veryfront 0.1.215 → 0.1.217

package/esm/src/extensions/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Core types for the veryfront extension system.
+ *
+ * @module extensions/types
+ */
+/**
+ * Declares a system capability an extension requires.
+ * Object-based for extensibility -- scoping fields vary by type.
+ */
+export interface Capability {
+    type: string;
+    [key: string]: unknown;
+}
+export interface ExtensionContext {
+    get<T>(contract: string): T | undefined;
+    require<T>(contract: string): T;
+    provide<T>(contract: string, impl: T): void;
+    config: Record<string, unknown>;
+    logger: ExtensionLogger;
+}
+export interface ExtensionLogger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+export interface Extension {
+    name: string;
+    version: string;
+    capabilities: Capability[];
+    setup?(ctx: ExtensionContext): Promise<void> | void;
+    teardown?(): Promise<void> | void;
+    provides?: Record<string, unknown>;
+    extends?: Extension[];
+}
+export type ExtensionFactory = (config?: unknown) => Extension;
+export type ExtensionConfigEntry = Extension | {
+    name: string;
+    enabled: false;
+};
+export type ExtensionSource = "config" | "package" | "project" | "local-file";
+export interface ResolvedExtension {
+    extension: Extension;
+    source: ExtensionSource;
+    origin: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/esm/src/extensions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACxC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC;IAChC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,KAAK,CAAC,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpD,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,SAAS,CAAC;AAE/D,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAErC,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,SAAS,GACT,SAAS,GACT,YAAY,CAAC;AAEjB,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/esm/src/extensions/types.js

@@ -0,0 +1,6 @@
+/**
+ * Core types for the veryfront extension system.
+ *
+ * @module extensions/types
+ */
+export {};

package/esm/src/extensions/validation.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Extension validation and conflict detection.
+ *
+ * @module extensions/validation
+ */
+import type { ExtensionSource, ResolvedExtension } from "./types.js";
+/**
+ * Information about a contract conflict between extensions.
+ */
+export interface ConflictInfo {
+    contract: string;
+    providers: Array<{
+        name: string;
+        source: ExtensionSource;
+    }>;
+}
+/**
+ * Priority map for extension sources.
+ * Lower number = higher priority.
+ */
+export declare const SOURCE_PRIORITY: Record<ExtensionSource, number>;
+/**
+ * Select the highest-priority provider for each contract across a list of
+ * resolved extensions. When multiple extensions provide the same contract,
+ * the one whose source has the lowest `SOURCE_PRIORITY` number wins.
+ * Ties break on first-seen order (mirrors detectConflicts semantics).
+ */
+export declare function selectContractProviders(extensions: ResolvedExtension[]): Map<string, ResolvedExtension>;
+/**
+ * Validate the shape of an extension object.
+ * Returns an array of issue descriptions (empty array = valid).
+ *
+ * Accepts `unknown` so callers at module-boundary / config-loading paths can
+ * validate arbitrary imported values without casting.
+ */
+export declare function validateExtension(ext: unknown): string[];
+/**
+ * Detect contract conflicts between resolved extensions.
+ *
+ * A conflict exists when two or more extensions provide the same contract
+ * and no single provider has strictly higher source priority than all others.
+ */
+export declare function detectConflicts(extensions: ResolvedExtension[]): ConflictInfo[];
+//# sourceMappingURL=validation.d.ts.map

package/esm/src/extensions/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAa,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAK3D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,iBAAiB,EAAE,GAC9B,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAgBhC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAmCxD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,YAAY,EAAE,CA2C/E"}

package/esm/src/extensions/validation.js

@@ -0,0 +1,115 @@
+/**
+ * Extension validation and conflict detection.
+ *
+ * @module extensions/validation
+ */
+/**
+ * Priority map for extension sources.
+ * Lower number = higher priority.
+ */
+export const SOURCE_PRIORITY = {
+    config: 0,
+    package: 1,
+    project: 2,
+    "local-file": 3,
+};
+/**
+ * Select the highest-priority provider for each contract across a list of
+ * resolved extensions. When multiple extensions provide the same contract,
+ * the one whose source has the lowest `SOURCE_PRIORITY` number wins.
+ * Ties break on first-seen order (mirrors detectConflicts semantics).
+ */
+export function selectContractProviders(extensions) {
+    const winner = new Map();
+    for (const resolved of extensions) {
+        const provides = resolved.extension.provides;
+        if (!provides)
+            continue;
+        for (const contract of Object.keys(provides)) {
+            const current = winner.get(contract);
+            if (!current ||
+                SOURCE_PRIORITY[resolved.source] < SOURCE_PRIORITY[current.source]) {
+                winner.set(contract, resolved);
+            }
+        }
+    }
+    return winner;
+}
+/**
+ * Validate the shape of an extension object.
+ * Returns an array of issue descriptions (empty array = valid).
+ *
+ * Accepts `unknown` so callers at module-boundary / config-loading paths can
+ * validate arbitrary imported values without casting.
+ */
+export function validateExtension(ext) {
+    const issues = [];
+    if (ext === null || typeof ext !== "object" || Array.isArray(ext)) {
+        issues.push("extension must be a non-null object");
+        return issues;
+    }
+    const candidate = ext;
+    if (typeof candidate.name !== "string" || candidate.name.length === 0) {
+        issues.push("name must be a non-empty string");
+    }
+    if (typeof candidate.version !== "string" || candidate.version.length === 0) {
+        issues.push("version must be a non-empty string");
+    }
+    if (!Array.isArray(candidate.capabilities)) {
+        issues.push("capabilities must be an array");
+        return issues;
+    }
+    for (let i = 0; i < candidate.capabilities.length; i++) {
+        const cap = candidate.capabilities[i];
+        if (typeof cap !== "object" || cap === null || Array.isArray(cap)) {
+            issues.push(`capabilities[${i}] must be an object`);
+            continue;
+        }
+        if (typeof cap.type !== "string" || cap.type.length === 0) {
+            issues.push(`capabilities[${i}].type must be a non-empty string`);
+        }
+    }
+    return issues;
+}
+/**
+ * Detect contract conflicts between resolved extensions.
+ *
+ * A conflict exists when two or more extensions provide the same contract
+ * and no single provider has strictly higher source priority than all others.
+ */
+export function detectConflicts(extensions) {
+    const contractProviders = new Map();
+    for (const resolved of extensions) {
+        const provides = resolved.extension.provides;
+        if (!provides)
+            continue;
+        for (const contract of Object.keys(provides)) {
+            let list = contractProviders.get(contract);
+            if (!list) {
+                list = [];
+                contractProviders.set(contract, list);
+            }
+            list.push({
+                name: resolved.extension.name,
+                source: resolved.source,
+            });
+        }
+    }
+    const conflicts = [];
+    for (const [contract, providers] of contractProviders) {
+        if (providers.length < 2)
+            continue;
+        // Find the highest priority (lowest number) among providers
+        const priorities = providers.map((p) => SOURCE_PRIORITY[p.source]);
+        const bestPriority = Math.min(...priorities);
+        const winnersCount = priorities.filter((p) => p === bestPriority).length;
+        // If exactly one provider has the best priority, no conflict
+        if (winnersCount === 1)
+            continue;
+        conflicts.push({
+            contract,
+            providers: providers.map((p) => ({ name: p.name, source: p.source })),
+        });
+    }
+    return conflicts;
+}

package/esm/src/html/styles-builder/plugin-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/plugin-loader.ts"],"names":[],"mappings":"AAwGA;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0D/E;AAED,wBAAsB,UAAU,CAC9B,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CAmClB"}
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/plugin-loader.ts"],"names":[],"mappings":"AAiIA;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4D/E;AAED,wBAAsB,UAAU,CAC9B,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CAwClB"}

package/esm/src/html/styles-builder/plugin-loader.js

@@ -13,7 +13,25 @@ import colors from "tailwindcss/colors";
 import { serverLogger } from "../../utils/index.js";
 import { getErrorBySlug, IMPORT_RESOLUTION_ERROR, NETWORK_ERROR, VeryfrontError, } from "../../errors/index.js";
 import { getTailwindPluginBundleUrl } from "../../build/binary-plugin-includes.js";
+import { bareName, PACKAGE_SPEC_RE, TAILWIND_PLUGIN_ALLOWLIST, } from "./tailwind-plugin-allowlist.js";
 const logger = serverLogger.component("tailwind");
+/**
+ * Enforce the Tailwind plugin allowlist (VULN-FS-1).
+ *
+ * Called at the top of every entry point that can load third-party plugin
+ * code. Rejects anything that is not a syntactically valid npm package
+ * specifier, and anything whose bare name is not on the allowlist.
+ */
+function assertPluginAllowed(spec) {
+    if (!PACKAGE_SPEC_RE.test(spec)) {
+        throw new Error(`Invalid Tailwind plugin specifier: ${spec}`);
+    }
+    const name = bareName(spec);
+    if (!TAILWIND_PLUGIN_ALLOWLIST.has(name)) {
+        throw new Error(`Package "${name}" is not on the Tailwind plugin allowlist. ` +
+            `See src/html/styles-builder/tailwind-plugin-allowlist.ts.`);
+    }
+}
 // Provide localStorage shim for plugins that use util-deprecate (which checks localStorage)
 // This prevents "LocalStorage is not supported in this context" errors in Deno.
 try {
@@ -89,6 +107,7 @@ async function importBundledModule(code) {
  * dynamic imports from URLs. Fetches bundled code, rewrites imports, loads via temp file.
  */
 export async function loadModuleFromEsmSh(packageName) {
+    assertPluginAllowed(packageName);
     const stubUrl = getTailwindPluginBundleUrl(packageName);
     logger.debug("Fetching esm.sh stub", { url: stubUrl });
     const stubResponse = await fetch(stubUrl);
@@ -133,6 +152,10 @@ export async function loadModuleFromEsmSh(packageName) {
     return await importBundledModule(code);
 }
 export async function loadPlugin(id, pluginCache, pluginErrors) {
+    // Enforce the allowlist before consulting any caches so a disallowed id can
+    // never be served from a pre-seeded or stale cache entry — defence-in-depth
+    // against future changes that might pre-populate these maps.
+    assertPluginAllowed(id);
     const cachedError = pluginErrors.get(id);
     if (cachedError)
         throw cachedError;

package/esm/src/html/styles-builder/tailwind-plugin-allowlist.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Allowlist of Tailwind CSS plugin package names that may be dynamically loaded
+ * via `loadPlugin` / `loadModuleFromEsmSh`.
+ *
+ * Tailwind v4 stylesheets can request plugins through the `@plugin "..."`
+ * directive. Without restriction, this turns arbitrary project CSS into a
+ * remote-code-execution vector because the loader fetches and imports code
+ * from https://esm.sh. Only the packages listed here may be loaded.
+ *
+ * @module html/styles-builder/tailwind-plugin-allowlist
+ */
+export declare const TAILWIND_PLUGIN_ALLOWLIST: ReadonlySet<string>;
+/**
+ * Matches npm package specifiers, optionally scoped and optionally suffixed
+ * with an `@version` range. Deliberately restrictive: ASCII only, no path
+ * separators, no whitespace, no control characters.
+ */
+export declare const PACKAGE_SPEC_RE: RegExp;
+/**
+ * Return the bare package name (without any `@version` suffix) for a spec.
+ *
+ * Examples:
+ *   bareName("pkg")            -> "pkg"
+ *   bareName("pkg@1.0.0")      -> "pkg"
+ *   bareName("@scope/pkg")     -> "@scope/pkg"
+ *   bareName("@scope/pkg@1.0") -> "@scope/pkg"
+ */
+export declare function bareName(spec: string): string;
+//# sourceMappingURL=tailwind-plugin-allowlist.d.ts.map

package/esm/src/html/styles-builder/tailwind-plugin-allowlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-plugin-allowlist.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/tailwind-plugin-allowlist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAaxD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAA4D,CAAC;AAEzF;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO7C"}

package/esm/src/html/styles-builder/tailwind-plugin-allowlist.js

@@ -0,0 +1,48 @@
+/**
+ * Allowlist of Tailwind CSS plugin package names that may be dynamically loaded
+ * via `loadPlugin` / `loadModuleFromEsmSh`.
+ *
+ * Tailwind v4 stylesheets can request plugins through the `@plugin "..."`
+ * directive. Without restriction, this turns arbitrary project CSS into a
+ * remote-code-execution vector because the loader fetches and imports code
+ * from https://esm.sh. Only the packages listed here may be loaded.
+ *
+ * @module html/styles-builder/tailwind-plugin-allowlist
+ */
+export const TAILWIND_PLUGIN_ALLOWLIST = new Set([
+    // Bundled into the compiled binary (see src/build/binary-plugin-includes.ts).
+    // Must stay in sync with BINARY_TAILWIND_PLUGIN_PACKAGES — an invariant
+    // enforced by tailwind-plugin-allowlist.test.ts.
+    "@tailwindcss/typography",
+    "@tailwindcss/forms",
+    "tailwindcss-animate",
+    "tailwind-scrollbar-hide",
+    "daisyui",
+    // Allowlisted but NOT bundled: loaded from esm.sh on first use. Adding an
+    // entry here is arbitrary-code-exec surface; review each one explicitly.
+    "@tailwindcss/aspect-ratio",
+    "@tailwindcss/container-queries",
+]);
+/**
+ * Matches npm package specifiers, optionally scoped and optionally suffixed
+ * with an `@version` range. Deliberately restrictive: ASCII only, no path
+ * separators, no whitespace, no control characters.
+ */
+export const PACKAGE_SPEC_RE = /^(?:@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*(?:@[\w.+-]+)?$/i;
+/**
+ * Return the bare package name (without any `@version` suffix) for a spec.
+ *
+ * Examples:
+ *   bareName("pkg")            -> "pkg"
+ *   bareName("pkg@1.0.0")      -> "pkg"
+ *   bareName("@scope/pkg")     -> "@scope/pkg"
+ *   bareName("@scope/pkg@1.0") -> "@scope/pkg"
+ */
+export function bareName(spec) {
+    if (spec.startsWith("@")) {
+        const idx = spec.indexOf("@", 1);
+        return idx === -1 ? spec : spec.slice(0, idx);
+    }
+    const idx = spec.indexOf("@");
+    return idx === -1 ? spec : spec.slice(0, idx);
+}

package/esm/src/modules/react-loader/ssr-module-loader/loader-helpers.d.ts

@@ -0,0 +1,15 @@
+export type TransformCapacityErrorMode = "plain" | "build";
+export type ImportErrorClassification = {
+    type: "http-bundle-missing";
+    hash: string;
+    message: string;
+} | {
+    type: "module-not-found";
+    message: string;
+} | {
+    type: "unknown";
+    message: string;
+};
+export declare function classifyImportError(importError: unknown): ImportErrorClassification;
+export declare function createTransformCapacityError(mode: TransformCapacityErrorMode, message: string, filePath: string): Error;
+//# sourceMappingURL=loader-helpers.d.ts.map

package/esm/src/modules/react-loader/ssr-module-loader/loader-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-helpers.d.ts","sourceRoot":"","sources":["../../../../../src/src/modules/react-loader/ssr-module-loader/loader-helpers.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3D,MAAM,MAAM,yBAAyB,GACjC;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,OAAO,GAAG,yBAAyB,CAUnF;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,0BAA0B,EAChC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,KAAK,CASP"}

package/esm/src/modules/react-loader/ssr-module-loader/loader-helpers.js

@@ -0,0 +1,22 @@
+import { createError, toError } from "../../../errors/veryfront-error.js";
+const MISSING_HTTP_BUNDLE_PATTERN = /veryfront-http-bundle\/http-([a-f0-9]+)\.mjs/;
+export function classifyImportError(importError) {
+    const message = importError instanceof Error ? importError.message : String(importError);
+    const bundleMatch = message.match(MISSING_HTTP_BUNDLE_PATTERN);
+    if (bundleMatch?.[1]) {
+        return { type: "http-bundle-missing", hash: bundleMatch[1], message };
+    }
+    if (message.includes("Cannot find module") || message.includes("Module not found")) {
+        return { type: "module-not-found", message };
+    }
+    return { type: "unknown", message };
+}
+export function createTransformCapacityError(mode, message, filePath) {
+    if (mode === "plain")
+        return new Error(message);
+    return toError(createError({
+        type: "build",
+        message,
+        context: { file: filePath, phase: "transform" },
+    }));
+}

package/esm/src/modules/react-loader/ssr-module-loader/loader.d.ts

@@ -19,8 +19,6 @@ export declare class SSRModuleLoader {
     private circuitBreaker;
     private depValidator;
     constructor(options: SSRModuleLoaderOptions);
-    private classifyImportError;
-    private createTransformCapacityError;
     private withTransformCapacity;
     private importModuleFromCacheEntry;
     loadRawModule(filePath: string, source: string): Promise<Record<string, unknown>>;

package/esm/src/modules/react-loader/ssr-module-loader/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../../src/src/modules/react-loader/ssr-module-loader/loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAiCpC,OAAO,KAAK,EAAoB,sBAAsB,EAAE,MAAM,YAAY,CAAC;AA2B3E;;;;;GAKG;AACH,qBAAa,eAAe;IAKd,OAAO,CAAC,OAAO;IAJ3B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,YAAY,CAAyB;gBAEzB,OAAO,EAAE,sBAAsB;IAWnD,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,4BAA4B;YAetB,qBAAqB;YAuCrB,0BAA0B;IAwHxC,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA+C7B,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;YAK1C,2BAA2B;IAYzC,OAAO,CAAC,yBAAyB;YAiBnB,2BAA2B;CA+V1C"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../../src/src/modules/react-loader/ssr-module-loader/loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAsCpC,OAAO,KAAK,EAAoB,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAkB3E;;;;;GAKG;AACH,qBAAa,eAAe;IAKd,OAAO,CAAC,OAAO;IAJ3B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,YAAY,CAAyB;gBAEzB,OAAO,EAAE,sBAAsB;YAWrC,qBAAqB;YAuCrB,0BAA0B;IAwHxC,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA+C7B,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;YAK1C,2BAA2B;IAYzC,OAAO,CAAC,yBAAyB;YAiBnB,2BAA2B;CA+V1C"}

package/esm/src/modules/react-loader/ssr-module-loader/loader.js

@@ -16,6 +16,7 @@ import { rendererLogger } from "../../../utils/index.js";
 import { withSpan } from "../../../observability/tracing/otlp-setup.js";
 import { SpanNames } from "../../../observability/tracing/span-names.js";
 import { extractComponent } from "../extract-component.js";
+import { classifyImportError, createTransformCapacityError, } from "./loader-helpers.js";
 import { getMaxConcurrentTransforms, IN_PROGRESS_WAIT_TIMEOUT_MS, MAX_TRANSFORM_DEPTH, TRANSFORM_ACQUIRE_TIMEOUT_MS, TRANSFORM_BATCH_SIZE, } from "./constants.js";
 import { withTimeoutThrow } from "../../../rendering/utils/stream-utils.js";
 import { getFromRedis, getTransformSemaphore, globalInProgress, globalModuleCache, isSSRDistributedCacheEnabled, releaseTransformSlot, setInRedis, tryAcquireTransformSlot, } from "./cache/index.js";
@@ -34,7 +35,6 @@ import { registerCSSImport } from "../css-import-collector.js";
 import { injectNodePositions } from "../../../transforms/plugins/babel-node-positions.js";
 import { ensureMdxModuleDependencies } from "../../../transforms/mdx/esm-module-loader/module-fetcher/dependency-recovery.js";
 const logger = rendererLogger.component("ssr-module-loader");
-const MISSING_HTTP_BUNDLE_PATTERN = /veryfront-http-bundle\/http-([a-f0-9]+)\.mjs/;
 /**
  * SSR Module Loader with Redis Support.
  *
@@ -51,39 +51,19 @@ export class SSRModuleLoader {
         this.cache = new SSRCacheManager(options);
         this.depValidator = new SSRDependencyValidator((filePath) => this.cache.getCacheKey(filePath), (filePath, source, depth) => this.transformWithDependencies(filePath, source, depth), (crossImport) => this.transformCrossProjectImport(crossImport), options.adapter, options.projectDir);
     }
-    classifyImportError(importError) {
-        const message = importError instanceof Error ? importError.message : String(importError);
-        const bundleMatch = message.match(MISSING_HTTP_BUNDLE_PATTERN);
-        if (bundleMatch?.[1]) {
-            return { type: "http-bundle-missing", hash: bundleMatch[1], message };
-        }
-        if (message.includes("Cannot find module") || message.includes("Module not found")) {
-            return { type: "module-not-found", message };
-        }
-        return { type: "unknown", message };
-    }
-    createTransformCapacityError(mode, message, filePath) {
-        if (mode === "plain")
-            return new Error(message);
-        return toError(createError({
-            type: "build",
-            message,
-            context: { file: filePath, phase: "transform" },
-        }));
-    }
     async withTransformCapacity(filePath, mode, operation) {
         const useSemaphore = getMaxConcurrentTransforms() > 0;
         const projectId = this.options.projectId;
         const semaphore = useSemaphore ? getTransformSemaphore() : undefined;
         let semaphoreAcquired = false;
         if (!await tryAcquireTransformSlot(projectId, TRANSFORM_ACQUIRE_TIMEOUT_MS)) {
-            throw this.createTransformCapacityError(mode, `Project ${projectId} at transform capacity. Consider reducing page complexity or request rate.`, filePath);
+            throw createTransformCapacityError(mode, `Project ${projectId} at transform capacity. Consider reducing page complexity or request rate.`, filePath);
         }
         try {
             if (semaphore) {
                 semaphoreAcquired = await semaphore.tryAcquire(TRANSFORM_ACQUIRE_TIMEOUT_MS);
                 if (!semaphoreAcquired) {
-                    throw this.createTransformCapacityError(mode, `Transform capacity exceeded (${semaphore.waiting} waiting). Service is overloaded.`, filePath);
+                    throw createTransformCapacityError(mode, `Transform capacity exceeded (${semaphore.waiting} waiting). Service is overloaded.`, filePath);
                 }
             }
             return await operation();
@@ -115,7 +95,7 @@ export class SSRModuleLoader {
             return (await withSpan(SpanNames.SSR_DYNAMIC_IMPORT, () => import(`file://${cacheEntry.tempPath}?v=${cacheEntry.contentHash}`), { "ssr.file": fileName }));
         }
         catch (importError) {
-            const classifiedError = this.classifyImportError(importError);
+            const classifiedError = classifyImportError(importError);
             if (classifiedError.type === "http-bundle-missing") {
                 const hash = classifiedError.hash;
                 const cacheDir = getHttpBundleCacheDir();

package/esm/src/platform/adapters/fs/veryfront/adapter-helpers.d.ts

@@ -0,0 +1,19 @@
+import type { VeryfrontAPIConfig } from "../../veryfront-api-client/types.js";
+import type { FileCacheOptions } from "../cache/types.js";
+import type { ContentSource, FSAdapterConfig } from "./types.js";
+export declare const DEFAULT_MAX_RETRIES = 3;
+export declare const DEFAULT_INITIAL_RETRY_DELAY_MS = 1000;
+export declare const DEFAULT_MAX_RETRY_DELAY_MS = 10000;
+export declare const DEFAULT_CACHE_TTL_MS = 60000;
+export declare const DEFAULT_CACHE_MAX_ENTRIES = 1000;
+export declare const DEFAULT_CACHE_MAX_MEMORY_BYTES: number;
+type VeryfrontConfigOverrides = NonNullable<FSAdapterConfig["veryfront"]>;
+type RetryOverrides = VeryfrontConfigOverrides["retry"];
+type CacheOverrides = VeryfrontConfigOverrides["cache"];
+export declare function buildRetryConfig(retry?: RetryOverrides): NonNullable<VeryfrontAPIConfig["retry"]>;
+export declare function buildFileCacheOptions(cache?: CacheOverrides): FileCacheOptions;
+export declare function shouldBackgroundPregenerateStyles(contentContext: {
+    sourceType: ContentSource["type"];
+} | null): boolean;
+export {};
+//# sourceMappingURL=adapter-helpers.d.ts.map

package/esm/src/platform/adapters/fs/veryfront/adapter-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/adapter-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,8BAA8B,OAAQ,CAAC;AACpD,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAC3C,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAC/C,eAAO,MAAM,8BAA8B,QAAoB,CAAC;AAEhE,KAAK,wBAAwB,GAAG,WAAW,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;AAC1E,KAAK,cAAc,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;AACxD,KAAK,cAAc,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAExD,wBAAgB,gBAAgB,CAC9B,KAAK,CAAC,EAAE,cAAc,GACrB,WAAW,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAO1C;AAED,wBAAgB,qBAAqB,CACnC,KAAK,CAAC,EAAE,cAAc,GACrB,gBAAgB,CAQlB;AAED,wBAAgB,iCAAiC,CAC/C,cAAc,EAAE;IAAE,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,GAC3D,OAAO,CAET"}

package/esm/src/platform/adapters/fs/veryfront/adapter-helpers.js

@@ -0,0 +1,26 @@
+export const DEFAULT_MAX_RETRIES = 3;
+export const DEFAULT_INITIAL_RETRY_DELAY_MS = 1_000;
+export const DEFAULT_MAX_RETRY_DELAY_MS = 10_000;
+export const DEFAULT_CACHE_TTL_MS = 60_000;
+export const DEFAULT_CACHE_MAX_ENTRIES = 1_000;
+export const DEFAULT_CACHE_MAX_MEMORY_BYTES = 100 * 1024 * 1024;
+export function buildRetryConfig(retry) {
+    return {
+        maxRetries: DEFAULT_MAX_RETRIES,
+        initialDelay: DEFAULT_INITIAL_RETRY_DELAY_MS,
+        maxDelay: DEFAULT_MAX_RETRY_DELAY_MS,
+        ...retry,
+    };
+}
+export function buildFileCacheOptions(cache) {
+    return {
+        enabled: true,
+        ttl: DEFAULT_CACHE_TTL_MS,
+        maxSize: DEFAULT_CACHE_MAX_ENTRIES,
+        maxMemory: DEFAULT_CACHE_MAX_MEMORY_BYTES,
+        ...cache,
+    };
+}
+export function shouldBackgroundPregenerateStyles(contentContext) {
+    return contentContext?.sourceType !== "branch";
+}

package/esm/src/platform/adapters/fs/veryfront/adapter.d.ts.map

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

package/esm/src/platform/adapters/fs/veryfront/adapter.js

@@ -10,13 +10,8 @@ import { buildFileCacheKeyPrefix, buildFileListCacheKey } from "./cache-keys.js"
 import { isPrefixBeingInvalidated } from "./invalidation-state.js";
 import { WebSocketManager } from "./websocket-manager.js";
 import { fetchFileListForContext, hasContentContextChanged, resolveContentContext, summarizeFileList, toClientContext, } from "./adapter-content-context.js";
+import { buildFileCacheOptions, buildRetryConfig, shouldBackgroundPregenerateStyles, } from "./adapter-helpers.js";
 const logger = baseLogger.component("veryfront-fs-adapter");
-const DEFAULT_MAX_RETRIES = 3;
-const DEFAULT_INITIAL_RETRY_DELAY_MS = 1_000;
-const DEFAULT_MAX_RETRY_DELAY_MS = 10_000;
-const DEFAULT_CACHE_TTL_MS = 60_000;
-const DEFAULT_CACHE_MAX_ENTRIES = 1_000;
-const DEFAULT_CACHE_MAX_MEMORY_BYTES = 100 * 1024 * 1024;
 export class VeryfrontFSAdapter {
     client;
     cache;
@@ -85,12 +80,7 @@ export class VeryfrontFSAdapter {
         this.projectSlug = vf.projectSlug ?? "";
         this.contentSource = vf.contentSource ?? { type: "branch", branch: "main" };
         this.proxyMode = vf.proxyMode ?? false;
-        const retryConfig = {
-            maxRetries: DEFAULT_MAX_RETRIES,
-            initialDelay: DEFAULT_INITIAL_RETRY_DELAY_MS,
-            maxDelay: DEFAULT_MAX_RETRY_DELAY_MS,
-            ...vf.retry,
-        };
+        const retryConfig = buildRetryConfig(vf.retry);
         this.client = new VeryfrontApiClient({
             apiBaseUrl: this.apiBaseUrl,
             apiToken: this.apiToken,
@@ -99,13 +89,7 @@ export class VeryfrontFSAdapter {
             proxyMode: vf.proxyMode,
             retry: retryConfig,
         });
-        const cacheConfig = {
-            enabled: true,
-            ttl: DEFAULT_CACHE_TTL_MS,
-            maxSize: DEFAULT_CACHE_MAX_ENTRIES,
-            maxMemory: DEFAULT_CACHE_MAX_MEMORY_BYTES,
-            ...vf.cache,
-        };
+        const cacheConfig = buildFileCacheOptions(vf.cache);
         this.cache = new FileCache(cacheConfig);
         this.normalizer = new PathNormalizer(config.projectDir);
         const contentContextGetter = {
@@ -283,7 +267,7 @@ export class VeryfrontFSAdapter {
         // Branch previews should recover the last registered stylesheet artifact on
         // cold starts before rebuilding CSS locally. Live edit pokes still
         // pregenerate through the WebSocket path after branch content changes.
-        return this.contentContext?.sourceType !== "branch";
+        return shouldBackgroundPregenerateStyles(this.contentContext);
     }
     scheduleFileListWarmup(reason, cacheKey) {
         if (!this.initialized || !this.contentContext)

package/esm/src/platform/adapters/fs/veryfront/read-operations-helpers.d.ts

@@ -31,6 +31,7 @@ interface BuildReadFetchStateOptions {
 export declare function assertProjectSourcePath(normalizedPath: string): void;
 export declare function buildReadFetchState(options: BuildReadFetchStateOptions): ReadFetchState;
 export declare function getResolvedCacheKey(cacheKeyPrefix: string, normalizedResolvedPath: string): string;
+export declare function buildContentPreview(content: string, max?: number): string;
 export declare function buildExtensionCandidatePaths(basePath: string): string[];
 export declare function splitKnownFileExtension(apiPath: string): {
     originalExtension: string;

package/esm/src/platform/adapters/fs/veryfront/read-operations-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-operations-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/read-operations-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,iCAAiC,EAAE,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,UAAU,uBAAuB;IAC/B,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,4BAA4B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3D,yBAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,UAAU,0BAA0B;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C;AAED,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAOpE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,cAAc,CA2BvF;AAED,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,sBAAsB,EAAE,MAAM,GAC7B,MAAM,CAER;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvE;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GACd;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASxD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG3D;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAEvE"}
+{"version":3,"file":"read-operations-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/read-operations-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,iCAAiC,EAAE,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,UAAU,uBAAuB;IAC/B,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,4BAA4B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3D,yBAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,UAAU,0BAA0B;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C;AAED,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAOpE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,cAAc,CA2BvF;AAED,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,sBAAsB,EAAE,MAAM,GAC7B,MAAM,CAER;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,MAAM,CAErE;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvE;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GACd;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASxD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG3D;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAEvE"}

package/esm/src/platform/adapters/fs/veryfront/read-operations-helpers.js

@@ -40,6 +40,9 @@ export function buildReadFetchState(options) {
 export function getResolvedCacheKey(cacheKeyPrefix, normalizedResolvedPath) {
     return `${cacheKeyPrefix}:${normalizedResolvedPath}`;
 }
+export function buildContentPreview(content, max = 80) {
+    return content.length > max ? `${content.slice(0, max)}...` : content;
+}
 export function buildExtensionCandidatePaths(basePath) {
     return READ_OPERATION_EXTENSION_PRIORITY.map((ext) => `${basePath}${ext}`);
 }