@tinqerjs/better-sqlite3-adapter 0.0.21

package/dist/generators/take.js

@@ -0,0 +1,18 @@
+/**
+ * TAKE (LIMIT) clause generator
+ */
+import { generateValueExpression } from "../expression-generator.js";
+/**
+ * Generate LIMIT clause
+ */
+export function generateTake(operation, context) {
+    if (typeof operation.count === "number") {
+        return `LIMIT ${operation.count}`;
+    }
+    else {
+        // Handle as expression (ParamRef, ArithmeticExpression, etc.)
+        const expr = generateValueExpression(operation.count, context);
+        return `LIMIT ${expr}`;
+    }
+}
+//# sourceMappingURL=take.js.map

package/dist/generators/take.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"take.js","sourceRoot":"","sources":["../../src/generators/take.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAErE;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,SAAwB,EAAE,OAAmB;IACxE,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,SAAS,SAAS,CAAC,KAAK,EAAE,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,8DAA8D;QAC9D,MAAM,IAAI,GAAG,uBAAuB,CAAC,SAAS,CAAC,KAAwB,EAAE,OAAO,CAAC,CAAC;QAClF,OAAO,SAAS,IAAI,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/generators/thenby.d.ts

@@ -0,0 +1,11 @@
+/**
+ * THEN BY clause generator
+ */
+import type { ThenByOperation } from "@tinqerjs/tinqer";
+import type { SqlContext } from "../types.js";
+/**
+ * Generate additional ORDER BY clause
+ * Note: THEN BY in SQL is just additional ORDER BY columns
+ */
+export declare function generateThenBy(operation: ThenByOperation, context: SqlContext): string;
+//# sourceMappingURL=thenby.d.ts.map

package/dist/generators/thenby.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thenby.d.ts","sourceRoot":"","sources":["../../src/generators/thenby.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,eAAe,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CA4CtF"}

package/dist/generators/thenby.js

@@ -0,0 +1,58 @@
+/**
+ * THEN BY clause generator
+ */
+import { generateValueExpression } from "../expression-generator.js";
+/**
+ * Generate additional ORDER BY clause
+ * Note: THEN BY in SQL is just additional ORDER BY columns
+ */
+export function generateThenBy(operation, context) {
+    let orderByExpr;
+    if (typeof operation.keySelector === "string") {
+        // Simple column name - check if it maps to a source column
+        // Check if it's a path like "u.age"
+        if (operation.keySelector.includes(".") && context.symbolTable) {
+            const parts = operation.keySelector.split(".");
+            if (parts.length === 2) {
+                const tableRef = context.symbolTable.entries.get(parts[0]);
+                if (tableRef && tableRef.columnName === "*") {
+                    orderByExpr = `"${tableRef.tableAlias}"."${parts[1]}"`;
+                }
+                else {
+                    // Try full path
+                    const pathRef = context.symbolTable.entries.get(operation.keySelector);
+                    if (pathRef) {
+                        orderByExpr = `"${pathRef.tableAlias}"."${pathRef.columnName}"`;
+                    }
+                    else {
+                        orderByExpr = `"${operation.keySelector}"`;
+                    }
+                }
+            }
+            else {
+                orderByExpr = `"${operation.keySelector}"`;
+            }
+        }
+        else if (context.symbolTable) {
+            const sourceRef = context.symbolTable.entries.get(operation.keySelector);
+            if (sourceRef) {
+                orderByExpr = `"${sourceRef.tableAlias}"."${sourceRef.columnName}"`;
+            }
+            else {
+                orderByExpr = `"${operation.keySelector}"`;
+            }
+        }
+        else {
+            orderByExpr = `"${operation.keySelector}"`;
+        }
+    }
+    else {
+        // Complex expression
+        orderByExpr = generateValueExpression(operation.keySelector, context);
+    }
+    const direction = operation.descending ? "DESC" : "ASC";
+    // Note: This returns just the additional column, not the full ORDER BY clause
+    // The orchestrator will combine all ORDER BY columns
+    return `, ${orderByExpr} ${direction}`;
+}
+//# sourceMappingURL=thenby.js.map

package/dist/generators/thenby.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thenby.js","sourceRoot":"","sources":["../../src/generators/thenby.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAErE;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAA0B,EAAE,OAAmB;IAC5E,IAAI,WAAmB,CAAC;IAExB,IAAI,OAAO,SAAS,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC9C,2DAA2D;QAE3D,oCAAoC;QACpC,IAAI,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;gBAC5D,IAAI,QAAQ,IAAI,QAAQ,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;oBAC5C,WAAW,GAAG,IAAI,QAAQ,CAAC,UAAU,MAAM,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;gBACzD,CAAC;qBAAM,CAAC;oBACN,gBAAgB;oBAChB,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;oBACvE,IAAI,OAAO,EAAE,CAAC;wBACZ,WAAW,GAAG,IAAI,OAAO,CAAC,UAAU,MAAM,OAAO,CAAC,UAAU,GAAG,CAAC;oBAClE,CAAC;yBAAM,CAAC;wBACN,WAAW,GAAG,IAAI,SAAS,CAAC,WAAW,GAAG,CAAC;oBAC7C,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,WAAW,GAAG,IAAI,SAAS,CAAC,WAAW,GAAG,CAAC;YAC7C,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACzE,IAAI,SAAS,EAAE,CAAC;gBACd,WAAW,GAAG,IAAI,SAAS,CAAC,UAAU,MAAM,SAAS,CAAC,UAAU,GAAG,CAAC;YACtE,CAAC;iBAAM,CAAC;gBACN,WAAW,GAAG,IAAI,SAAS,CAAC,WAAW,GAAG,CAAC;YAC7C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,IAAI,SAAS,CAAC,WAAW,GAAG,CAAC;QAC7C,CAAC;IACH,CAAC;SAAM,CAAC;QACN,qBAAqB;QACrB,WAAW,GAAG,uBAAuB,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IACxD,8EAA8E;IAC9E,qDAAqD;IACrD,OAAO,KAAK,WAAW,IAAI,SAAS,EAAE,CAAC;AACzC,CAAC"}

package/dist/generators/update.d.ts

@@ -0,0 +1,11 @@
+/**
+ * UPDATE SQL generation for SQLite (better-sqlite3)
+ */
+import type { UpdateOperation } from "@tinqerjs/tinqer";
+import type { SqlContext } from "../types.js";
+/**
+ * Generate UPDATE SQL statement
+ * SQLite supports RETURNING clause since version 3.35.0 (March 2021)
+ */
+export declare function generateUpdate(operation: UpdateOperation, context: SqlContext): string;
+//# sourceMappingURL=update.d.ts.map

package/dist/generators/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/generators/update.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAyB9C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,eAAe,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAiDtF"}

package/dist/generators/update.js

@@ -0,0 +1,69 @@
+/**
+ * UPDATE SQL generation for SQLite (better-sqlite3)
+ */
+import { generateExpression, generateBooleanExpression } from "../expression-generator.js";
+function shouldSkipAssignment(valueExpr, context) {
+    if (valueExpr.type === "param") {
+        const paramExpr = valueExpr;
+        const paramName = paramExpr.property || paramExpr.param;
+        const params = context.params;
+        if (!params) {
+            return false;
+        }
+        if (Object.prototype.hasOwnProperty.call(params, paramName)) {
+            return params[paramName] === undefined;
+        }
+        return true;
+    }
+    if (valueExpr.type === "constant") {
+        const constant = valueExpr;
+        return constant.value === undefined;
+    }
+    return false;
+}
+/**
+ * Generate UPDATE SQL statement
+ * SQLite supports RETURNING clause since version 3.35.0 (March 2021)
+ */
+export function generateUpdate(operation, context) {
+    const tableName = operation.schema
+        ? `"${operation.schema}"."${operation.table}"`
+        : `"${operation.table}"`;
+    // Extract SET assignments from the assignments object expression
+    const assignments = [];
+    if (operation.assignments.type === "object") {
+        for (const [column, valueExpr] of Object.entries(operation.assignments.properties)) {
+            if (shouldSkipAssignment(valueExpr, context)) {
+                continue;
+            }
+            const value = generateExpression(valueExpr, context);
+            assignments.push(`"${column}" = ${value}`);
+        }
+    }
+    if (assignments.length === 0) {
+        throw new Error("UPDATE must specify at least one column assignment. All provided values were undefined.");
+    }
+    let sql = `UPDATE ${tableName} SET ${assignments.join(", ")}`;
+    // Add WHERE clause if specified
+    if (operation.predicate) {
+        const whereClause = generateBooleanExpression(operation.predicate, context);
+        sql += ` WHERE ${whereClause}`;
+    }
+    else if (!operation.allowFullTableUpdate) {
+        throw new Error("UPDATE requires a WHERE clause or explicit allowFullTableUpdate(). " +
+            "Full table updates are dangerous and must be explicitly allowed.");
+    }
+    // SQLite supports RETURNING clause since version 3.35.0
+    if (operation.returning !== undefined) {
+        // Handle AllColumnsExpression (identity function like .returning(u => u))
+        if (operation.returning.type === "allColumns") {
+            sql += ` RETURNING *`;
+        }
+        else {
+            const returningExpr = generateExpression(operation.returning, context);
+            sql += ` RETURNING ${returningExpr}`;
+        }
+    }
+    return sql;
+}
+//# sourceMappingURL=update.js.map

package/dist/generators/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/generators/update.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAE3F,SAAS,oBAAoB,CAAC,SAAqB,EAAE,OAAmB;IACtE,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,SAAgC,CAAC;QACnD,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC;QACxD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC;YAC5D,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,SAAS,CAAC;QACzC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,SAA+B,CAAC;QACjD,OAAO,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAA0B,EAAE,OAAmB;IAC5E,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM;QAChC,CAAC,CAAC,IAAI,SAAS,CAAC,MAAM,MAAM,SAAS,CAAC,KAAK,GAAG;QAC9C,CAAC,CAAC,IAAI,SAAS,CAAC,KAAK,GAAG,CAAC;IAE3B,iEAAiE;IACjE,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,IAAI,SAAS,CAAC,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5C,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;YACnF,IAAI,oBAAoB,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC7C,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACrD,WAAW,CAAC,IAAI,CAAC,IAAI,MAAM,OAAO,KAAK,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,GAAG,UAAU,SAAS,QAAQ,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAE9D,gCAAgC;IAChC,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,yBAAyB,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5E,GAAG,IAAI,UAAU,WAAW,EAAE,CAAC;IACjC,CAAC;SAAM,IAAI,CAAC,SAAS,CAAC,oBAAoB,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,qEAAqE;YACnE,kEAAkE,CACrE,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACtC,0EAA0E;QAC1E,IAAI,SAAS,CAAC,SAAS,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC9C,GAAG,IAAI,cAAc,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,aAAa,GAAG,kBAAkB,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACvE,GAAG,IAAI,cAAc,aAAa,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/generators/where.d.ts

@@ -0,0 +1,10 @@
+/**
+ * WHERE clause generator
+ */
+import type { WhereOperation } from "@tinqerjs/tinqer";
+import type { SqlContext } from "../types.js";
+/**
+ * Generate WHERE clause
+ */
+export declare function generateWhere(operation: WhereOperation, context: SqlContext): string;
+//# sourceMappingURL=where.d.ts.map

package/dist/generators/where.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"where.d.ts","sourceRoot":"","sources":["../../src/generators/where.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAGpF"}

package/dist/generators/where.js

@@ -0,0 +1,12 @@
+/**
+ * WHERE clause generator
+ */
+import { generateBooleanExpression } from "../expression-generator.js";
+/**
+ * Generate WHERE clause
+ */
+export function generateWhere(operation, context) {
+    const predicate = generateBooleanExpression(operation.predicate, context);
+    return `WHERE ${predicate}`;
+}
+//# sourceMappingURL=where.js.map

package/dist/generators/where.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"where.js","sourceRoot":"","sources":["../../src/generators/where.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAEvE;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAyB,EAAE,OAAmB;IAC1E,MAAM,SAAS,GAAG,yBAAyB,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1E,OAAO,SAAS,SAAS,EAAE,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Better SQLite3 SQL generator for Tinqer
+ */
+import { type Queryable, type OrderedQueryable, type TerminalQuery, type QueryHelpers, type QueryBuilder, type DatabaseSchema, type Insertable, type InsertableWithReturning, type UpdatableWithSet, type UpdatableComplete, type UpdatableWithReturning, type Deletable, type DeletableComplete, type ParseQueryOptions, type QueryOperation, SelectPlanHandle, SelectTerminalHandle, InsertPlanHandleInitial, InsertPlanHandleWithValues, InsertPlanHandleWithReturning, UpdatePlanHandleWithSet, UpdatePlanHandleComplete, UpdatePlanHandleWithReturning, DeletePlanHandleInitial, DeletePlanHandleComplete } from "@tinqerjs/tinqer";
+import type { ExecuteOptions } from "./types.js";
+/**
+ * Convert a SELECT plan to SQL string with parameters
+ */
+export declare function toSql<TRecord, TParams>(plan: SelectPlanHandle<TRecord, TParams>, params: TParams): {
+    sql: string;
+    params: Record<string, unknown>;
+};
+/**
+ * Convert a SELECT terminal plan to SQL string with parameters
+ */
+export declare function toSql<TResult, TParams>(plan: SelectTerminalHandle<TResult, TParams>, params: TParams): {
+    sql: string;
+    params: Record<string, unknown>;
+};
+/**
+ * Convert an INSERT plan (initial) to SQL string with parameters
+ */
+export declare function toSql<TRecord, TParams>(plan: InsertPlanHandleInitial<TRecord, TParams>, params: TParams): {
+    sql: string;
+    params: Record<string, unknown>;
+};
+/**
+ * Convert an INSERT plan to SQL string with parameters
+ */
+export declare function toSql<TRecord, TParams>(plan: InsertPlanHandleWithValues<TRecord, TParams>, params: TParams): {
+    sql: string;
+    params: Record<string, unknown>;
+};
+/**
+ * Convert an INSERT plan with RETURNING to SQL string with parameters
+ */
+export declare function toSql<TResult, TParams>(plan: InsertPlanHandleWithReturning<TResult, TParams>, params: TParams): {
+    sql: string;
+    params: Record<string, unknown>;
+};
+/**
+ * Convert an UPDATE plan (with set) to SQL string with parameters
+ */
+export declare function toSql<TRecord, TParams>(plan: UpdatePlanHandleWithSet<TRecord, TParams>, params: TParams): {
+    sql: string;
+    params: Record<string, unknown>;
+};
+/**
+ * Convert an UPDATE plan to SQL string with parameters
+ */
+export declare function toSql<TRecord, TParams>(plan: UpdatePlanHandleComplete<TRecord, TParams>, params: TParams): {
+    sql: string;
+    params: Record<string, unknown>;
+};
+/**
+ * Convert an UPDATE plan with RETURNING to SQL string with parameters
+ */
+export declare function toSql<TResult, TParams>(plan: UpdatePlanHandleWithReturning<TResult, TParams>, params: TParams): {
+    sql: string;
+    params: Record<string, unknown>;
+};
+/**
+ * Convert a DELETE plan (initial) to SQL string with parameters
+ */
+export declare function toSql<TParams>(plan: DeletePlanHandleInitial<unknown, TParams>, params: TParams): {
+    sql: string;
+    params: Record<string, unknown>;
+};
+/**
+ * Convert a DELETE plan to SQL string with parameters
+ */
+export declare function toSql<TParams>(plan: DeletePlanHandleComplete<unknown, TParams>, params: TParams): {
+    sql: string;
+    params: Record<string, unknown>;
+};
+/**
+ * Convert a SELECT plan (either regular or terminal) to SQL string with parameters
+ */
+export declare function toSql<TParams>(plan: SelectPlanHandle<unknown, TParams> | SelectTerminalHandle<unknown, TParams>, params: TParams): {
+    sql: string;
+    params: Record<string, unknown>;
+};
+/**
+ * Simpler API for generating SQL with auto-parameterization
+ * @param queryable A Queryable or TerminalQuery object
+ * @param options Parse options including cache control
+ * @returns Object with text (SQL string), parameters, and preserved result type
+ */
+export declare function finalize<TParams = Record<string, never>>(plan: {
+    finalize(params: TParams): {
+        operation: QueryOperation;
+        params: Record<string, unknown>;
+    };
+}, params?: TParams): {
+    text: string;
+    parameters: Record<string, unknown>;
+};
+/**
+ * Database interface for Better SQLite3 compatibility
+ */
+interface BetterSqlite3Database {
+    prepare(sql: string): {
+        all(params?: Record<string, unknown>): unknown[];
+        get(params?: Record<string, unknown>): unknown;
+        run(params?: Record<string, unknown>): {
+            changes: number;
+        };
+    };
+}
+/**
+ * Execute a query with params and helpers
+ */
+export declare function executeSelect<TSchema, TParams, TQuery extends Queryable<unknown> | OrderedQueryable<unknown> | TerminalQuery<unknown>>(db: BetterSqlite3Database, schema: DatabaseSchema<TSchema>, builder: (queryBuilder: QueryBuilder<TSchema>, params: TParams, helpers: QueryHelpers) => TQuery, params: TParams, options?: ExecuteOptions & ParseQueryOptions): TQuery extends Queryable<infer T> ? T[] : TQuery extends OrderedQueryable<infer T> ? T[] : TQuery extends TerminalQuery<infer T> ? T : never;
+/**
+ * Execute a query with params only (no helpers)
+ */
+export declare function executeSelect<TSchema, TParams, TQuery extends Queryable<unknown> | OrderedQueryable<unknown> | TerminalQuery<unknown>>(db: BetterSqlite3Database, schema: DatabaseSchema<TSchema>, builder: (queryBuilder: QueryBuilder<TSchema>, params: TParams) => TQuery, params: TParams, options?: ExecuteOptions & ParseQueryOptions): TQuery extends Queryable<infer T> ? T[] : TQuery extends OrderedQueryable<infer T> ? T[] : TQuery extends TerminalQuery<infer T> ? T : never;
+/**
+ * Execute a query with query builder only (no params, no helpers)
+ */
+export declare function executeSelect<TSchema, TQuery extends Queryable<unknown> | OrderedQueryable<unknown> | TerminalQuery<unknown>>(db: BetterSqlite3Database, schema: DatabaseSchema<TSchema>, builder: (queryBuilder: QueryBuilder<TSchema>) => TQuery): TQuery extends Queryable<infer T> ? T[] : TQuery extends OrderedQueryable<infer T> ? T[] : TQuery extends TerminalQuery<infer T> ? T : never;
+/**
+ * Execute a query with no parameters
+ * @param dbClient Better SQLite3 database instance
+ * @param schema Database context with schema information
+ * @param builder Function that builds the query using LINQ operations with DSL and helpers
+ * @param options Optional execution options (e.g., SQL inspection callback)
+ * @returns Query results, properly typed based on the query
+ */
+export declare function executeSelectSimple<TSchema, TQuery extends Queryable<unknown> | OrderedQueryable<unknown> | TerminalQuery<unknown>>(dbClient: BetterSqlite3Database, schema: DatabaseSchema<TSchema>, builder: (queryBuilder: QueryBuilder<TSchema>, _params: Record<string, never>, helpers: QueryHelpers) => TQuery, options?: ExecuteOptions & ParseQueryOptions): TQuery extends Queryable<infer T> ? T[] : TQuery extends OrderedQueryable<infer T> ? T[] : TQuery extends TerminalQuery<infer T> ? T : never;
+/**
+ * Execute INSERT with params, return row count
+ */
+export declare function executeInsert<TSchema, TParams, TTable>(db: BetterSqlite3Database, schema: DatabaseSchema<TSchema>, builder: (queryBuilder: QueryBuilder<TSchema>, params: TParams) => Insertable<TTable>, params: TParams, options?: ExecuteOptions & ParseQueryOptions): number;
+/**
+ * Execute INSERT with params and RETURNING (not supported by SQLite)
+ */
+export declare function executeInsert<TSchema, TParams, TTable, TReturning>(db: BetterSqlite3Database, schema: DatabaseSchema<TSchema>, builder: (queryBuilder: QueryBuilder<TSchema>, params: TParams) => InsertableWithReturning<TTable, TReturning>, params: TParams, options?: ExecuteOptions & ParseQueryOptions): never;
+/**
+ * Execute INSERT without params, return row count
+ */
+export declare function executeInsert<TSchema, TTable>(db: BetterSqlite3Database, schema: DatabaseSchema<TSchema>, builder: (queryBuilder: QueryBuilder<TSchema>) => Insertable<TTable>): number;
+/**
+ * Execute INSERT without params, with RETURNING (not supported by SQLite)
+ */
+export declare function executeInsert<TSchema, TTable, TReturning>(db: BetterSqlite3Database, schema: DatabaseSchema<TSchema>, builder: (queryBuilder: QueryBuilder<TSchema>) => InsertableWithReturning<TTable, TReturning>): never;
+/**
+ * Execute UPDATE with params, return row count
+ */
+export declare function executeUpdate<TSchema, TParams, TTable>(db: BetterSqlite3Database, schema: DatabaseSchema<TSchema>, builder: (queryBuilder: QueryBuilder<TSchema>, params: TParams) => UpdatableWithSet<TTable> | UpdatableComplete<TTable>, params: TParams, options?: ExecuteOptions & ParseQueryOptions): number;
+/**
+ * Execute UPDATE with params and RETURNING (not supported by SQLite)
+ */
+export declare function executeUpdate<TSchema, TParams, TTable, TReturning>(db: BetterSqlite3Database, schema: DatabaseSchema<TSchema>, builder: (queryBuilder: QueryBuilder<TSchema>, params: TParams) => UpdatableWithReturning<TTable, TReturning>, params: TParams, options?: ExecuteOptions & ParseQueryOptions): never;
+/**
+ * Execute UPDATE without params, return row count
+ */
+export declare function executeUpdate<TSchema, TTable>(db: BetterSqlite3Database, schema: DatabaseSchema<TSchema>, builder: (queryBuilder: QueryBuilder<TSchema>) => UpdatableWithSet<TTable> | UpdatableComplete<TTable>): number;
+/**
+ * Execute UPDATE without params, with RETURNING (not supported by SQLite)
+ */
+export declare function executeUpdate<TSchema, TTable, TReturning>(db: BetterSqlite3Database, schema: DatabaseSchema<TSchema>, builder: (queryBuilder: QueryBuilder<TSchema>) => UpdatableWithReturning<TTable, TReturning>): never;
+/**
+ * Execute DELETE with params, return row count
+ */
+export declare function executeDelete<TSchema, TParams, TResult>(db: BetterSqlite3Database, schema: DatabaseSchema<TSchema>, builder: (queryBuilder: QueryBuilder<TSchema>, params: TParams) => Deletable<TResult> | DeletableComplete<TResult>, params: TParams, options?: ExecuteOptions & ParseQueryOptions): number;
+/**
+ * Execute DELETE without params, return row count
+ */
+export declare function executeDelete<TSchema, TResult>(db: BetterSqlite3Database, schema: DatabaseSchema<TSchema>, builder: (queryBuilder: QueryBuilder<TSchema>) => Deletable<TResult> | DeletableComplete<TResult>): number;
+export type { SqlResult, ExecuteOptions } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,234 @@
+/**
+ * Better SQLite3 SQL generator for Tinqer
+ */
+import { defineSelect, defineInsert, defineUpdate, defineDelete, isTerminalHandle, } from "@tinqerjs/tinqer";
+import { generateSql } from "./sql-generator.js";
+/**
+ * Helper function to expand array parameters into indexed parameters
+ * e.g., { ids: [1, 2, 3] } becomes { ids: [1, 2, 3], "ids_0": 1, "ids_1": 2, "ids_2": 3 }
+ */
+function expandArrayParams(params) {
+    const expanded = { ...params };
+    for (const [key, value] of Object.entries(params)) {
+        if (Array.isArray(value)) {
+            value.forEach((item, index) => {
+                expanded[`${key}_${index}`] = item;
+            });
+        }
+    }
+    return expanded;
+}
+function materializePlan(plan, params) {
+    const { operation, params: mergedParams } = plan.finalize(params);
+    const sql = generateSql(operation, mergedParams);
+    const expandedParams = expandArrayParams(mergedParams);
+    return { operation, mergedParams, sql, expandedParams };
+}
+function normalizeSqliteParams(params) {
+    const converted = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (typeof value === "boolean") {
+            converted[key] = value ? 1 : 0;
+        }
+        else if (value instanceof Date) {
+            const year = value.getFullYear();
+            const month = String(value.getMonth() + 1).padStart(2, "0");
+            const day = String(value.getDate()).padStart(2, "0");
+            const hours = String(value.getHours()).padStart(2, "0");
+            const minutes = String(value.getMinutes()).padStart(2, "0");
+            const seconds = String(value.getSeconds()).padStart(2, "0");
+            converted[key] = `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`;
+        }
+        else {
+            converted[key] = value;
+        }
+    }
+    return converted;
+}
+/**
+ * Convert any plan to SQL string with parameters
+ * Handles SQLite specific parameter normalization (booleans, dates)
+ */
+export function toSql(plan, params) {
+    const { operation, params: mergedParams } = plan.finalize(params);
+    const sql = generateSql(operation, mergedParams);
+    const expandedParams = expandArrayParams(mergedParams);
+    return { sql, params: expandedParams };
+}
+/**
+ * Simpler API for generating SQL with auto-parameterization
+ * @param queryable A Queryable or TerminalQuery object
+ * @param options Parse options including cache control
+ * @returns Object with text (SQL string), parameters, and preserved result type
+ */
+export function finalize(plan, params) {
+    const normalizedParams = params ?? {};
+    const { operation, params: mergedParams } = plan.finalize(normalizedParams);
+    const text = generateSql(operation, mergedParams);
+    return { text, parameters: mergedParams };
+}
+// Implementation
+export function executeSelect(db, schema, builder, params, options) {
+    const plan = defineSelect(schema, builder, options);
+    const normalizedParams = params || {};
+    const { operation, sql, expandedParams } = materializePlan(plan, normalizedParams);
+    const displayParams = expandedParams;
+    if (options?.onSql) {
+        options.onSql({ sql, params: displayParams });
+    }
+    const boundParams = normalizeSqliteParams(expandedParams);
+    const stmt = db.prepare(sql);
+    if (!isTerminalHandle(plan)) {
+        return stmt.all(boundParams);
+    }
+    const operationType = operation.operationType;
+    switch (operationType) {
+        case "first":
+        case "firstOrDefault":
+        case "single":
+        case "singleOrDefault":
+        case "last":
+        case "lastOrDefault": {
+            const rows = stmt.all(boundParams);
+            if (rows.length === 0) {
+                if (operationType.includes("OrDefault")) {
+                    return null;
+                }
+                throw new Error(`No elements found for ${operationType} operation`);
+            }
+            if (operationType.startsWith("single") && rows.length > 1) {
+                throw new Error(`Multiple elements found for ${operationType} operation`);
+            }
+            if (operationType.startsWith("last")) {
+                return rows[rows.length - 1];
+            }
+            return rows[0];
+        }
+        case "count":
+        case "longCount": {
+            const countRow = stmt.get(boundParams);
+            const value = countRow ? Number(extractFirstColumn(countRow)) : 0;
+            return Number.isNaN(value) ? 0 : value;
+        }
+        case "sum":
+        case "average":
+        case "min":
+        case "max": {
+            const aggRow = stmt.get(boundParams);
+            return (aggRow ? (extractFirstColumn(aggRow) ?? null) : null);
+        }
+        case "any":
+        case "all": {
+            const boolRow = stmt.get(boundParams);
+            return toBoolean(boolRow ? extractFirstColumn(boolRow) : undefined);
+        }
+        default:
+            return stmt.all(boundParams);
+    }
+}
+/**
+ * Execute a query with no parameters
+ * @param dbClient Better SQLite3 database instance
+ * @param schema Database context with schema information
+ * @param builder Function that builds the query using LINQ operations with DSL and helpers
+ * @param options Optional execution options (e.g., SQL inspection callback)
+ * @returns Query results, properly typed based on the query
+ */
+export function executeSelectSimple(dbClient, schema, builder, options = {}) {
+    return executeSelect(dbClient, schema, builder, {}, options);
+}
+// Implementation
+export function executeInsert(db, schema, builder, params, options) {
+    const normalizedParams = params || {};
+    let plan;
+    try {
+        plan = defineInsert(schema, builder, options);
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            error.message === "Failed to parse insert builder or not an insert operation") {
+            throw new Error("Failed to parse INSERT query or not an insert operation");
+        }
+        throw error;
+    }
+    const { operation, sql, expandedParams } = materializePlan(plan, normalizedParams);
+    if (options?.onSql) {
+        options.onSql({ sql, params: expandedParams });
+    }
+    const insertOperation = operation;
+    if (insertOperation.returning) {
+        throw new Error("SQLite adapter does not support INSERT ... RETURNING clauses");
+    }
+    const stmt = db.prepare(sql);
+    const result = stmt.run(normalizeSqliteParams(expandedParams));
+    return result.changes;
+}
+// Implementation
+export function executeUpdate(db, schema, builder, params, options) {
+    const normalizedParams = params || {};
+    let plan;
+    try {
+        plan = defineUpdate(schema, builder, options);
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            error.message === "Failed to parse update builder or not an update operation") {
+            throw new Error("Failed to parse UPDATE query or not an update operation");
+        }
+        throw error;
+    }
+    const { operation, sql, expandedParams } = materializePlan(plan, normalizedParams);
+    if (options?.onSql) {
+        options.onSql({ sql, params: expandedParams });
+    }
+    const updateOperation = operation;
+    if (updateOperation.returning) {
+        throw new Error("SQLite adapter does not support UPDATE ... RETURNING clauses");
+    }
+    const stmt = db.prepare(sql);
+    const result = stmt.run(normalizeSqliteParams(expandedParams));
+    return result.changes;
+}
+// Implementation
+export function executeDelete(db, schema, builder, params, options) {
+    const normalizedParams = params || {};
+    const plan = defineDelete(schema, builder, options);
+    const planResult = plan.finalize(normalizedParams);
+    const sql = generateSql(planResult.operation, planResult.params);
+    const expandedParams = expandArrayParams(planResult.params);
+    if (options?.onSql) {
+        options.onSql({ sql, params: expandedParams });
+    }
+    const stmt = db.prepare(sql);
+    const result = stmt.run(normalizeSqliteParams(expandedParams));
+    return result.changes;
+}
+function extractFirstColumn(row) {
+    if (!row) {
+        return undefined;
+    }
+    const keys = Object.keys(row);
+    if (keys.length === 0 || !keys[0]) {
+        return undefined;
+    }
+    return row[keys[0]];
+}
+function toBoolean(value) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        return value !== 0;
+    }
+    if (typeof value === "string") {
+        if (value === "0") {
+            return false;
+        }
+        if (value === "1") {
+            return true;
+        }
+        return value.length > 0;
+    }
+    return Boolean(value);
+}
+//# sourceMappingURL=index.js.map