@gjsify/sqlite 0.31.0 → 0.32.0

package/lib/esm/database-sync.js

@@ -1,2 +1,2 @@
-import"./_virtual/_rolldown/runtime.js";import{ConstructCallRequiredError as e,InvalidArgTypeError as t,InvalidStateError as n,InvalidUrlSchemeError as r,SqliteError as i}from"./errors.js";import{StatementSync as a}from"./statement-sync.js";import o from"@girs/gda-6.0";const s=Symbol.for(`sqlite-type`);function parsePath(e){if(typeof e==`string`){if(e.includes(`\0`))throw new t(`The "path" argument must be a string, Uint8Array, or URL without null bytes.`);return e}if(e instanceof URL){if(e.protocol!==`file:`)throw new r;let n=e.pathname;if(n.includes(`\0`))throw new t(`The "path" argument must be a string, Uint8Array, or URL without null bytes.`);return n}if(e instanceof Uint8Array){for(let n=0;n<e.length;n++)if(e[n]===0)throw new t(`The "path" argument must be a string, Uint8Array, or URL without null bytes.`);return new TextDecoder().decode(e)}throw new t(`The "path" argument must be a string, Uint8Array, or URL without null bytes.`)}function validateOptions(e){if(e===void 0)return{};if(typeof e!=`object`||!e)throw new t(`The "options" argument must be an object.`);let n=e,r={};if(n.open!==void 0){if(typeof n.open!=`boolean`)throw new t(`The "options.open" argument must be a boolean.`);r.open=n.open}if(n.readOnly!==void 0){if(typeof n.readOnly!=`boolean`)throw new t(`The "options.readOnly" argument must be a boolean.`);r.readOnly=n.readOnly}if(n.timeout!==void 0){if(typeof n.timeout!=`number`||!Number.isInteger(n.timeout))throw new t(`The "options.timeout" argument must be an integer.`);r.timeout=n.timeout}if(n.enableForeignKeyConstraints!==void 0){if(typeof n.enableForeignKeyConstraints!=`boolean`)throw new t(`The "options.enableForeignKeyConstraints" argument must be a boolean.`);r.enableForeignKeyConstraints=n.enableForeignKeyConstraints}if(n.enableDoubleQuotedStringLiterals!==void 0){if(typeof n.enableDoubleQuotedStringLiterals!=`boolean`)throw new t(`The "options.enableDoubleQuotedStringLiterals" argument must be a boolean.`);r.enableDoubleQuotedStringLiterals=n.enableDoubleQuotedStringLiterals}if(n.readBigInts!==void 0){if(typeof n.readBigInts!=`boolean`)throw new t(`The "options.readBigInts" argument must be a boolean.`);r.readBigInts=n.readBigInts}if(n.returnArrays!==void 0){if(typeof n.returnArrays!=`boolean`)throw new t(`The "options.returnArrays" argument must be a boolean.`);r.returnArrays=n.returnArrays}if(n.allowBareNamedParameters!==void 0){if(typeof n.allowBareNamedParameters!=`boolean`)throw new t(`The "options.allowBareNamedParameters" argument must be a boolean.`);r.allowBareNamedParameters=n.allowBareNamedParameters}if(n.allowUnknownNamedParameters!==void 0){if(typeof n.allowUnknownNamedParameters!=`boolean`)throw new t(`The "options.allowUnknownNamedParameters" argument must be a boolean.`);r.allowUnknownNamedParameters=n.allowUnknownNamedParameters}if(n.defensive!==void 0){if(typeof n.defensive!=`boolean`)throw new t(`The "options.defensive" argument must be a boolean.`);r.defensive=n.defensive}if(n.allowExtension!==void 0){if(typeof n.allowExtension!=`boolean`)throw new t(`The "options.allowExtension" argument must be a boolean.`);r.allowExtension=n.allowExtension}return r}function convertParameterSyntax(e){let t=[],n=0,r=``,i=0;for(;i<e.length;){if(e[i]===`'`){let t=i;for(i++;i<e.length&&e[i]!==`'`;){if(e[i]===`'`&&e[i+1]===`'`){i+=2;continue}i++}i<e.length&&i++,r+=e.substring(t,i);continue}if(e[i]===`?`){i++;let a=``;for(;i<e.length&&e[i]>=`0`&&e[i]<=`9`;)a+=e[i],i++;let o=a?parseInt(a,10)-1:n;n=a?n:n+1;let s=`p${o}`;t.push({gdaId:s,originalName:a?`?${a}`:`?`,position:o}),r+=`##${s}::string`;continue}if((e[i]===`$`||e[i]===`:`||e[i]===`@`)&&i+1<e.length&&/[a-zA-Z_]/.test(e[i+1])){let n=e[i];i++;let a=``;for(;i<e.length&&/[a-zA-Z0-9_]/.test(e[i]);)a+=e[i],i++;let o=a;t.push({gdaId:o,originalName:`${n}${a}`,position:-1}),r+=`##${o}::string`;continue}r+=e[i],i++}return[r,t]}var DatabaseSync=class{#e=null;#t=null;#n;#r;#i;#a=!1;constructor(t,n){if(!new.target)throw new e(`DatabaseSync`);this.#n=parsePath(t),this.#r=validateOptions(n),this.#i=this.#n===`:memory:`,this.#r.open!==!1&&this.open()}get[s](){return`node:sqlite`}get isOpen(){return this.#e!==null&&this.#e.is_opened()}get isTransaction(){return this.#o(),this.#a}open(){if(this.isOpen)throw new n(`database is already open`);try{if(this.#i)this.#e=o.Connection.new_from_string(`SQLite`,`DB_DIR=;DB_NAME=:memory:`,null,o.ConnectionOptions.NONE);else{let e=this.#n.lastIndexOf(`/`),t=e>=0?this.#n.substring(0,e):`.`,n=e>=0?this.#n.substring(e+1):this.#n,r=`DB_DIR=${t};DB_NAME=${n.endsWith(`.db`)?n.slice(0,-3):n}`,i=this.#r.readOnly?o.ConnectionOptions.READ_ONLY:o.ConnectionOptions.NONE;this.#e=o.Connection.new_from_string(`SQLite`,r,null,i)}this.#e.open()}catch(e){throw this.#e=null,new i(e instanceof Error?e.message:String(e))}this.#t=this.#e.create_parser()??new o.SqlParser,this.#s()}close(){if(!this.isOpen)throw new n(`database is not open`);this.#e.close(),this.#e=null,this.#t=null,this.#a=!1}sqlExec(e){if(this.#o(),typeof e!=`string`)throw new t(`The "sql" argument must be a string.`);try{let t=this.#l(e);for(let e of t){let[t]=this.#t.parse_string(e);t&&this.#c(t)}}catch(e){throw e instanceof i||e instanceof n||e instanceof t?e:new i(e instanceof Error?e.message:String(e))}this.#u(e)}prepare(e,n){if(this.#o(),typeof e!=`string`)throw new t(`The "sql" argument must be a string.`);let[,r]=convertParameterSyntax(e);try{let t=r.length>0?e.replace(/\?(\d+)?/g,`NULL`).replace(/[$:@][a-zA-Z_][a-zA-Z0-9_]*/g,`NULL`):e,[n]=this.#t.parse_string(t);if(!n)throw new i(`Failed to parse SQL statement`)}catch(e){throw e instanceof i||e instanceof t?e:new i(e instanceof Error?e.message:String(e))}let o={readBigInts:this.#r.readBigInts??!1,returnArrays:this.#r.returnArrays??!1,allowBareNamedParameters:this.#r.allowBareNamedParameters??!0,allowUnknownNamedParameters:this.#r.allowUnknownNamedParameters??!1};return a._create(this.#e,e,o,r,this.#t)}location(e){if(this.#o(),e!==void 0&&typeof e!=`string`)throw new t(`The "dbName" argument must be a string.`);return this.#i?null:this.#n}[Symbol.dispose](){if(this.isOpen)try{this.close()}catch{}}#o(){if(!this.isOpen)throw new n(`database is not open`)}#s(){let e=this.#e,runPragma=t=>{let[n]=this.#t.parse_string(t);n&&e.statement_execute_select(n,null)};this.#r.enableForeignKeyConstraints===!1?runPragma(`PRAGMA foreign_keys = OFF`):runPragma(`PRAGMA foreign_keys = ON`),this.#r.timeout!==void 0&&this.#r.timeout>0&&runPragma(`PRAGMA busy_timeout = ${this.#r.timeout}`)}#c(e){if(e.get_statement_type()===o.SqlStatementType.SELECT)this.#e.statement_execute_select(e,null);else try{this.#e.statement_execute_non_select(e,null)}catch{this.#e.statement_execute_select(e,null)}}#l(e){let t=[],n=``,r=e.length,i=0,flush=()=>{let e=n.trim();e.length>0&&t.push(e),n=``};for(;i<r;){let t=e[i],a=e[i+1];if(t===`-`&&a===`-`){let t=i+2;for(;t<r&&e[t]!==`
-`;)t++;i=t;continue}if(t===`/`&&a===`*`){let t=i+2;for(;t<r&&!(e[t]===`*`&&e[t+1]===`/`);)t++;i=t<r?t+2:r,n+=` `;continue}if(t===`'`||t===`"`||t==="`"||t===`[`){let a=t===`[`?`]`:t,o=t!==`[`,s=i+1;for(n+=t;s<r;){if(e[s]===a){if(o&&e[s+1]===a){n+=a+a,s+=2;continue}n+=a,s++;break}n+=e[s],s++}i=s;continue}if(t===`;`){flush(),i++;continue}n+=t,i++}return flush(),t}#u(e){let t=e.trim().toUpperCase();/\bBEGIN\b/.test(t)&&(this.#a=!0),(/\bCOMMIT\b/.test(t)||/\bROLLBACK\b/.test(t))&&(this.#a=!1)}};DatabaseSync.prototype.exec=DatabaseSync.prototype.sqlExec;export{DatabaseSync};
+import"./_virtual/_rolldown/runtime.js";import{ConstructCallRequiredError as e,InvalidArgTypeError as t,InvalidStateError as n,InvalidUrlSchemeError as r,SqliteError as i}from"./errors.js";import{convertParameterSyntax as a}from"./parameter-syntax.js";import{parseSql as o}from"./parse-sql.js";import{StatementSync as s}from"./statement-sync.js";import c from"@girs/gda-6.0";const l=Symbol.for(`sqlite-type`);function parsePath(e){if(typeof e==`string`){if(e.includes(`\0`))throw new t(`The "path" argument must be a string, Uint8Array, or URL without null bytes.`);return e}if(e instanceof URL){if(e.protocol!==`file:`)throw new r;let n=e.pathname;if(n.includes(`\0`))throw new t(`The "path" argument must be a string, Uint8Array, or URL without null bytes.`);return n}if(e instanceof Uint8Array){for(let n=0;n<e.length;n++)if(e[n]===0)throw new t(`The "path" argument must be a string, Uint8Array, or URL without null bytes.`);return new TextDecoder().decode(e)}throw new t(`The "path" argument must be a string, Uint8Array, or URL without null bytes.`)}function validateOptions(e){if(e===void 0)return{};if(typeof e!=`object`||!e)throw new t(`The "options" argument must be an object.`);let n=e,r={};if(n.open!==void 0){if(typeof n.open!=`boolean`)throw new t(`The "options.open" argument must be a boolean.`);r.open=n.open}if(n.readOnly!==void 0){if(typeof n.readOnly!=`boolean`)throw new t(`The "options.readOnly" argument must be a boolean.`);r.readOnly=n.readOnly}if(n.timeout!==void 0){if(typeof n.timeout!=`number`||!Number.isInteger(n.timeout))throw new t(`The "options.timeout" argument must be an integer.`);r.timeout=n.timeout}if(n.enableForeignKeyConstraints!==void 0){if(typeof n.enableForeignKeyConstraints!=`boolean`)throw new t(`The "options.enableForeignKeyConstraints" argument must be a boolean.`);r.enableForeignKeyConstraints=n.enableForeignKeyConstraints}if(n.enableDoubleQuotedStringLiterals!==void 0){if(typeof n.enableDoubleQuotedStringLiterals!=`boolean`)throw new t(`The "options.enableDoubleQuotedStringLiterals" argument must be a boolean.`);r.enableDoubleQuotedStringLiterals=n.enableDoubleQuotedStringLiterals}if(n.readBigInts!==void 0){if(typeof n.readBigInts!=`boolean`)throw new t(`The "options.readBigInts" argument must be a boolean.`);r.readBigInts=n.readBigInts}if(n.returnArrays!==void 0){if(typeof n.returnArrays!=`boolean`)throw new t(`The "options.returnArrays" argument must be a boolean.`);r.returnArrays=n.returnArrays}if(n.allowBareNamedParameters!==void 0){if(typeof n.allowBareNamedParameters!=`boolean`)throw new t(`The "options.allowBareNamedParameters" argument must be a boolean.`);r.allowBareNamedParameters=n.allowBareNamedParameters}if(n.allowUnknownNamedParameters!==void 0){if(typeof n.allowUnknownNamedParameters!=`boolean`)throw new t(`The "options.allowUnknownNamedParameters" argument must be a boolean.`);r.allowUnknownNamedParameters=n.allowUnknownNamedParameters}if(n.defensive!==void 0){if(typeof n.defensive!=`boolean`)throw new t(`The "options.defensive" argument must be a boolean.`);r.defensive=n.defensive}if(n.allowExtension!==void 0){if(typeof n.allowExtension!=`boolean`)throw new t(`The "options.allowExtension" argument must be a boolean.`);r.allowExtension=n.allowExtension}return r}var DatabaseSync=class{#e=null;#t;#n;#r;#i=!1;constructor(t,n){if(!new.target)throw new e(`DatabaseSync`);this.#t=parsePath(t),this.#n=validateOptions(n),this.#r=this.#t===`:memory:`,this.#n.open!==!1&&this.open()}get[l](){return`node:sqlite`}get isOpen(){return this.#e!==null&&this.#e.is_opened()}get isTransaction(){return this.#a(),this.#i}open(){if(this.isOpen)throw new n(`database is already open`);try{if(this.#r)this.#e=c.Connection.new_from_string(`SQLite`,`DB_DIR=;DB_NAME=:memory:`,null,c.ConnectionOptions.NONE);else{let e=this.#t.lastIndexOf(`/`),t=e>=0?this.#t.substring(0,e):`.`,n=e>=0?this.#t.substring(e+1):this.#t,r=`DB_DIR=${t};DB_NAME=${n.endsWith(`.db`)?n.slice(0,-3):n}`,i=this.#n.readOnly?c.ConnectionOptions.READ_ONLY:c.ConnectionOptions.NONE;this.#e=c.Connection.new_from_string(`SQLite`,r,null,i)}this.#e.open()}catch(e){throw this.#e=null,new i(e instanceof Error?e.message:String(e))}this.#s()}close(){if(!this.isOpen)throw new n(`database is not open`);this.#e.close(),this.#e=null,this.#i=!1}sqlExec(e){if(this.#a(),typeof e!=`string`)throw new t(`The "sql" argument must be a string.`);try{let t=this.#l(e);for(let e of t){let[t]=this.#o(e);this.#c(t)}}catch(e){throw e instanceof i||e instanceof n||e instanceof t?e:new i(e instanceof Error?e.message:String(e))}this.#u(e)}prepare(e,n){if(this.#a(),typeof e!=`string`)throw new t(`The "sql" argument must be a string.`);let[r,o]=a(e);try{this.#o(r)}catch(e){throw e instanceof i||e instanceof t?e:new i(e instanceof Error?e.message:String(e))}let c={readBigInts:this.#n.readBigInts??!1,returnArrays:this.#n.returnArrays??!1,allowBareNamedParameters:this.#n.allowBareNamedParameters??!0,allowUnknownNamedParameters:this.#n.allowUnknownNamedParameters??!1};return s._create(this.#e,e,c,o)}location(e){if(this.#a(),e!==void 0&&typeof e!=`string`)throw new t(`The "dbName" argument must be a string.`);return this.#r?null:this.#t}[Symbol.dispose](){if(this.isOpen)try{this.close()}catch{}}#a(){if(!this.isOpen)throw new n(`database is not open`)}#o(e){return o(this.#e,e)}#s(){let e=this.#e,runPragma=t=>{let[n]=this.#o(t);e.statement_execute_select(n,null)};this.#n.enableForeignKeyConstraints===!1?runPragma(`PRAGMA foreign_keys = OFF`):runPragma(`PRAGMA foreign_keys = ON`),this.#n.timeout!==void 0&&this.#n.timeout>0&&runPragma(`PRAGMA busy_timeout = ${this.#n.timeout}`)}#c(e){if(e.get_statement_type()===c.SqlStatementType.SELECT)this.#e.statement_execute_select(e,null);else try{this.#e.statement_execute_non_select(e,null)}catch{this.#e.statement_execute_select(e,null)}}#l(e){let t=[],n=``,r=e.length,i=0,flush=()=>{let e=n.trim();e.length>0&&t.push(e),n=``};for(;i<r;){let t=e[i],a=e[i+1];if(t===`-`&&a===`-`){let t=i+2;for(;t<r&&e[t]!==`
+`;)t++;i=t;continue}if(t===`/`&&a===`*`){let t=i+2;for(;t<r&&!(e[t]===`*`&&e[t+1]===`/`);)t++;i=t<r?t+2:r,n+=` `;continue}if(t===`'`||t===`"`||t==="`"||t===`[`){let a=t===`[`?`]`:t,o=t!==`[`,s=i+1;for(n+=t;s<r;){if(e[s]===a){if(o&&e[s+1]===a){n+=a+a,s+=2;continue}n+=a,s++;break}n+=e[s],s++}i=s;continue}if(t===`;`){flush(),i++;continue}n+=t,i++}return flush(),t}#u(e){let t=e.trim().toUpperCase();/\bBEGIN\b/.test(t)&&(this.#i=!0),(/\bCOMMIT\b/.test(t)||/\bROLLBACK\b/.test(t))&&(this.#i=!1)}};DatabaseSync.prototype.exec=DatabaseSync.prototype.sqlExec;export{DatabaseSync};

package/lib/esm/param-binding.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{InvalidArgTypeError as e,InvalidArgValueError as t,InvalidStateError as n,SqliteError as r}from"./errors.js";function setHolderPrim(e,t){return e.set_value(t)}function validateBindValue(t,n){if(t==null)return;let r=typeof t;if(!(r===`number`||r===`bigint`||r===`string`||r===`boolean`)&&!(t instanceof Uint8Array||t instanceof ArrayBuffer)&&!ArrayBuffer.isView(t))throw new e(`Provided value cannot be bound to SQLite parameter ${n}.`)}function setHolderValue(e,n){if(n==null){e.set_value(null);return}if(typeof n==`number`){setHolderPrim(e,n);return}if(typeof n==`bigint`){if(n>9223372036854775807n||n<-9223372036854775808n)throw new t(`BigInt value is too large to bind.`);setHolderPrim(e,Number(n));return}if(typeof n==`string`){setHolderPrim(e,n);return}if(typeof n==`boolean`){setHolderPrim(e,+!!n);return}if(n instanceof Uint8Array||ArrayBuffer.isView(n)){setHolderPrim(e,n instanceof Uint8Array?n:new Uint8Array(n.buffer));return}e.set_value(n)}function bindParameters(e,t,i,a){if(!e){if(t.length>0)throw new r(`column index out of range`,25,`column index out of range`);return}let o=e.get_holders();if(i){let e=new Set;for(let t of o){let r=t.get_id(),s,c=!1;if(r in i&&(s=i[r],e.add(r),c=!0),!c&&a.allowBareNamedParameters){let t=r.replace(/^[$:@]/,``);t in i&&(s=i[t],e.add(t),c=!0)}if(!c&&!a.allowBareNamedParameters){let e=r.replace(/^[$:@]/,``);if(e in i)throw new n(`Unknown named parameter '${e}'`)}if(c){let e=o.indexOf(t)+1;validateBindValue(s,e),setHolderValue(t,s)}else setHolderValue(t,null)}if(!a.allowUnknownNamedParameters){for(let t of Object.keys(i))if(!e.has(t)&&!o.some(e=>{let n=e.get_id();return n===t||n.replace(/^[$:@]/,``)===t}))throw new n(`Unknown named parameter '${t}'`)}}else{if(t.length>o.length)throw new r(`column index out of range`,25,`column index out of range`);for(let e=0;e<o.length;e++){let n=e<t.length?t[e]:void 0;validateBindValue(n,e+1),setHolderValue(o[e],n??null)}}}export{bindParameters};
+import"./_virtual/_rolldown/runtime.js";import{SqliteError as e}from"./errors.js";function setHolderString(e,t){return e.set_value(t)}function bindStringHolders(t,n){if(n.size!==0){if(!t)throw new e(`Failed to bind parameters: statement has no parameter set`);for(let[r,i]of n){let n=t.get_holder(r);if(!n)throw new e(`Failed to bind parameter '${r}'`);setHolderString(n,i)}}}export{bindStringHolders};

package/lib/esm/parameter-syntax.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";const asStringHolder=e=>`##${e.gdaId}::string`;function convertParameterSyntax(e,t=asStringHolder){let n=[],r=0,i=``,a=0;for(;a<e.length;){if(e[a]===`'`){let t=a;for(a++;a<e.length&&e[a]!==`'`;){if(e[a]===`'`&&e[a+1]===`'`){a+=2;continue}a++}a<e.length&&a++,i+=e.substring(t,a);continue}if(e[a]===`?`){a++;let o=``;for(;a<e.length&&e[a]>=`0`&&e[a]<=`9`;)o+=e[a],a++;let s=o?parseInt(o,10)-1:r;r=o?r:r+1;let c={gdaId:`p${s}`,originalName:o?`?${o}`:`?`,position:s};n.push(c),i+=t(c);continue}if((e[a]===`$`||e[a]===`:`||e[a]===`@`)&&a+1<e.length&&/[a-zA-Z_]/.test(e[a+1])){let r=e[a];a++;let o=``;for(;a<e.length&&/[a-zA-Z0-9_]/.test(e[a]);)o+=e[a],a++;let s={gdaId:o,originalName:`${r}${o}`,position:-1};n.push(s),i+=t(s);continue}i+=e[a],a++}return[i,n]}export{asStringHolder,convertParameterSyntax};

package/lib/esm/parse-sql.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";import{SqliteError as e}from"./errors.js";function parseSql(t,n){let[r,i]=t.parse_sql_string(n);if(!r)throw new e(`Failed to parse SQL statement`);return[r,i]}export{parseSql};

package/lib/esm/statement-sync.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{IllegalConstructorError as e,InvalidArgTypeError as t,InvalidArgValueError as n,SqliteError as r}from"./errors.js";import{readAllRows as i,readFirstRow as a}from"./data-model-reader.js";import o from"@girs/gda-6.0";const s=Symbol(`StatementSync.internal`);function validateBindValue(e,n){if(e===null)return;let r=typeof e;if(!(r===`number`||r===`bigint`||r===`string`||r===`boolean`)&&!(e instanceof Uint8Array||e instanceof ArrayBuffer)&&!ArrayBuffer.isView(e))throw new t(`Provided value cannot be bound to SQLite parameter ${n}.`)}function sqlEscapeValue(e){if(e==null)return`NULL`;if(typeof e==`number`)return String(e);if(typeof e==`boolean`)return e?`1`:`0`;if(typeof e==`bigint`){if(e>9223372036854775807n||e<-9223372036854775808n)throw new n(`BigInt value is too large to bind.`);return String(e)}if(typeof e==`string`)return`'`+e.replace(/'/g,`''`)+`'`;if(e instanceof Uint8Array){let t=``;for(let n=0;n<e.length;n++)t+=e[n].toString(16).padStart(2,`0`);return`X'`+t+`'`}return ArrayBuffer.isView(e)?sqlEscapeValue(new Uint8Array(e.buffer)):`NULL`}var c=class StatementSync{#e;#t;#n;#r;#i;#a;#o;#s;constructor(t,n,r,i,a,o){if(t!==s)throw new e;this.#e=n,this.#t=r,this.#n=a,this.#r=i.readBigInts??!1,this.#i=i.returnArrays??!1,this.#a=i.allowBareNamedParameters??!0,this.#o=i.allowUnknownNamedParameters??!1,this.#s=o}static _create(e,t,n,r,i){return new StatementSync(s,e,t,n,r,i)}get sourceSQL(){return this.#t}get expandedSQL(){return this.#t}#c(){return{readBigInts:this.#r,returnArrays:this.#i}}#l(e){if(this.#n.length===0){if(e.length>0&&!(e.length>0&&e[0]!==null&&typeof e[0]==`object`&&!(e[0]instanceof Uint8Array)&&!ArrayBuffer.isView(e[0])))throw new r(`column index out of range`,25,`column index out of range`);return this.#t}let t=null,n=e;e.length>0&&e[0]!==null&&typeof e[0]==`object`&&!(e[0]instanceof Uint8Array)&&!ArrayBuffer.isView(e[0])&&(t=e[0],n=e.slice(1));let i=new Map,a={};if(t){for(let e of this.#n){if(e.position>=0)continue;let n=e.originalName,a,o=!1;if(n in t&&(a=t[n],o=!0),!o&&this.#a){let e=n.replace(/^[$:@]/,``);e in t&&(a=t[e],o=!0)}if(!o&&!this.#a){let e=n.replace(/^[$:@]/,``);if(e in t)throw new r(`Unknown named parameter '${e}'`,0,`Unknown named parameter '${e}'`)}o?(validateBindValue(a,this.#n.indexOf(e)+1),i.set(e.originalName,sqlEscapeValue(a))):i.set(e.originalName,`NULL`)}if(!this.#o){let e=new Set;for(let t of this.#n)t.position>=0||(e.add(t.originalName),e.add(t.originalName.replace(/^[$:@]/,``)));for(let n of Object.keys(t))if(!e.has(n)&&!e.has(n.replace(/^[$:@]/,``)))throw new r(`Unknown named parameter '${n}'`,0,`Unknown named parameter '${n}'`)}let e=this.#n.filter(e=>e.position>=0);for(let t=0;t<n.length;t++){if(t>=e.length)throw new r(`column index out of range`,25,`column index out of range`);validateBindValue(n[t],t+1),a[e[t].position]=sqlEscapeValue(n[t])}}else{let e=this.#n.filter(e=>e.position>=0);if(n.length>e.length&&e.length>0)throw new r(`column index out of range`,25,`column index out of range`);for(let t=0;t<e.length;t++)t<n.length?(validateBindValue(n[t],t+1),a[e[t].position]=sqlEscapeValue(n[t])):a[e[t].position]=`NULL`}let o=this.#t,s=this.#n.filter(e=>e.position<0).sort((e,t)=>t.originalName.length-e.originalName.length);for(let e of s){let t=i.get(e.originalName)??`NULL`;o=o.split(e.originalName).join(t)}if(Object.keys(a).length>0){let e=``,t=0,n=0;for(;n<o.length;){if(o[n]===`'`){let t=n;for(n++;n<o.length&&o[n]!==`'`;){if(o[n]===`'`&&o[n+1]===`'`){n+=2;continue}n++}n<o.length&&n++,e+=o.substring(t,n);continue}if(o[n]===`?`){n++;let r=``;for(;n<o.length&&o[n]>=`0`&&o[n]<=`9`;)r+=o[n],n++;let i=r?parseInt(r,10)-1:t;t=r?t:t+1,e+=i in a?a[i]:`NULL`;continue}e+=o[n],n++}o=e}return o}#u(e){let[t]=this.#s.parse_string(e);if(!t)throw new r(`Failed to parse SQL statement`);if(t.get_statement_type()===o.SqlStatementType.SELECT)return{model:this.#e.statement_execute_select(t,null),isSelect:!0};try{return this.#e.statement_execute_non_select(t,null),{model:null,isSelect:!1}}catch{return{model:this.#e.statement_execute_select(t,null),isSelect:!0}}}run(...e){let t=this.#l(e);this.#u(t);let n=0,r=0;try{let e=this.#e.execute_select_command(`SELECT changes()`);e&&e.get_n_rows()>0&&(n=e.get_value_at(0,0))}catch{}try{let e=this.#e.execute_select_command(`SELECT last_insert_rowid()`);e&&e.get_n_rows()>0&&(r=e.get_value_at(0,0))}catch{}return this.#r&&(n=BigInt(n),r=BigInt(r)),{changes:n,lastInsertRowid:r}}get(...e){let t=this.#l(e);try{let{model:e}=this.#u(t);return!e||e.get_n_rows()===0?void 0:a(e,this.#c())}catch{return}}all(...e){let t=this.#l(e);try{let{model:e}=this.#u(t);return e?i(e,this.#c()):[]}catch{return[]}}setReadBigInts(e){if(typeof e!=`boolean`)throw new t(`The "readBigInts" argument must be a boolean.`);this.#r=e}setReturnArrays(e){if(typeof e!=`boolean`)throw new t(`The "returnArrays" argument must be a boolean.`);this.#i=e}setAllowBareNamedParameters(e){if(typeof e!=`boolean`)throw new t(`The "allowBareNamedParameters" argument must be a boolean.`);this.#a=e}setAllowUnknownNamedParameters(e){if(typeof e!=`boolean`)throw new t(`The "allowUnknownNamedParameters" argument must be a boolean.`);this.#o=e}};export{c as StatementSync};
+import"./_virtual/_rolldown/runtime.js";import{IllegalConstructorError as e,InvalidArgTypeError as t,InvalidArgValueError as n,SqliteError as r}from"./errors.js";import{readAllRows as i,readFirstRow as a}from"./data-model-reader.js";import{convertParameterSyntax as o}from"./parameter-syntax.js";import{parseSql as s}from"./parse-sql.js";import{bindStringHolders as c}from"./param-binding.js";import l from"@girs/gda-6.0";const u=Symbol(`StatementSync.internal`);function isNamedArgObject(e){return typeof e==`object`&&!!e&&!(e instanceof Uint8Array)&&!ArrayBuffer.isView(e)}function validateBindValue(e,n){if(e===null)return;let r=typeof e;if(!(r===`number`||r===`bigint`||r===`string`||r===`boolean`)&&!(e instanceof Uint8Array||e instanceof ArrayBuffer)&&!ArrayBuffer.isView(e))throw new t(`Provided value cannot be bound to SQLite parameter ${n}.`)}function sqlLiteral(e){if(e==null)return`NULL`;if(typeof e==`number`){if(Number.isNaN(e))return`NULL`;if(e===1/0)return`9e999`;if(e===-1/0)return`-9e999`;let t=String(e);return Number.isInteger(e)&&!t.includes(`e`)&&!t.includes(`E`)?`${t}.0`:t}if(typeof e==`boolean`)return e?`1`:`0`;if(typeof e==`bigint`){if(e>9223372036854775807n||e<-9223372036854775808n)throw new n(`BigInt value is too large to bind.`);return String(e)}if(e instanceof Uint8Array){let t=``;for(let n=0;n<e.length;n++)t+=e[n].toString(16).padStart(2,`0`);return`X'`+t+`'`}return ArrayBuffer.isView(e)?sqlLiteral(new Uint8Array(e.buffer)):`NULL`}var d=class StatementSync{#e;#t;#n;#r;#i;#a;#o;constructor(t,n,r,i,a){if(t!==u)throw new e;this.#e=n,this.#t=r,this.#n=a,this.#r=i.readBigInts??!1,this.#i=i.returnArrays??!1,this.#a=i.allowBareNamedParameters??!0,this.#o=i.allowUnknownNamedParameters??!1}static _create(e,t,n,r){return new StatementSync(u,e,t,n,r)}get sourceSQL(){return this.#t}get expandedSQL(){return this.#t}#s(){return{readBigInts:this.#r,returnArrays:this.#i}}#c(){let e=-1;for(let t of this.#n)t.position>e&&(e=t.position);return e}#l(e){let t=new Map;if(this.#n.length===0){if(e.length>0&&!isNamedArgObject(e[0]))throw new r(`column index out of range`,25,`column index out of range`);return{sql:this.#t,strings:t}}let n=null,i=e;e.length>0&&isNamedArgObject(e[0])&&(n=e[0],i=e.slice(1));let a=new Map;if(n){for(let e of this.#n){if(e.position>=0)continue;let t=e.originalName,i,o=!1;if(t in n&&(i=n[t],o=!0),!o&&this.#a){let e=t.replace(/^[$:@]/,``);e in n&&(i=n[e],o=!0)}if(!o&&!this.#a){let e=t.replace(/^[$:@]/,``);if(e in n)throw new r(`Unknown named parameter '${e}'`,0,`Unknown named parameter '${e}'`)}o&&(validateBindValue(i,this.#n.indexOf(e)+1),a.set(e.gdaId,i))}if(!this.#o){let e=new Set;for(let t of this.#n)t.position>=0||(e.add(t.originalName),e.add(t.originalName.replace(/^[$:@]/,``)));for(let t of Object.keys(n))if(!e.has(t)&&!e.has(t.replace(/^[$:@]/,``)))throw new r(`Unknown named parameter '${t}'`,0,`Unknown named parameter '${t}'`)}for(let e=0;e<i.length;e++){if(e>this.#c())throw new r(`column index out of range`,25,`column index out of range`);validateBindValue(i[e],e+1),a.set(`p${e}`,i[e])}}else{let e=this.#c()+1;if(i.length>e&&e>0)throw new r(`column index out of range`,25,`column index out of range`);for(let t=0;t<Math.min(i.length,e);t++)validateBindValue(i[t],t+1),a.set(`p${t}`,i[t])}let[s]=o(this.#t,e=>{let n=a.get(e.gdaId);return typeof n==`string`?(t.set(e.gdaId,n),`##${e.gdaId}::string`):sqlLiteral(n)});return{sql:s,strings:t}}#u(e){let{sql:t,strings:n}=this.#l(e),[r,i]=s(this.#e,t);if(c(i,n),r.get_statement_type()===l.SqlStatementType.SELECT)return{model:this.#e.statement_execute_select(r,i),isSelect:!0};try{return this.#e.statement_execute_non_select(r,i),{model:null,isSelect:!1}}catch{return{model:this.#e.statement_execute_select(r,i),isSelect:!0}}}run(...e){this.#u(e);let t=0,n=0;try{let e=this.#e.execute_select_command(`SELECT changes()`);e&&e.get_n_rows()>0&&(t=e.get_value_at(0,0))}catch{}try{let e=this.#e.execute_select_command(`SELECT last_insert_rowid()`);e&&e.get_n_rows()>0&&(n=e.get_value_at(0,0))}catch{}return this.#r&&(t=BigInt(t),n=BigInt(n)),{changes:t,lastInsertRowid:n}}get(...e){try{let{model:t}=this.#u(e);return!t||t.get_n_rows()===0?void 0:a(t,this.#s())}catch{return}}all(...e){try{let{model:t}=this.#u(e);return t?i(t,this.#s()):[]}catch{return[]}}setReadBigInts(e){if(typeof e!=`boolean`)throw new t(`The "readBigInts" argument must be a boolean.`);this.#r=e}setReturnArrays(e){if(typeof e!=`boolean`)throw new t(`The "returnArrays" argument must be a boolean.`);this.#i=e}setAllowBareNamedParameters(e){if(typeof e!=`boolean`)throw new t(`The "allowBareNamedParameters" argument must be a boolean.`);this.#a=e}setAllowUnknownNamedParameters(e){if(typeof e!=`boolean`)throw new t(`The "allowUnknownNamedParameters" argument must be a boolean.`);this.#o=e}};export{d as StatementSync};

package/lib/types/database-sync.d.ts

@@ -1,10 +1,5 @@
 import { StatementSync } from './statement-sync.ts';
 declare const sqliteTypeSymbol: unique symbol;
-interface ParamInfo {
-    gdaId: string;
-    originalName: string;
-    position: number;
-}
 export declare class DatabaseSync {
     #private;
     constructor(path: unknown, options?: unknown);
@@ -22,4 +17,4 @@ export declare class DatabaseSync {
     location(dbName?: unknown): string | null;
     [Symbol.dispose](): void;
 }
-export type { ParamInfo };
+export {};

package/lib/types/param-binding.d.ts

@@ -1,6 +1,13 @@
 import type Gda from '@girs/gda-6.0';
-export interface BindingContext {
-    allowBareNamedParameters: boolean;
-    allowUnknownNamedParameters: boolean;
-}
-export declare function bindParameters(paramSet: Gda.Set | null, anonymousArgs: unknown[], namedArgs: Record<string, unknown> | null, ctx: BindingContext): void;
+/**
+ * Bind the string parameters of one execution to the holders libgda created for them.
+ *
+ * Only strings are bound. Every other type is rendered as a SQL literal by
+ * `sqlLiteral()`, because those alphabets cannot break out of the statement — whereas a
+ * string can, and did: libgda reads `\` as an escape inside `'…'` where SQLite does not.
+ *
+ * A missing holder is a bug in this package (the SQL and the holder set come from the
+ * same `convertParameterSyntax` pass), so it raises rather than binding nothing and
+ * silently writing NULL.
+ */
+export declare function bindStringHolders(paramSet: Gda.Set | null, strings: Map<string, string>): void;

package/lib/types/param-binding.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/lib/types/parameter-syntax.d.ts

@@ -0,0 +1,22 @@
+/** One placeholder found in the SQL. `position` is -1 for named parameters. */
+export interface ParamInfo {
+    gdaId: string;
+    originalName: string;
+    position: number;
+}
+/**
+ * Decides what a placeholder becomes in the SQL handed to libgda.
+ *
+ * `StatementSync` substitutes this per execution, because the choice depends on the value:
+ * a string becomes a `##id::string` holder so its text never enters the SQL, everything
+ * else becomes a literal drawn from an alphabet that cannot end a quoted region. Callers
+ * that only need to VALIDATE the SQL, where no values exist yet, take the default.
+ */
+export type PlaceholderRenderer = (param: ParamInfo) => string;
+export declare const asStringHolder: PlaceholderRenderer;
+/**
+ * Rewrite `sql` with every parameter rendered by `render`, and report the parameters in
+ * source order. String literals are copied verbatim so a `?` or `:name` inside one is not
+ * mistaken for a placeholder.
+ */
+export declare function convertParameterSyntax(sql: string, render?: PlaceholderRenderer): [string, ParamInfo[]];

package/lib/types/parse-sql.d.ts

@@ -0,0 +1,26 @@
+import type Gda from '@girs/gda-6.0';
+/**
+ * Parse a single SQL statement and return it with its parameter set.
+ *
+ * **Never call `Gda.SqlParser.parse_string()` in this package.** Its `remain`
+ * out-parameter points INTO the SQL string that was passed in — it is the unparsed tail,
+ * not an allocation — but `Gda-6.0.gir` declares it `transfer-ownership="full"`:
+ *
+ * ```xml
+ * <parameter name="remain" direction="out" transfer-ownership="full" nullable="1">
+ *   <type name="utf8" c:type="const gchar**"/>
+ * ```
+ *
+ * So whenever libgda stops before the end of the string, GJS calls `g_free()` on an
+ * interior pointer at call teardown and glibc aborts the process: `free(): invalid
+ * pointer`, SIGABRT, no JS exception, no return value. Nothing can catch it and nothing
+ * can be checked first — asking for the parse IS the crash. A block comment does it; so
+ * does a statement whose string literal libgda thinks ends elsewhere than SQLite does
+ * (libgda honours `\` as an escape inside `'…'`, SQLite does not — which is how a mail
+ * body ending in a backslash killed a consumer mid-import).
+ *
+ * `gda_connection_parse_sql_string()` takes no `remain` at all, so the same input raises
+ * an ordinary catchable error. It also hands back the `Gda.Set` of parameter holders,
+ * which is what lets values be BOUND instead of spliced into the SQL text.
+ */
+export declare function parseSql(connection: Gda.Connection, sql: string): [Gda.Statement, Gda.Set | null];

package/lib/types/statement-sync.d.ts

@@ -1,11 +1,11 @@
 import Gda from '@girs/gda-6.0';
+import { type ParamInfo } from './parameter-syntax.ts';
 import type { RunResult, StatementSyncOptions } from './types.ts';
-import type { ParamInfo } from './database-sync.ts';
 export declare class StatementSync {
     #private;
-    constructor(sentinel: symbol, connection: Gda.Connection, sql: string, options: StatementSyncOptions, paramMap: ParamInfo[], parser: Gda.SqlParser);
+    constructor(sentinel: symbol, connection: Gda.Connection, sql: string, options: StatementSyncOptions, paramMap: ParamInfo[]);
     /** @internal */
-    static _create(connection: Gda.Connection, sql: string, options: StatementSyncOptions, paramMap: ParamInfo[], parser: Gda.SqlParser): StatementSync;
+    static _create(connection: Gda.Connection, sql: string, options: StatementSyncOptions, paramMap: ParamInfo[]): StatementSync;
     get sourceSQL(): string;
     get expandedSQL(): string;
     run(...args: unknown[]): RunResult;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/sqlite",
-    "version": "0.31.0",
+    "version": "0.32.0",
     "description": "Node.js sqlite module for Gjs using libgda",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -40,9 +40,9 @@
         "libgda"
     ],
     "devDependencies": {
-        "@gjsify/cli": "^0.31.0",
+        "@gjsify/cli": "^0.32.0",
         "@gjsify/node-gi": "file:../../../packages/node-gi/node-gi",
-        "@gjsify/unit": "^0.31.0",
+        "@gjsify/unit": "^0.32.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },