sqlstack 3.5.0 → 3.6.0-dev.0

package/dist/esm/core/fileResolution.js.map

@@ -1 +1 @@
-{"version":3,"file":"fileResolution.js","sourceRoot":"","sources":["../../../src/core/fileResolution.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'fs';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport type { Dialect } from '../registry';\n\nconst DIALECT_EXT: Record<Dialect, string> = {\n  postgres: 'pg',\n  mysql: 'mysql',\n  sqlite: 'sqlite',\n};\n\nconst contentCache = new Map<string, string>();\nconst pathCache = new Map<string, string>();\n\nfunction key(root: string, method: string, dialect: Dialect): string {\n  return `${root}::${method}::${dialect}`;\n}\n\nexport function resolveSqlFromFs(rootDir: string, methodName: string, dialect: Dialect): { sql: string; tried: string[] } {\n  const k = key(rootDir, methodName, dialect);\n  const tried: string[] = [];\n  const ext = DIALECT_EXT[dialect];\n  const dialectPath = path.join(rootDir, `${methodName}.${ext}.sql`);\n  const genericPath = path.join(rootDir, `${methodName}.sql`);\n\n  // Cached path\n  let chosen = pathCache.get(k);\n  if (!chosen) {\n    if (fs.existsSync(dialectPath)) {\n      chosen = dialectPath;\n    } else if (fs.existsSync(genericPath)) {\n      chosen = genericPath;\n    }\n    if (chosen) pathCache.set(k, chosen);\n  }\n\n  if (!chosen) {\n    tried.push(dialectPath, genericPath);\n    throw new Error(\n      `sqlstack: SQL file not found for ${methodName}\\ntried: ${tried.join(\"\\n\")}`\n    );\n  }\n\n  // Cached content\n  let sql = contentCache.get(chosen);\n  if (!sql) {\n    sql = fs.readFileSync(chosen, 'utf8');\n    contentCache.set(chosen, sql);\n  }\n  return { sql, tried: [chosen] };\n}\n\nexport function coerceRootPath(input?: string): { rootDir?: string; from?: 'file' | 'folder' } {\n  if (!input) return {};\n  const stat = fs.existsSync(input) ? fs.statSync(input) : undefined;\n  if (stat?.isDirectory()) return { rootDir: input, from: 'folder' };\n  if (stat?.isFile()) return { rootDir: path.dirname(input), from: 'file' };\n  // If not found, treat as folder hint anyway\n  return { rootDir: input, from: 'folder' };\n}\n\nexport function guessDecoratorDir(): string | undefined {\n  const err = new Error();\n  const stack = (err.stack || '').split('\\n').slice(2);\n  const packageRoot = PACKAGE_ROOT_NORMALIZED;\n\n  // DEBUG: Uncomment to trace issues\n  // console.log('[guessDecoratorDir] packageRoot:', packageRoot);\n  // console.log('[guessDecoratorDir] stack:', stack.slice(0, 5));\n\n  for (const line of stack) {\n    const m = line.match(/\\((.*?):\\d+:\\d+\\)/) || line.match(/at (.*?):\\d+:\\d+/);\n    const file = m?.[1];\n    if (!file) continue;\n\n    const resolved = toAbsolutePath(file);\n    if (!resolved) continue;\n\n    // Skip frames from node_modules (including sqlstack itself when used as dependency)\n    if (resolved.includes('node_modules')) continue;\n\n    const normalized = safeNormalize(resolved);\n    if (!normalized) continue;\n\n    // Skip frames from sqlstack's own package (when running from source)\n    // Also skip if the path contains /sqlstack/ anywhere (linked package scenario)\n    if (packageRoot && normalized.startsWith(packageRoot)) {\n      continue;\n    }\n\n    // Additional check: skip if this is a sqlstack path (handles linked packages with relative paths)\n    if (isSqlstackPath(resolved)) {\n      continue;\n    }\n\n    // Return the first valid frame - this is where @Query is defined\n    return path.dirname(resolved);\n  }\n  return undefined;\n}\n\nfunction toAbsolutePath(file: string): string | undefined {\n  try {\n    if (file.startsWith('file://')) {\n      return fileURLToPath(file);\n    }\n    // Skip Node.js internal modules and bundler internals\n    if (file.startsWith('node:') || file.startsWith('webpack://')) {\n      return undefined;\n    }\n    if (!path.isAbsolute(file)) {\n      return path.resolve(file);\n    }\n    return file;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction ensureTrailingSep(p: string): string {\n  return p.endsWith(path.sep) ? p : p + path.sep;\n}\n\nfunction safeNormalize(p?: string): string | undefined {\n  if (!p) return undefined;\n  const normalized = path.normalize(p);\n  return process.platform === 'win32' ? normalized.toLowerCase() : normalized;\n}\n\n/**\n * Finds the package root from a starting directory by walking up to find package.json.\n * @internal Exported for testing\n */\nexport function findPackageRoot(startDir: string): string | undefined {\n  let current = startDir;\n  for (let i = 0; i < 6; i++) {\n    const candidate = path.join(current, 'package.json');\n    if (fs.existsSync(candidate)) {\n      const root = path.dirname(candidate);\n      const normalizedRoot = safeNormalize(root);\n      return normalizedRoot ? ensureTrailingSep(normalizedRoot) : ensureTrailingSep(root);\n    }\n    const parent = path.dirname(current);\n    if (parent === current) break;\n    current = parent;\n  }\n  return undefined;\n}\n\n/**\n * Detects if a path belongs to sqlstack package.\n * Handles both source paths (contains 'sqlstack') and node_modules paths.\n * @internal Exported for testing\n */\nexport function isSqlstackPath(filePath: string): boolean {\n  const normalized = filePath.toLowerCase();\n  // Check for source development path (e.g., /path/to/sqlstack/src/...)\n  if (normalized.includes(path.sep + 'sqlstack' + path.sep)) return true;\n  // Check for node_modules installation\n  if (normalized.includes('node_modules' + path.sep + 'sqlstack' + path.sep)) return true;\n  // Check for scoped package (@noego/sqlstack or similar)\n  if (normalized.includes('node_modules' + path.sep + '@') && normalized.includes('sqlstack' + path.sep)) return true;\n  return false;\n}\n\n/**\n * Extracts sqlstack's location from a stack trace.\n * Handles absolute paths, file:// URLs, and relative paths (Vitest uses relative paths).\n * @internal Exported for testing\n */\nexport function findSqlstackFromStack(stackString: string): string | undefined {\n  const lines = stackString.split('\\n');\n  for (const line of lines) {\n    const m = line.match(/\\((.*?):\\d+:\\d+\\)/) || line.match(/at (.*?):\\d+:\\d+/);\n    const file = m?.[1];\n    if (!file) continue;\n    try {\n      let resolved: string | undefined;\n      if (file.startsWith('file://')) {\n        resolved = fileURLToPath(file);\n      } else if (path.isAbsolute(file)) {\n        resolved = file;\n      } else if (!file.startsWith('node:') && !file.startsWith('webpack://')) {\n        // Relative path - resolve it (Vitest uses relative paths in stack traces)\n        resolved = path.resolve(file);\n      }\n      if (resolved && resolved.includes('fileResolution')) {\n        return path.dirname(resolved);\n      }\n    } catch {\n      // Skip invalid paths\n    }\n  }\n  return undefined;\n}\n\n/**\n * Computes the sqlstack package root directory.\n * Handles both CJS (__dirname) and ESM (stack trace) detection.\n * Validates that __dirname actually points to sqlstack (guards against Vitest injection).\n * @internal Exported for testing\n */\nexport function computePackageRoot(\n  dirnameValue: string | undefined,\n  filenameValue: string | undefined,\n  getStack: () => string\n): string | undefined {\n  const candidates: string[] = [];\n\n  // CJS: use __dirname/__filename, but validate they actually point to sqlstack\n  // (Vitest can inject __dirname incorrectly when transforming CJS modules)\n  if (typeof dirnameValue === 'string' && isSqlstackPath(dirnameValue)) {\n    candidates.push(dirnameValue);\n  }\n  if (typeof filenameValue === 'string' && isSqlstackPath(filenameValue)) {\n    candidates.push(path.dirname(filenameValue));\n  }\n\n  // ESM fallback or when __dirname was incorrectly injected: parse stack trace\n  if (candidates.length === 0) {\n    const stackDir = findSqlstackFromStack(getStack());\n    if (stackDir) {\n      candidates.push(stackDir);\n    }\n  }\n\n  // Find the package root from the first valid candidate\n  for (const base of candidates) {\n    const root = findPackageRoot(base);\n    if (root) return root;\n  }\n  return undefined;\n}\n\nconst PACKAGE_ROOT_NORMALIZED = computePackageRoot(\n  typeof __dirname === 'string' ? __dirname : undefined,\n  typeof __filename === 'string' ? __filename : undefined,\n  () => new Error().stack || ''\n);\n"]}
+{"version":3,"file":"fileResolution.js","sourceRoot":"","sources":["../../../src/core/fileResolution.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'fs';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport type { Dialect } from '../registry';\n\nconst DIALECT_EXT: Record<Dialect, string> = {\n  postgres: 'pg',\n  mysql: 'mysql',\n  sqlite: 'sqlite',\n};\n\nconst contentCache = new Map<string, string>();\nconst pathCache = new Map<string, string>();\n\nfunction key(root: string, method: string, dialect: Dialect): string {\n  return `${root}::${method}::${dialect}`;\n}\n\nexport function resolveSqlFromFs(rootDir: string, methodName: string, dialect: Dialect): { sql: string; tried: string[] } {\n  const k = key(rootDir, methodName, dialect);\n  const tried: string[] = [];\n  const ext = DIALECT_EXT[dialect];\n  const dialectPath = path.join(rootDir, `${methodName}.${ext}.sql`);\n  const genericPath = path.join(rootDir, `${methodName}.sql`);\n\n  // Cached path\n  let chosen = pathCache.get(k);\n  if (!chosen) {\n    if (fs.existsSync(dialectPath)) {\n      chosen = dialectPath;\n    } else if (fs.existsSync(genericPath)) {\n      chosen = genericPath;\n    }\n    if (chosen) pathCache.set(k, chosen);\n  }\n\n  if (!chosen) {\n    tried.push(dialectPath, genericPath);\n    throw new Error(\n      `sqlstack: SQL file not found for ${methodName}\\ntried: ${tried.join(\"\\n\")}`\n    );\n  }\n\n  // Cached content\n  let sql = contentCache.get(chosen);\n  if (!sql) {\n    sql = fs.readFileSync(chosen, 'utf8');\n    contentCache.set(chosen, sql);\n  }\n  return { sql, tried: [chosen] };\n}\n\nexport function coerceRootPath(input?: string): { rootDir?: string; from?: 'file' | 'folder' } {\n  if (!input) return {};\n  const stat = fs.existsSync(input) ? fs.statSync(input) : undefined;\n  if (stat?.isDirectory()) return { rootDir: input, from: 'folder' };\n  if (stat?.isFile()) return { rootDir: path.dirname(input), from: 'file' };\n  // If not found, treat as folder hint anyway\n  return { rootDir: input, from: 'folder' };\n}\n\nexport function guessDecoratorDir(): string | undefined {\n  const err = new Error();\n  const stack = (err.stack || '').split('\\n').slice(2);\n  const packageRoot = PACKAGE_ROOT_NORMALIZED;\n  const codeRoot = SQLSTACK_CODE_ROOT;\n\n  // DEBUG: Uncomment to trace issues\n  // console.log('[guessDecoratorDir] packageRoot:', packageRoot);\n  // console.log('[guessDecoratorDir] stack:', stack.slice(0, 5));\n\n  for (const line of stack) {\n    const m = line.match(/\\((.*?):\\d+:\\d+\\)/) || line.match(/at (.*?):\\d+:\\d+/);\n    const file = m?.[1];\n    if (!file) continue;\n\n    const resolved = toAbsolutePath(file);\n    if (!resolved) continue;\n\n    const normalized = safeNormalize(resolved);\n    if (!normalized) continue;\n\n    // Skip every node_modules frame (sqlstack as a dependency, decorator\n    // helpers such as reflect-metadata, test runners) and sqlstack's own\n    // src/ and dist/ under its package root (running from source or a linked\n    // checkout). A consumer module under a node_modules-free path that merely\n    // contains the word \"sqlstack\" — this package's own tests/fixtures — is\n    // a consumer and is NOT skipped.\n    if (normalized.includes(path.sep + 'node_modules' + path.sep)) continue;\n    if (packageRoot && isSqlstackCodePath(normalized, packageRoot)) continue;\n    // Filesystem-free: sqlstack's own code root (the directory holding\n    // core/, decorators/, …) as the STACK names it — the only reliable\n    // reference on hosts without fs (workerd) or with re-rooted trees.\n    if (codeRoot && normalized.startsWith(codeRoot)) continue;\n\n    // Return the first consumer frame - this is where @Query is applied\n    return path.dirname(resolved);\n  }\n  return undefined;\n}\n\nfunction isSqlstackCodePath(normalized: string, packageRoot: string): boolean {\n  const root = process.platform === 'win32' ? packageRoot.toLowerCase() : packageRoot;\n  return normalized.startsWith(root + 'src' + path.sep) || normalized.startsWith(root + 'dist' + path.sep);\n}\n\nfunction toAbsolutePath(file: string): string | undefined {\n  try {\n    if (file.startsWith('file://')) {\n      return fileURLToPath(file);\n    }\n    // Skip Node.js internal modules and bundler internals\n    if (file.startsWith('node:') || file.startsWith('webpack://')) {\n      return undefined;\n    }\n    if (!path.isAbsolute(file)) {\n      return path.resolve(file);\n    }\n    return file;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction ensureTrailingSep(p: string): string {\n  return p.endsWith(path.sep) ? p : p + path.sep;\n}\n\nfunction safeNormalize(p?: string): string | undefined {\n  if (!p) return undefined;\n  const normalized = path.normalize(p);\n  return process.platform === 'win32' ? normalized.toLowerCase() : normalized;\n}\n\n/**\n * Finds the package root from a starting directory by walking up to find package.json.\n * @internal Exported for testing\n */\nexport function findPackageRoot(startDir: string): string | undefined {\n  // The ESM build ships a nested dist/esm/package.json ({ type: module });\n  // keep walking past any package.json that is not sqlstack's own so the\n  // root is the real package directory (whose src/ and dist/ are skipped by\n  // guessDecoratorDir). The first package.json found is the fallback.\n  let current = startDir;\n  let fallback: string | undefined;\n  for (let i = 0; i < 8; i++) {\n    const candidate = path.join(current, 'package.json');\n    if (fs.existsSync(candidate)) {\n      const root = path.dirname(candidate);\n      const normalizedRoot = safeNormalize(root);\n      const asRoot = normalizedRoot ? ensureTrailingSep(normalizedRoot) : ensureTrailingSep(root);\n      if (packageNameOf(candidate) === 'sqlstack') return asRoot;\n      fallback ??= asRoot;\n    }\n    const parent = path.dirname(current);\n    if (parent === current) break;\n    current = parent;\n  }\n  return fallback;\n}\n\nfunction packageNameOf(packageJsonPath: string): string | undefined {\n  try {\n    return JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'))?.name;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Detects if a path belongs to sqlstack package.\n * Handles both source paths (contains 'sqlstack') and node_modules paths.\n * @internal Exported for testing\n */\nexport function isSqlstackPath(filePath: string): boolean {\n  const normalized = filePath.toLowerCase();\n  // Check for source development path (e.g., /path/to/sqlstack/src/...)\n  if (normalized.includes(path.sep + 'sqlstack' + path.sep)) return true;\n  // Check for node_modules installation\n  if (normalized.includes('node_modules' + path.sep + 'sqlstack' + path.sep)) return true;\n  // Check for scoped package (@noego/sqlstack or similar)\n  if (normalized.includes('node_modules' + path.sep + '@') && normalized.includes('sqlstack' + path.sep)) return true;\n  return false;\n}\n\n/**\n * Extracts sqlstack's location from a stack trace.\n * Handles absolute paths, file:// URLs, and relative paths (Vitest uses relative paths).\n * @internal Exported for testing\n */\nexport function findSqlstackFromStack(stackString: string): string | undefined {\n  const lines = stackString.split('\\n');\n  for (const line of lines) {\n    const m = line.match(/\\((.*?):\\d+:\\d+\\)/) || line.match(/at (.*?):\\d+:\\d+/);\n    const file = m?.[1];\n    if (!file) continue;\n    try {\n      let resolved: string | undefined;\n      if (file.startsWith('file://')) {\n        resolved = fileURLToPath(file);\n      } else if (path.isAbsolute(file)) {\n        resolved = file;\n      } else if (!file.startsWith('node:') && !file.startsWith('webpack://')) {\n        // Relative path - resolve it (Vitest uses relative paths in stack traces)\n        resolved = path.resolve(file);\n      }\n      if (resolved && resolved.includes('fileResolution')) {\n        return path.dirname(resolved);\n      }\n    } catch {\n      // Skip invalid paths\n    }\n  }\n  return undefined;\n}\n\n/**\n * Computes the sqlstack package root directory.\n * Handles both CJS (__dirname) and ESM (stack trace) detection.\n * Validates that __dirname actually points to sqlstack (guards against Vitest injection).\n * @internal Exported for testing\n */\nexport function computePackageRoot(\n  dirnameValue: string | undefined,\n  filenameValue: string | undefined,\n  getStack: () => string\n): string | undefined {\n  const candidates: string[] = [];\n\n  // CJS: use __dirname/__filename, but validate they actually point to sqlstack\n  // (Vitest can inject __dirname incorrectly when transforming CJS modules)\n  if (typeof dirnameValue === 'string' && isSqlstackPath(dirnameValue)) {\n    candidates.push(dirnameValue);\n  }\n  if (typeof filenameValue === 'string' && isSqlstackPath(filenameValue)) {\n    candidates.push(path.dirname(filenameValue));\n  }\n\n  // ESM fallback or when __dirname was incorrectly injected: parse stack trace\n  if (candidates.length === 0) {\n    const stackDir = findSqlstackFromStack(getStack());\n    if (stackDir) {\n      candidates.push(stackDir);\n    }\n  }\n\n  // Find the package root from the first valid candidate\n  for (const base of candidates) {\n    const root = findPackageRoot(base);\n    if (root) return root;\n  }\n  return undefined;\n}\n\nconst PACKAGE_ROOT_NORMALIZED = computePackageRoot(\n  typeof __dirname === 'string' ? __dirname : undefined,\n  typeof __filename === 'string' ? __filename : undefined,\n  () => new Error().stack || ''\n);\n\n/**\n * sqlstack's code root as the runtime names this module in stack traces:\n * the parent of this file's directory (`src/`, `dist/cjs/`, `dist/esm/`, or\n * a bundler's re-rooted copy). Needs no filesystem.\n * @internal Exported for testing\n */\nexport function computeCodeRoot(getStack: () => string): string | undefined {\n  const coreDir = findSqlstackFromStack(getStack());\n  if (!coreDir) return undefined;\n  const root = safeNormalize(path.dirname(coreDir));\n  return root ? ensureTrailingSep(root) : undefined;\n}\n\nconst SQLSTACK_CODE_ROOT = computeCodeRoot(() => new Error().stack || '');\n"]}

package/dist/esm/core/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/core/metadata.ts"],"names":[],"mappings":"AAAA,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAqBzC,MAAM,UAAU,OAAO,CAAC,MAAW;IACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAe,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAW,EAAE,IAAqB,EAAE,KAA4B;IAC9F,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAa,EAAE,IAAqB;IAClE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAS,EAAE,KAA2B;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAa;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC","sourcesContent":["const META = Symbol.for('sqlstack:meta');\n\nexport type MethodLabels = {\n  defaults?: Record<string, unknown>;\n  shape?: 'single' | 'only' | 'exist' | 'none';\n  validateSchema?: unknown;\n  source?: { kind: 'inline'; sql: string } | { kind: 'fs'; rootDir: string };\n  db?: string;\n  transform?: (row: any) => any;\n  page?: { size: number; zeroBase?: boolean };\n};\n\nexport type ClassLabels = {\n  db?: string;\n};\n\nexport type MetaShape = {\n  class?: ClassLabels;\n  methods: Record<string | symbol, MethodLabels>;\n};\n\nexport function getMeta(target: any): MetaShape {\n  if (!target[META]) {\n    target[META] = { methods: {} } as MetaShape;\n  }\n  return target[META];\n}\n\nexport function setMethodLabels(target: any, prop: string | symbol, patch: Partial<MethodLabels>) {\n  const meta = getMeta(target);\n  meta.methods[prop] = { ...(meta.methods[prop] || {}), ...patch };\n}\n\nexport function getMethodLabels(instance: any, prop: string | symbol): MethodLabels {\n  const meta = getMeta(Object.getPrototypeOf(instance));\n  return meta.methods[prop] || {};\n}\n\nexport function setClassLabels(ctor: any, patch: Partial<ClassLabels>) {\n  const meta = getMeta(ctor.prototype);\n  meta.class = { ...(meta.class || {}), ...patch };\n}\n\nexport function getClassLabels(instance: any): ClassLabels | undefined {\n  const meta = getMeta(Object.getPrototypeOf(instance));\n  return meta.class;\n}\n"]}
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/core/metadata.ts"],"names":[],"mappings":"AAAA,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAyBzC,MAAM,UAAU,OAAO,CAAC,MAAW;IACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAe,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAW,EAAE,IAAqB,EAAE,KAA4B;IAC9F,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAa,EAAE,IAAqB;IAClE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAS,EAAE,KAA2B;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAa;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC","sourcesContent":["const META = Symbol.for('sqlstack:meta');\n\nexport type MethodLabels = {\n  defaults?: Record<string, unknown>;\n  shape?: 'single' | 'only' | 'exist' | 'none';\n  validateSchema?: unknown;\n  source?:\n    | { kind: 'inline'; sql: string }\n    | { kind: 'fs'; rootDir: string }\n    /** Bare @Query(): the directory of the decorating module, read from the stack at decoration time. */\n    | { kind: 'guess'; dir: string };\n  db?: string;\n  transform?: (row: any) => any;\n  page?: { size: number; zeroBase?: boolean };\n};\n\nexport type ClassLabels = {\n  db?: string;\n};\n\nexport type MetaShape = {\n  class?: ClassLabels;\n  methods: Record<string | symbol, MethodLabels>;\n};\n\nexport function getMeta(target: any): MetaShape {\n  if (!target[META]) {\n    target[META] = { methods: {} } as MetaShape;\n  }\n  return target[META];\n}\n\nexport function setMethodLabels(target: any, prop: string | symbol, patch: Partial<MethodLabels>) {\n  const meta = getMeta(target);\n  meta.methods[prop] = { ...(meta.methods[prop] || {}), ...patch };\n}\n\nexport function getMethodLabels(instance: any, prop: string | symbol): MethodLabels {\n  const meta = getMeta(Object.getPrototypeOf(instance));\n  return meta.methods[prop] || {};\n}\n\nexport function setClassLabels(ctor: any, patch: Partial<ClassLabels>) {\n  const meta = getMeta(ctor.prototype);\n  meta.class = { ...(meta.class || {}), ...patch };\n}\n\nexport function getClassLabels(instance: any): ClassLabels | undefined {\n  const meta = getMeta(Object.getPrototypeOf(instance));\n  return meta.class;\n}\n"]}

package/dist/esm/core/resources.js

@@ -0,0 +1,91 @@
+const g = globalThis;
+if (!g.__SQLSTACK_RESOURCES_STATE__) {
+    g.__SQLSTACK_RESOURCES_STATE__ = {
+        resources: undefined,
+        byKey: new Map(),
+        byTail: new Map(),
+        lookups: new Map(),
+    };
+}
+const state = g.__SQLSTACK_RESOURCES_STATE__;
+const DIALECT_EXT = { postgres: 'pg', mysql: 'mysql', sqlite: 'sqlite' };
+/** Forward slashes, no `file://`, no leading `./`, exactly one leading `/`. */
+export function normalizeResourcePath(p) {
+    let s = p.replace(/\\/g, '/');
+    if (s.startsWith('file://'))
+        s = s.slice('file://'.length);
+    s = s.replace(/^(\.\/)+/, '');
+    s = s.replace(/^\/+/, '');
+    return '/' + s;
+}
+function tailOf(normalized) {
+    const parts = normalized.split('/');
+    return '/' + parts.slice(-2).join('/');
+}
+/** Install (or clear with undefined) the process-wide packaged SQL resources. */
+export function setResources(map) {
+    state.byKey = new Map();
+    state.byTail = new Map();
+    state.lookups = new Map();
+    state.resources = map;
+    if (!map)
+        return;
+    for (const [rawKey, sql] of Object.entries(map)) {
+        const key = normalizeResourcePath(rawKey);
+        state.byKey.set(key, sql);
+        const tail = tailOf(key);
+        const list = state.byTail.get(tail);
+        if (list)
+            list.push(key);
+        else
+            state.byTail.set(tail, [key]);
+    }
+}
+export function getResources() {
+    return state.resources;
+}
+/**
+ * Resolve one absolute (or module-tree) candidate path against the installed
+ * resources. Order: exact key; the longest key that is a path suffix of the
+ * candidate; the unique key sharing the candidate's `<folder>/<file>` tail.
+ */
+export function lookupResource(candidatePath) {
+    if (!state.resources)
+        return undefined;
+    const candidate = normalizeResourcePath(candidatePath);
+    if (state.lookups.has(candidate))
+        return state.lookups.get(candidate);
+    let found = state.byKey.get(candidate);
+    if (found === undefined) {
+        let bestLen = -1;
+        for (const [key, sql] of state.byKey) {
+            if (key.length > bestLen && candidate.endsWith(key)) {
+                found = sql;
+                bestLen = key.length;
+            }
+        }
+    }
+    if (found === undefined) {
+        const hits = state.byTail.get(tailOf(candidate));
+        if (hits && hits.length === 1)
+            found = state.byKey.get(hits[0]);
+    }
+    state.lookups.set(candidate, found);
+    return found;
+}
+/**
+ * Resolve a decorated method's SQL from the installed resources: the
+ * dialect-specific `<dir>/<method>.<ext>.sql` first, then `<dir>/<method>.sql`.
+ * Returns the tried candidate paths so a miss can be reported precisely.
+ */
+export function resolveSqlFromResources(dir, methodName, dialect) {
+    const base = normalizeResourcePath(dir).replace(/\/+$/, '');
+    const tried = [`${base}/${methodName}.${DIALECT_EXT[dialect]}.sql`, `${base}/${methodName}.sql`];
+    for (const candidate of tried) {
+        const sql = lookupResource(candidate);
+        if (sql !== undefined)
+            return { sql, tried };
+    }
+    return { sql: undefined, tried };
+}
+//# sourceMappingURL=resources.js.map

package/dist/esm/core/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../src/core/resources.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Dialect } from '../registry';\n\n/**\n * Packaged SQL resources: a path-keyed map `{ '<path>/<method>.sql': '<sql>' }`\n * installed by a bundled/packaged runtime (Electron asar, Cloudflare Worker,\n * @noego/app node runner) via `SqlStack.useResources(map)`.\n *\n * Keys are file paths — absolute, or relative to the project root (the shape\n * `import.meta.glob('/server/**\\/*.sql', { eager: true, query: '?raw' })`\n * produces). Lookups match by path suffix: the decorator's guessed directory\n * plus `<method>.sql` must END WITH a key. That makes the same map valid\n * whether modules load from `/repo/server/...`, `app.asar/out/server/...`\n * or a Worker's `modules/<project>/server/...` tree, as long as the module\n * tree is not flattened.\n */\nexport type SqlResources = Record<string, string>;\n\ntype ResourcesState = {\n  resources: SqlResources | undefined;\n  /** normalized key → sql */\n  byKey: Map<string, string>;\n  /** `<folder>/<file>` tail → normalized keys sharing that tail */\n  byTail: Map<string, string[]>;\n  lookups: Map<string, string | undefined>;\n};\n\nconst g = globalThis as any;\nif (!g.__SQLSTACK_RESOURCES_STATE__) {\n  g.__SQLSTACK_RESOURCES_STATE__ = {\n    resources: undefined,\n    byKey: new Map(),\n    byTail: new Map(),\n    lookups: new Map(),\n  } as ResourcesState;\n}\nconst state: ResourcesState = g.__SQLSTACK_RESOURCES_STATE__;\n\nconst DIALECT_EXT: Record<Dialect, string> = { postgres: 'pg', mysql: 'mysql', sqlite: 'sqlite' };\n\n/** Forward slashes, no `file://`, no leading `./`, exactly one leading `/`. */\nexport function normalizeResourcePath(p: string): string {\n  let s = p.replace(/\\\\/g, '/');\n  if (s.startsWith('file://')) s = s.slice('file://'.length);\n  s = s.replace(/^(\\.\\/)+/, '');\n  s = s.replace(/^\\/+/, '');\n  return '/' + s;\n}\n\nfunction tailOf(normalized: string): string {\n  const parts = normalized.split('/');\n  return '/' + parts.slice(-2).join('/');\n}\n\n/** Install (or clear with undefined) the process-wide packaged SQL resources. */\nexport function setResources(map: SqlResources | undefined): void {\n  state.byKey = new Map();\n  state.byTail = new Map();\n  state.lookups = new Map();\n  state.resources = map;\n  if (!map) return;\n  for (const [rawKey, sql] of Object.entries(map)) {\n    const key = normalizeResourcePath(rawKey);\n    state.byKey.set(key, sql);\n    const tail = tailOf(key);\n    const list = state.byTail.get(tail);\n    if (list) list.push(key);\n    else state.byTail.set(tail, [key]);\n  }\n}\n\nexport function getResources(): SqlResources | undefined {\n  return state.resources;\n}\n\n/**\n * Resolve one absolute (or module-tree) candidate path against the installed\n * resources. Order: exact key; the longest key that is a path suffix of the\n * candidate; the unique key sharing the candidate's `<folder>/<file>` tail.\n */\nexport function lookupResource(candidatePath: string): string | undefined {\n  if (!state.resources) return undefined;\n  const candidate = normalizeResourcePath(candidatePath);\n  if (state.lookups.has(candidate)) return state.lookups.get(candidate);\n  let found: string | undefined = state.byKey.get(candidate);\n  if (found === undefined) {\n    let bestLen = -1;\n    for (const [key, sql] of state.byKey) {\n      if (key.length > bestLen && candidate.endsWith(key)) {\n        found = sql;\n        bestLen = key.length;\n      }\n    }\n  }\n  if (found === undefined) {\n    const hits = state.byTail.get(tailOf(candidate));\n    if (hits && hits.length === 1) found = state.byKey.get(hits[0]);\n  }\n  state.lookups.set(candidate, found);\n  return found;\n}\n\n/**\n * Resolve a decorated method's SQL from the installed resources: the\n * dialect-specific `<dir>/<method>.<ext>.sql` first, then `<dir>/<method>.sql`.\n * Returns the tried candidate paths so a miss can be reported precisely.\n */\nexport function resolveSqlFromResources(\n  dir: string,\n  methodName: string,\n  dialect: Dialect\n): { sql: string | undefined; tried: string[] } {\n  const base = normalizeResourcePath(dir).replace(/\\/+$/, '');\n  const tried = [`${base}/${methodName}.${DIALECT_EXT[dialect]}.sql`, `${base}/${methodName}.sql`];\n  for (const candidate of tried) {\n    const sql = lookupResource(candidate);\n    if (sql !== undefined) return { sql, tried };\n  }\n  return { sql: undefined, tried };\n}\n"]}

package/dist/esm/core/sourceScanResolver.js

@@ -13,15 +13,15 @@ var _SourceScanResolver_inner;
 import { ManifestResolver } from './resolver.js';
 import { scanSqlManifestSync } from '../codegen/generateManifest.js';
 /**
- * Zero-config Node resolution for bare @Query(): lazily scans the project
- * tree (process.cwd(), or an explicit rootDir) for @Query classes and their
- * sibling .sql files, then answers Contract A lookups from the in-memory
- * manifest. The scan runs once, on the first bare-@Query execution.
+ * Opt-in Node resolution that scans a project tree (process.cwd(), or an
+ * explicit rootDir) for @Query classes and their sibling .sql files, then
+ * answers Contract A lookups from the in-memory manifest. The scan runs once
+ * per instance, on first resolve.
  *
- * This is the DEFAULT resolver — installed resolvers (per-root SqlStackConfig
- * or the deprecated global) always take precedence, and bundled runtimes
- * (Cloudflare Workers) never reach it because their entrypoints install a
- * ManifestResolver.
+ * This is NOT a default. Bare @Query() resolves its own module directory
+ * (stack guess at decoration time) against `SqlStack.useResources(...)` or
+ * the filesystem; nothing walks the tree unless this resolver is installed
+ * explicitly via `SqlStack.useResolver` / `SqlStackConfig.resolver`.
  */
 export class SourceScanResolver {
     constructor(rootDir) {
@@ -37,15 +37,4 @@ export class SourceScanResolver {
     }
 }
 _SourceScanResolver_inner = new WeakMap();
-let defaultInstance;
-/**
- * @internal Process-wide default used by the @Query call path when no
- * resolver is installed and the decorator captured no filesystem root.
- * Node-only: returns undefined where the filesystem is unavailable.
- */
-export function defaultSourceScanResolver() {
-    if (typeof process === 'undefined' || typeof process.cwd !== 'function')
-        return undefined;
-    return (defaultInstance ?? (defaultInstance = new SourceScanResolver()));
-}
 //# sourceMappingURL=sourceScanResolver.js.map

package/dist/esm/core/sourceScanResolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"sourceScanResolver.js","sourceRoot":"","sources":["../../../src/core/sourceScanResolver.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,kBAAkB;IAG7B,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;QAF7C,4CAAqC;IAEW,CAAC;IAEjD,OAAO,CAAC,OAA6B;QACnC,IAAI,CAAC,uBAAA,IAAI,iCAAO,EAAE,CAAC;YACjB,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACxE,uBAAA,IAAI,6BAAU,IAAI,gBAAgB,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,MAAA,CAAC;QAClE,CAAC;QACD,OAAO,uBAAA,IAAI,iCAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;CACF;;AAED,IAAI,eAA+C,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB;IACvC,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAC1F,OAAO,CAAC,eAAe,KAAf,eAAe,GAAK,IAAI,kBAAkB,EAAE,EAAC,CAAC;AACxD,CAAC","sourcesContent":["import type { SqlResolver, SqlResolutionRequest } from './resolver';\nimport { ManifestResolver } from './resolver';\nimport { scanSqlManifestSync } from '../codegen/generateManifest';\n\n/**\n * Zero-config Node resolution for bare @Query(): lazily scans the project\n * tree (process.cwd(), or an explicit rootDir) for @Query classes and their\n * sibling .sql files, then answers Contract A lookups from the in-memory\n * manifest. The scan runs once, on the first bare-@Query execution.\n *\n * This is the DEFAULT resolver — installed resolvers (per-root SqlStackConfig\n * or the deprecated global) always take precedence, and bundled runtimes\n * (Cloudflare Workers) never reach it because their entrypoints install a\n * ManifestResolver.\n */\nexport class SourceScanResolver implements SqlResolver {\n  #inner: ManifestResolver | undefined;\n\n  constructor(private readonly rootDir?: string) {}\n\n  resolve(request: SqlResolutionRequest): string | undefined {\n    if (!this.#inner) {\n      const { manifest } = scanSqlManifestSync(this.rootDir ?? process.cwd());\n      this.#inner = new ManifestResolver(manifest, { assert: false });\n    }\n    return this.#inner.resolve(request);\n  }\n}\n\nlet defaultInstance: SourceScanResolver | undefined;\n\n/**\n * @internal Process-wide default used by the @Query call path when no\n * resolver is installed and the decorator captured no filesystem root.\n * Node-only: returns undefined where the filesystem is unavailable.\n */\nexport function defaultSourceScanResolver(): SourceScanResolver | undefined {\n  if (typeof process === 'undefined' || typeof process.cwd !== 'function') return undefined;\n  return (defaultInstance ??= new SourceScanResolver());\n}\n"]}
+{"version":3,"file":"sourceScanResolver.js","sourceRoot":"","sources":["../../../src/core/sourceScanResolver.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,kBAAkB;IAG7B,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;QAF7C,4CAAqC;IAEW,CAAC;IAEjD,OAAO,CAAC,OAA6B;QACnC,IAAI,CAAC,uBAAA,IAAI,iCAAO,EAAE,CAAC;YACjB,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACxE,uBAAA,IAAI,6BAAU,IAAI,gBAAgB,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,MAAA,CAAC;QAClE,CAAC;QACD,OAAO,uBAAA,IAAI,iCAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;CACF","sourcesContent":["import type { SqlResolver, SqlResolutionRequest } from './resolver';\nimport { ManifestResolver } from './resolver';\nimport { scanSqlManifestSync } from '../codegen/generateManifest';\n\n/**\n * Opt-in Node resolution that scans a project tree (process.cwd(), or an\n * explicit rootDir) for @Query classes and their sibling .sql files, then\n * answers Contract A lookups from the in-memory manifest. The scan runs once\n * per instance, on first resolve.\n *\n * This is NOT a default. Bare @Query() resolves its own module directory\n * (stack guess at decoration time) against `SqlStack.useResources(...)` or\n * the filesystem; nothing walks the tree unless this resolver is installed\n * explicitly via `SqlStack.useResolver` / `SqlStackConfig.resolver`.\n */\nexport class SourceScanResolver implements SqlResolver {\n  #inner: ManifestResolver | undefined;\n\n  constructor(private readonly rootDir?: string) {}\n\n  resolve(request: SqlResolutionRequest): string | undefined {\n    if (!this.#inner) {\n      const { manifest } = scanSqlManifestSync(this.rootDir ?? process.cwd());\n      this.#inner = new ManifestResolver(manifest, { assert: false });\n    }\n    return this.#inner.resolve(request);\n  }\n}\n"]}

package/dist/esm/decorators/query.js

@@ -1,14 +1,14 @@
 import { getClassLabels, getMethodLabels, setMethodLabels } from '../core/metadata.js';
 import { SqlStackError, ExactlyOneRowError, NoRowsError, RowsExistError, DatabaseError, ExpectedRowsError } from '../core/errors.js';
 import { isValidationDisabled, validateOutput } from '../core/validator.js';
-import { resolveExecution, resolveSqlResolver } from '../runtime.js';
+import { resolveExecution, resolveSqlResolver, isRegisteredDatabaseName } from '../runtime.js';
 import { createSqliteBinder, createMysqlBinder, createPostgresBinder } from '../binders/sqlBinder.js';
-import { coerceRootPath, resolveSqlFromFs } from '../core/fileResolution.js';
-import { registerDecoratedMethod, recordQueryMethodOnClass } from '../core/resolver.js';
-import { defaultSourceScanResolver } from '../core/sourceScanResolver.js';
-import { getActiveTransaction } from '../transactions.js';
+import { coerceRootPath, resolveSqlFromFs, guessDecoratorDir } from '../core/fileResolution.js';
+import { registerDecoratedMethod, recordQueryMethodOnClass, getActiveResolver } from '../core/resolver.js';
+import { getResources, resolveSqlFromResources } from '../core/resources.js';
+import { getTransactionTarget } from '../transactions.js';
 import { SqlFragment, compileFragment } from '../sql.js';
-import { runStorage, resolveRunTarget, executeOnTarget, toRunError, fragmentText, } from '../run.js';
+import { runStorage, resolveRunTarget, executeOnTarget, toRunError, fragmentText, isRunDatabaseHandle, } from '../run.js';
 /**
  * Turn a method into a database query. The body calls `run(...)` (see `run`
  * for its forms); the wrapper resolves SQL, binds, executes, and applies the
@@ -36,14 +36,20 @@ export function Query(arg) {
             setMethodLabels(_target, prop, { source: { kind: 'inline', sql: options.sql } });
         }
         else {
-            // FS-based resolution: only an EXPLICIT path argument pins a directory.
-            // Bare @Query() resolves through the active resolver (or the default
-            // SourceScanResolver) — no stack-based directory guessing, which breaks
-            // under bundlers and test transforms.
+            // An EXPLICIT path argument pins a filesystem directory. Bare @Query()
+            // records the directory of the decorating module (first non-sqlstack
+            // stack frame at decoration time); at call time that directory is
+            // resolved against the packaged resources map when one is installed
+            // (SqlStack.useResources), else read from the filesystem. No tree scan.
             const { rootDir } = coerceRootPath(rootArg);
             if (rootDir) {
                 setMethodLabels(_target, prop, { source: { kind: 'fs', rootDir } });
             }
+            else {
+                const dir = guessDecoratorDir();
+                if (dir)
+                    setMethodLabels(_target, prop, { source: { kind: 'guess', dir } });
+            }
         }
         // Record for resolver coverage checks: immutable class metadata (the
         // canonical, environment-local source) plus the deprecated global list
@@ -80,26 +86,25 @@ export function Query(arg) {
                 }
                 const db = target.db;
                 const dialect = options?.dialect ?? db.dialect ?? 'sqlite';
-                // 3) load SQL source (inline, environment resolver, v1 fs fallback,
-                //    or the zero-config source scan — bare @Query() with nothing installed)
+                // 3) load SQL source: inline; else an installed resolver (the
+                //    instance's, else the process-global one — a build-time manifest
+                //    registered by a host runner applies even when the SqlStack itself
+                //    came from an IoC root); else the decorator's directory (explicit
+                //    path or guessed module dir) against the packaged resources /
+                //    filesystem.
+                const className = this?.constructor?.name ?? '<anonymous>';
+                const resolver = activeResolver ?? getActiveResolver();
                 const sql = labels?.source?.kind === 'inline'
                     ? labels.source.sql
-                    : activeResolver
-                        ? activeResolver.resolve({
-                            className: this?.constructor?.name ?? '<anonymous>',
-                            methodName: String(prop),
-                            dialect,
-                            rootDir: labels?.source?.kind === 'fs' ? labels.source.rootDir : undefined,
-                        })
-                        : labels?.source?.kind === 'fs'
-                            ? resolveSqlFromFs(labels.source.rootDir, String(prop), dialect).sql
-                            : defaultSourceScanResolver()?.resolve({
-                                className: this?.constructor?.name ?? '<anonymous>',
-                                methodName: String(prop),
-                                dialect,
-                            });
+                    : (resolver?.resolve({
+                        className,
+                        methodName: String(prop),
+                        dialect,
+                        rootDir: labels?.source?.kind === 'fs' ? labels.source.rootDir : undefined,
+                    }) ?? resolveSourceSql(labels?.source, className, String(prop), dialect));
                 if (!sql) {
-                    throw new SqlStackError(`No SQL source provided for method ${String(prop)}. Use @Query() with a file/folder path or inline sql.`);
+                    throw new SqlStackError(`No SQL source for ${className}.${String(prop)}: the decorating module's directory could not be ` +
+                        'determined from the stack. Use @Query() with a file/folder path or inline sql.');
                 }
                 onSql(sql);
                 // 4) bind placeholders
@@ -311,11 +316,43 @@ export function Query(arg) {
                 const resolved = await resolveExecution(dbName);
                 return {
                     db: resolved.entry.db,
-                    tx: getActiveTransaction(resolved.entry),
+                    tx: getTransactionTarget(resolved.entry),
                     resolver: resolved.resolver,
                     byName: true,
                 };
             };
+            // The method's own leading database argument: a handle (object with
+            // query()) or a registered database name. It selects run()'s target
+            // and is never bound as a value.
+            const leadingDb = async () => {
+                if (callArgs.length === 0)
+                    return undefined;
+                const first = callArgs[0];
+                if (isRunDatabaseHandle(first))
+                    return first;
+                if (typeof first === 'string' && first.length > 0 && (await isRegisteredDatabaseName(first)))
+                    return first;
+                return undefined;
+            };
+            // A database chosen by run's argument or the method's leading argument.
+            const explicitTarget = async (db) => {
+                const target = await resolveRunTarget(db);
+                // Inline SQL needs no resolver; only look one up for file-based SQL.
+                const resolver = target.byName
+                    ? target.resolver
+                    : labels?.source?.kind === 'inline'
+                        ? undefined
+                        : await resolveSqlResolver();
+                return { target, resolver };
+            };
+            // run() (and the legacy fallback): the method's arguments minus a
+            // leading database, on that database or the decorator context.
+            const executeDefault = async (onSql) => {
+                const lead = await leadingDb();
+                if (lead === undefined)
+                    return executeMethodSql(callArgs, undefined, onSql);
+                return executeMethodSql(callArgs.slice(1), await explicitTarget(lead), onSql);
+            };
             // run's argument-taking forms: return the adapter's raw result.
             const executeInvocation = async (invocation, onSql) => {
                 if (invocation.kind === 'fragment') {
@@ -327,17 +364,19 @@ export function Query(arg) {
                     onSql(boundSql);
                     return executeOnTarget(target, boundSql, params);
                 }
-                // run(db, params): the method's own SQL against db, bound from params
-                // only (an object for :named, an array for :argN).
-                const target = await resolveRunTarget(invocation.db);
-                // Inline SQL needs no resolver; only look one up for file-based SQL.
-                const resolver = target.byName
-                    ? target.resolver
-                    : labels?.source?.kind === 'inline'
-                        ? undefined
-                        : await resolveSqlResolver();
+                if (invocation.kind === 'db') {
+                    // run(db): the method's own SQL against db, bound from the method's
+                    // arguments minus a leading database argument.
+                    const lead = await leadingDb();
+                    const bindArgs = lead === undefined ? callArgs : callArgs.slice(1);
+                    return executeMethodSql(bindArgs, await explicitTarget(invocation.db), onSql);
+                }
+                // run(db, params) / run(params): the method's own SQL bound from params
+                // only (an object for :named, an array for :argN), against run's db,
+                // else the method's leading database, else the decorator context.
                 const bindArgs = Array.isArray(invocation.params) ? [...invocation.params] : [invocation.params];
-                return executeMethodSql(bindArgs, { target, resolver }, onSql);
+                const db = invocation.db ?? (await leadingDb());
+                return executeMethodSql(bindArgs, db !== undefined ? await explicitTarget(db) : undefined, onSql);
             };
             // The full pipeline: execute, then — if rows were returned
             // (SELECT/CTE/RETURNING) — shape + transform + validate; a write result
@@ -349,7 +388,7 @@ export function Query(arg) {
             // DatabaseError with the original error in `.cause`.
             const pipeline = async (invocation) => {
                 if (invocation === undefined || invocation.kind === 'default') {
-                    const out = await executeMethodSql(callArgs, undefined, () => { });
+                    const out = await executeDefault(() => { });
                     return finishResult(out, labels, this, prop);
                 }
                 let sqlText = invocation.kind === 'fragment' ? fragmentText(invocation.fragment) : '';
@@ -393,7 +432,7 @@ export function Query(arg) {
                 const db = entry.db;
                 let out;
                 try {
-                    const tx = getActiveTransaction(entry);
+                    const tx = getTransactionTarget(entry);
                     out = tx ? await tx.query(boundSql, params) : await db.query(boundSql, params);
                 }
                 catch (dbError) {
@@ -406,6 +445,28 @@ export function Query(arg) {
         return desc;
     };
 }
+// Directory-based SQL for a decorated method. An explicit @Query('<path>')
+// is always the filesystem. A bare @Query() uses the packaged resources map
+// when one is installed (bundled/packaged runtimes), else the filesystem next
+// to the decorating module (tests, plain Node). Misses name every key tried.
+function resolveSourceSql(source, className, methodName, dialect) {
+    if (!source || source.kind === 'inline')
+        return undefined;
+    if (source.kind === 'fs')
+        return resolveSqlFromFs(source.rootDir, methodName, dialect).sql;
+    const packaged = getResources();
+    const fromResources = packaged ? resolveSqlFromResources(source.dir, methodName, dialect) : undefined;
+    if (fromResources?.sql !== undefined)
+        return fromResources.sql;
+    try {
+        return resolveSqlFromFs(source.dir, methodName, dialect).sql;
+    }
+    catch (fsError) {
+        const triedResources = fromResources ? `\npackaged resources tried:\n${fromResources.tried.join('\n')}` : '';
+        throw new SqlStackError(`sqlstack: no SQL for ${className}.${methodName}.${triedResources}\n` +
+            `${fsError?.message ?? String(fsError)}`);
+    }
+}
 // Deprecated (removal in the next major version): a @Query body that RETURNS
 // an sql`` fragment. It only type-checks when the method's declared return
 // type is bent to admit SqlFragment (an `as any`-style hole). One warning per