@fantastic.dev/better-stripe 0.40.0 → 0.42.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 (183) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +1 -1
  3. package/dist/client/balanceFundingWorkflow/client.d.ts +172 -0
  4. package/dist/client/balanceFundingWorkflow/client.d.ts.map +1 -0
  5. package/dist/client/balanceFundingWorkflow/client.js +289 -0
  6. package/dist/client/balanceFundingWorkflow/client.js.map +1 -0
  7. package/dist/client/billing/balanceFunding.d.ts +5 -0
  8. package/dist/client/billing/balanceFunding.d.ts.map +1 -1
  9. package/dist/client/billing/balanceFunding.js +30 -0
  10. package/dist/client/billing/balanceFunding.js.map +1 -1
  11. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +808 -2
  12. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  13. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +404 -1
  14. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  15. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +808 -2
  16. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  17. package/dist/client/connect/payoutSyncTestHelpers.d.ts +404 -1
  18. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  19. package/dist/client/costRecovery-invoices.d.ts +2 -2
  20. package/dist/client/costRecovery-invoices.d.ts.map +1 -1
  21. package/dist/client/costRecovery-invoices.js +4 -1
  22. package/dist/client/costRecovery-invoices.js.map +1 -1
  23. package/dist/client/costRecovery.d.ts +5 -2
  24. package/dist/client/costRecovery.d.ts.map +1 -1
  25. package/dist/client/costRecovery.js +3 -1
  26. package/dist/client/costRecovery.js.map +1 -1
  27. package/dist/client/index.d.ts +3 -0
  28. package/dist/client/index.d.ts.map +1 -1
  29. package/dist/client/index.js +4 -0
  30. package/dist/client/index.js.map +1 -1
  31. package/dist/client/recoveryWorkflow/client.d.ts +14 -0
  32. package/dist/client/recoveryWorkflow/client.d.ts.map +1 -0
  33. package/dist/client/recoveryWorkflow/client.js +34 -0
  34. package/dist/client/recoveryWorkflow/client.js.map +1 -0
  35. package/dist/client/recoveryWorkflow/contracts.d.ts +63 -0
  36. package/dist/client/recoveryWorkflow/contracts.d.ts.map +1 -0
  37. package/dist/client/recoveryWorkflow/contracts.js +11 -0
  38. package/dist/client/recoveryWorkflow/contracts.js.map +1 -0
  39. package/dist/client/recoveryWorkflow/provider.d.ts +10 -0
  40. package/dist/client/recoveryWorkflow/provider.d.ts.map +1 -0
  41. package/dist/client/recoveryWorkflow/provider.js +80 -0
  42. package/dist/client/recoveryWorkflow/provider.js.map +1 -0
  43. package/dist/client/recoveryWorkflow/settlement.d.ts +6 -0
  44. package/dist/client/recoveryWorkflow/settlement.d.ts.map +1 -0
  45. package/dist/client/recoveryWorkflow/settlement.js +43 -0
  46. package/dist/client/recoveryWorkflow/settlement.js.map +1 -0
  47. package/dist/component/_generated/api.d.ts +30 -0
  48. package/dist/component/_generated/api.d.ts.map +1 -1
  49. package/dist/component/_generated/api.js.map +1 -1
  50. package/dist/component/_generated/component.d.ts +637 -0
  51. package/dist/component/_generated/component.d.ts.map +1 -1
  52. package/dist/component/balanceFunding/helpers.d.ts +42 -0
  53. package/dist/component/balanceFunding/helpers.d.ts.map +1 -1
  54. package/dist/component/balanceFunding/internal/actions.d.ts +39 -0
  55. package/dist/component/balanceFunding/internal/actions.d.ts.map +1 -0
  56. package/dist/component/balanceFunding/internal/actions.js +80 -0
  57. package/dist/component/balanceFunding/internal/actions.js.map +1 -0
  58. package/dist/component/balanceFunding/internal/mutations.d.ts +55 -0
  59. package/dist/component/balanceFunding/internal/mutations.d.ts.map +1 -0
  60. package/dist/component/balanceFunding/internal/mutations.js +54 -0
  61. package/dist/component/balanceFunding/internal/mutations.js.map +1 -0
  62. package/dist/component/balanceFunding/internal/queries.d.ts +116 -0
  63. package/dist/component/balanceFunding/internal/queries.d.ts.map +1 -0
  64. package/dist/component/balanceFunding/internal/queries.js +35 -0
  65. package/dist/component/balanceFunding/internal/queries.js.map +1 -0
  66. package/dist/component/balanceFunding/internal/workflow.d.ts +10 -0
  67. package/dist/component/balanceFunding/internal/workflow.d.ts.map +1 -0
  68. package/dist/component/balanceFunding/internal/workflow.js +31 -0
  69. package/dist/component/balanceFunding/internal/workflow.js.map +1 -0
  70. package/dist/component/balanceFunding/lifecycleHandlers.d.ts +126 -0
  71. package/dist/component/balanceFunding/lifecycleHandlers.d.ts.map +1 -1
  72. package/dist/component/balanceFunding/mutations.d.ts +419 -16
  73. package/dist/component/balanceFunding/mutations.d.ts.map +1 -1
  74. package/dist/component/balanceFunding/mutations.js +24 -0
  75. package/dist/component/balanceFunding/mutations.js.map +1 -1
  76. package/dist/component/balanceFunding/preparationHandlers.d.ts +42 -0
  77. package/dist/component/balanceFunding/preparationHandlers.d.ts.map +1 -1
  78. package/dist/component/balanceFunding/queries.d.ts +78 -0
  79. package/dist/component/balanceFunding/queries.d.ts.map +1 -1
  80. package/dist/component/balanceFunding/queries.js +35 -0
  81. package/dist/component/balanceFunding/queries.js.map +1 -1
  82. package/dist/component/balanceFunding/receipt.d.ts +5 -0
  83. package/dist/component/balanceFunding/receipt.d.ts.map +1 -0
  84. package/dist/component/balanceFunding/receipt.js +37 -0
  85. package/dist/component/balanceFunding/receipt.js.map +1 -0
  86. package/dist/component/balanceFunding/schema.d.ts +506 -2
  87. package/dist/component/balanceFunding/schema.d.ts.map +1 -1
  88. package/dist/component/balanceFunding/schema.js +2 -0
  89. package/dist/component/balanceFunding/schema.js.map +1 -1
  90. package/dist/component/balanceFunding/stateHandlers.d.ts +42 -0
  91. package/dist/component/balanceFunding/stateHandlers.d.ts.map +1 -1
  92. package/dist/component/balanceFunding/workflowControl.d.ts +19 -0
  93. package/dist/component/balanceFunding/workflowControl.d.ts.map +1 -0
  94. package/dist/component/balanceFunding/workflowControl.js +149 -0
  95. package/dist/component/balanceFunding/workflowControl.js.map +1 -0
  96. package/dist/component/balanceFunding/workflowSchema.d.ts +356 -0
  97. package/dist/component/balanceFunding/workflowSchema.d.ts.map +1 -0
  98. package/dist/component/balanceFunding/workflowSchema.js +48 -0
  99. package/dist/component/balanceFunding/workflowSchema.js.map +1 -0
  100. package/dist/component/balanceFunding/workflowState.d.ts +157 -0
  101. package/dist/component/balanceFunding/workflowState.d.ts.map +1 -0
  102. package/dist/component/balanceFunding/workflowState.js +194 -0
  103. package/dist/component/balanceFunding/workflowState.js.map +1 -0
  104. package/dist/component/balanceFunding/workflowValidators.d.ts +306 -0
  105. package/dist/component/balanceFunding/workflowValidators.d.ts.map +1 -0
  106. package/dist/component/balanceFunding/workflowValidators.js +27 -0
  107. package/dist/component/balanceFunding/workflowValidators.js.map +1 -0
  108. package/dist/component/earnings/triggers.d.ts +280 -2
  109. package/dist/component/earnings/triggers.d.ts.map +1 -1
  110. package/dist/component/payoutRelease/queries.d.ts +2 -2
  111. package/dist/component/payoutRelease/queries.d.ts.map +1 -1
  112. package/dist/component/recoveryWorkflow/bridge.d.ts +21 -0
  113. package/dist/component/recoveryWorkflow/bridge.d.ts.map +1 -0
  114. package/dist/component/recoveryWorkflow/bridge.js +52 -0
  115. package/dist/component/recoveryWorkflow/bridge.js.map +1 -0
  116. package/dist/component/recoveryWorkflow/helpers.d.ts +83 -0
  117. package/dist/component/recoveryWorkflow/helpers.d.ts.map +1 -0
  118. package/dist/component/recoveryWorkflow/helpers.js +48 -0
  119. package/dist/component/recoveryWorkflow/helpers.js.map +1 -0
  120. package/dist/component/recoveryWorkflow/mutations.d.ts +91 -0
  121. package/dist/component/recoveryWorkflow/mutations.d.ts.map +1 -0
  122. package/dist/component/recoveryWorkflow/mutations.js +177 -0
  123. package/dist/component/recoveryWorkflow/mutations.js.map +1 -0
  124. package/dist/component/recoveryWorkflow/queries.d.ts +118 -0
  125. package/dist/component/recoveryWorkflow/queries.d.ts.map +1 -0
  126. package/dist/component/recoveryWorkflow/queries.js +20 -0
  127. package/dist/component/recoveryWorkflow/queries.js.map +1 -0
  128. package/dist/component/recoveryWorkflow/schema.d.ts +653 -0
  129. package/dist/component/recoveryWorkflow/schema.d.ts.map +1 -0
  130. package/dist/component/recoveryWorkflow/schema.js +81 -0
  131. package/dist/component/recoveryWorkflow/schema.js.map +1 -0
  132. package/dist/component/recoveryWorkflow/steps.d.ts +70 -0
  133. package/dist/component/recoveryWorkflow/steps.d.ts.map +1 -0
  134. package/dist/component/recoveryWorkflow/steps.js +94 -0
  135. package/dist/component/recoveryWorkflow/steps.js.map +1 -0
  136. package/dist/component/recoveryWorkflow/workflow.d.ts +22 -0
  137. package/dist/component/recoveryWorkflow/workflow.d.ts.map +1 -0
  138. package/dist/component/recoveryWorkflow/workflow.js +56 -0
  139. package/dist/component/recoveryWorkflow/workflow.js.map +1 -0
  140. package/dist/component/schema.d.ts +404 -1
  141. package/dist/component/schema.js +3 -0
  142. package/dist/component/schema.js.map +1 -1
  143. package/package.json +1 -1
  144. package/src/client/balanceFundingWorkflow/capture.test.ts +144 -0
  145. package/src/client/balanceFundingWorkflow/client.ts +419 -0
  146. package/src/client/billing/balanceFunding.ts +50 -0
  147. package/src/client/costRecovery-invoices.ts +6 -0
  148. package/src/client/costRecovery.ts +8 -3
  149. package/src/client/index.ts +15 -0
  150. package/src/client/recoveryWorkflow/client.test.ts +37 -0
  151. package/src/client/recoveryWorkflow/client.ts +76 -0
  152. package/src/client/recoveryWorkflow/contracts.ts +72 -0
  153. package/src/client/recoveryWorkflow/provider.test.ts +424 -0
  154. package/src/client/recoveryWorkflow/provider.ts +119 -0
  155. package/src/client/recoveryWorkflow/settlement.ts +67 -0
  156. package/src/component/_generated/api.ts +30 -0
  157. package/src/component/_generated/component.ts +746 -0
  158. package/src/component/balanceFunding/internal/actions.ts +107 -0
  159. package/src/component/balanceFunding/internal/mutations.ts +66 -0
  160. package/src/component/balanceFunding/internal/queries.ts +34 -0
  161. package/src/component/balanceFunding/internal/workflow.ts +49 -0
  162. package/src/component/balanceFunding/mutations.ts +34 -0
  163. package/src/component/balanceFunding/queries.ts +38 -0
  164. package/src/component/balanceFunding/receipt.ts +48 -0
  165. package/src/component/balanceFunding/schema.ts +2 -0
  166. package/src/component/balanceFunding/scopeLookup.test.ts +94 -0
  167. package/src/component/balanceFunding/workflow.fixtures.ts +366 -0
  168. package/src/component/balanceFunding/workflow.test.ts +552 -0
  169. package/src/component/balanceFunding/workflowControl.ts +198 -0
  170. package/src/component/balanceFunding/workflowSchema.ts +78 -0
  171. package/src/component/balanceFunding/workflowState.ts +285 -0
  172. package/src/component/balanceFunding/workflowValidators.ts +40 -0
  173. package/src/component/recoveryWorkflow/bridge.test.ts +481 -0
  174. package/src/component/recoveryWorkflow/bridge.ts +66 -0
  175. package/src/component/recoveryWorkflow/helpers.ts +58 -0
  176. package/src/component/recoveryWorkflow/journal.test.ts +104 -0
  177. package/src/component/recoveryWorkflow/mutations.ts +224 -0
  178. package/src/component/recoveryWorkflow/queries.ts +19 -0
  179. package/src/component/recoveryWorkflow/schema.ts +92 -0
  180. package/src/component/recoveryWorkflow/state.test.ts +191 -0
  181. package/src/component/recoveryWorkflow/steps.ts +97 -0
  182. package/src/component/recoveryWorkflow/workflow.ts +73 -0
  183. package/src/component/schema.ts +6 -0
@@ -506,6 +506,65 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
506
506
  retryable: true;
507
507
  status: "not_ready";
508
508
  }, Name>;
509
+ cancelWorkflow: FunctionReference<"mutation", "internal", {
510
+ accountId: string;
511
+ definitionVersion: string;
512
+ operationId: string;
513
+ providerApiVersion: string;
514
+ scopeKey: string;
515
+ stripeSubscriptionId: string;
516
+ version: number;
517
+ }, {
518
+ accountId: string;
519
+ cancelRequested: boolean;
520
+ failureCode?: "invalid_scope" | "unsupported_source" | "policy_invalid";
521
+ operationId: string;
522
+ scopeKey: string;
523
+ state: "pending" | "running" | "unknown" | "succeeded" | "canceled" | "failed";
524
+ version: number;
525
+ }, Name>;
526
+ claimProviderPhase: FunctionReference<"mutation", "internal", {
527
+ accountId: string;
528
+ definitionVersion: string;
529
+ operationId: string;
530
+ phase: "create" | "attach" | "apply";
531
+ providerApiVersion: string;
532
+ providerKey: string;
533
+ scopeKey: string;
534
+ stripeSubscriptionId: string;
535
+ version: number;
536
+ }, {
537
+ mode: "execute" | "reconcile";
538
+ paymentMethodId?: string;
539
+ status: "claimed";
540
+ } | {
541
+ status: "ready";
542
+ value: {
543
+ customerAccount: string;
544
+ enabled?: boolean;
545
+ paymentMethodId: string | null;
546
+ paymentMethodTypes?: Array<string> | null;
547
+ phase: "create" | "attach" | "apply";
548
+ providerApiVersion: string;
549
+ stripeSubscriptionId: string;
550
+ };
551
+ } | {
552
+ reason: "provider_outcome_unknown" | "history_incomplete";
553
+ retryable: false;
554
+ status: "unknown";
555
+ } | {
556
+ reason: "scope_busy" | "identity_changed" | "revision_changed";
557
+ retryable: false;
558
+ status: "conflict";
559
+ } | {
560
+ reason: "invalid_scope" | "unsupported_source" | "policy_invalid";
561
+ retryable: false;
562
+ status: "rejected";
563
+ } | {
564
+ reason: "provider_pending";
565
+ retryable: true;
566
+ status: "not_ready";
567
+ }, Name>;
509
568
  failBeforeStart: FunctionReference<"mutation", "internal", {
510
569
  accountId: string;
511
570
  failureCode: "invalid_scope" | "unsupported_source" | "policy_invalid";
@@ -518,6 +577,48 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
518
577
  accountId: string;
519
578
  cancelRequested: boolean;
520
579
  enabled: boolean;
580
+ execution?: {
581
+ apply?: {
582
+ receipt?: {
583
+ customerAccount: string;
584
+ enabled?: boolean;
585
+ paymentMethodId: string | null;
586
+ paymentMethodTypes?: Array<string> | null;
587
+ phase: "create" | "attach" | "apply";
588
+ providerApiVersion: string;
589
+ stripeSubscriptionId: string;
590
+ };
591
+ state: "running" | "unknown" | "succeeded";
592
+ };
593
+ attach?: {
594
+ receipt?: {
595
+ customerAccount: string;
596
+ enabled?: boolean;
597
+ paymentMethodId: string | null;
598
+ paymentMethodTypes?: Array<string> | null;
599
+ phase: "create" | "attach" | "apply";
600
+ providerApiVersion: string;
601
+ stripeSubscriptionId: string;
602
+ };
603
+ state: "running" | "unknown" | "succeeded";
604
+ };
605
+ create?: {
606
+ receipt?: {
607
+ customerAccount: string;
608
+ enabled?: boolean;
609
+ paymentMethodId: string | null;
610
+ paymentMethodTypes?: Array<string> | null;
611
+ phase: "create" | "attach" | "apply";
612
+ providerApiVersion: string;
613
+ stripeSubscriptionId: string;
614
+ };
615
+ state: "running" | "unknown" | "succeeded";
616
+ };
617
+ definitionVersion: string;
618
+ providerAction: string;
619
+ providerApiVersion: string;
620
+ workflowId?: string;
621
+ };
521
622
  failureCode?: "invalid_scope" | "unsupported_source" | "policy_invalid";
522
623
  kind: "prepare" | "apply";
523
624
  preparationId: string;
@@ -558,6 +659,48 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
558
659
  accountId: string;
559
660
  cancelRequested: boolean;
560
661
  enabled: boolean;
662
+ execution?: {
663
+ apply?: {
664
+ receipt?: {
665
+ customerAccount: string;
666
+ enabled?: boolean;
667
+ paymentMethodId: string | null;
668
+ paymentMethodTypes?: Array<string> | null;
669
+ phase: "create" | "attach" | "apply";
670
+ providerApiVersion: string;
671
+ stripeSubscriptionId: string;
672
+ };
673
+ state: "running" | "unknown" | "succeeded";
674
+ };
675
+ attach?: {
676
+ receipt?: {
677
+ customerAccount: string;
678
+ enabled?: boolean;
679
+ paymentMethodId: string | null;
680
+ paymentMethodTypes?: Array<string> | null;
681
+ phase: "create" | "attach" | "apply";
682
+ providerApiVersion: string;
683
+ stripeSubscriptionId: string;
684
+ };
685
+ state: "running" | "unknown" | "succeeded";
686
+ };
687
+ create?: {
688
+ receipt?: {
689
+ customerAccount: string;
690
+ enabled?: boolean;
691
+ paymentMethodId: string | null;
692
+ paymentMethodTypes?: Array<string> | null;
693
+ phase: "create" | "attach" | "apply";
694
+ providerApiVersion: string;
695
+ stripeSubscriptionId: string;
696
+ };
697
+ state: "running" | "unknown" | "succeeded";
698
+ };
699
+ definitionVersion: string;
700
+ providerAction: string;
701
+ providerApiVersion: string;
702
+ workflowId?: string;
703
+ };
561
704
  failureCode?: "invalid_scope" | "unsupported_source" | "policy_invalid";
562
705
  kind: "prepare" | "apply";
563
706
  preparationId: string;
@@ -598,6 +741,48 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
598
741
  accountId: string;
599
742
  cancelRequested: boolean;
600
743
  enabled: boolean;
744
+ execution?: {
745
+ apply?: {
746
+ receipt?: {
747
+ customerAccount: string;
748
+ enabled?: boolean;
749
+ paymentMethodId: string | null;
750
+ paymentMethodTypes?: Array<string> | null;
751
+ phase: "create" | "attach" | "apply";
752
+ providerApiVersion: string;
753
+ stripeSubscriptionId: string;
754
+ };
755
+ state: "running" | "unknown" | "succeeded";
756
+ };
757
+ attach?: {
758
+ receipt?: {
759
+ customerAccount: string;
760
+ enabled?: boolean;
761
+ paymentMethodId: string | null;
762
+ paymentMethodTypes?: Array<string> | null;
763
+ phase: "create" | "attach" | "apply";
764
+ providerApiVersion: string;
765
+ stripeSubscriptionId: string;
766
+ };
767
+ state: "running" | "unknown" | "succeeded";
768
+ };
769
+ create?: {
770
+ receipt?: {
771
+ customerAccount: string;
772
+ enabled?: boolean;
773
+ paymentMethodId: string | null;
774
+ paymentMethodTypes?: Array<string> | null;
775
+ phase: "create" | "attach" | "apply";
776
+ providerApiVersion: string;
777
+ stripeSubscriptionId: string;
778
+ };
779
+ state: "running" | "unknown" | "succeeded";
780
+ };
781
+ definitionVersion: string;
782
+ providerAction: string;
783
+ providerApiVersion: string;
784
+ workflowId?: string;
785
+ };
601
786
  failureCode?: "invalid_scope" | "unsupported_source" | "policy_invalid";
602
787
  kind: "prepare" | "apply";
603
788
  preparationId: string;
@@ -661,6 +846,48 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
661
846
  accountId: string;
662
847
  cancelRequested: boolean;
663
848
  enabled: boolean;
849
+ execution?: {
850
+ apply?: {
851
+ receipt?: {
852
+ customerAccount: string;
853
+ enabled?: boolean;
854
+ paymentMethodId: string | null;
855
+ paymentMethodTypes?: Array<string> | null;
856
+ phase: "create" | "attach" | "apply";
857
+ providerApiVersion: string;
858
+ stripeSubscriptionId: string;
859
+ };
860
+ state: "running" | "unknown" | "succeeded";
861
+ };
862
+ attach?: {
863
+ receipt?: {
864
+ customerAccount: string;
865
+ enabled?: boolean;
866
+ paymentMethodId: string | null;
867
+ paymentMethodTypes?: Array<string> | null;
868
+ phase: "create" | "attach" | "apply";
869
+ providerApiVersion: string;
870
+ stripeSubscriptionId: string;
871
+ };
872
+ state: "running" | "unknown" | "succeeded";
873
+ };
874
+ create?: {
875
+ receipt?: {
876
+ customerAccount: string;
877
+ enabled?: boolean;
878
+ paymentMethodId: string | null;
879
+ paymentMethodTypes?: Array<string> | null;
880
+ phase: "create" | "attach" | "apply";
881
+ providerApiVersion: string;
882
+ stripeSubscriptionId: string;
883
+ };
884
+ state: "running" | "unknown" | "succeeded";
885
+ };
886
+ definitionVersion: string;
887
+ providerAction: string;
888
+ providerApiVersion: string;
889
+ workflowId?: string;
890
+ };
664
891
  failureCode?: "invalid_scope" | "unsupported_source" | "policy_invalid";
665
892
  kind: "prepare" | "apply";
666
893
  preparationId: string;
@@ -731,6 +958,48 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
731
958
  accountId: string;
732
959
  cancelRequested: boolean;
733
960
  enabled: boolean;
961
+ execution?: {
962
+ apply?: {
963
+ receipt?: {
964
+ customerAccount: string;
965
+ enabled?: boolean;
966
+ paymentMethodId: string | null;
967
+ paymentMethodTypes?: Array<string> | null;
968
+ phase: "create" | "attach" | "apply";
969
+ providerApiVersion: string;
970
+ stripeSubscriptionId: string;
971
+ };
972
+ state: "running" | "unknown" | "succeeded";
973
+ };
974
+ attach?: {
975
+ receipt?: {
976
+ customerAccount: string;
977
+ enabled?: boolean;
978
+ paymentMethodId: string | null;
979
+ paymentMethodTypes?: Array<string> | null;
980
+ phase: "create" | "attach" | "apply";
981
+ providerApiVersion: string;
982
+ stripeSubscriptionId: string;
983
+ };
984
+ state: "running" | "unknown" | "succeeded";
985
+ };
986
+ create?: {
987
+ receipt?: {
988
+ customerAccount: string;
989
+ enabled?: boolean;
990
+ paymentMethodId: string | null;
991
+ paymentMethodTypes?: Array<string> | null;
992
+ phase: "create" | "attach" | "apply";
993
+ providerApiVersion: string;
994
+ stripeSubscriptionId: string;
995
+ };
996
+ state: "running" | "unknown" | "succeeded";
997
+ };
998
+ definitionVersion: string;
999
+ providerAction: string;
1000
+ providerApiVersion: string;
1001
+ workflowId?: string;
1002
+ };
734
1003
  failureCode?: "invalid_scope" | "unsupported_source" | "policy_invalid";
735
1004
  kind: "prepare" | "apply";
736
1005
  preparationId: string;
@@ -752,6 +1021,48 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
752
1021
  state: "pending" | "running" | "unknown" | "succeeded" | "canceled" | "failed";
753
1022
  version: number;
754
1023
  }, Name>;
1024
+ resumeWorkflow: FunctionReference<"mutation", "internal", {
1025
+ accountId: string;
1026
+ definitionVersion: string;
1027
+ operationId: string;
1028
+ providerApiVersion: string;
1029
+ scopeKey: string;
1030
+ stripeSubscriptionId: string;
1031
+ version: number;
1032
+ }, {
1033
+ operation: {
1034
+ accountId: string;
1035
+ operationId: string;
1036
+ scopeKey: string;
1037
+ version: number;
1038
+ };
1039
+ status: "accepted";
1040
+ workflowId?: string;
1041
+ } | {
1042
+ operation: {
1043
+ accountId: string;
1044
+ operationId: string;
1045
+ scopeKey: string;
1046
+ version: number;
1047
+ };
1048
+ status: "canceled";
1049
+ } | {
1050
+ reason: "provider_outcome_unknown" | "history_incomplete";
1051
+ retryable: false;
1052
+ status: "unknown";
1053
+ } | {
1054
+ reason: "scope_busy" | "identity_changed" | "revision_changed";
1055
+ retryable: false;
1056
+ status: "conflict";
1057
+ } | {
1058
+ reason: "invalid_scope" | "unsupported_source" | "policy_invalid";
1059
+ retryable: false;
1060
+ status: "rejected";
1061
+ } | {
1062
+ reason: "provider_pending";
1063
+ retryable: true;
1064
+ status: "not_ready";
1065
+ }, Name>;
755
1066
  savePreparation: FunctionReference<"mutation", "internal", {
756
1067
  accountId: string;
757
1068
  consentAt: number;
@@ -786,6 +1097,48 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
786
1097
  accountId: string;
787
1098
  cancelRequested: boolean;
788
1099
  enabled: boolean;
1100
+ execution?: {
1101
+ apply?: {
1102
+ receipt?: {
1103
+ customerAccount: string;
1104
+ enabled?: boolean;
1105
+ paymentMethodId: string | null;
1106
+ paymentMethodTypes?: Array<string> | null;
1107
+ phase: "create" | "attach" | "apply";
1108
+ providerApiVersion: string;
1109
+ stripeSubscriptionId: string;
1110
+ };
1111
+ state: "running" | "unknown" | "succeeded";
1112
+ };
1113
+ attach?: {
1114
+ receipt?: {
1115
+ customerAccount: string;
1116
+ enabled?: boolean;
1117
+ paymentMethodId: string | null;
1118
+ paymentMethodTypes?: Array<string> | null;
1119
+ phase: "create" | "attach" | "apply";
1120
+ providerApiVersion: string;
1121
+ stripeSubscriptionId: string;
1122
+ };
1123
+ state: "running" | "unknown" | "succeeded";
1124
+ };
1125
+ create?: {
1126
+ receipt?: {
1127
+ customerAccount: string;
1128
+ enabled?: boolean;
1129
+ paymentMethodId: string | null;
1130
+ paymentMethodTypes?: Array<string> | null;
1131
+ phase: "create" | "attach" | "apply";
1132
+ providerApiVersion: string;
1133
+ stripeSubscriptionId: string;
1134
+ };
1135
+ state: "running" | "unknown" | "succeeded";
1136
+ };
1137
+ definitionVersion: string;
1138
+ providerAction: string;
1139
+ providerApiVersion: string;
1140
+ workflowId?: string;
1141
+ };
789
1142
  failureCode?: "invalid_scope" | "unsupported_source" | "policy_invalid";
790
1143
  kind: "prepare" | "apply";
791
1144
  preparationId: string;
@@ -807,6 +1160,49 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
807
1160
  state: "pending" | "running" | "unknown" | "succeeded" | "canceled" | "failed";
808
1161
  version: number;
809
1162
  }, Name>;
1163
+ startWorkflow: FunctionReference<"mutation", "internal", {
1164
+ accountId: string;
1165
+ definitionVersion: string;
1166
+ operationId: string;
1167
+ providerAction: string;
1168
+ providerApiVersion: string;
1169
+ scopeKey: string;
1170
+ stripeSubscriptionId: string;
1171
+ version: number;
1172
+ }, {
1173
+ operation: {
1174
+ accountId: string;
1175
+ operationId: string;
1176
+ scopeKey: string;
1177
+ version: number;
1178
+ };
1179
+ status: "accepted";
1180
+ workflowId?: string;
1181
+ } | {
1182
+ operation: {
1183
+ accountId: string;
1184
+ operationId: string;
1185
+ scopeKey: string;
1186
+ version: number;
1187
+ };
1188
+ status: "canceled";
1189
+ } | {
1190
+ reason: "provider_outcome_unknown" | "history_incomplete";
1191
+ retryable: false;
1192
+ status: "unknown";
1193
+ } | {
1194
+ reason: "scope_busy" | "identity_changed" | "revision_changed";
1195
+ retryable: false;
1196
+ status: "conflict";
1197
+ } | {
1198
+ reason: "invalid_scope" | "unsupported_source" | "policy_invalid";
1199
+ retryable: false;
1200
+ status: "rejected";
1201
+ } | {
1202
+ reason: "provider_pending";
1203
+ retryable: true;
1204
+ status: "not_ready";
1205
+ }, Name>;
810
1206
  };
811
1207
  queries: {
812
1208
  findPreparationOperation: FunctionReference<"query", "internal", {
@@ -894,6 +1290,48 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
894
1290
  accountId: string;
895
1291
  cancelRequested: boolean;
896
1292
  enabled: boolean;
1293
+ execution?: {
1294
+ apply?: {
1295
+ receipt?: {
1296
+ customerAccount: string;
1297
+ enabled?: boolean;
1298
+ paymentMethodId: string | null;
1299
+ paymentMethodTypes?: Array<string> | null;
1300
+ phase: "create" | "attach" | "apply";
1301
+ providerApiVersion: string;
1302
+ stripeSubscriptionId: string;
1303
+ };
1304
+ state: "running" | "unknown" | "succeeded";
1305
+ };
1306
+ attach?: {
1307
+ receipt?: {
1308
+ customerAccount: string;
1309
+ enabled?: boolean;
1310
+ paymentMethodId: string | null;
1311
+ paymentMethodTypes?: Array<string> | null;
1312
+ phase: "create" | "attach" | "apply";
1313
+ providerApiVersion: string;
1314
+ stripeSubscriptionId: string;
1315
+ };
1316
+ state: "running" | "unknown" | "succeeded";
1317
+ };
1318
+ create?: {
1319
+ receipt?: {
1320
+ customerAccount: string;
1321
+ enabled?: boolean;
1322
+ paymentMethodId: string | null;
1323
+ paymentMethodTypes?: Array<string> | null;
1324
+ phase: "create" | "attach" | "apply";
1325
+ providerApiVersion: string;
1326
+ stripeSubscriptionId: string;
1327
+ };
1328
+ state: "running" | "unknown" | "succeeded";
1329
+ };
1330
+ definitionVersion: string;
1331
+ providerAction: string;
1332
+ providerApiVersion: string;
1333
+ workflowId?: string;
1334
+ };
897
1335
  failureCode?: "invalid_scope" | "unsupported_source" | "policy_invalid";
898
1336
  kind: "prepare" | "apply";
899
1337
  preparationId: string;
@@ -942,6 +1380,41 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
942
1380
  startsPaused: boolean;
943
1381
  verified: boolean;
944
1382
  } | null, Name>;
1383
+ readScopePreparation: FunctionReference<"query", "internal", {
1384
+ accountId: string;
1385
+ providerApiVersion: string;
1386
+ scopeKey: string;
1387
+ stripeSubscriptionId: string;
1388
+ }, {
1389
+ _creationTime: number;
1390
+ _id: string;
1391
+ accountId: string;
1392
+ activeOperationId?: string;
1393
+ consentAt: number;
1394
+ consentReference: string;
1395
+ enabled: boolean;
1396
+ operationVersion: number;
1397
+ preparation: {
1398
+ customerAccount: string;
1399
+ paymentMethodId?: string;
1400
+ previousPaymentMethodId: string | null;
1401
+ previousPaymentMethodTypes: Array<string> | null;
1402
+ stripeSubscriptionId: string;
1403
+ };
1404
+ preparationOperationId?: string;
1405
+ providerApiVersion: string;
1406
+ scopeKey: string;
1407
+ startsPaused: boolean;
1408
+ verified: boolean;
1409
+ } | {
1410
+ reason: "scope_busy" | "identity_changed" | "revision_changed";
1411
+ retryable: false;
1412
+ status: "conflict";
1413
+ } | {
1414
+ reason: "invalid_scope";
1415
+ retryable: false;
1416
+ status: "rejected";
1417
+ } | null, Name>;
945
1418
  };
946
1419
  };
947
1420
  billing: {
@@ -5188,6 +5661,170 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
5188
5661
  }, Name>;
5189
5662
  };
5190
5663
  };
5664
+ recoveryWorkflow: {
5665
+ mutations: {
5666
+ requestCancel: FunctionReference<"mutation", "internal", {
5667
+ accountId: string;
5668
+ currency: string;
5669
+ groupKey: string;
5670
+ operationId: string;
5671
+ scopeKey: string;
5672
+ version: number;
5673
+ }, {
5674
+ accountId: string;
5675
+ cancelRequested: boolean;
5676
+ currency: string;
5677
+ groupKey: string;
5678
+ operationId: string;
5679
+ outcome?: "collect" | "release";
5680
+ scopeKey: string;
5681
+ sourceId: string;
5682
+ sourceKind: "settlement" | "invoice";
5683
+ status: "queued" | "running" | "waiting" | "unknown" | "completed" | "canceled";
5684
+ version: number;
5685
+ }, Name>;
5686
+ resume: FunctionReference<"mutation", "internal", {
5687
+ accountId: string;
5688
+ currency: string;
5689
+ groupKey: string;
5690
+ operationId: string;
5691
+ scopeKey: string;
5692
+ version: number;
5693
+ }, {
5694
+ accountId: string;
5695
+ cancelRequested: boolean;
5696
+ currency: string;
5697
+ groupKey: string;
5698
+ operationId: string;
5699
+ outcome?: "collect" | "release";
5700
+ scopeKey: string;
5701
+ sourceId: string;
5702
+ sourceKind: "settlement" | "invoice";
5703
+ status: "queued" | "running" | "waiting" | "unknown" | "completed" | "canceled";
5704
+ version: number;
5705
+ }, Name>;
5706
+ start: FunctionReference<"mutation", "internal", {
5707
+ accountId: string;
5708
+ allocation?: {
5709
+ adjustmentAmount?: number;
5710
+ currency: string;
5711
+ gross: number;
5712
+ paymentId?: string;
5713
+ paymentIntentId?: string;
5714
+ platformNet: number;
5715
+ processingFee: number;
5716
+ sourceChargeId: string;
5717
+ sourceInvoiceId?: string;
5718
+ transfers: Array<{
5719
+ amount: number;
5720
+ destinationAccountId: string;
5721
+ role: "store" | "affiliate" | "other";
5722
+ }>;
5723
+ };
5724
+ completion?: string;
5725
+ currency: string;
5726
+ definitionVersion: number;
5727
+ groupKey: string;
5728
+ maxAttempts: number;
5729
+ provider: string;
5730
+ providerApiVersion: string;
5731
+ releaseUncollectible: boolean;
5732
+ requestKey: string;
5733
+ retryDelayMs: number;
5734
+ scopeKey: string;
5735
+ }, {
5736
+ accountId: string;
5737
+ cancelRequested: boolean;
5738
+ currency: string;
5739
+ groupKey: string;
5740
+ operationId: string;
5741
+ outcome?: "collect" | "release";
5742
+ scopeKey: string;
5743
+ sourceId: string;
5744
+ sourceKind: "settlement" | "invoice";
5745
+ status: "queued" | "running" | "waiting" | "unknown" | "completed" | "canceled";
5746
+ version: number;
5747
+ } | {
5748
+ reason: "identity_changed";
5749
+ retryable: false;
5750
+ status: "conflict";
5751
+ } | {
5752
+ reason: "history_incomplete";
5753
+ retryable: true;
5754
+ status: "not_ready";
5755
+ }, Name>;
5756
+ };
5757
+ queries: {
5758
+ get: FunctionReference<"query", "internal", {
5759
+ accountId: string;
5760
+ currency: string;
5761
+ groupKey: string;
5762
+ operationId: string;
5763
+ scopeKey: string;
5764
+ version: number;
5765
+ }, {
5766
+ accountId: string;
5767
+ cancelRequested: boolean;
5768
+ currency: string;
5769
+ groupKey: string;
5770
+ operationId: string;
5771
+ outcome?: "collect" | "release";
5772
+ scopeKey: string;
5773
+ sourceId: string;
5774
+ sourceKind: "settlement" | "invoice";
5775
+ status: "queued" | "running" | "waiting" | "unknown" | "completed" | "canceled";
5776
+ version: number;
5777
+ }, Name>;
5778
+ snapshot: FunctionReference<"query", "internal", {
5779
+ accountId: string;
5780
+ currency: string;
5781
+ groupKey: string;
5782
+ operationId: string;
5783
+ scopeKey: string;
5784
+ version: number;
5785
+ }, {
5786
+ _creationTime: number;
5787
+ _id: string;
5788
+ accountId: string;
5789
+ activePhase?: "execute" | "reconcile";
5790
+ allocation?: {
5791
+ adjustmentAmount?: number;
5792
+ currency: string;
5793
+ gross: number;
5794
+ paymentId?: string;
5795
+ paymentIntentId?: string;
5796
+ platformNet: number;
5797
+ processingFee: number;
5798
+ sourceChargeId: string;
5799
+ sourceInvoiceId?: string;
5800
+ transfers: Array<{
5801
+ amount: number;
5802
+ destinationAccountId: string;
5803
+ role: "store" | "affiliate" | "other";
5804
+ }>;
5805
+ };
5806
+ cancelRequested: boolean;
5807
+ completion?: string;
5808
+ currency: string;
5809
+ definitionVersion: number;
5810
+ groupKey: string;
5811
+ maxAttempts: number;
5812
+ outcome?: "collect" | "release";
5813
+ provider: string;
5814
+ providerApiVersion: string;
5815
+ providerStarted: boolean;
5816
+ releaseUncollectible: boolean;
5817
+ resumeQueued: boolean;
5818
+ retryDelayMs: number;
5819
+ scopeKey: string;
5820
+ sourceId: string;
5821
+ sourceKind: "settlement" | "invoice";
5822
+ status: "queued" | "running" | "waiting" | "unknown" | "completed" | "canceled";
5823
+ version: number;
5824
+ workflowId?: string;
5825
+ }, Name>;
5826
+ };
5827
+ };
5191
5828
  refundHistory: {
5192
5829
  mutations: {
5193
5830
  normalizeRefundCommandBindings: FunctionReference<"mutation", "internal", {