vimonkey 0.2.2 → 0.2.4

package/dist/chaos/index.mjs

@@ -0,0 +1,121 @@
+//#region src/chaos/index.ts
+/**
+* Skip items with probability `rate`.
+* Simulates message loss, queue overflow, network drops.
+*/
+async function* drop(source, rate, rng) {
+	for await (const item of source) if (!rng.bool(rate)) yield item;
+}
+/**
+* Buffer up to `windowSize` items, shuffle, yield when buffer is full.
+* Simulates out-of-order delivery, non-deterministic event ordering.
+*/
+async function* reorder(source, windowSize, rng) {
+	const buffer = [];
+	for await (const item of source) {
+		buffer.push(item);
+		if (buffer.length >= windowSize) {
+			const shuffled = rng.shuffle(buffer);
+			buffer.length = 0;
+			for (const e of shuffled) yield e;
+		}
+	}
+	if (buffer.length > 0) {
+		const shuffled = rng.shuffle(buffer);
+		for (const e of shuffled) yield e;
+	}
+}
+/**
+* With probability `rate`, yield the item twice.
+* Simulates duplicate delivery, at-least-once semantics.
+*/
+async function* duplicate(source, rate, rng) {
+	for await (const item of source) {
+		yield item;
+		if (rng.bool(rate)) yield item;
+	}
+}
+/**
+* Collect `burstSize` items, then yield them all at once.
+* Simulates bursty delivery, batched network packets.
+*/
+async function* burst(source, burstSize) {
+	const buffer = [];
+	for await (const item of source) {
+		buffer.push(item);
+		if (buffer.length >= burstSize) {
+			for (const e of buffer) yield e;
+			buffer.length = 0;
+		}
+	}
+	for (const e of buffer) yield e;
+}
+/**
+* Skip the first `count` items.
+* Simulates missed events during initialization, late subscriber.
+*/
+async function* initGap(source, count) {
+	let skipped = 0;
+	for await (const item of source) {
+		if (skipped < count) {
+			skipped++;
+			continue;
+		}
+		yield item;
+	}
+}
+/**
+* Add a random delay before yielding each item.
+* Simulates slow I/O, network latency, disk delays.
+*/
+async function* delay(source, minMs, maxMs, rng) {
+	for await (const item of source) {
+		const ms = rng.int(minMs, maxMs);
+		await new Promise((resolve) => setTimeout(resolve, ms));
+		yield item;
+	}
+}
+/** Built-in transformer registry (works for any T) */
+const BUILTIN_REGISTRY = {
+	drop: (s, p, rng) => drop(s, p.rate ?? .2, rng),
+	reorder: (s, p, rng) => reorder(s, p.windowSize ?? 5, rng),
+	duplicate: (s, p, rng) => duplicate(s, p.rate ?? .3, rng),
+	burst: (s, p) => burst(s, p.burstSize ?? 10),
+	initGap: (s, p) => initGap(s, p.count ?? 5),
+	delay: (s, p, rng) => delay(s, p.minMs ?? 1, p.maxMs ?? 5, rng)
+};
+/**
+* Compose multiple chaos transformer configs into a single async iterable pipeline.
+*
+* Uses built-in transformers by default. Pass a custom `registry` to add
+* domain-specific transformers (e.g., FS-specific atomicSave, coalesce).
+*
+* @example
+* ```typescript
+* const chaotic = chaos(source, [
+*   { type: "drop", params: { rate: 0.2 } },
+*   { type: "reorder", params: { windowSize: 5 } },
+* ], rng)
+* ```
+*
+* @example Custom registry
+* ```typescript
+* const chaotic = chaos(source, configs, rng, {
+*   ...builtinChaosRegistry,
+*   atomic_save: (s, p, rng) => atomicSave(s, p.rate, rng),
+* })
+* ```
+*/
+function chaos(source, configs, rng, registry) {
+	const reg = registry ?? BUILTIN_REGISTRY;
+	let pipeline = source;
+	for (const config of configs) {
+		const factory = reg[config.type];
+		if (factory) pipeline = factory(pipeline, config.params, rng);
+	}
+	return pipeline;
+}
+/** Re-export the built-in registry for extension */
+const builtinChaosRegistry = BUILTIN_REGISTRY;
+//#endregion
+export { builtinChaosRegistry, burst, chaos, delay, drop, duplicate, initGap, reorder };

package/dist/fuzz/index.mjs

@@ -0,0 +1,2 @@
+import { C as getFuzzContext, D as parseRepeats, E as deriveSeeds, O as parseSeed, S as fuzzContext, T as createSeededRandom, _ as shrinkSequence, a as beforeEach, b as createFuzzContext, c as it, d as deleteCase, f as getFuzzCasesDir, g as formatShrinkResult, h as saveCase, i as beforeAll, k as weightedPickFromTuples, l as test, m as loadCasesForTest, n as afterAll, o as describe, p as loadCases, r as afterEach, s as expect, t as FuzzError, u as clearCases, v as gen, w as isInFuzzContext, x as createReplayContext, y as take } from "../test-fuzz-ZgFKEVq-.mjs";
+export { FuzzError, afterAll, afterEach, beforeAll, beforeEach, clearCases, createFuzzContext, createReplayContext, createSeededRandom, deleteCase, deriveSeeds, describe, expect, formatShrinkResult, fuzzContext, gen, getFuzzCasesDir, getFuzzContext, isInFuzzContext, it, loadCases, loadCasesForTest, parseRepeats, parseSeed, saveCase, shrinkSequence, take, test, weightedPickFromTuples };

package/dist/index.mjs

@@ -0,0 +1,37 @@
+import { C as getFuzzContext, D as parseRepeats, E as deriveSeeds, O as parseSeed, S as fuzzContext, T as createSeededRandom, _ as shrinkSequence, a as beforeEach, b as createFuzzContext, c as it, d as deleteCase, f as getFuzzCasesDir, g as formatShrinkResult, h as saveCase, i as beforeAll, k as weightedPickFromTuples, l as test, m as loadCasesForTest, n as afterAll, o as describe, p as loadCases, r as afterEach, s as expect, t as FuzzError, u as clearCases, v as gen, w as isInFuzzContext, x as createReplayContext, y as take } from "./test-fuzz-ZgFKEVq-.mjs";
+//#region src/env.ts
+const VALID_VALUES = [
+	"fake",
+	"real:mem",
+	"real:disk"
+];
+/**
+* Get the current TEST_SYS value
+*
+* @returns The test system type, defaults to 'fake'
+*
+* @example
+* ```typescript
+* import { getTestSys } from 'vimonkey'
+*
+* const sys = getTestSys()
+* if (sys === 'fake') {
+*   // use mock
+* } else if (sys === 'real:mem') {
+*   // use real with in-memory storage
+* } else {
+*   // use real with disk storage
+* }
+* ```
+*/
+function getTestSys() {
+	const value = process.env.TEST_SYS;
+	if (!value) return "fake";
+	if (!VALID_VALUES.includes(value)) {
+		console.warn(`Invalid TEST_SYS value: "${value}". Valid values: ${VALID_VALUES.join(", ")}. Defaulting to "fake".`);
+		return "fake";
+	}
+	return value;
+}
+//#endregion
+export { FuzzError, afterAll, afterEach, beforeAll, beforeEach, clearCases, createFuzzContext, createReplayContext, createSeededRandom, deleteCase, deriveSeeds, describe, expect, formatShrinkResult, fuzzContext, gen, getFuzzCasesDir, getFuzzContext, getTestSys, isInFuzzContext, it, loadCases, loadCasesForTest, parseRepeats, parseSeed, saveCase, shrinkSequence, take, test, weightedPickFromTuples };

package/dist/plugin.mjs

@@ -0,0 +1,14 @@
+//#region src/plugin.ts
+/**
+* Creates the vimonkey plugin for Vitest
+*/
+function viMonkey(options = {}) {
+	const { fuzz = {}, ai = {}, doc = {} } = options;
+	return {
+		name: "vimonkey",
+		config() {},
+		configureServer(server) {}
+	};
+}
+//#endregion
+export { viMonkey as default, viMonkey };