@dvmkit/sdk 0.1.1-rc.7 → 0.1.3-rc.7

package/dist/{chunk-TKA6ZP4M.js → chunk-4B56DEEV.js}

@@ -1,42 +1,11 @@
 import {
-  initCallerLoggers
-} from "./chunk-66HGCPBU.js";
+  StepCache,
+  loggers
+} from "./chunk-YDIYXGYL.js";
 import {
   redactUrl
 } from "./chunk-FUJ36YDV.js";
 
-// src/sdk/step-cache.ts
-var StepCache = class _StepCache {
-  cache = /* @__PURE__ */ new Map();
-  /** Check if a step result is cached. */
-  has(id) {
-    return this.cache.has(id);
-  }
-  /** Get a cached step result. Throws if not present. */
-  get(id) {
-    if (!this.cache.has(id)) {
-      throw new Error(`StepCache: no cached result for step "${id}"`);
-    }
-    return this.cache.get(id);
-  }
-  /** Cache a step result. */
-  set(id, value) {
-    this.cache.set(id, value);
-  }
-  /** Export all cached steps for persistence. */
-  serialize() {
-    return [...this.cache.entries()].map(([id, value]) => ({ id, value }));
-  }
-  /** Restore a StepCache from persisted records. */
-  static deserialize(records) {
-    const cache = new _StepCache();
-    for (const { id, value } of records) {
-      cache.set(id, value);
-    }
-    return cache;
-  }
-};
-
 // src/sdk/server/job.ts
 function toJobRecord(job) {
   return {
@@ -218,6 +187,9 @@ function accumulateAskedTopUp(prior, ask) {
   return { micro: prior.micro + ask.micro, currency: prior.currency, reason: prior.reason };
 }
 var UNCAPPABLE_ASK_TOTAL = -1;
+function isJobRetentionStore(store) {
+  return "listJobsForRetention" in store && "redactJob" in store;
+}
 function isReceiptIssuingStore(store) {
   return "claimReceiptSeq" in store && "saveReceipt" in store;
 }
@@ -298,7 +270,7 @@ var MemoryJobStore = class {
         }
       }
     }
-    if (existing && isTerminal(existing.status) && existing.status !== record.status) {
+    if (existing && (existing.redactedAt !== void 0 || isTerminal(existing.status) && existing.status !== record.status)) {
       return Promise.resolve();
     }
     const snapshot = structuredClone(record);
@@ -318,6 +290,38 @@ var MemoryJobStore = class {
     this.receiptSeqs.delete(id);
     return Promise.resolve();
   }
+  listJobsForRetention(args) {
+    const capabilitySet = args.capabilities === null ? null : new Set(args.capabilities);
+    const matches = [...this.data.values()].filter(
+      (record) => record.redactedAt === void 0 && isTerminal(record.status) && record.lastActivityAt < args.lastActivityBeforeMs && (capabilitySet === null || capabilitySet.has(record.capability)) && (!args.after || compareRetentionKey(record, args.after) > 0)
+    ).sort(compareRetentionKey).slice(0, args.limit).map((record) => structuredClone(record));
+    return Promise.resolve(matches);
+  }
+  redactJob(args) {
+    const record = this.data.get(args.jobId);
+    if (!record || record.redactedAt !== void 0 || !isTerminal(record.status) || record.lastActivityAt !== args.expectedLastActivityAt) {
+      return Promise.resolve(false);
+    }
+    record.input = "";
+    record.params = {};
+    record.summary = void 0;
+    record.messages = [];
+    record.receivedProofs = [];
+    record.pendingPaymentMsats = void 0;
+    record.pendingMppChallengeIds = void 0;
+    record.pendingX402Nonce = void 0;
+    record.pendingX402AmountUsdcMicro = void 0;
+    record.pendingPaymentFiatMicro = void 0;
+    record.pendingPaymentFiatCurrency = void 0;
+    record.stepCache = [];
+    record.state = {};
+    record.requesterToken = void 0;
+    record.requestFingerprint = void 0;
+    record.authRequestPath = void 0;
+    record.redactedAt = args.redactedAt;
+    this.messages.delete(args.jobId);
+    return Promise.resolve(true);
+  }
   claimReceiptSeq(jobId) {
     if (!this.data.has(jobId)) {
       return Promise.reject(new Error(`claimReceiptSeq: job ${jobId} not found`));
@@ -336,7 +340,9 @@ var MemoryJobStore = class {
   }
   appendOutgoing(jobId, message, opts) {
     const record = this.data.get(jobId);
-    if (!record) return Promise.reject(new Error(`appendOutgoing: job ${jobId} not found`));
+    if (!record || record.redactedAt !== void 0) {
+      return Promise.reject(new Error(`appendOutgoing: job ${jobId} not found`));
+    }
     const seq = this.allocateSeq(jobId);
     const fullMessage = { ...message, seq };
     this.messagesFor(jobId).push({ message: fullMessage, status: "verified" });
@@ -373,7 +379,9 @@ var MemoryJobStore = class {
   }
   recordInbound(jobId, message) {
     const record = this.data.get(jobId);
-    if (!record) return Promise.reject(new Error(`recordInbound: job ${jobId} not found`));
+    if (!record || record.redactedAt !== void 0) {
+      return Promise.reject(new Error(`recordInbound: job ${jobId} not found`));
+    }
     const seq = this.allocateSeq(jobId);
     const fullMessage = { ...message, seq };
     this.messagesFor(jobId).push({ message: fullMessage, status: "pending-verification" });
@@ -611,6 +619,9 @@ var MemoryJobStore = class {
     if (subs) for (const cb of subs) cb();
   }
 };
+function compareRetentionKey(a, b) {
+  return a.lastActivityAt - b.lastActivityAt || a.id.localeCompare(b.id);
+}
 function requestIdClaimKey(requesterPubkey, requestId) {
   return `${requesterPubkey}\0${requestId}`;
 }
@@ -629,340 +640,6 @@ function snapshotCounters(record) {
   };
 }
 
-// src/sdk/logger.ts
-function createConsoleLogger(jobId) {
-  const fmt = (message, data) => {
-    const parts = [`[${jobId}] ${message}`];
-    if (data) parts.push(data);
-    return parts;
-  };
-  return {
-    debug(message, data) {
-      console.debug(...fmt(message, data));
-    },
-    info(message, data) {
-      console.info(...fmt(message, data));
-    },
-    warn(message, data) {
-      console.warn(...fmt(message, data));
-    },
-    error(message, data) {
-      console.error(...fmt(message, data));
-    }
-  };
-}
-function createStdoutLogger(context) {
-  const emit = (sink, level) => (message, data) => {
-    sink(JSON.stringify({ level, msg: message, ...context, ...data }));
-  };
-  return {
-    debug: emit(console.debug.bind(console), "debug"),
-    info: emit(console.info.bind(console), "info"),
-    warn: emit(console.warn.bind(console), "warn"),
-    error: emit(console.error.bind(console), "error")
-  };
-}
-function createNoopLogger() {
-  const noop2 = () => {
-  };
-  return { debug: noop2, info: noop2, warn: noop2, error: noop2 };
-}
-
-// src/observability/context.ts
-import { AsyncLocalStorage } from "async_hooks";
-import { randomBytes, randomUUID } from "crypto";
-var storage = new AsyncLocalStorage();
-var defaultService = "unknown";
-function setDefaultService(service) {
-  defaultService = service;
-}
-function randomTraceId() {
-  const buf = randomBytes(16);
-  const now = Date.now();
-  buf.writeUInt16BE(Math.floor(now / 4294967296), 0);
-  buf.writeUInt32BE(now % 4294967296, 2);
-  buf[6] = buf[6] & 15 | 112;
-  buf[8] = buf[8] & 63 | 128;
-  return buf.toString("hex");
-}
-function randomSpanId() {
-  return randomUUID().replace(/-/g, "").slice(0, 16);
-}
-function withTraceContext(ctx, fn) {
-  return storage.run(ctx, fn);
-}
-function currentContext(service) {
-  const ctx = storage.getStore();
-  if (ctx) return ctx;
-  return {
-    traceId: randomTraceId(),
-    spanId: null,
-    dimensions: {},
-    service: service ?? defaultService
-  };
-}
-function pinDimension(key, value) {
-  const ctx = storage.getStore();
-  if (ctx) {
-    ctx.dimensions = { ...ctx.dimensions, [key]: value };
-  }
-}
-function rawContext() {
-  return storage.getStore();
-}
-
-// src/observability/with-span.ts
-import { hostname } from "os";
-
-// src/observability/stdout-sink.ts
-var SENSITIVE_KEY_RE = /secret|token|password|private|bearer|seed|preimage|api[_-]?key|signing[_-]?key|priv[_-]?key/i;
-var isTTY = typeof process.stdout.isTTY === "boolean" && process.stdout.isTTY;
-var RED = isTTY ? "\x1B[31m" : "";
-var YELLOW = isTTY ? "\x1B[33m" : "";
-var RESET = isTTY ? "\x1B[0m" : "";
-function formatSpanLine(span) {
-  const ts = new Date(span.started_at_ms).toISOString();
-  const levelStr = colorLevel(span.level);
-  const parts = [`[${ts}]`, span.dataset, `${levelStr}:`, span.name];
-  if (span.trace_id) {
-    parts.push(`trace=${span.trace_id}`);
-  }
-  for (const [k, v] of Object.entries(span.dimensions)) {
-    parts.push(formatKV(k, v));
-  }
-  for (const [k, v] of Object.entries(span.attributes)) {
-    parts.push(formatKV(k, v));
-  }
-  const durationMs = span.ended_at_ms - span.started_at_ms;
-  if (durationMs > 0) {
-    parts.push(`duration=${durationMs}ms`);
-  }
-  if (span.error_message) {
-    parts.push(`error=${truncate(span.error_message, 120)}`);
-  }
-  return parts.join(" ");
-}
-function writeSpanLine(span) {
-  const line = formatSpanLine(span);
-  process.stdout.write(line + "\n");
-}
-function colorLevel(level) {
-  if (level === "error") return `${RED}error${RESET}`;
-  if (level === "warn") return `${YELLOW}warn${RESET}`;
-  return level;
-}
-function formatKV(key, value) {
-  if (SENSITIVE_KEY_RE.test(key)) return `${key}=[REDACTED]`;
-  return `${key}=${truncate(stringify(value), 80)}`;
-}
-function stringify(value) {
-  if (typeof value === "string") return value;
-  if (value === void 0) return "undefined";
-  if (value === null) return "null";
-  if (typeof value === "function") return "[function]";
-  if (typeof value === "symbol") return value.toString();
-  if (typeof value === "bigint") return value.toString();
-  return JSON.stringify(value);
-}
-function truncate(s, max) {
-  if (s.length <= max) return s;
-  return s.slice(0, max - 3) + "...";
-}
-
-// src/observability/with-span.ts
-var emitter = null;
-function setEmitter(fn) {
-  emitter = fn;
-}
-var cachedHost = hostname();
-var serviceVersion = process.env.GIT_SHA ?? process.env.FLY_IMAGE_REF ?? "dev";
-async function withSpan(opts, fn) {
-  const spanId = randomSpanId();
-  const existingCtx = rawContext();
-  const ctx = existingCtx ?? currentContext();
-  const startMs = opts.startMs ?? Date.now();
-  let status = "ok";
-  let level = opts.level;
-  let errorMessage = null;
-  let errorStack = null;
-  if (opts.err) {
-    status = "error";
-    errorMessage = opts.err.message;
-    errorStack = opts.err.stack ?? null;
-  }
-  const childCtx = {
-    traceId: ctx.traceId,
-    spanId,
-    dimensions: { ...ctx.dimensions, ...opts.dims },
-    service: ctx.service,
-    tracestate: ctx.tracestate
-  };
-  const emitRow = () => {
-    const endMs = opts.endMs ?? Date.now();
-    const row = {
-      span_id: spanId,
-      trace_id: ctx.traceId,
-      parent_span_id: ctx.spanId,
-      dataset: opts.dataset,
-      name: opts.name,
-      level: level ?? (status === "error" ? "error" : "info"),
-      status,
-      started_at_ms: startMs,
-      ended_at_ms: endMs,
-      service: ctx.service,
-      service_version: serviceVersion,
-      host: cachedHost,
-      pid: process.pid,
-      dimensions: childCtx.dimensions,
-      attributes: opts.attrs ?? {},
-      error_message: errorMessage,
-      error_stack: errorStack,
-      sample_rate: 1
-    };
-    writeSpanLine(row);
-    if (emitter) emitter(row);
-  };
-  try {
-    const result = await withTraceContext(childCtx, () => fn());
-    if (opts.inspect) {
-      const overrides = opts.inspect(result);
-      if (overrides) {
-        if (overrides.status) status = overrides.status;
-        if (overrides.level) level = overrides.level;
-        if (overrides.errorMessage !== void 0) errorMessage = overrides.errorMessage;
-        if (overrides.attrs) Object.assign(opts.attrs ??= {}, overrides.attrs);
-      }
-    }
-    emitRow();
-    return result;
-  } catch (err) {
-    status = "error";
-    if (err instanceof Error) {
-      errorMessage = err.message;
-      errorStack = err.stack ?? null;
-    } else {
-      errorMessage = String(err);
-    }
-    if (opts.onError) {
-      const overrides = opts.onError(err);
-      if (overrides) Object.assign(opts.attrs ??= {}, overrides);
-    }
-    emitRow();
-    throw err;
-  }
-}
-
-// src/observability/datasets.ts
-var SPANS_DATASETS = [
-  { name: "platform", retentionDays: 90 },
-  { name: "cashu", retentionDays: 90 },
-  { name: "lightning", retentionDays: 90 },
-  { name: "stripe", retentionDays: 90 },
-  { name: "x402", retentionDays: 90 },
-  { name: "tempo", retentionDays: 90 },
-  { name: "isolate", retentionDays: 90 },
-  { name: "audit", retentionDays: 365 },
-  { name: "cron", retentionDays: 30 }
-];
-var DATASET_NAMES = new Set(SPANS_DATASETS.map((d) => d.name));
-
-// src/observability/loggers.ts
-var noop = () => {
-};
-var loggers = buildNoopLoggers();
-function initLoggers(writer, service) {
-  setEmitter((row) => {
-    writer.enqueue(row);
-  });
-  setDefaultService(service);
-  const result = {};
-  for (const ds of SPANS_DATASETS) {
-    result[ds.name] = createLogger(ds.name, {});
-  }
-  loggers = result;
-  initCallerLoggers(result);
-  return result;
-}
-function createLogger(dataset, bakedDims) {
-  const logger = {
-    info(name, attrs) {
-      void withSpan({ dataset, name, level: "info", attrs, dims: bakedDims }, noop).catch(noop);
-    },
-    warn(name, attrs) {
-      void withSpan({ dataset, name, level: "warn", attrs, dims: bakedDims }, noop).catch(noop);
-    },
-    error(name, attrs) {
-      const err = attrs?.err instanceof Error ? attrs.err : void 0;
-      const cleanAttrs = attrs ? { ...attrs } : void 0;
-      if (cleanAttrs) delete cleanAttrs.err;
-      void withSpan(
-        { dataset, name, level: "error", attrs: cleanAttrs, dims: bakedDims, err },
-        noop
-      ).catch(noop);
-    },
-    async span(name, attrs, fn, opts) {
-      return withSpan({ dataset, name, attrs, dims: bakedDims, onError: opts?.onError }, fn);
-    },
-    timer(name, attrs) {
-      const startMs = Date.now();
-      return {
-        [Symbol.dispose]() {
-          const endMs = Date.now();
-          void withSpan({ dataset, name, attrs, dims: bakedDims, startMs, endMs }, noop).catch(
-            noop
-          );
-        }
-      };
-    },
-    set(dims) {
-      for (const [k, v] of Object.entries(dims)) {
-        pinDimension(k, v);
-      }
-    },
-    extend(dims) {
-      return createLogger(dataset, { ...bakedDims, ...dims });
-    },
-    tracked(name, fn) {
-      return ((...args) => logger.span(name, {}, () => fn(...args)));
-    }
-  };
-  return logger;
-}
-function buildNoopLoggers() {
-  const noopLogger = {
-    // eslint-disable-next-line @typescript-eslint/no-empty-function
-    info() {
-    },
-    // eslint-disable-next-line @typescript-eslint/no-empty-function
-    warn() {
-    },
-    // eslint-disable-next-line @typescript-eslint/no-empty-function
-    error() {
-    },
-    async span(_name, _attrs, fn, _opts) {
-      return fn();
-    },
-    timer() {
-      return { [Symbol.dispose]() {
-      } };
-    },
-    // eslint-disable-next-line @typescript-eslint/no-empty-function
-    set() {
-    },
-    extend() {
-      return noopLogger;
-    },
-    tracked(_name, fn) {
-      return fn;
-    }
-  };
-  const result = {};
-  for (const ds of SPANS_DATASETS) {
-    result[ds.name] = noopLogger;
-  }
-  return result;
-}
-
 // src/sdk/server/instrumented-fetch.ts
 function createInstrumentedFetch(signal) {
   return async (input, init) => {
@@ -986,49 +663,7 @@ function mergeSignals(a, b) {
   return AbortSignal.any([a, b]);
 }
 
-// src/sdk/store.ts
-var MemoryKVStore = class {
-  data = /* @__PURE__ */ new Map();
-  /** Retrieve a value by key. Returns undefined if not found or expired. */
-  get(key) {
-    const entry = this.data.get(key);
-    if (!entry) return Promise.resolve(void 0);
-    if (entry.expiry !== void 0 && Date.now() > entry.expiry) {
-      this.data.delete(key);
-      return Promise.resolve(void 0);
-    }
-    return Promise.resolve(entry.value);
-  }
-  /** Store a value. Optionally set a TTL in seconds. */
-  set(key, value, opts) {
-    const expiry = opts?.ttl !== void 0 ? Date.now() + opts.ttl * 1e3 : void 0;
-    this.data.set(key, { value, expiry });
-    return Promise.resolve();
-  }
-  /** Delete a key. */
-  delete(key) {
-    this.data.delete(key);
-    return Promise.resolve();
-  }
-  /** List keys, optionally filtered by prefix. Excludes expired entries. */
-  list(prefix) {
-    const now = Date.now();
-    const keys = [];
-    for (const [key, entry] of this.data) {
-      if (entry.expiry !== void 0 && now > entry.expiry) {
-        this.data.delete(key);
-        continue;
-      }
-      if (prefix === void 0 || key.startsWith(prefix)) {
-        keys.push(key);
-      }
-    }
-    return Promise.resolve(keys);
-  }
-};
-
 export {
-  StepCache,
   toJobRecord,
   fromJobRecord,
   abortJob,
@@ -1039,21 +674,10 @@ export {
   isYieldMessage,
   accumulateAskedTopUp,
   UNCAPPABLE_ASK_TOTAL,
+  isJobRetentionStore,
   isReceiptIssuingStore,
   isStreamableJobStore,
   isStaleJobReapable,
   MemoryJobStore,
-  createConsoleLogger,
-  createStdoutLogger,
-  createNoopLogger,
-  randomTraceId,
-  withTraceContext,
-  currentContext,
-  pinDimension,
-  setEmitter,
-  withSpan,
-  loggers,
-  initLoggers,
-  createInstrumentedFetch,
-  MemoryKVStore
+  createInstrumentedFetch
 };

package/dist/{chunk-X3IKFWJA.js → chunk-6BQM7TOW.js}

@@ -140,6 +140,7 @@ var PayoutReporter = class {
   ownsBatchStore;
   intervalMs;
   now;
+  lastX402SnapshotAt = 0;
   x402;
   tempo;
   timer = null;
@@ -572,6 +573,8 @@ var PayoutReporter = class {
   async snapshotX402() {
     const ctx = this.x402;
     if (!ctx) return;
+    const snapshotAt = Math.max(this.now(), this.lastX402SnapshotAt + 1);
+    this.lastX402SnapshotAt = snapshotAt;
     try {
       const pools = [];
       const wedged = [];
@@ -627,7 +630,7 @@ var PayoutReporter = class {
         items: pools.length,
         pools,
         wedged,
-        snapshotAt: this.now()
+        snapshotAt
       });
     } catch (err) {
       warn("payout_pending_snapshot_failed", { rail: "x402", error: message(err) });

package/dist/chunk-BIFLRKMO.js

@@ -0,0 +1,87 @@
+import {
+  createX402FacilitatorAuthHeaders,
+  settleWithFacilitator,
+  verifyWithFacilitator
+} from "./chunk-BQ2NMWKE.js";
+import {
+  buildPaymentRequirements,
+  decodePayment,
+  encodeSettleResponseHeader,
+  exactEvmAuthorization
+} from "./chunk-Z4BNLUZF.js";
+import {
+  usdcToMsats
+} from "./chunk-5URG56JJ.js";
+import {
+  callerLoggers
+} from "./chunk-66HGCPBU.js";
+
+// src/lib/x402/verify.ts
+async function verifyX402Payment(paymentHeader, config, requiredUsdcMicro, resource, btcUsdRate, exactVersions = { v1: true, v2: true }) {
+  return callerLoggers.x402.span(
+    "x402.verify_payment",
+    {
+      resource,
+      required_usdc_micro: Number(requiredUsdcMicro),
+      facilitator_url: config.facilitator
+    },
+    async () => {
+      let payload;
+      try {
+        payload = decodePayment(paymentHeader);
+      } catch {
+        return { verified: false, amountMsats: 0, invalidReason: "decode_failed" };
+      }
+      if (payload.x402Version === 1 && !exactVersions.v1 || payload.x402Version === 2 && !exactVersions.v2) {
+        return { verified: false, amountMsats: 0, invalidReason: "unsupported_version" };
+      }
+      const requirementOpts = { x402Config: config, requiredUsdcMicro, resource };
+      const requirements = payload.x402Version === 1 ? buildPaymentRequirements({ ...requirementOpts, version: 1 }) : buildPaymentRequirements({ ...requirementOpts, version: 2 });
+      const createAuthHeaders = createX402FacilitatorAuthHeaders(config);
+      const verifyRes = await verifyWithFacilitator(
+        payload,
+        requirements,
+        config,
+        createAuthHeaders
+      );
+      if (!verifyRes.isValid) {
+        return {
+          verified: false,
+          amountMsats: 0,
+          invalidReason: verifyRes.invalidReason ?? "verify_failed"
+        };
+      }
+      const settleRes = await settleWithFacilitator(
+        payload,
+        requirements,
+        config,
+        createAuthHeaders
+      );
+      if (!settleRes.success) {
+        return {
+          verified: false,
+          amountMsats: 0,
+          invalidReason: settleRes.errorReason ?? "settle_failed"
+        };
+      }
+      const amountUsdcMicro = Number.parseInt(exactEvmAuthorization(payload).value, 10);
+      const amountMsats = btcUsdRate > 0 ? usdcToMsats(amountUsdcMicro / 1e6, btcUsdRate) : 0;
+      callerLoggers.x402.info("x402.verify_payment.result", {
+        verified: true,
+        tx_hash: settleRes.transaction,
+        amount_msats: amountMsats
+      });
+      return {
+        verified: true,
+        amountMsats,
+        amountUsdcMicro,
+        txHash: settleRes.transaction,
+        settleResponseHeader: encodeSettleResponseHeader(settleRes)
+      };
+    }
+  );
+}
+
+export {
+  verifyX402Payment
+};