@opensip-cli/graph 0.1.0

package/dist/__tests__/persistence/session-replay.test.js

@@ -0,0 +1,196 @@
+/**
+ * Unit tests for {@link graphReplayFromSession} (coverage gap).
+ *
+ * `session-payload.ts` (encode) and `session-replay.ts` (decode) are inverses,
+ * so the happy path is a round-trip: `Signal[]` → `buildGraphSessionPayload` →
+ * stored payload → `graphReplayFromSession`. The remaining tests drive each
+ * validation branch directly with malformed payloads.
+ */
+import { describe, expect, it } from 'vitest';
+import { buildGraphSessionPayload } from '../../persistence/session-payload.js';
+import { graphReplayFromSession } from '../../persistence/session-replay.js';
+function sig(over) {
+    return {
+        id: `sig_${over.ruleId}`,
+        source: 'graph',
+        provider: 'opensip-cli',
+        category: 'architecture',
+        message: `${over.severity} ${over.ruleId}`,
+        metadata: {},
+        createdAt: '2026-06-08T00:00:00.000Z',
+        ...over,
+    };
+}
+function storedSession(payload, overrides = {}) {
+    return {
+        id: 'GRAPH_1',
+        tool: 'graph',
+        cwd: '/repo',
+        startedAt: '2026-06-08T00:00:00.000Z',
+        completedAt: '2026-06-08T00:00:00.000Z',
+        score: 80,
+        passed: false,
+        durationMs: 99,
+        payload,
+        ...overrides,
+    };
+}
+describe('graphReplayFromSession', () => {
+    it('round-trips a stored payload back into a projection envelope + graph-done result', () => {
+        const payload = buildGraphSessionPayload([
+            sig({
+                ruleId: 'graph:god-file',
+                severity: 'high',
+                filePath: 'a.ts',
+                line: 1,
+                column: 2,
+                suggestion: 'split it',
+                metadata: { fanIn: 12, label: 'big', flagged: true },
+            }),
+            sig({ ruleId: 'graph:dup-body', severity: 'low', filePath: 'b.ts' }),
+        ]);
+        const replay = graphReplayFromSession(storedSession(payload));
+        expect(replay.fidelity).toBe('projection');
+        expect(replay.envelope.tool).toBe('graph');
+        expect(replay.envelope.runId).toBe('GRAPH_1');
+        expect(replay.envelope.signals.map((s) => s.severity)).toEqual(['high', 'medium']);
+        const located = replay.envelope.signals.find((s) => s.ruleId === 'graph:god-file');
+        expect(located?.code).toEqual({ file: 'a.ts', line: 1, column: 2 });
+        expect(located?.suggestion).toBe('split it');
+        expect(located?.metadata).toEqual({ fanIn: 12, label: 'big', flagged: true });
+        expect(replay.result.type).toBe('graph-done');
+        expect(replay.result.summary).toEqual({ passed: 1, failed: 1, errors: 1, warnings: 1 });
+        expect(replay.result.durationMs).toBe(99);
+    });
+    it('carries recipe onto the envelope when present', () => {
+        const payload = buildGraphSessionPayload([]);
+        const replay = graphReplayFromSession(storedSession(payload, { recipe: 'example' }));
+        expect(replay.envelope.recipe).toBe('example');
+    });
+    it('preserves a finding with no optional location fields', () => {
+        const payload = {
+            summary: { total: 1, passed: 0, failed: 1, errors: 1, warnings: 0 },
+            checks: [
+                {
+                    checkSlug: 'graph:r',
+                    passed: false,
+                    violationCount: 1,
+                    durationMs: 0,
+                    findings: [{ ruleId: 'r', message: 'm', severity: 'error', filePath: 'x.ts' }],
+                },
+            ],
+        };
+        const replay = graphReplayFromSession(storedSession(payload));
+        const signal = replay.envelope.signals[0];
+        expect(signal?.line).toBeUndefined();
+        expect(signal?.code).toEqual({ file: 'x.ts' });
+        expect(signal?.metadata).toEqual({});
+    });
+    it('drops non-scalar metadata entries and an all-empty metadata bag', () => {
+        const payload = {
+            summary: { total: 1, passed: 0, failed: 1, errors: 1, warnings: 0 },
+            checks: [
+                {
+                    checkSlug: 'graph:r',
+                    passed: false,
+                    violationCount: 1,
+                    durationMs: 0,
+                    findings: [
+                        {
+                            ruleId: 'r',
+                            message: 'm',
+                            severity: 'error',
+                            filePath: 'x.ts',
+                            metadata: { keep: 'yes', drop: { nested: true } },
+                        },
+                    ],
+                },
+            ],
+        };
+        const replay = graphReplayFromSession(storedSession(payload));
+        expect(replay.envelope.signals[0]?.metadata).toEqual({ keep: 'yes' });
+    });
+    describe('payload validation', () => {
+        const cases = [
+            { name: 'null payload', payload: null, message: /no replay payload/ },
+            { name: 'missing summary', payload: { checks: [] }, message: /summary is missing/ },
+            {
+                name: 'non-number summary field',
+                payload: {
+                    summary: { total: 'x', passed: 0, failed: 0, errors: 0, warnings: 0 },
+                    checks: [],
+                },
+                message: /total must be a number/,
+            },
+            {
+                name: 'missing checks[]',
+                payload: { summary: { total: 0, passed: 0, failed: 0, errors: 0, warnings: 0 } },
+                message: /missing checks\[\]/,
+            },
+            {
+                name: 'invalid check row',
+                payload: {
+                    summary: { total: 0, passed: 0, failed: 0, errors: 0, warnings: 0 },
+                    checks: [null],
+                },
+                message: /check row is invalid/,
+            },
+            {
+                name: 'check missing findings[]',
+                payload: {
+                    summary: { total: 0, passed: 0, failed: 0, errors: 0, warnings: 0 },
+                    checks: [{ checkSlug: 'a', passed: true, violationCount: 0, durationMs: 0 }],
+                },
+                message: /missing findings\[\]/,
+            },
+            {
+                name: 'invalid finding row',
+                payload: {
+                    summary: { total: 0, passed: 0, failed: 0, errors: 0, warnings: 0 },
+                    checks: [
+                        { checkSlug: 'a', passed: true, violationCount: 1, durationMs: 0, findings: [42] },
+                    ],
+                },
+                message: /finding is invalid/,
+            },
+            {
+                name: 'invalid finding severity',
+                payload: {
+                    summary: { total: 0, passed: 0, failed: 0, errors: 0, warnings: 0 },
+                    checks: [
+                        {
+                            checkSlug: 'a',
+                            passed: true,
+                            violationCount: 1,
+                            durationMs: 0,
+                            findings: [{ ruleId: 'r', message: 'm', severity: 'info', filePath: 'x.ts' }],
+                        },
+                    ],
+                },
+                message: /invalid severity/,
+            },
+            {
+                name: 'finding missing filePath',
+                payload: {
+                    summary: { total: 0, passed: 0, failed: 0, errors: 0, warnings: 0 },
+                    checks: [
+                        {
+                            checkSlug: 'a',
+                            passed: true,
+                            violationCount: 1,
+                            durationMs: 0,
+                            findings: [{ ruleId: 'r', message: 'm', severity: 'error' }],
+                        },
+                    ],
+                },
+                message: /filePath must be a string/,
+            },
+        ];
+        for (const { name, payload, message } of cases) {
+            it(`throws on ${name}`, () => {
+                expect(() => graphReplayFromSession(storedSession(payload))).toThrow(message);
+            });
+        }
+    });
+});
+//# sourceMappingURL=session-replay.test.js.map

package/dist/__tests__/persistence/session-replay.test.js.map

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

package/dist/__tests__/public-api.test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Export-surface lock for `@opensip-cli/graph`.
+ *
+ * The public barrel is the marketplace contract surface: `graphTool` plus the
+ * `GraphLanguageAdapter` authoring API (adapter registry, edge/body-digest
+ * helpers, recipe/rule authoring) that external adapter packs consume. This
+ * test pins the exact set of **runtime (value) exports** so the barrel cannot
+ * silently re-grow to leak engine internals — the regression the 2026-06-05
+ * boundary audit found, where the concrete `CatalogRepo` persistence repo sat
+ * on the contract with no external consumer (now demoted to
+ * `@opensip-cli/graph/internal`).
+ *
+ * Scope note: type-only exports are erased at runtime and cannot be asserted
+ * here. Adding a *value* export to the barrel is a deliberate minor-version act
+ * and must be reflected in EXPECTED below (and in the package catalog);
+ * removing one is a major change.
+ */
+export {};
+//# sourceMappingURL=public-api.test.d.ts.map

package/dist/__tests__/public-api.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/public-api.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/__tests__/public-api.test.js

@@ -0,0 +1,96 @@
+/**
+ * Export-surface lock for `@opensip-cli/graph`.
+ *
+ * The public barrel is the marketplace contract surface: `graphTool` plus the
+ * `GraphLanguageAdapter` authoring API (adapter registry, edge/body-digest
+ * helpers, recipe/rule authoring) that external adapter packs consume. This
+ * test pins the exact set of **runtime (value) exports** so the barrel cannot
+ * silently re-grow to leak engine internals — the regression the 2026-06-05
+ * boundary audit found, where the concrete `CatalogRepo` persistence repo sat
+ * on the contract with no external consumer (now demoted to
+ * `@opensip-cli/graph/internal`).
+ *
+ * Scope note: type-only exports are erased at runtime and cannot be asserted
+ * here. Adding a *value* export to the barrel is a deliberate minor-version act
+ * and must be reflected in EXPECTED below (and in the package catalog);
+ * removing one is a major change.
+ */
+import { describe, expect, it } from 'vitest';
+import * as barrel from '../index.js';
+/** The complete, intended set of runtime value exports. Keep alphabetised. */
+const EXPECTED_VALUE_EXPORTS = [
+    'CALL_EDGE_TEXT_MAX',
+    'CREATION_EDGE_PREFIX',
+    'CREATION_EDGE_TEXT_MAX',
+    // Env-surface specs (release 2.12.0, §5.12) — imported by the CLI to aggregate
+    // the env-surface reference doc.
+    'GRAPH_ENV_SPECS',
+    'GraphAdapterRegistry',
+    'GraphAdapterSelector',
+    'GraphRecipeRegistry',
+    'appendEdge',
+    'builtInGraphRecipes',
+    'builtInGraphRecipesByName',
+    // Cross-package resolution primitives — the (import specifier + callee name) →
+    // unique exported SOURCE occurrence model BOTH engines link `@scope/pkg` calls
+    // through (the exact↔sharded convergence contract). Part of the adapter
+    // surface alongside the edge-helpers and body-digest primitives.
+    'buildExportIndex',
+    'buildPackageManifestIndex',
+    'buildPackageManifestIndexFromRoots',
+    'createAdapterRegistry',
+    'createMutableStats',
+    'createRecipeRegistry',
+    'currentAdapterRegistry',
+    'currentGraphRecipes',
+    'deadCodeGraphRecipe',
+    'defaultGraphRecipe',
+    'defineGraphRecipe',
+    'defineRule',
+    'graphTool',
+    'GRAPH_CONTRACT_VERSION',
+    'hashBody',
+    'isBuiltInGraphRecipe',
+    'linkExported',
+    'normalizeWhitespace',
+    'ownerEdgeKey',
+    'pickAdapter',
+    'pushCreationEdge',
+    'resolveCrossPackageCall',
+    'resolveRecipeToRules',
+    'resolveSpecifierToPackage',
+    'tool',
+    'truncateForCallEdge',
+].sort();
+describe('@opensip-cli/graph public barrel', () => {
+    it('exposes exactly the curated value-export surface', () => {
+        const actual = Object.keys(barrel)
+            .filter((k) => barrel[k] !== undefined)
+            .sort();
+        expect(actual).toEqual(EXPECTED_VALUE_EXPORTS);
+    });
+    it('exposes `graphTool` (and its `tool` alias) as the Tool descriptor', () => {
+        expect(barrel.graphTool).toBeDefined();
+        expect(barrel.graphTool.metadata.name).toBe('graph');
+        expect(barrel.graphTool.metadata.id).toBe('3873f1c2-02a9-4719-930a-bca74b62b706');
+        expect(barrel.tool).toBe(barrel.graphTool);
+    });
+    it('does NOT leak engine internals through the barrel', () => {
+        // CatalogRepo (persistence) + the orchestration/rule internals live on
+        // `@opensip-cli/graph/internal`, never the public barrel.
+        for (const leak of [
+            'CatalogRepo',
+            'runGraph',
+            'executeGraph',
+            'buildIndexes',
+            'buildUnifiedReportLines',
+            'orphanSubtreeRule',
+            'duplicatedFunctionBodyRule',
+            'MemoryPressureError',
+            'GRAPH_STAGES',
+        ]) {
+            expect(barrel).not.toHaveProperty(leak);
+        }
+    });
+});
+//# sourceMappingURL=public-api.test.js.map

package/dist/__tests__/public-api.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.test.js","sourceRoot":"","sources":["../../src/__tests__/public-api.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,8EAA8E;AAC9E,MAAM,sBAAsB,GAAG;IAC7B,oBAAoB;IACpB,sBAAsB;IACtB,wBAAwB;IACxB,+EAA+E;IAC/E,iCAAiC;IACjC,iBAAiB;IACjB,sBAAsB;IACtB,sBAAsB;IACtB,qBAAqB;IACrB,YAAY;IACZ,qBAAqB;IACrB,2BAA2B;IAC3B,+EAA+E;IAC/E,+EAA+E;IAC/E,wEAAwE;IACxE,iEAAiE;IACjE,kBAAkB;IAClB,2BAA2B;IAC3B,oCAAoC;IACpC,uBAAuB;IACvB,oBAAoB;IACpB,sBAAsB;IACtB,wBAAwB;IACxB,qBAAqB;IACrB,qBAAqB;IACrB,oBAAoB;IACpB,mBAAmB;IACnB,YAAY;IACZ,WAAW;IACX,wBAAwB;IACxB,UAAU;IACV,sBAAsB;IACtB,cAAc;IACd,qBAAqB;IACrB,cAAc;IACd,aAAa;IACb,kBAAkB;IAClB,yBAAyB;IACzB,sBAAsB;IACtB,2BAA2B;IAC3B,MAAM;IACN,qBAAqB;CACtB,CAAC,IAAI,EAAE,CAAC;AAET,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAwB,CAAC,KAAK,SAAS,CAAC;aAC7D,IAAI,EAAE,CAAC;QACV,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QAClF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,uEAAuE;QACvE,0DAA0D;QAC1D,KAAK,MAAM,IAAI,IAAI;YACjB,aAAa;YACb,UAAU;YACV,cAAc;YACd,cAAc;YACd,yBAAyB;YACzB,mBAAmB;YACnB,4BAA4B;YAC5B,qBAAqB;YACrB,cAAc;SACf,EAAE,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/render/catalog-json-types.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Type-shape lock for the catalog JSON wire format. Each test asserts
+ * a sample object that exercises every documented field — a removal or
+ * shape change in the types fails the assertion.
+ *
+ * Phase 3 Task 3.1 per DEC-498. Phase 5 (opensip-side ingestor) cites
+ * these types as the wire contract.
+ */
+export {};
+//# sourceMappingURL=catalog-json-types.test.d.ts.map

package/dist/__tests__/render/catalog-json-types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-json-types.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/render/catalog-json-types.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/render/catalog-json-types.test.js

@@ -0,0 +1,121 @@
+/**
+ * Type-shape lock for the catalog JSON wire format. Each test asserts
+ * a sample object that exercises every documented field — a removal or
+ * shape change in the types fails the assertion.
+ *
+ * Phase 3 Task 3.1 per DEC-498. Phase 5 (opensip-side ingestor) cites
+ * these types as the wire contract.
+ */
+import { describe, expect, it } from 'vitest';
+describe('CatalogExport wire shape', () => {
+    it('CatalogExportSymbol accepts all 14 documented fields', () => {
+        const symbol = {
+            id: 'a'.repeat(64),
+            repoId: 'repo_x',
+            kind: 'function',
+            language: 'typescript',
+            qualifiedName: 'OrderProcessor.process',
+            modulePath: 'src/order/process',
+            arity: 2,
+            filePath: 'src/order/process.ts',
+            startLine: 42,
+            endLine: 67,
+            isExported: true,
+            signature: '(order: Order, ctx: Context) => Result',
+            docSummary: 'Processes a customer order through the fulfillment pipeline.',
+            gitSha: 'abc1234567890abc1234567890abc1234567890a',
+        };
+        expect(symbol.id).toHaveLength(64);
+        expect(symbol.arity).toBe(2);
+    });
+    it('CatalogExportSymbol accepts arity = null for symbols without arity', () => {
+        const symbol = {
+            id: 'b'.repeat(64),
+            repoId: 'repo_x',
+            kind: 'class',
+            language: 'typescript',
+            qualifiedName: 'OrderProcessor',
+            modulePath: 'src/order/process',
+            arity: null,
+            filePath: 'src/order/process.ts',
+            startLine: 1,
+            endLine: 100,
+            isExported: true,
+            gitSha: 'abc1234567890abc1234567890abc1234567890a',
+        };
+        expect(symbol.arity).toBeNull();
+    });
+    it('CatalogExportEdge accepts a resolved edge with toSymbolId', () => {
+        const edge = {
+            id: 'c'.repeat(64),
+            repoId: 'repo_x',
+            edgeKind: 'calls',
+            fromSymbolId: 'a'.repeat(64),
+            toSymbolId: 'b'.repeat(64),
+            toQualifiedNameUnresolved: null,
+            sourceFile: 'src/order/process.ts',
+            sourceLine: 47,
+            gitSha: 'abc1234567890abc1234567890abc1234567890a',
+        };
+        expect(edge.toSymbolId).toBeTruthy();
+        expect(edge.toQualifiedNameUnresolved).toBeNull();
+    });
+    it('CatalogExportEdge accepts an unresolved edge with toQualifiedNameUnresolved', () => {
+        const edge = {
+            id: 'd'.repeat(64),
+            repoId: 'repo_x',
+            edgeKind: 'calls',
+            fromSymbolId: 'a'.repeat(64),
+            toSymbolId: null,
+            toQualifiedNameUnresolved: 'externalLib.someFn',
+            sourceFile: 'src/order/process.ts',
+            sourceLine: 48,
+            gitSha: 'abc1234567890abc1234567890abc1234567890a',
+        };
+        expect(edge.toSymbolId).toBeNull();
+        expect(edge.toQualifiedNameUnresolved).toBe('externalLib.someFn');
+    });
+    it('CatalogExportProvenance complete shape', () => {
+        const p = {
+            runId: '01j-test-run-id-uuid',
+            completeness: 'complete',
+            engineVersion: '1.0.0',
+            startedAt: '2026-05-27T00:00:00.000Z',
+            completedAt: '2026-05-27T00:01:00.000Z',
+            tenantId: 'tenant_x',
+        };
+        expect(p.completeness).toBe('complete');
+        expect(p.completedAt).not.toBeNull();
+    });
+    it('CatalogExportProvenance partial shape allows null completedAt', () => {
+        const p = {
+            runId: '01j-test-run-id-uuid',
+            completeness: 'partial',
+            engineVersion: '1.0.0',
+            startedAt: '2026-05-27T00:00:00.000Z',
+            completedAt: null,
+            tenantId: 'tenant_x',
+        };
+        expect(p.completeness).toBe('partial');
+        expect(p.completedAt).toBeNull();
+    });
+    it('CatalogExport top-level document', () => {
+        const doc = {
+            version: '1.0',
+            provenance: {
+                runId: 'run_x',
+                completeness: 'complete',
+                engineVersion: '1.0.0',
+                startedAt: '2026-05-27T00:00:00.000Z',
+                completedAt: '2026-05-27T00:01:00.000Z',
+                tenantId: 'tenant_x',
+            },
+            symbols: [],
+            edges: [],
+        };
+        expect(doc.version).toBe('1.0');
+        expect(doc.symbols).toEqual([]);
+        expect(doc.edges).toEqual([]);
+    });
+});
+//# sourceMappingURL=catalog-json-types.test.js.map

package/dist/__tests__/render/catalog-json-types.test.js.map

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

package/dist/__tests__/render/catalog-json.test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tests for the catalog JSON renderer.
+ *
+ * Coverage:
+ *   1. Golden-fixture snapshot of a small representative catalog —
+ *      locks the wire format byte-for-byte.
+ *   2. Symbol-row invariants: id matches `deriveOpenSipSymbolId`
+ *      output, kind mapping, arity derivation, modulePath
+ *      derivation, isExported from visibility.
+ *   3. Edge-row invariants: id matches `deriveOpenSipEdgeId`,
+ *      polymorphic edges split into multiple rows, unresolved edges
+ *      carry the call-text as `toQualifiedNameUnresolved`.
+ *   4. Stable ordering: re-rendering the same catalog produces
+ *      byte-identical output.
+ *
+ * Phase 3 Task 3.3 per DEC-498.
+ */
+export {};
+//# sourceMappingURL=catalog-json.test.d.ts.map

package/dist/__tests__/render/catalog-json.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-json.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/render/catalog-json.test.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;GAgBG"}