@veryfront/ext-content-mdx 0.1.1185 → 0.1.1186

package/esm/deno.d.ts

@@ -38,6 +38,7 @@ declare namespace _default {
         "./workflow/blob": string;
         "./workflow/worker": string;
         "./workflow/claude-code": string;
+        "./workflow/claude-code/types": string;
         "./workflow/claude-code/react": string;
         "./workflow/discovery": string;
         "./schemas": string;
@@ -55,6 +56,8 @@ declare namespace _default {
         "./observability": string;
         "./observability/sentry": string;
         "./observability/otlp-setup": string;
+        "./errors/general": string;
+        "./errors/module": string;
         "./utils": string;
         "./utils/logger": string;
         "./release-assets": string;
@@ -68,15 +71,18 @@ declare namespace _default {
         "./embedding": string;
         "./knowledge": string;
         "./extensions": string;
+        "./extensions/types": string;
         "./extensions/llm": string;
         "./extensions/auth": string;
         "./extensions/bundler": string;
         "./extensions/cache": string;
         "./extensions/content": string;
+        "./extensions/distributed": string;
         "./extensions/contracts": string;
         "./extensions/compat": string;
         "./extensions/first-party-import": string;
         "./extensions/css": string;
+        "./extensions/image": string;
         "./extensions/database": string;
         "./extensions/eval": string;
         "./extensions/parser": string;
@@ -84,6 +90,7 @@ declare namespace _default {
         "./extensions/schema": string;
         "./extensions/observability": string;
         "./extensions/websocket": string;
+        "./platform/env": string;
         "./testing": string;
         "./testing/assert": string;
         "./testing/bdd": string;
@@ -130,6 +137,7 @@ declare namespace _default {
         "veryfront/workflow/runtime": string;
         "veryfront/workflow/worker": string;
         "veryfront/workflow/claude-code": string;
+        "veryfront/workflow/claude-code/types": string;
         "veryfront/workflow/claude-code/react": string;
         "veryfront/workflow/discovery": string;
         "veryfront/utils": string;
@@ -147,6 +155,7 @@ declare namespace _default {
         "veryfront/observability/otlp-setup": string;
         "veryfront/observability/sentry": string;
         "veryfront/platform/esbuild-init": string;
+        "veryfront/platform/env": string;
         "veryfront/platform/path": string;
         "veryfront/platform/http": string;
         "veryfront/cli": string;
@@ -166,6 +175,8 @@ declare namespace _default {
         "veryfront/cache": string;
         "veryfront/security": string;
         "veryfront/errors": string;
+        "veryfront/errors/general": string;
+        "veryfront/errors/module": string;
         "veryfront/trigger/target": string;
         "veryfront/trigger/validation": string;
         "veryfront/issues": string;
@@ -177,6 +188,7 @@ declare namespace _default {
         "veryfront/tool/schema": string;
         "veryfront/agent/composition": string;
         "veryfront/extensions": string;
+        "veryfront/extensions/types": string;
         "veryfront/testing": string;
         "veryfront/testing/assert": string;
         "veryfront/testing/bdd": string;
@@ -185,10 +197,12 @@ declare namespace _default {
         "veryfront/extensions/bundler": string;
         "veryfront/extensions/cache": string;
         "veryfront/extensions/content": string;
+        "veryfront/extensions/distributed": string;
         "veryfront/extensions/compat": string;
         "veryfront/extensions/contracts": string;
         "veryfront/extensions/first-party-import": string;
         "veryfront/extensions/css": string;
+        "veryfront/extensions/image": string;
         "veryfront/extensions/database": string;
         "veryfront/extensions/eval": string;
         "veryfront/extensions/parser": string;
@@ -217,6 +231,8 @@ declare namespace _default {
         "#veryfront/eval/agent-service": string;
         "#veryfront/metrics": string;
         "#veryfront/extensions/eval": string;
+        "#veryfront/extensions/distributed": string;
+        "#veryfront/extensions/distributed/": string;
         "#veryfront/extensions/first-party-import.ts": string;
         "#veryfront/html": string;
         "#veryfront/mcp": string;

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.1185",
+    "version": "0.1.1186",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {
@@ -48,7 +48,11 @@ export default {
         "./extensions/ext-blob-s3",
         "./extensions/ext-bundler-esbuild",
         "./extensions/ext-cache-redis",
+        "./extensions/ext-redis",
+        "./extensions/ext-css-lightning",
+        "./extensions/ext-css-purgecss",
         "./extensions/ext-css-tailwind",
+        "./extensions/ext-image-sharp",
         "./extensions/ext-node-websocket-ws",
         "./extensions/ext-document-kreuzberg",
         "./extensions/ext-db-sqlite",
@@ -101,6 +105,7 @@ export default {
         "./workflow/blob": "./src/workflow/blob/index.ts",
         "./workflow/worker": "./src/workflow/worker/index.ts",
         "./workflow/claude-code": "./src/workflow/claude-code/index.ts",
+        "./workflow/claude-code/types": "./src/workflow/claude-code/types.ts",
         "./workflow/claude-code/react": "./src/workflow/claude-code/react/index.ts",
         "./workflow/discovery": "./src/workflow/discovery/index.ts",
         "./schemas": "./src/schemas/index.ts",
@@ -118,6 +123,8 @@ export default {
         "./observability": "./src/observability/index.ts",
         "./observability/sentry": "./src/observability/sentry.ts",
         "./observability/otlp-setup": "./src/observability/tracing/otlp-setup.ts",
+        "./errors/general": "./src/errors/error-registry/general.ts",
+        "./errors/module": "./src/errors/error-registry/module.ts",
         "./utils": "./src/utils/index.ts",
         "./utils/logger": "./src/utils/logger/index.ts",
         "./release-assets": "./src/release-assets/index.ts",
@@ -131,15 +138,18 @@ export default {
         "./embedding": "./src/embedding/index.ts",
         "./knowledge": "./src/knowledge/index.ts",
         "./extensions": "./src/extensions/index.ts",
+        "./extensions/types": "./src/extensions/types.ts",
         "./extensions/llm": "./src/extensions/llm/index.ts",
         "./extensions/auth": "./src/extensions/auth/index.ts",
         "./extensions/bundler": "./src/extensions/bundler/index.ts",
         "./extensions/cache": "./src/extensions/cache/index.ts",
         "./extensions/content": "./src/extensions/content/index.ts",
+        "./extensions/distributed": "./src/extensions/distributed/index.ts",
         "./extensions/contracts": "./src/extensions/contracts.ts",
         "./extensions/compat": "./src/extensions/compat/index.ts",
         "./extensions/first-party-import": "./src/extensions/first-party-import.ts",
         "./extensions/css": "./src/extensions/css/index.ts",
+        "./extensions/image": "./src/extensions/image/index.ts",
         "./extensions/database": "./src/extensions/database/index.ts",
         "./extensions/eval": "./src/extensions/eval/index.ts",
         "./extensions/parser": "./src/extensions/parser/index.ts",
@@ -147,6 +157,7 @@ export default {
         "./extensions/schema": "./src/extensions/schema/index.ts",
         "./extensions/observability": "./src/extensions/observability/index.ts",
         "./extensions/websocket": "./src/extensions/websocket/index.ts",
+        "./platform/env": "./src/platform/compat/process/env.ts",
         "./testing": "./src/testing/index.ts",
         "./testing/assert": "./src/testing/assert.ts",
         "./testing/bdd": "./src/testing/bdd.ts",
@@ -193,6 +204,7 @@ export default {
         "veryfront/workflow/runtime": "./src/workflow/runtime/index.ts",
         "veryfront/workflow/worker": "./src/workflow/worker/index.ts",
         "veryfront/workflow/claude-code": "./src/workflow/claude-code/index.ts",
+        "veryfront/workflow/claude-code/types": "./src/workflow/claude-code/types.ts",
         "veryfront/workflow/claude-code/react": "./src/workflow/claude-code/react/index.ts",
         "veryfront/workflow/discovery": "./src/workflow/discovery/index.ts",
         "veryfront/utils": "./src/utils/index.ts",
@@ -210,6 +222,7 @@ export default {
         "veryfront/observability/otlp-setup": "./src/observability/tracing/otlp-setup.ts",
         "veryfront/observability/sentry": "./src/observability/sentry.ts",
         "veryfront/platform/esbuild-init": "./src/platform/compat/esbuild-init.ts",
+        "veryfront/platform/env": "./src/platform/compat/process/env.ts",
         "veryfront/platform/path": "./src/platform/compat/path/index.ts",
         "veryfront/platform/http": "./src/platform/compat/http/index.ts",
         "veryfront/cli": "./cli/main.ts",
@@ -229,6 +242,8 @@ export default {
         "veryfront/cache": "./src/cache/index.ts",
         "veryfront/security": "./src/security/index.ts",
         "veryfront/errors": "./src/errors/index.ts",
+        "veryfront/errors/general": "./src/errors/error-registry/general.ts",
+        "veryfront/errors/module": "./src/errors/error-registry/module.ts",
         "veryfront/trigger/target": "./src/trigger/target.ts",
         "veryfront/trigger/validation": "./src/trigger/validation.ts",
         "veryfront/issues": "./src/issues/index.ts",
@@ -240,6 +255,7 @@ export default {
         "veryfront/tool/schema": "./src/tool/schema/index.ts",
         "veryfront/agent/composition": "./src/agent/composition/index.ts",
         "veryfront/extensions": "./src/extensions/index.ts",
+        "veryfront/extensions/types": "./src/extensions/types.ts",
         "veryfront/testing": "./src/testing/index.ts",
         "veryfront/testing/assert": "./src/testing/assert.ts",
         "veryfront/testing/bdd": "./src/testing/bdd.ts",
@@ -248,10 +264,12 @@ export default {
         "veryfront/extensions/bundler": "./src/extensions/bundler/index.ts",
         "veryfront/extensions/cache": "./src/extensions/cache/index.ts",
         "veryfront/extensions/content": "./src/extensions/content/index.ts",
+        "veryfront/extensions/distributed": "./src/extensions/distributed/index.ts",
         "veryfront/extensions/compat": "./src/extensions/compat/index.ts",
         "veryfront/extensions/contracts": "./src/extensions/contracts.ts",
         "veryfront/extensions/first-party-import": "./src/extensions/first-party-import.ts",
         "veryfront/extensions/css": "./src/extensions/css/index.ts",
+        "veryfront/extensions/image": "./src/extensions/image/index.ts",
         "veryfront/extensions/database": "./src/extensions/database/index.ts",
         "veryfront/extensions/eval": "./src/extensions/eval/index.ts",
         "veryfront/extensions/parser": "./src/extensions/parser/index.ts",
@@ -280,6 +298,8 @@ export default {
         "#veryfront/eval/agent-service": "./src/eval/agent-service.ts",
         "#veryfront/metrics": "./src/metrics/index.ts",
         "#veryfront/extensions/eval": "./src/extensions/eval/index.ts",
+        "#veryfront/extensions/distributed": "./src/extensions/distributed/index.ts",
+        "#veryfront/extensions/distributed/": "./src/extensions/distributed/",
         "#veryfront/extensions/first-party-import.ts": "./src/extensions/first-party-import.ts",
         "#veryfront/html": "./src/html/index.ts",
         "#veryfront/mcp": "./src/mcp/index.ts",

package/esm/src/errors/error-registry.d.ts

@@ -3,13 +3,13 @@ export * from "./error-registry/config.js";
 export * from "./error-registry/build.js";
 export * from "./error-registry/runtime.js";
 export * from "./error-registry/route.js";
-export * from "./error-registry/module.js";
+export * from "veryfront/errors/module";
 export * from "./error-registry/server.js";
 export * from "./error-registry/boundary.js";
 export * from "./error-registry/dev.js";
 export * from "./error-registry/deploy.js";
 export * from "./error-registry/agent.js";
-export * from "./error-registry/general.js";
+export * from "veryfront/errors/general";
 /**
  * Central registry mapping every error slug to its definition. Assembled from
  * the per-category registry fragments.

package/esm/src/platform/adapters/base.d.ts

@@ -122,10 +122,26 @@ export interface Server {
     };
 }
 export interface FileSystemAdapter {
+    /** Explicit marker for virtual filesystems that never resolve symbolic links. */
+    readonly symlinkSemantics?: "none";
     readFile(path: string): Promise<string>;
     /** Read raw bytes when binary-safe access is required */
     readFileBytes?(path: string): Promise<Uint8Array>;
+    /** Fixed upstream whole-object ceiling, valid only with `readFileBytes`. */
+    readonly maxWholeFileReadBytes?: number;
+    /** Read at most a caller-selected byte prefix without materializing the whole source. */
+    readFileBytesBounded?(path: string, byteLimit: number): Promise<Uint8Array>;
+    /** Read a complete file only when it fits within the caller-selected limit. */
+    readFileBytesWithinLimit?(path: string, byteLimit: number): Promise<Uint8Array>;
+    /** Read one verified native snapshot beneath `containmentRoot`. */
+    readFileSnapshotWithinLimit?(path: string, containmentRoot: string, byteLimit: number): Promise<Uint8Array>;
     writeFile(path: string, content: string): Promise<void>;
+    /** Write raw bytes when binary-safe output is required. */
+    writeFileBytes?(path: string, content: Uint8Array): Promise<void>;
+    /** Create a new file atomically, refusing to replace an existing path. */
+    createFileBytesExclusive?(path: string, content: Uint8Array): Promise<void>;
+    /** Atomically replace a path when the runtime supports same-filesystem rename. */
+    rename?(from: string, to: string): Promise<void>;
     exists(path: string): Promise<boolean>;
     readDir(path: string): AsyncIterable<DirEntry>;
     stat(path: string): Promise<FileInfo>;
@@ -168,6 +184,8 @@ export interface FileSystemAdapter {
      */
     getSourceSnapshotVersion?(): number | undefined | Promise<number | undefined>;
 }
+export type BoundedFileSystemAdapter = FileSystemAdapter & Required<Pick<FileSystemAdapter, "readFileBytesBounded">>;
+export type ExactBoundedFileSystemAdapter = FileSystemAdapter & Required<Pick<FileSystemAdapter, "readFileBytesWithinLimit">>;
 export interface ResolveFileOptions {
     allowPagesPrefix?: boolean;
 }

package/esm/src/platform/adapters/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/adapters/base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/adapters/base.ts"],"names":[],"mappings":"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"}

package/esm/src/platform/adapters/bounded-file-read.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Minimal handle contract shared by native filesystem adapters.
+ *
+ * The caller supplies the handle factory so each runtime can choose its native
+ * open semantics while this helper owns bounded chunking and cleanup.
+ */
+export interface BoundedFileReader {
+    read(buffer: Uint8Array): Promise<number | null>;
+}
+export interface BoundedFileReadHandle extends BoundedFileReader {
+    close(): void | Promise<void>;
+}
+export declare function requireBoundedFileReadLimit(byteLimit: unknown): number;
+/**
+ * Read at most `byteLimit` bytes without first materializing the whole file.
+ *
+ * A full-length result is intentionally ambiguous: callers that need to
+ * distinguish an exact-size file from an oversized file request their accepted
+ * maximum plus one byte.
+ */
+export declare function readBoundedFilePrefix(openHandle: () => Promise<BoundedFileReadHandle>, byteLimit: number): Promise<Uint8Array>;
+/**
+ * Read the complete file only when it fits within `byteLimit`.
+ *
+ * Unlike a prefix read, reaching the limit triggers one additional EOF probe.
+ * The probe reuses the final byte of the accepted buffer, so the helper never
+ * retains more than `byteLimit` bytes from the source.
+ */
+export declare function readFileWithinLimit(openHandle: () => Promise<BoundedFileReadHandle>, byteLimit: number): Promise<Uint8Array>;
+/** Read a bounded prefix while leaving ownership of the open handle to the caller. */
+export declare function readBoundedFileHandlePrefix(reader: BoundedFileReader, byteLimit: number): Promise<Uint8Array>;
+/** Read a complete bounded file while leaving ownership of the handle to the caller. */
+export declare function readFileHandleWithinLimit(reader: BoundedFileReader, byteLimit: number): Promise<Uint8Array>;
+//# sourceMappingURL=bounded-file-read.d.ts.map

package/esm/src/platform/adapters/bounded-file-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-file-read.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/adapters/bounded-file-read.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAuGD,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAKtE;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,EAChD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAMrB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,EAChD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAMrB;AAED,sFAAsF;AACtF,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAoDrB;AAED,wFAAwF;AACxF,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAuBrB"}

package/esm/src/platform/adapters/bounded-file-read.js

@@ -0,0 +1,179 @@
+const apply = Reflect.apply;
+const arrayPush = Array.prototype.push;
+const minimum = Math.min;
+const numberIsSafeInteger = Number.isSafeInteger;
+const NativeUint8Array = Uint8Array;
+const typedArrayPrototype = Object.getPrototypeOf(NativeUint8Array.prototype);
+const typedArrayByteLengthGetterCandidate = Object.getOwnPropertyDescriptor(typedArrayPrototype, "byteLength")?.get;
+const typedArrayBufferGetterCandidate = Object.getOwnPropertyDescriptor(typedArrayPrototype, "buffer")?.get;
+const typedArrayByteOffsetGetterCandidate = Object.getOwnPropertyDescriptor(typedArrayPrototype, "byteOffset")?.get;
+const setBytes = NativeUint8Array.prototype.set;
+if (typeof typedArrayByteLengthGetterCandidate !== "function" ||
+    typeof typedArrayBufferGetterCandidate !== "function" ||
+    typeof typedArrayByteOffsetGetterCandidate !== "function") {
+    throw new TypeError("Required Uint8Array intrinsics are unavailable");
+}
+const typedArrayByteLengthGetter = typedArrayByteLengthGetterCandidate;
+const typedArrayBufferGetter = typedArrayBufferGetterCandidate;
+const typedArrayByteOffsetGetter = typedArrayByteOffsetGetterCandidate;
+function byteLengthOf(value) {
+    const byteLength = apply(typedArrayByteLengthGetter, value, []);
+    if (!numberIsSafeInteger(byteLength) || byteLength < 0) {
+        throw new TypeError("Filesystem read buffer has an invalid byte length");
+    }
+    return byteLength;
+}
+function allocateBytes(byteLength) {
+    const bytes = new NativeUint8Array(byteLength);
+    if (byteLengthOf(bytes) !== byteLength) {
+        throw new TypeError("Filesystem byte buffer allocation returned an invalid size");
+    }
+    return bytes;
+}
+function viewBytes(value, start, byteLength) {
+    const sourceByteLength = byteLengthOf(value);
+    if (!numberIsSafeInteger(start) || start < 0 ||
+        !numberIsSafeInteger(byteLength) || byteLength < 0 ||
+        start > sourceByteLength - byteLength) {
+        throw new RangeError("Filesystem byte view is outside its source buffer");
+    }
+    const buffer = apply(typedArrayBufferGetter, value, []);
+    const byteOffset = apply(typedArrayByteOffsetGetter, value, []);
+    const view = new NativeUint8Array(buffer, byteOffset + start, byteLength);
+    if (byteLengthOf(view) !== byteLength) {
+        throw new TypeError("Filesystem byte view allocation returned an invalid size");
+    }
+    return view;
+}
+// Keep a large caller-supplied limit from becoming an equally large eager
+// allocation when the source is small. The aggregate returned data remains
+// bounded by the caller's limit.
+const BOUNDED_FILE_READ_CHUNK_BYTES = 64 * 1024;
+async function readAndCloseHandle(openHandle, read) {
+    const handle = await openHandle();
+    let result;
+    let primaryFailure;
+    let primaryFailed = false;
+    try {
+        result = await read(handle);
+    }
+    catch (error) {
+        primaryFailed = true;
+        primaryFailure = error;
+    }
+    try {
+        await handle.close();
+    }
+    catch (cleanupFailure) {
+        if (primaryFailed) {
+            throw new AggregateError([primaryFailure, cleanupFailure], "Filesystem read and handle cleanup both failed");
+        }
+        throw cleanupFailure;
+    }
+    if (primaryFailed)
+        throw primaryFailure;
+    return result;
+}
+export function requireBoundedFileReadLimit(byteLimit) {
+    if (!numberIsSafeInteger(byteLimit) || byteLimit <= 0) {
+        throw new RangeError("Filesystem byteLimit must be a positive safe integer");
+    }
+    return byteLimit;
+}
+/**
+ * Read at most `byteLimit` bytes without first materializing the whole file.
+ *
+ * A full-length result is intentionally ambiguous: callers that need to
+ * distinguish an exact-size file from an oversized file request their accepted
+ * maximum plus one byte.
+ */
+export async function readBoundedFilePrefix(openHandle, byteLimit) {
+    const boundedLimit = requireBoundedFileReadLimit(byteLimit);
+    return await readAndCloseHandle(openHandle, (handle) => readBoundedFileHandlePrefix(handle, boundedLimit));
+}
+/**
+ * Read the complete file only when it fits within `byteLimit`.
+ *
+ * Unlike a prefix read, reaching the limit triggers one additional EOF probe.
+ * The probe reuses the final byte of the accepted buffer, so the helper never
+ * retains more than `byteLimit` bytes from the source.
+ */
+export async function readFileWithinLimit(openHandle, byteLimit) {
+    const boundedLimit = requireBoundedFileReadLimit(byteLimit);
+    return await readAndCloseHandle(openHandle, (handle) => readFileHandleWithinLimit(handle, boundedLimit));
+}
+/** Read a bounded prefix while leaving ownership of the open handle to the caller. */
+export async function readBoundedFileHandlePrefix(reader, byteLimit) {
+    const boundedLimit = requireBoundedFileReadLimit(byteLimit);
+    const chunks = [];
+    let byteLength = 0;
+    let reachedEnd = false;
+    while (byteLength < boundedLimit) {
+        const chunk = allocateBytes(minimum(BOUNDED_FILE_READ_CHUNK_BYTES, boundedLimit - byteLength));
+        let chunkLength = 0;
+        const chunkByteLength = byteLengthOf(chunk);
+        while (chunkLength < chunkByteLength) {
+            const remaining = viewBytes(chunk, chunkLength, chunkByteLength - chunkLength);
+            const bytesRead = await reader.read(remaining);
+            if (bytesRead === null || bytesRead === 0) {
+                reachedEnd = true;
+                break;
+            }
+            if (!numberIsSafeInteger(bytesRead) ||
+                bytesRead < 0 ||
+                bytesRead > byteLengthOf(remaining)) {
+                throw new TypeError("Filesystem read returned an invalid byte count");
+            }
+            chunkLength += bytesRead;
+            byteLength += bytesRead;
+        }
+        if (chunkLength > 0) {
+            // Copy a short final chunk so a tiny result does not retain the entire
+            // fixed-size read buffer.
+            if (chunkLength === chunkByteLength) {
+                apply(arrayPush, chunks, [chunk]);
+            }
+            else {
+                const shortChunk = allocateBytes(chunkLength);
+                apply(setBytes, shortChunk, [viewBytes(chunk, 0, chunkLength)]);
+                apply(arrayPush, chunks, [shortChunk]);
+            }
+        }
+        if (reachedEnd)
+            break;
+    }
+    if (chunks.length === 0)
+        return allocateBytes(0);
+    if (chunks.length === 1)
+        return chunks[0];
+    const bytes = allocateBytes(byteLength);
+    let offset = 0;
+    for (let index = 0; index < chunks.length; index++) {
+        const chunk = chunks[index];
+        apply(setBytes, bytes, [chunk, offset]);
+        offset += byteLengthOf(chunk);
+    }
+    return bytes;
+}
+/** Read a complete bounded file while leaving ownership of the handle to the caller. */
+export async function readFileHandleWithinLimit(reader, byteLimit) {
+    const boundedLimit = requireBoundedFileReadLimit(byteLimit);
+    const bytes = await readBoundedFileHandlePrefix(reader, boundedLimit);
+    if (byteLengthOf(bytes) < boundedLimit)
+        return bytes;
+    // Reuse the final accepted byte as the EOF probe instead of allocating or
+    // retaining a maximum-plus-one buffer. Restore it when the file ends exactly
+    // at the limit; on overflow the result is discarded.
+    const finalIndex = boundedLimit - 1;
+    const acceptedFinalByte = bytes[finalIndex];
+    const probe = viewBytes(bytes, finalIndex, 1);
+    const bytesRead = await reader.read(probe);
+    if (bytesRead === null || bytesRead === 0) {
+        bytes[finalIndex] = acceptedFinalByte;
+        return bytes;
+    }
+    if (!numberIsSafeInteger(bytesRead) || bytesRead < 0 || bytesRead > byteLengthOf(probe)) {
+        throw new TypeError("Filesystem read returned an invalid byte count");
+    }
+    throw new RangeError(`File exceeds byte limit of ${boundedLimit} ${boundedLimit === 1 ? "byte" : "bytes"}`);
+}

package/esm/src/platform/adapters/file-snapshot-error.d.ts

@@ -0,0 +1,6 @@
+export declare class FileSnapshotChangedError extends Error {
+    readonly name = "FileSnapshotChangedError";
+    constructor(message?: string);
+}
+export declare function isFileSnapshotChangedError(value: unknown): value is FileSnapshotChangedError;
+//# sourceMappingURL=file-snapshot-error.d.ts.map

package/esm/src/platform/adapters/file-snapshot-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-snapshot-error.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/adapters/file-snapshot-error.ts"],"names":[],"mappings":"AAEA,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,SAAkB,IAAI,8BAA8B;gBAExC,OAAO,SAA0C;CAI9D;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,wBAAwB,CAEnC"}

package/esm/src/platform/adapters/file-snapshot-error.js

@@ -0,0 +1,11 @@
+const changedErrors = new WeakSet();
+export class FileSnapshotChangedError extends Error {
+    name = "FileSnapshotChangedError";
+    constructor(message = "File snapshot changed during the read") {
+        super(message);
+        changedErrors.add(this);
+    }
+}
+export function isFileSnapshotChangedError(value) {
+    return typeof value === "object" && value !== null && changedErrors.has(value);
+}

package/esm/src/platform/adapters/runtime/shared/native-file-capabilities.d.ts

@@ -0,0 +1,33 @@
+interface SnapshotStat {
+    readonly dev: bigint;
+    readonly ino: bigint;
+    readonly size: bigint;
+    readonly mtimeNs: bigint;
+    readonly ctimeNs: bigint;
+    isFile(): boolean;
+    isSymbolicLink(): boolean;
+}
+interface SnapshotHandle {
+    stat(): Promise<SnapshotStat>;
+    read(buffer: Uint8Array, offset: number, length: number, position: number): Promise<{
+        bytesRead: number;
+    }>;
+    writeFile(content: Uint8Array): Promise<void>;
+    close(): Promise<void>;
+}
+export interface NativeSnapshotOperations {
+    realpath(path: string): Promise<string>;
+    lstat(path: string): Promise<SnapshotStat>;
+    open(path: string, flags: number | string): Promise<SnapshotHandle>;
+}
+/** Whether the runtime can enforce a no-follow native snapshot open. */
+export declare function supportsNativeFileSnapshots(platform?: "posix" | "windows"): boolean;
+/**
+ * Read one verified regular-file generation without following a terminal link.
+ * Identity and generation are checked before and after the bounded positional read.
+ */
+export declare function readNodeFileSnapshotWithinLimit(path: string, containmentRoot: string, byteLimit: number, operations?: NativeSnapshotOperations): Promise<Uint8Array>;
+/** Create a new file without replacement and join handle cleanup. */
+export declare function createNodeFileBytesExclusive(path: string, content: Uint8Array, operations?: NativeSnapshotOperations): Promise<void>;
+export {};
+//# sourceMappingURL=native-file-capabilities.d.ts.map

package/esm/src/platform/adapters/runtime/shared/native-file-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-file-capabilities.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/runtime/shared/native-file-capabilities.ts"],"names":[],"mappings":"AAIA,UAAU,YAAY;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,MAAM,IAAI,OAAO,CAAC;IAClB,cAAc,IAAI,OAAO,CAAC;CAC3B;AAED,UAAU,cAAc;IACtB,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9B,IAAI,CACF,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClC,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACrE;AAED,wEAAwE;AACxE,wBAAgB,2BAA2B,CACzC,QAAQ,GAAE,OAAO,GAAG,SAA2D,GAC9E,OAAO,CAET;AAkFD;;;GAGG;AACH,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,wBAAwB,GACpC,OAAO,CAAC,UAAU,CAAC,CAsHrB;AAED,qEAAqE;AACrE,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,EACnB,UAAU,CAAC,EAAE,wBAAwB,GACpC,OAAO,CAAC,IAAI,CAAC,CAYf"}