@dexto/core 1.4.0 → 1.5.1

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");
@@ -50,7 +53,10 @@ const PostgresDatabaseSchema = BaseDatabaseSchema.extend({
   host: import_zod.z.string().optional().describe("PostgreSQL host"),
   port: import_zod.z.number().int().positive().optional().describe("PostgreSQL port"),
   database: import_zod.z.string().optional().describe("PostgreSQL database name"),
-  password: import_zod.z.string().optional().describe("PostgreSQL password")
+  password: import_zod.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: import_zod.z.string().optional().describe('Optional key prefix for namespacing (e.g., "dev:myagent:")')
 }).strict();
 const DatabaseConfigSchema = import_zod.z.discriminatedUnion(
   "type",
@@ -84,5 +90,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
 });

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

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export declare const DATABASE_TYPES: readonly ["in-memory", "sqlite", "postgres"];
 export type DatabaseType = (typeof DATABASE_TYPES)[number];
-declare const InMemoryDatabaseSchema: z.ZodObject<{
+export declare const InMemoryDatabaseSchema: z.ZodObject<{
     maxConnections: z.ZodOptional<z.ZodNumber>;
     idleTimeoutMillis: z.ZodOptional<z.ZodNumber>;
     connectionTimeoutMillis: z.ZodOptional<z.ZodNumber>;
@@ -22,7 +22,7 @@ declare const InMemoryDatabaseSchema: z.ZodObject<{
     connectionTimeoutMillis?: number | undefined;
 }>;
 export type InMemoryDatabaseConfig = z.output<typeof InMemoryDatabaseSchema>;
-declare const SqliteDatabaseSchema: z.ZodObject<{
+export declare const SqliteDatabaseSchema: z.ZodObject<{
     maxConnections: z.ZodOptional<z.ZodNumber>;
     idleTimeoutMillis: z.ZodOptional<z.ZodNumber>;
     connectionTimeoutMillis: z.ZodOptional<z.ZodNumber>;
@@ -46,7 +46,7 @@ declare const SqliteDatabaseSchema: z.ZodObject<{
     connectionTimeoutMillis?: number | undefined;
 }>;
 export type SqliteDatabaseConfig = z.output<typeof SqliteDatabaseSchema>;
-declare const PostgresDatabaseSchema: z.ZodObject<{
+export declare const PostgresDatabaseSchema: z.ZodObject<{
     maxConnections: z.ZodOptional<z.ZodNumber>;
     idleTimeoutMillis: z.ZodOptional<z.ZodNumber>;
     connectionTimeoutMillis: z.ZodOptional<z.ZodNumber>;
@@ -59,6 +59,7 @@ declare const PostgresDatabaseSchema: z.ZodObject<{
     port: z.ZodOptional<z.ZodNumber>;
     database: z.ZodOptional<z.ZodString>;
     password: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     type: "postgres";
     password?: string | undefined;
@@ -71,6 +72,7 @@ declare const PostgresDatabaseSchema: z.ZodObject<{
     port?: number | undefined;
     database?: string | undefined;
     connectionString?: string | undefined;
+    keyPrefix?: string | undefined;
 }, {
     type: "postgres";
     password?: string | undefined;
@@ -83,6 +85,7 @@ declare const PostgresDatabaseSchema: z.ZodObject<{
     port?: number | undefined;
     database?: string | undefined;
     connectionString?: string | undefined;
+    keyPrefix?: string | undefined;
 }>;
 export type PostgresDatabaseConfig = z.output<typeof PostgresDatabaseSchema>;
 export declare const DatabaseConfigSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
@@ -139,6 +142,7 @@ export declare const DatabaseConfigSchema: z.ZodEffects<z.ZodDiscriminatedUnion<
     port: z.ZodOptional<z.ZodNumber>;
     database: z.ZodOptional<z.ZodString>;
     password: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     type: "postgres";
     password?: string | undefined;
@@ -151,6 +155,7 @@ export declare const DatabaseConfigSchema: z.ZodEffects<z.ZodDiscriminatedUnion<
     port?: number | undefined;
     database?: string | undefined;
     connectionString?: string | undefined;
+    keyPrefix?: string | undefined;
 }, {
     type: "postgres";
     password?: string | undefined;
@@ -163,6 +168,7 @@ export declare const DatabaseConfigSchema: z.ZodEffects<z.ZodDiscriminatedUnion<
     port?: number | undefined;
     database?: string | undefined;
     connectionString?: string | undefined;
+    keyPrefix?: string | undefined;
 }>]>, {
     type: "in-memory";
     options?: Record<string, any> | undefined;
@@ -188,6 +194,7 @@ export declare const DatabaseConfigSchema: z.ZodEffects<z.ZodDiscriminatedUnion<
     port?: number | undefined;
     database?: string | undefined;
     connectionString?: string | undefined;
+    keyPrefix?: string | undefined;
 }, {
     type: "in-memory";
     options?: Record<string, any> | undefined;
@@ -213,7 +220,7 @@ export declare const DatabaseConfigSchema: z.ZodEffects<z.ZodDiscriminatedUnion<
     port?: number | undefined;
     database?: string | undefined;
     connectionString?: string | undefined;
+    keyPrefix?: string | undefined;
 }>;
 export type DatabaseConfig = z.output<typeof DatabaseConfigSchema>;
-export {};
 //# sourceMappingURL=schemas.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/storage/database/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,cAAc,8CAA+C,CAAC;AAC3E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAoB3D,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;EAGjB,CAAC;AAEZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAG7E,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;EAOf,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGzE,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQjB,CAAC;AAEZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAG7E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiC3B,CAAC;AAEP,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/storage/database/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,cAAc,8CAA+C,CAAC;AAC3E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAoB3D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;EAGxB,CAAC;AAEZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAG7E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;EAOtB,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGzE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcxB,CAAC;AAEZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAG7E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiC3B,CAAC;AAEP,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/storage/database/schemas.js

@@ -27,7 +27,10 @@ const PostgresDatabaseSchema = BaseDatabaseSchema.extend({
   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")
+  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();
 const DatabaseConfigSchema = z.discriminatedUnion(
   "type",
@@ -60,5 +63,8 @@ const DatabaseConfigSchema = z.discriminatedUnion(
 });
 export {
   DATABASE_TYPES,
-  DatabaseConfigSchema
+  DatabaseConfigSchema,
+  InMemoryDatabaseSchema,
+  PostgresDatabaseSchema,
+  SqliteDatabaseSchema
 };

package/dist/storage/error-codes.cjs

@@ -45,6 +45,12 @@ var StorageErrorCode = /* @__PURE__ */ ((StorageErrorCode2) => {
   StorageErrorCode2["BLOB_BACKEND_UNAVAILABLE"] = "BLOB_BACKEND_UNAVAILABLE";
   StorageErrorCode2["BLOB_CLEANUP_FAILED"] = "BLOB_CLEANUP_FAILED";
   StorageErrorCode2["BLOB_OPERATION_FAILED"] = "BLOB_OPERATION_FAILED";
+  StorageErrorCode2["BLOB_PROVIDER_UNKNOWN"] = "BLOB_PROVIDER_UNKNOWN";
+  StorageErrorCode2["BLOB_PROVIDER_ALREADY_REGISTERED"] = "BLOB_PROVIDER_ALREADY_REGISTERED";
+  StorageErrorCode2["DATABASE_PROVIDER_UNKNOWN"] = "DATABASE_PROVIDER_UNKNOWN";
+  StorageErrorCode2["DATABASE_PROVIDER_ALREADY_REGISTERED"] = "DATABASE_PROVIDER_ALREADY_REGISTERED";
+  StorageErrorCode2["CACHE_PROVIDER_UNKNOWN"] = "CACHE_PROVIDER_UNKNOWN";
+  StorageErrorCode2["CACHE_PROVIDER_ALREADY_REGISTERED"] = "CACHE_PROVIDER_ALREADY_REGISTERED";
   return StorageErrorCode2;
 })(StorageErrorCode || {});
 // Annotate the CommonJS export names for ESM import in node:

package/dist/storage/error-codes.d.ts

@@ -25,6 +25,12 @@ export declare enum StorageErrorCode {
     BLOB_BACKEND_NOT_CONNECTED = "BLOB_BACKEND_NOT_CONNECTED",
     BLOB_BACKEND_UNAVAILABLE = "BLOB_BACKEND_UNAVAILABLE",
     BLOB_CLEANUP_FAILED = "BLOB_CLEANUP_FAILED",
-    BLOB_OPERATION_FAILED = "BLOB_OPERATION_FAILED"
+    BLOB_OPERATION_FAILED = "BLOB_OPERATION_FAILED",
+    BLOB_PROVIDER_UNKNOWN = "BLOB_PROVIDER_UNKNOWN",
+    BLOB_PROVIDER_ALREADY_REGISTERED = "BLOB_PROVIDER_ALREADY_REGISTERED",
+    DATABASE_PROVIDER_UNKNOWN = "DATABASE_PROVIDER_UNKNOWN",
+    DATABASE_PROVIDER_ALREADY_REGISTERED = "DATABASE_PROVIDER_ALREADY_REGISTERED",
+    CACHE_PROVIDER_UNKNOWN = "CACHE_PROVIDER_UNKNOWN",
+    CACHE_PROVIDER_ALREADY_REGISTERED = "CACHE_PROVIDER_ALREADY_REGISTERED"
 }
 //# sourceMappingURL=error-codes.d.ts.map

package/dist/storage/error-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/storage/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,gBAAgB;IAExB,uBAAuB,oCAAoC;IAC3D,qBAAqB,kCAAkC;IAGvD,wBAAwB,qCAAqC;IAG7D,iBAAiB,8BAA8B;IAC/C,yBAAyB,sCAAsC;IAG/D,WAAW,wBAAwB;IACnC,YAAY,yBAAyB;IACrC,aAAa,0BAA0B;IAGvC,gBAAgB,6BAA6B;IAC7C,uBAAuB,oCAAoC;IAG3D,mBAAmB,wBAAwB;IAG3C,kBAAkB,uBAAuB;IACzC,wBAAwB,6BAA6B;IACrD,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAG3C,cAAc,mBAAmB;IACjC,sBAAsB,2BAA2B;IACjD,kBAAkB,uBAAuB;IACzC,cAAc,mBAAmB;IAGjC,0BAA0B,+BAA+B;IACzD,wBAAwB,6BAA6B;IAGrD,mBAAmB,wBAAwB;IAC3C,qBAAqB,0BAA0B;CAClD"}
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/storage/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,gBAAgB;IAExB,uBAAuB,oCAAoC;IAC3D,qBAAqB,kCAAkC;IAGvD,wBAAwB,qCAAqC;IAG7D,iBAAiB,8BAA8B;IAC/C,yBAAyB,sCAAsC;IAG/D,WAAW,wBAAwB;IACnC,YAAY,yBAAyB;IACrC,aAAa,0BAA0B;IAGvC,gBAAgB,6BAA6B;IAC7C,uBAAuB,oCAAoC;IAG3D,mBAAmB,wBAAwB;IAG3C,kBAAkB,uBAAuB;IACzC,wBAAwB,6BAA6B;IACrD,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAG3C,cAAc,mBAAmB;IACjC,sBAAsB,2BAA2B;IACjD,kBAAkB,uBAAuB;IACzC,cAAc,mBAAmB;IAGjC,0BAA0B,+BAA+B;IACzD,wBAAwB,6BAA6B;IAGrD,mBAAmB,wBAAwB;IAC3C,qBAAqB,0BAA0B;IAG/C,qBAAqB,0BAA0B;IAC/C,gCAAgC,qCAAqC;IAGrE,yBAAyB,8BAA8B;IACvD,oCAAoC,yCAAyC;IAG7E,sBAAsB,2BAA2B;IACjD,iCAAiC,sCAAsC;CAC1E"}

package/dist/storage/error-codes.js

@@ -23,6 +23,12 @@ var StorageErrorCode = /* @__PURE__ */ ((StorageErrorCode2) => {
   StorageErrorCode2["BLOB_BACKEND_UNAVAILABLE"] = "BLOB_BACKEND_UNAVAILABLE";
   StorageErrorCode2["BLOB_CLEANUP_FAILED"] = "BLOB_CLEANUP_FAILED";
   StorageErrorCode2["BLOB_OPERATION_FAILED"] = "BLOB_OPERATION_FAILED";
+  StorageErrorCode2["BLOB_PROVIDER_UNKNOWN"] = "BLOB_PROVIDER_UNKNOWN";
+  StorageErrorCode2["BLOB_PROVIDER_ALREADY_REGISTERED"] = "BLOB_PROVIDER_ALREADY_REGISTERED";
+  StorageErrorCode2["DATABASE_PROVIDER_UNKNOWN"] = "DATABASE_PROVIDER_UNKNOWN";
+  StorageErrorCode2["DATABASE_PROVIDER_ALREADY_REGISTERED"] = "DATABASE_PROVIDER_ALREADY_REGISTERED";
+  StorageErrorCode2["CACHE_PROVIDER_UNKNOWN"] = "CACHE_PROVIDER_UNKNOWN";
+  StorageErrorCode2["CACHE_PROVIDER_ALREADY_REGISTERED"] = "CACHE_PROVIDER_ALREADY_REGISTERED";
   return StorageErrorCode2;
 })(StorageErrorCode || {});
 export {

package/dist/storage/errors.cjs

@@ -317,6 +317,86 @@ class StorageError {
       }
     );
   }
+  /**
+   * Unknown blob provider type
+   */
+  static unknownBlobProvider(type, availableTypes) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.StorageErrorCode.BLOB_PROVIDER_UNKNOWN,
+      import_types.ErrorScope.STORAGE,
+      import_types.ErrorType.USER,
+      `Unknown blob store type: '${type}'`,
+      { type, availableTypes },
+      `Available types: ${availableTypes.length > 0 ? availableTypes.join(", ") : "none"}`
+    );
+  }
+  /**
+   * Blob provider already registered
+   */
+  static blobProviderAlreadyRegistered(type) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.StorageErrorCode.BLOB_PROVIDER_ALREADY_REGISTERED,
+      import_types.ErrorScope.STORAGE,
+      import_types.ErrorType.USER,
+      `Blob store provider '${type}' is already registered`,
+      { type },
+      `Use unregister() first if you need to replace it`
+    );
+  }
+  // ==================== Database Provider Registry Errors ====================
+  /**
+   * Unknown database provider type
+   */
+  static unknownDatabaseProvider(type, availableTypes) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.StorageErrorCode.DATABASE_PROVIDER_UNKNOWN,
+      import_types.ErrorScope.STORAGE,
+      import_types.ErrorType.USER,
+      `Unknown database type: '${type}'`,
+      { type, availableTypes },
+      `Available types: ${availableTypes.length > 0 ? availableTypes.join(", ") : "none"}`
+    );
+  }
+  /**
+   * Database provider already registered
+   */
+  static databaseProviderAlreadyRegistered(type) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.StorageErrorCode.DATABASE_PROVIDER_ALREADY_REGISTERED,
+      import_types.ErrorScope.STORAGE,
+      import_types.ErrorType.USER,
+      `Database provider '${type}' is already registered`,
+      { type },
+      `Use unregister() first if you need to replace it`
+    );
+  }
+  // ==================== Cache Provider Registry Errors ====================
+  /**
+   * Unknown cache provider type
+   */
+  static unknownCacheProvider(type, availableTypes) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.StorageErrorCode.CACHE_PROVIDER_UNKNOWN,
+      import_types.ErrorScope.STORAGE,
+      import_types.ErrorType.USER,
+      `Unknown cache type: '${type}'`,
+      { type, availableTypes },
+      `Available types: ${availableTypes.length > 0 ? availableTypes.join(", ") : "none"}`
+    );
+  }
+  /**
+   * Cache provider already registered
+   */
+  static cacheProviderAlreadyRegistered(type) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.StorageErrorCode.CACHE_PROVIDER_ALREADY_REGISTERED,
+      import_types.ErrorScope.STORAGE,
+      import_types.ErrorType.USER,
+      `Cache provider '${type}' is already registered`,
+      { type },
+      `Use unregister() first if you need to replace it`
+    );
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/storage/errors.d.ts

@@ -124,5 +124,29 @@ export declare class StorageError {
      * Blob operation failed
      */
     static blobOperationFailed(operation: string, backendType: string, error: unknown): DextoRuntimeError;
+    /**
+     * Unknown blob provider type
+     */
+    static unknownBlobProvider(type: string, availableTypes: string[]): DextoRuntimeError;
+    /**
+     * Blob provider already registered
+     */
+    static blobProviderAlreadyRegistered(type: string): DextoRuntimeError;
+    /**
+     * Unknown database provider type
+     */
+    static unknownDatabaseProvider(type: string, availableTypes: string[]): DextoRuntimeError;
+    /**
+     * Database provider already registered
+     */
+    static databaseProviderAlreadyRegistered(type: string): DextoRuntimeError;
+    /**
+     * Unknown cache provider type
+     */
+    static unknownCacheProvider(type: string, availableTypes: string[]): DextoRuntimeError;
+    /**
+     * Cache provider already registered
+     */
+    static cacheProviderAlreadyRegistered(type: string): DextoRuntimeError;
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/storage/errors.d.ts.map

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