@adriangalilea/utils 0.18.0 → 0.20.0

package/dist/bot/storage.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Typed storage abstraction for `bot/*` plugins.
+ *
+ * Replaces the per-plugin `botSubKey + storage.get/set` boilerplate
+ * with three small primitives that automatically:
+ *
+ *   - **Namespace by bot id.** Every key gets `bot-<id>:` prefixed via
+ *     `ctx.bot.info.id`, so multiple bots sharing one Redis stay
+ *     isolated by construction (see `bot/CLAUDE.md` § Multi-bot
+ *     isolation). No plugin has to remember to wrap.
+ *
+ *   - **Validate on read** (optional). Pass any `{ parse(data:
+ *     unknown): T }` validator (zod / valibot / arktype / yours) and a
+ *     mis-shaped record from storage throws a clear `SourcedError`
+ *     instead of NaN-ing downstream. Omit the validator and you get
+ *     the same untyped read as before.
+ *
+ *   - **Stay typed end-to-end.** `botRecord<ChargeRecord>(...)` returns
+ *     a `BotRecord<ChargeRecord>` and `.get()` is `Promise<ChargeRecord
+ *     | undefined>`. No casts at the call site.
+ *
+ * ## Three primitives
+ *
+ *   - `botRecord<T>(storage, prefix, validator?)` — get/set/delete a
+ *     single typed value keyed by an id (`pay:charge:<chargeId>`,
+ *     `ac:user:<userId>`, …). Most plugin state.
+ *
+ *   - `botIndex(storage, prefix, opts?)` — a capped, prepend-friendly
+ *     `string[]` stored under a single key. Use for "recent N
+ *     charges", "pending access requests", etc.
+ *
+ *   - `botSentinel(storage, prefix)` — a presence flag (`"1"` / absent)
+ *     for idempotency. `claim(ctx, id)` returns `true` only on first
+ *     call; subsequent calls return `false` without setting. Note:
+ *     read-then-write is NOT atomic under concurrent load; for
+ *     production we'd want a storage backend with `setNX` semantics.
+ *
+ * ## Why not couple to zod?
+ *
+ * The validator parameter is typed as `{ parse(data: unknown): T }` —
+ * a structural shape that zod schemas, valibot, ArkType, and hand-rolled
+ * type guards all satisfy. The library has zero zod imports; consumers
+ * bring whichever validator they prefer.
+ */
+import type { Storage } from "@gramio/storage";
+import type { BotIdCtx } from "./ctx.js";
+/**
+ * Anything with a synchronous `parse(unknown): T`. zod schemas satisfy
+ * this natively (`.parse` throws on invalid input). Custom guards work
+ * the same way: `{ parse: (d) => { if (!ok(d)) throw new Error(...); return d as T } }`.
+ */
+export type RecordValidator<T> = {
+    parse: (data: unknown) => T;
+};
+export type BotRecord<T> = {
+    /** Storage key for `id` under this record's prefix. */
+    keyFor: (ctx: BotIdCtx, id: string) => string;
+    /** `undefined` on miss; throws `SourcedError` on validator failure. */
+    get: (ctx: BotIdCtx, id: string) => Promise<T | undefined>;
+    /** Overwrites unconditionally. Use `botSentinel` if you need set-if-absent. */
+    set: (ctx: BotIdCtx, id: string, value: T) => Promise<void>;
+    /** Hard delete. No-op if absent. */
+    delete: (ctx: BotIdCtx, id: string) => Promise<void>;
+    /** `true` if a record exists at `id` (no read, no validation). */
+    has: (ctx: BotIdCtx, id: string) => Promise<boolean>;
+};
+/**
+ * Typed record store, auto-namespaced by bot id.
+ *
+ * @example  per-charge record with zod validation
+ *
+ *   const charges = botRecord<ChargeRecord>(
+ *     storage,
+ *     'pay:charge',
+ *     ChargeRecordSchema,   // any zod.ZodType<ChargeRecord>
+ *   )
+ *   await charges.set(ctx, chargeId, charge)
+ *   const c = await charges.get(ctx, chargeId)
+ *
+ * @example  without a validator (backwards-compatible behaviour)
+ *
+ *   const charges = botRecord<ChargeRecord>(storage, 'pay:charge')
+ *   const c = await charges.get(ctx, chargeId)  // typed but unchecked
+ */
+export declare const botRecord: <T>(storage: Storage, prefix: string, validator?: RecordValidator<T>) => BotRecord<T>;
+export type BotIndexOptions = {
+    /**
+     * Maximum number of ids retained. New `prepend` calls past this
+     * limit drop the OLDEST id. Omit for an unbounded index (a
+     * footgun for high-volume bots — set a cap).
+     */
+    capacity?: number;
+};
+export type BotIndex = {
+    keyFor: (ctx: BotIdCtx) => string;
+    /** Newest-first list of ids, capped to `capacity` if configured. */
+    list: (ctx: BotIdCtx) => Promise<string[]>;
+    /** Insert `id` at the front. Idempotent: re-prepending an existing
+     *  id moves it to the front. Returns the new length post-cap. */
+    prepend: (ctx: BotIdCtx, id: string) => Promise<number>;
+    /** Remove `id`. No-op if absent. Returns whether anything was removed. */
+    remove: (ctx: BotIdCtx, id: string) => Promise<boolean>;
+    /** Wipe the whole index. */
+    clear: (ctx: BotIdCtx) => Promise<void>;
+};
+/**
+ * Newest-first capped list of ids stored under a single key. Designed
+ * for "user's last N charges", "pending access requests", "recent
+ * payouts" — small, ordered, bounded.
+ *
+ * `prepend(id)` is the only mutator. Re-prepending an existing id moves
+ * it to the front (de-duplication). At-cap inserts drop the tail.
+ */
+export declare const botIndex: (storage: Storage, prefix: string, opts?: BotIndexOptions) => BotIndex;
+export type BotSentinel = {
+    keyFor: (ctx: BotIdCtx, id: string) => string;
+    /**
+     * Attempt to claim `id`. Returns `true` on first claim (and
+     * persists), `false` if already claimed (no write).
+     *
+     * NOT atomic under concurrent load — the read and write happen as
+     * two ops. For at-most-once semantics under contention, swap the
+     * storage backend for one with `setNX` (e.g. `@gramio/storage-redis`
+     * with a `setIfNotExists` helper) and override this method. For
+     * single-process polling bots (the v1 target), the race window is
+     * bounded by Telegram's retry delay and acceptable.
+     */
+    claim: (ctx: BotIdCtx, id: string) => Promise<boolean>;
+    /** `true` if `id` has been claimed. No write. */
+    check: (ctx: BotIdCtx, id: string) => Promise<boolean>;
+    /** Release a claim. Returns whether anything was released. */
+    release: (ctx: BotIdCtx, id: string) => Promise<boolean>;
+};
+/**
+ * Presence-flag store for idempotency. Each id is either claimed
+ * (storage has the key) or not (storage doesn't). The stored value is
+ * an opaque sentinel string — readers only care about presence.
+ *
+ * @example  idempotent successful_payment fulfillment
+ *
+ *   const idem = botSentinel(storage, 'pay:idem')
+ *   if (!(await idem.claim(ctx, chargeId))) return  // duplicate, no-op
+ *   await fulfill(charge)
+ */
+export declare const botSentinel: (storage: Storage, prefix: string) => BotSentinel;
+/**
+ * Wrap any `BotRecord` with trace-level logging for every read/write.
+ * Useful when debugging a specific plugin's storage flow without
+ * polluting every other plugin's logs. Defaults off.
+ *
+ *   const charges = withTracing(botRecord<ChargeRecord>(...), 'pay:charge')
+ */
+export declare const withTracing: <T>(record: BotRecord<T>, label: string) => BotRecord<T>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/bot/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/bot/storage.ts"],"names":[],"mappings":"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"}

package/dist/bot/storage.js

@@ -0,0 +1,222 @@
+/**
+ * Typed storage abstraction for `bot/*` plugins.
+ *
+ * Replaces the per-plugin `botSubKey + storage.get/set` boilerplate
+ * with three small primitives that automatically:
+ *
+ *   - **Namespace by bot id.** Every key gets `bot-<id>:` prefixed via
+ *     `ctx.bot.info.id`, so multiple bots sharing one Redis stay
+ *     isolated by construction (see `bot/CLAUDE.md` § Multi-bot
+ *     isolation). No plugin has to remember to wrap.
+ *
+ *   - **Validate on read** (optional). Pass any `{ parse(data:
+ *     unknown): T }` validator (zod / valibot / arktype / yours) and a
+ *     mis-shaped record from storage throws a clear `SourcedError`
+ *     instead of NaN-ing downstream. Omit the validator and you get
+ *     the same untyped read as before.
+ *
+ *   - **Stay typed end-to-end.** `botRecord<ChargeRecord>(...)` returns
+ *     a `BotRecord<ChargeRecord>` and `.get()` is `Promise<ChargeRecord
+ *     | undefined>`. No casts at the call site.
+ *
+ * ## Three primitives
+ *
+ *   - `botRecord<T>(storage, prefix, validator?)` — get/set/delete a
+ *     single typed value keyed by an id (`pay:charge:<chargeId>`,
+ *     `ac:user:<userId>`, …). Most plugin state.
+ *
+ *   - `botIndex(storage, prefix, opts?)` — a capped, prepend-friendly
+ *     `string[]` stored under a single key. Use for "recent N
+ *     charges", "pending access requests", etc.
+ *
+ *   - `botSentinel(storage, prefix)` — a presence flag (`"1"` / absent)
+ *     for idempotency. `claim(ctx, id)` returns `true` only on first
+ *     call; subsequent calls return `false` without setting. Note:
+ *     read-then-write is NOT atomic under concurrent load; for
+ *     production we'd want a storage backend with `setNX` semantics.
+ *
+ * ## Why not couple to zod?
+ *
+ * The validator parameter is typed as `{ parse(data: unknown): T }` —
+ * a structural shape that zod schemas, valibot, ArkType, and hand-rolled
+ * type guards all satisfy. The library has zero zod imports; consumers
+ * bring whichever validator they prefer.
+ */
+import { SourcedError } from "../offensive.js";
+import { createLogger } from "../universal/log.js";
+const log = createLogger("bot/storage");
+const botIdOf = (ctx) => {
+    const id = ctx.bot?.info?.id;
+    if (typeof id !== "number") {
+        throw new SourcedError({
+            source: "storage",
+            operation: "key",
+            message: "ctx.bot.info.id is missing — called before bot.start()/bot.init()?",
+        });
+    }
+    return id;
+};
+/**
+ * Build the namespaced key for a record / index / sentinel. Matches
+ * the format `botSubKey` / `botStorageKey` in `kit.ts` use, so the
+ * abstractions compose with anything that still consumes those.
+ */
+const buildKey = (ctx, prefix, id) => {
+    const base = `bot-${botIdOf(ctx)}:${prefix}`;
+    return id !== undefined ? `${base}:${id}` : base;
+};
+const parseOr = (raw, validator, key) => {
+    if (!validator)
+        return raw;
+    try {
+        return validator.parse(raw);
+    }
+    catch (cause) {
+        throw new SourcedError({
+            source: "storage",
+            operation: "validate",
+            message: cause instanceof Error
+                ? cause.message
+                : "validator threw a non-Error value",
+            cause,
+            context: { key },
+        });
+    }
+};
+/**
+ * Typed record store, auto-namespaced by bot id.
+ *
+ * @example  per-charge record with zod validation
+ *
+ *   const charges = botRecord<ChargeRecord>(
+ *     storage,
+ *     'pay:charge',
+ *     ChargeRecordSchema,   // any zod.ZodType<ChargeRecord>
+ *   )
+ *   await charges.set(ctx, chargeId, charge)
+ *   const c = await charges.get(ctx, chargeId)
+ *
+ * @example  without a validator (backwards-compatible behaviour)
+ *
+ *   const charges = botRecord<ChargeRecord>(storage, 'pay:charge')
+ *   const c = await charges.get(ctx, chargeId)  // typed but unchecked
+ */
+export const botRecord = (storage, prefix, validator) => ({
+    keyFor: (ctx, id) => buildKey(ctx, prefix, id),
+    get: async (ctx, id) => {
+        const key = buildKey(ctx, prefix, id);
+        const raw = await storage.get(key);
+        if (raw === undefined)
+            return undefined;
+        return parseOr(raw, validator, key);
+    },
+    // `@gramio/storage`'s methods return `MaybePromise<T>` (sync- or
+    // async-storage agnostic). We normalize to `Promise<T>` via
+    // `Promise.resolve` so callers don't have to care which backend
+    // they're on.
+    set: async (ctx, id, value) => void (await storage.set(buildKey(ctx, prefix, id), value)),
+    delete: async (ctx, id) => void (await storage.delete(buildKey(ctx, prefix, id))),
+    has: async (ctx, id) => (await storage.has(buildKey(ctx, prefix, id))) === true,
+});
+/**
+ * Newest-first capped list of ids stored under a single key. Designed
+ * for "user's last N charges", "pending access requests", "recent
+ * payouts" — small, ordered, bounded.
+ *
+ * `prepend(id)` is the only mutator. Re-prepending an existing id moves
+ * it to the front (de-duplication). At-cap inserts drop the tail.
+ */
+export const botIndex = (storage, prefix, opts = {}) => {
+    const cap = opts.capacity;
+    return {
+        keyFor: (ctx) => buildKey(ctx, prefix),
+        list: async (ctx) => {
+            const key = buildKey(ctx, prefix);
+            return (await storage.get(key)) ?? [];
+        },
+        prepend: async (ctx, id) => {
+            const key = buildKey(ctx, prefix);
+            const existing = (await storage.get(key)) ?? [];
+            // De-dup: remove if present, then unshift. Cap at the end.
+            const filtered = existing.filter((x) => x !== id);
+            filtered.unshift(id);
+            const trimmed = cap !== undefined && filtered.length > cap
+                ? filtered.slice(0, cap)
+                : filtered;
+            await storage.set(key, trimmed);
+            return trimmed.length;
+        },
+        remove: async (ctx, id) => {
+            const key = buildKey(ctx, prefix);
+            const existing = (await storage.get(key)) ?? [];
+            const filtered = existing.filter((x) => x !== id);
+            if (filtered.length === existing.length)
+                return false;
+            await storage.set(key, filtered);
+            return true;
+        },
+        clear: async (ctx) => void (await storage.delete(buildKey(ctx, prefix))),
+    };
+};
+/**
+ * Presence-flag store for idempotency. Each id is either claimed
+ * (storage has the key) or not (storage doesn't). The stored value is
+ * an opaque sentinel string — readers only care about presence.
+ *
+ * @example  idempotent successful_payment fulfillment
+ *
+ *   const idem = botSentinel(storage, 'pay:idem')
+ *   if (!(await idem.claim(ctx, chargeId))) return  // duplicate, no-op
+ *   await fulfill(charge)
+ */
+export const botSentinel = (storage, prefix) => {
+    const SENTINEL = "1";
+    return {
+        keyFor: (ctx, id) => buildKey(ctx, prefix, id),
+        claim: async (ctx, id) => {
+            const key = buildKey(ctx, prefix, id);
+            const existing = await storage.get(key);
+            if (existing !== undefined)
+                return false;
+            await storage.set(key, SENTINEL);
+            return true;
+        },
+        check: async (ctx, id) => {
+            const key = buildKey(ctx, prefix, id);
+            return (await storage.get(key)) !== undefined;
+        },
+        release: async (ctx, id) => {
+            const key = buildKey(ctx, prefix, id);
+            if ((await storage.get(key)) === undefined)
+                return false;
+            await storage.delete(key);
+            return true;
+        },
+    };
+};
+// ─── observability hook (opt-in) ──────────────────────────────────
+/**
+ * Wrap any `BotRecord` with trace-level logging for every read/write.
+ * Useful when debugging a specific plugin's storage flow without
+ * polluting every other plugin's logs. Defaults off.
+ *
+ *   const charges = withTracing(botRecord<ChargeRecord>(...), 'pay:charge')
+ */
+export const withTracing = (record, label) => ({
+    keyFor: record.keyFor,
+    get: async (ctx, id) => {
+        const result = await record.get(ctx, id);
+        log.trace(`${label}.get(${id}) → ${result === undefined ? "miss" : "hit"}`);
+        return result;
+    },
+    set: async (ctx, id, value) => {
+        await record.set(ctx, id, value);
+        log.trace(`${label}.set(${id})`);
+    },
+    delete: async (ctx, id) => {
+        await record.delete(ctx, id);
+        log.trace(`${label}.delete(${id})`);
+    },
+    has: (ctx, id) => record.has(ctx, id),
+});
+//# sourceMappingURL=storage.js.map

package/dist/bot/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/bot/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;AAWxC,MAAM,OAAO,GAAG,CAAC,GAAa,EAAU,EAAE;IACzC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;IAC7B,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,YAAY,CAAC;YACtB,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,KAAK;YAChB,OAAO,EACN,oEAAoE;SACrE,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACX,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,QAAQ,GAAG,CAAC,GAAa,EAAE,MAAc,EAAE,EAAW,EAAU,EAAE;IACvE,MAAM,IAAI,GAAG,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;IAC7C,OAAO,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,CACf,GAAY,EACZ,SAAyC,EACzC,GAAW,EACP,EAAE;IACN,IAAI,CAAC,SAAS;QAAE,OAAO,GAAQ,CAAC;IAChC,IAAI,CAAC;QACJ,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,YAAY,CAAC;YACtB,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,UAAU;YACrB,OAAO,EACN,KAAK,YAAY,KAAK;gBACrB,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,mCAAmC;YACvC,KAAK;YACL,OAAO,EAAE,EAAE,GAAG,EAAE;SAChB,CAAC,CAAC;IACJ,CAAC;AACF,CAAC,CAAC;AAiBF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACxB,OAAgB,EAChB,MAAc,EACd,SAA8B,EACf,EAAE,CAAC,CAAC;IACnB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC;IAC9C,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE;QACtB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACxC,OAAO,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,iEAAiE;IACjE,4DAA4D;IAC5D,gEAAgE;IAChE,cAAc;IACd,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAC7B,KAAK,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3D,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,CACzB,KAAK,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IACvD,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,CACtB,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI;CACxD,CAAC,CAAC;AA0BH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACvB,OAAgB,EAChB,MAAc,EACd,OAAwB,EAAE,EACf,EAAE;IACb,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC1B,OAAO;QACN,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACtC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACnB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAClC,OAAQ,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAA0B,IAAI,EAAE,CAAC;QACjE,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE;YAC1B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAClC,MAAM,QAAQ,GAAI,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAA0B,IAAI,EAAE,CAAC;YAC1E,2DAA2D;YAC3D,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACrB,MAAM,OAAO,GACZ,GAAG,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG;gBACzC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBACxB,CAAC,CAAC,QAAQ,CAAC;YACb,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAChC,OAAO,OAAO,CAAC,MAAM,CAAC;QACvB,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE;YACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAClC,MAAM,QAAQ,GAAI,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAA0B,IAAI,EAAE,CAAC;YAC1E,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAClD,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;YACtD,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QACb,CAAC;QACD,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;KACxE,CAAC;AACH,CAAC,CAAC;AAwBF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAgB,EAAE,MAAc,EAAe,EAAE;IAC5E,MAAM,QAAQ,GAAG,GAAG,CAAC;IACrB,OAAO;QACN,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC;QAC9C,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE;YACxB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YACtC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YACzC,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QACb,CAAC;QACD,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE;YACxB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YACtC,OAAO,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,SAAS,CAAC;QAC/C,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE;YAC1B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YACzD,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QACb,CAAC;KACD,CAAC;AACH,CAAC,CAAC;AAEF,qEAAqE;AAErE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAC1B,MAAoB,EACpB,KAAa,EACE,EAAE,CAAC,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM;IACrB,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE;QACtB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACzC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,QAAQ,EAAE,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5E,OAAO,MAAM,CAAC;IACf,CAAC;IACD,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE;QAC7B,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QACjC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,QAAQ,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE;QACzB,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7B,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,WAAW,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC;CACrC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@adriangalilea/utils",
-	"version": "0.18.0",
+	"version": "0.20.0",
 	"description": "TypeScript utilities - logger, currency, formatter, GramIO bot plugins, and more",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -40,6 +40,10 @@
 			"types": "./dist/bot/access-control.d.ts",
 			"default": "./dist/bot/access-control.js"
 		},
+		"./bot/allow-list": {
+			"types": "./dist/bot/allow-list.d.ts",
+			"default": "./dist/bot/allow-list.js"
+		},
 		"./bot/coalesce": {
 			"types": "./dist/bot/coalesce.d.ts",
 			"default": "./dist/bot/coalesce.js"
@@ -59,6 +63,22 @@
 		"./bot/llm": {
 			"types": "./dist/bot/llm.d.ts",
 			"default": "./dist/bot/llm.js"
+		},
+		"./bot/payments": {
+			"types": "./dist/bot/payments/index.d.ts",
+			"default": "./dist/bot/payments/index.js"
+		},
+		"./bot/storage": {
+			"types": "./dist/bot/storage.d.ts",
+			"default": "./dist/bot/storage.js"
+		},
+		"./bot/ctx": {
+			"types": "./dist/bot/ctx.d.ts",
+			"default": "./dist/bot/ctx.js"
+		},
+		"./bot/callbacks": {
+			"types": "./dist/bot/callbacks.d.ts",
+			"default": "./dist/bot/callbacks.js"
 		}
 	},
 	"files": [
@@ -98,7 +118,8 @@
 		"gramio": "^0.10.0",
 		"marked": "^15.0.11",
 		"tsx": "^4.20.4",
-		"typescript": "^5.9.2"
+		"typescript": "^5.9.2",
+		"zod": "^4.4.3"
 	},
 	"dependencies": {
 		"chalk": "^5.6.0"
@@ -108,7 +129,8 @@
 		"@gramio/session": ">=0.2.0",
 		"@gramio/storage": ">=2.0.0",
 		"gramio": ">=0.10.0",
-		"marked": ">=12"
+		"marked": ">=12",
+		"zod": ">=3.22"
 	},
 	"peerDependenciesMeta": {
 		"@gramio/format": {
@@ -125,6 +147,9 @@
 		},
 		"marked": {
 			"optional": true
+		},
+		"zod": {
+			"optional": true
 		}
 	},
 	"publishConfig": {