swagger-parser-mcp-server 2.0.4 → 2.3.0

package/dist/domain/canonical/canonicalSnapshot.js

@@ -0,0 +1,300 @@
+import { createHash } from 'node:crypto';
+import { SchemaResolver } from '../../utils/schemaResolver.js';
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace'];
+const NOISE_FIELDS = new Set(['description', 'summary', 'title', 'operationId', 'example', 'examples', 'externalDocs']);
+const ORDER_INSENSITIVE_ARRAY_FIELDS = new Set(['required', 'parameters', 'enum', 'allOf', 'anyOf', 'oneOf']);
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function hasReference(value) {
+    return isRecord(value) && typeof value.$ref === 'string';
+}
+function isSchemaResolverWrapper(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    const keys = Object.keys(value);
+    return (typeof value.$ref === 'string' && 'resolved' in value && keys.every(key => key === '$ref' || key === 'resolved'));
+}
+function stableHash(value) {
+    return createHash('sha256').update(JSON.stringify(value)).digest('hex');
+}
+function resolveReference(value, document, resolver) {
+    if (!hasReference(value)) {
+        return value;
+    }
+    return resolver.resolveRef(value.$ref, document);
+}
+function stripRefWrappers(value) {
+    if (Array.isArray(value)) {
+        return value.map(item => stripRefWrappers(item));
+    }
+    if (!isRecord(value)) {
+        return value;
+    }
+    if (isSchemaResolverWrapper(value)) {
+        return stripRefWrappers(value.resolved);
+    }
+    const next = {};
+    Object.entries(value).forEach(([key, child]) => {
+        next[key] = stripRefWrappers(child);
+    });
+    return next;
+}
+function shouldDropKey(key) {
+    return NOISE_FIELDS.has(key) || key.startsWith('x-');
+}
+function shouldSortArray(parentKey) {
+    return parentKey !== null && ORDER_INSENSITIVE_ARRAY_FIELDS.has(parentKey);
+}
+function canonicalizeValue(value, parentKey = null) {
+    if (Array.isArray(value)) {
+        const normalized = value.map(item => canonicalizeValue(item, parentKey));
+        if (shouldSortArray(parentKey)) {
+            return normalized.sort((left, right) => JSON.stringify(left).localeCompare(JSON.stringify(right)));
+        }
+        return normalized;
+    }
+    if (!isRecord(value)) {
+        return value;
+    }
+    const nextEntries = Object.entries(value)
+        .filter(([key, child]) => !shouldDropKey(key) && child !== undefined)
+        .map(([key, child]) => [key, canonicalizeValue(child, key)])
+        .sort(([left], [right]) => left.localeCompare(right));
+    return Object.fromEntries(nextEntries);
+}
+function toComparableVersion(rawVersion) {
+    if (!rawVersion) {
+        return null;
+    }
+    const match = rawVersion.match(/v?(\d+(?:\.\d+){0,2})/i);
+    if (!match) {
+        return null;
+    }
+    const parsed = match[1].split('.').map(part => String(Number.parseInt(part, 10)));
+    while (parsed.length > 1 && parsed[parsed.length - 1] === '0') {
+        parsed.pop();
+    }
+    return parsed.join('.');
+}
+function collectUrlVersionHints(sourceUrl) {
+    const hints = new Set();
+    const candidates = new Set([sourceUrl]);
+    try {
+        const parsedUrl = new URL(sourceUrl);
+        candidates.add(parsedUrl.pathname);
+        candidates.add(parsedUrl.search);
+    }
+    catch {
+        // Invalid URL is handled as a best-effort parse; sourceUrl itself is already in candidates.
+    }
+    const versionPatterns = [
+        /\/v(\d+(?:\.\d+){0,2})\b/gi,
+        /\/version\/(\d+(?:\.\d+){0,2})\b/gi,
+        /[?&](?:v|version)=(\d+(?:\.\d+){0,2})\b/gi,
+    ];
+    candidates.forEach(candidate => {
+        versionPatterns.forEach(pattern => {
+            let match = pattern.exec(candidate);
+            while (match) {
+                const normalized = toComparableVersion(match[1]);
+                if (normalized) {
+                    hints.add(normalized);
+                }
+                match = pattern.exec(candidate);
+            }
+            pattern.lastIndex = 0;
+        });
+    });
+    return Array.from(hints).sort();
+}
+function normalizeSchema(schema, document, resolver) {
+    if (schema === undefined) {
+        return undefined;
+    }
+    const resolvedSchema = resolver.resolveSchemaReference(schema, document);
+    return canonicalizeValue(stripRefWrappers(resolvedSchema));
+}
+function normalizeMediaContent(contentValue, document, resolver) {
+    if (!isRecord(contentValue)) {
+        return [];
+    }
+    return Object.entries(contentValue)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([mediaType, mediaObject]) => {
+        if (!isRecord(mediaObject) || mediaObject.schema === undefined) {
+            return {
+                mediaType,
+                hasSchema: false,
+            };
+        }
+        const schema = normalizeSchema(mediaObject.schema, document, resolver);
+        return {
+            mediaType,
+            hasSchema: schema !== undefined,
+            ...(schema !== undefined ? { schema } : {}),
+        };
+    });
+}
+function normalizeParameter(parameterValue, document, resolver) {
+    const resolved = resolveReference(parameterValue, document, resolver);
+    if (!isRecord(resolved) || typeof resolved.name !== 'string' || typeof resolved.in !== 'string') {
+        return null;
+    }
+    const normalizedParameter = {
+        name: resolved.name,
+        in: resolved.in,
+        required: resolved.required === true,
+    };
+    if (resolved.schema !== undefined) {
+        normalizedParameter.schema = normalizeSchema(resolved.schema, document, resolver);
+    }
+    if (resolved.content !== undefined) {
+        const normalizedContent = normalizeMediaContent(resolved.content, document, resolver);
+        if (normalizedContent.length > 0) {
+            normalizedParameter.content = normalizedContent;
+        }
+    }
+    return normalizedParameter;
+}
+function normalizeRequestBody(requestBodyValue, document, resolver) {
+    if (requestBodyValue === undefined) {
+        return undefined;
+    }
+    const resolved = resolveReference(requestBodyValue, document, resolver);
+    if (!isRecord(resolved)) {
+        return undefined;
+    }
+    const normalizedContent = normalizeMediaContent(resolved.content, document, resolver);
+    if (normalizedContent.length === 0) {
+        return undefined;
+    }
+    return {
+        required: resolved.required === true,
+        content: normalizedContent,
+    };
+}
+function normalizeResponses(responsesValue, document, resolver) {
+    if (!isRecord(responsesValue)) {
+        return [];
+    }
+    return Object.entries(responsesValue)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([statusCode, responseValue]) => {
+        const resolvedResponse = resolveReference(responseValue, document, resolver);
+        const content = isRecord(resolvedResponse)
+            ? normalizeMediaContent(resolvedResponse.content, document, resolver)
+            : [];
+        return {
+            statusCode,
+            content,
+        };
+    });
+}
+function normalizeOperation(pathValue, method, document, resolver) {
+    if (!isRecord(pathValue)) {
+        return null;
+    }
+    const operation = pathValue[method];
+    if (!isRecord(operation)) {
+        return null;
+    }
+    const pathLevelParameters = Array.isArray(pathValue.parameters) ? pathValue.parameters : [];
+    const operationParameters = Array.isArray(operation.parameters) ? operation.parameters : [];
+    const parameterMap = new Map();
+    pathLevelParameters
+        .map(parameter => normalizeParameter(parameter, document, resolver))
+        .filter((parameter) => parameter !== null)
+        .forEach(parameter => {
+        parameterMap.set(`${parameter.in}:${parameter.name}`, parameter);
+    });
+    operationParameters
+        .map(parameter => normalizeParameter(parameter, document, resolver))
+        .filter((parameter) => parameter !== null)
+        .forEach(parameter => {
+        // OpenAPI semantics: operation-level parameters override path-level duplicates by (name, in).
+        parameterMap.set(`${parameter.in}:${parameter.name}`, parameter);
+    });
+    const normalizedParameters = Array.from(parameterMap.values()).sort((left, right) => `${left.in}:${left.name}`.localeCompare(`${right.in}:${right.name}`));
+    return {
+        parameters: normalizedParameters,
+        requestBody: normalizeRequestBody(operation.requestBody, document, resolver),
+        responses: normalizeResponses(operation.responses, document, resolver),
+    };
+}
+export function extractVersionSignal(document, sourceUrl) {
+    const infoVersion = typeof document.info?.version === 'string' ? document.info.version : null;
+    const normalizedInfoVersion = toComparableVersion(infoVersion);
+    const urlVersionHints = collectUrlVersionHints(sourceUrl);
+    const hasVersionMismatch = normalizedInfoVersion !== null && urlVersionHints.length > 0 && !urlVersionHints.includes(normalizedInfoVersion);
+    return {
+        infoVersion,
+        normalizedInfoVersion,
+        urlVersionHints,
+        hasVersionMismatch,
+    };
+}
+export function createCanonicalSnapshot(input) {
+    const resolver = new SchemaResolver({
+        includeCircularRefs: false,
+        maxDepth: 12,
+    });
+    const pathEntries = Object.entries(input.document.paths || {}).sort(([left], [right]) => left.localeCompare(right));
+    const endpoints = [];
+    pathEntries.forEach(([path, pathValue]) => {
+        HTTP_METHODS.forEach(method => {
+            const operationShape = normalizeOperation(pathValue, method, input.document, resolver);
+            if (!operationShape) {
+                return;
+            }
+            const canonicalOperation = canonicalizeValue(operationShape);
+            const fingerprint = stableHash({
+                path,
+                method,
+                operation: canonicalOperation,
+            });
+            endpoints.push({
+                path,
+                method,
+                fingerprint,
+                canonicalOperation,
+            });
+        });
+    });
+    endpoints.sort((left, right) => `${left.path}:${left.method}`.localeCompare(`${right.path}:${right.method}`));
+    const documentFingerprint = stableHash(endpoints.map(endpoint => ({
+        path: endpoint.path,
+        method: endpoint.method,
+        operation: endpoint.canonicalOperation,
+    })));
+    return {
+        sourceUrl: input.sourceUrl,
+        documentFingerprint,
+        endpoints,
+        versionSignal: extractVersionSignal(input.document, input.sourceUrl),
+    };
+}
+function areStringArraysEqual(left, right) {
+    if (left.length !== right.length) {
+        return false;
+    }
+    for (let index = 0; index < left.length; index += 1) {
+        if (left[index] !== right[index]) {
+            return false;
+        }
+    }
+    return true;
+}
+export function analyzeCanonicalChange(baseline, target) {
+    const hasStructuralChanges = baseline.documentFingerprint !== target.documentFingerprint;
+    const hasVersionChange = baseline.versionSignal.normalizedInfoVersion !== target.versionSignal.normalizedInfoVersion ||
+        !areStringArraysEqual(baseline.versionSignal.urlVersionHints, target.versionSignal.urlVersionHints);
+    return {
+        hasStructuralChanges,
+        hasVersionChange,
+        isVersionOnlyChange: !hasStructuralChanges && hasVersionChange,
+        hasVersionMismatch: target.versionSignal.hasVersionMismatch,
+    };
+}
+//# sourceMappingURL=canonicalSnapshot.js.map

package/dist/domain/canonical/canonicalSnapshot.js.map

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

package/dist/domain/contracts/runtimeEnvironmentContract.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+declare const environmentSchema: z.ZodObject<{
+    DATABASE_URL: z.ZodEffects<z.ZodString, string, string>;
+    PROJECT_KEY: z.ZodString;
+    SWAGGER_URL: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    DATABASE_URL: string;
+    PROJECT_KEY: string;
+    SWAGGER_URL: string;
+}, {
+    DATABASE_URL: string;
+    PROJECT_KEY: string;
+    SWAGGER_URL: string;
+}>;
+export declare class EnvironmentValidationError extends Error {
+    constructor(message: string);
+}
+export type RuntimeEnvironment = z.infer<typeof environmentSchema>;
+export declare function validateEnvironment(env: NodeJS.ProcessEnv): RuntimeEnvironment;
+export {};
+//# sourceMappingURL=runtimeEnvironmentContract.d.ts.map

package/dist/domain/contracts/runtimeEnvironmentContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeEnvironmentContract.d.ts","sourceRoot":"","sources":["../../../src/domain/contracts/runtimeEnvironmentContract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,iBAAiB;;;;;;;;;;;;EAsBZ,CAAC;AAEZ,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEnE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,kBAAkB,CAoB9E"}

package/dist/domain/contracts/runtimeEnvironmentContract.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+const REQUIRED_ENV_KEYS = ['DATABASE_URL', 'PROJECT_KEY', 'SWAGGER_URL'];
+const environmentSchema = z
+    .object({
+    DATABASE_URL: z
+        .string()
+        .trim()
+        .url()
+        .refine(value => value.startsWith('postgres://') || value.startsWith('postgresql://'), {
+        message: 'DATABASE_URL must use postgres:// or postgresql://',
+    }),
+    PROJECT_KEY: z
+        .string()
+        .trim()
+        .min(1, 'PROJECT_KEY is required')
+        .regex(/^[A-Za-z0-9._-]+$/, 'PROJECT_KEY can only contain letters, numbers, dot, underscore, and hyphen'),
+    SWAGGER_URL: z
+        .string()
+        .trim()
+        .url()
+        .refine(value => value.startsWith('http://') || value.startsWith('https://'), {
+        message: 'SWAGGER_URL must use http:// or https://',
+    }),
+})
+    .strict();
+export class EnvironmentValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'EnvironmentValidationError';
+    }
+}
+export function validateEnvironment(env) {
+    const missingKeys = REQUIRED_ENV_KEYS.filter(key => !env[key]?.trim());
+    if (missingKeys.length > 0) {
+        throw new EnvironmentValidationError(`Missing required environment variables: ${missingKeys.join(', ')}`);
+    }
+    const parsed = environmentSchema.safeParse({
+        DATABASE_URL: env.DATABASE_URL,
+        PROJECT_KEY: env.PROJECT_KEY,
+        SWAGGER_URL: env.SWAGGER_URL,
+    });
+    if (!parsed.success) {
+        const formattedIssues = parsed.error.issues
+            .map(issue => `${String(issue.path[0] ?? 'env')}: ${issue.message}`)
+            .join('; ');
+        throw new EnvironmentValidationError(`Invalid environment configuration: ${formattedIssues}`);
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=runtimeEnvironmentContract.js.map

package/dist/domain/contracts/runtimeEnvironmentContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeEnvironmentContract.js","sourceRoot":"","sources":["../../../src/domain/contracts/runtimeEnvironmentContract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,iBAAiB,GAAG,CAAC,cAAc,EAAE,aAAa,EAAE,aAAa,CAAU,CAAC;AAElF,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,EAAE;SACL,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE;QACrF,OAAO,EAAE,oDAAoD;KAC9D,CAAC;IACJ,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;SACjC,KAAK,CAAC,mBAAmB,EAAE,4EAA4E,CAAC;IAC3G,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,EAAE;SACL,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QAC5E,OAAO,EAAE,0CAA0C;KACpD,CAAC;CACL,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAID,MAAM,UAAU,mBAAmB,CAAC,GAAsB;IACxD,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,0BAA0B,CAAC,2CAA2C,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC;QACzC,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;KAC7B,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aACxC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aACnE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,0BAA0B,CAAC,sCAAsC,eAAe,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/domain/contracts/snapshotDiffContract.d.ts

@@ -0,0 +1,270 @@
+import { z } from 'zod';
+export declare const httpMethodSchema: z.ZodEnum<["get", "post", "put", "patch", "delete", "head", "options", "trace"]>;
+export declare const changeClassificationSchema: z.ZodEnum<["breaking", "non-breaking", "info"]>;
+export declare const warningCodeSchema: z.ZodEnum<["VERSION_ONLY_CHANGE", "VERSION_MISMATCH"]>;
+export declare const diffSummarySchema: z.ZodObject<{
+    projectKey: z.ZodString;
+    sourceUrl: z.ZodString;
+    baselineSnapshotId: z.ZodString;
+    targetSnapshotId: z.ZodString;
+    comparedAt: z.ZodString;
+    hasChanges: z.ZodBoolean;
+    isNoopCapture: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    projectKey: string;
+    sourceUrl: string;
+    baselineSnapshotId: string;
+    targetSnapshotId: string;
+    comparedAt: string;
+    hasChanges: boolean;
+    isNoopCapture: boolean;
+}, {
+    projectKey: string;
+    sourceUrl: string;
+    baselineSnapshotId: string;
+    targetSnapshotId: string;
+    comparedAt: string;
+    hasChanges: boolean;
+    isNoopCapture: boolean;
+}>;
+export declare const diffCountsSchema: z.ZodEffects<z.ZodObject<{
+    total: z.ZodNumber;
+    breaking: z.ZodNumber;
+    nonBreaking: z.ZodNumber;
+    info: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    breaking: number;
+    info: number;
+    total: number;
+    nonBreaking: number;
+}, {
+    breaking: number;
+    info: number;
+    total: number;
+    nonBreaking: number;
+}>, {
+    breaking: number;
+    info: number;
+    total: number;
+    nonBreaking: number;
+}, {
+    breaking: number;
+    info: number;
+    total: number;
+    nonBreaking: number;
+}>;
+export declare const endpointChangeSchema: z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodEnum<["get", "post", "put", "patch", "delete", "head", "options", "trace"]>;
+    classification: z.ZodEnum<["breaking", "non-breaking", "info"]>;
+    changeReason: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    method: "get" | "post" | "put" | "delete" | "patch" | "head" | "options" | "trace";
+    url: string;
+    classification: "breaking" | "non-breaking" | "info";
+    changeReason: string;
+}, {
+    method: "get" | "post" | "put" | "delete" | "patch" | "head" | "options" | "trace";
+    url: string;
+    classification: "breaking" | "non-breaking" | "info";
+    changeReason: string;
+}>;
+export declare const warningSchema: z.ZodObject<{
+    code: z.ZodEnum<["VERSION_ONLY_CHANGE", "VERSION_MISMATCH"]>;
+    message: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    code: "VERSION_ONLY_CHANGE" | "VERSION_MISMATCH";
+    message: string;
+}, {
+    code: "VERSION_ONLY_CHANGE" | "VERSION_MISMATCH";
+    message: string;
+}>;
+export declare const snapshotDiffResultSchema: z.ZodEffects<z.ZodObject<{
+    summary: z.ZodObject<{
+        projectKey: z.ZodString;
+        sourceUrl: z.ZodString;
+        baselineSnapshotId: z.ZodString;
+        targetSnapshotId: z.ZodString;
+        comparedAt: z.ZodString;
+        hasChanges: z.ZodBoolean;
+        isNoopCapture: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        projectKey: string;
+        sourceUrl: string;
+        baselineSnapshotId: string;
+        targetSnapshotId: string;
+        comparedAt: string;
+        hasChanges: boolean;
+        isNoopCapture: boolean;
+    }, {
+        projectKey: string;
+        sourceUrl: string;
+        baselineSnapshotId: string;
+        targetSnapshotId: string;
+        comparedAt: string;
+        hasChanges: boolean;
+        isNoopCapture: boolean;
+    }>;
+    counts: z.ZodEffects<z.ZodObject<{
+        total: z.ZodNumber;
+        breaking: z.ZodNumber;
+        nonBreaking: z.ZodNumber;
+        info: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        breaking: number;
+        info: number;
+        total: number;
+        nonBreaking: number;
+    }, {
+        breaking: number;
+        info: number;
+        total: number;
+        nonBreaking: number;
+    }>, {
+        breaking: number;
+        info: number;
+        total: number;
+        nonBreaking: number;
+    }, {
+        breaking: number;
+        info: number;
+        total: number;
+        nonBreaking: number;
+    }>;
+    changes: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        method: z.ZodEnum<["get", "post", "put", "patch", "delete", "head", "options", "trace"]>;
+        classification: z.ZodEnum<["breaking", "non-breaking", "info"]>;
+        changeReason: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        method: "get" | "post" | "put" | "delete" | "patch" | "head" | "options" | "trace";
+        url: string;
+        classification: "breaking" | "non-breaking" | "info";
+        changeReason: string;
+    }, {
+        method: "get" | "post" | "put" | "delete" | "patch" | "head" | "options" | "trace";
+        url: string;
+        classification: "breaking" | "non-breaking" | "info";
+        changeReason: string;
+    }>, "many">;
+    warnings: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<["VERSION_ONLY_CHANGE", "VERSION_MISMATCH"]>;
+        message: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        code: "VERSION_ONLY_CHANGE" | "VERSION_MISMATCH";
+        message: string;
+    }, {
+        code: "VERSION_ONLY_CHANGE" | "VERSION_MISMATCH";
+        message: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    summary: {
+        projectKey: string;
+        sourceUrl: string;
+        baselineSnapshotId: string;
+        targetSnapshotId: string;
+        comparedAt: string;
+        hasChanges: boolean;
+        isNoopCapture: boolean;
+    };
+    counts: {
+        breaking: number;
+        info: number;
+        total: number;
+        nonBreaking: number;
+    };
+    changes: {
+        method: "get" | "post" | "put" | "delete" | "patch" | "head" | "options" | "trace";
+        url: string;
+        classification: "breaking" | "non-breaking" | "info";
+        changeReason: string;
+    }[];
+    warnings: {
+        code: "VERSION_ONLY_CHANGE" | "VERSION_MISMATCH";
+        message: string;
+    }[];
+}, {
+    summary: {
+        projectKey: string;
+        sourceUrl: string;
+        baselineSnapshotId: string;
+        targetSnapshotId: string;
+        comparedAt: string;
+        hasChanges: boolean;
+        isNoopCapture: boolean;
+    };
+    counts: {
+        breaking: number;
+        info: number;
+        total: number;
+        nonBreaking: number;
+    };
+    changes: {
+        method: "get" | "post" | "put" | "delete" | "patch" | "head" | "options" | "trace";
+        url: string;
+        classification: "breaking" | "non-breaking" | "info";
+        changeReason: string;
+    }[];
+    warnings: {
+        code: "VERSION_ONLY_CHANGE" | "VERSION_MISMATCH";
+        message: string;
+    }[];
+}>, {
+    summary: {
+        projectKey: string;
+        sourceUrl: string;
+        baselineSnapshotId: string;
+        targetSnapshotId: string;
+        comparedAt: string;
+        hasChanges: boolean;
+        isNoopCapture: boolean;
+    };
+    counts: {
+        breaking: number;
+        info: number;
+        total: number;
+        nonBreaking: number;
+    };
+    changes: {
+        method: "get" | "post" | "put" | "delete" | "patch" | "head" | "options" | "trace";
+        url: string;
+        classification: "breaking" | "non-breaking" | "info";
+        changeReason: string;
+    }[];
+    warnings: {
+        code: "VERSION_ONLY_CHANGE" | "VERSION_MISMATCH";
+        message: string;
+    }[];
+}, {
+    summary: {
+        projectKey: string;
+        sourceUrl: string;
+        baselineSnapshotId: string;
+        targetSnapshotId: string;
+        comparedAt: string;
+        hasChanges: boolean;
+        isNoopCapture: boolean;
+    };
+    counts: {
+        breaking: number;
+        info: number;
+        total: number;
+        nonBreaking: number;
+    };
+    changes: {
+        method: "get" | "post" | "put" | "delete" | "patch" | "head" | "options" | "trace";
+        url: string;
+        classification: "breaking" | "non-breaking" | "info";
+        changeReason: string;
+    }[];
+    warnings: {
+        code: "VERSION_ONLY_CHANGE" | "VERSION_MISMATCH";
+        message: string;
+    }[];
+}>;
+export type DiffSummary = z.infer<typeof diffSummarySchema>;
+export type DiffCounts = z.infer<typeof diffCountsSchema>;
+export type EndpointChange = z.infer<typeof endpointChangeSchema>;
+export type DiffWarning = z.infer<typeof warningSchema>;
+export type SnapshotDiffResult = z.infer<typeof snapshotDiffResultSchema>;
+//# sourceMappingURL=snapshotDiffContract.d.ts.map

package/dist/domain/contracts/snapshotDiffContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotDiffContract.d.ts","sourceRoot":"","sources":["../../../src/domain/contracts/snapshotDiffContract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB,kFAAgF,CAAC;AAC9G,eAAO,MAAM,0BAA0B,iDAA+C,CAAC;AACvF,eAAO,MAAM,iBAAiB,wDAAsD,CAAC;AAErF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;EAUnB,CAAC;AAEZ,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;EAgBzB,CAAC;AAEL,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAOtB,CAAC;AAEZ,eAAO,MAAM,aAAa;;;;;;;;;EAKf,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuDjC,CAAC;AAEL,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACxD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}