dripfeed 0.1.0

package/dist/cli.mjs

@@ -0,0 +1,273 @@
+#!/usr/bin/env node
+import { _ as createJsonReporter, g as createMarkdownReporter, n as computeStats, s as loadDripfeedConfig, t as createSoakTest, u as createSqliteStorage, v as createConsoleReporter } from "./runner-ByEGj869.mjs";
+import { defineCommand, runMain } from "citty";
+//#region src/cli.ts
+const VALID_REPORT_FORMATS = [
+	"console",
+	"json",
+	"markdown"
+];
+const VALID_EXPORT_FORMATS = ["csv", "json"];
+const validateFormat = (format, valid, command) => {
+	if (!valid.includes(format)) {
+		process.stderr.write(`Unsupported format "${format}" for ${command}. Use: ${valid.join(", ")}\n`);
+		process.exit(1);
+	}
+};
+runMain(defineCommand({
+	meta: {
+		name: "dripfeed",
+		version: "0.1.0",
+		description: "SQLite-native API soak testing. Drip, not firehose."
+	},
+	subCommands: {
+		run: defineCommand({
+			meta: {
+				name: "run",
+				description: "Start a soak test"
+			},
+			args: {
+				duration: {
+					type: "string",
+					alias: "d",
+					description: "Test duration (e.g. \"30s\", \"5m\", \"2h\")"
+				},
+				interval: {
+					type: "string",
+					alias: "i",
+					description: "Request interval (e.g. \"3s\", \"500ms\")"
+				},
+				db: {
+					type: "string",
+					description: "SQLite database path"
+				},
+				report: {
+					type: "string",
+					alias: "r",
+					description: "Report format: console, json, markdown",
+					default: "console"
+				},
+				output: {
+					type: "string",
+					alias: "o",
+					description: "Report output file path"
+				},
+				quiet: {
+					type: "boolean",
+					alias: "q",
+					description: "Suppress live output",
+					default: false
+				}
+			},
+			run: async ({ args }) => {
+				const reportFormat = args.report ?? "console";
+				validateFormat(reportFormat, VALID_REPORT_FORMATS, "report");
+				const overrides = {};
+				if (args.duration) overrides.duration = args.duration;
+				if (args.interval) overrides.interval = args.interval;
+				if (args.db) overrides.db = args.db;
+				let config;
+				try {
+					config = await loadDripfeedConfig(overrides);
+				} catch (err) {
+					if (err && typeof err === "object" && "issues" in err) {
+						process.stderr.write("Invalid config. Run `dripfeed init` to create a starter config.\n");
+						const { issues } = err;
+						process.stderr.write(`Details: ${JSON.stringify(issues, null, 2)}\n`);
+					} else process.stderr.write(`Config error: ${err instanceof Error ? err.message : err}\n`);
+					process.exit(1);
+				}
+				const reporters = [];
+				const shouldQuiet = args.quiet || reportFormat !== "console";
+				if (!shouldQuiet) reporters.push(createConsoleReporter());
+				if (reportFormat === "json") reporters.push(createJsonReporter(args.output));
+				else if (reportFormat === "markdown") reporters.push(createMarkdownReporter(args.output));
+				if (!shouldQuiet) {
+					const interval = config.interval ?? "3s";
+					const duration = args.duration ? ` for ${args.duration}` : "";
+					process.stdout.write(`\ndripfeed v0.1.0 — every ${interval}${duration} | Ctrl+C to stop\n\n`);
+				}
+				if ((await createSoakTest(config, reporters).run({ duration: args.duration })).thresholds?.some((t) => !t.passed)) process.exit(1);
+			}
+		}),
+		init: defineCommand({
+			meta: {
+				name: "init",
+				description: "Generate a starter dripfeed config file"
+			},
+			args: { format: {
+				type: "string",
+				description: "Config format: ts, json",
+				default: "ts"
+			} },
+			run: async ({ args }) => {
+				const { writeFile, access } = await import("node:fs/promises");
+				const format = args.format ?? "ts";
+				if (format !== "ts" && format !== "json") {
+					process.stderr.write(`Unsupported format "${format}". Use: ts, json\n`);
+					process.exit(1);
+				}
+				const filename = format === "ts" ? "dripfeed.config.ts" : "dripfeed.config.json";
+				try {
+					await access(filename);
+					process.stderr.write(`${filename} already exists. Delete it first or use a different format.\n`);
+					process.exit(1);
+				} catch {}
+				if (format === "ts") await writeFile(filename, `import type { DripfeedConfig } from 'dripfeed';
+
+const config: DripfeedConfig = {
+\tinterval: '3s',
+\ttimeout: '30s',
+\tstorage: 'sqlite',
+\trotation: 'weighted-random',
+\tendpoints: [
+\t\t{
+\t\t\tname: 'health',
+\t\t\turl: 'https://api.example.com/health',
+\t\t},
+\t\t{
+\t\t\tname: 'users',
+\t\t\turl: 'https://api.example.com/v1/users',
+\t\t\tweight: 3,
+\t\t},
+\t],
+\tthresholds: {
+\t\terror_rate: '< 1%',
+\t\tp95: '< 500ms',
+\t},
+};
+
+export default config;
+`);
+				else await writeFile(filename, JSON.stringify({
+					interval: "3s",
+					timeout: "30s",
+					storage: "sqlite",
+					rotation: "weighted-random",
+					endpoints: [{
+						name: "health",
+						url: "https://api.example.com/health"
+					}, {
+						name: "users",
+						url: "https://api.example.com/v1/users",
+						weight: 3
+					}],
+					thresholds: {
+						error_rate: "< 1%",
+						p95: "< 500ms"
+					}
+				}, null, 2));
+				process.stdout.write(`Created ${filename}\n`);
+			}
+		}),
+		report: defineCommand({
+			meta: {
+				name: "report",
+				description: "Generate a report from an existing SQLite database"
+			},
+			args: {
+				db: {
+					type: "string",
+					description: "SQLite database path",
+					default: "dripfeed-results.db"
+				},
+				format: {
+					type: "string",
+					description: "Report format: console, json, markdown",
+					default: "console"
+				},
+				output: {
+					type: "string",
+					alias: "o",
+					description: "Output file path"
+				}
+			},
+			run: async ({ args }) => {
+				const format = args.format ?? "console";
+				validateFormat(format, VALID_REPORT_FORMATS, "report");
+				const storage = createSqliteStorage(args.db ?? "dripfeed-results.db");
+				await storage.init();
+				const results = await storage.getAll();
+				await storage.close();
+				if (results.length === 0) {
+					process.stdout.write("No results found in database.\n");
+					return;
+				}
+				const stats = computeStats(results, new Date(results[0]?.timestamp ?? Date.now()), void 0, new Date(results[results.length - 1]?.timestamp ?? Date.now()));
+				if (format === "console") createConsoleReporter().onComplete(stats);
+				else if (format === "json") createJsonReporter(args.output).onComplete(stats);
+				else if (format === "markdown") createMarkdownReporter(args.output).onComplete(stats);
+				if (args.output) process.stdout.write(`Report written to ${args.output}\n`);
+			}
+		}),
+		export: defineCommand({
+			meta: {
+				name: "export",
+				description: "Export results from SQLite to CSV or JSON"
+			},
+			args: {
+				db: {
+					type: "string",
+					description: "SQLite database path",
+					default: "dripfeed-results.db"
+				},
+				format: {
+					type: "string",
+					description: "Export format: csv, json",
+					default: "csv"
+				},
+				output: {
+					type: "string",
+					alias: "o",
+					description: "Output file path"
+				}
+			},
+			run: async ({ args }) => {
+				const format = args.format ?? "csv";
+				validateFormat(format, VALID_EXPORT_FORMATS, "export");
+				const { writeFile } = await import("node:fs/promises");
+				const storage = createSqliteStorage(args.db ?? "dripfeed-results.db");
+				await storage.init();
+				const results = await storage.getAll();
+				await storage.close();
+				let output;
+				if (format === "json") output = JSON.stringify(results, null, 2);
+				else {
+					const headers = [
+						"timestamp",
+						"endpoint",
+						"method",
+						"url",
+						"status",
+						"duration_ms",
+						"error",
+						"response_body"
+					];
+					const escapeCsv = (s) => {
+						if (s === null) return "";
+						return s.includes(",") || s.includes("\"") || s.includes("\n") ? `"${s.replace(/"/g, "\"\"")}"` : s;
+					};
+					const rows = results.map((r) => [
+						r.timestamp,
+						r.endpoint,
+						r.method,
+						r.url,
+						r.status ?? "",
+						r.duration_ms,
+						escapeCsv(r.error),
+						escapeCsv(r.response_body)
+					].join(","));
+					output = [headers.join(","), ...rows].join("\n");
+				}
+				if (args.output) {
+					await writeFile(args.output, output);
+					process.stdout.write(`Exported ${results.length} results to ${args.output}\n`);
+				} else process.stdout.write(`${output}\n`);
+			}
+		})
+	}
+}));
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { defineCommand, runMain } from 'citty';\nimport { createConsoleReporter } from './adapters/reporters/console.js';\nimport type { Reporter } from './adapters/reporters/interface.js';\nimport { createJsonReporter } from './adapters/reporters/json.js';\nimport { createMarkdownReporter } from './adapters/reporters/markdown.js';\nimport { createSqliteStorage } from './adapters/storage/sqlite.js';\nimport { loadDripfeedConfig, type ParsedConfig } from './core/config.js';\nimport { createSoakTest } from './core/runner.js';\nimport { computeStats } from './utils/stats.js';\n\nconst VALID_REPORT_FORMATS = ['console', 'json', 'markdown'] as const;\nconst VALID_EXPORT_FORMATS = ['csv', 'json'] as const;\n\nconst validateFormat = (format: string, valid: readonly string[], command: string) => {\n\tif (!valid.includes(format)) {\n\t\tprocess.stderr.write(\n\t\t\t`Unsupported format \"${format}\" for ${command}. Use: ${valid.join(', ')}\\n`,\n\t\t);\n\t\tprocess.exit(1);\n\t}\n};\n\nconst run = defineCommand({\n\tmeta: { name: 'run', description: 'Start a soak test' },\n\targs: {\n\t\tduration: { type: 'string', alias: 'd', description: 'Test duration (e.g. \"30s\", \"5m\", \"2h\")' },\n\t\tinterval: { type: 'string', alias: 'i', description: 'Request interval (e.g. \"3s\", \"500ms\")' },\n\t\tdb: { type: 'string', description: 'SQLite database path' },\n\t\treport: {\n\t\t\ttype: 'string',\n\t\t\talias: 'r',\n\t\t\tdescription: 'Report format: console, json, markdown',\n\t\t\tdefault: 'console',\n\t\t},\n\t\toutput: { type: 'string', alias: 'o', description: 'Report output file path' },\n\t\tquiet: { type: 'boolean', alias: 'q', description: 'Suppress live output', default: false },\n\t},\n\trun: async ({ args }) => {\n\t\tconst reportFormat = args.report ?? 'console';\n\t\tvalidateFormat(reportFormat, VALID_REPORT_FORMATS, 'report');\n\n\t\tconst overrides: Record<string, unknown> = {};\n\t\tif (args.duration) overrides.duration = args.duration;\n\t\tif (args.interval) overrides.interval = args.interval;\n\t\tif (args.db) overrides.db = args.db;\n\n\t\tlet config: ParsedConfig | undefined;\n\t\ttry {\n\t\t\tconfig = await loadDripfeedConfig(overrides);\n\t\t} catch (err) {\n\t\t\tif (err && typeof err === 'object' && 'issues' in err) {\n\t\t\t\tprocess.stderr.write('Invalid config. Run `dripfeed init` to create a starter config.\\n');\n\t\t\t\tconst { issues } = err as { issues: unknown };\n\t\t\t\tprocess.stderr.write(`Details: ${JSON.stringify(issues, null, 2)}\\n`);\n\t\t\t} else {\n\t\t\t\tprocess.stderr.write(`Config error: ${err instanceof Error ? err.message : err}\\n`);\n\t\t\t}\n\t\t\tprocess.exit(1);\n\t\t}\n\n\t\tconst reporters: Reporter[] = [];\n\t\t// Auto-quiet when using json/markdown report to avoid mixing outputs\n\t\tconst shouldQuiet = args.quiet || reportFormat !== 'console';\n\t\tif (!shouldQuiet) {\n\t\t\treporters.push(createConsoleReporter());\n\t\t}\n\n\t\tif (reportFormat === 'json') {\n\t\t\treporters.push(createJsonReporter(args.output));\n\t\t} else if (reportFormat === 'markdown') {\n\t\t\treporters.push(createMarkdownReporter(args.output));\n\t\t}\n\n\t\t// Startup banner (only in console mode)\n\t\tif (!shouldQuiet) {\n\t\t\tconst interval = config.interval ?? '3s';\n\t\t\tconst duration = args.duration ? ` for ${args.duration}` : '';\n\t\t\tprocess.stdout.write(`\\ndripfeed v0.1.0 — every ${interval}${duration} | Ctrl+C to stop\\n\\n`);\n\t\t}\n\n\t\tconst test = createSoakTest(config, reporters);\n\t\tconst stats = await test.run({ duration: args.duration });\n\n\t\tif (stats.thresholds?.some((t) => !t.passed)) {\n\t\t\tprocess.exit(1);\n\t\t}\n\t},\n});\n\nconst init = defineCommand({\n\tmeta: { name: 'init', description: 'Generate a starter dripfeed config file' },\n\targs: {\n\t\tformat: {\n\t\t\ttype: 'string',\n\t\t\tdescription: 'Config format: ts, json',\n\t\t\tdefault: 'ts',\n\t\t},\n\t},\n\trun: async ({ args }) => {\n\t\tconst { writeFile, access } = await import('node:fs/promises');\n\t\tconst format = args.format ?? 'ts';\n\n\t\tif (format !== 'ts' && format !== 'json') {\n\t\t\tprocess.stderr.write(`Unsupported format \"${format}\". Use: ts, json\\n`);\n\t\t\tprocess.exit(1);\n\t\t}\n\n\t\tconst filename = format === 'ts' ? 'dripfeed.config.ts' : 'dripfeed.config.json';\n\n\t\t// Check if file exists\n\t\ttry {\n\t\t\tawait access(filename);\n\t\t\tprocess.stderr.write(\n\t\t\t\t`${filename} already exists. Delete it first or use a different format.\\n`,\n\t\t\t);\n\t\t\tprocess.exit(1);\n\t\t} catch {\n\t\t\t// File doesn't exist, proceed\n\t\t}\n\n\t\tif (format === 'ts') {\n\t\t\tconst content = `import type { DripfeedConfig } from 'dripfeed';\n\nconst config: DripfeedConfig = {\n\\tinterval: '3s',\n\\ttimeout: '30s',\n\\tstorage: 'sqlite',\n\\trotation: 'weighted-random',\n\\tendpoints: [\n\\t\\t{\n\\t\\t\\tname: 'health',\n\\t\\t\\turl: 'https://api.example.com/health',\n\\t\\t},\n\\t\\t{\n\\t\\t\\tname: 'users',\n\\t\\t\\turl: 'https://api.example.com/v1/users',\n\\t\\t\\tweight: 3,\n\\t\\t},\n\\t],\n\\tthresholds: {\n\\t\\terror_rate: '< 1%',\n\\t\\tp95: '< 500ms',\n\\t},\n};\n\nexport default config;\n`;\n\t\t\tawait writeFile(filename, content);\n\t\t} else {\n\t\t\tconst content = {\n\t\t\t\tinterval: '3s',\n\t\t\t\ttimeout: '30s',\n\t\t\t\tstorage: 'sqlite',\n\t\t\t\trotation: 'weighted-random',\n\t\t\t\tendpoints: [\n\t\t\t\t\t{ name: 'health', url: 'https://api.example.com/health' },\n\t\t\t\t\t{ name: 'users', url: 'https://api.example.com/v1/users', weight: 3 },\n\t\t\t\t],\n\t\t\t\tthresholds: { error_rate: '< 1%', p95: '< 500ms' },\n\t\t\t};\n\t\t\tawait writeFile(filename, JSON.stringify(content, null, 2));\n\t\t}\n\n\t\tprocess.stdout.write(`Created ${filename}\\n`);\n\t},\n});\n\nconst report = defineCommand({\n\tmeta: { name: 'report', description: 'Generate a report from an existing SQLite database' },\n\targs: {\n\t\tdb: {\n\t\t\ttype: 'string',\n\t\t\tdescription: 'SQLite database path',\n\t\t\tdefault: 'dripfeed-results.db',\n\t\t},\n\t\tformat: {\n\t\t\ttype: 'string',\n\t\t\tdescription: 'Report format: console, json, markdown',\n\t\t\tdefault: 'console',\n\t\t},\n\t\toutput: { type: 'string', alias: 'o', description: 'Output file path' },\n\t},\n\trun: async ({ args }) => {\n\t\tconst format = args.format ?? 'console';\n\t\tvalidateFormat(format, VALID_REPORT_FORMATS, 'report');\n\n\t\tconst dbPath = args.db ?? 'dripfeed-results.db';\n\t\tconst storage = createSqliteStorage(dbPath);\n\t\tawait storage.init();\n\t\tconst results = await storage.getAll();\n\t\tawait storage.close();\n\n\t\tif (results.length === 0) {\n\t\t\tprocess.stdout.write('No results found in database.\\n');\n\t\t\treturn;\n\t\t}\n\n\t\t// Use first result timestamp as start, last as end for accurate duration\n\t\tconst firstTimestamp = new Date(results[0]?.timestamp ?? Date.now());\n\t\tconst lastTimestamp = new Date(results[results.length - 1]?.timestamp ?? Date.now());\n\t\tconst stats = computeStats(results, firstTimestamp, undefined, lastTimestamp);\n\n\t\tif (format === 'console') {\n\t\t\tcreateConsoleReporter().onComplete(stats);\n\t\t} else if (format === 'json') {\n\t\t\tcreateJsonReporter(args.output).onComplete(stats);\n\t\t} else if (format === 'markdown') {\n\t\t\tcreateMarkdownReporter(args.output).onComplete(stats);\n\t\t}\n\n\t\tif (args.output) {\n\t\t\tprocess.stdout.write(`Report written to ${args.output}\\n`);\n\t\t}\n\t},\n});\n\nconst exportCmd = defineCommand({\n\tmeta: { name: 'export', description: 'Export results from SQLite to CSV or JSON' },\n\targs: {\n\t\tdb: {\n\t\t\ttype: 'string',\n\t\t\tdescription: 'SQLite database path',\n\t\t\tdefault: 'dripfeed-results.db',\n\t\t},\n\t\tformat: { type: 'string', description: 'Export format: csv, json', default: 'csv' },\n\t\toutput: { type: 'string', alias: 'o', description: 'Output file path' },\n\t},\n\trun: async ({ args }) => {\n\t\tconst format = args.format ?? 'csv';\n\t\tvalidateFormat(format, VALID_EXPORT_FORMATS, 'export');\n\n\t\tconst { writeFile } = await import('node:fs/promises');\n\t\tconst dbPath = args.db ?? 'dripfeed-results.db';\n\t\tconst storage = createSqliteStorage(dbPath);\n\t\tawait storage.init();\n\t\tconst results = await storage.getAll();\n\t\tawait storage.close();\n\n\t\tlet output: string;\n\n\t\tif (format === 'json') {\n\t\t\toutput = JSON.stringify(results, null, 2);\n\t\t} else {\n\t\t\tconst headers = [\n\t\t\t\t'timestamp',\n\t\t\t\t'endpoint',\n\t\t\t\t'method',\n\t\t\t\t'url',\n\t\t\t\t'status',\n\t\t\t\t'duration_ms',\n\t\t\t\t'error',\n\t\t\t\t'response_body',\n\t\t\t];\n\t\t\tconst escapeCsv = (s: string | null) => {\n\t\t\t\tif (s === null) return '';\n\t\t\t\treturn s.includes(',') || s.includes('\"') || s.includes('\\n')\n\t\t\t\t\t? `\"${s.replace(/\"/g, '\"\"')}\"`\n\t\t\t\t\t: s;\n\t\t\t};\n\t\t\tconst rows = results.map((r) =>\n\t\t\t\t[\n\t\t\t\t\tr.timestamp,\n\t\t\t\t\tr.endpoint,\n\t\t\t\t\tr.method,\n\t\t\t\t\tr.url,\n\t\t\t\t\tr.status ?? '',\n\t\t\t\t\tr.duration_ms,\n\t\t\t\t\tescapeCsv(r.error),\n\t\t\t\t\tescapeCsv(r.response_body),\n\t\t\t\t].join(','),\n\t\t\t);\n\t\t\toutput = [headers.join(','), ...rows].join('\\n');\n\t\t}\n\n\t\tif (args.output) {\n\t\t\tawait writeFile(args.output, output);\n\t\t\tprocess.stdout.write(`Exported ${results.length} results to ${args.output}\\n`);\n\t\t} else {\n\t\t\tprocess.stdout.write(`${output}\\n`);\n\t\t}\n\t},\n});\n\nconst main = defineCommand({\n\tmeta: {\n\t\tname: 'dripfeed',\n\t\tversion: '0.1.0',\n\t\tdescription: 'SQLite-native API soak testing. Drip, not firehose.',\n\t},\n\tsubCommands: { run, init, report, export: exportCmd },\n});\n\nrunMain(main);\n"],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1,21 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runner = require("./runner-Dc1JRBps.cjs");
+exports.computeStats = require_runner.computeStats;
+exports.configSchema = require_runner.configSchema;
+exports.createConsoleReporter = require_runner.createConsoleReporter;
+exports.createJsonReporter = require_runner.createJsonReporter;
+exports.createJsonStorage = require_runner.createJsonStorage;
+exports.createMarkdownReporter = require_runner.createMarkdownReporter;
+exports.createMemoryStorage = require_runner.createMemoryStorage;
+exports.createSoakTest = require_runner.createSoakTest;
+exports.createSqliteStorage = require_runner.createSqliteStorage;
+exports.createStorage = require_runner.createStorage;
+exports.isBun = require_runner.isBun;
+exports.isDeno = require_runner.isDeno;
+exports.isNode = require_runner.isNode;
+exports.isSuccess = require_runner.isSuccess;
+exports.loadDripfeedConfig = require_runner.loadDripfeedConfig;
+exports.parseConfig = require_runner.parseConfig;
+exports.parseDuration = require_runner.parseDuration;
+exports.percentile = require_runner.percentile;
+exports.timedFetch = require_runner.timedFetch;

package/dist/index.d.cts

@@ -0,0 +1,187 @@
+import { z } from "zod";
+
+//#region src/core/types.d.ts
+interface RequestResult {
+  timestamp: string;
+  endpoint: string;
+  method: string;
+  url: string;
+  status: number | null;
+  duration_ms: number;
+  response_body: string | null;
+  error: string | null;
+}
+interface EndpointConfig {
+  name: string;
+  url: string;
+  method?: string;
+  headers?: Record<string, string>;
+  body?: unknown;
+  timeout?: string;
+  weight?: number;
+}
+interface ThresholdConfig {
+  error_rate?: string;
+  p50?: string;
+  p95?: string;
+  p99?: string;
+  max?: string;
+}
+interface DripfeedConfig {
+  interval?: string;
+  duration?: string;
+  timeout?: string;
+  storage?: 'sqlite' | 'json' | 'memory';
+  db?: string;
+  rotation?: 'weighted-random' | 'round-robin' | 'sequential';
+  headers?: Record<string, string>;
+  endpoints: EndpointConfig[];
+  thresholds?: ThresholdConfig;
+}
+/** Check if an HTTP status code represents a successful response */
+declare const isSuccess: (status: number | null) => boolean;
+interface EndpointStats {
+  name: string;
+  requests: number;
+  avg_ms: number;
+  p95_ms: number;
+  error_count: number;
+}
+interface ErrorGroup {
+  endpoint: string;
+  status: number | null;
+  count: number;
+  sample_body: string | null;
+}
+interface ThresholdResult {
+  name: string;
+  target: string;
+  actual: string;
+  passed: boolean;
+}
+interface LatencyStats {
+  min: number;
+  avg: number;
+  p50: number;
+  p95: number;
+  p99: number;
+  max: number;
+}
+interface SoakStats {
+  duration_s: number;
+  total_requests: number;
+  success_count: number;
+  failure_count: number;
+  uptime_pct: number;
+  latency: LatencyStats;
+  status_codes: Record<number, number>;
+  endpoints: EndpointStats[];
+  errors: ErrorGroup[];
+  thresholds?: ThresholdResult[];
+}
+interface SoakTestHandle {
+  start: () => Promise<void>;
+  stop: () => Promise<SoakStats>;
+  run: (opts?: {
+    duration?: string;
+  }) => Promise<SoakStats>;
+}
+//#endregion
+//#region src/adapters/reporters/interface.d.ts
+interface Reporter {
+  onRequest(result: RequestResult, counts: {
+    ok: number;
+    fail: number;
+  }): void;
+  onComplete(stats: SoakStats): void;
+}
+//#endregion
+//#region src/adapters/reporters/console.d.ts
+declare const createConsoleReporter: () => Reporter;
+//#endregion
+//#region src/adapters/reporters/json.d.ts
+declare const createJsonReporter: (outputPath?: string) => Reporter;
+//#endregion
+//#region src/adapters/reporters/markdown.d.ts
+declare const createMarkdownReporter: (outputPath?: string) => Reporter;
+//#endregion
+//#region src/adapters/storage/interface.d.ts
+interface StorageAdapter {
+  init(): Promise<void>;
+  record(result: RequestResult): Promise<void>;
+  getAll(): Promise<RequestResult[]>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/adapters/storage/json.d.ts
+declare const createJsonStorage: (filePath: string) => StorageAdapter;
+//#endregion
+//#region src/adapters/storage/memory.d.ts
+declare const createMemoryStorage: () => StorageAdapter;
+//#endregion
+//#region src/adapters/storage/sqlite.d.ts
+declare const createSqliteStorage: (dbPath: string) => StorageAdapter;
+//#endregion
+//#region src/adapters/storage/index.d.ts
+declare const createStorage: (config: DripfeedConfig) => StorageAdapter;
+//#endregion
+//#region src/core/config.d.ts
+declare const configSchema: z.ZodObject<{
+  interval: z.ZodDefault<z.ZodString>;
+  duration: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodDefault<z.ZodString>;
+  storage: z.ZodDefault<z.ZodEnum<{
+    sqlite: "sqlite";
+    json: "json";
+    memory: "memory";
+  }>>;
+  db: z.ZodOptional<z.ZodString>;
+  rotation: z.ZodDefault<z.ZodEnum<{
+    "weighted-random": "weighted-random";
+    "round-robin": "round-robin";
+    sequential: "sequential";
+  }>>;
+  headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  endpoints: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    url: z.ZodString;
+    method: z.ZodDefault<z.ZodString>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodOptional<z.ZodUnknown>;
+    timeout: z.ZodOptional<z.ZodString>;
+    weight: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>>;
+  thresholds: z.ZodOptional<z.ZodObject<{
+    error_rate: z.ZodOptional<z.ZodString>;
+    p50: z.ZodOptional<z.ZodString>;
+    p95: z.ZodOptional<z.ZodString>;
+    p99: z.ZodOptional<z.ZodString>;
+    max: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type ParsedConfig = z.infer<typeof configSchema>;
+/** Parse and validate a raw config object into a fully-typed ParsedConfig with defaults applied.
+ *  Use this when creating a soak test programmatically without a config file. */
+declare const parseConfig: (raw: unknown) => ParsedConfig;
+declare const loadDripfeedConfig: (overrides?: Partial<ParsedConfig>) => Promise<ParsedConfig>;
+//#endregion
+//#region src/core/runner.d.ts
+declare const createSoakTest: (config: ParsedConfig, reporters?: Reporter[]) => SoakTestHandle;
+//#endregion
+//#region src/utils/duration.d.ts
+declare const parseDuration: (input: string) => number;
+//#endregion
+//#region src/utils/http.d.ts
+declare const timedFetch: (endpoint: EndpointConfig, globalHeaders?: Record<string, string>, timeout?: string) => Promise<RequestResult>;
+//#endregion
+//#region src/utils/runtime.d.ts
+declare const isBun: boolean;
+declare const isDeno: boolean;
+declare const isNode: boolean;
+//#endregion
+//#region src/utils/stats.d.ts
+declare const percentile: (sorted: number[], p: number) => number;
+declare const computeStats: (results: RequestResult[], startTime: Date, thresholds?: ThresholdConfig, endTime?: Date) => SoakStats;
+//#endregion
+export { type DripfeedConfig, type EndpointConfig, type EndpointStats, type ErrorGroup, type LatencyStats, type ParsedConfig, type Reporter, type RequestResult, type SoakStats, type SoakTestHandle, type StorageAdapter, type ThresholdConfig, type ThresholdResult, computeStats, configSchema, createConsoleReporter, createJsonReporter, createJsonStorage, createMarkdownReporter, createMemoryStorage, createSoakTest, createSqliteStorage, createStorage, isBun, isDeno, isNode, isSuccess, loadDripfeedConfig, parseConfig, parseDuration, percentile, timedFetch };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/core/types.ts","../src/adapters/reporters/interface.ts","../src/adapters/reporters/console.ts","../src/adapters/reporters/json.ts","../src/adapters/reporters/markdown.ts","../src/adapters/storage/interface.ts","../src/adapters/storage/json.ts","../src/adapters/storage/memory.ts","../src/adapters/storage/sqlite.ts","../src/adapters/storage/index.ts","../src/core/config.ts","../src/core/runner.ts","../src/utils/duration.ts","../src/utils/http.ts","../src/utils/runtime.ts","../src/utils/stats.ts"],"mappings":"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"}