@happyvertical/smrt-core 0.43.2 → 0.43.3

package/dist/manifest/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","names":[],"sources":["../../src/manifest/store.ts"],"sourcesContent":["/**\n * Leaf manifest storage + pure fs/URL helpers.\n *\n * This module has **no dependency on ObjectRegistry, registry.ts, or\n * class-registration.ts**. It owns the globalThis manifest caches and the\n * filesystem helpers that resolve and read manifest.json files from the\n * workspace, installed node_modules, and smrt-core's own bundle.\n *\n * Breaking the cycle: Before this module existed, `registry.ts` and\n * `manifest-loader.ts` both maintained their own copies of these helpers\n * (`registry.ts` had its own because `registerPackageManifest` needed them\n * and could not import `manifest-loader.ts` due to a module cycle —\n * `registry.ts → class-registration.ts → manifest-loader.ts → registry.ts`).\n * Centralizing them here lets both files import from a leaf, so the cycle\n * goes away and Release B's `ManifestSource` abstraction can live above\n * this leaf without re-creating it.\n *\n * @see https://github.com/happyvertical/smrt/issues/1133\n */\n\nimport { createLogger } from '@happyvertical/logger';\nimport { recordRegistryDiagnostic } from '../registry/diagnostics.js';\nimport type {\n  SmartObjectDefinition,\n  SmartObjectManifest,\n} from '../scanner/types.js';\nimport { MANIFEST_TIMESTAMP } from '../scanner/types.js';\nimport type { ColumnDefinition } from '../schema/types.js';\nimport {\n  createQualifiedName,\n  isQualifiedName,\n  parseQualifiedName,\n} from '../utils/qualified-names.js';\n\nconst logger = createLogger({ level: 'info' });\n\nexport type ManifestLoadOptions = {\n  warn?: boolean;\n};\n\n// ── Runtime environment detection ────────────────────────────────────────\n\n/**\n * Detect whether we're running inside a test runner. Test manifests must\n * never load in production to avoid test classes colliding with real ones.\n */\nexport function isTestEnvironment(): boolean {\n  return (\n    process.env.NODE_ENV === 'test' ||\n    process.env.VITEST === 'true' ||\n    process.env.JEST_WORKER_ID !== undefined\n  );\n}\n\n/**\n * Best-effort detection of the current package under test.\n *\n * In workspace consumers, `process.cwd()` points at the consuming app/package,\n * while in smrt-core's own tests it points at `packages/core`. We use that\n * distinction to keep smrt-core's internal test manifest scoped to its own\n * test suite instead of leaking those fixtures into every consumer test run.\n */\nexport function getCurrentPackageName(): string | null {\n  const explicitPackageName = process.env.npm_package_name;\n  if (explicitPackageName) {\n    return explicitPackageName;\n  }\n\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  let currentDir = process.cwd();\n\n  while (true) {\n    const packageJsonPath = builtins.path.join(currentDir, 'package.json');\n    if (builtins.fs.existsSync(packageJsonPath)) {\n      try {\n        const packageJson = JSON.parse(\n          builtins.fs.readFileSync(packageJsonPath, 'utf-8'),\n        ) as { name?: string };\n        return packageJson.name ?? null;\n      } catch {\n        return null;\n      }\n    }\n\n    const parentDir = builtins.path.dirname(currentDir);\n    if (parentDir === currentDir) {\n      return null;\n    }\n\n    currentDir = parentDir;\n  }\n}\n\n/**\n * smrt-core's committed test manifest is for smrt-core's own tests only.\n * Consumer packages should expose only their local test manifest plus real\n * published manifests from dependencies.\n */\nexport function shouldLoadCoreTestManifest(): boolean {\n  if (!isTestEnvironment()) {\n    return false;\n  }\n\n  const currentPackageName = getCurrentPackageName();\n  if (currentPackageName) {\n    return currentPackageName === '@happyvertical/smrt-core';\n  }\n\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return false;\n  }\n\n  const moduleDir = builtins.path.dirname(\n    builtins.url.fileURLToPath(import.meta.url),\n  );\n  const workspaceRoot = findWorkspaceRootSync(moduleDir);\n  if (!workspaceRoot) {\n    return false;\n  }\n\n  const corePackageDir = builtins.path.join(workspaceRoot, 'packages', 'core');\n  const relative = builtins.path.relative(corePackageDir, process.cwd());\n  return (\n    relative === '' ||\n    (!relative.startsWith('..') && !builtins.path.isAbsolute(relative))\n  );\n}\n\n// ── Node builtins access ─────────────────────────────────────────────────\n\n/**\n * Resolve Node's built-in `fs`/`path`/`url` modules without a static import.\n *\n * `process.getBuiltinModule()` is a Node 22+ API that returns the live\n * built-in without going through the module loader. This avoids Vite's\n * static-import analysis flagging these builtins and simulated\n * \"externalized for browser\" warnings in bundled browser builds.\n */\nexport function getNodeBuiltins() {\n  const getBuiltinModule = (\n    process as typeof process & {\n      getBuiltinModule?: (id: string) => unknown;\n    }\n  ).getBuiltinModule;\n  if (typeof getBuiltinModule !== 'function') {\n    return null;\n  }\n\n  const fs = getBuiltinModule('node:fs') as\n    | typeof import('node:fs')\n    | undefined;\n  const path = getBuiltinModule('node:path') as\n    | typeof import('node:path')\n    | undefined;\n  const url = getBuiltinModule('node:url') as\n    | typeof import('node:url')\n    | undefined;\n\n  if (!fs || !path || !url) {\n    return null;\n  }\n\n  return { fs, path, url };\n}\n\n// ── globalThis cache accessors ───────────────────────────────────────────\n\ntype ManifestGlobals = typeof globalThis & {\n  __smrtManifestStatic?: SmartObjectManifest | null;\n  __smrtManifestStaticLoadAttempted?: boolean;\n  __smrtManifestTest?: SmartObjectManifest | null;\n  __smrtManifestLocalTest?: SmartObjectManifest | null;\n  __smrtManifestCache?: Map<string, SmartObjectManifest>;\n};\n\nfunction getManifestGlobals(): ManifestGlobals {\n  return globalThis as ManifestGlobals;\n}\n\n/**\n * Return the mutable external-manifest cache, creating it if absent.\n *\n * Writers: `registerPackageManifest()` (Release A, each package's shim),\n * `loadExternalManifestSyncWithNode()`, `loadManifestFromPathSyncWithNode()`.\n * Readers: all discovery paths.\n */\nexport function getManifestCache(): Map<string, SmartObjectManifest> {\n  const globals = getManifestGlobals();\n  if (!globals.__smrtManifestCache) {\n    globals.__smrtManifestCache = new Map();\n  }\n  return globals.__smrtManifestCache;\n}\n\n/** Read-only snapshot of the static manifest, if cached. */\nexport function getStaticManifestCache(): SmartObjectManifest | null {\n  return getManifestGlobals().__smrtManifestStatic ?? null;\n}\n\n/** Read-only snapshot of the core test manifest, if cached. */\nexport function getTestManifestCache(): SmartObjectManifest | null {\n  return getManifestGlobals().__smrtManifestTest ?? null;\n}\n\n/**\n * Read-only snapshot of the local (domain package) test manifest.\n *\n * Preserves the three-state semantics that `discoverManifestEntry()` relies\n * on: `undefined` means \"never attempted to load\" and triggers the lazy\n * loader; `null` means \"attempted but no local test manifest in this\n * package\"; a manifest object means \"loaded\". Do not collapse `undefined`\n * to `null` here — the async-discovery lazy-load path keys off the\n * distinction (see manifest-loader.ts:`if (getLocalTestManifestCache() === undefined) loadLocalTestManifestSync()`).\n */\nexport function getLocalTestManifestCache():\n  | SmartObjectManifest\n  | null\n  | undefined {\n  return getManifestGlobals().__smrtManifestLocalTest;\n}\n\n// ── Manifest shape helpers ───────────────────────────────────────────────\n\nexport function createEmptyStaticManifest(): SmartObjectManifest {\n  return {\n    version: '1.0.0',\n    timestamp: MANIFEST_TIMESTAMP,\n    objects: {},\n    packageName: '@happyvertical/smrt-core',\n  };\n}\n\n/**\n * Deep-clone a manifest's schema column map so downstream mutators don't\n * corrupt the cached manifest. Foreign-key descriptors get their own copy\n * because manifest-loader.ts and registerFromManifest() both splice them\n * into live schema entries.\n */\nexport function cloneManifestSchemaColumns(\n  columns: Record<string, unknown> | undefined,\n): Record<string, ColumnDefinition> {\n  return Object.fromEntries(\n    Object.entries(columns || {}).map(([columnName, column]) => {\n      const clonedColumn = {\n        ...(column as ColumnDefinition & Record<string, unknown>),\n      } as ColumnDefinition;\n      const manifestDefault = (\n        clonedColumn as ColumnDefinition & {\n          default?: unknown;\n        }\n      ).default;\n\n      if (\n        clonedColumn.defaultValue === undefined &&\n        manifestDefault !== undefined\n      ) {\n        clonedColumn.defaultValue = manifestDefault;\n      }\n\n      if (clonedColumn.foreignKey) {\n        clonedColumn.foreignKey = { ...clonedColumn.foreignKey };\n      }\n\n      return [columnName, clonedColumn];\n    }),\n  ) as Record<string, ColumnDefinition>;\n}\n\n/**\n * Look up a class definition inside a single manifest.\n *\n * Tries qualified-key, simple-name, and lowercase-name lookups, then falls\n * back to iterating every entry in the manifest comparing lowered names.\n * This is the low-level primitive used by every sync discovery path.\n */\nexport function lookupCachedManifestEntry(\n  manifest: SmartObjectManifest | null | undefined,\n  className: string,\n): SmartObjectDefinition | undefined {\n  if (!manifest?.objects) {\n    return undefined;\n  }\n\n  const requestedQualifiedName = isQualifiedName(className)\n    ? className\n    : undefined;\n  const requestedClassName = requestedQualifiedName\n    ? parseQualifiedName(requestedQualifiedName).className\n    : className;\n  const lowerClassName = requestedClassName.toLowerCase();\n  const packageName = manifest.packageName;\n  const qualifiedKey =\n    requestedQualifiedName ||\n    (packageName\n      ? createQualifiedName(packageName, requestedClassName)\n      : undefined);\n\n  return (\n    (qualifiedKey ? manifest.objects[qualifiedKey] : undefined) ||\n    manifest.objects[requestedClassName] ||\n    manifest.objects[lowerClassName] ||\n    Object.values(manifest.objects).find((entry) => {\n      if (!entry) {\n        return false;\n      }\n\n      if (entry.className?.toLowerCase() === lowerClassName) {\n        return true;\n      }\n\n      return (\n        requestedQualifiedName !== undefined &&\n        packageName !== undefined &&\n        createQualifiedName(packageName, entry.className || '') ===\n          requestedQualifiedName\n      );\n    })\n  );\n}\n\n// ── Filesystem helpers ───────────────────────────────────────────────────\n\nexport function findWorkspaceRootSync(startDir: string): string | null {\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  let currentDir = startDir;\n\n  while (true) {\n    if (\n      builtins.fs.existsSync(\n        builtins.path.join(currentDir, 'pnpm-workspace.yaml'),\n      )\n    ) {\n      return currentDir;\n    }\n\n    const parentDir = builtins.path.dirname(currentDir);\n    if (parentDir === currentDir) {\n      return null;\n    }\n\n    currentDir = parentDir;\n  }\n}\n\nexport function resolveInstalledPackageJsonPathSync(\n  packageName: string,\n): string | null {\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  let currentDir = process.cwd();\n\n  while (true) {\n    const packageJsonPath = builtins.path.join(\n      currentDir,\n      'node_modules',\n      packageName,\n      'package.json',\n    );\n\n    if (builtins.fs.existsSync(packageJsonPath)) {\n      return packageJsonPath;\n    }\n\n    const parentDir = builtins.path.dirname(currentDir);\n    if (parentDir === currentDir) {\n      return null;\n    }\n\n    currentDir = parentDir;\n  }\n}\n\nexport function resolveWorkspacePackageJsonPathSync(\n  packageName: string,\n): string | null {\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  const workspaceRoot = findWorkspaceRootSync(process.cwd());\n  if (!workspaceRoot) {\n    return null;\n  }\n\n  const workspacePackagesDir = builtins.path.join(workspaceRoot, 'packages');\n  if (!builtins.fs.existsSync(workspacePackagesDir)) {\n    return null;\n  }\n\n  for (const packageDirName of builtins.fs.readdirSync(workspacePackagesDir)) {\n    const packageJsonPath = builtins.path.join(\n      workspacePackagesDir,\n      packageDirName,\n      'package.json',\n    );\n    if (!builtins.fs.existsSync(packageJsonPath)) {\n      continue;\n    }\n\n    try {\n      const packageJson = JSON.parse(\n        builtins.fs.readFileSync(packageJsonPath, 'utf-8'),\n      ) as { name?: string };\n      if (packageJson.name === packageName) {\n        return packageJsonPath;\n      }\n    } catch {\n      // Ignore unreadable workspace package metadata and continue scanning.\n    }\n  }\n\n  return null;\n}\n\nexport function resolveWorkspaceSourceManifestPathSync(\n  packageDir: string,\n): string | null {\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  const candidates = [\n    builtins.path.join(packageDir, 'src', 'manifest', 'manifest.json'),\n    builtins.path.join(packageDir, '.smrt', 'manifest.json'),\n  ];\n\n  for (const candidate of candidates) {\n    if (builtins.fs.existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  return null;\n}\n\nexport function resolveManifestExportPathSync(\n  packageName: string,\n  options: ManifestLoadOptions = {},\n): string | null {\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  const shouldWarn = options.warn ?? true;\n  const packageJsonPath =\n    resolveInstalledPackageJsonPathSync(packageName) ||\n    resolveWorkspacePackageJsonPathSync(packageName);\n\n  if (!packageJsonPath) {\n    return null;\n  }\n\n  const packageDir = builtins.path.dirname(packageJsonPath);\n  const packageJson = JSON.parse(\n    builtins.fs.readFileSync(packageJsonPath, 'utf-8'),\n  ) as {\n    exports?: Record<\n      string,\n      string | { default?: string; import?: string; require?: string }\n    >;\n  };\n  const manifestExports = ['./manifest.json', './manifest'];\n\n  for (const exportKey of manifestExports) {\n    const manifestExport = packageJson.exports?.[exportKey];\n    if (!manifestExport) {\n      continue;\n    }\n\n    const manifestRelativePath =\n      typeof manifestExport === 'string'\n        ? manifestExport\n        : manifestExport.import ||\n          manifestExport.default ||\n          manifestExport.require;\n\n    if (!manifestRelativePath) {\n      recordRegistryDiagnostic(\n        'error',\n        'MANIFEST_EXPORT_INVALID',\n        `Package ${packageName} has invalid manifest export configuration for ${exportKey}`,\n        { packageName, exportKey },\n      );\n      if (shouldWarn) {\n        logger.warn(\n          `Package ${packageName} has invalid manifest export configuration for ${exportKey}`,\n        );\n      }\n      return null;\n    }\n\n    if (!manifestRelativePath.endsWith('.json')) {\n      recordRegistryDiagnostic(\n        'error',\n        'MANIFEST_EXPORT_NOT_JSON',\n        `Package ${packageName} must export a JSON manifest for ${exportKey}, received ${manifestRelativePath}`,\n        { packageName, exportKey, manifestRelativePath },\n      );\n      if (shouldWarn) {\n        logger.warn(\n          `Package ${packageName} must export a JSON manifest for ${exportKey}, received ${manifestRelativePath}`,\n        );\n      }\n      return null;\n    }\n\n    const manifestPath = builtins.path.join(packageDir, manifestRelativePath);\n    if (builtins.fs.existsSync(manifestPath)) {\n      return manifestPath;\n    }\n\n    const workspaceSourceManifest =\n      resolveWorkspaceSourceManifestPathSync(packageDir);\n    if (workspaceSourceManifest) {\n      return workspaceSourceManifest;\n    }\n\n    recordRegistryDiagnostic(\n      'error',\n      'MANIFEST_EXPORT_NOT_FOUND',\n      `Package ${packageName} declares manifest export ${manifestRelativePath}, but no manifest file was found.`,\n      { packageName, exportKey, manifestRelativePath },\n    );\n    if (shouldWarn) {\n      logger.warn(\n        `Package ${packageName} declares manifest export ${manifestRelativePath}, but no manifest file was found.`,\n      );\n    }\n    return null;\n  }\n\n  return null;\n}\n\n// ── Manifest reading (seeds caches) ──────────────────────────────────────\n\n/**\n * Load smrt-core's own bundled manifest from disk, caching in\n * `__smrtManifestStatic`. Resolves against this module's own `import.meta.url`\n * so paths work whether the code is running from `dist/` or `src/`.\n */\nexport function loadStaticManifestSyncWithNode(): SmartObjectManifest | null {\n  const globals = getManifestGlobals();\n\n  if (globals.__smrtManifestStatic !== undefined) {\n    return globals.__smrtManifestStatic ?? null;\n  }\n\n  const builtins = getNodeBuiltins();\n  globals.__smrtManifestStaticLoadAttempted = true;\n  if (!builtins) {\n    const fallbackManifest = createEmptyStaticManifest();\n    globals.__smrtManifestStatic = fallbackManifest;\n    return fallbackManifest;\n  }\n\n  // store.ts lives at src/manifest/store.ts (source) → dist/manifest/store.js\n  // (compiled). In src, the static manifest is a sibling JSON; in dist, it is\n  // the package's dist/manifest.json one level up.\n  const candidates = import.meta.url.endsWith('.ts')\n    ? [\n        new URL('./static-manifest.json', import.meta.url),\n        new URL('../../dist/manifest.json', import.meta.url),\n      ]\n    : [new URL('../manifest.json', import.meta.url)];\n\n  for (const candidate of candidates) {\n    try {\n      if (!builtins.fs.existsSync(candidate)) {\n        continue;\n      }\n\n      const manifest = JSON.parse(\n        builtins.fs.readFileSync(candidate, 'utf-8'),\n      ) as SmartObjectManifest;\n\n      if (!manifest.objects || typeof manifest.objects !== 'object') {\n        continue;\n      }\n\n      const cachedManifest = manifest.packageName\n        ? manifest\n        : { ...manifest, packageName: '@happyvertical/smrt-core' };\n      globals.__smrtManifestStatic = cachedManifest;\n      return cachedManifest;\n    } catch {\n      // Try the next candidate and fall back to the empty manifest if needed.\n    }\n  }\n\n  const fallbackManifest = createEmptyStaticManifest();\n  globals.__smrtManifestStatic = fallbackManifest;\n  return fallbackManifest;\n}\n\n/**\n * Load a package's published manifest by package name, caching in\n * `__smrtManifestCache` under the package key. Returns null on miss or\n * invalid shape; records a diagnostic instead of throwing.\n */\nexport function loadExternalManifestSyncWithNode(\n  packageName: string,\n  options: ManifestLoadOptions = {},\n): SmartObjectManifest | null {\n  const cache = getManifestCache();\n\n  if (cache.has(packageName)) {\n    return cache.get(packageName) || null;\n  }\n\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  const manifestPath = resolveManifestExportPathSync(packageName, options);\n  if (!manifestPath) {\n    return null;\n  }\n\n  try {\n    const manifest = JSON.parse(\n      builtins.fs.readFileSync(manifestPath, 'utf-8'),\n    ) as SmartObjectManifest;\n\n    if (!manifest.objects || typeof manifest.objects !== 'object') {\n      if (options.warn ?? true) {\n        logger.warn(`Invalid manifest structure for package ${packageName}`);\n      }\n      return null;\n    }\n\n    const cachedManifest = manifest.packageName\n      ? manifest\n      : { ...manifest, packageName };\n\n    cache.set(packageName, cachedManifest);\n\n    return cachedManifest;\n  } catch (error) {\n    if (options.warn ?? true) {\n      logger.warn(\n        `Failed to load manifest for package ${packageName}: ${error instanceof Error ? error.message : error}`,\n      );\n    }\n    return null;\n  }\n}\n\n/**\n * Load a manifest from an explicit filesystem path, caching in\n * `__smrtManifestCache` under the manifest's packageName (or the path as a\n * fallback key). Used by `loadAllManifests({ manifestPaths })` in registry.ts\n * and by the Release B `ExplicitPathsManifestSource`.\n */\nexport function loadManifestFromPathSyncWithNode(\n  manifestPath: string,\n): SmartObjectManifest | null {\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  try {\n    const manifest = JSON.parse(\n      builtins.fs.readFileSync(manifestPath, 'utf-8'),\n    ) as SmartObjectManifest;\n\n    if (!manifest.objects || typeof manifest.objects !== 'object') {\n      logger.warn(`Invalid manifest structure at ${manifestPath}`);\n      return null;\n    }\n\n    getManifestCache().set(manifest.packageName || manifestPath, manifest);\n\n    return manifest;\n  } catch (error) {\n    logger.warn(\n      `Failed to load manifest from path ${manifestPath}: ${error instanceof Error ? error.message : error}`,\n    );\n    return null;\n  }\n}\n\n/**\n * Synchronous lookup across every cached manifest source, in priority order.\n *\n * Matches the historical order from manifest-loader.ts and registry.ts:\n * local test → core test → static (smrt-core bundled) → external cache.\n * The Release B `CompositeManifestSource` wraps the same priority behind a\n * higher-level abstraction.\n */\nexport function discoverCachedManifestSync(\n  className: string,\n): SmartObjectDefinition | undefined {\n  const manifests: Array<SmartObjectManifest | null | undefined> = [\n    getLocalTestManifestCache(),\n    getTestManifestCache(),\n    loadStaticManifestSyncWithNode(),\n    ...getManifestCache().values(),\n  ];\n\n  for (const manifest of manifests) {\n    const entry = lookupCachedManifestEntry(manifest, className);\n    if (entry) {\n      return entry;\n    }\n  }\n\n  return undefined;\n}\n"],"mappings":"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"}
+{"version":3,"file":"store.js","names":[],"sources":["../../src/manifest/store.ts"],"sourcesContent":["/**\n * Leaf manifest storage + pure fs/URL helpers.\n *\n * This module has **no dependency on ObjectRegistry, registry.ts, or\n * class-registration.ts**. It owns the globalThis manifest caches and the\n * filesystem helpers that resolve and read manifest.json files from the\n * workspace, installed node_modules, and smrt-core's own bundle.\n *\n * Breaking the cycle: Before this module existed, `registry.ts` and\n * `manifest-loader.ts` both maintained their own copies of these helpers\n * (`registry.ts` had its own because `registerPackageManifest` needed them\n * and could not import `manifest-loader.ts` due to a module cycle —\n * `registry.ts → class-registration.ts → manifest-loader.ts → registry.ts`).\n * Centralizing them here lets both files import from a leaf, so the cycle\n * goes away and Release B's `ManifestSource` abstraction can live above\n * this leaf without re-creating it.\n *\n * @see https://github.com/happyvertical/smrt/issues/1133\n */\n\nimport { createLogger } from '@happyvertical/logger';\nimport { recordRegistryDiagnostic } from '../registry/diagnostics.js';\nimport type {\n  SmartObjectDefinition,\n  SmartObjectManifest,\n} from '../scanner/types.js';\nimport { MANIFEST_TIMESTAMP } from '../scanner/types.js';\nimport type { ColumnDefinition } from '../schema/types.js';\nimport {\n  createQualifiedName,\n  isQualifiedName,\n  parseQualifiedName,\n} from '../utils/qualified-names.js';\n\nconst logger = createLogger({ level: 'info' });\n\nexport type ManifestLoadOptions = {\n  warn?: boolean;\n};\n\n// ── Runtime environment detection ────────────────────────────────────────\n\n/**\n * Detect whether we're running inside a test runner. Test manifests must\n * never load in production to avoid test classes colliding with real ones.\n */\nexport function isTestEnvironment(): boolean {\n  return (\n    process.env.NODE_ENV === 'test' ||\n    process.env.VITEST === 'true' ||\n    process.env.JEST_WORKER_ID !== undefined\n  );\n}\n\n/**\n * Best-effort detection of the current package under test.\n *\n * In workspace consumers, `process.cwd()` points at the consuming app/package,\n * while in smrt-core's own tests it points at `packages/core`. We use that\n * distinction to keep smrt-core's internal test manifest scoped to its own\n * test suite instead of leaking those fixtures into every consumer test run.\n */\nexport function getCurrentPackageName(): string | null {\n  const explicitPackageName = process.env.npm_package_name;\n  if (explicitPackageName) {\n    return explicitPackageName;\n  }\n\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  let currentDir = process.cwd();\n\n  while (true) {\n    const packageJsonPath = builtins.path.join(currentDir, 'package.json');\n    if (builtins.fs.existsSync(packageJsonPath)) {\n      try {\n        const packageJson = JSON.parse(\n          builtins.fs.readFileSync(packageJsonPath, 'utf-8'),\n        ) as { name?: string };\n        return packageJson.name ?? null;\n      } catch {\n        return null;\n      }\n    }\n\n    const parentDir = builtins.path.dirname(currentDir);\n    if (parentDir === currentDir) {\n      return null;\n    }\n\n    currentDir = parentDir;\n  }\n}\n\n/**\n * smrt-core's committed test manifest is for smrt-core's own tests only.\n * Consumer packages should expose only their local test manifest plus real\n * published manifests from dependencies.\n */\nexport function shouldLoadCoreTestManifest(): boolean {\n  if (!isTestEnvironment()) {\n    return false;\n  }\n\n  const currentPackageName = getCurrentPackageName();\n  if (currentPackageName) {\n    return currentPackageName === '@happyvertical/smrt-core';\n  }\n\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return false;\n  }\n\n  const moduleDir = builtins.path.dirname(\n    builtins.url.fileURLToPath(import.meta.url),\n  );\n  const workspaceRoot = findWorkspaceRootSync(moduleDir);\n  if (!workspaceRoot) {\n    return false;\n  }\n\n  const corePackageDir = builtins.path.join(workspaceRoot, 'packages', 'core');\n  const relative = builtins.path.relative(corePackageDir, process.cwd());\n  return (\n    relative === '' ||\n    (!relative.startsWith('..') && !builtins.path.isAbsolute(relative))\n  );\n}\n\n// ── Node builtins access ─────────────────────────────────────────────────\n\n/**\n * Resolve Node's built-in `fs`/`path`/`url` modules without a static import.\n *\n * `process.getBuiltinModule()` is a Node 22+ API that returns the live\n * built-in without going through the module loader. This avoids Vite's\n * static-import analysis flagging these builtins and simulated\n * \"externalized for browser\" warnings in bundled browser builds.\n */\nexport function getNodeBuiltins() {\n  const getBuiltinModule = (\n    process as typeof process & {\n      getBuiltinModule?: (id: string) => unknown;\n    }\n  ).getBuiltinModule;\n  if (typeof getBuiltinModule !== 'function') {\n    return null;\n  }\n\n  const fs = getBuiltinModule('node:fs') as\n    | typeof import('node:fs')\n    | undefined;\n  const path = getBuiltinModule('node:path') as\n    | typeof import('node:path')\n    | undefined;\n  const url = getBuiltinModule('node:url') as\n    | typeof import('node:url')\n    | undefined;\n\n  if (!fs || !path || !url) {\n    return null;\n  }\n\n  return { fs, path, url };\n}\n\n// ── globalThis cache accessors ───────────────────────────────────────────\n\ntype ManifestGlobals = typeof globalThis & {\n  __smrtManifestStatic?: SmartObjectManifest | null;\n  __smrtManifestStaticLoadAttempted?: boolean;\n  __smrtManifestTest?: SmartObjectManifest | null;\n  __smrtManifestLocalTest?: SmartObjectManifest | null;\n  __smrtManifestCache?: Map<string, SmartObjectManifest>;\n};\n\nfunction getManifestGlobals(): ManifestGlobals {\n  return globalThis as ManifestGlobals;\n}\n\n/**\n * Return the mutable external-manifest cache, creating it if absent.\n *\n * Writers: `registerPackageManifest()` (Release A, each package's shim),\n * `loadExternalManifestSyncWithNode()`, `loadManifestFromPathSyncWithNode()`.\n * Readers: all discovery paths.\n */\nexport function getManifestCache(): Map<string, SmartObjectManifest> {\n  const globals = getManifestGlobals();\n  if (!globals.__smrtManifestCache) {\n    globals.__smrtManifestCache = new Map();\n  }\n  return globals.__smrtManifestCache;\n}\n\n/** Read-only snapshot of the static manifest, if cached. */\nexport function getStaticManifestCache(): SmartObjectManifest | null {\n  return getManifestGlobals().__smrtManifestStatic ?? null;\n}\n\n/** Read-only snapshot of the core test manifest, if cached. */\nexport function getTestManifestCache(): SmartObjectManifest | null {\n  return getManifestGlobals().__smrtManifestTest ?? null;\n}\n\n/**\n * Read-only snapshot of the local (domain package) test manifest.\n *\n * Preserves the three-state semantics that `discoverManifestEntry()` relies\n * on: `undefined` means \"never attempted to load\" and triggers the lazy\n * loader; `null` means \"attempted but no local test manifest in this\n * package\"; a manifest object means \"loaded\". Do not collapse `undefined`\n * to `null` here — the async-discovery lazy-load path keys off the\n * distinction (see manifest-loader.ts:`if (getLocalTestManifestCache() === undefined) loadLocalTestManifestSync()`).\n */\nexport function getLocalTestManifestCache():\n  | SmartObjectManifest\n  | null\n  | undefined {\n  return getManifestGlobals().__smrtManifestLocalTest;\n}\n\n// ── Manifest shape helpers ───────────────────────────────────────────────\n\nexport function createEmptyStaticManifest(): SmartObjectManifest {\n  return {\n    version: '1.0.0',\n    timestamp: MANIFEST_TIMESTAMP,\n    objects: {},\n    packageName: '@happyvertical/smrt-core',\n  };\n}\n\n/**\n * Deep-clone a manifest's schema column map so downstream mutators don't\n * corrupt the cached manifest. Foreign-key descriptors get their own copy\n * because manifest-loader.ts and registerFromManifest() both splice them\n * into live schema entries.\n */\nexport function cloneManifestSchemaColumns(\n  columns: Record<string, unknown> | undefined,\n): Record<string, ColumnDefinition> {\n  return Object.fromEntries(\n    Object.entries(columns || {}).map(([columnName, column]) => {\n      const clonedColumn = {\n        ...(column as ColumnDefinition & Record<string, unknown>),\n      } as ColumnDefinition;\n      const manifestDefault = (\n        clonedColumn as ColumnDefinition & {\n          default?: unknown;\n        }\n      ).default;\n\n      if (\n        clonedColumn.defaultValue === undefined &&\n        manifestDefault !== undefined\n      ) {\n        clonedColumn.defaultValue = manifestDefault;\n      }\n\n      if (clonedColumn.foreignKey) {\n        clonedColumn.foreignKey = { ...clonedColumn.foreignKey };\n      }\n\n      return [columnName, clonedColumn];\n    }),\n  ) as Record<string, ColumnDefinition>;\n}\n\n/**\n * Look up a class definition inside a single manifest.\n *\n * Tries qualified-key, simple-name, and lowercase-name lookups, then falls\n * back to iterating every entry in the manifest comparing lowered names.\n * This is the low-level primitive used by every sync discovery path.\n */\nexport function lookupCachedManifestEntry(\n  manifest: SmartObjectManifest | null | undefined,\n  className: string,\n): SmartObjectDefinition | undefined {\n  if (!manifest?.objects) {\n    return undefined;\n  }\n\n  const requestedQualifiedName = isQualifiedName(className)\n    ? className\n    : undefined;\n  const requestedClassName = requestedQualifiedName\n    ? parseQualifiedName(requestedQualifiedName).className\n    : className;\n  const lowerClassName = requestedClassName.toLowerCase();\n  const packageName = manifest.packageName;\n  const qualifiedKey =\n    requestedQualifiedName ||\n    (packageName\n      ? createQualifiedName(packageName, requestedClassName)\n      : undefined);\n\n  return (\n    (qualifiedKey ? manifest.objects[qualifiedKey] : undefined) ||\n    manifest.objects[requestedClassName] ||\n    manifest.objects[lowerClassName] ||\n    Object.values(manifest.objects).find((entry) => {\n      if (!entry) {\n        return false;\n      }\n\n      if (entry.className?.toLowerCase() === lowerClassName) {\n        return true;\n      }\n\n      return (\n        requestedQualifiedName !== undefined &&\n        packageName !== undefined &&\n        createQualifiedName(packageName, entry.className || '') ===\n          requestedQualifiedName\n      );\n    })\n  );\n}\n\n// ── Filesystem helpers ───────────────────────────────────────────────────\n\nexport function findWorkspaceRootSync(startDir: string): string | null {\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  let currentDir = startDir;\n\n  while (true) {\n    if (\n      builtins.fs.existsSync(\n        builtins.path.join(currentDir, 'pnpm-workspace.yaml'),\n      )\n    ) {\n      return currentDir;\n    }\n\n    const parentDir = builtins.path.dirname(currentDir);\n    if (parentDir === currentDir) {\n      return null;\n    }\n\n    currentDir = parentDir;\n  }\n}\n\nexport function resolveInstalledPackageJsonPathSync(\n  packageName: string,\n): string | null {\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  let currentDir = process.cwd();\n\n  while (true) {\n    const packageJsonPath = builtins.path.join(\n      currentDir,\n      'node_modules',\n      packageName,\n      'package.json',\n    );\n\n    if (builtins.fs.existsSync(packageJsonPath)) {\n      return packageJsonPath;\n    }\n\n    const parentDir = builtins.path.dirname(currentDir);\n    if (parentDir === currentDir) {\n      return null;\n    }\n\n    currentDir = parentDir;\n  }\n}\n\nexport function resolveWorkspacePackageJsonPathSync(\n  packageName: string,\n): string | null {\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  const workspaceRoot = findWorkspaceRootSync(process.cwd());\n  if (!workspaceRoot) {\n    return null;\n  }\n\n  const workspacePackagesDir = builtins.path.join(workspaceRoot, 'packages');\n  if (!builtins.fs.existsSync(workspacePackagesDir)) {\n    return null;\n  }\n\n  for (const packageDirName of builtins.fs.readdirSync(workspacePackagesDir)) {\n    const packageJsonPath = builtins.path.join(\n      workspacePackagesDir,\n      packageDirName,\n      'package.json',\n    );\n    if (!builtins.fs.existsSync(packageJsonPath)) {\n      continue;\n    }\n\n    try {\n      const packageJson = JSON.parse(\n        builtins.fs.readFileSync(packageJsonPath, 'utf-8'),\n      ) as { name?: string };\n      if (packageJson.name === packageName) {\n        return packageJsonPath;\n      }\n    } catch {\n      // Ignore unreadable workspace package metadata and continue scanning.\n    }\n  }\n\n  return null;\n}\n\nexport function resolveWorkspaceSourceManifestPathSync(\n  packageDir: string,\n): string | null {\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  const candidates = [\n    builtins.path.join(packageDir, 'src', 'manifest', 'manifest.json'),\n    builtins.path.join(packageDir, '.smrt', 'manifest.json'),\n  ];\n\n  for (const candidate of candidates) {\n    if (builtins.fs.existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  return null;\n}\n\nexport function resolveManifestExportPathSync(\n  packageName: string,\n  options: ManifestLoadOptions = {},\n): string | null {\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  const shouldWarn = options.warn ?? true;\n  const packageJsonPath =\n    resolveInstalledPackageJsonPathSync(packageName) ||\n    resolveWorkspacePackageJsonPathSync(packageName);\n\n  if (!packageJsonPath) {\n    return null;\n  }\n\n  const packageDir = builtins.path.dirname(packageJsonPath);\n  const packageJson = JSON.parse(\n    builtins.fs.readFileSync(packageJsonPath, 'utf-8'),\n  ) as {\n    exports?: Record<\n      string,\n      string | { default?: string; import?: string; require?: string }\n    >;\n  };\n  const manifestExports = ['./manifest.json', './manifest'];\n\n  for (const exportKey of manifestExports) {\n    const manifestExport = packageJson.exports?.[exportKey];\n    if (!manifestExport) {\n      continue;\n    }\n\n    const manifestRelativePath =\n      typeof manifestExport === 'string'\n        ? manifestExport\n        : manifestExport.import ||\n          manifestExport.default ||\n          manifestExport.require;\n\n    if (!manifestRelativePath) {\n      recordRegistryDiagnostic(\n        'error',\n        'MANIFEST_EXPORT_INVALID',\n        `Package ${packageName} has invalid manifest export configuration for ${exportKey}`,\n        { packageName, exportKey },\n      );\n      if (shouldWarn) {\n        logger.warn(\n          `Package ${packageName} has invalid manifest export configuration for ${exportKey}`,\n        );\n      }\n      return null;\n    }\n\n    if (!manifestRelativePath.endsWith('.json')) {\n      recordRegistryDiagnostic(\n        'error',\n        'MANIFEST_EXPORT_NOT_JSON',\n        `Package ${packageName} must export a JSON manifest for ${exportKey}, received ${manifestRelativePath}`,\n        { packageName, exportKey, manifestRelativePath },\n      );\n      if (shouldWarn) {\n        logger.warn(\n          `Package ${packageName} must export a JSON manifest for ${exportKey}, received ${manifestRelativePath}`,\n        );\n      }\n      return null;\n    }\n\n    const manifestPath = builtins.path.join(packageDir, manifestRelativePath);\n    if (builtins.fs.existsSync(manifestPath)) {\n      return manifestPath;\n    }\n\n    const workspaceSourceManifest =\n      resolveWorkspaceSourceManifestPathSync(packageDir);\n    if (workspaceSourceManifest) {\n      return workspaceSourceManifest;\n    }\n\n    recordRegistryDiagnostic(\n      'error',\n      'MANIFEST_EXPORT_NOT_FOUND',\n      `Package ${packageName} declares manifest export ${manifestRelativePath}, but no manifest file was found.`,\n      { packageName, exportKey, manifestRelativePath },\n    );\n    if (shouldWarn) {\n      logger.warn(\n        `Package ${packageName} declares manifest export ${manifestRelativePath}, but no manifest file was found.`,\n      );\n    }\n    return null;\n  }\n\n  return null;\n}\n\n// ── Manifest reading (seeds caches) ──────────────────────────────────────\n\n/**\n * Load smrt-core's own bundled manifest from disk, caching in\n * `__smrtManifestStatic`. Resolves against this module's own `import.meta.url`\n * so paths work whether the code is running from `dist/` or `src/`.\n */\nexport function loadStaticManifestSyncWithNode(): SmartObjectManifest | null {\n  const globals = getManifestGlobals();\n\n  if (globals.__smrtManifestStatic !== undefined) {\n    return globals.__smrtManifestStatic ?? null;\n  }\n\n  const builtins = getNodeBuiltins();\n  globals.__smrtManifestStaticLoadAttempted = true;\n  if (!builtins) {\n    const fallbackManifest = createEmptyStaticManifest();\n    globals.__smrtManifestStatic = fallbackManifest;\n    return fallbackManifest;\n  }\n\n  // store.ts lives at src/manifest/store.ts (source) → dist/manifest/store.js\n  // (compiled). In src, the static manifest is a sibling JSON; in dist, it is\n  // the package's dist/manifest.json one level up.\n  const candidates = import.meta.url.endsWith('.ts')\n    ? [\n        new URL('./static-manifest.json', import.meta.url),\n        new URL('../../dist/manifest.json', import.meta.url),\n      ]\n    : [new URL('../manifest.json', import.meta.url)];\n\n  for (const candidate of candidates) {\n    try {\n      if (!builtins.fs.existsSync(candidate)) {\n        continue;\n      }\n\n      const manifest = JSON.parse(\n        builtins.fs.readFileSync(candidate, 'utf-8'),\n      ) as SmartObjectManifest;\n\n      if (!manifest.objects || typeof manifest.objects !== 'object') {\n        continue;\n      }\n\n      const cachedManifest = manifest.packageName\n        ? manifest\n        : { ...manifest, packageName: '@happyvertical/smrt-core' };\n      globals.__smrtManifestStatic = cachedManifest;\n      return cachedManifest;\n    } catch {\n      // Try the next candidate and fall back to the empty manifest if needed.\n    }\n  }\n\n  const fallbackManifest = createEmptyStaticManifest();\n  globals.__smrtManifestStatic = fallbackManifest;\n  return fallbackManifest;\n}\n\n/**\n * Load a package's published manifest by package name, caching in\n * `__smrtManifestCache` under the package key. Returns null on miss or\n * invalid shape; records a diagnostic instead of throwing.\n */\nexport function loadExternalManifestSyncWithNode(\n  packageName: string,\n  options: ManifestLoadOptions = {},\n): SmartObjectManifest | null {\n  const cache = getManifestCache();\n\n  if (cache.has(packageName)) {\n    return cache.get(packageName) || null;\n  }\n\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  const manifestPath = resolveManifestExportPathSync(packageName, options);\n  if (!manifestPath) {\n    return null;\n  }\n\n  try {\n    const manifest = JSON.parse(\n      builtins.fs.readFileSync(manifestPath, 'utf-8'),\n    ) as SmartObjectManifest;\n\n    if (!manifest.objects || typeof manifest.objects !== 'object') {\n      if (options.warn ?? true) {\n        logger.warn(`Invalid manifest structure for package ${packageName}`);\n      }\n      return null;\n    }\n\n    const cachedManifest = manifest.packageName\n      ? manifest\n      : { ...manifest, packageName };\n\n    cache.set(packageName, cachedManifest);\n\n    return cachedManifest;\n  } catch (error) {\n    if (options.warn ?? true) {\n      logger.warn(\n        `Failed to load manifest for package ${packageName}: ${error instanceof Error ? error.message : error}`,\n      );\n    }\n    return null;\n  }\n}\n\n/**\n * Load a manifest from an explicit filesystem path, caching in\n * `__smrtManifestCache` under the manifest's packageName (or the path as a\n * fallback key). Used by `loadAllManifests({ manifestPaths })` in registry.ts\n * and by the Release B `ExplicitPathsManifestSource`.\n */\nexport function loadManifestFromPathSyncWithNode(\n  manifestPath: string,\n): SmartObjectManifest | null {\n  const builtins = getNodeBuiltins();\n  if (!builtins) {\n    return null;\n  }\n\n  try {\n    const manifest = JSON.parse(\n      builtins.fs.readFileSync(manifestPath, 'utf-8'),\n    ) as SmartObjectManifest;\n\n    if (!manifest.objects || typeof manifest.objects !== 'object') {\n      logger.warn(`Invalid manifest structure at ${manifestPath}`);\n      return null;\n    }\n\n    getManifestCache().set(manifest.packageName || manifestPath, manifest);\n\n    return manifest;\n  } catch (error) {\n    logger.warn(\n      `Failed to load manifest from path ${manifestPath}: ${error instanceof Error ? error.message : error}`,\n    );\n    return null;\n  }\n}\n\n/**\n * Synchronous lookup across every cached manifest source, in priority order.\n *\n * Matches the historical order from manifest-loader.ts and registry.ts:\n * local test → core test → static (smrt-core bundled) → external cache.\n * The Release B `CompositeManifestSource` wraps the same priority behind a\n * higher-level abstraction.\n */\nexport function discoverCachedManifestSync(\n  className: string,\n): SmartObjectDefinition | undefined {\n  const manifests: Array<SmartObjectManifest | null | undefined> = [\n    getLocalTestManifestCache(),\n    getTestManifestCache(),\n    loadStaticManifestSyncWithNode(),\n    ...getManifestCache().values(),\n  ];\n\n  for (const manifest of manifests) {\n    const entry = lookupCachedManifestEntry(manifest, className);\n    if (entry) {\n      return entry;\n    }\n  }\n\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAkCA,IAAM,SAAS,aAAa,EAAE,OAAO,OAAO,CAAC;;;;;AAY7C,SAAgB,oBAA6B;CAC3C,OAAA,QAAA,IAAA,aAC2B,UACzB,QAAQ,IAAI,WAAW,UACvB,QAAQ,IAAI,mBAAmB,KAAA;AAEnC;;;;;;;;;AAUA,SAAgB,wBAAuC;CACrD,MAAM,sBAAsB,QAAQ,IAAI;CACxC,IAAI,qBACF,OAAO;CAGT,MAAM,WAAW,gBAAgB;CACjC,IAAI,CAAC,UACH,OAAO;CAGT,IAAI,aAAa,QAAQ,IAAI;CAE7B,OAAO,MAAM;EACX,MAAM,kBAAkB,SAAS,KAAK,KAAK,YAAY,cAAc;EACrE,IAAI,SAAS,GAAG,WAAW,eAAe,GACxC,IAAI;GAIF,OAHoB,KAAK,MACvB,SAAS,GAAG,aAAa,iBAAiB,OAAO,CAE5C,CAAA,CAAY,QAAQ;EAC7B,QAAQ;GACN,OAAO;EACT;EAGF,MAAM,YAAY,SAAS,KAAK,QAAQ,UAAU;EAClD,IAAI,cAAc,YAChB,OAAO;EAGT,aAAa;CACf;AACF;;;;;;AAOA,SAAgB,6BAAsC;CACpD,IAAI,CAAC,kBAAkB,GACrB,OAAO;CAGT,MAAM,qBAAqB,sBAAsB;CACjD,IAAI,oBACF,OAAO,uBAAuB;CAGhC,MAAM,WAAW,gBAAgB;CACjC,IAAI,CAAC,UACH,OAAO;CAMT,MAAM,gBAAgB,sBAHJ,SAAS,KAAK,QAC9B,SAAS,IAAI,cAAc,OAAO,KAAK,GAAG,CAEA,CAAS;CACrD,IAAI,CAAC,eACH,OAAO;CAGT,MAAM,iBAAiB,SAAS,KAAK,KAAK,eAAe,YAAY,MAAM;CAC3E,MAAM,WAAW,SAAS,KAAK,SAAS,gBAAgB,QAAQ,IAAI,CAAC;CACrE,OACE,aAAa,MACZ,CAAC,SAAS,WAAW,IAAI,KAAK,CAAC,SAAS,KAAK,WAAW,QAAQ;AAErE;;;;;;;;;AAYA,SAAgB,kBAAkB;CAChC,MAAM,mBACJ,QAGA;CACF,IAAI,OAAO,qBAAqB,YAC9B,OAAO;CAGT,MAAM,KAAK,iBAAiB,SAAS;CAGrC,MAAM,OAAO,iBAAiB,WAAW;CAGzC,MAAM,MAAM,iBAAiB,UAAU;CAIvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KACnB,OAAO;CAGT,OAAO;EAAE;EAAI;EAAM;CAAI;AACzB;AAYA,SAAS,qBAAsC;CAC7C,OAAO;AACT;;;;;;;;AASA,SAAgB,mBAAqD;CACnE,MAAM,UAAU,mBAAmB;CACnC,IAAI,CAAC,QAAQ,qBACX,QAAQ,sCAAsB,IAAI,IAAI;CAExC,OAAO,QAAQ;AACjB;;AAGA,SAAgB,yBAAqD;CACnE,OAAO,mBAAmB,CAAC,CAAC,wBAAwB;AACtD;;AAGA,SAAgB,uBAAmD;CACjE,OAAO,mBAAmB,CAAC,CAAC,sBAAsB;AACpD;;;;;;;;;;;AAYA,SAAgB,4BAGF;CACZ,OAAO,mBAAmB,CAAC,CAAC;AAC9B;AAIA,SAAgB,4BAAiD;CAC/D,OAAO;EACL,SAAS;EACT,WAAA;EACA,SAAS,CAAC;EACV,aAAa;CACf;AACF;;;;;;;AAQA,SAAgB,2BACd,SACkC;CAClC,OAAO,OAAO,YACZ,OAAO,QAAQ,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,YAAY;EAC1D,MAAM,eAAe,EACnB,GAAI,OACN;EACA,MAAM,kBACJ,aAGA;EAEF,IACE,aAAa,iBAAiB,KAAA,KAC9B,oBAAoB,KAAA,GAEpB,aAAa,eAAe;EAG9B,IAAI,aAAa,YACf,aAAa,aAAa,EAAE,GAAG,aAAa,WAAW;EAGzD,OAAO,CAAC,YAAY,YAAY;CAClC,CAAC,CACH;AACF;;;;;;;;AASA,SAAgB,0BACd,UACA,WACmC;CACnC,IAAI,CAAC,UAAU,SACb;CAGF,MAAM,yBAAyB,gBAAgB,SAAS,IACpD,YACA,KAAA;CACJ,MAAM,qBAAqB,yBACvB,mBAAmB,sBAAsB,CAAC,CAAC,YAC3C;CACJ,MAAM,iBAAiB,mBAAmB,YAAY;CACtD,MAAM,cAAc,SAAS;CAC7B,MAAM,eACJ,2BACC,cACG,oBAAoB,aAAa,kBAAkB,IACnD,KAAA;CAEN,QACG,eAAe,SAAS,QAAQ,gBAAgB,KAAA,MACjD,SAAS,QAAQ,uBACjB,SAAS,QAAQ,mBACjB,OAAO,OAAO,SAAS,OAAO,CAAC,CAAC,MAAM,UAAU;EAC9C,IAAI,CAAC,OACH,OAAO;EAGT,IAAI,MAAM,WAAW,YAAY,MAAM,gBACrC,OAAO;EAGT,OACE,2BAA2B,KAAA,KAC3B,gBAAgB,KAAA,KAChB,oBAAoB,aAAa,MAAM,aAAa,EAAE,MACpD;CAEN,CAAC;AAEL;AAIA,SAAgB,sBAAsB,UAAiC;CACrE,MAAM,WAAW,gBAAgB;CACjC,IAAI,CAAC,UACH,OAAO;CAGT,IAAI,aAAa;CAEjB,OAAO,MAAM;EACX,IACE,SAAS,GAAG,WACV,SAAS,KAAK,KAAK,YAAY,qBAAqB,CACtD,GAEA,OAAO;EAGT,MAAM,YAAY,SAAS,KAAK,QAAQ,UAAU;EAClD,IAAI,cAAc,YAChB,OAAO;EAGT,aAAa;CACf;AACF;AAEA,SAAgB,oCACd,aACe;CACf,MAAM,WAAW,gBAAgB;CACjC,IAAI,CAAC,UACH,OAAO;CAGT,IAAI,aAAa,QAAQ,IAAI;CAE7B,OAAO,MAAM;EACX,MAAM,kBAAkB,SAAS,KAAK,KACpC,YACA,gBACA,aACA,cACF;EAEA,IAAI,SAAS,GAAG,WAAW,eAAe,GACxC,OAAO;EAGT,MAAM,YAAY,SAAS,KAAK,QAAQ,UAAU;EAClD,IAAI,cAAc,YAChB,OAAO;EAGT,aAAa;CACf;AACF;AAEA,SAAgB,oCACd,aACe;CACf,MAAM,WAAW,gBAAgB;CACjC,IAAI,CAAC,UACH,OAAO;CAGT,MAAM,gBAAgB,sBAAsB,QAAQ,IAAI,CAAC;CACzD,IAAI,CAAC,eACH,OAAO;CAGT,MAAM,uBAAuB,SAAS,KAAK,KAAK,eAAe,UAAU;CACzE,IAAI,CAAC,SAAS,GAAG,WAAW,oBAAoB,GAC9C,OAAO;CAGT,KAAK,MAAM,kBAAkB,SAAS,GAAG,YAAY,oBAAoB,GAAG;EAC1E,MAAM,kBAAkB,SAAS,KAAK,KACpC,sBACA,gBACA,cACF;EACA,IAAI,CAAC,SAAS,GAAG,WAAW,eAAe,GACzC;EAGF,IAAI;GAIF,IAHoB,KAAK,MACvB,SAAS,GAAG,aAAa,iBAAiB,OAAO,CAE/C,CAAA,CAAY,SAAS,aACvB,OAAO;EAEX,QAAQ,CAER;CACF;CAEA,OAAO;AACT;AAEA,SAAgB,uCACd,YACe;CACf,MAAM,WAAW,gBAAgB;CACjC,IAAI,CAAC,UACH,OAAO;CAGT,MAAM,aAAa,CACjB,SAAS,KAAK,KAAK,YAAY,OAAO,YAAY,eAAe,GACjE,SAAS,KAAK,KAAK,YAAY,SAAS,eAAe,CACzD;CAEA,KAAK,MAAM,aAAa,YACtB,IAAI,SAAS,GAAG,WAAW,SAAS,GAClC,OAAO;CAIX,OAAO;AACT;AAEA,SAAgB,8BACd,aACA,UAA+B,CAAC,GACjB;CACf,MAAM,WAAW,gBAAgB;CACjC,IAAI,CAAC,UACH,OAAO;CAGT,MAAM,aAAa,QAAQ,QAAQ;CACnC,MAAM,kBACJ,oCAAoC,WAAW,KAC/C,oCAAoC,WAAW;CAEjD,IAAI,CAAC,iBACH,OAAO;CAGT,MAAM,aAAa,SAAS,KAAK,QAAQ,eAAe;CACxD,MAAM,cAAc,KAAK,MACvB,SAAS,GAAG,aAAa,iBAAiB,OAAO,CACnD;CAQA,KAAK,MAAM,aAAa,CAFC,mBAAmB,YAEpB,GAAiB;EACvC,MAAM,iBAAiB,YAAY,UAAU;EAC7C,IAAI,CAAC,gBACH;EAGF,MAAM,uBACJ,OAAO,mBAAmB,WACtB,iBACA,eAAe,UACf,eAAe,WACf,eAAe;EAErB,IAAI,CAAC,sBAAsB;GACzB,yBACE,SACA,2BACA,WAAW,YAAY,iDAAiD,aACxE;IAAE;IAAa;GAAU,CAC3B;GACA,IAAI,YACF,OAAO,KACL,WAAW,YAAY,iDAAiD,WAC1E;GAEF,OAAO;EACT;EAEA,IAAI,CAAC,qBAAqB,SAAS,OAAO,GAAG;GAC3C,yBACE,SACA,4BACA,WAAW,YAAY,mCAAmC,UAAU,aAAa,wBACjF;IAAE;IAAa;IAAW;GAAqB,CACjD;GACA,IAAI,YACF,OAAO,KACL,WAAW,YAAY,mCAAmC,UAAU,aAAa,sBACnF;GAEF,OAAO;EACT;EAEA,MAAM,eAAe,SAAS,KAAK,KAAK,YAAY,oBAAoB;EACxE,IAAI,SAAS,GAAG,WAAW,YAAY,GACrC,OAAO;EAGT,MAAM,0BACJ,uCAAuC,UAAU;EACnD,IAAI,yBACF,OAAO;EAGT,yBACE,SACA,6BACA,WAAW,YAAY,4BAA4B,qBAAqB,oCACxE;GAAE;GAAa;GAAW;EAAqB,CACjD;EACA,IAAI,YACF,OAAO,KACL,WAAW,YAAY,4BAA4B,qBAAqB,kCAC1E;EAEF,OAAO;CACT;CAEA,OAAO;AACT;;;;;;AASA,SAAgB,iCAA6D;CAC3E,MAAM,UAAU,mBAAmB;CAEnC,IAAI,QAAQ,yBAAyB,KAAA,GACnC,OAAO,QAAQ,wBAAwB;CAGzC,MAAM,WAAW,gBAAgB;CACjC,QAAQ,oCAAoC;CAC5C,IAAI,CAAC,UAAU;EACb,MAAM,mBAAmB,0BAA0B;EACnD,QAAQ,uBAAuB;EAC/B,OAAO;CACT;CAKA,MAAM,aAAa,OAAO,KAAK,IAAI,SAAS,KAAK,IAC7C,CACE,IAAA,IAAA,qpkDAAA,KAAA,OAAA,KAAA,GAAA,GACA,IAAA,IAAA,qpkDAAA,KAAA,OAAA,KAAA,GAAA,CACF,IACA,CAAC,IAAA,IAAA,oBAAA,KAAA,OAAA,KAAA,GAAA,CAA4C;CAEjD,KAAK,MAAM,aAAa,YACtB,IAAI;EACF,IAAI,CAAC,SAAS,GAAG,WAAW,SAAS,GACnC;EAGF,MAAM,WAAW,KAAK,MACpB,SAAS,GAAG,aAAa,WAAW,OAAO,CAC7C;EAEA,IAAI,CAAC,SAAS,WAAW,OAAO,SAAS,YAAY,UACnD;EAGF,MAAM,iBAAiB,SAAS,cAC5B,WACA;GAAE,GAAG;GAAU,aAAa;EAA2B;EAC3D,QAAQ,uBAAuB;EAC/B,OAAO;CACT,QAAQ,CAER;CAGF,MAAM,mBAAmB,0BAA0B;CACnD,QAAQ,uBAAuB;CAC/B,OAAO;AACT;;;;;;AAOA,SAAgB,iCACd,aACA,UAA+B,CAAC,GACJ;CAC5B,MAAM,QAAQ,iBAAiB;CAE/B,IAAI,MAAM,IAAI,WAAW,GACvB,OAAO,MAAM,IAAI,WAAW,KAAK;CAGnC,MAAM,WAAW,gBAAgB;CACjC,IAAI,CAAC,UACH,OAAO;CAGT,MAAM,eAAe,8BAA8B,aAAa,OAAO;CACvE,IAAI,CAAC,cACH,OAAO;CAGT,IAAI;EACF,MAAM,WAAW,KAAK,MACpB,SAAS,GAAG,aAAa,cAAc,OAAO,CAChD;EAEA,IAAI,CAAC,SAAS,WAAW,OAAO,SAAS,YAAY,UAAU;GAC7D,IAAI,QAAQ,QAAQ,MAClB,OAAO,KAAK,0CAA0C,aAAa;GAErE,OAAO;EACT;EAEA,MAAM,iBAAiB,SAAS,cAC5B,WACA;GAAE,GAAG;GAAU;EAAY;EAE/B,MAAM,IAAI,aAAa,cAAc;EAErC,OAAO;CACT,SAAS,OAAO;EACd,IAAI,QAAQ,QAAQ,MAClB,OAAO,KACL,uCAAuC,YAAY,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAClG;EAEF,OAAO;CACT;AACF;;;;;;;AAQA,SAAgB,iCACd,cAC4B;CAC5B,MAAM,WAAW,gBAAgB;CACjC,IAAI,CAAC,UACH,OAAO;CAGT,IAAI;EACF,MAAM,WAAW,KAAK,MACpB,SAAS,GAAG,aAAa,cAAc,OAAO,CAChD;EAEA,IAAI,CAAC,SAAS,WAAW,OAAO,SAAS,YAAY,UAAU;GAC7D,OAAO,KAAK,iCAAiC,cAAc;GAC3D,OAAO;EACT;EAEA,iBAAiB,CAAC,CAAC,IAAI,SAAS,eAAe,cAAc,QAAQ;EAErE,OAAO;CACT,SAAS,OAAO;EACd,OAAO,KACL,qCAAqC,aAAa,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OACjG;EACA,OAAO;CACT;AACF;;;;;;;;;AAUA,SAAgB,2BACd,WACmC;CACnC,MAAM,YAA2D;EAC/D,0BAA0B;EAC1B,qBAAqB;EACrB,+BAA+B;EAC/B,GAAG,iBAAiB,CAAC,CAAC,OAAO;CAC/B;CAEA,KAAK,MAAM,YAAY,WAAW;EAChC,MAAM,QAAQ,0BAA0B,UAAU,SAAS;EAC3D,IAAI,OACF,OAAO;CAEX;AAGF"}

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-core",
-  "packageVersion": "0.43.2",
+  "packageVersion": "0.43.3",
   "objects": {
     "@happyvertical/smrt-core:SmrtClass": {
       "name": "smrtclass",
@@ -156,7 +156,7 @@
               "optional": false
             }
           ],
-          "returnType": "Promise<SmrtLatestRelatedRow<ModelType>[]>",
+          "returnType": "Promise<SmrtLatestRelatedRow<SmrtObject>[]>",
           "isStatic": false,
           "isPublic": true
         },
@@ -291,7 +291,7 @@
               "optional": true
             }
           ],
-          "returnType": "Promise<ModelType[] | Record<string>[]>",
+          "returnType": "Promise<SmrtObject[] | Record<string>[]>",
           "isStatic": false,
           "isPublic": true
         },

package/dist/smrt-knowledge.json

@@ -3,19 +3,19 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-core",
-  "packageVersion": "0.43.2",
+  "packageVersion": "0.43.3",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "c88746cd725f004f0cf7017ecc51a8e670695d71a3604deef4492a24f634c853",
-    "packageJson": "91b171a13ce3814b56d25d0a9dea5faace98f711447cfef5b4446781d7384a2e",
+    "manifest": "0516c99ae96e0dcc73b501c40e1517487e109f9ee08835af9f3e01acdd550436",
+    "packageJson": "517f33eb7454afc15b61141e7324b516e70d1783d4bf3d882f826b4acfd2199d",
     "agents": "271fe1a30ab094368f077a0e47a2108104f5fb33ba6bdaa4b3f26f99c2a56357",
     "moduleDoc:agents/change-feed.md": "1530ded9ed605aa9b8a772b3ba4dd992a3f797f4d7c9ede3b3389dd7bfb401fa",
     "moduleDoc:agents/change-signals.md": "d9cb6a5541728ffea46607a6b1d4fa61d4621849f2b4ea86a0645fbb0af892e9",
     "moduleDoc:agents/generators.md": "2b6ccd5ff557293f2ce84d25cc254ceb518f4c274d93b7e3175985b18f36f564",
     "moduleDoc:agents/schema-paths.md": "effba5199db08573d120ce162819cc73de4dfc44af5a8b34cd4797e8b2021e38",
     "moduleDoc:agents/data-query.md": "1b72411d441ce2285bf0c89674e7aa996832a58b552b23a6d43834b907d91355",
-    "moduleDoc:agents/collection-reads.md": "9773b8306e6560a0968514a1c809121bdd63c7e2f74ec0d6e1da0d366420f027",
+    "moduleDoc:agents/collection-reads.md": "4ce06e8b70b9ce9b77b47b3e2ed266c899bb7962ca015d4714f07a4aca10a865",
     "moduleDoc:agents/memory.md": "658cb34f3a499e290c14ba0dd8cf0bf82bcc571da01150b61070abf100894dfc",
     "moduleDoc:agents/query-bounds.md": "3a0601ddaf2bea4e90e3f22e16a2eb3508a6fb8c019e3fb2c1f930c90a377cd5"
   },
@@ -376,7 +376,7 @@
           "params": [
             "options?: SmrtListOptions<ModelType>"
           ],
-          "returns": "Promise<ModelType[] | Record<string>[]>"
+          "returns": "Promise<SmrtObject[] | Record<string>[]>"
         },
         {
           "name": "listByIds",
@@ -392,7 +392,7 @@
           "params": [
             "options: SmrtLatestRelatedListOptions<ModelType>"
           ],
-          "returns": "Promise<SmrtLatestRelatedRow<ModelType>[]>"
+          "returns": "Promise<SmrtLatestRelatedRow<SmrtObject>[]>"
         },
         {
           "name": "query",
@@ -983,7 +983,7 @@
     {
       "path": "agents/collection-reads.md",
       "module": "collection-reads",
-      "content": "<!-- Module doc for packages/core/AGENTS.md. Linked from the Modules table there. -->\n\n# Collection reads\n\nThis module covers bounded collection reads beyond the basic query contract in\n`packages/core/AGENTS.md`.\n\n## Projections and related rows\n\n`list({ select })` uses SMRT field names, maps them to database columns, and\nreturns plain rows without hydrating objects. It composes with `where`,\n`orderBy`, `limit`, and `offset`, runs normal `beforeList`/tenant interceptors,\nand is limited to column-backed fields; it cannot combine with `include`.\n\nFor one child per parent, use\n[`latest-related.md`](latest-related.md). It uses a portable ranked CTE,\ndeclared primary keys, adapter-specific offset-only syntax, explicit aliases,\nand hydrates only the visible parent page.\n\n## Facets, counts, and read plans\n\n`collection.facets({ fields, where })` runs one bounded `GROUP BY` per requested\nfield and returns `{ field, values: [{ value, count }] }`. It accepts at most 20\nfields, clamps value limits to 1,000 and the collection ceiling, never hydrates\nobjects, and applies the same read/tenant/sensitive-field rails as `select`.\nStored array/string-list values are grouped as stored; they are not unnested.\n`collection.counts({ where })` returns `{ total, filtered }` through two scoped\n`COUNT(*)` queries. Local coverage is SQLite/DuckDB; optional scalar PostgreSQL\ncoverage requires `SMRT_TEST_POSTGRES_URL`.\n\n`executeCollectionReadPlan()` bounds concurrent reads across independent\ncollections while preserving the normal registry and collection options. The\ncaller supplies a positive `maxConcurrency`; the executor does not compose SQL,\ncache, or alter pool defaults, and drains already-started work before returning\nthe first error.\n\n`where` operators must remain aligned with `@happyvertical/sql`'s `buildWhere`:\n`=`, `>`, `<`, `>=`, `<=`, `!=`, `in`, `not in`, and `like`. Arrays imply `IN`,\nand null values render `IS NULL`/`IS NOT NULL`. `contains` and dot-notation JSON\npaths are intentionally rejected until the SQL layer supports them.\n"
+      "content": "<!-- Module doc for packages/core/AGENTS.md. Linked from the Modules table there. -->\n\n# Collection reads\n\nThis module covers bounded collection reads beyond the basic query contract in\n`packages/core/AGENTS.md`.\n\n## Projections and related rows\n\n`list({ select })` uses SMRT field names, maps them to database columns, and\nreturns plain rows without hydrating objects. It composes with `where`,\n`orderBy`, `limit`, and `offset`, runs normal `beforeList`/tenant interceptors,\nand is limited to column-backed fields; it cannot combine with `include`.\n\n## Bounded STI discriminator scopes\n\nAn STI child collection remains scoped to its own qualified `_meta_type` by\ndefault. A migration that must read registered sibling types may opt into an\nexplicit allowlist:\n\n```typescript\nawait impressionEvents.list({\n  stiScope: {\n    types: [\n      '@anytown/advertising:AdImpression',\n      '@anytown/advertising:LegacyAdImpression',\n    ],\n  },\n  orderBy: 'created_at ASC',\n  limit: 100,\n});\n```\n\n`stiScope.types` accepts 1–50 unique, qualified, registered types, all sharing\nthe child collection's STI root. Empty, simple-name, unknown, duplicate,\nunrelated, and non-child scopes fail at the collection boundary. The option is\nsupported by `list()`, `count()`, `counts()`, `facets()`, and\n`listWithLatestRelated()`. These methods retain their normal field validation,\nprojection or polymorphic hydration, pagination and cache-key construction;\nnormal read and tenant interceptors still run and are ANDed with the allowlist.\nPoint reads through `get()` remain child-only; use a bounded\n`list({ where, limit: 1, stiScope })` migration read when sibling hydration is\nrequired.\n\nFor one child per parent, use\n[`latest-related.md`](latest-related.md). It uses a portable ranked CTE,\ndeclared primary keys, adapter-specific offset-only syntax, explicit aliases,\nand hydrates only the visible parent page.\n\n## Facets, counts, and read plans\n\n`collection.facets({ fields, where })` runs one bounded `GROUP BY` per requested\nfield and returns `{ field, values: [{ value, count }] }`. It accepts at most 20\nfields, clamps value limits to 1,000 and the collection ceiling, never hydrates\nobjects, and applies the same read/tenant/sensitive-field rails as `select`.\nStored array/string-list values are grouped as stored; they are not unnested.\n`collection.counts({ where })` returns `{ total, filtered }` through two scoped\n`COUNT(*)` queries. Local coverage is SQLite/DuckDB; optional scalar PostgreSQL\ncoverage requires `SMRT_TEST_POSTGRES_URL`.\n\n`executeCollectionReadPlan()` bounds concurrent reads across independent\ncollections while preserving the normal registry and collection options. The\ncaller supplies a positive `maxConcurrency`; the executor does not compose SQL,\ncache, or alter pool defaults, and drains already-started work before returning\nthe first error.\n\n`where` operators must remain aligned with `@happyvertical/sql`'s `buildWhere`:\n`=`, `>`, `<`, `>=`, `<=`, `!=`, `in`, `not in`, and `like`. Arrays imply `IN`,\nand null values render `IS NULL`/`IS NOT NULL`. `contains` and dot-notation JSON\npaths are intentionally rejected until the SQL layer supports them.\n"
     },
     {
       "path": "agents/memory.md",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-core",
-  "version": "0.43.2",
+  "version": "0.43.3",
   "description": "Core AI agent framework with standardized collections, object-relational mapping, and code generators",
   "author": "HappyVertical",
   "type": "module",
@@ -164,9 +164,9 @@
     "tsx": "^4.23.0",
     "typescript": "5.9.3",
     "yaml": "^2.9.0",
-    "@happyvertical/smrt-config": "0.43.2",
-    "@happyvertical/smrt-scanner": "0.43.2",
-    "@happyvertical/smrt-types": "0.43.2"
+    "@happyvertical/smrt-config": "0.43.3",
+    "@happyvertical/smrt-scanner": "0.43.3",
+    "@happyvertical/smrt-types": "0.43.3"
   },
   "peerDependencies": {
     "@huggingface/transformers": ">=3.0.0 <4.0.0",