@cullet/erp-core 1.3.0 → 1.4.0

package/dist/unexpected-error.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"unexpected-error.cjs","names":[],"sources":["../src/core/errors/error-codes.ts","../src/core/errors/utils/json-safe.ts","../src/core/errors/app-error.ts","../src/core/errors/unexpected-error.ts"],"sourcesContent":["const ErrorCodes = {\n    authentication: {\n        missingToken: \"sec.authn.missing_token\",\n        invalidToken: \"sec.authn.invalid_token\",\n        expiredToken: \"sec.authn.expired_token\",\n        invalidCredentials: \"sec.authn.invalid_credentials\",\n    },\n    authorization: {\n        forbidden: \"sec.authz.forbidden\",\n        policyDenied: \"sec.authz.policy_denied\",\n        missingCapability: \"sec.authz.missing_capability\",\n        outOfScope: \"sec.authz.out_of_scope\",\n    },\n    businessRuleViolation: \"business_rule_violation\",\n    conflict: {\n        alreadyExists: \"conf.already_exists\",\n        duplicate: \"conf.duplicate\",\n        uniqueViolation: \"conf.unique_violation\",\n    },\n    idempotency: {\n        keyMissing: \"idemp.key_missing\",\n        inProgress: \"idemp.in_progress\",\n        payloadMismatch: \"idemp.payload_mismatch\",\n        replayNotSupported: \"idemp.replay_not_supported\",\n    },\n    integration: {\n        timeout: \"int.timeout\",\n        unreachable: \"int.unreachable\",\n        badResponse: \"int.bad_response\",\n    },\n    legacyIncompatible: \"legacy_incompatible\",\n    notFound: \"not_found\",\n    serialization: {\n        deserializePrefix: \"ser.des\",\n        serializePrefix: \"ser.ser\",\n    },\n    temporal: {\n        expired: \"tmp.expired\",\n        notYetValid: \"tmp.not_yet_valid\",\n    },\n    unexpected: \"unexpected\",\n    validation: \"validation_error\",\n} as const;\n\ntype SerializationCodeDirection = \"deserialize\" | \"serialize\";\n\nfunction serializationErrorCode(\n    direction: SerializationCodeDirection,\n    category: string,\n): string {\n    const prefix =\n        direction === \"deserialize\"\n            ? ErrorCodes.serialization.deserializePrefix\n            : ErrorCodes.serialization.serializePrefix;\n\n    return `${prefix}.${category}`;\n}\n\nexport { ErrorCodes, serializationErrorCode };\nexport type { SerializationCodeDirection };\n","// Utilities for ensuring metadata is JSON-serializable.\n\nimport type { JsonSafeRecord, JsonSafeValue } from \"../types.js\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Constants\n// ─────────────────────────────────────────────────────────────────────────────\n\nconst NON_SERIALIZABLE_PLACEHOLDER = \"[NonSerializable]\";\nconst CIRCULAR_REFERENCE_PLACEHOLDER = \"[Circular]\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Internal helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n    if (value === null || typeof value !== \"object\") return false;\n    const proto = Object.getPrototypeOf(value);\n    return proto === Object.prototype || proto === null;\n}\n\n// `seen` tracks the ancestors on the current traversal branch (a DFS path), not\n// every object visited. This collapses true circular references to a placeholder\n// while still serializing the same object referenced more than once across\n// sibling branches (a DAG) — matching `JSON.stringify`, which only rejects\n// cycles, not shared references.\nfunction sanitizeValue(value: unknown, seen: WeakSet<object>): JsonSafeValue {\n    // Null passthrough\n    if (value === null) return null;\n\n    const type = typeof value;\n\n    // Primitives\n    if (type === \"string\" || type === \"number\" || type === \"boolean\") {\n        return value as JsonSafeValue;\n    }\n\n    // Non-serializable primitives\n    if (\n        type === \"bigint\" ||\n        type === \"function\" ||\n        type === \"symbol\" ||\n        value === undefined\n    ) {\n        return NON_SERIALIZABLE_PLACEHOLDER;\n    }\n\n    // Arrays (recursive)\n    if (Array.isArray(value)) {\n        if (seen.has(value)) return CIRCULAR_REFERENCE_PLACEHOLDER;\n        seen.add(value);\n        const sanitized = value.map((item) => sanitizeValue(item, seen));\n        seen.delete(value);\n        return sanitized;\n    }\n\n    // Date → placeholder (could also use .toISOString() if preferred)\n    if (value instanceof Date) {\n        return NON_SERIALIZABLE_PLACEHOLDER;\n    }\n\n    // Class instances and non-plain objects → placeholder\n    if (!isPlainObject(value)) {\n        return NON_SERIALIZABLE_PLACEHOLDER;\n    }\n\n    // Plain object (recursive)\n    if (seen.has(value)) return CIRCULAR_REFERENCE_PLACEHOLDER;\n    seen.add(value);\n    const result: Record<string, JsonSafeValue> = {};\n    for (const [key, val] of Object.entries(value)) {\n        result[key] = sanitizeValue(val, seen);\n    }\n    seen.delete(value);\n    return result;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Public API\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Ensures metadata is JSON-serializable.\n *\n * **Allowed:** string, number, boolean, null, arrays, and plain objects.\n *\n * **Converted to placeholder:** Date, BigInt, class instances, functions,\n * symbols, undefined, and circular references (which would otherwise make\n * `JSON.stringify` throw).\n *\n * @throws {TypeError} If `input` is not a plain object at the root level.\n */\nfunction assertJsonSafeMetadata(input: unknown): JsonSafeRecord {\n    if (input === undefined) {\n        return {};\n    }\n\n    if (!isPlainObject(input)) {\n        throw new TypeError(\n            \"metadata must be a plain object (Record<string, unknown>).\",\n        );\n    }\n\n    return sanitizeValue(input, new WeakSet<object>()) as JsonSafeRecord;\n}\n\nexport {\n    assertJsonSafeMetadata,\n    CIRCULAR_REFERENCE_PLACEHOLDER,\n    NON_SERIALIZABLE_PLACEHOLDER,\n};\n","// Base application error for the domain/application layer.\n// Encapsulates a code, optional cause, and JSON-safe metadata.\n\nimport type {\n    AppErrorOptions,\n    ErrorSeverity,\n    JsonSafeRecord,\n} from \"./types.js\";\nimport { assertJsonSafeMetadata } from \"./utils/index.js\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// AppError (abstract base class)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Root of the application/domain error hierarchy. Every error the system raises\n * on purpose extends `AppError`, which gives callers a single `instanceof` to\n * catch and a uniform, serializable shape to log and transport.\n *\n * Beyond the native `Error` message it carries a stable `code` (the contract the\n * outside world matches on), an optional non-leaking `publicMessage`, a\n * severity, JSON-safe `metadata`, and the correlation/request/command ids that\n * stitch an error back to the request that produced it. The metadata is\n * validated as JSON-safe on construction, so a logger can serialize any\n * `AppError` without hitting a circular reference or a non-serializable value.\n *\n * Abstract on purpose: callers should throw a specific subclass (e.g.\n * {@link ValidationError}, {@link NotFoundError}) so the `code` and shape are\n * meaningful, never a bare `AppError`.\n */\nabstract class AppError extends Error {\n    public readonly code: string;\n    public readonly cause?: unknown;\n    public readonly metadata?: JsonSafeRecord;\n    public readonly type?: string;\n    public readonly severity?: ErrorSeverity;\n    public readonly createdAtIso: string;\n    public readonly publicMessage?: string;\n    /**\n     * Identifies a single execution \"story\" in the system. All operations\n     * related to the same logical flow must share the same correlationId.\n     */\n    public readonly correlationId?: string;\n    /**\n     * Identifies a specific technical request attempt (each retry may produce\n     * a new requestId), even when the correlationId stays the same.\n     */\n    public readonly requestId?: string;\n    /**\n     * Marks the business intent / idempotency key; stays the same across\n     * technical retries and multiple requests that represent the same intent.\n     */\n    public readonly commandId?: string;\n\n    /**\n     * Builds the common error envelope shared by every subclass.\n     *\n     * `name` is taken from `new.target` so the thrown instance reports its\n     * concrete subclass name (not `\"AppError\"`), and the prototype is re-pinned\n     * via `setPrototypeOf` so `instanceof` keeps working after transpilation to\n     * older targets where extending built-ins breaks the chain. `createdAtIso`\n     * defaults to now, and `metadata` is validated as JSON-safe so the error is\n     * always serializable.\n     *\n     * Declared `protected`: instantiate a concrete subclass, never `AppError`.\n     *\n     * @param message - The internal, developer-facing message.\n     * @param code - The stable machine-readable code callers match on.\n     * @param options - Optional cause, metadata, severity, and correlation ids.\n     * @throws When `options.metadata` contains a value that is not JSON-safe.\n     */\n    protected constructor(\n        message: string,\n        code: string,\n        options?: AppErrorOptions,\n    ) {\n        super(message);\n\n        this.name = new.target.name;\n        this.code = code;\n        this.cause = options?.cause;\n        this.type = options?.type;\n        this.severity = options?.severity;\n        this.correlationId = options?.correlationId;\n        this.requestId = options?.requestId;\n        this.commandId = options?.commandId;\n        this.createdAtIso = options?.createdAtIso ?? new Date().toISOString();\n        this.publicMessage = options?.publicMessage;\n\n        this.metadata = options?.metadata\n            ? assertJsonSafeMetadata(options.metadata)\n            : undefined;\n\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n\n    /**\n     * Returns a JSON-safe representation of the error.\n     * Does NOT include `cause` by default (to avoid leaking internal details).\n     */\n    public toJSON(): Record<string, unknown> {\n        const payload: Record<string, unknown> = {\n            name: this.name,\n            code: this.code,\n            message: this.message,\n            createdAtIso: this.createdAtIso,\n        };\n\n        // Optional fields are emitted only when defined, so the serialized\n        // shape never carries `undefined`-valued keys (consistent with how the\n        // correlation/request/command ids are handled).\n        if (this.type !== undefined) payload.type = this.type;\n        if (this.severity !== undefined) payload.severity = this.severity;\n        if (this.publicMessage !== undefined)\n            payload.publicMessage = this.publicMessage;\n        if (this.metadata !== undefined) payload.metadata = this.metadata;\n        if (this.correlationId !== undefined)\n            payload.correlationId = this.correlationId;\n        if (this.requestId !== undefined) payload.requestId = this.requestId;\n        if (this.commandId !== undefined) payload.commandId = this.commandId;\n\n        return payload;\n    }\n}\n\nexport { AppError };\n","import { AppError } from \"./app-error.js\";\nimport { ErrorCodes } from \"./error-codes.js\";\nimport type { AppErrorOptions } from \"./types.js\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// UnexpectedError\n// ─────────────────────────────────────────────────────────────────────────────\n\nclass UnexpectedError extends AppError {\n    constructor(\n        message = \"Unexpected error\",\n        cause?: unknown,\n        options?: Omit<AppErrorOptions, \"cause\">,\n    ) {\n        super(message, ErrorCodes.unexpected, {\n            cause,\n            ...options,\n        });\n    }\n}\n\nexport { UnexpectedError };\n"],"mappings":"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"}
+{"version":3,"file":"unexpected-error.cjs","names":["AppError","ErrorCodes"],"sources":["../src/core/errors/unexpected-error.ts"],"sourcesContent":["import { AppError } from \"./app-error.js\";\nimport { ErrorCodes } from \"./error-codes.js\";\nimport type { AppErrorOptions } from \"./types.js\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// UnexpectedError\n// ─────────────────────────────────────────────────────────────────────────────\n\nclass UnexpectedError extends AppError {\n    constructor(\n        message = \"Unexpected error\",\n        cause?: unknown,\n        options?: Omit<AppErrorOptions, \"cause\">,\n    ) {\n        super(message, ErrorCodes.unexpected, {\n            cause,\n            ...options,\n        });\n    }\n}\n\nexport { UnexpectedError };\n"],"mappings":";;AAQA,IAAM,kBAAN,cAA8BA,kBAAAA,SAAS;CACnC,YACI,UAAU,oBACV,OACA,SACF;EACE,MAAM,SAASC,kBAAAA,WAAW,YAAY;GAClC;GACA,GAAG;EACP,CAAC;CACL;AACJ"}

package/dist/unexpected-error.js

@@ -1,169 +1,4 @@
-//#region src/core/errors/error-codes.ts
-const ErrorCodes = {
-	authentication: {
-		missingToken: "sec.authn.missing_token",
-		invalidToken: "sec.authn.invalid_token",
-		expiredToken: "sec.authn.expired_token",
-		invalidCredentials: "sec.authn.invalid_credentials"
-	},
-	authorization: {
-		forbidden: "sec.authz.forbidden",
-		policyDenied: "sec.authz.policy_denied",
-		missingCapability: "sec.authz.missing_capability",
-		outOfScope: "sec.authz.out_of_scope"
-	},
-	businessRuleViolation: "business_rule_violation",
-	conflict: {
-		alreadyExists: "conf.already_exists",
-		duplicate: "conf.duplicate",
-		uniqueViolation: "conf.unique_violation"
-	},
-	idempotency: {
-		keyMissing: "idemp.key_missing",
-		inProgress: "idemp.in_progress",
-		payloadMismatch: "idemp.payload_mismatch",
-		replayNotSupported: "idemp.replay_not_supported"
-	},
-	integration: {
-		timeout: "int.timeout",
-		unreachable: "int.unreachable",
-		badResponse: "int.bad_response"
-	},
-	legacyIncompatible: "legacy_incompatible",
-	notFound: "not_found",
-	serialization: {
-		deserializePrefix: "ser.des",
-		serializePrefix: "ser.ser"
-	},
-	temporal: {
-		expired: "tmp.expired",
-		notYetValid: "tmp.not_yet_valid"
-	},
-	unexpected: "unexpected",
-	validation: "validation_error"
-};
-function serializationErrorCode(direction, category) {
-	return `${direction === "deserialize" ? ErrorCodes.serialization.deserializePrefix : ErrorCodes.serialization.serializePrefix}.${category}`;
-}
-//#endregion
-//#region src/core/errors/utils/json-safe.ts
-const NON_SERIALIZABLE_PLACEHOLDER = "[NonSerializable]";
-const CIRCULAR_REFERENCE_PLACEHOLDER = "[Circular]";
-function isPlainObject(value) {
-	if (value === null || typeof value !== "object") return false;
-	const proto = Object.getPrototypeOf(value);
-	return proto === Object.prototype || proto === null;
-}
-function sanitizeValue(value, seen) {
-	if (value === null) return null;
-	const type = typeof value;
-	if (type === "string" || type === "number" || type === "boolean") return value;
-	if (type === "bigint" || type === "function" || type === "symbol" || value === void 0) return NON_SERIALIZABLE_PLACEHOLDER;
-	if (Array.isArray(value)) {
-		if (seen.has(value)) return CIRCULAR_REFERENCE_PLACEHOLDER;
-		seen.add(value);
-		const sanitized = value.map((item) => sanitizeValue(item, seen));
-		seen.delete(value);
-		return sanitized;
-	}
-	if (value instanceof Date) return NON_SERIALIZABLE_PLACEHOLDER;
-	if (!isPlainObject(value)) return NON_SERIALIZABLE_PLACEHOLDER;
-	if (seen.has(value)) return CIRCULAR_REFERENCE_PLACEHOLDER;
-	seen.add(value);
-	const result = {};
-	for (const [key, val] of Object.entries(value)) result[key] = sanitizeValue(val, seen);
-	seen.delete(value);
-	return result;
-}
-/**
-* Ensures metadata is JSON-serializable.
-*
-* **Allowed:** string, number, boolean, null, arrays, and plain objects.
-*
-* **Converted to placeholder:** Date, BigInt, class instances, functions,
-* symbols, undefined, and circular references (which would otherwise make
-* `JSON.stringify` throw).
-*
-* @throws {TypeError} If `input` is not a plain object at the root level.
-*/
-function assertJsonSafeMetadata(input) {
-	if (input === void 0) return {};
-	if (!isPlainObject(input)) throw new TypeError("metadata must be a plain object (Record<string, unknown>).");
-	return sanitizeValue(input, /* @__PURE__ */ new WeakSet());
-}
-//#endregion
-//#region src/core/errors/app-error.ts
-/**
-* Root of the application/domain error hierarchy. Every error the system raises
-* on purpose extends `AppError`, which gives callers a single `instanceof` to
-* catch and a uniform, serializable shape to log and transport.
-*
-* Beyond the native `Error` message it carries a stable `code` (the contract the
-* outside world matches on), an optional non-leaking `publicMessage`, a
-* severity, JSON-safe `metadata`, and the correlation/request/command ids that
-* stitch an error back to the request that produced it. The metadata is
-* validated as JSON-safe on construction, so a logger can serialize any
-* `AppError` without hitting a circular reference or a non-serializable value.
-*
-* Abstract on purpose: callers should throw a specific subclass (e.g.
-* {@link ValidationError}, {@link NotFoundError}) so the `code` and shape are
-* meaningful, never a bare `AppError`.
-*/
-var AppError = class extends Error {
-	/**
-	* Builds the common error envelope shared by every subclass.
-	*
-	* `name` is taken from `new.target` so the thrown instance reports its
-	* concrete subclass name (not `"AppError"`), and the prototype is re-pinned
-	* via `setPrototypeOf` so `instanceof` keeps working after transpilation to
-	* older targets where extending built-ins breaks the chain. `createdAtIso`
-	* defaults to now, and `metadata` is validated as JSON-safe so the error is
-	* always serializable.
-	*
-	* Declared `protected`: instantiate a concrete subclass, never `AppError`.
-	*
-	* @param message - The internal, developer-facing message.
-	* @param code - The stable machine-readable code callers match on.
-	* @param options - Optional cause, metadata, severity, and correlation ids.
-	* @throws When `options.metadata` contains a value that is not JSON-safe.
-	*/
-	constructor(message, code, options) {
-		super(message);
-		this.name = new.target.name;
-		this.code = code;
-		this.cause = options?.cause;
-		this.type = options?.type;
-		this.severity = options?.severity;
-		this.correlationId = options?.correlationId;
-		this.requestId = options?.requestId;
-		this.commandId = options?.commandId;
-		this.createdAtIso = options?.createdAtIso ?? (/* @__PURE__ */ new Date()).toISOString();
-		this.publicMessage = options?.publicMessage;
-		this.metadata = options?.metadata ? assertJsonSafeMetadata(options.metadata) : void 0;
-		Object.setPrototypeOf(this, new.target.prototype);
-	}
-	/**
-	* Returns a JSON-safe representation of the error.
-	* Does NOT include `cause` by default (to avoid leaking internal details).
-	*/
-	toJSON() {
-		const payload = {
-			name: this.name,
-			code: this.code,
-			message: this.message,
-			createdAtIso: this.createdAtIso
-		};
-		if (this.type !== void 0) payload.type = this.type;
-		if (this.severity !== void 0) payload.severity = this.severity;
-		if (this.publicMessage !== void 0) payload.publicMessage = this.publicMessage;
-		if (this.metadata !== void 0) payload.metadata = this.metadata;
-		if (this.correlationId !== void 0) payload.correlationId = this.correlationId;
-		if (this.requestId !== void 0) payload.requestId = this.requestId;
-		if (this.commandId !== void 0) payload.commandId = this.commandId;
-		return payload;
-	}
-};
-//#endregion
+import { r as ErrorCodes, t as AppError } from "./app-error.js";
 //#region src/core/errors/unexpected-error.ts
 var UnexpectedError = class extends AppError {
 	constructor(message = "Unexpected error", cause, options) {
@@ -174,6 +9,6 @@ var UnexpectedError = class extends AppError {
 	}
 };
 //#endregion
-export { serializationErrorCode as a, ErrorCodes as i, AppError as n, assertJsonSafeMetadata as r, UnexpectedError as t };
+export { UnexpectedError as t };
 
 //# sourceMappingURL=unexpected-error.js.map

package/dist/unexpected-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"unexpected-error.js","names":[],"sources":["../src/core/errors/error-codes.ts","../src/core/errors/utils/json-safe.ts","../src/core/errors/app-error.ts","../src/core/errors/unexpected-error.ts"],"sourcesContent":["const ErrorCodes = {\n    authentication: {\n        missingToken: \"sec.authn.missing_token\",\n        invalidToken: \"sec.authn.invalid_token\",\n        expiredToken: \"sec.authn.expired_token\",\n        invalidCredentials: \"sec.authn.invalid_credentials\",\n    },\n    authorization: {\n        forbidden: \"sec.authz.forbidden\",\n        policyDenied: \"sec.authz.policy_denied\",\n        missingCapability: \"sec.authz.missing_capability\",\n        outOfScope: \"sec.authz.out_of_scope\",\n    },\n    businessRuleViolation: \"business_rule_violation\",\n    conflict: {\n        alreadyExists: \"conf.already_exists\",\n        duplicate: \"conf.duplicate\",\n        uniqueViolation: \"conf.unique_violation\",\n    },\n    idempotency: {\n        keyMissing: \"idemp.key_missing\",\n        inProgress: \"idemp.in_progress\",\n        payloadMismatch: \"idemp.payload_mismatch\",\n        replayNotSupported: \"idemp.replay_not_supported\",\n    },\n    integration: {\n        timeout: \"int.timeout\",\n        unreachable: \"int.unreachable\",\n        badResponse: \"int.bad_response\",\n    },\n    legacyIncompatible: \"legacy_incompatible\",\n    notFound: \"not_found\",\n    serialization: {\n        deserializePrefix: \"ser.des\",\n        serializePrefix: \"ser.ser\",\n    },\n    temporal: {\n        expired: \"tmp.expired\",\n        notYetValid: \"tmp.not_yet_valid\",\n    },\n    unexpected: \"unexpected\",\n    validation: \"validation_error\",\n} as const;\n\ntype SerializationCodeDirection = \"deserialize\" | \"serialize\";\n\nfunction serializationErrorCode(\n    direction: SerializationCodeDirection,\n    category: string,\n): string {\n    const prefix =\n        direction === \"deserialize\"\n            ? ErrorCodes.serialization.deserializePrefix\n            : ErrorCodes.serialization.serializePrefix;\n\n    return `${prefix}.${category}`;\n}\n\nexport { ErrorCodes, serializationErrorCode };\nexport type { SerializationCodeDirection };\n","// Utilities for ensuring metadata is JSON-serializable.\n\nimport type { JsonSafeRecord, JsonSafeValue } from \"../types.js\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Constants\n// ─────────────────────────────────────────────────────────────────────────────\n\nconst NON_SERIALIZABLE_PLACEHOLDER = \"[NonSerializable]\";\nconst CIRCULAR_REFERENCE_PLACEHOLDER = \"[Circular]\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Internal helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n    if (value === null || typeof value !== \"object\") return false;\n    const proto = Object.getPrototypeOf(value);\n    return proto === Object.prototype || proto === null;\n}\n\n// `seen` tracks the ancestors on the current traversal branch (a DFS path), not\n// every object visited. This collapses true circular references to a placeholder\n// while still serializing the same object referenced more than once across\n// sibling branches (a DAG) — matching `JSON.stringify`, which only rejects\n// cycles, not shared references.\nfunction sanitizeValue(value: unknown, seen: WeakSet<object>): JsonSafeValue {\n    // Null passthrough\n    if (value === null) return null;\n\n    const type = typeof value;\n\n    // Primitives\n    if (type === \"string\" || type === \"number\" || type === \"boolean\") {\n        return value as JsonSafeValue;\n    }\n\n    // Non-serializable primitives\n    if (\n        type === \"bigint\" ||\n        type === \"function\" ||\n        type === \"symbol\" ||\n        value === undefined\n    ) {\n        return NON_SERIALIZABLE_PLACEHOLDER;\n    }\n\n    // Arrays (recursive)\n    if (Array.isArray(value)) {\n        if (seen.has(value)) return CIRCULAR_REFERENCE_PLACEHOLDER;\n        seen.add(value);\n        const sanitized = value.map((item) => sanitizeValue(item, seen));\n        seen.delete(value);\n        return sanitized;\n    }\n\n    // Date → placeholder (could also use .toISOString() if preferred)\n    if (value instanceof Date) {\n        return NON_SERIALIZABLE_PLACEHOLDER;\n    }\n\n    // Class instances and non-plain objects → placeholder\n    if (!isPlainObject(value)) {\n        return NON_SERIALIZABLE_PLACEHOLDER;\n    }\n\n    // Plain object (recursive)\n    if (seen.has(value)) return CIRCULAR_REFERENCE_PLACEHOLDER;\n    seen.add(value);\n    const result: Record<string, JsonSafeValue> = {};\n    for (const [key, val] of Object.entries(value)) {\n        result[key] = sanitizeValue(val, seen);\n    }\n    seen.delete(value);\n    return result;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Public API\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Ensures metadata is JSON-serializable.\n *\n * **Allowed:** string, number, boolean, null, arrays, and plain objects.\n *\n * **Converted to placeholder:** Date, BigInt, class instances, functions,\n * symbols, undefined, and circular references (which would otherwise make\n * `JSON.stringify` throw).\n *\n * @throws {TypeError} If `input` is not a plain object at the root level.\n */\nfunction assertJsonSafeMetadata(input: unknown): JsonSafeRecord {\n    if (input === undefined) {\n        return {};\n    }\n\n    if (!isPlainObject(input)) {\n        throw new TypeError(\n            \"metadata must be a plain object (Record<string, unknown>).\",\n        );\n    }\n\n    return sanitizeValue(input, new WeakSet<object>()) as JsonSafeRecord;\n}\n\nexport {\n    assertJsonSafeMetadata,\n    CIRCULAR_REFERENCE_PLACEHOLDER,\n    NON_SERIALIZABLE_PLACEHOLDER,\n};\n","// Base application error for the domain/application layer.\n// Encapsulates a code, optional cause, and JSON-safe metadata.\n\nimport type {\n    AppErrorOptions,\n    ErrorSeverity,\n    JsonSafeRecord,\n} from \"./types.js\";\nimport { assertJsonSafeMetadata } from \"./utils/index.js\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// AppError (abstract base class)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Root of the application/domain error hierarchy. Every error the system raises\n * on purpose extends `AppError`, which gives callers a single `instanceof` to\n * catch and a uniform, serializable shape to log and transport.\n *\n * Beyond the native `Error` message it carries a stable `code` (the contract the\n * outside world matches on), an optional non-leaking `publicMessage`, a\n * severity, JSON-safe `metadata`, and the correlation/request/command ids that\n * stitch an error back to the request that produced it. The metadata is\n * validated as JSON-safe on construction, so a logger can serialize any\n * `AppError` without hitting a circular reference or a non-serializable value.\n *\n * Abstract on purpose: callers should throw a specific subclass (e.g.\n * {@link ValidationError}, {@link NotFoundError}) so the `code` and shape are\n * meaningful, never a bare `AppError`.\n */\nabstract class AppError extends Error {\n    public readonly code: string;\n    public readonly cause?: unknown;\n    public readonly metadata?: JsonSafeRecord;\n    public readonly type?: string;\n    public readonly severity?: ErrorSeverity;\n    public readonly createdAtIso: string;\n    public readonly publicMessage?: string;\n    /**\n     * Identifies a single execution \"story\" in the system. All operations\n     * related to the same logical flow must share the same correlationId.\n     */\n    public readonly correlationId?: string;\n    /**\n     * Identifies a specific technical request attempt (each retry may produce\n     * a new requestId), even when the correlationId stays the same.\n     */\n    public readonly requestId?: string;\n    /**\n     * Marks the business intent / idempotency key; stays the same across\n     * technical retries and multiple requests that represent the same intent.\n     */\n    public readonly commandId?: string;\n\n    /**\n     * Builds the common error envelope shared by every subclass.\n     *\n     * `name` is taken from `new.target` so the thrown instance reports its\n     * concrete subclass name (not `\"AppError\"`), and the prototype is re-pinned\n     * via `setPrototypeOf` so `instanceof` keeps working after transpilation to\n     * older targets where extending built-ins breaks the chain. `createdAtIso`\n     * defaults to now, and `metadata` is validated as JSON-safe so the error is\n     * always serializable.\n     *\n     * Declared `protected`: instantiate a concrete subclass, never `AppError`.\n     *\n     * @param message - The internal, developer-facing message.\n     * @param code - The stable machine-readable code callers match on.\n     * @param options - Optional cause, metadata, severity, and correlation ids.\n     * @throws When `options.metadata` contains a value that is not JSON-safe.\n     */\n    protected constructor(\n        message: string,\n        code: string,\n        options?: AppErrorOptions,\n    ) {\n        super(message);\n\n        this.name = new.target.name;\n        this.code = code;\n        this.cause = options?.cause;\n        this.type = options?.type;\n        this.severity = options?.severity;\n        this.correlationId = options?.correlationId;\n        this.requestId = options?.requestId;\n        this.commandId = options?.commandId;\n        this.createdAtIso = options?.createdAtIso ?? new Date().toISOString();\n        this.publicMessage = options?.publicMessage;\n\n        this.metadata = options?.metadata\n            ? assertJsonSafeMetadata(options.metadata)\n            : undefined;\n\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n\n    /**\n     * Returns a JSON-safe representation of the error.\n     * Does NOT include `cause` by default (to avoid leaking internal details).\n     */\n    public toJSON(): Record<string, unknown> {\n        const payload: Record<string, unknown> = {\n            name: this.name,\n            code: this.code,\n            message: this.message,\n            createdAtIso: this.createdAtIso,\n        };\n\n        // Optional fields are emitted only when defined, so the serialized\n        // shape never carries `undefined`-valued keys (consistent with how the\n        // correlation/request/command ids are handled).\n        if (this.type !== undefined) payload.type = this.type;\n        if (this.severity !== undefined) payload.severity = this.severity;\n        if (this.publicMessage !== undefined)\n            payload.publicMessage = this.publicMessage;\n        if (this.metadata !== undefined) payload.metadata = this.metadata;\n        if (this.correlationId !== undefined)\n            payload.correlationId = this.correlationId;\n        if (this.requestId !== undefined) payload.requestId = this.requestId;\n        if (this.commandId !== undefined) payload.commandId = this.commandId;\n\n        return payload;\n    }\n}\n\nexport { AppError };\n","import { AppError } from \"./app-error.js\";\nimport { ErrorCodes } from \"./error-codes.js\";\nimport type { AppErrorOptions } from \"./types.js\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// UnexpectedError\n// ─────────────────────────────────────────────────────────────────────────────\n\nclass UnexpectedError extends AppError {\n    constructor(\n        message = \"Unexpected error\",\n        cause?: unknown,\n        options?: Omit<AppErrorOptions, \"cause\">,\n    ) {\n        super(message, ErrorCodes.unexpected, {\n            cause,\n            ...options,\n        });\n    }\n}\n\nexport { UnexpectedError };\n"],"mappings":"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"}
+{"version":3,"file":"unexpected-error.js","names":[],"sources":["../src/core/errors/unexpected-error.ts"],"sourcesContent":["import { AppError } from \"./app-error.js\";\nimport { ErrorCodes } from \"./error-codes.js\";\nimport type { AppErrorOptions } from \"./types.js\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// UnexpectedError\n// ─────────────────────────────────────────────────────────────────────────────\n\nclass UnexpectedError extends AppError {\n    constructor(\n        message = \"Unexpected error\",\n        cause?: unknown,\n        options?: Omit<AppErrorOptions, \"cause\">,\n    ) {\n        super(message, ErrorCodes.unexpected, {\n            cause,\n            ...options,\n        });\n    }\n}\n\nexport { UnexpectedError };\n"],"mappings":";;AAQA,IAAM,kBAAN,cAA8B,SAAS;CACnC,YACI,UAAU,oBACV,OACA,SACF;EACE,MAAM,SAAS,WAAW,YAAY;GAClC;GACA,GAAG;EACP,CAAC;CACL;AACJ"}

package/dist/uuid-identifier.d.cts

@@ -1,6 +1,5 @@
 import { n as ContractVersion } from "./version.cjs";
-import { t as DeepReadonly } from "./immutable.cjs";
-import { t as PluginManager } from "./plugin.cjs";
+import { t as ValueObject } from "./value-object.cjs";
 
 //#region src/core/domain/entity.d.ts
 
@@ -96,88 +95,6 @@ declare abstract class Entity<TIdentifier> {
   protected markAsModified(updatedAt?: Date): number;
 }
 //#endregion
-//#region src/core/domain/value-object.d.ts
-/**
- * Extension point for value-object equality. A plugin implementing this
- * contract overrides how any two value objects are compared, letting the host
- * application swap in a structural comparator (e.g. `lodash.isEqual` over the
- * wrapped `value`) without every value object having to implement `equals` by
- * hand.
- */
-type ValueObjectPluginContract = {
-  equals: (a: ValueObject<unknown, unknown>, b: ValueObject<unknown, unknown>) => boolean;
-};
-/**
- * Base class for value objects — domain concepts defined entirely by their
- * contents, with no identity of their own. Two value objects are
- * interchangeable when they hold equal data, which is the opposite of an
- * {@link Entity} (compared by id). Money, a CPF, a date range: replacing one
- * instance with an equal one changes nothing about the model.
- *
- * Immutability is the defining guarantee here. The wrapped `value` is
- * deep-frozen on construction, so a value object can be shared freely without
- * any risk of a consumer mutating shared state. Subclasses seal the instance
- * itself with {@link finalize} once their own fields are set.
- *
- * @typeParam T - The shape of the wrapped data.
- * @typeParam P - The primitive form produced by {@link toPrimitive} / {@link toJSON}.
- */
-declare abstract class ValueObject<T, P> {
-  static readonly CONTRACT_VERSION: ContractVersion;
-  /**
-   * Registry of equality plugins shared by every value object. Empty by
-   * default — when nothing is registered, {@link equals} falls back to a
-   * structural comparison of the wrapped `value`. Hosts register a plugin
-   * (e.g. `lodash.isEqual`) once at startup to customise equality globally.
-   */
-  static readonly plugins: PluginManager<ValueObjectPluginContract>;
-  /** The wrapped data, deep-frozen so it can never be mutated after construction. */
-  readonly value: DeepReadonly<T>;
-  /**
-   * Wraps `value`, deep-freezing it so the value object is immutable from the
-   * moment it exists. Declared `protected` because value objects are built
-   * through a validating subclass factory, never instantiated directly.
-   */
-  protected constructor(value: T);
-  /**
-   * The schema/contract version stamped on this value-object type by the
-   * `@version` decorator — used to detect state persisted under an older shape.
-   */
-  get contractVersion(): ContractVersion;
-  /**
-   * Freezes the instance shell, blocking reassignment of any own field.
-   *
-   * `value` is already deep-frozen by the constructor, so the wrapped data is
-   * immutable regardless. The instance itself is NOT frozen automatically
-   * because a subclass may still need to assign its own fields after
-   * `super(value)` runs. Call `finalize()` at the very end of the subclass
-   * constructor (after all fields are set) to make the whole value object
-   * immutable.
-   */
-  protected finalize(): void;
-  /**
-   * Hook for `JSON.stringify`. Delegates to {@link toPrimitive} so a value
-   * object serializes to its primitive form rather than exposing the internal
-   * `value` wrapper.
-   */
-  toJSON(): P;
-  /**
-   * Compares this value object with another by content. Because value objects
-   * carry no identity, two independently constructed instances holding the
-   * same data are considered equal.
-   *
-   * Delegates to the registered equality {@link plugins}; with no plugin
-   * registered it falls back to comparing the serialized wrapped `value`.
-   * Subclasses may still override for a faster or domain-specific comparison.
-   */
-  equals(other: this): boolean;
-  /**
-   * Projects the value object down to a plain, serializable primitive form —
-   * the representation suitable for persistence, transport, or comparison.
-   */
-  abstract toPrimitive(): P;
-}
-//#endregion
 //#region src/core/domain/uuid-identifier.d.ts
 /**
  * Base class for UUID-backed identity value objects.
@@ -226,5 +143,5 @@ declare abstract class UuidIdentifier<TBrand extends string = string> extends Va
   static isValid(candidate: string): boolean;
 }
 //#endregion
-export { EntityState as a, Entity as i, ValueObject as n, ValueObjectPluginContract as r, UuidIdentifier as t };
+export { Entity as n, EntityState as r, UuidIdentifier as t };
 //# sourceMappingURL=uuid-identifier.d.cts.map

package/dist/uuid-identifier.d.ts

@@ -1,6 +1,5 @@
 import { n as ContractVersion } from "./version.js";
-import { t as DeepReadonly } from "./immutable.js";
-import { t as PluginManager } from "./plugin.js";
+import { t as ValueObject } from "./value-object.js";
 
 //#region src/core/domain/entity.d.ts
 
@@ -96,88 +95,6 @@ declare abstract class Entity<TIdentifier> {
   protected markAsModified(updatedAt?: Date): number;
 }
 //#endregion
-//#region src/core/domain/value-object.d.ts
-/**
- * Extension point for value-object equality. A plugin implementing this
- * contract overrides how any two value objects are compared, letting the host
- * application swap in a structural comparator (e.g. `lodash.isEqual` over the
- * wrapped `value`) without every value object having to implement `equals` by
- * hand.
- */
-type ValueObjectPluginContract = {
-  equals: (a: ValueObject<unknown, unknown>, b: ValueObject<unknown, unknown>) => boolean;
-};
-/**
- * Base class for value objects — domain concepts defined entirely by their
- * contents, with no identity of their own. Two value objects are
- * interchangeable when they hold equal data, which is the opposite of an
- * {@link Entity} (compared by id). Money, a CPF, a date range: replacing one
- * instance with an equal one changes nothing about the model.
- *
- * Immutability is the defining guarantee here. The wrapped `value` is
- * deep-frozen on construction, so a value object can be shared freely without
- * any risk of a consumer mutating shared state. Subclasses seal the instance
- * itself with {@link finalize} once their own fields are set.
- *
- * @typeParam T - The shape of the wrapped data.
- * @typeParam P - The primitive form produced by {@link toPrimitive} / {@link toJSON}.
- */
-declare abstract class ValueObject<T, P> {
-  static readonly CONTRACT_VERSION: ContractVersion;
-  /**
-   * Registry of equality plugins shared by every value object. Empty by
-   * default — when nothing is registered, {@link equals} falls back to a
-   * structural comparison of the wrapped `value`. Hosts register a plugin
-   * (e.g. `lodash.isEqual`) once at startup to customise equality globally.
-   */
-  static readonly plugins: PluginManager<ValueObjectPluginContract>;
-  /** The wrapped data, deep-frozen so it can never be mutated after construction. */
-  readonly value: DeepReadonly<T>;
-  /**
-   * Wraps `value`, deep-freezing it so the value object is immutable from the
-   * moment it exists. Declared `protected` because value objects are built
-   * through a validating subclass factory, never instantiated directly.
-   */
-  protected constructor(value: T);
-  /**
-   * The schema/contract version stamped on this value-object type by the
-   * `@version` decorator — used to detect state persisted under an older shape.
-   */
-  get contractVersion(): ContractVersion;
-  /**
-   * Freezes the instance shell, blocking reassignment of any own field.
-   *
-   * `value` is already deep-frozen by the constructor, so the wrapped data is
-   * immutable regardless. The instance itself is NOT frozen automatically
-   * because a subclass may still need to assign its own fields after
-   * `super(value)` runs. Call `finalize()` at the very end of the subclass
-   * constructor (after all fields are set) to make the whole value object
-   * immutable.
-   */
-  protected finalize(): void;
-  /**
-   * Hook for `JSON.stringify`. Delegates to {@link toPrimitive} so a value
-   * object serializes to its primitive form rather than exposing the internal
-   * `value` wrapper.
-   */
-  toJSON(): P;
-  /**
-   * Compares this value object with another by content. Because value objects
-   * carry no identity, two independently constructed instances holding the
-   * same data are considered equal.
-   *
-   * Delegates to the registered equality {@link plugins}; with no plugin
-   * registered it falls back to comparing the serialized wrapped `value`.
-   * Subclasses may still override for a faster or domain-specific comparison.
-   */
-  equals(other: this): boolean;
-  /**
-   * Projects the value object down to a plain, serializable primitive form —
-   * the representation suitable for persistence, transport, or comparison.
-   */
-  abstract toPrimitive(): P;
-}
-//#endregion
 //#region src/core/domain/uuid-identifier.d.ts
 /**
  * Base class for UUID-backed identity value objects.
@@ -226,5 +143,5 @@ declare abstract class UuidIdentifier<TBrand extends string = string> extends Va
   static isValid(candidate: string): boolean;
 }
 //#endregion
-export { EntityState as a, Entity as i, ValueObject as n, ValueObjectPluginContract as r, UuidIdentifier as t };
+export { Entity as n, EntityState as r, UuidIdentifier as t };
 //# sourceMappingURL=uuid-identifier.d.ts.map