@zudojs/errors 1.0.1 → 1.2.0

package/dist/domain/cli/cliError.base.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Errors raised by the `zudojs-cli` scaffolding and generation commands.
+ *
+ * Owned here so the CLI (and tools that drive it) can match them with
+ * `instanceof` against a single class hierarchy.
+ */
+import { ApplicationError } from "../app/application.error.js";
+/** Invalid user input to a CLI command (bad name, unknown option value). */
+export declare class CLIValidationError extends ApplicationError {
+    constructor(message: string);
+}
+/** A generator or scaffolder failed while producing files. */
+export declare class CLIGenerationError extends ApplicationError {
+    constructor(message: string, cause?: unknown);
+}
+/** The command needs a Zudojs project but was run outside one. */
+export declare class CLINotInProjectError extends ApplicationError {
+    constructor();
+}
+/** A template could not be found or rendered. */
+export declare class CLITemplateError extends ApplicationError {
+    constructor(message: string);
+}
+//# sourceMappingURL=cliError.base.d.ts.map

package/dist/domain/cli/cliError.base.js

@@ -0,0 +1,34 @@
+/**
+ * Errors raised by the `zudojs-cli` scaffolding and generation commands.
+ *
+ * Owned here so the CLI (and tools that drive it) can match them with
+ * `instanceof` against a single class hierarchy.
+ */
+import { ApplicationError } from "../app/application.error.js";
+/** Invalid user input to a CLI command (bad name, unknown option value). */
+export class CLIValidationError extends ApplicationError {
+    constructor(message) {
+        super(message, { isOperational: true });
+    }
+}
+/** A generator or scaffolder failed while producing files. */
+export class CLIGenerationError extends ApplicationError {
+    constructor(message, cause) {
+        super(message, { cause });
+    }
+}
+/** The command needs a Zudojs project but was run outside one. */
+export class CLINotInProjectError extends ApplicationError {
+    constructor() {
+        super("This command must be run inside a Zudojs project directory.", {
+            isOperational: true,
+        });
+    }
+}
+/** A template could not be found or rendered. */
+export class CLITemplateError extends ApplicationError {
+    constructor(message) {
+        super(message);
+    }
+}
+//# sourceMappingURL=cliError.base.js.map

package/dist/domain/cli/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/errors/domain/cli
+ *
+ * Errors for the `zudojs-cli` command-line tool.
+ */
+export * from "./cliError.base.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/cli/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/errors/domain/cli
+ *
+ * Errors for the `zudojs-cli` command-line tool.
+ */
+export * from "./cliError.base.js";
+//# sourceMappingURL=index.js.map

package/dist/domain/constant/constantError.base.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Errors raised by `@zudojs/constants` branded-type factories and
+ * environment helpers.
+ */
+import { BaseError } from "../../base/core/baseError.core.js";
+import { ErrorCode } from "../../base/types/errorCode.type.js";
+import type { ErrorMetadata } from "../../base/core/errorMetadata.type.js";
+/** Error thrown when an invalid constant value is used. */
+export declare class InvalidConstantError extends BaseError {
+    constructor(message: string, options?: {
+        readonly code?: ErrorCode;
+        readonly metadata?: ErrorMetadata;
+    });
+}
+/** Error thrown when a constant is used outside its valid context. */
+export declare class ConstantContextError extends BaseError {
+    constructor(message: string, options?: {
+        readonly metadata?: ErrorMetadata;
+    });
+}
+//# sourceMappingURL=constantError.base.d.ts.map

package/dist/domain/constant/constantError.base.js

@@ -0,0 +1,31 @@
+/**
+ * Errors raised by `@zudojs/constants` branded-type factories and
+ * environment helpers.
+ */
+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 thrown when an invalid constant value is used. */
+export class InvalidConstantError extends BaseError {
+    constructor(message, options) {
+        super(message, {
+            code: options?.code ?? ErrorCode.CONFIGURATION_INVALID,
+            category: ErrorCategory.VALIDATION,
+            severity: ErrorSeverity.ERROR,
+            metadata: options?.metadata,
+        });
+    }
+}
+/** Error thrown when a constant is used outside its valid context. */
+export class ConstantContextError extends BaseError {
+    constructor(message, options) {
+        super(message, {
+            code: ErrorCode.INVALID_INPUT,
+            category: ErrorCategory.VALIDATION,
+            severity: ErrorSeverity.ERROR,
+            metadata: options?.metadata,
+        });
+    }
+}
+//# sourceMappingURL=constantError.base.js.map

package/dist/domain/constant/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/errors/domain/constant
+ *
+ * Errors for invalid or misused constants and branded values.
+ */
+export * from "./constantError.base.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/constant/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/errors/domain/constant
+ *
+ * Errors for invalid or misused constants and branded values.
+ */
+export * from "./constantError.base.js";
+//# sourceMappingURL=index.js.map

package/dist/domain/cqrs/cqrsError.base.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Base CQRS error, owned here so `@zudojs/cqrs` can extend or re-export it.
+ */
+import type { BaseErrorOptions } from "../../base/types/baseError.type.js";
+import { BaseError } from "../../base/core/baseError.core.js";
+/**
+ * Base error for failures originating from the CQRS package.
+ *
+ * Defaults: `ErrorCode.INTERNAL_ERROR`, category `system`, 500, not exposed.
+ */
+export declare class CqrsError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+//# sourceMappingURL=cqrsError.base.d.ts.map

package/dist/domain/cqrs/cqrsError.base.js

@@ -0,0 +1,26 @@
+/**
+ * Base CQRS error, owned here so `@zudojs/cqrs` can extend or re-export it.
+ */
+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";
+/**
+ * Base error for failures originating from the CQRS package.
+ *
+ * Defaults: `ErrorCode.INTERNAL_ERROR`, category `system`, 500, not exposed.
+ */
+export class CqrsError extends BaseError {
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            code: options.code ?? ErrorCode.INTERNAL_ERROR,
+            category: options.category ?? ErrorCategory.SYSTEM,
+            severity: options.severity ?? ErrorSeverity.ERROR,
+            statusCode: options.statusCode ?? 500,
+            expose: options.expose ?? false,
+            isOperational: options.isOperational ?? true,
+        });
+    }
+}
+//# sourceMappingURL=cqrsError.base.js.map

package/dist/domain/cqrs/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/errors/domain/cqrs
+ *
+ * Command/query bus errors.
+ */
+export * from "./cqrsError.base.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/cqrs/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/errors/domain/cqrs
+ *
+ * Command/query bus errors.
+ */
+export * from "./cqrsError.base.js";
+//# sourceMappingURL=index.js.map

package/dist/domain/event/event.error.d.ts

@@ -4,6 +4,6 @@
 export { EventError, createEventError, isEventError, toEventError, } from "./eventError.base.js";
 export type { EventErrorOptions } from "./eventError.base.js";
 export { EventHandlerError, createEventHandlerError, EventHandlerNotFoundError, DuplicateEventHandlerError, EventMiddlewareError, } from "./eventError.handler.js";
-export { EventPublishError, InvalidEventError, EventTypeNotFoundError, DuplicateEventDefinitionError, EventDefinitionNotFoundError, EventDispatchAbortedError, EventEmitterDisposedError, EventRegistryDisposedError, EventSubscriptionClosedError, EventBusDisposedError, EventTimeoutError, } from "./eventError.lifecycle.js";
+export { EventPublishError, InvalidEventError, EventTypeNotFoundError, DuplicateEventDefinitionError, EventDefinitionNotFoundError, EventDispatchAbortedError, EventEmitterDisposedError, EventRegistryDisposedError, EventSubscriptionClosedError, EventBusDisposedError, EventListenerLimitExceededError, EventTimeoutError, } from "./eventError.lifecycle.js";
 export { EventSerializationError, EventDeserializationError, } from "./eventError.serialization.js";
 //# sourceMappingURL=event.error.d.ts.map

package/dist/domain/event/event.error.js

@@ -3,6 +3,6 @@
  */
 export { EventError, createEventError, isEventError, toEventError, } from "./eventError.base.js";
 export { EventHandlerError, createEventHandlerError, EventHandlerNotFoundError, DuplicateEventHandlerError, EventMiddlewareError, } from "./eventError.handler.js";
-export { EventPublishError, InvalidEventError, EventTypeNotFoundError, DuplicateEventDefinitionError, EventDefinitionNotFoundError, EventDispatchAbortedError, EventEmitterDisposedError, EventRegistryDisposedError, EventSubscriptionClosedError, EventBusDisposedError, EventTimeoutError, } from "./eventError.lifecycle.js";
+export { EventPublishError, InvalidEventError, EventTypeNotFoundError, DuplicateEventDefinitionError, EventDefinitionNotFoundError, EventDispatchAbortedError, EventEmitterDisposedError, EventRegistryDisposedError, EventSubscriptionClosedError, EventBusDisposedError, EventListenerLimitExceededError, EventTimeoutError, } from "./eventError.lifecycle.js";
 export { EventSerializationError, EventDeserializationError, } from "./eventError.serialization.js";
 //# sourceMappingURL=event.error.js.map

package/dist/domain/event/eventError.lifecycle.d.ts

@@ -62,6 +62,22 @@ export declare class EventSubscriptionClosedError extends EventError {
 export declare class EventBusDisposedError extends EventError {
     constructor();
 }
+/**
+ * Error thrown when a pattern exceeds its configured handler limit.
+ *
+ * The limit exists to catch a subscribe-without-unsubscribe leak. Registering
+ * past it is a programming fault rather than bad input, so this is reported as
+ * internal and is never exposed to a caller.
+ *
+ * A registry only raises this when it is configured to enforce the limit;
+ * the default is a one-shot warning, which does not interrupt registration.
+ */
+export declare class EventListenerLimitExceededError extends EventError {
+    readonly pattern: string;
+    readonly count: number;
+    readonly limit: number;
+    constructor(pattern: string, count: number, limit: number);
+}
 /** Error thrown when an event operation times out. */
 export declare class EventTimeoutError extends EventError {
     readonly timeoutMs: number;

package/dist/domain/event/eventError.lifecycle.js

@@ -130,6 +130,37 @@ export class EventBusDisposedError extends EventError {
         });
     }
 }
+/**
+ * Error thrown when a pattern exceeds its configured handler limit.
+ *
+ * The limit exists to catch a subscribe-without-unsubscribe leak. Registering
+ * past it is a programming fault rather than bad input, so this is reported as
+ * internal and is never exposed to a caller.
+ *
+ * A registry only raises this when it is configured to enforce the limit;
+ * the default is a one-shot warning, which does not interrupt registration.
+ */
+export class EventListenerLimitExceededError extends EventError {
+    pattern;
+    count;
+    limit;
+    constructor(pattern, count, limit) {
+        assertFiniteNonNegative("count", count);
+        assertFiniteNonNegative("limit", limit);
+        super(`Possible event handler leak: ${count} handlers registered for ` +
+            `"${pattern}" (limit ${limit}). Unsubscribe handlers you no longer ` +
+            "need or raise maxHandlersPerPattern / maxListeners.", {
+            code: ErrorCode.EVENT_LISTENER_LIMIT_EXCEEDED,
+            metadata: { pattern, count, limit },
+            statusCode: 500,
+            expose: false,
+            isOperational: false,
+        });
+        this.pattern = pattern;
+        this.count = count;
+        this.limit = limit;
+    }
+}
 /** Error thrown when an event operation times out. */
 export class EventTimeoutError extends EventError {
     timeoutMs;

package/dist/domain/index.d.ts

@@ -17,4 +17,10 @@ export * from "./rpc/index.js";
 export * from "./scheduler/index.js";
 export * from "./documentation/index.js";
 export * from "./plugin/index.js";
+export * from "./transaction/index.js";
+export * from "./traversal/index.js";
+export * from "./openapi/index.js";
+export * from "./cqrs/index.js";
+export * from "./constant/index.js";
+export * from "./cli/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/domain/index.js

@@ -17,4 +17,10 @@ export * from "./rpc/index.js";
 export * from "./scheduler/index.js";
 export * from "./documentation/index.js";
 export * from "./plugin/index.js";
+export * from "./transaction/index.js";
+export * from "./traversal/index.js";
+export * from "./openapi/index.js";
+export * from "./cqrs/index.js";
+export * from "./constant/index.js";
+export * from "./cli/index.js";
 //# sourceMappingURL=index.js.map

package/dist/domain/openapi/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/errors/domain/openapi
+ *
+ * OpenAPI document build and validation errors.
+ */
+export * from "./openApiError.base.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/openapi/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/errors/domain/openapi
+ *
+ * OpenAPI document build and validation errors.
+ */
+export * from "./openApiError.base.js";
+//# sourceMappingURL=index.js.map

package/dist/domain/openapi/openApiError.base.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Base OpenAPI error. Server-side defaults (500, not exposed): a document
+ * that fails to build is an operator's problem, not a client's.
+ */
+import { BaseError } from "../../base/core/baseError.core.js";
+/** Options for creating an OpenAPI error. */
+export interface OpenAPIErrorOptions {
+    readonly code?: string;
+    /** Overrides the default status (500). */
+    readonly statusCode?: number;
+    /** Overrides the default exposure (false). */
+    readonly expose?: boolean;
+    readonly cause?: unknown;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/** Base error for all OpenAPI subsystem failures. */
+export declare class OpenAPIError extends BaseError {
+    constructor(message: string, options?: OpenAPIErrorOptions);
+}
+//# sourceMappingURL=openApiError.base.d.ts.map

package/dist/domain/openapi/openApiError.base.js

@@ -0,0 +1,24 @@
+/**
+ * Base OpenAPI error. Server-side defaults (500, not exposed): a document
+ * that fails to build is an operator's problem, not a client's.
+ */
+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";
+/** Base error for all OpenAPI subsystem failures. */
+export class OpenAPIError extends BaseError {
+    constructor(message, options = {}) {
+        super(message, {
+            code: options.code ?? ErrorCode.OPENAPI_DOCUMENT,
+            category: ErrorCategory.OPENAPI,
+            severity: ErrorSeverity.ERROR,
+            statusCode: options.statusCode ?? 500,
+            expose: options.expose ?? false,
+            cause: options.cause,
+            metadata: options.metadata,
+        });
+        this.name = "OpenAPIError";
+    }
+}
+//# sourceMappingURL=openApiError.base.js.map

package/dist/domain/schema/schemaError.base.js

@@ -38,7 +38,7 @@ export class SchemaError extends BaseError {
         const safeIssues = toJsonSafeIssues(this.issues);
         return {
             ...super.toJSON(),
-            issues: this.expose ? redactIssueValues(safeIssues) : safeIssues,
+            issues: redactIssueValues(safeIssues),
         };
     }
 }

package/dist/domain/shared/domainError.helpers.d.ts

@@ -48,8 +48,9 @@ export declare function normalizeRetryAfterSeconds(value: number, name?: string)
 export declare function mergeMetadata(callerMetadata: ErrorMetadata | undefined, own: ErrorMetadata): ErrorMetadata;
 /**
  * Removes submitted values from a list of issue objects so they can be
- * exposed to clients. Values are replaced by a type/size description under
- * `<key>Type`.
+ * exposed to clients or logged. Values are replaced by a type/size
+ * description under `<key>Type`; `__proto__`, `constructor` and `prototype`
+ * keys are dropped.
  */
 export declare function redactIssueValues<T>(issues: readonly T[]): readonly T[];
 /**

package/dist/domain/shared/domainError.helpers.js

@@ -7,9 +7,15 @@
  */
 /** Default maximum length for untrusted strings embedded in messages. */
 export const MAX_MESSAGE_FRAGMENT_LENGTH = 200;
-/** Control characters (C0 range, DEL, and C1 range) that must not reach logs. */
+/**
+ * Characters that must not reach logs: C0, DEL and C1 controls, the Unicode
+ * line and paragraph separators (U+2028/U+2029, which break log lines in
+ * viewers that honour them), and the bidirectional marks, embeddings,
+ * overrides and isolates (U+061C, U+200E/F, U+202A-E, U+2066-9), which can
+ * visually reorder a log line.
+ */
 // eslint-disable-next-line no-control-regex
-const CONTROL_CHARS = /[\u0000-\u001f\u007f-\u009f]/g;
+const CONTROL_CHARS = /[\u0000-\u001f\u007f-\u009f\u061c\u200e\u200f\u2028\u2029\u202a-\u202e\u2066-\u2069]/g;
 /** Default maximum length for untrusted strings stored in metadata. */
 export const MAX_METADATA_FRAGMENT_LENGTH = 1024;
 /**
@@ -48,16 +54,22 @@ export function safeStringify(value, maxLength = MAX_METADATA_FRAGMENT_LENGTH) {
             text = "undefined";
         }
         else {
-            const seen = new WeakSet();
-            const json = JSON.stringify(value, (_key, item) => {
+            // Track the ancestor path, not every object visited: a sub-object
+            // shared by two siblings is repeated data, not a cycle.
+            const ancestors = [];
+            const json = JSON.stringify(value, function replacer(_key, item) {
                 if (typeof item === "bigint")
                     return `${item.toString()}n`;
                 if (typeof item === "symbol")
                     return item.toString();
                 if (typeof item === "object" && item !== null) {
-                    if (seen.has(item))
+                    while (ancestors.length > 0 &&
+                        ancestors[ancestors.length - 1] !== this) {
+                        ancestors.pop();
+                    }
+                    if (ancestors.includes(item))
                         return "[Circular]";
-                    seen.add(item);
+                    ancestors.push(item);
                 }
                 return item;
             });
@@ -150,12 +162,22 @@ export function normalizeRetryAfterSeconds(value, name = "retryAfterSeconds") {
 export function mergeMetadata(callerMetadata, own) {
     return { ...(callerMetadata ?? {}), ...own };
 }
+/**
+ * Keys never copied into a redacted issue: assigning an own `__proto__` key
+ * (which a JSON round-trip creates) to a plain object replaces its prototype.
+ */
+const FORBIDDEN_ISSUE_KEYS = new Set([
+    "__proto__",
+    "constructor",
+    "prototype",
+]);
 /** Keys that hold submitted values inside validation/schema issues. */
 const VALUE_KEYS = new Set(["value", "received", "input", "actual"]);
 /**
  * Removes submitted values from a list of issue objects so they can be
- * exposed to clients. Values are replaced by a type/size description under
- * `<key>Type`.
+ * exposed to clients or logged. Values are replaced by a type/size
+ * description under `<key>Type`; `__proto__`, `constructor` and `prototype`
+ * keys are dropped.
  */
 export function redactIssueValues(issues) {
     return issues.map((issue) => {
@@ -164,6 +186,8 @@ export function redactIssueValues(issues) {
         }
         const out = {};
         for (const [key, val] of Object.entries(issue)) {
+            if (FORBIDDEN_ISSUE_KEYS.has(key))
+                continue;
             if (VALUE_KEYS.has(key)) {
                 out[`${key}Type`] = describeValue(val);
             }

package/dist/domain/state/validationError.base.d.ts

@@ -34,9 +34,10 @@ export declare class ValidationError extends BaseError {
     /**
      * Returns a serialized representation including validation issues.
      *
-     * When the error is exposable (the default), submitted values inside
-     * issues (`value`) are replaced by a type/size description so that secrets
-     * such as passwords are never echoed to clients or written to logs. The
+     * Submitted values inside issues (`value`, `received`, `input`, `actual`)
+     * are always replaced by a type/size description, whether or not the error
+     * is exposable, so that secrets such as passwords are never echoed to
+     * clients or written to logs. The raw values remain on `error.issues`. The
      * output is always JSON-safe (BigInt and cyclic values are stringified).
      */
     toJSON(): {

package/dist/domain/state/validationError.base.js

@@ -35,16 +35,17 @@ export class ValidationError extends BaseError {
     /**
      * Returns a serialized representation including validation issues.
      *
-     * When the error is exposable (the default), submitted values inside
-     * issues (`value`) are replaced by a type/size description so that secrets
-     * such as passwords are never echoed to clients or written to logs. The
+     * Submitted values inside issues (`value`, `received`, `input`, `actual`)
+     * are always replaced by a type/size description, whether or not the error
+     * is exposable, so that secrets such as passwords are never echoed to
+     * clients or written to logs. The raw values remain on `error.issues`. The
      * output is always JSON-safe (BigInt and cyclic values are stringified).
      */
     toJSON() {
         const safeIssues = toJsonSafeIssues(this.issues);
         return {
             ...super.toJSON(),
-            issues: this.expose ? redactIssueValues(safeIssues) : safeIssues,
+            issues: redactIssueValues(safeIssues),
         };
     }
 }

package/dist/domain/transaction/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/errors/domain/transaction
+ *
+ * Transaction lifecycle errors (state, timeout, commit, rollback, adapter,
+ * propagation, isolation, savepoint, presence, capability).
+ */
+export * from "./transactionError.base.js";
+export * from "./transactionError.types.js";
+export * from "./transactionError.misc.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/transaction/index.js

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/errors/domain/transaction
+ *
+ * Transaction lifecycle errors (state, timeout, commit, rollback, adapter,
+ * propagation, isolation, savepoint, presence, capability).
+ */
+export * from "./transactionError.base.js";
+export * from "./transactionError.types.js";
+export * from "./transactionError.misc.js";
+//# sourceMappingURL=index.js.map

package/dist/domain/transaction/transactionError.base.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Base transaction error, owned here so `@zudojs/transactions` can re-export
+ * it and `instanceof` matches across both import paths.
+ */
+import { BaseError } from "../../base/core/baseError.core.js";
+import { ErrorCode } from "../../base/types/errorCode.type.js";
+import type { ErrorMetadata } from "../../base/core/errorMetadata.type.js";
+/** Options accepted by {@link TransactionError}. */
+export interface TransactionErrorOptions {
+    readonly code?: ErrorCode;
+    readonly metadata?: ErrorMetadata;
+    readonly cause?: unknown;
+}
+/** Base error for all transaction-related failures. */
+export declare class TransactionError extends BaseError {
+    constructor(message: string, options?: TransactionErrorOptions);
+}
+//# sourceMappingURL=transactionError.base.d.ts.map

package/dist/domain/transaction/transactionError.base.js

@@ -0,0 +1,21 @@
+/**
+ * Base transaction error, owned here so `@zudojs/transactions` can re-export
+ * it and `instanceof` matches across both import paths.
+ */
+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";
+/** Base error for all transaction-related failures. */
+export class TransactionError extends BaseError {
+    constructor(message, options) {
+        super(message, {
+            code: options?.code ?? ErrorCode.OPERATION_FAILED,
+            category: ErrorCategory.DATABASE,
+            severity: ErrorSeverity.ERROR,
+            metadata: options?.metadata,
+            cause: options?.cause,
+        });
+    }
+}
+//# sourceMappingURL=transactionError.base.js.map

package/dist/domain/transaction/transactionError.misc.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Remaining transaction error subclasses (isolation, savepoints, presence,
+ * capabilities).
+ */
+import { TransactionError } from "./transactionError.base.js";
+/** Required isolation level is not supported by the adapter. */
+export declare class TransactionIsolationError extends TransactionError {
+    constructor(level: string);
+}
+/** Savepoint operation failed. */
+export declare class SavepointError extends TransactionError {
+    constructor(message: string, cause?: unknown);
+}
+/** A transaction is required but none exists. */
+export declare class TransactionRequiredError extends TransactionError {
+    constructor();
+}
+/** A transaction exists but none was expected. */
+export declare class TransactionUnexpectedError extends TransactionError {
+    constructor();
+}
+/** The adapter does not support the requested capability. */
+export declare class TransactionCapabilityError extends TransactionError {
+    constructor(capability: string);
+}
+//# sourceMappingURL=transactionError.misc.d.ts.map