@rippledb/client-controllers 0.1.0

package/README.md

@@ -0,0 +1,51 @@
+# @rippledb/client-controllers
+
+Abstract CRUD controllers with batch loading for RippleDB.
+
+📚 **Documentation:** [rippledb.dev/docs/adapters/controllers](https://rippledb.dev/docs/adapters/controllers)
+
+## Installation
+
+```bash
+npm install @rippledb/client-controllers
+```
+
+## Usage
+
+```typescript
+import { createEntityController } from '@rippledb/client-controllers';
+import { MemoryStore } from '@rippledb/store-memory';
+
+const store = new MemoryStore<MySchema>();
+
+// Create a controller for an entity type
+const todoController = createEntityController({
+  store,
+  entity: 'todos',
+  stream: 'user-123',
+});
+
+// CRUD operations with automatic batch loading
+const todo = await todoController.create({ title: 'Buy milk' });
+const fetched = await todoController.read(todo.id);
+const updated = await todoController.update(todo.id, { done: true });
+await todoController.delete(todo.id);
+```
+
+## Features
+
+- **Batch loading**: Multiple `read()` calls in the same tick are automatically batched
+- **CRUD operations**: Simple, type-safe create/read/update/delete API
+- **Framework agnostic**: Works with any UI framework or backend
+- **Store abstraction**: Works with any `Store` implementation
+
+## Relationship to bind-tanstack-query
+
+- **Controllers**: Handle reads/writes and batch loading (data access layer)
+- **bind-tanstack-query**: Handles cache invalidation (UI reactivity layer)
+
+Use controllers for CRUD operations, and `bind-tanstack-query` for automatic cache invalidation.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,113 @@
+import type { Store } from '@rippledb/client';
+import type { RippleSchema, HlcState, EntityName } from '@rippledb/core';
+/**
+ * Batch loader interface for efficient bulk reads.
+ * Collects keys during a tick and executes them as a single bulk query.
+ */
+export interface BatchLoader<K, V> {
+    /**
+     * Load a single key. Keys are collected per tick and batched.
+     */
+    load(key: K): Promise<V | null>;
+    /**
+     * Load multiple keys. Always executes immediately (no batching).
+     */
+    loadMany(keys: K[]): Promise<Map<K, V>>;
+}
+export type BatchLoaderFlushStrategy = 'auto' | 'microtask' | 'raf';
+export type CreateBatchLoaderOptions = {
+    /**
+     * How to schedule the batch flush.
+     *
+     * - `microtask`: flush at end of current JS turn (lowest latency, smaller batch window)
+     * - `raf`: flush on next animation frame (bigger batch window, adds up to ~1 frame latency)
+     * - `auto`: `raf` when available, otherwise `microtask`
+     *
+     * @default 'auto'
+     */
+    flush?: BatchLoaderFlushStrategy;
+};
+/**
+ * Creates a batch loader for a specific entity in a Store.
+ *
+ * The batch loader collects `load()` calls during a single tick/RAF,
+ * deduplicates keys, and executes them as a bulk query using `store.getRows`.
+ *
+ * @param store - The Store instance
+ * @param entity - The entity name to load from
+ * @returns A BatchLoader instance
+ */
+export declare function createBatchLoader<S extends RippleSchema = RippleSchema, E extends EntityName<S> = EntityName<S>>(store: Store<S>, entity: E, options?: CreateBatchLoaderOptions): BatchLoader<string, S[E]>;
+/**
+ * Entity controller interface for CRUD operations with batch loading.
+ */
+export interface EntityController<S extends RippleSchema = RippleSchema, E extends EntityName<S> = EntityName<S>, ListQuery = unknown> {
+    /**
+     * Create a new entity. If patch contains an `id` field, it will be used.
+     * Otherwise, a UUID will be generated.
+     */
+    create(patch: Partial<S[E]>): Promise<S[E]>;
+    /**
+     * Read a single entity by ID. Uses batch loading for efficiency.
+     */
+    read(id: string): Promise<S[E] | null>;
+    /**
+     * Read multiple entities by IDs. Always executes immediately (no batching).
+     */
+    readMany(ids: string[]): Promise<Map<string, S[E]>>;
+    /**
+     * Update an entity by ID with a partial patch.
+     */
+    update(id: string, patch: Partial<S[E]>): Promise<S[E]>;
+    /**
+     * Delete an entity by ID.
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * List entities using a store-specific query.
+     */
+    list(query: ListQuery): Promise<S[E][]>;
+}
+export type CreateEntityControllerOptions<S extends RippleSchema = RippleSchema, E extends EntityName<S> = EntityName<S>, ListQuery = unknown> = {
+    /**
+     * The Store instance to operate on.
+     */
+    store: Store<S, ListQuery>;
+    /**
+     * The entity name this controller manages.
+     */
+    entity: E;
+    /**
+     * The stream ID for all changes created by this controller.
+     */
+    stream: string;
+    /**
+     * Optional HLC state. If not provided, a new one will be created.
+     */
+    hlcState?: HlcState;
+    /**
+     * Optional function to generate entity IDs. Defaults to crypto.randomUUID().
+     */
+    generateId?: () => string;
+    /**
+     * Optional batch loader scheduling configuration.
+     */
+    batch?: CreateBatchLoaderOptions;
+};
+/**
+ * Creates an entity controller for CRUD operations with automatic batch loading.
+ *
+ * @example
+ * ```ts
+ * const todoController = createEntityController({
+ *   store,
+ *   entity: 'todos',
+ *   stream: 'user-123',
+ * });
+ *
+ * const todo = await todoController.create({ title: 'Buy milk' });
+ * const fetched = await todoController.read(todo.id);
+ * ```
+ */
+export declare function createEntityController<S extends RippleSchema = RippleSchema, E extends EntityName<S> = EntityName<S>, ListQuery = unknown>(options: CreateEntityControllerOptions<S, E, ListQuery>): EntityController<S, E, ListQuery>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,135 @@
+// src/index.ts
+import { makeUpsert, makeDelete, tickHlc, createHlcState } from "@rippledb/core";
+function createBatchLoader(store, entity, options = {}) {
+  const pending = /* @__PURE__ */ new Map();
+  let scheduled = false;
+  const flush = async () => {
+    scheduled = false;
+    if (pending.size === 0) return;
+    const keys = Array.from(pending.keys());
+    const requests = /* @__PURE__ */ new Map();
+    for (const [key, reqs] of pending.entries()) {
+      requests.set(key, reqs);
+    }
+    pending.clear();
+    try {
+      const uniqueKeys = Array.from(new Set(keys));
+      const results = await store.getRows(entity, uniqueKeys);
+      for (const [key, reqs] of requests.entries()) {
+        const value = results.get(key) ?? null;
+        for (const req of reqs) {
+          req.resolve(value);
+        }
+      }
+    } catch (error) {
+      for (const reqs of requests.values()) {
+        for (const req of reqs) {
+          req.reject(error);
+        }
+      }
+    }
+  };
+  const flushStrategy = options.flush ?? "auto";
+  const scheduleFlush = () => {
+    if (scheduled) return;
+    scheduled = true;
+    const raf = globalThis.requestAnimationFrame;
+    if (typeof raf === "function" && (flushStrategy === "raf" || flushStrategy === "auto")) {
+      raf(() => {
+        void flush();
+      });
+      return;
+    }
+    queueMicrotask(() => {
+      void flush();
+    });
+  };
+  return {
+    load(key) {
+      return new Promise((resolve, reject) => {
+        const reqs = pending.get(key) ?? [];
+        reqs.push({ resolve, reject });
+        pending.set(key, reqs);
+        scheduleFlush();
+      });
+    },
+    async loadMany(keys) {
+      const uniqueKeys = Array.from(new Set(keys));
+      return await store.getRows(entity, uniqueKeys);
+    }
+  };
+}
+function createEntityController(options) {
+  const {
+    store,
+    entity,
+    stream,
+    hlcState = createHlcState("controller"),
+    generateId = () => crypto.randomUUID(),
+    batch
+  } = options;
+  const batchLoader = createBatchLoader(store, entity, batch);
+  const getHlc = () => tickHlc(hlcState, Date.now());
+  return {
+    async create(patch) {
+      const id = patch.id ?? generateId();
+      const hlc = getHlc();
+      await store.applyChanges([
+        makeUpsert({
+          stream,
+          entity,
+          entityId: id,
+          patch: { ...patch, id },
+          hlc
+        })
+      ]);
+      const created = await batchLoader.load(id);
+      if (!created) {
+        throw new Error(`Failed to read created entity ${entity}:${id}`);
+      }
+      return created;
+    },
+    read(id) {
+      return batchLoader.load(id);
+    },
+    readMany(ids) {
+      return batchLoader.loadMany(ids);
+    },
+    async update(id, patch) {
+      const hlc = getHlc();
+      await store.applyChanges([
+        makeUpsert({
+          stream,
+          entity,
+          entityId: id,
+          patch,
+          hlc
+        })
+      ]);
+      const updated = await batchLoader.load(id);
+      if (!updated) {
+        throw new Error(`Failed to read updated entity ${entity}:${id}`);
+      }
+      return updated;
+    },
+    async delete(id) {
+      const hlc = getHlc();
+      await store.applyChanges([
+        makeDelete({
+          stream,
+          entity,
+          entityId: id,
+          hlc
+        })
+      ]);
+    },
+    async list(query) {
+      return await store.listRows(query);
+    }
+  };
+}
+export {
+  createBatchLoader,
+  createEntityController
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Store } from '@rippledb/client';\nimport type { RippleSchema, HlcState, EntityName } from '@rippledb/core';\nimport { makeUpsert, makeDelete, tickHlc, createHlcState } from '@rippledb/core';\n\n/**\n * Batch loader interface for efficient bulk reads.\n * Collects keys during a tick and executes them as a single bulk query.\n */\nexport interface BatchLoader<K, V> {\n  /**\n   * Load a single key. Keys are collected per tick and batched.\n   */\n  load(key: K): Promise<V | null>;\n\n  /**\n   * Load multiple keys. Always executes immediately (no batching).\n   */\n  loadMany(keys: K[]): Promise<Map<K, V>>;\n}\n\nexport type BatchLoaderFlushStrategy = 'auto' | 'microtask' | 'raf';\n\nexport type CreateBatchLoaderOptions = {\n  /**\n   * How to schedule the batch flush.\n   *\n   * - `microtask`: flush at end of current JS turn (lowest latency, smaller batch window)\n   * - `raf`: flush on next animation frame (bigger batch window, adds up to ~1 frame latency)\n   * - `auto`: `raf` when available, otherwise `microtask`\n   *\n   * @default 'auto'\n   */\n  flush?: BatchLoaderFlushStrategy;\n};\n\ntype PendingRequest<V> = {\n  resolve: (value: V | null) => void;\n  reject: (error: unknown) => void;\n};\n\n/**\n * Creates a batch loader for a specific entity in a Store.\n *\n * The batch loader collects `load()` calls during a single tick/RAF,\n * deduplicates keys, and executes them as a bulk query using `store.getRows`.\n *\n * @param store - The Store instance\n * @param entity - The entity name to load from\n * @returns A BatchLoader instance\n */\nexport function createBatchLoader<\n  S extends RippleSchema = RippleSchema,\n  E extends EntityName<S> = EntityName<S>,\n>(store: Store<S>, entity: E, options: CreateBatchLoaderOptions = {}): BatchLoader<string, S[E]> {\n  const pending = new Map<string, PendingRequest<S[E]>[]>();\n  let scheduled = false;\n\n  const flush = async () => {\n    scheduled = false;\n\n    if (pending.size === 0) return;\n\n    const keys = Array.from(pending.keys());\n    const requests = new Map<string, PendingRequest<S[E]>[]>();\n\n    // Move pending requests to local map and clear\n    for (const [key, reqs] of pending.entries()) {\n      requests.set(key, reqs);\n    }\n    pending.clear();\n\n    try {\n      const uniqueKeys = Array.from(new Set(keys));\n      const results = await store.getRows(entity, uniqueKeys);\n\n      // Resolve all pending requests\n      for (const [key, reqs] of requests.entries()) {\n        const value = results.get(key) ?? null;\n        for (const req of reqs) {\n          req.resolve(value);\n        }\n      }\n    } catch (error) {\n      // Reject all pending requests on error\n      for (const reqs of requests.values()) {\n        for (const req of reqs) {\n          req.reject(error);\n        }\n      }\n    }\n  };\n\n  const flushStrategy: BatchLoaderFlushStrategy = options.flush ?? 'auto';\n\n  const scheduleFlush = () => {\n    if (scheduled) return;\n    scheduled = true;\n\n    const raf = (globalThis as unknown as { requestAnimationFrame?: (cb: () => void) => number })\n      .requestAnimationFrame;\n\n    if (typeof raf === 'function' && (flushStrategy === 'raf' || flushStrategy === 'auto')) {\n      raf(() => {\n        void flush();\n      });\n      return;\n    }\n\n    // Default: batch within the same tick\n    queueMicrotask(() => {\n      void flush();\n    });\n  };\n\n  return {\n    load(key: string): Promise<S[E] | null> {\n      return new Promise((resolve, reject) => {\n        const reqs = pending.get(key) ?? [];\n        reqs.push({ resolve, reject });\n        pending.set(key, reqs);\n        scheduleFlush();\n      });\n    },\n\n    async loadMany(keys: string[]): Promise<Map<string, S[E]>> {\n      // Intentionally NOT batched:\n      // - `load()` is for scattered reads and benefits from a tick/RAF batching window.\n      // - `loadMany()` is the \"I already have the full ID set\" escape hatch and should\n      //   issue exactly one bulk `getRows()` immediately (no extra scheduling latency).\n      //\n      // Note: If callers mix `load()` + `loadMany()` within the same frame, this may\n      // cause two bulk reads (one for the flush + one for loadMany). We can add an\n      // explicit opt-in like `loadMany(ids, { coalesce: true })` later if we\n      // see real call-sites where this matters.\n\t  // I see two options:\n\t  // 1. loadMany separates each key into a separate function call to move them into the schedule.\n\t  // 2. loadMany lets currently scheduled keys piggy back on its load call.\n      const uniqueKeys = Array.from(new Set(keys));\n      return await store.getRows(entity, uniqueKeys);\n    },\n  };\n}\n\n/**\n * Entity controller interface for CRUD operations with batch loading.\n */\nexport interface EntityController<\n  S extends RippleSchema = RippleSchema,\n  E extends EntityName<S> = EntityName<S>,\n  ListQuery = unknown,\n> {\n  /**\n   * Create a new entity. If patch contains an `id` field, it will be used.\n   * Otherwise, a UUID will be generated.\n   */\n  create(patch: Partial<S[E]>): Promise<S[E]>;\n\n  /**\n   * Read a single entity by ID. Uses batch loading for efficiency.\n   */\n  read(id: string): Promise<S[E] | null>;\n\n  /**\n   * Read multiple entities by IDs. Always executes immediately (no batching).\n   */\n  readMany(ids: string[]): Promise<Map<string, S[E]>>;\n\n  /**\n   * Update an entity by ID with a partial patch.\n   */\n  update(id: string, patch: Partial<S[E]>): Promise<S[E]>;\n\n  /**\n   * Delete an entity by ID.\n   */\n  delete(id: string): Promise<void>;\n\n  /**\n   * List entities using a store-specific query.\n   */\n  list(query: ListQuery): Promise<S[E][]>;\n}\n\nexport type CreateEntityControllerOptions<\n  S extends RippleSchema = RippleSchema,\n  E extends EntityName<S> = EntityName<S>,\n  ListQuery = unknown,\n> = {\n  /**\n   * The Store instance to operate on.\n   */\n  store: Store<S, ListQuery>;\n\n  /**\n   * The entity name this controller manages.\n   */\n  entity: E;\n\n  /**\n   * The stream ID for all changes created by this controller.\n   */\n  stream: string;\n\n  /**\n   * Optional HLC state. If not provided, a new one will be created.\n   */\n  hlcState?: HlcState;\n\n  /**\n   * Optional function to generate entity IDs. Defaults to crypto.randomUUID().\n   */\n  generateId?: () => string;\n\n  /**\n   * Optional batch loader scheduling configuration.\n   */\n  batch?: CreateBatchLoaderOptions;\n};\n\n/**\n * Creates an entity controller for CRUD operations with automatic batch loading.\n *\n * @example\n * ```ts\n * const todoController = createEntityController({\n *   store,\n *   entity: 'todos',\n *   stream: 'user-123',\n * });\n *\n * const todo = await todoController.create({ title: 'Buy milk' });\n * const fetched = await todoController.read(todo.id);\n * ```\n */\nexport function createEntityController<\n  S extends RippleSchema = RippleSchema,\n  E extends EntityName<S> = EntityName<S>,\n  ListQuery = unknown,\n>(options: CreateEntityControllerOptions<S, E, ListQuery>): EntityController<S, E, ListQuery> {\n  const {\n    store,\n    entity,\n    stream,\n    hlcState = createHlcState('controller'),\n    generateId = () => crypto.randomUUID(),\n    batch,\n  } = options;\n  const batchLoader = createBatchLoader(store, entity, batch);\n\n  const getHlc = () => tickHlc(hlcState, Date.now());\n\n  return {\n    async create(patch: Partial<S[E]>): Promise<S[E]> {\n      // Extract ID from patch if present, otherwise generate one\n      const id = (patch as Record<string, unknown>).id as string | undefined ?? generateId();\n      const hlc = getHlc();\n\n      await store.applyChanges([\n        makeUpsert({\n          stream,\n          entity,\n          entityId: id,\n          patch: { ...patch, id } as Partial<S[E]>,\n          hlc,\n        }),\n      ]);\n\n      // Read back the created entity\n      const created = await batchLoader.load(id);\n      if (!created) {\n        throw new Error(`Failed to read created entity ${entity}:${id}`);\n      }\n      return created;\n    },\n\n    read(id: string): Promise<S[E] | null> {\n      return batchLoader.load(id);\n    },\n\n    readMany(ids: string[]): Promise<Map<string, S[E]>> {\n      return batchLoader.loadMany(ids);\n    },\n\n    async update(id: string, patch: Partial<S[E]>): Promise<S[E]> {\n      const hlc = getHlc();\n\n      await store.applyChanges([\n        makeUpsert({\n          stream,\n          entity,\n          entityId: id,\n          patch,\n          hlc,\n        }),\n      ]);\n\n      // Read back the updated entity\n      const updated = await batchLoader.load(id);\n      if (!updated) {\n        throw new Error(`Failed to read updated entity ${entity}:${id}`);\n      }\n      return updated;\n    },\n\n    async delete(id: string): Promise<void> {\n      const hlc = getHlc();\n\n      await store.applyChanges([\n        makeDelete({\n          stream,\n          entity,\n          entityId: id,\n          hlc,\n        }),\n      ]);\n    },\n\n    async list(query: ListQuery): Promise<S[E][]> {\n      return (await store.listRows(query)) as S[E][];\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@rippledb/client-controllers",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "sideEffects": false,
+  "description": "Abstract CRUD controllers with batch loading for RippleDB",
+  "keywords": [
+    "rippledb",
+    "crud",
+    "controllers",
+    "batch-loader",
+    "local-first",
+    "offline-first"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eckerlein/rippledb.git",
+    "directory": "packages/client-controllers"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@rippledb/core": "0.1.1",
+    "@rippledb/client": "0.1.1"
+  },
+  "devDependencies": {
+    "eslint": "^9.37.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@rippledb/store-memory": "0.1.1"
+  },
+  "tsup": {
+    "entry": [
+      "src/index.ts"
+    ],
+    "format": [
+      "esm"
+    ],
+    "dts": false,
+    "sourcemap": true,
+    "clean": true
+  },
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.build.json",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest --passWithNoTests",
+    "lint": "eslint ."
+  }
+}