sqlstack 1.0.25 → 3.0.0

package/dist/esm/core/resolver.js

@@ -0,0 +1,132 @@
+import { resolveSqlFromFs } from './fileResolution.js';
+/**
+ * Dialect → manifest key suffix. Mirrors the on-disk file convention
+ * (`findByEmail.pg.sql` → key `UsersRepo.findByEmail.pg`).
+ */
+export const MANIFEST_DIALECT_EXT = {
+    postgres: 'pg',
+    mysql: 'mysql',
+    sqlite: 'sqlite',
+};
+/**
+ * Node filesystem resolution — the v1 behavior, unchanged: dialect-specific
+ * `<method>.<ext>.sql` first, then generic `<method>.sql`, from the rootDir
+ * the decorator captured (explicit argument or stack-based directory guess).
+ */
+export class FsResolver {
+    resolve({ rootDir, methodName, dialect }) {
+        if (!rootDir)
+            return undefined;
+        return resolveSqlFromFs(rootDir, methodName, dialect).sql;
+    }
+}
+/**
+ * Build-time manifest resolution — bundling-proof (Cloudflare Workers).
+ * Lookup order per Contract A:
+ *   1. `${className}.${methodName}.${dialectExt}`
+ *   2. `${className}.${methodName}`            (generic fallback)
+ */
+export class ManifestResolver {
+    constructor(manifest, options = {}) {
+        this.manifest = manifest;
+        this.options = options;
+    }
+    resolve({ className, methodName, dialect }) {
+        const ext = MANIFEST_DIALECT_EXT[dialect];
+        return (this.manifest[`${className}.${methodName}.${ext}`] ??
+            this.manifest[`${className}.${methodName}`]);
+    }
+    /** True when the manifest has a generic or any dialect-specific entry. */
+    hasEntryFor(className, methodName) {
+        const generic = `${className}.${methodName}`;
+        if (generic in this.manifest)
+            return true;
+        return Object.values(MANIFEST_DIALECT_EXT).some((ext) => `${generic}.${ext}` in this.manifest);
+    }
+}
+// Immutable per-class record of @Query-decorated methods, written at
+// class-definition time onto the prototype. Unlike the process-global list
+// below, this cannot be polluted by unrelated imports/tests: coverage checks
+// derive from the classes explicitly supplied to them (repo spec 19 §10).
+const QUERY_METHODS = Symbol.for('sqlstack:queryMethods');
+/** @internal Called by the @Query decorator at class-definition time. */
+export function recordQueryMethodOnClass(proto, entry) {
+    if (!Object.prototype.hasOwnProperty.call(proto, QUERY_METHODS)) {
+        Object.defineProperty(proto, QUERY_METHODS, { value: [], enumerable: false });
+    }
+    proto[QUERY_METHODS].push(entry);
+}
+/** @Query-decorated methods declared by the given classes (own + inherited). */
+export function queryMethodsOf(classes) {
+    const out = [];
+    for (const cls of classes) {
+        let proto = cls.prototype;
+        while (proto && proto !== Object.prototype) {
+            if (Object.prototype.hasOwnProperty.call(proto, QUERY_METHODS)) {
+                out.push(...proto[QUERY_METHODS]);
+            }
+            proto = Object.getPrototypeOf(proto);
+        }
+    }
+    return out;
+}
+// Single shared state across module copies (same pattern as SqlStackDB).
+const g = globalThis;
+if (!g.__SQLSTACK_RESOLVER_STATE__) {
+    g.__SQLSTACK_RESOLVER_STATE__ = { resolver: undefined, decorated: [] };
+}
+const state = g.__SQLSTACK_RESOLVER_STATE__;
+/** @internal Called by the @Query decorator at class-definition time. */
+export function registerDecoratedMethod(entry) {
+    state.decorated.push(entry);
+}
+/** @internal Read by the @Query call path. */
+export function getActiveResolver() {
+    return state.resolver;
+}
+function assertMissing(resolver, decorated) {
+    const missing = decorated
+        .filter((m) => !m.inline)
+        .filter((m) => !resolver.hasEntryFor(m.className, m.methodName))
+        .map((m) => `${m.className}.${m.methodName}`);
+    if (missing.length) {
+        throw new Error('sqlstack: ManifestResolver has no SQL for these @Query methods:\n' +
+            missing.map((k) => `  - ${k}`).join('\n') +
+            '\nRegenerate the manifest (see docs/codegen.md), or pass ' +
+            '{ assert: false } if these methods return a SqlFragment from their body.');
+    }
+}
+/**
+ * Environment-local manifest coverage check: validates only the explicitly
+ * supplied classes, from their immutable class metadata. Deterministic
+ * regardless of what else the process happened to import.
+ */
+export function assertManifestCoversClasses(resolver, classes) {
+    assertMissing(resolver, queryMethodsOf(classes));
+}
+/**
+ * @deprecated Process-global resolver registration (legacy v2 surface,
+ * previously `SqlStack.useResolver(...)`). The canonical path is a per-root
+ * resolver on the SqlStack instance (see src/stack.ts); this global is only
+ * consulted when no IoC environment is active. Reached via the deprecated
+ * static `SqlStack.useResolver(...)` forwards during migration.
+ */
+export function setGlobalResolver(resolver) {
+    if (resolver instanceof ManifestResolver && resolver.options.assert !== false) {
+        assertMissing(resolver, state.decorated);
+    }
+    state.resolver = resolver;
+}
+/** @deprecated See setGlobalResolver. */
+export function clearGlobalResolver() {
+    state.resolver = undefined;
+}
+/**
+ * @internal
+ * @deprecated Coverage check against the process-global decorated list; the
+ * canonical path is assertManifestCoversClasses with an explicit catalog.
+ */
+export function assertManifestCoverage(resolver) {
+    assertMissing(resolver, state.decorated);
+}
+//# sourceMappingURL=resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../src/core/resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Dialect } from '../registry';\nimport { resolveSqlFromFs } from './fileResolution';\n\n/**\n * Dialect → manifest key suffix. Mirrors the on-disk file convention\n * (`findByEmail.pg.sql` → key `UsersRepo.findByEmail.pg`).\n */\nexport const MANIFEST_DIALECT_EXT: Record<Dialect, string> = {\n  postgres: 'pg',\n  mysql: 'mysql',\n  sqlite: 'sqlite',\n};\n\n/**\n * Generated SQL manifest shape (see docs/resolver_architecture.md, Contract A):\n *   { '<ClassName>.<methodName>.<dialectExt>': '<sql>', '<ClassName>.<methodName>': '<sql>' }\n */\nexport type SqlManifest = Record<string, string>;\n\nexport type SqlResolutionRequest = {\n  className: string;\n  methodName: string;\n  dialect: Dialect;\n  /** Present when the @Query decorator resolved a filesystem root (Node only). */\n  rootDir?: string;\n};\n\n/**\n * Strategy for turning a decorated @Query method into a SQL string.\n * The public @Query API is identical under every resolver.\n */\nexport interface SqlResolver {\n  /** Return the SQL for the request, or undefined when this resolver has none. */\n  resolve(request: SqlResolutionRequest): string | undefined;\n}\n\n/**\n * Node filesystem resolution — the v1 behavior, unchanged: dialect-specific\n * `<method>.<ext>.sql` first, then generic `<method>.sql`, from the rootDir\n * the decorator captured (explicit argument or stack-based directory guess).\n */\nexport class FsResolver implements SqlResolver {\n  resolve({ rootDir, methodName, dialect }: SqlResolutionRequest): string | undefined {\n    if (!rootDir) return undefined;\n    return resolveSqlFromFs(rootDir, methodName, dialect).sql;\n  }\n}\n\nexport type ManifestResolverOptions = {\n  /**\n   * Validate at registration time that every decorated @Query method has a\n   * manifest entry (fail fast, earlier than v1's lazy fs lookup).\n   * Default true. Set false when some @Query methods build their SQL by\n   * returning a SqlFragment from the method body — those never consult the\n   * manifest and cannot be distinguished statically.\n   */\n  assert?: boolean;\n};\n\n/**\n * Build-time manifest resolution — bundling-proof (Cloudflare Workers).\n * Lookup order per Contract A:\n *   1. `${className}.${methodName}.${dialectExt}`\n *   2. `${className}.${methodName}`            (generic fallback)\n */\nexport class ManifestResolver implements SqlResolver {\n  constructor(\n    private readonly manifest: SqlManifest,\n    readonly options: ManifestResolverOptions = {}\n  ) {}\n\n  resolve({ className, methodName, dialect }: SqlResolutionRequest): string | undefined {\n    const ext = MANIFEST_DIALECT_EXT[dialect];\n    return (\n      this.manifest[`${className}.${methodName}.${ext}`] ??\n      this.manifest[`${className}.${methodName}`]\n    );\n  }\n\n  /** True when the manifest has a generic or any dialect-specific entry. */\n  hasEntryFor(className: string, methodName: string): boolean {\n    const generic = `${className}.${methodName}`;\n    if (generic in this.manifest) return true;\n    return Object.values(MANIFEST_DIALECT_EXT).some((ext) => `${generic}.${ext}` in this.manifest);\n  }\n}\n\nexport type DecoratedMethod = { className: string; methodName: string; inline: boolean };\n\n// Immutable per-class record of @Query-decorated methods, written at\n// class-definition time onto the prototype. Unlike the process-global list\n// below, this cannot be polluted by unrelated imports/tests: coverage checks\n// derive from the classes explicitly supplied to them (repo spec 19 §10).\nconst QUERY_METHODS = Symbol.for('sqlstack:queryMethods');\n\n/** @internal Called by the @Query decorator at class-definition time. */\nexport function recordQueryMethodOnClass(proto: any, entry: DecoratedMethod): void {\n  if (!Object.prototype.hasOwnProperty.call(proto, QUERY_METHODS)) {\n    Object.defineProperty(proto, QUERY_METHODS, { value: [], enumerable: false });\n  }\n  proto[QUERY_METHODS].push(entry);\n}\n\n/** @Query-decorated methods declared by the given classes (own + inherited). */\nexport function queryMethodsOf(classes: ReadonlyArray<abstract new (...args: any[]) => any>): DecoratedMethod[] {\n  const out: DecoratedMethod[] = [];\n  for (const cls of classes) {\n    let proto = cls.prototype;\n    while (proto && proto !== Object.prototype) {\n      if (Object.prototype.hasOwnProperty.call(proto, QUERY_METHODS)) {\n        out.push(...proto[QUERY_METHODS]);\n      }\n      proto = Object.getPrototypeOf(proto);\n    }\n  }\n  return out;\n}\n\ntype ResolverState = {\n  resolver: SqlResolver | undefined;\n  decorated: DecoratedMethod[];\n};\n\n// Single shared state across module copies (same pattern as SqlStackDB).\nconst g = globalThis as any;\nif (!g.__SQLSTACK_RESOLVER_STATE__) {\n  g.__SQLSTACK_RESOLVER_STATE__ = { resolver: undefined, decorated: [] } as ResolverState;\n}\nconst state: ResolverState = g.__SQLSTACK_RESOLVER_STATE__;\n\n/** @internal Called by the @Query decorator at class-definition time. */\nexport function registerDecoratedMethod(entry: DecoratedMethod): void {\n  state.decorated.push(entry);\n}\n\n/** @internal Read by the @Query call path. */\nexport function getActiveResolver(): SqlResolver | undefined {\n  return state.resolver;\n}\n\nfunction assertMissing(resolver: ManifestResolver, decorated: DecoratedMethod[]): void {\n  const missing = decorated\n    .filter((m) => !m.inline)\n    .filter((m) => !resolver.hasEntryFor(m.className, m.methodName))\n    .map((m) => `${m.className}.${m.methodName}`);\n  if (missing.length) {\n    throw new Error(\n      'sqlstack: ManifestResolver has no SQL for these @Query methods:\\n' +\n        missing.map((k) => `  - ${k}`).join('\\n') +\n        '\\nRegenerate the manifest (see docs/codegen.md), or pass ' +\n        '{ assert: false } if these methods return a SqlFragment from their body.'\n    );\n  }\n}\n\n/**\n * Environment-local manifest coverage check: validates only the explicitly\n * supplied classes, from their immutable class metadata. Deterministic\n * regardless of what else the process happened to import.\n */\nexport function assertManifestCoversClasses(\n  resolver: ManifestResolver,\n  classes: ReadonlyArray<abstract new (...args: any[]) => any>\n): void {\n  assertMissing(resolver, queryMethodsOf(classes));\n}\n\n/**\n * @deprecated Process-global resolver registration (legacy v2 surface,\n * previously `SqlStack.useResolver(...)`). The canonical path is a per-root\n * resolver on the SqlStack instance (see src/stack.ts); this global is only\n * consulted when no IoC environment is active. Reached via the deprecated\n * static `SqlStack.useResolver(...)` forwards during migration.\n */\nexport function setGlobalResolver(resolver: SqlResolver): void {\n  if (resolver instanceof ManifestResolver && resolver.options.assert !== false) {\n    assertMissing(resolver, state.decorated);\n  }\n  state.resolver = resolver;\n}\n\n/** @deprecated See setGlobalResolver. */\nexport function clearGlobalResolver(): void {\n  state.resolver = undefined;\n}\n\n/**\n * @internal\n * @deprecated Coverage check against the process-global decorated list; the\n * canonical path is assertManifestCoversClasses with an explicit catalog.\n */\nexport function assertManifestCoverage(resolver: ManifestResolver): void {\n  assertMissing(resolver, state.decorated);\n}\n"]}

package/dist/esm/core/sourceScanResolver.js

@@ -0,0 +1,51 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+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.
+ *
+ * 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.
+ */
+export class SourceScanResolver {
+    constructor(rootDir) {
+        this.rootDir = rootDir;
+        _SourceScanResolver_inner.set(this, void 0);
+    }
+    resolve(request) {
+        if (!__classPrivateFieldGet(this, _SourceScanResolver_inner, "f")) {
+            const { manifest } = scanSqlManifestSync(this.rootDir ?? process.cwd());
+            __classPrivateFieldSet(this, _SourceScanResolver_inner, new ManifestResolver(manifest, { assert: false }), "f");
+        }
+        return __classPrivateFieldGet(this, _SourceScanResolver_inner, "f").resolve(request);
+    }
+}
+_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

@@ -0,0 +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"]}

package/dist/esm/decorators/query.js

@@ -1,9 +1,11 @@
 import { getClassLabels, getMethodLabels, setMethodLabels } from '../core/metadata.js';
 import { SqlStackError, ExactlyOneRowError, NoRowsError, RowsExistError, DatabaseError } from '../core/errors.js';
 import { isValidationDisabled, validateOutput } from '../core/validator.js';
-import { SqlStackDB } from '../registry.js';
+import { resolveExecution } from '../runtime.js';
 import { createSqliteBinder, createMysqlBinder, createPostgresBinder } from '../binders/sqlBinder.js';
-import { coerceRootPath, guessDecoratorDir, resolveSqlFromFs } from '../core/fileResolution.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 { SqlFragment } from '../sql.js';
 export function Query(arg) {
@@ -19,13 +21,25 @@ export function Query(arg) {
             setMethodLabels(_target, prop, { source: { kind: 'inline', sql: options.sql } });
         }
         else {
-            // FS-based resolution
+            // 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.
             const { rootDir } = coerceRootPath(rootArg);
-            const dir = rootDir ?? guessDecoratorDir();
-            if (dir) {
-                setMethodLabels(_target, prop, { source: { kind: 'fs', rootDir: dir } });
+            if (rootDir) {
+                setMethodLabels(_target, prop, { source: { kind: 'fs', rootDir } });
             }
         }
+        // Record for resolver coverage checks: immutable class metadata (the
+        // canonical, environment-local source) plus the deprecated global list
+        // consulted by the legacy global-resolver path.
+        const decoratedEntry = {
+            className: _target?.constructor?.name ?? '<anonymous>',
+            methodName: String(prop),
+            inline: !!options?.sql,
+        };
+        recordQueryMethodOnClass(_target, decoratedEntry);
+        registerDecoratedMethod(decoratedEntry);
         const original = desc.value;
         desc.value = async function (...callArgs) {
             const labels = getMethodLabels(this, prop);
@@ -42,10 +56,11 @@ export function Query(arg) {
             if (fragmentResult instanceof SqlFragment) {
                 const { sql: boundSql, params } = fragmentResult.toSQL();
                 const dbName = labels.db ?? options?.db ?? classLabels?.db;
-                const { name: resolvedDbName, db } = SqlStackDB.getEntry(dbName);
+                const { entry } = await resolveExecution(dbName);
+                const db = entry.db;
                 let out;
                 try {
-                    const tx = getActiveTransaction(resolvedDbName);
+                    const tx = getActiveTransaction(entry);
                     out = tx ? await tx.query(boundSql, params) : await db.query(boundSql, params);
                 }
                 catch (dbError) {
@@ -69,16 +84,29 @@ export function Query(arg) {
             }
             // 1) prepare args with defaults
             const rawInput = callArgs.length === 1 ? callArgs[0] : callArgs; // object or positional array
-            // 2) choose database and dialect
+            // 2) choose database and dialect via the active environment
             const dbName = labels.db ?? options?.db ?? classLabels?.db;
-            const { name: resolvedDbName, db } = SqlStackDB.getEntry(dbName);
+            const { entry, resolver: activeResolver } = await resolveExecution(dbName);
+            const db = entry.db;
             const dialect = options?.dialect ?? db.dialect ?? 'sqlite';
-            // 3) load SQL source (inline or fs)
+            // 3) load SQL source (inline, environment resolver, v1 fs fallback,
+            //    or the zero-config source scan — bare @Query() with nothing installed)
             const sql = labels?.source?.kind === 'inline'
                 ? labels.source.sql
-                : labels?.source?.kind === 'fs'
-                    ? resolveSqlFromFs(labels.source.rootDir, String(prop), dialect).sql
-                    : undefined;
+                : 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,
+                        });
             if (!sql) {
                 throw new SqlStackError(`No SQL source provided for method ${String(prop)}. Use @Query() with a file/folder path or inline sql.`);
             }
@@ -266,7 +294,7 @@ export function Query(arg) {
             // 5) execute query via registry DB
             let out;
             try {
-                const tx = getActiveTransaction(resolvedDbName);
+                const tx = getActiveTransaction(entry);
                 out = tx ? await tx.query(boundSql, params) : await db.query(boundSql, params);
             }
             catch (dbError) {

package/dist/esm/decorators/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/decorators/query.ts"],"names":[],"mappings":"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","sourcesContent":["import { getClassLabels, getMethodLabels, setMethodLabels } from '../core/metadata';\nimport { SqlStackError, ExactlyOneRowError, NoRowsError, RowsExistError, DatabaseError } from '../core/errors';\nimport { isValidationDisabled, validateOutput } from '../core/validator';\nimport { SqlStackDB } from '../registry';\nimport { createSqliteBinder, createMysqlBinder, createPostgresBinder } from '../binders/sqlBinder';\nimport { coerceRootPath, guessDecoratorDir, resolveSqlFromFs } from '../core/fileResolution';\nimport { getActiveTransaction } from '../transactions';\nimport { SqlFragment } from '../sql';\n\ntype QueryOptions = {\n  sql?: string; // optional inline SQL for testing; otherwise, future: load from file\n  db?: string;  // optional override DB name\n  dialect?: 'sqlite' | 'mysql' | 'postgres';\n};\n\nexport function Query(arg?: string | QueryOptions) {\n  return function (_target: any, prop: string | symbol, desc: PropertyDescriptor) {\n    const options: QueryOptions | undefined = typeof arg === 'string' ? undefined : arg;\n    const rootArg: string | undefined = typeof arg === 'string' ? arg : undefined;\n    // Store method-level db override if provided\n    if (options?.db) {\n      setMethodLabels(_target, prop, { db: options.db });\n    }\n    // Store inline SQL if provided\n    if (options?.sql) {\n      setMethodLabels(_target, prop, { source: { kind: 'inline', sql: options.sql } });\n    } else {\n      // FS-based resolution\n      const { rootDir } = coerceRootPath(rootArg);\n      const dir = rootDir ?? guessDecoratorDir();\n      if (dir) {\n        setMethodLabels(_target, prop, { source: { kind: 'fs', rootDir: dir } });\n      }\n    }\n\n    const original = desc.value;\n    desc.value = async function (...callArgs: any[]) {\n      const labels = getMethodLabels(this, prop);\n      const classLabels = getClassLabels(this);\n\n      // 0) Check if the method body returns a SqlFragment (template literal path)\n      let fragmentResult: unknown;\n      try {\n        fragmentResult = await original.apply(this, callArgs);\n      } catch {\n        // Method body threw (e.g. placeholder `throw new Error('replaced')`) — fall through to file/inline SQL\n        fragmentResult = undefined;\n      }\n      if (fragmentResult instanceof SqlFragment) {\n        const { sql: boundSql, params } = fragmentResult.toSQL();\n\n        const dbName = labels.db ?? options?.db ?? classLabels?.db;\n        const { name: resolvedDbName, db } = SqlStackDB.getEntry(dbName);\n\n        let out;\n        try {\n          const tx = getActiveTransaction(resolvedDbName);\n          out = tx ? await tx.query(boundSql, params) : await db.query(boundSql, params);\n        } catch (dbError: any) {\n          throw new DatabaseError(\n            dbError?.message || String(dbError),\n            boundSql,\n            dbError instanceof Error ? dbError : undefined\n          );\n        }\n\n        if (Array.isArray(out)) {\n          const shaped = applyShape(out, labels.shape);\n          const transformed = labels.transform ? labels.transform(shaped) : shaped;\n\n          if (labels.validateSchema && !isValidationDisabled()) {\n            if (Array.isArray(transformed)) {\n              for (const row of transformed) validateOutput(labels.validateSchema, row);\n            } else if (transformed !== null && transformed !== undefined) {\n              validateOutput(labels.validateSchema, transformed);\n            }\n          }\n          return transformed;\n        }\n        return out;\n      }\n\n      // 1) prepare args with defaults\n      const rawInput = callArgs.length === 1 ? callArgs[0] : callArgs; // object or positional array\n\n      // 2) choose database and dialect\n      const dbName = labels.db ?? options?.db ?? classLabels?.db;\n      const { name: resolvedDbName, db } = SqlStackDB.getEntry(dbName);\n      const dialect = options?.dialect ?? db.dialect ?? 'sqlite';\n\n      // 3) load SQL source (inline or fs)\n      const sql = labels?.source?.kind === 'inline'\n        ? labels.source.sql\n        : labels?.source?.kind === 'fs'\n          ? resolveSqlFromFs(labels.source.rootDir, String(prop), dialect).sql\n          : undefined;\n      if (!sql) {\n        throw new SqlStackError(`No SQL source provided for method ${String(prop)}. Use @Query() with a file/folder path or inline sql.`);\n      }\n\n      // 4) bind placeholders\n      // Decide argument mode: positional if SQL contains :argN\n      let workingSql = sql;\n      const hasPositional = /:arg[1-9][0-9]*/.test(workingSql);\n\n      // Prepare args for binder\n      let args: any;\n      if (hasPositional) {\n        args = callArgs;\n      } else {\n        const namedBase = callArgs.length > 0 ? callArgs[0] : undefined;\n        args = applyDefaults(labels.defaults, namedBase ?? {});\n      }\n\n      // Compute paging and inject :offset/:limit (named mode) or rewrite to positional\n      const pageCfg = labels.page;\n      if (pageCfg) {\n        const { size, zeroBase } = pageCfg;\n        const base = zeroBase ? 0 : 1;\n\n        // Extract page number from input (object) or a trailing options object in positional mode\n        const pageFromObject = (val: any): number | undefined => {\n          if (val && typeof val === 'object' && !Array.isArray(val) && typeof (val as any).page !== 'undefined') {\n            const p = (val as any).page;\n            if (typeof p === 'number' && isFinite(p)) return p;\n          }\n          return undefined;\n        };\n\n        let pageNum: number | undefined;\n        if (hasPositional) {\n          // Variadic-style: only the LAST argument may carry `{ page }`\n          if (callArgs.length > 0) {\n            const last = callArgs[callArgs.length - 1];\n            pageNum = pageFromObject(last);\n          }\n        } else {\n          // Prefer last-arg options if provided; otherwise read from named object\n          if (callArgs.length > 1) {\n            const last = callArgs[callArgs.length - 1];\n            pageNum = pageFromObject(last);\n          }\n          if (pageNum === undefined) {\n            pageNum = pageFromObject(args);\n          }\n        }\n\n        const effectivePage = typeof pageNum === 'number' ? pageNum : base;\n        const offset = (effectivePage - base) * size;\n        const limit = size;\n\n        if (hasPositional) {\n          // Replace occurrences of :offset and :limit with new :argN tokens appended to args\n          const baseIndex = callArgs.length; // start numbering after user args\n          let nextIndex = baseIndex + 1;\n          const additions: unknown[] = [];\n\n          const rewrite = (sqlText: string) => {\n            const out: string[] = [];\n            let i = 0;\n            let inSQ = false, inDQ = false, inLC = false, inBC = false;\n            const len = sqlText.length;\n            while (i < len) {\n              const ch = sqlText[i];\n              const next = i + 1 < len ? sqlText[i + 1] : '';\n              if (inLC) { out.push(ch); if (ch === '\\n') inLC = false; i++; continue; }\n              if (inBC) { out.push(ch); if (ch === '*' && next === '/') { out.push(next); i++; inBC = false; } i++; continue; }\n              if (inSQ) {\n                out.push(ch);\n                if (ch === \"'\" && next === \"'\") { out.push(next); i += 2; continue; }\n                if (ch === \"'\") inSQ = false;\n                i++;\n                continue;\n              }\n              if (inDQ) {\n                out.push(ch);\n                if (ch === '\"' && next === '\"') { out.push(next); i += 2; continue; }\n                if (ch === '\"') inDQ = false;\n                i++;\n                continue;\n              }\n              if (ch === '-' && next === '-') { out.push(ch, next); i += 2; inLC = true; continue; }\n              if (ch === '/' && next === '*') { out.push(ch, next); i += 2; inBC = true; continue; }\n              if (ch === '\"') { out.push(ch); inDQ = true; i++; continue; }\n              if (ch === \"'\") { out.push(ch); inSQ = true; i++; continue; }\n              if (ch === ':' && next === ':') { out.push('::'); i += 2; continue; }\n              if (ch === ':') {\n                // parse token\n                let j = i + 1;\n                const start = j;\n                while (j < len) {\n                  const c = sqlText[j];\n                  if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || (c >= '0' && c <= '9') || c === '_') j++; else break;\n                }\n                const name = sqlText.slice(start, j);\n                if (name === 'offset') {\n                  const token = `:arg${nextIndex++}`;\n                  out.push(token);\n                  additions.push(offset);\n                  i = j;\n                  continue;\n                }\n                if (name === 'limit') {\n                  const token = `:arg${nextIndex++}`;\n                  out.push(token);\n                  additions.push(limit);\n                  i = j;\n                  continue;\n                }\n                // otherwise leave untouched\n                out.push(':');\n                i++;\n                continue;\n              }\n              out.push(ch);\n              i++;\n            }\n            return out.join('');\n          };\n\n          const rewritten = rewrite(workingSql);\n          if (rewritten !== workingSql) {\n            workingSql = rewritten;\n            // append values so :argK map correctly\n            (args as unknown[]).push(...additions);\n          }\n        } else {\n          // Named-mode: attach computed values (override any provided)\n          args = { ...(args as Record<string, unknown>), offset, limit };\n        }\n      }\n      const binder =\n        dialect === 'postgres' ? createPostgresBinder() : dialect === 'mysql' ? createMysqlBinder() : createSqliteBinder();\n      const { sql: boundSql, params } = binder.bind(workingSql, args as any);\n\n      // 5) execute query via registry DB\n      let out;\n      try {\n        const tx = getActiveTransaction(resolvedDbName);\n        out = tx ? await tx.query(boundSql, params) : await db.query(boundSql, params);\n      } catch (dbError: any) {\n        // Attach SQL query (with placeholders) to error for debugging\n        throw new DatabaseError(\n          dbError?.message || String(dbError),\n          boundSql,\n          dbError instanceof Error ? dbError : undefined\n        );\n      }\n\n      // 6) If rows were returned (SELECT/CTE), shape + transform + validate\n      if (Array.isArray(out)) {\n        const shaped = applyShape(out, labels.shape);\n        const transformed = labels.transform ? labels.transform(shaped) : shaped;\n\n        // 7) validate result via JSON Schema, if provided\n        if (labels.validateSchema && !isValidationDisabled()) {\n          if (Array.isArray(transformed)) {\n            for (const row of transformed) validateOutput(labels.validateSchema, row);\n          } else if (transformed !== null && transformed !== undefined) {\n            validateOutput(labels.validateSchema, transformed);\n          }\n        }\n        return transformed;\n      }\n\n      // Non-SELECT: return the write result as-is\n      return out;\n    };\n\n    return desc;\n  };\n}\n\nfunction applyDefaults(defaults: Record<string, unknown> | undefined, input: any) {\n  if (!defaults) return input;\n  if (Array.isArray(input)) return input; // defaults only apply to named-object args\n  return { ...defaults, ...(input || {}) };\n}\n\nfunction applyShape<T>(rows: T[], shape?: 'single' | 'only' | 'exist' | 'none'): any {\n  switch (shape) {\n    case 'single':\n      return rows.length > 0 ? rows[0] : null;\n    case 'only':\n      if (rows.length !== 1) throw new ExactlyOneRowError(rows.length);\n      return rows[0];\n    case 'exist':\n      if (rows.length < 1) throw new NoRowsError();\n      return rows[0];\n    case 'none':\n      if (rows.length > 0) throw new RowsExistError(rows.length);\n      return null;\n    default:\n      return rows;\n  }\n}\n"]}
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/decorators/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/G,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAQrC,MAAM,UAAU,KAAK,CAAC,GAA2B;IAC/C,OAAO,UAAU,OAAY,EAAE,IAAqB,EAAE,IAAwB;QAC5E,MAAM,OAAO,GAA6B,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;QACpF,MAAM,OAAO,GAAuB,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9E,6CAA6C;QAC7C,IAAI,OAAO,EAAE,EAAE,EAAE,CAAC;YAChB,eAAe,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,+BAA+B;QAC/B,IAAI,OAAO,EAAE,GAAG,EAAE,CAAC;YACjB,eAAe,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACnF,CAAC;aAAM,CAAC;YACN,wEAAwE;YACxE,qEAAqE;YACrE,wEAAwE;YACxE,sCAAsC;YACtC,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YAC5C,IAAI,OAAO,EAAE,CAAC;gBACZ,eAAe,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QAED,qEAAqE;QACrE,uEAAuE;QACvE,gDAAgD;QAChD,MAAM,cAAc,GAAG;YACrB,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,aAAa;YACtD,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC;YACxB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG;SACvB,CAAC;QACF,wBAAwB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAClD,uBAAuB,CAAC,cAAc,CAAC,CAAC;QAExC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,WAAW,GAAG,QAAe;YAC7C,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC3C,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YAEzC,4EAA4E;YAC5E,IAAI,cAAuB,CAAC;YAC5B,IAAI,CAAC;gBACH,cAAc,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,uGAAuG;gBACvG,cAAc,GAAG,SAAS,CAAC;YAC7B,CAAC;YACD,IAAI,cAAc,YAAY,WAAW,EAAE,CAAC;gBAC1C,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC;gBAEzD,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,OAAO,EAAE,EAAE,IAAI,WAAW,EAAE,EAAE,CAAC;gBAC3D,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBACjD,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;gBAEpB,IAAI,GAAG,CAAC;gBACR,IAAI,CAAC;oBACH,MAAM,EAAE,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;oBACvC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBACjF,CAAC;gBAAC,OAAO,OAAY,EAAE,CAAC;oBACtB,MAAM,IAAI,aAAa,CACrB,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,EACnC,QAAQ,EACR,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAC/C,CAAC;gBACJ,CAAC;gBAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;oBACvB,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;oBAEzE,IAAI,MAAM,CAAC,cAAc,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;wBACrD,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;4BAC/B,KAAK,MAAM,GAAG,IAAI,WAAW;gCAAE,cAAc,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;wBAC5E,CAAC;6BAAM,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;4BAC7D,cAAc,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;wBACrD,CAAC;oBACH,CAAC;oBACD,OAAO,WAAW,CAAC;gBACrB,CAAC;gBACD,OAAO,GAAG,CAAC;YACb,CAAC;YAED,gCAAgC;YAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,6BAA6B;YAE9F,4DAA4D;YAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,OAAO,EAAE,EAAE,IAAI,WAAW,EAAE,EAAE,CAAC;YAC3D,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC3E,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC,OAAO,IAAI,QAAQ,CAAC;YAE3D,oEAAoE;YACpE,4EAA4E;YAC5E,MAAM,GAAG,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,KAAK,QAAQ;gBAC3C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG;gBACnB,CAAC,CAAC,cAAc;oBACd,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC;wBACrB,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,IAAI,aAAa;wBACnD,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC;wBACxB,OAAO;wBACP,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;qBAC3E,CAAC;oBACJ,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,KAAK,IAAI;wBAC7B,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG;wBACpE,CAAC,CAAC,yBAAyB,EAAE,EAAE,OAAO,CAAC;4BACnC,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,IAAI,aAAa;4BACnD,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC;4BACxB,OAAO;yBACR,CAAC,CAAC;YACX,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,IAAI,aAAa,CAAC,qCAAqC,MAAM,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;YACpI,CAAC;YAED,uBAAuB;YACvB,yDAAyD;YACzD,IAAI,UAAU,GAAG,GAAG,CAAC;YACrB,MAAM,aAAa,GAAG,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAEzD,0BAA0B;YAC1B,IAAI,IAAS,CAAC;YACd,IAAI,aAAa,EAAE,CAAC;gBAClB,IAAI,GAAG,QAAQ,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAChE,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;YACzD,CAAC;YAED,iFAAiF;YACjF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;YAC5B,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;gBACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAE9B,0FAA0F;gBAC1F,MAAM,cAAc,GAAG,CAAC,GAAQ,EAAsB,EAAE;oBACtD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,OAAQ,GAAW,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;wBACtG,MAAM,CAAC,GAAI,GAAW,CAAC,IAAI,CAAC;wBAC5B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC;4BAAE,OAAO,CAAC,CAAC;oBACrD,CAAC;oBACD,OAAO,SAAS,CAAC;gBACnB,CAAC,CAAC;gBAEF,IAAI,OAA2B,CAAC;gBAChC,IAAI,aAAa,EAAE,CAAC;oBAClB,8DAA8D;oBAC9D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;wBAC3C,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;oBACjC,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,wEAAwE;oBACxE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;wBAC3C,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;oBACjC,CAAC;oBACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;wBAC1B,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;oBACjC,CAAC;gBACH,CAAC;gBAED,MAAM,aAAa,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;gBACnE,MAAM,MAAM,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;gBAC7C,MAAM,KAAK,GAAG,IAAI,CAAC;gBAEnB,IAAI,aAAa,EAAE,CAAC;oBAClB,mFAAmF;oBACnF,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,kCAAkC;oBACrE,IAAI,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC;oBAC9B,MAAM,SAAS,GAAc,EAAE,CAAC;oBAEhC,MAAM,OAAO,GAAG,CAAC,OAAe,EAAE,EAAE;wBAClC,MAAM,GAAG,GAAa,EAAE,CAAC;wBACzB,IAAI,CAAC,GAAG,CAAC,CAAC;wBACV,IAAI,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,CAAC;wBAC3D,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;wBAC3B,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC;4BACf,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;4BACtB,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;4BAC/C,IAAI,IAAI,EAAE,CAAC;gCAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gCAAC,IAAI,EAAE,KAAK,IAAI;oCAAE,IAAI,GAAG,KAAK,CAAC;gCAAC,CAAC,EAAE,CAAC;gCAAC,SAAS;4BAAC,CAAC;4BACzE,IAAI,IAAI,EAAE,CAAC;gCAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gCAAC,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;oCAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oCAAC,CAAC,EAAE,CAAC;oCAAC,IAAI,GAAG,KAAK,CAAC;gCAAC,CAAC;gCAAC,CAAC,EAAE,CAAC;gCAAC,SAAS;4BAAC,CAAC;4BACjH,IAAI,IAAI,EAAE,CAAC;gCACT,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gCACb,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;oCAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oCAAC,CAAC,IAAI,CAAC,CAAC;oCAAC,SAAS;gCAAC,CAAC;gCACrE,IAAI,EAAE,KAAK,GAAG;oCAAE,IAAI,GAAG,KAAK,CAAC;gCAC7B,CAAC,EAAE,CAAC;gCACJ,SAAS;4BACX,CAAC;4BACD,IAAI,IAAI,EAAE,CAAC;gCACT,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gCACb,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;oCAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oCAAC,CAAC,IAAI,CAAC,CAAC;oCAAC,SAAS;gCAAC,CAAC;gCACrE,IAAI,EAAE,KAAK,GAAG;oCAAE,IAAI,GAAG,KAAK,CAAC;gCAC7B,CAAC,EAAE,CAAC;gCACJ,SAAS;4BACX,CAAC;4BACD,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gCAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;gCAAC,CAAC,IAAI,CAAC,CAAC;gCAAC,IAAI,GAAG,IAAI,CAAC;gCAAC,SAAS;4BAAC,CAAC;4BACtF,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gCAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;gCAAC,CAAC,IAAI,CAAC,CAAC;gCAAC,IAAI,GAAG,IAAI,CAAC;gCAAC,SAAS;4BAAC,CAAC;4BACtF,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gCAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gCAAC,IAAI,GAAG,IAAI,CAAC;gCAAC,CAAC,EAAE,CAAC;gCAAC,SAAS;4BAAC,CAAC;4BAC7D,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gCAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gCAAC,IAAI,GAAG,IAAI,CAAC;gCAAC,CAAC,EAAE,CAAC;gCAAC,SAAS;4BAAC,CAAC;4BAC7D,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gCAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gCAAC,CAAC,IAAI,CAAC,CAAC;gCAAC,SAAS;4BAAC,CAAC;4BACrE,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gCACf,cAAc;gCACd,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gCACd,MAAM,KAAK,GAAG,CAAC,CAAC;gCAChB,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC;oCACf,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;oCACrB,IAAI,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG;wCAAE,CAAC,EAAE,CAAC;;wCAAM,MAAM;gCAC/G,CAAC;gCACD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gCACrC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;oCACtB,MAAM,KAAK,GAAG,OAAO,SAAS,EAAE,EAAE,CAAC;oCACnC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oCAChB,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oCACvB,CAAC,GAAG,CAAC,CAAC;oCACN,SAAS;gCACX,CAAC;gCACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;oCACrB,MAAM,KAAK,GAAG,OAAO,SAAS,EAAE,EAAE,CAAC;oCACnC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oCAChB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oCACtB,CAAC,GAAG,CAAC,CAAC;oCACN,SAAS;gCACX,CAAC;gCACD,4BAA4B;gCAC5B,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gCACd,CAAC,EAAE,CAAC;gCACJ,SAAS;4BACX,CAAC;4BACD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;4BACb,CAAC,EAAE,CAAC;wBACN,CAAC;wBACD,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACtB,CAAC,CAAC;oBAEF,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;oBACtC,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;wBAC7B,UAAU,GAAG,SAAS,CAAC;wBACvB,uCAAuC;wBACtC,IAAkB,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;oBACzC,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,6DAA6D;oBAC7D,IAAI,GAAG,EAAE,GAAI,IAAgC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;gBACjE,CAAC;YACH,CAAC;YACD,MAAM,MAAM,GACV,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC;YACrH,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,IAAW,CAAC,CAAC;YAEvE,mCAAmC;YACnC,IAAI,GAAG,CAAC;YACR,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;gBACvC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACjF,CAAC;YAAC,OAAO,OAAY,EAAE,CAAC;gBACtB,8DAA8D;gBAC9D,MAAM,IAAI,aAAa,CACrB,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,EACnC,QAAQ,EACR,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAC/C,CAAC;YACJ,CAAC;YAED,sEAAsE;YACtE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBAEzE,kDAAkD;gBAClD,IAAI,MAAM,CAAC,cAAc,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;oBACrD,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;wBAC/B,KAAK,MAAM,GAAG,IAAI,WAAW;4BAAE,cAAc,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;oBAC5E,CAAC;yBAAM,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;wBAC7D,cAAc,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;oBACrD,CAAC;gBACH,CAAC;gBACD,OAAO,WAAW,CAAC;YACrB,CAAC;YAED,4CAA4C;YAC5C,OAAO,GAAG,CAAC;QACb,CAAC,CAAC;QAEF,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,QAA6C,EAAE,KAAU;IAC9E,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,2CAA2C;IACnF,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,UAAU,CAAI,IAAS,EAAE,KAA4C;IAC5E,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1C,KAAK,MAAM;YACT,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,KAAK,OAAO;YACV,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,IAAI,WAAW,EAAE,CAAC;YAC7C,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,KAAK,MAAM;YACT,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3D,OAAO,IAAI,CAAC;QACd;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC","sourcesContent":["import { getClassLabels, getMethodLabels, setMethodLabels } from '../core/metadata';\nimport { SqlStackError, ExactlyOneRowError, NoRowsError, RowsExistError, DatabaseError } from '../core/errors';\nimport { isValidationDisabled, validateOutput } from '../core/validator';\nimport { resolveExecution } from '../runtime';\nimport { createSqliteBinder, createMysqlBinder, createPostgresBinder } from '../binders/sqlBinder';\nimport { coerceRootPath, resolveSqlFromFs } from '../core/fileResolution';\nimport { registerDecoratedMethod, recordQueryMethodOnClass } from '../core/resolver';\nimport { defaultSourceScanResolver } from '../core/sourceScanResolver';\nimport { getActiveTransaction } from '../transactions';\nimport { SqlFragment } from '../sql';\n\ntype QueryOptions = {\n  sql?: string; // optional inline SQL for testing; otherwise, future: load from file\n  db?: string;  // optional override DB name\n  dialect?: 'sqlite' | 'mysql' | 'postgres';\n};\n\nexport function Query(arg?: string | QueryOptions) {\n  return function (_target: any, prop: string | symbol, desc: PropertyDescriptor) {\n    const options: QueryOptions | undefined = typeof arg === 'string' ? undefined : arg;\n    const rootArg: string | undefined = typeof arg === 'string' ? arg : undefined;\n    // Store method-level db override if provided\n    if (options?.db) {\n      setMethodLabels(_target, prop, { db: options.db });\n    }\n    // Store inline SQL if provided\n    if (options?.sql) {\n      setMethodLabels(_target, prop, { source: { kind: 'inline', sql: options.sql } });\n    } else {\n      // FS-based resolution: only an EXPLICIT path argument pins a directory.\n      // Bare @Query() resolves through the active resolver (or the default\n      // SourceScanResolver) — no stack-based directory guessing, which breaks\n      // under bundlers and test transforms.\n      const { rootDir } = coerceRootPath(rootArg);\n      if (rootDir) {\n        setMethodLabels(_target, prop, { source: { kind: 'fs', rootDir } });\n      }\n    }\n\n    // Record for resolver coverage checks: immutable class metadata (the\n    // canonical, environment-local source) plus the deprecated global list\n    // consulted by the legacy global-resolver path.\n    const decoratedEntry = {\n      className: _target?.constructor?.name ?? '<anonymous>',\n      methodName: String(prop),\n      inline: !!options?.sql,\n    };\n    recordQueryMethodOnClass(_target, decoratedEntry);\n    registerDecoratedMethod(decoratedEntry);\n\n    const original = desc.value;\n    desc.value = async function (...callArgs: any[]) {\n      const labels = getMethodLabels(this, prop);\n      const classLabels = getClassLabels(this);\n\n      // 0) Check if the method body returns a SqlFragment (template literal path)\n      let fragmentResult: unknown;\n      try {\n        fragmentResult = await original.apply(this, callArgs);\n      } catch {\n        // Method body threw (e.g. placeholder `throw new Error('replaced')`) — fall through to file/inline SQL\n        fragmentResult = undefined;\n      }\n      if (fragmentResult instanceof SqlFragment) {\n        const { sql: boundSql, params } = fragmentResult.toSQL();\n\n        const dbName = labels.db ?? options?.db ?? classLabels?.db;\n        const { entry } = await resolveExecution(dbName);\n        const db = entry.db;\n\n        let out;\n        try {\n          const tx = getActiveTransaction(entry);\n          out = tx ? await tx.query(boundSql, params) : await db.query(boundSql, params);\n        } catch (dbError: any) {\n          throw new DatabaseError(\n            dbError?.message || String(dbError),\n            boundSql,\n            dbError instanceof Error ? dbError : undefined\n          );\n        }\n\n        if (Array.isArray(out)) {\n          const shaped = applyShape(out, labels.shape);\n          const transformed = labels.transform ? labels.transform(shaped) : shaped;\n\n          if (labels.validateSchema && !isValidationDisabled()) {\n            if (Array.isArray(transformed)) {\n              for (const row of transformed) validateOutput(labels.validateSchema, row);\n            } else if (transformed !== null && transformed !== undefined) {\n              validateOutput(labels.validateSchema, transformed);\n            }\n          }\n          return transformed;\n        }\n        return out;\n      }\n\n      // 1) prepare args with defaults\n      const rawInput = callArgs.length === 1 ? callArgs[0] : callArgs; // object or positional array\n\n      // 2) choose database and dialect via the active environment\n      const dbName = labels.db ?? options?.db ?? classLabels?.db;\n      const { entry, resolver: activeResolver } = await resolveExecution(dbName);\n      const db = entry.db;\n      const dialect = options?.dialect ?? db.dialect ?? 'sqlite';\n\n      // 3) load SQL source (inline, environment resolver, v1 fs fallback,\n      //    or the zero-config source scan — bare @Query() with nothing installed)\n      const sql = labels?.source?.kind === 'inline'\n        ? labels.source.sql\n        : activeResolver\n          ? activeResolver.resolve({\n              className: this?.constructor?.name ?? '<anonymous>',\n              methodName: String(prop),\n              dialect,\n              rootDir: labels?.source?.kind === 'fs' ? labels.source.rootDir : undefined,\n            })\n          : labels?.source?.kind === 'fs'\n            ? resolveSqlFromFs(labels.source.rootDir, String(prop), dialect).sql\n            : defaultSourceScanResolver()?.resolve({\n                className: this?.constructor?.name ?? '<anonymous>',\n                methodName: String(prop),\n                dialect,\n              });\n      if (!sql) {\n        throw new SqlStackError(`No SQL source provided for method ${String(prop)}. Use @Query() with a file/folder path or inline sql.`);\n      }\n\n      // 4) bind placeholders\n      // Decide argument mode: positional if SQL contains :argN\n      let workingSql = sql;\n      const hasPositional = /:arg[1-9][0-9]*/.test(workingSql);\n\n      // Prepare args for binder\n      let args: any;\n      if (hasPositional) {\n        args = callArgs;\n      } else {\n        const namedBase = callArgs.length > 0 ? callArgs[0] : undefined;\n        args = applyDefaults(labels.defaults, namedBase ?? {});\n      }\n\n      // Compute paging and inject :offset/:limit (named mode) or rewrite to positional\n      const pageCfg = labels.page;\n      if (pageCfg) {\n        const { size, zeroBase } = pageCfg;\n        const base = zeroBase ? 0 : 1;\n\n        // Extract page number from input (object) or a trailing options object in positional mode\n        const pageFromObject = (val: any): number | undefined => {\n          if (val && typeof val === 'object' && !Array.isArray(val) && typeof (val as any).page !== 'undefined') {\n            const p = (val as any).page;\n            if (typeof p === 'number' && isFinite(p)) return p;\n          }\n          return undefined;\n        };\n\n        let pageNum: number | undefined;\n        if (hasPositional) {\n          // Variadic-style: only the LAST argument may carry `{ page }`\n          if (callArgs.length > 0) {\n            const last = callArgs[callArgs.length - 1];\n            pageNum = pageFromObject(last);\n          }\n        } else {\n          // Prefer last-arg options if provided; otherwise read from named object\n          if (callArgs.length > 1) {\n            const last = callArgs[callArgs.length - 1];\n            pageNum = pageFromObject(last);\n          }\n          if (pageNum === undefined) {\n            pageNum = pageFromObject(args);\n          }\n        }\n\n        const effectivePage = typeof pageNum === 'number' ? pageNum : base;\n        const offset = (effectivePage - base) * size;\n        const limit = size;\n\n        if (hasPositional) {\n          // Replace occurrences of :offset and :limit with new :argN tokens appended to args\n          const baseIndex = callArgs.length; // start numbering after user args\n          let nextIndex = baseIndex + 1;\n          const additions: unknown[] = [];\n\n          const rewrite = (sqlText: string) => {\n            const out: string[] = [];\n            let i = 0;\n            let inSQ = false, inDQ = false, inLC = false, inBC = false;\n            const len = sqlText.length;\n            while (i < len) {\n              const ch = sqlText[i];\n              const next = i + 1 < len ? sqlText[i + 1] : '';\n              if (inLC) { out.push(ch); if (ch === '\\n') inLC = false; i++; continue; }\n              if (inBC) { out.push(ch); if (ch === '*' && next === '/') { out.push(next); i++; inBC = false; } i++; continue; }\n              if (inSQ) {\n                out.push(ch);\n                if (ch === \"'\" && next === \"'\") { out.push(next); i += 2; continue; }\n                if (ch === \"'\") inSQ = false;\n                i++;\n                continue;\n              }\n              if (inDQ) {\n                out.push(ch);\n                if (ch === '\"' && next === '\"') { out.push(next); i += 2; continue; }\n                if (ch === '\"') inDQ = false;\n                i++;\n                continue;\n              }\n              if (ch === '-' && next === '-') { out.push(ch, next); i += 2; inLC = true; continue; }\n              if (ch === '/' && next === '*') { out.push(ch, next); i += 2; inBC = true; continue; }\n              if (ch === '\"') { out.push(ch); inDQ = true; i++; continue; }\n              if (ch === \"'\") { out.push(ch); inSQ = true; i++; continue; }\n              if (ch === ':' && next === ':') { out.push('::'); i += 2; continue; }\n              if (ch === ':') {\n                // parse token\n                let j = i + 1;\n                const start = j;\n                while (j < len) {\n                  const c = sqlText[j];\n                  if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || (c >= '0' && c <= '9') || c === '_') j++; else break;\n                }\n                const name = sqlText.slice(start, j);\n                if (name === 'offset') {\n                  const token = `:arg${nextIndex++}`;\n                  out.push(token);\n                  additions.push(offset);\n                  i = j;\n                  continue;\n                }\n                if (name === 'limit') {\n                  const token = `:arg${nextIndex++}`;\n                  out.push(token);\n                  additions.push(limit);\n                  i = j;\n                  continue;\n                }\n                // otherwise leave untouched\n                out.push(':');\n                i++;\n                continue;\n              }\n              out.push(ch);\n              i++;\n            }\n            return out.join('');\n          };\n\n          const rewritten = rewrite(workingSql);\n          if (rewritten !== workingSql) {\n            workingSql = rewritten;\n            // append values so :argK map correctly\n            (args as unknown[]).push(...additions);\n          }\n        } else {\n          // Named-mode: attach computed values (override any provided)\n          args = { ...(args as Record<string, unknown>), offset, limit };\n        }\n      }\n      const binder =\n        dialect === 'postgres' ? createPostgresBinder() : dialect === 'mysql' ? createMysqlBinder() : createSqliteBinder();\n      const { sql: boundSql, params } = binder.bind(workingSql, args as any);\n\n      // 5) execute query via registry DB\n      let out;\n      try {\n        const tx = getActiveTransaction(entry);\n        out = tx ? await tx.query(boundSql, params) : await db.query(boundSql, params);\n      } catch (dbError: any) {\n        // Attach SQL query (with placeholders) to error for debugging\n        throw new DatabaseError(\n          dbError?.message || String(dbError),\n          boundSql,\n          dbError instanceof Error ? dbError : undefined\n        );\n      }\n\n      // 6) If rows were returned (SELECT/CTE), shape + transform + validate\n      if (Array.isArray(out)) {\n        const shaped = applyShape(out, labels.shape);\n        const transformed = labels.transform ? labels.transform(shaped) : shaped;\n\n        // 7) validate result via JSON Schema, if provided\n        if (labels.validateSchema && !isValidationDisabled()) {\n          if (Array.isArray(transformed)) {\n            for (const row of transformed) validateOutput(labels.validateSchema, row);\n          } else if (transformed !== null && transformed !== undefined) {\n            validateOutput(labels.validateSchema, transformed);\n          }\n        }\n        return transformed;\n      }\n\n      // Non-SELECT: return the write result as-is\n      return out;\n    };\n\n    return desc;\n  };\n}\n\nfunction applyDefaults(defaults: Record<string, unknown> | undefined, input: any) {\n  if (!defaults) return input;\n  if (Array.isArray(input)) return input; // defaults only apply to named-object args\n  return { ...defaults, ...(input || {}) };\n}\n\nfunction applyShape<T>(rows: T[], shape?: 'single' | 'only' | 'exist' | 'none'): any {\n  switch (shape) {\n    case 'single':\n      return rows.length > 0 ? rows[0] : null;\n    case 'only':\n      if (rows.length !== 1) throw new ExactlyOneRowError(rows.length);\n      return rows[0];\n    case 'exist':\n      if (rows.length < 1) throw new NoRowsError();\n      return rows[0];\n    case 'none':\n      if (rows.length > 0) throw new RowsExistError(rows.length);\n      return null;\n    default:\n      return rows;\n  }\n}\n"]}

package/dist/esm/families/sqliteFamily.js

@@ -0,0 +1,151 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { SqlStackError } from '../core/errors.js';
+import { createSqliteDb } from '../adapters/sqlite.js';
+const SIDECARS = ['-wal', '-shm', '-journal'];
+/**
+ * Strict SQLite file family (spec 17 §15/§20): open() NEVER creates a missing
+ * file — a lost database must surface as a failure, not become a fresh empty
+ * migrated database. Creation is explicit.
+ *
+ * Keys are opaque (spec 17 §18): any non-empty string is accepted, including
+ * path-shaped legacy keys. Safety is containment — the resolved file must
+ * stay inside the family root — and canonical identity: keyId is the
+ * resolved root-relative path, so aliasing spellings collapse to one member.
+ */
+export function sqliteFamily(options) {
+    const root = path.resolve(options.directory);
+    function resolvePath(key) {
+        // Default naming: keys already carrying .db (legacy stored paths) map
+        // as-is; bare logical keys get the .db suffix.
+        const file = options.filename
+            ? options.filename(key)
+            : key.endsWith('.db')
+                ? key
+                : `${key}.db`;
+        const resolved = path.resolve(root, file);
+        if (resolved === root || !resolved.startsWith(root + path.sep)) {
+            throw new SqlStackError(`SQLite family key "${key}" resolves outside the family directory (${root}). ` +
+                'Resolved member files must stay inside the configured root.');
+        }
+        return resolved;
+    }
+    async function openConnection(file, mustExist) {
+        let BetterSqlite3;
+        try {
+            BetterSqlite3 = (await import('better-sqlite3')).default;
+        }
+        catch {
+            throw new SqlStackError('sqliteFamily requires the optional peer "better-sqlite3".');
+        }
+        const conn = new BetterSqlite3(file, { fileMustExist: mustExist });
+        for (const pragma of options.pragmas ?? []) {
+            conn.pragma(pragma);
+        }
+        return createSqliteDb(conn);
+    }
+    return {
+        normalizeKey(input) {
+            if (typeof input !== 'string' || input.length === 0) {
+                throw new SqlStackError(`Invalid SQLite family key ${JSON.stringify(input)}: keys are non-empty strings.`);
+            }
+            // Containment is validated eagerly so a bad key fails at normalization
+            // time with the key in the diagnostic, before any lifecycle operation.
+            resolvePath(input);
+            return input;
+        },
+        // Canonical identity (spec 17 §18): aliasing spellings of the same file
+        // ("a.db" vs "sub/../a.db") collapse to one keyId, so cache entries,
+        // lease counts, and transaction identity can never split across aliases.
+        keyId(key) {
+            return path.relative(root, resolvePath(key));
+        },
+        async exists(key) {
+            return fs.existsSync(resolvePath(key));
+        },
+        async open(key) {
+            const file = resolvePath(key);
+            try {
+                return await openConnection(file, true);
+            }
+            catch (err) {
+                if (!fs.existsSync(file)) {
+                    throw new SqlStackError(`SQLite family database "${key}" does not exist at ${file}. ` +
+                        'open() never creates databases — use create(key) or ensure(key) explicitly.');
+                }
+                throw err;
+            }
+        },
+        async create(key) {
+            const file = resolvePath(key);
+            if (options.mkdirs !== false) {
+                fs.mkdirSync(path.dirname(file), { recursive: true });
+            }
+            // Exclusive file creation makes "must not already exist" race-free; an
+            // empty file is a valid brand-new SQLite database.
+            try {
+                fs.closeSync(fs.openSync(file, 'wx'));
+            }
+            catch (err) {
+                if (err?.code === 'EEXIST') {
+                    throw new SqlStackError(`SQLite family database "${key}" already exists at ${file}. ` +
+                        'create() requires a new database — use ensure(key) for create-if-missing.');
+                }
+                throw err;
+            }
+            try {
+                const db = await openConnection(file, true);
+                if (options.prepare)
+                    await options.prepare(db, key);
+                return db;
+            }
+            catch (err) {
+                // Safe cleanup of the storage this create() call owns.
+                try {
+                    fs.rmSync(file, { force: true });
+                }
+                catch {
+                    /* keep original error */
+                }
+                throw err;
+            }
+        },
+        async ensure(key) {
+            const file = resolvePath(key);
+            if (fs.existsSync(file))
+                return this.open(key);
+            return this.create(key);
+        },
+        async delete(key) {
+            const file = resolvePath(key);
+            if (!fs.existsSync(file)) {
+                throw new SqlStackError(`SQLite family database "${key}" does not exist at ${file}; nothing to delete.`);
+            }
+            fs.rmSync(file);
+            for (const suffix of SIDECARS) {
+                fs.rmSync(file + suffix, { force: true });
+            }
+        },
+        async inspect(key) {
+            const file = resolvePath(key);
+            if (!fs.existsSync(file))
+                return { state: 'missing', path: file };
+            const sizeBytes = fs.statSync(file).size;
+            let sidecarBytes = 0;
+            for (const suffix of SIDECARS) {
+                if (fs.existsSync(file + suffix))
+                    sidecarBytes += fs.statSync(file + suffix).size;
+            }
+            return { state: 'closed', path: file, sizeBytes, sidecarBytes };
+        },
+        async *list() {
+            if (!fs.existsSync(root))
+                return;
+            for (const entry of fs.readdirSync(root)) {
+                if (entry.endsWith('.db'))
+                    yield entry.slice(0, -3);
+            }
+        },
+    };
+}
+//# sourceMappingURL=sqliteFamily.js.map

package/dist/esm/families/sqliteFamily.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteFamily.js","sourceRoot":"","sources":["../../../src/families/sqliteFamily.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport type { Database } from '../registry';\nimport { SqlStackError } from '../core/errors';\nimport { createSqliteDb } from '../adapters/sqlite';\nimport type { DatabaseFamilyProvider, DatabaseInspection } from '../family';\n\nexport interface SqliteFamilyOptions {\n  /** Root directory that owns every member file. Keys resolve inside it. */\n  directory: string;\n  /** Filename for a key (default `<key>.db`). Must not escape the directory. */\n  filename?: (key: string) => string;\n  /** Pragmas applied on every open (e.g. ['journal_mode = WAL']). */\n  pragmas?: readonly string[];\n  /** Preparation hook (e.g. Proper migrations) run after create/ensure-open. */\n  prepare?: (db: Database, key: string) => Promise<void>;\n  /** Create parent directories on create/ensure (default true). */\n  mkdirs?: boolean;\n}\n\nconst SIDECARS = ['-wal', '-shm', '-journal'];\n\n/**\n * Strict SQLite file family (spec 17 §15/§20): open() NEVER creates a missing\n * file — a lost database must surface as a failure, not become a fresh empty\n * migrated database. Creation is explicit.\n *\n * Keys are opaque (spec 17 §18): any non-empty string is accepted, including\n * path-shaped legacy keys. Safety is containment — the resolved file must\n * stay inside the family root — and canonical identity: keyId is the\n * resolved root-relative path, so aliasing spellings collapse to one member.\n */\nexport function sqliteFamily(options: SqliteFamilyOptions): DatabaseFamilyProvider<string> {\n  const root = path.resolve(options.directory);\n\n  function resolvePath(key: string): string {\n    // Default naming: keys already carrying .db (legacy stored paths) map\n    // as-is; bare logical keys get the .db suffix.\n    const file = options.filename\n      ? options.filename(key)\n      : key.endsWith('.db')\n        ? key\n        : `${key}.db`;\n    const resolved = path.resolve(root, file);\n    if (resolved === root || !resolved.startsWith(root + path.sep)) {\n      throw new SqlStackError(\n        `SQLite family key \"${key}\" resolves outside the family directory (${root}). ` +\n          'Resolved member files must stay inside the configured root.'\n      );\n    }\n    return resolved;\n  }\n\n  async function openConnection(file: string, mustExist: boolean): Promise<Database> {\n    let BetterSqlite3: any;\n    try {\n      BetterSqlite3 = ((await import('better-sqlite3' as string)) as any).default;\n    } catch {\n      throw new SqlStackError('sqliteFamily requires the optional peer \"better-sqlite3\".');\n    }\n    const conn = new BetterSqlite3(file, { fileMustExist: mustExist });\n    for (const pragma of options.pragmas ?? []) {\n      conn.pragma(pragma);\n    }\n    return createSqliteDb(conn);\n  }\n\n  return {\n    normalizeKey(input: unknown): string {\n      if (typeof input !== 'string' || input.length === 0) {\n        throw new SqlStackError(\n          `Invalid SQLite family key ${JSON.stringify(input)}: keys are non-empty strings.`\n        );\n      }\n      // Containment is validated eagerly so a bad key fails at normalization\n      // time with the key in the diagnostic, before any lifecycle operation.\n      resolvePath(input);\n      return input;\n    },\n\n    // Canonical identity (spec 17 §18): aliasing spellings of the same file\n    // (\"a.db\" vs \"sub/../a.db\") collapse to one keyId, so cache entries,\n    // lease counts, and transaction identity can never split across aliases.\n    keyId(key: string): string {\n      return path.relative(root, resolvePath(key));\n    },\n\n    async exists(key: string): Promise<boolean> {\n      return fs.existsSync(resolvePath(key));\n    },\n\n    async open(key: string): Promise<Database> {\n      const file = resolvePath(key);\n      try {\n        return await openConnection(file, true);\n      } catch (err: any) {\n        if (!fs.existsSync(file)) {\n          throw new SqlStackError(\n            `SQLite family database \"${key}\" does not exist at ${file}. ` +\n              'open() never creates databases — use create(key) or ensure(key) explicitly.'\n          );\n        }\n        throw err;\n      }\n    },\n\n    async create(key: string): Promise<Database> {\n      const file = resolvePath(key);\n      if (options.mkdirs !== false) {\n        fs.mkdirSync(path.dirname(file), { recursive: true });\n      }\n      // Exclusive file creation makes \"must not already exist\" race-free; an\n      // empty file is a valid brand-new SQLite database.\n      try {\n        fs.closeSync(fs.openSync(file, 'wx'));\n      } catch (err: any) {\n        if (err?.code === 'EEXIST') {\n          throw new SqlStackError(\n            `SQLite family database \"${key}\" already exists at ${file}. ` +\n              'create() requires a new database — use ensure(key) for create-if-missing.'\n          );\n        }\n        throw err;\n      }\n      try {\n        const db = await openConnection(file, true);\n        if (options.prepare) await options.prepare(db, key);\n        return db;\n      } catch (err) {\n        // Safe cleanup of the storage this create() call owns.\n        try {\n          fs.rmSync(file, { force: true });\n        } catch {\n          /* keep original error */\n        }\n        throw err;\n      }\n    },\n\n    async ensure(key: string): Promise<Database> {\n      const file = resolvePath(key);\n      if (fs.existsSync(file)) return this.open(key);\n      return this.create!(key);\n    },\n\n    async delete(key: string): Promise<void> {\n      const file = resolvePath(key);\n      if (!fs.existsSync(file)) {\n        throw new SqlStackError(\n          `SQLite family database \"${key}\" does not exist at ${file}; nothing to delete.`\n        );\n      }\n      fs.rmSync(file);\n      for (const suffix of SIDECARS) {\n        fs.rmSync(file + suffix, { force: true });\n      }\n    },\n\n    async inspect(key: string): Promise<DatabaseInspection> {\n      const file = resolvePath(key);\n      if (!fs.existsSync(file)) return { state: 'missing', path: file };\n      const sizeBytes = fs.statSync(file).size;\n      let sidecarBytes = 0;\n      for (const suffix of SIDECARS) {\n        if (fs.existsSync(file + suffix)) sidecarBytes += fs.statSync(file + suffix).size;\n      }\n      return { state: 'closed', path: file, sizeBytes, sidecarBytes };\n    },\n\n    async *list(): AsyncIterable<string> {\n      if (!fs.existsSync(root)) return;\n      for (const entry of fs.readdirSync(root)) {\n        if (entry.endsWith('.db')) yield entry.slice(0, -3);\n      }\n    },\n  };\n}\n"]}