@fantastic.dev/better-stripe 0.90.0 → 0.92.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 (239) 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 +41 -0
  4. package/dist/client/billing/renewalAttach/internal/acquisition/ownedAcquisition.d.ts.map +1 -0
  5. package/dist/client/billing/renewalAttach/internal/acquisition/ownedAcquisition.js +187 -0
  6. package/dist/client/billing/renewalAttach/internal/acquisition/ownedAcquisition.js.map +1 -0
  7. package/dist/client/billing/renewalAttach/internal/acquisition/rawAcquisition.d.ts +2 -23
  8. package/dist/client/billing/renewalAttach/internal/acquisition/rawAcquisition.d.ts.map +1 -1
  9. package/dist/client/billing/renewalAttach/internal/acquisition/rawAcquisition.js +1 -112
  10. package/dist/client/billing/renewalAttach/internal/acquisition/rawAcquisition.js.map +1 -1
  11. package/dist/client/billing/renewalAttach/internal/acquisition/rawWireSource.d.ts +8 -3
  12. package/dist/client/billing/renewalAttach/internal/acquisition/rawWireSource.d.ts.map +1 -1
  13. package/dist/client/billing/renewalAttach/internal/acquisition/rawWireSource.js +1 -0
  14. package/dist/client/billing/renewalAttach/internal/acquisition/rawWireSource.js.map +1 -1
  15. package/dist/client/billing/renewalAttach/internal/acquisition/test-fixtures/sourcePort.d.mts +1 -1
  16. package/dist/client/billing/renewalAttach/internal/configure/actor.d.ts +14 -0
  17. package/dist/client/billing/renewalAttach/internal/configure/actor.d.ts.map +1 -0
  18. package/dist/client/billing/renewalAttach/internal/configure/actor.js +444 -0
  19. package/dist/client/billing/renewalAttach/internal/configure/actor.js.map +1 -0
  20. package/dist/client/billing/renewalAttach/internal/configure/capture.d.ts +12 -0
  21. package/dist/client/billing/renewalAttach/internal/configure/capture.d.ts.map +1 -0
  22. package/dist/client/billing/renewalAttach/internal/configure/capture.js +99 -0
  23. package/dist/client/billing/renewalAttach/internal/configure/capture.js.map +1 -0
  24. package/dist/client/billing/renewalAttach/internal/configure/output.d.ts +16 -0
  25. package/dist/client/billing/renewalAttach/internal/configure/output.d.ts.map +1 -0
  26. package/dist/client/billing/renewalAttach/internal/configure/output.js +274 -0
  27. package/dist/client/billing/renewalAttach/internal/configure/output.js.map +1 -0
  28. package/dist/client/billing/renewalAttach/internal/configure/ownedContinuation.d.ts +3 -0
  29. package/dist/client/billing/renewalAttach/internal/configure/ownedContinuation.d.ts.map +1 -0
  30. package/dist/client/billing/renewalAttach/internal/configure/ownedContinuation.js +61 -0
  31. package/dist/client/billing/renewalAttach/internal/configure/ownedContinuation.js.map +1 -0
  32. package/dist/client/billing/renewalAttach/internal/configure/replay.d.ts +3 -0
  33. package/dist/client/billing/renewalAttach/internal/configure/replay.d.ts.map +1 -0
  34. package/dist/client/billing/renewalAttach/internal/configure/replay.js +9 -0
  35. package/dist/client/billing/renewalAttach/internal/configure/replay.js.map +1 -0
  36. package/dist/client/billing/renewalAttach/internal/configure/request.d.ts +39 -0
  37. package/dist/client/billing/renewalAttach/internal/configure/request.d.ts.map +1 -0
  38. package/dist/client/billing/renewalAttach/internal/configure/request.js +245 -0
  39. package/dist/client/billing/renewalAttach/internal/configure/request.js.map +1 -0
  40. package/dist/client/billing/renewalAttach/internal/configure/transport.d.ts +88 -0
  41. package/dist/client/billing/renewalAttach/internal/configure/transport.d.ts.map +1 -0
  42. package/dist/client/billing/renewalAttach/internal/configure/transport.js +289 -0
  43. package/dist/client/billing/renewalAttach/internal/configure/transport.js.map +1 -0
  44. package/dist/client/billing/renewalAttach/internal/observation/actor.d.ts +16 -0
  45. package/dist/client/billing/renewalAttach/internal/observation/actor.d.ts.map +1 -0
  46. package/dist/client/billing/renewalAttach/internal/observation/actor.js +383 -0
  47. package/dist/client/billing/renewalAttach/internal/observation/actor.js.map +1 -0
  48. package/dist/client/billing/renewalAttach/internal/observation/capture.d.ts +9 -0
  49. package/dist/client/billing/renewalAttach/internal/observation/capture.d.ts.map +1 -0
  50. package/dist/client/billing/renewalAttach/internal/observation/capture.js +216 -0
  51. package/dist/client/billing/renewalAttach/internal/observation/capture.js.map +1 -0
  52. package/dist/client/billing/renewalAttach/internal/observation/configureAcknowledgement.d.ts +5 -0
  53. package/dist/client/billing/renewalAttach/internal/observation/configureAcknowledgement.d.ts.map +1 -0
  54. package/dist/client/billing/renewalAttach/internal/observation/configureAcknowledgement.js +11 -0
  55. package/dist/client/billing/renewalAttach/internal/observation/configureAcknowledgement.js.map +1 -0
  56. package/dist/client/billing/renewalAttach/internal/observation/profile.d.ts +7 -0
  57. package/dist/client/billing/renewalAttach/internal/observation/profile.d.ts.map +1 -0
  58. package/dist/client/billing/renewalAttach/internal/observation/profile.js +190 -0
  59. package/dist/client/billing/renewalAttach/internal/observation/profile.js.map +1 -0
  60. package/dist/client/billing/renewalAttach/internal/observation/record.d.ts +5 -0
  61. package/dist/client/billing/renewalAttach/internal/observation/record.d.ts.map +1 -0
  62. package/dist/client/billing/renewalAttach/internal/observation/record.js +317 -0
  63. package/dist/client/billing/renewalAttach/internal/observation/record.js.map +1 -0
  64. package/dist/client/billing/renewalAttach/internal/observation/types.d.ts +84 -0
  65. package/dist/client/billing/renewalAttach/internal/observation/types.d.ts.map +1 -0
  66. package/dist/client/billing/renewalAttach/internal/observation/types.js +27 -0
  67. package/dist/client/billing/renewalAttach/internal/observation/types.js.map +1 -0
  68. package/dist/client/billing/renewalAttach/internal/operations/configureReadTransport.d.ts +18 -0
  69. package/dist/client/billing/renewalAttach/internal/operations/configureReadTransport.d.ts.map +1 -0
  70. package/dist/client/billing/renewalAttach/internal/operations/configureReadTransport.js +229 -0
  71. package/dist/client/billing/renewalAttach/internal/operations/configureReadTransport.js.map +1 -0
  72. package/dist/client/billing/renewalAttach/internal/operations/fixedTransport.d.ts +163 -0
  73. package/dist/client/billing/renewalAttach/internal/operations/fixedTransport.d.ts.map +1 -0
  74. package/dist/client/billing/renewalAttach/internal/operations/fixedTransport.js +443 -0
  75. package/dist/client/billing/renewalAttach/internal/operations/fixedTransport.js.map +1 -0
  76. package/dist/client/billing/renewalAttach/internal/operations/initialAttach.d.ts +8 -0
  77. package/dist/client/billing/renewalAttach/internal/operations/initialAttach.d.ts.map +1 -0
  78. package/dist/client/billing/renewalAttach/internal/operations/initialAttach.js +467 -0
  79. package/dist/client/billing/renewalAttach/internal/operations/initialAttach.js.map +1 -0
  80. package/dist/client/billing/renewalAttach/internal/operations/ownedAwait.d.ts +6 -0
  81. package/dist/client/billing/renewalAttach/internal/operations/ownedAwait.d.ts.map +1 -0
  82. package/dist/client/billing/renewalAttach/internal/operations/ownedAwait.js +59 -0
  83. package/dist/client/billing/renewalAttach/internal/operations/ownedAwait.js.map +1 -0
  84. package/dist/client/billing/renewalAttach/internal/operations/providerFailure.d.ts +10 -0
  85. package/dist/client/billing/renewalAttach/internal/operations/providerFailure.d.ts.map +1 -0
  86. package/dist/client/billing/renewalAttach/internal/operations/providerFailure.js +48 -0
  87. package/dist/client/billing/renewalAttach/internal/operations/providerFailure.js.map +1 -0
  88. package/dist/client/billing/renewalAttach/internal/operations/sourceOperations.d.ts +20 -0
  89. package/dist/client/billing/renewalAttach/internal/operations/sourceOperations.d.ts.map +1 -0
  90. package/dist/client/billing/renewalAttach/internal/operations/sourceOperations.js +44 -0
  91. package/dist/client/billing/renewalAttach/internal/operations/sourceOperations.js.map +1 -0
  92. package/dist/client/billing/renewalAttach/internal/operations/types.d.ts +42 -0
  93. package/dist/client/billing/renewalAttach/internal/operations/types.d.ts.map +1 -0
  94. package/dist/client/billing/renewalAttach/internal/operations/types.js +158 -0
  95. package/dist/client/billing/renewalAttach/internal/operations/types.js.map +1 -0
  96. package/dist/client/billing/renewalAttach/internal/preflight/configurePreflight.d.ts +5 -0
  97. package/dist/client/billing/renewalAttach/internal/preflight/configurePreflight.d.ts.map +1 -0
  98. package/dist/client/billing/renewalAttach/internal/preflight/configurePreflight.js +214 -0
  99. package/dist/client/billing/renewalAttach/internal/preflight/configurePreflight.js.map +1 -0
  100. package/dist/client/billing/renewalAttach/internal/preflight/grammar.d.ts +33 -0
  101. package/dist/client/billing/renewalAttach/internal/preflight/grammar.d.ts.map +1 -0
  102. package/dist/client/billing/renewalAttach/internal/preflight/grammar.js +208 -0
  103. package/dist/client/billing/renewalAttach/internal/preflight/grammar.js.map +1 -0
  104. package/dist/client/billing/renewalAttach/internal/preflight/output.d.ts +4 -0
  105. package/dist/client/billing/renewalAttach/internal/preflight/output.d.ts.map +1 -0
  106. package/dist/client/billing/renewalAttach/internal/preflight/output.js +25 -0
  107. package/dist/client/billing/renewalAttach/internal/preflight/output.js.map +1 -0
  108. package/dist/client/billing/renewalAttach/internal/preflight/record.d.ts +16 -0
  109. package/dist/client/billing/renewalAttach/internal/preflight/record.d.ts.map +1 -0
  110. package/dist/client/billing/renewalAttach/internal/preflight/record.js +93 -0
  111. package/dist/client/billing/renewalAttach/internal/preflight/record.js.map +1 -0
  112. package/dist/client/billing/renewalAttach/internal/preflight/relations.d.ts +7 -0
  113. package/dist/client/billing/renewalAttach/internal/preflight/relations.d.ts.map +1 -0
  114. package/dist/client/billing/renewalAttach/internal/preflight/relations.js +153 -0
  115. package/dist/client/billing/renewalAttach/internal/preflight/relations.js.map +1 -0
  116. package/dist/client/billing/renewalAttach/internal/recovery/material.d.ts +22 -0
  117. package/dist/client/billing/renewalAttach/internal/recovery/material.d.ts.map +1 -0
  118. package/dist/client/billing/renewalAttach/internal/recovery/material.js +221 -0
  119. package/dist/client/billing/renewalAttach/internal/recovery/material.js.map +1 -0
  120. package/dist/client/billing/renewalAttach/internal/recovery/output.d.ts +8 -0
  121. package/dist/client/billing/renewalAttach/internal/recovery/output.d.ts.map +1 -0
  122. package/dist/client/billing/renewalAttach/internal/recovery/output.js +101 -0
  123. package/dist/client/billing/renewalAttach/internal/recovery/output.js.map +1 -0
  124. package/dist/client/billing/renewalAttach/internal/recovery/record.d.ts +12 -0
  125. package/dist/client/billing/renewalAttach/internal/recovery/record.d.ts.map +1 -0
  126. package/dist/client/billing/renewalAttach/internal/recovery/record.js +186 -0
  127. package/dist/client/billing/renewalAttach/internal/recovery/record.js.map +1 -0
  128. package/dist/client/billing/renewalAttach/internal/recovery/recoveryActor.d.ts +5 -0
  129. package/dist/client/billing/renewalAttach/internal/recovery/recoveryActor.d.ts.map +1 -0
  130. package/dist/client/billing/renewalAttach/internal/recovery/recoveryActor.js +498 -0
  131. package/dist/client/billing/renewalAttach/internal/recovery/recoveryActor.js.map +1 -0
  132. package/dist/client/billing/renewalAttach/internal/recovery/relation.d.ts +21 -0
  133. package/dist/client/billing/renewalAttach/internal/recovery/relation.d.ts.map +1 -0
  134. package/dist/client/billing/renewalAttach/internal/recovery/relation.js +119 -0
  135. package/dist/client/billing/renewalAttach/internal/recovery/relation.js.map +1 -0
  136. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +16 -16
  137. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +32 -32
  138. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  139. package/dist/component/financialObservations/settlementHelpers.d.ts +3 -3
  140. package/dist/component/usage/allowance.fixtures.d.ts +16 -16
  141. package/dist/component/usageCredits/accounting.fixtures.d.ts +16 -16
  142. package/docs/renewal-context-reads.md +26 -8
  143. package/docs/renewal-material-observation.md +58 -0
  144. package/docs/renewal-phase-assembly.md +68 -0
  145. package/docs/renewal-raw-acquisition.md +19 -5
  146. package/package.json +1 -1
  147. package/src/client/billing/renewalAttach/internal/acquisition/ownedAcquisition.ts +304 -0
  148. package/src/client/billing/renewalAttach/internal/acquisition/rawAcquisition.ts +2 -160
  149. package/src/client/billing/renewalAttach/internal/acquisition/rawWireSource.ts +15 -3
  150. package/src/client/billing/renewalAttach/internal/configure/actor.ts +586 -0
  151. package/src/client/billing/renewalAttach/internal/configure/capture.ts +117 -0
  152. package/src/client/billing/renewalAttach/internal/configure/dispatch.integration.test.ts +32 -0
  153. package/src/client/billing/renewalAttach/internal/configure/limits.test.ts +510 -0
  154. package/src/client/billing/renewalAttach/internal/configure/order.integration.test.ts +207 -0
  155. package/src/client/billing/renewalAttach/internal/configure/output.ts +372 -0
  156. package/src/client/billing/renewalAttach/internal/configure/ownedContinuation.ts +56 -0
  157. package/src/client/billing/renewalAttach/internal/configure/ownership.integration.test.ts +148 -0
  158. package/src/client/billing/renewalAttach/internal/configure/replay.integration.test.ts +173 -0
  159. package/src/client/billing/renewalAttach/internal/configure/replay.ts +13 -0
  160. package/src/client/billing/renewalAttach/internal/configure/request.ts +312 -0
  161. package/src/client/billing/renewalAttach/internal/configure/transport.integration.test.ts +507 -0
  162. package/src/client/billing/renewalAttach/internal/configure/transport.ts +348 -0
  163. package/src/client/billing/renewalAttach/internal/observation/actor.ts +487 -0
  164. package/src/client/billing/renewalAttach/internal/observation/capture.ts +251 -0
  165. package/src/client/billing/renewalAttach/internal/observation/configureAcknowledgement.ts +20 -0
  166. package/src/client/billing/renewalAttach/internal/observation/observation.integration.test.ts +220 -0
  167. package/src/client/billing/renewalAttach/internal/observation/observationConfigureACK.integration.test.ts +36 -0
  168. package/src/client/billing/renewalAttach/internal/observation/observationConfigureACKControls.integration.test.ts +48 -0
  169. package/src/client/billing/renewalAttach/internal/observation/observationConfigureACKLifecycle.integration.test.ts +44 -0
  170. package/src/client/billing/renewalAttach/internal/observation/observationConfiguredHistory.integration.test.ts +34 -0
  171. package/src/client/billing/renewalAttach/internal/observation/observationRetirement.integration.test.ts +60 -0
  172. package/src/client/billing/renewalAttach/internal/observation/profile.ts +264 -0
  173. package/src/client/billing/renewalAttach/internal/observation/record.ts +408 -0
  174. package/src/client/billing/renewalAttach/internal/observation/types.ts +107 -0
  175. package/src/client/billing/renewalAttach/internal/operations/configureReadTransport.ts +285 -0
  176. package/src/client/billing/renewalAttach/internal/operations/defaultBindings.test.ts +69 -0
  177. package/src/client/billing/renewalAttach/internal/operations/fixedTransport.ts +574 -0
  178. package/src/client/billing/renewalAttach/internal/operations/initialAttach.integration.test.ts +34 -0
  179. package/src/client/billing/renewalAttach/internal/operations/initialAttach.ts +535 -0
  180. package/src/client/billing/renewalAttach/internal/operations/ownedAwait.ts +63 -0
  181. package/src/client/billing/renewalAttach/internal/operations/providerFailure.integration.test.ts +61 -0
  182. package/src/client/billing/renewalAttach/internal/operations/providerFailure.ts +66 -0
  183. package/src/client/billing/renewalAttach/internal/operations/sourceOperations.ts +50 -0
  184. package/src/client/billing/renewalAttach/internal/operations/transport.integration.test.ts +116 -0
  185. package/src/client/billing/renewalAttach/internal/operations/types.ts +223 -0
  186. package/src/client/billing/renewalAttach/internal/preflight/configurePreflight.integration.test.ts +285 -0
  187. package/src/client/billing/renewalAttach/internal/preflight/configurePreflight.ts +258 -0
  188. package/src/client/billing/renewalAttach/internal/preflight/configureReads.integration.test.ts +139 -0
  189. package/src/client/billing/renewalAttach/internal/preflight/grammar.ts +257 -0
  190. package/src/client/billing/renewalAttach/internal/preflight/output.ts +42 -0
  191. package/src/client/billing/renewalAttach/internal/preflight/owner.integration.test.ts +82 -0
  192. package/src/client/billing/renewalAttach/internal/preflight/preflight.integration.test.ts +354 -0
  193. package/src/client/billing/renewalAttach/internal/preflight/record.ts +127 -0
  194. package/src/client/billing/renewalAttach/internal/preflight/relations.ts +209 -0
  195. package/src/client/billing/renewalAttach/internal/recovery/material.ts +311 -0
  196. package/src/client/billing/renewalAttach/internal/recovery/output.ts +136 -0
  197. package/src/client/billing/renewalAttach/internal/recovery/record.ts +230 -0
  198. package/src/client/billing/renewalAttach/internal/recovery/recovery.integration.test.ts +463 -0
  199. package/src/client/billing/renewalAttach/internal/recovery/recoveryActor.ts +599 -0
  200. package/src/client/billing/renewalAttach/internal/recovery/relation.ts +175 -0
  201. package/src/client/billing/renewalAttach/internal/test-fixtures/attachEntries.ts +217 -0
  202. package/src/client/billing/renewalAttach/internal/test-fixtures/attachObservations.ts +226 -0
  203. package/src/client/billing/renewalAttach/internal/test-fixtures/attachScenario.ts +556 -0
  204. package/src/client/billing/renewalAttach/internal/test-fixtures/attachScenarioAssertions.ts +180 -0
  205. package/src/client/billing/renewalAttach/internal/test-fixtures/attachScenarioBarriers.ts +144 -0
  206. package/src/client/billing/renewalAttach/internal/test-fixtures/configurePreflightAssertions.ts +122 -0
  207. package/src/client/billing/renewalAttach/internal/test-fixtures/configurePreflightBarriers.ts +330 -0
  208. package/src/client/billing/renewalAttach/internal/test-fixtures/configurePreflightControls.ts +139 -0
  209. package/src/client/billing/renewalAttach/internal/test-fixtures/configurePreflightOperation.ts +513 -0
  210. package/src/client/billing/renewalAttach/internal/test-fixtures/configureReadNativeBaseline.ts +344 -0
  211. package/src/client/billing/renewalAttach/internal/test-fixtures/configureReadOperation.ts +278 -0
  212. package/src/client/billing/renewalAttach/internal/test-fixtures/configureReadPort.ts +17 -0
  213. package/src/client/billing/renewalAttach/internal/test-fixtures/configureWriteAssertions.ts +537 -0
  214. package/src/client/billing/renewalAttach/internal/test-fixtures/configureWriteBarriers.ts +125 -0
  215. package/src/client/billing/renewalAttach/internal/test-fixtures/configureWriteDeclarations.ts +325 -0
  216. package/src/client/billing/renewalAttach/internal/test-fixtures/configureWriteDelegate.ts +38 -0
  217. package/src/client/billing/renewalAttach/internal/test-fixtures/configureWriteHistory.ts +471 -0
  218. package/src/client/billing/renewalAttach/internal/test-fixtures/configureWriteObservations.ts +515 -0
  219. package/src/client/billing/renewalAttach/internal/test-fixtures/configureWriteOperation.ts +587 -0
  220. package/src/client/billing/renewalAttach/internal/test-fixtures/observationAssertions.ts +211 -0
  221. package/src/client/billing/renewalAttach/internal/test-fixtures/observationConfigureACKAssertions.ts +115 -0
  222. package/src/client/billing/renewalAttach/internal/test-fixtures/observationConfigureACKDeclarations.ts +141 -0
  223. package/src/client/billing/renewalAttach/internal/test-fixtures/observationConfigureACKLifecycleAssertions.ts +74 -0
  224. package/src/client/billing/renewalAttach/internal/test-fixtures/observationConfigureACKLifecycleDeclarations.ts +79 -0
  225. package/src/client/billing/renewalAttach/internal/test-fixtures/observationConfigureACKLifecycleInstrumentation.ts +207 -0
  226. package/src/client/billing/renewalAttach/internal/test-fixtures/observationConfigureACKLifecycleOperation.ts +494 -0
  227. package/src/client/billing/renewalAttach/internal/test-fixtures/observationConfigureACKOperation.ts +452 -0
  228. package/src/client/billing/renewalAttach/internal/test-fixtures/observationConfiguredHistoryAssertions.ts +88 -0
  229. package/src/client/billing/renewalAttach/internal/test-fixtures/observationConfiguredHistoryDeclarations.ts +170 -0
  230. package/src/client/billing/renewalAttach/internal/test-fixtures/observationConfiguredHistoryNative.ts +99 -0
  231. package/src/client/billing/renewalAttach/internal/test-fixtures/observationConfiguredHistoryOperation.ts +411 -0
  232. package/src/client/billing/renewalAttach/internal/test-fixtures/observationDeclarations.ts +192 -0
  233. package/src/client/billing/renewalAttach/internal/test-fixtures/observationHTTP.ts +197 -0
  234. package/src/client/billing/renewalAttach/internal/test-fixtures/observationObservations.ts +269 -0
  235. package/src/client/billing/renewalAttach/internal/test-fixtures/observationOperation.ts +262 -0
  236. package/src/client/billing/renewalAttach/internal/test-fixtures/observationProbe.ts +319 -0
  237. package/src/client/billing/renewalAttach/internal/test-fixtures/ownedOperations.ts +94 -0
  238. package/src/client/billing/renewalAttach/internal/test-fixtures/sourceOperationPort.ts +16 -0
  239. package/src/client/billing/renewalAttach/internal/test-fixtures/stockHttp.ts +21 -0
@@ -0,0 +1,587 @@
1
+ import assert from "node:assert/strict";
2
+ import { vi } from "vitest";
3
+ import { declaredEntries } from "./attachEntries.js";
4
+ import { captureWriteTestDelegate } from "./configureWriteDelegate.js";
5
+ import {
6
+ declarePreflightCase,
7
+ deepFreeze,
8
+ data,
9
+ } from "./configurePreflightControls.js";
10
+ import {
11
+ preflightBarriers,
12
+ installPreflightDigestBarrier,
13
+ cleanPreflightMocks,
14
+ preflightObservationState,
15
+ installPreflightObservers,
16
+ } from "./configurePreflightBarriers.js";
17
+ import {
18
+ declareConfigureWriteFamily,
19
+ type WriteCase,
20
+ } from "./configureWriteDeclarations.js";
21
+ import {
22
+ writeObservationState,
23
+ installWriteAPIObservers,
24
+ } from "./configureWriteObservations.js";
25
+ import {
26
+ configureWriteBarriers,
27
+ installWriteDigestAccounting,
28
+ } from "./configureWriteBarriers.js";
29
+ import {
30
+ declareExpectedReplay,
31
+ configureWriteTestFamily,
32
+ type ConfiguredWriteTestFamily,
33
+ } from "./configureWriteHistory.js";
34
+ import {
35
+ assertFit,
36
+ assertPreflightPositive,
37
+ } from "./configurePreflightAssertions.js";
38
+ import {
39
+ establishWriteOracle,
40
+ assertWriteTokenPreimages,
41
+ logWritePrerequisites,
42
+ } from "./configureWriteAssertions.js";
43
+
44
+ /** Closed TEST Source. Real initial ACK is a prerequisite, never a fabricated receipt. */
45
+ export async function configureWriteFixture(mode: WriteCase = "ack") {
46
+ const name = "positive" as const;
47
+ const declarations = declareConfigureWriteFamily(mode);
48
+ const write = declarations.control;
49
+ const writeState = writeObservationState();
50
+ const writeGates = configureWriteBarriers();
51
+ vi.resetModules();
52
+ const declared = declarePreflightCase(name);
53
+ const gates = preflightBarriers(name);
54
+ try {
55
+ const state = preflightObservationState();
56
+ let now = declared.firstAt;
57
+ const start = declared.original.attachRequest.firstDispatchedAt * 1000;
58
+ const basis = Object.freeze({
59
+ startWallMs: start,
60
+ startNs: BigInt(start) * 1000000n,
61
+ workEndWallMs: start + declared.workSeconds * 1000,
62
+ workEndNs: BigInt(start + declared.workSeconds * 1000) * 1000000n,
63
+ endWallMs: start + declared.endSeconds * 1000,
64
+ endNs: BigInt(start + declared.endSeconds * 1000) * 1000000n,
65
+ });
66
+ const advance = (next: number) => {
67
+ assert(next >= now && next < basis.workEndWallMs);
68
+ now = next;
69
+ };
70
+ const listeners = new Set<() => void>(),
71
+ origin = Object.freeze({});
72
+ const source = Object.freeze({
73
+ clock: Object.freeze({
74
+ basis,
75
+ sample: () => {
76
+ state.samples++;
77
+ return { wallMs: now, ns: BigInt(now) * 1000000n };
78
+ },
79
+ subscribeRetirement(fn: () => void) {
80
+ listeners.add(fn);
81
+ return () => listeners.delete(fn);
82
+ },
83
+ }),
84
+ originalPolicy: {
85
+ firstDispatchedAt: declared.original.attachRequest.firstDispatchedAt,
86
+ periodStart:
87
+ declared.original.attachRequest.preparation.expected.periodStart,
88
+ periodEnd:
89
+ declared.original.attachRequest.preparation.expected.periodEnd,
90
+ },
91
+ originAssociation: origin,
92
+ });
93
+ const NativeDate = Date;
94
+ vi.stubGlobal(
95
+ "Date",
96
+ class extends NativeDate {
97
+ constructor(value?: string | number) {
98
+ super(value ?? now);
99
+ }
100
+ static now() {
101
+ return now;
102
+ }
103
+ },
104
+ );
105
+ installPreflightDigestBarrier(gates, () => state.phase);
106
+ vi.doMock("../sourceBindings.js", () => ({
107
+ loadOwnedOriginalSource: () => source,
108
+ }));
109
+ const { OWNER } = await import("../originalOwner.js");
110
+ const originalBasis = OWNER.basis;
111
+ const actual = await installPreflightObservers(
112
+ state,
113
+ OWNER,
114
+ name,
115
+ gates,
116
+ () => advance(declared.laterAt),
117
+ () => {
118
+ throw Error("NO_RETARGET_IN_WRITER_PREREQUISITE");
119
+ },
120
+ );
121
+ const { captureRetainedInput, ownedRetainedEligibility } =
122
+ await import("../material/capture.js");
123
+ const original = captureRetainedInput(declared.original);
124
+ const prepared = await actual.prepareRenewalPriceReplacementV2(
125
+ original.attachRequest.preparation,
126
+ );
127
+ OWNER.check();
128
+ const request = await actual.prepareRenewalScheduleAttachmentV2({
129
+ prepared,
130
+ apiVersion: original.attachRequest.apiVersion,
131
+ attachKey: original.attachRequest.attachKey,
132
+ firstDispatchedAt: original.attachRequest.firstDispatchedAt,
133
+ });
134
+ OWNER.check();
135
+ const { validateOwnedReadMaterial } =
136
+ await import("../material/readMaterial.js");
137
+ const reads = validateOwnedReadMaterial(
138
+ {
139
+ apiVersion: declared.apiVersion,
140
+ observedAt: original.attachRequest.firstDispatchedAt,
141
+ freshSubscription: original.originalBundle.wireSubscription,
142
+ targetPrice: original.originalBundle.wireTargetPrice,
143
+ billingCustomer: original.originalBundle.wireBillingCustomer,
144
+ },
145
+ prepared,
146
+ undefined,
147
+ ownedRetainedEligibility(original),
148
+ );
149
+ const entries = declaredEntries(
150
+ original,
151
+ prepared,
152
+ request,
153
+ reads,
154
+ original.originalBundle,
155
+ );
156
+ const query = String(
157
+ new URLSearchParams(
158
+ ["discounts", "items.data.discounts", "items.data.price"].map(
159
+ (value, i) => ["expand[" + i + "]", value],
160
+ ),
161
+ ),
162
+ );
163
+ const paths = [
164
+ "/v1/subscriptions/" + prepared.expected.subscriptionId + "?" + query,
165
+ "/v1/prices/" + prepared.expected.targetPriceId,
166
+ "/v1/customers/" + original.originalBundle.wireBillingCustomer.id,
167
+ ...original.originalBundle.couponReads.map((row) => {
168
+ assert(typeof row.couponId === "string");
169
+ return "/v1/coupons/" + encodeURIComponent(row.couponId);
170
+ }),
171
+ ];
172
+ const row = (path: string, i: number) =>
173
+ deepFreeze({
174
+ resource:
175
+ i === 0
176
+ ? "subscription"
177
+ : i === 1
178
+ ? "price"
179
+ : i === 2
180
+ ? "customer"
181
+ : "coupon",
182
+ ordinal: i + 1,
183
+ method: "GET",
184
+ path,
185
+ body: undefined,
186
+ options: { apiVersion: declared.apiVersion, maxNetworkRetries: 0 },
187
+ });
188
+ const initialPlan = Object.freeze(paths.map(row));
189
+ const schedulePath = "/v1/subscription_schedules/" + declared.schedule.id;
190
+ const configurePlan = Object.freeze([
191
+ ...initialPlan,
192
+ deepFreeze({ ...row(schedulePath, paths.length), resource: "schedule" }),
193
+ ]);
194
+ const originalBodies = [
195
+ original.originalBundle.wireSubscription,
196
+ original.originalBundle.wireTargetPrice,
197
+ original.originalBundle.wireBillingCustomer,
198
+ ...original.originalBundle.couponReads.map((value) => value.wireCoupon),
199
+ ];
200
+ const currentBodies = [
201
+ declared.currentBundle.wireSubscription,
202
+ declared.currentBundle.wireTargetPrice,
203
+ declared.currentBundle.wireBillingCustomer,
204
+ ...declared.currentBundle.couponReads.map((value) => value.wireCoupon),
205
+ ];
206
+ const table = deepFreeze([
207
+ ...paths.map((path, i) => ({
208
+ method: "GET",
209
+ path,
210
+ body: originalBodies[i],
211
+ schedule: false,
212
+ })),
213
+ {
214
+ method: "POST",
215
+ path: "/v1/subscription_schedules",
216
+ body: declared.schedule,
217
+ schedule: false,
218
+ },
219
+ ...paths.map((path, i) => ({
220
+ method: "GET",
221
+ path,
222
+ body: currentBodies[i],
223
+ schedule: false,
224
+ })),
225
+ {
226
+ method: "GET",
227
+ path: schedulePath,
228
+ body: declared.currentSchedule,
229
+ schedule: true,
230
+ },
231
+ ]);
232
+ vi.stubGlobal("fetch", async (input: unknown, init: RequestInit) => {
233
+ const next = table[state.calls.length],
234
+ url = new URL(String(input));
235
+ assert(next, "UNDECLARED_PREFLIGHT_HTTP");
236
+ assert.equal(url.origin, "https://api.stripe.com");
237
+ assert.equal(url.pathname + url.search, next.path);
238
+ assert.equal(init.method, next.method);
239
+ assert.equal(init.redirect, "error");
240
+ assert.equal(
241
+ new Headers(init.headers).get("stripe-version"),
242
+ declared.apiVersion,
243
+ );
244
+ state.calls.push({ method: String(init.method), path: next.path });
245
+ if (next.schedule) {
246
+ await gates.hold("schedule");
247
+ advance(declared.scheduleAt);
248
+ state.scheduleReplies++;
249
+ }
250
+ return new Response(JSON.stringify(next.body), {
251
+ status: 200,
252
+ headers: {
253
+ "content-type": "application/json",
254
+ "request-id": "req_SYNTHETIC_PREFLIGHT",
255
+ },
256
+ });
257
+ });
258
+ const { getStripeClient } = await import("../../../../helpers.js");
259
+ const client = getStripeClient(
260
+ "sk_test_SYNTHETIC_PREFLIGHT_NO_CREDENTIAL",
261
+ declared.apiVersion,
262
+ { singleAttempt: true },
263
+ );
264
+ const method = client.rawRequest;
265
+ const delegate = Object.freeze({
266
+ rawRequest(...args: unknown[]) {
267
+ return Reflect.apply(method, client, args) as Promise<unknown>;
268
+ },
269
+ });
270
+ const readonlyDelegate = Object.freeze({
271
+ rawRequest(...args: unknown[]) {
272
+ state.readonlyCalls++;
273
+ assert.equal(args[0], "GET");
274
+ return Reflect.apply(method, client, args) as Promise<unknown>;
275
+ },
276
+ });
277
+ const sink = Object.freeze({
278
+ send(value: unknown, acknowledge: (value: unknown) => void) {
279
+ OWNER.check();
280
+ const record = data(value);
281
+ state.records.push(record);
282
+ acknowledge({ sequence: record.sequence, binding: record.binding });
283
+ },
284
+ });
285
+ let slotTakes = 0;
286
+ const initialOperation = Object.freeze({
287
+ owner: OWNER,
288
+ originAssociation: origin,
289
+ slot: Object.freeze({
290
+ takeOnce(owner: unknown) {
291
+ assert.equal(owner, OWNER);
292
+ assert.equal(++slotTakes, 1);
293
+ return {
294
+ rawAttachRequest: original.attachRequest,
295
+ originalBundle: original.originalBundle,
296
+ };
297
+ },
298
+ }),
299
+ readPlan: initialPlan,
300
+ delegate,
301
+ sink,
302
+ });
303
+ const initialFrame = Object.freeze({
304
+ owner: OWNER,
305
+ operation: initialOperation,
306
+ request,
307
+ readPlan: initialPlan,
308
+ delegate,
309
+ });
310
+ // Each TEST Source cell is filled once after actual initial terminal ACK, then read unchanged.
311
+ let operation: object | null = null,
312
+ configureFrame: object | null = null;
313
+ let family: ConfiguredWriteTestFamily | null = null;
314
+ const writeCoverage = Object.freeze({
315
+ originalEntry: entries.entry,
316
+ coversConfigure(record: unknown, evidence: unknown, fresh: unknown) {
317
+ assert(family);
318
+ return family.covers(record, evidence, fresh, expectedEvidence);
319
+ },
320
+ });
321
+ const coverage = Object.freeze({
322
+ originalEntry: entries.entry,
323
+ coversPreflight(record: unknown, evidence: unknown, fresh: unknown) {
324
+ state.coverage++;
325
+ assert.deepEqual(record, expectedRecord);
326
+ assert.deepEqual(evidence, expectedEvidence);
327
+ assert.deepEqual(fresh, projected);
328
+ return true;
329
+ },
330
+ });
331
+ vi.doMock("../operations/sourceOperations.js", () => ({
332
+ COMPILED_INITIAL_ENTRIES: Object.freeze([entries.entry]),
333
+ COMPILED_RECOVERY_ENTRIES: Object.freeze([]),
334
+ COMPILED_PREFLIGHT_ENTRIES: Object.freeze([coverage]),
335
+ COMPILED_CONFIGURE_WRITE_ENTRIES: Object.freeze(
336
+ mode === "empty" ? [] : [writeCoverage],
337
+ ),
338
+ loadFixedConfigureWriteOperation() {
339
+ assert(family);
340
+ return family.initialOperation();
341
+ },
342
+ loadConfigureWriteTransportSource() {
343
+ assert(family);
344
+ return family.initialFrame();
345
+ },
346
+ loadFixedConfigureReplayOperation() {
347
+ assert(family);
348
+ return family.replayOperation();
349
+ },
350
+ loadConfigureReplayTransportSource() {
351
+ assert(family);
352
+ return family.replayFrame();
353
+ },
354
+ ORIGINAL_ORIGIN_ASSOCIATION: origin,
355
+ loadFixedInitialOperation: () => initialOperation,
356
+ loadInitialOwnedTransportSource: () => initialFrame,
357
+ loadOwnedConfigureOperation() {
358
+ state.operationLoads++;
359
+ assert(operation);
360
+ return operation;
361
+ },
362
+ loadConfigureOwnedReadTransportSource() {
363
+ state.pairLoads++;
364
+ assert(configureFrame);
365
+ return configureFrame;
366
+ },
367
+ }));
368
+ const { captureOwnedInitialAttachV2 } =
369
+ await import("../operations/initialAttach.js");
370
+ const initialOutput = data(await captureOwnedInitialAttachV2().invoke());
371
+ assert.equal(
372
+ initialOutput.status,
373
+ "attach_acknowledged",
374
+ "ACTUAL_INITIAL_ACK_PREREQUISITE",
375
+ );
376
+ assert.equal(state.records.length, 3);
377
+ assert.equal(
378
+ state.calls.filter((value) => value.method === "POST").length,
379
+ 1,
380
+ );
381
+ const acknowledgement = initialOutput.receipt;
382
+ assert(acknowledgement && typeof acknowledgement === "object");
383
+ assert.deepEqual(data(acknowledgement).providerSnapshot, declared.schedule);
384
+ assert.deepEqual(data(acknowledgement).request, request);
385
+ assert.deepEqual(data(state.records[2]!.data).receipt, acknowledgement);
386
+ advance(declared.baseAt);
387
+ const goodConfiguration = {
388
+ preparation: original.attachRequest.preparation,
389
+ attachReceipt: {
390
+ attachRequest: original.attachRequest,
391
+ actualDispatch: {
392
+ scope: request.scope,
393
+ apiVersion: request.apiVersion,
394
+ method: request.method,
395
+ path: request.path,
396
+ payload: request.payload,
397
+ key: request.key,
398
+ firstDispatchedAt: request.firstDispatchedAt,
399
+ },
400
+ providerSnapshot: declared.schedule,
401
+ },
402
+ freshSubscription: declared.baselineBundle.wireSubscription,
403
+ targetPrice: declared.baselineBundle.wireTargetPrice,
404
+ billingCustomer: declared.baselineBundle.wireBillingCustomer,
405
+ schedule: declared.schedule,
406
+ apiVersion: declared.apiVersion,
407
+ observedAt: declared.configureAt,
408
+ firstDispatchedAt: declared.configureAt,
409
+ configureKey: declared.configureKey,
410
+ };
411
+ const projected =
412
+ await actual.projectRenewalConfigurationV2(goodConfiguration);
413
+ OWNER.check();
414
+ assert.equal(
415
+ projected.status,
416
+ "projected_configure_request",
417
+ "EXPANDED_NATIVE_C6_PREREQUISITE",
418
+ );
419
+ if (projected.status !== "projected_configure_request")
420
+ throw Error("EXPANDED_NATIVE_C6_PREREQUISITE");
421
+ const expectedRecord = deepFreeze({
422
+ configuration: goodConfiguration,
423
+ request: projected,
424
+ attachReceipt: acknowledgement,
425
+ originalBundle: original.originalBundle,
426
+ });
427
+ const expectedEvidence = deepFreeze({
428
+ bundle: declared.baselineBundle,
429
+ schedule: declared.schedule,
430
+ observedAt: Math.floor(declared.scheduleAt / 1000),
431
+ });
432
+ const boundRecord = expectedRecord;
433
+ operation = Object.freeze({
434
+ owner: OWNER,
435
+ originAssociation: origin,
436
+ originalEntry: entries.entry,
437
+ preflightEntry: coverage,
438
+ actualAcknowledgement: acknowledgement,
439
+ record: boundRecord,
440
+ readTransport: readonlyDelegate,
441
+ });
442
+ configureFrame = Object.freeze({
443
+ owner: OWNER,
444
+ operation,
445
+ readPlan: configurePlan,
446
+ delegate: readonlyDelegate,
447
+ });
448
+ const before = {
449
+ GET: state.calls.filter((value) => value.method === "GET").length,
450
+ POST: state.calls.filter((value) => value.method === "POST").length,
451
+ records: state.records.length,
452
+ };
453
+ state.initialFinished = true;
454
+ const beforeCapture = Object.freeze({
455
+ samples: state.samples,
456
+ operationLoads: state.operationLoads,
457
+ });
458
+ // Load the actual actor only after real initial ACK and expanded C6 prerequisites.
459
+ const subject = await import("../preflight/configurePreflight.js");
460
+ const prerequisite = {
461
+ OWNER,
462
+ declared,
463
+ state,
464
+ basis: originalBasis,
465
+ expectedRecord,
466
+ expectedEvidence,
467
+ projected,
468
+ initialOutput,
469
+ acknowledgement,
470
+ boundRecord,
471
+ directOriginal: () =>
472
+ actual.projectRenewalConfigurationV2(goodConfiguration),
473
+ beforeCapture,
474
+ capture: subject.captureOwnedConfigurePreflightV2,
475
+ gates,
476
+ deltas: () => ({
477
+ GET:
478
+ state.calls.filter((value) => value.method === "GET").length -
479
+ before.GET,
480
+ POST:
481
+ state.calls.filter((value) => value.method === "POST").length -
482
+ before.POST,
483
+ records: state.records.length - before.records,
484
+ }),
485
+ async cleanup() {
486
+ await writeGates.cleanup();
487
+ await gates.cleanup();
488
+ vi.doUnmock("../c10/publicApi.js");
489
+ cleanPreflightMocks();
490
+ },
491
+ };
492
+ const preflightOutput = await prerequisite.capture().invoke();
493
+ assertPreflightPositive(prerequisite, preflightOutput);
494
+ assert.deepEqual(declared, write.baseline, "DECLARED_INPUT_PARITY");
495
+ assertFit(expectedRecord);
496
+ assertFit(preflightOutput);
497
+ const beforeWrite = {
498
+ calls: state.calls.length,
499
+ records: state.records.length,
500
+ };
501
+ const active = await installWriteAPIObservers(
502
+ () => family?.currentObservations() ?? writeState,
503
+ writeGates,
504
+ );
505
+ installWriteDigestAccounting(writeGates);
506
+ const writeDelegate = captureWriteTestDelegate(
507
+ client,
508
+ method,
509
+ () => family?.currentObservations() ?? writeState,
510
+ writeGates,
511
+ write.baseline.apiVersion,
512
+ );
513
+ family = await configureWriteTestFamily({
514
+ declared: write,
515
+ declarations,
516
+ owner: OWNER,
517
+ origin,
518
+ entry: entries.entry,
519
+ coverage: writeCoverage,
520
+ record: expectedRecord,
521
+ configuration: goodConfiguration,
522
+ preflightOutput,
523
+ acknowledgement,
524
+ plan: configurePlan,
525
+ delegate: writeDelegate,
526
+ request: projected,
527
+ firstState: writeState,
528
+ gates: writeGates,
529
+ advance,
530
+ });
531
+ const { rawReceipt, expectedReceipt, expectedACK } =
532
+ await establishWriteOracle(
533
+ active,
534
+ OWNER,
535
+ goodConfiguration,
536
+ projected,
537
+ write,
538
+ expectedRecord,
539
+ );
540
+ assert.deepEqual(
541
+ projected.payload,
542
+ write.expectedPayload,
543
+ "INDEPENDENT_COMPLETE_PAYLOAD_PREREQUISITE",
544
+ );
545
+ assertWriteTokenPreimages(prepared, expectedRecord, expectedReceipt);
546
+ assert.equal(writeGates.activeDigests.size, 0);
547
+ assert.equal(OWNER.basis, originalBasis);
548
+ logWritePrerequisites({
549
+ initialOutput,
550
+ preflightOutput,
551
+ expectedRecord,
552
+ rawReceipt,
553
+ expectedReceipt,
554
+ expectedACK,
555
+ request: projected,
556
+ state: writeState,
557
+ });
558
+ writeState.phase = "writer";
559
+ return {
560
+ ...prerequisite,
561
+ write,
562
+ writeState,
563
+ writeGates,
564
+ beforeWrite,
565
+ rawReceipt,
566
+ expectedReceipt,
567
+ expectedACK,
568
+ replayDeclaration: declareExpectedReplay(projected),
569
+ captureWriter: family.captureA,
570
+ fixedAOperation: family.fixedAOperation,
571
+ readFixedA: family.readFixedA,
572
+ captureReplayB: family.captureB,
573
+ captureReplayC: family.captureC,
574
+ replayStates: Object.freeze({ B: family.states.B, C: family.states.C }),
575
+ };
576
+ } catch (error) {
577
+ await writeGates.cleanup();
578
+ await gates.cleanup();
579
+ vi.doUnmock("../c10/publicApi.js");
580
+ cleanPreflightMocks();
581
+ throw error;
582
+ }
583
+ }
584
+
585
+ export type ConfigureWriteFixture = Awaited<
586
+ ReturnType<typeof configureWriteFixture>
587
+ >;