@dvmkit/sdk 0.7.0-rc.1 → 0.7.0-rc.3

package/dist/{content-retention-DHyLdA6b.d.ts → content-retention-ChFSSVO0.d.ts}

@@ -1,4 +1,4 @@
-import { b as JobStore, J as JobRecord } from './job-store-DdLXBpol.js';
+import { b as JobStore, J as JobRecord } from './job-store-DkfNE9sv.js';
 
 /** Authenticated caller metadata; omitted fields on older services mean unknown. */
 interface JobContentMetadata {

package/dist/{credit-ledger-MCUXYKSJ.js → credit-ledger-7Z7LOCTN.js}

@@ -10,11 +10,11 @@ import {
   isDrainMethod,
   isFundingRail,
   x402SettlementPending
-} from "./chunk-6XF3RVVX.js";
-import "./chunk-COYKJRMM.js";
-import "./chunk-P6QON7ER.js";
+} from "./chunk-SPYEJXI7.js";
+import "./chunk-TRNMTTPX.js";
 import "./chunk-BPYMEMQX.js";
-import "./chunk-ETXDTUJO.js";
+import "./chunk-LAKP6FUI.js";
+import "./chunk-COYKJRMM.js";
 export {
   CreditLedger,
   CreditLedgerError,

package/dist/{credit-menu-DjnkeEUU.d.ts → credit-menu-fy0DDigm.d.ts}

@@ -1,11 +1,11 @@
-import { g as LockPubkey, f as CheckMintHealthOptions, b as LightningBackend, A as AttestationPayload } from './lightning-backend-Bw-qtAbt.js';
-import { cf as HostingCleanupFence, cV as HostedIntent, aj as FundingMethod, o as PaymentMethod, bN as CreditLedgerLike, a3 as Message, _ as FundingReceipt, bP as CreditSnapshot, $ as JobReceipt, S as SDKJobContext, aw as StepCache, u as ResponseContent, P as PaymentContent, a4 as MessageType, bj as X402Receipt, aE as X402Config, bi as X402ExactVersionSupport, cW as X402SettlementIntent, aa as PaymentRequirementsV2, cX as HostedFundingReservation, c2 as CreditLedgerQuerier, cY as X402SettlementCursor, bR as X402SettlementStatus, cZ as X402SettlementWriteOff, bO as X402RefundSettlementGate, c_ as X402FacilitatorAuth, c$ as X402BatchSettlementConfig, cB as PostgresX402ChannelStorage, d0 as X402PayoutObserver, bL as HostedSettlementReportObligations, br as MppxServer, ae as CashuMode, d1 as CreditDepositEnqueue, d2 as X402SettlementReconciliationReason, aq as PaymentRequirements, a2 as MppxCredential, bm as CreditDepositPayload, bQ as DrawResult, cp as CreditLedgerError, a7 as ReceiptCredit, ag as DrainReceiptEvent, a6 as DrainReceipt, K as KVStore, y as SignedRequestAudience, d3 as CreditDrawReleaseEnqueue, cz as JobCostReportPayload, cA as JobTerminalReportPayload, cD as RevenueSkippedNoRailPayload, Z as ZodLike, a as DVMDescriptor, bW as CreditInvoiceRecord, bX as InvoiceSettlement, cj as ClientCompatibilityGate, ch as ClientCompatibility, bv as PostgresTempoSessionStore, bu as PayoutReporter, R as ResolvedCreditConfig, g as CreditView } from './step-cache-2MkvenJn.js';
+import { f as LockPubkey, e as CheckMintHealthOptions, b as LightningBackend, A as AttestationPayload } from './lightning-backend-C3Gf1XpP.js';
+import { cf as HostingCleanupFence, cV as HostedIntent, ai as FundingMethod, o as PaymentMethod, bN as CreditLedgerLike, a4 as Message, _ as FundingReceipt, bP as CreditSnapshot, $ as JobReceipt, S as SDKJobContext, aw as StepCache, u as ResponseContent, P as PaymentContent, a0 as MessageType, bj as X402Receipt, aE as X402Config, bi as X402ExactVersionSupport, cW as X402SettlementIntent, aa as PaymentRequirementsV2, cX as HostedFundingReservation, c2 as CreditLedgerQuerier, cY as X402SettlementCursor, bR as X402SettlementStatus, cZ as X402SettlementWriteOff, bO as X402RefundSettlementGate, c_ as X402FacilitatorAuth, c$ as X402BatchSettlementConfig, cB as PostgresX402ChannelStorage, d0 as X402PayoutObserver, bL as HostedSettlementReportObligations, br as MppxServer, ad as CashuMode, d1 as CreditDepositEnqueue, d2 as X402SettlementReconciliationReason, ap as PaymentRequirements, a2 as MppxCredential, bm as CreditDepositPayload, bQ as DrawResult, cp as CreditLedgerError, a6 as ReceiptCredit, af as DrainReceiptEvent, a7 as DrainReceipt, K as KVStore, y as SignedRequestAudience, d3 as CreditDrawReleaseEnqueue, cz as JobCostReportPayload, cA as JobTerminalReportPayload, cD as RevenueSkippedNoRailPayload, Z as ZodLike, a as DVMDescriptor, bW as CreditInvoiceRecord, bX as InvoiceSettlement, cj as ClientCompatibilityGate, ch as ClientCompatibility, bv as PostgresTempoSessionStore, bu as PayoutReporter, R as ResolvedCreditConfig, g as CreditView } from './step-cache-DDTwd4SK.js';
 import { ProofLike, SerializedDLEQ, Proof } from '@cashu/cashu-ts';
 import { Hono, Context } from 'hono';
 import { Pool } from 'pg';
-import { b as FxRateSnapshot, F as FxFetcher } from './fx-zMWFzfrU.js';
+import { b as FxRateSnapshot, F as FxFetcher } from './fx-DM0_NYiE.js';
 import { Store, Challenge } from 'mppx';
-import { T as TopUpCapUnenforcedReason, A as AppendOutgoingOptions, J as JobRecord, b as JobStore } from './job-store-DdLXBpol.js';
+import { T as TopUpCapUnenforcedReason, A as AppendOutgoingOptions, J as JobRecord, b as JobStore } from './job-store-DkfNE9sv.js';
 import { SettleResponse, SupportedResponse } from '@x402/core/types';
 import { Channel, AutoSettlementConfig } from '@x402/evm/batch-settlement/server';
 import { FacilitatorClient } from '@x402/core/server';
@@ -1430,9 +1430,9 @@ interface X402SettlementEvidenceReader extends X402ExactSettlementEvidenceReader
 declare const X402_BATCH_SETTLEMENT_NETWORK = "eip155:84532";
 /** Base mainnet channel network, enabled only with an in-process relay. */
 declare const X402_BATCH_SETTLEMENT_MAINNET_NETWORK = "eip155:8453";
-/** Policy floor advertised to callers and enforced at boot. */
+/** Default withdrawal grace and minimum outside Base Sepolia; seconds. */
 declare const X402_BATCH_MIN_WITHDRAW_DELAY_SECONDS = 86400;
-/** Default claim and transfer cadence; comfortably inside the 24-hour exit window. */
+/** Default claim and transfer cadence; comfortably inside the default 24-hour exit window. */
 declare const X402_BATCH_AUTO_SETTLEMENT: AutoSettlementConfig;
 /** Natural identity and incremental value carried by an accepted channel voucher. */
 interface X402BatchFunding {

package/dist/{fx-zMWFzfrU.d.ts → fx-DM0_NYiE.d.ts}

@@ -1,4 +1,4 @@
-import { C as Currency } from './step-cache-2MkvenJn.js';
+import { C as Currency } from './step-cache-DDTwd4SK.js';
 
 /**
  * Quote-time FX snapshot. `rates` maps configured lowercase currency codes to

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { C as Currency, Z as ZodLike, D as DVMConfig, a as DVMDescriptor } from './step-cache-2MkvenJn.js';
-export { A as ApprovalContent, b as ArtifactContent, c as CancelContent, d as CanonicalEnvelope, e as CreateSignedRequestVerifierOpts, f as CreditConfig, g as CreditView, h as DEFAULT_CREDIT_MAX, i as DEFAULT_CREDIT_MIN, j as DEFAULT_CREDIT_TTL_SECONDS, k as DEFAULT_JOB_RETENTION_DAYS, l as DVMRouteContext, I as IncomingMessage, m as InputType, n as InvalidCurrencyError, J as JobCost, K as KVStore, L as Logger, P as PaymentContent, o as PaymentMethod, p as PriceValue, q as ProgressContent, r as PromptOpts, Q as QuoteConfig, s as QuoteContext, t as QuoteResult, R as ResolvedCreditConfig, u as ResponseContent, S as SDKJobContext, v as SDKPaymentRequestOpts, w as SIGNED_REQUEST_AUTH_ID, x as SIGNED_REQUEST_STATEMENT_VERSION, y as SignedRequestAudience, z as SignedRequestDomain, B as SignedRequestError, E as SignedRequestFailure, F as SignedRequestReplayStore, G as SignedRequestSignOpts, H as SignedRequestStatementHeader, M as SignedRequestVerifier, U as UnsupportedCurrencyError, N as createSignedRequestVerifier, O as isZodSchema, T as signedRequestStatementHeader, V as validateCurrency } from './step-cache-2MkvenJn.js';
-export { C as CreateFxFetcherOpts, D as DEFAULT_FX_CURRENCIES, a as DEFAULT_FX_RATE_SOURCE, F as FxFetcher, b as FxRateSnapshot, c as FxRateUnavailableError, P as PlatformFxSource, d as createFxFetcher, f as fxRateFor, r as resolveFxSourceFromEnv } from './fx-zMWFzfrU.js';
-export { I as InvalidFxRateError, f as fiatToSatsCeil, a as formatFiat, b as formatUsd, r as roundUsd, s as satsToFiat } from './usd-DI3d3gTK.js';
-export { J as JobRecord, a as JobStatus, b as JobStore } from './job-store-DdLXBpol.js';
+import { C as Currency, Z as ZodLike, D as DVMConfig, a as DVMDescriptor } from './step-cache-DDTwd4SK.js';
+export { A as ApprovalContent, b as ArtifactContent, c as CancelContent, d as CanonicalEnvelope, e as CreateSignedRequestVerifierOpts, f as CreditConfig, g as CreditView, h as DEFAULT_CREDIT_MAX, i as DEFAULT_CREDIT_MIN, j as DEFAULT_CREDIT_TTL_SECONDS, k as DEFAULT_JOB_RETENTION_DAYS, l as DVMRouteContext, I as IncomingMessage, m as InputType, n as InvalidCurrencyError, J as JobCost, K as KVStore, L as Logger, P as PaymentContent, o as PaymentMethod, p as PriceValue, q as ProgressContent, r as PromptOpts, Q as QuoteConfig, s as QuoteContext, t as QuoteResult, R as ResolvedCreditConfig, u as ResponseContent, S as SDKJobContext, v as SDKPaymentRequestOpts, w as SIGNED_REQUEST_AUTH_ID, x as SIGNED_REQUEST_STATEMENT_VERSION, y as SignedRequestAudience, z as SignedRequestDomain, B as SignedRequestError, E as SignedRequestFailure, F as SignedRequestReplayStore, G as SignedRequestSignOpts, H as SignedRequestStatementHeader, M as SignedRequestVerifier, U as UnsupportedCurrencyError, N as createSignedRequestVerifier, O as isZodSchema, T as signedRequestStatementHeader, V as validateCurrency } from './step-cache-DDTwd4SK.js';
+export { C as CreateFxFetcherOpts, D as DEFAULT_FX_CURRENCIES, a as DEFAULT_FX_RATE_SOURCE, F as FxFetcher, b as FxRateSnapshot, c as FxRateUnavailableError, P as PlatformFxSource, d as createFxFetcher, f as fxRateFor, r as resolveFxSourceFromEnv } from './fx-DM0_NYiE.js';
+export { I as InvalidFxRateError, f as fiatToSatsCeil, a as formatFiat, b as formatUsd, r as roundUsd, s as satsToFiat } from './usd-DkRy9nfU.js';
+export { J as JobRecord, a as JobStatus, b as JobStore } from './job-store-DkfNE9sv.js';
 export { P as PinnedFetch, S as SSRFError, a as SSRFGuardOpts, b as SSRFReason, c as SSRFResolver, d as assertSafeUrl, e as createPinnedFetch } from './ssrf-dMooihtY.js';
 export { z } from 'zod';
 import 'hono';

package/dist/index.js

@@ -5,13 +5,12 @@ import {
   envFlag
 } from "./chunk-TVI4V7GF.js";
 import {
-  configureDVM,
-  isConfiguredDVMDescriptor
-} from "./chunk-HCLVYZUZ.js";
+  CAPABILITY_NAME_RE
+} from "./chunk-A262WVYX.js";
 import {
   SignedRequestError,
   createSignedRequestVerifier
-} from "./chunk-N5RZ5HVB.js";
+} from "./chunk-72V5DTEC.js";
 import {
   DEFAULT_CREDIT_MAX,
   DEFAULT_CREDIT_MIN,
@@ -21,29 +20,250 @@ import {
   SIGNED_REQUEST_STATEMENT_VERSION,
   isZodSchema,
   signedRequestStatementHeader
-} from "./chunk-RCM3P2HE.js";
-import "./chunk-OFVV37XC.js";
+} from "./chunk-UKD3R2KU.js";
+import {
+  buildUpfront
+} from "./chunk-USL7ZEXN.js";
 import {
   DEFAULT_FX_CURRENCIES,
   DEFAULT_FX_RATE_SOURCE,
   FxRateUnavailableError,
   InvalidCurrencyError,
+  InvalidFxRateError,
   UnsupportedCurrencyError,
-  buildUpfront,
   createFxFetcher,
-  fxRateFor,
-  resolveFxSourceFromEnv,
-  validateCurrency
-} from "./chunk-BYCEKO65.js";
-import {
-  InvalidFxRateError,
   fiatToSatsCeil,
   formatFiat,
   formatUsd,
+  fxRateFor,
+  parseUsdPrice,
+  resolveFxSourceFromEnv,
   roundUsd,
-  satsToFiat
-} from "./chunk-AT6V3SY7.js";
-import "./chunk-ETXDTUJO.js";
+  satsToFiat,
+  validateCurrency
+} from "./chunk-CLIAFTUR.js";
+import "./chunk-LAKP6FUI.js";
+
+// src/sdk/configure.ts
+function configureDVM(config) {
+  const tags = collectTags(config);
+  const currency = resolvePricingCurrency(config.currency);
+  const capabilities = buildCapabilityMap(config, currency);
+  const jobRetentionDays = resolveJobRetentionDays(config.jobRetentionDays);
+  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,
+    jobRetentionDays,
+    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 resolveJobRetentionDays(raw) {
+  const days = raw ?? DEFAULT_JOB_RETENTION_DAYS;
+  if (!Number.isSafeInteger(days) || days < 0 || days > Math.floor((Number.MAX_SAFE_INTEGER - Date.now()) / 864e5)) {
+    throw new Error(
+      `configureDVM: jobRetentionDays must be a non-negative whole number of days; received ${JSON.stringify(raw)}`
+    );
+  }
+  return days;
+}
+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]];
+}
 
 // src/sdk/heartbeat.ts
 async function withProgressHeartbeat(opts, fn) {