@dabble/patches 0.5.21 → 0.6.0

package/dist/algorithms/server/commitChanges.js

@@ -1,5 +1,4 @@
 import "../../chunk-IZ2YBCUP.js";
-import { clampTimestamp, getISO, timestampDiff } from "../../utils/dates.js";
 import { filterSoftWritesAgainstState } from "../../json-patch/utils/softWrites.js";
 import { applyChanges } from "../shared/applyChanges.js";
 import { createVersion } from "./createVersion.js";
@@ -28,7 +27,7 @@ async function commitChanges(store, docId, changes, sessionTimeoutMillis, option
       });
     }
   }
-  const serverNow = getISO();
+  const serverNow = Date.now();
   let rev = baseRev + 1;
   changes.forEach((c) => {
     if (c.baseRev == null) c.baseRev = baseRev;
@@ -40,7 +39,7 @@ async function commitChanges(store, docId, changes, sessionTimeoutMillis, option
     if (!options?.historicalImport || !c.committedAt) {
       c.committedAt = serverNow;
     }
-    c.createdAt = c.createdAt ? clampTimestamp(c.createdAt, serverNow) : serverNow;
+    c.createdAt = c.createdAt ? Math.min(c.createdAt, serverNow) : serverNow;
   });
   if (baseRev > currentRev) {
     throw new Error(
@@ -54,7 +53,7 @@ async function commitChanges(store, docId, changes, sessionTimeoutMillis, option
   }
   const lastChange = currentChanges[currentChanges.length - 1];
   const compareTime = options?.historicalImport ? changes[0].createdAt : serverNow;
-  if (lastChange && timestampDiff(compareTime, lastChange.createdAt) > sessionTimeoutMillis) {
+  if (lastChange && compareTime - lastChange.createdAt > sessionTimeoutMillis) {
     await createVersion(store, docId, currentState, currentChanges);
   }
   const committedChanges = await store.listChanges(docId, {
@@ -66,7 +65,7 @@ async function commitChanges(store, docId, changes, sessionTimeoutMillis, option
   if (incomingChanges.length === 0) {
     return [committedChanges, []];
   }
-  const isOfflineTimestamp = timestampDiff(serverNow, incomingChanges[0].createdAt) > sessionTimeoutMillis;
+  const isOfflineTimestamp = serverNow - incomingChanges[0].createdAt > sessionTimeoutMillis;
   if (isOfflineTimestamp || batchId) {
     const canFastForward = committedChanges.length === 0;
     const origin = options?.historicalImport ? "main" : canFastForward ? "main" : "offline-branch";

package/dist/algorithms/server/createVersion.js

@@ -1,6 +1,5 @@
 import "../../chunk-IZ2YBCUP.js";
 import { createVersionMetadata } from "../../data/version.js";
-import { getISO } from "../../utils/dates.js";
 async function createVersion(store, docId, state, changes, metadata) {
   if (changes.length === 0) return;
   const startRev = changes[0].rev;
@@ -9,9 +8,8 @@ async function createVersion(store, docId, state, changes, metadata) {
   }
   const sessionMetadata = createVersionMetadata({
     origin: "main",
-    // Convert client timestamps to UTC for version metadata (enables lexicographic sorting)
-    startedAt: getISO(changes[0].createdAt),
-    endedAt: getISO(changes[changes.length - 1].createdAt),
+    startedAt: changes[0].createdAt,
+    endedAt: changes[changes.length - 1].createdAt,
     endRev: changes[changes.length - 1].rev,
     startRev,
     ...metadata

package/dist/algorithms/server/handleOfflineSessionsAndBatches.js

@@ -1,6 +1,5 @@
 import "../../chunk-IZ2YBCUP.js";
 import { createVersionMetadata } from "../../data/version.js";
-import { getISO, timestampDiff } from "../../utils/dates.js";
 import { applyChanges } from "../shared/applyChanges.js";
 import { breakChanges } from "../shared/changeBatching.js";
 import { getStateAtRevision } from "./getStateAtRevision.js";
@@ -22,14 +21,14 @@ async function handleOfflineSessionsAndBatches(store, sessionTimeoutMillis, docI
   let sessionStartIndex = 0;
   for (let i = 1; i <= changes.length; i++) {
     const isLastChange = i === changes.length;
-    const timeDiff = isLastChange ? Infinity : timestampDiff(changes[i].createdAt, changes[i - 1].createdAt);
+    const timeDiff = isLastChange ? Infinity : changes[i].createdAt - changes[i - 1].createdAt;
     if (timeDiff > sessionTimeoutMillis || isLastChange) {
       const sessionChanges = changes.slice(sessionStartIndex, i);
       if (sessionChanges.length > 0) {
-        const isContinuation = !!lastVersion && timestampDiff(sessionChanges[0].createdAt, lastVersion.endedAt) <= sessionTimeoutMillis;
+        const isContinuation = !!lastVersion && sessionChanges[0].createdAt - lastVersion.endedAt <= sessionTimeoutMillis;
         if (isContinuation) {
           const mergedState = applyChanges(offlineBaseState, sessionChanges);
-          const newEndedAt = getISO(sessionChanges[sessionChanges.length - 1].createdAt);
+          const newEndedAt = sessionChanges[sessionChanges.length - 1].createdAt;
           const newRev = sessionChanges[sessionChanges.length - 1].rev;
           await store.appendVersionChanges(docId, lastVersion.id, sessionChanges, newEndedAt, newRev, mergedState);
           offlineBaseState = mergedState;
@@ -41,9 +40,8 @@ async function handleOfflineSessionsAndBatches(store, sessionTimeoutMillis, docI
             groupId: batchId,
             origin,
             isOffline,
-            // Convert client timestamps to UTC for version metadata (enables lexicographic sorting)
-            startedAt: getISO(sessionChanges[0].createdAt),
-            endedAt: getISO(sessionChanges[sessionChanges.length - 1].createdAt),
+            startedAt: sessionChanges[0].createdAt,
+            endedAt: sessionChanges[sessionChanges.length - 1].createdAt,
             endRev: sessionChanges[sessionChanges.length - 1].rev,
             startRev: sessionChanges[0].rev
           });

package/dist/client/IndexedDBStore.d.ts

@@ -10,10 +10,10 @@ import '../json-patch/types.js';
  * - snapshots<{ docId: string; rev: number; state: any }> (primary key: docId)
  * - committedChanges<Change & { docId: string; }> (primary key: [docId, rev])
  * - pendingChanges<Change & { docId: string; }> (primary key: [docId, rev])
- * - docs<{ docId: string; committedRev: number; deleted?: boolean }> (primary key: docId)
+ * - docs<{ docId: string; committedRev: number; lastAttemptedSubmissionRev?: number; deleted?: boolean }> (primary key: docId)
  *
  * Under the hood, this class will store snapshots of the document only for committed state. It will not update the
- * committed state on *every* received committed change as this can cause issues with IndexedDB with many large updates.
+ * committed state on *every* received committed change as this can cause issues with IndexedDB with many small updates.
  * After every 200 committed changes, the class will save the current state to the snapshot store and delete the committed changes that went into it.
  * A snapshot will not be created if there are pending changes based on revisions older than the 200th committed change until those pending changes are committed.
  */

package/dist/data/change.js

@@ -1,7 +1,6 @@
 import "../chunk-IZ2YBCUP.js";
 import { inc } from "alphacounter";
 import { createId } from "crypto-id";
-import { getLocalISO } from "../utils/dates.js";
 function createChangeId(rev) {
   return inc.from(rev) + createId(4);
 }
@@ -10,7 +9,7 @@ function createChange(baseRev, rev, ops, metadata) {
     return {
       id: createId(8),
       ops: baseRev,
-      createdAt: getLocalISO(),
+      createdAt: Date.now(),
       ...rev
     };
   } else {
@@ -19,7 +18,7 @@ function createChange(baseRev, rev, ops, metadata) {
       baseRev,
       rev,
       ops,
-      createdAt: getLocalISO(),
+      createdAt: Date.now(),
       ...metadata
     };
   }

package/dist/{index-CvQws3AB.d.ts → index-C7ZhU2kS.d.ts}

@@ -3,6 +3,7 @@ import { add } from './json-patch/ops/add.js';
 import { bit } from './json-patch/ops/bitmask.js';
 import { copy } from './json-patch/ops/copy.js';
 import { increment } from './json-patch/ops/increment.js';
+import { max, min } from './json-patch/ops/minmax.js';
 import { move } from './json-patch/ops/move.js';
 import { remove } from './json-patch/ops/remove.js';
 import { replace } from './json-patch/ops/replace.js';
@@ -18,6 +19,8 @@ declare function getTypes(custom?: JSONPatchOpHandlerMap): {
     '@inc': JSONPatchOpHandler;
     '@bit': JSONPatchOpHandler;
     '@txt': JSONPatchOpHandler;
+    '@max': JSONPatchOpHandler;
+    '@min': JSONPatchOpHandler;
 };
 
 declare const index_add: typeof add;
@@ -25,12 +28,14 @@ declare const index_bit: typeof bit;
 declare const index_copy: typeof copy;
 declare const index_getTypes: typeof getTypes;
 declare const index_increment: typeof increment;
+declare const index_max: typeof max;
+declare const index_min: typeof min;
 declare const index_move: typeof move;
 declare const index_remove: typeof remove;
 declare const index_replace: typeof replace;
 declare const index_test: typeof test;
 declare namespace index {
-  export { index_add as add, index_bit as bit, index_copy as copy, index_getTypes as getTypes, index_increment as increment, index_move as move, index_remove as remove, index_replace as replace, index_test as test };
+  export { index_add as add, index_bit as bit, index_copy as copy, index_getTypes as getTypes, index_increment as increment, index_max as max, index_min as min, index_move as move, index_remove as remove, index_replace as replace, index_test as test };
 }
 
 export { getTypes as g, index as i };

package/dist/index.d.ts

@@ -12,16 +12,16 @@ export { applyPatch } from './json-patch/applyPatch.js';
 export { composePatch } from './json-patch/composePatch.js';
 export { invertPatch } from './json-patch/invertPatch.js';
 export { applyBitmask, bit, bitmask, combineBitmasks } from './json-patch/ops/bitmask.js';
-export { i as defaultOps, g as getTypes } from './index-CvQws3AB.js';
+export { i as defaultOps, g as getTypes } from './index-C7ZhU2kS.js';
 export { createPathProxy, pathProxy } from './json-patch/pathProxy.js';
 export { transformPatch } from './json-patch/transformPatch.js';
 export { JSONPatch, PathLike, WriteOptions } from './json-patch/JSONPatch.js';
 export { ApplyJSONPatchOptions, JSONPatchOpHandlerMap as JSONPatchCustomTypes, JSONPatchOp } from './json-patch/types.js';
 export { Branch, BranchStatus, Change, ChangeInput, ChangeMutator, CommitChangesOptions, DeleteDocOptions, DocumentTombstone, EditableBranchMetadata, EditableVersionMetadata, ListChangesOptions, ListVersionsOptions, PatchesSnapshot, PatchesState, PathProxy, SyncingState, VersionMetadata } from './types.js';
-export { clampTimestamp, extractTimezoneOffset, getISO, getLocalISO, getLocalTimezoneOffset, timestampDiff } from './utils/dates.js';
 export { add } from './json-patch/ops/add.js';
 export { copy } from './json-patch/ops/copy.js';
 export { increment } from './json-patch/ops/increment.js';
+export { max, min } from './json-patch/ops/minmax.js';
 export { move } from './json-patch/ops/move.js';
 export { remove } from './json-patch/ops/remove.js';
 export { replace } from './json-patch/ops/replace.js';

package/dist/index.js

@@ -5,7 +5,6 @@ export * from "./data/change.js";
 export * from "./data/version.js";
 export * from "./event-signal.js";
 export * from "./json-patch/index.js";
-export * from "./utils/dates.js";
 export {
   Delta
 };

package/dist/json-patch/JSONPatch.d.ts

@@ -70,6 +70,16 @@ declare class JSONPatch {
      * Decrements a numeric value by 1 or the given amount.
      */
     decrement(path: PathLike, value?: number): this;
+    /**
+     * Sets a value only if it's greater than the current value.
+     * Works with numbers or strings (ISO dates compare correctly).
+     */
+    max(path: PathLike, value: number | string): this;
+    /**
+     * Sets a value only if it's less than the current value.
+     * Works with numbers or strings (ISO dates compare correctly).
+     */
+    min(path: PathLike, value: number | string): this;
     /**
      * Flips a bit at the given index in a bitmask to the given value.
      */

package/dist/json-patch/JSONPatch.js

@@ -96,6 +96,22 @@ class JSONPatch {
   decrement(path, value = 1) {
     return this.op("@inc", path, -value);
   }
+  /**
+   * Sets a value only if it's greater than the current value.
+   * Works with numbers or strings (ISO dates compare correctly).
+   */
+  max(path, value) {
+    if (value && value.toJSON) value = value.toJSON();
+    return this.op("@max", path, value);
+  }
+  /**
+   * Sets a value only if it's less than the current value.
+   * Works with numbers or strings (ISO dates compare correctly).
+   */
+  min(path, value) {
+    if (value && value.toJSON) value = value.toJSON();
+    return this.op("@min", path, value);
+  }
   /**
    * Flips a bit at the given index in a bitmask to the given value.
    */

package/dist/json-patch/index.d.ts

@@ -2,7 +2,7 @@ export { applyPatch } from './applyPatch.js';
 export { composePatch } from './composePatch.js';
 export { invertPatch } from './invertPatch.js';
 export { applyBitmask, bit, bitmask, combineBitmasks } from './ops/bitmask.js';
-export { i as defaultOps, g as getTypes } from '../index-CvQws3AB.js';
+export { i as defaultOps, g as getTypes } from '../index-C7ZhU2kS.js';
 export { createPathProxy, pathProxy } from './pathProxy.js';
 export { transformPatch } from './transformPatch.js';
 export { JSONPatch, PathLike, WriteOptions } from './JSONPatch.js';
@@ -10,6 +10,7 @@ export { ApplyJSONPatchOptions, JSONPatchOpHandlerMap as JSONPatchCustomTypes, J
 export { add } from './ops/add.js';
 export { copy } from './ops/copy.js';
 export { increment } from './ops/increment.js';
+export { max, min } from './ops/minmax.js';
 export { move } from './ops/move.js';
 export { remove } from './ops/remove.js';
 export { replace } from './ops/replace.js';

package/dist/json-patch/ops/index.d.ts

@@ -3,8 +3,9 @@ export { add } from './add.js';
 export { bit } from './bitmask.js';
 export { copy } from './copy.js';
 export { increment } from './increment.js';
+export { max, min } from './minmax.js';
 export { move } from './move.js';
 export { remove } from './remove.js';
 export { replace } from './replace.js';
 export { test } from './test.js';
-export { g as getTypes } from '../../index-CvQws3AB.js';
+export { g as getTypes } from '../../index-C7ZhU2kS.js';

package/dist/json-patch/ops/index.js

@@ -3,6 +3,7 @@ import { add } from "./add.js";
 import { bit } from "./bitmask.js";
 import { copy } from "./copy.js";
 import { increment } from "./increment.js";
+import { max, min } from "./minmax.js";
 import { move } from "./move.js";
 import { remove } from "./remove.js";
 import { replace } from "./replace.js";
@@ -19,6 +20,8 @@ function getTypes(custom) {
     "@inc": increment,
     "@bit": bit,
     "@txt": text,
+    "@max": max,
+    "@min": min,
     ...custom
   };
 }
@@ -28,6 +31,8 @@ export {
   copy,
   getTypes,
   increment,
+  max,
+  min,
   move,
   remove,
   replace,

package/dist/json-patch/ops/minmax.d.ts

@@ -0,0 +1,14 @@
+import { JSONPatchOpHandler } from '../types.js';
+
+/**
+ * Set a value only if it's greater than the current value. Works with numbers or strings
+ * (ISO dates compare correctly). Useful for tracking "latest" values like lastModifiedAt.
+ */
+declare const max: JSONPatchOpHandler;
+/**
+ * Set a value only if it's less than the current value. Works with numbers or strings
+ * (ISO dates compare correctly). Useful for tracking "earliest" values like createdAt.
+ */
+declare const min: JSONPatchOpHandler;
+
+export { max, min };

package/dist/json-patch/ops/minmax.js

@@ -0,0 +1,44 @@
+import "../../chunk-IZ2YBCUP.js";
+import { get } from "../utils/get.js";
+import { updateRemovedOps } from "../utils/ops.js";
+import { replace } from "./replace.js";
+const max = {
+  like: "replace",
+  apply(state, path, value) {
+    const current = get(state, path);
+    if (current == null || value > current) {
+      return replace.apply(state, path, value);
+    }
+  },
+  transform(state, thisOp, otherOps) {
+    return updateRemovedOps(state, thisOp.path, otherOps, false, true);
+  },
+  invert(state, op, value, changedObj, isIndex) {
+    return replace.invert(state, op, value, changedObj, isIndex);
+  },
+  compose(_state, value1, value2) {
+    return value1 > value2 ? value1 : value2;
+  }
+};
+const min = {
+  like: "replace",
+  apply(state, path, value) {
+    const current = get(state, path);
+    if (current == null || value < current) {
+      return replace.apply(state, path, value);
+    }
+  },
+  transform(state, thisOp, otherOps) {
+    return updateRemovedOps(state, thisOp.path, otherOps, false, true);
+  },
+  invert(state, op, value, changedObj, isIndex) {
+    return replace.invert(state, op, value, changedObj, isIndex);
+  },
+  compose(_state, value1, value2) {
+    return value1 < value2 ? value1 : value2;
+  }
+};
+export {
+  max,
+  min
+};

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

@@ -99,7 +99,7 @@ declare class RPCServer {
     createVersion(params: {
         docId: string;
         metadata: EditableVersionMetadata;
-    }, ctx?: AuthContext): Promise<string>;
+    }, ctx?: AuthContext): Promise<string | null>;
     updateVersion(params: {
         docId: string;
         versionId: string;

package/dist/server/CompressedStoreBackend.d.ts

@@ -31,7 +31,7 @@ declare class CompressedStoreBackend implements PatchesStoreBackend {
     saveChanges(docId: string, changes: Change[]): Promise<void>;
     listChanges(docId: string, options: ListChangesOptions): Promise<Change[]>;
     createVersion(docId: string, metadata: VersionMetadata, state: any, changes: Change[]): Promise<void>;
-    appendVersionChanges(docId: string, versionId: string, changes: Change[], newEndedAt: string, newRev: number, newState: any): Promise<void>;
+    appendVersionChanges(docId: string, versionId: string, changes: Change[], newEndedAt: number, newRev: number, newState: any): Promise<void>;
     loadVersionChanges(docId: string, versionId: string): Promise<Change[]>;
     get loadLastVersionState(): PatchesStoreBackend['loadLastVersionState'];
     get saveLastVersionState(): PatchesStoreBackend['saveLastVersionState'];

package/dist/server/PatchesBranchManager.js

@@ -3,7 +3,6 @@ import { createId } from "crypto-id";
 import { breakChanges } from "../algorithms/shared/changeBatching.js";
 import { createChange } from "../data/change.js";
 import { createVersionMetadata } from "../data/version.js";
-import { getISO } from "../utils/dates.js";
 class PatchesBranchManager {
   constructor(store, patchesServer, maxPayloadBytes) {
     this.store = store;
@@ -33,7 +32,7 @@ class PatchesBranchManager {
     }
     const stateAtRev = (await this.patchesServer.getStateAtRevision(docId, rev)).state;
     const branchDocId = this.store.createBranchId ? await Promise.resolve(this.store.createBranchId(docId)) : createId(22);
-    const now = getISO();
+    const now = Date.now();
     const initialVersionMetadata = createVersionMetadata({
       origin: "main",
       // Branch doc versions are 'main' until merged

package/dist/server/PatchesHistoryManager.d.ts

@@ -27,9 +27,9 @@ declare class PatchesHistoryManager {
      * Create a new named version snapshot of a document's current state.
      * @param docId The document ID.
      * @param name The name of the version.
-     * @returns The ID of the created version.
+     * @returns The ID of the created version, or null if no changes to capture.
      */
-    createVersion(docId: string, metadata?: EditableVersionMetadata): Promise<string>;
+    createVersion(docId: string, metadata?: EditableVersionMetadata): Promise<string | null>;
     /**
      * Updates the name of a specific version.
      * @param docId - The ID of the document.

package/dist/server/PatchesHistoryManager.js

@@ -22,7 +22,7 @@ class PatchesHistoryManager {
    * Create a new named version snapshot of a document's current state.
    * @param docId The document ID.
    * @param name The name of the version.
-   * @returns The ID of the created version.
+   * @returns The ID of the created version, or null if no changes to capture.
    */
   async createVersion(docId, metadata) {
     assertVersionMetadata(metadata);

package/dist/server/PatchesServer.d.ts

@@ -104,7 +104,7 @@ declare class PatchesServer {
      * @param metadata Optional metadata for the version.
      * @returns The ID of the created version.
      */
-    captureCurrentVersion(docId: string, metadata?: EditableVersionMetadata): Promise<string>;
+    captureCurrentVersion(docId: string, metadata?: EditableVersionMetadata): Promise<string | null>;
 }
 declare function assertVersionMetadata(metadata?: EditableVersionMetadata): void;
 

package/dist/server/PatchesServer.js

@@ -7,7 +7,6 @@ import { applyChanges } from "../algorithms/shared/applyChanges.js";
 import { createChange } from "../data/change.js";
 import { signal } from "../event-signal.js";
 import { createJSONPatch } from "../json-patch/createJSONPatch.js";
-import { getISO } from "../utils/dates.js";
 import { CompressedStoreBackend } from "./CompressedStoreBackend.js";
 class PatchesServer {
   sessionTimeoutMillis;
@@ -108,7 +107,7 @@ class PatchesServer {
       const { rev: lastRev } = await this.getDoc(docId);
       await this.store.createTombstone({
         docId,
-        deletedAt: getISO(),
+        deletedAt: Date.now(),
         lastRev,
         deletedByClientId: originClientId
       });
@@ -146,7 +145,7 @@ class PatchesServer {
     state = applyChanges(state, changes);
     const version = await createVersion(this.store, docId, state, changes, metadata);
     if (!version) {
-      throw new Error(`No changes to create a version for doc ${docId}.`);
+      return null;
     }
     return version.id;
   }

package/dist/server/types.d.ts

@@ -27,7 +27,7 @@ interface PatchesStoreBackend {
      * Appends changes to an existing version, updating its state snapshot, endedAt, and endRev.
      * Used when a session spans multiple batch submissions.
      */
-    appendVersionChanges(docId: string, versionId: string, changes: Change[], newEndedAt: string, newEndRev: number, newState: any): Promise<void>;
+    appendVersionChanges(docId: string, versionId: string, changes: Change[], newEndedAt: number, newEndRev: number, newState: any): Promise<void>;
     /** Lists version metadata based on filtering/sorting options. */
     listVersions(docId: string, options: ListVersionsOptions): Promise<VersionMetadata[]>;
     /** Loads the state snapshot for a specific version ID. */

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. */
+    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,8 @@ 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 committed. */
+    committedAt: number;
 }
 /**
  * Represents the state of a document in the OT protocol.
@@ -71,8 +71,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 +89,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 +122,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dabble/patches",
-  "version": "0.5.21",
+  "version": "0.6.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/utils/dates.d.ts

@@ -1,43 +0,0 @@
-/**
- * Date utility functions for creating and manipulating ISO 8601 timestamps.
- *
- * Client-side timestamps use local timezone offsets (e.g., +04:00).
- * Server-side timestamps use UTC with Z suffix.
- */
-/**
- * Converts a Date or ISO string to UTC format without milliseconds.
- * Example: "2025-12-26T10:00:00Z"
- */
-declare function getISO(date?: Date | string): string;
-/**
- * Formats a Date with a specific timezone offset string.
- * The date is adjusted to display the correct local time for that offset.
- */
-declare function getLocalISO(date?: Date | string, offset?: string): string;
-/**
- * Calculates milliseconds between two ISO timestamps.
- * Returns (a - b) in milliseconds.
- */
-declare function timestampDiff(a: string, b: string): number;
-/**
- * Clamps a timestamp to not exceed a limit, preserving the original timezone offset.
- * Returns the original if it's <= limit, otherwise returns limit in original's timezone.
- *
- * Example:
- *   timestamp: "2025-12-26T18:00:00+04:00" (future)
- *   limit:     "2025-12-26T10:00:00Z"      (server time)
- *   result:    "2025-12-26T14:00:00+04:00" (clamped, same instant as limit)
- */
-declare function clampTimestamp(timestamp: string, limit: string): string;
-/**
- * Extracts the timezone offset string from an ISO timestamp.
- * Returns "+04:00", "-05:00", or "Z".
- */
-declare function extractTimezoneOffset(iso: string): string;
-/**
- * Gets the local timezone offset string for the current environment.
- * Returns "+04:00", "-05:00", or "Z" for UTC.
- */
-declare function getLocalTimezoneOffset(): string;
-
-export { clampTimestamp, extractTimezoneOffset, getISO, getLocalISO, getLocalTimezoneOffset, timestampDiff };

package/dist/utils/dates.js

@@ -1,47 +0,0 @@
-import "../chunk-IZ2YBCUP.js";
-function getISO(date = /* @__PURE__ */ new Date()) {
-  const d = typeof date === "string" ? new Date(date) : date;
-  return d.toISOString().replace(/\.\d{3}/, "");
-}
-function getLocalISO(date = /* @__PURE__ */ new Date(), offset = getLocalTimezoneOffset()) {
-  const match = offset.match(/([+-])(\d{2}):(\d{2})/);
-  if (offset === "Z" || !match) return getISO(date);
-  const sign = match[1] === "+" ? 1 : -1;
-  const offsetMinutes = sign * (parseInt(match[2]) * 60 + parseInt(match[3]));
-  const localDate = new Date((typeof date === "string" ? new Date(date) : date).getTime() + offsetMinutes * 60 * 1e3);
-  return getISO(localDate).slice(0, -1) + offset;
-}
-function timestampDiff(a, b) {
-  return new Date(a).getTime() - new Date(b).getTime();
-}
-function clampTimestamp(timestamp, limit) {
-  if (!timestamp || !limit) throw new Error("Timestamp and limit are required");
-  const timestampDate = new Date(timestamp);
-  const limitDate = new Date(limit);
-  if (timestampDate <= limitDate) {
-    return timestamp;
-  }
-  const offset = extractTimezoneOffset(timestamp);
-  return getLocalISO(limitDate, offset);
-}
-function extractTimezoneOffset(iso) {
-  if (!iso) return "Z";
-  const match = iso.match(/([+-]\d{2}:\d{2}|Z)$/);
-  return match ? match[1] : "Z";
-}
-function getLocalTimezoneOffset() {
-  const offset = -(/* @__PURE__ */ new Date()).getTimezoneOffset();
-  if (offset === 0) return "Z";
-  const hours = Math.floor(Math.abs(offset) / 60);
-  const mins = Math.abs(offset) % 60;
-  const sign = offset >= 0 ? "+" : "-";
-  return `${sign}${String(hours).padStart(2, "0")}:${String(mins).padStart(2, "0")}`;
-}
-export {
-  clampTimestamp,
-  extractTimezoneOffset,
-  getISO,
-  getLocalISO,
-  getLocalTimezoneOffset,
-  timestampDiff
-};