raffel 1.0.6 → 1.0.7

package/dist/server/builder.js

@@ -13,15 +13,39 @@ import { createLogger } from '../utils/logger.js';
 import { createProcedureBuilder, createStreamBuilder, createEventBuilder, createGroupBuilder, joinHandlerName, } from './handler-builders.js';
 import { createResourceBuilder } from './resource-builder.js';
 import { registerDiscoveredHandlers, resolveHooksForProcedure } from './discovery-utils.js';
+import { createRegistrationService } from '../application/registration.js';
+import { createRuntimePreviewService } from '../application/runtime-preview.js';
 import { buildProtocolConfig, resolveSinglePortConfig } from './protocol-config.js';
 import { normalizeInterceptors as normalizeInterceptorsShared } from './interceptor-utils.js';
-import { buildServerConfigPreview, emitConfigWarnings, logSinglePortConfig, } from './builder/config-preview.js';
 import { createFrontDoorBootstrap, normalizeFrontDoorProtocol } from './front-door.js';
+import { createProtocolFusionDiagnosticsStore, resolveProtocolFusionMode, } from './protocol-fusion-diagnostics.js';
 import { createDiscoveryBootstrap } from './discovery-bootstrap.js';
 import { createServerLifecycle } from './builder/lifecycle.js';
 import { configureMetrics, configureTracing, createTelemetryState, } from './telemetry-bootstrap.js';
-import { isSinglePortTcpRouteEnabled as detectSinglePortTcpRouteEnabled, isSinglePortUdpRouteEnabled as detectSinglePortUdpRouteEnabled, } from './builder/single-port-utils.js';
+import { isSinglePortTcpRouteEnabled as detectSinglePortTcpRouteEnabled, isSinglePortGrpcRouteEnabled as detectSinglePortGrpcRouteEnabled, isSinglePortUdpRouteEnabled as detectSinglePortUdpRouteEnabled, } from './builder/single-port-utils.js';
+import { mergeContractPolicies } from '../types/policies.js';
+import { adaptPinoLogger } from '../adapters/outbound/logger/pino.js';
 const logger = createLogger('server');
+const loggerPort = adaptPinoLogger(logger);
+function policyMetadataFromRouteMeta(meta) {
+    if (!meta)
+        return undefined;
+    return mergeContractPolicies(meta.auth && meta.auth !== 'none'
+        ? {
+            auth: {
+                mode: meta.auth,
+                ...(meta.roles && meta.roles.length > 0 && { roles: meta.roles }),
+            },
+        }
+        : undefined, meta.rateLimit
+        ? {
+            rateLimit: {
+                maxRequests: meta.rateLimit.limit,
+                windowMs: meta.rateLimit.window,
+            },
+        }
+        : undefined);
+}
 /**
  * Check if a value is an async iterable
  */
@@ -32,7 +56,7 @@ function isAsyncIterable(value) {
  * Create a unified Raffel server
  */
 export function createServer(options) {
-    const { port, host = '0.0.0.0', basePath = '/', cors = true, eventDelivery, websocket, jsonrpc, tcp, grpc, graphql, middleware, http: httpOptions, frontDoor, singlePort, envelope, discovery, hotReload = isDevelopment(), providers: initialProviders, protocolExtensions: initialProtocolExtensions, protocolAliasMode: serverProtocolAliasMode = 'standard', } = options;
+    const { port, host = '0.0.0.0', basePath = '/', cors = true, eventDelivery, websocket, jsonrpc, tcp, grpc, graphql, middleware, http: httpOptions, frontDoor, sharedPort, singlePort, envelope, discovery, hotReload = isDevelopment(), providers: initialProviders, protocolExtensions: initialProtocolExtensions, protocolAliasMode: serverProtocolAliasMode = 'standard', } = options;
     // Core components
     const registry = createRegistry();
     const router = createRouter(registry, { eventDelivery });
@@ -66,7 +90,9 @@ export function createServer(options) {
     const frontDoorEnabled = frontDoor?.enabled === true;
     const frontDoorHost = frontDoor?.host ?? host;
     const frontDoorPort = frontDoor?.port ?? port;
-    let singlePortConfigInput = singlePort;
+    let singlePortConfigInput = sharedPort
+        ? { ...(singlePort ?? {}), ...sharedPort }
+        : singlePort;
     let singlePortConfig = resolveSinglePortConfig(singlePortConfigInput);
     const frontDoorAliasMode = frontDoor?.protocolAliasMode ?? serverProtocolAliasMode;
     const effectiveHost = frontDoorEnabled ? frontDoorHost : host;
@@ -80,6 +106,16 @@ export function createServer(options) {
     const getSinglePortSource = () => {
         return singlePortConfig.enabled ? 'singlePort' : 'native';
     };
+    const protocolFusionDiagnostics = createProtocolFusionDiagnosticsStore({
+        getMode: () => resolveProtocolFusionMode(frontDoorEnabled, singlePortConfig.enabled),
+        getEntrypoint: () => (singlePortConfig.enabled ? 'tcp' : 'http'),
+        getTarget: () => ({
+            host: effectiveHost,
+            port: effectivePort,
+        }),
+        getFrontDoorProtocols: () => frontDoorProtocols,
+        getSharedPortProtocols: () => singlePortConfig.protocols,
+    });
     const updateSinglePortConfig = (next) => {
         if (next === undefined)
             return;
@@ -124,6 +160,7 @@ export function createServer(options) {
         basePath,
         effectiveHost,
         effectivePort,
+        onDecision: (decision) => protocolFusionDiagnostics.record(decision),
     });
     // Global interceptors (from options + added via .use())
     const globalInterceptors = middleware ? [...middleware] : [];
@@ -160,6 +197,7 @@ export function createServer(options) {
             sniffTimeoutMs: singlePortConfig.sniffTimeoutMs,
             sniffMaxBytes: singlePortConfig.sniffMaxBytes,
             maxConcurrentDetections: singlePortConfig.maxConcurrentDetections,
+            sniffers: singlePortConfig.sniffers,
             protocols: singlePortConfig.protocols,
             alpn: singlePortConfig.alpn,
         }),
@@ -167,15 +205,6 @@ export function createServer(options) {
         getSinglePortSource,
         protocols,
     };
-    function emitConfiguredWarnings() {
-        emitConfigWarnings(serverConfigPreviewContext, logger);
-    }
-    function getPreviewConfig() {
-        return buildServerConfigPreview(serverConfigPreviewContext);
-    }
-    function logSinglePortConfiguration() {
-        logSinglePortConfig(serverConfigPreviewContext, logger);
-    }
     // Namespace-level interceptors (for shared middleware per protocol)
     // These are persistent across getter calls, enabling shared middleware chains
     const httpInterceptors = [];
@@ -198,6 +227,7 @@ export function createServer(options) {
         providerMiddlewareInstalled: { value: false },
         portBinding: { value: null },
         singlePortTcpConnectionHandler: { value: null },
+        singlePortGrpcConnectionHandler: { value: null },
         httpServer: { value: null },
         wsAdapter: { value: null },
         jsonRpcAdapter: { value: null },
@@ -244,76 +274,64 @@ export function createServer(options) {
     const udpServers = [];
     // Channel definitions discovered from filesystem or added manually
     const channelRegistry = new Map();
+    const operationRegistrations = new Map();
     // REST resources for HTTP routing
     const restResourceRegistry = [];
+    function recordOperationRegistration(name, registration) {
+        operationRegistrations.set(name, registration);
+    }
+    function programmaticSource(kind = 'programmatic') {
+        return { kind, location: '<programmatic>' };
+    }
+    // Registration service (extracted to application/registration.ts)
+    const registrationService = createRegistrationService({
+        registry,
+        schemaRegistry,
+        globalInterceptors,
+        logger: loggerPort,
+        recordOperationRegistration,
+        generateResourceRoutes,
+        registerDiscoveredHandlers: (result, targetRegistry, targetSchemaRegistry, interceptors, onRegistered) => {
+            registerDiscoveredHandlers(result, targetRegistry, targetSchemaRegistry, interceptors, onRegistered);
+        },
+    });
     function registerChannel(channel) {
-        channelRegistry.set(channel.name, channel);
+        registrationService.registerChannel(channelRegistry, channel);
     }
     function registerRestResource(resource) {
-        // Store in registry for HTTP middleware
-        restResourceRegistry.push(resource);
-        for (const route of resource.routes) {
-            // HEAD and OPTIONS have both collection and item routes - differentiate them
-            const suffix = (route.operation === 'head' || route.operation === 'options')
-                ? (route.isCollection ? ':collection' : ':item')
-                : '';
-            const name = `${resource.name}.${route.operation}${suffix}`;
-            if (route.inputSchema || route.outputSchema) {
-                const schema = {};
-                if (route.inputSchema)
-                    schema.input = route.inputSchema;
-                if (route.outputSchema)
-                    schema.output = route.outputSchema;
-                schemaRegistry.register(name, schema);
-            }
-            registry.procedure(name, route.handler, {
-                interceptors: globalInterceptors.length > 0 ? [...globalInterceptors] : undefined,
-            });
-        }
-        logger.debug({ name: resource.name, routes: resource.routes.length }, 'Added REST resource');
+        registrationService.registerRestResource(restResourceRegistry, resource);
     }
     function registerResource(resource) {
-        const routes = generateResourceRoutes([resource]);
-        for (const route of routes) {
-            const name = `${resource.name}.${route.operation}`;
-            registry.procedure(name, route.handler, {
-                interceptors: globalInterceptors.length > 0 ? [...globalInterceptors] : undefined,
-            });
-        }
-        logger.debug({ name: resource.name, operations: routes.length }, 'Added resource');
+        registrationService.registerResource(resource);
     }
     function registerTcpHandler(handler) {
-        tcpHandlers.push(handler);
-        logger.debug({ name: handler.name, port: handler.config.port }, 'Added TCP handler');
+        registrationService.registerTcpHandler(tcpHandlers, handler);
     }
     function registerUdpHandler(handler) {
-        udpHandlers.push(handler);
-        logger.debug({ name: handler.name, port: handler.config.port }, 'Added UDP handler');
+        registrationService.registerUdpHandler(udpHandlers, handler);
     }
     function applyDiscoveryResult(result) {
-        registerDiscoveredHandlers(result, registry, schemaRegistry, globalInterceptors);
-        for (const channel of result.channels) {
-            registerChannel(channel);
-        }
-        for (const resource of result.restResources) {
-            registerRestResource(resource);
-        }
-        for (const resource of result.resources) {
-            registerResource(resource);
-        }
-        for (const handler of result.tcpHandlers) {
-            registerTcpHandler(handler);
-        }
-        for (const handler of result.udpHandlers) {
-            registerUdpHandler(handler);
-        }
+        registrationService.applyDiscoveryResult(result, channelRegistry, restResourceRegistry, tcpHandlers, udpHandlers);
     }
+    const runtimePreviewService = createRuntimePreviewService({
+        registry,
+        schemaRegistry,
+        basePath,
+        channelRegistry,
+        tcpHandlers,
+        udpHandlers,
+        operationRegistrations,
+        protocols,
+        serverConfigPreviewContext,
+        logger: loggerPort,
+    });
     const createFrontDoorDecisionMiddleware = () => frontDoorBootstrap.createDecisionMiddleware({
         info: logger.info.bind(logger),
         debug: logger.debug.bind(logger),
         warn: logger.warn.bind(logger),
     });
     const isSinglePortTcpRouteEnabled = () => detectSinglePortTcpRouteEnabled(singlePortConfig.enabled, protocols.tcp?.enabled ?? false, protocols.tcp?.options.port, protocols.tcp?.options.host, effectiveHost, effectivePort);
+    const isSinglePortGrpcRouteEnabled = () => detectSinglePortGrpcRouteEnabled(singlePortConfig.enabled, protocols.grpc?.enabled ?? false, protocols.grpc?.options.port, protocols.grpc?.options.host, effectiveHost, effectivePort);
     const isSinglePortUdpRouteEnabled = (handler) => detectSinglePortUdpRouteEnabled(singlePortConfig.enabled, handler.config.port, handler.config.host, effectiveHost, effectivePort);
     const serverLifecycle = createServerLifecycle({
         logger,
@@ -339,12 +357,14 @@ export function createServer(options) {
         udpServers,
         singlePortConfig,
         isSinglePortTcpRouteEnabled,
+        isSinglePortGrpcRouteEnabled,
         isSinglePortUdpRouteEnabled,
         getSinglePortSource,
         getSinglePortAliasMode,
+        recordProtocolFusionDecision: (decision) => protocolFusionDiagnostics.record(decision),
         createFrontDoorDecisionMiddleware,
         applyDiscoveryResult,
-        logSinglePortConfig: logSinglePortConfiguration,
+        logSinglePortConfig: runtimePreviewService.logSinglePortConfiguration,
         host,
         effectiveHost,
         effectivePort,
@@ -355,7 +375,7 @@ export function createServer(options) {
         usdDocsConfig,
     });
     /**
-     * Register an HTTP route (Hono-style).
+     * Register a native HTTP route.
      * Creates a procedure with the method and path as name (e.g., `get:/users/:id`).
      *
      * Interceptor chain order:
@@ -394,6 +414,7 @@ export function createServer(options) {
             httpMethod: method,
             interceptors: interceptors.length > 0 ? interceptors : undefined,
         });
+        recordOperationRegistration(name, { source: programmaticSource('http-namespace') });
         logger.debug({ name, path, method }, 'Added HTTP route');
         return server;
     }
@@ -591,7 +612,7 @@ export function createServer(options) {
                     server.grpc(grpcCfg);
                 }
             }
-            emitConfiguredWarnings();
+            runtimePreviewService.emitWarnings();
             return server;
         },
         withProfile(profile, overrides) {
@@ -633,6 +654,9 @@ export function createServer(options) {
             return server;
         },
         enableSinglePort(config = true) {
+            return server.enableSharedPort(config);
+        },
+        enableSharedPort(config = true) {
             updateSinglePortConfig(config);
             return server;
         },
@@ -741,10 +765,25 @@ export function createServer(options) {
                     ...opts,
                     interceptors: interceptors.length > 0 ? interceptors : undefined,
                 });
+                recordOperationRegistration(nameOrHandler, { source: programmaticSource() });
                 return;
             }
             // Fluent builder with hooks resolver
-            return createProcedureBuilder(registry, schemaRegistry, nameOrHandler, [...globalInterceptors], hooksResolver, envelopeInterceptor);
+            return createProcedureBuilder(registry, schemaRegistry, nameOrHandler, [...globalInterceptors], hooksResolver, envelopeInterceptor, (procedureName, procedureHandler, registration) => {
+                registry.procedure(procedureName, procedureHandler, {
+                    summary: registration.summary,
+                    description: registration.description,
+                    tags: registration.tags,
+                    graphql: registration.graphql,
+                    httpPath: registration.httpPath,
+                    httpMethod: registration.httpMethod,
+                    jsonrpc: registration.jsonrpc,
+                    grpc: registration.grpc,
+                    policies: registration.policies,
+                    interceptors: registration.interceptors,
+                });
+                recordOperationRegistration(procedureName, { source: programmaticSource() });
+            });
         },
         stream(name) {
             return createStreamBuilder(registry, schemaRegistry, name, [...globalInterceptors]);
@@ -763,7 +802,7 @@ export function createServer(options) {
                 tags: [name],
             });
         },
-        // === HTTP Routes (Hono-style) ===
+        // === HTTP Routes ===
         get(path, optionsOrHandler, maybeHandler) {
             return registerHttpRoute('GET', path, optionsOrHandler, maybeHandler);
         },
@@ -823,6 +862,7 @@ export function createServer(options) {
                     tags: def.tags,
                     httpPath,
                     httpMethod,
+                    policies: def.policies,
                     interceptors: interceptors.length > 0 ? interceptors : undefined,
                 });
                 logger.debug({ name, httpPath, httpMethod }, 'Added procedure from map');
@@ -989,6 +1029,9 @@ export function createServer(options) {
             const httpMethod = 'meta' in input ? input.meta?.httpMethod : input.httpMethod;
             const jsonrpc = 'meta' in input ? input.meta?.jsonrpc : input.jsonrpc;
             const grpc = 'meta' in input ? input.meta?.grpc : input.grpc;
+            const policies = 'meta' in input
+                ? policyMetadataFromRouteMeta(input.meta)
+                : input.policies;
             const routeInterceptors = 'middlewares' in input ? createRouteInterceptors(input) : [];
             const inputInterceptors = 'interceptors' in input ? input.interceptors ?? [] : [];
             let interceptors = normalizeInterceptors([...globalInterceptors, ...routeInterceptors, ...inputInterceptors]);
@@ -1011,8 +1054,14 @@ export function createServer(options) {
                 httpMethod,
                 jsonrpc,
                 grpc,
+                policies,
                 interceptors: interceptors.length > 0 ? interceptors : undefined,
             });
+            recordOperationRegistration(name, {
+                source: 'filePath' in input
+                    ? { kind: 'discovery', location: input.filePath }
+                    : programmaticSource(),
+            });
             logger.debug({ name }, 'Added procedure');
             return server;
         },
@@ -1023,6 +1072,9 @@ export function createServer(options) {
             const outputSchema = input.outputSchema;
             const description = 'meta' in input ? input.meta?.description : input.description;
             const direction = 'meta' in input ? input.meta?.direction : input.direction;
+            const policies = 'meta' in input
+                ? policyMetadataFromRouteMeta(input.meta)
+                : input.policies;
             const routeInterceptors = 'middlewares' in input ? createRouteInterceptors(input) : [];
             const inputInterceptors = 'interceptors' in input ? input.interceptors ?? [] : [];
             const interceptors = [...globalInterceptors, ...routeInterceptors, ...inputInterceptors];
@@ -1037,8 +1089,14 @@ export function createServer(options) {
             registry.stream(name, handler, {
                 description,
                 direction,
+                policies,
                 interceptors: interceptors.length > 0 ? interceptors : undefined,
             });
+            recordOperationRegistration(name, {
+                source: 'filePath' in input
+                    ? { kind: 'discovery', location: input.filePath }
+                    : programmaticSource(),
+            });
             logger.debug({ name }, 'Added stream');
             return server;
         },
@@ -1050,6 +1108,9 @@ export function createServer(options) {
             const delivery = 'meta' in input ? input.meta?.delivery : input.delivery;
             const retryPolicy = 'meta' in input ? input.meta?.retryPolicy : input.retryPolicy;
             const deduplicationWindow = 'meta' in input ? input.meta?.deduplicationWindow : input.deduplicationWindow;
+            const policies = 'meta' in input
+                ? policyMetadataFromRouteMeta(input.meta)
+                : input.policies;
             const routeInterceptors = 'middlewares' in input ? createRouteInterceptors(input) : [];
             const inputInterceptors = 'interceptors' in input ? input.interceptors ?? [] : [];
             const interceptors = [...globalInterceptors, ...routeInterceptors, ...inputInterceptors];
@@ -1061,8 +1122,14 @@ export function createServer(options) {
                 delivery,
                 retryPolicy,
                 deduplicationWindow,
+                policies,
                 interceptors: interceptors.length > 0 ? interceptors : undefined,
             });
+            recordOperationRegistration(name, {
+                source: 'filePath' in input
+                    ? { kind: 'discovery', location: input.filePath }
+                    : programmaticSource(),
+            });
             logger.debug({ name }, 'Added event');
             return server;
         },
@@ -1222,6 +1289,7 @@ export function createServer(options) {
                         direction: 'server',
                         interceptors: interceptors.length > 0 ? interceptors : undefined,
                     });
+                    recordOperationRegistration(streamName, { source: programmaticSource() });
                     logger.debug({ name: streamName, path: options.path ?? `/${name}` }, 'Added stream source');
                     return streamsNamespace;
                 },
@@ -1241,6 +1309,7 @@ export function createServer(options) {
                         direction: 'client',
                         interceptors: interceptors.length > 0 ? interceptors : undefined,
                     });
+                    recordOperationRegistration(streamName, { source: programmaticSource() });
                     logger.debug({ name: streamName, path: options.path ?? `/${name}` }, 'Added stream sink');
                     return streamsNamespace;
                 },
@@ -1260,6 +1329,7 @@ export function createServer(options) {
                         direction: 'bidi',
                         interceptors: interceptors.length > 0 ? interceptors : undefined,
                     });
+                    recordOperationRegistration(streamName, { source: programmaticSource() });
                     logger.debug({ name: streamName, path: options.path ?? `/${name}` }, 'Added stream duplex');
                     return streamsNamespace;
                 },
@@ -1288,6 +1358,7 @@ export function createServer(options) {
                     jsonrpc: { notification: isNotification },
                     interceptors: interceptors.length > 0 ? interceptors : undefined,
                 });
+                recordOperationRegistration(name, { source: programmaticSource('rpc-namespace') });
                 logger.debug({ name, notification: isNotification }, 'Added RPC method');
             };
             const rpcNamespace = {
@@ -1332,14 +1403,25 @@ export function createServer(options) {
                             return handlerBuilder;
                         },
                         end() {
-                            // Build framing config if specified
-                            const framingConfig = options?.framing ? {
-                                type: options.framing,
-                                lengthBytes: 4,
-                                lengthEncoding: 'BE',
-                                maxMessageSize: 16 * 1024 * 1024,
-                                delimiter: options.delimiter ? Buffer.from(options.delimiter) : undefined,
-                            } : null;
+                            let framingConfig = null;
+                            if (options?.framing === 'length-prefixed') {
+                                framingConfig = {
+                                    type: 'length-prefixed',
+                                    lengthBytes: 4,
+                                    lengthEncoding: 'BE',
+                                    maxMessageSize: 16 * 1024 * 1024,
+                                    delimiter: undefined,
+                                };
+                            }
+                            else if (options?.framing === 'delimiter' || options?.framing === 'line') {
+                                framingConfig = {
+                                    type: 'delimiter',
+                                    lengthBytes: 4,
+                                    lengthEncoding: 'BE',
+                                    maxMessageSize: 16 * 1024 * 1024,
+                                    delimiter: Buffer.from(options.delimiter ?? '\n'),
+                                };
+                            }
                             // Store TCP handler configuration for later startup
                             const tcpHandler = {
                                 name,
@@ -1356,7 +1438,12 @@ export function createServer(options) {
                                 },
                                 handlers: {
                                     onConnect: connectHandler,
-                                    onData: dataHandler,
+                                    onData: framingConfig
+                                        ? undefined
+                                        : dataHandler,
+                                    onMessage: framingConfig
+                                        ? dataHandler
+                                        : undefined,
                                     onClose: closeHandler,
                                     onError: errorHandler,
                                 },
@@ -1458,6 +1545,14 @@ export function createServer(options) {
                                 grpc: { serviceName, methodName: name, type: 'unary' },
                                 interceptors: interceptors.length > 0 ? interceptors : undefined,
                             });
+                            recordOperationRegistration(procedureName, {
+                                source: programmaticSource('grpc-namespace'),
+                                grpc: {
+                                    serviceName: packageName ? `${packageName}.${serviceName}` : serviceName,
+                                    methodName: name,
+                                    type: 'unary',
+                                },
+                            });
                             logger.debug({ name: procedureName, type: 'unary' }, 'Added gRPC method');
                             return serviceBuilder;
                         },
@@ -1480,6 +1575,14 @@ export function createServer(options) {
                                 direction: 'server',
                                 interceptors: interceptors.length > 0 ? interceptors : undefined,
                             });
+                            recordOperationRegistration(procedureName, {
+                                source: programmaticSource('grpc-namespace'),
+                                grpc: {
+                                    serviceName: packageName ? `${packageName}.${serviceName}` : serviceName,
+                                    methodName: name,
+                                    type: 'server-streaming',
+                                },
+                            });
                             logger.debug({ name: procedureName, type: 'server-stream' }, 'Added gRPC server stream');
                             return serviceBuilder;
                         },
@@ -1502,6 +1605,14 @@ export function createServer(options) {
                                 direction: 'client',
                                 interceptors: interceptors.length > 0 ? interceptors : undefined,
                             });
+                            recordOperationRegistration(procedureName, {
+                                source: programmaticSource('grpc-namespace'),
+                                grpc: {
+                                    serviceName: packageName ? `${packageName}.${serviceName}` : serviceName,
+                                    methodName: name,
+                                    type: 'client-streaming',
+                                },
+                            });
                             logger.debug({ name: procedureName, type: 'client-stream' }, 'Added gRPC client stream');
                             return serviceBuilder;
                         },
@@ -1524,6 +1635,14 @@ export function createServer(options) {
                                 direction: 'bidi',
                                 interceptors: interceptors.length > 0 ? interceptors : undefined,
                             });
+                            recordOperationRegistration(procedureName, {
+                                source: programmaticSource('grpc-namespace'),
+                                grpc: {
+                                    serviceName: packageName ? `${packageName}.${serviceName}` : serviceName,
+                                    methodName: name,
+                                    type: 'bidirectional',
+                                },
+                            });
                             logger.debug({ name: procedureName, type: 'bidi-stream' }, 'Added gRPC bidi stream');
                             return serviceBuilder;
                         },
@@ -1562,7 +1681,13 @@ export function createServer(options) {
         get metrics() { return telemetryState.metricsRegistry; },
         get tracer() { return telemetryState.tracerInstance; },
         previewConfig() {
-            return getPreviewConfig();
+            return runtimePreviewService.getPreviewConfig();
+        },
+        preview() {
+            return runtimePreviewService.getRuntimeInspectionPreview();
+        },
+        getProtocolFusionState() {
+            return protocolFusionDiagnostics.snapshot();
         },
         get usd() { return serverState.usdDocsHandlers.value; },
         // === USD Document Access ===