@molecule/api-mock-server 1.0.0

package/dist/server/middleware.js

@@ -0,0 +1,124 @@
+/**
+ * State control middleware for the mock server.
+ * Allows per-request state overrides via query params or headers.
+ *
+ * Query params: ?_state=error&_delay=2000&_status=500
+ * Headers: X-Mock-State: error, X-Mock-Delay: 2000
+ */
+/**
+ * Express middleware that extracts state control signals from the request
+ * and attaches them to res.locals for the route handler to use.
+ * @param defaultState - The default state to use when no override is provided.
+ *   Pass a function to have the default resolved per-request (a live getter) —
+ *   required for `MockServer.setDefaultState()` to take effect after startup,
+ *   since a plain object is captured once at middleware-creation time.
+ * @returns Express middleware function
+ */
+export function stateControlMiddleware(defaultState = { state: 'success' }) {
+    return (req, res, next) => {
+        // A repeated query param (?_state=a&_state=b) parses as an array — only
+        // accept plain strings so a malformed URL can't crash the middleware.
+        const queryString = (name) => {
+            const value = req.query[name];
+            return typeof value === 'string' ? value : undefined;
+        };
+        // Extract state from query params or headers
+        const stateParam = queryString('_state') || req.get('X-Mock-State');
+        const delayParam = queryString('_delay') || req.get('X-Mock-Delay');
+        const statusParam = queryString('_status') || req.get('X-Mock-Status');
+        const base = typeof defaultState === 'function' ? defaultState() : defaultState;
+        const state = { ...base };
+        if (stateParam) {
+            const normalized = stateParam.toLowerCase().trim();
+            if (['success', 'empty', 'error', 'unauthorized'].includes(normalized)) {
+                state.state = normalized;
+            }
+            else {
+                // A typo'd ?_state (e.g. `?_state=eror`) would otherwise silently serve
+                // the DEFAULT state — indistinguishable from the override never having
+                // been sent, which reads as "the mock ignores my state control". Label
+                // the response so a caller can tell "invalid state value" apart from
+                // "state applied".
+                res.setHeader('X-Mock-Invalid-State', stateParam);
+            }
+        }
+        if (delayParam) {
+            const delay = Number(delayParam);
+            if (!isNaN(delay) && delay >= 0) {
+                state.delay = delay;
+            }
+        }
+        if (statusParam) {
+            const status = Number(statusParam);
+            if (!isNaN(status) && status >= 100 && status < 600) {
+                state.statusCode = status;
+            }
+        }
+        // Attach to res.locals for route handlers
+        res.locals.mockState = state;
+        next();
+    };
+}
+/**
+ * CORS middleware that sets permissive CORS headers for development.
+ * @returns Express middleware function
+ */
+export function corsMiddleware() {
+    return (_req, res, next) => {
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS, PATCH');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, X-Mock-State, X-Mock-Delay, X-Mock-Status');
+        res.setHeader('Access-Control-Max-Age', '86400');
+        if (_req.method === 'OPTIONS') {
+            res.status(204).end();
+            return;
+        }
+        next();
+    };
+}
+/**
+ * Request logging middleware for the mock server.
+ * @returns Express middleware function
+ */
+export function loggingMiddleware() {
+    return (req, _res, next) => {
+        const state = _res.locals.mockState?.state ?? 'success';
+        const timestamp = new Date().toISOString().substring(11, 23);
+        console.log(`[mock-server ${timestamp}] ${req.method} ${req.path} (state: ${state})`);
+        next();
+    };
+}
+/**
+ * Maximum delay, in ms, that {@link applyDelay} will actually wait — a
+ * requested delay above this is clamped (and logged) rather than honored
+ * verbatim. Guards against a stray oversized `?_delay` / `X-Mock-Delay` /
+ * `defaultDelay` / `setState({ delay })` value (e.g. a units mistake
+ * applying `*1000` twice) hanging a request until the CLIENT gives up —
+ * which in an E2E harness presents as an inexplicable page timeout rather
+ * than an obvious mock misconfiguration.
+ */
+export const MAX_MOCK_DELAY_MS = 60_000;
+/**
+ * Apply a delay if specified in the response state. The requested delay is
+ * capped at {@link MAX_MOCK_DELAY_MS} — a value above the cap is clamped and
+ * a warning is logged (via `console.warn`, immediately, before waiting —
+ * not after — so the clamp is visible in server logs right when the
+ * oversized delay is requested rather than a minute later).
+ * @param state - The response state that may contain a delay
+ * @returns A promise that resolves after the (possibly clamped) delay, or
+ *   immediately if no delay was requested
+ */
+export function applyDelay(state) {
+    const requested = state.delay;
+    if (!requested || requested <= 0) {
+        return Promise.resolve();
+    }
+    const delay = Math.min(requested, MAX_MOCK_DELAY_MS);
+    if (delay !== requested) {
+        console.warn(`[mock-server] requested delay ${requested}ms exceeds the ${MAX_MOCK_DELAY_MS}ms cap — ` +
+            `clamping to ${delay}ms. Check for a units mistake (e.g. seconds*1000 applied twice) ` +
+            `in ?_delay / X-Mock-Delay / defaultDelay / setState({ delay }).`);
+    }
+    return new Promise((resolve) => setTimeout(resolve, delay));
+}
+//# sourceMappingURL=middleware.js.map

package/dist/server/middleware.js.map

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

package/dist/server/server.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Express-based mock HTTP server that serves fixture responses.
+ * Supports programmatic control of response states and delays.
+ */
+import type { MockServer, MockServerConfig } from '../types.js';
+/**
+ * Create and start a mock API server for the given app type.
+ * The server discovers endpoints by scanning handler templates and
+ * serves deterministic fixture data for each discovered route.
+ *
+ * @param config - Server configuration
+ * @returns A running MockServer instance with control methods
+ *
+ * @example
+ * ```typescript
+ * const server = await createMockServer({
+ *   appType: 'personal-finance',
+ *   port: 4000,
+ * })
+ *
+ * // Control state programmatically
+ * server.setState('GET /accounts', { state: 'error', statusCode: 500 })
+ *
+ * // Teardown
+ * await server.close()
+ * ```
+ */
+export declare function createMockServer(config: MockServerConfig): Promise<MockServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,OAAO,KAAK,EAGV,UAAU,EACV,gBAAgB,EAEjB,MAAM,aAAa,CAAA;AAQpB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8LpF"}

package/dist/server/server.js

@@ -0,0 +1,314 @@
+/**
+ * Express-based mock HTTP server that serves fixture responses.
+ * Supports programmatic control of response states and delays.
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import express from 'express';
+import { buildFixtureSet, generateFixtures } from '../fixtures/app-fixtures.js';
+import { resolveHandlersPath, scanHandlers } from '../scanner/scanner.js';
+import { getResponseBody, getStatusCode } from '../states/states.js';
+import { applyDelay, corsMiddleware, loggingMiddleware, stateControlMiddleware, } from './middleware.js';
+/**
+ * Create and start a mock API server for the given app type.
+ * The server discovers endpoints by scanning handler templates and
+ * serves deterministic fixture data for each discovered route.
+ *
+ * @param config - Server configuration
+ * @returns A running MockServer instance with control methods
+ *
+ * @example
+ * ```typescript
+ * const server = await createMockServer({
+ *   appType: 'personal-finance',
+ *   port: 4000,
+ * })
+ *
+ * // Control state programmatically
+ * server.setState('GET /accounts', { state: 'error', statusCode: 500 })
+ *
+ * // Teardown
+ * await server.close()
+ * ```
+ */
+export async function createMockServer(config) {
+    const { appType, fixturesPath, port = 4000, defaultDelay = 0, defaultState = 'success', endpointStates = {}, handlersPath, customFixtures, logging = true, } = config;
+    // Build fixture set
+    let fixtures;
+    if (customFixtures) {
+        fixtures = customFixtures;
+    }
+    else {
+        // Generate fixtures from directory path or throw
+        const resolvedFixturesPath = fixturesPath ?? resolveFixturesPath(appType);
+        if (!resolvedFixturesPath) {
+            throw new Error(`No fixture data available for app type: ${appType}. Pass fixturesPath ` +
+                `(a directory of *.json fixture files, e.g. './api/fixtures'). ` +
+                `Resolving by appType alone looks up mlcl/templates/apps/${appType}/api/fixtures/ ` +
+                `and only works inside the molecule workspace — in a scaffolded project, fixturesPath is required.`);
+        }
+        const generated = generateFixtures(resolvedFixturesPath, appType);
+        if (!generated) {
+            throw new Error(`No fixture data available at path: ${resolvedFixturesPath} — ` +
+                `the directory is missing or contains no *.json fixture files.`);
+        }
+        fixtures = generated;
+        // If handler files exist, scan them and merge any endpoints not already covered
+        const resolvedHandlersPath = handlersPath ?? resolveHandlersPath(appType);
+        if (resolvedHandlersPath) {
+            try {
+                const scanResult = scanHandlers(resolvedHandlersPath, appType);
+                const scanned = buildFixtureSet(appType, scanResult.endpoints, resolvedFixturesPath);
+                if (scanned) {
+                    // Directory fixtures key endpoints as `GET /api/x`; the scanner keys
+                    // them as `GET /x` (the router.use prefix has no /api). Normalize so
+                    // the two sets reconcile instead of double-registering.
+                    const norm = (k) => k.replace(/^(\w+) (?!\/api\/)\//, '$1 /api/');
+                    const dirKeys = new Set([...fixtures.endpoints.keys()].map(norm));
+                    for (const [key, fixture] of scanned.endpoints) {
+                        const nk = norm(key);
+                        if (!dirKeys.has(nk)) {
+                            // Scanner-discovered endpoint not covered by a fixture file.
+                            fixtures.endpoints.set(nk, fixture);
+                        }
+                        else if (fixture.endpoint.responseHints.isPaginated) {
+                            // Endpoint exists in both: the directory fixture defaults a list
+                            // GET to a bare array, but the handler actually returns a
+                            // `{ data, total }` envelope — re-wrap the directory fixture's
+                            // data so the response shape matches what app pages expect.
+                            const dir = fixtures.endpoints.get(nk);
+                            if (dir && Array.isArray(dir.successResponse)) {
+                                const arr = dir.successResponse;
+                                dir.successResponse = { data: arr, total: arr.length };
+                                dir.emptyResponse = { data: [], total: 0 };
+                                dir.endpoint.responseHints.isPaginated = true;
+                            }
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                // Scanner enrichment is best-effort: a scan failure must not stop the
+                // fixture-file endpoints from serving. But a SILENT failure made an
+                // explicitly passed handlersPath look ignored (its endpoints just
+                // "missing" with no signal), so surface the reason when logging is on.
+                if (logging) {
+                    console.warn(`[mock-server] handler scan failed for ${resolvedHandlersPath} — serving fixture-file endpoints only: ${error.message}`);
+                }
+            }
+        }
+    }
+    // Per-endpoint state overrides (mutable at runtime)
+    const stateOverrides = new Map(Object.entries(endpointStates));
+    let currentDefaultState = {
+        state: defaultState,
+        delay: defaultDelay,
+    };
+    // Create Express app
+    const app = express();
+    app.use(express.json());
+    app.use(corsMiddleware());
+    // Pass a getter, not the object: setDefaultState() reassigns
+    // currentDefaultState, and a captured object would freeze the default at
+    // its startup value (making setDefaultState a silent no-op).
+    app.use(stateControlMiddleware(() => currentDefaultState));
+    if (logging) {
+        app.use(loggingMiddleware());
+    }
+    // Register routes from fixtures — static paths before `:param` siblings.
+    // Express matches in registration order, so the dir-CRUD `GET /profile/:id`
+    // route would otherwise shadow a scanner-discovered `GET /profile/me`
+    // (`:id` = 'me') and serve the raw fixture record instead of the handler's
+    // synthesized single-object response shape. Sort is stable, so ordering
+    // within the same param count is preserved.
+    const routeEntries = [...fixtures.endpoints.entries()].sort(([, a], [, b]) => paramCount(a.endpoint.path) - paramCount(b.endpoint.path));
+    for (const [key, fixture] of routeEntries) {
+        registerRoute(app, key, fixture, stateOverrides, () => currentDefaultState);
+    }
+    // Health check endpoint
+    app.get('/health', (_req, res) => {
+        res.json({ status: 'ok', appType, endpoints: fixtures.endpoints.size });
+    });
+    // Catch-all for unmatched API routes (Express 5 path-to-regexp syntax).
+    // Unmatched routes intentionally return an empty SUCCESS (screenshot/E2E
+    // pages must render, not 404) — but that makes a typo'd endpoint look
+    // identical to legitimately-empty data. The X-Mock-Unmatched header (and a
+    // warn log) lets a caller/debugger tell "no such fixture endpoint" apart
+    // from "endpoint exists and its data is empty".
+    app.all('/api/{*path}', (req, res) => {
+        res.setHeader('X-Mock-Unmatched', 'true');
+        if (logging) {
+            console.warn(`[mock-server] no fixture endpoint matches ${req.method} ${req.path} — serving default empty response (X-Mock-Unmatched: true)`);
+        }
+        const state = res.locals.mockState;
+        if (state?.state === 'error') {
+            res.status(500).json({ error: 'Internal server error' });
+            return;
+        }
+        if (state?.state === 'unauthorized') {
+            res.status(401).json({ error: 'Unauthorized' });
+            return;
+        }
+        // Return empty success for unmatched routes
+        if (req.method === 'GET') {
+            res.json([]);
+        }
+        else if (req.method === 'DELETE') {
+            res.status(204).end();
+        }
+        else {
+            res.json({});
+        }
+    });
+    // Start server
+    const server = await startServer(app, port);
+    const actualPort = server.address().port;
+    if (logging) {
+        console.log(`\n  Mock API server running at http://localhost:${actualPort}`);
+        console.log(`  App type: ${appType}`);
+        console.log(`  Endpoints: ${fixtures.endpoints.size}`);
+        console.log(`  Default state: ${defaultState}\n`);
+    }
+    return {
+        port: actualPort,
+        appType,
+        setState(endpointKey, state) {
+            stateOverrides.set(endpointKey, state);
+        },
+        clearState(endpointKey) {
+            stateOverrides.delete(endpointKey);
+        },
+        setDefaultState(state) {
+            currentDefaultState = { state, delay: defaultDelay };
+        },
+        getFixtures() {
+            return fixtures;
+        },
+        async close() {
+            return new Promise((resolve, reject) => {
+                server.close((err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        },
+    };
+}
+/**
+ * Resolve a fixtures directory path from an app type name.
+ * Searches standard locations in the mlcl templates directory.
+ * @param appType - The app type name
+ * @returns The resolved fixtures path, or undefined if not found
+ */
+function resolveFixturesPath(appType) {
+    const root = findWorkspaceRoot();
+    if (!root)
+        return undefined;
+    const candidate = join(root, 'mlcl', 'templates', 'apps', appType, 'api', 'fixtures');
+    if (existsSync(candidate))
+        return candidate;
+    return undefined;
+}
+/**
+ * Attempt to find the workspace root by walking up from cwd.
+ */
+function findWorkspaceRoot() {
+    let dir = process.cwd();
+    for (let i = 0; i < 10; i++) {
+        if (existsSync(join(dir, 'mlcl')) && existsSync(join(dir, 'molecule'))) {
+            return dir;
+        }
+        const parent = join(dir, '..');
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return undefined;
+}
+/**
+ * Number of `:param` segments in a route path — used to register static
+ * paths before parameterized siblings that would otherwise shadow them.
+ * @param path - The route path (e.g. '/profile/:id')
+ */
+function paramCount(path) {
+    return path.split('/').filter((segment) => segment.startsWith(':')).length;
+}
+/**
+ * Register an Express route for a fixture endpoint.
+ * @param app
+ * @param key
+ * @param fixture
+ * @param stateOverrides
+ * @param getDefault
+ */
+function registerRoute(app, key, fixture, stateOverrides, getDefault) {
+    const { method, path } = fixture.endpoint;
+    // Prefix with /api if not already
+    const routePath = path.startsWith('/api') ? path : `/api${path}`;
+    // Convert :paramName to Express param syntax (already correct format)
+    // Build both key forms for state override lookup
+    const apiKey = key.replace(/ \//, ' /api/').replace(' /api/api/', ' /api/');
+    const bareKey = key.replace(/ \/api\//, ' /');
+    const handler = async (_req, res) => {
+        // Determine effective state: per-endpoint override > per-request > default
+        const endpointOverride = stateOverrides.get(key) ?? stateOverrides.get(apiKey) ?? stateOverrides.get(bareKey);
+        const requestState = res.locals.mockState;
+        let state;
+        if (endpointOverride) {
+            // Per-endpoint override wins, but inherit delay from request if not set
+            state = {
+                ...requestState,
+                ...endpointOverride,
+            };
+        }
+        else if (requestState) {
+            state = requestState;
+        }
+        else {
+            state = getDefault();
+        }
+        // Apply delay
+        await applyDelay(state);
+        // Get status code and body
+        const statusCode = getStatusCode(state, method);
+        const body = getResponseBody(state, method, fixture);
+        if (statusCode === 204 || body === null) {
+            res.status(statusCode).end();
+            return;
+        }
+        res.status(statusCode).json(body);
+    };
+    switch (method) {
+        case 'GET':
+            app.get(routePath, handler);
+            break;
+        case 'POST':
+            app.post(routePath, handler);
+            break;
+        case 'PUT':
+            app.put(routePath, handler);
+            break;
+        case 'PATCH':
+            app.patch(routePath, handler);
+            break;
+        case 'DELETE':
+            app.delete(routePath, handler);
+            break;
+    }
+}
+/**
+ * Start the Express server, with special handling for port 0 (random port).
+ * @param app
+ * @param port
+ */
+function startServer(app, port) {
+    return new Promise((resolve, reject) => {
+        const server = app.listen(port, () => {
+            resolve(server);
+        });
+        server.on('error', reject);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server/server.js.map

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

package/dist/states/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Response state management for the mock server.
+ * @module
+ */
+export * from './states.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/states/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/states/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,aAAa,CAAA"}

package/dist/states/index.js

@@ -0,0 +1,6 @@
+/**
+ * Response state management for the mock server.
+ * @module
+ */
+export * from './states.js';
+//# sourceMappingURL=index.js.map

package/dist/states/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/states/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,aAAa,CAAA"}

package/dist/states/states.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Configurable response states for the mock server.
+ * Provides standard response shapes for success, empty, error, and unauthorized states.
+ */
+import type { HttpMethod, ResponseState } from '../types.js';
+/** Default response states for each scenario */
+export declare const DEFAULT_STATES: {
+    readonly success: {
+        readonly state: "success";
+    };
+    readonly empty: {
+        readonly state: "empty";
+    };
+    readonly error: {
+        readonly state: "error";
+        readonly statusCode: 500;
+    };
+    readonly unauthorized: {
+        readonly state: "unauthorized";
+        readonly statusCode: 401;
+    };
+};
+/**
+ * Get the HTTP status code for a given state and method.
+ * @param state - The response state
+ * @param method - The HTTP method
+ * @returns The appropriate HTTP status code
+ */
+export declare function getStatusCode(state: ResponseState, method: HttpMethod): number;
+/**
+ * Get the response body for a given state, using the endpoint fixture data.
+ * @param state - The response state
+ * @param method - The HTTP method
+ * @param fixture - The fixture data containing success, empty, and error responses
+ * @param fixture.successResponse
+ * @param fixture.emptyResponse
+ * @param fixture.errorResponse
+ * @param fixture.errorResponse.error
+ * @returns The response body, or null for 204 responses
+ */
+export declare function getResponseBody(state: ResponseState, method: HttpMethod, fixture: {
+    successResponse: unknown;
+    emptyResponse: unknown;
+    errorResponse: {
+        error: string;
+    };
+}): unknown;
+/**
+ * Parse a state string into a ResponseState object.
+ * @param stateStr - The state string (e.g. 'success', 'error', 'empty', 'unauthorized')
+ * @returns The parsed ResponseState. An unrecognized string falls back to
+ *   `DEFAULT_STATES.success` — the same forgiving behavior as the per-request
+ *   `?_state` middleware (which additionally labels the response with an
+ *   `X-Mock-Invalid-State` header so typos are detectable).
+ */
+export declare function parseState(stateStr: string): ResponseState;
+//# sourceMappingURL=states.d.ts.map

package/dist/states/states.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../src/states/states.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE5D,gDAAgD;AAChD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;CAKjB,CAAA;AAEV;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAuB9E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE;IACP,eAAe,EAAE,OAAO,CAAA;IACxB,aAAa,EAAE,OAAO,CAAA;IACtB,aAAa,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CACjC,GACA,OAAO,CAkBT;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAc1D"}