@genesis-tech/genesispay-seller 0.13.1 → 0.13.2

package/dist/invoices.d.ts

@@ -0,0 +1,80 @@
+import { type Customer } from "./customers.js";
+import { type GenesisPayRequest } from "./resource.js";
+export type InvoiceStatus = "draft" | "open" | "past_due" | "paid" | "void" | "uncollectible";
+export type InvoiceLineInput = {
+    description: string;
+    quantity: number;
+    /** Decimal amount in the invoice asset, as a string with up to 6 decimals. */
+    unitAmount: string;
+};
+export type InvoiceDraftInput = {
+    customerId: string;
+    asset?: "USDC" | "EURC";
+    /** ISO-8601 timestamp with an offset. */
+    dueAt: string;
+    discountBps?: number;
+    taxBps?: number;
+    memo?: string;
+    footer?: string;
+    lineItems: InvoiceLineInput[];
+};
+export type Invoice = {
+    id: string;
+    publicId: string;
+    invoiceNumber: string | null;
+    status: InvoiceStatus;
+    asset: "USDC" | "EURC";
+    chainId: number;
+    customer: Customer;
+    lineItems: Array<{
+        id: string;
+        position: number;
+        description: string;
+        quantity: number;
+        unitAmountMinor: string;
+        amountMinor: string;
+    }>;
+    subtotalMinor: string;
+    discountBps: number;
+    discountMinor: string;
+    taxBps: number;
+    taxMinor: string;
+    totalMinor: string;
+    memo: string | null;
+    footer: string | null;
+    dueAt: string;
+    createdAt: string;
+    updatedAt: string;
+    finalizedAt: string | null;
+    paidAt: string | null;
+    voidedAt: string | null;
+    uncollectibleAt: string | null;
+    hostedInvoiceUrl: string | null;
+    pdfUrl: string | null;
+    payment: {
+        payUrl: string | null;
+        txHash: string | null;
+        payerWallet: string | null;
+    };
+};
+export type InvoiceEmailDelivery = {
+    id: string;
+    status: "sent";
+    providerMessageId: string | null;
+    sentAt: string | null;
+};
+export interface InvoicesResource {
+    create(input: InvoiceDraftInput): Promise<Invoice>;
+    list(): Promise<Invoice[]>;
+    retrieve(publicId: string): Promise<Invoice>;
+    update(publicId: string, input: InvoiceDraftInput): Promise<Invoice>;
+    finalize(publicId: string): Promise<Invoice>;
+    send(publicId: string, options: {
+        idempotencyKey: string;
+    }): Promise<InvoiceEmailDelivery>;
+    void(publicId: string): Promise<Invoice>;
+    markUncollectible(publicId: string): Promise<Invoice>;
+}
+export declare function createInvoicesResource(request: GenesisPayRequest): InvoicesResource;
+export declare function toInvoice(raw: Record<string, unknown>): Invoice;
+//# sourceMappingURL=invoices.d.ts.map

package/dist/invoices.d.ts.map

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

package/dist/invoices.js

@@ -0,0 +1,133 @@
+// `genesispay.invoices.*` — one-off invoice lifecycle over `/api/v1/invoices`.
+import { GenesisPayConfigError } from "./errors.js";
+import { toCustomer } from "./customers.js";
+import { asRecord, oneOf, optionalString, requiredString, toAmountString, toCount, } from "./resource.js";
+export function createInvoicesResource(request) {
+    return {
+        create: async (input) => invoiceRequest(request, "POST", "/api/v1/invoices", input, "create an invoice"),
+        list: async () => {
+            const body = await request({
+                path: "/api/v1/invoices",
+                operation: "GET /api/v1/invoices",
+                action: "list invoices",
+            });
+            const rows = asRecord(body)?.invoices;
+            if (!Array.isArray(rows)) {
+                throw new GenesisPayConfigError(`GenesisPay GET /api/v1/invoices returned no invoices array: ${JSON.stringify(body)}`);
+            }
+            return rows
+                .map(asRecord)
+                .filter((row) => Boolean(row?.publicId))
+                .map(toInvoice);
+        },
+        retrieve: async (publicId) => {
+            const id = requirePublicId(publicId, "invoices.retrieve");
+            return invoiceRequest(request, "GET", `/api/v1/invoices/${encodeURIComponent(id)}`, undefined, `retrieve invoice "${id}"`);
+        },
+        update: async (publicId, input) => {
+            const id = requirePublicId(publicId, "invoices.update");
+            return invoiceRequest(request, "PATCH", `/api/v1/invoices/${encodeURIComponent(id)}`, input, `update invoice "${id}"`);
+        },
+        finalize: async (publicId) => transition(request, publicId, "finalize", "finalize an invoice"),
+        void: async (publicId) => transition(request, publicId, "void", "void an invoice"),
+        markUncollectible: async (publicId) => transition(request, publicId, "mark-uncollectible", "mark an invoice uncollectible"),
+        send: async (publicId, options) => {
+            const id = requirePublicId(publicId, "invoices.send");
+            const idempotencyKey = options?.idempotencyKey?.trim();
+            if (!idempotencyKey) {
+                throw new GenesisPayConfigError("invoices.send requires a non-empty idempotencyKey.");
+            }
+            const path = `/api/v1/invoices/${encodeURIComponent(id)}/send`;
+            const response = await request({
+                method: "POST",
+                path,
+                operation: `POST ${path}`,
+                action: `send invoice "${id}"`,
+                headers: { "idempotency-key": idempotencyKey },
+            });
+            const delivery = asRecord(asRecord(response)?.delivery);
+            if (!delivery?.id) {
+                throw new GenesisPayConfigError(`GenesisPay POST ${path} returned no delivery: ${JSON.stringify(response)}`);
+            }
+            return {
+                id: requiredString(delivery.id),
+                status: "sent",
+                providerMessageId: optionalString(delivery.providerMessageId),
+                sentAt: optionalString(delivery.sentAt),
+            };
+        },
+    };
+}
+async function transition(request, publicId, transitionName, action) {
+    const id = requirePublicId(publicId, `invoices.${transitionName}`);
+    return invoiceRequest(request, "POST", `/api/v1/invoices/${encodeURIComponent(id)}/${transitionName}`, undefined, action);
+}
+async function invoiceRequest(request, method, path, body, action) {
+    const response = await request({
+        method,
+        path,
+        operation: `${method} ${path}`,
+        action,
+        ...(body === undefined ? {} : { body }),
+    });
+    const raw = asRecord(asRecord(response)?.invoice);
+    if (!raw?.publicId) {
+        throw new GenesisPayConfigError(`GenesisPay ${method} ${path} returned no invoice: ${JSON.stringify(response)}`);
+    }
+    return toInvoice(raw);
+}
+function requirePublicId(publicId, method) {
+    const id = publicId?.trim();
+    if (!id) {
+        throw new GenesisPayConfigError(`${method}(publicId) requires the publicId returned by invoices.create().`);
+    }
+    return id;
+}
+export function toInvoice(raw) {
+    const customer = asRecord(raw.customer) ?? {};
+    const payment = asRecord(raw.payment) ?? {};
+    const lines = Array.isArray(raw.lineItems) ? raw.lineItems : [];
+    return {
+        id: requiredString(raw.id),
+        publicId: requiredString(raw.publicId),
+        invoiceNumber: optionalString(raw.invoiceNumber),
+        status: oneOf(raw.status, ["draft", "open", "past_due", "paid", "void", "uncollectible"], "draft"),
+        asset: oneOf(raw.asset, ["USDC", "EURC"], "USDC"),
+        chainId: toCount(raw.chainId),
+        customer: toCustomer(customer),
+        lineItems: lines
+            .map(asRecord)
+            .filter((line) => Boolean(line?.id))
+            .map((line) => ({
+            id: requiredString(line.id),
+            position: toCount(line.position),
+            description: requiredString(line.description),
+            quantity: toCount(line.quantity),
+            unitAmountMinor: toAmountString(line.unitAmountMinor),
+            amountMinor: toAmountString(line.amountMinor),
+        })),
+        subtotalMinor: toAmountString(raw.subtotalMinor),
+        discountBps: toCount(raw.discountBps),
+        discountMinor: toAmountString(raw.discountMinor),
+        taxBps: toCount(raw.taxBps),
+        taxMinor: toAmountString(raw.taxMinor),
+        totalMinor: toAmountString(raw.totalMinor),
+        memo: optionalString(raw.memo),
+        footer: optionalString(raw.footer),
+        dueAt: requiredString(raw.dueAt),
+        createdAt: requiredString(raw.createdAt),
+        updatedAt: requiredString(raw.updatedAt),
+        finalizedAt: optionalString(raw.finalizedAt),
+        paidAt: optionalString(raw.paidAt),
+        voidedAt: optionalString(raw.voidedAt),
+        uncollectibleAt: optionalString(raw.uncollectibleAt),
+        hostedInvoiceUrl: optionalString(raw.hostedInvoiceUrl),
+        pdfUrl: optionalString(raw.pdfUrl),
+        payment: {
+            payUrl: optionalString(payment.payUrl),
+            txHash: optionalString(payment.txHash),
+            payerWallet: optionalString(payment.payerWallet),
+        },
+    };
+}
+//# sourceMappingURL=invoices.js.map

package/dist/invoices.js.map

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

package/dist/mandate-gate.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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.
+ */
+export declare const MANDATE_HEADER = "GENESISPAY-MANDATE";
+export type MandateGateOptions = {
+    /** Decimal charge per request, e.g. "0.08". */
+    amount: string;
+    /** Base URL of the GenesisPay app (your GENESISPAY_BASE_URL). */
+    baseUrl: string;
+    /** GenesisPay seller API key ("gp_sk_..."). */
+    apiKey: string;
+    /** Description attached to each charge (shows up in activity/usage). */
+    description?: string;
+    /** Override for testing; defaults to global fetch. */
+    fetchFn?: typeof fetch;
+};
+export type MandateChargeOutcome = {
+    ok: true;
+    charge: {
+        id: string;
+        amountMinor: string;
+        txHash: string;
+    };
+} | {
+    ok: false;
+    status: number;
+    code?: string;
+    error: string;
+};
+export type MandateGate = {
+    /** Charges the mandate once. Exposed for custom flows. */
+    charge: (mandateId: string, resourceUrl?: string) => Promise<MandateChargeOutcome>;
+    /**
+     * Wraps a fetch-style handler: requests carrying a valid `GENESISPAY-MANDATE`
+     * header are charged and passed through; requests without one get a 402
+     * JSON body explaining how to attach a mandate.
+     */
+    wrap: (handler: (request: Request) => Response | Promise<Response>) => (request: Request) => Promise<Response>;
+};
+export declare function createMandateGate(options: MandateGateOptions): MandateGate;
+//# sourceMappingURL=mandate-gate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mandate-gate.d.ts","sourceRoot":"","sources":["../src/mandate-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,cAAc,uBAAuB,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAC5B;IACE,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,MAAM,MAAM,WAAW,GAAG;IACxB,0DAA0D;IAC1D,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnF;;;;OAIG;IACH,IAAI,EAAE,CACJ,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,KACxD,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC9C,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAsH1E"}

package/dist/mandate-gate.js

@@ -0,0 +1,109 @@
+/**
+ * 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.
+ */
+export const MANDATE_HEADER = "GENESISPAY-MANDATE";
+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 fetchFn = options.fetchFn ?? fetch;
+    async function charge(mandateId, resourceUrl) {
+        let response;
+        try {
+            response = await fetchFn(`${baseUrl}/api/v1/mandates/${encodeURIComponent(mandateId)}/charge`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${apiKey}`,
+                },
+                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) {
+            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}).`,
+            };
+        }
+        const chargeRecord = (record.charge ?? {});
+        return {
+            ok: true,
+            charge: {
+                id: String(chargeRecord.id ?? ""),
+                amountMinor: String(chargeRecord.amountMinor ?? ""),
+                txHash: String(chargeRecord.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 outcome = await charge(mandateId, request.url);
+            if (!outcome.ok) {
+                return jsonResponse({ error: outcome.error, code: outcome.code }, outcome.status === 403 || outcome.status === 404 ? outcome.status : 402);
+            }
+            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,172 @@
+import { type GenesisPayRequest } from "./resource.js";
+export type MandateKind = "per_use" | "subscription";
+export type MandateStatus = "pending_permit" | "active" | "past_due" | "revoked" | "expired";
+export type MandateChargeStatus = "pending" | "settled" | "failed";
+export type Mandate = {
+    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 when the payer's signature was submitted — until then the mandate is inert. */
+    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;
+    /** 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>;
+    /**
+     * 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>;
+    /** Stops all future charges. Already-settled charges are unaffected. */
+    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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"}