phygital-payment-sdk 0.1.0

package/dist/merchant/client.js

@@ -0,0 +1,282 @@
+import { getCreateAssociatedTokenIdempotentInstructionAsync, TOKEN_PROGRAM_ADDRESS, } from "@solana-program/token";
+import { getAddMerchantOperatorInstructionAsync } from "../generated/instructions/addMerchantOperator.js";
+import { getMerchantRefundInstruction } from "../generated/instructions/merchantRefund.js";
+import { getMerchantRespondInstruction } from "../generated/instructions/merchantRespond.js";
+import { getRefundSettledInstruction } from "../generated/instructions/refundSettled.js";
+import { getRemoveMerchantOperatorInstructionAsync } from "../generated/instructions/removeMerchantOperator.js";
+import { ConfigurationError, InvalidAmountError } from "../core/errors.js";
+import { collectEventsForAddress, eventParticipants, subscribeToPaymentEvents, } from "../core/events.js";
+import { fetchPaymentSummary, } from "../core/payment.js";
+import { deriveAssociatedTokenAddress, deriveMerchantOperatorAddress, derivePaymentAccountAddress, derivePaymentAddressFromSeeds, } from "../core/pda.js";
+import { createProviderFeePayerSigner } from "../core/provider-fee-payer.js";
+import { createProviderTransport, } from "../core/provider-transport.js";
+import { PaymentStatus } from "../core/status.js";
+import { createTransactionRuntime } from "../core/transactions.js";
+import { charge as runCharge, resumeCharge as runResumeCharge, } from "./charge.js";
+import { createDeferredQueue, DEFAULT_FLUSH_INTERVAL_MS } from "./deferred-queue.js";
+import { createInMemoryDeferredStore, } from "./deferred-store.js";
+import { createIndexedDbDeferredStore } from "./indexed-db-store.js";
+export function createMerchantClient(config) {
+    const tokenProgram = config.tokenProgram ?? TOKEN_PROGRAM_ADDRESS;
+    const runtime = createTransactionRuntime(config);
+    const provider = "getEnablerSignature" in config.provider
+        ? config.provider
+        : createProviderTransport(config.provider);
+    const deferredStore = config.deferredStore ??
+        (typeof globalThis.indexedDB !== "undefined"
+            ? createIndexedDbDeferredStore()
+            : createInMemoryDeferredStore());
+    let chargePayerPromise = null;
+    function getChargePayer() {
+        if (config.feePayer)
+            return Promise.resolve(config.feePayer);
+        if (!chargePayerPromise) {
+            chargePayerPromise = createProviderFeePayerSigner(provider);
+        }
+        return chargePayerPromise;
+    }
+    let deferredQueuePromise = null;
+    async function getDeferredQueue() {
+        if (!deferredQueuePromise) {
+            deferredQueuePromise = getChargePayer().then((feePayer) => createDeferredQueue({
+                rpc: config.rpc,
+                store: deferredStore,
+                runtime,
+                feePayer,
+                provider,
+                merchant: config.merchant,
+            }));
+        }
+        return deferredQueuePromise;
+    }
+    async function restoreAndFlush() {
+        const queue = await getDeferredQueue();
+        try {
+            await queue.reconcileWithProviderAndChain();
+        }
+        catch {
+        }
+        try {
+            await queue.flush();
+        }
+        catch {
+        }
+    }
+    const autoFlush = config.autoFlush !== false;
+    let flushTimer = null;
+    if (autoFlush) {
+        void restoreAndFlush();
+        flushTimer = setInterval(() => {
+            void restoreAndFlush();
+        }, config.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS);
+        if (typeof flushTimer === "object" && flushTimer && "unref" in flushTimer) {
+            flushTimer.unref?.();
+        }
+        if (typeof globalThis.addEventListener === "function") {
+            globalThis.addEventListener("online", () => void restoreAndFlush());
+            globalThis.addEventListener("visibilitychange", () => {
+                if (typeof document !== "undefined" &&
+                    document.visibilityState === "visible") {
+                    void restoreAndFlush();
+                }
+            });
+        }
+    }
+    function requireTreasury(override, context = "this merchant operation") {
+        const signer = override ?? config.treasurySigner;
+        if (!signer) {
+            throw new ConfigurationError(`treasurySigner is required for ${context}. Pass it to createMerchantClient (charge uses the provider fee payer and does not need it).`);
+        }
+        return signer;
+    }
+    async function merchantAuthority() {
+        const feePayer = requireTreasury(undefined, "refund/respond");
+        if (config.operator) {
+            return {
+                authority: config.operator,
+                feePayer,
+                merchantOperator: await deriveMerchantOperatorAddress({
+                    treasury: config.merchant,
+                    operator: config.operator.address,
+                }),
+            };
+        }
+        return { authority: feePayer, feePayer, merchantOperator: undefined };
+    }
+    async function fetchPaymentOrThrow(payment) {
+        const summary = await fetchPaymentSummary(config.rpc, payment);
+        if (summary === null) {
+            throw new ConfigurationError(`Payment ${payment} does not exist on-chain. It may have already settled or been refunded (both close the account) — check getReceipt/recentPayments instead of retrying.`);
+        }
+        return summary;
+    }
+    return {
+        async charge(params) {
+            const feePayer = await getChargePayer();
+            const deferredQueue = await getDeferredQueue();
+            return runCharge({
+                rpc: config.rpc,
+                runtime,
+                provider,
+                merchant: config.merchant,
+                feePayer,
+                tokenProgram,
+                deferredQueue,
+                rpId: config.rpId,
+                allowDeferral: config.allowDeferral,
+            }, params);
+        },
+        async resumeCharge(cosigned, params = {}) {
+            const feePayer = await getChargePayer();
+            const deferredQueue = await getDeferredQueue();
+            return runResumeCharge({
+                rpc: config.rpc,
+                runtime,
+                provider,
+                merchant: config.merchant,
+                feePayer,
+                tokenProgram,
+                deferredQueue,
+                rpId: config.rpId,
+                allowDeferral: config.allowDeferral,
+            }, cosigned, params);
+        },
+        async flushDeferred() {
+            const queue = await getDeferredQueue();
+            await queue.reconcileWithProviderAndChain().catch(() => ({
+                landed: 0,
+                restored: 0,
+            }));
+            return queue.flush();
+        },
+        async reconcileDeferred() {
+            return (await getDeferredQueue()).reconcileWithProviderAndChain();
+        },
+        async restoreDeferredFromProvider() {
+            return (await getDeferredQueue()).restoreFromProvider();
+        },
+        async refund({ payment, amount }) {
+            const summary = await fetchPaymentOrThrow(payment);
+            const refunded = amount ?? summary.amount;
+            if (refunded <= 0n || refunded > summary.amount) {
+                throw new InvalidAmountError(`Refund amount ${refunded} must be within (0, ${summary.amount}].`);
+            }
+            if (summary.status === PaymentStatus.Disputed &&
+                refunded !== summary.amount) {
+                throw new InvalidAmountError("A disputed payment can only be refunded in full (this concedes the dispute and returns the payer's bond). Omit `amount` to refund everything.");
+            }
+            const { authority, feePayer, merchantOperator } = await merchantAuthority();
+            const paymentAccount = await derivePaymentAccountAddress({
+                owner: summary.payer,
+                mint: summary.mint,
+                tokenProgram: summary.tokenProgram,
+            });
+            const instruction = getMerchantRefundInstruction({
+                authority,
+                paymentAccount,
+                payment,
+                merchantOperator,
+                refundAmount: refunded,
+            });
+            const signature = await runtime.sendAndConfirm(feePayer, [instruction]);
+            return { signature, refunded, remaining: summary.amount - refunded };
+        },
+        async respond({ payment, evidenceHash }) {
+            const summary = await fetchPaymentOrThrow(payment);
+            const { authority, feePayer, merchantOperator } = await merchantAuthority();
+            const paymentAccount = await derivePaymentAccountAddress({
+                owner: summary.payer,
+                mint: summary.mint,
+                tokenProgram: summary.tokenProgram,
+            });
+            const instruction = getMerchantRespondInstruction({
+                authority,
+                paymentAccount,
+                payment,
+                merchantOperator,
+                evidenceHash,
+            });
+            const signature = await runtime.sendAndConfirm(feePayer, [instruction]);
+            return { signature };
+        },
+        async refundSettled(params) {
+            const merchantSigner = requireTreasury(params.merchantSigner, "refundSettled");
+            const feePayer = requireTreasury(undefined, "refundSettled");
+            const [merchantTokenAccount, payerTokenAccount] = await Promise.all([
+                deriveAssociatedTokenAddress({
+                    owner: merchantSigner.address,
+                    mint: params.mint,
+                    tokenProgram,
+                }),
+                deriveAssociatedTokenAddress({
+                    owner: params.payer,
+                    mint: params.mint,
+                    tokenProgram,
+                }),
+            ]);
+            const instructions = [
+                await getCreateAssociatedTokenIdempotentInstructionAsync({
+                    payer: feePayer,
+                    owner: params.payer,
+                    mint: params.mint,
+                    tokenProgram,
+                }),
+                getRefundSettledInstruction({
+                    merchant: merchantSigner,
+                    merchantTokenAccount,
+                    payerTokenAccount,
+                    mint: params.mint,
+                    tokenProgram,
+                    amount: params.amount,
+                    originalPayment: params.originalPayment,
+                    reference: params.reference,
+                }),
+            ];
+            const signature = await runtime.sendAndConfirm(feePayer, instructions);
+            return { signature };
+        },
+        async addOperator(operator, options = {}) {
+            const treasury = requireTreasury(options.treasurySigner, "addOperator");
+            const instruction = await getAddMerchantOperatorInstructionAsync({
+                treasury,
+                operator,
+            });
+            const signature = await runtime.sendAndConfirm(treasury, [instruction]);
+            return { signature };
+        },
+        async removeOperator(operator, options = {}) {
+            const treasury = requireTreasury(options.treasurySigner, "removeOperator");
+            const instruction = await getRemoveMerchantOperatorInstructionAsync({
+                treasury,
+                operator,
+            });
+            const signature = await runtime.sendAndConfirm(treasury, [instruction]);
+            return { signature };
+        },
+        async getPayment(paymentOrSeeds) {
+            const address = typeof paymentOrSeeds === "string"
+                ? paymentOrSeeds
+                : await derivePaymentAddressFromSeeds({
+                    owner: paymentOrSeeds.payer,
+                    mint: paymentOrSeeds.mint,
+                    reference: paymentOrSeeds.reference,
+                    tokenProgram,
+                });
+            return fetchPaymentSummary(config.rpc, address);
+        },
+        recentPayments(options = {}) {
+            return collectEventsForAddress(config.rpc, config.merchant, options);
+        },
+        onPayment(callback, options = {}) {
+            if (!config.rpcSubscriptions) {
+                throw new ConfigurationError("rpcSubscriptions is required for onPayment; pass it to createMerchantClient.");
+            }
+            return subscribeToPaymentEvents(config.rpcSubscriptions, (event) => {
+                if (eventParticipants(event.event).includes(config.merchant)) {
+                    callback(event);
+                }
+            }, { onError: options.onError });
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/merchant/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/merchant/client.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,kDAAkD,EAClD,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAW/B,OAAO,EAAE,sCAAsC,EAAE,MAAM,kDAAkD,CAAC;AAC1G,OAAO,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAC3F,OAAO,EAAE,6BAA6B,EAAE,MAAM,8CAA8C,CAAC;AAC7F,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,yCAAyC,EAAE,MAAM,qDAAqD,CAAC;AAChH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,GAEzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,GAGpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EACL,uBAAuB,GAGxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EACL,MAAM,IAAI,SAAS,EACnB,YAAY,IAAI,eAAe,GAKhC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAsB,MAAM,qBAAqB,CAAC;AACzG,OAAO,EACL,2BAA2B,GAE5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AA8IrE,MAAM,UAAU,oBAAoB,CAClC,MAA4B;IAE5B,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,qBAAqB,CAAC;IAClE,MAAM,OAAO,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,QAAQ,GACZ,qBAAqB,IAAI,MAAM,CAAC,QAAQ;QACtC,CAAC,CAAC,MAAM,CAAC,QAAQ;QACjB,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE/C,MAAM,aAAa,GACjB,MAAM,CAAC,aAAa;QACpB,CAAC,OAAO,UAAU,CAAC,SAAS,KAAK,WAAW;YAC1C,CAAC,CAAC,4BAA4B,EAAE;YAChC,CAAC,CAAC,2BAA2B,EAAE,CAAC,CAAC;IAErC,IAAI,kBAAkB,GAAsC,IAAI,CAAC;IACjE,SAAS,cAAc;QACrB,IAAI,MAAM,CAAC,QAAQ;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxB,kBAAkB,GAAG,4BAA4B,CAAC,QAAQ,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,IAAI,oBAAoB,GAAkC,IAAI,CAAC;IAC/D,KAAK,UAAU,gBAAgB;QAC7B,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC1B,oBAAoB,GAAG,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CACxD,mBAAmB,CAAC;gBAClB,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,KAAK,EAAE,aAAa;gBACpB,OAAO;gBACP,QAAQ;gBACR,QAAQ;gBACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CACH,CAAC;QACJ,CAAC;QACD,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,KAAK,UAAU,eAAe;QAC5B,MAAM,KAAK,GAAG,MAAM,gBAAgB,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,6BAA6B,EAAE,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;QAET,CAAC;QACD,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;QAET,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC;IAC7C,IAAI,UAAU,GAA0C,IAAI,CAAC;IAC7D,IAAI,SAAS,EAAE,CAAC;QAEd,KAAK,eAAe,EAAE,CAAC;QAEvB,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,KAAK,eAAe,EAAE,CAAC;QACzB,CAAC,EAAE,MAAM,CAAC,eAAe,IAAI,yBAAyB,CAAC,CAAC;QACxD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;YACzE,UAA6B,CAAC,KAAK,EAAE,EAAE,CAAC;QAC3C,CAAC;QAED,IAAI,OAAO,UAAU,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;YACtD,UAAU,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,eAAe,EAAE,CAAC,CAAC;YACpE,UAAU,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,EAAE;gBACnD,IACE,OAAO,QAAQ,KAAK,WAAW;oBAC/B,QAAQ,CAAC,eAAe,KAAK,SAAS,EACtC,CAAC;oBACD,KAAK,eAAe,EAAE,CAAC;gBACzB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,SAAS,eAAe,CACtB,QAA4B,EAC5B,OAAO,GAAG,yBAAyB;QAEnC,MAAM,MAAM,GAAG,QAAQ,IAAI,MAAM,CAAC,cAAc,CAAC;QACjD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,kBAAkB,CAC1B,kCAAkC,OAAO,8FAA8F,CACxI,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAGD,KAAK,UAAU,iBAAiB;QAK9B,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO;gBACL,SAAS,EAAE,MAAM,CAAC,QAAQ;gBAC1B,QAAQ;gBACR,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;oBACpD,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;iBAClC,CAAC;aACH,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC;IACxE,CAAC;IAED,KAAK,UAAU,mBAAmB,CAAC,OAAgB;QACjD,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,kBAAkB,CAC1B,WAAW,OAAO,wJAAwJ,CAC3K,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,MAAM;YACjB,MAAM,QAAQ,GAAG,MAAM,cAAc,EAAE,CAAC;YACxC,MAAM,aAAa,GAAG,MAAM,gBAAgB,EAAE,CAAC;YAC/C,OAAO,SAAS,CACd;gBACE,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,OAAO;gBACP,QAAQ;gBACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ;gBACR,YAAY;gBACZ,aAAa;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,aAAa,EAAE,MAAM,CAAC,aAAa;aACpC,EACD,MAAM,CACP,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE;YACtC,MAAM,QAAQ,GAAG,MAAM,cAAc,EAAE,CAAC;YACxC,MAAM,aAAa,GAAG,MAAM,gBAAgB,EAAE,CAAC;YAC/C,OAAO,eAAe,CACpB;gBACE,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,OAAO;gBACP,QAAQ;gBACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ;gBACR,YAAY;gBACZ,aAAa;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,aAAa,EAAE,MAAM,CAAC,aAAa;aACpC,EACD,QAAQ,EACR,MAAM,CACP,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,aAAa;YACjB,MAAM,KAAK,GAAG,MAAM,gBAAgB,EAAE,CAAC;YACvC,MAAM,KAAK,CAAC,6BAA6B,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;gBACvD,MAAM,EAAE,CAAC;gBACT,QAAQ,EAAE,CAAC;aACZ,CAAC,CAAC,CAAC;YACJ,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAED,KAAK,CAAC,iBAAiB;YACrB,OAAO,CAAC,MAAM,gBAAgB,EAAE,CAAC,CAAC,6BAA6B,EAAE,CAAC;QACpE,CAAC;QAED,KAAK,CAAC,2BAA2B;YAC/B,OAAO,CAAC,MAAM,gBAAgB,EAAE,CAAC,CAAC,mBAAmB,EAAE,CAAC;QAC1D,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE;YAC9B,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;YAE1C,IAAI,QAAQ,IAAI,EAAE,IAAI,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBAChD,MAAM,IAAI,kBAAkB,CAC1B,iBAAiB,QAAQ,uBAAuB,OAAO,CAAC,MAAM,IAAI,CACnE,CAAC;YACJ,CAAC;YACD,IACE,OAAO,CAAC,MAAM,KAAK,aAAa,CAAC,QAAQ;gBACzC,QAAQ,KAAK,OAAO,CAAC,MAAM,EAC3B,CAAC;gBACD,MAAM,IAAI,kBAAkB,CAC1B,+IAA+I,CAChJ,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;YAC5E,MAAM,cAAc,GAAG,MAAM,2BAA2B,CAAC;gBACvD,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC,CAAC;YACH,MAAM,WAAW,GAAG,4BAA4B,CAAC;gBAC/C,SAAS;gBACT,cAAc;gBACd,OAAO;gBACP,gBAAgB;gBAChB,YAAY,EAAE,QAAQ;aACvB,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;YACxE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QACvE,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE;YACrC,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACnD,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;YAC5E,MAAM,cAAc,GAAG,MAAM,2BAA2B,CAAC;gBACvD,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC,CAAC;YACH,MAAM,WAAW,GAAG,6BAA6B,CAAC;gBAChD,SAAS;gBACT,cAAc;gBACd,OAAO;gBACP,gBAAgB;gBAChB,YAAY;aACb,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;YACxE,OAAO,EAAE,SAAS,EAAE,CAAC;QACvB,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,MAAM;YACxB,MAAM,cAAc,GAAG,eAAe,CACpC,MAAM,CAAC,cAAc,EACrB,eAAe,CAChB,CAAC;YACF,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;YAC7D,MAAM,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAClE,4BAA4B,CAAC;oBAC3B,KAAK,EAAE,cAAc,CAAC,OAAO;oBAC7B,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,YAAY;iBACb,CAAC;gBACF,4BAA4B,CAAC;oBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,YAAY;iBACb,CAAC;aACH,CAAC,CAAC;YACH,MAAM,YAAY,GAAkB;gBAElC,MAAM,kDAAkD,CAAC;oBACvD,KAAK,EAAE,QAAQ;oBACf,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,YAAY;iBACb,CAAC;gBACF,2BAA2B,CAAC;oBAC1B,QAAQ,EAAE,cAAc;oBACxB,oBAAoB;oBACpB,iBAAiB;oBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,YAAY;oBACZ,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,eAAe,EAAE,MAAM,CAAC,eAAe;oBACvC,SAAS,EAAE,MAAM,CAAC,SAAS;iBAC5B,CAAC;aACH,CAAC;YACF,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YACvE,OAAO,EAAE,SAAS,EAAE,CAAC;QACvB,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,EAAE;YACtC,MAAM,QAAQ,GAAG,eAAe,CAC9B,OAAO,CAAC,cAAc,EACtB,aAAa,CACd,CAAC;YACF,MAAM,WAAW,GAAG,MAAM,sCAAsC,CAAC;gBAC/D,QAAQ;gBACR,QAAQ;aACT,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;YACxE,OAAO,EAAE,SAAS,EAAE,CAAC;QACvB,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,EAAE;YACzC,MAAM,QAAQ,GAAG,eAAe,CAC9B,OAAO,CAAC,cAAc,EACtB,gBAAgB,CACjB,CAAC;YACF,MAAM,WAAW,GAAG,MAAM,yCAAyC,CAAC;gBAClE,QAAQ;gBACR,QAAQ;aACT,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;YACxE,OAAO,EAAE,SAAS,EAAE,CAAC;QACvB,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,cAAc;YAC7B,MAAM,OAAO,GACX,OAAO,cAAc,KAAK,QAAQ;gBAChC,CAAC,CAAC,cAAc;gBAChB,CAAC,CAAC,MAAM,6BAA6B,CAAC;oBAClC,KAAK,EAAE,cAAc,CAAC,KAAK;oBAC3B,IAAI,EAAE,cAAc,CAAC,IAAI;oBACzB,SAAS,EAAE,cAAc,CAAC,SAAS;oBACnC,YAAY;iBACb,CAAC,CAAC;YACT,OAAO,mBAAmB,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QAED,cAAc,CAAC,OAAO,GAAG,EAAE;YACzB,OAAO,uBAAuB,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACvE,CAAC;QAED,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,EAAE;YAC9B,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBAC7B,MAAM,IAAI,kBAAkB,CAC1B,8EAA8E,CAC/E,CAAC;YACJ,CAAC;YACD,OAAO,wBAAwB,CAC7B,MAAM,CAAC,gBAAgB,EACvB,CAAC,KAAK,EAAE,EAAE;gBACR,IAAI,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC7D,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC,EACD,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAC7B,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/merchant/deferred-queue.d.ts

@@ -0,0 +1,35 @@
+import { type Address, type Instruction, type Signature, type TransactionSigner } from "@solana/kit";
+import type { SdkRpc } from "../core/payment.js";
+import type { ProviderTransport } from "../core/provider-transport.js";
+import type { TransactionRuntime } from "../core/transactions.js";
+import { type DeferredQueueStore, type PendingTap, type PendingTapWire } from "./deferred-store.js";
+export type EnqueuePendingTapInput = Omit<PendingTap, "id" | "attempts"> & {
+    id?: string;
+    attempts?: number;
+};
+export interface DeferredQueueConfig {
+    rpc: SdkRpc;
+    store: DeferredQueueStore;
+    runtime: TransactionRuntime;
+    feePayer: TransactionSigner;
+    provider: ProviderTransport;
+    merchant: Address;
+    maxTapsPerTx?: number;
+}
+export interface DeferredQueue {
+    enqueue(tap: EnqueuePendingTapInput): Promise<string>;
+    flush(): Promise<Signature[]>;
+    flushOneBatch(): Promise<Signature | null>;
+    reconcileWithProviderAndChain(): Promise<{
+        landed: number;
+        restored: number;
+    }>;
+    restoreFromProvider(): Promise<number>;
+}
+export declare const DEFAULT_FLUSH_INTERVAL_MS: number;
+export declare function rebuildBatchInstructions(taps: readonly PendingTap[], feePayer: TransactionSigner): Promise<Instruction[]>;
+export declare function estimateTransactionSize(feePayer: TransactionSigner, instructions: Instruction[]): number;
+export declare function packTapsForBatch(taps: readonly PendingTap[], feePayer: TransactionSigner, maxTaps?: number): Promise<PendingTap[]>;
+export declare function createDeferredQueue(config: DeferredQueueConfig): DeferredQueue;
+export type { PendingTapWire };
+//# sourceMappingURL=deferred-queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-queue.d.ts","sourceRoot":"","sources":["../../src/merchant/deferred-queue.ts"],"names":[],"mappings":"AAaA,OAAO,EASL,KAAK,OAAO,EAEZ,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AASrB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,UAAU,CAAC,GAAG;IACzE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAElB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtD,KAAK,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAE9B,aAAa,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAK3C,6BAA6B,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE/E,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAGD,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAGxD,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC,CAsCxB;AAGD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,iBAAiB,EAC3B,YAAY,EAAE,WAAW,EAAE,GAC1B,MAAM,CAsBR;AAMD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,MAAwB,GAChC,OAAO,CAAC,UAAU,EAAE,CAAC,CAcvB;AAiBD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAyK9E;AAED,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/merchant/deferred-queue.js

@@ -0,0 +1,237 @@
+import { appendTransactionMessageInstructions, compileTransaction, createTransactionMessage, getBase58Decoder, getBase64EncodedWireTransaction, pipe, setTransactionMessageFeePayerSigner, setTransactionMessageLifetimeUsingBlockhash, } from "@solana/kit";
+import { getSecp256r1VerifyInstruction, } from "phygital-token-sdk";
+import { fetchMaybePayment } from "../generated/accounts/payment.js";
+import { getTransferInstructionAsync } from "../generated/instructions/transfer.js";
+import { base58ToBytes } from "../core/bytes.js";
+import { ProviderHttpError } from "../core/errors.js";
+import { nowSeconds } from "../core/time.js";
+import { deserializePendingTap, MAX_TAPS_PER_TX, MAX_TRANSACTION_SIZE, } from "./deferred-store.js";
+export const DEFAULT_FLUSH_INTERVAL_MS = 15 * 60 * 1000;
+export async function rebuildBatchInstructions(taps, feePayer) {
+    if (taps.length === 0) {
+        throw new Error("rebuildBatchInstructions requires at least one tap");
+    }
+    if (taps.length > MAX_TAPS_PER_TX) {
+        throw new Error(`at most ${MAX_TAPS_PER_TX} taps per batch`);
+    }
+    const entries = [];
+    for (const tap of taps) {
+        entries.push(tap.credentialEntry, tap.enablerEntry);
+    }
+    const preamble = getSecp256r1VerifyInstruction(entries);
+    const transfers = [];
+    for (let i = 0; i < taps.length; i++) {
+        const tap = taps[i];
+        transfers.push(await getTransferInstructionAsync({
+            rentPayer: feePayer,
+            merchant: tap.merchant,
+            asset: tap.asset,
+            mint: tap.mint,
+            paymentAccount: tap.paymentAccount,
+            payment: tap.payment,
+            escrowTokenAccount: tap.escrowTokenAccount,
+            credentialSignedMessageIndex: 2 * i,
+            enablerSignedMessageIndex: 2 * i + 1,
+            clientDataJson: tap.clientDataJson,
+            amount: BigInt(tap.amount),
+            tapIssuedAt: tap.tapIssuedAt,
+            reference: base58ToBytes(tap.reference),
+            tokenProgram: tap.tokenProgram,
+        }));
+    }
+    return [preamble, ...transfers];
+}
+export function estimateTransactionSize(feePayer, instructions) {
+    const transaction = pipe(createTransactionMessage({ version: 0 }), (m) => setTransactionMessageFeePayerSigner(feePayer, m), (m) => setTransactionMessageLifetimeUsingBlockhash({
+        blockhash: getBase58Decoder().decode(crypto.getRandomValues(new Uint8Array(32))),
+        lastValidBlockHeight: 0n,
+    }, m), (m) => appendTransactionMessageInstructions(instructions, m), (m) => compileTransaction(m));
+    const wire = getBase64EncodedWireTransaction(transaction);
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(wire, "base64").byteLength;
+    }
+    return atob(wire).length;
+}
+export async function packTapsForBatch(taps, feePayer, maxTaps = MAX_TAPS_PER_TX) {
+    const batch = [];
+    for (const tap of taps) {
+        if (batch.length >= maxTaps)
+            break;
+        const candidate = [...batch, tap];
+        const instructions = await rebuildBatchInstructions(candidate, feePayer);
+        const size = estimateTransactionSize(feePayer, instructions);
+        if (size > MAX_TRANSACTION_SIZE) {
+            if (batch.length === 0)
+                return [tap];
+            break;
+        }
+        batch.push(tap);
+    }
+    return batch;
+}
+function isLikelyTransient(error) {
+    if (error instanceof ProviderHttpError) {
+        return error.status === 0 || error.status === 408 || error.status === 429 || error.status >= 500;
+    }
+    if (error instanceof TypeError)
+        return true;
+    const message = error instanceof Error ? error.message.toLowerCase() : String(error);
+    return (message.includes("network") ||
+        message.includes("offline") ||
+        message.includes("fetch") ||
+        message.includes("timeout") ||
+        message.includes("aborted"));
+}
+export function createDeferredQueue(config) {
+    const maxTaps = Math.min(config.maxTapsPerTx ?? MAX_TAPS_PER_TX, MAX_TAPS_PER_TX);
+    async function markLandedElsewhere(tap) {
+        await config.store.markDone(tap.id, "reconciled-on-chain");
+        try {
+            await config.provider.acknowledgePendingTap({ reference: tap.reference });
+        }
+        catch (error) {
+            if (!(error instanceof ProviderHttpError))
+                throw error;
+        }
+    }
+    async function dropAlreadyOnChain(taps) {
+        const remaining = [];
+        for (const tap of taps) {
+            const onChain = await fetchMaybePayment(config.rpc, tap.payment);
+            if (onChain.exists) {
+                await markLandedElsewhere(tap);
+            }
+            else {
+                remaining.push(tap);
+            }
+        }
+        return remaining;
+    }
+    async function liveSorted() {
+        const now = nowSeconds();
+        const mine = (await config.store.listPending()).filter((tap) => tap.merchant === config.merchant);
+        const live = [];
+        for (const tap of mine) {
+            if (tap.executeBy <= now) {
+                const onChain = await fetchMaybePayment(config.rpc, tap.payment);
+                if (onChain.exists) {
+                    await markLandedElsewhere(tap);
+                }
+                else {
+                    await config.store.markFailed(tap.id, `executeBy ${tap.executeBy} passed at ${now}`);
+                }
+            }
+            else {
+                live.push(tap);
+            }
+        }
+        return live.sort((a, b) => a.executeBy - b.executeBy);
+    }
+    async function landBatch(batch) {
+        const instructions = await rebuildBatchInstructions(batch, config.feePayer);
+        const signature = await config.runtime.sendAndConfirm(config.feePayer, instructions);
+        for (const tap of batch) {
+            await config.store.markDone(tap.id, signature);
+            try {
+                await config.provider.acknowledgePendingTap({ reference: tap.reference });
+            }
+            catch (error) {
+                if (!(error instanceof ProviderHttpError))
+                    throw error;
+            }
+        }
+        return signature;
+    }
+    async function flushOneBatch() {
+        const live = await dropAlreadyOnChain(await liveSorted());
+        if (live.length === 0)
+            return null;
+        const batch = await packTapsForBatch(live, config.feePayer, maxTaps);
+        if (batch.length === 0)
+            return null;
+        const stillOpen = await dropAlreadyOnChain(batch);
+        if (stillOpen.length === 0)
+            return null;
+        if (stillOpen.length !== batch.length) {
+            return flushOneBatch();
+        }
+        try {
+            return await landBatch(stillOpen);
+        }
+        catch (error) {
+            await dropAlreadyOnChain(stillOpen);
+            if (isLikelyTransient(error))
+                return null;
+            throw error;
+        }
+    }
+    async function flush() {
+        const signatures = [];
+        for (;;) {
+            const before = (await dropAlreadyOnChain(await liveSorted())).length;
+            if (before === 0)
+                break;
+            const signature = await flushOneBatch();
+            if (!signature)
+                break;
+            signatures.push(signature);
+            const after = (await dropAlreadyOnChain(await liveSorted())).length;
+            if (after >= before)
+                break;
+        }
+        return signatures;
+    }
+    async function restoreFromProvider() {
+        const remote = await config.provider.listPendingTaps({
+            merchant: config.merchant,
+        });
+        let restored = 0;
+        for (const wire of remote) {
+            const existing = await config.store.getByReference(wire.reference);
+            if (existing)
+                continue;
+            const tap = deserializePendingTap(wire);
+            const onChain = await fetchMaybePayment(config.rpc, tap.payment);
+            if (onChain.exists) {
+                try {
+                    await config.provider.acknowledgePendingTap({ reference: tap.reference });
+                }
+                catch (error) {
+                    if (!(error instanceof ProviderHttpError))
+                        throw error;
+                }
+                continue;
+            }
+            await config.store.put({ ...tap, id: "", attempts: 0 });
+            restored += 1;
+        }
+        return restored;
+    }
+    async function reconcileWithProviderAndChain() {
+        const before = await config.store.listPending();
+        await dropAlreadyOnChain(before.filter((tap) => tap.merchant === config.merchant));
+        const afterDrop = await config.store.listPending();
+        const landed = before.length - afterDrop.length;
+        const restored = await restoreFromProvider();
+        return { landed, restored };
+    }
+    return {
+        async enqueue(tap) {
+            const id = await config.store.put({
+                ...tap,
+                id: tap.id ?? "",
+                attempts: tap.attempts ?? 0,
+            });
+            const live = await dropAlreadyOnChain(await liveSorted());
+            if (live.length >= maxTaps) {
+                await flushOneBatch();
+            }
+            return id;
+        },
+        flush,
+        flushOneBatch,
+        reconcileWithProviderAndChain,
+        restoreFromProvider,
+    };
+}
+//# sourceMappingURL=deferred-queue.js.map

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

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

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

@@ -0,0 +1,67 @@
+import type { Address } from "@solana/kit";
+import type { Secp256r1VerifyEntry } from "phygital-token-sdk";
+export declare const MAX_SECP256R1_SIGNATURES = 8;
+export declare const MAX_TAPS_PER_TX: number;
+export declare const MAX_TRANSACTION_SIZE = 1232;
+export interface PendingTap {
+    id: string;
+    reference: string;
+    executeBy: number;
+    enqueuedAt: number;
+    merchant: Address;
+    credentialEntry: Secp256r1VerifyEntry;
+    enablerEntry: Secp256r1VerifyEntry;
+    clientDataJson: Uint8Array;
+    payer: Address;
+    mint: Address;
+    tokenProgram: Address;
+    amount: string;
+    arbiter: Address;
+    tapIssuedAt: number;
+    asset: Address;
+    paymentAccount: Address;
+    payment: Address;
+    escrowTokenAccount: Address;
+    attempts: number;
+}
+export interface PendingTapWire {
+    id: string;
+    reference: string;
+    executeBy: number;
+    enqueuedAt: number;
+    merchant: Address;
+    credentialEntry: WireVerifyEntry;
+    enablerEntry: WireVerifyEntry;
+    clientDataJson: string;
+    payer: Address;
+    mint: Address;
+    tokenProgram: Address;
+    amount: string;
+    arbiter: Address;
+    tapIssuedAt: number;
+    asset: Address;
+    paymentAccount: Address;
+    payment: Address;
+    escrowTokenAccount: Address;
+    attempts: number;
+}
+export interface WireVerifyEntry {
+    publicKey: string;
+    signature: string;
+    message: string;
+}
+export interface DeferredQueueStore {
+    put(tap: PendingTap): Promise<string>;
+    get(id: string): Promise<PendingTap | undefined>;
+    getByReference(reference: string): Promise<PendingTap | undefined>;
+    listPending(): Promise<PendingTap[]>;
+    markDone(id: string, signature: string): Promise<void>;
+    markFailed(id: string, error: string): Promise<void>;
+}
+export declare function serializePendingTap(tap: PendingTap): PendingTapWire;
+export declare function deserializePendingTap(wire: PendingTapWire): PendingTap;
+export declare function createInMemoryDeferredStore(): DeferredQueueStore & {
+    items(): PendingTap[];
+    done(): ReadonlyMap<string, string>;
+};
+//# sourceMappingURL=deferred-store.d.ts.map