awaitly-libsql 0.1.0

package/README.md

@@ -0,0 +1,113 @@
+# awaitly-libsql
+
+libSQL / SQLite persistence adapter for [awaitly](https://github.com/jagreehal/awaitly) workflows.
+
+Provides a `StatePersistence` backed by [libSQL](https://docs.turso.tech/libsql) (SQLite-compatible),
+suitable for local development (`file:` URLs, `:memory:`) and remote deployments (e.g. Turso).
+
+## Installation
+
+```bash
+npm install awaitly-libsql @libsql/client
+# or
+pnpm add awaitly-libsql @libsql/client
+# or
+yarn add awaitly-libsql @libsql/client
+```
+
+## Quick Start
+
+```ts
+import { createLibSqlPersistence } from "awaitly-libsql";
+import { durable } from "awaitly/durable";
+
+const store = await createLibSqlPersistence({
+  // Local file database (good for dev)
+  url: "file:./awaitly.db",
+  // Optional: custom table name (default: "awaitly_workflow_state")
+  // tableName: "awaitly_workflow_state",
+});
+
+const result = await durable.run(
+  { fetchUser, createOrder },
+  async (step, { fetchUser, createOrder }) => {
+    const user = await step(() => fetchUser("123"), { key: "fetch-user" });
+    const order = await step(() => createOrder(user), { key: "create-order" });
+    return order;
+  },
+  {
+    id: "checkout-123",
+    store,
+  }
+);
+```
+
+## Remote libSQL / Turso
+
+```ts
+const store = await createLibSqlPersistence({
+  url: process.env.LIBSQL_URL!,          // e.g. "libsql://your-db.turso.io"
+  authToken: process.env.LIBSQL_AUTH_TOKEN,
+  tableName: "awaitly_workflow_state",
+});
+```
+
+## Tenant-Aware Keying (Recommended)
+
+To make it easier to avoid cross-tenant leaks in multi-tenant setups, use a
+tenant-specific key prefix:
+
+```ts
+const tenantId = "acme-tenant-123";
+
+const store = await createLibSqlPersistence({
+  url: "file:./awaitly.db",
+  prefix: `tenant:${tenantId}:workflow:state:`,
+});
+```
+
+All workflow keys will be stored with the configured prefix.
+
+## Table Schema
+
+The adapter automatically creates a table with the following schema:
+
+```sql
+CREATE TABLE awaitly_workflow_state (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL,
+  expires_at TEXT
+);
+
+CREATE INDEX idx_awaitly_workflow_state_expires_at
+ON awaitly_workflow_state(expires_at);
+```
+
+The `expires_at` column stores ISO 8601 timestamps and is used for TTL support.
+
+## Using the KeyValueStore Directly
+
+If you want lower-level control, you can use `LibSqlKeyValueStore` directly
+and wire it into `createStatePersistence`:
+
+```ts
+import { LibSqlKeyValueStore } from "awaitly-libsql";
+import { createStatePersistence } from "awaitly/persistence";
+
+const store = new LibSqlKeyValueStore({
+  url: "file:./awaitly.db",
+  tableName: "awaitly_workflow_state",
+});
+
+const persistence = createStatePersistence(store, "custom:prefix:");
+```
+
+## Requirements
+
+- Node.js >= 22
+- `@libsql/client` package
+
+## License
+
+MIT
+

package/dist/index.cjs

@@ -0,0 +1,32 @@
+"use strict";var l=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var h=(r,e)=>{for(var t in e)l(r,t,{get:e[t],enumerable:!0})},w=(r,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of p(e))!m.call(r,s)&&s!==t&&l(r,s,{get:()=>e[s],enumerable:!(i=u(e,s))||i.enumerable});return r};var S=r=>w(l({},"__esModule",{value:!0}),r);var g={};h(g,{LibSqlKeyValueStore:()=>a,createLibSqlPersistence:()=>d});module.exports=S(g);var o=require("@libsql/client"),a=class{client;tableName;initialized=!1;initPromise=null;constructor(e={}){if(e.client)this.client=e.client;else{let i=e.url??"file:./awaitly.db";this.client=(0,o.createClient)({url:i,authToken:e.authToken})}let t=e.tableName??"awaitly_workflow_state";if(!/^[A-Za-z0-9_]+$/.test(t))throw new Error(`Invalid table name '${t}'. Only alphanumeric and underscore characters are allowed.`);this.tableName=t}async ensureInitialized(){if(!this.initialized)return this.initPromise?this.initPromise:(this.initPromise=(async()=>{try{await this.createTable(),this.initialized=!0}finally{this.initialized||(this.initPromise=null)}})(),this.initPromise)}async createTable(){await this.client.execute({sql:`
+        CREATE TABLE IF NOT EXISTS ${this.tableName} (
+          key TEXT PRIMARY KEY,
+          value TEXT NOT NULL,
+          expires_at TEXT
+        );
+      `,args:[]}),await this.client.execute({sql:`
+        CREATE INDEX IF NOT EXISTS idx_${this.tableName}_expires_at
+        ON ${this.tableName}(expires_at);
+      `,args:[]})}patternToLike(e){return e.replace(/%/g,"\\%").replace(/_/g,"\\_").replace(/\*/g,"%")}async get(e){await this.ensureInitialized();let t=new Date().toISOString(),i=await this.client.execute({sql:`
+        SELECT value, expires_at
+        FROM ${this.tableName}
+        WHERE key = ?
+      `,args:[e]});if(i.rows.length===0)return null;let s=i.rows[0],n=s.expires_at;return n&&n<=t?null:s.value??null}async set(e,t,i){await this.ensureInitialized();let s=i?.ttl&&i.ttl>0?new Date(Date.now()+i.ttl*1e3).toISOString():null;await this.client.execute({sql:`
+        INSERT INTO ${this.tableName} (key, value, expires_at)
+        VALUES (?, ?, ?)
+        ON CONFLICT(key) DO UPDATE SET
+          value = excluded.value,
+          expires_at = excluded.expires_at
+      `,args:[e,t,s]})}async delete(e){await this.ensureInitialized();let i=(await this.client.execute({sql:`DELETE FROM ${this.tableName} WHERE key = ?`,args:[e]})).rowsAffected;return typeof i=="number"?i>0:await this.get(e)===null}async exists(e){await this.ensureInitialized();let t=new Date().toISOString();return(await this.client.execute({sql:`
+        SELECT 1
+        FROM ${this.tableName}
+        WHERE key = ?
+          AND (expires_at IS NULL OR expires_at > ?)
+        LIMIT 1
+      `,args:[e,t]})).rows.length>0}async keys(e){await this.ensureInitialized();let t=this.patternToLike(e),i=new Date().toISOString();return(await this.client.execute({sql:`
+        SELECT key
+        FROM ${this.tableName}
+        WHERE key LIKE ? ESCAPE '\\'
+          AND (expires_at IS NULL OR expires_at > ?)
+      `,args:[t,i]})).rows.map(n=>n.key)}async close(){}};var c=require("awaitly/persistence");async function d(r={}){let{prefix:e,...t}=r,i=new a(t);return(0,c.createStatePersistence)(i,e)}0&&(module.exports={LibSqlKeyValueStore,createLibSqlPersistence});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/libsql-store.ts"],"sourcesContent":["/**\n * awaitly-libsql\n *\n * libSQL / SQLite persistence adapter for awaitly workflows.\n * Provides ready-to-use StatePersistence backed by libSQL.\n */\n\nimport { LibSqlKeyValueStore, type LibSqlKeyValueStoreOptions } from \"./libsql-store\";\nimport { createStatePersistence, type StatePersistence } from \"awaitly/persistence\";\n\n/**\n * Options for creating libSQL persistence.\n */\nexport interface LibSqlPersistenceOptions extends LibSqlKeyValueStoreOptions {\n  /**\n   * Key prefix for state entries.\n   * @default \"workflow:state:\"\n   */\n  prefix?: string;\n}\n\n/**\n * Create a StatePersistence instance backed by libSQL / SQLite.\n *\n * The table is automatically created on first use.\n *\n * @param options - libSQL connection and configuration options\n * @returns StatePersistence instance ready to use with durable.run()\n *\n * @example\n * ```typescript\n * import { createLibSqlPersistence } from \"awaitly-libsql\";\n * import { durable } from \"awaitly/durable\";\n *\n * const store = await createLibSqlPersistence({\n *   url: \"file:./awaitly.db\",\n * });\n *\n * const result = await durable.run(\n *   { fetchUser, createOrder },\n *   async (step, { fetchUser, createOrder }) => {\n *     const user = await step(() => fetchUser(\"123\"), { key: \"fetch-user\" });\n *     const order = await step(() => createOrder(user), { key: \"create-order\" });\n *     return order;\n *   },\n *   {\n *     id: \"checkout-123\",\n *     store,\n *   }\n * );\n * ```\n *\n * @example\n * ```typescript\n * // Using remote Turso (libSQL) instance\n * const store = await createLibSqlPersistence({\n *   url: process.env.LIBSQL_URL!,\n *   authToken: process.env.LIBSQL_AUTH_TOKEN,\n *   tableName: \"awaitly_workflow_state\",\n * });\n * ```\n */\nexport async function createLibSqlPersistence(\n  options: LibSqlPersistenceOptions = {}\n): Promise<\n  StatePersistence & {\n    loadRaw(runId: string): Promise<import(\"awaitly/persistence\").SerializedState | undefined>;\n  }\n> {\n  const { prefix, ...storeOptions } = options;\n\n  const store = new LibSqlKeyValueStore(storeOptions);\n  return createStatePersistence(store, prefix);\n}\n\n/**\n * libSQL KeyValueStore implementation.\n * Use this directly if you need more control over the store.\n *\n * @example\n * ```typescript\n * import { LibSqlKeyValueStore } from \"awaitly-libsql\";\n * import { createStatePersistence } from \"awaitly/persistence\";\n *\n * const store = new LibSqlKeyValueStore({\n *   url: \"file:./awaitly.db\",\n * });\n *\n * const persistence = createStatePersistence(store, \"custom:prefix:\");\n * ```\n */\nexport { LibSqlKeyValueStore, type LibSqlKeyValueStoreOptions };\n\n","/**\n * awaitly-libsql\n *\n * libSQL / SQLite KeyValueStore implementation for awaitly persistence.\n */\n\nimport { createClient, type Client } from \"@libsql/client\";\nimport type { KeyValueStore } from \"awaitly/persistence\";\n\n/**\n * Options for libSQL / SQLite KeyValueStore.\n */\nexport interface LibSqlKeyValueStoreOptions {\n  /**\n   * libSQL database URL.\n   *\n   * Examples:\n   * - \"file:./awaitly.db\" (local file)\n   * - \":memory:\" (in-memory, for tests)\n   * - \"libsql://your-db.turso.io\" (remote)\n   *\n   * @default \"file:./awaitly.db\"\n   */\n  url?: string;\n\n  /**\n   * Authentication token for remote libSQL databases (e.g. Turso).\n   */\n  authToken?: string;\n\n  /**\n   * Table name for storing key-value pairs.\n   * @default \"awaitly_workflow_state\"\n   */\n  tableName?: string;\n\n  /**\n   * Existing libSQL client to use.\n   * If provided, url/authToken options are ignored.\n   */\n  client?: Client;\n}\n\n/**\n * libSQL / SQLite implementation of KeyValueStore.\n *\n * Automatically creates the required table on first use.\n * Supports TTL via ISO 8601 `expires_at` column.\n */\nexport class LibSqlKeyValueStore implements KeyValueStore {\n  private client: Client;\n  private tableName: string;\n  private initialized = false;\n  private initPromise: Promise<void> | null = null;\n\n  constructor(options: LibSqlKeyValueStoreOptions = {}) {\n    if (options.client) {\n      this.client = options.client;\n    } else {\n      const url = options.url ?? \"file:./awaitly.db\";\n      this.client = createClient({\n        url,\n        authToken: options.authToken,\n      });\n    }\n\n    const tableName = options.tableName ?? \"awaitly_workflow_state\";\n    if (!/^[A-Za-z0-9_]+$/.test(tableName)) {\n      throw new Error(\n        `Invalid table name '${tableName}'. Only alphanumeric and underscore characters are allowed.`\n      );\n    }\n    this.tableName = tableName;\n  }\n\n  /**\n   * Initialize the store by creating the table and index if they don't exist.\n   * This is called automatically on first use.\n   */\n  private async ensureInitialized(): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    if (this.initPromise) {\n      return this.initPromise;\n    }\n\n    this.initPromise = (async () => {\n      try {\n        await this.createTable();\n        this.initialized = true;\n      } finally {\n        if (!this.initialized) {\n          this.initPromise = null;\n        }\n      }\n    })();\n\n    return this.initPromise;\n  }\n\n  /**\n   * Create the table and index if they don't exist.\n   */\n  private async createTable(): Promise<void> {\n    // SQLite / libSQL: execute schema changes as separate statements\n    await this.client.execute({\n      sql: `\n        CREATE TABLE IF NOT EXISTS ${this.tableName} (\n          key TEXT PRIMARY KEY,\n          value TEXT NOT NULL,\n          expires_at TEXT\n        );\n      `,\n      args: [],\n    });\n\n    await this.client.execute({\n      sql: `\n        CREATE INDEX IF NOT EXISTS idx_${this.tableName}_expires_at\n        ON ${this.tableName}(expires_at);\n      `,\n      args: [],\n    });\n  }\n\n  /**\n   * Convert glob pattern to SQL LIKE pattern.\n   * Supports * wildcard (matches any characters).\n   */\n  private patternToLike(pattern: string): string {\n    // Escape LIKE special characters and convert * to %\n    return pattern.replace(/%/g, \"\\\\%\").replace(/_/g, \"\\\\_\").replace(/\\*/g, \"%\");\n  }\n\n  async get(key: string): Promise<string | null> {\n    await this.ensureInitialized();\n\n    const nowIso = new Date().toISOString();\n    const result = await this.client.execute({\n      sql: `\n        SELECT value, expires_at\n        FROM ${this.tableName}\n        WHERE key = ?\n      `,\n      args: [key],\n    });\n\n    if (result.rows.length === 0) {\n      return null;\n    }\n\n    const row = result.rows[0] as Record<string, unknown>;\n    const expiresAt = row[\"expires_at\"] as string | null | undefined;\n\n    if (expiresAt && expiresAt <= nowIso) {\n      // Expired - behave as if key doesn't exist\n      return null;\n    }\n\n    return (row[\"value\"] as string) ?? null;\n  }\n\n  async set(key: string, value: string, options?: { ttl?: number }): Promise<void> {\n    await this.ensureInitialized();\n\n    const expiresAt =\n      options?.ttl && options.ttl > 0\n        ? new Date(Date.now() + options.ttl * 1000).toISOString()\n        : null;\n\n    await this.client.execute({\n      sql: `\n        INSERT INTO ${this.tableName} (key, value, expires_at)\n        VALUES (?, ?, ?)\n        ON CONFLICT(key) DO UPDATE SET\n          value = excluded.value,\n          expires_at = excluded.expires_at\n      `,\n      args: [key, value, expiresAt],\n    });\n  }\n\n  async delete(key: string): Promise<boolean> {\n    await this.ensureInitialized();\n\n    const result = await this.client.execute({\n      sql: `DELETE FROM ${this.tableName} WHERE key = ?`,\n      args: [key],\n    });\n\n    // libSQL .rowsAffected is available on hrana responses; fall back to > 0 check\n    const affected: number | undefined = result.rowsAffected;\n    if (typeof affected === \"number\") {\n      return affected > 0;\n    }\n\n    // If rowsAffected is not available, perform an existence check as a fallback\n    const after = await this.get(key);\n    return after === null;\n  }\n\n  async exists(key: string): Promise<boolean> {\n    await this.ensureInitialized();\n\n    const nowIso = new Date().toISOString();\n    const result = await this.client.execute({\n      sql: `\n        SELECT 1\n        FROM ${this.tableName}\n        WHERE key = ?\n          AND (expires_at IS NULL OR expires_at > ?)\n        LIMIT 1\n      `,\n      args: [key, nowIso],\n    });\n\n    return result.rows.length > 0;\n  }\n\n  async keys(pattern: string): Promise<string[]> {\n    await this.ensureInitialized();\n\n    const likePattern = this.patternToLike(pattern);\n    const nowIso = new Date().toISOString();\n\n    const result = await this.client.execute({\n      sql: `\n        SELECT key\n        FROM ${this.tableName}\n        WHERE key LIKE ? ESCAPE '\\\\'\n          AND (expires_at IS NULL OR expires_at > ?)\n      `,\n      args: [likePattern, nowIso],\n    });\n\n    return result.rows.map((row) => (row as Record<string, unknown>)[\"key\"] as string);\n  }\n\n  /**\n   * Close the underlying client if it supports close().\n   */\n  async close(): Promise<void> {\n    // libSQL client doesn't expose a close API in all runtimes; no-op for now.\n    // If a future version adds client.close(), it can be wired here.\n  }\n}\n\n"],"mappings":"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","names":["index_exports","__export","LibSqlKeyValueStore","createLibSqlPersistence","__toCommonJS","import_client","LibSqlKeyValueStore","options","url","tableName","pattern","key","nowIso","result","row","expiresAt","value","affected","likePattern","import_persistence","createLibSqlPersistence","options","prefix","storeOptions","store","LibSqlKeyValueStore"]}

package/dist/index.d.cts

@@ -0,0 +1,135 @@
+import * as awaitly_persistence from 'awaitly/persistence';
+import { KeyValueStore, StatePersistence } from 'awaitly/persistence';
+import { Client } from '@libsql/client';
+
+/**
+ * awaitly-libsql
+ *
+ * libSQL / SQLite KeyValueStore implementation for awaitly persistence.
+ */
+
+/**
+ * Options for libSQL / SQLite KeyValueStore.
+ */
+interface LibSqlKeyValueStoreOptions {
+    /**
+     * libSQL database URL.
+     *
+     * Examples:
+     * - "file:./awaitly.db" (local file)
+     * - ":memory:" (in-memory, for tests)
+     * - "libsql://your-db.turso.io" (remote)
+     *
+     * @default "file:./awaitly.db"
+     */
+    url?: string;
+    /**
+     * Authentication token for remote libSQL databases (e.g. Turso).
+     */
+    authToken?: string;
+    /**
+     * Table name for storing key-value pairs.
+     * @default "awaitly_workflow_state"
+     */
+    tableName?: string;
+    /**
+     * Existing libSQL client to use.
+     * If provided, url/authToken options are ignored.
+     */
+    client?: Client;
+}
+/**
+ * libSQL / SQLite implementation of KeyValueStore.
+ *
+ * Automatically creates the required table on first use.
+ * Supports TTL via ISO 8601 `expires_at` column.
+ */
+declare class LibSqlKeyValueStore implements KeyValueStore {
+    private client;
+    private tableName;
+    private initialized;
+    private initPromise;
+    constructor(options?: LibSqlKeyValueStoreOptions);
+    /**
+     * Initialize the store by creating the table and index if they don't exist.
+     * This is called automatically on first use.
+     */
+    private ensureInitialized;
+    /**
+     * Create the table and index if they don't exist.
+     */
+    private createTable;
+    /**
+     * Convert glob pattern to SQL LIKE pattern.
+     * Supports * wildcard (matches any characters).
+     */
+    private patternToLike;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, options?: {
+        ttl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    exists(key: string): Promise<boolean>;
+    keys(pattern: string): Promise<string[]>;
+    /**
+     * Close the underlying client if it supports close().
+     */
+    close(): Promise<void>;
+}
+
+/**
+ * Options for creating libSQL persistence.
+ */
+interface LibSqlPersistenceOptions extends LibSqlKeyValueStoreOptions {
+    /**
+     * Key prefix for state entries.
+     * @default "workflow:state:"
+     */
+    prefix?: string;
+}
+/**
+ * Create a StatePersistence instance backed by libSQL / SQLite.
+ *
+ * The table is automatically created on first use.
+ *
+ * @param options - libSQL connection and configuration options
+ * @returns StatePersistence instance ready to use with durable.run()
+ *
+ * @example
+ * ```typescript
+ * import { createLibSqlPersistence } from "awaitly-libsql";
+ * import { durable } from "awaitly/durable";
+ *
+ * const store = await createLibSqlPersistence({
+ *   url: "file:./awaitly.db",
+ * });
+ *
+ * const result = await durable.run(
+ *   { fetchUser, createOrder },
+ *   async (step, { fetchUser, createOrder }) => {
+ *     const user = await step(() => fetchUser("123"), { key: "fetch-user" });
+ *     const order = await step(() => createOrder(user), { key: "create-order" });
+ *     return order;
+ *   },
+ *   {
+ *     id: "checkout-123",
+ *     store,
+ *   }
+ * );
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using remote Turso (libSQL) instance
+ * const store = await createLibSqlPersistence({
+ *   url: process.env.LIBSQL_URL!,
+ *   authToken: process.env.LIBSQL_AUTH_TOKEN,
+ *   tableName: "awaitly_workflow_state",
+ * });
+ * ```
+ */
+declare function createLibSqlPersistence(options?: LibSqlPersistenceOptions): Promise<StatePersistence & {
+    loadRaw(runId: string): Promise<awaitly_persistence.SerializedState | undefined>;
+}>;
+
+export { LibSqlKeyValueStore, type LibSqlKeyValueStoreOptions, type LibSqlPersistenceOptions, createLibSqlPersistence };

package/dist/index.d.ts

@@ -0,0 +1,135 @@
+import * as awaitly_persistence from 'awaitly/persistence';
+import { KeyValueStore, StatePersistence } from 'awaitly/persistence';
+import { Client } from '@libsql/client';
+
+/**
+ * awaitly-libsql
+ *
+ * libSQL / SQLite KeyValueStore implementation for awaitly persistence.
+ */
+
+/**
+ * Options for libSQL / SQLite KeyValueStore.
+ */
+interface LibSqlKeyValueStoreOptions {
+    /**
+     * libSQL database URL.
+     *
+     * Examples:
+     * - "file:./awaitly.db" (local file)
+     * - ":memory:" (in-memory, for tests)
+     * - "libsql://your-db.turso.io" (remote)
+     *
+     * @default "file:./awaitly.db"
+     */
+    url?: string;
+    /**
+     * Authentication token for remote libSQL databases (e.g. Turso).
+     */
+    authToken?: string;
+    /**
+     * Table name for storing key-value pairs.
+     * @default "awaitly_workflow_state"
+     */
+    tableName?: string;
+    /**
+     * Existing libSQL client to use.
+     * If provided, url/authToken options are ignored.
+     */
+    client?: Client;
+}
+/**
+ * libSQL / SQLite implementation of KeyValueStore.
+ *
+ * Automatically creates the required table on first use.
+ * Supports TTL via ISO 8601 `expires_at` column.
+ */
+declare class LibSqlKeyValueStore implements KeyValueStore {
+    private client;
+    private tableName;
+    private initialized;
+    private initPromise;
+    constructor(options?: LibSqlKeyValueStoreOptions);
+    /**
+     * Initialize the store by creating the table and index if they don't exist.
+     * This is called automatically on first use.
+     */
+    private ensureInitialized;
+    /**
+     * Create the table and index if they don't exist.
+     */
+    private createTable;
+    /**
+     * Convert glob pattern to SQL LIKE pattern.
+     * Supports * wildcard (matches any characters).
+     */
+    private patternToLike;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, options?: {
+        ttl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    exists(key: string): Promise<boolean>;
+    keys(pattern: string): Promise<string[]>;
+    /**
+     * Close the underlying client if it supports close().
+     */
+    close(): Promise<void>;
+}
+
+/**
+ * Options for creating libSQL persistence.
+ */
+interface LibSqlPersistenceOptions extends LibSqlKeyValueStoreOptions {
+    /**
+     * Key prefix for state entries.
+     * @default "workflow:state:"
+     */
+    prefix?: string;
+}
+/**
+ * Create a StatePersistence instance backed by libSQL / SQLite.
+ *
+ * The table is automatically created on first use.
+ *
+ * @param options - libSQL connection and configuration options
+ * @returns StatePersistence instance ready to use with durable.run()
+ *
+ * @example
+ * ```typescript
+ * import { createLibSqlPersistence } from "awaitly-libsql";
+ * import { durable } from "awaitly/durable";
+ *
+ * const store = await createLibSqlPersistence({
+ *   url: "file:./awaitly.db",
+ * });
+ *
+ * const result = await durable.run(
+ *   { fetchUser, createOrder },
+ *   async (step, { fetchUser, createOrder }) => {
+ *     const user = await step(() => fetchUser("123"), { key: "fetch-user" });
+ *     const order = await step(() => createOrder(user), { key: "create-order" });
+ *     return order;
+ *   },
+ *   {
+ *     id: "checkout-123",
+ *     store,
+ *   }
+ * );
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using remote Turso (libSQL) instance
+ * const store = await createLibSqlPersistence({
+ *   url: process.env.LIBSQL_URL!,
+ *   authToken: process.env.LIBSQL_AUTH_TOKEN,
+ *   tableName: "awaitly_workflow_state",
+ * });
+ * ```
+ */
+declare function createLibSqlPersistence(options?: LibSqlPersistenceOptions): Promise<StatePersistence & {
+    loadRaw(runId: string): Promise<awaitly_persistence.SerializedState | undefined>;
+}>;
+
+export { LibSqlKeyValueStore, type LibSqlKeyValueStoreOptions, type LibSqlPersistenceOptions, createLibSqlPersistence };

package/dist/index.js

@@ -0,0 +1,32 @@
+import{createClient as l}from"@libsql/client";var a=class{client;tableName;initialized=!1;initPromise=null;constructor(e={}){if(e.client)this.client=e.client;else{let t=e.url??"file:./awaitly.db";this.client=l({url:t,authToken:e.authToken})}let i=e.tableName??"awaitly_workflow_state";if(!/^[A-Za-z0-9_]+$/.test(i))throw new Error(`Invalid table name '${i}'. Only alphanumeric and underscore characters are allowed.`);this.tableName=i}async ensureInitialized(){if(!this.initialized)return this.initPromise?this.initPromise:(this.initPromise=(async()=>{try{await this.createTable(),this.initialized=!0}finally{this.initialized||(this.initPromise=null)}})(),this.initPromise)}async createTable(){await this.client.execute({sql:`
+        CREATE TABLE IF NOT EXISTS ${this.tableName} (
+          key TEXT PRIMARY KEY,
+          value TEXT NOT NULL,
+          expires_at TEXT
+        );
+      `,args:[]}),await this.client.execute({sql:`
+        CREATE INDEX IF NOT EXISTS idx_${this.tableName}_expires_at
+        ON ${this.tableName}(expires_at);
+      `,args:[]})}patternToLike(e){return e.replace(/%/g,"\\%").replace(/_/g,"\\_").replace(/\*/g,"%")}async get(e){await this.ensureInitialized();let i=new Date().toISOString(),t=await this.client.execute({sql:`
+        SELECT value, expires_at
+        FROM ${this.tableName}
+        WHERE key = ?
+      `,args:[e]});if(t.rows.length===0)return null;let s=t.rows[0],r=s.expires_at;return r&&r<=i?null:s.value??null}async set(e,i,t){await this.ensureInitialized();let s=t?.ttl&&t.ttl>0?new Date(Date.now()+t.ttl*1e3).toISOString():null;await this.client.execute({sql:`
+        INSERT INTO ${this.tableName} (key, value, expires_at)
+        VALUES (?, ?, ?)
+        ON CONFLICT(key) DO UPDATE SET
+          value = excluded.value,
+          expires_at = excluded.expires_at
+      `,args:[e,i,s]})}async delete(e){await this.ensureInitialized();let t=(await this.client.execute({sql:`DELETE FROM ${this.tableName} WHERE key = ?`,args:[e]})).rowsAffected;return typeof t=="number"?t>0:await this.get(e)===null}async exists(e){await this.ensureInitialized();let i=new Date().toISOString();return(await this.client.execute({sql:`
+        SELECT 1
+        FROM ${this.tableName}
+        WHERE key = ?
+          AND (expires_at IS NULL OR expires_at > ?)
+        LIMIT 1
+      `,args:[e,i]})).rows.length>0}async keys(e){await this.ensureInitialized();let i=this.patternToLike(e),t=new Date().toISOString();return(await this.client.execute({sql:`
+        SELECT key
+        FROM ${this.tableName}
+        WHERE key LIKE ? ESCAPE '\\'
+          AND (expires_at IS NULL OR expires_at > ?)
+      `,args:[i,t]})).rows.map(r=>r.key)}async close(){}};import{createStatePersistence as o}from"awaitly/persistence";async function h(n={}){let{prefix:e,...i}=n,t=new a(i);return o(t,e)}export{a as LibSqlKeyValueStore,h as createLibSqlPersistence};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/libsql-store.ts","../src/index.ts"],"sourcesContent":["/**\n * awaitly-libsql\n *\n * libSQL / SQLite KeyValueStore implementation for awaitly persistence.\n */\n\nimport { createClient, type Client } from \"@libsql/client\";\nimport type { KeyValueStore } from \"awaitly/persistence\";\n\n/**\n * Options for libSQL / SQLite KeyValueStore.\n */\nexport interface LibSqlKeyValueStoreOptions {\n  /**\n   * libSQL database URL.\n   *\n   * Examples:\n   * - \"file:./awaitly.db\" (local file)\n   * - \":memory:\" (in-memory, for tests)\n   * - \"libsql://your-db.turso.io\" (remote)\n   *\n   * @default \"file:./awaitly.db\"\n   */\n  url?: string;\n\n  /**\n   * Authentication token for remote libSQL databases (e.g. Turso).\n   */\n  authToken?: string;\n\n  /**\n   * Table name for storing key-value pairs.\n   * @default \"awaitly_workflow_state\"\n   */\n  tableName?: string;\n\n  /**\n   * Existing libSQL client to use.\n   * If provided, url/authToken options are ignored.\n   */\n  client?: Client;\n}\n\n/**\n * libSQL / SQLite implementation of KeyValueStore.\n *\n * Automatically creates the required table on first use.\n * Supports TTL via ISO 8601 `expires_at` column.\n */\nexport class LibSqlKeyValueStore implements KeyValueStore {\n  private client: Client;\n  private tableName: string;\n  private initialized = false;\n  private initPromise: Promise<void> | null = null;\n\n  constructor(options: LibSqlKeyValueStoreOptions = {}) {\n    if (options.client) {\n      this.client = options.client;\n    } else {\n      const url = options.url ?? \"file:./awaitly.db\";\n      this.client = createClient({\n        url,\n        authToken: options.authToken,\n      });\n    }\n\n    const tableName = options.tableName ?? \"awaitly_workflow_state\";\n    if (!/^[A-Za-z0-9_]+$/.test(tableName)) {\n      throw new Error(\n        `Invalid table name '${tableName}'. Only alphanumeric and underscore characters are allowed.`\n      );\n    }\n    this.tableName = tableName;\n  }\n\n  /**\n   * Initialize the store by creating the table and index if they don't exist.\n   * This is called automatically on first use.\n   */\n  private async ensureInitialized(): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    if (this.initPromise) {\n      return this.initPromise;\n    }\n\n    this.initPromise = (async () => {\n      try {\n        await this.createTable();\n        this.initialized = true;\n      } finally {\n        if (!this.initialized) {\n          this.initPromise = null;\n        }\n      }\n    })();\n\n    return this.initPromise;\n  }\n\n  /**\n   * Create the table and index if they don't exist.\n   */\n  private async createTable(): Promise<void> {\n    // SQLite / libSQL: execute schema changes as separate statements\n    await this.client.execute({\n      sql: `\n        CREATE TABLE IF NOT EXISTS ${this.tableName} (\n          key TEXT PRIMARY KEY,\n          value TEXT NOT NULL,\n          expires_at TEXT\n        );\n      `,\n      args: [],\n    });\n\n    await this.client.execute({\n      sql: `\n        CREATE INDEX IF NOT EXISTS idx_${this.tableName}_expires_at\n        ON ${this.tableName}(expires_at);\n      `,\n      args: [],\n    });\n  }\n\n  /**\n   * Convert glob pattern to SQL LIKE pattern.\n   * Supports * wildcard (matches any characters).\n   */\n  private patternToLike(pattern: string): string {\n    // Escape LIKE special characters and convert * to %\n    return pattern.replace(/%/g, \"\\\\%\").replace(/_/g, \"\\\\_\").replace(/\\*/g, \"%\");\n  }\n\n  async get(key: string): Promise<string | null> {\n    await this.ensureInitialized();\n\n    const nowIso = new Date().toISOString();\n    const result = await this.client.execute({\n      sql: `\n        SELECT value, expires_at\n        FROM ${this.tableName}\n        WHERE key = ?\n      `,\n      args: [key],\n    });\n\n    if (result.rows.length === 0) {\n      return null;\n    }\n\n    const row = result.rows[0] as Record<string, unknown>;\n    const expiresAt = row[\"expires_at\"] as string | null | undefined;\n\n    if (expiresAt && expiresAt <= nowIso) {\n      // Expired - behave as if key doesn't exist\n      return null;\n    }\n\n    return (row[\"value\"] as string) ?? null;\n  }\n\n  async set(key: string, value: string, options?: { ttl?: number }): Promise<void> {\n    await this.ensureInitialized();\n\n    const expiresAt =\n      options?.ttl && options.ttl > 0\n        ? new Date(Date.now() + options.ttl * 1000).toISOString()\n        : null;\n\n    await this.client.execute({\n      sql: `\n        INSERT INTO ${this.tableName} (key, value, expires_at)\n        VALUES (?, ?, ?)\n        ON CONFLICT(key) DO UPDATE SET\n          value = excluded.value,\n          expires_at = excluded.expires_at\n      `,\n      args: [key, value, expiresAt],\n    });\n  }\n\n  async delete(key: string): Promise<boolean> {\n    await this.ensureInitialized();\n\n    const result = await this.client.execute({\n      sql: `DELETE FROM ${this.tableName} WHERE key = ?`,\n      args: [key],\n    });\n\n    // libSQL .rowsAffected is available on hrana responses; fall back to > 0 check\n    const affected: number | undefined = result.rowsAffected;\n    if (typeof affected === \"number\") {\n      return affected > 0;\n    }\n\n    // If rowsAffected is not available, perform an existence check as a fallback\n    const after = await this.get(key);\n    return after === null;\n  }\n\n  async exists(key: string): Promise<boolean> {\n    await this.ensureInitialized();\n\n    const nowIso = new Date().toISOString();\n    const result = await this.client.execute({\n      sql: `\n        SELECT 1\n        FROM ${this.tableName}\n        WHERE key = ?\n          AND (expires_at IS NULL OR expires_at > ?)\n        LIMIT 1\n      `,\n      args: [key, nowIso],\n    });\n\n    return result.rows.length > 0;\n  }\n\n  async keys(pattern: string): Promise<string[]> {\n    await this.ensureInitialized();\n\n    const likePattern = this.patternToLike(pattern);\n    const nowIso = new Date().toISOString();\n\n    const result = await this.client.execute({\n      sql: `\n        SELECT key\n        FROM ${this.tableName}\n        WHERE key LIKE ? ESCAPE '\\\\'\n          AND (expires_at IS NULL OR expires_at > ?)\n      `,\n      args: [likePattern, nowIso],\n    });\n\n    return result.rows.map((row) => (row as Record<string, unknown>)[\"key\"] as string);\n  }\n\n  /**\n   * Close the underlying client if it supports close().\n   */\n  async close(): Promise<void> {\n    // libSQL client doesn't expose a close API in all runtimes; no-op for now.\n    // If a future version adds client.close(), it can be wired here.\n  }\n}\n\n","/**\n * awaitly-libsql\n *\n * libSQL / SQLite persistence adapter for awaitly workflows.\n * Provides ready-to-use StatePersistence backed by libSQL.\n */\n\nimport { LibSqlKeyValueStore, type LibSqlKeyValueStoreOptions } from \"./libsql-store\";\nimport { createStatePersistence, type StatePersistence } from \"awaitly/persistence\";\n\n/**\n * Options for creating libSQL persistence.\n */\nexport interface LibSqlPersistenceOptions extends LibSqlKeyValueStoreOptions {\n  /**\n   * Key prefix for state entries.\n   * @default \"workflow:state:\"\n   */\n  prefix?: string;\n}\n\n/**\n * Create a StatePersistence instance backed by libSQL / SQLite.\n *\n * The table is automatically created on first use.\n *\n * @param options - libSQL connection and configuration options\n * @returns StatePersistence instance ready to use with durable.run()\n *\n * @example\n * ```typescript\n * import { createLibSqlPersistence } from \"awaitly-libsql\";\n * import { durable } from \"awaitly/durable\";\n *\n * const store = await createLibSqlPersistence({\n *   url: \"file:./awaitly.db\",\n * });\n *\n * const result = await durable.run(\n *   { fetchUser, createOrder },\n *   async (step, { fetchUser, createOrder }) => {\n *     const user = await step(() => fetchUser(\"123\"), { key: \"fetch-user\" });\n *     const order = await step(() => createOrder(user), { key: \"create-order\" });\n *     return order;\n *   },\n *   {\n *     id: \"checkout-123\",\n *     store,\n *   }\n * );\n * ```\n *\n * @example\n * ```typescript\n * // Using remote Turso (libSQL) instance\n * const store = await createLibSqlPersistence({\n *   url: process.env.LIBSQL_URL!,\n *   authToken: process.env.LIBSQL_AUTH_TOKEN,\n *   tableName: \"awaitly_workflow_state\",\n * });\n * ```\n */\nexport async function createLibSqlPersistence(\n  options: LibSqlPersistenceOptions = {}\n): Promise<\n  StatePersistence & {\n    loadRaw(runId: string): Promise<import(\"awaitly/persistence\").SerializedState | undefined>;\n  }\n> {\n  const { prefix, ...storeOptions } = options;\n\n  const store = new LibSqlKeyValueStore(storeOptions);\n  return createStatePersistence(store, prefix);\n}\n\n/**\n * libSQL KeyValueStore implementation.\n * Use this directly if you need more control over the store.\n *\n * @example\n * ```typescript\n * import { LibSqlKeyValueStore } from \"awaitly-libsql\";\n * import { createStatePersistence } from \"awaitly/persistence\";\n *\n * const store = new LibSqlKeyValueStore({\n *   url: \"file:./awaitly.db\",\n * });\n *\n * const persistence = createStatePersistence(store, \"custom:prefix:\");\n * ```\n */\nexport { LibSqlKeyValueStore, type LibSqlKeyValueStoreOptions };\n\n"],"mappings":"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","names":["createClient","LibSqlKeyValueStore","options","url","tableName","pattern","key","nowIso","result","row","expiresAt","value","affected","likePattern","createStatePersistence","createLibSqlPersistence","options","prefix","storeOptions","store","LibSqlKeyValueStore"]}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "awaitly-libsql",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "libSQL / SQLite persistence adapter for awaitly workflows",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "lint": "eslint .",
+    "clean": "rm -rf dist",
+    "quality": "pnpm type-check && pnpm test && pnpm lint"
+  },
+  "keywords": [
+    "awaitly",
+    "workflow",
+    "persistence",
+    "sqlite",
+    "libsql",
+    "turso",
+    "database",
+    "durable-execution"
+  ],
+  "author": "Jag Reehal <jag@jagreehal.com>",
+  "homepage": "https://github.com/jagreehal/awaitly#readme",
+  "bugs": {
+    "url": "https://github.com/jagreehal/awaitly/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jagreehal/awaitly.git"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "awaitly": "workspace:^"
+  },
+  "dependencies": {
+    "@libsql/client": "^0.17.0"
+  },
+  "devDependencies": {
+    "@total-typescript/ts-reset": "^0.6.1",
+    "@total-typescript/tsconfig": "^1.0.4",
+    "@types/node": "^25.1.0",
+    "awaitly": "workspace:^",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}