@happyvertical/smrt-core 0.44.0 → 0.45.0

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.44.0",
+  "packageVersion": "0.45.0",
   "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/object.d.ts

@@ -11,6 +11,14 @@ export interface SmrtSaveOptions {
      */
     expectedUpdatedAt?: Date | string;
 }
+/** Optional optimistic-concurrency guard for irreversible deletes. */
+export interface SmrtDeleteOptions {
+    /**
+     * Delete only when the stored row still has this revision. A mismatch throws
+     * `RUNTIME_REVISION_CONFLICT` before any durable cascade is committed.
+     */
+    expectedUpdatedAt?: Date | string;
+}
 /**
  * Options for SmrtObject initialization
  */
@@ -673,6 +681,28 @@ export declare class SmrtObject extends SmrtClass {
      * and other after-save consumers all see authoritative state.
      */
     protected completePersistedUpdate(durableRow: Record<string, unknown>): Promise<void>;
+    /**
+     * Build the compare-and-swap condition that pins a guarded UPDATE or DELETE
+     * to the revision this writer loaded.
+     *
+     * PostgreSQL stores `updated_at` as `timestamp(6) WITHOUT time zone` and `pg`
+     * hydrates it in the process zone, so neither the precision nor the wall clock
+     * of a JavaScript `Date` survives the round trip. Exact string equality was
+     * therefore unsatisfiable for any row last written by raw SQL, and for every
+     * row on a non-UTC host, turning a lost-race guard into a permanent
+     * `RUNTIME_REVISION_CONFLICT` (#2620). See `revision-guard.ts` for how the
+     * PostgreSQL condition restores both correctness and lost-race semantics.
+     *
+     * The guarded `delete({ expectedUpdatedAt })` predicate is built here too:
+     * it bound the same exact equality into its final `DELETE`, so a microsecond
+     * or non-UTC row was permanently undeletable under a revision guard for the
+     * same reason.
+     *
+     * Other server dialects (remote LibSQL) store ISO text that round-trips
+     * exactly, and embedded engines never reach here — they take the
+     * compare/upsert fallback in {@link usesEmbeddedRevisionFallback}.
+     */
+    private revisionPredicate;
     private revisionPredicateValue;
     private revisionsEqual;
     private nextRevisionTimestamp;
@@ -999,7 +1029,7 @@ export declare class SmrtObject extends SmrtClass {
      *
      * @see {@link foreignKey} for declaring `onDelete` on the referencing side
      */
-    delete(): Promise<void>;
+    delete(options?: SmrtDeleteOptions): Promise<void>;
     /**
      * Invalidate cached collection reads after a successful mutation
      * (issue #1498).

package/dist/object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAQzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAOpC,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAUrB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAkBpE,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAoC/B,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CACnC;AA8FD;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC;IAElB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;;;;;;OASG;IAEH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACvC;AAqBD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IACjE;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,UAAW,SAAQ,SAAS;IACvC;;OAEG;IACI,UAAU,EAAG,MAAM,CAAC;IAE3B;;;OAGG;IACH,OAAO,CAAC,oBAAoB,CAAmC;IAE/D;;;;;;;;;OASG;IACH,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW,CAAS;IAE5B;;;OAGG;IACY,OAAO,EAAE,iBAAiB,CAAC;IAE1C;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEzC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAE3C;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAE9C;;OAEG;IACI,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAQ;IAElD;;OAEG;IACI,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAQ;IAElD;;;;;OAKG;gBACS,OAAO,GAAE,iBAAsB;IA0B3C,OAAO,CAAC,sBAAsB;IAM9B,SAAS,CAAC,oBAAoB,IAAI,MAAM;IAIxC,SAAS,CAAC,wBAAwB,IAAI,MAAM;IAO5C,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,+BAA+B;YAezB,oBAAoB;IAgGlC;;;;OAIG;IACH,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIjC;;;;;OAKG;IACH,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;;;;OAKG;IACI,eAAe,IAAI,IAAI;IAI9B;;;;;;;;OAQG;IACI,mBAAmB,IAAI,IAAI;cAIlB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnD;;;;;;;;OAQG;IACU,eAAe,CAAC,CAAC,EAC5B,SAAS,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GACrC,OAAO,CAAC,CAAC,CAAC;IAoCb;;;;OAIG;IACH,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAM7C;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,UAAU;IAsBlB;;;;OAIG;YACW,+BAA+B;IAiD7C;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAElC;IAED;;;;;OAKG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAKtC;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAEpC;IAED;;;;;OAKG;IACH,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAMxC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;;OAKG;IACH,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAK3C;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBxC;;;;;;;;;OASG;IACH,OAAO,CAAC,2BAA2B;IAiBnC;;;;;;;;;OASG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA6JlD,4EAA4E;cAC5D,4BAA4B,CAC1C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAiCnC,+EAA+E;cAC/D,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IA6C1C,OAAO,CAAC,cAAc;IAwBtB;;OAEG;IACH,IAAI,SAAS,WAqCZ;IAED;;;;OAIG;IAMG,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC;IAiC/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,SAAS,CAAC,aAAa,CACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI1B;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM;IAgMN;;;;;;;;;;;;;;;;;;;OAmBG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIxC;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IA8C9B;;;;;;;;;;OAUG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAOlE;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,iBAAiB;IA2CzB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAoClC;;;;;;;;;;OAUG;IACG,KAAK;IA8BX;;;;;;;;;;;;;;;;;;;OAmBG;IACG,OAAO;IAgCb;;;;;;;;OAQG;IACG,UAAU;IAwBhB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;YACW,kBAAkB;IAmBhC;;;;OAIG;IACG,OAAO;IAKb;;;;;;;;;;;;;;;;;;;;;OAqBG;YACW,sBAAsB;IA8DpC;;;;;;;;;;;OAWG;YACW,2BAA2B;IAazC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkDG;IACG,IAAI,CAAC,OAAO,GAAE,eAAoB;IAsXxC;;;;;;;OAOG;IACG,aAAa,CAAC,iBAAiB,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuEpE;;;;;OAKG;cACa,uBAAuB,CACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC;IAchB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,qBAAqB;IAe7B;;;;;;;;;OASG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;;OAGG;cACa,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA6DnD;;;;;;;;;;;OAWG;cACa,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgEzD;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMnD;;;;;OAKG;IACH,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAMhD;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,uBAAuB,CAC5B,OAAO,EAAE,MAAM,GACd,QAAQ,GAAG,UAAU,GAAG,IAAI;IAiB/B;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,+BAA+B,CACvC,KAAK,EAAE,KAAK,EACZ,cAAc,EAAE,2BAA2B,GAC1C,MAAM;IAaT;;;;;OAKG;IACH,SAAS,CAAC,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAyB9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACU,UAAU;IA4CvB;;;;;;;;;;;;;;;;;;OAkBG;IACU,YAAY;IAezB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,oBAAoB;IAkC5B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;IA4BlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACU,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;IAoBtE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACU,QAAQ,CAAC,OAAO,GAAE,kBAAuB;IAoBtD;;;;;OAKG;cACa,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2DG;IACU,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAuDpC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,6BAA6B;IAyBrC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,gCAAgC;IAkCxC;;;;;;;;;;;OAWG;IACI,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlD;;;;;;;;;;;;;;;;OAgBG;IACI,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IAKU,WAAW,CACtB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,kBAAkB,GAExB,OAAO,CAAC,GAAG,CAAC;IAiHf;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,mBAAmB;IAqC3B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IAGU,eAAe,CAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,kBAAkB,GAExB,OAAO,CAAC,GAAG,EAAE,CAAC;IA8JjB;;;;;;OAMG;cACa,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GACA,OAAO,CAAC;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IAgDF;;;;;;;;;;;;;;;;;;;;;;OAsBG;IAGU,UAAU,CACrB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,kBAAkB,GAExB,OAAO,CAAC,GAAG,CAAC;IAuCf;;;;;;;;;;;;OAYG;IACI,iBAAiB,IAAI,MAAM,EAAE;IAKpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACU,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC;IAOzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACU,QAAQ,CAAC,OAAO,EAAE;QAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,OAAO,CAAC;QACf,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACU,MAAM,CAAC,OAAO,EAAE;QAC3B,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,OAAO,CAAC;IAqEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACU,SAAS,CACpB,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;KACnB,GACL,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA+ChC;;;;;;;;;;;;;;;;;;OAkBG;IACU,MAAM,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3E;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACU,WAAW,CAAC,OAAO,EAAE;QAChC,KAAK,EAAE,MAAM,CAAC;QACd,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BnB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACU,kBAAkB,CAC7B,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,IAAI,CAAC;IAkJhB;;;;;;;;;;;;;;;;;OAiBG;IACU,YAAY,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IA8C3B;;;;;;;;;;;;;;OAcG;IACU,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IA4EnD;;;;;;;;;;;;OAYG;IACU,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;CAW9C"}
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAQzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAOpC,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAWrB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAmBpE,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAoC/B,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CACnC;AAED,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CACnC;AA8FD;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC;IAElB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;;;;;;OASG;IAEH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACvC;AAqBD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IACjE;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,UAAW,SAAQ,SAAS;IACvC;;OAEG;IACI,UAAU,EAAG,MAAM,CAAC;IAE3B;;;OAGG;IACH,OAAO,CAAC,oBAAoB,CAAmC;IAE/D;;;;;;;;;OASG;IACH,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW,CAAS;IAE5B;;;OAGG;IACY,OAAO,EAAE,iBAAiB,CAAC;IAE1C;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEzC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAE3C;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAE9C;;OAEG;IACI,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAQ;IAElD;;OAEG;IACI,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAQ;IAElD;;;;;OAKG;gBACS,OAAO,GAAE,iBAAsB;IA0B3C,OAAO,CAAC,sBAAsB;IAM9B,SAAS,CAAC,oBAAoB,IAAI,MAAM;IAIxC,SAAS,CAAC,wBAAwB,IAAI,MAAM;IAO5C,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,+BAA+B;YAezB,oBAAoB;IAgGlC;;;;OAIG;IACH,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIjC;;;;;OAKG;IACH,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;;;;OAKG;IACI,eAAe,IAAI,IAAI;IAI9B;;;;;;;;OAQG;IACI,mBAAmB,IAAI,IAAI;cAIlB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnD;;;;;;;;OAQG;IACU,eAAe,CAAC,CAAC,EAC5B,SAAS,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GACrC,OAAO,CAAC,CAAC,CAAC;IAoCb;;;;OAIG;IACH,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAM7C;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,UAAU;IAsBlB;;;;OAIG;YACW,+BAA+B;IAiD7C;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAElC;IAED;;;;;OAKG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAKtC;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAEpC;IAED;;;;;OAKG;IACH,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAMxC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;;OAKG;IACH,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAK3C;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBxC;;;;;;;;;OASG;IACH,OAAO,CAAC,2BAA2B;IAiBnC;;;;;;;;;OASG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA6JlD,4EAA4E;cAC5D,4BAA4B,CAC1C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAiCnC,+EAA+E;cAC/D,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IA6C1C,OAAO,CAAC,cAAc;IAwBtB;;OAEG;IACH,IAAI,SAAS,WAqCZ;IAED;;;;OAIG;IAMG,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC;IAiC/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,SAAS,CAAC,aAAa,CACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI1B;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM;IAgMN;;;;;;;;;;;;;;;;;;;OAmBG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIxC;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IA8C9B;;;;;;;;;;OAUG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAOlE;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,iBAAiB;IA2CzB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAoClC;;;;;;;;;;OAUG;IACG,KAAK;IA8BX;;;;;;;;;;;;;;;;;;;OAmBG;IACG,OAAO;IAgCb;;;;;;;;OAQG;IACG,UAAU;IAwBhB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;YACW,kBAAkB;IAmBhC;;;;OAIG;IACG,OAAO;IAKb;;;;;;;;;;;;;;;;;;;;;OAqBG;YACW,sBAAsB;IA8DpC;;;;;;;;;;;OAWG;YACW,2BAA2B;IAazC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkDG;IACG,IAAI,CAAC,OAAO,GAAE,eAAoB;IAmXxC;;;;;;;OAOG;IACG,aAAa,CAAC,iBAAiB,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuEpE;;;;;OAKG;cACa,uBAAuB,CACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC;IAchB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,qBAAqB;IAe7B;;;;;;;;;OASG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;;OAGG;cACa,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA6DnD;;;;;;;;;;;OAWG;cACa,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgEzD;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMnD;;;;;OAKG;IACH,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAMhD;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,uBAAuB,CAC5B,OAAO,EAAE,MAAM,GACd,QAAQ,GAAG,UAAU,GAAG,IAAI;IAiB/B;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,+BAA+B,CACvC,KAAK,EAAE,KAAK,EACZ,cAAc,EAAE,2BAA2B,GAC1C,MAAM;IAaT;;;;;OAKG;IACH,SAAS,CAAC,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAyB9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACU,UAAU;IA4CvB;;;;;;;;;;;;;;;;;;OAkBG;IACU,YAAY;IAezB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,oBAAoB;IAkC5B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;IA4BlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACU,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;IAoBtE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACU,QAAQ,CAAC,OAAO,GAAE,kBAAuB;IAoBtD;;;;;OAKG;cACa,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2DG;IACU,MAAM,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqGnE;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,6BAA6B;IAyBrC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,gCAAgC;IAkCxC;;;;;;;;;;;OAWG;IACI,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlD;;;;;;;;;;;;;;;;OAgBG;IACI,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IAKU,WAAW,CACtB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,kBAAkB,GAExB,OAAO,CAAC,GAAG,CAAC;IAiHf;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,mBAAmB;IAqC3B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IAGU,eAAe,CAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,kBAAkB,GAExB,OAAO,CAAC,GAAG,EAAE,CAAC;IA8JjB;;;;;;OAMG;cACa,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GACA,OAAO,CAAC;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IAgDF;;;;;;;;;;;;;;;;;;;;;;OAsBG;IAGU,UAAU,CACrB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,kBAAkB,GAExB,OAAO,CAAC,GAAG,CAAC;IAuCf;;;;;;;;;;;;OAYG;IACI,iBAAiB,IAAI,MAAM,EAAE;IAKpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACU,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC;IAOzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACU,QAAQ,CAAC,OAAO,EAAE;QAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,OAAO,CAAC;QACf,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACU,MAAM,CAAC,OAAO,EAAE;QAC3B,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,OAAO,CAAC;IAqEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACU,SAAS,CACpB,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;KACnB,GACL,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA+ChC;;;;;;;;;;;;;;;;;;OAkBG;IACU,MAAM,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3E;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACU,WAAW,CAAC,OAAO,EAAE;QAChC,KAAK,EAAE,MAAM,CAAC;QACd,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BnB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACU,kBAAkB,CAC7B,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,IAAI,CAAC;IAkJhB;;;;;;;;;;;;;;;;;OAiBG;IACU,YAAY,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IA8C3B;;;;;;;;;;;;;;OAcG;IACU,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IA4EnD;;;;;;;;;;;;OAYG;IACU,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;CAW9C"}

package/dist/object.js

@@ -3,7 +3,7 @@ import { DatabaseError, ErrorUtils, RuntimeError, SmrtError, TenantIsolationErro
 import { toSnakeCase } from "./utils/naming.js";
 import { runCascadeDelete } from "./cascade.js";
 import { broadcastCacheInvalidation, hasCrossProcessCacheInterest, invalidateCollectionCache, resolveDbCacheKey } from "./collection-cache.js";
-import { isEmbeddedDatabase, usesEmbeddedRevisionFallback, withEmbeddedWriteQueue, withEmbeddedWriteTransaction } from "./embedded-write-queue.js";
+import { isEmbeddedDatabase, isPostgresDatabase, usesEmbeddedRevisionFallback, withEmbeddedWriteQueue, withEmbeddedWriteTransaction } from "./embedded-write-queue.js";
 import { GlobalInterceptors, createInterceptorContext, resolveGetStringFilter } from "./interceptors.js";
 import { detectEngine } from "./schema/ddl/index.js";
 import { CHANGE_FEED_WAS_PERSISTED_KEY, recordInstanceChange } from "./change-feed.js";
@@ -11,6 +11,7 @@ import { SmrtClass } from "./class.js";
 import { EmbeddingProvider } from "./embeddings/provider.js";
 import { EmbeddingStorage } from "./embeddings/storage.js";
 import { ContentHasher } from "./embeddings/hash.js";
+import { postgresRevisionCondition } from "./revision-guard.js";
 import { verifyPersistenceTable } from "./schema/table-verifier.js";
 import { executeToolCall } from "./tools/tool-executor.js";
 import { fieldsFromClass, keysToSnakeCase, tableNameFromClass } from "./utils.js";
@@ -1177,7 +1178,7 @@ var SmrtObject = class SmrtObject extends SmrtClass {
 						}
 						const updateResult = useEmbeddedRevisionFallback ? await this.db.upsert(this.tableName, ["id"], data) : await this.db.update(this.tableName, {
 							id: data.id,
-							...revisionGuard !== void 0 ? { updated_at: this.revisionPredicateValue(revisionGuard) } : {}
+							...revisionGuard !== void 0 ? this.revisionPredicate(revisionGuard) : {}
 						}, updateData);
 						if (revisionGuard !== void 0 && updateResult.affected !== 1) {
 							revisionMatched = false;
@@ -1259,7 +1260,7 @@ var SmrtObject = class SmrtObject extends SmrtClass {
 				updated_at: updatedAt.toISOString()
 			}) : await this.db.update(this.tableName, {
 				id: this.id,
-				updated_at: this.revisionPredicateValue(expectedUpdatedAt)
+				...this.revisionPredicate(expectedUpdatedAt)
 			}, { updated_at: updatedAt.toISOString() });
 		});
 		if (!revisionMatched || result?.affected !== 1) throw new RuntimeError(`Revision conflict while claiming ${className}`, "RUNTIME_REVISION_CONFLICT", {
@@ -1287,6 +1288,31 @@ var SmrtObject = class SmrtObject extends SmrtClass {
 		};
 		await GlobalInterceptors.executeAfterSave(this, context);
 	}
+	/**
+	* Build the compare-and-swap condition that pins a guarded UPDATE or DELETE
+	* to the revision this writer loaded.
+	*
+	* PostgreSQL stores `updated_at` as `timestamp(6) WITHOUT time zone` and `pg`
+	* hydrates it in the process zone, so neither the precision nor the wall clock
+	* of a JavaScript `Date` survives the round trip. Exact string equality was
+	* therefore unsatisfiable for any row last written by raw SQL, and for every
+	* row on a non-UTC host, turning a lost-race guard into a permanent
+	* `RUNTIME_REVISION_CONFLICT` (#2620). See `revision-guard.ts` for how the
+	* PostgreSQL condition restores both correctness and lost-race semantics.
+	*
+	* The guarded `delete({ expectedUpdatedAt })` predicate is built here too:
+	* it bound the same exact equality into its final `DELETE`, so a microsecond
+	* or non-UTC row was permanently undeletable under a revision guard for the
+	* same reason.
+	*
+	* Other server dialects (remote LibSQL) store ISO text that round-trips
+	* exactly, and embedded engines never reach here — they take the
+	* compare/upsert fallback in {@link usesEmbeddedRevisionFallback}.
+	*/
+	revisionPredicate(revision) {
+		if (isPostgresDatabase(this.db)) return postgresRevisionCondition(revision);
+		return { updated_at: this.revisionPredicateValue(revision) };
+	}
 	revisionPredicateValue(revision) {
 		return revision instanceof Date ? revision.toISOString() : revision;
 	}
@@ -1804,16 +1830,38 @@ var SmrtObject = class SmrtObject extends SmrtClass {
 	*
 	* @see {@link foreignKey} for declaring `onDelete` on the referencing side
 	*/
-	async delete() {
+	async delete(options = {}) {
+		const className = this.getResolvedClassName();
+		const expectedUpdatedAt = options.expectedUpdatedAt;
+		if (expectedUpdatedAt !== void 0 && (!this._persisted || !this.id)) throw RuntimeError.invalidState("A revision-guarded delete requires a persisted object", { className });
 		const interceptorContext = createInterceptorContext(this.constructor.name, "delete");
 		await GlobalInterceptors.executeBeforeDelete(this, interceptorContext);
 		await this.runHook("beforeDelete");
 		await this.verifyStorageReady();
-		const { affectedTables, affectedTableClasses } = await withEmbeddedWriteQueue(this.db, isEmbeddedDatabase(this.db), () => runCascadeDelete(this.db, ObjectRegistry, {
-			className: this.getResolvedQualifiedName(),
-			tableName: this.tableName,
-			id: this.id
-		}, (db) => db.delete(this.tableName, { id: this.id }).then(() => void 0)));
+		const embeddedRevisionGuard = expectedUpdatedAt !== void 0 && usesEmbeddedRevisionFallback(this.db);
+		const { affectedTables, affectedTableClasses } = await withEmbeddedWriteQueue(this.db, isEmbeddedDatabase(this.db), async () => {
+			if (embeddedRevisionGuard) {
+				const current = await this.getCanonicalPersistedRow({ id: this.id });
+				if (!current || !this.revisionsEqual(current.updated_at, expectedUpdatedAt)) throw new RuntimeError(`Revision conflict while deleting ${className}`, "RUNTIME_REVISION_CONFLICT", {
+					className,
+					id: this.id
+				});
+			}
+			return runCascadeDelete(this.db, ObjectRegistry, {
+				className: this.getResolvedQualifiedName(),
+				tableName: this.tableName,
+				id: this.id
+			}, async (db) => {
+				const result = await db.delete(this.tableName, {
+					id: this.id,
+					...expectedUpdatedAt !== void 0 && !embeddedRevisionGuard ? this.revisionPredicate(expectedUpdatedAt) : {}
+				});
+				if (expectedUpdatedAt !== void 0 && result.affected !== 1) throw new RuntimeError(`Revision conflict while deleting ${className}`, "RUNTIME_REVISION_CONFLICT", {
+					className,
+					id: this.id
+				});
+			});
+		});
 		this._persisted = false;
 		this.invalidateCollectionReadCache();
 		for (const table of affectedTables) this.invalidateCollectionReadCache(table, affectedTableClasses.get(table));