sverka 0.0.0 → 0.2.3

package/dist/bin.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/bin.mjs

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { t as missingBuildHint } from "./errors-DHioC6LB.mjs";
+import process from "node:process";
+//#region src/bin.ts
+async function start() {
+	try {
+		const { main } = await import("./index.mjs");
+		process.exitCode = await main(process.argv.slice(2));
+	} catch (e) {
+		const hint = missingBuildHint(e);
+		if (hint !== null) process.stderr.write(`error: ${hint}\n`);
+		else {
+			const msg = e instanceof Error ? e.stack ?? e.message : String(e);
+			process.stderr.write(`fatal: ${msg}\n`);
+		}
+		process.exitCode = 3;
+	}
+}
+start();
+//#endregion
+export {};
+
+//# sourceMappingURL=bin.mjs.map

package/dist/bin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.mjs","names":[],"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\nimport process from \"node:process\";\nimport { missingBuildHint } from \"./internal/errors.js\";\n\n// Set process.exitCode and let the event loop drain instead of calling\n// process.exit() immediately — a forced exit can truncate buffered stdout/stderr\n// writes when output is piped or large.\nasync function start(): Promise<void> {\n  try {\n    // Dynamic import so a missing @sverka/* dist (partial build) lands here\n    // as a readable hint instead of Node's raw ERR_MODULE_NOT_FOUND.\n    const { main } = await import(\"./index.js\");\n    process.exitCode = await main(process.argv.slice(2));\n  } catch (e: unknown) {\n    const hint = missingBuildHint(e);\n    if (hint !== null) {\n      process.stderr.write(`error: ${hint}\\n`);\n    } else {\n      const msg = e instanceof Error ? (e.stack ?? e.message) : String(e);\n      process.stderr.write(`fatal: ${msg}\\n`);\n    }\n    process.exitCode = 3;\n  }\n}\n\nvoid start();\n"],"mappings":";;;;AAOA,eAAe,QAAuB;CACpC,IAAI;EAGF,MAAM,EAAE,SAAS,MAAM,OAAO;EAC9B,QAAQ,WAAW,MAAM,KAAK,QAAQ,KAAK,MAAM,CAAC,CAAC;CACrD,SAAS,GAAY;EACnB,MAAM,OAAO,iBAAiB,CAAC;EAC/B,IAAI,SAAS,MACX,QAAQ,OAAO,MAAM,UAAU,KAAK,GAAG;OAClC;GACL,MAAM,MAAM,aAAa,QAAS,EAAE,SAAS,EAAE,UAAW,OAAO,CAAC;GAClE,QAAQ,OAAO,MAAM,UAAU,IAAI,GAAG;EACxC;EACA,QAAQ,WAAW;CACrB;AACF;AAEK,MAAM"}

package/dist/errors-DHioC6LB.mjs

@@ -0,0 +1,16 @@
+//#region src/internal/errors.ts
+/**
+* When a workspace @sverka/* dependency resolves but its dist output is
+* missing (partial build, stale checkout), Node throws a raw
+* ERR_MODULE_NOT_FOUND that does not tell the user what to do. Detect that
+* case and return an actionable hint, or null for unrelated errors.
+*/
+function missingBuildHint(e) {
+	const msg = e instanceof Error ? e.message : String(e);
+	if ((e.code === "ERR_MODULE_NOT_FOUND" || /Cannot find (?:module|package)/.test(msg)) && msg.includes("@sverka/") && /[/\\]dist[/\\]/.test(msg)) return "a @sverka/* dependency has no build output — run `bun run build` in the sverka checkout and retry";
+	return null;
+}
+//#endregion
+export { missingBuildHint as t };
+
+//# sourceMappingURL=errors-DHioC6LB.mjs.map

package/dist/errors-DHioC6LB.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-DHioC6LB.mjs","names":[],"sources":["../src/internal/errors.ts"],"sourcesContent":["// Error-message helpers shared by the bin entry and the command dispatcher.\n\n/**\n * When a workspace @sverka/* dependency resolves but its dist output is\n * missing (partial build, stale checkout), Node throws a raw\n * ERR_MODULE_NOT_FOUND that does not tell the user what to do. Detect that\n * case and return an actionable hint, or null for unrelated errors.\n */\nexport function missingBuildHint(e: unknown): string | null {\n  const msg = e instanceof Error ? e.message : String(e);\n  const code = (e as { code?: unknown }).code;\n  const isModuleNotFound =\n    code === \"ERR_MODULE_NOT_FOUND\" ||\n    /Cannot find (?:module|package)/.test(msg);\n  if (\n    isModuleNotFound &&\n    msg.includes(\"@sverka/\") &&\n    /[/\\\\]dist[/\\\\]/.test(msg)\n  ) {\n    return (\n      \"a @sverka/* dependency has no build output — \" +\n      \"run `bun run build` in the sverka checkout and retry\"\n    );\n  }\n  return null;\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,iBAAiB,GAA2B;CAC1D,MAAM,MAAM,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;CAKrD,KAJc,EAAyB,SAE5B,0BACT,iCAAiC,KAAK,GAAG,MAGzC,IAAI,SAAS,UAAU,KACvB,iBAAiB,KAAK,GAAG,GAEzB,OACE;CAIJ,OAAO;AACT"}

package/dist/index.d.mts

@@ -0,0 +1,84 @@
+//#region src/types.d.ts
+/** Global flags parsed from the command line. */
+export interface GlobalFlags {
+  /** Output format. Defaults to "text". */
+  format: "text" | "json" | "html" | "sarif" | "web";
+  /** Path to sverka.config.ts. */
+  config: string | null;
+  /** Root directory. Defaults to process.cwd(). */
+  root: string;
+  /** Suppress non-error output. */
+  quiet: boolean;
+  /** Enable verbose output with debug information. */
+  verbose: boolean;
+}
+/** Output writer abstraction for testability. */
+export interface OutputWriter {
+  write(text: string): void;
+  writeLine(text: string): void;
+  error(text: string): void;
+  errorLine(text: string): void;
+  /** Write a debug line, only visible when --verbose is set. */
+  debug(text: string): void;
+}
+/** Exit codes used by the CLI. */
+export declare const ExitCode: {
+  readonly Success: 0;
+  readonly PolicyFail: 1;
+  readonly UsageError: 2;
+  readonly RuntimeError: 3;
+};
+export type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];
+/** CLI error codes. */
+export type CliErrorCode = "UNKNOWN_COMMAND" | "MISSING_ARG" | "INVALID_FLAG" | "CONFIG_EXISTS" | "RUNTIME_NOT_AVAILABLE" | "SDK_ERROR" | "PACKAGE_ERROR";
+/** Error thrown when CLI argument parsing or command execution fails. */
+export declare class CliError extends Error {
+  readonly code: CliErrorCode;
+  readonly exitCode: ExitCode;
+  readonly cause: unknown;
+  constructor(message: string, code: CliErrorCode, exitCode: ExitCode, cause?: unknown);
+}
+//#endregion
+//#region src/main.d.ts
+/** Optional dependencies for main (testability seam). */
+interface MainDeps {
+  output?: OutputWriter;
+}
+/**
+ * The main CLI entry point.
+ * @param argv Command-line arguments (excluding node and script path).
+ * @returns Exit code (0 = success, 1 = policy fail, 2 = usage error, 3 = runtime error).
+ */
+export declare function main(argv: string[], deps?: MainDeps): Promise<number>;
+//#endregion
+//#region src/output.d.ts
+/** A sink that receives a string. */
+type WriteSink = (text: string) => void;
+/**
+ * OutputWriter that writes to caller-provided sinks (stdout/stderr).
+ * In production, the sinks write to process.stdout/process.stderr.
+ * In tests, the sinks capture into arrays.
+ */
+export declare class ConsoleOutputWriter implements OutputWriter {
+  #private;
+  constructor(out: WriteSink, err: WriteSink, quiet?: boolean, verbose?: boolean);
+  write(text: string): void;
+  writeLine(text: string): void;
+  error(text: string): void;
+  errorLine(text: string): void;
+  /** Write a debug line to stderr, only when --verbose is set. */
+  debug(text: string): void;
+}
+/**
+ * Create an OutputWriter from global flags. In JSON format, stdout is NOT
+ * suppressed by --quiet (the JSON result is the data and must be emitted).
+ */
+export declare function createOutputWriter(global: GlobalFlags, out: WriteSink, err: WriteSink): ConsoleOutputWriter;
+/**
+ * Wrap any OutputWriter with --quiet / --verbose semantics from global flags.
+ * Use for injected test writers so they respect the same suppression rules.
+ */
+export declare function wrapOutputWriter(global: GlobalFlags, base: OutputWriter): OutputWriter;
+//#endregion
+export type { MainDeps, WriteSink };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/main.ts","../src/output.ts"],"mappings":";;iBAGiB;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;;iBAIe;EACf,MAAM;EACN,UAAU;EACV,MAAM;EACN,UAAU;;EAEV,MAAM;;;qBAIK;;;;;;YAOD,mBAAmB,uBAAuB;;YAG1C;;qBAUC,iBAAiB;WACnB,MAAM;WACN,UAAU;WACD;EAEhB,YAAA,iBACA,MAAM,cACN,UAAU,UACV;;;;;UC/Ba;EACf,SAAS;;;;;;;wBA2XW,KAAK,gBAAgB,OAAO,WAAW;;;;KCjZjD,aAAa;;;;;;qBAOZ,+BAA+B;;EAM9B,YAAA,KAAK,WAAW,KAAK,WAAW,iBAAe;EAO3D,MAAM;EAKN,UAAU;EAKV,MAAM;EAIN,UAAU;;EAKV,MAAM;;;;;;wBAwDQ,mBACd,QAAQ,aACR,KAAK,WACL,KAAK,YACJ;;;;;wBAYa,iBACd,QAAQ,aACR,MAAM,eACL"}