@korajs/sync 0.1.0 → 0.1.3

package/README.md

@@ -0,0 +1,67 @@
+# @korajs/sync
+
+Sync protocol and transports for Kora.js. Handles version vector delta sync, causal ordering, Protobuf wire format, and automatic reconnection with operation queuing.
+
+> Most developers don't install this directly. Use [`korajs`](https://www.npmjs.com/package/korajs) instead.
+
+## Install
+
+```bash
+pnpm add @korajs/sync
+```
+
+## Usage
+
+### WebSocket Transport
+
+```typescript
+import { SyncEngine, WebSocketTransport } from '@korajs/sync'
+
+const transport = new WebSocketTransport({
+  url: 'wss://my-server.com/kora',
+  auth: async () => ({ token: await getAuthToken() }),
+})
+
+const sync = new SyncEngine({
+  transport,
+  mergeEngine,
+  operationLog,
+})
+
+sync.start()
+```
+
+### HTTP Transport
+
+```typescript
+import { HttpTransport } from '@korajs/sync'
+
+const transport = new HttpTransport({
+  url: 'https://my-server.com/kora/sync',
+  pollInterval: 5000,
+})
+```
+
+### Sync Events
+
+```typescript
+sync.on('connected', () => console.log('Connected'))
+sync.on('disconnected', (reason) => console.log('Disconnected:', reason))
+sync.on('sent', (ops) => console.log('Sent', ops.length, 'operations'))
+sync.on('received', (ops) => console.log('Received', ops.length, 'operations'))
+```
+
+## Protocol
+
+1. **Handshake** -- exchange version vectors to determine what each side is missing
+2. **Delta sync** -- send only the operations the other side doesn't have
+3. **Real-time streaming** -- bidirectional operation flow after initial sync
+4. **Resumable** -- reconnects pick up from the last acknowledged sequence number
+
+Operations are always sent in causal order. The protocol is idempotent -- duplicate operations are detected via content-addressing and safely ignored.
+
+## License
+
+MIT
+
+See the [full documentation](https://github.com/ehoneahobed/kora) for guides, API reference, and examples.

package/dist/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -102,7 +112,8 @@ function isErrorMessage(value) {
 
 // src/protocol/serializer.ts
 var import_core = require("@korajs/core");
-var import_minimal = require("protobufjs/minimal");
+var import_minimal = __toESM(require("protobufjs/minimal"), 1);
+var { Reader, Writer } = import_minimal.default;
 function versionVectorToWire(vector) {
   const wire = {};
   for (const [nodeId, seq] of vector) {
@@ -385,7 +396,7 @@ function toBytes(data) {
   throw new import_core.SyncError("Unsupported sync payload type", { receivedType: typeof data });
 }
 function encodeEnvelope(envelope) {
-  const writer = import_minimal.Writer.create();
+  const writer = Writer.create();
   if (envelope.type.length > 0) writer.uint32(10).string(envelope.type);
   if (envelope.messageId.length > 0) writer.uint32(18).string(envelope.messageId);
   if (envelope.nodeId && envelope.nodeId.length > 0) writer.uint32(26).string(envelope.nodeId);
@@ -424,7 +435,7 @@ function encodeEnvelope(envelope) {
   return writer.finish();
 }
 function decodeEnvelope(bytes) {
-  const reader = import_minimal.Reader.create(bytes);
+  const reader = Reader.create(bytes);
   const envelope = { type: "error", messageId: "" };
   while (reader.pos < reader.len) {
     const tag = reader.uint32();