raffel 0.1.2

package/dist/docs/generators/errors.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Raffel-Errors Spec Generator
+ *
+ * Generates error documentation with protocol mappings
+ * from the standard error codes and any custom registered errors.
+ */
+import type { ErrorsDocument, ErrorCategory, ProtocolMappings, GrpcStatusCode, GrpcStatusName } from './errors-types.js';
+export interface ErrorRegistryEntry {
+    summary: string;
+    description?: string;
+    category: ErrorCategory;
+    retryable?: boolean;
+    retryAfter?: string;
+    mappings?: ProtocolMappings;
+    causes?: string[];
+    solutions?: string[];
+}
+/**
+ * Register a custom error code with protocol mappings
+ *
+ * @example
+ * ```ts
+ * registerErrorCode('QUOTA_EXCEEDED', {
+ *   summary: 'Quota Exceeded',
+ *   description: 'You have exceeded your usage quota',
+ *   category: 'client',
+ *   retryable: false,
+ *   mappings: {
+ *     http: { status: 402 },
+ *     grpc: { code: 8, codeName: 'RESOURCE_EXHAUSTED' },
+ *     websocket: { close: 4402 },
+ *     jsonrpc: { code: -32010 }
+ *   }
+ * })
+ * ```
+ */
+export declare function registerErrorCode(code: string, definition: ErrorRegistryEntry): void;
+/**
+ * Get all registered error codes (standard + custom)
+ */
+export declare function getErrorCodes(): Map<string, ErrorRegistryEntry>;
+/**
+ * Clear custom error codes (useful for testing)
+ */
+export declare function clearCustomErrorCodes(): void;
+export interface GenerateErrorsOptions {
+    /** Include only specific error codes */
+    include?: string[];
+    /** Exclude specific error codes */
+    exclude?: string[];
+    /** Include example for each error */
+    includeExamples?: boolean;
+}
+/**
+ * Generate Raffel-Errors specification document
+ *
+ * @example
+ * ```ts
+ * const errorsSpec = generateErrorsSpec()
+ * // Returns ErrorsDocument with all standard + custom errors
+ * ```
+ */
+export declare function generateErrorsSpec(options?: GenerateErrorsOptions): ErrorsDocument;
+/**
+ * Get HTTP status code for an error
+ */
+export declare function getHttpStatus(code: string): number;
+/**
+ * Get gRPC status code for an error
+ */
+export declare function getGrpcCode(code: string): GrpcStatusCode;
+/**
+ * Get gRPC status name for an error
+ */
+export declare function getGrpcName(code: string): GrpcStatusName;
+/**
+ * Get WebSocket close code for an error
+ */
+export declare function getWebSocketClose(code: string): number;
+/**
+ * Get JSON-RPC error code for an error
+ */
+export declare function getJsonRpcCode(code: string): number;
+/**
+ * Check if an error is retryable
+ */
+export declare function isRetryable(code: string): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/docs/generators/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/docs/generators/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EAEd,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,cAAc,EACf,MAAM,mBAAmB,CAAA;AAO1B,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,aAAa,CAAA;IACvB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAKpF;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAc/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAMD,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,qCAAqC;IACrC,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CA8DtF;AA8DD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAIxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAIxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAItD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIjD"}

package/dist/docs/generators/errors.js

@@ -0,0 +1,224 @@
+/**
+ * Raffel-Errors Spec Generator
+ *
+ * Generates error documentation with protocol mappings
+ * from the standard error codes and any custom registered errors.
+ */
+import { RAFFEL_ERRORS_VERSION, SCHEMA_URLS, STANDARD_ERROR_CODES } from './errors-types.js';
+const customErrors = new Map();
+/**
+ * Register a custom error code with protocol mappings
+ *
+ * @example
+ * ```ts
+ * registerErrorCode('QUOTA_EXCEEDED', {
+ *   summary: 'Quota Exceeded',
+ *   description: 'You have exceeded your usage quota',
+ *   category: 'client',
+ *   retryable: false,
+ *   mappings: {
+ *     http: { status: 402 },
+ *     grpc: { code: 8, codeName: 'RESOURCE_EXHAUSTED' },
+ *     websocket: { close: 4402 },
+ *     jsonrpc: { code: -32010 }
+ *   }
+ * })
+ * ```
+ */
+export function registerErrorCode(code, definition) {
+    if (code in STANDARD_ERROR_CODES) {
+        throw new Error(`Cannot override standard error code: ${code}`);
+    }
+    customErrors.set(code, definition);
+}
+/**
+ * Get all registered error codes (standard + custom)
+ */
+export function getErrorCodes() {
+    const all = new Map();
+    // Add standard errors
+    for (const [code, def] of Object.entries(STANDARD_ERROR_CODES)) {
+        all.set(code, def);
+    }
+    // Add custom errors
+    for (const [code, def] of customErrors) {
+        all.set(code, def);
+    }
+    return all;
+}
+/**
+ * Clear custom error codes (useful for testing)
+ */
+export function clearCustomErrorCodes() {
+    customErrors.clear();
+}
+/**
+ * Generate Raffel-Errors specification document
+ *
+ * @example
+ * ```ts
+ * const errorsSpec = generateErrorsSpec()
+ * // Returns ErrorsDocument with all standard + custom errors
+ * ```
+ */
+export function generateErrorsSpec(options = {}) {
+    const { include, exclude, includeExamples = true } = options;
+    const allErrors = getErrorCodes();
+    const errors = {};
+    for (const [code, entry] of allErrors) {
+        // Filter by include/exclude
+        if (include && !include.includes(code))
+            continue;
+        if (exclude && exclude.includes(code))
+            continue;
+        const definition = {
+            summary: entry.summary,
+            description: entry.description,
+            category: entry.category,
+            retryable: entry.retryable ?? false,
+            retryAfter: entry.retryAfter,
+            mappings: entry.mappings,
+            causes: entry.causes,
+            solutions: entry.solutions,
+        };
+        // Add example if requested
+        if (includeExamples) {
+            definition.example = {
+                code,
+                message: generateExampleMessage(code, entry),
+                details: generateExampleDetails(code, entry),
+            };
+        }
+        errors[code] = definition;
+    }
+    return {
+        $schema: SCHEMA_URLS.errors,
+        raffelErrors: RAFFEL_ERRORS_VERSION,
+        errors,
+        definitions: {
+            Error: {
+                type: 'object',
+                properties: {
+                    code: { type: 'string', description: 'Error code' },
+                    message: { type: 'string', description: 'Human-readable message' },
+                    details: { type: 'object', description: 'Additional context' },
+                },
+                required: ['code', 'message'],
+            },
+            StreamError: {
+                allOf: [
+                    { $ref: '#/definitions/Error' },
+                    {
+                        type: 'object',
+                        properties: {
+                            recoverable: { type: 'boolean', description: 'Can stream continue?' },
+                            position: { type: 'integer', description: 'Last processed position' },
+                        },
+                    },
+                ],
+            },
+        },
+    };
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+function generateExampleMessage(code, entry) {
+    switch (code) {
+        case 'VALIDATION_ERROR':
+            return 'Invalid email format';
+        case 'NOT_FOUND':
+            return 'User not found';
+        case 'UNAUTHENTICATED':
+            return 'Authentication required';
+        case 'PERMISSION_DENIED':
+            return 'You do not have permission to access this resource';
+        case 'RATE_LIMITED':
+            return 'Too many requests. Please try again in 60 seconds.';
+        case 'INTERNAL_ERROR':
+            return 'An unexpected error occurred';
+        case 'UNAVAILABLE':
+            return 'Service temporarily unavailable';
+        case 'DEADLINE_EXCEEDED':
+            return 'Request timeout exceeded';
+        case 'ALREADY_EXISTS':
+            return 'Resource already exists';
+        default:
+            return entry.summary;
+    }
+}
+function generateExampleDetails(code, _entry) {
+    switch (code) {
+        case 'VALIDATION_ERROR':
+            return {
+                field: 'email',
+                constraint: 'email',
+                value: 'invalid-email',
+            };
+        case 'NOT_FOUND':
+            return {
+                resource: 'user',
+                id: '123',
+            };
+        case 'RATE_LIMITED':
+            return {
+                limit: 100,
+                remaining: 0,
+                resetAt: new Date(Date.now() + 60000).toISOString(),
+            };
+        default:
+            return undefined;
+    }
+}
+// =============================================================================
+// Protocol Mappers
+// =============================================================================
+/**
+ * Get HTTP status code for an error
+ */
+export function getHttpStatus(code) {
+    const errors = getErrorCodes();
+    const error = errors.get(code);
+    return error?.mappings?.http?.status ?? 500;
+}
+/**
+ * Get gRPC status code for an error
+ */
+export function getGrpcCode(code) {
+    const errors = getErrorCodes();
+    const error = errors.get(code);
+    return (error?.mappings?.grpc?.code ?? 2);
+}
+/**
+ * Get gRPC status name for an error
+ */
+export function getGrpcName(code) {
+    const errors = getErrorCodes();
+    const error = errors.get(code);
+    return error?.mappings?.grpc?.codeName ?? 'UNKNOWN';
+}
+/**
+ * Get WebSocket close code for an error
+ */
+export function getWebSocketClose(code) {
+    const errors = getErrorCodes();
+    const error = errors.get(code);
+    return error?.mappings?.websocket?.close ?? 4500;
+}
+/**
+ * Get JSON-RPC error code for an error
+ */
+export function getJsonRpcCode(code) {
+    const errors = getErrorCodes();
+    const error = errors.get(code);
+    return error?.mappings?.jsonrpc?.code ?? -32603;
+}
+/**
+ * Check if an error is retryable
+ */
+export function isRetryable(code) {
+    const errors = getErrorCodes();
+    const error = errors.get(code);
+    return error?.retryable ?? false;
+}
+//# sourceMappingURL=errors.js.map

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

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

package/dist/docs/generators/generators.int.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generators.int.test.d.ts.map

package/dist/docs/generators/generators.int.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.int.test.d.ts","sourceRoot":"","sources":["../../../src/docs/generators/generators.int.test.ts"],"names":[],"mappings":""}

package/dist/docs/generators/generators.int.test.js

@@ -0,0 +1,105 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { generateErrorsSpec, registerErrorCode, clearCustomErrorCodes, getHttpStatus, getGrpcCode, getWebSocketClose, getJsonRpcCode, isRetryable, } from './errors.js';
+// =============================================================================
+// Error Generator Tests
+// =============================================================================
+describe('generateErrorsSpec', () => {
+    beforeEach(() => {
+        clearCustomErrorCodes();
+    });
+    it('should generate spec with standard error codes', () => {
+        const spec = generateErrorsSpec();
+        expect(spec.raffelErrors).toBe('1.0.0');
+        expect(spec.errors).toBeDefined();
+        expect(spec.errors.VALIDATION_ERROR).toBeDefined();
+        expect(spec.errors.NOT_FOUND).toBeDefined();
+        expect(spec.errors.UNAUTHENTICATED).toBeDefined();
+        expect(spec.errors.RATE_LIMITED).toBeDefined();
+    });
+    it('should include protocol mappings', () => {
+        const spec = generateErrorsSpec();
+        const validationError = spec.errors.VALIDATION_ERROR;
+        expect(validationError.mappings?.http?.status).toBe(400);
+        expect(validationError.mappings?.grpc?.code).toBe(3);
+        expect(validationError.mappings?.websocket?.close).toBe(4400);
+        expect(validationError.mappings?.jsonrpc?.code).toBe(-32602);
+    });
+    it('should include examples when enabled', () => {
+        const spec = generateErrorsSpec({ includeExamples: true });
+        expect(spec.errors.VALIDATION_ERROR.example).toBeDefined();
+        expect(spec.errors.VALIDATION_ERROR.example?.code).toBe('VALIDATION_ERROR');
+        expect(spec.errors.VALIDATION_ERROR.example?.message).toBe('Invalid email format');
+    });
+    it('should include Error and StreamError definitions', () => {
+        const spec = generateErrorsSpec();
+        expect(spec.definitions?.Error).toBeDefined();
+        expect(spec.definitions?.StreamError).toBeDefined();
+    });
+    it('should filter errors with include option', () => {
+        const spec = generateErrorsSpec({ include: ['VALIDATION_ERROR', 'NOT_FOUND'] });
+        expect(Object.keys(spec.errors)).toHaveLength(2);
+        expect(spec.errors.VALIDATION_ERROR).toBeDefined();
+        expect(spec.errors.NOT_FOUND).toBeDefined();
+        expect(spec.errors.UNAUTHENTICATED).toBeUndefined();
+    });
+    it('should filter errors with exclude option', () => {
+        const spec = generateErrorsSpec({ exclude: ['DEADLINE_EXCEEDED', 'ALREADY_EXISTS'] });
+        expect(spec.errors.DEADLINE_EXCEEDED).toBeUndefined();
+        expect(spec.errors.ALREADY_EXISTS).toBeUndefined();
+        expect(spec.errors.VALIDATION_ERROR).toBeDefined();
+    });
+});
+describe('registerErrorCode', () => {
+    beforeEach(() => {
+        clearCustomErrorCodes();
+    });
+    it('should register custom error codes', () => {
+        registerErrorCode('QUOTA_EXCEEDED', {
+            summary: 'Quota Exceeded',
+            category: 'client',
+            mappings: {
+                http: { status: 402 },
+                grpc: { code: 8, codeName: 'RESOURCE_EXHAUSTED' },
+                websocket: { close: 4402 },
+                jsonrpc: { code: -32010 },
+            },
+        });
+        const spec = generateErrorsSpec();
+        expect(spec.errors.QUOTA_EXCEEDED).toBeDefined();
+        expect(spec.errors.QUOTA_EXCEEDED.summary).toBe('Quota Exceeded');
+        expect(spec.errors.QUOTA_EXCEEDED.mappings?.http?.status).toBe(402);
+    });
+    it('should throw when overriding standard error codes', () => {
+        expect(() => registerErrorCode('VALIDATION_ERROR', {
+            summary: 'Custom',
+            category: 'client',
+        })).toThrow('Cannot override standard error code');
+    });
+});
+describe('Protocol mappers', () => {
+    it('should return correct HTTP status', () => {
+        expect(getHttpStatus('VALIDATION_ERROR')).toBe(400);
+        expect(getHttpStatus('NOT_FOUND')).toBe(404);
+        expect(getHttpStatus('RATE_LIMITED')).toBe(429);
+        expect(getHttpStatus('UNKNOWN_CODE')).toBe(500); // default
+    });
+    it('should return correct gRPC code', () => {
+        expect(getGrpcCode('VALIDATION_ERROR')).toBe(3);
+        expect(getGrpcCode('NOT_FOUND')).toBe(5);
+        expect(getGrpcCode('UNAUTHENTICATED')).toBe(16);
+    });
+    it('should return correct WebSocket close code', () => {
+        expect(getWebSocketClose('VALIDATION_ERROR')).toBe(4400);
+        expect(getWebSocketClose('NOT_FOUND')).toBe(4404);
+    });
+    it('should return correct JSON-RPC code', () => {
+        expect(getJsonRpcCode('VALIDATION_ERROR')).toBe(-32602);
+        expect(getJsonRpcCode('INTERNAL_ERROR')).toBe(-32603);
+    });
+    it('should check retryable status', () => {
+        expect(isRetryable('VALIDATION_ERROR')).toBe(false);
+        expect(isRetryable('RATE_LIMITED')).toBe(true);
+        expect(isRetryable('INTERNAL_ERROR')).toBe(true);
+    });
+});
+//# sourceMappingURL=generators.int.test.js.map

package/dist/docs/generators/generators.int.test.js.map

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

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

@@ -0,0 +1,53 @@
+/**
+ * gRPC Generator for USD
+ *
+ * Converts Raffel procedures to USD gRPC specification (x-usd.grpc).
+ */
+import type { Registry } from '../../core/registry.js';
+import type { SchemaRegistry } from '../../validation/index.js';
+import type { USDGrpc, USDContentTypes, USDSchema } from '../../usd/index.js';
+/**
+ * gRPC generation options
+ */
+export interface GrpcGeneratorOptions {
+    /** Proto package name */
+    package?: string;
+    /** Proto syntax version */
+    syntax?: 'proto3' | 'proto2';
+    /** Proto file options */
+    options?: Record<string, unknown>;
+    /** Protocol content types */
+    contentTypes?: USDContentTypes;
+    /** Override service/method names for specific procedures */
+    serviceNameOverrides?: Record<string, {
+        service: string;
+        method?: string;
+    }>;
+    /** Default service name for procedures without namespace */
+    defaultServiceName?: string;
+}
+/**
+ * gRPC generation context
+ */
+export interface GrpcGeneratorContext {
+    /** Handler registry */
+    registry: Registry;
+    /** Schema registry for input/output schemas */
+    schemaRegistry?: SchemaRegistry;
+}
+/**
+ * gRPC generation result
+ */
+export interface GrpcGeneratorResult {
+    /** USD gRPC specification */
+    grpc: USDGrpc;
+    /** Component schemas used */
+    schemas: Record<string, USDSchema>;
+    /** Tags used */
+    tags: Set<string>;
+}
+/**
+ * Generate USD gRPC specification from registered procedures
+ */
+export declare function generateGrpc(ctx: GrpcGeneratorContext, options?: GrpcGeneratorOptions): GrpcGeneratorResult;
+//# sourceMappingURL=grpc-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grpc-generator.d.ts","sourceRoot":"","sources":["../../../src/docs/generators/grpc-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,OAAO,EAGP,eAAe,EACf,SAAS,EACV,MAAM,oBAAoB,CAAA;AAU3B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC5B,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,6BAA6B;IAC7B,YAAY,CAAC,EAAE,eAAe,CAAA;IAC9B,4DAA4D;IAC5D,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC3E,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,QAAQ,EAAE,QAAQ,CAAA;IAClB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,cAAc,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAA;IACb,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,YAAY,CAC1B,GAAG,EAAE,oBAAoB,EACzB,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CA+CrB"}

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

@@ -0,0 +1,109 @@
+/**
+ * gRPC Generator for USD
+ *
+ * Converts Raffel procedures to USD gRPC specification (x-usd.grpc).
+ */
+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 gRPC specification from registered procedures
+ */
+export function generateGrpc(ctx, options = {}) {
+    const { package: packageName, syntax = 'proto3', options: grpcOptions, contentTypes = USD_PROTOCOL_CONTENT_TYPES.grpc, serviceNameOverrides, defaultServiceName = 'Service', } = options;
+    const schemaRegistry = createSchemaRegistry();
+    const services = {};
+    const tags = new Set();
+    for (const meta of ctx.registry.listProcedures()) {
+        const handlerSchema = ctx.schemaRegistry?.get(meta.name);
+        const mapping = resolveServiceAndMethod(meta.name, serviceNameOverrides, defaultServiceName);
+        if (!services[mapping.service]) {
+            services[mapping.service] = {};
+        }
+        if (!services[mapping.service].methods) {
+            services[mapping.service].methods = {};
+        }
+        services[mapping.service].methods[mapping.method] = createMethod(meta, handlerSchema, schemaRegistry, [mapping.service]);
+        tags.add(mapping.service);
+    }
+    return {
+        grpc: {
+            package: packageName,
+            syntax,
+            contentTypes,
+            services: Object.keys(services).length > 0 ? services : undefined,
+            options: grpcOptions,
+        },
+        schemas: schemaRegistry.toObject(),
+        tags,
+    };
+}
+/**
+ * Create gRPC method definition
+ */
+function createMethod(meta, handlerSchema, schemaRegistry, tags) {
+    const method = {
+        input: { type: 'object' },
+        output: { type: 'object' },
+    };
+    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.input = createRef(schemaName);
+    }
+    if (handlerSchema?.output) {
+        const schemaName = generateSchemaName(meta.name, 'Output');
+        schemaRegistry.add(schemaName, handlerSchema.output);
+        method.output = createRef(schemaName);
+    }
+    if (meta.grpc?.clientStreaming) {
+        method['x-usd-client-streaming'] = true;
+    }
+    if (meta.grpc?.serverStreaming) {
+        method['x-usd-server-streaming'] = true;
+    }
+    if (resolvedContentTypes) {
+        method.contentTypes = resolvedContentTypes;
+    }
+    return method;
+}
+function resolveServiceAndMethod(name, overrides, defaultServiceName) {
+    const override = overrides?.[name];
+    if (override) {
+        const method = override.method ?? deriveMethodName(name);
+        return { service: override.service, method };
+    }
+    const parts = name.split('.').filter(Boolean);
+    if (parts.length > 1) {
+        return {
+            service: toPascalCase(parts[0]),
+            method: toPascalCase(parts.slice(1).join('-')),
+        };
+    }
+    return {
+        service: defaultServiceName,
+        method: toPascalCase(name),
+    };
+}
+function deriveMethodName(name) {
+    const parts = name.split('.').filter(Boolean);
+    if (parts.length > 1) {
+        return toPascalCase(parts.slice(1).join('-'));
+    }
+    return toPascalCase(name);
+}
+function toPascalCase(value) {
+    return value
+        .split(/[^a-zA-Z0-9]/)
+        .filter(Boolean)
+        .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))
+        .join('');
+}
+//# sourceMappingURL=grpc-generator.js.map

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

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