@dabble/patches 0.5.22 → 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/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.d.ts

@@ -18,7 +18,6 @@ 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';

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/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/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
       });

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.22",
+  "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
-};