@recordtimelabel/core 0.1.8 → 0.1.10

package/README.md

@@ -20,7 +20,7 @@ During local development an app can consume a sibling checkout with:
 For release builds, consume a fixed npm package, git tag, or private registry version so builds do not depend on a sibling folder path. The current published release is:
 
 ```json
-"@recordtimelabel/core": "0.1.7"
+"@recordtimelabel/core": "0.1.10"
 ```
 
 If this checkout's `package.json` is ahead of the published version, publish the new package before updating consumers to that version.
@@ -43,6 +43,7 @@ If this checkout's `package.json` is ahead of the published version, publish the
 - `buildFirestoreV1UserPatch(state, options)`
 - `buildFirestoreV2LogicalPaths(userId)`
 - `buildFirestoreV2DocumentsFromState(state, options)`
+- `buildFirestoreV2DocumentChangeSet(previousDocuments, nextDocuments, options)`
 - `buildStateFromFirestoreV2Documents(documents, options)`
 - `hasMeaningfulRecordTimeLabelCloudState(data, options)`
 - `buildRecordTimeLabelContentFingerprint(data)`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recordtimelabel/core",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "type": "module",
   "description": "Shared RecordTimeLabel data model, merge logic, operations, and sync engine.",
   "main": "./src/index.js",

package/src/index.js

@@ -5,7 +5,7 @@ const REQUIRED_FOLDERS = [
   { id: DEFAULT_FOLDER_ID, name: 'Uncategorized' }
 ];
 
-export const RECORD_TIMELABEL_CORE_VERSION = '0.1.8';
+export const RECORD_TIMELABEL_CORE_VERSION = '0.1.10';
 
 export const OPERATION_TYPES = Object.freeze({
   RECORD_CREATE: 'record.create',
@@ -1274,6 +1274,106 @@ export const buildFirestoreV2DocumentsFromState = (state = {}, options = {}) =>
   };
 };
 
+const canonicalizeFirestoreV2DocumentValue = (value) => {
+  if (value === null) {
+    return ['null'];
+  }
+  if (Array.isArray(value)) {
+    return ['array', value.map((entry) => canonicalizeFirestoreV2DocumentValue(entry))];
+  }
+  if (value instanceof Date) {
+    const timestamp = value.getTime();
+    return ['date', Number.isNaN(timestamp) ? 'invalid' : value.toISOString()];
+  }
+
+  const valueType = typeof value;
+  if (valueType === 'number') {
+    if (Number.isNaN(value)) return ['number', 'NaN'];
+    if (value === Infinity) return ['number', 'Infinity'];
+    if (value === -Infinity) return ['number', '-Infinity'];
+    return ['number', value];
+  }
+  if (valueType !== 'object') {
+    return [valueType, valueType === 'bigint' ? value.toString() : value];
+  }
+
+  return [
+    'object',
+    Object.keys(value)
+      .sort()
+      .map((key) => [key, canonicalizeFirestoreV2DocumentValue(value[key])])
+  ];
+};
+
+const areFirestoreV2DocumentValuesEqual = (left, right) => (
+  JSON.stringify(canonicalizeFirestoreV2DocumentValue(left)) ===
+  JSON.stringify(canonicalizeFirestoreV2DocumentValue(right))
+);
+
+const buildFirestoreV2CollectionChangeSet = (previousCollection, nextCollection, allowDeletes) => {
+  const previous = previousCollection && typeof previousCollection === 'object'
+    ? previousCollection
+    : {};
+  const next = nextCollection && typeof nextCollection === 'object'
+    ? nextCollection
+    : {};
+  const upserts = {};
+
+  Object.keys(next).sort().forEach((documentId) => {
+    if (!Object.prototype.hasOwnProperty.call(previous, documentId) ||
+      !areFirestoreV2DocumentValuesEqual(previous[documentId], next[documentId])) {
+      upserts[documentId] = next[documentId];
+    }
+  });
+
+  const deleteIds = allowDeletes
+    ? Object.keys(previous).filter((documentId) => (
+      !Object.prototype.hasOwnProperty.call(next, documentId)
+    )).sort()
+    : [];
+
+  return { upserts, deleteIds };
+};
+
+export const buildFirestoreV2DocumentChangeSet = (
+  previousDocuments = {},
+  nextDocuments = {},
+  options = {}
+) => {
+  const allowDeletes = options.allowDeletes === true;
+  const previousRoot = previousDocuments?.root;
+  const nextRoot = nextDocuments?.root;
+  const rootUpsert = nextRoot && !areFirestoreV2DocumentValuesEqual(previousRoot, nextRoot)
+    ? nextRoot
+    : null;
+  const records = buildFirestoreV2CollectionChangeSet(
+    previousDocuments?.records,
+    nextDocuments?.records,
+    allowDeletes
+  );
+  const folders = buildFirestoreV2CollectionChangeSet(
+    previousDocuments?.folders,
+    nextDocuments?.folders,
+    allowDeletes
+  );
+  const ops = buildFirestoreV2CollectionChangeSet(
+    previousDocuments?.ops,
+    nextDocuments?.ops,
+    allowDeletes
+  );
+  const hasCollectionChanges = [records, folders, ops].some((changeSet) => (
+    Object.keys(changeSet.upserts).length > 0 || changeSet.deleteIds.length > 0
+  ));
+
+  return {
+    hasChanges: Boolean(rootUpsert) || hasCollectionChanges,
+    root: { upsert: rootUpsert },
+    records,
+    folders,
+    ops
+  };
+};
+
 const removeV2Metadata = (data = {}) => {
   const { schemaVersion, folderId, ...rest } = data || {};
   return rest;
@@ -2125,6 +2225,7 @@ export default {
   buildFirestoreV1UserPatch,
   buildFirestoreV2LogicalPaths,
   buildFirestoreV2DocumentsFromState,
+  buildFirestoreV2DocumentChangeSet,
   buildStateFromFirestoreV2Documents,
   flushPendingOperations,
   mergeRemoteStateIntoLocal,