@constructive-io/errors 0.3.0

package/format.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LOCALE = void 0;
+exports.registerCatalog = registerCatalog;
+exports.format = format;
+const interpolate_1 = require("./interpolate");
+const registry_1 = require("./registry");
+/**
+ * Locale to use when `format` is called without one. This is a plain fallback
+ * label, not a special catalog: the untagged default copy lives in the registry
+ * itself, so there is no built-in `'en'` catalog to keep in sync.
+ */
+exports.DEFAULT_LOCALE = 'en';
+/**
+ * Registered locale overlays. Empty by default — the base/default message for
+ * every code is the registry entry, so a locale only needs entries for the
+ * codes it actually translates.
+ */
+const catalogs = {};
+/**
+ * Register or extend a locale catalog. Merges with any existing entries for
+ * that locale (new entries win), so hosts can override individual codes — pass
+ * the default locale to override the base copy.
+ */
+function registerCatalog(locale, catalog) {
+    catalogs[locale] = { ...catalogs[locale], ...catalog };
+}
+/** Humanize a code as a last-resort message, e.g. `LIMIT_REACHED` → `Limit reached`. */
+function humanize(code) {
+    const lower = code.toLowerCase().replace(/_/g, ' ');
+    return lower.charAt(0).toUpperCase() + lower.slice(1);
+}
+/** The registry's default message for a code (string template or function). */
+function defaultMessage(code, context) {
+    const def = (0, registry_1.getDefinition)(code);
+    if (def) {
+        if (typeof def.message === 'string')
+            return (0, interpolate_1.interpolate)(def.message, context);
+        if (typeof def.message === 'function') {
+            return def.message(context);
+        }
+    }
+    return humanize(code);
+}
+/**
+ * Render a localized message for a code.
+ *
+ * Resolution order:
+ * 1. requested-locale overlay entry (template) → interpolate
+ * 2. registry default message (template → interpolate, or function → call)
+ * 3. humanized code
+ */
+function format(code, context = {}, locale = exports.DEFAULT_LOCALE) {
+    const overlay = catalogs[locale]?.[code];
+    if (typeof overlay === 'string') {
+        return (0, interpolate_1.interpolate)(overlay, context);
+    }
+    return defaultMessage(code, context);
+}

package/generated/registry.generated.d.ts

@@ -0,0 +1,27 @@
+/**
+ * GENERATED FILE — DO NOT EDIT BY HAND.
+ *
+ * Source of truth: the constructive-db error audit (289 distinct codes
+ * raised via EXCEPTION/THROW across deploy sources + generated output).
+ * Regenerate with `python3 scripts/generate-registry.py` (see README.md).
+ *
+ * Public copy is seeded from the dashboard error catalogs; developer/invariant
+ * codes carry their raw message (with %-args rendered as {{argN}}). Curated
+ * entries in `registry.ts` override anything here (typed context + refined copy).
+ *
+ * Counts: 289 total, 82 public, 207 internal.
+ */
+import { type DefinedError } from '../define';
+import type { ErrorContext } from '../types';
+export interface GeneratedCodeMeta {
+    class: 'public' | 'internal';
+    dynamic: boolean;
+    /** True when the code is only emitted by DB code generators (no hand source). */
+    generatedOnly: boolean;
+}
+/** Every constructive-db error code, keyed by code. */
+export declare const generatedRegistry: Record<string, DefinedError<ErrorContext>>;
+/** Audit metadata for each generated code. */
+export declare const GENERATED_CODE_META: Record<string, GeneratedCodeMeta>;
+/** Total number of codes collected from constructive-db. */
+export declare const GENERATED_CODE_COUNT = 289;