@genesis-tech/genesispay-seller 0.13.1 → 0.13.2

package/dist/customers.d.ts

@@ -0,0 +1,41 @@
+import { type GenesisPayRequest } from "./resource.js";
+export type Customer = {
+    id: string;
+    publicId: string;
+    name: string;
+    email: string;
+    companyName: string | null;
+    addressLine1: string | null;
+    addressLine2: string | null;
+    city: string | null;
+    postalCode: string | null;
+    countryCode: string | null;
+    taxId: string | null;
+    metadata: Record<string, string> | null;
+    createdAt: string;
+    updatedAt: string;
+    archivedAt: string | null;
+};
+export type CustomerCreateInput = {
+    name: string;
+    email: string;
+    companyName?: string;
+    addressLine1?: string;
+    addressLine2?: string;
+    city?: string;
+    postalCode?: string;
+    countryCode?: string;
+    taxId?: string;
+    metadata?: Record<string, string>;
+};
+export type CustomerUpdateInput = Partial<CustomerCreateInput>;
+export interface CustomersResource {
+    create(input: CustomerCreateInput): Promise<Customer>;
+    list(): Promise<Customer[]>;
+    retrieve(publicId: string): Promise<Customer>;
+    update(publicId: string, input: CustomerUpdateInput): Promise<Customer>;
+    archive(publicId: string): Promise<Customer>;
+}
+export declare function createCustomersResource(request: GenesisPayRequest): CustomersResource;
+export declare function toCustomer(raw: Record<string, unknown>): Customer;
+//# sourceMappingURL=customers.d.ts.map

package/dist/customers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.d.ts","sourceRoot":"","sources":["../src/customers.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxE,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC9C;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAoDrF;AAmCD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAkBjE"}

package/dist/customers.js

@@ -0,0 +1,76 @@
+// `genesispay.customers.*` — reusable billing contacts over `/api/v1/customers`.
+import { GenesisPayConfigError } 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 GenesisPayConfigError(`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 GenesisPayConfigError(`GenesisPay ${method} ${path} returned no customer: ${JSON.stringify(response)}`);
+    }
+    return toCustomer(raw);
+}
+function requirePublicId(publicId, method) {
+    const id = publicId?.trim();
+    if (!id) {
+        throw new GenesisPayConfigError(`${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/entitlements.d.ts

@@ -0,0 +1,19 @@
+import { type GenesisPayRequest } from "./resource.js";
+export type VerifiedEntitlement = {
+    valid: boolean;
+    entitlement: {
+        publicId: string;
+        productId: string;
+        sku: string | null;
+        paymentAttemptId: string;
+        simulated: boolean;
+        expiresAt: string;
+        redemptionCount: number;
+    };
+};
+export interface EntitlementsResource {
+    /** Seller-scoped hard check for a redirect entitlement. */
+    verify(entitlementId: string): Promise<VerifiedEntitlement>;
+}
+export declare function createEntitlementsResource(request: GenesisPayRequest): EntitlementsResource;
+//# sourceMappingURL=entitlements.d.ts.map

package/dist/entitlements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.d.ts","sourceRoot":"","sources":["../src/entitlements.ts"],"names":[],"mappings":"AACA,OAAO,EAA4C,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEjG,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC7D;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iBAAiB,GAAG,oBAAoB,CAuB3F"}

package/dist/entitlements.js

@@ -0,0 +1,30 @@
+import { GenesisPayConfigError } from "./errors.js";
+import { asRecord, optionalString, requiredString } from "./resource.js";
+export function createEntitlementsResource(request) {
+    return {
+        async verify(entitlementId) {
+            const id = entitlementId?.trim();
+            if (!id?.startsWith("ent_"))
+                throw new GenesisPayConfigError("entitlements.verify requires an ent_… id.");
+            const body = await request({
+                path: `/api/v1/entitlements/verify?entitlement=${encodeURIComponent(id)}`,
+                operation: "GET /api/v1/entitlements/verify",
+                action: `verify entitlement "${id}"`,
+                notFoundMessage: "The entitlement does not exist or does not belong to this seller.",
+            });
+            const root = asRecord(body);
+            const raw = asRecord(root?.entitlement);
+            if (!raw)
+                throw new GenesisPayConfigError("GenesisPay entitlement verification returned no entitlement.");
+            return {
+                valid: root?.valid === true,
+                entitlement: {
+                    publicId: requiredString(raw.publicId), productId: requiredString(raw.productId), sku: optionalString(raw.sku),
+                    paymentAttemptId: requiredString(raw.paymentAttemptId), simulated: raw.simulated === true,
+                    expiresAt: requiredString(raw.expiresAt), redemptionCount: typeof raw.redemptionCount === "number" ? raw.redemptionCount : 0,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=entitlements.js.map

package/dist/entitlements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.js","sourceRoot":"","sources":["../src/entitlements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAA0B,MAAM,eAAe,CAAC;AAoBjG,MAAM,UAAU,0BAA0B,CAAC,OAA0B;IACnE,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,aAAa;YACxB,MAAM,EAAE,GAAG,aAAa,EAAE,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,qBAAqB,CAAC,2CAA2C,CAAC,CAAC;YAC1G,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;gBACzB,IAAI,EAAE,2CAA2C,kBAAkB,CAAC,EAAE,CAAC,EAAE;gBACzE,SAAS,EAAE,iCAAiC;gBAC5C,MAAM,EAAE,uBAAuB,EAAE,GAAG;gBACpC,eAAe,EAAE,mEAAmE;aACrF,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAAC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACrE,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,qBAAqB,CAAC,8DAA8D,CAAC,CAAC;YAC1G,OAAO;gBACL,KAAK,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI;gBAC3B,WAAW,EAAE;oBACX,QAAQ,EAAE,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;oBAC9G,gBAAgB,EAAE,cAAc,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,KAAK,IAAI;oBACzF,SAAS,EAAE,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;iBAC7H;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,63 @@
+/** Missing/invalid key, unresolvable prod URL, or unreachable backend. */
+export declare class GenesisPayConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * The requested resource does not exist (HTTP 404). Kept separate from
+ * `GenesisPayConfigError` 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 GenesisPayNotFoundError extends Error {
+    constructor(message: string);
+}
+/** Asset-integrity, mode↔network, or expectedPayTo-pin mismatch — a money-safety stop. */
+export declare class GenesisPayNetworkSafetyError extends Error {
+    constructor(message: string);
+}
+/** One rejected field, as the API reports it. `path` is dot-joined ("metadata.orderId"). */
+export type GenesisPayValidationIssue = {
+    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 GenesisPayValidationError extends Error {
+    readonly issues: GenesisPayValidationIssue[];
+    constructor(message: string, issues?: GenesisPayValidationIssue[]);
+}
+/**
+ * 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 GenesisPayRateLimitError 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,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,0FAA0F;AAC1F,qBAAa,4BAA6B,SAAQ,KAAK;gBACzC,OAAO,EAAE,MAAM;CAI5B;AAED,4FAA4F;AAC5F,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;GAOG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,MAAM,EAAE,yBAAyB,EAAE,CAAC;gBAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,yBAAyB,EAAO;CAKtE;AAED;;;;;;;GAOG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,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 GenesisPayConfigError(...)` 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 GenesisPayConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GenesisPayConfigError";
+    }
+}
+/**
+ * The requested resource does not exist (HTTP 404). Kept separate from
+ * `GenesisPayConfigError` 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 GenesisPayNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GenesisPayNotFoundError";
+    }
+}
+/** Asset-integrity, mode↔network, or expectedPayTo-pin mismatch — a money-safety stop. */
+export class GenesisPayNetworkSafetyError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GenesisPayNetworkSafetyError";
+    }
+}
+/**
+ * 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 GenesisPayValidationError extends Error {
+    issues;
+    constructor(message, issues = []) {
+        super(message);
+        this.name = "GenesisPayValidationError";
+        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 GenesisPayRateLimitError extends Error {
+    retryAfterSeconds;
+    constructor(message, retryAfterSeconds) {
+        super(message);
+        this.name = "GenesisPayRateLimitError";
+        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 GenesisPayNotFoundError(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 GenesisPayValidationError — 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 GenesisPayConfigError 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 GenesisPayValidationError(`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 GenesisPayRateLimitError(`GenesisPay ${options.operation} was rate limited (429)${suffix}${wait}`, retryAfterSeconds);
+    }
+    throw new GenesisPayConfigError(`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":"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"}

package/dist/genesispay-settlement.d.ts

@@ -0,0 +1,30 @@
+import type { VerifySettlement } from "./payment-gate.js";
+/**
+ * Default GenesisPay app base URL — the public "development" facilitator. Used
+ * when `facilitatorBaseUrl` is omitted so integrators don't have to configure a
+ * URL in dev. Set `facilitatorBaseUrl` explicitly for production.
+ *
+ * The custom domain rather than the Railway-generated hostname: the generated
+ * form encodes the service name and breaks when the service is renamed.
+ */
+export declare const DEFAULT_FACILITATOR_BASE_URL = "https://dev.genesispay.finance";
+export type GenesisPaySettlementOptions = {
+    /**
+     * Base URL of the GenesisPay app, e.g. "https://genesispay.example". Defaults to
+     * the public development facilitator (DEFAULT_FACILITATOR_BASE_URL) when
+     * omitted; set it explicitly in production.
+     */
+    facilitatorBaseUrl?: string;
+    /** GenesisPay seller API key ("gp_sk_..."). */
+    apiKey: string;
+    /** Override for testing; defaults to global fetch. */
+    fetchFn?: typeof fetch;
+};
+/**
+ * Built-in settlement hook that forwards the PAYMENT-SIGNATURE payload to the
+ * GenesisPay facilitator (`POST /api/v1/facilitator/settle`). GenesisPay broadcasts
+ * the EIP-3009 authorization on-chain (or verifies a payer-provided txHash)
+ * and verifies the USDC transfer before reporting success.
+ */
+export declare function genesisPaySettlement(options: GenesisPaySettlementOptions): VerifySettlement;
+//# sourceMappingURL=genesispay-settlement.d.ts.map

package/dist/genesispay-settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genesispay-settlement.d.ts","sourceRoot":"","sources":["../src/genesispay-settlement.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,mCAAmC,CAAC;AAE7E,MAAM,MAAM,2BAA2B,GAAG;IACxC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,gBAAgB,CA6DlB"}

package/dist/genesispay-settlement.js

@@ -0,0 +1,103 @@
+import { parseSettlementResponsePayload } from "@genesis-tech/genesispay-protocol";
+/**
+ * Default GenesisPay app base URL — the public "development" facilitator. Used
+ * when `facilitatorBaseUrl` is omitted so integrators don't have to configure a
+ * URL in dev. Set `facilitatorBaseUrl` explicitly for production.
+ *
+ * The custom domain rather than the Railway-generated hostname: the generated
+ * form encodes the service name and breaks when the service is renamed.
+ */
+export const DEFAULT_FACILITATOR_BASE_URL = "https://dev.genesispay.finance";
+/**
+ * Built-in settlement hook that forwards the PAYMENT-SIGNATURE payload to the
+ * GenesisPay facilitator (`POST /api/v1/facilitator/settle`). GenesisPay broadcasts
+ * the EIP-3009 authorization on-chain (or verifies a payer-provided txHash)
+ * and verifies the USDC transfer before reporting success.
+ */
+export function genesisPaySettlement(options) {
+    const settleUrl = buildSettleUrl(options.facilitatorBaseUrl?.trim() || DEFAULT_FACILITATOR_BASE_URL);
+    const apiKey = options.apiKey?.trim();
+    if (!apiKey) {
+        throw new Error("genesisPaySettlement requires a GenesisPay seller API key (gp_sk_...).");
+    }
+    const fetchFn = options.fetchFn ?? fetch;
+    return async (context) => {
+        const { requirement } = context;
+        let response;
+        try {
+            response = await fetchFn(settleUrl, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify({
+                    paymentSignature: context.paymentSignatureHeader,
+                    requirement: {
+                        resource: requirement.resource,
+                        network: requirement.network,
+                        chainId: requirement.chainId,
+                        assetAddress: requirement.assetAddress,
+                        amountUsdcMinor: requirement.maxAmountRequired,
+                        payTo: requirement.payTo,
+                        description: requirement.description || undefined,
+                    },
+                }),
+            });
+        }
+        catch (error) {
+            return {
+                ok: false,
+                errorReason: `Failed to reach the GenesisPay facilitator: ${describeError(error)}`,
+            };
+        }
+        const body = await readJsonBody(response);
+        const settlement = tryParseSettlement(body);
+        if (response.ok && settlement?.success) {
+            return { ok: true, settlement };
+        }
+        return {
+            ok: false,
+            errorReason: settlement?.errorReason ??
+                readErrorMessage(body) ??
+                `GenesisPay facilitator settlement failed with status ${response.status}.`,
+            ...(settlement ? { settlement } : {}),
+        };
+    };
+}
+function buildSettleUrl(facilitatorBaseUrl) {
+    const trimmed = facilitatorBaseUrl?.trim().replace(/\/+$/, "");
+    if (!trimmed || !/^https?:\/\//.test(trimmed)) {
+        throw new Error(`Invalid facilitatorBaseUrl "${String(facilitatorBaseUrl)}": expected an http(s) URL like "https://genesispay.example".`);
+    }
+    return `${trimmed}/api/v1/facilitator/settle`;
+}
+async function readJsonBody(response) {
+    try {
+        return await response.json();
+    }
+    catch {
+        return undefined;
+    }
+}
+function tryParseSettlement(body) {
+    try {
+        return parseSettlementResponsePayload(body);
+    }
+    catch {
+        return undefined;
+    }
+}
+function readErrorMessage(body) {
+    if (typeof body === "object" &&
+        body !== null &&
+        "error" in body &&
+        typeof body.error === "string") {
+        return body.error;
+    }
+    return undefined;
+}
+function describeError(error) {
+    return error instanceof Error ? error.message : "unknown error";
+}
+//# sourceMappingURL=genesispay-settlement.js.map

package/dist/genesispay-settlement.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { GenesisPay, type GenesisPayKeyMode, type GenesisPayClientOptions, 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 Product, type ProductCreateInput, type ProductPaymentLink, type ProductDelivery, type ProductGate, type ProductGatePurchase, type ProductsResource, } from "./products.js";
+export { type EntitlementsResource, type VerifiedEntitlement } from "./entitlements.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 { GenesisPayConfigError, GenesisPayNetworkSafetyError, GenesisPayNotFoundError, GenesisPayValidationError, GenesisPayRateLimitError, type GenesisPayValidationIssue, } from "./errors.js";
+export { constructEvent, isKnownGenesisPayEventType, GENESISPAY_EVENT_TYPES, GenesisPaySignatureVerificationError, type GenesisPayEvent, type GenesisPayAnyEvent, type GenesisPayUnknownEvent, type GenesisPayEventType, type GenesisPayPaymentEvent, type GenesisPayMandateEvent, type GenesisPayAgentPaymentEvent, type GenesisPayPaymentEventData, type GenesisPayMandateEventData, type ConstructEventOptions, } from "./webhooks.js";
+export { createPaymentGate, type PaymentGate, type PaymentGateConfig, type SettlementContext, type SettlementVerification, type VerifySettlement, type WrapOptions, } from "./payment-gate.js";
+export { genesisPaySettlement, DEFAULT_FACILITATOR_BASE_URL, type GenesisPaySettlementOptions, } from "./genesispay-settlement.js";
+export { resolvePaymentGateNetwork, type PaymentGateNetwork, type PaymentGateNetworkConfig, } from "./networks.js";
+export { parseUsdcAmountToMinorUnits } from "./usdc-amount.js";
+export { CHECKOUT_RETURN_LINK_ID_PARAM, CHECKOUT_RETURN_STATUS_PARAM, parseCheckoutReturnHint, type CheckoutReturnHint, } from "./checkout-return.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,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,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;AAIpB,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExF,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,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,oCAAoC,EACpC,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,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,oBAAoB,EACpB,4BAA4B,EAC5B,KAAK,2BAA2B,GACjC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,yBAAyB,EACzB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAM/D,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,EACvB,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,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,18 @@
+// @genesis-tech/genesispay-seller — framework-agnostic x402 payment gate.
+export { GenesisPay, } 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 { GenesisPayConfigError, GenesisPayNetworkSafetyError, GenesisPayNotFoundError, GenesisPayValidationError, GenesisPayRateLimitError, } from "./errors.js";
+export { constructEvent, isKnownGenesisPayEventType, GENESISPAY_EVENT_TYPES, GenesisPaySignatureVerificationError, } from "./webhooks.js";
+export { createPaymentGate, } from "./payment-gate.js";
+export { genesisPaySettlement, DEFAULT_FACILITATOR_BASE_URL, } from "./genesispay-settlement.js";
+export { resolvePaymentGateNetwork, } from "./networks.js";
+export { parseUsdcAmountToMinorUnits } from "./usdc-amount.js";
+// Checkout return parameters: the query-parameter names GenesisPay appends to a
+// merchant's `returnUrl`, plus the typed hint parser that reads them back. The
+// hint is a UI convenience, not proof of payment — verify with
+// `checkout.retrieve(hint.linkId)` before acting on it.
+export { CHECKOUT_RETURN_LINK_ID_PARAM, CHECKOUT_RETURN_STATUS_PARAM, parseCheckoutReturnHint, } from "./checkout-return.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,UAAU,GAaX,MAAM,aAAa,CAAC;AA0DrB,+EAA+E;AAC/E,wEAAwE;AACxE,gDAAgD;AAChD,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,GAEzB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,oCAAoC,GAWrC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,iBAAiB,GAOlB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,oBAAoB,EACpB,4BAA4B,GAE7B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,yBAAyB,GAG1B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAE/D,gFAAgF;AAChF,+EAA+E;AAC/E,+DAA+D;AAC/D,wDAAwD;AACxD,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,GAExB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,cAAc,GAIf,MAAM,mBAAmB,CAAC"}