@ir-kit/kit 0.0.0-stage → 1.0.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

@@ -1,3 +1,38 @@
-# Temporary Holding Version
+# ir-kit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+One package for working with API specs. Load, convert, diff and document OpenAPI, AsyncAPI, TypeSpec, protobuf and Postman specs, and generate SDKs, Hey API plugin output and k6 load tests from them.
+
+```sh
+npm i -D @ir-kit/kit
+npx ir sdk go openapi.yaml --output sdk/go
+```
+
+## Subpaths
+
+| Import | What it does | Docs |
+| --- | --- | --- |
+| `@ir-kit/kit` / `@ir-kit/kit/spec` | `loadSpec`, `convertSpec`, `diffSpec`, `renderDocs` | [load](./docs/spec-load.md), [convert](./docs/spec-convert.md), [diff](./docs/spec-diff.md), [docs](./docs/spec-docs.md) |
+| `@ir-kit/kit/spec/openapi`, `/asyncapi`, `/typespec` | format-specific loaders | [openapi](./docs/spec-openapi.md), [asyncapi](./docs/spec-asyncapi.md), [typespec](./docs/spec-typespec.md) |
+| `@ir-kit/kit/sdk/go`, `/java`, `/kotlin`, `/swift`, `/typescript` | SDK generators, each with `generate({ spec, output })` | [go](./docs/sdk-go.md), [java](./docs/sdk-java.md), [kotlin](./docs/sdk-kotlin.md), [swift](./docs/sdk-swift.md), [typescript](./docs/sdk-typescript.md) |
+| `@ir-kit/kit/sdk/k6` | typed k6 client generator | [k6](./docs/sdk-k6.md) |
+| `@ir-kit/kit/sdk/asyncapi` | TypeScript output for AsyncAPI specs | [asyncapi](./docs/sdk-asyncapi.md) |
+| `@ir-kit/kit/openapi-ts/faker`, `/orpc`, `/paths`, `/typia`, `/k6` | Hey API plugins | [faker](./docs/openapi-ts-faker.md), [orpc](./docs/openapi-ts-orpc.md), [paths](./docs/openapi-ts-paths.md), [typia](./docs/openapi-ts-typia.md), [k6](./docs/openapi-ts-k6.md) |
+| `@ir-kit/kit/fn-schema` | JSON Schema from TypeScript function signatures | [fn-schema](./docs/fn-schema-core.md) |
+| `@ir-kit/kit/fn-schema/unplugin/vite` (and `/webpack`, `/rollup`, ...) | fn-schema bundler plugins | [unplugin](./docs/fn-schema-unplugin.md) |
+| `@ir-kit/kit/recon` | build an OpenAPI spec from recorded traffic | [recon](./docs/recon.md) |
+| `@ir-kit/kit/k6-toolkit` | k6 project scaffold, sync and bundle | [k6-toolkit](./docs/k6-toolkit.md) |
+| `@ir-kit/kit/cli` | the `ir` command's specs, to embed it in your own tooling | [cli](./docs/cli.md) |
+
+## Optional dependencies
+
+Only install what the features you use need:
+
+| Feature | Install |
+| --- | --- |
+| TypeSpec input | `@typespec/compiler @typespec/openapi3` (plus `@typespec/json-schema` / `@typespec/protobuf` for those outputs) |
+| AsyncAPI input | `@asyncapi/parser` |
+| Postman conversion | `openapi-to-postmanv2` / `@readme/postman-to-openapi` |
+| fn-schema | `ts-morph ts-json-schema-generator` (and `unplugin` for the bundler plugins) |
+| Hey API plugins | the plugin's own peers, such as `@faker-js/faker`, `@orpc/*` or `typia` |
+
+The runtime that k6 scripts import stays in its own package, [`@ir-kit/k6`](../k6/framework).

package/bin/ir.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/cli/bin.js";

package/dist/asyncapi/bindings.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Typed accessors for AMQP 0.3.0 bindings on AsyncAPI 3.0 documents.
+ *
+ * Spec: https://github.com/asyncapi/bindings/blob/v3.0.0/amqp/README.md
+ *
+ * `@asyncapi/parser` exposes the binding wrapper but `binding.value()` returns
+ * `any`. We narrow that to the spec'd shape here so generators can rely on
+ * typed extractors instead of guessing field names.
+ */
+import type { ChannelInterface, MessageInterface, OperationInterface, ServerInterface } from "@asyncapi/parser";
+export type AmqpExchangeType = "topic" | "direct" | "fanout" | "default" | "headers";
+export interface AmqpExchangeProps {
+    /** Exchange name. Max 255 characters per spec. */
+    name: string;
+    type: AmqpExchangeType;
+    durable?: boolean;
+    autoDelete?: boolean;
+    /** Defaults to `/`. */
+    vhost?: string;
+}
+export interface AmqpQueueProps {
+    /** Queue name. Max 255 characters per spec. */
+    name: string;
+    durable?: boolean;
+    exclusive?: boolean;
+    autoDelete?: boolean;
+    vhost?: string;
+}
+export type AmqpChannelBinding = {
+    is: "routingKey";
+    exchange: AmqpExchangeProps;
+    queue?: AmqpQueueProps;
+    bindingVersion?: string;
+} | {
+    is: "queue";
+    queue: AmqpQueueProps;
+    exchange?: AmqpExchangeProps;
+    bindingVersion?: string;
+};
+export interface AmqpOperationBinding {
+    /** TTL of the message, in milliseconds. */
+    expiration?: number;
+    /** Identifies the user that publishes the message. */
+    userId?: string;
+    /** Routing keys the message should be routed to (in addition to the binding key). */
+    cc?: string[];
+    /** Message priority (0–9 typically). */
+    priority?: number;
+    /** 1 = transient, 2 = persistent. */
+    deliveryMode?: 1 | 2;
+    /** Mandatory flag — if true, returns the message to the publisher when no queue is bound. (publish only) */
+    mandatory?: boolean;
+    /** Like `cc` but consumers won't see it. (publish only) */
+    bcc?: string[];
+    /** Whether the broker should add a timestamp on publish. */
+    timestamp?: boolean;
+    /** Whether the consumer should ack messages. (subscribe only) */
+    ack?: boolean;
+    bindingVersion?: string;
+}
+export interface AmqpMessageBinding {
+    contentEncoding?: string;
+    messageType?: string;
+    bindingVersion?: string;
+}
+/** Server bindings for AMQP are currently empty/reserved per spec. */
+export type AmqpServerBinding = Record<string, never>;
+/**
+ * Extract the typed AMQP channel binding from a parsed channel, or undefined
+ * if the channel has no AMQP binding. Does not validate `bindingVersion`.
+ */
+export declare function getAmqpChannelBinding(channel: ChannelInterface): AmqpChannelBinding | undefined;
+export declare function getAmqpOperationBinding(operation: OperationInterface): AmqpOperationBinding | undefined;
+export declare function getAmqpMessageBinding(message: MessageInterface): AmqpMessageBinding | undefined;
+export declare function getAmqpServerBinding(server: ServerInterface): AmqpServerBinding | undefined;
+/**
+ * Convenience: pull the exchange config out of a channel binding regardless
+ * of `is` value (channels with `is: queue` may still declare an exchange to
+ * bind to).
+ */
+export declare function getAmqpExchange(channel: ChannelInterface): AmqpExchangeProps | undefined;
+export declare function getAmqpQueue(channel: ChannelInterface): AmqpQueueProps | undefined;
+//# sourceMappingURL=bindings.d.ts.map

package/dist/asyncapi/bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../src/asyncapi/bindings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IACE,EAAE,EAAE,YAAY,CAAC;IACjB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACD;IACE,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACrB,4GAA4G;IAC5G,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iEAAiE;IACjE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,GACxB,kBAAkB,GAAG,SAAS,CAEhC;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,kBAAkB,GAC5B,oBAAoB,GAAG,SAAS,CAElC;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,GACxB,kBAAkB,GAAG,SAAS,CAEhC;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,GACtB,iBAAiB,GAAG,SAAS,CAE/B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,GACxB,iBAAiB,GAAG,SAAS,CAE/B;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,gBAAgB,GACxB,cAAc,GAAG,SAAS,CAE5B"}

package/dist/asyncapi/bindings.js

@@ -0,0 +1,47 @@
+/**
+ * Typed accessors for AMQP 0.3.0 bindings on AsyncAPI 3.0 documents.
+ *
+ * Spec: https://github.com/asyncapi/bindings/blob/v3.0.0/amqp/README.md
+ *
+ * `@asyncapi/parser` exposes the binding wrapper but `binding.value()` returns
+ * `any`. We narrow that to the spec'd shape here so generators can rely on
+ * typed extractors instead of guessing field names.
+ */
+/**
+ * Extract the typed AMQP channel binding from a parsed channel, or undefined
+ * if the channel has no AMQP binding. Does not validate `bindingVersion`.
+ */
+export function getAmqpChannelBinding(channel) {
+    return readAmqpBinding(channel.bindings());
+}
+export function getAmqpOperationBinding(operation) {
+    return readAmqpBinding(operation.bindings());
+}
+export function getAmqpMessageBinding(message) {
+    return readAmqpBinding(message.bindings());
+}
+export function getAmqpServerBinding(server) {
+    return readAmqpBinding(server.bindings());
+}
+/**
+ * Convenience: pull the exchange config out of a channel binding regardless
+ * of `is` value (channels with `is: queue` may still declare an exchange to
+ * bind to).
+ */
+export function getAmqpExchange(channel) {
+    return getAmqpChannelBinding(channel)?.exchange;
+}
+export function getAmqpQueue(channel) {
+    return getAmqpChannelBinding(channel)?.queue;
+}
+function readAmqpBinding(bindings) {
+    const binding = bindings.get("amqp");
+    if (!binding)
+        return undefined;
+    // The parser separates bindingVersion onto the wrapper; merge it back in
+    // so callers get the full spec'd shape from one object.
+    const value = binding.value();
+    const version = binding.version();
+    return version ? { ...value, bindingVersion: version } : value;
+}
+//# sourceMappingURL=bindings.js.map

package/dist/asyncapi/bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.js","sourceRoot":"","sources":["../../src/asyncapi/bindings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgFH;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAyB;IAEzB,OAAO,eAAe,CAAqB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAA6B;IAE7B,OAAO,eAAe,CAAuB,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAAyB;IAEzB,OAAO,eAAe,CAAqB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAAuB;IAEvB,OAAO,eAAe,CAAoB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAyB;IAEzB,OAAO,qBAAqB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,OAAyB;IAEzB,OAAO,qBAAqB,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC;AAC/C,CAAC;AAED,SAAS,eAAe,CACtB,QAAkD;IAElD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,yEAAyE;IACzE,wDAAwD;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAO,CAAC;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAClC,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACjE,CAAC"}

package/dist/asyncapi/index.d.ts

@@ -0,0 +1,5 @@
+export type { AsyncAPIDocumentInterface, Diagnostic, } from "@asyncapi/parser";
+export { type AmqpChannelBinding, type AmqpExchangeProps, type AmqpExchangeType, type AmqpMessageBinding, type AmqpOperationBinding, type AmqpQueueProps, type AmqpServerBinding, getAmqpChannelBinding, getAmqpExchange, getAmqpMessageBinding, getAmqpOperationBinding, getAmqpQueue, getAmqpServerBinding, } from "./bindings.js";
+export { compileRoutingKey, matchRoutingKey } from "./match.js";
+export { type ParseInput, type ParseResult, parseSpec, parseSpecOrThrow, } from "./parse.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/asyncapi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/asyncapi/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,yBAAyB,EACzB,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EACL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,SAAS,EACT,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/asyncapi/index.js

@@ -0,0 +1,4 @@
+export { getAmqpChannelBinding, getAmqpExchange, getAmqpMessageBinding, getAmqpOperationBinding, getAmqpQueue, getAmqpServerBinding, } from "./bindings.js";
+export { compileRoutingKey, matchRoutingKey } from "./match.js";
+export { parseSpec, parseSpecOrThrow, } from "./parse.js";
+//# sourceMappingURL=index.js.map

package/dist/asyncapi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/asyncapi/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAQL,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAGL,SAAS,EACT,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/asyncapi/match.d.ts

@@ -0,0 +1,19 @@
+/**
+ * RabbitMQ topic-exchange routing-key pattern matching.
+ *
+ * Reference: https://www.rabbitmq.com/tutorials/tutorial-five
+ *
+ * Wildcards:
+ *   `*` — exactly one word (no dots)
+ *   `#` — zero or more words separated by dots
+ *
+ * Routing keys and patterns are dot-separated (e.g. `user.account.created`).
+ * Words consist of any characters except `.`.
+ */
+export declare function matchRoutingKey(pattern: string, key: string): boolean;
+/**
+ * Compile a routing-key pattern into a reusable matcher. Cheaper than
+ * calling `matchRoutingKey` repeatedly with the same pattern.
+ */
+export declare function compileRoutingKey(pattern: string): (key: string) => boolean;
+//# sourceMappingURL=match.d.ts.map

package/dist/asyncapi/match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../src/asyncapi/match.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAErE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAG3E"}

package/dist/asyncapi/match.js

@@ -0,0 +1,44 @@
+/**
+ * RabbitMQ topic-exchange routing-key pattern matching.
+ *
+ * Reference: https://www.rabbitmq.com/tutorials/tutorial-five
+ *
+ * Wildcards:
+ *   `*` — exactly one word (no dots)
+ *   `#` — zero or more words separated by dots
+ *
+ * Routing keys and patterns are dot-separated (e.g. `user.account.created`).
+ * Words consist of any characters except `.`.
+ */
+export function matchRoutingKey(pattern, key) {
+    return matchSegments(pattern.split("."), key.split("."));
+}
+/**
+ * Compile a routing-key pattern into a reusable matcher. Cheaper than
+ * calling `matchRoutingKey` repeatedly with the same pattern.
+ */
+export function compileRoutingKey(pattern) {
+    const patternSegments = pattern.split(".");
+    return (key) => matchSegments(patternSegments, key.split("."));
+}
+function matchSegments(p, k) {
+    if (p.length === 0)
+        return k.length === 0;
+    const head = p[0];
+    const pTail = p.slice(1);
+    if (head === "#") {
+        // `#` matches zero or more words. Try every possible split.
+        for (let i = 0; i <= k.length; i++) {
+            if (matchSegments(pTail, k.slice(i)))
+                return true;
+        }
+        return false;
+    }
+    if (k.length === 0)
+        return false;
+    if (head === "*" || head === k[0]) {
+        return matchSegments(pTail, k.slice(1));
+    }
+    return false;
+}
+//# sourceMappingURL=match.js.map

package/dist/asyncapi/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../../src/asyncapi/match.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,GAAW;IAC1D,OAAO,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAW,EAAE,EAAE,CAAC,aAAa,CAAC,eAAe,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,aAAa,CACpB,CAAwB,EACxB,CAAwB;IAExB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IAE1C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEzB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,4DAA4D;QAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QACpD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEjC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,OAAO,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/asyncapi/parse.d.ts

@@ -0,0 +1,41 @@
+import type { AsyncAPIDocumentInterface, Diagnostic } from "@asyncapi/parser";
+/**
+ * Result of a parse — `document` is `undefined` when the spec failed to
+ * validate; `diagnostics` is always populated.
+ */
+export interface ParseResult {
+    document: AsyncAPIDocumentInterface | undefined;
+    diagnostics: Diagnostic[];
+}
+/**
+ * Input source for {@link parseSpec}.
+ *
+ *  - `{ kind: "file"; path }` — local filesystem path. `$ref`s resolve
+ *    relative to the file.
+ *  - `{ kind: "url"; url }` — fetched over HTTP(S).
+ *  - `{ kind: "string"; spec }` — already-loaded YAML / JSON. `$ref`s must
+ *    be self-contained or to URLs the parser can fetch.
+ */
+export type ParseInput = {
+    kind: "file";
+    path: string;
+} | {
+    kind: "url";
+    url: string;
+} | {
+    kind: "string";
+    spec: string;
+};
+/**
+ * Parse an AsyncAPI 3.x spec from a file, URL, or string. Delegates to
+ * `@asyncapi/parser` — does not throw on validation failure; inspect
+ * `result.diagnostics` and check `result.document !== undefined`.
+ */
+export declare function parseSpec(input: ParseInput): Promise<ParseResult>;
+/**
+ * Convenience: parse and throw on validation failure with a formatted
+ * diagnostic summary. Use this when callers don't want to handle partial
+ * results; otherwise call {@link parseSpec} directly.
+ */
+export declare function parseSpecOrThrow(input: ParseInput): Promise<AsyncAPIDocumentInterface>;
+//# sourceMappingURL=parse.d.ts.map

package/dist/asyncapi/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/asyncapi/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,UAAU,EAEX,MAAM,kBAAkB,CAAC;AAI1B;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAChD,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AA8BrC;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAUvE;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,yBAAyB,CAAC,CAYpC"}

package/dist/asyncapi/parse.js

@@ -0,0 +1,54 @@
+import { loadOptional } from "../optional.js";
+let sharedParser;
+const PACKAGES = [
+    "@asyncapi/parser",
+    "@asyncapi/avro-schema-parser",
+    "@asyncapi/openapi-schema-parser",
+];
+function getParser() {
+    sharedParser ??= loadOptional(async () => {
+        const [parserModule, avro, openapi] = await Promise.all([
+            import("@asyncapi/parser"),
+            import("@asyncapi/avro-schema-parser"),
+            import("@asyncapi/openapi-schema-parser"),
+        ]);
+        const parser = new parserModule.Parser({
+            schemaParsers: [avro.AvroSchemaParser(), openapi.OpenAPISchemaParser()],
+        });
+        return { parser, parserModule };
+    }, "AsyncAPI input", PACKAGES);
+    return sharedParser;
+}
+/**
+ * Parse an AsyncAPI 3.x spec from a file, URL, or string. Delegates to
+ * `@asyncapi/parser` — does not throw on validation failure; inspect
+ * `result.diagnostics` and check `result.document !== undefined`.
+ */
+export async function parseSpec(input) {
+    const { parser, parserModule } = await getParser();
+    switch (input.kind) {
+        case "file":
+            return parserModule.fromFile(parser, input.path).parse();
+        case "url":
+            return parserModule.fromURL(parser, input.url).parse();
+        case "string":
+            return parser.parse(input.spec);
+    }
+}
+/**
+ * Convenience: parse and throw on validation failure with a formatted
+ * diagnostic summary. Use this when callers don't want to handle partial
+ * results; otherwise call {@link parseSpec} directly.
+ */
+export async function parseSpecOrThrow(input) {
+    const { document, diagnostics } = await parseSpec(input);
+    if (!document) {
+        const errors = diagnostics
+            .filter((d) => d.severity === 0)
+            .map((d) => `  - ${d.message} (${d.path?.join(".") ?? "<root>"})`)
+            .join("\n");
+        throw new Error(`AsyncAPI spec failed validation:\n${errors || diagnostics.map((d) => `  - ${d.message}`).join("\n")}`);
+    }
+    return document;
+}
+//# sourceMappingURL=parse.js.map

package/dist/asyncapi/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/asyncapi/parse.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAyB9C,IAAI,YAAqE,CAAC;AAG1E,MAAM,QAAQ,GAAG;IACf,kBAAkB;IAClB,8BAA8B;IAC9B,iCAAiC;CAClC,CAAC;AAEF,SAAS,SAAS;IAChB,YAAY,KAAK,YAAY,CAC3B,KAAK,IAAI,EAAE;QACT,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACtD,MAAM,CAAC,kBAAkB,CAAC;YAC1B,MAAM,CAAC,8BAA8B,CAAC;YACtC,MAAM,CAAC,iCAAiC,CAAC;SAC1C,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC;YACrC,aAAa,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,OAAO,CAAC,mBAAmB,EAAE,CAAC;SACxE,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAClC,CAAC,EACD,gBAAgB,EAChB,QAAQ,CACT,CAAC;IACF,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAiB;IAC/C,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,SAAS,EAAE,CAAC;IACnD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3D,KAAK,KAAK;YACR,OAAO,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QACzD,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAiB;IAEjB,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;IACzD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,WAAW;aACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC;aACjE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CACb,qCAAqC,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvG,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/cli/bin.d.ts

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

package/dist/cli/bin.d.ts.map

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

package/dist/cli/bin.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { docsCommand } from "./commands/docs.js";
+import { fnSchemaDiffCommand } from "./commands/fn-schema-diff.js";
+import { fnSchemaExtractCommand } from "./commands/fn-schema-extract.js";
+import { fnSchemaInspectCommand } from "./commands/fn-schema-inspect.js";
+import { fnSchemaScanCommand } from "./commands/fn-schema-scan.js";
+import { generateCommand, watchCommand } from "./commands/generate.js";
+import { initCommand } from "./commands/init.js";
+import { k6BundleCommand } from "./commands/k6-bundle.js";
+import { k6SyncCommand } from "./commands/k6-sync.js";
+import { reconCommand } from "./commands/recon.js";
+import { sdkAllCommand } from "./commands/sdk-all.js";
+import { sdkCommands } from "./commands/sdk-targets.js";
+import { specConvertCommand } from "./commands/spec-convert.js";
+import { specDiffCommand } from "./commands/spec-diff.js";
+import { runCli } from "./runtime.js";
+const { version } = createRequire(import.meta.url)("../../package.json");
+await runCli({
+    name: "ir",
+    version,
+    description: "Load, convert, diff and document API specs, and generate SDKs, docs and k6 load tests from them.",
+    commands: [
+        initCommand,
+        generateCommand,
+        watchCommand,
+        specConvertCommand,
+        specDiffCommand,
+        docsCommand,
+        ...sdkCommands,
+        sdkAllCommand,
+        reconCommand,
+        fnSchemaExtractCommand,
+        fnSchemaScanCommand,
+        fnSchemaInspectCommand,
+        fnSchemaDiffCommand,
+        k6SyncCommand,
+        k6BundleCommand,
+    ],
+});
+//# sourceMappingURL=bin.js.map

package/dist/cli/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAEtE,CAAC;AAEF,MAAM,MAAM,CAAC;IACX,IAAI,EAAE,IAAI;IACV,OAAO;IACP,WAAW,EACT,kGAAkG;IACpG,QAAQ,EAAE;QACR,WAAW;QACX,eAAe;QACf,YAAY;QACZ,kBAAkB;QAClB,eAAe;QACf,WAAW;QACX,GAAG,WAAW;QACd,aAAa;QACb,YAAY;QACZ,sBAAsB;QACtB,mBAAmB;QACnB,sBAAsB;QACtB,mBAAmB;QACnB,aAAa;QACb,eAAe;KAChB;CACF,CAAC,CAAC"}

package/dist/cli/command-spec.d.ts

@@ -0,0 +1,11 @@
+import type { Schema } from "../schema/index.js";
+export type OutputFormat = "none" | "json" | "yaml" | "table";
+export interface CommandSpec<TInput, TOutput> {
+    path: ReadonlyArray<string>;
+    description: string;
+    args: Schema;
+    output?: Schema;
+    handler: (input: TInput) => Promise<TOutput>;
+}
+export type AnyCommandSpec = CommandSpec<any, any>;
+//# sourceMappingURL=command-spec.d.ts.map

package/dist/cli/command-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-spec.d.ts","sourceRoot":"","sources":["../../src/cli/command-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9D,MAAM,WAAW,WAAW,CAAC,MAAM,EAAE,OAAO;IAC1C,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9C;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC"}

package/dist/cli/command-spec.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-spec.js.map

package/dist/cli/command-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-spec.js","sourceRoot":"","sources":["../../src/cli/command-spec.ts"],"names":[],"mappings":""}

package/dist/cli/commands/docs.d.ts

@@ -0,0 +1,10 @@
+import type { CommandSpec } from "../command-spec.js";
+interface Input {
+    input: string;
+    out?: string;
+    theme?: string;
+    from?: string;
+}
+export declare const docsCommand: CommandSpec<Input, void>;
+export {};
+//# sourceMappingURL=docs.d.ts.map

package/dist/cli/commands/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/docs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,UAAU,KAAK;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAqCD,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,KAAK,EAAE,IAAI,CAkBhD,CAAC"}

package/dist/cli/commands/docs.js

@@ -0,0 +1,55 @@
+import { writeFile } from "node:fs/promises";
+import { renderDocs } from "../../spec/docs/index.js";
+const themes = [
+    "default",
+    "alternate",
+    "moon",
+    "purple",
+    "solarized",
+    "bluePlanet",
+    "saturn",
+    "kepler",
+    "mars",
+    "deepSpace",
+    "none",
+];
+const args = {
+    type: "object",
+    properties: {
+        input: { type: "string", description: "Spec file path or URL" },
+        out: {
+            type: "string",
+            description: "Output HTML path (stdout if omitted)",
+        },
+        theme: {
+            type: "string",
+            description: "Scalar theme",
+            enum: themes,
+        },
+        from: {
+            type: "string",
+            description: "Source format (auto-detected if omitted)",
+        },
+    },
+    required: ["input"],
+};
+export const docsCommand = {
+    path: ["docs"],
+    description: "Render any spec as standalone HTML docs via Scalar (converts to OpenAPI 3 first)",
+    args,
+    handler: async (input) => {
+        const { html } = await renderDocs({
+            input: input.input,
+            from: input.from,
+            theme: input.theme,
+        });
+        if (input.out) {
+            await writeFile(input.out, html);
+            process.stdout.write(`Wrote ${input.out}\n`);
+        }
+        else {
+            process.stdout.write(html);
+        }
+    },
+};
+//# sourceMappingURL=docs.js.map

package/dist/cli/commands/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/cli/commands/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAWtD,MAAM,MAAM,GAAG;IACb,SAAS;IACT,WAAW;IACX,MAAM;IACN,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,WAAW;IACX,MAAM;CACP,CAAC;AAEF,MAAM,IAAI,GAAW;IACnB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;QAC/D,GAAG,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,sCAAsC;SACpD;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,cAAc;YAC3B,IAAI,EAAE,MAAM;SACb;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0CAA0C;SACxD;KACF;IACD,QAAQ,EAAE,CAAC,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAA6B;IACnD,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,WAAW,EACT,kFAAkF;IACpF,IAAI;IACJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,UAAU,CAAC;YAChC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAgD;YAC5D,KAAK,EAAE,KAAK,CAAC,KAAkD;SAChE,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YACd,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/cli/commands/fn-schema-diff.d.ts

@@ -0,0 +1,10 @@
+import type { CommandSpec } from "../command-spec.js";
+interface Input {
+    from: string;
+    to: string;
+    json?: boolean;
+    breakingOnly?: boolean;
+}
+export declare const fnSchemaDiffCommand: CommandSpec<Input, void>;
+export {};
+//# sourceMappingURL=fn-schema-diff.d.ts.map

package/dist/cli/commands/fn-schema-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fn-schema-diff.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/fn-schema-diff.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAsBD,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,KAAK,EAAE,IAAI,CA6BxD,CAAC"}

package/dist/cli/commands/fn-schema-diff.js

@@ -0,0 +1,46 @@
+import { runDiff } from "../../fn-schema/core/index.js";
+import { log } from "../log.js";
+const args = {
+    type: "object",
+    properties: {
+        from: { type: "string", description: "Baseline bundle (JSON path)" },
+        to: { type: "string", description: "New bundle (JSON path)" },
+        json: {
+            type: "boolean",
+            description: "Emit machine-readable JSON",
+            default: false,
+        },
+        breakingOnly: {
+            type: "boolean",
+            description: "Exit non-zero only when changes are breaking (removed signatures, changed input/output shape)",
+            default: false,
+        },
+    },
+    required: ["from", "to"],
+};
+export const fnSchemaDiffCommand = {
+    path: ["fn-schema", "diff"],
+    description: "Compare two fn-schema bundles. Reports added/removed/changed signatures and definitions",
+    args,
+    handler: async (input) => {
+        const out = await runDiff(input.from, input.to);
+        if (input.json) {
+            process.stdout.write(`${JSON.stringify(out, null, 2)}\n`);
+        }
+        else {
+            for (const c of out.changes) {
+                const marker = c.kind === "added" ? "+" : c.kind === "removed" ? "-" : "~";
+                process.stdout.write(`${marker} ${c.id}  (${c.kind})\n`);
+            }
+            for (const d of out.definitionChanges) {
+                const marker = d.kind === "added" ? "+" : d.kind === "removed" ? "-" : "~";
+                process.stdout.write(`${marker} def ${d.name}  (${d.kind})\n`);
+            }
+            log.box(`${out.changes.length} signature change(s), ${out.definitionChanges.length} definition change(s) — ${out.breaking} breaking, ${out.additive} additive`);
+        }
+        const fail = input.breakingOnly ? out.breaking > 0 : out.changes.length > 0;
+        if (fail)
+            process.exitCode = 1;
+    },
+};
+//# sourceMappingURL=fn-schema-diff.js.map

package/dist/cli/commands/fn-schema-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fn-schema-diff.js","sourceRoot":"","sources":["../../../src/cli/commands/fn-schema-diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAGxD,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAShC,MAAM,IAAI,GAAW;IACnB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;QACpE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;QAC7D,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,4BAA4B;YACzC,OAAO,EAAE,KAAK;SACf;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,SAAS;YACf,WAAW,EACT,+FAA+F;YACjG,OAAO,EAAE,KAAK;SACf;KACF;IACD,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAA6B;IAC3D,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;IAC3B,WAAW,EACT,yFAAyF;IAC3F,IAAI;IACJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAEhD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC5B,MAAM,MAAM,GACV,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;YAC3D,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC;gBACtC,MAAM,MAAM,GACV,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;YACjE,CAAC;YACD,GAAG,CAAC,GAAG,CACL,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,yBAAyB,GAAG,CAAC,iBAAiB,CAAC,MAAM,2BAA2B,GAAG,CAAC,QAAQ,cAAc,GAAG,CAAC,QAAQ,WAAW,CACvJ,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5E,IAAI,IAAI;YAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACjC,CAAC;CACF,CAAC"}