@trestleinc/replicate 0.1.0

package/dist/server.js

@@ -0,0 +1,96 @@
+import { defineTable } from "convex/server";
+import { v } from "convex/values";
+function cleanDocument(doc) {
+    return Object.fromEntries(Object.entries(doc).filter(([_, value])=>null != value));
+}
+async function insertDocumentHelper(ctx, components, tableName, args) {
+    const timestamp = Date.now();
+    await ctx.runMutation(components.replicate.public.insertDocument, {
+        collectionName: tableName,
+        documentId: args.id,
+        crdtBytes: args.crdtBytes,
+        version: args.version
+    });
+    const db = ctx.db;
+    const cleanDoc = cleanDocument(args.materializedDoc);
+    await db.insert(tableName, {
+        id: args.id,
+        ...cleanDoc,
+        version: args.version,
+        timestamp
+    });
+    return {
+        success: true,
+        metadata: {
+            documentId: args.id,
+            timestamp,
+            version: args.version,
+            collectionName: tableName
+        }
+    };
+}
+async function updateDocumentHelper(ctx, components, tableName, args) {
+    const timestamp = Date.now();
+    await ctx.runMutation(components.replicate.public.updateDocument, {
+        collectionName: tableName,
+        documentId: args.id,
+        crdtBytes: args.crdtBytes,
+        version: args.version
+    });
+    const db = ctx.db;
+    const existing = await db.query(tableName).withIndex('by_user_id', (q)=>q.eq('id', args.id)).first();
+    if (!existing) throw new Error(`Document ${args.id} not found in table ${tableName}`);
+    const cleanDoc = cleanDocument(args.materializedDoc);
+    await db.patch(existing._id, {
+        ...cleanDoc,
+        version: args.version,
+        timestamp
+    });
+    return {
+        success: true,
+        metadata: {
+            documentId: args.id,
+            timestamp,
+            version: args.version,
+            collectionName: tableName
+        }
+    };
+}
+async function deleteDocumentHelper(ctx, components, tableName, args) {
+    const timestamp = Date.now();
+    await ctx.runMutation(components.replicate.public.deleteDocument, {
+        collectionName: tableName,
+        documentId: args.id,
+        crdtBytes: args.crdtBytes,
+        version: args.version
+    });
+    const db = ctx.db;
+    const existing = await db.query(tableName).withIndex('by_user_id', (q)=>q.eq('id', args.id)).first();
+    if (existing) await db.delete(existing._id);
+    return {
+        success: true,
+        metadata: {
+            documentId: args.id,
+            timestamp,
+            version: args.version,
+            collectionName: tableName
+        }
+    };
+}
+async function streamHelper(ctx, components, tableName, args) {
+    return ctx.runQuery(components.replicate.public.stream, {
+        collectionName: tableName,
+        checkpoint: args.checkpoint,
+        limit: args.limit
+    });
+}
+function replicatedTable(userFields, applyIndexes) {
+    const tableWithMetadata = defineTable({
+        ...userFields,
+        version: v.number(),
+        timestamp: v.number()
+    });
+    if (applyIndexes) return applyIndexes(tableWithMetadata);
+    return tableWithMetadata;
+}
+export { deleteDocumentHelper, insertDocumentHelper, replicatedTable, streamHelper, updateDocumentHelper };

package/dist/ssr.js

@@ -0,0 +1,19 @@
+async function loadCollection(httpClient, config) {
+    const result = await httpClient.query(config.api.stream, {
+        collectionName: config.collection,
+        checkpoint: {
+            lastModified: 0
+        },
+        limit: config.limit ?? 100
+    });
+    const items = [];
+    for (const change of result.changes){
+        const item = {
+            id: change.documentId,
+            ...change.document
+        };
+        items.push(item);
+    }
+    return items;
+}
+export { loadCollection };

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "@trestleinc/replicate",
+  "version": "0.1.0",
+  "description": "Offline-first data replication with Yjs CRDTs and Convex",
+  "repository": "github:trestleinc/convex-replicate",
+  "homepage": "https://github.com/trestleinc/convex-replicate#readme",
+  "bugs": {
+    "url": "https://github.com/trestleinc/convex-replicate/issues"
+  },
+  "license": "Apache-2.0",
+  "keywords": [
+    "convex",
+    "replicate",
+    "crdt",
+    "yjs",
+    "offline-first",
+    "tanstack"
+  ],
+  "type": "module",
+  "private": false,
+  "resolutions": {
+    "convex": "1.28.2"
+  },
+  "overrides": {
+    "convex": "1.28.2"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    "./client": {
+      "import": {
+        "@convex-dev/component-source": "./src/client/index.ts",
+        "types": "./dist/client/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./server": {
+      "import": {
+        "types": "./dist/server/index.d.ts",
+        "default": "./dist/server.js"
+      }
+    },
+    "./ssr": {
+      "import": {
+        "types": "./dist/server/ssr.d.ts",
+        "default": "./dist/ssr.js"
+      }
+    },
+    "./convex.config": {
+      "import": {
+        "@convex-dev/component-source": "./src/component/convex.config.ts",
+        "types": "./dist/component/convex.config.d.ts",
+        "default": "./dist/component/convex.config.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "yjs": "13.6.27",
+    "@tanstack/offline-transactions": "0.1.3",
+    "@logtape/logtape": "1.1.2"
+  },
+  "peerDependencies": {
+    "convex": "1.28.2",
+    "@tanstack/db": "0.4.20"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.4",
+    "@rslib/core": "0.17.1",
+    "@semantic-release/changelog": "6.0.3",
+    "@semantic-release/exec": "7.1.0",
+    "@semantic-release/git": "10.0.1",
+    "@semantic-release/github": "12.0.1",
+    "@tanstack/db": "0.4.20",
+    "@types/node": "24.10.0",
+    "convex": "1.28.2",
+    "semantic-release": "25.0.1",
+    "typescript": "5.9.3",
+    "zod": "4.1.12"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/client/index.d.ts",
+  "module": "./dist/index.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rslib build",
+    "dev": "rslib build --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "dev:example": "cd examples/tanstack-start && pnpm run dev",
+    "build:example": "cd examples/tanstack-start && pnpm run build",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint --write .",
+    "format": "biome format --write .",
+    "format:check": "biome format .",
+    "check": "biome check .",
+    "check:fix": "biome check --write .",
+    "version-packages": "node scripts/version-packages.js",
+    "publish:npm": "pnpm run build && pnpm run check:fix && pnpm publish --access public",
+    "prepublish": "pnpm run build && pnpm run check:fix"
+  }
+}