@fantastic.dev/better-stripe 0.53.0 → 0.55.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 (184) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +1 -1
  3. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +226 -34
  4. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  5. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +97 -1
  6. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  7. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +226 -34
  8. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutSyncTestHelpers.d.ts +97 -1
  10. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  11. package/dist/client/index.d.ts +8 -0
  12. package/dist/client/index.d.ts.map +1 -1
  13. package/dist/client/index.js +1 -0
  14. package/dist/client/index.js.map +1 -1
  15. package/dist/client/usage/client.d.ts +2 -2
  16. package/dist/client/usage/client.d.ts.map +1 -1
  17. package/dist/client/usage/client.js +3 -3
  18. package/dist/client/usage/client.js.map +1 -1
  19. package/dist/client/usage/deliveryClient.d.ts +64 -0
  20. package/dist/client/usage/deliveryClient.d.ts.map +1 -0
  21. package/dist/client/usage/deliveryClient.js +60 -0
  22. package/dist/client/usage/deliveryClient.js.map +1 -0
  23. package/dist/client/usage/deliveryProtocol.d.ts +130 -0
  24. package/dist/client/usage/deliveryProtocol.d.ts.map +1 -0
  25. package/dist/client/usage/deliveryProtocol.js +21 -0
  26. package/dist/client/usage/deliveryProtocol.js.map +1 -0
  27. package/dist/client/usage/deliveryProvider.d.ts +32 -0
  28. package/dist/client/usage/deliveryProvider.d.ts.map +1 -0
  29. package/dist/client/usage/deliveryProvider.js +127 -0
  30. package/dist/client/usage/deliveryProvider.js.map +1 -0
  31. package/dist/client/usage/index.d.ts +8 -0
  32. package/dist/client/usage/index.d.ts.map +1 -1
  33. package/dist/client/usage/index.js +1 -0
  34. package/dist/client/usage/index.js.map +1 -1
  35. package/dist/client/usage/invoiceObservation.d.ts +38 -0
  36. package/dist/client/usage/invoiceObservation.d.ts.map +1 -0
  37. package/dist/client/usage/invoiceObservation.js +157 -0
  38. package/dist/client/usage/invoiceObservation.js.map +1 -0
  39. package/dist/client/usage/observationClient.d.ts +83 -0
  40. package/dist/client/usage/observationClient.d.ts.map +1 -0
  41. package/dist/client/usage/observationClient.js +157 -0
  42. package/dist/client/usage/observationClient.js.map +1 -0
  43. package/dist/client/usage/observationTypes.d.ts +63 -0
  44. package/dist/client/usage/observationTypes.d.ts.map +1 -0
  45. package/dist/client/usage/observationTypes.js +59 -0
  46. package/dist/client/usage/observationTypes.js.map +1 -0
  47. package/dist/client/usage/providerObservation.d.ts +4 -0
  48. package/dist/client/usage/providerObservation.d.ts.map +1 -0
  49. package/dist/client/usage/providerObservation.js +96 -0
  50. package/dist/client/usage/providerObservation.js.map +1 -0
  51. package/dist/client/usage/reconciliation.d.ts +12 -0
  52. package/dist/client/usage/reconciliation.d.ts.map +1 -0
  53. package/dist/client/usage/reconciliation.js +48 -0
  54. package/dist/client/usage/reconciliation.js.map +1 -0
  55. package/dist/client/usage/summary.d.ts +50 -0
  56. package/dist/client/usage/summary.d.ts.map +1 -0
  57. package/dist/client/usage/summary.js +110 -0
  58. package/dist/client/usage/summary.js.map +1 -0
  59. package/dist/client/webhooks/handler.d.ts.map +1 -1
  60. package/dist/client/webhooks/handler.js +2 -1
  61. package/dist/client/webhooks/handler.js.map +1 -1
  62. package/dist/client/webhooks/meterErrors.d.ts +5 -0
  63. package/dist/client/webhooks/meterErrors.d.ts.map +1 -0
  64. package/dist/client/webhooks/meterErrors.js +98 -0
  65. package/dist/client/webhooks/meterErrors.js.map +1 -0
  66. package/dist/client/webhooks/v2.d.ts.map +1 -1
  67. package/dist/client/webhooks/v2.js +5 -0
  68. package/dist/client/webhooks/v2.js.map +1 -1
  69. package/dist/component/_generated/api.d.ts +22 -0
  70. package/dist/component/_generated/api.d.ts.map +1 -1
  71. package/dist/component/_generated/api.js.map +1 -1
  72. package/dist/component/_generated/component.d.ts +265 -0
  73. package/dist/component/_generated/component.d.ts.map +1 -1
  74. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  75. package/dist/component/balanceFunding/mutations.d.ts +27 -27
  76. package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
  77. package/dist/component/earnings/triggers.d.ts +206 -18
  78. package/dist/component/earnings/triggers.d.ts.map +1 -1
  79. package/dist/component/schema.d.ts +97 -1
  80. package/dist/component/schema.js +6 -0
  81. package/dist/component/schema.js.map +1 -1
  82. package/dist/component/usage/schema.d.ts +101 -1
  83. package/dist/component/usage/schema.d.ts.map +1 -1
  84. package/dist/component/usage/schema.js +11 -2
  85. package/dist/component/usage/schema.js.map +1 -1
  86. package/dist/component/usageDelivery/bridge.d.ts +25 -0
  87. package/dist/component/usageDelivery/bridge.d.ts.map +1 -0
  88. package/dist/component/usageDelivery/bridge.js +45 -0
  89. package/dist/component/usageDelivery/bridge.js.map +1 -0
  90. package/dist/component/usageDelivery/fields.d.ts +79 -0
  91. package/dist/component/usageDelivery/fields.d.ts.map +1 -0
  92. package/dist/component/usageDelivery/fields.js +39 -0
  93. package/dist/component/usageDelivery/fields.js.map +1 -0
  94. package/dist/component/usageDelivery/helpers.d.ts +84 -0
  95. package/dist/component/usageDelivery/helpers.d.ts.map +1 -0
  96. package/dist/component/usageDelivery/helpers.js +63 -0
  97. package/dist/component/usageDelivery/helpers.js.map +1 -0
  98. package/dist/component/usageDelivery/mutations.d.ts +97 -0
  99. package/dist/component/usageDelivery/mutations.d.ts.map +1 -0
  100. package/dist/component/usageDelivery/mutations.js +160 -0
  101. package/dist/component/usageDelivery/mutations.js.map +1 -0
  102. package/dist/component/usageDelivery/queries.d.ts +115 -0
  103. package/dist/component/usageDelivery/queries.d.ts.map +1 -0
  104. package/dist/component/usageDelivery/queries.js +22 -0
  105. package/dist/component/usageDelivery/queries.js.map +1 -0
  106. package/dist/component/usageDelivery/schema.d.ts +79 -0
  107. package/dist/component/usageDelivery/schema.d.ts.map +1 -0
  108. package/dist/component/usageDelivery/schema.js +30 -0
  109. package/dist/component/usageDelivery/schema.js.map +1 -0
  110. package/dist/component/usageDelivery/steps.d.ts +85 -0
  111. package/dist/component/usageDelivery/steps.d.ts.map +1 -0
  112. package/dist/component/usageDelivery/steps.js +161 -0
  113. package/dist/component/usageDelivery/steps.js.map +1 -0
  114. package/dist/component/usageDelivery/workflow.d.ts +15 -0
  115. package/dist/component/usageDelivery/workflow.d.ts.map +1 -0
  116. package/dist/component/usageDelivery/workflow.js +28 -0
  117. package/dist/component/usageDelivery/workflow.js.map +1 -0
  118. package/dist/component/usageObservations/helpers.d.ts +38 -0
  119. package/dist/component/usageObservations/helpers.d.ts.map +1 -0
  120. package/dist/component/usageObservations/helpers.js +80 -0
  121. package/dist/component/usageObservations/helpers.js.map +1 -0
  122. package/dist/component/usageObservations/history.d.ts +6 -0
  123. package/dist/component/usageObservations/history.d.ts.map +1 -0
  124. package/dist/component/usageObservations/history.js +29 -0
  125. package/dist/component/usageObservations/history.js.map +1 -0
  126. package/dist/component/usageObservations/mutations.d.ts +6 -0
  127. package/dist/component/usageObservations/mutations.d.ts.map +1 -0
  128. package/dist/component/usageObservations/mutations.js +39 -0
  129. package/dist/component/usageObservations/mutations.js.map +1 -0
  130. package/dist/component/usageObservations/queries.d.ts +78 -0
  131. package/dist/component/usageObservations/queries.d.ts.map +1 -0
  132. package/dist/component/usageObservations/queries.js +131 -0
  133. package/dist/component/usageObservations/queries.js.map +1 -0
  134. package/dist/component/usageObservations/schema.d.ts +72 -0
  135. package/dist/component/usageObservations/schema.d.ts.map +1 -0
  136. package/dist/component/usageObservations/schema.js +29 -0
  137. package/dist/component/usageObservations/schema.js.map +1 -0
  138. package/docs/README.md +5 -1
  139. package/docs/metering-setup.md +3 -1
  140. package/docs/usage-delivery.md +143 -0
  141. package/docs/usage-observations.md +152 -0
  142. package/package.json +4 -2
  143. package/src/client/index.ts +34 -0
  144. package/src/client/usage/client.ts +5 -2
  145. package/src/client/usage/deliveryClient.ts +130 -0
  146. package/src/client/usage/deliveryProtocol.ts +26 -0
  147. package/src/client/usage/deliveryProvider.test.ts +207 -0
  148. package/src/client/usage/deliveryProvider.ts +155 -0
  149. package/src/client/usage/index.ts +31 -0
  150. package/src/client/usage/invoiceObservation.test.ts +195 -0
  151. package/src/client/usage/invoiceObservation.ts +203 -0
  152. package/src/client/usage/observationClient.ts +233 -0
  153. package/src/client/usage/observationTypes.ts +101 -0
  154. package/src/client/usage/providerObservation.test.ts +207 -0
  155. package/src/client/usage/providerObservation.ts +124 -0
  156. package/src/client/usage/reconciliation.test.ts +117 -0
  157. package/src/client/usage/reconciliation.ts +86 -0
  158. package/src/client/usage/summary.test.ts +222 -0
  159. package/src/client/usage/summary.ts +188 -0
  160. package/src/client/webhooks/handler.ts +2 -1
  161. package/src/client/webhooks/meterErrors.test.ts +164 -0
  162. package/src/client/webhooks/meterErrors.ts +118 -0
  163. package/src/client/webhooks/v2.ts +5 -0
  164. package/src/component/_generated/api.ts +22 -0
  165. package/src/component/_generated/component.ts +437 -0
  166. package/src/component/schema.ts +12 -0
  167. package/src/component/usage/schema.ts +11 -2
  168. package/src/component/usageDelivery/bridge.ts +56 -0
  169. package/src/component/usageDelivery/concurrency.test.ts +62 -0
  170. package/src/component/usageDelivery/fields.ts +60 -0
  171. package/src/component/usageDelivery/helpers.ts +77 -0
  172. package/src/component/usageDelivery/mutations.ts +210 -0
  173. package/src/component/usageDelivery/queries.ts +25 -0
  174. package/src/component/usageDelivery/schema.ts +33 -0
  175. package/src/component/usageDelivery/steps.ts +209 -0
  176. package/src/component/usageDelivery/workflow.test.ts +402 -0
  177. package/src/component/usageDelivery/workflow.ts +36 -0
  178. package/src/component/usageObservations/helpers.ts +95 -0
  179. package/src/component/usageObservations/history.test.ts +87 -0
  180. package/src/component/usageObservations/history.ts +39 -0
  181. package/src/component/usageObservations/mutations.ts +39 -0
  182. package/src/component/usageObservations/queries.test.ts +162 -0
  183. package/src/component/usageObservations/queries.ts +145 -0
  184. package/src/component/usageObservations/schema.ts +40 -0
@@ -6882,6 +6882,271 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
6882
6882
  } | null, Name>;
6883
6883
  };
6884
6884
  };
6885
+ usageDelivery: {
6886
+ mutations: {
6887
+ hold: FunctionReference<"mutation", "internal", {
6888
+ eventId: string;
6889
+ scope: {
6890
+ customerAccount: string;
6891
+ livemode: boolean;
6892
+ meterId: string;
6893
+ stripeAccountId: string;
6894
+ };
6895
+ }, {
6896
+ attempts: number;
6897
+ eventId: string;
6898
+ held: boolean;
6899
+ providerIdentifier: string;
6900
+ reason?: "rate_limited" | "provider_unavailable" | "provider_outcome_unknown" | "provider_rejected" | "retry_exhausted" | "delivery_window_expired" | "scope_busy" | "administrative_hold";
6901
+ receipt?: {
6902
+ created: number;
6903
+ identifier: string;
6904
+ };
6905
+ state: "queued" | "sending" | "provider_accepted" | "rejected" | "unknown" | "held";
6906
+ validationErrors: Array<{
6907
+ code: "meter_event_customer_not_found" | "meter_event_no_customer_defined" | "meter_event_dimension_count_too_high" | "archived_meter" | "timestamp_too_far_in_past" | "timestamp_in_future" | "meter_event_value_not_found" | "meter_event_invalid_value" | "no_meter";
6908
+ observedAt: number;
6909
+ providerEventId: string;
6910
+ }>;
6911
+ validationHistoryComplete: boolean;
6912
+ }, Name>;
6913
+ recordErrorReport: FunctionReference<"mutation", "internal", {
6914
+ livemode: boolean;
6915
+ meterId?: string;
6916
+ providerEventId: string;
6917
+ samples: Array<{
6918
+ code: "meter_event_customer_not_found" | "meter_event_no_customer_defined" | "meter_event_dimension_count_too_high" | "archived_meter" | "timestamp_too_far_in_past" | "timestamp_in_future" | "meter_event_value_not_found" | "meter_event_invalid_value" | "no_meter";
6919
+ identifier: string;
6920
+ }>;
6921
+ stripeAccountId: string;
6922
+ truncated: boolean;
6923
+ }, {
6924
+ matched: number;
6925
+ truncated: boolean;
6926
+ unattributed: number;
6927
+ }, Name>;
6928
+ resume: FunctionReference<"mutation", "internal", {
6929
+ eventId: string;
6930
+ scope: {
6931
+ customerAccount: string;
6932
+ livemode: boolean;
6933
+ meterId: string;
6934
+ stripeAccountId: string;
6935
+ };
6936
+ }, {
6937
+ attempts: number;
6938
+ eventId: string;
6939
+ held: boolean;
6940
+ providerIdentifier: string;
6941
+ reason?: "rate_limited" | "provider_unavailable" | "provider_outcome_unknown" | "provider_rejected" | "retry_exhausted" | "delivery_window_expired" | "scope_busy" | "administrative_hold";
6942
+ receipt?: {
6943
+ created: number;
6944
+ identifier: string;
6945
+ };
6946
+ state: "queued" | "sending" | "provider_accepted" | "rejected" | "unknown" | "held";
6947
+ validationErrors: Array<{
6948
+ code: "meter_event_customer_not_found" | "meter_event_no_customer_defined" | "meter_event_dimension_count_too_high" | "archived_meter" | "timestamp_too_far_in_past" | "timestamp_in_future" | "meter_event_value_not_found" | "meter_event_invalid_value" | "no_meter";
6949
+ observedAt: number;
6950
+ providerEventId: string;
6951
+ }>;
6952
+ validationHistoryComplete: boolean;
6953
+ }, Name>;
6954
+ start: FunctionReference<"mutation", "internal", {
6955
+ definitionVersion: 1;
6956
+ eventId: string;
6957
+ provider: string;
6958
+ scope: {
6959
+ customerAccount: string;
6960
+ livemode: boolean;
6961
+ meterId: string;
6962
+ stripeAccountId: string;
6963
+ };
6964
+ }, {
6965
+ attempts: number;
6966
+ eventId: string;
6967
+ held: boolean;
6968
+ providerIdentifier: string;
6969
+ reason?: "rate_limited" | "provider_unavailable" | "provider_outcome_unknown" | "provider_rejected" | "retry_exhausted" | "delivery_window_expired" | "scope_busy" | "administrative_hold";
6970
+ receipt?: {
6971
+ created: number;
6972
+ identifier: string;
6973
+ };
6974
+ state: "queued" | "sending" | "provider_accepted" | "rejected" | "unknown" | "held";
6975
+ validationErrors: Array<{
6976
+ code: "meter_event_customer_not_found" | "meter_event_no_customer_defined" | "meter_event_dimension_count_too_high" | "archived_meter" | "timestamp_too_far_in_past" | "timestamp_in_future" | "meter_event_value_not_found" | "meter_event_invalid_value" | "no_meter";
6977
+ observedAt: number;
6978
+ providerEventId: string;
6979
+ }>;
6980
+ validationHistoryComplete: boolean;
6981
+ }, Name>;
6982
+ };
6983
+ queries: {
6984
+ get: FunctionReference<"query", "internal", {
6985
+ eventId: string;
6986
+ scope: {
6987
+ customerAccount: string;
6988
+ livemode: boolean;
6989
+ meterId: string;
6990
+ stripeAccountId: string;
6991
+ };
6992
+ }, {
6993
+ attempts: number;
6994
+ eventId: string;
6995
+ held: boolean;
6996
+ providerIdentifier: string;
6997
+ reason?: "rate_limited" | "provider_unavailable" | "provider_outcome_unknown" | "provider_rejected" | "retry_exhausted" | "delivery_window_expired" | "scope_busy" | "administrative_hold";
6998
+ receipt?: {
6999
+ created: number;
7000
+ identifier: string;
7001
+ };
7002
+ state: "queued" | "sending" | "provider_accepted" | "rejected" | "unknown" | "held";
7003
+ validationErrors: Array<{
7004
+ code: "meter_event_customer_not_found" | "meter_event_no_customer_defined" | "meter_event_dimension_count_too_high" | "archived_meter" | "timestamp_too_far_in_past" | "timestamp_in_future" | "meter_event_value_not_found" | "meter_event_invalid_value" | "no_meter";
7005
+ observedAt: number;
7006
+ providerEventId: string;
7007
+ }>;
7008
+ validationHistoryComplete: boolean;
7009
+ }, Name>;
7010
+ snapshot: FunctionReference<"query", "internal", {
7011
+ eventId: string;
7012
+ scope: {
7013
+ customerAccount: string;
7014
+ livemode: boolean;
7015
+ meterId: string;
7016
+ stripeAccountId: string;
7017
+ };
7018
+ }, {
7019
+ event: {
7020
+ _creationTime: number;
7021
+ _id: string;
7022
+ acceptedAt: number;
7023
+ identity: string;
7024
+ occurredAt: number;
7025
+ recordJson: string;
7026
+ reservationId?: string;
7027
+ scopeKey: string;
7028
+ subscriptionJson: string;
7029
+ };
7030
+ outbox: {
7031
+ _creationTime: number;
7032
+ _id: string;
7033
+ attempts: number;
7034
+ definitionVersion?: 1;
7035
+ dispatch?: string;
7036
+ eventId: string;
7037
+ firstSendAt?: number;
7038
+ held?: boolean;
7039
+ historySequence?: number;
7040
+ leaseUntil?: number;
7041
+ nextAttemptAt: number;
7042
+ provider?: string;
7043
+ providerIdentifier: string;
7044
+ reason?: "rate_limited" | "provider_unavailable" | "provider_outcome_unknown" | "provider_rejected" | "retry_exhausted" | "delivery_window_expired" | "scope_busy" | "administrative_hold";
7045
+ receipt?: {
7046
+ created: number;
7047
+ identifier: string;
7048
+ };
7049
+ scopeKey: string;
7050
+ state: "queued" | "sending" | "provider_accepted" | "rejected" | "unknown" | "held";
7051
+ workflowId?: string;
7052
+ };
7053
+ }, Name>;
7054
+ };
7055
+ };
7056
+ usageObservations: {
7057
+ mutations: {
7058
+ save: FunctionReference<"mutation", "internal", {
7059
+ observationJson: string;
7060
+ sourceJson: string;
7061
+ startedAt: number;
7062
+ }, null, Name>;
7063
+ };
7064
+ queries: {
7065
+ cached: FunctionReference<"query", "internal", {
7066
+ sourceJson: string;
7067
+ }, string | null, Name>;
7068
+ deliveryHistory: FunctionReference<"query", "internal", {
7069
+ eventId: string;
7070
+ paginationOpts: {
7071
+ cursor: string | null;
7072
+ endCursor?: string | null;
7073
+ id?: number;
7074
+ maximumBytesRead?: number;
7075
+ maximumRowsRead?: number;
7076
+ numItems: number;
7077
+ };
7078
+ scope: {
7079
+ customerAccount: string;
7080
+ livemode: boolean;
7081
+ meterId: string;
7082
+ stripeAccountId: string;
7083
+ };
7084
+ }, {
7085
+ continueCursor: string;
7086
+ isDone: boolean;
7087
+ legacyHistoryMissing: boolean;
7088
+ page: Array<{
7089
+ _creationTime: number;
7090
+ _id: string;
7091
+ attempt: number;
7092
+ created?: number;
7093
+ eventId: string;
7094
+ identity: string;
7095
+ phase: "started" | "accepted" | "rate_limited" | "unavailable" | "unknown" | "rejected" | "held" | "resumed" | "window_expired" | "retry_exhausted";
7096
+ recordedAt: number;
7097
+ scopeKey: string;
7098
+ sequence: number;
7099
+ }>;
7100
+ pageStatus?: "SplitRecommended" | "SplitRequired" | null;
7101
+ splitCursor?: string | null;
7102
+ }, Name>;
7103
+ summary: FunctionReference<"query", "internal", {
7104
+ maxRecords: number;
7105
+ period: {
7106
+ end: number;
7107
+ start: number;
7108
+ };
7109
+ scope: {
7110
+ customerAccount: string;
7111
+ livemode: boolean;
7112
+ meterId: string;
7113
+ stripeAccountId: string;
7114
+ };
7115
+ }, string, Name>;
7116
+ validationHistory: FunctionReference<"query", "internal", {
7117
+ eventId: string;
7118
+ paginationOpts: {
7119
+ cursor: string | null;
7120
+ endCursor?: string | null;
7121
+ id?: number;
7122
+ maximumBytesRead?: number;
7123
+ maximumRowsRead?: number;
7124
+ numItems: number;
7125
+ };
7126
+ scope: {
7127
+ customerAccount: string;
7128
+ livemode: boolean;
7129
+ meterId: string;
7130
+ stripeAccountId: string;
7131
+ };
7132
+ }, {
7133
+ continueCursor: string;
7134
+ isDone: boolean;
7135
+ page: Array<{
7136
+ _creationTime: number;
7137
+ _id: string;
7138
+ code: "meter_event_customer_not_found" | "meter_event_no_customer_defined" | "meter_event_dimension_count_too_high" | "archived_meter" | "timestamp_too_far_in_past" | "timestamp_in_future" | "meter_event_value_not_found" | "meter_event_invalid_value" | "no_meter";
7139
+ dedupe: string;
7140
+ eventId: string;
7141
+ observedAt: number;
7142
+ providerEventId: string;
7143
+ scopeKey: string;
7144
+ }>;
7145
+ pageStatus?: "SplitRecommended" | "SplitRequired" | null;
7146
+ splitCursor?: string | null;
7147
+ }, Name>;
7148
+ };
7149
+ };
6885
7150
  webhooks: {
6886
7151
  mutations: {
6887
7152
  insertWebhookEvent: FunctionReference<"mutation", "internal", {