@inhuman.tools/harness 0.0.0-stage → 0.2.0

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":"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"}

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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"}

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

@@ -0,0 +1,84 @@
+import { type DocumentCheckpoint, type FlushResult } from "./checkpoint.js";
+import { type DocumentKey } from "./keys.js";
+import { type SupervisionIdentity } from "../schemas/identity.js";
+declare const PRIVATE_AUTH_REASONS: readonly ["unauthorized", "busy", "stale"];
+export type PrivateAuthReason = (typeof PRIVATE_AUTH_REASONS)[number];
+declare const PRIVATE_REJECT_REASONS: readonly ["stale-epoch", "gap", "reset"];
+export type PrivateRejectReason = (typeof PRIVATE_REJECT_REASONS)[number];
+declare const PRIVATE_OPEN_FAIL_REASONS: readonly ["not-found", "overload", "corrupt"];
+export type PrivateOpenFailReason = (typeof PRIVATE_OPEN_FAIL_REASONS)[number];
+declare const PRIVATE_CREATE_FAIL_REASONS: readonly ["overload", "storage-failed"];
+export type PrivateCreateFailReason = (typeof PRIVATE_CREATE_FAIL_REASONS)[number];
+export type PrivateHello = {
+    readonly capability: string;
+    readonly identity: SupervisionIdentity;
+};
+export type PrivateHelloAck = {
+    readonly ok: true;
+    readonly serverEpoch: number;
+    readonly runtimeGeneration: number;
+    readonly connectionEpoch: number;
+} | {
+    readonly ok: false;
+    readonly reason: PrivateAuthReason;
+};
+export type PrivateSnapshotAck = {
+    readonly requestId: number;
+    readonly revision: number;
+    readonly guid: string;
+    readonly image: Uint8Array;
+};
+export type PrivateControl = {
+    readonly op: "hello";
+    readonly hello: PrivateHello;
+} | {
+    readonly op: "hello-ack";
+    readonly ack: PrivateHelloAck;
+} | {
+    readonly op: "open-existing";
+    readonly requestId: number;
+    readonly key: DocumentKey;
+} | {
+    readonly op: "create";
+    readonly requestId: number;
+    readonly key: DocumentKey;
+    readonly initial: Uint8Array;
+} | {
+    readonly op: "release";
+    readonly requestId: number;
+    readonly key: DocumentKey;
+} | ({
+    readonly op: "opened";
+} & PrivateSnapshotAck) | ({
+    readonly op: "created";
+} & PrivateSnapshotAck) | {
+    readonly op: "open-failed";
+    readonly requestId: number;
+    readonly reason: PrivateOpenFailReason;
+} | {
+    readonly op: "create-failed";
+    readonly requestId: number;
+    readonly reason: PrivateCreateFailReason;
+} | {
+    readonly op: "released";
+    readonly requestId: number;
+} | {
+    readonly op: "reject";
+    readonly reason: PrivateRejectReason;
+};
+export type BarrierRequest = {
+    readonly requestId: number;
+    readonly checkpoint: DocumentCheckpoint;
+};
+export type BarrierReply = {
+    readonly requestId: number;
+    readonly result: FlushResult;
+};
+export declare function encodePrivateControl(control: PrivateControl): Uint8Array;
+export declare function decodePrivateControl(bytes: Uint8Array): PrivateControl | null;
+export declare function encodeBarrierRequest(request: BarrierRequest): Uint8Array;
+export declare function decodeBarrierRequest(bytes: Uint8Array): BarrierRequest | null;
+export declare function encodeBarrierReply(reply: BarrierReply): Uint8Array;
+export declare function decodeBarrierReply(bytes: Uint8Array): BarrierReply | null;
+export {};
+//# sourceMappingURL=private.d.ts.map

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

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

package/dist/protocol/document/private.js

@@ -0,0 +1,260 @@
+/**
+ * Authenticated private-peer payloads. Envelopes live in ordering.ts;
+ * this module is hello/control/barrier bodies, not public Yjs frames.
+ */
+import * as decoding from "lib0/decoding";
+import * as encoding from "lib0/encoding";
+import { decodeDocumentCheckpoint, encodeDocumentCheckpoint, encodeDurableReceipt, decodeDurableReceipt, } from "./checkpoint.js";
+import { readDocumentKey, writeDocumentKey } from "./keys.js";
+import { supervisionIdentitySchema } from "../schemas/identity.js";
+const PRIVATE_AUTH_REASONS = ["unauthorized", "busy", "stale"];
+const PRIVATE_REJECT_REASONS = ["stale-epoch", "gap", "reset"];
+const PRIVATE_OPEN_FAIL_REASONS = ["not-found", "overload", "corrupt"];
+const PRIVATE_CREATE_FAIL_REASONS = ["overload", "storage-failed"];
+const CONTROL_OPS = [
+    "hello",
+    "hello-ack",
+    "open-existing",
+    "opened",
+    "open-failed",
+    "create",
+    "created",
+    "create-failed",
+    "release",
+    "released",
+    "reject",
+];
+function writeIdentity(encoder, identity) {
+    encoding.writeVarString(encoder, identity.hypervisor.kind);
+    encoding.writeVarString(encoder, identity.hypervisor.id);
+    encoding.writeVarString(encoder, identity.process.kind);
+    encoding.writeVarString(encoder, identity.process.id);
+    encoding.writeVarUint(encoder, identity.serverEpoch);
+    encoding.writeVarUint(encoder, identity.runtimeGeneration);
+    encoding.writeVarUint(encoder, identity.connectionEpoch);
+}
+function readIdentity(decoder) {
+    return supervisionIdentitySchema.parse({
+        hypervisor: {
+            kind: decoding.readVarString(decoder),
+            id: decoding.readVarString(decoder),
+        },
+        process: {
+            kind: decoding.readVarString(decoder),
+            id: decoding.readVarString(decoder),
+        },
+        serverEpoch: decoding.readVarUint(decoder),
+        runtimeGeneration: decoding.readVarUint(decoder),
+        connectionEpoch: decoding.readVarUint(decoder),
+    });
+}
+function writeSnapshot(encoder, snapshot) {
+    encoding.writeVarUint(encoder, snapshot.requestId);
+    encoding.writeVarUint(encoder, snapshot.revision);
+    encoding.writeVarString(encoder, snapshot.guid);
+    encoding.writeVarUint8Array(encoder, snapshot.image);
+}
+function readSnapshot(decoder) {
+    return {
+        requestId: decoding.readVarUint(decoder),
+        revision: decoding.readVarUint(decoder),
+        guid: decoding.readVarString(decoder),
+        image: decoding.readVarUint8Array(decoder),
+    };
+}
+export function encodePrivateControl(control) {
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, CONTROL_OPS.indexOf(control.op));
+    switch (control.op) {
+        case "hello":
+            encoding.writeVarString(encoder, control.hello.capability);
+            writeIdentity(encoder, control.hello.identity);
+            break;
+        case "hello-ack":
+            if (control.ack.ok) {
+                encoding.writeVarUint(encoder, 1);
+                encoding.writeVarUint(encoder, control.ack.serverEpoch);
+                encoding.writeVarUint(encoder, control.ack.runtimeGeneration);
+                encoding.writeVarUint(encoder, control.ack.connectionEpoch);
+            }
+            else {
+                encoding.writeVarUint(encoder, 0);
+                encoding.writeVarString(encoder, control.ack.reason);
+            }
+            break;
+        case "open-existing":
+        case "release":
+            encoding.writeVarUint(encoder, control.requestId);
+            writeDocumentKey(encoder, control.key);
+            break;
+        case "create":
+            encoding.writeVarUint(encoder, control.requestId);
+            writeDocumentKey(encoder, control.key);
+            encoding.writeVarUint8Array(encoder, control.initial);
+            break;
+        case "opened":
+        case "created":
+            writeSnapshot(encoder, control);
+            break;
+        case "open-failed":
+        case "create-failed":
+            encoding.writeVarUint(encoder, control.requestId);
+            encoding.writeVarString(encoder, control.reason);
+            break;
+        case "released":
+            encoding.writeVarUint(encoder, control.requestId);
+            break;
+        case "reject":
+            encoding.writeVarString(encoder, control.reason);
+            break;
+    }
+    return encoding.toUint8Array(encoder);
+}
+export function decodePrivateControl(bytes) {
+    try {
+        const decoder = decoding.createDecoder(bytes);
+        const op = CONTROL_OPS.at(decoding.readVarUint(decoder));
+        if (op === undefined)
+            return null;
+        switch (op) {
+            case "hello":
+                return {
+                    op,
+                    hello: {
+                        capability: decoding.readVarString(decoder),
+                        identity: readIdentity(decoder),
+                    },
+                };
+            case "hello-ack": {
+                const ok = decoding.readVarUint(decoder);
+                if (ok === 1) {
+                    return {
+                        op,
+                        ack: {
+                            ok: true,
+                            serverEpoch: decoding.readVarUint(decoder),
+                            runtimeGeneration: decoding.readVarUint(decoder),
+                            connectionEpoch: decoding.readVarUint(decoder),
+                        },
+                    };
+                }
+                if (ok !== 0)
+                    return null;
+                const reason = decoding.readVarString(decoder);
+                if (!isAuthReason(reason))
+                    return null;
+                return { op, ack: { ok: false, reason } };
+            }
+            case "open-existing":
+            case "release":
+                return {
+                    op,
+                    requestId: decoding.readVarUint(decoder),
+                    key: readDocumentKey(decoder),
+                };
+            case "create":
+                return {
+                    op,
+                    requestId: decoding.readVarUint(decoder),
+                    key: readDocumentKey(decoder),
+                    initial: decoding.readVarUint8Array(decoder),
+                };
+            case "opened":
+            case "created":
+                return { op, ...readSnapshot(decoder) };
+            case "open-failed": {
+                const requestId = decoding.readVarUint(decoder);
+                const reason = decoding.readVarString(decoder);
+                if (!isOpenFailReason(reason))
+                    return null;
+                return { op, requestId, reason };
+            }
+            case "create-failed": {
+                const requestId = decoding.readVarUint(decoder);
+                const reason = decoding.readVarString(decoder);
+                if (!isCreateFailReason(reason))
+                    return null;
+                return { op, requestId, reason };
+            }
+            case "released":
+                return { op, requestId: decoding.readVarUint(decoder) };
+            case "reject": {
+                const reason = decoding.readVarString(decoder);
+                if (!isRejectReason(reason))
+                    return null;
+                return { op, reason };
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+}
+export function encodeBarrierRequest(request) {
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, request.requestId);
+    encoding.writeVarUint8Array(encoder, encodeDocumentCheckpoint(request.checkpoint));
+    return encoding.toUint8Array(encoder);
+}
+export function decodeBarrierRequest(bytes) {
+    try {
+        const decoder = decoding.createDecoder(bytes);
+        const requestId = decoding.readVarUint(decoder);
+        const checkpoint = decodeDocumentCheckpoint(decoding.readVarUint8Array(decoder));
+        if (checkpoint == null)
+            return null;
+        return { requestId, checkpoint };
+    }
+    catch {
+        return null;
+    }
+}
+export function encodeBarrierReply(reply) {
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, reply.requestId);
+    if (reply.result.ok) {
+        encoding.writeVarUint(encoder, 1);
+        encoding.writeVarUint8Array(encoder, encodeDurableReceipt(reply.result.receipt));
+    }
+    else {
+        encoding.writeVarUint(encoder, 0);
+        encoding.writeVarString(encoder, reply.result.reason);
+    }
+    return encoding.toUint8Array(encoder);
+}
+export function decodeBarrierReply(bytes) {
+    try {
+        const decoder = decoding.createDecoder(bytes);
+        const requestId = decoding.readVarUint(decoder);
+        const ok = decoding.readVarUint(decoder);
+        if (ok === 1) {
+            const receipt = decodeDurableReceipt(decoding.readVarUint8Array(decoder));
+            if (receipt == null)
+                return null;
+            return { requestId, result: { ok: true, receipt } };
+        }
+        if (ok !== 0)
+            return null;
+        const reason = decoding.readVarString(decoder);
+        if (reason !== "storage-failed" && reason !== "disconnected" && reason !== "overload") {
+            return null;
+        }
+        return { requestId, result: { ok: false, reason } };
+    }
+    catch {
+        return null;
+    }
+}
+function isAuthReason(value) {
+    return PRIVATE_AUTH_REASONS.includes(value);
+}
+function isRejectReason(value) {
+    return PRIVATE_REJECT_REASONS.includes(value);
+}
+function isOpenFailReason(value) {
+    return PRIVATE_OPEN_FAIL_REASONS.includes(value);
+}
+function isCreateFailReason(value) {
+    return PRIVATE_CREATE_FAIL_REASONS.includes(value);
+}
+//# sourceMappingURL=private.js.map