@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,6 @@
1
+ "use strict";var ot=Object.defineProperty;var _n=Object.getOwnPropertyDescriptor;var yn=Object.getOwnPropertyNames;var fn=Object.prototype.hasOwnProperty;var gn=(e,t)=>{for(var r in t)ot(e,r,{get:t[r],enumerable:!0})},mn=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let a of yn(t))!fn.call(e,a)&&a!==r&&ot(e,a,{get:()=>t[a],enumerable:!(n=_n(t,a))||n.enumerable});return e};var hn=e=>mn(ot({},"__esModule",{value:!0}),e);var Pr={};gn(Pr,{MemoryDeliveryInboxStore:()=>Ue,authorizationEventCatalogFixture:()=>Dt,createCardSandboxRuntime:()=>vt,deliveryInboxVectors:()=>ce,interlaceCardTransactionFixtures:()=>ht,mapInterlaceCardTransactionToAuthorization:()=>bt,replayInterlaceCardTransaction:()=>ln,requiredEventCatalogFixture:()=>$e,runCardSimulatorVectors:()=>nn,simulatorDeliveryKinds:()=>ge,simulatorDeliveryScenario:()=>Fe,startCardSimulator:()=>Lt});module.exports=hn(Pr);var B={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"},L={...B,binding_id:"cb_01JZ9X8K4M2V7R5T3N6P8Q0W2Z",binding_revision:1},st={network:"Visa",type:"virtual",last4:"4242"},Pe={network:null,type:null,last4:null},Ne={binding_id:L.binding_id,intent_id:null,external_card_id:"scp_card_0001",subject_link_id:"csl_synthetic",card:st,approved_scopes:["card.metadata.view"],consent_revision:"synthetic"},ye={operation_type:"authorization_requested",resource_version:"v1",external_authorization_id:"synthetic-auth",mapping_revision:"synthetic-mapping"},Ct=[{kind:"facto_admission",state:"confirmed",recorded_at:B.occurred_at,source_system:"facto",observed_at:B.occurred_at},{kind:"durable_commit",state:"confirmed",recorded_at:B.occurred_at,source_system:"facto",observed_at:B.occurred_at},{kind:"provider_authorization",state:"unobserved",recorded_at:B.occurred_at,source_system:"provider"},{kind:"chain_finality",state:"confirmed",recorded_at:B.occurred_at,source_system:"chain",observed_at:B.occurred_at},{kind:"provider_settlement",state:"unobserved",recorded_at:B.occurred_at,source_system:"provider"}],bn=Ct.map(e=>e.kind==="provider_authorization"?{...e,state:"confirmed",observed_at:B.occurred_at}:e),at={receipt_event_id:B.event_id,charge_id:"0x"+"0".repeat(62)+"01",external_authorization_id:ye.external_authorization_id,mapping_revision:ye.mapping_revision,operation_type:ye.operation_type,resource_version:ye.resource_version,execution_outcome:"succeeded",terminal_action:"releaseFor",finalized_at:B.occurred_at,facts_at_finality:Ct},qe=[{...L,event_kind:"card.binding.linked",data:Ne},{...L,event_kind:"card.binding.linked",connection_sequence:null,data:{...Ne,intent_id:"cint_01JZ9X8K4M2V7R5T3N6P8Q0W2Y",card:Pe}},{...L,event_kind:"card.binding.relinked",data:Ne},{...L,event_kind:"card.binding.relinked",connection_sequence:null,data:{...Ne,intent_id:"cint_01JZ9X8K4M2V7R5T3N6P8Q0W2Y",card:Pe}},{...L,event_kind:"card.binding.revoked",data:{binding_id:L.binding_id,binding_revision:1,external_card_id:"scp_card_0001",card:st,revocation_source:"user_portfolio",reason_code:"user_requested",payable_projections_closed:0,routes_detached:0}},{...L,event_kind:"card.binding.revoked",connection_sequence:null,data:{binding_id:L.binding_id,binding_revision:1,external_card_id:"scp_card_0001",card:Pe,revocation_source:"provider_lifecycle_event",payable_projections_closed:0,routes_detached:0}},{...L,event_kind:"card.binding.route_changed",data:{binding_id:L.binding_id,binding_revision:1,association_status:"associated"}},{...L,event_kind:"card.binding.route_changed",connection_sequence:null,data:{binding_id:L.binding_id,binding_revision:1,association_status:"unassociated"}},{...L,event_kind:"card.binding.limits_changed",data:{binding_id:L.binding_id,binding_revision:1,per_tx_limit:"1.000000",period_limit:"2.000000",period:"monthly",expires_at:"2027-01-01T00:00:00Z"}},{...L,event_kind:"card.binding.limits_changed",connection_sequence:null,data:{binding_id:L.binding_id,binding_revision:1,per_tx_limit:"1.000000",period_limit:"2.000000",period:"monthly",expires_at:null}},{...L,event_kind:"card.binding.ownership_transferred",data:{previous_binding_id:L.binding_id,new_binding_id:"cb_new0000000000001",external_card_id:"scp_card_0001",card:st,transferred_at:B.occurred_at}},{...L,event_kind:"card.binding.ownership_transferred",connection_sequence:null,data:{previous_binding_id:L.binding_id,new_binding_id:"cb_new0000000000001",external_card_id:"scp_card_0001",card:Pe,transferred_at:B.occurred_at}},{...B,event_kind:"card.charge.finalized",data:{authorization_revision:1,...ye,final_receipt:at}},{...B,event_id:"00000000-0000-4000-8000-000000000002",event_kind:"card.charge.facts_updated",connection_sequence:2,data:{authorization_revision:2,...ye,charge_id:at.charge_id,final_receipt_event_id:at.receipt_event_id,previous_authorization_revision:1,facts:bn}},{...B,event_kind:"card.authorization.updated",data:{lifecycle_revision:1,...ye,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:B.occurred_at}}}];var vn=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]),xn=new Uint32Array([1779033703,3144134277,1013904242,2773480762,1359893119,2600822924,528734635,1541459225]),In=new TextEncoder;function Rt(e){return typeof e=="string"?In.encode(e):e}function ae(e,t){return e>>>t|e<<32-t}function Le(e){let t=Rt(e),r=Math.floor(t.byteLength*8/4294967296),n=t.byteLength*8>>>0,a=Math.ceil((t.byteLength+9)/64)*64,c=new Uint8Array(a);c.set(t),c[t.byteLength]=128;let m=new DataView(c.buffer);m.setUint32(a-8,r,!1),m.setUint32(a-4,n,!1);let y=new Uint32Array(xn),i=new Uint32Array(64);for(let l=0;l<a;l+=64){for(let p=0;p<16;p+=1)i[p]=m.getUint32(l+p*4,!1);for(let p=16;p<64;p+=1){let w=ae(i[p-15],7)^ae(i[p-15],18)^i[p-15]>>>3,b=ae(i[p-2],17)^ae(i[p-2],19)^i[p-2]>>>10;i[p]=i[p-16]+w+i[p-7]+b>>>0}let _=y[0],s=y[1],S=y[2],C=y[3],E=y[4],D=y[5],o=y[6],h=y[7];for(let p=0;p<64;p+=1){let w=ae(E,6)^ae(E,11)^ae(E,25),b=E&D^~E&o,I=h+w+b+vn[p]+i[p]>>>0,F=ae(_,2)^ae(_,13)^ae(_,22),te=_&s^_&S^s&S,K=F+te>>>0;h=o,o=D,D=E,E=C+I>>>0,C=S,S=s,s=_,_=I+K>>>0}y[0]=y[0]+_>>>0,y[1]=y[1]+s>>>0,y[2]=y[2]+S>>>0,y[3]=y[3]+C>>>0,y[4]=y[4]+E>>>0,y[5]=y[5]+D>>>0,y[6]=y[6]+o>>>0,y[7]=y[7]+h>>>0}let u=new Uint8Array(32),d=new DataView(u.buffer);for(let l=0;l<8;l+=1)d.setUint32(l*4,y[l],!1);return u}function zt(e){let t="";for(let r=0;r<e.byteLength;r+=1)t+=e[r].toString(16).padStart(2,"0");return t}function se(e){return zt(Le(e))}function fe(e,t){let n=new Uint8Array(64),a=e.byteLength>64?Le(e):e;n.set(a);let c=new Uint8Array(64),m=new Uint8Array(64);for(let l=0;l<64;l+=1)c[l]=n[l]^54,m[l]=n[l]^92;let y=Rt(t),i=new Uint8Array(64+y.byteLength);i.set(c,0),i.set(y,64);let u=Le(i),d=new Uint8Array(96);return d.set(m,0),d.set(u,64),zt(Le(d))}var Ue=class{states=new Map;capacity;leaseMs;now;constructor(t={}){if(this.capacity=t.capacity??1e3,this.leaseMs=t.leaseMs??3e4,this.now=t.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(t,r){let n=JSON.stringify([t.connectionId,t.environment,t.programId]),a=this.states.get(n);if(!a){if(this.states.size>=this.capacity)throw new Error("inbox_capacity");a={observedMax:null,digests:new Map,fence:0},this.states.set(n,a)}let c=this.now();if(!Number.isFinite(c))throw new Error("invalid_clock");if(a.lease&&a.lease.expiresAt>c)throw new Error("inbox_busy");if(!Number.isSafeInteger(a.fence+1)||!Number.isFinite(c+this.leaseMs))throw new Error("inbox_fence_exhausted");let m=++a.fence;a.lease={fence:m,expiresAt:c+this.leaseMs};let y=a,i=()=>{let l=this.now();if(!Number.isFinite(l)||y.lease?.fence!==m||l>=y.lease.expiresAt)throw new Error("inbox_lease_expired")},u=a.observedMax,d=new Map(a.digests);try{let _=await r({context:void 0,fence:m,async getDigest(s){return i(),d.get(s)},async getObservedMaxSequence(){return i(),u},markProcessed:async(s,S,C)=>{if(i(),!d.has(s)&&d.size>=this.capacity)throw new Error("inbox_capacity");d.set(s,S),C!==null&&(u=Math.max(u??0,C))}});return i(),y.observedMax=u,y.digests=d,_}finally{y.lease?.fence===m&&delete y.lease}}},Et={connectionId:"pconn_SYNTHETIC00000001",environment:"dev",programId:"cprog_SYNTHETIC00000001",targetRevision:"00000000-0000-4000-8000-000000000001"},dt="card.binding.linked",Ot=new TextEncoder().encode("synthetic-delivery-test-key"),kt={...Et,keyId:"synthetic-key",signerKeyVersion:1,notBefore:"2026-01-01T00:00:00Z",expiresAt:"2027-01-01T00:00:00Z",status:"active",eventKinds:[dt],secret:Ot};function we(e,t=!1,r=!1){let n=`00000000-0000-4000-8000-${String(e).padStart(12,"0")}`,a=JSON.stringify({...qe[t||r?1:0],event_id:n,binding_revision:e,connection_sequence:t?null:e}),c=new TextEncoder().encode(a),m="1792713600",y=se(c),i=fe(Ot,["facto:card:outbound-delivery-signature","v1",n,dt,m,y].join(`
2
+ `));return{rawBody:c,headers:[["facto-signature",`v1=${i}`],["facto-signature-key-id",kt.keyId],["facto-event-id",n],["facto-event-kind",dt],["facto-event-timestamp-seconds",m],["facto-delivery-attempt","1"]],registry:[kt],expectedScope:Et,nowSeconds:Number(m)}}var Se=we(1),An=we(2),Tt=we(3),ce={duplicate:{deliveries:[Se,Se]},outOfOrder:{deliveries:[Se,Tt,An]},gap:{deliveries:[Se,Tt]},nullableCard:{deliveries:[we(1,!1,!0)]},unsequenced:{deliveries:[we(4,!0),Se]}};var $e=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"])})}),Dt=Object.freeze({revision:"2026-11-18-card-events.1",digest:"sha256:9fcad68499ef3f770533ad3f3a4c4950d16c0385c56b2b0af6bba5375038aa98",approvedFeatureSnapshot:Object.freeze([...$e.approvedFeatureSnapshot,"authorization_updates"]),featureClosures:Object.freeze({...$e.featureClosures,authorization_updates:Object.freeze(["card.authorization.updated"])})}),Sn="synthetic-delivery-test-key",ge=["duplicate","outOfOrder","gap","nullableCard","unsequenced","authorizationOutOfOrder","authorizationRedelivery","refundAwaitingChargeFinal","refundAwaitingFunds","refundPayable","refundPaid","refundFailed","refundNotPayable","chargeFailed"],ct="card.binding.linked",ut="card.authorization.updated";function lt(e){let t=ge.indexOf(e)+1;return{name:e,selectionId:`00000000-0000-4000-8000-${String(100+t).padStart(12,"0")}`,connectionId:`pconn_SYNTHETIC0000000${t}`,programId:"cprog_SYNTHETIC00000001",environment:"dev",targetRevision:"00000000-0000-4000-8000-000000000001",keyId:`synthetic-delivery-${e}`,secretUtf8:Sn,signerKeyVersion:1,notBefore:"2020-01-01T00:00:00Z",expiresAt:"2099-01-01T00:00:00Z",status:"active",eventKinds:[t>5?ut:ct]}}function Fe(e,t=Math.floor(Date.now()/1e3),r=1){let n=lt(e),a={connectionId:n.connectionId,programId:n.programId,environment:n.environment,targetRevision:n.targetRevision},c={...a,keyId:n.keyId,secret:new TextEncoder().encode(n.secretUtf8),signerKeyVersion:n.signerKeyVersion,notBefore:n.notBefore,expiresAt:n.expiresAt,status:n.status,eventKinds:n.eventKinds};if(e.startsWith("authorization")||e.startsWith("refund")||e==="chargeFailed"){let i=qe.find(_=>_.event_kind==="card.authorization.updated"),d={refundAwaitingChargeFinal:"awaiting_charge_final",refundAwaitingFunds:"awaiting_funds",refundPayable:"payable",refundPaid:"paid",refundFailed:"failed",refundNotPayable:"not_payable"}[e],l=(_,s)=>{let S=`00000000-0000-4000-8002-${String(ge.indexOf(e)*10+_+(s?1:0)).padStart(12,"0")}`,C=d?{case_id:"rfc_00000000000000000000000000000001",source_operation_type:"refund",status:d,amount:"1.000000",excess_amount:"0.000000",updated_at:i.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,E={...i,event_id:S,program_id:n.programId,origin_connection_id:n.connectionId,connection_sequence:_+(s?1:0),data:{...i.data,lifecycle_revision:_,...d?{refunds:{...i.data.refunds,case_count:1,status_counts:{...i.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:i.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:i.occurred_at}}:{},change:d?{type:`refund_case.${d}`,at:i.occurred_at,refund_case:C}:i.data.change}},D=new TextEncoder().encode(JSON.stringify(E)),o=String(t),h=se(D),w=[["facto-signature",`v1=${fe(c.secret,["facto:card:outbound-delivery-signature","v1",S,ut,o,h].join(`
3
+ `))}`],["facto-signature-key-id",c.keyId],["facto-event-id",S],["facto-event-kind",ut],["facto-event-timestamp-seconds",o],["facto-delivery-attempt",String(s?Math.max(r,2):r)]];return s&&w.push(["facto-redelivery-reason","retry"]),{rawBody:D,headers:w,registry:[c],expectedScope:a}};return{config:n,deliveries:e==="authorizationOutOfOrder"?[l(2,!1),l(1,!1)]:e==="authorizationRedelivery"?[l(1,!1),l(1,!0)]:[l(1,!1)]}}let m=ce[e],y=(i,u)=>{let d=JSON.parse(new TextDecoder().decode(i.rawBody)),l=Number(d.event_id.slice(-12));d.event_id=`00000000-0000-4000-8001-${ge.indexOf(e)+1}${String(l).padStart(11,"0")}`,d.origin_connection_id=n.connectionId;let _=new TextEncoder().encode(JSON.stringify(d)),s=String(t),S=se(_),C=fe(c.secret,["facto:card:outbound-delivery-signature","v1",d.event_id,ct,s,S].join(`
4
+ `));return{rawBody:_,headers:[["facto-signature",`v1=${C}`],["facto-signature-key-id",c.keyId],["facto-event-id",d.event_id],["facto-event-kind",ct],["facto-event-timestamp-seconds",s],["facto-delivery-attempt",String(u)]],registry:[c],expectedScope:a}};return{config:n,deliveries:m.deliveries.map((i,u)=>y(i,r+(e==="duplicate"&&u===1?1:0)))}}var he=require("node:crypto"),qt=require("node:http");var Ie=require("node:crypto");var wn=new Set([400,401,402,403,404,410,412,422,423]),Cn=new Set(["idempotency_payload_mismatch","mapping_revision_not_approved","fact_type_not_allowed","managed_route_refused","ambiguous_lookup_selector"]);function Rn(e){if(typeof e!="object"||e===null||Array.isArray(e))return{engineCode:void 0,requestId:void 0};let t=e;if(typeof t.error=="string"&&t.error.length>0)return{engineCode:t.error,requestId:typeof t.request_id=="string"&&t.request_id.length>0?t.request_id:void 0};if(typeof t.error=="object"&&t.error!==null&&!Array.isArray(t.error)){let r=t.error;return{engineCode:typeof r.code=="string"&&r.code.length>0?r.code:void 0,requestId:typeof r.request_id=="string"&&r.request_id.length>0?r.request_id:void 0}}return{engineCode:typeof t.code=="string"&&t.code.length>0?t.code:void 0,requestId:typeof t.request_id=="string"&&t.request_id.length>0?t.request_id:void 0}}function zn(e,t,r){return e==="FACTO_CONFIG_INVALID"?"config_invalid":e==="FACTO_ENGINE_RESPONSE_INVALID"||e==="FACTO_REQUEST_ABORTED"||e==="FACTO_STATUS_POLL_ABORTED"||t===void 0?"unknown":wn.has(t)||t===409&&r!==void 0&&Cn.has(r)?"refused":"unknown"}var pt=class extends Error{code;retryable;status;details;retryAfterSeconds;constructor(t,r,n){super(r),this.name="FactoConnectServerError",this.code=t,this.retryable=n.retryable,this.status=n.status,this.details=n.details,this.retryAfterSeconds=n.retryAfterSeconds}},U=class extends pt{outcome;engineCode;httpStatus;requestId;constructor(t,r,n){let a=n.httpStatus??n.status;super(t,r,{retryable:n.retryable,status:a,details:n.details,retryAfterSeconds:n.retryAfterSeconds}),this.name="CardError",this.httpStatus=a;let c=Rn(n.details);this.engineCode=n.engineCode??c.engineCode,this.requestId=n.requestId??c.requestId,this.outcome=n.outcome??zn(t,a,this.engineCode)}};var kn=/^(?:[0-9a-fA-F]{2})+$/;function me(e){return new U("FACTO_CONFIG_INVALID",e,{retryable:!1})}function Be(e){if(typeof e=="string")throw me("apiKeySecret cannot be a bare string; pass { encoding: 'hex', value }, { encoding: 'utf8', value }, or Uint8Array");if(e instanceof Uint8Array){if(e.byteLength===0)throw me("apiKeySecret Uint8Array must not be empty");return new Uint8Array(e)}if(typeof e!="object"||e===null||Array.isArray(e))throw me("apiKeySecret must be { encoding: 'hex', value }, { encoding: 'utf8', value }, or Uint8Array");if(Object.keys(e).length!==2||!Object.hasOwn(e,"encoding")||!Object.hasOwn(e,"value"))throw me("apiKeySecret must contain only { encoding: 'hex' | 'utf8', value: string }");let{encoding:r,value:n}=e;if(r==="utf8"){if(typeof n!="string"||n.length===0)throw me("apiKeySecret with encoding 'utf8' must have a non-empty string value");return new TextEncoder().encode(n)}if(r==="hex"){if(typeof n!="string"||!kn.test(n))throw me("apiKeySecret with encoding 'hex' must be a non-empty, even-length hexadecimal string");let a=new Uint8Array(n.length/2);for(let c=0;c<n.length;c+=2)a[c/2]=Number.parseInt(n.slice(c,c+2),16);return a}throw me("apiKeySecret encoding must be 'hex' or 'utf8', or pass a Uint8Array")}function Ce(e){let t=Be(e.secret),r=(0,Ie.createHash)("sha256").update(e.body).digest("hex"),n=["FACTO-HMAC-V2",e.method,e.target,String(e.timestamp),e.nonce,r].join(`
5
+ `),a=new Headers({"x-api-key":e.apiKeyId,"x-api-timestamp":String(e.timestamp),"x-api-nonce":e.nonce,"x-api-signature":(0,Ie.createHmac)("sha256",t).update(n,"utf8").digest("hex")});return e.idempotencyKey!==void 0&&a.set("Idempotency-Key",e.idempotencyKey),a}function Pt(e){let t=Be(e.secret),r=new Headers(e.headers),n=r.get("x-api-timestamp"),a=r.get("x-api-nonce"),c=r.get("x-api-signature");if(r.get("x-api-key")!==e.apiKeyId||!n||!/^\d{10}$/.test(n)||!a||!/^[\x21-\x7e]{1,128}$/.test(a)||!c||!/^[a-f0-9]{64}$/.test(c))return!1;let m=Ce({...e,secret:t,timestamp:Number(n),nonce:a}).get("x-api-signature");return(0,Ie.timingSafeEqual)(Buffer.from(c,"hex"),Buffer.from(m,"hex"))}var J={connectionId:"pconn_SYNTHETIC00000001",programId:"synthetic-program",apiKeyId:"synthetic-key",apiKeySecret:{encoding:"utf8",value:"SYNTHETIC-TEST-KEY-NOT-A-SECRET"}},ue="00000000-0000-4000-8000-000000000001",be="00000000-0000-4000-8000-000000000002",Tn=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,Nt=/^cint_[A-Za-z0-9_-]{16,}$/;async function Lt(e=0,t={}){let r=t.capacity??1e3,n=t.ttlMs??6e5,a=t.nowMs??Date.now;if(!Number.isSafeInteger(r)||r<1||!Number.isSafeInteger(n)||n<1)throw new Error("Invalid simulator limits");let c=new Map,m=new Map,y=new Map,i=new Map,u=new Map,d=new Map,l=new Map,_=(p,w)=>JSON.stringify([p,w]),s=(p,w)=>JSON.stringify([p,w]),S=(p,w)=>JSON.stringify([typeof p=="string"?p.trim():p,w]),C=p=>{let w=typeof p.amount=="string"?p.amount.trim().match(/^(\d+)(?:\.(\d{1,6}))?$/):null,b=p.cardholder_verification,I=p.supplier_transaction_id!==void 0||p.client_transaction_id!==void 0,F=p.supplier_transaction_id!==void 0||p.decision_mode==="synchronous",te=K=>typeof K=="string"?K.trim():null;return JSON.stringify({card:p.external_card_id,currency:p.currency,amount:w?(BigInt(w[1])*1000000n+BigInt((w[2]??"").padEnd(6,"0"))).toString():p.amount,...I?{supplier:te(p.supplier_transaction_id),client:te(p.client_transaction_id)}:{},...F?{merchant:p.merchant_name??null,mcc:p.merchant_mcc??null,method:b?.method,verifiedAt:b?.verified_at,evidence:b?.evidence_id}:{},...p.decision_mode==="synchronous"?{mode:"synchronous",timeout:p.decision_timeout_ms??2e3,deadline:p.deadline_at??null}:{}})},E=(p,w)=>{let b=I=>typeof I=="string"?I.trim():null;return JSON.stringify({externalAuthId:p,factType:w.fact_type,currency:w.currency,amount:w.amount,predecessor:w.predecessor_version,supplier:b(w.supplier_transaction_id),parent:b(w.parent_supplier_transaction_id),client:b(w.client_transaction_id)})};function D(p){for(let[w,b]of l)b<=p&&l.delete(w);for(let[w,b]of d)b.expiresAt<=p&&d.delete(w);for(let[w,b]of m)if(b.expiresAt<=p){m.delete(w),y.delete(b.lineageVersion),u.delete(b.chargeId),b.supplierIdentity&&i.delete(b.supplierIdentity);for(let I of b.keys)c.delete(I)}}let o=(0,qt.createServer)(async(p,w)=>{let b=(x,v,z={})=>{w.writeHead(x,{"content-type":"application/json",...z}),w.end(JSON.stringify(v))},I=(x,v,z)=>b(x,{error:v,message:"Synthetic simulator response",request_id:"synthetic-request"},z),F=[],te=0;for await(let x of p){let v=Buffer.from(x);if(te+=v.length,te>1024*1024){I(413,"invalid_request");return}F.push(v)}let K=Buffer.concat(F),W=a();D(W);let ne=new URL(p.url??"/","http://127.0.0.1"),Z=ne.pathname,pe=p.headers["x-api-timestamp"],_e=p.headers["x-api-nonce"],Ae=p.headers["x-api-signature"],re=p.method==="POST"||p.method==="PUT"||p.method==="GET"?p.method:null;if(!re||p.headers["x-api-key"]!==J.apiKeyId||typeof pe!="string"||!/^\d{10}$/.test(pe)||Math.abs(Math.floor(W/1e3)-Number(pe))>300||typeof _e!="string"||!_e||l.has(_e)||typeof Ae!="string"||!/^[0-9a-f]{64}$/.test(Ae)){I(401,"authentication_failed");return}let xt=new Headers;for(let[x,v]of Object.entries(p.headers))typeof v=="string"&&xt.set(x,v);if(!Pt({secret:J.apiKeySecret,apiKeyId:J.apiKeyId,method:re,target:p.url??"",body:K,headers:xt})){I(401,"authentication_failed");return}if(l.size>=r){I(503,"internal_error");return}if(l.set(_e,(Number(pe)+301)*1e3),re==="GET"&&Z==="/api/card/deliveries/dead-letters"){if(K.length>0){I(400,"invalid_request");return}let x=ne.searchParams.get("limit");for(let[v]of ne.searchParams)if(v!=="limit"){I(400,"invalid_request");return}if(ne.searchParams.getAll("limit").length>1){I(400,"invalid_request");return}if(x!==null&&(!/^\d+$/.test(x)||Number(x)<1||Number(x)>100)){I(400,"invalid_request");return}b(200,{items:[]});return}let it=x=>typeof x=="string"&&[...x].length>=32&&[...x].length<=8192&&/^[\x21-\x7e]+$/.test(x),It=Z.match(/^\/api\/card\/connect\/intents\/([^/]+)\/cards$/);if(It){let x=decodeURIComponent(It[1]);if(!Nt.test(x)){I(400,"invalid_request");return}if(re==="GET"){let v=p.headers["x-facto-intent-token"];if(K.length>0||!it(v)){I(400,"invalid_request");return}b(200,{id:x,revision:`sha256:${"0".repeat(64)}`,cards:[]});return}if(re==="PUT"){let v=p.headers["idempotency-key"];if(typeof v!="string"||v.length<16){I(400,"invalid_request");return}let z;try{z=JSON.parse(K.toString("utf8"))}catch{I(400,"invalid_request");return}if(!it(z.intent_token)||typeof z.approval_id!="string"||z.approval_id.length===0||typeof z.approval_sha256!="string"||!/^[a-f0-9]{64}$/.test(z.approval_sha256)||typeof z.revision!="string"||!/^sha256:[a-fA-F0-9]{64}$/.test(z.revision)){I(400,"invalid_request");return}let Y=Array.isArray(z.cards)?z.cards:[];b(200,{id:x,status:"applied",revision:`sha256:${"f".repeat(64)}`,added_binding_ids:Y.map((P,M)=>`cb_SYNTHETIC0000000${M+1}`),removed_binding_ids:[],kept_binding_ids:[]});return}I(404,"not_found");return}let At=Z.match(/^\/api\/card\/connect\/intents\/([^/]+)\/cancel$/);if(re==="POST"&&At){let x=decodeURIComponent(At[1]);if(!Nt.test(x)){I(400,"invalid_request");return}let v;try{v=JSON.parse(K.toString("utf8"))}catch{I(400,"invalid_request");return}if(!v||typeof v!="object"||Array.isArray(v)||!it(v.intent_token)){I(400,"invalid_request");return}b(200,{id:x,status:"cancelled"});return}let St=Z.match(/^\/api\/card\/deliveries\/dead-letters\/([^/]+)\/replay$/);if(re==="POST"&&St){let x=decodeURIComponent(St[1]);if(!Tn.test(x)){I(404,"not_found");return}b(202,{id:x,status:"accepted"});return}if(re!=="POST"){I(404,"not_found");return}let f;try{if(f=JSON.parse(K.length?K.toString("utf8"):"{}"),!f||typeof f!="object"||Array.isArray(f))throw new Error}catch{I(400,"invalid_request");return}typeof f.supplier_transaction_id=="string"&&(f.supplier_transaction_id=f.supplier_transaction_id.trim());let wt=Z.match(/^\/api\/card\/authorizations\/([^/]+)\/facts$/);if(wt){let x=decodeURIComponent(wt[1]);if(f.program_id!==J.programId){I(403,"program_grant_denied");return}let v=p.headers["idempotency-key"];if(typeof v!="string"||v.length<16){I(400,"invalid_request");return}if(!["authorization_updated","clearing","reversal","refund","chargeback","settlement"].includes(String(f.fact_type))||typeof f.predecessor_version!="string"||!f.predecessor_version||f.predecessor_version===f.resource_version||typeof f.recorded_at!="string"||!Number.isFinite(Date.parse(f.recorded_at))){I(400,"invalid_request");return}let Y=K,P=c.get(v);if(P&&!P.raw.equals(Y)){I(409,"integrity_conflict");return}let M=_(x,f.resource_version),oe=E(x,f),R=m.get(M);if(R&&R.normalized!==oe){I(409,"integrity_conflict");return}if(!y.has(s(x,f.predecessor_version))){I(409,"integrity_conflict");return}let q=s(x,f.resource_version),ee=y.get(q);if(ee&&ee.identity!==M){I(409,"integrity_conflict");return}let Q=f.supplier_transaction_id?i.get(S(f.supplier_transaction_id,f.resource_version)):void 0;if(Q&&Q.identity!==M){I(409,"integrity_conflict");return}if(!P&&c.size>=r){I(503,"internal_error");return}let j=P?.operation??R;if(!j){let G=(0,he.randomUUID)(),pn=`0x${"0".repeat(32)}${G.replaceAll("-","")}`;j={externalAuthorizationId:x,factType:String(f.fact_type),body:{...f,external_authorization_id:x},identity:M,normalized:oe,lineageVersion:q,chargeId:pn,operationId:G,expiresAt:W+n,keys:new Set,statusReads:0,...f.supplier_transaction_id?{supplierIdentity:S(f.supplier_transaction_id,f.resource_version)}:{}},m.set(M,j),y.set(q,j),j.supplierIdentity&&i.set(j.supplierIdentity,j)}P||(c.set(v,{raw:Y,operation:j}),j.keys.add(v)),b(200,{operation_id:j.operationId,status:"recorded"});return}if(["/api/card/authorizations","/api/card/authorizations/lookup","/api/card/deliveries/reconciliations/list","/api/card/deliveries/replays"].includes(Z)&&f.program_id!==J.programId){I(403,"program_grant_denied");return}let De=K,X=new Date(W).toISOString(),ie=p.headers["idempotency-key"];switch(Z){case"/api/card/authorizations":{if(typeof ie!="string"||ie.length<16){I(400,"invalid_request");return}if(f.decision_mode==="synchronous"&&(f.decision_timeout_ms!==void 0&&(typeof f.decision_timeout_ms!="number"||!Number.isInteger(f.decision_timeout_ms)||f.decision_timeout_ms<50||f.decision_timeout_ms>5e3)||f.deadline_at!==void 0&&(typeof f.deadline_at!="string"||!Number.isFinite(Date.parse(f.deadline_at))))){I(400,"invalid_request");return}if(f.decision_mode!=="synchronous"&&(f.decision_timeout_ms!==void 0||f.deadline_at!==void 0)){I(400,"invalid_request");return}if(typeof f.external_authorization_id!="string"||!f.external_authorization_id||typeof f.external_card_id!="string"||!f.external_card_id){I(400,"invalid_request");return}let x=c.get(ie);if(x&&!x.raw.equals(De)){I(409,"integrity_conflict");return}let v=_(f.external_authorization_id,f.resource_version),z=C(f),Y=m.get(v);if(Y&&Y.normalized!==z){I(409,"integrity_conflict");return}if(f.decision_mode!=="synchronous"&&f.external_card_id==="synthetic-rate-limited-card"){b(429,{error:{category:"rate_limited",code:"too_many_requests",message:"Synthetic rate limit",request_id:"synthetic-request",retryable:!0}},{"retry-after":"2"});return}if(f.decision_mode!=="synchronous"&&f.external_card_id==="synthetic-bad-gateway-card"){w.writeHead(502,{"content-type":"text/html","retry-after":"2"}),w.end("<html>Synthetic gateway error</html>");return}if(f.decision_mode!=="synchronous"&&f.external_card_id==="synthetic-nested-500-card"){b(500,{error:{category:"internal",code:"synthetic_unavailable",message:"Synthetic failure",request_id:"synthetic-request",retryable:!1}});return}if(f.decision_mode!=="synchronous"&&f.external_card_id==="synthetic-retry-card"&&!x){let q=d.get(ie);if(!q){if(d.size>=r){I(503,"internal_error");return}d.set(ie,{raw:De,expiresAt:W+n}),I(503,"internal_error");return}if(!q.raw.equals(De)){I(409,"integrity_conflict");return}d.delete(ie)}let P=s(f.external_authorization_id,f.resource_version),M=y.get(P);if(M&&M.identity!==v){I(409,"integrity_conflict");return}let oe=f.supplier_transaction_id?i.get(S(f.supplier_transaction_id,f.resource_version)):void 0;if(oe&&oe.identity!==v){I(409,"integrity_conflict");return}if(!x&&c.size>=r){I(503,"internal_error");return}let R=x?.operation??Y;if(!R){let q=f.decision_mode==="synchronous"?Math.min(W+(typeof f.decision_timeout_ms=="number"?f.decision_timeout_ms:2e3),typeof f.deadline_at=="string"?Date.parse(f.deadline_at):1/0):void 0,ee=(0,he.randomUUID)(),Q=`0x${"0".repeat(32)}${ee.replaceAll("-","")}`;R={externalAuthorizationId:f.external_authorization_id,factType:"authorization_requested",body:f,identity:v,normalized:z,lineageVersion:P,chargeId:Q,operationId:ee,deadline:q,expiresAt:W+n,keys:new Set,statusReads:0,...q!==void 0?{decision:q<=W?"self_reversed_timeout":"declined"}:{},...f.supplier_transaction_id?{supplierIdentity:S(f.supplier_transaction_id,f.resource_version)}:{}},m.set(v,R),y.set(P,R),R.supplierIdentity&&i.set(R.supplierIdentity,R),f.decision_mode!=="synchronous"&&u.set(Q,R)}if(x||(c.set(ie,{raw:De,operation:R}),R.keys.add(ie)),f.decision_mode==="synchronous"){let q=R.deadline!==void 0&&R.deadline<=W;b(q?408:422,{...q?{}:{decision:"declined",decided_at:X},error:q?"decision_deadline_exceeded":"sync_approval_admission_closed",message:"Synthetic simulator decision",request_id:"synthetic-request",decision_id:R.operationId,deadline_at:new Date(R.deadline).toISOString()});return}if(f.external_card_id==="synthetic-declined-card"){I(402,"spending_limit_exceeded");return}b(200,{charge_id:R.chargeId,status:"processing"});return}case"/api/card/authorizations/lookup":{let x=f.criteria,v=x?.by==="idempotency_key"&&x.original_credential_key_id===J.apiKeyId&&typeof x.idempotency_key=="string"?c.get(x.idempotency_key)?.operation:x?.by==="charge_id"&&typeof x.charge_id=="string"?u.get(x.charge_id):x?.by==="external_authorization_id"?m.get(_(x.external_authorization_id,x.resource_version)):x?.by==="supplier_transaction_id"?i.get(S(x.supplier_transaction_id,x.resource_version)):void 0;if(!v||(x?.by==="external_authorization_id"||x?.by==="supplier_transaction_id")&&(x.mapping_revision!==v.body.mapping_revision||x.fact_type!==void 0&&x.fact_type!==v.factType)){b(200,{observed_at:X,resolution:"not_observed"});return}let z=v.body,Y=v.statusReads++;if(["synthetic-terminal-card","synthetic-failed-card"].includes(String(z.external_card_id))&&v.factType==="authorization_requested"&&Y>0){let R=v.finalizedAt??X;v.finalizedAt=R;let q=["facto_admission","durable_commit","provider_authorization","chain_finality","provider_settlement"].map(G=>G.startsWith("provider_")?{kind:G,state:"unobserved",source_system:"provider",recorded_at:R}:{kind:G,state:"confirmed",source_system:G==="chain_finality"?"chain":"facto",recorded_at:R,observed_at:R}),ee={resource_version:z.resource_version,mapping_revision:z.mapping_revision,external_authorization_id:v.externalAuthorizationId,charge_id:v.chargeId},Q=z.external_card_id==="synthetic-failed-card",j={receipt_event_id:v.operationId,charge_id:v.chargeId,authorization_ref:v.externalAuthorizationId,mapping_revision:z.mapping_revision,operation_type:v.factType,resource_version:z.resource_version,execution_outcome:Q?"failed":"succeeded",terminal_action:Q?"cancelReservation":"releaseFor",finalized_at:R,facts_at_finality:q};b(200,{observed_at:X,resolution:"resolved",authorization:{...ee,operation_type:v.factType,origin_connection_id:J.connectionId,processing_status:Q?"failed":"succeeded",facts:q,revision:2,final_receipt:j,...z.supplier_transaction_id?{supplier_transaction_id:z.supplier_transaction_id}:{}}});return}let P=v.factType==="authorization_requested",M=v.decision||z.external_card_id==="synthetic-declined-card",oe=["facto_admission","durable_commit","provider_authorization","chain_finality","provider_settlement"].map(R=>{let q=R==="durable_commit"||R==="facto_admission"&&P&&!M;return{kind:R,state:q?"confirmed":"unobserved",source_system:R.startsWith("provider_")?"provider":R==="chain_finality"?"chain":"facto",recorded_at:X,...q?{observed_at:X}:{}}});b(200,{observed_at:X,resolution:M?"resolved":P?"pending":"unknown",authorization:{origin_connection_id:J.connectionId,processing_status:M?"failed":P?"processing":"indeterminate",facts:oe,revision:1,operation_type:v.factType,resource_version:z.resource_version,mapping_revision:z.mapping_revision,external_authorization_id:v.externalAuthorizationId,...P&&!v.decision?{charge_id:v.chargeId}:{},...v.decision?{decision:v.decision,decline_reason_code:v.decision==="declined"?"sync_approval_admission_closed":"decision_deadline_exceeded"}:z.external_card_id==="synthetic-declined-card"?{decline_reason_code:"spending_limit_exceeded"}:{},...z.supplier_transaction_id?{supplier_transaction_id:z.supplier_transaction_id}:{}}});return}case"/api/card/deliveries/reconciliations/list":{let x=ge.find(P=>lt(P).selectionId===f.selection_id);if(x&&f.target_revision===ue){let P=Fe(x),M=new Map;for(let j of P.deliveries){let G=JSON.parse(new TextDecoder().decode(j.rawBody));M.set(G.event_id,{event_id:G.event_id,origin_connection_id:P.config.connectionId,connection_sequence:G.connection_sequence,event_sha256:(0,he.createHash)("sha256").update(j.rawBody).digest("hex"),target_revision:P.config.targetRevision,delivery_state:"accepted"})}let oe=[...M.values()].sort((j,G)=>(j.connection_sequence??0)-(G.connection_sequence??0)),R=typeof f.cursor=="string"?Number(f.cursor.slice(17)):0,q=typeof f.page_size=="number"?f.page_size:100,ee=oe.slice(R,R+q),Q=R+ee.length>=oe.length;b(200,{snapshot_token:"synthetic-snapshot-token",snapshot_at:X,to_at:typeof f.to_at=="string"?f.to_at:X,items:ee,next_cursor:Q?null:`synthetic-cursor-${R+ee.length}`,complete:Q});return}let v=ce.duplicate.deliveries[0],z=v.headers.find(([P])=>P==="facto-event-id")?.[1],Y=f.selection_id===be&&f.target_revision===ue?[{event_id:z,origin_connection_id:v.expectedScope.connectionId,connection_sequence:1,event_sha256:(0,he.createHash)("sha256").update(v.rawBody).digest("hex"),target_revision:v.expectedScope.targetRevision,delivery_state:"accepted"}]:[];b(200,{snapshot_token:"synthetic-snapshot-token",snapshot_at:X,to_at:typeof f.to_at=="string"?f.to_at:X,items:Y,next_cursor:null,complete:!0});return}case"/api/card/deliveries/replays":if(typeof ie!="string"||ie.length<16){I(400,"invalid_request");return}b(202,{replay_id:(0,he.randomUUID)(),selection_id:f.selection_id,target_revision:ue,status:"accepted"});return;case"/api/card/bindings/lookup":b(200,{binding:null});return;case"/api/card/events":b(200,{delivery_id:f.delivery_id,disposition:"applied",effect:"none"});return;default:I(404,"not_found")}});await new Promise((p,w)=>{o.once("error",w),o.listen(e,"127.0.0.1",()=>{o.off("error",w),p()})});let h=o.address();if(!h||typeof h=="string")throw new Error("Simulator listener unavailable");return{server:o,url:`http://127.0.0.1:${h.port}`}}var mt=require("node:crypto");var Zt=require("node:crypto");var Je=require("node:crypto");function Re(e){let t=e.headers.get("retry-after");if(!(t===null||!/^[0-9]+$/.test(t)))return Number(t)}var En=1048576,_t=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,je=/^pconn_[A-Za-z0-9_-]{16,}$/,yt=/^[a-f0-9]{64}$/,Ve=/^sha256:[a-f0-9]{64}$/,$t=["environment","apiBaseUrl","timeoutMs","retry","maxResponseBytes","fetch"];function $(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function A(e,t=1,r=255){return typeof e=="string"&&[...e].length>=t&&[...e].length<=r}function ve(e,t=1,r=255){return A(e,t,r)&&/^[\x21-\x7e]+$/.test(e)}function H(e){return typeof e=="string"&&_t.test(e)&&e!=="00000000-0000-0000-0000-000000000000"}function Ft(e){return typeof e=="number"&&Number.isInteger(e)&&e>=1&&e<=2147483647}function O(e){return typeof e=="string"&&/^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d(?:\.\d+)?(?:Z|[+-]\d\d:\d\d)$/.test(e)&&Number.isFinite(Date.parse(e))}function T(e,t,r=[]){return $(e)&&t.every(n=>Object.hasOwn(e,n))&&Object.keys(e).every(n=>t.includes(n)||r.includes(n))}function k(e,t,r=[]){return $(e)&&t.every(n=>Object.hasOwn(e,n))}function g(e,t){if(!e)throw new U("FACTO_CONFIG_INVALID",t,{retryable:!1})}function Ke(e){return e===429||e>=500}function Me(e){let t=e?.headers.get("x-request-id")?.trim();return t&&t.length>0?t:void 0}function V(e,t){return new U("FACTO_ENGINE_RESPONSE_INVALID","Card API response does not match the producer contract",{retryable:Ke(e),status:e,retryAfterSeconds:t?Re(t):void 0,requestId:Me(t)})}function Ut(e,t){return new U("FACTO_ENGINE_RESPONSE_INVALID",`Card API response body exceeds maxResponseBytes (${t} bytes)`,{retryable:Ke(e.status),status:e.status,details:{reason:"response_body_too_large",maxResponseBytes:t},retryAfterSeconds:Re(e),requestId:Me(e)})}async function On(e,t,r){let n=e.headers.get("content-length")?.trim();if(n!==void 0&&/^\d+$/.test(n)&&Number(n)>t)throw await e.body?.cancel().catch(()=>{}),Ut(e,t);if(!e.body)return"";let a=e.body.getReader(),c=[],m=0;try{for(;;){let{done:u,value:d}=await a.read();if(u)break;if(m+=d.byteLength,m>t||r.aborted)throw await a.cancel().catch(()=>{}),r.aborted?new U("FACTO_REQUEST_ABORTED","Card API request aborted or timed out",{retryable:!1}):Ut(e,t);c.push(d)}}finally{a.releaseLock()}let y=new Uint8Array(m),i=0;for(let u of c)y.set(u,i),i+=u.byteLength;return new TextDecoder().decode(y)}var Dn=512;function Pn(e){return k(e,["error","message","request_id"])&&A(e.error,1,128)&&/^[a-z][a-z0-9_]*$/.test(e.error)&&A(e.message,1,Dn)&&A(e.request_id,1,128)}function He(e){if(!k(e,["error"])||!k(e.error,["category","code","message","request_id","retryable"],["details"]))return!1;let t=e.error;return!(typeof t.category!="string"||typeof t.code!="string"||typeof t.message!="string"||typeof t.request_id!="string"||typeof t.retryable!="boolean")}function Nn(e){e!==void 0&&(g($(e),"retry options must be an object"),e.maxRetries!==void 0&&g(typeof e.maxRetries=="number"&&Number.isSafeInteger(e.maxRetries)&&e.maxRetries>=0,"retry.maxRetries must be a non-negative integer"),e.baseDelayMs!==void 0&&g(typeof e.baseDelayMs=="number"&&Number.isFinite(e.baseDelayMs)&&e.baseDelayMs>=0,"retry.baseDelayMs must be non-negative"),e.maxDelayMs!==void 0&&g(typeof e.maxDelayMs=="number"&&Number.isFinite(e.maxDelayMs)&&e.maxDelayMs>=0,"retry.maxDelayMs must be non-negative"),e.maxRetryAfterMs!==void 0&&g(typeof e.maxRetryAfterMs=="number"&&Number.isFinite(e.maxRetryAfterMs)&&e.maxRetryAfterMs>=0&&e.maxRetryAfterMs<=2147483647,"retry.maxRetryAfterMs is out of range"))}function Bt(e,t){g(typeof window>"u","Card API credentials require a server runtime"),g(e.environment==="dev"||e.environment==="production","An explicit dev or production environment is required"),Nn(e.retry);let r={dev:"https://dev-api.facto.to",production:"https://api.facto.to"},n;g(e.environment!=="production"||typeof e.apiBaseUrl=="string","Production requires an explicit apiBaseUrl");try{n=new URL(e.apiBaseUrl??r.dev)}catch{throw new U("FACTO_CONFIG_INVALID","apiBaseUrl must be an absolute HTTP(S) origin",{retryable:!1})}g(!n.username&&!n.password&&!n.search&&!n.hash&&n.pathname==="/"&&(n.protocol==="https:"||n.protocol==="http:"&&["localhost","127.0.0.1","[::1]"].includes(n.hostname)),"apiBaseUrl must be an HTTPS origin or an explicit loopback HTTP origin");let a=`${n.protocol}//${n.hostname.replace(/\.+$/,"")}${n.port?`:${n.port}`:""}`;g(!Object.values(r).includes(a)||a===r[e.environment],"The published endpoint must match the client environment");let c=n.origin,m=e.timeoutMs??3e4;g(Number.isSafeInteger(m)&&m>0,"timeoutMs must be a positive integer");let y=e.maxResponseBytes??En;g(Number.isSafeInteger(y)&&y>0,"maxResponseBytes must be a positive integer");let i=e.fetch??globalThis.fetch?.bind(globalThis);return g(typeof i=="function","A server fetch implementation is required"),async function(d,l,_,s,S,C,E={}){let D=new AbortController,o=()=>D.abort();E.signal?.addEventListener("abort",o,{once:!0}),E.signal?.aborted&&o();let h=setTimeout(o,m),p,w=new Promise((b,I)=>{p=()=>I(new U("FACTO_REQUEST_ABORTED","Card API request aborted or timed out",{retryable:!1})),D.signal.addEventListener("abort",p,{once:!0}),D.signal.aborted&&p()});try{if(D.signal.aborted)return await w;_.set("accept","application/json"),s!==void 0&&_.set("content-type","application/json");let b=await Promise.race([i(`${c}${l}`,{method:d,headers:_,redirect:"error",signal:D.signal,...s!==void 0?{body:s}:{}}),w]),I=await Promise.race([On(b,y,D.signal),w]),F;try{F=JSON.parse(I)}catch{throw V(b.status,b)}if(S.includes(b.status)&&C(F,b.status))return F;if(!b.ok){if(Pn(F))throw new U("FACTO_ENGINE_REQUEST_FAILED",`Card API ${t} request failed with status ${b.status}`,{retryable:Ke(b.status),status:b.status,details:F,retryAfterSeconds:Re(b),requestId:F.request_id||Me(b)});if(He(F))throw new U("FACTO_ENGINE_REQUEST_FAILED",`Card API ${t} request failed with status ${b.status}`,{retryable:Ke(b.status),status:b.status,details:F,retryAfterSeconds:Re(b),requestId:F.error.request_id||Me(b)})}throw V(b.status,b)}catch(b){throw b instanceof U?b:new U("FACTO_ENGINE_REQUEST_FAILED","Card API transport failed; inspect the original operation before any new action",{retryable:!1})}finally{clearTimeout(h),E.signal?.removeEventListener("abort",o),p&&D.signal.removeEventListener("abort",p)}}}var qn="facto-card-binding+jwt",Ln=/^pc_[A-Za-z0-9_-]{16,}$/,Un=/^cbs_[A-Za-z0-9_-]{16,}$/,$n=/^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/,Fn=/^[A-Za-z0-9_-]+$/,Bn=/^[0-9]{4}$/,Kt=300,Mt=600,Kn=["card.metadata.view","card.use_for_facto_payments"],Mn=["passkey","mfa","reauthenticated_session"],jn=["provider_authenticated_app","device_bound_confirmation"],Vn={dev:"urn:facto:sandbox:card-program-connect:binding-proof",production:"urn:facto:production:card-program-connect:binding-proof"};function jt(e){return Buffer.from(JSON.stringify(e),"utf8").toString("base64url")}function ze(e){return typeof e=="number"&&Number.isSafeInteger(e)&&e>=1e9&&e<=9999999999}function Vt(e){return typeof e=="string"&&Fn.test(e)&&Buffer.from(e,"base64url").byteLength===32}function Hn(e){return/^[0-9]{12,19}$/.test(e)||/[0-9]{13}/.test(e)}function Jn(e,t){return g($(e),"Binding assertion proof claim is required"),e.mode==="provider_reauthentication"?(g(T(e,["mode","authenticatedAtSeconds","assurance"])&&ze(e.authenticatedAtSeconds)&&e.authenticatedAtSeconds<=t&&t-e.authenticatedAtSeconds<=Mt&&Mn.includes(e.assurance),"Reauthentication proof requires valid authenticatedAtSeconds (within 600 seconds before issuedAtSeconds) and assurance"),{mode:"provider_reauthentication",authenticated_at:e.authenticatedAtSeconds,assurance:e.assurance}):(g(e.mode==="provider_second_channel"&&T(e,["mode","approvedAtSeconds","approvalRef","channelType"])&&ze(e.approvedAtSeconds)&&e.approvedAtSeconds<=t&&t-e.approvedAtSeconds<=Mt&&A(e.approvalRef,16,255)&&jn.includes(e.channelType),"Second-channel proof requires valid approvedAtSeconds (within 600 seconds before issuedAtSeconds), approvalRef (16-255 chars), and channelType"),{mode:"provider_second_channel",approved_at:e.approvedAtSeconds,approval_ref:e.approvalRef,channel_type:e.channelType})}function Gn(e){g(Array.isArray(e)&&e.length>=1&&e.length<=20,"Binding assertion requires 1 to 20 asserted cards");let t=new Set,r=0;return e.map(n=>{g(T(n,["externalCardId"],["isEntryCard","display"])&&A(n.externalCardId,8,512)&&!Hn(n.externalCardId)&&(n.isEntryCard===void 0||typeof n.isEntryCard=="boolean"),"Each asserted card requires an opaque externalCardId (8-512 non-PAN chars) and optional boolean isEntryCard"),g(!t.has(n.externalCardId),"Asserted cards must have unique externalCardId values"),t.add(n.externalCardId),n.isEntryCard===!0&&(r+=1,g(r<=1,"At most one asserted card may set isEntryCard to true"));let a;if(n.display!==void 0){g(T(n.display,[],["network","cardType","last4"]),"Asserted card display accepts only network, cardType, and last4");let c=n.display;g((c.network===void 0||A(c.network,1,32))&&(c.cardType===void 0||A(c.cardType,1,32))&&(c.last4===void 0||typeof c.last4=="string"&&Bn.test(c.last4)),"Asserted card display fields are out of contract bounds");let m={};c.network!==void 0&&(m.network=c.network),c.cardType!==void 0&&(m.card_type=c.cardType),c.last4!==void 0&&(m.last4=c.last4),Object.keys(m).length>0&&(a=m)}return{card_ref:n.externalCardId,relationship_type:"owner",...n.isEntryCard===!0?{is_entry_card:!0}:{},...a!==void 0?{display:a}:{}}})}async function Wn(e,t,r){if(typeof e=="function"){let n=await e(t);return g(n instanceof Uint8Array&&n.byteLength===64,"Binding assertion signer must return a 64-byte Ed25519 signature"),n}g(T(e,["kty","crv","x","d"],["kid","alg","use","key_ops","ext"])&&e.kty==="OKP"&&e.crv==="Ed25519"&&(e.alg===void 0||e.alg==="EdDSA"||e.alg==="Ed25519")&&(e.use===void 0||e.use==="sig")&&(e.key_ops===void 0||Array.isArray(e.key_ops)&&e.key_ops.every(n=>typeof n=="string")&&e.key_ops.includes("sign"))&&(e.ext===void 0||typeof e.ext=="boolean")&&(e.kid===void 0||e.kid===r)&&Vt(e.x)&&Vt(e.d),"Binding assertion signer must be a valid Ed25519 private JWK (matching signingKeyId when kid is present) or async signing callback");try{let n=(0,Je.createPrivateKey)({key:{kty:"OKP",crv:"Ed25519",x:e.x,d:e.d},format:"jwk"});return new Uint8Array((0,Je.sign)(null,t,n))}catch{throw new U("FACTO_CONFIG_INVALID","Invalid Ed25519 private JWK for binding assertion signing",{retryable:!1})}}async function Ht(e){g(T(e,["environment","providerConnectionId","programId","bindingSessionId","issuer","subject","jti","factoChallenge","sessionRequestDigest","requestedUserConsents","proof","cards","signingKeyId","signer"],["issuedAtSeconds","notBeforeSeconds","expiresAtSeconds"]),"Binding assertion input contains missing or unknown fields"),g(e.environment==="dev"||e.environment==="production","environment must be dev or production"),g(typeof e.providerConnectionId=="string"&&Ln.test(e.providerConnectionId),"providerConnectionId must be a pc_ provider connection identifier (not a pconn_ program connection identifier)"),g(A(e.programId,1,255),"programId must be 1 to 255 characters"),g(typeof e.bindingSessionId=="string"&&Un.test(e.bindingSessionId),"bindingSessionId must be a cbs_ identifier"),g(A(e.issuer,1,512),"issuer is required"),g(A(e.subject,16,512),"subject must be a pairwise opaque identifier of 16 to 512 characters"),g(A(e.jti,16,255),"jti must be 16 to 255 characters"),g(A(e.factoChallenge,1,512),"factoChallenge is required"),g(typeof e.sessionRequestDigest=="string"&&Ve.test(e.sessionRequestDigest),"sessionRequestDigest must be a sha256:<hex> digest"),g(A(e.signingKeyId,1,255)&&e.signingKeyId.trim()===e.signingKeyId&&!e.signingKeyId.includes("\0"),"signingKeyId must be a non-empty trimmed identifier without NUL bytes");let t=e.requestedUserConsents;g(Array.isArray(t)&&t.length>0&&new Set(t).size===t.length&&t.every(_=>Kn.includes(_)),"requestedUserConsents must be a non-empty unique set of supported consent purposes");let r=e.issuedAtSeconds??Math.floor(Date.now()/1e3),n=e.notBeforeSeconds??r,a=e.expiresAtSeconds??r+Kt;g(ze(r)&&ze(n)&&ze(a)&&n<=r&&r<=a&&a-r<=Kt,"Binding assertion timestamps must satisfy nbf <= iat <= exp with lifetime <= 300 seconds");let c=Jn(e.proof,r),m=Gn(e.cards),y=jt({typ:qn,alg:"EdDSA",kid:e.signingKeyId}),i=jt({iss:e.issuer,aud:Vn[e.environment],sub:e.subject,iat:r,nbf:n,exp:a,jti:e.jti,binding_session_id:e.bindingSessionId,facto_challenge:e.factoChallenge,session_request_digest:e.sessionRequestDigest,connection_id:e.providerConnectionId,environment:e.environment,program_ref:e.programId,proof:c,cards:m,requested_user_consents:[...t]}),u=new TextEncoder().encode(`${y}.${i}`),d=await Wn(e.signer,u,e.signingKeyId),l=`${y}.${i}.${Buffer.from(d).toString("base64url")}`;return g(l.length>=128&&l.length<=16384&&$n.test(l),"Signed binding assertion exceeds compact JWS bounds"),l}var Ee=/^cbs_[A-Za-z0-9_-]{16,}$/,Qe=/^cint_[A-Za-z0-9_-]{16,}$/,Xe=/^cb_[A-Za-z0-9_-]{16,}$/,gt=/^sha256:[a-fA-F0-9]{64}$/,Yt=["authorization_updated","clearing","reversal","refund","chargeback","settlement"],Ye=["authorization_requested",...Yt],Zn=["facto_admission","durable_commit","provider_authorization","chain_finality","provider_settlement"],Yn=["active","frozen","closed","replaced"],Qn=/^[A-Za-z0-9_.:-]{1,64}$/,Xn=/^[0-9]+\.[0-9]{2,6}$/,er=/^-?[0-9]+\.[0-9]{2,6}$/;function N(e,t){return typeof e=="string"&&t.test(e)}function Qt(e){return e===null||typeof e=="string"}function We(e,t=-2147483648){return typeof e=="number"&&Number.isInteger(e)&&e>=t&&e<=2147483647}function Te(e,t=128){return A(e,1,t)&&!/[0-9]{13}/.test(e)}function ke(e,t){return e==null||t(e)}function Ze(e){return Array.isArray(e)&&e.every(t=>N(t,Xe))}function Xt(e){return k(e,["network","type","last4"])&&Qt(e.network)&&(e.type===null||["virtual","physical","unknown"].includes(String(e.type)))&&(e.last4===null||typeof e.last4=="string"&&/^[0-9]{4}$/.test(e.last4))}function le(e){return typeof e=="string"&&/^0x0{32}[0-9a-fA-F]{32}$/.test(e)}function tr(e){return typeof e=="string"&&Qn.test(e)}function nr(e){return!k(e,["snapshot_token","snapshot_at","to_at","items","next_cursor","complete"])||!A(e.snapshot_token,16,4096)||!O(e.snapshot_at)||!O(e.to_at)||typeof e.complete!="boolean"||e.next_cursor!==null&&!A(e.next_cursor,1,4096)||e.complete&&e.next_cursor!==null||!Array.isArray(e.items)||e.items.length>100?!1:e.items.every(t=>k(t,["event_id","origin_connection_id","connection_sequence","event_sha256","target_revision","delivery_state"],["accepted_at"])&&H(t.event_id)&&typeof t.origin_connection_id=="string"&&je.test(t.origin_connection_id)&&(t.connection_sequence===null||typeof t.connection_sequence=="number"&&Number.isSafeInteger(t.connection_sequence)&&t.connection_sequence>=1)&&typeof t.event_sha256=="string"&&yt.test(t.event_sha256)&&H(t.target_revision)&&typeof t.delivery_state=="string"&&(t.accepted_at===void 0||O(t.accepted_at)))}function rr(e){return k(e,["replay_id","selection_id","target_revision","status"])&&H(e.replay_id)&&H(e.selection_id)&&H(e.target_revision)&&e.status==="accepted"}function ir(e){g(T(e,["target_revision","page_size"],["selection_id","from_at","to_at","snapshot_token","cursor"]),"Reconciliation requires only the generated query fields"),g(H(e.target_revision)&&typeof e.page_size=="number"&&Number.isInteger(e.page_size)&&e.page_size>=1&&e.page_size<=100,"Reconciliation target_revision and page_size are invalid"),g(H(e.selection_id)&&!Object.hasOwn(e,"from_at")&&!Object.hasOwn(e,"to_at")||!Object.hasOwn(e,"selection_id")&&O(e.from_at)&&O(e.to_at)&&Date.parse(e.from_at)<=Date.parse(e.to_at),"Select exactly one fixed selection or explicit time window"),g((e.snapshot_token===void 0||A(e.snapshot_token,16,4096))&&(e.cursor===void 0||A(e.cursor,16,4096)&&A(e.snapshot_token,16,4096)),"A cursor requires its original snapshot token")}function or(e){g($(e),"Authorization lookup requires criteria");let t=Object.hasOwn(e,"criteria")?(g(T(e,["criteria"])&&$(e.criteria),"Authorization lookup wrapper requires only criteria"),e.criteria):e;g($(t),"Authorization lookup requires criteria");let r=t.by==="external_authorization_id"?T(t,["by","external_authorization_id","resource_version","mapping_revision"],["fact_type"])&&A(t.external_authorization_id,1,256)&&A(t.resource_version,1,255)&&A(t.mapping_revision,1,255)&&(t.fact_type===void 0||Ye.includes(String(t.fact_type))):t.by==="supplier_transaction_id"?T(t,["by","supplier_transaction_id","resource_version","mapping_revision"],["fact_type"])&&typeof t.supplier_transaction_id=="string"&&A(t.supplier_transaction_id.trim(),1,256)&&A(t.resource_version,1,255)&&A(t.mapping_revision,1,255)&&(t.fact_type===void 0||Ye.includes(String(t.fact_type))):t.by==="idempotency_key"?T(t,["by","idempotency_key","original_credential_key_id"],["operation"])&&A(t.idempotency_key,16,255)&&A(t.original_credential_key_id,1,255)&&(t.operation===void 0||t.operation==="create_authorization"):t.by==="charge_id"&&T(t,["by","charge_id"])&&le(t.charge_id);return g(r,"Select exactly one complete external_authorization_id, supplier_transaction_id, idempotency_key, or public charge_id"),t}function ar(e){g(T(e,["external_card_id","external_authorization_id","amount","currency","resource_version","mapping_revision","cardholder_verification"],["supplier_transaction_id","client_transaction_id","merchant_name","merchant_mcc","merchant_country","occurred_at","decision_mode","decision_timeout_ms","deadline_at"]),"Authorization create requires the complete generated request");let n=e.cardholder_verification;g(Te(e.external_card_id,512)&&A(e.external_authorization_id,1,256)&&N(e.amount,Xn)&&(e.currency==="USD"||e.currency==="USDC")&&A(e.resource_version,1,255)&&A(e.mapping_revision,1,255)&&(e.merchant_name===void 0||A(e.merchant_name,0,256))&&(e.merchant_mcc===void 0||N(e.merchant_mcc,/^[0-9]{4}$/))&&(e.merchant_country===void 0||A(e.merchant_country,2,3))&&(e.occurred_at===void 0||O(e.occurred_at))&&[e.supplier_transaction_id,e.client_transaction_id].every(a=>a===void 0||typeof a=="string"&&A(a.trim(),1,256))&&(e.decision_mode===void 0||e.decision_mode==="asynchronous"||e.decision_mode==="synchronous")&&(e.decision_timeout_ms===void 0||e.decision_mode==="synchronous"&&typeof e.decision_timeout_ms=="number"&&Number.isInteger(e.decision_timeout_ms)&&e.decision_timeout_ms>=50&&e.decision_timeout_ms<=5e3)&&(e.deadline_at===void 0||e.decision_mode==="synchronous"&&O(e.deadline_at))&&T(n,["method","verified_at","evidence_id"])&&["pin","biometric","cdcvm","signature","no_cvm","provider_attested"].includes(String(n.method))&&O(n.verified_at)&&A(n.evidence_id,1,256),"Authorization fields, currency, mapping/version, or cardholder verification is invalid")}function sr(e,t){g(A(e,1,255)&&e!=="."&&e!==".."&&!e.includes("/"),"externalId must be a valid external authorization identifier"),g(T(t,["fact_type","amount","currency","resource_version","predecessor_version","mapping_revision","recorded_at"],["supplier_transaction_id","parent_supplier_transaction_id","client_transaction_id","merchant_name","merchant_mcc","merchant_country"]),"Authorization fact requires the complete generated request"),g(Yt.includes(String(t.fact_type))&&N(t.amount,er)&&(t.currency==="USD"||t.currency==="USDC")&&A(t.resource_version,1,255)&&typeof t.predecessor_version=="string"&&A(t.predecessor_version.trim(),1,255)&&t.predecessor_version!==t.resource_version&&A(t.mapping_revision,1,255)&&O(t.recorded_at)&&(t.merchant_name===void 0||A(t.merchant_name,1,255))&&(t.merchant_mcc===void 0||N(t.merchant_mcc,/^[0-9]{4}$/))&&(t.merchant_country===void 0||A(t.merchant_country,2,3))&&[t.supplier_transaction_id,t.parent_supplier_transaction_id,t.client_transaction_id].every(a=>a===void 0||typeof a=="string"&&A(a.trim(),1,255)),"Authorization fact type, predecessor version, amount, or timestamp is invalid")}function en(e){return Array.isArray(e)&&e.length===5&&e.every((t,r)=>k(t,["kind","state","recorded_at","source_system"],["observed_at","safe_code"])&&t.kind===Zn[r]&&["unobserved","pending","confirmed","rejected","indeterminate"].includes(String(t.state))&&O(t.recorded_at)&&["facto","provider","chain"].includes(String(t.source_system))&&(t.safe_code===void 0||A(t.safe_code,1,64))&&(t.observed_at===void 0||O(t.observed_at))&&(t.state!=="confirmed"||O(t.observed_at))&&(t.state!=="unobserved"||!Object.hasOwn(t,"observed_at")))}function dr(e){return!k(e,["receipt_event_id","charge_id","mapping_revision","operation_type","resource_version","execution_outcome","terminal_action","finalized_at","facts_at_finality"],["external_authorization_id","authorization_ref"])||!H(e.receipt_event_id)||!le(e.charge_id)||!(A(e.external_authorization_id,1,256)||A(e.authorization_ref,1,256))||!A(e.mapping_revision,1,255)||!Ye.includes(String(e.operation_type))||!A(e.resource_version,1,255)||!O(e.finalized_at)||!en(e.facts_at_finality)||e.facts_at_finality[3].state!=="confirmed"?!1:e.terminal_action==="releaseFor"?e.execution_outcome==="succeeded"&&e.facts_at_finality[0].state==="confirmed"&&e.facts_at_finality[1].state==="confirmed":e.terminal_action==="cancelReservation"&&e.execution_outcome==="failed"}function cr(e){if(e===void 0)return!0;if(!$(e)||!$(e.issuer)||!Array.isArray(e.issuer.entries)||!Array.isArray(e.refund_cases))return!1;let t=e.issuer,r=t.entries;return["state","cleared_amount","reversed_amount","refunded_amount"].every(n=>typeof t[n]=="string")&&r.every(n=>$(n)&&["operation_type","resource_version","amount","currency","recorded_at","link_status"].every(a=>typeof n[a]=="string")&&n.currency==="USDC"&&(n.unlinked_reason===void 0||typeof n.unlinked_reason=="string"))&&e.refund_cases.every(n=>$(n)&&["case_id","source_operation_type","source_resource_version","status","amount","excess_amount","updated_at"].every(a=>typeof n[a]=="string")&&(n.paid_amount===void 0||typeof n.paid_amount=="string")&&(n.not_payable_reason===void 0||typeof n.not_payable_reason=="string"))}function ur(e,t){if(e===void 0)return!0;if(!$(e)||typeof e.fee_total!="string"||!$(e.fee_breakdown))return!1;let r=e.fee_breakdown;if(!["base_fee","fast_pay_fee","pooled_surcharge"].every(a=>typeof r[a]=="string"))return!1;let n=e.user_payment;return n!==void 0&&(!$(n)||!Number.isSafeInteger(n.chain_id)||typeof n.tx_hash!="string"||!/^0x[0-9a-fA-F]{64}$/.test(n.tx_hash)||n.asset_symbol!==void 0&&typeof n.asset_symbol!="string")?!1:e.refund_payments===void 0||t&&Array.isArray(e.refund_payments)&&e.refund_payments.every(a=>$(a)&&Number.isSafeInteger(a.chain_id)&&typeof a.case_id=="string"&&typeof a.paid_amount=="string"&&typeof a.recorded_by=="string"&&typeof a.tx_hash=="string"&&/^0x[0-9a-fA-F]{64}$/.test(a.tx_hash))}function lr(e){if(!k(e,["external_authorization_id","processing_status","origin_connection_id","resource_version","mapping_revision"],["charge_id","final_receipt","decline_reason_code","supplier_transaction_id","facts","revision","operation_type","decision","lifecycle","payment_details"])||!A(e.external_authorization_id,1,256)||typeof e.origin_connection_id!="string"||!je.test(e.origin_connection_id)||!A(e.resource_version,1,255)||!A(e.mapping_revision,1,255)||e.charge_id!==void 0&&e.charge_id!==null&&!le(e.charge_id)||e.supplier_transaction_id!==void 0&&!A(e.supplier_transaction_id,1,256)||e.facts!==void 0&&!en(e.facts)||e.revision!==void 0&&!Ft(e.revision)||e.operation_type!==void 0&&!Ye.includes(String(e.operation_type))||e.decision!==void 0&&!["approved","declined","self_reversed_timeout"].includes(String(e.decision))||e.decline_reason_code!==void 0&&!tr(e.decline_reason_code)||!cr(e.lifecycle)||!ur(e.payment_details,e.lifecycle!==void 0))return!1;if(e.processing_status==="succeeded"||e.processing_status==="failed"){if(Object.hasOwn(e,"final_receipt")&&e.final_receipt!==void 0){if(!le(e.charge_id)||!dr(e.final_receipt)||Object.hasOwn(e,"decline_reason_code"))return!1;let t=e.final_receipt,r=t.external_authorization_id??t.authorization_ref;return t.execution_outcome===e.processing_status&&t.charge_id===e.charge_id&&r===e.external_authorization_id&&t.mapping_revision===e.mapping_revision&&t.resource_version===e.resource_version&&(e.operation_type===void 0||t.operation_type===e.operation_type)}return e.processing_status==="succeeded"?!Object.hasOwn(e,"decline_reason_code")&&(e.charge_id===void 0||le(e.charge_id)):le(e.charge_id)||(e.charge_id===void 0||e.charge_id===null)&&(e.decision==="declined"||e.decision==="self_reversed_timeout"||e.decline_reason_code!==void 0)}return!Object.hasOwn(e,"final_receipt")&&!Object.hasOwn(e,"decline_reason_code")&&(e.processing_status==="processing"||e.processing_status==="indeterminate"&&(e.charge_id===void 0||e.charge_id===null))}function pr(e){return!k(e,["observed_at","resolution"],["authorization"])||!O(e.observed_at)?!1:e.resolution==="not_observed"?!Object.hasOwn(e,"authorization")||e.authorization===void 0:lr(e.authorization)?e.resolution==="resolved"?["succeeded","failed"].includes(e.authorization.processing_status):e.resolution==="pending"?e.authorization.processing_status==="processing":e.resolution==="unknown"&&e.authorization.processing_status==="indeterminate":!1}function _r(e){return k(e,["charge_id","status"])&&le(e.charge_id)&&["processing","approved","declined"].includes(String(e.status))&&!Object.hasOwn(e,"final_receipt")}function yr(e){return k(e,["operation_id","status"])&&H(e.operation_id)&&e.status==="recorded"}function fr(e,t){return!k(e,["deadline_at","decision_id"])||!O(e.deadline_at)||!H(e.decision_id)?!1:t===200?e.decision==="approved"&&e.status==="approved"&&le(e.charge_id)&&O(e.decided_at):typeof e.error!="string"||typeof e.message!="string"||typeof e.request_id!="string"?!1:t===408&&e.error==="decision_deadline_exceeded"&&!Object.hasOwn(e,"decision")?!0:O(e.decided_at)&&(t===422&&e.decision==="declined"||t===408&&e.decision==="self_reversed_timeout")}function gr(e){if(!k(e,["binding_session_id","status","binding_url","expires_at","proof_policy"])||!N(e.binding_session_id,Ee)||e.status!=="pending"||typeof e.binding_url!="string"||!O(e.expires_at))return!1;let t=e.proof_policy;return k(t,["allowed_modes","challenge_after_facto_auth","challenge_delivery"],["card_selection_supported"])&&Array.isArray(t.allowed_modes)&&t.allowed_modes.length>0&&new Set(t.allowed_modes).size===t.allowed_modes.length&&t.allowed_modes.every(r=>r==="provider_reauthentication"||r==="provider_second_channel")&&t.challenge_after_facto_auth===!0&&(t.challenge_delivery==="browser_handoff"||t.challenge_delivery==="provider_backend")&&(t.card_selection_supported===void 0||t.card_selection_supported===!0)}function Jt(e){if(!$(e)||!N(e.binding_session_id,Ee)||!O(e.expires_at))return!1;let t=["binding_session_id","status","expires_at"];return["pending","proof_pending","consent_pending"].includes(String(e.status))?k(e,t)&&!["outcome","binding_ids","failure_reason","completed_at"].some(r=>Object.hasOwn(e,r)):e.status==="completed"?Object.hasOwn(e,"completed_at")&&!O(e.completed_at)?!1:e.outcome==="bound"?k(e,[...t,"outcome","binding_ids"],["completed_at"])&&!Object.hasOwn(e,"failure_reason")&&Ze(e.binding_ids):e.outcome==="declined"&&k(e,[...t,"outcome","failure_reason"],["completed_at"])&&!Object.hasOwn(e,"binding_ids")&&e.failure_reason==="declined_by_user":e.status==="cancelled"?k(e,t,["completed_at","failure_reason"])&&!["outcome","binding_ids"].some(r=>Object.hasOwn(e,r))&&(!Object.hasOwn(e,"completed_at")||O(e.completed_at))&&(!Object.hasOwn(e,"failure_reason")||["cancelled_by_user","cancelled_by_partner","proof_rejected","admission_closed","no_eligible_cards","integrity_conflict"].includes(String(e.failure_reason))):e.status==="expired"&&k(e,t,["failure_reason"])&&!["completed_at","outcome","binding_ids"].some(r=>Object.hasOwn(e,r))&&(!Object.hasOwn(e,"failure_reason")||e.failure_reason==="expired"||e.failure_reason==="proof_timeout")}function mr(e){return k(e,["binding_session_id","status","proof_received_at"])&&N(e.binding_session_id,Ee)&&e.status==="consent_pending"&&O(e.proof_received_at)}function hr(e){return k(e,["binding_session_id","facto_challenge","session_request_digest","expires_at"])&&N(e.binding_session_id,Ee)&&A(e.facto_challenge,1,512)&&N(e.session_request_digest,Ve)&&O(e.expires_at)}function br(e){g(T(e,["requested_user_consents","return_uri"]),"Binding session requires the generated consent and return URI fields");let t=e.requested_user_consents;g(Array.isArray(t)&&t.length>0&&new Set(t).size===t.length&&t.every(r=>r==="card.metadata.view"||r==="card.use_for_facto_payments"),"Binding session consents are invalid"),g(typeof e.return_uri=="string"&&Buffer.byteLength(e.return_uri,"utf8")<=2048&&e.return_uri.startsWith("https://")&&!/[#\r\n]/.test(e.return_uri)&&e.return_uri.slice(8).split(/[/?]/,1)[0].length>0&&!e.return_uri.slice(8).split(/[/?]/,1)[0].includes("@"),"An exact registered HTTPS return URI is required")}function Gt(e){g(T(e,["proof_format","binding_assertion"])&&e.proof_format==="compact-jws"&&typeof e.binding_assertion=="string"&&e.binding_assertion.length>=128&&e.binding_assertion.length<=16384&&/^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/.test(e.binding_assertion),"The original compact JWS provider proof is required")}function vr(e){return k(e,["id","revision","cards"])&&N(e.id,Qe)&&N(e.revision,gt)&&Array.isArray(e.cards)&&e.cards.every(t=>k(t,["binding_id","status","card"])&&N(t.binding_id,Xe)&&typeof t.status=="string"&&Xt(t.card))}function xr(e){return k(e,["id","status","revision","added_binding_ids","removed_binding_ids","kept_binding_ids"])&&N(e.id,Qe)&&["applied","no_change"].includes(String(e.status))&&N(e.revision,gt)&&Ze(e.added_binding_ids)&&Ze(e.removed_binding_ids)&&Ze(e.kept_binding_ids)}function Ir(e){return k(e,["id","status"])&&N(e.id,Qe)&&e.status==="cancelled"}function Ar(e){return e===void 0||k(e,["configured","state"],["reason"])&&typeof e.configured=="boolean"&&["ready","not_configured","unavailable"].includes(String(e.state))&&(e.reason===void 0||e.reason===null||typeof e.reason=="string")}function Sr(e){if(!k(e,["binding"],["found"])||e.found!==void 0&&typeof e.found!="boolean")return!1;let t=e.binding;return t===null?e.found!==!0:(e.found===void 0||e.found===!0)&&k(t,["id","status","revision","card"],["funding"])&&N(t.id,Xe)&&typeof t.status=="string"&&We(t.revision,1)&&Xt(t.card)&&Ar(t.funding)}function wr(e){return k(e,["items"])&&Array.isArray(e.items)&&e.items.every(t=>k(t,["id","event_kind","binding_id","binding_revision","connection_sequence","delivery_attempts","last_delivery_error","dead_lettered_at","replay_count"])&&N(t.id,_t)&&typeof t.event_kind=="string"&&N(t.binding_id,Xe)&&We(t.binding_revision,1)&&(t.connection_sequence===null||typeof t.connection_sequence=="number"&&Number.isSafeInteger(t.connection_sequence)&&t.connection_sequence>=1)&&We(t.delivery_attempts,1)&&Qt(t.last_delivery_error)&&(t.dead_lettered_at===null||O(t.dead_lettered_at))&&We(t.replay_count,0))}function Cr(e){return k(e,["id","status"])&&H(e.id)&&e.status==="accepted"}function Rr(e){return k(e,["delivery_id","disposition","effect"])&&H(e.delivery_id)&&(e.disposition==="duplicate"?e.effect===null:e.disposition==="applied"&&["revoked","status_updated","released","none"].includes(String(e.effect)))}function zr(e){g(T(e,["intent_token","approval_id","approval_sha256","revision","cards"],["external_account_id"])&&ve(e.intent_token,32,8192)&&A(e.approval_id,1,255)&&N(e.approval_sha256,yt)&&N(e.revision,gt)&&ke(e.external_account_id,t=>typeof t=="string"&&t.length>0&&Buffer.byteLength(t,"utf8")<=512),"Card replacement requires the original complete approved request"),g(Array.isArray(e.cards)&&e.cards.length<=50&&e.cards.every(t=>T(t,["external_card_id"],["network","type","last4"])&&Te(t.external_card_id,255)&&ke(t.network,r=>Te(r,40))&&ke(t.type,r=>r==="virtual"||r==="physical"||r==="unknown")&&ke(t.last4,r=>typeof r=="string"&&/^[0-9]{4}$/.test(r))),"Target cards must match the generated safe card projection")}function kr(e){g(T(e,["delivery_id","kind","assertion_jws"],["external_card_id","lifecycle_status","external_account_id"])&&H(e.delivery_id)&&typeof e.assertion_jws=="string"&&e.assertion_jws.trim().length>=32,"Inbound event requires a UUID delivery_id and signed assertion_jws");let t=r=>r==null;g(e.kind==="account.released"?A(e.external_account_id,1,512)&&t(e.external_card_id)&&t(e.lifecycle_status):Te(e.external_card_id)&&t(e.external_account_id)&&(e.kind==="card.unbound"?t(e.lifecycle_status):e.kind==="card.lifecycle_changed"&&Yn.includes(String(e.lifecycle_status))),"Inbound event fields must match the declared event kind")}function xe(e){return g(e&&ve(e.idempotencyKey,16,255),"An explicit original Idempotency-Key of 16 to 255 characters is required"),e.idempotencyKey}function Ge(e){return g(N(e,Ee),"id must be the original binding session identifier"),`/api/card/connect/sessions/${e}`}function ft(e){return g(N(e,Qe),"id must be the original connect intent identifier"),`/api/card/connect/intents/${e}`}function Wt(e){return g(e?.rawBody===void 0||typeof e?.rawBody=="string","rawBody must preserve the original authenticated request bytes"),e?.rawBody}function tn(e){g(T(e,["environment","connectionId","programId","apiKeyId","apiKeySecret"],[...$t,"nowSeconds","createNonce"]),"Card client options cannot contain human session or arbitrary authentication fields"),g(typeof e.connectionId=="string"&&je.test(e.connectionId),"connectionId must be a pconn_ connection identifier"),g(A(e.programId,1,128)&&ve(e.apiKeyId),"programId and apiKeyId are required");let t=Be(e.apiKeySecret),r=Bt(e,"program"),n=Object.freeze({connectionId:e.connectionId,environment:e.environment,programId:e.programId}),a=e.apiKeyId,c=e.nowSeconds??(()=>Math.floor(Date.now()/1e3)),m=e.createNonce??Zt.randomUUID;function y(i,u,d,l="POST"){let _=c(),s=m();return g(Number.isSafeInteger(_)&&_>=1e9&&_<=9999999999,"nowSeconds must return a ten-digit Unix timestamp in seconds"),g(ve(s,1,128),"createNonce must return a bounded canonical nonce"),Ce({secret:t,apiKeyId:a,method:l,target:i,timestamp:_,nonce:s,body:u,idempotencyKey:d})}return Object.freeze({scope:n,sessions:Object.freeze({async create(i,u){br(i),g(T(u,["idempotencyKey"],["cardSelection","signal"]),"Binding session create options accept only idempotencyKey, optional cardSelection, and optional signal");let d=xe(u);g(u.cardSelection===void 0||typeof u.cardSelection=="boolean","cardSelection must be a boolean when provided");let l={...i,program_ref:n.programId},_=JSON.stringify(l),s="/api/card/connect/sessions",S=y(s,_,d);return u.cardSelection===!0&&S.set("x-facto-card-selection","1"),r("POST",s,S,_,[201],gr,u)},async get(i,u){let d=Ge(i),l=await r("GET",d,y(d,"",void 0,"GET"),void 0,[200],Jt,u);if(l.binding_session_id!==i)throw V(200);return l},async submitProof(i,u,d){let l=`${Ge(i)}/provider-proof`,_=xe(d);g($(u),"Provider proof input is required");let s;if(Object.hasOwn(u,"proof_format")||Object.hasOwn(u,"binding_assertion"))Gt(u),s=u;else{g(!["environment","programId","bindingSessionId","connectionId"].some(h=>Object.hasOwn(u,h)),"Provider proof assertion inherits environment, programId, and bindingSessionId from client scope and session id, and requires explicit providerConnectionId (pc_...)");let E=u,D=E.issuedAtSeconds??c();s={proof_format:"compact-jws",binding_assertion:await Ht({...E,environment:n.environment,programId:n.programId,bindingSessionId:i,issuedAtSeconds:D})},Gt(s)}let S=JSON.stringify(s),C=await r("POST",l,y(l,S,_),S,[202],mr,d);if(C.binding_session_id!==i)throw V(202);return C},async getProofChallenge(i,u){let d=`${Ge(i)}/proof-challenge`,l=await r("GET",d,y(d,"",void 0,"GET"),void 0,[200],hr,u);if(l.binding_session_id!==i)throw V(200);return l},async cancel(i,u){let d=`${Ge(i)}/cancel`,l=xe(u),_=Wt(u)??"{}",s=await r("POST",d,y(d,_,l),_,[200],Jt,u);if(s.binding_session_id!==i)throw V(200);return s}}),intents:Object.freeze({async listCards(i,u){let d=`${ft(i)}/cards`;g(T(u,["intentToken"],["signal"])&&ve(u.intentToken,32,8192),"intentToken must be a valid HTTP header value of at least 32 characters");let l=y(d,"",void 0,"GET");l.set("x-facto-intent-token",u.intentToken);let _=await r("GET",d,l,void 0,[200],vr,u);if(_.id!==i)throw V(200);return _},async replaceCards(i,u,d){let l=`${ft(i)}/cards`;zr(u);let _=xe(d),s=JSON.stringify(u),S=await r("PUT",l,y(l,s,_,"PUT"),s,[200],xr,d);if(S.id!==i)throw V(200);return S},async cancel(i,u,d){let l=`${ft(i)}/cancel`;g(T(u,["intent_token"])&&ve(u.intent_token,32,8192),"Cancel requires the original intent_token body of at least 32 characters");let _=JSON.stringify(u),s=await r("POST",l,y(l,_),_,[200],Ir,d);if(s.id!==i)throw V(200);return s}}),bindings:Object.freeze({async lookup(i,u){g(T(i,["external_card_id"])&&Te(i.external_card_id),"Binding lookup requires only an opaque external_card_id in its body");let d=JSON.stringify(i),l="/api/card/bindings/lookup";return r("POST",l,y(l,d),d,[200],Sr,u)}}),authorizations:Object.freeze({create:(async(i,u)=>{ar(i);let d=xe(u),l={...i,program_id:n.programId},_=JSON.stringify(l),s="/api/card/authorizations";return i.decision_mode==="synchronous"?r("POST",s,y(s,_,d),_,[200,422,408],fr,u):r("POST",s,y(s,_,d),_,[200],_r,u)}),async recordFact(i,u,d){sr(i,u);let l=xe(d),_={...u,program_id:n.programId},s=JSON.stringify(_),S=`/api/card/authorizations/${encodeURIComponent(i)}/facts`;return r("POST",S,y(S,s,l),s,[200],yr,d)},async lookup(i,u){let d=or(i),l={program_id:n.programId,criteria:d},_=JSON.stringify(l),s="/api/card/authorizations/lookup",S=await r("POST",s,y(s,_),_,[200],pr,u),C=S.authorization;if(C&&(C.origin_connection_id!==n.connectionId||d.by==="charge_id"&&C.charge_id?.toLowerCase()!==d.charge_id.toLowerCase()||d.by==="external_authorization_id"&&(C.external_authorization_id!==d.external_authorization_id||C.resource_version!==d.resource_version||C.mapping_revision!==d.mapping_revision||d.fact_type!==void 0&&C.operation_type!==void 0&&C.operation_type!==d.fact_type)||d.by==="supplier_transaction_id"&&(C.supplier_transaction_id!==d.supplier_transaction_id.trim()||C.resource_version!==d.resource_version||C.mapping_revision!==d.mapping_revision||d.fact_type!==void 0&&C.operation_type!==void 0&&C.operation_type!==d.fact_type)))throw V(200);return S}}),events:Object.freeze({async record(i,u){kr(i);let d=JSON.stringify(i),l="/api/card/events",_=await r("POST",l,y(l,d),d,[200],Rr,u),s=i.kind==="card.unbound"?"revoked":i.kind==="card.lifecycle_changed"?"status_updated":"released";if(_.delivery_id!==i.delivery_id||_.disposition==="applied"&&_.effect!=="none"&&_.effect!==s)throw V(200);return _}}),deliveries:Object.freeze({async list(i,u){ir(i);let d={...i,program_id:n.programId},l=JSON.stringify(d),_="/api/card/deliveries/reconciliations/list",s=await r("POST",_,y(_,l),l,[200],nr,u);if(s.items.length>i.page_size)throw V(200);return s}}),deliveryReplays:Object.freeze({async create(i,u){g(T(i,["selection_id"])&&H(i.selection_id),"Delivery replay requires a fixed selection_id UUID");let d=xe(u),l={...i,program_id:n.programId},_=JSON.stringify(l),s="/api/card/deliveries/replays",S=await r("POST",s,y(s,_,d),_,[202],rr,u);if(S.selection_id!==i.selection_id)throw V(202);return S}}),deadLetters:Object.freeze({async list(i,u){g(i===void 0||T(i,[],["limit"])&&ke(i.limit,s=>typeof s=="number"&&Number.isInteger(s)&&s>=1&&s<=100),"Dead-letter limit must be null, absent, or an integer from 1 to 100");let d=typeof i?.limit=="number"?i.limit:void 0,l=d!==void 0?`/api/card/deliveries/dead-letters?limit=${d}`:"/api/card/deliveries/dead-letters",_=await r("GET",l,y(l,"",void 0,"GET"),void 0,[200],wr,u);if(_.items.length>(d??50))throw V(200);return _},async replay(i,u){g(H(i),"The dead-letter path identifier must be a UUID");let d=`/api/card/deliveries/dead-letters/${i}/replay`,l=Wt(u),_=await r("POST",d,y(d,l??""),l,[202],Cr,u);if(_.id!==i)throw V(202);return _}})})}function de(e,t,r){return!e||typeof e!="object"||!("status"in e)||e.status!==t?!1:r?"details"in e&&!!e.details&&typeof e.details=="object"&&"error"in e.details&&e.details.error===r:!0}async function nn(e,t=console.log){let r=new URL(e);if(r.protocol!=="http:"||r.hostname!=="127.0.0.1"||r.pathname!=="/"||r.search||r.hash||r.username||r.password)throw new Error("Simulator vectors only support a loopback HTTP origin");let n=(o={})=>tn({environment:"dev",...J,apiBaseUrl:r.origin,...o}),a=n(),c=(0,mt.randomUUID)(),m={external_card_id:"synthetic-card",external_authorization_id:`synthetic-${c}`,supplier_transaction_id:`synthetic-supplier-${c}`,amount:"1.00",currency:"USD",cardholder_verification:{method:"provider_attested",verified_at:"2026-01-01T00:00:00Z",evidence_id:"synthetic-proof"},resource_version:"v1",mapping_revision:"v1"},y=`synthetic-key-${c}`,i=o=>({...m,external_authorization_id:`${m.external_authorization_id}-${o}`,supplier_transaction_id:`${m.supplier_transaction_id}-${o}`}),u=o=>a.authorizations.lookup({by:"idempotency_key",idempotency_key:o,original_credential_key_id:J.apiKeyId}),d=async(o,h,p)=>{let w=Ce({secret:J.apiKeySecret,apiKeyId:J.apiKeyId,method:"POST",target:o,timestamp:Math.floor(Date.now()/1e3),nonce:(0,mt.randomUUID)(),body:h,idempotencyKey:p});return w.set("content-type","application/json"),fetch(`${r.origin}${o}`,{method:"POST",headers:w,body:h,redirect:"error"})},l=!0,_="";async function s(o,h){try{if(await h()){t(`vector_passed:${o}`);return}}catch{}l=!1,t(`vector_failed:${o}`)}await s("authorization",async()=>{let o=await a.authorizations.create(m,{idempotencyKey:y});return _=o.charge_id,o.status==="processing"}),await s("authorization_replay",async()=>(await a.authorizations.create(m,{idempotencyKey:y})).charge_id===_&&_!==""),await s("integrity_conflict",async()=>{try{return await a.authorizations.create({...m,amount:"2.00"},{idempotencyKey:y}),!1}catch(o){return de(o,409,"integrity_conflict")}}),await s("operation_identity_conflict",async()=>{try{return await a.authorizations.create({...m,amount:"2.00"},{idempotencyKey:`different-key-${c}`}),!1}catch(o){return de(o,409,"integrity_conflict")}}),await s("byte_integrity_conflict",async()=>{let o=await d("/api/card/authorizations",JSON.stringify({...m,program_id:J.programId},null,2),y),h=await o.json();return o.status===409&&!!h&&typeof h=="object"&&"error"in h&&h.error==="integrity_conflict"});let S={fact_type:"clearing",supplier_transaction_id:m.supplier_transaction_id,amount:"1.00",currency:"USD",resource_version:"v2",predecessor_version:"v1",mapping_revision:"v1",recorded_at:"2026-01-01T01:00:00Z"};await s("clearing_fact",async()=>(await a.authorizations.recordFact(m.external_authorization_id,S,{idempotencyKey:`fact-${c}`})).status==="recorded"),await s("fact_status",async()=>{let o=await a.authorizations.lookup({by:"external_authorization_id",external_authorization_id:m.external_authorization_id,resource_version:S.resource_version,mapping_revision:S.mapping_revision});return o.resolution==="unknown"&&o.authorization.facts?.[0]?.state==="unobserved"&&o.authorization.facts?.[1]?.state==="confirmed"}),await s("fact_missing_predecessor",async()=>{let{predecessor_version:o,...h}=S;return(await d(`/api/card/authorizations/${encodeURIComponent(m.external_authorization_id)}/facts`,JSON.stringify({...h,program_id:J.programId}),`missing-${c}`)).status===400}),await s("fact_version_conflict",async()=>{try{return await a.authorizations.recordFact(m.external_authorization_id,{...S,fact_type:"reversal",resource_version:"v1",predecessor_version:"v2"},{idempotencyKey:`conflict-${c}`}),!1}catch(o){return de(o,409,"integrity_conflict")}});for(let[o,h]of["authorization_updated","reversal","refund","chargeback","settlement"].entries())await s(`fact_${h}`,async()=>(await a.authorizations.recordFact(m.external_authorization_id,{...S,fact_type:h,resource_version:`v${o+3}`,predecessor_version:`v${o+2}`},{idempotencyKey:`fact-${h}-${c}`})).status==="recorded");await s("status",async()=>{let o=await a.authorizations.lookup({by:"external_authorization_id",external_authorization_id:m.external_authorization_id,resource_version:m.resource_version,mapping_revision:m.mapping_revision});return o.resolution==="pending"&&o.authorization.facts?.[0]?.state==="confirmed"&&o.authorization.facts?.[1]?.state==="confirmed"}),await s("status_supplier_ref",async()=>(await a.authorizations.lookup({by:"supplier_transaction_id",supplier_transaction_id:m.supplier_transaction_id,resource_version:m.resource_version,mapping_revision:m.mapping_revision})).resolution==="pending"),await s("trimmed_supplier_ref",async()=>{let o={...i("trimmed"),supplier_transaction_id:` supplier-trim-${c} `};await a.authorizations.create(o,{idempotencyKey:`trimmed-${c}`});let h=await a.authorizations.lookup({by:"supplier_transaction_id",supplier_transaction_id:o.supplier_transaction_id.trim(),resource_version:o.resource_version,mapping_revision:o.mapping_revision});return h.resolution==="pending"&&h.authorization.supplier_transaction_id===o.supplier_transaction_id.trim()}),await s("supplier_namespace_conflict",async()=>{try{return await a.authorizations.create({...i("supplier-conflict"),supplier_transaction_id:m.supplier_transaction_id,mapping_revision:"other-mapping"},{idempotencyKey:`supplier-conflict-${c}`}),!1}catch(o){return de(o,409,"integrity_conflict")}}),await s("status_idempotency_key",async()=>(await u(y)).resolution==="pending"),await s("status_charge_id",async()=>(await a.authorizations.lookup({by:"charge_id",charge_id:_})).resolution==="pending"),await s("status_not_observed",async()=>(await u(`absent-${c}`)).resolution==="not_observed"),await s("status_failed_receipt",async()=>{let o=`failed-${c}`;if(await a.authorizations.create({...i("failed"),external_card_id:"synthetic-failed-card"},{idempotencyKey:o}),(await u(o)).resolution!=="pending")return!1;let h=await u(o);return h.resolution==="resolved"&&h.authorization.processing_status==="failed"&&h.authorization.final_receipt?.execution_outcome==="failed"&&h.authorization.final_receipt.terminal_action==="cancelReservation"});let C=`sync-${c}`,E=`expired-${c}`,D=`declined-${c}`;return await s("sync_closed",async()=>{let o=await a.authorizations.create({...i("sync"),decision_mode:"synchronous"},{idempotencyKey:C});return"error"in o&&o.error==="sync_approval_admission_closed"}),await s("sync_expired",async()=>{let o=await a.authorizations.create({...i("expired"),decision_mode:"synchronous",deadline_at:"2020-01-01T00:00:00Z"},{idempotencyKey:E});return"error"in o&&o.error==="decision_deadline_exceeded"}),await s("explicit_402",async()=>{try{return await a.authorizations.create({...i("declined"),external_card_id:"synthetic-declined-card"},{idempotencyKey:D}),!1}catch(o){return de(o,402,"spending_limit_exceeded")}}),await s("status_sync_closed",async()=>{let o=await u(C);return o.resolution==="resolved"&&o.authorization.processing_status==="failed"&&o.authorization.decision==="declined"&&o.authorization.decline_reason_code==="sync_approval_admission_closed"&&o.authorization.charge_id===void 0}),await s("status_sync_expired",async()=>{let o=await u(E);return o.resolution==="resolved"&&o.authorization.processing_status==="failed"&&o.authorization.decision==="self_reversed_timeout"&&o.authorization.decline_reason_code==="decision_deadline_exceeded"&&o.authorization.charge_id===void 0}),await s("status_explicit_402",async()=>{let o=await u(D);return o.resolution==="resolved"&&o.authorization.processing_status==="failed"&&o.authorization.decline_reason_code==="spending_limit_exceeded"}),await s("retry_503",async()=>{let o={...i("retry"),external_card_id:"synthetic-retry-card"},h=`retry-${c}`;try{return await a.authorizations.create(o,{idempotencyKey:h}),!1}catch(p){if(!de(p,503)||!p||typeof p!="object"||!("retryable"in p)||p.retryable!==!0)return!1}return(await a.authorizations.create(o,{idempotencyKey:h})).status==="processing"}),await s("retry_after_429",async()=>{try{return await a.authorizations.create({...i("rate"),external_card_id:"synthetic-rate-limited-card"},{idempotencyKey:`rate-${c}`}),!1}catch(o){return o instanceof U&&o.status===429&&o.code==="FACTO_ENGINE_REQUEST_FAILED"&&o.outcome==="unknown"&&o.retryable&&o.retryAfterSeconds===2&&He(o.details)&&o.details.error.code==="too_many_requests"}}),await s("invalid_502",async()=>{try{return await a.authorizations.create({...i("gateway"),external_card_id:"synthetic-bad-gateway-card"},{idempotencyKey:`gateway-${c}`}),!1}catch(o){return o instanceof U&&o.status===502&&o.code==="FACTO_ENGINE_RESPONSE_INVALID"&&o.outcome==="unknown"&&o.retryable&&o.retryAfterSeconds===2}}),await s("nested_500_hint_false",async()=>{try{return await a.authorizations.create({...i("nested-500"),external_card_id:"synthetic-nested-500-card"},{idempotencyKey:`nested-500-${c}`}),!1}catch(o){return o instanceof U&&o.status===500&&o.code==="FACTO_ENGINE_REQUEST_FAILED"&&o.outcome==="unknown"&&o.retryable&&He(o.details)&&o.details.error.retryable===!1}}),await s("bad_signature",async()=>{try{return await n({apiKeySecret:{encoding:"utf8",value:"wrong-synthetic-test-key"}}).deliveries.list({target_revision:ue,selection_id:be,page_size:1}),!1}catch(o){return de(o,401)}}),await s("expired_timestamp",async()=>{try{return await n({nowSeconds:()=>Math.floor(Date.now()/1e3)-301}).deliveries.list({target_revision:ue,selection_id:be,page_size:1}),!1}catch(o){return de(o,401)}}),await s("nonce_replay",async()=>{let o=n({createNonce:()=>`nonce-${c}`}),h={target_revision:ue,selection_id:be,page_size:1};await o.deliveries.list(h);try{return await o.deliveries.list(h),!1}catch(p){return de(p,401)}}),await s("reconciliation",async()=>{let o=await a.deliveries.list({target_revision:ue,selection_id:be,page_size:1}),h=ce.duplicate.deliveries[0].headers.find(([p])=>p==="facto-event-id")?.[1];return o.complete&&o.items.length===1&&o.items[0]?.event_id===h}),await s("history_replay",async()=>(await a.deliveryReplays.create({selection_id:be},{idempotencyKey:`replay-${c}`})).status==="accepted"),l}var et="11111111-1111-4111-8111-111111111101",Oe="acct_interlace_synthetic_01",tt="synthetic-card",sn="synthetic-declined-card",ht=Object.freeze({authorizationApproved:Object.freeze({event:"CARD_TRANSACTION",id:et,cardId:tt,accountId:Oe,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:sn,accountId:Oe,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:tt,accountId:Oe,clientTransactionId:"client-req-clearing-0003",relatedCardTransactionId:et,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:tt,accountId:Oe,clientTransactionId:"client-req-reversal-0004",relatedCardTransactionId:et,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:tt,accountId:Oe,clientTransactionId:"client-req-refund-0005",relatedCardTransactionId:et,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"})})}),dn="cprog_SYNTHETIC00000001",cn="pconn_SYNTHETIC00000001",un="facto-interlace-v1",Tr="00000000-0000-4000-8000-000000000001",Er="synthetic-delivery-test-key";function rn(e,t,r,n){return`interlace-v1-${se(JSON.stringify([e,t,r,n])).slice(0,32)}`}function rt(e){let t=se(e);return`${t.slice(0,8)}-${t.slice(8,12)}-4${t.slice(13,16)}-8${t.slice(17,20)}-${t.slice(20,32)}`}function on(e){return`0x${"0".repeat(32)}${se(e).slice(0,32)}`}function nt(e,t){return new Error(`Interlace CARD_TRANSACTION ${e.id} (type ${e.type}, status ${e.status}) cannot be mapped: ${t}. Hold it for authoritative evidence; never submit it as a new authorization.`)}function Or(e){let t=e.clearingEvidence?.state==="CLEARED";if(e.type===1){if(t)return"clearing";if(e.relatedCardTransactionId!==void 0)throw nt(e,"a consumption record linked to a parent maps only to a clearing fact, which requires clearingEvidence.state CLEARED");return}let r=e.type===14?"reversal":"refund";if(e.relatedCardTransactionId===void 0)throw nt(e,`a ${r} child requires relatedCardTransactionId pointing to the original consumption`);if(e.status!=="CLOSED"&&e.status!=="CLEARED")throw nt(e,`status ${e.status} is not a final successful ${r}`);if(r==="refund"&&!t)throw nt(e,"a merchant refund requires clearingEvidence.state CLEARED for the original consumption");return r}function bt(e,t={}){let r=t.programId??dn,n=t.connectionId??cn,a=t.mappingRevision??un,c=Or(e);if(c!==void 0){let y=e.relatedCardTransactionId??e.id,i=`${c}-${e.id}`,u=t.predecessorVersion??(c==="refund"?`clearing-${y}`:"auth-v1"),d=rn(n,y,e.id,c);return{endpoint:"POST /api/card/authorizations/{external_id}/facts",externalAuthorizationId:y,idempotencyKey:d,payload:{program_id:r,fact_type:c,supplier_transaction_id:e.id,parent_supplier_transaction_id:y,client_transaction_id:e.clientTransactionId,amount:e.amount,currency:e.currency,resource_version:i,predecessor_version:u,mapping_revision:a,recorded_at:e.clearingEvidence?.occurredAt??e.transactionAt}}}return{endpoint:"POST /api/card/authorizations",idempotencyKey:rn(n,e.id,e.id,"create_authorization"),payload:{program_id:r,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:a,cardholder_verification:{method:"provider_attested",verified_at:e.transactionAt,evidence_id:`interlace:${e.clientTransactionId}`}}}}function Dr(e){if(typeof e=="string"){let t=ht[e];if(!t)throw new RangeError(`Unknown Interlace CARD_TRANSACTION fixture: ${e}`);return{fixtureName:e,sourceEvent:t}}return{sourceEvent:e}}function an(e){let t=rt(`${e.scope.connectionId}:${e.externalAuthorizationId}:${e.sequence}:${e.changeType}`),r="card.authorization.updated",n=e.operationType==="clearing",a=e.operationType==="reversal",c=e.operationType==="refund",m=Number(e.amount).toFixed(6),y={envelope_version:2,event_id:t,event_kind:r,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:m,currency:"USDC"},charge:{charge_id:e.chargeId,status:"processing",amount:m,fee_total:"0.000000",total_debited:m,currency:"USDC",updated_at:e.occurredAt},issuer:{state:c?"refunded":a?"partially_reversed":n?"cleared":"authorized",cleared_amount:n?m:"0.000000",reversed_amount:a?m:"0.000000",refunded_amount:c?m:"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?m:"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:m,currency:"USDC",recorded_at:e.occurredAt,link_status:"linked"}}:{}}}},i=new TextEncoder().encode(JSON.stringify(y)),u=String(e.nowSeconds),d=se(i),l=fe(e.secret,["facto:card:outbound-delivery-signature","v1",t,r,u,d].join(`
6
+ `)),_={...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:[r]},s=[["facto-signature",`v1=${l}`],["facto-signature-key-id",_.keyId],["facto-event-id",t],["facto-event-kind",r],["facto-event-timestamp-seconds",u],["facto-delivery-attempt",e.isSandboxReplay?"2":"1"]];return e.isSandboxReplay&&s.push(["facto-redelivery-reason","sandbox_replay"]),{rawBody:i,headers:s,registry:[_],expectedScope:e.scope,nowSeconds:e.nowSeconds}}function vt(e={}){let t=e.programId??dn,r=e.connectionId??cn,n=e.mappingRevision??un,a=e.targetRevision??Tr,c=new TextEncoder().encode(e.deliverySecretUtf8??Er),m=e.nowSeconds??(()=>1795e6),y=new Map,i=[],u=0;return{replayInterlaceTransaction(d,l={}){let{fixtureName:_,sourceEvent:s}=Dr(d),S=l.programId??t,C=l.connectionId??r,E=l.mappingRevision??n,D=l.targetRevision??a,o=l.nowSeconds??m(),h=bt(s,{...l,programId:S,connectionId:C,mappingRevision:E}),p=JSON.stringify(h.payload),w=y.get(h.idempotencyKey);if(w){if(w.bodyJson!==p){let ne={error:"idempotency_payload_mismatch",message:"Idempotency-Key was previously used with different request bytes",request_id:`req_sandbox_${rt(p).slice(0,8)}`},Z={..._?{fixtureName:_}:{},sourceEvent:s,mappedRequest:h,simulatedHttpStatus:409,simulatedResponse:ne};return i.push({sequence:i.length+1,idempotencyKey:h.idempotencyKey,endpoint:h.endpoint,httpStatus:409,response:ne}),Z}return w.result}let b={connectionId:C,environment:"dev",programId:S,targetRevision:D};if(h.endpoint==="POST /api/card/authorizations"){if(s.cardId===sn||Number(s.amount)>5e3){let Ae={error:"spending_limit_exceeded",message:"Pre-admission spending limit exceeded",request_id:`req_sandbox_${rt(h.idempotencyKey).slice(0,8)}`},re={..._?{fixtureName:_}:{},sourceEvent:s,mappedRequest:h,simulatedHttpStatus:402,simulatedResponse:Ae};return i.push({sequence:i.length+1,idempotencyKey:h.idempotencyKey,endpoint:h.endpoint,httpStatus:402,response:Ae}),re}u+=1;let ne=on(`${C}:${h.payload.external_authorization_id}`),Z={charge_id:ne,status:"processing"},pe=an({scope:b,secret:c,sequence:u,nowSeconds:o,isSandboxReplay:l.isSandboxReplay??!1,externalAuthorizationId:h.payload.external_authorization_id,supplierTransactionId:h.payload.supplier_transaction_id,mappingRevision:E,resourceVersion:h.payload.resource_version,operationType:"authorization_requested",amount:h.payload.amount,currency:h.payload.currency,chargeId:ne,occurredAt:s.transactionAt,changeType:"authorization.recorded"}),_e={..._?{fixtureName:_}:{},sourceEvent:s,mappedRequest:h,simulatedHttpStatus:200,simulatedResponse:Z,outboundDelivery:pe};return y.set(h.idempotencyKey,{bodyJson:p,result:_e}),i.push({sequence:i.length+1,idempotencyKey:h.idempotencyKey,endpoint:h.endpoint,httpStatus:200,response:Z,outboundDelivery:pe}),_e}u+=1;let I=rt(`${C}:${h.idempotencyKey}`),F=on(`${C}:${h.externalAuthorizationId}`),te={operation_id:I,status:"recorded"},K=an({scope:b,secret:c,sequence:u,nowSeconds:o,isSandboxReplay:l.isSandboxReplay??!1,externalAuthorizationId:h.externalAuthorizationId,supplierTransactionId:h.payload.supplier_transaction_id,mappingRevision:E,resourceVersion:h.payload.resource_version,operationType:h.payload.fact_type,amount:h.payload.amount,currency:h.payload.currency,chargeId:F,occurredAt:h.payload.recorded_at,changeType:"issuer_fact.recorded"}),W={..._?{fixtureName:_}:{},sourceEvent:s,mappedRequest:h,simulatedHttpStatus:200,simulatedResponse:te,outboundDelivery:K};return y.set(h.idempotencyKey,{bodyJson:p,result:W}),i.push({sequence:i.length+1,idempotencyKey:h.idempotencyKey,endpoint:h.endpoint,httpStatus:200,response:te,outboundDelivery:K}),W},listRecordedEvents(){return[...i]},reset(){y.clear(),i.length=0,u=0}}}function ln(e,t={}){return vt({programId:t.programId,connectionId:t.connectionId,mappingRevision:t.mappingRevision,targetRevision:t.targetRevision,nowSeconds:t.nowSeconds!==void 0?()=>t.nowSeconds:void 0}).replayInterlaceTransaction(e,t)}
@@ -0,0 +1,199 @@
1
+ import { s as DeliveryInboxStore, u as DeliveryScope, t as DeliveryInboxTransaction, z as VerifyEventDeliveryInput } from './card-inbox-DzsHFRPT.cjs';
2
+ import { Server } from 'node:http';
3
+
4
+ declare class MemoryDeliveryInboxStore implements DeliveryInboxStore {
5
+ private readonly states;
6
+ private readonly capacity;
7
+ private readonly leaseMs;
8
+ private readonly now;
9
+ constructor(options?: {
10
+ capacity?: number;
11
+ leaseMs?: number;
12
+ nowMs?: () => number;
13
+ });
14
+ withConnection<T>(scope: Readonly<DeliveryScope>, operation: (transaction: DeliveryInboxTransaction) => Promise<T>): Promise<T>;
15
+ }
16
+ declare const deliveryInboxVectors: {
17
+ readonly duplicate: {
18
+ readonly deliveries: readonly [VerifyEventDeliveryInput, VerifyEventDeliveryInput];
19
+ };
20
+ readonly outOfOrder: {
21
+ readonly deliveries: readonly [VerifyEventDeliveryInput, VerifyEventDeliveryInput, VerifyEventDeliveryInput];
22
+ };
23
+ readonly gap: {
24
+ readonly deliveries: readonly [VerifyEventDeliveryInput, VerifyEventDeliveryInput];
25
+ };
26
+ readonly nullableCard: {
27
+ readonly deliveries: readonly [VerifyEventDeliveryInput];
28
+ };
29
+ readonly unsequenced: {
30
+ readonly deliveries: readonly [VerifyEventDeliveryInput, VerifyEventDeliveryInput];
31
+ };
32
+ };
33
+
34
+ declare const requiredEventCatalogFixture: Readonly<{
35
+ revision: "2026-11-18-card-events.1";
36
+ digest: "sha256:9fcad68499ef3f770533ad3f3a4c4950d16c0385c56b2b0af6bba5375038aa98";
37
+ approvedFeatureSnapshot: readonly ["binding", "new_consumption", "supplier_fact_updates"];
38
+ featureClosures: Readonly<{
39
+ binding: readonly ["card.binding.linked", "card.binding.relinked", "card.binding.revoked", "card.binding.route_changed", "card.binding.limits_changed", "card.binding.ownership_transferred"];
40
+ new_consumption: readonly ["card.charge.finalized"];
41
+ supplier_fact_updates: readonly ["card.charge.facts_updated"];
42
+ }>;
43
+ }>;
44
+ declare const authorizationEventCatalogFixture: Readonly<{
45
+ revision: "2026-11-18-card-events.1";
46
+ digest: "sha256:9fcad68499ef3f770533ad3f3a4c4950d16c0385c56b2b0af6bba5375038aa98";
47
+ approvedFeatureSnapshot: readonly ["binding", "new_consumption", "supplier_fact_updates", "authorization_updates"];
48
+ featureClosures: Readonly<{
49
+ authorization_updates: readonly ["card.authorization.updated"];
50
+ binding: readonly ["card.binding.linked", "card.binding.relinked", "card.binding.revoked", "card.binding.route_changed", "card.binding.limits_changed", "card.binding.ownership_transferred"];
51
+ new_consumption: readonly ["card.charge.finalized"];
52
+ supplier_fact_updates: readonly ["card.charge.facts_updated"];
53
+ }>;
54
+ }>;
55
+ declare const simulatorDeliveryKinds: readonly ["duplicate", "outOfOrder", "gap", "nullableCard", "unsequenced", "authorizationOutOfOrder", "authorizationRedelivery", "refundAwaitingChargeFinal", "refundAwaitingFunds", "refundPayable", "refundPaid", "refundFailed", "refundNotPayable", "chargeFailed"];
56
+ type SimulatorDeliveryKind = (typeof simulatorDeliveryKinds)[number];
57
+ declare function simulatorDeliveryScenario(name: SimulatorDeliveryKind, nowSeconds?: number, attempt?: number): {
58
+ config: {
59
+ name: "duplicate" | "outOfOrder" | "gap" | "nullableCard" | "unsequenced" | "authorizationOutOfOrder" | "authorizationRedelivery" | "refundAwaitingChargeFinal" | "refundAwaitingFunds" | "refundPayable" | "refundPaid" | "refundFailed" | "refundNotPayable" | "chargeFailed";
60
+ selectionId: string;
61
+ connectionId: string;
62
+ programId: string;
63
+ environment: "dev";
64
+ targetRevision: string;
65
+ keyId: string;
66
+ secretUtf8: string;
67
+ signerKeyVersion: number;
68
+ notBefore: string;
69
+ expiresAt: string;
70
+ status: "active";
71
+ eventKinds: string[];
72
+ };
73
+ deliveries: VerifyEventDeliveryInput[];
74
+ };
75
+
76
+ declare function startCardSimulator(port?: number, options?: {
77
+ capacity?: number;
78
+ ttlMs?: number;
79
+ nowMs?: () => number;
80
+ }): Promise<{
81
+ server: Server;
82
+ url: string;
83
+ }>;
84
+
85
+ declare function runCardSimulatorVectors(url: string, report?: (line: string) => void): Promise<boolean>;
86
+
87
+ interface InterlaceClearingEvidence {
88
+ readonly profile: 'facto-interlace-v1';
89
+ readonly state: 'CLEARED';
90
+ readonly amount: string;
91
+ readonly currency: 'USD' | 'USDC';
92
+ readonly occurredAt: string;
93
+ readonly revision: number;
94
+ readonly refundableAmount: string;
95
+ }
96
+ interface InterlaceCardTransactionEvent {
97
+ readonly event: 'CARD_TRANSACTION';
98
+ readonly id: string;
99
+ readonly cardId: string;
100
+ readonly accountId: string;
101
+ readonly clientTransactionId: string;
102
+ readonly relatedCardTransactionId?: string;
103
+ readonly type: 0 | 1 | 14;
104
+ readonly status: 'PENDING' | 'CLOSED' | 'CLEARED' | 'FAILED';
105
+ readonly amount: string;
106
+ readonly currency: 'USD' | 'USDC';
107
+ readonly merchantName: string;
108
+ readonly merchantMcc: string;
109
+ readonly merchantCountry: string;
110
+ readonly transactionAt: string;
111
+ readonly clearingEvidence?: InterlaceClearingEvidence;
112
+ }
113
+ type InterlaceCardTransactionFixtureName = 'authorizationApproved' | 'authorizationDeclinedLimit' | 'clearingEqualAmount' | 'partialReversalUncleared' | 'merchantRefundCleared';
114
+ declare const interlaceCardTransactionFixtures: Readonly<Record<InterlaceCardTransactionFixtureName, InterlaceCardTransactionEvent>>;
115
+ interface InterlaceMappedAuthorizationRequest {
116
+ readonly endpoint: 'POST /api/card/authorizations';
117
+ readonly idempotencyKey: string;
118
+ readonly payload: Readonly<{
119
+ program_id: string;
120
+ external_card_id: string;
121
+ external_authorization_id: string;
122
+ supplier_transaction_id: string;
123
+ client_transaction_id: string;
124
+ amount: string;
125
+ currency: 'USD' | 'USDC';
126
+ merchant_name: string;
127
+ merchant_mcc: string;
128
+ merchant_country: string;
129
+ resource_version: string;
130
+ mapping_revision: string;
131
+ cardholder_verification: Readonly<{
132
+ method: 'provider_attested';
133
+ verified_at: string;
134
+ evidence_id: string;
135
+ }>;
136
+ }>;
137
+ }
138
+ interface InterlaceMappedFactRequest {
139
+ readonly endpoint: 'POST /api/card/authorizations/{external_id}/facts';
140
+ readonly externalAuthorizationId: string;
141
+ readonly idempotencyKey: string;
142
+ readonly payload: Readonly<{
143
+ program_id: string;
144
+ fact_type: 'clearing' | 'reversal' | 'refund';
145
+ supplier_transaction_id: string;
146
+ parent_supplier_transaction_id: string;
147
+ client_transaction_id: string;
148
+ amount: string;
149
+ currency: 'USD' | 'USDC';
150
+ resource_version: string;
151
+ predecessor_version: string;
152
+ mapping_revision: string;
153
+ recorded_at: string;
154
+ }>;
155
+ }
156
+ type InterlaceMappedCardRequest = InterlaceMappedAuthorizationRequest | InterlaceMappedFactRequest;
157
+ interface InterlaceReplayOptions {
158
+ readonly programId?: string;
159
+ readonly connectionId?: string;
160
+ readonly mappingRevision?: string;
161
+ readonly predecessorVersion?: string;
162
+ readonly targetRevision?: string;
163
+ readonly nowSeconds?: number;
164
+ readonly isSandboxReplay?: boolean;
165
+ }
166
+ interface InterlaceReplayResult {
167
+ readonly fixtureName?: InterlaceCardTransactionFixtureName;
168
+ readonly sourceEvent: InterlaceCardTransactionEvent;
169
+ readonly mappedRequest: InterlaceMappedCardRequest;
170
+ readonly simulatedHttpStatus: 200 | 402 | 409;
171
+ readonly simulatedResponse: Readonly<Record<string, unknown>>;
172
+ readonly outboundDelivery?: VerifyEventDeliveryInput;
173
+ }
174
+ interface CardSandboxRuntimeOptions {
175
+ readonly programId?: string;
176
+ readonly connectionId?: string;
177
+ readonly mappingRevision?: string;
178
+ readonly targetRevision?: string;
179
+ readonly deliverySecretUtf8?: string;
180
+ readonly nowSeconds?: () => number;
181
+ }
182
+ interface CardSandboxRecordedEvent {
183
+ readonly sequence: number;
184
+ readonly idempotencyKey: string;
185
+ readonly endpoint: InterlaceMappedCardRequest['endpoint'];
186
+ readonly httpStatus: 200 | 402 | 409;
187
+ readonly response: Readonly<Record<string, unknown>>;
188
+ readonly outboundDelivery?: VerifyEventDeliveryInput;
189
+ }
190
+ interface CardSandboxRuntime {
191
+ replayInterlaceTransaction(eventOrFixture: InterlaceCardTransactionFixtureName | InterlaceCardTransactionEvent, options?: InterlaceReplayOptions): InterlaceReplayResult;
192
+ listRecordedEvents(): readonly CardSandboxRecordedEvent[];
193
+ reset(): void;
194
+ }
195
+ declare function mapInterlaceCardTransactionToAuthorization(event: InterlaceCardTransactionEvent, options?: InterlaceReplayOptions): InterlaceMappedCardRequest;
196
+ declare function createCardSandboxRuntime(runtimeOptions?: CardSandboxRuntimeOptions): CardSandboxRuntime;
197
+ declare function replayInterlaceCardTransaction(eventOrFixture: InterlaceCardTransactionFixtureName | InterlaceCardTransactionEvent, options?: InterlaceReplayOptions): InterlaceReplayResult;
198
+
199
+ 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, runCardSimulatorVectors, simulatorDeliveryKinds, simulatorDeliveryScenario, startCardSimulator };