@spring-systems/core 0.8.0

package/dist/chunk-GON7Q32Q.js

@@ -0,0 +1,176 @@
+import {
+  registerFallbackMigration
+} from "./chunk-RUCXSQEY.js";
+import {
+  tryGetSpringInstance
+} from "./chunk-EFUBAQCV.js";
+import {
+  SpringAdapterError
+} from "./chunk-PT4DIYUK.js";
+
+// src/adapters/http-adapter.ts
+var noopAdapter = {
+  async request() {
+    throw new SpringAdapterError(
+      "No HttpAdapter configured. Call setHttpAdapter() before making API requests.",
+      "HttpAdapter"
+    );
+  },
+  async get() {
+    throw new SpringAdapterError(
+      "No HttpAdapter configured. Call setHttpAdapter() before making API requests.",
+      "HttpAdapter"
+    );
+  },
+  async post() {
+    throw new SpringAdapterError(
+      "No HttpAdapter configured. Call setHttpAdapter() before making API requests.",
+      "HttpAdapter"
+    );
+  },
+  async put() {
+    throw new SpringAdapterError(
+      "No HttpAdapter configured. Call setHttpAdapter() before making API requests.",
+      "HttpAdapter"
+    );
+  },
+  async delete() {
+    throw new SpringAdapterError(
+      "No HttpAdapter configured. Call setHttpAdapter() before making API requests.",
+      "HttpAdapter"
+    );
+  }
+};
+var fallbackAdapter = noopAdapter;
+var UI_KEY = /* @__PURE__ */ Symbol.for("spring:httpAdapter");
+registerFallbackMigration((instance) => {
+  if (fallbackAdapter !== noopAdapter) {
+    instance.ui[UI_KEY] = fallbackAdapter;
+  }
+});
+function setHttpAdapter(adapter) {
+  const instance = tryGetSpringInstance();
+  if (instance) {
+    instance.ui[UI_KEY] = adapter;
+  } else {
+    fallbackAdapter = adapter;
+  }
+}
+function getHttpAdapter() {
+  const instance = tryGetSpringInstance();
+  if (instance) {
+    return instance.ui[UI_KEY] ?? noopAdapter;
+  }
+  return fallbackAdapter;
+}
+function clearHttpAdapter() {
+  const instance = tryGetSpringInstance();
+  if (instance) {
+    delete instance.ui[UI_KEY];
+  }
+  fallbackAdapter = noopAdapter;
+}
+
+// src/adapters/license-adapter.ts
+var defaultLicenseInfo = {
+  tier: "community",
+  features: []
+};
+var noopAdapter2 = {
+  async validateLicense() {
+    return { valid: false, tier: "community", message: "No license adapter configured" };
+  },
+  getLicenseInfo() {
+    return defaultLicenseInfo;
+  },
+  isFeatureLicensed() {
+    return false;
+  }
+};
+var fallbackAdapter2 = noopAdapter2;
+var UI_KEY2 = /* @__PURE__ */ Symbol.for("spring:licenseAdapter");
+registerFallbackMigration((instance) => {
+  if (fallbackAdapter2 !== noopAdapter2) {
+    instance.ui[UI_KEY2] = fallbackAdapter2;
+  }
+});
+function setLicenseAdapter(adapter) {
+  const instance = tryGetSpringInstance();
+  if (instance) {
+    instance.ui[UI_KEY2] = adapter;
+  } else {
+    fallbackAdapter2 = adapter;
+  }
+}
+function getLicenseAdapter() {
+  const instance = tryGetSpringInstance();
+  if (instance) {
+    return instance.ui[UI_KEY2] ?? noopAdapter2;
+  }
+  return fallbackAdapter2;
+}
+function clearLicenseAdapter() {
+  const instance = tryGetSpringInstance();
+  if (instance) {
+    delete instance.ui[UI_KEY2];
+  }
+  fallbackAdapter2 = noopAdapter2;
+}
+function validateLicense() {
+  return getLicenseAdapter().validateLicense();
+}
+function isFeatureLicensed(feature) {
+  return getLicenseAdapter().isFeatureLicensed(feature);
+}
+function getLicenseInfo() {
+  return getLicenseAdapter().getLicenseInfo();
+}
+
+// src/adapters/notification-adapter.ts
+var fallback = {
+  error: (msg) => console.error("[Notification]", msg),
+  success: (msg) => console.info("[Notification]", msg),
+  warning: (msg) => console.warn("[Notification]", msg),
+  info: (msg) => console.info("[Notification]", msg)
+};
+var fallbackAdapter3 = fallback;
+registerFallbackMigration((instance) => {
+  if (fallbackAdapter3 !== fallback) {
+    instance.core.notificationAdapter = fallbackAdapter3;
+  }
+});
+function setNotificationAdapter(a) {
+  const instance = tryGetSpringInstance();
+  if (instance) {
+    instance.core.notificationAdapter = a;
+  } else {
+    fallbackAdapter3 = a;
+  }
+}
+function getNotificationAdapter() {
+  const instance = tryGetSpringInstance();
+  return instance ? instance.core.notificationAdapter : fallbackAdapter3;
+}
+function clearNotificationAdapter() {
+  const instance = tryGetSpringInstance();
+  if (instance) {
+    instance.core.notificationAdapter = fallback;
+  }
+  fallbackAdapter3 = fallback;
+}
+
+export {
+  setHttpAdapter,
+  getHttpAdapter,
+  clearHttpAdapter,
+  setLicenseAdapter,
+  getLicenseAdapter,
+  clearLicenseAdapter,
+  validateLicense,
+  isFeatureLicensed,
+  getLicenseInfo,
+  setNotificationAdapter,
+  getNotificationAdapter,
+  clearNotificationAdapter
+};
+//# sourceMappingURL=chunk-GON7Q32Q.js.map

package/dist/chunk-GON7Q32Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/http-adapter.ts","../src/adapters/license-adapter.ts","../src/adapters/notification-adapter.ts"],"sourcesContent":["/**\n * HTTP adapter — decouples the framework from any specific HTTP client (axios, fetch, etc.).\n *\n * Consumer applications provide their own HTTP implementation by setting a custom adapter.\n * The framework uses this adapter for all API communication (lists, forms, auth, etc.)\n *\n * @example\n * ```ts\n * import { setHttpAdapter } from \"@spring-systems/core/adapters\";\n *\n * setHttpAdapter({\n *     async request(config) {\n *         const resp = await fetch(config.url, {\n *             method: config.method ?? \"GET\",\n *             body: config.data ? JSON.stringify(config.data) : undefined,\n *             headers: config.headers,\n *             signal: config.signal,\n *         });\n *         return resp.json();\n *     },\n *     async get(url, config) {\n *         return this.request({ ...config, url, method: \"GET\" });\n *     },\n *     async post(config) {\n *         return this.request({ ...config, method: \"POST\" });\n *     },\n *     async put(config) {\n *         return this.request({ ...config, method: \"PUT\" });\n *     },\n *     async delete(url, config) {\n *         return this.request({ ...config, url, method: \"DELETE\" });\n *     },\n * });\n * ```\n *\n * @module http-adapter\n */\n\nimport { SpringAdapterError } from \"../errors/errors\";\nimport { tryGetSpringInstance } from \"../instance/current-instance\";\nimport { registerFallbackMigration } from \"../instance/fallback-bridge\";\n\nexport interface HttpRequest {\n    url: string;\n    method?: \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\";\n    data?: unknown;\n    params?: Record<string, string>;\n    headers?: Record<string, string>;\n    signal?: AbortSignal;\n    /** Override the global timeout for this request (e.g. longer timeout for exports/uploads). */\n    timeoutMs?: number;\n    suppressToast?: boolean;\n    suppressRedirect?: boolean;\n}\n\nexport interface HttpAdapter {\n    request<TResponse>(config: HttpRequest): Promise<TResponse | undefined>;\n    get<TResponse>(url: string, config?: Partial<HttpRequest>): Promise<TResponse | undefined>;\n    post<TData, TResponse>(config: HttpRequest & { data: TData }): Promise<TResponse | undefined>;\n    put<TData, TResponse>(config: HttpRequest & { data: TData }): Promise<TResponse | undefined>;\n    delete<TResponse>(url: string, config?: Partial<HttpRequest>): Promise<TResponse | undefined>;\n}\n\n/**\n * Default adapter — throws at runtime so missing adapter is caught early.\n * Consumer apps must provide a real HTTP adapter before making API calls.\n */\nconst noopAdapter = {\n    async request() {\n        throw new SpringAdapterError(\n            \"No HttpAdapter configured. Call setHttpAdapter() before making API requests.\",\n            \"HttpAdapter\",\n        );\n    },\n    async get() {\n        throw new SpringAdapterError(\n            \"No HttpAdapter configured. Call setHttpAdapter() before making API requests.\",\n            \"HttpAdapter\",\n        );\n    },\n    async post() {\n        throw new SpringAdapterError(\n            \"No HttpAdapter configured. Call setHttpAdapter() before making API requests.\",\n            \"HttpAdapter\",\n        );\n    },\n    async put() {\n        throw new SpringAdapterError(\n            \"No HttpAdapter configured. Call setHttpAdapter() before making API requests.\",\n            \"HttpAdapter\",\n        );\n    },\n    async delete() {\n        throw new SpringAdapterError(\n            \"No HttpAdapter configured. Call setHttpAdapter() before making API requests.\",\n            \"HttpAdapter\",\n        );\n    },\n} satisfies HttpAdapter;\n\nlet fallbackAdapter: HttpAdapter = noopAdapter;\n\nconst UI_KEY = Symbol.for(\"spring:httpAdapter\");\n\n// Migrate fallback HTTP adapter to SpringInstance when SpringProvider mounts\nregisterFallbackMigration((instance) => {\n    if (fallbackAdapter !== noopAdapter) {\n        instance.ui[UI_KEY] = fallbackAdapter;\n    }\n});\n\nexport function setHttpAdapter(adapter: HttpAdapter): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        instance.ui[UI_KEY] = adapter;\n    } else {\n        fallbackAdapter = adapter;\n    }\n}\n\nexport function getHttpAdapter(): HttpAdapter {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        return (instance.ui[UI_KEY] as HttpAdapter) ?? noopAdapter;\n    }\n    return fallbackAdapter;\n}\n\n/**\n * Reset the HTTP adapter to the default noop adapter.\n * For testing only.\n */\nexport function clearHttpAdapter(): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        delete instance.ui[UI_KEY];\n    }\n    fallbackAdapter = noopAdapter;\n}\n","/**\n * License adapter — provides a pluggable interface for enterprise license validation.\n *\n * Enterprise clients integrate with their license servers by providing a custom adapter.\n * The framework checks license status at key points (startup, feature gating, etc.)\n *\n * @example\n * ```ts\n * import { setLicenseAdapter } from \"@spring-systems/core/adapters\";\n *\n * setLicenseAdapter({\n *     async validateLicense() {\n *         const resp = await fetch(\"/api/license\");\n *         const data = await resp.json();\n *         return { valid: data.active, expiresAt: new Date(data.expiresAt), tier: data.tier };\n *     },\n *     getLicenseInfo() {\n *         return cachedLicenseInfo;\n *     },\n *     isFeatureLicensed(feature) {\n *         return cachedLicenseInfo.features.includes(feature);\n *     },\n * });\n * ```\n *\n * @module license-adapter\n */\n\nimport { tryGetSpringInstance } from \"../instance/current-instance\";\nimport { registerFallbackMigration } from \"../instance/fallback-bridge\";\n\n/** Result of a license validation call */\nexport interface LicenseValidationResult {\n    /** Whether the license is currently valid */\n    valid: boolean;\n    /** When the license expires (undefined = perpetual) */\n    expiresAt?: Date;\n    /** License tier identifier (e.g. \"community\", \"professional\", \"enterprise\") */\n    tier?: string;\n    /** Human-readable message (e.g. \"License expired\", \"Trial period\") */\n    message?: string;\n}\n\n/** Cached license info (synchronous access) */\nexport interface LicenseInfo {\n    /** License tier (e.g. \"standard\", \"professional\", \"enterprise\") */\n    tier: string;\n    /** List of licensed feature keys */\n    features: string[];\n    /** When the license expires */\n    expiresAt?: Date;\n}\n\nexport interface LicenseAdapter {\n    /**\n     * Validate the license asynchronously (e.g. call a license server).\n     * Called at application startup and periodically.\n     */\n    validateLicense(): Promise<LicenseValidationResult>;\n\n    /**\n     * Get cached license info synchronously.\n     * Returns info from the last successful validation.\n     */\n    getLicenseInfo(): LicenseInfo;\n\n    /**\n     * Check if a specific feature is licensed.\n     * Uses cached license info for synchronous access.\n     */\n    isFeatureLicensed(feature: string): boolean;\n}\n\nconst defaultLicenseInfo = {\n    tier: \"community\",\n    features: [],\n} satisfies LicenseInfo;\n\n/**\n * Default adapter — fail-closed: no features licensed, validation returns invalid.\n * Enterprise clients must provide a real adapter to unlock licensed features.\n * This ensures that a missing adapter never accidentally grants access.\n */\nconst noopAdapter = {\n    async validateLicense() {\n        return { valid: false, tier: \"community\", message: \"No license adapter configured\" };\n    },\n    getLicenseInfo() {\n        return defaultLicenseInfo;\n    },\n    isFeatureLicensed() {\n        return false;\n    },\n} satisfies LicenseAdapter;\n\nlet fallbackAdapter: LicenseAdapter = noopAdapter;\n\nconst UI_KEY = Symbol.for(\"spring:licenseAdapter\");\n\n// Migrate fallback license adapter to SpringInstance when SpringProvider mounts\nregisterFallbackMigration((instance) => {\n    if (fallbackAdapter !== noopAdapter) {\n        instance.ui[UI_KEY] = fallbackAdapter;\n    }\n});\n\nexport function setLicenseAdapter(adapter: LicenseAdapter): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        instance.ui[UI_KEY] = adapter;\n    } else {\n        fallbackAdapter = adapter;\n    }\n}\n\nexport function getLicenseAdapter(): LicenseAdapter {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        return (instance.ui[UI_KEY] as LicenseAdapter) ?? noopAdapter;\n    }\n    return fallbackAdapter;\n}\n\n/**\n * Reset the license adapter to the default noop (fail-closed) adapter.\n * For testing only.\n */\nexport function clearLicenseAdapter(): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        delete instance.ui[UI_KEY];\n    }\n    fallbackAdapter = noopAdapter;\n}\n\n/**\n * Convenience: validate the license via the configured adapter.\n */\nexport function validateLicense(): Promise<LicenseValidationResult> {\n    return getLicenseAdapter().validateLicense();\n}\n\n/**\n * Convenience: check if a feature is licensed.\n */\nexport function isFeatureLicensed(feature: string): boolean {\n    return getLicenseAdapter().isFeatureLicensed(feature);\n}\n\n/**\n * Convenience: get cached license info.\n */\nexport function getLicenseInfo(): LicenseInfo {\n    return getLicenseAdapter().getLicenseInfo();\n}\n","/**\n * Notification adapter — decouples API/validation layers from the UI notification system (react-toastify).\n * Pattern matches setLogAdapter() in logger.ts.\n * @module notification-adapter\n */\n\nimport { tryGetSpringInstance } from \"../instance/current-instance\";\nimport { registerFallbackMigration } from \"../instance/fallback-bridge\";\n\nexport interface NotificationAdapter {\n    error(msg: string): void;\n    success(msg: string): void;\n    warning(msg: string): void;\n    info(msg: string): void;\n}\n\nconst fallback = {\n    error: (msg) => console.error(\"[Notification]\", msg),\n    success: (msg) => console.info(\"[Notification]\", msg),\n    warning: (msg) => console.warn(\"[Notification]\", msg),\n    info: (msg) => console.info(\"[Notification]\", msg),\n} satisfies NotificationAdapter;\n\nlet fallbackAdapter: NotificationAdapter = fallback;\n\n// Migrate fallback notification adapter to SpringInstance when SpringProvider mounts\nregisterFallbackMigration((instance) => {\n    if (fallbackAdapter !== fallback) {\n        instance.core.notificationAdapter = fallbackAdapter;\n    }\n});\n\nexport function setNotificationAdapter(a: NotificationAdapter): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        instance.core.notificationAdapter = a;\n    } else {\n        fallbackAdapter = a;\n    }\n}\n\nexport function getNotificationAdapter(): NotificationAdapter {\n    const instance = tryGetSpringInstance();\n    return instance ? instance.core.notificationAdapter : fallbackAdapter;\n}\n\n/** Reset to default notification adapter. For testing/integration teardown only. */\nexport function clearNotificationAdapter(): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        instance.core.notificationAdapter = fallback;\n    }\n    fallbackAdapter = fallback;\n}\n"],"mappings":"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","names":["noopAdapter","fallbackAdapter","UI_KEY","fallbackAdapter"]}

package/dist/chunk-GXU75LQX.js

@@ -0,0 +1,182 @@
+import {
+  getRegisteredCapabilityNames,
+  hasCapability
+} from "./chunk-S7MKRNMI.js";
+import {
+  logError,
+  logWarn
+} from "./chunk-KX32MU3I.js";
+import {
+  devThrow,
+  devWarn
+} from "./chunk-EFUBAQCV.js";
+import {
+  SpringPluginError
+} from "./chunk-PT4DIYUK.js";
+
+// src/plugins/plugin.ts
+function isDescriptor(plugin) {
+  return typeof plugin === "object" && plugin !== null && "setup" in plugin;
+}
+function validateDescriptor(plugin, index) {
+  if (!plugin.name || typeof plugin.name !== "string" || plugin.name.trim().length === 0) {
+    devWarn("Plugin", `Plugin[${index}]: descriptor.name must be a non-empty string`);
+    return false;
+  }
+  if (typeof plugin.setup !== "function") {
+    devWarn("Plugin", `Plugin "${plugin.name}": descriptor.setup must be a function`);
+    return false;
+  }
+  return true;
+}
+function getPluginName(plugin, index) {
+  return isDescriptor(plugin) ? plugin.name : `plugin[${index}]`;
+}
+function topologicalSort(plugins) {
+  const descriptors = [];
+  const functions = [];
+  for (const p of plugins) {
+    if (isDescriptor(p)) {
+      descriptors.push(p);
+    } else {
+      functions.push(p);
+    }
+  }
+  if (descriptors.every((d) => !d.requires || d.requires.length === 0)) {
+    return plugins;
+  }
+  const nameMap = /* @__PURE__ */ new Map();
+  for (const d of descriptors) {
+    if (nameMap.has(d.name)) {
+      throw new SpringPluginError(
+        `Duplicate plugin name "${d.name}". Each plugin must have a unique name. If you need to override a plugin, remove the original from the plugins array first.`,
+        d.name
+      );
+    }
+    nameMap.set(d.name, d);
+  }
+  const inDegree = /* @__PURE__ */ new Map();
+  const adjacency = /* @__PURE__ */ new Map();
+  for (const d of descriptors) {
+    if (!inDegree.has(d.name)) inDegree.set(d.name, 0);
+    if (!adjacency.has(d.name)) adjacency.set(d.name, []);
+    for (const req of d.requires ?? []) {
+      if (!nameMap.has(req)) {
+        devThrow("Plugin", `Plugin "${d.name}" requires "${req}" which is not registered. Add "${req}" to the plugins array.`);
+        continue;
+      }
+      if (!adjacency.has(req)) adjacency.set(req, []);
+      const deps = adjacency.get(req);
+      if (!deps) continue;
+      deps.push(d.name);
+      inDegree.set(d.name, (inDegree.get(d.name) ?? 0) + 1);
+    }
+  }
+  const queue = [];
+  for (const [name, deg] of inDegree) {
+    if (deg === 0) queue.push(name);
+  }
+  const sorted = [];
+  while (queue.length > 0) {
+    const name = queue.shift();
+    if (!name) break;
+    const desc = nameMap.get(name);
+    if (desc) sorted.push(desc);
+    for (const neighbor of adjacency.get(name) ?? []) {
+      const deg = (inDegree.get(neighbor) ?? 1) - 1;
+      inDegree.set(neighbor, deg);
+      if (deg === 0) queue.push(neighbor);
+    }
+  }
+  if (sorted.length < descriptors.length) {
+    const missing = descriptors.filter((d) => !sorted.includes(d)).map((d) => d.name);
+    throw new SpringPluginError(
+      `Circular dependency detected among plugins: ${missing.join(", ")}. Review the 'requires' arrays to break the cycle.`,
+      missing[0] ?? "unknown"
+    );
+  }
+  return [...functions, ...sorted];
+}
+var CLEANUP_KEY = /* @__PURE__ */ Symbol.for("spring:pluginCleanups");
+var LOADED_KEY = /* @__PURE__ */ Symbol.for("spring:loadedPlugins");
+function applyPlugins(instance, plugins) {
+  const sorted = topologicalSort(plugins);
+  const cleanups = [];
+  const loaded = [];
+  for (let i = 0; i < sorted.length; i++) {
+    const plugin = sorted[i];
+    if (!plugin) continue;
+    if (typeof plugin !== "function" && !isDescriptor(plugin)) {
+      devWarn("Plugin", `Plugin[${i}] is neither a function nor a valid descriptor \u2014 skipping`);
+      continue;
+    }
+    if (isDescriptor(plugin) && !validateDescriptor(plugin, i)) {
+      continue;
+    }
+    const name = getPluginName(plugin, i);
+    if (isDescriptor(plugin) && plugin.capabilities) {
+      const registeredNames = getRegisteredCapabilityNames();
+      const unregistered = plugin.capabilities.filter(
+        (c) => !registeredNames.includes(c)
+      );
+      if (unregistered.length > 0) {
+        devWarn(
+          "Plugin",
+          `Plugin "${name}" references unregistered capabilities: ${unregistered.join(", ")}. Did you forget to call configureCapabilities()? Registered: [${registeredNames.join(", ")}]`
+        );
+      }
+      const missing = plugin.capabilities.filter((c) => !hasCapability(c));
+      if (missing.length > 0) {
+        logWarn("Plugin", `Skipping "${name}" \u2014 missing capabilities: ${missing.join(", ")}`);
+        continue;
+      }
+    }
+    try {
+      const setupFn = isDescriptor(plugin) ? plugin.setup : plugin;
+      const setupCleanup = setupFn(instance);
+      if (typeof setupCleanup === "function") {
+        cleanups.push(setupCleanup);
+      } else if (setupCleanup !== void 0) {
+        logWarn("Plugin", `Plugin "${name}" returned non-function cleanup; ignoring.`);
+      }
+      if (isDescriptor(plugin) && plugin.cleanup !== void 0) {
+        if (typeof plugin.cleanup === "function") {
+          cleanups.push(plugin.cleanup);
+        } else {
+          logWarn("Plugin", `Plugin "${name}" has non-function descriptor.cleanup; ignoring.`);
+        }
+      }
+      loaded.push({
+        name,
+        version: isDescriptor(plugin) ? plugin.version : void 0
+      });
+    } catch (e) {
+      logError(`Plugin setup failed: ${name}`, e);
+    }
+  }
+  instance.ui[CLEANUP_KEY] = cleanups;
+  instance.ui[LOADED_KEY] = loaded;
+}
+function disposePlugins(instance) {
+  const cleanups = instance.ui[CLEANUP_KEY];
+  if (!cleanups) return;
+  for (const cleanup of cleanups) {
+    try {
+      cleanup();
+    } catch (e) {
+      logError("Plugin cleanup failed", e);
+    }
+  }
+  delete instance.ui[CLEANUP_KEY];
+  delete instance.ui[LOADED_KEY];
+}
+function getLoadedPlugins(instance) {
+  return instance.ui[LOADED_KEY] ?? [];
+}
+
+export {
+  applyPlugins,
+  disposePlugins,
+  getLoadedPlugins
+};
+//# sourceMappingURL=chunk-GXU75LQX.js.map

package/dist/chunk-GXU75LQX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugins/plugin.ts"],"sourcesContent":["/**\n * Plugin system for the SPRING framework.\n *\n * A plugin can be either:\n * - A simple setup function (backward compatible): `(instance) => cleanup?`\n * - A plugin descriptor with metadata: `{ name, version, setup, ... }`\n *\n * Plugin descriptors enable:\n * - Dependency declaration and topological ordering\n * - Capability requirements checking\n * - Version compatibility validation\n * - Plugin discovery and introspection\n *\n * @module plugin\n */\n\nimport { getRegisteredCapabilityNames,hasCapability } from \"../config/capabilities\";\nimport { SpringPluginError } from \"../errors/errors\";\nimport type { SpringInstance } from \"../instance/spring-instance\";\nimport { logError, logWarn } from \"../logger/logger\";\nimport type { FormDataValue, FormStoreState } from \"../types/form-types\";\nimport type { ColumnType } from \"../types/grid-types\";\nimport { devThrow, devWarn } from \"../utils/dev-warnings\";\n\n// ---------------------------------------------------------------------------\n// Types for plugin authors (column renderers)\n// ---------------------------------------------------------------------------\n\n/** Column renderer info passed to custom renderers. */\nexport interface PluginColumnRendererInfo {\n    field: string;\n    type: ColumnType;\n    title: string;\n    suffix?: string;\n    decimals?: number;\n    name?: string;\n}\n\n/**\n * Column renderer function signature.\n * Returns a React node (any valid JSX return value).\n */\nexport type PluginColumnRenderer = (\n    value: FormDataValue,\n    row: FormStoreState,\n    column: PluginColumnRendererInfo,\n) => unknown;\n\n// ---------------------------------------------------------------------------\n// Plugin types\n// ---------------------------------------------------------------------------\n\n/** Simple plugin function (backward compatible) */\nexport type SpringPluginFn = (instance: SpringInstance) => void | (() => void);\n\n/**\n * Plugin descriptor with metadata for enterprise plugin management.\n *\n * @example\n * ```ts\n * const auditPlugin: SpringPluginDescriptor = {\n *     name: \"@spring-systems/audit\",\n *     version: \"1.0.0\",\n *     requires: [\"@spring-systems/core-validators\"],\n *     capabilities: [\"advancedFiltering\"],\n *     setup(instance) {\n *         registerMiddleware(\"form:beforeSave\", auditMiddleware);\n *         return () => { cleanup(); };\n *     },\n * };\n * ```\n */\nexport interface SpringPluginDescriptor {\n    /** Unique plugin name. Use npm-style scoped names (e.g. \"@myorg/plugin-name\"). */\n    name: string;\n    /** Semver version string. */\n    version?: string;\n    /** Names of plugins that must be loaded before this one. */\n    requires?: string[];\n    /** Capability keys that must be enabled for this plugin to activate. */\n    capabilities?: string[];\n    /** Plugin setup function. Returns optional cleanup. */\n    setup: SpringPluginFn;\n    /**\n     * Explicit cleanup function. Called by `disposePlugins()` alongside any\n     * cleanup returned from `setup()`. Also available for direct invocation\n     * by consumers who hold a reference to the descriptor.\n     */\n    cleanup?: () => void;\n}\n\n/** A SPRING plugin — either a simple function or a descriptor with metadata. */\nexport type SpringPlugin = SpringPluginFn | SpringPluginDescriptor;\n\nfunction isDescriptor(plugin: SpringPlugin): plugin is SpringPluginDescriptor {\n    return typeof plugin === \"object\" && plugin !== null && \"setup\" in plugin;\n}\n\nfunction validateDescriptor(plugin: SpringPluginDescriptor, index: number): boolean {\n    if (!plugin.name || typeof plugin.name !== \"string\" || plugin.name.trim().length === 0) {\n        devWarn(\"Plugin\", `Plugin[${index}]: descriptor.name must be a non-empty string`);\n        return false;\n    }\n    if (typeof plugin.setup !== \"function\") {\n        devWarn(\"Plugin\", `Plugin \"${plugin.name}\": descriptor.setup must be a function`);\n        return false;\n    }\n    return true;\n}\n\nfunction getPluginName(plugin: SpringPlugin, index: number): string {\n    return isDescriptor(plugin) ? plugin.name : `plugin[${index}]`;\n}\n\n// ---------------------------------------------------------------------------\n// Topological sort for plugin dependencies\n// ---------------------------------------------------------------------------\n\nfunction topologicalSort(plugins: SpringPlugin[]): SpringPlugin[] {\n    // Separate descriptors (with potential deps) from simple functions\n    const descriptors: SpringPluginDescriptor[] = [];\n    const functions: SpringPluginFn[] = [];\n\n    for (const p of plugins) {\n        if (isDescriptor(p)) {\n            descriptors.push(p);\n        } else {\n            functions.push(p);\n        }\n    }\n\n    // If no descriptors have dependencies, skip sorting\n    if (descriptors.every((d) => !d.requires || d.requires.length === 0)) {\n        return plugins;\n    }\n\n    // Build adjacency map\n    const nameMap = new Map<string, SpringPluginDescriptor>();\n    for (const d of descriptors) {\n        if (nameMap.has(d.name)) {\n            throw new SpringPluginError(\n                `Duplicate plugin name \"${d.name}\". ` +\n                    \"Each plugin must have a unique name. If you need to override a plugin, \" +\n                    \"remove the original from the plugins array first.\",\n                d.name,\n            );\n        }\n        nameMap.set(d.name, d);\n    }\n\n    // Kahn's algorithm for topological sort\n    const inDegree = new Map<string, number>();\n    const adjacency = new Map<string, string[]>();\n\n    for (const d of descriptors) {\n        if (!inDegree.has(d.name)) inDegree.set(d.name, 0);\n        if (!adjacency.has(d.name)) adjacency.set(d.name, []);\n\n        for (const req of d.requires ?? []) {\n            if (!nameMap.has(req)) {\n                devThrow(\"Plugin\", `Plugin \"${d.name}\" requires \"${req}\" which is not registered. Add \"${req}\" to the plugins array.`);\n                continue;\n            }\n            if (!adjacency.has(req)) adjacency.set(req, []);\n            const deps = adjacency.get(req);\n            if (!deps) continue;\n            deps.push(d.name);\n            inDegree.set(d.name, (inDegree.get(d.name) ?? 0) + 1);\n        }\n    }\n\n    const queue: string[] = [];\n    for (const [name, deg] of inDegree) {\n        if (deg === 0) queue.push(name);\n    }\n\n    const sorted: SpringPluginDescriptor[] = [];\n    while (queue.length > 0) {\n        const name = queue.shift();\n        if (!name) break;\n        const desc = nameMap.get(name);\n        if (desc) sorted.push(desc);\n        for (const neighbor of adjacency.get(name) ?? []) {\n            const deg = (inDegree.get(neighbor) ?? 1) - 1;\n            inDegree.set(neighbor, deg);\n            if (deg === 0) queue.push(neighbor);\n        }\n    }\n\n    if (sorted.length < descriptors.length) {\n        const missing = descriptors.filter((d) => !sorted.includes(d)).map((d) => d.name);\n        throw new SpringPluginError(\n            `Circular dependency detected among plugins: ${missing.join(\", \")}. ` +\n                \"Review the 'requires' arrays to break the cycle.\",\n            missing[0] ?? \"unknown\",\n        );\n    }\n\n    // Simple functions first, then sorted descriptors\n    return [...functions, ...sorted];\n}\n\n// ---------------------------------------------------------------------------\n// Plugin lifecycle\n// ---------------------------------------------------------------------------\n\nconst CLEANUP_KEY: unique symbol = Symbol.for(\"spring:pluginCleanups\");\nconst LOADED_KEY: unique symbol = Symbol.for(\"spring:loadedPlugins\");\n\ninterface LoadedPluginInfo {\n    name: string;\n    version?: string;\n}\n\n/**\n * Apply an array of plugins to a SpringInstance.\n * Plugins with dependencies are topologically sorted.\n * Each may return a cleanup function stored on the instance.\n *\n * Setup errors are caught and logged — a failing plugin does not block others.\n *\n * @param instance - The SpringInstance to apply plugins to\n * @param plugins - Array of plugins (simple functions or descriptors with metadata)\n */\nexport function applyPlugins(instance: SpringInstance, plugins: SpringPlugin[]): void {\n    const sorted = topologicalSort(plugins);\n    const cleanups: (() => void)[] = [];\n    const loaded: LoadedPluginInfo[] = [];\n\n    for (let i = 0; i < sorted.length; i++) {\n        const plugin = sorted[i];\n        if (!plugin) continue;\n\n        // Validate plugin structure\n        if (typeof plugin !== \"function\" && !isDescriptor(plugin)) {\n            devWarn(\"Plugin\", `Plugin[${i}] is neither a function nor a valid descriptor — skipping`);\n            continue;\n        }\n        if (isDescriptor(plugin) && !validateDescriptor(plugin, i)) {\n            continue;\n        }\n\n        const name = getPluginName(plugin, i);\n\n        // Check capability requirements\n        if (isDescriptor(plugin) && plugin.capabilities) {\n            // Warn about capabilities that haven't been registered at all\n            const registeredNames = getRegisteredCapabilityNames();\n            const unregistered = plugin.capabilities.filter(\n                (c) => !registeredNames.includes(c),\n            );\n            if (unregistered.length > 0) {\n                devWarn(\n                    \"Plugin\",\n                    `Plugin \"${name}\" references unregistered capabilities: ${unregistered.join(\", \")}. ` +\n                        `Did you forget to call configureCapabilities()? Registered: [${registeredNames.join(\", \")}]`,\n                );\n            }\n\n            const missing = plugin.capabilities.filter((c) => !hasCapability(c as keyof import(\"../config/capabilities\").CapabilityMap));\n            if (missing.length > 0) {\n                logWarn(\"Plugin\", `Skipping \"${name}\" — missing capabilities: ${missing.join(\", \")}`);\n                continue;\n            }\n        }\n\n        try {\n            const setupFn = isDescriptor(plugin) ? plugin.setup : plugin;\n            const setupCleanup = setupFn(instance);\n            if (typeof setupCleanup === \"function\") {\n                cleanups.push(setupCleanup);\n            } else if (setupCleanup !== undefined) {\n                logWarn(\"Plugin\", `Plugin \"${name}\" returned non-function cleanup; ignoring.`);\n            }\n            if (isDescriptor(plugin) && plugin.cleanup !== undefined) {\n                if (typeof plugin.cleanup === \"function\") {\n                    cleanups.push(plugin.cleanup);\n                } else {\n                    logWarn(\"Plugin\", `Plugin \"${name}\" has non-function descriptor.cleanup; ignoring.`);\n                }\n            }\n            loaded.push({\n                name,\n                version: isDescriptor(plugin) ? plugin.version : undefined,\n            });\n        } catch (e: unknown) {\n            logError(`Plugin setup failed: ${name}`, e);\n        }\n    }\n\n    instance.ui[CLEANUP_KEY] = cleanups;\n    instance.ui[LOADED_KEY] = loaded;\n}\n\n/**\n * Run all cleanup functions stored by `applyPlugins()` and remove them\n * from the instance. Errors during cleanup are caught and logged.\n *\n * @param instance - The SpringInstance whose plugins should be disposed\n */\nexport function disposePlugins(instance: SpringInstance): void {\n    const cleanups = instance.ui[CLEANUP_KEY] as (() => void)[] | undefined;\n    if (!cleanups) return;\n    for (const cleanup of cleanups) {\n        try {\n            cleanup();\n        } catch (e: unknown) {\n            logError(\"Plugin cleanup failed\", e);\n        }\n    }\n    delete instance.ui[CLEANUP_KEY];\n    delete instance.ui[LOADED_KEY];\n}\n\n/**\n * Get the list of loaded plugins for the given instance.\n * Useful for debugging and introspection.\n */\nexport function getLoadedPlugins(instance: SpringInstance): ReadonlyArray<LoadedPluginInfo> {\n    return (instance.ui[LOADED_KEY] as LoadedPluginInfo[]) ?? [];\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-HFELOXDQ.js

@@ -0,0 +1,110 @@
+import {
+  registerFallbackMigration
+} from "./chunk-RUCXSQEY.js";
+import {
+  logError
+} from "./chunk-KX32MU3I.js";
+import {
+  tryGetSpringInstance
+} from "./chunk-EFUBAQCV.js";
+
+// src/auth/auth-handler.ts
+var fallbackLogoutHandler = null;
+var fallbackAuthenticated = false;
+var fallbackLogoutInFlight = null;
+registerFallbackMigration((instance) => {
+  if (fallbackLogoutHandler) {
+    instance.core.logoutHandler = fallbackLogoutHandler;
+  }
+  if (fallbackAuthenticated) {
+    instance.core.authenticated = fallbackAuthenticated;
+  }
+  if (fallbackLogoutInFlight) {
+    const migratingPromise = fallbackLogoutInFlight;
+    instance.core.logoutInFlight = migratingPromise;
+    void migratingPromise.finally(() => {
+      if (instance.core.logoutInFlight === migratingPromise) {
+        instance.core.logoutInFlight = null;
+      }
+    });
+  }
+});
+function setLogoutHandler(handler) {
+  const instance = tryGetSpringInstance();
+  if (instance) {
+    instance.core.logoutHandler = handler;
+  } else {
+    fallbackLogoutHandler = handler;
+  }
+}
+function setAuthenticated(value) {
+  const instance = tryGetSpringInstance();
+  if (instance) {
+    instance.core.authenticated = value;
+  } else {
+    fallbackAuthenticated = value;
+  }
+}
+function isAuthenticated() {
+  const instance = tryGetSpringInstance();
+  return instance ? instance.core.authenticated : fallbackAuthenticated;
+}
+async function triggerLogout(reason) {
+  const instance = tryGetSpringInstance();
+  const getLogoutHandler = () => instance ? instance.core.logoutHandler : fallbackLogoutHandler;
+  const getLogoutInFlight = () => instance ? instance.core.logoutInFlight : fallbackLogoutInFlight;
+  const setLogoutInFlight = (p) => {
+    if (instance) {
+      instance.core.logoutInFlight = p;
+    } else {
+      fallbackLogoutInFlight = p;
+    }
+  };
+  const setAuth = (v) => {
+    if (instance) {
+      instance.core.authenticated = v;
+    } else {
+      fallbackAuthenticated = v;
+    }
+  };
+  const handler = getLogoutHandler();
+  if (!handler) return;
+  if (reason === "unauthorized" || reason === "token_missing") {
+    setAuth(false);
+  }
+  const inFlight = getLogoutInFlight();
+  if (inFlight) {
+    return inFlight;
+  }
+  const promise = (async () => {
+    try {
+      await handler(reason);
+    } catch (e) {
+      logError("Auth.logout", e);
+    } finally {
+      setLogoutInFlight(null);
+    }
+  })();
+  setLogoutInFlight(promise);
+  await promise;
+}
+function clearAuthState() {
+  const instance = tryGetSpringInstance();
+  if (instance) {
+    instance.core.logoutHandler = null;
+    instance.core.authenticated = false;
+    instance.core.logoutInFlight = null;
+  }
+  fallbackLogoutHandler = null;
+  fallbackAuthenticated = false;
+  fallbackLogoutInFlight = null;
+}
+
+export {
+  setLogoutHandler,
+  setAuthenticated,
+  isAuthenticated,
+  triggerLogout,
+  clearAuthState
+};
+//# sourceMappingURL=chunk-HFELOXDQ.js.map

package/dist/chunk-HFELOXDQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/auth/auth-handler.ts"],"sourcesContent":["import { tryGetSpringInstance } from \"../instance/current-instance\";\nimport { registerFallbackMigration } from \"../instance/fallback-bridge\";\nimport type { LogoutHandler,LogoutReason } from \"../instance/spring-instance\";\nimport { logError } from \"../logger/logger\";\n\nexport type { LogoutHandler,LogoutReason };\n\n// Fallback state for code that runs before SpringInstance is created\nlet fallbackLogoutHandler: LogoutHandler | null = null;\nlet fallbackAuthenticated = false;\nlet fallbackLogoutInFlight: Promise<void> | null = null;\n\n// Migrate fallback auth state to SpringInstance when SpringProvider mounts\nregisterFallbackMigration((instance) => {\n    if (fallbackLogoutHandler) {\n        instance.core.logoutHandler = fallbackLogoutHandler;\n    }\n    if (fallbackAuthenticated) {\n        instance.core.authenticated = fallbackAuthenticated;\n    }\n    if (fallbackLogoutInFlight) {\n        const migratingPromise = fallbackLogoutInFlight;\n        instance.core.logoutInFlight = migratingPromise;\n        void migratingPromise.finally(() => {\n            if (instance.core.logoutInFlight === migratingPromise) {\n                instance.core.logoutInFlight = null;\n            }\n        });\n    }\n});\n\nexport function setLogoutHandler(handler: LogoutHandler): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        instance.core.logoutHandler = handler;\n    } else {\n        fallbackLogoutHandler = handler;\n    }\n}\n\nexport function setAuthenticated(value: boolean): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        instance.core.authenticated = value;\n    } else {\n        fallbackAuthenticated = value;\n    }\n}\n\nexport function isAuthenticated(): boolean {\n    const instance = tryGetSpringInstance();\n    return instance ? instance.core.authenticated : fallbackAuthenticated;\n}\n\nexport async function triggerLogout(reason: LogoutReason): Promise<void> {\n    const instance = tryGetSpringInstance();\n\n    const getLogoutHandler = () => instance ? instance.core.logoutHandler : fallbackLogoutHandler;\n    const getLogoutInFlight = () => instance ? instance.core.logoutInFlight : fallbackLogoutInFlight;\n    const setLogoutInFlight = (p: Promise<void> | null) => {\n        if (instance) {\n            instance.core.logoutInFlight = p;\n        } else {\n            fallbackLogoutInFlight = p;\n        }\n    };\n    const setAuth = (v: boolean) => {\n        if (instance) {\n            instance.core.authenticated = v;\n        } else {\n            fallbackAuthenticated = v;\n        }\n    };\n\n    const handler = getLogoutHandler();\n    if (!handler) return;\n    if (reason === \"unauthorized\" || reason === \"token_missing\") {\n        setAuth(false);\n    }\n    const inFlight = getLogoutInFlight();\n    if (inFlight) {\n        return inFlight;\n    }\n    const promise = (async () => {\n        try {\n            await handler(reason);\n        } catch (e: unknown) {\n            logError(\"Auth.logout\", e);\n        } finally {\n            setLogoutInFlight(null);\n        }\n    })();\n    setLogoutInFlight(promise);\n    await promise;\n}\n\n/**\n * Clears auth-related fallback and instance state.\n * Intended for test/integration teardown.\n */\nexport function clearAuthState(): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        instance.core.logoutHandler = null;\n        instance.core.authenticated = false;\n        instance.core.logoutInFlight = null;\n    }\n\n    fallbackLogoutHandler = null;\n    fallbackAuthenticated = false;\n    fallbackLogoutInFlight = null;\n}\n"],"mappings":";;;;;;;;;;;AAQA,IAAI,wBAA8C;AAClD,IAAI,wBAAwB;AAC5B,IAAI,yBAA+C;AAGnD,0BAA0B,CAAC,aAAa;AACpC,MAAI,uBAAuB;AACvB,aAAS,KAAK,gBAAgB;AAAA,EAClC;AACA,MAAI,uBAAuB;AACvB,aAAS,KAAK,gBAAgB;AAAA,EAClC;AACA,MAAI,wBAAwB;AACxB,UAAM,mBAAmB;AACzB,aAAS,KAAK,iBAAiB;AAC/B,SAAK,iBAAiB,QAAQ,MAAM;AAChC,UAAI,SAAS,KAAK,mBAAmB,kBAAkB;AACnD,iBAAS,KAAK,iBAAiB;AAAA,MACnC;AAAA,IACJ,CAAC;AAAA,EACL;AACJ,CAAC;AAEM,SAAS,iBAAiB,SAA8B;AAC3D,QAAM,WAAW,qBAAqB;AACtC,MAAI,UAAU;AACV,aAAS,KAAK,gBAAgB;AAAA,EAClC,OAAO;AACH,4BAAwB;AAAA,EAC5B;AACJ;AAEO,SAAS,iBAAiB,OAAsB;AACnD,QAAM,WAAW,qBAAqB;AACtC,MAAI,UAAU;AACV,aAAS,KAAK,gBAAgB;AAAA,EAClC,OAAO;AACH,4BAAwB;AAAA,EAC5B;AACJ;AAEO,SAAS,kBAA2B;AACvC,QAAM,WAAW,qBAAqB;AACtC,SAAO,WAAW,SAAS,KAAK,gBAAgB;AACpD;AAEA,eAAsB,cAAc,QAAqC;AACrE,QAAM,WAAW,qBAAqB;AAEtC,QAAM,mBAAmB,MAAM,WAAW,SAAS,KAAK,gBAAgB;AACxE,QAAM,oBAAoB,MAAM,WAAW,SAAS,KAAK,iBAAiB;AAC1E,QAAM,oBAAoB,CAAC,MAA4B;AACnD,QAAI,UAAU;AACV,eAAS,KAAK,iBAAiB;AAAA,IACnC,OAAO;AACH,+BAAyB;AAAA,IAC7B;AAAA,EACJ;AACA,QAAM,UAAU,CAAC,MAAe;AAC5B,QAAI,UAAU;AACV,eAAS,KAAK,gBAAgB;AAAA,IAClC,OAAO;AACH,8BAAwB;AAAA,IAC5B;AAAA,EACJ;AAEA,QAAM,UAAU,iBAAiB;AACjC,MAAI,CAAC,QAAS;AACd,MAAI,WAAW,kBAAkB,WAAW,iBAAiB;AACzD,YAAQ,KAAK;AAAA,EACjB;AACA,QAAM,WAAW,kBAAkB;AACnC,MAAI,UAAU;AACV,WAAO;AAAA,EACX;AACA,QAAM,WAAW,YAAY;AACzB,QAAI;AACA,YAAM,QAAQ,MAAM;AAAA,IACxB,SAAS,GAAY;AACjB,eAAS,eAAe,CAAC;AAAA,IAC7B,UAAE;AACE,wBAAkB,IAAI;AAAA,IAC1B;AAAA,EACJ,GAAG;AACH,oBAAkB,OAAO;AACzB,QAAM;AACV;AAMO,SAAS,iBAAuB;AACnC,QAAM,WAAW,qBAAqB;AACtC,MAAI,UAAU;AACV,aAAS,KAAK,gBAAgB;AAC9B,aAAS,KAAK,gBAAgB;AAC9B,aAAS,KAAK,iBAAiB;AAAA,EACnC;AAEA,0BAAwB;AACxB,0BAAwB;AACxB,2BAAyB;AAC7B;","names":[]}