@ir-kit/kit 0.0.1 → 1.0.0

package/docs/spec-typespec.md

@@ -0,0 +1,60 @@
+# `@ir-kit/kit/spec/typespec`
+
+Compile a [TypeSpec](https://typespec.io) file or inline source to an OpenAPI 3 document in memory. Thin wrapper over `@typespec/compiler` + `@typespec/openapi3` — plugs into any ir-kit OpenAPI generator at the spec-loading boundary.
+
+Part of [ir-kit](https://github.com/ahmedrowaihi/ir-kit).
+
+## Install
+
+```sh
+npm install @ir-kit/kit
+# Peer deps (install whichever emitters you'll use):
+npm install @typespec/compiler @typespec/openapi3 @typespec/json-schema @typespec/protobuf
+```
+
+## Usage
+
+```ts
+import { compileTypespec } from "@ir-kit/kit/spec/typespec";
+
+// From a file path
+const { document } = await compileTypespec({ path: "./api.tsp" });
+
+// From inline source
+const { document } = await compileTypespec({
+  source: `
+    @service(#{ title: "Petstore" })
+    namespace Petstore;
+
+    model Pet { id: int32; name: string; }
+    op listPets(): Pet[];
+  `,
+  imports: ["@typespec/http"],
+});
+```
+
+No disk artifacts survive the call — compilation runs against a temp dir that's cleaned up automatically.
+
+## Capture mode
+
+For emitters that don't expose a `getX()` programmatic API (e.g. `@typespec/json-schema`, `@typespec/protobuf`), use `compileTypespecCapture` — it wraps the compiler host and intercepts `writeFile` calls so the emitted files come back as an in-memory `{ path → content }` map.
+
+```ts
+import { compileTypespecCapture } from "@ir-kit/kit/spec/typespec";
+
+const { files } = await compileTypespecCapture(
+  { path: "./api.tsp" },
+  { emitter: "@typespec/json-schema" },
+);
+```
+
+## API
+
+| Export                                                                    | Description                                            |
+| ------------------------------------------------------------------------- | ------------------------------------------------------ |
+| `compileTypespec(input, opts?)`                                           | Compile to OpenAPI 3, return `{ document, documents }` |
+| `compileTypespecCapture(input, opts)`                                     | Run any emitter, return `{ files }` map                |
+| `isTypespecPath(input)`                                                   | Type predicate — `true` for `.tsp` string paths        |
+| `CompileTypespecInput`, `CompileTypespecOptions`, `CompileTypespecResult` | Public types                                           |
+
+Multi-service TypeSpec entries emit multiple OpenAPI documents — access via `result.documents`. The single-document `result.document` getter throws when the entry produces more than one (catch-and-handle if your entry might be versioned or multi-service).

package/package.json

@@ -1,11 +1,446 @@
 {
   "name": "@ir-kit/kit",
-  "version": "0.0.1",
-  "description": "Placeholder. The first real release is @ir-kit/kit 1.0.0.",
-  "license": "MIT",
+  "version": "1.0.0",
+  "description": "API spec toolchain: load, convert, diff and document any API spec, and generate SDKs, mocks, validators and k6 load tests from it.",
+  "keywords": [
+    "openapi",
+    "asyncapi",
+    "typespec",
+    "protobuf",
+    "postman",
+    "sdk",
+    "codegen",
+    "go",
+    "kotlin",
+    "swift",
+    "java",
+    "typescript",
+    "k6",
+    "hey-api"
+  ],
+  "homepage": "https://github.com/ahmedrowaihi/ir-kit#readme",
+  "bugs": {
+    "url": "https://github.com/ahmedrowaihi/ir-kit/issues"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ahmedrowaihi/ir-kit.git",
     "directory": "packages/ir-kit"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Ahmed Rowaihi",
+    "email": "ahmedrowaihi@gmail.com"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "bin": {
+    "ir": "./bin/ir.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./asyncapi": {
+      "types": "./dist/asyncapi/index.d.ts",
+      "import": "./dist/asyncapi/index.js"
+    },
+    "./asyncapi/bindings": {
+      "types": "./dist/asyncapi/bindings.d.ts",
+      "import": "./dist/asyncapi/bindings.js"
+    },
+    "./asyncapi/match": {
+      "types": "./dist/asyncapi/match.d.ts",
+      "import": "./dist/asyncapi/match.js"
+    },
+    "./asyncapi/parse": {
+      "types": "./dist/asyncapi/parse.d.ts",
+      "import": "./dist/asyncapi/parse.js"
+    },
+    "./cli": {
+      "types": "./dist/cli/index.d.ts",
+      "import": "./dist/cli/index.js"
+    },
+    "./codegen": {
+      "types": "./dist/codegen/index.d.ts",
+      "import": "./dist/codegen/index.js"
+    },
+    "./fn-schema": {
+      "types": "./dist/fn-schema/core/index.d.ts",
+      "import": "./dist/fn-schema/core/index.js"
+    },
+    "./fn-schema/emit": {
+      "types": "./dist/fn-schema/core/emit/index.d.ts",
+      "import": "./dist/fn-schema/core/emit/index.js"
+    },
+    "./fn-schema/loader": {
+      "types": "./dist/fn-schema/loader/index.d.ts",
+      "import": "./dist/fn-schema/loader/index.js"
+    },
+    "./fn-schema/transformer": {
+      "types": "./dist/fn-schema/transformer/index.d.ts",
+      "import": "./dist/fn-schema/transformer/index.js"
+    },
+    "./fn-schema/transformer/runtime": {
+      "types": "./dist/fn-schema/transformer/runtime.d.ts",
+      "import": "./dist/fn-schema/transformer/runtime.js"
+    },
+    "./fn-schema/typescript": {
+      "types": "./dist/fn-schema/typescript/index.d.ts",
+      "import": "./dist/fn-schema/typescript/index.js"
+    },
+    "./fn-schema/unplugin": {
+      "types": "./dist/fn-schema/unplugin/index.d.ts",
+      "import": "./dist/fn-schema/unplugin/index.js"
+    },
+    "./fn-schema/unplugin/esbuild": {
+      "types": "./dist/fn-schema/unplugin/esbuild.d.ts",
+      "import": "./dist/fn-schema/unplugin/esbuild.js"
+    },
+    "./fn-schema/unplugin/farm": {
+      "types": "./dist/fn-schema/unplugin/farm.d.ts",
+      "import": "./dist/fn-schema/unplugin/farm.js"
+    },
+    "./fn-schema/unplugin/rolldown": {
+      "types": "./dist/fn-schema/unplugin/rolldown.d.ts",
+      "import": "./dist/fn-schema/unplugin/rolldown.js"
+    },
+    "./fn-schema/unplugin/rollup": {
+      "types": "./dist/fn-schema/unplugin/rollup.d.ts",
+      "import": "./dist/fn-schema/unplugin/rollup.js"
+    },
+    "./fn-schema/unplugin/rspack": {
+      "types": "./dist/fn-schema/unplugin/rspack.d.ts",
+      "import": "./dist/fn-schema/unplugin/rspack.js"
+    },
+    "./fn-schema/unplugin/vite": {
+      "types": "./dist/fn-schema/unplugin/vite.d.ts",
+      "import": "./dist/fn-schema/unplugin/vite.js"
+    },
+    "./fn-schema/unplugin/webpack": {
+      "types": "./dist/fn-schema/unplugin/webpack.d.ts",
+      "import": "./dist/fn-schema/unplugin/webpack.js"
+    },
+    "./generate": {
+      "types": "./dist/generate/index.d.ts",
+      "import": "./dist/generate/index.js"
+    },
+    "./k6-toolkit": {
+      "types": "./dist/k6-toolkit/index.d.ts",
+      "import": "./dist/k6-toolkit/index.js"
+    },
+    "./openapi": {
+      "types": "./dist/openapi/index.d.ts",
+      "import": "./dist/openapi/index.js"
+    },
+    "./ir": {
+      "types": "./dist/ir/index.d.ts",
+      "import": "./dist/ir/index.js"
+    },
+    "./openapi-tools": {
+      "types": "./dist/openapi-tools/index.d.ts",
+      "import": "./dist/openapi-tools/index.js"
+    },
+    "./openapi-tools/ir": {
+      "types": "./dist/openapi-tools/ir.d.ts",
+      "import": "./dist/openapi-tools/ir.js"
+    },
+    "./openapi-tools/match": {
+      "types": "./dist/openapi-tools/match.d.ts",
+      "import": "./dist/openapi-tools/match.js"
+    },
+    "./openapi-tools/merge": {
+      "types": "./dist/openapi-tools/merge.d.ts",
+      "import": "./dist/openapi-tools/merge.js"
+    },
+    "./openapi-tools/route": {
+      "types": "./dist/openapi-tools/route.d.ts",
+      "import": "./dist/openapi-tools/route.js"
+    },
+    "./openapi-tools/router": {
+      "types": "./dist/openapi-tools/router.d.ts",
+      "import": "./dist/openapi-tools/router.js"
+    },
+    "./openapi-ts/faker": {
+      "types": "./dist/openapi-ts/faker/index.d.ts",
+      "import": "./dist/openapi-ts/faker/index.js"
+    },
+    "./openapi-ts/faker/core": {
+      "types": "./dist/openapi-ts/faker/core/index.d.ts",
+      "import": "./dist/openapi-ts/faker/core/index.js"
+    },
+    "./openapi-ts/k6": {
+      "types": "./dist/openapi-ts/k6/index.d.ts",
+      "import": "./dist/openapi-ts/k6/index.js"
+    },
+    "./openapi-ts/kit": {
+      "types": "./dist/openapi-ts/kit/index.d.ts",
+      "import": "./dist/openapi-ts/kit/index.js"
+    },
+    "./openapi-ts/orpc": {
+      "types": "./dist/openapi-ts/orpc/index.d.ts",
+      "import": "./dist/openapi-ts/orpc/index.js"
+    },
+    "./openapi-ts/paths": {
+      "types": "./dist/openapi-ts/paths/index.d.ts",
+      "import": "./dist/openapi-ts/paths/index.js"
+    },
+    "./openapi-ts/typia": {
+      "types": "./dist/openapi-ts/typia/index.d.ts",
+      "import": "./dist/openapi-ts/typia/index.js"
+    },
+    "./openapi-ts/typia/orpc": {
+      "types": "./dist/openapi-ts/typia/orpc/index.d.ts",
+      "import": "./dist/openapi-ts/typia/orpc/index.js"
+    },
+    "./recon": {
+      "types": "./dist/recon/index.d.ts",
+      "import": "./dist/recon/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema/index.d.ts",
+      "import": "./dist/schema/index.js"
+    },
+    "./schema/adapters/heyapi": {
+      "types": "./dist/schema/adapters/heyapi.d.ts",
+      "import": "./dist/schema/adapters/heyapi.js"
+    },
+    "./schema/adapters/jsonschema": {
+      "types": "./dist/schema/adapters/jsonschema.d.ts",
+      "import": "./dist/schema/adapters/jsonschema.js"
+    },
+    "./sdk/asyncapi": {
+      "types": "./dist/sdk/asyncapi/index.d.ts",
+      "import": "./dist/sdk/asyncapi/index.js"
+    },
+    "./sdk/go": {
+      "types": "./dist/sdk/go/index.d.ts",
+      "import": "./dist/sdk/go/index.js"
+    },
+    "./sdk/java": {
+      "types": "./dist/sdk/java/index.d.ts",
+      "import": "./dist/sdk/java/index.js"
+    },
+    "./sdk/k6": {
+      "types": "./dist/sdk/k6/index.d.ts",
+      "import": "./dist/sdk/k6/index.js"
+    },
+    "./sdk/k6/ast": {
+      "types": "./dist/sdk/k6/emit/ast.d.ts",
+      "import": "./dist/sdk/k6/emit/ast.js"
+    },
+    "./sdk/kotlin": {
+      "types": "./dist/sdk/kotlin/index.d.ts",
+      "import": "./dist/sdk/kotlin/index.js"
+    },
+    "./sdk/swift": {
+      "types": "./dist/sdk/swift/index.d.ts",
+      "import": "./dist/sdk/swift/index.js"
+    },
+    "./sdk/typescript": {
+      "types": "./dist/sdk/typescript/index.d.ts",
+      "import": "./dist/sdk/typescript/index.js"
+    },
+    "./spec": {
+      "types": "./dist/spec/index.d.ts",
+      "import": "./dist/spec/index.js"
+    },
+    "./spec/asyncapi": {
+      "types": "./dist/spec/asyncapi/index.d.ts",
+      "import": "./dist/spec/asyncapi/index.js"
+    },
+    "./spec/openapi": {
+      "types": "./dist/spec/openapi/index.d.ts",
+      "import": "./dist/spec/openapi/index.js"
+    },
+    "./spec/typespec": {
+      "types": "./dist/spec/typespec/index.d.ts",
+      "import": "./dist/spec/typespec/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "bin",
+    "docs",
+    "dist",
+    "runtime",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "dependencies": {
+    "@hey-api/json-schema-ref-parser": "0.0.0-next-20260930190945",
+    "@scalar/core": "^0.5.9",
+    "@types/json-schema": "^7.0.15",
+    "api-smart-diff": "^1.0.6",
+    "citty": "^0.2.2",
+    "js-yaml": "^4.1.0",
+    "json-schema-typed": "^8.0.2",
+    "oxc-parser": "^0.158.0",
+    "protobufjs": "^7.4.0"
+  },
+  "peerDependencies": {
+    "@asyncapi/avro-schema-parser": ">=3.0.0",
+    "@asyncapi/openapi-schema-parser": ">=3.0.0",
+    "@asyncapi/parser": ">=3.0.0",
+    "@faker-js/faker": "^10.0.0 || ^9.0.0 || ^8.0.0",
+    "@hey-api/codegen-core": "0.0.0-next-20260930190945",
+    "@hey-api/openapi-ts": "0.0.0-next-20260930190945",
+    "@hey-api/shared": "0.0.0-next-20260930190945",
+    "@hey-api/spec-types": "0.0.0-next-20260930190945",
+    "@orpc/client": "^1.13",
+    "@orpc/contract": ">=1.13.0",
+    "@orpc/openapi": ">=1.13.0",
+    "@orpc/openapi-client": "^1.13",
+    "@orpc/server": "^1.13",
+    "@orpc/tanstack-query": "^1.13",
+    "@orpc/zod": "^1.13",
+    "@readme/postman-to-openapi": "^4.1.0",
+    "@standard-schema/spec": "^1.0.0",
+    "@typespec/compiler": ">=1.0.0",
+    "@typespec/json-schema": ">=1.0.0",
+    "@typespec/openapi3": ">=1.0.0",
+    "@typespec/protobuf": ">=0.80.0",
+    "amqplib": ">=0.10.0",
+    "openapi-to-postmanv2": "^6.0.1",
+    "ts-json-schema-generator": "^2.9.0",
+    "ts-morph": "^28.0.0",
+    "tsdown": "^0.22.0",
+    "typescript": ">=5.0.0",
+    "typia": "^12.0.0 || ^15.0.0",
+    "unplugin": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@asyncapi/avro-schema-parser": {
+      "optional": true
+    },
+    "@asyncapi/openapi-schema-parser": {
+      "optional": true
+    },
+    "@asyncapi/parser": {
+      "optional": true
+    },
+    "@faker-js/faker": {
+      "optional": true
+    },
+    "@orpc/client": {
+      "optional": true
+    },
+    "@orpc/contract": {
+      "optional": true
+    },
+    "@orpc/openapi": {
+      "optional": true
+    },
+    "@orpc/openapi-client": {
+      "optional": true
+    },
+    "@orpc/server": {
+      "optional": true
+    },
+    "@orpc/tanstack-query": {
+      "optional": true
+    },
+    "@orpc/zod": {
+      "optional": true
+    },
+    "@readme/postman-to-openapi": {
+      "optional": true
+    },
+    "@standard-schema/spec": {
+      "optional": true
+    },
+    "@typespec/compiler": {
+      "optional": true
+    },
+    "@typespec/json-schema": {
+      "optional": true
+    },
+    "@typespec/openapi3": {
+      "optional": true
+    },
+    "@typespec/protobuf": {
+      "optional": true
+    },
+    "amqplib": {
+      "optional": true
+    },
+    "openapi-to-postmanv2": {
+      "optional": true
+    },
+    "ts-json-schema-generator": {
+      "optional": true
+    },
+    "ts-morph": {
+      "optional": true
+    },
+    "tsdown": {
+      "optional": true
+    },
+    "typescript": {
+      "optional": true
+    },
+    "typia": {
+      "optional": true
+    },
+    "unplugin": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@asyncapi/avro-schema-parser": "^3.0.24",
+    "@asyncapi/openapi-schema-parser": "^3.0.24",
+    "@asyncapi/parser": "^3.6.0",
+    "@faker-js/faker": "^10.4.0",
+    "@hey-api/codegen-core": "0.0.0-next-20260930190945",
+    "@hey-api/openapi-ts": "0.0.0-next-20260930190945",
+    "@hey-api/shared": "0.0.0-next-20260930190945",
+    "@hey-api/spec-types": "0.0.0-next-20260930190945",
+    "@orpc/client": "^1.14.0",
+    "@orpc/contract": "^1.13.14",
+    "@orpc/openapi": "^1.13.14",
+    "@orpc/openapi-client": "^1.14.0",
+    "@orpc/server": "^1.14.0",
+    "@orpc/tanstack-query": "^1.14.0",
+    "@orpc/zod": "^1.13",
+    "@readme/postman-to-openapi": "^4.1.0",
+    "@standard-schema/spec": "^1.1.0",
+    "@testcontainers/rabbitmq": "^11.14.0",
+    "@types/amqplib": "^0.10.5",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^24",
+    "@typespec/compiler": "^1.12.0",
+    "@typespec/http": "^1.12.0",
+    "@typespec/json-schema": "^1.12.0",
+    "@typespec/openapi": "^1.12.0",
+    "@typespec/openapi3": "^1.12.0",
+    "@typespec/protobuf": "^0.82.0",
+    "@typespec/rest": "^0.74.0",
+    "amqplib": "^0.10.4",
+    "openapi-to-postmanv2": "^6.0.1",
+    "oxc-parser": "^0.158.0",
+    "testcontainers": "^11.14.0",
+    "ts-json-schema-generator": "^2.9.0",
+    "ts-morph": "^28.0.0",
+    "tsdown": "^0.22.0",
+    "typescript": "7.0.2",
+    "typescript5": "npm:typescript@5.9.3",
+    "typia": "15.4.0",
+    "unplugin": "^3.0.0",
+    "vitest": "^4.0.0",
+    "@ir-kit/tsconfig": "0.0.0"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "sync-typia-tags": "node scripts/sync-typia-tags.ts"
   }
-}
+}

package/runtime/asyncapi/amqplib/amqp.gen.ts

@@ -0,0 +1,99 @@
+// AUTO-GENERATED by @ir-kit/kit/sdk/asyncapi — do not hand-edit.
+
+import type { Channel, ConsumeMessage } from "amqplib";
+
+export interface EventDescriptor {
+  exchange: string;
+  exchangeType: string;
+  type: string;
+  contentType?: string;
+}
+
+export interface ConsumerLike {
+  bindings: ReadonlyArray<{ exchange: string; routingKey: string }>;
+  dispatch: (raw: ConsumeMessage | null) => Promise<void> | void;
+}
+
+export interface AssertExchangesOptions {
+  durable?: boolean;
+}
+
+export async function assertExchanges(
+  channel: Channel,
+  events: Readonly<Record<string, EventDescriptor>>,
+  opts: AssertExchangesOptions = {},
+) {
+  const seen = new Set<string>();
+  for (const ev of Object.values(events)) {
+    if (seen.has(ev.exchange)) continue;
+    seen.add(ev.exchange);
+    await channel.assertExchange(ev.exchange, ev.exchangeType, {
+      durable: opts.durable,
+    });
+  }
+}
+
+export interface BindAndConsumeOptions {
+  durable?: boolean;
+  exclusive?: boolean;
+  autoDelete?: boolean;
+  noAck?: boolean;
+}
+
+export async function bindAndConsume(
+  channel: Channel,
+  queue: string,
+  registry: ConsumerLike,
+  opts: BindAndConsumeOptions = {},
+) {
+  await channel.assertQueue(queue, {
+    durable: opts.durable,
+    exclusive: opts.exclusive,
+    autoDelete: opts.autoDelete,
+  });
+  for (const { exchange, routingKey } of registry.bindings) {
+    await channel.bindQueue(queue, exchange, routingKey);
+  }
+  return channel.consume(queue, registry.dispatch, {
+    noAck: opts.noAck,
+  });
+}
+
+/**
+ * Encode a typed payload to bytes. Default is JSON.stringify + utf8.
+ * Override to swap in protobuf / msgpack / cbor / etc.
+ */
+export type SerializeFn = <T>(payload: T) => Buffer;
+
+const defaultSerialize: SerializeFn = (payload) =>
+  Buffer.from(JSON.stringify(payload));
+
+export interface PublishOptions {
+  serialize?: SerializeFn;
+  persistent?: boolean;
+  expiration?: number;
+  priority?: number;
+  correlationId?: string;
+  replyTo?: string;
+  headers?: Record<string, unknown>;
+  mandatory?: boolean;
+}
+
+export function publish<T>(
+  channel: Channel,
+  ev: EventDescriptor,
+  payload: T,
+  opts: PublishOptions = {},
+): boolean {
+  const serialize = opts.serialize ?? defaultSerialize;
+  return channel.publish(ev.exchange, ev.type, serialize(payload), {
+    contentType: ev.contentType,
+    persistent: opts.persistent,
+    expiration: opts.expiration?.toString(),
+    priority: opts.priority,
+    correlationId: opts.correlationId,
+    replyTo: opts.replyTo,
+    headers: opts.headers,
+    mandatory: opts.mandatory,
+  });
+}