@molecule/api-mock-server 1.0.0

package/dist/fixtures/zod-walker.js

@@ -0,0 +1,183 @@
+/**
+ * Walks ZodType._def trees to produce conformant fixture data.
+ * Handles the Zod 4 type system for deterministic data generation.
+ */
+import { createSeededRandom, FIXTURE_NOW, recentDate, seededUUID, seedFromPath } from './seed.js';
+import { applySemanticRules } from './semantic-generator.js';
+/**
+ * Walk a serialized Zod schema definition and produce conformant data.
+ * @param schema - The serialized schema definition
+ * @param fieldName - The field name (for semantic heuristics)
+ * @param rng - The seeded random function
+ * @param index - The item index for list generation
+ * @returns A conformant value matching the schema
+ */
+export function walkSchema(schema, fieldName, rng, index) {
+    switch (schema.type) {
+        case 'ZodObject':
+            return walkObject(schema, rng, index);
+        case 'ZodArray':
+            return walkArray(schema, fieldName, rng, index);
+        case 'ZodString':
+            return walkString(schema, fieldName, rng, index);
+        case 'ZodNumber':
+            return walkNumber(schema, fieldName, rng, index);
+        case 'ZodBoolean':
+            return rng() > 0.5;
+        case 'ZodEnum':
+            if (schema.enumValues && schema.enumValues.length > 0) {
+                return schema.enumValues[Math.floor(rng() * schema.enumValues.length)];
+            }
+            return 'unknown';
+        case 'ZodOptional':
+        case 'ZodNullable':
+            // Always generate the inner value (we want populated data for screenshots)
+            if (schema.innerType) {
+                return walkSchema(schema.innerType, fieldName, rng, index);
+            }
+            return null;
+        case 'ZodDefault':
+            // Use the default value
+            if (schema.defaultValue !== undefined) {
+                return schema.defaultValue;
+            }
+            if (schema.innerType) {
+                return walkSchema(schema.innerType, fieldName, rng, index);
+            }
+            return null;
+        case 'ZodUnion':
+            // Pick the first option
+            if (schema.innerType) {
+                return walkSchema(schema.innerType, fieldName, rng, index);
+            }
+            return null;
+        case 'ZodLiteral':
+            return schema.defaultValue;
+        case 'ZodUnknown':
+        case 'ZodAny':
+            return null;
+        default:
+            // Fallback: try semantic rules
+            return applySemanticRules(fieldName, rng, index) ?? `mock-${fieldName}`;
+    }
+}
+/**
+ * Walk a ZodObject schema to produce a conformant object.
+ * @param schema
+ * @param rng
+ * @param index
+ */
+function walkObject(schema, rng, index) {
+    const result = {};
+    if (schema.shape) {
+        for (const [key, fieldSchema] of Object.entries(schema.shape)) {
+            result[key] = walkSchema(fieldSchema, key, rng, index);
+        }
+    }
+    return result;
+}
+/**
+ * Walk a ZodArray schema to produce a conformant array.
+ * @param schema
+ * @param fieldName
+ * @param rng
+ * @param index
+ */
+function walkArray(schema, fieldName, rng, index) {
+    const count = schema.constraints?.min ?? 2;
+    const elementType = schema.elementType ?? { type: 'ZodString' };
+    const result = [];
+    for (let i = 0; i < count; i++) {
+        result.push(walkSchema(elementType, fieldName, rng, index + i));
+    }
+    return result;
+}
+/**
+ * Walk a ZodString schema, applying semantic rules for realistic values.
+ * @param _schema
+ * @param fieldName
+ * @param rng
+ * @param index
+ */
+function walkString(_schema, fieldName, rng, index) {
+    // Try semantic rule first
+    const semantic = applySemanticRules(fieldName, rng, index);
+    if (typeof semantic === 'string') {
+        return semantic;
+    }
+    // Fallback to a generic string
+    return `mock-${fieldName}-${index}`;
+}
+/**
+ * Walk a ZodNumber schema, applying semantic rules and constraints.
+ * @param schema
+ * @param fieldName
+ * @param rng
+ * @param index
+ */
+function walkNumber(schema, fieldName, rng, index) {
+    // Try semantic rule first
+    const semantic = applySemanticRules(fieldName, rng, index);
+    if (typeof semantic === 'number') {
+        return semantic;
+    }
+    const c = schema.constraints;
+    let min = c?.min ?? 0;
+    const max = c?.max ?? 1000;
+    if (c?.positive && min <= 0) {
+        min = 1;
+    }
+    let value = rng() * (max - min) + min;
+    if (c?.int) {
+        value = Math.floor(value);
+    }
+    else {
+        value = Math.round(value * 100) / 100;
+    }
+    return value;
+}
+/**
+ * Generate a single conformant record from a schema, enriched with
+ * standard fields (id, created_at, updated_at).
+ * @param schema - The serialized Zod schema definition
+ * @param rng - The seeded random function
+ * @param index - The item index
+ * @returns A record with all schema fields plus standard fields
+ */
+export function generateRecord(schema, rng, index) {
+    const base = {
+        id: seededUUID(rng),
+        // Anchored to FIXTURE_NOW (not the wall clock) so generated records are
+        // byte-stable across runs — the module's determinism promise held for
+        // seed.ts dates but this function used Date.now(), so timestamps (and any
+        // screenshot rendering them) changed on every run. created_at is always
+        // <= updated_at.
+        created_at: recentDate(rng),
+        updated_at: FIXTURE_NOW.toISOString(),
+    };
+    if (schema && schema.type === 'ZodObject' && schema.shape) {
+        for (const [key, fieldSchema] of Object.entries(schema.shape)) {
+            base[key] = walkSchema(fieldSchema, key, rng, index);
+        }
+    }
+    return base;
+}
+/**
+ * Generate multiple records from a schema definition.
+ * @param schema - The serialized Zod schema definition
+ * @param count - Number of records to generate
+ * @param appType - App type for seed derivation
+ * @param path - Endpoint path for seed derivation
+ * @param config - Optional fixture configuration
+ * @returns An array of conformant records
+ */
+export function generateRecords(schema, count, appType, path, config) {
+    const seed = config?.seed ?? seedFromPath(appType, path);
+    const rng = createSeededRandom(seed);
+    const records = [];
+    for (let i = 0; i < count; i++) {
+        records.push(generateRecord(schema, rng, i));
+    }
+    return records;
+}
+//# sourceMappingURL=zod-walker.js.map

package/dist/fixtures/zod-walker.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Mock API server with deterministic fixture data for testing, screenshots, and E2E.
+ *
+ * Provides a lightweight Express server that serves realistic fixture responses
+ * for any molecule app type. Supports per-request state control via query params
+ * and headers for testing success, empty, error, and unauthorized states.
+ *
+ * @example
+ * ```typescript
+ * import { createMockServer } from '@molecule/api-mock-server'
+ *
+ * const server = await createMockServer({
+ *   appType: 'personal-finance',
+ *   fixturesPath: './api/fixtures', // directory of *.json fixture files
+ *   port: 4000,
+ * })
+ *
+ * // Control state programmatically ('GET /accounts' and 'GET /api/accounts'
+ * // are equivalent keys)
+ * server.setState('GET /accounts', { state: 'error', statusCode: 500 })
+ * server.setState('GET /transactions', { state: 'empty' })
+ * server.setDefaultState('empty') // flips every endpoint at once
+ *
+ * // Undo an endpoint override so ?_state / the default control it again —
+ * // setState(key, { state: 'success' }) is NOT the same thing (see @remarks)
+ * server.clearState('GET /accounts')
+ *
+ * // Teardown
+ * await server.close()
+ * ```
+ *
+ * @remarks
+ * The server uses deterministic seeded PRNG for stable fixture data, making
+ * screenshot comparisons reliable. Fixture data comes from the JSON files in
+ * `fixturesPath` (array files become CRUD resources; `reports`/`storefront`/
+ * `admin` object files become sub-endpoint groups).
+ *
+ * Omitting `fixturesPath` makes the server resolve
+ * `mlcl/templates/apps/<appType>/api/fixtures/` by walking up from `process.cwd()`
+ * — that only works inside the molecule workspace. In a scaffolded project,
+ * always pass `fixturesPath`.
+ *
+ * Requests to `/api/*` paths with no matching fixture endpoint return an empty
+ * success (`200 []` for GET) so pages still render — the response carries an
+ * `X-Mock-Unmatched: true` header so a typo'd endpoint can be told apart from
+ * an endpoint that legitimately returned empty data. Similarly, an invalid
+ * `?_state`/`X-Mock-State` value is ignored (the default state is served) but
+ * labeled with an `X-Mock-Invalid-State` response header, so a typo'd state
+ * control is detectable instead of silently looking like "state applied".
+ *
+ * State precedence, per request, highest first: (1) an endpoint-level
+ * `server.setState(key, state)` override, (2) a per-request `?_state` query
+ * param / `X-Mock-State` header, (3) `server.setDefaultState(...)` / the
+ * configured `defaultState`. A `setState()` override is PERSISTENT — a
+ * forgotten override from an earlier test silently beats every later
+ * `?_state` on that same endpoint. Calling `setState(key, { state: 'success'
+ * })` again does NOT remove the override (it replaces it with one that looks
+ * like the default, still outranking `?_state`); call `server.clearState(key)`
+ * to actually remove it and hand control back to per-request/default state.
+ * `setDefaultState()` only changes the fallback and never clears endpoint
+ * overrides.
+ *
+ * Response delay (`defaultDelay`, `?_delay`/`X-Mock-Delay`, or a `delay` in
+ * `setState`/`setDefaultState`) is capped at `MAX_MOCK_DELAY_MS` (60s) — an
+ * oversized value (e.g. a units mistake applying `*1000` twice) is clamped
+ * and logged with `console.warn` instead of hanging the request until the
+ * client gives up, which in an E2E harness reads as an inexplicable page
+ * timeout rather than a mock misconfiguration.
+ *
+ * @module
+ */
+export * from './browser-guard.js';
+export * from './fixtures/index.js';
+export * from './scanner/index.js';
+export * from './server/index.js';
+export * from './states/index.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,78 @@
+/**
+ * Mock API server with deterministic fixture data for testing, screenshots, and E2E.
+ *
+ * Provides a lightweight Express server that serves realistic fixture responses
+ * for any molecule app type. Supports per-request state control via query params
+ * and headers for testing success, empty, error, and unauthorized states.
+ *
+ * @example
+ * ```typescript
+ * import { createMockServer } from '@molecule/api-mock-server'
+ *
+ * const server = await createMockServer({
+ *   appType: 'personal-finance',
+ *   fixturesPath: './api/fixtures', // directory of *.json fixture files
+ *   port: 4000,
+ * })
+ *
+ * // Control state programmatically ('GET /accounts' and 'GET /api/accounts'
+ * // are equivalent keys)
+ * server.setState('GET /accounts', { state: 'error', statusCode: 500 })
+ * server.setState('GET /transactions', { state: 'empty' })
+ * server.setDefaultState('empty') // flips every endpoint at once
+ *
+ * // Undo an endpoint override so ?_state / the default control it again —
+ * // setState(key, { state: 'success' }) is NOT the same thing (see @remarks)
+ * server.clearState('GET /accounts')
+ *
+ * // Teardown
+ * await server.close()
+ * ```
+ *
+ * @remarks
+ * The server uses deterministic seeded PRNG for stable fixture data, making
+ * screenshot comparisons reliable. Fixture data comes from the JSON files in
+ * `fixturesPath` (array files become CRUD resources; `reports`/`storefront`/
+ * `admin` object files become sub-endpoint groups).
+ *
+ * Omitting `fixturesPath` makes the server resolve
+ * `mlcl/templates/apps/<appType>/api/fixtures/` by walking up from `process.cwd()`
+ * — that only works inside the molecule workspace. In a scaffolded project,
+ * always pass `fixturesPath`.
+ *
+ * Requests to `/api/*` paths with no matching fixture endpoint return an empty
+ * success (`200 []` for GET) so pages still render — the response carries an
+ * `X-Mock-Unmatched: true` header so a typo'd endpoint can be told apart from
+ * an endpoint that legitimately returned empty data. Similarly, an invalid
+ * `?_state`/`X-Mock-State` value is ignored (the default state is served) but
+ * labeled with an `X-Mock-Invalid-State` response header, so a typo'd state
+ * control is detectable instead of silently looking like "state applied".
+ *
+ * State precedence, per request, highest first: (1) an endpoint-level
+ * `server.setState(key, state)` override, (2) a per-request `?_state` query
+ * param / `X-Mock-State` header, (3) `server.setDefaultState(...)` / the
+ * configured `defaultState`. A `setState()` override is PERSISTENT — a
+ * forgotten override from an earlier test silently beats every later
+ * `?_state` on that same endpoint. Calling `setState(key, { state: 'success'
+ * })` again does NOT remove the override (it replaces it with one that looks
+ * like the default, still outranking `?_state`); call `server.clearState(key)`
+ * to actually remove it and hand control back to per-request/default state.
+ * `setDefaultState()` only changes the fallback and never clears endpoint
+ * overrides.
+ *
+ * Response delay (`defaultDelay`, `?_delay`/`X-Mock-Delay`, or a `delay` in
+ * `setState`/`setDefaultState`) is capped at `MAX_MOCK_DELAY_MS` (60s) — an
+ * oversized value (e.g. a units mistake applying `*1000` twice) is clamped
+ * and logged with `console.warn` instead of hanging the request until the
+ * client gives up, which in an E2E harness reads as an inexplicable page
+ * timeout rather than a mock misconfiguration.
+ *
+ * @module
+ */
+export * from './browser-guard.js';
+export * from './fixtures/index.js';
+export * from './scanner/index.js';
+export * from './server/index.js';
+export * from './states/index.js';
+export * from './types.js';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA"}

package/dist/scanner/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Handler scanner module for discovering endpoints from template files.
+ * @module
+ */
+export * from './scanner.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/scanner/index.js

@@ -0,0 +1,6 @@
+/**
+ * Handler scanner module for discovering endpoints from template files.
+ * @module
+ */
+export * from './scanner.js';
+//# sourceMappingURL=index.js.map

package/dist/scanner/index.js.map

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

package/dist/scanner/scanner.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Static analysis scanner that reads handler files from mlcl templates
+ * and produces endpoint definitions. Uses regex-based AST parsing.
+ */
+import type { HandlerScanResult } from '../types.js';
+/**
+ * Scan all handler files for a given app type and produce endpoint definitions.
+ * @param handlersPath - Path to the handlers directory
+ * @param appType - The app type name
+ * @returns The scan result with all discovered endpoints
+ */
+export declare function scanHandlers(handlersPath: string, appType: string): HandlerScanResult;
+/**
+ * Resolve the handlers path for a given app type.
+ * Searches standard locations in the mlcl templates directory.
+ * @param appType - The app type name
+ * @param workspaceRoot - The workspace root directory
+ * @returns The resolved handlers path, or undefined if not found
+ */
+export declare function resolveHandlersPath(appType: string, workspaceRoot?: string): string | undefined;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/scanner/scanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAEV,iBAAiB,EAIlB,MAAM,aAAa,CAAA;AAoMpB;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA2GrF;AAgLD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkB/F"}