@kaelio/ktx 0.5.0 → 0.7.0

package/dist/context/ingest/adapters/live-database/stage.test.js

@@ -1,133 +0,0 @@
-import { mkdtemp, readFile } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { describe, expect, it } from 'vitest';
-import { detectLiveDatabaseStagedDir, LIVE_DATABASE_FOREIGN_KEYS_FILE, LIVE_DATABASE_META_FILE, liveDatabaseTablePath, readLiveDatabaseTableFiles, writeLiveDatabaseSnapshot, } from './stage.js';
-function snapshot() {
-    return {
-        connectionId: 'conn-1',
-        driver: 'postgres',
-        extractedAt: '2026-04-27T00:00:00.000Z',
-        scope: { schemas: ['public'] },
-        metadata: { dialect: 'postgres' },
-        tables: [
-            {
-                name: 'orders',
-                catalog: null,
-                db: 'public',
-                kind: 'table',
-                comment: 'Orders placed by customers',
-                estimatedRows: 200,
-                columns: [
-                    {
-                        name: 'id',
-                        nativeType: 'integer',
-                        normalizedType: 'integer',
-                        dimensionType: 'number',
-                        nullable: false,
-                        primaryKey: true,
-                        comment: null,
-                    },
-                    {
-                        name: 'customer_id',
-                        nativeType: 'integer',
-                        normalizedType: 'integer',
-                        dimensionType: 'number',
-                        nullable: false,
-                        primaryKey: false,
-                        comment: null,
-                    },
-                    {
-                        name: 'total',
-                        nativeType: 'numeric',
-                        normalizedType: 'numeric',
-                        dimensionType: 'number',
-                        nullable: false,
-                        primaryKey: false,
-                        comment: null,
-                    },
-                ],
-                foreignKeys: [
-                    {
-                        fromColumn: 'customer_id',
-                        toCatalog: null,
-                        toDb: 'public',
-                        toTable: 'customers',
-                        toColumn: 'id',
-                        constraintName: null,
-                    },
-                ],
-            },
-            {
-                name: 'customers',
-                catalog: null,
-                db: 'public',
-                kind: 'table',
-                comment: null,
-                estimatedRows: 50,
-                columns: [
-                    {
-                        name: 'id',
-                        nativeType: 'integer',
-                        normalizedType: 'integer',
-                        dimensionType: 'number',
-                        nullable: false,
-                        primaryKey: true,
-                        comment: null,
-                    },
-                ],
-                foreignKeys: [],
-            },
-        ],
-    };
-}
-describe('live-database staged snapshot files', () => {
-    it('writes deterministic metadata, table, and foreign-key files', async () => {
-        const dir = await mkdtemp(join(tmpdir(), 'ktx-live-db-stage-'));
-        await writeLiveDatabaseSnapshot(dir, snapshot());
-        await expect(readFile(join(dir, LIVE_DATABASE_META_FILE), 'utf8')).resolves.toContain('"connectionId": "conn-1"');
-        await expect(readFile(join(dir, LIVE_DATABASE_FOREIGN_KEYS_FILE), 'utf8')).resolves.toContain('"fromTable": "orders"');
-        const connectionJson = await readFile(join(dir, LIVE_DATABASE_META_FILE), 'utf8');
-        expect(connectionJson).toContain('"driver": "postgres"');
-        expect(connectionJson).toContain('"schemas"');
-        const ordersPath = liveDatabaseTablePath({ catalog: null, db: 'public', name: 'orders' });
-        const customersPath = liveDatabaseTablePath({ catalog: null, db: 'public', name: 'customers' });
-        expect(ordersPath).toMatch(/^tables\/[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.json$/);
-        await expect(readFile(join(dir, ordersPath), 'utf8')).resolves.toContain('"name": "orders"');
-        await expect(readFile(join(dir, customersPath), 'utf8')).resolves.toContain('"name": "customers"');
-        const ordersJson = await readFile(join(dir, ordersPath), 'utf8');
-        expect(ordersJson).toContain('"kind": "table"');
-        expect(ordersJson).toContain('"estimatedRows": 200');
-        expect(ordersJson).toContain('"nativeType": "integer"');
-        expect(ordersJson).toContain('"normalizedType": "integer"');
-        expect(ordersJson).not.toContain('"type": "integer"');
-        const tableFiles = await readLiveDatabaseTableFiles(dir);
-        expect(tableFiles.map((file) => file.table.name)).toEqual(['customers', 'orders']);
-        expect(await detectLiveDatabaseStagedDir(dir)).toBe(true);
-    });
-    it('redacts sensitive snapshot metadata before writing connection metadata', async () => {
-        const dir = await mkdtemp(join(tmpdir(), 'ktx-live-db-redacted-stage-'));
-        await writeLiveDatabaseSnapshot(dir, {
-            ...snapshot(),
-            metadata: {
-                dialect: 'postgres',
-                url: 'postgres://reader:secret@example.test/db', // pragma: allowlist secret
-                serviceAccountJson: {
-                    client_email: 'reader@example.test',
-                    private_key: 'pem-value', // pragma: allowlist secret
-                },
-            },
-        });
-        const connectionJson = await readFile(join(dir, LIVE_DATABASE_META_FILE), 'utf8');
-        expect(connectionJson).toContain('"dialect": "postgres"');
-        expect(connectionJson).toContain('"client_email": "reader@example.test"');
-        expect(connectionJson).toContain('"url": "<redacted>"');
-        expect(connectionJson).toContain('"private_key": "<redacted>"');
-        expect(connectionJson).not.toContain('postgres://reader:secret@example.test/db'); // pragma: allowlist secret
-        expect(connectionJson).not.toContain('pem-value');
-    });
-    it('returns false for a directory that is missing live database metadata', async () => {
-        const dir = await mkdtemp(join(tmpdir(), 'ktx-live-db-empty-'));
-        expect(await detectLiveDatabaseStagedDir(dir)).toBe(false);
-    });
-});

package/dist/context/ingest/adapters/looker/chunk.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/context/ingest/adapters/looker/chunk.test.js

@@ -1,142 +0,0 @@
-import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
-import { chunkLookerStagedDir } from './chunk.js';
-import { writeLookerEvidenceDocuments } from './evidence-documents.js';
-async function writeJson(stagedDir, relPath, value) {
-    const abs = join(stagedDir, relPath);
-    await mkdir(join(abs, '..'), { recursive: true });
-    await writeFile(abs, `${JSON.stringify(value, null, 2)}\n`, 'utf-8');
-}
-async function writeSmallFixture(stagedDir) {
-    await writeJson(stagedDir, 'sync-config.json', {
-        lookerConnectionId: '11111111-1111-4111-8111-111111111111',
-        fetchedAt: '2026-04-30T12:30:00.000Z',
-    });
-    await writeJson(stagedDir, 'lookml_models.json', {
-        models: [{ name: 'b2b', label: 'B2B', explores: [{ name: 'sales_pipeline', label: 'Sales Pipeline' }] }],
-    });
-    await writeJson(stagedDir, 'explores/b2b/sales_pipeline.json', {
-        modelName: 'b2b',
-        exploreName: 'sales_pipeline',
-        label: 'Sales Pipeline',
-        description: null,
-        fields: { dimensions: [{ name: 'opportunities.id' }], measures: [{ name: 'opportunities.arr' }] },
-        joins: [],
-    });
-    await writeJson(stagedDir, 'dashboards/10.json', {
-        lookerId: '10',
-        title: 'Sales Pipeline',
-        description: null,
-        folderId: '7',
-        ownerId: '3',
-        updatedAt: '2026-04-30T12:00:00.000Z',
-        tiles: [{ id: '100', title: 'ARR', lookId: null, query: { model: 'b2b', view: 'sales_pipeline' } }],
-    });
-    await writeJson(stagedDir, 'looks/20.json', {
-        lookerId: '20',
-        title: 'Open Pipeline',
-        description: null,
-        folderId: '7',
-        ownerId: '3',
-        updatedAt: '2026-04-30T12:00:00.000Z',
-        query: { model: 'b2b', view: 'sales_pipeline', fields: ['opportunities.arr'] },
-    });
-    await writeJson(stagedDir, 'folders/tree.json', {
-        folders: [{ id: '7', name: 'Sandbox', parentId: null, path: ['Sandbox'] }],
-    });
-    await writeJson(stagedDir, 'users/3.json', { id: '3', displayName: 'Ada Lovelace', email: null });
-    await writeJson(stagedDir, 'signals/dashboard_usage.json', [
-        { contentId: '10', queryCount30d: 50, uniqueUsers30d: 8 },
-    ]);
-    await writeJson(stagedDir, 'signals/look_usage.json', [{ contentId: '20', queryCount30d: 20, uniqueUsers30d: 5 }]);
-    await writeJson(stagedDir, 'signals/scheduled_plans.json', [
-        { contentId: '10', contentType: 'dashboard', isScheduled: true, scheduleCount: 1, recipientCount: 3 },
-    ]);
-    await writeJson(stagedDir, 'signals/favorites.json', [
-        { contentId: '10', contentType: 'dashboard', favoriteCount: 4 },
-    ]);
-    await writeLookerEvidenceDocuments(stagedDir);
-}
-describe('chunkLookerStagedDir', () => {
-    let stagedDir;
-    beforeEach(async () => {
-        stagedDir = await mkdtemp(join(tmpdir(), 'looker-chunk-'));
-        await writeSmallFixture(stagedDir);
-    });
-    afterEach(async () => {
-        await rm(stagedDir, { recursive: true, force: true });
-    });
-    it('emits one WU per explore, dashboard, and Look with readable dependencies', async () => {
-        const result = await chunkLookerStagedDir(stagedDir);
-        expect(result.reconcileNotes).toEqual([
-            expect.stringContaining('emit_artifact_resolution with actionType="subsumed"'),
-        ]);
-        expect(result.workUnits.map((wu) => wu.unitKey).sort()).toEqual([
-            'looker-dashboard-10',
-            'looker-explore-b2b-sales_pipeline',
-            'looker-look-20',
-        ]);
-        const dashboard = result.workUnits.find((wu) => wu.unitKey === 'looker-dashboard-10');
-        expect(dashboard?.rawFiles).toEqual([
-            'dashboards/10.json',
-            'evidence/dashboards/10/metadata.json',
-            'evidence/dashboards/10/page.md',
-        ]);
-        expect(dashboard?.notes).toContain('context_candidate_write');
-        expect(dashboard?.notes).not.toContain('wiki_write');
-        expect(dashboard?.dependencyPaths.sort()).toEqual([
-            'explores/b2b/sales_pipeline.json',
-            'folders/tree.json',
-            'signals/dashboard_usage.json',
-            'signals/favorites.json',
-            'signals/scheduled_plans.json',
-            'users/3.json',
-        ]);
-        const explore = result.workUnits.find((wu) => wu.unitKey === 'looker-explore-b2b-sales_pipeline');
-        expect(explore?.rawFiles).toEqual([
-            'explores/b2b/sales_pipeline.json',
-            'evidence/explores/b2b/sales_pipeline/metadata.json',
-            'evidence/explores/b2b/sales_pipeline/page.md',
-        ]);
-        expect(explore?.dependencyPaths).toEqual(['lookml_models.json']);
-    });
-    it('keeps downstream dashboard and Look WUs when an explore dependency changes', async () => {
-        const result = await chunkLookerStagedDir(stagedDir, {
-            added: [],
-            modified: ['explores/b2b/sales_pipeline.json'],
-            deleted: [],
-            unchanged: [
-                'dashboards/10.json',
-                'looks/20.json',
-                'lookml_models.json',
-                'folders/tree.json',
-                'users/3.json',
-                'signals/dashboard_usage.json',
-                'signals/look_usage.json',
-                'signals/scheduled_plans.json',
-                'signals/favorites.json',
-            ],
-        });
-        expect(result.workUnits.map((wu) => wu.unitKey).sort()).toEqual([
-            'looker-dashboard-10',
-            'looker-explore-b2b-sales_pipeline',
-            'looker-look-20',
-        ]);
-        expect(result.workUnits.find((wu) => wu.unitKey === 'looker-dashboard-10')?.rawFiles).toEqual([
-            'dashboards/10.json',
-            'evidence/dashboards/10/metadata.json',
-            'evidence/dashboards/10/page.md',
-        ]);
-    });
-    it('returns an EvictionUnit for deleted runtime entity raw paths', async () => {
-        const result = await chunkLookerStagedDir(stagedDir, {
-            added: [],
-            modified: [],
-            deleted: ['looks/20.json'],
-            unchanged: ['dashboards/10.json', 'explores/b2b/sales_pipeline.json'],
-        });
-        expect(result.eviction).toEqual({ deletedRawPaths: ['looks/20.json'] });
-    });
-});

package/dist/context/ingest/adapters/looker/client-boundary.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/context/ingest/adapters/looker/client-boundary.test.js

@@ -1,12 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { describe, expect, it } from 'vitest';
-describe('LookerClient boundary', () => {
-    it('does not import server or NestJS modules', async () => {
-        const source = await readFile(new URL('./client.ts', import.meta.url), 'utf-8');
-        expect(source).not.toMatch(/@nestjs\/common/);
-        expect(source).not.toMatch(/DataSourceClient/);
-        expect(source).not.toMatch(/\.\.\/interfaces/);
-        expect(source).not.toMatch(/\.\.\/types/);
-        expect(source).not.toMatch(/server\/src/);
-    });
-});

package/dist/context/ingest/adapters/looker/client.test.d.ts

@@ -1 +0,0 @@
-export {};