@ir-kit/openapi-tools 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ahmed Rowaihi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# @ir-kit/openapi-tools
+
+OpenAPI utilities built on top of [`@hey-api/codegen-core`](https://github.com/hey-api/openapi-ts) and `@hey-api/shared`. Spec diffing, parsing, and helpers — usable on their own without `@hey-api/openapi-ts` plugins.
+
+Part of [ir-kit](https://github.com/ir-kit/ir-kit).
+
+## Install
+
+```bash
+pnpm add @ir-kit/openapi-tools @hey-api/codegen-core @hey-api/shared
+```
+
+## Usage
+
+### Diff two OpenAPI specs
+
+```ts
+import { diffSpecs, parseSpec } from "@ir-kit/openapi-tools";
+
+const before = parseSpec(beforeJson);
+const after = parseSpec(afterJson);
+
+const report = diffSpecs(before, after, {
+  filter: (method, path) => path.startsWith("/v1"),
+  compare: { request: true, response: true, params: true },
+});
+```
+
+### Parse a spec into hey-api's IR
+
+```ts
+import { parseSpec } from "@ir-kit/openapi-tools";
+
+const ir = parseSpec(openApiSpecJson);
+```
+
+## API
+
+| Export | Description |
+| --- | --- |
+| `diffSpecs(before, after, options?)` | Compare two parsed specs, return endpoint-level diff |
+| `parseSpec(spec)` | Parse OpenAPI 2.0 / 3.0 / 3.1 into the shared IR |
+| `DiffOptions` / `DiffReport` / `EndpointDiff` / `ShapeDiff` / `TypeChange` / `RequiredChange` | Public types |
+| `IR` (re-export) | hey-api shared IR namespace |
+
+## Origin
+
+Previously shipped as `@ir-kit/openapi-ts-orpc/tools` subpath. Extracted into its own package since the utilities are spec-host-agnostic — they don't depend on oRPC.

package/dist/diff.d.ts

@@ -0,0 +1,65 @@
+import { type IR } from "@hey-api/shared";
+export interface DiffOptions {
+    /** Only include endpoints where this returns true. */
+    filter?: (method: string, path: string) => boolean;
+    /** Which layers to compare. All enabled by default. Set to false to skip. */
+    compare?: {
+        request?: boolean;
+        response?: boolean;
+        params?: boolean;
+        query?: boolean;
+        headers?: boolean;
+        cookies?: boolean;
+    };
+}
+export interface TypeChange {
+    key: string;
+    base: string;
+    head: string;
+}
+export interface RequiredChange {
+    key: string;
+    base: boolean;
+    head: boolean;
+}
+export interface ShapeDiff {
+    added: string[];
+    removed: string[];
+    typeChanged: TypeChange[];
+    requiredChanged: RequiredChange[];
+}
+export interface EndpointDiff {
+    endpoint: string;
+    method: string;
+    path: string;
+    request: ShapeDiff | null;
+    response: ShapeDiff | null;
+    params: ShapeDiff | null;
+    query: ShapeDiff | null;
+    headers: ShapeDiff | null;
+    cookies: ShapeDiff | null;
+}
+export interface DiffReport {
+    generatedAt: string;
+    summary: {
+        shared: number;
+        matching: number;
+        differing: number;
+        onlyInBase: number;
+        onlyInHead: number;
+        drifts: number;
+    };
+    matching: string[];
+    diffed: EndpointDiff[];
+    onlyInBase: string[];
+    onlyInHead: string[];
+}
+/**
+ * Diff two parsed OpenAPI specs (IR models).
+ *
+ * @param base - The reference spec (source of truth).
+ * @param head - The spec to compare against base.
+ * @param options - Filter endpoints, configure behavior.
+ */
+export declare function diffSpecs(base: IR.Model, head: IR.Model, options?: DiffOptions): DiffReport;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,EAAE,EAKR,MAAM,iBAAiB,CAAC;AAMzB,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnD,6EAA6E;IAC7E,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAqPD;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,EAAE,CAAC,KAAK,EACd,IAAI,EAAE,EAAE,CAAC,KAAK,EACd,OAAO,CAAC,EAAE,WAAW,GACpB,UAAU,CAkHZ"}

package/dist/diff.js

@@ -0,0 +1,296 @@
+import { fromRef, ref } from "@hey-api/codegen-core";
+import { childContext, createSchemaWalker, operationResponsesMap, } from "@hey-api/shared";
+function typedEntries(obj) {
+    return Object.entries(obj);
+}
+function pathKey(ctx) {
+    return fromRef(ctx.path).join(".");
+}
+function createShapeCollector(store) {
+    const shape = new Map();
+    const visitor = {
+        applyModifiers() { },
+        array(schema, ctx, walk) {
+            const key = pathKey(ctx);
+            const item = schema.items?.[0];
+            if (item && (item.properties || item.$ref)) {
+                shape.set(key, { type: "array<object>", required: false });
+                walk(item, childContext(ctx, "[]"));
+            }
+            else {
+                shape.set(key, {
+                    type: `array<${item?.type ?? "unknown"}>`,
+                    required: false,
+                });
+            }
+        },
+        boolean(_s, ctx) {
+            shape.set(pathKey(ctx), { type: "boolean", required: false });
+        },
+        enum(schema, ctx) {
+            const values = (schema.items ?? [])
+                .map((i) => (i.const != null ? String(i.const) : ""))
+                .filter(Boolean)
+                .sort();
+            shape.set(pathKey(ctx), {
+                type: values.length ? `enum(${values.join("|")})` : "enum",
+                required: false,
+            });
+        },
+        integer(_s, ctx) {
+            shape.set(pathKey(ctx), { type: "integer", required: false });
+        },
+        intersection(items) {
+            void items;
+        },
+        never(_s, ctx) {
+            shape.set(pathKey(ctx), { type: "never", required: false });
+        },
+        null(_s, ctx) {
+            shape.set(pathKey(ctx), { type: "null", required: false });
+        },
+        number(_s, ctx) {
+            shape.set(pathKey(ctx), { type: "number", required: false });
+        },
+        object(schema, ctx, walk) {
+            const key = pathKey(ctx);
+            if (key)
+                shape.set(key, { type: "object", required: false });
+            if (!schema.properties)
+                return;
+            const requiredSet = new Set(schema.required ?? []);
+            for (const [name, prop] of typedEntries(schema.properties)) {
+                const propCtx = childContext(ctx, name);
+                walk(prop, propCtx);
+                const existing = shape.get(pathKey(propCtx));
+                if (existing)
+                    existing.required = requiredSet.has(name);
+            }
+        },
+        reference($ref, _schema, ctx) {
+            const name = $ref.split("/").at(-1);
+            if (name && store[name])
+                walk(store[name], ctx);
+        },
+        string(_s, ctx) {
+            shape.set(pathKey(ctx), { type: "string", required: false });
+        },
+        tuple(schema, ctx, walk) {
+            shape.set(pathKey(ctx), { type: "tuple", required: false });
+            for (const [i, item] of (schema.items ?? []).entries()) {
+                walk(item, childContext(ctx, i));
+            }
+        },
+        undefined(_s, ctx) {
+            shape.set(pathKey(ctx), { type: "undefined", required: false });
+        },
+        union(items) {
+            void items;
+        },
+        unknown(_s, ctx) {
+            shape.set(pathKey(ctx), { type: "unknown", required: false });
+        },
+        void(_s, ctx) {
+            shape.set(pathKey(ctx), { type: "void", required: false });
+        },
+    };
+    const walk = createSchemaWalker(visitor);
+    return { walk, shape };
+}
+function collectShape(schema, store) {
+    const { walk, shape } = createShapeCollector(store);
+    walk(schema, { path: ref([]), plugin: null });
+    // Replace empty root key with a typed root entry
+    if (shape.has("")) {
+        const root = shape.get("");
+        shape.delete("");
+        shape.set("(root)", root);
+    }
+    else if (shape.size === 0 && schema.type) {
+        shape.set("(root)", { type: schema.type, required: false });
+    }
+    return shape;
+}
+function collectParamsShape(params, store) {
+    const shape = new Map();
+    if (!params)
+        return shape;
+    for (const [name, param] of typedEntries(params)) {
+        const paramShape = collectShape(param.schema, store);
+        if (paramShape.size === 1 && paramShape.has("(root)")) {
+            const root = paramShape.get("(root)");
+            shape.set(name, { type: root.type, required: param.required ?? false });
+        }
+        else {
+            shape.set(name, { type: "object", required: param.required ?? false });
+            for (const [key, info] of paramShape) {
+                if (key === "(root)")
+                    continue;
+                shape.set(`${name}.${key}`, info);
+            }
+        }
+    }
+    return shape;
+}
+function diffShapes(base, head) {
+    const added = [];
+    const removed = [];
+    const typeChanged = [];
+    const requiredChanged = [];
+    for (const [key] of head)
+        if (!base.has(key))
+            added.push(key);
+    for (const [key] of base)
+        if (!head.has(key))
+            removed.push(key);
+    for (const [key, b] of base) {
+        const h = head.get(key);
+        if (!h)
+            continue;
+        if (b.type !== h.type)
+            typeChanged.push({ key, base: b.type, head: h.type });
+        if (b.required !== h.required)
+            requiredChanged.push({ key, base: b.required, head: h.required });
+    }
+    if (!added.length &&
+        !removed.length &&
+        !typeChanged.length &&
+        !requiredChanged.length)
+        return null;
+    return { added, removed, typeChanged, requiredChanged };
+}
+function extractEndpoints(paths, filter) {
+    const result = new Map();
+    if (!paths)
+        return result;
+    for (const [path, pathItem] of typedEntries(paths)) {
+        for (const method of ["get", "post", "put", "patch", "delete"]) {
+            const op = pathItem[method];
+            if (!op)
+                continue;
+            if (filter && !filter(method.toUpperCase(), path))
+                continue;
+            const key = `${method.toUpperCase()} ${path}`;
+            const resMap = operationResponsesMap(op);
+            result.set(key, {
+                request: op.body?.schema,
+                response: resMap.response,
+                params: op.parameters?.path,
+                query: op.parameters?.query,
+                headers: op.parameters?.header,
+                cookies: op.parameters?.cookie,
+            });
+        }
+    }
+    return result;
+}
+function countDrifts(diffed) {
+    let n = 0;
+    for (const d of diffed) {
+        for (const s of [
+            d.request,
+            d.response,
+            d.params,
+            d.query,
+            d.headers,
+            d.cookies,
+        ]) {
+            if (!s)
+                continue;
+            n +=
+                s.removed.length +
+                    s.added.length +
+                    s.typeChanged.length +
+                    s.requiredChanged.length;
+        }
+    }
+    return n;
+}
+/**
+ * Diff two parsed OpenAPI specs (IR models).
+ *
+ * @param base - The reference spec (source of truth).
+ * @param head - The spec to compare against base.
+ * @param options - Filter endpoints, configure behavior.
+ */
+export function diffSpecs(base, head, options) {
+    const baseStore = base.components?.schemas ?? {};
+    const headStore = head.components?.schemas ?? {};
+    const cmp = {
+        request: options?.compare?.request !== false,
+        response: options?.compare?.response !== false,
+        params: options?.compare?.params !== false,
+        query: options?.compare?.query !== false,
+        headers: options?.compare?.headers !== false,
+        cookies: options?.compare?.cookies !== false,
+    };
+    const baseEps = extractEndpoints(base.paths, options?.filter);
+    const headEps = extractEndpoints(head.paths, options?.filter);
+    const baseKeys = new Set(baseEps.keys());
+    const headKeys = new Set(headEps.keys());
+    const shared = [...headKeys].filter((k) => baseKeys.has(k)).sort();
+    const onlyInBase = [...baseKeys].filter((k) => !headKeys.has(k)).sort();
+    const onlyInHead = [...headKeys].filter((k) => !baseKeys.has(k)).sort();
+    const matching = [];
+    const diffed = [];
+    for (const key of shared) {
+        const b = baseEps.get(key);
+        const h = headEps.get(key);
+        const reqDiff = cmp.request && b.request && h.request
+            ? diffShapes(collectShape(b.request, baseStore), collectShape(h.request, headStore))
+            : null;
+        const resDiff = cmp.response && b.response && h.response
+            ? diffShapes(collectShape(b.response, baseStore), collectShape(h.response, headStore))
+            : null;
+        const paramsDiff = cmp.params
+            ? diffShapes(collectParamsShape(b.params, baseStore), collectParamsShape(h.params, headStore))
+            : null;
+        const queryDiff = cmp.query
+            ? diffShapes(collectParamsShape(b.query, baseStore), collectParamsShape(h.query, headStore))
+            : null;
+        const headersDiff = cmp.headers
+            ? diffShapes(collectParamsShape(b.headers, baseStore), collectParamsShape(h.headers, headStore))
+            : null;
+        const cookiesDiff = cmp.cookies
+            ? diffShapes(collectParamsShape(b.cookies, baseStore), collectParamsShape(h.cookies, headStore))
+            : null;
+        if (reqDiff ||
+            resDiff ||
+            paramsDiff ||
+            queryDiff ||
+            headersDiff ||
+            cookiesDiff) {
+            const [method, ...rest] = key.split(" ");
+            diffed.push({
+                endpoint: key,
+                method: method,
+                path: rest.join(" "),
+                request: reqDiff,
+                response: resDiff,
+                params: paramsDiff,
+                query: queryDiff,
+                headers: headersDiff,
+                cookies: cookiesDiff,
+            });
+        }
+        else {
+            matching.push(key);
+        }
+    }
+    return {
+        generatedAt: new Date().toISOString(),
+        summary: {
+            shared: shared.length,
+            matching: matching.length,
+            differing: diffed.length,
+            onlyInBase: onlyInBase.length,
+            onlyInHead: onlyInHead.length,
+            drifts: countDrifts(diffed),
+        },
+        matching,
+        diffed,
+        onlyInBase,
+        onlyInHead,
+    };
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { type DiffOptions, type DiffReport, diffSpecs, type EndpointDiff, type RequiredChange, type ShapeDiff, type TypeChange, } from "./diff.js";
+export { routesFromIR } from "./ir.js";
+export { type LoadSpecOptions, loadSpec, resolveSpecInput, type SpecInput, } from "./load.js";
+export { type ExtractParams, isInSpec, type MatchResult, match, } from "./match.js";
+export type { IR } from "./parse.js";
+export { parseSpec } from "./parse.js";
+export type { Route } from "./route.js";
+export { createRouter, type Router } from "./router.js";
+export { type EnumLiteral, getEnumLiterals, isEnumSchema, isUnionSchema, } from "./schema.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EACL,KAAK,eAAe,EACpB,QAAQ,EACR,gBAAgB,EAChB,KAAK,SAAS,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,aAAa,EAClB,QAAQ,EACR,KAAK,WAAW,EAChB,KAAK,GACN,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EACL,KAAK,WAAW,EAChB,eAAe,EACf,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { diffSpecs, } from "./diff.js";
+export { routesFromIR } from "./ir.js";
+export { loadSpec, resolveSpecInput, } from "./load.js";
+export { isInSpec, match, } from "./match.js";
+export { parseSpec } from "./parse.js";
+export { createRouter } from "./router.js";
+export { getEnumLiterals, isEnumSchema, isUnionSchema, } from "./schema.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,SAAS,GAKV,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAEL,QAAQ,EACR,gBAAgB,GAEjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAEL,QAAQ,EAER,KAAK,GACN,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AACxD,OAAO,EAEL,eAAe,EACf,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC"}

package/dist/ir.d.ts

@@ -0,0 +1,5 @@
+import type { IR } from "@hey-api/shared";
+import type { Route } from "./route.js";
+/** Extract `Route[]` from a parsed IR — for runtime-loaded specs without codegen. */
+export declare function routesFromIR(ir: IR.Model): Route[];
+//# sourceMappingURL=ir.d.ts.map

package/dist/ir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAkBxC,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,EAAE,CAkBlD"}

package/dist/ir.js

@@ -0,0 +1,36 @@
+const HTTP_METHODS = [
+    "get",
+    "put",
+    "post",
+    "delete",
+    "options",
+    "head",
+    "patch",
+    "trace",
+];
+/** `/users/{id}/posts/{postId}` → `/users/:id/posts/:postId` */
+function specToPattern(spec) {
+    return spec.replace(/\{([^}]+)\}/g, ":$1");
+}
+/** Extract `Route[]` from a parsed IR — for runtime-loaded specs without codegen. */
+export function routesFromIR(ir) {
+    const out = [];
+    const paths = ir.paths ?? {};
+    for (const [spec, pathItem] of Object.entries(paths)) {
+        if (!pathItem)
+            continue;
+        for (const method of HTTP_METHODS) {
+            const op = pathItem[method];
+            if (!op)
+                continue;
+            out.push({
+                spec,
+                pattern: specToPattern(spec),
+                method,
+                operationId: op.operationId,
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=ir.js.map

package/dist/ir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir.js","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"AAIA,MAAM,YAAY,GAAG;IACnB,KAAK;IACL,KAAK;IACL,MAAM;IACN,QAAQ;IACR,SAAS;IACT,MAAM;IACN,OAAO;IACP,OAAO;CACC,CAAC;AAEX,gEAAgE;AAChE,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,EAAY;IACvC,MAAM,GAAG,GAAY,EAAE,CAAC;IACxB,MAAM,KAAK,GACR,EAA0D,CAAC,KAAK,IAAI,EAAE,CAAC;IAC1E,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;YAClC,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAyC,CAAC;YACpE,IAAI,CAAC,EAAE;gBAAE,SAAS;YAClB,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI;gBACJ,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC;gBAC5B,MAAM;gBACN,WAAW,EAAE,EAAE,CAAC,WAAW;aAC5B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/load.d.ts

@@ -0,0 +1,27 @@
+import { type NormalizeOptions } from "@ir-kit/openapi-core";
+export type SpecInput = string | Record<string, unknown>;
+export interface LoadSpecOptions {
+    /** File path, URL, or pre-parsed spec object. */
+    input: SpecInput;
+    /** Working directory used to resolve relative paths. Default: `process.cwd()`. */
+    cwd?: string;
+    /**
+     * Apply normalization after bundling. `true` enables the safe preset
+     * shared by every generator; pass an object for custom rules.
+     */
+    normalize?: boolean | NormalizeOptions;
+}
+/**
+ * Single-source loader for every generator in the workspace.
+ * Path-vs-URL detection, `$RefParser.bundle()`, and the optional
+ * normalize step all happen here so individual generators stay focused
+ * on IR → target conversion.
+ */
+export declare function loadSpec(opts: LoadSpecOptions): Promise<Record<string, unknown>>;
+/**
+ * Normalize a spec input string: URLs pass through verbatim, absolute
+ * paths pass through, relative paths resolve against `cwd`. Pre-parsed
+ * objects are returned as-is.
+ */
+export declare function resolveSpecInput(input: SpecInput, cwd?: string): SpecInput;
+//# sourceMappingURL=load.d.ts.map

package/dist/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,KAAK,EAAE,SAAS,CAAC;IACjB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAclC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,GAAG,GAAE,MAAsB,GAC1B,SAAS,CASX"}

package/dist/load.js

@@ -0,0 +1,38 @@
+import { isAbsolute, resolve } from "node:path";
+import { $RefParser } from "@hey-api/json-schema-ref-parser";
+import { normalizeSpec, SAFE_NORMALIZE, } from "@ir-kit/openapi-core";
+/**
+ * Single-source loader for every generator in the workspace.
+ * Path-vs-URL detection, `$RefParser.bundle()`, and the optional
+ * normalize step all happen here so individual generators stay focused
+ * on IR → target conversion.
+ */
+export async function loadSpec(opts) {
+    const parser = new $RefParser();
+    const bundled = (await parser.bundle({
+        pathOrUrlOrSchema: resolveSpecInput(opts.input, opts.cwd),
+    }));
+    if (opts.normalize) {
+        normalizeSpec(bundled, opts.normalize === true ? SAFE_NORMALIZE : opts.normalize);
+    }
+    return bundled;
+}
+/**
+ * Normalize a spec input string: URLs pass through verbatim, absolute
+ * paths pass through, relative paths resolve against `cwd`. Pre-parsed
+ * objects are returned as-is.
+ */
+export function resolveSpecInput(input, cwd = process.cwd()) {
+    if (typeof input !== "string")
+        return input;
+    const trimmed = input.trim();
+    if (trimmed === "") {
+        throw new Error("OpenAPI spec input is empty or only whitespace.");
+    }
+    if (/^https?:\/\//i.test(trimmed))
+        return trimmed;
+    if (isAbsolute(trimmed))
+        return trimmed;
+    return resolve(cwd, trimmed);
+}
+//# sourceMappingURL=load.js.map

package/dist/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAEL,aAAa,EACb,cAAc,GACf,MAAM,sBAAsB,CAAC;AAgB9B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAqB;IAErB,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC;QACnC,iBAAiB,EAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC;KAC1D,CAAC,CAA4B,CAAC;IAE/B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,aAAa,CACX,OAAO,EACP,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAC1D,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAgB,EAChB,MAAc,OAAO,CAAC,GAAG,EAAE;IAE3B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAClD,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACxC,OAAO,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/match.d.ts

@@ -0,0 +1,20 @@
+import type { Route } from "./route.js";
+/** `/users/{id}/posts/{postId}` → `{ id: string; postId: string }` (URL params are always strings). */
+export type ExtractParams<P extends string> = P extends `${string}{${infer Key}}${infer Rest}` ? {
+    [K in Key | keyof ExtractParams<Rest>]: string;
+} : Record<string, never>;
+/** Discriminated union; narrow on `spec` + `method` for typed `params`. */
+export type MatchResult<TRoute extends Route = Route> = TRoute extends Route ? {
+    spec: TRoute["spec"];
+    method: TRoute["method"];
+    params: ExtractParams<TRoute["spec"]>;
+    operationId: TRoute extends {
+        operationId: infer O;
+    } ? O : undefined;
+} : never;
+/** Match a request against routes. Returns `MatchResult<R>` discriminated union or `null`. */
+export declare function match<R extends Route>(routes: readonly R[], request: Request): MatchResult<R> | null;
+/** Boolean: does this request hit any route? */
+export declare function isInSpec(routes: readonly Route[], request: Request): boolean;
+export type { Route };
+//# sourceMappingURL=match.d.ts.map

package/dist/match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../src/match.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,uGAAuG;AACvG,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IACxC,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,GAAG,IAAI,MAAM,IAAI,EAAE,GAC5C;KAAG,CAAC,IAAI,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,GAAG,MAAM;CAAE,GAClD,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE5B,2EAA2E;AAC3E,MAAM,MAAM,WAAW,CAAC,MAAM,SAAS,KAAK,GAAG,KAAK,IAAI,MAAM,SAAS,KAAK,GACxE;IACE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,SAAS;QAAE,WAAW,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,CAAC,GAAG,SAAS,CAAC;CACtE,GACD,KAAK,CAAC;AA+BV,8FAA8F;AAC9F,wBAAgB,KAAK,CAAC,CAAC,SAAS,KAAK,EACnC,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,OAAO,EAAE,OAAO,GACf,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAmBvB;AAED,gDAAgD;AAChD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAQ5E;AAED,YAAY,EAAE,KAAK,EAAE,CAAC"}