@inhuman.tools/harness 0.0.0-stage → 0.1.0

package/dist/protocol/document/checkpoint.js.map

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

package/dist/protocol/document/frames.d.ts

@@ -0,0 +1,15 @@
+import * as Y from "yjs";
+export declare const MESSAGE_SYNC = 0;
+export declare const MESSAGE_AWARENESS = 1;
+/** y-websocket `messageQueryAwareness`. Inbound counts as traffic for its 30s watchdog. */
+export declare const MESSAGE_QUERY_AWARENESS = 3;
+export declare function encodeDocUpdate(update: Uint8Array): Uint8Array;
+export declare function encodeSyncStep1(doc: Y.Doc): Uint8Array;
+export declare function replyLensSyncFrame(frame: Uint8Array, live: Y.Doc): Uint8Array | null;
+/** Document peer: STEP1 replies STEP2; STEP2/UPDATE apply onto `live` with `origin`. */
+export declare function applyPeerSyncFrame(frame: Uint8Array, live: Y.Doc, origin: unknown): Uint8Array | null;
+export declare function peekMessageType(frame: Uint8Array): number;
+export declare function encodeQueryAwareness(): Uint8Array;
+export declare function encodeAwarenessFrame(payload: Uint8Array): Uint8Array;
+export declare function decodeAwarenessPayload(frame: Uint8Array): Uint8Array | null;
+//# sourceMappingURL=frames.d.ts.map

package/dist/protocol/document/frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../../src/protocol/document/frames.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,2FAA2F;AAC3F,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAK9D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,UAAU,CAKtD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,GAAG,UAAU,GAAG,IAAI,CAQpF;AAED,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAOrG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEzD;AAED,wBAAgB,oBAAoB,IAAI,UAAU,CAIjD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAKpE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAQ3E"}

package/dist/protocol/document/frames.js

@@ -0,0 +1,66 @@
+import * as decoding from "lib0/decoding";
+import * as encoding from "lib0/encoding";
+import * as syncProtocol from "y-protocols/sync";
+export const MESSAGE_SYNC = 0;
+export const MESSAGE_AWARENESS = 1;
+/** y-websocket `messageQueryAwareness`. Inbound counts as traffic for its 30s watchdog. */
+export const MESSAGE_QUERY_AWARENESS = 3;
+export function encodeDocUpdate(update) {
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, MESSAGE_SYNC);
+    syncProtocol.writeUpdate(encoder, update);
+    return encoding.toUint8Array(encoder);
+}
+export function encodeSyncStep1(doc) {
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, MESSAGE_SYNC);
+    syncProtocol.writeSyncStep1(encoder, doc);
+    return encoding.toUint8Array(encoder);
+}
+export function replyLensSyncFrame(frame, live) {
+    const decoder = decoding.createDecoder(frame);
+    if (decoding.readVarUint(decoder) !== MESSAGE_SYNC)
+        return null;
+    if (decoding.readVarUint(decoder) !== syncProtocol.messageYjsSyncStep1)
+        return null;
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, MESSAGE_SYNC);
+    syncProtocol.readSyncStep1(decoder, encoder, live);
+    return encoding.length(encoder) > 1 ? encoding.toUint8Array(encoder) : null;
+}
+/** Document peer: STEP1 replies STEP2; STEP2/UPDATE apply onto `live` with `origin`. */
+export function applyPeerSyncFrame(frame, live, origin) {
+    const decoder = decoding.createDecoder(frame);
+    if (decoding.readVarUint(decoder) !== MESSAGE_SYNC)
+        return null;
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, MESSAGE_SYNC);
+    syncProtocol.readSyncMessage(decoder, encoder, live, origin);
+    return encoding.length(encoder) > 1 ? encoding.toUint8Array(encoder) : null;
+}
+export function peekMessageType(frame) {
+    return decoding.readVarUint(decoding.createDecoder(frame));
+}
+export function encodeQueryAwareness() {
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, MESSAGE_QUERY_AWARENESS);
+    return encoding.toUint8Array(encoder);
+}
+export function encodeAwarenessFrame(payload) {
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, MESSAGE_AWARENESS);
+    encoding.writeVarUint8Array(encoder, payload);
+    return encoding.toUint8Array(encoder);
+}
+export function decodeAwarenessPayload(frame) {
+    try {
+        const decoder = decoding.createDecoder(frame);
+        if (decoding.readVarUint(decoder) !== MESSAGE_AWARENESS)
+            return null;
+        return decoding.readVarUint8Array(decoder);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=frames.js.map

package/dist/protocol/document/frames.js.map

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

package/dist/protocol/document/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./keys.js";
+export * from "./checkpoint.js";
+export * from "./inventory.js";
+export * from "./occupancy.js";
+export * from "./ordering.js";
+export * from "./private.js";
+export { applyPeerSyncFrame, decodeAwarenessPayload, encodeAwarenessFrame, encodeDocUpdate, encodeQueryAwareness, encodeSyncStep1, MESSAGE_AWARENESS, MESSAGE_QUERY_AWARENESS, MESSAGE_SYNC, peekMessageType, replyLensSyncFrame, } from "@inhuman.tools/harness-peer/frames";
+export { bindPlexusAwareness, encodeLocalAwarenessFrame, forwardPlexusAwareness, ingestPlexusAwareness, REMOTE_AWARENESS_ORIGIN, type AwarenessPlane, type AwarenessUpdate, } from "@inhuman.tools/harness-peer/awareness";
+//# sourceMappingURL=index.d.ts.map

package/dist/protocol/document/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/protocol/document/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAG7B,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,eAAe,EACf,kBAAkB,GACnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,uCAAuC,CAAC"}

package/dist/protocol/document/index.js

@@ -0,0 +1,11 @@
+export * from "./keys.js";
+export * from "./checkpoint.js";
+export * from "./inventory.js";
+export * from "./occupancy.js";
+export * from "./ordering.js";
+export * from "./private.js";
+// The Yjs frame codecs and the awareness plane live in the browser-safe peer package.
+// Subpaths, not the barrel: the barrel registers every synced model, which the Yjs server does not need.
+export { applyPeerSyncFrame, decodeAwarenessPayload, encodeAwarenessFrame, encodeDocUpdate, encodeQueryAwareness, encodeSyncStep1, MESSAGE_AWARENESS, MESSAGE_QUERY_AWARENESS, MESSAGE_SYNC, peekMessageType, replyLensSyncFrame, } from "@inhuman.tools/harness-peer/frames";
+export { bindPlexusAwareness, encodeLocalAwarenessFrame, forwardPlexusAwareness, ingestPlexusAwareness, REMOTE_AWARENESS_ORIGIN, } from "@inhuman.tools/harness-peer/awareness";
+//# sourceMappingURL=index.js.map

package/dist/protocol/document/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/protocol/document/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,sFAAsF;AACtF,yGAAyG;AACzG,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,eAAe,EACf,kBAAkB,GACnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,GAGxB,MAAM,uCAAuC,CAAC"}

package/dist/protocol/document/inventory.d.ts

@@ -0,0 +1,37 @@
+import { type DocumentKey, type DocumentKind } from "./keys.js";
+export type InventoryEntry = {
+    readonly key: DocumentKey;
+    readonly durableRevision: number;
+    readonly storagePath: string;
+};
+export type InventoryCheckpoint = {
+    readonly serverEpoch: number;
+    readonly cut: number;
+};
+export type InventoryPage = {
+    readonly entries: readonly InventoryEntry[];
+    readonly cursor: string | null;
+    readonly checkpoint: InventoryCheckpoint;
+};
+export type InventoryListQuery = {
+    readonly kind: DocumentKind;
+    readonly cursor: string | null;
+};
+export type InventoryGapReason = "overflow" | "missing-checkpoint" | "epoch-change";
+export type InventoryWatchEvent = {
+    readonly type: "change";
+    readonly key: DocumentKey;
+    readonly revision: number;
+} | {
+    readonly type: "gap";
+    readonly reason: InventoryGapReason;
+    readonly serverEpoch: number;
+};
+export type InventoryErrorReason = "mismatch" | "corrupt" | "empty" | "decode-failure";
+export type InventoryError = {
+    readonly storagePath: string;
+    readonly reason: InventoryErrorReason;
+};
+export declare function encodeInventoryWatchEvent(event: InventoryWatchEvent): Uint8Array;
+export declare function decodeInventoryWatchEvent(bytes: Uint8Array): InventoryWatchEvent | null;
+//# sourceMappingURL=inventory.d.ts.map

package/dist/protocol/document/inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../../../src/protocol/document/inventory.ts"],"names":[],"mappings":"AAOA,OAAO,EAAqC,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAEnG,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,oBAAoB,GAAG,cAAc,CAAC;AAEpF,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEN,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,gBAAgB,CAAC;AAEvF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;CACvC,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,GAAG,UAAU,CAYhF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,GAAG,IAAI,CAmBvF"}

package/dist/protocol/document/inventory.js

@@ -0,0 +1,44 @@
+/**
+ * Identity inventory: catalog rows, pagination cuts, invalidations, and
+ * explicit gaps. Filenames are hashes; overviews are not the catalog.
+ */
+import * as decoding from "lib0/decoding";
+import * as encoding from "lib0/encoding";
+import { readDocumentKey, writeDocumentKey } from "./keys.js";
+export function encodeInventoryWatchEvent(event) {
+    const encoder = encoding.createEncoder();
+    if (event.type === "change") {
+        encoding.writeVarUint(encoder, 0);
+        writeDocumentKey(encoder, event.key);
+        encoding.writeVarUint(encoder, event.revision);
+    }
+    else {
+        encoding.writeVarUint(encoder, 1);
+        encoding.writeVarString(encoder, event.reason);
+        encoding.writeVarUint(encoder, event.serverEpoch);
+    }
+    return encoding.toUint8Array(encoder);
+}
+export function decodeInventoryWatchEvent(bytes) {
+    try {
+        const decoder = decoding.createDecoder(bytes);
+        const type = decoding.readVarUint(decoder);
+        if (type === 0) {
+            const key = readDocumentKey(decoder);
+            const revision = decoding.readVarUint(decoder);
+            return { type: "change", key, revision };
+        }
+        if (type === 1) {
+            const reason = decoding.readVarString(decoder);
+            if (reason !== "overflow" && reason !== "missing-checkpoint" && reason !== "epoch-change")
+                return null;
+            const serverEpoch = decoding.readVarUint(decoder);
+            return { type: "gap", reason, serverEpoch };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=inventory.js.map

package/dist/protocol/document/inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.js","sourceRoot":"","sources":["../../../src/protocol/document/inventory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAuC,MAAM,WAAW,CAAC;AA6CnG,MAAM,UAAU,yBAAyB,CAAC,KAA0B;IAClE,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;IACzC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAClC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAClC,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/C,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAiB;IACzD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC/C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;QAC3C,CAAC;QACD,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,oBAAoB,IAAI,MAAM,KAAK,cAAc;gBAAE,OAAO,IAAI,CAAC;YACvG,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAClD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/protocol/document/keys.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Document identity, public rooms, storage-path hashing, and Y.Doc guid
+ * prefixes. Directory names are not identities; images live at
+ * `documents/{kind}/{sha256(id)}.yjs`.
+ */
+import * as decoding from "lib0/decoding";
+import * as encoding from "lib0/encoding";
+export declare const DOCUMENT_KINDS: readonly ["kernel", "sessions", "projects"];
+export type DocumentKind = (typeof DOCUMENT_KINDS)[number];
+export type DocumentKey = {
+    readonly kind: DocumentKind;
+    readonly id: string;
+};
+/** Storage kind `kernel`, identity `"kernel"`. */
+export declare const KERNEL_DOCUMENT_KEY: DocumentKey;
+/** Matches KernelPlexus. A project guid is minted, not hashed from path. */
+export declare const KERNEL_DOCUMENT_GUID = "harness:kernel";
+export declare const SESSION_DOCUMENT_GUID_PREFIX = "harness:session:";
+export declare const PROJECT_DOCUMENT_GUID_PREFIX = "harness:project";
+export declare const PUBLIC_ROOM: {
+    readonly kernel: "kernel";
+    readonly project: "project";
+    readonly session: "session";
+};
+export type PublicRoomName = (typeof PUBLIC_ROOM)[keyof typeof PUBLIC_ROOM];
+export declare function isDocumentKind(value: string): value is DocumentKind;
+export declare function parseDocumentKind(value: string): DocumentKind;
+export declare function documentKey(kind: DocumentKind, id: string): DocumentKey;
+export declare function documentKeysEqual(a: DocumentKey, b: DocumentKey): boolean;
+export declare function sessionDocumentGuid(sessionId: string): string;
+export declare function publicRoomName(kind: DocumentKind): PublicRoomName;
+export declare function sha256Hex(id: string): string;
+export declare function documentImageFileName(id: string): string;
+/** Path segments under a daemon root. Join with the platform separator at the store. */
+export declare function documentImageSegments(kind: string, id: string): readonly ["documents", string, string];
+export declare function writeDocumentKey(encoder: encoding.Encoder, key: DocumentKey): void;
+export declare function readDocumentKey(decoder: decoding.Decoder): DocumentKey;
+//# sourceMappingURL=keys.d.ts.map

package/dist/protocol/document/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/protocol/document/keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAG1C,eAAO,MAAM,cAAc,6CAA8C,CAAC;AAC1E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,mBAAmB,EAAE,WAGjC,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AACrD,eAAO,MAAM,4BAA4B,qBAAqB,CAAC;AAC/D,eAAO,MAAM,4BAA4B,oBAAoB,CAAC;AAE9D,eAAO,MAAM,WAAW;;;;CAId,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAE5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAEnE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAG7D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,CAIvE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAEzE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CASjE;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wFAAwF;AACxF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,CAEtG;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAGlF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,GAAG,WAAW,CAEtE"}

package/dist/protocol/document/keys.js

@@ -0,0 +1,77 @@
+/**
+ * Document identity, public rooms, storage-path hashing, and Y.Doc guid
+ * prefixes. Directory names are not identities; images live at
+ * `documents/{kind}/{sha256(id)}.yjs`.
+ */
+import * as decoding from "lib0/decoding";
+import * as encoding from "lib0/encoding";
+import { digest } from "lib0/hash/sha256";
+export const DOCUMENT_KINDS = ["kernel", "sessions", "projects"];
+/** Storage kind `kernel`, identity `"kernel"`. */
+export const KERNEL_DOCUMENT_KEY = {
+    kind: "kernel",
+    id: "kernel",
+};
+/** Matches KernelPlexus. A project guid is minted, not hashed from path. */
+export const KERNEL_DOCUMENT_GUID = "harness:kernel";
+export const SESSION_DOCUMENT_GUID_PREFIX = "harness:session:";
+export const PROJECT_DOCUMENT_GUID_PREFIX = "harness:project";
+export const PUBLIC_ROOM = {
+    kernel: "kernel",
+    project: "project",
+    session: "session",
+};
+export function isDocumentKind(value) {
+    return value === "kernel" || value === "sessions" || value === "projects";
+}
+export function parseDocumentKind(value) {
+    if (isDocumentKind(value))
+        return value;
+    throw new Error(`unknown document kind: ${value}`);
+}
+export function documentKey(kind, id) {
+    const trimmed = id.trim();
+    if (trimmed === "")
+        throw new Error("document id is required");
+    return { kind, id: trimmed };
+}
+export function documentKeysEqual(a, b) {
+    return a.kind === b.kind && a.id === b.id;
+}
+export function sessionDocumentGuid(sessionId) {
+    return `${SESSION_DOCUMENT_GUID_PREFIX}${sessionId}`;
+}
+export function publicRoomName(kind) {
+    switch (kind) {
+        case "kernel":
+            return PUBLIC_ROOM.kernel;
+        case "projects":
+            return PUBLIC_ROOM.project;
+        case "sessions":
+            return PUBLIC_ROOM.session;
+    }
+}
+export function sha256Hex(id) {
+    return hex(digest(new TextEncoder().encode(id)));
+}
+export function documentImageFileName(id) {
+    return `${sha256Hex(id)}.yjs`;
+}
+/** Path segments under a daemon root. Join with the platform separator at the store. */
+export function documentImageSegments(kind, id) {
+    return ["documents", kind, documentImageFileName(id)];
+}
+export function writeDocumentKey(encoder, key) {
+    encoding.writeVarString(encoder, key.kind);
+    encoding.writeVarString(encoder, key.id);
+}
+export function readDocumentKey(decoder) {
+    return documentKey(parseDocumentKind(decoding.readVarString(decoder)), decoding.readVarString(decoder));
+}
+function hex(bytes) {
+    let out = "";
+    for (const byte of bytes)
+        out += byte.toString(16).padStart(2, "0");
+    return out;
+}
+//# sourceMappingURL=keys.js.map

package/dist/protocol/document/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/protocol/document/keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;AAQ1E,kDAAkD;AAClD,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC9C,IAAI,EAAE,QAAQ;IACd,EAAE,EAAE,QAAQ;CACb,CAAC;AAEF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AACrD,MAAM,CAAC,MAAM,4BAA4B,GAAG,kBAAkB,CAAC;AAC/D,MAAM,CAAC,MAAM,4BAA4B,GAAG,iBAAiB,CAAC;AAE9D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACV,CAAC;AAGX,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,UAAU,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,cAAc,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAkB,EAAE,EAAU;IACxD,MAAM,OAAO,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,OAAO,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/D,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,CAAc,EAAE,CAAc;IAC9D,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,OAAO,GAAG,4BAA4B,GAAG,SAAS,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAkB;IAC/C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,WAAW,CAAC,MAAM,CAAC;QAC5B,KAAK,UAAU;YACb,OAAO,WAAW,CAAC,OAAO,CAAC;QAC7B,KAAK,UAAU;YACb,OAAO,WAAW,CAAC,OAAO,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,EAAU;IAC9C,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC;AAChC,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,EAAU;IAC5D,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAyB,EAAE,GAAgB;IAC1E,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3C,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,OAAO,WAAW,CAAC,iBAAiB,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAC1G,CAAC;AAED,SAAS,GAAG,CAAC,KAAiB;IAC5B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpE,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/protocol/document/occupancy.d.ts

@@ -0,0 +1,13 @@
+export type OccupancySeat = {
+    readonly sessionId: string;
+    readonly clientId: number;
+};
+export type OccupancySnapshot = {
+    readonly serverEpoch: number;
+    readonly sequence: number;
+    readonly seats: readonly OccupancySeat[];
+};
+export declare function occupiedSessionIdsOf(snapshot: OccupancySnapshot): Set<string>;
+export declare function encodeOccupancySnapshot(snapshot: OccupancySnapshot): Uint8Array;
+export declare function decodeOccupancySnapshot(bytes: Uint8Array): OccupancySnapshot | null;
+//# sourceMappingURL=occupancy.d.ts.map

package/dist/protocol/document/occupancy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"occupancy.d.ts","sourceRoot":"","sources":["../../../src/protocol/document/occupancy.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C,CAAC;AAiBF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,GAAG,CAAC,MAAM,CAAC,CAI7E;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,UAAU,CAE/E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,iBAAiB,GAAG,IAAI,CAOnF"}

package/dist/protocol/document/occupancy.js

@@ -0,0 +1,38 @@
+/**
+ * Occupancy facts the sync server supplies to runtime. Awareness is
+ * ephemeral; unknown occupancy is not a seat grant. Membership changes are
+ * stamped with a monotonic sequence and delivered atomically.
+ */
+import { z } from "zod";
+const occupancySeatSchema = z
+    .object({
+    sessionId: z.string().trim().min(1),
+    clientId: z.number().int(),
+})
+    .strict();
+const occupancySnapshotSchema = z
+    .object({
+    serverEpoch: z.number().int().nonnegative(),
+    sequence: z.number().int().nonnegative(),
+    seats: z.array(occupancySeatSchema),
+})
+    .strict();
+export function occupiedSessionIdsOf(snapshot) {
+    const ids = new Set();
+    for (const seat of snapshot.seats)
+        ids.add(seat.sessionId);
+    return ids;
+}
+export function encodeOccupancySnapshot(snapshot) {
+    return new TextEncoder().encode(JSON.stringify(snapshot));
+}
+export function decodeOccupancySnapshot(bytes) {
+    try {
+        const parsed = occupancySnapshotSchema.safeParse(JSON.parse(new TextDecoder().decode(bytes)));
+        return parsed.success ? parsed.data : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=occupancy.js.map

package/dist/protocol/document/occupancy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"occupancy.js","sourceRoot":"","sources":["../../../src/protocol/document/occupancy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,MAAM,mBAAmB,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CAC3B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,uBAAuB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACxC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC;CACpC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,UAAU,oBAAoB,CAAC,QAA2B;IAC9D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK;QAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAA2B;IACjE,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAiB;IACvD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9F,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/protocol/document/ordering.d.ts

@@ -0,0 +1,41 @@
+import { type DocumentKey } from "./keys.js";
+export declare const FRAME_CLASSES: readonly ["occupancy", "control", "barrier", "rpc", "sync"];
+export type FrameClass = (typeof FRAME_CLASSES)[number];
+/** Lower runs first when the private connection must shed bulk sync. */
+export declare const FRAME_CLASS_PRIORITY: Record<FrameClass, number>;
+export type SequenceRelation = "ok" | "duplicate" | "gap" | "reset";
+export type PrivateEnvelope = {
+    readonly connectionEpoch: number;
+    readonly sequence: number;
+    readonly class: FrameClass;
+    readonly document?: DocumentKey;
+    readonly payload: Uint8Array;
+};
+export declare function compareSchedulePriority(a: FrameClass, b: FrameClass): number;
+export declare function sequenceRelation(prev: number, next: number): SequenceRelation;
+export type SequenceState = {
+    epoch: number;
+    sequence: number;
+};
+export type EnvelopeAdmission = {
+    readonly action: "apply";
+} | {
+    readonly action: "reset";
+} | {
+    readonly action: "drop";
+    readonly reason: "duplicate";
+} | {
+    readonly action: "reject";
+    readonly reason: "gap" | "reset" | "stale-epoch";
+};
+/**
+ * Admit one inbound envelope. Sequence is the wire order; a newer connection
+ * epoch resets the clock at sequence 1. The caller updates `state` only on
+ * apply/reset.
+ */
+export declare function admitPrivateEnvelope(state: SequenceState, envelope: PrivateEnvelope): EnvelopeAdmission;
+export declare function advanceSequenceState(state: SequenceState, envelope: PrivateEnvelope): void;
+export declare function encodePrivateEnvelope(envelope: PrivateEnvelope): Uint8Array;
+export declare function decodePrivateEnvelope(bytes: Uint8Array): PrivateEnvelope | null;
+export declare function peekEnvelopeClass(bytes: Uint8Array): FrameClass | null;
+//# sourceMappingURL=ordering.d.ts.map

package/dist/protocol/document/ordering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordering.d.ts","sourceRoot":"","sources":["../../../src/protocol/document/ordering.ts"],"names":[],"mappings":"AAQA,OAAO,EAAqC,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEhF,eAAO,MAAM,aAAa,6DAA8D,CAAC;AACzF,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAM3D,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,WAAW,GAAG,KAAK,GAAG,OAAO,CAAC;AAEpE,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;CAC9B,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,CAE5E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAK7E;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GACzD;IACE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,aAAa,CAAC;CAClD,CAAC;AAEN;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,GAAG,iBAAiB,CAcvG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAG1F;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,CAa3E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,GAAG,IAAI,CAkB/E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAStE"}

package/dist/protocol/document/ordering.js

@@ -0,0 +1,104 @@
+/**
+ * Private document-addressed envelope. Each direction has a monotonic
+ * sequence per connection epoch. Occupancy/control are a schedule-priority
+ * class ahead of bulk sync; sequence is still the wire order.
+ */
+import * as decoding from "lib0/decoding";
+import * as encoding from "lib0/encoding";
+import { readDocumentKey, writeDocumentKey } from "./keys.js";
+export const FRAME_CLASSES = ["occupancy", "control", "barrier", "rpc", "sync"];
+/** Lower runs first when the private connection must shed bulk sync. */
+export const FRAME_CLASS_PRIORITY = {
+    occupancy: 0,
+    control: 1,
+    barrier: 2,
+    rpc: 3,
+    sync: 4,
+};
+export function compareSchedulePriority(a, b) {
+    return FRAME_CLASS_PRIORITY[a] - FRAME_CLASS_PRIORITY[b];
+}
+export function sequenceRelation(prev, next) {
+    if (next === prev)
+        return "duplicate";
+    if (next === prev + 1)
+        return "ok";
+    if (next > prev + 1)
+        return "gap";
+    return "reset";
+}
+/**
+ * Admit one inbound envelope. Sequence is the wire order; a newer connection
+ * epoch resets the clock at sequence 1. The caller updates `state` only on
+ * apply/reset.
+ */
+export function admitPrivateEnvelope(state, envelope) {
+    if (envelope.connectionEpoch < state.epoch) {
+        return { action: "reject", reason: "stale-epoch" };
+    }
+    if (envelope.connectionEpoch > state.epoch) {
+        if (envelope.sequence !== 1) {
+            return { action: "reject", reason: "gap" };
+        }
+        return { action: "reset" };
+    }
+    const relation = sequenceRelation(state.sequence, envelope.sequence);
+    if (relation === "ok")
+        return { action: "apply" };
+    if (relation === "duplicate")
+        return { action: "drop", reason: "duplicate" };
+    return { action: "reject", reason: relation };
+}
+export function advanceSequenceState(state, envelope) {
+    state.epoch = envelope.connectionEpoch;
+    state.sequence = envelope.sequence;
+}
+export function encodePrivateEnvelope(envelope) {
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, envelope.connectionEpoch);
+    encoding.writeVarUint(encoder, envelope.sequence);
+    encoding.writeVarUint(encoder, FRAME_CLASS_PRIORITY[envelope.class]);
+    if (envelope.document == null) {
+        encoding.writeVarUint(encoder, 0);
+    }
+    else {
+        encoding.writeVarUint(encoder, 1);
+        writeDocumentKey(encoder, envelope.document);
+    }
+    encoding.writeVarUint8Array(encoder, envelope.payload);
+    return encoding.toUint8Array(encoder);
+}
+export function decodePrivateEnvelope(bytes) {
+    try {
+        const decoder = decoding.createDecoder(bytes);
+        const connectionEpoch = decoding.readVarUint(decoder);
+        const sequence = decoding.readVarUint(decoder);
+        const classCode = decoding.readVarUint(decoder);
+        const frameClass = FRAME_CLASSES.at(classCode);
+        if (frameClass === undefined)
+            return null;
+        const hasDocument = decoding.readVarUint(decoder);
+        const document = hasDocument === 1 ? readDocumentKey(decoder) : undefined;
+        if (hasDocument !== 0 && hasDocument !== 1)
+            return null;
+        const payload = decoding.readVarUint8Array(decoder);
+        return document == null
+            ? { connectionEpoch, sequence, class: frameClass, payload }
+            : { connectionEpoch, sequence, class: frameClass, document, payload };
+    }
+    catch {
+        return null;
+    }
+}
+export function peekEnvelopeClass(bytes) {
+    try {
+        const decoder = decoding.createDecoder(bytes);
+        decoding.readVarUint(decoder);
+        decoding.readVarUint(decoder);
+        return FRAME_CLASSES.at(decoding.readVarUint(decoder)) ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=ordering.js.map

package/dist/protocol/document/ordering.js.map

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