@veryfront/ext-observability-opentelemetry 0.1.1032 → 0.1.1033

package/esm/{index.js → extensions/ext-observability-opentelemetry/src/index.js}

@@ -13,7 +13,9 @@
  *
  * @module extensions/ext-observability-opentelemetry
  */
-import * as dntShim from "./_dnt.shims.js";
+import "../../../_dnt.polyfills.js";
+import * as dntShim from "../../../_dnt.shims.js";
+import { VERSION } from "../../../src/utils/index.js";
 const NOOP_SPAN = {
     setAttribute() {
         return NOOP_SPAN;
@@ -124,6 +126,42 @@ function parseHeaders(headerInput) {
     }
     return result;
 }
+function parseResourceAttributes(value) {
+    if (!value)
+        return {};
+    const attributes = {};
+    for (const part of value.split(",")) {
+        const [rawKey, ...rawValueParts] = part.split("=");
+        const key = rawKey?.trim();
+        if (!key || rawValueParts.length === 0)
+            continue;
+        attributes[key] = rawValueParts.join("=").trim();
+    }
+    return attributes;
+}
+function resolveServiceName(read, resourceAttributes) {
+    return read("OTEL_SERVICE_NAME") ?? resourceAttributes["service.name"] ??
+        read("DD_SERVICE") ?? "veryfront";
+}
+function resolveServiceVersion(read, resourceAttributes) {
+    return resourceAttributes["service.version"] ??
+        read("OTEL_SERVICE_VERSION") ??
+        read("DD_VERSION") ??
+        read("VERYFRONT_VERSION") ??
+        read("RELEASE_VERSION") ??
+        read("npm_package_version") ??
+        VERSION;
+}
+function resolveDeploymentEnvironment(read, resourceAttributes) {
+    return resourceAttributes["deployment.environment.name"] ??
+        resourceAttributes["deployment.environment"] ??
+        read("OTEL_DEPLOYMENT_ENVIRONMENT") ??
+        read("DD_ENV") ??
+        read("APP_ENVIRONMENT") ??
+        read("VERYFRONT_ENVIRONMENT") ??
+        read("NODE_ENV") ??
+        "development";
+}
 function headersOrDefault(signalHeaders, defaultHeaders) {
     return signalHeaders ?? defaultHeaders;
 }
@@ -148,7 +186,79 @@ function logSeverityNumber(otel, level) {
             return otel.apiLogs.SeverityNumber.INFO;
     }
 }
-function logAttributes(record) {
+const TRACE_ID_LOG_ALIASES = ["trace.id", "otel.trace_id"];
+const SPAN_ID_LOG_ALIASES = ["span.id", "otel.span_id"];
+const PROJECT_ID_LOG_ALIASES = ["project.id"];
+const RUN_ID_LOG_ALIASES = ["run.id"];
+const AGENT_ID_LOG_ALIASES = ["agent.id", "gen_ai.agent.id"];
+const THREAD_ID_LOG_ALIASES = ["thread.id"];
+const SCHEDULE_ID_LOG_ALIASES = ["schedule.id", "run.trigger.id"];
+const SCHEDULE_NAME_LOG_ALIASES = ["schedule.name"];
+const TOOL_NAME_LOG_ALIASES = ["tool.name", "gen_ai.tool.name"];
+const TOOL_CALL_ID_LOG_ALIASES = ["tool.call.id", "gen_ai.tool.call.id"];
+const LOG_ATTRIBUTE_ALIASES = {
+    trace_id: TRACE_ID_LOG_ALIASES,
+    span_id: SPAN_ID_LOG_ALIASES,
+    project_id: PROJECT_ID_LOG_ALIASES,
+    run_id: RUN_ID_LOG_ALIASES,
+    agent_id: AGENT_ID_LOG_ALIASES,
+    thread_id: THREAD_ID_LOG_ALIASES,
+    schedule_id: SCHEDULE_ID_LOG_ALIASES,
+    schedule_name: SCHEDULE_NAME_LOG_ALIASES,
+    tool_name: TOOL_NAME_LOG_ALIASES,
+    tool_call_id: TOOL_CALL_ID_LOG_ALIASES,
+};
+const CONTEXT_LOG_ATTRIBUTE_ALIASES = {
+    traceId: TRACE_ID_LOG_ALIASES,
+    trace_id: TRACE_ID_LOG_ALIASES,
+    spanId: SPAN_ID_LOG_ALIASES,
+    span_id: SPAN_ID_LOG_ALIASES,
+    projectId: PROJECT_ID_LOG_ALIASES,
+    project_id: PROJECT_ID_LOG_ALIASES,
+    runId: RUN_ID_LOG_ALIASES,
+    run_id: RUN_ID_LOG_ALIASES,
+    agentId: AGENT_ID_LOG_ALIASES,
+    agent_id: AGENT_ID_LOG_ALIASES,
+    threadId: THREAD_ID_LOG_ALIASES,
+    thread_id: THREAD_ID_LOG_ALIASES,
+    scheduleId: SCHEDULE_ID_LOG_ALIASES,
+    schedule_id: SCHEDULE_ID_LOG_ALIASES,
+    scheduleName: SCHEDULE_NAME_LOG_ALIASES,
+    schedule_name: SCHEDULE_NAME_LOG_ALIASES,
+    toolName: TOOL_NAME_LOG_ALIASES,
+    tool_name: TOOL_NAME_LOG_ALIASES,
+    toolCallId: TOOL_CALL_ID_LOG_ALIASES,
+    tool_call_id: TOOL_CALL_ID_LOG_ALIASES,
+};
+function isLogAttributeValue(value) {
+    return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+function hexToUnsignedDecimal(value) {
+    const normalized = value?.trim().replace(/^0x/, "");
+    if (!normalized || !/^[0-9a-f]+$/i.test(normalized))
+        return undefined;
+    try {
+        return BigInt(`0x${normalized}`).toString(10);
+    }
+    catch {
+        return undefined;
+    }
+}
+function addLogAttributeAliases(attributes, key, value) {
+    const aliases = LOG_ATTRIBUTE_ALIASES[key] ?? CONTEXT_LOG_ATTRIBUTE_ALIASES[key];
+    for (const alias of aliases ?? []) {
+        attributes[alias] ??= value;
+    }
+    if (key === "trace_id" || key === "traceId") {
+        const traceId = typeof value === "string" ? value : String(value);
+        attributes["dd.trace_id"] ??= hexToUnsignedDecimal(traceId.slice(-16)) ?? traceId;
+    }
+    if (key === "span_id" || key === "spanId") {
+        const spanId = typeof value === "string" ? value : String(value);
+        attributes["dd.span_id"] ??= hexToUnsignedDecimal(spanId) ?? spanId;
+    }
+}
+export function logAttributes(record) {
     const attributes = {};
     for (const [key, value] of Object.entries(record)) {
         if (key === "timestamp" ||
@@ -158,14 +268,16 @@ function logAttributes(record) {
             key === "error") {
             continue;
         }
-        if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        if (isLogAttributeValue(value)) {
             attributes[key] = value;
+            addLogAttributeAliases(attributes, key, value);
         }
     }
     if (record.context) {
         for (const [key, value] of Object.entries(record.context)) {
-            if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+            if (isLogAttributeValue(value)) {
                 attributes[`context.${key}`] = value;
+                addLogAttributeAliases(attributes, key, value);
             }
         }
     }
@@ -213,6 +325,7 @@ function resolveMetricsTemporalityPreference(value) {
     return "delta";
 }
 export function resolveOtlpExtensionConfig(read = readEnv) {
+    const resourceAttributes = parseResourceAttributes(read("OTEL_RESOURCE_ATTRIBUTES"));
     const endpoint = read("OTEL_EXPORTER_OTLP_ENDPOINT");
     const tracesEndpoint = read("OTEL_EXPORTER_OTLP_TRACES_ENDPOINT") ?? endpoint;
     const metricsEndpoint = read("OTEL_EXPORTER_OTLP_METRICS_ENDPOINT") ?? endpoint;
@@ -223,8 +336,9 @@ export function resolveOtlpExtensionConfig(read = readEnv) {
     const metricsHeaders = mergeHeaders(headers, parseHeaders(read("OTEL_EXPORTER_OTLP_METRICS_HEADERS")));
     const logsHeaders = mergeHeaders(headers, parseHeaders(read("OTEL_EXPORTER_OTLP_LOGS_HEADERS")));
     return {
-        serviceName: read("OTEL_SERVICE_NAME") ?? "veryfront",
-        serviceVersion: "0.1.0",
+        serviceName: resolveServiceName(read, resourceAttributes),
+        serviceVersion: resolveServiceVersion(read, resourceAttributes),
+        deploymentEnvironment: resolveDeploymentEnvironment(read, resourceAttributes),
         headers,
         tracesHeaders,
         metricsHeaders,
@@ -259,6 +373,8 @@ class OtlpTracingExporter {
         const resource = otel.resources.resourceFromAttributes({
             [otel.semanticConventions.ATTR_SERVICE_NAME]: cfg.serviceName,
             [otel.semanticConventions.ATTR_SERVICE_VERSION]: cfg.serviceVersion,
+            "deployment.environment": cfg.deploymentEnvironment,
+            "deployment.environment.name": cfg.deploymentEnvironment,
         });
         if (cfg.tracesEnabled) {
             if (!cfg.tracesUrl) {
@@ -409,6 +525,7 @@ class OpenTelemetryNodeTelemetryProvider {
             "service.name": options.serviceName,
             "service.version": options.serviceVersion,
             "deployment.environment": options.deploymentEnvironment,
+            "deployment.environment.name": options.deploymentEnvironment,
         });
         const spanProcessors = tracesEnabled
             ? [
@@ -541,7 +658,18 @@ const extOpenTelemetry = () => {
                     "OTEL_EXPORTER_OTLP_TRACES_HEADERS",
                     "OTEL_EXPORTER_OTLP_METRICS_HEADERS",
                     "OTEL_EXPORTER_OTLP_LOGS_HEADERS",
+                    "OTEL_RESOURCE_ATTRIBUTES",
                     "OTEL_SERVICE_NAME",
+                    "OTEL_SERVICE_VERSION",
+                    "OTEL_DEPLOYMENT_ENVIRONMENT",
+                    "DD_SERVICE",
+                    "DD_VERSION",
+                    "DD_ENV",
+                    "VERYFRONT_VERSION",
+                    "RELEASE_VERSION",
+                    "APP_ENVIRONMENT",
+                    "VERYFRONT_ENVIRONMENT",
+                    "NODE_ENV",
                     "OTEL_TRACES_ENABLED",
                     "OTEL_METRICS_ENABLED",
                     "OTEL_LOGS_ENABLED",

package/esm/src/config/defaults.d.ts

@@ -0,0 +1,39 @@
+import { DEFAULT_PORT } from "../platform/compat/constants.js";
+export { DEFAULT_PORT };
+export declare const DEFAULT_TIMEOUT_MS = 5000;
+export declare const SSR_TIMEOUT_MS = 10000;
+export declare const SANDBOX_TIMEOUT_MS = 5000;
+/** Timeout for user data fetching functions (getServerData, getStaticData) */
+export declare const DATA_FETCH_TIMEOUT_MS = 10000;
+export declare const DEFAULT_CACHE_MAX_SIZE = 100;
+export declare const DURATION_HISTOGRAM_BOUNDARIES_MS: readonly [5, 10, 25, 50, 75, 100, 250, 500, 750, 1000, 2500, 5000, 7500, 10000];
+export declare const SIZE_HISTOGRAM_BOUNDARIES_KB: readonly [1, 5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000, 10000];
+export declare const defaultConfig: {
+    readonly server: {
+        readonly port: 3000;
+        readonly hostname: "0.0.0.0";
+    };
+    readonly timeouts: {
+        readonly default: 5000;
+        readonly api: 30000;
+        readonly ssr: 10000;
+        readonly hmr: 30000;
+        readonly sandbox: 5000;
+    };
+    readonly cache: {
+        readonly jit: {
+            readonly maxSize: 100;
+            readonly tempDirPrefix: "vf-bundle-";
+        };
+    };
+    readonly metrics: {
+        readonly ssrBoundaries: readonly [5, 10, 25, 50, 75, 100, 250, 500, 750, 1000, 2500, 5000, 7500, 10000];
+    };
+};
+export declare const DEFAULT_PREFETCH_DELAY_MS = 100;
+export declare const DEFAULT_METRICS_COLLECT_INTERVAL_MS = 60000;
+export declare const DEFAULT_REDIS_SCAN_COUNT = 100;
+export declare const DEFAULT_REDIS_BATCH_DELETE_SIZE = 1000;
+export declare const PAGE_TRANSITION_DELAY_MS = 150;
+export type DefaultConfig = typeof defaultConfig;
+//# sourceMappingURL=defaults.d.ts.map

package/esm/src/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,CAAC;AACxB,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,eAAO,MAAM,cAAc,QAAQ,CAAC;AACpC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,eAAO,MAAM,gCAAgC,iFAenC,CAAC;AAEX,eAAO,MAAM,4BAA4B,qEAa/B,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;CAqBhB,CAAC;AAEX,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,mCAAmC,QAAQ,CAAC;AACzD,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,+BAA+B,OAAO,CAAC;AACpD,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC"}

package/esm/src/config/defaults.js

@@ -0,0 +1,65 @@
+import { DEFAULT_PORT } from "../platform/compat/constants.js";
+export { DEFAULT_PORT };
+export const DEFAULT_TIMEOUT_MS = 5000;
+export const SSR_TIMEOUT_MS = 10000;
+export const SANDBOX_TIMEOUT_MS = 5000;
+/** Timeout for user data fetching functions (getServerData, getStaticData) */
+export const DATA_FETCH_TIMEOUT_MS = 10000;
+export const DEFAULT_CACHE_MAX_SIZE = 100;
+export const DURATION_HISTOGRAM_BOUNDARIES_MS = [
+    5,
+    10,
+    25,
+    50,
+    75,
+    100,
+    250,
+    500,
+    750,
+    1000,
+    2500,
+    5000,
+    7500,
+    10000,
+];
+export const SIZE_HISTOGRAM_BOUNDARIES_KB = [
+    1,
+    5,
+    10,
+    25,
+    50,
+    100,
+    250,
+    500,
+    1000,
+    2500,
+    5000,
+    10000,
+];
+export const defaultConfig = {
+    server: {
+        port: DEFAULT_PORT,
+        hostname: "0.0.0.0",
+    },
+    timeouts: {
+        default: DEFAULT_TIMEOUT_MS,
+        api: 30000,
+        ssr: SSR_TIMEOUT_MS,
+        hmr: 30000,
+        sandbox: SANDBOX_TIMEOUT_MS,
+    },
+    cache: {
+        jit: {
+            maxSize: DEFAULT_CACHE_MAX_SIZE,
+            tempDirPrefix: "vf-bundle-",
+        },
+    },
+    metrics: {
+        ssrBoundaries: DURATION_HISTOGRAM_BOUNDARIES_MS,
+    },
+};
+export const DEFAULT_PREFETCH_DELAY_MS = 100;
+export const DEFAULT_METRICS_COLLECT_INTERVAL_MS = 60000;
+export const DEFAULT_REDIS_SCAN_COUNT = 100;
+export const DEFAULT_REDIS_BATCH_DELETE_SIZE = 1000;
+export const PAGE_TRANSITION_DELAY_MS = 150;

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

@@ -0,0 +1,18 @@
+export declare const AGENT_ERROR: import("../types.js").RegisteredError;
+export declare const AGENT_NOT_FOUND: import("../types.js").RegisteredError;
+export declare const AGENT_TIMEOUT: import("../types.js").RegisteredError;
+export declare const AGENT_INTENT_ERROR: import("../types.js").RegisteredError;
+export declare const ORCHESTRATION_ERROR: import("../types.js").RegisteredError;
+export declare const COST_LIMIT_EXCEEDED: import("../types.js").RegisteredError;
+export declare const TOOL_ID_CONFLICT: import("../types.js").RegisteredError;
+/** Registry fragment for AGENT errors (slug → definition). */
+export declare const AGENT_REGISTRY: {
+    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;
+};
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../../src/src/errors/error-registry/agent.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,uCAMtB,CAAC;AAEH,eAAO,MAAM,eAAe,uCAM1B,CAAC;AAEH,eAAO,MAAM,aAAa,uCAMxB,CAAC;AAEH,eAAO,MAAM,kBAAkB,uCAM7B,CAAC;AAEH,eAAO,MAAM,mBAAmB,uCAM9B,CAAC;AAEH,eAAO,MAAM,mBAAmB,uCAM9B,CAAC;AAEH,eAAO,MAAM,gBAAgB,uCAM3B,CAAC;AAEH,8DAA8D;AAC9D,eAAO,MAAM,cAAc;;;;;;;;CAQjB,CAAC"}

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

@@ -0,0 +1,60 @@
+import { defineError } from "../types.js";
+export const AGENT_ERROR = defineError({
+    slug: "agent-error",
+    category: "AGENT",
+    status: 500,
+    title: "Agent operation error",
+    suggestion: "Check agent configuration and logs",
+});
+export const AGENT_NOT_FOUND = defineError({
+    slug: "agent-not-found",
+    category: "AGENT",
+    status: 404,
+    title: "Agent not found",
+    suggestion: "Verify the agent ID exists",
+});
+export const AGENT_TIMEOUT = defineError({
+    slug: "agent-timeout",
+    category: "AGENT",
+    status: 408,
+    title: "Agent operation timed out",
+    suggestion: "Increase timeout or simplify the request",
+});
+export const AGENT_INTENT_ERROR = defineError({
+    slug: "agent-intent-error",
+    category: "AGENT",
+    status: 400,
+    title: "Agent intent parsing error",
+    suggestion: "Rephrase the request more clearly",
+});
+export const ORCHESTRATION_ERROR = defineError({
+    slug: "orchestration-error",
+    category: "AGENT",
+    status: 500,
+    title: "Multi-agent orchestration error",
+    suggestion: "Check agent coordination logic",
+});
+export const COST_LIMIT_EXCEEDED = defineError({
+    slug: "cost-limit-exceeded",
+    category: "AGENT",
+    status: 429,
+    title: "Cost limit exceeded",
+    suggestion: "Wait for the budget period to reset or increase the limit",
+});
+export const TOOL_ID_CONFLICT = defineError({
+    slug: "tool-id-conflict",
+    category: "AGENT",
+    status: 409,
+    title: "Tool ID conflict",
+    suggestion: "Use a unique tool ID or rename one of the conflicting tools",
+});
+/** Registry fragment for AGENT errors (slug → definition). */
+export const AGENT_REGISTRY = {
+    "agent-error": AGENT_ERROR,
+    "agent-not-found": AGENT_NOT_FOUND,
+    "agent-timeout": AGENT_TIMEOUT,
+    "agent-intent-error": AGENT_INTENT_ERROR,
+    "orchestration-error": ORCHESTRATION_ERROR,
+    "cost-limit-exceeded": COST_LIMIT_EXCEEDED,
+    "tool-id-conflict": TOOL_ID_CONFLICT,
+};

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

@@ -0,0 +1,16 @@
+export declare const CLIENT_BOUNDARY_VIOLATION: import("../types.js").RegisteredError;
+export declare const SERVER_ONLY_IN_CLIENT: import("../types.js").RegisteredError;
+export declare const CLIENT_ONLY_IN_SERVER: import("../types.js").RegisteredError;
+export declare const INVALID_USE_CLIENT: import("../types.js").RegisteredError;
+export declare const INVALID_USE_SERVER: import("../types.js").RegisteredError;
+export declare const RSC_PAYLOAD_ERROR: import("../types.js").RegisteredError;
+/** Registry fragment for BOUNDARY errors (slug → definition). */
+export declare const BOUNDARY_REGISTRY: {
+    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;
+};
+//# sourceMappingURL=boundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../../../../src/src/errors/error-registry/boundary.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB,uCAMpC,CAAC;AAEH,eAAO,MAAM,qBAAqB,uCAMhC,CAAC;AAEH,eAAO,MAAM,qBAAqB,uCAMhC,CAAC;AAEH,eAAO,MAAM,kBAAkB,uCAM7B,CAAC;AAEH,eAAO,MAAM,kBAAkB,uCAM7B,CAAC;AAEH,eAAO,MAAM,iBAAiB,uCAM5B,CAAC;AAEH,iEAAiE;AACjE,eAAO,MAAM,iBAAiB;;;;;;;CAOpB,CAAC"}

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

@@ -0,0 +1,52 @@
+import { defineError } from "../types.js";
+export const CLIENT_BOUNDARY_VIOLATION = defineError({
+    slug: "client-boundary-violation",
+    category: "BOUNDARY",
+    status: 400,
+    title: "Client boundary rule violation",
+    suggestion: "Add 'use client' directive or move code to a client component",
+});
+export const SERVER_ONLY_IN_CLIENT = defineError({
+    slug: "server-only-in-client",
+    category: "BOUNDARY",
+    status: 400,
+    title: "Server-only code in client component",
+    suggestion: "Move server-only code to a server component",
+});
+export const CLIENT_ONLY_IN_SERVER = defineError({
+    slug: "client-only-in-server",
+    category: "BOUNDARY",
+    status: 400,
+    title: "Client-only code in server component",
+    suggestion: "Move client-only code to a client component",
+});
+export const INVALID_USE_CLIENT = defineError({
+    slug: "invalid-use-client",
+    category: "BOUNDARY",
+    status: 400,
+    title: "Invalid 'use client' directive",
+    suggestion: "Place 'use client' at the top of the file",
+});
+export const INVALID_USE_SERVER = defineError({
+    slug: "invalid-use-server",
+    category: "BOUNDARY",
+    status: 400,
+    title: "Invalid 'use server' directive",
+    suggestion: "Place 'use server' at the top of the file or function",
+});
+export const RSC_PAYLOAD_ERROR = defineError({
+    slug: "rsc-payload-error",
+    category: "BOUNDARY",
+    status: 500,
+    title: "RSC payload serialization error",
+    suggestion: "Ensure props are serializable (no functions, symbols, etc.)",
+});
+/** Registry fragment for BOUNDARY errors (slug → definition). */
+export const BOUNDARY_REGISTRY = {
+    "client-boundary-violation": CLIENT_BOUNDARY_VIOLATION,
+    "server-only-in-client": SERVER_ONLY_IN_CLIENT,
+    "client-only-in-server": CLIENT_ONLY_IN_SERVER,
+    "invalid-use-client": INVALID_USE_CLIENT,
+    "invalid-use-server": INVALID_USE_SERVER,
+    "rsc-payload-error": RSC_PAYLOAD_ERROR,
+};

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

@@ -0,0 +1,20 @@
+export declare const BUILD_FAILED: import("../types.js").RegisteredError;
+export declare const BUNDLE_ERROR: import("../types.js").RegisteredError;
+export declare const TYPESCRIPT_ERROR: import("../types.js").RegisteredError;
+export declare const MDX_COMPILE_ERROR: import("../types.js").RegisteredError;
+export declare const ASSET_OPTIMIZATION_ERROR: import("../types.js").RegisteredError;
+export declare const SSG_GENERATION_ERROR: import("../types.js").RegisteredError;
+export declare const SOURCEMAP_ERROR: import("../types.js").RegisteredError;
+export declare const COMPILATION_ERROR: import("../types.js").RegisteredError;
+/** Registry fragment for BUILD errors (slug → definition). */
+export declare const BUILD_REGISTRY: {
+    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;
+};
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../src/src/errors/error-registry/build.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,uCAMvB,CAAC;AAEH,eAAO,MAAM,YAAY,uCAMvB,CAAC;AAEH,eAAO,MAAM,gBAAgB,uCAM3B,CAAC;AAEH,eAAO,MAAM,iBAAiB,uCAM5B,CAAC;AAEH,eAAO,MAAM,wBAAwB,uCAMnC,CAAC;AAEH,eAAO,MAAM,oBAAoB,uCAM/B,CAAC;AAEH,eAAO,MAAM,eAAe,uCAM1B,CAAC;AAEH,eAAO,MAAM,iBAAiB,uCAM5B,CAAC;AAEH,8DAA8D;AAC9D,eAAO,MAAM,cAAc;;;;;;;;;CASjB,CAAC"}

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

@@ -0,0 +1,68 @@
+import { defineError } from "../types.js";
+export const BUILD_FAILED = defineError({
+    slug: "build-failed",
+    category: "BUILD",
+    status: 500,
+    title: "Build process failed",
+    suggestion: "Check the build output for specific errors",
+});
+export const BUNDLE_ERROR = defineError({
+    slug: "bundle-error",
+    category: "BUILD",
+    status: 500,
+    title: "Bundle generation failed",
+    suggestion: "Review bundler output for details",
+});
+export const TYPESCRIPT_ERROR = defineError({
+    slug: "typescript-error",
+    category: "BUILD",
+    status: 500,
+    title: "TypeScript compilation error",
+    suggestion: "Fix TypeScript errors shown in the output",
+});
+export const MDX_COMPILE_ERROR = defineError({
+    slug: "mdx-compile-error",
+    category: "BUILD",
+    status: 500,
+    title: "MDX compilation failed",
+    suggestion: "Check your MDX file syntax",
+});
+export const ASSET_OPTIMIZATION_ERROR = defineError({
+    slug: "asset-optimization-error",
+    category: "BUILD",
+    status: 500,
+    title: "Asset optimization failed",
+    suggestion: "Check asset file formats and paths",
+});
+export const SSG_GENERATION_ERROR = defineError({
+    slug: "ssg-generation-error",
+    category: "BUILD",
+    status: 500,
+    title: "Static site generation failed",
+    suggestion: "Review SSG configuration and data fetching",
+});
+export const SOURCEMAP_ERROR = defineError({
+    slug: "sourcemap-error",
+    category: "BUILD",
+    status: 500,
+    title: "Source map generation failed",
+    suggestion: "Check source map configuration",
+});
+export const COMPILATION_ERROR = defineError({
+    slug: "compilation-error",
+    category: "BUILD",
+    status: 500,
+    title: "Compilation failed",
+    suggestion: "Review compiler output for specific errors",
+});
+/** Registry fragment for BUILD errors (slug → definition). */
+export const BUILD_REGISTRY = {
+    "build-failed": BUILD_FAILED,
+    "bundle-error": BUNDLE_ERROR,
+    "typescript-error": TYPESCRIPT_ERROR,
+    "mdx-compile-error": MDX_COMPILE_ERROR,
+    "asset-optimization-error": ASSET_OPTIMIZATION_ERROR,
+    "ssg-generation-error": SSG_GENERATION_ERROR,
+    "sourcemap-error": SOURCEMAP_ERROR,
+    "compilation-error": COMPILATION_ERROR,
+};

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

@@ -0,0 +1,22 @@
+export declare const CONFIG_NOT_FOUND: import("../types.js").RegisteredError;
+export declare const CONFIG_INVALID: import("../types.js").RegisteredError;
+export declare const CONFIG_PARSE_ERROR: import("../types.js").RegisteredError;
+/** Schema-level config validation (e.g. Zod schema mismatch at runtime) */
+export declare const CONFIG_VALIDATION_ERROR: import("../types.js").RegisteredError;
+export declare const CONFIG_TYPE_ERROR: import("../types.js").RegisteredError;
+export declare const IMPORT_MAP_INVALID: import("../types.js").RegisteredError;
+export declare const CORS_CONFIG_INVALID: import("../types.js").RegisteredError;
+/** Config file validation failures (replaces ConfigValidationError) */
+export declare const CONFIG_VALIDATION_FAILED: import("../types.js").RegisteredError;
+/** Registry fragment for CONFIG errors (slug → definition). */
+export declare const CONFIG_REGISTRY: {
+    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;
+};
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/src/errors/error-registry/config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,uCAM3B,CAAC;AAEH,eAAO,MAAM,cAAc,uCAMzB,CAAC;AAEH,eAAO,MAAM,kBAAkB,uCAM7B,CAAC;AAEH,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,uCAMlC,CAAC;AAEH,eAAO,MAAM,iBAAiB,uCAM5B,CAAC;AAEH,eAAO,MAAM,kBAAkB,uCAM7B,CAAC;AAEH,eAAO,MAAM,mBAAmB,uCAM9B,CAAC;AAEH,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,uCAMnC,CAAC;AAEH,+DAA+D;AAC/D,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC"}

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

@@ -0,0 +1,70 @@
+import { defineError } from "../types.js";
+export const CONFIG_NOT_FOUND = defineError({
+    slug: "config-not-found",
+    category: "CONFIG",
+    status: 404,
+    title: "Configuration file not found",
+    suggestion: "Run 'vf init' to create a configuration file",
+});
+export const CONFIG_INVALID = defineError({
+    slug: "config-invalid",
+    category: "CONFIG",
+    status: 400,
+    title: "Invalid configuration format",
+    suggestion: "Check your veryfront.config.ts for syntax errors",
+});
+export const CONFIG_PARSE_ERROR = defineError({
+    slug: "config-parse-error",
+    category: "CONFIG",
+    status: 400,
+    title: "Failed to parse configuration",
+    suggestion: "Ensure your configuration file is valid TypeScript/JSON",
+});
+/** Schema-level config validation (e.g. Zod schema mismatch at runtime) */
+export const CONFIG_VALIDATION_ERROR = defineError({
+    slug: "config-validation-error",
+    category: "CONFIG",
+    status: 422,
+    title: "Configuration validation failed",
+    suggestion: "Check the configuration against the schema requirements",
+});
+export const CONFIG_TYPE_ERROR = defineError({
+    slug: "config-type-error",
+    category: "CONFIG",
+    status: 400,
+    title: "Configuration type mismatch",
+    suggestion: "Ensure configuration values match expected types",
+});
+export const IMPORT_MAP_INVALID = defineError({
+    slug: "import-map-invalid",
+    category: "CONFIG",
+    status: 400,
+    title: "Invalid import map configuration",
+    suggestion: "Check your import map syntax and paths",
+});
+export const CORS_CONFIG_INVALID = defineError({
+    slug: "cors-config-invalid",
+    category: "CONFIG",
+    status: 400,
+    title: "Invalid CORS configuration",
+    suggestion: "Review CORS settings in your configuration",
+});
+/** Config file validation failures (replaces ConfigValidationError) */
+export const CONFIG_VALIDATION_FAILED = defineError({
+    slug: "config-validation-failed",
+    category: "CONFIG",
+    status: 400,
+    title: "Configuration validation failed",
+    suggestion: "Check configuration values against requirements",
+});
+/** Registry fragment for CONFIG errors (slug → definition). */
+export const CONFIG_REGISTRY = {
+    "config-not-found": CONFIG_NOT_FOUND,
+    "config-invalid": CONFIG_INVALID,
+    "config-parse-error": CONFIG_PARSE_ERROR,
+    "config-validation-error": CONFIG_VALIDATION_ERROR,
+    "config-type-error": CONFIG_TYPE_ERROR,
+    "import-map-invalid": IMPORT_MAP_INVALID,
+    "cors-config-invalid": CORS_CONFIG_INVALID,
+    "config-validation-failed": CONFIG_VALIDATION_FAILED,
+};