@syncular/testkit 0.0.0 → 0.0.2-136

package/dist/sync-http.d.ts

@@ -0,0 +1,48 @@
+import type { SyncCombinedRequest, SyncCombinedResponse, SyncPullRequest, SyncPullResponse, SyncPushRequest, SyncPushResponse } from '@syncular/core';
+export interface JsonActorHeadersOptions {
+    actorId: string;
+    actorHeader?: string;
+    extraHeaders?: Record<string, string>;
+}
+export declare function createJsonActorHeaders(options: JsonActorHeadersOptions): Record<string, string>;
+export interface PostJsonWithActorOptions<TBody> {
+    fetch: typeof globalThis.fetch;
+    url: string;
+    actorId: string;
+    actorHeader?: string;
+    extraHeaders?: Record<string, string>;
+    body: TBody;
+}
+export interface PostJsonWithActorResult<TResponse> {
+    response: Response;
+    json: TResponse;
+}
+export declare function postJsonWithActor<TBody, TResponse>(options: PostJsonWithActorOptions<TBody>): Promise<PostJsonWithActorResult<TResponse>>;
+export interface PostSyncCombinedRequestOptions {
+    fetch: typeof globalThis.fetch;
+    url: string;
+    actorId: string;
+    actorHeader?: string;
+    extraHeaders?: Record<string, string>;
+    body: SyncCombinedRequest;
+}
+export declare function postSyncCombinedRequest(options: PostSyncCombinedRequestOptions): Promise<PostJsonWithActorResult<SyncCombinedResponse>>;
+export interface PostSyncPushRequestOptions {
+    fetch: typeof globalThis.fetch;
+    url: string;
+    actorId: string;
+    actorHeader?: string;
+    extraHeaders?: Record<string, string>;
+    body: SyncPushRequest;
+}
+export declare function postSyncPushRequest(options: PostSyncPushRequestOptions): Promise<PostJsonWithActorResult<SyncPushResponse>>;
+export interface PostSyncPullRequestOptions {
+    fetch: typeof globalThis.fetch;
+    url: string;
+    actorId: string;
+    actorHeader?: string;
+    extraHeaders?: Record<string, string>;
+    body: SyncPullRequest;
+}
+export declare function postSyncPullRequest(options: PostSyncPullRequestOptions): Promise<PostJsonWithActorResult<SyncPullResponse>>;
+//# sourceMappingURL=sync-http.d.ts.map

package/dist/sync-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-http.d.ts","sourceRoot":"","sources":["../src/sync-http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxB;AAED,MAAM,WAAW,wBAAwB,CAAC,KAAK;IAC7C,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,IAAI,EAAE,KAAK,CAAC;CACb;AAED,MAAM,WAAW,uBAAuB,CAAC,SAAS;IAChD,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EACtD,OAAO,EAAE,wBAAwB,CAAC,KAAK,CAAC,GACvC,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAa7C;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,IAAI,EAAE,mBAAmB,CAAC;CAC3B;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,uBAAuB,CAAC,oBAAoB,CAAC,CAAC,CAExD;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,CAAC,CAEpD;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,CAAC,CAEpD"}

package/dist/sync-http.js

@@ -0,0 +1,30 @@
+export function createJsonActorHeaders(options) {
+    return {
+        'content-type': 'application/json',
+        [options.actorHeader ?? 'x-actor-id']: options.actorId,
+        ...options.extraHeaders,
+    };
+}
+export async function postJsonWithActor(options) {
+    const response = await options.fetch(options.url, {
+        method: 'POST',
+        headers: createJsonActorHeaders({
+            actorId: options.actorId,
+            actorHeader: options.actorHeader,
+            extraHeaders: options.extraHeaders,
+        }),
+        body: JSON.stringify(options.body),
+    });
+    const json = (await response.json());
+    return { response, json };
+}
+export async function postSyncCombinedRequest(options) {
+    return postJsonWithActor(options);
+}
+export async function postSyncPushRequest(options) {
+    return postJsonWithActor(options);
+}
+export async function postSyncPullRequest(options) {
+    return postJsonWithActor(options);
+}
+//# sourceMappingURL=sync-http.js.map

package/dist/sync-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-http.js","sourceRoot":"","sources":["../src/sync-http.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,sBAAsB,CACpC,OAAgC,EACR;IACxB,OAAO;QACL,cAAc,EAAE,kBAAkB;QAClC,CAAC,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC,EAAE,OAAO,CAAC,OAAO;QACtD,GAAG,OAAO,CAAC,YAAY;KACxB,CAAC;AAAA,CACH;AAgBD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAwC,EACK;IAC7C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QAChD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,sBAAsB,CAAC;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC;QACF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;KACnC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAc,CAAC;IAClD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAAA,CAC3B;AAWD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAuC,EACiB;IACxD,OAAO,iBAAiB,CAA4C,OAAO,CAAC,CAAC;AAAA,CAC9E;AAWD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAmC,EACiB;IACpD,OAAO,iBAAiB,CAAoC,OAAO,CAAC,CAAC;AAAA,CACtE;AAWD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAmC,EACiB;IACpD,OAAO,iBAAiB,CAAoC,OAAO,CAAC,CAAC;AAAA,CACtE"}

package/dist/sync-response.d.ts

@@ -0,0 +1,7 @@
+import { type SyncChange, type SyncPullResponse } from '@syncular/core';
+export type SyncChangeRecord = SyncChange;
+export type SyncSubscriptionRecord = Pick<SyncPullResponse['subscriptions'][number], 'id' | 'commits'>;
+export declare function subscriptionChanges(subscriptions: SyncSubscriptionRecord[] | undefined, subscriptionId: string): SyncChangeRecord[];
+export declare function findSubscriptionChange(subscriptions: SyncSubscriptionRecord[] | undefined, subscriptionId: string, rowId: string): SyncChangeRecord | undefined;
+export declare function subscriptionChangeRow(change: SyncChangeRecord | undefined): Record<string, unknown> | undefined;
+//# sourceMappingURL=sync-response.d.ts.map

package/dist/sync-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-response.d.ts","sourceRoot":"","sources":["../src/sync-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAE1C,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,gBAAgB,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EACzC,IAAI,GAAG,SAAS,CACjB,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,sBAAsB,EAAE,GAAG,SAAS,EACnD,cAAc,EAAE,MAAM,GACrB,gBAAgB,EAAE,CASpB;AAED,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,sBAAsB,EAAE,GAAG,SAAS,EACnD,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,GACZ,gBAAgB,GAAG,SAAS,CAG9B;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAMrC"}

package/dist/sync-response.js

@@ -0,0 +1,19 @@
+import { isRecord, } from '@syncular/core';
+export function subscriptionChanges(subscriptions, subscriptionId) {
+    const subscription = subscriptions?.find((item) => item.id === subscriptionId);
+    if (!subscription) {
+        return [];
+    }
+    return subscription.commits?.flatMap((commit) => commit.changes) ?? [];
+}
+export function findSubscriptionChange(subscriptions, subscriptionId, rowId) {
+    const changes = subscriptionChanges(subscriptions, subscriptionId);
+    return changes.find((change) => change.row_id === rowId);
+}
+export function subscriptionChangeRow(change) {
+    if (!change) {
+        return undefined;
+    }
+    return isRecord(change.row_json) ? change.row_json : undefined;
+}
+//# sourceMappingURL=sync-response.js.map

package/dist/sync-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-response.js","sourceRoot":"","sources":["../src/sync-response.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,GAGT,MAAM,gBAAgB,CAAC;AASxB,MAAM,UAAU,mBAAmB,CACjC,aAAmD,EACnD,cAAsB,EACF;IACpB,MAAM,YAAY,GAAG,aAAa,EAAE,IAAI,CACtC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,cAAc,CACrC,CAAC;IACF,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;AAAA,CACxE;AAED,MAAM,UAAU,sBAAsB,CACpC,aAAmD,EACnD,cAAsB,EACtB,KAAa,EACiB;IAC9B,MAAM,OAAO,GAAG,mBAAmB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IACnE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC;AAAA,CAC1D;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAoC,EACC;IACrC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAAA,CAChE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/testkit",
-  "version": "0.0.0",
+  "version": "0.0.2-136",
   "description": "Testing fixtures and utilities for Syncular",
   "license": "MIT",
   "author": "Benjamin Kniffler",
@@ -41,17 +41,17 @@
     "release": "bunx syncular-publish"
   },
   "dependencies": {
-    "@syncular/client": "0.0.0",
-    "@syncular/core": "0.0.0",
-    "@syncular/dialect-bun-sqlite": "0.0.0",
-    "@syncular/dialect-libsql": "0.0.0",
-    "@syncular/dialect-pglite": "0.0.0",
-    "@syncular/dialect-sqlite3": "0.0.0",
-    "@syncular/server": "0.0.0",
-    "@syncular/server-dialect-postgres": "0.0.0",
-    "@syncular/server-dialect-sqlite": "0.0.0",
-    "@syncular/server-hono": "0.0.0",
-    "@syncular/transport-http": "0.0.0",
+    "@syncular/client": "0.0.2-136",
+    "@syncular/core": "0.0.2-136",
+    "@syncular/dialect-bun-sqlite": "0.0.2-136",
+    "@syncular/dialect-libsql": "0.0.2-136",
+    "@syncular/dialect-pglite": "0.0.2-136",
+    "@syncular/dialect-sqlite3": "0.0.2-136",
+    "@syncular/server": "0.0.2-136",
+    "@syncular/server-dialect-postgres": "0.0.2-136",
+    "@syncular/server-dialect-sqlite": "0.0.2-136",
+    "@syncular/server-hono": "0.0.2-136",
+    "@syncular/transport-http": "0.0.2-136",
     "hono": "^4.11.9"
   },
   "devDependencies": {

package/src/faults.ts

@@ -224,6 +224,3 @@ export function withRecording(
     },
   };
 }
-
-export const createErrorTransport = withFaults;
-export const createRecordingTransport = withRecording;

package/src/fixtures.ts

@@ -844,6 +844,3 @@ export async function destroyTestServer(
 ): Promise<void> {
   await server.destroy();
 }
-
-export const createServerFixture = createTestServer;
-export const createClientFixture = createTestClient;

package/src/index.ts

@@ -4,3 +4,6 @@ export * from './fixtures';
 export * from './hono-node-server';
 export * from './http-fixtures';
 export * from './project-scoped-tasks';
+export * from './runtime-process';
+export * from './sync-http';
+export * from './sync-response';

package/src/project-scoped-tasks.ts

@@ -1,4 +1,8 @@
-import { isRecord, type SyncOperation } from '@syncular/core';
+import {
+  isRecord,
+  type SyncOperation,
+  type SyncSubscriptionRequest,
+} from '@syncular/core';
 import type {
   ApplyOperationResult,
   EmittedChange,
@@ -297,3 +301,49 @@ export function createProjectScopedTasksHandler<
     },
   };
 }
+
+export interface CreateProjectScopedTasksSubscriptionOptions {
+  id?: string;
+  userId: string;
+  projectId?: string;
+  cursor?: number;
+}
+
+export function createProjectScopedTasksSubscription(
+  options: CreateProjectScopedTasksSubscriptionOptions
+): SyncSubscriptionRequest {
+  return {
+    id: options.id ?? 'sub-tasks',
+    table: 'tasks',
+    scopes: {
+      user_id: options.userId,
+      project_id: options.projectId ?? 'p0',
+    },
+    cursor: options.cursor ?? 0,
+    bootstrapState: null,
+  };
+}
+
+export interface CreateProjectScopedTaskUpsertOperationOptions {
+  taskId: string;
+  title: string;
+  completed?: number;
+  projectId?: string;
+  baseVersion?: number | null;
+}
+
+export function createProjectScopedTaskUpsertOperation(
+  options: CreateProjectScopedTaskUpsertOperationOptions
+): SyncOperation {
+  return {
+    table: 'tasks',
+    row_id: options.taskId,
+    op: 'upsert',
+    payload: {
+      title: options.title,
+      completed: options.completed ?? 0,
+      project_id: options.projectId ?? 'p0',
+    },
+    base_version: options.baseVersion ?? null,
+  };
+}

package/src/runtime-process.ts

@@ -0,0 +1,133 @@
+import type { ChildProcess } from 'node:child_process';
+
+export interface WaitForJsonPortOptions {
+  timeoutMs?: number;
+  processName?: string;
+}
+
+export async function waitForJsonPortFromStdout(
+  process: ChildProcess,
+  options: WaitForJsonPortOptions = {}
+): Promise<number> {
+  const timeoutMs = options.timeoutMs ?? 30_000;
+  const processName = options.processName ?? 'Child process';
+
+  return new Promise<number>((resolve, reject) => {
+    const stdout = process.stdout;
+    const stderr = process.stderr;
+
+    if (!stdout || !stderr) {
+      reject(new Error(`${processName} has no stdout/stderr pipes`));
+      return;
+    }
+
+    let stdoutBuffer = '';
+    let stderrBuffer = '';
+
+    const cleanup = () => {
+      clearTimeout(timeout);
+      stdout.off('data', onStdoutData);
+      stderr.off('data', onStderrData);
+      process.off('exit', onExit);
+    };
+
+    const resolvePort = (port: number) => {
+      cleanup();
+      resolve(port);
+    };
+
+    const rejectWith = (error: Error) => {
+      cleanup();
+      reject(error);
+    };
+
+    const onStdoutData = (chunk: Buffer | string) => {
+      stdoutBuffer += chunk.toString();
+
+      const lines = stdoutBuffer.split('\n');
+      stdoutBuffer = lines.pop() ?? '';
+
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+          continue;
+        }
+
+        try {
+          const parsed = JSON.parse(trimmed) as { port?: number };
+          if (parsed.port && parsed.port > 0) {
+            resolvePort(parsed.port);
+            return;
+          }
+        } catch {
+          // keep reading until a valid JSON line is emitted
+        }
+      }
+    };
+
+    const onStderrData = (chunk: Buffer | string) => {
+      stderrBuffer += chunk.toString();
+    };
+
+    const onExit = (code: number | null, signal: NodeJS.Signals | null) => {
+      rejectWith(
+        new Error(
+          `${processName} exited before reporting port (code=${String(code)} signal=${String(signal)})\nstderr: ${stderrBuffer}`
+        )
+      );
+    };
+
+    const timeout = setTimeout(() => {
+      rejectWith(
+        new Error(
+          `${processName} startup timed out after ${timeoutMs}ms\nstderr: ${stderrBuffer}`
+        )
+      );
+    }, timeoutMs);
+
+    stdout.on('data', onStdoutData);
+    stderr.on('data', onStderrData);
+    process.on('exit', onExit);
+  });
+}
+
+export interface StopChildProcessOptions {
+  gracePeriodMs?: number;
+}
+
+export async function stopChildProcess(
+  process: ChildProcess,
+  options: StopChildProcessOptions = {}
+): Promise<void> {
+  if (process.exitCode != null) {
+    return;
+  }
+
+  const gracePeriodMs = options.gracePeriodMs ?? 5000;
+
+  try {
+    process.kill('SIGTERM');
+  } catch {
+    return;
+  }
+
+  await new Promise<void>((resolve) => {
+    const onExit = () => {
+      clearTimeout(timeout);
+      process.off('exit', onExit);
+      resolve();
+    };
+
+    const timeout = setTimeout(() => {
+      try {
+        process.kill('SIGKILL');
+      } catch {
+        // ignore
+      }
+      process.off('exit', onExit);
+      resolve();
+    }, gracePeriodMs);
+
+    process.on('exit', onExit);
+  });
+}

package/src/sync-http.ts

@@ -0,0 +1,100 @@
+import type {
+  SyncCombinedRequest,
+  SyncCombinedResponse,
+  SyncPullRequest,
+  SyncPullResponse,
+  SyncPushRequest,
+  SyncPushResponse,
+} from '@syncular/core';
+
+export interface JsonActorHeadersOptions {
+  actorId: string;
+  actorHeader?: string;
+  extraHeaders?: Record<string, string>;
+}
+
+export function createJsonActorHeaders(
+  options: JsonActorHeadersOptions
+): Record<string, string> {
+  return {
+    'content-type': 'application/json',
+    [options.actorHeader ?? 'x-actor-id']: options.actorId,
+    ...options.extraHeaders,
+  };
+}
+
+export interface PostJsonWithActorOptions<TBody> {
+  fetch: typeof globalThis.fetch;
+  url: string;
+  actorId: string;
+  actorHeader?: string;
+  extraHeaders?: Record<string, string>;
+  body: TBody;
+}
+
+export interface PostJsonWithActorResult<TResponse> {
+  response: Response;
+  json: TResponse;
+}
+
+export async function postJsonWithActor<TBody, TResponse>(
+  options: PostJsonWithActorOptions<TBody>
+): Promise<PostJsonWithActorResult<TResponse>> {
+  const response = await options.fetch(options.url, {
+    method: 'POST',
+    headers: createJsonActorHeaders({
+      actorId: options.actorId,
+      actorHeader: options.actorHeader,
+      extraHeaders: options.extraHeaders,
+    }),
+    body: JSON.stringify(options.body),
+  });
+
+  const json = (await response.json()) as TResponse;
+  return { response, json };
+}
+
+export interface PostSyncCombinedRequestOptions {
+  fetch: typeof globalThis.fetch;
+  url: string;
+  actorId: string;
+  actorHeader?: string;
+  extraHeaders?: Record<string, string>;
+  body: SyncCombinedRequest;
+}
+
+export async function postSyncCombinedRequest(
+  options: PostSyncCombinedRequestOptions
+): Promise<PostJsonWithActorResult<SyncCombinedResponse>> {
+  return postJsonWithActor<SyncCombinedRequest, SyncCombinedResponse>(options);
+}
+
+export interface PostSyncPushRequestOptions {
+  fetch: typeof globalThis.fetch;
+  url: string;
+  actorId: string;
+  actorHeader?: string;
+  extraHeaders?: Record<string, string>;
+  body: SyncPushRequest;
+}
+
+export async function postSyncPushRequest(
+  options: PostSyncPushRequestOptions
+): Promise<PostJsonWithActorResult<SyncPushResponse>> {
+  return postJsonWithActor<SyncPushRequest, SyncPushResponse>(options);
+}
+
+export interface PostSyncPullRequestOptions {
+  fetch: typeof globalThis.fetch;
+  url: string;
+  actorId: string;
+  actorHeader?: string;
+  extraHeaders?: Record<string, string>;
+  body: SyncPullRequest;
+}
+
+export async function postSyncPullRequest(
+  options: PostSyncPullRequestOptions
+): Promise<PostJsonWithActorResult<SyncPullResponse>> {
+  return postJsonWithActor<SyncPullRequest, SyncPullResponse>(options);
+}

package/src/sync-response.ts

@@ -0,0 +1,45 @@
+import {
+  isRecord,
+  type SyncChange,
+  type SyncPullResponse,
+} from '@syncular/core';
+
+export type SyncChangeRecord = SyncChange;
+
+export type SyncSubscriptionRecord = Pick<
+  SyncPullResponse['subscriptions'][number],
+  'id' | 'commits'
+>;
+
+export function subscriptionChanges(
+  subscriptions: SyncSubscriptionRecord[] | undefined,
+  subscriptionId: string
+): SyncChangeRecord[] {
+  const subscription = subscriptions?.find(
+    (item) => item.id === subscriptionId
+  );
+  if (!subscription) {
+    return [];
+  }
+
+  return subscription.commits?.flatMap((commit) => commit.changes) ?? [];
+}
+
+export function findSubscriptionChange(
+  subscriptions: SyncSubscriptionRecord[] | undefined,
+  subscriptionId: string,
+  rowId: string
+): SyncChangeRecord | undefined {
+  const changes = subscriptionChanges(subscriptions, subscriptionId);
+  return changes.find((change) => change.row_id === rowId);
+}
+
+export function subscriptionChangeRow(
+  change: SyncChangeRecord | undefined
+): Record<string, unknown> | undefined {
+  if (!change) {
+    return undefined;
+  }
+
+  return isRecord(change.row_json) ? change.row_json : undefined;
+}