@dvmkit/sdk 0.1.2-rc.7 → 0.1.4-rc.7

package/dist/{tempo-session-store-DALMRIWN.js → tempo-session-store-2JNOKJGX.js}

@@ -1,10 +1,10 @@
 import {
   PostgresTempoSessionStore,
   assertMonotonicTransition
-} from "./chunk-RU7SXHLO.js";
+} from "./chunk-UP2F5RRT.js";
 import "./chunk-YG7G4DPZ.js";
-import "./chunk-C3MTFLC6.js";
 import "./chunk-S3XAHZQY.js";
+import "./chunk-C3MTFLC6.js";
 export {
   PostgresTempoSessionStore,
   assertMonotonicTransition

package/dist/testing/index.d.ts

@@ -1,13 +1,14 @@
-import { cj as StreamableJobStore, ck as ReceiptIssuingStore, J as JobRecord, cl as RequestIdClaim, cm as RequestIdClaimResult, _ as JobReceipt, aw as OutgoingMessage, cn as AppendOutgoingOptions, co as PaymentCreditDelta, cp as VerifyAndCreditResult, cq as JobCounters, a2 as Message, a3 as MessageType, K as KVStore, L as Logger, v as ResponseContent, P as PaymentContent, S as SDKJobContext } from '../job-store-C53VQ5uu.js';
-import '@cashu/cashu-ts';
+import { Y as JobReceipt, a1 as Message, a2 as MessageType, K as KVStore, L as Logger, u as ResponseContent, P as PaymentContent, S as SDKJobContext } from '../step-cache-BLPZNizw.js';
+import { c as StreamableJobStore, R as ReceiptIssuingStore, J as JobRecord, d as RequestIdClaim, e as RequestIdClaimResult, f as JobRetentionCursor, O as OutgoingMessage, A as AppendOutgoingOptions, P as PaymentCreditDelta, V as VerifyAndCreditResult, g as JobCounters } from '../job-store-DHnW4Cg_.js';
+import 'hono';
 import 'mppx';
 import '@x402/core/server';
 import '@x402/evm/batch-settlement/server';
-import 'hono';
 import 'viem';
 import 'pg';
 import '@x402/core/types';
 import 'zod';
+import '@cashu/cashu-ts';
 
 /**
  * In-memory JobStore implementing the transactional + streaming surface
@@ -34,6 +35,17 @@ declare class MemoryJobStore implements StreamableJobStore, ReceiptIssuingStore
     releaseRequestIdClaim(claim: RequestIdClaim): Promise<void>;
     save(record: JobRecord): Promise<void>;
     delete(id: string): Promise<void>;
+    listJobsForRetention(args: {
+        lastActivityBeforeMs: number;
+        limit: number;
+        capabilities: string[] | null;
+        after?: JobRetentionCursor;
+    }): Promise<JobRecord[]>;
+    redactJob(args: {
+        jobId: string;
+        expectedLastActivityAt: number;
+        redactedAt: number;
+    }): Promise<boolean>;
     claimReceiptSeq(jobId: string): Promise<number>;
     saveReceipt(jobId: string, receipt: JobReceipt): Promise<JobReceipt | undefined>;
     appendOutgoing(jobId: string, message: OutgoingMessage, opts?: AppendOutgoingOptions): Promise<number>;
@@ -119,6 +131,16 @@ interface TestJobContext<State = Record<string, unknown>, Input = string> extend
     readonly summary: string | undefined;
     /** The error string passed to fail(). */
     readonly failError: string | undefined;
+    /**
+     * What the handler declared through `ctx.cost()`, summed, in 1e-6 of
+     * `currency` — exactly what the runtime would report to the platform.
+     * `undefined` when the handler declared nothing, and also when it declared
+     * two different currencies, which the runtime refuses to report.
+     */
+    readonly reportedCost: {
+        amountMicro: number;
+        currency: string;
+    } | undefined;
     /**
      * Cancel the job under test (internal-review) — aborts `ctx.signal` exactly as a
      * caller cancel, idle timeout, or stale-sweep would in the real runtime, and

package/dist/testing/index.js

@@ -1,12 +1,20 @@
+import {
+  MemoryKVStore
+} from "../chunk-RW5LP57K.js";
 import {
   JobCancelledError,
   MemoryJobStore,
-  MemoryKVStore,
-  createInstrumentedFetch,
+  createInstrumentedFetch
+} from "../chunk-U6M3ATSG.js";
+import {
   createNoopLogger
-} from "../chunk-TKA6ZP4M.js";
+} from "../chunk-E4EVGPDX.js";
 import "../chunk-66HGCPBU.js";
 import "../chunk-FUJ36YDV.js";
+import {
+  validateCurrency
+} from "../chunk-27V2ILSR.js";
+import "../chunk-AT6V3SY7.js";
 
 // src/sdk/testing/test-context.ts
 function createTestContext(opts) {
@@ -18,6 +26,10 @@ function createTestContext(opts) {
   let refundRequested = false;
   let summary;
   let failError;
+  let costAmount = 0;
+  let costMicro = 0;
+  let costCurrency;
+  let costPoisoned = false;
   const state = opts?.state !== void 0 ? structuredClone(opts.state) : {};
   const store = opts?.store ?? new MemoryKVStore();
   const env = opts?.env ?? {};
@@ -50,6 +62,10 @@ function createTestContext(opts) {
     get failError() {
       return failError;
     },
+    get reportedCost() {
+      if (costPoisoned || costCurrency === void 0) return void 0;
+      return { amountMicro: costMicro, currency: costCurrency };
+    },
     // --- Messaging ---
     text(message) {
       if (cancelled) return;
@@ -132,6 +148,23 @@ function createTestContext(opts) {
       cancelled = true;
       abort.abort(new JobCancelledError(reason));
     },
+    // --- Accounting ---
+    cost(declared) {
+      if (cancelled) return;
+      const currency = validateCurrency(declared.currency);
+      const total = costAmount + declared.amount;
+      const micro = Math.round(total * 1e6);
+      if (!Number.isFinite(declared.amount) || declared.amount < 0 || !Number.isSafeInteger(micro)) {
+        throw new RangeError(
+          `ctx.cost amounts must each be a finite, non-negative number of currency units, and must total no more than ${Math.floor(Number.MAX_SAFE_INTEGER / 1e6)}; got ${String(declared.amount)}`
+        );
+      }
+      if (costCurrency !== void 0 && costCurrency !== currency) costPoisoned = true;
+      costCurrency ??= currency;
+      if (costPoisoned) return;
+      costAmount = total;
+      costMicro = micro;
+    },
     // --- Durable execution ---
     async step(_id, fn) {
       return fn();

package/dist/{usd-gLcJB1ps.d.ts → usd-BgOfZlk6.d.ts}

@@ -1,4 +1,4 @@
-import { C as Currency } from './job-store-C53VQ5uu.js';
+import { C as Currency } from './step-cache-BLPZNizw.js';
 
 /**
  * Thrown by `fiatToSatsCeil` / `satsToFiat` when the supplied `ratePerBtc` is

package/dist/wallet-CJC8lwxx.d.ts

@@ -0,0 +1,29 @@
+import { Wallet } from '@cashu/cashu-ts';
+
+/**
+ * Get or create a cashu-ts Wallet for a mint, calling loadMint() once per
+ * session.
+ *
+ * When the agent has a mnemonic on disk at `~/.dvm/wallet.mnemonic` AND
+ * the wallet's `mnemonic_fingerprint` matches it (internal-review), NUT-13
+ * deterministic secrets are eligible: the constructor receives `bip39seed`
+ * derived via `mnemonicToSeedSync` and a {@link PersistentCounterSource}
+ * backed by `wallet.nut13_counters`.
+ *
+ * NUT-13 is resolved per mint. Deterministic derivation is unsafe over an
+ * selected V1 output keyset (`id` prefix `00`) — the 2026-01 keyset-ID-collision
+ * disclosure — so a wallet bound to V1 is degraded to random-secret mode for
+ * that mint alone, rather than refused. Retired V1 keysets remain published so
+ * their proofs can be verified and spent, but cannot produce new outputs; a
+ * V2-bound wallet (`id` prefix `01`) keeps NUT-13. The
+ * {@link assertNoKeysetCollision} guard only protects the derivation path, so
+ * it runs only for mints where NUT-13 stays active.
+ *
+ * When the agent wallet or its sibling mnemonic file is absent (e.g. on a
+ * DVM server, or a CLI process that only touches the builder-side
+ * cashu-proofs flow), NUT-13 stays inactive everywhere — `new Wallet(mintUrl)`
+ * with no options, random secrets.
+ */
+declare function getWallet(mintUrl: string): Promise<Wallet>;
+
+export { getWallet as g };

package/dist/{x402-FTG2GRAQ.js → x402-T2C5MX3T.js}

@@ -9,11 +9,14 @@ import {
   resolveX402Asset,
   saveX402Wallet,
   tryX402Payment,
-  verifyX402Payment,
   x402WrongAssetHint
-} from "./chunk-FJDCFHW5.js";
+} from "./chunk-C6JHBLMW.js";
 import "./chunk-KSQEFVFJ.js";
 import "./chunk-TSWKITGR.js";
+import {
+  verifyX402Payment
+} from "./chunk-BIFLRKMO.js";
+import "./chunk-BQ2NMWKE.js";
 import {
   X402_DEFAULT_FACILITATOR,
   X402_DEFAULT_NETWORK,
@@ -38,7 +41,7 @@ import {
   x402NetworkListForCopy,
   x402NetworkToCaip2,
   x402SupportedNetworksHint
-} from "./chunk-JGGI65I3.js";
+} from "./chunk-Z4BNLUZF.js";
 import "./chunk-5URG56JJ.js";
 import "./chunk-MKI6OVW4.js";
 import "./chunk-66HGCPBU.js";

package/package.json

@@ -1,19 +1,20 @@
 {
   "name": "@dvmkit/sdk",
-  "version": "0.1.2-rc.7",
+  "version": "0.1.4-rc.7",
   "description": "SDK for building accountless, pay-per-use Digital Vending Machines",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/dvmkit/sdk.git"
   },
-  "homepage": "https://dvmkit.ai/docs/sdk",
+  "homepage": "https://dvmkit.com/docs/sdk",
   "bugs": {
     "url": "https://github.com/dvmkit/sdk/issues"
   },
   "publishConfig": {
     "access": "public"
   },
+  "sideEffects": false,
   "type": "module",
   "exports": {
     ".": {
@@ -41,24 +42,28 @@
     "node": ">=22"
   },
   "scripts": {
-    "build": "NODE_OPTIONS=--max-old-space-size=6144 tsup --config tsup.config.ts && node scripts/prune-sdk-dist.mjs",
-    "check:api": "node scripts/check-api-surface.mjs",
+    "build": "NODE_OPTIONS=--max-old-space-size=6144 tsup --config tsup.config.ts && node scripts/write-internal-entry.mjs && node scripts/prune-sdk-dist.mjs",
+    "check:api": "node scripts/check-api-surface.mjs && node scripts/generate-api-reference.mjs --check",
     "check:consumer": "node scripts/consumer-smoke.mjs",
+    "install-published-release": "node scripts/install-published-release.mjs",
     "check:package": "node scripts/package-smoke.mjs",
     "check:public-safety": "node scripts/public-safety.mjs",
     "check:release": "node scripts/check-release.mjs",
     "check:toolchain": "node scripts/check-toolchain.mjs",
+    "check:tree-shaking": "node scripts/check-internal-tree-shaking.mjs",
     "clean-install-smoke": "node scripts/clean-install-smoke.mjs",
     "lint": "eslint . --max-warnings 0",
+    "docs:api": "node scripts/generate-api-reference.mjs --write",
     "release:tag": "node scripts/release-tag.mjs",
     "test": "vitest run --config vitest.config.ts",
+    "test:examples": "node --test examples/quickstart/handler.test.mjs examples/authenticated-route/handler.test.mjs examples/payments-and-lifecycle/handler.test.mjs",
     "test:db": "vitest run --config vitest.db.config.ts",
     "typecheck": "tsc --noEmit",
     "typecheck:scripts": "tsc --noEmit --project tsconfig.scripts.json",
     "verify": "node scripts/verify.mjs"
   },
   "dependencies": {
-    "@cashu/cashu-ts": "4.2.1",
+    "@cashu/cashu-ts": "4.10.2",
     "@hono/node-server": "1.19.17",
     "@noble/curves": "2.0.1",
     "@noble/hashes": "2.0.1",
@@ -86,6 +91,7 @@
     "@types/pg": "8.18.0",
     "@types/proper-lockfile": "4.1.4",
     "@types/ws": "8.18.1",
+    "esbuild": "0.27.7",
     "eslint": "10.9.1",
     "globals": "17.11.0",
     "tsup": "8.5.1",

package/dist/{chunk-RU7SXHLO.js → chunk-UP2F5RRT.js}

@@ -2,12 +2,12 @@ import {
   parseStoreValue,
   stringifyStoreValue
 } from "./chunk-YG7G4DPZ.js";
-import {
-  withPostgresTransactionRecovery
-} from "./chunk-C3MTFLC6.js";
 import {
   withSdkInitLock
 } from "./chunk-S3XAHZQY.js";
+import {
+  withPostgresTransactionRecovery
+} from "./chunk-C3MTFLC6.js";
 
 // src/sdk/server/tempo-session-store.ts
 import { AsyncLocalStorage } from "async_hooks";