@dabble/patches 0.5.22 → 0.7.0

package/dist/server/utils.js

@@ -0,0 +1,23 @@
+import "../chunk-IZ2YBCUP.js";
+const nonModifiableVersionFields = /* @__PURE__ */ new Set([
+  "id",
+  "parentId",
+  "groupId",
+  "origin",
+  "branchName",
+  "startedAt",
+  "endedAt",
+  "rev",
+  "baseRev"
+]);
+function assertVersionMetadata(metadata) {
+  if (!metadata) return;
+  for (const key in metadata) {
+    if (nonModifiableVersionFields.has(key)) {
+      throw new Error(`Cannot modify version field ${key}`);
+    }
+  }
+}
+export {
+  assertVersionMetadata
+};

package/dist/solid/context.d.ts

@@ -2,15 +2,16 @@ import { JSX } from 'solid-js';
 import { Patches } from '../client/Patches.js';
 import { PatchesSync } from '../net/PatchesSync.js';
 import '../event-signal.js';
+import '../json-patch/types.js';
 import '../types.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';
-import '../json-patch/types.js';
-import '../client/PatchesDoc.js';
-import '../algorithms/shared/changeBatching.js';
+import '../client/ClientAlgorithm.js';
+import '../BaseDoc-DkP3tUhT.js';
 import '../client/PatchesStore.js';
-import '../net/protocol/types.js';
 import '../net/protocol/JSONRPCClient.js';
+import '../net/protocol/types.js';
+import '../algorithms/shared/changeBatching.js';
 import '../net/websocket/PatchesWebSocket.js';
 import '../net/PatchesClient.js';
 import '../net/websocket/WebSocketTransport.js';

package/dist/solid/doc-manager.d.ts

@@ -1,12 +1,12 @@
 import { Patches } from '../client/Patches.js';
-import { PatchesDoc } from '../client/PatchesDoc.js';
+import { a as PatchesDoc } from '../BaseDoc-DkP3tUhT.js';
 import '../event-signal.js';
+import '../json-patch/types.js';
 import '../types.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';
-import '../json-patch/types.js';
+import '../client/ClientAlgorithm.js';
 import '../client/PatchesStore.js';
-import '../algorithms/shared/changeBatching.js';
 
 /**
  * Reference counting manager for PatchesDoc instances.

package/dist/solid/index.d.ts

@@ -4,16 +4,17 @@ export { DocManager, getDocManager } from './doc-manager.js';
 import 'solid-js';
 import '../client/Patches.js';
 import '../event-signal.js';
+import '../json-patch/types.js';
 import '../types.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';
-import '../json-patch/types.js';
-import '../client/PatchesDoc.js';
-import '../algorithms/shared/changeBatching.js';
+import '../client/ClientAlgorithm.js';
+import '../BaseDoc-DkP3tUhT.js';
 import '../client/PatchesStore.js';
 import '../net/PatchesSync.js';
-import '../net/protocol/types.js';
 import '../net/protocol/JSONRPCClient.js';
+import '../net/protocol/types.js';
+import '../algorithms/shared/changeBatching.js';
 import '../net/websocket/PatchesWebSocket.js';
 import '../net/PatchesClient.js';
 import '../net/websocket/WebSocketTransport.js';

package/dist/solid/primitives.d.ts

@@ -1,11 +1,10 @@
 import { Accessor } from 'solid-js';
-import { PatchesDoc } from '../client/PatchesDoc.js';
+import { a as PatchesDoc } from '../BaseDoc-DkP3tUhT.js';
 import { ChangeMutator } from '../types.js';
 import '../event-signal.js';
-import '../algorithms/shared/changeBatching.js';
+import '../json-patch/types.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';
-import '../json-patch/types.js';
 
 /**
  * Options for usePatchesDoc primitive.

package/dist/types.d.ts

@@ -17,8 +17,8 @@ interface ChangeInput {
     baseRev?: number;
     /** Optional revision number. If omitted, server assigns based on current state. */
     rev?: number;
-    /** Client-side ISO timestamp when the change was created (with timezone offset). */
-    createdAt: string;
+    /** Unix timestamp in milliseconds when the change was created. If omitted, server sets to current time. */
+    createdAt?: number;
     /** Optional batch identifier for grouping changes that belong to the same client batch (for multi-batch offline/large edits). */
     batchId?: string;
     /** Optional arbitrary metadata associated with the change. */
@@ -33,8 +33,10 @@ interface Change extends ChangeInput {
     baseRev: number;
     /** The revision number assigned by the server after commit. */
     rev: number;
-    /** Server-side ISO timestamp when the change was committed (UTC with Z). */
-    committedAt: string;
+    /** Unix timestamp in milliseconds when the change was created (always set by server if omitted from input). */
+    createdAt: number;
+    /** Unix timestamp in milliseconds when the change was committed. */
+    committedAt: number;
 }
 /**
  * Represents the state of a document in the OT protocol.
@@ -71,8 +73,8 @@ interface Branch {
     docId: string;
     /** The revision number on the source document where the branch occurred. */
     branchedAtRev: number;
-    /** Server-side ISO timestamp when the branch was created (UTC with Z). */
-    createdAt: string;
+    /** Unix timestamp in milliseconds when the branch was created. */
+    createdAt: number;
     /** Optional user-friendly name for the branch. */
     name?: string;
     /** Current status of the branch. */
@@ -89,14 +91,14 @@ type EditableBranchMetadata = Disallowed<Branch, 'id' | 'docId' | 'branchedAtRev
 interface DocumentTombstone {
     /** The ID of the deleted document. */
     docId: string;
-    /** ISO timestamp when the document was deleted (UTC with Z). */
-    deletedAt: string;
+    /** Unix timestamp in milliseconds when the document was deleted. */
+    deletedAt: number;
     /** The last revision number before deletion. */
     lastRev: number;
     /** Optional client ID that initiated the deletion. */
     deletedByClientId?: string;
-    /** Optional ISO timestamp for automatic tombstone expiration (UTC with Z). */
-    expiresAt?: string;
+    /** Optional Unix timestamp in milliseconds for automatic tombstone expiration. */
+    expiresAt?: number;
 }
 /**
  * Options for deleting a document.
@@ -122,10 +124,10 @@ interface VersionMetadata {
     isOffline?: boolean;
     /** User-defined name if origin is 'branch'. */
     branchName?: string;
-    /** Server-side ISO timestamp of version start (UTC with Z). */
-    startedAt: string;
-    /** Server-side ISO timestamp of version end (UTC with Z). */
-    endedAt: string;
+    /** Unix timestamp in milliseconds of version start. */
+    startedAt: number;
+    /** Unix timestamp in milliseconds of version end. */
+    endedAt: number;
     /** The ending revision number of this version (the last change's rev). */
     endRev: number;
     /** The starting revision number of this version (the first change's rev). */

package/dist/vue/composables.d.ts

@@ -1,11 +1,10 @@
 import { ShallowRef, Ref, MaybeRef } from 'vue';
-import { PatchesDoc } from '../client/PatchesDoc.js';
+import { a as PatchesDoc } from '../BaseDoc-DkP3tUhT.js';
 import { ChangeMutator } from '../types.js';
 import '../event-signal.js';
-import '../algorithms/shared/changeBatching.js';
+import '../json-patch/types.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';
-import '../json-patch/types.js';
 
 /**
  * Options for usePatchesDoc composable.

package/dist/vue/doc-manager.d.ts

@@ -1,12 +1,12 @@
 import { Patches } from '../client/Patches.js';
-import { PatchesDoc } from '../client/PatchesDoc.js';
+import { a as PatchesDoc } from '../BaseDoc-DkP3tUhT.js';
 import '../event-signal.js';
+import '../json-patch/types.js';
 import '../types.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';
-import '../json-patch/types.js';
+import '../client/ClientAlgorithm.js';
 import '../client/PatchesStore.js';
-import '../algorithms/shared/changeBatching.js';
 
 /**
  * Reference counting manager for PatchesDoc instances.

package/dist/vue/index.d.ts

@@ -4,16 +4,17 @@ export { DocManager, getDocManager } from './doc-manager.js';
 import 'vue';
 import '../client/Patches.js';
 import '../event-signal.js';
+import '../json-patch/types.js';
 import '../types.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';
-import '../json-patch/types.js';
-import '../client/PatchesDoc.js';
-import '../algorithms/shared/changeBatching.js';
+import '../client/ClientAlgorithm.js';
+import '../BaseDoc-DkP3tUhT.js';
 import '../client/PatchesStore.js';
 import '../net/PatchesSync.js';
-import '../net/protocol/types.js';
 import '../net/protocol/JSONRPCClient.js';
+import '../net/protocol/types.js';
+import '../algorithms/shared/changeBatching.js';
 import '../net/websocket/PatchesWebSocket.js';
 import '../net/PatchesClient.js';
 import '../net/websocket/WebSocketTransport.js';

package/dist/vue/provider.d.ts

@@ -2,15 +2,16 @@ import { InjectionKey, App } from 'vue';
 import { Patches } from '../client/Patches.js';
 import { PatchesSync } from '../net/PatchesSync.js';
 import '../event-signal.js';
+import '../json-patch/types.js';
 import '../types.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';
-import '../json-patch/types.js';
-import '../client/PatchesDoc.js';
-import '../algorithms/shared/changeBatching.js';
+import '../client/ClientAlgorithm.js';
+import '../BaseDoc-DkP3tUhT.js';
 import '../client/PatchesStore.js';
-import '../net/protocol/types.js';
 import '../net/protocol/JSONRPCClient.js';
+import '../net/protocol/types.js';
+import '../algorithms/shared/changeBatching.js';
 import '../net/websocket/PatchesWebSocket.js';
 import '../net/PatchesClient.js';
 import '../net/websocket/WebSocketTransport.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dabble/patches",
-  "version": "0.5.22",
+  "version": "0.7.0",
   "description": "Immutable JSON Patch implementation based on RFC 6902 supporting operational transformation and last-writer-wins",
   "author": "Jacob Wright <jacwright@gmail.com>",
   "bugs": {

package/dist/algorithms/client/collapsePendingChanges.d.ts

@@ -1,30 +0,0 @@
-import { Change } from '../../types.js';
-import '../../json-patch/JSONPatch.js';
-import '@dabble/delta';
-import '../../json-patch/types.js';
-
-/**
- * Collapses redundant pending changes before sync to reduce network traffic.
- *
- * This optimization automatically detects and collapses multiple "replace" operations
- * on the same JSON path with primitive values (boolean, number, string, null) into
- * a single change containing only the final value.
- *
- * Example: If a user toggles a folder's open state 100 times while offline,
- * this collapses those 100 changes into just 1 change with the final state.
- *
- * Safety guarantees:
- * - Only collapses single-op changes (multi-op changes are atomic, preserve intent)
- * - Only collapses "replace" operations (not add, remove, move)
- * - Only collapses primitive values (not objects/arrays)
- * - Detects path invalidation from structural changes (remove, array shifts, move)
- * - Respects the submission bookmark to never collapse already-submitted changes
- *
- * @param changes Array of pending changes to potentially collapse
- * @param afterRev Optional revision bookmark - changes at or before this rev are not collapsed
- *                 (they may have been partially submitted to the server)
- * @returns Collapsed array of changes, maintaining correct ordering
- */
-declare function collapsePendingChanges(changes: Change[], afterRev?: number): Change[];
-
-export { collapsePendingChanges };

package/dist/algorithms/client/collapsePendingChanges.js

@@ -1,78 +0,0 @@
-import "../../chunk-IZ2YBCUP.js";
-function collapsePendingChanges(changes, afterRev) {
-  if (changes.length <= 1) {
-    return changes;
-  }
-  const pathState = /* @__PURE__ */ new Map();
-  const outputSlots = new Array(changes.length).fill(null);
-  for (let i = 0; i < changes.length; i++) {
-    const change = changes[i];
-    if (afterRev !== void 0 && change.rev !== void 0 && change.rev <= afterRev) {
-      outputSlots[i] = change;
-      continue;
-    }
-    updatePathInvalidations(change, pathState);
-    if (!isCollapsibleChange(change)) {
-      outputSlots[i] = change;
-      continue;
-    }
-    const path = change.ops[0].path;
-    const existing = pathState.get(path);
-    if (existing) {
-      outputSlots[existing.lastIndex] = null;
-    }
-    pathState.set(path, { lastChange: change, lastIndex: i });
-    outputSlots[i] = change;
-  }
-  return outputSlots.filter((c) => c !== null);
-}
-function isCollapsibleChange(change) {
-  if (change.ops.length !== 1) {
-    return false;
-  }
-  const op = change.ops[0];
-  if (op.op !== "replace") {
-    return false;
-  }
-  return isPrimitiveValue(op.value);
-}
-function isPrimitiveValue(value) {
-  if (value === null) return true;
-  const type = typeof value;
-  return type === "boolean" || type === "number" || type === "string";
-}
-function updatePathInvalidations(change, pathState) {
-  for (const op of change.ops) {
-    if (op.op === "remove" || op.op === "move") {
-      invalidatePathAndChildren(op.path, pathState);
-      if (op.op === "move" && "from" in op) {
-        invalidatePathAndChildren(op.from, pathState);
-      }
-    }
-    if (op.op === "add" || op.op === "remove") {
-      invalidateShiftedArrayPaths(op.path, pathState);
-    }
-  }
-}
-function invalidatePathAndChildren(opPath, pathState) {
-  for (const trackedPath of pathState.keys()) {
-    if (trackedPath === opPath || trackedPath.startsWith(opPath + "/")) {
-      pathState.delete(trackedPath);
-    }
-  }
-}
-function invalidateShiftedArrayPaths(opPath, pathState) {
-  const segments = opPath.split("/");
-  const lastSegment = segments[segments.length - 1];
-  if (/^\d+$/.test(lastSegment)) {
-    const arrayPath = segments.slice(0, -1).join("/");
-    for (const trackedPath of pathState.keys()) {
-      if (trackedPath.startsWith(arrayPath + "/")) {
-        pathState.delete(trackedPath);
-      }
-    }
-  }
-}
-export {
-  collapsePendingChanges
-};

package/dist/net/websocket/RPCServer.d.ts

@@ -1,141 +0,0 @@
-import { PatchesState, Change, CommitChangesOptions, DeleteDocOptions, ListVersionsOptions, VersionMetadata, EditableVersionMetadata, ListChangesOptions, Branch } from '../../types.js';
-import { PatchesBranchManager } from '../../server/PatchesBranchManager.js';
-import { PatchesHistoryManager } from '../../server/PatchesHistoryManager.js';
-import { PatchesServer } from '../../server/PatchesServer.js';
-import { JSONRPCServer } from '../protocol/JSONRPCServer.js';
-import { AuthorizationProvider, AuthContext } from './AuthorizationProvider.js';
-import '../../json-patch/JSONPatch.js';
-import '@dabble/delta';
-import '../../json-patch/types.js';
-import '../../server/types.js';
-import '../../event-signal.js';
-import '../../compression/index.js';
-import '../../algorithms/shared/lz.js';
-import '../protocol/types.js';
-
-/**
- * High-level client for the Patches real-time collaboration service.
- * This class provides document subscription, patch notification handling,
- * versioning, and other OT-specific functionality over a JSON RPC interface.
- */
-interface RPCServerOptions {
-    patches: PatchesServer;
-    history?: PatchesHistoryManager;
-    branches?: PatchesBranchManager;
-    auth?: AuthorizationProvider;
-}
-declare class RPCServer {
-    rpc: JSONRPCServer;
-    auth: AuthorizationProvider;
-    protected patches: PatchesServer;
-    protected history?: PatchesHistoryManager;
-    protected branches?: PatchesBranchManager;
-    /**
-     * Creates a new Patches WebSocket client instance.
-     * @param patches - The patches server instance to handle document operations
-     * @param history - (Optional) History manager instance to handle versioning operations
-     * @param branches - (Optional) Branch manager instance to handle branching operations
-     * @param auth - (Optional) Authorization provider implementation. Defaults to deny-all for security.
-     */
-    constructor({ patches, history, branches, auth }: RPCServerOptions);
-    /**
-     * Gets the latest state (content and revision) of a document.
-     * @param connectionId - The ID of the connection making the request
-     * @param params - The document parameters
-     * @param params.docId - The ID of the document
-     * @param params.atRev - Optional revision number to get document state at
-     */
-    getDoc(params: {
-        docId: string;
-        atRev?: number;
-    }, ctx?: AuthContext): Promise<PatchesState<any>>;
-    /**
-     * Gets changes that occurred for a document after a specific revision number.
-     * @param connectionId - The ID of the connection making the request
-     * @param params - The change request parameters
-     * @param params.docId - The ID of the document
-     * @param params.rev - The revision number after which to fetch changes
-     */
-    getChangesSince(params: {
-        docId: string;
-        rev: number;
-    }, ctx?: AuthContext): Promise<Change[]>;
-    /**
-     * Applies a set of client-generated changes to a document on the server.
-     * @param connectionId - The ID of the connection making the request
-     * @param params - The change parameters
-     * @param params.docId - The ID of the document
-     * @param params.changes - An array of changes to apply
-     * @param params.options - Optional commit settings (e.g., forceCommit for migrations)
-     */
-    commitChanges(params: {
-        docId: string;
-        changes: Change[];
-        options?: CommitChangesOptions;
-    }, ctx?: AuthContext): Promise<Change[]>;
-    /**
-     * Deletes a document on the server.
-     * @param connectionId - The ID of the connection making the request
-     * @param params - The deletion parameters
-     * @param params.docId - The ID of the document to delete
-     * @param params.options - Optional deletion settings (e.g., skipTombstone)
-     */
-    deleteDoc(params: {
-        docId: string;
-        options?: DeleteDocOptions;
-    }, ctx?: AuthContext): Promise<void>;
-    /**
-     * Removes the tombstone for a deleted document, allowing it to be recreated.
-     * @param params - The undelete parameters
-     * @param params.docId - The ID of the document to undelete
-     */
-    undeleteDoc(params: {
-        docId: string;
-    }, ctx?: AuthContext): Promise<boolean>;
-    listVersions(params: {
-        docId: string;
-        options?: ListVersionsOptions;
-    }, ctx?: AuthContext): Promise<VersionMetadata[]>;
-    createVersion(params: {
-        docId: string;
-        metadata: EditableVersionMetadata;
-    }, ctx?: AuthContext): Promise<string | null>;
-    updateVersion(params: {
-        docId: string;
-        versionId: string;
-        metadata: EditableVersionMetadata;
-    }, ctx?: AuthContext): Promise<void>;
-    getVersionState(params: {
-        docId: string;
-        versionId: string;
-    }, ctx?: AuthContext): Promise<any>;
-    getVersionChanges(params: {
-        docId: string;
-        versionId: string;
-    }, ctx?: AuthContext): Promise<Change[]>;
-    listServerChanges(params: {
-        docId: string;
-        options?: ListChangesOptions;
-    }, ctx?: AuthContext): Promise<Change[]>;
-    listBranches(params: {
-        docId: string;
-    }, ctx?: AuthContext): Promise<Branch[]>;
-    createBranch(params: {
-        docId: string;
-        rev: number;
-        metadata?: EditableVersionMetadata;
-    }, ctx?: AuthContext): Promise<string>;
-    closeBranch(params: {
-        branchId: string;
-    }, ctx?: AuthContext): Promise<void>;
-    mergeBranch(params: {
-        branchId: string;
-    }, ctx?: AuthContext): Promise<Change[]>;
-    protected assertAccess(ctx: AuthContext | undefined, docId: string, kind: 'read' | 'write', method: string, params?: Record<string, any>): Promise<void>;
-    assertRead(ctx: AuthContext | undefined, docId: string, method: string, params?: Record<string, any>): Promise<void>;
-    assertWrite(ctx: AuthContext | undefined, docId: string, method: string, params?: Record<string, any>): Promise<void>;
-    protected assertHistoryEnabled(): void;
-    protected assertBranchingEnabled(): void;
-}
-
-export { RPCServer, type RPCServerOptions };