@dabble/patches 0.5.0 → 0.5.2

package/dist/algorithms/server/commitChanges.js

@@ -1,5 +1,5 @@
 import "../../chunk-IZ2YBCUP.js";
-import { clampTimestamp, createServerTimestamp, timestampDiff } from "../../utils/dates.js";
+import { clampTimestamp, getISO, timestampDiff } from "../../utils/dates.js";
 import { applyChanges } from "../shared/applyChanges.js";
 import { createVersion } from "./createVersion.js";
 import { getSnapshotAtRevision } from "./getSnapshotAtRevision.js";
@@ -15,7 +15,7 @@ async function commitChanges(store, docId, changes, sessionTimeoutMillis) {
   const currentState = applyChanges(initialState, currentChanges);
   const currentRev = currentChanges.at(-1)?.rev ?? initialRev;
   const baseRev = changes[0].baseRev ?? currentRev;
-  const serverNow = createServerTimestamp();
+  const serverNow = getISO();
   let rev = baseRev + 1;
   changes.forEach((c) => {
     if (c.baseRev == null) c.baseRev = baseRev;

package/dist/algorithms/server/createVersion.js

@@ -1,5 +1,6 @@
 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 baseRev = changes[0].baseRev;
@@ -9,8 +10,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: new Date(changes[0].createdAt).toISOString(),
-    endedAt: new Date(changes[changes.length - 1].createdAt).toISOString(),
+    startedAt: getISO(changes[0].createdAt),
+    endedAt: getISO(changes[changes.length - 1].createdAt),
     rev: changes[changes.length - 1].rev,
     baseRev,
     ...metadata

package/dist/algorithms/server/handleOfflineSessionsAndBatches.js

@@ -1,7 +1,7 @@
 import "../../chunk-IZ2YBCUP.js";
 import { createSortableId } from "crypto-id";
 import { createVersionMetadata } from "../../data/version.js";
-import { timestampDiff } from "../../utils/dates.js";
+import { getISO, timestampDiff } from "../../utils/dates.js";
 import { applyChanges } from "../shared/applyChanges.js";
 import { getStateAtRevision } from "./getStateAtRevision.js";
 async function handleOfflineSessionsAndBatches(store, sessionTimeoutMillis, docId, changes, baseRev, batchId) {
@@ -41,8 +41,8 @@ async function handleOfflineSessionsAndBatches(store, sessionTimeoutMillis, docI
             groupId,
             origin: "offline",
             // Convert client timestamps to UTC for version metadata (enables lexicographic sorting)
-            startedAt: new Date(sessionChanges[0].createdAt).toISOString(),
-            endedAt: new Date(sessionChanges[sessionChanges.length - 1].createdAt).toISOString(),
+            startedAt: getISO(sessionChanges[0].createdAt),
+            endedAt: getISO(sessionChanges[sessionChanges.length - 1].createdAt),
             rev: sessionChanges[sessionChanges.length - 1].rev,
             baseRev
           });

package/dist/data/change.js

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

package/dist/index.d.ts

@@ -18,6 +18,7 @@ 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, 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,6 +5,7 @@ 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/PatchesBranchManager.js

@@ -2,7 +2,7 @@ import "../chunk-IZ2YBCUP.js";
 import { createId } from "crypto-id";
 import { createChange } from "../data/change.js";
 import { createVersionMetadata } from "../data/version.js";
-import { createServerTimestamp } from "../utils/dates.js";
+import { getISO } from "../utils/dates.js";
 class PatchesBranchManager {
   constructor(store, patchesServer) {
     this.store = store;
@@ -31,7 +31,7 @@ class PatchesBranchManager {
     }
     const stateAtRev = (await this.patchesServer.getStateAtRevision(docId, rev)).state;
     const branchDocId = createId();
-    const now = createServerTimestamp();
+    const now = getISO();
     const initialVersionMetadata = createVersionMetadata({
       origin: "main",
       // Branch doc versions are 'main' until merged

package/dist/utils/dates.d.ts

@@ -5,48 +5,39 @@
  * Server-side timestamps use UTC with Z suffix.
  */
 /**
- * Creates an ISO string with local timezone offset for client dates.
- * Example: "2025-12-26T14:00:00.000+04:00"
+ * Converts a Date or ISO string to UTC format without milliseconds.
+ * Example: "2025-12-26T10:00:00Z"
  */
-declare function createClientTimestamp(): string;
+declare function getISO(date?: Date | string): string;
 /**
- * Creates an ISO string with Z suffix for server dates.
- * Example: "2025-12-26T10:00:00.000Z"
- */
-declare function createServerTimestamp(): string;
-/**
- * Parses an ISO string to a Date for comparisons.
+ * Formats a Date with a specific timezone offset string.
+ * The date is adjusted to display the correct local time for that offset.
  */
-declare function parseTimestamp(iso: string): Date;
+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;
-/**
- * Extracts the timezone offset string from an ISO timestamp.
- * Returns "+04:00", "-05:00", or "Z".
- */
-declare function extractTimezoneOffset(iso: string): string;
 /**
  * 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.000+04:00" (future)
- *   limit:     "2025-12-26T10:00:00.000Z"      (server time)
- *   result:    "2025-12-26T14:00:00.000+04:00" (clamped, same instant as limit)
+ *   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;
 /**
- * Formats a Date with a specific timezone offset string.
- * The date is adjusted to display the correct local time for that offset.
+ * Extracts the timezone offset string from an ISO timestamp.
+ * Returns "+04:00", "-05:00", or "Z".
  */
-declare function formatWithOffset(date: Date, offset: string): string;
+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, createClientTimestamp, createServerTimestamp, extractTimezoneOffset, formatWithOffset, getLocalTimezoneOffset, parseTimestamp, timestampDiff };
+export { clampTimestamp, extractTimezoneOffset, getISO, getLocalISO, getLocalTimezoneOffset, timestampDiff };

package/dist/utils/dates.js

@@ -1,21 +1,19 @@
 import "../chunk-IZ2YBCUP.js";
-function createClientTimestamp() {
-  const now = /* @__PURE__ */ new Date();
-  return formatWithOffset(now, getLocalTimezoneOffset());
+function getISO(date = /* @__PURE__ */ new Date()) {
+  const d = typeof date === "string" ? new Date(date) : date;
+  return d.toISOString().replace(/\.\d{3}/, "");
 }
-function createServerTimestamp() {
-  return (/* @__PURE__ */ new Date()).toISOString();
-}
-function parseTimestamp(iso) {
-  return new Date(iso);
+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 extractTimezoneOffset(iso) {
-  const match = iso.match(/([+-]\d{2}:\d{2}|Z)$/);
-  return match ? match[1] : "Z";
-}
 function clampTimestamp(timestamp, limit) {
   const timestampDate = new Date(timestamp);
   const limitDate = new Date(limit);
@@ -23,19 +21,11 @@ function clampTimestamp(timestamp, limit) {
     return timestamp;
   }
   const offset = extractTimezoneOffset(timestamp);
-  return formatWithOffset(limitDate, offset);
+  return getLocalISO(limitDate, offset);
 }
-function formatWithOffset(date, offset) {
-  if (offset === "Z") {
-    return date.toISOString();
-  }
-  const match = offset.match(/([+-])(\d{2}):(\d{2})/);
-  if (!match) return date.toISOString();
-  const sign = match[1] === "+" ? 1 : -1;
-  const offsetMinutes = sign * (parseInt(match[2]) * 60 + parseInt(match[3]));
-  const localDate = new Date(date.getTime() + offsetMinutes * 60 * 1e3);
-  const iso = localDate.toISOString();
-  return iso.slice(0, -1) + offset;
+function extractTimezoneOffset(iso) {
+  const match = iso.match(/([+-]\d{2}:\d{2}|Z)$/);
+  return match ? match[1] : "Z";
 }
 function getLocalTimezoneOffset() {
   const offset = -(/* @__PURE__ */ new Date()).getTimezoneOffset();
@@ -47,11 +37,9 @@ function getLocalTimezoneOffset() {
 }
 export {
   clampTimestamp,
-  createClientTimestamp,
-  createServerTimestamp,
   extractTimezoneOffset,
-  formatWithOffset,
+  getISO,
+  getLocalISO,
   getLocalTimezoneOffset,
-  parseTimestamp,
   timestampDiff
 };

package/package.json

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