sqlstack 1.0.12 → 1.0.14

package/dist/esm/core/sqlParams.js

@@ -0,0 +1,117 @@
+/**
+ * Extracts named parameter names from SQL.
+ * Ignores parameters in string literals and comments.
+ */
+export function extractNamedParams(sql) {
+    const names = new Set();
+    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 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) {
+            i++;
+            if (ch === '\n')
+                inLC = false;
+            continue;
+        }
+        if (inBC) {
+            i++;
+            if (ch === '*' && next === '/') {
+                i++;
+                inBC = false;
+            }
+            continue;
+        }
+        if (inSQ) {
+            i++;
+            // escape '' inside string
+            if (ch === "'" && next === "'") {
+                i++;
+            }
+            else if (ch === "'") {
+                inSQ = false;
+            }
+            continue;
+        }
+        if (inDQ) {
+            i++;
+            // escape "" inside identifier
+            if (ch === '"' && next === '"') {
+                i++;
+            }
+            else if (ch === '"') {
+                inDQ = false;
+            }
+            continue;
+        }
+        // Not inside string/comment
+        if (ch === '-' && next === '-') {
+            i += 2;
+            inLC = true;
+            continue;
+        }
+        if (ch === '/' && next === '*') {
+            i += 2;
+            inBC = true;
+            continue;
+        }
+        if (ch === "'") {
+            i++;
+            inSQ = true;
+            continue;
+        }
+        if (ch === '"') {
+            i++;
+            inDQ = true;
+            continue;
+        }
+        // Postgres cast :: — skip as literal
+        if (ch === ':' && next === ':') {
+            i += 2;
+            continue;
+        }
+        if (ch === ':') {
+            // Attempt to parse a parameter token
+            let j = i + 1;
+            const start = j;
+            // Parameter name must start with letter or underscore
+            if (j < len) {
+                const c = sql[j];
+                if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || c === '_') {
+                    j++;
+                    // Continue with alphanumeric and underscore
+                    while (j < len) {
+                        const ch = sql[j];
+                        if ((ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z') || (ch >= '0' && ch <= '9') || ch === '_') {
+                            j++;
+                        }
+                        else {
+                            break;
+                        }
+                    }
+                    const name = sql.slice(start, j);
+                    // Don't add positional parameters (argN)
+                    const isPos = /^arg([1-9][0-9]*)$/.test(name);
+                    if (!isPos) {
+                        names.add(name);
+                    }
+                    i = j;
+                    continue;
+                }
+            }
+            // Not a valid parameter name, keep the colon
+            i++;
+            continue;
+        }
+        // default: skip char
+        i++;
+    }
+    return Array.from(names);
+}
+//# sourceMappingURL=sqlParams.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlParams.js","sourceRoot":"","sources":["../../../src/core/sqlParams.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Extracts named parameter names from SQL.\n * Ignores parameters in string literals and comments.\n */\nexport function extractNamedParams(sql: string): string[] {\n  const names = new Set<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\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      i++;\n      if (ch === '\\n') inLC = false;\n      continue;\n    }\n    if (inBC) {\n      i++;\n      if (ch === '*' && next === '/') {\n        i++;\n        inBC = false;\n      }\n      continue;\n    }\n    if (inSQ) {\n      i++;\n      // escape '' inside string\n      if (ch === \"'\" && next === \"'\") {\n        i++;\n      } else if (ch === \"'\") {\n        inSQ = false;\n      }\n      continue;\n    }\n    if (inDQ) {\n      i++;\n      // escape \"\" inside identifier\n      if (ch === '\"' && 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      i += 2;\n      inLC = true;\n      continue;\n    }\n    if (ch === '/' && next === '*') {\n      i += 2;\n      inBC = true;\n      continue;\n    }\n    if (ch === \"'\") {\n      i++;\n      inSQ = true;\n      continue;\n    }\n    if (ch === '\"') {\n      i++;\n      inDQ = true;\n      continue;\n    }\n\n    // Postgres cast :: — skip as literal\n    if (ch === ':' && next === ':') {\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\n      // Parameter name must start with letter or underscore\n      if (j < len) {\n        const c = sql[j];\n        if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || c === '_') {\n          j++;\n          // Continue with alphanumeric and underscore\n          while (j < len) {\n            const ch = sql[j];\n            if ((ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z') || (ch >= '0' && ch <= '9') || ch === '_') {\n              j++;\n            } else {\n              break;\n            }\n          }\n\n          const name = sql.slice(start, j);\n          // Don't add positional parameters (argN)\n          const isPos = /^arg([1-9][0-9]*)$/.test(name);\n          if (!isPos) {\n            names.add(name);\n          }\n          i = j;\n          continue;\n        }\n      }\n\n      // Not a valid parameter name, keep the colon\n      i++;\n      continue;\n    }\n\n    // default: skip char\n    i++;\n  }\n\n  return Array.from(names);\n}\n"]}

package/dist/esm/core/validator.js

@@ -1,13 +1,6 @@
 import Ajv from 'ajv';
 import addFormats from 'ajv-formats';
-import { SqlStackError } from './errors';
-export class ValidationError extends SqlStackError {
-    constructor(details) {
-        super(`Validation failed: ${details}`);
-        this.details = details;
-        this.name = 'ValidationError';
-    }
-}
+import { ValidationError } from './errors.js';
 const ajv = new Ajv({ allErrors: true, strict: false });
 addFormats(ajv);
 const cache = new WeakMap();

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

@@ -1 +1 @@
-{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../../src/core/validator.ts"],"names":[],"mappings":"AAAA,OAAO,GAAqB,MAAM,KAAK,CAAC;AACxC,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChD,YAAmB,OAAe;QAChC,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;QADtB,YAAO,GAAP,OAAO,CAAQ;QAEhC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AACxD,UAAU,CAAC,GAAG,CAAC,CAAC;AAEhB,MAAM,KAAK,GAAG,IAAI,OAAO,EAAsC,CAAC;AAEhE,SAAS,YAAY,CAAC,MAAW;IAC/B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,MAAgB,CAAC,CAAC;QAC7C,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,CAAC,GAAG,CAAC,MAAgB,EAAE,QAAQ,CAAC,CAAC;QACtC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,eAAe,CAAC,gBAAgB,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAW,EAAE,IAAS;IACnD,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,MAA+B,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5F,MAAM,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAyB;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,QAAQ,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5B,KAAK,GAAG,CAAC;QACT,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK,CAAC;QACX,KAAK,IAAI;YACP,OAAO,IAAI,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,oBAAoB;IAClC,8DAA8D;IAC9D,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;QAAE,OAAO,KAAK,CAAC;IACtE,yBAAyB;IACzB,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC;QAAE,OAAO,IAAI,CAAC;IACtE,uCAAuC;IACvC,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import Ajv, { DefinedError } from 'ajv';\nimport addFormats from 'ajv-formats';\nimport { SqlStackError } from './errors';\n\nexport class ValidationError extends SqlStackError {\n  constructor(public details: string) {\n    super(`Validation failed: ${details}`);\n    this.name = 'ValidationError';\n  }\n}\n\nconst ajv = new Ajv({ allErrors: true, strict: false });\naddFormats(ajv);\n\nconst cache = new WeakMap<object, ReturnType<Ajv['compile']>>();\n\nfunction getValidator(schema: any) {\n  if (schema && typeof schema === 'object') {\n    const existing = cache.get(schema as object);\n    if (existing) return existing;\n    const compiled = ajv.compile(schema);\n    cache.set(schema as object, compiled);\n    return compiled;\n  }\n  throw new ValidationError('Invalid schema');\n}\n\nexport function validateOutput(schema: any, data: any) {\n  const validate = getValidator(schema);\n  const ok = validate(data);\n  if (!ok) {\n    const msg = ajv.errorsText(validate.errors as DefinedError[] | null, { dataVar: 'result' });\n    throw new ValidationError(msg);\n  }\n}\n\nfunction isTruthyEnv(value: string | undefined): boolean {\n  if (!value) return false;\n  switch (value.toLowerCase()) {\n    case '1':\n    case 'true':\n    case 'yes':\n    case 'on':\n      return true;\n    default:\n      return false;\n  }\n}\n\n// SQLSTACK_DISABLE_VALIDATION: when truthy, validation is skipped.\nexport function isValidationDisabled(): boolean {\n  // Highest priority: explicit enable wins (even in production)\n  if (isTruthyEnv(process.env.SQLSTACK_ENABLE_VALIDATION)) return false;\n  // Next: explicit disable\n  if (isTruthyEnv(process.env.SQLSTACK_DISABLE_VALIDATION)) return true;\n  // Default: enabled in all environments\n  return false;\n}\n"]}
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../../src/core/validator.ts"],"names":[],"mappings":"AAAA,OAAO,GAAqB,MAAM,KAAK,CAAC;AACxC,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AACxD,UAAU,CAAC,GAAG,CAAC,CAAC;AAEhB,MAAM,KAAK,GAAG,IAAI,OAAO,EAAsC,CAAC;AAEhE,SAAS,YAAY,CAAC,MAAW;IAC/B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,MAAgB,CAAC,CAAC;QAC7C,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,CAAC,GAAG,CAAC,MAAgB,EAAE,QAAQ,CAAC,CAAC;QACtC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,eAAe,CAAC,gBAAgB,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAW,EAAE,IAAS;IACnD,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,MAA+B,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5F,MAAM,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAyB;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,QAAQ,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5B,KAAK,GAAG,CAAC;QACT,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK,CAAC;QACX,KAAK,IAAI;YACP,OAAO,IAAI,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,oBAAoB;IAClC,8DAA8D;IAC9D,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;QAAE,OAAO,KAAK,CAAC;IACtE,yBAAyB;IACzB,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC;QAAE,OAAO,IAAI,CAAC;IACtE,uCAAuC;IACvC,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import Ajv, { DefinedError } from 'ajv';\nimport addFormats from 'ajv-formats';\nimport { ValidationError } from './errors';\n\nconst ajv = new Ajv({ allErrors: true, strict: false });\naddFormats(ajv);\n\nconst cache = new WeakMap<object, ReturnType<Ajv['compile']>>();\n\nfunction getValidator(schema: any) {\n  if (schema && typeof schema === 'object') {\n    const existing = cache.get(schema as object);\n    if (existing) return existing;\n    const compiled = ajv.compile(schema);\n    cache.set(schema as object, compiled);\n    return compiled;\n  }\n  throw new ValidationError('Invalid schema');\n}\n\nexport function validateOutput(schema: any, data: any) {\n  const validate = getValidator(schema);\n  const ok = validate(data);\n  if (!ok) {\n    const msg = ajv.errorsText(validate.errors as DefinedError[] | null, { dataVar: 'result' });\n    throw new ValidationError(msg);\n  }\n}\n\nfunction isTruthyEnv(value: string | undefined): boolean {\n  if (!value) return false;\n  switch (value.toLowerCase()) {\n    case '1':\n    case 'true':\n    case 'yes':\n    case 'on':\n      return true;\n    default:\n      return false;\n  }\n}\n\n// SQLSTACK_DISABLE_VALIDATION: when truthy, validation is skipped.\nexport function isValidationDisabled(): boolean {\n  // Highest priority: explicit enable wins (even in production)\n  if (isTruthyEnv(process.env.SQLSTACK_ENABLE_VALIDATION)) return false;\n  // Next: explicit disable\n  if (isTruthyEnv(process.env.SQLSTACK_DISABLE_VALIDATION)) return true;\n  // Default: enabled in all environments\n  return false;\n}\n"]}

package/dist/esm/decorators/defaults.js

@@ -1,4 +1,4 @@
-import { setMethodLabels } from '../core/metadata';
+import { setMethodLabels } from '../core/metadata.js';
 export function Defaults(values) {
     return function (_target, prop) {
         setMethodLabels(_target, prop, { defaults: { ...(values || {}) } });

package/dist/esm/decorators/missingAsNull.js

@@ -0,0 +1,37 @@
+import { setMethodLabels } from '../core/metadata.js';
+/**
+ * Decorator that enables automatic binding of missing or undefined named SQL parameters as NULL.
+ *
+ * By default (without this decorator), missing/undefined parameters throw an error.
+ * With @MissingAsNull, they are bound as NULL instead, allowing SQL functions like
+ * COALESCE/IFNULL to provide fallback values for partial updates.
+ *
+ * @example
+ * ```
+ * @MissingAsNull()
+ * async updateUser(args: { id: string; name?: string; email?: string }) {
+ *   // Parameters not provided are bound as NULL
+ *   // SQL can use COALESCE: COALESCE(:name, name) keeps old name if :name is NULL
+ * }
+ * ```
+ *
+ * @example
+ * ```
+ * @MissingAsNull({ require: ['id'] })
+ * async updateUser(args: { id: string; name?: string }) {
+ *   // 'id' is required; missing it throws
+ *   // 'name' is optional; if missing, bound as NULL
+ * }
+ * ```
+ */
+export function MissingAsNull(options) {
+    return function (target, propertyKey, descriptor) {
+        setMethodLabels(target, propertyKey, {
+            missingAsNull: {
+                require: options?.require,
+            },
+        });
+        return descriptor;
+    };
+}
+//# sourceMappingURL=missingAsNull.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"missingAsNull.js","sourceRoot":"","sources":["../../../src/decorators/missingAsNull.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAUnD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,aAAa,CAAC,OAA8B;IAC1D,OAAO,UAAU,MAAW,EAAE,WAA4B,EAAE,UAA8B;QACxF,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE;YACnC,aAAa,EAAE;gBACb,OAAO,EAAE,OAAO,EAAE,OAAO;aAC1B;SACF,CAAC,CAAC;QACH,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { setMethodLabels } from '../core/metadata';\n\nexport interface MissingAsNullOptions {\n  /**\n   * Array of parameter names that must not be null.\n   * If a required parameter is missing or undefined, an error will be thrown.\n   */\n  require?: string[];\n}\n\n/**\n * Decorator that enables automatic binding of missing or undefined named SQL parameters as NULL.\n *\n * By default (without this decorator), missing/undefined parameters throw an error.\n * With @MissingAsNull, they are bound as NULL instead, allowing SQL functions like\n * COALESCE/IFNULL to provide fallback values for partial updates.\n *\n * @example\n * ```\n * @MissingAsNull()\n * async updateUser(args: { id: string; name?: string; email?: string }) {\n *   // Parameters not provided are bound as NULL\n *   // SQL can use COALESCE: COALESCE(:name, name) keeps old name if :name is NULL\n * }\n * ```\n *\n * @example\n * ```\n * @MissingAsNull({ require: ['id'] })\n * async updateUser(args: { id: string; name?: string }) {\n *   // 'id' is required; missing it throws\n *   // 'name' is optional; if missing, bound as NULL\n * }\n * ```\n */\nexport function MissingAsNull(options?: MissingAsNullOptions) {\n  return function (target: any, propertyKey: string | symbol, descriptor: PropertyDescriptor) {\n    setMethodLabels(target, propertyKey, {\n      missingAsNull: {\n        require: options?.require,\n      },\n    });\n    return descriptor;\n  };\n}\n"]}

package/dist/esm/decorators/page.js

@@ -1,4 +1,4 @@
-import { setMethodLabels } from '../core/metadata';
+import { setMethodLabels } from '../core/metadata.js';
 export function Page(size, options) {
     return function (_target, prop) {
         const zeroBase = options?.zeroBase === true;

package/dist/esm/decorators/query.js

@@ -1,9 +1,9 @@
-import { getClassLabels, getMethodLabels, setMethodLabels } from '../core/metadata';
-import { SqlStackError, ExactlyOneRowError, NoRowsError, RowsExistError } from '../core/errors';
-import { isValidationDisabled, validateOutput } from '../core/validator';
-import { SqlStackDB } from '../registry';
-import { createSqliteBinder, createMysqlBinder, createPostgresBinder } from '../binders/sqlBinder';
-import { coerceRootPath, guessDecoratorDir, resolveSqlFromFs } from '../core/fileResolution';
+import { getClassLabels, getMethodLabels, setMethodLabels } from '../core/metadata.js';
+import { SqlStackError, ExactlyOneRowError, NoRowsError, RowsExistError } from '../core/errors.js';
+import { isValidationDisabled, validateOutput } from '../core/validator.js';
+import { SqlStackDB } from '../registry.js';
+import { createSqliteBinder, createMysqlBinder, createPostgresBinder, extractNamedParams } from '../binders/sqlBinder.js';
+import { coerceRootPath, guessDecoratorDir, resolveSqlFromFs } from '../core/fileResolution.js';
 export function Query(arg) {
     return function (_target, prop, desc) {
         const options = typeof arg === 'string' ? undefined : arg;
@@ -56,6 +56,29 @@ export function Query(arg) {
                 const namedBase = callArgs.length > 0 ? callArgs[0] : undefined;
                 args = applyDefaults(labels.defaults, namedBase ?? {});
             }
+            // Handle @MissingAsNull before pagination
+            const missingAsNullCfg = labels.missingAsNull;
+            if (missingAsNullCfg && !hasPositional) {
+                // Only for named parameters
+                const namedParams = extractNamedParams(workingSql);
+                const namedArgs = args;
+                const required = new Set(missingAsNullCfg.require || []);
+                // Check required parameters (missing or undefined)
+                for (const param of required) {
+                    if (!(param in namedArgs) || namedArgs[param] === undefined) {
+                        throw new SqlStackError(`Missing required parameter :${param}`);
+                    }
+                }
+                // Bind missing/undefined parameters as NULL
+                for (const param of namedParams) {
+                    if (!(param in namedArgs)) {
+                        namedArgs[param] = null;
+                    }
+                    else if (namedArgs[param] === undefined) {
+                        namedArgs[param] = null;
+                    }
+                }
+            }
             // Compute paging and inject :offset/:limit (named mode) or rewrite to positional
             const pageCfg = labels.page;
             if (pageCfg) {

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 } 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';\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      // 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 db = SqlStackDB.get(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      const out = await db.query(boundSql, params);\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":"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","sourcesContent":["import { getClassLabels, getMethodLabels, setMethodLabels } from '../core/metadata';\nimport { SqlStackError, ExactlyOneRowError, NoRowsError, RowsExistError } from '../core/errors';\nimport { isValidationDisabled, validateOutput } from '../core/validator';\nimport { SqlStackDB } from '../registry';\nimport { createSqliteBinder, createMysqlBinder, createPostgresBinder, extractNamedParams } from '../binders/sqlBinder';\nimport { coerceRootPath, guessDecoratorDir, resolveSqlFromFs } from '../core/fileResolution';\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      // 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 db = SqlStackDB.get(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      // Handle @MissingAsNull before pagination\n      const missingAsNullCfg = labels.missingAsNull;\n      if (missingAsNullCfg && !hasPositional) {\n        // Only for named parameters\n        const namedParams = extractNamedParams(workingSql);\n        const namedArgs = args as Record<string, unknown>;\n        const required = new Set(missingAsNullCfg.require || []);\n\n        // Check required parameters (missing or undefined)\n        for (const param of required) {\n          if (!(param in namedArgs) || namedArgs[param] === undefined) {\n            throw new SqlStackError(`Missing required parameter :${param}`);\n          }\n        }\n\n        // Bind missing/undefined parameters as NULL\n        for (const param of namedParams) {\n          if (!(param in namedArgs)) {\n            namedArgs[param] = null;\n          } else if (namedArgs[param] === undefined) {\n            namedArgs[param] = null;\n          }\n        }\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      const out = await db.query(boundSql, params);\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/decorators/queryBinder.js

@@ -1,4 +1,4 @@
-import { setClassLabels } from '../core/metadata';
+import { setClassLabels } from '../core/metadata.js';
 export function QueryBinder(options) {
     return function (ctor) {
         setClassLabels(ctor, { db: options?.db });

package/dist/esm/decorators/resultShape.js

@@ -1,4 +1,4 @@
-import { setMethodLabels } from '../core/metadata';
+import { setMethodLabels } from '../core/metadata.js';
 export function Single(target, prop) {
     setMethodLabels(target, prop, { shape: 'single' });
 }

package/dist/esm/decorators/transform.js

@@ -1,4 +1,4 @@
-import { setMethodLabels } from '../core/metadata';
+import { setMethodLabels } from '../core/metadata.js';
 // Transform operates on the shaped value (array of rows, single row, or null)
 export function Transform(fn) {
     return function (target, prop) {

package/dist/esm/decorators/validateResult.js

@@ -1,4 +1,4 @@
-import { setMethodLabels } from '../core/metadata';
+import { setMethodLabels } from '../core/metadata.js';
 // Accept a JSON Schema directly
 export function ValidateResult(schema) {
     return function (target, prop) {

package/dist/esm/index.js

@@ -1,15 +1,20 @@
-export * from './binders/sqlBinder';
-export * from './core/errors';
-export * from './core/validator';
-export * from './registry';
-export * from './adapters';
-export * from './decorators/queryBinder';
-export * from './decorators/query';
-export * from './decorators/defaults';
-export * from './decorators/resultShape';
-export * from './decorators/validateResult';
-export * from './decorators/transform';
-export * from './decorators/page';
-export * from './utils/dto';
-export { WriteResult, PostgresWriteResult, QueryResult } from './runtimeTypes';
+// Decorators
+export * from './decorators/queryBinder.js';
+export * from './decorators/query.js';
+export * from './decorators/defaults.js';
+export * from './decorators/resultShape.js';
+export * from './decorators/validateResult.js';
+export * from './decorators/transform.js';
+export * from './decorators/page.js';
+export * from './decorators/missingAsNull.js';
+// Adapters
+export * from './adapters/index.js';
+// Errors and Validation
+export * from './core/errors.js';
+export * from './core/validator.js';
+// DTO Helper
+export * from './utils/dto.js';
+export { SqlStackDB } from './registry.js';
+// Legacy exports (kept for backward compatibility)
+export * from './binders/sqlBinder.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["export * from './binders/sqlBinder';\nexport * from './core/errors';\nexport * from './core/validator';\nexport * from './registry';\nexport * from './adapters';\nexport * from './decorators/queryBinder';\nexport * from './decorators/query';\nexport * from './decorators/defaults';\nexport * from './decorators/resultShape';\nexport * from './decorators/validateResult';\nexport * from './decorators/transform';\nexport * from './decorators/page';\nexport * from './utils/dto';\nexport { WriteResult, PostgresWriteResult, QueryResult } from './runtimeTypes';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAE3C,WAAW;AACX,cAAc,YAAY,CAAC;AAE3B,wBAAwB;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AAEjC,aAAa;AACb,cAAc,aAAa,CAAC;AAI5B,OAAO,EAAE,UAAU,EAAY,MAAM,YAAY,CAAC;AAElD,mDAAmD;AACnD,cAAc,qBAAqB,CAAC","sourcesContent":["// Decorators\nexport * from './decorators/queryBinder';\nexport * from './decorators/query';\nexport * from './decorators/defaults';\nexport * from './decorators/resultShape';\nexport * from './decorators/validateResult';\nexport * from './decorators/transform';\nexport * from './decorators/page';\nexport * from './decorators/missingAsNull';\n\n// Adapters\nexport * from './adapters';\n\n// Errors and Validation\nexport * from './core/errors';\nexport * from './core/validator';\n\n// DTO Helper\nexport * from './utils/dto';\n\n// Database Registry and Types\nexport type { Dialect, WriteResult, PostgresWriteResult, QueryResult, Database } from './registry';\nexport { SqlStackDB, IStackDB } from './registry';\n\n// Legacy exports (kept for backward compatibility)\nexport * from './binders/sqlBinder';\n"]}

package/dist/esm/registry.js

@@ -22,5 +22,10 @@ class Registry {
         return db;
     }
 }
-export const SqlStackDB = new Registry();
+// Ensure a single shared instance across module copies/usages
+const g = globalThis;
+if (!g.__SQLSTACK_SINGLETON__) {
+    g.__SQLSTACK_SINGLETON__ = new Registry();
+}
+export const SqlStackDB = g.__SQLSTACK_SINGLETON__;
 //# sourceMappingURL=registry.js.map

package/dist/esm/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"AAwBA,MAAM,QAAQ;IAAd;QACU,QAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;IAqB5C,CAAC;IAlBC,QAAQ,CAAC,IAAY,EAAE,EAAY;QACjC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;QACjF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,IAAa;QACf,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC;QACrC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACrD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAC;QAChE,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,QAAQ,EAAE,CAAC","sourcesContent":["export type Dialect = 'sqlite' | 'mysql' | 'postgres';\n\n// Result for non-SELECT statements across adapters\nexport interface WriteResult {\n  rowsAffected: number;\n  lastInsertId?: unknown;\n}\n\n// Postgres-specific extension when using RETURNING on write statements\nexport interface PostgresWriteResult extends WriteResult {\n  // Only present when the SQL includes RETURNING and rows are returned\n  returning?: any[];\n}\n\nexport type QueryResult = any[] | WriteResult | PostgresWriteResult;\n\nexport interface Database {\n  dialect: Dialect;\n  query(sql: string, params: unknown[]): Promise<QueryResult>;\n  // Underlying driver connection or pool (driver-specific)\n  conn: unknown;\n  close: () => Promise<void> | void;\n}\n\nclass Registry {\n  private map = new Map<string, Database>();\n  private defaultName?: string;\n\n  register(name: string, db: Database) {\n    this.map.set(name, db);\n    return this;\n  }\n\n  setDefault(name: string) {\n    if (!this.map.has(name)) throw new Error(`No database registered under ${name}`);\n    this.defaultName = name;\n    return this;\n  }\n\n  get(name?: string): Database {\n    const key = name ?? this.defaultName;\n    if (!key) throw new Error('No default database set');\n    const db = this.map.get(key);\n    if (!db) throw new Error(`No database registered under ${key}`);\n    return db;\n  }\n}\n\nexport const SqlStackDB = new Registry();\n"]}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"AAwBA,MAAM,QAAQ;IAAd;QACU,QAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;IAqB5C,CAAC;IAlBC,QAAQ,CAAC,IAAY,EAAE,EAAY;QACjC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;QACjF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,IAAa;QACf,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC;QACrC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACrD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAC;QAChE,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,8DAA8D;AAC9D,MAAM,CAAC,GAAG,UAAiB,CAAC;AAC5B,IAAI,CAAC,CAAC,CAAC,sBAAsB,EAAE,CAAC;IAC9B,CAAC,CAAC,sBAAsB,GAAG,IAAI,QAAQ,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAa,CAAC,CAAC,sBAAsB,CAAC","sourcesContent":["export type Dialect = 'sqlite' | 'mysql' | 'postgres';\n\n// Result for non-SELECT statements across adapters\nexport interface WriteResult {\n  rowsAffected: number;\n  lastInsertId?: unknown;\n}\n\n// Postgres-specific extension when using RETURNING on write statements\nexport interface PostgresWriteResult extends WriteResult {\n  // Only present when the SQL includes RETURNING and rows are returned\n  returning?: any[];\n}\n\nexport type QueryResult = any[] | WriteResult | PostgresWriteResult;\n\nexport interface Database {\n  dialect: Dialect;\n  query(sql: string, params: unknown[]): Promise<QueryResult>;\n  // Underlying driver connection or pool (driver-specific)\n  conn: unknown;\n  close: () => Promise<void> | void;\n}\n\nclass Registry {\n  private map = new Map<string, Database>();\n  private defaultName?: string;\n\n  register(name: string, db: Database) {\n    this.map.set(name, db);\n    return this;\n  }\n\n  setDefault(name: string) {\n    if (!this.map.has(name)) throw new Error(`No database registered under ${name}`);\n    this.defaultName = name;\n    return this;\n  }\n\n  get(name?: string): Database {\n    const key = name ?? this.defaultName;\n    if (!key) throw new Error('No default database set');\n    const db = this.map.get(key);\n    if (!db) throw new Error(`No database registered under ${key}`);\n    return db;\n  }\n}\n\n// Ensure a single shared instance across module copies/usages\nconst g = globalThis as any;\nif (!g.__SQLSTACK_SINGLETON__) {\n  g.__SQLSTACK_SINGLETON__ = new Registry();\n}\n\nexport const SqlStackDB: Registry = g.__SQLSTACK_SINGLETON__;\n\nexport type IStackDB = typeof SqlStackDB;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sqlstack",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "",
   "license": "ISC",
   "author": "",
@@ -35,7 +35,7 @@
   "scripts": {
     "build": "npm-run-all clean build:cjs build:esm",
     "build:cjs": "tsc -p tsconfig.json",
-    "build:esm": "tsc -p tsconfig.esm.json && node scripts/create-esm-package.cjs",
+    "build:esm": "tsc -p tsconfig.esm.json && node scripts/fix-esm-extensions.js && node scripts/create-esm-package.cjs",
     "test": "jest",
     "test:watch": "jest --watch",
     "clean": "rimraf dist",