@absolutejs/sync-automerge 0.0.1

package/README.md

@@ -0,0 +1,51 @@
+# @absolutejs/sync-automerge
+
+An [Automerge](https://automerge.org)-backed collaborative-text CRDT for
+[`@absolutejs/sync`](https://github.com/absolutejs/sync), behind the same
+`CrdtText` / `TextCrdtAdapter` contract as the core's zero-dependency `rgaText`
+and `@absolutejs/sync-yjs`.
+
+`@absolutejs/sync/crdt` ships a first-party RGA text CRDT that's great for
+offline-merge and moderate collaboration. Automerge is a mature, battle-tested
+CRDT library; this adapter lets you swap it in without touching your call sites.
+
+## Install
+
+```bash
+bun add @absolutejs/sync-automerge @automerge/automerge
+```
+
+`@absolutejs/sync` is a peer dependency. `@automerge/automerge` is a runtime
+dependency you install alongside.
+
+## Use
+
+```ts
+import { automergeText } from '@absolutejs/sync-automerge';
+// ...instead of: import { rgaText } from '@absolutejs/sync/crdt';
+
+// Server — declare the CRDT field with this backend
+engine.registerCrdt('doc', { state: automergeText });
+
+// Client — same hook, just pass the backend's factory
+const doc = useCollaborativeText({
+	collection: 'doc',
+	field: 'state',
+	id: 'shared',
+	url,
+	create: (replica) => createAutomergeText(replica)
+});
+```
+
+The serialized state is a base64 string of an Automerge document — JSON-safe for
+the sync engine's change feed. `merge` is commutative/associative/idempotent.
+
+## The contract
+
+Implements `TextCrdtAdapter<string>` from `@absolutejs/sync/crdt`: `create`,
+`merge`, `empty`, `textOf`. The `replica` argument is accepted for contract
+compatibility; Automerge manages actor identity internally.
+
+## License
+
+CC BY-NC 4.0

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * An Automerge-backed collaborative-text CRDT for `@absolutejs/sync`, behind the
+ * same `CrdtText` / `TextCrdtAdapter` contract as the first-party `rgaText` and
+ * `@absolutejs/sync-yjs`. Automerge is a mature, battle-tested CRDT library;
+ * swapping `rgaText` for `automergeText` needs no other change at the call site.
+ *
+ * The serialized state is a **base64 string** of an Automerge document, so it
+ * stays JSON-safe for the sync engine's change feed and row storage. Merges are
+ * commutative/associative/idempotent, so a merge-on-write mutation combines
+ * concurrent edits without clobbering.
+ */
+import type { CrdtText, TextCrdtAdapter } from '@absolutejs/sync/crdt';
+/** Create a live Automerge-backed collaborative-text doc for `replica`. */
+export declare const createAutomergeText: (replica: string, initial?: string) => CrdtText<string>;
+/**
+ * The Automerge collaborative-text backend as a {@link TextCrdtAdapter}. Drop-in
+ * for the first-party `rgaText`. The `replica` argument is accepted for contract
+ * compatibility; Automerge manages actor identity internally.
+ */
+export declare const automergeText: TextCrdtAdapter<string>;

package/dist/index.js

@@ -0,0 +1,73 @@
+// @bun
+// src/index.ts
+import * as Automerge from "@automerge/automerge";
+var toBase64 = (bytes) => {
+  let binary = "";
+  for (const byte of bytes) {
+    binary += String.fromCharCode(byte);
+  }
+  return btoa(binary);
+};
+var fromBase64 = (base64) => {
+  const binary = atob(base64);
+  const bytes = new Uint8Array(binary.length);
+  for (let index = 0;index < binary.length; index += 1) {
+    bytes[index] = binary.charCodeAt(index);
+  }
+  return bytes;
+};
+var emptyDoc = () => Automerge.from({ text: "" });
+var encode = (doc) => toBase64(Automerge.save(doc));
+var decode = (state) => Automerge.load(fromBase64(state));
+var load2 = (state) => state.length > 0 ? decode(state) : emptyDoc();
+var reconcile = (doc, next) => {
+  const current = doc.text;
+  if (current === next) {
+    return doc;
+  }
+  let prefix = 0;
+  const maxPrefix = Math.min(current.length, next.length);
+  while (prefix < maxPrefix && current[prefix] === next[prefix]) {
+    prefix += 1;
+  }
+  let suffix = 0;
+  while (suffix < maxPrefix - prefix && current[current.length - 1 - suffix] === next[next.length - 1 - suffix]) {
+    suffix += 1;
+  }
+  const removed = current.length - prefix - suffix;
+  const inserted = next.slice(prefix, next.length - suffix);
+  return Automerge.change(doc, (draft) => {
+    Automerge.splice(draft, ["text"], prefix, removed, inserted);
+  });
+};
+var createAutomergeText = (replica, initial) => {
+  let doc = initial !== undefined ? load2(initial) : emptyDoc();
+  return {
+    merge: (state) => {
+      if (state.length > 0) {
+        doc = Automerge.merge(doc, decode(state));
+      }
+    },
+    setText: (next) => {
+      doc = reconcile(doc, next);
+    },
+    state: () => encode(doc),
+    text: () => doc.text
+  };
+};
+var automergeText = {
+  create: createAutomergeText,
+  empty: () => encode(emptyDoc()),
+  merge: (a, b) => {
+    const merged = b.length > 0 ? Automerge.merge(load2(a), decode(b)) : load2(a);
+    return encode(merged);
+  },
+  textOf: (state) => load2(state).text
+};
+export {
+  createAutomergeText,
+  automergeText
+};
+
+//# debugId=FB0D6126D29D984364756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": [
+    "/**\n * An Automerge-backed collaborative-text CRDT for `@absolutejs/sync`, behind the\n * same `CrdtText` / `TextCrdtAdapter` contract as the first-party `rgaText` and\n * `@absolutejs/sync-yjs`. Automerge is a mature, battle-tested CRDT library;\n * swapping `rgaText` for `automergeText` needs no other change at the call site.\n *\n * The serialized state is a **base64 string** of an Automerge document, so it\n * stays JSON-safe for the sync engine's change feed and row storage. Merges are\n * commutative/associative/idempotent, so a merge-on-write mutation combines\n * concurrent edits without clobbering.\n */\nimport type { CrdtText, TextCrdtAdapter } from '@absolutejs/sync/crdt';\nimport * as Automerge from '@automerge/automerge';\n\ntype Doc = { text: string };\n\n// Isomorphic base64 (browser + Bun expose btoa/atob), so the adapter runs\n// unchanged on the client and the server.\nconst toBase64 = (bytes: Uint8Array): string => {\n\tlet binary = '';\n\tfor (const byte of bytes) {\n\t\tbinary += String.fromCharCode(byte);\n\t}\n\n\treturn btoa(binary);\n};\n\nconst fromBase64 = (base64: string): Uint8Array => {\n\tconst binary = atob(base64);\n\tconst bytes = new Uint8Array(binary.length);\n\tfor (let index = 0; index < binary.length; index += 1) {\n\t\tbytes[index] = binary.charCodeAt(index);\n\t}\n\n\treturn bytes;\n};\n\nconst emptyDoc = (): Automerge.Doc<Doc> => Automerge.from<Doc>({ text: '' });\nconst encode = (doc: Automerge.Doc<Doc>): string =>\n\ttoBase64(Automerge.save(doc));\nconst decode = (state: string): Automerge.Doc<Doc> =>\n\tAutomerge.load<Doc>(fromBase64(state));\nconst load = (state: string): Automerge.Doc<Doc> =>\n\tstate.length > 0 ? decode(state) : emptyDoc();\n\n// Reconcile `text` to `next` by editing only the changed middle (keep the common\n// prefix/suffix), so two replicas editing different spots merge.\nconst reconcile = (\n\tdoc: Automerge.Doc<Doc>,\n\tnext: string\n): Automerge.Doc<Doc> => {\n\tconst current = doc.text;\n\tif (current === next) {\n\t\treturn doc;\n\t}\n\tlet prefix = 0;\n\tconst maxPrefix = Math.min(current.length, next.length);\n\twhile (prefix < maxPrefix && current[prefix] === next[prefix]) {\n\t\tprefix += 1;\n\t}\n\tlet suffix = 0;\n\twhile (\n\t\tsuffix < maxPrefix - prefix &&\n\t\tcurrent[current.length - 1 - suffix] === next[next.length - 1 - suffix]\n\t) {\n\t\tsuffix += 1;\n\t}\n\tconst removed = current.length - prefix - suffix;\n\tconst inserted = next.slice(prefix, next.length - suffix);\n\n\treturn Automerge.change(doc, (draft) => {\n\t\tAutomerge.splice(draft, ['text'], prefix, removed, inserted);\n\t});\n};\n\n/** Create a live Automerge-backed collaborative-text doc for `replica`. */\nexport const createAutomergeText = (\n\treplica: string,\n\tinitial?: string\n): CrdtText<string> => {\n\tlet doc = initial !== undefined ? load(initial) : emptyDoc();\n\n\treturn {\n\t\tmerge: (state) => {\n\t\t\tif (state.length > 0) {\n\t\t\t\tdoc = Automerge.merge(doc, decode(state));\n\t\t\t}\n\t\t},\n\t\tsetText: (next) => {\n\t\t\tdoc = reconcile(doc, next);\n\t\t},\n\t\tstate: () => encode(doc),\n\t\ttext: () => doc.text\n\t};\n};\n\n/**\n * The Automerge collaborative-text backend as a {@link TextCrdtAdapter}. Drop-in\n * for the first-party `rgaText`. The `replica` argument is accepted for contract\n * compatibility; Automerge manages actor identity internally.\n */\nexport const automergeText: TextCrdtAdapter<string> = {\n\tcreate: createAutomergeText,\n\tempty: () => encode(emptyDoc()),\n\tmerge: (a, b) => {\n\t\tconst merged =\n\t\t\tb.length > 0 ? Automerge.merge(load(a), decode(b)) : load(a);\n\n\t\treturn encode(merged);\n\t},\n\ttextOf: (state) => load(state).text\n};\n"
+  ],
+  "mappings": ";;AAYA;AAMA,IAAM,WAAW,CAAC,UAA8B;AAAA,EAC/C,IAAI,SAAS;AAAA,EACb,WAAW,QAAQ,OAAO;AAAA,IACzB,UAAU,OAAO,aAAa,IAAI;AAAA,EACnC;AAAA,EAEA,OAAO,KAAK,MAAM;AAAA;AAGnB,IAAM,aAAa,CAAC,WAA+B;AAAA,EAClD,MAAM,SAAS,KAAK,MAAM;AAAA,EAC1B,MAAM,QAAQ,IAAI,WAAW,OAAO,MAAM;AAAA,EAC1C,SAAS,QAAQ,EAAG,QAAQ,OAAO,QAAQ,SAAS,GAAG;AAAA,IACtD,MAAM,SAAS,OAAO,WAAW,KAAK;AAAA,EACvC;AAAA,EAEA,OAAO;AAAA;AAGR,IAAM,WAAW,MAAoC,eAAU,EAAE,MAAM,GAAG,CAAC;AAC3E,IAAM,SAAS,CAAC,QACf,SAAmB,eAAK,GAAG,CAAC;AAC7B,IAAM,SAAS,CAAC,UACL,eAAU,WAAW,KAAK,CAAC;AACtC,IAAM,QAAO,CAAC,UACb,MAAM,SAAS,IAAI,OAAO,KAAK,IAAI,SAAS;AAI7C,IAAM,YAAY,CACjB,KACA,SACwB;AAAA,EACxB,MAAM,UAAU,IAAI;AAAA,EACpB,IAAI,YAAY,MAAM;AAAA,IACrB,OAAO;AAAA,EACR;AAAA,EACA,IAAI,SAAS;AAAA,EACb,MAAM,YAAY,KAAK,IAAI,QAAQ,QAAQ,KAAK,MAAM;AAAA,EACtD,OAAO,SAAS,aAAa,QAAQ,YAAY,KAAK,SAAS;AAAA,IAC9D,UAAU;AAAA,EACX;AAAA,EACA,IAAI,SAAS;AAAA,EACb,OACC,SAAS,YAAY,UACrB,QAAQ,QAAQ,SAAS,IAAI,YAAY,KAAK,KAAK,SAAS,IAAI,SAC/D;AAAA,IACD,UAAU;AAAA,EACX;AAAA,EACA,MAAM,UAAU,QAAQ,SAAS,SAAS;AAAA,EAC1C,MAAM,WAAW,KAAK,MAAM,QAAQ,KAAK,SAAS,MAAM;AAAA,EAExD,OAAiB,iBAAO,KAAK,CAAC,UAAU;AAAA,IAC7B,iBAAO,OAAO,CAAC,MAAM,GAAG,QAAQ,SAAS,QAAQ;AAAA,GAC3D;AAAA;AAIK,IAAM,sBAAsB,CAClC,SACA,YACsB;AAAA,EACtB,IAAI,MAAM,YAAY,YAAY,MAAK,OAAO,IAAI,SAAS;AAAA,EAE3D,OAAO;AAAA,IACN,OAAO,CAAC,UAAU;AAAA,MACjB,IAAI,MAAM,SAAS,GAAG;AAAA,QACrB,MAAgB,gBAAM,KAAK,OAAO,KAAK,CAAC;AAAA,MACzC;AAAA;AAAA,IAED,SAAS,CAAC,SAAS;AAAA,MAClB,MAAM,UAAU,KAAK,IAAI;AAAA;AAAA,IAE1B,OAAO,MAAM,OAAO,GAAG;AAAA,IACvB,MAAM,MAAM,IAAI;AAAA,EACjB;AAAA;AAQM,IAAM,gBAAyC;AAAA,EACrD,QAAQ;AAAA,EACR,OAAO,MAAM,OAAO,SAAS,CAAC;AAAA,EAC9B,OAAO,CAAC,GAAG,MAAM;AAAA,IAChB,MAAM,SACL,EAAE,SAAS,IAAc,gBAAM,MAAK,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,MAAK,CAAC;AAAA,IAE5D,OAAO,OAAO,MAAM;AAAA;AAAA,EAErB,QAAQ,CAAC,UAAU,MAAK,KAAK,EAAE;AAChC;",
+  "debugId": "FB0D6126D29D984364756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+	"name": "@absolutejs/sync-automerge",
+	"version": "0.0.1",
+	"description": "Automerge-backed collaborative-text CRDT adapter for @absolutejs/sync",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/absolutejs/sync-adapters.git",
+		"directory": "automerge"
+	},
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"type": "module",
+	"license": "CC BY-NC 4.0",
+	"author": "Alex Kahn",
+	"publishConfig": {
+		"access": "public"
+	},
+	"keywords": [
+		"absolutejs",
+		"sync",
+		"crdt",
+		"automerge",
+		"collaborative",
+		"multiplayer"
+	],
+	"scripts": {
+		"build": "rm -rf dist && bun build src/index.ts --outdir dist --sourcemap --target=bun --external @absolutejs/sync --external @automerge/automerge && tsc --project tsconfig.build.json",
+		"test": "bun test",
+		"typecheck": "tsc --noEmit",
+		"format": "prettier --write \"./**/*.{ts,json,md}\"",
+		"release": "bun run format && bun run build && bun publish"
+	},
+	"dependencies": {
+		"@automerge/automerge": "^3.2.6"
+	},
+	"peerDependencies": {
+		"@absolutejs/sync": ">= 0.10.0"
+	},
+	"devDependencies": {
+		"@absolutejs/sync": "^0.15.0",
+		"@types/bun": "1.3.14",
+		"prettier": "3.5.3",
+		"typescript": "5.8.3"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md"
+	]
+}