@veryfront/ext-content-mdx 0.1.985

package/esm/src/utils/constants/network.js

@@ -0,0 +1,27 @@
+export const DEFAULT_DEV_SERVER_PORT = 3000;
+export const DEFAULT_REDIS_PORT = 6379;
+export const DEFAULT_API_SERVER_PORT = 8080;
+export const DEFAULT_PREVIEW_SERVER_PORT = 5000;
+export const DEFAULT_METRICS_PORT = 9000;
+/** Shared bytes per kb value. */
+export const BYTES_PER_KB = 1024;
+export const BYTES_PER_MB = BYTES_PER_KB * BYTES_PER_KB;
+export const DEFAULT_IMAGE_THUMBNAIL_SIZE = 256;
+export const DEFAULT_IMAGE_SMALL_SIZE = 512;
+export const DEFAULT_IMAGE_LARGE_SIZE = 2048;
+export const RESPONSIVE_IMAGE_WIDTH_XS = 320;
+export const RESPONSIVE_IMAGE_WIDTH_SM = 640;
+export const RESPONSIVE_IMAGE_WIDTH_MD = 1024;
+/** Shared responsive image width lg value. */
+export const RESPONSIVE_IMAGE_WIDTH_LG = 1920;
+/** Shared responsive image widths value. */
+export const RESPONSIVE_IMAGE_WIDTHS = [
+    RESPONSIVE_IMAGE_WIDTH_XS,
+    RESPONSIVE_IMAGE_WIDTH_SM,
+    RESPONSIVE_IMAGE_WIDTH_MD,
+    RESPONSIVE_IMAGE_WIDTH_LG,
+];
+export const MAX_CHUNK_SIZE_KB = 4096;
+export const MIN_PORT = 1;
+export const MAX_PORT = 65535;
+export const DEFAULT_SERVER_PORT = 8000;

package/esm/src/utils/constants/priorities.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Handler priority constants - lower numbers run first.
+ * CRITICAL(0) -> VERY_HIGH(50) -> HIGH(100-300) -> MEDIUM(400-700) -> LOW(1000) -> FALLBACK(10000)
+ */
+export declare const PRIORITY_CRITICAL = 0;
+export declare const PRIORITY_VERY_HIGH = 50;
+export declare const PRIORITY_HIGH = 100;
+export declare const PRIORITY_HIGH_CLIENT_LOG = 200;
+export declare const PRIORITY_HIGH_DEV = 300;
+export declare const PRIORITY_MEDIUM_DEV_FILES = 400;
+export declare const PRIORITY_MEDIUM_STATIC = 500;
+export declare const PRIORITY_MEDIUM_LIB_MODULES = 550;
+export declare const PRIORITY_MEDIUM = 600;
+export declare const PRIORITY_MEDIUM_API = 700;
+export declare const PRIORITY_LOW = 1000;
+export declare const PRIORITY_FALLBACK = 10000;
+export declare const HANDLER_PRIORITIES: {
+    readonly CRITICAL: 0;
+    readonly VERY_HIGH: 50;
+    readonly HIGH: 100;
+    readonly HIGH_CLIENT_LOG: 200;
+    readonly HIGH_DEV: 300;
+    readonly MEDIUM_DEV_FILES: 400;
+    readonly MEDIUM_STATIC: 500;
+    readonly MEDIUM_LIB_MODULES: 550;
+    readonly MEDIUM: 600;
+    readonly MEDIUM_API: 700;
+    readonly LOW: 1000;
+    readonly FALLBACK: 10000;
+};
+//# sourceMappingURL=priorities.d.ts.map

package/esm/src/utils/constants/priorities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priorities.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/constants/priorities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,YAAY,OAAO,CAAC;AACjC,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;CAarB,CAAC"}

package/esm/src/utils/constants/priorities.js

@@ -0,0 +1,30 @@
+/**
+ * Handler priority constants - lower numbers run first.
+ * CRITICAL(0) -> VERY_HIGH(50) -> HIGH(100-300) -> MEDIUM(400-700) -> LOW(1000) -> FALLBACK(10000)
+ */
+export const PRIORITY_CRITICAL = 0;
+export const PRIORITY_VERY_HIGH = 50;
+export const PRIORITY_HIGH = 100;
+export const PRIORITY_HIGH_CLIENT_LOG = 200;
+export const PRIORITY_HIGH_DEV = 300;
+export const PRIORITY_MEDIUM_DEV_FILES = 400;
+export const PRIORITY_MEDIUM_STATIC = 500;
+export const PRIORITY_MEDIUM_LIB_MODULES = 550;
+export const PRIORITY_MEDIUM = 600;
+export const PRIORITY_MEDIUM_API = 700;
+export const PRIORITY_LOW = 1000;
+export const PRIORITY_FALLBACK = 10000;
+export const HANDLER_PRIORITIES = {
+    CRITICAL: PRIORITY_CRITICAL,
+    VERY_HIGH: PRIORITY_VERY_HIGH,
+    HIGH: PRIORITY_HIGH,
+    HIGH_CLIENT_LOG: PRIORITY_HIGH_CLIENT_LOG,
+    HIGH_DEV: PRIORITY_HIGH_DEV,
+    MEDIUM_DEV_FILES: PRIORITY_MEDIUM_DEV_FILES,
+    MEDIUM_STATIC: PRIORITY_MEDIUM_STATIC,
+    MEDIUM_LIB_MODULES: PRIORITY_MEDIUM_LIB_MODULES,
+    MEDIUM: PRIORITY_MEDIUM,
+    MEDIUM_API: PRIORITY_MEDIUM_API,
+    LOW: PRIORITY_LOW,
+    FALLBACK: PRIORITY_FALLBACK,
+};

package/esm/src/utils/constants/retry.d.ts

@@ -0,0 +1,14 @@
+export declare const DEFAULT_RETRY_MAX_ATTEMPTS = 3;
+export declare const DEFAULT_RETRY_INITIAL_DELAY_MS = 100;
+export declare const DEFAULT_RETRY_MAX_DELAY_MS = 5000;
+export declare const DEFAULT_RETRY_BACKOFF_MULTIPLIER = 2;
+export declare const API_RETRY_MAX_ATTEMPTS = 3;
+export declare const API_RETRY_INITIAL_DELAY_MS = 1000;
+export declare const API_RETRY_MAX_DELAY_MS = 10000;
+export declare const FS_RETRY_MAX_ATTEMPTS = 3;
+export declare const FS_RETRY_INITIAL_DELAY_MS = 1000;
+export declare const FS_RETRY_MAX_DELAY_MS = 10000;
+export declare const WS_RECONNECT_MAX_ATTEMPTS = 5;
+export declare const WS_RECONNECT_INITIAL_DELAY_MS = 1000;
+export declare const WS_RECONNECT_MAX_DELAY_MS = 30000;
+//# sourceMappingURL=retry.d.ts.map

package/esm/src/utils/constants/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/constants/retry.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAC/C,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAC/C,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAE5C,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAC9C,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAClD,eAAO,MAAM,yBAAyB,QAAQ,CAAC"}

package/esm/src/utils/constants/retry.js

@@ -0,0 +1,13 @@
+export const DEFAULT_RETRY_MAX_ATTEMPTS = 3;
+export const DEFAULT_RETRY_INITIAL_DELAY_MS = 100;
+export const DEFAULT_RETRY_MAX_DELAY_MS = 5000;
+export const DEFAULT_RETRY_BACKOFF_MULTIPLIER = 2;
+export const API_RETRY_MAX_ATTEMPTS = 3;
+export const API_RETRY_INITIAL_DELAY_MS = 1000;
+export const API_RETRY_MAX_DELAY_MS = 10000;
+export const FS_RETRY_MAX_ATTEMPTS = 3;
+export const FS_RETRY_INITIAL_DELAY_MS = 1000;
+export const FS_RETRY_MAX_DELAY_MS = 10000;
+export const WS_RECONNECT_MAX_ATTEMPTS = 5;
+export const WS_RECONNECT_INITIAL_DELAY_MS = 1000;
+export const WS_RECONNECT_MAX_DELAY_MS = 30000;

package/esm/src/utils/constants/security.d.ts

@@ -0,0 +1,16 @@
+/** Maximum value for path traversal depth. */
+export declare const MAX_PATH_TRAVERSAL_DEPTH = 10;
+/** Shared forbidden path patterns value. */
+export declare const FORBIDDEN_PATH_PATTERNS: RegExp[];
+/**
+ * Fast-match pattern for common vulnerability scanner probe paths.
+ * Keep this scoped to root-level probe paths so valid nested application
+ * routes are not accidentally blocked.
+ */
+export declare const SCANNER_PATH_PATTERN: RegExp;
+export declare const DIRECTORY_TRAVERSAL_PATTERN: RegExp;
+export declare const ABSOLUTE_PATH_PATTERN: RegExp;
+/** Maximum value for path length. */
+export declare const MAX_PATH_LENGTH = 4096;
+export declare const DEFAULT_MAX_STRING_LENGTH = 1000;
+//# sourceMappingURL=security.d.ts.map

package/esm/src/utils/constants/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/constants/security.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,4CAA4C;AAC5C,eAAO,MAAM,uBAAuB,UAAS,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QACkG,CAAC;AACpI,eAAO,MAAM,2BAA2B,QAAe,CAAC;AACxD,eAAO,MAAM,qBAAqB,QAAY,CAAC;AAC/C,qCAAqC;AACrC,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,yBAAyB,OAAO,CAAC"}

package/esm/src/utils/constants/security.js

@@ -0,0 +1,15 @@
+/** Maximum value for path traversal depth. */
+export const MAX_PATH_TRAVERSAL_DEPTH = 10;
+/** Shared forbidden path patterns value. */
+export const FORBIDDEN_PATH_PATTERNS = [/\0/];
+/**
+ * Fast-match pattern for common vulnerability scanner probe paths.
+ * Keep this scoped to root-level probe paths so valid nested application
+ * routes are not accidentally blocked.
+ */
+export const SCANNER_PATH_PATTERN = /^\/(?:wp-(?:admin|login\.php|includes|content|config\.php)(?:\/|$)|cgi-bin(?:\/|$)|xmlrpc\.php$|\.git(?:\/|$)|\.env(?:\..*)?$)/i;
+export const DIRECTORY_TRAVERSAL_PATTERN = /\.\.[\/\\]/;
+export const ABSOLUTE_PATH_PATTERN = /^[\/\\]/;
+/** Maximum value for path length. */
+export const MAX_PATH_LENGTH = 4096;
+export const DEFAULT_MAX_STRING_LENGTH = 1000;

package/esm/src/utils/constants/server.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Centralized server endpoints and paths registry
+ *
+ * All internal veryfront URLs should be defined here as the single source of truth.
+ * This prevents hardcoding URLs across the codebase and makes refactoring easier.
+ */
+export { DEFAULT_PORT } from "../../config/defaults.js";
+/** Default port for development dashboard (matches veryfront.config.ts default) */
+export declare const DEFAULT_DASHBOARD_PORT = 3001;
+/** Internal URL prefix for all veryfront endpoints */
+export declare const INTERNAL_PREFIX = "/_veryfront";
+/**
+ * All internal veryfront URL path prefixes (directories)
+ */
+export declare const INTERNAL_PATH_PREFIXES: {
+    /** React Server Components endpoints */
+    readonly RSC: "/_veryfront/rsc/";
+    /** File system access endpoints (base64 encoded paths) */
+    readonly FS: "/_veryfront/fs/";
+    /** Virtual module system */
+    readonly MODULES: "/_veryfront/modules/";
+    /** Generated page modules */
+    readonly PAGES: "/_veryfront/pages/";
+    /** Data JSON endpoints */
+    readonly DATA: "/_veryfront/data/";
+    /** Library modules and large vendor surfaces */
+    readonly LIB: "/_veryfront/lib/";
+    /** Chunk assets */
+    readonly CHUNKS: "/_veryfront/chunks/";
+    /** Client component modules */
+    readonly CLIENT: "/_veryfront/client/";
+};
+/**
+ * Specific internal endpoint URLs
+ */
+export declare const INTERNAL_ENDPOINTS: {
+    readonly HMR_RUNTIME: "/_veryfront/hmr-runtime.js";
+    readonly HMR: "/_veryfront/hmr.js";
+    readonly ERROR_OVERLAY: "/_veryfront/error-overlay.js";
+    readonly DEV_LOADER: "/_veryfront/dev-loader.js";
+    readonly CLIENT_LOG: "/_veryfront/log";
+    readonly CLIENT_JS: "/_veryfront/client.js";
+    readonly ROUTER_JS: "/_veryfront/router.js";
+    readonly PREFETCH_JS: "/_veryfront/prefetch.js";
+    readonly MANIFEST_JSON: "/_veryfront/manifest.json";
+    readonly APP_JS: "/_veryfront/app.js";
+    readonly RSC_CLIENT: "/_veryfront/rsc/client.js";
+    readonly RSC_MANIFEST: "/_veryfront/rsc/manifest";
+    readonly RSC_STREAM: "/_veryfront/rsc/stream";
+    readonly RSC_PAYLOAD: "/_veryfront/rsc/payload";
+    readonly RSC_RENDER: "/_veryfront/rsc/render";
+    readonly RSC_PAGE: "/_veryfront/rsc/page";
+    readonly RSC_MODULE: "/_veryfront/rsc/module";
+    readonly RSC_DOM: "/_veryfront/rsc/dom.js";
+    readonly LIB_CHAT_REACT: "/_veryfront/lib/chat/react.js";
+    readonly LIB_CHAT_COMPONENTS: "/_veryfront/lib/chat/components.js";
+    readonly LIB_CHAT_PRIMITIVES: "/_veryfront/lib/chat/primitives.js";
+};
+/**
+ * Build output directory paths (relative)
+ */
+export declare const BUILD_DIRS: {
+    /** Main build output directory */
+    readonly ROOT: "_veryfront";
+    /** Chunks directory */
+    readonly CHUNKS: "_veryfront/chunks";
+    /** Data directory */
+    readonly DATA: "_veryfront/data";
+    /** Assets directory */
+    readonly ASSETS: "_veryfront/assets";
+};
+/**
+ * Local project directory paths (relative to project root)
+ * These are .gitignore'd directories for caching and temporary files
+ */
+export declare const PROJECT_DIRS: {
+    /** Base veryfront internal directory */
+    readonly ROOT: ".veryfront";
+    /** Cache directory for build artifacts, transforms, etc. */
+    readonly CACHE: ".veryfront/cache";
+    /** KV store directory */
+    readonly KV: ".veryfront/kv";
+    /** Log files directory */
+    readonly LOGS: ".veryfront/logs";
+    /** Temporary files directory */
+    readonly TMP: ".veryfront/tmp";
+};
+/** Default cache directory path */
+export declare const DEFAULT_CACHE_DIR: ".veryfront/cache";
+/**
+ * Helper to check if a pathname is an internal veryfront endpoint
+ */
+export declare function isInternalEndpoint(pathname: string): boolean;
+/**
+ * Helper to check if a pathname is a static asset (has extension or is internal)
+ */
+export declare function isStaticAsset(pathname: string): boolean;
+/**
+ * Normalize a chunk path to include the base prefix
+ */
+export declare function normalizeChunkPath(filename: string, basePath?: string): string;
+/** Shared dev server endpoints value. */
+export declare const DEV_SERVER_ENDPOINTS: {
+    readonly HMR_RUNTIME: "/_veryfront/hmr-runtime.js";
+    readonly ERROR_OVERLAY: "/_veryfront/error-overlay.js";
+};
+//# sourceMappingURL=server.d.ts.map

package/esm/src/utils/constants/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/constants/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,sDAAsD;AACtD,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,wCAAwC;;IAExC,0DAA0D;;IAE1D,4BAA4B;;IAE5B,6BAA6B;;IAE7B,0BAA0B;;IAE1B,gDAAgD;;IAEhD,mBAAmB;;IAEnB,+BAA+B;;CAEvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;CA8BrB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB,kCAAkC;;IAElC,uBAAuB;;IAEvB,qBAAqB;;IAErB,uBAAuB;;CAEf,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB,wCAAwC;;IAExC,4DAA4D;;IAE5D,yBAAyB;;IAEzB,0BAA0B;;IAE1B,gCAAgC;;CAExB,CAAC;AAEX,mCAAmC;AACnC,eAAO,MAAM,iBAAiB,oBAAqB,CAAC;AAEpD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAsC,GAC/C,MAAM,CAIR;AAGD,yCAAyC;AACzC,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC"}

package/esm/src/utils/constants/server.js

@@ -0,0 +1,120 @@
+/**
+ * Centralized server endpoints and paths registry
+ *
+ * All internal veryfront URLs should be defined here as the single source of truth.
+ * This prevents hardcoding URLs across the codebase and makes refactoring easier.
+ */
+export { DEFAULT_PORT } from "../../config/defaults.js";
+/** Default port for development dashboard (matches veryfront.config.ts default) */
+export const DEFAULT_DASHBOARD_PORT = 3001;
+/** Internal URL prefix for all veryfront endpoints */
+export const INTERNAL_PREFIX = "/_veryfront";
+/**
+ * All internal veryfront URL path prefixes (directories)
+ */
+export const INTERNAL_PATH_PREFIXES = {
+    /** React Server Components endpoints */
+    RSC: `${INTERNAL_PREFIX}/rsc/`,
+    /** File system access endpoints (base64 encoded paths) */
+    FS: `${INTERNAL_PREFIX}/fs/`,
+    /** Virtual module system */
+    MODULES: `${INTERNAL_PREFIX}/modules/`,
+    /** Generated page modules */
+    PAGES: `${INTERNAL_PREFIX}/pages/`,
+    /** Data JSON endpoints */
+    DATA: `${INTERNAL_PREFIX}/data/`,
+    /** Library modules and large vendor surfaces */
+    LIB: `${INTERNAL_PREFIX}/lib/`,
+    /** Chunk assets */
+    CHUNKS: `${INTERNAL_PREFIX}/chunks/`,
+    /** Client component modules */
+    CLIENT: `${INTERNAL_PREFIX}/client/`,
+};
+/**
+ * Specific internal endpoint URLs
+ */
+export const INTERNAL_ENDPOINTS = {
+    // Development endpoints
+    HMR_RUNTIME: `${INTERNAL_PREFIX}/hmr-runtime.js`,
+    HMR: `${INTERNAL_PREFIX}/hmr.js`,
+    ERROR_OVERLAY: `${INTERNAL_PREFIX}/error-overlay.js`,
+    // Legacy endpoint retained for backward compatibility (no active handler).
+    DEV_LOADER: `${INTERNAL_PREFIX}/dev-loader.js`,
+    CLIENT_LOG: `${INTERNAL_PREFIX}/log`,
+    // Production endpoints
+    CLIENT_JS: `${INTERNAL_PREFIX}/client.js`,
+    ROUTER_JS: `${INTERNAL_PREFIX}/router.js`,
+    PREFETCH_JS: `${INTERNAL_PREFIX}/prefetch.js`,
+    MANIFEST_JSON: `${INTERNAL_PREFIX}/manifest.json`,
+    APP_JS: `${INTERNAL_PREFIX}/app.js`,
+    // RSC endpoints
+    RSC_CLIENT: `${INTERNAL_PREFIX}/rsc/client.js`,
+    RSC_MANIFEST: `${INTERNAL_PREFIX}/rsc/manifest`,
+    RSC_STREAM: `${INTERNAL_PREFIX}/rsc/stream`,
+    RSC_PAYLOAD: `${INTERNAL_PREFIX}/rsc/payload`,
+    RSC_RENDER: `${INTERNAL_PREFIX}/rsc/render`,
+    RSC_PAGE: `${INTERNAL_PREFIX}/rsc/page`,
+    RSC_MODULE: `${INTERNAL_PREFIX}/rsc/module`,
+    RSC_DOM: `${INTERNAL_PREFIX}/rsc/dom.js`,
+    // Library module endpoints
+    LIB_CHAT_REACT: `${INTERNAL_PREFIX}/lib/chat/react.js`,
+    LIB_CHAT_COMPONENTS: `${INTERNAL_PREFIX}/lib/chat/components.js`,
+    LIB_CHAT_PRIMITIVES: `${INTERNAL_PREFIX}/lib/chat/primitives.js`,
+};
+/**
+ * Build output directory paths (relative)
+ */
+export const BUILD_DIRS = {
+    /** Main build output directory */
+    ROOT: "_veryfront",
+    /** Chunks directory */
+    CHUNKS: "_veryfront/chunks",
+    /** Data directory */
+    DATA: "_veryfront/data",
+    /** Assets directory */
+    ASSETS: "_veryfront/assets",
+};
+/**
+ * Local project directory paths (relative to project root)
+ * These are .gitignore'd directories for caching and temporary files
+ */
+export const PROJECT_DIRS = {
+    /** Base veryfront internal directory */
+    ROOT: ".veryfront",
+    /** Cache directory for build artifacts, transforms, etc. */
+    CACHE: ".veryfront/cache",
+    /** KV store directory */
+    KV: ".veryfront/kv",
+    /** Log files directory */
+    LOGS: ".veryfront/logs",
+    /** Temporary files directory */
+    TMP: ".veryfront/tmp",
+};
+/** Default cache directory path */
+export const DEFAULT_CACHE_DIR = PROJECT_DIRS.CACHE;
+/**
+ * Helper to check if a pathname is an internal veryfront endpoint
+ */
+export function isInternalEndpoint(pathname) {
+    return pathname.startsWith(`${INTERNAL_PREFIX}/`);
+}
+/**
+ * Helper to check if a pathname is a static asset (has extension or is internal)
+ */
+export function isStaticAsset(pathname) {
+    return pathname.includes(".") || isInternalEndpoint(pathname);
+}
+/**
+ * Normalize a chunk path to include the base prefix
+ */
+export function normalizeChunkPath(filename, basePath = INTERNAL_PATH_PREFIXES.CHUNKS) {
+    if (filename.startsWith("/"))
+        return filename;
+    return `${basePath.replace(/\/$/, "")}/${filename}`;
+}
+// Re-export for backward compatibility
+/** Shared dev server endpoints value. */
+export const DEV_SERVER_ENDPOINTS = {
+    HMR_RUNTIME: INTERNAL_ENDPOINTS.HMR_RUNTIME,
+    ERROR_OVERLAY: INTERNAL_ENDPOINTS.ERROR_OVERLAY,
+};

package/esm/src/utils/feature-flags.d.ts

@@ -0,0 +1,7 @@
+/** Check whether RSC is enabled. */
+export declare function isRSCEnabled(config?: {
+    experimental?: {
+        rsc?: boolean;
+    };
+}): boolean;
+//# sourceMappingURL=feature-flags.d.ts.map

package/esm/src/utils/feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../src/src/utils/feature-flags.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,wBAAgB,YAAY,CAC1B,MAAM,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAC5C,OAAO,CAKT"}

package/esm/src/utils/feature-flags.js

@@ -0,0 +1,8 @@
+import { getEnv } from "../platform/compat/process.js";
+/** Check whether RSC is enabled. */
+export function isRSCEnabled(config) {
+    const rsc = config?.experimental?.rsc;
+    if (rsc != null)
+        return rsc;
+    return getEnv("VERYFRONT_EXPERIMENTAL_RSC") === "1";
+}

package/esm/src/utils/hash-utils.d.ts

@@ -0,0 +1,19 @@
+/** Compute hash. */
+export declare function computeHash(content: string): Promise<string>;
+/** Source bundle content used for hash computation. */
+export interface BundleCode {
+    code: string;
+    css?: string;
+    sourceMap?: string;
+}
+/** Compute code hash. */
+export declare function computeCodeHash(code: BundleCode): Promise<string>;
+/** Create simple hash. */
+export declare function simpleHash(str: string): number;
+/** Hash string to hex (base 16) - used for module filenames */
+export declare function hashCodeHex(str: string): string;
+/** Create short hash. */
+export declare function shortHash(content: string): Promise<string>;
+/** FNV-1a hash for strings - returns hex string */
+export declare function fnv1aHash(input: string): string;
+//# sourceMappingURL=hash-utils.d.ts.map

package/esm/src/utils/hash-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/hash-utils.ts"],"names":[],"mappings":"AAOA,oBAAoB;AACpB,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKlE;AACD,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,yBAAyB;AACzB,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAEjE;AAED,0BAA0B;AAC1B,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS9C;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,yBAAyB;AACzB,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhE;AAED,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS/C"}

package/esm/src/utils/hash-utils.js

@@ -0,0 +1,42 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { FNV1A_PRIME_32 } from "./constants/crypto.js";
+import { HASH_SEED_FNV1A } from "./constants/hash.js";
+/** Number of hex characters kept by shortHash (8 hex chars = 32 bits) */
+const SHORT_HASH_LENGTH = 8;
+/** Compute hash. */
+export async function computeHash(content) {
+    const data = new TextEncoder().encode(content);
+    const hashBuffer = await dntShim.crypto.subtle.digest("SHA-256", data);
+    return Array.from(new Uint8Array(hashBuffer), (b) => b.toString(16).padStart(2, "0")).join("");
+}
+/** Compute code hash. */
+export function computeCodeHash(code) {
+    return computeHash(`${code.code}${code.css ?? ""}${code.sourceMap ?? ""}`);
+}
+/** Create simple hash. */
+export function simpleHash(str) {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        hash = (hash << 5) - hash + str.charCodeAt(i);
+        hash &= hash;
+    }
+    return Math.abs(hash);
+}
+/** Hash string to hex (base 16) - used for module filenames */
+export function hashCodeHex(str) {
+    return simpleHash(str).toString(16);
+}
+/** Create short hash. */
+export async function shortHash(content) {
+    const fullHash = await computeHash(content);
+    return fullHash.slice(0, SHORT_HASH_LENGTH);
+}
+/** FNV-1a hash for strings - returns hex string */
+export function fnv1aHash(input) {
+    let hash = HASH_SEED_FNV1A >>> 0;
+    for (const char of input) {
+        hash ^= char.charCodeAt(0);
+        hash = Math.imul(hash, FNV1A_PRIME_32);
+    }
+    return (hash >>> 0).toString(16);
+}

package/esm/src/utils/import-lockfile.d.ts

@@ -0,0 +1,52 @@
+export interface LockfileEntry {
+    resolved: string;
+    integrity: string;
+    dependencies?: string[];
+    fetchedAt?: string;
+}
+export interface LockfileData {
+    version: 1;
+    imports: Record<string, LockfileEntry>;
+}
+export declare function createEmptyLockfile(): LockfileData;
+/** Compute integrity. */
+export declare function computeIntegrity(content: string): Promise<string>;
+export declare function verifyIntegrity(content: string, integrity: string): Promise<boolean>;
+/** Public API contract for lockfile manager. */
+export interface LockfileManager {
+    read(): Promise<LockfileData | null>;
+    write(data: LockfileData): Promise<void>;
+    get(url: string): Promise<LockfileEntry | null>;
+    set(url: string, entry: LockfileEntry): Promise<void>;
+    has(url: string): Promise<boolean>;
+    clear(): Promise<void>;
+    flush(): Promise<void>;
+}
+export type FSAdapter = {
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    remove?(path: string): Promise<void>;
+};
+/** Create lockfile manager. */
+export declare function createLockfileManager(projectDir: string, fsAdapter?: FSAdapter): LockfileManager;
+export interface FetchWithLockOptions {
+    lockfile: LockfileManager;
+    url: string;
+    fetchFn?: typeof fetch;
+    strict?: boolean;
+}
+export interface FetchWithLockResult {
+    content: string;
+    resolvedUrl: string;
+    fromCache: boolean;
+    integrity: string;
+}
+export declare function fetchWithLock(options: FetchWithLockOptions): Promise<FetchWithLockResult>;
+export interface ParsedImport {
+    specifier: string;
+    type: "static" | "dynamic";
+}
+export declare function extractImports(content: string): ParsedImport[];
+export declare function resolveImportUrl(specifier: string, baseUrl: string): string | null;
+//# sourceMappingURL=import-lockfile.d.ts.map

package/esm/src/utils/import-lockfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-lockfile.d.ts","sourceRoot":"","sources":["../../../src/src/utils/import-lockfile.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACxC;AAKD,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,yBAAyB;AACzB,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGvE;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG1F;AAED,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAChD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC,CAAC;AAqBF,+BAA+B;AAC/B,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,eAAe,CAkFhG;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,eAAe,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA2D/F;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC5B;AAMD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAmB9D;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUlF"}