@fluojs/microservices 1.0.0-beta.1

package/dist/tokens.js

@@ -0,0 +1,4 @@
+/** Compatibility injection token for the programmatic microservice facade. */
+export const MICROSERVICE = Symbol.for('fluo.microservices.service');
+/** Injection token for the configured transport and runtime module options. */
+export const MICROSERVICE_OPTIONS = Symbol.for('fluo.microservices.options');

package/dist/transports/event-handler-logger.d.ts

@@ -0,0 +1,3 @@
+import type { MicroserviceTransportLogger } from '../types.js';
+export declare function logTransportEventHandlerFailure(logger: MicroserviceTransportLogger | undefined, transportName: string, error: unknown): void;
+//# sourceMappingURL=event-handler-logger.d.ts.map

package/dist/transports/event-handler-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler-logger.d.ts","sourceRoot":"","sources":["../../src/transports/event-handler-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE/D,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,2BAA2B,GAAG,SAAS,EAC/C,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,OAAO,GACb,IAAI,CAEN"}

package/dist/transports/event-handler-logger.js

@@ -0,0 +1,3 @@
+export function logTransportEventHandlerFailure(logger, transportName, error) {
+  logger?.error('Event handler failed.', error, transportName);
+}

package/dist/transports/grpc-transport.d.ts

@@ -0,0 +1,193 @@
+import type { MicroserviceTransport, MicroserviceTransportLogger, ServerStreamWriter, TransportBidiStreamHandler, TransportClientStreamHandler, TransportHandler, TransportServerStreamHandler } from '../types.js';
+type DynamicImport = (specifier: string) => Promise<unknown>;
+interface GrpcMetadataLike {
+    get(key: string): unknown;
+    set(key: string, value: string): void;
+}
+interface GrpcServerCredentialsFactoryLike {
+    createInsecure(): unknown;
+}
+interface GrpcServerLike {
+    addService(serviceDefinition: unknown, implementation: Record<string, unknown>): void;
+    bindAsync(address: string, credentials: unknown, callback: (error: Error | null, port: number) => void): void;
+    forceShutdown?(): void;
+    start(): void;
+    tryShutdown?(callback: (error?: Error) => void): void;
+}
+interface GrpcClientLike {
+    close?(): void;
+    [methodName: string]: unknown;
+}
+interface GrpcJsLike {
+    Metadata: new () => GrpcMetadataLike;
+    Server: new () => GrpcServerLike;
+    credentials: GrpcServerCredentialsFactoryLike;
+    loadPackageDefinition(packageDefinition: unknown): unknown;
+    makeGenericClientConstructor(serviceDefinition: unknown, serviceName: string, options?: unknown): new (address: string, credentials: unknown, options?: unknown) => GrpcClientLike;
+    status?: {
+        CANCELLED?: number;
+        DEADLINE_EXCEEDED?: number;
+        INTERNAL?: number;
+        INVALID_ARGUMENT?: number;
+        UNIMPLEMENTED?: number;
+    };
+}
+interface ProtoLoaderLike {
+    loadSync(protoPath: string, options?: Record<string, unknown>): unknown;
+}
+/** Options for configuring the gRPC microservice transport. */
+export interface GrpcMicroserviceTransportOptions {
+    protoPath: string;
+    packageName: string;
+    url: string;
+    services?: readonly string[];
+    requestTimeoutMs?: number;
+    loaderOptions?: Record<string, unknown>;
+    channelOptions?: Record<string, unknown>;
+    credentials?: unknown;
+    kindMetadataKey?: string;
+    messageKindMetadataValue?: string;
+    eventKindMetadataValue?: string;
+    grpc?: GrpcJsLike;
+    protoLoader?: ProtoLoaderLike;
+    moduleLoader?: DynamicImport;
+    server?: GrpcServerLike;
+}
+/**
+ * gRPC transport for unary, event-style unary, and all streaming microservice patterns.
+ *
+ * The adapter loads protobuf definitions at runtime, registers service implementations on a gRPC server,
+ * and exposes matching unary/server-stream/client-stream/bidi-stream client calls through one transport surface.
+ */
+export declare class GrpcMicroserviceTransport implements MicroserviceTransport {
+    private readonly options;
+    private bidiStreamHandler;
+    private clientStreamHandler;
+    private closing;
+    private readonly clients;
+    private grpc;
+    private handler;
+    private logger;
+    private listening;
+    private listenPromise;
+    private readonly pending;
+    private packageRoot;
+    private readonly requestTimeoutMs;
+    private readonly server;
+    private resolvedServer;
+    private serverStreamHandler;
+    /**
+     * Creates a gRPC transport bound to one protobuf package and server endpoint.
+     *
+     * @param options Protobuf loading, server binding, and client-call settings for the transport.
+     */
+    constructor(options: GrpcMicroserviceTransportOptions);
+    setLogger(logger: MicroserviceTransportLogger): void;
+    /**
+     * Loads protobuf services, registers handlers, and binds the gRPC server.
+     *
+     * @param handler Runtime callback invoked for inbound unary message and event packets.
+     * @returns A promise that resolves once the gRPC server is bound and ready.
+     */
+    listen(handler: TransportHandler): Promise<void>;
+    /**
+     * Sends one unary request-response message through gRPC.
+     *
+     * @param pattern `<Service>.<Method>` pattern identifying the remote unary RPC.
+     * @param payload Serializable request payload.
+     * @param signal Optional abort signal used to cancel the call.
+     * @returns The decoded unary RPC response.
+     */
+    send(pattern: string, payload: unknown, signal?: AbortSignal): Promise<unknown>;
+    /**
+     * Emits one event-style unary call through gRPC.
+     *
+     * @param pattern `<Service>.<Method>` pattern identifying the remote RPC.
+     * @param payload Serializable event payload.
+     * @returns A promise that resolves once the remote RPC acknowledges the call.
+     */
+    emit(pattern: string, payload: unknown): Promise<void>;
+    /**
+     * Registers the runtime callback used for inbound server-streaming RPCs.
+     *
+     * @param handler Runtime callback invoked for inbound server-stream requests.
+     */
+    listenServerStreaming(handler: TransportServerStreamHandler): void;
+    /**
+     * Registers the runtime callback used for inbound client-streaming RPCs.
+     *
+     * @param handler Runtime callback invoked for inbound client-stream requests.
+     */
+    listenClientStreaming(handler: TransportClientStreamHandler): void;
+    /**
+     * Registers the runtime callback used for inbound bidirectional-streaming RPCs.
+     *
+     * @param handler Runtime callback invoked for inbound bidi-stream requests.
+     */
+    listenBidiStreaming(handler: TransportBidiStreamHandler): void;
+    /**
+     * Opens an outbound server-streaming call.
+     *
+     * @param pattern `<Service>.<Method>` pattern identifying the remote server-stream RPC.
+     * @param payload Serializable request payload.
+     * @param signal Optional abort signal used to cancel the stream.
+     * @returns An async iterable of streamed response messages.
+     */
+    serverStream(pattern: string, payload: unknown, signal?: AbortSignal): AsyncIterable<unknown>;
+    /**
+     * Opens an outbound client-streaming call.
+     *
+     * @param pattern `<Service>.<Method>` pattern identifying the remote client-stream RPC.
+     * @param signal Optional abort signal used to cancel the stream.
+     * @returns A writer for request messages and a promise for the final response payload.
+     */
+    clientStream(pattern: string, signal?: AbortSignal): {
+        writer: ServerStreamWriter;
+        result: Promise<unknown>;
+    };
+    /**
+     * Opens an outbound bidirectional-streaming call.
+     *
+     * @param pattern `<Service>.<Method>` pattern identifying the remote bidi-stream RPC.
+     * @param signal Optional abort signal used to cancel the stream.
+     * @returns A response reader paired with a request writer.
+     */
+    bidiStream(pattern: string, signal?: AbortSignal): {
+        reader: AsyncIterable<unknown>;
+        writer: ServerStreamWriter;
+    };
+    /**
+     * Shuts down the gRPC server and closes any cached service clients.
+     *
+     * @returns A promise that resolves once shutdown cleanup completes.
+     */
+    close(): Promise<void>;
+    private buildServiceImplementation;
+    private handleInboundUnary;
+    private handleInboundServerStream;
+    private handleInboundClientStream;
+    private handleInboundBidiStream;
+    private callUnary;
+    private callServerStream;
+    private callClientStream;
+    private callBidiStream;
+    private getServiceRuntime;
+    private resolvePackageRoot;
+    private resolveTargetServices;
+    private resolveServiceConstructor;
+    private isServiceConstructor;
+    private bindServer;
+    private shutdownServer;
+    private resolveGrpc;
+    private resolveProtoLoader;
+    private loadPeerModule;
+    private createMetadata;
+    private resolveInboundKind;
+    private kindMetadataValue;
+    private mapGrpcHandlerError;
+    private createGrpcError;
+    private resolveGrpcStatusCode;
+    private logEventHandlerFailure;
+}
+export {};
+//# sourceMappingURL=grpc-transport.d.ts.map

package/dist/transports/grpc-transport.d.ts.map

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