@fluojs/microservices 1.0.0-beta.1

package/dist/module.d.ts

@@ -0,0 +1,23 @@
+import type { Provider } from '@fluojs/di';
+import { type ModuleType } from '@fluojs/runtime';
+import type { MicroserviceModuleOptions } from './types.js';
+/**
+ * Creates DI providers for the microservice runtime and transport options.
+ *
+ * @param options Microservice transport configuration consumed by the runtime lifecycle service.
+ * @returns Provider definitions that register `MICROSERVICE_OPTIONS`, `MicroserviceLifecycleService`, and the compatibility alias `MICROSERVICE`.
+ */
+export declare function createMicroservicesProviders(options: MicroserviceModuleOptions): Provider[];
+/**
+ * Runtime module entrypoint for registering microservice transport wiring.
+ */
+export declare class MicroservicesModule {
+    /**
+     * Registers the microservice runtime providers as a global module.
+     *
+     * @param options Transport and handler runtime options for the microservice lifecycle service.
+     * @returns A module definition that exports `MicroserviceLifecycleService` and the compatibility token `MICROSERVICE`.
+     */
+    static forRoot(options: MicroserviceModuleOptions): ModuleType;
+}
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIhE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,yBAAyB,GAAG,QAAQ,EAAE,CA2B3F;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,yBAAyB,GAAG,UAAU;CAgB/D"}

package/dist/module.js

@@ -0,0 +1,55 @@
+import { defineModule } from '@fluojs/runtime';
+import { MicroserviceLifecycleService } from './service.js';
+import { MICROSERVICE, MICROSERVICE_OPTIONS } from './tokens.js';
+/**
+ * Creates DI providers for the microservice runtime and transport options.
+ *
+ * @param options Microservice transport configuration consumed by the runtime lifecycle service.
+ * @returns Provider definitions that register `MICROSERVICE_OPTIONS`, `MicroserviceLifecycleService`, and the compatibility alias `MICROSERVICE`.
+ */
+export function createMicroservicesProviders(options) {
+  return [{
+    provide: MICROSERVICE_OPTIONS,
+    useValue: options
+  }, MicroserviceLifecycleService, {
+    inject: [MicroserviceLifecycleService],
+    provide: MICROSERVICE,
+    useFactory: service => {
+      const runtime = service;
+      return {
+        bidiStream: runtime.bidiStream ? (pattern, signal) => runtime.bidiStream(pattern, signal) : undefined,
+        clientStream: runtime.clientStream ? (pattern, signal) => runtime.clientStream(pattern, signal) : undefined,
+        close: _signal => runtime.close(),
+        emit: (pattern, payload) => runtime.emit(pattern, payload),
+        listen: () => runtime.listen(),
+        send: (pattern, payload, signal) => runtime.send(pattern, payload, signal),
+        serverStream: runtime.serverStream ? (pattern, payload, signal) => runtime.serverStream(pattern, payload, signal) : undefined
+      };
+    }
+  }];
+}
+
+/**
+ * Runtime module entrypoint for registering microservice transport wiring.
+ */
+export class MicroservicesModule {
+  /**
+   * Registers the microservice runtime providers as a global module.
+   *
+   * @param options Transport and handler runtime options for the microservice lifecycle service.
+   * @returns A module definition that exports `MicroserviceLifecycleService` and the compatibility token `MICROSERVICE`.
+   */
+  static forRoot(options) {
+    class MicroservicesModuleDefinition {}
+    const additionalExports = options.module?.additionalExports ?? [];
+    const additionalProviders = options.module?.providers ?? [];
+    const global = options.module?.global ?? true;
+    return defineModule(MicroservicesModuleDefinition, {
+      exports: [MicroserviceLifecycleService, MICROSERVICE, ...additionalExports],
+      global,
+      providers: [...createMicroservicesProviders({
+        transport: options.transport
+      }), ...additionalProviders]
+    });
+  }
+}

package/dist/service.d.ts

@@ -0,0 +1,116 @@
+import type { Container } from '@fluojs/di';
+import { type ApplicationLogger, type CompiledModule, type MicroserviceRuntime, type OnApplicationShutdown } from '@fluojs/runtime';
+import type { Microservice, MicroserviceModuleOptions, ServerStreamWriter } from './types.js';
+/**
+ * Lifecycle-managed microservice runtime that discovers pattern handlers and binds them to a transport.
+ *
+ * The service resolves singleton or request-scoped handlers, exposes programmatic
+ * send/emit/stream APIs, and delegates transport-specific I/O to the configured adapter.
+ */
+export declare class MicroserviceLifecycleService implements Microservice, MicroserviceRuntime, OnApplicationShutdown {
+    private readonly runtimeContainer;
+    private readonly compiledModules;
+    private readonly logger;
+    private readonly moduleOptions;
+    private readonly descriptors;
+    private readonly handlerInstances;
+    private lifecycleState;
+    private lastListenError;
+    private listening;
+    private listenPromise;
+    constructor(runtimeContainer: Container, compiledModules: readonly CompiledModule[], logger: ApplicationLogger, moduleOptions: MicroserviceModuleOptions);
+    /**
+     * Starts transport listeners and discovers decorated handlers.
+     *
+     * @returns A promise that resolves once the configured transport is ready to accept traffic.
+     */
+    listen(): Promise<void>;
+    /**
+     * Closes the configured transport and stops accepting microservice traffic.
+     *
+     * @returns A promise that resolves once shutdown completes.
+     */
+    close(): Promise<void>;
+    onApplicationShutdown(): Promise<void>;
+    /**
+     * Creates a platform status snapshot for health checks and diagnostics.
+     *
+     * @returns A structured snapshot describing handler counts, transport capabilities, and lifecycle state.
+     */
+    createPlatformStatusSnapshot(): import("./status.js").MicroservicePlatformStatusSnapshot;
+    /**
+     * Sends one request-response message through the configured transport.
+     *
+     * @param pattern Pattern identifying the remote handler.
+     * @param payload Serializable payload forwarded to the transport.
+     * @param signal Optional abort signal passed to the transport.
+     * @returns The transport response payload.
+     */
+    send(pattern: string, payload: unknown, signal?: AbortSignal): Promise<unknown>;
+    /**
+     * Emits one fire-and-forget event through the configured transport.
+     *
+     * @param pattern Pattern identifying the remote event channel.
+     * @param payload Serializable payload forwarded to the transport.
+     * @returns A promise that resolves once the transport accepts the event.
+     */
+    emit(pattern: string, payload: unknown): Promise<void>;
+    /**
+     * Opens a server-streaming request through the configured transport.
+     *
+     * @param pattern Pattern identifying the remote server-stream handler.
+     * @param payload Serializable request payload forwarded to the transport.
+     * @param signal Optional abort signal passed to the transport.
+     * @returns An async iterable of stream messages.
+     *
+     * @throws {Error} When the configured transport does not implement `serverStream()`.
+     */
+    serverStream(pattern: string, payload: unknown, signal?: AbortSignal): AsyncIterable<unknown>;
+    /**
+     * Opens a client-streaming request through the configured transport.
+     *
+     * @param pattern Pattern identifying the remote client-stream handler.
+     * @param signal Optional abort signal passed to the transport.
+     * @returns A writer for request chunks plus a promise for the final response.
+     *
+     * @throws {Error} When the configured transport does not implement `clientStream()`.
+     */
+    clientStream(pattern: string, signal?: AbortSignal): {
+        writer: ServerStreamWriter;
+        result: Promise<unknown>;
+    };
+    /**
+     * Opens a bidirectional stream through the configured transport.
+     *
+     * @param pattern Pattern identifying the remote bidi-stream handler.
+     * @param signal Optional abort signal passed to the transport.
+     * @returns A reader for response chunks and a writer for outbound chunks.
+     *
+     * @throws {Error} When the configured transport does not implement `bidiStream()`.
+     */
+    bidiStream(pattern: string, signal?: AbortSignal): {
+        reader: AsyncIterable<unknown>;
+        writer: ServerStreamWriter;
+    };
+    private dispatchPacket;
+    private dispatchServerStream;
+    private invokeServerStreamHandler;
+    private invokeResolvedServerStreamHandler;
+    private dispatchClientStream;
+    private invokeClientStreamHandler;
+    private invokeResolvedClientStreamHandler;
+    private dispatchBidiStream;
+    private invokeBidiStreamHandler;
+    private invokeResolvedBidiStreamHandler;
+    private dispatchEventHandlers;
+    private invokeResolvedHandlerInScope;
+    private matchesPattern;
+    private discoverHandlerDescriptors;
+    private dedupeKey;
+    private isDuplicate;
+    private discoveryCandidates;
+    private invokeHandler;
+    private invokeResolvedHandler;
+    private resolveSingletonHandlerInstance;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,YAAY,CAAC;AACtD,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AAMzB,OAAO,KAAK,EAGV,YAAY,EACZ,yBAAyB,EAEzB,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AA6BpB;;;;;GAKG;AACH,qBACa,4BAA6B,YAAW,YAAY,EAAE,mBAAmB,EAAE,qBAAqB;IASzG,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAXhC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2B;IACvD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsC;IACvE,OAAO,CAAC,cAAc,CAAmF;IACzG,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAA4B;gBAG9B,gBAAgB,EAAE,SAAS,EAC3B,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,MAAM,EAAE,iBAAiB,EACzB,aAAa,EAAE,yBAAyB;IAG3D;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA2D7B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBtB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;;OAIG;IACH,4BAA4B;IAqB5B;;;;;;;OAOG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrF;;;;;;OAMG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D;;;;;;;;;OASG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC;IAU7F;;;;;;;;OAQG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG;QAAE,MAAM,EAAE,kBAAkB,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE;IAU7G;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG;QAAE,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAAC,MAAM,EAAE,kBAAkB,CAAA;KAAE;YAUnG,cAAc;YAyBd,oBAAoB;YA+BpB,yBAAyB;YAiCzB,iCAAiC;YAuBjC,oBAAoB;YA4BpB,yBAAyB;YA+BzB,iCAAiC;YAsBjC,kBAAkB;YA+BlB,uBAAuB;YAiCvB,+BAA+B;YAuB/B,qBAAqB;YA8DrB,4BAA4B;IAK1C,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,0BAA0B;IAkClC,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,mBAAmB;YAsCb,aAAa;YAuBb,qBAAqB;YA2BrB,+BAA+B;CAsB9C"}