@absolutejs/sync-loro 0.0.1

package/README.md

@@ -0,0 +1,51 @@
+# @absolutejs/sync-loro
+
+A [Loro](https://loro.dev)-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. Loro is a fast, Rust/wasm CRDT library;
+this adapter lets you swap it in without touching your call sites.
+
+## Install
+
+```bash
+bun add @absolutejs/sync-loro loro-crdt
+```
+
+`@absolutejs/sync` is a peer dependency. `loro-crdt` is a runtime dependency you
+install alongside.
+
+## Use
+
+```ts
+import { loroText } from '@absolutejs/sync-loro';
+// ...instead of: import { rgaText } from '@absolutejs/sync/crdt';
+
+// Server — declare the CRDT field with this backend
+engine.registerCrdt('doc', { state: loroText });
+
+// Client — same hook, just pass the backend's factory
+const doc = useCollaborativeText({
+	collection: 'doc',
+	field: 'state',
+	id: 'shared',
+	url,
+	create: (replica) => createLoroText(replica)
+});
+```
+
+The serialized state is a base64 string of a Loro snapshot — 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; Loro assigns a peer id internally.
+
+## License
+
+CC BY-NC 4.0

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * A [Loro](https://loro.dev)-backed collaborative-text CRDT for `@absolutejs/sync`,
+ * behind the same `CrdtText` / `TextCrdtAdapter` contract as the first-party
+ * `rgaText` and `@absolutejs/sync-yjs`. Loro is a fast, Rust/wasm CRDT library;
+ * swapping `rgaText` for `loroText` needs no other change at the call site.
+ *
+ * The serialized state is a **base64 string** of a Loro snapshot, so it stays
+ * JSON-safe for the sync engine's change feed and row storage. Merges are
+ * commutative/associative/idempotent.
+ */
+import type { CrdtText, TextCrdtAdapter } from '@absolutejs/sync/crdt';
+/** Create a live Loro-backed collaborative-text doc for `replica`. */
+export declare const createLoroText: (replica: string, initial?: string) => CrdtText<string>;
+/**
+ * The Loro collaborative-text backend as a {@link TextCrdtAdapter}. Drop-in for
+ * the first-party `rgaText`. The `replica` argument is accepted for contract
+ * compatibility; Loro assigns a peer id internally.
+ */
+export declare const loroText: TextCrdtAdapter<string>;

package/dist/index.js

@@ -0,0 +1,86 @@
+// @bun
+// src/index.ts
+import { LoroDoc } from "loro-crdt";
+var TEXT_KEY = "text";
+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 snapshot = (doc) => toBase64(doc.export({ mode: "snapshot" }));
+var docFrom = (state) => {
+  const doc = new LoroDoc;
+  if (state !== undefined && state.length > 0) {
+    doc.import(fromBase64(state));
+  }
+  return doc;
+};
+var reconcile = (text, next) => {
+  const current = text.toString();
+  if (current === next) {
+    return;
+  }
+  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);
+  if (removed > 0) {
+    text.delete(prefix, removed);
+  }
+  if (inserted.length > 0) {
+    text.insert(prefix, inserted);
+  }
+};
+var createLoroText = (replica, initial) => {
+  const doc = docFrom(initial);
+  const text = doc.getText(TEXT_KEY);
+  return {
+    merge: (state) => {
+      if (state.length > 0) {
+        doc.import(fromBase64(state));
+      }
+    },
+    setText: (next) => {
+      reconcile(text, next);
+      doc.commit();
+    },
+    state: () => snapshot(doc),
+    text: () => text.toString()
+  };
+};
+var loroText = {
+  create: createLoroText,
+  empty: () => snapshot(new LoroDoc),
+  merge: (a, b) => {
+    const doc = docFrom(a);
+    if (b.length > 0) {
+      doc.import(fromBase64(b));
+    }
+    return snapshot(doc);
+  },
+  textOf: (state) => docFrom(state).getText(TEXT_KEY).toString()
+};
+export {
+  loroText,
+  createLoroText
+};
+
+//# debugId=F14EF622F649D70764756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": [
+    "/**\n * A [Loro](https://loro.dev)-backed collaborative-text CRDT for `@absolutejs/sync`,\n * behind the same `CrdtText` / `TextCrdtAdapter` contract as the first-party\n * `rgaText` and `@absolutejs/sync-yjs`. Loro is a fast, Rust/wasm CRDT library;\n * swapping `rgaText` for `loroText` needs no other change at the call site.\n *\n * The serialized state is a **base64 string** of a Loro snapshot, so it stays\n * JSON-safe for the sync engine's change feed and row storage. Merges are\n * commutative/associative/idempotent.\n */\nimport type { CrdtText, TextCrdtAdapter } from '@absolutejs/sync/crdt';\nimport { LoroDoc } from 'loro-crdt';\n\nconst TEXT_KEY = 'text';\n\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 snapshot = (doc: LoroDoc): string =>\n\ttoBase64(doc.export({ mode: 'snapshot' }));\n\nconst docFrom = (state?: string): LoroDoc => {\n\tconst doc = new LoroDoc();\n\tif (state !== undefined && state.length > 0) {\n\t\tdoc.import(fromBase64(state));\n\t}\n\n\treturn doc;\n};\n\n// Reconcile `text` to `next` by editing only the changed middle.\nconst reconcile = (text: ReturnType<LoroDoc['getText']>, next: string) => {\n\tconst current = text.toString();\n\tif (current === next) {\n\t\treturn;\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\tif (removed > 0) {\n\t\ttext.delete(prefix, removed);\n\t}\n\tif (inserted.length > 0) {\n\t\ttext.insert(prefix, inserted);\n\t}\n};\n\n/** Create a live Loro-backed collaborative-text doc for `replica`. */\nexport const createLoroText = (\n\treplica: string,\n\tinitial?: string\n): CrdtText<string> => {\n\tconst doc = docFrom(initial);\n\tconst text = doc.getText(TEXT_KEY);\n\n\treturn {\n\t\tmerge: (state) => {\n\t\t\tif (state.length > 0) {\n\t\t\t\tdoc.import(fromBase64(state));\n\t\t\t}\n\t\t},\n\t\tsetText: (next) => {\n\t\t\treconcile(text, next);\n\t\t\tdoc.commit();\n\t\t},\n\t\tstate: () => snapshot(doc),\n\t\ttext: () => text.toString()\n\t};\n};\n\n/**\n * The Loro collaborative-text backend as a {@link TextCrdtAdapter}. Drop-in for\n * the first-party `rgaText`. The `replica` argument is accepted for contract\n * compatibility; Loro assigns a peer id internally.\n */\nexport const loroText: TextCrdtAdapter<string> = {\n\tcreate: createLoroText,\n\tempty: () => snapshot(new LoroDoc()),\n\tmerge: (a, b) => {\n\t\tconst doc = docFrom(a);\n\t\tif (b.length > 0) {\n\t\t\tdoc.import(fromBase64(b));\n\t\t}\n\n\t\treturn snapshot(doc);\n\t},\n\ttextOf: (state) => docFrom(state).getText(TEXT_KEY).toString()\n};\n"
+  ],
+  "mappings": ";;AAWA;AAEA,IAAM,WAAW;AAEjB,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,CAAC,QACjB,SAAS,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC,CAAC;AAE1C,IAAM,UAAU,CAAC,UAA4B;AAAA,EAC5C,MAAM,MAAM,IAAI;AAAA,EAChB,IAAI,UAAU,aAAa,MAAM,SAAS,GAAG;AAAA,IAC5C,IAAI,OAAO,WAAW,KAAK,CAAC;AAAA,EAC7B;AAAA,EAEA,OAAO;AAAA;AAIR,IAAM,YAAY,CAAC,MAAsC,SAAiB;AAAA,EACzE,MAAM,UAAU,KAAK,SAAS;AAAA,EAC9B,IAAI,YAAY,MAAM;AAAA,IACrB;AAAA,EACD;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,EACxD,IAAI,UAAU,GAAG;AAAA,IAChB,KAAK,OAAO,QAAQ,OAAO;AAAA,EAC5B;AAAA,EACA,IAAI,SAAS,SAAS,GAAG;AAAA,IACxB,KAAK,OAAO,QAAQ,QAAQ;AAAA,EAC7B;AAAA;AAIM,IAAM,iBAAiB,CAC7B,SACA,YACsB;AAAA,EACtB,MAAM,MAAM,QAAQ,OAAO;AAAA,EAC3B,MAAM,OAAO,IAAI,QAAQ,QAAQ;AAAA,EAEjC,OAAO;AAAA,IACN,OAAO,CAAC,UAAU;AAAA,MACjB,IAAI,MAAM,SAAS,GAAG;AAAA,QACrB,IAAI,OAAO,WAAW,KAAK,CAAC;AAAA,MAC7B;AAAA;AAAA,IAED,SAAS,CAAC,SAAS;AAAA,MAClB,UAAU,MAAM,IAAI;AAAA,MACpB,IAAI,OAAO;AAAA;AAAA,IAEZ,OAAO,MAAM,SAAS,GAAG;AAAA,IACzB,MAAM,MAAM,KAAK,SAAS;AAAA,EAC3B;AAAA;AAQM,IAAM,WAAoC;AAAA,EAChD,QAAQ;AAAA,EACR,OAAO,MAAM,SAAS,IAAI,OAAS;AAAA,EACnC,OAAO,CAAC,GAAG,MAAM;AAAA,IAChB,MAAM,MAAM,QAAQ,CAAC;AAAA,IACrB,IAAI,EAAE,SAAS,GAAG;AAAA,MACjB,IAAI,OAAO,WAAW,CAAC,CAAC;AAAA,IACzB;AAAA,IAEA,OAAO,SAAS,GAAG;AAAA;AAAA,EAEpB,QAAQ,CAAC,UAAU,QAAQ,KAAK,EAAE,QAAQ,QAAQ,EAAE,SAAS;AAC9D;",
+  "debugId": "F14EF622F649D70764756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+	"name": "@absolutejs/sync-loro",
+	"version": "0.0.1",
+	"description": "Loro-backed collaborative-text CRDT adapter for @absolutejs/sync",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/absolutejs/sync-adapters.git",
+		"directory": "loro"
+	},
+	"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",
+		"loro",
+		"collaborative",
+		"multiplayer"
+	],
+	"scripts": {
+		"build": "rm -rf dist && bun build src/index.ts --outdir dist --sourcemap --target=bun --external @absolutejs/sync --external loro-crdt && 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": {
+		"loro-crdt": "^1.12.2"
+	},
+	"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"
+	]
+}