actor-ts 0.9.0

package/dist/io/broker/GrpcServerActor.js

@@ -0,0 +1,230 @@
+import { ConfigKeys } from '../../config/ConfigKeys.js';
+import { Lazy } from '../../util/Lazy.js';
+import { Actor } from '../../Actor.js';
+import { BrokerSettingsError } from './BrokerSettings.js';
+/**
+ * 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 class GrpcServerActor extends Actor {
+    _ctorSettings;
+    settings;
+    server = null;
+    bound = false;
+    constructor(_ctorSettings) {
+        super();
+        this._ctorSettings = _ctorSettings;
+    }
+    async preStart() {
+        this.settings = await this.resolveSettings();
+        this.validateRequired();
+        await this.bindServer();
+    }
+    async postStop() {
+        if (!this.server)
+            return;
+        const sv = this.server;
+        this.server = null;
+        this.bound = false;
+        await new Promise((resolve) => {
+            let done = false;
+            sv.tryShutdown((err) => {
+                if (done)
+                    return;
+                done = true;
+                if (err)
+                    sv.forceShutdown();
+                resolve();
+            });
+            setTimeout(() => {
+                if (done)
+                    return;
+                done = true;
+                try {
+                    sv.forceShutdown();
+                }
+                catch { /* ignore */ }
+                resolve();
+            }, 2_000);
+        });
+    }
+    onReceive(_) { }
+    /** Bound port (useful when `bind: '0.0.0.0:0'` was used to let the OS pick). */
+    get isBound() { return this.bound; }
+    /* ----------------------------- internals ----------------------------- */
+    async resolveSettings() {
+        const defaults = {
+            credentials: { kind: 'insecure' },
+        };
+        const cfgPath = ConfigKeys.io.broker.grpc.server;
+        const cfg = this.system.config.hasPath(cfgPath)
+            ? this.system.config.getConfig(cfgPath)
+            : null;
+        const fromCfg = {};
+        if (cfg) {
+            if (cfg.hasPath('protoPath')) {
+                const v = cfg.getList('protoPath');
+                if (v.length === 1 && typeof v[0] === 'string')
+                    fromCfg.protoPath = v[0];
+                else
+                    fromCfg.protoPath = cfg.getStringList('protoPath');
+            }
+            if (cfg.hasPath('packageName'))
+                fromCfg.packageName = cfg.getString('packageName');
+            if (cfg.hasPath('serviceName'))
+                fromCfg.serviceName = cfg.getString('serviceName');
+            if (cfg.hasPath('bind'))
+                fromCfg.bind = cfg.getString('bind');
+        }
+        return { ...defaults, ...fromCfg, ...this._ctorSettings };
+    }
+    validateRequired() {
+        const required = ['protoPath', 'packageName', 'serviceName', 'bind', 'handlers'];
+        const missing = required.filter((k) => this.settings[k] === undefined);
+        if (missing.length > 0) {
+            throw new BrokerSettingsError(`GrpcServerActor missing required settings: ${missing.join(', ')}`, ConfigKeys.io.broker.grpc.server);
+        }
+    }
+    async bindServer() {
+        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);
+        let pkg = loaded;
+        for (const seg of this.settings.packageName.split('.')) {
+            pkg = pkg[seg];
+        }
+        const serviceCtor = pkg[this.settings.serviceName];
+        if (!serviceCtor?.service) {
+            throw new Error(`grpc-server: service '${this.settings.serviceName}' not found`);
+        }
+        this.server = new grpc.Server();
+        const impl = {};
+        for (const [methodName, handler] of Object.entries(this.settings.handlers ?? {})) {
+            impl[methodName] = this.buildMethodImpl(methodName, handler);
+        }
+        this.server.addService(serviceCtor.service, impl);
+        const creds = this.settings.credentials?.kind === 'tls'
+            ? grpc.ServerCredentials.createSsl(this.settings.credentials.rootCerts ? Buffer.from(this.settings.credentials.rootCerts) : null, [{
+                    private_key: Buffer.from(this.settings.credentials.key),
+                    cert_chain: Buffer.from(this.settings.credentials.cert),
+                }], this.settings.credentials.rootCerts !== undefined)
+            : grpc.ServerCredentials.createInsecure();
+        await new Promise((resolve, reject) => {
+            this.server.bindAsync(this.settings.bind, creds, (err) => {
+                if (err)
+                    reject(err);
+                else {
+                    this.bound = true;
+                    this.server.start();
+                    resolve();
+                }
+            });
+        });
+    }
+    buildMethodImpl(methodName, handler) {
+        if (handler.kind === 'unary') {
+            return (call, cb) => {
+                const userCall = {
+                    method: methodName,
+                    request: call.request,
+                    metadata: extractMetadata(call.metadata),
+                    respond: (response) => cb(null, response),
+                    respondError: (message, code) => cb({ code: code ?? 13, message }),
+                };
+                handler.target.tell(userCall);
+            };
+        }
+        if (handler.kind === 'serverStream') {
+            return (call) => {
+                let ended = false;
+                const userCall = {
+                    method: methodName,
+                    request: call.request,
+                    metadata: extractMetadata(call.metadata),
+                    send: (chunk) => { if (!ended)
+                        call.write(chunk); },
+                    complete: () => { if (!ended) {
+                        ended = true;
+                        call.end();
+                    } },
+                    fail: (message, code) => { if (!ended) {
+                        ended = true;
+                        call.emit('error', { code: code ?? 13, message });
+                    } },
+                };
+                handler.target.tell(userCall);
+            };
+        }
+        // bidi
+        return (call) => {
+            const subscribers = new Set();
+            let ended = false;
+            const userCall = {
+                method: methodName,
+                metadata: extractMetadata(call.metadata),
+                onData: (target) => { subscribers.add(target); },
+                send: (chunk) => { if (!ended)
+                    call.write(chunk); },
+                complete: () => { if (!ended) {
+                    ended = true;
+                    call.end();
+                } },
+                fail: (message, code) => { if (!ended) {
+                    ended = true;
+                    call.emit('error', { code: code ?? 13, message });
+                } },
+            };
+            handler.target.tell(userCall);
+            call.on('data', (chunk) => {
+                for (const ref of subscribers)
+                    ref.tell({ kind: 'chunk', chunk });
+            });
+            call.on('end', () => {
+                for (const ref of subscribers)
+                    ref.tell({ kind: 'end' });
+            });
+        };
+    }
+}
+/* ----------------------------- internals -------------------------------- */
+function extractMetadata(md) {
+    // grpc-js Metadata has an opaque internal representation; for tests we
+    // return an empty object and let real users dig into the raw call if
+    // they need full headers.
+    void md;
+    return {};
+}
+const grpcLazy = Lazy.of(async () => {
+    try {
+        const name = '@grpc/grpc-js';
+        return (await import(name));
+    }
+    catch (e) {
+        throw new Error('GrpcServerActor 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('GrpcServerActor requires "@grpc/proto-loader".  Install it with: npm install @grpc/proto-loader\n'
+            + 'Original error: ' + (e instanceof Error ? e.message : String(e)));
+    }
+});
+//# sourceMappingURL=GrpcServerActor.js.map

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

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

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

@@ -0,0 +1,352 @@
+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';
+/**
+ * JetStream durable-streaming actor (#3).  Sister to {@link NatsActor}
+ * — same `nats` peer-dep, same broker scaffold, but the consumer
+ * binds a **push consumer** to a durable JetStream subscription so
+ * recovery, replay, and explicit acks all work.  Where NatsActor is
+ * fire-and-forget pub/sub, JetStreamActor is durable streaming with
+ * Kafka-style "exactly-once-with-processing" semantics via the
+ * `ack` / `nak` / `term` command handshake.
+ *
+ * **What this actor does (v1).**
+ *
+ *   - Connects to NATS, opens a JetStream context.
+ *   - Optionally **creates or updates** a stream (`stream.name`,
+ *     `subjects`, retention, etc.) at connect time.
+ *   - Optionally **creates or updates** a durable consumer
+ *     (`consumer.durable`) and binds a push subscription delivering
+ *     to `target`.
+ *   - Forwards every consumed message to `target` and waits for an
+ *     explicit `ack` / `nak` / `term` command before the consumer's
+ *     ack-window expires (`ackWaitMs`).  Same shape as KafkaActor's
+ *     `commitMode: 'manual'` (#2).
+ *   - Publishing supports JetStream idempotent publish via the
+ *     `messageId` field (sent as the `Nats-Msg-Id` header — server
+ *     dedupes a message-id within the stream's deduplication window).
+ *
+ * **Out of scope for v1.**
+ *
+ *   - **Pull consumers**.  Push is the natural fit for actor-style
+ *     fan-out; pull consumers introduce a separate async loop and a
+ *     batch-fetch API.  File a follow-up if needed.
+ *   - **KV / Object Store**.  Different JetStream sub-APIs; warrant
+ *     their own actors.
+ *   - **Stream / consumer deletion**.  Actor only ever creates or
+ *     updates — destroying a stream is an operator concern, not a
+ *     runtime one.
+ *
+ * **Example.**
+ *
+ *   const js = system.spawnAnonymous(Props.create(() => new JetStreamActor({
+ *     servers: ['nats://localhost:4222'],
+ *     stream:  { name: 'ORDERS', subjects: ['orders.*'] },
+ *     consumer: { durable: 'order-processor', ackWaitMs: 30_000 },
+ *     target:  orderProcessor,
+ *   })));
+ *
+ *   class OrderProcessor extends Actor<JetStreamMessage> {
+ *     constructor(private readonly js: ActorRef<JetStreamCmd>) { super(); }
+ *     async onReceive(m: JetStreamMessage) {
+ *       try {
+ *         await db.insertOrder(JSON.parse(new TextDecoder().decode(m.payload)));
+ *         this.js.tell({ kind: 'ack', streamSeq: m.streamSeq });
+ *       } catch (e) {
+ *         this.js.tell({ kind: 'nak', streamSeq: m.streamSeq, delayMs: 5_000 });
+ *       }
+ *     }
+ *   }
+ */
+/** Inbound JetStream message handed to subscribers. */
+export interface JetStreamMessage {
+    readonly subject: string;
+    readonly payload: Uint8Array;
+    /** Reply subject (for request/reply patterns); empty when not set. */
+    readonly replyTo: string;
+    /** Stream sequence — unique within the stream, monotonic per stream. */
+    readonly streamSeq: number;
+    /** Consumer delivery sequence — bumps on every (re-)delivery. */
+    readonly consumerSeq: number;
+    /** Number of times this message has been delivered (1 = first try). */
+    readonly deliveries: number;
+    /** Server-assigned timestamp in ms since epoch. */
+    readonly timestamp: number;
+    /** Optional per-message headers (e.g. `Nats-Msg-Id`). */
+    readonly headers: Readonly<Record<string, string>>;
+}
+/** Outbound JetStream publish — payload + optional dedupe headers. */
+export interface JetStreamPublish {
+    readonly subject: string;
+    readonly payload: Uint8Array | string;
+    /**
+     * Optional dedupe id — sent as `Nats-Msg-Id` header so a re-publish
+     * within the stream's deduplication window is idempotent.
+     */
+    readonly messageId?: string;
+    /**
+     * Optional expected last sequence — server rejects the publish if
+     * the stream's last seq doesn't match (optimistic concurrency).
+     */
+    readonly expectedLastSeq?: number;
+    /** Extra headers (free-form). */
+    readonly headers?: Readonly<Record<string, string>>;
+}
+/** Stream lifecycle policy at connect time. */
+export interface JetStreamStreamConfig {
+    readonly name: string;
+    readonly subjects: ReadonlyArray<string>;
+    readonly retention?: 'limits' | 'interest' | 'workqueue';
+    readonly storage?: 'memory' | 'file';
+    readonly maxMsgs?: number;
+    readonly maxBytes?: number;
+    readonly maxAge?: number;
+    /** Auto-create or update at connect time.  Default true. */
+    readonly create?: boolean;
+}
+/** Push or pull consumer config (#62). */
+export interface JetStreamConsumerConfig {
+    /** Durable name — required so the consumer survives restarts. */
+    readonly durable: string;
+    /**
+     * Consumer mode (#62).  `'push'` *(default)* — server pushes
+     * messages; the actor's internal pump iterates the subscription
+     * and waits per-message for ack/nak/term.  `'pull'` — caller
+     * drives fetches with `{ kind: 'fetch', batch, expiresMs }`
+     * commands; messages within a fetch still go through the same
+     * ack handshake.  Pull mode lets the application self-pace,
+     * which fits slow/bursty consumers better than push fan-out.
+     */
+    readonly mode?: 'push' | 'pull';
+    /** Where in the stream to start the new consumer.  Default `'all'`. */
+    readonly deliverPolicy?: 'all' | 'last' | 'new' | {
+        readonly kind: 'byStartSeq';
+        readonly startSeq: number;
+    } | {
+        readonly kind: 'byStartTime';
+        readonly startTimeMs: number;
+    };
+    /** `'explicit'` (default — ack/nak/term required), `'none'`, or `'all'`. */
+    readonly ackPolicy?: 'explicit' | 'none' | 'all';
+    /** Max time before the consumer redelivers without an ack.  Default 30s. */
+    readonly ackWaitMs?: number;
+    /** Subject filter — defaults to all subjects in the stream. */
+    readonly filterSubject?: string;
+    /** Max in-flight unacked messages.  Default 1024 (server default). */
+    readonly maxAckPending?: number;
+    /** Auto-create or update at connect time.  Default true. */
+    readonly create?: boolean;
+}
+export interface JetStreamActorSettings extends BrokerCommonSettings {
+    /** NATS server URLs. */
+    readonly servers?: ReadonlyArray<string> | string;
+    /** Optional credentials. */
+    readonly token?: string;
+    readonly user?: string;
+    readonly password?: string;
+    /** Optional client name. */
+    readonly name?: string;
+    /** Stream lifecycle config — set when this actor owns the stream. */
+    readonly stream?: JetStreamStreamConfig;
+    /** Consumer config — required to start a subscription. */
+    readonly consumer?: JetStreamConsumerConfig;
+    /** Actor receiving every consumed message. */
+    readonly target?: ActorRef<JetStreamMessage>;
+    /**
+     * Max time the manual-ack pump waits for a `ack`/`nak`/`term`
+     * before giving up on a message and rejecting internally
+     * (kafkajs-style failure).  Default = `consumer.ackWaitMs ?? 30s`.
+     */
+    readonly ackTimeoutMs?: number;
+}
+export type JetStreamCmd = {
+    readonly kind: 'publish';
+    readonly publish: JetStreamPublish;
+}
+/** Acknowledge a delivered message — server marks consumed. */
+ | {
+    readonly kind: 'ack';
+    readonly streamSeq: number;
+}
+/** Negative-ack — server redelivers (after optional `delayMs`). */
+ | {
+    readonly kind: 'nak';
+    readonly streamSeq: number;
+    readonly delayMs?: number;
+}
+/** Terminal failure — server drops the message permanently. */
+ | {
+    readonly kind: 'term';
+    readonly streamSeq: number;
+    readonly reason?: string;
+}
+/** Heartbeat — extend the ack-wait window for a long-running handler. */
+ | {
+    readonly kind: 'inProgress';
+    readonly streamSeq: number;
+}
+/**
+ * Pull-mode (#62) — fetch up to `batch` messages, returning early
+ * after `expiresMs` (default 5 s) if fewer are available.  Each
+ * fetched message still goes through the same ack/nak/term
+ * handshake as push-mode.  Sending `fetch` to a push-mode
+ * consumer is a silent no-op with a warn log.
+ */
+ | {
+    readonly kind: 'fetch';
+    readonly batch: number;
+    readonly expiresMs?: number;
+};
+export declare class JetStreamActor extends BrokerActor<JetStreamActorSettings, JetStreamCmd, JetStreamPublish> {
+    private nc;
+    private js;
+    private subscription;
+    /** Pull-consumer handle (#62).  Non-null when consumer.mode === 'pull'. */
+    private pullConsumer;
+    /** Map of streamSeq → in-flight ack handle for the manual-ack pump. */
+    private readonly pending;
+    constructor(settings?: Partial<JetStreamActorSettings>);
+    protected configKey(): string;
+    protected builtInDefaults(): Partial<JetStreamActorSettings>;
+    protected readSettingsFromConfig(c: Config): Partial<JetStreamActorSettings>;
+    protected requiredSettings(): ReadonlyArray<keyof JetStreamActorSettings>;
+    protected endpointLabel(): string;
+    /**
+     * Build a `NatsConnectionLike`.  Override in a test subclass to
+     * inject a mock connection (the `nats` peer-dep is heavy and not
+     * necessary for unit tests).
+     */
+    protected createNatsConnection(): Promise<NatsConnectionLike>;
+    protected connectImpl(): Promise<void>;
+    protected disconnectImpl(): Promise<void>;
+    protected dispatchOutgoing(env: OutboundEnvelope<JetStreamPublish>): Promise<void>;
+    onReceive(cmd: JetStreamCmd): void;
+    private runPump;
+    /**
+     * Pull-mode fetch (#62) — request up to `batch` messages, fan them
+     * to `target`, and wait per-message for ack/nak/term using the same
+     * `deliverAndAwaitAck` helper as the push pump.  Returns once every
+     * message in the batch has been acked or its ack-timeout has
+     * fired; subsequent `fetch` cmds are processed serially by the
+     * mailbox.
+     */
+    private handleFetch;
+    /**
+     * Shared per-message delivery path used by both the push pump and
+     * `handleFetch`.  Tells the message to `target`, then awaits an
+     * external ack / nak / term (unless `ackPolicy === 'none'`).
+     */
+    private deliverAndAwaitAck;
+    private handleAck;
+    private handleNak;
+    private handleTerm;
+    private handleInProgress;
+}
+/**
+ * Minimal `NatsConnection` surface the actor depends on.  Exported so
+ * test seams (subclasses of `JetStreamActor` overriding
+ * `createNatsConnection`) can satisfy the same shape without pulling
+ * the real `nats` peer-dep.
+ */
+export interface NatsConnectionLike {
+    jetstream(): JetStreamClientLike;
+    jetstreamManager(): Promise<JetStreamManagerLike>;
+    drain(): Promise<void>;
+    closed(): Promise<Error | undefined>;
+}
+export interface JetStreamClientLike {
+    publish(subject: string, payload: Uint8Array, opts?: {
+        msgID?: string;
+        expect?: {
+            lastSequence?: number;
+        };
+        headers?: Readonly<Record<string, string>>;
+    }): Promise<unknown>;
+    subscribe(subject: string, opts: {
+        stream: string;
+        consumer: string;
+    }): Promise<JetStreamSubscriptionLike>;
+    /**
+     * Pull-consumer accessor (#62).  Returns a handle that exposes
+     * `fetch` for batched on-demand delivery — see the nats.js
+     * `consumers.get(stream, durable)` API.
+     */
+    readonly consumers: {
+        get(stream: string, durable: string): Promise<PullConsumerLike>;
+    };
+}
+export interface JetStreamSubscriptionLike extends AsyncIterable<JetStreamMsgHandleLike> {
+    destroy(): Promise<void>;
+}
+/**
+ * Pull-consumer handle returned by `JetStreamClient.consumers.get`.
+ * `fetch` returns an async iterable that yields up to `max_messages`
+ * messages before resolving (the iterator completes after `expires`
+ * ms even if the batch isn't full).  Per-message ack semantics are
+ * identical to push-mode.
+ */
+export interface PullConsumerLike {
+    fetch(opts: {
+        max_messages: number;
+        expires: number;
+    }): Promise<AsyncIterable<JetStreamMsgHandleLike>>;
+}
+interface HeadersLike {
+    keys(): Iterable<string>;
+    get(key: string): string | null;
+}
+export interface JetStreamMsgInfoLike {
+    readonly streamSequence: number;
+    readonly deliverySequence: number;
+    readonly deliveryCount: number;
+    readonly timestampNanos?: number;
+}
+export interface JetStreamMsgHandleLike {
+    readonly subject: string;
+    readonly data: Uint8Array;
+    readonly reply?: string;
+    readonly headers?: HeadersLike;
+    readonly info: JetStreamMsgInfoLike;
+    ack(): void;
+    nak(delayMs?: number): void;
+    term(): void;
+    working(): void;
+}
+interface ConsumerAddConfig {
+    durable_name: string;
+    ack_policy?: 'explicit' | 'none' | 'all';
+    ack_wait?: number;
+    filter_subject?: string;
+    max_ack_pending?: number;
+    deliver_policy?: 'all' | 'last' | 'new' | 'by_start_sequence' | 'by_start_time';
+    opt_start_seq?: number;
+    opt_start_time?: string;
+}
+export interface JetStreamManagerLike {
+    readonly streams: {
+        add(cfg: {
+            name: string;
+            subjects: string[];
+            retention?: string;
+            storage?: string;
+            max_msgs?: number;
+            max_bytes?: number;
+            max_age?: number;
+        }): Promise<unknown>;
+        update(name: string, cfg: {
+            subjects: string[];
+            retention?: string;
+            storage?: string;
+            max_msgs?: number;
+            max_bytes?: number;
+            max_age?: number;
+        }): Promise<unknown>;
+    };
+    readonly consumers: {
+        add(stream: string, cfg: ConsumerAddConfig): Promise<unknown>;
+        update(stream: string, durable: string, cfg: ConsumerAddConfig): Promise<unknown>;
+    };
+}
+export {};
+//# sourceMappingURL=JetStreamActor.d.ts.map

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

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