actor-ts 0.9.1 → 0.10.0

package/dist/discovery/Receptionist.js.map

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

package/dist/discovery/ReceptionistOptions.d.ts

@@ -0,0 +1,30 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import type { Cluster } from '../cluster/Cluster.js';
+/** Plain settings-object shape accepted by a {@link Receptionist}. */
+export interface ReceptionistOptionsType {
+    readonly cluster?: Cluster | null;
+    readonly gossipIntervalMs?: number;
+}
+/**
+ * Fluent builder for {@link ReceptionistOptionsType}.  Normally you don't
+ * touch this directly — `system.extension(ReceptionistId).start(cluster,
+ * options)` supplies the `cluster` positionally and only the tunables
+ * (`withGossipIntervalMs`) come through the builder.
+ */
+export declare class ReceptionistOptionsBuilder extends OptionsBuilder<ReceptionistOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new ReceptionistOptionsBuilder()`. */
+    static create(): ReceptionistOptionsBuilder;
+    /** The cluster this receptionist gossips over.  `null` = single-node (no gossip). */
+    withCluster(cluster: Cluster | null): this;
+    /** Interval between gossip pushes in milliseconds.  Default: cluster gossip interval. */
+    withGossipIntervalMs(gossipIntervalMs: number): this;
+}
+/**
+ * Accepted input for the {@link Receptionist} constructor: the fluent
+ * {@link ReceptionistOptionsBuilder} OR a plain {@link ReceptionistOptionsType}
+ * object.
+ */
+export type ReceptionistOptions = ReceptionistOptionsBuilder | Partial<ReceptionistOptionsType>;
+/** Value alias so `ReceptionistOptions.create()` / `new ReceptionistOptions()` resolve to the builder. */
+export declare const ReceptionistOptions: typeof ReceptionistOptionsBuilder;
+//# sourceMappingURL=ReceptionistOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReceptionistOptions.d.ts","sourceRoot":"","sources":["../../src/discovery/ReceptionistOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,sEAAsE;AACtE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;;;GAKG;AACH,qBAAa,0BAA2B,SAAQ,cAAc,CAAC,uBAAuB,CAAC;IACrF,gFAAgF;IAChF,MAAM,CAAC,MAAM,IAAI,0BAA0B;IAI3C,qFAAqF;IACrF,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI;IAI1C,yFAAyF;IACzF,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;CAGrD;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,0BAA0B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAChG,0GAA0G;AAC1G,eAAO,MAAM,mBAAmB,mCAA6B,CAAC"}

package/dist/discovery/ReceptionistOptions.js

@@ -0,0 +1,24 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link ReceptionistOptionsType}.  Normally you don't
+ * touch this directly — `system.extension(ReceptionistId).start(cluster,
+ * options)` supplies the `cluster` positionally and only the tunables
+ * (`withGossipIntervalMs`) come through the builder.
+ */
+export class ReceptionistOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new ReceptionistOptionsBuilder()`. */
+    static create() {
+        return new ReceptionistOptionsBuilder();
+    }
+    /** The cluster this receptionist gossips over.  `null` = single-node (no gossip). */
+    withCluster(cluster) {
+        return this.set('cluster', cluster);
+    }
+    /** Interval between gossip pushes in milliseconds.  Default: cluster gossip interval. */
+    withGossipIntervalMs(gossipIntervalMs) {
+        return this.set('gossipIntervalMs', gossipIntervalMs);
+    }
+}
+/** Value alias so `ReceptionistOptions.create()` / `new ReceptionistOptions()` resolve to the builder. */
+export const ReceptionistOptions = ReceptionistOptionsBuilder;
+//# sourceMappingURL=ReceptionistOptions.js.map

package/dist/discovery/ReceptionistOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReceptionistOptions.js","sourceRoot":"","sources":["../../src/discovery/ReceptionistOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAS3D;;;;;GAKG;AACH,MAAM,OAAO,0BAA2B,SAAQ,cAAuC;IACrF,gFAAgF;IAChF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,0BAA0B,EAAE,CAAC;IAC1C,CAAC;IAED,qFAAqF;IACrF,WAAW,CAAC,OAAuB;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,yFAAyF;IACzF,oBAAoB,CAAC,gBAAwB;QAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;IACxD,CAAC;CACF;AAQD,0GAA0G;AAC1G,MAAM,CAAC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC"}

package/dist/discovery/autoDiscovery.d.ts

@@ -1,47 +1,6 @@
 import { AggregateSeedProvider } from './AggregateSeedProvider.js';
+import type { AutoDiscoveryOptions } from './AutoDiscoveryOptions.js';
 import type { SeedProvider } from './SeedProvider.js';
-/**
- * Env-driven defaults for the standard production deployment shapes.
- * Recognised environment variables (none required — every layer is
- * optional, the helper returns whatever providers the env supports):
- *
- *   - `CLUSTER_SEEDS`         — comma-separated `[system@]host:port` list.
- *                               Strongest signal; if present, the
- *                               `ConfigSeedProvider` is preferred over the
- *                               service-discovery layers.
- *   - `CLUSTER_SERVICE_NAME`  — name of the service whose members are
- *                               this cluster's peers.  Drives both the
- *                               `KubernetesApiSeedProvider` (when running
- *                               in-pod) and the `DnsSeedProvider`.
- *   - `CLUSTER_NAMESPACE`     — K8s namespace.  Default: `default`.
- *   - `KUBERNETES_SERVICE_HOST` — set automatically inside every K8s pod;
- *                                used as the detection signal for adding
- *                                the K8s-API provider to the chain.
- *
- * Chain order (first non-empty wins):
- *
- *   1. `CLUSTER_SEEDS` (ConfigSeedProvider)        — most explicit
- *   2. K8s API endpoints                            — service mesh
- *   3. DNS resolve of `CLUSTER_SERVICE_NAME`        — fallback
- *
- * If none of the env vars are set, the returned provider's `lookup()`
- * resolves to `[]` — the cluster boots as the first node in a
- * single-node topology, which is exactly what local dev wants.
- */
-export interface AutoDiscoverySettings {
-    /** ActorSystem name to stamp on discovered NodeAddresses. */
-    readonly systemName: string;
-    /** Cluster remoting port to pair each discovered IP with. */
-    readonly port: number;
-    /**
-     * Optional pre-mapped env lookup — useful for tests that want to
-     * exercise the provider chain without mutating `process.env`.
-     * Defaults to `process.env` at call time.
-     */
-    readonly env?: Record<string, string | undefined>;
-    /** Logger for individual provider failures.  Default: no-op. */
-    readonly log?: (msg: string, err?: unknown) => void;
-}
 /**
  * Build an {@link AggregateSeedProvider} from environment variables —
  * the default discovery wiring used by `Cluster.bootstrap()` when the
@@ -51,7 +10,7 @@ export interface AutoDiscoverySettings {
  * always has a `SeedProvider` to invoke — the resulting `lookup()`
  * just resolves to `[]` for single-node dev.
  */
-export declare function autoDiscovery(settings: AutoDiscoverySettings): AggregateSeedProvider;
+export declare function autoDiscovery(options: AutoDiscoveryOptions): AggregateSeedProvider;
 /**
  * Named-provider shorthand used by `Cluster.bootstrap({ discovery: '...' })`.
  * Pins the chain to a single provider type (configured from env vars)
@@ -59,5 +18,5 @@ export declare function autoDiscovery(settings: AutoDiscoverySettings): Aggregat
  * you're running on K8s and want the bootstrap to fail loudly if the
  * K8s API isn't reachable, instead of silently falling through to DNS.
  */
-export declare function singleProviderDiscovery(kind: 'config' | 'dns' | 'kubernetes', settings: AutoDiscoverySettings): SeedProvider;
+export declare function singleProviderDiscovery(kind: 'config' | 'dns' | 'kubernetes', options: AutoDiscoveryOptions): SeedProvider;
 //# sourceMappingURL=autoDiscovery.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"autoDiscovery.d.ts","sourceRoot":"","sources":["../../src/discovery/autoDiscovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAInE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD,gEAAgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,qBAAqB,GAAG,qBAAqB,CAmCpF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,YAAY,EACrC,QAAQ,EAAE,qBAAqB,GAC9B,YAAY,CAsCd"}
+{"version":3,"file":"autoDiscovery.d.ts","sourceRoot":"","sources":["../../src/discovery/autoDiscovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAA4B,MAAM,2BAA2B,CAAC;AAOhG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,qBAAqB,CAuClF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,YAAY,EACrC,OAAO,EAAE,oBAAoB,GAC5B,YAAY,CA0Cd"}

package/dist/discovery/autoDiscovery.js

@@ -1,7 +1,10 @@
 import { AggregateSeedProvider } from './AggregateSeedProvider.js';
 import { ConfigSeedProvider } from './ConfigSeedProvider.js';
+import { ConfigSeedProviderOptions } from './ConfigSeedProviderOptions.js';
 import { DnsSeedProvider } from './DnsSeedProvider.js';
+import { DnsSeedProviderOptions } from './DnsSeedProviderOptions.js';
 import { KubernetesApiSeedProvider } from './KubernetesApiSeedProvider.js';
+import { KubernetesApiSeedProviderOptions } from './KubernetesApiSeedProviderOptions.js';
 function parseSeedList(raw) {
     return raw.split(',').map(s => s.trim()).filter(Boolean);
 }
@@ -14,35 +17,33 @@ function parseSeedList(raw) {
  * always has a `SeedProvider` to invoke — the resulting `lookup()`
  * just resolves to `[]` for single-node dev.
  */
-export function autoDiscovery(settings) {
+export function autoDiscovery(options) {
+    const settings = options;
     const env = settings.env ?? process.env;
     const log = settings.log ?? (() => { });
     const providers = [];
     // 1. CLUSTER_SEEDS — explicit static list.
     const rawSeeds = (env.CLUSTER_SEEDS ?? '').trim();
     if (rawSeeds.length > 0) {
-        providers.push(new ConfigSeedProvider({
-            systemName: settings.systemName,
-            seeds: parseSeedList(rawSeeds),
-        }));
+        providers.push(new ConfigSeedProvider(ConfigSeedProviderOptions.create()
+            .withSystemName(settings.systemName)
+            .withSeeds(parseSeedList(rawSeeds))));
     }
     // 2. Kubernetes API — only inside a pod with a matching service name.
     const serviceName = (env.CLUSTER_SERVICE_NAME ?? '').trim();
     if (env.KUBERNETES_SERVICE_HOST && serviceName.length > 0) {
-        providers.push(new KubernetesApiSeedProvider({
-            systemName: settings.systemName,
-            namespace: env.CLUSTER_NAMESPACE ?? 'default',
-            serviceName,
-            port: settings.port,
-        }));
+        providers.push(new KubernetesApiSeedProvider(KubernetesApiSeedProviderOptions.create()
+            .withSystemName(settings.systemName)
+            .withNamespace(env.CLUSTER_NAMESPACE ?? 'default')
+            .withServiceName(serviceName)
+            .withPort(settings.port)));
     }
     // 3. DNS — resolve the service hostname directly.
     if (serviceName.length > 0) {
-        providers.push(new DnsSeedProvider({
-            systemName: settings.systemName,
-            hostname: serviceName,
-            port: settings.port,
-        }));
+        providers.push(new DnsSeedProvider(DnsSeedProviderOptions.create()
+            .withSystemName(settings.systemName)
+            .withHostname(serviceName)
+            .withPort(settings.port)));
     }
     return new AggregateSeedProvider(providers, log);
 }
@@ -53,38 +54,36 @@ export function autoDiscovery(settings) {
  * you're running on K8s and want the bootstrap to fail loudly if the
  * K8s API isn't reachable, instead of silently falling through to DNS.
  */
-export function singleProviderDiscovery(kind, settings) {
+export function singleProviderDiscovery(kind, options) {
+    const settings = options;
     const env = settings.env ?? process.env;
     switch (kind) {
         case 'config': {
             const rawSeeds = (env.CLUSTER_SEEDS ?? '').trim();
-            return new ConfigSeedProvider({
-                systemName: settings.systemName,
-                seeds: parseSeedList(rawSeeds),
-            });
+            return new ConfigSeedProvider(ConfigSeedProviderOptions.create()
+                .withSystemName(settings.systemName)
+                .withSeeds(parseSeedList(rawSeeds)));
         }
         case 'dns': {
             const hostname = (env.CLUSTER_SERVICE_NAME ?? '').trim();
             if (!hostname) {
                 throw new Error("Cluster.bootstrap({ discovery: 'dns' }): CLUSTER_SERVICE_NAME must be set");
             }
-            return new DnsSeedProvider({
-                systemName: settings.systemName,
-                hostname,
-                port: settings.port,
-            });
+            return new DnsSeedProvider(DnsSeedProviderOptions.create()
+                .withSystemName(settings.systemName)
+                .withHostname(hostname)
+                .withPort(settings.port));
         }
         case 'kubernetes': {
             const serviceName = (env.CLUSTER_SERVICE_NAME ?? '').trim();
             if (!serviceName) {
                 throw new Error("Cluster.bootstrap({ discovery: 'kubernetes' }): CLUSTER_SERVICE_NAME must be set");
             }
-            return new KubernetesApiSeedProvider({
-                systemName: settings.systemName,
-                namespace: env.CLUSTER_NAMESPACE ?? 'default',
-                serviceName,
-                port: settings.port,
-            });
+            return new KubernetesApiSeedProvider(KubernetesApiSeedProviderOptions.create()
+                .withSystemName(settings.systemName)
+                .withNamespace(env.CLUSTER_NAMESPACE ?? 'default')
+                .withServiceName(serviceName)
+                .withPort(settings.port));
         }
     }
 }

package/dist/discovery/autoDiscovery.js.map

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

package/dist/discovery/index.d.ts

@@ -1,16 +1,21 @@
 export type { SeedProvider } from './SeedProvider.js';
 export { ConfigSeedProvider, seedsFromEnv } from './ConfigSeedProvider.js';
-export type { ConfigSeedProviderSettings } from './ConfigSeedProvider.js';
+export { ConfigSeedProviderOptions, ConfigSeedProviderOptionsBuilder } from './ConfigSeedProviderOptions.js';
+export type { ConfigSeedProviderOptionsType } from './ConfigSeedProviderOptions.js';
 export { DnsSeedProvider } from './DnsSeedProvider.js';
-export type { DnsSeedProviderSettings } from './DnsSeedProvider.js';
+export { DnsSeedProviderOptions, DnsSeedProviderOptionsBuilder } from './DnsSeedProviderOptions.js';
+export type { DnsSeedProviderOptionsType } from './DnsSeedProviderOptions.js';
 export { AggregateSeedProvider } from './AggregateSeedProvider.js';
 export { KubernetesApiSeedProvider } from './KubernetesApiSeedProvider.js';
-export type { KubernetesApiSeedProviderSettings } from './KubernetesApiSeedProvider.js';
+export { KubernetesApiSeedProviderOptions, KubernetesApiSeedProviderOptionsBuilder } from './KubernetesApiSeedProviderOptions.js';
+export type { KubernetesApiSeedProviderOptionsType } from './KubernetesApiSeedProviderOptions.js';
 export { autoDiscovery, singleProviderDiscovery } from './autoDiscovery.js';
-export type { AutoDiscoverySettings } from './autoDiscovery.js';
+export { AutoDiscoveryOptions, AutoDiscoveryOptionsBuilder } from './AutoDiscoveryOptions.js';
+export type { AutoDiscoveryOptionsType } from './AutoDiscoveryOptions.js';
 export { ServiceKey } from './ServiceKey.js';
 export { Receptionist, ReceptionistExtension, ReceptionistId, } from './Receptionist.js';
-export type { ReceptionistSettings } from './Receptionist.js';
+export { ReceptionistOptions, ReceptionistOptionsBuilder } from './ReceptionistOptions.js';
+export type { ReceptionistOptionsType } from './ReceptionistOptions.js';
 export { Register, Registered, Deregister, Find, Subscribe, Unsubscribe, Listing, } from './ReceptionistMessages.js';
 export type { ReceptionistGossipMsg } from './ReceptionistMessages.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,YAAY,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,YAAY,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,IAAI,EACJ,SAAS,EACT,WAAW,EACX,OAAO,GACR,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAC7G,YAAY,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AACpG,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,gCAAgC,EAAE,uCAAuC,EAAE,MAAM,uCAAuC,CAAC;AAClI,YAAY,EAAE,oCAAoC,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAC9F,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAC3F,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,IAAI,EACJ,SAAS,EACT,WAAW,EACX,OAAO,GACR,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/discovery/index.js

@@ -1,9 +1,14 @@
 export { ConfigSeedProvider, seedsFromEnv } from './ConfigSeedProvider.js';
+export { ConfigSeedProviderOptions, ConfigSeedProviderOptionsBuilder } from './ConfigSeedProviderOptions.js';
 export { DnsSeedProvider } from './DnsSeedProvider.js';
+export { DnsSeedProviderOptions, DnsSeedProviderOptionsBuilder } from './DnsSeedProviderOptions.js';
 export { AggregateSeedProvider } from './AggregateSeedProvider.js';
 export { KubernetesApiSeedProvider } from './KubernetesApiSeedProvider.js';
+export { KubernetesApiSeedProviderOptions, KubernetesApiSeedProviderOptionsBuilder } from './KubernetesApiSeedProviderOptions.js';
 export { autoDiscovery, singleProviderDiscovery } from './autoDiscovery.js';
+export { AutoDiscoveryOptions, AutoDiscoveryOptionsBuilder } from './AutoDiscoveryOptions.js';
 export { ServiceKey } from './ServiceKey.js';
 export { Receptionist, ReceptionistExtension, ReceptionistId, } from './Receptionist.js';
+export { ReceptionistOptions, ReceptionistOptionsBuilder } from './ReceptionistOptions.js';
 export { Register, Registered, Deregister, Find, Subscribe, Unsubscribe, Listing, } from './ReceptionistMessages.js';
 //# sourceMappingURL=index.js.map

package/dist/discovery/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,IAAI,EACJ,SAAS,EACT,WAAW,EACX,OAAO,GACR,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAE7G,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAEpG,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,gCAAgC,EAAE,uCAAuC,EAAE,MAAM,uCAAuC,CAAC;AAElI,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAE9F,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAE3F,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,IAAI,EACJ,SAAS,EACT,WAAW,EACX,OAAO,GACR,MAAM,2BAA2B,CAAC"}

package/dist/http/HttpExtension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HttpExtension.d.ts","sourceRoot":"","sources":["../../src/http/HttpExtension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEvF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAW,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAGjD,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC;IACtD,yEAAyE;IACzE,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7C;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,SAAS;IAIjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAoB;gBAElB,MAAM,EAAE,WAAW;IAEhD,2EAA2E;IAC3E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa;IA6CtD,qDAAqD;IACrD,aAAa,8GAA+C;CAC7D;AAED,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,aAAa,CAGtD,CAAC"}
+{"version":3,"file":"HttpExtension.d.ts","sourceRoot":"","sources":["../../src/http/HttpExtension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEvF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAW,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC;IACtD,yEAAyE;IACzE,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7C;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,SAAS;IAIjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAoB;gBAElB,MAAM,EAAE,WAAW;IAEhD,2EAA2E;IAC3E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa;IAuHtD,qDAAqD;IACrD,aAAa,8GAA+C;CAC7D;AAED,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,aAAa,CAGtD,CAAC"}

package/dist/http/HttpExtension.js

@@ -1,7 +1,9 @@
+import { CoordinatedShutdownId, Phases } from '../CoordinatedShutdown.js';
 import { extensionId } from '../Extension.js';
 import { FastifyBackend } from './backend/FastifyBackend.js';
 import { HttpClient } from './HttpClient.js';
 import { compile } from './Route.js';
+import { ConnectionTracker, trackSocket } from './ws/ConnectionWiring.js';
 /**
  * System-wide HTTP extension — entry point for the routing DSL and the
  * shared HttpClient.  Every ActorSystem gets one HttpClient and a factory
@@ -27,13 +29,34 @@ export class HttpExtension {
             async bind(routes) {
                 const active = backend ?? new FastifyBackend();
                 const compiled = compile(routes);
-                // Wrap each route's handler with a request log + timing.
+                const httpRoutes = compiled.filter((r) => r.kind === 'http');
+                const wsRoutes = compiled.filter((r) => r.kind === 'websocket');
+                if (wsRoutes.length > 0 && typeof active.registerWebSocket !== 'function') {
+                    throw new Error(`HTTP backend "${active.name}" does not support websocket() routes.`);
+                }
+                // Reject duplicate / conflicting patterns up front — clearer than
+                // the backend's own boot-time error, and it catches the WS-vs-GET
+                // collision (a WS route occupies the GET verb at its pattern).
+                const wsPatterns = new Set();
+                for (const r of wsRoutes) {
+                    if (wsPatterns.has(r.pattern)) {
+                        throw new Error(`Duplicate websocket() route for pattern "${r.pattern}".`);
+                    }
+                    wsPatterns.add(r.pattern);
+                }
+                for (const r of httpRoutes) {
+                    if (r.method === 'GET' && wsPatterns.has(r.pattern)) {
+                        throw new Error(`Route conflict: GET ${r.pattern} collides with a websocket() route on the same path.`);
+                    }
+                }
+                // Wrap each HTTP route's handler with a request log + timing.
                 // Done at the DSL level so backends don't need a Logger
                 // reference — every backend gets the same per-request debug
                 // line uniformly.
-                for (const r of compiled) {
-                    const wrapped = {
-                        ...r,
+                for (const r of httpRoutes) {
+                    active.registerRoute({
+                        method: r.method,
+                        pattern: r.pattern,
                         handler: async (req) => {
                             const start = Date.now();
                             system.log.debug(`[http] ${req.method} ${req.path}`);
@@ -47,12 +70,50 @@ export class HttpExtension {
                                 throw err;
                             }
                         },
-                    };
-                    active.registerRoute(wrapped);
+                    });
+                }
+                // WebSocket routes: every accepted socket flows through the
+                // shared ConnectionTracker so unbind() can close it — otherwise
+                // a long-lived socket keeps the server's close() pending forever.
+                const tracker = new ConnectionTracker();
+                for (const r of wsRoutes) {
+                    active.registerWebSocket({
+                        pattern: r.pattern,
+                        authorize: r.authorize,
+                        onConnection: (req, socket) => {
+                            system.log.debug(`[ws] upgrade ${req.path}`);
+                            r.connect(system, req, trackSocket(tracker, socket));
+                        },
+                    });
                 }
-                const binding = await active.listen(host, port);
+                const raw = await active.listen(host, port);
+                // Wrap `unbind` so it's idempotent — both the auto-registered
+                // CoordinatedShutdown task and any manual caller can invoke it
+                // safely; subsequent calls return the in-flight/resolved promise
+                // from the first.  On unbind we also close then hard-terminate
+                // live WebSocket sockets so the backend's close() can complete.
+                let unbindOnce = null;
+                const binding = {
+                    host: raw.host,
+                    port: raw.port,
+                    unbind(gracePeriodMs) {
+                        if (!unbindOnce) {
+                            unbindOnce = (async () => {
+                                const backendUnbind = raw.unbind(gracePeriodMs);
+                                tracker.closeAll(1001, 'server shutting down');
+                                tracker.terminateAll();
+                                await backendUnbind;
+                            })();
+                        }
+                        return unbindOnce;
+                    },
+                };
+                // Auto-register with CoordinatedShutdown's ServiceUnbind phase so
+                // operator-triggered shutdown (SIGTERM, cluster-leave, etc.) closes
+                // the server before the rest of the pipeline tears down the system.
+                system.extension(CoordinatedShutdownId).addTask(Phases.ServiceUnbind, `http-unbind-${binding.host}:${binding.port}`, () => binding.unbind());
                 system.log.info(`HTTP server bound on ${binding.host}:${binding.port} (${active.name})`);
-                system.log.debug(`[http] ${compiled.length} route(s) registered`);
+                system.log.debug(`[http] ${httpRoutes.length} route(s) + ${wsRoutes.length} websocket route(s) registered`);
                 return binding;
             },
         };

package/dist/http/HttpExtension.js.map

@@ -1 +1 @@
-{"version":3,"file":"HttpExtension.js","sourceRoot":"","sources":["../../src/http/HttpExtension.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAoC,MAAM,iBAAiB,CAAC;AAEhF,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAc,MAAM,YAAY,CAAC;AAUjD;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAIK;IAH7B,kDAAkD;IACzC,MAAM,GAAe,IAAI,UAAU,EAAE,CAAC;IAE/C,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,2EAA2E;IAC3E,WAAW,CAAC,IAAY,EAAE,IAAY;QACpC,IAAI,OAAO,GAA6B,IAAI,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,OAAO;YACL,UAAU,CAAC,CAAoB;gBAC7B,OAAO,GAAG,CAAC,CAAC;gBACZ,OAAO,IAAI,CAAC;YACd,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,MAAa;gBACtB,MAAM,MAAM,GAAG,OAAO,IAAI,IAAI,cAAc,EAAE,CAAC;gBAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;gBACjC,yDAAyD;gBACzD,wDAAwD;gBACxD,4DAA4D;gBAC5D,kBAAkB;gBAClB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;oBACzB,MAAM,OAAO,GAAG;wBACd,GAAG,CAAC;wBACJ,OAAO,EAAE,KAAK,EAAE,GAAgB,EAAyB,EAAE;4BACzD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;4BACzB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;4BACrD,IAAI,CAAC;gCACH,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gCACjC,MAAM,CAAC,GAAG,CAAC,KAAK,CACd,UAAU,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAC9E,CAAC;gCACF,OAAO,GAAG,CAAC;4BACb,CAAC;4BAAC,OAAO,GAAG,EAAE,CAAC;gCACb,MAAM,CAAC,GAAG,CAAC,KAAK,CACd,UAAU,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,kBAAkB,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,QAAS,GAAa,CAAC,OAAO,EAAE,CACrG,CAAC;gCACF,MAAM,GAAG,CAAC;4BACZ,CAAC;wBACH,CAAC;qBACF,CAAC;oBACF,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;gBACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAChD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;gBACzF,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,QAAQ,CAAC,MAAM,sBAAsB,CAAC,CAAC;gBAClE,OAAO,OAAO,CAAC;YACjB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;CAC7D;AAED,MAAM,CAAC,MAAM,eAAe,GAA+B,WAAW,CACpE,eAAe,EACf,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,CACtC,CAAC"}
+{"version":3,"file":"HttpExtension.js","sourceRoot":"","sources":["../../src/http/HttpExtension.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAoC,MAAM,iBAAiB,CAAC;AAEhF,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAc,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAS1E;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAIK;IAH7B,kDAAkD;IACzC,MAAM,GAAe,IAAI,UAAU,EAAE,CAAC;IAE/C,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,2EAA2E;IAC3E,WAAW,CAAC,IAAY,EAAE,IAAY;QACpC,IAAI,OAAO,GAA6B,IAAI,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,OAAO;YACL,UAAU,CAAC,CAAoB;gBAC7B,OAAO,GAAG,CAAC,CAAC;gBACZ,OAAO,IAAI,CAAC;YACd,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,MAAa;gBACtB,MAAM,MAAM,GAAsB,OAAO,IAAI,IAAI,cAAc,EAAE,CAAC;gBAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;gBACjC,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;gBAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;gBAEhE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,MAAM,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;oBAC1E,MAAM,IAAI,KAAK,CACb,iBAAiB,MAAM,CAAC,IAAI,wCAAwC,CACrE,CAAC;gBACJ,CAAC;gBAED,kEAAkE;gBAClE,kEAAkE;gBAClE,+DAA+D;gBAC/D,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;gBACrC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;oBACzB,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;wBAC9B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;oBAC7E,CAAC;oBACD,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC5B,CAAC;gBACD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;oBAC3B,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;wBACpD,MAAM,IAAI,KAAK,CACb,uBAAuB,CAAC,CAAC,OAAO,sDAAsD,CACvF,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAED,8DAA8D;gBAC9D,wDAAwD;gBACxD,4DAA4D;gBAC5D,kBAAkB;gBAClB,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;oBAC3B,MAAM,CAAC,aAAa,CAAC;wBACnB,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;wBAClB,OAAO,EAAE,KAAK,EAAE,GAAgB,EAAyB,EAAE;4BACzD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;4BACzB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;4BACrD,IAAI,CAAC;gCACH,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gCACjC,MAAM,CAAC,GAAG,CAAC,KAAK,CACd,UAAU,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAC9E,CAAC;gCACF,OAAO,GAAG,CAAC;4BACb,CAAC;4BAAC,OAAO,GAAG,EAAE,CAAC;gCACb,MAAM,CAAC,GAAG,CAAC,KAAK,CACd,UAAU,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,kBAAkB,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,QAAS,GAAa,CAAC,OAAO,EAAE,CACrG,CAAC;gCACF,MAAM,GAAG,CAAC;4BACZ,CAAC;wBACH,CAAC;qBACF,CAAC,CAAC;gBACL,CAAC;gBAED,4DAA4D;gBAC5D,gEAAgE;gBAChE,kEAAkE;gBAClE,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAE,CAAC;gBACxC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;oBACzB,MAAM,CAAC,iBAAkB,CAAC;wBACxB,OAAO,EAAE,CAAC,CAAC,OAAO;wBAClB,SAAS,EAAE,CAAC,CAAC,SAAS;wBACtB,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;4BAC5B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;4BAC7C,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;wBACvD,CAAC;qBACF,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC5C,8DAA8D;gBAC9D,+DAA+D;gBAC/D,iEAAiE;gBACjE,+DAA+D;gBAC/D,gEAAgE;gBAChE,IAAI,UAAU,GAAyB,IAAI,CAAC;gBAC5C,MAAM,OAAO,GAAkB;oBAC7B,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,MAAM,CAAC,aAAsB;wBAC3B,IAAI,CAAC,UAAU,EAAE,CAAC;4BAChB,UAAU,GAAG,CAAC,KAAK,IAAI,EAAE;gCACvB,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;gCAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;gCAC/C,OAAO,CAAC,YAAY,EAAE,CAAC;gCACvB,MAAM,aAAa,CAAC;4BACtB,CAAC,CAAC,EAAE,CAAC;wBACP,CAAC;wBACD,OAAO,UAAU,CAAC;oBACpB,CAAC;iBACF,CAAC;gBACF,kEAAkE;gBAClE,oEAAoE;gBACpE,oEAAoE;gBACpE,MAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC,OAAO,CAC7C,MAAM,CAAC,aAAa,EACpB,eAAe,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,EAC7C,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CACvB,CAAC;gBACF,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;gBACzF,MAAM,CAAC,GAAG,CAAC,KAAK,CACd,UAAU,UAAU,CAAC,MAAM,eAAe,QAAQ,CAAC,MAAM,gCAAgC,CAC1F,CAAC;gBACF,OAAO,OAAO,CAAC;YACjB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;CAC7D;AAED,MAAM,CAAC,MAAM,eAAe,GAA+B,WAAW,CACpE,eAAe,EACf,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,CACtC,CAAC"}

package/dist/http/Route.d.ts

@@ -1,13 +1,57 @@
+import type { ActorSystem } from '../ActorSystem.js';
 import { type HttpMethod, type HttpRequest, type HttpResponse } from './types.js';
+import type { WebSocketSocketAdapter } from './ws/SocketAdapter.js';
 /**
- * A compiled route — the Route-DSL reduces to a list of these, which the
- * HTTP backend registers in its native routing table.
+ * A compiled HTTP route — the Route-DSL reduces to a list of these
+ * (plus {@link CompiledWebSocketRoute}s), which the HTTP backend
+ * registers in its native routing table.
  */
 export interface CompiledRoute {
+    readonly kind: 'http';
     readonly method: HttpMethod;
     readonly pattern: string;
     readonly handler: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse;
 }
+/**
+ * Framework-owned entry point for one accepted WebSocket connection.
+ * The backend never sees actors — it only hands us the upgrade request
+ * and a normalised socket; the closure (built by the `websocket()`
+ * directive) owns the codec, target ref and per-route policy.
+ */
+export type WebSocketConnectHandler = (system: ActorSystem, req: HttpRequest, socket: WebSocketSocketAdapter) => void;
+/**
+ * A compiled WebSocket route.  Occupies the `GET` verb at its pattern
+ * (that's how the HTTP upgrade arrives).  `authorize` folds any
+ * enclosing `withMiddleware(...)` — it runs once, against the upgrade
+ * request, and returns `null` to accept or an {@link HttpResponse} to
+ * reject the upgrade with a plain HTTP response.
+ */
+export interface CompiledWebSocketRoute {
+    readonly kind: 'websocket';
+    readonly method: 'GET';
+    readonly pattern: string;
+    readonly connect: WebSocketConnectHandler;
+    readonly authorize: (req: HttpRequest) => Promise<HttpResponse | null>;
+}
+/** A compiled endpoint is either a plain HTTP route or a WebSocket route. */
+export type CompiledEndpoint = CompiledRoute | CompiledWebSocketRoute;
+/**
+ * Per-request hook that runs around a handler.  Receives the request
+ * and a `next()` thunk; either short-circuit by returning your own
+ * response, or call `next()` and pass its result through (optionally
+ * wrapped, decorated, or re-thrown).
+ *
+ * Examples (all shipped in `src/http/middleware/`):
+ *   - `BearerTokenAuth({ tokens })` — checks `Authorization: Bearer`,
+ *     short-circuits with 401 on mismatch.
+ *   - `IpAllowlist({ allow })` — checks `remoteAddress` (or a
+ *     configured extractor) against a CIDR list, short-circuits
+ *     with 403 if not allowed.
+ *
+ * Throwing `HttpError(status, msg)` is the idiomatic short-circuit:
+ * the global error handler catches it and emits the right response.
+ */
+export type Middleware = (req: HttpRequest, next: () => Promise<HttpResponse>) => Promise<HttpResponse> | HttpResponse;
 /**
  * Node type emitted by DSL builders like `path(...)`, `get(...)`.  Internal
  * representation is a tree that knows how to flatten into CompiledRoutes.
@@ -23,6 +67,13 @@ export type Route = {
 } | {
     readonly kind: 'concat';
     readonly routes: ReadonlyArray<Route>;
+} | {
+    readonly kind: 'middleware';
+    readonly middleware: Middleware;
+    readonly child: Route;
+} | {
+    readonly kind: 'websocket';
+    readonly connect: WebSocketConnectHandler;
 };
 /** Compose several sibling routes (OR semantics — first matching wins). */
 export declare function concat(...routes: Route[]): Route;
@@ -30,6 +81,27 @@ export declare function concat(...routes: Route[]): Route;
 export declare function path(segment: string, child: Route): Route;
 /** Scope under a path prefix that may capture dynamic segments. */
 export declare function pathPrefix(segment: string, child: Route): Route;
+/**
+ * Wrap every handler in `child`'s subtree with the given `Middleware`.
+ * The middleware runs **before** the handler; it can short-circuit
+ * (return without calling `next()`) or transform the response.
+ *
+ * Nesting composes outside-in: `withMiddleware(a, withMiddleware(b,
+ * get(h)))` runs `a` first, then if it calls `next()`, `b` runs, and
+ * if `b` calls `next()`, the handler `h` runs.
+ *
+ *     const protectedRoutes = withMiddleware(
+ *       BearerTokenAuth({ tokens: [process.env.MGMT_TOKEN!] }),
+ *       withMiddleware(
+ *         IpAllowlist({ allow: ['10.0.0.0/8'] }),
+ *         path('cluster', concat(
+ *           path('down', post(handleDown)),
+ *           path('leave', post(handleLeave)),
+ *         )),
+ *       ),
+ *     );
+ */
+export declare function withMiddleware(middleware: Middleware, child: Route): Route;
 export declare const get: (h: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse) => Route;
 export declare const post: (h: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse) => Route;
 export declare const put: (h: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse) => Route;
@@ -47,8 +119,8 @@ export declare function completeText(status: number, body: string, headers?: Rec
 export declare function redirect(url: string, status?: number): HttpResponse;
 /** Rejection — throw to short-circuit to a 4xx/5xx. */
 export declare function reject(status: number, message: string, extra?: Record<string, unknown>): never;
-/** Flatten a Route tree into the list of concrete route registrations. */
-export declare function compile(route: Route, prefix?: string[]): CompiledRoute[];
+/** Flatten a Route tree into the list of concrete endpoint registrations. */
+export declare function compile(route: Route, prefix?: string[]): CompiledEndpoint[];
 /**
  * Extract a query parameter as a trimmed string, or undefined.  Array-valued
  * params (e.g. `?x=1&x=2`) return the first value.