actor-ts 0.9.0

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

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

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

@@ -0,0 +1,149 @@
+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';
+/** MQTT QoS levels.  0 = at-most-once, 1 = at-least-once, 2 = exactly-once. */
+export type MqttQos = 0 | 1 | 2;
+export interface MqttSubscription {
+    readonly topic: string;
+    readonly qos?: MqttQos;
+    readonly target: ActorRef<MqttMessage>;
+}
+/**
+ * Multi-valued user-property bag carried alongside an MQTT 5.0
+ * message.  Same shape as the underlying mqtt-packet's
+ * `properties.userProperties` field — a single key may map to one
+ * value or an array of values (the protocol allows duplicates).
+ * Absent when the broker / client is on MQTT 3.1.1.
+ */
+export type MqttUserProperties = Record<string, string | string[]>;
+/** Inbound MQTT message handed to subscribers. */
+export interface MqttMessage {
+    readonly topic: string;
+    readonly payload: Uint8Array;
+    readonly qos: MqttQos;
+    readonly retain: boolean;
+    /**
+     * MQTT 5.0 user properties on the inbound packet, if any.  Always
+     * `undefined` for MQTT 3.1.1 traffic — the protocol doesn't carry
+     * them.  See {@link MqttActorSettings.protocolVersion}.
+     */
+    readonly userProperties?: MqttUserProperties;
+    /**
+     * MQTT 5.0 PUBACK / PUBREC reason code attached to the message,
+     * if the broker emitted one.  `undefined` for MQTT 3.1.1 or for
+     * unprompted publishes.  See the MQTT 5.0 spec § 2.4 "Reason Code"
+     * for the value space.
+     */
+    readonly reasonCode?: number;
+}
+/** Outbound publish envelope. */
+export interface MqttPublish {
+    readonly topic: string;
+    readonly payload: Uint8Array | string;
+    readonly qos?: MqttQos;
+    readonly retain?: boolean;
+    /**
+     * MQTT 5.0 user properties to attach to the PUBLISH packet.
+     * Silently dropped when the actor's `protocolVersion` is 4 — the
+     * 3.1.1 wire format has no way to carry them.
+     */
+    readonly userProperties?: MqttUserProperties;
+}
+export interface MqttCredentials {
+    readonly username?: string;
+    readonly password?: string;
+}
+export interface MqttActorSettings extends BrokerCommonSettings {
+    /** Broker URL — `mqtt://`, `mqtts://`, `ws://`, `wss://`. */
+    readonly brokerUrl?: string;
+    /** Stable client id.  When omitted the broker assigns one. */
+    readonly clientId?: string;
+    readonly credentials?: MqttCredentials;
+    /** Default QoS used by `publish` / `subscribe` when not overridden per call. */
+    readonly defaultQos?: MqttQos;
+    /** Initial subscriptions wired up immediately after connect. */
+    readonly subscriptions?: ReadonlyArray<MqttSubscription>;
+    /** Last-will-and-testament published by the broker if the actor disconnects ungracefully. */
+    readonly will?: {
+        readonly topic: string;
+        readonly payload: Uint8Array | string;
+        readonly qos?: MqttQos;
+        readonly retain?: boolean;
+    };
+    /** Clean-session flag.  Default `true`. */
+    readonly cleanSession?: boolean;
+    /** Keep-alive interval in seconds.  Default 60. */
+    readonly keepAliveSec?: number;
+    /**
+     * MQTT protocol version negotiated with the broker.  Default `4`
+     * (MQTT 3.1.1) for back-compat with every existing config; set to
+     * `5` to opt in to MQTT 5.0 features (user properties + reason
+     * codes — see {@link MqttPublish.userProperties} +
+     * {@link MqttMessage.reasonCode}).  The peer-dep `mqtt` handles
+     * the wire negotiation; we only flip the flag.
+     */
+    readonly protocolVersion?: 4 | 5;
+}
+export type MqttCmd = {
+    readonly kind: 'publish';
+    readonly publish: MqttPublish;
+} | {
+    readonly kind: 'subscribe';
+    readonly topic: string;
+    readonly target: ActorRef<MqttMessage>;
+    readonly qos?: MqttQos;
+} | {
+    readonly kind: 'unsubscribe';
+    readonly topic: string;
+    readonly target?: ActorRef<MqttMessage>;
+};
+/**
+ * MQTT 3.1.1 / 5.0 actor backed by the `mqtt` peer-dep.  Inbound
+ * messages are routed to subscribers via the base class' fan-out;
+ * wildcard subscriptions (`+`, `#`) are honoured on the broker side
+ * and locally we deliver based on the *concrete* topic the message
+ * was received on (matching Paho/mqtt.js semantics).
+ *
+ * The `subscriptions` setting wires up topic→actor mappings at
+ * connect-time; runtime `tell({ kind: 'subscribe', ... })` adds more.
+ */
+export declare class MqttActor extends BrokerActor<MqttActorSettings, MqttCmd, MqttPublish> {
+    private client;
+    /**
+     * topic-pattern → subscribers.  Patterns can be wildcard (`a/+/c`,
+     * `a/#`).  We test inbound topics against every pattern at delivery
+     * time — O(n) but n is small in practice (sub-100 patterns).
+     */
+    private readonly patternSubs;
+    constructor(settings?: Partial<MqttActorSettings>);
+    protected configKey(): string;
+    protected builtInDefaults(): Partial<MqttActorSettings>;
+    protected readSettingsFromConfig(c: Config): Partial<MqttActorSettings>;
+    protected requiredSettings(): ReadonlyArray<keyof MqttActorSettings>;
+    protected endpointLabel(): string;
+    protected connectImpl(): Promise<void>;
+    protected disconnectImpl(): Promise<void>;
+    protected dispatchOutgoing(env: OutboundEnvelope<MqttPublish>): Promise<void>;
+    onReceive(cmd: MqttCmd): void;
+    private patternSubscribe;
+    private patternUnsubscribe;
+    private dispatchInbound;
+}
+/**
+ * Build the mqtt-packet `properties` object for an outbound publish,
+ * or `undefined` if there's nothing v5-specific to attach.  Pure
+ * function — testable without a real broker or mqtt.js install
+ * (see `tests/unit/io/broker/MqttActor.test.ts`).
+ *
+ * `protocolVersion < 5` always returns undefined: the 3.1.1 wire
+ * format has no slot for user properties, so we drop them rather
+ * than letting them leak into the publish callsite and confuse
+ * downstream tooling.
+ */
+export declare function buildPublishProperties(p: MqttPublish, protocolVersion: 4 | 5): {
+    userProperties?: MqttUserProperties;
+} | undefined;
+/** Standard MQTT pattern match: `+` matches one segment, `#` matches the rest. */
+export declare function matchesMqttPattern(pattern: string, topic: string): boolean;
+//# sourceMappingURL=MqttActor.d.ts.map

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

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

package/dist/io/broker/MqttActor.js

@@ -0,0 +1,255 @@
+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';
+/**
+ * MQTT 3.1.1 / 5.0 actor backed by the `mqtt` peer-dep.  Inbound
+ * messages are routed to subscribers via the base class' fan-out;
+ * wildcard subscriptions (`+`, `#`) are honoured on the broker side
+ * and locally we deliver based on the *concrete* topic the message
+ * was received on (matching Paho/mqtt.js semantics).
+ *
+ * The `subscriptions` setting wires up topic→actor mappings at
+ * connect-time; runtime `tell({ kind: 'subscribe', ... })` adds more.
+ */
+export class MqttActor extends BrokerActor {
+    client = null;
+    /**
+     * topic-pattern → subscribers.  Patterns can be wildcard (`a/+/c`,
+     * `a/#`).  We test inbound topics against every pattern at delivery
+     * time — O(n) but n is small in practice (sub-100 patterns).
+     */
+    patternSubs = new Map();
+    constructor(settings = {}) { super(settings); }
+    configKey() { return ConfigKeys.io.broker.mqtt; }
+    builtInDefaults() {
+        return { defaultQos: 0, cleanSession: true, keepAliveSec: 60 };
+    }
+    readSettingsFromConfig(c) {
+        const out = {};
+        if (c.hasPath('brokerUrl'))
+            out.brokerUrl = c.getString('brokerUrl');
+        if (c.hasPath('clientId'))
+            out.clientId = c.getString('clientId');
+        if (c.hasPath('credentials')) {
+            const cc = c.getConfig('credentials');
+            out.credentials = {
+                username: cc.hasPath('username') ? cc.getString('username') : undefined,
+                password: cc.hasPath('password') ? cc.getString('password') : undefined,
+            };
+        }
+        if (c.hasPath('defaultQos'))
+            out.defaultQos = c.getInt('defaultQos');
+        if (c.hasPath('cleanSession'))
+            out.cleanSession = c.getBoolean('cleanSession');
+        if (c.hasPath('keepAliveSec'))
+            out.keepAliveSec = c.getInt('keepAliveSec');
+        if (c.hasPath('protocolVersion')) {
+            const v = c.getInt('protocolVersion');
+            if (v !== 4 && v !== 5) {
+                throw new Error(`MqttActor: protocolVersion must be 4 or 5, got ${v}`);
+            }
+            out.protocolVersion = v;
+        }
+        return out;
+    }
+    requiredSettings() { return ['brokerUrl']; }
+    endpointLabel() { return this.settings.brokerUrl ?? '<unknown>'; }
+    async connectImpl() {
+        const mqtt = await mqttLazy.get();
+        const opts = {
+            clientId: this.settings.clientId,
+            username: this.settings.credentials?.username,
+            password: this.settings.credentials?.password,
+            clean: this.settings.cleanSession,
+            keepalive: this.settings.keepAliveSec,
+            protocolVersion: this.settings.protocolVersion ?? 4,
+        };
+        if (this.settings.will) {
+            opts.will = {
+                topic: this.settings.will.topic,
+                payload: this.settings.will.payload,
+                qos: this.settings.will.qos ?? 0,
+                retain: this.settings.will.retain ?? false,
+            };
+        }
+        return new Promise((resolve, reject) => {
+            const client = mqtt.connect(this.settings.brokerUrl, opts);
+            let done = false;
+            client.once('connect', () => {
+                if (done)
+                    return;
+                done = true;
+                client.removeAllListeners('error');
+                this.client = client;
+                client.on('message', (topic, payload, packet) => {
+                    // MQTT 5.0 v5 properties live under `packet.properties` per
+                    // mqtt-packet's shape; absent on 3.1.1.  We pass them
+                    // through verbatim so subscribers that care can read user-
+                    // properties / reasonCode straight off the inbound
+                    // message, and those that don't are unaffected.
+                    this.dispatchInbound({
+                        topic, payload,
+                        qos: (packet?.qos ?? 0),
+                        retain: packet?.retain ?? false,
+                        userProperties: packet?.properties?.userProperties,
+                        reasonCode: packet?.properties?.reasonCode,
+                    });
+                });
+                client.on('error', (e) => this.handleConnectionLost(e));
+                client.on('close', () => this.handleConnectionLost(new Error('mqtt connection closed')));
+                // Wire up initial subscriptions (and re-subscribe after reconnect).
+                for (const sub of this.settings.subscriptions ?? []) {
+                    this.patternSubscribe(sub.topic, sub.target);
+                    client.subscribe(sub.topic, { qos: sub.qos ?? this.settings.defaultQos ?? 0 }, (err) => {
+                        if (err)
+                            this.log.warn(`MqttActor: initial subscribe to '${sub.topic}' failed: ${err.message}`);
+                    });
+                }
+                resolve();
+            });
+            client.once('error', (e) => {
+                if (done)
+                    return;
+                done = true;
+                try {
+                    client.end(true);
+                }
+                catch { /* ignore */ }
+                reject(e);
+            });
+        });
+    }
+    async disconnectImpl() {
+        if (!this.client)
+            return;
+        const c = this.client;
+        this.client = null;
+        return new Promise((resolve) => {
+            c.removeAllListeners();
+            c.end(false, {}, () => resolve());
+            setTimeout(resolve, 1_000);
+        });
+    }
+    async dispatchOutgoing(env) {
+        if (!this.client)
+            throw new Error('MqttActor: not connected');
+        const p = env.payload;
+        const qos = p.qos ?? this.settings.defaultQos ?? 0;
+        const retain = p.retain ?? false;
+        const protocolVersion = this.settings.protocolVersion ?? 4;
+        const opts = { qos, retain };
+        // User properties only carry on MQTT 5.0 — silently drop them
+        // on 3.1.1 (the wire format has no slot for them).  Same
+        // pattern mqtt.js follows when the option mismatches the
+        // negotiated protocol version.
+        const properties = buildPublishProperties(p, protocolVersion);
+        if (properties)
+            opts.properties = properties;
+        return new Promise((resolve, reject) => {
+            this.client.publish(p.topic, p.payload, opts, (err) => {
+                err ? reject(err) : resolve();
+            });
+        });
+    }
+    onReceive(cmd) {
+        // Compile-time exhaustiveness: adding a new MqttCmd variant
+        // forces this site to handle it explicitly.
+        match(cmd)
+            .with({ kind: 'publish' }, (c) => {
+            this.enqueueOutbound(c.publish);
+        })
+            .with({ kind: 'subscribe' }, (c) => {
+            this.patternSubscribe(c.topic, c.target);
+            // If already connected, register on the broker too.  Reconnect
+            // re-runs the initial subscriptions; runtime additions persist
+            // only via the local pattern map — we don't try to "remember"
+            // them across reconnect (caller can re-tell after `BrokerConnected`).
+            if (this.connectionState === 'connected' && this.client) {
+                this.client.subscribe(c.topic, { qos: c.qos ?? this.settings.defaultQos ?? 0 }, (err) => { if (err)
+                    this.log.warn(`MqttActor: subscribe '${c.topic}' failed: ${err.message}`); });
+            }
+        })
+            .with({ kind: 'unsubscribe' }, (c) => {
+            if (c.target)
+                this.patternUnsubscribe(c.topic, c.target);
+            else
+                this.patternSubs.delete(c.topic);
+            if (this.connectionState === 'connected' && this.client) {
+                this.client.unsubscribe(c.topic, undefined, (err) => {
+                    if (err)
+                        this.log.warn(`MqttActor: unsubscribe '${c.topic}' failed: ${err.message}`);
+                });
+            }
+        })
+            .exhaustive();
+    }
+    /* ----------------------------- internals ------------------------------ */
+    patternSubscribe(pattern, ref) {
+        let set = this.patternSubs.get(pattern);
+        if (!set) {
+            set = new Set();
+            this.patternSubs.set(pattern, set);
+        }
+        set.add(ref);
+    }
+    patternUnsubscribe(pattern, ref) {
+        const set = this.patternSubs.get(pattern);
+        if (!set)
+            return;
+        set.delete(ref);
+        if (set.size === 0)
+            this.patternSubs.delete(pattern);
+    }
+    dispatchInbound(msg) {
+        for (const [pattern, subs] of this.patternSubs) {
+            if (matchesMqttPattern(pattern, msg.topic)) {
+                for (const ref of subs)
+                    ref.tell(msg);
+            }
+        }
+    }
+}
+/* --------------------------- MQTT 5.0 helpers -------------------------- */
+/**
+ * Build the mqtt-packet `properties` object for an outbound publish,
+ * or `undefined` if there's nothing v5-specific to attach.  Pure
+ * function — testable without a real broker or mqtt.js install
+ * (see `tests/unit/io/broker/MqttActor.test.ts`).
+ *
+ * `protocolVersion < 5` always returns undefined: the 3.1.1 wire
+ * format has no slot for user properties, so we drop them rather
+ * than letting them leak into the publish callsite and confuse
+ * downstream tooling.
+ */
+export function buildPublishProperties(p, protocolVersion) {
+    if (protocolVersion < 5)
+        return undefined;
+    if (!p.userProperties)
+        return undefined;
+    const keys = Object.keys(p.userProperties);
+    if (keys.length === 0)
+        return undefined;
+    return { userProperties: p.userProperties };
+}
+/* --------------------------- MQTT topic match -------------------------- */
+/** Standard MQTT pattern match: `+` matches one segment, `#` matches the rest. */
+export function matchesMqttPattern(pattern, topic) {
+    const ps = pattern.split('/');
+    const ts = topic.split('/');
+    for (let i = 0; i < ps.length; i++) {
+        const p = ps[i];
+        if (p === '#')
+            return true;
+        if (i >= ts.length)
+            return false;
+        if (p === '+')
+            continue;
+        if (p !== ts[i])
+            return false;
+    }
+    return ps.length === ts.length;
+}
+const mqttLazy = Lazy.of(() => lazyImportModule('mqtt', { context: 'MqttActor' }));
+//# sourceMappingURL=MqttActor.js.map

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

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

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

@@ -0,0 +1,65 @@
+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 NATS message handed to subscribers. */
+export interface NatsMessage {
+    readonly subject: string;
+    readonly payload: Uint8Array;
+    /** Reply subject (for request/reply patterns).  Empty when not set. */
+    readonly replyTo: string;
+}
+/** Outbound publish — one NATS message. */
+export interface NatsPublish {
+    readonly subject: string;
+    readonly payload: Uint8Array | string;
+    readonly replyTo?: string;
+}
+export interface NatsActorSettings extends BrokerCommonSettings {
+    /** NATS server URLs (`'nats://localhost:4222'`). */
+    readonly servers?: ReadonlyArray<string> | string;
+    /** Optional credentials (token / user-password). */
+    readonly token?: string;
+    readonly user?: string;
+    readonly password?: string;
+    /** Subscriptions wired up at connect time.  Subjects support `*` and `>` wildcards (NATS-side). */
+    readonly subscriptions?: ReadonlyArray<{
+        readonly subject: string;
+        readonly target: ActorRef<NatsMessage>;
+    }>;
+    /** Optional client name reported to the server. */
+    readonly name?: string;
+}
+export type NatsCmd = {
+    readonly kind: 'publish';
+    readonly publish: NatsPublish;
+} | {
+    readonly kind: 'subscribe';
+    readonly subject: string;
+    readonly target: ActorRef<NatsMessage>;
+} | {
+    readonly kind: 'unsubscribe';
+    readonly subject: string;
+};
+/**
+ * NATS-Core (no JetStream) actor backed by the official `nats` peer-dep.
+ * Plain pub/sub with optional request/reply via `replyTo`.  JetStream
+ * (durable streams + consumers) is out-of-scope for v1 — would warrant
+ * its own actor with very different semantics.
+ */
+export declare class NatsActor extends BrokerActor<NatsActorSettings, NatsCmd, NatsPublish> {
+    private nc;
+    private readonly subs;
+    constructor(settings?: Partial<NatsActorSettings>);
+    protected configKey(): string;
+    protected builtInDefaults(): Partial<NatsActorSettings>;
+    protected readSettingsFromConfig(c: Config): Partial<NatsActorSettings>;
+    protected requiredSettings(): ReadonlyArray<keyof NatsActorSettings>;
+    protected endpointLabel(): string;
+    protected connectImpl(): Promise<void>;
+    protected disconnectImpl(): Promise<void>;
+    protected dispatchOutgoing(env: OutboundEnvelope<NatsPublish>): Promise<void>;
+    onReceive(cmd: NatsCmd): void;
+    private subscribeOnConnection;
+}
+//# sourceMappingURL=NatsActor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NatsActor.d.ts","sourceRoot":"","sources":["../../../src/io/broker/NatsActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,oDAAoD;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAClD,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,mGAAmG;IACnG,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAA;KAAE,CAAC,CAAC;IAC7G,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,OAAO,GACf;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAA;CAAE,GAChG;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D;;;;;GAKG;AACH,qBAAa,SAAU,SAAQ,WAAW,CAAC,iBAAiB,EAAE,OAAO,EAAE,WAAW,CAAC;IACjF,OAAO,CAAC,EAAE,CAAmC;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2C;gBAEpD,QAAQ,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAErD,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,eAAe,IAAI,OAAO,CAAC,iBAAiB,CAAC;IACvD,SAAS,CAAC,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IASvE,SAAS,CAAC,gBAAgB,IAAI,aAAa,CAAC,MAAM,iBAAiB,CAAC;IACpE,SAAS,CAAC,aAAa,IAAI,MAAM;cAMjB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;cAuB5B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;cAW/B,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1E,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAkBtC,OAAO,CAAC,qBAAqB;CAkB9B"}

package/dist/io/broker/NatsActor.js

@@ -0,0 +1,126 @@
+import { ConfigKeys } from '../../config/ConfigKeys.js';
+import { Lazy } from '../../util/Lazy.js';
+import { lazyImportModule } from '../../util/LazyImport.js';
+import { BrokerActor } from './BrokerActor.js';
+/**
+ * NATS-Core (no JetStream) actor backed by the official `nats` peer-dep.
+ * Plain pub/sub with optional request/reply via `replyTo`.  JetStream
+ * (durable streams + consumers) is out-of-scope for v1 — would warrant
+ * its own actor with very different semantics.
+ */
+export class NatsActor extends BrokerActor {
+    nc = null;
+    subs = new Map();
+    constructor(settings = {}) { super(settings); }
+    configKey() { return ConfigKeys.io.broker.nats; }
+    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 s.join(',');
+        return typeof s === 'string' ? s : '';
+    }
+    async connectImpl() {
+        const nats = await natsLazy.get();
+        const servers = Array.isArray(this.settings.servers)
+            ? [...this.settings.servers]
+            : [this.settings.servers];
+        this.nc = await nats.connect({
+            servers,
+            token: this.settings.token,
+            user: this.settings.user,
+            pass: this.settings.password,
+            name: this.settings.name,
+        });
+        for (const s of this.settings.subscriptions ?? []) {
+            this.subscribeOnConnection(s.subject, s.target);
+        }
+        // The connection emits a closed-promise we await loosely.
+        void this.nc.closed().then((err) => {
+            this.handleConnectionLost(err ?? new Error('nats connection closed'));
+        });
+    }
+    async disconnectImpl() {
+        for (const sub of this.subs.values()) {
+            try {
+                sub.unsubscribe();
+            }
+            catch { /* ignore */ }
+        }
+        this.subs.clear();
+        if (this.nc) {
+            try {
+                await this.nc.drain();
+            }
+            catch { /* ignore */ }
+            this.nc = null;
+        }
+    }
+    async dispatchOutgoing(env) {
+        if (!this.nc)
+            throw new Error('NatsActor: not connected');
+        const p = env.payload;
+        const bytes = typeof p.payload === 'string'
+            ? new TextEncoder().encode(p.payload)
+            : p.payload;
+        this.nc.publish(p.subject, bytes, p.replyTo ? { reply: p.replyTo } : undefined);
+    }
+    onReceive(cmd) {
+        if (cmd.kind === 'publish') {
+            this.enqueueOutbound(cmd.publish);
+        }
+        else if (cmd.kind === 'subscribe') {
+            if (this.connectionState === 'connected' && this.nc) {
+                this.subscribeOnConnection(cmd.subject, cmd.target);
+            }
+        }
+        else {
+            const existing = this.subs.get(cmd.subject);
+            if (existing) {
+                try {
+                    existing.unsubscribe();
+                }
+                catch { /* ignore */ }
+                this.subs.delete(cmd.subject);
+            }
+        }
+    }
+    /* ----------------------------- internals ----------------------------- */
+    subscribeOnConnection(subject, target) {
+        if (!this.nc)
+            return;
+        if (this.subs.has(subject))
+            return;
+        const sub = this.nc.subscribe(subject, {
+            callback: (err, msg) => {
+                if (err) {
+                    this.log.warn(`NatsActor: subscription error on '${subject}': ${err.message}`);
+                    return;
+                }
+                target.tell({
+                    subject: msg.subject,
+                    payload: msg.data,
+                    replyTo: msg.reply ?? '',
+                });
+            },
+        });
+        this.subs.set(subject, sub);
+    }
+}
+const natsLazy = Lazy.of(() => lazyImportModule('nats', { context: 'NatsActor' }));
+//# sourceMappingURL=NatsActor.js.map