@absurd-sqlite/sdk 0.2.1-alpha.1 → 0.3.0-alpha.0

package/test/sqlite.test.ts

@@ -4,13 +4,13 @@ import { mkdtempSync, rmSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 
-import { SqliteConnection } from "../src/sqlite";
+import { SQLiteConnection } from "../src/sqlite-connection";
 import type { SQLiteDatabase } from "../src/sqlite-types";
 
-describe("SqliteConnection", () => {
+describe("SQLiteConnection", () => {
   it("rewrites postgres-style params and absurd schema names", async () => {
-    const db = new sqlite(":memory:") as unknown as SQLiteDatabase;
-    const conn = new SqliteConnection(db);
+    const db = new sqlite(":memory:") as SQLiteDatabase;
+    const conn = new SQLiteConnection(db);
 
     await conn.exec("CREATE TABLE absurd_tasks (id, name)");
     await conn.exec("INSERT INTO absurd.tasks (id, name) VALUES ($1, $2)", [
@@ -28,8 +28,8 @@ describe("SqliteConnection", () => {
   });
 
   it("throws when query is used for non-reader statements", async () => {
-    const db = new sqlite(":memory:") as unknown as SQLiteDatabase;
-    const conn = new SqliteConnection(db);
+    const db = new sqlite(":memory:") as SQLiteDatabase;
+    const conn = new SQLiteConnection(db);
 
     await expect(conn.query("CREATE TABLE t (id)")).rejects.toThrow(
       "only statements that return data"
@@ -38,8 +38,8 @@ describe("SqliteConnection", () => {
   });
 
   it("decodes JSON from typeless columns", async () => {
-    const db = new sqlite(":memory:") as unknown as SQLiteDatabase;
-    const conn = new SqliteConnection(db);
+    const db = new sqlite(":memory:") as SQLiteDatabase;
+    const conn = new SQLiteConnection(db);
 
     await conn.exec("CREATE TABLE t (payload)");
     await conn.exec("INSERT INTO t (payload) VALUES ($1)", ['{"a":1}']);
@@ -53,8 +53,8 @@ describe("SqliteConnection", () => {
   });
 
   it("decodes JSON from blob columns", async () => {
-    const db = new sqlite(":memory:") as unknown as SQLiteDatabase;
-    const conn = new SqliteConnection(db);
+    const db = new sqlite(":memory:") as SQLiteDatabase;
+    const conn = new SQLiteConnection(db);
 
     await conn.exec("CREATE TABLE t_blob (payload BLOB)");
     await conn.exec("INSERT INTO t_blob (payload) VALUES ($1)", [
@@ -70,8 +70,8 @@ describe("SqliteConnection", () => {
   });
 
   it("decodes datetime columns into Date objects", async () => {
-    const db = new sqlite(":memory:") as unknown as SQLiteDatabase;
-    const conn = new SqliteConnection(db);
+    const db = new sqlite(":memory:") as SQLiteDatabase;
+    const conn = new SQLiteConnection(db);
     const now = Date.now();
 
     await conn.exec("CREATE TABLE t_date (created_at DATETIME)");
@@ -86,12 +86,42 @@ describe("SqliteConnection", () => {
     db.close();
   });
 
+  it("allows custom value codec overrides", async () => {
+    const db = new sqlite(":memory:") as SQLiteDatabase;
+    const encodedValues: unknown[] = [];
+    const conn = new SQLiteConnection(db, {
+      valueCodec: {
+        encodeParam: (value) => {
+          encodedValues.push(value);
+          return value;
+        },
+        decodeColumn: ({ value }) => {
+          if (typeof value === "string") {
+            return value.toUpperCase();
+          }
+          return value;
+        },
+      },
+    });
+
+    await conn.exec("CREATE TABLE t (name TEXT)");
+    await conn.exec("INSERT INTO t (name) VALUES ($1)", ["alpha"]);
+
+    const { rows } = await conn.query<{ name: string }>(
+      "SELECT name FROM t"
+    );
+
+    expect(encodedValues).toEqual(["alpha"]);
+    expect(rows[0]?.name).toBe("ALPHA");
+    db.close();
+  });
+
   it("retries when SQLite reports the database is busy", async () => {
     const tempDir = mkdtempSync(join(tmpdir(), "absurd-sqlite-busy-"));
     const dbPath = join(tempDir, "busy.db");
-    const primary = new sqlite(dbPath) as unknown as SQLiteDatabase;
+    const primary = new sqlite(dbPath) as SQLiteDatabase;
     (primary as any).pragma("busy_timeout = 1");
-    const conn = new SqliteConnection(primary);
+    const conn = new SQLiteConnection(primary);
     await conn.exec("CREATE TABLE t_busy (id INTEGER PRIMARY KEY, value TEXT)");
 
     const blocker = new sqlite(dbPath);
@@ -150,7 +180,7 @@ describe("SqliteConnection", () => {
       close: vi.fn(),
       loadExtension: vi.fn(),
     };
-    const conn = new SqliteConnection(db);
+    const conn = new SQLiteConnection(db);
 
     await expect(
       conn.exec("UPDATE locked_table SET value = $1 WHERE id = $2", [1, 1])

package/dist/absurd-types.d.ts

@@ -1,109 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

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

package/dist/absurd-types.js.map

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

package/dist/cjs/absurd-types.js

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

package/dist/sqlite.d.ts

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

package/dist/sqlite.d.ts.map

@@ -1 +0,0 @@
-{"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;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAK;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAM;gBAE3B,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;IAoBnB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;YAQvD,YAAY;CAc3B"}

package/dist/sqlite.js.map

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

package/src/absurd-types.ts

@@ -1,149 +0,0 @@
-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.
-   */
-  // bindToConnection(con: Queryable, owned?: boolean): this;
-
-  /**
-   * 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>;
-}