keyv-registry 0.3.1 → 0.4.0

package/README.md

@@ -77,6 +77,25 @@ const store = await createStore('redis://localhost:6379?keyPrefix=myapp&ttl=3600
 const file = await createStore('file://~/data.json?writeDelay=100&pretty=true');
 ```
 
+### Connection String Handling
+
+Connection strings are passed to adapters via protocol-specific mappings. Different adapters expect connection information in different formats:
+
+**Direct URL passing** (adapter instantiated with URI string):
+- `redis://`, `rediss://` - Redis
+- `memcache://` - Memcached
+
+**URI option mapping** (wrapped in `{ uri }` object):
+- `postgresql://`, `postgres://` - PostgreSQL
+- `mysql://` - MySQL/MariaDB
+- `sqlite://` - SQLite
+
+**URL option mapping** (wrapped in `{ url }` object):
+- `mongodb://`, `mongodb+srv://` - MongoDB
+- `etcd://` - etcd
+
+Query parameters are always passed through and can be used for adapter-specific configuration. User options override both query parameters and protocol mappings.
+
 ### Custom Adapters
 
 Register custom protocols or override defaults:
@@ -119,15 +138,15 @@ const store = await createStore('redis://ignored', { store: customRedis });
 
 ### Official @keyv Adapters
 
-| Protocol | Package | Notes |
-|----------|---------|-------|
-| `redis://`, `rediss://` | `@keyv/redis` | Redis, supports TLS |
-| `postgresql://`, `postgres://` | `@keyv/postgres` | PostgreSQL |
-| `mysql://` | `@keyv/mysql` | MySQL/MariaDB |
-| `sqlite://` | `@keyv/sqlite` | SQLite |
-| `mongodb://`, `mongodb+srv://` | `@keyv/mongo` | MongoDB |
-| `memcache://` | `@keyv/memcache` | Memcached |
-| `etcd://` | `@keyv/etcd` | etcd |
+| Protocol | Package | Connection String Handling | Notes |
+|----------|---------|---------------------------|-------|
+| `redis://`, `rediss://` | `@keyv/redis` | Direct URL | Redis, supports TLS |
+| `postgresql://`, `postgres://` | `@keyv/postgres` | URI option | PostgreSQL |
+| `mysql://` | `@keyv/mysql` | URI option | MySQL/MariaDB |
+| `sqlite://` | `@keyv/sqlite` | URI option | SQLite |
+| `mongodb://`, `mongodb+srv://` | `@keyv/mongo` | URL option | MongoDB |
+| `memcache://` | `@keyv/memcache` | Direct URI | Memcached |
+| `etcd://` | `@keyv/etcd` | URL option | etcd |
 
 ### Third-party Adapters
 

package/dist/cjs/index.js

@@ -35,7 +35,7 @@ function createStore(uri, options, callback) {
     options = typeof options === 'function' ? {} : options || {};
     if (typeof callback === 'function') return (0, _workerts.default)(uri, options, callback);
     return new Promise(function(resolve, reject) {
-        (0, _workerts.default)(uri, options, function(err, store) {
+        return (0, _workerts.default)(uri, options, function(err, store) {
             return err ? reject(err) : resolve(store);
         });
     });

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/keyv/keyv-registry/src/index.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport type { CreateStoreCallback, CreateStoreOptions } from './types.ts';\nimport worker from './worker.ts';\n\nexport { clearAdapterCache } from './loadAdapter.ts';\nexport { getRegistry, registerAdapter } from './registry.ts';\nexport type { AdapterConfig, CreateStoreCallback, CreateStoreOptions } from './types.ts';\n\n/**\n * Create a Keyv store from a URI string\n *\n * Supports dual-boot API (callback or Promise):\n *\n * @example\n * // Promise API\n * const store = await createStore('redis://localhost:6379');\n * const file = await createStore('file://~/.cache/app/data.json');\n * const memory = await createStore('memory://');\n *\n * @example\n * // Callback API\n * createStore('redis://localhost:6379', (err, store) => {\n *   if (err) throw err;\n *   // use store\n * });\n *\n * @example\n * // With options\n * const store = await createStore('redis://localhost:6379', {\n *   namespace: 'myapp',\n *   ttl: 60000\n * });\n *\n * @example\n * // Pre-instantiated adapter passthrough\n * import KeyvRedis from '@keyv/redis';\n * const redis = new KeyvRedis('redis://localhost:6379');\n * const store = await createStore('redis://ignored', { store: redis });\n */\nexport default function createStore<T>(uri: string, callback: CreateStoreCallback<T>): void;\nexport default function createStore<T>(uri: string, options: CreateStoreOptions, callback: CreateStoreCallback<T>): void;\nexport default function createStore<T>(uri: string, options?: CreateStoreOptions): Promise<Keyv<T>>;\nexport default function createStore<T>(uri: string, options?: CreateStoreOptions | CreateStoreCallback<T>, callback?: CreateStoreCallback<T>): void | Promise<Keyv<T>> {\n  callback = typeof options === 'function' ? options : callback;\n  options = typeof options === 'function' ? {} : ((options || {}) as CreateStoreOptions);\n\n  if (typeof callback === 'function') return worker(uri, options, callback);\n  return new Promise((resolve, reject) => {\n    worker(uri, options, (err, store) => (err ? reject(err) : resolve(store as Keyv<T>)));\n  });\n}\n"],"names":["clearAdapterCache","createStore","getRegistry","registerAdapter","uri","options","callback","worker","Promise","resolve","reject","err","store"],"mappings":";;;;;;;;;;;QAISA;eAAAA,gCAAiB;;QAsC1B;eAAwBC;;QArCfC;eAAAA,uBAAW;;QAAEC;eAAAA,2BAAe;;;+DAHlB;6BAEe;0BACW;;;;;;AAqC9B,SAASF,YAAeG,GAAW,EAAEC,OAAqD,EAAEC,QAAiC;IAC1IA,WAAW,OAAOD,YAAY,aAAaA,UAAUC;IACrDD,UAAU,OAAOA,YAAY,aAAa,CAAC,IAAMA,WAAW,CAAC;IAE7D,IAAI,OAAOC,aAAa,YAAY,OAAOC,IAAAA,iBAAM,EAACH,KAAKC,SAASC;IAChE,OAAO,IAAIE,QAAQ,SAACC,SAASC;QAC3BH,IAAAA,iBAAM,EAACH,KAAKC,SAAS,SAACM,KAAKC;mBAAWD,MAAMD,OAAOC,OAAOF,QAAQG;;IACpE;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/keyv/keyv-registry/src/index.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport type { CreateStoreCallback, CreateStoreOptions } from './types.ts';\nimport worker from './worker.ts';\n\nexport { clearAdapterCache } from './loadAdapter.ts';\nexport { getRegistry, registerAdapter } from './registry.ts';\nexport type { AdapterConfig, CreateStoreCallback, CreateStoreOptions } from './types.ts';\n\n/**\n * Create a Keyv store from a URI string\n *\n * Supports dual-boot API (callback or Promise):\n *\n * @example\n * // Promise API\n * const store = await createStore('redis://localhost:6379');\n * const file = await createStore('file://~/.cache/app/data.json');\n * const memory = await createStore('memory://');\n *\n * @example\n * // Callback API\n * createStore('redis://localhost:6379', (err, store) => {\n *   if (err) throw err;\n *   // use store\n * });\n *\n * @example\n * // With options\n * const store = await createStore('redis://localhost:6379', {\n *   namespace: 'myapp',\n *   ttl: 60000\n * });\n *\n * @example\n * // Pre-instantiated adapter passthrough\n * import KeyvRedis from '@keyv/redis';\n * const redis = new KeyvRedis('redis://localhost:6379');\n * const store = await createStore('redis://ignored', { store: redis });\n */\nexport default function createStore<T>(uri: string, callback: CreateStoreCallback<T>): void;\nexport default function createStore<T>(uri: string, options: CreateStoreOptions, callback: CreateStoreCallback<T>): void;\nexport default function createStore<T>(uri: string, options?: CreateStoreOptions): Promise<Keyv<T>>;\nexport default function createStore<T>(uri: string, options?: CreateStoreOptions | CreateStoreCallback<T>, callback?: CreateStoreCallback<T>): void | Promise<Keyv<T>> {\n  callback = typeof options === 'function' ? options : callback;\n  options = typeof options === 'function' ? {} : ((options || {}) as CreateStoreOptions);\n\n  if (typeof callback === 'function') return worker(uri, options, callback);\n  return new Promise((resolve, reject) => worker(uri, options, (err, store) => (err ? reject(err) : resolve(store as Keyv<T>))));\n}\n"],"names":["clearAdapterCache","createStore","getRegistry","registerAdapter","uri","options","callback","worker","Promise","resolve","reject","err","store"],"mappings":";;;;;;;;;;;QAISA;eAAAA,gCAAiB;;QAsC1B;eAAwBC;;QArCfC;eAAAA,uBAAW;;QAAEC;eAAAA,2BAAe;;;+DAHlB;6BAEe;0BACW;;;;;;AAqC9B,SAASF,YAAeG,GAAW,EAAEC,OAAqD,EAAEC,QAAiC;IAC1IA,WAAW,OAAOD,YAAY,aAAaA,UAAUC;IACrDD,UAAU,OAAOA,YAAY,aAAa,CAAC,IAAMA,WAAW,CAAC;IAE7D,IAAI,OAAOC,aAAa,YAAY,OAAOC,IAAAA,iBAAM,EAACH,KAAKC,SAASC;IAChE,OAAO,IAAIE,QAAQ,SAACC,SAASC;eAAWH,IAAAA,iBAAM,EAACH,KAAKC,SAAS,SAACM,KAAKC;mBAAWD,MAAMD,OAAOC,OAAOF,QAAQG;;;AAC5G"}

package/dist/cjs/registry.js

@@ -53,34 +53,79 @@ function _object_spread(target) {
  */ var PROTOCOL_REGISTRY = {
     // Official @keyv adapters
     'redis:': {
-        package: '@keyv/redis'
+        package: '@keyv/redis',
+        mode: 'string'
     },
     'rediss:': {
-        package: '@keyv/redis'
+        package: '@keyv/redis',
+        mode: 'string'
     },
     'postgresql:': {
-        package: '@keyv/postgres'
+        package: '@keyv/postgres',
+        mode: 'options',
+        optionsMapper: function(url) {
+            return {
+                uri: url.toString()
+            };
+        }
     },
     'postgres:': {
-        package: '@keyv/postgres'
+        package: '@keyv/postgres',
+        mode: 'options',
+        optionsMapper: function(url) {
+            return {
+                uri: url.toString()
+            };
+        }
     },
     'mysql:': {
-        package: '@keyv/mysql'
+        package: '@keyv/mysql',
+        mode: 'options',
+        optionsMapper: function(url) {
+            return {
+                uri: url.toString()
+            };
+        }
     },
     'sqlite:': {
-        package: '@keyv/sqlite'
+        package: '@keyv/sqlite',
+        mode: 'options',
+        optionsMapper: function(url) {
+            return {
+                uri: url.toString()
+            };
+        }
     },
     'mongodb:': {
-        package: '@keyv/mongo'
+        package: '@keyv/mongo',
+        mode: 'options',
+        optionsMapper: function(url) {
+            return {
+                url: url.toString()
+            };
+        }
     },
     'mongodb+srv:': {
-        package: '@keyv/mongo'
+        package: '@keyv/mongo',
+        mode: 'options',
+        optionsMapper: function(url) {
+            return {
+                url: url.toString()
+            };
+        }
     },
     'memcache:': {
-        package: '@keyv/memcache'
+        package: '@keyv/memcache',
+        mode: 'string'
     },
     'etcd:': {
-        package: '@keyv/etcd'
+        package: '@keyv/etcd',
+        mode: 'options',
+        optionsMapper: function(url) {
+            return {
+                url: url.toString()
+            };
+        }
     },
     // Third-party adapters
     'file:': {

package/dist/cjs/registry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/keyv/keyv-registry/src/registry.ts"],"sourcesContent":["import type { AdapterConfig } from './types.ts';\nimport { resolveFilePath } from './utils.ts';\n\n/**\n * Protocol registry mapping URI protocols to adapter configurations\n */\nconst PROTOCOL_REGISTRY: Record<string, AdapterConfig> = {\n  // Official @keyv adapters\n  'redis:': { package: '@keyv/redis' },\n  'rediss:': { package: '@keyv/redis' },\n  'postgresql:': { package: '@keyv/postgres' },\n  'postgres:': { package: '@keyv/postgres' },\n  'mysql:': { package: '@keyv/mysql' },\n  'sqlite:': { package: '@keyv/sqlite' },\n  'mongodb:': { package: '@keyv/mongo' },\n  'mongodb+srv:': { package: '@keyv/mongo' },\n  'memcache:': { package: '@keyv/memcache' },\n  'etcd:': { package: '@keyv/etcd' },\n\n  // Third-party adapters\n  'file:': {\n    package: 'keyv-file',\n    exportName: 'KeyvFile',\n    optionsMapper: (url: URL) => ({ filename: resolveFilePath(url) }),\n  },\n\n  // Built-in (no package needed)\n  'memory:': { package: null },\n\n  // Future/custom adapters\n  'duckdb:': {\n    package: 'keyv-duckdb',\n    optionsMapper: (url: URL) => ({ filename: resolveFilePath(url) }),\n  },\n};\n\n/**\n * Register or override a protocol adapter\n */\nexport function registerAdapter(protocol: string, config: AdapterConfig): void {\n  const normalizedProtocol = protocol.endsWith(':') ? protocol : `${protocol}:`;\n  PROTOCOL_REGISTRY[normalizedProtocol] = config;\n}\n\n/**\n * Get the current registry (read-only copy)\n */\nexport function getRegistry(): Readonly<Record<string, AdapterConfig>> {\n  return { ...PROTOCOL_REGISTRY };\n}\n\n/**\n * Get adapter config for a protocol\n */\nexport function getAdapterConfig(protocol: string): AdapterConfig | undefined {\n  return PROTOCOL_REGISTRY[protocol];\n}\n"],"names":["getAdapterConfig","getRegistry","registerAdapter","PROTOCOL_REGISTRY","package","exportName","optionsMapper","url","filename","resolveFilePath","protocol","config","normalizedProtocol","endsWith"],"mappings":";;;;;;;;;;;QAsDgBA;eAAAA;;QAPAC;eAAAA;;QARAC;eAAAA;;;uBAtCgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEhC;;CAEC,GACD,IAAMC,oBAAmD;IACvD,0BAA0B;IAC1B,UAAU;QAAEC,SAAS;IAAc;IACnC,WAAW;QAAEA,SAAS;IAAc;IACpC,eAAe;QAAEA,SAAS;IAAiB;IAC3C,aAAa;QAAEA,SAAS;IAAiB;IACzC,UAAU;QAAEA,SAAS;IAAc;IACnC,WAAW;QAAEA,SAAS;IAAe;IACrC,YAAY;QAAEA,SAAS;IAAc;IACrC,gBAAgB;QAAEA,SAAS;IAAc;IACzC,aAAa;QAAEA,SAAS;IAAiB;IACzC,SAAS;QAAEA,SAAS;IAAa;IAEjC,uBAAuB;IACvB,SAAS;QACPA,SAAS;QACTC,YAAY;QACZC,eAAe,SAACC;mBAAc;gBAAEC,UAAUC,IAAAA,wBAAe,EAACF;YAAK;;IACjE;IAEA,+BAA+B;IAC/B,WAAW;QAAEH,SAAS;IAAK;IAE3B,yBAAyB;IACzB,WAAW;QACTA,SAAS;QACTE,eAAe,SAACC;mBAAc;gBAAEC,UAAUC,IAAAA,wBAAe,EAACF;YAAK;;IACjE;AACF;AAKO,SAASL,gBAAgBQ,QAAgB,EAAEC,MAAqB;IACrE,IAAMC,qBAAqBF,SAASG,QAAQ,CAAC,OAAOH,WAAW,AAAC,GAAW,OAATA,UAAS;IAC3EP,iBAAiB,CAACS,mBAAmB,GAAGD;AAC1C;AAKO,SAASV;IACd,OAAO,mBAAKE;AACd;AAKO,SAASH,iBAAiBU,QAAgB;IAC/C,OAAOP,iBAAiB,CAACO,SAAS;AACpC"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/keyv/keyv-registry/src/registry.ts"],"sourcesContent":["import type { AdapterConfig } from './types.ts';\nimport { resolveFilePath } from './utils.ts';\n\n/**\n * Protocol registry mapping URI protocols to adapter configurations\n */\nconst PROTOCOL_REGISTRY: Record<string, AdapterConfig> = {\n  // Official @keyv adapters\n  'redis:': { package: '@keyv/redis', mode: 'string' },\n  'rediss:': { package: '@keyv/redis', mode: 'string' },\n  'postgresql:': { package: '@keyv/postgres', mode: 'options', optionsMapper: (url) => ({ uri: url.toString() }) },\n  'postgres:': { package: '@keyv/postgres', mode: 'options', optionsMapper: (url) => ({ uri: url.toString() }) },\n  'mysql:': { package: '@keyv/mysql', mode: 'options', optionsMapper: (url) => ({ uri: url.toString() }) },\n  'sqlite:': { package: '@keyv/sqlite', mode: 'options', optionsMapper: (url) => ({ uri: url.toString() }) },\n  'mongodb:': { package: '@keyv/mongo', mode: 'options', optionsMapper: (url) => ({ url: url.toString() }) },\n  'mongodb+srv:': { package: '@keyv/mongo', mode: 'options', optionsMapper: (url) => ({ url: url.toString() }) },\n  'memcache:': { package: '@keyv/memcache', mode: 'string' },\n  'etcd:': { package: '@keyv/etcd', mode: 'options', optionsMapper: (url) => ({ url: url.toString() }) },\n\n  // Third-party adapters\n  'file:': {\n    package: 'keyv-file',\n    exportName: 'KeyvFile',\n    optionsMapper: (url: URL) => ({ filename: resolveFilePath(url) }),\n  },\n\n  // Built-in (no package needed)\n  'memory:': { package: null },\n\n  // Future/custom adapters\n  'duckdb:': {\n    package: 'keyv-duckdb',\n    optionsMapper: (url: URL) => ({ filename: resolveFilePath(url) }),\n  },\n};\n\n/**\n * Register or override a protocol adapter\n */\nexport function registerAdapter(protocol: string, config: AdapterConfig): void {\n  const normalizedProtocol = protocol.endsWith(':') ? protocol : `${protocol}:`;\n  PROTOCOL_REGISTRY[normalizedProtocol] = config;\n}\n\n/**\n * Get the current registry (read-only copy)\n */\nexport function getRegistry(): Readonly<Record<string, AdapterConfig>> {\n  return { ...PROTOCOL_REGISTRY };\n}\n\n/**\n * Get adapter config for a protocol\n */\nexport function getAdapterConfig(protocol: string): AdapterConfig | undefined {\n  return PROTOCOL_REGISTRY[protocol];\n}\n"],"names":["getAdapterConfig","getRegistry","registerAdapter","PROTOCOL_REGISTRY","package","mode","optionsMapper","url","uri","toString","exportName","filename","resolveFilePath","protocol","config","normalizedProtocol","endsWith"],"mappings":";;;;;;;;;;;QAsDgBA;eAAAA;;QAPAC;eAAAA;;QARAC;eAAAA;;;uBAtCgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEhC;;CAEC,GACD,IAAMC,oBAAmD;IACvD,0BAA0B;IAC1B,UAAU;QAAEC,SAAS;QAAeC,MAAM;IAAS;IACnD,WAAW;QAAED,SAAS;QAAeC,MAAM;IAAS;IACpD,eAAe;QAAED,SAAS;QAAkBC,MAAM;QAAWC,eAAe,SAACC;mBAAS;gBAAEC,KAAKD,IAAIE,QAAQ;YAAG;;IAAG;IAC/G,aAAa;QAAEL,SAAS;QAAkBC,MAAM;QAAWC,eAAe,SAACC;mBAAS;gBAAEC,KAAKD,IAAIE,QAAQ;YAAG;;IAAG;IAC7G,UAAU;QAAEL,SAAS;QAAeC,MAAM;QAAWC,eAAe,SAACC;mBAAS;gBAAEC,KAAKD,IAAIE,QAAQ;YAAG;;IAAG;IACvG,WAAW;QAAEL,SAAS;QAAgBC,MAAM;QAAWC,eAAe,SAACC;mBAAS;gBAAEC,KAAKD,IAAIE,QAAQ;YAAG;;IAAG;IACzG,YAAY;QAAEL,SAAS;QAAeC,MAAM;QAAWC,eAAe,SAACC;mBAAS;gBAAEA,KAAKA,IAAIE,QAAQ;YAAG;;IAAG;IACzG,gBAAgB;QAAEL,SAAS;QAAeC,MAAM;QAAWC,eAAe,SAACC;mBAAS;gBAAEA,KAAKA,IAAIE,QAAQ;YAAG;;IAAG;IAC7G,aAAa;QAAEL,SAAS;QAAkBC,MAAM;IAAS;IACzD,SAAS;QAAED,SAAS;QAAcC,MAAM;QAAWC,eAAe,SAACC;mBAAS;gBAAEA,KAAKA,IAAIE,QAAQ;YAAG;;IAAG;IAErG,uBAAuB;IACvB,SAAS;QACPL,SAAS;QACTM,YAAY;QACZJ,eAAe,SAACC;mBAAc;gBAAEI,UAAUC,IAAAA,wBAAe,EAACL;YAAK;;IACjE;IAEA,+BAA+B;IAC/B,WAAW;QAAEH,SAAS;IAAK;IAE3B,yBAAyB;IACzB,WAAW;QACTA,SAAS;QACTE,eAAe,SAACC;mBAAc;gBAAEI,UAAUC,IAAAA,wBAAe,EAACL;YAAK;;IACjE;AACF;AAKO,SAASL,gBAAgBW,QAAgB,EAAEC,MAAqB;IACrE,IAAMC,qBAAqBF,SAASG,QAAQ,CAAC,OAAOH,WAAW,AAAC,GAAW,OAATA,UAAS;IAC3EV,iBAAiB,CAACY,mBAAmB,GAAGD;AAC1C;AAKO,SAASb;IACd,OAAO,mBAAKE;AACd;AAKO,SAASH,iBAAiBa,QAAgB;IAC/C,OAAOV,iBAAiB,CAACU,SAAS;AACpC"}

package/dist/cjs/types.d.cts

@@ -7,6 +7,8 @@ export interface AdapterConfig {
     package: string | null;
     /** Named export from the package (default: 'default') */
     exportName?: string;
+    /** How to instantiate the adapter */
+    mode?: 'string' | 'options';
     /** Custom function to map URL to adapter options */
     optionsMapper?: (url: URL) => Record<string, unknown>;
 }

package/dist/cjs/types.d.ts

@@ -7,6 +7,8 @@ export interface AdapterConfig {
     package: string | null;
     /** Named export from the package (default: 'default') */
     exportName?: string;
+    /** How to instantiate the adapter */
+    mode?: 'string' | 'options';
     /** Custom function to map URL to adapter options */
     optionsMapper?: (url: URL) => Record<string, unknown>;
 }

package/dist/cjs/worker.js

@@ -124,18 +124,24 @@ function worker(uri, options, callback) {
             var _ref;
             var _config_optionsMapper;
             // Build adapter options: URI params + custom mapper + user options
-            var adapterOptions = _object_spread({}, (0, _utilsts.parseUriOptions)(url), (_ref = (_config_optionsMapper = config.optionsMapper) === null || _config_optionsMapper === void 0 ? void 0 : _config_optionsMapper.call(config, url)) !== null && _ref !== void 0 ? _ref : {
-                uri: uri
-            }, options);
+            var adapterOptions = _object_spread({}, (0, _utilsts.parseUriOptions)(url), (_ref = (_config_optionsMapper = config.optionsMapper) === null || _config_optionsMapper === void 0 ? void 0 : _config_optionsMapper.call(config, url)) !== null && _ref !== void 0 ? _ref : {}, options);
             // Remove store from adapter options to avoid confusion
             var _ = adapterOptions.store, cleanAdapterOptions = _object_without_properties(adapterOptions, [
                 "store"
             ]);
-            var storeInstance = new AdapterClass(cleanAdapterOptions);
-            var keyv = new _keyv.default(_object_spread({
-                store: storeInstance
+            if (config.mode === 'string') {
+                var storeInstance = new AdapterClass(uri, cleanAdapterOptions);
+                var keyv = new _keyv.default(_object_spread({
+                    store: storeInstance
+                }, options));
+                callback(null, keyv);
+                return;
+            }
+            var storeInstance1 = new AdapterClass(cleanAdapterOptions);
+            var keyv1 = new _keyv.default(_object_spread({
+                store: storeInstance1
             }, options));
-            callback(null, keyv);
+            callback(null, keyv1);
         } catch (createErr) {
             callback(createErr);
         }

package/dist/cjs/worker.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/keyv/keyv-registry/src/worker.ts"],"sourcesContent":["import Keyv from 'keyv';\nimport loadAdapter from './loadAdapter.ts';\nimport { getAdapterConfig } from './registry.ts';\nimport type { CreateStoreCallback, CreateStoreOptions } from './types.ts';\nimport { parseUriOptions } from './utils.ts';\n\n/**\n * Core worker function that creates a Keyv store\n */\nexport default function worker<T>(uri: string, options: CreateStoreOptions, callback: CreateStoreCallback<T>): void {\n  // Passthrough: pre-instantiated adapter provided\n  if (options.store) {\n    try {\n      const keyv = new Keyv<T>({ ...options });\n      callback(null, keyv);\n    } catch (err) {\n      callback(err as Error);\n    }\n    return;\n  }\n\n  // Parse URI\n  let url: URL;\n  try {\n    url = new URL(uri);\n  } catch (_err) {\n    callback(new Error(`Invalid URI: ${uri}`));\n    return;\n  }\n\n  const config = getAdapterConfig(url.protocol);\n\n  if (!config) {\n    callback(new Error(`Unknown protocol: ${url.protocol}. Use registerAdapter() to add support.`));\n    return;\n  }\n\n  // Memory store - no package needed\n  if (config.package === null) {\n    try {\n      const keyv = new Keyv<T>({ ...parseUriOptions(url), ...options });\n      callback(null, keyv);\n    } catch (err) {\n      callback(err as Error);\n    }\n    return;\n  }\n\n  // Load adapter (install if needed)\n  loadAdapter(config.package, config.exportName, (err, AdapterClass) => {\n    if (err) return callback(err);\n\n    try {\n      // Build adapter options: URI params + custom mapper + user options\n      const adapterOptions = {\n        ...parseUriOptions(url),\n        ...(config.optionsMapper?.(url) ?? { uri }),\n        ...options,\n      };\n\n      // Remove store from adapter options to avoid confusion\n      const { store: _, ...cleanAdapterOptions } = adapterOptions;\n\n      const storeInstance = new (AdapterClass as new (options: Record<string, unknown>) => unknown)(cleanAdapterOptions);\n      const keyv = new Keyv<T>({ store: storeInstance, ...options });\n\n      callback(null, keyv);\n    } catch (createErr) {\n      callback(createErr as Error);\n    }\n  });\n}\n"],"names":["worker","uri","options","callback","store","keyv","Keyv","err","url","URL","_err","Error","config","getAdapterConfig","protocol","package","parseUriOptions","loadAdapter","exportName","AdapterClass","adapterOptions","optionsMapper","_","cleanAdapterOptions","storeInstance","createErr"],"mappings":";;;;+BAMA;;CAEC,GACD;;;eAAwBA;;;2DATP;oEACO;0BACS;uBAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKjB,SAASA,OAAUC,GAAW,EAAEC,OAA2B,EAAEC,QAAgC;IAC1G,iDAAiD;IACjD,IAAID,QAAQE,KAAK,EAAE;QACjB,IAAI;YACF,IAAMC,OAAO,IAAIC,aAAI,CAAI,mBAAKJ;YAC9BC,SAAS,MAAME;QACjB,EAAE,OAAOE,KAAK;YACZJ,SAASI;QACX;QACA;IACF;IAEA,YAAY;IACZ,IAAIC;IACJ,IAAI;QACFA,MAAM,IAAIC,IAAIR;IAChB,EAAE,OAAOS,MAAM;QACbP,SAAS,IAAIQ,MAAM,AAAC,gBAAmB,OAAJV;QACnC;IACF;IAEA,IAAMW,SAASC,IAAAA,4BAAgB,EAACL,IAAIM,QAAQ;IAE5C,IAAI,CAACF,QAAQ;QACXT,SAAS,IAAIQ,MAAM,AAAC,qBAAiC,OAAbH,IAAIM,QAAQ,EAAC;QACrD;IACF;IAEA,mCAAmC;IACnC,IAAIF,OAAOG,OAAO,KAAK,MAAM;QAC3B,IAAI;YACF,IAAMV,QAAO,IAAIC,aAAI,CAAI,mBAAKU,IAAAA,wBAAe,EAACR,MAASN;YACvDC,SAAS,MAAME;QACjB,EAAE,OAAOE,KAAK;YACZJ,SAASI;QACX;QACA;IACF;IAEA,mCAAmC;IACnCU,IAAAA,sBAAW,EAACL,OAAOG,OAAO,EAAEH,OAAOM,UAAU,EAAE,SAACX,KAAKY;QACnD,IAAIZ,KAAK,OAAOJ,SAASI;QAEzB,IAAI;;gBAIIK;YAHN,mEAAmE;YACnE,IAAMQ,iBAAiB,mBAClBJ,IAAAA,wBAAe,EAACR,eACfI,wBAAAA,OAAOS,aAAa,cAApBT,4CAAAA,2BAAAA,QAAuBJ,2CAAQ;gBAAEP,KAAAA;YAAI,GACtCC;YAGL,uDAAuD;YACvD,IAAQE,AAAOkB,IAA8BF,eAArChB,OAAamB,iDAAwBH;;;YAE7C,IAAMI,gBAAgB,IAAKL,aAAmEI;YAC9F,IAAMlB,OAAO,IAAIC,aAAI,CAAI;gBAAEF,OAAOoB;eAAkBtB;YAEpDC,SAAS,MAAME;QACjB,EAAE,OAAOoB,WAAW;YAClBtB,SAASsB;QACX;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/keyv/keyv-registry/src/worker.ts"],"sourcesContent":["import Keyv from 'keyv';\nimport loadAdapter from './loadAdapter.ts';\nimport { getAdapterConfig } from './registry.ts';\nimport type { CreateStoreCallback, CreateStoreOptions } from './types.ts';\nimport { parseUriOptions } from './utils.ts';\n\n/**\n * Core worker function that creates a Keyv store\n */\nexport default function worker<T>(uri: string, options: CreateStoreOptions, callback: CreateStoreCallback<T>): void {\n  // Passthrough: pre-instantiated adapter provided\n  if (options.store) {\n    try {\n      const keyv = new Keyv<T>({ ...options });\n      callback(null, keyv);\n    } catch (err) {\n      callback(err as Error);\n    }\n    return;\n  }\n\n  // Parse URI\n  let url: URL;\n  try {\n    url = new URL(uri);\n  } catch (_err) {\n    callback(new Error(`Invalid URI: ${uri}`));\n    return;\n  }\n\n  const config = getAdapterConfig(url.protocol);\n\n  if (!config) {\n    callback(new Error(`Unknown protocol: ${url.protocol}. Use registerAdapter() to add support.`));\n    return;\n  }\n\n  // Memory store - no package needed\n  if (config.package === null) {\n    try {\n      const keyv = new Keyv<T>({ ...parseUriOptions(url), ...options });\n      callback(null, keyv);\n    } catch (err) {\n      callback(err as Error);\n    }\n    return;\n  }\n\n  // Load adapter (install if needed)\n  loadAdapter(config.package, config.exportName, (err, AdapterClass) => {\n    if (err) return callback(err);\n\n    try {\n      // Build adapter options: URI params + custom mapper + user options\n      const adapterOptions = {\n        ...parseUriOptions(url),\n        ...(config.optionsMapper?.(url) ?? {}),\n        ...options,\n      };\n\n      // Remove store from adapter options to avoid confusion\n      const { store: _, ...cleanAdapterOptions } = adapterOptions;\n\n      if (config.mode === 'string') {\n        const storeInstance = new (AdapterClass as new (uri: string, options: Record<string, unknown>) => unknown)(uri, cleanAdapterOptions);\n        const keyv = new Keyv<T>({ store: storeInstance, ...options });\n        callback(null, keyv);\n        return;\n      }\n\n      const storeInstance = new (AdapterClass as new (options: Record<string, unknown>) => unknown)(cleanAdapterOptions);\n      const keyv = new Keyv<T>({ store: storeInstance, ...options });\n\n      callback(null, keyv);\n    } catch (createErr) {\n      callback(createErr as Error);\n    }\n  });\n}\n"],"names":["worker","uri","options","callback","store","keyv","Keyv","err","url","URL","_err","Error","config","getAdapterConfig","protocol","package","parseUriOptions","loadAdapter","exportName","AdapterClass","adapterOptions","optionsMapper","_","cleanAdapterOptions","mode","storeInstance","createErr"],"mappings":";;;;+BAMA;;CAEC,GACD;;;eAAwBA;;;2DATP;oEACO;0BACS;uBAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKjB,SAASA,OAAUC,GAAW,EAAEC,OAA2B,EAAEC,QAAgC;IAC1G,iDAAiD;IACjD,IAAID,QAAQE,KAAK,EAAE;QACjB,IAAI;YACF,IAAMC,OAAO,IAAIC,aAAI,CAAI,mBAAKJ;YAC9BC,SAAS,MAAME;QACjB,EAAE,OAAOE,KAAK;YACZJ,SAASI;QACX;QACA;IACF;IAEA,YAAY;IACZ,IAAIC;IACJ,IAAI;QACFA,MAAM,IAAIC,IAAIR;IAChB,EAAE,OAAOS,MAAM;QACbP,SAAS,IAAIQ,MAAM,AAAC,gBAAmB,OAAJV;QACnC;IACF;IAEA,IAAMW,SAASC,IAAAA,4BAAgB,EAACL,IAAIM,QAAQ;IAE5C,IAAI,CAACF,QAAQ;QACXT,SAAS,IAAIQ,MAAM,AAAC,qBAAiC,OAAbH,IAAIM,QAAQ,EAAC;QACrD;IACF;IAEA,mCAAmC;IACnC,IAAIF,OAAOG,OAAO,KAAK,MAAM;QAC3B,IAAI;YACF,IAAMV,QAAO,IAAIC,aAAI,CAAI,mBAAKU,IAAAA,wBAAe,EAACR,MAASN;YACvDC,SAAS,MAAME;QACjB,EAAE,OAAOE,KAAK;YACZJ,SAASI;QACX;QACA;IACF;IAEA,mCAAmC;IACnCU,IAAAA,sBAAW,EAACL,OAAOG,OAAO,EAAEH,OAAOM,UAAU,EAAE,SAACX,KAAKY;QACnD,IAAIZ,KAAK,OAAOJ,SAASI;QAEzB,IAAI;;gBAIIK;YAHN,mEAAmE;YACnE,IAAMQ,iBAAiB,mBAClBJ,IAAAA,wBAAe,EAACR,eACfI,wBAAAA,OAAOS,aAAa,cAApBT,4CAAAA,2BAAAA,QAAuBJ,2CAAQ,CAAC,GACjCN;YAGL,uDAAuD;YACvD,IAAQE,AAAOkB,IAA8BF,eAArChB,OAAamB,iDAAwBH;;;YAE7C,IAAIR,OAAOY,IAAI,KAAK,UAAU;gBAC5B,IAAMC,gBAAgB,IAAKN,aAAgFlB,KAAKsB;gBAChH,IAAMlB,OAAO,IAAIC,aAAI,CAAI;oBAAEF,OAAOqB;mBAAkBvB;gBACpDC,SAAS,MAAME;gBACf;YACF;YAEA,IAAMoB,iBAAgB,IAAKN,aAAmEI;YAC9F,IAAMlB,QAAO,IAAIC,aAAI,CAAI;gBAAEF,OAAOqB;eAAkBvB;YAEpDC,SAAS,MAAME;QACjB,EAAE,OAAOqB,WAAW;YAClBvB,SAASuB;QACX;IACF;AACF"}

package/dist/esm/index.js

@@ -5,7 +5,5 @@ export default function createStore(uri, options, callback) {
     callback = typeof options === 'function' ? options : callback;
     options = typeof options === 'function' ? {} : options || {};
     if (typeof callback === 'function') return worker(uri, options, callback);
-    return new Promise((resolve, reject)=>{
-        worker(uri, options, (err, store)=>err ? reject(err) : resolve(store));
-    });
+    return new Promise((resolve, reject)=>worker(uri, options, (err, store)=>err ? reject(err) : resolve(store)));
 }

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/keyv/keyv-registry/src/index.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport type { CreateStoreCallback, CreateStoreOptions } from './types.ts';\nimport worker from './worker.ts';\n\nexport { clearAdapterCache } from './loadAdapter.ts';\nexport { getRegistry, registerAdapter } from './registry.ts';\nexport type { AdapterConfig, CreateStoreCallback, CreateStoreOptions } from './types.ts';\n\n/**\n * Create a Keyv store from a URI string\n *\n * Supports dual-boot API (callback or Promise):\n *\n * @example\n * // Promise API\n * const store = await createStore('redis://localhost:6379');\n * const file = await createStore('file://~/.cache/app/data.json');\n * const memory = await createStore('memory://');\n *\n * @example\n * // Callback API\n * createStore('redis://localhost:6379', (err, store) => {\n *   if (err) throw err;\n *   // use store\n * });\n *\n * @example\n * // With options\n * const store = await createStore('redis://localhost:6379', {\n *   namespace: 'myapp',\n *   ttl: 60000\n * });\n *\n * @example\n * // Pre-instantiated adapter passthrough\n * import KeyvRedis from '@keyv/redis';\n * const redis = new KeyvRedis('redis://localhost:6379');\n * const store = await createStore('redis://ignored', { store: redis });\n */\nexport default function createStore<T>(uri: string, callback: CreateStoreCallback<T>): void;\nexport default function createStore<T>(uri: string, options: CreateStoreOptions, callback: CreateStoreCallback<T>): void;\nexport default function createStore<T>(uri: string, options?: CreateStoreOptions): Promise<Keyv<T>>;\nexport default function createStore<T>(uri: string, options?: CreateStoreOptions | CreateStoreCallback<T>, callback?: CreateStoreCallback<T>): void | Promise<Keyv<T>> {\n  callback = typeof options === 'function' ? options : callback;\n  options = typeof options === 'function' ? {} : ((options || {}) as CreateStoreOptions);\n\n  if (typeof callback === 'function') return worker(uri, options, callback);\n  return new Promise((resolve, reject) => {\n    worker(uri, options, (err, store) => (err ? reject(err) : resolve(store as Keyv<T>)));\n  });\n}\n"],"names":["worker","clearAdapterCache","getRegistry","registerAdapter","createStore","uri","options","callback","Promise","resolve","reject","err","store"],"mappings":"AAEA,OAAOA,YAAY,cAAc;AAEjC,SAASC,iBAAiB,QAAQ,mBAAmB;AACrD,SAASC,WAAW,EAAEC,eAAe,QAAQ,gBAAgB;AAqC7D,eAAe,SAASC,YAAeC,GAAW,EAAEC,OAAqD,EAAEC,QAAiC;IAC1IA,WAAW,OAAOD,YAAY,aAAaA,UAAUC;IACrDD,UAAU,OAAOA,YAAY,aAAa,CAAC,IAAMA,WAAW,CAAC;IAE7D,IAAI,OAAOC,aAAa,YAAY,OAAOP,OAAOK,KAAKC,SAASC;IAChE,OAAO,IAAIC,QAAQ,CAACC,SAASC;QAC3BV,OAAOK,KAAKC,SAAS,CAACK,KAAKC,QAAWD,MAAMD,OAAOC,OAAOF,QAAQG;IACpE;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/keyv/keyv-registry/src/index.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport type { CreateStoreCallback, CreateStoreOptions } from './types.ts';\nimport worker from './worker.ts';\n\nexport { clearAdapterCache } from './loadAdapter.ts';\nexport { getRegistry, registerAdapter } from './registry.ts';\nexport type { AdapterConfig, CreateStoreCallback, CreateStoreOptions } from './types.ts';\n\n/**\n * Create a Keyv store from a URI string\n *\n * Supports dual-boot API (callback or Promise):\n *\n * @example\n * // Promise API\n * const store = await createStore('redis://localhost:6379');\n * const file = await createStore('file://~/.cache/app/data.json');\n * const memory = await createStore('memory://');\n *\n * @example\n * // Callback API\n * createStore('redis://localhost:6379', (err, store) => {\n *   if (err) throw err;\n *   // use store\n * });\n *\n * @example\n * // With options\n * const store = await createStore('redis://localhost:6379', {\n *   namespace: 'myapp',\n *   ttl: 60000\n * });\n *\n * @example\n * // Pre-instantiated adapter passthrough\n * import KeyvRedis from '@keyv/redis';\n * const redis = new KeyvRedis('redis://localhost:6379');\n * const store = await createStore('redis://ignored', { store: redis });\n */\nexport default function createStore<T>(uri: string, callback: CreateStoreCallback<T>): void;\nexport default function createStore<T>(uri: string, options: CreateStoreOptions, callback: CreateStoreCallback<T>): void;\nexport default function createStore<T>(uri: string, options?: CreateStoreOptions): Promise<Keyv<T>>;\nexport default function createStore<T>(uri: string, options?: CreateStoreOptions | CreateStoreCallback<T>, callback?: CreateStoreCallback<T>): void | Promise<Keyv<T>> {\n  callback = typeof options === 'function' ? options : callback;\n  options = typeof options === 'function' ? {} : ((options || {}) as CreateStoreOptions);\n\n  if (typeof callback === 'function') return worker(uri, options, callback);\n  return new Promise((resolve, reject) => worker(uri, options, (err, store) => (err ? reject(err) : resolve(store as Keyv<T>))));\n}\n"],"names":["worker","clearAdapterCache","getRegistry","registerAdapter","createStore","uri","options","callback","Promise","resolve","reject","err","store"],"mappings":"AAEA,OAAOA,YAAY,cAAc;AAEjC,SAASC,iBAAiB,QAAQ,mBAAmB;AACrD,SAASC,WAAW,EAAEC,eAAe,QAAQ,gBAAgB;AAqC7D,eAAe,SAASC,YAAeC,GAAW,EAAEC,OAAqD,EAAEC,QAAiC;IAC1IA,WAAW,OAAOD,YAAY,aAAaA,UAAUC;IACrDD,UAAU,OAAOA,YAAY,aAAa,CAAC,IAAMA,WAAW,CAAC;IAE7D,IAAI,OAAOC,aAAa,YAAY,OAAOP,OAAOK,KAAKC,SAASC;IAChE,OAAO,IAAIC,QAAQ,CAACC,SAASC,SAAWV,OAAOK,KAAKC,SAAS,CAACK,KAAKC,QAAWD,MAAMD,OAAOC,OAAOF,QAAQG;AAC5G"}

package/dist/esm/registry.js

@@ -4,34 +4,65 @@ import { resolveFilePath } from './utils.js';
  */ const PROTOCOL_REGISTRY = {
     // Official @keyv adapters
     'redis:': {
-        package: '@keyv/redis'
+        package: '@keyv/redis',
+        mode: 'string'
     },
     'rediss:': {
-        package: '@keyv/redis'
+        package: '@keyv/redis',
+        mode: 'string'
     },
     'postgresql:': {
-        package: '@keyv/postgres'
+        package: '@keyv/postgres',
+        mode: 'options',
+        optionsMapper: (url)=>({
+                uri: url.toString()
+            })
     },
     'postgres:': {
-        package: '@keyv/postgres'
+        package: '@keyv/postgres',
+        mode: 'options',
+        optionsMapper: (url)=>({
+                uri: url.toString()
+            })
     },
     'mysql:': {
-        package: '@keyv/mysql'
+        package: '@keyv/mysql',
+        mode: 'options',
+        optionsMapper: (url)=>({
+                uri: url.toString()
+            })
     },
     'sqlite:': {
-        package: '@keyv/sqlite'
+        package: '@keyv/sqlite',
+        mode: 'options',
+        optionsMapper: (url)=>({
+                uri: url.toString()
+            })
     },
     'mongodb:': {
-        package: '@keyv/mongo'
+        package: '@keyv/mongo',
+        mode: 'options',
+        optionsMapper: (url)=>({
+                url: url.toString()
+            })
     },
     'mongodb+srv:': {
-        package: '@keyv/mongo'
+        package: '@keyv/mongo',
+        mode: 'options',
+        optionsMapper: (url)=>({
+                url: url.toString()
+            })
     },
     'memcache:': {
-        package: '@keyv/memcache'
+        package: '@keyv/memcache',
+        mode: 'string'
     },
     'etcd:': {
-        package: '@keyv/etcd'
+        package: '@keyv/etcd',
+        mode: 'options',
+        optionsMapper: (url)=>({
+                url: url.toString()
+            })
     },
     // Third-party adapters
     'file:': {

package/dist/esm/registry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/keyv/keyv-registry/src/registry.ts"],"sourcesContent":["import type { AdapterConfig } from './types.ts';\nimport { resolveFilePath } from './utils.ts';\n\n/**\n * Protocol registry mapping URI protocols to adapter configurations\n */\nconst PROTOCOL_REGISTRY: Record<string, AdapterConfig> = {\n  // Official @keyv adapters\n  'redis:': { package: '@keyv/redis' },\n  'rediss:': { package: '@keyv/redis' },\n  'postgresql:': { package: '@keyv/postgres' },\n  'postgres:': { package: '@keyv/postgres' },\n  'mysql:': { package: '@keyv/mysql' },\n  'sqlite:': { package: '@keyv/sqlite' },\n  'mongodb:': { package: '@keyv/mongo' },\n  'mongodb+srv:': { package: '@keyv/mongo' },\n  'memcache:': { package: '@keyv/memcache' },\n  'etcd:': { package: '@keyv/etcd' },\n\n  // Third-party adapters\n  'file:': {\n    package: 'keyv-file',\n    exportName: 'KeyvFile',\n    optionsMapper: (url: URL) => ({ filename: resolveFilePath(url) }),\n  },\n\n  // Built-in (no package needed)\n  'memory:': { package: null },\n\n  // Future/custom adapters\n  'duckdb:': {\n    package: 'keyv-duckdb',\n    optionsMapper: (url: URL) => ({ filename: resolveFilePath(url) }),\n  },\n};\n\n/**\n * Register or override a protocol adapter\n */\nexport function registerAdapter(protocol: string, config: AdapterConfig): void {\n  const normalizedProtocol = protocol.endsWith(':') ? protocol : `${protocol}:`;\n  PROTOCOL_REGISTRY[normalizedProtocol] = config;\n}\n\n/**\n * Get the current registry (read-only copy)\n */\nexport function getRegistry(): Readonly<Record<string, AdapterConfig>> {\n  return { ...PROTOCOL_REGISTRY };\n}\n\n/**\n * Get adapter config for a protocol\n */\nexport function getAdapterConfig(protocol: string): AdapterConfig | undefined {\n  return PROTOCOL_REGISTRY[protocol];\n}\n"],"names":["resolveFilePath","PROTOCOL_REGISTRY","package","exportName","optionsMapper","url","filename","registerAdapter","protocol","config","normalizedProtocol","endsWith","getRegistry","getAdapterConfig"],"mappings":"AACA,SAASA,eAAe,QAAQ,aAAa;AAE7C;;CAEC,GACD,MAAMC,oBAAmD;IACvD,0BAA0B;IAC1B,UAAU;QAAEC,SAAS;IAAc;IACnC,WAAW;QAAEA,SAAS;IAAc;IACpC,eAAe;QAAEA,SAAS;IAAiB;IAC3C,aAAa;QAAEA,SAAS;IAAiB;IACzC,UAAU;QAAEA,SAAS;IAAc;IACnC,WAAW;QAAEA,SAAS;IAAe;IACrC,YAAY;QAAEA,SAAS;IAAc;IACrC,gBAAgB;QAAEA,SAAS;IAAc;IACzC,aAAa;QAAEA,SAAS;IAAiB;IACzC,SAAS;QAAEA,SAAS;IAAa;IAEjC,uBAAuB;IACvB,SAAS;QACPA,SAAS;QACTC,YAAY;QACZC,eAAe,CAACC,MAAc,CAAA;gBAAEC,UAAUN,gBAAgBK;YAAK,CAAA;IACjE;IAEA,+BAA+B;IAC/B,WAAW;QAAEH,SAAS;IAAK;IAE3B,yBAAyB;IACzB,WAAW;QACTA,SAAS;QACTE,eAAe,CAACC,MAAc,CAAA;gBAAEC,UAAUN,gBAAgBK;YAAK,CAAA;IACjE;AACF;AAEA;;CAEC,GACD,OAAO,SAASE,gBAAgBC,QAAgB,EAAEC,MAAqB;IACrE,MAAMC,qBAAqBF,SAASG,QAAQ,CAAC,OAAOH,WAAW,GAAGA,SAAS,CAAC,CAAC;IAC7EP,iBAAiB,CAACS,mBAAmB,GAAGD;AAC1C;AAEA;;CAEC,GACD,OAAO,SAASG;IACd,OAAO;QAAE,GAAGX,iBAAiB;IAAC;AAChC;AAEA;;CAEC,GACD,OAAO,SAASY,iBAAiBL,QAAgB;IAC/C,OAAOP,iBAAiB,CAACO,SAAS;AACpC"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/keyv/keyv-registry/src/registry.ts"],"sourcesContent":["import type { AdapterConfig } from './types.ts';\nimport { resolveFilePath } from './utils.ts';\n\n/**\n * Protocol registry mapping URI protocols to adapter configurations\n */\nconst PROTOCOL_REGISTRY: Record<string, AdapterConfig> = {\n  // Official @keyv adapters\n  'redis:': { package: '@keyv/redis', mode: 'string' },\n  'rediss:': { package: '@keyv/redis', mode: 'string' },\n  'postgresql:': { package: '@keyv/postgres', mode: 'options', optionsMapper: (url) => ({ uri: url.toString() }) },\n  'postgres:': { package: '@keyv/postgres', mode: 'options', optionsMapper: (url) => ({ uri: url.toString() }) },\n  'mysql:': { package: '@keyv/mysql', mode: 'options', optionsMapper: (url) => ({ uri: url.toString() }) },\n  'sqlite:': { package: '@keyv/sqlite', mode: 'options', optionsMapper: (url) => ({ uri: url.toString() }) },\n  'mongodb:': { package: '@keyv/mongo', mode: 'options', optionsMapper: (url) => ({ url: url.toString() }) },\n  'mongodb+srv:': { package: '@keyv/mongo', mode: 'options', optionsMapper: (url) => ({ url: url.toString() }) },\n  'memcache:': { package: '@keyv/memcache', mode: 'string' },\n  'etcd:': { package: '@keyv/etcd', mode: 'options', optionsMapper: (url) => ({ url: url.toString() }) },\n\n  // Third-party adapters\n  'file:': {\n    package: 'keyv-file',\n    exportName: 'KeyvFile',\n    optionsMapper: (url: URL) => ({ filename: resolveFilePath(url) }),\n  },\n\n  // Built-in (no package needed)\n  'memory:': { package: null },\n\n  // Future/custom adapters\n  'duckdb:': {\n    package: 'keyv-duckdb',\n    optionsMapper: (url: URL) => ({ filename: resolveFilePath(url) }),\n  },\n};\n\n/**\n * Register or override a protocol adapter\n */\nexport function registerAdapter(protocol: string, config: AdapterConfig): void {\n  const normalizedProtocol = protocol.endsWith(':') ? protocol : `${protocol}:`;\n  PROTOCOL_REGISTRY[normalizedProtocol] = config;\n}\n\n/**\n * Get the current registry (read-only copy)\n */\nexport function getRegistry(): Readonly<Record<string, AdapterConfig>> {\n  return { ...PROTOCOL_REGISTRY };\n}\n\n/**\n * Get adapter config for a protocol\n */\nexport function getAdapterConfig(protocol: string): AdapterConfig | undefined {\n  return PROTOCOL_REGISTRY[protocol];\n}\n"],"names":["resolveFilePath","PROTOCOL_REGISTRY","package","mode","optionsMapper","url","uri","toString","exportName","filename","registerAdapter","protocol","config","normalizedProtocol","endsWith","getRegistry","getAdapterConfig"],"mappings":"AACA,SAASA,eAAe,QAAQ,aAAa;AAE7C;;CAEC,GACD,MAAMC,oBAAmD;IACvD,0BAA0B;IAC1B,UAAU;QAAEC,SAAS;QAAeC,MAAM;IAAS;IACnD,WAAW;QAAED,SAAS;QAAeC,MAAM;IAAS;IACpD,eAAe;QAAED,SAAS;QAAkBC,MAAM;QAAWC,eAAe,CAACC,MAAS,CAAA;gBAAEC,KAAKD,IAAIE,QAAQ;YAAG,CAAA;IAAG;IAC/G,aAAa;QAAEL,SAAS;QAAkBC,MAAM;QAAWC,eAAe,CAACC,MAAS,CAAA;gBAAEC,KAAKD,IAAIE,QAAQ;YAAG,CAAA;IAAG;IAC7G,UAAU;QAAEL,SAAS;QAAeC,MAAM;QAAWC,eAAe,CAACC,MAAS,CAAA;gBAAEC,KAAKD,IAAIE,QAAQ;YAAG,CAAA;IAAG;IACvG,WAAW;QAAEL,SAAS;QAAgBC,MAAM;QAAWC,eAAe,CAACC,MAAS,CAAA;gBAAEC,KAAKD,IAAIE,QAAQ;YAAG,CAAA;IAAG;IACzG,YAAY;QAAEL,SAAS;QAAeC,MAAM;QAAWC,eAAe,CAACC,MAAS,CAAA;gBAAEA,KAAKA,IAAIE,QAAQ;YAAG,CAAA;IAAG;IACzG,gBAAgB;QAAEL,SAAS;QAAeC,MAAM;QAAWC,eAAe,CAACC,MAAS,CAAA;gBAAEA,KAAKA,IAAIE,QAAQ;YAAG,CAAA;IAAG;IAC7G,aAAa;QAAEL,SAAS;QAAkBC,MAAM;IAAS;IACzD,SAAS;QAAED,SAAS;QAAcC,MAAM;QAAWC,eAAe,CAACC,MAAS,CAAA;gBAAEA,KAAKA,IAAIE,QAAQ;YAAG,CAAA;IAAG;IAErG,uBAAuB;IACvB,SAAS;QACPL,SAAS;QACTM,YAAY;QACZJ,eAAe,CAACC,MAAc,CAAA;gBAAEI,UAAUT,gBAAgBK;YAAK,CAAA;IACjE;IAEA,+BAA+B;IAC/B,WAAW;QAAEH,SAAS;IAAK;IAE3B,yBAAyB;IACzB,WAAW;QACTA,SAAS;QACTE,eAAe,CAACC,MAAc,CAAA;gBAAEI,UAAUT,gBAAgBK;YAAK,CAAA;IACjE;AACF;AAEA;;CAEC,GACD,OAAO,SAASK,gBAAgBC,QAAgB,EAAEC,MAAqB;IACrE,MAAMC,qBAAqBF,SAASG,QAAQ,CAAC,OAAOH,WAAW,GAAGA,SAAS,CAAC,CAAC;IAC7EV,iBAAiB,CAACY,mBAAmB,GAAGD;AAC1C;AAEA;;CAEC,GACD,OAAO,SAASG;IACd,OAAO;QAAE,GAAGd,iBAAiB;IAAC;AAChC;AAEA;;CAEC,GACD,OAAO,SAASe,iBAAiBL,QAAgB;IAC/C,OAAOV,iBAAiB,CAACU,SAAS;AACpC"}

package/dist/esm/types.d.ts

@@ -7,6 +7,8 @@ export interface AdapterConfig {
     package: string | null;
     /** Named export from the package (default: 'default') */
     exportName?: string;
+    /** How to instantiate the adapter */
+    mode?: 'string' | 'options';
     /** Custom function to map URL to adapter options */
     optionsMapper?: (url: URL) => Record<string, unknown>;
 }

package/dist/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/keyv/keyv-registry/src/types.ts"],"sourcesContent":["import type Keyv from 'keyv';\n\n/**\n * Configuration for a protocol adapter\n */\nexport interface AdapterConfig {\n  /** npm package name, or null for built-in adapters */\n  package: string | null;\n  /** Named export from the package (default: 'default') */\n  exportName?: string;\n  /** Custom function to map URL to adapter options */\n  optionsMapper?: (url: URL) => Record<string, unknown>;\n}\n\n/**\n * Options for createStore\n */\nexport interface CreateStoreOptions {\n  /** Pre-instantiated adapter (bypasses URI loading) */\n  store?: unknown;\n  /** Keyv namespace */\n  namespace?: string;\n  /** Default TTL in milliseconds */\n  ttl?: number;\n  /** Additional Keyv options */\n  [key: string]: unknown;\n}\n\n/**\n * Callback type for createStore\n */\nexport type CreateStoreCallback<T> = (err: Error | null, store?: Keyv<T>) => void;\n\n/**\n * Internal callback type for loadAdapter\n */\nexport type LoadAdapterCallback = (err: Error | null, Adapter?: unknown) => void;\n"],"names":[],"mappings":"AAiCA;;CAEC,GACD,WAAiF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/keyv/keyv-registry/src/types.ts"],"sourcesContent":["import type Keyv from 'keyv';\n\n/**\n * Configuration for a protocol adapter\n */\nexport interface AdapterConfig {\n  /** npm package name, or null for built-in adapters */\n  package: string | null;\n  /** Named export from the package (default: 'default') */\n  exportName?: string;\n  /** How to instantiate the adapter */\n  mode?: 'string' | 'options';\n  /** Custom function to map URL to adapter options */\n  optionsMapper?: (url: URL) => Record<string, unknown>;\n}\n\n/**\n * Options for createStore\n */\nexport interface CreateStoreOptions {\n  /** Pre-instantiated adapter (bypasses URI loading) */\n  store?: unknown;\n  /** Keyv namespace */\n  namespace?: string;\n  /** Default TTL in milliseconds */\n  ttl?: number;\n  /** Additional Keyv options */\n  [key: string]: unknown;\n}\n\n/**\n * Callback type for createStore\n */\nexport type CreateStoreCallback<T> = (err: Error | null, store?: Keyv<T>) => void;\n\n/**\n * Internal callback type for loadAdapter\n */\nexport type LoadAdapterCallback = (err: Error | null, Adapter?: unknown) => void;\n"],"names":[],"mappings":"AAmCA;;CAEC,GACD,WAAiF"}

package/dist/esm/worker.js

@@ -52,13 +52,20 @@ import { parseUriOptions } from './utils.js';
             // Build adapter options: URI params + custom mapper + user options
             const adapterOptions = {
                 ...parseUriOptions(url),
-                ...(_ref = (_config_optionsMapper = config.optionsMapper) === null || _config_optionsMapper === void 0 ? void 0 : _config_optionsMapper.call(config, url)) !== null && _ref !== void 0 ? _ref : {
-                    uri
-                },
+                ...(_ref = (_config_optionsMapper = config.optionsMapper) === null || _config_optionsMapper === void 0 ? void 0 : _config_optionsMapper.call(config, url)) !== null && _ref !== void 0 ? _ref : {},
                 ...options
             };
             // Remove store from adapter options to avoid confusion
             const { store: _, ...cleanAdapterOptions } = adapterOptions;
+            if (config.mode === 'string') {
+                const storeInstance = new AdapterClass(uri, cleanAdapterOptions);
+                const keyv = new Keyv({
+                    store: storeInstance,
+                    ...options
+                });
+                callback(null, keyv);
+                return;
+            }
             const storeInstance = new AdapterClass(cleanAdapterOptions);
             const keyv = new Keyv({
                 store: storeInstance,

package/dist/esm/worker.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/keyv/keyv-registry/src/worker.ts"],"sourcesContent":["import Keyv from 'keyv';\nimport loadAdapter from './loadAdapter.ts';\nimport { getAdapterConfig } from './registry.ts';\nimport type { CreateStoreCallback, CreateStoreOptions } from './types.ts';\nimport { parseUriOptions } from './utils.ts';\n\n/**\n * Core worker function that creates a Keyv store\n */\nexport default function worker<T>(uri: string, options: CreateStoreOptions, callback: CreateStoreCallback<T>): void {\n  // Passthrough: pre-instantiated adapter provided\n  if (options.store) {\n    try {\n      const keyv = new Keyv<T>({ ...options });\n      callback(null, keyv);\n    } catch (err) {\n      callback(err as Error);\n    }\n    return;\n  }\n\n  // Parse URI\n  let url: URL;\n  try {\n    url = new URL(uri);\n  } catch (_err) {\n    callback(new Error(`Invalid URI: ${uri}`));\n    return;\n  }\n\n  const config = getAdapterConfig(url.protocol);\n\n  if (!config) {\n    callback(new Error(`Unknown protocol: ${url.protocol}. Use registerAdapter() to add support.`));\n    return;\n  }\n\n  // Memory store - no package needed\n  if (config.package === null) {\n    try {\n      const keyv = new Keyv<T>({ ...parseUriOptions(url), ...options });\n      callback(null, keyv);\n    } catch (err) {\n      callback(err as Error);\n    }\n    return;\n  }\n\n  // Load adapter (install if needed)\n  loadAdapter(config.package, config.exportName, (err, AdapterClass) => {\n    if (err) return callback(err);\n\n    try {\n      // Build adapter options: URI params + custom mapper + user options\n      const adapterOptions = {\n        ...parseUriOptions(url),\n        ...(config.optionsMapper?.(url) ?? { uri }),\n        ...options,\n      };\n\n      // Remove store from adapter options to avoid confusion\n      const { store: _, ...cleanAdapterOptions } = adapterOptions;\n\n      const storeInstance = new (AdapterClass as new (options: Record<string, unknown>) => unknown)(cleanAdapterOptions);\n      const keyv = new Keyv<T>({ store: storeInstance, ...options });\n\n      callback(null, keyv);\n    } catch (createErr) {\n      callback(createErr as Error);\n    }\n  });\n}\n"],"names":["Keyv","loadAdapter","getAdapterConfig","parseUriOptions","worker","uri","options","callback","store","keyv","err","url","URL","_err","Error","config","protocol","package","exportName","AdapterClass","adapterOptions","optionsMapper","_","cleanAdapterOptions","storeInstance","createErr"],"mappings":"AAAA,OAAOA,UAAU,OAAO;AACxB,OAAOC,iBAAiB,mBAAmB;AAC3C,SAASC,gBAAgB,QAAQ,gBAAgB;AAEjD,SAASC,eAAe,QAAQ,aAAa;AAE7C;;CAEC,GACD,eAAe,SAASC,OAAUC,GAAW,EAAEC,OAA2B,EAAEC,QAAgC;IAC1G,iDAAiD;IACjD,IAAID,QAAQE,KAAK,EAAE;QACjB,IAAI;YACF,MAAMC,OAAO,IAAIT,KAAQ;gBAAE,GAAGM,OAAO;YAAC;YACtCC,SAAS,MAAME;QACjB,EAAE,OAAOC,KAAK;YACZH,SAASG;QACX;QACA;IACF;IAEA,YAAY;IACZ,IAAIC;IACJ,IAAI;QACFA,MAAM,IAAIC,IAAIP;IAChB,EAAE,OAAOQ,MAAM;QACbN,SAAS,IAAIO,MAAM,CAAC,aAAa,EAAET,KAAK;QACxC;IACF;IAEA,MAAMU,SAASb,iBAAiBS,IAAIK,QAAQ;IAE5C,IAAI,CAACD,QAAQ;QACXR,SAAS,IAAIO,MAAM,CAAC,kBAAkB,EAAEH,IAAIK,QAAQ,CAAC,uCAAuC,CAAC;QAC7F;IACF;IAEA,mCAAmC;IACnC,IAAID,OAAOE,OAAO,KAAK,MAAM;QAC3B,IAAI;YACF,MAAMR,OAAO,IAAIT,KAAQ;gBAAE,GAAGG,gBAAgBQ,IAAI;gBAAE,GAAGL,OAAO;YAAC;YAC/DC,SAAS,MAAME;QACjB,EAAE,OAAOC,KAAK;YACZH,SAASG;QACX;QACA;IACF;IAEA,mCAAmC;IACnCT,YAAYc,OAAOE,OAAO,EAAEF,OAAOG,UAAU,EAAE,CAACR,KAAKS;QACnD,IAAIT,KAAK,OAAOH,SAASG;QAEzB,IAAI;;gBAIIK;YAHN,mEAAmE;YACnE,MAAMK,iBAAiB;gBACrB,GAAGjB,gBAAgBQ,IAAI;4BACnBI,wBAAAA,OAAOM,aAAa,cAApBN,4CAAAA,2BAAAA,QAAuBJ,2CAAQ;oBAAEN;gBAAI,CAAzC;gBACA,GAAGC,OAAO;YACZ;YAEA,uDAAuD;YACvD,MAAM,EAAEE,OAAOc,CAAC,EAAE,GAAGC,qBAAqB,GAAGH;YAE7C,MAAMI,gBAAgB,IAAKL,aAAmEI;YAC9F,MAAMd,OAAO,IAAIT,KAAQ;gBAAEQ,OAAOgB;gBAAe,GAAGlB,OAAO;YAAC;YAE5DC,SAAS,MAAME;QACjB,EAAE,OAAOgB,WAAW;YAClBlB,SAASkB;QACX;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/keyv/keyv-registry/src/worker.ts"],"sourcesContent":["import Keyv from 'keyv';\nimport loadAdapter from './loadAdapter.ts';\nimport { getAdapterConfig } from './registry.ts';\nimport type { CreateStoreCallback, CreateStoreOptions } from './types.ts';\nimport { parseUriOptions } from './utils.ts';\n\n/**\n * Core worker function that creates a Keyv store\n */\nexport default function worker<T>(uri: string, options: CreateStoreOptions, callback: CreateStoreCallback<T>): void {\n  // Passthrough: pre-instantiated adapter provided\n  if (options.store) {\n    try {\n      const keyv = new Keyv<T>({ ...options });\n      callback(null, keyv);\n    } catch (err) {\n      callback(err as Error);\n    }\n    return;\n  }\n\n  // Parse URI\n  let url: URL;\n  try {\n    url = new URL(uri);\n  } catch (_err) {\n    callback(new Error(`Invalid URI: ${uri}`));\n    return;\n  }\n\n  const config = getAdapterConfig(url.protocol);\n\n  if (!config) {\n    callback(new Error(`Unknown protocol: ${url.protocol}. Use registerAdapter() to add support.`));\n    return;\n  }\n\n  // Memory store - no package needed\n  if (config.package === null) {\n    try {\n      const keyv = new Keyv<T>({ ...parseUriOptions(url), ...options });\n      callback(null, keyv);\n    } catch (err) {\n      callback(err as Error);\n    }\n    return;\n  }\n\n  // Load adapter (install if needed)\n  loadAdapter(config.package, config.exportName, (err, AdapterClass) => {\n    if (err) return callback(err);\n\n    try {\n      // Build adapter options: URI params + custom mapper + user options\n      const adapterOptions = {\n        ...parseUriOptions(url),\n        ...(config.optionsMapper?.(url) ?? {}),\n        ...options,\n      };\n\n      // Remove store from adapter options to avoid confusion\n      const { store: _, ...cleanAdapterOptions } = adapterOptions;\n\n      if (config.mode === 'string') {\n        const storeInstance = new (AdapterClass as new (uri: string, options: Record<string, unknown>) => unknown)(uri, cleanAdapterOptions);\n        const keyv = new Keyv<T>({ store: storeInstance, ...options });\n        callback(null, keyv);\n        return;\n      }\n\n      const storeInstance = new (AdapterClass as new (options: Record<string, unknown>) => unknown)(cleanAdapterOptions);\n      const keyv = new Keyv<T>({ store: storeInstance, ...options });\n\n      callback(null, keyv);\n    } catch (createErr) {\n      callback(createErr as Error);\n    }\n  });\n}\n"],"names":["Keyv","loadAdapter","getAdapterConfig","parseUriOptions","worker","uri","options","callback","store","keyv","err","url","URL","_err","Error","config","protocol","package","exportName","AdapterClass","adapterOptions","optionsMapper","_","cleanAdapterOptions","mode","storeInstance","createErr"],"mappings":"AAAA,OAAOA,UAAU,OAAO;AACxB,OAAOC,iBAAiB,mBAAmB;AAC3C,SAASC,gBAAgB,QAAQ,gBAAgB;AAEjD,SAASC,eAAe,QAAQ,aAAa;AAE7C;;CAEC,GACD,eAAe,SAASC,OAAUC,GAAW,EAAEC,OAA2B,EAAEC,QAAgC;IAC1G,iDAAiD;IACjD,IAAID,QAAQE,KAAK,EAAE;QACjB,IAAI;YACF,MAAMC,OAAO,IAAIT,KAAQ;gBAAE,GAAGM,OAAO;YAAC;YACtCC,SAAS,MAAME;QACjB,EAAE,OAAOC,KAAK;YACZH,SAASG;QACX;QACA;IACF;IAEA,YAAY;IACZ,IAAIC;IACJ,IAAI;QACFA,MAAM,IAAIC,IAAIP;IAChB,EAAE,OAAOQ,MAAM;QACbN,SAAS,IAAIO,MAAM,CAAC,aAAa,EAAET,KAAK;QACxC;IACF;IAEA,MAAMU,SAASb,iBAAiBS,IAAIK,QAAQ;IAE5C,IAAI,CAACD,QAAQ;QACXR,SAAS,IAAIO,MAAM,CAAC,kBAAkB,EAAEH,IAAIK,QAAQ,CAAC,uCAAuC,CAAC;QAC7F;IACF;IAEA,mCAAmC;IACnC,IAAID,OAAOE,OAAO,KAAK,MAAM;QAC3B,IAAI;YACF,MAAMR,OAAO,IAAIT,KAAQ;gBAAE,GAAGG,gBAAgBQ,IAAI;gBAAE,GAAGL,OAAO;YAAC;YAC/DC,SAAS,MAAME;QACjB,EAAE,OAAOC,KAAK;YACZH,SAASG;QACX;QACA;IACF;IAEA,mCAAmC;IACnCT,YAAYc,OAAOE,OAAO,EAAEF,OAAOG,UAAU,EAAE,CAACR,KAAKS;QACnD,IAAIT,KAAK,OAAOH,SAASG;QAEzB,IAAI;;gBAIIK;YAHN,mEAAmE;YACnE,MAAMK,iBAAiB;gBACrB,GAAGjB,gBAAgBQ,IAAI;4BACnBI,wBAAAA,OAAOM,aAAa,cAApBN,4CAAAA,2BAAAA,QAAuBJ,2CAAQ,CAAC,CAApC;gBACA,GAAGL,OAAO;YACZ;YAEA,uDAAuD;YACvD,MAAM,EAAEE,OAAOc,CAAC,EAAE,GAAGC,qBAAqB,GAAGH;YAE7C,IAAIL,OAAOS,IAAI,KAAK,UAAU;gBAC5B,MAAMC,gBAAgB,IAAKN,aAAgFd,KAAKkB;gBAChH,MAAMd,OAAO,IAAIT,KAAQ;oBAAEQ,OAAOiB;oBAAe,GAAGnB,OAAO;gBAAC;gBAC5DC,SAAS,MAAME;gBACf;YACF;YAEA,MAAMgB,gBAAgB,IAAKN,aAAmEI;YAC9F,MAAMd,OAAO,IAAIT,KAAQ;gBAAEQ,OAAOiB;gBAAe,GAAGnB,OAAO;YAAC;YAE5DC,SAAS,MAAME;QACjB,EAAE,OAAOiB,WAAW;YAClBnB,SAASmB;QACX;IACF;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keyv-registry",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Protocol-based Keyv adapter registry with dynamic module installation",
   "keywords": [
     "keyv",