@fantastic.dev/better-stripe 0.44.0 → 0.45.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.
package/CHANGELOG.md CHANGED
@@ -26,6 +26,34 @@
26
26
  - Remove internal tracker references from public documentation and add a
27
27
  regression check that prevents their reintroduction.
28
28
 
29
+ ## [0.45.1](https://github.com/FantasticDevHQ/better-stripe/compare/v0.45.0...v0.45.1) (2026-10-17)
30
+
31
+ ### Tests
32
+
33
+ - verify cross-domain durable execution invariants ([392080f](https://github.com/FantasticDevHQ/better-stripe/commit/392080f5d166ad731864ac0db4897fe6a1b7de63))
34
+ - verify cross-domain durable execution invariants ([c814519](https://github.com/FantasticDevHQ/better-stripe/commit/c8145194ac0b9fb51b92109ffd2d6be5cf44488f))
35
+
36
+ ## [0.45.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.44.0...v0.45.0) (2026-10-17)
37
+
38
+ ### Features
39
+
40
+ - migrate example recovery to component workflows ([13ca8ea](https://github.com/FantasticDevHQ/better-stripe/commit/13ca8ea48a9f014838dad56f5bcf04300f4bba5e))
41
+ - migrate example recovery to component workflows ([a60dd5a](https://github.com/FantasticDevHQ/better-stripe/commit/a60dd5a18869feb5dd9906333cabe8dcf11be53d))
42
+
43
+ ### Bug Fixes
44
+
45
+ - preserve affiliate offsets and fence direct recovery payouts ([782264c](https://github.com/FantasticDevHQ/better-stripe/commit/782264c1d55c4177607ebd76f4fa83266900956f))
46
+
47
+ ### Documentation
48
+
49
+ - fix balance-funding preview configuration ([bc427aa](https://github.com/FantasticDevHQ/better-stripe/commit/bc427aa8d89b700481725efd391eab187c5118dc))
50
+
51
+ ### Tests
52
+
53
+ - ratchet recovery migration coverage floors ([4e79b74](https://github.com/FantasticDevHQ/better-stripe/commit/4e79b74468bab0dfc3020f6ce99a03edb738018b))
54
+ - run commission regressions through nested recovery workflows ([7343bd2](https://github.com/FantasticDevHQ/better-stripe/commit/7343bd2f7dec240f5c7c3b85b1722e2d80e72b36))
55
+ - verify bounded invoice proof and isolate provider fixtures ([39c3ae3](https://github.com/FantasticDevHQ/better-stripe/commit/39c3ae33ba8189d54e1a926deca0cb4ec74c11ae))
56
+
29
57
  ## [0.44.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.43.0...v0.44.0) (2026-10-17)
30
58
 
31
59
  ### Features
package/README.md CHANGED
@@ -70,7 +70,7 @@ claim execution are completed.
70
70
 
71
71
  ## Status
72
72
 
73
- **Version**: `0.44.0` <!-- x-release-please-version --> (pre-1.0). API may change between minor versions until 1.0.
73
+ **Version**: `0.45.1` <!-- x-release-please-version --> (pre-1.0). API may change between minor versions until 1.0.
74
74
 
75
75
  Used in production by its authors. Webhook pipeline is covered by unit tests and a live E2E harness (`npm run e2e:webhooks`) that fires real Stripe-signed events and asserts the ledger.
76
76
 
@@ -11,8 +11,8 @@ type InvoiceReceipt = {
11
11
  };
12
12
  type BindInvoiceItem = (invoiceItemId: string) => Promise<RecoveryGroup>;
13
13
  /** Attachment always produces an item; reconciliation can release an unbound void invoice. */
14
- export declare function attachRecoveryInvoice(stripe: Stripe, group: RecoveryGroup | null, opts: RecoveryInvoiceOptions, bind: BindInvoiceItem, create?: true, maxItems?: number, historyBounds?: ProcessingCostHistoryBounds): Promise<InvoiceReceipt>;
15
- export declare function attachRecoveryInvoice(stripe: Stripe, group: RecoveryGroup | null, opts: RecoveryInvoiceOptions, bind: BindInvoiceItem, create: false, maxItems?: number, historyBounds?: ProcessingCostHistoryBounds): Promise<InvoiceReceipt | (Omit<InvoiceReceipt, "invoiceItemId"> & {
14
+ export declare function attachRecoveryInvoice(stripe: Stripe, group: RecoveryGroup | null, opts: RecoveryInvoiceOptions, bind: BindInvoiceItem, create?: true, maxItems?: number, historyBounds?: ProcessingCostHistoryBounds, readOnly?: boolean): Promise<InvoiceReceipt>;
15
+ export declare function attachRecoveryInvoice(stripe: Stripe, group: RecoveryGroup | null, opts: RecoveryInvoiceOptions, bind: BindInvoiceItem, create: false, maxItems?: number, historyBounds?: ProcessingCostHistoryBounds, readOnly?: boolean): Promise<InvoiceReceipt | (Omit<InvoiceReceipt, "invoiceItemId"> & {
16
16
  invoiceItemId: null;
17
17
  })>;
18
18
  /** Refuse ambiguous cash/credit or multi-payment allocations instead of inventing economics. */
@@ -1 +1 @@
1
- {"version":3,"file":"costRecovery-invoices.d.ts","sourceRoot":"","sources":["../../src/client/costRecovery-invoices.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,uCAAuC,CAAC;AAG/C,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACtE,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAK1E,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;CACzC,CAAC;AACF,KAAK,eAAe,GAAG,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAEzE,8FAA8F;AAC9F,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,IAAI,EAAE,sBAAsB,EAC5B,IAAI,EAAE,eAAe,EACrB,MAAM,CAAC,EAAE,IAAI,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,2BAA2B,GAC1C,OAAO,CAAC,cAAc,CAAC,CAAC;AAC3B,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,IAAI,EAAE,sBAAsB,EAC5B,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,KAAK,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,2BAA2B,GAC1C,OAAO,CACN,cAAc,GACd,CAAC,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG;IAAE,aAAa,EAAE,IAAI,CAAA;CAAE,CAAC,CACpE,CAAC;AAgHF,gGAAgG;AAChG,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;YAyB/D,WAAW;YACX,qCAAqC;GAYlD"}
1
+ {"version":3,"file":"costRecovery-invoices.d.ts","sourceRoot":"","sources":["../../src/client/costRecovery-invoices.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,uCAAuC,CAAC;AAG/C,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACtE,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAK1E,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;CACzC,CAAC;AACF,KAAK,eAAe,GAAG,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAEzE,8FAA8F;AAC9F,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,IAAI,EAAE,sBAAsB,EAC5B,IAAI,EAAE,eAAe,EACrB,MAAM,CAAC,EAAE,IAAI,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,2BAA2B,EAC3C,QAAQ,CAAC,EAAE,OAAO,GACjB,OAAO,CAAC,cAAc,CAAC,CAAC;AAC3B,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,IAAI,EAAE,sBAAsB,EAC5B,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,KAAK,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,2BAA2B,EAC3C,QAAQ,CAAC,EAAE,OAAO,GACjB,OAAO,CACN,cAAc,GACd,CAAC,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG;IAAE,aAAa,EAAE,IAAI,CAAA;CAAE,CAAC,CACpE,CAAC;AA0HF,gGAAgG;AAChG,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;YAyB/D,WAAW;YACX,qCAAqC;GAYlD"}
@@ -4,7 +4,9 @@ import { getProcessingCostContext } from "./settlement/processingCosts.js";
4
4
  const marker = "bsRecoveryGroup";
5
5
  const id = (value) => typeof value === "string" ? value : value?.id;
6
6
  /** One immutable item per sealed group. Host serializes provider operations per group. */
7
- export async function attachRecoveryInvoice(stripe, group, opts, bind, create = true, maxItems = Number.POSITIVE_INFINITY, historyBounds) {
7
+ export async function attachRecoveryInvoice(stripe, group, opts, bind, create = true, maxItems = Number.POSITIVE_INFINITY, historyBounds, readOnly = false) {
8
+ if (readOnly && create)
9
+ throw new Error("Read-only verification cannot create invoice items.");
8
10
  if (!group ||
9
11
  group.groupKey !== opts.groupKey ||
10
12
  group.sourceKind !== "invoice" ||
@@ -16,7 +18,8 @@ export async function attachRecoveryInvoice(stripe, group, opts, bind, create =
16
18
  (create && ["released", "releasing"].includes(group.status)))
17
19
  throw new Error("Invoice recovery group must be sealed and active.");
18
20
  const invoice = await stripe.invoices.retrieve(group.sourceId);
19
- if (invoice.id !== group.sourceId ||
21
+ if ((readOnly && invoice.object !== "invoice") ||
22
+ invoice.id !== group.sourceId ||
20
23
  invoice.customer_account !== group.accountId)
21
24
  throw new Error("Recovery invoice ownership does not match.");
22
25
  if (invoice.currency !== group.currency)
@@ -37,7 +40,9 @@ export async function attachRecoveryInvoice(stripe, group, opts, bind, create =
37
40
  continue;
38
41
  if (found)
39
42
  throw new Error("Duplicate recovery invoice items require reconciliation.");
40
- if (id(item.invoice) !== invoice.id ||
43
+ if ((readOnly &&
44
+ (item.object !== "invoiceitem" || item.discountable !== false)) ||
45
+ id(item.invoice) !== invoice.id ||
41
46
  item.customer_account !== group.accountId ||
42
47
  item.currency !== group.currency ||
43
48
  item.amount !== group.amount ||
@@ -69,6 +74,8 @@ export async function attachRecoveryInvoice(stripe, group, opts, bind, create =
69
74
  metadata: { [marker]: group._id },
70
75
  }, { idempotencyKey: `better-stripe:recovery:${group._id}` });
71
76
  }
77
+ if (readOnly && group.invoiceItemId !== found.id)
78
+ throw new Error("Read-only verification requires an existing item binding.");
72
79
  const bound = group.invoiceItemId === found.id ? group : await bind(found.id);
73
80
  return {
74
81
  group: bound,
@@ -1 +1 @@
1
- {"version":3,"file":"costRecovery-invoices.js","sourceRoot":"","sources":["../../src/client/costRecovery-invoices.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"costRecovery-invoices.js","sourceRoot":"","sources":["../../src/client/costRecovery-invoices.ts"],"names":[],"mappings":"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"}
@@ -110,6 +110,20 @@ export declare class CostRecoveryClient extends ProcessingCostReconciliationClie
110
110
  invoiceItemId: string;
111
111
  invoiceStatus: Stripe.Invoice["status"];
112
112
  }>;
113
+ /** Read-only legacy proof. Hard caps require complete history; never bind, finish or create. */
114
+ verifyInvoiceReceipt(ctx: RunCtx, opts: RecoveryScope & {
115
+ groupKey: string;
116
+ }): Promise<{
117
+ status: "unknown";
118
+ reason: "history_incomplete";
119
+ retryable: false;
120
+ } | {
121
+ status: "ready";
122
+ outcome: "collect" | "release";
123
+ group: RecoveryGroup;
124
+ invoiceItemId: string;
125
+ invoiceStatus: Stripe.Invoice["status"];
126
+ }>;
113
127
  /** Re-read Stripe; keep unpaid items reserved. Repeat until isDone after terminal outcomes. */
114
128
  reconcileInvoice(ctx: RunCtx, opts: RecoveryScope & {
115
129
  groupKey: string;
@@ -1 +1 @@
1
- {"version":3,"file":"costRecovery.d.ts","sourceRoot":"","sources":["../../src/client/costRecovery.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"costRecovery.d.ts","sourceRoot":"","sources":["../../src/client/costRecovery.ts"],"names":[],"mappings":"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"}
@@ -27,6 +27,38 @@ export class CostRecoveryClient extends ProcessingCostReconciliationClient {
27
27
  invoiceItemId,
28
28
  }));
29
29
  }
30
+ /** Read-only legacy proof. Hard caps require complete history; never bind, finish or create. */
31
+ async verifyInvoiceReceipt(ctx, opts) {
32
+ const unknown = {
33
+ status: "unknown",
34
+ reason: "history_incomplete",
35
+ retryable: false,
36
+ };
37
+ try {
38
+ if (!this.provider)
39
+ return unknown;
40
+ const group = await this.getGroup(ctx, { groupKey: opts.groupKey });
41
+ if (!group?.invoiceItemId)
42
+ return unknown;
43
+ const receipt = await attachRecoveryInvoice(this.provider(), group, opts, async () => {
44
+ throw new Error("Read-only invoice verification cannot bind.");
45
+ }, false, 500, { maxPages: 5, maxItems: 500 }, true);
46
+ if (!receipt.invoiceItemId ||
47
+ !["paid", "void"].includes(receipt.invoiceStatus ?? ""))
48
+ return unknown;
49
+ return {
50
+ status: "ready",
51
+ ...receipt,
52
+ outcome: receipt.invoiceStatus === "paid"
53
+ ? "collect"
54
+ : "release",
55
+ };
56
+ }
57
+ catch {
58
+ // Provider failures and malformed/incomplete evidence never authorize a financial transition.
59
+ return unknown;
60
+ }
61
+ }
30
62
  /** Re-read Stripe; keep unpaid items reserved. Repeat until isDone after terminal outcomes. */
31
63
  async reconcileInvoice(ctx, opts) {
32
64
  if (!this.provider)
@@ -1 +1 @@
1
- {"version":3,"file":"costRecovery.js","sourceRoot":"","sources":["../../src/client/costRecovery.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"costRecovery.js","sourceRoot":"","sources":["../../src/client/costRecovery.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fantastic.dev/better-stripe",
3
- "version": "0.44.0",
3
+ "version": "0.45.1",
4
4
  "description": "A Convex component for Stripe V2 Accounts API integration.",
5
5
  "keywords": [
6
6
  "stripe",
@@ -0,0 +1,140 @@
1
+ import Stripe from "stripe";
2
+ import { componentsGeneric } from "convex/server";
3
+ import { expect, it, vi } from "vitest";
4
+ import { CostRecoveryClient, type RecoveryGroup } from "./costRecovery.js";
5
+ import type { Component, RunCtx } from "./helpers.js";
6
+
7
+ const scope = {
8
+ accountId: "acct_owner",
9
+ scopeKey: "store",
10
+ currency: "usd",
11
+ groupKey: "invoice:in_1",
12
+ };
13
+ async function fixture(mode: string) {
14
+ const group = {
15
+ ...scope,
16
+ _id: "group_1",
17
+ _creationTime: 0,
18
+ sourceKind: "invoice",
19
+ sourceId: "in_1",
20
+ status: "collecting",
21
+ amount: 11,
22
+ pendingOperations: 10,
23
+ maxDebit: 1000,
24
+ maxCredit: 1000,
25
+ invoiceItemId: "ii_original",
26
+ } as RecoveryGroup;
27
+ const requests: { method: string; url: string }[] = [];
28
+ const sdk = new Stripe("sk_test_receipt_fixture", {
29
+ maxNetworkRetries: 0,
30
+ httpClient: Stripe.createFetchHttpClient(async (url, init) => {
31
+ requests.push({ method: init?.method ?? "GET", url: String(url) });
32
+ const path = new URL(String(url));
33
+ const item = {
34
+ id: mode === "identity" ? "ii_foreign" : "ii_original",
35
+ object: mode === "malformed" ? "wrong" : "invoiceitem",
36
+ invoice: "in_1",
37
+ customer_account: "acct_owner",
38
+ currency: "usd",
39
+ amount: mode === "amount" ? 12 : 11,
40
+ discountable: false,
41
+ metadata: { bsRecoveryGroup: "group_1" },
42
+ };
43
+ const data = path.pathname.startsWith("/v1/invoices/")
44
+ ? {
45
+ id: "in_1",
46
+ object: "invoice",
47
+ customer_account: "acct_owner",
48
+ currency: "usd",
49
+ status:
50
+ mode === "pending" ? "open" : mode === "void" ? "void" : "paid",
51
+ }
52
+ : {
53
+ object: "list",
54
+ has_more: mode === "incomplete",
55
+ data:
56
+ mode === "incomplete"
57
+ ? Array.from({ length: 100 }, (_, i) => ({
58
+ id: `ii_${requests.length}_${i}`,
59
+ metadata: {},
60
+ }))
61
+ : mode === "duplicate"
62
+ ? [item, { ...item, id: "ii_duplicate" }]
63
+ : [item],
64
+ };
65
+ return new Response(JSON.stringify(data), {
66
+ status: 200,
67
+ headers: { "Content-Type": "application/json" },
68
+ });
69
+ }),
70
+ });
71
+ const runMutation = vi.fn(() => {
72
+ throw new Error("Verifier must not mutate");
73
+ });
74
+ const ctx = { runQuery: async () => group, runMutation } as unknown as RunCtx;
75
+ const client = new CostRecoveryClient(
76
+ componentsGeneric().betterStripe as unknown as Component,
77
+ () => sdk,
78
+ );
79
+ return { client, ctx, requests, runMutation, group };
80
+ }
81
+ it("verifies an exact terminal invoice receipt with GETs only and no ledger or binding writes", async () => {
82
+ const f = await fixture("ready");
83
+ expect(await f.client.verifyInvoiceReceipt(f.ctx, scope)).toMatchObject({
84
+ status: "ready",
85
+ outcome: "collect",
86
+ invoiceItemId: "ii_original",
87
+ invoiceStatus: "paid",
88
+ group: { status: "collecting", amount: 11 },
89
+ });
90
+ expect(f.runMutation).not.toHaveBeenCalled();
91
+ expect(f.requests.map((r) => r.method)).toEqual(["GET", "GET"]);
92
+ });
93
+ it.each([
94
+ "identity",
95
+ "amount",
96
+ "duplicate",
97
+ "incomplete",
98
+ "pending",
99
+ "malformed",
100
+ ])("fails closed for %s receipts without writes", async (mode) => {
101
+ const f = await fixture(mode);
102
+ expect(await f.client.verifyInvoiceReceipt(f.ctx, scope)).toMatchObject({
103
+ status: "unknown",
104
+ reason: "history_incomplete",
105
+ retryable: false,
106
+ });
107
+ expect(f.runMutation).not.toHaveBeenCalled();
108
+ expect(f.requests.every((r) => r.method === "GET")).toBe(true);
109
+ expect(f.requests.length).toBeLessThanOrEqual(6);
110
+ if (mode === "incomplete") expect(f.requests.length).toBe(6);
111
+ });
112
+ it("rejects an unauthorized scope before provider I/O", async () => {
113
+ const f = await fixture("ready");
114
+ expect(
115
+ await f.client.verifyInvoiceReceipt(f.ctx, {
116
+ ...scope,
117
+ accountId: "acct_other",
118
+ }),
119
+ ).toMatchObject({ status: "unknown" });
120
+ expect(f.requests).toHaveLength(0);
121
+ });
122
+
123
+ it("verifies a void receipt without deciding a financial release", async () => {
124
+ const f = await fixture("void");
125
+ expect(await f.client.verifyInvoiceReceipt(f.ctx, scope)).toMatchObject({
126
+ status: "ready",
127
+ outcome: "release",
128
+ invoiceStatus: "void",
129
+ group: { status: "collecting" },
130
+ });
131
+ expect(f.runMutation).not.toHaveBeenCalled();
132
+ });
133
+ it("leaves an unbound group unknown before provider I/O", async () => {
134
+ const f = await fixture("ready");
135
+ delete f.group.invoiceItemId;
136
+ expect(await f.client.verifyInvoiceReceipt(f.ctx, scope)).toMatchObject({
137
+ status: "unknown",
138
+ });
139
+ expect(f.requests).toHaveLength(0);
140
+ });
@@ -27,6 +27,7 @@ export function attachRecoveryInvoice(
27
27
  create?: true,
28
28
  maxItems?: number,
29
29
  historyBounds?: ProcessingCostHistoryBounds,
30
+ readOnly?: boolean,
30
31
  ): Promise<InvoiceReceipt>;
31
32
  export function attachRecoveryInvoice(
32
33
  stripe: Stripe,
@@ -36,6 +37,7 @@ export function attachRecoveryInvoice(
36
37
  create: false,
37
38
  maxItems?: number,
38
39
  historyBounds?: ProcessingCostHistoryBounds,
40
+ readOnly?: boolean,
39
41
  ): Promise<
40
42
  | InvoiceReceipt
41
43
  | (Omit<InvoiceReceipt, "invoiceItemId"> & { invoiceItemId: null })
@@ -50,7 +52,10 @@ export async function attachRecoveryInvoice(
50
52
  create = true,
51
53
  maxItems = Number.POSITIVE_INFINITY,
52
54
  historyBounds?: ProcessingCostHistoryBounds,
55
+ readOnly = false,
53
56
  ) {
57
+ if (readOnly && create)
58
+ throw new Error("Read-only verification cannot create invoice items.");
54
59
  if (
55
60
  !group ||
56
61
  group.groupKey !== opts.groupKey ||
@@ -69,6 +74,7 @@ export async function attachRecoveryInvoice(
69
74
  throw new Error("Invoice recovery group must be sealed and active.");
70
75
  const invoice = await stripe.invoices.retrieve(group.sourceId);
71
76
  if (
77
+ (readOnly && invoice.object !== "invoice") ||
72
78
  invoice.id !== group.sourceId ||
73
79
  invoice.customer_account !== group.accountId
74
80
  )
@@ -97,6 +103,8 @@ export async function attachRecoveryInvoice(
97
103
  "Duplicate recovery invoice items require reconciliation.",
98
104
  );
99
105
  if (
106
+ (readOnly &&
107
+ (item.object !== "invoiceitem" || item.discountable !== false)) ||
100
108
  id(item.invoice) !== invoice.id ||
101
109
  item.customer_account !== group.accountId ||
102
110
  item.currency !== group.currency ||
@@ -143,6 +151,10 @@ export async function attachRecoveryInvoice(
143
151
  { idempotencyKey: `better-stripe:recovery:${group._id}` },
144
152
  );
145
153
  }
154
+ if (readOnly && group.invoiceItemId !== found.id)
155
+ throw new Error(
156
+ "Read-only verification requires an existing item binding.",
157
+ );
146
158
  const bound = group.invoiceItemId === found.id ? group : await bind(found.id);
147
159
  return {
148
160
  group: bound,
@@ -145,6 +145,50 @@ export class CostRecoveryClient extends ProcessingCostReconciliationClient {
145
145
  }),
146
146
  );
147
147
  }
148
+ /** Read-only legacy proof. Hard caps require complete history; never bind, finish or create. */
149
+ async verifyInvoiceReceipt(
150
+ ctx: RunCtx,
151
+ opts: RecoveryScope & { groupKey: string },
152
+ ) {
153
+ const unknown = {
154
+ status: "unknown" as const,
155
+ reason: "history_incomplete" as const,
156
+ retryable: false as const,
157
+ };
158
+ try {
159
+ if (!this.provider) return unknown;
160
+ const group = await this.getGroup(ctx, { groupKey: opts.groupKey });
161
+ if (!group?.invoiceItemId) return unknown;
162
+ const receipt = await attachRecoveryInvoice(
163
+ this.provider(),
164
+ group,
165
+ opts,
166
+ async () => {
167
+ throw new Error("Read-only invoice verification cannot bind.");
168
+ },
169
+ false,
170
+ 500,
171
+ { maxPages: 5, maxItems: 500 },
172
+ true,
173
+ );
174
+ if (
175
+ !receipt.invoiceItemId ||
176
+ !["paid", "void"].includes(receipt.invoiceStatus ?? "")
177
+ )
178
+ return unknown;
179
+ return {
180
+ status: "ready" as const,
181
+ ...receipt,
182
+ outcome:
183
+ receipt.invoiceStatus === "paid"
184
+ ? ("collect" as const)
185
+ : ("release" as const),
186
+ };
187
+ } catch {
188
+ // Provider failures and malformed/incomplete evidence never authorize a financial transition.
189
+ return unknown;
190
+ }
191
+ }
148
192
  /** Re-read Stripe; keep unpaid items reserved. Repeat until isDone after terminal outcomes. */
149
193
  async reconcileInvoice(
150
194
  ctx: RunCtx,