@neoma/fixtures 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Shipdventures
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,133 @@
+# @neoma/fixtures
+
+Test fixtures for @neoma/* NestJS packages. Provides mock Express and NestJS objects, custom Jest matchers, and a mock logger for unit-testing NestJS building blocks (guards, interceptors, filters, pipes, middleware).
+
+## Installation
+
+```bash
+npm install --save-dev @neoma/fixtures
+```
+
+### Peer dependencies
+
+- `@nestjs/common` 11.x
+- `jest` >= 29.0.0
+- `@types/jest` >= 29.0.0
+
+## Usage
+
+### Express mocks
+
+```typescript
+import { express } from '@neoma/fixtures'
+import type { MockRequest, MockResponse } from '@neoma/fixtures'
+
+// Create a request with randomized defaults
+const req = express.request()
+
+// Override specific properties
+const customReq = express.request({
+  method: 'POST',
+  headers: { authorization: 'Bearer token' },
+  body: { name: 'test' },
+})
+
+// Case-insensitive header access
+req.get('Authorization')   // => 'Bearer token'
+req.get('authorization')   // => 'Bearer token'
+req.header('Authorization') // => 'Bearer token'
+
+// Create a response with locals and headers
+const res = express.response({
+  locals: { user: { id: 'abc' } },
+  headers: { 'Content-Type': 'text/html' },
+})
+
+// status() sets statusCode AND returns this for chaining
+res.status(404).json({ error: 'Not found' })
+expect(res.statusCode).toBe(404)
+expect(res.json).toHaveBeenCalledWith({ error: 'Not found' })
+
+// Mutable headers
+res.setHeader('X-Custom', 'value')
+res.getHeader('x-custom') // => 'value'
+
+// Create a signed cookie (HMAC-SHA256, cookie-parser format)
+const cookie = express.cookie('user123', 'my-secret')
+const jsonCookie = express.cookie({ userId: 'abc' }, 'my-secret')
+```
+
+### NestJS ExecutionContext
+
+```typescript
+import { executionContext, express } from '@neoma/fixtures'
+
+// Minimal context (just switchToHttp)
+const ctx = executionContext(req, res)
+ctx.switchToHttp().getRequest()  // => req
+ctx.switchToHttp().getResponse() // => res
+
+// With bare handler function (for isolated guard testing)
+const handler = (): void => {}
+Reflect.defineMetadata('roles', ['admin'], handler)
+const ctx = executionContext(req, res, handler)
+ctx.getHandler() // => handler
+ctx.getClass()   // => Object
+
+// With custom class
+const ctx = executionContext(req, res, handler, MyController)
+ctx.getClass() // => MyController
+
+// With typed route object (for integration-style testing)
+const ctx = executionContext(req, res, {
+  controller: UserController,
+  method: 'findAll',
+})
+ctx.getHandler() // => UserController.prototype.findAll
+ctx.getClass()   // => UserController
+```
+
+### MockLoggerService
+
+```typescript
+import { MockLoggerService } from '@neoma/fixtures'
+
+const logger = new MockLoggerService()
+// Use anywhere NestJS expects a LoggerService
+// All methods (log, error, warn, debug, verbose, trace, fatal, setLogLevels) are jest.fn()
+
+logger.error('something failed')
+expect(logger.error).toHaveBeenCalledWith('something failed')
+```
+
+### Custom Jest matchers
+
+Add to your Jest config's `setupFilesAfterEnv`:
+
+```json
+{
+  "setupFilesAfterEnv": ["@neoma/fixtures/matchers"]
+}
+```
+
+Then use in tests:
+
+```typescript
+// Check that a function throws a specific error class
+expect(() => service.register(email)).toThrowMatching(
+  EmailAlreadyExistsException,
+)
+
+// Check class + properties
+expect(() => service.register(email)).toThrowMatching(
+  EmailAlreadyExistsException,
+  { email: 'test@example.com' },
+)
+
+// Check an already-caught error
+expect(caughtError).toMatchError(NotFoundException, { message: 'Not found' })
+```
+
+## License
+
+MIT

package/dist/express/index.d.ts

@@ -0,0 +1,80 @@
+import { type IncomingHttpHeaders, type OutgoingHttpHeaders } from "http";
+import { type Socket } from "net";
+/**
+ * Mirrors the Express Response interface — method signatures match
+ * express.Response, not the underlying Node http.ServerResponse.
+ */
+export interface MockResponse {
+    statusCode?: number;
+    getHeaders(): OutgoingHttpHeaders;
+    get(name: string): string | undefined;
+    header(field: string, value?: string | Array<string>): MockResponse;
+    getHeader(name: string): string | number | string[] | undefined;
+    setHeader(name: string, value: string | string[]): MockResponse;
+    removeHeader(name: string): void;
+    cookie: jest.Mock;
+    clearCookie: jest.Mock;
+    end: jest.Mock;
+    status(code: number): MockResponse;
+    json: jest.Mock;
+    render: jest.Mock;
+    redirect: jest.Mock;
+    send: jest.Mock;
+    locals: Record<string, any>;
+}
+export interface MockRequest {
+    get(name: string): any;
+    header(name: string): any;
+    body: any;
+    headers: IncomingHttpHeaders;
+    method: string;
+    url: string;
+    res: MockResponse;
+    path: string;
+    params: Record<string, string>;
+    signedCookies: Record<string, string>;
+    connection: Socket;
+    [key: string]: any;
+}
+type ExpressFixtures = {
+    /**
+     * Creates a signed cookie string using the provided value and secret according
+     * to how the cookie-parser library would sign a cookie, i.e. HMAC-SHA256.
+     *
+     * @param val The cookie value to sign. If an object, it will be JSON.stringified
+     * with the `s:j:` prefix before signing.
+     * @param secret The secret to use to sign the cookie. If not provided, an unsigned
+     * cookie will be returned.
+     *
+     * @returns The signed value string only — no cookie name prefix, no flags.
+     * Format: `${encodedPrefix}${value}.${encodedSignature}`
+     */
+    cookie(val: string | object, secret?: string): string;
+    /**
+     * Creates a MockResponse with status, json, and header functions that
+     * are instances of a jest.Mock and with a locals property.
+     *
+     * @param options.locals Any locals to populate the response's locals property.
+     * @param options.headers Any headers to set on the response. They will be accessible through
+     * both the getHeaders and get functions.
+     *
+     * @returns A MockResponse with status, get, getHeaders, getHeader, setHeader,
+     * removeHeader, json, header, render, redirect, send, cookie, clearCookie,
+     * and end functions, and a locals property.
+     */
+    response: (options?: {
+        locals?: Record<string, any>;
+        headers?: OutgoingHttpHeaders;
+    }) => MockResponse;
+    /**
+     * Creates a MockRequest with body, and headers properties, and a mock response
+     * object. Also adds convenience methods get and header to provide case insensitive
+     * access to the request headers.
+     *
+     * @param req A Partial MockRequest to provide values for body, headers, and res objects,
+     * and get, and headers functions. Any properties not provided will use sensible defaults.
+     */
+    request: (options?: Partial<MockRequest>) => MockRequest;
+};
+export declare const express: ExpressFixtures;
+export {};

package/dist/express/index.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.express = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const faker_1 = require("@faker-js/faker");
+const { helpers, internet, system } = faker_1.faker;
+const caseInsensitiveSearch = (obj, key) => {
+    return obj[key.toLowerCase()];
+};
+const convertHeadersToLowerCase = (headers = {}) => {
+    const result = {};
+    for (const key of Object.keys(headers)) {
+        result[key.toLowerCase()] = headers[key];
+    }
+    return result;
+};
+exports.express = {
+    cookie(val, secret) {
+        const cookieValue = typeof val === "string" ? val : `j:${JSON.stringify(val)}`;
+        const prefix = "s:";
+        if (!secret) {
+            return `${encodeURIComponent(prefix)}${cookieValue}`;
+        }
+        const signature = crypto_1.default
+            .createHmac("sha256", secret)
+            .update(cookieValue)
+            .digest("base64")
+            .replace(/=+$/, "");
+        return `${encodeURIComponent(prefix)}${cookieValue}.${encodeURIComponent(signature)}`;
+    },
+    response({ locals = {}, headers = {}, } = {
+        locals: {},
+        headers: {},
+    }) {
+        const clonedHeaders = convertHeadersToLowerCase(headers);
+        return {
+            getHeaders() {
+                return clonedHeaders;
+            },
+            get(name) {
+                return caseInsensitiveSearch(clonedHeaders, name);
+            },
+            header(field, value) {
+                clonedHeaders[field.toLowerCase()] = value;
+                return this;
+            },
+            getHeader(name) {
+                return clonedHeaders[name.toLowerCase()];
+            },
+            setHeader(name, value) {
+                clonedHeaders[name.toLowerCase()] = value;
+                return this;
+            },
+            removeHeader(name) {
+                delete clonedHeaders[name];
+                delete clonedHeaders[name.toLowerCase()];
+            },
+            cookie: jest.fn().mockReturnThis(),
+            clearCookie: jest.fn().mockReturnThis(),
+            end: jest.fn().mockReturnThis(),
+            status(code) {
+                this.statusCode = code;
+                return this;
+            },
+            json: jest.fn().mockReturnThis(),
+            render: jest.fn(),
+            redirect: jest.fn().mockReturnThis(),
+            send: jest.fn().mockReturnThis(),
+            locals,
+        };
+    },
+    request({ body = {}, headers = {}, method = helpers.arrayElement(["GET", "POST", "PUT", "DELETE", "PATCH"]), url = internet.url(), res = exports.express.response(), path = system.filePath(), params = {}, signedCookies = {}, } = {
+        body: {},
+        headers: {},
+        method: helpers.arrayElement(["GET", "POST", "PUT", "DELETE", "PATCH"]),
+        url: internet.url(),
+        res: exports.express.response(),
+        path: system.filePath(),
+        params: {},
+        signedCookies: {},
+    }) {
+        // Build the base object with the arguments spread, then normalize headers
+        // afterward so that the spread cannot re-add un-normalized keys.
+        const base = {
+            body,
+            method,
+            url,
+            res,
+            path,
+            params,
+            signedCookies,
+            // eslint-disable-next-line prefer-rest-params
+            ...arguments[0],
+        };
+        const normalizedHeaders = convertHeadersToLowerCase(base.headers ?? headers);
+        return {
+            get(name) {
+                return normalizedHeaders[name.toLowerCase()];
+            },
+            header(name) {
+                return normalizedHeaders[name.toLowerCase()];
+            },
+            ...base,
+            headers: normalizedHeaders,
+            // Must include the connection so that the Bunyan req serializer treats it as a real request.
+            connection: {},
+        };
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/express/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/express/index.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { express } from "./express";
+export type { MockRequest, MockResponse } from "./express";
+export { executionContext } from "./nestjs";
+export { MockLoggerService } from "./loggers";

package/dist/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockLoggerService = exports.executionContext = exports.express = void 0;
+// Express mocks — mock request, response, and signed cookie helpers
+var express_1 = require("./express");
+Object.defineProperty(exports, "express", { enumerable: true, get: function () { return express_1.express; } });
+// NestJS mocks — partial ExecutionContext for guard/interceptor/filter tests
+var nestjs_1 = require("./nestjs");
+Object.defineProperty(exports, "executionContext", { enumerable: true, get: function () { return nestjs_1.executionContext; } });
+// Logger mock — implements LoggerService with jest.fn() methods
+var loggers_1 = require("./loggers");
+Object.defineProperty(exports, "MockLoggerService", { enumerable: true, get: function () { return loggers_1.MockLoggerService; } });
+// Custom matchers are loaded separately via Jest setupFilesAfterEnv:
+//   import '@neoma/fixtures/matchers'
+// They are NOT re-exported here — they self-register via expect.extend().
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,oEAAoE;AACpE,qCAAmC;AAA1B,kGAAA,OAAO,OAAA;AAGhB,6EAA6E;AAC7E,mCAA2C;AAAlC,0GAAA,gBAAgB,OAAA;AAEzB,gEAAgE;AAChE,qCAA6C;AAApC,4GAAA,iBAAiB,OAAA;AAE1B,qEAAqE;AACrE,sCAAsC;AACtC,0EAA0E"}

package/dist/loggers/index.d.ts

@@ -0,0 +1,23 @@
+import { type LoggerService } from "@nestjs/common";
+/**
+ * A mock service for representing the LoggerService in tests.
+ *
+ * @property debug A jest function that mocks the debug method from LoggerService.
+ * @property error A jest function that mocks the error method from LoggerService.
+ * @property fatal A jest function that mocks the fatal method from LoggerService.
+ * @property log A jest function that mocks the log method from LoggerService.
+ * @property trace A jest function that mocks the trace method from LoggerService.
+ * @property verbose A jest function that mocks the optional verbose method from LoggerService.
+ * @property warn A jest function that mocks the warn method from LoggerService.
+ * @property setLogLevels A jest function that mocks the optional setLogLevels method from LoggerService.
+ */
+export declare class MockLoggerService implements LoggerService {
+    debug: jest.Mock<any, any, any>;
+    error: jest.Mock<any, any, any>;
+    fatal: jest.Mock<any, any, any>;
+    log: jest.Mock<any, any, any>;
+    trace: jest.Mock<any, any, any>;
+    verbose: jest.Mock<any, any, any>;
+    warn: jest.Mock<any, any, any>;
+    setLogLevels: jest.Mock<any, any, any>;
+}

package/dist/loggers/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockLoggerService = void 0;
+/**
+ * A mock service for representing the LoggerService in tests.
+ *
+ * @property debug A jest function that mocks the debug method from LoggerService.
+ * @property error A jest function that mocks the error method from LoggerService.
+ * @property fatal A jest function that mocks the fatal method from LoggerService.
+ * @property log A jest function that mocks the log method from LoggerService.
+ * @property trace A jest function that mocks the trace method from LoggerService.
+ * @property verbose A jest function that mocks the optional verbose method from LoggerService.
+ * @property warn A jest function that mocks the warn method from LoggerService.
+ * @property setLogLevels A jest function that mocks the optional setLogLevels method from LoggerService.
+ */
+class MockLoggerService {
+    debug = jest.fn();
+    error = jest.fn();
+    fatal = jest.fn();
+    log = jest.fn();
+    trace = jest.fn();
+    verbose = jest.fn();
+    warn = jest.fn();
+    setLogLevels = jest.fn();
+}
+exports.MockLoggerService = MockLoggerService;
+//# sourceMappingURL=index.js.map

package/dist/loggers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/loggers/index.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;GAWG;AACH,MAAa,iBAAiB;IACrB,KAAK,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;IACjB,KAAK,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;IACjB,KAAK,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;IACjB,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;IACf,KAAK,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;IACjB,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;IACnB,IAAI,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;IAChB,YAAY,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;CAChC;AATD,8CASC"}

package/dist/matchers/index.d.ts

@@ -0,0 +1,23 @@
+declare global {
+    namespace jest {
+        interface Matchers<R> {
+            /**
+             * Checks if a function throws an instance of an error class, optionally
+             * with specific properties.
+             *
+             * @param ErrorClass The expected error class/constructor
+             * @param expectedProps Optional object of properties to match
+             */
+            toThrowMatching<T>(ErrorClass: new (...args: any[]) => T, expectedProps?: Partial<T>): R;
+            /**
+             * Checks if a value is an instance of an error class, optionally
+             * with specific properties.
+             *
+             * @param ErrorClass The expected error class/constructor
+             * @param expectedProps Optional object of properties to match
+             */
+            toMatchError<T>(ErrorClass: new (...args: any[]) => T, expectedProps?: Partial<T>): R;
+        }
+    }
+}
+export {};

package/dist/matchers/index.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_util_1 = require("node:util");
+const jest_matcher_utils_1 = require("jest-matcher-utils");
+const checkErrorInstance = (subject, ErrorClass, expectedProps) => {
+    // Check type
+    if (!(subject instanceof ErrorClass)) {
+        return {
+            pass: false,
+            message: () => 
+            // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- falsy check is intentional for constructor name fallback
+            `Expected ${(0, jest_matcher_utils_1.EXPECTED_COLOR)(ErrorClass.name)} but got ${(0, jest_matcher_utils_1.RECEIVED_COLOR)(subject?.constructor?.name || typeof subject)}`,
+        };
+    }
+    // If no props specified, just type check passes
+    if (!expectedProps) {
+        return {
+            pass: true,
+            message: () => `Expected not to be ${(0, jest_matcher_utils_1.EXPECTED_COLOR)(ErrorClass.name)}`,
+        };
+    }
+    // Check properties
+    for (const [key, value] of Object.entries(expectedProps)) {
+        if (!(0, node_util_1.isDeepStrictEqual)(subject[key], value)) {
+            return {
+                pass: false,
+                message: () => `Expected ${(0, jest_matcher_utils_1.EXPECTED_COLOR)(ErrorClass.name)} with ${(0, jest_matcher_utils_1.EXPECTED_COLOR)(`${key}: ${JSON.stringify(value)}`)}, got ${(0, jest_matcher_utils_1.RECEIVED_COLOR)(`${key}: ${JSON.stringify(subject[key])}`)}`,
+            };
+        }
+    }
+    return {
+        pass: true,
+        message: () => `Expected not to be ${(0, jest_matcher_utils_1.EXPECTED_COLOR)(ErrorClass.name)} with given properties`,
+    };
+};
+const toThrowMatching = (subject, ErrorClass, expectedProps) => {
+    if (!(subject instanceof Function)) {
+        return {
+            pass: false,
+            message: () => `toThrowMatching requires a function, but received ${(0, jest_matcher_utils_1.RECEIVED_COLOR)(typeof subject)}. Use toMatchError to check an already-caught error.`,
+        };
+    }
+    try {
+        subject();
+        return {
+            pass: false,
+            message: () => `Expected function to throw ${(0, jest_matcher_utils_1.EXPECTED_COLOR)(ErrorClass.name)}, but it did not throw`,
+        };
+    }
+    catch (e) {
+        return checkErrorInstance(e, ErrorClass, expectedProps);
+    }
+};
+const toMatchError = (subject, ErrorClass, expectedProps) => {
+    if (subject instanceof Function) {
+        return {
+            pass: false,
+            message: () => `toMatchError requires an error instance, but received a function. Use toThrowMatching to assert on a throwing function.`,
+        };
+    }
+    return checkErrorInstance(subject, ErrorClass, expectedProps);
+};
+expect.extend({
+    toThrowMatching,
+    toMatchError,
+});
+//# sourceMappingURL=index.js.map

package/dist/matchers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/matchers/index.ts"],"names":[],"mappings":";;AAAA,yCAA6C;AAE7C,2DAAmE;AAEnE,MAAM,kBAAkB,GAAG,CACzB,OAAgB,EAChB,UAAyC,EACzC,aAAuC,EACb,EAAE;IAC5B,aAAa;IACb,IAAI,CAAC,CAAC,OAAO,YAAY,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,GAAG,EAAE;YACZ,oIAAoI;YACpI,YAAY,IAAA,mCAAc,EAAC,UAAU,CAAC,IAAI,CAAC,YAAY,IAAA,mCAAc,EAAE,OAAe,EAAE,WAAW,EAAE,IAAI,IAAI,OAAO,OAAO,CAAC,EAAE;SACjI,CAAA;IACH,CAAC;IAED,gDAAgD;IAChD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO;YACL,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,GAAG,EAAE,CAAC,sBAAsB,IAAA,mCAAc,EAAC,UAAU,CAAC,IAAI,CAAC,EAAE;SACvE,CAAA;IACH,CAAC;IAED,mBAAmB;IACnB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACzD,IAAI,CAAC,IAAA,6BAAiB,EAAE,OAAe,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;YACrD,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE,GAAG,EAAE,CACZ,YAAY,IAAA,mCAAc,EAAC,UAAU,CAAC,IAAI,CAAC,SAAS,IAAA,mCAAc,EAAC,GAAG,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,IAAA,mCAAc,EAAC,GAAG,GAAG,KAAK,IAAI,CAAC,SAAS,CAAE,OAAe,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE;aACtL,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,GAAG,EAAE,CACZ,sBAAsB,IAAA,mCAAc,EAAC,UAAU,CAAC,IAAI,CAAC,wBAAwB;KAChF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,CACtB,OAAgB,EAChB,UAAyC,EACzC,aAAuC,EACb,EAAE;IAC5B,IAAI,CAAC,CAAC,OAAO,YAAY,QAAQ,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,GAAG,EAAE,CACZ,qDAAqD,IAAA,mCAAc,EAAC,OAAO,OAAO,CAAC,sDAAsD;SAC5I,CAAA;IACH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,EAAE,CAAA;QACT,OAAO;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,GAAG,EAAE,CACZ,8BAA8B,IAAA,mCAAc,EAAC,UAAU,CAAC,IAAI,CAAC,wBAAwB;SACxF,CAAA;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,kBAAkB,CAAC,CAAC,EAAE,UAAU,EAAE,aAAa,CAAC,CAAA;IACzD,CAAC;AACH,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CACnB,OAAgB,EAChB,UAAyC,EACzC,aAAuC,EACb,EAAE;IAC5B,IAAI,OAAO,YAAY,QAAQ,EAAE,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,GAAG,EAAE,CACZ,yHAAyH;SAC5H,CAAA;IACH,CAAC;IAED,OAAO,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,CAAC,CAAA;AAC/D,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,CAAC;IACZ,eAAe;IACf,YAAY;CACb,CAAC,CAAA"}

package/dist/nestjs/index.d.ts

@@ -0,0 +1,24 @@
+import { type ExecutionContext } from "@nestjs/common";
+import { type MockRequest, type MockResponse } from "../express";
+/**
+ * Creates a partial ExecutionContext with a switchToHttp method that then allows
+ * access to req and res through getRequest and getResponse methods respectively.
+ *
+ * ExecutionContext extends ArgumentsHost so use this function to create
+ * ArgumentsHosts too.
+ *
+ * @param req A MockRequest that is returned when switchToHttp().getRequest is called.
+ * @param res A MockResponse that is returned when switchToHttp().getResponse is called.
+ * @param handler Either a bare handler function (for isolated guard testing where
+ * metadata is applied with Reflect.defineMetadata) or a typed route object (for
+ * integration-style testing where metadata lives on a real controller). When omitted,
+ * getHandler and getClass are not included on the returned context.
+ * @param cls An optional class returned by getClass(). Only meaningful when handler
+ * is a bare function; ignored when handler is a route object. Defaults to Object.
+ * @returns A partial ExecutionContext that supports switchToHttp and, when a handler
+ * is supplied, getHandler/getClass.
+ */
+export declare const executionContext: (req?: MockRequest, res?: MockResponse, handler?: (() => void) | {
+    controller: new (...args: any[]) => any;
+    method: string;
+}, cls?: new (...args: any[]) => any) => Partial<ExecutionContext>;

package/dist/nestjs/index.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executionContext = void 0;
+const express_1 = require("../express");
+/**
+ * Creates a partial ExecutionContext with a switchToHttp method that then allows
+ * access to req and res through getRequest and getResponse methods respectively.
+ *
+ * ExecutionContext extends ArgumentsHost so use this function to create
+ * ArgumentsHosts too.
+ *
+ * @param req A MockRequest that is returned when switchToHttp().getRequest is called.
+ * @param res A MockResponse that is returned when switchToHttp().getResponse is called.
+ * @param handler Either a bare handler function (for isolated guard testing where
+ * metadata is applied with Reflect.defineMetadata) or a typed route object (for
+ * integration-style testing where metadata lives on a real controller). When omitted,
+ * getHandler and getClass are not included on the returned context.
+ * @param cls An optional class returned by getClass(). Only meaningful when handler
+ * is a bare function; ignored when handler is a route object. Defaults to Object.
+ * @returns A partial ExecutionContext that supports switchToHttp and, when a handler
+ * is supplied, getHandler/getClass.
+ */
+const executionContext = (req = express_1.express.request(), res = req.res, handler, cls) => {
+    req.res = res;
+    let resolvedHandler;
+    let resolvedClass;
+    if (typeof handler === "function") {
+        // Features pattern: bare handler + optional class
+        resolvedHandler = handler;
+        resolvedClass = cls ?? Object;
+    }
+    else if (handler) {
+        // Garmr pattern: typed route object
+        resolvedHandler = handler.controller.prototype[handler.method];
+        resolvedClass = handler.controller;
+    }
+    return {
+        switchToHttp: jest.fn().mockReturnValue({
+            getResponse: jest.fn().mockReturnValue(res),
+            getRequest: jest.fn().mockReturnValue(req),
+        }),
+        ...(resolvedHandler && {
+            getHandler: jest.fn().mockReturnValue(resolvedHandler),
+            getClass: jest.fn().mockReturnValue(resolvedClass),
+        }),
+    };
+};
+exports.executionContext = executionContext;
+//# sourceMappingURL=index.js.map

package/dist/nestjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":";;;AAEA,wCAAyE;AAEzE;;;;;;;;;;;;;;;;;GAiBG;AACI,MAAM,gBAAgB,GAAG,CAC9B,MAAmB,iBAAO,CAAC,OAAO,EAAE,EACpC,MAAoB,GAAG,CAAC,GAAG,EAC3B,OAE+D,EAC/D,GAAiC,EACN,EAAE;IAC7B,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IAEb,IAAI,eAAyC,CAAA;IAC7C,IAAI,aAAwD,CAAA;IAE5D,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,kDAAkD;QAClD,eAAe,GAAG,OAAO,CAAA;QACzB,aAAa,GAAG,GAAG,IAAI,MAAM,CAAA;IAC/B,CAAC;SAAM,IAAI,OAAO,EAAE,CAAC;QACnB,oCAAoC;QACpC,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAC9D,aAAa,GAAG,OAAO,CAAC,UAAU,CAAA;IACpC,CAAC;IAED,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC;YACtC,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC;YAC3C,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC;SAC3C,CAAC;QACF,GAAG,CAAC,eAAe,IAAI;YACrB,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,eAAe,CAAC;YACtD,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,aAAa,CAAC;SACnD,CAAC;KACH,CAAA;AACH,CAAC,CAAA;AAjCY,QAAA,gBAAgB,oBAiC5B"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@neoma/fixtures",
+  "version": "0.1.0",
+  "description": "Test fixtures for @neoma/* NestJS packages",
+  "author": "Shipdventures",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shipdventures/neoma-fixtures"
+  },
+  "bugs": {
+    "url": "https://github.com/shipdventures/neoma-fixtures/issues"
+  },
+  "homepage": "https://github.com/shipdventures/neoma-fixtures#readme",
+  "keywords": [
+    "nestjs",
+    "fixtures",
+    "testing",
+    "neoma"
+  ],
+  "private": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "_comment": "This package uses an exports map instead of main+types only because the ./matchers sub-path must be loadable independently via Jest setupFilesAfterEnv without importing the main entry point.",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./matchers": {
+      "require": "./dist/matchers/index.js",
+      "types": "./dist/matchers/index.d.ts"
+    }
+  },
+  "scripts": {
+    "prepublishOnly": "cp ../../README.md ../../LICENSE ."
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "!**/*.json",
+    "!**/*.tsbuildinfo"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@nestjs/common": "11.x",
+    "@types/jest": ">=29.0.0",
+    "jest": ">=29.0.0"
+  },
+  "dependencies": {
+    "@faker-js/faker": "^9.0.0"
+  }
+}