@hazeljs/prompts 0.2.0-alpha.1

package/dist/__tests__/template.test.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const template_1 = require("../template");
+describe('PromptTemplate', () => {
+    describe('constructor', () => {
+        it('stores template string and metadata', () => {
+            const tpl = new template_1.PromptTemplate('Hello {name}', { name: 'Test', version: '1.0.0' });
+            expect(tpl.template).toBe('Hello {name}');
+            expect(tpl.metadata.name).toBe('Test');
+            expect(tpl.metadata.version).toBe('1.0.0');
+        });
+    });
+    describe('render()', () => {
+        it('substitutes a single variable', () => {
+            const tpl = new template_1.PromptTemplate('Hello {name}!', { name: 'Test' });
+            expect(tpl.render({ name: 'World' })).toBe('Hello World!');
+        });
+        it('substitutes multiple variables', () => {
+            const tpl = new template_1.PromptTemplate('Context: {context}\nQuestion: {query}', { name: 'QA' });
+            const rendered = tpl.render({ query: 'What?', context: 'Some context' });
+            expect(rendered).toBe('Context: Some context\nQuestion: What?');
+        });
+        it('leaves unrecognised placeholders intact', () => {
+            const tpl = new template_1.PromptTemplate('Hello {name} from {place}', {
+                name: 'Test',
+            });
+            expect(tpl.render({ name: 'Alice' })).toBe('Hello Alice from {place}');
+        });
+        it('converts non-string values to string', () => {
+            const tpl = new template_1.PromptTemplate('Count: {count}', { name: 'Counter' });
+            expect(tpl.render({ count: 42 })).toBe('Count: 42');
+        });
+        it('handles empty template', () => {
+            const tpl = new template_1.PromptTemplate('', { name: 'Empty' });
+            expect(tpl.render({})).toBe('');
+        });
+        it('handles template with no placeholders', () => {
+            const tpl = new template_1.PromptTemplate('Static text only.', {
+                name: 'Static',
+            });
+            expect(tpl.render({})).toBe('Static text only.');
+        });
+        it('substitutes the same placeholder multiple times', () => {
+            const tpl = new template_1.PromptTemplate('{word} and {word} again', { name: 'Rep' });
+            expect(tpl.render({ word: 'yes' })).toBe('yes and yes again');
+        });
+        it('handles multiline templates', () => {
+            const tpl = new template_1.PromptTemplate('Line 1: {a}\nLine 2: {b}\nDone.', {
+                name: 'ML',
+            });
+            const result = tpl.render({ a: 'foo', b: 'bar' });
+            expect(result).toBe('Line 1: foo\nLine 2: bar\nDone.');
+        });
+        it('handles undefined values by leaving placeholder', () => {
+            const tpl = new template_1.PromptTemplate('{defined} {optional}', { name: 'Partial' });
+            expect(tpl.render({ defined: 'hello' })).toBe('hello {optional}');
+        });
+    });
+});
+//# sourceMappingURL=template.test.js.map

package/dist/__tests__/template.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.test.js","sourceRoot":"","sources":["../../src/__tests__/template.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export type { PromptMetadata } from './types';
+export { PromptTemplate } from './template';
+export { PromptRegistry } from './registry';
+export type { PromptEntry, PromptStore } from './stores/store.interface';
+export { MemoryStore } from './stores/memory.store';
+export { FileStore } from './stores/file.store';
+export type { FileStoreOptions } from './stores/file.store';
+export { RedisStore } from './stores/redis.store';
+export type { RedisAdapter, RedisStoreOptions } from './stores/redis.store';
+export { DatabaseStore } from './stores/database.store';
+export type { DatabaseAdapter, DatabaseStoreOptions } from './stores/database.store';
+export { MultiStore } from './stores/multi.store';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiStore = exports.DatabaseStore = exports.RedisStore = exports.FileStore = exports.MemoryStore = exports.PromptRegistry = exports.PromptTemplate = void 0;
+var template_1 = require("./template");
+Object.defineProperty(exports, "PromptTemplate", { enumerable: true, get: function () { return template_1.PromptTemplate; } });
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "PromptRegistry", { enumerable: true, get: function () { return registry_1.PromptRegistry; } });
+var memory_store_1 = require("./stores/memory.store");
+Object.defineProperty(exports, "MemoryStore", { enumerable: true, get: function () { return memory_store_1.MemoryStore; } });
+var file_store_1 = require("./stores/file.store");
+Object.defineProperty(exports, "FileStore", { enumerable: true, get: function () { return file_store_1.FileStore; } });
+var redis_store_1 = require("./stores/redis.store");
+Object.defineProperty(exports, "RedisStore", { enumerable: true, get: function () { return redis_store_1.RedisStore; } });
+var database_store_1 = require("./stores/database.store");
+Object.defineProperty(exports, "DatabaseStore", { enumerable: true, get: function () { return database_store_1.DatabaseStore; } });
+var multi_store_1 = require("./stores/multi.store");
+Object.defineProperty(exports, "MultiStore", { enumerable: true, get: function () { return multi_store_1.MultiStore; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AACvB,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AAIvB,sDAAoD;AAA3C,2GAAA,WAAW,OAAA;AACpB,kDAAgD;AAAvC,uGAAA,SAAS,OAAA;AAElB,oDAAkD;AAAzC,yGAAA,UAAU,OAAA;AAEnB,0DAAwD;AAA/C,+GAAA,aAAa,OAAA;AAEtB,oDAAkD;AAAzC,yGAAA,UAAU,OAAA"}

package/dist/registry.d.ts

@@ -0,0 +1,153 @@
+/**
+ * PromptRegistry
+ *
+ * A global static store that maps string keys to PromptTemplate instances.
+ *
+ * ## Sync API (unchanged, zero-cost, works at module load time)
+ * Built-in prompt files self-register at import time via `register()`.
+ * Application code reads prompts synchronously via `get()`.
+ * End-users swap any prompt with `override()` at startup.
+ *
+ * ## Store backends (optional, async)
+ * One or more `PromptStore` implementations can be configured to
+ * persist/load prompts from the file system, Redis, a database, or any
+ * combination via `MultiStore`.  The in-memory registry always acts as the
+ * runtime cache; stores are used for persistence and versioning.
+ *
+ * ## Versioning
+ * Every `PromptTemplate.metadata.version` is tracked in the version index.
+ * `get(key, version)` retrieves a specific cached version.
+ * `getAsync(key, version?)` falls back to configured stores when the version
+ * is not in the in-memory cache.
+ *
+ * Key naming convention: `package:scope:action`
+ *   e.g. `rag:graph:entity-extraction`, `agent:supervisor:routing`
+ *
+ * @example Startup override
+ * ```typescript
+ * import { PromptRegistry, PromptTemplate } from '@hazeljs/prompts';
+ *
+ * PromptRegistry.override('rag:graph:entity-extraction', new PromptTemplate(
+ *   'Extract entities from: {text}',
+ *   { name: 'Custom Extraction', version: '2.0.0' },
+ * ));
+ * ```
+ *
+ * @example Multiple store backends
+ * ```typescript
+ * import { PromptRegistry, FileStore, RedisStore, MultiStore } from '@hazeljs/prompts';
+ *
+ * PromptRegistry.configure([
+ *   new MultiStore([
+ *     new FileStore({ filePath: './prompts/library.json' }),
+ *     new RedisStore({ client: redisClient }),
+ *   ]),
+ * ]);
+ *
+ * await PromptRegistry.saveAll(); // persist current registry to all stores
+ * ```
+ */
+import { PromptTemplate } from './template';
+import type { PromptStore } from './stores/store.interface';
+export declare class PromptRegistry {
+    /** Latest version for each key. */
+    private static readonly latest;
+    /**
+     * All cached versions per key.
+     * Shape: `{ [key]: { [version]: PromptTemplate } }`
+     */
+    private static readonly versioned;
+    private static stores;
+    /**
+     * Replace the configured store list.
+     * Called once at application startup before prompts are loaded.
+     */
+    static configure(stores: PromptStore[]): void;
+    /**
+     * Append a single store to the list without replacing existing ones.
+     */
+    static addStore(store: PromptStore): void;
+    /** Returns the names of all configured stores (useful for diagnostics). */
+    static storeNames(): string[];
+    /**
+     * Register a prompt only if the key has not already been registered.
+     * Built-in prompt files call this so they don't clobber user overrides
+     * set before the module is imported.
+     */
+    static register<T extends object>(key: string, template: PromptTemplate<T>): void;
+    /**
+     * Override an existing (or register a new) prompt unconditionally.
+     * This is the entry point for end-user customisation.
+     */
+    static override<T extends object>(key: string, template: PromptTemplate<T>): void;
+    /**
+     * Retrieve a registered prompt by key.
+     *
+     * @param key - Registry key (e.g. `rag:graph:entity-extraction`).
+     * @param version - Optional specific version. Defaults to `'latest'`.
+     * @throws When the key (or requested version) is not found in the cache.
+     */
+    static get<T extends object>(key: string, version?: string): PromptTemplate<T>;
+    /** Returns `true` when a prompt is registered under the given key. */
+    static has(key: string, version?: string): boolean;
+    /** Returns all registered prompt keys (latest versions) in insertion order. */
+    static list(): string[];
+    /**
+     * Returns all cached version strings for a given key (excludes `'latest'`).
+     * Returns an empty array when the key is not registered.
+     */
+    static versions(key: string): string[];
+    /**
+     * Remove a prompt from the cache.
+     * Primarily useful in tests to reset state between test cases.
+     * Pass `version` to remove only that version; omit to remove all versions.
+     */
+    static unregister(key: string, version?: string): void;
+    /**
+     * Clear every registered prompt from the in-memory cache.
+     * Does NOT affect configured stores.
+     * Useful in tests; not recommended in production.
+     */
+    static clear(): void;
+    /**
+     * Retrieve a prompt by key, checking the in-memory cache first.
+     * Falls back to configured stores when the version is not cached.
+     * The loaded template is added to the in-memory cache for subsequent calls.
+     *
+     * @param key - Registry key.
+     * @param version - Specific version string; defaults to `'latest'`.
+     * @throws When the key is not found in the cache or any configured store.
+     */
+    static getAsync<T extends object>(key: string, version?: string): Promise<PromptTemplate<T>>;
+    /**
+     * Persist the in-memory prompt for `key` to all configured stores.
+     * @param key - Registry key.
+     * @param version - Specific cached version to persist; defaults to `'latest'` (current).
+     */
+    static save(key: string, version?: string): Promise<void>;
+    /**
+     * Persist ALL in-memory prompts (latest version of each) to all configured stores.
+     */
+    static saveAll(): Promise<void>;
+    /**
+     * Load ALL prompts from the primary configured store into the in-memory cache.
+     * Existing in-memory registrations are NOT overwritten (same behaviour as `register()`).
+     * Use `override()` after `loadAll()` to force-replace specific keys.
+     *
+     * @param overwrite - When `true`, loaded entries overwrite existing cache entries.
+     *                    Default: `false`.
+     */
+    static loadAll(overwrite?: boolean): Promise<void>;
+    /**
+     * Load a single prompt (optionally a specific version) from the first
+     * store that has it, cache it, and return it.
+     *
+     * @param key - Registry key.
+     * @param version - Specific version string; defaults to `'latest'`.
+     */
+    static load(key: string, version?: string): Promise<PromptTemplate<object> | null>;
+    private static setInMemory;
+    private static templateToEntry;
+    private static entryToTemplate;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,0BAA0B,CAAC;AAEzE,qBAAa,cAAc;IAGzB,mCAAmC;IAEnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAA0C;IAExE;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAI7B;IAIJ,OAAO,CAAC,MAAM,CAAC,MAAM,CAAqB;IAI1C;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAI7C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIzC,2EAA2E;IAC3E,MAAM,CAAC,UAAU,IAAI,MAAM,EAAE;IAM7B;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAMjF;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAIjF;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC;IAyB9E,sEAAsE;IACtE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAKlD,+EAA+E;IAC/E,MAAM,CAAC,IAAI,IAAI,MAAM,EAAE;IAIvB;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAMtC;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAStD;;;;OAIG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;IAOpB;;;;;;;;OAQG;WACU,QAAQ,CAAC,CAAC,SAAS,MAAM,EACpC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAuB7B;;;;OAIG;WACU,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D;;OAEG;WACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrC;;;;;;;OAOG;WACU,OAAO,CAAC,SAAS,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBtD;;;;;;OAMG;WACU,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAcxF,OAAO,CAAC,MAAM,CAAC,WAAW;IAU1B,OAAO,CAAC,MAAM,CAAC,eAAe;IAc9B,OAAO,CAAC,MAAM,CAAC,eAAe;CAG/B"}

package/dist/registry.js

@@ -0,0 +1,288 @@
+"use strict";
+/**
+ * PromptRegistry
+ *
+ * A global static store that maps string keys to PromptTemplate instances.
+ *
+ * ## Sync API (unchanged, zero-cost, works at module load time)
+ * Built-in prompt files self-register at import time via `register()`.
+ * Application code reads prompts synchronously via `get()`.
+ * End-users swap any prompt with `override()` at startup.
+ *
+ * ## Store backends (optional, async)
+ * One or more `PromptStore` implementations can be configured to
+ * persist/load prompts from the file system, Redis, a database, or any
+ * combination via `MultiStore`.  The in-memory registry always acts as the
+ * runtime cache; stores are used for persistence and versioning.
+ *
+ * ## Versioning
+ * Every `PromptTemplate.metadata.version` is tracked in the version index.
+ * `get(key, version)` retrieves a specific cached version.
+ * `getAsync(key, version?)` falls back to configured stores when the version
+ * is not in the in-memory cache.
+ *
+ * Key naming convention: `package:scope:action`
+ *   e.g. `rag:graph:entity-extraction`, `agent:supervisor:routing`
+ *
+ * @example Startup override
+ * ```typescript
+ * import { PromptRegistry, PromptTemplate } from '@hazeljs/prompts';
+ *
+ * PromptRegistry.override('rag:graph:entity-extraction', new PromptTemplate(
+ *   'Extract entities from: {text}',
+ *   { name: 'Custom Extraction', version: '2.0.0' },
+ * ));
+ * ```
+ *
+ * @example Multiple store backends
+ * ```typescript
+ * import { PromptRegistry, FileStore, RedisStore, MultiStore } from '@hazeljs/prompts';
+ *
+ * PromptRegistry.configure([
+ *   new MultiStore([
+ *     new FileStore({ filePath: './prompts/library.json' }),
+ *     new RedisStore({ client: redisClient }),
+ *   ]),
+ * ]);
+ *
+ * await PromptRegistry.saveAll(); // persist current registry to all stores
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptRegistry = void 0;
+const template_1 = require("./template");
+class PromptRegistry {
+    // ── Store configuration ───────────────────────────────────────────────────
+    /**
+     * Replace the configured store list.
+     * Called once at application startup before prompts are loaded.
+     */
+    static configure(stores) {
+        this.stores = [...stores];
+    }
+    /**
+     * Append a single store to the list without replacing existing ones.
+     */
+    static addStore(store) {
+        this.stores.push(store);
+    }
+    /** Returns the names of all configured stores (useful for diagnostics). */
+    static storeNames() {
+        return this.stores.map((s) => s.name);
+    }
+    // ── Sync API (fully backward-compatible) ──────────────────────────────────
+    /**
+     * Register a prompt only if the key has not already been registered.
+     * Built-in prompt files call this so they don't clobber user overrides
+     * set before the module is imported.
+     */
+    static register(key, template) {
+        if (!this.latest.has(key)) {
+            this.setInMemory(key, template);
+        }
+    }
+    /**
+     * Override an existing (or register a new) prompt unconditionally.
+     * This is the entry point for end-user customisation.
+     */
+    static override(key, template) {
+        this.setInMemory(key, template);
+    }
+    /**
+     * Retrieve a registered prompt by key.
+     *
+     * @param key - Registry key (e.g. `rag:graph:entity-extraction`).
+     * @param version - Optional specific version. Defaults to `'latest'`.
+     * @throws When the key (or requested version) is not found in the cache.
+     */
+    static get(key, version) {
+        if (version) {
+            const verMap = this.versioned.get(key);
+            const tpl = verMap?.get(version);
+            if (!tpl) {
+                throw new Error(`[PromptRegistry] Version "${version}" of prompt "${key}" not found in cache. ` +
+                    `Cached versions: ${[...(verMap?.keys() ?? [])].join(', ') || '(none)'}. ` +
+                    `Use getAsync() to load from a store backend.`);
+            }
+            return tpl;
+        }
+        const template = this.latest.get(key);
+        if (!template) {
+            throw new Error(`[PromptRegistry] Prompt not found: "${key}". ` +
+                `Make sure the prompt file is imported before calling get(). ` +
+                `Registered keys: ${[...this.latest.keys()].join(', ') || '(none)'}`);
+        }
+        return template;
+    }
+    /** Returns `true` when a prompt is registered under the given key. */
+    static has(key, version) {
+        if (version)
+            return this.versioned.get(key)?.has(version) ?? false;
+        return this.latest.has(key);
+    }
+    /** Returns all registered prompt keys (latest versions) in insertion order. */
+    static list() {
+        return [...this.latest.keys()];
+    }
+    /**
+     * Returns all cached version strings for a given key (excludes `'latest'`).
+     * Returns an empty array when the key is not registered.
+     */
+    static versions(key) {
+        const verMap = this.versioned.get(key);
+        if (!verMap)
+            return [];
+        return [...verMap.keys()].filter((v) => v !== 'latest').sort();
+    }
+    /**
+     * Remove a prompt from the cache.
+     * Primarily useful in tests to reset state between test cases.
+     * Pass `version` to remove only that version; omit to remove all versions.
+     */
+    static unregister(key, version) {
+        if (version) {
+            this.versioned.get(key)?.delete(version);
+        }
+        else {
+            this.latest.delete(key);
+            this.versioned.delete(key);
+        }
+    }
+    /**
+     * Clear every registered prompt from the in-memory cache.
+     * Does NOT affect configured stores.
+     * Useful in tests; not recommended in production.
+     */
+    static clear() {
+        this.latest.clear();
+        this.versioned.clear();
+    }
+    // ── Async store API ───────────────────────────────────────────────────────
+    /**
+     * Retrieve a prompt by key, checking the in-memory cache first.
+     * Falls back to configured stores when the version is not cached.
+     * The loaded template is added to the in-memory cache for subsequent calls.
+     *
+     * @param key - Registry key.
+     * @param version - Specific version string; defaults to `'latest'`.
+     * @throws When the key is not found in the cache or any configured store.
+     */
+    static async getAsync(key, version) {
+        const cached = this.latest.get(key);
+        if (!version && cached)
+            return cached;
+        if (version && this.versioned.get(key)?.has(version)) {
+            return this.versioned.get(key).get(version);
+        }
+        // Try each store in order
+        for (const store of this.stores) {
+            const entry = await store.get(key, version);
+            if (entry) {
+                const tpl = this.entryToTemplate(entry);
+                this.setInMemory(key, tpl);
+                return tpl;
+            }
+        }
+        throw new Error(`[PromptRegistry] Prompt "${key}"${version ? `@${version}` : ''} not found ` +
+            `in cache or any configured store (${this.stores.map((s) => s.name).join(', ') || 'none'}).`);
+    }
+    /**
+     * Persist the in-memory prompt for `key` to all configured stores.
+     * @param key - Registry key.
+     * @param version - Specific cached version to persist; defaults to `'latest'` (current).
+     */
+    static async save(key, version) {
+        const tpl = this.get(key, version);
+        const entry = this.templateToEntry(key, tpl, version);
+        await Promise.all(this.stores.map((s) => s.set(entry)));
+    }
+    /**
+     * Persist ALL in-memory prompts (latest version of each) to all configured stores.
+     */
+    static async saveAll() {
+        const tasks = [];
+        for (const key of this.latest.keys()) {
+            tasks.push(this.save(key));
+        }
+        await Promise.all(tasks);
+    }
+    /**
+     * Load ALL prompts from the primary configured store into the in-memory cache.
+     * Existing in-memory registrations are NOT overwritten (same behaviour as `register()`).
+     * Use `override()` after `loadAll()` to force-replace specific keys.
+     *
+     * @param overwrite - When `true`, loaded entries overwrite existing cache entries.
+     *                    Default: `false`.
+     */
+    static async loadAll(overwrite = false) {
+        if (this.stores.length === 0)
+            return;
+        const primaryStore = this.stores[0];
+        const keys = await primaryStore.keys();
+        await Promise.all(keys.map(async (key) => {
+            const entry = await primaryStore.get(key);
+            if (!entry)
+                return;
+            const tpl = this.entryToTemplate(entry);
+            if (overwrite) {
+                this.setInMemory(key, tpl);
+            }
+            else {
+                this.register(key, tpl);
+            }
+        }));
+    }
+    /**
+     * Load a single prompt (optionally a specific version) from the first
+     * store that has it, cache it, and return it.
+     *
+     * @param key - Registry key.
+     * @param version - Specific version string; defaults to `'latest'`.
+     */
+    static async load(key, version) {
+        for (const store of this.stores) {
+            const entry = await store.get(key, version);
+            if (entry) {
+                const tpl = this.entryToTemplate(entry);
+                this.setInMemory(key, tpl);
+                return tpl;
+            }
+        }
+        return null;
+    }
+    // ── Private helpers ───────────────────────────────────────────────────────
+    static setInMemory(key, template) {
+        this.latest.set(key, template);
+        // Track versioned entry
+        const ver = template.metadata.version ?? 'latest';
+        if (!this.versioned.has(key)) {
+            this.versioned.set(key, new Map());
+        }
+        this.versioned.get(key).set(ver, template);
+    }
+    static templateToEntry(key, template, version) {
+        return {
+            key,
+            version: version ?? template.metadata.version ?? 'latest',
+            template: template.template,
+            metadata: template.metadata,
+            storedAt: new Date().toISOString(),
+        };
+    }
+    static entryToTemplate(entry) {
+        return new template_1.PromptTemplate(entry.template, entry.metadata);
+    }
+}
+exports.PromptRegistry = PromptRegistry;
+// ── In-memory runtime cache ───────────────────────────────────────────────
+/** Latest version for each key. */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+PromptRegistry.latest = new Map();
+/**
+ * All cached versions per key.
+ * Shape: `{ [key]: { [version]: PromptTemplate } }`
+ */
+PromptRegistry.versioned = new Map();
+// ── Store backends ────────────────────────────────────────────────────────
+PromptRegistry.stores = [];
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/stores/database.store.d.ts

@@ -0,0 +1,93 @@
+import type { PromptEntry, PromptStore } from './store.interface';
+/**
+ * Minimal database adapter interface.
+ * Any ORM or raw database driver can implement this:
+ * Prisma, TypeORM, Knex, `pg`, `mysql2`, etc.
+ *
+ * Expected table / collection schema:
+ * ```sql
+ * CREATE TABLE prompt_entries (
+ *   key        TEXT    NOT NULL,
+ *   version    TEXT    NOT NULL DEFAULT 'latest',
+ *   template   TEXT    NOT NULL,
+ *   metadata   JSONB   NOT NULL,
+ *   stored_at  TEXT    NOT NULL,
+ *   PRIMARY KEY (key, version)
+ * );
+ * ```
+ *
+ * @example Using Prisma:
+ * ```typescript
+ * import { PrismaClient } from '@prisma/client';
+ * const prisma = new PrismaClient();
+ *
+ * PromptRegistry.addStore(new DatabaseStore({
+ *   adapter: {
+ *     findOne: ({ key, version }) =>
+ *       prisma.promptEntry.findUnique({ where: { key_version: { key, version } } }),
+ *     upsert: (entry) =>
+ *       prisma.promptEntry.upsert({
+ *         where: { key_version: { key: entry.key, version: entry.version } },
+ *         create: entry,
+ *         update: entry,
+ *       }),
+ *     remove: ({ key, version }) =>
+ *       version
+ *         ? prisma.promptEntry.deleteMany({ where: { key, version } })
+ *         : prisma.promptEntry.deleteMany({ where: { key } }),
+ *     findKeys: () => prisma.promptEntry.findMany({ select: { key: true } }),
+ *     findVersions: ({ key }) =>
+ *       prisma.promptEntry.findMany({ where: { key, NOT: { version: 'latest' } }, select: { version: true } }),
+ *   }
+ * }));
+ * ```
+ */
+export interface DatabaseAdapter {
+    /** Find one entry by key + version (defaults to `'latest'`). Returns null/undefined if not found. */
+    findOne(params: {
+        key: string;
+        version: string;
+    }): Promise<PromptEntry | null | undefined>;
+    /** Insert or update an entry. */
+    upsert(entry: PromptEntry): Promise<void>;
+    /** Delete entries. If `version` is absent, delete all versions of the key. */
+    remove(params: {
+        key: string;
+        version?: string;
+    }): Promise<void>;
+    /** Return all distinct keys. */
+    findKeys(): Promise<Array<{
+        key: string;
+    }>>;
+    /** Return all version strings for a given key (excluding `'latest'`). */
+    findVersions(params: {
+        key: string;
+    }): Promise<Array<{
+        version: string;
+    }>>;
+}
+export interface DatabaseStoreOptions {
+    /** Adapter that bridges the generic interface to your specific ORM/driver. */
+    adapter: DatabaseAdapter;
+}
+/**
+ * DatabaseStore
+ *
+ * Persists prompt entries to any relational or document database via a thin
+ * `DatabaseAdapter` interface.  No database driver is imported directly;
+ * you supply the adapter so the package stays dependency-free.
+ *
+ * @example See `DatabaseAdapter` JSDoc for a complete Prisma example.
+ */
+export declare class DatabaseStore implements PromptStore {
+    readonly name = "database";
+    private readonly adapter;
+    constructor(options: DatabaseStoreOptions);
+    get(key: string, version?: string): Promise<PromptEntry | undefined>;
+    set(entry: PromptEntry): Promise<void>;
+    delete(key: string, version?: string): Promise<void>;
+    has(key: string, version?: string): Promise<boolean>;
+    keys(): Promise<string[]>;
+    versions(key: string): Promise<string[]>;
+}
+//# sourceMappingURL=database.store.d.ts.map