@absurd-sqlite/sdk 0.2.0-alpha.0

package/README.md

@@ -0,0 +1 @@
+# Absurd Sqlite SDK for TypeScript

package/dist/absurd-types.d.ts

@@ -0,0 +1,109 @@
+import type { ClaimedTask, JsonValue, SpawnOptions, SpawnResult, TaskHandler, TaskRegistrationOptions, WorkerOptions } from "absurd-sdk";
+import type { SQLiteRestBindParams } from "./sqlite-types";
+/**
+ * Minimal query interface compatible with Absurd's database operations.
+ */
+export interface Queryable {
+    /**
+     * Execute a parameterized SQL query and return rows.
+     * @param sql SQL text with parameter placeholders.
+     * @param params Optional positional parameters.
+     */
+    query<R extends object = Record<string, any>>(sql: string, params?: SQLiteRestBindParams): Promise<{
+        rows: R[];
+    }>;
+}
+/**
+ * Background worker handle returned by startWorker().
+ */
+export interface Worker {
+    /**
+     * Stop the worker loop and wait for in-flight tasks to settle.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Absurd client interface.
+ */
+export interface AbsurdClient {
+    /**
+     * Create a new client bound to the provided connection.
+     * @param con Connection to use for queries.
+     * @param owned If true, close the connection when close() is called.
+     */
+    /**
+     * Register a task handler.
+     * @param options Task registration options.
+     * @param handler Async task handler.
+     */
+    registerTask<P = any, R = any>(options: TaskRegistrationOptions, handler: TaskHandler<P, R>): void;
+    /**
+     * Create a queue.
+     * @param queueName Optional queue name (defaults to client queue).
+     */
+    createQueue(queueName?: string): Promise<void>;
+    /**
+     * Drop a queue.
+     * @param queueName Optional queue name (defaults to client queue).
+     */
+    dropQueue(queueName?: string): Promise<void>;
+    /**
+     * List available queues.
+     */
+    listQueues(): Promise<Array<string>>;
+    /**
+     * Spawn a task execution.
+     * @param taskName Task name.
+     * @param params Task parameters.
+     * @param options Spawn options including queue and retry behavior.
+     */
+    spawn<P = any>(taskName: string, params: P, options?: SpawnOptions): Promise<SpawnResult>;
+    /**
+     * Emit an event on a queue.
+     * @param eventName Non-empty event name.
+     * @param payload Optional JSON payload.
+     * @param queueName Optional queue name (defaults to client queue).
+     */
+    emitEvent(eventName: string, payload?: JsonValue, queueName?: string): Promise<void>;
+    /**
+     * Cancel a task by ID.
+     * @param taskID Task identifier.
+     * @param queueName Optional queue name (defaults to client queue).
+     */
+    cancelTask(taskID: string, queueName?: string): Promise<void>;
+    /**
+     * Claim tasks for processing.
+     * @param options Claiming options.
+     */
+    claimTasks(options?: {
+        batchSize?: number;
+        claimTimeout?: number;
+        workerId?: string;
+    }): Promise<ClaimedTask[]>;
+    /**
+     * Claim and process a batch of tasks sequentially.
+     * @param workerId Worker identifier.
+     * @param claimTimeout Lease duration in seconds.
+     * @param batchSize Max tasks to process.
+     */
+    workBatch(workerId?: string, claimTimeout?: number, batchSize?: number): Promise<void>;
+    /**
+     * Start a background worker that polls and executes tasks.
+     * @param options Worker behavior options.
+     */
+    startWorker(options?: WorkerOptions): Promise<Worker>;
+    /**
+     * Close the client and any owned resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Execute a claimed task (used by workers).
+     * @param task Claimed task record.
+     * @param claimTimeout Lease duration in seconds.
+     * @param options Execution options.
+     */
+    executeTask(task: ClaimedTask, claimTimeout: number, options?: {
+        fatalOnLeaseTimeout?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=absurd-types.d.ts.map

package/dist/absurd-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"absurd-types.d.ts","sourceRoot":"","sources":["../src/absurd-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,WAAW,EACX,WAAW,EACX,uBAAuB,EACvB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1C,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IAGH;;;;OAIG;IACH,YAAY,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAC3B,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GACzB,IAAI,CAAC;IAER;;;OAGG;IACH,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAErC;;;;;OAKG;IACH,KAAK,CAAC,CAAC,GAAG,GAAG,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;;;;OAKG;IACH,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,SAAS,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;;OAGG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE3B;;;;;OAKG;IACH,SAAS,CACP,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtD;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;;OAKG;IACH,WAAW,CACT,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;QAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1C,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

package/dist/absurd-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=absurd-types.js.map

package/dist/absurd-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"absurd-types.js","sourceRoot":"","sources":["../src/absurd-types.ts"],"names":[],"mappings":""}

package/dist/cjs/absurd-types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Absurd = void 0;
+const absurd_sdk_1 = require("absurd-sdk");
+const sqlite_1 = require("./sqlite");
+class Absurd extends absurd_sdk_1.Absurd {
+    db;
+    constructor(db, extensionPath) {
+        db.loadExtension(extensionPath);
+        const queryable = new sqlite_1.SqliteConnection(db);
+        super(queryable);
+        this.db = db;
+    }
+    async close() {
+        this.db.close();
+    }
+}
+exports.Absurd = Absurd;

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/sqlite-types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/sqlite.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteConnection = void 0;
+class SqliteConnection {
+    db;
+    constructor(db) {
+        this.db = db;
+        // TODO: verbose logging
+    }
+    async query(sql, params) {
+        const sqliteQuery = rewritePostgresQuery(sql);
+        const sqliteParams = rewritePostgresParams(params);
+        const statement = this.db.prepare(sqliteQuery);
+        if (!statement.readonly) {
+            // this indicates `return_data` is false
+            // https://github.com/WiseLibs/better-sqlite3/blob/6209be238d6a1b181f516e4e636986604b0f62e1/src/objects/statement.cpp#L134C83-L134C95
+            throw new Error("The query() method is only statements that return data");
+        }
+        const rowsDecoded = statement
+            .all(sqliteParams)
+            .map((row) => decodeRowValues(statement, row));
+        return { rows: rowsDecoded };
+    }
+    async exec(sql, params) {
+        const sqliteQuery = rewritePostgresQuery(sql);
+        const sqliteParams = rewritePostgresParams(params);
+        this.db.prepare(sqliteQuery).run(sqliteParams);
+    }
+}
+exports.SqliteConnection = SqliteConnection;
+const namedParamPrefix = "p";
+function rewritePostgresQuery(text) {
+    return text
+        .replace(/\$(\d+)/g, `:${namedParamPrefix}$1`)
+        .replace(/absurd\.(\w+)/g, "absurd_$1");
+}
+function rewritePostgresParams(params) {
+    if (!params) {
+        return {};
+    }
+    const rewrittenParams = {};
+    params.forEach((value, index) => {
+        const paramKey = `${namedParamPrefix}${index + 1}`;
+        const encodedParamValue = encodeColumnValue(value);
+        rewrittenParams[paramKey] = encodedParamValue;
+    });
+    return rewrittenParams;
+}
+function decodeRowValues(statement, row, verbose) {
+    const columns = statement.columns();
+    const decodedRow = {};
+    for (const column of columns) {
+        const columnName = column.name;
+        const columnType = column.type;
+        const rawValue = row[columnName];
+        const decodedValue = decodeColumnValue(rawValue, columnName, columnType, verbose);
+        decodedRow[columnName] = decodedValue;
+    }
+    return decodedRow;
+}
+function decodeColumnValue(value, columnName, columnType, verbose) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (columnType === null) {
+        if (typeof value === "string") {
+            // When column type is not known but the value is string
+            // try parse it as JSON -- for cases where the column is computed
+            // e.g. `SELECT json(x) as y from ....`
+            // FIXME: better type detection
+            let rv;
+            let isValidJSON = false;
+            try {
+                rv = JSON.parse(value);
+                isValidJSON = true;
+            }
+            catch (e) {
+                verbose?.(`Failed to decode string column ${columnName} as JSON`, e);
+                rv = value;
+            }
+            if (isValidJSON) {
+                verbose?.(`Decoded column ${columnName} with null as JSON`);
+            }
+            return rv;
+        }
+        verbose?.(`Column ${columnName} has null type, returning raw value`);
+        return value;
+    }
+    const columnTypeName = columnType.toLowerCase();
+    if (columnTypeName === "blob") {
+        // BLOB values are JSON string decoded from JSONB
+        try {
+            return JSON.parse(value.toString());
+        }
+        catch (e) {
+            verbose?.(`Failed to decode BLOB column ${columnName} as JSON`, e);
+            throw e;
+        }
+    }
+    if (columnTypeName === "datetime") {
+        if (typeof value !== "number") {
+            throw new Error(`Expected datetime column ${columnName} to be a number, got ${typeof value}`);
+        }
+        return new Date(value);
+    }
+    // For other types, return as is
+    return value;
+}
+function encodeColumnValue(value) {
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (typeof value === "number" && Number.isInteger(value)) {
+        return value.toString();
+    }
+    return value;
+}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { Absurd as AbsurdBase } from "absurd-sdk";
+import type { AbsurdClient } from "./absurd-types";
+import type { SQLiteDatabase } from "./sqlite-types";
+export type { AbsurdClient, Queryable, Worker } from "./absurd-types";
+export type { AbsurdHooks, AbsurdOptions, CancellationPolicy, ClaimedTask, JsonObject, JsonValue, RetryStrategy, SpawnOptions, SpawnResult, TaskContext, TaskHandler, TaskRegistrationOptions, WorkerOptions, } from "absurd-sdk";
+export type { SQLiteBindParams, SQLiteBindValue, SQLiteColumnDefinition, SQLiteDatabase, SQLiteRestBindParams, SQLiteStatement, SQLiteVerboseLog, } from "./sqlite-types";
+export declare class Absurd extends AbsurdBase implements AbsurdClient {
+    private db;
+    constructor(db: SQLiteDatabase, extensionPath: string);
+    close(): Promise<void>;
+}
+//# 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":"AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,uBAAuB,EACvB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,qBAAa,MAAO,SAAQ,UAAW,YAAW,YAAY;IAC5D,OAAO,CAAC,EAAE,CAAiB;gBAEf,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;IAO/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/index.js

@@ -0,0 +1,15 @@
+import { Absurd as AbsurdBase } from "absurd-sdk";
+import { SqliteConnection } from "./sqlite";
+export class Absurd extends AbsurdBase {
+    db;
+    constructor(db, extensionPath) {
+        db.loadExtension(extensionPath);
+        const queryable = new SqliteConnection(db);
+        super(queryable);
+        this.db = db;
+    }
+    async close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AAIlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AA4B5C,MAAM,OAAO,MAAO,SAAQ,UAAU;IAC5B,EAAE,CAAiB;IAE3B,YAAY,EAAkB,EAAE,aAAqB;QACnD,EAAE,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;QAChC,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAC3C,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/sqlite-types.d.ts

@@ -0,0 +1,23 @@
+export type SQLiteBindValue = number | string | Buffer | bigint | Date | null;
+export type SQLiteBindParams = SQLiteBindValue[] | Record<string, SQLiteBindValue>;
+export type SQLiteRestBindParams = SQLiteBindValue[] | [SQLiteBindParams];
+export interface SQLiteColumnDefinition {
+    name: string;
+    column: string | null;
+    table: string | null;
+    database: string | null;
+    type: string | null;
+}
+export interface SQLiteStatement<Result extends object = Record<string, any>> {
+    readonly: boolean;
+    columns(): SQLiteColumnDefinition[];
+    all(...args: SQLiteRestBindParams): Result[];
+    run(...args: SQLiteRestBindParams): number;
+}
+export interface SQLiteDatabase {
+    prepare<Result extends object = Record<string, any>>(sql: string): SQLiteStatement<Result>;
+    close(): void;
+    loadExtension(path: string): void;
+}
+export type SQLiteVerboseLog = (message?: any, ...optionalParams: any[]) => void;
+//# sourceMappingURL=sqlite-types.d.ts.map

package/dist/sqlite-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-types.d.ts","sourceRoot":"","sources":["../src/sqlite-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GACxB,eAAe,EAAE,GACjB,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEpC,MAAM,MAAM,oBAAoB,GAAG,eAAe,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAE1E,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,eAAe,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC1E,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,IAAI,sBAAsB,EAAE,CAAC;IACpC,GAAG,CAAC,GAAG,IAAI,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAAC;IAC7C,GAAG,CAAC,GAAG,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjD,GAAG,EAAE,MAAM,GACV,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3B,KAAK,IAAI,IAAI,CAAC;IACd,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,CAAC,EAAE,GAAG,EACb,GAAG,cAAc,EAAE,GAAG,EAAE,KACrB,IAAI,CAAC"}

package/dist/sqlite-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sqlite-types.js.map

package/dist/sqlite-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-types.js","sourceRoot":"","sources":["../src/sqlite-types.ts"],"names":[],"mappings":""}

package/dist/sqlite.d.ts

@@ -0,0 +1,11 @@
+import type { Queryable } from "./absurd-types";
+import type { SQLiteRestBindParams, SQLiteDatabase } from "./sqlite-types";
+export declare class SqliteConnection implements Queryable {
+    private readonly db;
+    constructor(db: SQLiteDatabase);
+    query<R extends object = Record<string, any>>(sql: string, params?: SQLiteRestBindParams): Promise<{
+        rows: R[];
+    }>;
+    exec(sql: string, params?: SQLiteRestBindParams): Promise<void>;
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EAGf,MAAM,gBAAgB,CAAC;AAExB,qBAAa,gBAAiB,YAAW,SAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;gBAExB,EAAE,EAAE,cAAc;IAKxB,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChD,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAA;KAAE,CAAC;IAkBnB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAMtE"}

package/dist/sqlite.js

@@ -0,0 +1,114 @@
+export class SqliteConnection {
+    db;
+    constructor(db) {
+        this.db = db;
+        // TODO: verbose logging
+    }
+    async query(sql, params) {
+        const sqliteQuery = rewritePostgresQuery(sql);
+        const sqliteParams = rewritePostgresParams(params);
+        const statement = this.db.prepare(sqliteQuery);
+        if (!statement.readonly) {
+            // this indicates `return_data` is false
+            // https://github.com/WiseLibs/better-sqlite3/blob/6209be238d6a1b181f516e4e636986604b0f62e1/src/objects/statement.cpp#L134C83-L134C95
+            throw new Error("The query() method is only statements that return data");
+        }
+        const rowsDecoded = statement
+            .all(sqliteParams)
+            .map((row) => decodeRowValues(statement, row));
+        return { rows: rowsDecoded };
+    }
+    async exec(sql, params) {
+        const sqliteQuery = rewritePostgresQuery(sql);
+        const sqliteParams = rewritePostgresParams(params);
+        this.db.prepare(sqliteQuery).run(sqliteParams);
+    }
+}
+const namedParamPrefix = "p";
+function rewritePostgresQuery(text) {
+    return text
+        .replace(/\$(\d+)/g, `:${namedParamPrefix}$1`)
+        .replace(/absurd\.(\w+)/g, "absurd_$1");
+}
+function rewritePostgresParams(params) {
+    if (!params) {
+        return {};
+    }
+    const rewrittenParams = {};
+    params.forEach((value, index) => {
+        const paramKey = `${namedParamPrefix}${index + 1}`;
+        const encodedParamValue = encodeColumnValue(value);
+        rewrittenParams[paramKey] = encodedParamValue;
+    });
+    return rewrittenParams;
+}
+function decodeRowValues(statement, row, verbose) {
+    const columns = statement.columns();
+    const decodedRow = {};
+    for (const column of columns) {
+        const columnName = column.name;
+        const columnType = column.type;
+        const rawValue = row[columnName];
+        const decodedValue = decodeColumnValue(rawValue, columnName, columnType, verbose);
+        decodedRow[columnName] = decodedValue;
+    }
+    return decodedRow;
+}
+function decodeColumnValue(value, columnName, columnType, verbose) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (columnType === null) {
+        if (typeof value === "string") {
+            // When column type is not known but the value is string
+            // try parse it as JSON -- for cases where the column is computed
+            // e.g. `SELECT json(x) as y from ....`
+            // FIXME: better type detection
+            let rv;
+            let isValidJSON = false;
+            try {
+                rv = JSON.parse(value);
+                isValidJSON = true;
+            }
+            catch (e) {
+                verbose?.(`Failed to decode string column ${columnName} as JSON`, e);
+                rv = value;
+            }
+            if (isValidJSON) {
+                verbose?.(`Decoded column ${columnName} with null as JSON`);
+            }
+            return rv;
+        }
+        verbose?.(`Column ${columnName} has null type, returning raw value`);
+        return value;
+    }
+    const columnTypeName = columnType.toLowerCase();
+    if (columnTypeName === "blob") {
+        // BLOB values are JSON string decoded from JSONB
+        try {
+            return JSON.parse(value.toString());
+        }
+        catch (e) {
+            verbose?.(`Failed to decode BLOB column ${columnName} as JSON`, e);
+            throw e;
+        }
+    }
+    if (columnTypeName === "datetime") {
+        if (typeof value !== "number") {
+            throw new Error(`Expected datetime column ${columnName} to be a number, got ${typeof value}`);
+        }
+        return new Date(value);
+    }
+    // For other types, return as is
+    return value;
+}
+function encodeColumnValue(value) {
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (typeof value === "number" && Number.isInteger(value)) {
+        return value.toString();
+    }
+    return value;
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/sqlite.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@absurd-sqlite/sdk",
+  "version": "0.2.0-alpha.0",
+  "description": "TypeScript SDK for Absurd-SQLite - SQLite-based durable task execution",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json && tsc --project tsconfig.cjs.json && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
+    "type-check": "tsc --noEmit",
+    "prepare": "npm run build",
+    "test:prepare": "cd ../../ && cargo build -p absurd-sqlite-extension --release",
+    "test": "npm run test:prepare && vitest --silent --run",
+    "test:watch": "npm run test:prepare && vitest",
+    "test:ui": "npm run test:prepare && vitest --ui",
+    "docs": "typedoc"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/b4fun/absurd-sqlite.git"
+  },
+  "keywords": [
+    "absurd",
+    "sqlite",
+    "queue",
+    "task",
+    "durable",
+    "workflow"
+  ],
+  "author": "",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/b4fun/absurd-sqlite/issues"
+  },
+  "homepage": "https://github.com/b4fun/absurd-sqlite#readme",
+  "peerDependencies": {
+    "better-sqlite3": "^12.5.0"
+  },
+  "dependencies": {
+    "absurd-sdk": "~0.0.7"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.18.0",
+    "typedoc": "^0.28.14",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.7"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}