@bymbly/api-tools 1.0.0

package/dist/lib/redocly/lint.js

@@ -0,0 +1,80 @@
+import { Command, Option, } from "@commander-js/extra-typings";
+import { runBatchInputCommand, } from "../cli/helpers.js";
+import { isQuiet, resolveDocuments, resolveStdio, } from "../cli/runtime.js";
+import { resolveConfig, run } from "./cli.js";
+const VALID_OUTPUT_FORMATS = [
+    "codeframe",
+    "stylish",
+    "json",
+    "checkstyle",
+    "codeclimate",
+    "github-actions",
+    "markdown",
+    "summary",
+];
+export const lintCommand = new Command("lint")
+    .description("Validate and lint OpenAPI, AsyncAPI, Arazzo documents using Redocly")
+    .argument("[input]", "Document path (default: auto-detect)")
+    .option("--openapi", "Lint OpenAPI document at openapi/openapi.yaml", false)
+    .option("--asyncapi", "Lint AsyncAPI document at asyncapi/asyncapi.yaml", false)
+    .option("--arazzo", "Lint Arazzo document at arazzo/arazzo.yaml", false)
+    .addOption(new Option("--format <format>", "Output format")
+    .choices([...VALID_OUTPUT_FORMATS])
+    .default("codeframe"))
+    .option("--config <file>", "Config file path (overrides auto/bundled)")
+    .allowExcessArguments(true)
+    .action(runLint);
+function runLint(input, options, cmd) {
+    runBatchInputCommand({
+        input,
+        options,
+        cmd,
+        resolveDocuments: resolveDocuments,
+        execute: lint,
+    });
+}
+export function lint(params) {
+    const { input, options, globals } = params;
+    const config = resolveConfig(options.config);
+    // prevent using --generate-ignore-file with bundled config
+    // since redocly writes the generated ignore file to the config's directory
+    // and this would be difficult for users to find/manage
+    if (config.source === "bundled" &&
+        params.passthrough.some((arg) => arg.includes("--generate-ignore-file"))) {
+        console.error(`
+❌ Error: Cannot use --generate-ignore-file with bundled config
+
+The --generate-ignore-file option requires a local Redocly configuration file, but no local config was found.
+
+To generate a starter config, run:
+
+    api-tools redocly init
+
+Then re-run this command.
+`.trim());
+        return 1;
+    }
+    const args = buildArgs(params, config);
+    const stdio = resolveStdio(globals);
+    const quiet = isQuiet(globals);
+    if (!quiet) {
+        console.log("🔍 Redocly lint...");
+        console.log(`   Input: ${input}`);
+        console.log(`   Format: ${options.format}`);
+        console.log(`   Config: ${config.path ?? "auto"} (${config.source})`);
+    }
+    return run(args, stdio);
+}
+function buildArgs(params, config) {
+    const { input, options, passthrough } = params;
+    const args = ["lint", input, "--format", options.format];
+    // only pass --config if we resolved an explicit path (cli or bundled)
+    if (config.path)
+        args.push("--config", config.path);
+    // forward any passthrough args to redocly
+    if (passthrough.length > 0) {
+        args.push(...passthrough);
+    }
+    return args;
+}
+//# sourceMappingURL=lint.js.map

package/dist/lib/redocly/lint.js.map

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

package/dist/lib/redocly/respect.js

@@ -0,0 +1,84 @@
+import { Command, Option, } from "@commander-js/extra-typings";
+import { runSingleInputCommand, } from "../cli/helpers.js";
+import { isQuiet, resolveStdio } from "../cli/runtime.js";
+import { run } from "./cli.js";
+export const respectCommand = new Command("respect")
+    .description("Execute Arazzo workflow tests using Redocly")
+    .argument("[input]", "Arazzo document path (default: arazzo/arazzo.yaml)")
+    .addOption(new Option("--workflow <names...>", "Run only specified workflows").conflicts("skip"))
+    .addOption(new Option("--skip <names...>", "Skip specified workflows").conflicts("workflow"))
+    .option("--verbose", "Enable verbose output", false)
+    .option("--input <params...>", "Workflow input parameters (key=value or JSON)")
+    .option("--server <overrides...>", "Server overrides (format: name=url)")
+    .option("--json-output <file>", "Save results to JSON file")
+    .option("--har-output <file>", "Save HTTP interactions to HAR file")
+    .allowExcessArguments(true)
+    .action(runRespect);
+function runRespect(input, options, cmd) {
+    runSingleInputCommand({
+        input,
+        options,
+        cmd,
+        defaultInput: "arazzo/arazzo.yaml",
+        execute: respect,
+    });
+}
+export function respect(params) {
+    const { input, options, globals } = params;
+    const args = buildArgs(params);
+    const stdio = resolveStdio(globals);
+    const quiet = isQuiet(globals);
+    if (!quiet) {
+        console.log(`🧪 Redocly respect...`);
+        console.log(`   Input: ${input}`);
+        if (options.workflow && options.workflow.length > 0) {
+            console.log(`   Workflows: ${options.workflow.join(", ")}`);
+        }
+        if (options.skip && options.skip.length > 0) {
+            console.log(`   Skipped Workflows: ${options.skip.join(", ")}`);
+        }
+        if (options.server && options.server.length > 0) {
+            console.log(`   Server Overrides: ${options.server.join(", ")}`);
+        }
+        if (options.jsonOutput) {
+            console.log(`   JSON Output: ${options.jsonOutput}`);
+        }
+        if (options.harOutput) {
+            console.log(`   HAR Output: ${options.harOutput}`);
+        }
+    }
+    return run(args, stdio);
+}
+function buildArgs(params) {
+    const { input, options, passthrough } = params;
+    const args = ["respect", input];
+    if (options.workflow && options.workflow.length > 0) {
+        args.push("--workflow", ...options.workflow);
+    }
+    if (options.skip && options.skip.length > 0) {
+        args.push("--skip", ...options.skip);
+    }
+    if (options.verbose) {
+        args.push("--verbose");
+    }
+    if (options.input && options.input.length > 0) {
+        options.input.forEach((param) => {
+            args.push("--input", param);
+        });
+    }
+    if (options.server && options.server.length > 0) {
+        args.push("--server", ...options.server);
+    }
+    if (options.jsonOutput) {
+        args.push("--json-output", options.jsonOutput);
+    }
+    if (options.harOutput) {
+        args.push("--har-output", options.harOutput);
+    }
+    // forward any passthrough args to redocly
+    if (passthrough.length > 0) {
+        args.push(...passthrough);
+    }
+    return args;
+}
+//# sourceMappingURL=respect.js.map

package/dist/lib/redocly/respect.js.map

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

package/dist/lib/spectral/cli.js

@@ -0,0 +1,16 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveConfigRuntime, runCli, } from "../cli/runtime.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export const BIN_PATH = "@stoplight/spectral-cli/dist/index.js";
+// https://github.com/stoplightio/spectral/blob/develop/packages/core/src/ruleset/ruleset.ts#L24
+const CONFIG_REGEX = /^\.?spectral\.(ya?ml|json|m?js)$/;
+const DEFAULT_CONFIG_PATH = path.join(__dirname, "../../defaults/spectral.yaml");
+export function resolveConfig(cliConfig) {
+    return resolveConfigRuntime(cliConfig, CONFIG_REGEX, DEFAULT_CONFIG_PATH);
+}
+export function run(args, stdio) {
+    return runCli(BIN_PATH, args, stdio);
+}
+//# sourceMappingURL=cli.js.map

package/dist/lib/spectral/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/lib/spectral/cli.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,oBAAoB,EAEpB,MAAM,GAEP,MAAM,mBAAmB,CAAC;AAE3B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,QAAQ,GAAG,uCAAuC,CAAC;AAEhE,gGAAgG;AAChG,MAAM,YAAY,GAAG,kCAAkC,CAAC;AAExD,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CACnC,SAAS,EACT,8BAA8B,CAC/B,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,SAA6B;IACzD,OAAO,oBAAoB,CAAC,SAAS,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAc,EAAE,KAAgB;IAClD,OAAO,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/lib/spectral/command.js

@@ -0,0 +1,17 @@
+import { Command } from "@commander-js/extra-typings";
+import { createInitCommand, handleRawPassthrough } from "../cli/helpers.js";
+import { run } from "./cli.js";
+import { lintCommand } from "./lint.js";
+export const spectralCommand = new Command("spectral")
+    .description("Spectral-related commands")
+    .allowExcessArguments(true)
+    .configureHelp({
+    sortSubcommands: true,
+    sortOptions: true,
+})
+    .action((opts, cmd) => {
+    handleRawPassthrough(opts, cmd, run);
+})
+    .addCommand(createInitCommand("spectral.yaml"))
+    .addCommand(lintCommand);
+//# sourceMappingURL=command.js.map

package/dist/lib/spectral/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/lib/spectral/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;KACnD,WAAW,CAAC,2BAA2B,CAAC;KACxC,oBAAoB,CAAC,IAAI,CAAC;KAC1B,aAAa,CAAC;IACb,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE,IAAI;CAClB,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;IACpB,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC,CAAC;KACD,UAAU,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;KAC9C,UAAU,CAAC,WAAW,CAAC,CAAC"}

package/dist/lib/spectral/lint.js

@@ -0,0 +1,91 @@
+import { Command, Option, } from "@commander-js/extra-typings";
+import { runBatchInputCommand, } from "../cli/helpers.js";
+import { isQuiet, resolveDocuments, resolveStdio, } from "../cli/runtime.js";
+import { resolveConfig, run } from "./cli.js";
+export const VALID_OUTPUT_FORMATS = [
+    "json",
+    "stylish",
+    "junit",
+    "html",
+    "text",
+    "teamcity",
+    "pretty",
+    "github-actions",
+    "sarif",
+    "markdown",
+    "gitlab",
+];
+const VALID_FAIL_SEVERITIES = ["error", "warn", "info", "hint"];
+export const lintCommand = new Command("lint")
+    .description("Validate and lint OpenAPI, AsyncAPI, and Arazzo Documents using Spectral")
+    .argument("[input]", "Document path (default: auto-detect)")
+    .option("--openapi", "Lint OpenAPI document at openapi/openapi.yaml", false)
+    .option("--asyncapi", "Lint AsyncAPI document at asyncapi/asyncapi.yaml", false)
+    .option("--arazzo", "Lint Arazzo document at arazzo/arazzo.yaml", false)
+    .addOption(new Option("--format <format>", "Output format")
+    .choices([...VALID_OUTPUT_FORMATS])
+    .default("stylish"))
+    .option("--output <file>", "Write output to a file")
+    .option("--ruleset <file>", "Ruleset file path (overrides auto/bundled)")
+    .addOption(new Option("--fail-severity <level>", "Fail severity threshold")
+    .choices([...VALID_FAIL_SEVERITIES])
+    .default("warn"))
+    .option("--display-only-failures", "Display only failing results", false)
+    .option("--verbose", "Enable verbose output", false)
+    .allowExcessArguments(true)
+    .action(runLint);
+function runLint(input, options, cmd) {
+    runBatchInputCommand({
+        input,
+        options,
+        cmd,
+        resolveDocuments: resolveDocuments,
+        execute: lint,
+    });
+}
+export function lint(params) {
+    const { input, options, globals } = params;
+    const ruleset = resolveConfig(options.ruleset);
+    const args = buildArgs(params, ruleset);
+    const stdio = resolveStdio(globals);
+    const quiet = isQuiet(globals);
+    if (!quiet) {
+        console.log(`🔍 Spectral lint...`);
+        console.log(`   Input: ${input}`);
+        console.log(`   Format: ${options.format}`);
+        console.log(`   Ruleset: ${ruleset.path ?? "auto"} (${ruleset.source})`);
+        if (options.output) {
+            console.log(`   Output: ${options.output}`);
+        }
+        console.log(`   Fail Severity: ${options.failSeverity}`);
+        console.log(`   Display Only Failures: ${String(options.displayOnlyFailures)}`);
+        console.log(`   Verbose: ${String(options.verbose)}`);
+    }
+    return run(args, stdio);
+}
+function buildArgs(params, ruleset) {
+    const { input, options, passthrough } = params;
+    const args = [
+        "lint",
+        input,
+        "--format",
+        options.format,
+        "--fail-severity",
+        options.failSeverity,
+    ];
+    // only pass --ruleset if we resolved an explicit path (cli or bundled)
+    if (ruleset.path)
+        args.push("--ruleset", ruleset.path);
+    if (options.output)
+        args.push("--output", options.output);
+    if (options.displayOnlyFailures)
+        args.push("--display-only-failures");
+    if (options.verbose)
+        args.push("--verbose");
+    // forward any passthrough args to spectral
+    if (passthrough.length > 0) {
+        args.push(...passthrough);
+    }
+    return args;
+}
+//# sourceMappingURL=lint.js.map

package/dist/lib/spectral/lint.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@bymbly/api-tools",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "Unified, opinionated CLI wrapper for API specification tooling.",
+  "license": "Apache-2.0",
+  "keywords": [
+    "openapi",
+    "asyncapi",
+    "arazzo",
+    "redocly",
+    "spectral",
+    "cli",
+    "tools",
+    "api"
+  ],
+  "files": [
+    "dist/**/*"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bymbly/api-tools.git"
+  },
+  "bin": {
+    "api-tools": "dist/bin/api-tools.js"
+  },
+  "scripts": {
+    "dev": "npm run watch",
+    "build": "tsc -p tsconfig.build.json && npm run copy:defaults",
+    "test": "vitest run",
+    "build:clean": "npm run clean && npm run build",
+    "pretest": "npm run build",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build:clean",
+    "watch": "npm run copy:defaults && tsc --watch",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "typecheck": "tsc",
+    "lint": "npm run lint:md && npm run lint:eslint",
+    "lint:check": "npm run lint:md:check && npm run lint:eslint:check",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint:md": "markdownlint-cli2 --fix",
+    "lint:md:check": "markdownlint-cli2",
+    "lint:eslint": "eslint . --fix",
+    "lint:eslint:check": "eslint .",
+    "clean": "npm run clean:dist",
+    "clean:dist": "rm -rf ./dist",
+    "copy:defaults": "copyfiles --all defaults/* dist/"
+  },
+  "dependencies": {
+    "@commander-js/extra-typings": "^14.0.0",
+    "@redocly/cli": "^2.14.4",
+    "@stoplight/spectral-cli": "^6.15.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^24.10.7",
+    "@vitest/ui": "^4.0.15",
+    "copyfiles": "^2.4.1",
+    "eslint": "^9.39.2",
+    "markdownlint-cli2": "0.20.0",
+    "prettier": "3.8.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.52.0",
+    "vitest": "^4.0.15"
+  }
+}