swagger-parser-mcp-server 2.0.4 → 2.3.0

package/dist/tests/mcpSnapshotTools.test.js

@@ -0,0 +1,316 @@
+import { createMcpToolRouter } from '../transport/mcpToolRouter.js';
+import { snapshotDiffResultSchema } from '../domain/contracts/snapshotDiffContract.js';
+import { endpointDiffDetailOutputSchema, listEndpointChangeHistoryResultSchema, listSnapshotsResultSchema, } from '../schemas.js';
+import { SchemaResolver } from '../utils/schemaResolver.js';
+const fixedNow = '2026-03-09T09:00:00.000Z';
+const environment = {
+    DATABASE_URL: 'postgresql://localhost:5432/test',
+    PROJECT_KEY: 'frontend-diff',
+    SWAGGER_URL: 'https://api.example.com/openapi.json',
+};
+const bootstrapResult = {
+    environment,
+    project: { id: 'project-1', projectKey: 'frontend-diff', createdAt: fixedNow },
+    source: {
+        id: 'source-1',
+        projectId: 'project-1',
+        swaggerUrl: 'https://api.example.com/openapi.json',
+        createdAt: fixedNow,
+    },
+};
+const diffResult = snapshotDiffResultSchema.parse({
+    summary: {
+        projectKey: 'frontend-diff',
+        sourceUrl: 'https://api.example.com/openapi.json',
+        baselineSnapshotId: 'snapshot-1',
+        targetSnapshotId: 'snapshot-2',
+        comparedAt: fixedNow,
+        hasChanges: true,
+        isNoopCapture: false,
+    },
+    counts: {
+        total: 1,
+        breaking: 1,
+        nonBreaking: 0,
+        info: 0,
+    },
+    changes: [
+        {
+            url: '/users',
+            method: 'get',
+            classification: 'breaking',
+            changeReason: 'response_status_removed',
+        },
+    ],
+    warnings: [],
+});
+const endpointDetailResult = {
+    baselineSnapshotId: 'snapshot-1',
+    targetSnapshotId: 'snapshot-2',
+    path: '/users',
+    method: 'get',
+    hasChange: true,
+    classification: 'breaking',
+    changeReason: 'response_status_removed',
+    details: [
+        {
+            reason: 'response_status_removed',
+            classification: 'breaking',
+            message: 'Response status code removed: 200',
+            metadata: {
+                removedStatusCodes: ['200'],
+            },
+        },
+    ],
+    before: { parameters: [], responses: [{ statusCode: '200', content: [] }] },
+    after: { parameters: [], responses: [] },
+};
+const snapshotItems = [
+    {
+        id: 'snapshot-2',
+        sourceId: 'source-1',
+        specHash: 'spec-hash-2',
+        documentFingerprint: 'doc-fingerprint-2',
+        capturedAt: fixedNow,
+    },
+];
+const historyEvents = [
+    {
+        baselineSnapshotId: 'snapshot-1',
+        targetSnapshotId: 'snapshot-2',
+        path: '/users',
+        method: 'get',
+        classification: 'breaking',
+        changeReason: 'response_status_removed',
+        changedAt: fixedNow,
+    },
+];
+function parseToolPayload(response) {
+    return JSON.parse(response.content[0].text);
+}
+function createMockService() {
+    return {
+        capture: jest.fn().mockResolvedValue({
+            ...bootstrapResult,
+            specHash: 'spec-hash-2',
+            snapshot: {
+                id: 'snapshot-2',
+                sourceId: 'source-1',
+                specHash: 'spec-hash-2',
+                documentFingerprint: 'doc-fingerprint-2',
+                canonicalSnapshot: {
+                    sourceUrl: 'https://api.example.com/openapi.json',
+                    documentFingerprint: 'doc-fingerprint-2',
+                    endpoints: [],
+                    versionSignal: {
+                        infoVersion: '1.0.0',
+                        normalizedInfoVersion: '1',
+                        urlVersionHints: ['1'],
+                        hasVersionMismatch: false,
+                    },
+                },
+                capturedAt: fixedNow,
+            },
+            previousSnapshot: null,
+            isNoopCapture: false,
+            diffResult,
+        }),
+        bootstrap: jest.fn().mockResolvedValue(bootstrapResult),
+        listSnapshotsBySource: jest.fn().mockResolvedValue(snapshotItems),
+        listEndpointChangeHistory: jest.fn().mockResolvedValue(historyEvents),
+        replayDiff: jest.fn().mockResolvedValue(diffResult),
+        getEndpointDiffDetail: jest.fn().mockResolvedValue(endpointDetailResult),
+    };
+}
+function createLegacySwagger() {
+    return {
+        openapi: '3.0.0',
+        info: { title: 'Legacy API', version: '1.0.0' },
+        paths: {
+            '/users': {
+                get: {
+                    tags: ['users'],
+                    operationId: 'getUsers',
+                    parameters: [
+                        {
+                            name: 'limit',
+                            in: 'query',
+                            required: false,
+                            schema: { type: 'integer' },
+                        },
+                    ],
+                    responses: {
+                        '200': {
+                            description: 'ok',
+                            content: {
+                                'application/json': {
+                                    schema: { $ref: '#/components/schemas/UserList' },
+                                },
+                            },
+                        },
+                    },
+                },
+                trace: {
+                    tags: ['users'],
+                    operationId: 'traceUsers',
+                    summary: 'Trace users route',
+                    responses: {
+                        '200': {
+                            description: 'trace-ok',
+                        },
+                    },
+                },
+            },
+            '/trace-only': {
+                trace: {
+                    tags: ['trace-only'],
+                    operationId: 'traceOnlyRoute',
+                    responses: {
+                        '204': {
+                            description: 'no-content',
+                        },
+                    },
+                },
+            },
+        },
+        components: {
+            schemas: {
+                User: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'string' },
+                    },
+                },
+                UserList: {
+                    type: 'array',
+                    items: { $ref: '#/components/schemas/User' },
+                },
+            },
+        },
+    };
+}
+describe('MCP transport tool router', () => {
+    let service;
+    let runtimeProvider;
+    let swaggerCache;
+    let router;
+    beforeEach(() => {
+        service = createMockService();
+        runtimeProvider = jest.fn().mockResolvedValue({
+            environment,
+            service,
+        });
+        swaggerCache = {
+            load: jest.fn(),
+            getOrLoad: jest.fn(),
+        };
+        router = createMcpToolRouter({
+            runtimeProvider,
+            swaggerCache,
+            schemaResolver: new SchemaResolver({ includeCircularRefs: false }),
+        });
+    });
+    it('should keep legacy tools behavior for controllers/paths/details/schema resolution', async () => {
+        const swagger = createLegacySwagger();
+        swaggerCache.getOrLoad.mockResolvedValue(swagger);
+        const controllers = parseToolPayload(await router.execute('get_controllers', { url: environment.SWAGGER_URL }));
+        expect(controllers.controllers).toEqual(expect.arrayContaining(['users', 'trace-only']));
+        expect(controllers.count).toBe(2);
+        const paths = parseToolPayload(await router.execute('get_paths_by_controller', { url: environment.SWAGGER_URL, controller: 'users' }));
+        expect(paths.count).toBe(2);
+        expect(paths.paths).toEqual(expect.arrayContaining([
+            expect.objectContaining({ path: '/users', method: 'get' }),
+            expect.objectContaining({ path: '/users', method: 'trace' }),
+        ]));
+        const pathDetails = parseToolPayload(await router.execute('get_path_details', { url: environment.SWAGGER_URL, path: '/users', method: 'get' }));
+        expect(pathDetails.path).toBe('/users');
+        expect(pathDetails.method).toBe('GET');
+        const tracePathDetails = parseToolPayload(await router.execute('get_path_details', { url: environment.SWAGGER_URL, path: '/users', method: 'trace' }));
+        expect(tracePathDetails.path).toBe('/users');
+        expect(tracePathDetails.method).toBe('TRACE');
+        expect(tracePathDetails.operationId).toBe('traceUsers');
+        const resolved = parseToolPayload(await router.execute('resolve_schema', { url: environment.SWAGGER_URL, ref: '#/components/schemas/UserList' }));
+        expect(resolved.ref).toBe('#/components/schemas/UserList');
+        expect(resolved.resolved).toBeDefined();
+    });
+    it('should return Slice 1 DTO contract for capture_snapshot and get_snapshot_diff', async () => {
+        const capturePayload = parseToolPayload(await router.execute('capture_snapshot', {}));
+        expect(() => snapshotDiffResultSchema.parse(capturePayload)).not.toThrow();
+        const diffPayload = parseToolPayload(await router.execute('get_snapshot_diff', {
+            baselineSnapshotId: 'snapshot-1',
+            targetSnapshotId: 'snapshot-2',
+        }));
+        expect(() => snapshotDiffResultSchema.parse(diffPayload)).not.toThrow();
+        expect(service.replayDiff).toHaveBeenCalledTimes(1);
+    });
+    it('should keep list_snapshots, list_endpoint_change_history, and get_endpoint_diff_detail output shape stable', async () => {
+        const listPayload = parseToolPayload(await router.execute('list_snapshots', { limit: 20 }));
+        expect(() => listSnapshotsResultSchema.parse(listPayload)).not.toThrow();
+        const historyPayload = parseToolPayload(await router.execute('list_endpoint_change_history', {
+            limit: 20,
+            path: '/users',
+            method: 'get',
+        }));
+        expect(() => listEndpointChangeHistoryResultSchema.parse(historyPayload)).not.toThrow();
+        const detailPayload = parseToolPayload(await router.execute('get_endpoint_diff_detail', {
+            baselineSnapshotId: 'snapshot-1',
+            targetSnapshotId: 'snapshot-2',
+            path: '/users',
+            method: 'get',
+        }));
+        expect(() => endpointDiffDetailOutputSchema.parse(detailPayload)).not.toThrow();
+    });
+    it('should reject invalid history filters when path or method is missing', async () => {
+        const pathOnlyResponse = await router.execute('list_endpoint_change_history', {
+            path: '/users',
+        });
+        expect(pathOnlyResponse.content[0].text).toContain('Error: method: path and method must be provided together.');
+        const methodOnlyResponse = await router.execute('list_endpoint_change_history', {
+            method: 'get',
+        });
+        expect(methodOnlyResponse.content[0].text).toContain('Error: path: path and method must be provided together.');
+    });
+    it('should reject snapshot tools when replayed snapshots are outside configured source', async () => {
+        service.replayDiff.mockResolvedValueOnce(snapshotDiffResultSchema.parse({
+            ...diffResult,
+            summary: {
+                ...diffResult.summary,
+                projectKey: 'other-project',
+                sourceUrl: 'https://api.example.com/other.json',
+            },
+        }));
+        const diffResponse = await router.execute('get_snapshot_diff', {
+            baselineSnapshotId: 'snapshot-1',
+            targetSnapshotId: 'snapshot-2',
+        });
+        expect(diffResponse.content[0].text).toContain('Error: Snapshots do not belong to the configured source.');
+    });
+    it('should return proper errors for missing snapshots and runtime initialization failure', async () => {
+        service.replayDiff.mockRejectedValueOnce(new Error('Baseline snapshot not found: missing'));
+        const missingSnapshotResponse = await router.execute('get_snapshot_diff', {
+            baselineSnapshotId: 'missing',
+            targetSnapshotId: 'snapshot-2',
+        });
+        expect(missingSnapshotResponse.content[0].text).toContain('Error: Baseline snapshot not found: missing');
+        runtimeProvider.mockRejectedValueOnce(new Error('Invalid environment configuration: DATABASE_URL invalid'));
+        const runtimeInitResponse = await router.execute('capture_snapshot', {});
+        expect(runtimeInitResponse.content[0].text).toContain('Error: Invalid environment configuration: DATABASE_URL invalid');
+    });
+    it('should fail endpoint detail when diff replay does not belong to configured source', async () => {
+        service.replayDiff.mockResolvedValueOnce(snapshotDiffResultSchema.parse({
+            ...diffResult,
+            summary: {
+                ...diffResult.summary,
+                sourceUrl: 'https://api.example.com/foreign.json',
+            },
+        }));
+        const detailResponse = await router.execute('get_endpoint_diff_detail', {
+            baselineSnapshotId: 'snapshot-1',
+            targetSnapshotId: 'snapshot-2',
+            path: '/users',
+            method: 'get',
+        });
+        expect(detailResponse.content[0].text).toContain('Error: Snapshots do not belong to the configured source.');
+    });
+});
+//# sourceMappingURL=mcpSnapshotTools.test.js.map

package/dist/tests/mcpSnapshotTools.test.js.map

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

package/dist/tests/postgresMigrationSmoke.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=postgresMigrationSmoke.test.d.ts.map

package/dist/tests/postgresMigrationSmoke.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresMigrationSmoke.test.d.ts","sourceRoot":"","sources":["../../src/tests/postgresMigrationSmoke.test.ts"],"names":[],"mappings":""}

package/dist/tests/postgresMigrationSmoke.test.js

@@ -0,0 +1,187 @@
+import { newDb } from 'pg-mem';
+import { runPostgresMigrations } from '../infrastructure/postgres/migrationRunner.js';
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+describe('Slice 7: postgres migration smoke', () => {
+    it('should apply SQL migrations idempotently and enforce snapshot uniqueness', async () => {
+        const db = newDb({
+            autoCreateForeignKeyIndices: true,
+            noAstCoverageCheck: true,
+        });
+        const pgAdapter = db.adapters.createPg();
+        const client = new pgAdapter.Client();
+        await client.connect();
+        try {
+            const firstRun = await runPostgresMigrations(client);
+            expect(firstRun.applied).toEqual(['001_snapshot_schema.sql', '002_snapshot_change_history.sql']);
+            const secondRun = await runPostgresMigrations(client);
+            expect(secondRun.applied).toEqual([]);
+            expect(secondRun.skipped).toContain('001_snapshot_schema.sql');
+            expect(secondRun.skipped).toContain('002_snapshot_change_history.sql');
+            const history = await client.query(`
+        SELECT version
+        FROM schema_migrations
+        ORDER BY version ASC;
+      `);
+            expect(history.rows.map(row => row.version)).toEqual([
+                '001_snapshot_schema.sql',
+                '002_snapshot_change_history.sql',
+            ]);
+            const projectResult = await client.query(`
+        INSERT INTO projects (project_key)
+        VALUES ($1)
+        RETURNING id;
+        `, ['ops-migration-smoke']);
+            const projectId = projectResult.rows[0].id;
+            const sourceResult = await client.query(`
+        INSERT INTO sources (project_id, swagger_url)
+        VALUES ($1, $2)
+        RETURNING id;
+        `, [projectId, 'https://api.example.com/openapi.json']);
+            const sourceId = sourceResult.rows[0].id;
+            const firstSnapshotResult = await client.query(`
+        INSERT INTO snapshots (source_id, spec_hash, document_fingerprint, canonical_snapshot)
+        VALUES ($1, $2, $3, $4)
+        RETURNING id;
+        `, [sourceId, 'hash-v1', 'fingerprint-v1', JSON.stringify({ sourceUrl: 'https://api.example.com/openapi.json' })]);
+            const firstSnapshotId = firstSnapshotResult.rows[0].id;
+            await expect(client.query(`
+          INSERT INTO snapshots (source_id, spec_hash, document_fingerprint, canonical_snapshot)
+          VALUES ($1, $2, $3, $4);
+          `, [sourceId, 'hash-v1', 'fingerprint-v1', JSON.stringify({ sourceUrl: 'https://api.example.com/openapi.json' })])).rejects.toThrow(/duplicate key|unique/i);
+            const secondSnapshotResult = await client.query(`
+        INSERT INTO snapshots (source_id, spec_hash, document_fingerprint, canonical_snapshot)
+        VALUES ($1, $2, $3, $4)
+        RETURNING id, captured_at;
+        `, [sourceId, 'hash-v2', 'fingerprint-v2', JSON.stringify({ sourceUrl: 'https://api.example.com/openapi.json' })]);
+            const secondSnapshot = secondSnapshotResult.rows[0];
+            const transitionResult = await client.query(`
+        INSERT INTO snapshot_transitions (source_id, baseline_snapshot_id, target_snapshot_id, captured_at, counts, warnings)
+        VALUES ($1, $2, $3, $4, $5, $6)
+        RETURNING id;
+        `, [
+                sourceId,
+                firstSnapshotId,
+                secondSnapshot.id,
+                secondSnapshot.captured_at,
+                JSON.stringify({ total: 1, breaking: 0, nonBreaking: 1, info: 0 }),
+                JSON.stringify([]),
+            ]);
+            const transitionId = transitionResult.rows[0].id;
+            await client.query(`
+        INSERT INTO endpoint_change_history (
+          transition_id,
+          source_id,
+          path,
+          method,
+          classification,
+          change_reason,
+          baseline_snapshot_id,
+          target_snapshot_id,
+          changed_at
+        )
+        VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9);
+        `, [
+                transitionId,
+                sourceId,
+                '/pets',
+                'post',
+                'non-breaking',
+                'method_added',
+                firstSnapshotId,
+                secondSnapshot.id,
+                secondSnapshot.captured_at,
+            ]);
+            await expect(client.query(`
+          INSERT INTO snapshot_transitions (source_id, baseline_snapshot_id, target_snapshot_id, captured_at, counts, warnings)
+          VALUES ($1, $2, $3, $4, $5, $6);
+          `, [
+                sourceId,
+                firstSnapshotId,
+                secondSnapshot.id,
+                secondSnapshot.captured_at,
+                JSON.stringify({ total: 1, breaking: 0, nonBreaking: 1, info: 0 }),
+                JSON.stringify([]),
+            ])).rejects.toThrow(/duplicate key|unique/i);
+        }
+        finally {
+            await client.end();
+        }
+    });
+    it('should fail explicitly when migration directory is missing', async () => {
+        const db = newDb({
+            autoCreateForeignKeyIndices: true,
+            noAstCoverageCheck: true,
+        });
+        const pgAdapter = db.adapters.createPg();
+        const client = new pgAdapter.Client();
+        await client.connect();
+        try {
+            await expect(runPostgresMigrations(client, {
+                migrationsDirectory: path.join(os.tmpdir(), `missing-migrations-${Date.now()}`),
+            })).rejects.toThrow('Migration directory not found');
+        }
+        finally {
+            await client.end();
+        }
+    });
+    it('should rollback failed migration transaction and surface migration filename in error', async () => {
+        const tempDirectory = await mkdtemp(path.join(os.tmpdir(), 'snapshot-migrations-'));
+        const validPath = path.join(tempDirectory, '001_valid.sql');
+        const failingPath = path.join(tempDirectory, '002_failing.sql');
+        await writeFile(validPath, 'CREATE TABLE IF NOT EXISTS valid_probe (id INT PRIMARY KEY);\n', 'utf8');
+        await writeFile(failingPath, ['INSERT INTO valid_probe (id) VALUES (1);', 'INSERT INTO rollback_probe_missing VALUES (1);'].join('\n'), 'utf8');
+        const db = newDb({
+            autoCreateForeignKeyIndices: true,
+            noAstCoverageCheck: true,
+        });
+        const pgAdapter = db.adapters.createPg();
+        const client = new pgAdapter.Client();
+        await client.connect();
+        try {
+            await expect(runPostgresMigrations(client, {
+                migrationsDirectory: tempDirectory,
+            })).rejects.toThrow('Failed to apply migration 002_failing.sql');
+            const migrationHistory = await client.query('SELECT version FROM schema_migrations ORDER BY version ASC;');
+            const versions = migrationHistory.rows.map(row => row.version);
+            expect(versions).toEqual(['001_valid.sql']);
+            const validProbe = await client.query(`
+        SELECT COUNT(*)::int AS count
+        FROM valid_probe;
+        `);
+            expect(validProbe.rows[0].count).toBe(0);
+        }
+        finally {
+            await client.end();
+            await rm(tempDirectory, { recursive: true, force: true });
+        }
+    });
+    it('should tolerate concurrent migration execution without duplicate schema_migrations rows', async () => {
+        const db = newDb({
+            autoCreateForeignKeyIndices: true,
+            noAstCoverageCheck: true,
+        });
+        const pgAdapter = db.adapters.createPg();
+        const clientA = new pgAdapter.Client();
+        const clientB = new pgAdapter.Client();
+        await clientA.connect();
+        await clientB.connect();
+        try {
+            const [left, right] = await Promise.allSettled([runPostgresMigrations(clientA), runPostgresMigrations(clientB)]);
+            expect(left.status).toBe('fulfilled');
+            expect(right.status).toBe('fulfilled');
+            const history = await clientA.query(`
+        SELECT version
+        FROM schema_migrations
+        WHERE version IN ('001_snapshot_schema.sql', '002_snapshot_change_history.sql');
+        `);
+            expect(history.rows).toHaveLength(2);
+        }
+        finally {
+            await clientA.end();
+            await clientB.end();
+        }
+    });
+});
+//# sourceMappingURL=postgresMigrationSmoke.test.js.map

package/dist/tests/postgresMigrationSmoke.test.js.map

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

package/dist/tests/realPostgresTestSchema.d.ts

@@ -0,0 +1,10 @@
+export interface RealPostgresTestSchema {
+    schemaName: string;
+    databaseUrl: string;
+    dispose(): Promise<void>;
+}
+export declare function readTestDatabaseUrl(env?: NodeJS.ProcessEnv): string | null;
+export declare function createRealPostgresTestSchema(env?: NodeJS.ProcessEnv, options?: {
+    schemaPrefix?: string;
+}): Promise<RealPostgresTestSchema>;
+//# sourceMappingURL=realPostgresTestSchema.d.ts.map

package/dist/tests/realPostgresTestSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realPostgresTestSchema.d.ts","sourceRoot":"","sources":["../../src/tests/realPostgresTestSchema.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAwCD,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,IAAI,CAMvF;AAED,wBAAsB,4BAA4B,CAChD,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACtC,OAAO,CAAC,sBAAsB,CAAC,CAgCjC"}

package/dist/tests/realPostgresTestSchema.js

@@ -0,0 +1,73 @@
+import { randomBytes } from 'node:crypto';
+import { Pool } from 'pg';
+function normalizePrefix(prefix) {
+    const normalized = prefix
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9_]/g, '_')
+        .replace(/_+/g, '_')
+        .replace(/^_+|_+$/g, '');
+    if (!normalized) {
+        return 'snapshot_real_test';
+    }
+    if (!/^[a-z]/.test(normalized)) {
+        return `s_${normalized}`;
+    }
+    return normalized;
+}
+function createSchemaName(prefix) {
+    const safePrefix = normalizePrefix(prefix);
+    const timestamp = Date.now().toString(36);
+    const randomSuffix = randomBytes(4).toString('hex');
+    return `${safePrefix}_${timestamp}_${randomSuffix}`;
+}
+function quoteIdentifier(value) {
+    return `"${value.replace(/"/g, '""')}"`;
+}
+function buildSchemaScopedDatabaseUrl(databaseUrl, schemaName) {
+    const parsed = new URL(databaseUrl);
+    const scopedOption = `-c search_path=${schemaName},public`;
+    const existingOptions = parsed.searchParams.get('options');
+    parsed.searchParams.set('options', existingOptions ? `${existingOptions} ${scopedOption}` : scopedOption);
+    return parsed.toString();
+}
+export function readTestDatabaseUrl(env = process.env) {
+    const databaseUrl = env.TEST_DATABASE_URL?.trim();
+    if (!databaseUrl) {
+        return null;
+    }
+    return databaseUrl;
+}
+export async function createRealPostgresTestSchema(env = process.env, options = {}) {
+    const baseDatabaseUrl = readTestDatabaseUrl(env);
+    if (!baseDatabaseUrl) {
+        throw new Error('TEST_DATABASE_URL is required for real Postgres persistence tests.');
+    }
+    const schemaName = createSchemaName(options.schemaPrefix ?? 'snapshot_real_test');
+    const adminPool = new Pool({ connectionString: baseDatabaseUrl });
+    let disposed = false;
+    try {
+        await adminPool.query(`CREATE SCHEMA ${quoteIdentifier(schemaName)};`);
+    }
+    catch (error) {
+        await adminPool.end().catch(() => undefined);
+        throw error;
+    }
+    return {
+        schemaName,
+        databaseUrl: buildSchemaScopedDatabaseUrl(baseDatabaseUrl, schemaName),
+        async dispose() {
+            if (disposed) {
+                return;
+            }
+            disposed = true;
+            try {
+                await adminPool.query(`DROP SCHEMA IF EXISTS ${quoteIdentifier(schemaName)} CASCADE;`);
+            }
+            finally {
+                await adminPool.end().catch(() => undefined);
+            }
+        },
+    };
+}
+//# sourceMappingURL=realPostgresTestSchema.js.map

package/dist/tests/realPostgresTestSchema.js.map

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

package/dist/tests/snapshotCapturePipeline.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=snapshotCapturePipeline.test.d.ts.map

package/dist/tests/snapshotCapturePipeline.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotCapturePipeline.test.d.ts","sourceRoot":"","sources":["../../src/tests/snapshotCapturePipeline.test.ts"],"names":[],"mappings":""}