Skip to main content

latest

Storage core for GramIO

Works with
This package works with Bun
This package works with Cloudflare Workers
This package works with Node.js
This package works with Deno
This package works with Browsers
JSR Score
100%
Published
2 weeks ago (0.0.3)

@gramio/storage

npm JSR JSR Score

Core of storage adapters.

Read more in documentation.

How to write my own storage adapters

It is very simple to write your adapter!

It is enough to return the object with the required methods and use the methods of the solution you have chosen for the adapter. (for example, ioredis)

import type { Storage } from "@gramio/storage";
import ThirdPartyStorage, { type ThirdPartyStorageOptions } from "some-library";

export interface MyOwnStorageOptions extends ThirdPartyStorageOptions {
    /** add new property to options */
    some?: number;
}

export function myOwnStorage(options: MyOwnStorageOptions = {}): Storage {
    const storage = new ThirdPartyStorage(options);

    return {
        async get(key) {
            const data = await storage.get(key);

            return data ? JSON.parse(data) : undefined;
        },
        async has(key) {
            return storage.has(key);
        },
        async set(key, value) {
            await storage.set(key, JSON.stringify(value));
        },
        async delete(key) {
            return storage.delete(key);
        },
    };
}
Important

If you want to publish your adapter, we recommend that you follow the convention and name it starting with gramio-storage and add gramio + gramio-storage keywords in your package.json

How to use storage adapters in my own plugin

It is also very easy to work with storage adapters in your plugin!

Everything we need is already in @gramio/storage.

import { Plugin } from "gramio";
import { type Storage, inMemoryStorage } from "@gramio/storage";

export interface MyOwnPluginOptions {
    storage?: Storage;
}

export function myOwnPlugin(options: MyOwnPluginOptions = {}) {
    // use in memory storage by default
    const storage = options.storage ?? inMemoryStorage();

    return new Plugin("gramio-example");
}
Important

You can scaffold this example by create-gramio-plugin

Add Package

deno add @gramio/storage

Import symbol

import * as mod from "@gramio/storage";

Add Package

npx jsr add @gramio/storage

Import symbol

import * as mod from "@gramio/storage";

Add Package

yarn dlx jsr add @gramio/storage

Import symbol

import * as mod from "@gramio/storage";

Add Package

pnpm dlx jsr add @gramio/storage

Import symbol

import * as mod from "@gramio/storage";

Add Package

bunx jsr add @gramio/storage

Import symbol

import * as mod from "@gramio/storage";