@qraft/cli 1.0.0-beta.0

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# @qraft/cli
+
+## 1.0.0-beta.0
+
+### Minor Changes
+
+- a282960: Introduce unified CLI tool `@qraft/cli` that extends code generation capabilities beyond OpenAPI to support AsyncAPI
+  specifications. The new CLI provides three main commands:
+  - `qraft openapi` - Generate type-safe code from OpenAPI documents (React Query hooks and TypeScript types)
+  - `qraft asyncapi` - Generate TypeScript types from AsyncAPI documents
+  - `qraft redocly` - Generate code from Redocly configuration files supporting both OpenAPI and AsyncAPI APIs
+
+  The CLI uses a plugin-based architecture where plugins are installed as peer dependencies, allowing users to install
+  only the plugins they need. It maintains full backward compatibility with existing OpenAPI workflows while adding
+  seamless support for event-driven API specifications.
+
+### Patch Changes
+
+- Updated dependencies [7074f50]
+- Updated dependencies [a282960]
+  - @openapi-qraft/tanstack-query-react-plugin@2.15.0-beta.1
+  - @qraft/asyncapi-typescript-plugin@1.0.0-beta.0
+  - @openapi-qraft/openapi-typescript-plugin@2.15.0-beta.1
+  - @qraft/asyncapi-plugin@1.0.0-beta.0
+  - @openapi-qraft/plugin@2.15.0-beta.1
+  - @qraft/cli-utils@1.0.0-beta.0
+  - @qraft/plugin@1.0.0-beta.0

package/README.md

@@ -0,0 +1,139 @@
+# @qraft/cli
+
+CLI tool for generating type-safe code from OpenAPI and AsyncAPI specifications.
+
+## Installation
+
+**Requirements:** Node.js >= 20.19.6
+
+```bash
+npm install -g @qraft/cli
+```
+
+### Required Plugins
+
+The CLI requires additional plugins to be installed depending on which features you want to use:
+
+**For OpenAPI generation:**
+
+```bash
+npm install @openapi-qraft/openapi-typescript-plugin @openapi-qraft/tanstack-query-react-plugin
+```
+
+**For AsyncAPI generation:**
+
+```bash
+npm install @qraft/asyncapi-typescript-plugin
+```
+
+**For both OpenAPI and AsyncAPI:**
+
+```bash
+npm install @openapi-qraft/openapi-typescript-plugin @openapi-qraft/tanstack-query-react-plugin @qraft/asyncapi-typescript-plugin
+```
+
+> **Note:** All plugins are peer dependencies and must be installed alongside `@qraft/cli` for the corresponding
+> commands to work.
+
+## Commands
+
+### `qraft openapi`
+
+Generate code from OpenAPI specification.
+
+**Available plugins:**
+- `tanstack-query-react` - Generates Qraft API services for React
+- `openapi-typescript` - Generates TypeScript types from OpenAPI Document
+
+**Examples:**
+
+```bash
+# Generate TypeScript types only
+qraft openapi --plugin openapi-typescript ./openapi.yaml -o ./src/types
+
+# Generate both services and types
+qraft openapi --plugin tanstack-query-react --plugin openapi-typescript ./openapi.yaml -o ./src/api
+
+# Generate from Redocly config
+qraft openapi --redocly
+```
+
+### `qraft asyncapi`
+
+Generate code from AsyncAPI specification.
+
+**Required:** Plugin must be explicitly specified.
+
+**Available plugins:**
+- `asyncapi-typescript` - Generates TypeScript types from AsyncAPI Document
+
+**Examples:**
+
+```bash
+# Generate TypeScript types from AsyncAPI
+qraft asyncapi --plugin asyncapi-typescript ./asyncapi.yaml -o ./src/types
+
+# Generate from Redocly config
+qraft asyncapi --redocly
+```
+
+## Redocly Config Support
+
+The CLI supports using a Redocly configuration file (`redocly.yaml`) to generate API clients. This allows you to define multiple API entry points and configure generation options in a single file.
+
+### Configuration Keys
+
+- `x-openapi-qraft` - Configuration for OpenAPI generation
+- `x-asyncapi-qraft` - Configuration for AsyncAPI generation
+
+### Usage
+
+```bash
+# Generate from default redocly.yaml (both OpenAPI and AsyncAPI)
+qraft redocly
+
+# Generate from specific config file
+qraft redocly --redocly ./path/to/redocly.yaml
+
+# Generate specific APIs
+qraft redocly my-api@v1
+
+# Generate only OpenAPI from Redocly config
+qraft openapi --redocly
+
+# Generate only AsyncAPI from Redocly config
+qraft asyncapi --redocly
+```
+
+### Example Configuration
+
+```yaml
+# redocly.yaml
+apis:
+  main:
+    root: ./openapi.json
+    x-openapi-qraft:
+      plugin:
+        tanstack-query-react: true
+        openapi-typescript: true
+      output-dir: src/api
+      clean: true
+
+  events:
+    root: ./asyncapi.json
+    x-asyncapi-qraft:
+      plugin:
+        asyncapi-typescript: true
+      output-dir: src/events
+      clean: true
+```
+
+## Options
+
+All options from the underlying plugins are supported. Use `--help` to see available options for each command:
+
+```bash
+qraft openapi --help
+qraft asyncapi --help
+qraft redocly --help
+```

package/bin.mjs

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Workaround to allow `rimraf dist/` on rebuilds and keep `bin` executable
+ * without a need `yarn install`
+ */
+import { main } from './dist/bin.js';
+
+main(process.argv);

package/dist/bin.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import type { ParseOptions } from 'commander';
+export declare function main(processArgv: string[], processArgvParseOptions?: ParseOptions): Promise<void>;
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAa9C,wBAAsB,IAAI,CACxB,WAAW,EAAE,MAAM,EAAE,EACrB,uBAAuB,CAAC,EAAE,YAAY,iBAyFvC"}

package/dist/bin.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { ASYNCAPI_QRAFT_REDOC_CONFIG_KEY, OPENAPI_QRAFT_REDOC_CONFIG_KEY, } from '@qraft/plugin/lib/getRedocAPIsToQraft';
+import { createRedoclyOption, RedoclyConfigCommand, } from '@qraft/plugin/lib/RedoclyConfigCommand';
+import c from 'ansi-colors';
+import { Command } from 'commander';
+import { packageVersion } from './packageVersion.js';
+export async function main(processArgv, processArgvParseOptions) {
+    const program = new Command();
+    program
+        .name('qraft')
+        .description('Generate type-safe code from OpenAPI and AsyncAPI specifications')
+        // todo::maybe add "<bin> help <command>" handling
+        .helpCommand(false)
+        .version(packageVersion);
+    program
+        .command('openapi')
+        .description('Generate code from OpenAPI specification')
+        .allowUnknownOption()
+        .allowExcessArguments()
+        .action(async () => {
+        const subcommandArgv = extractSubcommandArgv(processArgv, 'openapi');
+        const { qraftOpenapi } = await import('./commands/openapi.js');
+        await qraftOpenapi(subcommandArgv, processArgvParseOptions);
+    })
+        .helpOption(false); // The command handles the help independently
+    program
+        .command('asyncapi')
+        .description('Generate code from AsyncAPI specification')
+        .allowUnknownOption()
+        .allowExcessArguments()
+        .action(async () => {
+        const subcommandArgv = extractSubcommandArgv(processArgv, 'asyncapi');
+        const { qraftAsyncapi } = await import('./commands/asyncapi.js');
+        await qraftAsyncapi(subcommandArgv, processArgvParseOptions);
+    })
+        .helpOption(false); // The command handles the help independently
+    program
+        .command('redocly')
+        .description('Generate from Redocly config (both OpenAPI and AsyncAPI)')
+        .argument('[apis...]', 'Selective API names from Redocly config to generate')
+        .addOption(createRedoclyOption())
+        .action(async (apis, options) => {
+        const redoclyArgv = buildRedoclyArgv(apis, options.redocly);
+        await new RedoclyConfigCommand().parseConfig({
+            [OPENAPI_QRAFT_REDOC_CONFIG_KEY]: async (argv, parseOptions) => {
+                const { runOpenAPI } = await import('./commands/runOpenAPI.js');
+                return runOpenAPI(argv, parseOptions);
+            },
+            [ASYNCAPI_QRAFT_REDOC_CONFIG_KEY]: async (argv, parseOptions) => {
+                const { runAsyncAPI } = await import('./commands/runAsyncAPI.js');
+                return runAsyncAPI(argv, parseOptions);
+            },
+        }, redoclyArgv, { from: 'user' });
+    });
+    program.addHelpText('after', `
+${c.bold('Examples:')}
+  ${c.dim('# Generate React Query hooks from OpenAPI')}
+  $ qraft openapi --plugin tanstack-query-react ./openapi.yaml -o ./src/api
+
+  ${c.dim('# Generate TypeScript types from OpenAPI')}
+  $ qraft openapi --plugin openapi-typescript ./openapi.yaml -o ./src/types
+
+  ${c.dim('# Generate TypeScript types from AsyncAPI')}
+  $ qraft asyncapi --plugin asyncapi-typescript ./asyncapi.yaml -o ./src/types
+
+  ${c.dim('# Generate from Redocly config (both OpenAPI and AsyncAPI)')}
+  $ qraft redocly
+
+  ${c.dim('# Generate specific APIs from Redocly config')}
+  $ qraft redocly openapi-main asyncapi-main
+
+  ${c.dim('# Generate from custom Redocly config path')}
+  $ qraft redocly --redocly ./custom-redocly.yaml
+`);
+    await program.parseAsync(processArgv, processArgvParseOptions);
+}
+function buildRedoclyArgv(apis, redoclyConfig) {
+    const argv = [...apis];
+    if (typeof redoclyConfig === 'string') {
+        argv.push('--redocly', redoclyConfig);
+    }
+    else if (redoclyConfig) {
+        argv.push('--redocly');
+    }
+    return argv;
+}
+function extractSubcommandArgv(processArgv, subcommand) {
+    const subcommandIndex = processArgv.indexOf(subcommand);
+    if (subcommandIndex === -1)
+        return processArgv;
+    return [
+        ...processArgv.slice(0, 2),
+        ...processArgv.slice(subcommandIndex + 1),
+    ];
+}
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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

package/dist/builtInPlugins.d.ts

@@ -0,0 +1,8 @@
+export declare const openApiBuiltInPlugins: {
+    readonly 'tanstack-query-react': () => Promise<typeof import("@openapi-qraft/tanstack-query-react-plugin")>;
+    readonly 'openapi-typescript': () => Promise<typeof import("@openapi-qraft/openapi-typescript-plugin")>;
+};
+export declare const asyncApiBuiltInPlugins: {
+    readonly 'asyncapi-typescript': () => Promise<typeof import("@qraft/asyncapi-typescript-plugin")>;
+};
+//# sourceMappingURL=builtInPlugins.d.ts.map

package/dist/builtInPlugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtInPlugins.d.ts","sourceRoot":"","sources":["../src/builtInPlugins.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB;;;CAKC,CAAC;AAEpC,eAAO,MAAM,sBAAsB;;CAEA,CAAC"}

package/dist/builtInPlugins.js

@@ -0,0 +1,8 @@
+export const openApiBuiltInPlugins = {
+    'tanstack-query-react': () => import('@openapi-qraft/tanstack-query-react-plugin'),
+    'openapi-typescript': () => import('@openapi-qraft/openapi-typescript-plugin'),
+};
+export const asyncApiBuiltInPlugins = {
+    'asyncapi-typescript': () => import('@qraft/asyncapi-typescript-plugin'),
+};
+//# sourceMappingURL=builtInPlugins.js.map

package/dist/builtInPlugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtInPlugins.js","sourceRoot":"","sources":["../src/builtInPlugins.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,sBAAsB,EAAE,GAAG,EAAE,CAC3B,MAAM,CAAC,4CAA4C,CAAC;IACtD,oBAAoB,EAAE,GAAG,EAAE,CACzB,MAAM,CAAC,0CAA0C,CAAC;CACnB,CAAC;AAEpC,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,qBAAqB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mCAAmC,CAAC;CACvC,CAAC"}

package/dist/commands/asyncapi.d.ts

@@ -0,0 +1,3 @@
+import type { ParseOptions } from 'commander';
+export declare function qraftAsyncapi(processArgv: string[], processArgvParseOptions?: ParseOptions): Promise<void>;
+//# sourceMappingURL=asyncapi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asyncapi.d.ts","sourceRoot":"","sources":["../../src/commands/asyncapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EAAE,EACrB,uBAAuB,CAAC,EAAE,YAAY,iBAcvC"}

package/dist/commands/asyncapi.js

@@ -0,0 +1,9 @@
+import { runAsyncAPI } from './runAsyncAPI.js';
+export async function qraftAsyncapi(processArgv, processArgvParseOptions) {
+    const { RedoclyConfigCommand, ASYNCAPI_QRAFT_REDOC_CONFIG_KEY } = await import('@qraft/plugin/lib/RedoclyConfigCommand');
+    const redoclyConfigParseResult = await new RedoclyConfigCommand().parseConfig({ [ASYNCAPI_QRAFT_REDOC_CONFIG_KEY]: runAsyncAPI }, processArgv, processArgvParseOptions);
+    if (redoclyConfigParseResult?.length)
+        return;
+    await runAsyncAPI(processArgv, processArgvParseOptions);
+}
+//# sourceMappingURL=asyncapi.js.map

package/dist/commands/asyncapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncapi.js","sourceRoot":"","sources":["../../src/commands/asyncapi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAqB,EACrB,uBAAsC;IAEtC,MAAM,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,GAC7D,MAAM,MAAM,CAAC,wCAAwC,CAAC,CAAC;IAEzD,MAAM,wBAAwB,GAAG,MAAM,IAAI,oBAAoB,EAAE,CAAC,WAAW,CAC3E,EAAE,CAAC,+BAA+B,CAAC,EAAE,WAAW,EAAE,EAClD,WAAW,EACX,uBAAuB,CACxB,CAAC;IAEF,IAAI,wBAAwB,EAAE,MAAM;QAAE,OAAO;IAE7C,MAAM,WAAW,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC;AAC1D,CAAC"}

package/dist/commands/openapi.d.ts

@@ -0,0 +1,3 @@
+import type { ParseOptions } from 'commander';
+export declare function qraftOpenapi(processArgv: string[], processArgvParseOptions?: ParseOptions): Promise<void>;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/commands/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/commands/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EAAE,EACrB,uBAAuB,CAAC,EAAE,YAAY,iBAcvC"}

package/dist/commands/openapi.js

@@ -0,0 +1,9 @@
+import { runOpenAPI } from './runOpenAPI.js';
+export async function qraftOpenapi(processArgv, processArgvParseOptions) {
+    const { RedoclyConfigCommand, OPENAPI_QRAFT_REDOC_CONFIG_KEY } = await import('@qraft/plugin/lib/RedoclyConfigCommand');
+    const redoclyConfigParseResult = await new RedoclyConfigCommand().parseConfig({ [OPENAPI_QRAFT_REDOC_CONFIG_KEY]: runOpenAPI }, processArgv, processArgvParseOptions);
+    if (redoclyConfigParseResult?.length)
+        return;
+    await runOpenAPI(processArgv, processArgvParseOptions);
+}
+//# sourceMappingURL=openapi.js.map

package/dist/commands/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../src/commands/openapi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAqB,EACrB,uBAAsC;IAEtC,MAAM,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,GAC5D,MAAM,MAAM,CAAC,wCAAwC,CAAC,CAAC;IAEzD,MAAM,wBAAwB,GAAG,MAAM,IAAI,oBAAoB,EAAE,CAAC,WAAW,CAC3E,EAAE,CAAC,8BAA8B,CAAC,EAAE,UAAU,EAAE,EAChD,WAAW,EACX,uBAAuB,CACxB,CAAC;IAEF,IAAI,wBAAwB,EAAE,MAAM;QAAE,OAAO;IAE7C,MAAM,UAAU,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC;AACzD,CAAC"}

package/dist/commands/runAsyncAPI.d.ts

@@ -0,0 +1,3 @@
+import { ParseOptions } from 'commander';
+export declare function runAsyncAPI(processArgv: string[], processArgvParseOptions?: ParseOptions): Promise<void>;
+//# sourceMappingURL=runAsyncAPI.d.ts.map

package/dist/commands/runAsyncAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runAsyncAPI.d.ts","sourceRoot":"","sources":["../../src/commands/runAsyncAPI.ts"],"names":[],"mappings":"AAOA,OAAO,EAAU,YAAY,EAAE,MAAM,WAAW,CAAC;AAGjD,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EAAE,EACrB,uBAAuB,CAAC,EAAE,YAAY,iBAuCvC"}

package/dist/commands/runAsyncAPI.js

@@ -0,0 +1,30 @@
+import { addCommandUsageWithPlugins, createFileHeader, extractArgvPluginOptions, hasHelpOption, setupPlugins, } from '@qraft/cli-utils';
+import { Option } from 'commander';
+import { asyncApiBuiltInPlugins } from '../builtInPlugins.js';
+export async function runAsyncAPI(processArgv, processArgvParseOptions) {
+    const { QraftCommand } = await import('@qraft/asyncapi-plugin');
+    const command = new QraftCommand('qraft asyncapi', {
+        defaultFileHeader: createFileHeader('@qraft/cli'),
+    });
+    const { argv, plugins } = extractArgvPluginOptions(processArgv);
+    if (plugins) {
+        await setupPlugins({
+            command,
+            plugins,
+            builtInPlugins: asyncApiBuiltInPlugins,
+            addUsage: addCommandUsageWithPlugins,
+        });
+    }
+    else {
+        command.addOption(new Option('--plugin <name_1> --plugin <name_2>', `Specifies which generator plugins should be used for code generation`)
+            .choices(Object.keys(asyncApiBuiltInPlugins))
+            .argParser(() => {
+            throw new Error('The plugin option must be processed before command parsing and should not be directly passed to the commander');
+        }));
+        if (!hasHelpOption(argv)) {
+            throw new Error(`Plugin must be explicitly specified for asyncapi command. Available plugins: ${Object.keys(asyncApiBuiltInPlugins).join(', ')}`);
+        }
+    }
+    await command.parseAsync(argv, processArgvParseOptions);
+}
+//# sourceMappingURL=runAsyncAPI.js.map

package/dist/commands/runAsyncAPI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runAsyncAPI.js","sourceRoot":"","sources":["../../src/commands/runAsyncAPI.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,wBAAwB,EACxB,aAAa,EACb,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAgB,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAqB,EACrB,uBAAsC;IAEtC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAEhE,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,gBAAgB,EAAE;QACjD,iBAAiB,EAAE,gBAAgB,CAAC,YAAY,CAAC;KAClD,CAAC,CAAC;IAEH,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,wBAAwB,CAAC,WAAW,CAAC,CAAC;IAEhE,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,YAAY,CAAC;YACjB,OAAO;YACP,OAAO;YACP,cAAc,EAAE,sBAAsB;YACtC,QAAQ,EAAE,0BAA0B;SACrC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,SAAS,CACf,IAAI,MAAM,CACR,qCAAqC,EACrC,sEAAsE,CACvE;aACE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;aAC5C,SAAS,CAAC,GAAG,EAAE;YACd,MAAM,IAAI,KAAK,CACb,+GAA+G,CAChH,CAAC;QACJ,CAAC,CAAC,CACL,CAAC;QAEF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,gFAAgF,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjI,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;AAC1D,CAAC"}

package/dist/commands/runOpenAPI.d.ts

@@ -0,0 +1,3 @@
+import { ParseOptions } from 'commander';
+export declare function runOpenAPI(processArgv: string[], processArgvParseOptions?: ParseOptions): Promise<void>;
+//# sourceMappingURL=runOpenAPI.d.ts.map

package/dist/commands/runOpenAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runOpenAPI.d.ts","sourceRoot":"","sources":["../../src/commands/runOpenAPI.ts"],"names":[],"mappings":"AAOA,OAAO,EAAU,YAAY,EAAE,MAAM,WAAW,CAAC;AAGjD,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EAAE,EACrB,uBAAuB,CAAC,EAAE,YAAY,iBAuCvC"}

package/dist/commands/runOpenAPI.js

@@ -0,0 +1,30 @@
+import { addCommandUsageWithPlugins, createFileHeader, extractArgvPluginOptions, hasHelpOption, setupPlugins, } from '@qraft/cli-utils';
+import { Option } from 'commander';
+import { openApiBuiltInPlugins } from '../builtInPlugins.js';
+export async function runOpenAPI(processArgv, processArgvParseOptions) {
+    const { QraftCommand } = await import('@openapi-qraft/plugin');
+    const command = new QraftCommand('qraft openapi', {
+        defaultFileHeader: createFileHeader('@qraft/cli'),
+    });
+    const { argv, plugins } = extractArgvPluginOptions(processArgv);
+    if (plugins) {
+        await setupPlugins({
+            command,
+            plugins,
+            builtInPlugins: openApiBuiltInPlugins,
+            addUsage: addCommandUsageWithPlugins,
+        });
+    }
+    else {
+        command.addOption(new Option('--plugin <name_1> --plugin <name_2>', `Specifies which generator plugins should be used for code generation`)
+            .choices(Object.keys(openApiBuiltInPlugins))
+            .argParser(() => {
+            throw new Error('The plugin option must be processed before command parsing and should not be directly passed to the commander');
+        }));
+        if (!hasHelpOption(argv)) {
+            throw new Error(`Plugin must be explicitly specified for openapi command. Available plugins: ${Object.keys(openApiBuiltInPlugins).join(', ')}`);
+        }
+    }
+    await command.parseAsync(argv, processArgvParseOptions);
+}
+//# sourceMappingURL=runOpenAPI.js.map

package/dist/commands/runOpenAPI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runOpenAPI.js","sourceRoot":"","sources":["../../src/commands/runOpenAPI.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,wBAAwB,EACxB,aAAa,EACb,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAgB,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAqB,EACrB,uBAAsC;IAEtC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAE/D,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,eAAe,EAAE;QAChD,iBAAiB,EAAE,gBAAgB,CAAC,YAAY,CAAC;KAClD,CAAC,CAAC;IAEH,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,wBAAwB,CAAC,WAAW,CAAC,CAAC;IAEhE,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,YAAY,CAAC;YACjB,OAAO;YACP,OAAO;YACP,cAAc,EAAE,qBAAqB;YACrC,QAAQ,EAAE,0BAA0B;SACrC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,SAAS,CACf,IAAI,MAAM,CACR,qCAAqC,EACrC,sEAAsE,CACvE;aACE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;aAC3C,SAAS,CAAC,GAAG,EAAE;YACd,MAAM,IAAI,KAAK,CACb,+GAA+G,CAChH,CAAC;QACJ,CAAC,CAAC,CACL,CAAC;QAEF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,+EAA+E,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/H,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;AAC1D,CAAC"}

package/dist/packageVersion.d.ts

@@ -0,0 +1,2 @@
+export declare const packageVersion = "1.0.0-beta.0";
+//# sourceMappingURL=packageVersion.d.ts.map

package/dist/packageVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageVersion.d.ts","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,cAAc,iBAAiB,CAAC"}

package/dist/packageVersion.js

@@ -0,0 +1,3 @@
+// This file was generated automatically
+export const packageVersion = '1.0.0-beta.0';
+//# sourceMappingURL=packageVersion.js.map

package/dist/packageVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC"}

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "@qraft/cli",
+  "version": "1.0.0-beta.0",
+  "description": "CLI tool for generating type-safe code from OpenAPI and AsyncAPI specifications",
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "dev": "yarn build --watch --noEmitOnError false",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint",
+    "clean": "rimraf dist/",
+    "write-package-version-file": "yarn exec ../../write-package-version-file.sh"
+  },
+  "type": "module",
+  "bin": {
+    "qraft": "./bin.mjs"
+  },
+  "peerDependencies": {
+    "@openapi-qraft/openapi-typescript-plugin": "2.15.0-beta.1",
+    "@openapi-qraft/plugin": "2.15.0-beta.1",
+    "@openapi-qraft/tanstack-query-react-plugin": "2.15.0-beta.1",
+    "@qraft/asyncapi-plugin": "1.0.0-beta.0",
+    "@qraft/asyncapi-typescript-plugin": "1.0.0-beta.0"
+  },
+  "peerDependenciesMeta": {
+    "@openapi-qraft/openapi-typescript-plugin": {
+      "optional": true
+    },
+    "@openapi-qraft/plugin": {
+      "optional": true
+    },
+    "@openapi-qraft/tanstack-query-react-plugin": {
+      "optional": true
+    },
+    "@qraft/asyncapi-plugin": {
+      "optional": true
+    },
+    "@qraft/asyncapi-typescript-plugin": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@qraft/cli-utils": "1.0.0-beta.0",
+    "@qraft/plugin": "1.0.0-beta.0",
+    "ansi-colors": "^4.1.3",
+    "commander": "^14.0.2"
+  },
+  "devDependencies": {
+    "@openapi-qraft/eslint-config": "1.0.1",
+    "@openapi-qraft/openapi-typescript-plugin": "2.15.0-beta.1",
+    "@openapi-qraft/plugin": "2.15.0-beta.1",
+    "@openapi-qraft/tanstack-query-react-plugin": "2.15.0-beta.1",
+    "@qraft/asyncapi-plugin": "1.0.0-beta.0",
+    "@qraft/asyncapi-typescript-plugin": "1.0.0-beta.0",
+    "@types/node": "^20.16.5",
+    "eslint": "^9.39.1",
+    "rimraf": "^6.1.2",
+    "typescript": "^5.6.2",
+    "vitest": "^3.2.4"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!dist/**/*.test.*",
+    "!dist/**/*.spec.*",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*"
+  ],
+  "module": "dist/bin.js",
+  "types": "dist/bin.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "dist/*"
+      ]
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OpenAPI-Qraft/openapi-qraft.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/OpenAPI-Qraft/openapi-qraft/issues"
+  },
+  "homepage": "https://openapi-qraft.github.io/openapi-qraft/",
+  "keywords": [
+    "openapi",
+    "swagger",
+    "rest",
+    "api",
+    "oapi_3",
+    "oapi_3_1",
+    "typescript",
+    "ts",
+    "dts",
+    "codegen",
+    "generation",
+    "fetch",
+    "react",
+    "hooks",
+    "TanStack Query"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/bin.ts

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+import type { ParseOptions } from 'commander';
+import {
+  ASYNCAPI_QRAFT_REDOC_CONFIG_KEY,
+  OPENAPI_QRAFT_REDOC_CONFIG_KEY,
+} from '@qraft/plugin/lib/getRedocAPIsToQraft';
+import {
+  createRedoclyOption,
+  RedoclyConfigCommand,
+} from '@qraft/plugin/lib/RedoclyConfigCommand';
+import c from 'ansi-colors';
+import { Command } from 'commander';
+import { packageVersion } from './packageVersion.js';
+
+export async function main(
+  processArgv: string[],
+  processArgvParseOptions?: ParseOptions
+) {
+  const program = new Command();
+
+  program
+    .name('qraft')
+    .description(
+      'Generate type-safe code from OpenAPI and AsyncAPI specifications'
+    )
+    // todo::maybe add "<bin> help <command>" handling
+    .helpCommand(false)
+    .version(packageVersion);
+
+  program
+    .command('openapi')
+    .description('Generate code from OpenAPI specification')
+    .allowUnknownOption()
+    .allowExcessArguments()
+    .action(async () => {
+      const subcommandArgv = extractSubcommandArgv(processArgv, 'openapi');
+      const { qraftOpenapi } = await import('./commands/openapi.js');
+      await qraftOpenapi(subcommandArgv, processArgvParseOptions);
+    })
+    .helpOption(false); // The command handles the help independently
+
+  program
+    .command('asyncapi')
+    .description('Generate code from AsyncAPI specification')
+    .allowUnknownOption()
+    .allowExcessArguments()
+    .action(async () => {
+      const subcommandArgv = extractSubcommandArgv(processArgv, 'asyncapi');
+      const { qraftAsyncapi } = await import('./commands/asyncapi.js');
+      await qraftAsyncapi(subcommandArgv, processArgvParseOptions);
+    })
+    .helpOption(false); // The command handles the help independently
+
+  program
+    .command('redocly')
+    .description('Generate from Redocly config (both OpenAPI and AsyncAPI)')
+    .argument(
+      '[apis...]',
+      'Selective API names from Redocly config to generate'
+    )
+    .addOption(createRedoclyOption())
+    .action(async (apis: string[], options: { redocly: string | boolean }) => {
+      const redoclyArgv = buildRedoclyArgv(apis, options.redocly);
+
+      await new RedoclyConfigCommand().parseConfig(
+        {
+          [OPENAPI_QRAFT_REDOC_CONFIG_KEY]: async (argv, parseOptions) => {
+            const { runOpenAPI } = await import('./commands/runOpenAPI.js');
+            return runOpenAPI(argv, parseOptions);
+          },
+          [ASYNCAPI_QRAFT_REDOC_CONFIG_KEY]: async (argv, parseOptions) => {
+            const { runAsyncAPI } = await import('./commands/runAsyncAPI.js');
+            return runAsyncAPI(argv, parseOptions);
+          },
+        },
+        redoclyArgv,
+        { from: 'user' }
+      );
+    });
+
+  program.addHelpText(
+    'after',
+    `
+${c.bold('Examples:')}
+  ${c.dim('# Generate React Query hooks from OpenAPI')}
+  $ qraft openapi --plugin tanstack-query-react ./openapi.yaml -o ./src/api
+
+  ${c.dim('# Generate TypeScript types from OpenAPI')}
+  $ qraft openapi --plugin openapi-typescript ./openapi.yaml -o ./src/types
+
+  ${c.dim('# Generate TypeScript types from AsyncAPI')}
+  $ qraft asyncapi --plugin asyncapi-typescript ./asyncapi.yaml -o ./src/types
+
+  ${c.dim('# Generate from Redocly config (both OpenAPI and AsyncAPI)')}
+  $ qraft redocly
+
+  ${c.dim('# Generate specific APIs from Redocly config')}
+  $ qraft redocly openapi-main asyncapi-main
+
+  ${c.dim('# Generate from custom Redocly config path')}
+  $ qraft redocly --redocly ./custom-redocly.yaml
+`
+  );
+
+  await program.parseAsync(processArgv, processArgvParseOptions);
+}
+
+function buildRedoclyArgv(
+  apis: string[],
+  redoclyConfig: string | boolean
+): string[] {
+  const argv: string[] = [...apis];
+
+  if (typeof redoclyConfig === 'string') {
+    argv.push('--redocly', redoclyConfig);
+  } else if (redoclyConfig) {
+    argv.push('--redocly');
+  }
+
+  return argv;
+}
+
+function extractSubcommandArgv(
+  processArgv: string[],
+  subcommand: string
+): string[] {
+  const subcommandIndex = processArgv.indexOf(subcommand);
+  if (subcommandIndex === -1) return processArgv;
+
+  return [
+    ...processArgv.slice(0, 2),
+    ...processArgv.slice(subcommandIndex + 1),
+  ];
+}

package/src/builtInPlugins.ts

@@ -0,0 +1,12 @@
+import type { BuiltInPlugins } from '@qraft/cli-utils';
+
+export const openApiBuiltInPlugins = {
+  'tanstack-query-react': () =>
+    import('@openapi-qraft/tanstack-query-react-plugin'),
+  'openapi-typescript': () =>
+    import('@openapi-qraft/openapi-typescript-plugin'),
+} as const satisfies BuiltInPlugins;
+
+export const asyncApiBuiltInPlugins = {
+  'asyncapi-typescript': () => import('@qraft/asyncapi-typescript-plugin'),
+} as const satisfies BuiltInPlugins;

package/src/commands/asyncapi.ts

@@ -0,0 +1,20 @@
+import type { ParseOptions } from 'commander';
+import { runAsyncAPI } from './runAsyncAPI.js';
+
+export async function qraftAsyncapi(
+  processArgv: string[],
+  processArgvParseOptions?: ParseOptions
+) {
+  const { RedoclyConfigCommand, ASYNCAPI_QRAFT_REDOC_CONFIG_KEY } =
+    await import('@qraft/plugin/lib/RedoclyConfigCommand');
+
+  const redoclyConfigParseResult = await new RedoclyConfigCommand().parseConfig(
+    { [ASYNCAPI_QRAFT_REDOC_CONFIG_KEY]: runAsyncAPI },
+    processArgv,
+    processArgvParseOptions
+  );
+
+  if (redoclyConfigParseResult?.length) return;
+
+  await runAsyncAPI(processArgv, processArgvParseOptions);
+}

package/src/commands/openapi.ts

@@ -0,0 +1,20 @@
+import type { ParseOptions } from 'commander';
+import { runOpenAPI } from './runOpenAPI.js';
+
+export async function qraftOpenapi(
+  processArgv: string[],
+  processArgvParseOptions?: ParseOptions
+) {
+  const { RedoclyConfigCommand, OPENAPI_QRAFT_REDOC_CONFIG_KEY } =
+    await import('@qraft/plugin/lib/RedoclyConfigCommand');
+
+  const redoclyConfigParseResult = await new RedoclyConfigCommand().parseConfig(
+    { [OPENAPI_QRAFT_REDOC_CONFIG_KEY]: runOpenAPI },
+    processArgv,
+    processArgvParseOptions
+  );
+
+  if (redoclyConfigParseResult?.length) return;
+
+  await runOpenAPI(processArgv, processArgvParseOptions);
+}

package/src/commands/runAsyncAPI.ts

@@ -0,0 +1,52 @@
+import {
+  addCommandUsageWithPlugins,
+  createFileHeader,
+  extractArgvPluginOptions,
+  hasHelpOption,
+  setupPlugins,
+} from '@qraft/cli-utils';
+import { Option, ParseOptions } from 'commander';
+import { asyncApiBuiltInPlugins } from '../builtInPlugins.js';
+
+export async function runAsyncAPI(
+  processArgv: string[],
+  processArgvParseOptions?: ParseOptions
+) {
+  const { QraftCommand } = await import('@qraft/asyncapi-plugin');
+
+  const command = new QraftCommand('qraft asyncapi', {
+    defaultFileHeader: createFileHeader('@qraft/cli'),
+  });
+
+  const { argv, plugins } = extractArgvPluginOptions(processArgv);
+
+  if (plugins) {
+    await setupPlugins({
+      command,
+      plugins,
+      builtInPlugins: asyncApiBuiltInPlugins,
+      addUsage: addCommandUsageWithPlugins,
+    });
+  } else {
+    command.addOption(
+      new Option(
+        '--plugin <name_1> --plugin <name_2>',
+        `Specifies which generator plugins should be used for code generation`
+      )
+        .choices(Object.keys(asyncApiBuiltInPlugins))
+        .argParser(() => {
+          throw new Error(
+            'The plugin option must be processed before command parsing and should not be directly passed to the commander'
+          );
+        })
+    );
+
+    if (!hasHelpOption(argv)) {
+      throw new Error(
+        `Plugin must be explicitly specified for asyncapi command. Available plugins: ${Object.keys(asyncApiBuiltInPlugins).join(', ')}`
+      );
+    }
+  }
+
+  await command.parseAsync(argv, processArgvParseOptions);
+}

package/src/commands/runOpenAPI.ts

@@ -0,0 +1,52 @@
+import {
+  addCommandUsageWithPlugins,
+  createFileHeader,
+  extractArgvPluginOptions,
+  hasHelpOption,
+  setupPlugins,
+} from '@qraft/cli-utils';
+import { Option, ParseOptions } from 'commander';
+import { openApiBuiltInPlugins } from '../builtInPlugins.js';
+
+export async function runOpenAPI(
+  processArgv: string[],
+  processArgvParseOptions?: ParseOptions
+) {
+  const { QraftCommand } = await import('@openapi-qraft/plugin');
+
+  const command = new QraftCommand('qraft openapi', {
+    defaultFileHeader: createFileHeader('@qraft/cli'),
+  });
+
+  const { argv, plugins } = extractArgvPluginOptions(processArgv);
+
+  if (plugins) {
+    await setupPlugins({
+      command,
+      plugins,
+      builtInPlugins: openApiBuiltInPlugins,
+      addUsage: addCommandUsageWithPlugins,
+    });
+  } else {
+    command.addOption(
+      new Option(
+        '--plugin <name_1> --plugin <name_2>',
+        `Specifies which generator plugins should be used for code generation`
+      )
+        .choices(Object.keys(openApiBuiltInPlugins))
+        .argParser(() => {
+          throw new Error(
+            'The plugin option must be processed before command parsing and should not be directly passed to the commander'
+          );
+        })
+    );
+
+    if (!hasHelpOption(argv)) {
+      throw new Error(
+        `Plugin must be explicitly specified for openapi command. Available plugins: ${Object.keys(openApiBuiltInPlugins).join(', ')}`
+      );
+    }
+  }
+
+  await command.parseAsync(argv, processArgvParseOptions);
+}

package/src/packageVersion.ts

@@ -0,0 +1,2 @@
+// This file was generated automatically
+export const packageVersion = '1.0.0-beta.0';