@dexto/core 1.4.0 → 1.5.0

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/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
+};

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

@@ -0,0 +1,62 @@
+"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 postgres_exports = {};
+__export(postgres_exports, {
+  postgresDatabaseProvider: () => postgresDatabaseProvider
+});
+module.exports = __toCommonJS(postgres_exports);
+var import_schemas = require("../schemas.js");
+var import_errors = require("../../errors.js");
+const postgresDatabaseProvider = {
+  type: "postgres",
+  configSchema: import_schemas.PostgresDatabaseSchema,
+  create: async (config, logger) => {
+    try {
+      const module2 = await import("../postgres-store.js");
+      logger.info("Connecting to PostgreSQL database");
+      return new module2.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;
+    }
+  },
+  metadata: {
+    displayName: "PostgreSQL",
+    description: "Production PostgreSQL database with connection pooling",
+    requiresNetwork: true,
+    supportsListOperations: true
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  postgresDatabaseProvider
+});

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

@@ -0,0 +1,19 @@
+import type { DatabaseProvider } from '../provider.js';
+import type { PostgresDatabaseConfig } from '../schemas.js';
+/**
+ * Provider for PostgreSQL database storage.
+ *
+ * This provider stores data in a PostgreSQL database server using the pg package.
+ * It's ideal for production deployments requiring scalability and multi-machine access.
+ *
+ * Features:
+ * - Connection pooling for efficient resource usage
+ * - JSONB storage for flexible data types
+ * - Transaction support
+ * - Suitable for distributed deployments
+ *
+ * Note: pg is an optional dependency. Install it with:
+ * npm install pg
+ */
+export declare const postgresDatabaseProvider: DatabaseProvider<'postgres', PostgresDatabaseConfig>;
+//# sourceMappingURL=postgres.d.ts.map

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

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

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

@@ -0,0 +1,29 @@
+import "../../../chunk-PTJYTZNU.js";
+import { PostgresDatabaseSchema } from "../schemas.js";
+import { StorageError } from "../../errors.js";
+const postgresDatabaseProvider = {
+  type: "postgres",
+  configSchema: PostgresDatabaseSchema,
+  create: async (config, logger) => {
+    try {
+      const module = await import("../postgres-store.js");
+      logger.info("Connecting to PostgreSQL database");
+      return new module.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;
+    }
+  },
+  metadata: {
+    displayName: "PostgreSQL",
+    description: "Production PostgreSQL database with connection pooling",
+    requiresNetwork: true,
+    supportsListOperations: true
+  }
+};
+export {
+  postgresDatabaseProvider
+};

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

@@ -0,0 +1,66 @@
+"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_exports = {};
+__export(sqlite_exports, {
+  sqliteDatabaseProvider: () => sqliteDatabaseProvider
+});
+module.exports = __toCommonJS(sqlite_exports);
+var import_schemas = require("../schemas.js");
+var import_errors = require("../../errors.js");
+const sqliteDatabaseProvider = {
+  type: "sqlite",
+  configSchema: import_schemas.SqliteDatabaseSchema,
+  create: async (config, logger) => {
+    try {
+      const module2 = await import("../sqlite-store.js");
+      logger.info(`Creating SQLite database store: ${config.path}`);
+      return new module2.SQLiteStore(config, logger);
+    } catch (error) {
+      const err = error;
+      if (err.code === "ERR_MODULE_NOT_FOUND" && typeof err.message === "string" && err.message.includes("better-sqlite3")) {
+        throw import_errors.StorageError.dependencyNotInstalled(
+          "SQLite",
+          "better-sqlite3",
+          "npm install better-sqlite3"
+        );
+      }
+      throw error;
+    }
+  },
+  metadata: {
+    displayName: "SQLite",
+    description: "Local SQLite database for persistent storage",
+    requiresNetwork: false,
+    supportsListOperations: true
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  sqliteDatabaseProvider
+});

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

@@ -0,0 +1,20 @@
+import type { DatabaseProvider } from '../provider.js';
+import type { SqliteDatabaseConfig } from '../schemas.js';
+/**
+ * Provider for SQLite database storage.
+ *
+ * This provider stores data in a local SQLite database file using better-sqlite3.
+ * It's ideal for single-machine deployments and development scenarios where
+ * persistence is required without the overhead of a database server.
+ *
+ * Features:
+ * - Uses better-sqlite3 for synchronous, fast operations
+ * - WAL mode enabled for better concurrency
+ * - No external server required
+ * - Persistent storage survives restarts
+ *
+ * Note: better-sqlite3 is an optional dependency. Install it with:
+ * npm install better-sqlite3
+ */
+export declare const sqliteDatabaseProvider: DatabaseProvider<'sqlite', SqliteDatabaseConfig>;
+//# sourceMappingURL=sqlite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../../../src/storage/database/providers/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAI1D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,CA8BnF,CAAC"}

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

@@ -0,0 +1,33 @@
+import "../../../chunk-PTJYTZNU.js";
+import { SqliteDatabaseSchema } from "../schemas.js";
+import { StorageError } from "../../errors.js";
+const sqliteDatabaseProvider = {
+  type: "sqlite",
+  configSchema: SqliteDatabaseSchema,
+  create: async (config, logger) => {
+    try {
+      const module = await import("../sqlite-store.js");
+      logger.info(`Creating SQLite database store: ${config.path}`);
+      return new module.SQLiteStore(config, logger);
+    } catch (error) {
+      const err = error;
+      if (err.code === "ERR_MODULE_NOT_FOUND" && typeof err.message === "string" && err.message.includes("better-sqlite3")) {
+        throw StorageError.dependencyNotInstalled(
+          "SQLite",
+          "better-sqlite3",
+          "npm install better-sqlite3"
+        );
+      }
+      throw error;
+    }
+  },
+  metadata: {
+    displayName: "SQLite",
+    description: "Local SQLite database for persistent storage",
+    requiresNetwork: false,
+    supportsListOperations: true
+  }
+};
+export {
+  sqliteDatabaseProvider
+};

package/dist/storage/database/registry.cjs

@@ -0,0 +1,50 @@
+"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 registry_exports = {};
+__export(registry_exports, {
+  DatabaseRegistry: () => DatabaseRegistry,
+  databaseRegistry: () => databaseRegistry
+});
+module.exports = __toCommonJS(registry_exports);
+var import_errors = require("../errors.js");
+var import_base_registry = require("../../providers/base-registry.js");
+const databaseErrorFactory = {
+  alreadyRegistered: (type) => import_errors.StorageError.databaseProviderAlreadyRegistered(type),
+  notFound: (type, availableTypes) => import_errors.StorageError.unknownDatabaseProvider(type, availableTypes)
+};
+class DatabaseRegistry extends import_base_registry.BaseRegistry {
+  constructor() {
+    super(databaseErrorFactory);
+  }
+  /**
+   * Get all registered providers.
+   * Alias for getAll() for backward compatibility.
+   *
+   * @returns Array of providers
+   */
+  getProviders() {
+    return this.getAll();
+  }
+}
+const databaseRegistry = new DatabaseRegistry();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DatabaseRegistry,
+  databaseRegistry
+});

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

@@ -0,0 +1,42 @@
+import type { DatabaseProvider } from './provider.js';
+import { BaseRegistry } from '../../providers/base-registry.js';
+/**
+ * Registry for database providers.
+ *
+ * This registry manages available database implementations and provides
+ * runtime validation for configurations. Providers can be registered from
+ * both core (built-in) and application layers (custom).
+ *
+ * The registry follows a global singleton pattern to allow registration
+ * before configuration loading, while maintaining type safety through
+ * provider interfaces.
+ *
+ * Extends BaseRegistry for common registry functionality.
+ */
+export declare class DatabaseRegistry extends BaseRegistry<DatabaseProvider<any, any>> {
+    constructor();
+    /**
+     * Get all registered providers.
+     * Alias for getAll() for backward compatibility.
+     *
+     * @returns Array of providers
+     */
+    getProviders(): DatabaseProvider<any, any>[];
+}
+/**
+ * Global singleton registry for database providers.
+ *
+ * This registry is used by the createDatabase factory and can be extended
+ * with custom providers before configuration loading.
+ *
+ * Example usage in CLI/server layer:
+ * ```typescript
+ * import { databaseRegistry } from '@dexto/core';
+ * import { mongoProvider } from './storage/mongo-provider.js';
+ *
+ * // Register custom provider before loading config
+ * databaseRegistry.register(mongoProvider);
+ * ```
+ */
+export declare const databaseRegistry: DatabaseRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/storage/database/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,YAAY,EAA6B,MAAM,kCAAkC,CAAC;AAY3F;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;;IAK1E;;;;;OAKG;IACH,YAAY,IAAI,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE;CAG/C;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/dist/storage/database/registry.js

@@ -0,0 +1,26 @@
+import "../../chunk-PTJYTZNU.js";
+import { StorageError } from "../errors.js";
+import { BaseRegistry } from "../../providers/base-registry.js";
+const databaseErrorFactory = {
+  alreadyRegistered: (type) => StorageError.databaseProviderAlreadyRegistered(type),
+  notFound: (type, availableTypes) => StorageError.unknownDatabaseProvider(type, availableTypes)
+};
+class DatabaseRegistry extends BaseRegistry {
+  constructor() {
+    super(databaseErrorFactory);
+  }
+  /**
+   * Get all registered providers.
+   * Alias for getAll() for backward compatibility.
+   *
+   * @returns Array of providers
+   */
+  getProviders() {
+    return this.getAll();
+  }
+}
+const databaseRegistry = new DatabaseRegistry();
+export {
+  DatabaseRegistry,
+  databaseRegistry
+};

package/dist/storage/database/schemas.cjs

@@ -19,7 +19,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var schemas_exports = {};
 __export(schemas_exports, {
   DATABASE_TYPES: () => DATABASE_TYPES,
-  DatabaseConfigSchema: () => DatabaseConfigSchema
+  DatabaseConfigSchema: () => DatabaseConfigSchema,
+  InMemoryDatabaseSchema: () => InMemoryDatabaseSchema,
+  PostgresDatabaseSchema: () => PostgresDatabaseSchema,
+  SqliteDatabaseSchema: () => SqliteDatabaseSchema
 });
 module.exports = __toCommonJS(schemas_exports);
 var import_zod = require("zod");
@@ -84,5 +87,8 @@ const DatabaseConfigSchema = import_zod.z.discriminatedUnion(
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DATABASE_TYPES,
-  DatabaseConfigSchema
+  DatabaseConfigSchema,
+  InMemoryDatabaseSchema,
+  PostgresDatabaseSchema,
+  SqliteDatabaseSchema
 });