@genesis-tech/genesispay-seller 0.13.1 → 1.3.0

package/dist/mandate-gate.js

@@ -0,0 +1,183 @@
+/**
+ * Mandate gate — the signature-free metered path for humans and subscriptions.
+ *
+ * Instead of demanding a fresh signed payment per request (the x402 gate), the
+ * caller presents a standing payment mandate id via the `GENESISPAY-MANDATE`
+ * header. The gate debits the mandate through GenesisPay
+ * (`POST /api/v1/mandates/:id/charge`) — a non-custodial on-chain pull from
+ * the payer's wallet directly to yours — and only runs your handler once the
+ * charge settled. Combine with `createPaymentGate` to accept both per-call
+ * x402 payments and mandate-metered calls on one endpoint.
+ */
+import { parseUsdcAmountToMinorUnits } from "./usdc-amount.js";
+export const MANDATE_HEADER = "GENESISPAY-MANDATE";
+const MANDATE_IDEMPOTENCY_KEY = /^[A-Za-z0-9][A-Za-z0-9._:-]{7,199}$/;
+const TRANSACTION_HASH = /^0x[0-9a-f]{64}$/i;
+function validIdempotencyKey(value) {
+    const key = value?.trim();
+    return key &&
+        key.toLowerCase() !== "undefined" &&
+        MANDATE_IDEMPOTENCY_KEY.test(key)
+        ? key
+        : null;
+}
+export function createMandateGate(options) {
+    const apiKey = options.apiKey?.trim();
+    if (!apiKey) {
+        throw new Error("createMandateGate requires a GenesisPay seller API key (gp_sk_...).");
+    }
+    const baseUrl = options.baseUrl?.trim().replace(/\/+$/, "");
+    if (!baseUrl) {
+        throw new Error("createMandateGate requires the GenesisPay base URL.");
+    }
+    if (!/^\d+(\.\d{1,6})?$/.test(options.amount)) {
+        throw new Error("createMandateGate requires a decimal amount with up to 6 decimals, e.g. \"0.08\".");
+    }
+    const expectedAmountMinor = parseUsdcAmountToMinorUnits(options.amount).toString();
+    const fetchFn = options.fetchFn ?? fetch;
+    async function charge(mandateId, resourceUrl, idempotencyKey) {
+        const stableKey = validIdempotencyKey(idempotencyKey);
+        if (!stableKey) {
+            return {
+                ok: false,
+                status: 400,
+                code: "invalid_idempotency_key",
+                error: "Idempotency-Key is required for mandate charges and must be reused after an outcome-unknown response.",
+            };
+        }
+        let response;
+        try {
+            response = await fetchFn(`${baseUrl}/api/v1/mandates/${encodeURIComponent(mandateId)}/charge`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${apiKey}`,
+                    "Idempotency-Key": stableKey,
+                },
+                body: JSON.stringify({
+                    amount: options.amount,
+                    resourceUrl,
+                    description: options.description,
+                }),
+            });
+        }
+        catch (error) {
+            return {
+                ok: false,
+                status: 503,
+                error: `GenesisPay is unreachable: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+        let body = null;
+        try {
+            body = await response.json();
+        }
+        catch {
+            // Non-JSON error body; fall through with a generic message.
+        }
+        const record = (body ?? {});
+        if (!response.ok) {
+            const chargeRecord = (record.charge ?? null);
+            return {
+                ok: false,
+                status: response.status,
+                code: typeof record.code === "string" ? record.code : undefined,
+                error: typeof record.error === "string"
+                    ? record.error
+                    : `GenesisPay rejected the mandate charge (${response.status}).`,
+                ...(chargeRecord && typeof chargeRecord.id === "string"
+                    ? {
+                        charge: {
+                            id: chargeRecord.id,
+                            amountMinor: String(chargeRecord.amountMinor ?? ""),
+                            txHash: typeof chargeRecord.txHash === "string"
+                                ? chargeRecord.txHash
+                                : null,
+                        },
+                    }
+                    : {}),
+            };
+        }
+        const chargeRecord = record.charge &&
+            typeof record.charge === "object" &&
+            !Array.isArray(record.charge)
+            ? record.charge
+            : null;
+        const chargeId = typeof chargeRecord?.id === "string" ? chargeRecord.id : "";
+        const amountMinor = typeof chargeRecord?.amountMinor === "string"
+            ? chargeRecord.amountMinor
+            : "";
+        const txHash = typeof chargeRecord?.txHash === "string" ? chargeRecord.txHash : "";
+        if (chargeRecord?.status !== "settled" ||
+            chargeId.trim().length === 0 ||
+            amountMinor !== expectedAmountMinor ||
+            !TRANSACTION_HASH.test(txHash)) {
+            return {
+                ok: false,
+                status: 503,
+                code: "charge_response_unverified",
+                error: "GenesisPay did not return a verified settled mandate charge. Do not retry with a new Idempotency-Key.",
+                ...(chargeId.trim().length > 0
+                    ? {
+                        charge: {
+                            id: chargeId,
+                            amountMinor,
+                            txHash: TRANSACTION_HASH.test(txHash) ? txHash : null,
+                        },
+                    }
+                    : {}),
+            };
+        }
+        return {
+            ok: true,
+            charge: {
+                id: chargeId,
+                amountMinor,
+                txHash,
+            },
+        };
+    }
+    function wrap(handler) {
+        return async (request) => {
+            const mandateId = request.headers.get(MANDATE_HEADER)?.trim();
+            if (!mandateId) {
+                return jsonResponse({
+                    error: "Payment required.",
+                    howToPay: `Attach an active GenesisPay mandate id via the ${MANDATE_HEADER} header, or pay per call via x402.`,
+                    amount: options.amount,
+                }, 402);
+            }
+            const idempotencyKey = validIdempotencyKey(request.headers.get("Idempotency-Key"));
+            if (!idempotencyKey) {
+                return jsonResponse({
+                    error: "Idempotency-Key is required for a mandate-metered request and must be reused after a timeout.",
+                    code: "invalid_idempotency_key",
+                }, 400);
+            }
+            const outcome = await charge(mandateId, request.url, idempotencyKey);
+            if (!outcome.ok) {
+                return jsonResponse({
+                    error: outcome.error,
+                    code: outcome.code,
+                    ...(outcome.charge ? { charge: outcome.charge } : {}),
+                }, outcome.status);
+            }
+            const response = await handler(request);
+            const headers = new Headers(response.headers);
+            headers.set("GENESISPAY-MANDATE-CHARGE", outcome.charge.id);
+            return new Response(response.body, {
+                status: response.status,
+                statusText: response.statusText,
+                headers,
+            });
+        };
+    }
+    return { charge, wrap };
+}
+function jsonResponse(body, status) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { "Content-Type": "application/json" },
+    });
+}
+//# sourceMappingURL=mandate-gate.js.map

package/dist/mandate-gate.js.map

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

package/dist/mandates.d.ts

@@ -0,0 +1,189 @@
+import { type GenesisPayRequest } from "./resource.js";
+import { type ContractUsageCharge, type ContractUsageInput } from "./contract-usage.js";
+import type { Hex } from "viem";
+import { type ContractPerUseCreateInput, type ContractPerUseCreateResult, type ContractSubscriptionCreateInput, type ContractSubscriptionCreateResult } from "./contract-mandates.js";
+export type MandateKind = "per_use" | "subscription";
+export type MandateStatus = "pending_permit" | "active" | "past_due" | "revoked" | "expired" | "cancelled";
+export type MandateChargeStatus = "pending" | "submitted" | "settled" | "failed";
+export type Mandate = {
+    protocol?: "contract_mandate_v1";
+    activationStatus?: "proposed" | "submitted" | "confirmed";
+    revocationStatus?: "none" | "requested" | "confirmed";
+    executor?: string;
+    contractVersion?: string;
+    id: string;
+    kind: MandateKind;
+    status: MandateStatus;
+    asset: "USDC" | "EURC";
+    chainId: number;
+    payerWallet: string;
+    destinationWallet: string;
+    /**
+     * The subscription plan this mandate was signed from, or `null` when it was
+     * proposed directly via `mandates.create` — that path has no plan, and one
+     * supplied by the caller would let a mandate be attributed to a foreign plan.
+     * `null` is a valid state, not a missing value; older mandates have it too.
+     */
+    subscriptionPlanId: string | null;
+    /** Total approved spend, in 6-decimal minor units (string — no precision loss). */
+    allowanceMinor: string;
+    /** Ceiling for any single charge, in minor units. */
+    capPerChargeMinor: string;
+    spentMinor: string;
+    /** `allowanceMinor - spentMinor`, as the server computes it. */
+    remainingMinor: string;
+    /** Subscription mandates only; null for `per_use`. */
+    amountPerPeriodMinor: string | null;
+    /** Subscription mandates only; null for `per_use`. */
+    periodDays: number | null;
+    nextChargeAt: string | null;
+    /** After this the unsubmitted permit is dead and the mandate needs re-signing. */
+    permitDeadline: string;
+    permitTxHash: string | null;
+    createdAt: string;
+    /** Set after canonical activation confirmation. HTTP acceptance is not activation. */
+    activatedAt: string | null;
+    revokedAt: string | null;
+};
+/**
+ * The EIP-712 payload the payer's wallet signs (`eth_signTypedData_v4`).
+ *
+ * Passed through **verbatim** from the server rather than remapped: a signature
+ * covers the exact bytes of this structure, so normalizing a field would
+ * produce a signature over something other than what the contract verifies.
+ */
+export type PermitTypedData = {
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract: string;
+    };
+    types: Record<string, ReadonlyArray<{
+        name: string;
+        type: string;
+    }>>;
+    primaryType: string;
+    message: {
+        owner: string;
+        spender: string;
+        value: string;
+        nonce: string;
+        deadline: string;
+    };
+};
+export type MandateCreateInput = {
+    payerWallet: string;
+    kind: MandateKind;
+    /** Total spending approval as a decimal amount, e.g. "20". */
+    allowance: string;
+    /** Ceiling for a single charge as a decimal amount, e.g. "0.10". */
+    capPerCharge: string;
+    /** Required for `kind: "subscription"`. Decimal amount, e.g. "9". */
+    amountPerPeriod?: string;
+    /** Required for `kind: "subscription"`. Whole days, e.g. 30. */
+    periodDays?: number;
+    /** Defaults to USDC. */
+    asset?: "USDC" | "EURC";
+    /** Defaults to the account's receiving wallet. */
+    destinationWallet?: string;
+};
+export type MandateCreateResult = {
+    mandate: Mandate;
+    /** Give this to the payer's wallet to sign; then activate from the frontend. */
+    permitTypedData: PermitTypedData;
+    /** The facilitator address the permit approves as spender. */
+    spender: string;
+};
+export type MandateChargeInput = {
+    /** Decimal amount, e.g. "0.08". Must not exceed the mandate's cap per charge. */
+    amount: string;
+    /** Stable identity for this logical usage request; reuse it after timeouts. */
+    idempotencyKey: string;
+    /** What was paid for — surfaced to the payer in their mandate history. */
+    resourceUrl?: string;
+    description?: string;
+};
+export type MandateCharge = {
+    id: string;
+    status: MandateChargeStatus;
+    amountMinor: string;
+    /** Null while the pull is still pending, and for a failed charge. */
+    txHash: string | null;
+};
+export type MandateListOptions = {
+    /**
+     * A plan's **public** id (`plan.publicId`) — the identifier the routes take —
+     * not the internal uuid. An unknown or foreign plan id matches nothing and
+     * yields an empty page rather than an error, so it cannot be used to probe
+     * which plans exist.
+     */
+    planId?: string;
+    status?: MandateStatus;
+    /** 1–100. The server defaults to 25 when omitted. */
+    limit?: number;
+    /** Id of the **last** mandate of the previous page — see `list`. */
+    startingAfter?: string;
+};
+export type MandateListPage = {
+    /** Newest first (`createdAt` descending), at most `limit` entries. */
+    mandates: Mandate[];
+    /** True when another page exists behind this one. */
+    hasMore: boolean;
+};
+export interface MandatesResource {
+    /**
+     * Proposes a mandate. The returned mandate is inert (`pending_permit`) until
+     * the payer signs `permitTypedData` and that signature is submitted from the
+     * payer's frontend — see the note at the top of this module on `activate`.
+     */
+    create(input: MandateCreateInput): Promise<MandateCreateResult>;
+    /** Explicit two-signature contract protocol. New capabilities remain gated by the deployment. */
+    createContractSubscription(input: ContractSubscriptionCreateInput): Promise<ContractSubscriptionCreateResult>;
+    /** Bounded per-use consent; every later charge needs a separate payer signature. */
+    createContractPerUse(input: ContractPerUseCreateInput): Promise<ContractPerUseCreateResult>;
+    proposeContractUsage(input: ContractUsageInput): Promise<ContractUsageCharge>;
+    submitContractUsage(proposal: ContractUsageCharge, signature: Hex): Promise<ContractUsageCharge>;
+    getContractUsage(proposal: ContractUsageCharge): Promise<ContractUsageCharge>;
+    /**
+     * One page of this account's mandates, newest first.
+     *
+     * This is how you find a mandate id without having kept the `mandate.active`
+     * webhook: a customer who wants to cancel can be served by listing, matching
+     * on `payerWallet` (or `subscriptionPlanId`), and calling `revoke`.
+     *
+     * **Paging is keyset-based**, so pass the id of the *last* mandate you
+     * received as `startingAfter` and repeat while `hasMore` is true:
+     *
+     * ```ts
+     * const all: Mandate[] = [];
+     * let startingAfter: string | undefined;
+     * for (;;) {
+     *   const page = await genesispay.mandates.list({
+     *     planId: "plan_1",
+     *     status: "active",
+     *     limit: 100,
+     *     startingAfter,
+     *   });
+     *   all.push(...page.mandates);
+     *   if (!page.hasMore) break;
+     *   startingAfter = page.mandates[page.mandates.length - 1]!.id;
+     * }
+     * ```
+     *
+     * Do **not** pass the id of an arbitrary mandate: the cursor is a position in
+     * `(createdAt desc, id desc)`, not a filter. A `startingAfter` that names no
+     * mandate of this account is refused by the server (as a `GenesisPayConfigError`
+     * — it carries no field-level detail to raise as a validation error).
+     */
+    list(opts?: MandateListOptions): Promise<MandateListPage>;
+    /** Entitlement check: is it active, and how much approval is left? */
+    retrieve(id: string): Promise<Mandate>;
+    /** Pulls a single charge. Signature-free — this is the metered path. */
+    charge(id: string, input: MandateChargeInput): Promise<MandateCharge>;
+    /** Requests cancellation. Contract mandates require confirmed payer revocation before authority is extinguished. */
+    revoke(id: string): Promise<Mandate>;
+}
+export declare function createMandatesResource(request: GenesisPayRequest): MandatesResource;
+export declare function toMandate(raw: Record<string, unknown>): Mandate;
+//# sourceMappingURL=mandates.d.ts.map

package/dist/mandates.d.ts.map

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

package/dist/mandates.js

@@ -0,0 +1,234 @@
+// `genesispay.mandates.*` — payment mandates over `/api/v1/mandates`.
+//
+// A mandate is a bounded, revocable spending approval a payer signs once (an
+// EIP-2612 permit); the seller then pulls individual charges against it with no
+// further signature. Funds stay in the payer's wallet until each pull.
+//
+// Deliberately absent: `mandates.activate`. Activation submits the payer's
+// *signature* over the permit typed data — it is authorized by the payer's
+// wallet, not by a seller API key, and belongs in the payer-facing frontend
+// (`POST /api/v1/mandates/:id/activate`). `mandates.create` returns the
+// `permitTypedData` for exactly that purpose: hand it to the payer's wallet,
+// and post the resulting signature from there. Offering activate here would
+// suggest a seller can switch on a mandate by itself, which is the one thing
+// the design does not allow.
+import { GenesisPayConfigError, GenesisPayValidationError, } from "./errors.js";
+import { asRecord, optionalAmountString, optionalCount, optionalString, requiredString, toAmountString, toCount, oneOf, } from "./resource.js";
+import { proposeContractUsage, submitContractUsage, getContractUsage } from "./contract-usage.js";
+import { createContractPerUse, createContractSubscription } from "./contract-mandates.js";
+function requireMandateChargeIdempotencyKey(value) {
+    if (typeof value !== "string" ||
+        value.toLowerCase() === "undefined" ||
+        !/^[A-Za-z0-9][A-Za-z0-9._:-]{7,199}$/.test(value)) {
+        throw new GenesisPayValidationError("mandates.charge requires an idempotencyKey with 8–200 safe characters.", [{ path: "idempotencyKey", message: "invalid idempotency key" }]);
+    }
+    return value;
+}
+export function createMandatesResource(request) {
+    return {
+        createContractSubscription: (input) => createContractSubscription(request, input),
+        createContractPerUse: (input) => createContractPerUse(request, input),
+        proposeContractUsage: (input) => proposeContractUsage(request, input),
+        submitContractUsage: (proposal, signature) => submitContractUsage(request, proposal, signature),
+        getContractUsage: (proposal) => getContractUsage(request, proposal),
+        create: async (input) => {
+            const body = await request({
+                method: "POST",
+                path: "/api/v1/mandates",
+                operation: "POST /api/v1/mandates",
+                action: "create a mandate",
+                body: {
+                    payerWallet: input.payerWallet,
+                    kind: input.kind,
+                    allowance: input.allowance,
+                    capPerCharge: input.capPerCharge,
+                    ...(input.amountPerPeriod ? { amountPerPeriod: input.amountPerPeriod } : {}),
+                    ...(input.periodDays === undefined ? {} : { periodDays: input.periodDays }),
+                    ...(input.asset ? { asset: input.asset } : {}),
+                    ...(input.destinationWallet
+                        ? { destinationWallet: input.destinationWallet }
+                        : {}),
+                },
+            });
+            const record = asRecord(body);
+            const mandate = requireMandate(body, "POST /api/v1/mandates");
+            const permitTypedData = asRecord(record?.permitTypedData);
+            if (!permitTypedData ||
+                !asRecord(permitTypedData.message) ||
+                !asRecord(permitTypedData.domain)) {
+                // Without the typed data the payer cannot sign, so the mandate can never
+                // leave `pending_permit` — better to fail loudly than hand back a stub.
+                throw new GenesisPayConfigError(`GenesisPay POST /api/v1/mandates returned a mandate without permitTypedData: ${JSON.stringify(body)}`);
+            }
+            const spender = requiredString(record?.spender);
+            if (!spender) {
+                // Degrading to "" would hand back an address-shaped empty string for the
+                // account the allowance approves. Same reasoning as permitTypedData:
+                // a missing contract field is a broken response, not an old backend.
+                throw new GenesisPayConfigError(`GenesisPay POST /api/v1/mandates returned a mandate without a spender: ${JSON.stringify(body)}`);
+            }
+            return {
+                mandate,
+                // Verbatim: see the PermitTypedData docs — a signature is over these bytes.
+                permitTypedData: permitTypedData,
+                spender,
+            };
+        },
+        list: async (opts = {}) => {
+            const query = new URLSearchParams();
+            if (opts.planId !== undefined) {
+                // An explicitly empty filter is refused rather than dropped: silently
+                // omitting it would widen the page from "one plan's subscribers" to
+                // every mandate on the account — the opposite of what was asked for.
+                query.set("planId", requireFilterValue(opts.planId, "planId"));
+            }
+            if (opts.status !== undefined)
+                query.set("status", opts.status);
+            if (opts.limit !== undefined)
+                query.set("limit", String(opts.limit));
+            if (opts.startingAfter !== undefined) {
+                // Same reasoning, sharper failure mode: dropping an empty cursor
+                // restarts at page 1, which turns a paging loop into an endless one.
+                query.set("startingAfter", requireFilterValue(opts.startingAfter, "startingAfter"));
+            }
+            const search = query.toString();
+            const body = await request({
+                path: search ? `/api/v1/mandates?${search}` : "/api/v1/mandates",
+                // Label without the query string: the operation is what failed, the
+                // filter values are not error detail (and `planId` is caller data).
+                operation: "GET /api/v1/mandates",
+                action: "list mandates",
+            });
+            const record = asRecord(body);
+            const mandates = record?.mandates;
+            if (!Array.isArray(mandates)) {
+                // A list endpoint answering 200 without a list is a broken contract,
+                // not an old backend. Returning [] would hide it as "no mandates yet"
+                // — and "this customer has no subscription" is exactly the wrong thing
+                // to conclude from a malformed response.
+                throw new GenesisPayConfigError(`GenesisPay GET /api/v1/mandates returned no mandates array: ${JSON.stringify(body)}`);
+            }
+            return {
+                // Individual entries stay tolerant: one unusable row must not lose the
+                // rest of the page. A row without an id is dropped — it could not be
+                // revoked or retrieved anyway.
+                mandates: mandates
+                    .map(asRecord)
+                    .filter((raw) => raw !== null)
+                    .filter((raw) => typeof raw.id === "string" && raw.id.length > 0)
+                    .map(toMandate),
+                // Only an explicit `true` means "there is more". Anything else stops
+                // the loop above rather than spinning it against a backend that does
+                // not report the flag.
+                hasMore: record?.hasMore === true,
+            };
+        },
+        retrieve: async (id) => {
+            const mandateId = requireMandateId(id, "mandates.retrieve");
+            const body = await request({
+                path: `/api/v1/mandates/${encodeURIComponent(mandateId)}`,
+                operation: `GET /api/v1/mandates/${mandateId}`,
+                action: `retrieve mandate "${mandateId}"`,
+                notFoundMessage: notFoundMessage(mandateId),
+            });
+            return requireMandate(body, `GET /api/v1/mandates/${mandateId}`);
+        },
+        charge: async (id, input) => {
+            const mandateId = requireMandateId(id, "mandates.charge");
+            const idempotencyKey = requireMandateChargeIdempotencyKey(input?.idempotencyKey);
+            const body = await request({
+                method: "POST",
+                path: `/api/v1/mandates/${encodeURIComponent(mandateId)}/charge`,
+                operation: `POST /api/v1/mandates/${mandateId}/charge`,
+                action: `charge mandate "${mandateId}"`,
+                notFoundMessage: notFoundMessage(mandateId),
+                headers: { "Idempotency-Key": idempotencyKey },
+                body: {
+                    amount: input.amount,
+                    ...(input.resourceUrl ? { resourceUrl: input.resourceUrl } : {}),
+                    ...(input.description ? { description: input.description } : {}),
+                },
+            });
+            const raw = asRecord(asRecord(body)?.charge);
+            if (!raw || typeof raw.id !== "string" || !raw.id) {
+                throw new GenesisPayConfigError(`GenesisPay POST /api/v1/mandates/${mandateId}/charge returned no charge: ${JSON.stringify(body)}`);
+            }
+            return {
+                id: raw.id,
+                status: oneOf(raw.status, ["pending", "submitted", "settled", "failed"], "pending"),
+                amountMinor: toAmountString(raw.amountMinor),
+                txHash: optionalString(raw.txHash),
+            };
+        },
+        revoke: async (id) => {
+            const mandateId = requireMandateId(id, "mandates.revoke");
+            const body = await request({
+                method: "POST",
+                path: `/api/v1/mandates/${encodeURIComponent(mandateId)}/revoke`,
+                operation: `POST /api/v1/mandates/${mandateId}/revoke`,
+                action: `revoke mandate "${mandateId}"`,
+                notFoundMessage: notFoundMessage(mandateId),
+            });
+            return requireMandate(body, `POST /api/v1/mandates/${mandateId}/revoke`);
+        },
+    };
+}
+function notFoundMessage(id) {
+    return (`No GenesisPay mandate with id "${id}". Check the id and that it belongs to ` +
+        `the account this API key authenticates.`);
+}
+function requireFilterValue(value, field) {
+    const trimmed = typeof value === "string" ? value.trim() : "";
+    if (!trimmed) {
+        throw new GenesisPayConfigError(`mandates.list({ ${field} }) was given an empty value. Omit ${field} ` +
+            `entirely to list without it — an empty string would silently change ` +
+            `which mandates come back.`);
+    }
+    return trimmed;
+}
+function requireMandateId(id, method) {
+    const mandateId = id?.trim();
+    if (!mandateId) {
+        throw new GenesisPayConfigError(`${method}(id) requires the mandate id returned by mandates.create().`);
+    }
+    return mandateId;
+}
+function requireMandate(body, operation) {
+    const raw = asRecord(asRecord(body)?.mandate);
+    if (!raw || typeof raw.id !== "string" || !raw.id) {
+        throw new GenesisPayConfigError(`GenesisPay ${operation} returned no mandate: ${JSON.stringify(body)}`);
+    }
+    return toMandate(raw);
+}
+export function toMandate(raw) {
+    return {
+        ...(raw.protocol === "contract_mandate_v1" ? { protocol: "contract_mandate_v1",
+            activationStatus: oneOf(raw.activationStatus, ["proposed", "submitted", "confirmed"], "proposed"),
+            revocationStatus: oneOf(raw.revocationStatus, ["none", "requested", "confirmed"], "none"),
+            executor: requiredString(raw.executor), contractVersion: requiredString(raw.contractVersion) } : {}),
+        id: requiredString(raw.id),
+        kind: oneOf(raw.kind, ["per_use", "subscription"], "per_use"),
+        // An unknown status degrades to `pending_permit`, the inert state: guessing
+        // "active" for a status this SDK version has never heard of would invite a
+        // caller to serve something it should not.
+        status: oneOf(raw.status, ["pending_permit", "active", "past_due", "revoked", "expired", "cancelled"], "pending_permit"),
+        asset: oneOf(raw.asset, ["USDC", "EURC"], "USDC"),
+        chainId: toCount(raw.chainId),
+        payerWallet: requiredString(raw.payerWallet),
+        destinationWallet: requiredString(raw.destinationWallet),
+        subscriptionPlanId: optionalString(raw.subscriptionPlanId),
+        allowanceMinor: toAmountString(raw.allowanceMinor),
+        capPerChargeMinor: toAmountString(raw.capPerChargeMinor),
+        spentMinor: toAmountString(raw.spentMinor),
+        remainingMinor: toAmountString(raw.remainingMinor),
+        amountPerPeriodMinor: optionalAmountString(raw.amountPerPeriodMinor),
+        periodDays: optionalCount(raw.periodDays),
+        nextChargeAt: optionalString(raw.nextChargeAt),
+        permitDeadline: requiredString(raw.permitDeadline),
+        permitTxHash: optionalString(raw.permitTxHash),
+        createdAt: requiredString(raw.createdAt),
+        activatedAt: optionalString(raw.activatedAt),
+        revokedAt: optionalString(raw.revokedAt),
+    };
+}
+//# sourceMappingURL=mandates.js.map

package/dist/mandates.js.map

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

package/dist/networks.d.ts

@@ -0,0 +1,10 @@
+import type { EvmAddress } from "@genesis-tech/genesispay-protocol";
+/** Networks the payment gate supports out of the box. */
+export type PaymentGateNetwork = "base" | "base-sepolia";
+export type PaymentGateNetworkConfig = {
+    network: PaymentGateNetwork;
+    chainId: number;
+    usdcAddress: EvmAddress;
+};
+export declare function resolvePaymentGateNetwork(network: PaymentGateNetwork): PaymentGateNetworkConfig;
+//# sourceMappingURL=networks.d.ts.map