swagger-parser-mcp-server 2.0.4 → 2.3.0

package/dist/domain/contracts/snapshotDiffContract.js

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+export const httpMethodSchema = z.enum(['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace']);
+export const changeClassificationSchema = z.enum(['breaking', 'non-breaking', 'info']);
+export const warningCodeSchema = z.enum(['VERSION_ONLY_CHANGE', 'VERSION_MISMATCH']);
+export const diffSummarySchema = z
+    .object({
+    projectKey: z.string().min(1),
+    sourceUrl: z.string().url(),
+    baselineSnapshotId: z.string().min(1),
+    targetSnapshotId: z.string().min(1),
+    comparedAt: z.string().datetime({ offset: true }),
+    hasChanges: z.boolean(),
+    isNoopCapture: z.boolean(),
+})
+    .strict();
+export const diffCountsSchema = z
+    .object({
+    total: z.number().int().nonnegative(),
+    breaking: z.number().int().nonnegative(),
+    nonBreaking: z.number().int().nonnegative(),
+    info: z.number().int().nonnegative(),
+})
+    .strict()
+    .superRefine((counts, context) => {
+    const calculatedTotal = counts.breaking + counts.nonBreaking + counts.info;
+    if (counts.total !== calculatedTotal) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'counts.total must equal breaking + nonBreaking + info',
+        });
+    }
+});
+export const endpointChangeSchema = z
+    .object({
+    url: z.string().min(1),
+    method: httpMethodSchema,
+    classification: changeClassificationSchema,
+    changeReason: z.string().min(1),
+})
+    .strict();
+export const warningSchema = z
+    .object({
+    code: warningCodeSchema,
+    message: z.string().min(1),
+})
+    .strict();
+export const snapshotDiffResultSchema = z
+    .object({
+    summary: diffSummarySchema,
+    counts: diffCountsSchema,
+    changes: z.array(endpointChangeSchema),
+    warnings: z.array(warningSchema),
+})
+    .strict()
+    .superRefine((result, context) => {
+    if (result.counts.total !== result.changes.length) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'counts.total must equal changes.length',
+        });
+    }
+    if (result.summary.hasChanges !== result.counts.total > 0) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'summary.hasChanges must match whether counts.total is greater than 0',
+        });
+    }
+    const classificationCounts = result.changes.reduce((acc, change) => {
+        if (change.classification === 'breaking') {
+            acc.breaking += 1;
+        }
+        else if (change.classification === 'non-breaking') {
+            acc.nonBreaking += 1;
+        }
+        else if (change.classification === 'info') {
+            acc.info += 1;
+        }
+        return acc;
+    }, { breaking: 0, nonBreaking: 0, info: 0 });
+    if (result.counts.breaking !== classificationCounts.breaking) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'counts.breaking must equal number of changes classified as breaking',
+        });
+    }
+    if (result.counts.nonBreaking !== classificationCounts.nonBreaking) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'counts.nonBreaking must equal number of changes classified as non-breaking',
+        });
+    }
+    if (result.counts.info !== classificationCounts.info) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'counts.info must equal number of changes classified as info',
+        });
+    }
+});
+//# sourceMappingURL=snapshotDiffContract.js.map

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

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

package/dist/domain/diff/endpointDiffClassifier.d.ts

@@ -0,0 +1,78 @@
+import { CanonicalEndpointSnapshot, CanonicalOperationShape, CanonicalSnapshot } from '../canonical/canonicalSnapshot.js';
+export type DiffClassification = 'breaking' | 'non-breaking' | 'info';
+export type EndpointChangeReason = 'method_added' | 'method_removed' | 'request_optional_to_required' | 'response_status_removed' | 'response_status_added' | 'response_media_type_removed' | 'response_media_type_added' | 'required_response_field_removed' | 'operation_structure_changed';
+export type EndpointChangeDetail = {
+    reason: 'method_added';
+    classification: 'non-breaking';
+    message: string;
+} | {
+    reason: 'method_removed';
+    classification: 'breaking';
+    message: string;
+} | {
+    reason: 'request_optional_to_required';
+    classification: 'breaking';
+    message: string;
+} | {
+    reason: 'response_status_removed';
+    classification: 'breaking';
+    message: string;
+    metadata: {
+        removedStatusCodes: string[];
+    };
+} | {
+    reason: 'response_status_added';
+    classification: 'non-breaking';
+    message: string;
+    metadata: {
+        addedStatusCodes: string[];
+    };
+} | {
+    reason: 'response_media_type_removed';
+    classification: 'breaking';
+    message: string;
+    metadata: {
+        statusCode: string;
+        removedMediaTypes: string[];
+    };
+} | {
+    reason: 'response_media_type_added';
+    classification: 'non-breaking';
+    message: string;
+    metadata: {
+        statusCode: string;
+        addedMediaTypes: string[];
+    };
+} | {
+    reason: 'required_response_field_removed';
+    classification: 'breaking';
+    message: string;
+    metadata: {
+        removedRequiredResponseFields: string[];
+    };
+} | {
+    reason: 'operation_structure_changed';
+    classification: 'info';
+    message: string;
+};
+export interface EndpointDiff {
+    url: string;
+    method: CanonicalEndpointSnapshot['method'];
+    classification: DiffClassification;
+    changeReason: EndpointChangeReason;
+    before: CanonicalOperationShape | null;
+    after: CanonicalOperationShape | null;
+    details: EndpointChangeDetail[];
+}
+export interface DiffCounts {
+    total: number;
+    breaking: number;
+    nonBreaking: number;
+    info: number;
+}
+export interface EndpointDiffClassificationResult {
+    changes: EndpointDiff[];
+    counts: DiffCounts;
+}
+export declare function classifyEndpointDiffs(baseline: CanonicalSnapshot, target: CanonicalSnapshot): EndpointDiffClassificationResult;
+//# sourceMappingURL=endpointDiffClassifier.d.ts.map

package/dist/domain/diff/endpointDiffClassifier.d.ts.map

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

package/dist/domain/diff/endpointDiffClassifier.js

@@ -0,0 +1,317 @@
+const CLASSIFICATION_PRIORITY = {
+    breaking: 3,
+    'non-breaking': 2,
+    info: 1,
+};
+const REASON_PRIORITY_ORDER = {
+    method_removed: 1,
+    request_optional_to_required: 2,
+    required_response_field_removed: 3,
+    response_status_removed: 4,
+    response_media_type_removed: 5,
+    method_added: 6,
+    response_status_added: 7,
+    response_media_type_added: 8,
+    operation_structure_changed: 9,
+};
+function getReasonPriority(reason) {
+    const priority = REASON_PRIORITY_ORDER[reason];
+    if (priority === undefined) {
+        throw new Error(`Reason priority is not configured for: ${reason}`);
+    }
+    return priority;
+}
+function endpointKey(endpoint) {
+    return `${endpoint.path}::${endpoint.method}`;
+}
+function sortEndpointChanges(changes) {
+    return [...changes].sort((left, right) => `${left.url}:${left.method}`.localeCompare(`${right.url}:${right.method}`));
+}
+function getPrimaryDetail(details) {
+    return [...details].sort((left, right) => {
+        const classificationDelta = CLASSIFICATION_PRIORITY[right.classification] - CLASSIFICATION_PRIORITY[left.classification];
+        if (classificationDelta !== 0) {
+            return classificationDelta;
+        }
+        return getReasonPriority(left.reason) - getReasonPriority(right.reason);
+    })[0];
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function collectRequiredPaths(schema, parentPath = '') {
+    const paths = new Set();
+    if (!isRecord(schema)) {
+        return paths;
+    }
+    const required = Array.isArray(schema.required) ? schema.required.filter(item => typeof item === 'string') : [];
+    const properties = isRecord(schema.properties) ? schema.properties : {};
+    required.forEach(propertyName => {
+        const propertyPath = parentPath ? `${parentPath}.${propertyName}` : propertyName;
+        paths.add(propertyPath);
+        const child = properties[propertyName];
+        if (isRecord(child) && child.type === 'array' && child.items !== undefined) {
+            collectRequiredPaths(child.items, `${propertyPath}[]`).forEach(path => paths.add(path));
+            return;
+        }
+        collectRequiredPaths(child, propertyPath).forEach(path => paths.add(path));
+    });
+    const compositionKeys = ['allOf', 'anyOf', 'oneOf'];
+    compositionKeys.forEach(compositionKey => {
+        const compositionValue = schema[compositionKey];
+        if (!Array.isArray(compositionValue)) {
+            return;
+        }
+        compositionValue.forEach(item => {
+            collectRequiredPaths(item, parentPath).forEach(path => paths.add(path));
+        });
+    });
+    return paths;
+}
+function mapResponseRequiredFields(responses) {
+    const requiredByStatus = new Map();
+    responses.forEach(response => {
+        const requiredByMediaType = new Map();
+        response.content.forEach(content => {
+            if (!content.hasSchema || content.schema === undefined) {
+                return;
+            }
+            requiredByMediaType.set(content.mediaType, collectRequiredPaths(content.schema));
+        });
+        requiredByStatus.set(response.statusCode, requiredByMediaType);
+    });
+    return requiredByStatus;
+}
+function detectRemovedRequiredResponseFields(before, after) {
+    const removedFieldPaths = [];
+    const beforeByStatus = mapResponseRequiredFields(before.responses);
+    const afterByStatus = mapResponseRequiredFields(after.responses);
+    beforeByStatus.forEach((beforeMediaMap, statusCode) => {
+        const afterMediaMap = afterByStatus.get(statusCode);
+        if (!afterMediaMap) {
+            return;
+        }
+        beforeMediaMap.forEach((beforeRequiredPaths, mediaType) => {
+            const afterRequiredPaths = afterMediaMap.get(mediaType);
+            if (!afterRequiredPaths) {
+                return;
+            }
+            beforeRequiredPaths.forEach(requiredPath => {
+                if (!afterRequiredPaths.has(requiredPath)) {
+                    removedFieldPaths.push(`${statusCode}:${mediaType}:${requiredPath}`);
+                }
+            });
+        });
+    });
+    return removedFieldPaths.sort();
+}
+function detectResponseMediaTypeChanges(before, after) {
+    const details = [];
+    const beforeByStatus = new Map(before.responses.map(response => [response.statusCode, response]));
+    const afterByStatus = new Map(after.responses.map(response => [response.statusCode, response]));
+    beforeByStatus.forEach((beforeResponse, statusCode) => {
+        const afterResponse = afterByStatus.get(statusCode);
+        if (!afterResponse) {
+            return;
+        }
+        const beforeMediaTypes = new Set(beforeResponse.content.map(content => content.mediaType));
+        const afterMediaTypes = new Set(afterResponse.content.map(content => content.mediaType));
+        const removedMediaTypes = Array.from(beforeMediaTypes)
+            .filter(mediaType => !afterMediaTypes.has(mediaType))
+            .sort();
+        if (removedMediaTypes.length > 0) {
+            details.push({
+                reason: 'response_media_type_removed',
+                classification: 'breaking',
+                message: `Response media type removed for ${statusCode}: ${removedMediaTypes.join(', ')}`,
+                metadata: {
+                    statusCode,
+                    removedMediaTypes,
+                },
+            });
+        }
+        const addedMediaTypes = Array.from(afterMediaTypes)
+            .filter(mediaType => !beforeMediaTypes.has(mediaType))
+            .sort();
+        if (addedMediaTypes.length > 0) {
+            details.push({
+                reason: 'response_media_type_added',
+                classification: 'non-breaking',
+                message: `Response media type added for ${statusCode}: ${addedMediaTypes.join(', ')}`,
+                metadata: {
+                    statusCode,
+                    addedMediaTypes,
+                },
+            });
+        }
+    });
+    return details;
+}
+function detectOperationDetails(before, after) {
+    const details = [];
+    const beforeRequestRequired = before.requestBody?.required === true;
+    const afterRequestRequired = after.requestBody?.required === true;
+    if (!beforeRequestRequired && afterRequestRequired) {
+        details.push({
+            reason: 'request_optional_to_required',
+            classification: 'breaking',
+            message: 'Request body changed from optional to required.',
+        });
+    }
+    const beforeStatusCodes = new Set(before.responses.map(response => response.statusCode));
+    const afterStatusCodes = new Set(after.responses.map(response => response.statusCode));
+    const removedStatusCodes = Array.from(beforeStatusCodes)
+        .filter(statusCode => !afterStatusCodes.has(statusCode))
+        .sort();
+    if (removedStatusCodes.length > 0) {
+        details.push({
+            reason: 'response_status_removed',
+            classification: 'breaking',
+            message: `Response status code removed: ${removedStatusCodes.join(', ')}`,
+            metadata: {
+                removedStatusCodes,
+            },
+        });
+    }
+    const addedStatusCodes = Array.from(afterStatusCodes)
+        .filter(statusCode => !beforeStatusCodes.has(statusCode))
+        .sort();
+    if (addedStatusCodes.length > 0) {
+        details.push({
+            reason: 'response_status_added',
+            classification: 'non-breaking',
+            message: `Response status code added: ${addedStatusCodes.join(', ')}`,
+            metadata: {
+                addedStatusCodes,
+            },
+        });
+    }
+    const removedRequiredResponseFields = detectRemovedRequiredResponseFields(before, after);
+    if (removedRequiredResponseFields.length > 0) {
+        details.push({
+            reason: 'required_response_field_removed',
+            classification: 'breaking',
+            message: `Required response field removed: ${removedRequiredResponseFields.join(', ')}`,
+            metadata: {
+                removedRequiredResponseFields,
+            },
+        });
+    }
+    details.push(...detectResponseMediaTypeChanges(before, after));
+    if (details.length === 0) {
+        details.push({
+            reason: 'operation_structure_changed',
+            classification: 'info',
+            message: 'Operation structure changed without a classified breaking rule.',
+        });
+    }
+    return details;
+}
+function createMethodAddedChange(endpoint) {
+    const details = [
+        {
+            reason: 'method_added',
+            classification: 'non-breaking',
+            message: 'Operation was added.',
+        },
+    ];
+    return {
+        url: endpoint.path,
+        method: endpoint.method,
+        classification: 'non-breaking',
+        changeReason: 'method_added',
+        before: null,
+        after: endpoint.canonicalOperation,
+        details,
+    };
+}
+function createMethodRemovedChange(endpoint) {
+    const details = [
+        {
+            reason: 'method_removed',
+            classification: 'breaking',
+            message: 'Operation was removed.',
+        },
+    ];
+    return {
+        url: endpoint.path,
+        method: endpoint.method,
+        classification: 'breaking',
+        changeReason: 'method_removed',
+        before: endpoint.canonicalOperation,
+        after: null,
+        details,
+    };
+}
+function toCounts(changes) {
+    return changes.reduce((acc, change) => {
+        acc.total += 1;
+        if (change.classification === 'breaking') {
+            acc.breaking += 1;
+        }
+        else if (change.classification === 'non-breaking') {
+            acc.nonBreaking += 1;
+        }
+        else {
+            acc.info += 1;
+        }
+        return acc;
+    }, {
+        total: 0,
+        breaking: 0,
+        nonBreaking: 0,
+        info: 0,
+    });
+}
+function buildEndpointMap(snapshot, snapshotLabel) {
+    const endpointMap = new Map();
+    snapshot.endpoints.forEach(endpoint => {
+        const key = endpointKey(endpoint);
+        if (endpointMap.has(key)) {
+            throw new Error(`Duplicate endpoint key detected in ${snapshotLabel} snapshot: ${key}`);
+        }
+        endpointMap.set(key, endpoint);
+    });
+    return endpointMap;
+}
+export function classifyEndpointDiffs(baseline, target) {
+    const baselineMap = buildEndpointMap(baseline, 'baseline');
+    const targetMap = buildEndpointMap(target, 'target');
+    const keys = Array.from(new Set([...baselineMap.keys(), ...targetMap.keys()])).sort();
+    const changes = [];
+    keys.forEach(key => {
+        const beforeEndpoint = baselineMap.get(key);
+        const afterEndpoint = targetMap.get(key);
+        if (beforeEndpoint && !afterEndpoint) {
+            changes.push(createMethodRemovedChange(beforeEndpoint));
+            return;
+        }
+        if (!beforeEndpoint && afterEndpoint) {
+            changes.push(createMethodAddedChange(afterEndpoint));
+            return;
+        }
+        if (!beforeEndpoint || !afterEndpoint) {
+            return;
+        }
+        if (beforeEndpoint.fingerprint === afterEndpoint.fingerprint) {
+            return;
+        }
+        const details = detectOperationDetails(beforeEndpoint.canonicalOperation, afterEndpoint.canonicalOperation);
+        const primaryDetail = getPrimaryDetail(details);
+        changes.push({
+            url: beforeEndpoint.path,
+            method: beforeEndpoint.method,
+            classification: primaryDetail.classification,
+            changeReason: primaryDetail.reason,
+            before: beforeEndpoint.canonicalOperation,
+            after: afterEndpoint.canonicalOperation,
+            details,
+        });
+    });
+    const sortedChanges = sortEndpointChanges(changes);
+    return {
+        changes: sortedChanges,
+        counts: toCounts(sortedChanges),
+    };
+}
+//# sourceMappingURL=endpointDiffClassifier.js.map

package/dist/domain/diff/endpointDiffClassifier.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

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

package/dist/http.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { createSnapshotToolRuntime } from './transport/createSnapshotToolRuntime.js';
+import { startSnapshotWebServer } from './transport/webServerRuntime.js';
+function isDirectExecution() {
+    const entryPoint = process.argv[1] ?? '';
+    return /(?:^|[/\\])http\.(?:ts|js)$/.test(entryPoint);
+}
+if (isDirectExecution()) {
+    const runtime = createSnapshotToolRuntime(process.env);
+    let webServer = null;
+    let shuttingDown = false;
+    const shutdown = async (exitCode) => {
+        if (shuttingDown) {
+            return;
+        }
+        shuttingDown = true;
+        if (webServer) {
+            await webServer.close().catch(() => undefined);
+            webServer = null;
+        }
+        await runtime.dispose().catch(() => undefined);
+        process.exit(exitCode);
+    };
+    process.on('SIGINT', () => {
+        void shutdown(0);
+    });
+    process.on('SIGTERM', () => {
+        void shutdown(0);
+    });
+    process.on('uncaughtException', error => {
+        console.error(error);
+        void shutdown(1);
+    });
+    process.on('unhandledRejection', reason => {
+        console.error(reason);
+        void shutdown(1);
+    });
+    startSnapshotWebServer({
+        env: process.env,
+        toolRouter: runtime.toolRouter,
+        forceEnable: true,
+    })
+        .then(startedServer => {
+        webServer = startedServer;
+        console.error(`Swagger Snapshot HTTP Server running on http://${startedServer.host}:${startedServer.port}`);
+    })
+        .catch(error => {
+        console.error(error);
+        void shutdown(1);
+    });
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAA2B,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAElG,SAAS,iBAAiB;IACxB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,OAAO,6BAA6B,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACxD,CAAC;AAED,IAAI,iBAAiB,EAAE,EAAE,CAAC;IACxB,MAAM,OAAO,GAAG,yBAAyB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvD,IAAI,SAAS,GAAmC,IAAI,CAAC;IAErD,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,MAAM,QAAQ,GAAG,KAAK,EAAE,QAAgB,EAAiB,EAAE;QACzD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,YAAY,GAAG,IAAI,CAAC;QACpB,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC/C,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QACD,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,KAAK,CAAC,EAAE;QACtC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,MAAM,CAAC,EAAE;QACxC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,sBAAsB,CAAC;QACrB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,WAAW,EAAE,IAAI;KAClB,CAAC;SACC,IAAI,CAAC,aAAa,CAAC,EAAE;QACpB,SAAS,GAAG,aAAa,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,kDAAkD,aAAa,CAAC,IAAI,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9G,CAAC,CAAC;SACD,KAAK,CAAC,KAAK,CAAC,EAAE;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 #!/usr/bin/env node
+type StdioInput = Pick<NodeJS.ReadStream, 'once' | 'off'>;
+export declare function attachStdioShutdownHooks(stdin: StdioInput, onClosed: () => void): () => void;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAOA,KAAK,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;AAE1D,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAiB5F"}