@jamesaphoenix/tx-test-utils 0.4.2 → 0.5.0

package/dist/index.js

@@ -18,7 +18,7 @@
 // Fixtures - SHA256-based deterministic IDs
 export { fixtureId, namespacedFixtureId, sequentialFixtureIds, contentFixtureId } from "./fixtures/index.js";
 // Database helpers
-export { createTestDatabase, TestDatabaseService, TestDatabaseLive, createTestDatabaseLayer } from "./database/index.js";
+export { createTestDatabase, TestDatabaseService, TestDatabaseLive, createTestDatabaseLayer, wrapDbAsTestDatabase } from "./database/index.js";
 // Factories
 export { 
 // Task
@@ -39,6 +39,12 @@ hashInput, cachedLLMCall, withLLMCache, configureLLMCache, getCacheConfig, reset
 getCacheStats, clearCache, formatCacheStats, getCacheEntry, listCacheEntries } from "./llm-cache/index.js";
 // Effect Helpers
 export { runEffect, runEffectFail, runEffectEither, expectEffectSuccess, expectEffectFailure, mergeLayers, createTestContext } from "./helpers/index.js";
+// Shared Test Layer - memory-efficient integration testing
+export { createSharedTestLayer } from "./helpers/index.js";
+// SQLite database factory for tests
+export { createSqliteDatabase, createMigratedSqliteDatabase } from "./helpers/index.js";
+// Singleton Test Database - ONE DB for entire test suite
+export { getSharedTestLayer, resetTestDb, closeTestDb, isTestDbInitialized } from "./singleton.js";
 // Temp Files (to be implemented)
 // export { createTempDir, writeTestTypeScriptFile, createTestSourceFiles } from './helpers/index.js'
 // export type { TempDir } from './helpers/index.js'
@@ -49,4 +55,26 @@ export { createMockAnthropic, createMockAnthropicForExtraction, createMockOpenAI
 // export { MockFileSystem } from './mocks/index.js'
 // Setup (to be implemented)
 // export { default as vitestSetup } from './setup/index.js'
+// Chaos Engineering Utilities
+export { 
+// Namespace export
+chaos, 
+// Process failure simulation
+crashAfter, CrashSimulationError, 
+// Worker heartbeat manipulation
+killHeartbeat, WorkerHeartbeatController, 
+// Race condition testing
+raceWorkers, 
+// State corruption
+corruptState, 
+// JSONL replay
+replayJSONL, 
+// Double completion testing
+doubleComplete, 
+// Partial write simulation
+partialWrite, 
+// Delayed claim testing
+delayedClaim, 
+// Stress testing
+stressLoad } from "./chaos/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,4CAA4C;AAC5C,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,qBAAqB,CAAA;AAE5B,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,qBAAqB,CAAA;AAG5B,YAAY;AACZ,OAAO;AACL,OAAO;AACP,WAAW,EACX,cAAc,EACd,eAAe;AAEf,WAAW;AACX,eAAe,EACf,kBAAkB,EAClB,mBAAmB;AAEnB,OAAO;AACP,WAAW,EACX,cAAc,EACd,0BAA0B;AAE1B,SAAS;AACT,aAAa,EACb,gBAAgB;AAEhB,YAAY;AACZ,gBAAgB,EAChB,mBAAmB,EAKpB,MAAM,sBAAsB,CAAA;AAE7B,4CAA4C;AAC5C,OAAO;AACL,iBAAiB;AACjB,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,gBAAgB;AAChB,gBAAgB;AAChB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EACjB,MAAM,sBAAsB,CAAA;AAS7B,iBAAiB;AACjB,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EAGlB,MAAM,oBAAoB,CAAA;AAE3B,iCAAiC;AACjC,qGAAqG;AACrG,oDAAoD;AAEpD,QAAQ;AACR,OAAO,EACL,mBAAmB,EACnB,gCAAgC,EAMhC,gBAAgB,EAChB,6BAA6B,EAC7B,gCAAgC,EAMjC,MAAM,kBAAkB,CAAA;AACzB,gDAAgD;AAChD,wDAAwD;AACxD,oDAAoD;AAEpD,4BAA4B;AAC5B,4DAA4D"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,4CAA4C;AAC5C,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,qBAAqB,CAAA;AAE5B,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,qBAAqB,CAAA;AAG5B,YAAY;AACZ,OAAO;AACL,OAAO;AACP,WAAW,EACX,cAAc,EACd,eAAe;AAEf,WAAW;AACX,eAAe,EACf,kBAAkB,EAClB,mBAAmB;AAEnB,OAAO;AACP,WAAW,EACX,cAAc,EACd,0BAA0B;AAE1B,SAAS;AACT,aAAa,EACb,gBAAgB;AAEhB,YAAY;AACZ,gBAAgB,EAChB,mBAAmB,EAKpB,MAAM,sBAAsB,CAAA;AAE7B,4CAA4C;AAC5C,OAAO;AACL,iBAAiB;AACjB,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,gBAAgB;AAChB,gBAAgB;AAChB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EACjB,MAAM,sBAAsB,CAAA;AAS7B,iBAAiB;AACjB,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EAGlB,MAAM,oBAAoB,CAAA;AAE3B,2DAA2D;AAC3D,OAAO,EACL,qBAAqB,EAGtB,MAAM,oBAAoB,CAAA;AAE3B,oCAAoC;AACpC,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC7B,MAAM,oBAAoB,CAAA;AAE3B,yDAAyD;AACzD,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,mBAAmB,EACpB,MAAM,gBAAgB,CAAA;AAEvB,iCAAiC;AACjC,qGAAqG;AACrG,oDAAoD;AAEpD,QAAQ;AACR,OAAO,EACL,mBAAmB,EACnB,gCAAgC,EAMhC,gBAAgB,EAChB,6BAA6B,EAC7B,gCAAgC,EAMjC,MAAM,kBAAkB,CAAA;AACzB,gDAAgD;AAChD,wDAAwD;AACxD,oDAAoD;AAEpD,4BAA4B;AAC5B,4DAA4D;AAE5D,8BAA8B;AAC9B,OAAO;AACL,mBAAmB;AACnB,KAAK;AACL,6BAA6B;AAC7B,UAAU,EACV,oBAAoB;AAGpB,gCAAgC;AAChC,aAAa,EACb,yBAAyB;AAEzB,yBAAyB;AACzB,WAAW;AAGX,mBAAmB;AACnB,YAAY;AAGZ,eAAe;AACf,WAAW;AAIX,4BAA4B;AAC5B,cAAc;AAGd,2BAA2B;AAC3B,YAAY;AAGZ,wBAAwB;AACxB,YAAY;AAGZ,iBAAiB;AACjB,UAAU,EAGX,MAAM,kBAAkB,CAAA"}

package/dist/singleton.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Singleton test database for maximum memory efficiency.
+ *
+ * Instead of creating a new database per test or per describe block,
+ * this module provides a single shared database instance for the entire test suite.
+ *
+ * Usage:
+ * - Tests call `getSharedTestLayer()` to get the singleton
+ * - Global `afterEach` in vitest.setup.ts calls `resetTestDb()` for isolation
+ * - Global `afterAll` calls `closeTestDb()` for cleanup
+ *
+ * @module @tx/test-utils/singleton
+ */
+import { type SharedTestLayerResult } from "./helpers/shared-test-layer.js";
+/**
+ * Get the singleton test database layer.
+ * Creates it on first call, returns cached instance thereafter.
+ *
+ * @example
+ * ```typescript
+ * import { getSharedTestLayer } from '@jamesaphoenix/tx-test-utils'
+ *
+ * it("test", async () => {
+ *   const { layer } = await getSharedTestLayer()
+ *   const result = await Effect.runPromise(
+ *     myEffect.pipe(Effect.provide(layer))
+ *   )
+ * })
+ * ```
+ */
+export declare const getSharedTestLayer: () => Promise<SharedTestLayerResult>;
+/**
+ * Reset all tables in the singleton DB.
+ * Call in afterEach to ensure test isolation.
+ * Safe to call even if DB hasn't been initialized.
+ */
+export declare const resetTestDb: () => Promise<void>;
+/**
+ * Close the singleton DB connection.
+ * Call in global teardown or afterAll.
+ * Resets the singleton so a new one can be created if needed.
+ */
+export declare const closeTestDb: () => Promise<void>;
+/**
+ * Check if the singleton has been initialized.
+ * Useful for debugging and conditional logic.
+ */
+export declare const isTestDbInitialized: () => boolean;
+//# sourceMappingURL=singleton.d.ts.map

package/dist/singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../src/singleton.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAyB,KAAK,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAIlG;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,kBAAkB,QAAa,OAAO,CAAC,qBAAqB,CAKxE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAa,OAAO,CAAC,IAAI,CAIhD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAa,OAAO,CAAC,IAAI,CAKhD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAO,OAEtC,CAAA"}

package/dist/singleton.js

@@ -0,0 +1,66 @@
+/**
+ * Singleton test database for maximum memory efficiency.
+ *
+ * Instead of creating a new database per test or per describe block,
+ * this module provides a single shared database instance for the entire test suite.
+ *
+ * Usage:
+ * - Tests call `getSharedTestLayer()` to get the singleton
+ * - Global `afterEach` in vitest.setup.ts calls `resetTestDb()` for isolation
+ * - Global `afterAll` calls `closeTestDb()` for cleanup
+ *
+ * @module @tx/test-utils/singleton
+ */
+import { createSharedTestLayer } from "./helpers/shared-test-layer.js";
+let instance = null;
+/**
+ * Get the singleton test database layer.
+ * Creates it on first call, returns cached instance thereafter.
+ *
+ * @example
+ * ```typescript
+ * import { getSharedTestLayer } from '@jamesaphoenix/tx-test-utils'
+ *
+ * it("test", async () => {
+ *   const { layer } = await getSharedTestLayer()
+ *   const result = await Effect.runPromise(
+ *     myEffect.pipe(Effect.provide(layer))
+ *   )
+ * })
+ * ```
+ */
+export const getSharedTestLayer = async () => {
+    if (!instance) {
+        instance = await createSharedTestLayer();
+    }
+    return instance;
+};
+/**
+ * Reset all tables in the singleton DB.
+ * Call in afterEach to ensure test isolation.
+ * Safe to call even if DB hasn't been initialized.
+ */
+export const resetTestDb = async () => {
+    if (instance) {
+        await instance.reset();
+    }
+};
+/**
+ * Close the singleton DB connection.
+ * Call in global teardown or afterAll.
+ * Resets the singleton so a new one can be created if needed.
+ */
+export const closeTestDb = async () => {
+    if (instance) {
+        await instance.close();
+        instance = null;
+    }
+};
+/**
+ * Check if the singleton has been initialized.
+ * Useful for debugging and conditional logic.
+ */
+export const isTestDbInitialized = () => {
+    return instance !== null;
+};
+//# sourceMappingURL=singleton.js.map

package/dist/singleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.js","sourceRoot":"","sources":["../src/singleton.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,qBAAqB,EAA8B,MAAM,gCAAgC,CAAA;AAElG,IAAI,QAAQ,GAAiC,IAAI,CAAA;AAEjD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,IAAoC,EAAE;IAC3E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,MAAM,qBAAqB,EAAE,CAAA;IAC1C,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,IAAmB,EAAE;IACnD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;AACH,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,IAAmB,EAAE;IACnD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAA;QACtB,QAAQ,GAAG,IAAI,CAAA;IACjB,CAAC;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAY,EAAE;IAC/C,OAAO,QAAQ,KAAK,IAAI,CAAA;AAC1B,CAAC,CAAA"}

package/package.json

@@ -1,52 +1,66 @@
 {
   "name": "@jamesaphoenix/tx-test-utils",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Test utilities, factories, fixtures, and helpers for tx monorepo",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
     "./database": {
+      "bun": "./src/database/index.ts",
       "types": "./dist/database/index.d.ts",
       "import": "./dist/database/index.js"
     },
     "./factories": {
+      "bun": "./src/factories/index.ts",
       "types": "./dist/factories/index.d.ts",
       "import": "./dist/factories/index.js"
     },
     "./fixtures": {
+      "bun": "./src/fixtures/index.ts",
       "types": "./dist/fixtures/index.d.ts",
       "import": "./dist/fixtures/index.js"
     },
     "./llm-cache": {
+      "bun": "./src/llm-cache/index.ts",
       "types": "./dist/llm-cache/index.d.ts",
       "import": "./dist/llm-cache/index.js"
     },
     "./mocks": {
+      "bun": "./src/mocks/index.ts",
       "types": "./dist/mocks/index.d.ts",
       "import": "./dist/mocks/index.js"
     },
     "./helpers": {
+      "bun": "./src/helpers/index.ts",
       "types": "./dist/helpers/index.d.ts",
       "import": "./dist/helpers/index.js"
     },
     "./setup": {
+      "bun": "./src/setup/index.ts",
       "types": "./dist/setup/index.d.ts",
       "import": "./dist/setup/index.js"
+    },
+    "./chaos": {
+      "bun": "./src/chaos/index.ts",
+      "types": "./dist/chaos/index.d.ts",
+      "import": "./dist/chaos/index.js"
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "scripts": {
     "build": "tsc -b",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src/",
-    "test": "vitest run --passWithNoTests"
+    "test": "bunx --bun vitest run"
   },
   "dependencies": {
     "@jamesaphoenix/tx-core": "*",
@@ -54,21 +68,17 @@
     "effect": "^3.19.15"
   },
   "peerDependencies": {
-    "better-sqlite3": "^11.0.0",
-    "vitest": "^3.0.0"
+    "vitest": "^4.0.18"
   },
   "peerDependenciesMeta": {
-    "better-sqlite3": {
-      "optional": false
-    },
     "vitest": {
       "optional": false
     }
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.0",
+    "@types/bun": "^1.2.0",
     "typescript": "^5.7.0",
-    "vitest": "^3.0.0"
+    "vitest": "^4.0.18"
   },
   "repository": {
     "type": "git",