zerodrift 1.0.0

package/dist/schema/zod.js

@@ -0,0 +1,101 @@
+import { fields, entity, rebuildFieldBuilder } from "./builders";
+const PRIMITIVE_KIND = new Map([
+    ["string", fields.string],
+    ["number", fields.number],
+    ["int", fields.number],
+    ["boolean", fields.boolean],
+    ["date", fields.date],
+]);
+/**
+ * Convert any Zod schema into the equivalent schema-first `FieldBuilder`.
+ * Handles the common nullable / optional / default modifiers; anything more
+ * structured (objects, arrays, unions, enums) collapses to `s.json<T>()` so
+ * the runtime stores the raw value and the TS type still flows from Zod.
+ *
+ * Zod is an optional peer dependency — calling this function requires the
+ * caller to have installed `zod`.
+ */
+export function fromZod(zSchema) {
+    let current = zSchema;
+    let nullable = false;
+    let optional = false;
+    let defaultValue = undefined;
+    while (true) {
+        const { type, innerType, defaultValue: inner } = current._zod.def;
+        if (type === "nullable" && innerType != null) {
+            nullable = true;
+            current = innerType;
+            continue;
+        }
+        if (type === "optional" && innerType != null) {
+            optional = true;
+            current = innerType;
+            continue;
+        }
+        if (type === "default" && innerType != null) {
+            defaultValue = inner;
+            current = innerType;
+            continue;
+        }
+        break;
+    }
+    const factory = PRIMITIVE_KIND.get(current._zod.def.type) ?? fields.json;
+    let builder = factory();
+    if (defaultValue !== undefined) {
+        builder = builder.default(defaultValue);
+    }
+    if (nullable) {
+        builder = builder.nullable();
+    }
+    if (optional) {
+        builder = rebuildFieldBuilder({
+            ...builder.meta,
+            optional: true,
+        });
+    }
+    return builder;
+}
+/**
+ * Convert a `z.object({ ... })` into an `EntityDef`. Each key on the Zod
+ * object becomes a field via `fromZod`, then `opts.fields[key]` (if
+ * present) is applied — either chained onto the auto-derived builder, or
+ * used as a full replacement.
+ *
+ * The override map is captured via a `const`-modified generic so per-field
+ * metadata (`.indexed()`, refId target, …) flows into the returned
+ * `EntityDef` — `IndexedFieldKeys`, `getByIndex`, `peekByIndex`, and the
+ * typed React hooks all see Zod-built entities the same way they see
+ * hand-written ones.
+ *
+ * `F` is inferred from the provided `fields` map while an intersected
+ * override-map type supplies allowed keys and key-specific contextual typing
+ * for the `(auto) => ...` parameter. When no `fields` map is provided, `F`
+ * defaults to an empty record so untouched Zod fields stay on the auto-derived
+ * `FieldBuilder<z.infer<...>>` path.
+ * `EntityFromZodOpts<Z>` keeps the strict union for users who pre-type
+ * their opts variables.
+ *
+ * Only single-record entities are produced; relations still belong in the
+ * schema's `links` block. Treat the Zod object as the source of field
+ * shape and validation; `link(...)` remains the source of truth for the
+ * graph.
+ */
+export function entityFromZod(zSchema, opts) {
+    const overrides = (opts.fields ?? {});
+    const fieldsRecord = {};
+    for (const [key, fieldSchema] of Object.entries(zSchema.shape)) {
+        const auto = key === "id" ? fields.id() : fromZod(fieldSchema);
+        const override = overrides[key];
+        fieldsRecord[key] =
+            typeof override === "function"
+                ? override(auto)
+                : (override ?? auto);
+    }
+    return entity({
+        loadStrategy: opts.loadStrategy,
+        usedForPartialIndexes: opts.usedForPartialIndexes,
+        name: opts.name,
+        version: opts.version,
+        fields: fieldsRecord,
+    });
+}

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "zerodrift",
+  "version": "1.0.0",
+  "private": false,
+  "description": "A TypeScript local-first sync engine: synchronous in-memory reads, optimistic writes, realtime SSE sync, offline IndexedDB persistence. Runs in the browser and in Node.",
+  "license": "MIT",
+  "author": "selasijean <selasijean@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/selasijean/zerodrift.git"
+  },
+  "workspaces": [
+    "examples/webapp"
+  ],
+  "homepage": "https://github.com/selasijean/zerodrift#readme",
+  "bugs": "https://github.com/selasijean/zerodrift/issues",
+  "keywords": [
+    "local-first",
+    "sync",
+    "offline",
+    "optimistic",
+    "indexeddb",
+    "sse",
+    "mobx",
+    "realtime",
+    "crdt-alternative"
+  ],
+  "type": "module",
+  "main": "./dist/core/index.js",
+  "module": "./dist/core/index.js",
+  "types": "./dist/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/core/index.d.ts",
+      "default": "./dist/core/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema/index.d.ts",
+      "default": "./dist/schema/index.js"
+    },
+    "./internal": {
+      "types": "./dist/core/internal.d.ts",
+      "default": "./dist/core/internal.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "prepack": "npm run clean && npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint \"src/**/*.{ts,tsx}\" \"__tests__/**/*.ts\""
+  },
+  "dependencies": {
+    "mobx": "^6.15.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "zod": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@swc/core": "^1.15.24",
+    "@types/react": "^19.2.14",
+    "@vitest/coverage-v8": "^4.1.4",
+    "eslint": "^10.2.0",
+    "eslint-config-prettier": "^10.1.8",
+    "fake-indexeddb": "^6.2.5",
+    "jsdom": "^29.0.2",
+    "prettier": "^3.8.3",
+    "react": "^19.2.5",
+    "typescript": "^6.0.2",
+    "typescript-eslint": "^8.58.2",
+    "unplugin-swc": "^1.5.9",
+    "vitest": "^4.1.4",
+    "zod": "^4.4.3"
+  }
+}