@codenhub/error 0.0.1 → 0.1.0

package/dist/index.d.ts

@@ -1,53 +1,5 @@
-import { a as ErrorPatternDefinition, c as ErrorPrefixRegistryBucket, i as ErrorFeedback, l as ErrorRegistry, n as AppErrorSource, o as ErrorPatternRegistryBucket, r as AppErrorType, s as ErrorPrefixDefinition, t as AppErrorOptions, u as ErrorRegistryBucket } from "./types-D6n8W1xw.js";
-
-//#region src/app-error.d.ts
-/** Default message used when no registry entry or fallback message can describe an error. */
-declare const DEFAULT_APP_ERROR_MESSAGE = "An unexpected error occurred.";
-/** Error class that normalizes unknown thrown or returned values into a predictable shape. */
-declare class AppError extends Error {
-  /** App-level registry used when no registry is passed to the constructor. */
-  static readonly registry: ErrorRegistry;
-  /** Creates an isolated registry without modifying the app-level registry. */
-  static createRegistry(): ErrorRegistry;
-  /** Classification assigned after registry lookup and fallback handling. */
-  readonly type: AppErrorType;
-  /** User-facing message resolved from registry feedback or fallback handling. */
-  readonly message: string;
-  /** Optional localization key from matched registry feedback. */
-  readonly messageKey: string | null;
-  /** Optional source label from matched registry feedback. */
-  readonly source: AppErrorSource;
-  /** Original value passed to the constructor, or the original value from a wrapped `AppError`. */
-  readonly originalError: unknown;
-  /** Whether retrying the failed operation is likely to help. */
-  readonly retryable: boolean;
-  /**
-   * Normalizes an unknown error value. Construction does not throw; unmatched values become `unknown` errors.
-   */
-  constructor(error: unknown, options?: AppErrorOptions);
-  private static resolve;
-}
-//#endregion
-//#region src/registry.d.ts
-/** Creates an empty, isolated registry for classifying unknown errors. */
-declare const createErrorRegistry: () => ErrorRegistry;
-//#endregion
-//#region src/result.d.ts
-/** Successful result value returned by `ok()`. */
-type Ok<T> = {
-  ok: true;
-  value: T;
-};
-/** Failed result value returned by `err()`. */
-type Err = {
-  ok: false;
-  error: AppError;
-};
-/** Result union for APIs that return success or failure without throwing. */
-type Result<T> = Ok<T> | Err;
-/** Wraps a value in a successful result. */
-declare const ok: <T>(value: T) => Ok<T>;
-/** Normalizes an unknown error value and wraps it in a failed result. */
-declare const err: (error: unknown, options?: AppErrorOptions) => Err;
-//#endregion
-export { AppError, type AppErrorOptions, type AppErrorSource, type AppErrorType, DEFAULT_APP_ERROR_MESSAGE, type Err, type ErrorFeedback, type ErrorPatternDefinition, type ErrorPatternRegistryBucket, type ErrorPrefixDefinition, type ErrorPrefixRegistryBucket, type ErrorRegistry, type ErrorRegistryBucket, type Ok, type Result, createErrorRegistry, err, ok };
+import { AppError, AppErrorOptions, AppErrorSource, AppErrorType, ErrorFeedback, ErrorPatternDefinition, ErrorPatternRegistryBucket, ErrorPrefixDefinition, ErrorPrefixRegistryBucket, ErrorRegistry, ErrorRegistryBucket, ReadonlyErrorRegistry } from "./types.js";
+import { DEFAULT_APP_ERROR_MESSAGE, createAppError, isAppError } from "./create-app-error.js";
+import { createErrorRegistry, freezeRegistry, getErrorRegistry, setErrorRegistry } from "./registry.js";
+import { Err, Ok, Result, andThen, err, map, match, ok, unwrap, unwrapOr } from "./result.js";
+export { type AppError, type AppErrorOptions, type AppErrorSource, type AppErrorType, DEFAULT_APP_ERROR_MESSAGE, type Err, type ErrorFeedback, type ErrorPatternDefinition, type ErrorPatternRegistryBucket, type ErrorPrefixDefinition, type ErrorPrefixRegistryBucket, type ErrorRegistry, type ErrorRegistryBucket, type Ok, type ReadonlyErrorRegistry, type Result, andThen, createAppError, createErrorRegistry, err, freezeRegistry, getErrorRegistry, isAppError, map, match, ok, setErrorRegistry, unwrap, unwrapOr };

package/dist/index.js

@@ -1,2 +1,4 @@
-import { a as createErrorRegistry, i as DEFAULT_APP_ERROR_MESSAGE, n as ok, r as AppError, t as err } from "./src-DrlQ39IZ.js";
-export { AppError, DEFAULT_APP_ERROR_MESSAGE, createErrorRegistry, err, ok };
+import { createErrorRegistry, freezeRegistry, getErrorRegistry, setErrorRegistry } from "./registry.js";
+import { DEFAULT_APP_ERROR_MESSAGE, createAppError, isAppError } from "./create-app-error.js";
+import { andThen, err, map, match, ok, unwrap, unwrapOr } from "./result.js";
+export { DEFAULT_APP_ERROR_MESSAGE, andThen, createAppError, createErrorRegistry, err, freezeRegistry, getErrorRegistry, isAppError, map, match, ok, setErrorRegistry, unwrap, unwrapOr };

package/dist/normalize.js

@@ -0,0 +1,125 @@
+import { normalizeErrorIdentifier } from "./bucket.js";
+//#region src/normalize.ts
+const ERROR_UNWRAP_MAX_DEPTH = 3;
+const ERROR_WRAPPER_FIELD_NAMES = [
+	"cause",
+	"originalError",
+	"error",
+	"err",
+	"inner",
+	"innerError"
+];
+const isRecord = (value) => {
+	return (typeof value === "object" || typeof value === "function") && value !== null;
+};
+const getRecordField = (source, key) => {
+	try {
+		return source[key];
+	} catch {
+		return;
+	}
+};
+const getStringField = (source, key) => {
+	const value = getRecordField(source, key);
+	return typeof value === "string" ? value : null;
+};
+const toKnownClassification = (feedback) => ({
+	type: "known",
+	message: feedback.message,
+	messageKey: feedback.messageKey ?? null,
+	source: feedback.source ?? null,
+	isRetryable: feedback.isRetryable ?? false
+});
+const toUnexpectedClassification = (feedback) => ({
+	type: "unexpected",
+	message: feedback.message,
+	messageKey: feedback.messageKey ?? null,
+	source: feedback.source ?? null,
+	isRetryable: feedback.isRetryable ?? false
+});
+const normalizeError = (error) => {
+	if (typeof error === "string") return {
+		code: null,
+		message: error,
+		name: null
+	};
+	if (!isRecord(error)) return {
+		code: null,
+		message: null,
+		name: null
+	};
+	const rawCode = getRecordField(error, "code");
+	return {
+		code: typeof rawCode === "string" ? rawCode : typeof rawCode === "number" ? String(rawCode) : null,
+		message: getStringField(error, "message"),
+		name: getStringField(error, "name")
+	};
+};
+const getWrappedErrorCandidates = (error) => {
+	if (!isRecord(error)) return [];
+	return ERROR_WRAPPER_FIELD_NAMES.map((fieldName) => getRecordField(error, fieldName)).filter((value) => value !== void 0 && value !== null);
+};
+const getErrorCandidates = (error, maxDepth = ERROR_UNWRAP_MAX_DEPTH) => {
+	const visitedObjects = /* @__PURE__ */ new Set();
+	if (isRecord(error)) visitedObjects.add(error);
+	const pendingCandidates = [{
+		depth: 0,
+		value: error
+	}];
+	const candidates = [];
+	for (let index = 0; index < pendingCandidates.length; index += 1) {
+		const candidate = pendingCandidates[index];
+		candidates.push(candidate.value);
+		if (candidate.depth >= maxDepth) continue;
+		for (const wrappedErrorCandidate of getWrappedErrorCandidates(candidate.value)) {
+			if (isRecord(wrappedErrorCandidate)) {
+				if (visitedObjects.has(wrappedErrorCandidate)) continue;
+				visitedObjects.add(wrappedErrorCandidate);
+			}
+			pendingCandidates.push({
+				depth: candidate.depth + 1,
+				value: wrappedErrorCandidate
+			});
+		}
+	}
+	return candidates;
+};
+const getKnownMessageFeedback = (registry, message) => {
+	const normalizedMessage = normalizeErrorIdentifier(message);
+	const exactFeedback = registry.messages.get(normalizedMessage);
+	if (exactFeedback !== void 0) return toKnownClassification(exactFeedback);
+	const sortedPrefixes = registry.prefixes.values();
+	for (const definition of sortedPrefixes) if (normalizedMessage.startsWith(definition.prefix)) return toKnownClassification(definition);
+	return null;
+};
+const resolveDeterministicKnownError = (registry, { code, message, name }) => {
+	if (code !== null) {
+		const feedback = registry.codes.get(code);
+		if (feedback !== void 0) return toKnownClassification(feedback);
+	}
+	if (name !== null) {
+		const feedback = registry.names.get(name);
+		if (feedback !== void 0) return toKnownClassification(feedback);
+	}
+	if (message !== null) {
+		const feedback = getKnownMessageFeedback(registry, message);
+		if (feedback !== null) return feedback;
+	}
+	return null;
+};
+const resolveHeuristicUnexpectedError = (registry, { message }) => {
+	if (message === null) return null;
+	const matchedDefinition = registry.patterns.values().find((definition) => definition.pattern.test(message));
+	if (matchedDefinition === void 0) return null;
+	return toUnexpectedClassification(matchedDefinition);
+};
+const classifyErrorCandidateKnown = (registry, error) => {
+	const normalizedError = normalizeError(error);
+	return resolveDeterministicKnownError(registry, normalizedError);
+};
+const classifyErrorCandidateUnexpected = (registry, error) => {
+	const normalizedError = normalizeError(error);
+	return resolveHeuristicUnexpectedError(registry, normalizedError);
+};
+//#endregion
+export { classifyErrorCandidateKnown, classifyErrorCandidateUnexpected, getErrorCandidates };

package/dist/registries/browser.d.ts

@@ -1,10 +1,26 @@
-import { l as ErrorRegistry } from "../types-D6n8W1xw.js";
+import { ErrorFeedback, ReadonlyErrorRegistry } from "../types.js";
 
 //#region src/registries/browser.d.ts
 /**
- * Opt-in mutable registry preset for common browser and Web API errors.
- * Importing this preset does not mutate `AppError.registry` and does not require browser globals.
+ * Raw name mapping definitions for common browser and Web API errors.
+ *
+ * Provides fallback messages, translation keys, and source labels for typical browser DOMExceptions.
  */
-declare const browserErrorRegistry: ErrorRegistry;
+declare const browserErrorNames: Record<string, ErrorFeedback>;
+/**
+ * Raw heuristic pattern mappings for common browser and Web API errors.
+ *
+ * Defines regex patterns to identify fetch failures, DNS issues, and network connection refusal.
+ */
+declare const browserErrorPatterns: readonly (readonly [RegExp, ErrorFeedback])[];
+/**
+ * An opt-in, read-only error registry pre-populated with mappings for common browser and Web API errors.
+ *
+ * Includes name mappings for DOMException types (e.g., `AbortError`, `TimeoutError`, `QuotaExceededError`)
+ * and pattern mappings for network fetch failures (e.g., DNS errors, connection refusal).
+ *
+ * Importing this registry preset does not access or require browser/DOM globals.
+ */
+declare const browserErrorRegistry: ReadonlyErrorRegistry;
 //#endregion
-export { browserErrorRegistry };
+export { browserErrorNames, browserErrorPatterns, browserErrorRegistry };

package/dist/registries/browser.js

@@ -1,32 +1,86 @@
-import { r as AppError } from "../src-DrlQ39IZ.js";
+import { createErrorRegistry, freezeRegistry } from "../registry.js";
 //#region src/registries/browser.ts
 /**
-* Opt-in mutable registry preset for common browser and Web API errors.
-* Importing this preset does not mutate `AppError.registry` and does not require browser globals.
+* Raw name mapping definitions for common browser and Web API errors.
+*
+* Provides fallback messages, translation keys, and source labels for typical browser DOMExceptions.
 */
-const browserErrorRegistry = AppError.createRegistry();
-browserErrorRegistry.names.addList([
-	["AbortError", {
+const browserErrorNames = {
+	AbortError: {
 		message: "Request cancelled.",
 		messageKey: "error.browser.abort",
 		source: "browser"
-	}],
-	["QuotaExceededError", {
+	},
+	QuotaExceededError: {
 		message: "Browser storage quota exceeded.",
 		messageKey: "error.browser.storageQuotaExceeded",
 		source: "browser.storage"
-	}],
-	["NotAllowedError", {
+	},
+	NotAllowedError: {
 		message: "Permission was denied.",
 		messageKey: "error.browser.permissionDenied",
 		source: "browser.permissions"
-	}]
-]);
-browserErrorRegistry.patterns.addList([[/failed to fetch|networkerror|load failed/i, {
+	},
+	NotFoundError: {
+		message: "The requested resource could not be found.",
+		messageKey: "error.browser.notFound",
+		source: "browser"
+	},
+	SecurityError: {
+		message: "The operation is insecure.",
+		messageKey: "error.browser.security",
+		source: "browser"
+	},
+	TimeoutError: {
+		message: "The operation timed out.",
+		messageKey: "error.browser.timeout",
+		source: "browser",
+		isRetryable: true
+	},
+	NotSupportedError: {
+		message: "The operation is not supported.",
+		messageKey: "error.browser.notSupported",
+		source: "browser"
+	},
+	InvalidStateError: {
+		message: "The operation is invalid in the current state.",
+		messageKey: "error.browser.invalidState",
+		source: "browser"
+	},
+	NetworkError: {
+		message: "A network error occurred.",
+		messageKey: "error.browser.network",
+		source: "browser.network",
+		isRetryable: true
+	}
+};
+/**
+* Raw heuristic pattern mappings for common browser and Web API errors.
+*
+* Defines regex patterns to identify fetch failures, DNS issues, and network connection refusal.
+*/
+const browserErrorPatterns = [[/failed to fetch|networkerror|load failed/i, {
 	message: "Network request failed.",
 	messageKey: "error.browser.network",
 	source: "browser.network",
-	retryable: true
-}]]);
+	isRetryable: true
+}], [/connection refused|dns_probe_finished/i, {
+	message: "Could not connect to the server.",
+	messageKey: "error.browser.connectionRefused",
+	source: "browser.network",
+	isRetryable: true
+}]];
+const registry = createErrorRegistry();
+registry.names.addList(Object.entries(browserErrorNames));
+registry.patterns.addList(browserErrorPatterns);
+/**
+* An opt-in, read-only error registry pre-populated with mappings for common browser and Web API errors.
+*
+* Includes name mappings for DOMException types (e.g., `AbortError`, `TimeoutError`, `QuotaExceededError`)
+* and pattern mappings for network fetch failures (e.g., DNS errors, connection refusal).
+*
+* Importing this registry preset does not access or require browser/DOM globals.
+*/
+const browserErrorRegistry = freezeRegistry(registry);
 //#endregion
-export { browserErrorRegistry };
+export { browserErrorNames, browserErrorPatterns, browserErrorRegistry };

package/dist/registries/index.d.ts

@@ -1,3 +1,3 @@
-import { browserErrorRegistry } from "./browser.js";
-import { supabaseErrorRegistry } from "./supabase.js";
-export { browserErrorRegistry, supabaseErrorRegistry };
+import { browserErrorNames, browserErrorPatterns, browserErrorRegistry } from "./browser.js";
+import { supabaseErrorCodes, supabaseErrorNames, supabaseErrorRegistry } from "./supabase.js";
+export { browserErrorNames, browserErrorPatterns, browserErrorRegistry, supabaseErrorCodes, supabaseErrorNames, supabaseErrorRegistry };

package/dist/registries/index.js

@@ -1,3 +1,3 @@
-import { browserErrorRegistry } from "./browser.js";
-import { supabaseErrorRegistry } from "./supabase.js";
-export { browserErrorRegistry, supabaseErrorRegistry };
+import { browserErrorNames, browserErrorPatterns, browserErrorRegistry } from "./browser.js";
+import { supabaseErrorCodes, supabaseErrorNames, supabaseErrorRegistry } from "./supabase.js";
+export { browserErrorNames, browserErrorPatterns, browserErrorRegistry, supabaseErrorCodes, supabaseErrorNames, supabaseErrorRegistry };

package/dist/registries/supabase.d.ts

@@ -1,10 +1,27 @@
-import { l as ErrorRegistry } from "../types-D6n8W1xw.js";
+import { ErrorFeedback, ReadonlyErrorRegistry } from "../types.js";
 
 //#region src/registries/supabase.d.ts
 /**
- * Opt-in mutable registry preset for common Supabase Auth, database, and function errors.
- * Importing this preset does not mutate `AppError.registry` or contact Supabase services.
+ * Raw code mapping definitions for common Supabase service errors.
+ *
+ * Includes Postgres database codes and Supabase Auth specific error codes.
  */
-declare const supabaseErrorRegistry: ErrorRegistry;
+declare const supabaseErrorCodes: Record<string, ErrorFeedback>;
+/**
+ * Raw name mapping definitions for common Supabase service errors.
+ *
+ * Includes name mappings for edge function execution issues.
+ */
+declare const supabaseErrorNames: Record<string, ErrorFeedback>;
+/**
+ * An opt-in, read-only error registry pre-populated with mappings for common Supabase service errors.
+ *
+ * Includes code mappings for Supabase Auth (e.g., rate limits, invalid credentials) and PostgreSQL
+ * database errors (e.g., foreign key violations, unique constraint violations), as well as name
+ * mappings for edge function execution issues.
+ *
+ * Importing this preset does not establish any network connection to Supabase services or require client dependencies.
+ */
+declare const supabaseErrorRegistry: ReadonlyErrorRegistry;
 //#endregion
-export { supabaseErrorRegistry };
+export { supabaseErrorCodes, supabaseErrorNames, supabaseErrorRegistry };

package/dist/registries/supabase.js

@@ -1,32 +1,131 @@
-import { r as AppError } from "../src-DrlQ39IZ.js";
+import { createErrorRegistry, freezeRegistry } from "../registry.js";
 //#region src/registries/supabase.ts
 /**
-* Opt-in mutable registry preset for common Supabase Auth, database, and function errors.
-* Importing this preset does not mutate `AppError.registry` or contact Supabase services.
+* Raw code mapping definitions for common Supabase service errors.
+*
+* Includes Postgres database codes and Supabase Auth specific error codes.
 */
-const supabaseErrorRegistry = AppError.createRegistry();
-supabaseErrorRegistry.codes.addList([
-	["invalid_credentials", {
+const supabaseErrorCodes = {
+	invalid_credentials: {
 		message: "Invalid email or password.",
 		messageKey: "error.supabase.auth.invalidCredentials",
 		source: "supabase.auth"
-	}],
-	["email_not_confirmed", {
+	},
+	email_not_confirmed: {
 		message: "Email address is not confirmed.",
 		messageKey: "error.supabase.auth.emailNotConfirmed",
 		source: "supabase.auth"
-	}],
-	["23505", {
+	},
+	user_already_exists: {
+		message: "An account with this email address already exists.",
+		messageKey: "error.supabase.auth.userAlreadyExists",
+		source: "supabase.auth"
+	},
+	signup_disabled: {
+		message: "Signups are currently disabled.",
+		messageKey: "error.supabase.auth.signupDisabled",
+		source: "supabase.auth"
+	},
+	otp_expired: {
+		message: "One-time password has expired.",
+		messageKey: "error.supabase.auth.otpExpired",
+		source: "supabase.auth"
+	},
+	sms_send_failed: {
+		message: "Failed to send SMS message.",
+		messageKey: "error.supabase.auth.smsSendFailed",
+		source: "supabase.auth",
+		isRetryable: true
+	},
+	over_sms_send_rate_limit: {
+		message: "SMS send rate limit exceeded. Please try again later.",
+		messageKey: "error.supabase.auth.overSmsSendRateLimit",
+		source: "supabase.auth"
+	},
+	over_email_send_rate_limit: {
+		message: "Email send rate limit exceeded. Please try again later.",
+		messageKey: "error.supabase.auth.overEmailSendRateLimit",
+		source: "supabase.auth"
+	},
+	invalid_grant: {
+		message: "Invalid login credentials or refresh token.",
+		messageKey: "error.supabase.auth.invalidGrant",
+		source: "supabase.auth"
+	},
+	bad_oauth_state: {
+		message: "Invalid OAuth state.",
+		messageKey: "error.supabase.auth.badOAuthState",
+		source: "supabase.auth"
+	},
+	"23505": {
 		message: "A record with this value already exists.",
 		messageKey: "error.supabase.database.uniqueViolation",
 		source: "supabase.database"
-	}]
-]);
-supabaseErrorRegistry.names.add("FunctionsHttpError", {
-	message: "Edge Function request failed.",
-	messageKey: "error.supabase.functions.http",
-	source: "supabase.functions",
-	retryable: true
-});
+	},
+	"23503": {
+		message: "Referenced record could not be found.",
+		messageKey: "error.supabase.database.foreignKeyViolation",
+		source: "supabase.database"
+	},
+	"23502": {
+		message: "A required field is missing.",
+		messageKey: "error.supabase.database.notNullViolation",
+		source: "supabase.database"
+	},
+	"42P01": {
+		message: "Database table not found.",
+		messageKey: "error.supabase.database.undefinedTable",
+		source: "supabase.database"
+	},
+	"42703": {
+		message: "Database column not found.",
+		messageKey: "error.supabase.database.undefinedColumn",
+		source: "supabase.database"
+	},
+	"57014": {
+		message: "Database query timed out or was cancelled.",
+		messageKey: "error.supabase.database.timeout",
+		source: "supabase.database",
+		isRetryable: true
+	}
+};
+/**
+* Raw name mapping definitions for common Supabase service errors.
+*
+* Includes name mappings for edge function execution issues.
+*/
+const supabaseErrorNames = {
+	FunctionsHttpError: {
+		message: "Edge Function request failed.",
+		messageKey: "error.supabase.functions.http",
+		source: "supabase.functions",
+		isRetryable: true
+	},
+	FunctionsRelayError: {
+		message: "Edge Function relay failed.",
+		messageKey: "error.supabase.functions.relay",
+		source: "supabase.functions",
+		isRetryable: true
+	},
+	FunctionsFetchError: {
+		message: "Failed to fetch Edge Function.",
+		messageKey: "error.supabase.functions.fetch",
+		source: "supabase.functions",
+		isRetryable: true
+	}
+};
+const registry = createErrorRegistry();
+registry.codes.addList(Object.entries(supabaseErrorCodes));
+registry.names.addList(Object.entries(supabaseErrorNames));
+/**
+* An opt-in, read-only error registry pre-populated with mappings for common Supabase service errors.
+*
+* Includes code mappings for Supabase Auth (e.g., rate limits, invalid credentials) and PostgreSQL
+* database errors (e.g., foreign key violations, unique constraint violations), as well as name
+* mappings for edge function execution issues.
+*
+* Importing this preset does not establish any network connection to Supabase services or require client dependencies.
+*/
+const supabaseErrorRegistry = freezeRegistry(registry);
 //#endregion
-export { supabaseErrorRegistry };
+export { supabaseErrorCodes, supabaseErrorNames, supabaseErrorRegistry };

package/dist/registry.d.ts

@@ -0,0 +1,43 @@
+import { ErrorRegistry, ReadonlyErrorRegistry } from "./types.js";
+
+//#region src/registry.d.ts
+/**
+ * Creates an empty, isolated error registry.
+ *
+ * Optionally merges a list of preset registries into the newly created registry.
+ *
+ * @param presets - Optional list of existing registries to merge during creation.
+ * @returns A new, mutable ErrorRegistry instance.
+ */
+declare const createErrorRegistry: (presets?: readonly (ErrorRegistry | ReadonlyErrorRegistry)[]) => ErrorRegistry;
+/**
+ * Retrieves the active global error registry.
+ *
+ * This registry is used as the default classification source for `createAppError`.
+ *
+ * @returns The current active ErrorRegistry.
+ */
+declare const getErrorRegistry: () => ErrorRegistry;
+/**
+ * Sets the active global error registry.
+ *
+ * Allows consumers to replace the default registry at application initialization.
+ * Throws a TypeError if the provided value is null or not an object.
+ *
+ * @param registry - The ErrorRegistry instance to set as active.
+ * @throws TypeError - If the parameter is not a valid ErrorRegistry.
+ */
+declare const setErrorRegistry: (registry: ErrorRegistry) => void;
+/**
+ * Wraps an ErrorRegistry in a read-only Proxy to prevent any future mutations.
+ *
+ * All mutating methods (such as `add`, `addList`, `clear`, `delete`) will throw a TypeError
+ * if called on a frozen registry bucket. The returned type is `ReadonlyErrorRegistry`,
+ * which only exposes the read-facing bucket surface at the type level.
+ *
+ * @param registry - The ErrorRegistry instance to freeze.
+ * @returns A read-only `ReadonlyErrorRegistry` instance.
+ */
+declare const freezeRegistry: (registry: ErrorRegistry) => ReadonlyErrorRegistry;
+//#endregion
+export { createErrorRegistry, freezeRegistry, getErrorRegistry, setErrorRegistry };