AbsoluteJS

@absolutejs/sync-loro

@absolutejs/sync-lorov0.0.5betaData & Sync

Loro-backed collaborative-text CRDT adapter for @absolutejs/sync

#Installation

BASH
bun add @absolutejs/sync-loro

#Capabilities

Overview

A Loro-backed collaborative-text CRDT for @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.

Use

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 from @absolutejs/sync/crdt: create, merge, empty, textOf. The replica argument is accepted for contract compatibility; Loro assigns a peer id internally.

Outcomes

What you can build

Build on the supported package contract

Use @absolutejs/sync-loro through its supported public entry points.

Hardening checklist

Production guidance

Make every external boundary explicitPin the deployed @absolutejs/sync-loro version, replace example or memory-backed dependencies with durable implementations, bound external calls, protect credentials, and emit enough evidence to retry or recover safely.

Follow in order

Troubleshooting path

1
Trace from the first failed boundary
Reproduce the smallest canonical @absolutejs/sync-loro example, confirm the supported entry point and version in the API explorer, then inspect the first boundary that did not produce its documented result.

#Use

Partial snippet

Working example for 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)
});

#Public entry points

Supported entry points declared by this package manifest.

Package entry point declared in package.json.

@absolutejs/sync-loro@absolutejs/sync-loro/manifest@absolutejs/sync-loro/manifest.json

#Package commands

Scripts declared by this package manifest.

bun run buildrm -rf dist && bun build src/index.ts src/manifest.ts --outdir dist --sourcemap --target=bun --external @absolutejs/sync --external loro-crdt && tsc --project tsconfig.build.json && absolute-manifest emit
bun run formatprettier --write "./**/*.{ts,json,md}"
bun run testbun test
bun run typechecktsc --noEmit