@mycodemap/mycodemap 0.1.1 → 0.2.0

package/dist/infrastructure/storage/StorageFactory.js

@@ -0,0 +1,150 @@
+// [META] since:2026-03 | owner:architecture-team | stable:true
+// [WHY] Storage factory - creates appropriate storage backend based on configuration
+// ============================================
+// 存储工厂 - 根据配置创建适当的存储后端
+// ============================================
+import { StorageError } from './interfaces/StorageBase.js';
+import { FileSystemStorage } from './adapters/FileSystemStorage.js';
+import { MemoryStorage } from './adapters/MemoryStorage.js';
+// 延迟加载可选依赖
+let KuzuDBStorage = null;
+let Neo4jStorage = null;
+/**
+ * 异步加载 KùzuDB 存储适配器
+ */
+async function loadKuzuDBStorage() {
+    if (!KuzuDBStorage) {
+        const module = await import('./adapters/KuzuDBStorage.js');
+        KuzuDBStorage = module.KuzuDBStorage;
+    }
+    return KuzuDBStorage;
+}
+/**
+ * 异步加载 Neo4j 存储适配器
+ */
+async function loadNeo4jStorage() {
+    if (!Neo4jStorage) {
+        const module = await import('./adapters/Neo4jStorage.js');
+        Neo4jStorage = module.Neo4jStorage;
+    }
+    return Neo4jStorage;
+}
+/**
+ * 存储工厂实现
+ *
+ * 根据配置自动选择合适的存储后端：
+ * - filesystem: 文件系统存储（默认，无需额外依赖）
+ * - memory: 内存存储（用于测试）
+ * - kuzudb: KùzuDB 图数据库
+ * - neo4j: Neo4j 图数据库
+ * - auto: 根据项目规模自动选择
+ */
+export class StorageFactory {
+    /**
+     * 创建存储实例
+     * @param config - 存储配置
+     * @returns 存储实例
+     */
+    async create(config) {
+        const storageType = config.type === 'auto'
+            ? await this.determineStorageType(config)
+            : config.type;
+        switch (storageType) {
+            case 'filesystem':
+                return new FileSystemStorage(config);
+            case 'memory':
+                return new MemoryStorage();
+            case 'kuzudb': {
+                const KuzuStorage = await loadKuzuDBStorage();
+                if (!KuzuStorage) {
+                    throw new StorageError('KùzuDB storage adapter not available. Install with: npm install kuzu', 'ADAPTER_NOT_AVAILABLE');
+                }
+                return new KuzuStorage(config);
+            }
+            case 'neo4j': {
+                const Neo4jStorageClass = await loadNeo4jStorage();
+                if (!Neo4jStorageClass) {
+                    throw new StorageError('Neo4j storage adapter not available. Install with: npm install neo4j-driver', 'ADAPTER_NOT_AVAILABLE');
+                }
+                return new Neo4jStorageClass(config);
+            }
+            default:
+                throw new StorageError(`Unknown storage type: ${String(storageType)}`, 'UNKNOWN_STORAGE_TYPE');
+        }
+    }
+    /**
+     * 为项目创建存储实例
+     * @param projectPath - 项目路径
+     * @param config - 存储配置
+     * @returns 初始化的存储实例
+     */
+    async createForProject(projectPath, config) {
+        const storage = await this.create(config);
+        await storage.initialize(projectPath);
+        return storage;
+    }
+    /**
+     * 自动确定存储类型
+     *
+     * 策略：
+     * - 小项目（<100文件）: 文件系统
+     * - 中等项目（100-1000文件）: 文件系统
+     * - 大项目（>1000文件）: KùzuDB
+     *
+     * 可通过配置调整阈值
+     */
+    async determineStorageType(config) {
+        const thresholds = config.autoThresholds ?? {
+            useGraphDBWhenFileCount: 1000,
+            useGraphDBWhenNodeCount: 10000,
+        };
+        // 默认使用文件系统，因为它最简单可靠
+        // 实际项目分析后可能需要更复杂的启发式算法
+        return 'filesystem';
+    }
+    /**
+     * 检查存储类型是否可用
+     * @param type - 存储类型
+     * @returns 是否可用
+     */
+    static isStorageTypeAvailable(type) {
+        switch (type) {
+            case 'filesystem':
+            case 'memory':
+                return true;
+            case 'kuzudb':
+                // 检查 kuzu 包是否可用
+                try {
+                    require.resolve('kuzu');
+                    return true;
+                }
+                catch {
+                    return false;
+                }
+            case 'neo4j':
+                // 检查 neo4j-driver 包是否可用
+                try {
+                    require.resolve('neo4j-driver');
+                    return true;
+                }
+                catch {
+                    return false;
+                }
+            default:
+                return false;
+        }
+    }
+    /**
+     * 获取可用的存储类型列表
+     * @returns 可用存储类型数组
+     */
+    static getAvailableStorageTypes() {
+        const allTypes = ['filesystem', 'memory', 'kuzudb', 'neo4j'];
+        return allTypes.filter(type => StorageFactory.isStorageTypeAvailable(type));
+    }
+}
+/**
+ * 默认存储工厂实例
+ */
+export const storageFactory = new StorageFactory();
+//# sourceMappingURL=StorageFactory.js.map

package/dist/infrastructure/storage/StorageFactory.js.map

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

package/dist/infrastructure/storage/adapters/FileSystemStorage.d.ts

@@ -0,0 +1,52 @@
+import type { StorageConfig, Cycle, ImpactResult, ProjectStatistics } from '../../../interface/types/storage.js';
+import type { CodeGraph, Module, Symbol, Dependency } from '../../../interface/types/index.js';
+import { StorageBase } from '../interfaces/StorageBase.js';
+/**
+ * 文件系统存储适配器
+ *
+ * 特点：
+ * - 零依赖，开箱即用
+ * - 数据以 JSON 格式存储
+ * - 适合小到中型项目
+ * - 查询性能一般，但足够用于本地开发
+ */
+export declare class FileSystemStorage extends StorageBase {
+    private storageConfig;
+    readonly type: "filesystem";
+    /** 存储目录路径 */
+    private storageDir;
+    /** 主数据文件路径 */
+    private dataFilePath;
+    /** 缓存的代码图 */
+    private cachedGraph;
+    /** 缓存是否已修改 */
+    private cacheDirty;
+    constructor(storageConfig: StorageConfig);
+    protected doInitialize(): Promise<void>;
+    protected doClose(): Promise<void>;
+    saveCodeGraph(graph: CodeGraph): Promise<void>;
+    loadCodeGraph(): Promise<CodeGraph>;
+    deleteProject(): Promise<void>;
+    updateModule(module: Module): Promise<void>;
+    deleteModule(moduleId: string): Promise<void>;
+    findModuleById(id: string): Promise<Module | null>;
+    findModulesByPath(path: string): Promise<Module[]>;
+    findSymbolByName(name: string): Promise<Symbol[]>;
+    findSymbolById(id: string): Promise<Symbol | null>;
+    findDependencies(moduleId: string): Promise<Dependency[]>;
+    findDependents(moduleId: string): Promise<Dependency[]>;
+    findCallers(functionId: string): Promise<Symbol[]>;
+    findCallees(functionId: string): Promise<Symbol[]>;
+    detectCycles(): Promise<Cycle[]>;
+    calculateImpact(moduleId: string, depth: number): Promise<ImpactResult>;
+    getStatistics(): Promise<ProjectStatistics>;
+    /**
+     * 将代码图持久化到文件
+     */
+    private persistGraph;
+    /**
+     * 创建空代码图
+     */
+    private createEmptyGraph;
+}
+//# sourceMappingURL=FileSystemStorage.d.ts.map

package/dist/infrastructure/storage/adapters/FileSystemStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystemStorage.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/storage/adapters/FileSystemStorage.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,aAAa,EACb,KAAK,EACL,YAAY,EACZ,iBAAiB,EAClB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EACV,SAAS,EACT,MAAM,EACN,MAAM,EACN,UAAU,EACX,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAgB,MAAM,8BAA8B,CAAC;AAEzE;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAepC,OAAO,CAAC,aAAa;IAdjC,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;IAEtC,aAAa;IACb,OAAO,CAAC,UAAU,CAAuB;IAEzC,cAAc;IACd,OAAO,CAAC,YAAY,CAAuB;IAE3C,aAAa;IACb,OAAO,CAAC,WAAW,CAA0B;IAE7C,cAAc;IACd,OAAO,CAAC,UAAU,CAAS;gBAEP,aAAa,EAAE,aAAa;cAQhC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;cAoB7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAalC,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC;IA0BnC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB7C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMlD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMlD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMjD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMlD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAMzD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAMvD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAsBlD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBlD,YAAY,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IA+ChC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAsCvE,aAAa,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAmBjD;;OAEG;YACW,YAAY;IAkB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAczB"}

package/dist/infrastructure/storage/adapters/FileSystemStorage.js

@@ -0,0 +1,315 @@
+// [META] since:2026-03 | owner:architecture-team | stable:true
+// [WHY] FileSystem storage adapter - persists code graph to JSON files
+// ============================================
+// 文件系统存储适配器 - 将代码图持久化到 JSON 文件
+// ============================================
+import { writeFile, readFile, mkdir, rm } from 'fs/promises';
+import { join } from 'path';
+import { StorageBase, StorageError } from '../interfaces/StorageBase.js';
+/**
+ * 文件系统存储适配器
+ *
+ * 特点：
+ * - 零依赖，开箱即用
+ * - 数据以 JSON 格式存储
+ * - 适合小到中型项目
+ * - 查询性能一般，但足够用于本地开发
+ */
+export class FileSystemStorage extends StorageBase {
+    storageConfig;
+    type = 'filesystem';
+    /** 存储目录路径 */
+    storageDir = null;
+    /** 主数据文件路径 */
+    dataFilePath = null;
+    /** 缓存的代码图 */
+    cachedGraph = null;
+    /** 缓存是否已修改 */
+    cacheDirty = false;
+    constructor(storageConfig) {
+        super();
+        this.storageConfig = storageConfig;
+    }
+    // ============================================
+    // 生命周期管理
+    // ============================================
+    async doInitialize() {
+        if (!this.projectPath) {
+            throw new StorageError('Project path not set', 'PROJECT_PATH_NOT_SET');
+        }
+        // 确定存储目录
+        const defaultDir = join(this.projectPath, '.codemap', 'storage');
+        this.storageDir = this.storageConfig.outputPath
+            ? join(this.projectPath, this.storageConfig.outputPath)
+            : defaultDir;
+        this.dataFilePath = join(this.storageDir, 'codegraph.json');
+        // 确保存储目录存在
+        await mkdir(this.storageDir, { recursive: true });
+    }
+    async doClose() {
+        // 如果有未保存的更改，先保存
+        if (this.cacheDirty && this.cachedGraph) {
+            await this.persistGraph();
+        }
+        this.cachedGraph = null;
+        this.cacheDirty = false;
+    }
+    // ============================================
+    // 项目级别操作
+    // ============================================
+    async saveCodeGraph(graph) {
+        this.ensureInitialized();
+        this.cachedGraph = graph;
+        this.cacheDirty = true;
+        await this.persistGraph();
+    }
+    async loadCodeGraph() {
+        this.ensureInitialized();
+        // 优先使用缓存
+        if (this.cachedGraph) {
+            return this.cachedGraph;
+        }
+        // 尝试从文件加载
+        try {
+            const data = await readFile(this.dataFilePath, 'utf-8');
+            this.cachedGraph = JSON.parse(data);
+            return this.cachedGraph;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // 文件不存在，返回空图
+                return this.createEmptyGraph();
+            }
+            throw new StorageError('Failed to load code graph', 'LOAD_FAILED', error);
+        }
+    }
+    async deleteProject() {
+        this.ensureInitialized();
+        try {
+            await rm(this.storageDir, { recursive: true, force: true });
+            this.cachedGraph = null;
+            this.cacheDirty = false;
+        }
+        catch (error) {
+            throw new StorageError('Failed to delete project data', 'DELETE_FAILED', error);
+        }
+    }
+    // ============================================
+    // 增量更新
+    // ============================================
+    async updateModule(module) {
+        this.ensureInitialized();
+        const graph = await this.loadCodeGraph();
+        const index = graph.modules.findIndex(m => m.id === module.id);
+        if (index >= 0) {
+            graph.modules[index] = module;
+        }
+        else {
+            graph.modules.push(module);
+        }
+        this.cachedGraph = graph;
+        this.cacheDirty = true;
+        await this.persistGraph();
+    }
+    async deleteModule(moduleId) {
+        this.ensureInitialized();
+        const graph = await this.loadCodeGraph();
+        graph.modules = graph.modules.filter(m => m.id !== moduleId);
+        // 同时清理相关的符号和依赖关系
+        graph.symbols = graph.symbols.filter(s => s.moduleId !== moduleId);
+        graph.dependencies = graph.dependencies.filter(d => d.sourceId !== moduleId && d.targetId !== moduleId);
+        this.cachedGraph = graph;
+        this.cacheDirty = true;
+        await this.persistGraph();
+    }
+    // ============================================
+    // 查询操作
+    // ============================================
+    async findModuleById(id) {
+        this.ensureInitialized();
+        const graph = await this.loadCodeGraph();
+        return graph.modules.find(m => m.id === id) ?? null;
+    }
+    async findModulesByPath(path) {
+        this.ensureInitialized();
+        const graph = await this.loadCodeGraph();
+        return graph.modules.filter(m => m.path.includes(path));
+    }
+    async findSymbolByName(name) {
+        this.ensureInitialized();
+        const graph = await this.loadCodeGraph();
+        return graph.symbols.filter(s => s.name.includes(name));
+    }
+    async findSymbolById(id) {
+        this.ensureInitialized();
+        const graph = await this.loadCodeGraph();
+        return graph.symbols.find(s => s.id === id) ?? null;
+    }
+    async findDependencies(moduleId) {
+        this.ensureInitialized();
+        const graph = await this.loadCodeGraph();
+        return graph.dependencies.filter(d => d.sourceId === moduleId);
+    }
+    async findDependents(moduleId) {
+        this.ensureInitialized();
+        const graph = await this.loadCodeGraph();
+        return graph.dependencies.filter(d => d.targetId === moduleId);
+    }
+    async findCallers(functionId) {
+        this.ensureInitialized();
+        const graph = await this.loadCodeGraph();
+        // 查找从该函数出发的调用依赖
+        const callerIds = new Set();
+        for (const dep of graph.dependencies) {
+            if (dep.targetId === functionId && dep.type === 'call') {
+                callerIds.add(dep.sourceId);
+            }
+        }
+        // 返回对应的符号
+        const results = [];
+        for (const id of callerIds) {
+            const symbol = graph.symbols.find(s => s.id === id);
+            if (symbol)
+                results.push(symbol);
+        }
+        return results;
+    }
+    async findCallees(functionId) {
+        this.ensureInitialized();
+        const graph = await this.loadCodeGraph();
+        const calleeIds = new Set();
+        for (const dep of graph.dependencies) {
+            if (dep.sourceId === functionId && dep.type === 'call') {
+                calleeIds.add(dep.targetId);
+            }
+        }
+        const results = [];
+        for (const id of calleeIds) {
+            const symbol = graph.symbols.find(s => s.id === id);
+            if (symbol)
+                results.push(symbol);
+        }
+        return results;
+    }
+    // ============================================
+    // 分析操作
+    // ============================================
+    async detectCycles() {
+        this.ensureInitialized();
+        const graph = await this.loadCodeGraph();
+        // 使用 DFS 检测循环依赖
+        const cycles = [];
+        const visited = new Set();
+        const inStack = new Set();
+        const dfs = (nodeId, path) => {
+            if (inStack.has(nodeId)) {
+                // 发现循环
+                const cycleStart = path.indexOf(nodeId);
+                const cycleModules = path.slice(cycleStart);
+                cycles.push({
+                    modules: cycleModules,
+                    length: cycleModules.length,
+                });
+                return;
+            }
+            if (visited.has(nodeId)) {
+                return;
+            }
+            visited.add(nodeId);
+            inStack.add(nodeId);
+            // 遍历模块间的依赖
+            for (const dep of graph.dependencies) {
+                if (dep.sourceId === nodeId) {
+                    dfs(dep.targetId, [...path, nodeId]);
+                }
+            }
+            inStack.delete(nodeId);
+        };
+        for (const module of graph.modules) {
+            if (!visited.has(module.id)) {
+                dfs(module.id, []);
+            }
+        }
+        return cycles;
+    }
+    async calculateImpact(moduleId, depth) {
+        this.ensureInitialized();
+        const graph = await this.loadCodeGraph();
+        const affectedModules = [];
+        const visited = new Set();
+        const queue = [{ id: moduleId, level: 0 }];
+        while (queue.length > 0) {
+            const { id, level } = queue.shift();
+            if (visited.has(id) || level > depth) {
+                continue;
+            }
+            visited.add(id);
+            if (level > 0) {
+                const module = graph.modules.find(m => m.id === id);
+                if (module) {
+                    affectedModules.push(module);
+                }
+            }
+            // 查找依赖此模块的其他模块
+            for (const dep of graph.dependencies) {
+                if (dep.targetId === id && !visited.has(dep.sourceId)) {
+                    queue.push({ id: dep.sourceId, level: level + 1 });
+                }
+            }
+        }
+        return {
+            rootModule: moduleId,
+            affectedModules,
+            depth,
+        };
+    }
+    async getStatistics() {
+        this.ensureInitialized();
+        const graph = await this.loadCodeGraph();
+        const totalLines = graph.modules.reduce((sum, m) => sum + m.stats.lines, 0);
+        return {
+            totalModules: graph.modules.length,
+            totalSymbols: graph.symbols.length,
+            totalDependencies: graph.dependencies.length,
+            totalLines,
+            averageComplexity: 0, // MVP 阶段暂不计算
+        };
+    }
+    // ============================================
+    // 私有方法
+    // ============================================
+    /**
+     * 将代码图持久化到文件
+     */
+    async persistGraph() {
+        if (!this.cachedGraph || !this.dataFilePath) {
+            return;
+        }
+        try {
+            const data = JSON.stringify(this.cachedGraph, null, 2);
+            await writeFile(this.dataFilePath, data, 'utf-8');
+            this.cacheDirty = false;
+        }
+        catch (error) {
+            throw new StorageError('Failed to persist code graph', 'PERSIST_FAILED', error);
+        }
+    }
+    /**
+     * 创建空代码图
+     */
+    createEmptyGraph() {
+        return {
+            project: {
+                id: '',
+                name: '',
+                rootPath: this.projectPath ?? '',
+                createdAt: new Date(),
+                updatedAt: new Date(),
+            },
+            modules: [],
+            symbols: [],
+            dependencies: [],
+        };
+    }
+}
+//# sourceMappingURL=FileSystemStorage.js.map

package/dist/infrastructure/storage/adapters/FileSystemStorage.js.map

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

package/dist/infrastructure/storage/adapters/KuzuDBStorage.d.ts

@@ -0,0 +1,52 @@
+import type { StorageConfig, Cycle, ImpactResult, ProjectStatistics } from '../../../interface/types/storage.js';
+import type { CodeGraph, Module, Symbol, Dependency } from '../../../interface/types/index.js';
+import { StorageBase } from '../interfaces/StorageBase.js';
+/**
+ * KùzuDB 存储适配器（可选依赖）
+ *
+ * 安装：npm install kuzu
+ *
+ * 特点：
+ * - 嵌入式图数据库
+ * - 高性能图查询
+ * - 适合大型项目（>1000文件）
+ * - 支持复杂关系分析
+ *
+ * TODO-DEBT [L1] [日期:2026-03-17] [作者:AI] [原因:MVP阶段暂不实现完整功能]
+ * 问题：目前使用内存 fallback 实现
+ * 风险：无法持久化到 KùzuDB
+ * 偿还计划：V1.0 实现完整 KùzuDB 集成
+ */
+export declare class KuzuDBStorage extends StorageBase {
+    readonly type: "kuzudb";
+    /** KùzuDB 数据库实例 */
+    private db;
+    /** 连接实例 */
+    private conn;
+    /** 内存 fallback */
+    private memoryGraph;
+    /** 存储配置 */
+    private dbConfig;
+    constructor(config: StorageConfig);
+    protected doInitialize(): Promise<void>;
+    protected doClose(): Promise<void>;
+    saveCodeGraph(graph: CodeGraph): Promise<void>;
+    loadCodeGraph(): Promise<CodeGraph>;
+    deleteProject(): Promise<void>;
+    updateModule(module: Module): Promise<void>;
+    deleteModule(moduleId: string): Promise<void>;
+    findModuleById(id: string): Promise<Module | null>;
+    findModulesByPath(path: string): Promise<Module[]>;
+    findSymbolByName(name: string): Promise<Symbol[]>;
+    findSymbolById(id: string): Promise<Symbol | null>;
+    findDependencies(moduleId: string): Promise<Dependency[]>;
+    findDependents(moduleId: string): Promise<Dependency[]>;
+    findCallers(_functionId: string): Promise<Symbol[]>;
+    findCallees(_functionId: string): Promise<Symbol[]>;
+    detectCycles(): Promise<Cycle[]>;
+    calculateImpact(moduleId: string, depth: number): Promise<ImpactResult>;
+    getStatistics(): Promise<ProjectStatistics>;
+    private initializeSchema;
+    private createEmptyGraph;
+}
+//# sourceMappingURL=KuzuDBStorage.d.ts.map

package/dist/infrastructure/storage/adapters/KuzuDBStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KuzuDBStorage.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/storage/adapters/KuzuDBStorage.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,aAAa,EACb,KAAK,EACL,YAAY,EACZ,iBAAiB,EAClB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EACV,SAAS,EACT,MAAM,EACN,MAAM,EACN,UAAU,EACX,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAgB,MAAM,8BAA8B,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAElC,mBAAmB;IACnB,OAAO,CAAC,EAAE,CAAiB;IAE3B,WAAW;IACX,OAAO,CAAC,IAAI,CAAiB;IAE7B,kBAAkB;IAClB,OAAO,CAAC,WAAW,CAAsC;IAEzD,WAAW;IACX,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,MAAM,EAAE,aAAa;cASjB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;cAuB7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAYlC,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9C,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC;IAmBnC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB7C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAWlD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUlD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUjD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUlD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAUzD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAUvD,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKnD,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IASnD,YAAY,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAKhC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IASvE,aAAa,IAAI,OAAO,CAAC,iBAAiB,CAAC;YAgBnC,gBAAgB;IAQ9B,OAAO,CAAC,gBAAgB;CAczB"}