@adriangalilea/utils 0.17.1 → 0.19.0

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

package/dist/bot/payments/types.js

@@ -0,0 +1,39 @@
+/**
+ * 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.
+ */
+/** Internal value Telegram expects on the wire (seconds). */
+export const SUBSCRIPTION_PERIOD_SECONDS = {
+    "30d": 2_592_000,
+};
+/**
+ * Fallback when `legal.privacyUrl` is omitted. Identical to the menu
+ * plugin's default — both surface the same policy text.
+ */
+export const DEFAULT_PRIVACY_URL = "https://telegram.org/privacy-tpa";
+// ─── error sentinel ────────────────────────────────────────────────
+/**
+ * Thrown by `credits.consume(n)` when the balance is below `n`.
+ * `tryConsume(n)` returns `false` instead.
+ */
+export class InsufficientCredits extends Error {
+    requested;
+    available;
+    constructor(requested, available) {
+        super(`InsufficientCredits: requested ${requested}, available ${available}`);
+        this.name = "InsufficientCredits";
+        this.requested = requested;
+        this.available = available;
+    }
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/bot/payments/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAcH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,2BAA2B,GAEpC;IACH,KAAK,EAAE,SAAS;CAChB,CAAC;AAwFF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,kCAAkC,CAAC;AAoQtE,sEAAsE;AAEtE;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACpC,SAAS,CAAS;IAClB,SAAS,CAAS;IAC3B,YAAY,SAAiB,EAAE,SAAiB;QAC/C,KAAK,CACJ,kCAAkC,SAAS,eAAe,SAAS,EAAE,CACrE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5B,CAAC;CACD"}

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

@@ -0,0 +1,81 @@
+/**
+ * Art. 103(m) TRLGDCU waiver flow.
+ *
+ * Three things have to happen together (see CLAUDE.md §5):
+ *
+ *   1. The user expresses *prior express consent* to begin execution.
+ *   2. They acknowledge they thereby lose the 14-day right of withdrawal.
+ *   3. The contract is confirmed on a durable medium.
+ *
+ * This module owns #1 and #2 via a separate, unbundled consent prompt
+ * — one inline message with the waiver text plus a single affirmative
+ * button. Bundling this into ToS acceptance voids the waiver under
+ * Spanish consumer law. #3 is satisfied implicitly by Telegram: every
+ * outgoing message the bot sends is preserved in the chat (durable).
+ *
+ * The bot author supplies the wording (Polyglot text + version string).
+ * Bumping `waiver.version` forces re-consent on the next purchase
+ * attempt; old consents stay attached to old charges for audit (see
+ * `ChargeRecord.waiverSnapshot`).
+ */
+import type { Storage } from "@gramio/storage";
+import { InlineKeyboard } from "gramio";
+import { type BotPaymentsConfig, type PaymentsSession, type WaiverRecord } from "./types.js";
+/**
+ * Callback fired when the user taps "✅ Consiento y comprendo" in the
+ * waiver consent prompt. Carries the productKey of the in-flight
+ * purchase so we can resume after persisting consent.
+ *
+ * `pk` (productKey) follows the shape validated by `payload.ts` —
+ * `vip.N` / `credits.N` / `perks.X` — all ASCII-safe.
+ */
+export declare const waiverConsentCb: import("gramio").CallbackData<Record<never, never>, Record<never, never>>;
+/** Fired when the user taps "❌ Cancelar" in the consent prompt. */
+export declare const waiverCancelCb: import("gramio").CallbackData<Record<never, never>, Record<never, never>>;
+/**
+ * Returns true when the stored consent matches the current waiver
+ * version — i.e. no re-consent needed before a purchase.
+ */
+export declare const isWaiverFresh: (stored: WaiverRecord | undefined, currentVersion: string) => boolean;
+/**
+ * Build the inline keyboard that accompanies the consent prompt. Three
+ * buttons:
+ *
+ *   📖 Términos — URL to `legal.termsUrl` (informational, not the
+ *                  affirmative action)
+ *   🔒 Privacidad — URL to `legal.privacyUrl` (same)
+ *   ✅ Consiento y comprendo — the single affirmative action
+ *   ❌ Cancelar — back out without consenting
+ *
+ * The "✅" button carries the productKey the user was about to buy, so
+ * the consent handler can resume the invoice flow on tap.
+ */
+export declare const waiverKeyboard: (cfg: BotPaymentsConfig<string>, productKey: string, lang: string) => InlineKeyboard;
+/**
+ * Render the consent body the user sees. Includes a short, neutral
+ * header above the wording supplied by the bot author. The header is
+ * separated by a blank line so reading order matches what consumer
+ * authorities expect (waiver text is unambiguous and prominent).
+ */
+export declare const renderConsentBody: (cfg: BotPaymentsConfig<string>, lang: string) => string;
+/**
+ * Persist a fresh waiver record onto the current ctx's session. Callers
+ * own the session shape via a structural narrow — this avoids a generic
+ * type bloom across the plugin.
+ */
+export declare const persistWaiverOnSession: (ctx: {
+    session: {
+        pay?: PaymentsSession;
+    };
+}, version: string, locale: string) => WaiverRecord;
+/**
+ * Persist a waiver record onto a SPECIFIC user's stored session (used
+ * when the consent tap arrives on a different ctx than the original
+ * `invoice()` call — rare, but possible if the user wedges multiple
+ * flows). The cross-user write is via storage directly, mirroring the
+ * pattern in `access-control.ts`.
+ */
+export declare const persistWaiverForUser: (storage: Storage, ctx: {
+    bot: unknown;
+}, userId: number, version: string, locale: string) => Promise<WaiverRecord>;
+//# sourceMappingURL=waiver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"waiver.d.ts","sourceRoot":"","sources":["../../../src/bot/payments/waiver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAMxC,OAAO,EACN,KAAK,iBAAiB,EAEtB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,MAAM,YAAY,CAAC;AAOpB;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,2EAA8C,CAAC;AAE3E,mEAAmE;AACnE,eAAO,MAAM,cAAc,2EAA+B,CAAC;AAI3D;;;GAGG;AACH,eAAO,MAAM,aAAa,GACzB,QAAQ,YAAY,GAAG,SAAS,EAChC,gBAAgB,MAAM,KACpB,OAGF,CAAC;AAiBF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAC1B,KAAK,iBAAiB,CAAC,MAAM,CAAC,EAC9B,YAAY,MAAM,EAClB,MAAM,MAAM,KACV,cA8BF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC7B,KAAK,iBAAiB,CAAC,MAAM,CAAC,EAC9B,MAAM,MAAM,KACV,MAWU,CAAC;AAId;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAClC,KAAK;IAAE,OAAO,EAAE;QAAE,GAAG,CAAC,EAAE,eAAe,CAAA;KAAE,CAAA;CAAE,EAC3C,SAAS,MAAM,EACf,QAAQ,MAAM,KACZ,YAUF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAChC,SAAS,OAAO,EAChB,KAAK;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,EACrB,QAAQ,MAAM,EACd,SAAS,MAAM,EACf,QAAQ,MAAM,KACZ,OAAO,CAAC,YAAY,CAatB,CAAC"}

package/dist/bot/payments/waiver.js

@@ -0,0 +1,145 @@
+/**
+ * Art. 103(m) TRLGDCU waiver flow.
+ *
+ * Three things have to happen together (see CLAUDE.md §5):
+ *
+ *   1. The user expresses *prior express consent* to begin execution.
+ *   2. They acknowledge they thereby lose the 14-day right of withdrawal.
+ *   3. The contract is confirmed on a durable medium.
+ *
+ * This module owns #1 and #2 via a separate, unbundled consent prompt
+ * — one inline message with the waiver text plus a single affirmative
+ * button. Bundling this into ToS acceptance voids the waiver under
+ * Spanish consumer law. #3 is satisfied implicitly by Telegram: every
+ * outgoing message the bot sends is preserved in the chat (durable).
+ *
+ * The bot author supplies the wording (Polyglot text + version string).
+ * Bumping `waiver.version` forces re-consent on the next purchase
+ * attempt; old consents stay attached to old charges for audit (see
+ * `ChargeRecord.waiverSnapshot`).
+ */
+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 { DEFAULT_PRIVACY_URL, } from "./types.js";
+const FALLBACK_LANG = "en";
+const log = createLogger("bot/payments");
+const cb = callbackNs("pay");
+/**
+ * Callback fired when the user taps "✅ Consiento y comprendo" in the
+ * waiver consent prompt. Carries the productKey of the in-flight
+ * purchase so we can resume after persisting consent.
+ *
+ * `pk` (productKey) follows the shape validated by `payload.ts` —
+ * `vip.N` / `credits.N` / `perks.X` — all ASCII-safe.
+ */
+export const waiverConsentCb = cb.data("waiver:consent", { pk: "string" });
+/** Fired when the user taps "❌ Cancelar" in the consent prompt. */
+export const waiverCancelCb = cb.data("waiver:cancel", {});
+// ─── pure helpers ──────────────────────────────────────────────────
+/**
+ * Returns true when the stored consent matches the current waiver
+ * version — i.e. no re-consent needed before a purchase.
+ */
+export const isWaiverFresh = (stored, currentVersion) => {
+    if (!stored)
+        return false;
+    return stored.version === currentVersion;
+};
+/**
+ * Resolve the waiver text Polyglot to a single string for the recipient's
+ * locale, with `'en'` fallback. Matches `say()`'s semantics for the
+ * dynamic-string escape hatch.
+ */
+const resolveWaiverText = (cfg, lang) => {
+    const text = cfg.waiver.text;
+    return text[lang] ?? text[FALLBACK_LANG] ?? Object.values(text)[0] ?? "";
+};
+// ─── consent prompt rendering ──────────────────────────────────────
+/**
+ * Build the inline keyboard that accompanies the consent prompt. Three
+ * buttons:
+ *
+ *   📖 Términos — URL to `legal.termsUrl` (informational, not the
+ *                  affirmative action)
+ *   🔒 Privacidad — URL to `legal.privacyUrl` (same)
+ *   ✅ Consiento y comprendo — the single affirmative action
+ *   ❌ Cancelar — back out without consenting
+ *
+ * The "✅" button carries the productKey the user was about to buy, so
+ * the consent handler can resume the invoice flow on tap.
+ */
+export const waiverKeyboard = (cfg, productKey, lang) => {
+    const kb = new InlineKeyboard();
+    const termsUrl = cfg.legal.termsUrl;
+    const privacyUrl = cfg.legal.privacyUrl ?? DEFAULT_PRIVACY_URL;
+    // Terms button only renders if the bot configured a termsUrl —
+    // there's no Telegram-side standard ToS to default to. Privacy
+    // always renders; it falls back to Telegram's Standard Bot Privacy
+    // Policy when unset (covers what this library retains by default).
+    if (termsUrl) {
+        kb.url(say({ en: "📖 Terms", es: "📖 Términos" }, lang), termsUrl);
+    }
+    kb.url(say({ en: "🔒 Privacy", es: "🔒 Privacidad" }, lang), privacyUrl);
+    kb.row();
+    kb.text(say({
+        en: "✅ I consent and understand",
+        es: "✅ Consiento y comprendo",
+    }, lang), waiverConsentCb.pack({ pk: productKey }), { style: "primary" });
+    kb.row();
+    kb.text(say({ en: "❌ Cancel", es: "❌ Cancelar" }, lang), waiverCancelCb.pack({}));
+    return kb;
+};
+/**
+ * Render the consent body the user sees. Includes a short, neutral
+ * header above the wording supplied by the bot author. The header is
+ * separated by a blank line so reading order matches what consumer
+ * authorities expect (waiver text is unambiguous and prominent).
+ */
+export const renderConsentBody = (cfg, lang) => [
+    say({
+        en: "Before continuing, please read and consent:",
+        es: "Antes de continuar, lee y consiente:",
+    }, lang),
+    "",
+    resolveWaiverText(cfg, lang),
+].join("\n");
+// ─── persistence ───────────────────────────────────────────────────
+/**
+ * Persist a fresh waiver record onto the current ctx's session. Callers
+ * own the session shape via a structural narrow — this avoids a generic
+ * type bloom across the plugin.
+ */
+export const persistWaiverOnSession = (ctx, version, locale) => {
+    const record = {
+        at: Date.now(),
+        version,
+        locale,
+    };
+    ctx.session.pay ??= {};
+    ctx.session.pay.waiver = record;
+    log.success(`waiver consent persisted: version=${version} locale=${locale}`);
+    return record;
+};
+/**
+ * Persist a waiver record onto a SPECIFIC user's stored session (used
+ * when the consent tap arrives on a different ctx than the original
+ * `invoice()` call — rare, but possible if the user wedges multiple
+ * flows). The cross-user write is via storage directly, mirroring the
+ * pattern in `access-control.ts`.
+ */
+export const persistWaiverForUser = async (storage, ctx, userId, version, locale) => {
+    const key = botStorageKey(ctx, userId);
+    const full = ((await storage.get(key)) ?? {});
+    const record = {
+        at: Date.now(),
+        version,
+        locale,
+    };
+    full.pay = { ...(full.pay ?? {}), waiver: record };
+    await storage.set(key, full);
+    return record;
+};
+//# sourceMappingURL=waiver.js.map

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

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