edytor 5.0.0 → 7.0.0

package/dist/cloudflare/room/context.d.ts

@@ -18,6 +18,7 @@ import type { RoomHistory } from './history.js';
 import type { RoomMoves } from './moves.js';
 import type { RoomPresence } from './presence.js';
 import type { RoomPurge } from './purge.js';
+import type { RoomReseed } from './reseed.js';
 import type { ReplicaRegistry } from './replicas.js';
 import type { Scheduler } from './scheduler.js';
 import type { RoomStorage } from './storage.js';
@@ -157,34 +158,8 @@ export declare const crdt: {
             api: object;
         } & {
             prepare: {
-                insertFlow: (target: import("../../index.js").FlowTarget, flow: import("../../index.js").Flow, view?: import("../../index.js").FlowView) => import("../../index.js").Prepared;
-                deleteRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView) => import("../../index.js").Prepared;
-                replaceRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView) => import("../../index.js").Prepared;
                 nestBlock: (id: import("../../index.js").BlockId, parent: import("../../index.js").BlockId) => import("../../index.js").Prepared;
                 deleteBlocks: (ids: readonly import("../../index.js").BlockId[]) => import("../../index.js").Prepared;
-                insertText: (id: import("../../index.js").BlockId, offset: number, text: string, marks?: Record<string, unknown>) => import("../../index.js").Prepared;
-                deleteText: (id: import("../../index.js").BlockId, offset: number, length: number) => import("../../index.js").Prepared;
-                formatRange: (id: import("../../index.js").BlockId, offset: number, length: number, marks: Record<string, unknown>) => import("../../index.js").Prepared;
-                clearMarks: (id: import("../../index.js").BlockId, offset: number, length: number) => import("../../index.js").Prepared;
-                insertInline: (id: import("../../index.js").BlockId, offset: number, atom: import("../../crdt/doc/content.js").NewInline) => import("../../index.js").Prepared;
-                removeInline: (id: import("../../index.js").BlockId, inlineId: string) => import("../../index.js").Prepared;
-                setBlockType: (id: import("../../index.js").BlockId, type: string) => import("../../index.js").Prepared;
-                patchData: (target: import("../../index.js").DataTarget, patches: readonly import("../../index.js").DataPatch[]) => import("../../index.js").Prepared;
-                setBlock: (id: import("../../index.js").BlockId, value: {
-                    type?: string;
-                    data?: Record<string, unknown>;
-                    content?: (import("../../index.js").ContentItem | import("../../index.js").JSONText | import("../../index.js").JSONInlineBlock)[];
-                    children?: (import("../../index.js").BlockSpec | import("../../index.js").JSONBlock)[];
-                }) => import("../../index.js").Prepared;
-                deleteBlock: (id: import("../../index.js").BlockId, opts?: {
-                    keepChildren?: boolean;
-                }) => import("../../index.js").Prepared;
-                splitBlock: (id: import("../../index.js").BlockId, offset: number, newId: import("../../index.js").BlockId, tail?: import("../../index.js").SplitTail) => import("../../index.js").Prepared;
-                mergeBlocks: (fromId: import("../../index.js").BlockId, intoId: import("../../index.js").BlockId) => import("../../index.js").Prepared;
-                mergeBackward: (id: import("../../index.js").BlockId) => import("../../index.js").Prepared;
-                mergeForward: (id: import("../../index.js").BlockId) => import("../../index.js").Prepared;
-                placeBeside: (ids: readonly import("../../index.js").BlockId[], target: import("../../index.js").BlockId, side: "left" | "right", kind?: string) => import("../../index.js").Prepared;
-                wrapInLayout: (ids: readonly import("../../index.js").BlockId[], kind?: string, columns?: number) => import("../../index.js").Prepared;
                 insertBlocks: (dest: import("../../index.js").Destination, specs: readonly (import("../../index.js").BlockSpec | import("../../index.js").JSONBlock)[]) => import("../../index.js").Prepared;
                 moveBlocks: (ids: readonly import("../../index.js").BlockId[], dest: import("../../index.js").Destination) => import("../../index.js").Prepared;
                 unNestBlocks: (ids: readonly import("../../index.js").BlockId[]) => import("../../index.js").Prepared;
@@ -194,39 +169,39 @@ export declare const crdt: {
                     after?: readonly import("../../index.js").BlockSpec[];
                 }) => import("../../index.js").Prepared;
                 duplicateBlock: (id: import("../../index.js").BlockId, freshId?: (oldId: string, kind: "block" | "inline") => string) => import("../../index.js").Prepared;
+                placeBeside: (ids: readonly import("../../index.js").BlockId[], target: import("../../index.js").BlockId, side: "left" | "right", kind?: string) => import("../../index.js").Prepared;
+                wrapInLayout: (ids: readonly import("../../index.js").BlockId[], kind?: string, columns?: number) => import("../../index.js").Prepared;
+                splitBlock: (id: import("../../index.js").BlockId, offset: number, newId: import("../../index.js").BlockId, tail?: import("../../index.js").SplitTail) => import("../../index.js").Prepared;
+                mergeBlocks: (fromId: import("../../index.js").BlockId, intoId: import("../../index.js").BlockId) => import("../../index.js").Prepared;
+                mergeBackward: (id: import("../../index.js").BlockId) => import("../../index.js").Prepared;
+                mergeForward: (id: import("../../index.js").BlockId) => import("../../index.js").Prepared;
+                deleteBlock: (id: import("../../index.js").BlockId, opts?: {
+                    keepChildren?: boolean;
+                }) => import("../../index.js").Prepared;
+                setBlockType: (id: import("../../index.js").BlockId, type: string) => import("../../index.js").Prepared;
+                patchData: (target: import("../../index.js").DataTarget, patches: readonly import("../../index.js").DataPatch[]) => import("../../index.js").Prepared;
+                setBlock: (id: import("../../index.js").BlockId, value: {
+                    type?: string;
+                    data?: Record<string, unknown>;
+                    content?: (import("../../index.js").ContentItem | import("../../index.js").JSONText | import("../../index.js").JSONInlineBlock)[];
+                    children?: (import("../../index.js").BlockSpec | import("../../index.js").JSONBlock)[];
+                }) => import("../../index.js").Prepared;
+                insertText: (id: import("../../index.js").BlockId, offset: number, text: string, marks?: Record<string, unknown>) => import("../../index.js").Prepared;
+                deleteText: (id: import("../../index.js").BlockId, offset: number, length: number) => import("../../index.js").Prepared;
+                formatRange: (id: import("../../index.js").BlockId, offset: number, length: number, marks: Record<string, unknown>) => import("../../index.js").Prepared;
+                clearMarks: (id: import("../../index.js").BlockId, offset: number, length: number) => import("../../index.js").Prepared;
+                insertInline: (id: import("../../index.js").BlockId, offset: number, atom: import("../../crdt/doc/ops.js").NewInline) => import("../../index.js").Prepared;
+                removeInline: (id: import("../../index.js").BlockId, inlineId: string) => import("../../index.js").Prepared;
+                insertFlow: (target: import("../../index.js").FlowTarget, flow: import("../../index.js").Flow, view?: import("../../index.js").FlowView) => import("../../index.js").Prepared;
+                deleteRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView) => import("../../index.js").Prepared;
+                replaceRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView) => import("../../index.js").Prepared;
             };
             apply: (p: import("../../index.js").Prepared, quiet?: boolean) => import("../../index.js").OpResult;
             compose: (...parts: import("../../index.js").Prepared[]) => import("../../index.js").Prepared;
             transact: <R>(fn: () => R, origin?: unknown) => R;
             version: number;
-            insertFlow: (target: import("../../index.js").FlowTarget, flow: import("../../index.js").Flow, view?: import("../../index.js").FlowView | undefined) => import("../../index.js").OpResult;
-            deleteRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView | undefined) => import("../../index.js").OpResult;
-            replaceRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView | undefined) => import("../../index.js").OpResult;
             nestBlock: (id: string, parent: string) => import("../../index.js").OpResult;
             deleteBlocks: (ids: readonly string[]) => import("../../index.js").OpResult;
-            insertText: (id: string, offset: number, text: string, marks?: Record<string, unknown> | undefined) => import("../../index.js").OpResult;
-            deleteText: (id: string, offset: number, length: number) => import("../../index.js").OpResult;
-            formatRange: (id: string, offset: number, length: number, marks: Record<string, unknown>) => import("../../index.js").OpResult;
-            clearMarks: (id: string, offset: number, length: number) => import("../../index.js").OpResult;
-            insertInline: (id: string, offset: number, atom: import("../../crdt/doc/content.js").NewInline) => import("../../index.js").OpResult;
-            removeInline: (id: string, inlineId: string) => import("../../index.js").OpResult;
-            setBlockType: (id: string, type: string) => import("../../index.js").OpResult;
-            patchData: (target: import("../../index.js").DataTarget, patches: readonly import("../../index.js").DataPatch[]) => import("../../index.js").OpResult;
-            setBlock: (id: string, value: {
-                type?: string;
-                data?: Record<string, unknown>;
-                content?: (import("../../index.js").ContentItem | import("../../index.js").JSONText | import("../../index.js").JSONInlineBlock)[];
-                children?: (import("../../index.js").BlockSpec | import("../../index.js").JSONBlock)[];
-            }) => import("../../index.js").OpResult;
-            deleteBlock: (id: string, opts?: {
-                keepChildren?: boolean;
-            } | undefined) => import("../../index.js").OpResult;
-            splitBlock: (id: string, offset: number, newId: string, tail?: import("../../index.js").SplitTail | undefined) => import("../../index.js").OpResult;
-            mergeBlocks: (fromId: string, intoId: string) => import("../../index.js").OpResult;
-            mergeBackward: (id: string) => import("../../index.js").OpResult;
-            mergeForward: (id: string) => import("../../index.js").OpResult;
-            placeBeside: (ids: readonly string[], target: string, side: "left" | "right", kind?: string | undefined) => import("../../index.js").OpResult;
-            wrapInLayout: (ids: readonly string[], kind?: string | undefined, columns?: number | undefined) => import("../../index.js").OpResult;
             insertBlocks: (dest: import("../../index.js").Destination, specs: readonly (import("../../index.js").JSONBlock | import("../../index.js").BlockSpec)[]) => import("../../index.js").OpResult;
             moveBlocks: (ids: readonly string[], dest: import("../../index.js").Destination) => import("../../index.js").OpResult;
             unNestBlocks: (ids: readonly string[]) => import("../../index.js").OpResult;
@@ -236,6 +211,32 @@ export declare const crdt: {
                 after?: readonly import("../../index.js").BlockSpec[];
             } | undefined) => import("../../index.js").OpResult;
             duplicateBlock: (id: string, freshId?: ((oldId: string, kind: "block" | "inline") => string) | undefined) => import("../../index.js").OpResult;
+            placeBeside: (ids: readonly string[], target: string, side: "left" | "right", kind?: string | undefined) => import("../../index.js").OpResult;
+            wrapInLayout: (ids: readonly string[], kind?: string | undefined, columns?: number | undefined) => import("../../index.js").OpResult;
+            splitBlock: (id: string, offset: number, newId: string, tail?: import("../../index.js").SplitTail | undefined) => import("../../index.js").OpResult;
+            mergeBlocks: (fromId: string, intoId: string) => import("../../index.js").OpResult;
+            mergeBackward: (id: string) => import("../../index.js").OpResult;
+            mergeForward: (id: string) => import("../../index.js").OpResult;
+            deleteBlock: (id: string, opts?: {
+                keepChildren?: boolean;
+            } | undefined) => import("../../index.js").OpResult;
+            setBlockType: (id: string, type: string) => import("../../index.js").OpResult;
+            patchData: (target: import("../../index.js").DataTarget, patches: readonly import("../../index.js").DataPatch[]) => import("../../index.js").OpResult;
+            setBlock: (id: string, value: {
+                type?: string;
+                data?: Record<string, unknown>;
+                content?: (import("../../index.js").ContentItem | import("../../index.js").JSONText | import("../../index.js").JSONInlineBlock)[];
+                children?: (import("../../index.js").BlockSpec | import("../../index.js").JSONBlock)[];
+            }) => import("../../index.js").OpResult;
+            insertText: (id: string, offset: number, text: string, marks?: Record<string, unknown> | undefined) => import("../../index.js").OpResult;
+            deleteText: (id: string, offset: number, length: number) => import("../../index.js").OpResult;
+            formatRange: (id: string, offset: number, length: number, marks: Record<string, unknown>) => import("../../index.js").OpResult;
+            clearMarks: (id: string, offset: number, length: number) => import("../../index.js").OpResult;
+            insertInline: (id: string, offset: number, atom: import("../../crdt/doc/ops.js").NewInline) => import("../../index.js").OpResult;
+            removeInline: (id: string, inlineId: string) => import("../../index.js").OpResult;
+            insertFlow: (target: import("../../index.js").FlowTarget, flow: import("../../index.js").Flow, view?: import("../../index.js").FlowView | undefined) => import("../../index.js").OpResult;
+            deleteRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView | undefined) => import("../../index.js").OpResult;
+            replaceRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView | undefined) => import("../../index.js").OpResult;
             project: () => import("../../index.js").ProjectedDoc;
             toJSON: (options?: {
                 suggestions?: boolean;
@@ -312,7 +313,7 @@ export declare const crdt: {
             text: import("../../crdt/text/model.js").TextEngine;
         }, horizon: import("../../crdt/purge.js").Horizon | null) => import("../index.js").PurgeReport;
         horizonOf: (doc: E.EngineDoc) => import("../../crdt/purge.js").Horizon | null;
-        restoreTo: <Plan>(doc: E.EngineDoc, facade: import("../../crdt/restore.js").RestoreFacade<Plan>, json: JSONDoc) => import("../../crdt/restore.js").RestoreReport;
+        restoreTo: <Plan>(doc: E.EngineDoc, facade: import("../../crdt/restore.js").RestoreFacade<Plan>, json: JSONDoc, { rewrite, suggestions }?: import("../../crdt/restore.js").RestoreOptions<Plan>) => import("../../crdt/restore.js").RestoreReport;
         model: {
             REGISTRY_KEY: string;
             registryOf: (doc: E.EngineDoc) => E.EngineNode;
@@ -407,17 +408,12 @@ export declare const crdt: {
                 loadError: unknown;
                 _storeTimeout: number;
                 _storeTimeoutId: ReturnType<typeof setTimeout> | null;
-                _storeUpdate: (update: Uint8Array, origin: unknown) => void;
+                _unlisten: () => void;
                 awareness: import("../../index.js").Awareness;
                 bcconnected: boolean;
                 disableBc: boolean;
                 _ownsAwareness: boolean;
                 _bcSubscriber: (data: ArrayBuffer | Uint8Array, origin: unknown) => void;
-                _awarenessUpdateHandler: (updates: {
-                    added: number[];
-                    updated: number[];
-                    removed: number[];
-                }, origin: unknown) => void;
                 get synced(): boolean;
                 messageHandlers: Record<number, import("../../crdt/providers/room.js").RoomMessageHandler</*elided*/ any>>;
                 readMessage: (buf: Uint8Array, emitSynced: boolean) => E.Encoder;
@@ -425,7 +421,7 @@ export declare const crdt: {
                 connectBc(): void;
                 disconnectBc(): void;
                 destroy(): Promise<void>;
-                emit<N extends "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "load-error">(name: N, args: Parameters<{
+                emit<N extends "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "load-error">(name: N, args: Parameters<{
                     synced: (provider: /*elided*/ any) => void;
                     'protocol-mismatch': (mismatch: E.ProtocolMismatch, provider: /*elided*/ any) => void;
                     'load-error': (error: unknown, provider: /*elided*/ any) => void;
@@ -434,7 +430,7 @@ export declare const crdt: {
                     failed: (error: unknown, provider: /*elided*/ any) => void;
                 }[N]>): void;
                 _observers: Map<string, Set<any>>;
-                on<NAME extends "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "load-error">(name: NAME, f: {
+                on<NAME extends "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "load-error">(name: NAME, f: {
                     synced: (provider: /*elided*/ any) => void;
                     'protocol-mismatch': (mismatch: E.ProtocolMismatch, provider: /*elided*/ any) => void;
                     'load-error': (error: unknown, provider: /*elided*/ any) => void;
@@ -449,7 +445,7 @@ export declare const crdt: {
                     'schema-mismatch': (detail: E.SchemaMismatchDetail, provider: /*elided*/ any) => void;
                     failed: (error: unknown, provider: /*elided*/ any) => void;
                 }[NAME];
-                once<NAME extends "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "load-error">(name: NAME, f: {
+                once<NAME extends "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "load-error">(name: NAME, f: {
                     synced: (provider: /*elided*/ any) => void;
                     'protocol-mismatch': (mismatch: E.ProtocolMismatch, provider: /*elided*/ any) => void;
                     'load-error': (error: unknown, provider: /*elided*/ any) => void;
@@ -457,7 +453,7 @@ export declare const crdt: {
                     'schema-mismatch': (detail: E.SchemaMismatchDetail, provider: /*elided*/ any) => void;
                     failed: (error: unknown, provider: /*elided*/ any) => void;
                 }[NAME]): void;
-                off<NAME extends "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "load-error">(name: NAME, f: {
+                off<NAME extends "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "load-error">(name: NAME, f: {
                     synced: (provider: /*elided*/ any) => void;
                     'protocol-mismatch': (mismatch: E.ProtocolMismatch, provider: /*elided*/ any) => void;
                     'load-error': (error: unknown, provider: /*elided*/ any) => void;
@@ -508,6 +504,7 @@ export declare const crdt: {
                     deny(): void;
                     allow(): void;
                 };
+                _rebasing: boolean;
                 messageHandlers: Record<number, import("../../crdt/providers/room.js").RoomMessageHandler</*elided*/ any>>;
                 hasSynced: boolean;
                 whenSynced: Promise<unknown>;
@@ -518,14 +515,7 @@ export declare const crdt: {
                 _resync: ReturnType<typeof setInterval> | undefined;
                 _connectTimer: ReturnType<typeof setTimeout> | undefined;
                 _checkInterval: ReturnType<typeof setInterval>;
-                _updateHandler: (update: Uint8Array, origin: unknown, doc?: unknown, transaction?: {
-                    local: boolean;
-                }) => void;
-                _awarenessUpdateHandler: (updates: {
-                    added: number[];
-                    updated: number[];
-                    removed: number[];
-                }, origin: unknown) => void;
+                _unlisten: () => void;
                 get url(): string;
                 get unsaved(): number;
                 get saved(): boolean;
@@ -535,11 +525,11 @@ export declare const crdt: {
                 destroy(): void;
                 disconnect(): void;
                 connect(): void;
-                emit<N extends "refused" | "status" | "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: N, args: Parameters<E.WebsocketProviderEvents[N]>): void;
+                emit<N extends "refused" | "status" | "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: N, args: Parameters<E.WebsocketProviderEvents[N]>): void;
                 _observers: Map<string, Set<any>>;
-                on<NAME extends "refused" | "status" | "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: NAME, f: E.WebsocketProviderEvents[NAME]): E.WebsocketProviderEvents[NAME];
-                once<NAME extends "refused" | "status" | "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: NAME, f: E.WebsocketProviderEvents[NAME]): void;
-                off<NAME extends "refused" | "status" | "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: NAME, f: E.WebsocketProviderEvents[NAME]): void;
+                on<NAME extends "refused" | "status" | "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: NAME, f: E.WebsocketProviderEvents[NAME]): E.WebsocketProviderEvents[NAME];
+                once<NAME extends "refused" | "status" | "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: NAME, f: E.WebsocketProviderEvents[NAME]): void;
+                off<NAME extends "refused" | "status" | "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: NAME, f: E.WebsocketProviderEvents[NAME]): void;
             };
         };
         watchComments: (server: string | null, roomName: string, listener: (message: E.CommentMessage) => void) => (() => void);
@@ -656,6 +646,7 @@ export type RoomTables = {
     late: string;
     threads: string;
     comments: string;
+    cuts: string;
 };
 /** The room's public diagnostics, kept on the `AttachedDocument` itself. */
 export type RoomState = Pick<AttachedDocument, 'failure' | 'presence' | 'refusals' | 'refusalCounts' | 'origin'>;
@@ -725,6 +716,7 @@ export declare class RoomContext {
     presence: RoomPresence;
     access: RoomAccess;
     comments: RoomComments;
+    reseed: RoomReseed;
     constructor(ctx: DurableObjectState, options: AttachRoomOptions, limits: RoomLimits, state: RoomState);
     /** The room's id: its name (`getByName`), else the object's id. */
     get roomId(): string;
@@ -735,8 +727,11 @@ export declare class RoomContext {
     /**
      * A facade over `doc` obeying the room's block roles (`semantics`), its
      * shared suggestions built: its `toJSON()` leaves the pending ones out.
+     * With `actor`, its writes are that actor's (a rebase's: `room.reseed.rebase`).
      */
-    facadeOf(doc: YDoc): EdytorDoc;
+    facadeOf(doc: YDoc, actor?: {
+        id: string;
+    }): EdytorDoc;
     /**
      * The facade over the live document. Read while the room is idle, it
      * first drops a direct write whose append failed (`heal`).
@@ -763,6 +758,8 @@ export declare class RoomContext {
     log(entry: RoomLogEntry): void;
     /** Send one frame — as chunks when it exceeds `maxFrameBytes` (bounded catch-up). */
     send(ws: WebSocket, bytes: Uint8Array): void;
+    /** The open sockets of the current epoch: what the room relays to (`room.reseed.protocol`). */
+    sockets(): WebSocket[];
     broadcast(bytes: Uint8Array, except: unknown): void;
     close(ws: WebSocket, code: number, reason: string): void;
     /** A refused frame is dropped whole and its socket closed (1008 policy violation). */

package/dist/cloudflare/room/context.js

@@ -13,7 +13,7 @@ import { CLOSE } from '../../crdt/providers/room.js';
 import { asEngineDoc } from '../../crdt/structs.js';
 import { suggestionsOf } from '../../crdt/doc/suggest.js';
 import { defaultSemantics, facadeConfigOf, semanticsDigest } from '../../crdt/semantics.js';
-import { MAX_REFUSALS, ROOM_ORIGIN, SOCKET_TAG, noTimers } from './shared.js';
+import { MAX_REFUSALS, ROOM_ORIGIN, SOCKET_TAG, STALE_TAG, noTimers } from './shared.js';
 /** The engine API the room is built on (the Worker-safe CRDT entry). */
 export const crdt = E.bindCrdt(Y);
 export const sync = crdt.sync;
@@ -94,6 +94,7 @@ export class RoomContext {
     presence;
     access;
     comments;
+    reseed;
     #_facade = null;
     #_lookups = null;
     #_digest = null;
@@ -117,7 +118,8 @@ export class RoomContext {
             moves: `${prefix}moves`,
             late: `${prefix}late`,
             threads: `${prefix}threads`,
-            comments: `${prefix}comments`
+            comments: `${prefix}comments`,
+            cuts: `${prefix}cuts`
         };
         this.clock = options.now ?? Date.now;
     }
@@ -137,9 +139,11 @@ export class RoomContext {
     /**
      * A facade over `doc` obeying the room's block roles (`semantics`), its
      * shared suggestions built: its `toJSON()` leaves the pending ones out.
+     * With `actor`, its writes are that actor's (a rebase's: `room.reseed.rebase`).
      */
-    facadeOf(doc) {
-        const facade = crdt.doc.create(asEngineDoc(doc), this.lookups);
+    facadeOf(doc, actor) {
+        const config = actor ? { ...this.lookups, actor: () => actor } : this.lookups;
+        const facade = crdt.doc.create(asEngineDoc(doc), config);
         suggestionsOf(facade);
         return facade;
     }
@@ -259,10 +263,17 @@ export class RoomContext {
         for (const piece of E.chunkFrame(bytes, this.limits.maxFrameBytes))
             ws.send(piece);
     }
+    /** The open sockets of the current epoch: what the room relays to (`room.reseed.protocol`). */
+    sockets() {
+        const stale = new Set(this.ctx.getWebSockets(STALE_TAG));
+        return this.ctx
+            .getWebSockets(SOCKET_TAG)
+            .filter((ws) => ws.readyState === WebSocket.OPEN && !stale.has(ws));
+    }
     broadcast(bytes, except) {
         const pieces = E.chunkFrame(bytes, this.limits.maxFrameBytes);
-        for (const ws of this.ctx.getWebSockets(SOCKET_TAG)) {
-            if (ws === except || ws.readyState !== WebSocket.OPEN)
+        for (const ws of this.sockets()) {
+            if (ws === except)
                 continue;
             try {
                 for (const piece of pieces)

package/dist/cloudflare/room/forged.d.ts

@@ -9,7 +9,7 @@ export declare const isId: (value: unknown) => value is Id;
  * The clients of a frame (but `skip`) that write a per-writer block mark
  * of another writer: a struct whose key is `del.<n>` or `wd.<n>` on a
  * block node, from a client other than `n`. Only `n` writes its mark.
- * A struct in the purge horizon's root forges the room's.
+ * A struct in the purge horizon's root, or the epoch's, forges the room's.
  */
 export declare const forgedWriters: (doc: YDoc, structs: Struct[], skip: Set<number>) => Set<number>;
 /**

package/dist/cloudflare/room/forged.js

@@ -1,13 +1,13 @@
 /**
  * Forged writes: what a frame writes or deletes that its sender may not —
  * another writer's per-writer block mark (`room.marks.writer`), the purge
- * horizon (the room's alone), another replica's binding or another user's
+ * horizon and the epoch (the room's alone), another replica's binding or another user's
  * profile in the attribution root (`room.attribution.trust`). Pure reads of
  * the room document and the frame; `Admission` strips or drops what they
  * find.
  */
 import { Y } from '../../crdt/engine.js';
-import { ATTRIBUTION_ROOT, DEL_PREFIX, HORIZON_ROOT, REGISTRY_KEY, SUGGEST_ROOT, WITHDRAW_PREFIX } from '../../crdt/schema.js';
+import { ATTRIBUTION_ROOT, DEL_PREFIX, EPOCH_ROOT, HORIZON_ROOT, REGISTRY_KEY, SUGGEST_ROOT, WITHDRAW_PREFIX } from '../../crdt/schema.js';
 import { heldClock, runsOf, storedStruct, structAt } from './updates.js';
 // ── Per-writer marks ──────────────────────────────────────────
 /** The writer `n` of a per-writer block mark key (`del.<n>`, `wd.<n>`), or `null`. */
@@ -63,14 +63,16 @@ const isBlockNode = (doc, frame, parent) => {
     const item = parent?._item;
     return item?.parent === registry && registry !== undefined;
 };
-/** Is `parent` (a {@link Place}'s) the purge horizon's root, which only the room writes? */
-const isHorizon = (doc, parent) => parent === HORIZON_ROOT ||
-    (parent != null && parent === doc.share.get(HORIZON_ROOT));
+/**
+ * Is `parent` (a {@link Place}'s) a root only the room writes: the purge
+ * horizon's, or the epoch's (`room.reseed.protocol`)?
+ */
+const isRoomRoot = (doc, parent) => [HORIZON_ROOT, EPOCH_ROOT].some((root) => parent === root || (parent != null && parent === doc.share.get(root)));
 /**
  * The clients of a frame (but `skip`) that write a per-writer block mark
  * of another writer: a struct whose key is `del.<n>` or `wd.<n>` on a
  * block node, from a client other than `n`. Only `n` writes its mark.
- * A struct in the purge horizon's root forges the room's.
+ * A struct in the purge horizon's root, or the epoch's, forges the room's.
  */
 export const forgedWriters = (doc, structs, skip) => {
     const frame = runsOf(structs);
@@ -83,7 +85,7 @@ export const forgedWriters = (doc, structs, skip) => {
             continue;
         const place = placeOf(doc, frame, struct.id);
         const writer = markWriter(place?.key);
-        if ((place !== null && isHorizon(doc, place.parent)) ||
+        if ((place !== null && isRoomRoot(doc, place.parent)) ||
             (writer !== null && writer !== client && isBlockNode(doc, frame, place.parent))) {
             forged.add(client);
         }
@@ -113,8 +115,8 @@ export const forgedDeletes = (doc, ds, mayDelete) => {
                     break;
                 if (!(struct instanceof Y.Item) || struct.deleted)
                     continue;
-                // The purge horizon is the room's alone.
-                if (!isHorizon(doc, struct.parent)) {
+                // The purge horizon and the epoch are the room's alone.
+                if (!isRoomRoot(doc, struct.parent)) {
                     const writer = markWriter(struct.parentSub);
                     if (writer === null || mayDelete(writer))
                         continue;

package/dist/cloudflare/room/frames.d.ts

@@ -29,6 +29,8 @@ export declare const readOnlyFrame: () => Uint8Array;
 export declare const readOnlyDenialFrame: () => Uint8Array;
 /** The denial of what a suggest-only socket may not write (stripped): it stays, and still syncs. */
 export declare const suggestOnlyDenialFrame: () => Uint8Array;
+/** The room's epoch, to a socket that dialed an older one (`room.reseed.protocol`). */
+export declare const epochFrame: (epoch: number) => Uint8Array;
 /** The socket's access, at the join and at a change in place (`write`, `suggest`, `comment`, `read`). */
 export declare const accessFrame: (access: string) => Uint8Array;
 /** A Step2 of what the room STORED: the engine's pending store (never stored) is left out. */

package/dist/cloudflare/room/frames.js

@@ -51,6 +51,8 @@ export const readOnlyFrame = () => E.frame(E.messageAuth, (e) => E.writeReadOnly
 export const readOnlyDenialFrame = () => E.frame(E.messageAuth, (e) => E.writePermissionDenied(e, READ_ONLY_DENIAL));
 /** The denial of what a suggest-only socket may not write (stripped): it stays, and still syncs. */
 export const suggestOnlyDenialFrame = () => E.frame(E.messageAuth, (e) => E.writePermissionDenied(e, SUGGEST_ONLY_DENIAL));
+/** The room's epoch, to a socket that dialed an older one (`room.reseed.protocol`). */
+export const epochFrame = (epoch) => E.frame(E.messageAuth, (e) => E.writeEpoch(e, epoch));
 /** The socket's access, at the join and at a change in place (`write`, `suggest`, `comment`, `read`). */
 export const accessFrame = (access) => E.frame(E.messageAuth, (e) => E.writeAccess(e, access));
 /** A Step2 of what the room STORED: the engine's pending store (never stored) is left out. */

package/dist/cloudflare/room/presence.js

@@ -7,7 +7,6 @@
  * the socket goes.
  */
 import { semanticsMismatch } from '../../crdt/semantics.js';
-import { SOCKET_TAG } from './shared.js';
 import { allowance } from './admission.js';
 import { encodeJSON } from './context.js';
 import { encodePresenceEntry, presenceFrame, presenceFrameOf } from './frames.js';
@@ -142,9 +141,7 @@ export class RoomPresence {
      * replica, and {@link drain} sends each recipient's in one frame.
      */
     fanOut(entries) {
-        const sockets = this.room.ctx
-            .getWebSockets(SOCKET_TAG)
-            .filter((socket) => socket.readyState === WebSocket.OPEN);
+        const sockets = this.room.sockets();
         if (sockets.length === 0)
             return;
         if (this.waiting.size === 0 && this.take(sockets.length)) {

package/dist/cloudflare/room/reseed.d.ts

@@ -0,0 +1,93 @@
+import * as E from '../../crdt/protocol.js';
+import type { YDoc } from '../../crdt/index.js';
+import type { Attachment, SocketIdentity } from '../DocumentRoom.js';
+import type { Decoded } from './context.js';
+import { type RoomContext } from './context.js';
+/** An epoch a dial names (`?epoch=`; `new`: a document that holds nothing yet), or `null`. */
+export declare const parseEpoch: (raw: string | null) => number | "new" | null;
+export declare class RoomReseed {
+    #private;
+    private readonly room;
+    constructor(room: RoomContext);
+    /** The re-seed's settings (`null`: off). */
+    get config(): {
+        at: number;
+        idleMs: number;
+        gain: number;
+        force: number;
+        graceDays: number;
+    } | null;
+    /** The room's epoch: what its document says (`epoch.n`, which only the room writes), 0 before a re-seed. */
+    get epoch(): number;
+    /**
+     * A change was stored at `at` (`room.reseed.timing`): past the
+     * threshold the re-seed is due once nobody writes for `idleMs` (each
+     * change pushes it back), past `force` at once.
+     */
+    noteChange(at: number): void;
+    /**
+     * The `reseed` task: the cuts past their grace go (`room.reseed.grace`),
+     * then it re-seeds when still due (past the threshold and the floor); a
+     * re-seed that failed is due again at the first change a minute later or
+     * more. It is due again when the oldest cut left expires.
+     */
+    task(): void;
+    /**
+     * Re-seed now (`room.reseed.cut`): the new epoch replaces the rows, in
+     * one storage transaction with its cut; the replica registry, the
+     * purge's epochs and the last restore's step go (they name the old
+     * identities); the live document is rebuilt from the rows and every
+     * socket closed `4410`. `idle` (the task, once nobody wrote) waits while
+     * a suggestion is pending (an idle period later); `full` (the task, past
+     * `force` of the quota) drops them; both do nothing when the new epoch
+     * would give back less than `gain` (and wait for the document to grow by
+     * a quarter of `at` before trying again). `manual` (`reseed()`) runs
+     * whatever it gives back and drops them. Answers the new epoch, or `null`.
+     */
+    run(mode: 'idle' | 'full' | 'manual'): number | null;
+    /**
+     * The door (`RoomAccess.accept`, `room.reseed.protocol`): a dial of
+     * epoch `asked` is current, stale (an older epoch whose cuts are kept),
+     * or closed: none, in a room that re-seeded, `1008` (a client that
+     * predates the re-seed); any other epoch the room cannot rebase (past
+     * the cuts kept, or later than its own: the room lost it), `4410`, so
+     * the client drops its copy and loads the room's.
+     */
+    door(asked: number | 'new' | null): 'current' | 'stale' | {
+        code: number;
+        reason: string;
+    };
+    /**
+     * Whether `decoded`, from a socket of the current epoch, holds an older
+     * epoch's content (`room.reseed.protocol`): a struct of a client the
+     * cuts kept name, which the document holds nothing of (a tab took it
+     * from another tab of the old epoch). Its socket is closed `4410`.
+     */
+    holdsOld(decoded: Decoded, doc: YDoc): boolean;
+    /** The largest frame a socket of an older epoch may send: its whole old document. */
+    get staleFrameBytes(): number;
+    /**
+     * A stale socket joined: one that may write is told the room's epoch
+     * (its provider then hands over its old document); any other has no
+     * edit to merge and is closed `4410`. Past its user's rebase rate it is
+     * closed `1011` before it uploads anything: its provider dials again
+     * later.
+     */
+    join(ws: WebSocket, identity: SocketIdentity): void;
+    /**
+     * A stale socket's message: its old document (`messageRebase`) is
+     * rebased onto a copy of the current one, and what that wrote is
+     * admitted as an update of its user, from a client id of its own (the
+     * admission's quotas, access, validation and attribution, as any
+     * update); then it is closed `4410`. The merged state is kept per user
+     * and cut (`merged:<user>`), so another tab's upload merges nothing
+     * twice and another user's cannot claim it. A hand-over that cannot be
+     * read or rebased is dropped, its socket closed `4410` all the same (its
+     * client loads the room's document); past the rebase rate (one per user
+     * every ten seconds), `1011`, and the provider hands over again later.
+     * Anything else a stale socket sends is dropped.
+     */
+    onStale(ws: WebSocket, attachment: Attachment, type: number, decoder: E.Decoder): void;
+    /** Drop the cuts older than the grace, with what their rebases merged (`room.reseed.grace`). */
+    prune(at: number): void;
+}