@run402/sdk 1.70.1 → 2.0.1

package/dist/node/assets-node.js

@@ -0,0 +1,368 @@
+/**
+ * Node-only `Assets` namespace enrichments (v1.48 unified-apply).
+ *
+ * `NodeAssets` extends the isomorphic {@link Assets} with directory-walking
+ * helpers — `uploadDir` (additive), `syncDir` (declarative prune), and
+ * `prepareDir` (pre-commit URL injection) — that read bytes from disk
+ * lazily, compute SHA-256s in streaming chunks, and submit through the
+ * single hero `r.project(id).apply(spec)` engine. See design D8/D10/D11.
+ *
+ * Imports `node:fs/promises` via `fileSetFromDir`, so this module is
+ * Node-only — V8 isolates use `r.project(id).assets.putMany(items)` with
+ * in-memory byte sources.
+ */
+import { Assets } from "../namespaces/assets.js";
+import { Deploy } from "../namespaces/deploy.js";
+import { LocalError } from "../errors.js";
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { fileSetFromDir } from "./files.js";
+/**
+ * Build a `LocalDirRef` for the given filesystem path. Synchronous — the
+ * actual filesystem walk happens at `apply()` submission time per design
+ * D12 ("dir(path) returns synchronous LocalDirRef; SDK-input-only").
+ *
+ * @example
+ *   import { dir, run402 } from "@run402/sdk/node";
+ *   const r = run402();
+ *   await r.project(p).apply({
+ *     site:   dir("./dist"),
+ *     assets: dir("./assets", { prefix: "static/" }),
+ *   });
+ */
+export function dir(path, opts = {}) {
+    return {
+        __source: "local-dir",
+        path,
+        prefix: opts.prefix,
+        ignore: opts.ignore,
+        includeSensitive: opts.includeSensitive,
+    };
+}
+// ───────────────────────────────────────────────────────────────────────────
+// Asset slice normalization (SDK input → wire)
+// ───────────────────────────────────────────────────────────────────────────
+/**
+ * Normalize one disk entry into a wire-shaped `AssetPutEntry`. Reads the
+ * file once, streams SHA-256, captures size, infers content_type from
+ * extension via the existing `guessContentType` table. Defaults
+ * `immutable: true` and `visibility: "public"`.
+ */
+async function entryFromFile(absolutePath, key, contentType) {
+    const buf = await readFile(absolutePath);
+    const sha = createHash("sha256").update(buf).digest("hex");
+    return {
+        key,
+        sha256: sha,
+        size_bytes: buf.length,
+        content_type: contentType,
+        visibility: "public",
+        immutable: true,
+    };
+}
+/**
+ * Normalize one in-memory `ContentSource` into a wire-shaped entry.
+ * Buffers the bytes (compatible with Uint8Array, ArrayBuffer, Blob,
+ * string). Streams aren't supported here yet — pass a Blob or pre-read.
+ */
+async function entryFromContent(key, source, contentType, immutable, visibility) {
+    const bytes = await readContentSourceBytes(source);
+    const sha = createHash("sha256").update(bytes).digest("hex");
+    return {
+        key,
+        sha256: sha,
+        size_bytes: bytes.length,
+        content_type: contentType ?? "application/octet-stream",
+        visibility: visibility ?? "public",
+        immutable: immutable ?? true,
+    };
+}
+async function readContentSourceBytes(src) {
+    if (typeof src === "string")
+        return new TextEncoder().encode(src);
+    if (src instanceof Uint8Array)
+        return src;
+    if (src instanceof ArrayBuffer)
+        return new Uint8Array(src);
+    if (typeof Blob !== "undefined" && src instanceof Blob) {
+        return new Uint8Array(await src.arrayBuffer());
+    }
+    if (typeof src === "object" && src !== null && "data" in src) {
+        return readContentSourceBytes(src.data);
+    }
+    if (typeof src === "object" && src !== null && "__source" in src) {
+        const fs = src;
+        if (fs.__source === "fs-file") {
+            return await readFile(fs.path);
+        }
+    }
+    throw new LocalError("Unsupported ContentSource for asset put (Streams not yet supported; pass a Blob or pre-read bytes)", "normalizing asset entry");
+}
+/**
+ * Walk a `LocalDirRef`, hash every file, and return wire-shaped
+ * `AssetPutEntry[]`. The prefix is applied to relative keys.
+ *
+ * This is the single normalization point — uploadDir/syncDir/prepareDir
+ * /putMany all funnel through here so the wire submission carries
+ * normalized entries only (gateway rejects LocalDirRef objects).
+ */
+export async function entriesFromLocalDir(ref) {
+    const fileSetOpts = {
+        ignore: ref.ignore,
+        includeSensitive: ref.includeSensitive,
+    };
+    const fileSet = await fileSetFromDir(ref.path, fileSetOpts);
+    const entries = [];
+    for (const [relPath, source] of Object.entries(fileSet)) {
+        const key = applyPrefix(ref.prefix, relPath);
+        if (typeof source === "object" && source !== null && "__source" in source) {
+            const fs = source;
+            if (fs.__source === "fs-file") {
+                const contentType = fs.contentType ?? "application/octet-stream";
+                entries.push(await entryFromFile(fs.path, key, contentType));
+                continue;
+            }
+        }
+        entries.push(await entryFromContent(key, source));
+    }
+    return entries;
+}
+function applyPrefix(prefix, relPath) {
+    if (!prefix)
+        return relPath;
+    return prefix.endsWith("/") ? `${prefix}${relPath}` : `${prefix}/${relPath}`;
+}
+function buildAssetManifest(releaseResult, entries, pruned, durationMs) {
+    const projectPublicId = releaseResult.urls?.project_public_id ?? "";
+    return buildManifestFromEntries(entries, projectPublicId, pruned, durationMs);
+}
+function buildManifestFromEntries(entries, projectPublicId, pruned, durationMs) {
+    const list = [];
+    const byKey = Object.create(null);
+    const manifest = Object.create(null);
+    for (const entry of entries) {
+        const e = buildEntryFromAssetPut(entry, projectPublicId);
+        list.push(e);
+        byKey[entry.key] = e;
+        manifest[entry.key] = e;
+    }
+    const result = {
+        list,
+        byKey,
+        manifest,
+        totals: {
+            files: entries.length,
+            // Byte counts come from the activation-transaction promote
+            // response; the SDK doesn't yet thread them through DeployResult
+            // (the gateway plan-response enrichment is a separate follow-up).
+            // Placeholder 0 keeps the shape stable.
+            bytes_uploaded: 0,
+            bytes_reused: 0,
+            duration_ms: durationMs,
+        },
+    };
+    if (pruned)
+        result.pruned = pruned;
+    return result;
+}
+/**
+ * Build an `AssetManifestEntry` from an `AssetPutEntry` and the
+ * project's public id. The URL form mirrors the gateway's
+ * `buildAssetRefForPlan` — deterministic from `(project_public_id, key,
+ * content_sha256)`. Private assets return null for all public URL
+ * fields per the visibility-aware URL matrix (design D6/D8).
+ */
+function buildEntryFromAssetPut(entry, projectPublicId) {
+    const visibility = entry.visibility ?? "public";
+    const immutable = entry.immutable ?? true;
+    const isPublic = visibility === "public";
+    const suffix = entry.sha256.slice(0, 8);
+    const dotIdx = entry.key.lastIndexOf(".");
+    const suffixedKey = dotIdx > 0
+        ? `${entry.key.slice(0, dotIdx)}-${suffix}${entry.key.slice(dotIdx)}`
+        : `${entry.key}-${suffix}`;
+    const host = projectPublicId ? `pr-${projectPublicId}.run402.com` : "";
+    const url = isPublic && host ? `https://${host}/_blob/${entry.key}` : null;
+    const immutableUrl = isPublic && immutable && host
+        ? `https://${host}/_blob/${suffixedKey}`
+        : null;
+    const contentDigest = `sha-256=:${Buffer.from(entry.sha256, "hex").toString("base64")}:`;
+    return {
+        key: entry.key,
+        sha256: entry.sha256,
+        size_bytes: entry.size_bytes,
+        content_type: entry.content_type ?? "application/octet-stream",
+        visibility,
+        url,
+        immutable_url: immutableUrl,
+        cdn_url: url,
+        cdn_immutable_url: immutableUrl,
+        sri: null,
+        etag: `"sha256-${entry.sha256}"`,
+        content_digest: contentDigest,
+    };
+}
+/**
+ * Error thrown by `syncDir({ prune: true })` when called without a
+ * `confirm` token. Carries the values the caller must echo back to
+ * commit the destructive operation. The SDK auto-throws this before the
+ * destructive apply lands so the agent has a chance to surface the
+ * planned delete set to the user.
+ */
+export class PruneConfirmationRequired extends LocalError {
+    code = "PRUNE_CONFIRMATION_REQUIRED";
+    base_revision;
+    delete_set_digest;
+    expected_delete_count;
+    sample_keys;
+    constructor(args) {
+        super(`Destructive syncDir requires a confirmation token. Re-call with confirm: { base_revision, delete_set_digest, expected_delete_count } from a prior plan.`, "preparing destructive asset sync");
+        this.base_revision = args.base_revision;
+        this.delete_set_digest = args.delete_set_digest;
+        this.expected_delete_count = args.expected_delete_count;
+        this.sample_keys = args.sample_keys;
+    }
+}
+export class NodeAssets extends Assets {
+    /**
+     * Additive directory upload. Existing keys under the (optional) prefix
+     * that aren't in the new directory are left untouched. Per design
+     * D10. Wraps `r._applyEngine.apply({ project, assets: { put: ... } })`.
+     */
+    async uploadDir(path, opts) {
+        const start = Date.now();
+        const ref = dir(path, {
+            prefix: opts.prefix,
+            ignore: opts.ignore,
+            includeSensitive: opts.includeSensitive,
+        });
+        const entries = await entriesFromLocalDir(ref);
+        if (entries.length === 0) {
+            throw new LocalError(`No files found under ${path} (after applying the ignore list)`, "uploading asset directory");
+        }
+        const result = await this.applyEngine().apply({ project: opts.project, assets: { put: entries } }, { onEvent: opts.onEvent });
+        return buildAssetManifest(result, entries, undefined, Date.now() - start);
+    }
+    /**
+     * Declarative directory sync. Per design D10:
+     * - Without `prune: true`, behaves identically to {@link uploadDir}
+     *   (additive only).
+     * - With `prune: true` AND no `confirm` token, runs a plan first and
+     *   throws {@link PruneConfirmationRequired} carrying the values the
+     *   caller must echo back to commit.
+     * - With `prune: true` AND a `confirm` token, commits the destructive
+     *   sync. The gateway's activation-time drift check
+     *   (`ASSET_SYNC_DRIFT`) catches the narrower race where inventory
+     *   mutates between commit and activation.
+     */
+    async syncDir(path, opts) {
+        const start = Date.now();
+        const ref = dir(path, {
+            prefix: opts.prefix,
+            ignore: opts.ignore,
+            includeSensitive: opts.includeSensitive,
+        });
+        const entries = await entriesFromLocalDir(ref);
+        if (!opts.prune) {
+            // Additive sync — same path as uploadDir.
+            const result = await this.applyEngine().apply({ project: opts.project, assets: { put: entries } }, { onEvent: opts.onEvent });
+            return buildAssetManifest(result, entries, undefined, Date.now() - start);
+        }
+        if (!opts.prefix) {
+            throw new LocalError("syncDir({ prune: true }) requires an explicit prefix (no implicit project-root prune)", "preparing destructive asset sync");
+        }
+        if (!opts.confirm) {
+            // Run a plan to obtain the gateway-computed base_revision +
+            // delete_set_digest + sample of planned-delete keys (design D10).
+            // The plan response carries an `asset_sync` block when the spec
+            // declares destructive sync; we surface its values via the typed
+            // PruneConfirmationRequired error so the caller can present them
+            // to a user, then retry with `confirm: {...}` populated.
+            const { plan } = await this.applyEngine().plan({
+                project: opts.project,
+                assets: {
+                    put: entries,
+                    sync: { prefix: opts.prefix, prune: true },
+                },
+            }, { dryRun: true });
+            const block = plan.asset_sync;
+            throw new PruneConfirmationRequired({
+                base_revision: block?.base_revision ?? "",
+                delete_set_digest: block?.delete_set_digest ?? "",
+                expected_delete_count: block?.expected_delete_count ?? 0,
+                sample_keys: block?.sample_keys ?? [],
+            });
+        }
+        const result = await this.applyEngine().apply({
+            project: opts.project,
+            assets: {
+                put: entries,
+                sync: {
+                    prefix: opts.prefix,
+                    prune: true,
+                    confirm: opts.confirm,
+                },
+            },
+        }, { onEvent: opts.onEvent });
+        return buildAssetManifest(result, entries, 
+        // pruned[] is populated by the activation transaction (gateway-
+        // side asset slice promotion). Without the enriched plan response
+        // (follow-up), we don't yet have the materialized list here.
+        undefined, Date.now() - start);
+    }
+    /**
+     * Pre-commit URL injection helper (design D8 / spec Requirement
+     * "assets.prepareDir"). Runs a plan against `r.project(id).apply.plan`
+     * and returns `{ manifest, applySlice }` so the caller can render HTML
+     * against the final resolved URLs and submit the same `applySlice` to
+     * the commit step without re-uploading. Currently a thin shim — the
+     * full plan-response enrichment lands in a follow-up.
+     */
+    async prepareDir(path, opts) {
+        const start = Date.now();
+        const ref = dir(path, {
+            prefix: opts.prefix,
+            ignore: opts.ignore,
+            includeSensitive: opts.includeSensitive,
+        });
+        const entries = await entriesFromLocalDir(ref);
+        if (entries.length === 0) {
+            throw new LocalError(`No files found under ${path} (after applying the ignore list)`, "preparing asset directory");
+        }
+        // Plan-only via the engine. The result's URLs are best-effort
+        // built locally until the gateway plan-response enrichment lands.
+        const plan = await this.applyEngine().plan({ project: opts.project, assets: { put: entries } }, { dryRun: true });
+        void plan; // referenced for type-check; consumed by URL-enrich follow-up
+        return {
+            manifest: buildManifestFromEntries(entries, "", undefined, Date.now() - start),
+            applySlice: { put: entries },
+        };
+    }
+    /**
+     * In-memory batch upload. Each item carries the key + an in-memory
+     * `ContentSource` (string, Uint8Array, ArrayBuffer, Blob). SHA-256 is
+     * computed locally, then a single apply call submits all entries.
+     * Returns `AssetManifest`.
+     */
+    async putMany(items, opts) {
+        const start = Date.now();
+        if (items.length === 0) {
+            throw new LocalError("putMany() requires at least one item", "uploading asset batch");
+        }
+        const entries = [];
+        for (const item of items) {
+            entries.push(await entryFromContent(item.key, item.source, item.contentType, item.immutable, item.visibility));
+        }
+        const result = await this.applyEngine().apply({ project: opts.project, assets: { put: entries } }, { onEvent: opts.onEvent });
+        return buildAssetManifest(result, entries, undefined, Date.now() - start);
+    }
+    /**
+     * Internal: instantiate a Deploy (engine) bound to the same Client
+     * this Assets instance was constructed with. Avoids requiring a
+     * separate apply-engine parameter on the namespace constructor.
+     */
+    applyEngine() {
+        return new Deploy(this.client);
+    }
+}
+//# sourceMappingURL=assets-node.js.map

package/dist/node/assets-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets-node.js","sourceRoot":"","sources":["../../src/node/assets-node.ts"],"names":[],"mappings":"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"}

package/dist/node/canonicalize.d.ts

@@ -2,7 +2,7 @@
  * RFC 8785 (JCS) canonical JSON utility — kept as a UX / diagnostic helper.
  *
  * **As of v1.34, the gateway is authoritative for the deploy manifest
- * digest.** `POST /deploy/v2/plans` returns the gateway-computed digest in
+ * digest.** `POST /apply/v1/plans` returns the gateway-computed digest in
  * the response, and operation idempotency keys on it (combined with
  * `project_id`, `base_release_id`, and an optional client idempotency key).
  * A drift between this implementation and the gateway's canonicalize

package/dist/node/canonicalize.js

@@ -2,7 +2,7 @@
  * RFC 8785 (JCS) canonical JSON utility — kept as a UX / diagnostic helper.
  *
  * **As of v1.34, the gateway is authoritative for the deploy manifest
- * digest.** `POST /deploy/v2/plans` returns the gateway-computed digest in
+ * digest.** `POST /apply/v1/plans` returns the gateway-computed digest in
  * the response, and operation idempotency keys on it (combined with
  * `project_id`, `base_release_id`, and an optional client idempotency key).
  * A drift between this implementation and the gateway's canonicalize

package/dist/node/index.d.ts

@@ -22,6 +22,7 @@
 import { Run402 } from "../index.js";
 import type { CredentialsProvider } from "../credentials.js";
 import { NodeSites } from "./sites-node.js";
+import { NodeAssets } from "./assets-node.js";
 export interface NodeRun402Options {
     /** Override the API base URL. Defaults to `getApiBase()` (env var or production URL). */
     apiBase?: string;
@@ -39,9 +40,13 @@ export interface NodeRun402Options {
     /** Fully custom fetch implementation. Takes precedence over `disablePaidFetch`. */
     fetch?: typeof globalThis.fetch;
 }
-/** Run402 instance with the Node-only `sites.deployDir` helper wired in. */
-export type NodeRun402 = Omit<Run402, "sites"> & {
+/** Run402 instance with Node-only helpers wired in: `sites.deployDir`
+ *  (v1.34 unified-deploy convenience) and `assets.uploadDir` /
+ *  `assets.syncDir` / `assets.prepareDir` / `assets.putMany`
+ *  (v1.48 unified-apply ergonomics). */
+export type NodeRun402 = Omit<Run402, "sites" | "assets"> & {
     sites: NodeSites;
+    assets: NodeAssets;
 };
 /**
  * Construct a Run402 client wired with Node defaults.
@@ -58,6 +63,8 @@ export { NodeSites } from "./sites-node.js";
 export type { DeployDirOptions, DeployEvent as DeployDirEvent, } from "./sites-node.js";
 export { fileSetFromDir, normalizeRelPath } from "./files.js";
 export type { FileSetFromDirOptions } from "./files.js";
+export { NodeAssets, dir, PruneConfirmationRequired } from "./assets-node.js";
+export type { AssetManifest, AssetManifestEntry, AssetManifestTotals, DirOptions, LocalDirRef, PutManyItem, UploadDirOptions, SyncDirOptions, PrepareDirOptions, } from "./assets-node.js";
 export { loadDeployManifest, normalizeDeployManifest } from "./deploy-manifest.js";
 export type { DeployManifestDatabaseSpec, DeployManifestFileEntry, DeployManifestFileSet, DeployManifestFunctionsSpec, DeployManifestFunctionSpec, DeployManifestInput, DeployManifestMigrationSpec, DeployManifestSiteSpec, LoadDeployManifestOptions, NormalizedDeployManifest, NormalizeDeployManifestOptions, } from "./deploy-manifest.js";
 export { signCiDelegation } from "./ci.js";

package/dist/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAI7D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mGAAmG;IACnG,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mFAAmF;IACnF,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAEtE;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,IAAI,GAAE,iBAAsB,GAAG,UAAU,CAqB/D;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EACV,gBAAgB,EAChB,WAAW,IAAI,cAAc,GAC9B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACnF,YAAY,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtE,mBAAmB,aAAa,CAAC;AAEjC,OAAO,EACL,MAAM,EACN,WAAW,EACX,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,8BAA8B,EAC9B,kBAAkB,EAClB,EAAE,EACF,sBAAsB,EACtB,MAAM,EACN,KAAK,EACL,WAAW,EACX,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,EACrB,4BAA4B,EAC5B,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,6BAA6B,EAC7B,+BAA+B,EAC/B,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,SAAS,GACV,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"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"}

package/dist/node/index.js

@@ -24,6 +24,7 @@ import { Run402 } from "../index.js";
 import { NodeCredentialsProvider } from "./credentials.js";
 import { createLazyPaidFetch } from "./paid-fetch.js";
 import { NodeSites } from "./sites-node.js";
+import { NodeAssets } from "./assets-node.js";
 /**
  * Construct a Run402 client wired with Node defaults.
  *
@@ -51,10 +52,18 @@ export function run402(opts = {}) {
     // the field; this keeps a single Client per instance (no divergent state).
     const client = base.sites.client;
     base.sites = new NodeSites(client);
+    // v1.48 unified-apply: upgrade `assets` to the Node-aware variant.
+    // Same single-Client pattern as the sites upgrade above.
+    base.assets = new NodeAssets(client);
     return base;
 }
 export { NodeSites } from "./sites-node.js";
 export { fileSetFromDir, normalizeRelPath } from "./files.js";
+// v1.48 unified-apply: Node-only `assets.{uploadDir,syncDir,prepareDir,
+// putMany}` ergonomics + `dir(path)` LocalDirRef helper. The
+// `dir(path)` call is synchronous (per design D12); the filesystem
+// walk happens at apply() submission time.
+export { NodeAssets, dir, PruneConfirmationRequired } from "./assets-node.js";
 export { loadDeployManifest, normalizeDeployManifest } from "./deploy-manifest.js";
 export { signCiDelegation } from "./ci.js";
 export { NodeCredentialsProvider } from "./credentials.js";

package/dist/node/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAuB5C;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CAAC,OAA0B,EAAE;IACjD,MAAM,OAAO,GAAkB;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,UAAU,EAAE;QACrC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,uBAAuB,CAAC;YAC3D,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC;QACF,KAAK,EACH,IAAI,CAAC,KAAK;YACV,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC;KACtF,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;IAEjC,yEAAyE;IACzE,0EAA0E;IAC1E,4EAA4E;IAC5E,2EAA2E;IAC3E,MAAM,MAAM,GAAI,IAAI,CAAC,KAAuC,CAAC,MAAM,CAAC;IACnE,IAAwC,CAAC,KAAK,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAExE,OAAO,IAA6B,CAAC;AACvC,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAK5C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAcnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,6EAA6E;AAC7E,OAAO,EACL,MAAM,EACN,WAAW,EACX,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,8BAA8B,EAC9B,kBAAkB,EAClB,EAAE,EACF,sBAAsB,EACtB,MAAM,EACN,KAAK,EACL,WAAW,EACX,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,EACrB,4BAA4B,EAC5B,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,6BAA6B,EAC7B,+BAA+B,EAC/B,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,SAAS,GACV,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"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"}

package/dist/scoped.d.ts

@@ -22,7 +22,7 @@ import type { ExposeManifestValidationInput, ExposeManifestValidationResult, Lis
 import type { AppDetails, BrowseAppsResult, ForkAppOptions, ForkAppResult, ListVersionsResult, PublishAppOptions, PublishedVersion, UpdateVersionOptions } from "./namespaces/apps.js";
 import type { AiUsageResult, GenerateImageOptions, GenerateImageResult, ModerateResult, TranslateOptions, TranslateResult } from "./namespaces/ai.js";
 import type { AuthSettings, AuthSettingsResult, AuthSessionResult, AuthUserAdminResult, CreateAuthUserOptions, MagicLinkOptions, MagicLinkVerifyResult, PasskeyDeleteOptions, PasskeyListOptions, PasskeyLoginOptions, PasskeyLoginVerifyOptions, PasskeyOptionsResult, PasskeyRecord, PasskeyRegistrationOptions, PasskeyRegistrationVerifyOptions, SetPasswordOptions } from "./namespaces/auth.js";
-import type { BlobDiagnoseEnvelope, BlobLsOptions, BlobLsResult, BlobPutOptions, BlobPutResult, BlobPutSource, BlobSignOptions, BlobSignResult, BlobUploadCompleteOptions, BlobUploadCompleteResult, BlobUploadInitOptions, BlobUploadInitResult, BlobUploadStatusResult, BlobWaitFreshOptions, BlobWaitFreshResult } from "./namespaces/blobs.types.js";
+import type { BlobDiagnoseEnvelope, BlobLsOptions, BlobLsResult, BlobPutOptions, BlobPutResult, BlobPutSource, BlobSignOptions, BlobSignResult, BlobUploadCompleteOptions, BlobUploadCompleteResult, BlobUploadInitOptions, BlobUploadInitResult, BlobUploadStatusResult, BlobWaitFreshOptions, BlobWaitFreshResult } from "./namespaces/assets.types.js";
 import type { ContractCallOptions, ContractReadOptions, ProvisionWalletOptions } from "./namespaces/contracts.js";
 import type { CustomDomainAddResult, CustomDomainListResult, CustomDomainRemoveResult, CustomDomainStatusResult } from "./namespaces/domains.js";
 import type { CreateMailboxResult, DeleteMailboxResult, EmailDetail, EmailSummary, ListEmailsOptions, MailboxInfo, MailboxWebhookSummary, MailboxWebhooksResult, RawEmailResult, RegisterWebhookOptions, SendEmailOptions, SendEmailResult, UpdateWebhookOptions } from "./namespaces/email.js";
@@ -97,7 +97,7 @@ declare class ScopedAuth {
     promote(email: string): Promise<void>;
     demote(email: string): Promise<void>;
 }
-declare class ScopedBlobs {
+declare class ScopedAssets {
     private readonly parent;
     private readonly projectId;
     constructor(parent: Run402, projectId: string);
@@ -129,16 +129,17 @@ declare class ScopedContracts {
     deleteWallet(walletId: string): Promise<unknown>;
     read(opts: ContractReadOptions): Promise<unknown>;
 }
-declare class ScopedDeploy {
-    private readonly parent;
-    private readonly projectId;
-    constructor(parent: Run402, projectId: string);
-    apply(spec: Omit<ReleaseSpec, "project"> & {
+/**
+ * Callable hero shape for `r.project(id).apply`. The function form is the
+ * documented happy path; the attached `plan`/`start`/`resume` sub-methods
+ * are advanced primitives for callers building their own plan/upload/commit
+ * pipelines. Per design D5 the hero is the only public apply surface — no
+ * bare `r.apply`, no `r.deploy.apply`, no `r.assets.apply`.
+ */
+export interface ScopedApplyHero {
+    (spec: Omit<ReleaseSpec, "project"> & {
         project?: string;
     }, opts?: ApplyOptions): Promise<DeployResult>;
-    start(spec: Omit<ReleaseSpec, "project"> & {
-        project?: string;
-    }, opts?: StartOptions): Promise<DeployOperation>;
     plan(spec: Omit<ReleaseSpec, "project"> & {
         project?: string;
     }, opts?: {
@@ -148,6 +149,18 @@ declare class ScopedDeploy {
         plan: PlanResponse;
         byteReaders: Map<string, ByteReader>;
     }>;
+    start(spec: Omit<ReleaseSpec, "project"> & {
+        project?: string;
+    }, opts?: StartOptions): Promise<DeployOperation>;
+    resume(operationId: string, opts?: {
+        onEvent?: (event: DeployEvent) => void;
+        project?: string;
+    }): Promise<DeployResult>;
+}
+declare class ScopedDeploy {
+    private readonly parent;
+    private readonly projectId;
+    constructor(parent: Run402, projectId: string);
     upload(plan: PlanResponse, opts: {
         project?: string;
         byteReaders: Map<string, ByteReader>;
@@ -178,7 +191,6 @@ declare class ScopedDeploy {
         project?: string;
     }): Promise<ReleaseToReleaseDiff>;
     resolve(opts: ScopedDeployResolveOptions): Promise<DeployResolveResponse>;
-    private bindProject;
 }
 declare class ScopedDomains {
     private readonly parent;
@@ -258,8 +270,22 @@ export declare class ScopedRun402 {
     readonly apps: ScopedApps;
     readonly ai: ScopedAi;
     readonly auth: ScopedAuth;
-    readonly blobs: ScopedBlobs;
+    readonly assets: ScopedAssets;
     readonly contracts: ScopedContracts;
+    /**
+     * Hero apply surface. Per design D5 / unified-apply: `r.project(id).apply(spec)`
+     * is the documented happy path for both release-only and mixed apply.
+     * Callable directly, with `.plan(spec)` / `.start(spec)` / `.resume(opId)`
+     * sub-methods for advanced plan-upload-commit pipelines.
+     */
+    readonly apply: ScopedApplyHero;
+    /**
+     * Release/operation read primitives — events streams, status reads,
+     * release inventory + diff, operation list, resolve. Distinct from the
+     * hero `apply` which is for writes. The legacy `.deploy.apply` /
+     * `.deploy.start` / `.deploy.plan` aliases were removed in v1.48
+     * (use `r.project(id).apply` directly).
+     */
     readonly deploy: ScopedDeploy;
     readonly domains: ScopedDomains;
     readonly email: ScopedEmail;