@ir-kit/kit 0.0.1 → 1.0.0

package/dist/cli/commands/fn-schema-extract.d.ts

@@ -0,0 +1,25 @@
+import type { CommandSpec } from "../command-spec.js";
+interface Input {
+    patterns?: string;
+    out?: string;
+    bundle?: string;
+    bundleTypes?: boolean;
+    watch?: boolean;
+    openapi?: string;
+    tsconfig?: string;
+    includeTag?: string;
+    excludeName?: string;
+    params?: string;
+    unwrapPromise?: boolean;
+    naming?: string;
+    dialect?: string;
+    identity?: string;
+    transport?: string;
+    sourceLocations?: string;
+    pretty?: boolean;
+    quiet?: boolean;
+    cwd?: string;
+}
+export declare const fnSchemaExtractCommand: CommandSpec<Input, void>;
+export {};
+//# sourceMappingURL=fn-schema-extract.d.ts.map

package/dist/cli/commands/fn-schema-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fn-schema-extract.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/fn-schema-extract.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,UAAU,KAAK;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAqFD,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,KAAK,EAAE,IAAI,CA2E3D,CAAC"}

package/dist/cli/commands/fn-schema-extract.js

@@ -0,0 +1,182 @@
+import path from "node:path";
+import { watchFiles } from "../../files.js";
+import { runExtract, } from "../../fn-schema/core/index.js";
+import { loadTypescriptExtractor } from "../../fn-schema/load-typescript.js";
+import { log } from "../log.js";
+const args = {
+    type: "object",
+    properties: {
+        patterns: {
+            type: "string",
+            description: "Glob pattern(s) for source files",
+        },
+        out: {
+            type: "string",
+            description: "Output directory (per-signature files)",
+        },
+        bundle: {
+            type: "string",
+            description: "Write a single bundled JSON file at this path",
+        },
+        bundleTypes: {
+            type: "boolean",
+            description: "When --bundle is set, also emit a sibling .ts wrapper",
+            default: false,
+        },
+        watch: {
+            type: "boolean",
+            description: "Re-extract on file change",
+            default: false,
+        },
+        openapi: {
+            type: "string",
+            description: "Write OpenAPI 3.1 components-only document at this path",
+        },
+        tsconfig: { type: "string", description: "Path to tsconfig.json" },
+        includeTag: {
+            type: "string",
+            description: "Only include functions carrying this JSDoc tag",
+        },
+        excludeName: {
+            type: "string",
+            description: "Exclude functions whose name matches this regex",
+        },
+        params: {
+            type: "string",
+            description: "Parameter rendering",
+            enum: ["array", "first-only", "object"],
+        },
+        unwrapPromise: {
+            type: "boolean",
+            description: "Unwrap Promise<T> in return types",
+        },
+        naming: {
+            type: "string",
+            description: "Naming strategy",
+            enum: ["function-name", "file-function", "jsdoc-tag"],
+        },
+        dialect: {
+            type: "string",
+            description: "JSON Schema dialect",
+            enum: ["draft-07", "draft-2020-12", "openapi-3.1"],
+        },
+        identity: {
+            type: "string",
+            description: "Vendor keyword for originating TS type",
+        },
+        transport: {
+            type: "string",
+            description: "Vendor keyword for binary transport hints",
+        },
+        sourceLocations: {
+            type: "string",
+            description: "Vendor keyword for file:line:col source locations",
+        },
+        pretty: {
+            type: "boolean",
+            description: "Pretty-print JSON output",
+            default: false,
+        },
+        quiet: {
+            type: "boolean",
+            description: "Suppress non-error logs",
+            default: false,
+        },
+        cwd: { type: "string", description: "Working directory" },
+    },
+};
+export const fnSchemaExtractCommand = {
+    path: ["fn-schema", "extract"],
+    description: "Extract JSON Schemas from TypeScript function signatures via ts-morph",
+    args,
+    handler: async (input) => {
+        if (input.quiet)
+            log.setQuiet(true);
+        const opts = mapInput(input, await loadTypescriptExtractor());
+        const once = async () => {
+            log.start("Extracting...");
+            const out = await runExtract(opts);
+            if (!out.ok) {
+                log.warn("No files matched.");
+                return 0;
+            }
+            for (const d of out.diagnostics) {
+                const msg = d.function ? `[${d.function}] ${d.message}` : d.message;
+                if (d.severity === "error")
+                    log.error(msg);
+                else if (d.severity === "warning")
+                    log.warn(msg);
+                else
+                    log.info(msg);
+            }
+            for (const w of out.written)
+                log.success(`Wrote ${w}`);
+            log.box(`Found ${out.result.signatures.length} signature(s) in ${out.durationMs}ms` +
+                (out.errors > 0 ? ` — ${out.errors} error(s)` : ""));
+            return out.errors;
+        };
+        if (!input.watch) {
+            const errors = await once();
+            if (errors > 0)
+                process.exitCode = 1;
+            return;
+        }
+        const cwd = path.resolve(input.cwd ?? process.cwd());
+        await once();
+        log.info("Watching for changes...");
+        const patterns = typeof opts.patterns === "string"
+            ? [opts.patterns]
+            : Array.isArray(opts.patterns)
+                ? [...opts.patterns]
+                : [];
+        let pending = null;
+        let queued = false;
+        const trigger = () => {
+            if (pending) {
+                queued = true;
+                return;
+            }
+            pending = (async () => {
+                try {
+                    return await once();
+                }
+                finally {
+                    pending = null;
+                    if (queued) {
+                        queued = false;
+                        trigger();
+                    }
+                }
+            })();
+            void pending;
+        };
+        const watcher = watchFiles(patterns.length > 0 ? patterns : ["**/*.ts"], cwd, trigger);
+        process.on("SIGINT", () => {
+            watcher.close();
+            process.exit(0);
+        });
+    },
+};
+function mapInput(input, typescript) {
+    return {
+        cwd: input.cwd,
+        patterns: input.patterns,
+        tsconfig: input.tsconfig,
+        includeTag: input.includeTag,
+        excludeName: input.excludeName,
+        params: input.params,
+        unwrapPromise: input.unwrapPromise,
+        naming: input.naming,
+        dialect: input.dialect,
+        identity: input.identity,
+        transport: input.transport,
+        sourceLocations: input.sourceLocations,
+        outDir: input.out,
+        bundlePath: input.bundle,
+        bundleTypes: input.bundleTypes,
+        openapiPath: input.openapi,
+        pretty: input.pretty,
+        extractors: [typescript()],
+    };
+}
+//# sourceMappingURL=fn-schema-extract.js.map

package/dist/cli/commands/fn-schema-extract.js.map

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

package/dist/cli/commands/fn-schema-inspect.d.ts

@@ -0,0 +1,16 @@
+import type { CommandSpec } from "../command-spec.js";
+interface Input {
+    name: string;
+    patterns?: string;
+    cwd?: string;
+    tsconfig?: string;
+    params?: string;
+    unwrapPromise?: boolean;
+    identity?: string;
+    transport?: string;
+    json?: boolean;
+    quiet?: boolean;
+}
+export declare const fnSchemaInspectCommand: CommandSpec<Input, void>;
+export {};
+//# sourceMappingURL=fn-schema-inspect.d.ts.map

package/dist/cli/commands/fn-schema-inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fn-schema-inspect.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/fn-schema-inspect.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA2CD,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,KAAK,EAAE,IAAI,CA0D3D,CAAC"}

package/dist/cli/commands/fn-schema-inspect.js

@@ -0,0 +1,118 @@
+import path from "node:path";
+import { runInspect } from "../../fn-schema/core/index.js";
+import { loadTypescriptExtractor } from "../../fn-schema/load-typescript.js";
+import { log } from "../log.js";
+const args = {
+    type: "object",
+    properties: {
+        name: { type: "string", description: "Function name to inspect" },
+        patterns: {
+            type: "string",
+            description: "Glob pattern(s) for source files",
+        },
+        cwd: { type: "string", description: "Working directory" },
+        tsconfig: { type: "string", description: "Path to tsconfig.json" },
+        params: {
+            type: "string",
+            description: "Parameter rendering",
+            enum: ["array", "first-only", "object"],
+        },
+        unwrapPromise: {
+            type: "boolean",
+            description: "Unwrap Promise<T> in return types",
+        },
+        identity: {
+            type: "string",
+            description: "Vendor keyword for originating TS type",
+        },
+        transport: {
+            type: "string",
+            description: "Vendor keyword for binary transport hints",
+        },
+        json: {
+            type: "boolean",
+            description: "Emit machine-readable JSON",
+            default: false,
+        },
+        quiet: {
+            type: "boolean",
+            description: "Suppress non-error logs",
+            default: false,
+        },
+    },
+    required: ["name"],
+};
+export const fnSchemaInspectCommand = {
+    path: ["fn-schema", "inspect"],
+    description: "Print the resolved input + output JSON Schema for a single function",
+    args,
+    handler: async (input) => {
+        if (input.quiet)
+            log.setQuiet(true);
+        const out = await runInspect({
+            name: input.name,
+            cwd: input.cwd,
+            patterns: input.patterns,
+            tsconfig: input.tsconfig,
+            params: input.params,
+            unwrapPromise: input.unwrapPromise,
+            identity: input.identity,
+            transport: input.transport,
+            extractors: [(await loadTypescriptExtractor())()],
+        });
+        if (out.kind === "not-found") {
+            log.error(`Function "${input.name}" not found.`);
+            process.exitCode = 1;
+            return;
+        }
+        if (out.kind === "ambiguous") {
+            const cwd = path.resolve(input.cwd ?? process.cwd());
+            log.error(`Function "${input.name}" matched ${out.matches.length} signatures. Narrow the patterns:`);
+            for (const m of out.matches) {
+                log.error(`  ${path.relative(cwd, m.file)}:${m.location.line}:${m.location.column}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        if (input.json) {
+            process.stdout.write(`${JSON.stringify({
+                signature: out.signature,
+                definitions: out.result.definitions,
+                diagnostics: out.result.diagnostics,
+            }, null, 2)}\n`);
+            return;
+        }
+        renderInspect(out.signature, out.result, path.resolve(input.cwd ?? process.cwd()));
+    },
+};
+function renderInspect(sig, result, cwd) {
+    const rel = path.relative(cwd, sig.file);
+    process.stdout.write(`\n${sig.id}  ${rel}:${sig.location.line}:${sig.location.column}\n`);
+    if (sig.jsDoc?.description) {
+        process.stdout.write(`  ${sig.jsDoc.description}\n`);
+    }
+    process.stdout.write("\n  input:\n");
+    process.stdout.write(indent(JSON.stringify(sig.input, null, 2), 4));
+    process.stdout.write("\n\n  output:\n");
+    process.stdout.write(indent(JSON.stringify(sig.output, null, 2), 4));
+    if (Object.keys(result.definitions).length > 0) {
+        process.stdout.write("\n\n  definitions:\n");
+        process.stdout.write(indent(JSON.stringify(result.definitions, null, 2), 4));
+    }
+    const fnDiags = result.diagnostics.filter((d) => d.function === sig.name);
+    if (fnDiags.length > 0) {
+        process.stdout.write("\n\n  diagnostics:\n");
+        for (const d of fnDiags) {
+            process.stdout.write(`    ${d.severity}  ${d.code}  ${d.message}\n`);
+        }
+    }
+    process.stdout.write("\n");
+}
+function indent(text, spaces) {
+    const pad = " ".repeat(spaces);
+    return text
+        .split("\n")
+        .map((line) => `${pad}${line}`)
+        .join("\n");
+}
+//# sourceMappingURL=fn-schema-inspect.js.map

package/dist/cli/commands/fn-schema-inspect.js.map

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

package/dist/cli/commands/fn-schema-scan.d.ts

@@ -0,0 +1,13 @@
+import type { CommandSpec } from "../command-spec.js";
+interface Input {
+    patterns?: string;
+    cwd?: string;
+    tsconfig?: string;
+    includeTag?: string;
+    excludeName?: string;
+    json?: boolean;
+    quiet?: boolean;
+}
+export declare const fnSchemaScanCommand: CommandSpec<Input, void>;
+export {};
+//# sourceMappingURL=fn-schema-scan.d.ts.map

package/dist/cli/commands/fn-schema-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fn-schema-scan.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/fn-schema-scan.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,UAAU,KAAK;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAgCD,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,KAAK,EAAE,IAAI,CAiCxD,CAAC"}

package/dist/cli/commands/fn-schema-scan.js

@@ -0,0 +1,92 @@
+import path from "node:path";
+import { runScan } from "../../fn-schema/core/index.js";
+import { loadTypescriptExtractor } from "../../fn-schema/load-typescript.js";
+import { log } from "../log.js";
+const args = {
+    type: "object",
+    properties: {
+        patterns: {
+            type: "string",
+            description: "Glob pattern(s) for source files",
+        },
+        cwd: { type: "string", description: "Working directory" },
+        tsconfig: { type: "string", description: "Path to tsconfig.json" },
+        includeTag: {
+            type: "string",
+            description: "Only include functions carrying this JSDoc tag",
+        },
+        excludeName: {
+            type: "string",
+            description: "Exclude functions whose name matches this regex",
+        },
+        json: {
+            type: "boolean",
+            description: "Emit machine-readable JSON instead of a human table",
+            default: false,
+        },
+        quiet: {
+            type: "boolean",
+            description: "Suppress non-error logs",
+            default: false,
+        },
+    },
+};
+export const fnSchemaScanCommand = {
+    path: ["fn-schema", "scan"],
+    description: "List functions discoverable in source — no schemas generated",
+    args,
+    handler: async (input) => {
+        if (input.quiet)
+            log.setQuiet(true);
+        const out = await runScan({
+            cwd: input.cwd,
+            patterns: input.patterns,
+            tsconfig: input.tsconfig,
+            includeTag: input.includeTag,
+            excludeName: input.excludeName,
+            extractors: [(await loadTypescriptExtractor())()],
+        });
+        if (!out.ok) {
+            log.warn("No files matched.");
+            return;
+        }
+        if (input.json) {
+            process.stdout.write(`${JSON.stringify(out.result, null, 2)}\n`);
+            return;
+        }
+        renderTable(out.result.signatures, path.resolve(input.cwd ?? process.cwd()));
+        log.box(`${out.result.signatures.length} fn(s) across ${out.filesScanned} file(s) in ${out.durationMs}ms` +
+            (out.errors + out.warnings > 0
+                ? ` — ${out.errors} error(s), ${out.warnings} warning(s)`
+                : ""));
+    },
+};
+function renderTable(signatures, cwd) {
+    const byFile = new Map();
+    for (const sig of signatures) {
+        const list = byFile.get(sig.file) ?? [];
+        list.push(sig);
+        byFile.set(sig.file, list);
+    }
+    for (const [file, list] of byFile) {
+        process.stdout.write(`\n${path.relative(cwd, file)}\n`);
+        for (const sig of list) {
+            const flags = [
+                sig.exported ? "exported" : "",
+                sig.async ? "async" : "",
+                sig.generic ? "generic" : "",
+                sig.kind !== "function" ? sig.kind : "",
+                sig.className ? `class:${sig.className}` : "",
+            ]
+                .filter(Boolean)
+                .join(" ");
+            const tag = sig.jsDoc?.tags
+                ? Object.entries(sig.jsDoc.tags)
+                    .map(([k, v]) => `@${k}${typeof v === "string" ? ` ${v}` : ""}`)
+                    .join(" ")
+                : "";
+            process.stdout.write(`  ${sig.name.padEnd(24)} ${`${sig.location.line}:${sig.location.column}`.padEnd(8)} ${flags}${tag ? `  ${tag}` : ""}\n`);
+        }
+    }
+}
+//# sourceMappingURL=fn-schema-scan.js.map

package/dist/cli/commands/fn-schema-scan.js.map

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

package/dist/cli/commands/generate.d.ts

@@ -0,0 +1,10 @@
+import type { CommandSpec } from "../command-spec.js";
+interface Input {
+    config?: string;
+    targets?: string;
+    check?: boolean;
+}
+export declare const generateCommand: CommandSpec<Input, void>;
+export declare const watchCommand: CommandSpec<Omit<Input, "check">, void>;
+export {};
+//# sourceMappingURL=generate.d.ts.map

package/dist/cli/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,UAAU,KAAK;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA2BD,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,KAAK,EAAE,IAAI,CAwCpD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,IAAI,CAiBhE,CAAC"}

package/dist/cli/commands/generate.js

@@ -0,0 +1,80 @@
+import { loadIrConfig } from "../../generate/load-config.js";
+import { generate } from "../../generate/run.js";
+import { watch } from "../../generate/watch.js";
+import { log } from "../log.js";
+const configArgs = {
+    config: {
+        type: "string",
+        description: "Config file (default: ir.config.ts in this directory)",
+    },
+    targets: {
+        type: "string",
+        description: "Comma-separated targets to run (default: all in the config)",
+    },
+};
+const splitTargets = (value) => value
+    ?.split(",")
+    .map((name) => name.trim())
+    .filter(Boolean);
+const report = (results) => {
+    for (const { target, output } of results) {
+        log.success(`${target} → ${output}`);
+    }
+};
+const MAX_LISTED = 20;
+export const generateCommand = {
+    path: ["generate"],
+    description: "Run every target in ir.config.ts",
+    args: {
+        type: "object",
+        properties: {
+            ...configArgs,
+            check: {
+                type: "boolean",
+                description: "Don't write. Fail when the output on disk differs from what would be generated",
+                default: false,
+            },
+        },
+    },
+    handler: async (input) => {
+        const { config, cwd } = await loadIrConfig({ configFile: input.config });
+        const results = await generate(config, {
+            cwd,
+            only: splitTargets(input.targets),
+            check: input.check,
+        });
+        if (!input.check)
+            return report(results);
+        const stale = results.filter((result) => result.stale.length > 0);
+        if (stale.length === 0) {
+            log.success(`${results.length} target(s) up to date`);
+            return;
+        }
+        const lines = stale.flatMap(({ target, output, stale: files }) => [
+            `${target} (${output}):`,
+            ...files.slice(0, MAX_LISTED).map((file) => `  ${file}`),
+            ...(files.length > MAX_LISTED
+                ? [`  …and ${files.length - MAX_LISTED} more`]
+                : []),
+        ]);
+        throw new Error(`Generated output is out of date.\n${lines.join("\n")}\nRun \`ir generate\` and commit the result.`);
+    },
+};
+export const watchCommand = {
+    path: ["watch"],
+    description: "Run ir.config.ts targets now and again whenever a spec changes",
+    args: { type: "object", properties: configArgs },
+    handler: async (input) => {
+        const controller = new AbortController();
+        process.once("SIGINT", () => controller.abort());
+        log.info("Watching for changes. Press Ctrl+C to stop.");
+        await watch({
+            configFile: input.config,
+            only: splitTargets(input.targets),
+            signal: controller.signal,
+            onRun: report,
+            onError: (error) => log.error(error instanceof Error ? error.message : String(error)),
+        });
+    },
+};
+//# sourceMappingURL=generate.js.map

package/dist/cli/commands/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAqB,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAGhD,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAQhC,MAAM,UAAU,GAAG;IACjB,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uDAAuD;KACrE;IACD,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,6DAA6D;KAC3E;CAC+B,CAAC;AAEnC,MAAM,YAAY,GAAG,CAAC,KAAyB,EAAE,EAAE,CACjD,KAAK;IACH,EAAE,KAAK,CAAC,GAAG,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;KAC1B,MAAM,CAAC,OAAO,CAAC,CAAC;AAErB,MAAM,MAAM,GAAG,CAAC,OAAuB,EAAE,EAAE;IACzC,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzC,GAAG,CAAC,OAAO,CAAC,GAAG,MAAM,MAAM,MAAM,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,IAAI,EAAE,CAAC,UAAU,CAAC;IAClB,WAAW,EAAE,kCAAkC;IAC/C,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,UAAU;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,gFAAgF;gBAClF,OAAO,EAAE,KAAK;aACf;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,YAAY,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE;YACrC,GAAG;YACH,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;YACjC,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;QAEzC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAClE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,uBAAuB,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YAChE,GAAG,MAAM,KAAK,MAAM,IAAI;YACxB,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;YACxD,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU;gBAC3B,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,MAAM,GAAG,UAAU,OAAO,CAAC;gBAC9C,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;QACH,MAAM,IAAI,KAAK,CACb,qCAAqC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,8CAA8C,CACpG,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAA4C;IACnE,IAAI,EAAE,CAAC,OAAO,CAAC;IACf,WAAW,EAAE,gEAAgE;IAC7E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE;IAChD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;QACjD,GAAG,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QACxD,MAAM,KAAK,CAAC;YACV,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;YACjC,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,GAAG,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SACpE,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,11 @@
+import type { AuthFlavor } from "../../k6-toolkit/index.js";
+import type { CommandSpec } from "../command-spec.js";
+interface Input {
+    input?: string;
+    targets?: string;
+    auth?: AuthFlavor;
+    force?: boolean;
+}
+export declare const initCommand: CommandSpec<Input, void>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,UAAU,KAAK;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAyCD,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,KAAK,EAAE,IAAI,CAqDhD,CAAC"}