actor-ts 0.10.0 → 0.11.0

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

@@ -6,8 +6,8 @@
  * and feeds the same three-layer merge (constructor > HOCON under
  * `actor-ts.io.broker.redisStreams` > built-in defaults).
  */
-import { BrokerOptionsBuilder } from './BrokerOptions.js';
-import type { BrokerCommonOptionsType } from './BrokerSettings.js';
+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 {
@@ -15,7 +15,7 @@ export interface RedisStreamsOptionsType extends BrokerCommonOptionsType {
     readonly url?: string;
     /** Streams to consume. */
     readonly streams?: ReadonlyArray<string>;
-    /** Consumer-group settings — required to consume.  When omitted only producing works. */
+    /** Consumer-group options — required to consume.  When omitted only producing works. */
     readonly consumerGroup?: {
         readonly group: string;
         readonly consumer: string;
@@ -34,13 +34,18 @@ export declare class RedisStreamsOptionsBuilder extends BrokerOptionsBuilder<Red
     withUrl(url: string): this;
     /** Streams to consume. */
     withStreams(streams: ReadonlyArray<string>): this;
-    /** Consumer-group settings — required to consume. */
+    /** 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.

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

@@ -1 +1 @@
-{"version":3,"file":"RedisStreamsOptions.d.ts","sourceRoot":"","sources":["../../../src/io/broker/RedisStreamsOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,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,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,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,qDAAqD;IACrD,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;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,0BAA0B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAChG,0GAA0G;AAC1G,eAAO,MAAM,mBAAmB,mCAA6B,CAAC"}
+{"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

@@ -6,7 +6,7 @@
  * and feeds the same three-layer merge (constructor > HOCON under
  * `actor-ts.io.broker.redisStreams` > built-in defaults).
  */
-import { BrokerOptionsBuilder } from './BrokerOptions.js';
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
 export class RedisStreamsOptionsBuilder extends BrokerOptionsBuilder {
     /** Start a fresh builder.  Equivalent to `new RedisStreamsOptionsBuilder()`. */
     static create() {
@@ -20,7 +20,7 @@ export class RedisStreamsOptionsBuilder extends BrokerOptionsBuilder {
     withStreams(streams) {
         return this.set('streams', streams);
     }
-    /** Consumer-group settings — required to consume. */
+    /** Consumer-group options — required to consume. */
     withConsumerGroup(group) {
         return this.set('consumerGroup', group);
     }
@@ -33,6 +33,17 @@ export class RedisStreamsOptionsBuilder extends BrokerOptionsBuilder {
         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

@@ -1 +1 @@
-{"version":3,"file":"RedisStreamsOptions.js","sourceRoot":"","sources":["../../../src/io/broker/RedisStreamsOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAuB1D,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,qDAAqD;IACrD,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;AAOD,0GAA0G;AAC1G,MAAM,CAAC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC"}
+{"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,5 +1,6 @@
 import type { Config } from '../../config/Config.js';
 import { BrokerActor, type OutboundEnvelope } from './BrokerActor.js';
+import { SseOptionsValidator } from './SseOptions.js';
 import type { SseOptions, SseOptionsType } from './SseOptions.js';
 /** Inbound SSE event delivered to subscribers. */
 export interface SseEvent {
@@ -10,7 +11,7 @@ export interface SseEvent {
     /** Last-event-id, when the server sent one. */
     readonly id?: string;
 }
-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
@@ -18,19 +19,20 @@ export type SseCmd = never;
  *
  * The base class' reconnect machinery applies on stream close.
  */
-export declare class SseActor extends BrokerActor<SseOptionsType, SseCmd, never> {
+export declare class SseActor extends BrokerActor<SseOptionsType, SseCommand, never> {
     private aborter;
     private streamRunning;
     constructor(options?: SseOptions);
     protected configKey(): string;
-    protected builtInDefaults(): Partial<SseOptionsType>;
-    protected readSettingsFromConfig(c: Config): Partial<SseOptionsType>;
-    protected requiredSettings(): ReadonlyArray<keyof SseOptionsType>;
+    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;AAGrD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,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,MAAM,GAAG,KAAK,CAAC;AAE3B;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC;IACtE,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,aAAa,CAAS;gBAElB,OAAO,GAAE,UAAe;IAEpC,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,eAAe,IAAI,OAAO,CAAC,cAAc,CAAC;IACpD,SAAS,CAAC,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAYpE,SAAS,CAAC,gBAAgB,IAAI,aAAa,CAAC,MAAM,cAAc,CAAC;IACjE,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
@@ -13,29 +21,30 @@ export class SseActor extends BrokerActor {
     streamRunning = false;
     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

@@ -6,8 +6,8 @@
  * and feeds the same three-layer merge (constructor > HOCON under
  * `actor-ts.io.broker.sse` > built-in defaults).
  */
-import { BrokerOptionsBuilder } from './BrokerOptions.js';
-import type { BrokerCommonOptionsType } from './BrokerSettings.js';
+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 {
@@ -28,6 +28,11 @@ export declare class SseOptionsBuilder extends BrokerOptionsBuilder<SseOptionsTy
     /** 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.

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

@@ -1 +1 @@
-{"version":3,"file":"SseOptions.d.ts","sourceRoot":"","sources":["../../../src/io/broker/SseOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,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;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AACrE,wFAAwF;AACxF,eAAO,MAAM,UAAU,0BAAoB,CAAC"}
+{"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

@@ -6,7 +6,7 @@
  * and feeds the same three-layer merge (constructor > HOCON under
  * `actor-ts.io.broker.sse` > built-in defaults).
  */
-import { BrokerOptionsBuilder } from './BrokerOptions.js';
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
 export class SseOptionsBuilder extends BrokerOptionsBuilder {
     /** Start a fresh builder.  Equivalent to `new SseOptionsBuilder()`. */
     static create() {
@@ -25,6 +25,16 @@ export class SseOptionsBuilder extends BrokerOptionsBuilder {
         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

@@ -1 +1 @@
-{"version":3,"file":"SseOptions.js","sourceRoot":"","sources":["../../../src/io/broker/SseOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAc1D,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;AAOD,wFAAwF;AACxF,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,CAAC"}
+{"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"}

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

@@ -1,5 +1,6 @@
 import type { Config } from '../../config/Config.js';
 import { BrokerActor, type OutboundEnvelope } from './BrokerActor.js';
+import { TcpSocketOptionsValidator } from './TcpSocketOptions.js';
 import type { TcpSocketOptions, TcpSocketOptionsType } from './TcpSocketOptions.js';
 /**
  * Frame extraction strategy on the inbound stream.
@@ -32,24 +33,25 @@ export type TcpOutbound = Uint8Array | string;
  * via the standard `enqueueOutbound` path — the actor exposes a small
  * command surface (`send`) so user code can `tell({ kind: 'send', payload })`.
  */
-export type TcpSocketCmd = {
+export type TcpSocketCommand = {
     readonly kind: 'send';
     readonly payload: TcpOutbound;
 };
-export declare class TcpSocketActor extends BrokerActor<TcpSocketOptionsType, TcpSocketCmd, TcpOutbound> {
+export declare class TcpSocketActor extends BrokerActor<TcpSocketOptionsType, TcpSocketCommand, TcpOutbound> {
     private socket;
     /** Buffer for partial frames not yet matched by the framing strategy. */
     private inboundBuffer;
     constructor(options?: TcpSocketOptions);
     protected configKey(): string;
-    protected builtInDefaults(): Partial<TcpSocketOptionsType>;
-    protected readSettingsFromConfig(c: Config): Partial<TcpSocketOptionsType>;
-    protected requiredSettings(): ReadonlyArray<keyof TcpSocketOptionsType>;
+    protected builtInDefaultOptions(): Partial<TcpSocketOptionsType>;
+    protected readOptionsFromConfig(config: Config): Partial<TcpSocketOptionsType>;
+    protected requiredOptions(): ReadonlyArray<keyof TcpSocketOptionsType>;
+    protected optionsValidator(): TcpSocketOptionsValidator;
     protected endpointLabel(): string;
-    protected connectImpl(): Promise<void>;
-    protected disconnectImpl(): Promise<void>;
+    protected connectImplementation(): Promise<void>;
+    protected disconnectImplementation(): Promise<void>;
     protected dispatchOutgoing(env: OutboundEnvelope<TcpOutbound>): Promise<void>;
-    onReceive(cmd: TcpSocketCmd): void;
+    onReceive(cmd: TcpSocketCommand): void;
     private handleData;
     private extractLines;
     private extractLengthPrefixed;

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

@@ -1 +1 @@
-{"version":3,"file":"TcpSocketActor.d.ts","sourceRoot":"","sources":["../../../src/io/broker/TcpSocketActor.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,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEpF;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACrF;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAE7D,qBAAa,cAAe,SAAQ,WAAW,CAAC,oBAAoB,EAAE,YAAY,EAAE,WAAW,CAAC;IAC9F,OAAO,CAAC,MAAM,CAA0B;IACxC,yEAAyE;IACzE,OAAO,CAAC,aAAa,CAAiC;gBAE1C,OAAO,GAAE,gBAAqB;IAE1C,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAG1D,SAAS,CAAC,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsB1E,SAAS,CAAC,gBAAgB,IAAI,aAAa,CAAC,MAAM,oBAAoB,CAAC;IAGvE,SAAS,CAAC,aAAa,IAAI,MAAM;cAEjB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;cAuB5B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;cAY/B,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1E,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI;IAM3C,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,OAAO;CAIhB"}
+{"version":3,"file":"TcpSocketActor.d.ts","sourceRoot":"","sources":["../../../src/io/broker/TcpSocketActor.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,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEpF;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACrF;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAE7D,qBAAa,cAAe,SAAQ,WAAW,CAAC,oBAAoB,EAAE,gBAAgB,EAAE,WAAW,CAAC;IAClG,OAAO,CAAC,MAAM,CAA0B;IACxC,yEAAyE;IACzE,OAAO,CAAC,aAAa,CAAiC;gBAE1C,OAAO,GAAE,gBAAqB;IAE1C,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,qBAAqB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAGhE,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsB9E,SAAS,CAAC,eAAe,IAAI,aAAa,CAAC,MAAM,oBAAoB,CAAC;cAGnD,gBAAgB,IAAI,yBAAyB;IAChE,SAAS,CAAC,aAAa,IAAI,MAAM;cAEjB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;cAuBtC,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;cAYzC,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1E,SAAS,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IAM/C,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,OAAO;CAIhB"}

package/dist/io/broker/TcpSocketActor.js

@@ -1,33 +1,34 @@
 import { ConfigKeys } from '../../config/ConfigKeys.js';
 import { Lazy } from '../../util/Lazy.js';
 import { BrokerActor } from './BrokerActor.js';
+import { TcpSocketOptionsValidator } from './TcpSocketOptions.js';
 export class TcpSocketActor extends BrokerActor {
     socket = null;
     /** Buffer for partial frames not yet matched by the framing strategy. */
     inboundBuffer = new Uint8Array(0);
     constructor(options = {}) { super(options); }
     configKey() { return ConfigKeys.io.broker.tcp; }
-    builtInDefaults() {
+    builtInDefaultOptions() {
         return { framing: { kind: 'bytes' } };
     }
-    readSettingsFromConfig(c) {
+    readOptionsFromConfig(config) {
         const out = {};
-        if (c.hasPath('host'))
-            out.host = c.getString('host');
-        if (c.hasPath('port'))
-            out.port = c.getInt('port');
-        if (c.hasPath('framing')) {
-            const f = c.getConfig('framing');
-            const kind = f.getString('kind');
+        if (config.hasPath('host'))
+            out.host = config.getString('host');
+        if (config.hasPath('port'))
+            out.port = config.getInt('port');
+        if (config.hasPath('framing')) {
+            const framingConfig = config.getConfig('framing');
+            const kind = framingConfig.getString('kind');
             if (kind === 'lines') {
                 out.framing = {
-                    kind, delimiter: f.hasPath('delimiter') ? f.getString('delimiter') : undefined,
-                    maxLineLen: f.hasPath('maxLineLen') ? f.getInt('maxLineLen') : undefined,
+                    kind, delimiter: framingConfig.hasPath('delimiter') ? framingConfig.getString('delimiter') : undefined,
+                    maxLineLen: framingConfig.hasPath('maxLineLen') ? framingConfig.getInt('maxLineLen') : undefined,
                 };
             }
             else if (kind === 'length-prefixed') {
                 out.framing = {
-                    kind, maxFrameLen: f.hasPath('maxFrameLen') ? f.getInt('maxFrameLen') : undefined,
+                    kind, maxFrameLen: framingConfig.hasPath('maxFrameLen') ? framingConfig.getInt('maxFrameLen') : undefined,
                 };
             }
             else {
@@ -36,14 +37,15 @@ export class TcpSocketActor extends BrokerActor {
         }
         return out;
     }
-    requiredSettings() {
+    requiredOptions() {
         return ['host', 'port', 'target'];
     }
-    endpointLabel() { return `tcp://${this.settings.host}:${this.settings.port}`; }
-    async connectImpl() {
+    optionsValidator() { return new TcpSocketOptionsValidator(); }
+    endpointLabel() { return `tcp://${this.options.host}:${this.options.port}`; }
+    async connectImplementation() {
         const net = await netLazy.get();
         return new Promise((resolve, reject) => {
-            const sock = net.createConnection({ host: this.settings.host, port: this.settings.port });
+            const sock = net.createConnection({ host: this.options.host, port: this.options.port });
             let done = false;
             sock.once('connect', () => {
                 if (done)
@@ -64,7 +66,7 @@ export class TcpSocketActor extends BrokerActor {
             });
         });
     }
-    async disconnectImpl() {
+    async disconnectImplementation() {
         if (!this.socket)
             return;
         const sock = this.socket;
@@ -105,16 +107,16 @@ export class TcpSocketActor extends BrokerActor {
             merged.set(chunk, this.inboundBuffer.length);
             this.inboundBuffer = merged;
         }
-        const f = this.settings.framing ?? { kind: 'bytes' };
-        if (f.kind === 'bytes') {
+        const framing = this.options.framing ?? { kind: 'bytes' };
+        if (framing.kind === 'bytes') {
             this.deliver(this.inboundBuffer);
             this.inboundBuffer = new Uint8Array(0);
         }
-        else if (f.kind === 'lines') {
-            this.extractLines(f.delimiter ?? '\n', f.maxLineLen ?? 1_048_576);
+        else if (framing.kind === 'lines') {
+            this.extractLines(framing.delimiter ?? '\n', framing.maxLineLen ?? 1_048_576);
         }
         else {
-            this.extractLengthPrefixed(f.maxFrameLen ?? 16 * 1024 * 1024);
+            this.extractLengthPrefixed(framing.maxFrameLen ?? 16 * 1024 * 1024);
         }
     }
     extractLines(delimiter, maxLineLen) {
@@ -132,6 +134,15 @@ export class TcpSocketActor extends BrokerActor {
             this.deliver(line);
             cursor = idx + delimiter.length;
         }
+        // Pending (un-terminated) remainder: bytes after the last delimiter, or
+        // the whole buffer when no delimiter has arrived.  If it already exceeds
+        // maxLineLen it can never become a valid line, so a hostile / MITM'd peer
+        // streaming delimiter-free bytes can't grow inboundBuffer without bound
+        // (security audit BRK-1).
+        if (text.length - cursor > maxLineLen) {
+            this.handleConnectionLost(new Error(`unterminated line exceeds maxLineLen=${maxLineLen}`));
+            return;
+        }
         if (cursor === 0)
             return;
         // Re-encode the leftover suffix as bytes.
@@ -156,7 +167,7 @@ export class TcpSocketActor extends BrokerActor {
         this.inboundBuffer = cursor === 0 ? buf : buf.slice(cursor);
     }
     deliver(frame) {
-        const target = this.settings.target;
+        const target = this.options.target;
         if (target)
             target.tell(frame);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"TcpSocketActor.js","sourceRoot":"","sources":["../../../src/io/broker/TcpSocketActor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AAiCtE,MAAM,OAAO,cAAe,SAAQ,WAA4D;IACtF,MAAM,GAAqB,IAAI,CAAC;IACxC,yEAAyE;IACjE,aAAa,GAAe,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAEtD,YAAY,UAA4B,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAErD,SAAS,KAAa,OAAO,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,eAAe;QACvB,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;IACxC,CAAC;IACS,sBAAsB,CAAC,CAAS;QACxC,MAAM,GAAG,GAA8E,EAAE,CAAC;QAC1F,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACjC,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAuB,CAAC;YACvD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrB,GAAG,CAAC,OAAO,GAAG;oBACZ,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;oBAC9E,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;iBACzE,CAAC;YACJ,CAAC;iBAAM,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACtC,GAAG,CAAC,OAAO,GAAG;oBACZ,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS;iBAClF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAClC,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACS,gBAAgB;QACxB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IACS,aAAa,KAAa,OAAO,SAAS,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAEvF,KAAK,CAAC,WAAW;QACzB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;QAChC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAK,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAK,EAAE,CAAC,CAAC;YAC5F,IAAI,IAAI,GAAG,KAAK,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;gBACxB,IAAI,IAAI;oBAAE,OAAO;gBACjB,IAAI,GAAG,IAAI,CAAC;gBACZ,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;gBACjC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBACnB,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC/D,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;gBAC9E,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7D,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAQ,EAAE,EAAE;gBAC9B,IAAI,IAAI;oBAAE,OAAO;gBACjB,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM,CAAC,CAAC,CAAC,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAES,KAAK,CAAC,cAAc;QAC5B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1B,kEAAkE;YAClE,UAAU,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;gBAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACzF,CAAC,CAAC,CAAC;IACL,CAAC;IAES,KAAK,CAAC,gBAAgB,CAAC,GAAkC;QACjE,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,YAAY,UAAU;YAC7C,CAAC,CAAC,GAAG,CAAC,OAAO;YACb,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,IAAI,CAAC,MAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;IACL,CAAC;IAEQ,SAAS,CAAC,GAAiB;QAClC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;YAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,wEAAwE;IAEhE,UAAU,CAAC,KAAiB;QAClC,oBAAoB;QACpB,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;YACxE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;YAClC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;QAC9B,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACrD,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACjC,IAAI,CAAC,aAAa,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,SAAiB,EAAE,UAAkB;QACxD,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACnF,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC5C,IAAI,GAAG,GAAG,CAAC;gBAAE,MAAM;YACnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACrC,IAAI,IAAI,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;gBAC7B,IAAI,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC,CAAC;gBAC9E,OAAO;YACT,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACnB,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC;QAClC,CAAC;QACD,IAAI,MAAM,KAAK,CAAC;YAAE,OAAO;QACzB,0CAA0C;QAC1C,IAAI,CAAC,aAAa,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,CAAC;IAEO,qBAAqB,CAAC,WAAmB;QAC/C,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC;QAC/B,OAAO,GAAG,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAE,IAAI,EAAE,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAE,IAAI,EAAE;kBAC3C,GAAG,CAAC,MAAM,GAAG,CAAC,CAAE,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC;YAC7D,IAAI,GAAG,GAAG,WAAW,EAAE,CAAC;gBACtB,IAAI,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,6BAA6B,WAAW,EAAE,CAAC,CAAC,CAAC;gBACjF,OAAO;YACT,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,GAAG;gBAAE,MAAM;YACzC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;YACtD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,IAAI,CAAC,GAAG,GAAG,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IAEO,OAAO,CAAC,KAA0B;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QACpC,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,KAAc,CAAC,CAAC;IAC1C,CAAC;CACF;AAoBD,MAAM,OAAO,GAA6B,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;IAC3D,MAAM,IAAI,GAAG,UAAU,CAAC;IACxB,OAAO,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAc,CAAC;AAC3C,CAAC,CAAC,CAAC"}
+{"version":3,"file":"TcpSocketActor.js","sourceRoot":"","sources":["../../../src/io/broker/TcpSocketActor.ts"],"names":[],"mappings":"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"}

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

@@ -6,8 +6,8 @@
  * and feeds the same three-layer merge (constructor > HOCON under
  * `actor-ts.io.broker.tcp` > built-in defaults).
  */
-import { BrokerOptionsBuilder } from './BrokerOptions.js';
-import type { BrokerCommonOptionsType } from './BrokerSettings.js';
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
+import type { BrokerCommonOptionsType } from './BrokerOptions.js';
 import type { ActorRef } from '../../ActorRef.js';
 import type { TcpFraming } from './TcpSocketActor.js';
 export interface TcpSocketOptionsType extends BrokerCommonOptionsType {
@@ -36,6 +36,11 @@ export declare class TcpSocketOptionsBuilder extends BrokerOptionsBuilder<TcpSoc
     /** Subscriber that receives every inbound frame.  Required. */
     withTarget(target: ActorRef<unknown>): this;
 }
+/** Validates resolved {@link TcpSocketOptionsType} settings. */
+export declare class TcpSocketOptionsValidator extends BrokerOptionsValidator<TcpSocketOptionsType> {
+    constructor();
+    protected rules(_s: Partial<TcpSocketOptionsType>): void;
+}
 /**
  * Accepted input for any TCP-socket-configurable constructor: the fluent
  * {@link TcpSocketOptionsBuilder} OR a plain {@link TcpSocketOptionsType} object.

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

@@ -1 +1 @@
-{"version":3,"file":"TcpSocketOptions.d.ts","sourceRoot":"","sources":["../../../src/io/broker/TcpSocketOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,oBAAqB,SAAQ,uBAAuB;IACnE,mBAAmB;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CACrC;AAED,qBAAa,uBAAwB,SAAQ,oBAAoB,CAAC,oBAAoB,CAAC;IACrF,6EAA6E;IAC7E,MAAM,CAAC,MAAM,IAAI,uBAAuB;IAIxC,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,+DAA+D;IAC/D,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAItC,+DAA+D;IAC/D,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI;CAG5C;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AACvF,oGAAoG;AACpG,eAAO,MAAM,gBAAgB,gCAA0B,CAAC"}
+{"version":3,"file":"TcpSocketOptions.d.ts","sourceRoot":"","sources":["../../../src/io/broker/TcpSocketOptions.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,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,oBAAqB,SAAQ,uBAAuB;IACnE,mBAAmB;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CACrC;AAED,qBAAa,uBAAwB,SAAQ,oBAAoB,CAAC,oBAAoB,CAAC;IACrF,6EAA6E;IAC7E,MAAM,CAAC,MAAM,IAAI,uBAAuB;IAIxC,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,+DAA+D;IAC/D,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAItC,+DAA+D;IAC/D,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI;CAG5C;AAED,gEAAgE;AAChE,qBAAa,yBAA0B,SAAQ,sBAAsB,CAAC,oBAAoB,CAAC;;IAIzF,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;CAKzD;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AACvF,oGAAoG;AACpG,eAAO,MAAM,gBAAgB,gCAA0B,CAAC"}

package/dist/io/broker/TcpSocketOptions.js

@@ -6,7 +6,7 @@
  * and feeds the same three-layer merge (constructor > HOCON under
  * `actor-ts.io.broker.tcp` > built-in defaults).
  */
-import { BrokerOptionsBuilder } from './BrokerOptions.js';
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
 export class TcpSocketOptionsBuilder extends BrokerOptionsBuilder {
     /** Start a fresh builder.  Equivalent to `new TcpSocketOptionsBuilder()`. */
     static create() {
@@ -29,6 +29,17 @@ export class TcpSocketOptionsBuilder extends BrokerOptionsBuilder {
         return this.set('target', target);
     }
 }
+/** Validates resolved {@link TcpSocketOptionsType} settings. */
+export class TcpSocketOptionsValidator extends BrokerOptionsValidator {
+    constructor() {
+        super('TcpSocketOptions');
+    }
+    rules(_s) {
+        this.commonRules(_s);
+        this.nonEmptyString('host');
+        this.port('port');
+    }
+}
 /** Value alias so `TcpSocketOptions.create()` / `new TcpSocketOptions()` resolve to the builder. */
 export const TcpSocketOptions = TcpSocketOptionsBuilder;
 //# sourceMappingURL=TcpSocketOptions.js.map