xytara 3.1.13 → 3.1.14

package/lib/commerce_runtime.js

@@ -1,322 +1,322 @@
-"use strict";
-
-const { createCommandArtifacts } = require("./commerce_artifacts");
-const { createQuote, hydrateQuoteStates, markQuoteExecuted } = require("./commerce_quotes");
-const { listRecords } = require("./record_queries");
-const { createBsvSettlementRecord } = require("./settlement_bsv_live");
-const {
-  actOnDispute,
-  actOnRefund,
-  actOnRemediationTicket,
-  createDispute,
-  createRefund,
-  createRemediationTicket,
-  settleRefundAsCredit
-} = require("./commerce_cases");
-
-function createRuntimeState() {
-  return {
-    quotes: new Map(),
-    checkoutPurchaseIntents: new Map(),
-    checkoutSessions: new Map(),
-    checkoutEvents: new Map(),
-    externalCreditGrants: new Map(),
-    accountAuthorityBindings: new Map(),
-    accountSpendCredentials: new Map(),
-    accountSpendCredentialsByToken: new Map(),
-    machineIdentityBindings: new Map(),
-    operatorParticipants: new Map(),
-    networkParticipants: new Map(),
-    runtimeBridgeDispatches: new Map(),
-    agentAccounts: new Map(),
-    transactions: new Map(),
-    receipts: new Map(),
-    paymentLedger: [],
-    bsvSettlementRecords: new Map(),
-    providerRegistry: new Map(),
-    providerSettlementLedger: [],
-    providerPayouts: [],
-    acceptedPaymentNonces: new Set(),
-    acceptedAgentSignatures: new Map(),
-    inFlightPaymentAuthorizations: new Map(),
-    economicsBudgets: new Map(),
-    economicsAgents: new Map(),
-    economicsReceipts: new Map(),
-    economicsAllocations: [],
-    economicsRailCredits: [],
-    economicsEntitlements: new Map(),
-    economicsCreditSpends: [],
-    economicsUsageMeters: new Map(),
-    economicsInterpretationHandoffs: [],
-    economicsJobActions: [],
-    coordinationHandoffs: [],
-    zoneAdmissionCases: [],
-    deliveries: new Map(),
-    pendingExecutions: new Map(),
-    disputes: new Map(),
-    refunds: new Map(),
-    remediationTickets: new Map()
-  };
-}
-
-function buildDeliveryEvent(event, delivery, atIso, extra) {
-  return {
-    event,
-    at_iso: atIso,
-    status: delivery.status,
-    callback_url: delivery.callback_url || null,
-    output_ref: delivery.output_ref || null,
-    proof_ref: delivery.proof_ref || null,
-    ...(extra || {})
-  };
-}
-
-function buildCallbackDeliveryState(callbackUrl, deliveredAtIso, options = {}) {
-  if (!callbackUrl) return null;
-  const opts = options || {};
-  const initialStatus = opts.initial_status || (deliveredAtIso ? "queued" : "pending_execution");
-  return {
-    status: initialStatus,
-    attempt_count: 0,
-    max_attempts: null,
-    last_attempt_at_iso: null,
-    next_attempt_at_iso: deliveredAtIso || null,
-    delivered_at_iso: null,
-    failed_at_iso: null,
-    last_error: null,
-    last_response_status: null,
-    signature_mode: "hmac_sha256"
-  };
-}
-
-function completePendingExecution(state, transactionId) {
-  if (!transactionId || !state.pendingExecutions.has(transactionId) || !state.transactions.has(transactionId)) {
-    return state.transactions.get(transactionId) || null;
-  }
-  const pending = state.pendingExecutions.get(transactionId);
-  const current = state.transactions.get(transactionId);
-  if (!pending || !current || Date.now() < pending.readyAtMs) {
-    return current;
-  }
-
-  const completedAtIso = new Date(pending.readyAtMs).toISOString();
-  const next = {
-    transaction: {
-      ...current.transaction,
-      status: "completed",
-      completed_at_iso: completedAtIso,
-      timing: {
-        ...current.transaction.timing,
-        completed_at_iso: completedAtIso,
-        duration_ms: pending.durationMs,
-        observed_latency_class: pending.observedLatencyClass,
-        assessment: pending.assessment
-      },
-      execution: {
-        ...current.transaction.execution,
-        status: "completed"
-      },
-      remediation: {
-        ...current.transaction.remediation,
-        updated_at_iso: completedAtIso
-      }
-    },
-    receipt: {
-      ...current.receipt,
-      status: "completed",
-      created_at_iso: completedAtIso,
-      timing: {
-        ...current.receipt.timing,
-        completed_at_iso: completedAtIso,
-        duration_ms: pending.durationMs,
-        observed_latency_class: pending.observedLatencyClass,
-        assessment: pending.assessment
-      },
-      remediation: {
-        ...current.receipt.remediation,
-        updated_at_iso: completedAtIso
-      }
-    },
-    command: current.command
-  };
-
-  state.transactions.set(transactionId, next);
-  state.receipts.set(next.receipt.receipt_id, next);
-  if (pending.quoteId && state.quotes.has(pending.quoteId)) {
-    const quote = state.quotes.get(pending.quoteId);
-    state.quotes.set(pending.quoteId, {
-      ...quote,
-      status: "executed",
-      payment_recorded_at_iso: completedAtIso,
-      executed_at_iso: completedAtIso
-    });
-  }
-  if (pending.deliveryId && state.deliveries.has(pending.deliveryId)) {
-    const delivery = state.deliveries.get(pending.deliveryId);
-    const nextDelivery = {
-      ...delivery,
-      status: "delivered",
-      delivered_at_iso: completedAtIso,
-      receipt_id: next.receipt.receipt_id,
-      proof_ref: next.receipt.proof_ref,
-      attempt_count: (delivery.attempt_count || 0) + 1,
-      last_attempt_at_iso: completedAtIso,
-      history: [
-        ...(Array.isArray(delivery.history) ? delivery.history : []),
-        buildDeliveryEvent("delivered", { ...delivery, status: "delivered", proof_ref: next.receipt.proof_ref }, completedAtIso, {
-          attempt_number: (delivery.attempt_count || 0) + 1
-        })
-      ],
-      callback_delivery: delivery.callback_url
-        ? {
-            ...(delivery.callback_delivery || buildCallbackDeliveryState(delivery.callback_url, completedAtIso)),
-            status: "queued",
-            next_attempt_at_iso: completedAtIso,
-            last_error: null,
-            failed_at_iso: null
-          }
-        : null
-    };
-    state.deliveries.set(pending.deliveryId, nextDelivery);
-  }
-  state.pendingExecutions.delete(transactionId);
-  return next;
-}
-
-function hydratePendingExecutions(state) {
-  for (const transactionId of Array.from(state.pendingExecutions.keys())) {
-    completePendingExecution(state, transactionId);
-  }
-}
-
-function createCommandResult(state, payload, quote, options) {
-  const opts = options || {};
-  const deferredCompletion = payload && payload.defer_completion === true;
-  const { transaction, receipt, command } = createCommandArtifacts(payload, quote, {
-    deferredCompletion,
-    paymentVerification: opts.paymentVerification || null,
-    externalExecution: opts.externalExecution || null
-  });
-  const result = { transaction, receipt, command };
-  state.transactions.set(transaction.transaction_id, result);
-  state.receipts.set(receipt.receipt_id, result);
-  let paymentRecord = null;
-  if (!opts.skipPaymentLedger) {
-    paymentRecord = {
-      payment_id: `pay_${quote.quote_id}`,
-      quote_id: quote.quote_id,
-      transaction_id: transaction.transaction_id,
-      receipt_id: receipt.receipt_id,
-      account_id: quote.account_id,
-      amount_minor: quote.amount_minor,
-      currency: quote.currency,
-      settlement_adapter: quote.settlement_adapter,
-      settlement_integration_id: quote.settlement_integration_id || null,
-      recorded_at_iso: receipt.created_at_iso,
-      payment: transaction.payment,
-      settlement: transaction.settlement,
-      treasury: transaction.treasury,
-      default_path: transaction.default_path,
-      payment_verification: opts.paymentVerification
-        ? {
-            verification_mode: opts.paymentVerification.verification_mode || null,
-            wallet_id: opts.paymentVerification.wallet_id || null,
-            age_seconds: Number.isFinite(Number(opts.paymentVerification.age_seconds))
-              ? Number(opts.paymentVerification.age_seconds)
-              : null
-          }
-        : null
-    };
-    state.paymentLedger = [
-      paymentRecord,
-      ...(Array.isArray(state.paymentLedger) ? state.paymentLedger : [])
-    ].slice(0, 100);
-    const liveSettlement = createBsvSettlementRecord(state, transaction, receipt, paymentRecord);
-    if (liveSettlement) {
-      paymentRecord.live_settlement = {
-        settlement_id: liveSettlement.settlement_id,
-        status: liveSettlement.status,
-        finality_status: liveSettlement.finality_status,
-        txid: liveSettlement.txid,
-        rail: liveSettlement.rail
-      };
-      transaction.settlement.live = paymentRecord.live_settlement;
-      receipt.settlement.live = paymentRecord.live_settlement;
-    }
-  }
-  if (opts.creditSpend) {
-    transaction.credit_spend = opts.creditSpend;
-    receipt.credit_spend = opts.creditSpend;
-  }
-  const deliveryRecord = {
-    delivery_id: `delivery_${transaction.transaction_id}`,
-    transaction_id: transaction.transaction_id,
-    receipt_id: receipt.receipt_id,
-    quote_id: quote.quote_id,
-    account_id: quote.account_id,
-    callback_url: transaction.callback_url,
-    output_ref: transaction.output_ref,
-    proof_ref: receipt.proof_ref,
-    payment_id: paymentRecord ? paymentRecord.payment_id : null,
-    delivery_target_kind: transaction.callback_url ? "callback" : "direct",
-    status: deferredCompletion ? "pending_delivery" : "delivered",
-    created_at_iso: transaction.created_at_iso,
-    delivered_at_iso: deferredCompletion ? null : receipt.created_at_iso,
-    attempt_count: deferredCompletion ? 0 : 1,
-    last_attempt_at_iso: deferredCompletion ? null : receipt.created_at_iso,
-    callback_delivery: buildCallbackDeliveryState(
-      transaction.callback_url,
-      deferredCompletion ? null : receipt.created_at_iso,
-      {
-        initial_status: deferredCompletion ? "pending_execution" : "queued"
-      }
-    ),
-    history: [
-      buildDeliveryEvent("created", {
-        callback_url: transaction.callback_url,
-        output_ref: transaction.output_ref,
-        proof_ref: receipt.proof_ref,
-        status: deferredCompletion ? "pending_delivery" : "delivered"
-      }, transaction.created_at_iso),
-      ...(!deferredCompletion ? [
-        buildDeliveryEvent("delivered", {
-          callback_url: transaction.callback_url,
-          output_ref: transaction.output_ref,
-          proof_ref: receipt.proof_ref,
-          status: "delivered"
-        }, receipt.created_at_iso, { attempt_number: 1 })
-      ] : [])
-    ]
-  };
-  state.deliveries.set(deliveryRecord.delivery_id, deliveryRecord);
-  markQuoteExecuted(state, quote, result, paymentRecord, { deferredCompletion });
-  if (deferredCompletion) {
-    state.pendingExecutions.set(transaction.transaction_id, {
-      readyAtMs: Date.now() + 300,
-      quoteId: quote.quote_id,
-      deliveryId: deliveryRecord.delivery_id,
-      durationMs: 250,
-      observedLatencyClass: "instant",
-      assessment: "within_posture"
-    });
-  }
-  return result;
-}
-
-module.exports = {
-  buildCallbackDeliveryState,
-  completePendingExecution,
-  createCommandResult,
-  createDispute,
-  createQuote,
-  createRefund,
-  createRemediationTicket,
-  createRuntimeState,
-  hydrateQuoteStates,
-  hydratePendingExecutions,
-  actOnDispute,
-  actOnRefund,
-  actOnRemediationTicket,
-  settleRefundAsCredit,
-  listRecords
-};
+"use strict";
+
+const { createCommandArtifacts } = require("./commerce_artifacts");
+const { createQuote, hydrateQuoteStates, markQuoteExecuted } = require("./commerce_quotes");
+const { listRecords } = require("./record_queries");
+const { createBsvSettlementRecord } = require("./settlement_bsv_live");
+const {
+  actOnDispute,
+  actOnRefund,
+  actOnRemediationTicket,
+  createDispute,
+  createRefund,
+  createRemediationTicket,
+  settleRefundAsCredit
+} = require("./commerce_cases");
+
+function createRuntimeState() {
+  return {
+    quotes: new Map(),
+    checkoutPurchaseIntents: new Map(),
+    checkoutSessions: new Map(),
+    checkoutEvents: new Map(),
+    externalCreditGrants: new Map(),
+    accountAuthorityBindings: new Map(),
+    accountSpendCredentials: new Map(),
+    accountSpendCredentialsByToken: new Map(),
+    machineIdentityBindings: new Map(),
+    operatorParticipants: new Map(),
+    networkParticipants: new Map(),
+    runtimeBridgeDispatches: new Map(),
+    agentAccounts: new Map(),
+    transactions: new Map(),
+    receipts: new Map(),
+    paymentLedger: [],
+    bsvSettlementRecords: new Map(),
+    providerRegistry: new Map(),
+    providerSettlementLedger: [],
+    providerPayouts: [],
+    acceptedPaymentNonces: new Set(),
+    acceptedAgentSignatures: new Map(),
+    inFlightPaymentAuthorizations: new Map(),
+    economicsBudgets: new Map(),
+    economicsAgents: new Map(),
+    economicsReceipts: new Map(),
+    economicsAllocations: [],
+    economicsRailCredits: [],
+    economicsEntitlements: new Map(),
+    economicsCreditSpends: [],
+    economicsUsageMeters: new Map(),
+    economicsInterpretationHandoffs: [],
+    economicsJobActions: [],
+    coordinationHandoffs: [],
+    zoneAdmissionCases: [],
+    deliveries: new Map(),
+    pendingExecutions: new Map(),
+    disputes: new Map(),
+    refunds: new Map(),
+    remediationTickets: new Map()
+  };
+}
+
+function buildDeliveryEvent(event, delivery, atIso, extra) {
+  return {
+    event,
+    at_iso: atIso,
+    status: delivery.status,
+    callback_url: delivery.callback_url || null,
+    output_ref: delivery.output_ref || null,
+    proof_ref: delivery.proof_ref || null,
+    ...(extra || {})
+  };
+}
+
+function buildCallbackDeliveryState(callbackUrl, deliveredAtIso, options = {}) {
+  if (!callbackUrl) return null;
+  const opts = options || {};
+  const initialStatus = opts.initial_status || (deliveredAtIso ? "queued" : "pending_execution");
+  return {
+    status: initialStatus,
+    attempt_count: 0,
+    max_attempts: null,
+    last_attempt_at_iso: null,
+    next_attempt_at_iso: deliveredAtIso || null,
+    delivered_at_iso: null,
+    failed_at_iso: null,
+    last_error: null,
+    last_response_status: null,
+    signature_mode: "hmac_sha256"
+  };
+}
+
+function completePendingExecution(state, transactionId) {
+  if (!transactionId || !state.pendingExecutions.has(transactionId) || !state.transactions.has(transactionId)) {
+    return state.transactions.get(transactionId) || null;
+  }
+  const pending = state.pendingExecutions.get(transactionId);
+  const current = state.transactions.get(transactionId);
+  if (!pending || !current || Date.now() < pending.readyAtMs) {
+    return current;
+  }
+
+  const completedAtIso = new Date(pending.readyAtMs).toISOString();
+  const next = {
+    transaction: {
+      ...current.transaction,
+      status: "completed",
+      completed_at_iso: completedAtIso,
+      timing: {
+        ...current.transaction.timing,
+        completed_at_iso: completedAtIso,
+        duration_ms: pending.durationMs,
+        observed_latency_class: pending.observedLatencyClass,
+        assessment: pending.assessment
+      },
+      execution: {
+        ...current.transaction.execution,
+        status: "completed"
+      },
+      remediation: {
+        ...current.transaction.remediation,
+        updated_at_iso: completedAtIso
+      }
+    },
+    receipt: {
+      ...current.receipt,
+      status: "completed",
+      created_at_iso: completedAtIso,
+      timing: {
+        ...current.receipt.timing,
+        completed_at_iso: completedAtIso,
+        duration_ms: pending.durationMs,
+        observed_latency_class: pending.observedLatencyClass,
+        assessment: pending.assessment
+      },
+      remediation: {
+        ...current.receipt.remediation,
+        updated_at_iso: completedAtIso
+      }
+    },
+    command: current.command
+  };
+
+  state.transactions.set(transactionId, next);
+  state.receipts.set(next.receipt.receipt_id, next);
+  if (pending.quoteId && state.quotes.has(pending.quoteId)) {
+    const quote = state.quotes.get(pending.quoteId);
+    state.quotes.set(pending.quoteId, {
+      ...quote,
+      status: "executed",
+      payment_recorded_at_iso: completedAtIso,
+      executed_at_iso: completedAtIso
+    });
+  }
+  if (pending.deliveryId && state.deliveries.has(pending.deliveryId)) {
+    const delivery = state.deliveries.get(pending.deliveryId);
+    const nextDelivery = {
+      ...delivery,
+      status: "delivered",
+      delivered_at_iso: completedAtIso,
+      receipt_id: next.receipt.receipt_id,
+      proof_ref: next.receipt.proof_ref,
+      attempt_count: (delivery.attempt_count || 0) + 1,
+      last_attempt_at_iso: completedAtIso,
+      history: [
+        ...(Array.isArray(delivery.history) ? delivery.history : []),
+        buildDeliveryEvent("delivered", { ...delivery, status: "delivered", proof_ref: next.receipt.proof_ref }, completedAtIso, {
+          attempt_number: (delivery.attempt_count || 0) + 1
+        })
+      ],
+      callback_delivery: delivery.callback_url
+        ? {
+            ...(delivery.callback_delivery || buildCallbackDeliveryState(delivery.callback_url, completedAtIso)),
+            status: "queued",
+            next_attempt_at_iso: completedAtIso,
+            last_error: null,
+            failed_at_iso: null
+          }
+        : null
+    };
+    state.deliveries.set(pending.deliveryId, nextDelivery);
+  }
+  state.pendingExecutions.delete(transactionId);
+  return next;
+}
+
+function hydratePendingExecutions(state) {
+  for (const transactionId of Array.from(state.pendingExecutions.keys())) {
+    completePendingExecution(state, transactionId);
+  }
+}
+
+function createCommandResult(state, payload, quote, options) {
+  const opts = options || {};
+  const deferredCompletion = payload && payload.defer_completion === true;
+  const { transaction, receipt, command } = createCommandArtifacts(payload, quote, {
+    deferredCompletion,
+    paymentVerification: opts.paymentVerification || null,
+    externalExecution: opts.externalExecution || null
+  });
+  const result = { transaction, receipt, command };
+  state.transactions.set(transaction.transaction_id, result);
+  state.receipts.set(receipt.receipt_id, result);
+  let paymentRecord = null;
+  if (!opts.skipPaymentLedger) {
+    paymentRecord = {
+      payment_id: `pay_${quote.quote_id}`,
+      quote_id: quote.quote_id,
+      transaction_id: transaction.transaction_id,
+      receipt_id: receipt.receipt_id,
+      account_id: quote.account_id,
+      amount_minor: quote.amount_minor,
+      currency: quote.currency,
+      settlement_adapter: quote.settlement_adapter,
+      settlement_integration_id: quote.settlement_integration_id || null,
+      recorded_at_iso: receipt.created_at_iso,
+      payment: transaction.payment,
+      settlement: transaction.settlement,
+      treasury: transaction.treasury,
+      default_path: transaction.default_path,
+      payment_verification: opts.paymentVerification
+        ? {
+            verification_mode: opts.paymentVerification.verification_mode || null,
+            wallet_id: opts.paymentVerification.wallet_id || null,
+            age_seconds: Number.isFinite(Number(opts.paymentVerification.age_seconds))
+              ? Number(opts.paymentVerification.age_seconds)
+              : null
+          }
+        : null
+    };
+    state.paymentLedger = [
+      paymentRecord,
+      ...(Array.isArray(state.paymentLedger) ? state.paymentLedger : [])
+    ].slice(0, 100);
+    const liveSettlement = createBsvSettlementRecord(state, transaction, receipt, paymentRecord);
+    if (liveSettlement) {
+      paymentRecord.live_settlement = {
+        settlement_id: liveSettlement.settlement_id,
+        status: liveSettlement.status,
+        finality_status: liveSettlement.finality_status,
+        txid: liveSettlement.txid,
+        rail: liveSettlement.rail
+      };
+      transaction.settlement.live = paymentRecord.live_settlement;
+      receipt.settlement.live = paymentRecord.live_settlement;
+    }
+  }
+  if (opts.creditSpend) {
+    transaction.credit_spend = opts.creditSpend;
+    receipt.credit_spend = opts.creditSpend;
+  }
+  const deliveryRecord = {
+    delivery_id: `delivery_${transaction.transaction_id}`,
+    transaction_id: transaction.transaction_id,
+    receipt_id: receipt.receipt_id,
+    quote_id: quote.quote_id,
+    account_id: quote.account_id,
+    callback_url: transaction.callback_url,
+    output_ref: transaction.output_ref,
+    proof_ref: receipt.proof_ref,
+    payment_id: paymentRecord ? paymentRecord.payment_id : null,
+    delivery_target_kind: transaction.callback_url ? "callback" : "direct",
+    status: deferredCompletion ? "pending_delivery" : "delivered",
+    created_at_iso: transaction.created_at_iso,
+    delivered_at_iso: deferredCompletion ? null : receipt.created_at_iso,
+    attempt_count: deferredCompletion ? 0 : 1,
+    last_attempt_at_iso: deferredCompletion ? null : receipt.created_at_iso,
+    callback_delivery: buildCallbackDeliveryState(
+      transaction.callback_url,
+      deferredCompletion ? null : receipt.created_at_iso,
+      {
+        initial_status: deferredCompletion ? "pending_execution" : "queued"
+      }
+    ),
+    history: [
+      buildDeliveryEvent("created", {
+        callback_url: transaction.callback_url,
+        output_ref: transaction.output_ref,
+        proof_ref: receipt.proof_ref,
+        status: deferredCompletion ? "pending_delivery" : "delivered"
+      }, transaction.created_at_iso),
+      ...(!deferredCompletion ? [
+        buildDeliveryEvent("delivered", {
+          callback_url: transaction.callback_url,
+          output_ref: transaction.output_ref,
+          proof_ref: receipt.proof_ref,
+          status: "delivered"
+        }, receipt.created_at_iso, { attempt_number: 1 })
+      ] : [])
+    ]
+  };
+  state.deliveries.set(deliveryRecord.delivery_id, deliveryRecord);
+  markQuoteExecuted(state, quote, result, paymentRecord, { deferredCompletion });
+  if (deferredCompletion) {
+    state.pendingExecutions.set(transaction.transaction_id, {
+      readyAtMs: Date.now() + 300,
+      quoteId: quote.quote_id,
+      deliveryId: deliveryRecord.delivery_id,
+      durationMs: 250,
+      observedLatencyClass: "instant",
+      assessment: "within_posture"
+    });
+  }
+  return result;
+}
+
+module.exports = {
+  buildCallbackDeliveryState,
+  completePendingExecution,
+  createCommandResult,
+  createDispute,
+  createQuote,
+  createRefund,
+  createRemediationTicket,
+  createRuntimeState,
+  hydrateQuoteStates,
+  hydratePendingExecutions,
+  actOnDispute,
+  actOnRefund,
+  actOnRemediationTicket,
+  settleRefundAsCredit,
+  listRecords
+};