raffel 1.0.6 → 1.0.7

package/dist/mock-server/cli.js

@@ -0,0 +1,314 @@
+/**
+ * Mock Server CLI
+ *
+ * `raffel mock <source>` — start a mock server from an OpenAPI spec, URL, or JSON data file.
+ *
+ * Auto-detects the source type:
+ *   - URL (http:// or https://) → fetches the spec remotely
+ *   - OpenAPI 3.x (yaml/json with "openapi"/"swagger" key) → spec-driven mock responses
+ *   - USD document (with "operations" key) → multi-protocol mock
+ *   - Plain JSON (object with array values) → full CRUD REST + WebSocket json-server
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { createParser } from 'cli-args-parser';
+import { createMockServer } from './index.js';
+import { createJsonServer } from '../json-server/index.js';
+function isUrl(input) {
+    return input.startsWith('http://') || input.startsWith('https://');
+}
+async function fetchRemoteSpec(url) {
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`Failed to fetch ${url} — ${res.status} ${res.statusText}`);
+    }
+    const content = await res.text();
+    const parsed = parseContent(content, url);
+    return { mode: 'spec', content, parsed, label: url };
+}
+function parseContent(content, source) {
+    const isYaml = /\.ya?ml(\?|$)/i.test(source) || content.trimStart().startsWith('openapi');
+    let parsed;
+    if (isYaml && !content.trimStart().startsWith('{')) {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const yaml = require('js-yaml');
+        parsed = yaml.load(content);
+    }
+    else {
+        try {
+            parsed = JSON.parse(content);
+        }
+        catch {
+            // If JSON parse fails, try YAML as fallback
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const yaml = require('js-yaml');
+                parsed = yaml.load(content);
+            }
+            catch {
+                throw new Error(`Cannot parse ${source} — expected JSON or YAML`);
+            }
+        }
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new Error(`${source} must be a JSON/YAML object (not array or primitive)`);
+    }
+    return parsed;
+}
+function classifyParsed(parsed) {
+    // OpenAPI 3.x or Swagger 2.x
+    if ('openapi' in parsed || 'swagger' in parsed || 'paths' in parsed) {
+        return 'spec';
+    }
+    // USD document
+    if ('operations' in parsed) {
+        return 'spec';
+    }
+    // Plain JSON with array values → json-server data
+    const values = Object.values(parsed);
+    if (values.length > 0 && values.every((v) => Array.isArray(v))) {
+        return 'data';
+    }
+    // Fallback: try as spec
+    return 'spec';
+}
+function detectFileSource(filePath) {
+    const resolved = path.resolve(filePath);
+    if (!fs.existsSync(resolved)) {
+        throw new Error(`File not found: ${resolved}`);
+    }
+    const content = fs.readFileSync(resolved, 'utf8');
+    const parsed = parseContent(content, resolved);
+    const mode = classifyParsed(parsed);
+    return { mode, content, parsed, label: resolved };
+}
+async function resolveSource(input) {
+    if (isUrl(input)) {
+        return fetchRemoteSpec(input);
+    }
+    return detectFileSource(input);
+}
+// ── CLI schema ───────────────────────────────────────────────────────────────
+export const mockParser = createParser({
+    positional: [
+        {
+            name: 'source',
+            required: true,
+            description: 'File path or URL to OpenAPI/USD spec (.yaml, .yml, .json) or JSON data file',
+        },
+    ],
+    options: {
+        port: {
+            short: 'p',
+            type: 'number',
+            default: 3000,
+            description: 'Server port',
+        },
+        host: {
+            type: 'string',
+            default: '0.0.0.0',
+            description: 'Bind address',
+        },
+        delay: {
+            short: 'd',
+            type: 'number',
+            description: 'Simulate network latency (ms)',
+        },
+        readonly: {
+            type: 'boolean',
+            default: false,
+            description: 'Disable write operations (data mode only)',
+        },
+        validate: {
+            type: 'boolean',
+            default: true,
+            description: 'Validate request bodies against schema (spec mode only)',
+            negatable: true,
+        },
+        ws: {
+            type: 'boolean',
+            description: 'Enable WebSocket protocol',
+        },
+        jsonrpc: {
+            type: 'boolean',
+            default: false,
+            description: 'Enable JSON-RPC on /rpc',
+        },
+        'id-key': {
+            type: 'string',
+            default: 'id',
+            description: 'Record ID field name (data mode only)',
+        },
+        watch: {
+            short: 'w',
+            type: 'boolean',
+            default: false,
+            description: 'Watch file for changes and reload',
+        },
+    },
+});
+// ── Runner ───────────────────────────────────────────────────────────────────
+export async function runMockCommand(args) {
+    const result = mockParser.parse(args);
+    if (result.errors.length > 0) {
+        console.error('Error:', result.errors.join(', '));
+        console.error();
+        console.error(mockParser.help());
+        return 1;
+    }
+    const source = result.positional.source;
+    if (!source) {
+        console.error(mockParser.help());
+        return 1;
+    }
+    const port = result.options.port ?? 3000;
+    const host = result.options.host ?? '0.0.0.0';
+    const delay = result.options.delay;
+    const readonly = result.options.readonly;
+    const validate = result.options.validate;
+    const ws = result.options.ws;
+    const jsonrpc = result.options.jsonrpc;
+    const idKey = result.options['id-key'];
+    const watch = result.options.watch;
+    const remote = isUrl(source);
+    let detected;
+    try {
+        if (remote) {
+            console.log(`  Fetching ${source}...`);
+        }
+        detected = await resolveSource(source);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        return 1;
+    }
+    if (remote && detected.mode === 'data') {
+        console.error('Error: Remote URLs only support OpenAPI/USD specs, not JSON data files');
+        return 1;
+    }
+    if (remote && watch) {
+        console.error('Warning: --watch is ignored for remote URLs');
+    }
+    const displayLabel = remote ? source : path.relative(process.cwd(), detected.label);
+    const resources = detected.mode === 'data' ? Object.keys(detected.parsed) : [];
+    console.log();
+    console.log(`  Raffel Mock Server`);
+    console.log(`  ──────────────────`);
+    console.log(`  Source:    ${displayLabel}`);
+    console.log(`  Mode:      ${detected.mode === 'spec' ? 'OpenAPI/USD spec → mock responses' : 'JSON data → CRUD REST + WebSocket'}`);
+    console.log(`  Address:   http://${host === '0.0.0.0' ? 'localhost' : host}:${port}`);
+    if (delay)
+        console.log(`  Delay:     ${delay}ms`);
+    if (detected.mode === 'data') {
+        console.log(`  Resources: ${resources.join(', ')}`);
+        if (readonly)
+            console.log(`  Readonly:  yes`);
+        if (idKey !== 'id')
+            console.log(`  ID key:    ${idKey}`);
+    }
+    if (detected.mode === 'spec') {
+        if (!validate)
+            console.log(`  Validate:  off`);
+    }
+    if (watch && !remote)
+        console.log(`  Watch:     enabled`);
+    console.log();
+    let shutdown;
+    async function startServer() {
+        if (detected.mode === 'spec') {
+            const { server, routes } = await createMockServer({
+                spec: detected.parsed,
+                port,
+                hostname: host,
+                delay,
+                validateRequests: validate,
+                protocols: {
+                    ws: ws ?? false,
+                    jsonrpc,
+                },
+            });
+            console.log(`  Routes:`);
+            for (const route of routes) {
+                console.log(`    ${route.method.padEnd(7)} ${route.pathPattern}`);
+            }
+            console.log();
+            console.log(`  Ready. Press Ctrl+C to stop.`);
+            shutdown = () => server.stop();
+        }
+        else {
+            const { server, store } = await createJsonServer({
+                db: detected.parsed,
+                port,
+                hostname: host,
+                delay,
+                readonly,
+                idKey,
+                protocols: {
+                    ws: ws !== false,
+                    jsonrpc,
+                },
+            });
+            const resourceNames = store.resources();
+            console.log(`  Endpoints:`);
+            for (const name of resourceNames) {
+                const count = store.list(name).total;
+                console.log(`    /${name.padEnd(20)} ${count} record${count !== 1 ? 's' : ''}`);
+            }
+            console.log();
+            if (ws !== false) {
+                console.log(`  WebSocket: ws://${host === '0.0.0.0' ? 'localhost' : host}:${port}/ws`);
+            }
+            if (jsonrpc) {
+                console.log(`  JSON-RPC:  http://${host === '0.0.0.0' ? 'localhost' : host}:${port}/rpc`);
+            }
+            console.log();
+            console.log(`  Ready. Press Ctrl+C to stop.`);
+            shutdown = () => server.stop();
+        }
+    }
+    await startServer();
+    // Watch mode: reload on local file changes (not for URLs)
+    if (watch && !remote) {
+        let reloading = false;
+        const watcher = fs.watch(detected.label, async () => {
+            if (reloading)
+                return;
+            reloading = true;
+            try {
+                console.log();
+                console.log(`  File changed, reloading...`);
+                if (shutdown) {
+                    await shutdown();
+                    shutdown = undefined;
+                }
+                detected = detectFileSource(detected.label);
+                await startServer();
+            }
+            catch (error) {
+                console.error(`  Reload failed: ${error.message}`);
+            }
+            finally {
+                reloading = false;
+            }
+        });
+        process.once('SIGINT', () => {
+            watcher.close();
+        });
+        process.once('SIGTERM', () => {
+            watcher.close();
+        });
+    }
+    // Wait for shutdown signal
+    await new Promise((resolve) => {
+        const stop = async () => {
+            if (shutdown) {
+                await shutdown();
+            }
+            resolve();
+        };
+        process.once('SIGINT', () => void stop());
+        process.once('SIGTERM', () => void stop());
+    });
+    return 0;
+}
+//# sourceMappingURL=cli.js.map

package/dist/mock-server/cli.js.map

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

package/dist/mock-server/fake-data.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Mock Server — Fake Data (delegates to shared schema-examples)
+ *
+ * Re-exports the unified generator with mock-server defaults:
+ * - uniqueValues: true (counter-based unique emails, uuids, uris)
+ * - maxOptionalProperties: Infinity (generate ALL properties for complete mocks)
+ */
+export { resetExampleCounter as resetFakeDataCounter } from '../utils/schema-examples.js';
+/**
+ * Generate fake data from a JSON Schema with mock-server defaults.
+ * Counter-based unique values, all properties generated.
+ */
+export declare function generateFromSchema(schema: Record<string, unknown>): unknown;
+//# sourceMappingURL=fake-data.d.ts.map

package/dist/mock-server/fake-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-data.d.ts","sourceRoot":"","sources":["../../src/mock-server/fake-data.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,mBAAmB,IAAI,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAOzF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAE3E"}

package/dist/mock-server/fake-data.js

@@ -0,0 +1,21 @@
+/**
+ * Mock Server — Fake Data (delegates to shared schema-examples)
+ *
+ * Re-exports the unified generator with mock-server defaults:
+ * - uniqueValues: true (counter-based unique emails, uuids, uris)
+ * - maxOptionalProperties: Infinity (generate ALL properties for complete mocks)
+ */
+import { generateSchemaExample, } from '../utils/schema-examples.js';
+export { resetExampleCounter as resetFakeDataCounter } from '../utils/schema-examples.js';
+const MOCK_SERVER_DEFAULTS = {
+    uniqueValues: true,
+    maxOptionalProperties: Infinity,
+};
+/**
+ * Generate fake data from a JSON Schema with mock-server defaults.
+ * Counter-based unique values, all properties generated.
+ */
+export function generateFromSchema(schema) {
+    return generateSchemaExample(schema, MOCK_SERVER_DEFAULTS);
+}
+//# sourceMappingURL=fake-data.js.map

package/dist/mock-server/fake-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-data.js","sourceRoot":"","sources":["../../src/mock-server/fake-data.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,qBAAqB,GAGtB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EAAE,mBAAmB,IAAI,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAEzF,MAAM,oBAAoB,GAAyB;IACjD,YAAY,EAAE,IAAI;IAClB,qBAAqB,EAAE,QAAQ;CAChC,CAAA;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA+B;IAChE,OAAO,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;AAC5D,CAAC"}

package/dist/mock-server/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Mock Server — Spec-driven mock server from OpenAPI/Swagger/USD
+ *
+ * Feed it an OpenAPI 3.x or USD spec (JSON/YAML/object) and get a fully
+ * functional mock server with:
+ *   - Auto-generated routes from paths
+ *   - Example-based or schema-generated responses
+ *   - Request body validation (optional)
+ *   - Multi-protocol support (HTTP REST + WS/JSON-RPC if USD)
+ *
+ * Architecture follows json-server's two-layer pattern:
+ *   1. HttpMiddleware for REST routes (before Raffel RPC router)
+ *   2. RouterModule with procedures (for WS / JSON-RPC)
+ */
+import { createServer } from '../server/builder.js';
+import type { RouterModule } from '../server/types.js';
+import type { HttpMiddleware } from '../adapters/http.js';
+import type { USDDocument } from '../usd/spec/types.js';
+import type { MockServerOptions, MockModuleOptions, MockRoute } from './types.js';
+export type { MockServerOptions, MockModuleOptions, MockRoute, MockResponse, ResolvedParam } from './types.js';
+export { generateFromSchema, resetFakeDataCounter } from './fake-data.js';
+export { extractRoutes, toExpressPath, resolveResponse, extractRequestBodySchema, mergeParameters } from './route-extractor.js';
+export interface MockModule {
+    /** RouterModule with procedures callable over WebSocket or JSON-RPC */
+    module: RouterModule;
+    /** HttpMiddleware that intercepts REST routes */
+    middleware: HttpMiddleware;
+    /** Extracted routes for inspection/debugging */
+    routes: MockRoute[];
+}
+/**
+ * Create a reusable mock module from an OpenAPI/USD spec.
+ *
+ * @example
+ * ```typescript
+ * const { module, middleware, routes } = createMockModule(openapiJson)
+ *
+ * const server = createServer({ port: 3000, http: { middleware: [middleware] } })
+ *   .mount('', module)
+ *
+ * await server.start()
+ * ```
+ */
+export declare function createMockModule(spec: string | USDDocument | Record<string, unknown>, options?: MockModuleOptions): MockModule;
+export interface MockServerResult {
+    /** The running Raffel server */
+    server: ReturnType<typeof createServer>;
+    /** Extracted routes for inspection */
+    routes: MockRoute[];
+}
+/**
+ * Create and start a standalone mock server from an OpenAPI/USD spec.
+ *
+ * @example
+ * ```typescript
+ * const { server, routes } = await createMockServer({
+ *   spec: './petstore.yaml',
+ *   port: 4000,
+ * })
+ *
+ * console.log(`Mock server running with ${routes.length} routes`)
+ *
+ * // → GET  /pets          returns mock data from spec examples or schema
+ * // → POST /pets          validates request body + returns mock response
+ * // → GET  /pets/:petId   returns mock pet
+ * ```
+ */
+export declare function createMockServer(options: MockServerOptions): Promise<MockServerResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/mock-server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mock-server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAAgB,MAAM,YAAY,CAAA;AAG/F,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC9G,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACzE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAI/H,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,MAAM,EAAE,YAAY,CAAA;IACpB,iDAAiD;IACjD,UAAU,EAAE,cAAc,CAAA;IAC1B,gDAAgD;IAChD,MAAM,EAAE,SAAS,EAAE,CAAA;CACpB;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpD,OAAO,GAAE,iBAAsB,GAC9B,UAAU,CAUZ;AAID,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA;IACvC,sCAAsC;IACtC,MAAM,EAAE,SAAS,EAAE,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmB5F"}