@spring-systems/core 0.8.4 → 0.8.7

package/dist/chunk-MEWPYTWC.js

@@ -1,284 +0,0 @@
-import {
-  registerFallbackMigration
-} from "./chunk-RUCXSQEY.js";
-import {
-  devThrow,
-  tryGetSpringInstance
-} from "./chunk-EFUBAQCV.js";
-import {
-  SpringMiddlewareError
-} from "./chunk-PT4DIYUK.js";
-
-// src/middleware/middleware-runner.ts
-function composeMiddleware(middlewares, options) {
-  const timeoutMs = options?.timeoutMs;
-  return async (ctx) => {
-    let index = -1;
-    let timedOut = false;
-    const timeoutController = timeoutMs != null && timeoutMs > 0 && typeof AbortController !== "undefined" ? new AbortController() : null;
-    const restoreSignal = timeoutController ? attachTimeoutSignal(ctx, timeoutController.signal) : () => {
-    };
-    const createTimeoutError = () => new SpringMiddlewareError(
-      `Middleware chain timed out after ${timeoutMs}ms`,
-      "timeout"
-    );
-    async function dispatch(i) {
-      if (timedOut) {
-        throw createTimeoutError();
-      }
-      if (i <= index) {
-        throw new SpringMiddlewareError("next() called multiple times in middleware.", "compose");
-      }
-      index = i;
-      if (i >= middlewares.length) {
-        return;
-      }
-      const fn = middlewares[i];
-      if (!fn) return;
-      await fn(ctx, () => dispatch(i + 1));
-    }
-    try {
-      if (timeoutMs != null && timeoutMs > 0) {
-        await raceWithTimeout(dispatch(0), timeoutMs, () => {
-          timedOut = true;
-          timeoutController?.abort();
-        });
-      } else {
-        await dispatch(0);
-      }
-    } finally {
-      restoreSignal();
-    }
-  };
-}
-function isAbortSignalLike(value) {
-  if (!value || typeof value !== "object") return false;
-  const candidate = value;
-  return typeof candidate.aborted === "boolean" && typeof candidate.addEventListener === "function";
-}
-function canAssignSignal(target) {
-  let current = target;
-  while (current) {
-    const descriptor = Object.getOwnPropertyDescriptor(current, "signal");
-    if (!descriptor) {
-      current = Object.getPrototypeOf(current);
-      continue;
-    }
-    if ("set" in descriptor) {
-      return typeof descriptor.set === "function";
-    }
-    return descriptor.writable === true;
-  }
-  return true;
-}
-function mergeAbortSignals(existing, timeoutSignal) {
-  if (typeof AbortSignal !== "undefined" && typeof AbortSignal.any === "function") {
-    return { signal: AbortSignal.any([existing, timeoutSignal]), cleanup: () => {
-    } };
-  }
-  if (typeof AbortController === "undefined") {
-    return { signal: timeoutSignal, cleanup: () => {
-    } };
-  }
-  const controller = new AbortController();
-  const abortCombined = () => {
-    if (!controller.signal.aborted) {
-      controller.abort();
-    }
-  };
-  if (existing.aborted || timeoutSignal.aborted) {
-    abortCombined();
-    return { signal: controller.signal, cleanup: () => {
-    } };
-  }
-  existing.addEventListener("abort", abortCombined, { once: true });
-  timeoutSignal.addEventListener("abort", abortCombined, { once: true });
-  return {
-    signal: controller.signal,
-    cleanup: () => {
-      existing.removeEventListener("abort", abortCombined);
-      timeoutSignal.removeEventListener("abort", abortCombined);
-    }
-  };
-}
-function attachTimeoutSignal(ctx, timeoutSignal) {
-  if (!ctx || typeof ctx !== "object") {
-    return () => {
-    };
-  }
-  const target = ctx;
-  if (!("signal" in target)) {
-    return () => {
-    };
-  }
-  const previous = target.signal;
-  if (previous !== void 0 && !isAbortSignalLike(previous)) {
-    return () => {
-    };
-  }
-  let nextSignal = timeoutSignal;
-  let cleanupMerged = () => {
-  };
-  if (isAbortSignalLike(previous) && previous !== timeoutSignal) {
-    const merged = mergeAbortSignals(previous, timeoutSignal);
-    nextSignal = merged.signal;
-    cleanupMerged = merged.cleanup;
-  }
-  if (!canAssignSignal(target)) {
-    return cleanupMerged;
-  }
-  try {
-    target.signal = nextSignal;
-  } catch {
-    cleanupMerged();
-    return () => {
-    };
-  }
-  return () => {
-    cleanupMerged();
-    try {
-      if (previous === void 0) {
-        delete target.signal;
-      } else {
-        target.signal = previous;
-      }
-    } catch {
-    }
-  };
-}
-function raceWithTimeout(task, ms, onTimeout) {
-  return new Promise((resolve, reject) => {
-    let settled = false;
-    const hasAbortTimeout = typeof AbortSignal !== "undefined" && typeof AbortSignal.timeout === "function";
-    let signal;
-    let fallbackTimer;
-    function handleTimeout() {
-      if (!settled) {
-        settled = true;
-        onTimeout();
-        if (signal) {
-          signal.removeEventListener("abort", handleTimeout);
-        }
-        reject(new SpringMiddlewareError(`Middleware chain timed out after ${ms}ms`, "timeout"));
-      }
-    }
-    if (hasAbortTimeout) {
-      signal = AbortSignal.timeout(ms);
-      signal.addEventListener("abort", handleTimeout, { once: true });
-    } else {
-      fallbackTimer = setTimeout(handleTimeout, ms);
-    }
-    task.then(
-      () => {
-        if (!settled) {
-          settled = true;
-          if (fallbackTimer !== void 0) clearTimeout(fallbackTimer);
-          if (signal) signal.removeEventListener("abort", handleTimeout);
-          resolve();
-        }
-      },
-      (err) => {
-        if (!settled) {
-          settled = true;
-          if (fallbackTimer !== void 0) clearTimeout(fallbackTimer);
-          if (signal) signal.removeEventListener("abort", handleTimeout);
-          reject(err);
-        }
-      }
-    );
-  });
-}
-
-// src/middleware/middleware-registry.ts
-var fallbackRegistry = /* @__PURE__ */ new Map();
-registerFallbackMigration((instance) => {
-  if (fallbackRegistry.size === 0) return;
-  const target = instance.core.middlewareRegistry;
-  for (const [slot, entries] of fallbackRegistry) {
-    if (entries.length === 0) continue;
-    const existing = target.get(slot);
-    if (!existing) {
-      target.set(slot, [...entries]);
-      continue;
-    }
-    for (const entry of entries) {
-      if (!existing.includes(entry)) {
-        existing.push(entry);
-      }
-    }
-    existing.sort((a, b) => b.priority - a.priority);
-  }
-});
-function removeMiddlewareEntry(registry, slot, entry) {
-  const current = registry.get(slot);
-  if (!current) return;
-  const idx = current.indexOf(entry);
-  if (idx !== -1) current.splice(idx, 1);
-}
-function getRegistry() {
-  const instance = tryGetSpringInstance();
-  return instance ? instance.core.middlewareRegistry : fallbackRegistry;
-}
-function registerMiddleware(slot, middleware, options) {
-  if (!slot || typeof slot !== "string") {
-    devThrow("Middleware", "registerMiddleware(): slot must be a non-empty string");
-    return () => {
-    };
-  }
-  if (typeof middleware !== "function") {
-    devThrow("Middleware", `registerMiddleware("${slot}"): middleware must be a function`);
-    return () => {
-    };
-  }
-  const priority = options?.priority ?? 0;
-  const entry = { fn: middleware, priority };
-  const registry = getRegistry();
-  let list = registry.get(slot);
-  if (!list) {
-    list = [];
-    registry.set(slot, list);
-  }
-  list.push(entry);
-  list.sort((a, b) => b.priority - a.priority);
-  return () => {
-    const e = entry;
-    removeMiddlewareEntry(registry, slot, e);
-    if (registry !== fallbackRegistry) {
-      removeMiddlewareEntry(fallbackRegistry, slot, e);
-    }
-    const instance = tryGetSpringInstance();
-    if (instance) {
-      removeMiddlewareEntry(
-        instance.core.middlewareRegistry,
-        slot,
-        e
-      );
-    }
-  };
-}
-function getMiddlewareRunner(slot) {
-  const registry = getRegistry();
-  const entries = registry.get(slot);
-  if (!entries || entries.length === 0) {
-    return async () => {
-    };
-  }
-  return composeMiddleware(entries.map((e) => e.fn));
-}
-function getRegisteredMiddlewareSlots() {
-  const registry = getRegistry();
-  return Array.from(registry.entries()).filter(([, list]) => list.length > 0).map(([slot]) => slot);
-}
-function clearAllMiddleware() {
-  const registry = getRegistry();
-  registry.clear();
-}
-
-export {
-  composeMiddleware,
-  registerMiddleware,
-  getMiddlewareRunner,
-  getRegisteredMiddlewareSlots,
-  clearAllMiddleware
-};
-//# sourceMappingURL=chunk-MEWPYTWC.js.map

package/dist/chunk-MEWPYTWC.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/middleware/middleware-runner.ts","../src/middleware/middleware-registry.ts"],"sourcesContent":["/**\n * Koa-style middleware composition.\n * Chains middleware functions with a `next()` pattern.\n * @module middleware-runner\n */\n\nimport { SpringMiddlewareError } from \"../errors/errors\";\nimport type { MiddlewareFn } from \"./middleware-types\";\n\nexport interface ComposeOptions {\n    /**\n     * Optional timeout in milliseconds for the entire middleware chain.\n     * If the chain doesn't complete within this time, a SpringMiddlewareError is thrown.\n     * When omitted, no timeout is applied (backward-compatible default).\n     */\n    timeoutMs?: number;\n}\n\n/**\n * Compose an array of middleware functions into a single function.\n * Each middleware receives a context and a `next` callback.\n * Calling `next()` invokes the next middleware in the chain.\n * Calling `next()` more than once throws an error.\n *\n * @param middlewares - Array of middleware functions to compose\n * @param options - Optional configuration (e.g. timeout)\n * @returns A function that runs the full middleware chain on a given context.\n */\nexport function composeMiddleware<TContext>(\n    middlewares: ReadonlyArray<MiddlewareFn<TContext>>,\n    options?: ComposeOptions,\n): (ctx: TContext) => Promise<void> {\n    const timeoutMs = options?.timeoutMs;\n\n    return async (ctx: TContext): Promise<void> => {\n        let index = -1;\n        let timedOut = false;\n        const timeoutController =\n            timeoutMs != null && timeoutMs > 0 && typeof AbortController !== \"undefined\"\n                ? new AbortController()\n                : null;\n        const restoreSignal = timeoutController ? attachTimeoutSignal(ctx, timeoutController.signal) : () => {};\n\n        const createTimeoutError = (): SpringMiddlewareError =>\n            new SpringMiddlewareError(\n                `Middleware chain timed out after ${timeoutMs}ms`,\n                \"timeout\",\n            );\n\n        async function dispatch(i: number): Promise<void> {\n            if (timedOut) {\n                throw createTimeoutError();\n            }\n            if (i <= index) {\n                throw new SpringMiddlewareError(\"next() called multiple times in middleware.\", \"compose\");\n            }\n            index = i;\n            if (i >= middlewares.length) {\n                return;\n            }\n            const fn = middlewares[i];\n            if (!fn) return;\n            await fn(ctx, () => dispatch(i + 1));\n        }\n\n        try {\n            if (timeoutMs != null && timeoutMs > 0) {\n                await raceWithTimeout(dispatch(0), timeoutMs, () => {\n                    timedOut = true;\n                    timeoutController?.abort();\n                });\n            } else {\n                await dispatch(0);\n            }\n        } finally {\n            restoreSignal();\n        }\n    };\n}\n\nfunction isAbortSignalLike(value: unknown): value is AbortSignal {\n    if (!value || typeof value !== \"object\") return false;\n    const candidate = value as { aborted?: unknown; addEventListener?: unknown };\n    return typeof candidate.aborted === \"boolean\" && typeof candidate.addEventListener === \"function\";\n}\n\nfunction canAssignSignal(target: Record<string, unknown>): boolean {\n    let current: object | null = target;\n    while (current) {\n        const descriptor = Object.getOwnPropertyDescriptor(current, \"signal\");\n        if (!descriptor) {\n            current = Object.getPrototypeOf(current);\n            continue;\n        }\n        if (\"set\" in descriptor) {\n            return typeof descriptor.set === \"function\";\n        }\n        return descriptor.writable === true;\n    }\n    return true;\n}\n\nfunction mergeAbortSignals(\n    existing: AbortSignal,\n    timeoutSignal: AbortSignal,\n): { signal: AbortSignal; cleanup: () => void } {\n    if (typeof AbortSignal !== \"undefined\" && typeof AbortSignal.any === \"function\") {\n        return { signal: AbortSignal.any([existing, timeoutSignal]), cleanup: () => {} };\n    }\n\n    if (typeof AbortController === \"undefined\") {\n        return { signal: timeoutSignal, cleanup: () => {} };\n    }\n\n    const controller = new AbortController();\n    const abortCombined = (): void => {\n        if (!controller.signal.aborted) {\n            controller.abort();\n        }\n    };\n\n    if (existing.aborted || timeoutSignal.aborted) {\n        abortCombined();\n        return { signal: controller.signal, cleanup: () => {} };\n    }\n\n    existing.addEventListener(\"abort\", abortCombined, { once: true });\n    timeoutSignal.addEventListener(\"abort\", abortCombined, { once: true });\n\n    return {\n        signal: controller.signal,\n        cleanup: () => {\n            existing.removeEventListener(\"abort\", abortCombined);\n            timeoutSignal.removeEventListener(\"abort\", abortCombined);\n        },\n    };\n}\n\n/**\n * If the context exposes a `signal` field, attach timeout signal so middleware\n * can abort downstream fetch/IO operations cooperatively.\n */\nfunction attachTimeoutSignal<TContext>(ctx: TContext, timeoutSignal: AbortSignal): () => void {\n    if (!ctx || typeof ctx !== \"object\") {\n        return () => {};\n    }\n\n    const target = ctx as Record<string, unknown>;\n    if (!(\"signal\" in target)) {\n        return () => {};\n    }\n\n    const previous = target.signal;\n    if (previous !== undefined && !isAbortSignalLike(previous)) {\n        return () => {};\n    }\n\n    let nextSignal: AbortSignal = timeoutSignal;\n    let cleanupMerged = () => {};\n    if (\n        isAbortSignalLike(previous) &&\n        previous !== timeoutSignal\n    ) {\n        const merged = mergeAbortSignals(previous, timeoutSignal);\n        nextSignal = merged.signal;\n        cleanupMerged = merged.cleanup;\n    }\n\n    if (!canAssignSignal(target)) {\n        return cleanupMerged;\n    }\n\n    try {\n        target.signal = nextSignal;\n    } catch {\n        cleanupMerged();\n        return () => {};\n    }\n\n    return () => {\n        cleanupMerged();\n        try {\n            if (previous === undefined) {\n                delete target.signal;\n            } else {\n                target.signal = previous;\n            }\n        } catch {\n            // Ignore restore errors for read-only or sealed contexts.\n        }\n    };\n}\n\n/**\n * Race a promise against a timeout. Rejects with SpringMiddlewareError if the\n * timeout fires first. Uses AbortSignal.timeout where available, falling\n * back to setTimeout for older runtimes.\n */\nfunction raceWithTimeout(task: Promise<void>, ms: number, onTimeout: () => void): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n        let settled = false;\n\n        // Use AbortSignal.timeout if available (Node 18+, modern browsers)\n        const hasAbortTimeout = typeof AbortSignal !== \"undefined\" && typeof AbortSignal.timeout === \"function\";\n        let signal: AbortSignal | undefined;\n        let fallbackTimer: ReturnType<typeof setTimeout> | undefined;\n\n        function handleTimeout(): void {\n            if (!settled) {\n                settled = true;\n                onTimeout();\n                if (signal) {\n                    signal.removeEventListener(\"abort\", handleTimeout);\n                }\n                reject(new SpringMiddlewareError(`Middleware chain timed out after ${ms}ms`, \"timeout\"));\n            }\n        }\n\n        if (hasAbortTimeout) {\n            signal = AbortSignal.timeout(ms);\n            signal.addEventListener(\"abort\", handleTimeout, { once: true });\n        } else {\n            fallbackTimer = setTimeout(handleTimeout, ms);\n        }\n\n        task.then(\n            () => {\n                if (!settled) {\n                    settled = true;\n                    if (fallbackTimer !== undefined) clearTimeout(fallbackTimer);\n                    if (signal) signal.removeEventListener(\"abort\", handleTimeout);\n                    resolve();\n                }\n            },\n            (err: unknown) => {\n                if (!settled) {\n                    settled = true;\n                    if (fallbackTimer !== undefined) clearTimeout(fallbackTimer);\n                    if (signal) signal.removeEventListener(\"abort\", handleTimeout);\n                    reject(err);\n                }\n            },\n        );\n    });\n}\n","/**\n * Middleware registry — manages middleware functions registered per slot.\n *\n * Type-safe: the context type is inferred from the slot name via MiddlewareSlotMap.\n * Custom slots added via declaration merging also get full type inference.\n *\n * @module middleware-registry\n */\n\nimport { tryGetSpringInstance } from \"../instance/current-instance\";\nimport { registerFallbackMigration } from \"../instance/fallback-bridge\";\nimport { devThrow } from \"../utils/dev-warnings\";\nimport { composeMiddleware } from \"./middleware-runner\";\nimport type { MiddlewareEntry, MiddlewareFn, MiddlewareSlot } from \"./middleware-types\";\n\nexport interface MiddlewareOptions {\n    /** Higher priority middleware runs first. Default: 0 */\n    priority?: number;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- heterogeneous registry stores middlewares for multiple context types by slot\nconst fallbackRegistry = new Map<MiddlewareSlot, MiddlewareEntry<any>[]>();\n\n// Migrate pre-mount middleware registrations to SpringInstance when it becomes available.\nregisterFallbackMigration((instance) => {\n    if (fallbackRegistry.size === 0) return;\n\n    const target = instance.core.middlewareRegistry;\n    for (const [slot, entries] of fallbackRegistry) {\n        if (entries.length === 0) continue;\n        const existing = target.get(slot);\n        if (!existing) {\n            target.set(slot, [...entries]);\n            continue;\n        }\n        for (const entry of entries) {\n            if (!existing.includes(entry)) {\n                existing.push(entry);\n            }\n        }\n        existing.sort((a, b) => b.priority - a.priority);\n    }\n});\n\nfunction removeMiddlewareEntry(\n    registry: Map<MiddlewareSlot, MiddlewareEntry<unknown>[]>,\n    slot: MiddlewareSlot,\n    entry: MiddlewareEntry<unknown>,\n): void {\n    const current = registry.get(slot);\n    if (!current) return;\n    const idx = current.indexOf(entry);\n    if (idx !== -1) current.splice(idx, 1);\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- same rationale as fallbackRegistry; runtime slot dispatch preserves context typing at call sites\nfunction getRegistry(): Map<MiddlewareSlot, MiddlewareEntry<any>[]> {\n    const instance = tryGetSpringInstance();\n    return instance ? instance.core.middlewareRegistry : fallbackRegistry;\n}\n\n/**\n * Register a middleware function for a given slot.\n * The context type is automatically inferred from the slot name via MiddlewareSlotMap.\n *\n * @example\n * ```ts\n * // Context type is inferred as FormSaveContext\n * const unregister = registerMiddleware(\"form:beforeSave\", async (ctx, next) => {\n *     console.log(\"Saving entity:\", ctx.entity);\n *     await next();\n * });\n * unregister(); // Cleanup when no longer needed\n *\n * // With priority (higher = runs first):\n * registerMiddleware(\"form:beforeSave\", auditMiddleware, { priority: 10 });\n * ```\n *\n * @param slot - Middleware slot name (e.g. \"form:beforeSave\", \"api:beforeRequest\")\n * @param middleware - Koa-style middleware function receiving `(ctx, next)`\n * @param options - Optional settings; `priority` controls execution order (higher runs first, default 0)\n * @returns An unregister function that removes this middleware from the slot.\n */\nexport function registerMiddleware<TContext = unknown>(\n    slot: MiddlewareSlot,\n    middleware: MiddlewareFn<TContext>,\n    options?: MiddlewareOptions,\n): () => void {\n    if (!slot || typeof slot !== \"string\") {\n        devThrow(\"Middleware\", \"registerMiddleware(): slot must be a non-empty string\");\n        return () => {};\n    }\n    if (typeof middleware !== \"function\") {\n        devThrow(\"Middleware\", `registerMiddleware(\"${slot}\"): middleware must be a function`);\n        return () => {};\n    }\n\n    const priority = options?.priority ?? 0;\n    const entry: MiddlewareEntry<TContext> = { fn: middleware, priority };\n\n    const registry = getRegistry();\n    let list = registry.get(slot);\n    if (!list) {\n        list = [];\n        registry.set(slot, list);\n    }\n    list.push(entry);\n    // Stable sort: higher priority first\n    list.sort((a, b) => b.priority - a.priority);\n\n    return () => {\n        const e = entry as MiddlewareEntry<unknown>;\n        removeMiddlewareEntry(registry as Map<MiddlewareSlot, MiddlewareEntry<unknown>[]>, slot, e);\n        if (registry !== fallbackRegistry) {\n            removeMiddlewareEntry(fallbackRegistry as Map<MiddlewareSlot, MiddlewareEntry<unknown>[]>, slot, e);\n        }\n        const instance = tryGetSpringInstance();\n        if (instance) {\n            removeMiddlewareEntry(\n                instance.core.middlewareRegistry as Map<MiddlewareSlot, MiddlewareEntry<unknown>[]>,\n                slot,\n                e,\n            );\n        }\n    };\n}\n\n/**\n * Get a composed runner for a given slot.\n * Returns a function that executes all registered middleware for that slot\n * in priority order (higher priority first) using the Koa-style `next()` pattern.\n *\n * If no middleware is registered for the slot, the returned function is a no-op.\n *\n * @param slot - Middleware slot name to compose a runner for\n * @returns An async function that runs all middleware for the slot on a given context.\n */\nexport function getMiddlewareRunner<TContext = unknown>(\n    slot: MiddlewareSlot,\n): (ctx: TContext) => Promise<void> {\n    const registry = getRegistry();\n    const entries = registry.get(slot);\n    if (!entries || entries.length === 0) {\n        return async () => {};\n    }\n    return composeMiddleware<TContext>(entries.map((e) => e.fn as MiddlewareFn<TContext>));\n}\n\n/**\n * Get all slot names that have at least one middleware registered.\n * Useful for debugging and introspection.\n */\nexport function getRegisteredMiddlewareSlots(): MiddlewareSlot[] {\n    const registry = getRegistry();\n    return Array.from(registry.entries())\n        .filter(([, list]) => list.length > 0)\n        .map(([slot]) => slot);\n}\n\n/**\n * Remove all registered middleware. Intended for testing.\n */\nexport function clearAllMiddleware(): void {\n    const registry = getRegistry();\n    registry.clear();\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-N2L4TUC4.js

@@ -1,34 +0,0 @@
-// src/i18n/default-messages.ts
-var DEFAULT_MESSAGES = {
-  "admin-fill-value": "This field is required",
-  "admin-invalid-phone-number-format": "Invalid phone number format",
-  "admin-invalid-email-format": "Invalid email format",
-  "admin-email-contains-multiple-addresses": "Field contains multiple email addresses",
-  "admin-invalid-url-format": "Invalid URL format",
-  "admin-password-min-length": "Password must be at least 8 characters",
-  "admin-password-uppercase": "Password must contain an uppercase letter",
-  "admin-password-lowercase": "Password must contain a lowercase letter",
-  "admin-password-digit": "Password must contain a digit",
-  "admin-password-special-char": "Password must contain a special character",
-  "admin-yes": "Yes",
-  "admin-no": "No",
-  "admin-login-failed": "Login failed",
-  "admin-session-expired": "Session expired. Please log in again.",
-  "admin-fill-all-required-fields": "Please fill in all required fields",
-  "admin-username": "Username",
-  "admin-detail": "Detail",
-  "admin-not-found": "Not found",
-  "admin-unknown-error": "Unknown error",
-  "admin-validation-error": "Validation error",
-  "admin-sorted-ascending": "Sorted ascending",
-  "admin-sorted-descending": "Sorted descending",
-  "admin-sort-cleared": "Sort cleared",
-  "admin-of": "of",
-  "admin-rows-selected": "rows selected",
-  "admin-tree": "Tree"
-};
-
-export {
-  DEFAULT_MESSAGES
-};
-//# sourceMappingURL=chunk-N2L4TUC4.js.map

package/dist/chunk-N2L4TUC4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/i18n/default-messages.ts"],"sourcesContent":["/**\n * Built-in default messages for framework UI strings.\n * These provide a working default so the framework operates out of the box\n * without requiring a ContentAdapter for basic validation messages.\n * Consumers can override via setContentAdapter() for full i18n.\n * @module default-messages\n */\n\nexport const DEFAULT_MESSAGES = {\n    \"admin-fill-value\": \"This field is required\",\n    \"admin-invalid-phone-number-format\": \"Invalid phone number format\",\n    \"admin-invalid-email-format\": \"Invalid email format\",\n    \"admin-email-contains-multiple-addresses\": \"Field contains multiple email addresses\",\n    \"admin-invalid-url-format\": \"Invalid URL format\",\n    \"admin-password-min-length\": \"Password must be at least 8 characters\",\n    \"admin-password-uppercase\": \"Password must contain an uppercase letter\",\n    \"admin-password-lowercase\": \"Password must contain a lowercase letter\",\n    \"admin-password-digit\": \"Password must contain a digit\",\n    \"admin-password-special-char\": \"Password must contain a special character\",\n    \"admin-yes\": \"Yes\",\n    \"admin-no\": \"No\",\n    \"admin-login-failed\": \"Login failed\",\n    \"admin-session-expired\": \"Session expired. Please log in again.\",\n    \"admin-fill-all-required-fields\": \"Please fill in all required fields\",\n    \"admin-username\": \"Username\",\n    \"admin-detail\": \"Detail\",\n    \"admin-not-found\": \"Not found\",\n    \"admin-unknown-error\": \"Unknown error\",\n    \"admin-validation-error\": \"Validation error\",\n    \"admin-sorted-ascending\": \"Sorted ascending\",\n    \"admin-sorted-descending\": \"Sorted descending\",\n    \"admin-sort-cleared\": \"Sort cleared\",\n    \"admin-of\": \"of\",\n    \"admin-rows-selected\": \"rows selected\",\n    \"admin-tree\": \"Tree\",\n} as const satisfies Record<string, string>;\n"],"mappings":";AAQO,IAAM,mBAAmB;AAAA,EAC5B,oBAAoB;AAAA,EACpB,qCAAqC;AAAA,EACrC,8BAA8B;AAAA,EAC9B,2CAA2C;AAAA,EAC3C,4BAA4B;AAAA,EAC5B,6BAA6B;AAAA,EAC7B,4BAA4B;AAAA,EAC5B,4BAA4B;AAAA,EAC5B,wBAAwB;AAAA,EACxB,+BAA+B;AAAA,EAC/B,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,sBAAsB;AAAA,EACtB,yBAAyB;AAAA,EACzB,kCAAkC;AAAA,EAClC,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAChB,mBAAmB;AAAA,EACnB,uBAAuB;AAAA,EACvB,0BAA0B;AAAA,EAC1B,0BAA0B;AAAA,EAC1B,2BAA2B;AAAA,EAC3B,sBAAsB;AAAA,EACtB,YAAY;AAAA,EACZ,uBAAuB;AAAA,EACvB,cAAc;AAClB;","names":[]}

package/dist/chunk-NQQIVCLX.js

@@ -1,47 +0,0 @@
-import {
-  DEFAULT_MESSAGES
-} from "./chunk-N2L4TUC4.js";
-import {
-  registerFallbackMigration
-} from "./chunk-RUCXSQEY.js";
-import {
-  tryGetSpringInstance
-} from "./chunk-EFUBAQCV.js";
-
-// src/adapters/content-adapter.ts
-var fallback = {
-  getRes: (key) => DEFAULT_MESSAGES[key] ?? `[${key}]`
-};
-function setContentAdapter(adapter) {
-  const instance = tryGetSpringInstance();
-  if (instance) {
-    instance.core.contentAdapter = adapter;
-  } else {
-    fallbackAdapter = adapter;
-  }
-}
-var fallbackAdapter = fallback;
-registerFallbackMigration((instance) => {
-  if (fallbackAdapter !== fallback) {
-    instance.core.contentAdapter = fallbackAdapter;
-  }
-});
-function getContentRes(key) {
-  const instance = tryGetSpringInstance();
-  const adapter = instance ? instance.core.contentAdapter : fallbackAdapter;
-  return adapter.getRes(key);
-}
-function clearContentAdapter() {
-  const instance = tryGetSpringInstance();
-  if (instance) {
-    instance.core.contentAdapter = fallback;
-  }
-  fallbackAdapter = fallback;
-}
-
-export {
-  setContentAdapter,
-  getContentRes,
-  clearContentAdapter
-};
-//# sourceMappingURL=chunk-NQQIVCLX.js.map

package/dist/chunk-NQQIVCLX.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/adapters/content-adapter.ts"],"sourcesContent":["/**\n * Content adapter — decouples API/validation layers from the i18n system (contents store).\n * Pattern matches setLogAdapter() in logger.ts.\n * @module content-adapter\n */\n\nimport { DEFAULT_MESSAGES } from \"../i18n/default-messages\";\nimport { tryGetSpringInstance } from \"../instance/current-instance\";\nimport { registerFallbackMigration } from \"../instance/fallback-bridge\";\n\nexport interface ContentAdapter {\n    getRes(key: string): string;\n}\n\nconst fallback = {\n    getRes: (key) => (DEFAULT_MESSAGES as Record<string, string>)[key] ?? `[${key}]`,\n} satisfies ContentAdapter;\n\nexport function setContentAdapter(adapter: ContentAdapter): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        instance.core.contentAdapter = adapter;\n    } else {\n        fallbackAdapter = adapter;\n    }\n}\n\n// Fallback for code that runs before SpringInstance is created\nlet fallbackAdapter: ContentAdapter = fallback;\n\n// Migrate fallback content adapter to SpringInstance when SpringProvider mounts\nregisterFallbackMigration((instance) => {\n    if (fallbackAdapter !== fallback) {\n        instance.core.contentAdapter = fallbackAdapter;\n    }\n});\n\n/** Returns translated content via the registered adapter. Replaces direct getRes() imports in core/api layers. */\nexport function getContentRes(key: string): string {\n    const instance = tryGetSpringInstance();\n    const adapter = instance ? instance.core.contentAdapter : fallbackAdapter;\n    return adapter.getRes(key);\n}\n\n/** Reset to default content adapter. For testing/integration teardown only. */\nexport function clearContentAdapter(): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        instance.core.contentAdapter = fallback;\n    }\n    fallbackAdapter = fallback;\n}\n"],"mappings":";;;;;;;;;;;AAcA,IAAM,WAAW;AAAA,EACb,QAAQ,CAAC,QAAS,iBAA4C,GAAG,KAAK,IAAI,GAAG;AACjF;AAEO,SAAS,kBAAkB,SAA+B;AAC7D,QAAM,WAAW,qBAAqB;AACtC,MAAI,UAAU;AACV,aAAS,KAAK,iBAAiB;AAAA,EACnC,OAAO;AACH,sBAAkB;AAAA,EACtB;AACJ;AAGA,IAAI,kBAAkC;AAGtC,0BAA0B,CAAC,aAAa;AACpC,MAAI,oBAAoB,UAAU;AAC9B,aAAS,KAAK,iBAAiB;AAAA,EACnC;AACJ,CAAC;AAGM,SAAS,cAAc,KAAqB;AAC/C,QAAM,WAAW,qBAAqB;AACtC,QAAM,UAAU,WAAW,SAAS,KAAK,iBAAiB;AAC1D,SAAO,QAAQ,OAAO,GAAG;AAC7B;AAGO,SAAS,sBAA4B;AACxC,QAAM,WAAW,qBAAqB;AACtC,MAAI,UAAU;AACV,aAAS,KAAK,iBAAiB;AAAA,EACnC;AACA,oBAAkB;AACtB;","names":[]}

package/dist/chunk-OSSX443T.js

@@ -1,146 +0,0 @@
-import {
-  getTelemetryAdapter
-} from "./chunk-S6RPCN5H.js";
-import {
-  registerFallbackMigration
-} from "./chunk-RUCXSQEY.js";
-import {
-  logError
-} from "./chunk-KX32MU3I.js";
-import {
-  devThrow,
-  devWarn,
-  tryGetSpringInstance
-} from "./chunk-EFUBAQCV.js";
-
-// src/events/event-bus.ts
-function getListeners() {
-  const instance = tryGetSpringInstance();
-  if (instance) return instance.core.eventListeners;
-  return fallbackListeners;
-}
-var fallbackListeners = /* @__PURE__ */ new Map();
-registerFallbackMigration((instance) => {
-  if (fallbackListeners.size === 0) return;
-  const target = instance.core.eventListeners;
-  for (const [event, entries] of fallbackListeners) {
-    if (entries.length === 0) continue;
-    const existing = target.get(event);
-    if (!existing) {
-      target.set(event, [...entries]);
-    } else {
-      for (const entry of entries) {
-        if (!existing.includes(entry)) {
-          existing.push(entry);
-        }
-      }
-    }
-  }
-});
-var LEAK_THRESHOLD = 100;
-function removeHandlerEntry(listeners, event, entry) {
-  const entries = listeners.get(event);
-  if (!entries) return;
-  const idx = entries.indexOf(entry);
-  if (idx !== -1) entries.splice(idx, 1);
-}
-function addHandler(event, handler, once2) {
-  if (typeof handler !== "function") {
-    devThrow("EventBus", `on("${event}"): handler must be a function`);
-    return () => {
-    };
-  }
-  const listeners = getListeners();
-  let entries = listeners.get(event);
-  if (!entries) {
-    entries = [];
-    listeners.set(event, entries);
-  }
-  if (entries.length >= LEAK_THRESHOLD) {
-    devWarn("EventBus", `Event "${event}" has ${entries.length}+ listeners \u2014 possible memory leak`);
-  }
-  const entry = { handler, once: once2 };
-  entries.push(entry);
-  return () => {
-    removeHandlerEntry(listeners, event, entry);
-    if (listeners !== fallbackListeners) {
-      removeHandlerEntry(fallbackListeners, event, entry);
-    }
-    const instance = tryGetSpringInstance();
-    if (instance) {
-      removeHandlerEntry(instance.core.eventListeners, event, entry);
-    }
-  };
-}
-function on(event, handler) {
-  return addHandler(event, handler, false);
-}
-function once(event, handler) {
-  return addHandler(event, handler, true);
-}
-function emit(event, ...[payload]) {
-  const listeners = getListeners();
-  const entries = listeners.get(event);
-  if (!entries || entries.length === 0) return;
-  const snapshot = entries.slice();
-  for (let i = 0; i < snapshot.length; i++) {
-    const entry = snapshot[i];
-    if (!entry) continue;
-    try {
-      const result = entry.handler(payload);
-      if (result && typeof result.catch === "function") {
-        result.catch((err) => {
-          logError(`EventBus handler #${i} for "${event}" threw`, err);
-          getTelemetryAdapter().trackError(err, { source: "EventBus", event });
-        });
-      }
-    } catch (err) {
-      logError(`EventBus handler #${i} for "${event}" threw`, err);
-      getTelemetryAdapter().trackError(err, { source: "EventBus", event });
-    }
-    if (entry.once) {
-      const liveIdx = entries.indexOf(entry);
-      if (liveIdx !== -1) entries.splice(liveIdx, 1);
-    }
-  }
-}
-async function emitAsync(event, ...[payload]) {
-  const listeners = getListeners();
-  const entries = listeners.get(event);
-  if (!entries || entries.length === 0) return;
-  const snapshot = entries.slice();
-  for (let i = 0; i < snapshot.length; i++) {
-    const entry = snapshot[i];
-    if (!entry) continue;
-    try {
-      await entry.handler(payload);
-    } catch (err) {
-      logError(`EventBus async handler #${i} for "${event}" threw`, err);
-      getTelemetryAdapter().trackError(err, { source: "EventBus", event });
-    }
-    if (entry.once) {
-      const liveIdx = entries.indexOf(entry);
-      if (liveIdx !== -1) entries.splice(liveIdx, 1);
-    }
-  }
-}
-function clear() {
-  const listeners = getListeners();
-  listeners.clear();
-  if (listeners !== fallbackListeners) {
-    fallbackListeners.clear();
-  }
-}
-function clearAll() {
-  const instance = tryGetSpringInstance();
-  if (instance) {
-    instance.core.eventListeners.clear();
-  }
-  fallbackListeners.clear();
-}
-var eventBus = { on, once, emit, emitAsync, clear, clearAll };
-
-export {
-  eventBus
-};
-//# sourceMappingURL=chunk-OSSX443T.js.map

package/dist/chunk-OSSX443T.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/events/event-bus.ts"],"sourcesContent":["/**\n * Typed event bus for framework-wide communication.\n * Handlers that throw are caught and logged — they never block other handlers.\n * @module event-bus\n */\n\nimport { getTelemetryAdapter } from \"../adapters/telemetry-adapter\";\nimport { tryGetSpringInstance } from \"../instance/current-instance\";\nimport { registerFallbackMigration } from \"../instance/fallback-bridge\";\nimport type { HandlerEntry } from \"../instance/spring-instance\";\nimport { logError } from \"../logger/logger\";\nimport { devThrow, devWarn } from \"../utils/dev-warnings\";\nimport type { FrameworkEventMap } from \"./event-types\";\n\ntype EventHandler<T> = (payload: T) => void | Promise<void>;\n\nfunction getListeners(): Map<string, HandlerEntry[]> {\n    const instance = tryGetSpringInstance();\n    if (instance) return instance.core.eventListeners;\n    // Fallback for code that runs before SpringProvider mounts\n    return fallbackListeners;\n}\n\nconst fallbackListeners = new Map<string, HandlerEntry[]>();\n\n// Migrate fallback event listeners to SpringInstance when SpringProvider mounts.\n// Listeners added before the instance exists would otherwise be silently lost.\nregisterFallbackMigration((instance) => {\n    if (fallbackListeners.size === 0) return;\n\n    const target = instance.core.eventListeners;\n    for (const [event, entries] of fallbackListeners) {\n        if (entries.length === 0) continue;\n        const existing = target.get(event);\n        if (!existing) {\n            // No listeners on the instance yet for this event — move them all\n            target.set(event, [...entries]);\n        } else {\n            // Merge: only add entries not already present on the target\n            for (const entry of entries) {\n                if (!existing.includes(entry)) {\n                    existing.push(entry);\n                }\n            }\n        }\n    }\n});\n\nconst LEAK_THRESHOLD = 100;\n\nfunction removeHandlerEntry(listeners: Map<string, HandlerEntry[]>, event: string, entry: HandlerEntry): void {\n    const entries = listeners.get(event);\n    if (!entries) return;\n    const idx = entries.indexOf(entry);\n    if (idx !== -1) entries.splice(idx, 1);\n}\n\nfunction addHandler(event: string, handler: EventHandler<unknown>, once: boolean): () => void {\n    if (typeof handler !== \"function\") {\n        devThrow(\"EventBus\", `on(\"${event}\"): handler must be a function`);\n        return () => {};\n    }\n\n    const listeners = getListeners();\n    let entries = listeners.get(event);\n    if (!entries) {\n        entries = [];\n        listeners.set(event, entries);\n    }\n    if (entries.length >= LEAK_THRESHOLD) {\n        devWarn(\"EventBus\", `Event \"${event}\" has ${entries.length}+ listeners — possible memory leak`);\n    }\n\n    const entry: HandlerEntry = { handler, once };\n    entries.push(entry);\n\n    return () => {\n        removeHandlerEntry(listeners, event, entry);\n        if (listeners !== fallbackListeners) {\n            removeHandlerEntry(fallbackListeners, event, entry);\n        }\n        const instance = tryGetSpringInstance();\n        if (instance) {\n            removeHandlerEntry(instance.core.eventListeners, event, entry);\n        }\n    };\n}\n\n/**\n * Register a handler for an event. Returns an unsubscribe function.\n *\n * @param event - Event name from FrameworkEventMap (e.g. \"auth:logout\", \"form:saved\")\n * @param handler - Callback invoked with the event payload; may be sync or async\n * @returns An unsubscribe function that removes this handler.\n */\nfunction on<K extends keyof FrameworkEventMap>(event: K, handler: EventHandler<FrameworkEventMap[K]>): () => void {\n    return addHandler(event as string, handler as EventHandler<unknown>, false);\n}\n\n/**\n * Register a one-time handler. Automatically removed after the first call.\n *\n * @param event - Event name from FrameworkEventMap\n * @param handler - Callback invoked once with the event payload, then auto-removed\n * @returns An unsubscribe function that removes this handler before it fires.\n */\nfunction once<K extends keyof FrameworkEventMap>(event: K, handler: EventHandler<FrameworkEventMap[K]>): () => void {\n    return addHandler(event as string, handler as EventHandler<unknown>, true);\n}\n\n/**\n * Emit an event synchronously. Handlers are called in registration order.\n * Handler errors are caught and logged but do not stop other handlers.\n *\n * @param event - Event name to emit\n * @param payload - Event payload matching the type defined in FrameworkEventMap (omit for void events)\n */\nfunction emit<K extends keyof FrameworkEventMap>(\n    event: K,\n    ...[payload]: FrameworkEventMap[K] extends void ? [undefined?] : [FrameworkEventMap[K]]\n): void {\n    const listeners = getListeners();\n    const entries = listeners.get(event as string);\n    if (!entries || entries.length === 0) return;\n\n    // Snapshot so that unsubscribes during iteration don't skip handlers\n    const snapshot = entries.slice();\n\n    for (let i = 0; i < snapshot.length; i++) {\n        const entry = snapshot[i];\n        if (!entry) continue;\n        try {\n            const result = entry.handler(payload);\n            // Catch rejections from async handlers passed to synchronous emit()\n            if (result && typeof (result as Promise<void>).catch === \"function\") {\n                (result as Promise<void>).catch((err) => {\n                    logError(`EventBus handler #${i} for \"${event as string}\" threw`, err);\n                    getTelemetryAdapter().trackError(err, { source: \"EventBus\", event: event as string });\n                });\n            }\n        } catch (err) {\n            logError(`EventBus handler #${i} for \"${event as string}\" threw`, err);\n            getTelemetryAdapter().trackError(err, { source: \"EventBus\", event: event as string });\n        }\n        if (entry.once) {\n            const liveIdx = entries.indexOf(entry);\n            if (liveIdx !== -1) entries.splice(liveIdx, 1);\n        }\n    }\n}\n\n/**\n * Emit an event and await all handlers (including async ones).\n * Handler errors are caught and logged but do not stop other handlers.\n *\n * @param event - Event name to emit\n * @param payload - Event payload matching the type defined in FrameworkEventMap (omit for void events)\n * @returns Resolves when all handlers have completed.\n */\nasync function emitAsync<K extends keyof FrameworkEventMap>(\n    event: K,\n    ...[payload]: FrameworkEventMap[K] extends void ? [undefined?] : [FrameworkEventMap[K]]\n): Promise<void> {\n    const listeners = getListeners();\n    const entries = listeners.get(event as string);\n    if (!entries || entries.length === 0) return;\n\n    // Snapshot so that unsubscribes during iteration don't skip handlers\n    const snapshot = entries.slice();\n\n    for (let i = 0; i < snapshot.length; i++) {\n        const entry = snapshot[i];\n        if (!entry) continue;\n        try {\n            await entry.handler(payload);\n        } catch (err) {\n            logError(`EventBus async handler #${i} for \"${event as string}\" threw`, err);\n            getTelemetryAdapter().trackError(err, { source: \"EventBus\", event: event as string });\n        }\n        if (entry.once) {\n            const liveIdx = entries.indexOf(entry);\n            if (liveIdx !== -1) entries.splice(liveIdx, 1);\n        }\n    }\n}\n\n/**\n * Remove all handlers for all events on both listener maps\n * (active instance map and fallback map).\n */\nfunction clear(): void {\n    const listeners = getListeners();\n    listeners.clear();\n    if (listeners !== fallbackListeners) {\n        fallbackListeners.clear();\n    }\n}\n\n/**\n * Remove all event listeners from both the SpringInstance (if active)\n * and the fallback listener map. Useful for full teardown in tests\n * or when disposing the entire framework.\n */\nfunction clearAll(): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        instance.core.eventListeners.clear();\n    }\n    fallbackListeners.clear();\n}\n\n/** Singleton event bus facade — delegates to the current SpringInstance's event listeners */\nexport const eventBus = { on, once, emit, emitAsync, clear, clearAll };\n"],"mappings":"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","names":["once"]}