on-zero 0.6.15 → 0.6.17

package/src/createZeroServer.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, test } from 'vitest'
+import { describe, expect, test, vi } from 'vitest'
 
 import { createZeroServer } from './createZeroServer'
 import { zeroHttpFixtureSchema } from './httpPull/fixtureSchema'
@@ -103,7 +103,7 @@ describe('createZeroServer mutation recovery', () => {
         project: {
           mutate: {
             touch: async ({ server }) => {
-              server?.asyncTasks.push(async () => {
+              server?.enqueueTask(async () => {
                 effectRuns++
               })
               throw new Error('rejected')
@@ -129,6 +129,196 @@ describe('createZeroServer mutation recovery', () => {
     expect(effectRuns).toBe(0)
   })
 
+  test('awaits barrier tasks before resolving the push response', async () => {
+    const pg = new FakePgClient()
+    let releaseBarrier!: () => void
+    let markBarrierStarted!: () => void
+    const barrierStarted = new Promise<void>((resolve) => {
+      markBarrierStarted = resolve
+    })
+    const barrier = new Promise<void>((resolve) => {
+      releaseBarrier = resolve
+    })
+    const zeroServer = createZeroServer({
+      schema: zeroHttpFixtureSchema,
+      models: {
+        project: {
+          mutate: {
+            touch: async ({ server }) => {
+              server?.enqueueTask(
+                async () => {
+                  markBarrierStarted()
+                  await barrier
+                },
+                { barrier: true },
+              )
+            },
+          },
+        },
+      },
+      createServerActions: () => ({}),
+      pool: pg as any,
+    })
+
+    let responseResolved = false
+    const resultPromise = zeroServer
+      .handleMutationRequest({
+        authData: null,
+        request: pushRequest(1),
+      })
+      .then((result) => {
+        responseResolved = true
+        return result
+      })
+
+    await barrierStarted
+    await Promise.resolve()
+    expect(responseResolved).toBe(false)
+
+    releaseBarrier()
+    const result = await resultPromise
+    expect((result.response as any).mutations[0].result).toEqual({})
+  })
+
+  test('does not fail the push when a background task rejects', async () => {
+    const pg = new FakePgClient()
+    const error = new Error('background failed')
+    const consoleError = vi.spyOn(console, 'error').mockImplementation(() => {})
+    const zeroServer = createZeroServer({
+      schema: zeroHttpFixtureSchema,
+      models: {
+        project: {
+          mutate: {
+            touch: async ({ server }) => {
+              server?.enqueueTask(async () => {
+                throw error
+              })
+            },
+          },
+        },
+      },
+      createServerActions: () => ({}),
+      pool: pg as any,
+    })
+
+    const result = await zeroServer.handleMutationRequest({
+      authData: null,
+      request: pushRequest(1),
+    })
+
+    expect((result.response as any).mutations[0].result).toEqual({})
+    await vi.waitFor(() => {
+      expect(consoleError).toHaveBeenCalledWith('[on-zero] async task failed', error)
+    })
+    consoleError.mockRestore()
+  })
+
+  test('registers a promise that settles every background task with the request scheduler', async () => {
+    const pg = new FakePgClient()
+    const error = new Error('background failed')
+    const consoleError = vi.spyOn(console, 'error').mockImplementation(() => {})
+    let releaseSibling!: () => void
+    const siblingGate = new Promise<void>((resolve) => {
+      releaseSibling = resolve
+    })
+    let siblingFinished = false
+    let scheduled: Promise<void> | undefined
+    const zeroServer = createZeroServer({
+      schema: zeroHttpFixtureSchema,
+      models: {
+        project: {
+          mutate: {
+            touch: async ({ server }) => {
+              server?.enqueueTask(async () => {
+                throw error
+              })
+              server?.enqueueTask(async () => {
+                await siblingGate
+                siblingFinished = true
+              })
+            },
+          },
+        },
+      },
+      createServerActions: () => ({}),
+      pool: pg as any,
+    })
+
+    const result = await zeroServer.handleMutationRequest({
+      authData: null,
+      request: pushRequest(1),
+      scheduleBackgroundTask: (promise) => {
+        scheduled = promise
+      },
+    })
+
+    expect((result.response as any).mutations[0].result).toEqual({})
+    expect(scheduled).toBeInstanceOf(Promise)
+    expect(siblingFinished).toBe(false)
+
+    let scheduledSettled = false
+    void scheduled!.then(() => {
+      scheduledSettled = true
+    })
+    await Promise.resolve()
+    expect(scheduledSettled).toBe(false)
+
+    releaseSibling()
+    await scheduled
+
+    expect(siblingFinished).toBe(true)
+    expect(consoleError).toHaveBeenCalledWith('[on-zero] async task failed', error)
+    consoleError.mockRestore()
+  })
+
+  test('awaits background tasks when the request has no scheduler', async () => {
+    const pg = new FakePgClient()
+    let markTaskStarted!: () => void
+    const taskStarted = new Promise<void>((resolve) => {
+      markTaskStarted = resolve
+    })
+    let releaseTask!: () => void
+    const taskGate = new Promise<void>((resolve) => {
+      releaseTask = resolve
+    })
+    const zeroServer = createZeroServer({
+      schema: zeroHttpFixtureSchema,
+      models: {
+        project: {
+          mutate: {
+            touch: async ({ server }) => {
+              server?.enqueueTask(async () => {
+                markTaskStarted()
+                await taskGate
+              })
+            },
+          },
+        },
+      },
+      createServerActions: () => ({}),
+      pool: pg as any,
+    })
+
+    let responseResolved = false
+    const resultPromise = zeroServer
+      .handleMutationRequest({
+        authData: null,
+        request: pushRequest(1),
+      })
+      .then((result) => {
+        responseResolved = true
+        return result
+      })
+
+    await taskStarted
+    await Promise.resolve()
+    expect(responseResolved).toBe(false)
+
+    releaseTask()
+    const result = await resultPromise
+    expect((result.response as any).mutations[0].result).toEqual({})
+  })
+
   test('persists alreadyProcessed duplicate results for zero-cache recovery rows', async () => {
     const pg = new FakePgClient()
     const zeroServer = createZeroServer({

package/src/createZeroServer.ts

@@ -15,6 +15,8 @@ import type { Schema as ZeroSchema } from '@rocicorp/zero'
 import type { NodePgTransaction } from '@rocicorp/zero/server/adapters/pg'
 
 export type {
+  BackgroundTaskScheduler,
+  HandleMutationRequestOptions,
   ValidateMutationArgs,
   ValidateMutationFn,
   ValidateQueryArgs,

package/src/createZeroServerCore.ts

@@ -3,6 +3,7 @@ import {
   handleQueryRequest as zeroHandleQueryRequest,
 } from '@rocicorp/zero/server'
 
+import { runAsyncTaskEntries } from './asyncTasks'
 import {
   createAsyncTaskCollector,
   createZeroDirectServerRuntime,
@@ -33,6 +34,15 @@ type PushRequestBody = {
   clientGroupID?: unknown
 }
 
+export type BackgroundTaskScheduler = (promise: Promise<void>) => void
+
+export type HandleMutationRequestOptions = {
+  authData: AuthData | null
+  request: Request
+  scheduleBackgroundTask?: BackgroundTaskScheduler
+  skipAsyncTasks?: boolean
+}
+
 export type PersistAlreadyProcessedArgs = {
   clientGroupID: string
   mutations: AlreadyProcessedMutation[]
@@ -81,16 +91,13 @@ export function createZeroServerCore<
   const handleMutationRequest = async ({
     authData,
     request,
+    scheduleBackgroundTask,
     skipAsyncTasks,
-  }: {
-    authData: AuthData | null
-    request: Request
-    skipAsyncTasks?: boolean
-  }) => {
+  }: HandleMutationRequestOptions) => {
     const tasks = createAsyncTaskCollector()
     const recoveryRequest = request.clone()
     const mutators = createMutators({
-      asyncTasks: tasks.queue,
+      enqueueTask: tasks.enqueueTask,
       can: permissions.can,
       createServerActions,
       environment: 'server',
@@ -110,11 +117,11 @@ export function createZeroServerCore<
     }
 
     if (!skipAsyncTasks && tasks.committed.length) {
-      Promise.all(tasks.committed.map((task) => runWithAuthScope(authData, task))).catch(
-        (err: unknown) => {
-          console.error('[push] async tasks failed', err)
-        },
-      )
+      const entries = tasks.committed.map((entry) => ({
+        ...entry,
+        task: () => runWithAuthScope(authData, entry.task),
+      }))
+      await runAsyncTaskEntries(entries, { background: scheduleBackgroundTask })
     }
 
     return {

package/src/generate.test.ts

@@ -218,6 +218,24 @@ export const allPosts = () => zero.query.post
     const second = await generate({ dir: testDir, silent: true })
     expect(second.filesChanged).toBe(0)
   })
+
+  test('force regenerates without source changes', async () => {
+    writeFileSync(
+      join(testDir, 'models/post.ts'),
+      `export const schema = table('post', { id: string() })`,
+    )
+    writeFileSync(
+      join(testDir, 'queries/post.ts'),
+      `export const allPosts = () => zero.query.post`,
+    )
+    await generate({ dir: testDir, silent: true })
+    const syncedQueriesPath = join(testDir, 'generated/syncedQueries.ts')
+    rmSync(syncedQueriesPath)
+
+    await generate({ dir: testDir, silent: true, force: true })
+
+    expect(existsSync(syncedQueriesPath)).toBe(true)
+  })
 })
 
 describe('mutations', () => {

package/src/generate.ts

@@ -17,6 +17,7 @@ import {
 import type { ExtractedMutation, ModelMutations, SchemaColumn } from './generate-helpers'
 
 const hash = (s: string) => createHash('sha256').update(s).digest('hex')
+const GENERATOR_CACHE_VERSION = '1'
 
 const isGeneratorSourceFile = (name: string) =>
   name.endsWith('.ts') &&
@@ -793,6 +794,8 @@ export interface GenerateOptions {
   after?: string
   /** suppress output */
   silent?: boolean
+  /** ignore the generation cache */
+  force?: boolean
 }
 
 export interface WatchOptions extends GenerateOptions {
@@ -809,7 +812,7 @@ export interface GenerateResult {
 }
 
 export async function generate(options: GenerateOptions): Promise<GenerateResult> {
-  const { dir, after, silent } = options
+  const { dir, after, silent, force } = options
   const baseDir = resolve(dir)
   // support both mutations/ (new) and models/ (legacy) directories
   const mutationsDir = resolve(baseDir, 'mutations')
@@ -832,6 +835,8 @@ export async function generate(options: GenerateOptions): Promise<GenerateResult
   // still re-runs generate on real model/query edits.
   const inputHash = hashInputTree(baseDir, generatedDir)
   if (
+    !force &&
+    generateCache.__generatorVersion === GENERATOR_CACHE_VERSION &&
     generateCache.__inputHash === inputHash &&
     existsSync(resolve(generatedDir, 'models.ts'))
   ) {
@@ -1154,6 +1159,7 @@ export async function generate(options: GenerateOptions): Promise<GenerateResult
   }
 
   // record the input hash + counts so the next boot can skip a no-op regen.
+  generateCache.__generatorVersion = GENERATOR_CACHE_VERSION
   generateCache.__inputHash = inputHash
   generateCache.__counts = JSON.stringify({
     modelCount: allModelFiles.length,

package/src/helpers/createMutators.ts

@@ -25,7 +25,7 @@ export function createMutators<Models extends GenericModels>({
   environment,
   authData,
   createServerActions,
-  asyncTasks = [],
+  enqueueTask = () => {},
   can,
   models,
   validateMutation,
@@ -35,7 +35,7 @@ export function createMutators<Models extends GenericModels>({
   authData: AuthData | null
   can: Can
   models: Models
-  asyncTasks?: Array<() => Promise<void>>
+  enqueueTask?: NonNullable<MutatorContext['server']>['enqueueTask']
   createServerActions?: () => Record<string, any>
   validateMutation?: ValidateMutationFn
   /** valibot schemas keyed by model.mutationName, auto-validates args before running */
@@ -61,7 +61,7 @@ export function createMutators<Models extends GenericModels>({
           environment === 'server'
             ? ({
                 actions: serverActions || {},
-                asyncTasks: asyncTasks || {},
+                enqueueTask,
               } as MutatorContext['server'])
             : undefined,
       }

package/src/helpers/mutatorContext.ts

@@ -13,7 +13,7 @@ const asyncContext =
   contextStore.__onZeroMutatorContext__ ??
   (contextStore.__onZeroMutatorContext__ = createAsyncContext<MutatorContext>())
 
-// lightweight auth-only scope for asyncTasks (where mutation context is gone but authData is needed)
+// lightweight auth-only scope for async tasks (where mutation context is gone but authData is needed)
 const authScopeContext =
   contextStore.__onZeroAuthScopeContext__ ??
   (contextStore.__onZeroAuthScopeContext__ = createAsyncContext<AuthData | null>())

package/src/index.ts

@@ -1,4 +1,5 @@
 export * from './createPermissions'
+export * from './asyncTasks'
 export * from './queryRegistry'
 export * from './helpers/batchQuery'
 export * from './helpers/createMutators'

package/src/server.ts

@@ -1,2 +1,4 @@
 export * from './createZeroServer'
 export * from './createZeroSQLiteServer'
+export * from './asyncTasks'
+export type { AsyncTask, AsyncTaskEntry, AsyncTaskOptions } from './types'

package/src/syncHost.test.ts

@@ -86,7 +86,7 @@ describe('createZeroSyncHostAdapter', () => {
             create: async ({ authData, server, tx }, value: Record<string, unknown>) => {
               expect(authData?.id).toBe('u1')
               await tx.mutate.project.insert(value as never)
-              server?.asyncTasks.push(async () => {
+              server?.enqueueTask(async () => {
                 effectAuthID = getScopedAuthData()?.id as string
               })
             },
@@ -132,7 +132,7 @@ describe('createZeroSyncHostAdapter', () => {
           mutate: {
             reject: async ({ server, tx }, value: Record<string, unknown>) => {
               await tx.mutate.project.insert(value as never)
-              server?.asyncTasks.push(async () => {
+              server?.enqueueTask(async () => {
                 effectRuns++
               })
               throw new Error('denied')

package/src/syncHost.ts

@@ -23,7 +23,7 @@ import { runWithAuthScope } from './helpers/mutatorContext'
 import { runWithQueryContext } from './helpers/queryContext'
 import { setEnvironment, setSchema } from './state'
 
-import type { AuthData, GenericModels } from './types'
+import type { AsyncTaskEntry, AuthData, GenericModels } from './types'
 import type { Schema as ZeroSchema } from '@rocicorp/zero'
 
 export type SyncHostJsonValue =
@@ -147,9 +147,11 @@ export function createZeroSyncHostAdapter<
     for (const mutatorName of Object.keys(model.mutate ?? {})) {
       mutators[`${modelName}|${mutatorName}`] = async (executor, args, context) => {
         const authData = mapAuthData(context.claims)
-        const asyncTasks: Array<() => Promise<void>> = []
+        const asyncTaskEntries: AsyncTaskEntry[] = []
         const modelMutators = createMutators({
-          asyncTasks,
+          enqueueTask(task, opts) {
+            asyncTaskEntries.push({ task, barrier: opts?.barrier === true })
+          },
           authData,
           can: permissions.can,
           createServerActions: options.createServerActions,
@@ -181,7 +183,7 @@ export function createZeroSyncHostAdapter<
         } catch (error) {
           throw asMutationApplicationError(error)
         }
-        for (const task of asyncTasks) {
+        for (const { task } of asyncTaskEntries) {
           context.defer(() => runWithAuthScope(authData, task))
         }
       }

package/src/types.ts

@@ -60,6 +60,17 @@ export type ServerActions =
 
 export type QueryBuilder = SchemaQuery<Schema>
 
+export type AsyncTask = () => Promise<void>
+
+export type AsyncTaskOptions = {
+  barrier?: boolean
+}
+
+export type AsyncTaskEntry = {
+  task: AsyncTask
+  barrier: boolean
+}
+
 /**
  * ➗0️⃣ END OVERRIDDEN TYPES
  */
@@ -71,7 +82,16 @@ export type MutatorContext = {
   environment: 'server' | 'client'
   server?: {
     actions: ServerActions
-    asyncTasks: Array<() => Promise<void>>
+    /**
+     * Schedules work after the mutation transaction commits. Tasks run in the
+     * background by default, following Zero's async task model, so they do not
+     * block the push response.
+     *
+     * Set `barrier: true` only when the client's next writes depend on the
+     * effect, such as provisioning a namespace before the client writes
+     * through a new instance. Barrier tasks finish before the push response.
+     */
+    enqueueTask(task: AsyncTask, opts?: AsyncTaskOptions): void
   }
   can: Can
 }
@@ -112,8 +132,6 @@ export type Can = <PWhere extends Where>(
   obj: string | Record<string, unknown>,
 ) => Promise<void>
 
-export type AsyncAction = () => Promise<void>
-
 type GenericTable = TableBuilderWithColumns<any>
 
 type GetTableSchema<TS extends GenericTable> =

package/src/vite-plugin.ts

@@ -62,6 +62,7 @@ export function onZeroPlugin(options: OnZeroPluginOptions = {}): Plugin[] {
       dir: dataDir,
       after: options.after,
       silent,
+      force: options.force,
     })
 
   return [

package/test-fixtures/server-return-types.ts

@@ -1,4 +1,10 @@
-import { createZeroServer } from 'on-zero/server'
+import {
+  createZeroServer,
+  runAsyncTaskEntries,
+  type AsyncTaskEntry,
+  type BackgroundTaskScheduler,
+  type HandleMutationRequestOptions,
+} from 'on-zero/server'
 import { createZeroSQLiteServer, type SqlStatementMetadata } from 'on-zero/sqlite'
 
 import type { Config, MutatorContext } from 'on-zero'
@@ -30,6 +36,7 @@ type SQLiteServer = ReturnType<typeof createZeroSQLiteServer<ZeroSchema, Models,
 
 declare const postgresServer: PostgresServer
 declare const sqliteServer: SQLiteServer
+declare const taskEntries: AsyncTaskEntry[]
 
 const authData: Config['authData'] = {
   email: 'admin@example.com',
@@ -44,6 +51,22 @@ const sqliteWrite: SqlStatementMetadata = {
 }
 void sqliteWrite
 
+void runAsyncTaskEntries(taskEntries, {
+  background(promise) {
+    void promise
+  },
+})
+
+const scheduleBackgroundTask: BackgroundTaskScheduler = (promise) => {
+  void promise
+}
+const mutationRequest: HandleMutationRequestOptions = {
+  authData,
+  request: new Request('https://example.com/api/zero/push'),
+  scheduleBackgroundTask,
+}
+void postgresServer.handleMutationRequest(mutationRequest)
+
 postgresServer.mutate.project.create(
   { id: 'pg' },
   { authData: { email: authData.email, id: authData.id, role: authData.role } },

package/types/asyncTasks.d.ts

@@ -0,0 +1,7 @@
+import type { AsyncTaskEntry } from './types';
+export type RunAsyncTaskEntriesOptions = {
+    /** Receives the background-task promise. Omit this to await all entries. */
+    background?: (promise: Promise<void>) => void;
+};
+export declare function runAsyncTaskEntries(entries: readonly AsyncTaskEntry[], { background }?: RunAsyncTaskEntriesOptions): Promise<void>;
+//# sourceMappingURL=asyncTasks.d.ts.map

package/types/asyncTasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncTasks.d.ts","sourceRoot":"","sources":["../src/asyncTasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,MAAM,MAAM,0BAA0B,GAAG;IACvC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;CAC9C,CAAA;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,EAAE,UAAU,EAAE,GAAE,0BAA+B,GAC9C,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/types/createZeroDirectServer.d.ts

@@ -1,5 +1,5 @@
 import { createPermissions } from './createPermissions';
-import type { AdminRoleMode, AsyncAction, AuthData, GenericModels, MutatorContext, QueryBuilder, Transaction } from './types';
+import type { AdminRoleMode, AsyncTask, AsyncTaskEntry, AsyncTaskOptions, AuthData, GenericModels, MutatorContext, QueryBuilder, Transaction } from './types';
 import type { AnyQueryRegistry, HumanReadable, Query, Schema as ZeroSchema } from '@rocicorp/zero';
 import type { Database } from '@rocicorp/zero/server';
 type MutateAuthData = Pick<AuthData, 'email' | 'id'> & Partial<AuthData>;
@@ -67,9 +67,9 @@ export type ZeroDirectServer<Schema extends ZeroSchema, Models extends GenericMo
     query: <R>(cb: (q: QueryBuilder) => Query<any, Schema, R>, authData?: AuthData | null) => Promise<HumanReadable<R>>;
 };
 export declare function createAsyncTaskCollector(): {
-    committed: AsyncAction[];
+    committed: AsyncTaskEntry[];
+    enqueueTask: (task: AsyncTask, opts?: AsyncTaskOptions) => void;
     lifecycle: TransactionAttemptLifecycle;
-    queue: AsyncAction[];
 };
 export declare function createZeroDirectServerRuntime<Schema extends ZeroSchema, Models extends GenericModels, ServerActions extends Record<string, unknown>>({ createDatabase, createServerActions, defaultAllowAdminRole, defaultMutateAuthData, models, mutations: mutationValidators, queries, schema, validateMutation, validateQuery, }: ZeroDirectServerOptions<Schema, Models, ServerActions>): {
     permissions: ReturnType<typeof createPermissions<Schema>>;

package/types/createZeroDirectServer.d.ts.map

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

package/types/createZeroServer.d.ts

@@ -2,7 +2,7 @@ import type { ZeroServer, ZeroServerCommonOptions } from './createZeroServerCore
 import type { GenericModels } from './types';
 import type { Schema as ZeroSchema } from '@rocicorp/zero';
 import type { NodePgTransaction } from '@rocicorp/zero/server/adapters/pg';
-export type { ValidateMutationArgs, ValidateMutationFn, ValidateQueryArgs, ValidateQueryFn, } from './createZeroServerCore';
+export type { BackgroundTaskScheduler, HandleMutationRequestOptions, ValidateMutationArgs, ValidateMutationFn, ValidateQueryArgs, ValidateQueryFn, } from './createZeroServerCore';
 export declare function createZeroServer<Schema extends ZeroSchema, Models extends GenericModels, ServerActions extends Record<string, unknown>>({ database, pool: externalPool, ...options }: ZeroServerCommonOptions<Schema, Models, ServerActions> & {
     /**
      * Optional pre-built Pool-like object, such as a PGlite wrapper.

package/types/createZeroServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createZeroServer.d.ts","sourceRoot":"","sources":["../src/createZeroServer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,UAAU,EACV,uBAAuB,EAExB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AAE1E,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,wBAAwB,CAAA;AAE/B,wBAAgB,gBAAgB,CAC9B,MAAM,SAAS,UAAU,EACzB,MAAM,SAAS,aAAa,EAC5B,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7C,EACA,QAAQ,EACR,IAAI,EAAE,YAAY,EAClB,GAAG,OAAO,EACX,EAAE,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,GAAG;IAC1D;;;OAGG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,CA8B5C"}
+{"version":3,"file":"createZeroServer.d.ts","sourceRoot":"","sources":["../src/createZeroServer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,UAAU,EACV,uBAAuB,EAExB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AAE1E,YAAY,EACV,uBAAuB,EACvB,4BAA4B,EAC5B,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,wBAAwB,CAAA;AAE/B,wBAAgB,gBAAgB,CAC9B,MAAM,SAAS,UAAU,EACzB,MAAM,SAAS,aAAa,EAC5B,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7C,EACA,QAAQ,EACR,IAAI,EAAE,YAAY,EAClB,GAAG,OAAO,EACX,EAAE,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,GAAG;IAC1D;;;OAGG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,CA8B5C"}

package/types/createZeroServerCore.d.ts

@@ -11,6 +11,13 @@ type AlreadyProcessedMutation = {
         details?: unknown;
     };
 };
+export type BackgroundTaskScheduler = (promise: Promise<void>) => void;
+export type HandleMutationRequestOptions = {
+    authData: AuthData | null;
+    request: Request;
+    scheduleBackgroundTask?: BackgroundTaskScheduler;
+    skipAsyncTasks?: boolean;
+};
 export type PersistAlreadyProcessedArgs = {
     clientGroupID: string;
     mutations: AlreadyProcessedMutation[];
@@ -24,11 +31,7 @@ export declare function createZeroServerCore<Schema extends ZeroSchema, Models e
     transaction: <CB extends (tx: import("./types").Transaction) => Promise<any>, Returns extends CB extends (tx: import("./types").Transaction) => Promise<infer X> ? X : never>(query: CB) => Promise<Returns>;
     mutate: import("./createZeroDirectServer").ServerMutate<Models>;
     query: <R>(cb: (q: import("./types").QueryBuilder) => import("@rocicorp/zero").Query<any, Schema, R>, authData?: {} | null | undefined) => Promise<import("@rocicorp/zero").HumanReadable<R>>;
-    handleMutationRequest: ({ authData, request, skipAsyncTasks, }: {
-        authData: AuthData | null;
-        request: Request;
-        skipAsyncTasks?: boolean;
-    }) => Promise<{
+    handleMutationRequest: ({ authData, request, scheduleBackgroundTask, skipAsyncTasks, }: HandleMutationRequestOptions) => Promise<{
         response: {
             userID?: string | null | undefined;
             kind: "MutateResponse";
@@ -157,7 +160,7 @@ export declare function createZeroServerCore<Schema extends ZeroSchema, Models e
             origin: "zeroCache";
             reason: "parse" | "timeout" | "internal";
         };
-        asyncTasks: import("./types").AsyncAction[];
+        asyncTasks: import("./types").AsyncTaskEntry[];
     }>;
     handleQueryRequest: ({ authData, request, }: {
         authData: AuthData | null;