@ir-kit/cli 0.2.0

package/dist/schema-args.d.ts

@@ -0,0 +1,24 @@
+import { type Schema } from "@ir-kit/schema";
+import type { ArgsDef } from "citty";
+/**
+ * Convert a JSON Schema 2020-12 object schema into citty's `ArgsDef` map.
+ * Each top-level property becomes one citty arg. The first required
+ * string property is rendered positional; everything else is a named flag.
+ * `enum` constraints become `string` flags + are validated post-parse.
+ */
+export declare function schemaToCittyArgs(schema: Schema): ArgsDef;
+/**
+ * Walk a JSON Schema and prompt the user for any required field whose
+ * value is missing in `partial`. Returns a fully-populated input object.
+ * Run AFTER citty has parsed argv so explicit flags win over prompts.
+ */
+export declare function fillFromPrompts<T extends Record<string, unknown>>(schema: Schema, partial: Partial<T>, opts?: {
+    title?: string;
+}): Promise<T>;
+/**
+ * Validate a fully-populated input against the schema's `enum` /
+ * required constraints. Throws on validation failure with a one-line
+ * error matching the offending property.
+ */
+export declare function validateInput(schema: Schema, input: Record<string, unknown>): void;
+//# sourceMappingURL=schema-args.d.ts.map

package/dist/schema-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-args.d.ts","sourceRoot":"","sources":["../src/schema-args.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAErC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAmDzD;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5B,OAAO,CAAC,CAAC,CAAC,CA6CZ;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAmBN"}

package/dist/schema-args.js

@@ -0,0 +1,130 @@
+import { intro, isCancel, outro, select, text } from "@clack/prompts";
+import { isSchemaObject } from "@ir-kit/schema";
+/**
+ * Convert a JSON Schema 2020-12 object schema into citty's `ArgsDef` map.
+ * Each top-level property becomes one citty arg. The first required
+ * string property is rendered positional; everything else is a named flag.
+ * `enum` constraints become `string` flags + are validated post-parse.
+ */
+export function schemaToCittyArgs(schema) {
+    const args = {};
+    const required = new Set(schema.required ?? []);
+    const props = Object.entries(schema.properties ?? {});
+    const firstRequiredString = props.find(([name, p]) => required.has(name) &&
+        isSchemaObject(p) &&
+        p.type === "string")?.[0];
+    for (const [name, propUnknown] of props) {
+        if (!isSchemaObject(propUnknown))
+            continue;
+        const prop = propUnknown;
+        const description = prop.description ?? "";
+        if (name === firstRequiredString) {
+            args[name] = {
+                type: "positional",
+                description,
+                required: true,
+            };
+            continue;
+        }
+        const t = Array.isArray(prop.type) ? prop.type[0] : prop.type;
+        if (t === "boolean") {
+            args[name] = {
+                type: "boolean",
+                description,
+                default: prop.default,
+            };
+        }
+        else if (t === "number" || t === "integer") {
+            args[name] = {
+                type: "string",
+                description,
+                default: prop.default,
+                required: required.has(name) && prop.default === undefined,
+            };
+        }
+        else {
+            args[name] = {
+                type: "string",
+                description,
+                default: prop.default,
+                required: required.has(name) && prop.default === undefined,
+            };
+        }
+    }
+    return args;
+}
+/**
+ * Walk a JSON Schema and prompt the user for any required field whose
+ * value is missing in `partial`. Returns a fully-populated input object.
+ * Run AFTER citty has parsed argv so explicit flags win over prompts.
+ */
+export async function fillFromPrompts(schema, partial, opts = {}) {
+    const required = new Set(schema.required ?? []);
+    const props = Object.entries(schema.properties ?? {});
+    const missing = props.filter(([name]) => required.has(name) && partial[name] === undefined);
+    if (missing.length === 0)
+        return partial;
+    if (opts.title)
+        intro(opts.title);
+    const filled = { ...partial };
+    for (const [name, propUnknown] of missing) {
+        if (!isSchemaObject(propUnknown))
+            continue;
+        const prop = propUnknown;
+        const message = prop.description ?? name;
+        let value;
+        if (Array.isArray(prop.enum) && prop.enum.length > 0) {
+            const options = prop.enum.map((v) => ({
+                value: String(v),
+                label: String(v),
+            }));
+            value = await select({
+                message,
+                options,
+                initialValue: prop.default ?? options[0]?.value,
+            });
+        }
+        else {
+            value = await text({
+                message,
+                placeholder: prop.examples?.[0] != null ? String(prop.examples[0]) : "",
+                initialValue: prop.default,
+                validate: (v) => {
+                    if (!v || !v.trim())
+                        return `${name} is required`;
+                },
+            });
+        }
+        if (isCancel(value)) {
+            outro("Cancelled.");
+            process.exit(1);
+        }
+        filled[name] = value;
+    }
+    return filled;
+}
+/**
+ * Validate a fully-populated input against the schema's `enum` /
+ * required constraints. Throws on validation failure with a one-line
+ * error matching the offending property.
+ */
+export function validateInput(schema, input) {
+    const required = schema.required ?? [];
+    for (const name of required) {
+        if (input[name] === undefined || input[name] === "") {
+            throw new Error(`Missing required argument: --${name}`);
+        }
+    }
+    for (const [name, propUnknown] of Object.entries(schema.properties ?? {})) {
+        if (!isSchemaObject(propUnknown))
+            continue;
+        const prop = propUnknown;
+        if (Array.isArray(prop.enum) && input[name] !== undefined) {
+            const allowed = prop.enum.map(String);
+            if (!allowed.includes(String(input[name]))) {
+                throw new Error(`Invalid value for --${name}: ${input[name]}. Allowed: ${allowed.join(", ")}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=schema-args.js.map

package/dist/schema-args.js.map

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

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@ir-kit/cli",
+  "version": "0.2.0",
+  "description": "Unified `ir` CLI — single entry point for spec loading, conversion, codegen, and reverse-engineering across every supported API standard. Commands are JSON-Schema-defined; runtime auto-derives flags, prompts, help, and validation from the schema.",
+  "keywords": [
+    "cli",
+    "openapi",
+    "asyncapi",
+    "typespec",
+    "codegen",
+    "ir-kit"
+  ],
+  "homepage": "https://github.com/ir-kit/ir-kit/tree/main/packages/cli",
+  "bugs": {
+    "url": "https://github.com/ir-kit/ir-kit/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Ahmed Rowaihi",
+    "email": "ahmedrowaihi@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ir-kit/ir-kit.git",
+    "directory": "packages/cli"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "ir": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.3.0",
+    "chokidar": "^4.0.3",
+    "citty": "^0.2.2",
+    "consola": "^3.4.2",
+    "@ir-kit/fn-schema-core": "0.2.0",
+    "@ir-kit/fn-schema-typescript": "0.1.1",
+    "@ir-kit/k6-gen": "0.3.0",
+    "@ir-kit/k6-toolkit": "0.2.0",
+    "@ir-kit/openapi-go": "2.0.0",
+    "@ir-kit/openapi-kotlin": "2.0.0",
+    "@ir-kit/openapi-recon": "0.2.0",
+    "@ir-kit/openapi-swift": "2.0.0",
+    "@ir-kit/openapi-typescript": "0.2.0",
+    "@ir-kit/schema": "0.2.0",
+    "@ir-kit/spec-convert": "0.2.0",
+    "@ir-kit/spec-diff": "0.2.0",
+    "@ir-kit/spec-docs": "0.2.0",
+    "@ir-kit/spec-loader": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "vitest": "^4.0.0",
+    "@ir-kit/tsconfig": "0.0.0"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}