@happyvertical/smrt-core 0.30.0

package/dist/registry/shared-state.js

@@ -0,0 +1,135 @@
+import { createLogger } from "@happyvertical/logger";
+import { getSmrtModuleConfig } from "../config/global-config.js";
+import { LRUCache } from "../utils/lru-cache.js";
+const VERBOSE_ENABLED = process.env.SMRT_VERBOSE === "true" || (process.env.DEBUG?.includes("smrt") ?? false);
+const logger = createLogger({ level: VERBOSE_ENABLED ? "debug" : "info" });
+function verboseLog(...args) {
+  if (VERBOSE_ENABLED) {
+    const [message, ...rest] = args;
+    logger.debug(
+      typeof message === "string" ? message : String(message),
+      rest.length > 0 ? { args: rest } : void 0
+    );
+  }
+}
+function getInheritanceConfig() {
+  const config = getSmrtModuleConfig("smrt", {});
+  return {
+    cacheSize: config.inheritance?.cacheSize ?? 200,
+    onMissingAncestor: config.inheritance?.onMissingAncestor ?? "warn"
+  };
+}
+function getSourceFileFromStack() {
+  const error = new Error();
+  const stack = error.stack || "";
+  const stackLines = stack.split("\n");
+  for (const line of stackLines) {
+    const fileMatch = line.match(
+      /(?:file:\/\/)?([^)\s]+\.(?:js|ts|mjs|mts|jsx|tsx|cjs|cts))(?::\d+:\d+)?/
+    );
+    if (fileMatch) {
+      const rawPath = fileMatch[1];
+      const normalizedPath = rawPath.replace(/^file:\/+/, "").replace(/\\/g, "/");
+      const lowerPath = normalizedPath.toLowerCase();
+      if (
+        // Installed package form: node_modules/@happyvertical/smrt-core/...
+        lowerPath.includes("/node_modules/@happyvertical/smrt-core/") || // Monorepo/workspace form: packages/core/src/...
+        lowerPath.includes("/packages/core/src/") && !lowerPath.includes("__tests__") || // Specific manifest loader internals
+        lowerPath.includes("/manifest/manifest-loader")
+      ) {
+        continue;
+      }
+      return normalizedPath;
+    }
+  }
+  return void 0;
+}
+function getClasses() {
+  if (!globalThis.__smrtRegistryClasses) {
+    globalThis.__smrtRegistryClasses = /* @__PURE__ */ new Map();
+  }
+  return globalThis.__smrtRegistryClasses;
+}
+function getCollections() {
+  if (!globalThis.__smrtRegistryCollections) {
+    globalThis.__smrtRegistryCollections = /* @__PURE__ */ new Map();
+  }
+  return globalThis.__smrtRegistryCollections;
+}
+function getCollectionTableNames() {
+  if (!globalThis.__smrtRegistryCollectionTableNames) {
+    globalThis.__smrtRegistryCollectionTableNames = /* @__PURE__ */ new Map();
+  }
+  return globalThis.__smrtRegistryCollectionTableNames;
+}
+function getCollectionCache() {
+  if (!globalThis.__smrtRegistryCollectionCache) {
+    globalThis.__smrtRegistryCollectionCache = new LRUCache(100);
+  }
+  return globalThis.__smrtRegistryCollectionCache;
+}
+function getDbInstanceIds() {
+  if (!globalThis.__smrtRegistryDbInstanceIds) {
+    globalThis.__smrtRegistryDbInstanceIds = /* @__PURE__ */ new WeakMap();
+  }
+  return globalThis.__smrtRegistryDbInstanceIds;
+}
+function getNextDbId() {
+  if (globalThis.__smrtRegistryNextDbId === void 0) {
+    globalThis.__smrtRegistryNextDbId = 1;
+  }
+  return globalThis.__smrtRegistryNextDbId;
+}
+function setNextDbId(value) {
+  globalThis.__smrtRegistryNextDbId = value;
+}
+function getFieldDecorators() {
+  if (!globalThis.__smrtRegistryFieldDecorators) {
+    globalThis.__smrtRegistryFieldDecorators = /* @__PURE__ */ new Map();
+  }
+  return globalThis.__smrtRegistryFieldDecorators;
+}
+function getStiSiblingsLoaded() {
+  if (!globalThis.__smrtRegistryStiSiblingsLoaded) {
+    globalThis.__smrtRegistryStiSiblingsLoaded = /* @__PURE__ */ new Set();
+  }
+  return globalThis.__smrtRegistryStiSiblingsLoaded;
+}
+function getConstructorIndex() {
+  if (!globalThis.__smrtRegistryConstructorIndex) {
+    globalThis.__smrtRegistryConstructorIndex = /* @__PURE__ */ new WeakMap();
+  }
+  return globalThis.__smrtRegistryConstructorIndex;
+}
+function getInheritanceCache() {
+  if (!globalThis.__smrtRegistryInheritanceChainCache) {
+    const config = getInheritanceConfig();
+    globalThis.__smrtRegistryInheritanceChainCache = new LRUCache(config.cacheSize);
+  }
+  return globalThis.__smrtRegistryInheritanceChainCache;
+}
+function getDiscoveryAttemptCache() {
+  if (!globalThis.__smrtRegistryDiscoveryAttemptCache) {
+    globalThis.__smrtRegistryDiscoveryAttemptCache = /* @__PURE__ */ new Map();
+  }
+  return globalThis.__smrtRegistryDiscoveryAttemptCache;
+}
+export {
+  VERBOSE_ENABLED,
+  getClasses,
+  getCollectionCache,
+  getCollectionTableNames,
+  getCollections,
+  getConstructorIndex,
+  getDbInstanceIds,
+  getDiscoveryAttemptCache,
+  getFieldDecorators,
+  getInheritanceCache,
+  getInheritanceConfig,
+  getNextDbId,
+  getSourceFileFromStack,
+  getStiSiblingsLoaded,
+  setNextDbId,
+  verboseLog
+};
+//# sourceMappingURL=shared-state.js.map

package/dist/registry/shared-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-state.js","sources":["../../src/registry/shared-state.ts"],"sourcesContent":["/**\n * Shared state accessors for the SMRT ObjectRegistry.\n *\n * All registry sub-modules share state via globalThis to ensure\n * cross-module consistency in monorepo environments.\n *\n * Extracted from registry.ts as part of issue #1006.\n * @see https://github.com/happyvertical/smrt/issues/1006\n * @see https://github.com/happyvertical/smrt/issues/543\n */\n\nimport { createLogger } from '@happyvertical/logger';\nimport type { SmrtCollection } from '../collection';\nimport {\n  getSmrtModuleConfig,\n  type SmrtGlobalConfig,\n} from '../config/global-config.js';\nimport { LRUCache } from '../utils/lru-cache';\nimport type { RegisteredClass, SmrtObjectConstructor } from './types';\n\n// Re-export the globalThis augmentation so it's visible everywhere\ndeclare global {\n  // eslint-disable-next-line no-var\n  var __smrtRegistryClasses: Map<string, any> | undefined;\n  // eslint-disable-next-line no-var\n  var __smrtRegistryCollections: Map<string, typeof SmrtCollection> | undefined;\n  // eslint-disable-next-line no-var\n  var __smrtRegistryCollectionCache:\n    | LRUCache<string, SmrtCollection<any>>\n    | undefined;\n  // eslint-disable-next-line no-var\n  var __smrtRegistryDbInstanceIds: WeakMap<object, number> | undefined;\n  // eslint-disable-next-line no-var\n  var __smrtRegistryNextDbId: number | undefined;\n  // eslint-disable-next-line no-var\n  var __smrtRegistryInheritanceChainCache:\n    | LRUCache<string, string[]>\n    | undefined;\n  // eslint-disable-next-line no-var\n  var __smrtRegistryFieldDecorators: Map<string, Map<string, any>> | undefined;\n  // eslint-disable-next-line no-var\n  var __smrtRegistryStiSiblingsLoaded: Set<string> | undefined;\n  // eslint-disable-next-line no-var\n  var __smrtRegistryCollectionTableNames: Map<string, string> | undefined;\n  // Release B (#1133) removed __smrtRegistryClassNameMap — case-insensitive\n  // lookups now iterate the `classes` Map directly. The globalThis slot is\n  // left undeclared so any leftover code that reaches for it gets a clean\n  // TS error instead of silently stale data.\n  // eslint-disable-next-line no-var\n  var __smrtRegistrySchemasInitialized: WeakSet<object> | undefined;\n  // eslint-disable-next-line no-var\n  var __smrtRegistryConstructorIndex:\n    | WeakMap<SmrtObjectConstructor, string>\n    | undefined;\n  // eslint-disable-next-line no-var\n  var __smrtRegistryDiscoveryAttemptCache: Map<string, boolean> | undefined;\n}\n\n/**\n * Cached verbose flag evaluated once at module load time.\n * Checks SMRT_VERBOSE=true or DEBUG containing 'smrt'.\n * Avoids repeated env var parsing on every log statement.\n * @see https://github.com/happyvertical/smrt/issues/782\n */\nexport const VERBOSE_ENABLED =\n  process.env.SMRT_VERBOSE === 'true' ||\n  (process.env.DEBUG?.includes('smrt') ?? false);\n\n// verboseLog() is gated by VERBOSE_ENABLED, so the level must allow debug when\n// it's set (a fixed 'info' would filter the trace out and break SMRT_VERBOSE).\nconst logger = createLogger({ level: VERBOSE_ENABLED ? 'debug' : 'info' });\n\n/**\n * Log a message only when verbose mode is enabled.\n * Used throughout registry modules to reduce noise during normal operation.\n * @param args - Arguments to pass to console.log\n */\nexport function verboseLog(...args: unknown[]): void {\n  if (VERBOSE_ENABLED) {\n    const [message, ...rest] = args;\n    logger.debug(\n      typeof message === 'string' ? message : String(message),\n      rest.length > 0 ? { args: rest } : undefined,\n    );\n  }\n}\n\n/**\n * Get inheritance config synchronously.\n * Uses the config package's sync accessor which returns already-loaded config.\n */\nexport function getInheritanceConfig() {\n  const config = getSmrtModuleConfig<SmrtGlobalConfig>('smrt', {});\n  return {\n    cacheSize: config.inheritance?.cacheSize ?? 200,\n    onMissingAncestor:\n      config.inheritance?.onMissingAncestor ?? ('warn' as 'warn' | 'error'),\n  };\n}\n\n/**\n * Extract the source file path from the call stack.\n *\n * Used to identify where a class was defined for collision detection.\n * This allows the same class to be re-registered when modules are re-evaluated\n * (e.g., during vitest test file collection with isolation enabled).\n *\n * @returns The file path where the @smrt() decorator was called, or undefined\n */\nexport function getSourceFileFromStack(): string | undefined {\n  const error = new Error();\n  const stack = error.stack || '';\n  const stackLines = stack.split('\\n');\n\n  // Look for the first file path that's NOT from smrt-core internal files\n  // Stack trace format: \"    at FunctionName (file:///path/to/file.ts:line:col)\"\n  // or \"    at file:///path/to/file.ts:line:col\"\n  for (const line of stackLines) {\n    // Match file paths in stack trace (include all JS/TS file extensions)\n    const fileMatch = line.match(\n      /(?:file:\\/\\/)?([^)\\s]+\\.(?:js|ts|mjs|mts|jsx|tsx|cjs|cts))(?::\\d+:\\d+)?/,\n    );\n    if (fileMatch) {\n      const rawPath = fileMatch[1];\n      // Normalize the path:\n      // - remove any leading file:// or file:/// prefix\n      // - convert Windows backslashes to POSIX-style forward slashes\n      const normalizedPath = rawPath\n        .replace(/^file:\\/+/, '')\n        .replace(/\\\\/g, '/');\n      const lowerPath = normalizedPath.toLowerCase();\n\n      // Skip smrt-core internal files using specific path patterns\n      // to avoid false positives with user files containing \"registry\" in name\n      if (\n        // Installed package form: node_modules/@happyvertical/smrt-core/...\n        lowerPath.includes('/node_modules/@happyvertical/smrt-core/') ||\n        // Monorepo/workspace form: packages/core/src/...\n        (lowerPath.includes('/packages/core/src/') &&\n          !lowerPath.includes('__tests__')) ||\n        // Specific manifest loader internals\n        lowerPath.includes('/manifest/manifest-loader')\n      ) {\n        continue;\n      }\n      return normalizedPath;\n    }\n  }\n  return undefined;\n}\n\n// ── Shared state accessor functions ──────────────────────────────────────\n\nexport function getClasses(): Map<string, RegisteredClass> {\n  if (!globalThis.__smrtRegistryClasses) {\n    globalThis.__smrtRegistryClasses = new Map<string, RegisteredClass>();\n  }\n  return globalThis.__smrtRegistryClasses;\n}\n\nexport function getCollections(): Map<string, typeof SmrtCollection> {\n  if (!globalThis.__smrtRegistryCollections) {\n    globalThis.__smrtRegistryCollections = new Map<\n      string,\n      typeof SmrtCollection\n    >();\n  }\n  return globalThis.__smrtRegistryCollections;\n}\n\nexport function getCollectionTableNames(): Map<string, string> {\n  if (!globalThis.__smrtRegistryCollectionTableNames) {\n    globalThis.__smrtRegistryCollectionTableNames = new Map<string, string>();\n  }\n  return globalThis.__smrtRegistryCollectionTableNames;\n}\n\nexport function getCollectionCache(): LRUCache<string, SmrtCollection<any>> {\n  if (!globalThis.__smrtRegistryCollectionCache) {\n    globalThis.__smrtRegistryCollectionCache = new LRUCache<\n      string,\n      SmrtCollection<any>\n    >(100);\n  }\n  return globalThis.__smrtRegistryCollectionCache;\n}\n\nexport function getDbInstanceIds(): WeakMap<object, number> {\n  if (!globalThis.__smrtRegistryDbInstanceIds) {\n    globalThis.__smrtRegistryDbInstanceIds = new WeakMap<object, number>();\n  }\n  return globalThis.__smrtRegistryDbInstanceIds;\n}\n\nexport function getNextDbId(): number {\n  if (globalThis.__smrtRegistryNextDbId === undefined) {\n    globalThis.__smrtRegistryNextDbId = 1;\n  }\n  return globalThis.__smrtRegistryNextDbId;\n}\n\nexport function setNextDbId(value: number): void {\n  globalThis.__smrtRegistryNextDbId = value;\n}\n\nexport function getFieldDecorators(): Map<string, Map<string, any>> {\n  if (!globalThis.__smrtRegistryFieldDecorators) {\n    globalThis.__smrtRegistryFieldDecorators = new Map<\n      string,\n      Map<string, any>\n    >();\n  }\n  return globalThis.__smrtRegistryFieldDecorators;\n}\n\nexport function getStiSiblingsLoaded(): Set<string> {\n  if (!globalThis.__smrtRegistryStiSiblingsLoaded) {\n    globalThis.__smrtRegistryStiSiblingsLoaded = new Set<string>();\n  }\n  return globalThis.__smrtRegistryStiSiblingsLoaded;\n}\n\n// getClassNameMap removed in Release B (#1133). The eagerly-maintained\n// lowercase-simple-name → qualified-key[] index was replaced by on-demand\n// iteration over the `classes` Map in name-resolver.ts. Any remaining\n// consumer should switch to `findClassesByName`, `getCanonicalClassName`,\n// or `findClass`.\n\nexport function getSchemasInitialized(): WeakSet<object> {\n  if (!globalThis.__smrtRegistrySchemasInitialized) {\n    globalThis.__smrtRegistrySchemasInitialized = new WeakSet<object>();\n  }\n  return globalThis.__smrtRegistrySchemasInitialized;\n}\n\nexport function getConstructorIndex(): WeakMap<SmrtObjectConstructor, string> {\n  if (!globalThis.__smrtRegistryConstructorIndex) {\n    globalThis.__smrtRegistryConstructorIndex = new WeakMap<\n      SmrtObjectConstructor,\n      string\n    >();\n  }\n  return globalThis.__smrtRegistryConstructorIndex;\n}\n\nexport function getInheritanceCache(): LRUCache<string, string[]> {\n  if (!globalThis.__smrtRegistryInheritanceChainCache) {\n    const config = getInheritanceConfig();\n    globalThis.__smrtRegistryInheritanceChainCache = new LRUCache<\n      string,\n      string[]\n    >(config.cacheSize);\n  }\n  return globalThis.__smrtRegistryInheritanceChainCache;\n}\n\nexport function getDiscoveryAttemptCache(): Map<string, boolean> {\n  if (!globalThis.__smrtRegistryDiscoveryAttemptCache) {\n    globalThis.__smrtRegistryDiscoveryAttemptCache = new Map<string, boolean>();\n  }\n  return globalThis.__smrtRegistryDiscoveryAttemptCache;\n}\n"],"names":[],"mappings":"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"}