@fantastic.dev/better-stripe 0.98.0 → 0.100.0

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 (96) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +1 -1
  3. package/dist/client/billing/renewalAttach/internal/acquisition/ownedAcquisition.d.ts +6 -0
  4. package/dist/client/billing/renewalAttach/internal/acquisition/ownedAcquisition.d.ts.map +1 -1
  5. package/dist/client/billing/renewalAttach/internal/acquisition/ownedAcquisition.js +1 -1
  6. package/dist/client/billing/renewalAttach/internal/acquisition/ownedAcquisition.js.map +1 -1
  7. package/dist/client/billing/renewalAttach/internal/c10/attachEvents.d.ts +22 -0
  8. package/dist/client/billing/renewalAttach/internal/c10/attachEvents.d.ts.map +1 -1
  9. package/dist/client/billing/renewalAttach/internal/c10/attachEvents.js +13 -5
  10. package/dist/client/billing/renewalAttach/internal/c10/attachEvents.js.map +1 -1
  11. package/dist/client/billing/renewalAttach/internal/operations/actorFailureControl.d.ts +17 -0
  12. package/dist/client/billing/renewalAttach/internal/operations/actorFailureControl.d.ts.map +1 -0
  13. package/dist/client/billing/renewalAttach/internal/operations/actorFailureControl.js +140 -0
  14. package/dist/client/billing/renewalAttach/internal/operations/actorFailureControl.js.map +1 -0
  15. package/dist/client/billing/renewalAttach/internal/operations/fixedTransport.d.ts +9 -11
  16. package/dist/client/billing/renewalAttach/internal/operations/fixedTransport.d.ts.map +1 -1
  17. package/dist/client/billing/renewalAttach/internal/operations/fixedTransport.js +3 -380
  18. package/dist/client/billing/renewalAttach/internal/operations/fixedTransport.js.map +1 -1
  19. package/dist/client/billing/renewalAttach/internal/operations/initialAttach.d.ts +146 -0
  20. package/dist/client/billing/renewalAttach/internal/operations/initialAttach.d.ts.map +1 -1
  21. package/dist/client/billing/renewalAttach/internal/operations/initialAttach.js +90 -139
  22. package/dist/client/billing/renewalAttach/internal/operations/initialAttach.js.map +1 -1
  23. package/dist/client/billing/renewalAttach/internal/operations/transportKernel.d.ts +63 -0
  24. package/dist/client/billing/renewalAttach/internal/operations/transportKernel.d.ts.map +1 -0
  25. package/dist/client/billing/renewalAttach/internal/operations/transportKernel.js +380 -0
  26. package/dist/client/billing/renewalAttach/internal/operations/transportKernel.js.map +1 -0
  27. package/dist/client/billing/renewalAttach/internal/producer/attachAcknowledgement.d.ts +10 -0
  28. package/dist/client/billing/renewalAttach/internal/producer/attachAcknowledgement.d.ts.map +1 -0
  29. package/dist/client/billing/renewalAttach/internal/producer/attachAcknowledgement.js +49 -0
  30. package/dist/client/billing/renewalAttach/internal/producer/attachAcknowledgement.js.map +1 -0
  31. package/dist/client/billing/renewalAttach/internal/producer/invocationProducer.d.ts +4 -0
  32. package/dist/client/billing/renewalAttach/internal/producer/invocationProducer.d.ts.map +1 -1
  33. package/dist/client/billing/renewalAttach/internal/producer/invocationProducer.js +12 -0
  34. package/dist/client/billing/renewalAttach/internal/producer/invocationProducer.js.map +1 -1
  35. package/dist/client/billing/renewalAttach/internal/producer/journalWorkFactory.d.ts +56 -0
  36. package/dist/client/billing/renewalAttach/internal/producer/journalWorkFactory.d.ts.map +1 -0
  37. package/dist/client/billing/renewalAttach/internal/producer/journalWorkFactory.js +49 -0
  38. package/dist/client/billing/renewalAttach/internal/producer/journalWorkFactory.js.map +1 -0
  39. package/dist/client/billing/renewalAttach/internal/producer/operationFactory.d.ts +1 -1
  40. package/dist/client/billing/renewalAttach/internal/producer/operationFactory.d.ts.map +1 -1
  41. package/dist/client/billing/renewalAttach/internal/producer/operationFactory.js +3 -2
  42. package/dist/client/billing/renewalAttach/internal/producer/operationFactory.js.map +1 -1
  43. package/dist/client/billing/renewalAttach/internal/producer/recoveryEntry.d.ts +13 -0
  44. package/dist/client/billing/renewalAttach/internal/producer/recoveryEntry.d.ts.map +1 -0
  45. package/dist/client/billing/renewalAttach/internal/producer/recoveryEntry.js +109 -0
  46. package/dist/client/billing/renewalAttach/internal/producer/recoveryEntry.js.map +1 -0
  47. package/dist/client/billing/renewalAttach/internal/producer/recoveryFactory.d.ts +368 -0
  48. package/dist/client/billing/renewalAttach/internal/producer/recoveryFactory.d.ts.map +1 -0
  49. package/dist/client/billing/renewalAttach/internal/producer/recoveryFactory.js +106 -0
  50. package/dist/client/billing/renewalAttach/internal/producer/recoveryFactory.js.map +1 -0
  51. package/dist/client/billing/renewalAttach/internal/recovery/output.d.ts +1 -0
  52. package/dist/client/billing/renewalAttach/internal/recovery/output.d.ts.map +1 -1
  53. package/dist/client/billing/renewalAttach/internal/recovery/output.js +22 -8
  54. package/dist/client/billing/renewalAttach/internal/recovery/output.js.map +1 -1
  55. package/dist/client/billing/renewalAttach/internal/recovery/record.d.ts +1 -0
  56. package/dist/client/billing/renewalAttach/internal/recovery/record.d.ts.map +1 -1
  57. package/dist/client/billing/renewalAttach/internal/recovery/record.js +10 -2
  58. package/dist/client/billing/renewalAttach/internal/recovery/record.js.map +1 -1
  59. package/dist/client/billing/renewalAttach/internal/recovery/recoveryActor.d.ts +12 -0
  60. package/dist/client/billing/renewalAttach/internal/recovery/recoveryActor.d.ts.map +1 -1
  61. package/dist/client/billing/renewalAttach/internal/recovery/recoveryActor.js +96 -156
  62. package/dist/client/billing/renewalAttach/internal/recovery/recoveryActor.js.map +1 -1
  63. package/dist/client/billing/renewalAttach/internal/recovery/relation.d.ts +18 -0
  64. package/dist/client/billing/renewalAttach/internal/recovery/relation.d.ts.map +1 -1
  65. package/dist/client/billing/renewalAttach/internal/recovery/relation.js +15 -1
  66. package/dist/client/billing/renewalAttach/internal/recovery/relation.js.map +1 -1
  67. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +32 -32
  68. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +32 -32
  69. package/dist/component/balanceFunding/mutations.d.ts +27 -27
  70. package/dist/component/balanceFunding/preparationHandlers.d.ts +8 -8
  71. package/dist/component/balanceFunding/queries.d.ts +1 -1
  72. package/dist/component/usage/allowance.fixtures.d.ts +16 -16
  73. package/docs/renewal-context-reads.md +67 -3
  74. package/package.json +1 -1
  75. package/src/client/billing/renewalAttach/internal/acquisition/ownedAcquisition.ts +3 -3
  76. package/src/client/billing/renewalAttach/internal/c10/attachEvents.ts +17 -5
  77. package/src/client/billing/renewalAttach/internal/operations/actorFailureControl.ts +165 -0
  78. package/src/client/billing/renewalAttach/internal/operations/fixedTransport.ts +4 -498
  79. package/src/client/billing/renewalAttach/internal/operations/initialAttach.ts +110 -160
  80. package/src/client/billing/renewalAttach/internal/operations/transportKernel.ts +500 -0
  81. package/src/client/billing/renewalAttach/internal/producer/attachAcknowledgement.ts +65 -0
  82. package/src/client/billing/renewalAttach/internal/producer/invocationProducer.ts +14 -0
  83. package/src/client/billing/renewalAttach/internal/producer/journalWorkFactory.ts +54 -0
  84. package/src/client/billing/renewalAttach/internal/producer/operationFactory.ts +3 -2
  85. package/src/client/billing/renewalAttach/internal/producer/producerAcknowledgement.integration.test.ts +320 -0
  86. package/src/client/billing/renewalAttach/internal/producer/producerAcknowledgementControls.integration.test.ts +411 -0
  87. package/src/client/billing/renewalAttach/internal/producer/producerRecovery.integration.test.ts +394 -0
  88. package/src/client/billing/renewalAttach/internal/producer/producerRecoveryControls.integration.test.ts +437 -0
  89. package/src/client/billing/renewalAttach/internal/producer/producerRecoveryIsolation.integration.test.ts +332 -0
  90. package/src/client/billing/renewalAttach/internal/producer/recoveryEntry.ts +143 -0
  91. package/src/client/billing/renewalAttach/internal/producer/recoveryFactory.ts +135 -0
  92. package/src/client/billing/renewalAttach/internal/recovery/output.ts +34 -8
  93. package/src/client/billing/renewalAttach/internal/recovery/record.ts +16 -2
  94. package/src/client/billing/renewalAttach/internal/recovery/recoveryActor.ts +146 -188
  95. package/src/client/billing/renewalAttach/internal/recovery/relation.ts +17 -1
  96. package/src/client/billing/renewalAttach/internal/test-fixtures/producerInitialOperation.ts +14 -1
@@ -0,0 +1,320 @@
1
+ import assert from "node:assert/strict";
2
+ import { afterEach, beforeEach, expect, it, vi } from "vitest";
3
+ import { initialOperations } from "../test-fixtures/producerInitialOperation.js";
4
+ import { declaredInputs } from "../test-fixtures/attachEntries.js";
5
+ import {
6
+ captureRetainedInput,
7
+ type RetainedInput,
8
+ } from "../material/capture.js";
9
+ import { INITIAL_NS } from "../test-fixtures/producerInitialDeclarations.js";
10
+ import { captureInitialInvocationCore } from "./invocationProducer.js";
11
+ import { data } from "../test-fixtures/attachScenarioBarriers.js";
12
+
13
+ const controls = vi.hoisted(() => {
14
+ const entries: { coversRetained(): boolean; coversFresh(): boolean }[] = [];
15
+ const recovery: { originalEntry: unknown; coversReplay(): boolean }[] = [];
16
+ return { entries, recovery, legacy: 0 };
17
+ });
18
+ // Synthetic TEST coverage only. Production compiled profile arrays stay EMPTY.
19
+ vi.mock("../operations/sourceOperations.js", () => {
20
+ const poisoned = () => {
21
+ controls.legacy++;
22
+ throw Error("LEGACY_SOURCE_POISON");
23
+ };
24
+ return {
25
+ COMPILED_INITIAL_ENTRIES: controls.entries,
26
+ COMPILED_RECOVERY_ENTRIES: controls.recovery,
27
+ loadFixedExplicitRecoveryOperation: poisoned,
28
+ ORIGINAL_ORIGIN_ASSOCIATION: null,
29
+ loadFixedInitialOperation: poisoned,
30
+ loadOwnedTransportSource: poisoned,
31
+ loadInitialOwnedTransportSource: poisoned,
32
+ loadRecoveryOwnedTransportSource: poisoned,
33
+ };
34
+ });
35
+ vi.mock("../originalOwner.js", () => ({
36
+ OWNER: Object.freeze({
37
+ get basis() {
38
+ controls.legacy++;
39
+ throw Error("LEGACY_OWNER_POISON");
40
+ },
41
+ check() {
42
+ controls.legacy++;
43
+ throw Error("LEGACY_OWNER_POISON");
44
+ },
45
+ sample() {
46
+ controls.legacy++;
47
+ throw Error("LEGACY_OWNER_POISON");
48
+ },
49
+ subscribe() {
50
+ controls.legacy++;
51
+ throw Error("LEGACY_OWNER_POISON");
52
+ },
53
+ retire() {
54
+ controls.legacy++;
55
+ throw Error("LEGACY_OWNER_POISON");
56
+ },
57
+ }),
58
+ }));
59
+ type Declaration = {
60
+ source: RetainedInput;
61
+ post: Record<string, unknown>;
62
+ key: string;
63
+ };
64
+ function declaration(suffix?: string): Declaration {
65
+ const original = declaredInputs("INITIAL-ACK");
66
+ const replace = (_key: string, value: unknown) =>
67
+ suffix && value === "sub_original" ? "sub_original_" + suffix : value;
68
+ const raw = JSON.parse(JSON.stringify(original.original), replace);
69
+ if (suffix) raw.attachRequest.attachKey += ":" + suffix;
70
+ const post: Record<string, unknown> = JSON.parse(
71
+ JSON.stringify(original.aPost),
72
+ replace,
73
+ );
74
+ if (suffix) post.id += "_" + suffix;
75
+ return {
76
+ source: captureRetainedInput(raw),
77
+ post,
78
+ key: suffix
79
+ ? "sk_test_invalid_actor_" + suffix
80
+ : "sk_test_invalid_owner_core",
81
+ };
82
+ }
83
+ function windowFor(source: RetainedInput) {
84
+ return {
85
+ workEndWallMs: (source.attachRequest.firstDispatchedAt + 4) * 1000,
86
+ endWallMs: (source.attachRequest.firstDispatchedAt + 5) * 1000,
87
+ };
88
+ }
89
+ function wireFor(
90
+ declared: Declaration[],
91
+ beforePost = async (_index: number) => {},
92
+ ) {
93
+ const calls: { method: string; path: string; index: number }[] = [];
94
+ const routes = new Map<string, { body: unknown; auth: Set<string> }>();
95
+ for (const item of declared) {
96
+ const b = item.source.originalBundle;
97
+ const rows: [string, unknown][] = [
98
+ [
99
+ "/v1/subscriptions/" +
100
+ item.source.attachRequest.preparation.expected.subscriptionId,
101
+ b.wireSubscription,
102
+ ],
103
+ [
104
+ "/v1/prices/" +
105
+ item.source.attachRequest.preparation.expected.targetPriceId,
106
+ b.wireTargetPrice,
107
+ ],
108
+ ["/v1/customers/" + b.wireBillingCustomer.id, b.wireBillingCustomer],
109
+ ];
110
+ for (const row of b.couponReads) {
111
+ assert(typeof row.couponId === "string");
112
+ rows.push([
113
+ "/v1/coupons/" + encodeURIComponent(row.couponId),
114
+ row.wireCoupon,
115
+ ]);
116
+ }
117
+ for (const [path, body] of rows) {
118
+ const route = routes.get(path) ?? { body, auth: new Set<string>() };
119
+ route.auth.add("Bearer " + item.key);
120
+ routes.set(path, route);
121
+ }
122
+ }
123
+ return {
124
+ calls,
125
+ fetch: async (input: RequestInfo | URL, init?: RequestInit) => {
126
+ const url = new URL(String(input));
127
+ assert.equal(url.origin, "https://api.stripe.com");
128
+ assert.equal(init?.redirect, "error");
129
+ const headers = new Headers(init?.headers);
130
+ const auth = headers.get("authorization");
131
+ let body: unknown,
132
+ index = -1;
133
+ if (init?.method === "GET") {
134
+ const row = routes.get(url.pathname);
135
+ assert(row && auth && row.auth.has(auth));
136
+ body = row.body;
137
+ } else {
138
+ assert.equal(init?.method, "POST");
139
+ assert.equal(url.pathname, "/v1/subscription_schedules");
140
+ index = declared.findIndex(
141
+ (item) =>
142
+ item.source.attachRequest.attachKey ===
143
+ headers.get("idempotency-key"),
144
+ );
145
+ assert(index >= 0);
146
+ assert.equal(auth, "Bearer " + declared[index].key);
147
+ assert.equal(
148
+ new URLSearchParams(String(init?.body)).get("from_subscription"),
149
+ declared[index].source.attachRequest.preparation.expected
150
+ .subscriptionId,
151
+ );
152
+ await beforePost(index);
153
+ body = declared[index].post;
154
+ }
155
+ calls.push({ method: init?.method ?? "", path: url.pathname, index });
156
+ return new Response(JSON.stringify(body), {
157
+ status: 200,
158
+ headers: {
159
+ "content-type": "application/json",
160
+ "request-id": "req_initial_actor_" + calls.length,
161
+ },
162
+ });
163
+ },
164
+ };
165
+ }
166
+ beforeEach(() => {
167
+ controls.legacy = 0;
168
+ controls.entries.splice(0, controls.entries.length, {
169
+ coversRetained: () => true,
170
+ coversFresh: () => true,
171
+ });
172
+ controls.recovery.splice(0, controls.recovery.length, {
173
+ originalEntry: controls.entries[0],
174
+ coversReplay: () => true,
175
+ });
176
+ vi.useFakeTimers({ toFake: ["Date", "setTimeout", "clearTimeout"] });
177
+ vi.setSystemTime(
178
+ (declaration().source.attachRequest.firstDispatchedAt + 1) * 1000,
179
+ );
180
+ vi.spyOn(process.hrtime, "bigint").mockReturnValue(INITIAL_NS);
181
+ });
182
+ afterEach(() => {
183
+ vi.useRealTimers();
184
+ vi.unstubAllGlobals();
185
+ vi.restoreAllMocks();
186
+ });
187
+
188
+ function recover(core: object) {
189
+ const capture = Reflect.get(core, "recoverAttach");
190
+ expect(typeof capture).toBe("function");
191
+ return Reflect.apply(capture, core, []) as { invoke(): Promise<unknown> };
192
+ }
193
+
194
+ function acknowledgement(core: object) {
195
+ const read = Reflect.get(core, "attachAcknowledgement");
196
+ expect(typeof read).toBe("function");
197
+ return Reflect.apply(read, core, []) as Readonly<{
198
+ output: unknown;
199
+ receipt: unknown;
200
+ operationalAuthority: false;
201
+ }>;
202
+ }
203
+
204
+ it.each(["initial", "replay", "resume"])(
205
+ "retains the exact actual %s output and receipt identities without replacement inputs",
206
+ async (path) => {
207
+ const declared = declaration();
208
+ let appended = 0;
209
+ await initialOperations(
210
+ async ({ fresh, journal }) => {
211
+ let posts = 0;
212
+ const wire = wireFor([declared], async () => {
213
+ posts++;
214
+ if (path === "replay" && posts === 1)
215
+ throw Error("CONTROLLED_LOST_RESPONSE");
216
+ });
217
+ vi.stubGlobal("fetch", wire.fetch);
218
+ const core = await captureInitialInvocationCore(fresh.call, journal);
219
+ try {
220
+ let output: unknown;
221
+ if (path === "initial") output = await core.initialAttach().invoke();
222
+ else {
223
+ if (path === "replay")
224
+ await expect(core.initialAttach().invoke()).rejects.toThrow(
225
+ "INITIAL_PROVIDER_REJECTED",
226
+ );
227
+ else
228
+ expect(data(await core.initialAttach().invoke()).status).toBe(
229
+ "fulfilled_unverified",
230
+ );
231
+ output = await recover(core).invoke();
232
+ }
233
+ expect(data(output).status).toBe("attach_acknowledged");
234
+ const view = acknowledgement(core);
235
+ expect(view.output).toBe(output);
236
+ expect(view.receipt).toBe(data(output).receipt);
237
+ expect(view.operationalAuthority).toBe(false);
238
+ expect(acknowledgement(core)).toBe(view);
239
+ const copy = JSON.parse(JSON.stringify(output));
240
+ expect(copy).toEqual(output);
241
+ expect(copy.receipt).not.toBe(view.receipt);
242
+ const calls = wire.calls.length;
243
+ expect(() =>
244
+ Reflect.apply(core.attachAcknowledgement, undefined, [
245
+ copy.receipt,
246
+ ]),
247
+ ).toThrow("INITIAL_OPERATION_UNBOUND");
248
+ expect(wire.calls).toHaveLength(calls);
249
+ expect(posts).toBe(path === "replay" ? 2 : 1);
250
+ expect(controls.legacy).toBe(0);
251
+ } finally {
252
+ core.owner.retire();
253
+ }
254
+ },
255
+ 1,
256
+ {
257
+ source: declared.source,
258
+ ...windowFor(declared.source),
259
+ afterAppend: async () => {
260
+ appended++;
261
+ if (path === "resume" && appended === 2)
262
+ throw Error("CONTROLLED_APPEND_REPLY_REJECTION");
263
+ },
264
+ },
265
+ );
266
+ },
267
+ );
268
+
269
+ it("committed receipt DATA does not become returned ACK custody while retention reply is pending, and absence is not cached", async () => {
270
+ const declared = declaration();
271
+ let release!: () => void, entered!: () => void;
272
+ const pending = new Promise<void>((resolve) => {
273
+ release = resolve;
274
+ });
275
+ const committed = new Promise<void>((resolve) => {
276
+ entered = resolve;
277
+ });
278
+ await initialOperations(
279
+ async ({ fresh, journal }) => {
280
+ const wire = wireFor([declared]);
281
+ vi.stubGlobal("fetch", wire.fetch);
282
+ const core = await captureInitialInvocationCore(fresh.call, journal);
283
+ try {
284
+ expect(typeof Reflect.get(core, "attachAcknowledgement")).toBe(
285
+ "function",
286
+ );
287
+ expect(() => acknowledgement(core)).toThrow(
288
+ "ATTACH_ACKNOWLEDGEMENT_UNAVAILABLE",
289
+ );
290
+ const initial = core.initialAttach().invoke();
291
+ await committed;
292
+ expect(await journal.readProviderAcknowledgement()).not.toBeNull();
293
+ expect(() => acknowledgement(core)).toThrow(
294
+ "ATTACH_ACKNOWLEDGEMENT_UNAVAILABLE",
295
+ );
296
+ release();
297
+ const output = await initial;
298
+ const view = acknowledgement(core);
299
+ expect(view.output).toBe(output);
300
+ expect(view.receipt).toBe(data(output).receipt);
301
+ expect(wire.calls.filter((row) => row.method === "POST")).toHaveLength(
302
+ 1,
303
+ );
304
+ expect(controls.legacy).toBe(0);
305
+ } finally {
306
+ release();
307
+ core.owner.retire();
308
+ }
309
+ },
310
+ 1,
311
+ {
312
+ source: declared.source,
313
+ ...windowFor(declared.source),
314
+ afterRetain: async () => {
315
+ entered();
316
+ await pending;
317
+ },
318
+ },
319
+ );
320
+ });