@resvary/sdk 0.5.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (171) hide show
  1. package/LICENSE +13 -0
  2. package/README.md +17 -0
  3. package/dist/billing/index.d.ts +3 -0
  4. package/dist/billing/index.d.ts.map +1 -0
  5. package/dist/billing/index.js +3 -0
  6. package/dist/billing/index.js.map +1 -0
  7. package/dist/billing/meter.d.ts +97 -0
  8. package/dist/billing/meter.d.ts.map +1 -0
  9. package/dist/billing/meter.js +109 -0
  10. package/dist/billing/meter.js.map +1 -0
  11. package/dist/billing/plans.d.ts +77 -0
  12. package/dist/billing/plans.d.ts.map +1 -0
  13. package/dist/billing/plans.js +65 -0
  14. package/dist/billing/plans.js.map +1 -0
  15. package/dist/client/buyer.d.ts +82 -0
  16. package/dist/client/buyer.d.ts.map +1 -0
  17. package/dist/client/buyer.js +168 -0
  18. package/dist/client/buyer.js.map +1 -0
  19. package/dist/client/index.d.ts +2 -0
  20. package/dist/client/index.d.ts.map +1 -0
  21. package/dist/client/index.js +2 -0
  22. package/dist/client/index.js.map +1 -0
  23. package/dist/constants.d.ts +36 -0
  24. package/dist/constants.d.ts.map +1 -0
  25. package/dist/constants.js +42 -0
  26. package/dist/constants.js.map +1 -0
  27. package/dist/credits/amount.d.ts +7 -0
  28. package/dist/credits/amount.d.ts.map +1 -0
  29. package/dist/credits/amount.js +36 -0
  30. package/dist/credits/amount.js.map +1 -0
  31. package/dist/credits/errors.d.ts +20 -0
  32. package/dist/credits/errors.d.ts.map +1 -0
  33. package/dist/credits/errors.js +35 -0
  34. package/dist/credits/errors.js.map +1 -0
  35. package/dist/credits/index.d.ts +7 -0
  36. package/dist/credits/index.d.ts.map +1 -0
  37. package/dist/credits/index.js +6 -0
  38. package/dist/credits/index.js.map +1 -0
  39. package/dist/credits/ledger.d.ts +175 -0
  40. package/dist/credits/ledger.d.ts.map +1 -0
  41. package/dist/credits/ledger.js +705 -0
  42. package/dist/credits/ledger.js.map +1 -0
  43. package/dist/credits/store.d.ts +104 -0
  44. package/dist/credits/store.d.ts.map +1 -0
  45. package/dist/credits/store.js +420 -0
  46. package/dist/credits/store.js.map +1 -0
  47. package/dist/credits/types.d.ts +234 -0
  48. package/dist/credits/types.d.ts.map +1 -0
  49. package/dist/credits/types.js +2 -0
  50. package/dist/credits/types.js.map +1 -0
  51. package/dist/credits/webhooks.d.ts +5 -0
  52. package/dist/credits/webhooks.d.ts.map +1 -0
  53. package/dist/credits/webhooks.js +13 -0
  54. package/dist/credits/webhooks.js.map +1 -0
  55. package/dist/funding/arc-worker.d.ts +55 -0
  56. package/dist/funding/arc-worker.d.ts.map +1 -0
  57. package/dist/funding/arc-worker.js +133 -0
  58. package/dist/funding/arc-worker.js.map +1 -0
  59. package/dist/funding/arc.d.ts +38 -0
  60. package/dist/funding/arc.d.ts.map +1 -0
  61. package/dist/funding/arc.js +83 -0
  62. package/dist/funding/arc.js.map +1 -0
  63. package/dist/funding/index.d.ts +3 -0
  64. package/dist/funding/index.d.ts.map +1 -0
  65. package/dist/funding/index.js +3 -0
  66. package/dist/funding/index.js.map +1 -0
  67. package/dist/gateway/client.d.ts +51 -0
  68. package/dist/gateway/client.d.ts.map +1 -0
  69. package/dist/gateway/client.js +59 -0
  70. package/dist/gateway/client.js.map +1 -0
  71. package/dist/gateway/index.d.ts +2 -0
  72. package/dist/gateway/index.d.ts.map +1 -0
  73. package/dist/gateway/index.js +2 -0
  74. package/dist/gateway/index.js.map +1 -0
  75. package/dist/index.d.ts +21 -0
  76. package/dist/index.d.ts.map +1 -0
  77. package/dist/index.js +20 -0
  78. package/dist/index.js.map +1 -0
  79. package/dist/middleware/express.d.ts +25 -0
  80. package/dist/middleware/express.d.ts.map +1 -0
  81. package/dist/middleware/express.js +61 -0
  82. package/dist/middleware/express.js.map +1 -0
  83. package/dist/middleware/index.d.ts +4 -0
  84. package/dist/middleware/index.d.ts.map +1 -0
  85. package/dist/middleware/index.js +4 -0
  86. package/dist/middleware/index.js.map +1 -0
  87. package/dist/middleware/next.d.ts +27 -0
  88. package/dist/middleware/next.d.ts.map +1 -0
  89. package/dist/middleware/next.js +67 -0
  90. package/dist/middleware/next.js.map +1 -0
  91. package/dist/middleware/paywall.d.ts +54 -0
  92. package/dist/middleware/paywall.d.ts.map +1 -0
  93. package/dist/middleware/paywall.js +102 -0
  94. package/dist/middleware/paywall.js.map +1 -0
  95. package/dist/pricing/index.d.ts +3 -0
  96. package/dist/pricing/index.d.ts.map +1 -0
  97. package/dist/pricing/index.js +2 -0
  98. package/dist/pricing/index.js.map +1 -0
  99. package/dist/pricing/rating.d.ts +21 -0
  100. package/dist/pricing/rating.d.ts.map +1 -0
  101. package/dist/pricing/rating.js +109 -0
  102. package/dist/pricing/rating.js.map +1 -0
  103. package/dist/receipts/amount.d.ts +8 -0
  104. package/dist/receipts/amount.d.ts.map +1 -0
  105. package/dist/receipts/amount.js +27 -0
  106. package/dist/receipts/amount.js.map +1 -0
  107. package/dist/receipts/index.d.ts +16 -0
  108. package/dist/receipts/index.d.ts.map +1 -0
  109. package/dist/receipts/index.js +15 -0
  110. package/dist/receipts/index.js.map +1 -0
  111. package/dist/receipts/invoice.d.ts +18 -0
  112. package/dist/receipts/invoice.d.ts.map +1 -0
  113. package/dist/receipts/invoice.js +112 -0
  114. package/dist/receipts/invoice.js.map +1 -0
  115. package/dist/receipts/ledger.d.ts +30 -0
  116. package/dist/receipts/ledger.d.ts.map +1 -0
  117. package/dist/receipts/ledger.js +109 -0
  118. package/dist/receipts/ledger.js.map +1 -0
  119. package/dist/receipts/memo-payment.d.ts +100 -0
  120. package/dist/receipts/memo-payment.d.ts.map +1 -0
  121. package/dist/receipts/memo-payment.js +91 -0
  122. package/dist/receipts/memo-payment.js.map +1 -0
  123. package/dist/receipts/memo.d.ts +14 -0
  124. package/dist/receipts/memo.d.ts.map +1 -0
  125. package/dist/receipts/memo.js +39 -0
  126. package/dist/receipts/memo.js.map +1 -0
  127. package/dist/receipts/persistent-ledger.d.ts +27 -0
  128. package/dist/receipts/persistent-ledger.d.ts.map +1 -0
  129. package/dist/receipts/persistent-ledger.js +111 -0
  130. package/dist/receipts/persistent-ledger.js.map +1 -0
  131. package/dist/receipts/persistent-webhook-inbox.d.ts +32 -0
  132. package/dist/receipts/persistent-webhook-inbox.d.ts.map +1 -0
  133. package/dist/receipts/persistent-webhook-inbox.js +93 -0
  134. package/dist/receipts/persistent-webhook-inbox.js.map +1 -0
  135. package/dist/receipts/proof.d.ts +80 -0
  136. package/dist/receipts/proof.d.ts.map +1 -0
  137. package/dist/receipts/proof.js +223 -0
  138. package/dist/receipts/proof.js.map +1 -0
  139. package/dist/receipts/serialization.d.ts +3 -0
  140. package/dist/receipts/serialization.d.ts.map +1 -0
  141. package/dist/receipts/serialization.js +24 -0
  142. package/dist/receipts/serialization.js.map +1 -0
  143. package/dist/receipts/store.d.ts +69 -0
  144. package/dist/receipts/store.d.ts.map +1 -0
  145. package/dist/receipts/store.js +85 -0
  146. package/dist/receipts/store.js.map +1 -0
  147. package/dist/receipts/types.d.ts +134 -0
  148. package/dist/receipts/types.d.ts.map +1 -0
  149. package/dist/receipts/types.js +5 -0
  150. package/dist/receipts/types.js.map +1 -0
  151. package/dist/receipts/watcher.d.ts +92 -0
  152. package/dist/receipts/watcher.d.ts.map +1 -0
  153. package/dist/receipts/watcher.js +323 -0
  154. package/dist/receipts/watcher.js.map +1 -0
  155. package/dist/receipts/webhook-inbox.d.ts +34 -0
  156. package/dist/receipts/webhook-inbox.d.ts.map +1 -0
  157. package/dist/receipts/webhook-inbox.js +101 -0
  158. package/dist/receipts/webhook-inbox.js.map +1 -0
  159. package/dist/receipts/webhook-route.d.ts +22 -0
  160. package/dist/receipts/webhook-route.d.ts.map +1 -0
  161. package/dist/receipts/webhook-route.js +37 -0
  162. package/dist/receipts/webhook-route.js.map +1 -0
  163. package/dist/receipts/webhooks.d.ts +20 -0
  164. package/dist/receipts/webhooks.d.ts.map +1 -0
  165. package/dist/receipts/webhooks.js +72 -0
  166. package/dist/receipts/webhooks.js.map +1 -0
  167. package/dist/types.d.ts +101 -0
  168. package/dist/types.d.ts.map +1 -0
  169. package/dist/types.js +5 -0
  170. package/dist/types.js.map +1 -0
  171. package/package.json +116 -0
@@ -0,0 +1,92 @@
1
+ /**
2
+ * Arc Testnet receipt watcher for Memo-wrapped USDC invoice payments.
3
+ */
4
+ import { type PublicClient } from 'viem';
5
+ import { type ReceiptStore } from './store.js';
6
+ import type { PaymentInvoice, PaymentReceipt, ObservedPayment } from './types.js';
7
+ export type ReceiptWatcherClient = Pick<PublicClient, 'getBlockNumber' | 'getLogs' | 'getTransactionReceipt'> & Partial<Pick<PublicClient, 'getChainId'>>;
8
+ export type ReceiptWatcherLifecycleEvent = {
9
+ type: 'watcher.started';
10
+ invoiceCount: number;
11
+ } | {
12
+ type: 'watcher.stopped';
13
+ } | {
14
+ type: 'watcher.poll';
15
+ fromBlock: bigint;
16
+ toBlock: bigint;
17
+ invoiceCount: number;
18
+ } | {
19
+ type: 'watcher.memo_seen';
20
+ invoiceId: string;
21
+ txHash: `0x${string}`;
22
+ blockNumber?: bigint;
23
+ } | {
24
+ type: 'watcher.receipt_created';
25
+ invoiceId: string;
26
+ receipt: PaymentReceipt;
27
+ } | {
28
+ type: 'watcher.cursor_saved';
29
+ invoiceId: string;
30
+ cursorKey: string;
31
+ nextFromBlock: bigint;
32
+ };
33
+ type MaybePromise<T> = T | Promise<T>;
34
+ export interface ReceiptLedgerWriter {
35
+ recordPayment(invoiceId: string, payment: ObservedPayment): MaybePromise<PaymentReceipt>;
36
+ getReceiptByTxHash(txHash: `0x${string}`, invoiceId?: string): MaybePromise<PaymentReceipt | undefined>;
37
+ }
38
+ export interface ReceiptWatcherConfig {
39
+ ledger: ReceiptLedgerWriter;
40
+ cursorStore?: ReceiptStore;
41
+ rpcUrl?: string;
42
+ publicClient?: ReceiptWatcherClient;
43
+ fromBlock?: bigint;
44
+ confirmations?: number;
45
+ pollIntervalMs?: number;
46
+ expectedChainId?: number;
47
+ maxBlockRange?: number;
48
+ cursorOverlap?: number;
49
+ retryAttempts?: number;
50
+ retryBaseDelayMs?: number;
51
+ onReceipt?: (receipt: PaymentReceipt, invoice: PaymentInvoice) => void | Promise<void>;
52
+ onEvent?: (event: ReceiptWatcherLifecycleEvent) => void | Promise<void>;
53
+ onError?: (error: unknown) => void;
54
+ }
55
+ export declare class ReceiptWatcher {
56
+ private readonly ledger;
57
+ private readonly cursorStore?;
58
+ private readonly client;
59
+ private readonly confirmations;
60
+ private readonly pollIntervalMs;
61
+ private readonly expectedChainId;
62
+ private readonly maxBlockRange;
63
+ private readonly cursorOverlap;
64
+ private readonly retryAttempts;
65
+ private readonly retryBaseDelayMs;
66
+ private readonly fromBlock?;
67
+ private readonly onReceipt?;
68
+ private readonly onEvent?;
69
+ private readonly onError?;
70
+ private readonly invoices;
71
+ private readonly cursors;
72
+ private timer?;
73
+ constructor(config: ReceiptWatcherConfig);
74
+ watchInvoice(invoice: PaymentInvoice, options?: {
75
+ fromBlock?: bigint;
76
+ }): void;
77
+ unwatchInvoice(invoiceId: string): void;
78
+ pollOnce(): Promise<PaymentReceipt[]>;
79
+ start(): void;
80
+ stop(): void;
81
+ private pollInvoice;
82
+ private processMemoLog;
83
+ private getUnrecordedMatchingMemoLog;
84
+ private resolveFromBlock;
85
+ private saveCursor;
86
+ private withRetry;
87
+ private getCursorKey;
88
+ private emit;
89
+ private handleError;
90
+ }
91
+ export {};
92
+ //# sourceMappingURL=watcher.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/receipts/watcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAQL,KAAK,YAAY,EAClB,MAAM,MAAM,CAAC;AAId,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EAEd,eAAe,EAChB,MAAM,YAAY,CAAC;AAMpB,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,YAAY,EACZ,gBAAgB,GAAG,SAAS,GAAG,uBAAuB,CACvD,GACC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;AA6B5C,MAAM,MAAM,4BAA4B,GACpC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;IACzF,kBAAkB,CAChB,MAAM,EAAE,KAAK,MAAM,EAAE,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,YAAY,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,4BAA4B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAoC;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,KAAK,CAAC,CAAiC;gBAEnC,MAAM,EAAE,oBAAoB;IA0BxC,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IAOjF,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKjC,QAAQ,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IA4C3C,KAAK,IAAI,IAAI;IAYb,IAAI,IAAI,IAAI;YAUE,WAAW;YA4BX,cAAc;YA6Dd,4BAA4B;YAiB5B,gBAAgB;YAoBhB,UAAU;YA8BV,SAAS;IAgBvB,OAAO,CAAC,YAAY;YAQN,IAAI;IAIlB,OAAO,CAAC,WAAW;CAQpB"}
@@ -0,0 +1,323 @@
1
+ /**
2
+ * Arc Testnet receipt watcher for Memo-wrapped USDC invoice payments.
3
+ */
4
+ import { createPublicClient, formatUnits, getAddress, http, parseAbiItem, parseEventLogs, } from 'viem';
5
+ import { ARC_TESTNET, USDC_DECIMALS } from '../constants.js';
6
+ import { createMemoPaymentRequest, ERC20_TRANSFER_ABI } from './memo-payment.js';
7
+ import { createMemoPaymentProofFromReceipt } from './proof.js';
8
+ import { createWatcherCursorKey } from './store.js';
9
+ const MEMO_EVENT = parseAbiItem('event Memo(address indexed sender,address indexed target,bytes32 callDataHash,bytes32 indexed memoId,bytes memo,uint256 memoIndex)');
10
+ export class ReceiptWatcher {
11
+ ledger;
12
+ cursorStore;
13
+ client;
14
+ confirmations;
15
+ pollIntervalMs;
16
+ expectedChainId;
17
+ maxBlockRange;
18
+ cursorOverlap;
19
+ retryAttempts;
20
+ retryBaseDelayMs;
21
+ fromBlock;
22
+ onReceipt;
23
+ onEvent;
24
+ onError;
25
+ invoices = new Map();
26
+ cursors = new Map();
27
+ timer;
28
+ constructor(config) {
29
+ this.ledger = config.ledger;
30
+ this.cursorStore = config.cursorStore;
31
+ this.client =
32
+ config.publicClient ??
33
+ createPublicClient({
34
+ transport: http(config.rpcUrl ?? ARC_TESTNET.rpcUrl),
35
+ });
36
+ this.confirmations = BigInt(config.confirmations ?? 1);
37
+ this.pollIntervalMs = config.pollIntervalMs ?? 5_000;
38
+ this.expectedChainId = config.expectedChainId ?? ARC_TESTNET.chainId;
39
+ this.maxBlockRange = BigInt(config.maxBlockRange ?? 2_000);
40
+ this.cursorOverlap = BigInt(config.cursorOverlap ?? 0);
41
+ this.retryAttempts = config.retryAttempts ?? 3;
42
+ this.retryBaseDelayMs = config.retryBaseDelayMs ?? 250;
43
+ this.fromBlock = config.fromBlock;
44
+ if (this.maxBlockRange <= 0n)
45
+ throw new Error('maxBlockRange must be positive');
46
+ if (this.cursorOverlap < 0n)
47
+ throw new Error('cursorOverlap cannot be negative');
48
+ if (!Number.isSafeInteger(this.retryAttempts) || this.retryAttempts < 1) {
49
+ throw new Error('retryAttempts must be a positive integer');
50
+ }
51
+ this.onReceipt = config.onReceipt;
52
+ this.onEvent = config.onEvent;
53
+ this.onError = config.onError;
54
+ }
55
+ watchInvoice(invoice, options = {}) {
56
+ this.invoices.set(invoice.id, invoice);
57
+ if (options.fromBlock !== undefined) {
58
+ this.cursors.set(invoice.id, options.fromBlock);
59
+ }
60
+ }
61
+ unwatchInvoice(invoiceId) {
62
+ this.invoices.delete(invoiceId);
63
+ this.cursors.delete(invoiceId);
64
+ }
65
+ async pollOnce() {
66
+ if (this.invoices.size === 0) {
67
+ return [];
68
+ }
69
+ if (this.client.getChainId) {
70
+ const chainId = await this.withRetry(() => this.client.getChainId());
71
+ if (chainId !== this.expectedChainId) {
72
+ throw new Error(`Receipt watcher chain mismatch: expected ${this.expectedChainId}, got ${chainId}`);
73
+ }
74
+ }
75
+ const latestBlock = await this.withRetry(() => this.client.getBlockNumber());
76
+ const toBlock = latestBlock > this.confirmations ? latestBlock - this.confirmations : 0n;
77
+ const receipts = [];
78
+ for (const invoice of this.invoices.values()) {
79
+ const request = createMemoPaymentRequest(invoice);
80
+ const fromBlock = await this.resolveFromBlock(invoice, request, toBlock);
81
+ if (fromBlock > toBlock) {
82
+ continue;
83
+ }
84
+ let chunkFrom = fromBlock;
85
+ while (chunkFrom <= toBlock) {
86
+ const chunkTo = minBigInt(toBlock, chunkFrom + this.maxBlockRange - 1n);
87
+ await this.emit({
88
+ type: 'watcher.poll',
89
+ fromBlock: chunkFrom,
90
+ toBlock: chunkTo,
91
+ invoiceCount: this.invoices.size,
92
+ });
93
+ const invoiceReceipts = await this.pollInvoice(invoice, request, chunkFrom, chunkTo);
94
+ receipts.push(...invoiceReceipts);
95
+ await this.saveCursor(invoice, request, chunkTo + 1n);
96
+ chunkFrom = chunkTo + 1n;
97
+ }
98
+ }
99
+ return receipts;
100
+ }
101
+ start() {
102
+ if (this.timer) {
103
+ return;
104
+ }
105
+ void this.emit({ type: 'watcher.started', invoiceCount: this.invoices.size });
106
+ void this.pollOnce().catch((error) => this.handleError(error));
107
+ this.timer = setInterval(() => {
108
+ void this.pollOnce().catch((error) => this.handleError(error));
109
+ }, this.pollIntervalMs);
110
+ }
111
+ stop() {
112
+ if (!this.timer) {
113
+ return;
114
+ }
115
+ clearInterval(this.timer);
116
+ this.timer = undefined;
117
+ void this.emit({ type: 'watcher.stopped' });
118
+ }
119
+ async pollInvoice(invoice, request, fromBlock, toBlock) {
120
+ const memoLogs = (await this.withRetry(() => this.client.getLogs({
121
+ address: request.memoContract,
122
+ event: MEMO_EVENT,
123
+ args: { memoId: request.memoId },
124
+ fromBlock,
125
+ toBlock,
126
+ })));
127
+ const receipts = [];
128
+ for (const memoLog of memoLogs) {
129
+ const receipt = await this.processMemoLog(invoice, request, memoLog);
130
+ if (receipt) {
131
+ receipts.push(receipt);
132
+ }
133
+ }
134
+ return receipts;
135
+ }
136
+ async processMemoLog(invoice, request, memoLog) {
137
+ const match = await this.getUnrecordedMatchingMemoLog(invoice.id, request, memoLog);
138
+ if (!match) {
139
+ return null;
140
+ }
141
+ await this.emit({
142
+ type: 'watcher.memo_seen',
143
+ invoiceId: invoice.id,
144
+ txHash: match.txHash,
145
+ blockNumber: match.blockNumber,
146
+ });
147
+ const txReceipt = await this.withRetry(() => this.client.getTransactionReceipt({ hash: match.txHash }));
148
+ if (txReceipt.status !== 'success') {
149
+ return null;
150
+ }
151
+ const transfer = extractMatchingTransfer(txReceipt.logs, request, match.args.sender);
152
+ if (!transfer) {
153
+ return null;
154
+ }
155
+ const onchainProof = createMemoPaymentProofFromReceipt({
156
+ txHash: match.txHash,
157
+ paymentRequest: request,
158
+ txReceipt,
159
+ });
160
+ const observed = {
161
+ txHash: match.txHash,
162
+ from: transfer.from,
163
+ to: transfer.to,
164
+ amount: formatUnits(transfer.value, USDC_DECIMALS),
165
+ currency: invoice.currency,
166
+ network: invoice.network,
167
+ memo: invoice.memo,
168
+ memoId: request.memoId,
169
+ callDataHash: request.callDataHash,
170
+ blockNumber: txReceipt.blockNumber,
171
+ onchainProof,
172
+ observedAt: Date.now(),
173
+ metadata: {
174
+ source: 'arc-testnet-watcher',
175
+ memoIndex: match.args.memoIndex?.toString(),
176
+ explorerUrl: onchainProof.explorerUrl,
177
+ },
178
+ };
179
+ const receipt = await this.ledger.recordPayment(invoice.id, observed);
180
+ await this.onReceipt?.(receipt, invoice);
181
+ await this.emit({ type: 'watcher.receipt_created', invoiceId: invoice.id, receipt });
182
+ return receipt;
183
+ }
184
+ async getUnrecordedMatchingMemoLog(invoiceId, request, memoLog) {
185
+ const match = getMatchingMemoLog(memoLog, request);
186
+ if (!match) {
187
+ return null;
188
+ }
189
+ if (await this.ledger.getReceiptByTxHash(match.txHash, invoiceId)) {
190
+ return null;
191
+ }
192
+ return match;
193
+ }
194
+ async resolveFromBlock(invoice, request, defaultFromBlock) {
195
+ const memoryCursor = this.cursors.get(invoice.id);
196
+ if (memoryCursor !== undefined) {
197
+ return memoryCursor;
198
+ }
199
+ const cursorKey = this.getCursorKey(invoice, request);
200
+ const persisted = await this.cursorStore?.getWatcherCursor(cursorKey);
201
+ if (persisted) {
202
+ this.cursors.set(invoice.id, persisted.nextFromBlock);
203
+ return persisted.nextFromBlock;
204
+ }
205
+ return this.fromBlock ?? defaultFromBlock;
206
+ }
207
+ async saveCursor(invoice, request, nextFromBlock) {
208
+ const persistedFromBlock = nextFromBlock > this.cursorOverlap ? nextFromBlock - this.cursorOverlap : 0n;
209
+ this.cursors.set(invoice.id, persistedFromBlock);
210
+ if (!this.cursorStore) {
211
+ return;
212
+ }
213
+ const cursorKey = this.getCursorKey(invoice, request);
214
+ await this.cursorStore.saveWatcherCursor({
215
+ key: cursorKey,
216
+ invoiceId: invoice.id,
217
+ memoId: request.memoId,
218
+ network: invoice.network,
219
+ nextFromBlock: persistedFromBlock,
220
+ updatedAt: Date.now(),
221
+ });
222
+ await this.emit({
223
+ type: 'watcher.cursor_saved',
224
+ invoiceId: invoice.id,
225
+ cursorKey,
226
+ nextFromBlock: persistedFromBlock,
227
+ });
228
+ }
229
+ async withRetry(operation) {
230
+ let lastError;
231
+ for (let attempt = 0; attempt < this.retryAttempts; attempt += 1) {
232
+ try {
233
+ return await operation();
234
+ }
235
+ catch (error) {
236
+ lastError = error;
237
+ if (attempt + 1 >= this.retryAttempts)
238
+ break;
239
+ const exponential = this.retryBaseDelayMs * 2 ** attempt;
240
+ const jitter = Math.floor(Math.random() * Math.max(1, this.retryBaseDelayMs));
241
+ await new Promise((resolve) => setTimeout(resolve, exponential + jitter));
242
+ }
243
+ }
244
+ throw lastError;
245
+ }
246
+ getCursorKey(invoice, request) {
247
+ return createWatcherCursorKey({
248
+ network: invoice.network,
249
+ invoiceId: invoice.id,
250
+ memoId: request.memoId,
251
+ });
252
+ }
253
+ async emit(event) {
254
+ await this.onEvent?.(event);
255
+ }
256
+ handleError(error) {
257
+ if (this.onError) {
258
+ this.onError(error);
259
+ return;
260
+ }
261
+ throw error;
262
+ }
263
+ }
264
+ function extractMatchingTransfer(logs, request, expectedFrom) {
265
+ const erc20Logs = logs.filter((log) => sameAddress(log.address, request.target));
266
+ const parsedLogs = parseEventLogs({
267
+ abi: ERC20_TRANSFER_ABI,
268
+ eventName: 'Transfer',
269
+ logs: erc20Logs,
270
+ strict: false,
271
+ });
272
+ for (const parsedLog of parsedLogs) {
273
+ const args = parsedLog.args;
274
+ if (!args.from || !args.to || args.value === undefined) {
275
+ continue;
276
+ }
277
+ if (!sameAddress(args.from, expectedFrom)) {
278
+ continue;
279
+ }
280
+ if (!sameAddress(args.to, request.payTo)) {
281
+ continue;
282
+ }
283
+ if (args.value < BigInt(request.amountUnits)) {
284
+ continue;
285
+ }
286
+ return {
287
+ from: args.from,
288
+ to: args.to,
289
+ value: args.value,
290
+ };
291
+ }
292
+ return null;
293
+ }
294
+ function getMatchingMemoLog(memoLog, request) {
295
+ const txHash = memoLog.transactionHash;
296
+ const args = memoLog.args;
297
+ if (!txHash || !hasCompleteMemoArgs(args)) {
298
+ return null;
299
+ }
300
+ if (!memoArgsMatchRequest(args, request)) {
301
+ return null;
302
+ }
303
+ return {
304
+ txHash,
305
+ blockNumber: memoLog.blockNumber ?? undefined,
306
+ args,
307
+ };
308
+ }
309
+ function hasCompleteMemoArgs(args) {
310
+ return Boolean(args?.sender && args.target && args.callDataHash && args.memoId);
311
+ }
312
+ function memoArgsMatchRequest(args, request) {
313
+ return (sameAddress(args.target, request.target) &&
314
+ args.memoId.toLowerCase() === request.memoId.toLowerCase() &&
315
+ args.callDataHash.toLowerCase() === request.callDataHash.toLowerCase());
316
+ }
317
+ function minBigInt(a, b) {
318
+ return a < b ? a : b;
319
+ }
320
+ function sameAddress(a, b) {
321
+ return getAddress(a) === getAddress(b);
322
+ }
323
+ //# sourceMappingURL=watcher.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/receipts/watcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,IAAI,EACJ,YAAY,EACZ,cAAc,GAGf,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,iCAAiC,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAqB,MAAM,YAAY,CAAC;AAQvE,MAAM,UAAU,GAAG,YAAY,CAC7B,oIAAoI,CACrI,CAAC;AAuEF,MAAM,OAAO,cAAc;IACR,MAAM,CAAsB;IAC5B,WAAW,CAAgB;IAC3B,MAAM,CAAuB;IAC7B,aAAa,CAAS;IACtB,cAAc,CAAS;IACvB,eAAe,CAAS;IACxB,aAAa,CAAS;IACtB,aAAa,CAAS;IACtB,aAAa,CAAS;IACtB,gBAAgB,CAAS;IACzB,SAAS,CAAU;IACnB,SAAS,CAAqC;IAC9C,OAAO,CAAmC;IAC1C,OAAO,CAAmC;IAC1C,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC7C,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,CAAkC;IAE/C,YAAY,MAA4B;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,MAAM;YACT,MAAM,CAAC,YAAY;gBACnB,kBAAkB,CAAC;oBACjB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC;iBACrD,CAAC,CAAC;QACL,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,KAAK,CAAC;QACrD,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,WAAW,CAAC,OAAO,CAAC;QACrE,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,IAAI,KAAK,CAAC,CAAC;QAC3D,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,GAAG,CAAC;QACvD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,IAAI,CAAC,aAAa,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAChF,IAAI,IAAI,CAAC,aAAa,GAAG,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACjF,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,YAAY,CAAC,OAAuB,EAAE,UAAkC,EAAE;QACxE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,cAAc,CAAC,SAAiB;QAC9B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,UAAW,EAAE,CAAC,CAAC;YACtE,IAAI,OAAO,KAAK,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CACb,4CAA4C,IAAI,CAAC,eAAe,SAAS,OAAO,EAAE,CACnF,CAAC;YACJ,CAAC;QACH,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QAC7E,MAAM,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACzF,MAAM,QAAQ,GAAqB,EAAE,CAAC;QAEtC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,MAAM,OAAO,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;YAClD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACzE,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,IAAI,SAAS,GAAG,SAAS,CAAC;YAC1B,OAAO,SAAS,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC;gBACxE,MAAM,IAAI,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,cAAc;oBACpB,SAAS,EAAE,SAAS;oBACpB,OAAO,EAAE,OAAO;oBAChB,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;iBACjC,CAAC,CAAC;gBAEH,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;gBACrF,QAAQ,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;gBAClC,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,CAAC,CAAC;gBACtD,SAAS,GAAG,OAAO,GAAG,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9E,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACjE,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC9C,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,OAAuB,EACvB,OAA2B,EAC3B,SAAiB,EACjB,OAAe;QAEf,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAClB,OAAO,EAAE,OAAO,CAAC,YAAY;YAC7B,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;YAChC,SAAS;YACT,OAAO;SACR,CAAC,CACH,CAAc,CAAC;QAEhB,MAAM,QAAQ,GAAqB,EAAE,CAAC;QAEtC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACrE,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,OAAuB,EACvB,OAA2B,EAC3B,OAAgB;QAEhB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,4BAA4B,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACpF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,mBAAmB;YACzB,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAC1C,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAC1D,CAAC;QACF,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,uBAAuB,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,YAAY,GAAG,iCAAiC,CAAC;YACrD,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,cAAc,EAAE,OAAO;YACvB,SAAS;SACV,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAoB;YAChC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;YAClD,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,YAAY;YACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;YACtB,QAAQ,EAAE;gBACR,MAAM,EAAE,qBAAqB;gBAC7B,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE;gBAC3C,WAAW,EAAE,YAAY,CAAC,WAAW;aACtC;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACtE,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzC,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACrF,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,4BAA4B,CACxC,SAAiB,EACjB,OAA2B,EAC3B,OAAgB;QAEhB,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC;YAClE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,OAAuB,EACvB,OAA2B,EAC3B,gBAAwB;QAExB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACtE,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;YACtD,OAAO,SAAS,CAAC,aAAa,CAAC;QACjC,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,IAAI,gBAAgB,CAAC;IAC5C,CAAC;IAEO,KAAK,CAAC,UAAU,CACtB,OAAuB,EACvB,OAA2B,EAC3B,aAAqB;QAErB,MAAM,kBAAkB,GACtB,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAEjD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC;YACvC,GAAG,EAAE,SAAS;YACd,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,aAAa,EAAE,kBAAkB;YACjC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,sBAAsB;YAC5B,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,SAAS;YACT,aAAa,EAAE,kBAAkB;SAClC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,SAAS,CAAI,SAA2B;QACpD,IAAI,SAAkB,CAAC;QACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC;gBACH,OAAO,MAAM,SAAS,EAAE,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,CAAC;gBAClB,IAAI,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,aAAa;oBAAE,MAAM;gBAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,GAAG,CAAC,IAAI,OAAO,CAAC;gBACzD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;gBAC9E,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QACD,MAAM,SAAS,CAAC;IAClB,CAAC;IAEO,YAAY,CAAC,OAAuB,EAAE,OAA2B;QACvE,OAAO,sBAAsB,CAAC;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,KAAmC;QACpD,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAEO,WAAW,CAAC,KAAc;QAChC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;CACF;AAED,SAAS,uBAAuB,CAC9B,IAAoB,EACpB,OAA2B,EAC3B,YAA2B;IAE3B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACjF,MAAM,UAAU,GAAG,cAAc,CAAC;QAChC,GAAG,EAAE,kBAAkB;QACvB,SAAS,EAAE,UAAU;QACrB,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IAEH,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,SAAS,CAAC,IAItB,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACvD,SAAS;QACX,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7C,SAAS;QACX,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAgB,EAAE,OAA2B;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1B,IAAI,CAAC,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,MAAM;QACN,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,SAAS;QAC7C,IAAI;KACL,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAqB;IAChD,OAAO,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAsB,EAAE,OAA2B;IAC/E,OAAO,CACL,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE;QAC1D,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,CACvE,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,CAAS,EAAE,CAAS;IACrC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,WAAW,CAAC,CAAgB,EAAE,CAAgB;IACrD,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC"}
@@ -0,0 +1,34 @@
1
+ /**
2
+ * Local in-memory inbox for signed Resvary Receipts webhooks.
3
+ */
4
+ import type { WebhookDeliveryAttempt, WebhookDeliveryStatus, WebhookEvent } from './types.js';
5
+ export interface ReceiveWebhookInput {
6
+ payload: WebhookEvent | string;
7
+ header: string;
8
+ secret: string;
9
+ target?: string;
10
+ now?: number;
11
+ receivedAt?: number;
12
+ toleranceSeconds?: number;
13
+ }
14
+ export interface ReplayWebhookInput {
15
+ event: WebhookEvent;
16
+ secret: string;
17
+ target?: string;
18
+ replayOf?: string;
19
+ timestamp?: number;
20
+ receivedAt?: number;
21
+ }
22
+ export interface WebhookDeliveryFilter {
23
+ eventId?: string;
24
+ status?: WebhookDeliveryStatus;
25
+ }
26
+ export declare class WebhookInbox {
27
+ private readonly deliveries;
28
+ receive(input: ReceiveWebhookInput): WebhookDeliveryAttempt;
29
+ replay(input: ReplayWebhookInput): WebhookDeliveryAttempt;
30
+ listDeliveries(filter?: WebhookDeliveryFilter): WebhookDeliveryAttempt[];
31
+ getDelivery(id: string): WebhookDeliveryAttempt | undefined;
32
+ private createDelivery;
33
+ }
34
+ //# sourceMappingURL=webhook-inbox.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webhook-inbox.d.ts","sourceRoot":"","sources":["../../src/receipts/webhook-inbox.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,EAEb,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgC;IAE3D,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,sBAAsB;IAyB3D,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,sBAAsB;IAkBzD,cAAc,CAAC,MAAM,GAAE,qBAA0B,GAAG,sBAAsB,EAAE;IAc5E,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAI3D,OAAO,CAAC,cAAc;CASvB"}
@@ -0,0 +1,101 @@
1
+ /**
2
+ * Local in-memory inbox for signed Resvary Receipts webhooks.
3
+ */
4
+ import { randomBytes } from 'node:crypto';
5
+ import { signWebhookEvent, verifyWebhookSignature } from './webhooks.js';
6
+ export class WebhookInbox {
7
+ deliveries = [];
8
+ receive(input) {
9
+ const event = parseWebhookPayload(input.payload);
10
+ const verified = verifyWebhookSignature({
11
+ payload: input.payload,
12
+ header: input.header,
13
+ secret: input.secret,
14
+ now: input.now,
15
+ toleranceSeconds: input.toleranceSeconds,
16
+ });
17
+ const delivery = this.createDelivery({
18
+ eventId: event.eventId,
19
+ eventType: event.eventType,
20
+ status: verified ? 'verified' : 'failed',
21
+ verified,
22
+ signatureHeader: input.header,
23
+ receivedAt: input.receivedAt ?? Date.now(),
24
+ target: input.target,
25
+ error: verified ? undefined : 'Webhook signature verification failed',
26
+ });
27
+ this.deliveries.push(delivery);
28
+ return delivery;
29
+ }
30
+ replay(input) {
31
+ const signature = signWebhookEvent(input.event, input.secret, input.timestamp);
32
+ const delivery = this.createDelivery({
33
+ eventId: input.event.id,
34
+ eventType: input.event.type,
35
+ status: 'verified',
36
+ verified: true,
37
+ signatureHeader: signature.header,
38
+ receivedAt: input.receivedAt ?? Date.now(),
39
+ target: input.target,
40
+ replayOf: input.replayOf,
41
+ });
42
+ this.deliveries.push(delivery);
43
+ return delivery;
44
+ }
45
+ listDeliveries(filter = {}) {
46
+ return this.deliveries.filter((delivery) => {
47
+ if (filter.eventId && delivery.eventId !== filter.eventId) {
48
+ return false;
49
+ }
50
+ if (filter.status && delivery.status !== filter.status) {
51
+ return false;
52
+ }
53
+ return true;
54
+ });
55
+ }
56
+ getDelivery(id) {
57
+ return this.deliveries.find((delivery) => delivery.id === id);
58
+ }
59
+ createDelivery(input) {
60
+ const attempt = this.deliveries.filter((delivery) => delivery.eventId === input.eventId).length + 1;
61
+ return {
62
+ id: `dlv_${randomBytes(12).toString('hex')}`,
63
+ attempt,
64
+ ...input,
65
+ };
66
+ }
67
+ }
68
+ function parseWebhookPayload(payload) {
69
+ const event = typeof payload === 'string'
70
+ ? parseJson(payload)
71
+ : payload;
72
+ if (!isWebhookEventLike(event)) {
73
+ return {
74
+ eventId: 'unknown',
75
+ eventType: 'unknown',
76
+ };
77
+ }
78
+ return {
79
+ eventId: event.id,
80
+ eventType: event.type,
81
+ };
82
+ }
83
+ function parseJson(value) {
84
+ try {
85
+ return JSON.parse(value);
86
+ }
87
+ catch {
88
+ return null;
89
+ }
90
+ }
91
+ function isWebhookEventLike(value) {
92
+ if (!value || typeof value !== 'object') {
93
+ return false;
94
+ }
95
+ const event = value;
96
+ return typeof event.id === 'string'
97
+ && typeof event.type === 'string'
98
+ && typeof event.createdAt === 'number'
99
+ && 'data' in event;
100
+ }
101
+ //# sourceMappingURL=webhook-inbox.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webhook-inbox.js","sourceRoot":"","sources":["../../src/receipts/webhook-inbox.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ import { WebhookInbox } from './webhook-inbox.js';
2
+ import { PersistentWebhookInbox } from './persistent-webhook-inbox.js';
3
+ import type { ReceiptStore } from './store.js';
4
+ import type { WebhookDeliveryAttempt } from './types.js';
5
+ export interface WebhookRouteHandlerConfig {
6
+ secret: string;
7
+ target?: string;
8
+ inbox?: WebhookInbox | PersistentWebhookInbox;
9
+ store?: ReceiptStore;
10
+ toleranceSeconds?: number;
11
+ }
12
+ export type WebhookRouteResult = {
13
+ ok: true;
14
+ delivery: WebhookDeliveryAttempt;
15
+ } | {
16
+ ok: false;
17
+ error: string;
18
+ reason: 'missing_signature' | 'signature_verification_failed';
19
+ delivery?: WebhookDeliveryAttempt;
20
+ };
21
+ export declare function createWebhookRouteHandler(config: WebhookRouteHandlerConfig): (request: Request) => Promise<Response>;
22
+ //# sourceMappingURL=webhook-route.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webhook-route.d.ts","sourceRoot":"","sources":["../../src/receipts/webhook-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,GAAG,sBAAsB,CAAC;IAC9C,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,kBAAkB,GAC1B;IACE,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,sBAAsB,CAAC;CAClC,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,GAAG,+BAA+B,CAAC;IAC9D,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC,CAAC;AAEN,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,IACrC,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CA0CzE"}
@@ -0,0 +1,37 @@
1
+ import { WebhookInbox } from './webhook-inbox.js';
2
+ import { PersistentWebhookInbox } from './persistent-webhook-inbox.js';
3
+ export function createWebhookRouteHandler(config) {
4
+ return async function handleWebhook(request) {
5
+ const payload = await request.text();
6
+ const header = request.headers.get('x-resvary-signature');
7
+ if (!header) {
8
+ return Response.json({
9
+ ok: false,
10
+ error: 'Missing x-resvary-signature header',
11
+ reason: 'missing_signature',
12
+ }, { status: 400 });
13
+ }
14
+ const inbox = config.inbox
15
+ ?? (config.store ? new PersistentWebhookInbox({ store: config.store }) : new WebhookInbox());
16
+ const delivery = await inbox.receive({
17
+ payload,
18
+ header,
19
+ secret: config.secret,
20
+ target: config.target,
21
+ toleranceSeconds: config.toleranceSeconds,
22
+ });
23
+ if (!delivery.verified) {
24
+ return Response.json({
25
+ ok: false,
26
+ error: delivery.error ?? 'Webhook signature verification failed',
27
+ reason: 'signature_verification_failed',
28
+ delivery,
29
+ }, { status: 400 });
30
+ }
31
+ return Response.json({
32
+ ok: true,
33
+ delivery,
34
+ });
35
+ };
36
+ }
37
+ //# sourceMappingURL=webhook-route.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webhook-route.js","sourceRoot":"","sources":["../../src/receipts/webhook-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAwBvE,MAAM,UAAU,yBAAyB,CAAC,MAAiC;IACzE,OAAO,KAAK,UAAU,aAAa,CAAC,OAAgB;QAClD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QAE1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,QAAQ,CAAC,IAAI,CAClB;gBACE,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,oCAAoC;gBAC3C,MAAM,EAAE,mBAAmB;aACC,EAC9B,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK;eACrB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,sBAAsB,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;QAC/F,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC;YACnC,OAAO;YACP,MAAM;YACN,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;SAC1C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACvB,OAAO,QAAQ,CAAC,IAAI,CAClB;gBACE,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,uCAAuC;gBAChE,MAAM,EAAE,+BAA+B;gBACvC,QAAQ;aACoB,EAC9B,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACnB,EAAE,EAAE,IAAI;YACR,QAAQ;SACoB,CAAC,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC"}