@jamesaphoenix/tx-test-utils 0.4.2 → 0.4.3

package/dist/helpers/sqlite-factory.d.ts

@@ -0,0 +1,49 @@
+/**
+ * SQLite database factory for tests.
+ *
+ * Creates SqliteDatabase instances that work with both Vitest (better-sqlite3)
+ * and Bun test (bun:sqlite). Tests should use this instead of directly importing
+ * from "bun:sqlite".
+ *
+ * Uses the SqliteDatabase interface from @tx/core, which is what SqliteClient
+ * provides via Effect layers. This means databases created here can be used
+ * directly with Layer.succeed(SqliteClient, db) — no `as any` needed.
+ *
+ * @module @tx/test-utils/helpers/sqlite-factory
+ */
+import type { SqliteDatabase } from "@jamesaphoenix/tx-core";
+/**
+ * Create a SqliteDatabase instance.
+ *
+ * - Under Vitest: uses better-sqlite3, wrapped via the adapter
+ * - Under Bun test: uses bun:sqlite
+ *
+ * PRAGMAs (journal_mode, foreign_keys, busy_timeout) are set automatically.
+ * Migrations are NOT applied — call applyMigrations(db) yourself if needed.
+ *
+ * @param path - Database file path, or ":memory:" (default)
+ *
+ * @example
+ * ```typescript
+ * import { createSqliteDatabase } from "@jamesaphoenix/tx-test-utils"
+ * import { applyMigrations, SqliteClient } from "@jamesaphoenix/tx-core"
+ * import { Layer } from "effect"
+ *
+ * // Raw database for migration tests
+ * const db = await createSqliteDatabase()
+ * applyMigrations(db)
+ *
+ * // Use with Effect layers
+ * const infra = Layer.succeed(SqliteClient, db)
+ * ```
+ */
+export declare const createSqliteDatabase: (path?: string) => Promise<SqliteDatabase>;
+/**
+ * Create a SqliteDatabase with all migrations applied.
+ *
+ * Convenience wrapper around createSqliteDatabase + applyMigrations.
+ *
+ * @param path - Database file path, or ":memory:" (default)
+ */
+export declare const createMigratedSqliteDatabase: (path?: string) => Promise<SqliteDatabase>;
+//# sourceMappingURL=sqlite-factory.d.ts.map

package/dist/helpers/sqlite-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-factory.d.ts","sourceRoot":"","sources":["../../src/helpers/sqlite-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAQ5D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAM,MAAmB,KACxB,OAAO,CAAC,cAAc,CAkBxB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,GACvC,OAAM,MAAmB,KACxB,OAAO,CAAC,cAAc,CAKxB,CAAA"}

package/dist/helpers/sqlite-factory.js

@@ -0,0 +1,74 @@
+/**
+ * SQLite database factory for tests.
+ *
+ * Creates SqliteDatabase instances that work with both Vitest (better-sqlite3)
+ * and Bun test (bun:sqlite). Tests should use this instead of directly importing
+ * from "bun:sqlite".
+ *
+ * Uses the SqliteDatabase interface from @tx/core, which is what SqliteClient
+ * provides via Effect layers. This means databases created here can be used
+ * directly with Layer.succeed(SqliteClient, db) — no `as any` needed.
+ *
+ * @module @tx/test-utils/helpers/sqlite-factory
+ */
+/**
+ * Detect whether we're running under Vitest (better-sqlite3) or Bun test (bun:sqlite).
+ */
+const isVitest = () => typeof process !== "undefined" && process.env.VITEST === "true";
+/**
+ * Create a SqliteDatabase instance.
+ *
+ * - Under Vitest: uses better-sqlite3, wrapped via the adapter
+ * - Under Bun test: uses bun:sqlite
+ *
+ * PRAGMAs (journal_mode, foreign_keys, busy_timeout) are set automatically.
+ * Migrations are NOT applied — call applyMigrations(db) yourself if needed.
+ *
+ * @param path - Database file path, or ":memory:" (default)
+ *
+ * @example
+ * ```typescript
+ * import { createSqliteDatabase } from "@jamesaphoenix/tx-test-utils"
+ * import { applyMigrations, SqliteClient } from "@jamesaphoenix/tx-core"
+ * import { Layer } from "effect"
+ *
+ * // Raw database for migration tests
+ * const db = await createSqliteDatabase()
+ * applyMigrations(db)
+ *
+ * // Use with Effect layers
+ * const infra = Layer.succeed(SqliteClient, db)
+ * ```
+ */
+export const createSqliteDatabase = async (path = ":memory:") => {
+    if (isVitest()) {
+        const { wrapBetterSqlite3 } = await import("../adapters/better-sqlite3-adapter.js");
+        const Database = (await import("better-sqlite3")).default;
+        const raw = new Database(path);
+        raw.pragma("journal_mode = WAL");
+        raw.pragma("foreign_keys = ON");
+        raw.pragma("busy_timeout = " + (process.env.TX_DB_BUSY_TIMEOUT || "5000"));
+        return wrapBetterSqlite3(raw);
+    }
+    // Bun test
+    const { Database } = await import("bun:sqlite");
+    const raw = new Database(path);
+    raw.run("PRAGMA journal_mode = WAL");
+    raw.run("PRAGMA foreign_keys = ON");
+    raw.run("PRAGMA busy_timeout = " + (process.env.TX_DB_BUSY_TIMEOUT || "5000"));
+    return raw;
+};
+/**
+ * Create a SqliteDatabase with all migrations applied.
+ *
+ * Convenience wrapper around createSqliteDatabase + applyMigrations.
+ *
+ * @param path - Database file path, or ":memory:" (default)
+ */
+export const createMigratedSqliteDatabase = async (path = ":memory:") => {
+    const { applyMigrations } = await import("@jamesaphoenix/tx-core");
+    const db = await createSqliteDatabase(path);
+    applyMigrations(db);
+    return db;
+};
+//# sourceMappingURL=sqlite-factory.js.map

package/dist/helpers/sqlite-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-factory.js","sourceRoot":"","sources":["../../src/helpers/sqlite-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;GAEG;AACH,MAAM,QAAQ,GAAG,GAAY,EAAE,CAC7B,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,OAAe,UAAU,EACA,EAAE;IAC3B,IAAI,QAAQ,EAAE,EAAE,CAAC;QACf,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAA;QACnF,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAA;QACzD,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC9B,GAAG,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAA;QAChC,GAAG,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAA;QAC/B,GAAG,CAAC,MAAM,CAAC,iBAAiB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,MAAM,CAAC,CAAC,CAAA;QAC1E,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED,WAAW;IACX,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;IAC/C,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC9B,GAAG,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAA;IACpC,GAAG,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAA;IACnC,GAAG,CAAC,GAAG,CAAC,wBAAwB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,MAAM,CAAC,CAAC,CAAA;IAC9E,OAAO,GAAgC,CAAA;AACzC,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,EAC/C,OAAe,UAAU,EACA,EAAE;IAC3B,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAA;IAClE,MAAM,EAAE,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAA;IAC3C,eAAe,CAAC,EAAE,CAAC,CAAA;IACnB,OAAO,EAAE,CAAA;AACX,CAAC,CAAA"}

package/dist/index.d.ts

@@ -16,11 +16,15 @@
  * @module @tx/test-utils
  */
 export { fixtureId, namespacedFixtureId, sequentialFixtureIds, contentFixtureId } from "./fixtures/index.js";
-export { createTestDatabase, TestDatabaseService, TestDatabaseLive, createTestDatabaseLayer } from "./database/index.js";
+export { createTestDatabase, TestDatabaseService, TestDatabaseLive, createTestDatabaseLayer, wrapDbAsTestDatabase } from "./database/index.js";
 export type { TestDatabase } from "./database/index.js";
-export { TaskFactory, createTestTask, createTestTasks, type CreateTaskOptions, LearningFactory, createTestLearning, createTestLearnings, type CreateLearningOptions, EdgeFactory, createTestEdge, createEdgeBetweenLearnings, type CreateEdgeOptions, AnchorFactory, createTestAnchor, type CreateAnchorOptions, CandidateFactory, createTestCandidate, type CreateCandidateOptions, type LearningCandidate, type CandidateConfidence, type CandidateStatus } from "./factories/index.js";
+export { TaskFactory, createTestTask, createTestTasks, type CreateTaskOptions, LearningFactory, createTestLearning, createTestLearnings, type CreateLearningOptions, } from "./factories/index.js";
 export { hashInput, cachedLLMCall, withLLMCache, configureLLMCache, getCacheConfig, resetCacheConfig, getCacheStats, clearCache, formatCacheStats, getCacheEntry, listCacheEntries } from "./llm-cache/index.js";
 export type { CacheEntry, CachedLLMCallOptions, WithLLMCacheOptions, CacheStats, ClearCacheOptions } from "./llm-cache/index.js";
 export { runEffect, runEffectFail, runEffectEither, expectEffectSuccess, expectEffectFailure, mergeLayers, createTestContext, type RunEffectOptions, type EffectResult } from "./helpers/index.js";
+export { createSharedTestLayer, type SharedTestLayer, type SharedTestLayerResult } from "./helpers/index.js";
+export { createSqliteDatabase, createMigratedSqliteDatabase } from "./helpers/index.js";
+export { getSharedTestLayer, resetTestDb, closeTestDb, isTestDbInitialized } from "./singleton.js";
 export { createMockAnthropic, createMockAnthropicForExtraction, type MockMessage, type MockAnthropicCall, type MockAnthropicResponse, type MockAnthropicConfig, type MockAnthropicResult, createMockOpenAI, createMockOpenAIForExtraction, createMockOpenAIForExtractionRaw, type MockOpenAIMessage, type MockOpenAIChatCall, type MockOpenAIChatResponse, type MockOpenAIConfig, type MockOpenAIResult } from "./mocks/index.js";
+export { chaos, crashAfter, CrashSimulationError, type CrashAfterOptions, type CrashAfterResult, killHeartbeat, WorkerHeartbeatController, type KillHeartbeatOptions, raceWorkers, type RaceWorkersOptions, type RaceWorkersResult, corruptState, type CorruptStateOptions, type CorruptionType, replayJSONL, type ReplayJSONLOptions, type ReplayJSONLResult, type SyncOperation, doubleComplete, type DoubleCompleteOptions, type DoubleCompleteResult, partialWrite, type PartialWriteOptions, type PartialWriteResult, delayedClaim, type DelayedClaimOptions, type DelayedClaimResult, stressLoad, type StressLoadOptions, type StressLoadResult } from "./chaos/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGvD,OAAO,EAEL,WAAW,EACX,cAAc,EACd,eAAe,EACf,KAAK,iBAAiB,EAEtB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,qBAAqB,EAE1B,WAAW,EACX,cAAc,EACd,0BAA0B,EAC1B,KAAK,iBAAiB,EAEtB,aAAa,EACb,gBAAgB,EAChB,KAAK,mBAAmB,EAExB,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EAEL,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAEhB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EACjB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EAClB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAA;AAO3B,OAAO,EACL,mBAAmB,EACnB,gCAAgC,EAChC,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,gBAAgB,EAChB,6BAA6B,EAC7B,gCAAgC,EAChC,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGvD,OAAO,EAEL,WAAW,EACX,cAAc,EACd,eAAe,EACf,KAAK,iBAAiB,EAEtB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EAEL,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAEhB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EACjB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EAClB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC3B,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC7B,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,mBAAmB,EACpB,MAAM,gBAAgB,CAAA;AAOvB,OAAO,EACL,mBAAmB,EACnB,gCAAgC,EAChC,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,gBAAgB,EAChB,6BAA6B,EAC7B,gCAAgC,EAChC,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAA;AASzB,OAAO,EAEL,KAAK,EAEL,UAAU,EACV,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAErB,aAAa,EACb,yBAAyB,EACzB,KAAK,oBAAoB,EAEzB,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EAEtB,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAEnB,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAElB,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAEzB,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAEvB,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAEvB,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -18,19 +18,13 @@
 // 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
 TaskFactory, createTestTask, createTestTasks, 
 // Learning
-LearningFactory, createTestLearning, createTestLearnings, 
-// Edge
-EdgeFactory, createTestEdge, createEdgeBetweenLearnings, 
-// Anchor
-AnchorFactory, createTestAnchor, 
-// Candidate
-CandidateFactory, createTestCandidate } from "./factories/index.js";
+LearningFactory, createTestLearning, createTestLearnings, } from "./factories/index.js";
 // LLM Cache - SHA256-based response caching
 export { 
 // Core functions
@@ -39,6 +33,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 — creates SqliteDatabase for both Vitest and Bun test
+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 +49,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,GAEpB,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,gFAAgF;AAChF,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,6 +1,6 @@
 {
   "name": "@jamesaphoenix/tx-test-utils",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Test utilities, factories, fixtures, and helpers for tx monorepo",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,16 +37,21 @@
     "./setup": {
       "types": "./dist/setup/index.d.ts",
       "import": "./dist/setup/index.js"
+    },
+    "./chaos": {
+      "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": "bun test src/ test/"
   },
   "dependencies": {
     "@jamesaphoenix/tx-core": "*",
@@ -54,21 +59,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",

package/dist/factories/factories.test.d.ts

@@ -1,8 +0,0 @@
-/**
- * Tests for entity factories.
- *
- * Verifies that all factories correctly create test data with
- * proper defaults and customizable options.
- */
-export {};
-//# sourceMappingURL=factories.test.d.ts.map

package/dist/factories/factories.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"factories.test.d.ts","sourceRoot":"","sources":["../../src/factories/factories.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}