@adriangalilea/utils 0.18.0 → 0.19.0

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

@@ -0,0 +1,90 @@
+/**
+ * Pure state computation over the charge log.
+ *
+ * This file is `state.ts` (not `derive.ts`) because gramio's `derive`
+ * concept is reserved for ctx decoration (see `derive.ts` alongside,
+ * which builds `ctx.payments`). The reducers here are bot-id and ctx
+ * agnostic — they take `ChargeRecord[]` and a session-shaped object
+ * and mutate the session in place.
+ *
+ * The charge log (`pay:charge:{chargeId}`) is the single source of truth
+ * (CLAUDE.md §"Storage layout"). Session state is a cache for O(1)
+ * runtime checks. This module owns the function that rebuilds the cache
+ * from the log.
+ *
+ * Two surfaces:
+ *
+ *   `deriveState(charges)`     — pure, reduces a chronological list of
+ *                                NON-refunded charges into the cache
+ *                                shape. Used by reconcile and refund
+ *                                (after marking the refunded charge).
+ *
+ *   `applyCharge(session, …)`  — incremental, mutates one session record
+ *                                for a single new charge. Used by
+ *                                `handlers.ts` on `successful_payment`.
+ *
+ *   `revertCreditsForCharge(session, charge)` — targeted decrement
+ *                                used by refund (vip/perks are full
+ *                                re-derive territory; credits is not,
+ *                                because consumption isn't in the log).
+ *
+ * Credits balance is **not fully derivable** from the log alone — the
+ * log records grants, not consumption. `deriveState` therefore returns
+ * `totalCreditsGranted` (sum) and callers decide whether to use it as
+ * the balance (reconcile of fresh state) or to ignore (incremental).
+ */
+import type { ChargeRecord, DerivedPaymentsState, PaymentsSession } from "./types.js";
+/**
+ * Result of `deriveState`. `totalCreditsGranted` is informational —
+ * subtract consumption (which isn't logged) for the real balance.
+ */
+export type DeriveResult = DerivedPaymentsState & {
+    readonly totalCreditsGranted: number;
+};
+/**
+ * Pure reducer over a chronological list of charges. Caller is
+ * responsible for filtering out refunded ones if they want
+ * "current state after refunds" semantics.
+ */
+export declare const deriveState: (charges: ReadonlyArray<ChargeRecord>) => DeriveResult;
+/**
+ * Apply a single new charge to a session in place. Idempotent across
+ * `chargeId` because the caller (handlers.ts) guards via the
+ * `pay:idempotency:{chargeId}` sentinel before this fires; we don't
+ * re-check here.
+ *
+ *   - vip:     replaces `session.pay.vip` (renewals update expiresAt;
+ *              tier upgrades replace rung)
+ *   - credits: increments `session.pay.credits` by the granted amount
+ *              (covers both pack purchases AND vip renewal grants)
+ *   - perks:   set-if-absent on `session.pay.perks[key]`
+ */
+export declare const applyCharge: (session: {
+    pay?: PaymentsSession;
+}, charge: ChargeRecord) => void;
+/**
+ * Subtract a refunded charge's `creditsGranted` from the session
+ * balance, clamping at zero. The "clamp at zero" semantics are
+ * deliberate: a user may have already consumed credits when the refund
+ * arrives, and going negative would let them buy back into a debt — we
+ * refuse that and accept the asymmetry (the refunded Stars are already
+ * leaving the bot's balance via `refundStarPayment` either way).
+ */
+export declare const revertCreditsForCharge: (session: {
+    pay?: PaymentsSession;
+}, charge: ChargeRecord) => void;
+/**
+ * Rebuild vip + perks (the fully-derivable parts of session.pay.*)
+ * from a fresh chronological view of the charge log, **after** the
+ * caller has marked any newly-refunded charges. Credits balance is
+ * NOT touched — caller handles that explicitly via
+ * `revertCreditsForCharge` for the targeted decrement semantics.
+ *
+ * Used by:
+ *   - refund.ts after `refundStarPayment` succeeds
+ *   - reconcile (admin command) for full state recovery
+ */
+export declare const rebuildVipAndPerks: (session: {
+    pay?: PaymentsSession;
+}, charges: ReadonlyArray<ChargeRecord>) => void;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/bot/payments/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EACX,YAAY,EACZ,oBAAoB,EACpB,eAAe,EAGf,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,oBAAoB,GAAG;IACjD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACvB,SAAS,aAAa,CAAC,YAAY,CAAC,KAClC,YAwCF,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,GACvB,SAAS;IAAE,GAAG,CAAC,EAAE,eAAe,CAAA;CAAE,EAClC,QAAQ,YAAY,KAClB,IA0BF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAClC,SAAS;IAAE,GAAG,CAAC,EAAE,eAAe,CAAA;CAAE,EAClC,QAAQ,YAAY,KAClB,IAMF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAC9B,SAAS;IAAE,GAAG,CAAC,EAAE,eAAe,CAAA;CAAE,EAClC,SAAS,aAAa,CAAC,YAAY,CAAC,KAClC,IAMF,CAAC"}

package/dist/bot/payments/state.js

@@ -0,0 +1,149 @@
+/**
+ * Pure state computation over the charge log.
+ *
+ * This file is `state.ts` (not `derive.ts`) because gramio's `derive`
+ * concept is reserved for ctx decoration (see `derive.ts` alongside,
+ * which builds `ctx.payments`). The reducers here are bot-id and ctx
+ * agnostic — they take `ChargeRecord[]` and a session-shaped object
+ * and mutate the session in place.
+ *
+ * The charge log (`pay:charge:{chargeId}`) is the single source of truth
+ * (CLAUDE.md §"Storage layout"). Session state is a cache for O(1)
+ * runtime checks. This module owns the function that rebuilds the cache
+ * from the log.
+ *
+ * Two surfaces:
+ *
+ *   `deriveState(charges)`     — pure, reduces a chronological list of
+ *                                NON-refunded charges into the cache
+ *                                shape. Used by reconcile and refund
+ *                                (after marking the refunded charge).
+ *
+ *   `applyCharge(session, …)`  — incremental, mutates one session record
+ *                                for a single new charge. Used by
+ *                                `handlers.ts` on `successful_payment`.
+ *
+ *   `revertCreditsForCharge(session, charge)` — targeted decrement
+ *                                used by refund (vip/perks are full
+ *                                re-derive territory; credits is not,
+ *                                because consumption isn't in the log).
+ *
+ * Credits balance is **not fully derivable** from the log alone — the
+ * log records grants, not consumption. `deriveState` therefore returns
+ * `totalCreditsGranted` (sum) and callers decide whether to use it as
+ * the balance (reconcile of fresh state) or to ignore (incremental).
+ */
+/**
+ * Pure reducer over a chronological list of charges. Caller is
+ * responsible for filtering out refunded ones if they want
+ * "current state after refunds" semantics.
+ */
+export const deriveState = (charges) => {
+    let vip;
+    const perks = {};
+    let totalCreditsGranted = 0;
+    // Charges are oldest-first by convention. Vip latest-wins by
+    // receivedAt; perks first-wins (an idempotent unlock — buying twice
+    // shouldn't change the unlock date).
+    for (const c of charges) {
+        if (c.paysupportState === "refunded")
+            continue;
+        totalCreditsGranted += c.creditsGranted;
+        if (c.vipRung !== undefined && c.subscriptionExpiresAt !== undefined) {
+            // Replace the active subscription only when this charge is newer
+            // or this is the first vip charge encountered.
+            if (!vip || c.receivedAt >= (vip.expiresAt ?? 0) || c.receivedAt > 0) {
+                vip = {
+                    rung: c.vipRung,
+                    chargeId: c.chargeId,
+                    expiresAt: c.subscriptionExpiresAt,
+                    canceled: false,
+                };
+            }
+        }
+        if (c.perkKey && !perks[c.perkKey]) {
+            perks[c.perkKey] = {
+                chargeId: c.chargeId,
+                at: c.receivedAt,
+            };
+        }
+    }
+    return {
+        credits: totalCreditsGranted,
+        vip,
+        perks,
+        totalCreditsGranted,
+    };
+};
+/**
+ * Apply a single new charge to a session in place. Idempotent across
+ * `chargeId` because the caller (handlers.ts) guards via the
+ * `pay:idempotency:{chargeId}` sentinel before this fires; we don't
+ * re-check here.
+ *
+ *   - vip:     replaces `session.pay.vip` (renewals update expiresAt;
+ *              tier upgrades replace rung)
+ *   - credits: increments `session.pay.credits` by the granted amount
+ *              (covers both pack purchases AND vip renewal grants)
+ *   - perks:   set-if-absent on `session.pay.perks[key]`
+ */
+export const applyCharge = (session, charge) => {
+    session.pay ??= {};
+    const pay = session.pay;
+    if (charge.creditsGranted > 0) {
+        pay.credits = (pay.credits ?? 0) + charge.creditsGranted;
+    }
+    if (charge.vipRung !== undefined &&
+        charge.subscriptionExpiresAt !== undefined) {
+        pay.vip = {
+            rung: charge.vipRung,
+            chargeId: charge.chargeId,
+            expiresAt: charge.subscriptionExpiresAt,
+            canceled: false,
+        };
+    }
+    if (charge.perkKey) {
+        pay.perks ??= {};
+        if (!pay.perks[charge.perkKey]) {
+            pay.perks[charge.perkKey] = {
+                chargeId: charge.chargeId,
+                at: charge.receivedAt,
+            };
+        }
+    }
+};
+/**
+ * Subtract a refunded charge's `creditsGranted` from the session
+ * balance, clamping at zero. The "clamp at zero" semantics are
+ * deliberate: a user may have already consumed credits when the refund
+ * arrives, and going negative would let them buy back into a debt — we
+ * refuse that and accept the asymmetry (the refunded Stars are already
+ * leaving the bot's balance via `refundStarPayment` either way).
+ */
+export const revertCreditsForCharge = (session, charge) => {
+    if (!charge.creditsGranted)
+        return;
+    session.pay ??= {};
+    const pay = session.pay;
+    const current = pay.credits ?? 0;
+    pay.credits = Math.max(0, current - charge.creditsGranted);
+};
+/**
+ * Rebuild vip + perks (the fully-derivable parts of session.pay.*)
+ * from a fresh chronological view of the charge log, **after** the
+ * caller has marked any newly-refunded charges. Credits balance is
+ * NOT touched — caller handles that explicitly via
+ * `revertCreditsForCharge` for the targeted decrement semantics.
+ *
+ * Used by:
+ *   - refund.ts after `refundStarPayment` succeeds
+ *   - reconcile (admin command) for full state recovery
+ */
+export const rebuildVipAndPerks = (session, charges) => {
+    const derived = deriveState(charges);
+    session.pay ??= {};
+    const pay = session.pay;
+    pay.vip = derived.vip;
+    pay.perks = derived.perks;
+};
+//# sourceMappingURL=state.js.map

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * The plugin's storage layout, in one place.
+ *
+ * Replaces the scattered `chargeKey` / `userChargesIndexKey` /
+ * `idempotencyKey` / `payoutKey` / `payoutsIndexKey` helpers that used
+ * to live in `handlers.ts`, `refund.ts`, `payouts.ts`. Every storage
+ * operation in the plugin goes through one of these handles.
+ *
+ * Built once at plugin construction (in `plugin.ts`) and threaded
+ * through every concern that needs it.
+ */
+import type { Storage } from "@gramio/storage";
+import { botIndex, botRecord, botSentinel } from "../storage.js";
+import type { ChargeRecord, PayoutRecord } from "./types.js";
+export type PaymentsStores = {
+    /** `pay:charge:<chargeId>` — authoritative per-charge record. */
+    readonly charges: ReturnType<typeof botRecord<ChargeRecord>>;
+    /** `pay:idem:<chargeId>` — fulfillment idempotency sentinel. */
+    readonly idempotency: ReturnType<typeof botSentinel>;
+    /**
+     * `pay:user:<userId>:charges` — newest-first cap of chargeIds for
+     * `/refunds` listing + menu history (v2). Factory because the key
+     * is per-user.
+     */
+    readonly userCharges: (userId: number) => ReturnType<typeof botIndex>;
+    /** `pay:payout:<batchId>` — Fragment payout record. */
+    readonly payouts: ReturnType<typeof botRecord<PayoutRecord>>;
+    /** `pay:payouts:index` — newest-first batchIds for export. */
+    readonly payoutsIndex: ReturnType<typeof botIndex>;
+};
+/**
+ * Construct the plugin's storage handles. Called once at plugin
+ * construction; the result is passed into every concern that reads or
+ * writes plugin state.
+ *
+ * Schemas are wired in — every `.get()` on `charges` / `payouts` runs
+ * the corresponding zod schema's `.parse()` and throws a clear
+ * `SourcedError({ source: 'storage', operation: 'validate' })` on a
+ * corrupted record (instead of NaN-ing downstream when the consumer
+ * reads a now-missing field). `idempotency` is a presence-only sentinel
+ * so no schema applies; `*Index` stores `string[]` so likewise.
+ */
+export declare const buildStores: (storage: Storage) => PaymentsStores;
+//# sourceMappingURL=stores.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stores.d.ts","sourceRoot":"","sources":["../../../src/bot/payments/stores.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO7D,MAAM,MAAM,cAAc,GAAG;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;IAC7D,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IACrD;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;IACtE,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;IAC7D,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;CACnD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,OAAO,KAAG,cAS7C,CAAC"}

package/dist/bot/payments/stores.js

@@ -0,0 +1,39 @@
+/**
+ * The plugin's storage layout, in one place.
+ *
+ * Replaces the scattered `chargeKey` / `userChargesIndexKey` /
+ * `idempotencyKey` / `payoutKey` / `payoutsIndexKey` helpers that used
+ * to live in `handlers.ts`, `refund.ts`, `payouts.ts`. Every storage
+ * operation in the plugin goes through one of these handles.
+ *
+ * Built once at plugin construction (in `plugin.ts`) and threaded
+ * through every concern that needs it.
+ */
+import { botIndex, botRecord, botSentinel } from "../storage.js";
+import { chargeRecordSchema, payoutRecordSchema } from "./schemas.js";
+/** Cap on the per-user `pay:user:<id>:charges` index. Older charges
+ *  drop off the list but remain in `pay:charge:<id>` for the gestor
+ *  export (which scans charges directly, not the index). */
+const USER_CHARGES_CAP = 100;
+/**
+ * Construct the plugin's storage handles. Called once at plugin
+ * construction; the result is passed into every concern that reads or
+ * writes plugin state.
+ *
+ * Schemas are wired in — every `.get()` on `charges` / `payouts` runs
+ * the corresponding zod schema's `.parse()` and throws a clear
+ * `SourcedError({ source: 'storage', operation: 'validate' })` on a
+ * corrupted record (instead of NaN-ing downstream when the consumer
+ * reads a now-missing field). `idempotency` is a presence-only sentinel
+ * so no schema applies; `*Index` stores `string[]` so likewise.
+ */
+export const buildStores = (storage) => ({
+    charges: botRecord(storage, "pay:charge", chargeRecordSchema),
+    idempotency: botSentinel(storage, "pay:idem"),
+    userCharges: (userId) => botIndex(storage, `pay:user:${userId}:charges`, {
+        capacity: USER_CHARGES_CAP,
+    }),
+    payouts: botRecord(storage, "pay:payout", payoutRecordSchema),
+    payoutsIndex: botIndex(storage, "pay:payouts:index"),
+});
+//# sourceMappingURL=stores.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stores.js","sourceRoot":"","sources":["../../../src/bot/payments/stores.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGtE;;4DAE4D;AAC5D,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAmB7B;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAgB,EAAkB,EAAE,CAAC,CAAC;IACjE,OAAO,EAAE,SAAS,CAAe,OAAO,EAAE,YAAY,EAAE,kBAAkB,CAAC;IAC3E,WAAW,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7C,WAAW,EAAE,CAAC,MAAc,EAAE,EAAE,CAC/B,QAAQ,CAAC,OAAO,EAAE,YAAY,MAAM,UAAU,EAAE;QAC/C,QAAQ,EAAE,gBAAgB;KAC1B,CAAC;IACH,OAAO,EAAE,SAAS,CAAe,OAAO,EAAE,YAAY,EAAE,kBAAkB,CAAC;IAC3E,YAAY,EAAE,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;CACpD,CAAC,CAAC"}

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

@@ -0,0 +1,299 @@
+/**
+ * Type surface for `bot/payments`. Two layers:
+ *
+ *   1. **Config shapes** the consumer authors (`BotPaymentsConfig`).
+ *   2. **Derived types** the consumer reads through `ctx.payments`
+ *      (`TierKey`, `AtLeastKey`, `ProductKey`) — narrowed from their
+ *      config so e.g. `atLeast('vip.5')` is a TS error when only 2
+ *      rungs are declared.
+ *
+ * Internal types (the ledger records, the catalog) live below and aren't
+ * exported through the package entrypoint.
+ *
+ * See `CLAUDE.md` in this folder for the design rationale.
+ */
+import type { Polyglot } from "../../say/index.js";
+/**
+ * The only Telegram-supported subscription period as of 2026 is exactly
+ * 2,592,000 seconds (30 days). Modeled as a literal so misconfigurations
+ * fail at compile time. See `sendInvoice` /
+ * `createInvoiceLink` docs at https://core.telegram.org/bots/api.
+ */
+export type SubscriptionPeriod = "30d";
+/** Internal value Telegram expects on the wire (seconds). */
+export declare const SUBSCRIPTION_PERIOD_SECONDS: Readonly<Record<SubscriptionPeriod, number>>;
+/**
+ * One rung of the VIP ladder. Position in the array is the rank (1-based
+ * id at the call site: `vip.1`, `vip.2`, …). Insert a rung at position 2
+ * → existing subscribers on rung 2+ shift by one, plus a trivial storage
+ * migration; no string-id churn.
+ *
+ * `name` is display-only Polyglot — renaming a rung is a config edit; the
+ * call sites (`atLeast('vip.2')`) are positional and untouched.
+ *
+ * `grants.credits` is applied **on every renewal** of this rung (not just
+ * the initial purchase). That's the canonical SaaS shape: "VIP gets 1000
+ * messages per month."
+ */
+export type VipRung<L extends string = string> = {
+    readonly xtr: number;
+    readonly period: SubscriptionPeriod;
+    readonly name: Polyglot<L>;
+    readonly grants?: {
+        readonly credits?: number;
+    };
+};
+/**
+ * A consumable credit pack the user buys one-shot to top up their
+ * `session.pay.credits` balance. Like VIP rungs, packs are positionally
+ * identified (`credits.1`, `credits.2`, …) so the call site doesn't carry
+ * a name. Adding/removing packs shifts ids; storage is the charge log
+ * (which records the exact productKey at purchase time), so historical
+ * charges stay valid even if you remove a pack later.
+ */
+export type CreditsPack<L extends string = string> = {
+    readonly xtr: number;
+    readonly grants: {
+        readonly credits: number;
+    };
+    readonly name?: Polyglot<L>;
+};
+/**
+ * Credits axis config. `unit` is the user-facing word for one credit
+ * (the menu says e.g. "1234 mensajes"). `packs` is the catalogue of
+ * top-up bundles surfaced in the menu and via `invoice('credits.N')`.
+ */
+export type CreditsConfig<L extends string = string> = {
+    readonly unit: Polyglot<L>;
+    readonly packs: ReadonlyArray<CreditsPack<L>>;
+};
+/**
+ * Orthogonal one-shot unlock (a "perk"). Named via the user's own key in
+ * the config (`perks: { voice_mode: { … } }`), surfaced as
+ * `perks.voice_mode` everywhere.
+ */
+export type Perk<L extends string = string> = {
+    readonly xtr: number;
+    readonly name: Polyglot<L>;
+};
+export type PerksConfig<L extends string = string> = Readonly<Record<string, Perk<L>>>;
+export type LegalConfig = {
+    readonly sellerName: string;
+    readonly nif: string;
+    /**
+     * Optional terms-of-service URL. When omitted, the consent prompt's
+     * 📖 Terms button is hidden — there's no Telegram-side standard ToS
+     * to default to (unlike `privacyUrl`).
+     */
+    readonly termsUrl?: string;
+    /**
+     * Optional privacy policy URL. When omitted, defaults to Telegram's
+     * [Standard Bot Privacy Policy](https://telegram.org/privacy-tpa),
+     * which covers what this library's plugins retain (session record,
+     * waiver consent, charge log) under "data necessary to function".
+     * Override only when your bot retains data beyond what the standard
+     * covers.
+     */
+    readonly privacyUrl?: string;
+};
+/**
+ * Fallback when `legal.privacyUrl` is omitted. Identical to the menu
+ * plugin's default — both surface the same policy text.
+ */
+export declare const DEFAULT_PRIVACY_URL = "https://telegram.org/privacy-tpa";
+/**
+ * Art. 103(m) TRLGDCU waiver text. Versioned so a wording change forces
+ * re-consent; the version string is stored alongside each charge for audit.
+ *
+ * The Polyglot covers every locale the bot supports — the plugin
+ * validates this at construction.
+ */
+export type WaiverConfig<L extends string = string> = {
+    readonly version: string;
+    readonly text: Polyglot<L>;
+};
+/**
+ * What the bot author passes to `botPayments({...})`. The generic `L`
+ * carries the bot's Polyglot language union forward into every nested
+ * `Polyglot<L>`, so TS catches a missing locale in any sub-config.
+ */
+export type BotPaymentsConfig<L extends string = string> = {
+    readonly paysupport: string;
+    readonly legal: LegalConfig;
+    readonly waiver: WaiverConfig<L>;
+    readonly vip?: ReadonlyArray<VipRung<L>>;
+    readonly credits?: CreditsConfig<L>;
+    readonly perks?: PerksConfig<L>;
+};
+type _Range1To<N extends number, Acc extends unknown[] = [unknown]> = Acc["length"] extends N ? Acc["length"] : Acc["length"] | _Range1To<N, [...Acc, unknown]>;
+/**
+ * Positional 1-based ids for a tuple. `[a,b,c]` → `1 | 2 | 3`.
+ *
+ * Empty tuple → `never` (no ids exist).
+ */
+export type Indices1<V extends ReadonlyArray<unknown>> = V["length"] extends 0 ? never : V["length"] extends number ? _Range1To<V["length"]> : never;
+/**
+ * Tier ids derivable from a `vip` config array. Bare `'vip'` is also
+ * accepted as "any rung" by `atLeast` (see `AtLeastKey`).
+ */
+export type VipPositionalKeys<V extends ReadonlyArray<unknown> | undefined> = V extends ReadonlyArray<unknown> ? `vip.${Indices1<V>}` : never;
+export type CreditsPackKeys<C extends CreditsConfig<string> | undefined> = C extends {
+    packs: infer P;
+} ? P extends ReadonlyArray<unknown> ? `credits.${Indices1<P>}` : never : never;
+export type PerkKeys<P extends PerksConfig<string> | undefined> = P extends PerksConfig<string> ? `perks.${keyof P & string}` : never;
+/**
+ * Every product the user can purchase. Discriminated by prefix. Note
+ * `perks.X` uses the **author-supplied key** verbatim (e.g.
+ * `perks.voice_mode`) while `vip.N` / `credits.N` are positional.
+ */
+export type ProductKey<Cfg extends BotPaymentsConfig<string>> = VipPositionalKeys<Cfg["vip"]> | CreditsPackKeys<Cfg["credits"]> | PerkKeys<Cfg["perks"]>;
+/**
+ * What `ctx.payments.tier()` can return. `'free'` is the bottom rung;
+ * `vip.N` follows the ladder.
+ */
+export type TierKey<Cfg extends BotPaymentsConfig<string>> = "free" | VipPositionalKeys<Cfg["vip"]>;
+/**
+ * What `ctx.payments.atLeast(...)` accepts. Same as `TierKey` minus
+ * `'free'` (atLeast('free') is trivially always true and unhelpful as a
+ * gate) plus the bare `'vip'` synonym for "any rung in the namespace".
+ */
+export type AtLeastKey<Cfg extends BotPaymentsConfig<string>> = "vip" | VipPositionalKeys<Cfg["vip"]>;
+export type VipRungResolved = {
+    readonly id: `vip.${number}`;
+    readonly rank: number;
+    readonly xtr: number;
+    readonly periodSeconds: number;
+    readonly name: Polyglot<string>;
+    readonly creditsGranted: number;
+};
+export type CreditsPackResolved = {
+    readonly id: `credits.${number}`;
+    readonly xtr: number;
+    readonly creditsGranted: number;
+    readonly name?: Polyglot<string>;
+};
+export type PerkResolved = {
+    readonly id: `perks.${string}`;
+    readonly key: string;
+    readonly xtr: number;
+    readonly name: Polyglot<string>;
+};
+export type ProductCatalog = {
+    readonly vip: ReadonlyArray<VipRungResolved>;
+    readonly creditsUnit: Polyglot<string> | undefined;
+    readonly creditsPacks: ReadonlyArray<CreditsPackResolved>;
+    readonly perks: ReadonlyArray<PerkResolved>;
+    /** O(1) lookup by ProductKey. */
+    readonly byKey: ReadonlyMap<string, VipRungResolved | CreditsPackResolved | PerkResolved>;
+};
+export type WaiverRecord = {
+    readonly at: number;
+    readonly version: string;
+    readonly locale: string;
+};
+export type VipState = {
+    /** 1-based rank — index into the resolved vip ladder + 1. */
+    readonly rung: number;
+    /** Original `telegram_payment_charge_id` of the active subscription. */
+    readonly chargeId: string;
+    /** Telegram's `subscription_expiration_date` — unix seconds. */
+    readonly expiresAt: number;
+    /** True after the user toggled cancel-renewal; access keeps until `expiresAt`. */
+    readonly canceled: boolean;
+};
+export type PerkState = {
+    readonly chargeId: string;
+    readonly at: number;
+};
+export type PaymentsSession = {
+    waiver?: WaiverRecord;
+    credits?: number;
+    vip?: VipState;
+    perks?: Record<string, PerkState>;
+};
+export type PaysupportState = "none" | "opened" | "refunded";
+export type ChargeRecord = {
+    readonly chargeId: string;
+    readonly userId: number;
+    readonly productKey: string;
+    readonly xtr: number;
+    readonly receivedAt: number;
+    /** Decoded invoice payload echoed back from Telegram. */
+    readonly payload: string;
+    /**
+     * Waiver snapshot at purchase time. Captured even if the user
+     * already consented earlier — defensive forensics.
+     */
+    readonly waiverSnapshot: WaiverRecord;
+    /**
+     * Telegram's `subscription_expiration_date` (unix seconds) if this
+     * charge was a subscription purchase. Used to compute tier expiry.
+     */
+    readonly subscriptionExpiresAt?: number;
+    /**
+     * Credits this charge grants at fulfillment / renewal. Denormalized
+     * onto the record so derivation works even if the catalog config
+     * later changes (rare, but the charge log must remain authoritative
+     * regardless of source-code edits). Zero for products that don't
+     * grant credits.
+     */
+    readonly creditsGranted: number;
+    /**
+     * 1-based vip rung this charge subscribed to, denormalized for the
+     * same reason as `creditsGranted`. Only set for `vip.*` charges.
+     */
+    readonly vipRung?: number;
+    /**
+     * Perk key this charge unlocked, denormalized. Only set for
+     * `perks.*` charges.
+     */
+    readonly perkKey?: string;
+    paysupportState: PaysupportState;
+    refundedAt?: number | null;
+    /** Set after `record()` claims this charge into a payout batch. */
+    payoutBatchId?: string | null;
+};
+export type PayoutRecord = {
+    readonly batchId: string;
+    readonly fromMs: number;
+    readonly toMs: number;
+    readonly tonAmount: number;
+    readonly eurAtReceipt: number;
+    readonly recordedAt: number;
+    /** Optional Spanish factura number issued for this payout. */
+    facturaNumber?: string;
+};
+/**
+ * Snapshot returned by `derive.ts` — pure function of the charge log
+ * for a given user. The plugin writes this into `session.pay.*` so
+ * runtime checks are O(1), but the log is always the truth.
+ */
+export type DerivedPaymentsState = {
+    readonly credits: number;
+    readonly vip: VipState | undefined;
+    readonly perks: Record<string, PerkState>;
+};
+/**
+ * What `payments.onFulfilled(productKey, handler)` receives. Sync
+ * signature on purpose — the plugin always answers the
+ * `successful_payment` event itself; the handler does its own async work
+ * fire-and-forget.
+ */
+export type FulfillmentEvent = {
+    readonly productKey: string;
+    readonly userId: number;
+    readonly chargeId: string;
+    readonly xtr: number;
+    readonly receivedAt: number;
+};
+/**
+ * Thrown by `credits.consume(n)` when the balance is below `n`.
+ * `tryConsume(n)` returns `false` instead.
+ */
+export declare class InsufficientCredits extends Error {
+    readonly requested: number;
+    readonly available: number;
+    constructor(requested: number, available: number);
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/bot/payments/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAInD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAEvC,6DAA6D;AAC7D,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CACjD,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAGlC,CAAC;AAIF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE;QACjB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE;QAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IACtD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,QAAQ,CAC5D,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CACvB,CAAC;AAIF,MAAM,MAAM,WAAW,GAAG;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,qCAAqC,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;CAC3B,CAAC;AAIF;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CAChC,CAAC;AAUF,KAAK,SAAS,CACb,CAAC,SAAS,MAAM,EAChB,GAAG,SAAS,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,IAC9B,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,GACxB,GAAG,CAAC,QAAQ,CAAC,GACb,GAAG,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;AAEnD;;;;GAIG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAC3E,KAAK,GACL,CAAC,CAAC,QAAQ,CAAC,SAAS,MAAM,GACzB,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GACtB,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,aAAa,CAAC,OAAO,CAAC,GAAG,SAAS,IACzE,CAAC,SAAS,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC;AAEjE,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,IACtE,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC,CAAA;CAAE,GACzB,CAAC,SAAS,aAAa,CAAC,OAAO,CAAC,GAC/B,WAAW,QAAQ,CAAC,CAAC,CAAC,EAAE,GACxB,KAAK,GACN,KAAK,CAAC;AAEV,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,IAC7D,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,GAAG,SAAS,iBAAiB,CAAC,MAAM,CAAC,IACzD,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAC7B,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAC/B,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAE1B;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,GAAG,SAAS,iBAAiB,CAAC,MAAM,CAAC,IACtD,MAAM,GACN,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAEjC;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,GAAG,SAAS,iBAAiB,CAAC,MAAM,CAAC,IACzD,KAAK,GACL,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AASjC,MAAM,MAAM,eAAe,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,OAAO,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC,QAAQ,CAAC,EAAE,EAAE,WAAW,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC1D,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAC5C,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAC1B,MAAM,EACN,eAAe,GAAG,mBAAmB,GAAG,YAAY,CACpD,CAAC;CACF,CAAC;AAOF,MAAM,MAAM,YAAY,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC7B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClC,CAAC;AAIF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE7D,MAAM,MAAM,YAAY,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,eAAe,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAC1C,CAAC;AAIF;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B,CAAC;AAIF;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBACf,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAQhD"}