actor-ts 0.9.1 → 0.11.0

package/dist/io/broker/MqttOptions.js

@@ -0,0 +1,90 @@
+/**
+ * All MQTT option-relevant types live here:
+ *
+ *   - {@link MqttOptionsType} — the plain options-object shape (what you may
+ *     also pass as a bare `{ … }` object).
+ *   - {@link MqttOptionsBuilder} — the fluent builder (`MqttOptions.create()…`).
+ *   - {@link MqttOptions} — the accepted-input **union**
+ *     (`MqttOptionsBuilder | MqttOptionsType`), plus a value alias to the
+ *     builder so `MqttOptions.create()` / `new MqttOptions()` keep working.
+ *
+ * A subclass takes `MqttOptions` in its constructor and tacks on per-instance
+ * options before calling `super(...)`:
+ *
+ *     class MyClient extends MqttActor {
+ *       constructor(options: MqttOptions = {}) {
+ *         super(options);
+ *         this.subscribe('some/topic/#');
+ *       }
+ *     }
+ *
+ * The builder records only the fields you set (as own enumerable props), so it
+ * reads/spreads exactly like a plain object; the same three-layer merge applies
+ * (constructor > HOCON under `actor-ts.io.broker.mqtt` > built-in defaults).
+ * The common broker fields (`withReconnect` / `withCircuitBreaker` /
+ * `withOutboundBuffer`) come from {@link BrokerOptionsBuilder}.
+ */
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
+/** Fluent builder for {@link MqttOptionsType}. */
+export class MqttOptionsBuilder extends BrokerOptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new MqttOptionsBuilder()`. */
+    static create() {
+        return new MqttOptionsBuilder();
+    }
+    /** Broker URL — `mqtt://`, `mqtts://`, `ws://`, `wss://`. */
+    withBrokerUrl(url) {
+        return this.set('brokerUrl', url);
+    }
+    /** Stable client id.  When omitted the broker assigns one. */
+    withClientId(clientId) {
+        return this.set('clientId', clientId);
+    }
+    /** Username / password credentials. */
+    withCredentials(username, password) {
+        return this.set('credentials', { username, password });
+    }
+    /** Default QoS used by `publish` / `subscribe` when not overridden per call. */
+    withQos(qos) {
+        return this.set('qos', qos);
+    }
+    /** Last-will-and-testament published by the broker on ungraceful disconnect. */
+    withWill(will) {
+        return this.set('will', will);
+    }
+    /** Clean-session flag.  Default `true`. */
+    withCleanSession(clean = true) {
+        return this.set('cleanSession', clean);
+    }
+    /** Keep-alive interval in seconds.  Default 60. */
+    withKeepAlive(seconds) {
+        return this.set('keepAlive', seconds);
+    }
+    /** MQTT protocol version — 4 (3.1.1, default) or 5. */
+    withProtocolVersion(version) {
+        return this.set('protocolVersion', version);
+    }
+    /** Payload codec for `entity()` decode + entity `publish` encode.  Default JSON. */
+    withCodec(codec) {
+        return this.set('codec', codec);
+    }
+}
+/**
+ * Validates resolved {@link MqttOptionsType} settings.  Invoked by
+ * {@link MqttActor} at start, so builder / plain-object / HOCON inputs all
+ * pass through the same rules.
+ */
+export class MqttOptionsValidator extends BrokerOptionsValidator {
+    constructor() {
+        super('MqttOptions');
+    }
+    rules(_s) {
+        this.commonRules(_s);
+        this.url('brokerUrl', ['mqtt', 'mqtts', 'ws', 'wss']);
+        this.oneOf('qos', [0, 1, 2]);
+        this.oneOf('protocolVersion', [4, 5]);
+        this.nonNegativeInt('keepAlive'); // 0 disables keep-alive per the MQTT spec
+    }
+}
+/** Value alias so `MqttOptions.create()` / `new MqttOptions()` resolve to the builder. */
+export const MqttOptions = MqttOptionsBuilder;
+//# sourceMappingURL=MqttOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MqttOptions.js","sourceRoot":"","sources":["../../../src/io/broker/MqttOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAyClF,kDAAkD;AAClD,MAAM,OAAO,kBAAmB,SAAQ,oBAAqC;IAC3E,wEAAwE;IACxE,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,kBAAkB,EAAE,CAAC;IAClC,CAAC;IAED,6DAA6D;IAC7D,aAAa,CAAC,GAAW;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,8DAA8D;IAC9D,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,uCAAuC;IACvC,eAAe,CAAC,QAAiB,EAAE,QAAiB;QAClD,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,gFAAgF;IAChF,OAAO,CAAC,GAAY;QAClB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,gFAAgF;IAChF,QAAQ,CAAC,IAA0C;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,2CAA2C;IAC3C,gBAAgB,CAAC,KAAK,GAAG,IAAI;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,mDAAmD;IACnD,aAAa,CAAC,OAAe;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,uDAAuD;IACvD,mBAAmB,CAAC,OAAc;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,oFAAoF;IACpF,SAAS,CAAC,KAAyB;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,sBAAuC;IAC/E;QACE,KAAK,CAAC,aAAa,CAAC,CAAC;IACvB,CAAC;IACS,KAAK,CAAC,EAA4B;QAC1C,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,0CAA0C;IAC9E,CAAC;CACF;AAOD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC"}

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

@@ -1,7 +1,8 @@
 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';
+import { NatsOptionsValidator } from './NatsOptions.js';
+import type { NatsOptions, NatsOptionsType } from './NatsOptions.js';
 /** Inbound NATS message handed to subscribers. */
 export interface NatsMessage {
     readonly subject: string;
@@ -15,22 +16,7 @@ export interface NatsPublish {
     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 = {
+export type NatsCommand = {
     readonly kind: 'publish';
     readonly publish: NatsPublish;
 } | {
@@ -47,19 +33,20 @@ export type NatsCmd = {
  * (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> {
+export declare class NatsActor extends BrokerActor<NatsOptionsType, NatsCommand, NatsPublish> {
     private nc;
     private readonly subs;
-    constructor(settings?: Partial<NatsActorSettings>);
+    constructor(options?: NatsOptions);
     protected configKey(): string;
-    protected builtInDefaults(): Partial<NatsActorSettings>;
-    protected readSettingsFromConfig(c: Config): Partial<NatsActorSettings>;
-    protected requiredSettings(): ReadonlyArray<keyof NatsActorSettings>;
+    protected builtInDefaultOptions(): Partial<NatsOptionsType>;
+    protected readOptionsFromConfig(config: Config): Partial<NatsOptionsType>;
+    protected requiredOptions(): ReadonlyArray<keyof NatsOptionsType>;
+    protected optionsValidator(): NatsOptionsValidator;
     protected endpointLabel(): string;
-    protected connectImpl(): Promise<void>;
-    protected disconnectImpl(): Promise<void>;
+    protected connectImplementation(): Promise<void>;
+    protected disconnectImplementation(): Promise<void>;
     protected dispatchOutgoing(env: OutboundEnvelope<NatsPublish>): Promise<void>;
-    onReceive(cmd: NatsCmd): void;
+    onReceive(cmd: NatsCommand): void;
     private subscribeOnConnection;
 }
 //# sourceMappingURL=NatsActor.d.ts.map

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

@@ -1 +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"}
+{"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,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAErE,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,MAAM,WAAW,GACnB;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,eAAe,EAAE,WAAW,EAAE,WAAW,CAAC;IACnF,OAAO,CAAC,EAAE,CAAmC;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2C;gBAEpD,OAAO,GAAE,WAAgB;IAErC,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,qBAAqB,IAAI,OAAO,CAAC,eAAe,CAAC;IAC3D,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IASzE,SAAS,CAAC,eAAe,IAAI,aAAa,CAAC,MAAM,eAAe,CAAC;cAC9C,gBAAgB,IAAI,oBAAoB;IAC3D,SAAS,CAAC,aAAa,IAAI,MAAM;cAMjB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;cAuBtC,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;cAWzC,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1E,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAkB1C,OAAO,CAAC,qBAAqB;CAkB9B"}

package/dist/io/broker/NatsActor.js

@@ -2,6 +2,7 @@ import { ConfigKeys } from '../../config/ConfigKeys.js';
 import { Lazy } from '../../util/Lazy.js';
 import { lazyImportModule } from '../../util/LazyImport.js';
 import { BrokerActor } from './BrokerActor.js';
+import { NatsOptionsValidator } from './NatsOptions.js';
 /**
  * NATS-Core (no JetStream) actor backed by the official `nats` peer-dep.
  * Plain pub/sub with optional request/reply via `replyTo`.  JetStream
@@ -11,51 +12,52 @@ import { BrokerActor } from './BrokerActor.js';
 export class NatsActor extends BrokerActor {
     nc = null;
     subs = new Map();
-    constructor(settings = {}) { super(settings); }
+    constructor(options = {}) { super(options); }
     configKey() { return ConfigKeys.io.broker.nats; }
-    builtInDefaults() { return {}; }
-    readSettingsFromConfig(c) {
+    builtInDefaultOptions() { return {}; }
+    readOptionsFromConfig(config) {
         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');
+        if (config.hasPath('servers'))
+            out.servers = config.getStringList('servers');
+        if (config.hasPath('token'))
+            out.token = config.getString('token');
+        if (config.hasPath('user'))
+            out.user = config.getString('user');
+        if (config.hasPath('password'))
+            out.password = config.getString('password');
+        if (config.hasPath('name'))
+            out.name = config.getString('name');
         return out;
     }
-    requiredSettings() { return ['servers']; }
+    requiredOptions() { return ['servers']; }
+    optionsValidator() { return new NatsOptionsValidator(); }
     endpointLabel() {
-        const s = this.settings.servers;
-        if (Array.isArray(s))
-            return s.join(',');
-        return typeof s === 'string' ? s : '';
+        const servers = this.options.servers;
+        if (Array.isArray(servers))
+            return servers.join(',');
+        return typeof servers === 'string' ? servers : '';
     }
-    async connectImpl() {
+    async connectImplementation() {
         const nats = await natsLazy.get();
-        const servers = Array.isArray(this.settings.servers)
-            ? [...this.settings.servers]
-            : [this.settings.servers];
+        const servers = Array.isArray(this.options.servers)
+            ? [...this.options.servers]
+            : [this.options.servers];
         this.nc = await nats.connect({
             servers,
-            token: this.settings.token,
-            user: this.settings.user,
-            pass: this.settings.password,
-            name: this.settings.name,
+            token: this.options.token,
+            user: this.options.user,
+            pass: this.options.password,
+            name: this.options.name,
         });
-        for (const s of this.settings.subscriptions ?? []) {
-            this.subscribeOnConnection(s.subject, s.target);
+        for (const subscription of this.options.subscriptions ?? []) {
+            this.subscribeOnConnection(subscription.subject, subscription.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() {
+    async disconnectImplementation() {
         for (const sub of this.subs.values()) {
             try {
                 sub.unsubscribe();
@@ -74,11 +76,11 @@ export class NatsActor extends BrokerActor {
     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);
+        const publish = env.payload;
+        const bytes = typeof publish.payload === 'string'
+            ? new TextEncoder().encode(publish.payload)
+            : publish.payload;
+        this.nc.publish(publish.subject, bytes, publish.replyTo ? { reply: publish.replyTo } : undefined);
     }
     onReceive(cmd) {
         if (cmd.kind === 'publish') {

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * Fluent builder for {@link NatsOptionsType}.  Protocol-specific
+ * methods only; the common broker fields (`withReconnect` /
+ * `withCircuitBreaker` / `withOutboundBuffer`) come from
+ * {@link BrokerOptionsBuilder}.  `build()` snapshots the accumulated partial
+ * and feeds the same three-layer merge (constructor > HOCON under
+ * `actor-ts.io.broker.nats` > built-in defaults).
+ */
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
+import type { BrokerCommonOptionsType } from './BrokerOptions.js';
+import type { ActorRef } from '../../ActorRef.js';
+import type { NatsMessage } from './NatsActor.js';
+export interface NatsOptionsType extends BrokerCommonOptionsType {
+    /** 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 declare class NatsOptionsBuilder extends BrokerOptionsBuilder<NatsOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new NatsOptionsBuilder()`. */
+    static create(): NatsOptionsBuilder;
+    /** NATS server URLs (`'nats://localhost:4222'` or array). */
+    withServers(servers: ReadonlyArray<string> | string): this;
+    /** Token credential. */
+    withToken(token: string): this;
+    /** Username credential. */
+    withUser(user: string): this;
+    /** Password credential. */
+    withPassword(password: string): this;
+    /** Subscriptions wired up at connect time. */
+    withSubscriptions(subscriptions: NonNullable<NatsOptionsType['subscriptions']>): this;
+    /** Client name reported to the server. */
+    withName(name: string): this;
+}
+/** Validates resolved {@link NatsOptionsType} settings. */
+export declare class NatsOptionsValidator extends BrokerOptionsValidator<NatsOptionsType> {
+    constructor();
+    protected rules(s: Partial<NatsOptionsType>): void;
+}
+/**
+ * Accepted input for any NATS-configurable constructor: the fluent
+ * {@link NatsOptionsBuilder} OR a plain {@link NatsOptionsType} object.
+ */
+export type NatsOptions = NatsOptionsBuilder | Partial<NatsOptionsType>;
+/** Value alias so `NatsOptions.create()` / `new NatsOptions()` resolve to the builder. */
+export declare const NatsOptions: typeof NatsOptionsBuilder;
+//# sourceMappingURL=NatsOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NatsOptions.d.ts","sourceRoot":"","sources":["../../../src/io/broker/NatsOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,eAAgB,SAAQ,uBAAuB;IAC9D,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,qBAAa,kBAAmB,SAAQ,oBAAoB,CAAC,eAAe,CAAC;IAC3E,wEAAwE;IACxE,MAAM,CAAC,MAAM,IAAI,kBAAkB;IAInC,6DAA6D;IAC7D,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI;IAI1D,wBAAwB;IACxB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,2BAA2B;IAC3B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC,8CAA8C;IAC9C,iBAAiB,CAAC,aAAa,EAAE,WAAW,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,GAAG,IAAI;IAIrF,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG7B;AAED,2DAA2D;AAC3D,qBAAa,oBAAqB,SAAQ,sBAAsB,CAAC,eAAe,CAAC;;IAI/E,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;CAInD;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AACxE,0FAA0F;AAC1F,eAAO,MAAM,WAAW,2BAAqB,CAAC"}

package/dist/io/broker/NatsOptions.js

@@ -0,0 +1,52 @@
+/**
+ * Fluent builder for {@link NatsOptionsType}.  Protocol-specific
+ * methods only; the common broker fields (`withReconnect` /
+ * `withCircuitBreaker` / `withOutboundBuffer`) come from
+ * {@link BrokerOptionsBuilder}.  `build()` snapshots the accumulated partial
+ * and feeds the same three-layer merge (constructor > HOCON under
+ * `actor-ts.io.broker.nats` > built-in defaults).
+ */
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
+export class NatsOptionsBuilder extends BrokerOptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new NatsOptionsBuilder()`. */
+    static create() {
+        return new NatsOptionsBuilder();
+    }
+    /** NATS server URLs (`'nats://localhost:4222'` or array). */
+    withServers(servers) {
+        return this.set('servers', servers);
+    }
+    /** Token credential. */
+    withToken(token) {
+        return this.set('token', token);
+    }
+    /** Username credential. */
+    withUser(user) {
+        return this.set('user', user);
+    }
+    /** Password credential. */
+    withPassword(password) {
+        return this.set('password', password);
+    }
+    /** Subscriptions wired up at connect time. */
+    withSubscriptions(subscriptions) {
+        return this.set('subscriptions', subscriptions);
+    }
+    /** Client name reported to the server. */
+    withName(name) {
+        return this.set('name', name);
+    }
+}
+/** Validates resolved {@link NatsOptionsType} settings. */
+export class NatsOptionsValidator extends BrokerOptionsValidator {
+    constructor() {
+        super('NatsOptions');
+    }
+    rules(s) {
+        this.commonRules(s);
+        this.nonEmptyStringOrArray('servers', s.servers);
+    }
+}
+/** Value alias so `NatsOptions.create()` / `new NatsOptions()` resolve to the builder. */
+export const NatsOptions = NatsOptionsBuilder;
+//# sourceMappingURL=NatsOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NatsOptions.js","sourceRoot":"","sources":["../../../src/io/broker/NatsOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAkBlF,MAAM,OAAO,kBAAmB,SAAQ,oBAAqC;IAC3E,wEAAwE;IACxE,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,kBAAkB,EAAE,CAAC;IAClC,CAAC;IAED,6DAA6D;IAC7D,WAAW,CAAC,OAAuC;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,wBAAwB;IACxB,SAAS,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,2BAA2B;IAC3B,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,2BAA2B;IAC3B,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,8CAA8C;IAC9C,iBAAiB,CAAC,aAA4D;QAC5E,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,0CAA0C;IAC1C,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,OAAO,oBAAqB,SAAQ,sBAAuC;IAC/E;QACE,KAAK,CAAC,aAAa,CAAC,CAAC;IACvB,CAAC;IACS,KAAK,CAAC,CAA2B;QACzC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;CACF;AAOD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC"}

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

@@ -1,7 +1,7 @@
 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';
+import { RedisStreamsOptionsValidator } from './RedisStreamsOptions.js';
+import type { RedisStreamsOptions, RedisStreamsOptionsType } from './RedisStreamsOptions.js';
 /** Inbound entry from a Redis stream. */
 export interface RedisStreamEntry {
     readonly stream: string;
@@ -15,24 +15,7 @@ export interface RedisStreamPublish {
     /** Optional `MAXLEN ~ N` cap.  Drops oldest when set. */
     readonly maxLenApprox?: number;
 }
-export interface RedisStreamsActorSettings extends BrokerCommonSettings {
-    /** Redis URL (`'redis://host:6379'`). */
-    readonly url?: string;
-    /** Streams to consume. */
-    readonly streams?: ReadonlyArray<string>;
-    /** Consumer-group settings — required to consume.  When omitted only producing works. */
-    readonly consumerGroup?: {
-        readonly group: string;
-        readonly consumer: string;
-        /** Auto-create the group if missing.  Default: true. */
-        readonly createIfMissing?: boolean;
-    };
-    /** Block timeout per XREADGROUP call in ms.  Default: 5_000. */
-    readonly blockMs?: number;
-    /** Subscriber for inbound entries.  Required to consume. */
-    readonly target?: ActorRef<RedisStreamEntry>;
-}
-export type RedisStreamsCmd = {
+export type RedisStreamsCommand = {
     readonly kind: 'publish';
     readonly publish: RedisStreamPublish;
 } | {
@@ -50,20 +33,21 @@ export type RedisStreamsCmd = {
  * once semantics with crash-recovery.  For at-most-once, ack
  * immediately on delivery.
  */
-export declare class RedisStreamsActor extends BrokerActor<RedisStreamsActorSettings, RedisStreamsCmd, RedisStreamPublish> {
+export declare class RedisStreamsActor extends BrokerActor<RedisStreamsOptionsType, RedisStreamsCommand, RedisStreamPublish> {
     private redis;
     private redisProducer;
     private consumerLoopRunning;
-    constructor(settings?: Partial<RedisStreamsActorSettings>);
+    constructor(options?: RedisStreamsOptions);
     protected configKey(): string;
-    protected builtInDefaults(): Partial<RedisStreamsActorSettings>;
-    protected readSettingsFromConfig(c: Config): Partial<RedisStreamsActorSettings>;
-    protected requiredSettings(): ReadonlyArray<keyof RedisStreamsActorSettings>;
+    protected builtInDefaultOptions(): Partial<RedisStreamsOptionsType>;
+    protected readOptionsFromConfig(config: Config): Partial<RedisStreamsOptionsType>;
+    protected requiredOptions(): ReadonlyArray<keyof RedisStreamsOptionsType>;
+    protected optionsValidator(): RedisStreamsOptionsValidator;
     protected endpointLabel(): string;
-    protected connectImpl(): Promise<void>;
-    protected disconnectImpl(): Promise<void>;
+    protected connectImplementation(): Promise<void>;
+    protected disconnectImplementation(): Promise<void>;
     protected dispatchOutgoing(env: OutboundEnvelope<RedisStreamPublish>): Promise<void>;
-    onReceive(cmd: RedisStreamsCmd): void;
+    onReceive(cmd: RedisStreamsCommand): void;
     private consumerLoop;
 }
 //# sourceMappingURL=RedisStreamsActor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"RedisStreamsActor.d.ts","sourceRoot":"","sources":["../../../src/io/broker/RedisStreamsActor.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,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,yDAAyD;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE,yCAAyC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,yFAAyF;IACzF,QAAQ,CAAC,aAAa,CAAC,EAAE;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,wDAAwD;QACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;KACpC,CAAC;IACF,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;CAC9C;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GAClE;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E;;;;;;;;;GASG;AACH,qBAAa,iBACX,SAAQ,WAAW,CAAC,yBAAyB,EAAE,eAAe,EAAE,kBAAkB,CAAC;IACnF,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,mBAAmB,CAAS;gBAExB,QAAQ,GAAE,OAAO,CAAC,yBAAyB,CAAM;IAE7D,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,eAAe,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAG/D,SAAS,CAAC,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAe/E,SAAS,CAAC,gBAAgB,IAAI,aAAa,CAAC,MAAM,yBAAyB,CAAC;IAC5E,SAAS,CAAC,aAAa,IAAI,MAAM;cAEjB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;cAuB5B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;cAQ/B,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjF,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;YAahC,YAAY;CA4B3B"}
+{"version":3,"file":"RedisStreamsActor.d.ts","sourceRoot":"","sources":["../../../src/io/broker/RedisStreamsActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAIrD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAE7F,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,yDAAyD;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GAClE;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E;;;;;;;;;GASG;AACH,qBAAa,iBACX,SAAQ,WAAW,CAAC,uBAAuB,EAAE,mBAAmB,EAAE,kBAAkB,CAAC;IACrF,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,mBAAmB,CAAS;gBAExB,OAAO,GAAE,mBAAwB;IAE7C,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,qBAAqB,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAGnE,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAejF,SAAS,CAAC,eAAe,IAAI,aAAa,CAAC,MAAM,uBAAuB,CAAC;cACtD,gBAAgB,IAAI,4BAA4B;IACnE,SAAS,CAAC,aAAa,IAAI,MAAM;cAEjB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;cAuBtC,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;cAQzC,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjF,SAAS,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI;YAapC,YAAY;CA4B3B"}