@jcbuisson/express-x-drizzle 1.0.7 → 1.0.8

package/CLAUDE.md

@@ -0,0 +1,29 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Package
+
+`@jcbuisson/express-x-drizzle` is an ESM-only NPM package (no build step). The single source file is `src/drizzle-plugins.mjs`; the package root re-exports it as `drizzle-plugins.mjs` via the `"main"` field in `package.json`.
+
+No test runner or linter is configured. There are no build, test, or lint commands.
+
+To publish: `npm publish` (package is public, not private).
+
+## Architecture
+
+The library exports one function: `drizzleOfflinePlugin(app, db, metadata, models)`.
+
+**Parameters:**
+- `app` — an `express-x` application instance (from `@jcbuisson/express-x`)
+- `db` — a Drizzle ORM database instance
+- `metadata` — a Drizzle table schema used to store per-record timestamps (`uid`, `created_at`, `updated_at`, `deleted_at`)
+- `models` — array of Drizzle table schemas to expose as services
+
+**What it does:**
+
+1. **Per-model services** — For each table in `models`, registers an `express-x` service named after the table. Each service exposes: `findUnique`, `findMany`, `createWithMeta`, `updateWithMeta`, `deleteWithMeta`. All mutation methods write to both the model table and the `metadata` table inside a transaction, keeping timestamps in sync.
+
+2. **`sync` service** — Implements an offline-first reconciliation algorithm. The client sends its local metadata dictionary (`{ uid → { created_at, updated_at, deleted_at } }`) plus a `cutoffDate`. The server computes set intersections between client UIDs and database UIDs, then determines add/update/delete operations for both sides. A `Mutex` (from `express-x`) serializes concurrent sync calls globally. The return value tells the client which records to add, update, or delete locally, and which UIDs the client should push to the database with full data.
+
+**Key invariant:** The sync algorithm compares `updated_at` (falling back to `created_at`) timestamps to decide which side wins a conflict — the most recently updated side wins. Records marked `deleted_at` on the client trigger a soft-delete propagation to the database.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jcbuisson/express-x-drizzle",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Drizzle ORM plugins for express-x framework",
   "main": "src/drizzle-plugins.mjs",
   "type": "module",
@@ -24,10 +24,9 @@
   "license": "MIT",
   "bugs": "",
   "keywords": [],
-  "scripts": {
-  },
+  "scripts": {},
   "dependencies": {
-    "@jcbuisson/express-x": "^3.0.4",
+    "@jcbuisson/express-x": "^3.0.5",
     "@jcbuisson/express-x-client": "^3.0.5",
     "@vueuse/core": "^14.3.0",
     "dexie": "^4.4.2",

package/src/drizzle-plugins.mjs

@@ -149,6 +149,7 @@ export function drizzleOfflinePlugin(app, db, metadata, models) {
             }
          } catch(err) {
             console.log('*** err sync', err)
+            throw err
          } finally {
             syncMutexes.get(mutexKey).release()
          }

package/.claude/settings.local.json

@@ -1,14 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npm test *)",
-      "Bash(node -e \"require\\('tsx'\\)\")",
-      "Bash(npm install *)",
-      "Bash(node --test test/sync.test.mjs)",
-      "Bash(tee /tmp/test-output.txt)",
-      "Bash(tee /tmp/test-output2.txt)",
-      "Bash(node --help)",
-      "Bash(node --import tsx/esm --import /tmp/preload.mjs --test --test-force-exit test/round-trip.test.mjs)"
-    ]
-  }
-}