raffel 0.1.2

package/dist/docs/ui/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../../src/docs/ui/styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAOxC;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAA;IAElD,OAAO;;yBAEgB,YAAY;yBACZ,WAAW,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA8C/C,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqnEtB,CAAA;AACH,CAAC"}

package/dist/docs/ui/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * UI Types
+ *
+ * Type definitions for the USD documentation UI.
+ */
+/**
+ * UI configuration options
+ */
+export interface UIConfig {
+    theme?: 'light' | 'dark' | 'auto';
+    primaryColor?: string;
+    logo?: string;
+    favicon?: string;
+    tryItOut?: boolean;
+    codeGeneration?: {
+        enabled?: boolean;
+        languages?: ('typescript' | 'python' | 'go' | 'curl')[];
+    };
+    hero?: HeroConfig;
+    sidebar?: SidebarConfig;
+}
+/**
+ * Hero section configuration
+ */
+export interface HeroConfig {
+    title?: string;
+    tagline?: string;
+    background?: 'gradient' | 'solid' | 'pattern' | 'image';
+    backgroundImage?: string;
+    buttons?: Array<{
+        text: string;
+        href?: string;
+        primary?: boolean;
+    }>;
+    quickLinks?: Array<{
+        title: string;
+        description?: string;
+        href: string;
+        icon?: string;
+    }>;
+}
+/**
+ * Sidebar configuration
+ */
+export interface SidebarConfig {
+    search?: boolean;
+    expandAll?: boolean;
+    showCounts?: boolean;
+}
+/**
+ * Tag group for hierarchical organization
+ */
+export interface TagGroup {
+    name: string;
+    tags: string[];
+    description?: string;
+    expanded?: boolean;
+}
+/**
+ * Options for generating UI HTML
+ */
+export interface UIGeneratorOptions {
+    doc: any;
+    basePath: string;
+    ui?: UIConfig;
+    tagGroups?: TagGroup[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/docs/ui/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/docs/ui/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;IACjC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc,CAAC,EAAE;QACf,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,SAAS,CAAC,EAAE,CAAC,YAAY,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC,EAAE,CAAA;KACxD,CAAA;IACD,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAA;IACvD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,OAAO,CAAA;KAClB,CAAC,CAAA;IACF,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,GAAG,CAAA;IACR,QAAQ,EAAE,MAAM,CAAA;IAChB,EAAE,CAAC,EAAE,QAAQ,CAAA;IACb,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;CACvB"}

package/dist/docs/ui/types.js

@@ -0,0 +1,7 @@
+/**
+ * UI Types
+ *
+ * Type definitions for the USD documentation UI.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/docs/ui/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/docs/ui/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/docs/ui/utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * UI Utilities
+ *
+ * Helper functions for the USD documentation UI.
+ */
+/**
+ * Escape HTML special characters to prevent XSS
+ */
+export declare function escapeHtml(str: string): string;
+/**
+ * Escape JSON for embedding in script tag (prevents XSS)
+ */
+export declare function escapeJsonForScript(obj: unknown): string;
+/**
+ * Adjust color brightness
+ * @param color - Hex color string (e.g., '#6366f1')
+ * @param amount - Positive to lighten, negative to darken
+ */
+export declare function adjustColor(color: string, amount: number): string;
+/**
+ * Generate hero background CSS based on configuration
+ */
+export declare function generateHeroBackgroundCSS(primaryColor: string, background?: 'gradient' | 'solid' | 'pattern' | 'image', backgroundImage?: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/docs/ui/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/docs/ui/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKxD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,EACvD,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAaR"}

package/dist/docs/ui/utils.js

@@ -0,0 +1,55 @@
+/**
+ * UI Utilities
+ *
+ * Helper functions for the USD documentation UI.
+ */
+/**
+ * Escape HTML special characters to prevent XSS
+ */
+export function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#x27;');
+}
+/**
+ * Escape JSON for embedding in script tag (prevents XSS)
+ */
+export function escapeJsonForScript(obj) {
+    return JSON.stringify(obj)
+        .replace(/</g, '\\u003c')
+        .replace(/>/g, '\\u003e')
+        .replace(/&/g, '\\u0026');
+}
+/**
+ * Adjust color brightness
+ * @param color - Hex color string (e.g., '#6366f1')
+ * @param amount - Positive to lighten, negative to darken
+ */
+export function adjustColor(color, amount) {
+    const hex = color.replace('#', '');
+    const r = Math.max(0, Math.min(255, parseInt(hex.slice(0, 2), 16) + amount));
+    const g = Math.max(0, Math.min(255, parseInt(hex.slice(2, 4), 16) + amount));
+    const b = Math.max(0, Math.min(255, parseInt(hex.slice(4, 6), 16) + amount));
+    return `#${r.toString(16).padStart(2, '0')}${g.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}`;
+}
+/**
+ * Generate hero background CSS based on configuration
+ */
+export function generateHeroBackgroundCSS(primaryColor, background, backgroundImage) {
+    switch (background) {
+        case 'gradient':
+            return `background: linear-gradient(135deg, ${primaryColor} 0%, ${adjustColor(primaryColor, -30)} 100%);`;
+        case 'pattern':
+            return `background: ${primaryColor}; background-image: url("data:image/svg+xml,%3Csvg width='60' height='60' viewBox='0 0 60 60' xmlns='http://www.w3.org/2000/svg'%3E%3Cg fill='none' fill-rule='evenodd'%3E%3Cg fill='%23ffffff' fill-opacity='0.1'%3E%3Cpath d='M36 34v-4h-2v4h-4v2h4v4h2v-4h4v-2h-4zm0-30V0h-2v4h-4v2h4v4h2V6h4V4h-4zM6 34v-4H4v4H0v2h4v4h2v-4h4v-2H6zM6 4V0H4v4H0v2h4v4h2V6h4V4H6z'/%3E%3C/g%3E%3C/g%3E%3C/svg%3E");`;
+        case 'image':
+            return backgroundImage
+                ? `background: url("${backgroundImage}") center/cover no-repeat;`
+                : `background: ${primaryColor};`;
+        default:
+            return `background: ${primaryColor};`;
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/docs/ui/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/docs/ui/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG;SACP,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,MAAc;IACvD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IAClC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAA;IAC5E,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAA;IAC5E,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAA;IAC5E,OAAO,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;AAClH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,YAAoB,EACpB,UAAuD,EACvD,eAAwB;IAExB,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,UAAU;YACb,OAAO,uCAAuC,YAAY,QAAQ,WAAW,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,SAAS,CAAA;QAC3G,KAAK,SAAS;YACZ,OAAO,eAAe,YAAY,wYAAwY,CAAA;QAC5a,KAAK,OAAO;YACV,OAAO,eAAe;gBACpB,CAAC,CAAC,oBAAoB,eAAe,4BAA4B;gBACjE,CAAC,CAAC,eAAe,YAAY,GAAG,CAAA;QACpC;YACE,OAAO,eAAe,YAAY,GAAG,CAAA;IACzC,CAAC;AACH,CAAC"}

package/dist/docs/usd-middleware.d.ts

@@ -0,0 +1,157 @@
+/**
+ * USD Documentation Middleware
+ *
+ * Creates HTTP handlers for serving USD documentation.
+ *
+ * Security Note: The UI HTML generation uses innerHTML for rendering
+ * documentation from the trusted spec object (generated by our own code).
+ * User-provided content is properly escaped with escapeHtml().
+ */
+import type { Registry } from '../core/index.js';
+import type { SchemaRegistry } from '../validation/index.js';
+import type { LoadedChannel, LoadedRestResource } from '../server/fs-routes/index.js';
+import type { USDDocument } from '../usd/index.js';
+import type { OpenAPIDocument } from '../usd/export/openapi.js';
+import { type USDGeneratorOptions, type USDGeneratorProtocolConfig } from './generators/usd-generator.js';
+import type { LoadedTcpHandler } from './generators/tcp-generator.js';
+import type { LoadedUdpHandler } from './generators/udp-generator.js';
+/**
+ * USD middleware configuration
+ */
+export interface USDMiddlewareConfig {
+    /** Base path for documentation endpoints (default: '/docs') */
+    basePath?: string;
+    /** API information */
+    info?: {
+        title?: string;
+        version?: string;
+        description?: string;
+        termsOfService?: string;
+        contact?: {
+            name?: string;
+            url?: string;
+            email?: string;
+        };
+        license?: {
+            name: string;
+            url?: string;
+            identifier?: string;
+        };
+        summary?: string;
+    };
+    /** Server definitions */
+    servers?: USDGeneratorOptions['servers'];
+    /** Protocols to include (auto-detected if not specified) */
+    protocols?: USDGeneratorOptions['protocols'];
+    /** Global content types */
+    contentTypes?: USDGeneratorOptions['contentTypes'];
+    /** Security schemes */
+    securitySchemes?: USDGeneratorOptions['securitySchemes'];
+    /** Default security requirement */
+    defaultSecurity?: USDGeneratorOptions['defaultSecurity'];
+    /** Tags for grouping */
+    tags?: USDGeneratorOptions['tags'];
+    /** External documentation */
+    externalDocs?: USDGeneratorOptions['externalDocs'];
+    /** Tag groups for hierarchical organization (like Redoc) */
+    tagGroups?: Array<{
+        name: string;
+        tags: string[];
+        description?: string;
+        expanded?: boolean;
+    }>;
+    /** UI configuration */
+    ui?: {
+        theme?: 'light' | 'dark' | 'auto';
+        primaryColor?: string;
+        logo?: string;
+        favicon?: string;
+        tryItOut?: boolean;
+        codeGeneration?: {
+            enabled?: boolean;
+            languages?: ('typescript' | 'python' | 'go' | 'curl')[];
+        };
+        /** Hero section (landing page header) */
+        hero?: {
+            /** Main title (defaults to API title) */
+            title?: string;
+            /** Subtitle/tagline */
+            tagline?: string;
+            /** Background style */
+            background?: 'gradient' | 'solid' | 'pattern' | 'image';
+            /** Background image URL (if background is 'image') */
+            backgroundImage?: string;
+            /** Call-to-action buttons */
+            buttons?: Array<{
+                text: string;
+                href?: string;
+                primary?: boolean;
+            }>;
+            /** Quick links section */
+            quickLinks?: Array<{
+                title: string;
+                description?: string;
+                href: string;
+                icon?: string;
+            }>;
+        };
+        /** Sidebar configuration */
+        sidebar?: {
+            /** Show search */
+            search?: boolean;
+            /** Expand all groups by default */
+            expandAll?: boolean;
+            /** Show endpoint count badges */
+            showCounts?: boolean;
+        };
+    };
+    /** Include standard error schemas */
+    includeErrorSchemas?: boolean;
+    /** Include stream event schemas */
+    includeStreamEventSchemas?: boolean;
+    /** JSON-RPC generation options */
+    jsonrpc?: USDGeneratorOptions['jsonrpc'];
+    /** gRPC generation options */
+    grpc?: USDGeneratorOptions['grpc'];
+}
+/**
+ * USD documentation handlers
+ */
+export interface USDHandlers {
+    /** Serve the main documentation UI */
+    serveUI: () => Response;
+    /** Serve USD document as JSON */
+    serveUSD: () => Response;
+    /** Serve USD document as YAML */
+    serveUSDYaml: () => Response;
+    /** Serve pure OpenAPI 3.1 JSON (for Swagger UI compatibility) */
+    serveOpenAPI: () => Response;
+    /** Get the USD document */
+    getUSDDocument: () => USDDocument;
+    /** Get the OpenAPI document */
+    getOpenAPIDocument: () => OpenAPIDocument;
+}
+/**
+ * Context for USD middleware
+ */
+export interface USDMiddlewareContext {
+    /** Handler registry */
+    registry: Registry;
+    /** Schema registry */
+    schemaRegistry: SchemaRegistry;
+    /** WebSocket channels */
+    channels?: Map<string, LoadedChannel>;
+    /** REST resources */
+    restResources?: LoadedRestResource[];
+    /** TCP handlers */
+    tcpHandlers?: LoadedTcpHandler[];
+    /** UDP handlers */
+    udpHandlers?: LoadedUdpHandler[];
+    /** Protocol configuration (jsonrpc/grpc detection) */
+    protocolConfig?: USDGeneratorProtocolConfig;
+}
+/**
+ * Create USD documentation handlers
+ */
+export declare function createUSDHandlers(ctx: USDMiddlewareContext, config?: USDMiddlewareConfig): USDHandlers;
+//# sourceMappingURL=usd-middleware.d.ts.map

package/dist/docs/usd-middleware.d.ts.map

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

package/dist/docs/usd-middleware.js

@@ -0,0 +1,118 @@
+/**
+ * USD Documentation Middleware
+ *
+ * Creates HTTP handlers for serving USD documentation.
+ *
+ * Security Note: The UI HTML generation uses innerHTML for rendering
+ * documentation from the trusted spec object (generated by our own code).
+ * User-provided content is properly escaped with escapeHtml().
+ */
+import { generateUSD, } from './generators/usd-generator.js';
+import { exportOpenAPI } from '../usd/export/openapi.js';
+import { dump as yamlStringify } from 'js-yaml';
+import { generateUIHTML } from './ui/index.js';
+// =============================================================================
+// Middleware Factory
+// =============================================================================
+/**
+ * Create USD documentation handlers
+ */
+export function createUSDHandlers(ctx, config = {}) {
+    const { basePath = '/docs', info, servers, protocols, contentTypes, securitySchemes, defaultSecurity, tags, externalDocs, jsonrpc, grpc, ui, includeErrorSchemas = true, includeStreamEventSchemas = true, } = config;
+    // Cache for generated documents
+    let cachedUSD = null;
+    let cachedOpenAPI = null;
+    // Generate USD document (lazy)
+    const getUSD = () => {
+        if (cachedUSD)
+            return cachedUSD;
+        const result = generateUSD({
+            registry: ctx.registry,
+            schemaRegistry: ctx.schemaRegistry,
+            channels: ctx.channels,
+            restResources: ctx.restResources,
+            tcpHandlers: ctx.tcpHandlers,
+            udpHandlers: ctx.udpHandlers,
+            protocolConfig: ctx.protocolConfig,
+        }, {
+            info: {
+                title: info?.title ?? 'API Documentation',
+                version: info?.version ?? '1.0.0',
+                description: info?.description,
+                termsOfService: info?.termsOfService,
+                contact: info?.contact,
+                license: info?.license,
+                summary: info?.summary,
+            },
+            servers,
+            protocols,
+            contentTypes,
+            securitySchemes,
+            defaultSecurity,
+            tags,
+            externalDocs,
+            jsonrpc,
+            grpc,
+            includeErrorSchemas,
+            includeStreamEventSchemas,
+        });
+        cachedUSD = result.document;
+        return cachedUSD;
+    };
+    // Generate OpenAPI document (lazy)
+    const getOpenAPI = () => {
+        if (cachedOpenAPI)
+            return cachedOpenAPI;
+        const usd = getUSD();
+        cachedOpenAPI = exportOpenAPI(usd, {
+            stripExtensions: true,
+            includeWebSocketAsWebhooks: false,
+            includeRpcAsEndpoints: false,
+            includeStreamsAsEndpoints: false,
+        });
+        return cachedOpenAPI;
+    };
+    return {
+        serveUI: () => {
+            const html = generateUIHTML({
+                doc: getUSD(),
+                basePath,
+                ui,
+                tagGroups: config.tagGroups,
+            });
+            return new Response(html, {
+                headers: {
+                    'Content-Type': 'text/html; charset=utf-8',
+                },
+            });
+        },
+        serveUSD: () => {
+            const doc = getUSD();
+            return new Response(JSON.stringify(doc, null, 2), {
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+            });
+        },
+        serveUSDYaml: () => {
+            const doc = getUSD();
+            const yaml = yamlStringify(doc);
+            return new Response(yaml, {
+                headers: {
+                    'Content-Type': 'application/x-yaml',
+                },
+            });
+        },
+        serveOpenAPI: () => {
+            const doc = getOpenAPI();
+            return new Response(JSON.stringify(doc, null, 2), {
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+            });
+        },
+        getUSDDocument: getUSD,
+        getOpenAPIDocument: getOpenAPI,
+    };
+}
+//# sourceMappingURL=usd-middleware.js.map

package/dist/docs/usd-middleware.js.map

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

package/dist/dx/health/health.int.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Health Check System Tests
+ */
+export {};
+//# sourceMappingURL=health.int.test.d.ts.map

package/dist/dx/health/health.int.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.int.test.d.ts","sourceRoot":"","sources":["../../../src/dx/health/health.int.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}