on-zero 0.9.2 → 0.9.4

package/src/createZeroClient.tsx

@@ -291,9 +291,116 @@ export function createZeroClientInternal<
 
   const DisabledContext = createContext<QueryControlMode>(false)
 
+  // mutators never vary per mount: auth is read dynamically through
+  // getAuthData() at mutation time. built once, lazily, so the provider and
+  // connectHeadless construct identical instances without either one forcing
+  // the work at createZeroClient() time.
+  let clientMutators: ReturnType<typeof createMutators> | null = null
+  function getClientMutators() {
+    clientMutators ??= createMutators({
+      models,
+      environment: 'client',
+      authData: null,
+      can: permissionsHelpers.can,
+    })
+    return clientMutators
+  }
+
+  type ConstructZeroInstanceArgs = {
+    options: Omit<ZeroOptions<Schema, ZeroMutators>, 'schema' | 'mutators'>
+    transport?: ZeroProviderTransport
+    beforeReload?: () => Promise<void>
+    scheduleReload?: (ctx: ScheduleReloadContext) => void
+    guardStorage?: RecoveryGuardStorage
+    benignLogPatterns?: readonly ZeroLogPattern[]
+  }
+
+  // build a Zero instance with on-zero's recovery wiring. shared by the
+  // provider's rotation effect and by connectHeadless so a non-react host gets
+  // the same instance the app gets, rather than a parallel construction that
+  // can drift.
+  function constructZeroInstance({
+    options,
+    transport,
+    beforeReload,
+    scheduleReload,
+    guardStorage,
+    benignLogPatterns,
+  }: ConstructZeroInstanceArgs): ZeroInstance {
+    // install before construction so the instance's first connect goes through
+    // HTTP. ensureHttpPullTransport is per-origin idempotent by design (a
+    // rotation would otherwise chain shims), so repeat calls reuse.
+    if (transport) {
+      // same precedence as zero's own getServer (cacheURL is the current
+      // option name; server is its deprecated alias)
+      const serverURL = options.cacheURL ?? options.server
+      if (typeof serverURL !== 'string') {
+        throw new Error(`client transport requires a server URL`)
+      }
+      transport.install(serverURL)
+    }
+    // recovery closures reach the instance through this ref so they always
+    // delete the CURRENT instance's own store (set right after construction;
+    // the handlers only fire post-mount).
+    const instanceRef: { current: ZeroInstance | null } = { current: null }
+    const recoveryDeps: ZeroRecoveryDeps = {
+      deleteLocalState: () => deleteZeroInstance(instanceRef.current),
+      zeroEvents,
+      beforeReload,
+      scheduleReload,
+      guardStorage,
+      benignLogPatterns: [
+        ...(transport?.logClassifications?.benign ?? []),
+        ...(benignLogPatterns ?? []),
+      ],
+      onRecovery: () => mutationLifecycle.fence(),
+    }
+    const recovery = makeZeroRecovery(recoveryDeps)
+    const createdInstance = new ZeroClient<Schema, ZeroMutators>({
+      kvStore: 'mem',
+      ...options,
+      schema,
+      // @ts-expect-error same erasure ZeroProvider needed
+      mutators: getClientMutators(),
+      // when the consumer brings no logSink, install ours: it preserves Zero's
+      // console output AND watches for the local-store-lost signature. a
+      // consumer with its own logSink owns log-based recovery (no double-fire
+      // with e.g. soot's origin-gated recovery).
+      logSink: options.logSink ?? composeRecoveryLogSink(recoveryDeps),
+      // consumer handlers win; otherwise on-zero's default self-healing
+      // recovery covers EVERY reason (drop local state + reload, guarded) —
+      // passing these to Zero disables its built-in reload, so any reason we
+      // left unhandled would fatal-blank the app forever.
+      onUpdateNeeded: options.onUpdateNeeded ?? recovery.onUpdateNeeded,
+      onClientStateNotFound:
+        options.onClientStateNotFound ?? recovery.onClientStateNotFound,
+    })
+    instanceRef.current = createdInstance
+    return createdInstance
+  }
+
   let latestZeroInstance: ZeroInstance | null = null
   const zeroReadyWaiters = new Set<(instance: ZeroInstance) => void>()
 
+  // publish the active instance through the stable facade and query runner.
+  // the provider calls this during render (before descendant effects do
+  // imperative work) and connectHeadless calls it directly — the `zero` proxy,
+  // run(), and waitForZero() resolve identically either way.
+  function publishZeroInstance(zeroInstance: ZeroInstance): boolean {
+    if (zeroInstance === latestZeroInstance) return false
+    latestZeroInstance = zeroInstance
+    mutationLifecycle.activate()
+    const runner: ZeroRunner = (query, options) => zeroInstance.run(query as any, options)
+    // the instance-keyed runner is what run() dispatches owned namespaces to;
+    // the global runner stays as the ambient fallback (inline zql)
+    instance.runner = runner
+    setRunner(runner)
+    const waiters = [...zeroReadyWaiters]
+    zeroReadyWaiters.clear()
+    for (const onReady of waiters) onReady(zeroInstance)
+    return true
+  }
+
   function waitForZero({ signal }: WaitForZeroOptions = {}): Promise<ZeroInstance> {
     if (latestZeroInstance) return Promise.resolve(latestZeroInstance)
     if (signal?.aborted) {
@@ -733,19 +840,6 @@ export function createZeroClientInternal<
     // (mutations read auth dynamically via getAuthData() to avoid stale closure race condition)
     setAuthData(authData)
 
-    // mutators are stable — auth is read dynamically via getAuthData() at mutation
-    // time, so we don't need to recreate them (or the Zero instance) on auth change.
-    // setAuthData() above already ensures getAuthData() returns current auth.
-    const mutators = useMemo(() => {
-      return createMutators({
-        models,
-        environment: 'client',
-        authData: null,
-        can: permissionsHelpers.can,
-      })
-      // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [])
-
     // host-scoped storage: composed here so embedding hosts isolate co-located
     // apps without app code carrying host globals. static per page load — the
     // host injects the scope before the app's module graph evaluates.
@@ -839,19 +933,6 @@ export function createZeroClientInternal<
         'schema' | 'mutators'
       >
 
-      // install before construction so the instance's first connect goes
-      // through HTTP. per-origin idempotence is strict: a second provider may
-      // reuse this transport only when every behavior option matches.
-      if (transport) {
-        // same precedence as zero's own getServer (cacheURL is the current
-        // option name; server is its deprecated alias)
-        const serverURL = options.cacheURL ?? options.server
-        if (typeof serverURL !== 'string') {
-          throw new Error(`client transport requires a server URL`)
-        }
-        transport.install(serverURL)
-      }
-
       if (cached?.key !== instanceKey) {
         if (cached) {
           // the replacement's SetZeroInstance effect publishes one version
@@ -860,44 +941,17 @@ export function createZeroClientInternal<
           mutationLifecycle.fence()
           cached.instance.close()
         }
-        // recovery closures reach the instance through this ref so they always
-        // delete the CURRENT instance's own store (set right after construction;
-        // the handlers only fire post-mount).
-        const instanceRef: { current: ZeroInstance | null } = { current: null }
-        const recoveryDeps: ZeroRecoveryDeps = {
-          deleteLocalState: () => deleteZeroInstance(instanceRef.current),
-          zeroEvents,
-          beforeReload,
-          scheduleReload,
-          guardStorage,
-          benignLogPatterns: [
-            ...(transport?.logClassifications?.benign ?? []),
-            ...(benignLogPatterns ?? []),
-          ],
-          onRecovery: () => mutationLifecycle.fence(),
+        cached = {
+          key: instanceKey,
+          instance: constructZeroInstance({
+            options,
+            transport,
+            beforeReload,
+            scheduleReload,
+            guardStorage,
+            benignLogPatterns,
+          }),
         }
-        const recovery = makeZeroRecovery(recoveryDeps)
-        const createdInstance = new ZeroClient<Schema, ZeroMutators>({
-          kvStore: 'mem',
-          ...options,
-          schema,
-          // @ts-expect-error same erasure ZeroProvider needed
-          mutators,
-          // when the consumer brings no logSink, install ours: it preserves
-          // Zero's console output AND watches for the local-store-lost signature.
-          // a consumer with its own logSink owns log-based recovery (no
-          // double-fire with e.g. soot's origin-gated recovery).
-          logSink: options.logSink ?? composeRecoveryLogSink(recoveryDeps),
-          // consumer handlers win; otherwise on-zero's default self-healing
-          // recovery covers EVERY reason (drop local state + reload, guarded) —
-          // passing these to Zero disables its built-in reload, so any reason we
-          // left unhandled would fatal-blank the app forever.
-          onUpdateNeeded: options.onUpdateNeeded ?? recovery.onUpdateNeeded,
-          onClientStateNotFound:
-            options.onClientStateNotFound ?? recovery.onClientStateNotFound,
-        })
-        instanceRef.current = createdInstance
-        cached = { key: instanceKey, instance: createdInstance }
         cachedZero = cached
       }
       setInstance(cached.instance)
@@ -964,21 +1018,8 @@ export function createZeroClientInternal<
   const SetZeroInstance = () => {
     const zeroInstance = useZero<Schema, ZeroMutators>()
 
-    // publish the active external instance through the stable facade and query
-    // runner before descendant effects perform imperative work.
-    if (zeroInstance !== latestZeroInstance) {
-      latestZeroInstance = zeroInstance
-      mutationLifecycle.activate()
-      const runner: ZeroRunner = (query, options) =>
-        zeroInstance.run(query as any, options)
-      // the instance-keyed runner is what run() dispatches owned namespaces
-      // to; the global runner stays as the ambient fallback (inline zql)
-      instance.runner = runner
-      setRunner(runner)
-      const waiters = [...zeroReadyWaiters]
-      zeroReadyWaiters.clear()
-      for (const onReady of waiters) onReady(zeroInstance)
-    }
+    // publish before descendant effects perform imperative work.
+    publishZeroInstance(zeroInstance)
 
     useEffect(() => {
       zeroInstanceVersion?.emit(zeroInstanceVersion.value + 1)
@@ -987,13 +1028,203 @@ export function createZeroClientInternal<
     return null
   }
 
+  // connect WITHOUT react. same construction and same publication the provider
+  // uses, so `zero`, run(), getQuery(), and waitForZero() all resolve exactly as
+  // they do in a mounted app — which is what lets code written against the
+  // module-global facade run unchanged in a worker, a durable object, or a
+  // script. the caller owns the lifetime and must close().
+  //
+  // there is no react tree here, so nothing owns rotation: an identity change
+  // means close this instance and connect a new one. the host is expected to be
+  // scoped to a single identity for its lifetime (one project, one user).
+  function connectHeadless(
+    props: Omit<ZeroOptions<Schema, ZeroMutators>, 'schema' | 'mutators'> & {
+      authData?: AuthData | null
+      transport?: ZeroProviderTransport
+      beforeReload?: () => Promise<void>
+      scheduleReload?: (ctx: ScheduleReloadContext) => void
+      guardStorage?: RecoveryGuardStorage
+      benignLogPatterns?: readonly ZeroLogPattern[]
+      // mint a fresh token. REQUIRED for any host that outlives its token: zero
+      // parks in needs-auth and will not resume until the auth string changes,
+      // so without this a long-lived headless host answers 401 forever.
+      refreshAuth?: () => Promise<string | undefined>
+    }
+  ): { zero: ZeroInstance; close: () => Promise<void> } {
+    const {
+      authData,
+      transport,
+      beforeReload,
+      scheduleReload,
+      guardStorage,
+      benignLogPatterns,
+      refreshAuth,
+      ...options
+    } = props
+    // mutations read auth dynamically through getAuthData(), so this has to be
+    // set before the first mutation exactly as the provider sets it in render.
+    setAuthData((authData ?? null) as AuthData)
+    const zeroInstance = constructZeroInstance({
+      options,
+      transport,
+      beforeReload,
+      scheduleReload,
+      guardStorage,
+      benignLogPatterns,
+    })
+    publishZeroInstance(zeroInstance)
+    zeroInstanceVersion?.emit(zeroInstanceVersion.value + 1)
+    const unwatch = watchZeroConnection({ zeroInstance, refreshAuth })
+    return {
+      zero: zeroInstance,
+      close: async () => {
+        unwatch()
+        clearZeroInstanceReferences(zeroInstance)
+        mutationLifecycle.fence()
+        await zeroInstance.close()
+      },
+    }
+  }
+
+  // watch a zero instance's connection and own the generic recovery: stale-poke
+  // and transport reconnects, needs-auth token refresh, reconnect-status events,
+  // and optional dataset mirroring. plain subscription, no react — a headless
+  // host needs exactly this and previously got none of it, so its token expiry
+  // ended as a permanent 401 with no way back.
+  function watchZeroConnection(args: {
+    zeroInstance: ZeroInstance
+    refreshAuth?: () => Promise<string | undefined>
+    exposeDataset?: boolean
+    datasetCacheUrl?: string
+  }): () => void {
+    const { zeroInstance, refreshAuth, exposeDataset, datasetCacheUrl } = args
+    let prevState = zeroInstance.connection.state.current.name
+    let hasConnected = false
+    const currentReconnect =
+      zeroEvents.value?.type === 'reconnect' && zeroEvents.value.status !== 'connected'
+        ? zeroEvents.value
+        : null
+    let reconnect: { reasonKey: ZeroReconnectReasonKey; reason: string } | null =
+      currentReconnect
+        ? { reasonKey: currentReconnect.reasonKey, reason: currentReconnect.reason }
+        : null
+    // one reconnect per distinct recoverable error / one refresh per needs-auth
+    // transition, so a stuck state doesn't retry-storm.
+    let recoverableError: string | null = null
+    let needsAuth = false
+
+    const handle = () => {
+      const state = zeroInstance.connection.state.current
+      const name = state.name
+      const reason =
+        'reason' in state && typeof state.reason === 'string' ? state.reason : ''
+
+      // mirror connection state onto the body dataset for e2e/diagnostics
+      // (enabled on one instance so instances don't clobber each other).
+      if (exposeDataset && typeof document !== 'undefined' && document.body) {
+        document.body.dataset.zeroState = name
+        if (datasetCacheUrl) document.body.dataset.zeroCacheUrl = datasetCacheUrl
+        if (reason) document.body.dataset.zeroReason = reason.slice(0, 200)
+        else delete document.body.dataset.zeroReason
+        if (name === 'connected') document.body.dataset.zeroConnected = 'true'
+        else delete document.body.dataset.zeroConnected
+      }
+
+      if (name === 'connected') {
+        hasConnected = true
+        recoverableError = null
+        if (reconnect) {
+          reconnect = null
+          emitReconnectStatus({ type: 'reconnect', status: 'connected' })
+        }
+      }
+
+      const reconnectReasonKey: ZeroReconnectReasonKey | undefined = reason.includes(
+        'ServerOverloaded'
+      )
+        ? 'server-overloaded'
+        : reason.includes('Failed to fetch') ||
+            reason.includes('fetch failed') ||
+            reason.includes('NetworkError when attempting to fetch resource') ||
+            reason.includes('Network request failed') ||
+            reason.includes('Load failed')
+          ? 'transport'
+          : undefined
+
+      // stale-poke and paused transport errors both resume the existing client.
+      // ServerOverloaded remains in Zero's own retry/backoff loop.
+      if (
+        name === 'error' &&
+        (isRecoverableZeroStalePokeMessage(reason) || reconnectReasonKey)
+      ) {
+        if (recoverableError !== reason) {
+          recoverableError = reason
+          reconnect = { reasonKey: reconnectReasonKey ?? 'transport', reason }
+          emitReconnectStatus({ type: 'reconnect', status: 'trying', ...reconnect })
+          void Promise.resolve(zeroInstance.connection?.connect?.()).catch(() => {})
+        }
+        return
+      }
+      if (name !== 'error') recoverableError = null
+
+      if (name === 'connecting' && (reconnect || hasConnected || Boolean(reason))) {
+        reconnect = {
+          reasonKey: reconnectReasonKey ?? reconnect?.reasonKey ?? 'transport',
+          reason: reason || reconnect?.reason || 'connection interrupted',
+        }
+        emitReconnectStatus({
+          type: 'reconnect',
+          status: reason ? 'waiting' : 'trying',
+          ...reconnect,
+        })
+      } else if (name === 'disconnected' && (reconnect || hasConnected)) {
+        reconnect = {
+          reasonKey: reconnect?.reasonKey ?? 'transport',
+          reason: reason || reconnect?.reason || 'connection interrupted',
+        }
+        emitReconnectStatus({ type: 'reconnect', status: 'waiting', ...reconnect })
+      }
+
+      // needs-auth: the token expired and zero won't auto-resume unless the
+      // auth string changes. refresh it and reconnect in place, once.
+      if (name === 'needs-auth') {
+        if (refreshAuth && !needsAuth) {
+          needsAuth = true
+          void refreshAuth()
+            .then((token) => {
+              if (token) zeroInstance.connection?.connect?.({ auth: token })
+            })
+            .catch(() => {})
+        }
+      } else {
+        needsAuth = false
+      }
+
+      if (name !== prevState) {
+        prevState = name
+        if (name === 'error' || name === 'needs-auth') {
+          zeroEvents.emit({
+            type: 'error',
+            reasonKey:
+              name === 'needs-auth' ? 'connection-needs-auth' : 'connection-error',
+            message: reason || name,
+          })
+        }
+      }
+    }
+
+    const unsubscribe = zeroInstance.connection.state.subscribe(handle)
+    handle()
+    return unsubscribe
+  }
+
   // monitors connection state and emits events (replaces onError callback removed
   // in 0.25). also owns the generic-Zero connection recovery that used to live in
   // each consumer: stale-poke reconnect, needs-auth token refresh, and optional
   // e2e dataset bookkeeping.
   const ConnectionMonitor = memo(
     ({
-      zeroEvents,
+      zeroEvents: _zeroEvents,
       refreshAuth,
       exposeDataset,
       datasetCacheUrl,
@@ -1004,146 +1235,19 @@ export function createZeroClientInternal<
       datasetCacheUrl?: string
     }) => {
       const zeroInstance = useZero<Schema, ZeroMutators>()
-      const state = useConnectionState()
-      const prevState = useRef(state.name)
-      const hasConnectedRef = useRef(false)
-      const currentReconnect =
-        zeroEvents.value?.type === 'reconnect' && zeroEvents.value.status !== 'connected'
-          ? zeroEvents.value
-          : null
-      const reconnectRef = useRef<{
-        reasonKey: ZeroReconnectReasonKey
-        reason: string
-      } | null>(
-        currentReconnect
-          ? {
-              reasonKey: currentReconnect.reasonKey,
-              reason: currentReconnect.reason,
-            }
-          : null
+      // the recovery logic itself is not react's — it is a subscription to the
+      // instance's connection state, shared with connectHeadless so a non-react
+      // host recovers identically instead of going dark on token expiry.
+      useEffect(
+        () =>
+          watchZeroConnection({
+            zeroInstance,
+            refreshAuth,
+            exposeDataset,
+            datasetCacheUrl,
+          }),
+        [zeroInstance, refreshAuth, exposeDataset, datasetCacheUrl]
       )
-      // one reconnect per distinct recoverable error / one refresh per
-      // needs-auth transition, so a stuck state doesn't retry-storm.
-      const recoverableErrorRef = useRef<string | null>(null)
-      const needsAuthRef = useRef(false)
-
-      useEffect(() => {
-        const name = state.name
-        const reason =
-          'reason' in state && typeof state.reason === 'string' ? state.reason : ''
-
-        // mirror connection state onto the body dataset for e2e/diagnostics
-        // (enabled on one instance so instances don't clobber each other).
-        if (exposeDataset && typeof document !== 'undefined' && document.body) {
-          document.body.dataset.zeroState = name
-          if (datasetCacheUrl) document.body.dataset.zeroCacheUrl = datasetCacheUrl
-          if (reason) document.body.dataset.zeroReason = reason.slice(0, 200)
-          else delete document.body.dataset.zeroReason
-          if (name === 'connected') document.body.dataset.zeroConnected = 'true'
-          else delete document.body.dataset.zeroConnected
-        }
-
-        if (name === 'connected') {
-          hasConnectedRef.current = true
-          recoverableErrorRef.current = null
-          if (reconnectRef.current) {
-            reconnectRef.current = null
-            emitReconnectStatus({ type: 'reconnect', status: 'connected' })
-          }
-        }
-
-        const reconnectReasonKey: ZeroReconnectReasonKey | undefined = reason.includes(
-          'ServerOverloaded'
-        )
-          ? 'server-overloaded'
-          : reason.includes('Failed to fetch') ||
-              reason.includes('fetch failed') ||
-              reason.includes('NetworkError when attempting to fetch resource') ||
-              reason.includes('Network request failed') ||
-              reason.includes('Load failed')
-            ? 'transport'
-            : undefined
-
-        // stale-poke and paused transport errors both resume the existing
-        // client. ServerOverloaded remains in Zero's own retry/backoff loop.
-        if (
-          name === 'error' &&
-          (isRecoverableZeroStalePokeMessage(reason) || reconnectReasonKey)
-        ) {
-          if (recoverableErrorRef.current !== reason) {
-            recoverableErrorRef.current = reason
-            reconnectRef.current = {
-              reasonKey: reconnectReasonKey ?? 'transport',
-              reason,
-            }
-            emitReconnectStatus({
-              type: 'reconnect',
-              status: 'trying',
-              ...reconnectRef.current,
-            })
-            void Promise.resolve(zeroInstance.connection?.connect?.()).catch(() => {})
-          }
-          return
-        }
-        if (name !== 'error') recoverableErrorRef.current = null
-
-        if (
-          name === 'connecting' &&
-          (reconnectRef.current || hasConnectedRef.current || Boolean(reason))
-        ) {
-          reconnectRef.current = {
-            reasonKey:
-              reconnectReasonKey ?? reconnectRef.current?.reasonKey ?? 'transport',
-            reason: reason || reconnectRef.current?.reason || 'connection interrupted',
-          }
-          emitReconnectStatus({
-            type: 'reconnect',
-            status: reason ? 'waiting' : 'trying',
-            ...reconnectRef.current,
-          })
-        } else if (
-          name === 'disconnected' &&
-          (reconnectRef.current || hasConnectedRef.current)
-        ) {
-          reconnectRef.current = {
-            reasonKey: reconnectRef.current?.reasonKey ?? 'transport',
-            reason: reason || reconnectRef.current?.reason || 'connection interrupted',
-          }
-          emitReconnectStatus({
-            type: 'reconnect',
-            status: 'waiting',
-            ...reconnectRef.current,
-          })
-        }
-
-        // needs-auth: the token expired and zero won't auto-resume unless the
-        // auth string changes. refresh it and reconnect in place, once.
-        if (name === 'needs-auth') {
-          if (refreshAuth && !needsAuthRef.current) {
-            needsAuthRef.current = true
-            void refreshAuth()
-              .then((token) => {
-                if (token) zeroInstance.connection?.connect?.({ auth: token })
-              })
-              .catch(() => {})
-          }
-        } else {
-          needsAuthRef.current = false
-        }
-
-        if (name !== prevState.current) {
-          prevState.current = name
-          if (name === 'error' || name === 'needs-auth') {
-            zeroEvents.emit({
-              type: 'error',
-              reasonKey:
-                name === 'needs-auth' ? 'connection-needs-auth' : 'connection-error',
-              message: reason || name,
-            })
-          }
-        }
-      }, [state, zeroEvents, zeroInstance, refreshAuth, exposeDataset, datasetCacheUrl])
-
       return null
     }
   )
@@ -1202,6 +1306,7 @@ export function createZeroClientInternal<
     zeroEvents,
     reloadPage,
     ProvideZero,
+    connectHeadless,
     ControlQueries,
     useQuery,
     useQueryDirect,

package/src/zeroRunner.ts

@@ -37,7 +37,7 @@ export function getAmbientRunner(instance?: { runner: ZeroRunner | null }): Zero
 
   if (!runner) {
     throw new Error(
-      'Zero runner not initialized. Ensure ProvideZero is mounted or server bindings are active.'
+      'Zero runner not initialized. Ensure ProvideZero is mounted, connectHeadless() was called, or server bindings are active.'
     )
   }
 

package/types/createZeroClient.d.ts

@@ -50,6 +50,18 @@ export declare function createZeroClient<Schema extends ZeroSchema, Models exten
         refreshAuth?: (() => Promise<string | undefined>) | undefined;
         connectionDataset?: boolean;
     }) => import("react").JSX.Element;
+    connectHeadless: (props: Omit<ZeroOptions<Schema, GetZeroMutators<Models>>, "schema" | "mutators"> & {
+        authData?: {} | null | undefined;
+        transport?: ZeroProviderTransport;
+        beforeReload?: (() => Promise<void>) | undefined;
+        scheduleReload?: ((ctx: ScheduleReloadContext) => void) | undefined;
+        guardStorage?: RecoveryGuardStorage;
+        benignLogPatterns?: readonly ZeroLogPattern[];
+        refreshAuth?: (() => Promise<string | undefined>) | undefined;
+    }) => {
+        zero: ZeroClient<Schema, GetZeroMutators<Models>, unknown>;
+        close: () => Promise<void>;
+    };
     ControlQueries: ({ children, action, whenDisabled, }: {
         children: ReactNode;
         action?: "enable" | "disable";
@@ -100,6 +112,18 @@ export declare function createZeroClientInternal<Schema extends ZeroSchema, Mode
         refreshAuth?: () => Promise<string | undefined>;
         connectionDataset?: boolean;
     }) => import("react").JSX.Element;
+    connectHeadless: (props: Omit<ZeroOptions<Schema, GetZeroMutators<Models>>, "schema" | "mutators"> & {
+        authData?: AuthData | null;
+        transport?: ZeroProviderTransport;
+        beforeReload?: () => Promise<void>;
+        scheduleReload?: (ctx: ScheduleReloadContext) => void;
+        guardStorage?: RecoveryGuardStorage;
+        benignLogPatterns?: readonly ZeroLogPattern[];
+        refreshAuth?: () => Promise<string | undefined>;
+    }) => {
+        zero: ZeroClient<Schema, GetZeroMutators<Models>, unknown>;
+        close: () => Promise<void>;
+    };
     ControlQueries: ({ children, action, whenDisabled, }: {
         children: ReactNode;
         action?: "enable" | "disable";

package/types/createZeroClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createZeroClient.d.ts","sourceRoot":"","sources":["../src/createZeroClient.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"createZeroClient.d.ts","sourceRoot":"","sources":["../src/createZeroClient.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,IAAI,IAAI,UAAU,EACnB,MAAM,gBAAgB,CAAA;AAOvB,OAAO,EASL,KAAK,OAAO,EACZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AAGd,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAK/D,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EAEpB,MAAM,6BAA6B,CAAA;AAIpC,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAOhE,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,eAAe,EAEf,iBAAiB,EAElB,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EACV,gBAAgB,EAChB,KAAK,EACL,GAAG,EAEH,WAAW,EACX,MAAM,IAAI,UAAU,EACrB,MAAM,gBAAgB,CAAA;AAEvB,KAAK,cAAc,GAAG;IAAE,GAAG,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAEvE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;AAMpF,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,iBAAiB,GAAG,kBAAkB,CAAA;AAEtF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC,kBAAkB,CAAC,EAAE;QACnB,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;KACnC,CAAA;CACF,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,uBAAuB,CACjC,MAAM,SAAS,UAAU,EACzB,MAAM,SAAS,aAAa,IAC1B;IACF,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,cAAc,CAAA;IAC9B,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IAGvC,iCAAiC,CAAC,EAAE,MAAM,CAAA;IAI1C,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,kBAAkB,CAAC,MAAM,SAAS,UAAU,IAAI,CAAC,KAAK,EAAE;IAClE,eAAe,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC1C,aAAa,EAAE,gBAAgB,CAAA;IAC/B,OAAO,EAAE,MAAM,GAAG,CAAA;IAClB,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAC7B,KAAK,YAAY,CAAC,MAAM,CAAC,CAAA;AA+B1B,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,UAAU,EAAE,MAAM,SAAS,aAAa,EACtF,OAAO,EAAE,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC;;;sBAsiBzB,OAAO;;kBA6ClB,SAAS;;kBAUT,OAAO;oBAGL,qBAAqB;8BAGZ,OAAO,CAAC,IAAI,CAAC;gCAIX,qBAAqB,KAAK,IAAI;uBAGtC,oBAAoB;4BAGf,SAAS,cAAc,EAAE;6BAGzB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;4BAI3B,OAAO;;;;oBAyQb,qBAAqB;8BACZ,OAAO,CAAC,IAAI,CAAC;gCACX,qBAAqB,KAAK,IAAI;uBACtC,oBAAoB;4BACf,SAAS,cAAc,EAAE;6BAIzB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;;;qBAEb,OAAO,CAAC,IAAI,CAAC;;;kBAmPvC,SAAS;iBACV,QAAQ,GAAG,SAAS;uBACd,OAAO,GAAG,YAAY;;;;uFAlwBxB,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,YACrC,OAAO,UACT,OAAO,KACZ,OAAO,GAAG,IAAI;6FAHR,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,YACrC,OAAO,UACT,OAAO,KACZ,OAAO,GAAG,IAAI;;;SAstBN,IAAI,EAAE,MAAM,0CAA0C,OAAO,kFAGlE,cAAc;2BACN,IAAI;sBAAY,OAAO,CAAC,IAAI,CAAC;;SAChC,MAAM,0CAA0C,OAAO,oEAE5D,cAAc;2BACN,IAAI;sBAAY,OAAO,CAAC,IAAI,CAAC;;;;SAe/B,IAAI,EAAE,MAAM,0CAA0C,OAAO,yEAG5E,UAAU,CAAC,OAAO,YAAY,QAAQ,CAAC;SACxB,MAAM,0CAA0C,OAAO,2DAEtE,UAAU,CAAC,OAAO,YAAY,QAAQ,CAAC;;+BAl3BT,kBAAkB;;yBA0PJ,OAAO;UAAU,OAAO,CAAC,OAAO,CAAC;;;;EArfjF;AAED,wBAAgB,wBAAwB,CACtC,MAAM,SAAS,UAAU,EACzB,MAAM,SAAS,aAAa,EAC5B,EACA,MAAM,EACN,MAAM,EACN,cAAc,EACd,kBAAiC,EACjC,YAAwB,EACxB,iCAAqC,EACrC,oBAAoB,GACrB,EAAE,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IAC3C,oBAAoB,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAA;CAClD;;;sBAohBwB,OAAO;;kBA6ClB,SAAS;mBACR,QAAQ,GAAG,IAAI;kBAShB,OAAO;oBAGL,qBAAqB;uBAGlB,MAAM,OAAO,CAAC,IAAI,CAAC;yBAIjB,CAAC,GAAG,EAAE,qBAAqB,KAAK,IAAI;uBAGtC,oBAAoB;4BAGf,SAAS,cAAc,EAAE;sBAG/B,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;4BAI3B,OAAO;;6BAuQpB,IAAI,CAAC,WAAW,CAAC,MAAM,0BAAe,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG;QACtE,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;QAC1B,SAAS,CAAC,EAAE,qBAAqB,CAAA;QACjC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;QAClC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,IAAI,CAAA;QACrD,YAAY,CAAC,EAAE,oBAAoB,CAAA;QACnC,iBAAiB,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;QAI7C,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;KAChD,KACA;QAAE,IAAI,uDAAe;QAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE;0DAkPlD;QACD,QAAQ,EAAE,SAAS,CAAA;QACnB,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;QAC7B,YAAY,CAAC,EAAE,OAAO,GAAG,YAAY,CAAA;KACtC;;;2BApwBY,oCAAY,CAAC,MAAM,GAAG,EAAE,CAAC,WACvB,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,YACrC,OAAO,UACT,OAAO,KACZ,OAAO,GAAG,IAAI;iCAJV,oCAAY,CAAC,MAAM,GAAG,EAAE,CAAC,WACvB,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,YACrC,OAAO,UACT,OAAO,KACZ,OAAO,GAAG,IAAI;;;SAstBN,IAAI,EAAE,MAAM,SAAS,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE,OAAO,MACxE,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,UAC9C,IAAI,YACF,cAAc,GACvB;YAAE,OAAO,EAAE,MAAM,IAAI,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;SAAE;SAClC,MAAM,SAAS,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE,OAAO,MAClE,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,YAC5C,cAAc,GACvB;YAAE,OAAO,EAAE,MAAM,IAAI,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;SAAE;;;SAejC,IAAI,EAAE,MAAM,SAAS,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE,OAAO,MACzE,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,UAC9C,IAAI,GACX,UAAU,CAAC,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;SACxB,MAAM,SAAS,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE,OAAO,MACnE,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,GACrD,UAAU,CAAC,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;;+BAl3BT,kBAAkB,KAAQ,OAAO,sDAAc;oBA0PpD;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,KAAQ,OAAO,CAAC,OAAO,CAAC;;;;EA8pBjF"}