@zudojs/core 0.0.1

package/dist/contracts/adapter.d.ts

@@ -0,0 +1,44 @@
+import type { Disposable } from "./disposable.js";
+/**
+ * Describes an adapter that connects Zudojs to an
+ * external technology or runtime.
+ *
+ * Examples:
+ *
+ * Fastify
+ * Prisma
+ * Redis
+ * PostgreSQL
+ * Kafka
+ * NATS
+ * S3
+ */
+export interface Adapter<TOptions = unknown> extends Disposable {
+    /**
+     * Unique adapter name.
+     */
+    readonly name: string;
+    /**
+     * Adapter configuration.
+     */
+    readonly options?: TOptions;
+    /**
+     * Initializes the adapter.
+     *
+     * This should prepare the external resource but should not
+     * necessarily start active processing.
+     */
+    initialize(): Promise<void> | void;
+    /**
+     * Starts the adapter.
+     *
+     * For example, an HTTP adapter may start listening on a port,
+     * while a message adapter may begin consuming messages.
+     */
+    start(): Promise<void> | void;
+    /**
+     * Stops the adapter gracefully.
+     */
+    stop(): Promise<void> | void;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/contracts/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/contracts/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAE,SAAQ,UAAU;IAC7D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC;IAE5B;;;;;OAKG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEnC;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9B"}

package/dist/contracts/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/contracts/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/contracts/adapter.ts"],"names":[],"mappings":""}

package/dist/contracts/disposable.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Defines a resource that can be gracefully disposed of.
+ *
+ * Disposable resources may include:
+ *
+ * Database connections
+ * Cache clients
+ * Message brokers
+ * Queue workers
+ * HTTP clients
+ * File handles
+ * External service connections
+ */
+export interface Disposable {
+    /**
+     * Releases resources owned by the implementation.
+     *
+     * Implementations should make this operation idempotent,
+     * meaning calling dispose() more than once should be safe.
+     */
+    dispose(): Promise<void> | void;
+}
+//# sourceMappingURL=disposable.d.ts.map

package/dist/contracts/disposable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposable.d.ts","sourceRoot":"","sources":["../../src/contracts/disposable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjC"}

package/dist/contracts/disposable.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=disposable.js.map

package/dist/contracts/disposable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposable.js","sourceRoot":"","sources":["../../src/contracts/disposable.ts"],"names":[],"mappings":""}

package/dist/contracts/handler.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Represents a generic operation that can be executed by Zudojs.
+ *
+ * A handler receives an input and produces an output.
+ *
+ * Examples:
+ *
+ * HTTP request      → HTTP response
+ * Command           → Command result
+ * Query             → Query result
+ * Job               → Job result
+ * Message           → Processing result
+ * Event             → void
+ */
+export interface Handler<TInput = unknown, TOutput = unknown> {
+    /**
+     * Executes the handler.
+     */
+    handle(input: TInput): Promise<TOutput> | TOutput;
+}
+/**
+ * A function-based handler.
+ *
+ * Useful when creating lightweight handlers without
+ * defining a class.
+ */
+export type HandlerFunction<TInput = unknown, TOutput = unknown> = (input: TInput) => Promise<TOutput> | TOutput;
+/**
+ * Converts a handler function into a Handler object.
+ */
+export declare function createHandler<TInput, TOutput>(handler: HandlerFunction<TInput, TOutput>): Handler<TInput, TOutput>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/contracts/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/contracts/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,OAAO,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC1D;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACnD;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,CACjE,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAEhC;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAC3C,OAAO,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAI1B"}

package/dist/contracts/handler.js

@@ -0,0 +1,9 @@
+/**
+ * Converts a handler function into a Handler object.
+ */
+export function createHandler(handler) {
+    return {
+        handle: handler,
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/contracts/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/contracts/handler.ts"],"names":[],"mappings":"AA+BA;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAyC;IAEzC,OAAO;QACL,MAAM,EAAE,OAAO;KAChB,CAAC;AACJ,CAAC"}

package/dist/contracts/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Core framework contracts.
+ */
+export { type Adapter } from "./adapter.js";
+export { type Handler, type HandlerFunction, createHandler, } from "./handler.js";
+export { type Disposable } from "./disposable.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/contracts/index.js

@@ -0,0 +1,7 @@
+/**
+ * Core framework contracts.
+ */
+export {} from "./adapter.js";
+export { createHandler, } from "./handler.js";
+export {} from "./disposable.js";
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAgB,MAAM,cAAc,CAAC;AAE5C,OAAO,EAGL,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAmB,MAAM,iBAAiB,CAAC"}

package/dist/errors/errorCode.code.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Canonical error codes provided by the Zudojs core.
+ *
+ * Feature-specific packages should define their own error codes
+ * rather than adding every possible application error here.
+ */
+export declare const ErrorCode: {
+    readonly UNKNOWN_ERROR: "CORE_UNKNOWN_ERROR";
+    readonly INTERNAL_ERROR: "CORE_INTERNAL_ERROR";
+    readonly INVALID_ARGUMENT: "CORE_INVALID_ARGUMENT";
+    readonly INVALID_STATE: "CORE_INVALID_STATE";
+    readonly OPERATION_FAILED: "CORE_OPERATION_FAILED";
+    readonly NOT_IMPLEMENTED: "CORE_NOT_IMPLEMENTED";
+    readonly APPLICATION_NOT_INITIALIZED: "CORE_APPLICATION_NOT_INITIALIZED";
+    readonly APPLICATION_ALREADY_INITIALIZED: "CORE_APPLICATION_ALREADY_INITIALIZED";
+    readonly APPLICATION_ALREADY_RUNNING: "CORE_APPLICATION_ALREADY_RUNNING";
+    readonly APPLICATION_NOT_RUNNING: "CORE_APPLICATION_NOT_RUNNING";
+    readonly APPLICATION_START_FAILED: "CORE_APPLICATION_START_FAILED";
+    readonly APPLICATION_STOP_FAILED: "CORE_APPLICATION_STOP_FAILED";
+    readonly PROVIDER_NOT_FOUND: "CORE_PROVIDER_NOT_FOUND";
+    readonly PROVIDER_ALREADY_REGISTERED: "CORE_PROVIDER_ALREADY_REGISTERED";
+    readonly INVALID_PROVIDER: "CORE_INVALID_PROVIDER";
+    readonly DEPENDENCY_RESOLUTION_FAILED: "CORE_DEPENDENCY_RESOLUTION_FAILED";
+    readonly CONFIGURATION_NOT_FOUND: "CORE_CONFIGURATION_NOT_FOUND";
+    readonly CONFIGURATION_INVALID: "CORE_CONFIGURATION_INVALID";
+    readonly CONFIGURATION_INVALID_TYPE: "CORE_CONFIGURATION_INVALID_TYPE";
+    readonly CONFIGURATION_SOURCE_FAILED: "CORE_CONFIGURATION_SOURCE_FAILED";
+    readonly CONFIGURATION_LOAD_FAILED: "CORE_CONFIGURATION_LOAD_FAILED";
+    readonly CONFIGURATION_REQUIRED: "CORE_CONFIGURATION_REQUIRED";
+    readonly CONFIGURATION_CONFLICT: "CORE_CONFIGURATION_CONFLICT";
+    readonly EXECUTION_CONTEXT_NOT_FOUND: "CORE_EXECUTION_CONTEXT_NOT_FOUND";
+    readonly INVALID_EXECUTION_CONTEXT: "CORE_INVALID_EXECUTION_CONTEXT";
+    readonly MODULE_NOT_FOUND: "CORE_MODULE_NOT_FOUND";
+    readonly MODULE_ALREADY_REGISTERED: "CORE_MODULE_ALREADY_REGISTERED";
+    readonly MODULE_INITIALIZATION_FAILED: "CORE_MODULE_INITIALIZATION_FAILED";
+    readonly ADAPTER_NOT_FOUND: "CORE_ADAPTER_NOT_FOUND";
+    readonly ADAPTER_ALREADY_REGISTERED: "CORE_ADAPTER_ALREADY_REGISTERED";
+    readonly ADAPTER_INITIALIZATION_FAILED: "CORE_ADAPTER_INITIALIZATION_FAILED";
+    readonly ADAPTER_START_FAILED: "CORE_ADAPTER_START_FAILED";
+    readonly ADAPTER_STOP_FAILED: "CORE_ADAPTER_STOP_FAILED";
+    readonly MODULE_INVALID_DEFINITION: "CORE_MODULE_INVALID_DEFINITION";
+    readonly MODULE_DUPLICATE: "CORE_MODULE_DUPLICATE";
+    readonly MODULE_INVALID_DEPENDENCY: "CORE_MODULE_INVALID_DEPENDENCY";
+    readonly MODULE_MISSING_DEPENDENCY: "CORE_MODULE_MISSING_DEPENDENCY";
+    readonly MODULE_CIRCULAR_DEPENDENCY: "CORE_MODULE_CIRCULAR_DEPENDENCY";
+    readonly MODULE_VERSION_MISMATCH: "CORE_MODULE_VERSION_MISMATCH";
+    readonly MODULE_LOAD_FAILED: "CORE_MODULE_LOAD_FAILED";
+    readonly MODULE_START_FAILED: "CORE_MODULE_START_FAILED";
+    readonly MODULE_STOP_FAILED: "CORE_MODULE_STOP_FAILED";
+    readonly MODULE_DESTROY_FAILED: "CORE_MODULE_DESTROY_FAILED";
+    readonly MODULE_INVALID_INSTANCE: "CORE_MODULE_INVALID_INSTANCE";
+    readonly MODULE_INVALID_STATE: "CORE_MODULE_INVALID_STATE";
+    readonly MODULE_OPERATION_IN_PROGRESS: "CORE_MODULE_OPERATION_IN_PROGRESS";
+    readonly MODULE_OPERATION_NOT_ALLOWED: "CORE_MODULE_OPERATION_NOT_ALLOWED";
+    readonly MODULE_VALIDATION_FAILED: "CORE_MODULE_VALIDATION_FAILED";
+    readonly RUNTIME_FAILURE: "CORE_RUNTIME_FAILURE";
+    readonly RUNTIME_ALREADY_STARTED: "CORE_RUNTIME_ALREADY_STARTED";
+    readonly RUNTIME_ALREADY_STOPPED: "CORE_RUNTIME_ALREADY_STOPPED";
+    readonly RUNTIME_FAILED: "CORE_RUNTIME_FAILED";
+    readonly RUNTIME_INVALID_TRANSITION: "CORE_RUNTIME_INVALID_TRANSITION";
+    readonly RUNTIME_BOOTSTRAP_FAILED: "CORE_RUNTIME_BOOTSTRAP_FAILED";
+    readonly RUNTIME_BOOTSTRAP_TIMEOUT: "CORE_RUNTIME_BOOTSTRAP_TIMEOUT";
+    readonly RUNTIME_SHUTDOWN_FAILED: "CORE_RUNTIME_SHUTDOWN_FAILED";
+    readonly RUNTIME_SHUTDOWN_TIMEOUT: "CORE_RUNTIME_SHUTDOWN_TIMEOUT";
+    readonly RUNTIME_OPERATION_TIMEOUT: "CORE_RUNTIME_OPERATION_TIMEOUT";
+    readonly RUNTIME_INVALID_CONFIGURATION: "CORE_RUNTIME_INVALID_CONFIGURATION";
+    readonly RUNTIME_MISSING_DEPENDENCY: "CORE_RUNTIME_MISSING_DEPENDENCY";
+    readonly RUNTIME_INVALID_ENVIRONMENT: "CORE_RUNTIME_INVALID_ENVIRONMENT";
+    readonly RUNTIME_NOT_READY: "CORE_RUNTIME_NOT_READY";
+    readonly RUNTIME_UNSUPPORTED_OPERATION: "CORE_RUNTIME_UNSUPPORTED_OPERATION";
+    readonly RUNTIME_OPERATION_CANCELLED: "CORE_RUNTIME_OPERATION_CANCELLED";
+    readonly CONFIGURATION_VALIDATION_FAILED: "CORE_CONFIGURATION_VALIDATION_FAILED";
+};
+/**
+ * Union of all core Zudojs error codes.
+ */
+export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
+//# sourceMappingURL=errorCode.code.d.ts.map

package/dist/errors/errorCode.code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorCode.code.d.ts","sourceRoot":"","sources":["../../src/errors/errorCode.code.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,SAAS;aAEpB,aAAa,EAAE,oBAAoB;aACnC,cAAc,EAAE,qBAAqB;aACrC,gBAAgB,EAAE,uBAAuB;aACzC,aAAa,EAAE,oBAAoB;aACnC,gBAAgB,EAAE,uBAAuB;aACzC,eAAe,EAAE,sBAAsB;aAGvC,2BAA2B,EAAE,kCAAkC;aAC/D,+BAA+B,EAAE,sCAAsC;aACvE,2BAA2B,EAAE,kCAAkC;aAC/D,uBAAuB,EAAE,8BAA8B;aACvD,wBAAwB,EAAE,+BAA+B;aACzD,uBAAuB,EAAE,8BAA8B;aAGvD,kBAAkB,EAAE,yBAAyB;aAC7C,2BAA2B,EAAE,kCAAkC;aAC/D,gBAAgB,EAAE,uBAAuB;aACzC,4BAA4B,EAAE,mCAAmC;aAGjE,uBAAuB,EAAE,8BAA8B;aACvD,qBAAqB,EAAE,4BAA4B;aACnD,0BAA0B,EAAE,iCAAiC;aAC7D,2BAA2B,EAAE,kCAAkC;aAC/D,yBAAyB,EAAE,gCAAgC;aAC3D,sBAAsB,EAAE,6BAA6B;aACrD,sBAAsB,EAAE,6BAA6B;aAGrD,2BAA2B,EAAE,kCAAkC;aAC/D,yBAAyB,EAAE,gCAAgC;aAG3D,gBAAgB,EAAE,uBAAuB;aACzC,yBAAyB,EAAE,gCAAgC;aAC3D,4BAA4B,EAAE,mCAAmC;aAGjE,iBAAiB,EAAE,wBAAwB;aAC3C,0BAA0B,EAAE,iCAAiC;aAC7D,6BAA6B,EAAE,oCAAoC;aACnE,oBAAoB,EAAE,2BAA2B;aACjD,mBAAmB,EAAE,0BAA0B;aAG/C,yBAAyB,EAAE,gCAAgC;aAC3D,gBAAgB,EAAE,uBAAuB;aACzC,yBAAyB,EAAE,gCAAgC;aAC3D,yBAAyB,EAAE,gCAAgC;aAC3D,0BAA0B,EAAE,iCAAiC;aAC7D,uBAAuB,EAAE,8BAA8B;aACvD,kBAAkB,EAAE,yBAAyB;aAC7C,mBAAmB,EAAE,0BAA0B;aAC/C,kBAAkB,EAAE,yBAAyB;aAC7C,qBAAqB,EAAE,4BAA4B;aACnD,uBAAuB,EAAE,8BAA8B;aACvD,oBAAoB,EAAE,2BAA2B;aACjD,4BAA4B,EAAE,mCAAmC;aACjE,4BAA4B,EAAE,mCAAmC;aACjE,wBAAwB,EAAE,+BAA+B;aAGzD,eAAe,EAAE,sBAAsB;aACvC,uBAAuB,EAAE,8BAA8B;aACvD,uBAAuB,EAAE,8BAA8B;aACvD,cAAc,EAAE,qBAAqB;aACrC,0BAA0B,EAAE,iCAAiC;aAC7D,wBAAwB,EAAE,+BAA+B;aACzD,yBAAyB,EAAE,gCAAgC;aAC3D,uBAAuB,EAAE,8BAA8B;aACvD,wBAAwB,EAAE,+BAA+B;aACzD,yBAAyB,EAAE,gCAAgC;aAC3D,6BAA6B,EAAE,oCAAoC;aACnE,0BAA0B,EAAE,iCAAiC;aAC7D,2BAA2B,EAAE,kCAAkC;aAC/D,iBAAiB,EAAE,wBAAwB;aAC3C,6BAA6B,EAAE,oCAAoC;aACnE,2BAA2B,EAAE,kCAAkC;aAG/D,+BAA+B,EAAE,sCAAsC;CAC/D,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC"}

package/dist/errors/errorCode.code.js

@@ -0,0 +1,84 @@
+/**
+ * Canonical error codes provided by the Zudojs core.
+ *
+ * Feature-specific packages should define their own error codes
+ * rather than adding every possible application error here.
+ */
+export const ErrorCode = {
+    // General
+    UNKNOWN_ERROR: "CORE_UNKNOWN_ERROR",
+    INTERNAL_ERROR: "CORE_INTERNAL_ERROR",
+    INVALID_ARGUMENT: "CORE_INVALID_ARGUMENT",
+    INVALID_STATE: "CORE_INVALID_STATE",
+    OPERATION_FAILED: "CORE_OPERATION_FAILED",
+    NOT_IMPLEMENTED: "CORE_NOT_IMPLEMENTED",
+    // Application lifecycle
+    APPLICATION_NOT_INITIALIZED: "CORE_APPLICATION_NOT_INITIALIZED",
+    APPLICATION_ALREADY_INITIALIZED: "CORE_APPLICATION_ALREADY_INITIALIZED",
+    APPLICATION_ALREADY_RUNNING: "CORE_APPLICATION_ALREADY_RUNNING",
+    APPLICATION_NOT_RUNNING: "CORE_APPLICATION_NOT_RUNNING",
+    APPLICATION_START_FAILED: "CORE_APPLICATION_START_FAILED",
+    APPLICATION_STOP_FAILED: "CORE_APPLICATION_STOP_FAILED",
+    // Dependency Injection
+    PROVIDER_NOT_FOUND: "CORE_PROVIDER_NOT_FOUND",
+    PROVIDER_ALREADY_REGISTERED: "CORE_PROVIDER_ALREADY_REGISTERED",
+    INVALID_PROVIDER: "CORE_INVALID_PROVIDER",
+    DEPENDENCY_RESOLUTION_FAILED: "CORE_DEPENDENCY_RESOLUTION_FAILED",
+    // Configuration
+    CONFIGURATION_NOT_FOUND: "CORE_CONFIGURATION_NOT_FOUND",
+    CONFIGURATION_INVALID: "CORE_CONFIGURATION_INVALID",
+    CONFIGURATION_INVALID_TYPE: "CORE_CONFIGURATION_INVALID_TYPE",
+    CONFIGURATION_SOURCE_FAILED: "CORE_CONFIGURATION_SOURCE_FAILED",
+    CONFIGURATION_LOAD_FAILED: "CORE_CONFIGURATION_LOAD_FAILED",
+    CONFIGURATION_REQUIRED: "CORE_CONFIGURATION_REQUIRED",
+    CONFIGURATION_CONFLICT: "CORE_CONFIGURATION_CONFLICT",
+    // Context
+    EXECUTION_CONTEXT_NOT_FOUND: "CORE_EXECUTION_CONTEXT_NOT_FOUND",
+    INVALID_EXECUTION_CONTEXT: "CORE_INVALID_EXECUTION_CONTEXT",
+    // Modules
+    MODULE_NOT_FOUND: "CORE_MODULE_NOT_FOUND",
+    MODULE_ALREADY_REGISTERED: "CORE_MODULE_ALREADY_REGISTERED",
+    MODULE_INITIALIZATION_FAILED: "CORE_MODULE_INITIALIZATION_FAILED",
+    // Adapters
+    ADAPTER_NOT_FOUND: "CORE_ADAPTER_NOT_FOUND",
+    ADAPTER_ALREADY_REGISTERED: "CORE_ADAPTER_ALREADY_REGISTERED",
+    ADAPTER_INITIALIZATION_FAILED: "CORE_ADAPTER_INITIALIZATION_FAILED",
+    ADAPTER_START_FAILED: "CORE_ADAPTER_START_FAILED",
+    ADAPTER_STOP_FAILED: "CORE_ADAPTER_STOP_FAILED",
+    // Module lifecycle
+    MODULE_INVALID_DEFINITION: "CORE_MODULE_INVALID_DEFINITION",
+    MODULE_DUPLICATE: "CORE_MODULE_DUPLICATE",
+    MODULE_INVALID_DEPENDENCY: "CORE_MODULE_INVALID_DEPENDENCY",
+    MODULE_MISSING_DEPENDENCY: "CORE_MODULE_MISSING_DEPENDENCY",
+    MODULE_CIRCULAR_DEPENDENCY: "CORE_MODULE_CIRCULAR_DEPENDENCY",
+    MODULE_VERSION_MISMATCH: "CORE_MODULE_VERSION_MISMATCH",
+    MODULE_LOAD_FAILED: "CORE_MODULE_LOAD_FAILED",
+    MODULE_START_FAILED: "CORE_MODULE_START_FAILED",
+    MODULE_STOP_FAILED: "CORE_MODULE_STOP_FAILED",
+    MODULE_DESTROY_FAILED: "CORE_MODULE_DESTROY_FAILED",
+    MODULE_INVALID_INSTANCE: "CORE_MODULE_INVALID_INSTANCE",
+    MODULE_INVALID_STATE: "CORE_MODULE_INVALID_STATE",
+    MODULE_OPERATION_IN_PROGRESS: "CORE_MODULE_OPERATION_IN_PROGRESS",
+    MODULE_OPERATION_NOT_ALLOWED: "CORE_MODULE_OPERATION_NOT_ALLOWED",
+    MODULE_VALIDATION_FAILED: "CORE_MODULE_VALIDATION_FAILED",
+    // Runtime
+    RUNTIME_FAILURE: "CORE_RUNTIME_FAILURE",
+    RUNTIME_ALREADY_STARTED: "CORE_RUNTIME_ALREADY_STARTED",
+    RUNTIME_ALREADY_STOPPED: "CORE_RUNTIME_ALREADY_STOPPED",
+    RUNTIME_FAILED: "CORE_RUNTIME_FAILED",
+    RUNTIME_INVALID_TRANSITION: "CORE_RUNTIME_INVALID_TRANSITION",
+    RUNTIME_BOOTSTRAP_FAILED: "CORE_RUNTIME_BOOTSTRAP_FAILED",
+    RUNTIME_BOOTSTRAP_TIMEOUT: "CORE_RUNTIME_BOOTSTRAP_TIMEOUT",
+    RUNTIME_SHUTDOWN_FAILED: "CORE_RUNTIME_SHUTDOWN_FAILED",
+    RUNTIME_SHUTDOWN_TIMEOUT: "CORE_RUNTIME_SHUTDOWN_TIMEOUT",
+    RUNTIME_OPERATION_TIMEOUT: "CORE_RUNTIME_OPERATION_TIMEOUT",
+    RUNTIME_INVALID_CONFIGURATION: "CORE_RUNTIME_INVALID_CONFIGURATION",
+    RUNTIME_MISSING_DEPENDENCY: "CORE_RUNTIME_MISSING_DEPENDENCY",
+    RUNTIME_INVALID_ENVIRONMENT: "CORE_RUNTIME_INVALID_ENVIRONMENT",
+    RUNTIME_NOT_READY: "CORE_RUNTIME_NOT_READY",
+    RUNTIME_UNSUPPORTED_OPERATION: "CORE_RUNTIME_UNSUPPORTED_OPERATION",
+    RUNTIME_OPERATION_CANCELLED: "CORE_RUNTIME_OPERATION_CANCELLED",
+    // Configuration validation
+    CONFIGURATION_VALIDATION_FAILED: "CORE_CONFIGURATION_VALIDATION_FAILED",
+};
+//# sourceMappingURL=errorCode.code.js.map

package/dist/errors/errorCode.code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorCode.code.js","sourceRoot":"","sources":["../../src/errors/errorCode.code.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU;IACV,aAAa,EAAE,oBAAoB;IACnC,cAAc,EAAE,qBAAqB;IACrC,gBAAgB,EAAE,uBAAuB;IACzC,aAAa,EAAE,oBAAoB;IACnC,gBAAgB,EAAE,uBAAuB;IACzC,eAAe,EAAE,sBAAsB;IAEvC,wBAAwB;IACxB,2BAA2B,EAAE,kCAAkC;IAC/D,+BAA+B,EAAE,sCAAsC;IACvE,2BAA2B,EAAE,kCAAkC;IAC/D,uBAAuB,EAAE,8BAA8B;IACvD,wBAAwB,EAAE,+BAA+B;IACzD,uBAAuB,EAAE,8BAA8B;IAEvD,uBAAuB;IACvB,kBAAkB,EAAE,yBAAyB;IAC7C,2BAA2B,EAAE,kCAAkC;IAC/D,gBAAgB,EAAE,uBAAuB;IACzC,4BAA4B,EAAE,mCAAmC;IAEjE,gBAAgB;IAChB,uBAAuB,EAAE,8BAA8B;IACvD,qBAAqB,EAAE,4BAA4B;IACnD,0BAA0B,EAAE,iCAAiC;IAC7D,2BAA2B,EAAE,kCAAkC;IAC/D,yBAAyB,EAAE,gCAAgC;IAC3D,sBAAsB,EAAE,6BAA6B;IACrD,sBAAsB,EAAE,6BAA6B;IAErD,UAAU;IACV,2BAA2B,EAAE,kCAAkC;IAC/D,yBAAyB,EAAE,gCAAgC;IAE3D,UAAU;IACV,gBAAgB,EAAE,uBAAuB;IACzC,yBAAyB,EAAE,gCAAgC;IAC3D,4BAA4B,EAAE,mCAAmC;IAEjE,WAAW;IACX,iBAAiB,EAAE,wBAAwB;IAC3C,0BAA0B,EAAE,iCAAiC;IAC7D,6BAA6B,EAAE,oCAAoC;IACnE,oBAAoB,EAAE,2BAA2B;IACjD,mBAAmB,EAAE,0BAA0B;IAE/C,mBAAmB;IACnB,yBAAyB,EAAE,gCAAgC;IAC3D,gBAAgB,EAAE,uBAAuB;IACzC,yBAAyB,EAAE,gCAAgC;IAC3D,yBAAyB,EAAE,gCAAgC;IAC3D,0BAA0B,EAAE,iCAAiC;IAC7D,uBAAuB,EAAE,8BAA8B;IACvD,kBAAkB,EAAE,yBAAyB;IAC7C,mBAAmB,EAAE,0BAA0B;IAC/C,kBAAkB,EAAE,yBAAyB;IAC7C,qBAAqB,EAAE,4BAA4B;IACnD,uBAAuB,EAAE,8BAA8B;IACvD,oBAAoB,EAAE,2BAA2B;IACjD,4BAA4B,EAAE,mCAAmC;IACjE,4BAA4B,EAAE,mCAAmC;IACjE,wBAAwB,EAAE,+BAA+B;IAEzD,UAAU;IACV,eAAe,EAAE,sBAAsB;IACvC,uBAAuB,EAAE,8BAA8B;IACvD,uBAAuB,EAAE,8BAA8B;IACvD,cAAc,EAAE,qBAAqB;IACrC,0BAA0B,EAAE,iCAAiC;IAC7D,wBAAwB,EAAE,+BAA+B;IACzD,yBAAyB,EAAE,gCAAgC;IAC3D,uBAAuB,EAAE,8BAA8B;IACvD,wBAAwB,EAAE,+BAA+B;IACzD,yBAAyB,EAAE,gCAAgC;IAC3D,6BAA6B,EAAE,oCAAoC;IACnE,0BAA0B,EAAE,iCAAiC;IAC7D,2BAA2B,EAAE,kCAAkC;IAC/D,iBAAiB,EAAE,wBAAwB;IAC3C,6BAA6B,EAAE,oCAAoC;IACnE,2BAA2B,EAAE,kCAAkC;IAE/D,2BAA2B;IAC3B,+BAA+B,EAAE,sCAAsC;CAC/D,CAAC"}

package/dist/errors/exceptions.d.ts

@@ -0,0 +1,52 @@
+import { FrameworkError } from "./frameworkError.error.js";
+/**
+ * Thrown when an invalid argument is supplied to a framework operation.
+ */
+export declare class InvalidArgumentError extends FrameworkError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Thrown when an operation is attempted while the application
+ * is in an incompatible lifecycle state.
+ */
+export declare class InvalidStateError extends FrameworkError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Thrown when a requested dependency provider cannot be found.
+ */
+export declare class ProviderNotFoundError extends FrameworkError {
+    constructor(token: unknown);
+}
+/**
+ * Thrown when attempting to register a provider for an already
+ * registered token.
+ */
+export declare class ProviderAlreadyRegisteredError extends FrameworkError {
+    constructor(token: unknown);
+}
+/**
+ * Thrown when configuration is required but cannot be found.
+ */
+export declare class ConfigurationNotFoundError extends FrameworkError {
+    constructor(path: string);
+}
+/**
+ * Thrown when no execution context is available.
+ */
+export declare class ExecutionContextNotFoundError extends FrameworkError {
+    constructor();
+}
+/**
+ * Thrown when a requested module cannot be found.
+ */
+export declare class ModuleNotFoundError extends FrameworkError {
+    constructor(moduleName: string);
+}
+/**
+ * Thrown when an adapter cannot be found.
+ */
+export declare class AdapterNotFoundError extends FrameworkError {
+    constructor(adapterName: string);
+}
+//# sourceMappingURL=exceptions.d.ts.map

package/dist/errors/exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../../src/errors/exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;IACtD,YAAmB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAOpD;CACF;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;IACnD,YAAmB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAOpD;CACF;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,cAAc;IACvD,YAAmB,KAAK,EAAE,OAAO,EAShC;CACF;AAED;;;GAGG;AACH,qBAAa,8BAA+B,SAAQ,cAAc;IAChE,YAAmB,KAAK,EAAE,OAAO,EAYhC;CACF;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,cAAc;IAC5D,YAAmB,IAAI,EAAE,MAAM,EAS9B;CACF;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,cAAc;IAC/D,cAMC;CACF;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,YAAmB,UAAU,EAAE,MAAM,EASpC;CACF;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;IACtD,YAAmB,WAAW,EAAE,MAAM,EASrC;CACF"}

package/dist/errors/exceptions.js

@@ -0,0 +1,125 @@
+import { FrameworkError } from "./frameworkError.error.js";
+import { ErrorCode } from "./errorCode.code.js";
+/**
+ * Thrown when an invalid argument is supplied to a framework operation.
+ */
+export class InvalidArgumentError extends FrameworkError {
+    constructor(message, details) {
+        super(message, {
+            code: ErrorCode.INVALID_ARGUMENT,
+            details,
+        });
+        this.name = "InvalidArgumentError";
+    }
+}
+/**
+ * Thrown when an operation is attempted while the application
+ * is in an incompatible lifecycle state.
+ */
+export class InvalidStateError extends FrameworkError {
+    constructor(message, details) {
+        super(message, {
+            code: ErrorCode.INVALID_STATE,
+            details,
+        });
+        this.name = "InvalidStateError";
+    }
+}
+/**
+ * Thrown when a requested dependency provider cannot be found.
+ */
+export class ProviderNotFoundError extends FrameworkError {
+    constructor(token) {
+        super(`No provider registered for token "${describeToken(token)}".`, {
+            code: ErrorCode.PROVIDER_NOT_FOUND,
+            details: {
+                token: describeToken(token),
+            },
+        });
+        this.name = "ProviderNotFoundError";
+    }
+}
+/**
+ * Thrown when attempting to register a provider for an already
+ * registered token.
+ */
+export class ProviderAlreadyRegisteredError extends FrameworkError {
+    constructor(token) {
+        super(`A provider is already registered for token "${describeToken(token)}".`, {
+            code: ErrorCode.PROVIDER_ALREADY_REGISTERED,
+            details: {
+                token: describeToken(token),
+            },
+        });
+        this.name = "ProviderAlreadyRegisteredError";
+    }
+}
+/**
+ * Thrown when configuration is required but cannot be found.
+ */
+export class ConfigurationNotFoundError extends FrameworkError {
+    constructor(path) {
+        super(`Required configuration "${path}" was not found.`, {
+            code: ErrorCode.CONFIGURATION_NOT_FOUND,
+            details: {
+                path,
+            },
+        });
+        this.name = "ConfigurationNotFoundError";
+    }
+}
+/**
+ * Thrown when no execution context is available.
+ */
+export class ExecutionContextNotFoundError extends FrameworkError {
+    constructor() {
+        super("No active execution context is available.", {
+            code: ErrorCode.EXECUTION_CONTEXT_NOT_FOUND,
+        });
+        this.name = "ExecutionContextNotFoundError";
+    }
+}
+/**
+ * Thrown when a requested module cannot be found.
+ */
+export class ModuleNotFoundError extends FrameworkError {
+    constructor(moduleName) {
+        super(`Module "${moduleName}" is not registered.`, {
+            code: ErrorCode.MODULE_NOT_FOUND,
+            details: {
+                module: moduleName,
+            },
+        });
+        this.name = "ModuleNotFoundError";
+    }
+}
+/**
+ * Thrown when an adapter cannot be found.
+ */
+export class AdapterNotFoundError extends FrameworkError {
+    constructor(adapterName) {
+        super(`Adapter "${adapterName}" is not registered.`, {
+            code: ErrorCode.ADAPTER_NOT_FOUND,
+            details: {
+                adapter: adapterName,
+            },
+        });
+        this.name = "AdapterNotFoundError";
+    }
+}
+/**
+ * Creates a readable representation of a dependency token.
+ */
+function describeToken(token) {
+    if (typeof token === "string") {
+        return token;
+    }
+    if (typeof token === "symbol") {
+        return token.description ?? token.toString();
+    }
+    if (typeof token === "function") {
+        return token.name || "anonymous class";
+    }
+    return String(token);
+}
+//# sourceMappingURL=exceptions.js.map

package/dist/errors/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../../src/errors/exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,cAAc;IACtD,YAAmB,OAAe,EAAE,OAAiB;QACnD,KAAK,CAAC,OAAO,EAAE;YACb,IAAI,EAAE,SAAS,CAAC,gBAAgB;YAChC,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,cAAc;IACnD,YAAmB,OAAe,EAAE,OAAiB;QACnD,KAAK,CAAC,OAAO,EAAE;YACb,IAAI,EAAE,SAAS,CAAC,aAAa;YAC7B,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,cAAc;IACvD,YAAmB,KAAc;QAC/B,KAAK,CAAC,qCAAqC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE;YACnE,IAAI,EAAE,SAAS,CAAC,kBAAkB;YAClC,OAAO,EAAE;gBACP,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC;aAC5B;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,8BAA+B,SAAQ,cAAc;IAChE,YAAmB,KAAc;QAC/B,KAAK,CACH,+CAA+C,aAAa,CAAC,KAAK,CAAC,IAAI,EACvE;YACE,IAAI,EAAE,SAAS,CAAC,2BAA2B;YAC3C,OAAO,EAAE;gBACP,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC;aAC5B;SACF,CACF,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC/C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,cAAc;IAC5D,YAAmB,IAAY;QAC7B,KAAK,CAAC,2BAA2B,IAAI,kBAAkB,EAAE;YACvD,IAAI,EAAE,SAAS,CAAC,uBAAuB;YACvC,OAAO,EAAE;gBACP,IAAI;aACL;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,6BAA8B,SAAQ,cAAc;IAC/D;QACE,KAAK,CAAC,2CAA2C,EAAE;YACjD,IAAI,EAAE,SAAS,CAAC,2BAA2B;SAC5C,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACrD,YAAmB,UAAkB;QACnC,KAAK,CAAC,WAAW,UAAU,sBAAsB,EAAE;YACjD,IAAI,EAAE,SAAS,CAAC,gBAAgB;YAChC,OAAO,EAAE;gBACP,MAAM,EAAE,UAAU;aACnB;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,cAAc;IACtD,YAAmB,WAAmB;QACpC,KAAK,CAAC,YAAY,WAAW,sBAAsB,EAAE;YACnD,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,OAAO,EAAE;gBACP,OAAO,EAAE,WAAW;aACrB;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,IAAI,IAAI,iBAAiB,CAAC;IACzC,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/errors/frameworkError.error.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Base error type for all Zudojs framework errors.
+ *
+ * FrameworkError extends ApplicationError from @zudojs/errors
+ * to maintain backward compatibility while providing structured
+ * error information for HTTP handlers, logging, and observability.
+ */
+import { ApplicationError, type SerializedBaseError } from "@zudojs/errors";
+/**
+ * Options accepted by FrameworkError.
+ */
+export interface FrameworkErrorOptions {
+    readonly code?: string;
+    readonly details?: unknown;
+    readonly status?: number;
+    readonly cause?: unknown;
+}
+/**
+ * Serializable representation of a FrameworkError.
+ */
+export interface FrameworkErrorJSON {
+    readonly name: string;
+    readonly message: string;
+    readonly code: string;
+    readonly status?: number;
+    readonly details?: unknown;
+}
+/**
+ * Base error class for all Zudojs framework errors.
+ *
+ * FrameworkError extends ApplicationError from @zudojs/errors
+ * so all framework errors inherit BaseError properties (code,
+ * category, severity, statusCode, metadata, serialization).
+ */
+export declare class FrameworkError extends ApplicationError {
+    /**
+     * Optional structured details associated with the error.
+     */
+    readonly details?: unknown;
+    /**
+     * Creates a framework error.
+     */
+    constructor(message: string, options?: FrameworkErrorOptions);
+    /**
+     * Converts the error into a structured representation.
+     */
+    toJSON(): SerializedBaseError & {
+        readonly details?: unknown;
+    };
+}
+//# sourceMappingURL=frameworkError.error.d.ts.map

package/dist/errors/frameworkError.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworkError.error.d.ts","sourceRoot":"","sources":["../../src/errors/frameworkError.error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,gBAAgB;IAClD;;OAEG;IACH,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElC;;OAEG;IACH,YAAmB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,EAStE;IAED;;OAEG;IACa,MAAM,IAAI,mBAAmB,GAAG;QAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;KAC5B,CAgBA;CACF"}

package/dist/errors/frameworkError.error.js

@@ -0,0 +1,54 @@
+/**
+ * Base error type for all Zudojs framework errors.
+ *
+ * FrameworkError extends ApplicationError from @zudojs/errors
+ * to maintain backward compatibility while providing structured
+ * error information for HTTP handlers, logging, and observability.
+ */
+import { ApplicationError } from "@zudojs/errors";
+/**
+ * Base error class for all Zudojs framework errors.
+ *
+ * FrameworkError extends ApplicationError from @zudojs/errors
+ * so all framework errors inherit BaseError properties (code,
+ * category, severity, statusCode, metadata, serialization).
+ */
+export class FrameworkError extends ApplicationError {
+    /**
+     * Optional structured details associated with the error.
+     */
+    details;
+    /**
+     * Creates a framework error.
+     */
+    constructor(message, options = {}) {
+        super(message, {
+            code: options.code,
+            statusCode: options.status,
+            cause: options.cause,
+        });
+        this.name = "FrameworkError";
+        this.details = options.details;
+    }
+    /**
+     * Converts the error into a structured representation.
+     */
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            name: this.name,
+            message: this.message,
+            code: String(this.code),
+            category: this.category,
+            severity: this.severity,
+            statusCode: this.statusCode,
+            expose: this.expose,
+            isOperational: this.isOperational,
+            metadata: this.metadata,
+            ...(this.details !== undefined && {
+                details: this.details,
+            }),
+        };
+    }
+}
+//# sourceMappingURL=frameworkError.error.js.map

package/dist/errors/frameworkError.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworkError.error.js","sourceRoot":"","sources":["../../src/errors/frameworkError.error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAA4B,MAAM,gBAAgB,CAAC;AAuB5E;;;;;;GAMG;AACH,MAAM,OAAO,cAAe,SAAQ,gBAAgB;IAClD;;OAEG;IACa,OAAO,CAAW;IAElC;;OAEG;IACH,YAAmB,OAAe,EAAE,OAAO,GAA0B,EAAE;QACrE,KAAK,CAAC,OAAO,EAAE;YACb,IAAI,EAAE,OAAO,CAAC,IAAW;YACzB,UAAU,EAAE,OAAO,CAAC,MAAM;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED;;OAEG;IACa,MAAM;QAGpB,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI;gBAChC,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC;SACH,CAAC;IACJ,CAAC;CACF"}