statewire 0.21.0 → 0.22.1

package/src/host-internal.ts

@@ -31,8 +31,18 @@ export namespace StatewireHostInternal {
       selection: StatewireProtocol.Selection,
       authorizedAt: number,
     ) => void;
+    /** Documents the attach had included before the adapter retained its socket; they ride the hello. */
+    included?: readonly IncludedDocument[];
+    /** Called with the attach's whole include set each time `include` or `exclude` changes it. */
+    onIncludedChange?: (included: readonly IncludedDocument[]) => void;
   };
 
+  /** A durable document an attach included: `[protocol, key]`. */
+  export type IncludedDocument = readonly [
+    protocol: string,
+    key: readonly string[] | null,
+  ];
+
   export type SocketHost = {
     /** Null means refused: the socket was told (fin and/or close) and is dead. */
     connect: (
@@ -76,6 +86,8 @@ export namespace StatewireHostInternal {
   export type SocketHostPersistence = {
     clientRecords?: readonly ClientRecord[];
     onClientRecordsChange?: (records: readonly ClientRecord[]) => void;
+    /** The adapter can evict the host while its WebSockets stay open: their leases arm no timer and are checked on every message, delivery and restore instead. */
+    hibernatable?: boolean;
   };
 
   export type SocketHostOptions<TAuth = unknown> = {