raffel 0.1.2

package/dist/docs/generators/index.js

@@ -0,0 +1,30 @@
+/**
+ * Documentation Generators
+ *
+ * Generate documentation specs from Registry and server configuration.
+ * All generators produce USD (Universal Service Documentation) format.
+ */
+// =============================================================================
+// USD Generators
+// =============================================================================
+// Main USD generator (orchestrates all protocol generators)
+export { generateUSD, createHttpOnlyUSD, createWebSocketOnlyUSD, createStreamsOnlyUSD, createTcpOnlyUSD, createUdpOnlyUSD, } from './usd-generator.js';
+// HTTP generator (procedures → paths)
+export { generateHttpPaths, } from './http-generator.js';
+// WebSocket generator (channels → x-usd.websocket)
+export { generateWebSocket, generateChannelSchemas, } from './websocket-generator.js';
+// Streams generator (streams → x-usd.streams)
+export { generateStreams, generateStreamEvents, createSSEStreamConfig, createBidiStreamConfig, } from './streams-generator.js';
+// JSON-RPC generator (procedures → x-usd.jsonrpc)
+export { generateJsonRpc, } from './jsonrpc-generator.js';
+// gRPC generator (procedures → x-usd.grpc)
+export { generateGrpc, } from './grpc-generator.js';
+// TCP generator (handlers → x-usd.tcp)
+export { generateTcp, generateTcpSchemas, createTcpServerConfig, } from './tcp-generator.js';
+// UDP generator (handlers → x-usd.udp)
+export { generateUdp, generateUdpSchemas, createUdpEndpointConfig, } from './udp-generator.js';
+// Schema converter (Zod → JSON Schema)
+export { convertSchema, createSchemaRegistry, isZodSchema, isJsonSchema, convertAndRegister, extractParameters, generateSchemaName, createRef, createArraySchema, createPaginatedSchema, createErrorSchema, } from './schema-converter.js';
+// Errors generator
+export { generateErrorsSpec, registerErrorCode, getErrorCodes, clearCustomErrorCodes, getHttpStatus, getGrpcCode, getGrpcName, getWebSocketClose, getJsonRpcCode, isRetryable, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/docs/generators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/docs/generators/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,4DAA4D;AAC5D,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GAKjB,MAAM,oBAAoB,CAAA;AAE3B,sCAAsC;AACtC,OAAO,EACL,iBAAiB,GAIlB,MAAM,qBAAqB,CAAA;AAE5B,mDAAmD;AACnD,OAAO,EACL,iBAAiB,EACjB,sBAAsB,GAIvB,MAAM,0BAA0B,CAAA;AAEjC,8CAA8C;AAC9C,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GAIvB,MAAM,wBAAwB,CAAA;AAE/B,kDAAkD;AAClD,OAAO,EACL,eAAe,GAIhB,MAAM,wBAAwB,CAAA;AAE/B,2CAA2C;AAC3C,OAAO,EACL,YAAY,GAIb,MAAM,qBAAqB,CAAA;AAE5B,uCAAuC;AACvC,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,qBAAqB,GAMtB,MAAM,oBAAoB,CAAA;AAE3B,uCAAuC;AACvC,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,uBAAuB,GAMxB,MAAM,oBAAoB,CAAA;AAE3B,uCAAuC;AACvC,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,GAIlB,MAAM,uBAAuB,CAAA;AAE9B,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,WAAW,GAGZ,MAAM,aAAa,CAAA"}

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

@@ -0,0 +1,53 @@
+/**
+ * JSON-RPC Generator for USD
+ *
+ * Converts Raffel procedures to USD JSON-RPC specification (x-usd.jsonrpc).
+ */
+import type { Registry } from '../../core/registry.js';
+import type { SchemaRegistry } from '../../validation/index.js';
+import type { USDJsonRpc, USDContentTypes, USDSchema } from '../../usd/index.js';
+/**
+ * JSON-RPC generation options
+ */
+export interface JsonRpcGeneratorOptions {
+    /** JSON-RPC endpoint path */
+    endpoint?: string;
+    /** JSON-RPC version */
+    version?: '2.0';
+    /** Protocol content types */
+    contentTypes?: USDContentTypes;
+    /** Enable batch support */
+    batch?: {
+        enabled?: boolean;
+        maxSize?: number;
+    };
+    /** Group methods by namespace as tags */
+    groupByNamespace?: boolean;
+    /** Default security requirement */
+    defaultSecurity?: Array<Record<string, string[]>>;
+}
+/**
+ * JSON-RPC generation context
+ */
+export interface JsonRpcGeneratorContext {
+    /** Handler registry */
+    registry: Registry;
+    /** Schema registry for input/output schemas */
+    schemaRegistry?: SchemaRegistry;
+}
+/**
+ * JSON-RPC generation result
+ */
+export interface JsonRpcGeneratorResult {
+    /** USD JSON-RPC specification */
+    jsonrpc: USDJsonRpc;
+    /** Component schemas used */
+    schemas: Record<string, USDSchema>;
+    /** Tags used */
+    tags: Set<string>;
+}
+/**
+ * Generate USD JSON-RPC specification from registered procedures
+ */
+export declare function generateJsonRpc(ctx: JsonRpcGeneratorContext, options?: JsonRpcGeneratorOptions): JsonRpcGeneratorResult;
+//# sourceMappingURL=jsonrpc-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc-generator.d.ts","sourceRoot":"","sources":["../../../src/docs/generators/jsonrpc-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,2BAA2B,CAAA;AAC9E,OAAO,KAAK,EACV,UAAU,EAGV,eAAe,EACf,SAAS,EACV,MAAM,oBAAoB,CAAA;AAU3B;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uBAAuB;IACvB,OAAO,CAAC,EAAE,KAAK,CAAA;IACf,6BAA6B;IAC7B,YAAY,CAAC,EAAE,eAAe,CAAA;IAC9B,2BAA2B;IAC3B,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,mCAAmC;IACnC,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uBAAuB;IACvB,QAAQ,EAAE,QAAQ,CAAA;IAClB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,cAAc,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,OAAO,EAAE,UAAU,CAAA;IACnB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAClC,gBAAgB;IAChB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAClB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,uBAAuB,EAC5B,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CA0CxB"}

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

@@ -0,0 +1,111 @@
+/**
+ * JSON-RPC Generator for USD
+ *
+ * Converts Raffel procedures to USD JSON-RPC specification (x-usd.jsonrpc).
+ */
+import { USD_PROTOCOL_CONTENT_TYPES } from '../../usd/index.js';
+import { createSchemaRegistry, generateSchemaName, createRef, } from './schema-converter.js';
+import { resolveContentTypes } from './content-types.js';
+/**
+ * Generate USD JSON-RPC specification from registered procedures
+ */
+export function generateJsonRpc(ctx, options = {}) {
+    const { endpoint = '/rpc', version = '2.0', contentTypes = USD_PROTOCOL_CONTENT_TYPES.jsonrpc, batch, groupByNamespace = true, defaultSecurity, } = options;
+    const schemaRegistry = createSchemaRegistry();
+    const methods = {};
+    const tags = new Set();
+    for (const meta of ctx.registry.listProcedures()) {
+        const handlerSchema = ctx.schemaRegistry?.get(meta.name);
+        const namespace = groupByNamespace ? extractNamespace(meta.name) : undefined;
+        if (namespace) {
+            tags.add(namespace);
+        }
+        methods[meta.name] = createMethod(meta, handlerSchema, schemaRegistry, namespace ? [namespace] : undefined, defaultSecurity);
+    }
+    return {
+        jsonrpc: {
+            endpoint,
+            version,
+            contentTypes,
+            methods: Object.keys(methods).length > 0 ? methods : undefined,
+            batch,
+        },
+        schemas: schemaRegistry.toObject(),
+        tags,
+    };
+}
+/**
+ * Create JSON-RPC method definition
+ */
+function createMethod(meta, handlerSchema, schemaRegistry, tags, defaultSecurity) {
+    const method = {};
+    const resolvedContentTypes = resolveContentTypes(meta);
+    if (meta.description || meta.summary) {
+        method.description = meta.description ?? meta.summary;
+    }
+    if (tags && tags.length > 0) {
+        method.tags = tags;
+    }
+    if (handlerSchema?.input) {
+        const schemaName = generateSchemaName(meta.name, 'Input');
+        schemaRegistry.add(schemaName, handlerSchema.input);
+        method.params = createRef(schemaName);
+    }
+    else {
+        method.params = { type: 'object' };
+    }
+    if (handlerSchema?.output) {
+        const schemaName = generateSchemaName(meta.name, 'Output');
+        schemaRegistry.add(schemaName, handlerSchema.output);
+        method.result = createRef(schemaName);
+    }
+    else {
+        method.result = { type: 'object' };
+    }
+    if (defaultSecurity) {
+        method.security = defaultSecurity;
+    }
+    if (resolvedContentTypes) {
+        method.contentTypes = resolvedContentTypes;
+    }
+    if (meta.jsonrpc?.streaming) {
+        method['x-usd-streaming'] = true;
+    }
+    if (meta.jsonrpc?.notification) {
+        method['x-usd-notification'] = true;
+    }
+    const errors = convertJsonRpcErrors(meta, schemaRegistry);
+    if (errors.length > 0) {
+        method.errors = errors;
+    }
+    return method;
+}
+/**
+ * Extract namespace from handler name
+ */
+function extractNamespace(name) {
+    const parts = name.split('.');
+    if (parts.length > 1) {
+        return parts[0];
+    }
+    return undefined;
+}
+function convertJsonRpcErrors(meta, schemaRegistry) {
+    const errors = meta.jsonrpc?.errors ?? [];
+    if (errors.length === 0)
+        return [];
+    return errors.map((err, index) => {
+        const definition = {
+            code: err.code,
+            message: err.message,
+            description: err.description,
+        };
+        if (err.dataSchema) {
+            const schemaName = generateSchemaName(meta.name, `Error${index + 1}Data`);
+            schemaRegistry.add(schemaName, err.dataSchema);
+            definition.data = createRef(schemaName);
+        }
+        return definition;
+    });
+}
+//# sourceMappingURL=jsonrpc-generator.js.map

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

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

package/dist/docs/generators/schema-converter.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Schema Converter
+ *
+ * Converts Zod schemas (or other validation schemas) to JSON Schema
+ * for use in USD documentation generation.
+ */
+import type { USDSchema } from '../../usd/index.js';
+/**
+ * Schema conversion options
+ */
+export interface SchemaConversionOptions {
+    /** Use $ref strategy for component schemas */
+    useRefs?: boolean;
+    /** Base path for $ref references */
+    refBasePath?: string;
+    /** Target format (affects some JSON Schema keywords) */
+    target?: 'openapi3' | 'jsonSchema2020';
+}
+/**
+ * Schema registry for tracking converted schemas
+ */
+export interface ConvertedSchemaRegistry {
+    /** Named schemas (for components/schemas) */
+    schemas: Map<string, USDSchema>;
+    /** Add a schema to the registry */
+    add(name: string, schema: unknown): USDSchema;
+    /** Get a reference to a named schema */
+    ref(name: string): USDSchema;
+    /** Get all schemas as object */
+    toObject(): Record<string, USDSchema>;
+}
+/**
+ * Create a schema registry for collecting converted schemas
+ */
+export declare function createSchemaRegistry(): ConvertedSchemaRegistry;
+/**
+ * Check if a value looks like a Zod schema
+ * Supports both Zod 3 (has _def) and Zod 4 (has def and toJSONSchema)
+ */
+export declare function isZodSchema(schema: unknown): boolean;
+/**
+ * Check if a value is already a JSON Schema
+ */
+export declare function isJsonSchema(schema: unknown): schema is USDSchema;
+/**
+ * Convert any supported schema to JSON Schema
+ *
+ * Supports:
+ * - Zod schemas
+ * - Already-JSON-Schema objects
+ * - Custom validator schemas (via registered validator)
+ */
+export declare function convertSchema(schema: unknown, options?: SchemaConversionOptions): USDSchema;
+/**
+ * Convert a schema and register it with a name
+ */
+export declare function convertAndRegister(registry: ConvertedSchemaRegistry, name: string, schema: unknown): USDSchema;
+/**
+ * Extract parameter schemas from a request schema
+ *
+ * Splits a schema into path, query, header, and body parts
+ * based on naming conventions or explicit annotations.
+ */
+export interface ExtractedParameters {
+    path: Array<{
+        name: string;
+        schema: USDSchema;
+        required: boolean;
+        description?: string;
+    }>;
+    query: Array<{
+        name: string;
+        schema: USDSchema;
+        required: boolean;
+        description?: string;
+    }>;
+    header: Array<{
+        name: string;
+        schema: USDSchema;
+        required: boolean;
+        description?: string;
+    }>;
+    body?: USDSchema;
+}
+/**
+ * Extract parameters from a schema based on path template
+ *
+ * @param schema - The input schema
+ * @param pathTemplate - The path template (e.g., '/users/{id}')
+ */
+export declare function extractParameters(schema: unknown, pathTemplate: string): ExtractedParameters;
+/**
+ * Generate a schema name from a handler name
+ *
+ * @example
+ * generateSchemaName('users.get', 'Input') => 'UsersGetInput'
+ * generateSchemaName('users.list', 'Output') => 'UsersListOutput'
+ * generateSchemaName('users.create', 'Error1Data') => 'UsersCreateError1Data'
+ */
+export declare function generateSchemaName(handlerName: string, suffix: string): string;
+/**
+ * Create a reference schema
+ */
+export declare function createRef(schemaName: string): USDSchema;
+/**
+ * Create an array schema
+ */
+export declare function createArraySchema(itemSchema: USDSchema): USDSchema;
+/**
+ * Create a paginated response schema
+ */
+export declare function createPaginatedSchema(itemSchema: USDSchema): USDSchema;
+/**
+ * Create a standard error schema
+ */
+export declare function createErrorSchema(): USDSchema;
+//# sourceMappingURL=schema-converter.d.ts.map

package/dist/docs/generators/schema-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-converter.d.ts","sourceRoot":"","sources":["../../../src/docs/generators/schema-converter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAGnD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wDAAwD;IACxD,MAAM,CAAC,EAAE,UAAU,GAAG,gBAAgB,CAAA;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC/B,mCAAmC;IACnC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7C,wCAAwC;IACxC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,gCAAgC;IAChC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CACtC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,uBAAuB,CAwB9D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAepD;AAaD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,SAAS,CAuBjE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,uBAA4B,GACpC,SAAS,CA2DX;AAsDD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,uBAAuB,EACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,GACd,SAAS,CAEX;AA+BD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACzF,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC1F,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC3F,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,MAAM,GACnB,mBAAmB,CA4DrB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM9E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAEvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,CAKlE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,CAetE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,SAAS,CA4B7C"}