@genesis-tech/genesispay-seller 0.13.1 → 1.3.0

package/dist/networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.d.ts","sourceRoot":"","sources":["../src/networks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAGpE,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,cAAc,CAAC;AAEzD,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,UAAU,CAAC;CACzB,CAAC;AAmBF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,kBAAkB,GAC1B,wBAAwB,CAU1B"}

package/dist/networks.js

@@ -0,0 +1,23 @@
+import { GENESISPAY_ASSET_DEPLOYMENTS } from "@genesis-tech/genesispay-protocol";
+const BASE_MAINNET = {
+    network: "base",
+    chainId: GENESISPAY_ASSET_DEPLOYMENTS.live.USDC.chainId,
+    usdcAddress: GENESISPAY_ASSET_DEPLOYMENTS.live.USDC.tokenAddress,
+};
+const BASE_SEPOLIA = {
+    network: "base-sepolia",
+    chainId: GENESISPAY_ASSET_DEPLOYMENTS.test.USDC.chainId,
+    usdcAddress: GENESISPAY_ASSET_DEPLOYMENTS.test.USDC.tokenAddress,
+};
+const NETWORK_CONFIGS = {
+    base: BASE_MAINNET,
+    "base-sepolia": BASE_SEPOLIA,
+};
+export function resolvePaymentGateNetwork(network) {
+    const config = NETWORK_CONFIGS[network];
+    if (!config) {
+        throw new Error(`Unsupported network "${String(network)}". Supported networks: ${Object.keys(NETWORK_CONFIGS).join(", ")}.`);
+    }
+    return config;
+}
+//# sourceMappingURL=networks.js.map

package/dist/networks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.js","sourceRoot":"","sources":["../src/networks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAWjF,MAAM,YAAY,GAA6B;IAC7C,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;IACvD,WAAW,EAAE,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY;CACjE,CAAC;AAEF,MAAM,YAAY,GAA6B;IAC7C,OAAO,EAAE,cAAc;IACvB,OAAO,EAAE,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;IACvD,WAAW,EAAE,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY;CACjE,CAAC;AAEF,MAAM,eAAe,GAAyD;IAC5E,IAAI,EAAE,YAAY;IAClB,cAAc,EAAE,YAAY;CAC7B,CAAC;AAEF,MAAM,UAAU,yBAAyB,CACvC,OAA2B;IAE3B,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAExC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,wBAAwB,MAAM,CAAC,OAAO,CAAC,0BAA0B,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC5G,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/payment-gate.d.ts

@@ -0,0 +1,98 @@
+import type { EvmAddress, PaymentAccept, PaymentSignaturePayload, SettlementResponsePayload } from "@genesis-tech/genesispay-protocol";
+import type { PaymentGateNetwork } from "./networks.js";
+export type PaymentGateConfig = {
+    /** Human-readable decimal USDC amount, e.g. "0.10". */
+    amountUsdc: string;
+    /** Wallet that receives the USDC payment. */
+    payTo: string;
+    /** Shown to payers in the PAYMENT-REQUIRED payload. */
+    description?: string;
+    /** Defaults to "base-sepolia". */
+    network?: PaymentGateNetwork;
+    /**
+     * Canonical resource URL advertised in PAYMENT-REQUIRED. Defaults to the
+     * incoming request URL (origin + pathname, query stripped).
+     */
+    resource?: string;
+    /** MIME type of the paid resource. Defaults to "application/json". */
+    mimeType?: string;
+    /** Payment authorization validity window advertised to payers. */
+    maxTimeoutSeconds?: number;
+    /**
+     * EIP-712 domain (`name`/`version`) of the settlement asset contract,
+     * advertised as the x402 `extra` field so generic clients sign with the
+     * exact domain the contract's DOMAIN_SEPARATOR() uses (e.g. Base mainnet
+     * USDC is { name: "USD Coin", version: "2" }). Omitted by default —
+     * clients then fall back to the standard "USDC"/"2" domain.
+     */
+    eip712Domain?: {
+        name: string;
+        version: string;
+    };
+};
+/** Context handed to the settlement hook once a payment passed structural checks. */
+export type SettlementContext = {
+    request: Request;
+    /** The raw PAYMENT-SIGNATURE header value, ready to forward to a facilitator. */
+    paymentSignatureHeader: string;
+    /** The decoded, structurally validated payment payload. */
+    payment: PaymentSignaturePayload;
+    /** The payment requirement this request must satisfy. */
+    requirement: PaymentAccept;
+    /** Persisted authority prepared before the payer signed. */
+    planId?: string;
+};
+export type PreparedSettlement = {
+    settlementPlan: {
+        planId: string;
+        sellerAuthorization: {
+            from: EvmAddress;
+            to: EvmAddress;
+            value: string;
+            validAfter: string;
+            validBefore: string;
+            nonce: `0x${string}`;
+        };
+        feeAuthorization: null;
+    };
+};
+export type PreparedAuthorizationRequest = {
+    sellerNonce: `0x${string}`;
+    feeNonce: `0x${string}` | null;
+    validBefore: string;
+};
+export type SettlementVerification = {
+    ok: true;
+    settlement: SettlementResponsePayload;
+} | {
+    ok: false;
+    errorReason: string;
+    settlement?: SettlementResponsePayload;
+    /** Signed authority may already be accepted or broadcast; never issue a fresh 402. */
+    outcomeUnknown?: true;
+};
+export type VerifySettlement = (context: SettlementContext) => Promise<SettlementVerification>;
+export type PlanAwareVerifySettlement = VerifySettlement & {
+    prepare?: (input: {
+        payer: EvmAddress;
+        idempotencyKey: string | null;
+        requirement: PaymentAccept;
+        authority?: PreparedAuthorizationRequest;
+    }) => Promise<PreparedSettlement>;
+};
+export type WrapOptions = {
+    verifySettlement: VerifySettlement;
+};
+type WrappableHandler<Args extends unknown[]> = (request: Request, ...args: Args) => Response | Promise<Response>;
+export type PaymentGate = {
+    /**
+     * Wraps a Web-standard (Request) => Response handler. Works with Next.js
+     * route handlers, Hono (`(c) => gated(c.req.raw)`), and Bun.serve.
+     */
+    wrap<Args extends unknown[]>(handler: WrappableHandler<Args>, options: WrapOptions): (request: Request, ...args: Args) => Promise<Response>;
+    /** Builds the PAYMENT-REQUIRED requirement for a given resource URL. */
+    requirementFor(resource: string): PaymentAccept;
+};
+export declare function createPaymentGate(config: PaymentGateConfig): PaymentGate;
+export {};
+//# sourceMappingURL=payment-gate.d.ts.map

package/dist/payment-gate.d.ts.map

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

package/dist/payment-gate.js

@@ -0,0 +1,370 @@
+import { GENESISPAY_SETTLEMENT_PREPARE_HEADER, GENESISPAY_SETTLEMENT_PREPARE_PARAMS_HEADER, PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, PAYMENT_SIGNATURE_HEADER, buildPaymentRequiredPayload, decodePaymentSignatureHeader, decodeSettlementPrepareParamsHeader, encodePaymentRequiredHeader, encodeSettlementResponseHeader, validatePaymentSignatureAgainstRequirement, } from "@genesis-tech/genesispay-protocol";
+import { getAddress, isAddress } from "viem";
+import { resolvePaymentGateNetwork } from "./networks.js";
+import { parseUsdcAmountToMinorUnits } from "./usdc-amount.js";
+export function createPaymentGate(config) {
+    const network = resolvePaymentGateNetwork(config.network ?? "base-sepolia");
+    const amountUsdcMinor = parseUsdcAmountToMinorUnits(config.amountUsdc);
+    const payTo = normalizePayToAddress(config.payTo);
+    const description = config.description ?? "Payment required";
+    function buildPayload(resource) {
+        return buildPaymentRequiredPayload({
+            amount: config.amountUsdc.trim(),
+            amountUsdcMinor,
+            asset: "USDC",
+            assetAddress: network.usdcAddress,
+            chainId: network.chainId,
+            network: network.network,
+            destination: payTo,
+            description,
+            resource,
+            mimeType: config.mimeType,
+            maxTimeoutSeconds: config.maxTimeoutSeconds,
+            extra: config.eip712Domain,
+        });
+    }
+    function resolveResource(request) {
+        if (config.resource) {
+            return config.resource;
+        }
+        const url = new URL(request.url);
+        return `${url.origin}${url.pathname}`;
+    }
+    return {
+        requirementFor(resource) {
+            return buildPayload(resource).accepts[0];
+        },
+        wrap(handler, options) {
+            if (typeof options?.verifySettlement !== "function") {
+                throw new Error("gate.wrap requires a verifySettlement hook — use genesisPaySettlement({ facilitatorBaseUrl, apiKey }) or provide your own.");
+            }
+            return async (request, ...args) => {
+                const planAwareVerifier = options.verifySettlement;
+                const payload = buildPayload(resolveResource(request));
+                const paymentSignatureHeader = request.headers.get(PAYMENT_SIGNATURE_HEADER);
+                if (!paymentSignatureHeader?.trim() &&
+                    request.headers.get(GENESISPAY_SETTLEMENT_PREPARE_HEADER) === "1") {
+                    if (!planAwareVerifier.prepare) {
+                        return new Response(JSON.stringify({
+                            error: "This gate does not support settlement preparation.",
+                            code: "settlement_plan_required",
+                        }), { status: 426, headers: { "Content-Type": "application/json" } });
+                    }
+                    const paramsHeader = request.headers.get(GENESISPAY_SETTLEMENT_PREPARE_PARAMS_HEADER);
+                    const prepareParams = paramsHeader === null
+                        ? await readLegacyPrepareBody(request)
+                        : readPrepareParamsHeader(paramsHeader);
+                    if (!prepareParams.ok)
+                        return prepareParams.response;
+                    const { payer, idempotencyKey, authority } = prepareParams;
+                    try {
+                        const prepared = await planAwareVerifier.prepare({
+                            payer,
+                            idempotencyKey,
+                            requirement: payload.accepts[0],
+                            ...(authority ? { authority } : {}),
+                        });
+                        return Response.json(prepared, {
+                            status: 201,
+                            headers: { "Cache-Control": "no-store" },
+                        });
+                    }
+                    catch (error) {
+                        return new Response(JSON.stringify({ error: describeError(error), code: "settlement_prepare_failed" }), { status: 502, headers: { "Content-Type": "application/json" } });
+                    }
+                }
+                if (!paymentSignatureHeader?.trim()) {
+                    return paymentRequiredResponse(payload, undefined, undefined, planAwareVerifier.prepare ? request.url : undefined);
+                }
+                let payment;
+                try {
+                    payment = decodePaymentSignatureHeader(paymentSignatureHeader);
+                }
+                catch (error) {
+                    return paymentRequiredResponse(payload, describeError(error));
+                }
+                const planId = request.headers.get("GENESISPAY-Settlement-Plan");
+                if (planAwareVerifier.prepare &&
+                    !planId &&
+                    !hasHistoricalSettlementTransaction(payment)) {
+                    return new Response(JSON.stringify({
+                        error: "Prepare a versioned settlement plan before signing.",
+                        code: "settlement_plan_required",
+                    }), { status: 426, headers: { "Content-Type": "application/json" } });
+                }
+                let requirement = payload.accepts[0];
+                const mismatch = validatePaymentSignatureAgainstRequirement(payment, requirement);
+                if (mismatch) {
+                    const transactionHash = getHistoricalSettlementTransaction(payment);
+                    const preparedReconciliationRequirement = transactionHash && planId && planAwareVerifier.prepare
+                        ? paymentRequirementForPreparedReconciliation(payment, requirement)
+                        : null;
+                    if (preparedReconciliationRequirement) {
+                        // Only a plan-aware verifier may receive this payer-carried
+                        // snapshot: its prepare capability is the SDK contract that says
+                        // the downstream facilitator will revalidate it against immutable
+                        // server-side authority. A custom verifier without that capability
+                        // must never be handed payer-selected amount/destination fields.
+                        requirement = preparedReconciliationRequirement;
+                    }
+                    else if (transactionHash) {
+                        return settlementOutcomeUnknownResponse({
+                            ok: false,
+                            outcomeUnknown: true,
+                            errorReason: `${mismatch} The payer transaction may already be on-chain; do not initiate another payment.`,
+                            settlement: {
+                                success: false,
+                                transaction: transactionHash,
+                                network: requirement.network,
+                                amount: requirement.maxAmountRequired,
+                                errorReason: mismatch,
+                                extensions: {
+                                    authorizationVerified: false,
+                                    settlementVerified: false,
+                                },
+                            },
+                        });
+                    }
+                    else {
+                        return paymentRequiredResponse(payload, mismatch);
+                    }
+                }
+                let verification;
+                try {
+                    verification = await options.verifySettlement({
+                        request,
+                        paymentSignatureHeader,
+                        payment,
+                        requirement,
+                        ...(planId ? { planId } : {}),
+                    });
+                }
+                catch (error) {
+                    const transactionHash = getHistoricalSettlementTransaction(payment);
+                    if (!transactionHash)
+                        throw error;
+                    const errorReason = "The settlement verifier failed after the payer transaction was supplied. Do not initiate another payment; retry reconciliation.";
+                    return settlementOutcomeUnknownResponse({
+                        ok: false,
+                        outcomeUnknown: true,
+                        errorReason,
+                        settlement: payerBroadcastOutcomeUnknownSettlement({
+                            transactionHash,
+                            requirement,
+                            errorReason,
+                        }),
+                    });
+                }
+                if (!verification.ok) {
+                    const transactionHash = getHistoricalSettlementTransaction(payment);
+                    if (verification.outcomeUnknown || transactionHash) {
+                        return settlementOutcomeUnknownResponse(transactionHash
+                            ? {
+                                ...verification,
+                                outcomeUnknown: true,
+                                settlement: payerBroadcastOutcomeUnknownSettlement({
+                                    transactionHash,
+                                    requirement,
+                                    errorReason: verification.errorReason,
+                                    settlement: verification.settlement,
+                                }),
+                            }
+                            : verification);
+                    }
+                    return paymentRequiredResponse(payload, verification.errorReason, verification.settlement);
+                }
+                const response = await handler(request, ...args);
+                return withSettlementHeader(response, verification.settlement);
+            };
+        },
+    };
+}
+function settlementOutcomeUnknownResponse(verification) {
+    const headers = new Headers({
+        "Content-Type": "application/json",
+        "Cache-Control": "no-store",
+        "Retry-After": "1",
+    });
+    if (verification.settlement) {
+        headers.set(PAYMENT_RESPONSE_HEADER, encodeSettlementResponseHeader(verification.settlement));
+    }
+    return new Response(JSON.stringify({
+        code: "settlement_outcome_unknown",
+        error: verification.errorReason,
+    }), { status: 503, headers });
+}
+function invalidPrepareRequest(error) {
+    return {
+        ok: false,
+        response: new Response(JSON.stringify({ error, code: "invalid_request" }), {
+            status: 422,
+            headers: { "Content-Type": "application/json" },
+        }),
+    };
+}
+/**
+ * Legacy preparation: the request BODY is the plan parameters. Kept unchanged
+ * for clients that predate `GENESISPAY-Settlement-Prepare-Params`.
+ */
+async function readLegacyPrepareBody(request) {
+    let body;
+    try {
+        body = await request.json();
+    }
+    catch {
+        body = null;
+    }
+    const payer = readPreparePayer(body);
+    if (!payer)
+        return invalidPrepareRequest("A valid payer is required.");
+    const idempotencyKey = typeof body === "object" &&
+        body !== null &&
+        "idempotencyKey" in body &&
+        typeof body.idempotencyKey === "string"
+        ? body.idempotencyKey
+        : null;
+    const authority = readPrepareAuthority(body);
+    if (typeof body === "object" && body !== null && "authority" in body && !authority) {
+        return invalidPrepareRequest("Prepared authority is invalid.");
+    }
+    return { ok: true, payer, idempotencyKey, authority };
+}
+/**
+ * Header preparation (ADR-0083): the plan parameters travel in
+ * `GENESISPAY-Settlement-Prepare-Params`, and the body is the purchase body.
+ * This gate prices by configuration and binds no request fingerprint, so the
+ * body stays opaque here and is never read; the resource URL alone scopes the
+ * requirement. A present but malformed header is refused, never read as a body.
+ */
+function readPrepareParamsHeader(paramsHeader) {
+    const params = decodeSettlementPrepareParamsHeader(paramsHeader);
+    if (!params)
+        return invalidPrepareRequest("Invalid settlement preparation parameters.");
+    return {
+        ok: true,
+        payer: params.payer,
+        idempotencyKey: params.idempotencyKey,
+        authority: params.authority ?? null,
+    };
+}
+function readPrepareAuthority(body) {
+    if (typeof body !== "object" || body === null || !("authority" in body)) {
+        return null;
+    }
+    const authority = body.authority;
+    if (typeof authority !== "object" ||
+        authority === null ||
+        !("sellerNonce" in authority) ||
+        typeof authority.sellerNonce !== "string" ||
+        !/^0x[0-9a-fA-F]{64}$/.test(authority.sellerNonce) ||
+        !("feeNonce" in authority) ||
+        (authority.feeNonce !== null &&
+            (typeof authority.feeNonce !== "string" ||
+                !/^0x[0-9a-fA-F]{64}$/.test(authority.feeNonce))) ||
+        !("validBefore" in authority) ||
+        typeof authority.validBefore !== "string" ||
+        !/^\d+$/.test(authority.validBefore)) {
+        return null;
+    }
+    return authority;
+}
+function hasHistoricalSettlementTransaction(payment) {
+    return getHistoricalSettlementTransaction(payment) !== null;
+}
+function getHistoricalSettlementTransaction(payment) {
+    const extensions = payment.extensions;
+    if (!extensions) {
+        return null;
+    }
+    for (const key of ["txHash", "transaction", "transactionHash"]) {
+        const value = extensions[key];
+        if (typeof value === "string" && /^0x[0-9a-fA-F]{64}$/.test(value)) {
+            return value;
+        }
+    }
+    return null;
+}
+function payerBroadcastOutcomeUnknownSettlement(input) {
+    return {
+        ...input.settlement,
+        success: false,
+        transaction: input.transactionHash,
+        network: input.settlement?.network ?? input.requirement.network,
+        amount: input.settlement?.amount ?? input.requirement.maxAmountRequired,
+        errorReason: input.settlement?.errorReason ?? input.errorReason,
+        extensions: {
+            ...input.settlement?.extensions,
+            settlementVerified: false,
+        },
+    };
+}
+function paymentRequirementForPreparedReconciliation(payment, fallback) {
+    const accepted = payment.accepted;
+    const destination = accepted.payTo ?? accepted.destination;
+    const resource = payment.resource?.url;
+    if (!accepted.chainId ||
+        !accepted.assetAddress ||
+        !destination ||
+        !resource) {
+        return null;
+    }
+    return {
+        ...fallback,
+        network: accepted.network,
+        chainId: accepted.chainId,
+        assetAddress: accepted.assetAddress,
+        asset: accepted.asset ?? fallback.asset,
+        amount: accepted.amount,
+        maxAmountRequired: accepted.amount,
+        destination,
+        payTo: destination,
+        resource,
+    };
+}
+function paymentRequiredResponse(payload, errorReason, settlement, prepareUrl) {
+    const body = errorReason
+        ? { ...payload, error: errorReason }
+        : payload;
+    const headers = new Headers({
+        "Content-Type": "application/json",
+        "Cache-Control": "no-store",
+        [PAYMENT_REQUIRED_HEADER]: encodePaymentRequiredHeader(body),
+    });
+    if (settlement) {
+        headers.set(PAYMENT_RESPONSE_HEADER, encodeSettlementResponseHeader(settlement));
+    }
+    if (prepareUrl) {
+        headers.set("GENESISPAY-Settlement-Prepare", prepareUrl);
+        headers.set("GENESISPAY-Settlement-Version", "1");
+    }
+    return new Response(JSON.stringify(body), { status: 402, headers });
+}
+function readPreparePayer(value) {
+    if (typeof value !== "object" ||
+        value === null ||
+        !("payer" in value) ||
+        typeof value.payer !== "string" ||
+        !isAddress(value.payer)) {
+        return null;
+    }
+    return getAddress(value.payer);
+}
+function withSettlementHeader(response, settlement) {
+    const headers = new Headers(response.headers);
+    headers.set(PAYMENT_RESPONSE_HEADER, encodeSettlementResponseHeader(settlement));
+    return new Response(response.body, {
+        status: response.status,
+        statusText: response.statusText,
+        headers,
+    });
+}
+function normalizePayToAddress(payTo) {
+    if (typeof payTo !== "string" || !isAddress(payTo.trim())) {
+        throw new Error(`Invalid payTo address "${String(payTo)}": expected an EVM address like 0x1234....`);
+    }
+    return getAddress(payTo.trim());
+}
+function describeError(error) {
+    return error instanceof Error ? error.message : "Malformed PAYMENT-SIGNATURE header.";
+}
+//# sourceMappingURL=payment-gate.js.map

package/dist/payment-gate.js.map

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

package/dist/plans.d.ts

@@ -0,0 +1,68 @@
+import { type GenesisPayRequest } from "./resource.js";
+export type SubscriptionPlanStatus = "active" | "archived";
+export type SubscriptionPlan = {
+    /** Internal id. Address a plan by `publicId` — that is what the routes take. */
+    id: string;
+    publicId: string;
+    title: string;
+    description: string | null;
+    asset: "USDC" | "EURC";
+    /** Decimal amount charged per period, e.g. "9.00". */
+    amountPerPeriod: string;
+    /** Same amount in 6-decimal minor units, as a string (no precision loss). */
+    amountPerPeriodMinor: string;
+    periodDays: number;
+    /**
+     * How many periods of allowance the customer approves up front. The mandate's
+     * total allowance is `amountPerPeriodMinor * prepaidCycles`; when it runs out
+     * the customer signs again.
+     */
+    prepaidCycles: number;
+    capPerChargeMinor: string;
+    allowanceMinor: string;
+    destinationWallet: string;
+    chainId: number;
+    status: SubscriptionPlanStatus;
+    /**
+     * The hosted subscribe flow (`/subscribe/:publicId`) — send the customer
+     * here. This is the whole reason to call the API rather than build the URL
+     * yourself: the host depends on the deployment the key points at.
+     */
+    checkoutUrl: string;
+    createdAt: string;
+    archivedAt: string | null;
+};
+export type PlanCreateInput = {
+    title: string;
+    /** Decimal amount per period, e.g. "9" or "9.00". */
+    amountPerPeriod: string;
+    /** Billing period in whole days, e.g. 30. */
+    periodDays: number;
+    description?: string;
+    /** Periods of allowance collected in one signature. Server default applies. */
+    prepaidCycles?: number;
+    /** Defaults to the account's receiving wallet. */
+    destinationWallet?: string;
+    /** Defaults to USDC. */
+    asset?: "USDC" | "EURC";
+};
+export interface PlansResource {
+    create(input: PlanCreateInput): Promise<SubscriptionPlan>;
+    list(): Promise<SubscriptionPlan[]>;
+    retrieve(publicId: string): Promise<SubscriptionPlan>;
+    /**
+     * Stops the hosted page from taking new subscribers. Mandates already signed
+     * from this plan keep billing until the payer revokes them — archiving is not
+     * a cancellation. Archiving twice is a no-op that returns the same plan.
+     */
+    archive(publicId: string): Promise<SubscriptionPlan>;
+}
+export declare function createPlansResource(request: GenesisPayRequest, 
+/**
+ * Applies the client's `expectedPayTo` pin to the wallet the server froze
+ * onto the plan. A plan's destination is where every future renewal settles,
+ * so it is exactly the value the pin exists to guard.
+ */
+assertPinnedDestination?: (wallet: unknown, what: string) => void): PlansResource;
+export declare function toSubscriptionPlan(raw: Record<string, unknown>): SubscriptionPlan;
+//# sourceMappingURL=plans.d.ts.map

package/dist/plans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"AASA,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gFAAgF;IAChF,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,sBAAsB,CAAC;IAC/B;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC1D,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACtD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACtD;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB;AAC1B;;;;GAIG;AACH,uBAAuB,GAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,IAAe,GAC1E,aAAa,CAwEf;AA6BD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAwBjF"}