actor-ts 0.9.1 → 0.11.0

package/dist/io/broker/RedisStreamsActor.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 { RedisStreamsOptionsValidator } from './RedisStreamsOptions.js';
 /**
  * Redis-Streams actor.  Wraps `ioredis` (already a peer-dep used by
  * the cache layer).  Producer + optional consumer in one actor.
@@ -16,40 +17,41 @@ export class RedisStreamsActor extends BrokerActor {
     redis = null;
     redisProducer = null;
     consumerLoopRunning = false;
-    constructor(settings = {}) { super(settings); }
+    constructor(options = {}) { super(options); }
     configKey() { return ConfigKeys.io.broker.redisStreams; }
-    builtInDefaults() {
+    builtInDefaultOptions() {
         return { blockMs: 5_000 };
     }
-    readSettingsFromConfig(c) {
+    readOptionsFromConfig(config) {
         const out = {};
-        if (c.hasPath('url'))
-            out.url = c.getString('url');
-        if (c.hasPath('streams'))
-            out.streams = c.getStringList('streams');
-        if (c.hasPath('blockMs'))
-            out.blockMs = c.getDuration('blockMs');
-        if (c.hasPath('consumerGroup')) {
-            const g = c.getConfig('consumerGroup');
+        if (config.hasPath('url'))
+            out.url = config.getString('url');
+        if (config.hasPath('streams'))
+            out.streams = config.getStringList('streams');
+        if (config.hasPath('blockMs'))
+            out.blockMs = config.getDuration('blockMs');
+        if (config.hasPath('consumerGroup')) {
+            const consumerGroupConfig = config.getConfig('consumerGroup');
             out.consumerGroup = {
-                group: g.getString('group'),
-                consumer: g.getString('consumer'),
-                createIfMissing: g.hasPath('createIfMissing') ? g.getBoolean('createIfMissing') : undefined,
+                group: consumerGroupConfig.getString('group'),
+                consumer: consumerGroupConfig.getString('consumer'),
+                createIfMissing: consumerGroupConfig.hasPath('createIfMissing') ? consumerGroupConfig.getBoolean('createIfMissing') : undefined,
             };
         }
         return out;
     }
-    requiredSettings() { return ['url']; }
-    endpointLabel() { return this.settings.url ?? '<unknown>'; }
-    async connectImpl() {
+    requiredOptions() { return ['url']; }
+    optionsValidator() { return new RedisStreamsOptionsValidator(); }
+    endpointLabel() { return this.options.url ?? '<unknown>'; }
+    async connectImplementation() {
         const ioredis = await ioredisLazy.get();
-        const Ctor = ioredis.default ?? ioredis;
-        this.redisProducer = new Ctor(this.settings.url);
-        if (this.settings.consumerGroup && this.settings.streams && this.settings.target) {
-            this.redis = new Ctor(this.settings.url);
-            const cg = this.settings.consumerGroup;
+        const Constructor = ioredis.default ?? ioredis;
+        this.redisProducer = new Constructor(this.options.url);
+        if (this.options.consumerGroup && this.options.streams && this.options.target) {
+            this.redis = new Constructor(this.options.url);
+            const cg = this.options.consumerGroup;
             if (cg.createIfMissing ?? true) {
-                for (const stream of this.settings.streams) {
+                for (const stream of this.options.streams) {
                     try {
                         await this.redis.xgroup('CREATE', stream, cg.group, '$', 'MKSTREAM');
                     }
@@ -65,7 +67,7 @@ export class RedisStreamsActor extends BrokerActor {
             void this.consumerLoop();
         }
     }
-    async disconnectImpl() {
+    async disconnectImplementation() {
         this.consumerLoopRunning = false;
         try {
             await this.redisProducer?.quit();
@@ -81,14 +83,14 @@ export class RedisStreamsActor extends BrokerActor {
     async dispatchOutgoing(env) {
         if (!this.redisProducer)
             throw new Error('RedisStreamsActor: producer not connected');
-        const p = env.payload;
-        const args = [p.stream];
-        if (p.maxLenApprox !== undefined) {
-            args.push('MAXLEN', '~', String(p.maxLenApprox));
+        const publish = env.payload;
+        const args = [publish.stream];
+        if (publish.maxLenApprox !== undefined) {
+            args.push('MAXLEN', '~', String(publish.maxLenApprox));
         }
         args.push('*'); // auto-id
-        for (const [k, v] of Object.entries(p.fields)) {
-            args.push(k, v);
+        for (const [fieldName, fieldValue] of Object.entries(publish.fields)) {
+            args.push(fieldName, fieldValue);
         }
         await this.redisProducer.xadd(...args);
     }
@@ -97,22 +99,22 @@ export class RedisStreamsActor extends BrokerActor {
             this.enqueueOutbound(cmd.publish);
         }
         else if (cmd.kind === 'ack') {
-            if (this.redis && this.settings.consumerGroup) {
-                void this.redis.xack(cmd.stream, this.settings.consumerGroup.group, cmd.id)
+            if (this.redis && this.options.consumerGroup) {
+                void this.redis.xack(cmd.stream, this.options.consumerGroup.group, cmd.id)
                     .catch((e) => this.log.warn(`xack failed: ${e.message}`));
             }
         }
     }
     /* ----------------------------- internals ----------------------------- */
     async consumerLoop() {
-        const cg = this.settings.consumerGroup;
-        const blockMs = this.settings.blockMs ?? 5_000;
+        const cg = this.options.consumerGroup;
+        const blockMs = this.options.blockMs ?? 5_000;
         while (this.consumerLoopRunning && this.redis) {
             try {
                 const args = ['GROUP', cg.group, cg.consumer,
                     'BLOCK', String(blockMs), 'COUNT', '32',
-                    'STREAMS', ...(this.settings.streams ?? []),
-                    ...(this.settings.streams ?? []).map(() => '>'),
+                    'STREAMS', ...(this.options.streams ?? []),
+                    ...(this.options.streams ?? []).map(() => '>'),
                 ];
                 const result = await this.redis.xreadgroup(...args);
                 if (!result)
@@ -123,7 +125,7 @@ export class RedisStreamsActor extends BrokerActor {
                         for (let i = 0; i + 1 < fields.length; i += 2) {
                             obj[fields[i]] = fields[i + 1];
                         }
-                        this.settings.target?.tell({ stream, id, fields: obj });
+                        this.options.target?.tell({ stream, id, fields: obj });
                     }
                 }
             }
@@ -131,7 +133,7 @@ export class RedisStreamsActor extends BrokerActor {
                 if (!this.consumerLoopRunning)
                     return;
                 this.log.warn(`RedisStreams consumer loop error: ${e.message}`);
-                await new Promise((r) => setTimeout(r, 500));
+                await new Promise((resolve) => setTimeout(resolve, 500));
             }
         }
     }

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * Fluent builder for {@link RedisStreamsOptionsType}.  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.redisStreams` > built-in defaults).
+ */
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
+import type { BrokerCommonOptionsType } from './BrokerOptions.js';
+import type { ActorRef } from '../../ActorRef.js';
+import type { RedisStreamEntry } from './RedisStreamsActor.js';
+export interface RedisStreamsOptionsType extends BrokerCommonOptionsType {
+    /** Redis URL (`'redis://host:6379'`). */
+    readonly url?: string;
+    /** Streams to consume. */
+    readonly streams?: ReadonlyArray<string>;
+    /** Consumer-group options — 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 declare class RedisStreamsOptionsBuilder extends BrokerOptionsBuilder<RedisStreamsOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new RedisStreamsOptionsBuilder()`. */
+    static create(): RedisStreamsOptionsBuilder;
+    /** Redis URL (`'redis://host:6379'`). */
+    withUrl(url: string): this;
+    /** Streams to consume. */
+    withStreams(streams: ReadonlyArray<string>): this;
+    /** Consumer-group options — required to consume. */
+    withConsumerGroup(group: NonNullable<RedisStreamsOptionsType['consumerGroup']>): this;
+    /** Block timeout per XREADGROUP call in ms.  Default 5000. */
+    withBlockMs(ms: number): this;
+    /** Subscriber for inbound entries.  Required to consume. */
+    withTarget(target: ActorRef<RedisStreamEntry>): this;
+}
+/** Validates resolved {@link RedisStreamsOptionsType} settings. */
+export declare class RedisStreamsOptionsValidator extends BrokerOptionsValidator<RedisStreamsOptionsType> {
+    constructor();
+    protected rules(s: Partial<RedisStreamsOptionsType>): void;
+}
+/**
+ * Accepted input for any Redis-Streams-configurable constructor: the fluent
+ * {@link RedisStreamsOptionsBuilder} OR a plain {@link RedisStreamsOptionsType} object.
+ */
+export type RedisStreamsOptions = RedisStreamsOptionsBuilder | Partial<RedisStreamsOptionsType>;
+/** Value alias so `RedisStreamsOptions.create()` / `new RedisStreamsOptions()` resolve to the builder. */
+export declare const RedisStreamsOptions: typeof RedisStreamsOptionsBuilder;
+//# sourceMappingURL=RedisStreamsOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RedisStreamsOptions.d.ts","sourceRoot":"","sources":["../../../src/io/broker/RedisStreamsOptions.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,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,WAAW,uBAAwB,SAAQ,uBAAuB;IACtE,yCAAyC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,wFAAwF;IACxF,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,qBAAa,0BAA2B,SAAQ,oBAAoB,CAAC,uBAAuB,CAAC;IAC3F,gFAAgF;IAChF,MAAM,CAAC,MAAM,IAAI,0BAA0B;IAI3C,yCAAyC;IACzC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI1B,0BAA0B;IAC1B,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAIjD,oDAAoD;IACpD,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC,GAAG,IAAI;IAIrF,8DAA8D;IAC9D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI7B,4DAA4D;IAC5D,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI;CAGrD;AAED,mEAAmE;AACnE,qBAAa,4BAA6B,SAAQ,sBAAsB,CAAC,uBAAuB,CAAC;;IAI/F,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,IAAI;CAK3D;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,0BAA0B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAChG,0GAA0G;AAC1G,eAAO,MAAM,mBAAmB,mCAA6B,CAAC"}

package/dist/io/broker/RedisStreamsOptions.js

@@ -0,0 +1,49 @@
+/**
+ * Fluent builder for {@link RedisStreamsOptionsType}.  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.redisStreams` > built-in defaults).
+ */
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
+export class RedisStreamsOptionsBuilder extends BrokerOptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new RedisStreamsOptionsBuilder()`. */
+    static create() {
+        return new RedisStreamsOptionsBuilder();
+    }
+    /** Redis URL (`'redis://host:6379'`). */
+    withUrl(url) {
+        return this.set('url', url);
+    }
+    /** Streams to consume. */
+    withStreams(streams) {
+        return this.set('streams', streams);
+    }
+    /** Consumer-group options — required to consume. */
+    withConsumerGroup(group) {
+        return this.set('consumerGroup', group);
+    }
+    /** Block timeout per XREADGROUP call in ms.  Default 5000. */
+    withBlockMs(ms) {
+        return this.set('blockMs', ms);
+    }
+    /** Subscriber for inbound entries.  Required to consume. */
+    withTarget(target) {
+        return this.set('target', target);
+    }
+}
+/** Validates resolved {@link RedisStreamsOptionsType} settings. */
+export class RedisStreamsOptionsValidator extends BrokerOptionsValidator {
+    constructor() {
+        super('RedisStreamsOptions');
+    }
+    rules(s) {
+        this.commonRules(s);
+        this.url('url', ['redis', 'rediss']);
+        this.nonNegativeInt('blockMs'); // 0 = block indefinitely (Redis XREAD semantics)
+    }
+}
+/** Value alias so `RedisStreamsOptions.create()` / `new RedisStreamsOptions()` resolve to the builder. */
+export const RedisStreamsOptions = RedisStreamsOptionsBuilder;
+//# sourceMappingURL=RedisStreamsOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RedisStreamsOptions.js","sourceRoot":"","sources":["../../../src/io/broker/RedisStreamsOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAuBlF,MAAM,OAAO,0BAA2B,SAAQ,oBAA6C;IAC3F,gFAAgF;IAChF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,0BAA0B,EAAE,CAAC;IAC1C,CAAC;IAED,yCAAyC;IACzC,OAAO,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,0BAA0B;IAC1B,WAAW,CAAC,OAA8B;QACxC,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,oDAAoD;IACpD,iBAAiB,CAAC,KAA4D;QAC5E,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,8DAA8D;IAC9D,WAAW,CAAC,EAAU;QACpB,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,4DAA4D;IAC5D,UAAU,CAAC,MAAkC;QAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,OAAO,4BAA6B,SAAQ,sBAA+C;IAC/F;QACE,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC/B,CAAC;IACS,KAAK,CAAC,CAAmC;QACjD,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,iDAAiD;IACnF,CAAC;CACF;AAOD,0GAA0G;AAC1G,MAAM,CAAC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC"}

package/dist/io/broker/SseActor.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 { SseOptionsValidator } from './SseOptions.js';
+import type { SseOptions, SseOptionsType } from './SseOptions.js';
 /** Inbound SSE event delivered to subscribers. */
 export interface SseEvent {
     /** The `event:` field value, or `'message'` (default per SSE spec). */
@@ -11,15 +11,7 @@ export interface SseEvent {
     /** Last-event-id, when the server sent one. */
     readonly id?: string;
 }
-export interface SseActorSettings extends BrokerCommonSettings {
-    /** SSE endpoint URL. */
-    readonly url?: string;
-    /** Custom request headers. */
-    readonly headers?: Readonly<Record<string, string>>;
-    /** Subscriber for inbound events.  Required. */
-    readonly target?: ActorRef<SseEvent>;
-}
-export type SseCmd = never;
+export type SseCommand = never;
 /**
  * Server-Sent Events client actor.  Pure built-ins — uses `fetch`
  * (Bun + Node 18+ + Deno all have it) and parses the wire format
@@ -27,19 +19,20 @@ export type SseCmd = never;
  *
  * The base class' reconnect machinery applies on stream close.
  */
-export declare class SseActor extends BrokerActor<SseActorSettings, SseCmd, never> {
+export declare class SseActor extends BrokerActor<SseOptionsType, SseCommand, never> {
     private aborter;
     private streamRunning;
-    constructor(settings?: Partial<SseActorSettings>);
+    constructor(options?: SseOptions);
     protected configKey(): string;
-    protected builtInDefaults(): Partial<SseActorSettings>;
-    protected readSettingsFromConfig(c: Config): Partial<SseActorSettings>;
-    protected requiredSettings(): ReadonlyArray<keyof SseActorSettings>;
+    protected builtInDefaultOptions(): Partial<SseOptionsType>;
+    protected readOptionsFromConfig(config: Config): Partial<SseOptionsType>;
+    protected requiredOptions(): ReadonlyArray<keyof SseOptionsType>;
+    protected optionsValidator(): SseOptionsValidator;
     protected endpointLabel(): string;
-    protected connectImpl(): Promise<void>;
-    protected disconnectImpl(): Promise<void>;
+    protected connectImplementation(): Promise<void>;
+    protected disconnectImplementation(): Promise<void>;
     protected dispatchOutgoing(_env: OutboundEnvelope<never>): Promise<void>;
-    onReceive(_cmd: SseCmd): void;
+    onReceive(_cmd: SseCommand): void;
     private consume;
 }
 //# sourceMappingURL=SseActor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SseActor.d.ts","sourceRoot":"","sources":["../../../src/io/broker/SseActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,kDAAkD;AAClD,MAAM,WAAW,QAAQ;IACvB,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC5D,wBAAwB;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC;AAE3B;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,WAAW,CAAC,gBAAgB,EAAE,MAAM,EAAE,KAAK,CAAC;IACxE,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,aAAa,CAAS;gBAElB,QAAQ,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAEpD,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC;IACtD,SAAS,CAAC,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAYtE,SAAS,CAAC,gBAAgB,IAAI,aAAa,CAAC,MAAM,gBAAgB,CAAC;IACnE,SAAS,CAAC,aAAa,IAAI,MAAM;cAEjB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;cAe5B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;cAM/B,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;YAIxB,OAAO;CA6BtB"}
+{"version":3,"file":"SseActor.d.ts","sourceRoot":"","sources":["../../../src/io/broker/SseActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAElE,kDAAkD;AAClD,MAAM,WAAW,QAAQ;IACvB,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC;AAU/B;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,WAAW,CAAC,cAAc,EAAE,UAAU,EAAE,KAAK,CAAC;IAC1E,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,aAAa,CAAS;gBAElB,OAAO,GAAE,UAAe;IAEpC,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,qBAAqB,IAAI,OAAO,CAAC,cAAc,CAAC;IAC1D,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAYxE,SAAS,CAAC,eAAe,IAAI,aAAa,CAAC,MAAM,cAAc,CAAC;cAC7C,gBAAgB,IAAI,mBAAmB;IAC1D,SAAS,CAAC,aAAa,IAAI,MAAM;cAEjB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;cAetC,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;cAMzC,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;YAI5B,OAAO;CAwCtB"}

package/dist/io/broker/SseActor.js

@@ -1,6 +1,14 @@
 import { ConfigKeys } from '../../config/ConfigKeys.js';
 import { Lazy } from '../../util/Lazy.js';
 import { BrokerActor } from './BrokerActor.js';
+import { SseOptionsValidator } from './SseOptions.js';
+/**
+ * Safety cap on the pending event buffer (chars).  A well-behaved server
+ * delimits events with `\n\n` frequently; this bounds the damage from one
+ * that never does (security audit BRK-2).  1 MiB is far above any real
+ * single SSE event.
+ */
+const SSE_MAX_BUFFER_CHARS = 1_048_576;
 /**
  * Server-Sent Events client actor.  Pure built-ins — uses `fetch`
  * (Bun + Node 18+ + Deno all have it) and parses the wire format
@@ -11,31 +19,32 @@ import { BrokerActor } from './BrokerActor.js';
 export class SseActor extends BrokerActor {
     aborter = null;
     streamRunning = false;
-    constructor(settings = {}) { super(settings); }
+    constructor(options = {}) { super(options); }
     configKey() { return ConfigKeys.io.broker.sse; }
-    builtInDefaults() { return {}; }
-    readSettingsFromConfig(c) {
+    builtInDefaultOptions() { return {}; }
+    readOptionsFromConfig(config) {
         const out = {};
-        if (c.hasPath('url'))
-            out.url = c.getString('url');
-        if (c.hasPath('headers')) {
-            const h = {};
-            for (const [k, v] of Object.entries(c.getObject('headers'))) {
-                if (typeof v === 'string')
-                    h[k] = v;
+        if (config.hasPath('url'))
+            out.url = config.getString('url');
+        if (config.hasPath('headers')) {
+            const headers = {};
+            for (const [headerName, headerValue] of Object.entries(config.getObject('headers'))) {
+                if (typeof headerValue === 'string')
+                    headers[headerName] = headerValue;
             }
-            out.headers = h;
+            out.headers = headers;
         }
         return out;
     }
-    requiredSettings() { return ['url', 'target']; }
-    endpointLabel() { return this.settings.url ?? '<unknown>'; }
-    async connectImpl() {
+    requiredOptions() { return ['url', 'target']; }
+    optionsValidator() { return new SseOptionsValidator(); }
+    endpointLabel() { return this.options.url ?? '<unknown>'; }
+    async connectImplementation() {
         this.aborter = new AbortController();
         const fetchFn = await fetchLazy.get();
-        const res = await fetchFn(this.settings.url, {
+        const res = await fetchFn(this.options.url, {
             method: 'GET',
-            headers: { Accept: 'text/event-stream', ...(this.settings.headers ?? {}) },
+            headers: { Accept: 'text/event-stream', ...(this.options.headers ?? {}) },
             signal: this.aborter.signal,
         });
         if (!res.ok)
@@ -45,7 +54,7 @@ export class SseActor extends BrokerActor {
         this.streamRunning = true;
         void this.consume(res.body);
     }
-    async disconnectImpl() {
+    async disconnectImplementation() {
         this.streamRunning = false;
         try {
             this.aborter?.abort();
@@ -68,13 +77,25 @@ export class SseActor extends BrokerActor {
                 if (done)
                     break;
                 buffer += decoder.decode(value, { stream: true });
+                // Cap the pending buffer: a hostile / MITM'd endpoint that streams
+                // bytes without an event delimiter (`\n\n`) would otherwise grow it
+                // without bound (security audit BRK-2).
+                if (buffer.length > SSE_MAX_BUFFER_CHARS) {
+                    this.streamRunning = false;
+                    try {
+                        this.aborter?.abort();
+                    }
+                    catch { /* ignore */ }
+                    this.handleConnectionLost(new Error(`SSE event buffer exceeded ${SSE_MAX_BUFFER_CHARS} chars without a delimiter`));
+                    return;
+                }
                 let idx = buffer.indexOf('\n\n');
                 while (idx >= 0) {
                     const block = buffer.slice(0, idx);
                     buffer = buffer.slice(idx + 2);
                     const ev = parseEventBlock(block);
-                    if (ev && this.settings.target)
-                        this.settings.target.tell(ev);
+                    if (ev && this.options.target)
+                        this.options.target.tell(ev);
                     idx = buffer.indexOf('\n\n');
                 }
             }
@@ -120,9 +141,9 @@ function parseEventBlock(block) {
     return { event, data: dataLines.join('\n'), id };
 }
 const fetchLazy = Lazy.of(async () => {
-    const f = globalThis.fetch;
-    if (typeof f === 'function')
-        return f;
+    const fetchImpl = globalThis.fetch;
+    if (typeof fetchImpl === 'function')
+        return fetchImpl;
     throw new Error('SseActor needs a global `fetch` (Bun, Node ≥18, Deno all provide one).  '
         + 'On older Node versions, polyfill via `npm install undici` and `globalThis.fetch = require("undici").fetch`.');
 });

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

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

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

@@ -0,0 +1,43 @@
+/**
+ * Fluent builder for {@link SseOptionsType}.  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.sse` > built-in defaults).
+ */
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
+import type { BrokerCommonOptionsType } from './BrokerOptions.js';
+import type { ActorRef } from '../../ActorRef.js';
+import type { SseEvent } from './SseActor.js';
+export interface SseOptionsType extends BrokerCommonOptionsType {
+    /** SSE endpoint URL. */
+    readonly url?: string;
+    /** Custom request headers. */
+    readonly headers?: Readonly<Record<string, string>>;
+    /** Subscriber for inbound events.  Required. */
+    readonly target?: ActorRef<SseEvent>;
+}
+export declare class SseOptionsBuilder extends BrokerOptionsBuilder<SseOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new SseOptionsBuilder()`. */
+    static create(): SseOptionsBuilder;
+    /** SSE endpoint URL. */
+    withUrl(url: string): this;
+    /** Custom request headers. */
+    withHeaders(headers: Readonly<Record<string, string>>): this;
+    /** Subscriber for inbound events.  Required. */
+    withTarget(target: ActorRef<SseEvent>): this;
+}
+/** Validates resolved {@link SseOptionsType} settings. */
+export declare class SseOptionsValidator extends BrokerOptionsValidator<SseOptionsType> {
+    constructor();
+    protected rules(s: Partial<SseOptionsType>): void;
+}
+/**
+ * Accepted input for any SSE-configurable constructor: the fluent
+ * {@link SseOptionsBuilder} OR a plain {@link SseOptionsType} object.
+ */
+export type SseOptions = SseOptionsBuilder | Partial<SseOptionsType>;
+/** Value alias so `SseOptions.create()` / `new SseOptions()` resolve to the builder. */
+export declare const SseOptions: typeof SseOptionsBuilder;
+//# sourceMappingURL=SseOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SseOptions.d.ts","sourceRoot":"","sources":["../../../src/io/broker/SseOptions.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,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,cAAe,SAAQ,uBAAuB;IAC7D,wBAAwB;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;CACtC;AAED,qBAAa,iBAAkB,SAAQ,oBAAoB,CAAC,cAAc,CAAC;IACzE,uEAAuE;IACvE,MAAM,CAAC,MAAM,IAAI,iBAAiB;IAIlC,wBAAwB;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI1B,8BAA8B;IAC9B,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI;IAI5D,gDAAgD;IAChD,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI;CAG7C;AAED,0DAA0D;AAC1D,qBAAa,mBAAoB,SAAQ,sBAAsB,CAAC,cAAc,CAAC;;IAI7E,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;CAIlD;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AACrE,wFAAwF;AACxF,eAAO,MAAM,UAAU,0BAAoB,CAAC"}

package/dist/io/broker/SseOptions.js

@@ -0,0 +1,40 @@
+/**
+ * Fluent builder for {@link SseOptionsType}.  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.sse` > built-in defaults).
+ */
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
+export class SseOptionsBuilder extends BrokerOptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new SseOptionsBuilder()`. */
+    static create() {
+        return new SseOptionsBuilder();
+    }
+    /** SSE endpoint URL. */
+    withUrl(url) {
+        return this.set('url', url);
+    }
+    /** Custom request headers. */
+    withHeaders(headers) {
+        return this.set('headers', headers);
+    }
+    /** Subscriber for inbound events.  Required. */
+    withTarget(target) {
+        return this.set('target', target);
+    }
+}
+/** Validates resolved {@link SseOptionsType} settings. */
+export class SseOptionsValidator extends BrokerOptionsValidator {
+    constructor() {
+        super('SseOptions');
+    }
+    rules(s) {
+        this.commonRules(s);
+        this.url('url', ['http', 'https']);
+    }
+}
+/** Value alias so `SseOptions.create()` / `new SseOptions()` resolve to the builder. */
+export const SseOptions = SseOptionsBuilder;
+//# sourceMappingURL=SseOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SseOptions.js","sourceRoot":"","sources":["../../../src/io/broker/SseOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAclF,MAAM,OAAO,iBAAkB,SAAQ,oBAAoC;IACzE,uEAAuE;IACvE,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,iBAAiB,EAAE,CAAC;IACjC,CAAC;IAED,wBAAwB;IACxB,OAAO,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,8BAA8B;IAC9B,WAAW,CAAC,OAAyC;QACnD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,gDAAgD;IAChD,UAAU,CAAC,MAA0B;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAED,0DAA0D;AAC1D,MAAM,OAAO,mBAAoB,SAAQ,sBAAsC;IAC7E;QACE,KAAK,CAAC,YAAY,CAAC,CAAC;IACtB,CAAC;IACS,KAAK,CAAC,CAA0B;QACxC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,CAAC;CACF;AAOD,wFAAwF;AACxF,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,CAAC"}