phygital-payment-sdk 0.1.0

package/dist/merchant/deferred-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-store.d.ts","sourceRoot":"","sources":["../../src/merchant/deferred-store.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAQ/D,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAG1C,eAAO,MAAM,eAAe,QAA+B,CAAC;AAG5D,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,oBAAoB,CAAC;IACtC,YAAY,EAAE,oBAAoB,CAAC;IACnC,cAAc,EAAE,UAAU,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IAEtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,EAAE,eAAe,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IACjD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IACnE,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAkBD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,cAAc,CAsBnE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAsBtE;AAGD,wBAAgB,2BAA2B,IAAI,kBAAkB,GAAG;IAClE,KAAK,IAAI,UAAU,EAAE,CAAC;IACtB,IAAI,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC,CAmEA"}

package/dist/merchant/deferred-store.js

@@ -0,0 +1,126 @@
+import { base64UrlToBytes, bytesToBase64Url, toUint8Array, } from "../core/bytes.js";
+export const MAX_SECP256R1_SIGNATURES = 8;
+export const MAX_TAPS_PER_TX = MAX_SECP256R1_SIGNATURES / 2;
+export const MAX_TRANSACTION_SIZE = 1232;
+function entryToWire(entry) {
+    return {
+        publicKey: bytesToBase64Url(toUint8Array(entry.publicKey)),
+        signature: bytesToBase64Url(toUint8Array(entry.signature)),
+        message: bytesToBase64Url(toUint8Array(entry.message)),
+    };
+}
+function entryFromWire(wire) {
+    return {
+        publicKey: base64UrlToBytes(wire.publicKey),
+        signature: base64UrlToBytes(wire.signature),
+        message: base64UrlToBytes(wire.message),
+    };
+}
+export function serializePendingTap(tap) {
+    return {
+        id: tap.id,
+        reference: tap.reference,
+        executeBy: tap.executeBy,
+        enqueuedAt: tap.enqueuedAt,
+        merchant: tap.merchant,
+        credentialEntry: entryToWire(tap.credentialEntry),
+        enablerEntry: entryToWire(tap.enablerEntry),
+        clientDataJson: bytesToBase64Url(tap.clientDataJson),
+        payer: tap.payer,
+        mint: tap.mint,
+        tokenProgram: tap.tokenProgram,
+        amount: tap.amount,
+        arbiter: tap.arbiter,
+        tapIssuedAt: tap.tapIssuedAt,
+        asset: tap.asset,
+        paymentAccount: tap.paymentAccount,
+        payment: tap.payment,
+        escrowTokenAccount: tap.escrowTokenAccount,
+        attempts: tap.attempts,
+    };
+}
+export function deserializePendingTap(wire) {
+    return {
+        id: wire.id,
+        reference: wire.reference,
+        executeBy: wire.executeBy,
+        enqueuedAt: wire.enqueuedAt,
+        merchant: wire.merchant,
+        credentialEntry: entryFromWire(wire.credentialEntry),
+        enablerEntry: entryFromWire(wire.enablerEntry),
+        clientDataJson: base64UrlToBytes(wire.clientDataJson),
+        payer: wire.payer,
+        mint: wire.mint,
+        tokenProgram: wire.tokenProgram,
+        amount: wire.amount,
+        arbiter: wire.arbiter,
+        tapIssuedAt: wire.tapIssuedAt,
+        asset: wire.asset,
+        paymentAccount: wire.paymentAccount,
+        payment: wire.payment,
+        escrowTokenAccount: wire.escrowTokenAccount,
+        attempts: wire.attempts,
+    };
+}
+export function createInMemoryDeferredStore() {
+    const rows = new Map();
+    const byReference = new Map();
+    const doneSigs = new Map();
+    let nextId = 1;
+    return {
+        async put(tap) {
+            const existingId = byReference.get(tap.reference);
+            if (existingId) {
+                const existing = rows.get(existingId);
+                if (existing?.status === "pending")
+                    return existingId;
+                const id = existingId;
+                rows.set(id, {
+                    ...tap,
+                    id,
+                    attempts: tap.attempts ?? 0,
+                    status: "pending",
+                });
+                return id;
+            }
+            const id = tap.id || `d_${nextId++}`;
+            rows.set(id, { ...tap, id, attempts: tap.attempts ?? 0, status: "pending" });
+            byReference.set(tap.reference, id);
+            return id;
+        },
+        async get(id) {
+            const row = rows.get(id);
+            return row?.status === "pending" ? { ...row } : undefined;
+        },
+        async getByReference(reference) {
+            const id = byReference.get(reference);
+            return id ? this.get(id) : undefined;
+        },
+        async listPending() {
+            return [...rows.values()]
+                .filter((row) => row.status === "pending")
+                .map((row) => ({ ...row }));
+        },
+        async markDone(id, signature) {
+            const row = rows.get(id);
+            if (row) {
+                row.status = "done";
+                row.signature = signature;
+                doneSigs.set(id, signature);
+            }
+        },
+        async markFailed(id, error) {
+            const row = rows.get(id);
+            if (row) {
+                row.attempts += 1;
+                row.error = error;
+                row.status = "failed";
+            }
+        },
+        items: () => [...rows.values()]
+            .filter((row) => row.status === "pending")
+            .map((row) => ({ ...row })),
+        done: () => doneSigs,
+    };
+}
+//# sourceMappingURL=deferred-store.js.map

package/dist/merchant/deferred-store.js.map

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

package/dist/merchant/indexed-db-store.d.ts

@@ -0,0 +1,6 @@
+import { type DeferredQueueStore } from "./deferred-store.js";
+export interface IndexedDbDeferredStoreConfig {
+    dbName?: string;
+}
+export declare function createIndexedDbDeferredStore(config?: IndexedDbDeferredStoreConfig): DeferredQueueStore;
+//# sourceMappingURL=indexed-db-store.d.ts.map

package/dist/merchant/indexed-db-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexed-db-store.d.ts","sourceRoot":"","sources":["../../src/merchant/indexed-db-store.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,kBAAkB,EAGxB,MAAM,qBAAqB,CAAC;AA0C7B,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,GAAE,4BAAiC,GACxC,kBAAkB,CAiGpB"}

package/dist/merchant/indexed-db-store.js

@@ -0,0 +1,121 @@
+import { ConfigurationError } from "../core/errors.js";
+import { deserializePendingTap, serializePendingTap, } from "./deferred-store.js";
+const DEFAULT_DB_NAME = "phygital-payment-deferred";
+const STORE_NAME = "pendingTaps";
+const DB_VERSION = 1;
+function requireIndexedDb() {
+    const idb = globalThis.indexedDB;
+    if (!idb) {
+        throw new ConfigurationError("IndexedDB is not available. Pass deferredStore to createMerchantClient (e.g. createInMemoryDeferredStore() in Node/tests).");
+    }
+    return idb;
+}
+function openDb(dbName) {
+    const idb = requireIndexedDb();
+    return new Promise((resolve, reject) => {
+        const request = idb.open(dbName, DB_VERSION);
+        request.onerror = () => reject(request.error ?? new Error("indexedDB open failed"));
+        request.onsuccess = () => resolve(request.result);
+        request.onupgradeneeded = () => {
+            const db = request.result;
+            if (!db.objectStoreNames.contains(STORE_NAME)) {
+                const store = db.createObjectStore(STORE_NAME, { keyPath: "id" });
+                store.createIndex("reference", "reference", { unique: true });
+                store.createIndex("status", "status", { unique: false });
+            }
+        };
+    });
+}
+function requestToPromise(request) {
+    return new Promise((resolve, reject) => {
+        request.onsuccess = () => resolve(request.result);
+        request.onerror = () => reject(request.error ?? new Error("indexedDB request failed"));
+    });
+}
+export function createIndexedDbDeferredStore(config = {}) {
+    const dbName = config.dbName ?? DEFAULT_DB_NAME;
+    let dbPromise = null;
+    const db = () => {
+        if (!dbPromise)
+            dbPromise = openDb(dbName);
+        return dbPromise;
+    };
+    async function withStore(mode, fn) {
+        const database = await db();
+        const tx = database.transaction(STORE_NAME, mode);
+        const store = tx.objectStore(STORE_NAME);
+        const result = await fn(store);
+        await new Promise((resolve, reject) => {
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error ?? new Error("indexedDB tx failed"));
+            tx.onabort = () => reject(tx.error ?? new Error("indexedDB tx aborted"));
+        });
+        return result;
+    }
+    return {
+        async put(tap) {
+            return withStore("readwrite", async (store) => {
+                const byRef = store.index("reference");
+                const existing = (await requestToPromise(byRef.get(tap.reference)));
+                if (existing?.status === "pending") {
+                    return existing.id;
+                }
+                const id = existing?.id ||
+                    tap.id ||
+                    (typeof crypto !== "undefined" && "randomUUID" in crypto
+                        ? `d_${crypto.randomUUID()}`
+                        : `d_${Date.now()}_${Math.random().toString(36).slice(2)}`);
+                const wire = serializePendingTap({ ...tap, id, attempts: tap.attempts ?? 0 });
+                const row = { ...wire, status: "pending" };
+                await requestToPromise(store.put(row));
+                return id;
+            });
+        },
+        async get(id) {
+            return withStore("readonly", async (store) => {
+                const row = (await requestToPromise(store.get(id)));
+                if (!row || row.status !== "pending")
+                    return undefined;
+                return deserializePendingTap(row);
+            });
+        },
+        async getByReference(reference) {
+            return withStore("readonly", async (store) => {
+                const row = (await requestToPromise(store.index("reference").get(reference)));
+                if (!row || row.status !== "pending")
+                    return undefined;
+                return deserializePendingTap(row);
+            });
+        },
+        async listPending() {
+            return withStore("readonly", async (store) => {
+                const all = (await requestToPromise(store.getAll()));
+                return all
+                    .filter((row) => row.status === "pending")
+                    .map((row) => deserializePendingTap(row));
+            });
+        },
+        async markDone(id, signature) {
+            await withStore("readwrite", async (store) => {
+                const row = (await requestToPromise(store.get(id)));
+                if (!row)
+                    return;
+                row.status = "done";
+                row.signature = signature;
+                await requestToPromise(store.put(row));
+            });
+        },
+        async markFailed(id, error) {
+            await withStore("readwrite", async (store) => {
+                const row = (await requestToPromise(store.get(id)));
+                if (!row)
+                    return;
+                row.attempts = (row.attempts ?? 0) + 1;
+                row.error = error;
+                row.status = "failed";
+                await requestToPromise(store.put(row));
+            });
+        },
+    };
+}
+//# sourceMappingURL=indexed-db-store.js.map

package/dist/merchant/indexed-db-store.js.map

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

package/dist/merchant/tap.d.ts

@@ -0,0 +1,11 @@
+import { type AuthenticationResponseJSON } from "@simplewebauthn/browser";
+import { type TapChallengeFields } from "../core/challenge.js";
+export interface TapReadResult {
+    response: AuthenticationResponseJSON;
+    challenge: Uint8Array;
+}
+export declare function readPaymentAccessoryCredential(fields: TapChallengeFields, options?: {
+    rpId?: string;
+    abortSignal?: AbortSignal;
+}): Promise<TapReadResult>;
+//# sourceMappingURL=tap.d.ts.map

package/dist/merchant/tap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap.d.ts","sourceRoot":"","sources":["../../src/merchant/tap.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,0BAA0B,EAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGlF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,0BAA0B,CAAC;IAErC,SAAS,EAAE,UAAU,CAAC;CACvB;AAUD,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,WAAW,CAAA;CAAO,GACzD,OAAO,CAAC,aAAa,CAAC,CA0DxB"}

package/dist/merchant/tap.js

@@ -0,0 +1,47 @@
+import { bufferToBase64URLString, startAuthentication, WebAuthnAbortService, } from "@simplewebauthn/browser";
+import { buildTapChallenge } from "../core/challenge.js";
+import { EnvironmentError, TapReadError } from "../core/errors.js";
+export async function readPaymentAccessoryCredential(fields, options = {}) {
+    if (typeof window === "undefined" || typeof navigator === "undefined") {
+        throw new EnvironmentError("readPaymentAccessoryCredential requires a browser with WebAuthn; run the tap flow in the terminal UI, not on a server.");
+    }
+    if (options.abortSignal?.aborted) {
+        throw new TapReadError("Tap was cancelled.", { aborted: true });
+    }
+    const challenge = buildTapChallenge(fields);
+    const onAbort = () => {
+        WebAuthnAbortService.cancelCeremony();
+    };
+    options.abortSignal?.addEventListener("abort", onAbort, { once: true });
+    let response;
+    try {
+        response = await startAuthentication({
+            optionsJSON: {
+                challenge: bufferToBase64URLString(new Uint8Array(challenge).buffer),
+                rpId: options.rpId ?? window.location.hostname,
+                userVerification: "preferred",
+                allowCredentials: [
+                    {
+                        id: bufferToBase64URLString(crypto.getRandomValues(new Uint8Array(64)).buffer),
+                        type: "public-key",
+                        transports: ["nfc"],
+                    },
+                ],
+            },
+        });
+    }
+    catch (cause) {
+        const aborted = options.abortSignal?.aborted === true ||
+            (cause instanceof DOMException && cause.name === "AbortError") ||
+            (cause instanceof Error && cause.name === "AbortError");
+        throw new TapReadError(aborted ? "Tap was cancelled." : "Failed to read the payment accessory.", { aborted, cause });
+    }
+    finally {
+        options.abortSignal?.removeEventListener("abort", onAbort);
+    }
+    if (options.abortSignal?.aborted) {
+        throw new TapReadError("Tap was cancelled.", { aborted: true });
+    }
+    return { response, challenge };
+}
+//# sourceMappingURL=tap.js.map

package/dist/merchant/tap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap.js","sourceRoot":"","sources":["../../src/merchant/tap.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,GAErB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAA2B,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAgBnE,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,MAA0B,EAC1B,UAAwD,EAAE;IAE1D,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;QACtE,MAAM,IAAI,gBAAgB,CACxB,wHAAwH,CACzH,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,oBAAoB,CAAC,cAAc,EAAE,CAAC;IACxC,CAAC,CAAC;IACF,OAAO,CAAC,WAAW,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAExE,IAAI,QAAoC,CAAC;IACzC,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,mBAAmB,CAAC;YACnC,WAAW,EAAE;gBACX,SAAS,EAAE,uBAAuB,CAChC,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC,MAAqB,CAChD;gBACD,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ;gBAC9C,gBAAgB,EAAE,WAAW;gBAC7B,gBAAgB,EAAE;oBAChB;wBAGE,EAAE,EAAE,uBAAuB,CACzB,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,MAAqB,CACjE;wBACD,IAAI,EAAE,YAAY;wBAClB,UAAU,EAAE,CAAC,KAAK,CAAC;qBACpB;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GACX,OAAO,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI;YACrC,CAAC,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;YAC9D,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;QAC1D,MAAM,IAAI,YAAY,CACpB,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,uCAAuC,EACxE,EAAE,OAAO,EAAE,KAAK,EAAE,CACnB,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,WAAW,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC"}

package/dist/server/closable-store.d.ts

@@ -0,0 +1,12 @@
+import type { Address } from "@solana/kit";
+export interface ClosablePayment {
+    payment: Address;
+    merchant: Address;
+}
+export interface ClosablePaymentStore {
+    add(entry: ClosablePayment): Promise<void> | void;
+    list(limit?: number): Promise<ClosablePayment[]> | ClosablePayment[];
+    remove(payment: Address): Promise<void> | void;
+}
+export declare function createInMemoryClosableStore(): ClosablePaymentStore;
+//# sourceMappingURL=closable-store.d.ts.map

package/dist/server/closable-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closable-store.d.ts","sourceRoot":"","sources":["../../src/server/closable-store.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,eAAe;IAE9B,OAAO,EAAE,OAAO,CAAC;IAEjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IAEnC,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAElD,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC;IAErE,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChD;AAGD,wBAAgB,2BAA2B,IAAI,oBAAoB,CAclE"}

package/dist/server/closable-store.js

@@ -0,0 +1,16 @@
+export function createInMemoryClosableStore() {
+    const rows = new Map();
+    return {
+        add(entry) {
+            rows.set(entry.payment, entry);
+        },
+        list(limit) {
+            const all = [...rows.values()];
+            return limit === undefined ? all : all.slice(0, limit);
+        },
+        remove(payment) {
+            rows.delete(payment);
+        },
+    };
+}
+//# sourceMappingURL=closable-store.js.map

package/dist/server/closable-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closable-store.js","sourceRoot":"","sources":["../../src/server/closable-store.ts"],"names":[],"mappings":"AA8BA,MAAM,UAAU,2BAA2B;IACzC,MAAM,IAAI,GAAG,IAAI,GAAG,EAA4B,CAAC;IACjD,OAAO;QACL,GAAG,CAAC,KAAK;YACP,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,KAAK;YACR,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/B,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,CAAC,OAAO;YACZ,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/deferred-flusher.d.ts

@@ -0,0 +1,19 @@
+import type { Address, RpcSubscriptions, Signature, SolanaRpcSubscriptionsApi, TransactionSigner } from "@solana/kit";
+import type { SdkRpc } from "../core/payment.js";
+import type { PendingTapStore } from "./pending-taps.js";
+export interface DeferredBackupFlusherConfig {
+    rpc: SdkRpc;
+    rpcSubscriptions: RpcSubscriptions<SolanaRpcSubscriptionsApi>;
+    store: PendingTapStore;
+    feePayer: TransactionSigner;
+    merchant?: Address;
+    maxTapsPerTx?: number;
+    pollIntervalMs?: number;
+}
+export interface DeferredBackupFlusher {
+    tick(): Promise<Signature[]>;
+    start(): void;
+    stop(): void;
+}
+export declare function createDeferredBackupFlusher(config: DeferredBackupFlusherConfig): DeferredBackupFlusher;
+//# sourceMappingURL=deferred-flusher.d.ts.map

package/dist/server/deferred-flusher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-flusher.d.ts","sourceRoot":"","sources":["../../src/server/deferred-flusher.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAYjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,gBAAgB,CAAC,yBAAyB,CAAC,CAAC;IAC9D,KAAK,EAAE,eAAe,CAAC;IAEvB,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,2BAA2B,GAClC,qBAAqB,CAuDvB"}

package/dist/server/deferred-flusher.js

@@ -0,0 +1,57 @@
+import { nowSeconds } from "../core/time.js";
+import { createTransactionRuntime } from "../core/transactions.js";
+import { packTapsForBatch, rebuildBatchInstructions, } from "../merchant/deferred-queue.js";
+import { deserializePendingTap, MAX_TAPS_PER_TX, } from "../merchant/deferred-store.js";
+export function createDeferredBackupFlusher(config) {
+    const runtime = createTransactionRuntime(config);
+    const maxTaps = Math.min(config.maxTapsPerTx ?? MAX_TAPS_PER_TX, MAX_TAPS_PER_TX);
+    let timer = null;
+    async function loadLive() {
+        const now = nowSeconds();
+        const wires = config.merchant
+            ? await config.store.listByMerchant(config.merchant)
+            : await config.store.listAll();
+        const live = [];
+        for (const wire of wires) {
+            if (wire.executeBy <= now) {
+                await config.store.acknowledge(wire.reference);
+                continue;
+            }
+            live.push(deserializePendingTap(wire));
+        }
+        return live.sort((a, b) => a.executeBy - b.executeBy);
+    }
+    async function tick() {
+        const signatures = [];
+        for (;;) {
+            const live = await loadLive();
+            if (live.length === 0)
+                break;
+            const batch = await packTapsForBatch(live, config.feePayer, maxTaps);
+            if (batch.length === 0)
+                break;
+            const instructions = await rebuildBatchInstructions(batch, config.feePayer);
+            const signature = await runtime.sendAndConfirm(config.feePayer, instructions);
+            signatures.push(signature);
+            for (const tap of batch) {
+                await config.store.acknowledge(tap.reference);
+            }
+        }
+        return signatures;
+    }
+    return {
+        tick,
+        start() {
+            if (timer)
+                return;
+            timer = setInterval(() => void tick().catch(() => { }), config.pollIntervalMs ?? 60_000);
+        },
+        stop() {
+            if (timer) {
+                clearInterval(timer);
+                timer = null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=deferred-flusher.js.map

package/dist/server/deferred-flusher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-flusher.js","sourceRoot":"","sources":["../../src/server/deferred-flusher.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,qBAAqB,EACrB,eAAe,GAEhB,MAAM,+BAA+B,CAAC;AAsBvC,MAAM,UAAU,2BAA2B,CACzC,MAAmC;IAEnC,MAAM,OAAO,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,eAAe,EAAE,eAAe,CAAC,CAAC;IAClF,IAAI,KAAK,GAA0C,IAAI,CAAC;IAExD,KAAK,UAAU,QAAQ;QACrB,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ;YAC3B,CAAC,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC;YACpD,CAAC,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAEjC,MAAM,IAAI,GAAiB,EAAE,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;gBAC1B,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC/C,SAAS;YACX,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,UAAU,IAAI;QACjB,MAAM,UAAU,GAAgB,EAAE,CAAC;QACnC,SAAS,CAAC;YACR,MAAM,IAAI,GAAG,MAAM,QAAQ,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM;YAC7B,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM;YAC9B,MAAM,YAAY,GAAG,MAAM,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5E,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAC9E,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3B,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;gBACxB,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO;QACL,IAAI;QACJ,KAAK;YACH,IAAI,KAAK;gBAAE,OAAO;YAClB,KAAK,GAAG,WAAW,CACjB,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,EACjC,MAAM,CAAC,cAAc,IAAI,MAAM,CAChC,CAAC;QACJ,CAAC;QACD,IAAI;YACF,IAAI,KAAK,EAAE,CAAC;gBACV,aAAa,CAAC,KAAK,CAAC,CAAC;gBACrB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/enabler-service.d.ts

@@ -0,0 +1,20 @@
+import { type SdkRpc } from "../core/payment.js";
+import type { EnablerSignatureRequest, EnablerSignatureResponse } from "../core/provider-transport.js";
+import { type EnablerSigner } from "./enabler-signer.js";
+import type { EnablerPolicy, ExposureStore, ReplayStore } from "./policy.js";
+export interface EnablerServiceConfig {
+    rpc: SdkRpc;
+    signer: EnablerSigner;
+    policy?: EnablerPolicy;
+    replayStore: ReplayStore;
+    exposureStore: ExposureStore;
+    expectedOrigins: string | readonly string[];
+    expectedRPID: string | readonly string[];
+}
+export interface EnablerService {
+    validateAndSign(request: EnablerSignatureRequest): Promise<EnablerSignatureResponse>;
+    publicKey: Uint8Array;
+}
+export declare function tapFingerprint(request: EnablerSignatureRequest): Promise<string>;
+export declare function createEnablerService(config: EnablerServiceConfig): EnablerService;
+//# sourceMappingURL=enabler-service.d.ts.map

package/dist/server/enabler-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enabler-service.d.ts","sourceRoot":"","sources":["../../src/server/enabler-service.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAyE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACxH,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EACV,aAAa,EAEb,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC;IAKvB,WAAW,EAAE,WAAW,CAAC;IAMzB,aAAa,EAAE,aAAa,CAAC;IAK7B,eAAe,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAK5C,YAAY,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAE7B,eAAe,CACb,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAErC,SAAS,EAAE,UAAU,CAAC;CACvB;AAGD,wBAAsB,cAAc,CAClC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,GAC3B,cAAc,CAiOhB"}