@rocicorp/zero 0.25.0-canary.8 → 0.25.0-canary.9

package/out/zero-server/src/process-mutations.js

@@ -1,5 +1,6 @@
 import { assert } from "../../shared/src/asserts.js";
 import { getErrorMessage, getErrorDetails } from "../../shared/src/error.js";
+import { promiseVoid } from "../../shared/src/resolved-promises.js";
 import { parse } from "../../shared/src/valita.js";
 import { MutationAlreadyProcessedError } from "../../zero-cache/src/services/mutagen/error.js";
 import { isApplicationError, wrapWithApplicationError } from "../../zero-protocol/src/application-error.js";
@@ -7,6 +8,7 @@ import { PushFailed } from "../../zero-protocol/src/error-kind-enum.js";
 import { Server } from "../../zero-protocol/src/error-origin-enum.js";
 import { Parse, UnsupportedPushVersion, OutOfOrderMutation as OutOfOrderMutation$1, Database, Internal } from "../../zero-protocol/src/error-reason-enum.js";
 import { pushBodySchema, pushParamsSchema } from "../../zero-protocol/src/push.js";
+import { isMutator } from "../../zql/src/mutate/mutator.js";
 import { createLogContext } from "./logging.js";
 const applicationErrorWrapper = async (fn) => {
   try {
@@ -18,26 +20,47 @@ const applicationErrorWrapper = async (fn) => {
     throw wrapWithApplicationError(error);
   }
 };
-async function handleMutationRequest(cb, queryOrQueryString, body, logLevel) {
-  if (logLevel === void 0) {
-    if (queryOrQueryString instanceof Request && typeof body === "string") {
-      logLevel = body;
-    } else {
-      logLevel = "info";
+async function handleMutationRequest(dbProvider, cb, queryStringOrRequest, bodyOrContext, contextOrLogLevel, logLevel) {
+  const isRequestOverload = queryStringOrRequest instanceof Request;
+  let request;
+  let queryString;
+  let jsonBody;
+  let context;
+  let lc;
+  if (isRequestOverload) {
+    request = queryStringOrRequest;
+    context = bodyOrContext;
+    const level = contextOrLogLevel ?? "info";
+    lc = createLogContext(level).withContext("PushProcessor");
+    const url = new URL(request.url);
+    queryString = url.searchParams;
+    try {
+      jsonBody = await request.json();
+    } catch (error) {
+      lc.error?.("Failed to parse push body", error);
+      const message = `Failed to parse push body: ${getErrorMessage(error)}`;
+      const details = getErrorDetails(error);
+      return {
+        kind: PushFailed,
+        origin: Server,
+        reason: Parse,
+        message,
+        mutationIDs: [],
+        ...details ? { details } : {}
+      };
     }
+  } else {
+    queryString = queryStringOrRequest;
+    jsonBody = bodyOrContext;
+    context = contextOrLogLevel;
+    const level = logLevel ?? "info";
+    lc = createLogContext(level).withContext("PushProcessor");
   }
-  const lc = createLogContext(logLevel).withContext("PushProcessor");
   let mutationIDs = [];
-  let req;
+  let pushBody;
   try {
-    let rawBody;
-    if (queryOrQueryString instanceof Request) {
-      rawBody = await queryOrQueryString.json();
-    } else {
-      rawBody = body;
-    }
-    req = parse(rawBody, pushBodySchema);
-    mutationIDs = req.mutations.map((m) => ({
+    pushBody = parse(jsonBody, pushBodySchema);
+    mutationIDs = pushBody.mutations.map((m) => ({
       id: m.id,
       clientID: m.clientID
     }));
@@ -56,17 +79,8 @@ async function handleMutationRequest(cb, queryOrQueryString, body, logLevel) {
   }
   let queryParams;
   try {
-    let queryString;
-    if (queryOrQueryString instanceof Request) {
-      const url = new URL(queryOrQueryString.url);
-      queryString = url.searchParams;
-    } else {
-      queryString = queryOrQueryString;
-    }
-    if (queryString instanceof URLSearchParams) {
-      queryString = Object.fromEntries(queryString);
-    }
-    queryParams = parse(queryString, pushParamsSchema, "passthrough");
+    const queryStringObj = queryString instanceof URLSearchParams ? Object.fromEntries(queryString) : queryString;
+    queryParams = parse(queryStringObj, pushParamsSchema, "passthrough");
   } catch (error) {
     lc.error?.("Failed to parse push query parameters", error);
     const message = `Failed to parse push query parameters: ${getErrorMessage(error)}`;
@@ -80,35 +94,59 @@ async function handleMutationRequest(cb, queryOrQueryString, body, logLevel) {
       ...details ? { details } : {}
     };
   }
-  if (req.pushVersion !== 1) {
+  if (pushBody.pushVersion !== 1) {
     const response = {
       kind: PushFailed,
       origin: Server,
       reason: UnsupportedPushVersion,
       mutationIDs,
-      message: `Unsupported push version: ${req.pushVersion}`
+      message: `Unsupported push version: ${pushBody.pushVersion}`
     };
     return response;
   }
   const responses = [];
   let processedCount = 0;
   try {
-    const transactor = new Transactor(req, queryParams, lc);
-    for (const m of req.mutations) {
+    const transactor = new Transactor(
+      dbProvider,
+      pushBody,
+      queryParams,
+      lc,
+      context
+    );
+    for (const m of pushBody.mutations) {
       assert(m.type === "custom", "Expected custom mutation");
-      const transactProxy = (dbProvider, innerCb) => transactor.transact(
-        dbProvider,
-        m,
-        (tx, name, args) => applicationErrorWrapper(() => innerCb(tx, name, args))
+      lc.debug?.(
+        `Processing mutation '${m.name}' (id=${m.id}, clientID=${m.clientID})`,
+        m.args
       );
+      let mutationPhase = "preTransaction";
+      const transactProxy = async (innerCb) => {
+        mutationPhase = "transactionPending";
+        const result = await transactor.transact(
+          m,
+          (tx, name, args) => applicationErrorWrapper(() => innerCb(tx, name, args, context))
+        );
+        mutationPhase = "postCommit";
+        return result;
+      };
       try {
         const res = await applicationErrorWrapper(() => cb(transactProxy, m));
         responses.push(res);
+        lc.debug?.(`Mutation '${m.name}' (id=${m.id}) completed successfully`);
         processedCount++;
       } catch (error) {
         if (!isApplicationError(error)) {
           throw error;
         }
+        if (mutationPhase === "preTransaction") {
+          await transactor.persistPreTransactionFailure(m, error);
+        } else if (mutationPhase === "postCommit") {
+          lc.error?.(
+            `Post-commit mutation handler failed for mutation ${m.id} for client ${m.clientID}`,
+            error
+          );
+        }
         lc.warn?.(
           `Application error processing mutation ${m.id} for client ${m.clientID}`,
           error
@@ -136,24 +174,23 @@ async function handleMutationRequest(cb, queryOrQueryString, body, logLevel) {
   }
 }
 class Transactor {
+  #dbProvider;
   #req;
   #params;
   #lc;
-  constructor(req, params, lc) {
+  #context;
+  constructor(dbProvider, req, params, lc, context) {
+    this.#dbProvider = dbProvider;
     this.#req = req;
     this.#params = params;
     this.#lc = lc;
+    this.#context = context;
   }
-  transact = async (dbProvider, mutation, cb) => {
+  transact = async (mutation, cb) => {
     let appError = void 0;
     for (; ; ) {
       try {
-        const ret = await this.#transactImpl(
-          dbProvider,
-          mutation,
-          cb,
-          appError
-        );
+        const ret = await this.#transactImpl(mutation, cb, appError);
         if (appError !== void 0) {
           this.#lc.warn?.(
             `Mutation ${mutation.id} for client ${mutation.clientID} was retried after an error`,
@@ -188,61 +225,72 @@ class Transactor {
           );
           continue;
         }
-        if (error instanceof DatabaseTransactionError) {
-          this.#lc.error?.(
-            `Database error processing mutation ${mutation.id} for client ${mutation.clientID}`,
-            error
-          );
-        } else {
-          this.#lc.error?.(
-            `Unexpected error processing mutation ${mutation.id} for client ${mutation.clientID}`,
-            error
-          );
-        }
+        this.#lc.error?.(
+          `Unexpected error processing mutation ${mutation.id} for client ${mutation.clientID}`,
+          error
+        );
         throw error;
       }
     }
   };
-  #transactImpl(dbProvider, mutation, cb, appError) {
+  async persistPreTransactionFailure(mutation, appError) {
+    const ret = await this.#transactImpl(
+      mutation,
+      // noop callback since there's no transaction to execute
+      () => promiseVoid,
+      appError
+    );
+    return ret;
+  }
+  async #transactImpl(mutation, cb, appError) {
     let transactionPhase = "open";
-    return dbProvider.transaction(
-      async (dbTx, transactionHooks) => {
-        transactionPhase = "execute";
-        await this.#checkAndIncrementLastMutationID(
-          transactionHooks,
-          mutation.clientID,
-          mutation.id
-        );
-        if (appError === void 0) {
-          try {
-            await cb(dbTx, mutation.name, mutation.args[0]);
-          } catch (appError2) {
-            throw wrapWithApplicationError(appError2);
+    try {
+      const ret = await this.#dbProvider.transaction(
+        async (dbTx, transactionHooks) => {
+          transactionPhase = "execute";
+          await this.#checkAndIncrementLastMutationID(
+            transactionHooks,
+            mutation.clientID,
+            mutation.id
+          );
+          if (appError === void 0) {
+            this.#lc.debug?.(
+              `Executing mutator '${mutation.name}' (id=${mutation.id})`
+            );
+            try {
+              await cb(dbTx, mutation.name, mutation.args[0], this.#context);
+            } catch (appError2) {
+              throw wrapWithApplicationError(appError2);
+            }
+          } else {
+            const mutationResult = makeAppErrorResponse(mutation, appError);
+            await transactionHooks.writeMutationResult(mutationResult);
           }
-        } else {
-          const mutationResult = makeAppErrorResponse(mutation, appError);
-          await transactionHooks.writeMutationResult(mutationResult);
-        }
-        return {
-          id: {
-            clientID: mutation.clientID,
-            id: mutation.id
-          },
-          result: {}
-        };
-      },
-      {
-        upstreamSchema: this.#params.schema,
-        clientGroupID: this.#req.clientGroupID,
-        clientID: mutation.clientID,
-        mutationID: mutation.id
-      }
-    ).catch((error) => {
+          return {
+            id: {
+              clientID: mutation.clientID,
+              id: mutation.id
+            },
+            result: {}
+          };
+        },
+        this.#getTransactionInput(mutation)
+      );
+      return ret;
+    } catch (error) {
       if (isApplicationError(error) || error instanceof OutOfOrderMutation || error instanceof MutationAlreadyProcessedError) {
         throw error;
       }
       throw new DatabaseTransactionError(transactionPhase, { cause: error });
-    });
+    }
+  }
+  #getTransactionInput(mutation) {
+    return {
+      upstreamSchema: this.#params.schema,
+      clientGroupID: this.#req.clientGroupID,
+      clientID: mutation.clientID,
+      mutationID: mutation.id
+    };
   }
   async #checkAndIncrementLastMutationID(transactionHooks, clientID, receivedMutationID) {
     const { lastMutationID } = await transactionHooks.updateClientMutationID();
@@ -282,26 +330,24 @@ function makeAppErrorResponse(m, error) {
   };
 }
 function getMutation(mutators, name) {
-  let path;
-  if (name.includes("|")) {
-    path = name.split("|");
-  } else {
-    path = name.split(".");
-  }
-  let mutator;
-  if (path.length === 1) {
-    mutator = mutators[path[0]];
-  } else {
-    const nextMap = mutators[path[0]];
-    assert(
-      typeof nextMap === "object" && nextMap !== void 0,
-      `could not find mutator map for ${name}`
-    );
-    mutator = nextMap[path[1]];
+  const path = name.split(/\.|\|/);
+  const mutator = getObjectAtPath(mutators, path);
+  assert(typeof mutator === "function", `could not find mutator ${name}`);
+  if (isMutator(mutator)) {
+    return (tx, args, ctx) => mutator.fn({ args, ctx, tx });
   }
-  assert(typeof mutator === "function", () => `could not find mutator ${name}`);
   return mutator;
 }
+function getObjectAtPath(obj, path) {
+  let current = obj;
+  for (const part of path) {
+    if (typeof current !== "object" || current === null || !(part in current)) {
+      return void 0;
+    }
+    current = current[part];
+  }
+  return current;
+}
 class DatabaseTransactionError extends Error {
   constructor(phase, options) {
     super(

package/out/zero-server/src/process-mutations.js.map

@@ -1 +1 @@
-{"version":3,"file":"process-mutations.js","sources":["../../../../zero-server/src/process-mutations.ts"],"sourcesContent":["import type {LogContext, LogLevel} from '@rocicorp/logger';\nimport {assert} from '../../shared/src/asserts.ts';\nimport {getErrorDetails, getErrorMessage} from '../../shared/src/error.ts';\nimport type {ReadonlyJSONValue} from '../../shared/src/json.ts';\nimport type {MaybePromise} from '../../shared/src/types.ts';\nimport * as v from '../../shared/src/valita.ts';\nimport {MutationAlreadyProcessedError} from '../../zero-cache/src/services/mutagen/error.ts';\nimport type {ApplicationError} from '../../zero-protocol/src/application-error.ts';\nimport {\n  isApplicationError,\n  wrapWithApplicationError,\n} from '../../zero-protocol/src/application-error.ts';\nimport {ErrorKind} from '../../zero-protocol/src/error-kind.ts';\nimport {ErrorOrigin} from '../../zero-protocol/src/error-origin.ts';\nimport {ErrorReason} from '../../zero-protocol/src/error-reason.ts';\nimport type {PushFailedBody} from '../../zero-protocol/src/error.ts';\nimport {\n  pushBodySchema,\n  pushParamsSchema,\n  type CustomMutation,\n  type Mutation,\n  type MutationID,\n  type MutationResponse,\n  type PushBody,\n  type PushResponse,\n} from '../../zero-protocol/src/push.ts';\nimport type {CustomMutatorDefs, CustomMutatorImpl} from './custom.ts';\nimport {createLogContext} from './logging.ts';\n\nexport interface TransactionProviderHooks {\n  updateClientMutationID: () => Promise<{lastMutationID: number | bigint}>;\n  writeMutationResult: (result: MutationResponse) => Promise<void>;\n}\n\nexport interface TransactionProviderInput {\n  upstreamSchema: string;\n  clientGroupID: string;\n  clientID: string;\n  mutationID: number;\n}\n\n/**\n * Defines the abstract interface for a database that PushProcessor can execute\n * transactions against.\n */\nexport interface Database<T> {\n  transaction: <R>(\n    callback: (\n      tx: T,\n      transactionHooks: TransactionProviderHooks,\n    ) => MaybePromise<R>,\n    transactionInput?: TransactionProviderInput,\n  ) => Promise<R>;\n}\n\nexport type ExtractTransactionType<D> = D extends Database<infer T> ? T : never;\nexport type Params = v.Infer<typeof pushParamsSchema>;\n\nexport type TransactFn = <D extends Database<ExtractTransactionType<D>>>(\n  dbProvider: D,\n  cb: TransactFnCallback<D>,\n) => Promise<MutationResponse>;\n\nexport type TransactFnCallback<D extends Database<ExtractTransactionType<D>>> =\n  (\n    tx: ExtractTransactionType<D>,\n    mutatorName: string,\n    mutatorArgs: ReadonlyJSONValue,\n  ) => Promise<void>;\n\nexport type Parsed = {\n  transact: TransactFn;\n  mutations: CustomMutation[];\n};\n\nconst applicationErrorWrapper = async <T>(fn: () => Promise<T>): Promise<T> => {\n  try {\n    return await fn();\n  } catch (error) {\n    if (\n      error instanceof DatabaseTransactionError ||\n      error instanceof OutOfOrderMutation ||\n      error instanceof MutationAlreadyProcessedError ||\n      isApplicationError(error)\n    ) {\n      throw error;\n    }\n\n    throw wrapWithApplicationError(error);\n  }\n};\n\n/**\n * Call `cb` for each mutation in the request.\n * The callback is called sequentially for each mutation.\n * If a mutation is out of order, the processing will stop and an error will be returned.\n * If a mutation has already been processed, it will be skipped and the processing will continue.\n * If a mutation receives an application error, it will be skipped, the error will be returned to the client, and processing will continue.\n */\nexport function handleMutationRequest(\n  cb: (\n    transact: TransactFn,\n    mutation: CustomMutation,\n  ) => Promise<MutationResponse>,\n  queryString: URLSearchParams | Record<string, string>,\n  body: ReadonlyJSONValue,\n  logLevel?: LogLevel,\n): Promise<PushResponse>;\nexport function handleMutationRequest(\n  cb: (\n    transact: TransactFn,\n    mutation: CustomMutation,\n  ) => Promise<MutationResponse>,\n  request: Request,\n  logLevel?: LogLevel,\n): Promise<PushResponse>;\nexport async function handleMutationRequest(\n  cb: (\n    transact: TransactFn,\n    mutation: CustomMutation,\n  ) => Promise<MutationResponse>,\n  queryOrQueryString: Request | URLSearchParams | Record<string, string>,\n  body?: ReadonlyJSONValue | LogLevel,\n  logLevel?: LogLevel,\n): Promise<PushResponse> {\n  if (logLevel === undefined) {\n    if (queryOrQueryString instanceof Request && typeof body === 'string') {\n      logLevel = body as LogLevel;\n    } else {\n      logLevel = 'info';\n    }\n  }\n\n  const lc = createLogContext(logLevel).withContext('PushProcessor');\n\n  let mutationIDs: MutationID[] = [];\n\n  let req: PushBody;\n  try {\n    let rawBody: unknown;\n    if (queryOrQueryString instanceof Request) {\n      rawBody = await queryOrQueryString.json();\n    } else {\n      rawBody = body;\n    }\n    req = v.parse(rawBody, pushBodySchema);\n\n    mutationIDs = req.mutations.map(m => ({\n      id: m.id,\n      clientID: m.clientID,\n    }));\n  } catch (error) {\n    lc.error?.('Failed to parse push body', error);\n\n    const message = `Failed to parse push body: ${getErrorMessage(error)}`;\n    const details = getErrorDetails(error);\n\n    return {\n      kind: ErrorKind.PushFailed,\n      origin: ErrorOrigin.Server,\n      reason: ErrorReason.Parse,\n      message,\n      mutationIDs,\n      ...(details ? {details} : {}),\n    } as const satisfies PushFailedBody;\n  }\n\n  let queryParams: Params;\n  try {\n    let queryString: URLSearchParams | Record<string, string>;\n\n    if (queryOrQueryString instanceof Request) {\n      const url = new URL(queryOrQueryString.url);\n      queryString = url.searchParams;\n    } else {\n      queryString = queryOrQueryString;\n    }\n\n    if (queryString instanceof URLSearchParams) {\n      queryString = Object.fromEntries(queryString);\n    }\n\n    queryParams = v.parse(queryString, pushParamsSchema, 'passthrough');\n  } catch (error) {\n    lc.error?.('Failed to parse push query parameters', error);\n\n    const message = `Failed to parse push query parameters: ${getErrorMessage(error)}`;\n    const details = getErrorDetails(error);\n\n    return {\n      kind: ErrorKind.PushFailed,\n      origin: ErrorOrigin.Server,\n      reason: ErrorReason.Parse,\n      message,\n      mutationIDs,\n      ...(details ? {details} : {}),\n    } as const satisfies PushFailedBody;\n  }\n\n  if (req.pushVersion !== 1) {\n    const response = {\n      kind: ErrorKind.PushFailed,\n      origin: ErrorOrigin.Server,\n      reason: ErrorReason.UnsupportedPushVersion,\n      mutationIDs,\n      message: `Unsupported push version: ${req.pushVersion}`,\n    } as const satisfies PushFailedBody;\n    return response;\n  }\n\n  const responses: MutationResponse[] = [];\n  let processedCount = 0;\n\n  try {\n    const transactor = new Transactor(req, queryParams, lc);\n\n    for (const m of req.mutations) {\n      assert(m.type === 'custom', 'Expected custom mutation');\n\n      const transactProxy: TransactFn = (dbProvider, innerCb) =>\n        transactor.transact(dbProvider, m, (tx, name, args) =>\n          applicationErrorWrapper(() => innerCb(tx, name, args)),\n        );\n\n      try {\n        const res = await applicationErrorWrapper(() => cb(transactProxy, m));\n        responses.push(res);\n\n        processedCount++;\n      } catch (error) {\n        if (!isApplicationError(error)) {\n          throw error;\n        }\n\n        lc.warn?.(\n          `Application error processing mutation ${m.id} for client ${m.clientID}`,\n          error,\n        );\n        responses.push(makeAppErrorResponse(m, error));\n        processedCount++;\n      }\n    }\n\n    return {\n      mutations: responses,\n    };\n  } catch (error) {\n    lc.error?.('Failed to process push request', error);\n    // only include mutationIDs for mutations that were not processed\n    const unprocessedMutationIDs = mutationIDs.slice(processedCount);\n\n    const message = getErrorMessage(error);\n    const details = getErrorDetails(error);\n\n    return {\n      kind: ErrorKind.PushFailed,\n      origin: ErrorOrigin.Server,\n      reason:\n        error instanceof OutOfOrderMutation\n          ? ErrorReason.OutOfOrderMutation\n          : error instanceof DatabaseTransactionError\n            ? ErrorReason.Database\n            : ErrorReason.Internal,\n      message,\n      mutationIDs: unprocessedMutationIDs,\n      ...(details ? {details} : {}),\n    };\n  }\n}\n\nclass Transactor {\n  readonly #req: PushBody;\n  readonly #params: Params;\n  readonly #lc: LogContext;\n\n  constructor(req: PushBody, params: Params, lc: LogContext) {\n    this.#req = req;\n    this.#params = params;\n    this.#lc = lc;\n  }\n\n  transact = async <D extends Database<ExtractTransactionType<D>>>(\n    dbProvider: D,\n    mutation: CustomMutation,\n    cb: TransactFnCallback<D>,\n  ): Promise<MutationResponse> => {\n    let appError: ApplicationError | undefined = undefined;\n    for (;;) {\n      try {\n        const ret = await this.#transactImpl(\n          dbProvider,\n          mutation,\n          cb,\n          appError,\n        );\n        if (appError !== undefined) {\n          this.#lc.warn?.(\n            `Mutation ${mutation.id} for client ${mutation.clientID} was retried after an error`,\n            appError,\n          );\n          return makeAppErrorResponse(mutation, appError);\n        }\n\n        return ret;\n      } catch (error) {\n        if (error instanceof OutOfOrderMutation) {\n          this.#lc.error?.(error);\n          throw error;\n        }\n\n        if (error instanceof MutationAlreadyProcessedError) {\n          this.#lc.warn?.(error);\n          return {\n            id: {\n              clientID: mutation.clientID,\n              id: mutation.id,\n            },\n            result: {\n              error: 'alreadyProcessed',\n              details: error.message,\n            },\n          };\n        }\n\n        if (isApplicationError(error)) {\n          appError = error;\n          this.#lc.warn?.(\n            `Application error processing mutation ${mutation.id} for client ${mutation.clientID}`,\n            appError,\n          );\n          continue;\n        }\n\n        if (error instanceof DatabaseTransactionError) {\n          this.#lc.error?.(\n            `Database error processing mutation ${mutation.id} for client ${mutation.clientID}`,\n            error,\n          );\n        } else {\n          this.#lc.error?.(\n            `Unexpected error processing mutation ${mutation.id} for client ${mutation.clientID}`,\n            error,\n          );\n        }\n\n        throw error;\n      }\n    }\n  };\n\n  #transactImpl<D extends Database<ExtractTransactionType<D>>>(\n    dbProvider: D,\n    mutation: CustomMutation,\n    cb: TransactFnCallback<D>,\n    appError: ApplicationError | undefined,\n  ): MaybePromise<MutationResponse> {\n    let transactionPhase: DatabaseTransactionPhase = 'open';\n\n    return dbProvider\n      .transaction(\n        async (dbTx, transactionHooks) => {\n          // update the transaction phase to 'execute' after the transaction is opened\n          transactionPhase = 'execute';\n\n          await this.#checkAndIncrementLastMutationID(\n            transactionHooks,\n            mutation.clientID,\n            mutation.id,\n          );\n\n          if (appError === undefined) {\n            try {\n              await cb(dbTx, mutation.name, mutation.args[0]);\n            } catch (appError) {\n              throw wrapWithApplicationError(appError);\n            }\n          } else {\n            const mutationResult = makeAppErrorResponse(mutation, appError);\n            await transactionHooks.writeMutationResult(mutationResult);\n          }\n\n          return {\n            id: {\n              clientID: mutation.clientID,\n              id: mutation.id,\n            },\n            result: {},\n          };\n        },\n        {\n          upstreamSchema: this.#params.schema,\n          clientGroupID: this.#req.clientGroupID,\n          clientID: mutation.clientID,\n          mutationID: mutation.id,\n        },\n      )\n      .catch(error => {\n        if (\n          isApplicationError(error) ||\n          error instanceof OutOfOrderMutation ||\n          error instanceof MutationAlreadyProcessedError\n        ) {\n          throw error;\n        }\n\n        throw new DatabaseTransactionError(transactionPhase, {cause: error});\n      });\n  }\n\n  async #checkAndIncrementLastMutationID(\n    transactionHooks: TransactionProviderHooks,\n    clientID: string,\n    receivedMutationID: number,\n  ) {\n    const {lastMutationID} = await transactionHooks.updateClientMutationID();\n\n    if (receivedMutationID < lastMutationID) {\n      throw new MutationAlreadyProcessedError(\n        clientID,\n        receivedMutationID,\n        lastMutationID,\n      );\n    } else if (receivedMutationID > lastMutationID) {\n      throw new OutOfOrderMutation(\n        clientID,\n        receivedMutationID,\n        lastMutationID,\n      );\n    }\n  }\n}\n\nexport class OutOfOrderMutation extends Error {\n  constructor(\n    clientID: string,\n    receivedMutationID: number,\n    lastMutationID: number | bigint,\n  ) {\n    super(\n      `Client ${clientID} sent mutation ID ${receivedMutationID} but expected ${lastMutationID}`,\n    );\n  }\n}\n\nfunction makeAppErrorResponse(\n  m: Mutation,\n  error: ApplicationError<ReadonlyJSONValue | undefined>,\n): MutationResponse {\n  return {\n    id: {\n      clientID: m.clientID,\n      id: m.id,\n    },\n    result: {\n      error: 'app',\n      message: error.message,\n      ...(error.details ? {details: error.details} : {}),\n    },\n  };\n}\n\nexport function getMutation(\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  mutators: CustomMutatorDefs<any>,\n  name: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n): CustomMutatorImpl<any, any> {\n  let path: string[];\n  if (name.includes('|')) {\n    path = name.split('|');\n  } else {\n    path = name.split('.');\n  }\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  let mutator: any;\n  if (path.length === 1) {\n    mutator = mutators[path[0]];\n  } else {\n    const nextMap = mutators[path[0]];\n    assert(\n      typeof nextMap === 'object' && nextMap !== undefined,\n      `could not find mutator map for ${name}`,\n    );\n    mutator = nextMap[path[1]];\n  }\n\n  assert(typeof mutator === 'function', () => `could not find mutator ${name}`);\n  return mutator;\n}\n\ntype DatabaseTransactionPhase = 'open' | 'execute';\nclass DatabaseTransactionError extends Error {\n  constructor(phase: DatabaseTransactionPhase, options?: ErrorOptions) {\n    super(\n      phase === 'open'\n        ? `Failed to open database transaction: ${getErrorMessage(options?.cause)}`\n        : `Database transaction failed after opening: ${getErrorMessage(options?.cause)}`,\n      options,\n    );\n    this.name = 'DatabaseTransactionError';\n  }\n}\n"],"names":["v.parse","ErrorKind.PushFailed","ErrorOrigin.Server","ErrorReason.Parse","ErrorReason.UnsupportedPushVersion","ErrorReason.OutOfOrderMutation","ErrorReason.Database","ErrorReason.Internal","appError"],"mappings":"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"}
+{"version":3,"file":"process-mutations.js","sources":["../../../../zero-server/src/process-mutations.ts"],"sourcesContent":["import type {LogContext, LogLevel} from '@rocicorp/logger';\nimport {assert} from '../../shared/src/asserts.ts';\nimport {getErrorDetails, getErrorMessage} from '../../shared/src/error.ts';\nimport type {ReadonlyJSONValue} from '../../shared/src/json.ts';\nimport {promiseVoid} from '../../shared/src/resolved-promises.ts';\nimport type {MaybePromise} from '../../shared/src/types.ts';\nimport * as v from '../../shared/src/valita.ts';\nimport {MutationAlreadyProcessedError} from '../../zero-cache/src/services/mutagen/error.ts';\nimport type {ApplicationError} from '../../zero-protocol/src/application-error.ts';\nimport {\n  isApplicationError,\n  wrapWithApplicationError,\n} from '../../zero-protocol/src/application-error.ts';\nimport {ErrorKind} from '../../zero-protocol/src/error-kind.ts';\nimport {ErrorOrigin} from '../../zero-protocol/src/error-origin.ts';\nimport {ErrorReason} from '../../zero-protocol/src/error-reason.ts';\nimport type {PushFailedBody} from '../../zero-protocol/src/error.ts';\nimport {\n  pushBodySchema,\n  pushParamsSchema,\n  type CustomMutation,\n  type Mutation,\n  type MutationID,\n  type MutationResponse,\n  type PushBody,\n  type PushResponse,\n} from '../../zero-protocol/src/push.ts';\nimport type {AnyMutatorRegistry} from '../../zql/src/mutate/mutator-registry.ts';\nimport {isMutator} from '../../zql/src/mutate/mutator.ts';\nimport type {CustomMutatorDefs, CustomMutatorImpl} from './custom.ts';\nimport {createLogContext} from './logging.ts';\n\nexport interface TransactionProviderHooks {\n  updateClientMutationID: () => Promise<{lastMutationID: number | bigint}>;\n  writeMutationResult: (result: MutationResponse) => Promise<void>;\n}\n\nexport interface TransactionProviderInput {\n  upstreamSchema: string;\n  clientGroupID: string;\n  clientID: string;\n  mutationID: number;\n}\n\n/**\n * Defines the abstract interface for a database that PushProcessor can execute\n * transactions against.\n */\nexport interface Database<T> {\n  transaction: <R>(\n    callback: (\n      tx: T,\n      transactionHooks: TransactionProviderHooks,\n    ) => MaybePromise<R>,\n    transactionInput?: TransactionProviderInput,\n  ) => Promise<R>;\n}\n\nexport type ExtractTransactionType<D> = D extends Database<infer T> ? T : never;\nexport type Params = v.Infer<typeof pushParamsSchema>;\n\nexport type TransactFn<\n  D extends Database<ExtractTransactionType<D>>,\n  Context,\n> = (cb: TransactFnCallback<D, Context>) => Promise<MutationResponse>;\n\nexport type TransactFnCallback<\n  D extends Database<ExtractTransactionType<D>>,\n  Context,\n> = (\n  tx: ExtractTransactionType<D>,\n  mutatorName: string,\n  mutatorArgs: ReadonlyJSONValue | undefined,\n  ctx: Context,\n) => Promise<void>;\n\nexport type Parsed<D extends Database<ExtractTransactionType<D>>, Context> = {\n  transact: TransactFn<D, Context>;\n  mutations: CustomMutation[];\n};\n\ntype MutationPhase = 'preTransaction' | 'transactionPending' | 'postCommit';\n\nconst applicationErrorWrapper = async <T>(fn: () => Promise<T>): Promise<T> => {\n  try {\n    return await fn();\n  } catch (error) {\n    if (\n      error instanceof DatabaseTransactionError ||\n      error instanceof OutOfOrderMutation ||\n      error instanceof MutationAlreadyProcessedError ||\n      isApplicationError(error)\n    ) {\n      throw error;\n    }\n\n    throw wrapWithApplicationError(error);\n  }\n};\n\nexport function handleMutationRequest<\n  D extends Database<ExtractTransactionType<D>>,\n  C = undefined,\n>(\n  dbProvider: D,\n  cb: (\n    transact: TransactFn<D, C>,\n    mutation: CustomMutation,\n  ) => Promise<MutationResponse>,\n  queryString: URLSearchParams | Record<string, string>,\n  body: ReadonlyJSONValue,\n  context?: C,\n  logLevel?: LogLevel,\n): Promise<PushResponse>;\n\nexport function handleMutationRequest<\n  D extends Database<ExtractTransactionType<D>>,\n  C = undefined,\n>(\n  dbProvider: D,\n  cb: (\n    transact: TransactFn<D, C>,\n    mutation: CustomMutation,\n  ) => Promise<MutationResponse>,\n  request: Request,\n  context?: C,\n  logLevel?: LogLevel,\n): Promise<PushResponse>;\n\nexport async function handleMutationRequest<\n  D extends Database<ExtractTransactionType<D>>,\n  C,\n>(\n  dbProvider: D,\n  cb: (\n    transact: TransactFn<D, C>,\n    mutation: CustomMutation,\n  ) => Promise<MutationResponse>,\n  queryStringOrRequest: Request | URLSearchParams | Record<string, string>,\n  bodyOrContext: ReadonlyJSONValue | C,\n  contextOrLogLevel?: C | LogLevel,\n  logLevel?: LogLevel,\n): Promise<PushResponse> {\n  // Parse overload arguments\n  const isRequestOverload = queryStringOrRequest instanceof Request;\n\n  let request: Request | undefined;\n  let queryString: URLSearchParams | Record<string, string>;\n  let jsonBody: unknown;\n  let context: C;\n  let lc: LogContext;\n\n  if (isRequestOverload) {\n    request = queryStringOrRequest;\n    context = bodyOrContext as C;\n    const level = (contextOrLogLevel as LogLevel | undefined) ?? 'info';\n\n    // Create log context early, before extracting JSON from Request\n    lc = createLogContext(level).withContext('PushProcessor');\n\n    const url = new URL(request.url);\n    queryString = url.searchParams;\n\n    try {\n      jsonBody = await request.json();\n    } catch (error) {\n      lc.error?.('Failed to parse push body', error);\n      const message = `Failed to parse push body: ${getErrorMessage(error)}`;\n      const details = getErrorDetails(error);\n      return {\n        kind: ErrorKind.PushFailed,\n        origin: ErrorOrigin.Server,\n        reason: ErrorReason.Parse,\n        message,\n        mutationIDs: [],\n        ...(details ? {details} : {}),\n      } as const satisfies PushFailedBody;\n    }\n  } else {\n    queryString = queryStringOrRequest;\n    jsonBody = bodyOrContext;\n    context = contextOrLogLevel as C;\n    const level = logLevel ?? 'info';\n    lc = createLogContext(level).withContext('PushProcessor');\n  }\n\n  let mutationIDs: MutationID[] = [];\n\n  let pushBody: PushBody;\n  try {\n    pushBody = v.parse(jsonBody, pushBodySchema);\n    mutationIDs = pushBody.mutations.map(m => ({\n      id: m.id,\n      clientID: m.clientID,\n    }));\n  } catch (error) {\n    lc.error?.('Failed to parse push body', error);\n    const message = `Failed to parse push body: ${getErrorMessage(error)}`;\n    const details = getErrorDetails(error);\n    return {\n      kind: ErrorKind.PushFailed,\n      origin: ErrorOrigin.Server,\n      reason: ErrorReason.Parse,\n      message,\n      mutationIDs,\n      ...(details ? {details} : {}),\n    } as const satisfies PushFailedBody;\n  }\n\n  let queryParams: Params;\n  try {\n    const queryStringObj =\n      queryString instanceof URLSearchParams\n        ? Object.fromEntries(queryString)\n        : queryString;\n    queryParams = v.parse(queryStringObj, pushParamsSchema, 'passthrough');\n  } catch (error) {\n    lc.error?.('Failed to parse push query parameters', error);\n    const message = `Failed to parse push query parameters: ${getErrorMessage(error)}`;\n    const details = getErrorDetails(error);\n    return {\n      kind: ErrorKind.PushFailed,\n      origin: ErrorOrigin.Server,\n      reason: ErrorReason.Parse,\n      message,\n      mutationIDs,\n      ...(details ? {details} : {}),\n    } as const satisfies PushFailedBody;\n  }\n\n  if (pushBody.pushVersion !== 1) {\n    const response = {\n      kind: ErrorKind.PushFailed,\n      origin: ErrorOrigin.Server,\n      reason: ErrorReason.UnsupportedPushVersion,\n      mutationIDs,\n      message: `Unsupported push version: ${pushBody.pushVersion}`,\n    } as const satisfies PushFailedBody;\n    return response;\n  }\n\n  const responses: MutationResponse[] = [];\n  let processedCount = 0;\n\n  try {\n    const transactor = new Transactor(\n      dbProvider,\n      pushBody,\n      queryParams,\n      lc,\n      context,\n    );\n\n    // Each mutation goes through three phases:\n    //   1. Pre-transaction: user logic that runs before `transact` is called. If\n    //      this throws we still advance LMID and persist the failure result.\n    //   2. Transaction: the callback passed to `transact`, which can be retried\n    //      if it fails with an ApplicationError.\n    //   3. Post-commit: any logic that runs after `transact` resolves. Failures\n    //      here are logged but the mutation remains committed.\n    for (const m of pushBody.mutations) {\n      assert(m.type === 'custom', 'Expected custom mutation');\n      lc.debug?.(\n        `Processing mutation '${m.name}' (id=${m.id}, clientID=${m.clientID})`,\n        m.args,\n      );\n\n      let mutationPhase: MutationPhase = 'preTransaction';\n\n      const transactProxy: TransactFn<D, C> = async innerCb => {\n        mutationPhase = 'transactionPending';\n        const result = await transactor.transact(m, (tx, name, args) =>\n          applicationErrorWrapper(() => innerCb(tx, name, args, context)),\n        );\n        mutationPhase = 'postCommit';\n        return result;\n      };\n\n      try {\n        const res = await applicationErrorWrapper(() => cb(transactProxy, m));\n        responses.push(res);\n        lc.debug?.(`Mutation '${m.name}' (id=${m.id}) completed successfully`);\n\n        processedCount++;\n      } catch (error) {\n        if (!isApplicationError(error)) {\n          throw error;\n        }\n\n        if (mutationPhase === 'preTransaction') {\n          // Pre-transaction\n          await transactor.persistPreTransactionFailure(m, error);\n        } else if (mutationPhase === 'postCommit') {\n          // Post-commit\n          lc.error?.(\n            `Post-commit mutation handler failed for mutation ${m.id} for client ${m.clientID}`,\n            error,\n          );\n        }\n\n        lc.warn?.(\n          `Application error processing mutation ${m.id} for client ${m.clientID}`,\n          error,\n        );\n        responses.push(makeAppErrorResponse(m, error));\n\n        processedCount++;\n      }\n    }\n\n    return {\n      mutations: responses,\n    };\n  } catch (error) {\n    lc.error?.('Failed to process push request', error);\n    // only include mutationIDs for mutations that were not processed\n    const unprocessedMutationIDs = mutationIDs.slice(processedCount);\n\n    const message = getErrorMessage(error);\n    const details = getErrorDetails(error);\n\n    return {\n      kind: ErrorKind.PushFailed,\n      origin: ErrorOrigin.Server,\n      reason:\n        error instanceof OutOfOrderMutation\n          ? ErrorReason.OutOfOrderMutation\n          : error instanceof DatabaseTransactionError\n            ? ErrorReason.Database\n            : ErrorReason.Internal,\n      message,\n      mutationIDs: unprocessedMutationIDs,\n      ...(details ? {details} : {}),\n    };\n  }\n}\n\nclass Transactor<D extends Database<ExtractTransactionType<D>>, Context> {\n  readonly #dbProvider: D;\n  readonly #req: PushBody;\n  readonly #params: Params;\n  readonly #lc: LogContext;\n  readonly #context: Context;\n\n  constructor(\n    dbProvider: D,\n    req: PushBody,\n    params: Params,\n    lc: LogContext,\n    context: Context,\n  ) {\n    this.#dbProvider = dbProvider;\n    this.#req = req;\n    this.#params = params;\n    this.#lc = lc;\n    this.#context = context;\n  }\n\n  transact = async (\n    mutation: CustomMutation,\n    cb: TransactFnCallback<D, Context>,\n  ): Promise<MutationResponse> => {\n    let appError: ApplicationError | undefined = undefined;\n    for (;;) {\n      try {\n        const ret = await this.#transactImpl(mutation, cb, appError);\n        if (appError !== undefined) {\n          this.#lc.warn?.(\n            `Mutation ${mutation.id} for client ${mutation.clientID} was retried after an error`,\n            appError,\n          );\n          return makeAppErrorResponse(mutation, appError);\n        }\n\n        return ret;\n      } catch (error) {\n        if (error instanceof OutOfOrderMutation) {\n          this.#lc.error?.(error);\n          throw error;\n        }\n\n        if (error instanceof MutationAlreadyProcessedError) {\n          this.#lc.warn?.(error);\n          return {\n            id: {\n              clientID: mutation.clientID,\n              id: mutation.id,\n            },\n            result: {\n              error: 'alreadyProcessed',\n              details: error.message,\n            },\n          };\n        }\n\n        if (isApplicationError(error)) {\n          appError = error;\n          this.#lc.warn?.(\n            `Application error processing mutation ${mutation.id} for client ${mutation.clientID}`,\n            appError,\n          );\n          continue;\n        }\n\n        this.#lc.error?.(\n          `Unexpected error processing mutation ${mutation.id} for client ${mutation.clientID}`,\n          error,\n        );\n\n        throw error;\n      }\n    }\n  };\n\n  async persistPreTransactionFailure(\n    mutation: CustomMutation,\n    appError: ApplicationError<ReadonlyJSONValue | undefined>,\n  ): Promise<MutationResponse> {\n    // User-land code threw before calling `transact`. We still need to bump the\n    // LMID for this mutation and persist the error so that the client knows it failed.\n    const ret = await this.#transactImpl(\n      mutation,\n      // noop callback since there's no transaction to execute\n      () => promiseVoid,\n      appError,\n    );\n    return ret;\n  }\n\n  async #transactImpl(\n    mutation: CustomMutation,\n    cb: TransactFnCallback<D, Context>,\n    appError: ApplicationError | undefined,\n  ): Promise<MutationResponse> {\n    let transactionPhase: DatabaseTransactionPhase = 'open';\n\n    try {\n      const ret = await this.#dbProvider.transaction(\n        async (dbTx, transactionHooks) => {\n          // update the transaction phase to 'execute' after the transaction is opened\n          transactionPhase = 'execute';\n\n          await this.#checkAndIncrementLastMutationID(\n            transactionHooks,\n            mutation.clientID,\n            mutation.id,\n          );\n\n          if (appError === undefined) {\n            this.#lc.debug?.(\n              `Executing mutator '${mutation.name}' (id=${mutation.id})`,\n            );\n            try {\n              await cb(dbTx, mutation.name, mutation.args[0], this.#context);\n            } catch (appError) {\n              throw wrapWithApplicationError(appError);\n            }\n          } else {\n            const mutationResult = makeAppErrorResponse(mutation, appError);\n            await transactionHooks.writeMutationResult(mutationResult);\n          }\n\n          return {\n            id: {\n              clientID: mutation.clientID,\n              id: mutation.id,\n            },\n            result: {},\n          };\n        },\n        this.#getTransactionInput(mutation),\n      );\n\n      return ret;\n    } catch (error) {\n      if (\n        isApplicationError(error) ||\n        error instanceof OutOfOrderMutation ||\n        error instanceof MutationAlreadyProcessedError\n      ) {\n        throw error;\n      }\n\n      throw new DatabaseTransactionError(transactionPhase, {cause: error});\n    }\n  }\n\n  #getTransactionInput(mutation: CustomMutation): TransactionProviderInput {\n    return {\n      upstreamSchema: this.#params.schema,\n      clientGroupID: this.#req.clientGroupID,\n      clientID: mutation.clientID,\n      mutationID: mutation.id,\n    };\n  }\n\n  async #checkAndIncrementLastMutationID(\n    transactionHooks: TransactionProviderHooks,\n    clientID: string,\n    receivedMutationID: number,\n  ) {\n    const {lastMutationID} = await transactionHooks.updateClientMutationID();\n\n    if (receivedMutationID < lastMutationID) {\n      throw new MutationAlreadyProcessedError(\n        clientID,\n        receivedMutationID,\n        lastMutationID,\n      );\n    } else if (receivedMutationID > lastMutationID) {\n      throw new OutOfOrderMutation(\n        clientID,\n        receivedMutationID,\n        lastMutationID,\n      );\n    }\n  }\n}\n\nexport class OutOfOrderMutation extends Error {\n  constructor(\n    clientID: string,\n    receivedMutationID: number,\n    lastMutationID: number | bigint,\n  ) {\n    super(\n      `Client ${clientID} sent mutation ID ${receivedMutationID} but expected ${lastMutationID}`,\n    );\n  }\n}\n\nfunction makeAppErrorResponse(\n  m: Mutation,\n  error: ApplicationError<ReadonlyJSONValue | undefined>,\n): MutationResponse {\n  return {\n    id: {\n      clientID: m.clientID,\n      id: m.id,\n    },\n    result: {\n      error: 'app',\n      message: error.message,\n      ...(error.details ? {details: error.details} : {}),\n    },\n  };\n}\n\n/** @deprecated Use getMutator instead */\nexport function getMutation(\n  // oxlint-disable-next-line no-explicit-any\n  mutators: AnyMutatorRegistry | CustomMutatorDefs<any>,\n  name: string,\n  // oxlint-disable-next-line no-explicit-any\n): CustomMutatorImpl<any> {\n  const path = name.split(/\\.|\\|/);\n  const mutator = getObjectAtPath(mutators, path);\n  assert(typeof mutator === 'function', `could not find mutator ${name}`);\n\n  if (isMutator(mutator)) {\n    // mutator needs to be called with {tx, args, ctx}\n    // CustomMutatorImpl is called with (tx, args, ctx)\n    return (tx, args, ctx) => mutator.fn({args, ctx, tx});\n  }\n\n  // oxlint-disable-next-line no-explicit-any\n  return mutator as CustomMutatorImpl<any>;\n}\n\nfunction getObjectAtPath(\n  obj: Record<string, unknown>,\n  path: string[],\n): unknown {\n  let current: unknown = obj;\n  for (const part of path) {\n    if (typeof current !== 'object' || current === null || !(part in current)) {\n      return undefined;\n    }\n    current = (current as Record<string, unknown>)[part];\n  }\n  return current;\n}\n\ntype DatabaseTransactionPhase = 'open' | 'execute';\nclass DatabaseTransactionError extends Error {\n  constructor(phase: DatabaseTransactionPhase, options?: ErrorOptions) {\n    super(\n      phase === 'open'\n        ? `Failed to open database transaction: ${getErrorMessage(options?.cause)}`\n        : `Database transaction failed after opening: ${getErrorMessage(options?.cause)}`,\n      options,\n    );\n    this.name = 'DatabaseTransactionError';\n  }\n}\n"],"names":["ErrorKind.PushFailed","ErrorOrigin.Server","ErrorReason.Parse","v.parse","ErrorReason.UnsupportedPushVersion","ErrorReason.OutOfOrderMutation","ErrorReason.Database","ErrorReason.Internal","appError"],"mappings":"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"}

package/out/zero-server/src/push-processor.d.ts

@@ -1,11 +1,13 @@
 import { type LogLevel } from '@rocicorp/logger';
 import type { ReadonlyJSONValue } from '../../shared/src/json.ts';
 import { type PushResponse } from '../../zero-protocol/src/push.ts';
+import { type Database, type ExtractTransactionType } from '../../zero-server/src/process-mutations.ts';
+import type { Schema } from '../../zero-types/src/schema.ts';
+import type { AnyMutatorRegistry } from '../../zql/src/mutate/mutator-registry.ts';
 import type { CustomMutatorDefs } from './custom.ts';
-import { type ExtractTransactionType, type Database } from '../../zero-server/src/process-mutations.ts';
-export declare class PushProcessor<D extends Database<ExtractTransactionType<D>>, MD extends CustomMutatorDefs<ExtractTransactionType<D>>> {
+export declare class PushProcessor<_S extends Schema, D extends Database<ExtractTransactionType<D>>, MD extends AnyMutatorRegistry | CustomMutatorDefs<ExtractTransactionType<D>>, C = undefined> {
     #private;
-    constructor(dbProvider: D, logLevel?: LogLevel);
+    constructor(dbProvider: D, context?: C, logLevel?: LogLevel);
     /**
      * Processes a push request from zero-cache.
      * This function will parse the request, check the protocol version, and process each mutation in the request.

package/out/zero-server/src/push-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"push-processor.d.ts","sourceRoot":"","sources":["../../../../zero-server/src/push-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,aAAa,CAAC;AACnD,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EAGd,MAAM,4CAA4C,CAAC;AAGpD,qBAAa,aAAa,CACxB,CAAC,SAAS,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,EAC7C,EAAE,SAAS,iBAAiB,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;;gBAK3C,UAAU,EAAE,CAAC,EAAE,QAAQ,GAAE,QAAiB;IAKtD;;;;;;;;;;OAUG;IACH,OAAO,CACL,QAAQ,EAAE,EAAE,EACZ,WAAW,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACrD,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,YAAY,CAAC;IAExB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CA6D/D"}
+{"version":3,"file":"push-processor.d.ts","sourceRoot":"","sources":["../../../../zero-server/src/push-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAGhE,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAG5B,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,gCAAgC,CAAC;AAE3D,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,0CAA0C,CAAC;AAEjF,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,aAAa,CAAC;AAEnD,qBAAa,aAAa,CACxB,EAAE,SAAS,MAAM,EACjB,CAAC,SAAS,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,EAC7C,EAAE,SAAS,kBAAkB,GAAG,iBAAiB,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,EAC5E,CAAC,GAAG,SAAS;;gBAMD,UAAU,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAE,QAAiB;IAMnE;;;;;;;;;;OAUG;IACH,OAAO,CACL,QAAQ,EAAE,EAAE,EACZ,WAAW,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACrD,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,YAAY,CAAC;IAExB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CAoD/D"}

package/out/zero-server/src/push-processor.js

@@ -1,57 +1,49 @@
 import "@rocicorp/logger";
 import { assert } from "../../shared/src/asserts.js";
+import { must } from "../../shared/src/must.js";
+import { getValueAtPath } from "../../shared/src/object-traversal.js";
 import "../../zero-protocol/src/push.js";
-import { splitMutatorKey } from "../../zql/src/mutate/custom.js";
 import { handleMutationRequest } from "./process-mutations.js";
-import { must } from "../../shared/src/must.js";
+import { isMutator } from "../../zql/src/mutate/mutator.js";
 class PushProcessor {
   #dbProvider;
   #logLevel;
-  constructor(dbProvider, logLevel = "info") {
+  #context;
+  constructor(dbProvider, context, logLevel = "info") {
     this.#dbProvider = dbProvider;
+    this.#context = context;
     this.#logLevel = logLevel;
   }
   process(mutators, queryOrQueryString, body) {
     if (queryOrQueryString instanceof Request) {
       return handleMutationRequest(
-        (transact, mutations) => this.#processMutation(mutators, transact, mutations),
+        this.#dbProvider,
+        (transact, mutation) => this.#processMutation(mutators, transact, mutation),
         queryOrQueryString,
+        this.#context,
         this.#logLevel
       );
     }
     return handleMutationRequest(
+      this.#dbProvider,
       (transact, mutation) => this.#processMutation(mutators, transact, mutation),
       queryOrQueryString,
       must(body),
+      this.#context,
       this.#logLevel
     );
   }
   #processMutation(mutators, transact, _mutation) {
     return transact(
-      this.#dbProvider,
-      (tx, name, args) => this.#dispatchMutation(mutators, tx, name, args)
+      (tx, name, args, ctx) => this.#dispatchMutation(mutators, tx, name, args, ctx)
     );
   }
-  #dispatchMutation(mutators, dbTx, key, args) {
-    const [namespace, name] = splitMutatorKey(key);
-    if (name === void 0) {
-      const mutator2 = mutators[namespace];
-      assert(
-        typeof mutator2 === "function",
-        () => `could not find mutator ${key}`
-      );
-      return mutator2(dbTx, args);
+  #dispatchMutation(mutators, dbTx, key, args, ctx) {
+    const mutator = getValueAtPath(mutators, key, /\.|\|/);
+    assert(typeof mutator === "function", `could not find mutator ${key}`);
+    if (isMutator(mutator)) {
+      return mutator.fn({ args, ctx, tx: dbTx });
     }
-    const mutatorGroup = mutators[namespace];
-    assert(
-      typeof mutatorGroup === "object",
-      () => `could not find mutators for namespace ${namespace}`
-    );
-    const mutator = mutatorGroup[name];
-    assert(
-      typeof mutator === "function",
-      () => `could not find mutator ${key}`
-    );
     return mutator(dbTx, args);
   }
 }

package/out/zero-server/src/push-processor.js.map

@@ -1 +1 @@
-{"version":3,"file":"push-processor.js","sources":["../../../../zero-server/src/push-processor.ts"],"sourcesContent":["import {type LogLevel} from '@rocicorp/logger';\nimport {assert} from '../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../shared/src/json.ts';\nimport {\n  type CustomMutation,\n  type MutationResponse,\n  type PushResponse,\n} from '../../zero-protocol/src/push.ts';\nimport {splitMutatorKey} from '../../zql/src/mutate/custom.ts';\nimport type {CustomMutatorDefs} from './custom.ts';\nimport {\n  type ExtractTransactionType,\n  type Database,\n  handleMutationRequest,\n  type TransactFn,\n} from '../../zero-server/src/process-mutations.ts';\nimport {must} from '../../shared/src/must.ts';\n\nexport class PushProcessor<\n  D extends Database<ExtractTransactionType<D>>,\n  MD extends CustomMutatorDefs<ExtractTransactionType<D>>,\n> {\n  readonly #dbProvider: D;\n  readonly #logLevel;\n\n  constructor(dbProvider: D, logLevel: LogLevel = 'info') {\n    this.#dbProvider = dbProvider;\n    this.#logLevel = logLevel;\n  }\n\n  /**\n   * Processes a push request from zero-cache.\n   * This function will parse the request, check the protocol version, and process each mutation in the request.\n   * - If a mutation is out of order: processing will stop and an error will be returned. The zero client will retry the mutation.\n   * - If a mutation has already been processed: it will be skipped and the processing will continue.\n   * - If a mutation receives an application error: it will be skipped, the error will be returned to the client, and processing will continue.\n   *\n   * @param mutators the custom mutators for the application\n   * @param queryString the query string from the request sent by zero-cache. This will include zero's postgres schema name and appID.\n   * @param body the body of the request sent by zero-cache as a JSON object.\n   */\n  process(\n    mutators: MD,\n    queryString: URLSearchParams | Record<string, string>,\n    body: ReadonlyJSONValue,\n  ): Promise<PushResponse>;\n\n  /**\n   * This override gets the query string and the body from a Request object.\n   *\n   * @param mutators the custom mutators for the application\n   * @param request A `Request` object.\n   */\n  process(mutators: MD, request: Request): Promise<PushResponse>;\n  process(\n    mutators: MD,\n    queryOrQueryString: Request | URLSearchParams | Record<string, string>,\n    body?: ReadonlyJSONValue,\n  ): Promise<PushResponse> {\n    if (queryOrQueryString instanceof Request) {\n      return handleMutationRequest(\n        (transact, mutations) =>\n          this.#processMutation(mutators, transact, mutations),\n        queryOrQueryString,\n        this.#logLevel,\n      );\n    }\n    return handleMutationRequest(\n      (transact, mutation) =>\n        this.#processMutation(mutators, transact, mutation),\n      queryOrQueryString,\n      must(body),\n      this.#logLevel,\n    );\n  }\n\n  #processMutation(\n    mutators: MD,\n    transact: TransactFn,\n    _mutation: CustomMutation,\n  ): Promise<MutationResponse> {\n    return transact(this.#dbProvider, (tx, name, args) =>\n      this.#dispatchMutation(mutators, tx, name, args),\n    );\n  }\n\n  #dispatchMutation(\n    mutators: MD,\n    dbTx: ExtractTransactionType<D>,\n    key: string,\n    args: ReadonlyJSONValue,\n  ): Promise<void> {\n    const [namespace, name] = splitMutatorKey(key);\n    if (name === undefined) {\n      const mutator = mutators[namespace];\n      assert(\n        typeof mutator === 'function',\n        () => `could not find mutator ${key}`,\n      );\n      return mutator(dbTx, args);\n    }\n\n    const mutatorGroup = mutators[namespace];\n    assert(\n      typeof mutatorGroup === 'object',\n      () => `could not find mutators for namespace ${namespace}`,\n    );\n    const mutator = mutatorGroup[name];\n    assert(\n      typeof mutator === 'function',\n      () => `could not find mutator ${key}`,\n    );\n    return mutator(dbTx, args);\n  }\n}\n"],"names":["mutator"],"mappings":";;;;;;AAkBO,MAAM,cAGX;AAAA,EACS;AAAA,EACA;AAAA,EAET,YAAY,YAAe,WAAqB,QAAQ;AACtD,SAAK,cAAc;AACnB,SAAK,YAAY;AAAA,EACnB;AAAA,EA0BA,QACE,UACA,oBACA,MACuB;AACvB,QAAI,8BAA8B,SAAS;AACzC,aAAO;AAAA,QACL,CAAC,UAAU,cACT,KAAK,iBAAiB,UAAU,UAAU,SAAS;AAAA,QACrD;AAAA,QACA,KAAK;AAAA,MAAA;AAAA,IAET;AACA,WAAO;AAAA,MACL,CAAC,UAAU,aACT,KAAK,iBAAiB,UAAU,UAAU,QAAQ;AAAA,MACpD;AAAA,MACA,KAAK,IAAI;AAAA,MACT,KAAK;AAAA,IAAA;AAAA,EAET;AAAA,EAEA,iBACE,UACA,UACA,WAC2B;AAC3B,WAAO;AAAA,MAAS,KAAK;AAAA,MAAa,CAAC,IAAI,MAAM,SAC3C,KAAK,kBAAkB,UAAU,IAAI,MAAM,IAAI;AAAA,IAAA;AAAA,EAEnD;AAAA,EAEA,kBACE,UACA,MACA,KACA,MACe;AACf,UAAM,CAAC,WAAW,IAAI,IAAI,gBAAgB,GAAG;AAC7C,QAAI,SAAS,QAAW;AACtB,YAAMA,WAAU,SAAS,SAAS;AAClC;AAAA,QACE,OAAOA,aAAY;AAAA,QACnB,MAAM,0BAA0B,GAAG;AAAA,MAAA;AAErC,aAAOA,SAAQ,MAAM,IAAI;AAAA,IAC3B;AAEA,UAAM,eAAe,SAAS,SAAS;AACvC;AAAA,MACE,OAAO,iBAAiB;AAAA,MACxB,MAAM,yCAAyC,SAAS;AAAA,IAAA;AAE1D,UAAM,UAAU,aAAa,IAAI;AACjC;AAAA,MACE,OAAO,YAAY;AAAA,MACnB,MAAM,0BAA0B,GAAG;AAAA,IAAA;AAErC,WAAO,QAAQ,MAAM,IAAI;AAAA,EAC3B;AACF;"}
+{"version":3,"file":"push-processor.js","sources":["../../../../zero-server/src/push-processor.ts"],"sourcesContent":["import {type LogLevel} from '@rocicorp/logger';\nimport {assert} from '../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../shared/src/json.ts';\nimport {must} from '../../shared/src/must.ts';\nimport {getValueAtPath} from '../../shared/src/object-traversal.ts';\nimport {\n  type CustomMutation,\n  type MutationResponse,\n  type PushResponse,\n} from '../../zero-protocol/src/push.ts';\nimport {\n  type Database,\n  type ExtractTransactionType,\n  handleMutationRequest,\n  type TransactFn,\n} from '../../zero-server/src/process-mutations.ts';\nimport type {Schema} from '../../zero-types/src/schema.ts';\nimport type {Transaction} from '../../zql/src/mutate/custom.ts';\nimport type {AnyMutatorRegistry} from '../../zql/src/mutate/mutator-registry.ts';\nimport {isMutator} from '../../zql/src/mutate/mutator.ts';\nimport type {CustomMutatorDefs} from './custom.ts';\n\nexport class PushProcessor<\n  _S extends Schema,\n  D extends Database<ExtractTransactionType<D>>,\n  MD extends AnyMutatorRegistry | CustomMutatorDefs<ExtractTransactionType<D>>,\n  C = undefined,\n> {\n  readonly #dbProvider: D;\n  readonly #logLevel: LogLevel;\n  readonly #context: C;\n\n  constructor(dbProvider: D, context?: C, logLevel: LogLevel = 'info') {\n    this.#dbProvider = dbProvider;\n    this.#context = context as C;\n    this.#logLevel = logLevel;\n  }\n\n  /**\n   * Processes a push request from zero-cache.\n   * This function will parse the request, check the protocol version, and process each mutation in the request.\n   * - If a mutation is out of order: processing will stop and an error will be returned. The zero client will retry the mutation.\n   * - If a mutation has already been processed: it will be skipped and the processing will continue.\n   * - If a mutation receives an application error: it will be skipped, the error will be returned to the client, and processing will continue.\n   *\n   * @param mutators the custom mutators for the application\n   * @param queryString the query string from the request sent by zero-cache. This will include zero's postgres schema name and appID.\n   * @param body the body of the request sent by zero-cache as a JSON object.\n   */\n  process(\n    mutators: MD,\n    queryString: URLSearchParams | Record<string, string>,\n    body: ReadonlyJSONValue,\n  ): Promise<PushResponse>;\n\n  /**\n   * This override gets the query string and the body from a Request object.\n   *\n   * @param mutators the custom mutators for the application\n   * @param request A `Request` object.\n   */\n  process(mutators: MD, request: Request): Promise<PushResponse>;\n  process(\n    mutators: MD,\n    queryOrQueryString: Request | URLSearchParams | Record<string, string>,\n    body?: ReadonlyJSONValue,\n  ): Promise<PushResponse> {\n    if (queryOrQueryString instanceof Request) {\n      return handleMutationRequest(\n        this.#dbProvider,\n        (transact, mutation) =>\n          this.#processMutation(mutators, transact, mutation),\n        queryOrQueryString,\n        this.#context,\n        this.#logLevel,\n      );\n    }\n    return handleMutationRequest(\n      this.#dbProvider,\n      (transact, mutation) =>\n        this.#processMutation(mutators, transact, mutation),\n      queryOrQueryString,\n      must(body),\n      this.#context,\n      this.#logLevel,\n    );\n  }\n\n  #processMutation(\n    mutators: MD,\n    transact: TransactFn<D, C>,\n    _mutation: CustomMutation,\n  ): Promise<MutationResponse> {\n    return transact((tx, name, args, ctx) =>\n      this.#dispatchMutation(mutators, tx, name, args, ctx),\n    );\n  }\n\n  #dispatchMutation(\n    mutators: MD,\n    dbTx: ExtractTransactionType<D>,\n    key: string,\n    args: ReadonlyJSONValue | undefined,\n    ctx: C,\n  ): Promise<void> {\n    // Legacy mutators used | as a separator, new mutators use .\n    const mutator = getValueAtPath(mutators, key, /\\.|\\|/);\n    assert(typeof mutator === 'function', `could not find mutator ${key}`);\n    if (isMutator(mutator)) {\n      return mutator.fn({args, ctx, tx: dbTx as Transaction<Schema, unknown>});\n    }\n    return mutator(dbTx, args);\n  }\n}\n"],"names":[],"mappings":";;;;;;;AAsBO,MAAM,cAKX;AAAA,EACS;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,YAAe,SAAa,WAAqB,QAAQ;AACnE,SAAK,cAAc;AACnB,SAAK,WAAW;AAChB,SAAK,YAAY;AAAA,EACnB;AAAA,EA0BA,QACE,UACA,oBACA,MACuB;AACvB,QAAI,8BAA8B,SAAS;AACzC,aAAO;AAAA,QACL,KAAK;AAAA,QACL,CAAC,UAAU,aACT,KAAK,iBAAiB,UAAU,UAAU,QAAQ;AAAA,QACpD;AAAA,QACA,KAAK;AAAA,QACL,KAAK;AAAA,MAAA;AAAA,IAET;AACA,WAAO;AAAA,MACL,KAAK;AAAA,MACL,CAAC,UAAU,aACT,KAAK,iBAAiB,UAAU,UAAU,QAAQ;AAAA,MACpD;AAAA,MACA,KAAK,IAAI;AAAA,MACT,KAAK;AAAA,MACL,KAAK;AAAA,IAAA;AAAA,EAET;AAAA,EAEA,iBACE,UACA,UACA,WAC2B;AAC3B,WAAO;AAAA,MAAS,CAAC,IAAI,MAAM,MAAM,QAC/B,KAAK,kBAAkB,UAAU,IAAI,MAAM,MAAM,GAAG;AAAA,IAAA;AAAA,EAExD;AAAA,EAEA,kBACE,UACA,MACA,KACA,MACA,KACe;AAEf,UAAM,UAAU,eAAe,UAAU,KAAK,OAAO;AACrD,WAAO,OAAO,YAAY,YAAY,0BAA0B,GAAG,EAAE;AACrE,QAAI,UAAU,OAAO,GAAG;AACtB,aAAO,QAAQ,GAAG,EAAC,MAAM,KAAK,IAAI,MAAqC;AAAA,IACzE;AACA,WAAO,QAAQ,MAAM,IAAI;AAAA,EAC3B;AACF;"}

package/out/zero-server/src/queries/process-queries.js

@@ -27,7 +27,7 @@ async function transform(cb, schema, requestOrJsonBody, lc, apiName) {
     queryIDs = parsed[1].map((r) => r.id);
   } catch (error) {
     lc.error?.(`Failed to parse ${apiName} queries request`, error);
-    const message = `Failed to parse get queries request: ${getErrorMessage(error)}`;
+    const message = `Failed to parse ${apiName} queries request: ${getErrorMessage(error)}`;
     const details = getErrorDetails(error);
     return [
       "transformFailed",