@ir-kit/kit 0.0.1 → 1.0.0

package/dist/spec/load/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spec/load/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,kBAAkB,EACvB,WAAW,EACX,KAAK,YAAY,EACjB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,sBAAsB,EAC3B,eAAe,EACf,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACb,CAAC;AACF,OAAO,EACL,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,mBAAmB,GACpB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE3D,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,eAAgB,SAAQ,sBAAsB;IAC7D,KAAK,EAAE,SAAS,CAAC;IACjB;6EACyE;IACzE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,kEAAkE;IAClE,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,yBAAyB,CAAA;CAAE,CAAC;AAE9D;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA0C7E;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,SAAS,GAAG,UAAU,GAAG,SAAS,CAKpC"}

package/dist/spec/load/index.js

@@ -0,0 +1,77 @@
+import { loadAsyncAPI, } from "../asyncapi/index.js";
+import { loadOpenAPI, readSpecDocument, resolveOpenAPIInput, } from "../openapi/index.js";
+import { compileTypespec, isTypespecPath, } from "../typespec/index.js";
+export { compileTypespec, isTypespecPath, loadAsyncAPI, loadOpenAPI, readSpecDocument, resolveOpenAPIInput, };
+/**
+ * Detect the spec format and dispatch to the matching per-format loader.
+ * TypeSpec inputs compile to OpenAPI 3 in-memory and return as
+ * `{ kind: "openapi" }`. Pre-parsed objects are kept as-is and
+ * classified by the `asyncapi` / `openapi` / `swagger` top-level key.
+ */
+export async function loadSpec(opts) {
+    const kind = opts.kind ?? (await detectKind(opts.input, opts.cwd));
+    if (kind === "typespec") {
+        const path = typeof opts.input === "string" ? opts.input : "";
+        if (!path) {
+            throw new Error("TypeSpec input must be a file path ending in .tsp");
+        }
+        const { document } = await compileTypespec({ path }, opts);
+        return {
+            kind: "openapi",
+            document: document,
+        };
+    }
+    if (kind === "asyncapi") {
+        if (typeof opts.input !== "string" && !isAsyncAPIDocument(opts.input)) {
+            throw new Error("asyncapi input must be a string path/URL or an AsyncAPIDocumentInterface");
+        }
+        const document = await loadAsyncAPI({
+            input: opts.input,
+            cwd: opts.cwd,
+        });
+        return { kind: "asyncapi", document };
+    }
+    if (typeof opts.input !== "string" &&
+        !isPlainOpenAPIObject(opts.input)) {
+        throw new Error("openapi input must be a string path/URL or a plain object");
+    }
+    const document = await loadOpenAPI({
+        input: opts.input,
+        cwd: opts.cwd,
+        normalize: opts.normalize,
+    });
+    return { kind: "openapi", document };
+}
+/** Classify a parsed document by its root version field. */
+export function classifySpecDocument(document) {
+    if (document.asyncapi !== undefined)
+        return "asyncapi";
+    if (document.openapi !== undefined || document.swagger !== undefined)
+        return "openapi";
+    return undefined;
+}
+async function detectKind(input, cwd) {
+    if (isAsyncAPIDocument(input))
+        return "asyncapi";
+    if (typeof input === "string" && isTypespecPath(input.trim()))
+        return "typespec";
+    const document = typeof input === "string" ? await readSpecDocument(input, cwd) : input;
+    const kind = isPlainOpenAPIObject(document)
+        ? classifySpecDocument(document)
+        : undefined;
+    if (!kind) {
+        const label = typeof input === "string" ? ` ${input}` : "";
+        throw new Error(`Unrecognized spec${label}: expected a top-level "openapi", "swagger" or "asyncapi" field.`);
+    }
+    return kind;
+}
+function isAsyncAPIDocument(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.json === "function" &&
+        typeof value.version === "function");
+}
+function isPlainOpenAPIObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=index.js.map

package/dist/spec/load/index.js.map

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

package/dist/spec/openapi/index.d.ts

@@ -0,0 +1,26 @@
+import { type Type } from "js-yaml";
+import { type NormalizeOptions } from "../../openapi/index.js";
+export type OpenAPIInput = string | Record<string, unknown>;
+export interface LoadOpenAPIOptions {
+    input: OpenAPIInput;
+    cwd?: string;
+    /** Apply hey-api-aware normalization after bundling. `true` enables
+     *  the safe preset; pass an object for custom rules. */
+    normalize?: boolean | NormalizeOptions;
+}
+/** Parse a spec file, URL or object into its raw root document without resolving refs. */
+export declare function readSpecDocument(input: OpenAPIInput, cwd?: string): Promise<Record<string, unknown>>;
+export declare function loadOpenAPI(opts: LoadOpenAPIOptions): Promise<Record<string, unknown>>;
+declare module "js-yaml" {
+    const types: {
+        merge: Type;
+    };
+}
+/**
+ * `x-` extensions are opaque to OpenAPI, so an external `$ref` inside one
+ * (Spotify's `x-spotify-policy: { $ref: ../policies.yaml }`) is data, not a
+ * dependency of the spec. Rename it to `x-$ref` so bundling never fetches it.
+ */
+export declare function detachExtensionRefs(node: unknown, inExtension?: boolean): void;
+export declare function resolveOpenAPIInput(input: OpenAPIInput, cwd?: string): OpenAPIInput;
+//# sourceMappingURL=index.d.ts.map

package/dist/spec/openapi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spec/openapi/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAqB,KAAK,IAAI,EAAS,MAAM,SAAS,CAAC;AAC9D,OAAO,EAEL,KAAK,gBAAgB,EAGtB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,YAAY,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;4DACwD;IACxD,SAAS,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;CACxC;AAED,0FAA0F;AAC1F,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,EACnB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAKlC;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0BlC;AAED,OAAO,QAAQ,SAAS,CAAC;IAEvB,MAAM,KAAK,EAAE;QAAE,KAAK,EAAE,IAAI,CAAA;KAAE,CAAC;CAC9B;AA4CD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,UAAQ,GAAG,IAAI,CAuB5E;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,GAAG,GAAE,MAAsB,GAC1B,YAAY,CASd"}

package/dist/spec/openapi/index.js

@@ -0,0 +1,116 @@
+import { isAbsolute, resolve } from "node:path";
+import { $RefParser, ParserError, } from "@hey-api/json-schema-ref-parser";
+import { CORE_SCHEMA, load, types } from "js-yaml";
+import { hoistForeignSchemaRefs, normalizeSpec, SAFE_NORMALIZE, } from "../../openapi/index.js";
+/** Parse a spec file, URL or object into its raw root document without resolving refs. */
+export async function readSpecDocument(input, cwd) {
+    const { schema } = await createParser().parse({
+        pathOrUrlOrSchema: resolveOpenAPIInput(input, cwd),
+    });
+    return schema;
+}
+export async function loadOpenAPI(opts) {
+    const parser = createParser();
+    const input = resolveOpenAPIInput(opts.input, opts.cwd);
+    const { schema } = await parser.parse({ pathOrUrlOrSchema: input });
+    const root = parser.$refs._root$Ref;
+    detachExtensionRefs(schema);
+    const bundled = (await parser.bundle({
+        pathOrUrlOrSchema: input,
+        resolvedInput: {
+            path: root.path ?? "",
+            schema,
+            type: typeof input === "string" ? root.pathType : "json",
+        },
+    }));
+    hoistForeignSchemaRefs(bundled);
+    if (opts.normalize) {
+        normalizeSpec(bundled, opts.normalize === true ? SAFE_NORMALIZE : opts.normalize);
+    }
+    return bundled;
+}
+// why: js-yaml's default YAML 1.1 schema turns unquoted dates such as
+// Stripe's `api_version` enum (`- 2011-01-01`) into `Date` objects, which
+// codegen then drops; the YAML 1.2 core schema keeps them as strings.
+// `<<` merge keys stay supported, as specs use them to share fields.
+const YAML_SCHEMA = CORE_SCHEMA.extend({ implicit: [types.merge] });
+function createParser() {
+    const parser = new $RefParser();
+    parser.options.parse.yaml.handler = (file) => {
+        const data = Buffer.isBuffer(file.data) ? file.data.toString() : file.data;
+        if (typeof data !== "string")
+            return data;
+        try {
+            return load(data, { schema: YAML_SCHEMA });
+        }
+        catch (error) {
+            throw new ParserError(error.message, file.url);
+        }
+    };
+    return parser;
+}
+/** Keys whose children are user-named entries, never `x-` extensions. */
+const NAMED_ENTRY_MAPS = new Set([
+    "$defs",
+    "callbacks",
+    "content",
+    "definitions",
+    "encoding",
+    "examples",
+    "headers",
+    "links",
+    "mapping",
+    "parameters",
+    "pathItems",
+    "patternProperties",
+    "properties",
+    "requestBodies",
+    "responses",
+    "schemas",
+    "securitySchemes",
+    "variables",
+]);
+/**
+ * `x-` extensions are opaque to OpenAPI, so an external `$ref` inside one
+ * (Spotify's `x-spotify-policy: { $ref: ../policies.yaml }`) is data, not a
+ * dependency of the spec. Rename it to `x-$ref` so bundling never fetches it.
+ */
+export function detachExtensionRefs(node, inExtension = false) {
+    if (!node || typeof node !== "object")
+        return;
+    if (Array.isArray(node)) {
+        for (const item of node)
+            detachExtensionRefs(item, inExtension);
+        return;
+    }
+    const obj = node;
+    if (inExtension &&
+        typeof obj.$ref === "string" &&
+        !obj.$ref.startsWith("#")) {
+        obj["x-$ref"] = obj.$ref;
+        delete obj.$ref;
+    }
+    for (const [key, value] of Object.entries(obj)) {
+        if (NAMED_ENTRY_MAPS.has(key) && value && typeof value === "object") {
+            for (const entry of Object.values(value))
+                detachExtensionRefs(entry, inExtension);
+        }
+        else {
+            detachExtensionRefs(value, inExtension || key.startsWith("x-"));
+        }
+    }
+}
+export function resolveOpenAPIInput(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=index.js.map

package/dist/spec/openapi/index.js.map

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

package/dist/spec/typespec/compile-capture.d.ts

@@ -0,0 +1,21 @@
+import { type CompileTypespecInput } from "./compile.js";
+import type { CompileTypespecOptions } from "./index.js";
+export interface CompileCaptureOptions extends CompileTypespecOptions {
+    /** Emitter package name (e.g. `@typespec/json-schema`, `@typespec/protobuf`). */
+    emitter: string;
+    /** Options forwarded to the emitter under `options[emitter]`. */
+    emitterOptions?: Record<string, unknown>;
+}
+export interface CompileCaptureResult {
+    /** Captured files keyed by their RELATIVE path from the emitter's
+     *  output dir. Empty string keys are flattened to filename only. */
+    files: Record<string, string>;
+}
+/**
+ * Compile a TypeSpec entry point with an arbitrary emitter, capturing
+ * the emitter's `writeFile` calls in memory instead of writing to
+ * disk. Use this when the emitter doesn't expose a `getX()` programmatic
+ * API the way `@typespec/openapi3` does.
+ */
+export declare function compileTypespecCapture(input: CompileTypespecInput, options: CompileCaptureOptions): Promise<CompileCaptureResult>;
+//# sourceMappingURL=compile-capture.d.ts.map

package/dist/spec/typespec/compile-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-capture.d.ts","sourceRoot":"","sources":["../../../src/spec/typespec/compile-capture.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,qBAAsB,SAAQ,sBAAsB;IACnE,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC;wEACoE;IACpE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA8B/B"}

package/dist/spec/typespec/compile-capture.js

@@ -0,0 +1,31 @@
+import { relative, resolve } from "node:path";
+import { loadTypespecCompiler, withProgram, } from "./compile.js";
+/**
+ * Compile a TypeSpec entry point with an arbitrary emitter, capturing
+ * the emitter's `writeFile` calls in memory instead of writing to
+ * disk. Use this when the emitter doesn't expose a `getX()` programmatic
+ * API the way `@typespec/openapi3` does.
+ */
+export async function compileTypespecCapture(input, options) {
+    const captured = new Map();
+    const outputDir = resolve(options.cwd ?? process.cwd(), "__capture__");
+    const { NodeHost } = await loadTypespecCompiler();
+    const host = {
+        ...NodeHost,
+        writeFile: async (path, content) => {
+            const rel = relative(outputDir, path);
+            const key = rel.startsWith("..") || rel === "" ? path : rel;
+            captured.set(key, content);
+        },
+        mkdirp: async () => undefined,
+    };
+    const compilerOptions = {
+        emit: [options.emitter],
+        outputDir,
+        options: options.emitterOptions
+            ? { [options.emitter]: options.emitterOptions }
+            : undefined,
+    };
+    return withProgram(input, options.cwd, compilerOptions, () => ({ files: Object.fromEntries(captured) }), host);
+}
+//# sourceMappingURL=compile-capture.js.map

package/dist/spec/typespec/compile-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-capture.js","sourceRoot":"","sources":["../../../src/spec/typespec/compile-capture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAI9C,OAAO,EAEL,oBAAoB,EACpB,WAAW,GACZ,MAAM,cAAc,CAAC;AAgBtB;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAA2B,EAC3B,OAA8B;IAE9B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC,CAAC;IACvE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAElD,MAAM,IAAI,GAAiB;QACzB,GAAG,QAAQ;QACX,SAAS,EAAE,KAAK,EAAE,IAAY,EAAE,OAAe,EAAE,EAAE;YACjD,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACtC,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YAC5D,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;KAC9B,CAAC;IAEF,MAAM,eAAe,GAAoB;QACvC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;QACvB,SAAS;QACT,OAAO,EAAE,OAAO,CAAC,cAAc;YAC7B,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,EAAE;YAC/C,CAAC,CAAC,SAAS;KACd,CAAC;IAEF,OAAO,WAAW,CAChB,KAAK,EACL,OAAO,CAAC,GAAG,EACX,eAAe,EACf,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,EAC/C,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/spec/typespec/compile.d.ts

@@ -0,0 +1,14 @@
+import type { CompilerHost, CompilerOptions, Program } from "@typespec/compiler";
+export declare const loadTypespecCompiler: () => Promise<typeof import("@typespec/compiler")>;
+export type CompileTypespecInput = {
+    source: string;
+    imports?: ReadonlyArray<string>;
+} | {
+    path: string;
+};
+/**
+ * Compile `input` (writing inline source to a temp `main.tsp` first),
+ * throw on error diagnostics, and hand the program to `use`.
+ */
+export declare function withProgram<T>(input: CompileTypespecInput, cwd: string | undefined, options: CompilerOptions, use: (program: Program) => Promise<T> | T, host?: CompilerHost): Promise<T>;
+//# sourceMappingURL=compile.d.ts.map

package/dist/spec/typespec/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/spec/typespec/compile.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,OAAO,EACR,MAAM,oBAAoB,CAAC;AAI5B,eAAO,MAAM,oBAAoB,oDAI7B,CAAC;AAEL,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,KAAK,EAAE,oBAAoB,EAC3B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACzC,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,CAAC,CAAC,CAcZ"}

package/dist/spec/typespec/compile.js

@@ -0,0 +1,46 @@
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { loadOptional } from "../../optional.js";
+export const loadTypespecCompiler = () => loadOptional(() => import("@typespec/compiler"), "TypeSpec input", [
+    "@typespec/compiler",
+    "@typespec/openapi3",
+]);
+/**
+ * Compile `input` (writing inline source to a temp `main.tsp` first),
+ * throw on error diagnostics, and hand the program to `use`.
+ */
+export async function withProgram(input, cwd, options, use, host) {
+    const { compile, NodeHost } = await loadTypespecCompiler();
+    const { mainFile, cleanup } = await materialize(input, cwd);
+    try {
+        const program = await compile(host ?? NodeHost, mainFile, options);
+        const fatal = program.diagnostics.filter((d) => d.severity === "error");
+        if (fatal.length > 0) {
+            const lines = fatal.map((d) => `  - ${d.message}`).join("\n");
+            throw new Error(`TypeSpec compilation failed:\n${lines}`);
+        }
+        return await use(program);
+    }
+    finally {
+        await cleanup();
+    }
+}
+async function materialize(input, cwd) {
+    if ("path" in input) {
+        return {
+            mainFile: resolve(cwd ?? process.cwd(), input.path),
+            cleanup: async () => { },
+        };
+    }
+    const base = cwd ?? process.cwd();
+    const dir = await mkdtemp(join(base, ".ir-kit-typespec-"));
+    const mainFile = join(dir, "main.tsp");
+    const imports = (input.imports ?? []).map((m) => `import "${m}";`).join("\n");
+    const body = imports ? `${imports}\n\n${input.source}` : input.source;
+    await writeFile(mainFile, body);
+    return {
+        mainFile,
+        cleanup: () => rm(dir, { recursive: true, force: true }),
+    };
+}
+//# sourceMappingURL=compile.js.map

package/dist/spec/typespec/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../../src/spec/typespec/compile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAO1C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,EAAE,CACvC,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,EAAE,gBAAgB,EAAE;IACjE,oBAAoB;IACpB,oBAAoB;CACrB,CAAC,CAAC;AAML;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAA2B,EAC3B,GAAuB,EACvB,OAAwB,EACxB,GAAyC,EACzC,IAAmB;IAEnB,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAC3D,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,IAAI,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;QACxE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,KAA2B,EAC3B,GAAuB;IAEvB,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACpB,OAAO;YACL,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC;YACnD,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;SACxB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IACtE,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAChC,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/dist/spec/typespec/index.d.ts

@@ -0,0 +1,22 @@
+import type { SupportedOpenAPIDocuments } from "@typespec/openapi3";
+import { type CompileTypespecInput } from "./compile.js";
+export type { CompileTypespecInput };
+export type CompileTypespecOptions = {
+    cwd?: string;
+    openapi?: Record<string, unknown>;
+};
+export type OpenAPIDocument = SupportedOpenAPIDocuments;
+export type CompileTypespecResult = {
+    documents: ReadonlyArray<OpenAPIDocument>;
+    document: OpenAPIDocument;
+};
+export { type CompileCaptureOptions, type CompileCaptureResult, compileTypespecCapture, } from "./compile-capture.js";
+/**
+ * Compile a TypeSpec entry point to an OpenAPI 3 document in memory.
+ * Accepts either a file path or an inline source string. No disk
+ * artifacts survive the call. Throws on `error`-severity diagnostics.
+ */
+export declare function compileTypespec(input: CompileTypespecInput, options?: CompileTypespecOptions): Promise<CompileTypespecResult>;
+/** `true` when `input` is a string path ending in `.tsp` (case-insensitive). */
+export declare function isTypespecPath(input: unknown): input is string;
+//# sourceMappingURL=index.d.ts.map

package/dist/spec/typespec/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spec/typespec/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGpE,OAAO,EAAE,KAAK,oBAAoB,EAAe,MAAM,cAAc,CAAC;AAEtE,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,yBAAyB,CAAC;AAExD,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC1C,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CA4ChC;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE9D"}

package/dist/spec/typespec/index.js

@@ -0,0 +1,47 @@
+import { loadOptional } from "../../optional.js";
+import { withProgram } from "./compile.js";
+export { compileTypespecCapture, } from "./compile-capture.js";
+/**
+ * Compile a TypeSpec entry point to an OpenAPI 3 document in memory.
+ * Accepts either a file path or an inline source string. No disk
+ * artifacts survive the call. Throws on `error`-severity diagnostics.
+ */
+export async function compileTypespec(input, options = {}) {
+    const emitterOptions = options.openapi ?? {};
+    const compilerOptions = {
+        noEmit: true,
+        emit: ["@typespec/openapi3"],
+        options: { "@typespec/openapi3": emitterOptions },
+    };
+    const { getOpenAPI3 } = await loadOptional(() => import("@typespec/openapi3"), "TypeSpec input", ["@typespec/compiler", "@typespec/openapi3"]);
+    return withProgram(input, options.cwd, compilerOptions, async (program) => {
+        const records = await getOpenAPI3(program, emitterOptions);
+        const documents = [];
+        for (const record of records) {
+            if (record.versioned === false) {
+                documents.push(record.document);
+            }
+            else {
+                for (const v of record.versions)
+                    documents.push(v.document);
+            }
+        }
+        if (documents.length === 0) {
+            throw new Error("TypeSpec compilation produced no OpenAPI 3 documents (is there a @service namespace?)");
+        }
+        return {
+            documents,
+            get document() {
+                if (documents.length > 1) {
+                    throw new Error(`TypeSpec compilation produced ${documents.length} OpenAPI documents; use \`documents\` to handle them explicitly.`);
+                }
+                return documents[0];
+            },
+        };
+    });
+}
+/** `true` when `input` is a string path ending in `.tsp` (case-insensitive). */
+export function isTypespecPath(input) {
+    return typeof input === "string" && /\.tsp$/i.test(input.trim());
+}
+//# sourceMappingURL=index.js.map

package/dist/spec/typespec/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/spec/typespec/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAA6B,WAAW,EAAE,MAAM,cAAc,CAAC;AAgBtE,OAAO,EAGL,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAA2B,EAC3B,OAAO,GAA2B,EAAE;IAEpC,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IAC7C,MAAM,eAAe,GAAoB;QACvC,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,CAAC,oBAAoB,CAAC;QAC5B,OAAO,EAAE,EAAE,oBAAoB,EAAE,cAAc,EAAE;KAClD,CAAC;IAEF,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,YAAY,CACxC,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,EAClC,gBAAgB,EAChB,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAC7C,CAAC;IACF,OAAO,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACxE,MAAM,OAAO,GAAG,MAAM,WAAW,CAC/B,OAAO,EACP,cAAmD,CACpD,CAAC;QACF,MAAM,SAAS,GAAsB,EAAE,CAAC;QACxC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;gBAC/B,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ;oBAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,SAAS;YACT,IAAI,QAAQ;gBACV,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzB,MAAM,IAAI,KAAK,CACb,iCAAiC,SAAS,CAAC,MAAM,kEAAkE,CACpH,CAAC;gBACJ,CAAC;gBACD,OAAO,SAAS,CAAC,CAAC,CAAE,CAAC;YACvB,CAAC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/docs/asyncapi.md

@@ -0,0 +1,30 @@
+# `@ir-kit/kit/asyncapi`
+
+Shared AsyncAPI 3.0 primitives for codegen. Mirror of [`@ir-kit/kit/openapi`](https://github.com/ahmedrowaihi/ir-kit/tree/main/packages/ir-kit/docs/openapi.md) for the AsyncAPI track — uniform `parseSpec` entry point on top of `@asyncapi/parser`, plus AMQP binding extractors and routing-key matching.
+
+## Install
+
+```sh
+npm install @ir-kit/kit
+# or pnpm / yarn
+```
+
+Peer deps: `@asyncapi/parser`.
+
+## Usage
+
+```ts
+import { parseSpec } from "@ir-kit/kit/asyncapi";
+
+const { spec, channels, operations, messages } = await parseSpec("./events.yaml");
+```
+
+Designed for emitters (`@ir-kit/kit/sdk/asyncapi`) to consume; not typically called from app code.
+
+## Status
+
+`0.1.0` — first release under the `@ir-kit/*` scope. Replaces the legacy `@ahmedrowaihi/asyncapi-core` (deprecated).
+
+## Repo
+
+Source at [ahmedrowaihi/ir-kit](https://github.com/ahmedrowaihi/ir-kit/tree/main/packages/ir-kit/docs/asyncapi.md).

package/docs/cli.md

@@ -0,0 +1,85 @@
+# `@ir-kit/kit/cli`
+
+The unified `ir` CLI — one entry point for every ir-kit operation across every supported API standard. Commands are JSON-Schema-defined; the runtime auto-derives flags, prompts, help, and validation from the schema.
+
+Part of [ir-kit](https://github.com/ahmedrowaihi/ir-kit).
+
+## Install
+
+```sh
+npm install -g @ir-kit/kit
+# or run ad-hoc:
+npx @ir-kit/kit <command>
+```
+
+## Commands
+
+```
+ir
+├── init           Write an ir.config.ts (and a starter k6 loadtest)
+├── generate       Run every target in ir.config.ts; --check fails when output is stale
+├── watch          Run the targets again whenever the spec changes
+├── spec
+│   ├── convert    Convert between OpenAPI 3 / AsyncAPI 3 / TypeSpec / Protobuf / Postman / JSON Schema
+│   └── diff       Cross-family diff with breaking / non-breaking classification
+├── docs           Render any spec as standalone HTML via Scalar API Reference
+├── sdk
+│   ├── go         Generate a Go SDK
+│   ├── kotlin     Generate a Kotlin (OkHttp + coroutines) SDK
+│   ├── swift      Generate a Swift (URLSession + Codable) SDK
+│   ├── java       Generate a Java (java.net.http + Jackson) SDK
+│   ├── typescript Generate a TypeScript SDK via @hey-api/openapi-ts
+│   ├── k6         Generate a typed k6 load-test client
+│   └── all        Run every SDK generator in one pass
+├── recon          Reverse-engineer OpenAPI 3.1 from a HAR capture
+├── fn-schema
+│   ├── extract    Extract JSON Schemas from TS function signatures
+│   ├── scan       Walk the project; report what extractors found
+│   ├── inspect    Resolve a single function/identifier and dump its schema
+│   └── diff       Compare two extracted bundles
+└── k6
+    ├── sync       Regenerate a typed k6 client from an OpenAPI spec
+    └── bundle     Bundle a k6 loadtest entry into a single .js file
+```
+
+Every command supports `--help` for full flag detail. For a project you regenerate often, put the targets in `ir.config.ts` and use `ir generate`: see [generate.md](./generate.md).
+
+## Examples
+
+```sh
+# Convert between any pair of supported formats — direct or graph-routed.
+ir spec convert ./api.proto --to openapi3
+ir spec convert ./collection.postman_collection.json --to typespec
+
+# Standalone HTML docs from any input
+ir docs ./api.yaml --out docs.html --theme moon
+
+# Cross-family diff — breaking-change detection in CI
+ir spec diff ./prod.yaml --after ./staging.proto --failOnBreaking
+
+# Generate every native SDK in one shot
+ir sdk all --input ./petstore.yaml --output ./sdks
+
+# Sync a k6 client and bundle the loadtest
+ir k6 sync && ir k6 bundle ./loadtest.ts --out dist/loadtest.js
+```
+
+## How it works
+
+Each command is a thin schema-driven wrapper around a programmatic `runX()` API exposed by the underlying engine package (`@ir-kit/kit/spec`, `@ir-kit/kit/spec`, `@ir-kit/kit/spec`, `@ir-kit/openapi-{go,kotlin,swift,java,typescript}`, `@ir-kit/kit/k6-toolkit`, `@ir-kit/kit/fn-schema`, `@ir-kit/kit/recon`). All orchestration lives in those engines — the CLI exists to expose them under one entry point with consistent flag UX.
+
+```ts
+// Every command follows the same shape:
+export const myCommand: CommandSpec<Input, void> = {
+  path: ["spec", "convert"],
+  description: "...",
+  args: {
+    /* JSON Schema */
+  },
+  handler: async (input) => {
+    /* call the engine */
+  },
+};
+```
+
+Programmatic access: import the engine package directly, skip the CLI.

package/docs/codegen.md

@@ -0,0 +1,54 @@
+# `@ir-kit/kit/codegen`
+
+Spec-agnostic codegen primitives shared by every native-SDK generator family — identifier transforms (`pascal`, `camel`, `safeIdent`, `safeCaseName`, `softCamel`, `synthName`, `avoidLeadingDigit`, `escapeIfReserved`), filesystem safety (`assertSafeOutputDir`), and project-name derivation (`defaultProjectName`). Pure functions, no spec dependencies.
+
+## Install
+
+```sh
+npm install @ir-kit/kit
+```
+
+Zero runtime dependencies.
+
+## Identifier helpers
+
+```ts
+import {
+  avoidLeadingDigit,
+  camel,
+  escapeIfReserved,
+  pascal,
+  safeCaseName,
+  safeIdent,
+  softCamel,
+  synthName,
+} from "@ir-kit/kit/codegen";
+
+pascal("first_name");     // "FirstName"
+camel("first_name");      // "firstName"
+softCamel("FirstName");   // "FirstName"  (preserves first-letter casing)
+camel("FirstName");       // "firstName"  (lowercases first letter)
+safeIdent("2024_release"); // "_2024Release"  (digit guard + pascal)
+safeCaseName("4xx");      // "_4xx"
+synthName("User", ["Address", "Street"]);   // "User_Address_Street"
+
+avoidLeadingDigit("2value");                // "_2value"
+escapeIfReserved("class", new Set(["class"]), (s) => `\`${s}\``);  // "`class`"
+```
+
+## Filesystem helpers
+
+```ts
+import { assertSafeOutputDir, defaultProjectName } from "@ir-kit/kit/codegen";
+
+assertSafeOutputDir("./out/sdk");           // throws if outside CWD or in . / ..
+defaultProjectName("./out/petstore-sdk");   // "petstore-sdk"
+```
+
+## Status
+
+`0.1.0` — first release under the `@ir-kit/*` scope. Replaces the legacy `@ahmedrowaihi/codegen-core` (deprecated).
+
+## Repo
+
+Source at [ahmedrowaihi/ir-kit](https://github.com/ahmedrowaihi/ir-kit/tree/main/packages/ir-kit/docs/codegen.md).