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

package/README.md

@@ -14,24 +14,30 @@ yarn add @digitaldefiance/express-suite-test-utils
 
 ## Usage
 
-### Importing Test Utilities from node-express-suite
+### Importing Test Utilities from Express Suite Packages
 
-Test helpers and mocks from `@digitaldefiance/node-express-suite` are available via a separate entry point:
+Test helpers and mocks are available via separate `/testing` entry points:
 
 ```typescript
+// node-express-suite test helpers
 import { 
-  mockFunctions,
-  setupTestEnv,
-  // ... other test helpers
+  createApplicationMock,
+  setupTestEnv
 } from '@digitaldefiance/node-express-suite/testing';
 
+// node-ecies-lib test mocks
+import { mockBackendMember } from '@digitaldefiance/node-ecies-lib/testing';
+
+// ecies-lib test mocks
+import { mockFrontendMember } from '@digitaldefiance/ecies-lib/testing';
+
 // Use in your tests
 beforeAll(async () => {
   await setupTestEnv();
 });
 ```
 
-**Note:** These utilities require `@faker-js/faker` as a peer dependency:
+**Note:** All `/testing` entry points require `@faker-js/faker` as a peer dependency:
 
 ```bash
 npm install -D @faker-js/faker
@@ -97,6 +103,14 @@ MIT
 
 ## ChangeLog
 
+### v1.0.9
+
+- Add mongoose memory helpers
+
+### v1.0.8
+
+- Add directLog mocks
+
 ### v1.0.6
 
 - Add react mocks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/express-suite-test-utils",
-  "version": "1.0.7",
+  "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

@@ -1,6 +1,8 @@
 export * from './lib/to-throw-type';
 export * from './lib/console';
+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,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

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./lib/to-throw-type"), exports);
 tslib_1.__exportStar(require("./lib/console"), exports);
+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

@@ -0,0 +1,38 @@
+/**
+ * Spies returned from withDirectLogMocks
+ */
+export interface DirectLogSpies {
+    writeSync: jest.Mock;
+}
+/**
+ * Options for withDirectLogMocks
+ */
+export interface WithDirectLogOptions {
+    /**
+     * If false, do not mute the output (let it pass through).
+     * By default (true), mutes output.
+     */
+    mute?: boolean;
+}
+/**
+ * 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 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.Mock, fd: number, ...needles: string[]): boolean;
+/**
+ * Get all messages written to a specific file descriptor.
+ * @param spy The writeSync mock
+ * @param fd The file descriptor (1 for stdout, 2 for stderr)
+ */
+export declare function getDirectLogMessages(spy: jest.Mock, fd: number): string[];
+//# sourceMappingURL=direct-log.d.ts.map

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

@@ -0,0 +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,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

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withDirectLogMocks = withDirectLogMocks;
+exports.directLogContains = directLogContains;
+exports.getDirectLogMessages = getDirectLogMessages;
+const tslib_1 = require("tslib");
+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
+    // 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 {
+        // 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 mock
+ * @param fd The file descriptor (1 for stdout, 2 for stderr)
+ * @param needles Substrings to search for in the buffer content
+ */
+function directLogContains(spy, fd, ...needles) {
+    return spy.mock.calls.some((args) => {
+        const [calledFd, buffer] = args;
+        if (calledFd !== fd)
+            return false;
+        const text = buffer instanceof Buffer
+            ? buffer.toString('utf8')
+            : String(buffer);
+        return needles.every((n) => text.includes(n));
+    });
+}
+/**
+ * Get all messages written to a specific file descriptor.
+ * @param spy The writeSync mock
+ * @param fd The file descriptor (1 for stdout, 2 for stderr)
+ */
+function getDirectLogMessages(spy, fd) {
+    return spy.mock.calls
+        .filter((args) => args[0] === fd)
+        .map((args) => {
+        const buffer = args[1];
+        return buffer instanceof Buffer
+            ? buffer.toString('utf8')
+            : String(buffer);
+    });
+}

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({});
+        }
+    }
+}