actor-ts 0.10.0 → 0.11.0

package/dist/cache/RedisCacheOptions.d.ts

@@ -1,6 +1,7 @@
 import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
 import type { RedisClientLike } from './RedisCache.js';
-/** Plain settings-object shape accepted by a {@link RedisCache}. */
+/** Plain options-object shape accepted by a {@link RedisCache}. */
 export interface RedisCacheOptionsType {
     /**
      * Redis URL (e.g. `redis://localhost:6379`) — passed straight to the
@@ -45,6 +46,15 @@ export declare class RedisCacheOptionsBuilder extends OptionsBuilder<RedisCacheO
     /** Pre-built ioredis client — bypass internal construction (connection sharing, Cluster). */
     withClient(client: RedisClientLike): this;
 }
+/**
+ * Validates resolved {@link RedisCacheOptionsType} settings: a valid Redis
+ * `url`, a well-ranged `port` / logical `db`, and the documented
+ * mutual-exclusivity of `url` with `host`/`port`.
+ */
+export declare class RedisCacheOptionsValidator extends OptionsValidator<RedisCacheOptionsType> {
+    constructor();
+    protected rules(s: Partial<RedisCacheOptionsType>): void;
+}
 /**
  * Accepted input for the {@link RedisCache} constructor: the fluent
  * {@link RedisCacheOptionsBuilder} OR a plain {@link RedisCacheOptionsType}

package/dist/cache/RedisCacheOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RedisCacheOptions.d.ts","sourceRoot":"","sources":["../../src/cache/RedisCacheOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,oEAAoE;AACpE,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;GAIG;AACH,qBAAa,wBAAyB,SAAQ,cAAc,CAAC,qBAAqB,CAAC;IACjF,8EAA8E;IAC9E,MAAM,CAAC,MAAM,IAAI,wBAAwB;IAIzC,yFAAyF;IACzF,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI1B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,6BAA6B;IAC7B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC,oCAAoC;IACpC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB,mFAAmF;IACnF,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAInC,6FAA6F;IAC7F,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;CAG1C;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAC1F,sGAAsG;AACtG,eAAO,MAAM,iBAAiB,iCAA2B,CAAC"}
+{"version":3,"file":"RedisCacheOptions.d.ts","sourceRoot":"","sources":["../../src/cache/RedisCacheOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,mEAAmE;AACnE,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;GAIG;AACH,qBAAa,wBAAyB,SAAQ,cAAc,CAAC,qBAAqB,CAAC;IACjF,8EAA8E;IAC9E,MAAM,CAAC,MAAM,IAAI,wBAAwB;IAIzC,yFAAyF;IACzF,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI1B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,6BAA6B;IAC7B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC,oCAAoC;IACpC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB,mFAAmF;IACnF,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAInC,6FAA6F;IAC7F,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;CAG1C;AAED;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB,CAAC,qBAAqB,CAAC;;IAIrF,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;CAQzD;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAC1F,sGAAsG;AACtG,eAAO,MAAM,iBAAiB,iCAA2B,CAAC"}

package/dist/cache/RedisCacheOptions.js

@@ -1,4 +1,5 @@
 import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
 /**
  * Fluent builder for {@link RedisCacheOptionsType}:
  *
@@ -38,6 +39,24 @@ export class RedisCacheOptionsBuilder extends OptionsBuilder {
         return this.set('client', client);
     }
 }
+/**
+ * Validates resolved {@link RedisCacheOptionsType} settings: a valid Redis
+ * `url`, a well-ranged `port` / logical `db`, and the documented
+ * mutual-exclusivity of `url` with `host`/`port`.
+ */
+export class RedisCacheOptionsValidator extends OptionsValidator {
+    constructor() {
+        super('RedisCacheOptions');
+    }
+    rules(s) {
+        this.url('url', ['redis', 'rediss']);
+        this.port('port');
+        this.nonNegativeInt('db');
+        if (s.url !== undefined && (s.host !== undefined || s.port !== undefined)) {
+            this.fail('url', 'is mutually exclusive with host/port');
+        }
+    }
+}
 /** Value alias so `RedisCacheOptions.create()` / `new RedisCacheOptions()` resolve to the builder. */
 export const RedisCacheOptions = RedisCacheOptionsBuilder;
 //# sourceMappingURL=RedisCacheOptions.js.map

package/dist/cache/RedisCacheOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"RedisCacheOptions.js","sourceRoot":"","sources":["../../src/cache/RedisCacheOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA0B3D;;;;GAIG;AACH,MAAM,OAAO,wBAAyB,SAAQ,cAAqC;IACjF,8EAA8E;IAC9E,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,wBAAwB,EAAE,CAAC;IACxC,CAAC;IAED,yFAAyF;IACzF,OAAO,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,oEAAoE;IACpE,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,oEAAoE;IACpE,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,6BAA6B;IAC7B,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,oCAAoC;IACpC,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,mFAAmF;IACnF,aAAa,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,6FAA6F;IAC7F,UAAU,CAAC,MAAuB;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAQD,sGAAsG;AACtG,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC"}
+{"version":3,"file":"RedisCacheOptions.js","sourceRoot":"","sources":["../../src/cache/RedisCacheOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AA0B/D;;;;GAIG;AACH,MAAM,OAAO,wBAAyB,SAAQ,cAAqC;IACjF,8EAA8E;IAC9E,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,wBAAwB,EAAE,CAAC;IACxC,CAAC;IAED,yFAAyF;IACzF,OAAO,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,oEAAoE;IACpE,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,oEAAoE;IACpE,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,6BAA6B;IAC7B,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,oCAAoC;IACpC,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,mFAAmF;IACnF,aAAa,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,6FAA6F;IAC7F,UAAU,CAAC,MAAuB;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,0BAA2B,SAAQ,gBAAuC;IACrF;QACE,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC7B,CAAC;IACS,KAAK,CAAC,CAAiC;QAC/C,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;YAC1E,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,sCAAsC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;CACF;AAQD,sGAAsG;AACtG,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC"}

package/dist/cache/index.d.ts

@@ -1,12 +1,14 @@
 export { CacheError } from './Cache.js';
 export type { Cache } from './Cache.js';
 export { InMemoryCache } from './InMemoryCache.js';
+export { InMemoryCacheOptions, InMemoryCacheOptionsBuilder, InMemoryCacheOptionsValidator } from './InMemoryCacheOptions.js';
+export type { InMemoryCacheOptionsType } from './InMemoryCacheOptions.js';
 export { RedisCache } from './RedisCache.js';
-export { RedisCacheOptions, RedisCacheOptionsBuilder } from './RedisCacheOptions.js';
+export { RedisCacheOptions, RedisCacheOptionsBuilder, RedisCacheOptionsValidator } from './RedisCacheOptions.js';
 export type { RedisCacheOptionsType } from './RedisCacheOptions.js';
 export type { RedisClientLike } from './RedisCache.js';
 export { MemcachedCache } from './MemcachedCache.js';
-export { MemcachedCacheOptions, MemcachedCacheOptionsBuilder } from './MemcachedCacheOptions.js';
+export { MemcachedCacheOptions, MemcachedCacheOptionsBuilder, MemcachedCacheOptionsValidator } from './MemcachedCacheOptions.js';
 export type { MemcachedCacheOptionsType } from './MemcachedCacheOptions.js';
 export type { MemcachedClientLike } from './MemcachedCache.js';
 export { CacheExtension, CacheExtensionId, IN_MEMORY_CACHE_PLUGIN_ID, REDIS_CACHE_PLUGIN_ID, MEMCACHED_CACHE_PLUGIN_ID, } from './CacheExtension.js';

package/dist/cache/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACrF,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AACjG,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC7H,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACjH,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AACjI,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC"}

package/dist/cache/index.js

@@ -1,8 +1,9 @@
 export { CacheError } from './Cache.js';
 export { InMemoryCache } from './InMemoryCache.js';
+export { InMemoryCacheOptions, InMemoryCacheOptionsBuilder, InMemoryCacheOptionsValidator } from './InMemoryCacheOptions.js';
 export { RedisCache } from './RedisCache.js';
-export { RedisCacheOptions, RedisCacheOptionsBuilder } from './RedisCacheOptions.js';
+export { RedisCacheOptions, RedisCacheOptionsBuilder, RedisCacheOptionsValidator } from './RedisCacheOptions.js';
 export { MemcachedCache } from './MemcachedCache.js';
-export { MemcachedCacheOptions, MemcachedCacheOptionsBuilder } from './MemcachedCacheOptions.js';
+export { MemcachedCacheOptions, MemcachedCacheOptionsBuilder, MemcachedCacheOptionsValidator } from './MemcachedCacheOptions.js';
 export { CacheExtension, CacheExtensionId, IN_MEMORY_CACHE_PLUGIN_ID, REDIS_CACHE_PLUGIN_ID, MEMCACHED_CACHE_PLUGIN_ID, } from './CacheExtension.js';
 //# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAGrF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAGjG,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAE7H,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGjH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAGjI,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC"}

package/dist/cluster/Cluster.d.ts

@@ -5,9 +5,9 @@ import { type ClusterEvent } from './ClusterEvents.js';
 import { Member } from './Member.js';
 import { NodeAddress } from './NodeAddress.js';
 import { ClusterSharding } from './sharding/ClusterSharding.js';
-import type { EnvelopeMsg, WireMessage } from './Protocol.js';
+import type { EnvelopeMessage, WireMessage } from './Protocol.js';
 import { type Transport } from './Transport.js';
-type EnvelopeHandler = (env: EnvelopeMsg, from: NodeAddress) => void;
+type EnvelopeHandler = (env: EnvelopeMessage, from: NodeAddress) => void;
 /**
  * The Cluster is a single-instance "extension" attached to an ActorSystem.
  * It owns a Transport, a gossip-based membership view, a failure detector
@@ -128,7 +128,7 @@ export declare class Cluster {
      * the encode step once covers all paths (sharding, pub-sub, singleton,
      * direct remote-ref).  Receiving nodes decode in `handleEnvelope`.
      */
-    _sendEnvelope(to: NodeAddress, env: EnvelopeMsg): void;
+    _sendEnvelope(to: NodeAddress, env: EnvelopeMessage): void;
     /** Register a handler for a specific wire-message discriminator. */
     _onWire(kind: string, handler: (msg: WireMessage, from: NodeAddress) => void): () => void;
     /**

package/dist/cluster/Cluster.d.ts.map

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

package/dist/cluster/Cluster.js

@@ -4,8 +4,9 @@ import { metricsOf } from '../metrics/MetricsExtension.js';
 import { tracerOf } from '../tracing/TracingExtension.js';
 import { DEFAULT_GOSSIP_INTERVAL_MS, DEFAULT_SEED_RETRY_INTERVAL_MS, DEFAULT_TOMBSTONE_PRUNE_INTERVAL_MS, DEFAULT_TOMBSTONE_TTL_MS, } from '../util/Constants.js';
 import { none, some } from '../util/Option.js';
+import { ClusterOptionsValidator } from './ClusterOptions.js';
 import { LeaderChanged, MemberDown, MemberJoined, MemberLeft, MemberReachable, MemberRemoved, MemberUnreachable, MemberUp, MemberWeaklyUp, SelfRemoved, SelfUp, } from './ClusterEvents.js';
-import { defaultFailureDetectorSettings, FailureDetector, } from './FailureDetector.js';
+import { defaultFailureDetectorOptions, FailureDetector, } from './FailureDetector.js';
 import { FailureDetectorOptions } from './FailureDetectorOptions.js';
 import { Member } from './Member.js';
 import { NodeAddress } from './NodeAddress.js';
@@ -65,34 +66,35 @@ export class Cluster {
      * unreachable peer" state would call `decide()` on every tick.
      */
     lastDownedView = null;
-    constructor(system, settings) {
+    constructor(system, options) {
         this.system = system;
-        this.selfAddress = new NodeAddress(system.name, settings.host, settings.port);
-        this.selfRoles = new Set(settings.roles ?? []);
+        this.selfAddress = new NodeAddress(system.name, options.host, options.port);
+        this.selfRoles = new Set(options.roles ?? []);
         this.log = system.log.withSource(`cluster@${this.selfAddress}`);
-        this.transport = settings.transport ?? new TcpTransport(this.selfAddress, this.log);
-        const fdSettings = {
-            ...defaultFailureDetectorSettings,
-            ...(settings.failureDetector ?? {}),
+        this.transport = options.transport ?? new TcpTransport(this.selfAddress, this.log);
+        const fdOptions = {
+            ...defaultFailureDetectorOptions,
+            ...(options.failureDetector ?? {}),
         };
         this.failureDetector = new FailureDetector(FailureDetectorOptions.create()
-            .withHeartbeatIntervalMs(fdSettings.heartbeatIntervalMs)
-            .withUnreachableAfterMs(fdSettings.unreachableAfterMs)
-            .withDownAfterMs(fdSettings.downAfterMs));
-        this.gossipIntervalMs = settings.gossipIntervalMs ?? DEFAULT_GOSSIP_INTERVAL_MS;
-        this.seedRetryIntervalMs = settings.seedRetryIntervalMs ?? DEFAULT_SEED_RETRY_INTERVAL_MS;
-        this.weaklyUpAfterMs = settings.weaklyUpAfterMs ?? 0;
-        this.downing = settings.downing ?? null;
-        this.tombstoneTtlMs = settings.tombstoneTtlMs ?? DEFAULT_TOMBSTONE_TTL_MS;
-        this.tombstonePruneIntervalMs = settings.tombstonePruneIntervalMs ?? DEFAULT_TOMBSTONE_PRUNE_INTERVAL_MS;
+            .withHeartbeatIntervalMs(fdOptions.heartbeatIntervalMs)
+            .withUnreachableAfterMs(fdOptions.unreachableAfterMs)
+            .withDownAfterMs(fdOptions.downAfterMs));
+        this.gossipIntervalMs = options.gossipIntervalMs ?? DEFAULT_GOSSIP_INTERVAL_MS;
+        this.seedRetryIntervalMs = options.seedRetryIntervalMs ?? DEFAULT_SEED_RETRY_INTERVAL_MS;
+        this.weaklyUpAfterMs = options.weaklyUpAfterMs ?? 0;
+        this.downing = options.downing ?? null;
+        this.tombstoneTtlMs = options.tombstoneTtlMs ?? DEFAULT_TOMBSTONE_TTL_MS;
+        this.tombstonePruneIntervalMs = options.tombstonePruneIntervalMs ?? DEFAULT_TOMBSTONE_PRUNE_INTERVAL_MS;
         this.tombstoneMinRetentionMs =
-            settings.tombstoneMinRetentionMs ?? 6 * fdSettings.downAfterMs;
+            options.tombstoneMinRetentionMs ?? 6 * fdOptions.downAfterMs;
     }
     /** Entry point: start the cluster and attempt to contact seed nodes. */
     static async join(system, options) {
-        const settings = options;
-        const cluster = new Cluster(system, settings);
-        await cluster._start(settings.seeds ?? []);
+        const resolvedOptions = options;
+        new ClusterOptionsValidator().validate(resolvedOptions);
+        const cluster = new Cluster(system, resolvedOptions);
+        await cluster._start(resolvedOptions.seeds ?? []);
         return cluster;
     }
     /**
@@ -143,19 +145,19 @@ export class Cluster {
     subscribe(listener) {
         this._listeners.push(listener);
         // Replay current state.
-        for (const m of this.members.values()) {
+        for (const member of this.members.values()) {
             try {
-                listener(new MemberJoined(m));
+                listener(new MemberJoined(member));
             }
             catch { /* ignore */ }
-            if (m.status === 'up') {
+            if (member.status === 'up') {
                 try {
-                    listener(new MemberUp(m));
+                    listener(new MemberUp(member));
                 }
                 catch { /* ignore */ }
-                if (m.address.equals(this.selfAddress)) {
+                if (member.address.equals(this.selfAddress)) {
                     try {
-                        listener(new SelfUp(m));
+                        listener(new SelfUp(member));
                     }
                     catch { /* ignore */ }
                 }
@@ -182,21 +184,21 @@ export class Cluster {
      * the topology".
      */
     getMembers() {
-        return Array.from(this.members.values()).filter((m) => m.status !== 'removed');
+        return Array.from(this.members.values()).filter((member) => member.status !== 'removed');
     }
     /** Members in the `up` state, ordered by address — the "active set". */
     upMembers() {
         return Array.from(this.members.values())
-            .filter(m => m.status === 'up')
+            .filter(member => member.status === 'up')
             .sort((a, b) => a.address.compareTo(b.address));
     }
     /** Reachable members (up + joining + leaving). */
     reachableMembers() {
-        return Array.from(this.members.values()).filter(m => m.isReachable());
+        return Array.from(this.members.values()).filter(member => member.isReachable());
     }
     /** Up members that carry the given role tag. */
     upMembersWithRole(role) {
-        return this.upMembers().filter(m => m.hasRole(role));
+        return this.upMembers().filter(member => member.hasRole(role));
     }
     /** The oldest up-member is the cluster leader (deterministic across nodes). */
     leader() {
@@ -256,23 +258,23 @@ export class Cluster {
         if (!this.started)
             return false;
         const key = typeof addr === 'string' ? addr : addr.toString();
-        const m = this.members.get(key);
-        if (!m)
+        const member = this.members.get(key);
+        if (!member)
             return false;
-        if (m.status === 'down' || m.status === 'removed')
+        if (member.status === 'down' || member.status === 'removed')
             return false;
-        if (m.address.equals(this.selfAddress)) {
+        if (member.address.equals(this.selfAddress)) {
             // Don't try to tombstone ourselves — that's `leave()`'s job.
             return false;
         }
-        const downed = m.withStatus('down');
+        const downed = member.withStatus('down');
         this.updateMember(downed);
         this.emit(new MemberDown(downed));
         const removed = downed.withRemoved(Date.now());
         this.members.set(key, removed);
-        this.failureDetector.forget(m.address);
+        this.failureDetector.forget(member.address);
         this.emit(new MemberRemoved(removed));
-        this.log.info(`operator force-down: ${m.address}`);
+        this.log.info(`operator force-down: ${member.address}`);
         return true;
     }
     /** Gracefully leave the cluster (broadcast `leave`, stop transport). */
@@ -285,10 +287,10 @@ export class Cluster {
             this.updateMember(me.withStatus('leaving'));
         }
         const leaveMsg = { t: 'leave', node: this.selfAddress.toJSON() };
-        const peers = this.reachableMembers().filter((m) => !m.address.equals(this.selfAddress));
+        const peers = this.reachableMembers().filter((member) => !member.address.equals(this.selfAddress));
         this.log.debug(`leaving — sending leave to ${peers.length} reachable peer(s)`);
-        for (const m of peers)
-            this.transport.send(m.address, leaveMsg);
+        for (const member of peers)
+            this.transport.send(member.address, leaveMsg);
         this.gossipTimer?.cancel();
         this.heartbeatTimer?.cancel();
         this.fdTimer?.cancel();
@@ -318,10 +320,10 @@ export class Cluster {
         this.members.set(me.address.toString(), me);
         this.emit(new MemberJoined(me));
         this.log.debug(`self joining: epoch=v${me.version} roles=[${[...this.selfRoles].join(',')}]`);
-        for (const s of seeds) {
-            const a = NodeAddress.parse(s.includes('@') ? s : `${this.system.name}@${s}`);
-            if (!a.equals(this.selfAddress))
-                this.seedAddrs.push(a);
+        for (const seed of seeds) {
+            const address = NodeAddress.parse(seed.includes('@') ? seed : `${this.system.name}@${seed}`);
+            if (!address.equals(this.selfAddress))
+                this.seedAddrs.push(address);
         }
         if (this.seedAddrs.length === 0) {
             // No seeds — we are the first node. Become Up immediately.
@@ -375,11 +377,11 @@ export class Cluster {
     handleWire(from, msg) {
         this.failureDetector.heartbeat(from);
         match(msg)
-            .with({ t: 'heartbeat' }, (m) => this.handleHeartbeat(from, m))
+            .with({ t: 'heartbeat' }, (message) => this.handleHeartbeat(from, message))
             .with({ t: 'heartbeat-ack' }, () => { })
-            .with({ t: 'gossip' }, (m) => this.handleGossip(m))
-            .with({ t: 'envelope' }, (m) => this.handleEnvelope(from, m))
-            .with({ t: 'leave' }, (m) => this.handleLeave(m))
+            .with({ t: 'gossip' }, (message) => this.handleGossip(message))
+            .with({ t: 'envelope' }, (message) => this.handleEnvelope(from, message))
+            .with({ t: 'leave' }, (message) => this.handleLeave(message))
             .otherwise(() => {
             // 'shard-map' and any custom extension wire-msgs handled by the
             // registry; we intentionally fall through when no handler is set.
@@ -410,16 +412,16 @@ export class Cluster {
         }
         // Ensure we know about the sender itself.
         if (!this.members.has(sender.toString())) {
-            const m = new Member(sender, 'joining', 1);
-            this.members.set(sender.toString(), m);
-            this.emit(new MemberJoined(m));
+            const member = new Member(sender, 'joining', 1);
+            this.members.set(sender.toString(), member);
+            this.emit(new MemberJoined(member));
         }
         // Leader promotes joining (and weakly-up) members to up.
         if (this.isLeader()) {
-            for (const m of this.members.values()) {
-                if (m.status === 'joining' || m.status === 'weakly-up') {
-                    this.log.debug(`leader-promote: ${m.address} ${m.status}→up`);
-                    this.updateMember(m.withStatus('up'));
+            for (const member of this.members.values()) {
+                if (member.status === 'joining' || member.status === 'weakly-up') {
+                    this.log.debug(`leader-promote: ${member.address} ${member.status}→up`);
+                    this.updateMember(member.withStatus('up'));
                 }
             }
         }
@@ -520,7 +522,7 @@ export class Cluster {
         this.maybeEmitLeaderChange();
     }
     gossipTick() {
-        const targets = this.reachableMembers().filter(m => !m.address.equals(this.selfAddress));
+        const targets = this.reachableMembers().filter(member => !member.address.equals(this.selfAddress));
         if (targets.length === 0)
             return;
         // Push to one random reachable peer each tick — epidemic style.
@@ -528,7 +530,7 @@ export class Cluster {
         const gossip = {
             t: 'gossip',
             from: this.selfAddress.toJSON(),
-            members: Array.from(this.members.values()).map(m => m.toData()),
+            members: Array.from(this.members.values()).map(member => member.toData()),
         };
         this.transport.send(target.address, gossip);
         // Stock metric: gossip rounds count.
@@ -542,25 +544,25 @@ export class Cluster {
             seq: this.heartbeatSeq,
             ts: Date.now(),
         };
-        for (const m of this.reachableMembers()) {
-            if (m.address.equals(this.selfAddress))
+        for (const member of this.reachableMembers()) {
+            if (member.address.equals(this.selfAddress))
                 continue;
-            this.transport.send(m.address, hb);
+            this.transport.send(member.address, hb);
         }
     }
     failureDetectionTick() {
-        for (const m of Array.from(this.members.values())) {
-            if (m.address.equals(this.selfAddress))
+        for (const member of Array.from(this.members.values())) {
+            if (member.address.equals(this.selfAddress))
                 continue;
-            const decision = this.failureDetector.decide(m.address);
-            if (decision === 'unreachable' && m.status === 'up') {
-                this.log.debug(`FD: ${m.address} → unreachable (heartbeat timeout)`);
-                this.updateMember(m.withStatus('unreachable'));
-                this.emit(new MemberUnreachable(this.members.get(m.address.toString())));
+            const decision = this.failureDetector.decide(member.address);
+            if (decision === 'unreachable' && member.status === 'up') {
+                this.log.debug(`FD: ${member.address} → unreachable (heartbeat timeout)`);
+                this.updateMember(member.withStatus('unreachable'));
+                this.emit(new MemberUnreachable(this.members.get(member.address.toString())));
             }
-            else if (decision === 'down' && m.status !== 'down' && m.status !== 'removed') {
-                this.log.debug(`FD: ${m.address} → down (was ${m.status}); deleting from membership`);
-                const downed = m.withStatus('down');
+            else if (decision === 'down' && member.status !== 'down' && member.status !== 'removed') {
+                this.log.debug(`FD: ${member.address} → down (was ${member.status}); deleting from membership`);
+                const downed = member.withStatus('down');
                 this.updateMember(downed);
                 this.emit(new MemberDown(downed));
                 // Note: FD-driven downing is the *advisory* fallback when no
@@ -570,8 +572,8 @@ export class Cluster {
                 // this.  Definitive downing paths (`handleLeave`,
                 // `evaluateDowning` force-down) tombstone instead, which
                 // prevents stale gossip from resurrecting the address.
-                this.members.delete(m.address.toString());
-                this.failureDetector.forget(m.address);
+                this.members.delete(member.address.toString());
+                this.failureDetector.forget(member.address);
                 // Transient `removed` Member only used for the event emit —
                 // not stored, so the missing `removedAt` here is intentional.
                 const removed = downed.withStatus('removed');
@@ -595,13 +597,13 @@ export class Cluster {
             return;
         const allMembers = Array.from(this.members.values());
         const unreachable = new Set(allMembers
-            .filter((m) => m.status === 'unreachable')
-            .map((m) => m.address.toString()));
+            .filter((member) => member.status === 'unreachable')
+            .map((member) => member.address.toString()));
         // Cheap fingerprint — re-evaluate only when membership or
         // reachability shifts.  The fingerprint includes statuses so a
         // change like "leaving → unreachable" also triggers a re-check.
         const fingerprint = allMembers
-            .map((m) => `${m.address.toString()}:${m.status}`)
+            .map((member) => `${member.address.toString()}:${member.status}`)
             .sort()
             .join('|');
         // Debounce only when the LAST evaluation produced an applied
@@ -638,12 +640,12 @@ export class Cluster {
             // member map.
             if (key === selfKey)
                 continue;
-            const m = this.members.get(key);
-            if (!m)
+            const member = this.members.get(key);
+            if (!member)
                 continue;
-            if (m.status === 'down' || m.status === 'removed')
+            if (member.status === 'down' || member.status === 'removed')
                 continue;
-            const downed = m.withStatus('down');
+            const downed = member.withStatus('down');
             this.updateMember(downed);
             this.emit(new MemberDown(downed));
             // Tombstone (don't delete) so later gossip from peers that
@@ -652,7 +654,7 @@ export class Cluster {
             // after `tombstoneTtlMs` (#75).
             const removed = downed.withRemoved(Date.now());
             this.members.set(key, removed);
-            this.failureDetector.forget(m.address);
+            this.failureDetector.forget(member.address);
             this.emit(new MemberRemoved(removed));
         }
         if (downsSelf) {
@@ -786,17 +788,17 @@ export class Cluster {
             || (prev.isSome() && newLeader.isSome() && !prev.value.address.equals(newLeader.value.address));
         if (changed) {
             this.currentLeader = newLeader;
-            const prevStr = prev.fold(() => 'none', (m) => m.address.toString());
-            const nextStr = newLeader.fold(() => 'none', (m) => m.address.toString());
+            const prevStr = prev.fold(() => 'none', (member) => member.address.toString());
+            const nextStr = newLeader.fold(() => 'none', (member) => member.address.toString());
             this.log.debug(`leader changed: ${prevStr} → ${nextStr}`);
             this.emit(new LeaderChanged(newLeader));
         }
     }
     emit(event) {
         this.system.eventStream.publish(event);
-        for (const l of this._listeners) {
+        for (const listener of this._listeners) {
             try {
-                l(event);
+                listener(event);
             }
             catch (e) {
                 this.log.warn('listener threw', e);
@@ -819,12 +821,12 @@ export class Cluster {
         const now = Date.now();
         const cutoff = Math.max(this.tombstoneTtlMs, this.tombstoneMinRetentionMs);
         let pruned = 0;
-        for (const [key, m] of this.members) {
-            if (m.status !== 'removed')
+        for (const [key, member] of this.members) {
+            if (member.status !== 'removed')
                 continue;
-            if (m.removedAt === undefined)
+            if (member.removedAt === undefined)
                 continue;
-            if (now - m.removedAt < cutoff)
+            if (now - member.removedAt < cutoff)
                 continue;
             this.members.delete(key);
             pruned++;