@zudojs/errors 0.0.1

package/dist/infrastructure/network/httpServerLifecycleError.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpServerLifecycleError.types.js","sourceRoot":"","sources":["../../../src/infrastructure/network/httpServerLifecycleError.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAE9E;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,wBAAwB;IACvE,gCAAgC;IAChB,KAAK,CAAS;IAE9B,YAAY,KAAa,EAAE,SAAiB;QAC1C,KAAK,CAAC,UAAU,SAAS,gCAAgC,KAAK,UAAU,EAAE;YACxE,IAAI,EAAE,SAAS,CAAC,yBAAyB;YACzC,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;SAC/B,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,wBAAwB;IAChE,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE;YACb,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,KAAK;SACN,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,wBAAwB;IAC/D,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE;YACb,IAAI,EAAE,SAAS,CAAC,gBAAgB;YAChC,KAAK;SACN,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/infrastructure/network/httpStream.error.d.ts

@@ -0,0 +1,24 @@
+import { BaseError } from "../../base/core/baseError.core.js";
+import type { BaseErrorOptions } from "../../base/types/baseError.type.js";
+import { ErrorCategory } from "../../base/types/errorCategory.type.js";
+/**
+ * Options for creating an HTTP stream error.
+ */
+export interface HttpStreamErrorOptions extends Omit<BaseErrorOptions, "category"> {
+    readonly category?: ErrorCategory;
+}
+/**
+ * Base error class for HTTP stream errors.
+ */
+export declare class HttpStreamError extends BaseError {
+    constructor(message: string, options?: HttpStreamErrorOptions);
+}
+/**
+ * Creates an HTTP stream error.
+ */
+export declare function createHttpStreamError(message: string, options?: HttpStreamErrorOptions): HttpStreamError;
+/**
+ * Determines whether an unknown value is an HttpStreamError.
+ */
+export declare function isHttpStreamError(value: unknown): value is HttpStreamError;
+//# sourceMappingURL=httpStream.error.d.ts.map

package/dist/infrastructure/network/httpStream.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpStream.error.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/network/httpStream.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAI3E,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAIvE;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAClD,gBAAgB,EAChB,UAAU,CACX;IACC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,EAWhE;CACF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAEjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E"}

package/dist/infrastructure/network/httpStream.error.js

@@ -0,0 +1,33 @@
+import { BaseError } from "../../base/core/baseError.core.js";
+import { ErrorCode } from "../../base/types/errorCode.type.js";
+import { ErrorCategory } from "../../base/types/errorCategory.type.js";
+import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
+/**
+ * Base error class for HTTP stream errors.
+ */
+export class HttpStreamError extends BaseError {
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            code: options.code ?? ErrorCode.HTTP_STREAM,
+            category: options.category ?? ErrorCategory.NETWORK,
+            severity: options.severity ?? ErrorSeverity.ERROR,
+            statusCode: options.statusCode ?? 500,
+            expose: options.expose ?? false,
+        });
+        this.name = "HttpStreamError";
+    }
+}
+/**
+ * Creates an HTTP stream error.
+ */
+export function createHttpStreamError(message, options = {}) {
+    return new HttpStreamError(message, options);
+}
+/**
+ * Determines whether an unknown value is an HttpStreamError.
+ */
+export function isHttpStreamError(value) {
+    return value instanceof HttpStreamError;
+}
+//# sourceMappingURL=httpStream.error.js.map

package/dist/infrastructure/network/httpStream.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpStream.error.js","sourceRoot":"","sources":["../../../src/infrastructure/network/httpStream.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAG9D,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAYvE;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C,YAAY,OAAe,EAAE,OAAO,GAA2B,EAAE;QAC/D,KAAK,CAAC,OAAO,EAAE;YACb,GAAG,OAAO;YACV,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC,WAAW;YAC3C,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC,OAAO;YACnD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC,KAAK;YACjD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;YACrC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;SAChC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,OAAO,GAA2B,EAAE;IAEpC,OAAO,IAAI,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,YAAY,eAAe,CAAC;AAC1C,CAAC"}

package/dist/infrastructure/network/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @zudojs/errors/infrastructure/network
+ *
+ * Network, HTTP, and timeout error types.
+ */
+export * from "./network.error.js";
+export * from "./http.error.js";
+export * from "./httpClientError.error.js";
+export * from "./httpClient.errors.js";
+export * from "./httpServerError.error.js";
+export * from "./timeout.error.js";
+export * from "./httpRouter.error.js";
+export * from "./httpAdapter.error.js";
+export * from "./httpServerLifecycle.error.js";
+export * from "./httpStream.error.js";
+export * from "./httpResponse.error.js";
+export * from "./routePattern.error.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/network/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/network/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/dist/infrastructure/network/index.js

@@ -0,0 +1,18 @@
+/**
+ * @zudojs/errors/infrastructure/network
+ *
+ * Network, HTTP, and timeout error types.
+ */
+export * from "./network.error.js";
+export * from "./http.error.js";
+export * from "./httpClientError.error.js";
+export * from "./httpClient.errors.js";
+export * from "./httpServerError.error.js";
+export * from "./timeout.error.js";
+export * from "./httpRouter.error.js";
+export * from "./httpAdapter.error.js";
+export * from "./httpServerLifecycle.error.js";
+export * from "./httpStream.error.js";
+export * from "./httpResponse.error.js";
+export * from "./routePattern.error.js";
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/network/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/network/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/dist/infrastructure/network/network.error.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Network error classes — re-exports from focused files.
+ */
+export { NetworkError, createNetworkError, isNetworkError, } from "./networkError.base.js";
+export type { NetworkErrorOptions } from "./networkError.base.js";
+export { connectionFailedError, networkTimeoutError, externalServiceUnavailableError, } from "./networkError.factory.js";
+//# sourceMappingURL=network.error.d.ts.map

package/dist/infrastructure/network/network.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.error.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/network/network.error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,GACf,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,+BAA+B,GAChC,MAAM,2BAA2B,CAAC"}

package/dist/infrastructure/network/network.error.js

@@ -0,0 +1,6 @@
+/**
+ * Network error classes — re-exports from focused files.
+ */
+export { NetworkError, createNetworkError, isNetworkError, } from "./networkError.base.js";
+export { connectionFailedError, networkTimeoutError, externalServiceUnavailableError, } from "./networkError.factory.js";
+//# sourceMappingURL=network.error.js.map

package/dist/infrastructure/network/network.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.error.js","sourceRoot":"","sources":["../../../src/infrastructure/network/network.error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,GACf,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,+BAA+B,GAChC,MAAM,2BAA2B,CAAC"}

package/dist/infrastructure/network/networkError.base.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Base NetworkError class, options, and factory functions.
+ */
+import { BaseError } from "../../base/core/baseError.core.js";
+import type { BaseErrorOptions } from "../../base/types/baseError.type.js";
+import { ErrorCategory } from "../../base/types/errorCategory.type.js";
+import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
+/** Options for creating a network error. */
+export interface NetworkErrorOptions extends Omit<BaseErrorOptions, "category"> {
+    readonly category?: ErrorCategory;
+    readonly endpoint?: string;
+    readonly method?: string;
+    readonly responseStatus?: number;
+    readonly service?: string;
+}
+/** Error raised when a network request or connection fails. */
+export declare class NetworkError extends BaseError {
+    readonly endpoint?: string;
+    readonly method?: string;
+    readonly responseStatus?: number;
+    readonly service?: string;
+    constructor(message?: string, options?: NetworkErrorOptions);
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string;
+        category: ErrorCategory;
+        severity: ErrorSeverity;
+        statusCode: number;
+        expose: boolean;
+        isOperational: boolean;
+        metadata: Readonly<import("../../index.js").ErrorMetadata>;
+        stack?: string;
+        cause?: import("../../base/types/baseError.type.js").SerializedBaseError | unknown;
+        endpoint?: string | undefined;
+        method?: string | undefined;
+        responseStatus?: number | undefined;
+        service?: string | undefined;
+    };
+}
+/** Creates a network error. */
+export declare function createNetworkError(message?: string, options?: NetworkErrorOptions): NetworkError;
+/** Determines whether an unknown value is a NetworkError. */
+export declare function isNetworkError(value: unknown): value is NetworkError;
+//# sourceMappingURL=networkError.base.d.ts.map

package/dist/infrastructure/network/networkError.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkError.base.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/network/networkError.base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,4CAA4C;AAC5C,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAC/C,gBAAgB,EAChB,UAAU,CACX;IACC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,+DAA+D;AAC/D,qBAAa,YAAa,SAAQ,SAAS;IACzC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjC,YACE,OAAO,SAAgC,EACvC,OAAO,GAAE,mBAAwB,EA4BlC;IAEe,MAAM;;;;;;;;;;;;;;;;MAUrB;CACF;AAED,+BAA+B;AAC/B,wBAAgB,kBAAkB,CAChC,OAAO,SAAgC,EACvC,OAAO,GAAE,mBAAwB,GAChC,YAAY,CAEd;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE"}

package/dist/infrastructure/network/networkError.base.js

@@ -0,0 +1,62 @@
+/**
+ * Base NetworkError class, options, and factory functions.
+ */
+import { BaseError } from "../../base/core/baseError.core.js";
+import { ErrorCategory } from "../../base/types/errorCategory.type.js";
+import { ErrorCode } from "../../base/types/errorCode.type.js";
+import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
+/** Error raised when a network request or connection fails. */
+export class NetworkError extends BaseError {
+    endpoint;
+    method;
+    responseStatus;
+    service;
+    constructor(message = "A network operation failed.", options = {}) {
+        super(message, {
+            ...options,
+            code: options.code ?? ErrorCode.NETWORK,
+            category: options.category ?? ErrorCategory.NETWORK,
+            severity: options.severity ?? ErrorSeverity.ERROR,
+            statusCode: options.statusCode ?? 502,
+            expose: options.expose ?? false,
+            isOperational: options.isOperational ?? true,
+            metadata: {
+                ...options.metadata,
+                ...(options.endpoint !== undefined
+                    ? { endpoint: options.endpoint }
+                    : {}),
+                ...(options.method !== undefined
+                    ? { method: options.method.toUpperCase() }
+                    : {}),
+                ...(options.responseStatus !== undefined
+                    ? { responseStatus: options.responseStatus }
+                    : {}),
+                ...(options.service !== undefined ? { service: options.service } : {}),
+            },
+        });
+        this.endpoint = options.endpoint;
+        this.method = options.method?.toUpperCase();
+        this.responseStatus = options.responseStatus;
+        this.service = options.service;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            ...(this.endpoint !== undefined ? { endpoint: this.endpoint } : {}),
+            ...(this.method !== undefined ? { method: this.method } : {}),
+            ...(this.responseStatus !== undefined
+                ? { responseStatus: this.responseStatus }
+                : {}),
+            ...(this.service !== undefined ? { service: this.service } : {}),
+        };
+    }
+}
+/** Creates a network error. */
+export function createNetworkError(message = "A network operation failed.", options = {}) {
+    return new NetworkError(message, options);
+}
+/** Determines whether an unknown value is a NetworkError. */
+export function isNetworkError(value) {
+    return value instanceof NetworkError;
+}
+//# sourceMappingURL=networkError.base.js.map

package/dist/infrastructure/network/networkError.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkError.base.js","sourceRoot":"","sources":["../../../src/infrastructure/network/networkError.base.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/network/networkError.factory.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Network error factory functions.
+ */
+import { NetworkError, type NetworkErrorOptions } from "./networkError.base.js";
+/** Creates a connection failure error. */
+export declare function connectionFailedError(service?: string, options?: Omit<NetworkErrorOptions, "service">): NetworkError;
+/** Creates a network timeout error. */
+export declare function networkTimeoutError(service?: string, options?: Omit<NetworkErrorOptions, "service">): NetworkError;
+/** Creates an error for an unavailable remote service. */
+export declare function externalServiceUnavailableError(service?: string, options?: Omit<NetworkErrorOptions, "service">): NetworkError;
+//# sourceMappingURL=networkError.factory.d.ts.map

package/dist/infrastructure/network/networkError.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkError.factory.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/network/networkError.factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,0CAA0C;AAC1C,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAM,GACjD,YAAY,CAOd;AAED,uCAAuC;AACvC,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAM,GACjD,YAAY,CAad;AAED,0DAA0D;AAC1D,wBAAgB,+BAA+B,CAC7C,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAM,GACjD,YAAY,CAad"}

package/dist/infrastructure/network/networkError.factory.js

@@ -0,0 +1,37 @@
+/**
+ * Network error factory functions.
+ */
+import { ErrorCategory } from "../../base/types/errorCategory.type.js";
+import { ErrorCode } from "../../base/types/errorCode.type.js";
+import { NetworkError } from "./networkError.base.js";
+/** Creates a connection failure error. */
+export function connectionFailedError(service, options = {}) {
+    return new NetworkError(service
+        ? `Unable to connect to ${service}.`
+        : "Unable to establish a network connection.", { ...options, code: ErrorCode.CONNECTION_FAILED, service });
+}
+/** Creates a network timeout error. */
+export function networkTimeoutError(service, options = {}) {
+    return new NetworkError(service
+        ? `The request to ${service} timed out.`
+        : "The network request timed out.", {
+        ...options,
+        code: ErrorCode.TIMEOUT,
+        category: ErrorCategory.TIMEOUT,
+        statusCode: options.statusCode ?? 504,
+        service,
+    });
+}
+/** Creates an error for an unavailable remote service. */
+export function externalServiceUnavailableError(service, options = {}) {
+    return new NetworkError(service
+        ? `${service} is currently unavailable.`
+        : "The external service is currently unavailable.", {
+        ...options,
+        code: ErrorCode.EXTERNAL_SERVICE_UNAVAILABLE,
+        category: ErrorCategory.EXTERNAL_SERVICE,
+        statusCode: options.statusCode ?? 503,
+        service,
+    });
+}
+//# sourceMappingURL=networkError.factory.js.map

package/dist/infrastructure/network/networkError.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkError.factory.js","sourceRoot":"","sources":["../../../src/infrastructure/network/networkError.factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAA4B,MAAM,wBAAwB,CAAC;AAEhF,0CAA0C;AAC1C,MAAM,UAAU,qBAAqB,CACnC,OAAgB,EAChB,OAAO,GAAyC,EAAE;IAElD,OAAO,IAAI,YAAY,CACrB,OAAO;QACL,CAAC,CAAC,wBAAwB,OAAO,GAAG;QACpC,CAAC,CAAC,2CAA2C,EAC/C,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,iBAAiB,EAAE,OAAO,EAAE,CAC3D,CAAC;AACJ,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,mBAAmB,CACjC,OAAgB,EAChB,OAAO,GAAyC,EAAE;IAElD,OAAO,IAAI,YAAY,CACrB,OAAO;QACL,CAAC,CAAC,kBAAkB,OAAO,aAAa;QACxC,CAAC,CAAC,gCAAgC,EACpC;QACE,GAAG,OAAO;QACV,IAAI,EAAE,SAAS,CAAC,OAAO;QACvB,QAAQ,EAAE,aAAa,CAAC,OAAO;QAC/B,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;QACrC,OAAO;KACR,CACF,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,+BAA+B,CAC7C,OAAgB,EAChB,OAAO,GAAyC,EAAE;IAElD,OAAO,IAAI,YAAY,CACrB,OAAO;QACL,CAAC,CAAC,GAAG,OAAO,4BAA4B;QACxC,CAAC,CAAC,gDAAgD,EACpD;QACE,GAAG,OAAO;QACV,IAAI,EAAE,SAAS,CAAC,4BAA4B;QAC5C,QAAQ,EAAE,aAAa,CAAC,gBAAgB;QACxC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;QACrC,OAAO;KACR,CACF,CAAC;AACJ,CAAC"}

package/dist/infrastructure/network/routePattern.error.d.ts

@@ -0,0 +1,44 @@
+import { BaseError } from "../../base/core/baseError.core.js";
+import type { BaseErrorOptions } from "../../base/types/baseError.type.js";
+import { ErrorCategory } from "../../base/types/errorCategory.type.js";
+/**
+ * Options for creating a route pattern error.
+ */
+export interface RoutePatternErrorOptions extends Omit<BaseErrorOptions, "category"> {
+    readonly category?: ErrorCategory;
+    readonly pattern?: string;
+    readonly position?: number;
+}
+/**
+ * Error thrown when a route pattern is invalid.
+ */
+export declare class RoutePatternError extends BaseError {
+    /**
+     * The route pattern that caused the error.
+     */
+    readonly pattern: string;
+    /**
+     * The position in the pattern where the error occurred.
+     */
+    readonly position: number | undefined;
+    constructor(message: string, options?: RoutePatternErrorOptions);
+}
+/**
+ * Error thrown when a duplicate parameter name is found in a route pattern.
+ */
+export declare class DuplicateRouteParameterError extends RoutePatternError {
+    /**
+     * The duplicate parameter name.
+     */
+    readonly paramName: string;
+    constructor(pattern: string, paramName: string);
+}
+/**
+ * Creates a route pattern error.
+ */
+export declare function createRoutePatternError(message: string, options?: RoutePatternErrorOptions): RoutePatternError;
+/**
+ * Determines whether an unknown value is a RoutePatternError.
+ */
+export declare function isRoutePatternError(value: unknown): value is RoutePatternError;
+//# sourceMappingURL=routePattern.error.d.ts.map

package/dist/infrastructure/network/routePattern.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routePattern.error.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/network/routePattern.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAI3E,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAIvE;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CACpD,gBAAgB,EAChB,UAAU,CACX;IACC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C;;OAEG;IACH,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,SAAgB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7C,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,wBAA6B,EAelE;CACF;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,iBAAiB;IACjE;;OAEG;IACH,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,YAAY,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAY7C;CACF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAEnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,iBAAiB,CAE5B"}

package/dist/infrastructure/network/routePattern.error.js

@@ -0,0 +1,63 @@
+import { BaseError } from "../../base/core/baseError.core.js";
+import { ErrorCode } from "../../base/types/errorCode.type.js";
+import { ErrorCategory } from "../../base/types/errorCategory.type.js";
+import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
+/**
+ * Error thrown when a route pattern is invalid.
+ */
+export class RoutePatternError extends BaseError {
+    /**
+     * The route pattern that caused the error.
+     */
+    pattern;
+    /**
+     * The position in the pattern where the error occurred.
+     */
+    position;
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            code: options.code ?? ErrorCode.HTTP_ROUTE_PATTERN,
+            category: options.category ?? ErrorCategory.VALIDATION,
+            severity: options.severity ?? ErrorSeverity.ERROR,
+            statusCode: options.statusCode ?? 400,
+            expose: options.expose ?? true,
+        });
+        this.name = "RoutePatternError";
+        this.pattern = options.pattern ?? "";
+        this.position = options.position;
+    }
+}
+/**
+ * Error thrown when a duplicate parameter name is found in a route pattern.
+ */
+export class DuplicateRouteParameterError extends RoutePatternError {
+    /**
+     * The duplicate parameter name.
+     */
+    paramName;
+    constructor(pattern, paramName) {
+        super(`Duplicate parameter: ${paramName}`, {
+            pattern,
+            code: ErrorCode.HTTP_DUPLICATE_ROUTE_PARAM,
+            metadata: {
+                paramName,
+            },
+        });
+        this.name = "DuplicateRouteParameterError";
+        this.paramName = paramName;
+    }
+}
+/**
+ * Creates a route pattern error.
+ */
+export function createRoutePatternError(message, options = {}) {
+    return new RoutePatternError(message, options);
+}
+/**
+ * Determines whether an unknown value is a RoutePatternError.
+ */
+export function isRoutePatternError(value) {
+    return value instanceof RoutePatternError;
+}
+//# sourceMappingURL=routePattern.error.js.map

package/dist/infrastructure/network/routePattern.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routePattern.error.js","sourceRoot":"","sources":["../../../src/infrastructure/network/routePattern.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAG9D,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAcvE;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C;;OAEG;IACa,OAAO,CAAS;IAEhC;;OAEG;IACa,QAAQ,CAAqB;IAE7C,YAAY,OAAe,EAAE,OAAO,GAA6B,EAAE;QACjE,KAAK,CAAC,OAAO,EAAE;YACb,GAAG,OAAO;YACV,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC,kBAAkB;YAClD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC,UAAU;YACtD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC,KAAK;YACjD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;YACrC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;SAC/B,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAEhC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QAErC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,4BAA6B,SAAQ,iBAAiB;IACjE;;OAEG;IACa,SAAS,CAAS;IAElC,YAAY,OAAe,EAAE,SAAiB;QAC5C,KAAK,CAAC,wBAAwB,SAAS,EAAE,EAAE;YACzC,OAAO;YACP,IAAI,EAAE,SAAS,CAAC,0BAA0B;YAC1C,QAAQ,EAAE;gBACR,SAAS;aACV;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAE3C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,OAAO,GAA6B,EAAE;IAEtC,OAAO,IAAI,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAc;IAEd,OAAO,KAAK,YAAY,iBAAiB,CAAC;AAC5C,CAAC"}

package/dist/infrastructure/network/timeout.error.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Timeout error classes — re-exports from focused files.
+ */
+export { TimeoutError, createTimeoutError, isTimeoutError, TimeoutOperation, } from "./timeoutError.base.js";
+export type { TimeoutErrorOptions } from "./timeoutError.base.js";
+export { requestTimeoutError, databaseTimeoutError, serviceTimeoutError, lockTimeoutError, } from "./timeoutError.factory.js";
+//# sourceMappingURL=timeout.error.d.ts.map

package/dist/infrastructure/network/timeout.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.error.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/network/timeout.error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC"}

package/dist/infrastructure/network/timeout.error.js

@@ -0,0 +1,6 @@
+/**
+ * Timeout error classes — re-exports from focused files.
+ */
+export { TimeoutError, createTimeoutError, isTimeoutError, TimeoutOperation, } from "./timeoutError.base.js";
+export { requestTimeoutError, databaseTimeoutError, serviceTimeoutError, lockTimeoutError, } from "./timeoutError.factory.js";
+//# sourceMappingURL=timeout.error.js.map

package/dist/infrastructure/network/timeout.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.error.js","sourceRoot":"","sources":["../../../src/infrastructure/network/timeout.error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC"}

package/dist/infrastructure/network/timeoutError.base.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Base TimeoutError class, options, and factory functions.
+ */
+import { BaseError } from "../../base/core/baseError.core.js";
+import type { BaseErrorOptions } from "../../base/types/baseError.type.js";
+import { ErrorCategory } from "../../base/types/errorCategory.type.js";
+import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
+/** Timeout operation types used for diagnostics. */
+export declare enum TimeoutOperation {
+    UNKNOWN = "unknown",
+    REQUEST = "request",
+    DATABASE = "database",
+    NETWORK = "network",
+    CACHE = "cache",
+    QUEUE = "queue",
+    JOB = "job",
+    LOCK = "lock",
+    EXTERNAL_SERVICE = "external_service"
+}
+/** Options for creating a timeout error. */
+export interface TimeoutErrorOptions extends Omit<BaseErrorOptions, "category"> {
+    readonly category?: ErrorCategory;
+    readonly operation?: TimeoutOperation;
+    readonly timeoutMs?: number;
+    readonly target?: string;
+}
+/** Error raised when an operation exceeds its allowed execution time. */
+export declare class TimeoutError extends BaseError {
+    readonly operation: TimeoutOperation;
+    readonly timeoutMs?: number;
+    readonly target?: string;
+    constructor(message?: string, options?: TimeoutErrorOptions);
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string;
+        category: ErrorCategory;
+        severity: ErrorSeverity;
+        statusCode: number;
+        expose: boolean;
+        isOperational: boolean;
+        metadata: Readonly<import("../../index.js").ErrorMetadata>;
+        stack?: string;
+        cause?: import("../../base/types/baseError.type.js").SerializedBaseError | unknown;
+        operation: TimeoutOperation;
+        timeoutMs?: number | undefined;
+        target?: string | undefined;
+    };
+}
+/** Creates a timeout error. */
+export declare function createTimeoutError(message?: string, options?: TimeoutErrorOptions): TimeoutError;
+/** Determines whether an unknown value is a TimeoutError. */
+export declare function isTimeoutError(value: unknown): value is TimeoutError;
+//# sourceMappingURL=timeoutError.base.d.ts.map

package/dist/infrastructure/network/timeoutError.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeoutError.base.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/network/timeoutError.base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,oDAAoD;AACpD,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,gBAAgB,qBAAqB;CACtC;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAC/C,gBAAgB,EAChB,UAAU,CACX;IACC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,yEAAyE;AACzE,qBAAa,YAAa,SAAQ,SAAS;IACzC,SAAgB,SAAS,EAAE,gBAAgB,CAAC;IAC5C,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhC,YACE,OAAO,SAA6B,EACpC,OAAO,GAAE,mBAAwB,EAyBlC;IAEe,MAAM;;;;;;;;;;;;;;;MAOrB;CACF;AAED,+BAA+B;AAC/B,wBAAgB,kBAAkB,CAChC,OAAO,SAA6B,EACpC,OAAO,GAAE,mBAAwB,GAChC,YAAY,CAEd;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE"}

package/dist/infrastructure/network/timeoutError.base.js

@@ -0,0 +1,77 @@
+/**
+ * Base TimeoutError class, options, and factory functions.
+ */
+import { BaseError } from "../../base/core/baseError.core.js";
+import { ErrorCategory } from "../../base/types/errorCategory.type.js";
+import { ErrorCode } from "../../base/types/errorCode.type.js";
+import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
+/** Timeout operation types used for diagnostics. */
+export var TimeoutOperation;
+(function (TimeoutOperation) {
+    TimeoutOperation["UNKNOWN"] = "unknown";
+    TimeoutOperation["REQUEST"] = "request";
+    TimeoutOperation["DATABASE"] = "database";
+    TimeoutOperation["NETWORK"] = "network";
+    TimeoutOperation["CACHE"] = "cache";
+    TimeoutOperation["QUEUE"] = "queue";
+    TimeoutOperation["JOB"] = "job";
+    TimeoutOperation["LOCK"] = "lock";
+    TimeoutOperation["EXTERNAL_SERVICE"] = "external_service";
+})(TimeoutOperation || (TimeoutOperation = {}));
+/** Error raised when an operation exceeds its allowed execution time. */
+export class TimeoutError extends BaseError {
+    operation;
+    timeoutMs;
+    target;
+    constructor(message = "The operation timed out.", options = {}) {
+        validateTimeout(options.timeoutMs);
+        super(message, {
+            ...options,
+            code: options.code ?? ErrorCode.TIMEOUT,
+            category: options.category ?? ErrorCategory.TIMEOUT,
+            severity: options.severity ?? ErrorSeverity.WARNING,
+            statusCode: options.statusCode ?? 504,
+            expose: options.expose ?? true,
+            isOperational: options.isOperational ?? true,
+            metadata: {
+                ...options.metadata,
+                ...(options.operation !== undefined
+                    ? { operation: options.operation }
+                    : {}),
+                ...(options.timeoutMs !== undefined
+                    ? { timeoutMs: options.timeoutMs }
+                    : {}),
+                ...(options.target !== undefined ? { target: options.target } : {}),
+            },
+        });
+        this.operation = options.operation ?? TimeoutOperation.UNKNOWN;
+        this.timeoutMs = options.timeoutMs;
+        this.target = options.target;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            operation: this.operation,
+            ...(this.timeoutMs !== undefined ? { timeoutMs: this.timeoutMs } : {}),
+            ...(this.target !== undefined ? { target: this.target } : {}),
+        };
+    }
+}
+/** Creates a timeout error. */
+export function createTimeoutError(message = "The operation timed out.", options = {}) {
+    return new TimeoutError(message, options);
+}
+/** Determines whether an unknown value is a TimeoutError. */
+export function isTimeoutError(value) {
+    return value instanceof TimeoutError;
+}
+/** Validates a timeout duration. */
+function validateTimeout(timeoutMs) {
+    if (timeoutMs === undefined) {
+        return;
+    }
+    if (!Number.isFinite(timeoutMs) || timeoutMs < 0) {
+        throw new RangeError("timeoutMs must be a finite non-negative number.");
+    }
+}
+//# sourceMappingURL=timeoutError.base.js.map

package/dist/infrastructure/network/timeoutError.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeoutError.base.js","sourceRoot":"","sources":["../../../src/infrastructure/network/timeoutError.base.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/network/timeoutError.factory.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Timeout error factory functions for specific operations.
+ */
+import { TimeoutError } from "./timeoutError.base.js";
+/** Creates a request timeout error. */
+export declare function requestTimeoutError(timeoutMs?: number, target?: string): TimeoutError;
+/** Creates a database timeout error. */
+export declare function databaseTimeoutError(timeoutMs?: number, target?: string): TimeoutError;
+/** Creates an external-service timeout error. */
+export declare function serviceTimeoutError(target?: string, timeoutMs?: number): TimeoutError;
+/** Creates a lock acquisition timeout error. */
+export declare function lockTimeoutError(target?: string, timeoutMs?: number): TimeoutError;
+//# sourceMappingURL=timeoutError.factory.d.ts.map

package/dist/infrastructure/network/timeoutError.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeoutError.factory.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/network/timeoutError.factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,YAAY,EAAoB,MAAM,wBAAwB,CAAC;AAExE,uCAAuC;AACvC,wBAAgB,mBAAmB,CACjC,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,YAAY,CAUd;AAED,wCAAwC;AACxC,wBAAgB,oBAAoB,CAClC,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,YAAY,CAad;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CACjC,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,YAAY,CAad;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,CAC9B,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,YAAY,CAcd"}