@generacy-ai/knowledge-store 0.0.0-preview-20260304013206

package/dist/portability/redaction.js

@@ -0,0 +1,128 @@
+/**
+ * Redaction transforms for different portability levels
+ */
+/**
+ * Org-specific domains that should be redacted
+ */
+const ORG_SPECIFIC_PATTERNS = [
+    /^company[:-]/i,
+    /^org[:-]/i,
+    /^internal[:-]/i,
+    /^proprietary[:-]/i,
+    /^confidential[:-]/i,
+];
+/**
+ * Check if a domain is org-specific
+ */
+function isOrgSpecific(domain) {
+    return ORG_SPECIFIC_PATTERNS.some((pattern) => pattern.test(domain));
+}
+/**
+ * Filter out org-specific domains
+ */
+function filterOrgDomains(domains) {
+    return domains.filter((d) => !isOrgSpecific(d));
+}
+/**
+ * Transform philosophy for export
+ */
+export function transformPhilosophy(philosophy, level) {
+    if (level === 'abstracted') {
+        // Anonymize identity
+        return {
+            values: philosophy.values,
+            beliefs: philosophy.beliefs.map((b) => ({
+                ...b,
+                domain: filterOrgDomains(b.domain),
+            })),
+            identity: {},
+        };
+    }
+    if (level === 'redacted') {
+        // Remove org-specific domains from beliefs
+        return {
+            values: philosophy.values,
+            beliefs: philosophy.beliefs.map((b) => ({
+                ...b,
+                domain: filterOrgDomains(b.domain),
+            })),
+            identity: philosophy.identity,
+        };
+    }
+    // Full - return as-is
+    return philosophy;
+}
+/**
+ * Transform principles for export
+ */
+export function transformPrinciples(principles, level) {
+    return principles
+        .filter((p) => p.status !== 'deprecated')
+        .map((p) => {
+        const domains = level === 'full' ? p.domain : filterOrgDomains(p.domain);
+        // Skip principles that are entirely org-specific
+        if (domains.length === 0 && p.domain.length > 0) {
+            return null;
+        }
+        const exported = {
+            id: p.id,
+            content: p.content,
+            domain: domains,
+            weight: p.weight,
+            evidenceCount: p.evidence.length,
+        };
+        if (level === 'full') {
+            exported.evidence = p.evidence;
+        }
+        else if (level === 'redacted') {
+            // Include evidence but redact context if it contains org info
+            exported.evidence = p.evidence.map((e) => ({
+                ...e,
+                context: e.context.replace(/\b(company|org|internal)\b/gi, '[REDACTED]'),
+            }));
+        }
+        // Abstracted - no evidence included
+        return exported;
+    })
+        .filter((p) => p !== null);
+}
+/**
+ * Transform patterns for export
+ */
+export function transformPatterns(patterns, level) {
+    if (level === 'abstracted') {
+        // Don't include patterns in abstracted export
+        return undefined;
+    }
+    return patterns
+        .filter((p) => p.status !== 'rejected')
+        .map((p) => {
+        const domains = level === 'full' ? p.domain : filterOrgDomains(p.domain);
+        if (domains.length === 0 && p.domain.length > 0) {
+            return null;
+        }
+        if (level === 'redacted') {
+            return {
+                ...p,
+                domain: domains,
+                occurrences: p.occurrences.map((o) => ({
+                    ...o,
+                    context: o.context.replace(/\b(company|org|internal)\b/gi, '[REDACTED]'),
+                })),
+            };
+        }
+        return p;
+    })
+        .filter((p) => p !== null);
+}
+/**
+ * Transform context for export
+ */
+export function transformContext(context, level) {
+    if (level === 'abstracted' || level === 'redacted') {
+        // Don't include context in redacted or abstracted
+        return undefined;
+    }
+    return context;
+}
+//# sourceMappingURL=redaction.js.map

package/dist/portability/redaction.js.map

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

package/dist/storage/AuditableStorage.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Auditable storage wrapper
+ * Adds audit trail logging to any StorageProvider
+ */
+import type { StorageProvider, VersionInfo } from '../types/storage.js';
+/**
+ * Audit log entry
+ */
+export interface AuditEntry {
+    timestamp: string;
+    action: 'set' | 'delete' | 'createVersion';
+    key: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Auditable storage wrapper that logs all modifications
+ */
+export declare class AuditableStorage implements StorageProvider {
+    private readonly storage;
+    private readonly auditPath;
+    private readonly enabled;
+    constructor(storage: StorageProvider, baseDir: string, enabled?: boolean);
+    /**
+     * Append an entry to the audit log
+     */
+    private appendAudit;
+    /**
+     * Get the audit log entries
+     */
+    getAuditLog(): Promise<AuditEntry[]>;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix: string): Promise<string[]>;
+    exists(key: string): Promise<boolean>;
+    getVersion<T>(key: string, version: number): Promise<T | null>;
+    listVersions(key: string): Promise<VersionInfo[]>;
+    createVersion(key: string): Promise<number>;
+    /**
+     * Get the underlying storage provider
+     */
+    getUnderlyingStorage(): StorageProvider;
+}
+//# sourceMappingURL=AuditableStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AuditableStorage.d.ts","sourceRoot":"","sources":["../../src/storage/AuditableStorage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,eAAe,CAAC;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,eAAe;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAGhC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAc;IAOzB;;OAEG;YACW,WAAW;IA2BzB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAWpC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAItC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAI9D,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAIjD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWjD;;OAEG;IACH,oBAAoB,IAAI,eAAe;CAGxC"}

package/dist/storage/AuditableStorage.js

@@ -0,0 +1,109 @@
+/**
+ * Auditable storage wrapper
+ * Adds audit trail logging to any StorageProvider
+ */
+import { promises as fs } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { now } from '../utils/timestamps.js';
+/**
+ * Auditable storage wrapper that logs all modifications
+ */
+export class AuditableStorage {
+    storage;
+    auditPath;
+    enabled;
+    constructor(storage, baseDir, enabled = true) {
+        this.storage = storage;
+        this.auditPath = join(baseDir, 'audit.json');
+        this.enabled = enabled;
+    }
+    /**
+     * Append an entry to the audit log
+     */
+    async appendAudit(entry) {
+        if (!this.enabled)
+            return;
+        try {
+            await fs.mkdir(dirname(this.auditPath), { recursive: true });
+            let entries = [];
+            try {
+                const data = await fs.readFile(this.auditPath, 'utf-8');
+                entries = JSON.parse(data);
+            }
+            catch {
+                // File doesn't exist or is invalid, start fresh
+            }
+            entries.push(entry);
+            // Keep only last 1000 entries
+            if (entries.length > 1000) {
+                entries = entries.slice(-1000);
+            }
+            await fs.writeFile(this.auditPath, JSON.stringify(entries, null, 2), 'utf-8');
+        }
+        catch {
+            // Audit logging should not fail the operation
+        }
+    }
+    /**
+     * Get the audit log entries
+     */
+    async getAuditLog() {
+        try {
+            const data = await fs.readFile(this.auditPath, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch {
+            return [];
+        }
+    }
+    // StorageProvider implementation
+    async get(key) {
+        return this.storage.get(key);
+    }
+    async set(key, value) {
+        await this.storage.set(key, value);
+        await this.appendAudit({
+            timestamp: now(),
+            action: 'set',
+            key,
+            details: { type: typeof value },
+        });
+    }
+    async delete(key) {
+        await this.storage.delete(key);
+        await this.appendAudit({
+            timestamp: now(),
+            action: 'delete',
+            key,
+        });
+    }
+    async list(prefix) {
+        return this.storage.list(prefix);
+    }
+    async exists(key) {
+        return this.storage.exists(key);
+    }
+    async getVersion(key, version) {
+        return this.storage.getVersion(key, version);
+    }
+    async listVersions(key) {
+        return this.storage.listVersions(key);
+    }
+    async createVersion(key) {
+        const version = await this.storage.createVersion(key);
+        await this.appendAudit({
+            timestamp: now(),
+            action: 'createVersion',
+            key,
+            details: { version },
+        });
+        return version;
+    }
+    /**
+     * Get the underlying storage provider
+     */
+    getUnderlyingStorage() {
+        return this.storage;
+    }
+}
+//# sourceMappingURL=AuditableStorage.js.map

package/dist/storage/AuditableStorage.js.map

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

package/dist/storage/LocalFileStorage.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Local file-based storage provider
+ * Implements atomic writes using temp file + rename pattern
+ */
+import type { StorageProvider, VersionInfo } from '../types/storage.js';
+/**
+ * Local file storage implementation
+ * Stores data as JSON files in the filesystem
+ */
+export declare class LocalFileStorage implements StorageProvider {
+    private readonly baseDir;
+    constructor(baseDir: string);
+    /**
+     * Get the full file path for a key
+     */
+    private getPath;
+    /**
+     * Get the version directory for a key
+     */
+    private getVersionDir;
+    /**
+     * Get the version file path
+     */
+    private getVersionPath;
+    /**
+     * Ensure a directory exists
+     */
+    private ensureDir;
+    /**
+     * Get a value by key
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Set a value by key using atomic write (temp file + rename)
+     */
+    set<T>(key: string, value: T): Promise<void>;
+    /**
+     * Delete a value by key
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * List all keys with a given prefix
+     */
+    list(prefix: string): Promise<string[]>;
+    /**
+     * Check if a key exists
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * Get a specific version of a value
+     */
+    getVersion<T>(key: string, version: number): Promise<T | null>;
+    /**
+     * List all versions for a key
+     */
+    listVersions(key: string): Promise<VersionInfo[]>;
+    /**
+     * Create a new version for a key (copies current value to version file)
+     * Returns the new version number
+     */
+    createVersion(key: string): Promise<number>;
+}
+//# sourceMappingURL=LocalFileStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LocalFileStorage.d.ts","sourceRoot":"","sources":["../../src/storage/LocalFileStorage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGxE;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,eAAe;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,MAAM;IAI3B;;OAEG;IACH,OAAO,CAAC,OAAO;IAIf;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;YACW,SAAS;IAIvB;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAkB5C;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBlD;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxC;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgC7C;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU3C;;OAEG;IACG,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAkBpE;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAwCvD;;;OAGG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAsClD"}

package/dist/storage/LocalFileStorage.js

@@ -0,0 +1,219 @@
+/**
+ * Local file-based storage provider
+ * Implements atomic writes using temp file + rename pattern
+ */
+import { promises as fs } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { StorageError } from './StorageProvider.js';
+/**
+ * Local file storage implementation
+ * Stores data as JSON files in the filesystem
+ */
+export class LocalFileStorage {
+    baseDir;
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+    }
+    /**
+     * Get the full file path for a key
+     */
+    getPath(key) {
+        return join(this.baseDir, `${key}.json`);
+    }
+    /**
+     * Get the version directory for a key
+     */
+    getVersionDir(key) {
+        return join(this.baseDir, 'versions', key);
+    }
+    /**
+     * Get the version file path
+     */
+    getVersionPath(key, version) {
+        return join(this.getVersionDir(key), `v${version}.json`);
+    }
+    /**
+     * Ensure a directory exists
+     */
+    async ensureDir(path) {
+        await fs.mkdir(dirname(path), { recursive: true });
+    }
+    /**
+     * Get a value by key
+     */
+    async get(key) {
+        const path = this.getPath(key);
+        try {
+            const data = await fs.readFile(path, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            throw new StorageError(`Failed to read key: ${key}`, 'get', key, error);
+        }
+    }
+    /**
+     * Set a value by key using atomic write (temp file + rename)
+     */
+    async set(key, value) {
+        const path = this.getPath(key);
+        const tempPath = `${path}.tmp.${Date.now()}`;
+        try {
+            await this.ensureDir(path);
+            const data = JSON.stringify(value, null, 2);
+            await fs.writeFile(tempPath, data, 'utf-8');
+            await fs.rename(tempPath, path);
+        }
+        catch (error) {
+            // Clean up temp file if it exists
+            try {
+                await fs.unlink(tempPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw new StorageError(`Failed to write key: ${key}`, 'set', key, error);
+        }
+    }
+    /**
+     * Delete a value by key
+     */
+    async delete(key) {
+        const path = this.getPath(key);
+        try {
+            await fs.unlink(path);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw new StorageError(`Failed to delete key: ${key}`, 'delete', key, error);
+            }
+        }
+    }
+    /**
+     * List all keys with a given prefix
+     */
+    async list(prefix) {
+        const searchDir = join(this.baseDir, dirname(prefix));
+        const filePrefix = prefix.split('/').pop() || '';
+        try {
+            const entries = await fs.readdir(searchDir, { withFileTypes: true });
+            return entries
+                .filter((entry) => {
+                if (!entry.isFile() || !entry.name.endsWith('.json')) {
+                    return false;
+                }
+                const keyName = entry.name.replace('.json', '');
+                return keyName.startsWith(filePrefix);
+            })
+                .map((entry) => {
+                const relativePath = dirname(prefix);
+                const keyName = entry.name.replace('.json', '');
+                return relativePath === '.' ? keyName : `${relativePath}/${keyName}`;
+            });
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return [];
+            }
+            throw new StorageError(`Failed to list keys with prefix: ${prefix}`, 'list', prefix, error);
+        }
+    }
+    /**
+     * Check if a key exists
+     */
+    async exists(key) {
+        const path = this.getPath(key);
+        try {
+            await fs.access(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get a specific version of a value
+     */
+    async getVersion(key, version) {
+        const path = this.getVersionPath(key, version);
+        try {
+            const data = await fs.readFile(path, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            throw new StorageError(`Failed to read version ${version} for key: ${key}`, 'getVersion', key, error);
+        }
+    }
+    /**
+     * List all versions for a key
+     */
+    async listVersions(key) {
+        const versionDir = this.getVersionDir(key);
+        try {
+            const entries = await fs.readdir(versionDir, { withFileTypes: true });
+            const versions = [];
+            for (const entry of entries) {
+                if (!entry.isFile() || !entry.name.startsWith('v') || !entry.name.endsWith('.json')) {
+                    continue;
+                }
+                const versionStr = entry.name.replace('v', '').replace('.json', '');
+                const version = parseInt(versionStr, 10);
+                if (isNaN(version)) {
+                    continue;
+                }
+                const filePath = join(versionDir, entry.name);
+                const stat = await fs.stat(filePath);
+                versions.push({
+                    version,
+                    timestamp: stat.mtime.toISOString(),
+                    size: stat.size,
+                });
+            }
+            return versions.sort((a, b) => a.version - b.version);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return [];
+            }
+            throw new StorageError(`Failed to list versions for key: ${key}`, 'listVersions', key, error);
+        }
+    }
+    /**
+     * Create a new version for a key (copies current value to version file)
+     * Returns the new version number
+     */
+    async createVersion(key) {
+        const current = await this.get(key);
+        if (current === null) {
+            throw new StorageError(`Cannot create version for non-existent key: ${key}`, 'createVersion', key);
+        }
+        const versions = await this.listVersions(key);
+        const newVersion = versions.length > 0
+            ? Math.max(...versions.map((v) => v.version)) + 1
+            : 1;
+        const versionPath = this.getVersionPath(key, newVersion);
+        const tempPath = `${versionPath}.tmp.${Date.now()}`;
+        try {
+            await this.ensureDir(versionPath);
+            const data = JSON.stringify(current, null, 2);
+            await fs.writeFile(tempPath, data, 'utf-8');
+            await fs.rename(tempPath, versionPath);
+            return newVersion;
+        }
+        catch (error) {
+            try {
+                await fs.unlink(tempPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw new StorageError(`Failed to create version for key: ${key}`, 'createVersion', key, error);
+        }
+    }
+}
+//# sourceMappingURL=LocalFileStorage.js.map

package/dist/storage/LocalFileStorage.js.map

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

package/dist/storage/StorageProvider.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Abstract storage provider interface
+ * Defines the contract for all storage implementations
+ */
+import type { StorageProvider, VersionInfo } from '../types/storage.js';
+export type { StorageProvider, VersionInfo };
+/**
+ * Error thrown when a storage operation fails
+ */
+export declare class StorageError extends Error {
+    readonly operation: string;
+    readonly key?: string | undefined;
+    readonly cause?: Error | undefined;
+    constructor(message: string, operation: string, key?: string | undefined, cause?: Error | undefined);
+}
+/**
+ * Error thrown when a key is not found
+ */
+export declare class KeyNotFoundError extends StorageError {
+    constructor(key: string);
+}
+/**
+ * Error thrown when a version is not found
+ */
+export declare class VersionNotFoundError extends StorageError {
+    constructor(key: string, version: number);
+}
+//# sourceMappingURL=StorageProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StorageProvider.d.ts","sourceRoot":"","sources":["../../src/storage/StorageProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAExE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC;AAE7C;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGnB,SAAS,EAAE,MAAM;aACjB,GAAG,CAAC,EAAE,MAAM;aACZ,KAAK,CAAC,EAAE,KAAK;gBAH7B,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,YAAA,EACZ,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;gBACpC,GAAG,EAAE,MAAM;CAIxB;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIzC"}

package/dist/storage/StorageProvider.js

@@ -0,0 +1,38 @@
+/**
+ * Abstract storage provider interface
+ * Defines the contract for all storage implementations
+ */
+/**
+ * Error thrown when a storage operation fails
+ */
+export class StorageError extends Error {
+    operation;
+    key;
+    cause;
+    constructor(message, operation, key, cause) {
+        super(message);
+        this.operation = operation;
+        this.key = key;
+        this.cause = cause;
+        this.name = 'StorageError';
+    }
+}
+/**
+ * Error thrown when a key is not found
+ */
+export class KeyNotFoundError extends StorageError {
+    constructor(key) {
+        super(`Key not found: ${key}`, 'get', key);
+        this.name = 'KeyNotFoundError';
+    }
+}
+/**
+ * Error thrown when a version is not found
+ */
+export class VersionNotFoundError extends StorageError {
+    constructor(key, version) {
+        super(`Version ${version} not found for key: ${key}`, 'getVersion', key);
+        this.name = 'VersionNotFoundError';
+    }
+}
+//# sourceMappingURL=StorageProvider.js.map

package/dist/storage/StorageProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageProvider.js","sourceRoot":"","sources":["../../src/storage/StorageProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAGnB;IACA;IACA;IAJlB,YACE,OAAe,EACC,SAAiB,EACjB,GAAY,EACZ,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,cAAS,GAAT,SAAS,CAAQ;QACjB,QAAG,GAAH,GAAG,CAAS;QACZ,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAChD,YAAY,GAAW;QACrB,KAAK,CAAC,kBAAkB,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD,YAAY,GAAW,EAAE,OAAe;QACtC,KAAK,CAAC,WAAW,OAAO,uBAAuB,GAAG,EAAE,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}