crypto-aio 0.0.2 → 0.1.0

package/dist/core/errors/codes.d.ts

@@ -0,0 +1,153 @@
+export type ErrorCategory = 'config' | 'unsupported' | 'validation' | 'provider' | 'chain' | 'signing' | 'state' | 'timeout';
+/** Frozen, with every entry: the table is shared by every error and every caller. */
+export declare const ERROR_CODES: {
+    readonly CONFIG_INVALID: {
+        readonly category: "config";
+        readonly retryable: false;
+    };
+    readonly DEPENDENCY_MISSING: {
+        readonly category: "config";
+        readonly retryable: false;
+    };
+    readonly INCOMPATIBLE_SELECTION: {
+        readonly category: "config";
+        readonly retryable: false;
+    };
+    readonly UNSUPPORTED_CAPABILITY: {
+        readonly category: "unsupported";
+        readonly retryable: false;
+    };
+    readonly INVALID_ADDRESS: {
+        readonly category: "validation";
+        readonly retryable: false;
+    };
+    readonly INVALID_AMOUNT: {
+        readonly category: "validation";
+        readonly retryable: false;
+    };
+    readonly ASSET_RESOLUTION: {
+        readonly category: "validation";
+        readonly retryable: false;
+    };
+    readonly INVALID_INTENT: {
+        readonly category: "validation";
+        readonly retryable: false;
+    };
+    readonly PROVIDER_UNAVAILABLE: {
+        readonly category: "provider";
+        readonly retryable: true;
+    };
+    readonly RATE_LIMITED: {
+        readonly category: "provider";
+        readonly retryable: true;
+    };
+    readonly PROVIDER_MISCONFIGURED: {
+        readonly category: "provider";
+        readonly retryable: false;
+    };
+    readonly PROVIDER_INCONSISTENT: {
+        readonly category: "provider";
+        readonly retryable: true;
+    };
+    readonly RPC_ERROR: {
+        readonly category: "provider";
+        readonly retryable: false;
+    };
+    readonly INSUFFICIENT_FUNDS: {
+        readonly category: "chain";
+        readonly retryable: false;
+    };
+    readonly NONCE_CONFLICT: {
+        readonly category: "chain";
+        readonly retryable: false;
+    };
+    readonly NONCE_TOO_HIGH: {
+        readonly category: "chain";
+        readonly retryable: false;
+    };
+    readonly FEE_TOO_LOW: {
+        readonly category: "chain";
+        readonly retryable: false;
+    };
+    readonly TX_REFUSED: {
+        readonly category: "chain";
+        readonly retryable: false;
+    };
+    readonly TX_REJECTED: {
+        readonly category: "chain";
+        readonly retryable: false;
+    };
+    readonly TX_REVERTED: {
+        readonly category: "chain";
+        readonly retryable: false;
+    };
+    readonly TX_EXPIRED: {
+        readonly category: "chain";
+        readonly retryable: false;
+    };
+    readonly TX_REPLACED: {
+        readonly category: "chain";
+        readonly retryable: false;
+    };
+    readonly SIGNER_UNAVAILABLE: {
+        readonly category: "signing";
+        readonly retryable: false;
+    };
+    readonly SIGNING_FAILED: {
+        readonly category: "signing";
+        readonly retryable: false;
+    };
+    readonly SIGNATURE_MISMATCH: {
+        readonly category: "signing";
+        readonly retryable: false;
+    };
+    readonly POLICY_REJECTED: {
+        readonly category: "signing";
+        readonly retryable: false;
+    };
+    readonly KEY_NOT_EXPORTABLE: {
+        readonly category: "signing";
+        readonly retryable: false;
+    };
+    readonly IDEMPOTENCY_CONFLICT: {
+        readonly category: "state";
+        readonly retryable: false;
+    };
+    readonly FENCING: {
+        readonly category: "state";
+        readonly retryable: false;
+    };
+    readonly VERSION_CONFLICT: {
+        readonly category: "state";
+        readonly retryable: true;
+    };
+    readonly INVALID_TRANSITION: {
+        readonly category: "state";
+        readonly retryable: false;
+    };
+    readonly NOT_FOUND: {
+        readonly category: "state";
+        readonly retryable: false;
+    };
+    readonly SEQUENCE_BUSY: {
+        readonly category: "state";
+        readonly retryable: true;
+    };
+    /** The outcome may have happened (e.g. a delivered broadcast) but was not recorded. */
+    readonly STATE_UNRECORDED: {
+        readonly category: "state";
+        readonly retryable: true;
+    };
+    readonly SCANNER_REORG_TOO_DEEP: {
+        readonly category: "state";
+        readonly retryable: false;
+    };
+    readonly TIMEOUT: {
+        readonly category: "timeout";
+        readonly retryable: true;
+    };
+};
+export type ErrorCode = keyof typeof ERROR_CODES;
+export type CodesOf<C extends ErrorCategory> = {
+    [K in ErrorCode]: (typeof ERROR_CODES)[K]['category'] extends C ? K : never;
+}[ErrorCode];

package/dist/core/errors/codes.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERROR_CODES = void 0;
+/** Frozen, with every entry: the table is shared by every error and every caller. */
+exports.ERROR_CODES = deepFreezeCodes({
+    CONFIG_INVALID: { category: 'config', retryable: false },
+    DEPENDENCY_MISSING: { category: 'config', retryable: false },
+    INCOMPATIBLE_SELECTION: { category: 'config', retryable: false },
+    UNSUPPORTED_CAPABILITY: { category: 'unsupported', retryable: false },
+    INVALID_ADDRESS: { category: 'validation', retryable: false },
+    INVALID_AMOUNT: { category: 'validation', retryable: false },
+    ASSET_RESOLUTION: { category: 'validation', retryable: false },
+    INVALID_INTENT: { category: 'validation', retryable: false },
+    PROVIDER_UNAVAILABLE: { category: 'provider', retryable: true },
+    RATE_LIMITED: { category: 'provider', retryable: true },
+    PROVIDER_MISCONFIGURED: { category: 'provider', retryable: false },
+    PROVIDER_INCONSISTENT: { category: 'provider', retryable: true },
+    RPC_ERROR: { category: 'provider', retryable: false },
+    INSUFFICIENT_FUNDS: { category: 'chain', retryable: false },
+    NONCE_CONFLICT: { category: 'chain', retryable: false },
+    NONCE_TOO_HIGH: { category: 'chain', retryable: false },
+    FEE_TOO_LOW: { category: 'chain', retryable: false },
+    TX_REFUSED: { category: 'chain', retryable: false },
+    TX_REJECTED: { category: 'chain', retryable: false },
+    TX_REVERTED: { category: 'chain', retryable: false },
+    TX_EXPIRED: { category: 'chain', retryable: false },
+    TX_REPLACED: { category: 'chain', retryable: false },
+    SIGNER_UNAVAILABLE: { category: 'signing', retryable: false },
+    SIGNING_FAILED: { category: 'signing', retryable: false },
+    SIGNATURE_MISMATCH: { category: 'signing', retryable: false },
+    POLICY_REJECTED: { category: 'signing', retryable: false },
+    KEY_NOT_EXPORTABLE: { category: 'signing', retryable: false },
+    IDEMPOTENCY_CONFLICT: { category: 'state', retryable: false },
+    FENCING: { category: 'state', retryable: false },
+    VERSION_CONFLICT: { category: 'state', retryable: true },
+    INVALID_TRANSITION: { category: 'state', retryable: false },
+    NOT_FOUND: { category: 'state', retryable: false },
+    SEQUENCE_BUSY: { category: 'state', retryable: true },
+    /** The outcome may have happened (e.g. a delivered broadcast) but was not recorded. */
+    STATE_UNRECORDED: { category: 'state', retryable: true },
+    SCANNER_REORG_TOO_DEEP: { category: 'state', retryable: false },
+    TIMEOUT: { category: 'timeout', retryable: true },
+});
+function deepFreezeCodes(codes) {
+    for (const definition of Object.values(codes))
+        Object.freeze(definition);
+    return Object.freeze(codes);
+}
+//# sourceMappingURL=codes.js.map

package/dist/core/errors/codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.js","sourceRoot":"","sources":["../../../src/core/errors/codes.ts"],"names":[],"mappings":"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","sourcesContent":["export type ErrorCategory =\n  | 'config'\n  | 'unsupported'\n  | 'validation'\n  | 'provider'\n  | 'chain'\n  | 'signing'\n  | 'state'\n  | 'timeout';\n\ninterface CodeDefinition {\n  readonly category: ErrorCategory;\n  readonly retryable: boolean;\n}\n\n/** Frozen, with every entry: the table is shared by every error and every caller. */\nexport const ERROR_CODES = deepFreezeCodes({\n  CONFIG_INVALID: { category: 'config', retryable: false },\n  DEPENDENCY_MISSING: { category: 'config', retryable: false },\n  INCOMPATIBLE_SELECTION: { category: 'config', retryable: false },\n  UNSUPPORTED_CAPABILITY: { category: 'unsupported', retryable: false },\n  INVALID_ADDRESS: { category: 'validation', retryable: false },\n  INVALID_AMOUNT: { category: 'validation', retryable: false },\n  ASSET_RESOLUTION: { category: 'validation', retryable: false },\n  INVALID_INTENT: { category: 'validation', retryable: false },\n  PROVIDER_UNAVAILABLE: { category: 'provider', retryable: true },\n  RATE_LIMITED: { category: 'provider', retryable: true },\n  PROVIDER_MISCONFIGURED: { category: 'provider', retryable: false },\n  PROVIDER_INCONSISTENT: { category: 'provider', retryable: true },\n  RPC_ERROR: { category: 'provider', retryable: false },\n  INSUFFICIENT_FUNDS: { category: 'chain', retryable: false },\n  NONCE_CONFLICT: { category: 'chain', retryable: false },\n  NONCE_TOO_HIGH: { category: 'chain', retryable: false },\n  FEE_TOO_LOW: { category: 'chain', retryable: false },\n  TX_REFUSED: { category: 'chain', retryable: false },\n  TX_REJECTED: { category: 'chain', retryable: false },\n  TX_REVERTED: { category: 'chain', retryable: false },\n  TX_EXPIRED: { category: 'chain', retryable: false },\n  TX_REPLACED: { category: 'chain', retryable: false },\n  SIGNER_UNAVAILABLE: { category: 'signing', retryable: false },\n  SIGNING_FAILED: { category: 'signing', retryable: false },\n  SIGNATURE_MISMATCH: { category: 'signing', retryable: false },\n  POLICY_REJECTED: { category: 'signing', retryable: false },\n  KEY_NOT_EXPORTABLE: { category: 'signing', retryable: false },\n  IDEMPOTENCY_CONFLICT: { category: 'state', retryable: false },\n  FENCING: { category: 'state', retryable: false },\n  VERSION_CONFLICT: { category: 'state', retryable: true },\n  INVALID_TRANSITION: { category: 'state', retryable: false },\n  NOT_FOUND: { category: 'state', retryable: false },\n  SEQUENCE_BUSY: { category: 'state', retryable: true },\n  /** The outcome may have happened (e.g. a delivered broadcast) but was not recorded. */\n  STATE_UNRECORDED: { category: 'state', retryable: true },\n  SCANNER_REORG_TOO_DEEP: { category: 'state', retryable: false },\n  TIMEOUT: { category: 'timeout', retryable: true },\n} as const satisfies Record<string, CodeDefinition>);\n\nfunction deepFreezeCodes<T extends Record<string, CodeDefinition>>(codes: T): T {\n  for (const definition of Object.values(codes)) Object.freeze(definition);\n  return Object.freeze(codes);\n}\n\nexport type ErrorCode = keyof typeof ERROR_CODES;\n\nexport type CodesOf<C extends ErrorCategory> = {\n  [K in ErrorCode]: (typeof ERROR_CODES)[K]['category'] extends C ? K : never;\n}[ErrorCode];\n"]}

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

@@ -0,0 +1,66 @@
+import { type CodesOf, type ErrorCategory, type ErrorCode } from './codes';
+export type { CodesOf, ErrorCategory, ErrorCode } from './codes';
+export type ErrorContextValue = string | number | boolean | undefined;
+export type ErrorContext = Readonly<Record<string, ErrorContextValue>>;
+export interface CryptoAioErrorOptions {
+    readonly cause?: unknown;
+    readonly context?: ErrorContext;
+    readonly details?: Readonly<Record<string, unknown>>;
+    readonly retryable?: boolean;
+    readonly ambiguous?: boolean;
+}
+export interface SerializedError {
+    readonly name: string;
+    readonly code: ErrorCode;
+    readonly category: ErrorCategory;
+    readonly message: string;
+    readonly retryable: boolean;
+    readonly ambiguous: boolean;
+    readonly context: ErrorContext;
+    readonly details?: Readonly<Record<string, unknown>>;
+}
+export declare class CryptoAioError extends Error {
+    readonly code: ErrorCode;
+    readonly category: ErrorCategory;
+    readonly retryable: boolean;
+    readonly ambiguous: boolean;
+    readonly context: ErrorContext;
+    readonly details?: Readonly<Record<string, unknown>>;
+    constructor(code: ErrorCode, message: string, options?: CryptoAioErrorOptions);
+    toJSON(): SerializedError;
+}
+export declare class ConfigError extends CryptoAioError {
+    constructor(code: CodesOf<'config'>, message: string, options?: CryptoAioErrorOptions);
+}
+export declare class UnsupportedCapabilityError extends CryptoAioError {
+    constructor(code: CodesOf<'unsupported'>, message: string, options?: CryptoAioErrorOptions);
+}
+export declare class ValidationError extends CryptoAioError {
+    constructor(code: CodesOf<'validation'>, message: string, options?: CryptoAioErrorOptions);
+}
+export declare class ProviderError extends CryptoAioError {
+    constructor(code: CodesOf<'provider'>, message: string, options?: CryptoAioErrorOptions);
+}
+export declare class ChainError extends CryptoAioError {
+    constructor(code: CodesOf<'chain'>, message: string, options?: CryptoAioErrorOptions);
+}
+export declare class SigningError extends CryptoAioError {
+    constructor(code: CodesOf<'signing'>, message: string, options?: CryptoAioErrorOptions);
+}
+export declare class StateError extends CryptoAioError {
+    constructor(code: CodesOf<'state'>, message: string, options?: CryptoAioErrorOptions);
+}
+export declare class TimeoutError extends CryptoAioError {
+    constructor(code: CodesOf<'timeout'>, message: string, options?: CryptoAioErrorOptions);
+}
+export declare function createError(code: ErrorCode, message: string, options?: CryptoAioErrorOptions): CryptoAioError;
+export declare function isCryptoAioError(value: unknown, code?: ErrorCode): value is CryptoAioError;
+/**
+ * Returns a copy of `error` (same class, same stack) with merged context, and optional flag
+ * and `details` overrides. The copy keeps the stack of the error it reports.
+ */
+export declare function withContext(error: CryptoAioError, context: ErrorContext, overrides?: {
+    readonly ambiguous?: boolean;
+    readonly retryable?: boolean;
+    readonly details?: Readonly<Record<string, unknown>>;
+}): CryptoAioError;

package/dist/core/errors/error.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeoutError = exports.StateError = exports.SigningError = exports.ChainError = exports.ProviderError = exports.ValidationError = exports.UnsupportedCapabilityError = exports.ConfigError = exports.CryptoAioError = void 0;
+exports.createError = createError;
+exports.isCryptoAioError = isCryptoAioError;
+exports.withContext = withContext;
+const codes_1 = require("./codes");
+class CryptoAioError extends Error {
+    code;
+    category;
+    retryable;
+    ambiguous;
+    context;
+    details;
+    constructor(code, message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = new.target.name;
+        const definition = codes_1.ERROR_CODES[code];
+        this.code = code;
+        this.category = definition.category;
+        this.retryable = options.retryable ?? definition.retryable;
+        this.ambiguous = options.ambiguous ?? false;
+        this.context = Object.freeze({ ...options.context });
+        if (options.details)
+            this.details = Object.freeze({ ...options.details });
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            category: this.category,
+            message: this.message,
+            retryable: this.retryable,
+            ambiguous: this.ambiguous,
+            context: this.context,
+            ...(this.details ? { details: this.details } : {}),
+        };
+    }
+}
+exports.CryptoAioError = CryptoAioError;
+class ConfigError extends CryptoAioError {
+    constructor(code, message, options) {
+        super(code, message, options);
+    }
+}
+exports.ConfigError = ConfigError;
+class UnsupportedCapabilityError extends CryptoAioError {
+    constructor(code, message, options) {
+        super(code, message, options);
+    }
+}
+exports.UnsupportedCapabilityError = UnsupportedCapabilityError;
+class ValidationError extends CryptoAioError {
+    constructor(code, message, options) {
+        super(code, message, options);
+    }
+}
+exports.ValidationError = ValidationError;
+class ProviderError extends CryptoAioError {
+    constructor(code, message, options) {
+        super(code, message, options);
+    }
+}
+exports.ProviderError = ProviderError;
+class ChainError extends CryptoAioError {
+    constructor(code, message, options) {
+        super(code, message, options);
+    }
+}
+exports.ChainError = ChainError;
+class SigningError extends CryptoAioError {
+    constructor(code, message, options) {
+        super(code, message, options);
+    }
+}
+exports.SigningError = SigningError;
+class StateError extends CryptoAioError {
+    constructor(code, message, options) {
+        super(code, message, options);
+    }
+}
+exports.StateError = StateError;
+class TimeoutError extends CryptoAioError {
+    constructor(code, message, options) {
+        super(code, message, options);
+    }
+}
+exports.TimeoutError = TimeoutError;
+const BY_CATEGORY = {
+    config: ConfigError,
+    unsupported: UnsupportedCapabilityError,
+    validation: ValidationError,
+    provider: ProviderError,
+    chain: ChainError,
+    signing: SigningError,
+    state: StateError,
+    timeout: TimeoutError,
+};
+function createError(code, message, options) {
+    const Ctor = BY_CATEGORY[codes_1.ERROR_CODES[code].category];
+    return new Ctor(code, message, options);
+}
+function isCryptoAioError(value, code) {
+    return value instanceof CryptoAioError && (code === undefined || value.code === code);
+}
+/**
+ * Returns a copy of `error` (same class, same stack) with merged context, and optional flag
+ * and `details` overrides. The copy keeps the stack of the error it reports.
+ */
+function withContext(error, context, overrides = {}) {
+    const Ctor = error.constructor;
+    const details = overrides.details ?? error.details;
+    const copy = new Ctor(error.code, error.message, {
+        cause: error.cause,
+        context: { ...error.context, ...context },
+        ...(details ? { details } : {}),
+        retryable: overrides.retryable ?? error.retryable,
+        ambiguous: overrides.ambiguous ?? error.ambiguous,
+    });
+    if (error.stack !== undefined) {
+        Object.defineProperty(copy, 'stack', {
+            value: error.stack,
+            writable: true,
+            configurable: true,
+        });
+    }
+    return copy;
+}
+//# sourceMappingURL=error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../src/core/errors/error.ts"],"names":[],"mappings":"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","sourcesContent":["import { ERROR_CODES, type CodesOf, type ErrorCategory, type ErrorCode } from './codes';\n\nexport type { CodesOf, ErrorCategory, ErrorCode } from './codes';\n\nexport type ErrorContextValue = string | number | boolean | undefined;\nexport type ErrorContext = Readonly<Record<string, ErrorContextValue>>;\n\nexport interface CryptoAioErrorOptions {\n  readonly cause?: unknown;\n  readonly context?: ErrorContext;\n  readonly details?: Readonly<Record<string, unknown>>;\n  readonly retryable?: boolean;\n  readonly ambiguous?: boolean;\n}\n\nexport interface SerializedError {\n  readonly name: string;\n  readonly code: ErrorCode;\n  readonly category: ErrorCategory;\n  readonly message: string;\n  readonly retryable: boolean;\n  readonly ambiguous: boolean;\n  readonly context: ErrorContext;\n  readonly details?: Readonly<Record<string, unknown>>;\n}\n\nexport class CryptoAioError extends Error {\n  readonly code: ErrorCode;\n  readonly category: ErrorCategory;\n  readonly retryable: boolean;\n  readonly ambiguous: boolean;\n  readonly context: ErrorContext;\n  readonly details?: Readonly<Record<string, unknown>>;\n\n  constructor(code: ErrorCode, message: string, options: CryptoAioErrorOptions = {}) {\n    super(message, options.cause === undefined ? undefined : { cause: options.cause });\n    this.name = new.target.name;\n    const definition = ERROR_CODES[code];\n    this.code = code;\n    this.category = definition.category;\n    this.retryable = options.retryable ?? definition.retryable;\n    this.ambiguous = options.ambiguous ?? false;\n    this.context = Object.freeze({ ...options.context });\n    if (options.details) this.details = Object.freeze({ ...options.details });\n  }\n\n  toJSON(): SerializedError {\n    return {\n      name: this.name,\n      code: this.code,\n      category: this.category,\n      message: this.message,\n      retryable: this.retryable,\n      ambiguous: this.ambiguous,\n      context: this.context,\n      ...(this.details ? { details: this.details } : {}),\n    };\n  }\n}\n\nexport class ConfigError extends CryptoAioError {\n  constructor(code: CodesOf<'config'>, message: string, options?: CryptoAioErrorOptions) {\n    super(code, message, options);\n  }\n}\nexport class UnsupportedCapabilityError extends CryptoAioError {\n  constructor(\n    code: CodesOf<'unsupported'>,\n    message: string,\n    options?: CryptoAioErrorOptions,\n  ) {\n    super(code, message, options);\n  }\n}\nexport class ValidationError extends CryptoAioError {\n  constructor(\n    code: CodesOf<'validation'>,\n    message: string,\n    options?: CryptoAioErrorOptions,\n  ) {\n    super(code, message, options);\n  }\n}\nexport class ProviderError extends CryptoAioError {\n  constructor(\n    code: CodesOf<'provider'>,\n    message: string,\n    options?: CryptoAioErrorOptions,\n  ) {\n    super(code, message, options);\n  }\n}\nexport class ChainError extends CryptoAioError {\n  constructor(code: CodesOf<'chain'>, message: string, options?: CryptoAioErrorOptions) {\n    super(code, message, options);\n  }\n}\nexport class SigningError extends CryptoAioError {\n  constructor(\n    code: CodesOf<'signing'>,\n    message: string,\n    options?: CryptoAioErrorOptions,\n  ) {\n    super(code, message, options);\n  }\n}\nexport class StateError extends CryptoAioError {\n  constructor(code: CodesOf<'state'>, message: string, options?: CryptoAioErrorOptions) {\n    super(code, message, options);\n  }\n}\nexport class TimeoutError extends CryptoAioError {\n  constructor(\n    code: CodesOf<'timeout'>,\n    message: string,\n    options?: CryptoAioErrorOptions,\n  ) {\n    super(code, message, options);\n  }\n}\n\ntype AnyErrorConstructor = new (\n  code: ErrorCode,\n  message: string,\n  options?: CryptoAioErrorOptions,\n) => CryptoAioError;\n\nconst BY_CATEGORY: Record<ErrorCategory, AnyErrorConstructor> = {\n  config: ConfigError as AnyErrorConstructor,\n  unsupported: UnsupportedCapabilityError as AnyErrorConstructor,\n  validation: ValidationError as AnyErrorConstructor,\n  provider: ProviderError as AnyErrorConstructor,\n  chain: ChainError as AnyErrorConstructor,\n  signing: SigningError as AnyErrorConstructor,\n  state: StateError as AnyErrorConstructor,\n  timeout: TimeoutError as AnyErrorConstructor,\n};\n\nexport function createError(\n  code: ErrorCode,\n  message: string,\n  options?: CryptoAioErrorOptions,\n): CryptoAioError {\n  const Ctor = BY_CATEGORY[ERROR_CODES[code].category];\n  return new Ctor(code, message, options);\n}\n\nexport function isCryptoAioError(\n  value: unknown,\n  code?: ErrorCode,\n): value is CryptoAioError {\n  return value instanceof CryptoAioError && (code === undefined || value.code === code);\n}\n\n/**\n * Returns a copy of `error` (same class, same stack) with merged context, and optional flag\n * and `details` overrides. The copy keeps the stack of the error it reports.\n */\nexport function withContext(\n  error: CryptoAioError,\n  context: ErrorContext,\n  overrides: {\n    readonly ambiguous?: boolean;\n    readonly retryable?: boolean;\n    readonly details?: Readonly<Record<string, unknown>>;\n  } = {},\n): CryptoAioError {\n  const Ctor = error.constructor as AnyErrorConstructor;\n  const details = overrides.details ?? error.details;\n  const copy = new Ctor(error.code, error.message, {\n    cause: error.cause,\n    context: { ...error.context, ...context },\n    ...(details ? { details } : {}),\n    retryable: overrides.retryable ?? error.retryable,\n    ambiguous: overrides.ambiguous ?? error.ambiguous,\n  });\n  if (error.stack !== undefined) {\n    Object.defineProperty(copy, 'stack', {\n      value: error.stack,\n      writable: true,\n      configurable: true,\n    });\n  }\n  return copy;\n}\n"]}

package/dist/core/events/bus.d.ts

@@ -0,0 +1,12 @@
+import type { Clock } from '../util/clock';
+import type { Logger } from './logger';
+import type { AioEvent, AioEventName, AioEvents } from './types';
+export declare class EventBus {
+    #private;
+    private readonly clock;
+    private readonly log;
+    constructor(clock: Clock, log: Logger);
+    on<E extends AioEventName>(type: E, handler: (event: AioEvent<E>) => void): () => void;
+    onAny(handler: (event: AioEvent) => void): () => void;
+    emit<E extends AioEventName>(type: E, payload: AioEvents[E]): void;
+}

package/dist/core/events/bus.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventBus = void 0;
+const error_1 = require("../errors/error");
+class EventBus {
+    clock;
+    log;
+    #handlers = new Map();
+    #any = new Set();
+    constructor(clock, log) {
+        this.clock = clock;
+        this.log = log;
+    }
+    on(type, handler) {
+        const set = this.#handlers.get(type) ?? new Set();
+        this.#handlers.set(type, set);
+        const h = handler;
+        set.add(h);
+        return () => {
+            set.delete(h);
+        };
+    }
+    onAny(handler) {
+        this.#any.add(handler);
+        return () => {
+            this.#any.delete(handler);
+        };
+    }
+    emit(type, payload) {
+        const event = { ...payload, type, at: this.clock.now() };
+        for (const handler of [...(this.#handlers.get(type) ?? []), ...this.#any]) {
+            try {
+                handler(event);
+            }
+            catch (error) {
+                // The code only; a handler's error message may carry anything.
+                this.log.warn('event handler threw', {
+                    type,
+                    code: (0, error_1.isCryptoAioError)(error) ? error.code : 'UNKNOWN',
+                });
+            }
+        }
+    }
+}
+exports.EventBus = EventBus;
+//# sourceMappingURL=bus.js.map

package/dist/core/events/bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.js","sourceRoot":"","sources":["../../../src/core/events/bus.ts"],"names":[],"mappings":";;;AAAA,2CAAmD;AAOnD,MAAa,QAAQ;IAKA;IACA;IALV,SAAS,GAAG,IAAI,GAAG,EAAiC,CAAC;IACrD,IAAI,GAAG,IAAI,GAAG,EAAc,CAAC;IAEtC,YACmB,KAAY,EACZ,GAAW;QADX,UAAK,GAAL,KAAK,CAAO;QACZ,QAAG,GAAH,GAAG,CAAQ;IAC3B,CAAC;IAEJ,EAAE,CAAyB,IAAO,EAAE,OAAqC;QACvE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAc,CAAC;QAC9D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,OAAgC,CAAC;QAC3C,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACX,OAAO,GAAG,EAAE;YACV,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAkC;QACtC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAyB,IAAO,EAAE,OAAqB;QACzD,MAAM,KAAK,GAAG,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAc,CAAC;QACrE,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1E,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,+DAA+D;gBAC/D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE;oBACnC,IAAI;oBACJ,IAAI,EAAE,IAAA,wBAAgB,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;iBACvD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAxCD,4BAwCC","sourcesContent":["import { isCryptoAioError } from '../errors/error';\nimport type { Clock } from '../util/clock';\nimport type { Logger } from './logger';\nimport type { AioEvent, AioEventName, AioEvents } from './types';\n\ntype AnyHandler = (event: AioEvent) => void;\n\nexport class EventBus {\n  readonly #handlers = new Map<AioEventName, Set<AnyHandler>>();\n  readonly #any = new Set<AnyHandler>();\n\n  constructor(\n    private readonly clock: Clock,\n    private readonly log: Logger,\n  ) {}\n\n  on<E extends AioEventName>(type: E, handler: (event: AioEvent<E>) => void): () => void {\n    const set = this.#handlers.get(type) ?? new Set<AnyHandler>();\n    this.#handlers.set(type, set);\n    const h = handler as unknown as AnyHandler;\n    set.add(h);\n    return () => {\n      set.delete(h);\n    };\n  }\n\n  onAny(handler: (event: AioEvent) => void): () => void {\n    this.#any.add(handler);\n    return () => {\n      this.#any.delete(handler);\n    };\n  }\n\n  emit<E extends AioEventName>(type: E, payload: AioEvents[E]): void {\n    const event = { ...payload, type, at: this.clock.now() } as AioEvent;\n    for (const handler of [...(this.#handlers.get(type) ?? []), ...this.#any]) {\n      try {\n        handler(event);\n      } catch (error) {\n        // The code only; a handler's error message may carry anything.\n        this.log.warn('event handler threw', {\n          type,\n          code: isCryptoAioError(error) ? error.code : 'UNKNOWN',\n        });\n      }\n    }\n  }\n}\n"]}

package/dist/core/events/logger.d.ts

@@ -0,0 +1,13 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type LogFields = Readonly<Record<string, unknown>>;
+export interface Logger {
+    debug(message: string, fields?: LogFields): void;
+    info(message: string, fields?: LogFields): void;
+    warn(message: string, fields?: LogFields): void;
+    error(message: string, fields?: LogFields): void;
+    child(namespace: string): Logger;
+}
+export type LogWriter = (level: LogLevel, namespace: string, message: string, fields?: Record<string, unknown>) => void;
+/** Structured logger; fields are always redacted before they reach the writer. */
+export declare function createLogger(namespace?: string, write?: LogWriter): Logger;
+export declare const noopLogger: Logger;

package/dist/core/events/logger.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopLogger = void 0;
+exports.createLogger = createLogger;
+const debug_1 = __importDefault(require("debug"));
+const redact_1 = require("../secret/redact");
+const debuggers = new Map();
+const debugWriter = (level, namespace, message, fields) => {
+    const name = `${namespace}:${level}`;
+    let log = debuggers.get(name);
+    if (!log) {
+        log = (0, debug_1.default)(name);
+        debuggers.set(name, log);
+    }
+    if (fields && Object.keys(fields).length > 0)
+        log('%s %o', message, fields);
+    else
+        log('%s', message);
+};
+/** Structured logger; fields are always redacted before they reach the writer. */
+function createLogger(namespace = 'crypto-aio', write = debugWriter) {
+    const emit = (level) => (message, fields) => write(level, namespace, (0, redact_1.redactText)(message), fields ? (0, redact_1.redactDeep)(fields) : undefined);
+    return {
+        debug: emit('debug'),
+        info: emit('info'),
+        warn: emit('warn'),
+        error: emit('error'),
+        child: (child) => createLogger(`${namespace}:${child}`, write),
+    };
+}
+const noop = () => undefined;
+exports.noopLogger = {
+    debug: noop,
+    info: noop,
+    warn: noop,
+    error: noop,
+    child: () => exports.noopLogger,
+};
+//# sourceMappingURL=logger.js.map

package/dist/core/events/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/core/events/logger.ts"],"names":[],"mappings":";;;;;;AAmCA,oCAkBC;AArDD,kDAAgC;AAChC,6CAA0D;AAoB1D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgC,CAAC;AAE1D,MAAM,WAAW,GAAc,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;IACnE,MAAM,IAAI,GAAG,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC;IACrC,IAAI,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,IAAA,eAAW,EAAC,IAAI,CAAC,CAAC;QACxB,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;;QACvE,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC1B,CAAC,CAAC;AAEF,kFAAkF;AAClF,SAAgB,YAAY,CAC1B,SAAS,GAAG,YAAY,EACxB,QAAmB,WAAW;IAE9B,MAAM,IAAI,GAAG,CAAC,KAAe,EAAE,EAAE,CAAC,CAAC,OAAe,EAAE,MAAkB,EAAE,EAAE,CACxE,KAAK,CACH,KAAK,EACL,SAAS,EACT,IAAA,mBAAU,EAAC,OAAO,CAAC,EACnB,MAAM,CAAC,CAAC,CAAE,IAAA,mBAAU,EAAC,MAAM,CAA6B,CAAC,CAAC,CAAC,SAAS,CACrE,CAAC;IACJ,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;QACpB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;QACpB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,SAAS,IAAI,KAAK,EAAE,EAAE,KAAK,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,MAAM,IAAI,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC;AAEtB,QAAA,UAAU,GAAW;IAChC,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,GAAG,EAAE,CAAC,kBAAU;CACxB,CAAC","sourcesContent":["import createDebug from 'debug';\nimport { redactDeep, redactText } from '../secret/redact';\n\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type LogFields = Readonly<Record<string, unknown>>;\n\nexport interface Logger {\n  debug(message: string, fields?: LogFields): void;\n  info(message: string, fields?: LogFields): void;\n  warn(message: string, fields?: LogFields): void;\n  error(message: string, fields?: LogFields): void;\n  child(namespace: string): Logger;\n}\n\nexport type LogWriter = (\n  level: LogLevel,\n  namespace: string,\n  message: string,\n  fields?: Record<string, unknown>,\n) => void;\n\nconst debuggers = new Map<string, createDebug.Debugger>();\n\nconst debugWriter: LogWriter = (level, namespace, message, fields) => {\n  const name = `${namespace}:${level}`;\n  let log = debuggers.get(name);\n  if (!log) {\n    log = createDebug(name);\n    debuggers.set(name, log);\n  }\n  if (fields && Object.keys(fields).length > 0) log('%s %o', message, fields);\n  else log('%s', message);\n};\n\n/** Structured logger; fields are always redacted before they reach the writer. */\nexport function createLogger(\n  namespace = 'crypto-aio',\n  write: LogWriter = debugWriter,\n): Logger {\n  const emit = (level: LogLevel) => (message: string, fields?: LogFields) =>\n    write(\n      level,\n      namespace,\n      redactText(message),\n      fields ? (redactDeep(fields) as Record<string, unknown>) : undefined,\n    );\n  return {\n    debug: emit('debug'),\n    info: emit('info'),\n    warn: emit('warn'),\n    error: emit('error'),\n    child: (child) => createLogger(`${namespace}:${child}`, write),\n  };\n}\n\nconst noop = (): void => undefined;\n\nexport const noopLogger: Logger = {\n  debug: noop,\n  info: noop,\n  warn: noop,\n  error: noop,\n  child: () => noopLogger,\n};\n"]}