@seedhape/x402-merchant-sdk 0.5.2 → 0.5.3

package/dist/commerce.js.map

@@ -1 +1 @@
-{"version":3,"file":"commerce.js","sourceRoot":"","sources":["../src/commerce.ts"],"names":[],"mappings":"AAyBA;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA8B;IACnE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAElG,OAAO;QACL,OAAO;YACL,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACvC,GAAG,OAAO;gBACV,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE;gBACpE,YAAY,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAU;aACxD,CAAC,CAAC,CAAC;QACN,CAAC;QACD,OAAO,CAAC,EAAU;YAChB,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;QAC9B,CAAC;QACD,UAAU,CAAC,EAAU;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7B,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;YACjE,OAAO;gBACL,GAAG,MAAM,CAAC,OAAO;gBACjB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;aAC/G,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"commerce.js","sourceRoot":"","sources":["../src/commerce.ts"],"names":[],"mappings":"AA2BA;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA8B;IACnE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAElG,OAAO;QACL,OAAO;YACL,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACvC,GAAG,OAAO;gBACV,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE;gBACpE,YAAY,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAU;gBACvD,cAAc,EAAE,CAAC,MAAM,CAAU;aAClC,CAAC,CAAC,CAAC;QACN,CAAC;QACD,OAAO,CAAC,EAAU;YAChB,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;QAC9B,CAAC;QACD,UAAU,CAAC,EAAU;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7B,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;YACjE,OAAO;gBACL,GAAG,MAAM,CAAC,OAAO;gBACjB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;aAC/G,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/fulfillment.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Protocol-neutral delivery values for products fulfilled after payment.
+ *
+ * The SDK does not store files or host merchant inventory. These helpers give
+ * merchants a stable response shape for their own storage, license, or
+ * entitlement systems while payment remains handled by the seller paywall.
+ */
+import type { SellerFulfillment, SellerFulfillmentContext, SellerProductKind } from "./seller.js";
+export interface DownloadGrant {
+    assetId: string;
+    orderId: string;
+    productId: string;
+    expiresAt: number;
+    maxDownloads?: number;
+}
+export interface DownloadAsset {
+    body: string | Uint8Array | ArrayBuffer | ReadableStream<Uint8Array>;
+    filename: string;
+    contentType?: string;
+    contentLength?: number;
+}
+export interface DownloadHandlerOptions {
+    secret: string;
+    resolveAsset: (grant: DownloadGrant) => Promise<DownloadAsset | null>;
+    /** Return false when the grant has reached its atomic download limit. */
+    consumeGrant?: (grant: DownloadGrant) => Promise<boolean>;
+}
+export interface LocalDownloadAsset {
+    relativePath: string;
+    filename: string;
+    contentType?: string;
+}
+export interface RemoteDownloadAsset {
+    url: string;
+    filename: string;
+    contentType?: string;
+}
+export type FulfillmentHandler = (context: SellerFulfillmentContext) => SellerFulfillment | Promise<SellerFulfillment>;
+export type FulfillmentRouterOptions = Partial<Record<SellerProductKind, FulfillmentHandler>>;
+/** Sign a short-lived, storage-opaque grant for a hosted download route. */
+export declare function createDownloadGrant(input: {
+    secret: string;
+    assetId: string;
+    orderId: string;
+    productId: string;
+    expiresInSeconds?: number;
+    maxDownloads?: number;
+    now?: number;
+}): Promise<{
+    token: string;
+    grant: DownloadGrant;
+}>;
+/** Verify a grant and return only the claims needed by a storage adapter. */
+export declare function verifyDownloadGrant(token: string, secret: string, now?: number): Promise<DownloadGrant>;
+/**
+ * Build a hosted download endpoint around private storage.
+ *
+ * The resolver should fetch the asset only after grant verification. When a
+ * grant has a maxDownloads value, provide consumeGrant backed by an atomic
+ * database update so concurrent requests cannot exceed the limit.
+ */
+export declare function createDownloadHandler(options: DownloadHandlerOptions): (request: Request) => Promise<Response>;
+/**
+ * Resolve assets from a private local directory without allowing path escape.
+ * This is intended for a small merchant deployment; object-storage adapters
+ * can implement the same DownloadHandlerOptions.resolveAsset contract.
+ */
+export declare function createLocalDownloadResolver(input: {
+    rootDir: string;
+    assets: Record<string, LocalDownloadAsset>;
+}): (grant: DownloadGrant) => Promise<DownloadAsset | null>;
+/** Resolve a private object-storage URL without exposing it to the buyer. */
+export declare function createRemoteDownloadResolver(input: {
+    getAsset: (grant: DownloadGrant) => Promise<RemoteDownloadAsset | null>;
+    timeoutMs?: number;
+    maxBytes?: number;
+}): (grant: DownloadGrant) => Promise<DownloadAsset | null>;
+/** Select the merchant's delivery handler from the product's declared kind. */
+export declare function createFulfillmentRouter(handlers: FulfillmentRouterOptions): FulfillmentHandler;
+export type DigitalDownloadDelivery = {
+    type: "digital_download";
+    downloadUrl: string;
+    filename: string;
+    expiresAt?: number;
+    maxDownloads?: number;
+};
+export type LicenseDelivery = {
+    type: "license";
+    licenseKey?: string;
+    activationUrl?: string;
+    metadata?: Record<string, string>;
+};
+export type WebhookDelivery = {
+    type: "webhook";
+    reference: string;
+};
+export type FulfillmentDelivery = DigitalDownloadDelivery | LicenseDelivery | WebhookDelivery;
+export interface FulfillmentWebhookEvent {
+    id: string;
+    type: "license.issue" | "license.revoke" | "subscription.activate" | "subscription.renew" | "subscription.cancel";
+    orderId: string;
+    productId: string;
+    buyerId?: string;
+    paymentReference?: string;
+    data?: Record<string, unknown>;
+}
+export interface FulfillmentWebhookResult {
+    status: number;
+    body: unknown;
+}
+export interface FulfillmentWebhookRetryOptions {
+    attempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    /** Injectable for tests and job runners. */
+    wait?: (milliseconds: number) => Promise<void>;
+}
+/** Parse and validate a signed webhook body before applying business logic. */
+export declare function parseFulfillmentWebhookEvent(body: string): FulfillmentWebhookEvent;
+/** Verify the timestamped HMAC headers received by a merchant webhook. */
+export declare function verifyFulfillmentWebhookSignature(input: {
+    secret: string;
+    timestamp: string;
+    signature: string;
+    body: string;
+    toleranceSeconds?: number;
+    now?: number;
+}): boolean;
+/** Create a validated, buyer-safe delivery response for a merchant-signed URL. */
+export declare function createDownloadDelivery(input: {
+    downloadUrl: string;
+    filename: string;
+    expiresAt?: number;
+    maxDownloads?: number;
+}): DigitalDownloadDelivery;
+export declare function createLicenseDelivery(input: {
+    licenseKey?: string;
+    activationUrl?: string;
+    metadata?: Record<string, string>;
+}): LicenseDelivery;
+export declare function createWebhookDelivery(reference: string): WebhookDelivery;
+type FulfillmentWebhookInput = {
+    url: string;
+    secret: string;
+    event: FulfillmentWebhookEvent;
+    timeoutMs?: number;
+};
+/** Send a signed, idempotent fulfillment event to a merchant-owned system. */
+export declare function sendFulfillmentWebhook(input: FulfillmentWebhookInput): Promise<FulfillmentWebhookResult>;
+/** Retry a fulfillment event without changing its idempotency key or signature payload. */
+export declare function sendFulfillmentWebhookWithRetry(input: Parameters<typeof sendFulfillmentWebhook>[0], retry?: FulfillmentWebhookRetryOptions): Promise<FulfillmentWebhookResult>;
+export {};
+//# sourceMappingURL=fulfillment.d.ts.map

package/dist/fulfillment.d.ts.map

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

package/dist/fulfillment.js

@@ -0,0 +1,369 @@
+/**
+ * Protocol-neutral delivery values for products fulfilled after payment.
+ *
+ * The SDK does not store files or host merchant inventory. These helpers give
+ * merchants a stable response shape for their own storage, license, or
+ * entitlement systems while payment remains handled by the seller paywall.
+ */
+import { SignJWT, jwtVerify } from "jose";
+import { createHmac, timingSafeEqual } from "node:crypto";
+import { realpath, readFile, stat } from "node:fs/promises";
+import { isAbsolute, relative, resolve } from "node:path";
+import { validateOutboundUrl } from "@seedhape/core";
+const DOWNLOAD_GRANT_ISSUER = "seedhape-download";
+function signingKey(secret) {
+    if (secret.length < 32)
+        throw new Error("download grant secret must be at least 32 characters.");
+    return new TextEncoder().encode(secret);
+}
+function requiredText(value, field) {
+    if (!value.trim() || value.length > 512)
+        throw new Error(`${field} must contain 1-512 characters.`);
+    return value;
+}
+/** Sign a short-lived, storage-opaque grant for a hosted download route. */
+export async function createDownloadGrant(input) {
+    const now = input.now ?? Math.floor(Date.now() / 1000);
+    const lifetime = input.expiresInSeconds ?? 3600;
+    if (!Number.isSafeInteger(lifetime) || lifetime < 60 || lifetime > 86_400)
+        throw new Error("expiresInSeconds must be an integer from 60 to 86400.");
+    if (input.maxDownloads !== undefined && (!Number.isSafeInteger(input.maxDownloads) || input.maxDownloads < 1))
+        throw new Error("maxDownloads must be a positive integer.");
+    const grant = {
+        assetId: requiredText(input.assetId, "assetId"),
+        orderId: requiredText(input.orderId, "orderId"),
+        productId: requiredText(input.productId, "productId"),
+        expiresAt: now + lifetime,
+        ...(input.maxDownloads === undefined ? {} : { maxDownloads: input.maxDownloads }),
+    };
+    const token = await new SignJWT({
+        asset_id: grant.assetId,
+        order_id: grant.orderId,
+        product_id: grant.productId,
+        ...(grant.maxDownloads === undefined ? {} : { max_downloads: grant.maxDownloads }),
+    })
+        .setProtectedHeader({ alg: "HS256", typ: "JWT" })
+        .setIssuer(DOWNLOAD_GRANT_ISSUER)
+        .setIssuedAt(now)
+        .setExpirationTime(grant.expiresAt)
+        .sign(signingKey(input.secret));
+    return { token, grant };
+}
+/** Verify a grant and return only the claims needed by a storage adapter. */
+export async function verifyDownloadGrant(token, secret, now = Math.floor(Date.now() / 1000)) {
+    const { payload } = await jwtVerify(token, signingKey(secret), { algorithms: ["HS256"], issuer: DOWNLOAD_GRANT_ISSUER });
+    const assetId = payload.asset_id;
+    const orderId = payload.order_id;
+    const productId = payload.product_id;
+    const expiresAt = payload.exp;
+    const maxDownloads = payload.max_downloads;
+    if (typeof assetId !== "string" || typeof orderId !== "string" || typeof productId !== "string" || typeof expiresAt !== "number" || expiresAt <= now) {
+        throw new Error("Invalid download grant claims.");
+    }
+    if (maxDownloads !== undefined && (typeof maxDownloads !== "number" || !Number.isSafeInteger(maxDownloads) || maxDownloads < 1))
+        throw new Error("Invalid download grant limit.");
+    return { assetId, orderId, productId, expiresAt, ...(maxDownloads === undefined ? {} : { maxDownloads }) };
+}
+function contentDisposition(filename) {
+    const safe = filename.replace(/[\\"\r\n]/g, "_");
+    return `attachment; filename="${safe}"`;
+}
+/**
+ * Build a hosted download endpoint around private storage.
+ *
+ * The resolver should fetch the asset only after grant verification. When a
+ * grant has a maxDownloads value, provide consumeGrant backed by an atomic
+ * database update so concurrent requests cannot exceed the limit.
+ */
+export function createDownloadHandler(options) {
+    signingKey(options.secret);
+    return async (request) => {
+        if (request.method !== "GET" && request.method !== "HEAD")
+            return new Response("Method Not Allowed", { status: 405, headers: { allow: "GET, HEAD" } });
+        const url = new URL(request.url);
+        let token;
+        try {
+            token = url.searchParams.get("token") ?? decodeURIComponent(url.pathname.split("/").filter(Boolean).at(-1) ?? "");
+        }
+        catch {
+            return new Response("Malformed download token", { status: 400 });
+        }
+        if (!token)
+            return new Response("Download token is required", { status: 400 });
+        let grant;
+        try {
+            grant = await verifyDownloadGrant(token, options.secret);
+        }
+        catch {
+            return new Response("Invalid or expired download link", { status: 401 });
+        }
+        const asset = await options.resolveAsset(grant);
+        if (!asset)
+            return new Response("Download not found", { status: 404 });
+        if (grant.maxDownloads !== undefined) {
+            if (!options.consumeGrant)
+                return new Response("Download delivery is not configured", { status: 503 });
+            if (!(await options.consumeGrant(grant)))
+                return new Response("Download limit reached", { status: 410 });
+        }
+        const headers = new Headers({ "content-type": asset.contentType ?? "application/octet-stream", "content-disposition": contentDisposition(asset.filename), "cache-control": "private, no-store" });
+        if (asset.contentLength !== undefined)
+            headers.set("content-length", String(asset.contentLength));
+        return new Response(request.method === "HEAD" ? null : asset.body, { status: 200, headers });
+    };
+}
+/**
+ * Resolve assets from a private local directory without allowing path escape.
+ * This is intended for a small merchant deployment; object-storage adapters
+ * can implement the same DownloadHandlerOptions.resolveAsset contract.
+ */
+export function createLocalDownloadResolver(input) {
+    if (isAbsolute(input.rootDir)) {
+        // Keep the explicit check here so a relative working-directory mistake is
+        // caught during setup rather than after a buyer has paid.
+    }
+    else {
+        throw new Error("rootDir must be an absolute path.");
+    }
+    const rootPromise = realpath(input.rootDir);
+    return async (grant) => {
+        const asset = input.assets[grant.assetId];
+        if (!asset || !asset.relativePath.trim() || isAbsolute(asset.relativePath))
+            return null;
+        const root = await rootPromise.catch(() => null);
+        if (!root)
+            return null;
+        const candidate = resolve(root, asset.relativePath);
+        const relation = relative(root, candidate);
+        if (relation.startsWith("..") || isAbsolute(relation))
+            return null;
+        try {
+            const actual = await realpath(candidate);
+            const actualRelation = relative(root, actual);
+            if (actualRelation.startsWith("..") || isAbsolute(actualRelation))
+                return null;
+            const metadata = await stat(actual);
+            if (!metadata.isFile())
+                return null;
+            return { body: await readFile(actual), filename: asset.filename, contentType: asset.contentType, contentLength: metadata.size };
+        }
+        catch {
+            return null;
+        }
+    };
+}
+/** Resolve a private object-storage URL without exposing it to the buyer. */
+export function createRemoteDownloadResolver(input) {
+    const timeoutMs = input.timeoutMs ?? 10_000;
+    const maxBytes = input.maxBytes ?? 50_000_000;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 100 || timeoutMs > 120_000)
+        throw new Error("timeoutMs must be an integer from 100 to 120000.");
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < 1_024 || maxBytes > 500_000_000)
+        throw new Error("maxBytes must be an integer from 1024 to 500000000.");
+    return async (grant) => {
+        const asset = await input.getAsset(grant);
+        if (!asset)
+            return null;
+        let url;
+        try {
+            url = await validateOutboundUrl(asset.url, { requireHttps: true });
+        }
+        catch {
+            return null;
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const response = await fetch(url, { redirect: "error", signal: controller.signal });
+            if (!response.ok)
+                return null;
+            const declaredLength = Number(response.headers.get("content-length"));
+            if (Number.isFinite(declaredLength) && declaredLength > maxBytes)
+                return null;
+            const body = await response.arrayBuffer();
+            if (body.byteLength > maxBytes)
+                return null;
+            return { body, filename: asset.filename, contentType: asset.contentType ?? response.headers.get("content-type") ?? undefined, contentLength: body.byteLength };
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === "AbortError")
+                return null;
+            return null;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    };
+}
+/** Select the merchant's delivery handler from the product's declared kind. */
+export function createFulfillmentRouter(handlers) {
+    return async (context) => {
+        const kind = context.product.kind ?? "api";
+        const handler = handlers[kind];
+        if (!handler)
+            throw new Error(`No fulfillment handler is configured for product kind '${kind}'.`);
+        return handler(context);
+    };
+}
+/** Parse and validate a signed webhook body before applying business logic. */
+export function parseFulfillmentWebhookEvent(body) {
+    let value;
+    try {
+        value = JSON.parse(body);
+    }
+    catch {
+        throw new Error("Fulfillment webhook body must be valid JSON.");
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("Fulfillment webhook event must be an object.");
+    const event = value;
+    const types = ["license.issue", "license.revoke", "subscription.activate", "subscription.renew", "subscription.cancel"];
+    if (typeof event.id !== "string" || !event.id.trim() || event.id.length > 256)
+        throw new Error("Fulfillment webhook event id is required.");
+    if (typeof event.type !== "string" || !types.includes(event.type))
+        throw new Error("Unsupported fulfillment webhook event type.");
+    if (typeof event.orderId !== "string" || !event.orderId.trim() || event.orderId.length > 512)
+        throw new Error("Fulfillment webhook orderId is required.");
+    if (typeof event.productId !== "string" || !event.productId.trim() || event.productId.length > 512)
+        throw new Error("Fulfillment webhook productId is required.");
+    if (event.buyerId !== undefined && (typeof event.buyerId !== "string" || event.buyerId.length > 512))
+        throw new Error("Fulfillment webhook buyerId is invalid.");
+    if (event.paymentReference !== undefined && (typeof event.paymentReference !== "string" || event.paymentReference.length > 512))
+        throw new Error("Fulfillment webhook paymentReference is invalid.");
+    if (event.data !== undefined && (!event.data || typeof event.data !== "object" || Array.isArray(event.data)))
+        throw new Error("Fulfillment webhook data must be an object.");
+    return event;
+}
+/** Verify the timestamped HMAC headers received by a merchant webhook. */
+export function verifyFulfillmentWebhookSignature(input) {
+    if (input.secret.length < 32 || !/^\d+$/.test(input.timestamp))
+        return false;
+    const timestamp = Number(input.timestamp);
+    const tolerance = input.toleranceSeconds ?? 300;
+    const now = input.now ?? Math.floor(Date.now() / 1000);
+    if (!Number.isSafeInteger(timestamp) || !Number.isSafeInteger(tolerance) || tolerance < 1 || Math.abs(now - timestamp) > tolerance)
+        return false;
+    const expected = signWebhook(input.secret, input.timestamp, input.body);
+    const received = Buffer.from(input.signature);
+    const calculated = Buffer.from(expected);
+    return received.length === calculated.length && timingSafeEqual(received, calculated);
+}
+function httpsUrl(value, field) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error(`${field} must be an absolute HTTPS URL.`);
+    }
+    if (url.protocol !== "https:")
+        throw new Error(`${field} must be an absolute HTTPS URL.`);
+    return url.toString();
+}
+/** Create a validated, buyer-safe delivery response for a merchant-signed URL. */
+export function createDownloadDelivery(input) {
+    if (!input.filename.trim() || input.filename.length > 255)
+        throw new Error("filename must contain 1-255 characters.");
+    if (input.expiresAt !== undefined && (!Number.isSafeInteger(input.expiresAt) || input.expiresAt <= Math.floor(Date.now() / 1000))) {
+        throw new Error("expiresAt must be a future Unix timestamp.");
+    }
+    if (input.maxDownloads !== undefined && (!Number.isSafeInteger(input.maxDownloads) || input.maxDownloads < 1)) {
+        throw new Error("maxDownloads must be a positive integer.");
+    }
+    return {
+        type: "digital_download",
+        downloadUrl: httpsUrl(input.downloadUrl, "downloadUrl"),
+        filename: input.filename,
+        ...(input.expiresAt === undefined ? {} : { expiresAt: input.expiresAt }),
+        ...(input.maxDownloads === undefined ? {} : { maxDownloads: input.maxDownloads }),
+    };
+}
+export function createLicenseDelivery(input) {
+    if (!input.licenseKey && !input.activationUrl)
+        throw new Error("A licenseKey or activationUrl is required.");
+    return {
+        type: "license",
+        ...(input.licenseKey === undefined ? {} : { licenseKey: input.licenseKey }),
+        ...(input.activationUrl === undefined ? {} : { activationUrl: httpsUrl(input.activationUrl, "activationUrl") }),
+        ...(input.metadata === undefined ? {} : { metadata: { ...input.metadata } }),
+    };
+}
+export function createWebhookDelivery(reference) {
+    if (!reference.trim())
+        throw new Error("Webhook fulfillment reference is required.");
+    return { type: "webhook", reference };
+}
+function signWebhook(secret, timestamp, body) {
+    if (secret.length < 32)
+        throw new Error("fulfillment webhook secret must be at least 32 characters.");
+    return `sha256=${createHmac("sha256", secret).update(`${timestamp}.${body}`).digest("hex")}`;
+}
+async function sendFulfillmentWebhookAtUrl(input, url) {
+    const timeoutMs = input.timeoutMs ?? 8_000;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 100 || timeoutMs > 120_000)
+        throw new Error("timeoutMs must be an integer from 100 to 120000.");
+    const body = JSON.stringify(input.event);
+    const timestamp = String(Math.floor(Date.now() / 1000));
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                accept: "application/json",
+                "idempotency-key": input.event.id,
+                "x-seedhape-event": input.event.type,
+                "x-seedhape-timestamp": timestamp,
+                "x-seedhape-signature": signWebhook(input.secret, timestamp, body),
+            },
+            body,
+            signal: controller.signal,
+            redirect: "error",
+        });
+        const responseBody = await response.json().catch(() => null);
+        if (!response.ok)
+            throw new Error(`Fulfillment webhook rejected the event (${response.status}).`);
+        return { status: response.status, body: responseBody };
+    }
+    catch (error) {
+        if (error instanceof DOMException && error.name === "AbortError")
+            throw new Error("Fulfillment webhook timed out.");
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Send a signed, idempotent fulfillment event to a merchant-owned system. */
+export async function sendFulfillmentWebhook(input) {
+    return sendFulfillmentWebhookAtUrl(input, await validateOutboundUrl(input.url, { requireHttps: true }));
+}
+/** Retry a fulfillment event without changing its idempotency key or signature payload. */
+export async function sendFulfillmentWebhookWithRetry(input, retry = {}) {
+    const attempts = retry.attempts ?? 3;
+    const baseDelayMs = retry.baseDelayMs ?? 250;
+    const maxDelayMs = retry.maxDelayMs ?? 5_000;
+    if (!Number.isSafeInteger(attempts) || attempts < 1 || attempts > 10)
+        throw new Error("attempts must be an integer from 1 to 10.");
+    if (!Number.isSafeInteger(baseDelayMs) || baseDelayMs < 0 || baseDelayMs > 60_000)
+        throw new Error("baseDelayMs must be an integer from 0 to 60000.");
+    if (!Number.isSafeInteger(maxDelayMs) || maxDelayMs < baseDelayMs || maxDelayMs > 300_000)
+        throw new Error("maxDelayMs must be at least baseDelayMs and no more than 300000.");
+    const wait = retry.wait ?? ((milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds)));
+    let lastError;
+    const url = await validateOutboundUrl(input.url, { requireHttps: true });
+    for (let attempt = 0; attempt < attempts; attempt += 1) {
+        try {
+            return await sendFulfillmentWebhookAtUrl(input, url);
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt === attempts - 1)
+                break;
+            await wait(Math.min(maxDelayMs, baseDelayMs * 2 ** attempt));
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error("Fulfillment webhook failed after retries.");
+}
+//# sourceMappingURL=fulfillment.js.map

package/dist/fulfillment.js.map

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

package/dist/index.d.ts

@@ -3,7 +3,10 @@ export * from "./mcp.js";
 export * from "./ap2.js";
 export * from "./browser-paywall.js";
 export * from "./commerce.js";
+export * from "./protocol-catalog.js";
 export * from "./mpp.js";
 export * from "./stripe-mpp.js";
 export * from "./seller.js";
+export * from "./fulfillment.js";
+export * from "./proxy.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -3,7 +3,10 @@ export * from "./mcp.js";
 export * from "./ap2.js";
 export * from "./browser-paywall.js";
 export * from "./commerce.js";
+export * from "./protocol-catalog.js";
 export * from "./mpp.js";
 export * from "./stripe-mpp.js";
 export * from "./seller.js";
+export * from "./fulfillment.js";
+export * from "./proxy.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}

package/dist/middleware.d.ts

@@ -36,8 +36,8 @@ export interface Receipt {
     asset: string;
     network: string;
     txHash?: string;
-    /** INR paise at settlement time. */
-    inrPaise?: bigint;
+    /** fiat minorUnits at settlement time. */
+    fiatMinorUnits?: bigint;
     fxRateScaled?: bigint;
     settledAt: number;
     /** Your own order/customer reference, if the caller supplied one. */
@@ -131,7 +131,7 @@ export interface PaywallConfig {
     price: Money | PriceResolver;
     facilitator: FacilitatorConfig;
     receipts?: ReceiptSink;
-    /** INR per USDC scaled 1e8, for receipt valuation. */
+    /** fiat per USDC scaled 1e8, for receipt valuation. */
     fxRateScaled?: () => Promise<bigint>;
     description?: string;
     /** Bazaar/Sonar metadata. `description` remains supported as a shorthand. */