@adriangalilea/utils 0.17.1 → 0.19.0

package/dist/bot/payments/plugin.js

@@ -0,0 +1,141 @@
+/**
+ * `botPayments({...})` — the top-level factory + GramIO plugin
+ * assembly.
+ *
+ * This file is **wiring only** per `bot/CLAUDE.md` § plugin file
+ * convention. Every handler body lives in its concern-specific
+ * neighbour (`derive.ts` / `handlers.ts` / `callbacks.ts` /
+ * `commands.ts` / `refund.ts`); this file's job is to stitch them
+ * into a `Plugin` chain.
+ *
+ * What gets wired:
+ *
+ *   - `ctx.payments.*` surface via `.derive()`        →  `derive.ts`
+ *   - `pre_checkout_query` handler                    →  `handlers.ts`
+ *   - `successful_payment` (dedicated event)          →  `handlers.ts`
+ *   - Waiver consent / cancel callbacks               →  `callbacks.ts` + `waiver.ts`
+ *   - Refund request / approve / deny / close         →  `callbacks.ts` + `refund.ts`
+ *   - `/paysupport` slash command                     →  `commands.ts`
+ *
+ * Returned alongside the plugin: `menuItem` (drop-in for `botMenu`),
+ * `payouts` (Fragment ledger), `admin` (read helpers for custom
+ * admin commands), and `onFulfilled` (event hook registration).
+ *
+ * See `CLAUDE.md` in this folder for the design rationale and flows.
+ */
+import { Plugin } from "gramio";
+import { panic } from "../../offensive.js";
+import { narrow } from "../ctx.js";
+import { buildRefundCloseHandler, buildWaiverCancelHandler, buildWaiverConsentHandler, } from "./callbacks.js";
+import { buildPaysupportCommand } from "./commands.js";
+import { buildCatalog, validateConfig } from "./config.js";
+import { buildPaymentsDerive } from "./derive.js";
+import { buildPreCheckoutHandler, buildSuccessfulPaymentHandler, } from "./handlers.js";
+import { buildPaymentsMenuItem } from "./menu-item.js";
+import { buildPayoutsApi } from "./payouts.js";
+import { buildRefundApproveHandler, buildRefundDenyHandler, buildRefundRequestHandler, refundApproveCb, refundCloseCb, refundDenyCb, refundRequestCb, } from "./refund.js";
+import { buildStores } from "./stores.js";
+import { waiverCancelCb, waiverConsentCb } from "./waiver.js";
+// ─── plugin assembly ───────────────────────────────────────────────
+const buildPlugin = (args) => {
+    const { cfg, catalog, sessionPlugin, storage, stores, onFulfilledMap } = args;
+    const paymentsDerive = buildPaymentsDerive({ cfg, catalog });
+    // handler factories (all bodies live in their concern files)
+    const successfulPaymentHandler = buildSuccessfulPaymentHandler({
+        stores,
+        cfg,
+        catalog,
+        // internals iterate this map per fulfillment, including `"*"` catch-all.
+        onFulfilled: onFulfilledMap,
+    });
+    const preCheckoutHandler = buildPreCheckoutHandler(catalog);
+    const refundApproveHandler = buildRefundApproveHandler({
+        stores,
+        storage,
+        cfg,
+    });
+    const refundDenyHandler = buildRefundDenyHandler({ stores, storage, cfg });
+    const refundRequestHandler = buildRefundRequestHandler({
+        stores,
+        storage,
+        cfg,
+    });
+    const waiverConsentHandler = buildWaiverConsentHandler({ cfg, catalog });
+    const waiverCancelHandler = buildWaiverCancelHandler();
+    const refundCloseHandler = buildRefundCloseHandler();
+    const paysupportCommand = buildPaysupportCommand(cfg);
+    return (new Plugin("@adriangalilea/utils/bot/payments", {
+        dependencies: ["@adriangalilea/utils/bot/admin"],
+    })
+        // Declare the shared session as a dep so types flow + runtime
+        // dedup ensures the session derive runs once per update.
+        .extend(sessionPlugin)
+        // ctx.payments builder — see derive.ts
+        .derive(["message", "callback_query"], paymentsDerive)
+        // pre_checkout_query — synchronous gate, 10s deadline
+        .on("pre_checkout_query", async (ctx, next) => {
+        await preCheckoutHandler(narrow(ctx));
+        await next();
+    })
+        // successful_payment — dedicated event (NOT a `message` rider;
+        // gramio puts it in `allowed_updates` only via the dedicated
+        // subscription, see CLAUDE.md §"foot-guns")
+        .on("successful_payment", async (ctx, next) => {
+        await successfulPaymentHandler(narrow(ctx));
+        await next();
+    })
+        // Waiver consent + cancel callbacks (bodies in callbacks.ts)
+        .callbackQuery(waiverConsentCb, waiverConsentHandler)
+        .callbackQuery(waiverCancelCb, waiverCancelHandler)
+        // Refund flow callbacks (bodies in refund.ts + callbacks.ts)
+        .callbackQuery(refundRequestCb, async (ctx) => {
+        const c = narrow(ctx);
+        const toast = await refundRequestHandler(c);
+        await c.answer(toast !== undefined ? { text: toast } : {});
+    })
+        .callbackQuery(refundApproveCb, async (ctx) => refundApproveHandler(narrow(ctx)))
+        .callbackQuery(refundDenyCb, async (ctx) => refundDenyHandler(narrow(ctx)))
+        .callbackQuery(refundCloseCb, refundCloseHandler)
+        // /paysupport (ToS §6.5; body in commands.ts)
+        .command("paysupport", { description: "Help & refunds for payments" }, paysupportCommand));
+};
+// ─── public factory ────────────────────────────────────────────────
+export const botPayments = (opts) => {
+    const { session: sessionPlugin, storage, ...rest } = opts;
+    const cfg = rest;
+    validateConfig(cfg);
+    const catalog = buildCatalog(cfg);
+    const stores = buildStores(storage);
+    const onFulfilledMap = new Map();
+    const plugin = buildPlugin({
+        cfg,
+        catalog,
+        sessionPlugin,
+        storage,
+        stores,
+        onFulfilledMap,
+    });
+    const menuItem = buildPaymentsMenuItem({ cfg, catalog });
+    const payouts = buildPayoutsApi(stores);
+    const admin = {
+        listCharges: async (ctx, userId) => {
+            const ids = await stores.userCharges(userId).list(ctx);
+            const charges = await Promise.all(ids.map((id) => stores.charges.get(ctx, id)));
+            return charges.filter((c) => c !== undefined);
+        },
+        getCharge: (ctx, chargeId) => stores.charges.get(ctx, chargeId),
+    };
+    const onFulfilled = (productKey, handler) => {
+        if (typeof productKey !== "string" || productKey.length === 0) {
+            panic("bot/payments: onFulfilled productKey must be a non-empty string");
+        }
+        if (typeof handler !== "function") {
+            panic("bot/payments: onFulfilled handler must be a function");
+        }
+        const arr = onFulfilledMap.get(productKey) ?? [];
+        arr.push(handler);
+        onFulfilledMap.set(productKey, arr);
+    };
+    return { plugin, menuItem, payouts, admin, onFulfilled };
+};
+//# sourceMappingURL=plugin.js.map

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

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

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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"}