@adriangalilea/utils 0.18.0 → 0.19.0

package/dist/bot/payments/refund.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Refund flow — user-initiated request, admin-approved, executed via
+ * `refundStarPayment` on Telegram's side, reversed in our cache via
+ * `derive.ts`'s incremental + full-rebuild helpers.
+ *
+ * The flow mirrors `access-control.ts`'s admin-DM approval pattern:
+ *
+ *      user opens /settings → 💎 VIP → 📜 History → tap a charge
+ *                       │
+ *               "💸 Request refund"  →  confirm overlay  →  tap "✅"
+ *                       │
+ *      pay:charge.paysupportState = 'opened'
+ *      DM admin with charge details + [✅ Approve] [❌ Deny]
+ *                       │
+ *                  admin taps
+ *                       │
+ *       Approve  →  refundStarPayment  →  pay:refund + revert state
+ *       Deny     →  paysupportState = 'none'
+ *                       │
+ *               user gets DM with the outcome
+ *
+ * Callback data carries the chargeId only — everything else is read
+ * from the persisted record. Telegram's `telegram_payment_charge_id` is
+ * a moderately long string (~40 chars in practice); with our short
+ * `payRf*` schema names this stays under the 64-byte callback_data cap.
+ */
+import type { Storage } from "@gramio/storage";
+import type { BotCallbackCtx } from "../ctx.js";
+import type { PaymentsStores } from "./stores.js";
+import type { BotPaymentsConfig, PaymentsSession } from "./types.js";
+/** User tap on a charge entry — opens confirmation overlay then admin DM. */
+export declare const refundRequestCb: import("gramio").CallbackData<Record<never, never>, Record<never, never>>;
+/** Admin tap on the DM notification — approve. */
+export declare const refundApproveCb: import("gramio").CallbackData<Record<never, never>, Record<never, never>>;
+/** Admin tap on the DM notification — deny. */
+export declare const refundDenyCb: import("gramio").CallbackData<Record<never, never>, Record<never, never>>;
+/** Admin tap on the DM notification — close (no action). */
+export declare const refundCloseCb: import("gramio").CallbackData<Record<never, never>, Record<never, never>>;
+/** Strict bot.api surface this module exercises. */
+type RefundBotApi = {
+    refundStarPayment: (params: {
+        user_id: number;
+        telegram_payment_charge_id: string;
+    }) => Promise<unknown>;
+    editUserStarSubscription: (params: {
+        user_id: number;
+        telegram_payment_charge_id: string;
+        is_canceled: boolean;
+    }) => Promise<unknown>;
+    sendMessage: (params: {
+        chat_id: number;
+        message_thread_id?: number;
+        text: string;
+        reply_markup?: unknown;
+    }) => Promise<unknown>;
+};
+type SessionLike = {
+    pay?: PaymentsSession;
+    language?: string;
+};
+/**
+ * Callback-query ctx shape this module's handlers receive. Composed
+ * from the canonical `BotCallbackCtx` with `{ cid: string }` queryData,
+ * intersected with the admin-context derives (`adminId`, `isAdmin`)
+ * the handlers depend on for the approve/deny/close paths.
+ */
+type CommonCtx = BotCallbackCtx<SessionLike, {
+    cid: string;
+}, RefundBotApi> & {
+    adminId: number;
+    isAdmin: boolean;
+};
+export type RefundHandlersOptions = {
+    stores: PaymentsStores;
+    /**
+     * Raw storage for cross-user session record reads/writes (the
+     * `@gramio/session` keyspace, outside our `pay:*` stores). Used by
+     * `applyRefundToUser` + `loadFullRecord` to reach a target user's
+     * full session record (preserving fields owned by other plugins).
+     */
+    storage: Storage;
+    cfg: BotPaymentsConfig<string>;
+};
+/**
+ * User taps "💸 Request refund" on a charge entry inside the menu's
+ * History view. The menu plugin's `confirm:` overlay already handled
+ * the "Are you sure?" step; this fires on the confirmed tap and:
+ *
+ *   1. Marks the charge `paysupportState = 'opened'`
+ *   2. DMs the admin with [Approve][Deny] buttons
+ *   3. Returns a toast acknowledging the request was sent
+ *
+ * The user's menu remains on the History view (menu's
+ * `confirm`-confirmed action returns to root, but the toast confirms
+ * the action so the user knows what happened).
+ */
+export declare const buildRefundRequestHandler: (opts: RefundHandlersOptions) => (ctx: CommonCtx & {
+    queryData: {
+        cid: string;
+    };
+}) => Promise<string | undefined>;
+/**
+ * Admin taps "✅ Approve". Calls Telegram's `refundStarPayment`,
+ * persists the refund record + flips charge state, applies the refund
+ * to the target user's session (cross-user write), and notifies the
+ * user.
+ */
+export declare const buildRefundApproveHandler: (opts: RefundHandlersOptions) => (ctx: CommonCtx & {
+    queryData: {
+        cid: string;
+    };
+}) => Promise<void>;
+/**
+ * Admin taps "❌ Deny". Reverts `paysupportState` to `'none'` so the
+ * user can try again or the admin can reconsider later. Notifies the
+ * user with the configured paysupport contact for further escalation.
+ */
+export declare const buildRefundDenyHandler: (opts: RefundHandlersOptions) => (ctx: CommonCtx & {
+    queryData: {
+        cid: string;
+    };
+}) => Promise<void>;
+export {};
+//# sourceMappingURL=refund.d.ts.map

package/dist/bot/payments/refund.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refund.d.ts","sourceRoot":"","sources":["../../../src/bot/payments/refund.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAM/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACX,iBAAiB,EAEjB,eAAe,EACf,MAAM,YAAY,CAAC;AASpB,6EAA6E;AAC7E,eAAO,MAAM,eAAe,2EAA+C,CAAC;AAC5E,kDAAkD;AAClD,eAAO,MAAM,eAAe,2EAA+C,CAAC;AAC5E,+CAA+C;AAC/C,eAAO,MAAM,YAAY,2EAA4C,CAAC;AACtE,4DAA4D;AAC5D,eAAO,MAAM,aAAa,2EAA8B,CAAC;AAIzD,oDAAoD;AACpD,KAAK,YAAY,GAAG;IACnB,iBAAiB,EAAE,CAAC,MAAM,EAAE;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,0BAA0B,EAAE,MAAM,CAAC;KACnC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvB,wBAAwB,EAAE,CAAC,MAAM,EAAE;QAClC,OAAO,EAAE,MAAM,CAAC;QAChB,0BAA0B,EAAE,MAAM,CAAC;QACnC,WAAW,EAAE,OAAO,CAAC;KACrB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,MAAM,EAAE;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,CAAC,EAAE,OAAO,CAAC;KACvB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB,CAAC;AAEF,KAAK,WAAW,GAAG;IAAE,GAAG,CAAC,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE;;;;;GAKG;AACH,KAAK,SAAS,GAAG,cAAc,CAAC,WAAW,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,YAAY,CAAC,GAAG;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC;AAyGF,MAAM,MAAM,qBAAqB,GAAG;IACnC,MAAM,EAAE,cAAc,CAAC;IACvB;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,GACpC,MAAM,qBAAqB,MAE3B,KAAK,SAAS,GAAG;IAAE,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,KAC7C,OAAO,CAAC,MAAM,GAAG,SAAS,CA8D5B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GACpC,MAAM,qBAAqB,MACrB,KAAK,SAAS,GAAG;IAAE,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,KAAG,OAAO,CAAC,IAAI,CAgHpE,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,qBAAqB,MACrB,KAAK,SAAS,GAAG;IAAE,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,KAAG,OAAO,CAAC,IAAI,CAwDpE,CAAC"}

package/dist/bot/payments/refund.js

@@ -0,0 +1,308 @@
+/**
+ * Refund flow — user-initiated request, admin-approved, executed via
+ * `refundStarPayment` on Telegram's side, reversed in our cache via
+ * `derive.ts`'s incremental + full-rebuild helpers.
+ *
+ * The flow mirrors `access-control.ts`'s admin-DM approval pattern:
+ *
+ *      user opens /settings → 💎 VIP → 📜 History → tap a charge
+ *                       │
+ *               "💸 Request refund"  →  confirm overlay  →  tap "✅"
+ *                       │
+ *      pay:charge.paysupportState = 'opened'
+ *      DM admin with charge details + [✅ Approve] [❌ Deny]
+ *                       │
+ *                  admin taps
+ *                       │
+ *       Approve  →  refundStarPayment  →  pay:refund + revert state
+ *       Deny     →  paysupportState = 'none'
+ *                       │
+ *               user gets DM with the outcome
+ *
+ * Callback data carries the chargeId only — everything else is read
+ * from the persisted record. Telegram's `telegram_payment_charge_id` is
+ * a moderately long string (~40 chars in practice); with our short
+ * `payRf*` schema names this stays under the 64-byte callback_data cap.
+ */
+import { InlineKeyboard } from "gramio";
+import { say } from "../../say/index.js";
+import { createLogger } from "../../universal/log.js";
+import { callbackNs } from "../callbacks.js";
+import { botStorageKey } from "../kit.js";
+import { rebuildVipAndPerks, revertCreditsForCharge } from "./state.js";
+const FALLBACK_LANG = "en";
+const log = createLogger("bot/payments");
+const cb = callbackNs("pay");
+// ─── callback data schemas ─────────────────────────────────────────
+/** User tap on a charge entry — opens confirmation overlay then admin DM. */
+export const refundRequestCb = cb.data("refund:request", { cid: "string" });
+/** Admin tap on the DM notification — approve. */
+export const refundApproveCb = cb.data("refund:approve", { cid: "string" });
+/** Admin tap on the DM notification — deny. */
+export const refundDenyCb = cb.data("refund:deny", { cid: "string" });
+/** Admin tap on the DM notification — close (no action). */
+export const refundCloseCb = cb.data("refund:close", {});
+const ctxLang = (ctx) => ctx.session?.language ?? FALLBACK_LANG;
+// ─── cross-user session mutation ───────────────────────────────────
+//
+// The user's session record lives in @gramio/session's keyspace
+// (`bot-<id>:<userId>` via `botStorageKey`), not in our `pay:*` stores.
+// We still hit `storage` directly here because the session record holds
+// many fields owned by other plugins (access, language, llm) and we
+// must preserve them via read-modify-write.
+const loadFullRecord = async (storage, ctx, userId) => (await storage.get(botStorageKey(ctx, userId))) ?? {};
+/**
+ * Apply the refund's side effect to the target user's session record
+ * (which is NOT `ctx.session` when the admin is the actor).
+ *
+ *   - credits: targeted decrement (clamped at zero — see derive.ts)
+ *   - vip + perks: full rebuild from the post-refund charge log
+ *
+ * Read-modify-write preserves other plugins' fields in the same record.
+ */
+const applyRefundToUser = async (stores, storage, ctx, userId, refundedCharge) => {
+    const full = await loadFullRecord(storage, ctx, userId);
+    const session = { pay: full.pay };
+    revertCreditsForCharge(session, refundedCharge);
+    // charges already include the refunded one with state='refunded'
+    const chargeIds = await stores.userCharges(userId).list(ctx);
+    const charges = (await Promise.all(chargeIds.map((id) => stores.charges.get(ctx, id)))).filter((c) => c !== undefined);
+    rebuildVipAndPerks(session, charges);
+    full.pay = session.pay;
+    await storage.set(botStorageKey(ctx, userId), full);
+};
+// ─── notification rendering ────────────────────────────────────────
+const fmtAge = (ms) => {
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}min`;
+    const h = Math.floor(m / 60);
+    if (h < 24)
+        return `${h}h`;
+    return `${Math.floor(h / 24)}d`;
+};
+const adminNotificationText = (charge, lang) => [
+    say({ en: "💸 Refund requested", es: "💸 Reembolso solicitado" }, lang),
+    "",
+    `👤 ${say({ en: "user", es: "usuario" }, lang)}: ${charge.userId}`,
+    `📦 ${charge.productKey}`,
+    `⭐ ${charge.xtr}`,
+    `🆔 ${charge.chargeId}`,
+    `⏰ ${say({ en: "purchased", es: "comprado" }, lang)}: ${fmtAge(Date.now() - charge.receivedAt)} ${say({ en: "ago", es: "atrás" }, lang)}`,
+].join("\n");
+const adminKeyboard = (chargeId, lang) => new InlineKeyboard()
+    .text(say({ en: "✅ Approve", es: "✅ Aprobar" }, lang), refundApproveCb.pack({ cid: chargeId }), { style: "success" })
+    .text(say({ en: "❌ Deny", es: "❌ Denegar" }, lang), refundDenyCb.pack({ cid: chargeId }), { style: "danger" })
+    .row()
+    .text(say({ en: "✖️ Close", es: "✖️ Cerrar" }, lang), refundCloseCb.pack({}));
+const adminLangOfUser = async (storage, ctx, userId) => {
+    const full = await loadFullRecord(storage, ctx, userId);
+    return full.language ?? FALLBACK_LANG;
+};
+/**
+ * User taps "💸 Request refund" on a charge entry inside the menu's
+ * History view. The menu plugin's `confirm:` overlay already handled
+ * the "Are you sure?" step; this fires on the confirmed tap and:
+ *
+ *   1. Marks the charge `paysupportState = 'opened'`
+ *   2. DMs the admin with [Approve][Deny] buttons
+ *   3. Returns a toast acknowledging the request was sent
+ *
+ * The user's menu remains on the History view (menu's
+ * `confirm`-confirmed action returns to root, but the toast confirms
+ * the action so the user knows what happened).
+ */
+export const buildRefundRequestHandler = (opts) => async (ctx) => {
+    const lang = ctxLang(ctx);
+    const userId = ctx.from?.id;
+    if (userId === undefined) {
+        return say({ en: "Could not identify you.", es: "No se pudo identificarte." }, lang);
+    }
+    const charge = await opts.stores.charges.get(ctx, ctx.queryData.cid);
+    if (!charge) {
+        return say({ en: "Charge not found.", es: "Cargo no encontrado." }, lang);
+    }
+    if (charge.userId !== userId) {
+        // Anti-tamper — never let user A request refund of user B's charge.
+        return say({ en: "Not your charge.", es: "No es tu cargo." }, lang);
+    }
+    if (charge.paysupportState !== "none") {
+        return say({
+            en: "Refund already in progress or completed.",
+            es: "Reembolso ya en curso o completado.",
+        }, lang);
+    }
+    charge.paysupportState = "opened";
+    await opts.stores.charges.set(ctx, charge.chargeId, charge);
+    log.event(`refund requested by user: chargeId=${charge.chargeId} product=${charge.productKey} xtr=${charge.xtr}`);
+    const adminLang = await adminLangOfUser(opts.storage, ctx, ctx.adminId);
+    try {
+        await ctx.bot.api.sendMessage({
+            chat_id: ctx.adminId,
+            text: adminNotificationText(charge, adminLang),
+            reply_markup: adminKeyboard(charge.chargeId, adminLang),
+        });
+    }
+    catch (e) {
+        log.error(`failed to DM admin: ${e}`);
+        // Roll back the open state so the user can try again later.
+        charge.paysupportState = "none";
+        await opts.stores.charges.set(ctx, charge.chargeId, charge);
+        return say({
+            en: `Couldn't reach the admin. Contact ${opts.cfg.paysupport}.`,
+            es: `No se pudo contactar al admin. Contacta con ${opts.cfg.paysupport}.`,
+        }, lang);
+    }
+    return say({
+        en: "💸 Refund request sent.",
+        es: "💸 Solicitud de reembolso enviada.",
+    }, lang);
+};
+/**
+ * Admin taps "✅ Approve". Calls Telegram's `refundStarPayment`,
+ * persists the refund record + flips charge state, applies the refund
+ * to the target user's session (cross-user write), and notifies the
+ * user.
+ */
+export const buildRefundApproveHandler = (opts) => async (ctx) => {
+    const aLang = ctxLang(ctx);
+    if (!ctx.isAdmin) {
+        await ctx.answer({
+            text: say({ en: "Admin only.", es: "Solo admin." }, aLang),
+            show_alert: true,
+        });
+        return;
+    }
+    const charge = await opts.stores.charges.get(ctx, ctx.queryData.cid);
+    if (!charge) {
+        await ctx.answer({
+            text: say({ en: "Charge not found.", es: "Cargo no encontrado." }, aLang),
+        });
+        return;
+    }
+    if (charge.paysupportState === "refunded") {
+        await ctx.answer({
+            text: say({ en: "Already refunded.", es: "Ya reembolsado." }, aLang),
+        });
+        return;
+    }
+    log.event(`admin approving refund: chargeId=${charge.chargeId} user=${charge.userId} xtr=${charge.xtr}`);
+    try {
+        await ctx.bot.api.refundStarPayment({
+            user_id: charge.userId,
+            telegram_payment_charge_id: charge.chargeId,
+        });
+    }
+    catch (e) {
+        log.error(`refundStarPayment failed: ${e}`);
+        await ctx.answer({
+            text: say({
+                en: `❌ Refund failed: ${e instanceof Error ? e.message : String(e)}`,
+                es: `❌ Reembolso falló: ${e instanceof Error ? e.message : String(e)}`,
+            }, aLang),
+            show_alert: true,
+        });
+        return;
+    }
+    // If this charge funded a still-active vip subscription, also
+    // cancel its auto-renewal so the user isn't charged again at the
+    // next period boundary. Best-effort; refund itself already
+    // succeeded.
+    if (charge.vipRung !== undefined) {
+        try {
+            await ctx.bot.api.editUserStarSubscription({
+                user_id: charge.userId,
+                telegram_payment_charge_id: charge.chargeId,
+                is_canceled: true,
+            });
+        }
+        catch (e) {
+            log.warn(`post-refund cancel renewal failed (probably already canceled): ${e}`);
+        }
+    }
+    charge.paysupportState = "refunded";
+    charge.refundedAt = Date.now();
+    await opts.stores.charges.set(ctx, charge.chargeId, charge);
+    await applyRefundToUser(opts.stores, opts.storage, ctx, charge.userId, charge);
+    // User notification
+    const userFull = await loadFullRecord(opts.storage, ctx, charge.userId);
+    const uLang = userFull.language ?? FALLBACK_LANG;
+    try {
+        await ctx.bot.api.sendMessage({
+            chat_id: charge.userId,
+            text: say({
+                en: `✅ Your refund of ${charge.xtr} ⭐ has been approved.`,
+                es: `✅ Tu reembolso de ${charge.xtr} ⭐ ha sido aprobado.`,
+            }, uLang),
+        });
+    }
+    catch (e) {
+        log.error(`failed to notify user of approval: ${e}`);
+    }
+    await ctx.answer({
+        text: say({ en: "✅ Refund approved.", es: "✅ Reembolso aprobado." }, aLang),
+    });
+    if (ctx.editText) {
+        try {
+            await ctx.editText(`${say({ en: "✅ Refunded", es: "✅ Reembolsado" }, aLang)} · ${charge.chargeId}`);
+        }
+        catch {
+            /* message too old to edit */
+        }
+    }
+};
+/**
+ * Admin taps "❌ Deny". Reverts `paysupportState` to `'none'` so the
+ * user can try again or the admin can reconsider later. Notifies the
+ * user with the configured paysupport contact for further escalation.
+ */
+export const buildRefundDenyHandler = (opts) => async (ctx) => {
+    const aLang = ctxLang(ctx);
+    if (!ctx.isAdmin) {
+        await ctx.answer({
+            text: say({ en: "Admin only.", es: "Solo admin." }, aLang),
+            show_alert: true,
+        });
+        return;
+    }
+    const charge = await opts.stores.charges.get(ctx, ctx.queryData.cid);
+    if (!charge) {
+        await ctx.answer({
+            text: say({ en: "Charge not found.", es: "Cargo no encontrado." }, aLang),
+        });
+        return;
+    }
+    charge.paysupportState = "none";
+    await opts.stores.charges.set(ctx, charge.chargeId, charge);
+    const userFull = await loadFullRecord(opts.storage, ctx, charge.userId);
+    const uLang = userFull.language ?? FALLBACK_LANG;
+    try {
+        await ctx.bot.api.sendMessage({
+            chat_id: charge.userId,
+            text: say({
+                en: `❌ Your refund request was denied.\n\n` +
+                    `For further questions, contact ${opts.cfg.paysupport}.`,
+                es: `❌ Tu solicitud de reembolso fue denegada.\n\n` +
+                    `Para más consultas, contacta con ${opts.cfg.paysupport}.`,
+            }, uLang),
+        });
+    }
+    catch (e) {
+        log.error("failed to notify user of denial", e);
+    }
+    await ctx.answer({
+        text: say({ en: "❌ Denied", es: "❌ Denegado" }, aLang),
+    });
+    if (ctx.editText) {
+        try {
+            await ctx.editText(`${say({ en: "❌ Denied", es: "❌ Denegado" }, aLang)} · ${charge.chargeId}`);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+};
+//# sourceMappingURL=refund.js.map

package/dist/bot/payments/refund.js.map

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

package/dist/bot/payments/schemas.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Runtime schemas for the persisted ledger records. Wired into
+ * `stores.ts` as the optional validator on `botRecord<T>` — every read
+ * from storage gets `.parse()`'d, so a corrupted Redis record throws
+ * a clear `SourcedError({ source: 'storage', operation: 'validate' })`
+ * instead of NaN-ing downstream.
+ *
+ * Why zod? It's the canonical TS validator with the right API surface
+ * (`{ parse(data): T }`). The library's `RecordValidator<T>` type is
+ * structural, so swapping to valibot / ArkType / a hand-rolled guard
+ * just works — but zod is what we ship the default with.
+ *
+ * Schemas mirror the TS types in `types.ts` 1:1. Keep them in sync; the
+ * type system enforces that via the `z.infer<>` round-trip — if a
+ * schema drifts from the type, `satisfies ZodType<X>` on each export
+ * blows up. We use `satisfies` (not `as`) so the TS error points at the
+ * mismatch, not the assertion.
+ */
+import { z } from "zod";
+/**
+ * `ChargeRecord` schema. Mutable fields stay loose-typed (zod doesn't
+ * enforce readonly the way TS does) but every field is structurally
+ * present.
+ */
+export declare const chargeRecordSchema: z.ZodObject<{
+    chargeId: z.ZodString;
+    userId: z.ZodNumber;
+    productKey: z.ZodString;
+    xtr: z.ZodNumber;
+    receivedAt: z.ZodNumber;
+    payload: z.ZodString;
+    waiverSnapshot: z.ZodObject<{
+        at: z.ZodNumber;
+        version: z.ZodString;
+        locale: z.ZodString;
+    }, z.core.$strip>;
+    subscriptionExpiresAt: z.ZodOptional<z.ZodNumber>;
+    creditsGranted: z.ZodNumber;
+    vipRung: z.ZodOptional<z.ZodNumber>;
+    perkKey: z.ZodOptional<z.ZodString>;
+    paysupportState: z.ZodEnum<{
+        none: "none";
+        opened: "opened";
+        refunded: "refunded";
+    }>;
+    refundedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    payoutBatchId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const payoutRecordSchema: z.ZodObject<{
+    batchId: z.ZodString;
+    fromMs: z.ZodNumber;
+    toMs: z.ZodNumber;
+    tonAmount: z.ZodNumber;
+    eurAtReceipt: z.ZodNumber;
+    recordedAt: z.ZodNumber;
+    facturaNumber: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/bot/payments/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/bot/payments/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;iBAeK,CAAC;AAErC,eAAO,MAAM,kBAAkB;;;;;;;;iBAQK,CAAC"}

package/dist/bot/payments/schemas.js

@@ -0,0 +1,55 @@
+/**
+ * Runtime schemas for the persisted ledger records. Wired into
+ * `stores.ts` as the optional validator on `botRecord<T>` — every read
+ * from storage gets `.parse()`'d, so a corrupted Redis record throws
+ * a clear `SourcedError({ source: 'storage', operation: 'validate' })`
+ * instead of NaN-ing downstream.
+ *
+ * Why zod? It's the canonical TS validator with the right API surface
+ * (`{ parse(data): T }`). The library's `RecordValidator<T>` type is
+ * structural, so swapping to valibot / ArkType / a hand-rolled guard
+ * just works — but zod is what we ship the default with.
+ *
+ * Schemas mirror the TS types in `types.ts` 1:1. Keep them in sync; the
+ * type system enforces that via the `z.infer<>` round-trip — if a
+ * schema drifts from the type, `satisfies ZodType<X>` on each export
+ * blows up. We use `satisfies` (not `as`) so the TS error points at the
+ * mismatch, not the assertion.
+ */
+import { z } from "zod";
+const waiverRecordSchema = z.object({
+    at: z.number(),
+    version: z.string(),
+    locale: z.string(),
+});
+/**
+ * `ChargeRecord` schema. Mutable fields stay loose-typed (zod doesn't
+ * enforce readonly the way TS does) but every field is structurally
+ * present.
+ */
+export const chargeRecordSchema = z.object({
+    chargeId: z.string(),
+    userId: z.number(),
+    productKey: z.string(),
+    xtr: z.number(),
+    receivedAt: z.number(),
+    payload: z.string(),
+    waiverSnapshot: waiverRecordSchema,
+    subscriptionExpiresAt: z.number().optional(),
+    creditsGranted: z.number(),
+    vipRung: z.number().optional(),
+    perkKey: z.string().optional(),
+    paysupportState: z.enum(["none", "opened", "refunded"]),
+    refundedAt: z.number().nullable().optional(),
+    payoutBatchId: z.string().nullable().optional(),
+});
+export const payoutRecordSchema = z.object({
+    batchId: z.string(),
+    fromMs: z.number(),
+    toMs: z.number(),
+    tonAmount: z.number(),
+    eurAtReceipt: z.number(),
+    recordedAt: z.number(),
+    facturaNumber: z.string().optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/bot/payments/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/bot/payments/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAmC,CAAC;AAErC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,cAAc,EAAE,kBAAkB;IAClC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACvD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC/C,CAAmC,CAAC;AAErC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAmC,CAAC"}