@dialecte/core 0.7.0 → 0.8.1

package/dist/store/engine/hub/hub-client.constants.d.ts

@@ -0,0 +1,27 @@
+/** Where a realm keeps its hub connection: shared by every copy of the library speaking this protocol. */
+export declare const HUB_REGISTRY_KEY: unique symbol;
+/**
+ * How long a realm waits for the hub's welcome once it said hello: a hub that does not answer (its
+ * script failed to load, or was blocked; a parent that unbound the port meanwhile) fails the join
+ * instead of keeping the realm waiting.
+ */
+export declare const HUB_WELCOME_BUDGET_MS = 10000;
+/**
+ * A port connected to the hub that says no hello within this long is let go: past a realm's own join budget
+ * (`HUB_WELCOME_BUDGET_MS`, its lock wait included) its hello no longer comes. A child's bound port is kept: its
+ * document may load later, and its parent unbinds it.
+ */
+export declare const HUB_HELLO_BUDGET_MS: number;
+/**
+ * A page back from a freeze whose hub cannot be reached tries again after this long, the delay doubling
+ * up to `HUB_REJOIN_MAX_DELAY_MS` (a hub restarting on a loaded machine, a deploy that moved its chunk).
+ */
+export declare const HUB_REJOIN_FIRST_DELAY_MS = 1000;
+export declare const HUB_REJOIN_MAX_DELAY_MS = 30000;
+/**
+ * How many times in a row a view joins the next hub at once after a hub that lasted was lost, its calls waiting for an
+ * engine kept waiting: past it (hubs that keep ending), they are refused and the next hub is joined after the delay -
+ * the bound on how long a call waits across hub restarts. Counted again from zero after a quiet while.
+ */
+export declare const HUB_REJOIN_AT_ONCE_MAX = 3;
+//# sourceMappingURL=hub-client.constants.d.ts.map

package/dist/store/engine/hub/hub-client.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-client.constants.d.ts","sourceRoot":"","sources":["../../../../src/store/engine/hub/hub-client.constants.ts"],"names":[],"mappings":"AAEA,0GAA0G;AAC1G,eAAO,MAAM,gBAAgB,eAA4D,CAAA;AAEzF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAS,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAA4B,CAAA;AAE5D;;;GAGG;AACH,eAAO,MAAM,yBAAyB,OAAQ,CAAA;AAE9C,eAAO,MAAM,uBAAuB,QAAS,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAA"}

package/dist/store/engine/hub/hub-client.d.ts

@@ -0,0 +1,46 @@
+import { HubConnection, HubConnectionOptions, HubConnectionParams, SpawnerRealm } from './hub-client.types';
+import { HubEngineSpawner } from './realm-host.types';
+/**
+ * Connect this realm to the origin's hub, once: a second call - from this copy of the library or
+ * another one of the same protocol - gets the first connection. Answers `undefined` where the browser
+ * has no SharedWorker, or the hub never welcomed the realm (its script failed to load or was blocked,
+ * or it stayed silent past the welcome budget): the caller then runs the engine itself, and a later
+ * call tries again. The realm registers the engines it can start whose worker is of its own origin: a
+ * later call adds those the connection does not run yet (`addSpawners`); one naming a dialecte the
+ * connection runs at another version, or two versions of one dialecte, is refused `STORE_HUB_SPAWNERS_FIXED`,
+ * the connection kept. A realm that cannot store (`hostsNoEngine`) registers none, its spawners checked all the same.
+ */
+export declare function openHubConnection(params?: HubConnectionOptions): Promise<HubConnection | undefined>;
+/** The realm's hub connection made or under way, if any: none is started for asking (a bound child has its own). */
+export declare function keptHubConnection(): Promise<HubConnection | undefined> | undefined;
+/**
+ * Join the hub through a port another realm made with `createHubPort` (a document that cannot reach
+ * the hub's script): a client only, whose liveness is its parent's. A port nobody answers (its parent
+ * unbound it) fails the join `STORE_CONNECTION_FAILED` once the welcome budget has passed. The realm's
+ * connection made or under way already, if any, is answered instead - `undefined` when that attempt
+ * found no hub - and it takes the new port as the one it joins on once the hub drops it (at once if it
+ * has): that join runs on its own, its calls waiting for the welcome; failed, the realm stays dropped
+ * until the next port.
+ */
+export declare function adoptHubConnection(params: {
+    port: MessagePort;
+}): Promise<HubConnection | undefined>;
+/**
+ * The spawners this realm can run: a worker of another origin is refused by the browser. The URL
+ * resolves as `new Worker` resolves it, against the document's base URL (in a srcdoc document
+ * `location` resolves nothing), and is compared with this realm's origin.
+ */
+export declare function sameOriginSpawners<GenericSpawner extends HubEngineSpawner>(params: {
+    spawners: GenericSpawner[];
+    realm?: SpawnerRealm;
+}): GenericSpawner[];
+/**
+ * A realm's connection over the ports `openPort` gives: its lock held before it says hello, the hub's
+ * answers routed to its project links and to the engines it hosts. What it says before it is welcomed
+ * waits for the welcome. A page that freezes or enters the back/forward cache ends its engines and lets
+ * its lock go (the hub elects other hosts); back, it joins as a new realm instance and asks for every
+ * project again. A hub refusing its hello (another protocol) ends it: its lock let go, everything
+ * waiting on it refused.
+ */
+export declare function startHubConnection(params: HubConnectionParams): Promise<HubConnection>;
+//# sourceMappingURL=hub-client.d.ts.map

package/dist/store/engine/hub/hub-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-client.d.ts","sourceRoot":"","sources":["../../../../src/store/engine/hub/hub-client.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAEX,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EAanB,YAAY,EACZ,MAAM,oBAAoB,CAAA;AAG3B,OAAO,KAAK,EAAE,gBAAgB,EAAiC,MAAM,oBAAoB,CAAA;AAEzF;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,GAAE,oBAAyB,GAC/B,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAmBpC;AAED,oHAAoH;AACpH,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,GAAG,SAAS,CAElF;AAqCD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAC1C,IAAI,EAAE,WAAW,CAAA;CACjB,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CA6BrC;AAoFD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,SAAS,gBAAgB,EAAE,MAAM,EAAE;IACnF,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,KAAK,CAAC,EAAE,YAAY,CAAA;CACpB,GAAG,cAAc,EAAE,CAUnB;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAs2B5F"}

package/dist/store/engine/hub/hub-client.types.d.ts

@@ -0,0 +1,208 @@
+import { EngineClient } from '../client/client.types';
+import { LinkNotice } from '../engine-store.types';
+import { RealmToHubMessage } from './hub-protocol.types';
+import { HubEngineSpawner, RealmEngineSpawner } from './realm-host.types';
+export type ConnectHubParams = {
+    /**
+     * The engines this page can start for the hub: each dialecte's `factory.spawner` (a spawner whose worker is of
+     * another origin is left out). A later call adds the engines the page does not run yet.
+     */
+    spawners?: HubEngineSpawner[];
+};
+/** How the realm connects: the engines it can start, with what each opens with. */
+export type HubConnectionOptions = {
+    spawners?: RealmEngineSpawner[];
+    /**
+     * The realm cannot store (no private file system): its spawners are checked - two versions of one dialecte
+     * refused - but none registered: elected to host an engine, it could not open it.
+     */
+    hostsNoEngine?: boolean;
+};
+/** The realm's global object as the hub connection is kept on it, under the protocol's key. */
+export type HubRegistry = Partial<Record<symbol, Promise<HubConnection | undefined>>>;
+/**
+ * What a page holds of its connection to the hub: its realm id, ports for the documents that cannot
+ * reach the hub themselves, and a call each time it is welcomed back. A child bound to a page that
+ * freezes is dropped by the hub with the page and told: its calls are refused `STORE_ENGINE_LOST`
+ * (`realm-dropped`) until the page, welcomed back (`onRejoined`), hands it a new port from
+ * `createHubPort` and the child calls `adoptHubPort` with it.
+ */
+export type HubRealm = Pick<HubConnection, 'realmId' | 'createHubPort' | 'onRejoined'>;
+/** This realm's connection to the origin's hub, shared by every copy of the library in the realm. */
+export type HubConnection = {
+    /** This realm instance's id (a new one after the page came back from a freeze or the cache). */
+    realmId: () => string;
+    /** Joined through a port its page made (`adoptHubPort`): a client only, hosting no engine. */
+    readonly bound: boolean;
+    /**
+     * Engines the realm can start from now on, beside those it runs: the hub told at once when welcomed (else in the
+     * next hello). A dialecte it runs at another version is refused `STORE_HUB_SPAWNERS_FIXED`, nothing added; one it
+     * runs already, or any for a child bound through `adoptHubPort` (it hosts none), adds nothing.
+     */
+    addSpawners: (params: {
+        spawners: RealmEngineSpawner[];
+    }) => void;
+    /** The realm's link to a project's engine: one per project, shared by the realm's connections to it. */
+    openProject: (params: HubProjectParams) => HubProjectLink;
+    /**
+     * Destroy a project once the hub grants it (no other view uses it): `destroy` deletes the files. Without
+     * `destroy` (a view that cannot store), the hub has a view that runs an engine of the dialecte delete them, and
+     * answers once it has. `own`, the destroying connection's link, does not count, and is let go once the destroy
+     * goes ahead.
+     */
+    destroyProject: (params: {
+        project: string;
+        dialecteId: string;
+        /** The version this realm runs: a view at that version deletes the files for it (no `destroy`) when one runs. */
+        dialecteVersion: string;
+        destroy?: () => Promise<void>;
+        own?: OwnHubLink;
+    }) => Promise<void>;
+    /** A port for a child realm that cannot reach the hub: it joins through it with `adoptHubPort`. */
+    createHubPort: () => HubPortHandle;
+    /**
+     * Ends the connection for good: its engines ended, its lock let go, everything waiting on it and every
+     * later call refused `STORE_CLOSED`; the realm's registry forgets it.
+     */
+    close: () => void;
+    /** Settles once the connection ended for good, with why. */
+    ended: Promise<unknown>;
+    /**
+     * `listener` called each time the realm is welcomed back after a freeze, the back/forward cache or
+     * being dropped - not on its first join: the moment to bind its children again (`createHubPort`).
+     * Answers its unsubscribe.
+     */
+    onRejoined: (listener: () => void) => () => void;
+    /**
+     * A child realm takes `port` as the one it joins on next, as a new realm instance, its links kept: at
+     * once if the hub has dropped it with the page that bound it, else once it does (that page may be back
+     * first); a port it held for that is let go. Answers whether it took it: a page, or a connection ended
+     * for good, takes none.
+     */
+    adoptPort: (params: {
+        port: MessagePort;
+    }) => boolean;
+};
+export type HubProjectParams = {
+    project: string;
+    dialecteId: string;
+    dialecteVersion: string;
+    /** How long a call waits on a silent engine (the default when absent). */
+    heartbeatTimeoutMs?: number;
+};
+/** One connection's use of the realm's link to a project. */
+export type HubProjectLink = {
+    /** The project's engine client now: waits for the hub's answer, rejects with its refusal. */
+    engine: () => Promise<EngineClient>;
+    /**
+     * `listener` told every change the project's engine announces to the realm, and `resync` once the realm reached
+     * another engine of it; until released. Answers the unsubscribe.
+     */
+    onNotice: (listener: (notice: LinkNotice) => void) => () => void;
+    /**
+     * This connection done with the project; the realm leaves it with its last connection, settled once the hub
+     * acknowledged the leave - from then on no destroy is refused for this realm (at once when another connection of
+     * the realm still uses it, or the hub was never asked).
+     */
+    release: () => Promise<void>;
+};
+/** The destroying connection's own link, and how to let it go (its store forgetting it). */
+export type OwnHubLink = {
+    link: HubProjectLink;
+    letGo: () => Promise<void>;
+};
+/** A port bound to this realm for a child realm, and how to say the child is gone. */
+export type HubPortHandle = {
+    port: MessagePort;
+    /** The child is gone (its iframe removed): the hub ends what it started. */
+    unbind: () => void;
+};
+/** A call waiting for the project's engine. */
+export type EngineWaiter = {
+    resolve: (client: EngineClient) => void;
+    reject: (thrown: unknown) => void;
+};
+/** The realm's link to one project: the connections using it, the engine client now, the calls waiting. */
+export type ProjectEntry = HubProjectParams & {
+    users: number;
+    /** What the realm's links of the project listen with: each change of its engine, and each resync. */
+    listeners: Set<(notice: LinkNotice) => void>;
+    /** An engine was reached once already: the next one is announced with a resync. */
+    reached: boolean;
+    /** The hub was asked for the project and has not refused it since. */
+    asked: boolean;
+    current: {
+        generation: number;
+        client: EngineClient;
+    } | undefined;
+    waiters: EngineWaiter[];
+    /** A refusal that holds for the rest of the link. */
+    refusal: unknown;
+    /**
+     * The id the project's file was created with, from the first engine the link reached: every later engine
+     * (the realm back from a freeze, a host gone) must run that project, else the link is refused.
+     */
+    creationId: string | undefined;
+};
+/**
+ * Where the realm instance stands with the hub: saying hello (its lock, then the welcome), welcomed (it
+ * may ask for projects and host engines), suspended (frozen, or in the back/forward cache), or refused
+ * by the hub (another protocol): done for good.
+ */
+export type RealmPhase = 'joining' | 'joined' | 'suspended' | 'dropped' | 'refused';
+/** A message for the hub kept until the realm instance is welcomed (one sent before is dropped). */
+export type QueuedMessage = {
+    message: RealmToHubMessage;
+    transfer: Transferable[];
+};
+/** Where a realm hears its page's lifecycle: `freeze` / `resume` on the document, `pagehide` / `pageshow` on the window. */
+export type HubLifecycleTargets = {
+    page: EventTarget;
+    window: EventTarget;
+};
+/** A destroy asked of the hub, waiting for its grant. */
+export type PendingDestroy = {
+    granted: () => void;
+    refused: (thrown: unknown) => void;
+};
+/** A port to the hub, and what settles if what serves it failed to start (a SharedWorker's `error`). */
+export type HubPortOpening = {
+    port: MessagePort;
+    failed?: Promise<unknown>;
+};
+/** The realm whose spawners are checked: where its scripts resolve from, and its origin. */
+export type SpawnerRealm = {
+    document?: {
+        baseURI: string;
+    };
+    location?: {
+        href: string;
+    };
+    origin: string;
+};
+/** How a realm's connection reaches the hub: a port, a new one for each realm instance. */
+export type HubConnectionParams = {
+    openPort: () => HubPortOpening;
+    /** How long the realm waits for the hub's welcome (the default when absent). */
+    welcomeBudgetMs?: number;
+    topLevel: boolean;
+    spawners: RealmEngineSpawner[];
+    /** Whether the realm holds a lock of its own (a child realm's liveness is its parent's). */
+    holdsLock: boolean;
+    /** The page's lifecycle to watch (freeze, the back/forward cache, the page going away); none for a child realm. */
+    lifecycle: HubLifecycleTargets | undefined;
+    /**
+     * Joined through a port its parent made (`adoptHubPort`), not on its own: dropped with its parent, it
+     * waits for the next port its page hands it. A realm that connected itself, top-level or not, is not. A bound
+     * realm watches no hub lock (a child of another origin shares no locks with the hub): a port its page hands it
+     * while it is still welcomed settles the leaves it waits for (the hub forgets it with its page); it joins on that
+     * port once the hub drops it.
+     */
+    bound?: boolean;
+};
+/** A join's budget, from its start: `expired` rejects once it has passed; `clear` stops it. */
+export type JoinBudget = {
+    expired: Promise<never>;
+    clear: () => void;
+};
+//# sourceMappingURL=hub-client.types.d.ts.map

package/dist/store/engine/hub/hub-client.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-client.types.d.ts","sourceRoot":"","sources":["../../../../src/store/engine/hub/hub-client.types.ts"],"names":[],"mappings":"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"}

package/dist/store/engine/hub/hub-protocol.types.d.ts

@@ -0,0 +1,193 @@
+import { ThrownData } from '../wire/wire.types';
+import { HubSpawner } from './hub.types';
+/** What a realm sends the hub. */
+export type RealmToHubMessage = {
+    type: 'hello';
+    protocol: number;
+    realmId: string;
+    topLevel: boolean;
+    spawners: HubSpawner[];
+}
+/** Engines the realm can start from now on, beside those of its hello (a child realm's are ignored). */
+ | {
+    type: 'spawners';
+    spawners: HubSpawner[];
+} | {
+    type: 'open';
+    project: string;
+    dialecteId: string;
+    dialecteVersion: string;
+    /** The creation id of the project the realm had, coming back to it. */
+    expectedCreationId?: string;
+} | {
+    type: 'leave';
+    project: string;
+    dialecteId: string;
+} | {
+    type: 'destroy';
+    project: string;
+    dialecteId: string;
+} | {
+    type: 'destroyed';
+    project: string;
+    dialecteId: string;
+}
+/** A realm that cannot store destroys the project: the hub has a realm that can delete its files. */
+ | {
+    type: 'destroy-elsewhere';
+    project: string;
+    dialecteId: string;
+    dialecteVersion: string;
+}
+/** A bound child asking whether its hub lives (it holds no lock to watch it): a hub answers `pong`. */
+ | {
+    type: 'ping';
+}
+/** The project's files deleted as the hub asked (`delete-files`), or what failed. */
+ | {
+    type: 'files-deleted';
+    project: string;
+    dialecteId: string;
+    error?: ThrownData;
+}
+/**
+ * Said on a port a parent bound for a child, before any hello, when the child lets it go unused (a newer one
+ * handed to it): the hub forgets that binding. A hub of the same protocol that does not know it ignores it.
+ */
+ | {
+    type: 'port-unused';
+}
+/** A port for a child realm (one with no hub of its own), bound to this realm under `bindingId`. */
+ | {
+    type: 'bind-child';
+    bindingId: string;
+    port: MessagePort;
+}
+/** The child realm bound under `bindingId` is gone (its iframe removed): the hub treats it as dead. */
+ | {
+    type: 'unbind-child';
+    bindingId: string;
+} | {
+    type: 'engine-opened';
+    project: string;
+    dialecteId: string;
+    generation: number;
+    creationId: string;
+} | {
+    type: 'engine-open-failed';
+    project: string;
+    dialecteId: string;
+    generation: number;
+    /** The error's catalog key, when it has one (`undefined` for a spawn that failed in the host). */
+    key: string | undefined;
+    error: ThrownData;
+} | {
+    type: 'engine-ended';
+    project: string;
+    dialecteId: string;
+    generation: number;
+} | {
+    type: 'client-adopted';
+    adoptionId: number;
+} | {
+    type: 'client-adopt-failed';
+    adoptionId: number;
+};
+/** What the hub sends a realm. */
+export type HubToRealmMessage = 
+/** Welcomed: `hubLock` names the lock the hub holds for its life - granted to a realm, the hub is gone. */
+{
+    type: 'welcome';
+    realmId: string;
+    hubLock: string;
+}
+/** The hello refused: the realm is not connected. */
+ | {
+    type: 'hello-refused';
+    error: ThrownData;
+} | {
+    type: 'engine-ready';
+    project: string;
+    dialecteId: string;
+    generation: number;
+    port: MessagePort;
+    /** The id the engine's project was created with. */
+    creationId: string;
+} | {
+    type: 'engine-lost';
+    project: string;
+    dialecteId: string;
+    generation: number;
+} | {
+    type: 'open-refused';
+    project: string;
+    dialecteId: string;
+    error: ThrownData;
+} | {
+    type: 'destroy-granted';
+    project: string;
+    dialecteId: string;
+}
+/** The realm's leave of the project handled: it counts no more for it. */
+ | {
+    type: 'left';
+    project: string;
+    dialecteId: string;
+} | {
+    type: 'destroy-refused';
+    project: string;
+    dialecteId: string;
+    error: ThrownData;
+}
+/** The hub lives: the answer to a `ping`. */
+ | {
+    type: 'pong';
+}
+/** The project this realm asked to destroy elsewhere is deleted. */
+ | {
+    type: 'destroyed-elsewhere';
+    project: string;
+    dialecteId: string;
+}
+/** Delete the project's files for a realm that cannot store; answer `files-deleted`. */
+ | {
+    type: 'delete-files';
+    project: string;
+    dialecteId: string;
+}
+/**
+ * Said to a child realm before its port closes, when the hub drops it with the page that bound it (that
+ * page gone, frozen, or unbinding it): its calls are refused until a new port binds it again. A realm
+ * of the same protocol that does not know it ignores it.
+ */
+ | {
+    type: 'dropped';
+} | {
+    type: 'spawn-engine';
+    project: string;
+    dialecteId: string;
+    generation: number;
+    openBudgetMs: number;
+    expectedCreationId?: string;
+} | {
+    type: 'adopt-client';
+    project: string;
+    dialecteId: string;
+    generation: number;
+    adoptionId: number;
+    /** The client's id in the engine: its realm id. */
+    clientId: string;
+    port: MessagePort;
+} | {
+    type: 'client-gone';
+    project: string;
+    dialecteId: string;
+    generation: number;
+    clientId: string;
+} | {
+    type: 'release-engine';
+    project: string;
+    dialecteId: string;
+    generation: number;
+};
+//# sourceMappingURL=hub-protocol.types.d.ts.map

package/dist/store/engine/hub/hub-protocol.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-protocol.types.d.ts","sourceRoot":"","sources":["../../../../src/store/engine/hub/hub-protocol.types.ts"],"names":[],"mappings":"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"}

package/dist/store/engine/hub/hub-router.d.ts

@@ -0,0 +1,9 @@
+import { HubRouter } from './hub.types';
+/**
+ * The hub's decisions as a state machine: which realm hosts each project's engine, which client
+ * gets a port, who is refused and why. Time, ports and locks stay outside: every event carries the
+ * hub clock, every command names realms by id and engines by project and generation, and the
+ * output says when to wake the router next.
+ */
+export declare function createHubRouter(): HubRouter;
+//# sourceMappingURL=hub-router.d.ts.map

package/dist/store/engine/hub/hub-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-router.d.ts","sourceRoot":"","sources":["../../../../src/store/engine/hub/hub-router.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EASX,SAAS,EAGT,MAAM,aAAa,CAAA;AAGpB;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAe3C"}

package/dist/store/engine/hub/hub-shell.d.ts

@@ -0,0 +1,13 @@
+import { HubShell, ServeHubParams } from './hub-shell.types';
+/**
+ * The hub as the browser runs it: the router's decisions carried out on ports and locks. Each realm
+ * speaks on its control port; the hub watches each realm's lock (its grant: the realm is gone), keeps
+ * one timer for the router's next deadline, and never relays a call: a client's port to its engine is
+ * one end of a channel whose other end the host hands its engine. A client gets its port only once the
+ * host says the engine adopted the other end; an adoption that fails ends that engine.
+ *
+ * The hub holds a Web Lock of its own for its life, named in each welcome (a realm granted it knows the hub is
+ * gone): a hub served in a page holds it as long as the page lives. No realm is heard before the hub holds it.
+ */
+export declare function serveHub(params?: ServeHubParams): HubShell;
+//# sourceMappingURL=hub-shell.d.ts.map

package/dist/store/engine/hub/hub-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-shell.d.ts","sourceRoot":"","sources":["../../../../src/store/engine/hub/hub-shell.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAEX,QAAQ,EAER,cAAc,EAEd,MAAM,mBAAmB,CAAA;AAG1B;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,MAAM,GAAE,cAAmB,GAAG,QAAQ,CA0M9D"}

package/dist/store/engine/hub/hub-shell.types.d.ts

@@ -0,0 +1,64 @@
+import { HubEvent } from './hub.types';
+/** The hub as its worker serves it: every realm's control port connected to it. */
+export type HubShell = {
+    connect: (params: {
+        port: MessagePort;
+    }) => void;
+};
+export type ServeHubParams = {
+    /** How long a port connected to the hub (not a child's binding) may stay without a hello. */
+    helloBudgetMs?: number;
+};
+/** The scope of the hub's SharedWorker, as far as the hub reads it. */
+export type SharedWorkerScope = {
+    onconnect: ((event: MessageEvent) => void) | null;
+};
+/** A realm the hub welcomed: its control port, and the watch of its lock (none for a child realm). */
+export type ShellRealm = {
+    realmId: string;
+    port: MessagePort;
+    watch: AbortController | undefined;
+};
+/** A client's port handed to its engine's host, kept until the host says the engine adopted it. */
+export type PendingAdoption = {
+    /** The realm asked to adopt: only its answer counts. */
+    hostRealmId: string;
+    clientRealmId: string;
+    project: string;
+    dialecteId: string;
+    generation: number;
+    /** The id the engine's project was created with, told the client with its port. */
+    creationId: string;
+    port: MessagePort;
+};
+/** A child realm's port bound by its parent: the child's realm id once it said hello. */
+export type ChildBinding = {
+    port: MessagePort;
+    /** The realm that bound it: gone, it takes a child that never said hello with it. */
+    parentRealmId: string;
+    realmId: string | undefined;
+};
+/** What the hub keeps beside the router: ports, lock watches, adoptions under way, its one timer. */
+export type HubShellState = {
+    realms: Map<string, ShellRealm>;
+    /** `<project>#<generation>` -> the realm hosting that engine. */
+    hosts: Map<string, string>;
+    adoptions: Map<number, PendingAdoption>;
+    nextAdoptionId: number;
+    /** Binding id -> the child realm bound under it. */
+    bindings: Map<string, ChildBinding>;
+    timer: ReturnType<typeof setTimeout> | undefined;
+    /** The lock this hub holds for its life, told each realm it welcomes. */
+    hubLock: string;
+};
+/** The port a hello came on, while the router decides on it (welcomed, or refused on that port). */
+export type HelloContext = {
+    port: MessagePort;
+    bindingId: string | undefined;
+};
+/** One event fed to the router, with the port of a hello when it is one. */
+export type ShellFeed = {
+    event: HubEvent;
+    hello?: HelloContext;
+};
+//# sourceMappingURL=hub-shell.types.d.ts.map

package/dist/store/engine/hub/hub-shell.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-shell.types.d.ts","sourceRoot":"","sources":["../../../../src/store/engine/hub/hub-shell.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,mFAAmF;AACnF,MAAM,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,CAAA;CAChD,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC5B,6FAA6F;IAC7F,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,uEAAuE;AACvE,MAAM,MAAM,iBAAiB,GAAG;IAC/B,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;CACjD,CAAA;AAED,sGAAsG;AACtG,MAAM,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,eAAe,GAAG,SAAS,CAAA;CAClC,CAAA;AAED,mGAAmG;AACnG,MAAM,MAAM,eAAe,GAAG;IAC7B,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,WAAW,CAAA;CACjB,CAAA;AAED,yFAAyF;AACzF,MAAM,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,WAAW,CAAA;IACjB,qFAAqF;IACrF,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3B,CAAA;AAED,qGAAqG;AACrG,MAAM,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC/B,iEAAiE;IACjE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IACvC,cAAc,EAAE,MAAM,CAAA;IACtB,oDAAoD;IACpD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACnC,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,SAAS,CAAA;IAChD,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,oGAAoG;AACpG,MAAM,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;CAC7B,CAAA;AAED,4EAA4E;AAC5E,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAAE,CAAA"}

package/dist/store/engine/hub/hub.constants.d.ts

@@ -0,0 +1,33 @@
+import { DialecteErrorKey } from '../../../errors';
+/**
+ * The wire protocol a realm and the hub speak; a realm speaking another one is refused. It also keys the connection
+ * every copy of the library in a realm shares (`HubRegistry`). Bumped with any change of either: `shared-shapes.test.ts`
+ * fails until it is, the shape recorded per version in `src/store/__shapes__/hub-protocol-v<version>.txt`.
+ */
+export declare const HUB_PROTOCOL_VERSION = 5;
+/** An engine left without client is told to close after this long; an open meanwhile keeps it. */
+export declare const ENGINE_IDLE_CLOSE_MS = 5000;
+/**
+ * An engine is started again (a busy retry, a new host) only with at least this much of the open
+ * window left; with less, the waiting clients get their answer.
+ */
+export declare const ENGINE_OPEN_MIN_BUDGET_MS = 1000;
+/**
+ * The longest a client waits for the hub's answer to an open, as long as a realm waits for an engine it
+ * runs itself: a slow worker start plus one whole engine attempt, with room to retry an engine that
+ * answers busy early.
+ */
+export declare const HUB_OPEN_BUDGET_MS = 30000;
+/** The prefix of the hub's own Web Lock, held for the hub's life: a realm granted it knows the hub is gone. */
+export declare const HUB_LOCK_PREFIX = "dialecte:hub:";
+/** The prefix of a realm's Web Lock, held for the realm's life: the hub's grant of it means the realm is gone. */
+export declare const REALM_LOCK_PREFIX = "dialecte:realm:";
+/** The name of the origin's hub SharedWorker. */
+export declare const HUB_WORKER_NAME = "dialecte-hub";
+/**
+ * The refusals that hold for the rest of a project's link (another dialecte, another version, another
+ * wire, its project destroyed while the realm was away); any other refusal answers the calls waiting, and
+ * the next call asks the hub again.
+ */
+export declare const LASTING_REFUSALS: readonly DialecteErrorKey[];
+//# sourceMappingURL=hub.constants.d.ts.map

package/dist/store/engine/hub/hub.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.constants.d.ts","sourceRoot":"","sources":["../../../../src/store/engine/hub/hub.constants.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAEhD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,kGAAkG;AAClG,eAAO,MAAM,oBAAoB,OAAQ,CAAA;AAEzC;;;GAGG;AACH,eAAO,MAAM,yBAAyB,OAAQ,CAAA;AAE9C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAwB,CAAA;AAEvD,+GAA+G;AAC/G,eAAO,MAAM,eAAe,kBAAkB,CAAA;AAE9C,kHAAkH;AAClH,eAAO,MAAM,iBAAiB,oBAAoB,CAAA;AAElD,iDAAiD;AACjD,eAAO,MAAM,eAAe,iBAAiB,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,gBAAgB,EAMvD,CAAA"}