raffel 0.1.2

package/dist/docs/generators/streams-generator.js

@@ -0,0 +1,282 @@
+/**
+ * Streams Generator for USD
+ *
+ * Converts Raffel streams to USD Streams specification (x-usd.streams).
+ */
+import { USD_PROTOCOL_CONTENT_TYPES } from '../../usd/index.js';
+import { createSchemaRegistry } from './schema-converter.js';
+import { resolveContentTypes } from './content-types.js';
+/**
+ * Generate USD Streams specification from registered streams
+ */
+export function generateStreams(ctx, options = {}) {
+    const { includeBackpressure = true, defaultSecurity, contentTypes = USD_PROTOCOL_CONTENT_TYPES.streams, } = options;
+    const protocolContentTypes = contentTypes;
+    const schemaRegistry = createSchemaRegistry();
+    const endpoints = {};
+    // Convert registered streams
+    for (const meta of ctx.registry.listStreams()) {
+        const handlerSchema = ctx.schemaRegistry?.get(meta.name);
+        const direction = convertDirection(meta.streamDirection);
+        endpoints[meta.name] = convertStreamEndpoint(meta, handlerSchema, direction, schemaRegistry, includeBackpressure, protocolContentTypes, defaultSecurity);
+    }
+    return {
+        streams: {
+            contentTypes: protocolContentTypes,
+            endpoints: Object.keys(endpoints).length > 0 ? endpoints : undefined,
+        },
+        schemas: schemaRegistry.toObject(),
+    };
+}
+/**
+ * Convert a stream handler to USD StreamEndpoint
+ */
+function convertStreamEndpoint(meta, handlerSchema, direction, schemaRegistry, includeBackpressure, protocolContentTypes, defaultSecurity) {
+    const resolvedContentTypes = resolveContentTypes(meta);
+    const messageContentType = resolvedContentTypes?.default ?? protocolContentTypes.default;
+    const endpoint = {
+        description: meta.description ?? `Stream: ${meta.name}`,
+        direction,
+        message: createStreamMessage(meta.name, handlerSchema, schemaRegistry, direction, messageContentType),
+    };
+    if (resolvedContentTypes) {
+        endpoint.contentTypes = resolvedContentTypes;
+    }
+    // Add tags based on stream name
+    const tags = extractStreamTags(meta.name);
+    if (tags.length > 0) {
+        endpoint.tags = tags;
+    }
+    // Add security if provided
+    if (defaultSecurity) {
+        endpoint.security = defaultSecurity;
+    }
+    // Add backpressure indicator for bidirectional streams
+    if (includeBackpressure && direction === 'bidirectional') {
+        endpoint['x-usd-backpressure'] = true;
+    }
+    return endpoint;
+}
+/**
+ * Create stream message schema
+ */
+function createStreamMessage(name, handlerSchema, schemaRegistry, direction, contentType) {
+    const message = {
+        name: `${sanitizeSchemaName(name)}Message`,
+        contentType: contentType ?? USD_PROTOCOL_CONTENT_TYPES.streams.default ?? 'application/json',
+    };
+    // Determine which schema to use based on direction
+    if (direction === 'server-to-client' && handlerSchema?.output) {
+        // Server sends, use output schema
+        const schemaName = `${sanitizeSchemaName(name)}_Output`;
+        schemaRegistry.add(schemaName, handlerSchema.output);
+        message.payload = { $ref: `#/components/schemas/${schemaName}` };
+        message.summary = 'Server-sent message';
+    }
+    else if (direction === 'client-to-server' && handlerSchema?.input) {
+        // Client sends, use input schema
+        const schemaName = `${sanitizeSchemaName(name)}_Input`;
+        schemaRegistry.add(schemaName, handlerSchema.input);
+        message.payload = { $ref: `#/components/schemas/${schemaName}` };
+        message.summary = 'Client-sent message';
+    }
+    else if (direction === 'bidirectional') {
+        // Bidirectional: create combined schema with both input and output
+        message.summary = 'Bidirectional message';
+        message.description = 'Messages can flow in both directions';
+        if (handlerSchema?.input && handlerSchema?.output) {
+            // Create a oneOf schema for bidirectional streams
+            const inputName = `${sanitizeSchemaName(name)}_ClientMessage`;
+            const outputName = `${sanitizeSchemaName(name)}_ServerMessage`;
+            schemaRegistry.add(inputName, handlerSchema.input);
+            schemaRegistry.add(outputName, handlerSchema.output);
+            // For bidirectional, we typically use the output schema as the main payload
+            // since that's what clients will receive
+            message.payload = { $ref: `#/components/schemas/${outputName}` };
+        }
+        else if (handlerSchema?.output) {
+            const schemaName = `${sanitizeSchemaName(name)}_Message`;
+            schemaRegistry.add(schemaName, handlerSchema.output);
+            message.payload = { $ref: `#/components/schemas/${schemaName}` };
+        }
+        else if (handlerSchema?.input) {
+            const schemaName = `${sanitizeSchemaName(name)}_Message`;
+            schemaRegistry.add(schemaName, handlerSchema.input);
+            message.payload = { $ref: `#/components/schemas/${schemaName}` };
+        }
+    }
+    // Default to generic object if no schema
+    if (!message.payload) {
+        message.payload = { type: 'object' };
+    }
+    return message;
+}
+/**
+ * Convert Raffel StreamDirection to USD StreamDirection
+ */
+function convertDirection(direction) {
+    switch (direction) {
+        case 'server':
+            return 'server-to-client';
+        case 'client':
+            return 'client-to-server';
+        case 'bidi':
+            return 'bidirectional';
+        default:
+            // Default to server-to-client (SSE-style)
+            return 'server-to-client';
+    }
+}
+/**
+ * Extract tags from stream name
+ */
+function extractStreamTags(name) {
+    // Split by . and take first part as tag
+    const parts = name.split('.');
+    if (parts.length > 1) {
+        return [parts[0]];
+    }
+    // Split by - or _ and take first part
+    const segments = name.split(/[-_]/);
+    if (segments.length > 1) {
+        return [segments[0]];
+    }
+    return [];
+}
+/**
+ * Sanitize stream name for schema naming
+ */
+function sanitizeSchemaName(name) {
+    return name
+        .replace(/\./g, '_')
+        .replace(/-/g, '_')
+        .split('_')
+        .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+        .join('');
+}
+/**
+ * Helper to create an SSE stream definition for manual configuration
+ */
+export function createSSEStreamConfig(options) {
+    return {
+        name: options.name,
+        meta: {
+            kind: 'stream',
+            name: options.name,
+            description: options.description ?? `SSE Stream: ${options.name}`,
+            streamDirection: 'server',
+        },
+        schema: {
+            output: options.eventSchema,
+            input: options.inputSchema,
+        },
+    };
+}
+/**
+ * Helper to create a bidirectional stream definition for manual configuration
+ */
+export function createBidiStreamConfig(options) {
+    return {
+        name: options.name,
+        meta: {
+            kind: 'stream',
+            name: options.name,
+            description: options.description ?? `Bidirectional Stream: ${options.name}`,
+            streamDirection: 'bidi',
+        },
+        schema: {
+            input: options.clientMessageSchema,
+            output: options.serverMessageSchema,
+        },
+    };
+}
+/**
+ * Generate stream auth security schemes
+ *
+ * Documents the available authentication methods for SSE/fetch streams:
+ * - Cookie session: Automatic with EventSource, uses session cookie
+ * - Bearer token (query): For EventSource, token in ?token= param
+ * - Bearer token (header): For fetch API streams, Authorization header
+ * - API key (query): For EventSource, key in ?apiKey= param
+ */
+export function generateStreamAuthSchemes() {
+    return {
+        StreamCookieSession: {
+            type: 'apiKey',
+            name: 'session',
+            in: 'cookie',
+            description: 'Cookie-based session authentication. Works automatically with EventSource. Use cookieSession() middleware to enable.',
+            'x-usd-streams': {
+                in: ['cookie'],
+                name: 'session',
+                description: 'Session cookie is sent automatically by browsers with EventSource requests. Use ctx.auth.user in stream handlers to access authenticated user.',
+            },
+        },
+        StreamBearerToken: {
+            type: 'http',
+            scheme: 'bearer',
+            bearerFormat: 'JWT',
+            description: 'Bearer token authentication for streams. Can be passed via Authorization header (fetch API) or query parameter (EventSource).',
+            'x-usd-streams': {
+                in: ['header', 'query'],
+                name: 'token',
+                description: 'For EventSource: append ?token=<JWT> to stream URL. For fetch API: use Authorization: Bearer <JWT> header.',
+            },
+        },
+        StreamApiKey: {
+            type: 'apiKey',
+            name: 'apiKey',
+            in: 'query',
+            description: 'API key authentication for streams. Pass key as query parameter for EventSource compatibility.',
+            'x-usd-streams': {
+                in: ['query', 'header'],
+                name: 'apiKey',
+                description: 'For EventSource: append ?apiKey=<KEY> to stream URL. For fetch API: use X-API-Key header or query param.',
+            },
+        },
+    };
+}
+/**
+ * Generate standard stream events for SSE compatibility
+ */
+export function generateStreamEvents() {
+    return {
+        StreamData: {
+            type: 'object',
+            description: 'Standard data event for SSE streams',
+            properties: {
+                id: { type: 'string', description: 'Event ID for resumption' },
+                event: { type: 'string', description: 'Event type/name' },
+                data: { description: 'Event payload' },
+                retry: { type: 'integer', description: 'Reconnection time in milliseconds' },
+            },
+            required: ['data'],
+        },
+        StreamError: {
+            type: 'object',
+            description: 'Stream error event',
+            properties: {
+                code: { type: 'string', description: 'Error code' },
+                message: { type: 'string', description: 'Error message' },
+                fatal: { type: 'boolean', description: 'Whether error terminates the stream' },
+            },
+            required: ['code', 'message'],
+        },
+        StreamEnd: {
+            type: 'object',
+            description: 'Stream end event',
+            properties: {
+                reason: { type: 'string', description: 'End reason' },
+                stats: {
+                    type: 'object',
+                    description: 'Stream statistics',
+                    properties: {
+                        messageCount: { type: 'integer' },
+                        duration: { type: 'integer', description: 'Duration in milliseconds' },
+                    },
+                },
+            },
+        },
+    };
+}
+//# sourceMappingURL=streams-generator.js.map

package/dist/docs/generators/streams-generator.js.map

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

package/dist/docs/generators/tcp-generator.d.ts

@@ -0,0 +1,133 @@
+/**
+ * TCP Generator for USD
+ *
+ * Converts Raffel TCP handlers to USD TCP specification (x-usd.tcp).
+ */
+import type { USDTcp, USDTcpFraming, USDContentTypes, USDSchema } from '../../usd/index.js';
+/**
+ * TCP handler with optional docs field for rich documentation
+ */
+export interface TcpHandlerDocs {
+    /** Handler summary */
+    summary?: string;
+    /** Handler description */
+    description?: string;
+    /** Content type shorthand */
+    contentType?: string;
+    /** Content type configuration */
+    contentTypes?: {
+        default?: string;
+        supported?: string[];
+    };
+    /** Framing configuration */
+    framing?: {
+        type: 'length-prefixed' | 'delimiter' | 'fixed' | 'none';
+        lengthBytes?: 1 | 2 | 4 | 8;
+        byteOrder?: 'big-endian' | 'little-endian';
+        delimiter?: string;
+        fixedSize?: number;
+    };
+    /** Zod schema for request messages (will be converted to JSON Schema) */
+    requestSchema?: unknown;
+    /** Zod schema for response messages (will be converted to JSON Schema) */
+    responseSchema?: unknown;
+    /** TLS configuration */
+    tls?: {
+        enabled: boolean;
+        cert?: string;
+        key?: string;
+        ca?: string;
+        clientAuth?: boolean;
+    };
+    /** Connection lifecycle */
+    lifecycle?: {
+        onConnect?: string;
+        onDisconnect?: string;
+        keepAlive?: {
+            enabled?: boolean;
+            intervalMs?: number;
+        };
+    };
+    /** Tags for grouping */
+    tags?: string[];
+}
+/**
+ * Loaded TCP handler from discovery
+ */
+export interface LoadedTcpHandler {
+    /** Handler name */
+    name: string;
+    /** File path */
+    filePath: string;
+    /** TCP server config */
+    config: {
+        /** Port number */
+        port: number;
+        /** Host address */
+        host?: string;
+        /** TLS enabled */
+        tls?: boolean;
+        /** Optional docs field */
+        docs?: TcpHandlerDocs;
+        /** Connection handler */
+        onConnection?: (socket: unknown) => void | Promise<void>;
+        /** Data handler */
+        onData?: (socket: unknown, data: unknown) => void | Promise<void>;
+        /** Close handler */
+        onClose?: (socket: unknown) => void | Promise<void>;
+    };
+}
+/**
+ * TCP generation options
+ */
+export interface TcpGeneratorOptions {
+    /** Default host if not specified */
+    defaultHost?: string;
+    /** Default framing if not specified */
+    defaultFraming?: USDTcpFraming;
+    /** Default security requirement */
+    defaultSecurity?: Array<Record<string, string[]>>;
+    /** Protocol content types */
+    contentTypes?: USDContentTypes;
+}
+/**
+ * TCP generation context
+ */
+export interface TcpGeneratorContext {
+    /** Loaded TCP handlers */
+    handlers: LoadedTcpHandler[];
+}
+/**
+ * TCP generation result
+ */
+export interface TcpGeneratorResult {
+    /** USD TCP specification */
+    tcp: USDTcp;
+    /** Component schemas used */
+    schemas: Record<string, USDSchema>;
+}
+/**
+ * Generate USD TCP specification from loaded TCP handlers
+ */
+export declare function generateTcp(ctx: TcpGeneratorContext, options?: TcpGeneratorOptions): TcpGeneratorResult;
+/**
+ * Helper to create a TCP server definition for manual configuration
+ */
+export declare function createTcpServerConfig(options: {
+    name: string;
+    port: number;
+    host?: string;
+    description?: string;
+    contentType?: string;
+    contentTypes?: TcpHandlerDocs['contentTypes'];
+    framing?: USDTcpFraming;
+    requestSchema?: unknown;
+    responseSchema?: unknown;
+    tls?: boolean;
+    tags?: string[];
+}): LoadedTcpHandler;
+/**
+ * Generate standard TCP schemas for common patterns
+ */
+export declare function generateTcpSchemas(): Record<string, USDSchema>;
+//# sourceMappingURL=tcp-generator.d.ts.map

package/dist/docs/generators/tcp-generator.d.ts.map

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

package/dist/docs/generators/tcp-generator.js

@@ -0,0 +1,227 @@
+/**
+ * TCP Generator for USD
+ *
+ * Converts Raffel TCP handlers to USD TCP specification (x-usd.tcp).
+ */
+import { USD_PROTOCOL_CONTENT_TYPES } from '../../usd/index.js';
+import { createSchemaRegistry } from './schema-converter.js';
+import { resolveContentTypes } from './content-types.js';
+/**
+ * Generate USD TCP specification from loaded TCP handlers
+ */
+export function generateTcp(ctx, options = {}) {
+    const { defaultHost = 'localhost', defaultFraming = { type: 'length-prefixed', lengthBytes: 4, byteOrder: 'big-endian' }, defaultSecurity, contentTypes = USD_PROTOCOL_CONTENT_TYPES.tcp, } = options;
+    const protocolContentTypes = contentTypes;
+    const schemaRegistry = createSchemaRegistry();
+    const servers = {};
+    for (const handler of ctx.handlers) {
+        const serverName = sanitizeName(handler.name);
+        servers[serverName] = convertTcpHandler(handler, schemaRegistry, defaultHost, defaultFraming, protocolContentTypes, defaultSecurity);
+    }
+    return {
+        tcp: {
+            contentTypes: protocolContentTypes,
+            servers: Object.keys(servers).length > 0 ? servers : undefined,
+        },
+        schemas: schemaRegistry.toObject(),
+    };
+}
+/**
+ * Convert a TCP handler to USD TcpServer
+ */
+function convertTcpHandler(handler, schemaRegistry, defaultHost, defaultFraming, protocolContentTypes, defaultSecurity) {
+    const { config } = handler;
+    const docs = config.docs;
+    const resolvedContentTypes = resolveContentTypes(docs);
+    const messageContentType = resolvedContentTypes?.default ?? protocolContentTypes.default;
+    const server = {
+        host: config.host ?? defaultHost,
+        port: config.port,
+    };
+    // Add description
+    if (docs?.description) {
+        server.description = docs.description;
+    }
+    else if (docs?.summary) {
+        server.description = docs.summary;
+    }
+    else {
+        server.description = `TCP server: ${handler.name}`;
+    }
+    // Add TLS configuration
+    if (docs?.tls || config.tls) {
+        server.tls = convertTls(docs?.tls, config.tls);
+    }
+    // Add framing configuration
+    if (docs?.framing) {
+        server.framing = docs.framing;
+    }
+    else {
+        server.framing = defaultFraming;
+    }
+    // Add message schemas
+    const messages = convertMessages(handler.name, docs, schemaRegistry, messageContentType);
+    if (messages) {
+        server.messages = messages;
+    }
+    // Add lifecycle
+    if (docs?.lifecycle) {
+        server.lifecycle = docs.lifecycle;
+    }
+    // Add tags
+    if (docs?.tags && docs.tags.length > 0) {
+        server.tags = docs.tags;
+    }
+    else {
+        // Extract tags from handler name
+        const tags = extractTags(handler.name);
+        if (tags.length > 0) {
+            server.tags = tags;
+        }
+    }
+    // Add security
+    if (defaultSecurity) {
+        server.security = defaultSecurity;
+    }
+    if (resolvedContentTypes) {
+        server.contentTypes = resolvedContentTypes;
+    }
+    return server;
+}
+/**
+ * Convert TLS configuration
+ */
+function convertTls(docs, enabled) {
+    if (docs) {
+        return docs;
+    }
+    return {
+        enabled: enabled ?? false,
+    };
+}
+/**
+ * Convert message schemas
+ */
+function convertMessages(handlerName, docs, schemaRegistry, contentType) {
+    if (!docs?.requestSchema && !docs?.responseSchema) {
+        return undefined;
+    }
+    const messages = {};
+    const baseName = sanitizeName(handlerName);
+    if (docs.requestSchema) {
+        const schemaName = `${baseName}Request`;
+        schemaRegistry.add(schemaName, docs.requestSchema);
+        messages.inbound = createMessageRef(schemaName, contentType);
+    }
+    if (docs.responseSchema) {
+        const schemaName = `${baseName}Response`;
+        schemaRegistry.add(schemaName, docs.responseSchema);
+        messages.outbound = createMessageRef(schemaName, contentType);
+    }
+    return messages;
+}
+function createMessageRef(schemaName, contentType) {
+    return {
+        contentType,
+        payload: { $ref: `#/components/schemas/${schemaName}` },
+    };
+}
+/**
+ * Sanitize handler name for schema naming
+ */
+function sanitizeName(name) {
+    return name
+        .replace(/\./g, '_')
+        .replace(/-/g, '_')
+        .split('_')
+        .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+        .join('');
+}
+/**
+ * Extract tags from handler name
+ */
+function extractTags(name) {
+    const parts = name.split('.');
+    if (parts.length > 1) {
+        return [parts[0]];
+    }
+    const segments = name.split(/[-_]/);
+    if (segments.length > 1) {
+        return [segments[0]];
+    }
+    return [];
+}
+/**
+ * Helper to create a TCP server definition for manual configuration
+ */
+export function createTcpServerConfig(options) {
+    return {
+        name: options.name,
+        filePath: `<manual>/${options.name}.ts`,
+        config: {
+            port: options.port,
+            host: options.host,
+            tls: options.tls,
+            docs: {
+                description: options.description,
+                contentType: options.contentType,
+                contentTypes: options.contentTypes,
+                framing: options.framing,
+                requestSchema: options.requestSchema,
+                responseSchema: options.responseSchema,
+                tags: options.tags,
+            },
+        },
+    };
+}
+/**
+ * Generate standard TCP schemas for common patterns
+ */
+export function generateTcpSchemas() {
+    return {
+        TcpLengthPrefixedFrame: {
+            type: 'object',
+            description: 'Length-prefixed binary frame',
+            properties: {
+                length: { type: 'integer', description: 'Message length in bytes' },
+                payload: { type: 'string', format: 'binary', description: 'Message payload' },
+            },
+            required: ['length', 'payload'],
+        },
+        TcpDelimitedFrame: {
+            type: 'object',
+            description: 'Delimiter-separated frame (typically newline)',
+            properties: {
+                data: { type: 'string', description: 'Frame data (excluding delimiter)' },
+            },
+            required: ['data'],
+        },
+        TcpHandshake: {
+            type: 'object',
+            description: 'Standard TCP handshake message',
+            properties: {
+                version: { type: 'string', description: 'Protocol version' },
+                clientId: { type: 'string', description: 'Client identifier' },
+                timestamp: { type: 'integer', description: 'Unix timestamp' },
+                auth: {
+                    type: 'object',
+                    description: 'Authentication data',
+                    properties: {
+                        token: { type: 'string' },
+                        signature: { type: 'string' },
+                    },
+                },
+            },
+            required: ['version'],
+        },
+        TcpHeartbeat: {
+            type: 'object',
+            description: 'Keep-alive heartbeat message',
+            properties: {
+                timestamp: { type: 'integer', description: 'Unix timestamp' },
+                sequence: { type: 'integer', description: 'Sequence number' },
+            },
+        },
+    };
+}
+//# sourceMappingURL=tcp-generator.js.map

package/dist/docs/generators/tcp-generator.js.map

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