@dialecte/core 0.7.0 → 0.8.1

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

@@ -0,0 +1,305 @@
+import { DialecteErrorKey } from '../../../errors';
+/** A dialecte whose engine a realm can start, with the version of the dialecte that engine runs. */
+export type HubSpawner = {
+    dialecteId: string;
+    dialecteVersion: string;
+};
+/** What an engine said when it could not open: its catalog key, read by the router, and its error as it came. */
+export type EngineOpenFailure = {
+    key: string | undefined;
+    error: unknown;
+};
+/**
+ * What reaches the router. Every event carries the hub's monotonic clock (`now`, ms): the router
+ * reads no clock of its own.
+ */
+export type HubEvent = {
+    /** A realm says who it is; `parentRealmId` when it speaks on a port another realm bound for it. */
+    type: 'hello';
+    now: number;
+    realmId: string;
+    protocol: number;
+    topLevel: boolean;
+    spawners: HubSpawner[];
+    parentRealmId?: string;
+} | {
+    /** A realm adds engines it can start, after its hello (a child realm's are ignored: it hosts none). */
+    type: 'spawners';
+    now: number;
+    realmId: string;
+    spawners: HubSpawner[];
+} | {
+    type: 'open';
+    now: number;
+    realmId: string;
+    project: string;
+    dialecteId: string;
+    dialecteVersion: string;
+    /** The creation id of the project the realm had, coming back to it. */
+    expectedCreationId?: string;
+} | {
+    /** A realm closes its link to a project. */ type: 'leave';
+    now: number;
+    realmId: string;
+    project: string;
+    dialecteId: string;
+} | {
+    /**
+     * The realm's lock was granted: it died, or it suspended and let the lock go. For a child
+     * realm: its parent unbound it.
+     */
+    type: 'realm-gone';
+    now: number;
+    realmId: string;
+} | {
+    type: 'engine-opened';
+    now: number;
+    project: string;
+    dialecteId: string;
+    generation: number;
+    /** The id the project's file was created with. */
+    creationId: string;
+} | {
+    /** The host saw its engine worker end without being asked (crash, out of memory). */
+    type: 'engine-ended';
+    now: number;
+    project: string;
+    dialecteId: string;
+    generation: number;
+} | {
+    /** The engine could not open; a spawn that failed in its host comes with `key: undefined`. */
+    type: 'engine-open-failed';
+    now: number;
+    project: string;
+    dialecteId: string;
+    generation: number;
+    failure: EngineOpenFailure;
+} | {
+    /** A realm asks to destroy the project: granted once no other realm is its client. */
+    type: 'destroy';
+    now: number;
+    realmId: string;
+    project: string;
+    dialecteId: string;
+} | {
+    /** The realm granted the destroy has done it (or given up): the project may open again. */
+    type: 'destroyed';
+    now: number;
+    realmId: string;
+    project: string;
+    dialecteId: string;
+} | {
+    /**
+     * A realm that cannot store (a child whose storage is refused) asks to destroy the project: granted as a
+     * `destroy` is, its files deleted by a realm that runs an engine of the dialecte.
+     */
+    type: 'destroy-elsewhere';
+    now: number;
+    realmId: string;
+    project: string;
+    dialecteId: string;
+    /** The version the asking realm runs: a realm deleting the files at that version is preferred. */
+    dialecteVersion: string;
+} | {
+    /** The realm asked to delete a project's files for another has done it, or failed with `error`. */
+    type: 'files-deleted';
+    now: number;
+    realmId: string;
+    project: string;
+    dialecteId: string;
+    error?: unknown;
+} | {
+    type: 'tick';
+    now: number;
+};
+/** Why the hub answers a hello or an open with no: its own reason, or the engine's error as it came. */
+export type HubRefusal = {
+    origin: 'hub';
+    key: DialecteErrorKey;
+    detail: string;
+    meta: Record<string, unknown>;
+} | {
+    origin: 'engine';
+    error: unknown;
+};
+/** What the router asks the hub worker to do: realms by realm id, engines by project and generation. */
+export type HubCommand = {
+    type: 'welcome';
+    realmId: string;
+}
+/** Forget the realm and close its control port. */
+ | {
+    type: 'drop-realm';
+    realmId: string;
+} | {
+    type: 'refuse-hello';
+    realmId: string;
+    refusal: HubRefusal;
+}
+/** Request the realm's lock; its grant is the realm's `realm-gone`. */
+ | {
+    type: 'watch-realm-lock';
+    realmId: string;
+} | {
+    type: 'spawn-engine';
+    realmId: string;
+    project: string;
+    dialecteId: string;
+    generation: number;
+    openBudgetMs: number;
+    /** The creation id every client waiting expects (realms coming back to the project), if they agree. */
+    expectedCreationId?: string;
+}
+/** One channel: an end to the engine for this client, the other to the realm as its engine port. */
+ | {
+    type: 'connect-client';
+    project: string;
+    dialecteId: string;
+    generation: number;
+    realmId: string;
+    /** The id the engine's project was created with: the client checks it is the project it had. */
+    creationId: string;
+}
+/** The client's engine is gone: the client waits for the hub's next answer. */
+ | {
+    type: 'engine-lost';
+    realmId: string;
+    project: string;
+    dialecteId: string;
+    generation: number;
+} | {
+    type: 'refuse-open';
+    realmId: string;
+    project: string;
+    dialecteId: string;
+    refusal: HubRefusal;
+}
+/** Tell the engine one of its clients is gone: it aborts what that client started. */
+ | {
+    type: 'client-gone';
+    project: string;
+    dialecteId: string;
+    generation: number;
+    realmId: string;
+}
+/** Have the host end that engine (close it, terminate its worker) and forget its control port. */
+ | {
+    type: 'release-engine';
+    project: string;
+    dialecteId: string;
+    generation: number;
+    hostRealmId: string;
+}
+/** The realm may destroy the project now: no engine runs it, opens wait until `destroyed`. */
+ | {
+    type: 'destroy-granted';
+    realmId: string;
+    project: string;
+    dialecteId: string;
+} | {
+    type: 'refuse-destroy';
+    realmId: string;
+    project: string;
+    dialecteId: string;
+    refusal: HubRefusal;
+}
+/** The realm's leave handled: it counts no more for the project (a destroy asked after it is not refused for it). */
+ | {
+    type: 'left';
+    realmId: string;
+    project: string;
+    dialecteId: string;
+}
+/** Delete the project's files for the realm that asked (`destroy-elsewhere`); answer `files-deleted`. */
+ | {
+    type: 'delete-files';
+    realmId: string;
+    project: string;
+    dialecteId: string;
+}
+/** The project the realm asked to destroy elsewhere is deleted. */
+ | {
+    type: 'destroyed-elsewhere';
+    realmId: string;
+    project: string;
+    dialecteId: string;
+};
+export type HubOutput = {
+    commands: HubCommand[];
+    /** The earliest deadline the router holds: send `tick` then. */
+    wakeAt: number | undefined;
+};
+export type HubRouter = {
+    handle: (event: HubEvent) => HubOutput;
+};
+export type HubRealm = {
+    realmId: string;
+    topLevel: boolean;
+    /** Dialecte id -> the version its engine runs. Empty for a child realm: a client only. */
+    spawners: Map<string, string>;
+    /** A child realm lives as long as the realm that bound its port. */
+    parentRealmId: string | undefined;
+    /** Connection order, the last tiebreak of an election. */
+    order: number;
+};
+/** A realm that can host an engine of a dialecte, and the version of the dialecte it would run. */
+export type HubCandidate = {
+    realm: HubRealm;
+    dialecteVersion: string;
+};
+export type HubEngine = {
+    hostRealmId: string;
+    generation: number;
+    /** The version of the dialecte the engine runs: its host's. */
+    dialecteVersion: string;
+    status: 'opening' | 'ready';
+    /** The id the project's file was created with, once the engine opened. */
+    creationId: string | undefined;
+    /** The creation id it was told to expect (its clients coming back to the project), if any. */
+    expectedCreationId: string | undefined;
+};
+/** A project exists while it has an engine, opening or ready. */
+export type HubProject = {
+    project: string;
+    dialecteId: string;
+    /** Realm id -> the dialecte version the realm runs. Every client holds a port while the engine is ready. */
+    clients: Map<string, string>;
+    /** Realm id -> the creation id a client coming back to the project expects (none for a client opening it anew). */
+    expectations: Map<string, string>;
+    engine: HubEngine;
+    /** While the engine opens for waiting clients: when they are answered at the latest. */
+    openDeadline: number | undefined;
+    /** While no client is left: when the engine is told to close. */
+    idleDeadline: number | undefined;
+    /** The hosts an engine of this open window failed busy on, oldest first. */
+    triedHosts: string[];
+};
+/** A project a realm is destroying: the opens made meanwhile wait, in their order, until it is done. */
+export type HubHold = {
+    project: string;
+    dialecteId: string;
+    /** The realm destroying it. */
+    realmId: string;
+    /** The realm deleting its files for it (`destroy-elsewhere`); none: the destroying realm deletes them itself. */
+    deleterRealmId?: string;
+    opens: Map<string, Extract<HubEvent, {
+        type: 'open';
+    }>>;
+};
+export type HubState = {
+    realms: Map<string, HubRealm>;
+    /** Project key (`projectKeyOf`: dialecte and name) -> the project and its engine. */
+    projects: Map<string, HubProject>;
+    /** Project key (`projectKeyOf`) -> the destroy running on it; such a project has no entry in `projects`. */
+    holds: Map<string, HubHold>;
+    /** One counter for the hub: a generation never repeats, not even for a project opened again. */
+    nextGeneration: number;
+    nextOrder: number;
+};
+/** One event being handled: the state, its time, and the commands answered so far. */
+export type HubStep = {
+    state: HubState;
+    now: number;
+    commands: HubCommand[];
+};
+//# sourceMappingURL=hub.types.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hub.worker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hub.worker.d.ts","sourceRoot":"","sources":["../../../../src/store/engine/hub/hub.worker.ts"],"names":[],"mappings":""}

package/dist/store/engine/hub/realm-host.d.ts

@@ -0,0 +1,10 @@
+import { RealmHost, RealmHostParams } from './realm-host.types';
+/**
+ * The engines this realm hosts for the hub: started from the dialecte's spawner when the hub asks
+ * (the project's lock waited for: the engine before it may still let it go), told of their clients,
+ * ended when released. What happens to each is told back to the hub: opened, failed to open, ended
+ * on its own (its lock let go without the realm ending it), a client adopted or not - an engine silent
+ * past the adopt budget did not adopt it (the hub then takes that engine for ended).
+ */
+export declare function createRealmHost(params: RealmHostParams): RealmHost;
+//# sourceMappingURL=realm-host.d.ts.map

package/dist/store/engine/hub/realm-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realm-host.d.ts","sourceRoot":"","sources":["../../../../src/store/engine/hub/realm-host.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAgB,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAElF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAuLlE"}

package/dist/store/engine/hub/realm-host.types.d.ts

@@ -0,0 +1,78 @@
+import { EngineControl } from '../client/client.types';
+import { RealmToHubMessage } from './hub-protocol.types';
+/**
+ * An engine a page can start for the hub: its dialecte, the version that dialecte runs, its worker. A dialecte's
+ * project factory carries its own (`factory.spawner`), built from the declaration.
+ */
+export type HubEngineSpawner = {
+    dialecteId: string;
+    dialecteVersion: string;
+    /** The address of the dialecte's engine worker (its `?worker&url` export). */
+    engineUrl: string;
+};
+/** A spawner as the page's host runs it: what its engine opens with, loaded when it spawns one. */
+export type RealmEngineSpawner = HubEngineSpawner & {
+    /** What the engine's kind needs to open, handed to it as is (the SQLite engine: its wasm file), loaded at spawn. */
+    settings: () => Promise<unknown>;
+    /** Measure the import's and the export's stages in the engine (`dev.perf`). */
+    perf?: boolean;
+};
+/** One engine a realm hosts for the hub. */
+export type HostedEngine = {
+    project: string;
+    dialecteId: string;
+    generation: number;
+    worker: Worker;
+    control: EngineControl;
+    /** Set once the realm ends it itself (released, the page suspending): its end is no news for the hub. */
+    ended: boolean;
+    /** The page's request of the engine lock, granted once the worker no longer holds it. */
+    watch: AbortController | undefined;
+};
+/** The engines a realm hosts, driven by what the hub asks; each answered back on the realm's control port. */
+export type RealmHost = {
+    spawn: (params: {
+        project: string;
+        dialecteId: string;
+        generation: number;
+        openBudgetMs: number;
+        expectedCreationId?: string;
+    }) => void;
+    adopt: (params: {
+        project: string;
+        generation: number;
+        adoptionId: number;
+        clientId: string;
+        port: MessagePort;
+    }) => void;
+    /** Settles once the engine has released the client (its port answers no more), or is gone. */
+    clientGone: (params: {
+        project: string;
+        generation: number;
+        clientId: string;
+    }) => Promise<void>;
+    release: (params: {
+        project: string;
+        generation: number;
+    }) => void;
+    /**
+     * Engines the page can start from now on, beside its own: a dialecte it runs already keeps its spawner, measured
+     * from now on when the one added is (`perf`).
+     */
+    add: (params: {
+        spawners: RealmEngineSpawner[];
+    }) => void;
+    /** Every engine ended at once (the page goes away or freezes): their workers terminated. */
+    endAll: () => void;
+};
+export type RealmHostParams = {
+    spawners: RealmEngineSpawner[];
+    /** Say something to the hub on the realm's control port. */
+    report: (message: RealmToHubMessage) => void;
+    /**
+     * How long an engine may take to adopt a client (`ENGINE_HEARTBEAT_TIMEOUT_MS` when absent): one silent that
+     * long is lost, the adoption reported failed.
+     */
+    adoptBudgetMs?: number;
+};
+//# sourceMappingURL=realm-host.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"realm-host.types.d.ts","sourceRoot":"","sources":["../../../../src/store/engine/hub/realm-host.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE7D;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,mGAAmG;AACnG,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG;IACnD,oHAAoH;IACpH,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAChC,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,aAAa,CAAA;IACtB,yGAAyG;IACzG,KAAK,EAAE,OAAO,CAAA;IACd,yFAAyF;IACzF,KAAK,EAAE,eAAe,GAAG,SAAS,CAAA;CAClC,CAAA;AAED,8GAA8G;AAC9G,MAAM,MAAM,SAAS,GAAG;IACvB,KAAK,EAAE,CAAC,MAAM,EAAE;QACf,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,CAAA;QAClB,YAAY,EAAE,MAAM,CAAA;QACpB,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAC3B,KAAK,IAAI,CAAA;IACV,KAAK,EAAE,CAAC,MAAM,EAAE;QACf,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,CAAA;QAClB,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,WAAW,CAAA;KACjB,KAAK,IAAI,CAAA;IACV,8FAA8F;IAC9F,UAAU,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAChG,OAAO,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IAClE;;;OAGG;IACH,GAAG,EAAE,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAA;KAAE,KAAK,IAAI,CAAA;IACzD,4FAA4F;IAC5F,MAAM,EAAE,MAAM,IAAI,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAE,kBAAkB,EAAE,CAAA;IAC9B,4DAA4D;IAC5D,MAAM,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;IAC5C;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA"}

package/dist/store/engine/project-key.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A project's key wherever its engine is found - the engine's Web Lock, its files' directory, the maps of the
+ * realms and of the hub: its dialecte's id and its name, each URI-encoded, joined by `/`. Two dialectes'
+ * projects of one name are two projects; no part can be read as the other.
+ */
+export declare function projectKeyOf(params: {
+    dialecteId: string;
+    project: string;
+}): string;
+/** The Web Lock the engine of a project holds while it runs: one engine at a time holds the project's files. */
+export declare function engineLockNameOf(params: {
+    dialecteId: string;
+    project: string;
+}): string;
+//# sourceMappingURL=project-key.d.ts.map

package/dist/store/engine/project-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-key.d.ts","sourceRoot":"","sources":["../../../src/store/engine/project-key.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAGpF;AAED,gHAAgH;AAChH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAExF"}

package/dist/store/engine/wire/error-envelope.d.ts

@@ -0,0 +1,25 @@
+import { ThrownData } from './wire.types';
+/**
+ * A thrown value as data a port carries (structured clone), causes included down to
+ * `WIRE_CAUSE_DEPTH`: no transfer handler of Comlink's is touched, so no other user of it changes.
+ */
+export declare function toThrownData(params: {
+    thrown: unknown;
+}): ThrownData;
+/**
+ * The thrown value back from its data: a structured error rebuilt as `createDialecteError` builds
+ * it (an `Error` whose `cause` is the record), so `toDialecteError` and `isKnownDialecteError` match
+ * it; any other `Error` as a plain `Error` of the same name.
+ */
+export declare function fromThrownData(params: {
+    data: ThrownData;
+}): unknown;
+/**
+ * A value a port carries: as it is when it clones; else a plain array or object rebuilt member by
+ * member, each member that does not clone as its text (a function, a symbol); a cycle as its text.
+ */
+export declare function cloneSafe(params: {
+    value: unknown;
+    ancestors?: Set<object>;
+}): unknown;
+//# sourceMappingURL=error-envelope.d.ts.map

package/dist/store/engine/wire/error-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-envelope.d.ts","sourceRoot":"","sources":["../../../../src/store/engine/wire/error-envelope.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAqB,UAAU,EAAE,MAAM,cAAc,CAAA;AAGjE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,UAAU,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG,OAAO,CAsBpE;AA8BD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,GAAG,OAAO,CAqBtF"}

package/dist/store/engine/wire/wire-values.d.ts

@@ -0,0 +1,33 @@
+import { WireJsonPlace, WireStandIn, WireValues } from './wire.types';
+/**
+ * The values of a call's arguments as plain data a port carries, read once, keys in their order: a
+ * proxy over plain data (a reactive object) crosses as what it reads as, as every store keeps it. A
+ * value that would not cross as it is - a function, a symbol, an instance of a class, a raw JSON
+ * value, an object with a `toJSON` function, a value whose reading throws (a getter, a proxy trap) -
+ * is left out and named as a stand-in, so the store's JSON check on the other side refuses it where
+ * and as it refuses the value itself. A cycle is kept as a cycle; what is nested deeper than the
+ * check reads is cut, the container that is too deep kept (empty).
+ */
+export declare function toWireValues(params: {
+    values: readonly unknown[];
+}): WireValues;
+/** The values back, each stand-in rebuilt where it was. */
+export declare function fromWireValues(params: WireValues): unknown[];
+/**
+ * A call's arguments as a port carries them: the values at its JSON places copied by
+ * `toWireValues` (stand-ins indexed by place), every other argument as it is (a `File`, a `Blob`).
+ */
+export declare function toWireArgs(params: {
+    args: readonly unknown[];
+    places: readonly WireJsonPlace[];
+}): {
+    args: unknown[];
+    standIns: WireStandIn[];
+};
+/** The arguments back, each stand-in rebuilt at its place. */
+export declare function fromWireArgs(params: {
+    args: readonly unknown[];
+    places: readonly WireJsonPlace[];
+    standIns: WireStandIn[];
+}): unknown[];
+//# sourceMappingURL=wire-values.d.ts.map

package/dist/store/engine/wire/wire-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-values.d.ts","sourceRoot":"","sources":["../../../../src/store/engine/wire/wire-values.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEX,aAAa,EACb,WAAW,EAEX,UAAU,EACV,MAAM,cAAc,CAAA;AAGrB;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GAAG,UAAU,CAW/E;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,EAAE,CAe5D;AA4QD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IAClC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;IACxB,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;CAChC,GAAG;IAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAAC,QAAQ,EAAE,WAAW,EAAE,CAAA;CAAE,CAoB/C;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACpC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;IACxB,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;IAChC,QAAQ,EAAE,WAAW,EAAE,CAAA;CACvB,GAAG,OAAO,EAAE,CAUZ"}

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

@@ -0,0 +1,116 @@
+/**
+ * The version of what crosses between a client and an engine (the wire table, the signals, the control
+ * messages): the engine says it as it opens, and a client of another version refuses it - each runs its
+ * own copy of the library.
+ */
+export declare const ENGINE_WIRE_PROTOCOL = 2;
+/** How many causes of a thrown error cross a port with it: the deeper ones are left behind. */
+export declare const WIRE_CAUSE_DEPTH = 4;
+/**
+ * Every member of the engine a client calls over a port, and how it crosses: the one table of the wire
+ * (a member of the engine's API missing here fails the type check).
+ */
+export declare const ENGINE_WIRE_MEMBERS: {
+    readonly registerDocument: {
+        readonly json: readonly [{
+            readonly argument: 0;
+        }];
+    };
+    readonly getDocument: {
+        readonly read: true;
+    };
+    readonly getDocuments: {
+        readonly read: true;
+    };
+    readonly updateDocument: {
+        readonly json: readonly [{
+            readonly argument: 1;
+        }];
+    };
+    readonly removeDocument: {};
+    readonly get: {
+        readonly read: true;
+    };
+    readonly getByDocumentId: {
+        readonly read: true;
+    };
+    readonly count: {
+        readonly read: true;
+    };
+    readonly getByTagNameInDocument: {
+        readonly read: true;
+    };
+    readonly getMany: {
+        readonly read: true;
+    };
+    readonly bulkWrite: {
+        readonly json: readonly [{
+            readonly argument: 1;
+            readonly path: readonly ["creates"];
+        }, {
+            readonly argument: 1;
+            readonly path: readonly ["updates"];
+        }];
+    };
+    readonly getWriteOutcome: {
+        readonly read: true;
+    };
+    readonly undo: {};
+    readonly redo: {};
+    readonly getHistoryStatus: {
+        readonly read: true;
+    };
+    readonly getChangeLog: {
+        readonly read: true;
+    };
+    readonly commit: {
+        readonly json: readonly [{
+            readonly argument: 0;
+            readonly path: readonly ["creates"];
+        }, {
+            readonly argument: 0;
+            readonly path: readonly ["updates"];
+        }];
+        readonly listener: 1;
+        readonly identified: true;
+    };
+    readonly importFile: {
+        readonly json: readonly [{
+            readonly argument: 0;
+            readonly path: readonly ["options"];
+        }];
+        readonly listener: 1;
+        readonly identified: true;
+    };
+    readonly abortImport: {};
+    readonly exportFile: {
+        readonly listener: 1;
+        readonly abortable: true;
+    };
+    readonly abortExport: {};
+    readonly addBlob: {
+        readonly json: readonly [{
+            readonly argument: 0;
+        }];
+    };
+    readonly getBlob: {
+        readonly read: true;
+    };
+    readonly getBlobsByDocument: {
+        readonly read: true;
+    };
+    readonly getBlobsByRecord: {
+        readonly read: true;
+    };
+    readonly getStandaloneBlobs: {
+        readonly read: true;
+    };
+    readonly attachBlob: {
+        readonly json: readonly [{
+            readonly argument: 1;
+        }];
+    };
+    readonly detachBlob: {};
+    readonly removeBlob: {};
+};
+//# sourceMappingURL=wire.constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wire.constants.d.ts","sourceRoot":"","sources":["../../../../src/store/engine/wire/wire.constants.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB,IAAI,CAAA;AAEjC;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C4B,CAAA"}