@facto-to/card 0.0.0-stage → 0.0.1-beta.2

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 (69) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/LICENSE +202 -0
  3. package/NOTICE +5 -0
  4. package/README.md +63 -2
  5. package/dist/card-inbox-DzsHFRPT.d.cts +312 -0
  6. package/dist/card-inbox-DzsHFRPT.d.ts +312 -0
  7. package/dist/chunk-KBS2PWM4.js +2 -0
  8. package/dist/cli/index.js +6 -0
  9. package/dist/docs/README.md +9 -0
  10. package/dist/docs/authentication.md +96 -0
  11. package/dist/docs/authorization-binding.md +182 -0
  12. package/dist/docs/authorizations.md +182 -0
  13. package/dist/docs/concepts.md +36 -0
  14. package/dist/docs/deliveries.md +170 -0
  15. package/dist/docs/errors.md +100 -0
  16. package/dist/docs/getting-access.md +56 -0
  17. package/dist/docs/idempotency.md +78 -0
  18. package/dist/docs/integration-checklist.md +15 -0
  19. package/dist/docs/integration.zh.md +59 -0
  20. package/dist/docs/interlace-adapter-v1.md +87 -0
  21. package/dist/docs/interlace-adapter-v1.zh.md +87 -0
  22. package/dist/docs/not-yet-available.md +13 -0
  23. package/dist/docs/quickstart.md +126 -0
  24. package/dist/docs/reconciliation.md +86 -0
  25. package/dist/docs/reference/api.md +2541 -0
  26. package/dist/docs/reference/events.md +639 -0
  27. package/dist/docs/reference/schemas.json +6603 -0
  28. package/dist/docs/reference/schemas.md +1001 -0
  29. package/dist/docs/simulator.md +235 -0
  30. package/dist/docs/versioning.md +9 -0
  31. package/dist/index.cjs +3 -0
  32. package/dist/index.d.cts +987 -0
  33. package/dist/index.d.ts +987 -0
  34. package/dist/index.js +2 -0
  35. package/dist/source/build.mjs +5 -0
  36. package/dist/source/package.json +16 -0
  37. package/dist/source/src/connect/cli/deliveries.ts +48 -0
  38. package/dist/source/src/connect/cli/index.ts +57 -0
  39. package/dist/source/src/connect/server/card-binding-assertion.ts +312 -0
  40. package/dist/source/src/connect/server/card-client.ts +1018 -0
  41. package/dist/source/src/connect/server/card-delivery.ts +301 -0
  42. package/dist/source/src/connect/server/card-events.ts +473 -0
  43. package/dist/source/src/connect/server/card-idempotency.ts +27 -0
  44. package/dist/source/src/connect/server/card-inbox.ts +82 -0
  45. package/dist/source/src/connect/server/card-intent-token.ts +588 -0
  46. package/dist/source/src/connect/server/card-polling.ts +69 -0
  47. package/dist/source/src/connect/server/card-signing.ts +115 -0
  48. package/dist/source/src/connect/server/card-transport.ts +282 -0
  49. package/dist/source/src/connect/server/errors.ts +280 -0
  50. package/dist/source/src/connect/server/fixtures/engine/card-events.synthetic.ts +84 -0
  51. package/dist/source/src/connect/server/retry-after.ts +12 -0
  52. package/dist/source/src/connect/testing/card-inbox.ts +124 -0
  53. package/dist/source/src/connect/testing/card-scenarios.ts +243 -0
  54. package/dist/source/src/connect/testing/card-simulator-vectors.ts +262 -0
  55. package/dist/source/src/connect/testing/card-simulator.ts +531 -0
  56. package/dist/source/src/connect/testing/interlace-card-transactions.ts +704 -0
  57. package/dist/source/src/connect/testing/pure-sha256.ts +123 -0
  58. package/dist/source/src/connect/wire.d.ts +544 -0
  59. package/dist/source/src/index.ts +163 -0
  60. package/dist/source/src/testing-browser.ts +24 -0
  61. package/dist/source/src/testing.ts +26 -0
  62. package/dist/source/tsconfig.json +20 -0
  63. package/dist/testing-browser.d.ts +220 -0
  64. package/dist/testing-browser.js +5 -0
  65. package/dist/testing.cjs +6 -0
  66. package/dist/testing.d.cts +199 -0
  67. package/dist/testing.d.ts +199 -0
  68. package/dist/testing.js +5 -0
  69. package/package.json +60 -4
@@ -0,0 +1,163 @@
1
+ // Partner entrypoint. Re-exports only: the Card implementation has a single
2
+ // source in the connect package, and this package selects its machine surface.
3
+ // Do not define or copy implementation here.
4
+ export { createCardClient, isCardErrorEnvelope, isCardNestedErrorEnvelope } from './connect/server/card-client'
5
+ export type {
6
+ CardClient,
7
+ CardSessionsApi,
8
+ CardIntentsApi,
9
+ CardBindingsApi,
10
+ CardAuthorizationsApi,
11
+ CardEventsApi,
12
+ CardDeliveriesApi,
13
+ CardDeliveryReplaysApi,
14
+ CardDeadLettersApi,
15
+ CardClientOptions,
16
+ CardRequestOptions,
17
+ CardIdempotentRequestOptions,
18
+ CardOpaqueRequestOptions,
19
+ BindingSessionCreateInput,
20
+ BindingSessionCreateOptions,
21
+ BindingSessionCancelOptions,
22
+ SessionProofAssertionInput,
23
+ BindingProofSubmitInput,
24
+ BindingProofChallenge,
25
+ BindingProofPolicy,
26
+ BindingSessionCreate,
27
+ BindingSessionCreated,
28
+ BindingSessionStatus,
29
+ ProviderProofAccepted,
30
+ ProviderProofSubmitPayload,
31
+ IntentCardsListOptions,
32
+ DeliveryReconciliationInput,
33
+ DeliveryReplayInput,
34
+ AuthorizationLookupClientInput,
35
+ AuthorizationCreateInput,
36
+ AuthorizationFactInput,
37
+ SynchronousAuthorizationCreateInput,
38
+ SynchronousAuthorizationResult,
39
+ CardAuthorizationErrorCode,
40
+ CardErrorEnvelope,
41
+ CardNestedErrorEnvelope,
42
+ CardEnvironment,
43
+ CardDisplayFacts,
44
+ IntentCardItem,
45
+ IntentCardList,
46
+ TargetCardInput,
47
+ IntentCardsReplaceInput,
48
+ IntentCardsReplaced,
49
+ IntentCancelInput,
50
+ IntentCancelled,
51
+ BindingLookupInput,
52
+ BindingFundingSummary,
53
+ BindingSummary,
54
+ BindingLookupResult,
55
+ CardholderVerification,
56
+ AuthorizationSubmitInput,
57
+ AuthorizationAccepted,
58
+ SynchronousAuthorizationApproved,
59
+ SynchronousAuthorizationDeclined,
60
+ AuthorizationDeadlineExceeded,
61
+ AuthorizationFactRecordInput,
62
+ AuthorizationFactReceipt,
63
+ AuthorizationLookupCriteria,
64
+ AuthorizationLookupInput,
65
+ AuthorizationProjection,
66
+ AuthorizationLookupResult,
67
+ CardFinalReceipt,
68
+ CardAuthorizationLifecycle,
69
+ CardPaymentDetails,
70
+ AuthorizationFacts,
71
+ CardInboundEventInput,
72
+ CardInboundEventReceipt,
73
+ DeliveryReconciliationListInput,
74
+ DeliveryItem,
75
+ DeliveryPage,
76
+ DeliveryReplayCreateInput,
77
+ DeliveryReplayAccepted,
78
+ DeadLetterListParams,
79
+ DeadLetterItem,
80
+ DeadLetterPage,
81
+ DeadLetterReplayAccepted,
82
+ } from './connect/server/card-client'
83
+ export { signCardRequest } from './connect/server/card-signing'
84
+ export type { CardApiKeySecret, CardSigningInput } from './connect/server/card-signing'
85
+ export {
86
+ CARD_BINDING_ASSERTION_TYP,
87
+ signBindingAssertion,
88
+ } from './connect/server/card-binding-assertion'
89
+ export type {
90
+ BindingAssertionCardDisplay,
91
+ BindingAssertionCardInput,
92
+ BindingAssertionEd25519Jwk,
93
+ BindingAssertionProofInput,
94
+ BindingAssertionSigner,
95
+ BindingProofAssurance,
96
+ BindingSecondChannelType,
97
+ BindingUserConsentPurpose,
98
+ SignBindingAssertionInput,
99
+ } from './connect/server/card-binding-assertion'
100
+ export {
101
+ CARD_INTENT_JWKS_PATH,
102
+ FactoIntentTokenError,
103
+ verifyCardIntentToken,
104
+ } from './connect/server/card-intent-token'
105
+ export type {
106
+ CardIntentJwk,
107
+ CardIntentJwks,
108
+ CardIntentJwksInput,
109
+ VerifyCardIntentTokenInput,
110
+ VerifiedCardIntentToken,
111
+ FactoIntentTokenErrorCode,
112
+ } from './connect/server/card-intent-token'
113
+ export {
114
+ CARD_REDELIVERY_REASONS,
115
+ createDeliveryVerifier,
116
+ getBusinessPayloadDigest,
117
+ verifyEventDelivery,
118
+ } from './connect/server/card-delivery'
119
+ export type {
120
+ CardRedeliveryReason,
121
+ CreateDeliveryVerifierOptions,
122
+ DeliveryScope,
123
+ DeliverySigningKey,
124
+ DeliveryVerificationFailureReason,
125
+ DeliveryVerifier,
126
+ DeliveryVerifierInput,
127
+ EventDeliveryVerification,
128
+ VerifiedEventDelivery,
129
+ VerifyEventDeliveryInput,
130
+ } from './connect/server/card-delivery'
131
+ export { CARD_EVENT_KINDS, decodeDeliveryEvent } from './connect/server/card-events'
132
+ export type {
133
+ CardEventKind,
134
+ DeliveredCardDisplay,
135
+ CardBindingEvent,
136
+ ChargeFact,
137
+ DeliveredChargeFinalReceipt,
138
+ ChargeFinalizedEvent,
139
+ ChargeFactsUpdatedEvent,
140
+ AuthorizationUpdatedEvent,
141
+ AuthorizationUpdateData,
142
+ AuthorizationChange,
143
+ CipLifecycleSummary,
144
+ RefundSummary,
145
+ CardKnownEvent,
146
+ DecodedDeliveryEvent,
147
+ } from './connect/server/card-events'
148
+ export { receiveEventDelivery } from './connect/server/card-inbox'
149
+ export type {
150
+ DeliveryInboxTransaction,
151
+ DeliveryInboxStore,
152
+ DeliveryInboxOptions,
153
+ DeliveryInboxResult,
154
+ DeliveryInboxMetadata,
155
+ DeliveryEventRevision,
156
+ ObservedSequenceGap,
157
+ } from './connect/server/card-inbox'
158
+ export { pollAuthorization } from './connect/server/card-polling'
159
+ export type { AuthorizationPollingOptions, AuthorizationPollingResult } from './connect/server/card-polling'
160
+ export { deriveAuthorizationIdempotencyKey } from './connect/server/card-idempotency'
161
+ export type { AuthorizationIdentity } from './connect/server/card-idempotency'
162
+ export { CardError, CardError as FactoConnectServerError, withCardServerRetry as withServerRetry } from './connect/server/errors'
163
+ export type { CardErrorOutcome, FactoConnectServerErrorCode, CardServerRetryOptions as ServerRetryOptions } from './connect/server/errors'
@@ -0,0 +1,24 @@
1
+ // Browser-safe testing entrypoint with zero Node built-in imports. Re-exports only
2
+ // the pure offline Card testing fixtures and sandbox runtime from their single source.
3
+ export { MemoryDeliveryInboxStore, deliveryInboxVectors } from './connect/testing/card-inbox'
4
+ export { requiredEventCatalogFixture, authorizationEventCatalogFixture } from './connect/testing/card-scenarios'
5
+ export { simulatorDeliveryScenario, simulatorDeliveryKinds } from './connect/testing/card-scenarios'
6
+ export {
7
+ interlaceCardTransactionFixtures,
8
+ mapInterlaceCardTransactionToAuthorization,
9
+ replayInterlaceCardTransaction,
10
+ createCardSandboxRuntime,
11
+ } from './connect/testing/interlace-card-transactions'
12
+ export type {
13
+ InterlaceClearingEvidence,
14
+ InterlaceCardTransactionEvent,
15
+ InterlaceCardTransactionFixtureName,
16
+ InterlaceMappedAuthorizationRequest,
17
+ InterlaceMappedFactRequest,
18
+ InterlaceMappedCardRequest,
19
+ InterlaceReplayOptions,
20
+ InterlaceReplayResult,
21
+ CardSandboxRuntimeOptions,
22
+ CardSandboxRecordedEvent,
23
+ CardSandboxRuntime,
24
+ } from './connect/testing/interlace-card-transactions'
@@ -0,0 +1,26 @@
1
+ // Partner testing entrypoint. Re-exports only the Card local test helpers from
2
+ // their single source; synthetic values are for local tests only.
3
+ export { MemoryDeliveryInboxStore, deliveryInboxVectors } from './connect/testing/card-inbox'
4
+ export { requiredEventCatalogFixture, authorizationEventCatalogFixture } from './connect/testing/card-scenarios'
5
+ export { startCardSimulator } from './connect/testing/card-simulator'
6
+ export { simulatorDeliveryScenario, simulatorDeliveryKinds } from './connect/testing/card-scenarios'
7
+ export { runCardSimulatorVectors } from './connect/testing/card-simulator-vectors'
8
+ export {
9
+ interlaceCardTransactionFixtures,
10
+ mapInterlaceCardTransactionToAuthorization,
11
+ replayInterlaceCardTransaction,
12
+ createCardSandboxRuntime,
13
+ } from './connect/testing/interlace-card-transactions'
14
+ export type {
15
+ InterlaceClearingEvidence,
16
+ InterlaceCardTransactionEvent,
17
+ InterlaceCardTransactionFixtureName,
18
+ InterlaceMappedAuthorizationRequest,
19
+ InterlaceMappedFactRequest,
20
+ InterlaceMappedCardRequest,
21
+ InterlaceReplayOptions,
22
+ InterlaceReplayResult,
23
+ CardSandboxRuntimeOptions,
24
+ CardSandboxRecordedEvent,
25
+ CardSandboxRuntime,
26
+ } from './connect/testing/interlace-card-transactions'
@@ -0,0 +1,20 @@
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2022",
4
+ "lib": [
5
+ "ES2022",
6
+ "DOM",
7
+ "DOM.Iterable"
8
+ ],
9
+ "module": "ESNext",
10
+ "moduleResolution": "bundler",
11
+ "strict": true,
12
+ "types": [
13
+ "node"
14
+ ],
15
+ "skipLibCheck": true
16
+ },
17
+ "include": [
18
+ "src"
19
+ ]
20
+ }
@@ -0,0 +1,220 @@
1
+ interface DeliveryScope {
2
+ readonly connectionId: string;
3
+ readonly environment: 'dev' | 'production';
4
+ readonly programId: string;
5
+ readonly targetRevision: string;
6
+ }
7
+ interface DeliverySigningKey extends DeliveryScope {
8
+ readonly keyId: string;
9
+ readonly secret: Uint8Array;
10
+ readonly signerKeyVersion: number;
11
+ readonly notBefore: string;
12
+ readonly expiresAt: string;
13
+ readonly status: 'active' | 'overlap' | 'revoked' | 'expired';
14
+ readonly eventKinds: readonly string[];
15
+ }
16
+ interface VerifyEventDeliveryInput {
17
+ readonly rawBody: Uint8Array;
18
+ readonly headers: readonly (readonly [string, string])[];
19
+ readonly registry: readonly DeliverySigningKey[];
20
+ readonly expectedScope: DeliveryScope;
21
+ readonly nowSeconds?: number;
22
+ readonly toleranceSeconds?: number;
23
+ }
24
+
25
+ interface DeliveryInboxTransaction<Context = unknown> {
26
+ readonly context: Context;
27
+ readonly fence: number;
28
+ getDigest(eventId: string): Promise<string | undefined>;
29
+ getObservedMaxSequence(): Promise<number | null>;
30
+ markProcessed(eventId: string, digest: string, sequence: number | null): Promise<void>;
31
+ }
32
+ interface DeliveryInboxStore<Context = unknown> {
33
+ withConnection<T>(scope: Readonly<DeliveryScope>, operation: (transaction: DeliveryInboxTransaction<Context>) => Promise<T>): Promise<T>;
34
+ }
35
+
36
+ declare class MemoryDeliveryInboxStore implements DeliveryInboxStore {
37
+ private readonly states;
38
+ private readonly capacity;
39
+ private readonly leaseMs;
40
+ private readonly now;
41
+ constructor(options?: {
42
+ capacity?: number;
43
+ leaseMs?: number;
44
+ nowMs?: () => number;
45
+ });
46
+ withConnection<T>(scope: Readonly<DeliveryScope>, operation: (transaction: DeliveryInboxTransaction) => Promise<T>): Promise<T>;
47
+ }
48
+ declare const deliveryInboxVectors: {
49
+ readonly duplicate: {
50
+ readonly deliveries: readonly [VerifyEventDeliveryInput, VerifyEventDeliveryInput];
51
+ };
52
+ readonly outOfOrder: {
53
+ readonly deliveries: readonly [VerifyEventDeliveryInput, VerifyEventDeliveryInput, VerifyEventDeliveryInput];
54
+ };
55
+ readonly gap: {
56
+ readonly deliveries: readonly [VerifyEventDeliveryInput, VerifyEventDeliveryInput];
57
+ };
58
+ readonly nullableCard: {
59
+ readonly deliveries: readonly [VerifyEventDeliveryInput];
60
+ };
61
+ readonly unsequenced: {
62
+ readonly deliveries: readonly [VerifyEventDeliveryInput, VerifyEventDeliveryInput];
63
+ };
64
+ };
65
+
66
+ declare const requiredEventCatalogFixture: Readonly<{
67
+ revision: "2026-11-18-card-events.1";
68
+ digest: "sha256:9fcad68499ef3f770533ad3f3a4c4950d16c0385c56b2b0af6bba5375038aa98";
69
+ approvedFeatureSnapshot: readonly ["binding", "new_consumption", "supplier_fact_updates"];
70
+ featureClosures: Readonly<{
71
+ binding: readonly ["card.binding.linked", "card.binding.relinked", "card.binding.revoked", "card.binding.route_changed", "card.binding.limits_changed", "card.binding.ownership_transferred"];
72
+ new_consumption: readonly ["card.charge.finalized"];
73
+ supplier_fact_updates: readonly ["card.charge.facts_updated"];
74
+ }>;
75
+ }>;
76
+ declare const authorizationEventCatalogFixture: Readonly<{
77
+ revision: "2026-11-18-card-events.1";
78
+ digest: "sha256:9fcad68499ef3f770533ad3f3a4c4950d16c0385c56b2b0af6bba5375038aa98";
79
+ approvedFeatureSnapshot: readonly ["binding", "new_consumption", "supplier_fact_updates", "authorization_updates"];
80
+ featureClosures: Readonly<{
81
+ authorization_updates: readonly ["card.authorization.updated"];
82
+ binding: readonly ["card.binding.linked", "card.binding.relinked", "card.binding.revoked", "card.binding.route_changed", "card.binding.limits_changed", "card.binding.ownership_transferred"];
83
+ new_consumption: readonly ["card.charge.finalized"];
84
+ supplier_fact_updates: readonly ["card.charge.facts_updated"];
85
+ }>;
86
+ }>;
87
+ declare const simulatorDeliveryKinds: readonly ["duplicate", "outOfOrder", "gap", "nullableCard", "unsequenced", "authorizationOutOfOrder", "authorizationRedelivery", "refundAwaitingChargeFinal", "refundAwaitingFunds", "refundPayable", "refundPaid", "refundFailed", "refundNotPayable", "chargeFailed"];
88
+ type SimulatorDeliveryKind = (typeof simulatorDeliveryKinds)[number];
89
+ declare function simulatorDeliveryScenario(name: SimulatorDeliveryKind, nowSeconds?: number, attempt?: number): {
90
+ config: {
91
+ name: "duplicate" | "outOfOrder" | "gap" | "nullableCard" | "unsequenced" | "authorizationOutOfOrder" | "authorizationRedelivery" | "refundAwaitingChargeFinal" | "refundAwaitingFunds" | "refundPayable" | "refundPaid" | "refundFailed" | "refundNotPayable" | "chargeFailed";
92
+ selectionId: string;
93
+ connectionId: string;
94
+ programId: string;
95
+ environment: "dev";
96
+ targetRevision: string;
97
+ keyId: string;
98
+ secretUtf8: string;
99
+ signerKeyVersion: number;
100
+ notBefore: string;
101
+ expiresAt: string;
102
+ status: "active";
103
+ eventKinds: string[];
104
+ };
105
+ deliveries: VerifyEventDeliveryInput[];
106
+ };
107
+
108
+ interface InterlaceClearingEvidence {
109
+ readonly profile: 'facto-interlace-v1';
110
+ readonly state: 'CLEARED';
111
+ readonly amount: string;
112
+ readonly currency: 'USD' | 'USDC';
113
+ readonly occurredAt: string;
114
+ readonly revision: number;
115
+ readonly refundableAmount: string;
116
+ }
117
+ interface InterlaceCardTransactionEvent {
118
+ readonly event: 'CARD_TRANSACTION';
119
+ readonly id: string;
120
+ readonly cardId: string;
121
+ readonly accountId: string;
122
+ readonly clientTransactionId: string;
123
+ readonly relatedCardTransactionId?: string;
124
+ readonly type: 0 | 1 | 14;
125
+ readonly status: 'PENDING' | 'CLOSED' | 'CLEARED' | 'FAILED';
126
+ readonly amount: string;
127
+ readonly currency: 'USD' | 'USDC';
128
+ readonly merchantName: string;
129
+ readonly merchantMcc: string;
130
+ readonly merchantCountry: string;
131
+ readonly transactionAt: string;
132
+ readonly clearingEvidence?: InterlaceClearingEvidence;
133
+ }
134
+ type InterlaceCardTransactionFixtureName = 'authorizationApproved' | 'authorizationDeclinedLimit' | 'clearingEqualAmount' | 'partialReversalUncleared' | 'merchantRefundCleared';
135
+ declare const interlaceCardTransactionFixtures: Readonly<Record<InterlaceCardTransactionFixtureName, InterlaceCardTransactionEvent>>;
136
+ interface InterlaceMappedAuthorizationRequest {
137
+ readonly endpoint: 'POST /api/card/authorizations';
138
+ readonly idempotencyKey: string;
139
+ readonly payload: Readonly<{
140
+ program_id: string;
141
+ external_card_id: string;
142
+ external_authorization_id: string;
143
+ supplier_transaction_id: string;
144
+ client_transaction_id: string;
145
+ amount: string;
146
+ currency: 'USD' | 'USDC';
147
+ merchant_name: string;
148
+ merchant_mcc: string;
149
+ merchant_country: string;
150
+ resource_version: string;
151
+ mapping_revision: string;
152
+ cardholder_verification: Readonly<{
153
+ method: 'provider_attested';
154
+ verified_at: string;
155
+ evidence_id: string;
156
+ }>;
157
+ }>;
158
+ }
159
+ interface InterlaceMappedFactRequest {
160
+ readonly endpoint: 'POST /api/card/authorizations/{external_id}/facts';
161
+ readonly externalAuthorizationId: string;
162
+ readonly idempotencyKey: string;
163
+ readonly payload: Readonly<{
164
+ program_id: string;
165
+ fact_type: 'clearing' | 'reversal' | 'refund';
166
+ supplier_transaction_id: string;
167
+ parent_supplier_transaction_id: string;
168
+ client_transaction_id: string;
169
+ amount: string;
170
+ currency: 'USD' | 'USDC';
171
+ resource_version: string;
172
+ predecessor_version: string;
173
+ mapping_revision: string;
174
+ recorded_at: string;
175
+ }>;
176
+ }
177
+ type InterlaceMappedCardRequest = InterlaceMappedAuthorizationRequest | InterlaceMappedFactRequest;
178
+ interface InterlaceReplayOptions {
179
+ readonly programId?: string;
180
+ readonly connectionId?: string;
181
+ readonly mappingRevision?: string;
182
+ readonly predecessorVersion?: string;
183
+ readonly targetRevision?: string;
184
+ readonly nowSeconds?: number;
185
+ readonly isSandboxReplay?: boolean;
186
+ }
187
+ interface InterlaceReplayResult {
188
+ readonly fixtureName?: InterlaceCardTransactionFixtureName;
189
+ readonly sourceEvent: InterlaceCardTransactionEvent;
190
+ readonly mappedRequest: InterlaceMappedCardRequest;
191
+ readonly simulatedHttpStatus: 200 | 402 | 409;
192
+ readonly simulatedResponse: Readonly<Record<string, unknown>>;
193
+ readonly outboundDelivery?: VerifyEventDeliveryInput;
194
+ }
195
+ interface CardSandboxRuntimeOptions {
196
+ readonly programId?: string;
197
+ readonly connectionId?: string;
198
+ readonly mappingRevision?: string;
199
+ readonly targetRevision?: string;
200
+ readonly deliverySecretUtf8?: string;
201
+ readonly nowSeconds?: () => number;
202
+ }
203
+ interface CardSandboxRecordedEvent {
204
+ readonly sequence: number;
205
+ readonly idempotencyKey: string;
206
+ readonly endpoint: InterlaceMappedCardRequest['endpoint'];
207
+ readonly httpStatus: 200 | 402 | 409;
208
+ readonly response: Readonly<Record<string, unknown>>;
209
+ readonly outboundDelivery?: VerifyEventDeliveryInput;
210
+ }
211
+ interface CardSandboxRuntime {
212
+ replayInterlaceTransaction(eventOrFixture: InterlaceCardTransactionFixtureName | InterlaceCardTransactionEvent, options?: InterlaceReplayOptions): InterlaceReplayResult;
213
+ listRecordedEvents(): readonly CardSandboxRecordedEvent[];
214
+ reset(): void;
215
+ }
216
+ declare function mapInterlaceCardTransactionToAuthorization(event: InterlaceCardTransactionEvent, options?: InterlaceReplayOptions): InterlaceMappedCardRequest;
217
+ declare function createCardSandboxRuntime(runtimeOptions?: CardSandboxRuntimeOptions): CardSandboxRuntime;
218
+ declare function replayInterlaceCardTransaction(eventOrFixture: InterlaceCardTransactionFixtureName | InterlaceCardTransactionEvent, options?: InterlaceReplayOptions): InterlaceReplayResult;
219
+
220
+ export { type CardSandboxRecordedEvent, type CardSandboxRuntime, type CardSandboxRuntimeOptions, type InterlaceCardTransactionEvent, type InterlaceCardTransactionFixtureName, type InterlaceClearingEvidence, type InterlaceMappedAuthorizationRequest, type InterlaceMappedCardRequest, type InterlaceMappedFactRequest, type InterlaceReplayOptions, type InterlaceReplayResult, MemoryDeliveryInboxStore, authorizationEventCatalogFixture, createCardSandboxRuntime, deliveryInboxVectors, interlaceCardTransactionFixtures, mapInterlaceCardTransactionToAuthorization, replayInterlaceCardTransaction, requiredEventCatalogFixture, simulatorDeliveryKinds, simulatorDeliveryScenario };
@@ -0,0 +1,5 @@
1
+ var v={envelope_version:2,event_id:"00000000-0000-4000-8000-000000000001",environment:"dev",program_id:"cprog_SYNTHETIC00000001",origin_connection_id:"pconn_SYNTHETIC00000001",connection_sequence:1,occurred_at:"2026-11-18T00:00:00Z"},f={...v,binding_id:"cb_01JZ9X8K4M2V7R5T3N6P8Q0W2Z",binding_revision:1},J={network:"Visa",type:"virtual",last4:"4242"},q={network:null,type:null,last4:null},K={binding_id:f.binding_id,intent_id:null,external_card_id:"scp_card_0001",subject_link_id:"csl_synthetic",card:J,approved_scopes:["card.metadata.view"],consent_revision:"synthetic"},C={operation_type:"authorization_requested",resource_version:"v1",external_authorization_id:"synthetic-auth",mapping_revision:"synthetic-mapping"},ie=[{kind:"facto_admission",state:"confirmed",recorded_at:v.occurred_at,source_system:"facto",observed_at:v.occurred_at},{kind:"durable_commit",state:"confirmed",recorded_at:v.occurred_at,source_system:"facto",observed_at:v.occurred_at},{kind:"provider_authorization",state:"unobserved",recorded_at:v.occurred_at,source_system:"provider"},{kind:"chain_finality",state:"confirmed",recorded_at:v.occurred_at,source_system:"chain",observed_at:v.occurred_at},{kind:"provider_settlement",state:"unobserved",recorded_at:v.occurred_at,source_system:"provider"}],Se=ie.map(e=>e.kind==="provider_authorization"?{...e,state:"confirmed",observed_at:v.occurred_at}:e),B={receipt_event_id:v.event_id,charge_id:"0x"+"0".repeat(62)+"01",external_authorization_id:C.external_authorization_id,mapping_revision:C.mapping_revision,operation_type:C.operation_type,resource_version:C.resource_version,execution_outcome:"succeeded",terminal_action:"releaseFor",finalized_at:v.occurred_at,facts_at_finality:ie},$=[{...f,event_kind:"card.binding.linked",data:K},{...f,event_kind:"card.binding.linked",connection_sequence:null,data:{...K,intent_id:"cint_01JZ9X8K4M2V7R5T3N6P8Q0W2Y",card:q}},{...f,event_kind:"card.binding.relinked",data:K},{...f,event_kind:"card.binding.relinked",connection_sequence:null,data:{...K,intent_id:"cint_01JZ9X8K4M2V7R5T3N6P8Q0W2Y",card:q}},{...f,event_kind:"card.binding.revoked",data:{binding_id:f.binding_id,binding_revision:1,external_card_id:"scp_card_0001",card:J,revocation_source:"user_portfolio",reason_code:"user_requested",payable_projections_closed:0,routes_detached:0}},{...f,event_kind:"card.binding.revoked",connection_sequence:null,data:{binding_id:f.binding_id,binding_revision:1,external_card_id:"scp_card_0001",card:q,revocation_source:"provider_lifecycle_event",payable_projections_closed:0,routes_detached:0}},{...f,event_kind:"card.binding.route_changed",data:{binding_id:f.binding_id,binding_revision:1,association_status:"associated"}},{...f,event_kind:"card.binding.route_changed",connection_sequence:null,data:{binding_id:f.binding_id,binding_revision:1,association_status:"unassociated"}},{...f,event_kind:"card.binding.limits_changed",data:{binding_id:f.binding_id,binding_revision:1,per_tx_limit:"1.000000",period_limit:"2.000000",period:"monthly",expires_at:"2027-01-01T00:00:00Z"}},{...f,event_kind:"card.binding.limits_changed",connection_sequence:null,data:{binding_id:f.binding_id,binding_revision:1,per_tx_limit:"1.000000",period_limit:"2.000000",period:"monthly",expires_at:null}},{...f,event_kind:"card.binding.ownership_transferred",data:{previous_binding_id:f.binding_id,new_binding_id:"cb_new0000000000001",external_card_id:"scp_card_0001",card:J,transferred_at:v.occurred_at}},{...f,event_kind:"card.binding.ownership_transferred",connection_sequence:null,data:{previous_binding_id:f.binding_id,new_binding_id:"cb_new0000000000001",external_card_id:"scp_card_0001",card:q,transferred_at:v.occurred_at}},{...v,event_kind:"card.charge.finalized",data:{authorization_revision:1,...C,final_receipt:B}},{...v,event_id:"00000000-0000-4000-8000-000000000002",event_kind:"card.charge.facts_updated",connection_sequence:2,data:{authorization_revision:2,...C,charge_id:B.charge_id,final_receipt_event_id:B.receipt_event_id,previous_authorization_revision:1,facts:Se}},{...v,event_kind:"card.authorization.updated",data:{lifecycle_revision:1,...C,authorization:{amount:"1.000000",currency:"USDC"},charge:null,issuer:{state:"authorized",cleared_amount:"0.000000",reversed_amount:"0.000000",refunded_amount:"0.000000",entry_count:0,unlinked_count:0},refunds:{case_count:0,status_counts:{awaiting_charge_final:0,awaiting_funds:0,payable:0,paid:0,failed:0,not_payable:0},total_amount:"0.000000",total_paid_amount:"0.000000",total_excess_amount:"0.000000"},change:{type:"authorization.recorded",at:v.occurred_at}}}];var Te=new Uint32Array([1116352408,1899447441,3049323471,3921009573,961987163,1508970993,2453635748,2870763221,3624381080,310598401,607225278,1426881987,1925078388,2162078206,2614888103,3248222580,3835390401,4022224774,264347078,604807628,770255983,1249150122,1555081692,1996064986,2554220882,2821834349,2952996808,3210313671,3336571891,3584528711,113926993,338241895,666307205,773529912,1294757372,1396182291,1695183700,1986661051,2177026350,2456956037,2730485921,2820302411,3259730800,3345764771,3516065817,3600352804,4094571909,275423344,430227734,506948616,659060556,883997877,958139571,1322822218,1537002063,1747873779,1955562222,2024104815,2227730452,2361852424,2428436474,2756734187,3204031479,3329325298]),Re=new Uint32Array([1779033703,3144134277,1013904242,2773480762,1359893119,2600822924,528734635,1541459225]),Ce=new TextEncoder;function oe(e){return typeof e=="string"?Ce.encode(e):e}function S(e,n){return e>>>n|e<<32-n}function F(e){let n=oe(e),u=Math.floor(n.byteLength*8/4294967296),a=n.byteLength*8>>>0,s=Math.ceil((n.byteLength+9)/64)*64,c=new Uint8Array(s);c.set(n),c[n.byteLength]=128;let y=new DataView(c.buffer);y.setUint32(s-8,u,!1),y.setUint32(s-4,a,!1);let r=new Uint32Array(Re),t=new Uint32Array(64);for(let o=0;o<s;o+=64){for(let _=0;_<16;_+=1)t[_]=y.getUint32(o+_*4,!1);for(let _=16;_<64;_+=1){let I=S(t[_-15],7)^S(t[_-15],18)^t[_-15]>>>3,A=S(t[_-2],17)^S(t[_-2],19)^t[_-2]>>>10;t[_]=t[_-16]+I+t[_-7]+A>>>0}let l=r[0],p=r[1],m=r[2],h=r[3],b=r[4],R=r[5],x=r[6],i=r[7];for(let _=0;_<64;_+=1){let I=S(b,6)^S(b,11)^S(b,25),A=b&R^~b&x,N=i+I+A+Te[_]+t[_]>>>0,Z=S(l,2)^S(l,13)^S(l,22),U=l&p^l&m^p&m,O=Z+U>>>0;i=x,x=R,R=b,b=h+N>>>0,h=m,m=p,p=l,l=N+O>>>0}r[0]=r[0]+l>>>0,r[1]=r[1]+p>>>0,r[2]=r[2]+m>>>0,r[3]=r[3]+h>>>0,r[4]=r[4]+b>>>0,r[5]=r[5]+R>>>0,r[6]=r[6]+x>>>0,r[7]=r[7]+i>>>0}let g=new Uint8Array(32),d=new DataView(g.buffer);for(let o=0;o<8;o+=1)d.setUint32(o*4,r[o],!1);return g}function ce(e){let n="";for(let u=0;u<e.byteLength;u+=1)n+=e[u].toString(16).padStart(2,"0");return n}function T(e){return ce(F(e))}function E(e,n){let a=new Uint8Array(64),s=e.byteLength>64?F(e):e;a.set(s);let c=new Uint8Array(64),y=new Uint8Array(64);for(let o=0;o<64;o+=1)c[o]=a[o]^54,y[o]=a[o]^92;let r=oe(n),t=new Uint8Array(64+r.byteLength);t.set(c,0),t.set(r,64);let g=F(t),d=new Uint8Array(96);return d.set(y,0),d.set(g,64),ce(F(d))}var Y=class{states=new Map;capacity;leaseMs;now;constructor(n={}){if(this.capacity=n.capacity??1e3,this.leaseMs=n.leaseMs??3e4,this.now=n.nowMs??(()=>performance.now()),!Number.isSafeInteger(this.capacity)||this.capacity<1)throw new RangeError("invalid_capacity");if(!Number.isSafeInteger(this.leaseMs)||this.leaseMs<1)throw new RangeError("invalid_lease")}async withConnection(n,u){let a=JSON.stringify([n.connectionId,n.environment,n.programId]),s=this.states.get(a);if(!s){if(this.states.size>=this.capacity)throw new Error("inbox_capacity");s={observedMax:null,digests:new Map,fence:0},this.states.set(a,s)}let c=this.now();if(!Number.isFinite(c))throw new Error("invalid_clock");if(s.lease&&s.lease.expiresAt>c)throw new Error("inbox_busy");if(!Number.isSafeInteger(s.fence+1)||!Number.isFinite(c+this.leaseMs))throw new Error("inbox_fence_exhausted");let y=++s.fence;s.lease={fence:y,expiresAt:c+this.leaseMs};let r=s,t=()=>{let o=this.now();if(!Number.isFinite(o)||r.lease?.fence!==y||o>=r.lease.expiresAt)throw new Error("inbox_lease_expired")},g=s.observedMax,d=new Map(s.digests);try{let l=await u({context:void 0,fence:y,async getDigest(p){return t(),d.get(p)},async getObservedMaxSequence(){return t(),g},markProcessed:async(p,m,h)=>{if(t(),!d.has(p)&&d.size>=this.capacity)throw new Error("inbox_capacity");d.set(p,m),h!==null&&(g=Math.max(g??0,h))}});return t(),r.observedMax=g,r.digests=d,l}finally{r.lease?.fence===y&&delete r.lease}}},ue={connectionId:"pconn_SYNTHETIC00000001",environment:"dev",programId:"cprog_SYNTHETIC00000001",targetRevision:"00000000-0000-4000-8000-000000000001"},G="card.binding.linked",le=new TextEncoder().encode("synthetic-delivery-test-key"),de={...ue,keyId:"synthetic-key",signerKeyVersion:1,notBefore:"2026-01-01T00:00:00Z",expiresAt:"2027-01-01T00:00:00Z",status:"active",eventKinds:[G],secret:le};function z(e,n=!1,u=!1){let a=`00000000-0000-4000-8000-${String(e).padStart(12,"0")}`,s=JSON.stringify({...$[n||u?1:0],event_id:a,binding_revision:e,connection_sequence:n?null:e}),c=new TextEncoder().encode(s),y="1792713600",r=T(c),t=E(le,["facto:card:outbound-delivery-signature","v1",a,G,y,r].join(`
2
+ `));return{rawBody:c,headers:[["facto-signature",`v1=${t}`],["facto-signature-key-id",de.keyId],["facto-event-id",a],["facto-event-kind",G],["facto-event-timestamp-seconds",y],["facto-delivery-attempt","1"]],registry:[de],expectedScope:ue,nowSeconds:Number(y)}}var w=z(1),Ee=z(2),se=z(3),W={duplicate:{deliveries:[w,w]},outOfOrder:{deliveries:[w,se,Ee]},gap:{deliveries:[w,se]},nullableCard:{deliveries:[z(1,!1,!0)]},unsequenced:{deliveries:[z(4,!0),w]}};var Q=Object.freeze({revision:"2026-11-18-card-events.1",digest:"sha256:9fcad68499ef3f770533ad3f3a4c4950d16c0385c56b2b0af6bba5375038aa98",approvedFeatureSnapshot:Object.freeze(["binding","new_consumption","supplier_fact_updates"]),featureClosures:Object.freeze({binding:Object.freeze(["card.binding.linked","card.binding.relinked","card.binding.revoked","card.binding.route_changed","card.binding.limits_changed","card.binding.ownership_transferred"]),new_consumption:Object.freeze(["card.charge.finalized"]),supplier_fact_updates:Object.freeze(["card.charge.facts_updated"])})}),Ae=Object.freeze({revision:"2026-11-18-card-events.1",digest:"sha256:9fcad68499ef3f770533ad3f3a4c4950d16c0385c56b2b0af6bba5375038aa98",approvedFeatureSnapshot:Object.freeze([...Q.approvedFeatureSnapshot,"authorization_updates"]),featureClosures:Object.freeze({...Q.featureClosures,authorization_updates:Object.freeze(["card.authorization.updated"])})}),De="synthetic-delivery-test-key",V=["duplicate","outOfOrder","gap","nullableCard","unsequenced","authorizationOutOfOrder","authorizationRedelivery","refundAwaitingChargeFinal","refundAwaitingFunds","refundPayable","refundPaid","refundFailed","refundNotPayable","chargeFailed"],X="card.binding.linked",ee="card.authorization.updated";function we(e){let n=V.indexOf(e)+1;return{name:e,selectionId:`00000000-0000-4000-8000-${String(100+n).padStart(12,"0")}`,connectionId:`pconn_SYNTHETIC0000000${n}`,programId:"cprog_SYNTHETIC00000001",environment:"dev",targetRevision:"00000000-0000-4000-8000-000000000001",keyId:`synthetic-delivery-${e}`,secretUtf8:De,signerKeyVersion:1,notBefore:"2020-01-01T00:00:00Z",expiresAt:"2099-01-01T00:00:00Z",status:"active",eventKinds:[n>5?ee:X]}}function ze(e,n=Math.floor(Date.now()/1e3),u=1){let a=we(e),s={connectionId:a.connectionId,programId:a.programId,environment:a.environment,targetRevision:a.targetRevision},c={...s,keyId:a.keyId,secret:new TextEncoder().encode(a.secretUtf8),signerKeyVersion:a.signerKeyVersion,notBefore:a.notBefore,expiresAt:a.expiresAt,status:a.status,eventKinds:a.eventKinds};if(e.startsWith("authorization")||e.startsWith("refund")||e==="chargeFailed"){let t=$.find(l=>l.event_kind==="card.authorization.updated"),d={refundAwaitingChargeFinal:"awaiting_charge_final",refundAwaitingFunds:"awaiting_funds",refundPayable:"payable",refundPaid:"paid",refundFailed:"failed",refundNotPayable:"not_payable"}[e],o=(l,p)=>{let m=`00000000-0000-4000-8002-${String(V.indexOf(e)*10+l+(p?1:0)).padStart(12,"0")}`,h=d?{case_id:"rfc_00000000000000000000000000000001",source_operation_type:"refund",status:d,amount:"1.000000",excess_amount:"0.000000",updated_at:t.occurred_at,...d==="paid"?{paid_amount:"1.000000",refund_payment:{chain_id:8453,tx_hash:`0x${"1".repeat(64)}`,paid_amount:"1.000000",recorded_by:"operator"}}:{}}:void 0,b={...t,event_id:m,program_id:a.programId,origin_connection_id:a.connectionId,connection_sequence:l+(p?1:0),data:{...t.data,lifecycle_revision:l,...d?{refunds:{...t.data.refunds,case_count:1,status_counts:{...t.data.refunds.status_counts,[d]:1},total_amount:"1.000000",total_paid_amount:d==="paid"?"1.000000":"0.000000"},charge:{charge_id:`0x${"2".repeat(64)}`,status:d==="awaiting_charge_final"?"processing":"succeeded",amount:"1.000000",fee_total:"0.000000",total_debited:"1.000000",currency:"USDC",updated_at:t.occurred_at}}:{},...e==="chargeFailed"?{charge:{charge_id:`0x${"2".repeat(64)}`,status:"failed",amount:"1.000000",fee_total:"0.000000",total_debited:"0.000000",currency:"USDC",failure_code:"synthetic_failure",updated_at:t.occurred_at}}:{},change:d?{type:`refund_case.${d}`,at:t.occurred_at,refund_case:h}:t.data.change}},R=new TextEncoder().encode(JSON.stringify(b)),x=String(n),i=T(R),I=[["facto-signature",`v1=${E(c.secret,["facto:card:outbound-delivery-signature","v1",m,ee,x,i].join(`
3
+ `))}`],["facto-signature-key-id",c.keyId],["facto-event-id",m],["facto-event-kind",ee],["facto-event-timestamp-seconds",x],["facto-delivery-attempt",String(p?Math.max(u,2):u)]];return p&&I.push(["facto-redelivery-reason","retry"]),{rawBody:R,headers:I,registry:[c],expectedScope:s}};return{config:a,deliveries:e==="authorizationOutOfOrder"?[o(2,!1),o(1,!1)]:e==="authorizationRedelivery"?[o(1,!1),o(1,!0)]:[o(1,!1)]}}let y=W[e],r=(t,g)=>{let d=JSON.parse(new TextDecoder().decode(t.rawBody)),o=Number(d.event_id.slice(-12));d.event_id=`00000000-0000-4000-8001-${V.indexOf(e)+1}${String(o).padStart(11,"0")}`,d.origin_connection_id=a.connectionId;let l=new TextEncoder().encode(JSON.stringify(d)),p=String(n),m=T(l),h=E(c.secret,["facto:card:outbound-delivery-signature","v1",d.event_id,X,p,m].join(`
4
+ `));return{rawBody:l,headers:[["facto-signature",`v1=${h}`],["facto-signature-key-id",c.keyId],["facto-event-id",d.event_id],["facto-event-kind",X],["facto-event-timestamp-seconds",p],["facto-delivery-attempt",String(g)]],registry:[c],expectedScope:s}};return{config:a,deliveries:y.deliveries.map((t,g)=>r(t,u+(e==="duplicate"&&g===1?1:0)))}}var L="11111111-1111-4111-8111-111111111101",k="acct_interlace_synthetic_01",H="synthetic-card",ge="synthetic-declined-card",fe=Object.freeze({authorizationApproved:Object.freeze({event:"CARD_TRANSACTION",id:L,cardId:H,accountId:k,clientTransactionId:"client-req-auth-0001",type:1,status:"PENDING",amount:"12.50",currency:"USD",merchantName:"Meridian Coffee",merchantMcc:"5814",merchantCountry:"US",transactionAt:"2026-11-18T00:00:00Z"}),authorizationDeclinedLimit:Object.freeze({event:"CARD_TRANSACTION",id:"11111111-1111-4111-8111-111111111102",cardId:ge,accountId:k,clientTransactionId:"client-req-decline-0002",type:1,status:"PENDING",amount:"9500.00",currency:"USD",merchantName:"Meridian Electronics",merchantMcc:"5732",merchantCountry:"US",transactionAt:"2026-11-18T00:05:00Z"}),clearingEqualAmount:Object.freeze({event:"CARD_TRANSACTION",id:"11111111-1111-4111-8111-111111111103",cardId:H,accountId:k,clientTransactionId:"client-req-clearing-0003",relatedCardTransactionId:L,type:1,status:"CLEARED",amount:"12.50",currency:"USD",merchantName:"Meridian Coffee",merchantMcc:"5814",merchantCountry:"US",transactionAt:"2026-11-18T01:00:00Z",clearingEvidence:Object.freeze({profile:"facto-interlace-v1",state:"CLEARED",amount:"12.50",currency:"USD",occurredAt:"2026-11-18T01:00:00Z",revision:1,refundableAmount:"12.50"})}),partialReversalUncleared:Object.freeze({event:"CARD_TRANSACTION",id:"11111111-1111-4111-8111-111111111104",cardId:H,accountId:k,clientTransactionId:"client-req-reversal-0004",relatedCardTransactionId:L,type:14,status:"CLOSED",amount:"5.00",currency:"USD",merchantName:"Meridian Coffee",merchantMcc:"5814",merchantCountry:"US",transactionAt:"2026-11-18T00:30:00Z"}),merchantRefundCleared:Object.freeze({event:"CARD_TRANSACTION",id:"11111111-1111-4111-8111-111111111105",cardId:H,accountId:k,clientTransactionId:"client-req-refund-0005",relatedCardTransactionId:L,type:0,status:"CLOSED",amount:"4.00",currency:"USD",merchantName:"Meridian Coffee",merchantMcc:"5814",merchantCountry:"US",transactionAt:"2026-11-18T02:00:00Z",clearingEvidence:Object.freeze({profile:"facto-interlace-v1",state:"CLEARED",amount:"12.50",currency:"USD",occurredAt:"2026-11-18T01:00:00Z",revision:2,refundableAmount:"8.50"})})}),ve="cprog_SYNTHETIC00000001",me="pconn_SYNTHETIC00000001",he="facto-interlace-v1",ke="00000000-0000-4000-8000-000000000001",Ne="synthetic-delivery-test-key";function pe(e,n,u,a){return`interlace-v1-${T(JSON.stringify([e,n,u,a])).slice(0,32)}`}function j(e){let n=T(e);return`${n.slice(0,8)}-${n.slice(8,12)}-4${n.slice(13,16)}-8${n.slice(17,20)}-${n.slice(20,32)}`}function ye(e){return`0x${"0".repeat(32)}${T(e).slice(0,32)}`}function P(e,n){return new Error(`Interlace CARD_TRANSACTION ${e.id} (type ${e.type}, status ${e.status}) cannot be mapped: ${n}. Hold it for authoritative evidence; never submit it as a new authorization.`)}function Ue(e){let n=e.clearingEvidence?.state==="CLEARED";if(e.type===1){if(n)return"clearing";if(e.relatedCardTransactionId!==void 0)throw P(e,"a consumption record linked to a parent maps only to a clearing fact, which requires clearingEvidence.state CLEARED");return}let u=e.type===14?"reversal":"refund";if(e.relatedCardTransactionId===void 0)throw P(e,`a ${u} child requires relatedCardTransactionId pointing to the original consumption`);if(e.status!=="CLOSED"&&e.status!=="CLEARED")throw P(e,`status ${e.status} is not a final successful ${u}`);if(u==="refund"&&!n)throw P(e,"a merchant refund requires clearingEvidence.state CLEARED for the original consumption");return u}function be(e,n={}){let u=n.programId??ve,a=n.connectionId??me,s=n.mappingRevision??he,c=Ue(e);if(c!==void 0){let r=e.relatedCardTransactionId??e.id,t=`${c}-${e.id}`,g=n.predecessorVersion??(c==="refund"?`clearing-${r}`:"auth-v1"),d=pe(a,r,e.id,c);return{endpoint:"POST /api/card/authorizations/{external_id}/facts",externalAuthorizationId:r,idempotencyKey:d,payload:{program_id:u,fact_type:c,supplier_transaction_id:e.id,parent_supplier_transaction_id:r,client_transaction_id:e.clientTransactionId,amount:e.amount,currency:e.currency,resource_version:t,predecessor_version:g,mapping_revision:s,recorded_at:e.clearingEvidence?.occurredAt??e.transactionAt}}}return{endpoint:"POST /api/card/authorizations",idempotencyKey:pe(a,e.id,e.id,"create_authorization"),payload:{program_id:u,external_card_id:e.cardId,external_authorization_id:e.id,supplier_transaction_id:e.id,client_transaction_id:e.clientTransactionId,amount:e.amount,currency:e.currency,merchant_name:e.merchantName,merchant_mcc:e.merchantMcc,merchant_country:e.merchantCountry,resource_version:"auth-v1",mapping_revision:s,cardholder_verification:{method:"provider_attested",verified_at:e.transactionAt,evidence_id:`interlace:${e.clientTransactionId}`}}}}function Oe(e){if(typeof e=="string"){let n=fe[e];if(!n)throw new RangeError(`Unknown Interlace CARD_TRANSACTION fixture: ${e}`);return{fixtureName:e,sourceEvent:n}}return{sourceEvent:e}}function _e(e){let n=j(`${e.scope.connectionId}:${e.externalAuthorizationId}:${e.sequence}:${e.changeType}`),u="card.authorization.updated",a=e.operationType==="clearing",s=e.operationType==="reversal",c=e.operationType==="refund",y=Number(e.amount).toFixed(6),r={envelope_version:2,event_id:n,event_kind:u,environment:e.scope.environment,program_id:e.scope.programId,origin_connection_id:e.scope.connectionId,connection_sequence:e.sequence,occurred_at:e.occurredAt,data:{lifecycle_revision:e.sequence,operation_type:e.operationType,resource_version:e.resourceVersion,external_authorization_id:e.externalAuthorizationId,mapping_revision:e.mappingRevision,authorization:{supplier_transaction_id:e.supplierTransactionId,amount:y,currency:"USDC"},charge:{charge_id:e.chargeId,status:"processing",amount:y,fee_total:"0.000000",total_debited:y,currency:"USDC",updated_at:e.occurredAt},issuer:{state:c?"refunded":s?"partially_reversed":a?"cleared":"authorized",cleared_amount:a?y:"0.000000",reversed_amount:s?y:"0.000000",refunded_amount:c?y:"0.000000",entry_count:e.sequence,unlinked_count:0,last_recorded_at:e.occurredAt},refunds:{case_count:c?1:0,status_counts:{awaiting_charge_final:0,awaiting_funds:c?1:0,payable:0,paid:0,failed:0,not_payable:0},total_amount:c?y:"0.000000",total_paid_amount:"0.000000",total_excess_amount:"0.000000"},change:{type:e.changeType,at:e.occurredAt,...e.changeType==="issuer_fact.recorded"?{issuer_fact:{operation_type:e.operationType,resource_version:e.resourceVersion,amount:y,currency:"USDC",recorded_at:e.occurredAt,link_status:"linked"}}:{}}}},t=new TextEncoder().encode(JSON.stringify(r)),g=String(e.nowSeconds),d=T(t),o=E(e.secret,["facto:card:outbound-delivery-signature","v1",n,u,g,d].join(`
5
+ `)),l={...e.scope,keyId:"synthetic-sandbox-delivery-key",secret:e.secret,signerKeyVersion:1,notBefore:"2020-01-01T00:00:00Z",expiresAt:"2099-01-01T00:00:00Z",status:"active",eventKinds:[u]},p=[["facto-signature",`v1=${o}`],["facto-signature-key-id",l.keyId],["facto-event-id",n],["facto-event-kind",u],["facto-event-timestamp-seconds",g],["facto-delivery-attempt",e.isSandboxReplay?"2":"1"]];return e.isSandboxReplay&&p.push(["facto-redelivery-reason","sandbox_replay"]),{rawBody:t,headers:p,registry:[l],expectedScope:e.scope,nowSeconds:e.nowSeconds}}function xe(e={}){let n=e.programId??ve,u=e.connectionId??me,a=e.mappingRevision??he,s=e.targetRevision??ke,c=new TextEncoder().encode(e.deliverySecretUtf8??Ne),y=e.nowSeconds??(()=>1795e6),r=new Map,t=[],g=0;return{replayInterlaceTransaction(d,o={}){let{fixtureName:l,sourceEvent:p}=Oe(d),m=o.programId??n,h=o.connectionId??u,b=o.mappingRevision??a,R=o.targetRevision??s,x=o.nowSeconds??y(),i=be(p,{...o,programId:m,connectionId:h,mappingRevision:b}),_=JSON.stringify(i.payload),I=r.get(i.idempotencyKey);if(I){if(I.bodyJson!==_){let D={error:"idempotency_payload_mismatch",message:"Idempotency-Key was previously used with different request bytes",request_id:`req_sandbox_${j(_).slice(0,8)}`},M={...l?{fixtureName:l}:{},sourceEvent:p,mappedRequest:i,simulatedHttpStatus:409,simulatedResponse:D};return t.push({sequence:t.length+1,idempotencyKey:i.idempotencyKey,endpoint:i.endpoint,httpStatus:409,response:D}),M}return I.result}let A={connectionId:h,environment:"dev",programId:m,targetRevision:R};if(i.endpoint==="POST /api/card/authorizations"){if(p.cardId===ge||Number(p.amount)>5e3){let ae={error:"spending_limit_exceeded",message:"Pre-admission spending limit exceeded",request_id:`req_sandbox_${j(i.idempotencyKey).slice(0,8)}`},Ie={...l?{fixtureName:l}:{},sourceEvent:p,mappedRequest:i,simulatedHttpStatus:402,simulatedResponse:ae};return t.push({sequence:t.length+1,idempotencyKey:i.idempotencyKey,endpoint:i.endpoint,httpStatus:402,response:ae}),Ie}g+=1;let D=ye(`${h}:${i.payload.external_authorization_id}`),M={charge_id:D,status:"processing"},te=_e({scope:A,secret:c,sequence:g,nowSeconds:x,isSandboxReplay:o.isSandboxReplay??!1,externalAuthorizationId:i.payload.external_authorization_id,supplierTransactionId:i.payload.supplier_transaction_id,mappingRevision:b,resourceVersion:i.payload.resource_version,operationType:"authorization_requested",amount:i.payload.amount,currency:i.payload.currency,chargeId:D,occurredAt:p.transactionAt,changeType:"authorization.recorded"}),re={...l?{fixtureName:l}:{},sourceEvent:p,mappedRequest:i,simulatedHttpStatus:200,simulatedResponse:M,outboundDelivery:te};return r.set(i.idempotencyKey,{bodyJson:_,result:re}),t.push({sequence:t.length+1,idempotencyKey:i.idempotencyKey,endpoint:i.endpoint,httpStatus:200,response:M,outboundDelivery:te}),re}g+=1;let N=j(`${h}:${i.idempotencyKey}`),Z=ye(`${h}:${i.externalAuthorizationId}`),U={operation_id:N,status:"recorded"},O=_e({scope:A,secret:c,sequence:g,nowSeconds:x,isSandboxReplay:o.isSandboxReplay??!1,externalAuthorizationId:i.externalAuthorizationId,supplierTransactionId:i.payload.supplier_transaction_id,mappingRevision:b,resourceVersion:i.payload.resource_version,operationType:i.payload.fact_type,amount:i.payload.amount,currency:i.payload.currency,chargeId:Z,occurredAt:i.payload.recorded_at,changeType:"issuer_fact.recorded"}),ne={...l?{fixtureName:l}:{},sourceEvent:p,mappedRequest:i,simulatedHttpStatus:200,simulatedResponse:U,outboundDelivery:O};return r.set(i.idempotencyKey,{bodyJson:_,result:ne}),t.push({sequence:t.length+1,idempotencyKey:i.idempotencyKey,endpoint:i.endpoint,httpStatus:200,response:U,outboundDelivery:O}),ne},listRecordedEvents(){return[...t]},reset(){r.clear(),t.length=0,g=0}}}function Me(e,n={}){return xe({programId:n.programId,connectionId:n.connectionId,mappingRevision:n.mappingRevision,targetRevision:n.targetRevision,nowSeconds:n.nowSeconds!==void 0?()=>n.nowSeconds:void 0}).replayInterlaceTransaction(e,n)}export{Y as MemoryDeliveryInboxStore,Ae as authorizationEventCatalogFixture,xe as createCardSandboxRuntime,W as deliveryInboxVectors,fe as interlaceCardTransactionFixtures,be as mapInterlaceCardTransactionToAuthorization,Me as replayInterlaceCardTransaction,Q as requiredEventCatalogFixture,V as simulatorDeliveryKinds,ze as simulatorDeliveryScenario};