@dexto/core 1.3.0 → 1.5.0

package/dist/storage/database/factory.cjs

@@ -1,9 +1,7 @@
 "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)
@@ -17,59 +15,22 @@ var __copyProps = (to, from, except, desc) => {
   }
   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 factory_exports = {};
 __export(factory_exports, {
   createDatabase: () => createDatabase
 });
 module.exports = __toCommonJS(factory_exports);
-var import_memory_database_store = require("./memory-database-store.js");
-var import_errors = require("../errors.js");
-let SQLiteStore = null;
-let PostgresStore = null;
+var import_registry = require("./registry.js");
 async function createDatabase(config, logger) {
-  switch (config.type) {
-    case "postgres":
-      return createPostgresStore(config, logger);
-    case "sqlite":
-      return createSQLiteStore(config, logger);
-    case "in-memory":
-    default:
-      logger.info("Using in-memory database store");
-      return new import_memory_database_store.MemoryDatabaseStore();
+  const validatedConfig = import_registry.databaseRegistry.validateConfig(config);
+  const provider = import_registry.databaseRegistry.get(validatedConfig.type);
+  if (!provider) {
+    throw new Error(`Provider '${validatedConfig.type}' not found in registry`);
   }
-}
-async function createPostgresStore(config, logger) {
-  try {
-    if (!PostgresStore) {
-      const module2 = await import("./postgres-store.js");
-      PostgresStore = module2.PostgresStore;
-    }
-    logger.info("Connecting to PostgreSQL database");
-    return new PostgresStore(config, logger);
-  } catch (error) {
-    const err = error;
-    if (err.code === "ERR_MODULE_NOT_FOUND") {
-      throw import_errors.StorageError.dependencyNotInstalled("PostgreSQL", "pg", "npm install pg");
-    }
-    throw error;
-  }
-}
-async function createSQLiteStore(config, logger) {
-  if (!SQLiteStore) {
-    const module2 = await import("./sqlite-store.js");
-    SQLiteStore = module2.SQLiteStore;
-  }
-  logger.info(`Creating SQLite database store: ${config.path}`);
-  return new SQLiteStore(config, logger);
+  const providerName = provider.metadata?.displayName || validatedConfig.type;
+  logger.info(`Using ${providerName} database`);
+  return provider.create(validatedConfig, logger);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/storage/database/factory.d.ts

@@ -1,13 +1,39 @@
 import type { Database } from './types.js';
-import type { DatabaseConfig } from '../schemas.js';
 import type { IDextoLogger } from '../../logger/v2/types.js';
 /**
- * Create a database store based on configuration.
- * Handles lazy loading of optional dependencies.
- * Throws StorageError.dependencyNotInstalled if required package is missing.
- * Database paths are provided via CLI enrichment layer.
- * @param config Database configuration with explicit paths
- * @param logger Logger instance for logging
+ * Create a database based on configuration using the provider registry.
+ *
+ * This factory function:
+ * 1. Validates the configuration against the registered provider's schema
+ * 2. Looks up the provider in the registry
+ * 3. Calls the provider's create method to instantiate the database
+ *
+ * The configuration type is determined at runtime by the 'type' field,
+ * which must match a registered provider. Custom providers can be registered
+ * via databaseRegistry.register() before calling this function.
+ *
+ * Database paths are provided via CLI enrichment layer (for sqlite).
+ *
+ * @param config - Database configuration with a 'type' discriminator
+ * @param logger - Logger instance for the database
+ * @returns A Database implementation
+ * @throws Error if the provider type is not registered or validation fails
+ *
+ * @example
+ * ```typescript
+ * // Using built-in provider
+ * const db = await createDatabase({ type: 'sqlite', path: '/tmp/data.db' }, logger);
+ *
+ * // Using custom provider (registered beforehand)
+ * import { databaseRegistry } from '@dexto/core';
+ * import { mongoProvider } from './storage/mongo-provider.js';
+ *
+ * databaseRegistry.register(mongoProvider);
+ * const db = await createDatabase({ type: 'mongodb', uri: '...' }, logger);
+ * ```
  */
-export declare function createDatabase(config: DatabaseConfig, logger: IDextoLogger): Promise<Database>;
+export declare function createDatabase(config: {
+    type: string;
+    [key: string]: any;
+}, logger: IDextoLogger): Promise<Database>;
 //# sourceMappingURL=factory.d.ts.map

package/dist/storage/database/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/storage/database/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAgD,MAAM,eAAe,CAAC;AAElG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAgB7D;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,YAAY,GACrB,OAAO,CAAC,QAAQ,CAAC,CAanB"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/storage/database/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,cAAc,CAChC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EAC5C,MAAM,EAAE,YAAY,GACrB,OAAO,CAAC,QAAQ,CAAC,CAgBnB"}

package/dist/storage/database/factory.js

@@ -1,43 +1,14 @@
-import "../../chunk-C6A6W6XS.js";
-import { MemoryDatabaseStore } from "./memory-database-store.js";
-import { StorageError } from "../errors.js";
-let SQLiteStore = null;
-let PostgresStore = null;
+import "../../chunk-PTJYTZNU.js";
+import { databaseRegistry } from "./registry.js";
 async function createDatabase(config, logger) {
-  switch (config.type) {
-    case "postgres":
-      return createPostgresStore(config, logger);
-    case "sqlite":
-      return createSQLiteStore(config, logger);
-    case "in-memory":
-    default:
-      logger.info("Using in-memory database store");
-      return new MemoryDatabaseStore();
+  const validatedConfig = databaseRegistry.validateConfig(config);
+  const provider = databaseRegistry.get(validatedConfig.type);
+  if (!provider) {
+    throw new Error(`Provider '${validatedConfig.type}' not found in registry`);
   }
-}
-async function createPostgresStore(config, logger) {
-  try {
-    if (!PostgresStore) {
-      const module = await import("./postgres-store.js");
-      PostgresStore = module.PostgresStore;
-    }
-    logger.info("Connecting to PostgreSQL database");
-    return new PostgresStore(config, logger);
-  } catch (error) {
-    const err = error;
-    if (err.code === "ERR_MODULE_NOT_FOUND") {
-      throw StorageError.dependencyNotInstalled("PostgreSQL", "pg", "npm install pg");
-    }
-    throw error;
-  }
-}
-async function createSQLiteStore(config, logger) {
-  if (!SQLiteStore) {
-    const module = await import("./sqlite-store.js");
-    SQLiteStore = module.SQLiteStore;
-  }
-  logger.info(`Creating SQLite database store: ${config.path}`);
-  return new SQLiteStore(config, logger);
+  const providerName = provider.metadata?.displayName || validatedConfig.type;
+  logger.info(`Using ${providerName} database`);
+  return provider.create(validatedConfig, logger);
 }
 export {
   createDatabase

package/dist/storage/database/index.cjs

@@ -0,0 +1,58 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var database_exports = {};
+__export(database_exports, {
+  DATABASE_TYPES: () => import_schemas.DATABASE_TYPES,
+  DatabaseConfigSchema: () => import_schemas.DatabaseConfigSchema,
+  DatabaseRegistry: () => import_registry2.DatabaseRegistry,
+  InMemoryDatabaseSchema: () => import_schemas.InMemoryDatabaseSchema,
+  MemoryDatabaseStore: () => import_memory_database_store.MemoryDatabaseStore,
+  PostgresDatabaseSchema: () => import_schemas.PostgresDatabaseSchema,
+  SqliteDatabaseSchema: () => import_schemas.SqliteDatabaseSchema,
+  createDatabase: () => import_factory.createDatabase,
+  databaseRegistry: () => import_registry2.databaseRegistry
+});
+module.exports = __toCommonJS(database_exports);
+var import_registry = require("./registry.js");
+var import_providers = require("./providers/index.js");
+var import_factory = require("./factory.js");
+var import_registry2 = require("./registry.js");
+var import_schemas = require("./schemas.js");
+var import_memory_database_store = require("./memory-database-store.js");
+if (!import_registry.databaseRegistry.has("in-memory")) {
+  import_registry.databaseRegistry.register(import_providers.inMemoryDatabaseProvider);
+}
+if (!import_registry.databaseRegistry.has("sqlite")) {
+  import_registry.databaseRegistry.register(import_providers.sqliteDatabaseProvider);
+}
+if (!import_registry.databaseRegistry.has("postgres")) {
+  import_registry.databaseRegistry.register(import_providers.postgresDatabaseProvider);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DATABASE_TYPES,
+  DatabaseConfigSchema,
+  DatabaseRegistry,
+  InMemoryDatabaseSchema,
+  MemoryDatabaseStore,
+  PostgresDatabaseSchema,
+  SqliteDatabaseSchema,
+  createDatabase,
+  databaseRegistry
+});

package/dist/storage/database/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Database Module
+ *
+ * This module provides a flexible database system with support for
+ * multiple backends through a provider pattern.
+ *
+ * ## Built-in Providers
+ * - `in-memory`: Store data in RAM (for testing/development)
+ * - `sqlite`: Store data in a local SQLite file
+ * - `postgres`: Store data in PostgreSQL server
+ *
+ * ## Custom Providers
+ * Custom providers (e.g., MongoDB, DynamoDB) can be registered at the
+ * CLI/server layer before configuration loading.
+ *
+ * ## Usage
+ *
+ * ### Using built-in providers
+ * ```typescript
+ * import { createDatabase } from '@dexto/core';
+ *
+ * const db = await createDatabase({ type: 'sqlite', path: '/tmp/data.db' }, logger);
+ * ```
+ *
+ * ### Registering custom providers
+ * ```typescript
+ * import { databaseRegistry, type DatabaseProvider } from '@dexto/core';
+ *
+ * const mongoProvider: DatabaseProvider<'mongodb', MongoConfig> = {
+ *   type: 'mongodb',
+ *   configSchema: MongoConfigSchema,
+ *   create: (config, logger) => new MongoDatabase(config, logger),
+ * };
+ *
+ * databaseRegistry.register(mongoProvider);
+ * const db = await createDatabase({ type: 'mongodb', uri: '...' }, logger);
+ * ```
+ */
+export { createDatabase } from './factory.js';
+export { databaseRegistry, DatabaseRegistry } from './registry.js';
+export type { DatabaseProvider } from './provider.js';
+export type { Database } from './types.js';
+export { DATABASE_TYPES, DatabaseConfigSchema, InMemoryDatabaseSchema, SqliteDatabaseSchema, PostgresDatabaseSchema, type DatabaseType, type DatabaseConfig, type InMemoryDatabaseConfig, type SqliteDatabaseConfig, type PostgresDatabaseConfig, } from './schemas.js';
+export { MemoryDatabaseStore } from './memory-database-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/database/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAwBH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EACH,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC9B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/storage/database/index.js

@@ -0,0 +1,37 @@
+import "../../chunk-PTJYTZNU.js";
+import { databaseRegistry } from "./registry.js";
+import {
+  inMemoryDatabaseProvider,
+  sqliteDatabaseProvider,
+  postgresDatabaseProvider
+} from "./providers/index.js";
+if (!databaseRegistry.has("in-memory")) {
+  databaseRegistry.register(inMemoryDatabaseProvider);
+}
+if (!databaseRegistry.has("sqlite")) {
+  databaseRegistry.register(sqliteDatabaseProvider);
+}
+if (!databaseRegistry.has("postgres")) {
+  databaseRegistry.register(postgresDatabaseProvider);
+}
+import { createDatabase } from "./factory.js";
+import { databaseRegistry as databaseRegistry2, DatabaseRegistry } from "./registry.js";
+import {
+  DATABASE_TYPES,
+  DatabaseConfigSchema,
+  InMemoryDatabaseSchema,
+  SqliteDatabaseSchema,
+  PostgresDatabaseSchema
+} from "./schemas.js";
+import { MemoryDatabaseStore } from "./memory-database-store.js";
+export {
+  DATABASE_TYPES,
+  DatabaseConfigSchema,
+  DatabaseRegistry,
+  InMemoryDatabaseSchema,
+  MemoryDatabaseStore,
+  PostgresDatabaseSchema,
+  SqliteDatabaseSchema,
+  createDatabase,
+  databaseRegistry2 as databaseRegistry
+};

package/dist/storage/database/memory-database-store.js

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { StorageError } from "../errors.js";
 class MemoryDatabaseStore {
   data = /* @__PURE__ */ new Map();

package/dist/storage/database/postgres-store.cjs

@@ -88,6 +88,12 @@ class PostgresStore {
         "INSERT INTO kv (key, value, updated_at) VALUES ($1, $2, $3) ON CONFLICT (key) DO UPDATE SET value = $2, updated_at = $3",
         [key, value, /* @__PURE__ */ new Date()]
       );
+    } catch (error) {
+      throw import_errors.StorageError.writeFailed(
+        "set",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
     } finally {
       client.release();
     }
@@ -137,6 +143,12 @@ class PostgresStore {
         item,
         /* @__PURE__ */ new Date()
       ]);
+    } catch (error) {
+      throw import_errors.StorageError.writeFailed(
+        "append",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
     } finally {
       client.release();
     }

package/dist/storage/database/postgres-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postgres-store.d.ts","sourceRoot":"","sources":["../../../src/storage/database/postgres-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,UAAU,EAAE,MAAM,IAAI,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D;;;;GAIG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAMtC,OAAO,CAAC,MAAM;IALlB,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAe;gBAGjB,MAAM,EAAE,sBAAsB,EACtC,MAAM,EAAE,YAAY;IAKlB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,MAAM;IAKhB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAiB3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuBvC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9C,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;YAe5D,YAAY;IA4B1B,OAAO,CAAC,eAAe;IAOjB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgBxE,QAAQ,IAAI,OAAO,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;IAsBI,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAShC"}
+{"version":3,"file":"postgres-store.d.ts","sourceRoot":"","sources":["../../../src/storage/database/postgres-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,UAAU,EAAE,MAAM,IAAI,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D;;;;GAIG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAMtC,OAAO,CAAC,MAAM;IALlB,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAe;gBAGjB,MAAM,EAAE,sBAAsB,EACtC,MAAM,EAAE,YAAY;IAKlB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,MAAM;IAKhB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAiB3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuBvC,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;YAe5D,YAAY;IA4B1B,OAAO,CAAC,eAAe;IAOjB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgBxE,QAAQ,IAAI,OAAO,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;IAsBI,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAShC"}

package/dist/storage/database/postgres-store.js

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { Pool } from "pg";
 import { DextoLogComponent } from "../../logger/v2/types.js";
 import { StorageError } from "../errors.js";
@@ -66,6 +66,12 @@ class PostgresStore {
         "INSERT INTO kv (key, value, updated_at) VALUES ($1, $2, $3) ON CONFLICT (key) DO UPDATE SET value = $2, updated_at = $3",
         [key, value, /* @__PURE__ */ new Date()]
       );
+    } catch (error) {
+      throw StorageError.writeFailed(
+        "set",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
     } finally {
       client.release();
     }
@@ -115,6 +121,12 @@ class PostgresStore {
         item,
         /* @__PURE__ */ new Date()
       ]);
+    } catch (error) {
+      throw StorageError.writeFailed(
+        "append",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
     } finally {
       client.release();
     }

package/dist/storage/database/provider.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 provider_exports = {};
+module.exports = __toCommonJS(provider_exports);

package/dist/storage/database/provider.d.ts

@@ -0,0 +1,56 @@
+import type { z } from 'zod';
+import type { Database } from './types.js';
+import type { IDextoLogger } from '../../logger/v2/types.js';
+/**
+ * Provider interface for creating database instances.
+ *
+ * This interface uses TypeScript generics to enforce type safety:
+ * - TType: The literal type string (e.g., 'sqlite', 'postgres')
+ * - TConfig: The configuration type with discriminator { type: TType }
+ *
+ * This ensures that the provider type matches the config type discriminator,
+ * providing compile-time safety for provider implementations.
+ */
+export interface DatabaseProvider<TType extends string = string, TConfig extends {
+    type: TType;
+} = any> {
+    /**
+     * Unique identifier for this provider (e.g., 'sqlite', 'postgres', 'in-memory').
+     * Must match the 'type' field in the configuration.
+     */
+    type: TType;
+    /**
+     * Zod schema for validating provider-specific configuration.
+     * The schema must output TConfig type.
+     *
+     * Note: Uses z.ZodType with relaxed generics to allow input/output type variance.
+     * This is necessary because Zod schemas with `.optional().default()` have
+     * input types that include undefined, but output types that don't.
+     */
+    configSchema: z.ZodType<TConfig, any, any>;
+    /**
+     * Factory function to create a Database instance.
+     *
+     * Unlike blob store providers (which are sync), database providers may return
+     * a Promise to support lazy loading of optional dependencies (e.g., better-sqlite3, pg).
+     *
+     * @param config - Validated configuration specific to this provider
+     * @param logger - Logger instance for the database
+     * @returns A Database implementation (or Promise for async providers)
+     */
+    create(config: TConfig, logger: IDextoLogger): Database | Promise<Database>;
+    /**
+     * Optional metadata for documentation, UIs, and discovery.
+     */
+    metadata?: {
+        /** Human-readable name (e.g., "SQLite", "PostgreSQL") */
+        displayName: string;
+        /** Brief description of this storage backend */
+        description: string;
+        /** Whether this provider requires network connectivity */
+        requiresNetwork?: boolean;
+        /** Whether this provider supports list operations (append/getRange) */
+        supportsListOperations?: boolean;
+    };
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/storage/database/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/storage/database/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB,CAC7B,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,OAAO,SAAS;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GAAG,GAAG;IAErC;;;OAGG;IACH,IAAI,EAAE,KAAK,CAAC;IAEZ;;;;;;;OAOG;IACH,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAE3C;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE5E;;OAEG;IACH,QAAQ,CAAC,EAAE;QACP,yDAAyD;QACzD,WAAW,EAAE,MAAM,CAAC;QACpB,gDAAgD;QAChD,WAAW,EAAE,MAAM,CAAC;QACpB,0DAA0D;QAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,uEAAuE;QACvE,sBAAsB,CAAC,EAAE,OAAO,CAAC;KACpC,CAAC;CACL"}

package/dist/storage/database/providers/index.cjs

@@ -0,0 +1,34 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var providers_exports = {};
+__export(providers_exports, {
+  inMemoryDatabaseProvider: () => import_memory.inMemoryDatabaseProvider,
+  postgresDatabaseProvider: () => import_postgres.postgresDatabaseProvider,
+  sqliteDatabaseProvider: () => import_sqlite.sqliteDatabaseProvider
+});
+module.exports = __toCommonJS(providers_exports);
+var import_memory = require("./memory.js");
+var import_sqlite = require("./sqlite.js");
+var import_postgres = require("./postgres.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  inMemoryDatabaseProvider,
+  postgresDatabaseProvider,
+  sqliteDatabaseProvider
+});

package/dist/storage/database/providers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Built-in database providers.
+ *
+ * These providers are automatically registered when importing from @dexto/core.
+ */
+export { inMemoryDatabaseProvider } from './memory.js';
+export { sqliteDatabaseProvider } from './sqlite.js';
+export { postgresDatabaseProvider } from './postgres.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/database/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/database/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}

package/dist/storage/database/providers/index.js

@@ -0,0 +1,9 @@
+import "../../../chunk-PTJYTZNU.js";
+import { inMemoryDatabaseProvider } from "./memory.js";
+import { sqliteDatabaseProvider } from "./sqlite.js";
+import { postgresDatabaseProvider } from "./postgres.js";
+export {
+  inMemoryDatabaseProvider,
+  postgresDatabaseProvider,
+  sqliteDatabaseProvider
+};

package/dist/storage/database/providers/memory.cjs

@@ -0,0 +1,40 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var memory_exports = {};
+__export(memory_exports, {
+  inMemoryDatabaseProvider: () => inMemoryDatabaseProvider
+});
+module.exports = __toCommonJS(memory_exports);
+var import_schemas = require("../schemas.js");
+var import_memory_database_store = require("../memory-database-store.js");
+const inMemoryDatabaseProvider = {
+  type: "in-memory",
+  configSchema: import_schemas.InMemoryDatabaseSchema,
+  create: (_config, _logger) => new import_memory_database_store.MemoryDatabaseStore(),
+  metadata: {
+    displayName: "In-Memory",
+    description: "Store data in RAM (ephemeral, for testing and development)",
+    requiresNetwork: false,
+    supportsListOperations: true
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  inMemoryDatabaseProvider
+});

package/dist/storage/database/providers/memory.d.ts

@@ -0,0 +1,16 @@
+import type { DatabaseProvider } from '../provider.js';
+import type { InMemoryDatabaseConfig } from '../schemas.js';
+/**
+ * Provider for in-memory database storage.
+ *
+ * This provider stores data in RAM and is ideal for development,
+ * testing, and ephemeral use cases where persistence is not required.
+ *
+ * Features:
+ * - Zero external dependencies
+ * - Fast in-memory operations
+ * - No network required
+ * - Data is lost on restart
+ */
+export declare const inMemoryDatabaseProvider: DatabaseProvider<'in-memory', InMemoryDatabaseConfig>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/storage/database/providers/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/storage/database/providers/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAI5D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,EAAE,gBAAgB,CAAC,WAAW,EAAE,sBAAsB,CAU1F,CAAC"}

package/dist/storage/database/providers/memory.js

@@ -0,0 +1,17 @@
+import "../../../chunk-PTJYTZNU.js";
+import { InMemoryDatabaseSchema } from "../schemas.js";
+import { MemoryDatabaseStore } from "../memory-database-store.js";
+const inMemoryDatabaseProvider = {
+  type: "in-memory",
+  configSchema: InMemoryDatabaseSchema,
+  create: (_config, _logger) => new MemoryDatabaseStore(),
+  metadata: {
+    displayName: "In-Memory",
+    description: "Store data in RAM (ephemeral, for testing and development)",
+    requiresNetwork: false,
+    supportsListOperations: true
+  }
+};
+export {
+  inMemoryDatabaseProvider
+};