@adriangalilea/utils 0.18.0 → 0.19.0

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

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

package/dist/bot/payments/menu-item.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `payments.menuItem` — single drop-in entry for `botMenu({ items: […] })`.
+ *
+ * Label, style, and submenu adapt to the user's current state via live
+ * resolvers reading `ctx.session.pay.*` (see `bot/CLAUDE.md` § "Snapshot
+ * vs live derives"). The plugin owns the whole submenu — bot author
+ * just adds `payments.menuItem` to their items array.
+ *
+ * Submenu shape (v1):
+ *
+ *   /settings → 💎 VIP
+ *   ├── ── tier cards ──
+ *   │   [💎 VIP — 500 ⭐]               buy / current state via style
+ *   │   [🌟 VIP Max — 2000 ⭐]
+ *   ├── ── credits packs (if axis used) ──
+ *   │   [💬 +100 — 100 ⭐]
+ *   │   [💬 +500 — 400 ⭐]
+ *   ├── ── perks (if axis used) ──
+ *   │   [🎁 Voice mode — 1500 ⭐]      hidden when owned
+ *   ├── ── manage (when vip active) ──
+ *   │   [⛔ Cancel renewal]            or [↩️ Resume renewal] when canceled
+ *   ├── 💬 Help / refunds → ctx.send(paysupport blurb)
+ *   ├── ⬅️ Back  ✖️ Close             (botMenu auto-renders these in submenus)
+ *
+ * What's deliberately NOT here yet:
+ *
+ *   - Per-charge **History** view + in-menu refund request. The compliance
+ *     surface (`/paysupport` + admin-mediated refund) is fulfilled by
+ *     the admin commands and the message-side flow in `refund.ts`. The
+ *     history UI is a v2 follow-up (see CLAUDE.md §"Open follow-ups").
+ *
+ *   - Deep-link `require()` → exact rung. v1 opens VIP root; deep-linking
+ *     needs menu-state encoding in callback data.
+ */
+import type { MenuItem } from "../menu.js";
+import type { BotPaymentsConfig, ProductCatalog } from "./types.js";
+export declare const buildPaymentsMenuItem: (args: {
+    cfg: BotPaymentsConfig<string>;
+    catalog: ProductCatalog;
+}) => MenuItem;
+//# sourceMappingURL=menu-item.d.ts.map

package/dist/bot/payments/menu-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-item.d.ts","sourceRoot":"","sources":["../../../src/bot/payments/menu-item.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,OAAO,KAAK,EAAW,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,KAAK,EACX,iBAAiB,EAEjB,cAAc,EACd,MAAM,YAAY,CAAC;AAiCpB,eAAO,MAAM,qBAAqB,GAAI,MAAM;IAC3C,GAAG,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,cAAc,CAAC;CACxB,KAAG,QAqRH,CAAC"}

package/dist/bot/payments/menu-item.js

@@ -0,0 +1,259 @@
+/**
+ * `payments.menuItem` — single drop-in entry for `botMenu({ items: […] })`.
+ *
+ * Label, style, and submenu adapt to the user's current state via live
+ * resolvers reading `ctx.session.pay.*` (see `bot/CLAUDE.md` § "Snapshot
+ * vs live derives"). The plugin owns the whole submenu — bot author
+ * just adds `payments.menuItem` to their items array.
+ *
+ * Submenu shape (v1):
+ *
+ *   /settings → 💎 VIP
+ *   ├── ── tier cards ──
+ *   │   [💎 VIP — 500 ⭐]               buy / current state via style
+ *   │   [🌟 VIP Max — 2000 ⭐]
+ *   ├── ── credits packs (if axis used) ──
+ *   │   [💬 +100 — 100 ⭐]
+ *   │   [💬 +500 — 400 ⭐]
+ *   ├── ── perks (if axis used) ──
+ *   │   [🎁 Voice mode — 1500 ⭐]      hidden when owned
+ *   ├── ── manage (when vip active) ──
+ *   │   [⛔ Cancel renewal]            or [↩️ Resume renewal] when canceled
+ *   ├── 💬 Help / refunds → ctx.send(paysupport blurb)
+ *   ├── ⬅️ Back  ✖️ Close             (botMenu auto-renders these in submenus)
+ *
+ * What's deliberately NOT here yet:
+ *
+ *   - Per-charge **History** view + in-menu refund request. The compliance
+ *     surface (`/paysupport` + admin-mediated refund) is fulfilled by
+ *     the admin commands and the message-side flow in `refund.ts`. The
+ *     history UI is a v2 follow-up (see CLAUDE.md §"Open follow-ups").
+ *
+ *   - Deep-link `require()` → exact rung. v1 opens VIP root; deep-linking
+ *     needs menu-state encoding in callback data.
+ */
+import { say } from "../../say/index.js";
+import { narrow } from "../ctx.js";
+import { presentInvoice } from "./invoice.js";
+const FALLBACK_LANG = "en";
+const ctxLang = (ctx) => narrow(ctx).session?.language ?? FALLBACK_LANG;
+const ctxPay = (ctx) => narrow(ctx).session?.pay;
+const resolveName = (value, lang) => {
+    if (!value)
+        return "";
+    return value[lang] ?? value[FALLBACK_LANG] ?? Object.values(value)[0] ?? "";
+};
+// ─── public factory ────────────────────────────────────────────────
+export const buildPaymentsMenuItem = (args) => {
+    const { cfg, catalog } = args;
+    // Root entry label + style adapt to current tier.
+    const rootLabel = (ctx) => {
+        const lang = ctxLang(ctx);
+        const pay = ctxPay(ctx);
+        if (!pay?.vip) {
+            return say({ en: "💎 VIP", es: "💎 VIP" }, lang);
+        }
+        // Active subscription — show name + days remaining.
+        const rung = catalog.vip[pay.vip.rung - 1];
+        const name = rung
+            ? resolveName(rung.name, lang)
+            : "VIP";
+        const daysLeft = Math.max(0, Math.ceil((pay.vip.expiresAt * 1000 - Date.now()) / 86_400_000));
+        // Two visual states: active+renewing → no marker; canceled → "expira".
+        if (pay.vip.canceled) {
+            return say({
+                en: `💎 ${name} · expires in ${daysLeft} d`,
+                es: `💎 ${name} · expira en ${daysLeft} d`,
+            }, lang);
+        }
+        return say({ en: `💎 ${name} · ${daysLeft} d`, es: `💎 ${name} · ${daysLeft} d` }, lang);
+    };
+    const rootStyle = (ctx) => {
+        const pay = ctxPay(ctx);
+        if (!pay?.vip)
+            return "primary"; // free → blue, "buy me" affordance
+        if (pay.vip.canceled)
+            return "danger"; // about to lapse
+        return undefined; // active+renewing → neutral
+    };
+    // ── submenu items ───────────────────────────────────────────────
+    //
+    // Menu item ids must not contain `.` — bot/menu joins paths with
+    // `.` (`pay.<itemId>`), so a dot in the id collides with the path
+    // separator and `itemForPath()` mis-parses the segments → "Item
+    // not found" with no logging. We replace dots with `_` for the
+    // menu id only; the action closure still uses the canonical
+    // `productKey` ("vip.1", "credits.1", "perks.voice_mode") for the
+    // catalog lookup and invoice payload.
+    const menuId = (productKey) => productKey.replace(/\./g, "_");
+    const items = [];
+    // 1. Tier cards (one per declared rung)
+    for (const rung of catalog.vip) {
+        items.push({
+            id: menuId(rung.id), // e.g. 'vip_1' — path-safe menu id
+            label: (ctx) => {
+                const lang = ctxLang(ctx);
+                const name = resolveName(rung.name, lang);
+                const pay = ctxPay(ctx);
+                if (pay?.vip?.rung === rung.rank) {
+                    return say({
+                        en: `✓ ${name} — ${rung.xtr} ⭐ (current)`,
+                        es: `✓ ${name} — ${rung.xtr} ⭐ (actual)`,
+                    }, lang);
+                }
+                const isUpgrade = (pay?.vip?.rung ?? 0) < rung.rank;
+                const tag = isUpgrade
+                    ? say({ en: "Upgrade", es: "Subir" }, lang)
+                    : say({ en: "Switch", es: "Cambiar" }, lang);
+                return `💎 ${name} — ${rung.xtr} ⭐ · ${tag}`;
+            },
+            style: (ctx) => {
+                const pay = ctxPay(ctx);
+                if (pay?.vip?.rung === rung.rank)
+                    return "primary";
+                return undefined;
+            },
+            // Don't re-show the buy card for the currently-active rung —
+            // it's already labeled "current" and tapping would re-invoice
+            // the same product, which Telegram allows but isn't useful UX.
+            visible: (ctx) => ctxPay(ctx)?.vip?.rung !== rung.rank,
+            action: async (ctx) => {
+                await presentInvoice(narrow(ctx), cfg, catalog, rung.id);
+                // Toast is the only thing the menu plugin will send for this
+                // tap; the invoice / waiver prompt itself goes out as a
+                // fresh message via ctx.send inside presentInvoice.
+                return undefined;
+            },
+        });
+    }
+    // 2. Credits packs (if axis configured)
+    for (const pack of catalog.creditsPacks) {
+        items.push({
+            id: menuId(pack.id), // e.g. 'credits_1' — path-safe menu id
+            label: (ctx) => {
+                const lang = ctxLang(ctx);
+                const unit = catalog.creditsUnit
+                    ? resolveName(catalog.creditsUnit, lang)
+                    : "credits";
+                const explicit = pack.name
+                    ? resolveName(pack.name, lang)
+                    : undefined;
+                const body = explicit ?? `+${pack.creditsGranted} ${unit}`;
+                return `💬 ${body} — ${pack.xtr} ⭐`;
+            },
+            action: async (ctx) => {
+                await presentInvoice(narrow(ctx), cfg, catalog, pack.id);
+                return undefined;
+            },
+        });
+    }
+    // 3. Perks — hide when already owned (no "tap to re-buy" UX trap)
+    for (const perk of catalog.perks) {
+        items.push({
+            id: menuId(perk.id), // e.g. 'perks_voice_mode' — path-safe
+            label: (ctx) => {
+                const lang = ctxLang(ctx);
+                const name = resolveName(perk.name, lang);
+                return `🎁 ${name} — ${perk.xtr} ⭐`;
+            },
+            visible: (ctx) => !ctxPay(ctx)?.perks?.[perk.key],
+            action: async (ctx) => {
+                await presentInvoice(narrow(ctx), cfg, catalog, perk.id);
+                return undefined;
+            },
+        });
+    }
+    // 4. Manage: cancel renewal / resume renewal (single dynamic button)
+    items.push({
+        id: "manage",
+        label: (ctx) => {
+            const lang = ctxLang(ctx);
+            const pay = ctxPay(ctx);
+            if (!pay?.vip)
+                return ""; // hidden when free
+            return pay.vip.canceled
+                ? say({ en: "↩️ Resume renewal", es: "↩️ Reanudar renovación" }, lang)
+                : say({ en: "⛔ Cancel renewal", es: "⛔ Cancelar renovación" }, lang);
+        },
+        style: (ctx) => {
+            const pay = ctxPay(ctx);
+            return pay?.vip?.canceled ? "primary" : "danger";
+        },
+        visible: (ctx) => !!ctxPay(ctx)?.vip,
+        refresh: true,
+        confirm: {
+            prompt: {
+                en: "⚠️ Toggle auto-renewal for your VIP subscription?\n\n" +
+                    "Canceling: access continues until the current period ends; no renewal charge.\n" +
+                    "Resuming: auto-renewal turns back on.",
+                es: "⚠️ ¿Cambiar la renovación automática de tu suscripción VIP?\n\n" +
+                    "Cancelar: mantienes acceso hasta el fin del periodo actual; no se cobra renovación.\n" +
+                    "Reanudar: se vuelve a activar la renovación automática.",
+            },
+        },
+        action: async (ctx) => {
+            const lang = ctxLang(ctx);
+            const pay = ctxPay(ctx);
+            if (!pay?.vip) {
+                return say({ en: "Nothing to do.", es: "Nada que hacer." }, lang);
+            }
+            const c = narrow(ctx);
+            const userId = c.from?.id;
+            if (!userId) {
+                return say({ en: "No user.", es: "Sin usuario." }, lang);
+            }
+            const wantCanceled = !pay.vip.canceled;
+            try {
+                await c.bot.api.editUserStarSubscription({
+                    user_id: userId,
+                    telegram_payment_charge_id: pay.vip.chargeId,
+                    is_canceled: wantCanceled,
+                });
+            }
+            catch (e) {
+                console.error("[bot/payments/menu] editUserStarSubscription failed", e);
+                return say({ en: "Failed — try later.", es: "Falló — prueba luego." }, lang);
+            }
+            // Reflect the new state in session so the menu re-renders
+            // correctly (refresh: true will fire the label/style resolvers
+            // again immediately after this returns).
+            const session = c.session;
+            if (session.pay?.vip) {
+                session.pay = {
+                    ...session.pay,
+                    vip: { ...session.pay.vip, canceled: wantCanceled },
+                };
+            }
+            return wantCanceled
+                ? say({ en: "⛔ Renewal canceled.", es: "⛔ Renovación cancelada." }, lang)
+                : say({ en: "↩️ Renewal resumed.", es: "↩️ Renovación reanudada." }, lang);
+        },
+    });
+    // 5. Help / refunds — URL-style action that just sends the paysupport blurb
+    items.push({
+        id: "help",
+        label: (ctx) => say({ en: "💬 Help & refunds", es: "💬 Ayuda y reembolsos" }, ctxLang(ctx)),
+        action: async (ctx) => {
+            const lang = ctxLang(ctx);
+            const c = narrow(ctx);
+            await c.send(say({
+                en: `Need help with a payment?\n\n` +
+                    `• Contact: ${cfg.paysupport}\n` +
+                    `• Include the chargeId from your purchase confirmation.\n\n` +
+                    `Refunds are processed by the admin within Telegram.`,
+                es: `¿Necesitas ayuda con un pago?\n\n` +
+                    `• Contacto: ${cfg.paysupport}\n` +
+                    `• Incluye el chargeId de tu confirmación de compra.\n\n` +
+                    `Los reembolsos los gestiona el admin dentro de Telegram.`,
+            }, lang));
+            return undefined;
+        },
+    });
+    return {
+        id: "pay",
+        label: rootLabel,
+        style: rootStyle,
+        submenu: items,
+    };
+};
+//# sourceMappingURL=menu-item.js.map

package/dist/bot/payments/menu-item.js.map

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

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

@@ -0,0 +1,42 @@
+/**
+ * Invoice payload codec. Telegram echoes the `invoice_payload` string
+ * back on `pre_checkout_query` and `successful_payment`; we use it to
+ * recover the `(productKey, userId)` pair that the in-flight purchase
+ * refers to.
+ *
+ * Constraints from Telegram:
+ *   - Max 128 bytes.
+ *   - Must be a string (we use printable ASCII).
+ *
+ * Format: `${productKey}|${userId}`
+ *
+ * The `|` delimiter is unambiguous because productKey is one of:
+ *   - `vip.${number}`        — only digits and `.`
+ *   - `credits.${number}`    — only digits and `.`
+ *   - `perks.${key}`         — key restricted to `/^[a-z][a-z0-9_]*$/i`
+ *                              by `config.ts` validation
+ *
+ * None of those contain `|`, so the first `|` is always the delimiter.
+ * Worst case length is ~`perks.${64-char-key}|${20-digit-int}` ≈ 90 bytes
+ * — comfortably under the 128-byte cap. We assert the length to fail
+ * loud if the cap is ever approached.
+ */
+export type DecodedPayload = {
+    readonly productKey: string;
+    readonly userId: number;
+};
+/**
+ * Build the `invoice_payload` string for a `sendInvoice` call. Throws
+ * `Panic` if the result would exceed Telegram's 128-byte cap — that's
+ * either a bad productKey or a userId out of bounds, both of which are
+ * bugs we want to scream about.
+ */
+export declare const encodePayload: (productKey: string, userId: number) => string;
+/**
+ * Decode the `invoice_payload` Telegram echoes back. Returns `undefined`
+ * (NOT throws) on malformed input — Telegram could in principle deliver
+ * a payload from a different bot version, and we want the pre_checkout
+ * handler to be able to reject it gracefully rather than crashing.
+ */
+export declare const decodePayload: (payload: string) => DecodedPayload | undefined;
+//# sourceMappingURL=payload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../src/bot/payments/payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,YAAY,MAAM,EAAE,QAAQ,MAAM,KAAG,MAmBlE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,cAAc,GAAG,SAUhE,CAAC"}

package/dist/bot/payments/payload.js

@@ -0,0 +1,69 @@
+/**
+ * Invoice payload codec. Telegram echoes the `invoice_payload` string
+ * back on `pre_checkout_query` and `successful_payment`; we use it to
+ * recover the `(productKey, userId)` pair that the in-flight purchase
+ * refers to.
+ *
+ * Constraints from Telegram:
+ *   - Max 128 bytes.
+ *   - Must be a string (we use printable ASCII).
+ *
+ * Format: `${productKey}|${userId}`
+ *
+ * The `|` delimiter is unambiguous because productKey is one of:
+ *   - `vip.${number}`        — only digits and `.`
+ *   - `credits.${number}`    — only digits and `.`
+ *   - `perks.${key}`         — key restricted to `/^[a-z][a-z0-9_]*$/i`
+ *                              by `config.ts` validation
+ *
+ * None of those contain `|`, so the first `|` is always the delimiter.
+ * Worst case length is ~`perks.${64-char-key}|${20-digit-int}` ≈ 90 bytes
+ * — comfortably under the 128-byte cap. We assert the length to fail
+ * loud if the cap is ever approached.
+ */
+import { panic } from "../../offensive.js";
+const MAX_PAYLOAD_BYTES = 128;
+/**
+ * Build the `invoice_payload` string for a `sendInvoice` call. Throws
+ * `Panic` if the result would exceed Telegram's 128-byte cap — that's
+ * either a bad productKey or a userId out of bounds, both of which are
+ * bugs we want to scream about.
+ */
+export const encodePayload = (productKey, userId) => {
+    if (!productKey.length) {
+        panic("bot/payments/payload: encodePayload called with empty productKey");
+    }
+    if (!Number.isInteger(userId) || userId <= 0) {
+        panic(`bot/payments/payload: encodePayload userId must be positive integer (got ${userId})`);
+    }
+    const payload = `${productKey}|${userId}`;
+    // ASCII-only by construction (productKey shape + decimal digits), so
+    // .length === byte length. Cheap check.
+    if (payload.length > MAX_PAYLOAD_BYTES) {
+        panic(`bot/payments/payload: encoded payload ${payload.length}B exceeds Telegram's ` +
+            `${MAX_PAYLOAD_BYTES}B cap. productKey="${productKey}" userId=${userId}`);
+    }
+    return payload;
+};
+/**
+ * Decode the `invoice_payload` Telegram echoes back. Returns `undefined`
+ * (NOT throws) on malformed input — Telegram could in principle deliver
+ * a payload from a different bot version, and we want the pre_checkout
+ * handler to be able to reject it gracefully rather than crashing.
+ */
+export const decodePayload = (payload) => {
+    if (typeof payload !== "string" || payload.length === 0)
+        return undefined;
+    const idx = payload.indexOf("|");
+    if (idx <= 0 || idx === payload.length - 1)
+        return undefined;
+    const productKey = payload.slice(0, idx);
+    const userIdStr = payload.slice(idx + 1);
+    if (!/^\d+$/.test(userIdStr))
+        return undefined;
+    const userId = Number.parseInt(userIdStr, 10);
+    if (!Number.isInteger(userId) || userId <= 0)
+        return undefined;
+    return { productKey, userId };
+};
+//# sourceMappingURL=payload.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../src/bot/payments/payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAO9B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,UAAkB,EAAE,MAAc,EAAU,EAAE;IAC3E,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QACxB,KAAK,CAAC,kEAAkE,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC9C,KAAK,CACJ,4EAA4E,MAAM,GAAG,CACrF,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC;IAC1C,qEAAqE;IACrE,wCAAwC;IACxC,IAAI,OAAO,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;QACxC,KAAK,CACJ,yCAAyC,OAAO,CAAC,MAAM,uBAAuB;YAC7E,GAAG,iBAAiB,sBAAsB,UAAU,YAAY,MAAM,EAAE,CACzE,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAe,EAA8B,EAAE;IAC5E,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1E,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,KAAK,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7D,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC,CAAC"}

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

@@ -0,0 +1,88 @@
+/**
+ * Fragment payout ledger — the bot author's accounting surface.
+ *
+ * Fragment Corp redeems your accumulated XTR balance into TON paid to
+ * the configured wallet. That payout is the **income event** for
+ * Spanish autónomo IRPF purposes (CLAUDE.md §4); the per-charge log on
+ * Telegram's side is informational. We persist each payout you receive
+ * here, optionally tagged with the Spanish factura number, and provide
+ * an `export()` helper that joins charges falling in the payout's time
+ * window — that's what your gestor needs.
+ *
+ * Calling pattern (called by the bot author, NOT from inside an event
+ * handler):
+ *
+ *   import { Bot } from 'gramio'
+ *   const bot = new Bot(token); await bot.start()
+ *
+ *   // After confirming a Fragment payout to your TON wallet:
+ *   await payments.payouts.record(bot, {
+ *     ton: 12.34,
+ *     eurAtReceipt: 47.20,
+ *     fromMs: Date.parse('2026-05-01'),
+ *     toMs:   Date.parse('2026-06-01'),
+ *   })
+ *
+ *   // For the monthly gestor export:
+ *   const data = await payments.payouts.exportForUsers(bot, userIds, {
+ *     from: Date.parse('2026-05-01'),
+ *     to:   Date.parse('2026-06-01'),
+ *   })
+ *
+ * Fragment doesn't tag payouts with specific charges, so the join is
+ * **time-windowed**: payouts get `{ fromMs, toMs }` and the export
+ * pulls every `ChargeRecord` whose `receivedAt` falls inside.
+ */
+import type { AnyBot } from "gramio";
+import type { PaymentsStores } from "./stores.js";
+import type { ChargeRecord, PayoutRecord } from "./types.js";
+export type RecordPayoutInput = {
+    /** Amount of TON received from Fragment. */
+    ton: number;
+    /** EUR value at receipt time (snapshot — exchange rates move). */
+    eurAtReceipt: number;
+    /** Window covered by this payout, lower bound (ms since epoch). */
+    fromMs: number;
+    /** Window covered by this payout, upper bound (ms since epoch). */
+    toMs: number;
+    /** Optional Spanish factura number issued for this payout. */
+    facturaNumber?: string;
+    /** Override the auto-generated batchId. Default: `payout_${toMs}`. */
+    batchId?: string;
+};
+export declare const recordPayout: (bot: AnyBot, stores: PaymentsStores, input: RecordPayoutInput) => Promise<PayoutRecord>;
+export declare const listPayouts: (bot: AnyBot, stores: PaymentsStores) => Promise<PayoutRecord[]>;
+export type ExportInput = {
+    /** Window lower bound, ms since epoch. */
+    from: number;
+    /** Window upper bound, ms since epoch. */
+    to: number;
+};
+export type ExportResult = {
+    payouts: PayoutRecord[];
+    charges: ChargeRecord[];
+};
+/**
+ * Build the payout-only dataset for a time window. Returns every
+ * `PayoutRecord` whose `[fromMs, toMs]` overlaps the requested window.
+ *
+ * The `charges` field is intentionally empty — without a global charge
+ * index (v2 TODO) we can't enumerate every user's charges from one
+ * call. Use `exportPayoutsForUsers` with an explicit user-id list.
+ */
+export declare const exportPayouts: (bot: AnyBot, stores: PaymentsStores, input: ExportInput) => Promise<ExportResult>;
+/**
+ * Same as `exportPayouts` but with an explicit user-id list to scan.
+ * Pulls every NON-refunded `ChargeRecord` whose `receivedAt` falls in
+ * the requested window, joined by time rather than payout identity
+ * (Fragment doesn't expose that mapping).
+ */
+export declare const exportPayoutsForUsers: (bot: AnyBot, stores: PaymentsStores, userIds: ReadonlyArray<number>, input: ExportInput) => Promise<ExportResult>;
+export type PayoutsApi = {
+    record: (bot: AnyBot, input: RecordPayoutInput) => Promise<PayoutRecord>;
+    list: (bot: AnyBot) => Promise<PayoutRecord[]>;
+    export: (bot: AnyBot, input: ExportInput) => Promise<ExportResult>;
+    exportForUsers: (bot: AnyBot, userIds: ReadonlyArray<number>, input: ExportInput) => Promise<ExportResult>;
+};
+export declare const buildPayoutsApi: (stores: PaymentsStores) => PayoutsApi;
+//# sourceMappingURL=payouts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payouts.d.ts","sourceRoot":"","sources":["../../../src/bot/payments/payouts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAwB7D,MAAM,MAAM,iBAAiB,GAAG;IAC/B,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAyBF,eAAO,MAAM,YAAY,GACxB,KAAK,MAAM,EACX,QAAQ,cAAc,EACtB,OAAO,iBAAiB,KACtB,OAAO,CAAC,YAAY,CAMtB,CAAC;AAEF,eAAO,MAAM,WAAW,GACvB,KAAK,MAAM,EACX,QAAQ,cAAc,KACpB,OAAO,CAAC,YAAY,EAAE,CAOxB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;CACxB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GACzB,KAAK,MAAM,EACX,QAAQ,cAAc,EACtB,OAAO,WAAW,KAChB,OAAO,CAAC,YAAY,CAWtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GACjC,KAAK,MAAM,EACX,QAAQ,cAAc,EACtB,SAAS,aAAa,CAAC,MAAM,CAAC,EAC9B,OAAO,WAAW,KAChB,OAAO,CAAC,YAAY,CAqBtB,CAAC;AAIF,MAAM,MAAM,UAAU,GAAG;IACxB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACzE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC/C,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACnE,cAAc,EAAE,CACf,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,EAC9B,KAAK,EAAE,WAAW,KACd,OAAO,CAAC,YAAY,CAAC,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ,cAAc,KAAG,UAMvD,CAAC"}