sqlstack 1.0.7 → 1.0.9

package/dist/esm/adapters/mysql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.js","sourceRoot":"","sources":["../../../src/adapters/mysql.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,SAAuB;IACnD,IAAI,IAAS,CAAC;IACd,IAAI,GAAG,GAAG,KAAK,CAAC;IAEhB,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,sCAAsC;QACtC,8DAA8D;QAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACxC,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC;QAChE,GAAG,GAAG,IAAI,CAAC;IACb,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,MAAiB;YACxC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,oBAAoB;gBACpB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1C,CAAC;YACD,2BAA2B;YAC3B,MAAM,GAAG,GAAQ,IAAI,IAAI,EAAE,CAAC;YAC5B,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;YACtE,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC;YAClC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;QACxC,CAAC;QACD,IAAI,EAAE,IAAI;QACV,KAAK,CAAC,KAAK;YACT,IAAI,GAAG,IAAI,OAAO,IAAI,EAAE,GAAG,KAAK,UAAU,EAAE,CAAC;gBAC3C,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;KACU,CAAC;AAChB,CAAC","sourcesContent":["import type { Database } from '../registry';\n\nexport function createMysqlDb(urlOrPool: string | any): Database {\n  let pool: any;\n  let own = false;\n\n  if (typeof urlOrPool === 'string') {\n    // Lazy import to keep driver optional\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const mysql = require('mysql2/promise');\n    pool = mysql.createPool({ uri: urlOrPool, connectionLimit: 4 });\n    own = true;\n  } else {\n    pool = urlOrPool;\n  }\n\n  return {\n    dialect: 'mysql',\n    async query(sql: string, params: unknown[]) {\n      const [rows] = await pool.query(sql, params);\n      if (Array.isArray(rows)) {\n        // SELECT/CTE result\n        return rows.map((r: any) => ({ ...r }));\n      }\n      // Non-SELECT result header\n      const hdr: any = rows || {};\n      const rowsAffected = Number(hdr.affectedRows ?? hdr.changedRows ?? 0);\n      const lastInsertId = hdr.insertId;\n      return { rowsAffected, lastInsertId };\n    },\n    conn: pool,\n    async close() {\n      if (own && typeof pool?.end === 'function') {\n        await pool.end();\n      }\n    },\n  } as Database;\n}\n"]}

package/dist/esm/adapters/pg.js

@@ -0,0 +1,67 @@
+function stripLeadingComments(sql) {
+    let i = 0;
+    const n = sql.length;
+    // Strip BOM
+    if (sql.charCodeAt(0) === 0xfeff)
+        i = 1;
+    while (i < n) {
+        // Skip whitespace
+        while (i < n && /\s/.test(sql[i]))
+            i++;
+        if (i + 1 < n && sql[i] === '-' && sql[i + 1] === '-') {
+            // Line comment -- ...\n
+            i += 2;
+            while (i < n && sql[i] !== '\n')
+                i++;
+            continue;
+        }
+        if (i + 1 < n && sql[i] === '/' && sql[i + 1] === '*') {
+            // Block comment /* ... */
+            i += 2;
+            let end = sql.indexOf('*/', i);
+            if (end === -1)
+                return '';
+            i = end + 2;
+            continue;
+        }
+        break;
+    }
+    return sql.slice(i);
+}
+export function createPgDb(urlOrPool) {
+    let pool;
+    let own = false;
+    if (typeof urlOrPool === 'string') {
+        // Lazy import to keep driver optional
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { Pool } = require('pg');
+        pool = new Pool({ connectionString: urlOrPool, max: 4 });
+        own = true;
+    }
+    else {
+        pool = urlOrPool;
+    }
+    return {
+        dialect: 'postgres',
+        async query(sql, params) {
+            const res = await pool.query(sql, params);
+            const text = stripLeadingComments(String(sql)).trimStart().toUpperCase();
+            if (text.startsWith('SELECT') || text.startsWith('WITH')) {
+                return res.rows;
+            }
+            // Non-SELECT: include rowCount and optional returning
+            const base = { rowsAffected: Number(res.rowCount ?? 0) };
+            if (Array.isArray(res.rows) && res.rows.length > 0) {
+                base.returning = res.rows;
+            }
+            return base;
+        },
+        conn: pool,
+        async close() {
+            if (own && typeof pool?.end === 'function') {
+                await pool.end();
+            }
+        },
+    };
+}
+//# sourceMappingURL=pg.js.map

package/dist/esm/adapters/pg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg.js","sourceRoot":"","sources":["../../../src/adapters/pg.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Database } from '../registry';\n\nfunction stripLeadingComments(sql: string): string {\n  let i = 0;\n  const n = sql.length;\n  // Strip BOM\n  if (sql.charCodeAt(0) === 0xfeff) i = 1;\n  while (i < n) {\n    // Skip whitespace\n    while (i < n && /\\s/.test(sql[i]!)) i++;\n    if (i + 1 < n && sql[i] === '-' && sql[i + 1] === '-') {\n      // Line comment -- ...\\n\n      i += 2;\n      while (i < n && sql[i] !== '\\n') i++;\n      continue;\n    }\n    if (i + 1 < n && sql[i] === '/' && sql[i + 1] === '*') {\n      // Block comment /* ... */\n      i += 2;\n      let end = sql.indexOf('*/', i);\n      if (end === -1) return '';\n      i = end + 2;\n      continue;\n    }\n    break;\n  }\n  return sql.slice(i);\n}\n\nexport function createPgDb(urlOrPool: string | any): Database {\n  let pool: any;\n  let own = false;\n\n  if (typeof urlOrPool === 'string') {\n    // Lazy import to keep driver optional\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const { Pool } = require('pg');\n    pool = new Pool({ connectionString: urlOrPool, max: 4 });\n    own = true;\n  } else {\n    pool = urlOrPool;\n  }\n\n  return {\n    dialect: 'postgres',\n    async query(sql: string, params: unknown[]) {\n      const res = await pool.query(sql, params);\n      const text = stripLeadingComments(String(sql)).trimStart().toUpperCase();\n      if (text.startsWith('SELECT') || text.startsWith('WITH')) {\n        return res.rows;\n      }\n      // Non-SELECT: include rowCount and optional returning\n      const base: any = { rowsAffected: Number(res.rowCount ?? 0) };\n      if (Array.isArray(res.rows) && res.rows.length > 0) {\n        base.returning = res.rows;\n      }\n      return base;\n    },\n    conn: pool,\n    async close() {\n      if (own && typeof pool?.end === 'function') {\n        await pool.end();\n      }\n    },\n  } as Database;\n}\n"]}

package/dist/{adapters → esm/adapters}/sqlite.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSqliteDb = createSqliteDb;
 function stripLeadingComments(sql) {
     let i = 0;
     const n = sql.length;
@@ -29,7 +26,7 @@ function stripLeadingComments(sql) {
     }
     return sql.slice(i);
 }
-function createSqliteDb(filenameOrDb) {
+export async function createSqliteDb(filenameOrDb) {
     // If a pre-created connection is provided
     if (typeof filenameOrDb !== 'string' && filenameOrDb) {
         const db = filenameOrDb;
@@ -80,10 +77,26 @@ function createSqliteDb(filenameOrDb) {
         };
     }
     const filename = filenameOrDb;
-    // Prefer better-sqlite3
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const BetterSqlite3 = require('better-sqlite3');
+    let BetterSqlite3;
+    if (typeof require === 'function') {
+        try {
+            BetterSqlite3 = require('better-sqlite3');
+        }
+        catch {
+            BetterSqlite3 = null;
+        }
+    }
+    else {
+        try {
+            // @ts-ignore optional dependency without types
+            const mod = await import('better-sqlite3');
+            BetterSqlite3 = mod.default ?? mod;
+        }
+        catch {
+            BetterSqlite3 = null;
+        }
+    }
+    if (BetterSqlite3) {
         const db = new BetterSqlite3(filename);
         return {
             dialect: 'sqlite',
@@ -102,11 +115,26 @@ function createSqliteDb(filenameOrDb) {
             },
         };
     }
-    catch { }
-    // Fallback to sqlite3
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const sqlite3 = require('sqlite3');
+    let sqlite3;
+    if (typeof require === 'function') {
+        try {
+            sqlite3 = require('sqlite3');
+        }
+        catch {
+            sqlite3 = null;
+        }
+    }
+    else {
+        try {
+            // @ts-ignore optional dependency without types
+            const mod = await import('sqlite3');
+            sqlite3 = mod.default ?? mod;
+        }
+        catch {
+            sqlite3 = null;
+        }
+    }
+    if (sqlite3) {
         const db = new sqlite3.Database(filename);
         return {
             dialect: 'sqlite',
@@ -138,7 +166,6 @@ function createSqliteDb(filenameOrDb) {
             },
         };
     }
-    catch { }
     throw new Error('No SQLite driver available. Install either better-sqlite3 or sqlite3.');
 }
 //# sourceMappingURL=sqlite.js.map

package/dist/esm/adapters/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../../src/adapters/sqlite.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Database } from '../registry';\n\nfunction stripLeadingComments(sql: string): string {\n  let i = 0;\n  const n = sql.length;\n  if (sql.charCodeAt(0) === 0xfeff) i = 1; // BOM\n  while (i < n) {\n    while (i < n && /\\s/.test(sql[i]!)) i++;\n    if (i + 1 < n && sql[i] === '-' && sql[i + 1] === '-') {\n      // -- line comment\n      i += 2;\n      while (i < n && sql[i] !== '\\n') i++;\n      continue;\n    }\n    if (i + 1 < n && sql[i] === '/' && sql[i + 1] === '*') {\n      // /* block comment */\n      i += 2;\n      const end = sql.indexOf('*/', i);\n      if (end === -1) return '';\n      i = end + 2;\n      continue;\n    }\n    break;\n  }\n  return sql.slice(i);\n}\n\nexport async function createSqliteDb(filenameOrDb: string | any): Promise<Database> {\n  // If a pre-created connection is provided\n  if (typeof filenameOrDb !== 'string' && filenameOrDb) {\n    const db = filenameOrDb;\n\n    // better-sqlite3 shape\n    if (typeof db.prepare === 'function') {\n      return {\n        dialect: 'sqlite',\n        async query(sql: string, params: unknown[]) {\n          const stmt = db.prepare(sql);\n          const text = stripLeadingComments(String(sql)).trimStart().toUpperCase();\n          if (text.startsWith('SELECT') || text.startsWith('WITH')) {\n            return stmt.all(...params);\n          }\n          const info = stmt.run(...params);\n          return { rowsAffected: Number(info?.changes ?? 0), lastInsertId: info?.lastInsertRowid };\n        },\n        conn: db,\n        // Do not close externally provided connection\n        close() {},\n      } as Database;\n    }\n\n    // sqlite3 shape\n    return {\n      dialect: 'sqlite',\n      async query(sql: string, params: unknown[]) {\n        const text = stripLeadingComments(String(sql)).trimStart().toUpperCase();\n        if (text.startsWith('SELECT') || text.startsWith('WITH')) {\n          return new Promise<any[]>((resolve, reject) => {\n            db.all(sql, params, (err: Error | null, rows: any[]) => {\n              if (err) return reject(err);\n              resolve(rows || []);\n            });\n          });\n        }\n        return new Promise((resolve, reject) => {\n          // Use function callback to access `this` for metadata\n          db.run(sql, params, function (this: any, err: Error | null) {\n            if (err) return reject(err);\n            resolve({ rowsAffected: Number(this?.changes ?? 0), lastInsertId: this?.lastID });\n          });\n        });\n      },\n      conn: db,\n      // Do not close externally provided connection\n      close() {},\n    } as Database;\n  }\n\n  const filename = filenameOrDb as string;\n\n  let BetterSqlite3: any;\n  if (typeof require === 'function') {\n    try {\n      BetterSqlite3 = require('better-sqlite3');\n    } catch {\n      BetterSqlite3 = null;\n    }\n  } else {\n    try {\n      // @ts-ignore optional dependency without types\n      const mod = await import('better-sqlite3');\n      BetterSqlite3 = (mod as any).default ?? mod;\n    } catch {\n      BetterSqlite3 = null;\n    }\n  }\n\n  if (BetterSqlite3) {\n    const db = new BetterSqlite3(filename);\n    return {\n      dialect: 'sqlite',\n      async query(sql: string, params: unknown[]) {\n        const stmt = db.prepare(sql);\n        const text = stripLeadingComments(String(sql)).trimStart().toUpperCase();\n        if (text.startsWith('SELECT') || text.startsWith('WITH')) {\n          return stmt.all(...params);\n        }\n        const info = stmt.run(...params);\n        return { rowsAffected: Number(info?.changes ?? 0), lastInsertId: info?.lastInsertRowid };\n      },\n      conn: db,\n      close() {\n        db.close();\n      },\n    } as Database;\n  }\n\n  let sqlite3: any;\n  if (typeof require === 'function') {\n    try {\n      sqlite3 = require('sqlite3');\n    } catch {\n      sqlite3 = null;\n    }\n  } else {\n    try {\n      // @ts-ignore optional dependency without types\n      const mod = await import('sqlite3');\n      sqlite3 = (mod as any).default ?? mod;\n    } catch {\n      sqlite3 = null;\n    }\n  }\n\n  if (sqlite3) {\n    const db = new sqlite3.Database(filename);\n    return {\n      dialect: 'sqlite',\n      async query(sql: string, params: unknown[]) {\n        const text = stripLeadingComments(String(sql)).trimStart().toUpperCase();\n        if (text.startsWith('SELECT') || text.startsWith('WITH')) {\n          return new Promise<any[]>((resolve, reject) => {\n            db.all(sql, params, (err: Error | null, rows: any[]) => {\n              if (err) return reject(err);\n              resolve(rows || []);\n            });\n          });\n        }\n        // Non-SELECT statements\n        return new Promise((resolve, reject) => {\n          db.run(sql, params, function (this: any, err: Error | null) {\n            if (err) return reject(err);\n            resolve({ rowsAffected: Number(this?.changes ?? 0), lastInsertId: this?.lastID });\n          });\n        });\n      },\n      conn: db,\n      close() {\n        return new Promise<void>((resolve, reject) => {\n          db.close((err: Error | null) => (err ? reject(err) : resolve()));\n        });\n      },\n    } as Database;\n  }\n\n  throw new Error('No SQLite driver available. Install either better-sqlite3 or sqlite3.');\n}\n"]}

package/dist/esm/adapters/test.js

@@ -0,0 +1,47 @@
+export function createTestDb() {
+    const tables = Object.create(null);
+    const ensure = (name) => (tables[name] || (tables[name] = []));
+    return {
+        dialect: 'sqlite',
+        async query(sql, params) {
+            const s = sql.trim().toUpperCase();
+            // Very small subset for tests: CREATE TABLE users
+            if (s.startsWith('CREATE TABLE USERS')) {
+                ensure('users');
+                return { rowsAffected: 0 };
+            }
+            // INSERT INTO users (id, email, status, ...)
+            if (s.startsWith('INSERT INTO USERS')) {
+                const users = ensure('users');
+                // naive: params order must match tests
+                const [id, email, status, created_at] = params;
+                users.push({ id, email, status, created_at });
+                return { rowsAffected: 1, lastInsertId: id };
+            }
+            // SELECT id, email, status FROM users WHERE email = ? AND status = ?
+            if (/FROM\s+users/i.test(sql) && /WHERE\s+email\s*=/.test(sql) && /status\s*=/.test(sql)) {
+                const [email, status] = params;
+                return ensure('users').filter((r) => r.email === email && r.status === status);
+            }
+            // SELECT id, email, status FROM users WHERE id = ?
+            if (/FROM\s+users/i.test(sql) && /WHERE\s+id\s*=/.test(sql)) {
+                const [id] = params;
+                return ensure('users').filter((r) => r.id === id).map((r) => ({ id: r.id, email: r.email, status: r.status }));
+            }
+            // SELECT id FROM users WHERE status = ? ORDER BY id
+            if (/FROM\s+users/i.test(sql) && /WHERE\s+status\s*=/.test(sql)) {
+                const [status] = params;
+                return ensure('users')
+                    .filter((r) => r.status === status)
+                    .sort((a, b) => String(a.id).localeCompare(String(b.id)))
+                    .map((r) => ({ id: r.id }));
+            }
+            // Fallback: return empty
+            return [];
+        },
+        conn: null,
+        // Ensure close exists; no-op for in-memory test adapter
+        close() { },
+    };
+}
+//# sourceMappingURL=test.js.map

package/dist/esm/adapters/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../../src/adapters/test.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Database } from '../registry';\n\ntype Row = Record<string, any>;\n\nexport function createTestDb(): Database {\n  const tables: Record<string, Row[]> = Object.create(null);\n  const ensure = (name: string) => (tables[name] ||= []);\n\n  return {\n    dialect: 'sqlite',\n    async query(sql: string, params: unknown[]) {\n      const s = sql.trim().toUpperCase();\n\n      // Very small subset for tests: CREATE TABLE users\n      if (s.startsWith('CREATE TABLE USERS')) {\n        ensure('users');\n        return { rowsAffected: 0 };\n      }\n\n      // INSERT INTO users (id, email, status, ...)\n      if (s.startsWith('INSERT INTO USERS')) {\n        const users = ensure('users');\n        // naive: params order must match tests\n        const [id, email, status, created_at] = params as any[];\n        users.push({ id, email, status, created_at });\n        return { rowsAffected: 1, lastInsertId: id };\n      }\n\n      // SELECT id, email, status FROM users WHERE email = ? AND status = ?\n      if (/FROM\\s+users/i.test(sql) && /WHERE\\s+email\\s*=/.test(sql) && /status\\s*=/.test(sql)) {\n        const [email, status] = params as any[];\n        return ensure('users').filter((r) => r.email === email && r.status === status);\n      }\n\n      // SELECT id, email, status FROM users WHERE id = ?\n      if (/FROM\\s+users/i.test(sql) && /WHERE\\s+id\\s*=/.test(sql)) {\n        const [id] = params as any[];\n        return ensure('users').filter((r) => r.id === id).map((r) => ({ id: r.id, email: r.email, status: r.status }));\n      }\n\n      // SELECT id FROM users WHERE status = ? ORDER BY id\n      if (/FROM\\s+users/i.test(sql) && /WHERE\\s+status\\s*=/.test(sql)) {\n        const [status] = params as any[];\n        return ensure('users')\n          .filter((r) => r.status === status)\n          .sort((a, b) => String(a.id).localeCompare(String(b.id)))\n          .map((r) => ({ id: r.id }));\n      }\n\n      // Fallback: return empty\n      return [];\n    },\n    conn: null,\n    // Ensure close exists; no-op for in-memory test adapter\n    close() {},\n  };\n}\n"]}

package/dist/esm/binders/sqlBinder.js

@@ -0,0 +1,182 @@
+export function createBinder(dialect) {
+    const placeholder = (indexRef) => {
+        if (dialect === 'postgres')
+            return `$${indexRef.i++}`;
+        return '?'; // mysql + sqlite
+    };
+    return {
+        bind(sql, args) {
+            const isArrayArgs = Array.isArray(args);
+            const params = [];
+            const out = [];
+            let i = 0;
+            let inSQ = false; // single quote string
+            let inDQ = false; // double quote identifier
+            let inLC = false; // line comment -- ...\n
+            let inBC = false; // block comment /* ... */
+            const pgIndex = { i: 1 };
+            let sawNamed = false;
+            let sawPositional = false;
+            const len = sql.length;
+            while (i < len) {
+                const ch = sql[i];
+                const next = i + 1 < len ? sql[i + 1] : '';
+                // Handle exiting comments/strings first
+                if (inLC) {
+                    out.push(ch);
+                    i++;
+                    if (ch === '\n')
+                        inLC = false;
+                    continue;
+                }
+                if (inBC) {
+                    out.push(ch);
+                    i++;
+                    if (ch === '*' && next === '/') {
+                        out.push(next);
+                        i++;
+                        inBC = false;
+                    }
+                    continue;
+                }
+                if (inSQ) {
+                    out.push(ch);
+                    i++;
+                    // escape '' inside string
+                    if (ch === "'" && next === "'") {
+                        out.push(next);
+                        i++;
+                    }
+                    else if (ch === "'") {
+                        inSQ = false;
+                    }
+                    continue;
+                }
+                if (inDQ) {
+                    out.push(ch);
+                    i++;
+                    // escape "" inside identifier
+                    if (ch === '"' && next === '"') {
+                        out.push(next);
+                        i++;
+                    }
+                    else if (ch === '"') {
+                        inDQ = false;
+                    }
+                    continue;
+                }
+                // Not inside string/comment
+                if (ch === '-' && next === '-') {
+                    out.push(ch, next);
+                    i += 2;
+                    inLC = true;
+                    continue;
+                }
+                if (ch === '/' && next === '*') {
+                    out.push(ch, next);
+                    i += 2;
+                    inBC = true;
+                    continue;
+                }
+                if (ch === "'") {
+                    out.push(ch);
+                    i++;
+                    inSQ = true;
+                    continue;
+                }
+                if (ch === '"') {
+                    out.push(ch);
+                    i++;
+                    inDQ = true;
+                    continue;
+                }
+                // Postgres cast :: — skip as literal
+                if (ch === ':' && next === ':') {
+                    out.push('::');
+                    i += 2;
+                    continue;
+                }
+                if (ch === ':') {
+                    // Attempt to parse a parameter token
+                    let j = i + 1;
+                    const start = j;
+                    while (j < len) {
+                        const c = sql[j];
+                        if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || (c >= '0' && c <= '9') || c === '_') {
+                            j++;
+                        }
+                        else {
+                            break;
+                        }
+                    }
+                    const name = sql.slice(start, j);
+                    if (!name) {
+                        // not a parameter — keep literal ':'
+                        out.push(':');
+                        i++;
+                        continue;
+                    }
+                    // Decide positional vs named
+                    const m = /^arg([1-9][0-9]*)$/.exec(name);
+                    const isPos = !!m;
+                    if (isPos)
+                        sawPositional = true;
+                    else
+                        sawNamed = true;
+                    if (sawNamed && sawPositional) {
+                        throw new Error('Cannot mix named and positional parameters in a single query');
+                    }
+                    let value;
+                    if (isPos) {
+                        if (!isArrayArgs)
+                            throw new Error('Positional placeholders require array arguments');
+                        const index = parseInt(m[1], 10) - 1; // 1-based in SQL
+                        const arr = args;
+                        if (index < 0 || index >= arr.length)
+                            throw new Error(`Missing positional argument :${name}`);
+                        value = arr[index];
+                    }
+                    else {
+                        if (isArrayArgs)
+                            throw new Error('Named placeholders require a parameter object');
+                        const obj = args;
+                        if (!Object.prototype.hasOwnProperty.call(obj, name)) {
+                            throw new Error(`Missing named parameter :${name}`);
+                        }
+                        value = obj[name];
+                    }
+                    if (value === undefined) {
+                        throw new Error(`Parameter :${name} is undefined`);
+                    }
+                    // Expand placeholder(s)
+                    if (Array.isArray(value)) {
+                        if (value.length === 0)
+                            throw new Error(`Array parameter :${name} must not be empty`);
+                        const placeholders = [];
+                        for (const v of value) {
+                            if (v === undefined)
+                                throw new Error(`Array parameter :${name} contains undefined`);
+                            placeholders.push(placeholder(pgIndex));
+                            params.push(v === undefined ? null : v);
+                        }
+                        out.push(placeholders.join(', '));
+                    }
+                    else {
+                        out.push(placeholder(pgIndex));
+                        params.push(value === undefined ? null : value);
+                    }
+                    i = j;
+                    continue;
+                }
+                // default: copy char
+                out.push(ch);
+                i++;
+            }
+            return { sql: out.join(''), params };
+        },
+    };
+}
+export const createMysqlBinder = () => createBinder('mysql');
+export const createSqliteBinder = () => createBinder('sqlite');
+export const createPostgresBinder = () => createBinder('postgres');
+//# sourceMappingURL=sqlBinder.js.map

package/dist/esm/binders/sqlBinder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlBinder.js","sourceRoot":"","sources":["../../../src/binders/sqlBinder.ts"],"names":[],"mappings":"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","sourcesContent":["export type BindResult = {\n  sql: string;\n  params: unknown[];\n};\n\nexport interface SqlBinder {\n  bind(sql: string, args: Record<string, unknown> | unknown[]): BindResult;\n}\n\ntype Dialect = 'mysql' | 'sqlite' | 'postgres';\n\nexport function createBinder(dialect: Dialect): SqlBinder {\n  const placeholder = (indexRef: { i: number }) => {\n    if (dialect === 'postgres') return `$${indexRef.i++}`;\n    return '?'; // mysql + sqlite\n  };\n\n  return {\n    bind(sql: string, args: Record<string, unknown> | unknown[]): BindResult {\n      const isArrayArgs = Array.isArray(args);\n      const params: unknown[] = [];\n      const out: string[] = [];\n\n      let i = 0;\n      let inSQ = false; // single quote string\n      let inDQ = false; // double quote identifier\n      let inLC = false; // line comment -- ...\\n\n      let inBC = false; // block comment /* ... */\n      const pgIndex = { i: 1 };\n\n      let sawNamed = false;\n      let sawPositional = false;\n\n      const len = sql.length;\n      while (i < len) {\n        const ch = sql[i];\n        const next = i + 1 < len ? sql[i + 1] : '';\n\n        // Handle exiting comments/strings first\n        if (inLC) {\n          out.push(ch);\n          i++;\n          if (ch === '\\n') inLC = false;\n          continue;\n        }\n        if (inBC) {\n          out.push(ch);\n          i++;\n          if (ch === '*' && next === '/') {\n            out.push(next);\n            i++;\n            inBC = false;\n          }\n          continue;\n        }\n        if (inSQ) {\n          out.push(ch);\n          i++;\n          // escape '' inside string\n          if (ch === \"'\" && next === \"'\") {\n            out.push(next);\n            i++;\n          } else if (ch === \"'\") {\n            inSQ = false;\n          }\n          continue;\n        }\n        if (inDQ) {\n          out.push(ch);\n          i++;\n          // escape \"\" inside identifier\n          if (ch === '\"' && next === '\"') {\n            out.push(next);\n            i++;\n          } else if (ch === '\"') {\n            inDQ = false;\n          }\n          continue;\n        }\n\n        // Not inside string/comment\n        if (ch === '-' && next === '-') {\n          out.push(ch, next);\n          i += 2;\n          inLC = true;\n          continue;\n        }\n        if (ch === '/' && next === '*') {\n          out.push(ch, next);\n          i += 2;\n          inBC = true;\n          continue;\n        }\n        if (ch === \"'\") {\n          out.push(ch);\n          i++;\n          inSQ = true;\n          continue;\n        }\n        if (ch === '\"') {\n          out.push(ch);\n          i++;\n          inDQ = true;\n          continue;\n        }\n\n        // Postgres cast :: — skip as literal\n        if (ch === ':' && next === ':') {\n          out.push('::');\n          i += 2;\n          continue;\n        }\n\n        if (ch === ':') {\n          // Attempt to parse a parameter token\n          let j = i + 1;\n          const start = j;\n          while (j < len) {\n            const c = sql[j];\n            if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || (c >= '0' && c <= '9') || c === '_') {\n              j++;\n            } else {\n              break;\n            }\n          }\n          const name = sql.slice(start, j);\n          if (!name) {\n            // not a parameter — keep literal ':'\n            out.push(':');\n            i++;\n            continue;\n          }\n\n          // Decide positional vs named\n          const m = /^arg([1-9][0-9]*)$/.exec(name);\n          const isPos = !!m;\n          if (isPos) sawPositional = true; else sawNamed = true;\n          if (sawNamed && sawPositional) {\n            throw new Error('Cannot mix named and positional parameters in a single query');\n          }\n\n          let value: unknown;\n          if (isPos) {\n            if (!isArrayArgs) throw new Error('Positional placeholders require array arguments');\n            const index = parseInt(m![1], 10) - 1; // 1-based in SQL\n            const arr = args as unknown[];\n            if (index < 0 || index >= arr.length) throw new Error(`Missing positional argument :${name}`);\n            value = arr[index];\n          } else {\n            if (isArrayArgs) throw new Error('Named placeholders require a parameter object');\n            const obj = args as Record<string, unknown>;\n            if (!Object.prototype.hasOwnProperty.call(obj, name)) {\n              throw new Error(`Missing named parameter :${name}`);\n            }\n            value = obj[name];\n          }\n\n          if (value === undefined) {\n            throw new Error(`Parameter :${name} is undefined`);\n          }\n\n          // Expand placeholder(s)\n          if (Array.isArray(value)) {\n            if (value.length === 0) throw new Error(`Array parameter :${name} must not be empty`);\n            const placeholders: string[] = [];\n            for (const v of value) {\n              if (v === undefined) throw new Error(`Array parameter :${name} contains undefined`);\n              placeholders.push(placeholder(pgIndex));\n              params.push(v === undefined ? null : v);\n            }\n            out.push(placeholders.join(', '));\n          } else {\n            out.push(placeholder(pgIndex));\n            params.push(value === undefined ? null : value);\n          }\n\n          i = j;\n          continue;\n        }\n\n        // default: copy char\n        out.push(ch);\n        i++;\n      }\n\n      return { sql: out.join(''), params };\n    },\n  };\n}\n\nexport const createMysqlBinder = () => createBinder('mysql');\nexport const createSqliteBinder = () => createBinder('sqlite');\nexport const createPostgresBinder = () => createBinder('postgres');\n"]}

package/dist/esm/core/errors.js

@@ -0,0 +1,25 @@
+export class SqlStackError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SqlStackError';
+    }
+}
+export class ExactlyOneRowError extends SqlStackError {
+    constructor(actualCount) {
+        super(`Expected exactly one row, got ${actualCount}`);
+        this.name = 'ExactlyOneRowError';
+    }
+}
+export class NoRowsError extends SqlStackError {
+    constructor() {
+        super('Expected at least one row, got 0');
+        this.name = 'NoRowsError';
+    }
+}
+export class RowsExistError extends SqlStackError {
+    constructor(actualCount) {
+        super(`Expected no rows, got ${actualCount}`);
+        this.name = 'RowsExistError';
+    }
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAgB;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,WAAmB;QAC7B,KAAK,CAAC,iCAAiC,WAAW,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,aAAa;IAC5C;QACE,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,aAAa;IAC/C,YAAY,WAAmB;QAC7B,KAAK,CAAC,yBAAyB,WAAW,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF","sourcesContent":["export class SqlStackError extends Error {\n  constructor(message?: string) {\n    super(message);\n    this.name = 'SqlStackError';\n  }\n}\n\nexport class ExactlyOneRowError extends SqlStackError {\n  constructor(actualCount: number) {\n    super(`Expected exactly one row, got ${actualCount}`);\n    this.name = 'ExactlyOneRowError';\n  }\n}\n\nexport class NoRowsError extends SqlStackError {\n  constructor() {\n    super('Expected at least one row, got 0');\n    this.name = 'NoRowsError';\n  }\n}\n\nexport class RowsExistError extends SqlStackError {\n  constructor(actualCount: number) {\n    super(`Expected no rows, got ${actualCount}`);\n    this.name = 'RowsExistError';\n  }\n}\n"]}

package/dist/esm/core/fileResolution.js

@@ -0,0 +1,74 @@
+import fs from 'fs';
+import path from 'path';
+const DIALECT_EXT = {
+    postgres: 'pg',
+    mysql: 'mysql',
+    sqlite: 'sqlite',
+};
+const contentCache = new Map();
+const pathCache = new Map();
+function key(root, method, dialect) {
+    return `${root}::${method}::${dialect}`;
+}
+export function resolveSqlFromFs(rootDir, methodName, dialect) {
+    const k = key(rootDir, methodName, dialect);
+    const tried = [];
+    const ext = DIALECT_EXT[dialect];
+    const dialectPath = path.join(rootDir, `${methodName}.${ext}.sql`);
+    const genericPath = path.join(rootDir, `${methodName}.sql`);
+    // Cached path
+    let chosen = pathCache.get(k);
+    if (!chosen) {
+        if (fs.existsSync(dialectPath)) {
+            chosen = dialectPath;
+        }
+        else if (fs.existsSync(genericPath)) {
+            chosen = genericPath;
+        }
+        if (chosen)
+            pathCache.set(k, chosen);
+    }
+    if (!chosen) {
+        tried.push(dialectPath, genericPath);
+        throw new Error(`sqlstack: SQL file not found for ${methodName}\ntried: ${tried.join(', ')}`);
+    }
+    // Cached content
+    let sql = contentCache.get(chosen);
+    if (!sql) {
+        sql = fs.readFileSync(chosen, 'utf8');
+        contentCache.set(chosen, sql);
+    }
+    return { sql, tried: [chosen] };
+}
+export function coerceRootPath(input) {
+    if (!input)
+        return {};
+    const stat = fs.existsSync(input) ? fs.statSync(input) : undefined;
+    if (stat?.isDirectory())
+        return { rootDir: input, from: 'folder' };
+    if (stat?.isFile())
+        return { rootDir: path.dirname(input), from: 'file' };
+    // If not found, treat as folder hint anyway
+    return { rootDir: input, from: 'folder' };
+}
+export function guessDecoratorDir() {
+    const err = new Error();
+    const stack = (err.stack || '').split('\n').slice(2);
+    for (const line of stack) {
+        const m = line.match(/\((.*?):\d+:\d+\)/) || line.match(/at (.*?):\d+:\d+/);
+        const file = m?.[1];
+        if (!file)
+            continue;
+        if (file.includes('node_modules'))
+            continue;
+        if (file.endsWith('.ts') || file.endsWith('.js')) {
+            try {
+                const dir = path.dirname(file);
+                return dir;
+            }
+            catch { }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=fileResolution.js.map

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

@@ -0,0 +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 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  // 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  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    if (file.includes('node_modules')) continue;\n    if (file.endsWith('.ts') || file.endsWith('.js')) {\n      try {\n        const dir = path.dirname(file);\n        return dir;\n      } catch {}\n    }\n  }\n  return undefined;\n}\n\n"]}

package/dist/esm/core/metadata.js

@@ -0,0 +1,24 @@
+const META = Symbol.for('sqlstack:meta');
+export function getMeta(target) {
+    if (!target[META]) {
+        target[META] = { methods: {} };
+    }
+    return target[META];
+}
+export function setMethodLabels(target, prop, patch) {
+    const meta = getMeta(target);
+    meta.methods[prop] = { ...(meta.methods[prop] || {}), ...patch };
+}
+export function getMethodLabels(instance, prop) {
+    const meta = getMeta(Object.getPrototypeOf(instance));
+    return meta.methods[prop] || {};
+}
+export function setClassLabels(ctor, patch) {
+    const meta = getMeta(ctor.prototype);
+    meta.class = { ...(meta.class || {}), ...patch };
+}
+export function getClassLabels(instance) {
+    const meta = getMeta(Object.getPrototypeOf(instance));
+    return meta.class;
+}
+//# sourceMappingURL=metadata.js.map

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

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