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

package/README.md

@@ -97,12 +97,83 @@ it('should log message', async () => {
 });
 ```
 
+### Direct Log Mocks
+
+Mock `fs.writeSync` for testing direct console output:
+
+```typescript
+import { withDirectLogMocks, directLogContains, getDirectLogMessages } from '@digitaldefiance/express-suite-test-utils';
+import * as fs from 'fs';
+
+// Important: Mock fs module at module level before importing
+jest.mock('fs', () => ({
+  ...jest.requireActual('fs'),
+  writeSync: jest.fn(),
+}));
+
+it('should capture direct writes to stdout', async () => {
+  await withDirectLogMocks({ mute: true }, async (spies) => {
+    const buffer = Buffer.from('hello world\n', 'utf8');
+    fs.writeSync(1, buffer); // stdout
+    
+    expect(directLogContains(spies.writeSync, 1, 'hello', 'world')).toBe(true);
+    expect(getDirectLogMessages(spies.writeSync, 1)).toEqual(['hello world\n']);
+  });
+});
+```
+
+### Mongoose Memory Database
+
+In-memory MongoDB testing utilities using mongodb-memory-server:
+
+```typescript
+import { connectMemoryDB, disconnectMemoryDB, clearMemoryDB } from '@digitaldefiance/express-suite-test-utils';
+import { User } from './models/user';
+
+describe('User model', () => {
+  beforeAll(async () => {
+    await connectMemoryDB();
+  });
+
+  afterAll(async () => {
+    await disconnectMemoryDB();
+  });
+
+  afterEach(async () => {
+    await clearMemoryDB();
+  });
+
+  it('should validate user schema', async () => {
+    const user = new User({ username: 'test', email: 'test@example.com' });
+    await user.validate(); // Real Mongoose validation!
+    
+    await expect(async () => {
+      const invalid = new User({ username: 'ab' }); // too short
+      await invalid.validate();
+    }).rejects.toThrow();
+  });
+});
+```
+
+**Note:** Requires `mongoose` as a peer dependency and `mongodb-memory-server` as a dependency (already included).
+
 ## License
 
 MIT
 
 ## ChangeLog
 
+### v1.0.10
+
+- Fix direct-log mocks to work with non-configurable fs.writeSync in newer Node.js versions
+- Add comprehensive mongoose memory database testing utilities
+- Fix memory mongoose connectMemoryDB
+
+
+### 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.10",
   "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,18 @@
+import { Connection } from 'mongoose';
+/**
+ * Connect to in-memory MongoDB for testing
+ * @returns Object with both the connection and URI
+ */
+export declare function connectMemoryDB(): Promise<{
+    connection: Connection;
+    uri: string;
+}>;
+/**
+ * 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;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAsBxF;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,57 @@
+"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
+ * @returns Object with both the connection and URI
+ */
+async function connectMemoryDB() {
+    // If mongoose is connected but we don't have our server, disconnect first
+    if (mongoose_1.default.connection.readyState !== 0 && !mongoServer) {
+        await mongoose_1.default.disconnect();
+        connection = undefined;
+    }
+    // Create new server if needed
+    if (!mongoServer) {
+        mongoServer = await mongodb_memory_server_1.MongoMemoryServer.create();
+    }
+    const uri = mongoServer.getUri();
+    // Connect if not already connected
+    if (mongoose_1.default.connection.readyState === 0) {
+        await mongoose_1.default.connect(uri);
+    }
+    connection = mongoose_1.default.connection;
+    return { connection, uri };
+}
+/**
+ * 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({});
+        }
+    }
+}