actor-ts 0.9.0

package/dist/io/broker/BrokerSettings.js

@@ -0,0 +1,73 @@
+export const DEFAULT_RECONNECT = {
+    initialDelayMs: 200,
+    maxDelayMs: 30_000,
+    factor: 2,
+    maxAttempts: Number.POSITIVE_INFINITY,
+};
+export const DEFAULT_OUTBOUND_BUFFER = 1000;
+/**
+ * Read the common reconnect / circuit-breaker / buffer fields from a
+ * Config block.  Subclass-specific fields are read by the subclass'
+ * own `readSettingsFromConfig()` method.
+ *
+ * Note: to *disable* reconnect via HOCON, set the leaf
+ * `reconnect.maxAttempts = 1` (one connect attempt, no retry).  The
+ * boolean `false` form is only supported via the constructor argument.
+ */
+export function readCommonSettings(config) {
+    const out = {};
+    if (config.hasPath('reconnect')) {
+        const sub = config.getConfig('reconnect');
+        out.reconnect = {
+            initialDelayMs: sub.hasPath('initialDelayMs') ? sub.getDuration('initialDelayMs') : undefined,
+            maxDelayMs: sub.hasPath('maxDelayMs') ? sub.getDuration('maxDelayMs') : undefined,
+            factor: sub.hasPath('factor') ? sub.getNumber('factor') : undefined,
+            maxAttempts: sub.hasPath('maxAttempts') ? sub.getNumber('maxAttempts') : undefined,
+        };
+    }
+    if (config.hasPath('circuitBreaker')) {
+        const sub = config.getConfig('circuitBreaker');
+        out.circuitBreaker = {
+            failureThreshold: sub.getInt('failureThreshold'),
+            resetMs: sub.getDuration('resetMs'),
+        };
+    }
+    if (config.hasPath('outboundBuffer')) {
+        out.outboundBuffer = config.getInt('outboundBuffer');
+    }
+    return out;
+}
+/**
+ * Merge settings in the documented precedence order:
+ *   1. constructor args  (highest)
+ *   2. HOCON config under `configKey`
+ *   3. built-in defaults  (lowest)
+ *
+ * Falsy / undefined values from a higher layer don't shadow lower
+ * layers — `undefined` means "not set", not "explicitly clear".
+ */
+export function mergeSettings(builtInDefaults, fromConfig, fromConstructor) {
+    return {
+        ...builtInDefaults,
+        ...stripUndefined(fromConfig),
+        ...stripUndefined(fromConstructor),
+    };
+}
+function stripUndefined(o) {
+    const out = {};
+    for (const [k, v] of Object.entries(o)) {
+        if (v !== undefined)
+            out[k] = v;
+    }
+    return out;
+}
+/** Raised when required settings are missing from every layer. */
+export class BrokerSettingsError extends Error {
+    configKey;
+    constructor(message, configKey) {
+        super(message);
+        this.configKey = configKey;
+        this.name = 'BrokerSettingsError';
+    }
+}
+//# sourceMappingURL=BrokerSettings.js.map

package/dist/io/broker/BrokerSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrokerSettings.js","sourceRoot":"","sources":["../../../src/io/broker/BrokerSettings.ts"],"names":[],"mappings":"AA2CA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,cAAc,EAAE,GAAG;IACnB,UAAU,EAAE,MAAM;IAClB,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,MAAM,CAAC,iBAAiB;CAC7B,CAAC;AAEX,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,GAAG,GAA6E,EAAE,CAAC;IAEzF,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC1C,GAAG,CAAC,SAAS,GAAG;YACd,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS;YAC7F,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;YACjF,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;YACnE,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS;SACnF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC/C,GAAG,CAAC,cAAc,GAAG;YACnB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC;YAChD,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC;SACpC,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACrC,GAAG,CAAC,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,eAA2B,EAC3B,UAAsB,EACtB,eAA2B;IAE3B,OAAO;QACL,GAAG,eAAe;QAClB,GAAG,cAAc,CAAC,UAAU,CAAC;QAC7B,GAAG,cAAc,CAAC,eAAe,CAAC;KAC9B,CAAC;AACT,CAAC;AAED,SAAS,cAAc,CAAmB,CAAI;IAC5C,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,GAAQ,CAAC;AAClB,CAAC;AAED,kEAAkE;AAClE,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACC;IAA7C,YAAY,OAAe,EAAkB,SAAiB;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,cAAS,GAAT,SAAS,CAAQ;QAE5D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/io/broker/GrpcClientActor.d.ts

@@ -0,0 +1,112 @@
+import type { Config } from '../../config/Config.js';
+import type { ActorRef } from '../../ActorRef.js';
+import { BrokerActor, type OutboundEnvelope } from './BrokerActor.js';
+import type { BrokerCommonSettings } from './BrokerSettings.js';
+/**
+ * Inbound gRPC reply / stream frame delivered to subscribers.  The
+ * `kind` discriminates between a unary completion, a stream chunk, the
+ * stream-end signal, and a stream error.
+ */
+export type GrpcInbound = {
+    readonly kind: 'reply';
+    readonly target: ActorRef<unknown>;
+    readonly response: unknown;
+} | {
+    readonly kind: 'stream-data';
+    readonly target: ActorRef<unknown>;
+    readonly streamId: number;
+    readonly chunk: unknown;
+} | {
+    readonly kind: 'stream-end';
+    readonly target: ActorRef<unknown>;
+    readonly streamId: number;
+} | {
+    readonly kind: 'stream-error';
+    readonly target: ActorRef<unknown>;
+    readonly streamId: number;
+    readonly error: Error;
+} | {
+    readonly kind: 'rpc-error';
+    readonly target: ActorRef<unknown>;
+    readonly error: Error;
+};
+/** TLS / mTLS credentials. */
+export type GrpcCredentials = {
+    readonly kind: 'insecure';
+} | {
+    readonly kind: 'tls';
+    readonly rootCerts?: Uint8Array;
+    readonly cert?: Uint8Array;
+    readonly key?: Uint8Array;
+};
+export interface GrpcClientActorSettings extends BrokerCommonSettings {
+    /** Path to the `.proto` file (or array of paths). */
+    readonly protoPath?: string | ReadonlyArray<string>;
+    /** gRPC package name (`'sensor.v1'`). */
+    readonly packageName?: string;
+    /** Service name (`'SensorService'`). */
+    readonly serviceName?: string;
+    /** Server endpoint (`'host:port'`). */
+    readonly endpoint?: string;
+    readonly credentials?: GrpcCredentials;
+    /** Per-call deadline in ms.  Default 30_000. */
+    readonly deadlineMs?: number;
+}
+/** Outbound command — what the actor accepts to fire RPC calls. */
+export type GrpcClientCmd = {
+    readonly kind: 'unary';
+    readonly method: string;
+    readonly request: unknown;
+    readonly target: ActorRef<unknown>;
+} | {
+    readonly kind: 'serverStream';
+    readonly method: string;
+    readonly request: unknown;
+    readonly target: ActorRef<unknown>;
+} | {
+    readonly kind: 'bidiStart';
+    readonly method: string;
+    readonly target: ActorRef<unknown>;
+} | {
+    readonly kind: 'bidiSend';
+    readonly streamId: number;
+    readonly chunk: unknown;
+} | {
+    readonly kind: 'bidiClose';
+    readonly streamId: number;
+};
+interface OutboundOp {
+    readonly op: GrpcClientCmd;
+}
+/**
+ * gRPC client actor.  One client instance per service, supports unary,
+ * server-stream, and bidi-stream calls.  All inbound data (replies,
+ * stream chunks) goes to the per-call `target` actor as
+ * `GrpcInbound` messages.
+ *
+ * Bidi streams: `bidiStart` returns nothing — the actor publishes a
+ * `'stream-data'` event to the target with `streamId` already filled
+ * in.  Subsequent `bidiSend` / `bidiClose` reference that id.  When
+ * the server closes its side, a `'stream-end'` is delivered.
+ */
+export declare class GrpcClientActor extends BrokerActor<GrpcClientActorSettings, GrpcClientCmd, OutboundOp> {
+    private serviceClient;
+    private nextStreamId;
+    private readonly bidiStreams;
+    constructor(settings?: Partial<GrpcClientActorSettings>);
+    protected configKey(): string;
+    protected builtInDefaults(): Partial<GrpcClientActorSettings>;
+    protected readSettingsFromConfig(c: Config): Partial<GrpcClientActorSettings>;
+    protected requiredSettings(): ReadonlyArray<keyof GrpcClientActorSettings>;
+    protected endpointLabel(): string;
+    protected connectImpl(): Promise<void>;
+    protected disconnectImpl(): Promise<void>;
+    protected dispatchOutgoing(env: OutboundEnvelope<OutboundOp>): Promise<void>;
+    onReceive(cmd: GrpcClientCmd): void;
+    private invokeUnary;
+    private invokeServerStream;
+    private invokeBidiStart;
+    private buildCredentials;
+}
+export {};
+//# sourceMappingURL=GrpcClientActor.d.ts.map

package/dist/io/broker/GrpcClientActor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GrpcClientActor.d.ts","sourceRoot":"","sources":["../../../src/io/broker/GrpcClientActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAC1F;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACxH;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC9F;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACvH;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAE9F,8BAA8B;AAC9B,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC;AAErH,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACpD,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;IACvC,gDAAgD;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,mEAAmE;AACnE,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;CAAE,GAClH;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;CAAE,GACzH;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;CAAE,GAC3F;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACjF;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,UAAU,UAAU;IAClB,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eACX,SAAQ,WAAW,CAAC,uBAAuB,EAAE,aAAa,EAAE,UAAU,CAAC;IACvE,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0E;gBAE1F,QAAQ,GAAE,OAAO,CAAC,uBAAuB,CAAM;IAE3D,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,eAAe,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAG7D,SAAS,CAAC,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAa7E,SAAS,CAAC,gBAAgB,IAAI,aAAa,CAAC,MAAM,uBAAuB,CAAC;IAG1E,SAAS,CAAC,aAAa,IAAI,MAAM;cAEjB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;cA8B5B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;cAW/B,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBzE,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAM5C,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,kBAAkB;IAqB1B,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,gBAAgB;CASzB"}

package/dist/io/broker/GrpcClientActor.js

@@ -0,0 +1,212 @@
+import { ConfigKeys } from '../../config/ConfigKeys.js';
+import { Lazy } from '../../util/Lazy.js';
+import { BrokerActor } from './BrokerActor.js';
+/**
+ * gRPC client actor.  One client instance per service, supports unary,
+ * server-stream, and bidi-stream calls.  All inbound data (replies,
+ * stream chunks) goes to the per-call `target` actor as
+ * `GrpcInbound` messages.
+ *
+ * Bidi streams: `bidiStart` returns nothing — the actor publishes a
+ * `'stream-data'` event to the target with `streamId` already filled
+ * in.  Subsequent `bidiSend` / `bidiClose` reference that id.  When
+ * the server closes its side, a `'stream-end'` is delivered.
+ */
+export class GrpcClientActor extends BrokerActor {
+    serviceClient = null;
+    nextStreamId = 1;
+    bidiStreams = new Map();
+    constructor(settings = {}) { super(settings); }
+    configKey() { return ConfigKeys.io.broker.grpc.client; }
+    builtInDefaults() {
+        return { credentials: { kind: 'insecure' }, deadlineMs: 30_000 };
+    }
+    readSettingsFromConfig(c) {
+        const out = {};
+        if (c.hasPath('protoPath')) {
+            const v = c.getList('protoPath');
+            if (v.length === 1 && typeof v[0] === 'string')
+                out.protoPath = v[0];
+            else
+                out.protoPath = c.getStringList('protoPath');
+        }
+        if (c.hasPath('packageName'))
+            out.packageName = c.getString('packageName');
+        if (c.hasPath('serviceName'))
+            out.serviceName = c.getString('serviceName');
+        if (c.hasPath('endpoint'))
+            out.endpoint = c.getString('endpoint');
+        if (c.hasPath('deadlineMs'))
+            out.deadlineMs = c.getDuration('deadlineMs');
+        return out;
+    }
+    requiredSettings() {
+        return ['protoPath', 'packageName', 'serviceName', 'endpoint'];
+    }
+    endpointLabel() { return `grpc://${this.settings.endpoint}`; }
+    async connectImpl() {
+        const grpc = await grpcLazy.get();
+        const protoLoader = await protoLoaderLazy.get();
+        const protoPaths = Array.isArray(this.settings.protoPath)
+            ? [...this.settings.protoPath]
+            : [this.settings.protoPath];
+        const packageDefinition = protoLoader.loadSync(protoPaths, {
+            keepCase: true, longs: String, enums: String, defaults: true, oneofs: true,
+        });
+        const loaded = grpc.loadPackageDefinition(packageDefinition);
+        // Walk the dotted package name.
+        let pkg = loaded;
+        for (const seg of this.settings.packageName.split('.')) {
+            const next = pkg[seg];
+            if (!next || typeof next !== 'object') {
+                throw new Error(`grpc: package '${this.settings.packageName}' not found in proto`);
+            }
+            pkg = next;
+        }
+        const ServiceCtor = pkg[this.settings.serviceName];
+        if (!ServiceCtor) {
+            throw new Error(`grpc: service '${this.settings.serviceName}' not found in package '${this.settings.packageName}'`);
+        }
+        const creds = this.buildCredentials(grpc);
+        this.serviceClient = new ServiceCtor(this.settings.endpoint, creds);
+    }
+    async disconnectImpl() {
+        for (const [, s] of this.bidiStreams) {
+            try {
+                s.call.end();
+            }
+            catch { /* ignore */ }
+        }
+        this.bidiStreams.clear();
+        if (this.serviceClient) {
+            try {
+                this.serviceClient.close?.();
+            }
+            catch { /* ignore */ }
+            this.serviceClient = null;
+        }
+    }
+    async dispatchOutgoing(env) {
+        if (!this.serviceClient)
+            throw new Error('GrpcClientActor: not connected');
+        const op = env.payload.op;
+        if (op.kind === 'unary') {
+            this.invokeUnary(op);
+        }
+        else if (op.kind === 'serverStream') {
+            this.invokeServerStream(op);
+        }
+        else if (op.kind === 'bidiStart') {
+            this.invokeBidiStart(op);
+        }
+        else if (op.kind === 'bidiSend') {
+            const s = this.bidiStreams.get(op.streamId);
+            if (s)
+                s.call.write(op.chunk);
+        }
+        else if (op.kind === 'bidiClose') {
+            const s = this.bidiStreams.get(op.streamId);
+            if (s) {
+                try {
+                    s.call.end();
+                }
+                catch { /* ignore */ }
+                this.bidiStreams.delete(op.streamId);
+            }
+        }
+    }
+    onReceive(cmd) {
+        this.enqueueOutbound({ op: cmd });
+    }
+    /* ----------------------------- internals ----------------------------- */
+    invokeUnary(op) {
+        const client = this.serviceClient;
+        if (!client)
+            return;
+        const fn = client[op.method];
+        if (!fn) {
+            op.target.tell({ kind: 'rpc-error', target: op.target, error: new Error(`unknown method: ${op.method}`) });
+            return;
+        }
+        fn.call(client, op.request, (err, response) => {
+            if (err)
+                op.target.tell({ kind: 'rpc-error', target: op.target, error: err });
+            else
+                op.target.tell({ kind: 'reply', target: op.target, response });
+        });
+    }
+    invokeServerStream(op) {
+        const client = this.serviceClient;
+        if (!client)
+            return;
+        const fn = client[op.method];
+        if (!fn) {
+            op.target.tell({ kind: 'rpc-error', target: op.target, error: new Error(`unknown method: ${op.method}`) });
+            return;
+        }
+        const streamId = this.nextStreamId++;
+        const call = fn.call(client, op.request);
+        call.on('data', (chunk) => {
+            op.target.tell({ kind: 'stream-data', target: op.target, streamId, chunk });
+        });
+        call.on('end', () => {
+            op.target.tell({ kind: 'stream-end', target: op.target, streamId });
+        });
+        call.on('error', (err) => {
+            op.target.tell({ kind: 'stream-error', target: op.target, streamId, error: err });
+        });
+    }
+    invokeBidiStart(op) {
+        const client = this.serviceClient;
+        if (!client)
+            return;
+        const fn = client[op.method];
+        if (!fn) {
+            op.target.tell({ kind: 'rpc-error', target: op.target, error: new Error(`unknown method: ${op.method}`) });
+            return;
+        }
+        const streamId = this.nextStreamId++;
+        const call = fn.call(client);
+        this.bidiStreams.set(streamId, { call, target: op.target });
+        call.on('data', (chunk) => {
+            op.target.tell({ kind: 'stream-data', target: op.target, streamId, chunk });
+        });
+        call.on('end', () => {
+            op.target.tell({ kind: 'stream-end', target: op.target, streamId });
+            this.bidiStreams.delete(streamId);
+        });
+        call.on('error', (err) => {
+            op.target.tell({ kind: 'stream-error', target: op.target, streamId, error: err });
+            this.bidiStreams.delete(streamId);
+        });
+        // Send the streamId back so the caller can address future bidiSend/Close.
+        op.target.tell({ kind: 'stream-data', target: op.target, streamId, chunk: { __streamId: streamId } });
+    }
+    buildCredentials(grpc) {
+        const c = this.settings.credentials ?? { kind: 'insecure' };
+        if (c.kind === 'insecure')
+            return grpc.credentials.createInsecure();
+        return grpc.credentials.createSsl(c.rootCerts ? Buffer.from(c.rootCerts) : null, c.key ? Buffer.from(c.key) : null, c.cert ? Buffer.from(c.cert) : null);
+    }
+}
+const grpcLazy = Lazy.of(async () => {
+    try {
+        const name = '@grpc/grpc-js';
+        return (await import(name));
+    }
+    catch (e) {
+        throw new Error('GrpcClientActor requires "@grpc/grpc-js".  Install it with: npm install @grpc/grpc-js @grpc/proto-loader\n'
+            + 'Original error: ' + (e instanceof Error ? e.message : String(e)));
+    }
+});
+const protoLoaderLazy = Lazy.of(async () => {
+    try {
+        const name = '@grpc/proto-loader';
+        return (await import(name));
+    }
+    catch (e) {
+        throw new Error('GrpcClientActor requires "@grpc/proto-loader".  Install it with: npm install @grpc/proto-loader\n'
+            + 'Original error: ' + (e instanceof Error ? e.message : String(e)));
+    }
+});
+//# sourceMappingURL=GrpcClientActor.js.map

package/dist/io/broker/GrpcClientActor.js.map

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

package/dist/io/broker/GrpcServerActor.d.ts

@@ -0,0 +1,101 @@
+import type { ActorRef } from '../../ActorRef.js';
+import { Actor } from '../../Actor.js';
+import { type BrokerCommonSettings } from './BrokerSettings.js';
+/**
+ * gRPC handler descriptor — paired with a method name when the server
+ * actor is constructed.  Each handler is a target actor that receives
+ * `GrpcCall<Req, Res>` envelopes.
+ */
+export type GrpcHandler = {
+    readonly kind: 'unary';
+    readonly target: ActorRef<GrpcUnaryCall>;
+} | {
+    readonly kind: 'serverStream';
+    readonly target: ActorRef<GrpcServerStreamCall>;
+} | {
+    readonly kind: 'bidi';
+    readonly target: ActorRef<GrpcBidiCall>;
+};
+/** Inbound unary call — handler must reply via `respond`. */
+export interface GrpcUnaryCall {
+    readonly method: string;
+    readonly request: unknown;
+    readonly metadata: Readonly<Record<string, string>>;
+    /** Reply with success (status OK). */
+    respond(response: unknown): void;
+    /** Reply with an error.  `code` defaults to 13 (INTERNAL). */
+    respondError(message: string, code?: number): void;
+}
+/** Inbound server-stream call — handler emits via `send`, ends via `complete`. */
+export interface GrpcServerStreamCall {
+    readonly method: string;
+    readonly request: unknown;
+    readonly metadata: Readonly<Record<string, string>>;
+    send(chunk: unknown): void;
+    complete(): void;
+    fail(message: string, code?: number): void;
+}
+/** Bidi call — handler receives chunks via `data` callback, sends via `send`. */
+export interface GrpcBidiCall {
+    readonly method: string;
+    readonly metadata: Readonly<Record<string, string>>;
+    /** Subscribe an actor to receive every inbound chunk + the end signal. */
+    onData(target: ActorRef<{
+        readonly kind: 'chunk';
+        readonly chunk: unknown;
+    } | {
+        readonly kind: 'end';
+    }>): void;
+    send(chunk: unknown): void;
+    complete(): void;
+    fail(message: string, code?: number): void;
+}
+export interface GrpcServerSettings extends BrokerCommonSettings {
+    readonly protoPath?: string | ReadonlyArray<string>;
+    readonly packageName?: string;
+    readonly serviceName?: string;
+    /** Bind address (`'0.0.0.0:50051'`). */
+    readonly bind?: string;
+    /** Method-name → handler mapping.  Methods absent from this map are unimplemented (UNIMPLEMENTED status). */
+    readonly handlers?: Readonly<Record<string, GrpcHandler>>;
+    /**
+     * TLS — when omitted, the server binds insecurely.  For mTLS supply
+     * cert + key + (optionally) `rootCerts` for client auth.
+     */
+    readonly credentials?: {
+        readonly kind: 'insecure';
+    } | {
+        readonly kind: 'tls';
+        readonly cert: Uint8Array;
+        readonly key: Uint8Array;
+        readonly rootCerts?: Uint8Array;
+    };
+}
+/**
+ * gRPC server actor.  Differs from the `BrokerActor` base shape — a
+ * server is *bound*, not connected; there are no outbound messages
+ * the actor itself produces.  Handlers run independently and forward
+ * inbound calls to user-supplied target actors.
+ *
+ * Lifecycle:
+ *   - `preStart`: load proto, build server, register methods, bind.
+ *   - `postStop`: graceful `tryShutdown`, then `forceShutdown` after a
+ *     short grace period.
+ */
+export declare class GrpcServerActor extends Actor<unknown> {
+    private readonly _ctorSettings;
+    private settings;
+    private server;
+    private bound;
+    constructor(_ctorSettings: Partial<GrpcServerSettings>);
+    preStart(): Promise<void>;
+    postStop(): Promise<void>;
+    onReceive(_: unknown): void;
+    /** Bound port (useful when `bind: '0.0.0.0:0'` was used to let the OS pick). */
+    get isBound(): boolean;
+    private resolveSettings;
+    private validateRequired;
+    private bindServer;
+    private buildMethodImpl;
+}
+//# sourceMappingURL=GrpcServerActor.d.ts.map

package/dist/io/broker/GrpcServerActor.d.ts.map

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