@happyvertical/smrt-core 0.43.10 → 0.44.1

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":"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"}

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-core",
-  "packageVersion": "0.43.10",
+  "packageVersion": "0.44.1",
   "objects": {
     "@happyvertical/smrt-core:SmrtClass": {
       "name": "smrtclass",
@@ -1101,7 +1101,13 @@
         "delete": {
           "name": "delete",
           "async": true,
-          "parameters": [],
+          "parameters": [
+            {
+              "name": "options",
+              "type": "SmrtDeleteOptions",
+              "optional": true
+            }
+          ],
           "returnType": "Promise<void>",
           "isStatic": false,
           "isPublic": true

package/dist/migrations/differ.d.ts

@@ -151,6 +151,15 @@ export declare class SchemaComparer {
     private options;
     private engine;
     private ddlStrategy;
+    /**
+     * Live schemas read during one `compare()` run. The uuid convergence plan
+     * (#2608) needs the same introspection the per-table comparison does, and
+     * re-reading `getTableSchema` per relationship would multiply catalog
+     * round-trips on a wide schema.
+     */
+    private liveSchemas;
+    /** Convergence plan for this run; `null` on non-PostgreSQL engines. */
+    private uuidConvergence;
     constructor(db: DatabaseInterface, options?: DiffOptions);
     /**
      * Compare manifest schemas to database and return differences
@@ -160,6 +169,38 @@ export declare class SchemaComparer {
      * Compare a single table's schema to manifest
      */
     compareTable(tableName: string, manifest: SchemaDefinition, manifestSchemas?: Record<string, SchemaDefinition>): Promise<SchemaChange[]>;
+    /**
+     * Read (and memoize for this run) one table's live schema. Returns
+     * `undefined` when the table does not exist or the adapter cannot
+     * introspect it.
+     */
+    private getLiveSchema;
+    /**
+     * Plan the pre-R11 `text` -> `uuid` convergence (#2608).
+     *
+     * PostgreSQL only: SQLite stores UUIDs as text by design and DuckDB cannot
+     * rewrite a column type in place, so both engines return `null` and emit
+     * nothing for this drift.
+     */
+    private buildUuidConvergencePlan;
+    /**
+     * Count values a legacy `text` identifier column holds that cannot be
+     * reinterpreted as `uuid`. Any failure resolves to `unavailable`, which the
+     * planner treats as a block — SMRT never coerces identifier values.
+     */
+    private probeUuidShape;
+    /**
+     * Turn the convergence plan into diff entries: executable `type_upgrade`
+     * conversions marked `phase: 'pre_foreign_key'`, plus report-only warnings
+     * for components the planner refused.
+     */
+    private uuidConvergenceChanges;
+    /**
+     * Live-type verdict for one foreign key once this run's conversions land.
+     * `undefined` means the pair is compatible (or unknowable) and the ordinary
+     * add path applies.
+     */
+    private describeForeignKeyTypeBlock;
     private compareForeignKeys;
     private foreignKeyHasOrphans;
     private getForeignKeyOrphanOptions;
@@ -497,4 +538,12 @@ export declare function hasActionableChanges(diff: SchemaDiff): boolean;
  * they already do for `type_upgrade`.
  */
 export declare function getSQLFromDiff(diff: SchemaDiff): string[];
+/**
+ * Executable SQL for an explicit subset of changes, in the order given.
+ * Callers that have to interleave diff changes with statements produced
+ * elsewhere — the orchestrator, which emits `CREATE TABLE` and deferred
+ * foreign keys of its own — partition `diff.changes` by
+ * {@link SchemaChange.phase} and render each part through this helper.
+ */
+export declare function getSQLFromChanges(changes: readonly SchemaChange[]): string[];
 //# sourceMappingURL=differ.d.ts.map

package/dist/migrations/differ.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"differ.d.ts","sourceRoot":"","sources":["../../src/migrations/differ.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"differ.d.ts","sourceRoot":"","sources":["../../src/migrations/differ.ts"],"names":[],"mappings":"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"}

package/dist/migrations/differ.js

@@ -2,6 +2,7 @@ import { normalizeForeignKeyAction, requireForeignKeyAction } from "../schema/fo
 import { isJsonPathIndex, isStiSubtypeUniqueIndex, renderIndexTarget } from "../schema/index-utils.js";
 import { foreignKeyConstraintName, foreignKeyRelationshipKey, renderForeignKeyConstraint, renderForeignKeyOrphanDetector, renderForeignKeyOrphanRepair, schemaForeignKeys, schemaForeignKeysForEngine } from "../schema/foreign-key-ddl.js";
 import { detectEngine, getDDLStrategy } from "../schema/ddl/index.js";
+import { describeForeignKeyTypeConflict, planUuidConvergence, renderUuidConvergenceRepairHint, renderUuidShapeProbe } from "../schema/uuid-convergence.js";
 import "../schema/utils.js";
 import { planSqliteTableRebuilds, sqliteRebuildPlaceholderSql } from "./sqlite-rebuild.js";
 import { createLogger } from "@happyvertical/logger";
@@ -291,6 +292,15 @@ var SchemaComparer = class {
 	options;
 	engine;
 	ddlStrategy;
+	/**
+	* Live schemas read during one `compare()` run. The uuid convergence plan
+	* (#2608) needs the same introspection the per-table comparison does, and
+	* re-reading `getTableSchema` per relationship would multiply catalog
+	* round-trips on a wide schema.
+	*/
+	liveSchemas = /* @__PURE__ */ new Map();
+	/** Convergence plan for this run; `null` on non-PostgreSQL engines. */
+	uuidConvergence = null;
 	constructor(db, options = {}) {
 		this.db = db;
 		this.options = {
@@ -313,7 +323,13 @@ var SchemaComparer = class {
 			changes: [],
 			has_changes: false
 		};
+		this.liveSchemas.clear();
 		const existingTables = await this.getExistingTables();
+		this.uuidConvergence = await this.buildUuidConvergencePlan(manifestSchemas, existingTables);
+		for (const change of this.uuidConvergenceChanges(manifestSchemas)) {
+			diff.changes.push(change);
+			if (!isInfoOnlyChange(change)) diff.has_changes = true;
+		}
 		for (const [tableName, schema] of Object.entries(manifestSchemas)) if (!existingTables.has(tableName)) {
 			diff.added_tables.push(schema);
 			diff.has_changes = true;
@@ -342,7 +358,7 @@ var SchemaComparer = class {
 	*/
 	async compareTable(tableName, manifest, manifestSchemas = {}) {
 		const changes = [];
-		const dbSchema = await this.db.getTableSchema?.(tableName);
+		const dbSchema = await this.getLiveSchema(tableName);
 		if (!dbSchema) return changes;
 		const columnChanges = await this.compareColumns(tableName, manifest, dbSchema);
 		changes.push(...this.engine === "sqlite" ? await planSqliteTableRebuilds({
@@ -357,6 +373,173 @@ var SchemaComparer = class {
 		changes.push(...await this.compareForeignKeys(tableName, manifest, dbSchema, manifestSchemas));
 		return changes;
 	}
+	/**
+	* Read (and memoize for this run) one table's live schema. Returns
+	* `undefined` when the table does not exist or the adapter cannot
+	* introspect it.
+	*/
+	async getLiveSchema(tableName) {
+		if (this.liveSchemas.has(tableName)) return this.liveSchemas.get(tableName) ?? void 0;
+		const schema = await this.db.getTableSchema?.(tableName);
+		this.liveSchemas.set(tableName, schema);
+		return schema ?? void 0;
+	}
+	/**
+	* Plan the pre-R11 `text` -> `uuid` convergence (#2608).
+	*
+	* PostgreSQL only: SQLite stores UUIDs as text by design and DuckDB cannot
+	* rewrite a column type in place, so both engines return `null` and emit
+	* nothing for this drift.
+	*/
+	async buildUuidConvergencePlan(manifestSchemas, existingTables) {
+		if (this.engine !== "postgres") return null;
+		for (const tableName of Object.keys(manifestSchemas)) {
+			if (!existingTables.has(tableName)) continue;
+			await this.getLiveSchema(tableName);
+		}
+		const relationships = Object.entries(manifestSchemas).flatMap(([tableName, schema]) => schemaForeignKeysForEngine(schema, "postgres").map((foreignKey) => ({
+			childTable: tableName,
+			childColumn: foreignKey.column,
+			parentTable: foreignKey.referencesTable,
+			parentColumn: foreignKey.referencesColumn
+		})));
+		const conversionCandidates = /* @__PURE__ */ new Set();
+		for (const relationship of relationships) {
+			const childManifest = manifestSchemas[relationship.childTable]?.columns[relationship.childColumn];
+			const parentManifest = manifestSchemas[relationship.parentTable]?.columns[relationship.parentColumn];
+			if (childManifest?.type !== "UUID" || parentManifest?.type !== "UUID") continue;
+			for (const [table, column] of [[relationship.childTable, relationship.childColumn], [relationship.parentTable, relationship.parentColumn]]) {
+				if (!existingTables.has(table)) continue;
+				const live = this.liveSchemas.get(table)?.columns[column];
+				if (!live) continue;
+				if (this.normalizeType(live.type) !== "TEXT") continue;
+				conversionCandidates.add(`${table} ${column}`);
+			}
+		}
+		if (conversionCandidates.size > 0) for (const tableName of existingTables) {
+			if (manifestSchemas[tableName]) continue;
+			if (tableName.startsWith("sqlite_")) continue;
+			await this.getLiveSchema(tableName);
+		}
+		const liveForeignKeys = [];
+		for (const [tableName, schema] of this.liveSchemas) for (const live of schema?.foreignKeys ?? []) liveForeignKeys.push({
+			table: tableName,
+			column: live.column,
+			referencesTable: live.referencesTable,
+			referencesColumn: live.referencesColumn
+		});
+		return planUuidConvergence({
+			manifestSchemas,
+			relationships,
+			liveForeignKeys,
+			getLiveColumn: (table, column) => {
+				if (!existingTables.has(table)) return void 0;
+				const live = this.liveSchemas.get(table)?.columns[column];
+				if (!live) return void 0;
+				return {
+					normalizedType: this.normalizeType(live.type),
+					rawType: live.type,
+					hasDefault: live.defaultValue !== null && live.defaultValue !== void 0,
+					exists: true
+				};
+			},
+			probeUuidShape: (table, column) => this.probeUuidShape(table, column)
+		});
+	}
+	/**
+	* Count values a legacy `text` identifier column holds that cannot be
+	* reinterpreted as `uuid`. Any failure resolves to `unavailable`, which the
+	* planner treats as a block — SMRT never coerces identifier values.
+	*/
+	async probeUuidShape(tableName, columnName) {
+		try {
+			const result = await this.db.query(renderUuidShapeProbe(tableName, columnName));
+			const rows = Array.isArray(result) ? result : result.rows || [];
+			const count = Number(rows[0]?.invalid_count ?? 0);
+			if (!Number.isFinite(count)) return {
+				status: "unavailable",
+				reason: "probe returned a non-numeric count"
+			};
+			if (count === 0) return { status: "clean" };
+			const sample = rows[0]?.sample_value;
+			return {
+				status: "dirty",
+				count,
+				...typeof sample === "string" ? { sample } : {}
+			};
+		} catch (error) {
+			return {
+				status: "unavailable",
+				reason: error instanceof Error ? error.message : String(error)
+			};
+		}
+	}
+	/**
+	* Turn the convergence plan into diff entries: executable `type_upgrade`
+	* conversions marked `phase: 'pre_foreign_key'`, plus report-only warnings
+	* for components the planner refused.
+	*/
+	uuidConvergenceChanges(manifestSchemas) {
+		const plan = this.uuidConvergence;
+		if (!plan) return [];
+		const manifestColumn = (table, column) => manifestSchemas[table]?.columns[column] ?? { type: "UUID" };
+		const changes = [];
+		for (const conversion of plan.conversions) changes.push({
+			type: "type_upgrade",
+			table: conversion.table,
+			name: conversion.column,
+			column: manifestColumn(conversion.table, conversion.column),
+			phase: "pre_foreign_key",
+			mismatch: {
+				expected: "UUID",
+				actual: conversion.liveType
+			},
+			sql: conversion.statements[0],
+			sqlStatements: conversion.statements
+		});
+		for (const block of plan.blocks) {
+			const [first] = block.targets.length > 0 ? block.targets : block.nodes;
+			changes.push({
+				type: "type_upgrade",
+				table: first?.table ?? "",
+				name: first?.column,
+				column: manifestColumn(first?.table ?? "", first?.column ?? ""),
+				phase: "pre_foreign_key",
+				mismatch: {
+					expected: "UUID",
+					actual: "mixed uuid/text"
+				},
+				advisory: {
+					severity: "warning",
+					message: `blocked: incompatible column types. The manifest declares UUID for ${block.nodes.map((node) => `${node.table}.${node.column}`).join(", ")}, but ${block.reason}.`,
+					suggestedSql: block.suggestedSql
+				}
+			});
+		}
+		return changes;
+	}
+	/**
+	* Live-type verdict for one foreign key once this run's conversions land.
+	* `undefined` means the pair is compatible (or unknowable) and the ordinary
+	* add path applies.
+	*/
+	async describeForeignKeyTypeBlock(tableName, dbSchema, foreignKey) {
+		if (this.engine !== "postgres") return void 0;
+		const parentSchema = foreignKey.referencesTable === tableName ? dbSchema : await this.getLiveSchema(foreignKey.referencesTable);
+		const childType = dbSchema.columns[foreignKey.column]?.type;
+		const parentType = parentSchema?.columns[foreignKey.referencesColumn]?.type;
+		if (!childType || !parentType) return void 0;
+		const plan = this.uuidConvergence;
+		if ((plan?.effectiveType(tableName, foreignKey.column) ?? this.normalizeType(childType)) === (plan?.effectiveType(foreignKey.referencesTable, foreignKey.referencesColumn) ?? this.normalizeType(parentType))) return void 0;
+		return describeForeignKeyTypeConflict({
+			childTable: tableName,
+			childColumn: foreignKey.column,
+			childType,
+			parentTable: foreignKey.referencesTable,
+			parentColumn: foreignKey.referencesColumn,
+			parentType
+		});
+	}
 	async compareForeignKeys(tableName, manifest, dbSchema, manifestSchemas) {
 		const changes = [];
 		const liveForeignKeys = dbSchema.foreignKeys || [];
@@ -433,6 +616,29 @@ var SchemaComparer = class {
 				});
 				continue;
 			}
+			const typeBlock = await this.describeForeignKeyTypeBlock(tableName, dbSchema, foreignKey);
+			if (typeBlock) {
+				const textNodes = manifest.columns[foreignKey.column]?.type === "UUID" && manifestSchemas[foreignKey.referencesTable]?.columns[foreignKey.referencesColumn]?.type === "UUID" ? [this.normalizeType(dbSchema.columns[foreignKey.column]?.type ?? "") === "TEXT" ? {
+					table: tableName,
+					column: foreignKey.column
+				} : void 0, this.normalizeType((foreignKey.referencesTable === tableName ? dbSchema : this.liveSchemas.get(foreignKey.referencesTable))?.columns[foreignKey.referencesColumn]?.type ?? "") === "TEXT" ? {
+					table: foreignKey.referencesTable,
+					column: foreignKey.referencesColumn
+				} : void 0].filter((node) => node !== void 0) : [];
+				const suggestedSql = renderUuidConvergenceRepairHint(textNodes);
+				changes.push({
+					type: "add_foreign_key",
+					table: tableName,
+					name: foreignKeyConstraintName(tableName, foreignKey),
+					foreignKey,
+					advisory: {
+						severity: "warning",
+						message: `blocked: incompatible column types. ${typeBlock}. ` + (textNodes.length > 0 ? "Converge the columns to UUID, then rerun the migration." : "Align both columns on one physical type deliberately, then rerun the migration."),
+						...suggestedSql.length > 0 ? { suggestedSql } : {}
+					}
+				});
+				continue;
+			}
 			if (Boolean(dbSchema.columns[foreignKey.column]) && await this.foreignKeyHasOrphans(tableName, foreignKey, orphanOptions)) {
 				changes.push({
 					type: "add_foreign_key",
@@ -480,7 +686,7 @@ var SchemaComparer = class {
 			nullable,
 			uuidComparison
 		};
-		const parentSchema = foreignKey.referencesTable === tableName ? dbSchema : await this.db.getTableSchema?.(foreignKey.referencesTable);
+		const parentSchema = foreignKey.referencesTable === tableName ? dbSchema : await this.getLiveSchema(foreignKey.referencesTable);
 		const childType = dbSchema.columns[foreignKey.column]?.type;
 		const parentType = parentSchema?.columns[foreignKey.referencesColumn]?.type;
 		if (!childType || !parentType) return {
@@ -1389,11 +1595,21 @@ function hasActionableChanges(diff) {
 * they already do for `type_upgrade`.
 */
 function getSQLFromDiff(diff) {
+	return getSQLFromChanges(diff.changes);
+}
+/**
+* Executable SQL for an explicit subset of changes, in the order given.
+* Callers that have to interleave diff changes with statements produced
+* elsewhere — the orchestrator, which emits `CREATE TABLE` and deferred
+* foreign keys of its own — partition `diff.changes` by
+* {@link SchemaChange.phase} and render each part through this helper.
+*/
+function getSQLFromChanges(changes) {
 	const statements = [];
-	for (const change of diff.changes) if (change.type !== "type_mismatch" && !isAdvisoryOnlyChange(change)) statements.push(...change.sqlStatements ?? (change.sql ? [change.sql] : []));
+	for (const change of changes) if (change.type !== "type_mismatch" && !isAdvisoryOnlyChange(change)) statements.push(...change.sqlStatements ?? (change.sql ? [change.sql] : []));
 	return statements;
 }
 //#endregion
-export { SchemaComparer, canonicalizeDefault, extractIndexPredicate, generateSchemaDiff, getSQLFromDiff, hasActionableChanges, isAdvisoryOnlyChange, isInfoOnlyChange, isManualOrAdvisoryChange, normalizeIndexPredicate, uniqueColumnIndexName };
+export { SchemaComparer, canonicalizeDefault, extractIndexPredicate, generateSchemaDiff, getSQLFromChanges, getSQLFromDiff, hasActionableChanges, isAdvisoryOnlyChange, isInfoOnlyChange, isManualOrAdvisoryChange, normalizeIndexPredicate, uniqueColumnIndexName };
 
 //# sourceMappingURL=differ.js.map