xytara 3.1.16 → 3.2.0

package/lib/commerce_quotes.js

@@ -1,266 +0,0 @@
-"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;
-}
-
-// Expired, never-paid quotes (e.g. from unpaid 402 probes) are pure history: nothing executes or
-// settles against them. Keep them for a retention window, then drop them so durable state does
-// not grow without bound. Executed/accepted quotes are never pruned.
-const DEFAULT_QUOTE_RETENTION_MS = 7 * 24 * 60 * 60 * 1000;
-function quoteRetentionMs() {
-  const raw = process.env.XYTARA_QUOTE_RETENTION_MS;
-  if (raw === undefined || raw === "") return DEFAULT_QUOTE_RETENTION_MS;
-  const n = Number(raw);
-  return Number.isFinite(n) && n >= 0 ? n : DEFAULT_QUOTE_RETENTION_MS;
-}
-
-function pruneStaleQuotes(state, nowMs) {
-  if (!state || !(state.quotes instanceof Map)) return 0;
-  const now = typeof nowMs === "number" ? nowMs : Date.now();
-  const cutoff = now - quoteRetentionMs();
-  let pruned = 0;
-  for (const [quoteId, quote] of Array.from(state.quotes.entries())) {
-    if (!quote || quote.status !== "expired" || quote.transaction_id) continue;
-    const expiresAtMs = Date.parse(quote.expires_at_iso || "");
-    if (Number.isFinite(expiresAtMs) && expiresAtMs < cutoff) {
-      state.quotes.delete(quoteId);
-      pruned += 1;
-    }
-  }
-  return pruned;
-}
-
-function hydrateQuoteStates(state, nowMs) {
-  for (const quoteId of Array.from(state.quotes.keys())) {
-    refreshQuoteStatus(state, quoteId, nowMs);
-  }
-  pruneStaleQuotes(state, 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,
-  pruneStaleQuotes,
-  refreshQuoteStatus
-};