xytara 3.1.16 → 3.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (390) hide show
  1. package/README.md +120 -92
  2. package/RELEASE_NOTES.md +7 -3
  3. package/START_HERE.md +56 -224
  4. package/bin/xytara.js +21 -8
  5. package/client.js +79 -1
  6. package/lib/{delivery_receipt.js → delivery_receipt_verify.js} +14 -100
  7. package/package.json +25 -35
  8. package/scripts/verify_client.js +418 -0
  9. package/scripts/verify_release_candidate.js +146 -45
  10. package/.env.example +0 -173
  11. package/ADAPTER_START_HERE.md +0 -56
  12. package/BSV_TERANODE_PLATFORM_DISCONTINUITY_RUNBOOK.md +0 -126
  13. package/CARRIED_HANDOFF_DEMO.md +0 -60
  14. package/EXAMPLE_PATHS.md +0 -53
  15. package/FINAL_CONTRACT.md +0 -498
  16. package/PARTNER_READY_PATH.md +0 -71
  17. package/PUBLIC_DEMO_SCRIPT.md +0 -78
  18. package/REAL_PAYMENT_SETUP.md +0 -320
  19. package/SERVICE_CONTRACT.md +0 -419
  20. package/SUPABASE_RUNTIME_STATE_SETUP.md +0 -61
  21. package/TERMINOLOGY.md +0 -50
  22. package/WHY_XYTARA_XOONYA.md +0 -63
  23. package/XT1_EXECUTION_TRUTH_STANDARD.md +0 -78
  24. package/XYTARA_ADAPTER_PROTOCOL_TRUTH_MODEL.md +0 -75
  25. package/XYTARA_AUTONOMOUS_ENTRY_MODEL.md +0 -124
  26. package/XYTARA_DEFAULT_PATH_MODEL.md +0 -84
  27. package/XYTARA_EXECUTION_TRUTH_MODEL.md +0 -171
  28. package/XYTARA_PAYMENT_RAIL_TRUTH_MODEL.md +0 -68
  29. package/adapters/AUTHORING_GUIDE.md +0 -244
  30. package/adapters/ONBOARDING_POSTURE.md +0 -61
  31. package/adapters/THIRD_PARTY_SUBMISSION_PROCESS.md +0 -84
  32. package/adapters/adapter-manifest.schema.json +0 -283
  33. package/adapters/examples/example-execution-adapter.js +0 -61
  34. package/adapters/examples/example-execution-adapter.manifest.json +0 -81
  35. package/adapters/examples/example-settlement-adapter.js +0 -55
  36. package/adapters/examples/example-settlement-adapter.manifest.json +0 -78
  37. package/adapters/examples/example-third-party-acp-registration.submission-bundle.json +0 -124
  38. package/adapters/examples/example-third-party-erc8004-registration.submission-bundle.json +0 -121
  39. package/adapters/examples/example-third-party-identity-registration.certification-pack.json +0 -22
  40. package/adapters/examples/example-third-party-identity-registration.record.json +0 -26
  41. package/adapters/examples/example-third-party-identity-registration.submission-bundle.json +0 -126
  42. package/adapters/examples/example-third-party-langchain-registration.submission-bundle.json +0 -124
  43. package/adapters/examples/example-third-party-mpp-registration.submission-bundle.json +0 -120
  44. package/adapters/examples/example-third-party-registration.certification-pack.json +0 -22
  45. package/adapters/examples/example-third-party-registration.record.json +0 -28
  46. package/adapters/examples/example-third-party-registration.submission-bundle.json +0 -126
  47. package/adapters/examples/example-third-party-settlement-registration.certification-pack.json +0 -22
  48. package/adapters/examples/example-third-party-settlement-registration.record.json +0 -26
  49. package/adapters/examples/example-third-party-settlement-registration.submission-bundle.json +0 -127
  50. package/adapters/examples/langchain-reference-execution-adapter.js +0 -81
  51. package/adapters/examples/langchain-reference-execution-adapter.manifest.json +0 -79
  52. package/adapters/examples/langgraph-reference-execution-adapter.js +0 -81
  53. package/adapters/examples/langgraph-reference-execution-adapter.manifest.json +0 -79
  54. package/adapters/examples/minimal-third-party-execution-adapter.js +0 -61
  55. package/adapters/examples/minimal-third-party-execution-adapter.manifest.json +0 -79
  56. package/adapters/examples/minimal-third-party-execution-registration.record.json +0 -26
  57. package/adapters/examples/minimal-third-party-execution.certification-pack.json +0 -22
  58. package/adapters/examples/minimal-third-party-execution.submission-bundle.json +0 -126
  59. package/adapters/integration-certification-pack.schema.json +0 -82
  60. package/adapters/integration-registration-record.schema.json +0 -114
  61. package/adapters/integration-submission-bundle-set.schema.json +0 -39
  62. package/adapters/integration-submission-bundle.schema.json +0 -34
  63. package/adapters/interfaces.js +0 -56
  64. package/bin/xytara-release.js +0 -1429
  65. package/examples/_demo_env.js +0 -40
  66. package/examples/adapter_review_walkthrough.js +0 -54
  67. package/examples/export_carried_handoff.js +0 -81
  68. package/examples/funded_runtime_walkthrough.js +0 -71
  69. package/examples/partner_launch_walkthrough.js +0 -44
  70. package/examples/quickstart.js +0 -3256
  71. package/fixtures/catalog.js +0 -1156
  72. package/index.js +0 -395
  73. package/integrations/dispatch.js +0 -276
  74. package/integrations/registry-snapshot.schema.json +0 -36
  75. package/integrations/registry.js +0 -2261
  76. package/integrations/views.js +0 -28
  77. package/lib/a2a_lane_contract.js +0 -104
  78. package/lib/a2a_rpc.js +0 -287
  79. package/lib/a2c_lane_contract.js +0 -111
  80. package/lib/account_auth.js +0 -585
  81. package/lib/acp_lane_contract.js +0 -54
  82. package/lib/activity_audit_contract.js +0 -322
  83. package/lib/adapter_certification_contract.js +0 -130
  84. package/lib/adapter_depth_contract.js +0 -218
  85. package/lib/adapter_pack.js +0 -118
  86. package/lib/adapter_partner_pack.js +0 -89
  87. package/lib/adapter_promotion_pack.js +0 -89
  88. package/lib/adapter_protocol_truth_contract.js +0 -229
  89. package/lib/agent_identity.js +0 -162
  90. package/lib/announcement_pack.js +0 -61
  91. package/lib/artifact_distribution_lane_contract.js +0 -54
  92. package/lib/asyncapi_contract.js +0 -150
  93. package/lib/auth_interop_contract.js +0 -80
  94. package/lib/authority_binding_lifecycle_contract.js +0 -182
  95. package/lib/autonomous_entry_contract.js +0 -409
  96. package/lib/bolt_adapter.js +0 -187
  97. package/lib/bolt_lane_contract.js +0 -55
  98. package/lib/bolt_payment_front.js +0 -224
  99. package/lib/business_cockpit.js +0 -378
  100. package/lib/buyer_event_log.js +0 -230
  101. package/lib/buyer_safety_policy.js +0 -132
  102. package/lib/capability_execution_truth.js +0 -276
  103. package/lib/capability_registry.js +0 -633
  104. package/lib/catalog_contract.js +0 -966
  105. package/lib/catalog_family_model.js +0 -193
  106. package/lib/catalog_views.js +0 -55
  107. package/lib/cdp_jwt.js +0 -57
  108. package/lib/checkout_event_security.js +0 -142
  109. package/lib/checkout_processor_adapter.js +0 -217
  110. package/lib/cloudevents_contract.js +0 -80
  111. package/lib/command_flow.js +0 -911
  112. package/lib/commerce_artifacts.js +0 -591
  113. package/lib/commerce_authority.js +0 -449
  114. package/lib/commerce_bridge.js +0 -274
  115. package/lib/commerce_cases.js +0 -399
  116. package/lib/commerce_checkout.js +0 -509
  117. package/lib/commerce_coordination.js +0 -346
  118. package/lib/commerce_economics.js +0 -4017
  119. package/lib/commerce_identity.js +0 -578
  120. package/lib/commerce_quotes.js +0 -266
  121. package/lib/commerce_reports.js +0 -14461
  122. package/lib/commerce_runtime.js +0 -322
  123. package/lib/commerce_shell.js +0 -257
  124. package/lib/crypto_agility_matrix.js +0 -125
  125. package/lib/default_path_contract.js +0 -412
  126. package/lib/delivery_summary_contract.js +0 -95
  127. package/lib/ecosystem_entry.js +0 -64
  128. package/lib/erc8004_lane_contract.js +0 -65
  129. package/lib/event_system_lane_contract.js +0 -75
  130. package/lib/execution_dedupe.js +0 -86
  131. package/lib/execution_truth_contract.js +0 -234
  132. package/lib/external_credit_bridge.js +0 -142
  133. package/lib/external_execution_policy.js +0 -143
  134. package/lib/external_execution_runtime.js +0 -238
  135. package/lib/feature_control_lane_contract.js +0 -54
  136. package/lib/first_run_conversion_contract.js +0 -290
  137. package/lib/framework_lane_contract.js +0 -89
  138. package/lib/framework_provider_promotion.js +0 -235
  139. package/lib/full_catalog_contract.js +0 -525
  140. package/lib/go_live_operator_pack.js +0 -391
  141. package/lib/http_transport.js +0 -99
  142. package/lib/identity_auth.js +0 -175
  143. package/lib/identity_interop_contract.js +0 -82
  144. package/lib/integration_matrix_contract.js +0 -102
  145. package/lib/l402_adapter.js +0 -241
  146. package/lib/l402_lane_contract.js +0 -55
  147. package/lib/l402_payment_front.js +0 -265
  148. package/lib/launch_narrative.js +0 -53
  149. package/lib/lifecycle_continuity_contract.js +0 -115
  150. package/lib/machine_identity_registry_contract.js +0 -199
  151. package/lib/major_rails_lane_contract.js +0 -150
  152. package/lib/market_lane_contract.js +0 -467
  153. package/lib/market_lane_depth_contract.js +0 -182
  154. package/lib/market_lane_promotion_contract.js +0 -210
  155. package/lib/market_lane_trace_contract.js +0 -278
  156. package/lib/mcp_lane_contract.js +0 -137
  157. package/lib/mpp_adapter.js +0 -237
  158. package/lib/network_transport.js +0 -110
  159. package/lib/offline_verifiability_recovery_contract.js +0 -155
  160. package/lib/openapi_contract.js +0 -300
  161. package/lib/operational_receipt_contract.js +0 -165
  162. package/lib/operator_intelligence.js +0 -407
  163. package/lib/outreach_copy_pack.js +0 -51
  164. package/lib/outreach_message_pack.js +0 -71
  165. package/lib/outreach_proof.js +0 -71
  166. package/lib/outreach_target_pack.js +0 -60
  167. package/lib/partner_intelligence.js +0 -105
  168. package/lib/payment_config.js +0 -257
  169. package/lib/payment_front_registry.js +0 -53
  170. package/lib/payment_protocol_contract.js +0 -165
  171. package/lib/payment_rail_truth_contract.js +0 -324
  172. package/lib/payment_verification.js +0 -357
  173. package/lib/phase_10_closeout_pack.js +0 -45
  174. package/lib/phase_10_completion_pack.js +0 -76
  175. package/lib/phase_10_decision_record_pack.js +0 -54
  176. package/lib/phase_10_decision_resolution_pack.js +0 -53
  177. package/lib/phase_10_demand_signal_adapters_runtime_pack.js +0 -74
  178. package/lib/phase_10_ecosystem_backlog_triage_runtime_pack.js +0 -74
  179. package/lib/phase_10_freeze_baseline_pack.js +0 -67
  180. package/lib/phase_10_freeze_review_pack.js +0 -64
  181. package/lib/phase_10_gate_pack.js +0 -57
  182. package/lib/phase_10_long_tail_continuity_pack.js +0 -80
  183. package/lib/phase_10_long_tail_ecosystem_pack.js +0 -66
  184. package/lib/phase_10_niche_extension_registry_runtime_pack.js +0 -74
  185. package/lib/phase_1_claude_mcp_pack.js +0 -60
  186. package/lib/phase_1_claude_mcp_runtime_pack.js +0 -52
  187. package/lib/phase_1_ecosystem_pack.js +0 -67
  188. package/lib/phase_1_openai_codex_pack.js +0 -60
  189. package/lib/phase_1_openai_codex_runtime_pack.js +0 -52
  190. package/lib/phase_2_base_runtime_pack.js +0 -71
  191. package/lib/phase_2_base_usdc_runtime_pack.js +0 -72
  192. package/lib/phase_2_closeout_pack.js +0 -65
  193. package/lib/phase_2_completion_pack.js +0 -113
  194. package/lib/phase_2_decision_record_pack.js +0 -66
  195. package/lib/phase_2_decision_resolution_pack.js +0 -69
  196. package/lib/phase_2_eth_runtime_pack.js +0 -70
  197. package/lib/phase_2_evm_base_runtime_pack.js +0 -73
  198. package/lib/phase_2_evm_runtime_pack.js +0 -71
  199. package/lib/phase_2_flip_preview_pack.js +0 -60
  200. package/lib/phase_2_freeze_review_pack.js +0 -99
  201. package/lib/phase_2_gate_pack.js +0 -77
  202. package/lib/phase_2_payment_rails_pack.js +0 -71
  203. package/lib/phase_2_usdc_runtime_pack.js +0 -71
  204. package/lib/phase_3_brc_runtime_pack.js +0 -81
  205. package/lib/phase_3_bsv_teranode_runtime_pack.js +0 -83
  206. package/lib/phase_3_closeout_pack.js +0 -62
  207. package/lib/phase_3_completion_pack.js +0 -94
  208. package/lib/phase_3_decision_record_pack.js +0 -64
  209. package/lib/phase_3_decision_resolution_pack.js +0 -69
  210. package/lib/phase_3_freeze_baseline_pack.js +0 -67
  211. package/lib/phase_3_freeze_review_pack.js +0 -80
  212. package/lib/phase_3_gate_pack.js +0 -76
  213. package/lib/phase_3_metanet_runtime_pack.js +0 -81
  214. package/lib/phase_3_native_bsv_pack.js +0 -91
  215. package/lib/phase_3_native_continuity_pack.js +0 -82
  216. package/lib/phase_4_attestation_runtime_pack.js +0 -75
  217. package/lib/phase_4_closeout_pack.js +0 -45
  218. package/lib/phase_4_completion_pack.js +0 -94
  219. package/lib/phase_4_decision_record_pack.js +0 -54
  220. package/lib/phase_4_decision_resolution_pack.js +0 -45
  221. package/lib/phase_4_erc8004_runtime_pack.js +0 -76
  222. package/lib/phase_4_freeze_baseline_pack.js +0 -67
  223. package/lib/phase_4_freeze_review_pack.js +0 -68
  224. package/lib/phase_4_gate_pack.js +0 -58
  225. package/lib/phase_4_identity_registry_runtime_pack.js +0 -75
  226. package/lib/phase_4_identity_trust_pack.js +0 -73
  227. package/lib/phase_4_trust_continuity_pack.js +0 -86
  228. package/lib/phase_5_antelope_runtime_pack.js +0 -76
  229. package/lib/phase_5_closeout_pack.js +0 -44
  230. package/lib/phase_5_completion_pack.js +0 -82
  231. package/lib/phase_5_constellation_dag_runtime_pack.js +0 -76
  232. package/lib/phase_5_decision_record_pack.js +0 -54
  233. package/lib/phase_5_decision_resolution_pack.js +0 -45
  234. package/lib/phase_5_digibyte_dgb_runtime_pack.js +0 -76
  235. package/lib/phase_5_freeze_baseline_pack.js +0 -67
  236. package/lib/phase_5_freeze_review_pack.js +0 -68
  237. package/lib/phase_5_gate_pack.js +0 -58
  238. package/lib/phase_5_hedera_hbar_runtime_pack.js +0 -76
  239. package/lib/phase_5_kaspa_kas_runtime_pack.js +0 -76
  240. package/lib/phase_5_major_rails_continuity_pack.js +0 -86
  241. package/lib/phase_5_major_rails_pack.js +0 -110
  242. package/lib/phase_5_metal_runtime_pack.js +0 -76
  243. package/lib/phase_5_polkadot_dot_runtime_pack.js +0 -76
  244. package/lib/phase_5_proton_xpr_runtime_pack.js +0 -76
  245. package/lib/phase_5_solana_runtime_pack.js +0 -76
  246. package/lib/phase_6_autogen_runtime_pack.js +0 -72
  247. package/lib/phase_6_closeout_pack.js +0 -46
  248. package/lib/phase_6_completion_pack.js +0 -77
  249. package/lib/phase_6_decision_record_pack.js +0 -54
  250. package/lib/phase_6_decision_resolution_pack.js +0 -53
  251. package/lib/phase_6_framework_continuity_pack.js +0 -81
  252. package/lib/phase_6_framework_runtime_pack.js +0 -68
  253. package/lib/phase_6_freeze_baseline_pack.js +0 -68
  254. package/lib/phase_6_freeze_review_pack.js +0 -65
  255. package/lib/phase_6_gate_pack.js +0 -59
  256. package/lib/phase_6_langchain_runtime_pack.js +0 -72
  257. package/lib/phase_6_langgraph_runtime_pack.js +0 -72
  258. package/lib/phase_6_semantic_kernel_runtime_pack.js +0 -72
  259. package/lib/phase_7_closeout_pack.js +0 -45
  260. package/lib/phase_7_completion_pack.js +0 -85
  261. package/lib/phase_7_decision_record_pack.js +0 -53
  262. package/lib/phase_7_decision_resolution_pack.js +0 -53
  263. package/lib/phase_7_event_system_continuity_pack.js +0 -89
  264. package/lib/phase_7_event_system_pack.js +0 -76
  265. package/lib/phase_7_freeze_baseline_pack.js +0 -74
  266. package/lib/phase_7_freeze_review_pack.js +0 -65
  267. package/lib/phase_7_gate_pack.js +0 -58
  268. package/lib/phase_7_kafka_runtime_pack.js +0 -74
  269. package/lib/phase_7_mqtt_runtime_pack.js +0 -74
  270. package/lib/phase_7_nats_runtime_pack.js +0 -74
  271. package/lib/phase_7_webhook_event_bus_runtime_pack.js +0 -74
  272. package/lib/phase_8_closeout_pack.js +0 -46
  273. package/lib/phase_8_completion_pack.js +0 -82
  274. package/lib/phase_8_decision_record_pack.js +0 -54
  275. package/lib/phase_8_decision_resolution_pack.js +0 -53
  276. package/lib/phase_8_external_receipt_import_runtime_pack.js +0 -74
  277. package/lib/phase_8_external_result_import_runtime_pack.js +0 -74
  278. package/lib/phase_8_freeze_baseline_pack.js +0 -71
  279. package/lib/phase_8_freeze_review_pack.js +0 -64
  280. package/lib/phase_8_gate_pack.js +0 -58
  281. package/lib/phase_8_proof_bridge_continuity_pack.js +0 -86
  282. package/lib/phase_8_proof_bridges_pack.js +0 -72
  283. package/lib/phase_8_proof_bundle_normalization_runtime_pack.js +0 -74
  284. package/lib/phase_9_closeout_pack.js +0 -46
  285. package/lib/phase_9_completion_pack.js +0 -82
  286. package/lib/phase_9_custody_refs_runtime_pack.js +0 -74
  287. package/lib/phase_9_decision_record_pack.js +0 -54
  288. package/lib/phase_9_decision_resolution_pack.js +0 -53
  289. package/lib/phase_9_freeze_baseline_pack.js +0 -71
  290. package/lib/phase_9_freeze_review_pack.js +0 -64
  291. package/lib/phase_9_gate_pack.js +0 -58
  292. package/lib/phase_9_operator_accounting_bridges_runtime_pack.js +0 -74
  293. package/lib/phase_9_treasury_connectivity_pack.js +0 -72
  294. package/lib/phase_9_treasury_continuity_pack.js +0 -86
  295. package/lib/phase_9_treasury_destinations_runtime_pack.js +0 -74
  296. package/lib/phase_program_pack.js +0 -120
  297. package/lib/pricing_optimization_contract.js +0 -775
  298. package/lib/protocol_lane_contract.js +0 -117
  299. package/lib/provenance_lane_contract.js +0 -54
  300. package/lib/provider_lane_contract.js +0 -240
  301. package/lib/provider_network_contract.js +0 -149
  302. package/lib/provider_payout_execution.js +0 -155
  303. package/lib/provider_registry.js +0 -852
  304. package/lib/provider_runtime_journey_contract.js +0 -183
  305. package/lib/public_surface_policy_contract.js +0 -111
  306. package/lib/publish_plan.js +0 -51
  307. package/lib/rate_limiter.js +0 -81
  308. package/lib/record_queries.js +0 -48
  309. package/lib/release_candidate.js +0 -50
  310. package/lib/release_center.js +0 -1093
  311. package/lib/release_history.js +0 -205
  312. package/lib/release_manifest.js +0 -113
  313. package/lib/release_pack.js +0 -453
  314. package/lib/request_rate_limit.js +0 -144
  315. package/lib/resource_views.js +0 -31
  316. package/lib/revenue_launch_path_contract.js +0 -326
  317. package/lib/route_matchers.js +0 -34
  318. package/lib/route_params.js +0 -19
  319. package/lib/runtime_bridge.js +0 -124
  320. package/lib/runtime_operations_worker.js +0 -282
  321. package/lib/runtime_state_store.js +0 -495
  322. package/lib/settlement_bsv_live.js +0 -600
  323. package/lib/settlement_bsv_teranode.js +0 -117
  324. package/lib/settlement_lane_contract.js +0 -111
  325. package/lib/shared_signals_lane_contract.js +0 -54
  326. package/lib/signed_audit_provenance_contract.js +0 -83
  327. package/lib/soft_launch_pack.js +0 -78
  328. package/lib/stablecoin_lane_contract.js +0 -76
  329. package/lib/stripe_mpp_lane_contract.js +0 -96
  330. package/lib/stripe_mpp_payment_front.js +0 -258
  331. package/lib/telemetry_lane_contract.js +0 -54
  332. package/lib/treasury_destinations_contract.js +0 -764
  333. package/lib/treasury_egress_policy_contract.js +0 -91
  334. package/lib/treasury_lane_contract.js +0 -84
  335. package/lib/trust_portability_boundary_contract.js +0 -72
  336. package/lib/x402_facilitator.js +0 -198
  337. package/lib/x402_lane_contract.js +0 -136
  338. package/lib/x402_settlement_recovery.js +0 -175
  339. package/scripts/buyer_events_daily_report.js +0 -79
  340. package/scripts/registry_cli.js +0 -275
  341. package/scripts/state_backup_offsite.js +0 -196
  342. package/scripts/verify_a2a_rpc.js +0 -131
  343. package/scripts/verify_adapters.js +0 -554
  344. package/scripts/verify_agent_identity.js +0 -153
  345. package/scripts/verify_all.js +0 -4963
  346. package/scripts/verify_bolt_adapter.js +0 -128
  347. package/scripts/verify_buyer_event_log.js +0 -128
  348. package/scripts/verify_buyer_safety.js +0 -141
  349. package/scripts/verify_cdp_facilitator.js +0 -110
  350. package/scripts/verify_checkout_processor.js +0 -109
  351. package/scripts/verify_commerce_bridge.js +0 -177
  352. package/scripts/verify_control_plane_contracts.js +0 -34
  353. package/scripts/verify_control_plane_routes.js +0 -70
  354. package/scripts/verify_delivery_summary.js +0 -112
  355. package/scripts/verify_examples.js +0 -19
  356. package/scripts/verify_execution_dedupe.js +0 -189
  357. package/scripts/verify_execution_surfacing.js +0 -76
  358. package/scripts/verify_external_execution_retry.js +0 -140
  359. package/scripts/verify_final_activation.js +0 -191
  360. package/scripts/verify_first_run_conversions.js +0 -81
  361. package/scripts/verify_framework_provider_promotion.js +0 -152
  362. package/scripts/verify_full_catalog.js +0 -174
  363. package/scripts/verify_integrations.js +0 -620
  364. package/scripts/verify_l402_adapter.js +0 -86
  365. package/scripts/verify_lifecycle_continuity.js +0 -96
  366. package/scripts/verify_lifecycle_spend_binding.js +0 -88
  367. package/scripts/verify_market_lane_depth.js +0 -94
  368. package/scripts/verify_market_lane_promotion.js +0 -103
  369. package/scripts/verify_market_lane_traces.js +0 -98
  370. package/scripts/verify_market_lanes.js +0 -102
  371. package/scripts/verify_mpp_adapter.js +0 -128
  372. package/scripts/verify_operator_observability_boundary.js +0 -83
  373. package/scripts/verify_pricing_experiment_plan.js +0 -124
  374. package/scripts/verify_production_readiness.js +0 -268
  375. package/scripts/verify_provider_network.js +0 -819
  376. package/scripts/verify_provider_runtime_breadth.js +0 -109
  377. package/scripts/verify_provider_runtime_journeys.js +0 -111
  378. package/scripts/verify_rate_limiter.js +0 -52
  379. package/scripts/verify_refund_credit.js +0 -106
  380. package/scripts/verify_revenue_launch_paths.js +0 -105
  381. package/scripts/verify_runtime_durability.js +0 -52
  382. package/scripts/verify_runtime_state_guard.js +0 -117
  383. package/scripts/verify_service.js +0 -15421
  384. package/scripts/verify_settlement.js +0 -116
  385. package/scripts/verify_tooling.js +0 -1412
  386. package/scripts/verify_treasury_public_boundary.js +0 -97
  387. package/scripts/verify_verify_execute_settle.js +0 -209
  388. package/scripts/verify_x402_facilitator.js +0 -307
  389. package/scripts/verify_x402_settlement_recovery.js +0 -153
  390. package/server.js +0 -12245
@@ -1,193 +0,0 @@
1
- "use strict";
2
-
3
- const FAMILY_DEFINITIONS = Object.freeze([
4
- { family_id: "identity", label: "identity" },
5
- { family_id: "discovery", label: "discovery" },
6
- { family_id: "negotiation", label: "negotiation" },
7
- { family_id: "invocation", label: "invocation" },
8
- { family_id: "sessions_messaging", label: "sessions/messaging" },
9
- { family_id: "payments_metering", label: "payments/metering" },
10
- { family_id: "delivery", label: "delivery" },
11
- { family_id: "disputes", label: "disputes" },
12
- { family_id: "anchoring_finality", label: "anchoring/finality" }
13
- ]);
14
-
15
- const LIFECYCLE_STAGE_DEFINITIONS = Object.freeze([
16
- { lifecycle_stage: "discover", label: "discover" },
17
- { lifecycle_stage: "negotiate", label: "negotiate" },
18
- { lifecycle_stage: "quote_commit", label: "quote/commit" },
19
- { lifecycle_stage: "invoke", label: "invoke" },
20
- { lifecycle_stage: "session_send_close", label: "session/send/close" },
21
- { lifecycle_stage: "meter", label: "meter" },
22
- { lifecycle_stage: "deliver", label: "deliver" },
23
- { lifecycle_stage: "settlement_intent", label: "settlement-intent" },
24
- { lifecycle_stage: "settle_reconcile", label: "settle/reconcile" },
25
- { lifecycle_stage: "anchor", label: "anchor" },
26
- { lifecycle_stage: "dispute_open", label: "dispute-open" },
27
- { lifecycle_stage: "dispute_fetch", label: "dispute-fetch" },
28
- { lifecycle_stage: "verify", label: "verify" }
29
- ]);
30
-
31
- const MARKET_CLASS_DEFINITIONS = Object.freeze([
32
- { market_class: "compute", label: "compute" },
33
- { market_class: "data", label: "data" },
34
- { market_class: "storage", label: "storage" },
35
- { market_class: "messaging", label: "messaging" },
36
- { market_class: "device_robotics", label: "device/robotics" },
37
- { market_class: "treasury_payments", label: "treasury/payments" }
38
- ]);
39
-
40
- function mapCategoryDefaults(publicCategory) {
41
- switch (String(publicCategory || "").trim()) {
42
- case "trust":
43
- return { task_family: "identity", lifecycle_stage: "verify", market_class: "data" };
44
- case "receipt":
45
- return { task_family: "delivery", lifecycle_stage: "verify", market_class: "data" };
46
- case "runtime":
47
- return { task_family: "delivery", lifecycle_stage: "deliver", market_class: "compute" };
48
- case "jobs":
49
- return { task_family: "invocation", lifecycle_stage: "quote_commit", market_class: "compute" };
50
- case "credits":
51
- return { task_family: "payments_metering", lifecycle_stage: "meter", market_class: "treasury_payments" };
52
- case "a2a":
53
- return { task_family: "negotiation", lifecycle_stage: "negotiate", market_class: "messaging" };
54
- case "a2c":
55
- return { task_family: "sessions_messaging", lifecycle_stage: "session_send_close", market_class: "messaging" };
56
- case "policy":
57
- return { task_family: "payments_metering", lifecycle_stage: "settlement_intent", market_class: "treasury_payments" };
58
- case "identity":
59
- return { task_family: "identity", lifecycle_stage: "verify", market_class: "data" };
60
- case "registry":
61
- return { task_family: "identity", lifecycle_stage: "deliver", market_class: "storage" };
62
- case "anchoring":
63
- return { task_family: "anchoring_finality", lifecycle_stage: "anchor", market_class: "storage" };
64
- case "discovery":
65
- return { task_family: "discovery", lifecycle_stage: "discover", market_class: "data" };
66
- case "admission":
67
- return { task_family: "negotiation", lifecycle_stage: "settlement_intent", market_class: "treasury_payments" };
68
- case "settlement":
69
- return { task_family: "payments_metering", lifecycle_stage: "settle_reconcile", market_class: "treasury_payments" };
70
- case "adapter":
71
- return { task_family: "invocation", lifecycle_stage: "invoke", market_class: "compute" };
72
- default:
73
- return { task_family: "discovery", lifecycle_stage: "discover", market_class: "data" };
74
- }
75
- }
76
-
77
- function decorateTaskMetadata(definition = {}) {
78
- const defaults = mapCategoryDefaults(definition.public_category);
79
- const publicTaskRef = String(definition.public_task_ref || "").trim();
80
- let task_family = defaults.task_family;
81
- let lifecycle_stage = defaults.lifecycle_stage;
82
- let market_class = defaults.market_class;
83
- let claim_status = "bounded_live";
84
- let evidence_status = "first_party_runtime";
85
-
86
- switch (publicTaskRef) {
87
- case "trust.handoff.emit":
88
- case "execution_receipt.handoff.emit":
89
- case "receipt_ledger.handoff.emit":
90
- case "identity.registry.link":
91
- case "registry.pack.bundle":
92
- case "jobs.release":
93
- lifecycle_stage = "deliver";
94
- evidence_status = "proof_handoff_ready";
95
- break;
96
- case "trust.handoff.validate":
97
- case "execution_receipt.handoff.validate":
98
- case "receipt_ledger.handoff.validate":
99
- case "receipt.validate":
100
- lifecycle_stage = "verify";
101
- break;
102
- case "runtime.anchor":
103
- case "runtime.emit_anchor":
104
- task_family = "anchoring_finality";
105
- lifecycle_stage = "anchor";
106
- break;
107
- case "jobs.quote":
108
- lifecycle_stage = "quote_commit";
109
- break;
110
- case "jobs.reserve":
111
- case "jobs.commit":
112
- task_family = "invocation";
113
- lifecycle_stage = "quote_commit";
114
- break;
115
- case "credits.apply":
116
- lifecycle_stage = "settle_reconcile";
117
- evidence_status = "first_party_ledger";
118
- break;
119
- case "a2a.commit":
120
- lifecycle_stage = "quote_commit";
121
- break;
122
- case "policy.simulate":
123
- case "admission.preview":
124
- lifecycle_stage = "settlement_intent";
125
- evidence_status = "first_party_policy_preview";
126
- break;
127
- case "settlement.submit":
128
- lifecycle_stage = "settle_reconcile";
129
- evidence_status = "first_party_settlement";
130
- break;
131
- case "adapter.mcp.invoke":
132
- case "adapter.mcp.catalog":
133
- case "adapter.mcp.reply.draft":
134
- case "adapter.mcp.json.validate":
135
- claim_status = "live";
136
- evidence_status = "provider_live";
137
- break;
138
- default:
139
- break;
140
- }
141
-
142
- return {
143
- task_family,
144
- lifecycle_stage,
145
- market_class,
146
- claim_status,
147
- evidence_status
148
- };
149
- }
150
-
151
- function decorateAdapterMetadata(adapterId) {
152
- switch (String(adapterId || "").trim()) {
153
- case "mcp":
154
- return {
155
- task_family: "invocation",
156
- lifecycle_stage: "invoke",
157
- market_class: "compute",
158
- claim_status: "live",
159
- evidence_status: "provider_live"
160
- };
161
- case "chain":
162
- return {
163
- task_family: "payments_metering",
164
- lifecycle_stage: "settle_reconcile",
165
- market_class: "treasury_payments",
166
- claim_status: "bounded_live",
167
- evidence_status: "first_party_settlement"
168
- };
169
- case "http":
170
- default:
171
- return {
172
- task_family: "discovery",
173
- lifecycle_stage: "discover",
174
- market_class: "data",
175
- claim_status: "bounded_live",
176
- evidence_status: "first_party_runtime"
177
- };
178
- }
179
- }
180
-
181
- function definitionLabel(definitions, field, value) {
182
- const entry = definitions.find((item) => item[field] === value);
183
- return entry ? entry.label : value;
184
- }
185
-
186
- module.exports = {
187
- FAMILY_DEFINITIONS,
188
- LIFECYCLE_STAGE_DEFINITIONS,
189
- MARKET_CLASS_DEFINITIONS,
190
- decorateAdapterMetadata,
191
- decorateTaskMetadata,
192
- definitionLabel
193
- };
@@ -1,55 +0,0 @@
1
- "use strict";
2
-
3
- const { buildMissingResponse } = require("./resource_views");
4
-
5
- function buildTaskDetailResponse(task) {
6
- if (!task) {
7
- return buildMissingResponse("task_not_found");
8
- }
9
- return {
10
- status: 200,
11
- payload: { ok: true, task }
12
- };
13
- }
14
-
15
- function buildWorkflowListResponse(workflows) {
16
- return {
17
- status: 200,
18
- payload: { ok: true, workflows }
19
- };
20
- }
21
-
22
- function buildWorkflowDetailResponse(workflow) {
23
- if (!workflow) {
24
- return buildMissingResponse("workflow_not_found");
25
- }
26
- return {
27
- status: 200,
28
- payload: { ok: true, workflow }
29
- };
30
- }
31
-
32
- function buildCreditPackListResponse(creditPacks) {
33
- return {
34
- status: 200,
35
- payload: { ok: true, credit_packs: creditPacks }
36
- };
37
- }
38
-
39
- function buildCreditPackDetailResponse(creditPack) {
40
- if (!creditPack) {
41
- return buildMissingResponse("credit_pack_not_found");
42
- }
43
- return {
44
- status: 200,
45
- payload: { ok: true, credit_pack: creditPack }
46
- };
47
- }
48
-
49
- module.exports = {
50
- buildCreditPackDetailResponse,
51
- buildCreditPackListResponse,
52
- buildTaskDetailResponse,
53
- buildWorkflowDetailResponse,
54
- buildWorkflowListResponse
55
- };
package/lib/cdp_jwt.js DELETED
@@ -1,57 +0,0 @@
1
- "use strict";
2
-
3
- // Zero-dependency Coinbase CDP Bearer JWT signer, used to authenticate requests to the
4
- // CDP-hosted x402 facilitator (https://api.cdp.coinbase.com/platform/v2/x402), which
5
- // settles Base mainnet. CDP authenticates each request with a short-lived (<=120s) EdDSA
6
- // (Ed25519) JWT generated from a CDP Secret API Key, so a static Authorization header is
7
- // not usable; a fresh token is minted per request with a `uri` claim bound to that request.
8
- //
9
- // Secret format: base64-encoded Ed25519, 64 bytes (first 32 = seed, last 32 = public key).
10
- // Reference: https://docs.cdp.coinbase.com/get-started/docs/cdp-api-keys
11
-
12
- const crypto = require("crypto");
13
-
14
- // DER PKCS#8 prefix for an Ed25519 private key carrying a 32-byte seed.
15
- const ED25519_PKCS8_PREFIX = Buffer.from("302e020100300506032b657004220420", "hex");
16
-
17
- function base64url(input) {
18
- const buf = Buffer.isBuffer(input) ? input : Buffer.from(input);
19
- return buf.toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
20
- }
21
-
22
- function privateKeyFromSecret(keySecret) {
23
- const decoded = Buffer.from(String(keySecret || "").trim(), "base64");
24
- if (decoded.length !== 64) {
25
- throw new Error("cdp_key_secret_invalid: expected a base64 Ed25519 key of 64 bytes");
26
- }
27
- const seed = decoded.subarray(0, 32);
28
- const pkcs8 = Buffer.concat([ED25519_PKCS8_PREFIX, seed]);
29
- return crypto.createPrivateKey({ key: pkcs8, format: "der", type: "pkcs8" });
30
- }
31
-
32
- // Build a CDP Bearer JWT for a single request.
33
- // keyId CDP API key id (UUID)
34
- // keySecret base64 Ed25519 secret (64 bytes)
35
- // method HTTP method, e.g. "POST"
36
- // host request host, e.g. "api.cdp.coinbase.com"
37
- // path request path, e.g. "/platform/v2/x402/verify"
38
- function buildCdpBearerToken({ keyId, keySecret, method, host, path }) {
39
- const id = String(keyId || "").trim();
40
- if (!id) throw new Error("cdp_key_id_missing");
41
- const privateKey = privateKeyFromSecret(keySecret);
42
- const now = Math.floor(Date.now() / 1000);
43
- const header = { alg: "EdDSA", typ: "JWT", kid: id, nonce: crypto.randomBytes(16).toString("hex") };
44
- const claims = {
45
- sub: id,
46
- iss: "cdp",
47
- aud: ["cdp_service"],
48
- nbf: now,
49
- exp: now + 120,
50
- uri: `${String(method || "POST").toUpperCase()} ${host}${path}`
51
- };
52
- const signingInput = `${base64url(JSON.stringify(header))}.${base64url(JSON.stringify(claims))}`;
53
- const signature = crypto.sign(null, Buffer.from(signingInput), privateKey);
54
- return `${signingInput}.${base64url(signature)}`;
55
- }
56
-
57
- module.exports = { buildCdpBearerToken, base64url };
@@ -1,142 +0,0 @@
1
- "use strict";
2
-
3
- const crypto = require("crypto");
4
-
5
- function normalizeString(value) {
6
- return typeof value === "string" ? value.trim() : "";
7
- }
8
-
9
- function parseBoolean(value, fallback) {
10
- const normalized = normalizeString(value).toLowerCase();
11
- if (!normalized) return fallback;
12
- if (["1", "true", "yes", "on"].includes(normalized)) return true;
13
- if (["0", "false", "no", "off"].includes(normalized)) return false;
14
- return fallback;
15
- }
16
-
17
- function safeEqualHex(left, right) {
18
- const leftNormalized = normalizeString(left).toLowerCase();
19
- const rightNormalized = normalizeString(right).toLowerCase();
20
- if (!leftNormalized || !rightNormalized || leftNormalized.length !== rightNormalized.length) return false;
21
- try {
22
- return crypto.timingSafeEqual(Buffer.from(leftNormalized, "hex"), Buffer.from(rightNormalized, "hex"));
23
- } catch (_error) {
24
- return false;
25
- }
26
- }
27
-
28
- function loadCheckoutEventSecurityConfig() {
29
- const secret = normalizeString(process.env.XYTARA_CHECKOUT_WEBHOOK_SECRET || process.env.XYTARA_HOSTED_CHECKOUT_WEBHOOK_SECRET);
30
- const verificationRequired = parseBoolean(
31
- process.env.XYTARA_CHECKOUT_WEBHOOK_VERIFICATION_REQUIRED,
32
- secret.length > 0
33
- );
34
- const maxAgeSeconds = Math.max(30, Number(process.env.XYTARA_CHECKOUT_WEBHOOK_MAX_AGE_SECONDS || 300) || 300);
35
- return {
36
- secret: secret || null,
37
- verification_required: verificationRequired,
38
- max_age_seconds: maxAgeSeconds,
39
- signature_header: "x-xytara-checkout-signature",
40
- timestamp_header: "x-xytara-checkout-timestamp",
41
- signature_mode: "hmac_sha256_timestamped"
42
- };
43
- }
44
-
45
- function buildCheckoutEventSecuritySummary() {
46
- const config = loadCheckoutEventSecurityConfig();
47
- const blockers = [];
48
- if (config.verification_required && !config.secret) blockers.push("checkout_webhook_secret_missing");
49
- return {
50
- ok: true,
51
- category: "machine-commerce-checkout-event-security-summary",
52
- summary_version: "xytara-checkout-event-security-summary-v1",
53
- verification_required: config.verification_required,
54
- secret_configured: Boolean(config.secret),
55
- max_age_seconds: config.max_age_seconds,
56
- signature_header: config.signature_header,
57
- timestamp_header: config.timestamp_header,
58
- signature_mode: config.signature_mode,
59
- ready: Boolean(config.secret),
60
- blockers,
61
- operator_guidance: config.verification_required
62
- ? "sign checkout event payloads with the configured webhook secret before forwarding them into xytara"
63
- : "configure XYTARA_CHECKOUT_WEBHOOK_SECRET and keep verification required when hosted checkout is live"
64
- };
65
- }
66
-
67
- function buildCheckoutEventSignature(rawBody, secret, timestamp) {
68
- return crypto.createHmac("sha256", secret).update(`${timestamp}.${rawBody}`).digest("hex");
69
- }
70
-
71
- function verifyCheckoutEventRequest(headers, rawBody) {
72
- const config = loadCheckoutEventSecurityConfig();
73
- const headerMap = headers && typeof headers === "object" ? headers : {};
74
- const signature = normalizeString(headerMap[config.signature_header]);
75
- const timestamp = normalizeString(headerMap[config.timestamp_header]);
76
-
77
- if (!config.verification_required && !config.secret) {
78
- return {
79
- ok: true,
80
- verification_mode: "verification_not_required",
81
- signature_mode: config.signature_mode
82
- };
83
- }
84
-
85
- if (!config.secret) {
86
- return {
87
- ok: false,
88
- reason: "checkout_webhook_secret_missing"
89
- };
90
- }
91
-
92
- if (!signature) {
93
- return {
94
- ok: false,
95
- reason: "checkout_webhook_signature_missing"
96
- };
97
- }
98
-
99
- if (!timestamp) {
100
- return {
101
- ok: false,
102
- reason: "checkout_webhook_timestamp_missing"
103
- };
104
- }
105
-
106
- const timestampMs = Date.parse(timestamp);
107
- if (!Number.isFinite(timestampMs)) {
108
- return {
109
- ok: false,
110
- reason: "checkout_webhook_timestamp_invalid"
111
- };
112
- }
113
-
114
- const ageSeconds = Math.abs(Date.now() - timestampMs) / 1000;
115
- if (ageSeconds > config.max_age_seconds) {
116
- return {
117
- ok: false,
118
- reason: "checkout_webhook_timestamp_expired"
119
- };
120
- }
121
-
122
- const expected = buildCheckoutEventSignature(rawBody, config.secret, timestamp);
123
- if (!safeEqualHex(expected, signature)) {
124
- return {
125
- ok: false,
126
- reason: "checkout_webhook_signature_invalid"
127
- };
128
- }
129
-
130
- return {
131
- ok: true,
132
- verification_mode: "timestamped_hmac",
133
- signature_mode: config.signature_mode
134
- };
135
- }
136
-
137
- module.exports = {
138
- buildCheckoutEventSecuritySummary,
139
- buildCheckoutEventSignature,
140
- loadCheckoutEventSecurityConfig,
141
- verifyCheckoutEventRequest
142
- };
@@ -1,217 +0,0 @@
1
- "use strict";
2
-
3
- // Provider-agnostic hosted-checkout processor adapter (fiat money-in).
4
- //
5
- // Turns the synthetic hosted-checkout scaffold into a real fiat rail WITHOUT
6
- // provider lock-in and WITHOUT changing existing behavior: it engages only when
7
- // env configures a processor. When unconfigured, every function reports
8
- // "not configured" and the caller preserves the current synthetic flow.
9
- //
10
- // First provider: Stripe (Checkout Sessions + webhooks). Dependency-free
11
- // (node https + crypto). To add another processor, extend the provider
12
- // switches below; nothing else changes.
13
- //
14
- // Env:
15
- // XYTARA_CHECKOUT_PROCESSOR = "stripe" (unset/empty => not configured)
16
- // STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET
17
- // XYTARA_CHECKOUT_SUCCESS_URL, XYTARA_CHECKOUT_CANCEL_URL
18
- // XYTARA_CHECKOUT_PRODUCT_NAME (optional), STRIPE_WEBHOOK_TOLERANCE_SECONDS (optional)
19
-
20
- const https = require("https");
21
- const crypto = require("crypto");
22
-
23
- function env(name) {
24
- const v = process.env[name];
25
- return typeof v === "string" && v.trim() ? v.trim() : "";
26
- }
27
-
28
- function loadCheckoutProcessorConfig() {
29
- const provider = env("XYTARA_CHECKOUT_PROCESSOR").toLowerCase();
30
- if (provider === "stripe") {
31
- return {
32
- provider: "stripe",
33
- secretKey: env("STRIPE_SECRET_KEY"),
34
- webhookSecret: env("STRIPE_WEBHOOK_SECRET"),
35
- successUrl: env("XYTARA_CHECKOUT_SUCCESS_URL") || env("STRIPE_SUCCESS_URL"),
36
- cancelUrl: env("XYTARA_CHECKOUT_CANCEL_URL") || env("STRIPE_CANCEL_URL"),
37
- productName: env("XYTARA_CHECKOUT_PRODUCT_NAME") || "naxytra runtime credits",
38
- webhookToleranceSeconds: Math.max(60, Number(env("STRIPE_WEBHOOK_TOLERANCE_SECONDS") || 300) || 300)
39
- };
40
- }
41
- return { provider: null };
42
- }
43
-
44
- function isConfigured(config) {
45
- return Boolean(config && config.provider);
46
- }
47
-
48
- function normalizeCurrency(currency) {
49
- const c = String(currency || "usd").toLowerCase();
50
- // The runtime books some prices as USD_CENTS; the minor-unit amount is already
51
- // in cents, so the processor currency is plain "usd".
52
- return c === "usd_cents" ? "usd" : c;
53
- }
54
-
55
- // Minimal form-encoded POST to Stripe. Resolves { status, json, raw }.
56
- function stripePost(path, formParams, secretKey, timeoutMs) {
57
- const body = new URLSearchParams(formParams).toString();
58
- return new Promise((resolve, reject) => {
59
- const req = https.request(
60
- {
61
- method: "POST",
62
- hostname: "api.stripe.com",
63
- path,
64
- headers: {
65
- Authorization: "Bearer " + secretKey,
66
- "Content-Type": "application/x-www-form-urlencoded",
67
- "Content-Length": Buffer.byteLength(body)
68
- }
69
- },
70
- (res) => {
71
- let data = "";
72
- res.on("data", (chunk) => {
73
- data += chunk;
74
- });
75
- res.on("end", () => {
76
- let json = null;
77
- try {
78
- json = data ? JSON.parse(data) : null;
79
- } catch (_) {
80
- json = null;
81
- }
82
- resolve({ status: res.statusCode, json, raw: data });
83
- });
84
- }
85
- );
86
- req.on("error", reject);
87
- req.setTimeout(timeoutMs || 15000, () => {
88
- req.destroy(new Error("stripe_request_timeout"));
89
- });
90
- req.write(body);
91
- req.end();
92
- });
93
- }
94
-
95
- // Create a real processor checkout session for a purchase intent.
96
- // `intent` = { amountMinor, currency, units, accountId, purchaseIntentId, successUrl?, cancelUrl? }
97
- // Returns { ok, checkout_url, checkout_reference, checkout_provider } | { ok:false, reason, detail? }.
98
- async function createProcessorCheckoutSession(config, intent) {
99
- if (!isConfigured(config)) return { ok: false, reason: "processor_not_configured" };
100
- if (config.provider === "stripe") {
101
- if (!config.secretKey) return { ok: false, reason: "stripe_secret_key_missing" };
102
- const amountMinor = Number(intent && intent.amountMinor);
103
- if (!Number.isFinite(amountMinor) || amountMinor <= 0) return { ok: false, reason: "invalid_amount" };
104
- const successUrl = (intent && intent.successUrl) || config.successUrl;
105
- const cancelUrl = (intent && intent.cancelUrl) || config.cancelUrl;
106
- if (!successUrl || !cancelUrl) return { ok: false, reason: "success_or_cancel_url_missing" };
107
- const params = {
108
- mode: "payment",
109
- success_url: successUrl,
110
- cancel_url: cancelUrl,
111
- "line_items[0][quantity]": "1",
112
- "line_items[0][price_data][currency]": normalizeCurrency(intent.currency),
113
- "line_items[0][price_data][unit_amount]": String(Math.round(amountMinor)),
114
- "line_items[0][price_data][product_data][name]": config.productName,
115
- "metadata[purchase_intent_id]": String((intent && intent.purchaseIntentId) || ""),
116
- "metadata[account_id]": String((intent && intent.accountId) || ""),
117
- "metadata[credits_units]": String((intent && intent.units) || "")
118
- };
119
- let res;
120
- try {
121
- res = await stripePost("/v1/checkout/sessions", params, config.secretKey, 15000);
122
- } catch (e) {
123
- return { ok: false, reason: "stripe_unreachable", detail: e && e.message ? e.message : "request_error" };
124
- }
125
- if (!res.json || res.status >= 400) {
126
- const detail = res.json && res.json.error ? res.json.error.message : `HTTP ${res.status}`;
127
- return { ok: false, reason: "stripe_session_create_failed", detail };
128
- }
129
- return { ok: true, checkout_url: res.json.url, checkout_reference: res.json.id, checkout_provider: "stripe" };
130
- }
131
- return { ok: false, reason: "unsupported_processor" };
132
- }
133
-
134
- // Verify a processor webhook request. Returns { ok, event } | { ok:false, reason }.
135
- // Uses the PROCESSOR's own signature scheme (Stripe: Stripe-Signature "t=,v1=").
136
- function verifyProcessorWebhook(config, headers, rawBody) {
137
- if (!isConfigured(config)) return { ok: false, reason: "processor_not_configured" };
138
- if (config.provider === "stripe") {
139
- if (!config.webhookSecret) return { ok: false, reason: "stripe_webhook_secret_missing" };
140
- const lower = {};
141
- for (const k in headers || {}) lower[k.toLowerCase()] = headers[k];
142
- const sigHeader = String(lower["stripe-signature"] || "");
143
- const parts = {};
144
- sigHeader.split(",").forEach((piece) => {
145
- const idx = piece.indexOf("=");
146
- if (idx === -1) return;
147
- const k = piece.slice(0, idx).trim();
148
- const v = piece.slice(idx + 1).trim();
149
- (parts[k] = parts[k] || []).push(v);
150
- });
151
- const t = parts.t && parts.t[0];
152
- const v1s = parts.v1 || [];
153
- if (!t || !v1s.length) return { ok: false, reason: "stripe_signature_malformed" };
154
- const ageSeconds = Math.abs(Date.now() / 1000 - Number(t));
155
- if (!Number.isFinite(ageSeconds) || ageSeconds > config.webhookToleranceSeconds) {
156
- return { ok: false, reason: "stripe_timestamp_out_of_tolerance" };
157
- }
158
- const expected = crypto.createHmac("sha256", config.webhookSecret).update(`${t}.${rawBody}`, "utf8").digest("hex");
159
- const match = v1s.some((v) => {
160
- try {
161
- return v.length === expected.length && crypto.timingSafeEqual(Buffer.from(v, "hex"), Buffer.from(expected, "hex"));
162
- } catch (_) {
163
- return false;
164
- }
165
- });
166
- if (!match) return { ok: false, reason: "stripe_signature_invalid" };
167
- let event = null;
168
- try {
169
- event = JSON.parse(rawBody);
170
- } catch (_) {
171
- return { ok: false, reason: "stripe_body_not_json" };
172
- }
173
- return { ok: true, event };
174
- }
175
- return { ok: false, reason: "unsupported_processor" };
176
- }
177
-
178
- // Build the Stripe-Signature header value for a raw body (used by tests and by
179
- // anyone generating a signed event). Not used in production verification.
180
- function buildStripeSignatureHeader(webhookSecret, rawBody, timestampSeconds) {
181
- const t = String(timestampSeconds || Math.floor(Date.now() / 1000));
182
- const v1 = crypto.createHmac("sha256", webhookSecret).update(`${t}.${rawBody}`, "utf8").digest("hex");
183
- return `t=${t},v1=${v1}`;
184
- }
185
-
186
- // Translate a verified webhook event into a credit-grant body (matches
187
- // createExternalCreditGrant), or null when it is not a completed payment.
188
- function mapProcessorEventToGrant(config, event) {
189
- if (!isConfigured(config) || !event || typeof event !== "object") return null;
190
- if (config.provider === "stripe") {
191
- if (event.type !== "checkout.session.completed") return null;
192
- const s = (event.data && event.data.object) || {};
193
- if (s.payment_status !== "paid") return null;
194
- const md = s.metadata || {};
195
- return {
196
- account_id: md.account_id || null,
197
- units: Number(md.credits_units) || null,
198
- source: "stripe",
199
- provider_reference: s.payment_intent || s.id || null,
200
- idempotency_key: "stripe:" + (event.id || s.id),
201
- amount_minor: Number(s.amount_total),
202
- currency: String(s.currency || "usd").toUpperCase(),
203
- purchase_intent_id: md.purchase_intent_id || null,
204
- metadata: { processor: "stripe", checkout_session_id: s.id, event_id: event.id }
205
- };
206
- }
207
- return null;
208
- }
209
-
210
- module.exports = {
211
- loadCheckoutProcessorConfig,
212
- isConfigured,
213
- createProcessorCheckoutSession,
214
- verifyProcessorWebhook,
215
- buildStripeSignatureHeader,
216
- mapProcessorEventToGrant
217
- };