@veryfront/ext-content-mdx 0.1.1119 → 0.1.1122

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

@@ -0,0 +1,120 @@
+import { type ErrorCategory } from "./types.js";
+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 "./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";
+/**
+ * Central registry mapping every error slug to its definition. Assembled from
+ * the per-category registry fragments.
+ */
+export declare const ERROR_REGISTRY: {
+    readonly "unknown-error": import("./types.js").RegisteredError;
+    readonly "permission-denied": import("./types.js").RegisteredError;
+    readonly "file-not-found": import("./types.js").RegisteredError;
+    readonly "resource-not-found": import("./types.js").RegisteredError;
+    readonly "invalid-argument": import("./types.js").RegisteredError;
+    readonly "timeout-error": import("./types.js").RegisteredError;
+    readonly "initialization-error": import("./types.js").RegisteredError;
+    readonly "not-supported": import("./types.js").RegisteredError;
+    readonly "security-violation": import("./types.js").RegisteredError;
+    readonly "input-validation-failed": import("./types.js").RegisteredError;
+    readonly "agent-error": import("./types.js").RegisteredError;
+    readonly "agent-not-found": import("./types.js").RegisteredError;
+    readonly "agent-timeout": import("./types.js").RegisteredError;
+    readonly "agent-intent-error": import("./types.js").RegisteredError;
+    readonly "orchestration-error": import("./types.js").RegisteredError;
+    readonly "cost-limit-exceeded": import("./types.js").RegisteredError;
+    readonly "tool-id-conflict": import("./types.js").RegisteredError;
+    readonly "deployment-error": import("./types.js").RegisteredError;
+    readonly "platform-error": import("./types.js").RegisteredError;
+    readonly "env-var-missing": import("./types.js").RegisteredError;
+    readonly "production-build-required": import("./types.js").RegisteredError;
+    readonly "hmr-error": import("./types.js").RegisteredError;
+    readonly "dev-server-error": import("./types.js").RegisteredError;
+    readonly "fast-refresh-error": import("./types.js").RegisteredError;
+    readonly "error-overlay-error": import("./types.js").RegisteredError;
+    readonly "source-map-error": import("./types.js").RegisteredError;
+    readonly "client-boundary-violation": import("./types.js").RegisteredError;
+    readonly "server-only-in-client": import("./types.js").RegisteredError;
+    readonly "client-only-in-server": import("./types.js").RegisteredError;
+    readonly "invalid-use-client": import("./types.js").RegisteredError;
+    readonly "invalid-use-server": import("./types.js").RegisteredError;
+    readonly "rsc-payload-error": import("./types.js").RegisteredError;
+    readonly "port-in-use": import("./types.js").RegisteredError;
+    readonly "server-start-error": import("./types.js").RegisteredError;
+    readonly "cache-error": import("./types.js").RegisteredError;
+    readonly "file-watch-error": import("./types.js").RegisteredError;
+    readonly "request-error": import("./types.js").RegisteredError;
+    readonly "service-overloaded": import("./types.js").RegisteredError;
+    readonly "semaphore-timeout": import("./types.js").RegisteredError;
+    readonly "circuit-breaker-open": import("./types.js").RegisteredError;
+    readonly "cache-path-mismatch": import("./types.js").RegisteredError;
+    readonly "network-error": import("./types.js").RegisteredError;
+    readonly "api-client-error": import("./types.js").RegisteredError;
+    readonly "token-storage-error": import("./types.js").RegisteredError;
+    readonly "cache-invariant-violation": import("./types.js").RegisteredError;
+    readonly "release-not-found": import("./types.js").RegisteredError;
+    readonly "fallback-exhausted": import("./types.js").RegisteredError;
+    readonly "module-not-found": import("./types.js").RegisteredError;
+    readonly "import-resolution-error": import("./types.js").RegisteredError;
+    readonly "circular-dependency": import("./types.js").RegisteredError;
+    readonly "invalid-import": import("./types.js").RegisteredError;
+    readonly "dependency-missing": import("./types.js").RegisteredError;
+    readonly "version-mismatch": import("./types.js").RegisteredError;
+    readonly "route-conflict": import("./types.js").RegisteredError;
+    readonly "invalid-route-file": import("./types.js").RegisteredError;
+    readonly "route-handler-invalid": import("./types.js").RegisteredError;
+    readonly "dynamic-route-error": import("./types.js").RegisteredError;
+    readonly "route-params-error": import("./types.js").RegisteredError;
+    readonly "api-route-error": import("./types.js").RegisteredError;
+    readonly "hydration-mismatch": import("./types.js").RegisteredError;
+    readonly "render-error": import("./types.js").RegisteredError;
+    readonly "component-error": import("./types.js").RegisteredError;
+    readonly "layout-not-found": import("./types.js").RegisteredError;
+    readonly "page-not-found": import("./types.js").RegisteredError;
+    readonly "api-error": import("./types.js").RegisteredError;
+    readonly "middleware-error": import("./types.js").RegisteredError;
+    readonly "trigger-target-not-found": import("./types.js").RegisteredError;
+    readonly "trigger-execution-failed": import("./types.js").RegisteredError;
+    readonly "trigger-not-supported": import("./types.js").RegisteredError;
+    readonly "build-failed": import("./types.js").RegisteredError;
+    readonly "bundle-error": import("./types.js").RegisteredError;
+    readonly "typescript-error": import("./types.js").RegisteredError;
+    readonly "mdx-compile-error": import("./types.js").RegisteredError;
+    readonly "asset-optimization-error": import("./types.js").RegisteredError;
+    readonly "ssg-generation-error": import("./types.js").RegisteredError;
+    readonly "sourcemap-error": import("./types.js").RegisteredError;
+    readonly "compilation-error": import("./types.js").RegisteredError;
+    readonly "config-not-found": import("./types.js").RegisteredError;
+    readonly "config-invalid": import("./types.js").RegisteredError;
+    readonly "config-parse-error": import("./types.js").RegisteredError;
+    readonly "config-validation-error": import("./types.js").RegisteredError;
+    readonly "config-type-error": import("./types.js").RegisteredError;
+    readonly "import-map-invalid": import("./types.js").RegisteredError;
+    readonly "cors-config-invalid": import("./types.js").RegisteredError;
+    readonly "config-validation-failed": import("./types.js").RegisteredError;
+    readonly "webhook-config-invalid": import("./types.js").RegisteredError;
+    readonly "schedule-config-invalid": import("./types.js").RegisteredError;
+    readonly "trigger-config-invalid": import("./types.js").RegisteredError;
+};
+export type ErrorSlug = keyof typeof ERROR_REGISTRY;
+/**
+ * Get an error definition by slug
+ */
+export declare function getErrorBySlug(slug: ErrorSlug): import("./types.js").RegisteredError;
+/**
+ * Get all errors in a category
+ */
+export declare function getErrorsByCategory(category: ErrorCategory): import("./types.js").RegisteredError[];
+/**
+ * Get all registered slugs
+ */
+export declare function getAllSlugs(): ErrorSlug[];
+//# sourceMappingURL=error-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-registry.d.ts","sourceRoot":"","sources":["../../../src/src/errors/error-registry.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAgBhD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYjB,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,cAAc,CAAC;AAEpD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,wCAE7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,0CAE1D;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,SAAS,EAAE,CAEzC"}

package/esm/src/errors/error-registry.js

@@ -0,0 +1,60 @@
+import { getRegistryEntriesByCategory, getRegistryEntry, getRegistrySlugs, } from "./error-registry-helpers.js";
+// Error definitions live in per-category modules under ./error-registry/.
+// This barrel re-exports them and assembles the slug → definition registry.
+import { CONFIG_REGISTRY } from "./error-registry/config.js";
+import { BUILD_REGISTRY } from "./error-registry/build.js";
+import { RUNTIME_REGISTRY } from "./error-registry/runtime.js";
+import { ROUTE_REGISTRY } from "./error-registry/route.js";
+import { MODULE_REGISTRY } from "./error-registry/module.js";
+import { SERVER_REGISTRY } from "./error-registry/server.js";
+import { BOUNDARY_REGISTRY } from "./error-registry/boundary.js";
+import { DEV_REGISTRY } from "./error-registry/dev.js";
+import { DEPLOY_REGISTRY } from "./error-registry/deploy.js";
+import { AGENT_REGISTRY } from "./error-registry/agent.js";
+import { GENERAL_REGISTRY } from "./error-registry/general.js";
+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 "./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";
+/**
+ * Central registry mapping every error slug to its definition. Assembled from
+ * the per-category registry fragments.
+ */
+export const ERROR_REGISTRY = {
+    ...CONFIG_REGISTRY,
+    ...BUILD_REGISTRY,
+    ...RUNTIME_REGISTRY,
+    ...ROUTE_REGISTRY,
+    ...MODULE_REGISTRY,
+    ...SERVER_REGISTRY,
+    ...BOUNDARY_REGISTRY,
+    ...DEV_REGISTRY,
+    ...DEPLOY_REGISTRY,
+    ...AGENT_REGISTRY,
+    ...GENERAL_REGISTRY,
+};
+/**
+ * Get an error definition by slug
+ */
+export function getErrorBySlug(slug) {
+    return getRegistryEntry(ERROR_REGISTRY, slug);
+}
+/**
+ * Get all errors in a category
+ */
+export function getErrorsByCategory(category) {
+    return getRegistryEntriesByCategory(ERROR_REGISTRY, category);
+}
+/**
+ * Get all registered slugs
+ */
+export function getAllSlugs() {
+    return getRegistrySlugs(ERROR_REGISTRY);
+}

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

@@ -0,0 +1,84 @@
+/**
+ * Error categories for domain-based grouping and handling
+ */
+export type ErrorCategory = "CONFIG" | "BUILD" | "RUNTIME" | "ROUTE" | "MODULE" | "SERVER" | "BOUNDARY" | "DEV" | "DEPLOY" | "AGENT" | "GENERAL";
+/**
+ * RFC 9457 Problem Details response shape
+ */
+export interface RFC9457Response {
+    type: string;
+    title: string;
+    status: number;
+    detail?: string;
+    instance?: string;
+    category: ErrorCategory;
+    suggestion?: string;
+    cause?: string;
+}
+/**
+ * Error definition for the registry
+ */
+export interface ErrorDefinition {
+    slug: string;
+    category: ErrorCategory;
+    status: number;
+    title: string;
+    suggestion?: string;
+}
+/**
+ * Options for creating an error instance
+ */
+export interface ErrorCreateOptions {
+    /** Override the error message (defaults to detail or definition title) */
+    message?: string;
+    detail?: string;
+    cause?: unknown;
+    instance?: string;
+    context?: unknown;
+    /** Override the definition's default HTTP status (e.g., for per-request status codes) */
+    status?: number;
+}
+/**
+ * Registered error with factory method
+ */
+export interface RegisteredError extends ErrorDefinition {
+    create(options?: ErrorCreateOptions): VeryfrontError;
+}
+/**
+ * Define an error in the registry
+ */
+export declare function defineError(definition: ErrorDefinition): RegisteredError;
+/**
+ * Options for VeryfrontError constructor
+ */
+export interface VeryfrontErrorOptions extends ErrorCreateOptions {
+    slug: string;
+    category: ErrorCategory;
+    status: number;
+    title: string;
+    suggestion?: string;
+}
+/**
+ * Veryfront Error class with slug-based error identity
+ */
+export declare class VeryfrontError extends Error {
+    slug: string;
+    category: ErrorCategory;
+    status: number;
+    title: string;
+    suggestion?: string;
+    detail?: string;
+    cause?: unknown;
+    instance?: string;
+    context?: unknown;
+    constructor(message: string, options: VeryfrontErrorOptions);
+    /**
+     * Convert to RFC 9457 Problem Details format
+     */
+    toRFC9457(): RFC9457Response;
+    /**
+     * Get documentation URL for this error
+     */
+    getDocsUrl(): string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/errors/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,OAAO,GACP,SAAS,GACT,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,KAAK,GACL,QAAQ,GACR,OAAO,GACP,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,MAAM,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,cAAc,CAAC;CACtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,eAAe,GAAG,eAAe,CAiBxE;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEN,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB;IAe3D;;OAEG;IACH,SAAS,IAAI,eAAe;IAa5B;;OAEG;IACH,UAAU,IAAI,MAAM;CAGrB"}

package/esm/src/errors/types.js

@@ -0,0 +1,69 @@
+/**
+ * Define an error in the registry
+ */
+export function defineError(definition) {
+    return {
+        ...definition,
+        create(options) {
+            return new VeryfrontError(options?.message || options?.detail || definition.title, {
+                slug: definition.slug,
+                category: definition.category,
+                status: options?.status ?? definition.status,
+                title: definition.title,
+                suggestion: definition.suggestion,
+                detail: options?.detail,
+                cause: options?.cause,
+                instance: options?.instance,
+                context: options?.context,
+            });
+        },
+    };
+}
+/**
+ * Veryfront Error class with slug-based error identity
+ */
+export class VeryfrontError extends Error {
+    slug;
+    category;
+    status;
+    title;
+    suggestion;
+    detail;
+    cause;
+    instance;
+    context;
+    constructor(message, options) {
+        super(message);
+        this.name = "VeryfrontError";
+        this.slug = options.slug;
+        this.category = options.category;
+        this.status = options.status;
+        this.title = options.title;
+        this.suggestion = options.suggestion;
+        this.detail = options.detail;
+        this.cause = options.cause;
+        this.instance = options.instance;
+        this.context = options.context;
+    }
+    /**
+     * Convert to RFC 9457 Problem Details format
+     */
+    toRFC9457() {
+        return {
+            type: `https://veryfront.com/docs/errors/${this.slug}`,
+            title: this.title,
+            status: this.status,
+            detail: this.detail,
+            instance: this.instance,
+            category: this.category,
+            suggestion: this.suggestion,
+            cause: typeof this.cause === "string" ? this.cause : undefined,
+        };
+    }
+    /**
+     * Get documentation URL for this error
+     */
+    getDocsUrl() {
+        return `https://veryfront.com/docs/errors/${this.slug}`;
+    }
+}

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

@@ -0,0 +1,149 @@
+export interface BuildContext {
+    file?: string;
+    line?: number;
+    column?: number;
+    moduleId?: string;
+    phase?: "parse" | "transform" | "bundle" | "optimize" | "dependency-resolution" | "circuit-breaker" | "http-bundle-validation";
+    /** Number of failures (for circuit breaker) */
+    failures?: number;
+    /** Missing dependencies list */
+    missing?: Array<{
+        specifier: string;
+        fromFile: string;
+        reason: string;
+    }>;
+    /** Failed HTTP bundle specifiers */
+    failed?: string[];
+    /** Cache directory path */
+    cacheDir?: string;
+}
+export interface APIContext {
+    endpoint?: string;
+    method?: string;
+    statusCode?: number;
+    headers?: Record<string, string>;
+}
+export interface RenderContext {
+    component?: string;
+    route?: string;
+    phase?: "server" | "client" | "hydration";
+    props?: unknown;
+}
+export interface ConfigContext {
+    configFile?: string;
+    field?: string;
+    value?: unknown;
+    expected?: string;
+}
+export interface AgentContext {
+    agentId?: string;
+    intent?: string;
+    timeout?: number;
+}
+export interface FileContext {
+    path?: string;
+    operation?: "read" | "write" | "delete" | "mkdir";
+    permissions?: string;
+}
+interface NetworkContext {
+    url?: string;
+    timeout?: number;
+    retryCount?: number;
+}
+/**
+ * Discriminated union for serializable error data.
+ *
+ * This represents error DATA (plain objects), not throwable errors.
+ * For throwable errors, use `VeryfrontError` class from `./types.ts`.
+ */
+export type VeryfrontErrorData = {
+    type: "build";
+    message: string;
+    context?: BuildContext;
+} | {
+    type: "api";
+    message: string;
+    context?: APIContext;
+} | {
+    type: "render";
+    message: string;
+    context?: RenderContext;
+} | {
+    type: "config";
+    message: string;
+    context?: ConfigContext;
+} | {
+    type: "agent";
+    message: string;
+    context?: AgentContext;
+} | {
+    type: "file";
+    message: string;
+    context?: FileContext;
+} | {
+    type: "network";
+    message: string;
+    context?: NetworkContext;
+} | {
+    type: "permission";
+    message: string;
+    context?: FileContext;
+} | {
+    type: "not_supported";
+    message: string;
+    feature?: string;
+} | {
+    type: "no_ai_available";
+    message: string;
+};
+export declare function createError(error: VeryfrontErrorData): VeryfrontErrorData;
+export declare const isBuildError: (error: VeryfrontErrorData) => error is {
+    type: "build";
+    message: string;
+    context?: BuildContext;
+};
+export declare const isAPIError: (error: VeryfrontErrorData) => error is {
+    type: "api";
+    message: string;
+    context?: APIContext;
+};
+export declare const isRenderError: (error: VeryfrontErrorData) => error is {
+    type: "render";
+    message: string;
+    context?: RenderContext;
+};
+export declare const isConfigError: (error: VeryfrontErrorData) => error is {
+    type: "config";
+    message: string;
+    context?: ConfigContext;
+};
+export declare const isFileError: (error: VeryfrontErrorData) => error is {
+    type: "file";
+    message: string;
+    context?: FileContext;
+};
+export declare const isNetworkError: (error: VeryfrontErrorData) => error is {
+    type: "network";
+    message: string;
+    context?: NetworkContext;
+};
+/**
+ * Convert a VeryfrontErrorData (plain object) to a throwable Error instance.
+ *
+ * Uses Error.captureStackTrace when available (V8 engines) to exclude toError()
+ * from the stack trace, making the stack point to the actual call site.
+ *
+ * @see plans/architecture-audit/010.3-dual-veryfront-error-definitions.md
+ */
+export declare function toError(veryfrontError: VeryfrontErrorData): Error;
+export declare function fromError(error: unknown): VeryfrontErrorData | null;
+/**
+ * Extract error message from any error type
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Ensure error is an Error instance
+ */
+export declare function ensureError(error: unknown): Error;
+export {};
+//# sourceMappingURL=veryfront-error.d.ts.map

package/esm/src/errors/veryfront-error.d.ts.map

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

package/esm/src/errors/veryfront-error.js

@@ -0,0 +1,61 @@
+export function createError(error) {
+    return error;
+}
+/** Type guard factory for VeryfrontErrorData types */
+function isErrorType(type) {
+    return (error) => error.type === type;
+}
+export const isBuildError = isErrorType("build");
+export const isAPIError = isErrorType("api");
+export const isRenderError = isErrorType("render");
+export const isConfigError = isErrorType("config");
+export const isFileError = isErrorType("file");
+export const isNetworkError = isErrorType("network");
+/**
+ * Convert a VeryfrontErrorData (plain object) to a throwable Error instance.
+ *
+ * Uses Error.captureStackTrace when available (V8 engines) to exclude toError()
+ * from the stack trace, making the stack point to the actual call site.
+ *
+ * @see plans/architecture-audit/010.3-dual-veryfront-error-definitions.md
+ */
+export function toError(veryfrontError) {
+    const error = new Error(veryfrontError.message);
+    error.name = `VeryfrontError[${veryfrontError.type}]`;
+    // Capture stack at call site, excluding toError from the trace
+    // This makes debugging easier by showing where createError+toError was called
+    if (Error.captureStackTrace)
+        Error.captureStackTrace(error, toError);
+    Object.defineProperty(error, "context", {
+        value: veryfrontError,
+        enumerable: false,
+        configurable: true,
+    });
+    return error;
+}
+export function fromError(error) {
+    if (!error || typeof error !== "object" || !("context" in error))
+        return null;
+    const context = error.context;
+    if (!context || typeof context !== "object")
+        return null;
+    if (!("type" in context) || !("message" in context))
+        return null;
+    return context;
+}
+/**
+ * Extract error message from any error type
+ */
+export function getErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+/**
+ * Ensure error is an Error instance
+ */
+export function ensureError(error) {
+    if (error instanceof Error)
+        return error;
+    return new Error(String(error));
+}

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

@@ -0,0 +1,13 @@
+export declare class Semaphore {
+    private permits;
+    private readonly maxQueueSize;
+    private waitQueue;
+    constructor(permits: number, options?: {
+        maxQueueSize?: number;
+    });
+    tryAcquire(timeoutMs?: number): Promise<boolean>;
+    release(): void;
+    get available(): number;
+    get waiting(): number;
+}
+//# sourceMappingURL=semaphore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semaphore.d.ts","sourceRoot":"","sources":["../../../../../../src/src/modules/react-loader/ssr-module-loader/concurrency/semaphore.ts"],"names":[],"mappings":"AAKA,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,SAAS,CAAoE;gBAEzE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;IAKhE,UAAU,CAAC,SAAS,SAA6B,GAAG,OAAO,CAAC,OAAO,CAAC;IAkCpE,OAAO,IAAI,IAAI;IAUf,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF"}

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

@@ -0,0 +1,55 @@
+/** Default timeout for acquiring a semaphore permit (ms) */
+import * as dntShim from "../../../../../_dnt.shims.js";
+const DEFAULT_ACQUIRE_TIMEOUT_MS = 100;
+export class Semaphore {
+    permits;
+    maxQueueSize;
+    waitQueue = [];
+    constructor(permits, options) {
+        this.permits = permits;
+        this.maxQueueSize = options?.maxQueueSize ?? Infinity;
+    }
+    tryAcquire(timeoutMs = DEFAULT_ACQUIRE_TIMEOUT_MS) {
+        if (this.permits > 0) {
+            this.permits--;
+            return Promise.resolve(true);
+        }
+        if (this.waitQueue.length >= this.maxQueueSize) {
+            return Promise.resolve(false);
+        }
+        return new Promise((resolve) => {
+            let settled = false;
+            const onAcquire = () => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timeoutId);
+                resolve(true);
+            };
+            const timeoutId = dntShim.setTimeout(() => {
+                if (settled)
+                    return;
+                settled = true;
+                const index = this.waitQueue.findIndex((w) => w.resolve === onAcquire);
+                if (index !== -1)
+                    this.waitQueue.splice(index, 1);
+                resolve(false);
+            }, timeoutMs);
+            this.waitQueue.push({ resolve: onAcquire, reject: onAcquire });
+        });
+    }
+    release() {
+        const next = this.waitQueue.shift();
+        if (next) {
+            next.resolve();
+            return;
+        }
+        this.permits++;
+    }
+    get available() {
+        return this.permits;
+    }
+    get waiting() {
+        return this.waitQueue.length;
+    }
+}