actor-ts 0.9.1 → 0.10.0

package/dist/discovery/ConfigSeedProvider.d.ts

@@ -1,18 +1,13 @@
 import { NodeAddress } from '../cluster/NodeAddress.js';
+import { ConfigSeedProviderOptions } from './ConfigSeedProviderOptions.js';
 import type { SeedProvider } from './SeedProvider.js';
-export interface ConfigSeedProviderSettings {
-    /** Static list of "system@host:port" or "host:port" strings. */
-    readonly seeds: string[];
-    /** Default system name used when a seed string omits it. */
-    readonly systemName: string;
-}
 /**
  * Simplest `SeedProvider`: returns a fixed list of addresses passed at
  * construction time (typically sourced from config or ENV).
  */
 export declare class ConfigSeedProvider implements SeedProvider {
     private readonly settings;
-    constructor(settings: ConfigSeedProviderSettings);
+    constructor(options?: ConfigSeedProviderOptions);
     lookup(): Promise<NodeAddress[]>;
 }
 /** Read seeds from an environment variable (comma-separated). */

package/dist/discovery/ConfigSeedProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigSeedProvider.d.ts","sourceRoot":"","sources":["../../src/discovery/ConfigSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,0BAA0B;IACzC,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,0BAA0B;IAE3D,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAMvC;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,kBAAkB,CAIpF"}
+{"version":3,"file":"ConfigSeedProvider.d.ts","sourceRoot":"","sources":["../../src/discovery/ConfigSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;gBAE7C,OAAO,GAAE,yBAA8B;IAI7C,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAMvC;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,kBAAkB,CAMpF"}

package/dist/discovery/ConfigSeedProvider.js

@@ -1,12 +1,13 @@
 import { NodeAddress } from '../cluster/NodeAddress.js';
+import { ConfigSeedProviderOptions } from './ConfigSeedProviderOptions.js';
 /**
  * Simplest `SeedProvider`: returns a fixed list of addresses passed at
  * construction time (typically sourced from config or ENV).
  */
 export class ConfigSeedProvider {
     settings;
-    constructor(settings) {
-        this.settings = settings;
+    constructor(options = {}) {
+        this.settings = options;
     }
     async lookup() {
         return this.settings.seeds.map((raw) => {
@@ -19,6 +20,6 @@ export class ConfigSeedProvider {
 export function seedsFromEnv(varName, systemName) {
     const raw = process.env[varName] ?? '';
     const seeds = raw.split(',').map(s => s.trim()).filter(Boolean);
-    return new ConfigSeedProvider({ seeds, systemName });
+    return new ConfigSeedProvider(ConfigSeedProviderOptions.create().withSeeds(seeds).withSystemName(systemName));
 }
 //# sourceMappingURL=ConfigSeedProvider.js.map

package/dist/discovery/ConfigSeedProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigSeedProvider.js","sourceRoot":"","sources":["../../src/discovery/ConfigSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAUxD;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,QAAoC;QAApC,aAAQ,GAAR,QAAQ,CAA4B;IAAG,CAAC;IAErE,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YAC5E,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,UAAkB;IAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChE,OAAO,IAAI,kBAAkB,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;AACvD,CAAC"}
+{"version":3,"file":"ConfigSeedProvider.js","sourceRoot":"","sources":["../../src/discovery/ConfigSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAI3E;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACZ,QAAQ,CAAgC;IAEzD,YAAY,UAAqC,EAAE;QACjD,IAAI,CAAC,QAAQ,GAAG,OAAwC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YAC5E,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,UAAkB;IAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChE,OAAO,IAAI,kBAAkB,CAC3B,yBAAyB,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAC/E,CAAC;AACJ,CAAC"}

package/dist/discovery/ConfigSeedProviderOptions.d.ts

@@ -0,0 +1,34 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/** Plain settings-object shape accepted by a {@link ConfigSeedProvider}. */
+export interface ConfigSeedProviderOptionsType {
+    /** Static list of "system@host:port" or "host:port" strings. */
+    readonly seeds: string[];
+    /** Default system name used when a seed string omits it. */
+    readonly systemName: string;
+}
+/**
+ * Fluent builder for {@link ConfigSeedProviderOptionsType}.
+ *
+ *     new ConfigSeedProvider(
+ *       ConfigSeedProviderOptions.create()
+ *         .withSeeds(['a@host1:2552', 'host2:2552'])
+ *         .withSystemName('my-system'),
+ *     );
+ */
+export declare class ConfigSeedProviderOptionsBuilder extends OptionsBuilder<ConfigSeedProviderOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new ConfigSeedProviderOptionsBuilder()`. */
+    static create(): ConfigSeedProviderOptionsBuilder;
+    /** Static list of "system@host:port" or "host:port" strings. */
+    withSeeds(seeds: string[]): this;
+    /** Default system name used when a seed string omits it. */
+    withSystemName(systemName: string): this;
+}
+/**
+ * Accepted input for the {@link ConfigSeedProvider} constructor: the fluent
+ * {@link ConfigSeedProviderOptionsBuilder} OR a plain
+ * {@link ConfigSeedProviderOptionsType} object.
+ */
+export type ConfigSeedProviderOptions = ConfigSeedProviderOptionsBuilder | Partial<ConfigSeedProviderOptionsType>;
+/** Value alias so `ConfigSeedProviderOptions.create()` / `new ConfigSeedProviderOptions()` resolve to the builder. */
+export declare const ConfigSeedProviderOptions: typeof ConfigSeedProviderOptionsBuilder;
+//# sourceMappingURL=ConfigSeedProviderOptions.d.ts.map

package/dist/discovery/ConfigSeedProviderOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigSeedProviderOptions.d.ts","sourceRoot":"","sources":["../../src/discovery/ConfigSeedProviderOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,4EAA4E;AAC5E,MAAM,WAAW,6BAA6B;IAC5C,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,qBAAa,gCAAiC,SAAQ,cAAc,CAAC,6BAA6B,CAAC;IACjG,sFAAsF;IACtF,MAAM,CAAC,MAAM,IAAI,gCAAgC;IAIjD,gEAAgE;IAChE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIhC,4DAA4D;IAC5D,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAGzC;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,gCAAgC,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;AAClH,sHAAsH;AACtH,eAAO,MAAM,yBAAyB,yCAAmC,CAAC"}

package/dist/discovery/ConfigSeedProviderOptions.js

@@ -0,0 +1,27 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link ConfigSeedProviderOptionsType}.
+ *
+ *     new ConfigSeedProvider(
+ *       ConfigSeedProviderOptions.create()
+ *         .withSeeds(['a@host1:2552', 'host2:2552'])
+ *         .withSystemName('my-system'),
+ *     );
+ */
+export class ConfigSeedProviderOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new ConfigSeedProviderOptionsBuilder()`. */
+    static create() {
+        return new ConfigSeedProviderOptionsBuilder();
+    }
+    /** Static list of "system@host:port" or "host:port" strings. */
+    withSeeds(seeds) {
+        return this.set('seeds', seeds);
+    }
+    /** Default system name used when a seed string omits it. */
+    withSystemName(systemName) {
+        return this.set('systemName', systemName);
+    }
+}
+/** Value alias so `ConfigSeedProviderOptions.create()` / `new ConfigSeedProviderOptions()` resolve to the builder. */
+export const ConfigSeedProviderOptions = ConfigSeedProviderOptionsBuilder;
+//# sourceMappingURL=ConfigSeedProviderOptions.js.map

package/dist/discovery/ConfigSeedProviderOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigSeedProviderOptions.js","sourceRoot":"","sources":["../../src/discovery/ConfigSeedProviderOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAU3D;;;;;;;;GAQG;AACH,MAAM,OAAO,gCAAiC,SAAQ,cAA6C;IACjG,sFAAsF;IACtF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,gCAAgC,EAAE,CAAC;IAChD,CAAC;IAED,gEAAgE;IAChE,SAAS,CAAC,KAAe;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,4DAA4D;IAC5D,cAAc,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;CACF;AAQD,sHAAsH;AACtH,MAAM,CAAC,MAAM,yBAAyB,GAAG,gCAAgC,CAAC"}

package/dist/discovery/DnsSeedProvider.d.ts

@@ -1,30 +1,6 @@
 import { NodeAddress } from '../cluster/NodeAddress.js';
+import type { DnsSeedProviderOptions } from './DnsSeedProviderOptions.js';
 import type { SeedProvider } from './SeedProvider.js';
-export interface DnsSeedProviderSettings {
-    /** Hostname to resolve (e.g. `my-cluster.default.svc.cluster.local`). */
-    readonly hostname: string;
-    /** System name to stamp on discovered NodeAddresses. */
-    readonly systemName: string;
-    /** Port each discovered IP should be paired with. */
-    readonly port: number;
-    /** Override the DNS-resolve function — defaults to `node:dns/promises`. */
-    readonly resolve?: (hostname: string) => Promise<string[]>;
-    /** When using SRV records, override `resolveSrv` similarly. */
-    readonly resolveSrv?: (hostname: string) => Promise<Array<{
-        name: string;
-        port: number;
-    }>>;
-    /** If true, prefer SRV records (which carry a port) over A. */
-    readonly useSrv?: boolean;
-    /**
-     * In-process TTL cache for DNS lookups.  Deliberately *not* a
-     * distributed cache — DNS resolution is a per-process concern, and a
-     * Redis hop here would cost more than the lookup itself.  Default:
-     * 60_000 ms.  Set `0` to disable.  Failures are NOT cached: a query
-     * that throws will retry on the next call.
-     */
-    readonly cacheTtlMs?: number;
-}
 /**
  * Seed provider backed by DNS.  Default mode resolves A records and pairs
  * each IP with the configured port; SRV mode picks up `name:port` directly.
@@ -37,10 +13,10 @@ export interface DnsSeedProviderSettings {
  * DNS load on large clusters where each node polls the same name.
  */
 export declare class DnsSeedProvider implements SeedProvider {
-    private readonly settings;
     private cached;
     private readonly cacheTtlMs;
-    constructor(settings: DnsSeedProviderSettings);
+    private readonly settings;
+    constructor(options?: DnsSeedProviderOptions);
     lookup(): Promise<NodeAddress[]>;
     /** Test hook — drop the cached entry so the next `lookup()` re-queries DNS. */
     invalidateCacheForTest(): void;

package/dist/discovery/DnsSeedProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DnsSeedProvider.d.ts","sourceRoot":"","sources":["../../src/discovery/DnsSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC3F,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAItC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAHrC,OAAO,CAAC,MAAM,CAA4D;IAC1E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAEP,QAAQ,EAAE,uBAAuB;IAOxD,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAYtC,+EAA+E;IAC/E,sBAAsB,IAAI,IAAI;YAEhB,QAAQ;CAUvB"}
+{"version":3,"file":"DnsSeedProvider.d.ts","sourceRoot":"","sources":["../../src/discovery/DnsSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAA8B,MAAM,6BAA6B,CAAC;AACtG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,MAAM,CAA4D;IAC1E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;gBAE1C,OAAO,GAAE,sBAA2B;IAQ1C,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAYtC,+EAA+E;IAC/E,sBAAsB,IAAI,IAAI;YAEhB,QAAQ;CAUvB"}

package/dist/discovery/DnsSeedProvider.js

@@ -11,12 +11,12 @@ import { NodeAddress } from '../cluster/NodeAddress.js';
  * DNS load on large clusters where each node polls the same name.
  */
 export class DnsSeedProvider {
-    settings;
     cached = null;
     cacheTtlMs;
-    constructor(settings) {
-        this.settings = settings;
-        this.cacheTtlMs = settings.cacheTtlMs ?? 60_000;
+    settings;
+    constructor(options = {}) {
+        this.settings = options;
+        this.cacheTtlMs = this.settings.cacheTtlMs ?? 60_000;
         if (!Number.isFinite(this.cacheTtlMs) || this.cacheTtlMs < 0) {
             throw new Error(`DnsSeedProvider: cacheTtlMs must be a non-negative finite number, got ${this.cacheTtlMs}`);
         }

package/dist/discovery/DnsSeedProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"DnsSeedProvider.js","sourceRoot":"","sources":["../../src/discovery/DnsSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AA0BxD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,eAAe;IAIG;IAHrB,MAAM,GAAuD,IAAI,CAAC;IACzD,UAAU,CAAS;IAEpC,YAA6B,QAAiC;QAAjC,aAAQ,GAAR,QAAQ,CAAyB;QAC5D,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,MAAM,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,yEAAyE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9G,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+EAA+E;IAC/E,sBAAsB,KAAW,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IAE9C,KAAK,CAAC,QAAQ;QACpB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,iBAAiB,CAAC;YACjE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACzD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,cAAc,CAAC;QACxD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClD,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1F,CAAC;CACF;AAED,KAAK,UAAU,cAAc,CAAC,QAAgB;IAC5C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC9C,OAAO,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IAC/C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"DnsSeedProvider.js","sourceRoot":"","sources":["../../src/discovery/DnsSeedProvider.ts"],"names":[],"mappings":"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"}

package/dist/discovery/DnsSeedProviderOptions.d.ts

@@ -0,0 +1,67 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/** Plain settings-object shape accepted by a {@link DnsSeedProvider}. */
+export interface DnsSeedProviderOptionsType {
+    /** Hostname to resolve (e.g. `my-cluster.default.svc.cluster.local`). */
+    readonly hostname: string;
+    /** System name to stamp on discovered NodeAddresses. */
+    readonly systemName: string;
+    /** Port each discovered IP should be paired with. */
+    readonly port: number;
+    /** Override the DNS-resolve function — defaults to `node:dns/promises`. */
+    readonly resolve?: (hostname: string) => Promise<string[]>;
+    /** When using SRV records, override `resolveSrv` similarly. */
+    readonly resolveSrv?: (hostname: string) => Promise<Array<{
+        name: string;
+        port: number;
+    }>>;
+    /** If true, prefer SRV records (which carry a port) over A. */
+    readonly useSrv?: boolean;
+    /**
+     * In-process TTL cache for DNS lookups.  Deliberately *not* a
+     * distributed cache — DNS resolution is a per-process concern, and a
+     * Redis hop here would cost more than the lookup itself.  Default:
+     * 60_000 ms.  Set `0` to disable.  Failures are NOT cached: a query
+     * that throws will retry on the next call.
+     */
+    readonly cacheTtlMs?: number;
+}
+/**
+ * Fluent builder for {@link DnsSeedProviderOptionsType}.
+ *
+ *     new DnsSeedProvider(
+ *       DnsSeedProviderOptions.create()
+ *         .withHostname('svc.default.svc.cluster.local')
+ *         .withSystemName('my-system')
+ *         .withPort(2552),
+ *     );
+ */
+export declare class DnsSeedProviderOptionsBuilder extends OptionsBuilder<DnsSeedProviderOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new DnsSeedProviderOptionsBuilder()`. */
+    static create(): DnsSeedProviderOptionsBuilder;
+    /** Hostname to resolve (e.g. `my-cluster.default.svc.cluster.local`). */
+    withHostname(hostname: string): this;
+    /** System name to stamp on discovered NodeAddresses. */
+    withSystemName(systemName: string): this;
+    /** Port each discovered IP should be paired with. */
+    withPort(port: number): this;
+    /** Override the DNS-resolve function — defaults to `node:dns/promises`. */
+    withResolve(resolve: (hostname: string) => Promise<string[]>): this;
+    /** When using SRV records, override `resolveSrv` similarly. */
+    withResolveSrv(resolveSrv: (hostname: string) => Promise<Array<{
+        name: string;
+        port: number;
+    }>>): this;
+    /** If true, prefer SRV records (which carry a port) over A. */
+    withUseSrv(useSrv?: boolean): this;
+    /** In-process TTL cache for DNS lookups.  Default 60_000 ms; `0` disables. */
+    withCacheTtlMs(cacheTtlMs: number): this;
+}
+/**
+ * Accepted input for the {@link DnsSeedProvider} constructor: the fluent
+ * {@link DnsSeedProviderOptionsBuilder} OR a plain
+ * {@link DnsSeedProviderOptionsType} object.
+ */
+export type DnsSeedProviderOptions = DnsSeedProviderOptionsBuilder | Partial<DnsSeedProviderOptionsType>;
+/** Value alias so `DnsSeedProviderOptions.create()` / `new DnsSeedProviderOptions()` resolve to the builder. */
+export declare const DnsSeedProviderOptions: typeof DnsSeedProviderOptionsBuilder;
+//# sourceMappingURL=DnsSeedProviderOptions.d.ts.map

package/dist/discovery/DnsSeedProviderOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DnsSeedProviderOptions.d.ts","sourceRoot":"","sources":["../../src/discovery/DnsSeedProviderOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,yEAAyE;AACzE,MAAM,WAAW,0BAA0B;IACzC,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC3F,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,qBAAa,6BAA8B,SAAQ,cAAc,CAAC,0BAA0B,CAAC;IAC3F,mFAAmF;IACnF,MAAM,CAAC,MAAM,IAAI,6BAA6B;IAI9C,yEAAyE;IACzE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC,wDAAwD;IACxD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIxC,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,2EAA2E;IAC3E,WAAW,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI;IAInE,+DAA+D;IAC/D,cAAc,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,GAAG,IAAI;IAItG,+DAA+D;IAC/D,UAAU,CAAC,MAAM,UAAO,GAAG,IAAI;IAI/B,8EAA8E;IAC9E,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAGzC;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,6BAA6B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;AACzG,gHAAgH;AAChH,eAAO,MAAM,sBAAsB,sCAAgC,CAAC"}

package/dist/discovery/DnsSeedProviderOptions.js

@@ -0,0 +1,48 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link DnsSeedProviderOptionsType}.
+ *
+ *     new DnsSeedProvider(
+ *       DnsSeedProviderOptions.create()
+ *         .withHostname('svc.default.svc.cluster.local')
+ *         .withSystemName('my-system')
+ *         .withPort(2552),
+ *     );
+ */
+export class DnsSeedProviderOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new DnsSeedProviderOptionsBuilder()`. */
+    static create() {
+        return new DnsSeedProviderOptionsBuilder();
+    }
+    /** Hostname to resolve (e.g. `my-cluster.default.svc.cluster.local`). */
+    withHostname(hostname) {
+        return this.set('hostname', hostname);
+    }
+    /** System name to stamp on discovered NodeAddresses. */
+    withSystemName(systemName) {
+        return this.set('systemName', systemName);
+    }
+    /** Port each discovered IP should be paired with. */
+    withPort(port) {
+        return this.set('port', port);
+    }
+    /** Override the DNS-resolve function — defaults to `node:dns/promises`. */
+    withResolve(resolve) {
+        return this.set('resolve', resolve);
+    }
+    /** When using SRV records, override `resolveSrv` similarly. */
+    withResolveSrv(resolveSrv) {
+        return this.set('resolveSrv', resolveSrv);
+    }
+    /** If true, prefer SRV records (which carry a port) over A. */
+    withUseSrv(useSrv = true) {
+        return this.set('useSrv', useSrv);
+    }
+    /** In-process TTL cache for DNS lookups.  Default 60_000 ms; `0` disables. */
+    withCacheTtlMs(cacheTtlMs) {
+        return this.set('cacheTtlMs', cacheTtlMs);
+    }
+}
+/** Value alias so `DnsSeedProviderOptions.create()` / `new DnsSeedProviderOptions()` resolve to the builder. */
+export const DnsSeedProviderOptions = DnsSeedProviderOptionsBuilder;
+//# sourceMappingURL=DnsSeedProviderOptions.js.map

package/dist/discovery/DnsSeedProviderOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DnsSeedProviderOptions.js","sourceRoot":"","sources":["../../src/discovery/DnsSeedProviderOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA0B3D;;;;;;;;;GASG;AACH,MAAM,OAAO,6BAA8B,SAAQ,cAA0C;IAC3F,mFAAmF;IACnF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,6BAA6B,EAAE,CAAC;IAC7C,CAAC;IAED,yEAAyE;IACzE,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,wDAAwD;IACxD,cAAc,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,qDAAqD;IACrD,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,2EAA2E;IAC3E,WAAW,CAAC,OAAgD;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,+DAA+D;IAC/D,cAAc,CAAC,UAAgF;QAC7F,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,+DAA+D;IAC/D,UAAU,CAAC,MAAM,GAAG,IAAI;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,8EAA8E;IAC9E,cAAc,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;CACF;AAQD,gHAAgH;AAChH,MAAM,CAAC,MAAM,sBAAsB,GAAG,6BAA6B,CAAC"}

package/dist/discovery/KubernetesApiSeedProvider.d.ts

@@ -1,17 +1,6 @@
 import { NodeAddress } from '../cluster/NodeAddress.js';
+import type { KubernetesApiSeedProviderOptions } from './KubernetesApiSeedProviderOptions.js';
 import type { SeedProvider } from './SeedProvider.js';
-export interface KubernetesApiSeedProviderSettings {
-    /** Target namespace to look up endpoints in. */
-    readonly namespace: string;
-    /** Service or Endpoints name whose backing pods provide the cluster. */
-    readonly serviceName: string;
-    /** System name stamped on the discovered NodeAddresses. */
-    readonly systemName: string;
-    /** Port for the cluster remoting endpoint on each pod. */
-    readonly port: number;
-    /** Override the Endpoints-fetch function — defaults to the in-cluster API. */
-    readonly fetchEndpoints?: () => Promise<string[]>;
-}
 /**
  * Seed provider driven by the Kubernetes API.  Reads the Endpoints object
  * for a headless Service (or any Service) and extracts the ready pod IPs.
@@ -24,7 +13,7 @@ export interface KubernetesApiSeedProviderSettings {
  */
 export declare class KubernetesApiSeedProvider implements SeedProvider {
     private readonly settings;
-    constructor(settings: KubernetesApiSeedProviderSettings);
+    constructor(options?: KubernetesApiSeedProviderOptions);
     lookup(): Promise<NodeAddress[]>;
 }
 //# sourceMappingURL=KubernetesApiSeedProvider.d.ts.map

package/dist/discovery/KubernetesApiSeedProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KubernetesApiSeedProvider.d.ts","sourceRoot":"","sources":["../../src/discovery/KubernetesApiSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,iCAAiC;IAChD,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACnD;AAED;;;;;;;;;GASG;AACH,qBAAa,yBAA0B,YAAW,YAAY;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,iCAAiC;IAElE,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAKvC"}
+{"version":3,"file":"KubernetesApiSeedProvider.d.ts","sourceRoot":"","sources":["../../src/discovery/KubernetesApiSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,gCAAgC,EAAwC,MAAM,uCAAuC,CAAC;AACpI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;GASG;AACH,qBAAa,yBAA0B,YAAW,YAAY;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;gBAEpD,OAAO,GAAE,gCAAqC;IAIpD,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAKvC"}

package/dist/discovery/KubernetesApiSeedProvider.js

@@ -11,8 +11,8 @@ import { NodeAddress } from '../cluster/NodeAddress.js';
  */
 export class KubernetesApiSeedProvider {
     settings;
-    constructor(settings) {
-        this.settings = settings;
+    constructor(options = {}) {
+        this.settings = options;
     }
     async lookup() {
         const fetchEndpoints = this.settings.fetchEndpoints ?? defaultFetchEndpoints(this.settings);

package/dist/discovery/KubernetesApiSeedProvider.js.map

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

package/dist/discovery/KubernetesApiSeedProviderOptions.d.ts

@@ -0,0 +1,46 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/** Plain settings-object shape accepted by a {@link KubernetesApiSeedProvider}. */
+export interface KubernetesApiSeedProviderOptionsType {
+    /** Target namespace to look up endpoints in. */
+    readonly namespace: string;
+    /** Service or Endpoints name whose backing pods provide the cluster. */
+    readonly serviceName: string;
+    /** System name stamped on the discovered NodeAddresses. */
+    readonly systemName: string;
+    /** Port for the cluster remoting endpoint on each pod. */
+    readonly port: number;
+    /** Override the Endpoints-fetch function — defaults to the in-cluster API. */
+    readonly fetchEndpoints?: () => Promise<string[]>;
+}
+/**
+ * Fluent builder for {@link KubernetesApiSeedProviderOptionsType}.
+ *
+ *     new KubernetesApiSeedProvider(
+ *       KubernetesApiSeedProviderOptions.create()
+ *         .withNamespace('actors').withServiceName('my-svc')
+ *         .withSystemName('my-system').withPort(2552),
+ *     );
+ */
+export declare class KubernetesApiSeedProviderOptionsBuilder extends OptionsBuilder<KubernetesApiSeedProviderOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new KubernetesApiSeedProviderOptionsBuilder()`. */
+    static create(): KubernetesApiSeedProviderOptionsBuilder;
+    /** Target namespace to look up endpoints in. */
+    withNamespace(namespace: string): this;
+    /** Service or Endpoints name whose backing pods provide the cluster. */
+    withServiceName(serviceName: string): this;
+    /** System name stamped on the discovered NodeAddresses. */
+    withSystemName(systemName: string): this;
+    /** Port for the cluster remoting endpoint on each pod. */
+    withPort(port: number): this;
+    /** Override the Endpoints-fetch function — defaults to the in-cluster API. */
+    withFetchEndpoints(fetchEndpoints: () => Promise<string[]>): this;
+}
+/**
+ * Accepted input for the {@link KubernetesApiSeedProvider} constructor: the
+ * fluent {@link KubernetesApiSeedProviderOptionsBuilder} OR a plain
+ * {@link KubernetesApiSeedProviderOptionsType} object.
+ */
+export type KubernetesApiSeedProviderOptions = KubernetesApiSeedProviderOptionsBuilder | Partial<KubernetesApiSeedProviderOptionsType>;
+/** Value alias so `KubernetesApiSeedProviderOptions.create()` / `new KubernetesApiSeedProviderOptions()` resolve to the builder. */
+export declare const KubernetesApiSeedProviderOptions: typeof KubernetesApiSeedProviderOptionsBuilder;
+//# sourceMappingURL=KubernetesApiSeedProviderOptions.d.ts.map

package/dist/discovery/KubernetesApiSeedProviderOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KubernetesApiSeedProviderOptions.d.ts","sourceRoot":"","sources":["../../src/discovery/KubernetesApiSeedProviderOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,mFAAmF;AACnF,MAAM,WAAW,oCAAoC;IACnD,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACnD;AAED;;;;;;;;GAQG;AACH,qBAAa,uCAAwC,SAAQ,cAAc,CAAC,oCAAoC,CAAC;IAC/G,6FAA6F;IAC7F,MAAM,CAAC,MAAM,IAAI,uCAAuC;IAIxD,gDAAgD;IAChD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAItC,wEAAwE;IACxE,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI1C,2DAA2D;IAC3D,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIxC,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,8EAA8E;IAC9E,kBAAkB,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI;CAGlE;AAED;;;;GAIG;AACH,MAAM,MAAM,gCAAgC,GACxC,uCAAuC,GACvC,OAAO,CAAC,oCAAoC,CAAC,CAAC;AAClD,oIAAoI;AACpI,eAAO,MAAM,gCAAgC,gDAA0C,CAAC"}

package/dist/discovery/KubernetesApiSeedProviderOptions.js

@@ -0,0 +1,39 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link KubernetesApiSeedProviderOptionsType}.
+ *
+ *     new KubernetesApiSeedProvider(
+ *       KubernetesApiSeedProviderOptions.create()
+ *         .withNamespace('actors').withServiceName('my-svc')
+ *         .withSystemName('my-system').withPort(2552),
+ *     );
+ */
+export class KubernetesApiSeedProviderOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new KubernetesApiSeedProviderOptionsBuilder()`. */
+    static create() {
+        return new KubernetesApiSeedProviderOptionsBuilder();
+    }
+    /** Target namespace to look up endpoints in. */
+    withNamespace(namespace) {
+        return this.set('namespace', namespace);
+    }
+    /** Service or Endpoints name whose backing pods provide the cluster. */
+    withServiceName(serviceName) {
+        return this.set('serviceName', serviceName);
+    }
+    /** System name stamped on the discovered NodeAddresses. */
+    withSystemName(systemName) {
+        return this.set('systemName', systemName);
+    }
+    /** Port for the cluster remoting endpoint on each pod. */
+    withPort(port) {
+        return this.set('port', port);
+    }
+    /** Override the Endpoints-fetch function — defaults to the in-cluster API. */
+    withFetchEndpoints(fetchEndpoints) {
+        return this.set('fetchEndpoints', fetchEndpoints);
+    }
+}
+/** Value alias so `KubernetesApiSeedProviderOptions.create()` / `new KubernetesApiSeedProviderOptions()` resolve to the builder. */
+export const KubernetesApiSeedProviderOptions = KubernetesApiSeedProviderOptionsBuilder;
+//# sourceMappingURL=KubernetesApiSeedProviderOptions.js.map

package/dist/discovery/KubernetesApiSeedProviderOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KubernetesApiSeedProviderOptions.js","sourceRoot":"","sources":["../../src/discovery/KubernetesApiSeedProviderOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAgB3D;;;;;;;;GAQG;AACH,MAAM,OAAO,uCAAwC,SAAQ,cAAoD;IAC/G,6FAA6F;IAC7F,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,uCAAuC,EAAE,CAAC;IACvD,CAAC;IAED,gDAAgD;IAChD,aAAa,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,wEAAwE;IACxE,eAAe,CAAC,WAAmB;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,2DAA2D;IAC3D,cAAc,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,0DAA0D;IAC1D,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,8EAA8E;IAC9E,kBAAkB,CAAC,cAAuC;QACxD,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IACpD,CAAC;CACF;AAUD,oIAAoI;AACpI,MAAM,CAAC,MAAM,gCAAgC,GAAG,uCAAuC,CAAC"}

package/dist/discovery/Receptionist.d.ts

@@ -1,4 +1,5 @@
 import { Actor } from '../Actor.js';
+import type { ReceptionistOptions } from './ReceptionistOptions.js';
 import { type Option } from '../util/Option.js';
 import type { ActorRef } from '../ActorRef.js';
 import type { ActorSystem } from '../ActorSystem.js';
@@ -6,10 +7,6 @@ import { type ExtensionId } from '../Extension.js';
 import type { Cluster } from '../cluster/Cluster.js';
 import { Deregister, Find, Register, Subscribe, Unsubscribe } from './ReceptionistMessages.js';
 type Msg = Register | Deregister | Find | Subscribe | Unsubscribe;
-export interface ReceptionistSettings {
-    readonly cluster?: Cluster | null;
-    readonly gossipIntervalMs?: number;
-}
 /**
  * Cluster-wide service registry.  Each node hosts one Receptionist actor.
  * Register/Deregister are authoritative locally; peers learn about
@@ -26,7 +23,7 @@ export declare class Receptionist extends Actor<Msg> {
     private gossipTimer;
     private unsubWire;
     private unsubCluster;
-    constructor(settings: ReceptionistSettings);
+    constructor(options?: ReceptionistOptions);
     preStart(): void;
     postStop(): void;
     onReceive(msg: Msg): void;
@@ -47,7 +44,7 @@ export declare class ReceptionistExtension {
     private readonly system;
     private started;
     constructor(system: ActorSystem);
-    start(cluster?: Cluster | null, settings?: Omit<ReceptionistSettings, 'cluster'>): ActorRef<Msg>;
+    start(cluster?: Cluster | null, options?: ReceptionistOptions): ActorRef<Msg>;
     get(): Option<ActorRef<Msg>>;
 }
 export declare const ReceptionistId: ExtensionId<ReceptionistExtension>;

package/dist/discovery/Receptionist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Receptionist.d.ts","sourceRoot":"","sources":["../../src/discovery/Receptionist.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAIrD,OAAO,EACL,UAAU,EACV,IAAI,EAEJ,QAAQ,EAER,SAAS,EACT,WAAW,EAEZ,MAAM,2BAA2B,CAAC;AAGnC,KAAK,GAAG,GACJ,QAAQ,GACR,UAAU,GACV,IAAI,GACJ,SAAS,GACT,WAAW,CAAC;AAWhB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,qBAAa,YAAa,SAAQ,KAAK,CAAC,GAAG,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,YAAY,CAA6B;gBAErC,QAAQ,EAAE,oBAAoB;IAMjC,QAAQ,IAAI,IAAI;IAiBhB,QAAQ,IAAI,IAAI;IAMhB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAYlC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,iBAAiB;CAK1B;AAID,qBAAa,qBAAqB;IAEpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IADnC,OAAO,CAAC,OAAO,CAA8B;gBAChB,MAAM,EAAE,WAAW;IAEhD,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,EAAE,QAAQ,GAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAM,GAAG,QAAQ,CAAC,GAAG,CAAC;IAUpG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;CAC7B;AAED,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,qBAAqB,CAG7D,CAAC"}
+{"version":3,"file":"Receptionist.d.ts","sourceRoot":"","sources":["../../src/discovery/Receptionist.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,KAAK,EAAE,mBAAmB,EAA2B,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAIrD,OAAO,EACL,UAAU,EACV,IAAI,EAEJ,QAAQ,EAER,SAAS,EACT,WAAW,EAEZ,MAAM,2BAA2B,CAAC;AAGnC,KAAK,GAAG,GACJ,QAAQ,GACR,UAAU,GACV,IAAI,GACJ,SAAS,GACT,WAAW,CAAC;AAWhB;;;;;;;GAOG;AACH,qBAAa,YAAa,SAAQ,KAAK,CAAC,GAAG,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,YAAY,CAA6B;gBAErC,OAAO,GAAE,mBAAwB;IAOpC,QAAQ,IAAI,IAAI;IAiBhB,QAAQ,IAAI,IAAI;IAMhB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAYlC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,iBAAiB;CAK1B;AAID,qBAAa,qBAAqB;IAEpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IADnC,OAAO,CAAC,OAAO,CAA8B;gBAChB,MAAM,EAAE,WAAW;IAEhD,KAAK,CACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,EACxB,OAAO,GAAE,mBAAwB,GAChC,QAAQ,CAAC,GAAG,CAAC;IAgBhB,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;CAC7B;AAED,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,qBAAqB,CAG7D,CAAC"}

package/dist/discovery/Receptionist.js

@@ -25,8 +25,9 @@ export class Receptionist extends Actor {
     gossipTimer = null;
     unsubWire = null;
     unsubCluster = null;
-    constructor(settings) {
+    constructor(options = {}) {
         super();
+        const settings = options;
         this.clusterRef = settings.cluster ?? null;
         this.gossipIntervalMs = settings.gossipIntervalMs ?? DEFAULT_GOSSIP_INTERVAL_MS;
     }
@@ -194,10 +195,16 @@ export class ReceptionistExtension {
     constructor(system) {
         this.system = system;
     }
-    start(cluster, settings = {}) {
+    start(cluster, options = {}) {
         if (this.started)
             return this.started;
-        const ref = this.system.spawn(Props.create(() => new Receptionist({ cluster: cluster ?? null, ...settings })), 'receptionist');
+        // `cluster` stays a positional arg (it's identity/wiring, not a tunable);
+        // fold it onto the resolved settings so the actor sees a single object.
+        const settings = {
+            ...options,
+            cluster: cluster ?? null,
+        };
+        const ref = this.system.spawn(Props.create(() => new Receptionist(settings)), 'receptionist');
         this.started = ref;
         return ref;
     }