@dexto/storage 1.6.0

package/dist/database/schemas.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { EnvExpandedString, ErrorScope, ErrorType, StorageErrorCode } from "@dexto/core";
+const DATABASE_TYPES = ["in-memory", "sqlite", "postgres"];
+const BaseDatabaseSchema = z.object({
+  maxConnections: z.number().int().positive().optional().describe("Maximum connections"),
+  idleTimeoutMillis: z.number().int().positive().optional().describe("Idle timeout in milliseconds"),
+  connectionTimeoutMillis: z.number().int().positive().optional().describe("Connection timeout in milliseconds"),
+  options: z.record(z.unknown()).optional().describe("Backend-specific options")
+});
+const InMemoryDatabaseSchema = BaseDatabaseSchema.extend({
+  type: z.literal("in-memory")
+  // In-memory database doesn't need connection options, but inherits pool options for consistency
+}).strict();
+const SqliteDatabaseSchema = BaseDatabaseSchema.extend({
+  type: z.literal("sqlite"),
+  path: z.string().describe(
+    "SQLite database file path (required for SQLite - CLI enrichment provides per-agent path)"
+  )
+}).strict();
+const PostgresDatabaseSchema = BaseDatabaseSchema.extend({
+  type: z.literal("postgres"),
+  url: EnvExpandedString().optional().describe("PostgreSQL connection URL (postgresql://...)"),
+  connectionString: EnvExpandedString().optional().describe("PostgreSQL connection string"),
+  host: z.string().optional().describe("PostgreSQL host"),
+  port: z.number().int().positive().optional().describe("PostgreSQL port"),
+  database: z.string().optional().describe("PostgreSQL database name"),
+  password: z.string().optional().describe("PostgreSQL password"),
+  // TODO: keyPrefix is reserved for future use - allows namespacing keys when multiple
+  // agents or environments share the same database (e.g., "dev:agent1:" vs "prod:agent2:")
+  keyPrefix: z.string().optional().describe('Optional key prefix for namespacing (e.g., "dev:myagent:")')
+}).strict().superRefine((data, ctx) => {
+  if (!data.url && !data.connectionString && !data.host) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "PostgreSQL database requires one of 'url', 'connectionString', or 'host' to be specified",
+      path: ["url"],
+      params: {
+        code: StorageErrorCode.CONNECTION_CONFIG_MISSING,
+        scope: ErrorScope.STORAGE,
+        type: ErrorType.USER
+      }
+    });
+  }
+});
+const DatabaseConfigSchema = z.object({
+  type: z.string().describe("Database backend type identifier")
+}).passthrough().describe("Database configuration (validated by image factory)");
+export {
+  DATABASE_TYPES,
+  DatabaseConfigSchema,
+  InMemoryDatabaseSchema,
+  PostgresDatabaseSchema,
+  SqliteDatabaseSchema
+};

package/dist/database/sqlite-store.cjs

@@ -0,0 +1,270 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var sqlite_store_exports = {};
+__export(sqlite_store_exports, {
+  SQLiteStore: () => SQLiteStore
+});
+module.exports = __toCommonJS(sqlite_store_exports);
+var import_path = require("path");
+var import_fs = require("fs");
+var import_core = require("@dexto/core");
+let BetterSqlite3Database;
+class SQLiteStore {
+  db = null;
+  // Database.Database
+  dbPath;
+  config;
+  logger;
+  constructor(config, logger) {
+    this.config = config;
+    this.dbPath = "";
+    this.logger = logger.createChild(import_core.DextoLogComponent.STORAGE);
+  }
+  initializeTables() {
+    this.logger.debug("SQLite initializing database schema...");
+    try {
+      this.db.exec(`
+                CREATE TABLE IF NOT EXISTS kv_store (
+                    key TEXT PRIMARY KEY,
+                    value TEXT NOT NULL,
+                    created_at INTEGER DEFAULT (strftime('%s', 'now')),
+                    updated_at INTEGER DEFAULT (strftime('%s', 'now'))
+                )
+            `);
+      this.db.exec(`
+                CREATE TABLE IF NOT EXISTS list_store (
+                    key TEXT NOT NULL,
+                    value TEXT NOT NULL,
+                    sequence INTEGER,
+                    created_at INTEGER DEFAULT (strftime('%s', 'now')),
+                    PRIMARY KEY (key, sequence)
+                )
+            `);
+      this.db.exec(`
+                CREATE INDEX IF NOT EXISTS idx_kv_store_key ON kv_store(key);
+                CREATE INDEX IF NOT EXISTS idx_list_store_key ON list_store(key);
+                CREATE INDEX IF NOT EXISTS idx_list_store_sequence ON list_store(key, sequence);
+            `);
+      this.logger.debug(
+        "SQLite database schema initialized: kv_store, list_store tables with indexes"
+      );
+    } catch (error) {
+      throw import_core.StorageError.migrationFailed(
+        error instanceof Error ? error.message : String(error),
+        {
+          operation: "table_initialization",
+          backend: "sqlite"
+        }
+      );
+    }
+  }
+  async connect() {
+    if (this.db) return;
+    if (!BetterSqlite3Database) {
+      try {
+        const module2 = await import("better-sqlite3");
+        BetterSqlite3Database = module2.default || module2;
+      } catch (error) {
+        const err = error;
+        if (err.code === "ERR_MODULE_NOT_FOUND") {
+          throw import_core.StorageError.dependencyNotInstalled(
+            "SQLite",
+            "better-sqlite3",
+            "npm install better-sqlite3"
+          );
+        }
+        throw import_core.StorageError.connectionFailed(
+          `Failed to import better-sqlite3: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+    this.dbPath = this.config.path;
+    this.logger.info(`SQLite using database file: ${this.dbPath}`);
+    const dir = (0, import_path.dirname)(this.dbPath);
+    this.logger.debug(`SQLite ensuring directory exists: ${dir}`);
+    try {
+      (0, import_fs.mkdirSync)(dir, { recursive: true });
+    } catch (error) {
+      this.logger.debug(`Directory creation result: ${error ? "exists" : "created"}`);
+    }
+    const sqliteOptions = this.config.options || {};
+    this.logger.debug(`SQLite initializing database with config:`, {
+      readonly: sqliteOptions.readonly || false,
+      fileMustExist: sqliteOptions.fileMustExist || false,
+      timeout: sqliteOptions.timeout || 5e3
+    });
+    this.db = new BetterSqlite3Database(this.dbPath, {
+      readonly: sqliteOptions.readonly || false,
+      fileMustExist: sqliteOptions.fileMustExist || false,
+      timeout: sqliteOptions.timeout || 5e3,
+      verbose: sqliteOptions.verbose ? (message, ...additionalArgs) => {
+        const messageStr = typeof message === "string" ? message : typeof message === "object" && message !== null ? JSON.stringify(message) : String(message);
+        this.logger.debug(
+          messageStr,
+          additionalArgs.length > 0 ? { args: additionalArgs } : void 0
+        );
+      } : void 0
+    });
+    this.db.pragma("journal_mode = WAL");
+    this.logger.debug("SQLite enabled WAL mode for better concurrency");
+    this.initializeTables();
+    this.logger.info(`\u2705 SQLite store successfully connected to: ${this.dbPath}`);
+  }
+  async disconnect() {
+    if (this.db) {
+      this.db.close();
+      this.db = null;
+    }
+  }
+  isConnected() {
+    return this.db !== null;
+  }
+  getStoreType() {
+    return "sqlite";
+  }
+  // Core operations
+  async get(key) {
+    this.checkConnection();
+    try {
+      const row = this.db.prepare("SELECT value FROM kv_store WHERE key = ?").get(key);
+      return row ? JSON.parse(row.value) : void 0;
+    } catch (error) {
+      throw import_core.StorageError.readFailed(
+        "get",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
+    }
+  }
+  async set(key, value) {
+    this.checkConnection();
+    try {
+      const serialized = JSON.stringify(value);
+      this.db.prepare(
+        "INSERT OR REPLACE INTO kv_store (key, value, updated_at) VALUES (?, ?, ?)"
+      ).run(key, serialized, Date.now());
+    } catch (error) {
+      throw import_core.StorageError.writeFailed(
+        "set",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
+    }
+  }
+  async delete(key) {
+    this.checkConnection();
+    try {
+      this.db.prepare("DELETE FROM kv_store WHERE key = ?").run(key);
+      this.db.prepare("DELETE FROM list_store WHERE key = ?").run(key);
+    } catch (error) {
+      throw import_core.StorageError.deleteFailed(
+        "delete",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
+    }
+  }
+  // List operations
+  async list(prefix) {
+    this.checkConnection();
+    try {
+      const kvKeys = this.db.prepare("SELECT key FROM kv_store WHERE key LIKE ?").all(`${prefix}%`);
+      const listKeys = this.db.prepare("SELECT DISTINCT key FROM list_store WHERE key LIKE ?").all(`${prefix}%`);
+      const allKeys = /* @__PURE__ */ new Set([
+        ...kvKeys.map((row) => row.key),
+        ...listKeys.map((row) => row.key)
+      ]);
+      return Array.from(allKeys).sort();
+    } catch (error) {
+      throw import_core.StorageError.readFailed(
+        "list",
+        error instanceof Error ? error.message : String(error),
+        { prefix }
+      );
+    }
+  }
+  async append(key, item) {
+    this.checkConnection();
+    try {
+      const serialized = JSON.stringify(item);
+      this.db.prepare(
+        "INSERT INTO list_store (key, value, sequence) VALUES (?, ?, (SELECT COALESCE(MAX(sequence), 0) + 1 FROM list_store WHERE key = ?))"
+      ).run(key, serialized, key);
+    } catch (error) {
+      throw import_core.StorageError.writeFailed(
+        "append",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
+    }
+  }
+  async getRange(key, start, count) {
+    this.checkConnection();
+    try {
+      const rows = this.db.prepare(
+        "SELECT value FROM list_store WHERE key = ? ORDER BY sequence ASC LIMIT ? OFFSET ?"
+      ).all(key, count, start);
+      return rows.map((row) => JSON.parse(row.value));
+    } catch (error) {
+      throw import_core.StorageError.readFailed(
+        "getRange",
+        error instanceof Error ? error.message : String(error),
+        { key, start, count }
+      );
+    }
+  }
+  // Schema management
+  checkConnection() {
+    if (!this.db) {
+      throw import_core.StorageError.notConnected("SQLiteStore");
+    }
+  }
+  // Maintenance operations
+  async vacuum() {
+    this.checkConnection();
+    this.db.exec("VACUUM");
+  }
+  async getStats() {
+    this.checkConnection();
+    const kvCount = this.db.prepare("SELECT COUNT(*) as count FROM kv_store").get();
+    const listCount = this.db.prepare("SELECT COUNT(*) as count FROM list_store").get();
+    const dbSize = this.db.prepare(
+      "SELECT page_count * page_size as size FROM pragma_page_count(), pragma_page_size()"
+    ).get();
+    return {
+      kvCount: kvCount.count,
+      listCount: listCount.count,
+      dbSize: dbSize.size
+    };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SQLiteStore
+});

package/dist/database/sqlite-store.d.cts

@@ -0,0 +1,35 @@
+import { Database, Logger } from '@dexto/core';
+import { SqliteDatabaseConfig } from './schemas.cjs';
+import 'zod';
+
+/**
+ * SQLite database store for local development and production.
+ * Implements the Database interface with proper schema and connection handling.
+ */
+declare class SQLiteStore implements Database {
+    private db;
+    private dbPath;
+    private config;
+    private logger;
+    constructor(config: SqliteDatabaseConfig, logger: Logger);
+    private initializeTables;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getStoreType(): string;
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix: string): Promise<string[]>;
+    append<T>(key: string, item: T): Promise<void>;
+    getRange<T>(key: string, start: number, count: number): Promise<T[]>;
+    private checkConnection;
+    vacuum(): Promise<void>;
+    getStats(): Promise<{
+        kvCount: number;
+        listCount: number;
+        dbSize: number;
+    }>;
+}
+
+export { SQLiteStore };

package/dist/database/sqlite-store.d.ts

@@ -0,0 +1,33 @@
+import type { Database } from './types.js';
+import type { Logger } from '@dexto/core';
+import type { SqliteDatabaseConfig } from './schemas.js';
+/**
+ * SQLite database store for local development and production.
+ * Implements the Database interface with proper schema and connection handling.
+ */
+export declare class SQLiteStore implements Database {
+    private db;
+    private dbPath;
+    private config;
+    private logger;
+    constructor(config: SqliteDatabaseConfig, logger: Logger);
+    private initializeTables;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getStoreType(): string;
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix: string): Promise<string[]>;
+    append<T>(key: string, item: T): Promise<void>;
+    getRange<T>(key: string, start: number, count: number): Promise<T[]>;
+    private checkConnection;
+    vacuum(): Promise<void>;
+    getStats(): Promise<{
+        kvCount: number;
+        listCount: number;
+        dbSize: number;
+    }>;
+}
+//# sourceMappingURL=sqlite-store.d.ts.map

package/dist/database/sqlite-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../src/database/sqlite-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAKzD;;;GAGG;AACH,qBAAa,WAAY,YAAW,QAAQ;IACxC,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM;IAOxD,OAAO,CAAC,gBAAgB;IA8ClB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2ExB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,MAAM;IAKhB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAgB3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAelC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BvC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9C,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAqB1E,OAAO,CAAC,eAAe;IAOjB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvB,QAAQ,IAAI,OAAO,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;CAqBL"}

package/dist/database/sqlite-store.js

@@ -0,0 +1,236 @@
+import { dirname } from "path";
+import { mkdirSync } from "fs";
+import { DextoLogComponent, StorageError } from "@dexto/core";
+let BetterSqlite3Database;
+class SQLiteStore {
+  db = null;
+  // Database.Database
+  dbPath;
+  config;
+  logger;
+  constructor(config, logger) {
+    this.config = config;
+    this.dbPath = "";
+    this.logger = logger.createChild(DextoLogComponent.STORAGE);
+  }
+  initializeTables() {
+    this.logger.debug("SQLite initializing database schema...");
+    try {
+      this.db.exec(`
+                CREATE TABLE IF NOT EXISTS kv_store (
+                    key TEXT PRIMARY KEY,
+                    value TEXT NOT NULL,
+                    created_at INTEGER DEFAULT (strftime('%s', 'now')),
+                    updated_at INTEGER DEFAULT (strftime('%s', 'now'))
+                )
+            `);
+      this.db.exec(`
+                CREATE TABLE IF NOT EXISTS list_store (
+                    key TEXT NOT NULL,
+                    value TEXT NOT NULL,
+                    sequence INTEGER,
+                    created_at INTEGER DEFAULT (strftime('%s', 'now')),
+                    PRIMARY KEY (key, sequence)
+                )
+            `);
+      this.db.exec(`
+                CREATE INDEX IF NOT EXISTS idx_kv_store_key ON kv_store(key);
+                CREATE INDEX IF NOT EXISTS idx_list_store_key ON list_store(key);
+                CREATE INDEX IF NOT EXISTS idx_list_store_sequence ON list_store(key, sequence);
+            `);
+      this.logger.debug(
+        "SQLite database schema initialized: kv_store, list_store tables with indexes"
+      );
+    } catch (error) {
+      throw StorageError.migrationFailed(
+        error instanceof Error ? error.message : String(error),
+        {
+          operation: "table_initialization",
+          backend: "sqlite"
+        }
+      );
+    }
+  }
+  async connect() {
+    if (this.db) return;
+    if (!BetterSqlite3Database) {
+      try {
+        const module = await import("better-sqlite3");
+        BetterSqlite3Database = module.default || module;
+      } catch (error) {
+        const err = error;
+        if (err.code === "ERR_MODULE_NOT_FOUND") {
+          throw StorageError.dependencyNotInstalled(
+            "SQLite",
+            "better-sqlite3",
+            "npm install better-sqlite3"
+          );
+        }
+        throw StorageError.connectionFailed(
+          `Failed to import better-sqlite3: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+    this.dbPath = this.config.path;
+    this.logger.info(`SQLite using database file: ${this.dbPath}`);
+    const dir = dirname(this.dbPath);
+    this.logger.debug(`SQLite ensuring directory exists: ${dir}`);
+    try {
+      mkdirSync(dir, { recursive: true });
+    } catch (error) {
+      this.logger.debug(`Directory creation result: ${error ? "exists" : "created"}`);
+    }
+    const sqliteOptions = this.config.options || {};
+    this.logger.debug(`SQLite initializing database with config:`, {
+      readonly: sqliteOptions.readonly || false,
+      fileMustExist: sqliteOptions.fileMustExist || false,
+      timeout: sqliteOptions.timeout || 5e3
+    });
+    this.db = new BetterSqlite3Database(this.dbPath, {
+      readonly: sqliteOptions.readonly || false,
+      fileMustExist: sqliteOptions.fileMustExist || false,
+      timeout: sqliteOptions.timeout || 5e3,
+      verbose: sqliteOptions.verbose ? (message, ...additionalArgs) => {
+        const messageStr = typeof message === "string" ? message : typeof message === "object" && message !== null ? JSON.stringify(message) : String(message);
+        this.logger.debug(
+          messageStr,
+          additionalArgs.length > 0 ? { args: additionalArgs } : void 0
+        );
+      } : void 0
+    });
+    this.db.pragma("journal_mode = WAL");
+    this.logger.debug("SQLite enabled WAL mode for better concurrency");
+    this.initializeTables();
+    this.logger.info(`\u2705 SQLite store successfully connected to: ${this.dbPath}`);
+  }
+  async disconnect() {
+    if (this.db) {
+      this.db.close();
+      this.db = null;
+    }
+  }
+  isConnected() {
+    return this.db !== null;
+  }
+  getStoreType() {
+    return "sqlite";
+  }
+  // Core operations
+  async get(key) {
+    this.checkConnection();
+    try {
+      const row = this.db.prepare("SELECT value FROM kv_store WHERE key = ?").get(key);
+      return row ? JSON.parse(row.value) : void 0;
+    } catch (error) {
+      throw StorageError.readFailed(
+        "get",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
+    }
+  }
+  async set(key, value) {
+    this.checkConnection();
+    try {
+      const serialized = JSON.stringify(value);
+      this.db.prepare(
+        "INSERT OR REPLACE INTO kv_store (key, value, updated_at) VALUES (?, ?, ?)"
+      ).run(key, serialized, Date.now());
+    } catch (error) {
+      throw StorageError.writeFailed(
+        "set",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
+    }
+  }
+  async delete(key) {
+    this.checkConnection();
+    try {
+      this.db.prepare("DELETE FROM kv_store WHERE key = ?").run(key);
+      this.db.prepare("DELETE FROM list_store WHERE key = ?").run(key);
+    } catch (error) {
+      throw StorageError.deleteFailed(
+        "delete",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
+    }
+  }
+  // List operations
+  async list(prefix) {
+    this.checkConnection();
+    try {
+      const kvKeys = this.db.prepare("SELECT key FROM kv_store WHERE key LIKE ?").all(`${prefix}%`);
+      const listKeys = this.db.prepare("SELECT DISTINCT key FROM list_store WHERE key LIKE ?").all(`${prefix}%`);
+      const allKeys = /* @__PURE__ */ new Set([
+        ...kvKeys.map((row) => row.key),
+        ...listKeys.map((row) => row.key)
+      ]);
+      return Array.from(allKeys).sort();
+    } catch (error) {
+      throw StorageError.readFailed(
+        "list",
+        error instanceof Error ? error.message : String(error),
+        { prefix }
+      );
+    }
+  }
+  async append(key, item) {
+    this.checkConnection();
+    try {
+      const serialized = JSON.stringify(item);
+      this.db.prepare(
+        "INSERT INTO list_store (key, value, sequence) VALUES (?, ?, (SELECT COALESCE(MAX(sequence), 0) + 1 FROM list_store WHERE key = ?))"
+      ).run(key, serialized, key);
+    } catch (error) {
+      throw StorageError.writeFailed(
+        "append",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
+    }
+  }
+  async getRange(key, start, count) {
+    this.checkConnection();
+    try {
+      const rows = this.db.prepare(
+        "SELECT value FROM list_store WHERE key = ? ORDER BY sequence ASC LIMIT ? OFFSET ?"
+      ).all(key, count, start);
+      return rows.map((row) => JSON.parse(row.value));
+    } catch (error) {
+      throw StorageError.readFailed(
+        "getRange",
+        error instanceof Error ? error.message : String(error),
+        { key, start, count }
+      );
+    }
+  }
+  // Schema management
+  checkConnection() {
+    if (!this.db) {
+      throw StorageError.notConnected("SQLiteStore");
+    }
+  }
+  // Maintenance operations
+  async vacuum() {
+    this.checkConnection();
+    this.db.exec("VACUUM");
+  }
+  async getStats() {
+    this.checkConnection();
+    const kvCount = this.db.prepare("SELECT COUNT(*) as count FROM kv_store").get();
+    const listCount = this.db.prepare("SELECT COUNT(*) as count FROM list_store").get();
+    const dbSize = this.db.prepare(
+      "SELECT page_count * page_size as size FROM pragma_page_count(), pragma_page_size()"
+    ).get();
+    return {
+      kvCount: kvCount.count,
+      listCount: listCount.count,
+      dbSize: dbSize.size
+    };
+  }
+}
+export {
+  SQLiteStore
+};

package/dist/database/types.cjs

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/database/types.d.cts

@@ -0,0 +1 @@
+export { Database } from '@dexto/core';

package/dist/database/types.d.ts

@@ -0,0 +1,2 @@
+export type { Database } from '@dexto/core';
+//# sourceMappingURL=types.d.ts.map

package/dist/database/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/database/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}