@homeostate/crdt-automerge 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @homeostate/crdt-automerge
 
+## 0.1.3
+
+### Patch Changes
+
+- 33c7b14: Mark the package side-effect free, so bundlers can drop modules that are not imported.
+- fb76f77: Preserve complete Unicode code points when diffing and applying string edits. Deleting or
+  replacing supplementary characters such as emoji no longer corrupts text, deletes adjacent
+  characters, or throws in the supplied CRDT backends.
+
+  String `Change` offsets remain UTF-16 code units. A string deletion can now carry a numeric
+  UTF-16 deletion length in its third tuple entry; `undefined` still means one unit. Custom
+  backends consuming `getChanges` must honor this length in one operation rather than delete
+  one code unit per step. Array and object deletion semantics are unchanged.
+
+- Updated dependencies [a643bbe]
+- Updated dependencies [0bbf653]
+- Updated dependencies [fb76f77]
+  - @homeostate/core@0.2.0
+
+## 0.1.2
+
+### Patch Changes
+
+- 30abf27: Remove draft release warnings, update docs links
+- Updated dependencies [30abf27]
+  - @homeostate/core@0.1.2
+
 ## 0.1.1
 
 ### Patch Changes

package/README.md

@@ -1,8 +1,5 @@
 # @homeostate/crdt-automerge
 
-> **Draft / placeholder release.** `0.0.0` reserves the name while the API is still
-> being designed. Nothing here is stable — do not depend on it yet.
-
 [Automerge](https://automerge.org) backend for
 [`@homeostate/core`](https://github.com/mixedrays/homeostate/tree/main/packages/core).
 It maps the synced state onto one key of an Automerge document (nested objects become

package/dist/patching.js

@@ -65,6 +65,6 @@ const applyToText = (doc, path, type, index, value) => {
     if (type === ChangeType.INSERT)
         A.splice(doc, path, index, 0, value);
     else if (type === ChangeType.DELETE)
-        A.splice(doc, path, index, 1);
+        A.splice(doc, path, index, typeof value === "number" ? value : 1);
 };
 //# sourceMappingURL=patching.js.map

package/dist/patching.js.map

@@ -1 +1 @@
-{"version":3,"file":"patching.js","sourceRoot":"","sources":["../src/patching.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"patching.js","sourceRoot":"","sources":["../src/patching.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homeostate/crdt-automerge",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Automerge CRDT backend for @homeostate/core",
   "license": "MIT",
   "type": "module",
@@ -9,7 +9,7 @@
     "url": "git+https://github.com/mixedrays/homeostate.git",
     "directory": "packages/crdt-automerge"
   },
-  "homepage": "https://github.com/mixedrays/homeostate#readme",
+  "homepage": "https://homeostate.pages.dev",
   "bugs": {
     "url": "https://github.com/mixedrays/homeostate/issues"
   },
@@ -28,8 +28,11 @@
       "default": "./dist/index.js"
     }
   },
+  "sideEffects": false,
   "files": [
     "dist",
+    "src",
+    "!src/**/__tests__",
     "README.md",
     "LICENSE",
     "THIRD_PARTY_NOTICES.md",
@@ -39,7 +42,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@homeostate/core": "^0.1.1"
+    "@homeostate/core": "^0.2.0"
   },
   "peerDependencies": {
     "@automerge/automerge": "^3.0.0"

package/src/automerge-backend.ts

@@ -0,0 +1,37 @@
+import type { CrdtBackend, Unsubscribe } from "@homeostate/core";
+import type { AutomergeHandle } from "./handle.js";
+import { applyChanges, diff, toJson, type Container } from "./patching.js";
+import { createSnapshot } from "./snapshot.js";
+
+export const createAutomergeBackend = <T extends Container>(
+  handle: AutomergeHandle<T>,
+  name: string,
+): CrdtBackend => {
+  const snapshot = createSnapshot();
+  let writing = false;
+
+  const current = (): unknown => (handle.doc() as Container)[name];
+
+  return {
+    read: () => snapshot(current()) ?? {},
+
+    write: (next) => {
+      const changes = diff(current(), next);
+      if (changes?.length === 0) return;
+      writing = true;
+      try {
+        handle.change((doc) => {
+          if (changes === null) (doc as Container)[name] = toJson(next);
+          else applyChanges(doc as Container, [name], changes);
+        });
+      } finally {
+        writing = false;
+      }
+    },
+
+    subscribe: (onRemoteChange): Unsubscribe =>
+      handle.subscribe(() => {
+        if (!writing) onRemoteChange();
+      }),
+  };
+};

package/src/handle.ts

@@ -0,0 +1,51 @@
+import * as A from "@automerge/automerge";
+import type { Unsubscribe } from "@homeostate/core";
+
+export interface AutomergeHandleEvent<T> {
+  doc: A.Doc<T>;
+  local: boolean;
+}
+
+export interface AutomergeHandle<T = Record<string, unknown>> {
+  doc: () => A.Doc<T>;
+  change: (fn: A.ChangeFn<T>) => void;
+  update: (fn: (doc: A.Doc<T>) => A.Doc<T>) => void;
+  subscribe: (
+    listener: (event: AutomergeHandleEvent<T>) => void,
+  ) => Unsubscribe;
+}
+
+const sameHeads = (a: A.Heads, b: A.Heads): boolean =>
+  a.length === b.length && a.every((hash, i) => hash === b[i]);
+
+export const createAutomergeHandle = <T = Record<string, unknown>>(
+  initial: A.Doc<T> = A.init<T>(),
+): AutomergeHandle<T> => {
+  let current = initial;
+  const listeners = new Set<(event: AutomergeHandleEvent<T>) => void>();
+
+  const replace = (
+    operation: (doc: A.Doc<T>) => A.Doc<T>,
+    local: boolean,
+  ): void => {
+    const before = A.getHeads(current);
+    const next = operation(current);
+    if (next === current) return;
+    current = next;
+    if (sameHeads(before, A.getHeads(next))) return;
+    const event = { doc: next, local };
+    listeners.forEach((listener) => listener(event));
+  };
+
+  return {
+    doc: () => current,
+    change: (fn) => replace((doc) => A.change(doc, fn), true),
+    update: (fn) => replace(fn, false),
+    subscribe: (listener): Unsubscribe => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+  };
+};

package/src/index.ts

@@ -0,0 +1,3 @@
+export { createAutomergeBackend } from "./automerge-backend.js";
+export { createAutomergeHandle } from "./handle.js";
+export type { AutomergeHandle, AutomergeHandleEvent } from "./handle.js";

package/src/patching.ts

@@ -0,0 +1,106 @@
+import * as A from "@automerge/automerge";
+import { ChangeType, getChanges, type Change } from "@homeostate/core";
+
+export type Container = Record<string, unknown>;
+
+const isRecord = (value: unknown): value is Container =>
+  value !== null && typeof value === "object" && !Array.isArray(value);
+
+export const toJson = (value: unknown): unknown => {
+  if (Array.isArray(value))
+    return value.map((item) => (item === undefined ? null : toJson(item)));
+  if (!isRecord(value)) return value;
+  const result: Container = {};
+  for (const [key, item] of Object.entries(value))
+    if (item !== undefined) result[key] = toJson(item);
+  return result;
+};
+
+export const diff = (current: unknown, next: unknown): Change[] | null => {
+  if (!isRecord(next)) return [];
+  return isRecord(current) ? getChanges(current, next) : null;
+};
+
+export const applyChanges = (
+  doc: Container,
+  path: A.Prop[],
+  changes: Change[],
+): void => {
+  const container = path.reduce<unknown>(
+    (value, prop) => (value as Container)[prop],
+    doc,
+  );
+  for (const [type, key, value] of changes) {
+    if (typeof container === "string")
+      applyToText(doc, path, type, key as number, value);
+    else if (Array.isArray(container))
+      applyToList(doc, path, container, type, key as number, value);
+    else
+      applyToMap(doc, path, container as Container, type, key as string, value);
+  }
+};
+
+const applyToMap = (
+  doc: Container,
+  path: A.Prop[],
+  map: Container,
+  type: ChangeType,
+  key: string,
+  value: unknown,
+): void => {
+  switch (type) {
+    case ChangeType.INSERT:
+    case ChangeType.UPDATE:
+      if (value !== undefined) map[key] = toJson(value);
+      else if (key in map) delete map[key];
+      break;
+
+    case ChangeType.DELETE:
+      delete map[key];
+      break;
+
+    case ChangeType.PENDING:
+      applyChanges(doc, [...path, key], value as Change[]);
+      break;
+  }
+};
+
+const applyToList = (
+  doc: Container,
+  path: A.Prop[],
+  list: unknown[],
+  type: ChangeType,
+  index: number,
+  value: unknown,
+): void => {
+  switch (type) {
+    case ChangeType.INSERT:
+      A.insertAt(list, index, toJson(value));
+      break;
+
+    case ChangeType.UPDATE:
+      list[index] = toJson(value);
+      break;
+
+    case ChangeType.DELETE:
+      A.deleteAt(list, index, 1);
+      break;
+
+    case ChangeType.PENDING:
+      applyChanges(doc, [...path, index], value as Change[]);
+      break;
+  }
+};
+
+const applyToText = (
+  doc: Container,
+  path: A.Prop[],
+  type: ChangeType,
+  index: number,
+  value: unknown,
+): void => {
+  if (type === ChangeType.INSERT)
+    A.splice(doc, path, index, 0, value as string);
+  else if (type === ChangeType.DELETE)
+    A.splice(doc, path, index, typeof value === "number" ? value : 1);
+};

package/src/snapshot.ts

@@ -0,0 +1,18 @@
+export const createSnapshot = (): ((value: unknown) => unknown) => {
+  const copies = new WeakMap<object, unknown>();
+
+  const copy = (value: unknown): unknown => {
+    if (value === null || typeof value !== "object") return value;
+    const cached = copies.get(value);
+    if (cached !== undefined) return cached;
+    const result = Array.isArray(value)
+      ? value.map(copy)
+      : Object.fromEntries(
+          Object.entries(value).map(([key, item]) => [key, copy(item)]),
+        );
+    copies.set(value, result);
+    return result;
+  };
+
+  return copy;
+};