@genesis-tech/genesispay-seller 0.8.0

package/dist/customers.js

@@ -0,0 +1,76 @@
+// `peerpay.customers.*` — reusable billing contacts over `/api/v1/customers`.
+import { PeerPayConfigError } from "./errors.js";
+import { asRecord, optionalMetadata, optionalString, requiredString, } from "./resource.js";
+export function createCustomersResource(request) {
+    return {
+        create: async (input) => customerRequest(request, "POST", "/api/v1/customers", input, "create a customer"),
+        list: async () => {
+            const body = await request({
+                path: "/api/v1/customers",
+                operation: "GET /api/v1/customers",
+                action: "list customers",
+            });
+            const rows = asRecord(body)?.customers;
+            if (!Array.isArray(rows)) {
+                throw new PeerPayConfigError(`GenesisPay GET /api/v1/customers returned no customers array: ${JSON.stringify(body)}`);
+            }
+            return rows
+                .map(asRecord)
+                .filter((row) => Boolean(row?.publicId))
+                .map(toCustomer);
+        },
+        retrieve: async (publicId) => {
+            const id = requirePublicId(publicId, "customers.retrieve");
+            return customerRequest(request, "GET", `/api/v1/customers/${encodeURIComponent(id)}`, undefined, `retrieve customer "${id}"`);
+        },
+        update: async (publicId, input) => {
+            const id = requirePublicId(publicId, "customers.update");
+            return customerRequest(request, "PATCH", `/api/v1/customers/${encodeURIComponent(id)}`, input, `update customer "${id}"`);
+        },
+        archive: async (publicId) => {
+            const id = requirePublicId(publicId, "customers.archive");
+            return customerRequest(request, "POST", `/api/v1/customers/${encodeURIComponent(id)}/archive`, undefined, `archive customer "${id}"`);
+        },
+    };
+}
+async function customerRequest(request, method, path, body, action) {
+    const response = await request({
+        method,
+        path,
+        operation: `${method} ${path}`,
+        action,
+        ...(body === undefined ? {} : { body }),
+    });
+    const raw = asRecord(asRecord(response)?.customer);
+    if (!raw?.publicId) {
+        throw new PeerPayConfigError(`GenesisPay ${method} ${path} returned no customer: ${JSON.stringify(response)}`);
+    }
+    return toCustomer(raw);
+}
+function requirePublicId(publicId, method) {
+    const id = publicId?.trim();
+    if (!id) {
+        throw new PeerPayConfigError(`${method}(publicId) requires the publicId returned by customers.create().`);
+    }
+    return id;
+}
+export function toCustomer(raw) {
+    return {
+        id: requiredString(raw.id),
+        publicId: requiredString(raw.publicId),
+        name: requiredString(raw.name),
+        email: requiredString(raw.email),
+        companyName: optionalString(raw.companyName),
+        addressLine1: optionalString(raw.addressLine1),
+        addressLine2: optionalString(raw.addressLine2),
+        city: optionalString(raw.city),
+        postalCode: optionalString(raw.postalCode),
+        countryCode: optionalString(raw.countryCode),
+        taxId: optionalString(raw.taxId),
+        metadata: optionalMetadata(raw.metadata),
+        createdAt: requiredString(raw.createdAt),
+        updatedAt: requiredString(raw.updatedAt),
+        archivedAt: optionalString(raw.archivedAt),
+    };
+}
+//# sourceMappingURL=customers.js.map

package/dist/customers.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,63 @@
+/** Missing/invalid key, unresolvable prod URL, or unreachable backend. */
+export declare class PeerPayConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * The requested resource does not exist (HTTP 404). Kept separate from
+ * `PeerPayConfigError` on purpose: polling `checkout.retrieve()` for an unknown
+ * publicId is an ordinary application case and must stay distinguishable from
+ * "the key is broken / the backend is unreachable".
+ */
+export declare class PeerPayNotFoundError extends Error {
+    constructor(message: string);
+}
+/** Asset-integrity, mode↔network, or expectedPayTo-pin mismatch — a money-safety stop. */
+export declare class PeerPayNetworkSafetyError extends Error {
+    constructor(message: string);
+}
+/** One rejected field, as the API reports it. `path` is dot-joined ("metadata.orderId"). */
+export type PeerPayValidationIssue = {
+    path: string;
+    message: string;
+};
+/**
+ * The request was well-formed but the input was rejected — HTTP 422 for a body,
+ * or HTTP 400 with field `issues` for a query string.
+ *
+ * `issues` is the server's structured list — the whole point of the class: 21
+ * metadata keys and a malformed wallet must not look the same to a caller that
+ * wants to surface the offending field back to its own user.
+ */
+export declare class PeerPayValidationError extends Error {
+    readonly issues: PeerPayValidationIssue[];
+    constructor(message: string, issues?: PeerPayValidationIssue[]);
+}
+/**
+ * The API key exceeded its rate limit (HTTP 429).
+ *
+ * `retryAfterSeconds` mirrors the server's `Retry-After` header. It is `null`
+ * when the header is missing or unparseable — never a guessed default, because
+ * a caller sleeping on a made-up number is worse than one that backs off with
+ * its own policy.
+ */
+export declare class PeerPayRateLimitError extends Error {
+    readonly retryAfterSeconds: number | null;
+    constructor(message: string, retryAfterSeconds: number | null);
+}
+export type ThrowForErrorResponseOptions = {
+    /** Operation label used in messages, e.g. `POST /api/v1/links`. */
+    operation: string;
+    /** Replaces the generic 404 message with a case-specific hint. */
+    notFoundMessage?: string;
+    /** Appended to the message — a next step for the caller, not error detail. */
+    hint?: string;
+};
+/**
+ * Maps a non-OK response onto the right error class and throws it.
+ *
+ * Consumes the response body exactly once (as text, then optimistically as
+ * JSON) so a non-JSON error page still ends up in the message instead of
+ * blowing up the mapper.
+ */
+export declare function throwForErrorResponse(response: Response, options: ThrowForErrorResponseOptions): Promise<never>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AASA,0EAA0E;AAC1E,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,0FAA0F;AAC1F,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAED,4FAA4F;AAC5F,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;GAOG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC;gBAE9B,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,sBAAsB,EAAO;CAKnE;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;gBAE9B,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI;CAK9D;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAUF;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,KAAK,CAAC,CA4ChB"}

package/dist/errors.js

@@ -0,0 +1,162 @@
+// Typed errors for every GenesisPay HTTP call.
+//
+// One rule, one place: `throwForErrorResponse` is the single mapper from a
+// non-OK `Response` to an error class, so every method (checkout today, plans
+// and mandates tomorrow) fails the same way. A method that hand-rolls its own
+// `throw new PeerPayConfigError(...)` for a non-OK status is a bug — 422 and
+// 429 carry information (which field is wrong, how long to wait) that a generic
+// config error throws away.
+/** Missing/invalid key, unresolvable prod URL, or unreachable backend. */
+export class PeerPayConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PeerPayConfigError";
+    }
+}
+/**
+ * The requested resource does not exist (HTTP 404). Kept separate from
+ * `PeerPayConfigError` on purpose: polling `checkout.retrieve()` for an unknown
+ * publicId is an ordinary application case and must stay distinguishable from
+ * "the key is broken / the backend is unreachable".
+ */
+export class PeerPayNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PeerPayNotFoundError";
+    }
+}
+/** Asset-integrity, mode↔network, or expectedPayTo-pin mismatch — a money-safety stop. */
+export class PeerPayNetworkSafetyError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PeerPayNetworkSafetyError";
+    }
+}
+/**
+ * The request was well-formed but the input was rejected — HTTP 422 for a body,
+ * or HTTP 400 with field `issues` for a query string.
+ *
+ * `issues` is the server's structured list — the whole point of the class: 21
+ * metadata keys and a malformed wallet must not look the same to a caller that
+ * wants to surface the offending field back to its own user.
+ */
+export class PeerPayValidationError extends Error {
+    issues;
+    constructor(message, issues = []) {
+        super(message);
+        this.name = "PeerPayValidationError";
+        this.issues = issues;
+    }
+}
+/**
+ * The API key exceeded its rate limit (HTTP 429).
+ *
+ * `retryAfterSeconds` mirrors the server's `Retry-After` header. It is `null`
+ * when the header is missing or unparseable — never a guessed default, because
+ * a caller sleeping on a made-up number is worse than one that backs off with
+ * its own policy.
+ */
+export class PeerPayRateLimitError extends Error {
+    retryAfterSeconds;
+    constructor(message, retryAfterSeconds) {
+        super(message);
+        this.name = "PeerPayRateLimitError";
+        this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+/**
+ * Maps a non-OK response onto the right error class and throws it.
+ *
+ * Consumes the response body exactly once (as text, then optimistically as
+ * JSON) so a non-JSON error page still ends up in the message instead of
+ * blowing up the mapper.
+ */
+export async function throwForErrorResponse(response, options) {
+    const body = await readErrorBody(response);
+    const detail = body.message ?? body.text;
+    const suffix = detail ? `: ${detail}` : "";
+    const hint = options.hint ? ` ${options.hint}` : "";
+    if (response.status === 404) {
+        throw new PeerPayNotFoundError(options.notFoundMessage ??
+            `GenesisPay ${options.operation} returned 404 (not found)${suffix}${hint}`);
+    }
+    // 422 is a rejected *body*; 400 with `issues[]` is a rejected *query string*
+    // (`GET /api/v1/mandates` answers that way). Both mean "your input was wrong,
+    // here are the fields", so both become PeerPayValidationError — a caller that
+    // wants to show the offending parameter must not have to branch on status.
+    //
+    // The `issues.length` gate is what keeps this narrow: a 400 without structured
+    // detail ("Request body must be JSON.", "startingAfter is not a mandate of this
+    // account.") stays a PeerPayConfigError exactly as before, so nothing that was
+    // a config error yesterday changes class today.
+    if (response.status === 422 || (response.status === 400 && body.issues.length > 0)) {
+        throw new PeerPayValidationError(`GenesisPay ${options.operation} rejected the input (${response.status})${suffix}`, body.issues);
+    }
+    if (response.status === 429) {
+        const retryAfterSeconds = parseRetryAfterSeconds(response.headers?.get("retry-after") ?? null);
+        const wait = retryAfterSeconds === null ? "" : ` Retry after ${retryAfterSeconds}s.`;
+        throw new PeerPayRateLimitError(`GenesisPay ${options.operation} was rate limited (429)${suffix}${wait}`, retryAfterSeconds);
+    }
+    throw new PeerPayConfigError(`GenesisPay ${options.operation} failed: ${response.status}${suffix}${hint}`.trim());
+}
+async function readErrorBody(response) {
+    const text = (await response.text().catch(() => "")).trim();
+    if (!text)
+        return { text: "", message: null, issues: [] };
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return { text, message: null, issues: [] };
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return { text, message: null, issues: [] };
+    }
+    const record = parsed;
+    const message = typeof record.error === "string" && record.error
+        ? record.error
+        : typeof record.message === "string" && record.message
+            ? record.message
+            : null;
+    return { text, message, issues: toValidationIssues(record.issues) };
+}
+/** Tolerant: anything that is not a `{path, message}` object is dropped, never thrown on. */
+function toValidationIssues(value) {
+    if (!Array.isArray(value))
+        return [];
+    const issues = [];
+    for (const entry of value) {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry))
+            continue;
+        const issue = entry;
+        if (typeof issue.message !== "string")
+            continue;
+        issues.push({
+            path: typeof issue.path === "string" ? issue.path : "",
+            message: issue.message,
+        });
+    }
+    return issues;
+}
+/**
+ * `Retry-After` is either delta-seconds or an HTTP date (RFC 9110). GenesisPay
+ * sends seconds; the date form is parsed anyway so a proxy that rewrites the
+ * header does not degrade the value to `null`.
+ */
+function parseRetryAfterSeconds(header) {
+    if (!header)
+        return null;
+    const raw = header.trim();
+    if (!raw)
+        return null;
+    if (/^\d+$/.test(raw)) {
+        const seconds = Number(raw);
+        return Number.isSafeInteger(seconds) ? seconds : null;
+    }
+    const dateMs = Date.parse(raw);
+    if (Number.isNaN(dateMs))
+        return null;
+    return Math.max(0, Math.ceil((dateMs - Date.now()) / 1_000));
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,8EAA8E;AAC9E,6EAA6E;AAC7E,gFAAgF;AAChF,4BAA4B;AAE5B,0EAA0E;AAC1E,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,0FAA0F;AAC1F,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAQD;;;;;;;GAOG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,MAAM,CAA2B;IAE1C,YAAY,OAAe,EAAE,SAAmC,EAAE;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,iBAAiB,CAAgB;IAE1C,YAAY,OAAe,EAAE,iBAAgC;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF;AAmBD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAkB,EAClB,OAAqC;IAErC,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,oBAAoB,CAC5B,OAAO,CAAC,eAAe;YACrB,cAAc,OAAO,CAAC,SAAS,4BAA4B,MAAM,GAAG,IAAI,EAAE,CAC7E,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,8EAA8E;IAC9E,8EAA8E;IAC9E,2EAA2E;IAC3E,EAAE;IACF,+EAA+E;IAC/E,gFAAgF;IAChF,+EAA+E;IAC/E,gDAAgD;IAChD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,sBAAsB,CAC9B,cAAc,OAAO,CAAC,SAAS,wBAAwB,QAAQ,CAAC,MAAM,IAAI,MAAM,EAAE,EAClF,IAAI,CAAC,MAAM,CACZ,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,iBAAiB,GAAG,sBAAsB,CAC9C,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAC7C,CAAC;QACF,MAAM,IAAI,GACR,iBAAiB,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,iBAAiB,IAAI,CAAC;QAC1E,MAAM,IAAI,qBAAqB,CAC7B,cAAc,OAAO,CAAC,SAAS,0BAA0B,MAAM,GAAG,IAAI,EAAE,EACxE,iBAAiB,CAClB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,kBAAkB,CAC1B,cAAc,OAAO,CAAC,SAAS,YAAY,QAAQ,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,CACpF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,QAAkB;IAC7C,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAE1D,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAAG,MAAkE,CAAC;IAClF,MAAM,OAAO,GACX,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK;QAC9C,CAAC,CAAC,MAAM,CAAC,KAAK;QACd,CAAC,CAAC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO;YACpD,CAAC,CAAC,MAAM,CAAC,OAAO;YAChB,CAAC,CAAC,IAAI,CAAC;IAEb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,6FAA6F;AAC7F,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,MAAM,GAA6B,EAAE,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,SAAS;QAC1E,MAAM,KAAK,GAAG,KAA8C,CAAC;QAC7D,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;YAAE,SAAS;QAChD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YACtD,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAS,sBAAsB,CAAC,MAAqB;IACnD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { PeerPay, type PeerPayKeyMode, type PeerPayClientOptions, type SellerConfig, type CheckoutAmountInput, type CheckoutCreateInput, type CheckoutLink, type CheckoutSession, type CheckoutAttempt, type CheckoutAttemptStatus, type SimulatePaymentOptions, type GateConfig, type ResolvingGate, } from "./client.js";
+export { type SubscriptionPlan, type SubscriptionPlanStatus, type PlanCreateInput, type PlansResource, } from "./plans.js";
+export { type Customer, type CustomerCreateInput, type CustomerUpdateInput, type CustomersResource, } from "./customers.js";
+export { type Invoice, type InvoiceStatus, type InvoiceLineInput, type InvoiceDraftInput, type InvoiceEmailDelivery, type InvoicesResource, } from "./invoices.js";
+export { type Mandate, type MandateKind, type MandateStatus, type MandateCreateInput, type MandateCreateResult, type MandateCharge, type MandateChargeInput, type MandateChargeStatus, type MandateListOptions, type MandateListPage, type PermitTypedData, type MandatesResource, } from "./mandates.js";
+export { PeerPayConfigError, PeerPayNetworkSafetyError, PeerPayNotFoundError, PeerPayValidationError, PeerPayRateLimitError, type PeerPayValidationIssue, } from "./errors.js";
+export { constructEvent, isKnownPeerPayEventType, PEERPAY_EVENT_TYPES, PeerPaySignatureVerificationError, type PeerPayEvent, type PeerPayAnyEvent, type PeerPayUnknownEvent, type PeerPayEventType, type PeerPayPaymentEvent, type PeerPayMandateEvent, type PeerPayAgentPaymentEvent, type PeerPayPaymentEventData, type PeerPayMandateEventData, type ConstructEventOptions, } from "./webhooks.js";
+export { createPaymentGate, type PaymentGate, type PaymentGateConfig, type SettlementContext, type SettlementVerification, type VerifySettlement, type WrapOptions, } from "./payment-gate.js";
+export { peerPaySettlement, DEFAULT_FACILITATOR_BASE_URL, type PeerPaySettlementOptions, } from "./peerpay-settlement.js";
+export { resolvePaymentGateNetwork, type PaymentGateNetwork, type PaymentGateNetworkConfig, } from "./networks.js";
+export { parseUsdcAmountToMinorUnits } from "./usdc-amount.js";
+export { createMandateGate, MANDATE_HEADER, type MandateChargeOutcome, type MandateGate, type MandateGateOptions, } from "./mandate-gate.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAKvB,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,iCAAiC,EACjC,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,yBAAyB,EACzB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// @genesis-tech/genesispay-seller — framework-agnostic x402 payment gate.
+export { PeerPay, } from "./client.js";
+// Every SDK method throws from this set: 404 → NotFound, 422 (and 400 when the
+// body carries structured `issues`) → Validation, 429 → RateLimit (with
+// `retryAfterSeconds`), anything else → Config.
+export { PeerPayConfigError, PeerPayNetworkSafetyError, PeerPayNotFoundError, PeerPayValidationError, PeerPayRateLimitError, } from "./errors.js";
+export { constructEvent, isKnownPeerPayEventType, PEERPAY_EVENT_TYPES, PeerPaySignatureVerificationError, } from "./webhooks.js";
+export { createPaymentGate, } from "./payment-gate.js";
+export { peerPaySettlement, DEFAULT_FACILITATOR_BASE_URL, } from "./peerpay-settlement.js";
+export { resolvePaymentGateNetwork, } from "./networks.js";
+export { parseUsdcAmountToMinorUnits } from "./usdc-amount.js";
+export { createMandateGate, MANDATE_HEADER, } from "./mandate-gate.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,EACL,OAAO,GAaR,MAAM,aAAa,CAAC;AA4CrB,+EAA+E;AAC/E,wEAAwE;AACxE,gDAAgD;AAChD,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GAEtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,iCAAiC,GAWlC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,iBAAiB,GAOlB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iBAAiB,EACjB,4BAA4B,GAE7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,yBAAyB,GAG1B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,EACL,iBAAiB,EACjB,cAAc,GAIf,MAAM,mBAAmB,CAAC"}

package/dist/invoices.d.ts

@@ -0,0 +1,80 @@
+import { type Customer } from "./customers.js";
+import { type PeerPayRequest } 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: PeerPayRequest): 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 @@
+// `peerpay.invoices.*` — one-off invoice lifecycle over `/api/v1/invoices`.
+import { PeerPayConfigError } 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 PeerPayConfigError(`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 PeerPayConfigError("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 PeerPayConfigError(`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 PeerPayConfigError(`GenesisPay ${method} ${path} returned no invoice: ${JSON.stringify(response)}`);
+    }
+    return toInvoice(raw);
+}
+function requirePublicId(publicId, method) {
+    const id = publicId?.trim();
+    if (!id) {
+        throw new PeerPayConfigError(`${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 `PEERPAY-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 = "PEERPAY-MANDATE";
+export type MandateGateOptions = {
+    /** Decimal charge per request, e.g. "0.08". */
+    amount: string;
+    /** Base URL of the GenesisPay app (your PEERPAY_BASE_URL). */
+    baseUrl: string;
+    /** GenesisPay seller API key ("pp_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 `PEERPAY-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