phygital-payment-sdk 0.1.0

package/dist/server/indexer.d.ts

@@ -0,0 +1,50 @@
+import type { Address, RpcSubscriptions, Signature, SolanaRpcSubscriptionsApi } from "@solana/kit";
+import { type EventWithContext, type PhygitalPaymentEvent } from "../core/events.js";
+import type { IndexerStore } from "../core/indexer-store.js";
+import { type PaymentSummary, type SdkRpc } from "../core/payment.js";
+import type { TransferReceipt } from "../core/provider-transport.js";
+import type { ClosablePaymentStore } from "./closable-store.js";
+import type { ExposureStore } from "./policy.js";
+export type { IndexedPayment, IndexerStore } from "../core/indexer-store.js";
+export type ReconcileInput = {
+    signature: Signature | string;
+    payment?: Address;
+} | {
+    payment: Address;
+    signature?: Signature | string;
+} | Pick<TransferReceipt, "txSig" | "sender" | "mint" | "reference" | "tokenProgram">;
+export declare function createInMemoryIndexerStore(): IndexerStore & {
+    size(): number;
+};
+export interface EventIndexerConfig {
+    rpc: SdkRpc;
+    rpcSubscriptions?: RpcSubscriptions<SolanaRpcSubscriptionsApi>;
+    store?: IndexerStore;
+    exposureStore?: ExposureStore;
+    closableStore?: ClosablePaymentStore;
+    programAddress?: Address;
+}
+export interface EventIndexer {
+    apply(event: EventWithContext): Promise<void>;
+    subscribe(callback?: (event: EventWithContext) => void, options?: {
+        onError?: (error: unknown) => void;
+    }): () => void;
+    backfill(options?: {
+        limit?: number;
+        before?: Signature;
+        until?: Signature;
+    }, callback?: (event: EventWithContext) => void): Promise<number>;
+    reconcilePayment(input: ReconcileInput): Promise<{
+        status: "confirmed";
+        payment: PaymentSummary;
+    } | {
+        status: "confirmed_closed";
+    } | {
+        status: "not_found";
+    }>;
+}
+export declare function applyEventToStore(store: IndexerStore, entry: EventWithContext): Promise<void>;
+export declare function createEventIndexer(config: EventIndexerConfig): EventIndexer;
+export declare function refreshIndexedPayment(rpc: SdkRpc, store: IndexerStore, address: Address): Promise<PaymentSummary | null>;
+export type { PhygitalPaymentEvent };
+//# sourceMappingURL=indexer.d.ts.map

package/dist/server/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../src/server/indexer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AAGrB,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7E,MAAM,MAAM,cAAc,GACtB;IAAE,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;CAAE,GACpD,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,cAAc,CAAC,CAAC;AAGtF,wBAAgB,0BAA0B,IAAI,YAAY,GAAG;IAC3D,IAAI,IAAI,MAAM,CAAC;CAChB,CAwCA;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,yBAAyB,CAAC,CAAC;IAE/D,KAAK,CAAC,EAAE,YAAY,CAAC;IAQrB,aAAa,CAAC,EAAE,aAAa,CAAC;IAM9B,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAE3B,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C,SAAS,CACP,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,EAC5C,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,GAC/C,MAAM,IAAI,CAAC;IAEd,QAAQ,CACN,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE,EACnE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAC3C,OAAO,CAAC,MAAM,CAAC,CAAC;IAKnB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAC5C;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE,GAChD;QAAE,MAAM,EAAE,kBAAkB,CAAA;KAAE,GAC9B;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,CAC1B,CAAC;CACH;AAQD,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAoDf;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAuH3E;AAGD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAuBhC;AAED,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/server/indexer.js

@@ -0,0 +1,218 @@
+import { PHYGITAL_PAYMENT_PROGRAM_ADDRESS } from "../generated/programs/phygitalPayment.js";
+import { base58ToBytes, bytesToBase58 } from "../core/bytes.js";
+import { collectEventsForAddress, subscribeToPaymentEvents, } from "../core/events.js";
+import { fetchPaymentSummary, } from "../core/payment.js";
+import { derivePaymentAddressFromSeeds } from "../core/pda.js";
+import { PaymentStatus } from "../core/status.js";
+import { nowSeconds } from "../core/time.js";
+export function createInMemoryIndexerStore() {
+    const rows = new Map();
+    return {
+        upsert(payment) {
+            rows.set(payment.address, payment);
+        },
+        remove(address) {
+            rows.delete(address);
+        },
+        get(address) {
+            return rows.get(address) ?? null;
+        },
+        list(filter = {}) {
+            const statuses = filter.status
+                ? new Set(Array.isArray(filter.status) ? filter.status : [filter.status])
+                : null;
+            let items = [...rows.values()].filter((row) => {
+                if (statuses && !statuses.has(row.status))
+                    return false;
+                if (filter.merchant && row.merchant !== filter.merchant)
+                    return false;
+                if (filter.arbiter && row.arbiter !== filter.arbiter)
+                    return false;
+                if (filter.payer && row.payer !== filter.payer)
+                    return false;
+                if (filter.deadlineAtOrBefore !== undefined) {
+                    const deadline = row.status === PaymentStatus.Pending
+                        ? row.captureAfter
+                        : row.merchantResponded
+                            ? row.respondedAt
+                            : row.disputedAt;
+                    if (deadline > filter.deadlineAtOrBefore)
+                        return false;
+                }
+                return true;
+            });
+            items.sort((a, b) => a.captureAfter - b.captureAfter);
+            if (filter.limit !== undefined)
+                items = items.slice(0, filter.limit);
+            return items;
+        },
+        size: () => rows.size,
+    };
+}
+export async function applyEventToStore(store, entry) {
+    const { event, signature } = entry;
+    const updatedAt = entry.blockTime ?? nowSeconds();
+    switch (event.type) {
+        case "paymentCreated": {
+            const existing = await store.get(event.data.payment);
+            await store.upsert({
+                address: event.data.payment,
+                payer: event.data.payer,
+                merchant: event.data.merchant,
+                mint: event.data.mint,
+                arbiter: event.data.arbiter,
+                amount: event.data.amount,
+                status: existing?.status ?? PaymentStatus.Pending,
+                merchantResponded: existing?.merchantResponded ?? false,
+                captureAfter: event.data.captureAfter,
+                disputedAt: existing?.disputedAt ?? 0,
+                respondedAt: existing?.respondedAt ?? 0,
+                lastSignature: signature,
+                updatedAt,
+            });
+            return;
+        }
+        case "paymentDisputed": {
+            const existing = await store.get(event.data.payment);
+            await store.upsert({
+                address: event.data.payment,
+                payer: event.data.payer,
+                merchant: event.data.merchant,
+                mint: existing?.mint ?? "11111111111111111111111111111111",
+                arbiter: existing?.arbiter ?? "11111111111111111111111111111111",
+                amount: existing?.amount ?? 0n,
+                status: PaymentStatus.Disputed,
+                merchantResponded: existing?.merchantResponded ?? false,
+                captureAfter: existing?.captureAfter ?? 0,
+                disputedAt: updatedAt,
+                respondedAt: existing?.respondedAt ?? 0,
+                lastSignature: signature,
+                updatedAt,
+            });
+            return;
+        }
+        case "paymentCaptured":
+        case "paymentRefunded":
+        case "disputeResolved":
+        case "settledPaymentRefunded":
+            await store.remove(event.data.payment);
+            return;
+        case "reserveChanged":
+            return;
+    }
+}
+export function createEventIndexer(config) {
+    const programAddress = config.programAddress ?? PHYGITAL_PAYMENT_PROGRAM_ADDRESS;
+    async function apply(entry) {
+        if (config.store) {
+            await applyEventToStore(config.store, entry);
+        }
+        if (config.exposureStore && entry.event.type === "paymentCreated") {
+            await config.exposureStore.release(bytesToBase58(entry.event.data.reference));
+        }
+        if (config.closableStore) {
+            const { event } = entry;
+            switch (event.type) {
+                case "paymentCaptured":
+                case "paymentRefunded":
+                case "disputeResolved":
+                    await config.closableStore.add({
+                        payment: event.data.payment,
+                        merchant: event.data.merchant,
+                    });
+                    break;
+                case "paymentClosed":
+                    await config.closableStore.remove(event.data.payment);
+                    break;
+            }
+        }
+    }
+    return {
+        apply,
+        subscribe(callback, options = {}) {
+            if (!config.rpcSubscriptions) {
+                throw new Error("createEventIndexer.subscribe requires rpcSubscriptions");
+            }
+            return subscribeToPaymentEvents(config.rpcSubscriptions, (entry) => {
+                void apply(entry);
+                callback?.(entry);
+            }, { programAddress, onError: options.onError });
+        },
+        async backfill(options = {}, callback) {
+            const events = await collectEventsForAddress(config.rpc, programAddress, { ...options, programAddress });
+            for (const entry of [...events].reverse()) {
+                await apply(entry);
+                callback?.(entry);
+            }
+            return events.length;
+        },
+        async reconcilePayment(input) {
+            const signature = "signature" in input && input.signature
+                ? input.signature
+                : "txSig" in input && input.txSig
+                    ? input.txSig
+                    : undefined;
+            let paymentAddress = "payment" in input ? input.payment : undefined;
+            if (!paymentAddress &&
+                "sender" in input &&
+                input.sender &&
+                input.mint &&
+                input.reference) {
+                paymentAddress = await derivePaymentAddressFromSeeds({
+                    owner: input.sender,
+                    mint: input.mint,
+                    reference: base58ToBytes(input.reference),
+                    tokenProgram: input.tokenProgram,
+                });
+            }
+            if (signature) {
+                const tx = await config.rpc
+                    .getTransaction(signature, {
+                    maxSupportedTransactionVersion: 0,
+                    encoding: "json",
+                    commitment: "confirmed",
+                })
+                    .send();
+                if (tx && tx.meta?.err === null) {
+                    if (paymentAddress) {
+                        const payment = await fetchPaymentSummary(config.rpc, paymentAddress);
+                        if (payment)
+                            return { status: "confirmed", payment };
+                    }
+                    return { status: "confirmed_closed" };
+                }
+            }
+            if (paymentAddress) {
+                const payment = await fetchPaymentSummary(config.rpc, paymentAddress);
+                if (payment)
+                    return { status: "confirmed", payment };
+            }
+            return { status: "not_found" };
+        },
+    };
+}
+export async function refreshIndexedPayment(rpc, store, address) {
+    const summary = await fetchPaymentSummary(rpc, address);
+    if (!summary) {
+        await store.remove(address);
+        return null;
+    }
+    const existing = await store.get(address);
+    await store.upsert({
+        address: summary.address,
+        payer: summary.payer,
+        merchant: summary.merchant,
+        mint: summary.mint,
+        arbiter: summary.arbiter,
+        amount: summary.amount,
+        status: summary.status,
+        merchantResponded: summary.merchantResponded,
+        captureAfter: summary.captureAfter,
+        disputedAt: summary.disputedAt,
+        respondedAt: summary.respondedAt,
+        lastSignature: existing?.lastSignature ?? "1111111111111111111111111111111111111111111111111111111111111111",
+        updatedAt: nowSeconds(),
+    });
+    return summary;
+}
+//# sourceMappingURL=indexer.js.map

package/dist/server/indexer.js.map

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

package/dist/server/keeper.d.ts

@@ -0,0 +1,34 @@
+import type { Address, RpcSubscriptions, Signature, SolanaRpcSubscriptionsApi, TransactionSigner } from "@solana/kit";
+import { type PhygitalPaymentSdkError } from "../core/errors.js";
+import { type SdkRpc } from "../core/payment.js";
+import type { IndexedPayment, IndexerStore } from "../core/indexer-store.js";
+import type { ClosablePaymentStore } from "./closable-store.js";
+export interface KeeperConfig {
+    rpc: SdkRpc;
+    rpcSubscriptions?: RpcSubscriptions<SolanaRpcSubscriptionsApi>;
+    feePayer: TransactionSigner;
+    store: IndexerStore;
+    closableStore?: ClosablePaymentStore;
+    batchSize?: number;
+    pollIntervalMs?: number;
+    onResult?: (result: {
+        payment: Address;
+        kind: "auto_settle" | "auto_refund" | "close_expired";
+        signature?: Signature;
+        merchant?: Address;
+        rentPayer?: Address;
+        error?: PhygitalPaymentSdkError;
+    }) => void;
+}
+export interface Keeper {
+    scanSettleable(now?: number): Promise<IndexedPayment[]>;
+    scanAutoRefundable(now?: number): Promise<IndexedPayment[]>;
+    crankAutoSettle(payment: Address): Promise<Signature>;
+    crankAutoRefund(payment: Address): Promise<Signature>;
+    crankCloseExpired(payment: Address): Promise<Signature>;
+    runOnce(): Promise<number>;
+    start(): void;
+    stop(): void;
+}
+export declare function createKeeper(config: KeeperConfig): Keeper;
+//# sourceMappingURL=keeper.d.ts.map

package/dist/server/keeper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keeper.d.ts","sourceRoot":"","sources":["../../src/server/keeper.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,OAAO,EAEP,gBAAgB,EAChB,SAAS,EACT,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAc,KAAK,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAGL,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAc5B,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7E,OAAO,KAAK,EAEV,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,yBAAyB,CAAC,CAAC;IAC/D,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,KAAK,EAAE,YAAY,CAAC;IAMpB,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAErC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,aAAa,GAAG,aAAa,GAAG,eAAe,CAAC;QACtD,SAAS,CAAC,EAAE,SAAS,CAAC;QAEtB,QAAQ,CAAC,EAAE,OAAO,CAAC;QAEnB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,KAAK,CAAC,EAAE,uBAAuB,CAAC;KACjC,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,MAAM;IAErB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAExD,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE5D,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtD,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtD,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAExD,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAgRzD"}

package/dist/server/keeper.js

@@ -0,0 +1,246 @@
+import { getCreateAssociatedTokenIdempotentInstructionAsync } from "@solana-program/token";
+import { getAutoRefundInstruction } from "../generated/instructions/autoRefund.js";
+import { getAutoSettleInstruction } from "../generated/instructions/autoSettle.js";
+import { getCloseExpiredPaymentInstruction } from "../generated/instructions/closeExpiredPayment.js";
+import { toSdkError } from "../core/errors.js";
+import { fetchPaymentSummary, } from "../core/payment.js";
+import { deriveAssociatedTokenAddress, deriveEscrowAddress, derivePaymentAccountAddress, } from "../core/pda.js";
+import { PaymentStatus } from "../core/status.js";
+import { autoRefundSplit, isAutoRefundable, isClosable, isSettleable, nowSeconds, } from "../core/time.js";
+import { createTransactionRuntime } from "../core/transactions.js";
+import { refreshIndexedPayment } from "./indexer.js";
+export function createKeeper(config) {
+    const runtime = createTransactionRuntime(config);
+    const batchSize = config.batchSize ?? 25;
+    let timer = null;
+    let running = false;
+    async function scanSettleable(now = nowSeconds()) {
+        const candidates = await config.store.list({
+            status: PaymentStatus.Pending,
+            deadlineAtOrBefore: now,
+            limit: batchSize,
+        });
+        return candidates.filter((row) => isSettleable(row, now));
+    }
+    async function scanAutoRefundable(now = nowSeconds()) {
+        const candidates = await config.store.list({
+            status: PaymentStatus.Disputed,
+            limit: batchSize * 2,
+        });
+        return candidates
+            .filter((row) => isAutoRefundable(row, now))
+            .slice(0, batchSize);
+    }
+    async function loadLive(payment) {
+        const summary = await refreshIndexedPayment(config.rpc, config.store, payment);
+        if (!summary) {
+            throw toSdkError(new Error(`Payment ${payment} is not open on-chain (already settled/refunded, or never existed).`));
+        }
+        return summary;
+    }
+    async function buildMerchantAtaIxs(summary) {
+        const merchantTokenAccount = await deriveAssociatedTokenAddress({
+            owner: summary.merchant,
+            mint: summary.mint,
+            tokenProgram: summary.tokenProgram,
+        });
+        const preamble = [
+            await getCreateAssociatedTokenIdempotentInstructionAsync({
+                payer: config.feePayer,
+                owner: summary.merchant,
+                mint: summary.mint,
+                tokenProgram: summary.tokenProgram,
+            }),
+        ];
+        return { merchantTokenAccount, preamble };
+    }
+    async function crankAutoSettle(payment) {
+        const summary = await loadLive(payment);
+        if (!isSettleable(summary)) {
+            throw toSdkError(new Error(`Payment ${payment} is not settleable (status=${summary.status}, captureAfter=${summary.captureAfter}).`));
+        }
+        const paymentAccount = await derivePaymentAccountAddress({
+            owner: summary.payer,
+            mint: summary.mint,
+            tokenProgram: summary.tokenProgram,
+        });
+        const escrowTokenAccount = await deriveEscrowAddress({
+            owner: summary.payer,
+            mint: summary.mint,
+            tokenProgram: summary.tokenProgram,
+        });
+        const { merchantTokenAccount, preamble } = await buildMerchantAtaIxs(summary);
+        const instruction = getAutoSettleInstruction({
+            paymentAccount,
+            payment,
+            escrowTokenAccount,
+            mint: summary.mint,
+            merchantTokenAccount,
+            tokenProgram: summary.tokenProgram,
+        });
+        try {
+            const signature = await runtime.sendAndConfirm(config.feePayer, [
+                ...preamble,
+                instruction,
+            ]);
+            await config.store.remove(payment);
+            await config.closableStore?.add({ payment, merchant: summary.merchant });
+            config.onResult?.({ payment, kind: "auto_settle", signature });
+            return signature;
+        }
+        catch (error) {
+            const sdkError = toSdkError(error);
+            config.onResult?.({ payment, kind: "auto_settle", error: sdkError });
+            throw sdkError;
+        }
+    }
+    async function crankAutoRefund(payment) {
+        const summary = await loadLive(payment);
+        if (!isAutoRefundable(summary)) {
+            throw toSdkError(new Error(`Payment ${payment} is not auto-refundable yet (status=${summary.status}, merchantResponded=${summary.merchantResponded}).`));
+        }
+        const paymentAccount = await derivePaymentAccountAddress({
+            owner: summary.payer,
+            mint: summary.mint,
+            tokenProgram: summary.tokenProgram,
+        });
+        const escrowTokenAccount = await deriveEscrowAddress({
+            owner: summary.payer,
+            mint: summary.mint,
+            tokenProgram: summary.tokenProgram,
+        });
+        const { payerShare } = autoRefundSplit(summary);
+        const preamble = [];
+        let merchantTokenAccount;
+        if (payerShare === "half") {
+            const built = await buildMerchantAtaIxs(summary);
+            merchantTokenAccount = built.merchantTokenAccount;
+            preamble.push(...built.preamble);
+        }
+        const instruction = getAutoRefundInstruction({
+            paymentAccount,
+            payment,
+            escrowTokenAccount,
+            mint: summary.mint,
+            merchantTokenAccount,
+            tokenProgram: summary.tokenProgram,
+        });
+        try {
+            const signature = await runtime.sendAndConfirm(config.feePayer, [
+                ...preamble,
+                instruction,
+            ]);
+            await config.store.remove(payment);
+            await config.closableStore?.add({ payment, merchant: summary.merchant });
+            config.onResult?.({ payment, kind: "auto_refund", signature });
+            return signature;
+        }
+        catch (error) {
+            const sdkError = toSdkError(error);
+            config.onResult?.({ payment, kind: "auto_refund", error: sdkError });
+            throw sdkError;
+        }
+    }
+    async function crankCloseExpired(payment) {
+        const summary = await fetchPaymentSummary(config.rpc, payment);
+        if (!summary) {
+            await config.closableStore?.remove(payment);
+            throw toSdkError(new Error(`Payment ${payment} is not on-chain (already closed).`));
+        }
+        if (!isClosable(summary)) {
+            throw toSdkError(new Error(`Payment ${payment} is not closable yet (status=${summary.status}, issuedAt=${summary.issuedAt}).`));
+        }
+        const paymentAccount = await derivePaymentAccountAddress({
+            owner: summary.payer,
+            mint: summary.mint,
+            tokenProgram: summary.tokenProgram,
+        });
+        const instruction = getCloseExpiredPaymentInstruction({
+            paymentAccount,
+            payment,
+            rentPayer: summary.rentPayer,
+        });
+        try {
+            const signature = await runtime.sendAndConfirm(config.feePayer, [instruction]);
+            await config.closableStore?.remove(payment);
+            config.onResult?.({
+                payment,
+                kind: "close_expired",
+                signature,
+                merchant: summary.merchant,
+                rentPayer: summary.rentPayer,
+            });
+            return signature;
+        }
+        catch (error) {
+            const sdkError = toSdkError(error);
+            config.onResult?.({ payment, kind: "close_expired", error: sdkError });
+            throw sdkError;
+        }
+    }
+    async function scanClosable(now = nowSeconds()) {
+        if (!config.closableStore)
+            return [];
+        void now;
+        return config.closableStore.list(batchSize);
+    }
+    async function runOnce() {
+        if (running)
+            return 0;
+        running = true;
+        let attempted = 0;
+        try {
+            const settleable = await scanSettleable();
+            for (const row of settleable) {
+                attempted += 1;
+                try {
+                    await crankAutoSettle(row.address);
+                }
+                catch {
+                }
+            }
+            const refundable = await scanAutoRefundable();
+            for (const row of refundable) {
+                attempted += 1;
+                try {
+                    await crankAutoRefund(row.address);
+                }
+                catch {
+                }
+            }
+            const closable = await scanClosable();
+            for (const row of closable) {
+                attempted += 1;
+                try {
+                    await crankCloseExpired(row.payment);
+                }
+                catch {
+                }
+            }
+            return attempted;
+        }
+        finally {
+            running = false;
+        }
+    }
+    return {
+        scanSettleable,
+        scanAutoRefundable,
+        crankAutoSettle,
+        crankAutoRefund,
+        crankCloseExpired,
+        runOnce,
+        start() {
+            if (timer)
+                return;
+            timer = setInterval(() => void runOnce(), config.pollIntervalMs ?? 30_000);
+        },
+        stop() {
+            if (timer) {
+                clearInterval(timer);
+                timer = null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=keeper.js.map

package/dist/server/keeper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keeper.js","sourceRoot":"","sources":["../../src/server/keeper.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kDAAkD,EAAE,MAAM,uBAAuB,CAAC;AAS3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,iCAAiC,EAAE,MAAM,kDAAkD,CAAC;AACrG,OAAO,EAAE,UAAU,EAAgC,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EACL,mBAAmB,GAGpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAKnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AA6CrD,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,MAAM,OAAO,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IACzC,IAAI,KAAK,GAA0C,IAAI,CAAC;IACxD,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,UAAU,cAAc,CAAC,GAAG,GAAG,UAAU,EAAE;QAC9C,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YACzC,MAAM,EAAE,aAAa,CAAC,OAAO;YAC7B,kBAAkB,EAAE,GAAG;YACvB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,UAAU,kBAAkB,CAC/B,GAAG,GAAG,UAAU,EAAE;QAElB,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YACzC,MAAM,EAAE,aAAa,CAAC,QAAQ;YAC9B,KAAK,EAAE,SAAS,GAAG,CAAC;SACrB,CAAC,CAAC;QACH,OAAO,UAAU;aACd,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;aAC3C,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,UAAU,QAAQ,CAAC,OAAgB;QACtC,MAAM,OAAO,GAAG,MAAM,qBAAqB,CACzC,MAAM,CAAC,GAAG,EACV,MAAM,CAAC,KAAK,EACZ,OAAO,CACR,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,UAAU,CACd,IAAI,KAAK,CACP,WAAW,OAAO,qEAAqE,CACxF,CACF,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,UAAU,mBAAmB,CAChC,OAAuB;QAEvB,MAAM,oBAAoB,GAAG,MAAM,4BAA4B,CAAC;YAC9D,KAAK,EAAE,OAAO,CAAC,QAAQ;YACvB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAkB;YAC9B,MAAM,kDAAkD,CAAC;gBACvD,KAAK,EAAE,MAAM,CAAC,QAAQ;gBACtB,KAAK,EAAE,OAAO,CAAC,QAAQ;gBACvB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC;SACH,CAAC;QACF,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC;IAC5C,CAAC;IAED,KAAK,UAAU,eAAe,CAAC,OAAgB;QAC7C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,MAAM,UAAU,CACd,IAAI,KAAK,CACP,WAAW,OAAO,8BAA8B,OAAO,CAAC,MAAM,kBAAkB,OAAO,CAAC,YAAY,IAAI,CACzG,CACF,CAAC;QACJ,CAAC;QACD,MAAM,cAAc,GAAG,MAAM,2BAA2B,CAAC;YACvD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAC;QACH,MAAM,kBAAkB,GAAG,MAAM,mBAAmB,CAAC;YACnD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAC;QACH,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,GACtC,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,WAAW,GAAG,wBAAwB,CAAC;YAC3C,cAAc;YACd,OAAO;YACP,kBAAkB;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,oBAAoB;YACpB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE;gBAC9D,GAAG,QAAQ;gBACX,WAAW;aACZ,CAAC,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAEnC,MAAM,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YACzE,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;YAC/D,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACrE,MAAM,QAAQ,CAAC;QACjB,CAAC;IACH,CAAC;IAED,KAAK,UAAU,eAAe,CAAC,OAAgB;QAC7C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,MAAM,UAAU,CACd,IAAI,KAAK,CACP,WAAW,OAAO,uCAAuC,OAAO,CAAC,MAAM,uBAAuB,OAAO,CAAC,iBAAiB,IAAI,CAC5H,CACF,CAAC;QACJ,CAAC;QACD,MAAM,cAAc,GAAG,MAAM,2BAA2B,CAAC;YACvD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAC;QACH,MAAM,kBAAkB,GAAG,MAAM,mBAAmB,CAAC;YACnD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAC;QACH,MAAM,EAAE,UAAU,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,IAAI,oBAAyC,CAAC;QAC9C,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACjD,oBAAoB,GAAG,KAAK,CAAC,oBAAoB,CAAC;YAClD,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,WAAW,GAAG,wBAAwB,CAAC;YAC3C,cAAc;YACd,OAAO;YACP,kBAAkB;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,oBAAoB;YACpB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE;gBAC9D,GAAG,QAAQ;gBACX,WAAW;aACZ,CAAC,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAEnC,MAAM,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YACzE,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;YAC/D,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACrE,MAAM,QAAQ,CAAC;QACjB,CAAC;IACH,CAAC;IAED,KAAK,UAAU,iBAAiB,CAAC,OAAgB;QAG/C,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;YAEb,MAAM,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,UAAU,CACd,IAAI,KAAK,CAAC,WAAW,OAAO,oCAAoC,CAAC,CAClE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,MAAM,UAAU,CACd,IAAI,KAAK,CACP,WAAW,OAAO,gCAAgC,OAAO,CAAC,MAAM,cAAc,OAAO,CAAC,QAAQ,IAAI,CACnG,CACF,CAAC;QACJ,CAAC;QACD,MAAM,cAAc,GAAG,MAAM,2BAA2B,CAAC;YACvD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,iCAAiC,CAAC;YACpD,cAAc;YACd,OAAO;YAGP,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;YAC/E,MAAM,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAChB,OAAO;gBACP,IAAI,EAAE,eAAe;gBACrB,SAAS;gBACT,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;YACH,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvE,MAAM,QAAQ,CAAC;QACjB,CAAC;IACH,CAAC;IAED,KAAK,UAAU,YAAY,CAAC,GAAG,GAAG,UAAU,EAAE;QAC5C,IAAI,CAAC,MAAM,CAAC,aAAa;YAAE,OAAO,EAAE,CAAC;QAGrC,KAAK,GAAG,CAAC;QACT,OAAO,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,UAAU,OAAO;QACpB,IAAI,OAAO;YAAE,OAAO,CAAC,CAAC;QACtB,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,cAAc,EAAE,CAAC;YAC1C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;gBAC7B,SAAS,IAAI,CAAC,CAAC;gBACf,IAAI,CAAC;oBACH,MAAM,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACrC,CAAC;gBAAC,MAAM,CAAC;gBAET,CAAC;YACH,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,kBAAkB,EAAE,CAAC;YAC9C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;gBAC7B,SAAS,IAAI,CAAC,CAAC;gBACf,IAAI,CAAC;oBACH,MAAM,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACrC,CAAC;gBAAC,MAAM,CAAC;gBAET,CAAC;YACH,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;YACtC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC3B,SAAS,IAAI,CAAC,CAAC;gBACf,IAAI,CAAC;oBACH,MAAM,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACvC,CAAC;gBAAC,MAAM,CAAC;gBAET,CAAC;YACH,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;gBAAS,CAAC;YACT,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO;QACL,cAAc;QACd,kBAAkB;QAClB,eAAe;QACf,eAAe;QACf,iBAAiB;QACjB,OAAO;QACP,KAAK;YACH,IAAI,KAAK;gBAAE,OAAO;YAClB,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,EAAE,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,CAAC;QAC7E,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/pending-taps.d.ts

@@ -0,0 +1,12 @@
+import type { Address } from "@solana/kit";
+import type { PendingTapWire } from "../merchant/deferred-store.js";
+export interface PendingTapStore {
+    put(tap: PendingTapWire): Promise<void>;
+    listByMerchant(merchant: Address): Promise<PendingTapWire[]>;
+    listAll(): Promise<PendingTapWire[]>;
+    acknowledge(reference: string): Promise<void>;
+}
+export declare function createInMemoryPendingTapStore(): PendingTapStore & {
+    items(): PendingTapWire[];
+};
+//# sourceMappingURL=pending-taps.d.ts.map

package/dist/server/pending-taps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-taps.d.ts","sourceRoot":"","sources":["../../src/server/pending-taps.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE7D,OAAO,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACrC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,wBAAgB,6BAA6B,IAAI,eAAe,GAAG;IACjE,KAAK,IAAI,cAAc,EAAE,CAAC;CAC3B,CAiBA"}

package/dist/server/pending-taps.js

@@ -0,0 +1,19 @@
+export function createInMemoryPendingTapStore() {
+    const byReference = new Map();
+    return {
+        async put(tap) {
+            byReference.set(tap.reference, tap);
+        },
+        async listByMerchant(merchant) {
+            return [...byReference.values()].filter((tap) => tap.merchant === merchant);
+        },
+        async listAll() {
+            return [...byReference.values()];
+        },
+        async acknowledge(reference) {
+            byReference.delete(reference);
+        },
+        items: () => [...byReference.values()],
+    };
+}
+//# sourceMappingURL=pending-taps.js.map

package/dist/server/pending-taps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-taps.js","sourceRoot":"","sources":["../../src/server/pending-taps.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,6BAA6B;IAG3C,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAC;IACtD,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,GAAG;YACX,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACtC,CAAC;QACD,KAAK,CAAC,cAAc,CAAC,QAAQ;YAC3B,OAAO,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QAC9E,CAAC;QACD,KAAK,CAAC,OAAO;YACX,OAAO,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,SAAS;YACzB,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;KACvC,CAAC;AACJ,CAAC"}