@digitaldefiance/express-suite-test-utils 1.0.8 → 1.0.9

package/README.md

@@ -103,6 +103,10 @@ MIT
 
 ## ChangeLog
 
+### v1.0.9
+
+- Add mongoose memory helpers
+
 ### v1.0.8
 
 - Add directLog mocks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/express-suite-test-utils",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Test utilities for Digital Defiance Express Suite",
   "main": "src/index.js",
   "types": "src/index.d.ts",
@@ -37,10 +37,15 @@
   "dependencies": {
     "@jest/globals": "^30.0.5",
     "@types/jest": "^30.0.0",
-    "expect": "^30.0.5"
+    "expect": "^30.0.5",
+    "mongodb-memory-server": "^10.1.3"
+  },
+  "peerDependencies": {
+    "mongoose": "^8.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0"
+    "@types/node": "^22.0.0",
+    "mongoose": "^8.9.3"
   },
   "type": "commonjs"
 }

package/src/index.d.ts

@@ -4,4 +4,5 @@ export * from './lib/direct-log';
 export * from './lib/localStorage-mock';
 export * from './lib/bson-mock';
 export * from './lib/react-mocks';
+export * from './lib/mongoose-memory';
 //# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-express-suite-test-utils/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-express-suite-test-utils/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/src/index.js

@@ -7,3 +7,4 @@ tslib_1.__exportStar(require("./lib/direct-log"), exports);
 tslib_1.__exportStar(require("./lib/localStorage-mock"), exports);
 tslib_1.__exportStar(require("./lib/bson-mock"), exports);
 tslib_1.__exportStar(require("./lib/react-mocks"), exports);
+tslib_1.__exportStar(require("./lib/mongoose-memory"), exports);

package/src/lib/direct-log.d.ts

@@ -2,7 +2,7 @@
  * Spies returned from withDirectLogMocks
  */
 export interface DirectLogSpies {
-    writeSync: jest.SpyInstance;
+    writeSync: jest.Mock;
 }
 /**
  * Options for withDirectLogMocks
@@ -18,19 +18,21 @@ export interface WithDirectLogOptions {
  * Wrap a test body with fs.writeSync spy for directLog testing.
  * By default mutes output (does nothing on write).
  * The spy will capture calls with file descriptor and buffer.
+ *
+ * Note: Requires fs module to be mocked at module level with jest.mock('fs')
  */
 export declare function withDirectLogMocks<T = unknown>(options: WithDirectLogOptions, fn: (spies: DirectLogSpies) => Promise<T> | T): Promise<T>;
 /**
  * Helper to check if writeSync was called with a specific file descriptor and message.
- * @param spy The writeSync spy
+ * @param spy The writeSync mock
  * @param fd The file descriptor (1 for stdout, 2 for stderr)
  * @param needles Substrings to search for in the buffer content
  */
-export declare function directLogContains(spy: jest.SpyInstance, fd: number, ...needles: string[]): boolean;
+export declare function directLogContains(spy: jest.Mock, fd: number, ...needles: string[]): boolean;
 /**
  * Get all messages written to a specific file descriptor.
- * @param spy The writeSync spy
+ * @param spy The writeSync mock
  * @param fd The file descriptor (1 for stdout, 2 for stderr)
  */
-export declare function getDirectLogMessages(spy: jest.SpyInstance, fd: number): string[];
+export declare function getDirectLogMessages(spy: jest.Mock, fd: number): string[];
 //# sourceMappingURL=direct-log.d.ts.map

package/src/lib/direct-log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"direct-log.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-test-utils/src/lib/direct-log.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAClD,OAAO,EAAE,oBAAoB,EAC7B,EAAE,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAC5C,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,IAAI,CAAC,WAAW,EACrB,EAAE,EAAE,MAAM,EACV,GAAG,OAAO,EAAE,MAAM,EAAE,GACnB,OAAO,CAWT;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,IAAI,CAAC,WAAW,EACrB,EAAE,EAAE,MAAM,GACT,MAAM,EAAE,CASV"}
+{"version":3,"file":"direct-log.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-test-utils/src/lib/direct-log.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAClD,OAAO,EAAE,oBAAoB,EAC7B,EAAE,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAC5C,OAAO,CAAC,CAAC,CAAC,CAgCZ;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,IAAI,CAAC,IAAI,EACd,EAAE,EAAE,MAAM,EACV,GAAG,OAAO,EAAE,MAAM,EAAE,GACnB,OAAO,CAWT;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,IAAI,CAAC,IAAI,EACd,EAAE,EAAE,MAAM,GACT,MAAM,EAAE,CASV"}

package/src/lib/direct-log.js

@@ -9,27 +9,42 @@ const fs = tslib_1.__importStar(require("fs"));
  * Wrap a test body with fs.writeSync spy for directLog testing.
  * By default mutes output (does nothing on write).
  * The spy will capture calls with file descriptor and buffer.
+ *
+ * Note: Requires fs module to be mocked at module level with jest.mock('fs')
  */
 async function withDirectLogMocks(options, fn) {
     const mute = options?.mute !== false; // default true
-    const noop = () => undefined;
-    const originalWriteSync = fs.writeSync;
-    const writeSync = jest
-        .spyOn(fs, 'writeSync')
-        .mockImplementation(mute
-        ? noop
-        : originalWriteSync);
+    // Get the mocked writeSync function
+    const writeSync = fs.writeSync;
+    // Store previous mock implementation if any
+    const previousImpl = writeSync.getMockImplementation();
+    // Set implementation based on mute option
+    if (mute) {
+        writeSync.mockImplementation(() => undefined);
+    }
+    else {
+        // Pass through - requires original implementation to be available
+        writeSync.mockImplementation((...args) => {
+            // In test environment, we can't easily call the real fs.writeSync
+            // so we just no-op but track the calls
+            return args[1]?.length || 0;
+        });
+    }
     const spies = { writeSync };
     try {
         return await fn(spies);
     }
     finally {
-        writeSync.mockRestore();
+        // Clear calls and restore previous implementation
+        writeSync.mockClear();
+        if (previousImpl) {
+            writeSync.mockImplementation(previousImpl);
+        }
     }
 }
 /**
  * Helper to check if writeSync was called with a specific file descriptor and message.
- * @param spy The writeSync spy
+ * @param spy The writeSync mock
  * @param fd The file descriptor (1 for stdout, 2 for stderr)
  * @param needles Substrings to search for in the buffer content
  */
@@ -46,7 +61,7 @@ function directLogContains(spy, fd, ...needles) {
 }
 /**
  * Get all messages written to a specific file descriptor.
- * @param spy The writeSync spy
+ * @param spy The writeSync mock
  * @param fd The file descriptor (1 for stdout, 2 for stderr)
  */
 function getDirectLogMessages(spy, fd) {

package/src/lib/mongoose-memory.d.ts

@@ -0,0 +1,14 @@
+import { Connection } from 'mongoose';
+/**
+ * Connect to in-memory MongoDB for testing
+ */
+export declare function connectMemoryDB(): Promise<Connection>;
+/**
+ * Drop all collections and disconnect
+ */
+export declare function disconnectMemoryDB(): Promise<void>;
+/**
+ * Clear all collections without disconnecting
+ */
+export declare function clearMemoryDB(): Promise<void>;
+//# sourceMappingURL=mongoose-memory.d.ts.map

package/src/lib/mongoose-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose-memory.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-test-utils/src/lib/mongoose-memory.ts"],"names":[],"mappings":"AACA,OAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAKhD;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC,CAY3D;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAWxD;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAOnD"}

package/src/lib/mongoose-memory.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectMemoryDB = connectMemoryDB;
+exports.disconnectMemoryDB = disconnectMemoryDB;
+exports.clearMemoryDB = clearMemoryDB;
+const tslib_1 = require("tslib");
+const mongodb_memory_server_1 = require("mongodb-memory-server");
+const mongoose_1 = tslib_1.__importDefault(require("mongoose"));
+let mongoServer;
+let connection;
+/**
+ * Connect to in-memory MongoDB for testing
+ */
+async function connectMemoryDB() {
+    if (connection && connection.readyState === 1) {
+        return connection;
+    }
+    mongoServer = await mongodb_memory_server_1.MongoMemoryServer.create();
+    const uri = mongoServer.getUri();
+    await mongoose_1.default.connect(uri);
+    connection = mongoose_1.default.connection;
+    return connection;
+}
+/**
+ * Drop all collections and disconnect
+ */
+async function disconnectMemoryDB() {
+    if (connection) {
+        await connection.dropDatabase();
+        await mongoose_1.default.disconnect();
+        connection = undefined;
+    }
+    if (mongoServer) {
+        await mongoServer.stop();
+        mongoServer = undefined;
+    }
+}
+/**
+ * Clear all collections without disconnecting
+ */
+async function clearMemoryDB() {
+    if (connection) {
+        const collections = connection.collections;
+        for (const key in collections) {
+            await collections[key].deleteMany({});
+        }
+    }
+}