xytara 3.1.0 → 3.1.2

package/lib/commerce_quotes.js

@@ -1,237 +1,237 @@
-"use strict";
-
-const crypto = require("crypto");
-const { findTask } = require("../fixtures/catalog");
-const { normalizeTaskRefs, resolveIntegrationSelection } = require("../integrations/dispatch");
-const { buildConfiguredTreasuryDestination } = require("./payment_config");
-const {
-  buildBsvTeranodeSettlementHints,
-  normalizeSettlementMode
-} = require("./settlement_bsv_teranode");
-
-function buildTreasuryDestination(accountId, settlementMode) {
-  const normalizedSettlementMode = normalizeSettlementMode(settlementMode);
-  const configured = buildConfiguredTreasuryDestination(accountId, normalizedSettlementMode);
-  if (configured) return configured;
-  const normalizedAccountId = accountId || "account_placeholder";
-  const mode = normalizedSettlementMode || "default_settlement";
-  return {
-    destination_id: `treasury_${normalizedAccountId}`,
-    destination_kind: "account_treasury",
-    account_id: normalizedAccountId,
-    settlement_mode: mode
-  };
-}
-
-function buildDefaultEconomicPath(paymentIntegrationId, settlementIntegrationId, treasuryDestination, options) {
-  const opts = options || {};
-  const paymentId = paymentIntegrationId || null;
-  const settlementId = settlementIntegrationId || null;
-  const paymentBuiltin = typeof paymentId === "string" && paymentId.startsWith("builtin.");
-  const settlementBuiltin = typeof settlementId === "string" && settlementId.startsWith("builtin.");
-  let pathKind = "custom";
-  if (paymentBuiltin && settlementBuiltin) pathKind = "first_party_default";
-  else if (paymentBuiltin || settlementBuiltin) pathKind = "hybrid";
-  return {
-    path_kind: pathKind,
-    selection_origin: Array.isArray(opts.requestedIntegrationIds) && opts.requestedIntegrationIds.length > 0
-      ? "explicit_or_constrained"
-      : "default",
-    payment_integration_id: paymentId,
-    settlement_integration_id: settlementId,
-    treasury_destination_id: treasuryDestination && treasuryDestination.destination_id
-      ? treasuryDestination.destination_id
-      : null,
-    payment_protocol: opts.paymentProtocol || null,
-    settlement_mode: opts.settlementMode || null,
-    uses_first_party_payment: paymentBuiltin,
-    uses_first_party_settlement: settlementBuiltin,
-    status: opts.status || "quoted"
-  };
-}
-
-function createQuote(state, payload) {
-  const taskRefs = normalizeTaskRefs(payload);
-  const selection = resolveIntegrationSelection(payload);
-  const amountMinor = taskRefs.reduce((sum, ref) => {
-    const task = findTask(ref);
-    return sum + Number((task && task.public_launch_price && task.public_launch_price.amount_minor) || 0);
-  }, 0) || 5;
-  const createdAtIso = new Date().toISOString();
-  const ttlMs = Number.isFinite(Number(payload.quote_ttl_ms)) ? Math.max(0, Number(payload.quote_ttl_ms)) : 5 * 60 * 1000;
-  const paymentPreference = payload.payment_preference === "credits_first" ? "credits_first" : null;
-  const paymentScheme = paymentPreference === "credits_first"
-    ? "credits"
-    : payload.account_id ? "exact" : "native";
-  const paymentProtocol = paymentPreference === "credits_first"
-    ? "account_credits"
-    : payload.payment_protocol || null;
-  const quote = {
-    quote_id: `quote_${crypto.randomBytes(6).toString("hex")}`,
-    account_id: payload.account_id || "account_placeholder",
-    status: "quoted",
-    amount_minor: amountMinor,
-    currency: "USD_CENTS",
-    capabilities: taskRefs,
-    adapters: selection.adapters,
-    integration_ids: selection.integration_ids,
-    requested_integration_ids: selection.requested_integration_ids,
-    execution_integration_ids: selection.execution_integration_ids,
-    protocol_integration_ids: selection.protocol_integration_ids,
-    identity_integration_ids: selection.identity_integration_ids,
-    settlement_integration_id: selection.settlement_integration_id,
-    integration_preference: selection.integration_preference,
-    protocols: selection.protocols,
-    settlement_adapter: selection.settlement_adapter,
-    settlement_binding_hash: crypto.createHash("sha256").update(JSON.stringify({
-      taskRefs,
-      settlementMode: selection.settlement_mode,
-      command: payload.command || ""
-    })).digest("hex"),
-    settlement_mode: selection.settlement_mode,
-    settlement_preference: payload.settlement_preference || null,
-    payment_scheme: paymentScheme,
-    payment_protocol: paymentProtocol,
-    task_count: taskRefs.length || 1,
-    task_refs: taskRefs,
-    created_at_iso: createdAtIso,
-    expires_at_iso: new Date(Date.now() + ttlMs).toISOString(),
-    intent: payload.command || "command.execute",
-    transaction_id: null,
-    receipt_id: null,
-    payment_id: null,
-    payment_recorded_at_iso: null,
-    executed_at_iso: null,
-    payment: {
-      scheme: paymentScheme,
-      protocol: paymentProtocol,
-      status: "quoted"
-    },
-    settlement: {
-      mode: selection.settlement_mode,
-      preference: payload.settlement_preference || null,
-      adapter: selection.settlement_adapter,
-      integration_id: selection.settlement_integration_id || null,
-      binding_hash: null,
-      hints: null,
-      status: "quoted"
-    },
-    treasury: {
-      ...buildTreasuryDestination(payload.account_id || "account_placeholder", selection.settlement_mode),
-      status: "pending_payment",
-      receipt_id: null,
-      payment_id: null
-    },
-    default_path: null
-  };
-  quote.settlement.binding_hash = crypto.createHash("sha256").update(JSON.stringify({
-    taskRefs,
-    settlementMode: selection.settlement_mode,
-    command: payload.command || ""
-  })).digest("hex");
-  quote.settlement_binding_hash = quote.settlement.binding_hash;
-  quote.settlement.hints = buildBsvTeranodeSettlementHints({
-    settlementMode: selection.settlement_mode,
-    amountMinor: quote.amount_minor,
-    currency: quote.currency,
-    settlementBindingHash: quote.settlement.binding_hash,
-    treasuryDestination: quote.treasury
-  });
-  quote.default_path = buildDefaultEconomicPath(
-    Array.isArray(selection.integration_ids)
-      ? selection.integration_ids.find((integrationId) => typeof integrationId === "string" && integrationId.startsWith("builtin.payment."))
-      : null,
-    selection.settlement_integration_id || null,
-    quote.treasury,
-    {
-      requestedIntegrationIds: selection.requested_integration_ids,
-      paymentProtocol: paymentProtocol,
-      settlementMode: selection.settlement_mode,
-      status: "quoted"
-    }
-  );
-  state.quotes.set(quote.quote_id, quote);
-  return quote;
-}
-
-function isQuoteExpired(quote, nowMs) {
-  if (!quote || !quote.expires_at_iso) return false;
-  const expiresAtMs = Date.parse(quote.expires_at_iso);
-  if (!Number.isFinite(expiresAtMs)) return false;
-  return expiresAtMs <= (typeof nowMs === "number" ? nowMs : Date.now());
-}
-
-function refreshQuoteStatus(state, quoteId, nowMs) {
-  if (!quoteId || !state.quotes.has(quoteId)) return null;
-  const current = state.quotes.get(quoteId);
-  if (!current) return null;
-  if (current.status !== "quoted") return current;
-  if (!isQuoteExpired(current, nowMs)) return current;
-  const next = {
-    ...current,
-    status: "expired"
-  };
-  state.quotes.set(quoteId, next);
-  return next;
-}
-
-function hydrateQuoteStates(state, nowMs) {
-  for (const quoteId of Array.from(state.quotes.keys())) {
-    refreshQuoteStatus(state, quoteId, nowMs);
-  }
-}
-
-function markQuoteExecuted(state, quote, result, paymentRecord, options) {
-  const opts = options || {};
-  if (!quote || !quote.quote_id || !state.quotes.has(quote.quote_id)) return quote;
-  const current = state.quotes.get(quote.quote_id);
-  const deferredCompletion = opts.deferredCompletion === true;
-  const executedAtIso =
-    (result && result.receipt && result.receipt.created_at_iso) ||
-    (result && result.transaction && result.transaction.completed_at_iso) ||
-    new Date().toISOString();
-  const next = {
-    ...current,
-    status: deferredCompletion ? "accepted" : "executed",
-    transaction_id: result && result.transaction ? result.transaction.transaction_id || null : null,
-    receipt_id: result && result.receipt ? result.receipt.receipt_id || null : null,
-    payment_id: paymentRecord ? paymentRecord.payment_id || null : null,
-    payment_recorded_at_iso: paymentRecord ? paymentRecord.recorded_at_iso || current.payment_recorded_at_iso : current.payment_recorded_at_iso,
-    executed_at_iso: deferredCompletion ? current.executed_at_iso : executedAtIso,
-    payment: {
-      ...(current.payment || {}),
-      status: deferredCompletion ? "authorized" : "recorded",
-      payment_id: paymentRecord ? paymentRecord.payment_id || null : null,
-      recorded_at_iso: paymentRecord ? paymentRecord.recorded_at_iso || null : null
-    },
-    settlement: {
-      ...(current.settlement || {}),
-      status: deferredCompletion ? "pending_completion" : "recorded",
-      transaction_id: result && result.transaction ? result.transaction.transaction_id || null : null,
-      receipt_id: result && result.receipt ? result.receipt.receipt_id || null : null
-    },
-    treasury: {
-      ...(current.treasury || {}),
-      status: deferredCompletion ? "pending_settlement" : "recorded",
-      receipt_id: result && result.receipt ? result.receipt.receipt_id || null : null,
-      payment_id: paymentRecord ? paymentRecord.payment_id || null : null
-    },
-    default_path: {
-      ...(current.default_path || {}),
-      status: deferredCompletion ? "pending_completion" : "recorded"
-    }
-  };
-  state.quotes.set(next.quote_id, next);
-  return next;
-}
-
-module.exports = {
-  buildDefaultEconomicPath,
-  buildTreasuryDestination,
-  createQuote,
-  hydrateQuoteStates,
-  isQuoteExpired,
-  markQuoteExecuted,
-  normalizeTaskRefs,
-  refreshQuoteStatus
-};
+"use strict";
+
+const crypto = require("crypto");
+const { findTask } = require("../fixtures/catalog");
+const { normalizeTaskRefs, resolveIntegrationSelection } = require("../integrations/dispatch");
+const { buildConfiguredTreasuryDestination } = require("./payment_config");
+const {
+  buildBsvTeranodeSettlementHints,
+  normalizeSettlementMode
+} = require("./settlement_bsv_teranode");
+
+function buildTreasuryDestination(accountId, settlementMode) {
+  const normalizedSettlementMode = normalizeSettlementMode(settlementMode);
+  const configured = buildConfiguredTreasuryDestination(accountId, normalizedSettlementMode);
+  if (configured) return configured;
+  const normalizedAccountId = accountId || "account_placeholder";
+  const mode = normalizedSettlementMode || "default_settlement";
+  return {
+    destination_id: `treasury_${normalizedAccountId}`,
+    destination_kind: "account_treasury",
+    account_id: normalizedAccountId,
+    settlement_mode: mode
+  };
+}
+
+function buildDefaultEconomicPath(paymentIntegrationId, settlementIntegrationId, treasuryDestination, options) {
+  const opts = options || {};
+  const paymentId = paymentIntegrationId || null;
+  const settlementId = settlementIntegrationId || null;
+  const paymentBuiltin = typeof paymentId === "string" && paymentId.startsWith("builtin.");
+  const settlementBuiltin = typeof settlementId === "string" && settlementId.startsWith("builtin.");
+  let pathKind = "custom";
+  if (paymentBuiltin && settlementBuiltin) pathKind = "first_party_default";
+  else if (paymentBuiltin || settlementBuiltin) pathKind = "hybrid";
+  return {
+    path_kind: pathKind,
+    selection_origin: Array.isArray(opts.requestedIntegrationIds) && opts.requestedIntegrationIds.length > 0
+      ? "explicit_or_constrained"
+      : "default",
+    payment_integration_id: paymentId,
+    settlement_integration_id: settlementId,
+    treasury_destination_id: treasuryDestination && treasuryDestination.destination_id
+      ? treasuryDestination.destination_id
+      : null,
+    payment_protocol: opts.paymentProtocol || null,
+    settlement_mode: opts.settlementMode || null,
+    uses_first_party_payment: paymentBuiltin,
+    uses_first_party_settlement: settlementBuiltin,
+    status: opts.status || "quoted"
+  };
+}
+
+function createQuote(state, payload) {
+  const taskRefs = normalizeTaskRefs(payload);
+  const selection = resolveIntegrationSelection(payload);
+  const amountMinor = taskRefs.reduce((sum, ref) => {
+    const task = findTask(ref);
+    return sum + Number((task && task.public_launch_price && task.public_launch_price.amount_minor) || 0);
+  }, 0) || 5;
+  const createdAtIso = new Date().toISOString();
+  const ttlMs = Number.isFinite(Number(payload.quote_ttl_ms)) ? Math.max(0, Number(payload.quote_ttl_ms)) : 5 * 60 * 1000;
+  const paymentPreference = payload.payment_preference === "credits_first" ? "credits_first" : null;
+  const paymentScheme = paymentPreference === "credits_first"
+    ? "credits"
+    : payload.account_id ? "exact" : "native";
+  const paymentProtocol = paymentPreference === "credits_first"
+    ? "account_credits"
+    : payload.payment_protocol || null;
+  const quote = {
+    quote_id: `quote_${crypto.randomBytes(6).toString("hex")}`,
+    account_id: payload.account_id || "account_placeholder",
+    status: "quoted",
+    amount_minor: amountMinor,
+    currency: "USD_CENTS",
+    capabilities: taskRefs,
+    adapters: selection.adapters,
+    integration_ids: selection.integration_ids,
+    requested_integration_ids: selection.requested_integration_ids,
+    execution_integration_ids: selection.execution_integration_ids,
+    protocol_integration_ids: selection.protocol_integration_ids,
+    identity_integration_ids: selection.identity_integration_ids,
+    settlement_integration_id: selection.settlement_integration_id,
+    integration_preference: selection.integration_preference,
+    protocols: selection.protocols,
+    settlement_adapter: selection.settlement_adapter,
+    settlement_binding_hash: crypto.createHash("sha256").update(JSON.stringify({
+      taskRefs,
+      settlementMode: selection.settlement_mode,
+      command: payload.command || ""
+    })).digest("hex"),
+    settlement_mode: selection.settlement_mode,
+    settlement_preference: payload.settlement_preference || null,
+    payment_scheme: paymentScheme,
+    payment_protocol: paymentProtocol,
+    task_count: taskRefs.length || 1,
+    task_refs: taskRefs,
+    created_at_iso: createdAtIso,
+    expires_at_iso: new Date(Date.now() + ttlMs).toISOString(),
+    intent: payload.command || "command.execute",
+    transaction_id: null,
+    receipt_id: null,
+    payment_id: null,
+    payment_recorded_at_iso: null,
+    executed_at_iso: null,
+    payment: {
+      scheme: paymentScheme,
+      protocol: paymentProtocol,
+      status: "quoted"
+    },
+    settlement: {
+      mode: selection.settlement_mode,
+      preference: payload.settlement_preference || null,
+      adapter: selection.settlement_adapter,
+      integration_id: selection.settlement_integration_id || null,
+      binding_hash: null,
+      hints: null,
+      status: "quoted"
+    },
+    treasury: {
+      ...buildTreasuryDestination(payload.account_id || "account_placeholder", selection.settlement_mode),
+      status: "pending_payment",
+      receipt_id: null,
+      payment_id: null
+    },
+    default_path: null
+  };
+  quote.settlement.binding_hash = crypto.createHash("sha256").update(JSON.stringify({
+    taskRefs,
+    settlementMode: selection.settlement_mode,
+    command: payload.command || ""
+  })).digest("hex");
+  quote.settlement_binding_hash = quote.settlement.binding_hash;
+  quote.settlement.hints = buildBsvTeranodeSettlementHints({
+    settlementMode: selection.settlement_mode,
+    amountMinor: quote.amount_minor,
+    currency: quote.currency,
+    settlementBindingHash: quote.settlement.binding_hash,
+    treasuryDestination: quote.treasury
+  });
+  quote.default_path = buildDefaultEconomicPath(
+    Array.isArray(selection.integration_ids)
+      ? selection.integration_ids.find((integrationId) => typeof integrationId === "string" && integrationId.startsWith("builtin.payment."))
+      : null,
+    selection.settlement_integration_id || null,
+    quote.treasury,
+    {
+      requestedIntegrationIds: selection.requested_integration_ids,
+      paymentProtocol: paymentProtocol,
+      settlementMode: selection.settlement_mode,
+      status: "quoted"
+    }
+  );
+  state.quotes.set(quote.quote_id, quote);
+  return quote;
+}
+
+function isQuoteExpired(quote, nowMs) {
+  if (!quote || !quote.expires_at_iso) return false;
+  const expiresAtMs = Date.parse(quote.expires_at_iso);
+  if (!Number.isFinite(expiresAtMs)) return false;
+  return expiresAtMs <= (typeof nowMs === "number" ? nowMs : Date.now());
+}
+
+function refreshQuoteStatus(state, quoteId, nowMs) {
+  if (!quoteId || !state.quotes.has(quoteId)) return null;
+  const current = state.quotes.get(quoteId);
+  if (!current) return null;
+  if (current.status !== "quoted") return current;
+  if (!isQuoteExpired(current, nowMs)) return current;
+  const next = {
+    ...current,
+    status: "expired"
+  };
+  state.quotes.set(quoteId, next);
+  return next;
+}
+
+function hydrateQuoteStates(state, nowMs) {
+  for (const quoteId of Array.from(state.quotes.keys())) {
+    refreshQuoteStatus(state, quoteId, nowMs);
+  }
+}
+
+function markQuoteExecuted(state, quote, result, paymentRecord, options) {
+  const opts = options || {};
+  if (!quote || !quote.quote_id || !state.quotes.has(quote.quote_id)) return quote;
+  const current = state.quotes.get(quote.quote_id);
+  const deferredCompletion = opts.deferredCompletion === true;
+  const executedAtIso =
+    (result && result.receipt && result.receipt.created_at_iso) ||
+    (result && result.transaction && result.transaction.completed_at_iso) ||
+    new Date().toISOString();
+  const next = {
+    ...current,
+    status: deferredCompletion ? "accepted" : "executed",
+    transaction_id: result && result.transaction ? result.transaction.transaction_id || null : null,
+    receipt_id: result && result.receipt ? result.receipt.receipt_id || null : null,
+    payment_id: paymentRecord ? paymentRecord.payment_id || null : null,
+    payment_recorded_at_iso: paymentRecord ? paymentRecord.recorded_at_iso || current.payment_recorded_at_iso : current.payment_recorded_at_iso,
+    executed_at_iso: deferredCompletion ? current.executed_at_iso : executedAtIso,
+    payment: {
+      ...(current.payment || {}),
+      status: deferredCompletion ? "authorized" : "recorded",
+      payment_id: paymentRecord ? paymentRecord.payment_id || null : null,
+      recorded_at_iso: paymentRecord ? paymentRecord.recorded_at_iso || null : null
+    },
+    settlement: {
+      ...(current.settlement || {}),
+      status: deferredCompletion ? "pending_completion" : "recorded",
+      transaction_id: result && result.transaction ? result.transaction.transaction_id || null : null,
+      receipt_id: result && result.receipt ? result.receipt.receipt_id || null : null
+    },
+    treasury: {
+      ...(current.treasury || {}),
+      status: deferredCompletion ? "pending_settlement" : "recorded",
+      receipt_id: result && result.receipt ? result.receipt.receipt_id || null : null,
+      payment_id: paymentRecord ? paymentRecord.payment_id || null : null
+    },
+    default_path: {
+      ...(current.default_path || {}),
+      status: deferredCompletion ? "pending_completion" : "recorded"
+    }
+  };
+  state.quotes.set(next.quote_id, next);
+  return next;
+}
+
+module.exports = {
+  buildDefaultEconomicPath,
+  buildTreasuryDestination,
+  createQuote,
+  hydrateQuoteStates,
+  isQuoteExpired,
+  markQuoteExecuted,
+  normalizeTaskRefs,
+  refreshQuoteStatus
+};