apiwatcher-cli 0.1.0

package/dist/specdiff/diff.test.js

@@ -0,0 +1,260 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { diffSpecs } from './diff.js';
+import { classifyTypeChange } from './compat.js';
+import { flattenOwnFields } from './openapi.js';
+/** Minimal spec builder so each test states only what it is about. */
+function spec(version, body = {}) {
+    return {
+        openapi: '3.0.0',
+        info: { version },
+        paths: {},
+        components: { schemas: {} },
+        ...body,
+    };
+}
+function formBody(properties, required = []) {
+    return {
+        content: {
+            'application/x-www-form-urlencoded': {
+                schema: { type: 'object', properties, ...(required.length > 0 ? { required } : {}) },
+            },
+        },
+    };
+}
+test('flattenOwnFields treats $ref as a boundary', () => {
+    const s = spec('2025-01-01', {
+        components: {
+            schemas: {
+                parent: {
+                    type: 'object',
+                    properties: {
+                        own: { type: 'string' },
+                        child: { $ref: '#/components/schemas/child' },
+                    },
+                },
+                child: { type: 'object', properties: { deep: { type: 'string' } } },
+            },
+        },
+    });
+    const fields = flattenOwnFields(s, s.components?.schemas?.parent);
+    assert.deepEqual([...fields.keys()].sort(), ['child', 'own']);
+    // `child.deep` belongs to the child schema and is diffed there, not here.
+    assert.equal(fields.has('child.deep'), false);
+});
+test('flattenOwnFields marks a field required only when every ancestor is', () => {
+    const s = spec('2025-01-01', {
+        components: {
+            schemas: {
+                root: {
+                    type: 'object',
+                    required: ['mandatory'],
+                    properties: {
+                        mandatory: { type: 'object', required: ['inner'], properties: { inner: { type: 'string' } } },
+                        optional: { type: 'object', required: ['inner'], properties: { inner: { type: 'string' } } },
+                    },
+                },
+            },
+        },
+    });
+    const fields = flattenOwnFields(s, s.components?.schemas?.root);
+    assert.equal(fields.get('mandatory.inner')?.requiredPath, true);
+    // Required inside an optional object: only binds callers who send the parent.
+    assert.equal(fields.get('optional.inner')?.required, true);
+    assert.equal(fields.get('optional.inner')?.requiredPath, false);
+});
+test('a removed endpoint is breaking', () => {
+    const before = spec('2025-01-01', { paths: { '/v1/old': { get: { operationId: 'GetOld' } } } });
+    const after = spec('2025-06-01', { paths: {} });
+    const cs = diffSpecs(before, after);
+    assert.equal(cs.changes.length, 1);
+    assert.equal(cs.changes[0]?.kind, 'removed');
+    assert.equal(cs.changes[0]?.location, 'operation');
+    assert.equal(cs.changes[0]?.severity, 'breaking');
+    assert.equal(cs.from, '2025-01-01');
+    assert.equal(cs.to, '2025-06-01');
+});
+test('a new endpoint is reported only with includeAdditive', () => {
+    const before = spec('2025-01-01', { paths: {} });
+    const after = spec('2025-06-01', { paths: { '/v1/new': { get: {} } } });
+    assert.equal(diffSpecs(before, after).changes.length, 0);
+    const withAdditive = diffSpecs(before, after, { includeAdditive: true });
+    assert.equal(withAdditive.changes.length, 1);
+    assert.equal(withAdditive.changes[0]?.severity, 'additive');
+});
+test('removing a request parameter does not also report its children', () => {
+    const before = spec('2025-01-01', {
+        paths: {
+            '/v1/x': {
+                post: {
+                    requestBody: formBody({
+                        tipping: {
+                            type: 'object',
+                            properties: { bgn: { type: 'object', properties: { amount: { type: 'integer' } } } },
+                        },
+                    }),
+                },
+            },
+        },
+    });
+    const after = spec('2025-06-01', {
+        paths: { '/v1/x': { post: { requestBody: formBody({ tipping: { type: 'object', properties: {} } }) } } },
+    });
+    const removed = diffSpecs(before, after).changes.filter((c) => c.kind === 'removed');
+    assert.deepEqual(removed.map((c) => c.field), ['tipping.bgn']);
+});
+test('an unrelated field pair is not mistaken for a rename', () => {
+    const before = spec('2025-01-01', {
+        paths: { '/v1/x': { post: { requestBody: formBody({ bgn: { type: 'string' } }) } } },
+    });
+    const after = spec('2025-06-01', {
+        paths: { '/v1/x': { post: { requestBody: formBody({ gip: { type: 'string' } }) } } },
+    });
+    const kinds = diffSpecs(before, after, { includeAdditive: true })
+        .changes.map((c) => c.kind)
+        .sort();
+    // Two unrelated currency keys: a removal and an addition, never a rename.
+    assert.deepEqual(kinds, ['added', 'removed']);
+});
+test('a genuine rename is detected', () => {
+    const before = spec('2025-01-01', {
+        paths: { '/v1/x': { post: { requestBody: formBody({ risk_level: { type: 'string' } }) } } },
+    });
+    const after = spec('2025-06-01', {
+        paths: { '/v1/x': { post: { requestBody: formBody({ level: { type: 'string' } }) } } },
+    });
+    const changes = diffSpecs(before, after).changes;
+    assert.equal(changes.length, 1);
+    assert.equal(changes[0]?.kind, 'renamed');
+    assert.equal(changes[0]?.field, 'risk_level');
+    assert.equal(changes[0]?.replacement, 'level');
+});
+test('a newly required nested parameter says what it is conditional on', () => {
+    const before = spec('2025-01-01', {
+        paths: {
+            '/v1/x': {
+                post: {
+                    requestBody: formBody({
+                        cfg: { type: 'object', properties: { a: { type: 'string' } } },
+                    }),
+                },
+            },
+        },
+    });
+    const after = spec('2025-06-01', {
+        paths: {
+            '/v1/x': {
+                post: {
+                    requestBody: formBody({
+                        cfg: { type: 'object', required: ['a'], properties: { a: { type: 'string' } } },
+                    }),
+                },
+            },
+        },
+    });
+    const changes = diffSpecs(before, after).changes;
+    assert.equal(changes.length, 1);
+    assert.equal(changes[0]?.kind, 'required');
+    assert.match(changes[0]?.note ?? '', /whenever "cfg" is provided/);
+});
+test('a top-level newly required parameter is stated unconditionally', () => {
+    const before = spec('2025-01-01', {
+        paths: { '/v1/x': { post: { requestBody: formBody({ a: { type: 'string' } }) } } },
+    });
+    const after = spec('2025-06-01', {
+        paths: { '/v1/x': { post: { requestBody: formBody({ a: { type: 'string' } }, ['a']) } } },
+    });
+    const changes = diffSpecs(before, after).changes;
+    assert.equal(changes[0]?.kind, 'required');
+    assert.doesNotMatch(changes[0]?.note ?? '', /whenever/);
+});
+test('response changes are attributed to the endpoints returning the resource', () => {
+    const build = (props, version) => spec(version, {
+        paths: {
+            '/v1/widgets/{id}': {
+                get: {
+                    responses: {
+                        '200': { content: { 'application/json': { schema: { $ref: '#/components/schemas/widget' } } } },
+                    },
+                },
+            },
+        },
+        components: {
+            schemas: { widget: { type: 'object', 'x-resourceId': 'widget', properties: props } },
+        },
+    });
+    const cs = diffSpecs(build({ keep: { type: 'string' }, gone: { type: 'string' } }, '2025-01-01'), build({ keep: { type: 'string' } }, '2025-06-01'));
+    assert.equal(cs.changes.length, 1);
+    const change = cs.changes[0];
+    assert.equal(change?.kind, 'removed');
+    assert.equal(change?.location, 'response');
+    assert.equal(change?.resource, 'widget');
+    assert.equal(change?.field, 'gone');
+    assert.deepEqual(change?.endpoints, [{ method: 'get', path: '/v1/widgets/{id}' }]);
+    assert.deepEqual(change?.fieldPaths, ['gone']);
+});
+test('a nested resource change cites the path a caller reads it through', () => {
+    const build = (childProps, version) => spec(version, {
+        paths: {
+            '/v1/parents': {
+                get: {
+                    responses: {
+                        '200': { content: { 'application/json': { schema: { $ref: '#/components/schemas/parent' } } } },
+                    },
+                },
+            },
+        },
+        components: {
+            schemas: {
+                parent: {
+                    type: 'object',
+                    properties: {
+                        items: { type: 'array', items: { $ref: '#/components/schemas/item' } },
+                    },
+                },
+                item: { type: 'object', properties: childProps },
+            },
+        },
+    });
+    const cs = diffSpecs(build({ amount: { type: 'integer' }, legacy: { type: 'string' } }, '2025-01-01'), build({ amount: { type: 'integer' } }, '2025-06-01'));
+    const change = cs.changes.find((c) => c.resource === 'item');
+    assert.ok(change, 'expected a change on the item schema');
+    assert.equal(change?.field, 'legacy');
+    // Reported once against `item`, but citeable at the path callers actually use.
+    assert.deepEqual(change?.fieldPaths, ['items[].legacy']);
+});
+test('a removed webhook event is breaking', () => {
+    const withEvents = (events, version) => spec(version, {
+        components: {
+            schemas: Object.fromEntries(events.map((e) => [e, { 'x-stripeEvent': { type: e } }])),
+        },
+    });
+    const cs = diffSpecs(withEvents(['a.b', 'c.d'], '2025-01-01'), withEvents(['a.b'], '2025-06-01'));
+    assert.equal(cs.changes.length, 1);
+    assert.equal(cs.changes[0]?.location, 'event');
+    assert.equal(cs.changes[0]?.event, 'c.d');
+    assert.equal(cs.changes[0]?.severity, 'breaking');
+});
+// --- type compatibility ----------------------------------------------------
+test('enum widening is additive, narrowing breaks only the sending side', () => {
+    const narrow = 'enum(a|b)';
+    const wide = 'enum(a|b|c)';
+    assert.equal(classifyTypeChange(narrow, wide, 'request').severity, 'additive');
+    assert.equal(classifyTypeChange(narrow, wide, 'response').severity, 'additive');
+    // Losing an accepted value breaks callers who send it.
+    assert.equal(classifyTypeChange(wide, narrow, 'request').severity, 'breaking');
+    // Losing a returned value only leaves a dead branch behind.
+    assert.equal(classifyTypeChange(wide, narrow, 'response').severity, 'additive');
+});
+test('a scalar type swap is breaking in both directions', () => {
+    for (const direction of ['request', 'response']) {
+        const verdict = classifyTypeChange('integer', 'string', direction);
+        assert.equal(verdict.changed, true);
+        assert.equal(verdict.severity, 'breaking');
+    }
+});
+test('identical signatures are not a change', () => {
+    assert.equal(classifyTypeChange('enum(a|b)', 'enum(b|a)', 'request').changed, false);
+    assert.equal(classifyTypeChange('string', 'string', 'response').changed, false);
+});
+//# sourceMappingURL=diff.test.js.map

package/dist/specdiff/diff.test.js.map

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

package/dist/specdiff/fetch.d.ts

@@ -0,0 +1,28 @@
+import type { OpenApiSpec } from './openapi.js';
+export declare const STRIPE_SPEC_REPO = "stripe/openapi";
+/** The `.sdk.` variant carries `x-stripeOperations`, which the plain spec omits. */
+export declare const STRIPE_SPEC_PATH = "openapi/spec3.sdk.json";
+export interface SpecCommit {
+    sha: string;
+    date: string;
+}
+/** Commits that touched the spec, newest first. */
+export declare function listSpecCommits(options?: {
+    perPage?: number;
+    until?: string;
+}): Promise<SpecCommit[]>;
+/**
+ * Resolve a ref to the commit that last touched the spec.
+ *
+ * The watcher records where it stopped so the next run can diff forward from
+ * there. Recording a branch name instead of a SHA would mean diffing a moving
+ * target against itself and silently finding nothing, so always pin.
+ */
+export declare function resolveSpecCommit(ref: string): Promise<string>;
+/** Fetch the spec at a git ref. ~10MB, so callers should cache. */
+export declare function fetchSpecAt(ref: string): Promise<OpenApiSpec>;
+export declare function readSpecFile(file: string): Promise<OpenApiSpec>;
+/** `"2026-08-26.dahlia"` -> a safe filename segment. */
+export declare function versionSlug(version: string): string;
+export declare function changesetFilename(from: string, to: string): string;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/specdiff/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/specdiff/fetch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AACjD,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,2BAA2B,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAsBD,mDAAmD;AACnD,wBAAsB,eAAe,CAAC,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAChG,UAAU,EAAE,CACb,CAWA;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQpE;AAED,mEAAmE;AACnE,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAKnE;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAErE;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/dist/specdiff/fetch.js

@@ -0,0 +1,68 @@
+import { readFile } from 'node:fs/promises';
+export const STRIPE_SPEC_REPO = 'stripe/openapi';
+/** The `.sdk.` variant carries `x-stripeOperations`, which the plain spec omits. */
+export const STRIPE_SPEC_PATH = 'openapi/spec3.sdk.json';
+function ghHeaders() {
+    const headers = {
+        accept: 'application/vnd.github+json',
+        'user-agent': 'apiwatcher-spec-watcher',
+    };
+    // Unauthenticated GitHub allows 60 requests/hour, which is plenty for a cron
+    // but not for local iteration. Honour a token when one is present.
+    const token = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
+    if (token)
+        headers.authorization = `Bearer ${token}`;
+    return headers;
+}
+async function ghJson(url) {
+    const res = await fetch(url, { headers: ghHeaders() });
+    if (!res.ok) {
+        throw new Error(`GitHub ${res.status} ${res.statusText} for ${url}`);
+    }
+    return (await res.json());
+}
+/** Commits that touched the spec, newest first. */
+export async function listSpecCommits(options = {}) {
+    const params = new URLSearchParams({
+        path: STRIPE_SPEC_PATH,
+        per_page: String(options.perPage ?? 30),
+    });
+    if (options.until)
+        params.set('until', options.until);
+    const commits = await ghJson(`https://api.github.com/repos/${STRIPE_SPEC_REPO}/commits?${params.toString()}`);
+    return commits.map((c) => ({ sha: c.sha, date: c.commit.committer.date }));
+}
+/**
+ * Resolve a ref to the commit that last touched the spec.
+ *
+ * The watcher records where it stopped so the next run can diff forward from
+ * there. Recording a branch name instead of a SHA would mean diffing a moving
+ * target against itself and silently finding nothing, so always pin.
+ */
+export async function resolveSpecCommit(ref) {
+    const params = new URLSearchParams({ path: STRIPE_SPEC_PATH, sha: ref, per_page: '1' });
+    const commits = await ghJson(`https://api.github.com/repos/${STRIPE_SPEC_REPO}/commits?${params.toString()}`);
+    const sha = commits[0]?.sha;
+    if (!sha)
+        throw new Error(`Could not resolve ${STRIPE_SPEC_REPO}@${ref} to a commit`);
+    return sha;
+}
+/** Fetch the spec at a git ref. ~10MB, so callers should cache. */
+export async function fetchSpecAt(ref) {
+    const url = `https://raw.githubusercontent.com/${STRIPE_SPEC_REPO}/${ref}/${STRIPE_SPEC_PATH}`;
+    const res = await fetch(url, { headers: { 'user-agent': 'apiwatcher-spec-watcher' } });
+    if (!res.ok)
+        throw new Error(`Failed to fetch spec at ${ref}: ${res.status} ${res.statusText}`);
+    return (await res.json());
+}
+export async function readSpecFile(file) {
+    return JSON.parse(await readFile(file, 'utf8'));
+}
+/** `"2026-08-26.dahlia"` -> a safe filename segment. */
+export function versionSlug(version) {
+    return version.replace(/[^a-z0-9.-]/gi, '_');
+}
+export function changesetFilename(from, to) {
+    return `${versionSlug(from)}__${versionSlug(to)}.json`;
+}
+//# sourceMappingURL=fetch.js.map

package/dist/specdiff/fetch.js.map

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

package/dist/specdiff/methodmap.d.ts

@@ -0,0 +1,45 @@
+import type { SdkMethodRef } from '../changeset/types.js';
+/**
+ * Maps an HTTP endpoint to the stripe-node calls that reach it, and back.
+ *
+ * Generated from the stripe package's own generated resource files, so it is
+ * ground truth rather than a guess at Stripe's pluralization rules.
+ */
+export interface MethodMap {
+    /** stripe-node version the map was generated from. */
+    sdkVersion: string;
+    generatedAt: string;
+    /** `"post /v1/payment_intents"` -> [{ namespace: 'paymentIntents', method: 'create' }] */
+    byEndpoint: Record<string, SdkMethodRef[]>;
+    /** `"paymentIntents.create"` -> { method: 'post', path: '/v1/payment_intents' } */
+    byCall: Record<string, {
+        method: string;
+        path: string;
+    }>;
+}
+export declare function endpointKey(method: string, path: string): string;
+export declare function callKey(namespace: string, method: string): string;
+/** Walk up from this module looking for the committed map. */
+export declare function defaultMethodMapPath(): string | null;
+/** The webhook event types a spec version defines. */
+export interface EventCatalog {
+    apiVersion: string;
+    generatedAt: string;
+    events: string[];
+}
+export declare function defaultEventCatalogPath(): string | null;
+/**
+ * Known event types, used to tell a real webhook event string apart from any
+ * other dotted lowercase literal. Without it the scanner has to guess from
+ * context and reports lower confidence.
+ */
+export declare function loadEventCatalog(file?: string): Promise<ReadonlySet<string> | null>;
+export declare function loadMethodMap(file?: string): Promise<MethodMap>;
+/**
+ * Endpoint paths in the spec use `{customer}`; stripe-node builds them from
+ * template literals. Both sides normalize to `{}` so they compare equal
+ * regardless of what the parameter happens to be called.
+ */
+export declare function normalizePath(path: string): string;
+export declare function lookupSdkMethods(map: MethodMap, method: string, path: string): SdkMethodRef[];
+//# sourceMappingURL=methodmap.d.ts.map

package/dist/specdiff/methodmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methodmap.d.ts","sourceRoot":"","sources":["../../src/specdiff/methodmap.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAI1D;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAC3C,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjE;AASD,8DAA8D;AAC9D,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAUpD;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAUvD;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CASzF;AAED,wBAAsB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAQrE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAyBD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAI7F"}

package/dist/specdiff/methodmap.js

@@ -0,0 +1,109 @@
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const HERE = dirname(fileURLToPath(import.meta.url));
+export function endpointKey(method, path) {
+    return `${method.toLowerCase()} ${path}`;
+}
+export function callKey(namespace, method) {
+    return `${namespace}.${method}`;
+}
+const EMPTY = {
+    sdkVersion: 'unknown',
+    generatedAt: new Date(0).toISOString(),
+    byEndpoint: {},
+    byCall: {},
+};
+/** Walk up from this module looking for the committed map. */
+export function defaultMethodMapPath() {
+    let dir = HERE;
+    for (let i = 0; i < 8; i++) {
+        const candidate = join(dir, 'data', 'stripe', 'method-map.json');
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+export function defaultEventCatalogPath() {
+    let dir = HERE;
+    for (let i = 0; i < 8; i++) {
+        const candidate = join(dir, 'data', 'stripe', 'events.json');
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/**
+ * Known event types, used to tell a real webhook event string apart from any
+ * other dotted lowercase literal. Without it the scanner has to guess from
+ * context and reports lower confidence.
+ */
+export async function loadEventCatalog(file) {
+    const path = file ? resolve(file) : defaultEventCatalogPath();
+    if (!path || !existsSync(path))
+        return null;
+    try {
+        const parsed = JSON.parse(await readFile(path, 'utf8'));
+        return Array.isArray(parsed.events) ? new Set(parsed.events) : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function loadMethodMap(file) {
+    const path = file ? resolve(file) : defaultMethodMapPath();
+    if (!path || !existsSync(path))
+        return EMPTY;
+    const parsed = JSON.parse(await readFile(path, 'utf8'));
+    if (!parsed.byEndpoint || !parsed.byCall) {
+        throw new Error(`${path}: not a method map (missing byEndpoint/byCall)`);
+    }
+    return parsed;
+}
+/**
+ * Endpoint paths in the spec use `{customer}`; stripe-node builds them from
+ * template literals. Both sides normalize to `{}` so they compare equal
+ * regardless of what the parameter happens to be called.
+ */
+export function normalizePath(path) {
+    return path.replace(/\{[^}]*\}/g, '{}');
+}
+/**
+ * Parameter names differ between sources — the spec says `{intent}`, stripe-node
+ * builds `{id}` — so lookups fall back to a name-insensitive index. Built once
+ * per map and cached, since the differ calls this for every operation.
+ */
+const normalizedIndexes = new WeakMap();
+function normalizedIndex(map) {
+    const cached = normalizedIndexes.get(map);
+    if (cached)
+        return cached;
+    const index = new Map();
+    for (const [key, refs] of Object.entries(map.byEndpoint)) {
+        const sep = key.indexOf(' ');
+        const normalized = `${key.slice(0, sep)} ${normalizePath(key.slice(sep + 1))}`;
+        const bucket = index.get(normalized);
+        if (bucket)
+            bucket.push(...refs);
+        else
+            index.set(normalized, [...refs]);
+    }
+    normalizedIndexes.set(map, index);
+    return index;
+}
+export function lookupSdkMethods(map, method, path) {
+    const exact = map.byEndpoint[endpointKey(method, path)];
+    if (exact)
+        return exact;
+    return normalizedIndex(map).get(`${method.toLowerCase()} ${normalizePath(path)}`) ?? [];
+}
+//# sourceMappingURL=methodmap.js.map

package/dist/specdiff/methodmap.js.map

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