actor-ts 0.9.0

package/dist/io/broker/JetStreamActor.js

@@ -0,0 +1,378 @@
+import { match } from 'ts-pattern';
+import { ConfigKeys } from '../../config/ConfigKeys.js';
+import { Lazy } from '../../util/Lazy.js';
+import { lazyImportModule } from '../../util/LazyImport.js';
+import { BrokerActor } from './BrokerActor.js';
+export class JetStreamActor extends BrokerActor {
+    nc = null;
+    js = null;
+    subscription = null;
+    /** Pull-consumer handle (#62).  Non-null when consumer.mode === 'pull'. */
+    pullConsumer = null;
+    /** Map of streamSeq → in-flight ack handle for the manual-ack pump. */
+    pending = new Map();
+    constructor(settings = {}) { super(settings); }
+    configKey() { return ConfigKeys.io.broker.jetstream; }
+    builtInDefaults() { return {}; }
+    readSettingsFromConfig(c) {
+        const out = {};
+        if (c.hasPath('servers'))
+            out.servers = c.getStringList('servers');
+        if (c.hasPath('token'))
+            out.token = c.getString('token');
+        if (c.hasPath('user'))
+            out.user = c.getString('user');
+        if (c.hasPath('password'))
+            out.password = c.getString('password');
+        if (c.hasPath('name'))
+            out.name = c.getString('name');
+        return out;
+    }
+    requiredSettings() { return ['servers']; }
+    endpointLabel() {
+        const s = this.settings.servers;
+        if (Array.isArray(s))
+            return `nats://${s.join(',')}`;
+        return `nats://${typeof s === 'string' ? s : ''}`;
+    }
+    /**
+     * 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).
+     */
+    async createNatsConnection() {
+        const nats = await natsLazy.get();
+        const servers = Array.isArray(this.settings.servers)
+            ? [...this.settings.servers]
+            : [this.settings.servers];
+        return nats.connect({
+            servers,
+            token: this.settings.token,
+            user: this.settings.user,
+            pass: this.settings.password,
+            name: this.settings.name,
+        });
+    }
+    async connectImpl() {
+        this.nc = await this.createNatsConnection();
+        this.js = this.nc.jetstream();
+        // Stream lifecycle: create-or-update if asked.
+        if (this.settings.stream && (this.settings.stream.create ?? true)) {
+            const jsm = await this.nc.jetstreamManager();
+            await upsertStream(jsm, this.settings.stream);
+        }
+        // Consumer + subscription (push) or pull handle.
+        if (this.settings.consumer) {
+            if (this.settings.consumer.create ?? true) {
+                if (!this.settings.stream?.name) {
+                    throw new Error('JetStreamActor: consumer.create requires stream.name');
+                }
+                const jsm = await this.nc.jetstreamManager();
+                await upsertConsumer(jsm, this.settings.stream.name, this.settings.consumer);
+            }
+            if (!this.settings.stream?.name) {
+                throw new Error('JetStreamActor: consumer requires stream.name');
+            }
+            const mode = this.settings.consumer.mode ?? 'push';
+            if (mode === 'push') {
+                this.subscription = await this.js.subscribe(this.settings.consumer.filterSubject ?? `${this.settings.stream.name}.>`, {
+                    stream: this.settings.stream.name,
+                    consumer: this.settings.consumer.durable,
+                });
+                void this.runPump();
+            }
+            else {
+                // Pull mode (#62) — grab the consumer handle but DON'T start
+                // a pump.  Messages flow only when the caller sends `fetch`.
+                this.pullConsumer = await this.js.consumers.get(this.settings.stream.name, this.settings.consumer.durable);
+            }
+        }
+        void this.nc.closed().then((err) => {
+            this.handleConnectionLost(err ?? new Error('nats connection closed'));
+        });
+    }
+    async disconnectImpl() {
+        // Reject every still-pending ack so the consumer pump unwinds.
+        if (this.pending.size > 0) {
+            for (const p of this.pending.values()) {
+                try {
+                    p.handle.nak();
+                }
+                catch { /* best-effort */ }
+            }
+            this.pending.clear();
+        }
+        if (this.subscription) {
+            try {
+                await this.subscription.destroy();
+            }
+            catch { /* */ }
+            this.subscription = null;
+        }
+        // Pull consumer doesn't own a long-lived subscription — drop the
+        // reference and the underlying nats client cleans up on drain.
+        this.pullConsumer = null;
+        if (this.nc) {
+            try {
+                await this.nc.drain();
+            }
+            catch { /* */ }
+            this.nc = null;
+        }
+        this.js = null;
+    }
+    async dispatchOutgoing(env) {
+        if (!this.js)
+            throw new Error('JetStreamActor: not connected');
+        const p = env.payload;
+        const bytes = typeof p.payload === 'string'
+            ? new TextEncoder().encode(p.payload)
+            : p.payload;
+        await this.js.publish(p.subject, bytes, {
+            msgID: p.messageId,
+            expect: p.expectedLastSeq !== undefined
+                ? { lastSequence: p.expectedLastSeq }
+                : undefined,
+            headers: p.headers,
+        });
+    }
+    onReceive(cmd) {
+        // Compile-time exhaustiveness: adding a new JetStreamCmd variant
+        // forces this site to handle it explicitly (TS error otherwise).
+        match(cmd)
+            .with({ kind: 'publish' }, (c) => { this.enqueueOutbound(c.publish); })
+            .with({ kind: 'ack' }, (c) => this.handleAck(c.streamSeq))
+            .with({ kind: 'nak' }, (c) => this.handleNak(c.streamSeq, c.delayMs))
+            .with({ kind: 'term' }, (c) => this.handleTerm(c.streamSeq, c.reason))
+            .with({ kind: 'inProgress' }, (c) => this.handleInProgress(c.streamSeq))
+            .with({ kind: 'fetch' }, (c) => { void this.handleFetch(c.batch, c.expiresMs); })
+            .exhaustive();
+    }
+    /* ----------------------------- internals ----------------------------- */
+    async runPump() {
+        if (!this.subscription)
+            return;
+        for await (const m of this.subscription) {
+            await this.deliverAndAwaitAck(m);
+        }
+    }
+    /**
+     * 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.
+     */
+    async handleFetch(batch, expiresMs) {
+        if (!this.pullConsumer) {
+            this.log.warn('JetStreamActor: fetch on push-mode (or disconnected) consumer — ignored');
+            return;
+        }
+        if (!Number.isInteger(batch) || batch <= 0) {
+            this.log.warn(`JetStreamActor: fetch batch must be a positive integer, got ${batch} — ignored`);
+            return;
+        }
+        let messages;
+        try {
+            messages = await this.pullConsumer.fetch({
+                max_messages: batch,
+                expires: expiresMs ?? 5_000,
+            });
+        }
+        catch (err) {
+            this.log.warn(`JetStreamActor: fetch failed: ${err.message}`);
+            return;
+        }
+        // Drain the fetch result.  The iterator completes either when the
+        // batch is full or when `expires` ms elapses — empty-batch is
+        // therefore a normal end condition, NOT an error.
+        const handles = [];
+        for await (const m of messages)
+            handles.push(m);
+        // Deliver everything to target first (typical pull-consumer
+        // semantics: the application sees the whole batch at once), then
+        // wait in parallel for the per-message acks.  Serial-await within
+        // a batch would deadlock if the target processes them out of
+        // order, which is the natural actor pattern.
+        await Promise.all(handles.map((h) => this.deliverAndAwaitAck(h)));
+    }
+    /**
+     * 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'`).
+     */
+    async deliverAndAwaitAck(m) {
+        const target = this.settings.target;
+        const ackTimeoutMs = this.settings.ackTimeoutMs
+            ?? this.settings.consumer?.ackWaitMs
+            ?? 30_000;
+        const handle = m;
+        const info = handle.info;
+        if (target) {
+            target.tell({
+                subject: handle.subject,
+                payload: handle.data,
+                replyTo: handle.reply ?? '',
+                streamSeq: info.streamSequence,
+                consumerSeq: info.deliverySequence,
+                deliveries: info.deliveryCount,
+                timestamp: info.timestampNanos !== undefined
+                    ? Math.floor(info.timestampNanos / 1_000_000)
+                    : Date.now(),
+                headers: extractHeaders(handle.headers),
+            });
+        }
+        if (this.settings.consumer?.ackPolicy === 'none')
+            return;
+        const seq = info.streamSequence;
+        try {
+            await new Promise((resolve, reject) => {
+                const timer = setTimeout(() => {
+                    this.pending.delete(seq);
+                    reject(new Error(`JetStreamActor: no ack/nak/term for streamSeq=${seq} within ${ackTimeoutMs}ms`));
+                }, ackTimeoutMs);
+                this.pending.set(seq, {
+                    streamSeq: seq,
+                    handle,
+                    done: () => { clearTimeout(timer); resolve(); },
+                    fail: (err) => { clearTimeout(timer); reject(err); },
+                });
+            });
+        }
+        catch (err) {
+            this.log.warn(`JetStreamActor: pump ${err.message} — letting consumer redeliver`);
+            try {
+                handle.nak();
+            }
+            catch { /* best-effort */ }
+        }
+    }
+    handleAck(streamSeq) {
+        const p = this.pending.get(streamSeq);
+        if (!p) {
+            this.log.debug(`JetStreamActor: ack for unknown streamSeq=${streamSeq} — ignored`);
+            return;
+        }
+        try {
+            p.handle.ack();
+        }
+        catch (err) {
+            p.fail(err instanceof Error ? err : new Error(String(err)));
+            this.pending.delete(streamSeq);
+            return;
+        }
+        p.done();
+        this.pending.delete(streamSeq);
+    }
+    handleNak(streamSeq, delayMs) {
+        const p = this.pending.get(streamSeq);
+        if (!p)
+            return;
+        try {
+            if (typeof delayMs === 'number' && delayMs > 0) {
+                p.handle.nak(delayMs);
+            }
+            else {
+                p.handle.nak();
+            }
+        }
+        catch { /* best-effort — nakWithDelay may be missing on older clients */ }
+        p.done();
+        this.pending.delete(streamSeq);
+    }
+    handleTerm(streamSeq, reason) {
+        const p = this.pending.get(streamSeq);
+        if (!p)
+            return;
+        this.log.warn(`JetStreamActor: term for streamSeq=${streamSeq}${reason ? ` (${reason})` : ''} — `
+            + `message dropped permanently`);
+        try {
+            p.handle.term();
+        }
+        catch { /* */ }
+        p.done();
+        this.pending.delete(streamSeq);
+    }
+    handleInProgress(streamSeq) {
+        const p = this.pending.get(streamSeq);
+        if (!p)
+            return;
+        try {
+            p.handle.working();
+        }
+        catch { /* */ }
+    }
+}
+async function upsertStream(jsm, cfg) {
+    try {
+        await jsm.streams.add({
+            name: cfg.name,
+            subjects: [...cfg.subjects],
+            retention: cfg.retention,
+            storage: cfg.storage,
+            max_msgs: cfg.maxMsgs,
+            max_bytes: cfg.maxBytes,
+            max_age: cfg.maxAge,
+        });
+    }
+    catch (e) {
+        // If the stream exists, update it; the nats client raises a
+        // 10058 ("stream name in use") error code we treat as benign.
+        const msg = e instanceof Error ? e.message : String(e);
+        if (!/in use|already exists|10058/i.test(msg))
+            throw e;
+        await jsm.streams.update(cfg.name, {
+            subjects: [...cfg.subjects],
+            retention: cfg.retention,
+            storage: cfg.storage,
+            max_msgs: cfg.maxMsgs,
+            max_bytes: cfg.maxBytes,
+            max_age: cfg.maxAge,
+        });
+    }
+}
+async function upsertConsumer(jsm, streamName, cfg) {
+    const ackWaitNs = (cfg.ackWaitMs ?? 30_000) * 1_000_000;
+    const consumerCfg = {
+        durable_name: cfg.durable,
+        ack_policy: cfg.ackPolicy ?? 'explicit',
+        ack_wait: ackWaitNs,
+        filter_subject: cfg.filterSubject,
+        max_ack_pending: cfg.maxAckPending,
+        deliver_policy: 'all',
+    };
+    if (cfg.deliverPolicy === 'last')
+        consumerCfg.deliver_policy = 'last';
+    else if (cfg.deliverPolicy === 'new')
+        consumerCfg.deliver_policy = 'new';
+    else if (typeof cfg.deliverPolicy === 'object' && 'kind' in cfg.deliverPolicy) {
+        if (cfg.deliverPolicy.kind === 'byStartSeq') {
+            consumerCfg.deliver_policy = 'by_start_sequence';
+            consumerCfg.opt_start_seq = cfg.deliverPolicy.startSeq;
+        }
+        else if (cfg.deliverPolicy.kind === 'byStartTime') {
+            consumerCfg.deliver_policy = 'by_start_time';
+            consumerCfg.opt_start_time = new Date(cfg.deliverPolicy.startTimeMs).toISOString();
+        }
+    }
+    try {
+        await jsm.consumers.add(streamName, consumerCfg);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        if (!/already exists|in use|10148/i.test(msg))
+            throw e;
+        await jsm.consumers.update(streamName, cfg.durable, consumerCfg);
+    }
+}
+function extractHeaders(h) {
+    if (!h)
+        return {};
+    const out = {};
+    for (const k of h.keys())
+        out[k] = h.get(k) ?? '';
+    return out;
+}
+const natsLazy = Lazy.of(() => lazyImportModule('nats', { context: 'JetStreamActor' }));
+//# sourceMappingURL=JetStreamActor.js.map

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

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