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.
- package/README.md +120 -92
- package/RELEASE_NOTES.md +7 -3
- package/START_HERE.md +56 -224
- package/bin/xytara.js +21 -8
- package/client.js +79 -1
- package/lib/{delivery_receipt.js → delivery_receipt_verify.js} +14 -100
- package/package.json +25 -35
- package/scripts/verify_client.js +418 -0
- package/scripts/verify_release_candidate.js +146 -45
- package/.env.example +0 -173
- package/ADAPTER_START_HERE.md +0 -56
- package/BSV_TERANODE_PLATFORM_DISCONTINUITY_RUNBOOK.md +0 -126
- package/CARRIED_HANDOFF_DEMO.md +0 -60
- package/EXAMPLE_PATHS.md +0 -53
- package/FINAL_CONTRACT.md +0 -498
- package/PARTNER_READY_PATH.md +0 -71
- package/PUBLIC_DEMO_SCRIPT.md +0 -78
- package/REAL_PAYMENT_SETUP.md +0 -320
- package/SERVICE_CONTRACT.md +0 -419
- package/SUPABASE_RUNTIME_STATE_SETUP.md +0 -61
- package/TERMINOLOGY.md +0 -50
- package/WHY_XYTARA_XOONYA.md +0 -63
- package/XT1_EXECUTION_TRUTH_STANDARD.md +0 -78
- package/XYTARA_ADAPTER_PROTOCOL_TRUTH_MODEL.md +0 -75
- package/XYTARA_AUTONOMOUS_ENTRY_MODEL.md +0 -124
- package/XYTARA_DEFAULT_PATH_MODEL.md +0 -84
- package/XYTARA_EXECUTION_TRUTH_MODEL.md +0 -171
- package/XYTARA_PAYMENT_RAIL_TRUTH_MODEL.md +0 -68
- package/adapters/AUTHORING_GUIDE.md +0 -244
- package/adapters/ONBOARDING_POSTURE.md +0 -61
- package/adapters/THIRD_PARTY_SUBMISSION_PROCESS.md +0 -84
- package/adapters/adapter-manifest.schema.json +0 -283
- package/adapters/examples/example-execution-adapter.js +0 -61
- package/adapters/examples/example-execution-adapter.manifest.json +0 -81
- package/adapters/examples/example-settlement-adapter.js +0 -55
- package/adapters/examples/example-settlement-adapter.manifest.json +0 -78
- package/adapters/examples/example-third-party-acp-registration.submission-bundle.json +0 -124
- package/adapters/examples/example-third-party-erc8004-registration.submission-bundle.json +0 -121
- package/adapters/examples/example-third-party-identity-registration.certification-pack.json +0 -22
- package/adapters/examples/example-third-party-identity-registration.record.json +0 -26
- package/adapters/examples/example-third-party-identity-registration.submission-bundle.json +0 -126
- package/adapters/examples/example-third-party-langchain-registration.submission-bundle.json +0 -124
- package/adapters/examples/example-third-party-mpp-registration.submission-bundle.json +0 -120
- package/adapters/examples/example-third-party-registration.certification-pack.json +0 -22
- package/adapters/examples/example-third-party-registration.record.json +0 -28
- package/adapters/examples/example-third-party-registration.submission-bundle.json +0 -126
- package/adapters/examples/example-third-party-settlement-registration.certification-pack.json +0 -22
- package/adapters/examples/example-third-party-settlement-registration.record.json +0 -26
- package/adapters/examples/example-third-party-settlement-registration.submission-bundle.json +0 -127
- package/adapters/examples/langchain-reference-execution-adapter.js +0 -81
- package/adapters/examples/langchain-reference-execution-adapter.manifest.json +0 -79
- package/adapters/examples/langgraph-reference-execution-adapter.js +0 -81
- package/adapters/examples/langgraph-reference-execution-adapter.manifest.json +0 -79
- package/adapters/examples/minimal-third-party-execution-adapter.js +0 -61
- package/adapters/examples/minimal-third-party-execution-adapter.manifest.json +0 -79
- package/adapters/examples/minimal-third-party-execution-registration.record.json +0 -26
- package/adapters/examples/minimal-third-party-execution.certification-pack.json +0 -22
- package/adapters/examples/minimal-third-party-execution.submission-bundle.json +0 -126
- package/adapters/integration-certification-pack.schema.json +0 -82
- package/adapters/integration-registration-record.schema.json +0 -114
- package/adapters/integration-submission-bundle-set.schema.json +0 -39
- package/adapters/integration-submission-bundle.schema.json +0 -34
- package/adapters/interfaces.js +0 -56
- package/bin/xytara-release.js +0 -1429
- package/examples/_demo_env.js +0 -40
- package/examples/adapter_review_walkthrough.js +0 -54
- package/examples/export_carried_handoff.js +0 -81
- package/examples/funded_runtime_walkthrough.js +0 -71
- package/examples/partner_launch_walkthrough.js +0 -44
- package/examples/quickstart.js +0 -3256
- package/fixtures/catalog.js +0 -1156
- package/index.js +0 -395
- package/integrations/dispatch.js +0 -276
- package/integrations/registry-snapshot.schema.json +0 -36
- package/integrations/registry.js +0 -2261
- package/integrations/views.js +0 -28
- package/lib/a2a_lane_contract.js +0 -104
- package/lib/a2a_rpc.js +0 -287
- package/lib/a2c_lane_contract.js +0 -111
- package/lib/account_auth.js +0 -585
- package/lib/acp_lane_contract.js +0 -54
- package/lib/activity_audit_contract.js +0 -322
- package/lib/adapter_certification_contract.js +0 -130
- package/lib/adapter_depth_contract.js +0 -218
- package/lib/adapter_pack.js +0 -118
- package/lib/adapter_partner_pack.js +0 -89
- package/lib/adapter_promotion_pack.js +0 -89
- package/lib/adapter_protocol_truth_contract.js +0 -229
- package/lib/agent_identity.js +0 -162
- package/lib/announcement_pack.js +0 -61
- package/lib/artifact_distribution_lane_contract.js +0 -54
- package/lib/asyncapi_contract.js +0 -150
- package/lib/auth_interop_contract.js +0 -80
- package/lib/authority_binding_lifecycle_contract.js +0 -182
- package/lib/autonomous_entry_contract.js +0 -409
- package/lib/bolt_adapter.js +0 -187
- package/lib/bolt_lane_contract.js +0 -55
- package/lib/bolt_payment_front.js +0 -224
- package/lib/business_cockpit.js +0 -378
- package/lib/buyer_event_log.js +0 -230
- package/lib/buyer_safety_policy.js +0 -132
- package/lib/capability_execution_truth.js +0 -276
- package/lib/capability_registry.js +0 -633
- package/lib/catalog_contract.js +0 -966
- package/lib/catalog_family_model.js +0 -193
- package/lib/catalog_views.js +0 -55
- package/lib/cdp_jwt.js +0 -57
- package/lib/checkout_event_security.js +0 -142
- package/lib/checkout_processor_adapter.js +0 -217
- package/lib/cloudevents_contract.js +0 -80
- package/lib/command_flow.js +0 -911
- package/lib/commerce_artifacts.js +0 -591
- package/lib/commerce_authority.js +0 -449
- package/lib/commerce_bridge.js +0 -274
- package/lib/commerce_cases.js +0 -399
- package/lib/commerce_checkout.js +0 -509
- package/lib/commerce_coordination.js +0 -346
- package/lib/commerce_economics.js +0 -4017
- package/lib/commerce_identity.js +0 -578
- package/lib/commerce_quotes.js +0 -266
- package/lib/commerce_reports.js +0 -14461
- package/lib/commerce_runtime.js +0 -322
- package/lib/commerce_shell.js +0 -257
- package/lib/crypto_agility_matrix.js +0 -125
- package/lib/default_path_contract.js +0 -412
- package/lib/delivery_summary_contract.js +0 -95
- package/lib/ecosystem_entry.js +0 -64
- package/lib/erc8004_lane_contract.js +0 -65
- package/lib/event_system_lane_contract.js +0 -75
- package/lib/execution_dedupe.js +0 -86
- package/lib/execution_truth_contract.js +0 -234
- package/lib/external_credit_bridge.js +0 -142
- package/lib/external_execution_policy.js +0 -143
- package/lib/external_execution_runtime.js +0 -238
- package/lib/feature_control_lane_contract.js +0 -54
- package/lib/first_run_conversion_contract.js +0 -290
- package/lib/framework_lane_contract.js +0 -89
- package/lib/framework_provider_promotion.js +0 -235
- package/lib/full_catalog_contract.js +0 -525
- package/lib/go_live_operator_pack.js +0 -391
- package/lib/http_transport.js +0 -99
- package/lib/identity_auth.js +0 -175
- package/lib/identity_interop_contract.js +0 -82
- package/lib/integration_matrix_contract.js +0 -102
- package/lib/l402_adapter.js +0 -241
- package/lib/l402_lane_contract.js +0 -55
- package/lib/l402_payment_front.js +0 -265
- package/lib/launch_narrative.js +0 -53
- package/lib/lifecycle_continuity_contract.js +0 -115
- package/lib/machine_identity_registry_contract.js +0 -199
- package/lib/major_rails_lane_contract.js +0 -150
- package/lib/market_lane_contract.js +0 -467
- package/lib/market_lane_depth_contract.js +0 -182
- package/lib/market_lane_promotion_contract.js +0 -210
- package/lib/market_lane_trace_contract.js +0 -278
- package/lib/mcp_lane_contract.js +0 -137
- package/lib/mpp_adapter.js +0 -237
- package/lib/network_transport.js +0 -110
- package/lib/offline_verifiability_recovery_contract.js +0 -155
- package/lib/openapi_contract.js +0 -300
- package/lib/operational_receipt_contract.js +0 -165
- package/lib/operator_intelligence.js +0 -407
- package/lib/outreach_copy_pack.js +0 -51
- package/lib/outreach_message_pack.js +0 -71
- package/lib/outreach_proof.js +0 -71
- package/lib/outreach_target_pack.js +0 -60
- package/lib/partner_intelligence.js +0 -105
- package/lib/payment_config.js +0 -257
- package/lib/payment_front_registry.js +0 -53
- package/lib/payment_protocol_contract.js +0 -165
- package/lib/payment_rail_truth_contract.js +0 -324
- package/lib/payment_verification.js +0 -357
- package/lib/phase_10_closeout_pack.js +0 -45
- package/lib/phase_10_completion_pack.js +0 -76
- package/lib/phase_10_decision_record_pack.js +0 -54
- package/lib/phase_10_decision_resolution_pack.js +0 -53
- package/lib/phase_10_demand_signal_adapters_runtime_pack.js +0 -74
- package/lib/phase_10_ecosystem_backlog_triage_runtime_pack.js +0 -74
- package/lib/phase_10_freeze_baseline_pack.js +0 -67
- package/lib/phase_10_freeze_review_pack.js +0 -64
- package/lib/phase_10_gate_pack.js +0 -57
- package/lib/phase_10_long_tail_continuity_pack.js +0 -80
- package/lib/phase_10_long_tail_ecosystem_pack.js +0 -66
- package/lib/phase_10_niche_extension_registry_runtime_pack.js +0 -74
- package/lib/phase_1_claude_mcp_pack.js +0 -60
- package/lib/phase_1_claude_mcp_runtime_pack.js +0 -52
- package/lib/phase_1_ecosystem_pack.js +0 -67
- package/lib/phase_1_openai_codex_pack.js +0 -60
- package/lib/phase_1_openai_codex_runtime_pack.js +0 -52
- package/lib/phase_2_base_runtime_pack.js +0 -71
- package/lib/phase_2_base_usdc_runtime_pack.js +0 -72
- package/lib/phase_2_closeout_pack.js +0 -65
- package/lib/phase_2_completion_pack.js +0 -113
- package/lib/phase_2_decision_record_pack.js +0 -66
- package/lib/phase_2_decision_resolution_pack.js +0 -69
- package/lib/phase_2_eth_runtime_pack.js +0 -70
- package/lib/phase_2_evm_base_runtime_pack.js +0 -73
- package/lib/phase_2_evm_runtime_pack.js +0 -71
- package/lib/phase_2_flip_preview_pack.js +0 -60
- package/lib/phase_2_freeze_review_pack.js +0 -99
- package/lib/phase_2_gate_pack.js +0 -77
- package/lib/phase_2_payment_rails_pack.js +0 -71
- package/lib/phase_2_usdc_runtime_pack.js +0 -71
- package/lib/phase_3_brc_runtime_pack.js +0 -81
- package/lib/phase_3_bsv_teranode_runtime_pack.js +0 -83
- package/lib/phase_3_closeout_pack.js +0 -62
- package/lib/phase_3_completion_pack.js +0 -94
- package/lib/phase_3_decision_record_pack.js +0 -64
- package/lib/phase_3_decision_resolution_pack.js +0 -69
- package/lib/phase_3_freeze_baseline_pack.js +0 -67
- package/lib/phase_3_freeze_review_pack.js +0 -80
- package/lib/phase_3_gate_pack.js +0 -76
- package/lib/phase_3_metanet_runtime_pack.js +0 -81
- package/lib/phase_3_native_bsv_pack.js +0 -91
- package/lib/phase_3_native_continuity_pack.js +0 -82
- package/lib/phase_4_attestation_runtime_pack.js +0 -75
- package/lib/phase_4_closeout_pack.js +0 -45
- package/lib/phase_4_completion_pack.js +0 -94
- package/lib/phase_4_decision_record_pack.js +0 -54
- package/lib/phase_4_decision_resolution_pack.js +0 -45
- package/lib/phase_4_erc8004_runtime_pack.js +0 -76
- package/lib/phase_4_freeze_baseline_pack.js +0 -67
- package/lib/phase_4_freeze_review_pack.js +0 -68
- package/lib/phase_4_gate_pack.js +0 -58
- package/lib/phase_4_identity_registry_runtime_pack.js +0 -75
- package/lib/phase_4_identity_trust_pack.js +0 -73
- package/lib/phase_4_trust_continuity_pack.js +0 -86
- package/lib/phase_5_antelope_runtime_pack.js +0 -76
- package/lib/phase_5_closeout_pack.js +0 -44
- package/lib/phase_5_completion_pack.js +0 -82
- package/lib/phase_5_constellation_dag_runtime_pack.js +0 -76
- package/lib/phase_5_decision_record_pack.js +0 -54
- package/lib/phase_5_decision_resolution_pack.js +0 -45
- package/lib/phase_5_digibyte_dgb_runtime_pack.js +0 -76
- package/lib/phase_5_freeze_baseline_pack.js +0 -67
- package/lib/phase_5_freeze_review_pack.js +0 -68
- package/lib/phase_5_gate_pack.js +0 -58
- package/lib/phase_5_hedera_hbar_runtime_pack.js +0 -76
- package/lib/phase_5_kaspa_kas_runtime_pack.js +0 -76
- package/lib/phase_5_major_rails_continuity_pack.js +0 -86
- package/lib/phase_5_major_rails_pack.js +0 -110
- package/lib/phase_5_metal_runtime_pack.js +0 -76
- package/lib/phase_5_polkadot_dot_runtime_pack.js +0 -76
- package/lib/phase_5_proton_xpr_runtime_pack.js +0 -76
- package/lib/phase_5_solana_runtime_pack.js +0 -76
- package/lib/phase_6_autogen_runtime_pack.js +0 -72
- package/lib/phase_6_closeout_pack.js +0 -46
- package/lib/phase_6_completion_pack.js +0 -77
- package/lib/phase_6_decision_record_pack.js +0 -54
- package/lib/phase_6_decision_resolution_pack.js +0 -53
- package/lib/phase_6_framework_continuity_pack.js +0 -81
- package/lib/phase_6_framework_runtime_pack.js +0 -68
- package/lib/phase_6_freeze_baseline_pack.js +0 -68
- package/lib/phase_6_freeze_review_pack.js +0 -65
- package/lib/phase_6_gate_pack.js +0 -59
- package/lib/phase_6_langchain_runtime_pack.js +0 -72
- package/lib/phase_6_langgraph_runtime_pack.js +0 -72
- package/lib/phase_6_semantic_kernel_runtime_pack.js +0 -72
- package/lib/phase_7_closeout_pack.js +0 -45
- package/lib/phase_7_completion_pack.js +0 -85
- package/lib/phase_7_decision_record_pack.js +0 -53
- package/lib/phase_7_decision_resolution_pack.js +0 -53
- package/lib/phase_7_event_system_continuity_pack.js +0 -89
- package/lib/phase_7_event_system_pack.js +0 -76
- package/lib/phase_7_freeze_baseline_pack.js +0 -74
- package/lib/phase_7_freeze_review_pack.js +0 -65
- package/lib/phase_7_gate_pack.js +0 -58
- package/lib/phase_7_kafka_runtime_pack.js +0 -74
- package/lib/phase_7_mqtt_runtime_pack.js +0 -74
- package/lib/phase_7_nats_runtime_pack.js +0 -74
- package/lib/phase_7_webhook_event_bus_runtime_pack.js +0 -74
- package/lib/phase_8_closeout_pack.js +0 -46
- package/lib/phase_8_completion_pack.js +0 -82
- package/lib/phase_8_decision_record_pack.js +0 -54
- package/lib/phase_8_decision_resolution_pack.js +0 -53
- package/lib/phase_8_external_receipt_import_runtime_pack.js +0 -74
- package/lib/phase_8_external_result_import_runtime_pack.js +0 -74
- package/lib/phase_8_freeze_baseline_pack.js +0 -71
- package/lib/phase_8_freeze_review_pack.js +0 -64
- package/lib/phase_8_gate_pack.js +0 -58
- package/lib/phase_8_proof_bridge_continuity_pack.js +0 -86
- package/lib/phase_8_proof_bridges_pack.js +0 -72
- package/lib/phase_8_proof_bundle_normalization_runtime_pack.js +0 -74
- package/lib/phase_9_closeout_pack.js +0 -46
- package/lib/phase_9_completion_pack.js +0 -82
- package/lib/phase_9_custody_refs_runtime_pack.js +0 -74
- package/lib/phase_9_decision_record_pack.js +0 -54
- package/lib/phase_9_decision_resolution_pack.js +0 -53
- package/lib/phase_9_freeze_baseline_pack.js +0 -71
- package/lib/phase_9_freeze_review_pack.js +0 -64
- package/lib/phase_9_gate_pack.js +0 -58
- package/lib/phase_9_operator_accounting_bridges_runtime_pack.js +0 -74
- package/lib/phase_9_treasury_connectivity_pack.js +0 -72
- package/lib/phase_9_treasury_continuity_pack.js +0 -86
- package/lib/phase_9_treasury_destinations_runtime_pack.js +0 -74
- package/lib/phase_program_pack.js +0 -120
- package/lib/pricing_optimization_contract.js +0 -775
- package/lib/protocol_lane_contract.js +0 -117
- package/lib/provenance_lane_contract.js +0 -54
- package/lib/provider_lane_contract.js +0 -240
- package/lib/provider_network_contract.js +0 -149
- package/lib/provider_payout_execution.js +0 -155
- package/lib/provider_registry.js +0 -852
- package/lib/provider_runtime_journey_contract.js +0 -183
- package/lib/public_surface_policy_contract.js +0 -111
- package/lib/publish_plan.js +0 -51
- package/lib/rate_limiter.js +0 -81
- package/lib/record_queries.js +0 -48
- package/lib/release_candidate.js +0 -50
- package/lib/release_center.js +0 -1093
- package/lib/release_history.js +0 -205
- package/lib/release_manifest.js +0 -113
- package/lib/release_pack.js +0 -453
- package/lib/request_rate_limit.js +0 -144
- package/lib/resource_views.js +0 -31
- package/lib/revenue_launch_path_contract.js +0 -326
- package/lib/route_matchers.js +0 -34
- package/lib/route_params.js +0 -19
- package/lib/runtime_bridge.js +0 -124
- package/lib/runtime_operations_worker.js +0 -282
- package/lib/runtime_state_store.js +0 -495
- package/lib/settlement_bsv_live.js +0 -600
- package/lib/settlement_bsv_teranode.js +0 -117
- package/lib/settlement_lane_contract.js +0 -111
- package/lib/shared_signals_lane_contract.js +0 -54
- package/lib/signed_audit_provenance_contract.js +0 -83
- package/lib/soft_launch_pack.js +0 -78
- package/lib/stablecoin_lane_contract.js +0 -76
- package/lib/stripe_mpp_lane_contract.js +0 -96
- package/lib/stripe_mpp_payment_front.js +0 -258
- package/lib/telemetry_lane_contract.js +0 -54
- package/lib/treasury_destinations_contract.js +0 -764
- package/lib/treasury_egress_policy_contract.js +0 -91
- package/lib/treasury_lane_contract.js +0 -84
- package/lib/trust_portability_boundary_contract.js +0 -72
- package/lib/x402_facilitator.js +0 -198
- package/lib/x402_lane_contract.js +0 -136
- package/lib/x402_settlement_recovery.js +0 -175
- package/scripts/buyer_events_daily_report.js +0 -79
- package/scripts/registry_cli.js +0 -275
- package/scripts/state_backup_offsite.js +0 -196
- package/scripts/verify_a2a_rpc.js +0 -131
- package/scripts/verify_adapters.js +0 -554
- package/scripts/verify_agent_identity.js +0 -153
- package/scripts/verify_all.js +0 -4963
- package/scripts/verify_bolt_adapter.js +0 -128
- package/scripts/verify_buyer_event_log.js +0 -128
- package/scripts/verify_buyer_safety.js +0 -141
- package/scripts/verify_cdp_facilitator.js +0 -110
- package/scripts/verify_checkout_processor.js +0 -109
- package/scripts/verify_commerce_bridge.js +0 -177
- package/scripts/verify_control_plane_contracts.js +0 -34
- package/scripts/verify_control_plane_routes.js +0 -70
- package/scripts/verify_delivery_summary.js +0 -112
- package/scripts/verify_examples.js +0 -19
- package/scripts/verify_execution_dedupe.js +0 -189
- package/scripts/verify_execution_surfacing.js +0 -76
- package/scripts/verify_external_execution_retry.js +0 -140
- package/scripts/verify_final_activation.js +0 -191
- package/scripts/verify_first_run_conversions.js +0 -81
- package/scripts/verify_framework_provider_promotion.js +0 -152
- package/scripts/verify_full_catalog.js +0 -174
- package/scripts/verify_integrations.js +0 -620
- package/scripts/verify_l402_adapter.js +0 -86
- package/scripts/verify_lifecycle_continuity.js +0 -96
- package/scripts/verify_lifecycle_spend_binding.js +0 -88
- package/scripts/verify_market_lane_depth.js +0 -94
- package/scripts/verify_market_lane_promotion.js +0 -103
- package/scripts/verify_market_lane_traces.js +0 -98
- package/scripts/verify_market_lanes.js +0 -102
- package/scripts/verify_mpp_adapter.js +0 -128
- package/scripts/verify_operator_observability_boundary.js +0 -83
- package/scripts/verify_pricing_experiment_plan.js +0 -124
- package/scripts/verify_production_readiness.js +0 -268
- package/scripts/verify_provider_network.js +0 -819
- package/scripts/verify_provider_runtime_breadth.js +0 -109
- package/scripts/verify_provider_runtime_journeys.js +0 -111
- package/scripts/verify_rate_limiter.js +0 -52
- package/scripts/verify_refund_credit.js +0 -106
- package/scripts/verify_revenue_launch_paths.js +0 -105
- package/scripts/verify_runtime_durability.js +0 -52
- package/scripts/verify_runtime_state_guard.js +0 -117
- package/scripts/verify_service.js +0 -15421
- package/scripts/verify_settlement.js +0 -116
- package/scripts/verify_tooling.js +0 -1412
- package/scripts/verify_treasury_public_boundary.js +0 -97
- package/scripts/verify_verify_execute_settle.js +0 -209
- package/scripts/verify_x402_facilitator.js +0 -307
- package/scripts/verify_x402_settlement_recovery.js +0 -153
- package/server.js +0 -12245
package/lib/business_cockpit.js
DELETED
|
@@ -1,378 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
function normalizeString(value) {
|
|
4
|
-
return typeof value === "string" && value.trim() ? value.trim() : null;
|
|
5
|
-
}
|
|
6
|
-
|
|
7
|
-
function escapeHtml(value) {
|
|
8
|
-
return String(value == null ? "" : value)
|
|
9
|
-
.replace(/&/g, "&")
|
|
10
|
-
.replace(/</g, "<")
|
|
11
|
-
.replace(/>/g, ">")
|
|
12
|
-
.replace(/"/g, """)
|
|
13
|
-
.replace(/'/g, "'");
|
|
14
|
-
}
|
|
15
|
-
|
|
16
|
-
function parseWalletRegistryAccountId() {
|
|
17
|
-
try {
|
|
18
|
-
const raw = process.env.XYTARA_WALLET_REGISTRY_JSON;
|
|
19
|
-
if (!raw) return null;
|
|
20
|
-
const parsed = JSON.parse(raw);
|
|
21
|
-
if (!Array.isArray(parsed)) return null;
|
|
22
|
-
for (const entry of parsed) {
|
|
23
|
-
const accountId = normalizeString(entry && entry.account_id);
|
|
24
|
-
if (accountId) return accountId;
|
|
25
|
-
}
|
|
26
|
-
} catch (_) {
|
|
27
|
-
return null;
|
|
28
|
-
}
|
|
29
|
-
return null;
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
function resolveBusinessCockpitAccountId(inputAccountId) {
|
|
33
|
-
return normalizeString(inputAccountId)
|
|
34
|
-
|| normalizeString(process.env.XYTARA_VERIFY_ACCOUNT_ID)
|
|
35
|
-
|| normalizeString(process.env.XYTARA_TREASURY_ACCOUNT_ID)
|
|
36
|
-
|| parseWalletRegistryAccountId()
|
|
37
|
-
|| "acct_demo";
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
function buildBusinessCockpitPack(input) {
|
|
41
|
-
const body = input && typeof input === "object" && !Array.isArray(input) ? input : {};
|
|
42
|
-
const accountId = resolveBusinessCockpitAccountId(body.account_id);
|
|
43
|
-
const releaseSummary = body.release_summary || {};
|
|
44
|
-
const treasurySummary = body.treasury_summary || {};
|
|
45
|
-
const paymentTruthSummary = body.payment_truth_summary || {};
|
|
46
|
-
const autonomousEntrySummary = body.autonomous_entry_summary || {};
|
|
47
|
-
const deliverySummary = body.delivery_summary || {};
|
|
48
|
-
const operatorShellCenter = body.operator_shell_center || {};
|
|
49
|
-
const operatorShellSummary = body.operator_shell_summary || {};
|
|
50
|
-
const operatorObservabilitySummary = body.operator_observability_summary || {};
|
|
51
|
-
const operatorIntelligenceSummary = body.operator_intelligence_summary || {};
|
|
52
|
-
const runtimeDurabilitySummary = body.runtime_durability_summary || {};
|
|
53
|
-
const nativeSettlementReadinessSummary = body.native_settlement_readiness_summary || {};
|
|
54
|
-
const externalMonitoring = body.external_monitoring || {};
|
|
55
|
-
|
|
56
|
-
return {
|
|
57
|
-
ok: true,
|
|
58
|
-
product: "xytara",
|
|
59
|
-
category: "machine-commerce-business-cockpit-pack",
|
|
60
|
-
cockpit_version: "xytara-business-cockpit-v1",
|
|
61
|
-
generated_at_iso: new Date().toISOString(),
|
|
62
|
-
account_id: accountId,
|
|
63
|
-
auth_mode: body.auth_mode || "bearer",
|
|
64
|
-
posture: "private_operator_business_analytics",
|
|
65
|
-
release: {
|
|
66
|
-
version: releaseSummary.version || null,
|
|
67
|
-
category: releaseSummary.category || null,
|
|
68
|
-
install_command: releaseSummary.install_command || null,
|
|
69
|
-
verify_command: releaseSummary.verify_command || null,
|
|
70
|
-
release_cli: releaseSummary.release_cli || null,
|
|
71
|
-
summary: releaseSummary
|
|
72
|
-
},
|
|
73
|
-
operations: {
|
|
74
|
-
autonomous_entry_summary: autonomousEntrySummary,
|
|
75
|
-
delivery_summary: deliverySummary,
|
|
76
|
-
operator_shell_center: operatorShellCenter,
|
|
77
|
-
operator_shell_summary: operatorShellSummary,
|
|
78
|
-
operator_observability_summary: operatorObservabilitySummary,
|
|
79
|
-
operator_intelligence_summary: operatorIntelligenceSummary
|
|
80
|
-
},
|
|
81
|
-
treasury: {
|
|
82
|
-
treasury_summary: treasurySummary,
|
|
83
|
-
payment_truth_summary: paymentTruthSummary,
|
|
84
|
-
runtime_durability_summary: runtimeDurabilitySummary,
|
|
85
|
-
native_settlement_readiness_summary: nativeSettlementReadinessSummary
|
|
86
|
-
},
|
|
87
|
-
external_monitoring: externalMonitoring,
|
|
88
|
-
linked_surfaces: {
|
|
89
|
-
self_ref: `/v1/business-cockpit?account_id=${encodeURIComponent(accountId)}`,
|
|
90
|
-
summary_ref: `/v1/business-cockpit/summary?account_id=${encodeURIComponent(accountId)}`,
|
|
91
|
-
html_ref: `/business-cockpit?account_id=${encodeURIComponent(accountId)}`,
|
|
92
|
-
operator_shell_ref: `/v1/operator-shell/summary?account_id=${encodeURIComponent(accountId)}`,
|
|
93
|
-
operator_observability_ref: `/v1/operator-observability/summary?account_id=${encodeURIComponent(accountId)}`,
|
|
94
|
-
deliveries_ref: "/v1/deliveries/summary",
|
|
95
|
-
treasury_ref: "/v1/treasury-destinations/summary",
|
|
96
|
-
payment_truth_ref: "/v1/payment-rail-truth/summary",
|
|
97
|
-
autonomous_entry_ref: "/v1/autonomous-entry/summary",
|
|
98
|
-
runtime_durability_ref: "/v1/runtime/durability/summary",
|
|
99
|
-
native_settlement_readiness_ref: "/v1/settlement/bsv-teranode/readiness"
|
|
100
|
-
}
|
|
101
|
-
};
|
|
102
|
-
}
|
|
103
|
-
|
|
104
|
-
function summarizeBusinessCockpitPack(packInput) {
|
|
105
|
-
const pack = packInput && packInput.category === "machine-commerce-business-cockpit-pack"
|
|
106
|
-
? packInput
|
|
107
|
-
: buildBusinessCockpitPack(packInput);
|
|
108
|
-
const treasurySummary = pack.treasury.treasury_summary || {};
|
|
109
|
-
const paymentTruthSummary = pack.treasury.payment_truth_summary || {};
|
|
110
|
-
const deliverySummary = pack.operations.delivery_summary || {};
|
|
111
|
-
const operatorObservabilitySummary = pack.operations.operator_observability_summary || {};
|
|
112
|
-
const operatorIntelligenceSummary = pack.operations.operator_intelligence_summary || {};
|
|
113
|
-
const runtimeDurabilitySummary = pack.treasury.runtime_durability_summary || {};
|
|
114
|
-
const nativeSettlementReadinessSummary = pack.treasury.native_settlement_readiness_summary || {};
|
|
115
|
-
const externalMonitoring = pack.external_monitoring || {};
|
|
116
|
-
const externalHealth = Object.values(externalMonitoring).filter(Boolean);
|
|
117
|
-
const degradedExternal = externalHealth.filter((entry) => entry.ok === false).length;
|
|
118
|
-
|
|
119
|
-
return {
|
|
120
|
-
ok: true,
|
|
121
|
-
product: "xytara",
|
|
122
|
-
category: "machine-commerce-business-cockpit-pack-summary",
|
|
123
|
-
summary_version: "xytara-business-cockpit-pack-summary-v1",
|
|
124
|
-
account_id: pack.account_id,
|
|
125
|
-
release_version: pack.release.version || null,
|
|
126
|
-
public_live_landing_rail_count: paymentTruthSummary.public_live_landing_rail_count || 0,
|
|
127
|
-
claimable_treasury_profile_count: treasurySummary.public_claimable_profile_count || 0,
|
|
128
|
-
configured_treasury_profile_count: treasurySummary.configured_profile_count || 0,
|
|
129
|
-
delivery_count: deliverySummary.delivery_count || 0,
|
|
130
|
-
payment_count: operatorObservabilitySummary.payment_count || 0,
|
|
131
|
-
transaction_count: operatorObservabilitySummary.transaction_count || 0,
|
|
132
|
-
settlement_count: operatorObservabilitySummary.settlement_count || 0,
|
|
133
|
-
attention_item_count: operatorObservabilitySummary.attention_item_count || 0,
|
|
134
|
-
operator_state: operatorObservabilitySummary.operator_state || null,
|
|
135
|
-
intelligence_state: operatorIntelligenceSummary.operator_state || null,
|
|
136
|
-
runtime_snapshot_enabled: runtimeDurabilitySummary.enabled === true,
|
|
137
|
-
native_settlement_ready: nativeSettlementReadinessSummary.ready === true,
|
|
138
|
-
degraded_external_source_count: degradedExternal,
|
|
139
|
-
linked_surfaces: pack.linked_surfaces
|
|
140
|
-
};
|
|
141
|
-
}
|
|
142
|
-
|
|
143
|
-
function renderKeyValueRows(entry) {
|
|
144
|
-
return Object.entries(entry || {})
|
|
145
|
-
.map(([key, value]) => {
|
|
146
|
-
const rendered = Array.isArray(value)
|
|
147
|
-
? value.join(", ")
|
|
148
|
-
: value && typeof value === "object"
|
|
149
|
-
? JSON.stringify(value)
|
|
150
|
-
: String(value);
|
|
151
|
-
return `<tr><th>${escapeHtml(key)}</th><td>${escapeHtml(rendered)}</td></tr>`;
|
|
152
|
-
})
|
|
153
|
-
.join("");
|
|
154
|
-
}
|
|
155
|
-
|
|
156
|
-
function renderSummaryCards(summary) {
|
|
157
|
-
const cards = [
|
|
158
|
-
["Release", summary.release_version || "unknown"],
|
|
159
|
-
["Live Rails", summary.public_live_landing_rail_count || 0],
|
|
160
|
-
["Treasury Profiles", summary.claimable_treasury_profile_count || 0],
|
|
161
|
-
["Payments", summary.payment_count || 0],
|
|
162
|
-
["Transactions", summary.transaction_count || 0],
|
|
163
|
-
["Deliveries", summary.delivery_count || 0],
|
|
164
|
-
["Settlements", summary.settlement_count || 0],
|
|
165
|
-
["Attention", summary.attention_item_count || 0],
|
|
166
|
-
["BSV Ready", summary.native_settlement_ready ? "yes" : "no"],
|
|
167
|
-
["External Degraded", summary.degraded_external_source_count || 0]
|
|
168
|
-
];
|
|
169
|
-
return cards.map(([label, value]) => `
|
|
170
|
-
<section class="card">
|
|
171
|
-
<div class="card-label">${escapeHtml(label)}</div>
|
|
172
|
-
<div class="card-value">${escapeHtml(value)}</div>
|
|
173
|
-
</section>
|
|
174
|
-
`).join("");
|
|
175
|
-
}
|
|
176
|
-
|
|
177
|
-
function buildBusinessCockpitHtml(packInput) {
|
|
178
|
-
const pack = packInput && packInput.category === "machine-commerce-business-cockpit-pack"
|
|
179
|
-
? packInput
|
|
180
|
-
: buildBusinessCockpitPack(packInput);
|
|
181
|
-
const summary = summarizeBusinessCockpitPack(pack);
|
|
182
|
-
const externalRows = Object.entries(pack.external_monitoring || {}).map(([key, value]) => ({
|
|
183
|
-
source: key,
|
|
184
|
-
ok: value && value.ok === true ? "ok" : "degraded",
|
|
185
|
-
ref: value && value.ref ? value.ref : null,
|
|
186
|
-
status: value && value.status != null ? value.status : null,
|
|
187
|
-
reason: value && value.reason ? value.reason : null
|
|
188
|
-
}));
|
|
189
|
-
|
|
190
|
-
return `<!doctype html>
|
|
191
|
-
<html lang="en">
|
|
192
|
-
<head>
|
|
193
|
-
<meta charset="utf-8">
|
|
194
|
-
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
195
|
-
<title>xytara Business Cockpit</title>
|
|
196
|
-
<style>
|
|
197
|
-
:root {
|
|
198
|
-
color-scheme: light;
|
|
199
|
-
--bg: #f4f1ea;
|
|
200
|
-
--panel: #fffaf2;
|
|
201
|
-
--ink: #1c1b18;
|
|
202
|
-
--muted: #6e6759;
|
|
203
|
-
--line: #d9cfbf;
|
|
204
|
-
--accent: #0f766e;
|
|
205
|
-
--accent-2: #a16207;
|
|
206
|
-
}
|
|
207
|
-
* { box-sizing: border-box; }
|
|
208
|
-
body {
|
|
209
|
-
margin: 0;
|
|
210
|
-
font-family: Georgia, "Times New Roman", serif;
|
|
211
|
-
color: var(--ink);
|
|
212
|
-
background: radial-gradient(circle at top left, #fffdf7 0%, var(--bg) 60%);
|
|
213
|
-
}
|
|
214
|
-
.wrap {
|
|
215
|
-
max-width: 1180px;
|
|
216
|
-
margin: 0 auto;
|
|
217
|
-
padding: 28px 20px 48px;
|
|
218
|
-
}
|
|
219
|
-
.hero {
|
|
220
|
-
background: linear-gradient(135deg, #fffef9, #f4ede0);
|
|
221
|
-
border: 1px solid var(--line);
|
|
222
|
-
border-radius: 22px;
|
|
223
|
-
padding: 28px;
|
|
224
|
-
box-shadow: 0 20px 50px rgba(28, 27, 24, 0.06);
|
|
225
|
-
}
|
|
226
|
-
h1, h2 { margin: 0 0 10px; }
|
|
227
|
-
h1 { font-size: 2.3rem; }
|
|
228
|
-
h2 { font-size: 1.25rem; margin-top: 24px; }
|
|
229
|
-
p, li, td, th, code { line-height: 1.45; }
|
|
230
|
-
.muted { color: var(--muted); }
|
|
231
|
-
.grid {
|
|
232
|
-
display: grid;
|
|
233
|
-
grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
|
|
234
|
-
gap: 14px;
|
|
235
|
-
margin-top: 20px;
|
|
236
|
-
}
|
|
237
|
-
.card, .panel {
|
|
238
|
-
background: var(--panel);
|
|
239
|
-
border: 1px solid var(--line);
|
|
240
|
-
border-radius: 18px;
|
|
241
|
-
padding: 16px;
|
|
242
|
-
}
|
|
243
|
-
.card-label {
|
|
244
|
-
font-size: 0.85rem;
|
|
245
|
-
text-transform: uppercase;
|
|
246
|
-
letter-spacing: 0.08em;
|
|
247
|
-
color: var(--muted);
|
|
248
|
-
}
|
|
249
|
-
.card-value {
|
|
250
|
-
margin-top: 8px;
|
|
251
|
-
font-size: 1.8rem;
|
|
252
|
-
font-weight: 700;
|
|
253
|
-
}
|
|
254
|
-
.section-grid {
|
|
255
|
-
display: grid;
|
|
256
|
-
grid-template-columns: repeat(auto-fit, minmax(320px, 1fr));
|
|
257
|
-
gap: 18px;
|
|
258
|
-
margin-top: 20px;
|
|
259
|
-
}
|
|
260
|
-
table {
|
|
261
|
-
width: 100%;
|
|
262
|
-
border-collapse: collapse;
|
|
263
|
-
}
|
|
264
|
-
th, td {
|
|
265
|
-
text-align: left;
|
|
266
|
-
padding: 9px 0;
|
|
267
|
-
border-bottom: 1px solid var(--line);
|
|
268
|
-
vertical-align: top;
|
|
269
|
-
}
|
|
270
|
-
th {
|
|
271
|
-
width: 42%;
|
|
272
|
-
color: var(--muted);
|
|
273
|
-
font-weight: 600;
|
|
274
|
-
}
|
|
275
|
-
a { color: var(--accent); text-decoration: none; }
|
|
276
|
-
a:hover { text-decoration: underline; }
|
|
277
|
-
.token-note {
|
|
278
|
-
margin-top: 14px;
|
|
279
|
-
font-size: 0.95rem;
|
|
280
|
-
color: var(--accent-2);
|
|
281
|
-
}
|
|
282
|
-
.inline-list {
|
|
283
|
-
display: flex;
|
|
284
|
-
flex-wrap: wrap;
|
|
285
|
-
gap: 10px;
|
|
286
|
-
padding: 0;
|
|
287
|
-
margin: 12px 0 0;
|
|
288
|
-
list-style: none;
|
|
289
|
-
}
|
|
290
|
-
.inline-list li {
|
|
291
|
-
border: 1px solid var(--line);
|
|
292
|
-
border-radius: 999px;
|
|
293
|
-
padding: 8px 12px;
|
|
294
|
-
background: #fff;
|
|
295
|
-
}
|
|
296
|
-
.external-table th { width: 24%; }
|
|
297
|
-
</style>
|
|
298
|
-
</head>
|
|
299
|
-
<body>
|
|
300
|
-
<main class="wrap">
|
|
301
|
-
<section class="hero">
|
|
302
|
-
<h1>xytara Business Cockpit</h1>
|
|
303
|
-
<p class="muted">Private operator analytics across runtime operations, treasury landing, release posture, settlement readiness, and linked proof-facing health.</p>
|
|
304
|
-
<p><strong>Account scope:</strong> <code>${escapeHtml(pack.account_id)}</code> <span class="muted">| auth: ${escapeHtml(pack.auth_mode)}</span></p>
|
|
305
|
-
<div class="grid">${renderSummaryCards(summary)}</div>
|
|
306
|
-
<p class="token-note">This page is private. Open it with <code>Authorization: Bearer <token></code> or a tokenized cockpit URL you keep private.</p>
|
|
307
|
-
</section>
|
|
308
|
-
<section class="section-grid">
|
|
309
|
-
<article class="panel">
|
|
310
|
-
<h2>Release</h2>
|
|
311
|
-
<table>${renderKeyValueRows({
|
|
312
|
-
version: pack.release.version,
|
|
313
|
-
category: pack.release.category,
|
|
314
|
-
install_command: pack.release.install_command,
|
|
315
|
-
verify_command: pack.release.verify_command,
|
|
316
|
-
release_cli: pack.release.release_cli
|
|
317
|
-
})}</table>
|
|
318
|
-
</article>
|
|
319
|
-
<article class="panel">
|
|
320
|
-
<h2>Treasury</h2>
|
|
321
|
-
<table>${renderKeyValueRows({
|
|
322
|
-
configured_profile_count: pack.treasury.treasury_summary.configured_profile_count,
|
|
323
|
-
public_claimable_profile_count: pack.treasury.treasury_summary.public_claimable_profile_count,
|
|
324
|
-
readiness_only_profile_count: pack.treasury.treasury_summary.readiness_only_profile_count,
|
|
325
|
-
public_live_landing_rail_count: pack.treasury.payment_truth_summary.public_live_landing_rail_count,
|
|
326
|
-
native_settlement_ready: pack.treasury.native_settlement_readiness_summary.ready,
|
|
327
|
-
runtime_snapshot_enabled: pack.treasury.runtime_durability_summary.enabled
|
|
328
|
-
})}</table>
|
|
329
|
-
</article>
|
|
330
|
-
<article class="panel">
|
|
331
|
-
<h2>Operations</h2>
|
|
332
|
-
<table>${renderKeyValueRows({
|
|
333
|
-
payment_count: pack.operations.operator_observability_summary.payment_count,
|
|
334
|
-
transaction_count: pack.operations.operator_observability_summary.transaction_count,
|
|
335
|
-
delivery_count: pack.operations.delivery_summary.delivery_count,
|
|
336
|
-
settlement_count: pack.operations.operator_observability_summary.settlement_count,
|
|
337
|
-
attention_item_count: pack.operations.operator_observability_summary.attention_item_count,
|
|
338
|
-
operator_state: pack.operations.operator_observability_summary.operator_state
|
|
339
|
-
})}</table>
|
|
340
|
-
</article>
|
|
341
|
-
<article class="panel">
|
|
342
|
-
<h2>External Health</h2>
|
|
343
|
-
<table class="external-table">
|
|
344
|
-
<thead>
|
|
345
|
-
<tr><th>Source</th><th>Status</th><th>HTTP</th><th>Ref</th></tr>
|
|
346
|
-
</thead>
|
|
347
|
-
<tbody>
|
|
348
|
-
${externalRows.map((entry) => `
|
|
349
|
-
<tr>
|
|
350
|
-
<th>${escapeHtml(entry.source)}</th>
|
|
351
|
-
<td>${escapeHtml(entry.ok)}</td>
|
|
352
|
-
<td>${escapeHtml(entry.status == null ? "-" : entry.status)}</td>
|
|
353
|
-
<td>${entry.ref ? `<a href="${escapeHtml(entry.ref)}">${escapeHtml(entry.ref)}</a>` : escapeHtml(entry.reason || "-")}</td>
|
|
354
|
-
</tr>
|
|
355
|
-
`).join("")}
|
|
356
|
-
</tbody>
|
|
357
|
-
</table>
|
|
358
|
-
</article>
|
|
359
|
-
</section>
|
|
360
|
-
<section class="panel" style="margin-top: 18px;">
|
|
361
|
-
<h2>Quick Links</h2>
|
|
362
|
-
<ul class="inline-list">
|
|
363
|
-
${Object.entries(pack.linked_surfaces).map(([key, value]) => `
|
|
364
|
-
<li><strong>${escapeHtml(key)}</strong>: <a href="${escapeHtml(value)}">${escapeHtml(value)}</a></li>
|
|
365
|
-
`).join("")}
|
|
366
|
-
</ul>
|
|
367
|
-
</section>
|
|
368
|
-
</main>
|
|
369
|
-
</body>
|
|
370
|
-
</html>`;
|
|
371
|
-
}
|
|
372
|
-
|
|
373
|
-
module.exports = {
|
|
374
|
-
resolveBusinessCockpitAccountId,
|
|
375
|
-
buildBusinessCockpitPack,
|
|
376
|
-
summarizeBusinessCockpitPack,
|
|
377
|
-
buildBusinessCockpitHtml
|
|
378
|
-
};
|
package/lib/buyer_event_log.js
DELETED
|
@@ -1,230 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
const crypto = require("crypto");
|
|
4
|
-
|
|
5
|
-
// Buyer-journey event log: every failed buyer attempt (ours, upstream, or the buyer's) is recorded
|
|
6
|
-
// so the operator can see who tried to use the system and why it did not work — plus counters for
|
|
7
|
-
// the normal steps (402 challenges issued, paid calls served) as denominators.
|
|
8
|
-
//
|
|
9
|
-
// Privacy: events never carry payment signatures/headers, request bodies, tokens, IP addresses or
|
|
10
|
-
// full wallet addresses. Payer addresses are reduced to a salted hash prefix; detail text is
|
|
11
|
-
// truncated and stripped of long hex/base64 runs.
|
|
12
|
-
//
|
|
13
|
-
// Storage: state.buyerEventLog (bounded ring, newest last) and state.buyerEventDaily (per-day
|
|
14
|
-
// counters, 30 days) are ordinary runtime state, so they persist with the Supabase snapshot and the
|
|
15
|
-
// daily off-site backup. The MCP executor forwards its own events to POST /v1/operator/buyer-events/ingest.
|
|
16
|
-
|
|
17
|
-
const DAILY_RETENTION_DAYS = 30;
|
|
18
|
-
|
|
19
|
-
// Stages that are normal steps, not failures (the MCP executor sends these with no fault).
|
|
20
|
-
const STEP_STAGES = new Set(["challenge_issued", "paid_ok", "success", "free_ok", "replay_served"]);
|
|
21
|
-
|
|
22
|
-
function isStepEvent(event) {
|
|
23
|
-
const fault = event && event.fault;
|
|
24
|
-
return STEP_STAGES.has(String((event && event.stage) || "")) || fault === null || fault === undefined || fault === "" || fault === "none";
|
|
25
|
-
}
|
|
26
|
-
|
|
27
|
-
function maxEvents() {
|
|
28
|
-
const value = Number(process.env.XYTARA_BUYER_EVENT_LOG_MAX || 500);
|
|
29
|
-
return Number.isFinite(value) && value >= 10 ? Math.min(5000, Math.floor(value)) : 500;
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
function ensureBuyerEventCollections(state) {
|
|
33
|
-
if (!Array.isArray(state.buyerEventLog)) state.buyerEventLog = [];
|
|
34
|
-
if (!(state.buyerEventDaily instanceof Map)) state.buyerEventDaily = new Map();
|
|
35
|
-
}
|
|
36
|
-
|
|
37
|
-
function cleanText(value, max) {
|
|
38
|
-
if (value === null || value === undefined) return null;
|
|
39
|
-
const text = String(value)
|
|
40
|
-
.replace(/0x[0-9a-fA-F]{40,}/g, "0x…")
|
|
41
|
-
.replace(/[A-Za-z0-9+/=_-]{40,}/g, "…")
|
|
42
|
-
.replace(/\s+/g, " ")
|
|
43
|
-
.trim();
|
|
44
|
-
return text ? text.slice(0, max) : null;
|
|
45
|
-
}
|
|
46
|
-
|
|
47
|
-
function payerHash(address) {
|
|
48
|
-
const value = String(address || "").trim().toLowerCase();
|
|
49
|
-
if (!value) return null;
|
|
50
|
-
const salt = String(process.env.XYTARA_BUYER_EVENT_SALT || "naxytra-buyer-events");
|
|
51
|
-
return crypto.createHash("sha256").update(`${salt}:${value}`).digest("hex").slice(0, 12);
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
// Path template without ids: segments that look like identifiers become ":id".
|
|
55
|
-
function routeTemplate(pathname) {
|
|
56
|
-
return String(pathname || "/")
|
|
57
|
-
.split("/")
|
|
58
|
-
.map((segment) => (/(^0x[0-9a-f]{6,})|([0-9a-f]{12,})|(_[0-9a-z]{6,}$)|(^\d{3,}$)/i.test(segment) ? ":id" : segment))
|
|
59
|
-
.join("/")
|
|
60
|
-
.slice(0, 120);
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
// reason -> [stage, fault]. fault: "ours" (our bug/infra), "upstream" (facilitator, RPC, provider),
|
|
64
|
-
// "buyer" (bad input / bad payment), "none" (expected protocol step).
|
|
65
|
-
const REASON_RULES = [
|
|
66
|
-
[/^(capability_not_executable|task_ref_required|task_not_found|unknown_tool)/, "route", "buyer"],
|
|
67
|
-
[/^(body_must_be_valid_json|invalid_json|request_body_too_large)/, "parse", "buyer"],
|
|
68
|
-
[/^payment_(signature_invalid|requirements_mismatch|header)/, "payment_match", "buyer"],
|
|
69
|
-
[/^payment_authorization_in_progress/, "payment_verify", "buyer"],
|
|
70
|
-
[/^payment_verification_failed|^invalid_exact/, "payment_verify", "buyer"],
|
|
71
|
-
[/^facilitator_|_unreachable$/, "payment_verify", "upstream"],
|
|
72
|
-
[/^(payment_settlement_failed|settlement_failed|settle_)/, "payment_settle", "upstream"],
|
|
73
|
-
[/^(external_execution|no_healthy_provider|provider_)/, "provider", "upstream"],
|
|
74
|
-
[/^(insufficient_credits|credit_spend_|delegated_)/, "credit", "buyer"],
|
|
75
|
-
[/^agent_signature|^spend_credential|_bearer|^unauthorized|^forbidden/, "auth", "buyer"],
|
|
76
|
-
[/^rate_limit/, "rate_limit", "buyer"],
|
|
77
|
-
[/^(state_restore_pending|runtime_state)/, "state", "ours"],
|
|
78
|
-
[/^quote_(expired|already_used)/, "quote", "buyer"]
|
|
79
|
-
];
|
|
80
|
-
|
|
81
|
-
function classify(reason, httpStatus) {
|
|
82
|
-
const text = String(reason || "");
|
|
83
|
-
for (const [pattern, stage, fault] of REASON_RULES) {
|
|
84
|
-
if (pattern.test(text)) return { stage, fault };
|
|
85
|
-
}
|
|
86
|
-
if (httpStatus >= 500) return { stage: "internal", fault: "ours" };
|
|
87
|
-
if (httpStatus === 404) return { stage: "route", fault: "buyer" };
|
|
88
|
-
return { stage: "other", fault: httpStatus >= 400 && httpStatus < 500 ? "buyer" : "ours" };
|
|
89
|
-
}
|
|
90
|
-
|
|
91
|
-
function dayKey(iso) {
|
|
92
|
-
return String(iso).slice(0, 10);
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
function bumpDaily(state, iso, service, key) {
|
|
96
|
-
const day = dayKey(iso);
|
|
97
|
-
let bucket = state.buyerEventDaily.get(day);
|
|
98
|
-
if (!bucket) {
|
|
99
|
-
bucket = {};
|
|
100
|
-
state.buyerEventDaily.set(day, bucket);
|
|
101
|
-
// Drop days beyond retention (keys are ISO dates, so lexical order is chronological).
|
|
102
|
-
const days = Array.from(state.buyerEventDaily.keys()).sort();
|
|
103
|
-
while (days.length > DAILY_RETENTION_DAYS) state.buyerEventDaily.delete(days.shift());
|
|
104
|
-
}
|
|
105
|
-
const counterKey = `${service}|${key}`;
|
|
106
|
-
bucket[counterKey] = (Number(bucket[counterKey]) || 0) + 1;
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
// Count a normal step without logging an event (challenge issued, paid call served, ...).
|
|
110
|
-
function countBuyerStep(state, step, options = {}) {
|
|
111
|
-
try {
|
|
112
|
-
ensureBuyerEventCollections(state);
|
|
113
|
-
bumpDaily(state, new Date().toISOString(), options.service || "runtime", `step:${step}|${routeTemplate(options.route)}`);
|
|
114
|
-
} catch (_) { /* observability must never break a buyer response */ }
|
|
115
|
-
}
|
|
116
|
-
|
|
117
|
-
function recordBuyerEvent(state, input) {
|
|
118
|
-
try {
|
|
119
|
-
ensureBuyerEventCollections(state);
|
|
120
|
-
const at = typeof input.at_iso === "string" && !Number.isNaN(Date.parse(input.at_iso)) ? new Date(input.at_iso).toISOString() : new Date().toISOString();
|
|
121
|
-
const httpStatus = Number.isFinite(Number(input.http_status)) ? Number(input.http_status) : null;
|
|
122
|
-
const reason = cleanText(input.reason, 80) || (httpStatus ? `http_${httpStatus}` : "unknown");
|
|
123
|
-
const classified = classify(reason, httpStatus || 0);
|
|
124
|
-
const event = {
|
|
125
|
-
id: `bev_${crypto.randomBytes(6).toString("hex")}`,
|
|
126
|
-
at_iso: at,
|
|
127
|
-
service: cleanText(input.service, 40) || "runtime",
|
|
128
|
-
request_id: cleanText(input.request_id, 40),
|
|
129
|
-
stage: cleanText(input.stage, 30) || classified.stage,
|
|
130
|
-
reason,
|
|
131
|
-
fault: cleanText(input.fault, 10) || classified.fault,
|
|
132
|
-
http_status: httpStatus,
|
|
133
|
-
route: input.route ? routeTemplate(input.route) : null,
|
|
134
|
-
method: cleanText(input.method, 8),
|
|
135
|
-
task_or_tool: cleanText(input.task_or_tool, 80),
|
|
136
|
-
rail: cleanText(input.rail, 20),
|
|
137
|
-
network: cleanText(input.network, 30),
|
|
138
|
-
amount_atomic: /^\d{1,30}$/.test(String(input.amount_atomic || "")) ? String(input.amount_atomic) : null,
|
|
139
|
-
payer_hash: input.payer_hash ? cleanText(input.payer_hash, 16) : payerHash(input.payer),
|
|
140
|
-
money_moved: input.money_moved === true,
|
|
141
|
-
latency_ms: Number.isFinite(Number(input.latency_ms)) ? Math.round(Number(input.latency_ms)) : null,
|
|
142
|
-
detail: cleanText(input.detail, 160),
|
|
143
|
-
ua: cleanText(String(input.ua || "").split(/[\s/]/)[0], 32)
|
|
144
|
-
};
|
|
145
|
-
state.buyerEventLog.push(event);
|
|
146
|
-
const cap = maxEvents();
|
|
147
|
-
if (state.buyerEventLog.length > cap) state.buyerEventLog.splice(0, state.buyerEventLog.length - cap);
|
|
148
|
-
bumpDaily(state, at, event.service, `fail:${event.stage}:${event.reason}:${event.fault}`);
|
|
149
|
-
if (event.money_moved) bumpDaily(state, at, event.service, "money_moved");
|
|
150
|
-
return event;
|
|
151
|
-
} catch (_) {
|
|
152
|
-
return null;
|
|
153
|
-
}
|
|
154
|
-
}
|
|
155
|
-
|
|
156
|
-
function listBuyerEvents(state, query = {}) {
|
|
157
|
-
ensureBuyerEventCollections(state);
|
|
158
|
-
// (Older entries could be steps mis-filed as failures; never surface them as failures.)
|
|
159
|
-
const since = query.since && !Number.isNaN(Date.parse(query.since)) ? Date.parse(query.since) : null;
|
|
160
|
-
const limit = Math.max(1, Math.min(500, Number(query.limit) || 100));
|
|
161
|
-
const matches = state.buyerEventLog.filter((event) => {
|
|
162
|
-
if (STEP_STAGES.has(String(event.stage || ""))) return false;
|
|
163
|
-
if (since !== null && Date.parse(event.at_iso) < since) return false;
|
|
164
|
-
if (query.service && event.service !== query.service) return false;
|
|
165
|
-
if (query.stage && event.stage !== query.stage) return false;
|
|
166
|
-
if (query.fault && event.fault !== query.fault) return false;
|
|
167
|
-
if (query.money_moved === "true" && !event.money_moved) return false;
|
|
168
|
-
return true;
|
|
169
|
-
});
|
|
170
|
-
return { count: matches.length, events: matches.slice(-limit).reverse() };
|
|
171
|
-
}
|
|
172
|
-
|
|
173
|
-
function summarizeBuyerEvents(state, days = 7) {
|
|
174
|
-
ensureBuyerEventCollections(state);
|
|
175
|
-
const window = Math.max(1, Math.min(DAILY_RETENTION_DAYS, Number(days) || 7));
|
|
176
|
-
// Calendar window covering at least the last `window` x 24 h: from the UTC day `window` days
|
|
177
|
-
// ago through today (so a report run early in the day still includes yesterday).
|
|
178
|
-
const cutoffDay = new Date(Date.now() - window * 86400000).toISOString().slice(0, 10);
|
|
179
|
-
const keys = Array.from(state.buyerEventDaily.keys()).sort().filter((day) => day >= cutoffDay);
|
|
180
|
-
const totals = { failures: 0, ours: 0, upstream: 0, buyer: 0, money_moved: 0, challenges_issued: 0, paid_ok: 0 };
|
|
181
|
-
const byReason = {};
|
|
182
|
-
const perDay = keys.map((day) => {
|
|
183
|
-
const bucket = state.buyerEventDaily.get(day) || {};
|
|
184
|
-
const dayTotals = { day, failures: 0, ours: 0, upstream: 0, money_moved: 0, challenges_issued: 0, paid_ok: 0 };
|
|
185
|
-
for (const [key, count] of Object.entries(bucket)) {
|
|
186
|
-
const [service, rest] = [key.slice(0, key.indexOf("|")), key.slice(key.indexOf("|") + 1)];
|
|
187
|
-
if (rest === "money_moved") { dayTotals.money_moved += count; totals.money_moved += count; continue; }
|
|
188
|
-
if (rest.startsWith("step:challenge_issued")) { dayTotals.challenges_issued += count; totals.challenges_issued += count; continue; }
|
|
189
|
-
if (rest.startsWith("step:paid_ok")) { dayTotals.paid_ok += count; totals.paid_ok += count; continue; }
|
|
190
|
-
if (!rest.startsWith("fail:")) continue;
|
|
191
|
-
const [, stage, reason, fault] = rest.split(":");
|
|
192
|
-
if (STEP_STAGES.has(stage)) continue;
|
|
193
|
-
dayTotals.failures += count;
|
|
194
|
-
totals.failures += count;
|
|
195
|
-
if (fault === "ours") { dayTotals.ours += count; totals.ours += count; }
|
|
196
|
-
if (fault === "upstream") { dayTotals.upstream += count; totals.upstream += count; }
|
|
197
|
-
if (fault === "buyer") totals.buyer += count;
|
|
198
|
-
const reasonKey = `${service}:${stage}:${reason}:${fault}`;
|
|
199
|
-
byReason[reasonKey] = (byReason[reasonKey] || 0) + count;
|
|
200
|
-
}
|
|
201
|
-
return dayTotals;
|
|
202
|
-
});
|
|
203
|
-
const topReasons = Object.entries(byReason)
|
|
204
|
-
.sort((a, b) => b[1] - a[1])
|
|
205
|
-
.slice(0, 25)
|
|
206
|
-
.map(([key, count]) => {
|
|
207
|
-
const [service, stage, reason, fault] = key.split(":");
|
|
208
|
-
return { service, stage, reason, fault, count };
|
|
209
|
-
});
|
|
210
|
-
return {
|
|
211
|
-
window_days: window,
|
|
212
|
-
totals,
|
|
213
|
-
// Needs attention: money moved without a delivered result, or failures that are our fault.
|
|
214
|
-
attention: totals.money_moved > 0 || totals.ours > 0,
|
|
215
|
-
per_day: perDay,
|
|
216
|
-
top_reasons: topReasons,
|
|
217
|
-
generated_at_iso: new Date().toISOString()
|
|
218
|
-
};
|
|
219
|
-
}
|
|
220
|
-
|
|
221
|
-
module.exports = {
|
|
222
|
-
countBuyerStep,
|
|
223
|
-
isStepEvent,
|
|
224
|
-
ensureBuyerEventCollections,
|
|
225
|
-
listBuyerEvents,
|
|
226
|
-
payerHash,
|
|
227
|
-
recordBuyerEvent,
|
|
228
|
-
routeTemplate,
|
|
229
|
-
summarizeBuyerEvents
|
|
230
|
-
};
|