@conto_finance/sdk 0.6.0-beta.2 → 0.6.0

package/dist/link-testing.js

@@ -1,285 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/link-testing.ts
-var link_testing_exports = {};
-__export(link_testing_exports, {
-  createLinkTestClient: () => createLinkTestClient
-});
-module.exports = __toCommonJS(link_testing_exports);
-var import_node_crypto = require("crypto");
-var import_index = require("./index.js");
-function canonical(value) {
-  if (Array.isArray(value)) return `[${value.map(canonical).join(",")}]`;
-  if (value && typeof value === "object") {
-    return `{${Object.entries(value).filter(([, v]) => v !== void 0).sort(([a], [b]) => a.localeCompare(b)).map(([key, v]) => `${JSON.stringify(key)}:${canonical(v)}`).join(",")}}`;
-  }
-  return JSON.stringify(value);
-}
-function fail(code, message, status = 409) {
-  throw new import_index.ContoError(message, { code, status });
-}
-var LIVE_API_ERRORS = {
-  POLICY_VIOLATION: {
-    status: 403,
-    message: "The request is not permitted.",
-    retryGuidance: "Verify credentials and permissions before trying again."
-  },
-  NOT_FOUND: {
-    status: 404,
-    message: "The requested resource was not found.",
-    retryGuidance: "Verify the resource identifier before trying again."
-  },
-  CONFLICT: {
-    status: 409,
-    message: "The request conflicts with the current resource state.",
-    retryGuidance: "Check the current resource state before trying again."
-  }
-};
-function liveApiError(code) {
-  const { status, message, retryGuidance } = LIVE_API_ERRORS[code];
-  throw new import_index.ContoError(message, { code, status, retryGuidance });
-}
-function createLinkTestClient(options = {}) {
-  const scenario = options.scenario ?? "approved";
-  const maximumAmountMinor = options.maximumAmountMinor ?? 5e3;
-  if (!["approved", "denied", "expired", "interrupted"].includes(scenario) || !Number.isSafeInteger(maximumAmountMinor) || maximumAmountMinor <= 0) {
-    throw new import_index.ContoError("Invalid Link simulation options", {
-      code: "INVALID_LINK_TEST_OPTIONS",
-      status: 0
-    });
-  }
-  const records = /* @__PURE__ */ new Map();
-  const intents = /* @__PURE__ */ new Map();
-  let sequence = 0;
-  const sessionId = (0, import_node_crypto.randomUUID)();
-  const read = (id) => {
-    const record = records.get(id);
-    if (!record) return liveApiError("NOT_FOUND");
-    return record;
-  };
-  const response = (id) => ({
-    execution: structuredClone(read(id))
-  });
-  const setStatus = (id, status, providerStatus, evidence = {}) => {
-    const record = read(id);
-    record.status = status;
-    record.providerStatus = `simulated_${providerStatus}`;
-    Object.assign(record.evidence, evidence, { status, providerStatus: record.providerStatus });
-    delete record.approvalUrl;
-    return response(id);
-  };
-  const setup = async (_input = {}) => ({
-    version: "conto.link-setup.v1",
-    mode: "SIMULATED",
-    // No live setting was inspected, so the simulator never reports CONFIGURED.
-    configurationStatus: "INCOMPLETE",
-    checks: [
-      {
-        code: "LOCAL_SIMULATION",
-        status: "WARNING",
-        actor: "developer",
-        message: "Local workflow fixture only. No real Link account, Conto policy, checkout, budget, or settlement is tested."
-      },
-      {
-        code: "LIVE_SETUP_NOT_INSPECTED",
-        status: "BLOCKED",
-        actor: "developer",
-        message: "The live Link configuration was not inspected. Call link.setup() on a live Conto client before a real payment."
-      }
-    ],
-    missingScopes: [],
-    paymentAuthorization: "NOT_EVALUATED",
-    providerVerified: false,
-    settlementVerified: false
-  });
-  const transport = {
-    getLinkSetup: setup,
-    async listStripeLinkPaymentMethods() {
-      return {
-        organizationId: "simulated_org",
-        connectionId: "simulated_connection",
-        paymentMethods: [
-          {
-            id: "simulated_method",
-            type: "SIMULATED",
-            isDefault: true,
-            displayLabel: "Simulated funding source (no funds)",
-            eligibleCredentialTypes: ["LINK_PAY_TOKEN"]
-          }
-        ]
-      };
-    },
-    async beginCommerceExecution(input) {
-      if (input.executionMethod !== "LINK_PAY_TOKEN")
-        return fail(
-          "SIMULATED_METHOD_UNSUPPORTED",
-          "Only the Link Pay Token workflow is simulated"
-        );
-      const key = input.idempotencyKey?.trim();
-      if (!key || key.length < 8 || key.length > 255) {
-        return fail(
-          "INVALID_IDEMPOTENCY_KEY",
-          "idempotencyKey must contain 8 to 255 characters",
-          0
-        );
-      }
-      const fingerprint = canonical({ ...input, idempotencyKey: key });
-      const prior = intents.get(key);
-      if (prior) {
-        if (prior.fingerprint !== fingerprint) return liveApiError("CONFLICT");
-        return response(prior.id);
-      }
-      if (scenario === "denied" || input.amountMinor > maximumAmountMinor) {
-        return liveApiError("POLICY_VIOLATION");
-      }
-      if (records.size >= 1e3)
-        return fail(
-          "SIMULATION_CAPACITY_REACHED",
-          "Create a new test client to start another simulation"
-        );
-      const id = `sim_link_${sessionId}_${++sequence}`;
-      const status = "AWAITING_APPROVAL";
-      const providerStatus = "simulated_pending_approval";
-      const evidence = {
-        mode: "SIMULATED",
-        schemaVersion: "conto.commerce-evidence.v1",
-        traceId: `sim_trace_${sequence}`,
-        executionId: id,
-        intentId: `sim_intent_${sequence}`,
-        organizationId: "simulated_org",
-        actorUserId: "simulated_owner",
-        agentId: "simulated_agent",
-        provider: "STRIPE_LINK",
-        sourceKind: "STRIPE_LINK",
-        amountMinor: input.amountMinor,
-        currency: input.currency,
-        purpose: input.purpose,
-        counterpartyId: input.counterparty.canonicalId,
-        counterpartyName: "Simulated checkout",
-        intentFingerprint: `sim_fingerprint_${sequence}`,
-        policyDecisionId: `sim_policy_${sequence}`,
-        policySnapshotHash: "simulated_policy",
-        grantId: `sim_grant_${sequence}`,
-        status,
-        deliveryMode: "SERVER_ONLY_ARTIFACT",
-        artifactKind: "LINK_PAY_TOKEN",
-        providerStatus
-      };
-      records.set(id, {
-        mode: "SIMULATED",
-        id,
-        intentId: evidence.intentId,
-        organizationId: evidence.organizationId,
-        agentId: evidence.agentId,
-        provider: "STRIPE_LINK",
-        executionAdapter: "STRIPE_LINK",
-        executionChannel: "BROWSER",
-        checkoutMethod: "LINK",
-        status,
-        providerStatus,
-        artifactKind: "LINK_PAY_TOKEN",
-        deliveryMode: "SERVER_ONLY_ARTIFACT",
-        // Reserved .invalid domain. It cannot approve anything. Call the test-only approve() method.
-        approvalUrl: `https://link-simulation.invalid/approve/${id}`,
-        amountMinor: input.amountMinor,
-        currency: input.currency,
-        purpose: input.purpose,
-        counterparty: { id: input.counterparty.canonicalId, name: "Simulated checkout" },
-        evidence,
-        evidenceFingerprint: `sim_evidence_${sequence}`
-      });
-      intents.set(key, { fingerprint, id });
-      return response(id);
-    },
-    async getCommerceExecution(id) {
-      return response(id);
-    },
-    // Like a live refresh, this observes the provider and never submits a payment.
-    // A submitted simulated checkout is observed as succeeded on the next refresh.
-    async refreshCommerceExecution(id) {
-      const { status, providerStatus } = read(id);
-      if (status === "PROCESSING" && providerStatus === "simulated_checkout_submitted")
-        return setStatus(id, "SETTLED", "succeeded");
-      return response(id);
-    },
-    async executeCommerceExecution(id) {
-      if (read(id).status !== "READY") return liveApiError("CONFLICT");
-      if (scenario === "interrupted") {
-        setStatus(id, "NEEDS_RECONCILIATION", "checkout_outcome_unknown");
-        throw new import_index.ContoError("Network request failed", { code: "NETWORK_ERROR", status: 0 });
-      }
-      return {
-        ...setStatus(id, "PROCESSING", "checkout_submitted", {
-          checkoutReference: id.replace(/^sim_link_/, "sim_checkout_")
-        }),
-        checkout: {
-          submitted: true,
-          deliveryMode: "SERVER_ONLY_ARTIFACT",
-          accepted: true
-        }
-      };
-    },
-    async cancelCommerceExecution(id) {
-      if (["PROCESSING", "NEEDS_RECONCILIATION", "COMPLETED", "SETTLED"].includes(read(id).status)) {
-        return liveApiError("CONFLICT");
-      }
-      return setStatus(id, "CANCELLED", "canceled");
-    }
-  };
-  const client = new import_index.LinkClient(transport, {
-    connectionId: "simulated_connection",
-    paymentMethodId: "simulated_method"
-  });
-  const marked = async (operation) => {
-    try {
-      return { ...await operation(), mode: "SIMULATED", settlementVerified: false };
-    } catch (error) {
-      const safe = error instanceof import_index.ContoError ? error : new import_index.ContoError("Local simulation failed", { code: "SIMULATION_FAILED", status: 0 });
-      throw Object.assign(safe, { mode: "SIMULATED", settlementVerified: false });
-    }
-  };
-  const payment = (operation) => marked(operation);
-  return {
-    mode: "SIMULATED",
-    link: {
-      setup: (input) => marked(() => client.setup(input)),
-      paymentMethods: () => marked(() => client.paymentMethods()),
-      pay: (input) => payment(() => client.pay(input)),
-      resume: (id) => payment(() => client.resume(id)),
-      status: (id) => payment(() => client.status(id)),
-      cancel: (id) => payment(() => client.cancel(id)),
-      /** Test-only owner action. Never available on the live Link client. */
-      approve: (id) => payment(async () => {
-        if (read(id).status !== "AWAITING_APPROVAL")
-          return fail(
-            "SIMULATED_APPROVAL_UNAVAILABLE",
-            "This simulation is not awaiting approval"
-          );
-        if (scenario === "expired") setStatus(id, "EXPIRED", "expired");
-        else setStatus(id, "READY", "approved");
-        return client.status(id);
-      })
-    }
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createLinkTestClient
-});

package/dist/link-testing.mjs

@@ -1,265 +0,0 @@
-import "./chunk-WSIKPUZJ.mjs";
-
-// src/link-testing.ts
-import { randomUUID } from "crypto";
-import {
-  ContoError,
-  LinkClient
-} from "./index.mjs";
-function canonical(value) {
-  if (Array.isArray(value)) return `[${value.map(canonical).join(",")}]`;
-  if (value && typeof value === "object") {
-    return `{${Object.entries(value).filter(([, v]) => v !== void 0).sort(([a], [b]) => a.localeCompare(b)).map(([key, v]) => `${JSON.stringify(key)}:${canonical(v)}`).join(",")}}`;
-  }
-  return JSON.stringify(value);
-}
-function fail(code, message, status = 409) {
-  throw new ContoError(message, { code, status });
-}
-var LIVE_API_ERRORS = {
-  POLICY_VIOLATION: {
-    status: 403,
-    message: "The request is not permitted.",
-    retryGuidance: "Verify credentials and permissions before trying again."
-  },
-  NOT_FOUND: {
-    status: 404,
-    message: "The requested resource was not found.",
-    retryGuidance: "Verify the resource identifier before trying again."
-  },
-  CONFLICT: {
-    status: 409,
-    message: "The request conflicts with the current resource state.",
-    retryGuidance: "Check the current resource state before trying again."
-  }
-};
-function liveApiError(code) {
-  const { status, message, retryGuidance } = LIVE_API_ERRORS[code];
-  throw new ContoError(message, { code, status, retryGuidance });
-}
-function createLinkTestClient(options = {}) {
-  const scenario = options.scenario ?? "approved";
-  const maximumAmountMinor = options.maximumAmountMinor ?? 5e3;
-  if (!["approved", "denied", "expired", "interrupted"].includes(scenario) || !Number.isSafeInteger(maximumAmountMinor) || maximumAmountMinor <= 0) {
-    throw new ContoError("Invalid Link simulation options", {
-      code: "INVALID_LINK_TEST_OPTIONS",
-      status: 0
-    });
-  }
-  const records = /* @__PURE__ */ new Map();
-  const intents = /* @__PURE__ */ new Map();
-  let sequence = 0;
-  const sessionId = randomUUID();
-  const read = (id) => {
-    const record = records.get(id);
-    if (!record) return liveApiError("NOT_FOUND");
-    return record;
-  };
-  const response = (id) => ({
-    execution: structuredClone(read(id))
-  });
-  const setStatus = (id, status, providerStatus, evidence = {}) => {
-    const record = read(id);
-    record.status = status;
-    record.providerStatus = `simulated_${providerStatus}`;
-    Object.assign(record.evidence, evidence, { status, providerStatus: record.providerStatus });
-    delete record.approvalUrl;
-    return response(id);
-  };
-  const setup = async (_input = {}) => ({
-    version: "conto.link-setup.v1",
-    mode: "SIMULATED",
-    // No live setting was inspected, so the simulator never reports CONFIGURED.
-    configurationStatus: "INCOMPLETE",
-    checks: [
-      {
-        code: "LOCAL_SIMULATION",
-        status: "WARNING",
-        actor: "developer",
-        message: "Local workflow fixture only. No real Link account, Conto policy, checkout, budget, or settlement is tested."
-      },
-      {
-        code: "LIVE_SETUP_NOT_INSPECTED",
-        status: "BLOCKED",
-        actor: "developer",
-        message: "The live Link configuration was not inspected. Call link.setup() on a live Conto client before a real payment."
-      }
-    ],
-    missingScopes: [],
-    paymentAuthorization: "NOT_EVALUATED",
-    providerVerified: false,
-    settlementVerified: false
-  });
-  const transport = {
-    getLinkSetup: setup,
-    async listStripeLinkPaymentMethods() {
-      return {
-        organizationId: "simulated_org",
-        connectionId: "simulated_connection",
-        paymentMethods: [
-          {
-            id: "simulated_method",
-            type: "SIMULATED",
-            isDefault: true,
-            displayLabel: "Simulated funding source (no funds)",
-            eligibleCredentialTypes: ["LINK_PAY_TOKEN"]
-          }
-        ]
-      };
-    },
-    async beginCommerceExecution(input) {
-      if (input.executionMethod !== "LINK_PAY_TOKEN")
-        return fail(
-          "SIMULATED_METHOD_UNSUPPORTED",
-          "Only the Link Pay Token workflow is simulated"
-        );
-      const key = input.idempotencyKey?.trim();
-      if (!key || key.length < 8 || key.length > 255) {
-        return fail(
-          "INVALID_IDEMPOTENCY_KEY",
-          "idempotencyKey must contain 8 to 255 characters",
-          0
-        );
-      }
-      const fingerprint = canonical({ ...input, idempotencyKey: key });
-      const prior = intents.get(key);
-      if (prior) {
-        if (prior.fingerprint !== fingerprint) return liveApiError("CONFLICT");
-        return response(prior.id);
-      }
-      if (scenario === "denied" || input.amountMinor > maximumAmountMinor) {
-        return liveApiError("POLICY_VIOLATION");
-      }
-      if (records.size >= 1e3)
-        return fail(
-          "SIMULATION_CAPACITY_REACHED",
-          "Create a new test client to start another simulation"
-        );
-      const id = `sim_link_${sessionId}_${++sequence}`;
-      const status = "AWAITING_APPROVAL";
-      const providerStatus = "simulated_pending_approval";
-      const evidence = {
-        mode: "SIMULATED",
-        schemaVersion: "conto.commerce-evidence.v1",
-        traceId: `sim_trace_${sequence}`,
-        executionId: id,
-        intentId: `sim_intent_${sequence}`,
-        organizationId: "simulated_org",
-        actorUserId: "simulated_owner",
-        agentId: "simulated_agent",
-        provider: "STRIPE_LINK",
-        sourceKind: "STRIPE_LINK",
-        amountMinor: input.amountMinor,
-        currency: input.currency,
-        purpose: input.purpose,
-        counterpartyId: input.counterparty.canonicalId,
-        counterpartyName: "Simulated checkout",
-        intentFingerprint: `sim_fingerprint_${sequence}`,
-        policyDecisionId: `sim_policy_${sequence}`,
-        policySnapshotHash: "simulated_policy",
-        grantId: `sim_grant_${sequence}`,
-        status,
-        deliveryMode: "SERVER_ONLY_ARTIFACT",
-        artifactKind: "LINK_PAY_TOKEN",
-        providerStatus
-      };
-      records.set(id, {
-        mode: "SIMULATED",
-        id,
-        intentId: evidence.intentId,
-        organizationId: evidence.organizationId,
-        agentId: evidence.agentId,
-        provider: "STRIPE_LINK",
-        executionAdapter: "STRIPE_LINK",
-        executionChannel: "BROWSER",
-        checkoutMethod: "LINK",
-        status,
-        providerStatus,
-        artifactKind: "LINK_PAY_TOKEN",
-        deliveryMode: "SERVER_ONLY_ARTIFACT",
-        // Reserved .invalid domain. It cannot approve anything. Call the test-only approve() method.
-        approvalUrl: `https://link-simulation.invalid/approve/${id}`,
-        amountMinor: input.amountMinor,
-        currency: input.currency,
-        purpose: input.purpose,
-        counterparty: { id: input.counterparty.canonicalId, name: "Simulated checkout" },
-        evidence,
-        evidenceFingerprint: `sim_evidence_${sequence}`
-      });
-      intents.set(key, { fingerprint, id });
-      return response(id);
-    },
-    async getCommerceExecution(id) {
-      return response(id);
-    },
-    // Like a live refresh, this observes the provider and never submits a payment.
-    // A submitted simulated checkout is observed as succeeded on the next refresh.
-    async refreshCommerceExecution(id) {
-      const { status, providerStatus } = read(id);
-      if (status === "PROCESSING" && providerStatus === "simulated_checkout_submitted")
-        return setStatus(id, "SETTLED", "succeeded");
-      return response(id);
-    },
-    async executeCommerceExecution(id) {
-      if (read(id).status !== "READY") return liveApiError("CONFLICT");
-      if (scenario === "interrupted") {
-        setStatus(id, "NEEDS_RECONCILIATION", "checkout_outcome_unknown");
-        throw new ContoError("Network request failed", { code: "NETWORK_ERROR", status: 0 });
-      }
-      return {
-        ...setStatus(id, "PROCESSING", "checkout_submitted", {
-          checkoutReference: id.replace(/^sim_link_/, "sim_checkout_")
-        }),
-        checkout: {
-          submitted: true,
-          deliveryMode: "SERVER_ONLY_ARTIFACT",
-          accepted: true
-        }
-      };
-    },
-    async cancelCommerceExecution(id) {
-      if (["PROCESSING", "NEEDS_RECONCILIATION", "COMPLETED", "SETTLED"].includes(read(id).status)) {
-        return liveApiError("CONFLICT");
-      }
-      return setStatus(id, "CANCELLED", "canceled");
-    }
-  };
-  const client = new LinkClient(transport, {
-    connectionId: "simulated_connection",
-    paymentMethodId: "simulated_method"
-  });
-  const marked = async (operation) => {
-    try {
-      return { ...await operation(), mode: "SIMULATED", settlementVerified: false };
-    } catch (error) {
-      const safe = error instanceof ContoError ? error : new ContoError("Local simulation failed", { code: "SIMULATION_FAILED", status: 0 });
-      throw Object.assign(safe, { mode: "SIMULATED", settlementVerified: false });
-    }
-  };
-  const payment = (operation) => marked(operation);
-  return {
-    mode: "SIMULATED",
-    link: {
-      setup: (input) => marked(() => client.setup(input)),
-      paymentMethods: () => marked(() => client.paymentMethods()),
-      pay: (input) => payment(() => client.pay(input)),
-      resume: (id) => payment(() => client.resume(id)),
-      status: (id) => payment(() => client.status(id)),
-      cancel: (id) => payment(() => client.cancel(id)),
-      /** Test-only owner action. Never available on the live Link client. */
-      approve: (id) => payment(async () => {
-        if (read(id).status !== "AWAITING_APPROVAL")
-          return fail(
-            "SIMULATED_APPROVAL_UNAVAILABLE",
-            "This simulation is not awaiting approval"
-          );
-        if (scenario === "expired") setStatus(id, "EXPIRED", "expired");
-        else setStatus(id, "READY", "approved");
-        return client.status(id);
-      })
-    }
-  };
-}
-export {
-  createLinkTestClient
-};