@ir-kit/k6-toolkit 0.1.0

package/dist/spawn-k6.d.ts

@@ -0,0 +1,30 @@
+import { type StdioOptions } from "node:child_process";
+export interface K6FlagArgs {
+    baseUrl?: string;
+    vus?: string;
+    duration?: string;
+    /** k6 `--out` sinks. Each entry is a separate `--out` flag. */
+    out?: ReadonlyArray<string>;
+    /** k6 `--summary-export=<path>`. */
+    summary?: string;
+    /** Extra args appended verbatim after the synthesized flags. */
+    extraArgs?: ReadonlyArray<string>;
+}
+/** Build the `k6 run …` argv for one bundle. */
+export declare function buildK6Args(outfile: string, args?: K6FlagArgs): string[];
+export interface SpawnK6Opts {
+    /** Where to inherit/pipe k6's stdio. Default: "inherit". */
+    stdio?: StdioOptions;
+    /** Path/name of the k6 binary. Default: "k6". */
+    binary?: string;
+    /** Working directory. */
+    cwd?: string;
+}
+/**
+ * Spawn k6 with the given argv. Resolves to the exit code; for
+ * signal-terminated processes returns `128 + signum` per POSIX so
+ * callers can fail-fast on Ctrl-C / SIGKILL without manual signal
+ * decoding.
+ */
+export declare function spawnK6(k6Args: ReadonlyArray<string>, opts?: SpawnK6Opts): Promise<number>;
+//# sourceMappingURL=spawn-k6.d.ts.map

package/dist/spawn-k6.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-k6.d.ts","sourceRoot":"","sources":["../src/spawn-k6.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAG9D,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,MAAM,EAAE,CAU5E;AAED,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAC7B,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/spawn-k6.js

@@ -0,0 +1,46 @@
+import { spawn } from "node:child_process";
+import { constants as osConstants } from "node:os";
+/** Build the `k6 run …` argv for one bundle. */
+export function buildK6Args(outfile, args = {}) {
+    const out = ["run"];
+    if (args.baseUrl)
+        out.push("-e", `BASE_URL=${args.baseUrl}`);
+    if (args.vus)
+        out.push("--vus", args.vus);
+    if (args.duration)
+        out.push("--duration", args.duration);
+    for (const sink of args.out ?? [])
+        out.push("--out", sink);
+    if (args.summary)
+        out.push(`--summary-export=${args.summary}`);
+    out.push(...(args.extraArgs ?? []));
+    out.push(outfile);
+    return out;
+}
+/**
+ * Spawn k6 with the given argv. Resolves to the exit code; for
+ * signal-terminated processes returns `128 + signum` per POSIX so
+ * callers can fail-fast on Ctrl-C / SIGKILL without manual signal
+ * decoding.
+ */
+export function spawnK6(k6Args, opts = {}) {
+    const child = spawn(opts.binary ?? "k6", [...k6Args], {
+        stdio: opts.stdio ?? "inherit",
+        cwd: opts.cwd,
+    });
+    return new Promise((resolve, reject) => {
+        child.on("exit", (code, signal) => {
+            if (code !== null)
+                return resolve(code);
+            if (signal)
+                return resolve(128 + (signalNumber(signal) ?? 1));
+            resolve(1);
+        });
+        child.on("error", reject);
+    });
+}
+/** Look up the platform-correct signum from Node's os.constants. */
+function signalNumber(signal) {
+    return osConstants.signals[signal];
+}
+//# sourceMappingURL=spawn-k6.js.map

package/dist/spawn-k6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-k6.js","sourceRoot":"","sources":["../src/spawn-k6.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AAcnD,gDAAgD;AAChD,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,OAAmB,EAAE;IAChE,MAAM,GAAG,GAAa,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,IAAI,CAAC,OAAO;QAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7D,IAAI,IAAI,CAAC,GAAG;QAAE,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,IAAI,CAAC,QAAQ;QAAE,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,GAAG,IAAI,EAAE;QAAE,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3D,IAAI,IAAI,CAAC,OAAO;QAAE,GAAG,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/D,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;IACpC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClB,OAAO,GAAG,CAAC;AACb,CAAC;AAWD;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CACrB,MAA6B,EAC7B,OAAoB,EAAE;IAEtB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE;QACpD,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS;QAC9B,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC,CAAC;IACH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAChC,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,MAAM;gBAAE,OAAO,OAAO,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9D,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,oEAAoE;AACpE,SAAS,YAAY,CAAC,MAAsB;IAC1C,OAAQ,WAAW,CAAC,OAA8C,CAAC,MAAM,CAAC,CAAC;AAC7E,CAAC"}

package/dist/sync-cli.d.ts

@@ -0,0 +1,2 @@
+export declare function runSyncCommand(argv: ReadonlyArray<string>): Promise<void>;
+//# sourceMappingURL=sync-cli.d.ts.map

package/dist/sync-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-cli.d.ts","sourceRoot":"","sources":["../src/sync-cli.ts"],"names":[],"mappings":"AAiIA,wBAAsB,cAAc,CAClC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAC1B,OAAO,CAAC,IAAI,CAAC,CA+Cf"}

package/dist/sync-cli.js

@@ -0,0 +1,137 @@
+import { relative } from "node:path";
+import { sync } from "./sync.js";
+const HELP = `
+k6-ts sync — generate the typed k6 client from an OpenAPI spec.
+
+USAGE
+  k6-ts sync <spec> [--output ./src/gen] [options]
+  k6-ts sync - [options]              # read JSON spec from stdin
+
+OPTIONS
+  --output <dir>          Where to write client.ts / types.ts / data.ts / index.ts.
+                          Default: ./src/gen
+  --base-url <url>        DEFAULT_BASE_URL baked into the generated client.
+                          Default: spec.servers[0].url
+  --scaffold              Also emit one stub loadtest per spec operation under loadtests/.
+  --no-normalize          Skip the safe-normalize preset on the input spec.
+  --dry-run               Build everything in memory, print results, don't write.
+  --report-renames        Diff operationIds against the prior sync's snapshot.
+  --help, -h              Show this help.
+
+EXAMPLES
+  k6-ts sync ./openapi.yaml --output ./src/gen
+  k6-ts sync https://api.example.com/openapi.json --base-url https://staging.example.com
+  openapi-recon ./traffic.har | k6-ts sync - --output ./src/gen
+`.trim();
+function parseArgs(argv) {
+    let input = "";
+    let output = "./src/gen";
+    let baseUrl;
+    let scaffold = false;
+    let normalize = true;
+    let dryRun = false;
+    let reportRenames = false;
+    let showHelp = false;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--help" || a === "-h") {
+            showHelp = true;
+            continue;
+        }
+        if (a === "--scaffold") {
+            scaffold = true;
+            continue;
+        }
+        if (a === "--no-normalize") {
+            normalize = false;
+            continue;
+        }
+        if (a === "--dry-run") {
+            dryRun = true;
+            continue;
+        }
+        if (a === "--report-renames") {
+            reportRenames = true;
+            continue;
+        }
+        if (a === "--output") {
+            output = expectValue(argv, ++i, "--output");
+            continue;
+        }
+        if (a === "--base-url") {
+            baseUrl = expectValue(argv, ++i, "--base-url");
+            continue;
+        }
+        if (a.startsWith("-") && a !== "-") {
+            throw new Error(`Unknown flag: ${a}`);
+        }
+        if (input) {
+            throw new Error(`Multiple inputs given: "${input}" and "${a}"`);
+        }
+        input = a;
+    }
+    if (!showHelp && !input) {
+        throw new Error("Missing input — pass a spec path, URL, or `-` for stdin JSON.");
+    }
+    return {
+        input,
+        output,
+        baseUrl,
+        scaffold,
+        normalize,
+        dryRun,
+        reportRenames,
+        showHelp,
+    };
+}
+function expectValue(argv, idx, flag) {
+    const v = argv[idx];
+    if (v === undefined || (v.startsWith("-") && v !== "-")) {
+        throw new Error(`${flag} requires a value`);
+    }
+    return v;
+}
+async function readStdinJson() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+    }
+    return JSON.parse(Buffer.concat(chunks).toString("utf8"));
+}
+export async function runSyncCommand(argv) {
+    let parsed;
+    try {
+        parsed = parseArgs(argv);
+    }
+    catch (err) {
+        console.error(`k6-ts sync: ${err instanceof Error ? err.message : String(err)}`);
+        console.error("Run `k6-ts sync --help` for usage.");
+        process.exit(2);
+    }
+    if (parsed.showHelp) {
+        console.log(HELP);
+        return;
+    }
+    const input = parsed.input === "-" ? await readStdinJson() : parsed.input;
+    const result = await sync({
+        input,
+        output: parsed.output,
+        normalize: parsed.normalize,
+        defaultBaseUrl: parsed.baseUrl,
+        scaffold: parsed.scaffold,
+        dryRun: parsed.dryRun,
+        reportRenames: parsed.reportRenames,
+    });
+    const where = relative(process.cwd(), result.output) || result.output;
+    const action = parsed.dryRun ? "would write" : "wrote";
+    console.error(`k6-ts sync: ${action} ${result.files.length} files to ${where}`);
+    if (result.diff) {
+        for (const r of result.diff.renamed) {
+            console.warn(`  renamed: ${r.method.toUpperCase()} ${r.path} — ${r.from} → ${r.to}`);
+        }
+        for (const r of result.diff.removed) {
+            console.warn(`  removed: ${r.method.toUpperCase()} ${r.path} — ${r.operationId}`);
+        }
+    }
+}
+//# sourceMappingURL=sync-cli.js.map

package/dist/sync-cli.js.map

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

package/dist/sync.d.ts

@@ -0,0 +1,23 @@
+import { type GenerateOptions, type GenerateResult } from "@ir-kit/k6-gen";
+import { type OperationDiff } from "./rename-report.js";
+export interface SyncOptions extends Pick<GenerateOptions, "input" | "normalize" | "defaultBaseUrl" | "scaffold" | "dryRun"> {
+    /** Output directory for the generated client. */
+    output: string;
+    /** Working directory used to resolve relative `input` / `output`. Default: `process.cwd()`. */
+    cwd?: string;
+    /** Diff operationIds against the prior sync's snapshot. */
+    reportRenames?: boolean;
+    /** Persist a fresh snapshot after generate. Default: `true`. */
+    writeSnapshot?: boolean;
+}
+export interface SyncResult extends GenerateResult {
+    /** Drift summary; populated only when `reportRenames` is true. */
+    diff?: OperationDiff;
+}
+/**
+ * Drive {@link generate} from a spec to an output directory, plus the
+ * snapshot bookkeeping that powers `--report-renames`. Returns the full
+ * `GenerateResult` (files + ir) so callers can chain.
+ */
+export declare function sync(opts: SyncOptions): Promise<SyncResult>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EAEpB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAO1E,MAAM,WAAW,WACf,SAAQ,IAAI,CACV,eAAe,EACf,OAAO,GAAG,WAAW,GAAG,gBAAgB,GAAG,UAAU,GAAG,QAAQ,CACjE;IACD,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gEAAgE;IAChE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,kEAAkE;IAClE,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA6BjE"}

package/dist/sync.js

@@ -0,0 +1,37 @@
+import { join, resolve } from "node:path";
+import { generate, } from "@ir-kit/k6-gen";
+import { resolveSpecInput } from "@ir-kit/openapi-tools";
+import { extractOperationMap } from "./operation-map.js";
+import { diffOperationIds } from "./rename-report.js";
+import { loadSnapshotOps, SNAPSHOT_FILENAME, writeSnapshotOps, } from "./snapshot.js";
+/**
+ * Drive {@link generate} from a spec to an output directory, plus the
+ * snapshot bookkeeping that powers `--report-renames`. Returns the full
+ * `GenerateResult` (files + ir) so callers can chain.
+ */
+export async function sync(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const output = resolve(cwd, opts.output);
+    const input = resolveSpecInput(opts.input, cwd);
+    const snapshotPath = join(output, SNAPSHOT_FILENAME);
+    const prevOps = opts.reportRenames
+        ? await loadSnapshotOps(snapshotPath)
+        : null;
+    const result = await generate({
+        input,
+        output,
+        normalize: opts.normalize,
+        defaultBaseUrl: opts.defaultBaseUrl,
+        scaffold: opts.scaffold,
+        dryRun: opts.dryRun,
+    });
+    const nextOps = extractOperationMap(result.ir);
+    if (!opts.dryRun && opts.writeSnapshot !== false) {
+        await writeSnapshotOps(snapshotPath, nextOps);
+    }
+    const diff = opts.reportRenames
+        ? diffOperationIds(prevOps ?? new Map(), nextOps)
+        : undefined;
+    return { ...result, diff };
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAGL,QAAQ,GACT,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAsB,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAsBvB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAiB;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAErD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa;QAChC,CAAC,CAAC,MAAM,eAAe,CAAC,YAAY,CAAC;QACrC,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;QAC5B,KAAK;QACL,MAAM;QACN,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;QACjD,MAAM,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa;QAC7B,CAAC,CAAC,gBAAgB,CAAC,OAAO,IAAI,IAAI,GAAG,EAAE,EAAE,OAAO,CAAC;QACjD,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@ir-kit/k6-toolkit",
+  "version": "0.1.0",
+  "description": "Programmatic toolkit for k6 workflows. Bundle loadtests (tsdown passthrough), spawn the k6 binary, sync the typed client from OpenAPI specs. One library covering the bundle → run → sync flow.",
+  "keywords": [
+    "k6",
+    "load-testing",
+    "openapi",
+    "codegen",
+    "bundler",
+    "tsdown"
+  ],
+  "homepage": "https://github.com/ir-kit/ir-kit/tree/main/packages/k6/toolkit",
+  "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/k6/toolkit"
+  },
+  "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": {
+    "k6-ts": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.3.0",
+    "tinyglobby": "^0.2.10",
+    "tsdown": "^0.22.0",
+    "@ir-kit/k6-gen": "0.1.0",
+    "@ir-kit/openapi-tools": "0.1.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"
+  }
+}