@dvmkit/sdk 0.1.0-rc.2 → 0.1.0-rc.4

package/dist/chunk-XYTSDAPH.js

@@ -0,0 +1,232 @@
+import {
+  DEFAULT_CREDIT_MAX,
+  DEFAULT_CREDIT_MIN,
+  DEFAULT_CREDIT_TTL_SECONDS,
+  isZodSchema
+} from "./chunk-AZBXSXQT.js";
+import {
+  InvalidCurrencyError,
+  validateCurrency
+} from "./chunk-27V2ILSR.js";
+import {
+  parseUsdPrice
+} from "./chunk-AT6V3SY7.js";
+
+// src/lib/wire-schema.ts
+var CAPABILITY_NAME_RE = /^[a-z0-9][a-z0-9-]*$/;
+
+// src/sdk/configure.ts
+function configureDVM(config) {
+  const tags = collectTags(config);
+  const currency = resolvePricingCurrency(config.currency);
+  const capabilities = buildCapabilityMap(config, currency);
+  const onlyCapability = singleCapabilityEntry(capabilities);
+  const descriptor = {
+    name: config.name,
+    description: config.description ?? "",
+    tags,
+    currency,
+    price: onlyCapability?.price,
+    inputSchema: onlyCapability?.input,
+    state: onlyCapability?.state ?? {},
+    idleTimeout: config.idleTimeout ?? 3600,
+    processingWatchdog: config.processingWatchdog,
+    config,
+    capabilities,
+    paymentMethods: config.paymentMethods,
+    x402: config.x402,
+    mpp: config.mpp,
+    credit: resolveCreditConfig(config.credit),
+    auth: config.auth
+  };
+  CONFIGURED_DVM_DESCRIPTORS.add(descriptor);
+  return Object.freeze(descriptor);
+}
+function isConfiguredDVMDescriptor(value) {
+  return typeof value === "object" && value !== null && CONFIGURED_DVM_DESCRIPTORS.has(value);
+}
+var CONFIGURED_DVM_DESCRIPTORS = /* @__PURE__ */ new WeakSet();
+function resolvePricingCurrency(raw) {
+  if (raw === void 0) return "usd";
+  try {
+    return validateCurrency(raw);
+  } catch (err) {
+    if (err instanceof InvalidCurrencyError) {
+      throw new Error(
+        `configureDVM: currency ${JSON.stringify(raw)} is not an ISO 4217 lowercase code like "usd" or "eur". Omit the field to price in USD.`,
+        { cause: err }
+      );
+    }
+    throw err;
+  }
+}
+function resolveCreditConfig(credit) {
+  if (!credit) return void 0;
+  const min = credit.min ?? DEFAULT_CREDIT_MIN;
+  const max = credit.max ?? DEFAULT_CREDIT_MAX;
+  const ttlSeconds = credit.ttl ?? DEFAULT_CREDIT_TTL_SECONDS;
+  const minAmount = validatePriceLiteral(min, "credit.min");
+  const maxAmount = validatePriceLiteral(max, "credit.max");
+  if (minAmount > maxAmount) {
+    throw new Error(
+      `credit.min (${JSON.stringify(min)}) exceeds credit.max (${JSON.stringify(max)}) \u2014 no funding amount could satisfy both.`
+    );
+  }
+  if (!Number.isFinite(ttlSeconds) || ttlSeconds <= 0) {
+    throw new Error(`credit.ttl must be a positive number of seconds (got ${ttlSeconds}).`);
+  }
+  const allowOneShotStablecoin = credit.allowOneShotStablecoin === true;
+  return { min, max, ttlSeconds, allowOneShotStablecoin };
+}
+function validatePriceLiteral(value, field, key = field) {
+  if (typeof value === "number") {
+    throw new Error(
+      `${field} is a number (${value}). Prices are USD literals \u2014 write ${key}: "$0.01" for one cent. Callers still pay in sats; the SDK converts at request time. Omit the field for a free capability, or use \`onQuote\` for dynamic pricing.`
+    );
+  }
+  if (typeof value !== "string") {
+    throw new Error(`${field} must be a USD literal like "$0.05" (got ${JSON.stringify(value)}).`);
+  }
+  return parseUsdPrice(value, field);
+}
+function validateCapabilityPrice(price, capabilityName, currency) {
+  if (price === void 0) return;
+  if (currency !== "usd") {
+    throw new Error(
+      `configureDVM: capability "${capabilityName}" declares a static price (${JSON.stringify(price)}) but this DVM prices in ${currency}. Static prices are USD literals, so they cannot express ${currency} \u2014 price this capability with \`onQuote\` returning { amount, currency: ${JSON.stringify(currency)} }, or drop the DVM-level \`currency\` to price in USD.`
+    );
+  }
+  validatePriceLiteral(price, `configureDVM: capability "${capabilityName}" price`, "price");
+}
+function collectTags(config) {
+  const tagSet = /* @__PURE__ */ new Set();
+  if (config.tag) tagSet.add(config.tag);
+  if (config.tags) {
+    for (const t of config.tags) tagSet.add(t);
+  }
+  return [...tagSet];
+}
+function buildCapabilityMap(config, currency) {
+  const hasExplicitBlock = config.capabilities !== void 0;
+  const hasFlatCapabilityName = typeof config.capability === "string";
+  const hasFlatHandler = typeof config.onJob === "function";
+  if (hasExplicitBlock && (hasFlatCapabilityName || hasFlatHandler || flatPerCapFieldsSet(config))) {
+    throw new Error(
+      "configureDVM: pass either the flat single-capability shape (capability + onJob + ...) or the explicit `capabilities` block, not both."
+    );
+  }
+  if (hasExplicitBlock) {
+    return buildExplicitCapabilities(config.capabilities ?? {}, currency);
+  }
+  if (!hasFlatHandler) {
+    throw new Error("configureDVM: onJob handler is required");
+  }
+  const name = typeof config.capability === "string" ? config.capability : slugifyCapabilityName(config.name);
+  validateCapabilityName(name);
+  validateCapabilityPrice(config.price, name, currency);
+  validateExampleAgainstInput(name, config.input, config.example);
+  const entry = {
+    name,
+    description: config.description ?? "",
+    input: config.input,
+    example: config.example,
+    state: config.state ?? {},
+    price: config.price,
+    onQuote: config.onQuote,
+    onJob: config.onJob,
+    onResponse: config.onResponse,
+    onPayment: config.onPayment,
+    onApproval: config.onApproval,
+    onCancel: config.onCancel,
+    onMessage: config.onMessage
+  };
+  return { [name]: entry };
+}
+function buildExplicitCapabilities(capabilities, currency) {
+  const keys = Object.keys(capabilities);
+  if (keys.length === 0) {
+    throw new Error("configureDVM: `capabilities` block must declare at least one capability");
+  }
+  const out = {};
+  for (const name of keys) {
+    validateCapabilityName(name);
+    const cap = capabilities[name];
+    if (typeof cap.onJob !== "function") {
+      throw new Error(`configureDVM: capability "${name}" is missing required onJob handler`);
+    }
+    validateCapabilityPrice(cap.price, name, currency);
+    validateExampleAgainstInput(name, cap.input, cap.example);
+    const entry = {
+      name,
+      description: cap.description ?? "",
+      // Per-capability `input` is the builder's Zod schema; the `any` widening
+      // through `Record<string, CapabilityConfig<any, any>>` is unavoidable
+      // here.
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+      input: cap.input,
+      example: cap.example,
+      state: cap.state !== void 0 ? structuredClone(cap.state) : {},
+      price: cap.price,
+      onQuote: cap.onQuote,
+      onJob: cap.onJob,
+      onResponse: cap.onResponse,
+      onPayment: cap.onPayment,
+      onApproval: cap.onApproval,
+      onCancel: cap.onCancel,
+      onMessage: cap.onMessage
+    };
+    out[name] = entry;
+  }
+  return out;
+}
+function flatPerCapFieldsSet(config) {
+  return config.input !== void 0 || config.example !== void 0 || config.state !== void 0 || config.price !== void 0 || config.onQuote !== void 0 || typeof config.onResponse === "function" || typeof config.onPayment === "function" || typeof config.onApproval === "function" || typeof config.onCancel === "function" || typeof config.onMessage === "function";
+}
+function validateExampleAgainstInput(capName, input, example) {
+  if (example === void 0) return;
+  if (!isZodSchema(input)) return;
+  const result = input.safeParse(example);
+  if (result.success) return;
+  throw new Error(
+    `configureDVM: capability "${capName}" example does not satisfy its input schema. Update the example to match the schema (including any \`.refine()\` checks). Issues: ${formatZodIssues(result.error)}`
+  );
+}
+function formatZodIssues(err) {
+  if (err && typeof err === "object" && "issues" in err && Array.isArray(err.issues)) {
+    const issues = err.issues;
+    if (issues.length === 0) return "(no issues reported)";
+    return issues.map((issue) => {
+      const path = issue.path.length > 0 ? issue.path.join(".") : "(root)";
+      return `${path}: ${issue.message}`;
+    }).join("; ");
+  }
+  if (err && typeof err === "object" && "message" in err && typeof err.message === "string") {
+    return err.message.replace(/\s+/g, " ").trim();
+  }
+  try {
+    return JSON.stringify(err);
+  } catch {
+    return String(err);
+  }
+}
+function validateCapabilityName(name) {
+  if (!CAPABILITY_NAME_RE.test(name)) {
+    throw new Error(
+      `configureDVM: invalid capability name "${name}" \u2014 must be lowercase letters/digits/hyphens, must start with a letter or digit, must not contain slashes.`
+    );
+  }
+}
+function slugifyCapabilityName(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function singleCapabilityEntry(capabilities) {
+  const keys = Object.keys(capabilities);
+  if (keys.length !== 1) return void 0;
+  return capabilities[keys[0]];
+}
+
+export {
+  CAPABILITY_NAME_RE,
+  configureDVM,
+  isConfiguredDVMDescriptor
+};

package/dist/{credit-ledger-RO4FGSHG.js → credit-ledger-ED6JXKVD.js}

@@ -10,8 +10,8 @@ import {
   isDrainMethod,
   isFundingRail,
   x402SettlementPending
-} from "./chunk-365P52XQ.js";
-import "./chunk-H25M54MI.js";
+} from "./chunk-LWUR4CGG.js";
+import "./chunk-C3MTFLC6.js";
 import "./chunk-S3XAHZQY.js";
 export {
   CreditLedger,