@veryfront/ext-content-mdx 0.1.1186 → 0.1.1189

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

@@ -4,6 +4,7 @@ export declare const CACHE_ERROR: import("../types.js").RegisteredError;
 export declare const FILE_WATCH_ERROR: import("../types.js").RegisteredError;
 export declare const REQUEST_ERROR: import("../types.js").RegisteredError;
 export declare const SERVICE_OVERLOADED: import("../types.js").RegisteredError;
+export declare const PROJECT_EXECUTION_UNAVAILABLE: import("../types.js").RegisteredError;
 export declare const SEMAPHORE_TIMEOUT: import("../types.js").RegisteredError;
 export declare const CIRCUIT_BREAKER_OPEN: import("../types.js").RegisteredError;
 export declare const CACHE_PATH_MISMATCH: import("../types.js").RegisteredError;
@@ -26,6 +27,7 @@ export declare const SERVER_REGISTRY: {
     readonly "file-watch-error": import("../types.js").RegisteredError;
     readonly "request-error": import("../types.js").RegisteredError;
     readonly "service-overloaded": import("../types.js").RegisteredError;
+    readonly "project-execution-unavailable": 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;

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/src/errors/error-registry/server.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,uCAMtB,CAAC;AAEH,eAAO,MAAM,kBAAkB,uCAM7B,CAAC;AAEH,eAAO,MAAM,WAAW,uCAMtB,CAAC;AAEH,eAAO,MAAM,gBAAgB,uCAM3B,CAAC;AAEH,eAAO,MAAM,aAAa,uCAMxB,CAAC;AAEH,eAAO,MAAM,kBAAkB,uCAM7B,CAAC;AAEH,eAAO,MAAM,iBAAiB,uCAM5B,CAAC;AAEH,eAAO,MAAM,oBAAoB,uCAM/B,CAAC;AAEH,eAAO,MAAM,mBAAmB,uCAM9B,CAAC;AAEH,eAAO,MAAM,aAAa,uCAMxB,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,uCAM3B,CAAC;AAEH,kEAAkE;AAClE,eAAO,MAAM,mBAAmB,uCAM9B,CAAC;AAEH,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,uCAMpC,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,uCAM5B,CAAC;AAEH,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,uCAM7B,CAAC;AAEH,+DAA+D;AAC/D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;CAgBlB,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/src/errors/error-registry/server.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,uCAMtB,CAAC;AAEH,eAAO,MAAM,kBAAkB,uCAM7B,CAAC;AAEH,eAAO,MAAM,WAAW,uCAMtB,CAAC;AAEH,eAAO,MAAM,gBAAgB,uCAM3B,CAAC;AAEH,eAAO,MAAM,aAAa,uCAMxB,CAAC;AAEH,eAAO,MAAM,kBAAkB,uCAM7B,CAAC;AAEH,eAAO,MAAM,6BAA6B,uCAMxC,CAAC;AAEH,eAAO,MAAM,iBAAiB,uCAM5B,CAAC;AAEH,eAAO,MAAM,oBAAoB,uCAM/B,CAAC;AAEH,eAAO,MAAM,mBAAmB,uCAM9B,CAAC;AAEH,eAAO,MAAM,aAAa,uCAMxB,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,uCAM3B,CAAC;AAEH,kEAAkE;AAClE,eAAO,MAAM,mBAAmB,uCAM9B,CAAC;AAEH,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,uCAMpC,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,uCAM5B,CAAC;AAEH,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,uCAM7B,CAAC;AAEH,+DAA+D;AAC/D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;CAiBlB,CAAC"}

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

@@ -41,6 +41,13 @@ export const SERVICE_OVERLOADED = defineError({
     title: "Service overloaded",
     suggestion: "Reduce load or scale up resources",
 });
+export const PROJECT_EXECUTION_UNAVAILABLE = defineError({
+    slug: "project-execution-unavailable",
+    category: "SERVER",
+    status: 503,
+    title: "Project execution unavailable",
+    suggestion: "Route the project to a dedicated isolated runtime",
+});
 export const SEMAPHORE_TIMEOUT = defineError({
     slug: "semaphore-timeout",
     category: "SERVER",
@@ -117,6 +124,7 @@ export const SERVER_REGISTRY = {
     "file-watch-error": FILE_WATCH_ERROR,
     "request-error": REQUEST_ERROR,
     "service-overloaded": SERVICE_OVERLOADED,
+    "project-execution-unavailable": PROJECT_EXECUTION_UNAVAILABLE,
     "semaphore-timeout": SEMAPHORE_TIMEOUT,
     "circuit-breaker-open": CIRCUIT_BREAKER_OPEN,
     "cache-path-mismatch": CACHE_PATH_MISMATCH,

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

@@ -1,6 +1,15 @@
 import type { ErrorCategory, RegisteredError } from "./types.js";
-export type ErrorRegistryMap = Record<string, RegisteredError>;
-export declare function getRegistryEntry<Registry extends ErrorRegistryMap, Slug extends keyof Registry>(registry: Registry, slug: Slug): Registry[Slug];
+export type ErrorRegistryMap = Readonly<Record<string, RegisteredError>>;
+type UnionToIntersection<Union> = (Union extends unknown ? (value: Union) => void : never) extends (value: infer Intersection) => void ? Intersection : never;
+type ComposedSlugMap<Fragments extends readonly object[]> = UnionToIntersection<Fragments[number]>;
+/**
+ * Compose slug-keyed fragments without object-spread's silent last-write-wins behavior.
+ */
+export declare function composeSluggedMaps<const Fragments extends readonly object[]>(collectionName: string, ...fragments: Fragments): Readonly<ComposedSlugMap<Fragments>>;
+export declare function composeErrorRegistry<const Fragments extends readonly ErrorRegistryMap[]>(...fragments: Fragments): Readonly<ComposedSlugMap<Fragments>>;
+export declare function getRegistryEntry<Registry extends ErrorRegistryMap, Slug extends Extract<keyof Registry, string>>(registry: Registry, slug: Slug): Registry[Slug];
+export declare function getRegistryEntry(registry: ErrorRegistryMap, slug: string): RegisteredError | undefined;
 export declare function getRegistryEntriesByCategory(registry: ErrorRegistryMap, category: ErrorCategory): RegisteredError[];
 export declare function getRegistrySlugs<Registry extends ErrorRegistryMap>(registry: Registry): Array<keyof Registry>;
+export {};
 //# sourceMappingURL=error-registry-helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"error-registry-helpers.d.ts","sourceRoot":"","sources":["../../../src/src/errors/error-registry-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE/D,wBAAgB,gBAAgB,CAC9B,QAAQ,SAAS,gBAAgB,EACjC,IAAI,SAAS,MAAM,QAAQ,EAC3B,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAEhD;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,aAAa,GACtB,eAAe,EAAE,CAEnB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,SAAS,gBAAgB,EAChE,QAAQ,EAAE,QAAQ,GACjB,KAAK,CAAC,MAAM,QAAQ,CAAC,CAEvB"}
+{"version":3,"file":"error-registry-helpers.d.ts","sourceRoot":"","sources":["../../../src/src/errors/error-registry-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;AAgBzE,KAAK,mBAAmB,CAAC,KAAK,IAAI,CAChC,KAAK,SAAS,OAAO,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,KAAK,CACvD,SAAS,CAAC,KAAK,EAAE,MAAM,YAAY,KAAK,IAAI,GAAG,YAAY,GAAG,KAAK,CAAC;AAErE,KAAK,eAAe,CAAC,SAAS,SAAS,SAAS,MAAM,EAAE,IAAI,mBAAmB,CAC7E,SAAS,CAAC,MAAM,CAAC,CAClB,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,SAAS,SAAS,SAAS,MAAM,EAAE,EAC1E,cAAc,EAAE,MAAM,EACtB,GAAG,SAAS,EAAE,SAAS,GACtB,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CA6BtC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,SAAS,SAAS,SAAS,gBAAgB,EAAE,EACtF,GAAG,SAAS,EAAE,SAAS,GACtB,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAyCtC;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,SAAS,gBAAgB,EACjC,IAAI,SAAS,OAAO,CAAC,MAAM,QAAQ,EAAE,MAAM,CAAC,EAC5C,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;AAClD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,MAAM,GACX,eAAe,GAAG,SAAS,CAAC;AAQ/B,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,aAAa,GACtB,eAAe,EAAE,CAEnB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,SAAS,gBAAgB,EAChE,QAAQ,EAAE,QAAQ,GACjB,KAAK,CAAC,MAAM,QAAQ,CAAC,CAEvB"}

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

@@ -1,5 +1,74 @@
+const ERROR_CATEGORIES = new Set([
+    "CONFIG",
+    "BUILD",
+    "RUNTIME",
+    "ROUTE",
+    "MODULE",
+    "SERVER",
+    "BOUNDARY",
+    "DEV",
+    "DEPLOY",
+    "AGENT",
+    "GENERAL",
+]);
+/**
+ * Compose slug-keyed fragments without object-spread's silent last-write-wins behavior.
+ */
+export function composeSluggedMaps(collectionName, ...fragments) {
+    const composed = Object.create(null);
+    const capitalizedCollectionName = collectionName.charAt(0).toUpperCase() +
+        collectionName.slice(1);
+    for (const fragment of fragments) {
+        for (const [key, entry] of Object.entries(fragment)) {
+            if (typeof entry !== "object" || entry === null || !Object.hasOwn(entry, "slug")) {
+                throw new Error(`${capitalizedCollectionName} entry "${key}" must define a slug`);
+            }
+            const slug = entry.slug;
+            if (typeof slug !== "string") {
+                throw new Error(`${capitalizedCollectionName} entry "${key}" must define a string slug`);
+            }
+            if (slug !== key) {
+                throw new Error(`${capitalizedCollectionName} key "${key}" does not match entry slug "${slug}"`);
+            }
+            if (Object.hasOwn(composed, key)) {
+                throw new Error(`Duplicate ${collectionName} slug "${key}"`);
+            }
+            composed[key] = entry;
+        }
+    }
+    return Object.freeze(composed);
+}
+export function composeErrorRegistry(...fragments) {
+    for (const fragment of fragments) {
+        for (const definition of Object.values(fragment)) {
+            if (typeof definition.slug !== "string" ||
+                definition.slug.length < 3 ||
+                definition.slug.length > 40 ||
+                !/^[a-z][a-z0-9-]*[a-z0-9]$/.test(definition.slug)) {
+                throw new TypeError(`Registered error slug must be 3-40 characters of lowercase kebab-case, got "${definition.slug}"`);
+            }
+            if (typeof definition.category !== "string" ||
+                !ERROR_CATEGORIES.has(definition.category)) {
+                throw new TypeError(`Registered error has unknown category "${definition.category}"`);
+            }
+            if (!Number.isInteger(definition.status) || definition.status < 400 ||
+                definition.status >= 600) {
+                throw new RangeError(`Registered error status must be an integer from 400 through 599, got ${definition.status}`);
+            }
+            if (typeof definition.title !== "string" || definition.title.trim().length === 0) {
+                throw new TypeError("Registered error title must be a non-empty string");
+            }
+            if (definition.suggestion !== undefined &&
+                (typeof definition.suggestion !== "string" ||
+                    definition.suggestion.trim().length === 0)) {
+                throw new TypeError("Registered error suggestion must be non-empty when provided");
+            }
+        }
+    }
+    return composeSluggedMaps("error registry", ...fragments);
+}
 export function getRegistryEntry(registry, slug) {
-    return registry[slug];
+    return Object.hasOwn(registry, slug) ? registry[slug] : undefined;
 }
 export function getRegistryEntriesByCategory(registry, category) {
     return Object.values(registry).filter((error) => error.category === category);

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

@@ -14,7 +14,7 @@ export * from "veryfront/errors/general";
  * Central registry mapping every error slug to its definition. Assembled from
  * the per-category registry fragments.
  */
-export declare const ERROR_REGISTRY: {
+export declare const ERROR_REGISTRY: Readonly<{
     readonly "unknown-error": import("./types.js").RegisteredError;
     readonly "authentication-required": import("./types.js").RegisteredError;
     readonly "permission-denied": import("./types.js").RegisteredError;
@@ -27,42 +27,60 @@ export declare const ERROR_REGISTRY: {
     readonly "security-violation": import("./types.js").RegisteredError;
     readonly "input-validation-failed": import("./types.js").RegisteredError;
     readonly "project-source-empty": 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 "environment-not-found": import("./types.js").RegisteredError;
-    readonly "release-missing-version": import("./types.js").RegisteredError;
-    readonly "release-build-timeout": import("./types.js").RegisteredError;
-    readonly "deployment-verification-timeout": import("./types.js").RegisteredError;
-    readonly "push-receipt-missing": import("./types.js").RegisteredError;
-    readonly "source-digest-mismatch": import("./types.js").RegisteredError;
-    readonly "preview-hostname-too-long": import("./types.js").RegisteredError;
-    readonly "branch-not-found": 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 "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;
+} & {
+    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 "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 "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 "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 "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 "project-execution-unavailable": 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;
@@ -72,48 +90,42 @@ export declare const ERROR_REGISTRY: {
     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;
-};
+} & {
+    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 "ssr-output-limit-exceeded": 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 "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 "environment-not-found": import("./types.js").RegisteredError;
+    readonly "release-missing-version": import("./types.js").RegisteredError;
+    readonly "release-build-timeout": import("./types.js").RegisteredError;
+    readonly "deployment-verification-timeout": import("./types.js").RegisteredError;
+    readonly "push-receipt-missing": import("./types.js").RegisteredError;
+    readonly "source-digest-mismatch": import("./types.js").RegisteredError;
+    readonly "preview-hostname-too-long": import("./types.js").RegisteredError;
+    readonly "branch-not-found": 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;
+}>;
 export type ErrorSlug = keyof typeof ERROR_REGISTRY;
 /**
  * Get an error definition by slug

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

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

@@ -1,4 +1,4 @@
-import { getRegistryEntriesByCategory, getRegistryEntry, getRegistrySlugs, } from "./error-registry-helpers.js";
+import { composeErrorRegistry, 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";
@@ -27,19 +27,7 @@ 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,
-};
+export const ERROR_REGISTRY = composeErrorRegistry(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
  */

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

@@ -24,7 +24,7 @@ export interface ErrorDefinition {
     status: number;
     title: string;
     suggestion?: string;
-    /** Process exit code to use when this error reaches the CLI boundary (e.g. 2 for usage errors). */
+    /** Process exit code to use when this error reaches the CLI boundary. */
     exitCode?: number;
 }
 /**
@@ -43,8 +43,14 @@ export interface ErrorCreateOptions {
 /**
  * Registered error with factory method
  */
-export interface RegisteredError extends ErrorDefinition {
-    create(options?: ErrorCreateOptions): VeryfrontError;
+export interface RegisteredError {
+    readonly slug: string;
+    readonly category: ErrorCategory;
+    readonly status: number;
+    readonly title: string;
+    readonly suggestion?: string;
+    readonly exitCode?: number;
+    readonly create: (options?: ErrorCreateOptions) => VeryfrontError;
 }
 /**
  * Define an error in the registry
@@ -62,6 +68,21 @@ export interface VeryfrontErrorOptions extends ErrorCreateOptions {
     /** Process exit code to use at the CLI boundary. */
     exitCode?: number;
 }
+/** Data-only snapshot used at logging, HTTP, CLI, and telemetry boundaries. */
+export interface VeryfrontErrorSnapshot {
+    readonly slug: string;
+    readonly category: ErrorCategory;
+    readonly status: number;
+    readonly title: string;
+    readonly message: string;
+    readonly suggestion?: string;
+    readonly exitCode?: number;
+    readonly detail?: string;
+    readonly cause?: unknown;
+    readonly instance?: string;
+    readonly context?: unknown;
+    readonly stack?: string;
+}
 /**
  * Veryfront Error class with slug-based error identity
  */
@@ -71,12 +92,12 @@ export declare class VeryfrontError extends Error {
     status: number;
     title: string;
     suggestion?: string;
+    /** Process exit code for the CLI boundary. */
+    exitCode?: number;
     detail?: string;
     cause?: unknown;
     instance?: string;
     context?: unknown;
-    /** Process exit code for the CLI boundary (e.g. 2 for usage errors). */
-    exitCode?: number;
     constructor(message: string, options: VeryfrontErrorOptions);
     /**
      * Convert to RFC 9457 Problem Details format
@@ -87,4 +108,22 @@ export declare class VeryfrontError extends Error {
      */
     getDocsUrl(): string;
 }
+/** Runtime-safe VeryfrontError guard for values caught from untrusted code. */
+export declare function isVeryfrontErrorInstance(error: unknown): error is VeryfrontError;
+/**
+ * Read a VeryfrontError once into plain data.
+ *
+ * A proxy can pass `instanceof VeryfrontError` and still throw from any field
+ * getter. Boundary code must use this snapshot instead of repeatedly reading
+ * the original object.
+ */
+export declare function snapshotVeryfrontError(error: unknown): VeryfrontErrorSnapshot | null;
+/**
+ * Snapshot a value that has already been classified as a VeryfrontError.
+ *
+ * Keeping classification separate lets boundary code avoid a second
+ * `instanceof`/proxy-prototype inspection after it has committed to this
+ * branch.
+ */
+export declare function snapshotKnownVeryfrontError(error: VeryfrontError): VeryfrontErrorSnapshot | null;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +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;IACpB,mGAAmG;IACnG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;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,CAkBxE;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;IACpB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;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;IAClB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAEN,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB;IAgB3D;;OAEG;IACH,SAAS,IAAI,eAAe;IAa5B;;OAEG;IACH,UAAU,IAAI,MAAM;CAGrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/errors/types.ts"],"names":[],"mappings":"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"}