@syncular/testkit 0.9.0 → 0.10.0

package/README.md

@@ -193,6 +193,12 @@ production. A `ValidationRejection` with structured details reaches
 tests can assert field focus and correction routing without displaying server
 diagnostics.
 
+Pass `commitValidator` to test aggregate invariants with the same
+transaction-scoped candidate view as production. Throw
+`CommitValidationRejection` to select the operation that correction UI should
+focus. The test server uses real SQLite transaction serialization and shares
+the callback across loopback and socket rounds.
+
 ## React
 
 `@syncular/react`'s `SyncProvider` already takes any `SyncClient`, so

package/dist/create-test-sync.d.ts

@@ -15,7 +15,7 @@
  *     await sync.dispose();
  */
 import type { ClientSchema, SyncClientConfig } from '@syncular/client';
-import type { ResolveScopes, ValidatorRegistry } from '@syncular/server';
+import type { CommitValidator, ResolveScopes, ValidatorRegistry } from '@syncular/server';
 import { type TestClient } from './client.js';
 import { type VirtualClock } from './clock.js';
 import { type TestServer } from './server.js';
@@ -39,6 +39,8 @@ export interface CreateTestSyncOptions {
     readonly resolveScopes?: ResolveScopes;
     /** Optional §6.7 write validators, executed by the real test server. */
     readonly validators?: ValidatorRegistry;
+    /** Optional §6.8 whole-commit validator, executed by the real test server. */
+    readonly commitValidator?: CommitValidator;
     /** Epoch ms the shared virtual clock starts at (default 1_750_000_000_000). */
     readonly startMs?: number;
 }

package/dist/create-test-sync.js

@@ -31,6 +31,9 @@ export async function createTestSync(options) {
         ...(options.validators !== undefined
             ? { validators: options.validators }
             : {}),
+        ...(options.commitValidator !== undefined
+            ? { commitValidator: options.commitValidator }
+            : {}),
     });
     const clients = [];
     let autoId = 0;

package/dist/server.d.ts

@@ -8,7 +8,7 @@
  * directly.
  */
 import { type ClientSchema } from '@syncular/client';
-import { MemorySegmentStore, type RealtimeHub, type ResolveScopes, SqliteServerStorage, type SyncRequestContext, type ValidatorRegistry } from '@syncular/server';
+import { type CommitValidator, MemorySegmentStore, type RealtimeHub, type ResolveScopes, SqliteServerStorage, type SyncRequestContext, type ValidatorRegistry } from '@syncular/server';
 import type { VirtualClock } from './clock.js';
 /** Default partition every actor lives in (apps override via options). */
 export declare const DEFAULT_PARTITION = "test";
@@ -29,6 +29,8 @@ export interface TestServerOptions {
     readonly resolveScopes?: ResolveScopes;
     /** Optional §6.7 validators, shared by HTTP-like and socket rounds. */
     readonly validators?: ValidatorRegistry;
+    /** Optional §6.8 whole-commit validator, shared by both transports. */
+    readonly commitValidator?: CommitValidator;
 }
 /**
  * The server half of a test sync. `ctxFor(actorId)` builds the per-request

package/dist/server.js

@@ -48,6 +48,9 @@ export function createTestServer(options) {
         ...(options.validators !== undefined
             ? { validators: options.validators }
             : {}),
+        ...(options.commitValidator !== undefined
+            ? { commitValidator: options.commitValidator }
+            : {}),
     });
     return {
         storage,
@@ -64,6 +67,9 @@ export function createTestServer(options) {
             ...(options.validators !== undefined
                 ? { validators: options.validators }
                 : {}),
+            ...(options.commitValidator !== undefined
+                ? { commitValidator: options.commitValidator }
+                : {}),
             clock: clockFn,
             realtime: hub,
         }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/testkit",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Syncular test kit: in-process loopback server + clients for integration scenarios",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -64,8 +64,8 @@
     "test": "bun test --preload ./test/setup.ts"
   },
   "dependencies": {
-    "@syncular/server": "0.9.0",
-    "@syncular/client": "0.9.0"
+    "@syncular/server": "0.10.0",
+    "@syncular/client": "0.10.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0"
@@ -77,8 +77,8 @@
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^15.11.0",
-    "@syncular/core": "0.9.0",
-    "@syncular/react": "0.9.0",
+    "@syncular/core": "0.10.0",
+    "@syncular/react": "0.10.0",
     "@testing-library/react": "^16.1.0",
     "@types/react": "^18.3.0",
     "react": "^18.3.1",

package/src/create-test-sync.ts

@@ -16,7 +16,11 @@
  */
 
 import type { ClientSchema, SyncClientConfig } from '@syncular/client';
-import type { ResolveScopes, ValidatorRegistry } from '@syncular/server';
+import type {
+  CommitValidator,
+  ResolveScopes,
+  ValidatorRegistry,
+} from '@syncular/server';
 import { buildTestClient, type TestClient } from './client';
 import { createVirtualClock, type VirtualClock } from './clock';
 import {
@@ -46,6 +50,8 @@ export interface CreateTestSyncOptions {
   readonly resolveScopes?: ResolveScopes;
   /** Optional §6.7 write validators, executed by the real test server. */
   readonly validators?: ValidatorRegistry;
+  /** Optional §6.8 whole-commit validator, executed by the real test server. */
+  readonly commitValidator?: CommitValidator;
   /** Epoch ms the shared virtual clock starts at (default 1_750_000_000_000). */
   readonly startMs?: number;
 }
@@ -103,6 +109,9 @@ export async function createTestSync(
     ...(options.validators !== undefined
       ? { validators: options.validators }
       : {}),
+    ...(options.commitValidator !== undefined
+      ? { commitValidator: options.commitValidator }
+      : {}),
   });
 
   const clients: TestClient[] = [];

package/src/server.ts

@@ -10,6 +10,7 @@
 
 import { type ClientSchema, compileClientSchema } from '@syncular/client';
 import {
+  type CommitValidator,
   createRealtimeHub,
   MemorySegmentStore,
   type RealtimeHub,
@@ -53,6 +54,8 @@ export interface TestServerOptions {
   readonly resolveScopes?: ResolveScopes;
   /** Optional §6.7 validators, shared by HTTP-like and socket rounds. */
   readonly validators?: ValidatorRegistry;
+  /** Optional §6.8 whole-commit validator, shared by both transports. */
+  readonly commitValidator?: CommitValidator;
 }
 
 /**
@@ -85,6 +88,9 @@ export function createTestServer(options: TestServerOptions): TestServer {
     ...(options.validators !== undefined
       ? { validators: options.validators }
       : {}),
+    ...(options.commitValidator !== undefined
+      ? { commitValidator: options.commitValidator }
+      : {}),
   });
   return {
     storage,
@@ -101,6 +107,9 @@ export function createTestServer(options: TestServerOptions): TestServer {
       ...(options.validators !== undefined
         ? { validators: options.validators }
         : {}),
+      ...(options.commitValidator !== undefined
+        ? { commitValidator: options.commitValidator }
+        : {}),
       clock: clockFn,
       realtime: hub,
     }),