raffel 0.1.2

package/dist/usd/builder/document.js

@@ -0,0 +1,418 @@
+/**
+ * USD Document Builder
+ *
+ * Provides a fluent API for building complete USD documents
+ */
+import { USD_VERSION, OPENAPI_VERSION } from '../spec/defaults.js';
+import { createHttpBuilder } from './http.js';
+import { createWebSocketBuilder } from './websocket.js';
+import { createStreamsBuilder } from './streams.js';
+import { createJsonRpcBuilder } from './jsonrpc.js';
+import { createGrpcBuilder } from './grpc.js';
+import { createTcpBuilder } from './tcp.js';
+import { createUdpBuilder } from './udp.js';
+import { serialize } from '../parser/index.js';
+/**
+ * USD Document Builder
+ */
+export class DocumentBuilder {
+    doc = {
+        usd: USD_VERSION,
+        openapi: OPENAPI_VERSION,
+    };
+    httpBuilder;
+    wsBuilder;
+    streamsBuilder;
+    rpcBuilder;
+    grpcBuilder;
+    tcpBuilder;
+    udpBuilder;
+    constructor(options) {
+        this.doc.info = {
+            title: options.title,
+            version: options.version,
+            description: options.description,
+        };
+        if (options.protocols && options.protocols.length > 0) {
+            this.ensureXUsd().protocols = options.protocols;
+        }
+    }
+    ensureXUsd() {
+        if (!this.doc['x-usd']) {
+            this.doc['x-usd'] = {};
+        }
+        return this.doc['x-usd'];
+    }
+    // ===========================================================================
+    // Info & Metadata
+    // ===========================================================================
+    /**
+     * Set description
+     */
+    description(description) {
+        this.doc.info.description = description;
+        return this;
+    }
+    /**
+     * Set summary
+     */
+    summary(summary) {
+        this.doc.info.summary = summary;
+        return this;
+    }
+    /**
+     * Set terms of service URL
+     */
+    termsOfService(url) {
+        this.doc.info.termsOfService = url;
+        return this;
+    }
+    /**
+     * Set contact information
+     */
+    contact(contact) {
+        this.doc.info.contact = contact;
+        return this;
+    }
+    /**
+     * Set license information
+     */
+    license(license) {
+        this.doc.info.license = license;
+        return this;
+    }
+    /**
+     * Set protocols
+     */
+    protocols(...protocols) {
+        this.ensureXUsd().protocols = protocols;
+        return this;
+    }
+    /**
+     * Set default and supported content types
+     */
+    contentTypes(contentTypes) {
+        this.ensureXUsd().contentTypes = contentTypes;
+        return this;
+    }
+    // ===========================================================================
+    // Servers
+    // ===========================================================================
+    /**
+     * Add a server
+     */
+    server(url, options) {
+        if (!this.doc.servers) {
+            this.doc.servers = [];
+        }
+        const protocol = options?.protocol;
+        if (protocol && protocol !== 'http') {
+            const xUsd = this.ensureXUsd();
+            if (!xUsd.servers)
+                xUsd.servers = [];
+            xUsd.servers.push({
+                url,
+                protocol,
+                description: options?.description,
+                variables: options?.variables,
+            });
+            return this;
+        }
+        const server = { url };
+        if (options?.description)
+            server.description = options.description;
+        if (options?.variables)
+            server.variables = options.variables;
+        this.doc.servers.push(server);
+        return this;
+    }
+    // ===========================================================================
+    // Tags
+    // ===========================================================================
+    /**
+     * Add a tag
+     */
+    tag(name, options) {
+        if (!this.doc.tags) {
+            this.doc.tags = [];
+        }
+        const tag = { name };
+        if (options?.description)
+            tag.description = options.description;
+        if (options?.externalDocs)
+            tag.externalDocs = options.externalDocs;
+        this.doc.tags.push(tag);
+        return this;
+    }
+    /**
+     * Set external documentation
+     */
+    externalDocs(url, description) {
+        this.doc.externalDocs = { url, description };
+        return this;
+    }
+    // ===========================================================================
+    // Components
+    // ===========================================================================
+    /**
+     * Add a schema to components
+     */
+    schema(name, schema) {
+        if (!this.doc.components) {
+            this.doc.components = {};
+        }
+        if (!this.doc.components.schemas) {
+            this.doc.components.schemas = {};
+        }
+        this.doc.components.schemas[name] = schema;
+        return this;
+    }
+    /**
+     * Add multiple schemas
+     */
+    schemas(schemas) {
+        for (const [name, schema] of Object.entries(schemas)) {
+            this.schema(name, schema);
+        }
+        return this;
+    }
+    /**
+     * Add a security scheme
+     */
+    securityScheme(name, scheme) {
+        if (!this.doc.components) {
+            this.doc.components = {};
+        }
+        if (!this.doc.components.securitySchemes) {
+            this.doc.components.securitySchemes = {};
+        }
+        this.doc.components.securitySchemes[name] = scheme;
+        return this;
+    }
+    /**
+     * Add global security requirement
+     */
+    security(...requirements) {
+        this.doc.security = requirements;
+        return this;
+    }
+    // ===========================================================================
+    // Errors
+    // ===========================================================================
+    /**
+     * Add a unified error definition
+     */
+    error(name, error) {
+        const xUsd = this.ensureXUsd();
+        if (!xUsd.errors) {
+            xUsd.errors = {};
+        }
+        xUsd.errors[name] = error;
+        return this;
+    }
+    /**
+     * Add multiple error definitions
+     */
+    errors(errors) {
+        for (const [name, error] of Object.entries(errors)) {
+            this.error(name, error);
+        }
+        return this;
+    }
+    http(path) {
+        if (!this.httpBuilder) {
+            this.httpBuilder = createHttpBuilder(this);
+        }
+        if (path) {
+            return this.httpBuilder.path(path);
+        }
+        return this.httpBuilder;
+    }
+    /**
+     * Get WebSocket builder
+     */
+    websocket() {
+        if (!this.wsBuilder) {
+            this.wsBuilder = createWebSocketBuilder(this);
+        }
+        return this.wsBuilder;
+    }
+    /**
+     * Alias for websocket()
+     */
+    ws() {
+        return this.websocket();
+    }
+    /**
+     * Get Streams builder
+     */
+    streams() {
+        if (!this.streamsBuilder) {
+            this.streamsBuilder = createStreamsBuilder(this);
+        }
+        return this.streamsBuilder;
+    }
+    /**
+     * Get JSON-RPC builder
+     */
+    jsonrpc(endpoint) {
+        if (!this.rpcBuilder) {
+            this.rpcBuilder = createJsonRpcBuilder(this);
+        }
+        if (endpoint) {
+            this.rpcBuilder.endpoint(endpoint);
+        }
+        return this.rpcBuilder;
+    }
+    /**
+     * Alias for jsonrpc()
+     */
+    rpc(endpoint) {
+        return this.jsonrpc(endpoint);
+    }
+    /**
+     * Get gRPC builder
+     */
+    grpc() {
+        if (!this.grpcBuilder) {
+            this.grpcBuilder = createGrpcBuilder(this);
+        }
+        return this.grpcBuilder;
+    }
+    /**
+     * Get TCP builder
+     */
+    tcp() {
+        if (!this.tcpBuilder) {
+            this.tcpBuilder = createTcpBuilder(this);
+        }
+        return this.tcpBuilder;
+    }
+    /**
+     * Get UDP builder
+     */
+    udp() {
+        if (!this.udpBuilder) {
+            this.udpBuilder = createUdpBuilder(this);
+        }
+        return this.udpBuilder;
+    }
+    // ===========================================================================
+    // Build
+    // ===========================================================================
+    /**
+     * Build the final USD document
+     */
+    build() {
+        const doc = {
+            usd: USD_VERSION,
+            openapi: OPENAPI_VERSION,
+            info: this.doc.info,
+        };
+        const xUsd = this.doc['x-usd'] ? { ...this.doc['x-usd'] } : {};
+        let hasXUsd = Object.keys(xUsd).length > 0;
+        // Copy optional fields
+        if (this.doc.servers)
+            doc.servers = this.doc.servers;
+        if (this.doc.tags)
+            doc.tags = this.doc.tags;
+        if (this.doc.externalDocs)
+            doc.externalDocs = this.doc.externalDocs;
+        if (this.doc.security)
+            doc.security = this.doc.security;
+        if (this.doc.components)
+            doc.components = this.doc.components;
+        // Build protocol sections
+        if (this.httpBuilder) {
+            doc.paths = this.httpBuilder.build();
+        }
+        if (this.wsBuilder) {
+            xUsd.websocket = this.wsBuilder.build();
+            hasXUsd = true;
+        }
+        if (this.streamsBuilder) {
+            xUsd.streams = this.streamsBuilder.build();
+            hasXUsd = true;
+        }
+        if (this.rpcBuilder) {
+            xUsd.jsonrpc = this.rpcBuilder.build();
+            hasXUsd = true;
+        }
+        if (this.grpcBuilder) {
+            xUsd.grpc = this.grpcBuilder.build();
+            hasXUsd = true;
+        }
+        if (this.tcpBuilder) {
+            xUsd.tcp = this.tcpBuilder.build();
+            hasXUsd = true;
+        }
+        if (this.udpBuilder) {
+            xUsd.udp = this.udpBuilder.build();
+            hasXUsd = true;
+        }
+        // Infer protocols if not set
+        if (!xUsd.protocols || xUsd.protocols.length === 0) {
+            const protocols = [];
+            if (doc.paths && Object.keys(doc.paths).length > 0)
+                protocols.push('http');
+            if (xUsd.websocket)
+                protocols.push('websocket');
+            if (xUsd.streams)
+                protocols.push('streams');
+            if (xUsd.jsonrpc)
+                protocols.push('jsonrpc');
+            if (xUsd.grpc)
+                protocols.push('grpc');
+            if (xUsd.tcp)
+                protocols.push('tcp');
+            if (xUsd.udp)
+                protocols.push('udp');
+            if (protocols.length > 0) {
+                xUsd.protocols = protocols;
+                hasXUsd = true;
+            }
+        }
+        if (hasXUsd) {
+            doc['x-usd'] = xUsd;
+        }
+        return doc;
+    }
+    /**
+     * Build and serialize to JSON
+     */
+    toJson(pretty = true) {
+        return serialize(this.build(), 'json', { pretty });
+    }
+    /**
+     * Build and serialize to YAML
+     */
+    toYaml(options) {
+        return serialize(this.build(), 'yaml', options);
+    }
+}
+/**
+ * Create a USD document builder
+ *
+ * @example
+ * ```typescript
+ * const doc = USD.document({ title: 'My API', version: '1.0.0' })
+ *   .http('/users')
+ *     .get('listUsers').response(200, UserListSchema).done()
+ *     .post('createUser').body(CreateUserSchema).response(201, UserSchema).done()
+ *   .done()
+ *   .websocket()
+ *     .public('chat-room').bidirectional(ChatMessageSchema).done()
+ *   .done()
+ *   .build()
+ * ```
+ */
+export function document(options) {
+    return new DocumentBuilder(options);
+}
+/**
+ * USD namespace for convenient imports
+ */
+export const USD = {
+    document,
+};
+//# sourceMappingURL=document.js.map

package/dist/usd/builder/document.js.map

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

package/dist/usd/builder/grpc.d.ts

@@ -0,0 +1,119 @@
+/**
+ * gRPC Builder for USD
+ *
+ * Provides a fluent API for building gRPC service definitions
+ */
+import type { USDGrpc, USDGrpcService, USDGrpcMethod, USDSchema, USDContentTypes } from '../spec/types.js';
+/**
+ * gRPC method builder
+ */
+export declare class GrpcMethodBuilder {
+    private serviceBuilder;
+    readonly name: string;
+    private method;
+    constructor(serviceBuilder: GrpcServiceBuilder, name: string);
+    description(description: string): this;
+    tags(...tags: string[]): this;
+    contentTypes(contentTypes: USDContentTypes): this;
+    /**
+     * Set input message schema
+     */
+    input(schema: USDSchema | {
+        $ref: string;
+    }): this;
+    /**
+     * Set output message schema
+     */
+    output(schema: USDSchema | {
+        $ref: string;
+    }): this;
+    /**
+     * Mark as client streaming
+     */
+    clientStreaming(): this;
+    /**
+     * Mark as server streaming
+     */
+    serverStreaming(): this;
+    /**
+     * Mark as bidirectional streaming
+     */
+    bidirectionalStreaming(): this;
+    /** Return to service builder */
+    done(): GrpcServiceBuilder;
+    /** Get the built method */
+    build(): USDGrpcMethod;
+}
+/**
+ * gRPC service builder
+ */
+export declare class GrpcServiceBuilder {
+    private grpcBuilder;
+    readonly name: string;
+    private service;
+    private methods;
+    constructor(grpcBuilder: GrpcBuilder, name: string);
+    description(description: string): this;
+    /**
+     * Add a unary method
+     */
+    unary(name: string): GrpcMethodBuilder;
+    /**
+     * Add a server streaming method
+     */
+    serverStream(name: string): GrpcMethodBuilder;
+    /**
+     * Add a client streaming method
+     */
+    clientStream(name: string): GrpcMethodBuilder;
+    /**
+     * Add a bidirectional streaming method
+     */
+    bidiStream(name: string): GrpcMethodBuilder;
+    /**
+     * Generic method builder
+     */
+    method(name: string): GrpcMethodBuilder;
+    /** Return to gRPC builder */
+    done(): GrpcBuilder;
+    /** Get the built service */
+    build(): USDGrpcService;
+}
+/**
+ * gRPC Builder for managing services
+ */
+export declare class GrpcBuilder {
+    private documentBuilder;
+    private config;
+    private services;
+    constructor(documentBuilder: any);
+    /**
+     * Set the proto package name
+     */
+    package(name: string): this;
+    /**
+     * Set proto syntax version
+     */
+    syntax(version: 'proto3' | 'proto2'): this;
+    /**
+     * Set proto options
+     */
+    options(opts: Record<string, unknown>): this;
+    /**
+     * Configure content types for gRPC messages
+     */
+    contentTypes(contentTypes: USDContentTypes): this;
+    /**
+     * Add a service
+     */
+    service(name: string): GrpcServiceBuilder;
+    /** Return to document builder */
+    done(): any;
+    /** Get the built gRPC config */
+    build(): USDGrpc;
+}
+/**
+ * Create a gRPC builder
+ */
+export declare function createGrpcBuilder(documentBuilder: any): GrpcBuilder;
+//# sourceMappingURL=grpc.d.ts.map

package/dist/usd/builder/grpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc.d.ts","sourceRoot":"","sources":["../../../src/usd/builder/grpc.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,aAAa,EACb,SAAS,EACT,eAAe,EAChB,MAAM,kBAAkB,CAAA;AAEzB;;GAEG;AACH,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,cAAc;aACN,IAAI,EAAE,MAAM;IAJ9B,OAAO,CAAC,MAAM,CAA6B;gBAGjC,cAAc,EAAE,kBAAkB,EAC1B,IAAI,EAAE,MAAM;IAG9B,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKtC,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAK7B,YAAY,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI;IAKjD;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAKjD;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAKlD;;OAEG;IACH,eAAe,IAAI,IAAI;IAKvB;;OAEG;IACH,eAAe,IAAI,IAAI;IAKvB;;OAEG;IACH,sBAAsB,IAAI,IAAI;IAM9B,gCAAgC;IAChC,IAAI,IAAI,kBAAkB;IAI1B,2BAA2B;IAC3B,KAAK,IAAI,aAAa;CASvB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,WAAW;aACH,IAAI,EAAE,MAAM;IAL9B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,OAAO,CAA4C;gBAGjD,WAAW,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM;IAG9B,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;IAMtC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;IAM7C;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;IAM7C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;IAM3C;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;IAMvC,6BAA6B;IAC7B,IAAI,IAAI,WAAW;IAInB,4BAA4B;IAC5B,KAAK,IAAI,cAAc;CAYxB;AAED;;GAEG;AACH,qBAAa,WAAW;IAIV,OAAO,CAAC,eAAe;IAHnC,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAA6C;gBAEzC,eAAe,EAAE,GAAG;IAExC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI;IAK1C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK5C;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI;IAKjD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB;IAMzC,iCAAiC;IACjC,IAAI,IAAI,GAAG;IAIX,gCAAgC;IAChC,KAAK,IAAI,OAAO;CAYjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,GAAG,GAAG,WAAW,CAEnE"}