mcp-architector 1.2.2 → 1.5.0

package/dist/migrate-scripts.js

@@ -0,0 +1,70 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { getProjectDir, isScriptsMigrated, setMigratedScriptsFlag, writeEntry, } from './storage.js';
+function getScriptsDir(projectId) {
+    return path.join(getProjectDir(projectId), 'scripts');
+}
+async function listLegacyScriptIds(projectId) {
+    try {
+        const files = await fs.readdir(getScriptsDir(projectId));
+        return files.filter((f) => f.endsWith('.json')).map((f) => f.replace('.json', ''));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+async function readLegacyScript(projectId, scriptId) {
+    try {
+        const content = await fs.readFile(path.join(getScriptsDir(projectId), `${scriptId}.json`), 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+export async function removeScriptsDirectory(projectId) {
+    await fs.rm(getScriptsDir(projectId), { recursive: true, force: true });
+}
+function scriptToEntry(script) {
+    return {
+        id: script.scriptId,
+        kind: 'script',
+        title: script.scriptName,
+        summary: script.description,
+        payload: {
+            usage: script.usage,
+            examples: script.examples,
+            parameters: script.parameters,
+            notes: script.notes ?? '',
+        },
+        tags: ['script', 'migrated'],
+        createdAt: script.createdAt,
+        updatedAt: script.updatedAt,
+    };
+}
+export async function migrateScriptsToEntries(projectId) {
+    if (await isScriptsMigrated(projectId)) {
+        await removeScriptsDirectory(projectId);
+        return { migrated: false, count: 0 };
+    }
+    const scriptIds = await listLegacyScriptIds(projectId);
+    let count = 0;
+    for (const scriptId of scriptIds) {
+        const script = await readLegacyScript(projectId, scriptId);
+        if (!script) {
+            continue;
+        }
+        await writeEntry(projectId, scriptToEntry(script));
+        count += 1;
+    }
+    await setMigratedScriptsFlag(projectId);
+    await removeScriptsDirectory(projectId);
+    return { migrated: count > 0, count };
+}
+//# sourceMappingURL=migrate-scripts.js.map

package/dist/migrate-scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-scripts.js","sourceRoot":"","sources":["../src/migrate-scripts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,GACX,MAAM,cAAc,CAAC;AAetB,SAAS,aAAa,CAAC,SAAiB;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;AACxD,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,SAAiB;IAClD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;QACzD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,SAAiB,EACjB,QAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAC/B,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,GAAG,QAAQ,OAAO,CAAC,EACvD,OAAO,CACR,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAA8B,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,SAAiB;IAC5D,MAAM,EAAE,CAAC,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,aAAa,CAAC,MAAiC;IACtD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,QAAQ;QACnB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,MAAM,CAAC,UAAU;QACxB,OAAO,EAAE,MAAM,CAAC,WAAW;QAC3B,OAAO,EAAE;YACP,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;SAC1B;QACD,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC5B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,SAAiB;IAI7D,IAAI,MAAM,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,MAAM,sBAAsB,CAAC,SAAS,CAAC,CAAC;QACxC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,SAAS;QACX,CAAC;QACD,MAAM,UAAU,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QACnD,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,MAAM,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAExC,OAAO,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;AACxC,CAAC"}

package/dist/slices.d.ts

@@ -0,0 +1,11 @@
+import type { BuiltinSliceInfo, Entry, EntryFilter, ProjectArchitecture, SliceBuildOptions, SliceDefinition, SliceResponse } from './types.js';
+export declare const BUILTIN_SLICES: BuiltinSliceInfo[];
+export declare function getBuiltinSlice(sliceId: string): BuiltinSliceInfo | undefined;
+export declare function resolveSliceFilter(sliceId: string, customSlice: SliceDefinition | null): EntryFilter | null;
+export declare function matchesEntryFilter(entry: Entry, filter: EntryFilter): boolean;
+export declare function clampLimit(limit?: number): number;
+export declare function buildSliceResponse(sliceId: string, sliceTitle: string, entries: Entry[], options: SliceBuildOptions, architecture: ProjectArchitecture | null): SliceResponse;
+export declare function countEntriesForKinds(indexItems: {
+    kind: string;
+}[], kinds: string[]): number;
+//# sourceMappingURL=slices.d.ts.map

package/dist/slices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slices.d.ts","sourceRoot":"","sources":["../src/slices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,KAAK,EACL,WAAW,EAEX,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EAEf,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,cAAc,EAAE,gBAAgB,EAqE5C,CAAC;AAKF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE7E;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,eAAe,GAAG,IAAI,GAClC,WAAW,GAAG,IAAI,CAYpB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAyB7E;AAgED,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,KAAK,EAAE,EAChB,OAAO,EAAE,iBAAiB,EAC1B,YAAY,EAAE,mBAAmB,GAAG,IAAI,GACvC,aAAa,CA4Df;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EAC9B,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,CAGR"}

package/dist/slices.js

@@ -0,0 +1,229 @@
+export const BUILTIN_SLICES = [
+    {
+        id: 'api',
+        title: 'API and entry points',
+        description: 'HTTP, gRPC, GraphQL, WebSocket, MCP tools/resources, CLI commands',
+        kinds: [
+            'http-endpoint',
+            'grpc-method',
+            'graphql-field',
+            'websocket-route',
+            'mcp-tool',
+            'mcp-resource',
+            'cli-command',
+        ],
+    },
+    {
+        id: 'persistence',
+        title: 'Persistence',
+        description: 'Tables, entities, repositories, migrations',
+        kinds: ['db-table', 'entity', 'repository', 'migration'],
+    },
+    {
+        id: 'events',
+        title: 'Events and messaging',
+        description: 'Events, topics, queues, messages',
+        kinds: ['event', 'topic', 'queue', 'message'],
+    },
+    {
+        id: 'domain',
+        title: 'Domain language',
+        description: 'Glossary, invariants, lifecycles',
+        kinds: ['glossary', 'invariant', 'lifecycle'],
+    },
+    {
+        id: 'flows',
+        title: 'Flows and scenarios',
+        description: 'End-to-end flows with steps in payload',
+        kinds: ['flow'],
+    },
+    {
+        id: 'integrations',
+        title: 'Integrations',
+        description: 'External systems and APIs',
+        kinds: ['integration', 'external-api'],
+    },
+    {
+        id: 'config',
+        title: 'Configuration',
+        description: 'Environment variables, feature flags, config keys',
+        kinds: ['env-var', 'feature-flag', 'config-key'],
+    },
+    {
+        id: 'runtime',
+        title: 'Runtime',
+        description: 'Services, entrypoints, scheduled jobs',
+        kinds: ['service', 'entrypoint', 'job'],
+    },
+    {
+        id: 'decisions',
+        title: 'Decisions and constraints',
+        description: 'ADRs and architectural constraints',
+        kinds: ['adr', 'constraint'],
+    },
+    {
+        id: 'scripts',
+        title: 'Scripts and commands',
+        description: 'Build, test, deploy commands (kind=script)',
+        kinds: ['script'],
+    },
+];
+const DEFAULT_LIMIT = 50;
+const MAX_LIMIT = 200;
+export function getBuiltinSlice(sliceId) {
+    return BUILTIN_SLICES.find((s) => s.id === sliceId);
+}
+export function resolveSliceFilter(sliceId, customSlice) {
+    const builtin = getBuiltinSlice(sliceId);
+    if (builtin) {
+        return { kinds: builtin.kinds };
+    }
+    if (customSlice && customSlice.id === sliceId) {
+        return {
+            kinds: customSlice.filter.kinds,
+            tags: customSlice.filter.tags,
+        };
+    }
+    return null;
+}
+export function matchesEntryFilter(entry, filter) {
+    if (filter.kinds?.length && !filter.kinds.includes(entry.kind)) {
+        return false;
+    }
+    if (filter.tags?.length) {
+        const entryTags = entry.tags ?? [];
+        if (!filter.tags.some((t) => entryTags.includes(t))) {
+            return false;
+        }
+    }
+    if (filter.query) {
+        const q = filter.query.trim().toLowerCase();
+        const haystack = [
+            entry.title,
+            entry.summary,
+            entry.kind,
+            ...(entry.tags ?? []),
+        ]
+            .join(' ')
+            .toLowerCase();
+        if (!haystack.includes(q)) {
+            return false;
+        }
+    }
+    return true;
+}
+function attachModuleContext(row, architecture) {
+    const moduleName = row.refs?.moduleName;
+    if (!moduleName || !architecture) {
+        return row;
+    }
+    const mod = architecture.modules.find((m) => m.name === moduleName);
+    if (!mod) {
+        return row;
+    }
+    return {
+        ...row,
+        moduleContext: { name: mod.name, description: mod.description },
+    };
+}
+function toCompactRow(entry) {
+    return {
+        id: entry.id,
+        kind: entry.kind,
+        title: entry.title,
+        summary: entry.summary,
+        refs: entry.refs?.files || entry.refs?.moduleName ? entry.refs : undefined,
+    };
+}
+function entryToTableRow(entry) {
+    const payload = entry.payload ?? {};
+    const apiKinds = new Set([
+        'http-endpoint',
+        'grpc-method',
+        'graphql-field',
+        'websocket-route',
+        'mcp-tool',
+        'mcp-resource',
+        'cli-command',
+    ]);
+    if (apiKinds.has(entry.kind)) {
+        return {
+            id: entry.id,
+            kind: entry.kind,
+            method: payload.method ?? '',
+            path: payload.path ?? entry.title,
+            summary: entry.summary,
+            files: entry.refs?.files ?? [],
+            moduleName: entry.refs?.moduleName ?? '',
+        };
+    }
+    return {
+        id: entry.id,
+        kind: entry.kind,
+        title: entry.title,
+        summary: entry.summary,
+        files: entry.refs?.files ?? [],
+        moduleName: entry.refs?.moduleName ?? '',
+    };
+}
+export function clampLimit(limit) {
+    if (limit === undefined || limit < 1) {
+        return DEFAULT_LIMIT;
+    }
+    return Math.min(limit, MAX_LIMIT);
+}
+export function buildSliceResponse(sliceId, sliceTitle, entries, options, architecture) {
+    const limit = clampLimit(options.limit);
+    const filtered = options.query
+        ? entries.filter((e) => matchesEntryFilter(e, { query: options.query }))
+        : entries;
+    const sorted = [...filtered].sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+    const slice = sorted.slice(0, limit);
+    if (options.format === 'detail') {
+        const items = options.includeModuleContext
+            ? slice.map((entry) => {
+                const row = toCompactRow(entry);
+                const withCtx = attachModuleContext(row, architecture);
+                return {
+                    ...entry,
+                    moduleContext: withCtx.moduleContext,
+                };
+            })
+            : slice;
+        return {
+            sliceId,
+            title: sliceTitle,
+            format: 'detail',
+            total: filtered.length,
+            returned: items.length,
+            items: items,
+        };
+    }
+    if (options.format === 'table') {
+        return {
+            sliceId,
+            title: sliceTitle,
+            format: 'table',
+            total: filtered.length,
+            returned: slice.length,
+            items: slice.map(entryToTableRow),
+        };
+    }
+    let items = slice.map(toCompactRow);
+    if (options.includeModuleContext) {
+        items = items.map((row) => attachModuleContext(row, architecture));
+    }
+    return {
+        sliceId,
+        title: sliceTitle,
+        format: 'compact',
+        total: filtered.length,
+        returned: items.length,
+        items,
+    };
+}
+export function countEntriesForKinds(indexItems, kinds) {
+    const kindSet = new Set(kinds);
+    return indexItems.filter((i) => kindSet.has(i.kind)).length;
+}
+//# sourceMappingURL=slices.js.map

package/dist/slices.js.map

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

package/dist/storage.d.ts

@@ -1,4 +1,5 @@
-import type { ProjectArchitecture, ModuleDetails, ScriptDocumentation } from './types.js';
+import type { Entry, EntryFilter, EntryIndex, EntryIndexItem, ProjectArchitecture, ModuleDetails, ProjectSummary, SliceDefinition } from './types.js';
+export declare function getStorageBaseDir(): string;
 /**
  * Get the storage directory for a specific project
  */
@@ -15,6 +16,25 @@ export declare function getModuleFile(projectId: string, moduleId: string): stri
  * Initialize storage for a project
  */
 export declare function initializeProjectStorage(projectId: string): Promise<void>;
+export declare function getEntriesDir(projectId: string): string;
+export declare function getEntryFile(projectId: string, entryId: string): string;
+export declare function getEntryIndexFile(projectId: string): string;
+export declare function getSliceFile(projectId: string, sliceId: string): string;
+export declare function readEntryIndex(projectId: string): Promise<EntryIndex>;
+export declare function readEntry(projectId: string, entryId: string): Promise<Entry | null>;
+export declare function writeEntry(projectId: string, entry: Entry): Promise<void>;
+export declare function deleteEntry(projectId: string, entryId: string): Promise<void>;
+export declare function listEntryIds(projectId: string): Promise<string[]>;
+export declare function findEntryByKindTitle(projectId: string, kind: string, title: string): Promise<Entry | null>;
+export declare function filterIndexItems(items: EntryIndexItem[], filter?: EntryFilter): EntryIndexItem[];
+export declare function loadEntries(projectId: string, filter?: EntryFilter): Promise<Entry[]>;
+export declare function rebuildEntryIndex(projectId: string): Promise<EntryIndex>;
+export declare function readSlice(projectId: string, sliceId: string): Promise<SliceDefinition | null>;
+export declare function writeSlice(projectId: string, slice: SliceDefinition): Promise<void>;
+export declare function deleteSlice(projectId: string, sliceId: string): Promise<void>;
+export declare function listSliceIds(projectId: string): Promise<string[]>;
+export declare function setMigratedScriptsFlag(projectId: string): Promise<void>;
+export declare function isScriptsMigrated(projectId: string): Promise<boolean>;
 /**
  * Read project architecture from storage
  */
@@ -39,22 +59,7 @@ export declare function listModules(projectId: string): Promise<string[]>;
  * Delete a module
  */
 export declare function deleteModule(projectId: string, moduleId: string): Promise<void>;
-/**
- * Get the path to a script documentation file
- */
-export declare function getScriptFile(projectId: string, scriptId: string): string;
-/**
- * Read script documentation from storage
- */
-export declare function readScript(projectId: string, scriptId: string): Promise<ScriptDocumentation | null>;
-/**
- * Write script documentation to storage
- */
-export declare function writeScript(projectId: string, scriptDoc: ScriptDocumentation): Promise<void>;
-/**
- * List all scripts in a project
- */
-export declare function listScripts(projectId: string): Promise<string[]>;
+export declare function listProjects(currentProjectId?: string | null, query?: string): Promise<ProjectSummary[]>;
 /**
  * Normalize project ID from workdir or user input
  */

package/dist/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAI1F;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzE;AAaD;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAW7F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAWnG;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAatE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASrF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAWzG;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAatE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3D"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}