on-zero 0.4.25 → 0.4.27

package/src/httpPullTransport.ts

@@ -0,0 +1,559 @@
+// http-pull transport: runs a stock @rocicorp/zero client over stateless HTTP
+// by intercepting its /sync/v51/connect WebSocket with a shim that translates
+// pull responses into v51 pokes. ported from the orez zero-http spike — the
+// wire contract (lexicographic string cookies, gotQueriesPatch poke-part
+// ordering, FIFO push serialization, updateAuth, 401→Unauthorized frame,
+// teardown drain) is pinned by the tests in ./httpPull/ and documented in
+// ~/orez/plans/zero-http.md. do not "simplify" any of it without re-running
+// those tests against a stock zero client.
+
+type WebSocketProtocols = string | string[] | undefined
+type SocketEventType = 'open' | 'message' | 'close' | 'error'
+type SocketListener = ((event: any) => void) | { handleEvent(event: any): void }
+
+type WebSocketConstructor = {
+  new (url: string | URL, protocols?: WebSocketProtocols): any
+  CONNECTING?: number
+  OPEN?: number
+  CLOSING?: number
+  CLOSED?: number
+}
+
+type DesiredQueryPatchOp =
+  | { op: 'clear' }
+  | { op: 'put' | 'del'; hash: string; [key: string]: unknown }
+
+type GotQueryPatchOp = { op: 'clear' } | { op: 'put' | 'del'; hash: string }
+
+type PullResponse =
+  | {
+      cookie: number
+      lastMutationIDChanges: Record<string, number>
+      rowsPatch: unknown[]
+      unchanged?: false
+    }
+  | {
+      cookie: number | null
+      unchanged: true
+    }
+
+type TransportState = {
+  readonly origin: URL
+  readonly originString: string
+  readonly fetch: typeof fetch
+  readonly nativeWebSocket: WebSocketConstructor | undefined
+  readonly sockets: Set<ZeroHttpSocket>
+  readonly pullIntervalMs: number | undefined
+  nextPokeID: number
+}
+
+const COOKIE_WIDTH = 20
+
+export type HttpPullTransport = {
+  pull(): Promise<void>
+  readonly connections: number
+  uninstall(): void
+}
+
+export type HttpPullTransportOptions = {
+  origin: string
+  fetch?: typeof fetch
+  // when set, every open connection also pulls on this interval so
+  // server-initiated changes arrive without a client-side trigger
+  pullIntervalMs?: number
+}
+
+export function installHttpPullTransport(
+  opts: HttpPullTransportOptions,
+): HttpPullTransport {
+  const previousWebSocket = globalThis.WebSocket as WebSocketConstructor | undefined
+  const fetchImpl = opts.fetch ?? globalThis.fetch
+  if (!fetchImpl) {
+    throw new Error('installHttpPullTransport requires a fetch implementation')
+  }
+
+  const state: TransportState = {
+    origin: new URL(opts.origin),
+    originString: trimTrailingSlash(new URL(opts.origin).toString()),
+    fetch: fetchImpl,
+    nativeWebSocket: previousWebSocket,
+    sockets: new Set(),
+    pullIntervalMs: opts.pullIntervalMs,
+    nextPokeID: 0,
+  }
+
+  const Shim = class {
+    static CONNECTING = 0
+    static OPEN = 1
+    static CLOSING = 2
+    static CLOSED = 3
+
+    constructor(url: string | URL, protocols?: WebSocketProtocols) {
+      if (shouldIntercept(state.origin, url)) {
+        return new ZeroHttpSocket(state, url, protocols)
+      }
+      if (!state.nativeWebSocket) {
+        throw new Error(`No native WebSocket available for ${String(url)}`)
+      }
+      return new state.nativeWebSocket(url, protocols)
+    }
+  }
+
+  globalThis.WebSocket = Shim as unknown as typeof WebSocket
+
+  return {
+    pull: async () => {
+      await Promise.all([...state.sockets].map((socket) => socket.pull()))
+    },
+    get connections() {
+      return state.sockets.size
+    },
+    uninstall: () => {
+      if (globalThis.WebSocket === (Shim as unknown as typeof WebSocket)) {
+        globalThis.WebSocket = previousWebSocket as typeof WebSocket
+      }
+    },
+  }
+}
+
+// per-origin idempotent install for app usage (ProvideZero rotates zero
+// instances against the same server; installing per rotation would chain
+// shims unboundedly). installed transports live for the page lifetime.
+const transportsByOrigin = new Map<string, HttpPullTransport>()
+
+export function ensureHttpPullTransport(
+  opts: HttpPullTransportOptions,
+): HttpPullTransport {
+  const key = trimTrailingSlash(new URL(opts.origin).toString())
+  const existing = transportsByOrigin.get(key)
+  if (existing) return existing
+  const transport = installHttpPullTransport(opts)
+  transportsByOrigin.set(key, transport)
+  return transport
+}
+
+class ZeroHttpSocket {
+  readonly CONNECTING = 0
+  readonly OPEN = 1
+  readonly CLOSING = 2
+  readonly CLOSED = 3
+
+  readonly url: string
+  readyState = this.CONNECTING
+
+  private readonly connectURL: URL
+  private authToken: string | undefined
+  private readonly listeners: Record<SocketEventType, Set<SocketListener>> = {
+    open: new Set(),
+    message: new Set(),
+    close: new Set(),
+    error: new Set(),
+  }
+  private readonly clientID: string
+  private readonly clientGroupID: string
+  private readonly wsid: string
+  private cookie: string | null
+  private pendingGotQueriesPatch: GotQueryPatchOp[] = []
+  private pullInFlight: Promise<void> | undefined
+  private pullAfterCurrent = false
+  private pushChain: Promise<void> = Promise.resolve()
+  private nextLocalCookieID = 0
+  private openTimer: ReturnType<typeof setTimeout> | undefined
+  private pullTimer: ReturnType<typeof setInterval> | undefined
+
+  constructor(
+    private readonly state: TransportState,
+    url: string | URL,
+    protocols?: WebSocketProtocols,
+  ) {
+    this.connectURL = toHttpURL(url)
+    this.url = String(url)
+    this.clientID = this.connectURL.searchParams.get('clientID') ?? ''
+    this.clientGroupID = this.connectURL.searchParams.get('clientGroupID') ?? ''
+    this.wsid = this.connectURL.searchParams.get('wsid') ?? `zero-http-${Date.now()}`
+    const baseCookie = this.connectURL.searchParams.get('baseCookie')
+    this.cookie = baseCookie ? baseCookie : null
+
+    const decoded = decodeSecProtocol(protocols)
+    this.authToken = decoded.authToken
+    this.queueDesiredQueries(decoded.initConnectionMessage?.[1])
+
+    this.state.sockets.add(this)
+    this.openTimer = setTimeout(() => this.open(), 0)
+  }
+
+  addEventListener(type: SocketEventType, listener: SocketListener | null) {
+    if (listener) this.listeners[type]?.add(listener)
+  }
+
+  removeEventListener(type: SocketEventType, listener: SocketListener | null) {
+    if (listener) this.listeners[type]?.delete(listener)
+  }
+
+  dispatchEvent(event: { type: SocketEventType }) {
+    this.emit(event.type, event)
+    return true
+  }
+
+  send(data: string) {
+    if (this.readyState !== this.OPEN) {
+      throw new Error('cannot send on a socket that is not open')
+    }
+    const message = JSON.parse(data) as [string, any]
+    switch (message[0]) {
+      case 'initConnection':
+      case 'changeDesiredQueries':
+        this.queueDesiredQueries(message[1])
+        this.requestPullAfterCurrent()
+        return
+      case 'updateAuth':
+        this.authToken = (message[1] as { auth?: string }).auth
+        return
+      case 'push':
+        this.enqueuePush(message[1])
+        return
+      case 'ping':
+        this.emitMessage(['pong', {}])
+        return
+      case 'pull':
+        this.run(this.answerMutationRecoveryPull(message[1]))
+        return
+      case 'deleteClients':
+      case 'ackMutationResponses':
+        return
+      default:
+        throw new Error(`unsupported zero-http upstream message ${message[0]}`)
+    }
+  }
+
+  close(code = 1000, reason = '') {
+    if (this.readyState === this.CLOSED) return
+    if (this.openTimer) clearTimeout(this.openTimer)
+    if (this.pullTimer) clearInterval(this.pullTimer)
+    this.readyState = this.CLOSED
+    this.state.sockets.delete(this)
+    this.emit('close', { code, reason, wasClean: code <= 1001 })
+  }
+
+  pull(): Promise<void> {
+    if (this.readyState === this.CLOSED) return Promise.resolve()
+    if (this.pullInFlight) return this.pullInFlight
+    this.pullInFlight = this.fetchPull(this.clientGroupID, this.cookie)
+      .then((response) => {
+        if (response.unchanged) {
+          this.emitGotQueriesPatch(response.cookie)
+          return
+        }
+        this.emitPoke(response)
+      })
+      .catch((error) => {
+        this.fail(error)
+        throw error
+      })
+      .finally(async () => {
+        const pullAgain = this.pullAfterCurrent
+        this.pullAfterCurrent = false
+        this.pullInFlight = undefined
+        if (pullAgain && this.readyState !== this.CLOSED) await this.pull()
+      })
+    return this.pullInFlight
+  }
+
+  private open() {
+    if (this.readyState !== this.CONNECTING) return
+    this.readyState = this.OPEN
+    this.emit('open', {})
+    this.emitMessage(['connected', { wsid: this.wsid, timestamp: Date.now() }])
+    setTimeout(() => this.run(this.pull()), 0)
+    if (this.state.pullIntervalMs) {
+      this.pullTimer = setInterval(() => {
+        this.run(this.pull())
+      }, this.state.pullIntervalMs)
+    }
+  }
+
+  private queueDesiredQueries(body: unknown) {
+    const desiredQueriesPatch = (body as { desiredQueriesPatch?: unknown })
+      ?.desiredQueriesPatch
+    if (!Array.isArray(desiredQueriesPatch)) return
+    this.pendingGotQueriesPatch.push(...gotQueriesPatch(desiredQueriesPatch))
+  }
+
+  private async push(body: unknown) {
+    const response = (await this.postJSON('/push', body)) as {
+      pushResponse?: unknown
+    }
+    this.emitMessage(['pushResponse', response.pushResponse])
+    this.requestPullAfterCurrent()
+  }
+
+  private enqueuePush(body: unknown) {
+    const nextPush = this.pushChain.then(async () => {
+      if (this.readyState === this.CLOSED) return
+      await this.push(body)
+    })
+    this.pushChain = nextPush.catch(() => {})
+    this.run(nextPush)
+  }
+
+  private requestPullAfterCurrent() {
+    if (this.pullInFlight) {
+      this.pullAfterCurrent = true
+      return
+    }
+    this.run(this.pull())
+  }
+
+  private async answerMutationRecoveryPull(body: {
+    clientGroupID: string
+    cookie: string | null
+    requestID: string
+  }) {
+    const response = await this.fetchPull(body.clientGroupID, body.cookie)
+    const cookie = toWebSocketCookie(response.cookie)
+    this.emitMessage([
+      'pull',
+      {
+        requestID: body.requestID,
+        cookie: cookie ?? this.cookie ?? '0',
+        lastMutationIDChanges: response.unchanged ? {} : response.lastMutationIDChanges,
+      },
+    ])
+  }
+
+  private async fetchPull(clientGroupID: string, cookie: string | null) {
+    return (await this.postJSON('/pull', {
+      clientID: this.clientID,
+      clientGroupID,
+      cookie: toHttpCookie(cookie),
+    })) as PullResponse
+  }
+
+  private async postJSON(path: '/pull' | '/push', body: unknown) {
+    const response = await this.state.fetch(`${this.state.originString}${path}`, {
+      method: 'POST',
+      headers: {
+        authorization: this.authToken ? `Bearer ${this.authToken}` : '',
+        'content-type': 'application/json',
+      },
+      body: JSON.stringify(body),
+    })
+    if (!response.ok) {
+      throw new ZeroHttpResponseError(path, response.status)
+    }
+    return response.json()
+  }
+
+  private run(promise: Promise<void>) {
+    void promise.catch((error) => this.fail(error))
+  }
+
+  private fail(error: unknown) {
+    if (this.readyState === this.CLOSED) return
+    if (isAuthHTTPError(error)) {
+      this.emitMessage([
+        'error',
+        {
+          kind: 'Unauthorized',
+          message: error.message,
+          origin: 'server',
+        },
+      ])
+      if (this.readyState !== this.CLOSED) this.close(1000, error.message)
+      return
+    }
+    this.emit('error', { error })
+    this.close(1011, errorMessage(error))
+  }
+
+  private emitPoke(response: Exclude<PullResponse, { unchanged: true }>) {
+    const nextCookie = toWebSocketCookie(response.cookie)
+    if (isStaleCookie(this.cookie, response.cookie)) {
+      throw new Error(
+        `zero-http pull returned stale cookie ${response.cookie} for ${this.cookie}`,
+      )
+    }
+
+    const pokeID = `zero-http-${++this.state.nextPokeID}`
+    const gotQueries = this.pendingGotQueriesPatch
+    this.pendingGotQueriesPatch = []
+
+    this.emitMessage([
+      'pokeStart',
+      {
+        pokeID,
+        baseCookie: this.cookie,
+        schemaVersions: {
+          minSupportedVersion: 1,
+          maxSupportedVersion: 1,
+        },
+        timestamp: Date.now(),
+      },
+    ])
+    this.emitMessage([
+      'pokePart',
+      {
+        pokeID,
+        lastMutationIDChanges: response.lastMutationIDChanges,
+        rowsPatch: response.rowsPatch,
+      },
+    ])
+    if (gotQueries.length > 0) {
+      this.emitMessage([
+        'pokePart',
+        {
+          pokeID,
+          gotQueriesPatch: gotQueries,
+        },
+      ])
+    }
+    this.emitMessage(['pokeEnd', { pokeID, cookie: nextCookie }])
+    this.cookie = nextCookie
+  }
+
+  private emitGotQueriesPatch(cookie: number | null) {
+    if (this.pendingGotQueriesPatch.length === 0) return
+
+    const serverCookie = cookie ?? toHttpCookie(this.cookie)
+    if (serverCookie === null) return
+    const nextCookie = toLocalWebSocketCookie(serverCookie, ++this.nextLocalCookieID)
+    const pokeID = `zero-http-${++this.state.nextPokeID}`
+    const gotQueries = this.pendingGotQueriesPatch
+    this.pendingGotQueriesPatch = []
+
+    this.emitMessage([
+      'pokeStart',
+      {
+        pokeID,
+        baseCookie: this.cookie,
+        schemaVersions: {
+          minSupportedVersion: 1,
+          maxSupportedVersion: 1,
+        },
+        timestamp: Date.now(),
+      },
+    ])
+    this.emitMessage([
+      'pokePart',
+      {
+        pokeID,
+        gotQueriesPatch: gotQueries,
+      },
+    ])
+    this.emitMessage(['pokeEnd', { pokeID, cookie: nextCookie }])
+    this.cookie = nextCookie
+  }
+
+  private emitMessage(message: unknown) {
+    if (this.readyState !== this.OPEN) return
+    this.emit('message', { data: JSON.stringify(message) })
+  }
+
+  private emit(type: SocketEventType, event: any) {
+    const handler = (this as unknown as Record<string, unknown>)[`on${type}`]
+    if (typeof handler === 'function') handler.call(this, event)
+    for (const listener of this.listeners[type]) {
+      if (typeof listener === 'function') listener(event)
+      else listener.handleEvent(event)
+    }
+  }
+}
+
+function shouldIntercept(origin: URL, url: string | URL) {
+  const candidate = toHttpURL(url)
+  if (candidate.origin !== origin.origin) return false
+  return candidate.pathname === `${trimTrailingSlash(origin.pathname)}/sync/v51/connect`
+}
+
+function toHttpURL(url: string | URL) {
+  const parsed = new URL(url)
+  if (parsed.protocol === 'ws:') parsed.protocol = 'http:'
+  if (parsed.protocol === 'wss:') parsed.protocol = 'https:'
+  return parsed
+}
+
+function trimTrailingSlash(value: string) {
+  return value.endsWith('/') ? value.slice(0, -1) : value
+}
+
+function decodeSecProtocol(protocols: WebSocketProtocols):
+  | {
+      authToken?: string
+      initConnectionMessage?: [string, Record<string, unknown>]
+    }
+  | Record<string, never> {
+  const protocol = Array.isArray(protocols) ? protocols[0] : protocols
+  if (!protocol) return {}
+  try {
+    const decoded = decodeURIComponent(protocol)
+    const json = new TextDecoder().decode(
+      Uint8Array.from(globalThis.atob(decoded), (char) => char.charCodeAt(0)),
+    )
+    const parsed = JSON.parse(json) as {
+      authToken?: string
+      initConnectionMessage?: unknown
+    }
+    return {
+      authToken: parsed.authToken,
+      initConnectionMessage: Array.isArray(parsed.initConnectionMessage)
+        ? (parsed.initConnectionMessage as [string, Record<string, unknown>])
+        : undefined,
+    }
+  } catch {
+    return {}
+  }
+}
+
+function gotQueriesPatch(patch: DesiredQueryPatchOp[]) {
+  const got: GotQueryPatchOp[] = []
+  for (const op of patch) {
+    if (op.op === 'clear') got.push({ op: 'clear' })
+    else if (op.hash) got.push({ op: op.op, hash: op.hash })
+  }
+  return got
+}
+
+function toHttpCookie(cookie: string | null): number | null {
+  if (cookie === null || cookie === '') return null
+  const parsed = Number(cookie.slice(0, COOKIE_WIDTH))
+  if (!Number.isFinite(parsed)) {
+    throw new Error(`zero-http cookie is not numeric: ${cookie}`)
+  }
+  return parsed
+}
+
+function toWebSocketCookie(cookie: number | null): string | null {
+  return cookie === null ? null : String(cookie).padStart(COOKIE_WIDTH, '0')
+}
+
+function toLocalWebSocketCookie(cookie: number, localID: number): string {
+  return `${String(cookie).padStart(COOKIE_WIDTH, '0')}#${String(localID).padStart(
+    6,
+    '0',
+  )}`
+}
+
+function isStaleCookie(current: string | null, next: number) {
+  const currentNumber = toHttpCookie(current)
+  return currentNumber !== null && next <= currentNumber
+}
+
+function errorMessage(error: unknown) {
+  return error instanceof Error ? error.message : String(error)
+}
+
+class ZeroHttpResponseError extends Error {
+  constructor(
+    readonly path: '/pull' | '/push',
+    readonly status: number,
+  ) {
+    super(`zero-http ${path} failed with ${status}`)
+  }
+}
+
+function isAuthHTTPError(error: unknown): error is ZeroHttpResponseError {
+  return (
+    error instanceof ZeroHttpResponseError &&
+    (error.status === 401 || error.status === 403)
+  )
+}

package/src/index.ts

@@ -10,6 +10,7 @@ export { setAuthData, setEnvironment } from './state'
 
 export * from './combineZeroClients'
 export * from './createZeroClient'
+export * from './httpPullTransport'
 export * from './createUseQuery'
 export * from './resolveQuery'
 export * from './run'

package/src/multiInstanceNested.test.tsx

@@ -6,7 +6,7 @@
 // path — they must materialize directly on the owning instance.
 
 import { createSchema, string, table } from '@rocicorp/zero'
-import { act } from 'react'
+import { act, StrictMode } from 'react'
 import { createRoot, type Root } from 'react-dom/client'
 import { afterEach, beforeEach, expect, test } from 'vitest'
 
@@ -182,6 +182,30 @@ test('inner provider unmount/remount does not break outer-instance subscriptions
   await waitFor(() => probe.data?.name === 'v3', 'v3 visible after inner remount')
 })
 
+test('StrictMode: direct views survive the effect double-invoke', async () => {
+  // StrictMode (and any suspense hide/reveal) runs effect cleanup + re-setup
+  // with unchanged deps: the cleanup destroys the materialized view while the
+  // memoized store identity survives, so without re-materialization on
+  // resubscribe the snapshot freezes at its mount-time value forever — the
+  // "control queries strand at result type unknown" bug (soot 3e6ecd10a)
+  await render(
+    <StrictMode>
+      <control.ProvideZero server={null} userID="t4-ctl">
+        <project.ProvideZero server={null} userID="t4-prj">
+          <ControlUserProbe id="u4" />
+        </project.ProvideZero>
+      </control.ProvideZero>
+    </StrictMode>,
+  )
+  await waitFor(() => probe.renders > 0, 'probe mount')
+
+  await seedControl({ id: 'u4', name: 'strict-v1' })
+  await waitFor(() => probe.data?.name === 'strict-v1', 'update visible under StrictMode')
+
+  await seedControl({ id: 'u4', name: 'strict-v2' })
+  await waitFor(() => probe.data?.name === 'strict-v2', 'second update still live')
+})
+
 test('direct-path views re-materialize when the owning instance rotates', async () => {
   const App = ({ userID }: { userID: string }) => (
     <control.ProvideZero server={null} userID={userID}>

package/types/createUseQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createUseQuery.d.ts","sourceRoot":"","sources":["../src/createUseQuery.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,EAML,KAAK,OAAO,EACb,MAAM,OAAO,CAAA;AAGd,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAEhE,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,KAAK,EACL,MAAM,IAAI,UAAU,EACrB,MAAM,gBAAgB,CAAA;AAGvB,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,OAAO,GAAG,YAAY,CAAA;AAE7D,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,GAAG,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;CAC9C,CAAA;AAED,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5D,MAAM,MAAM,WAAW,CAAC,OAAO,IAAI,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAA;AAExF,YAAY,EAAE,YAAY,EAAE,CAAA;AAE5B,MAAM,MAAM,YAAY,CAAC,MAAM,SAAS,UAAU,IAAI;IAEpD,CAAC,IAAI,EAAE,MAAM,SAAS,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE,OAAO,EAC5D,EAAE,EAAE,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,EACtD,MAAM,EAAE,IAAI,EACZ,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,GAClC,WAAW,CAAC,OAAO,CAAC,CAAC;IAGxB,CAAC,MAAM,SAAS,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE,OAAO,EACtD,EAAE,EAAE,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,EACtD,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,GAClC,WAAW,CAAC,OAAO,CAAC,CAAA;CACxB,CAAA;AAmBD,wBAAgB,cAAc,CAAC,MAAM,SAAS,UAAU,EAAE,EACxD,eAAe,EACf,aAAa,GACd,EAAE;IACD,eAAe,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC1C,aAAa,EAAE,gBAAgB,CAAA;CAChC,GAAG,YAAY,CAAC,MAAM,CAAC,CAkCvB;AAoCD,KAAK,kBAAkB,GAAG;IACxB,WAAW,CACT,KAAK,EAAE,GAAG,EACV,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,GACtB;QACD,WAAW,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;QAC9D,OAAO,IAAI,IAAI,CAAA;KAChB,CAAA;CACF,CAAA;AAiDD,wBAAgB,oBAAoB,CAAC,MAAM,SAAS,UAAU,EAAE,EAC9D,eAAe,EACf,aAAa,EACb,OAAO,EACP,WAAW,GACZ,EAAE;IACD,eAAe,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC1C,aAAa,EAAE,gBAAgB,CAAA;IAE/B,OAAO,EAAE,MAAM,kBAAkB,GAAG,IAAI,CAAA;IAExC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAC7B,GAAG,YAAY,CAAC,MAAM,CAAC,CAwDvB"}
+{"version":3,"file":"createUseQuery.d.ts","sourceRoot":"","sources":["../src/createUseQuery.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,EAML,KAAK,OAAO,EACb,MAAM,OAAO,CAAA;AAGd,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAEhE,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,KAAK,EACL,MAAM,IAAI,UAAU,EACrB,MAAM,gBAAgB,CAAA;AAGvB,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,OAAO,GAAG,YAAY,CAAA;AAE7D,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,GAAG,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;CAC9C,CAAA;AAED,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5D,MAAM,MAAM,WAAW,CAAC,OAAO,IAAI,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAA;AAExF,YAAY,EAAE,YAAY,EAAE,CAAA;AAE5B,MAAM,MAAM,YAAY,CAAC,MAAM,SAAS,UAAU,IAAI;IAEpD,CAAC,IAAI,EAAE,MAAM,SAAS,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE,OAAO,EAC5D,EAAE,EAAE,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,EACtD,MAAM,EAAE,IAAI,EACZ,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,GAClC,WAAW,CAAC,OAAO,CAAC,CAAC;IAGxB,CAAC,MAAM,SAAS,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE,OAAO,EACtD,EAAE,EAAE,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,EACtD,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,GAClC,WAAW,CAAC,OAAO,CAAC,CAAA;CACxB,CAAA;AAmBD,wBAAgB,cAAc,CAAC,MAAM,SAAS,UAAU,EAAE,EACxD,eAAe,EACf,aAAa,GACd,EAAE;IACD,eAAe,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC1C,aAAa,EAAE,gBAAgB,CAAA;CAChC,GAAG,YAAY,CAAC,MAAM,CAAC,CAkCvB;AAoCD,KAAK,kBAAkB,GAAG;IACxB,WAAW,CACT,KAAK,EAAE,GAAG,EACV,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,GACtB;QACD,WAAW,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;QAC9D,OAAO,IAAI,IAAI,CAAA;KAChB,CAAA;CACF,CAAA;AAoED,wBAAgB,oBAAoB,CAAC,MAAM,SAAS,UAAU,EAAE,EAC9D,eAAe,EACf,aAAa,EACb,OAAO,EACP,WAAW,GACZ,EAAE;IACD,eAAe,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC1C,aAAa,EAAE,gBAAgB,CAAA;IAE/B,OAAO,EAAE,MAAM,kBAAkB,GAAG,IAAI,CAAA;IAExC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAC7B,GAAG,YAAY,CAAC,MAAM,CAAC,CAuDvB"}

package/types/createZeroClient.d.ts

@@ -18,10 +18,12 @@ export declare function createZeroClient<Schema extends ZeroSchema, Models exten
 }): {
     instanceName: string;
     zeroEvents: import("@take-out/helpers").Emitter<ZeroEvent | null>;
-    ProvideZero: ({ children, authData: authDataIn, disable, ...props }: Omit<ZeroOptions<Schema, GetZeroMutators<Models>>, "schema" | "mutators"> & {
+    ProvideZero: ({ children, authData: authDataIn, disable, transport, pullIntervalMs, ...props }: Omit<ZeroOptions<Schema, GetZeroMutators<Models>>, "schema" | "mutators"> & {
         children: ReactNode;
         authData?: AuthData | null;
         disable?: boolean;
+        transport?: "http-pull";
+        pullIntervalMs?: number;
     }) => string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null | undefined;
     ControlQueries: ({ children, action, whenDisabled, }: {
         children: ReactNode;

package/types/createZeroClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createZeroClient.d.ts","sourceRoot":"","sources":["../src/createZeroClient.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,IAAI,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAG/E,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AAGd,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAA;AAMzB,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAOhE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAClF,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAQ,WAAW,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEzF,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;AAmBtF,wBAAgB,gBAAgB,CAC9B,MAAM,SAAS,UAAU,EACzB,MAAM,SAAS,aAAa,EAC5B,EACA,MAAM,EACN,MAAM,EACN,cAAc,EACd,kBAAiC,EACjC,YAAwB,GACzB,EAAE;IACD,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,cAAc,CAAA;IAC9B,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IAIvC,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;;;yEA6PI,IAAI,CAAC,WAAW,CAAC,MAAM,0BAAe,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG;QAClE,QAAQ,EAAE,SAAS,CAAA;QACnB,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;QAC1B,OAAO,CAAC,EAAE,OAAO,CAAA;KAClB;0DA8NE;QACD,QAAQ,EAAE,SAAS,CAAA;QACnB,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;QAC7B,YAAY,CAAC,EAAE,OAAO,GAAG,YAAY,CAAA;KACtC;;;2BAnTU,oCAAY,CAAC,MAAM,GAAG,EAAE,CAAC,WACvB,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,yCAG9C,OAAO,GAAG,IAAI;iCAJR,oCAAY,CAAC,MAAM,GAAG,EAAE,CAAC,WACvB,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,yCAG9C,OAAO,GAAG,IAAI;;;SAqQF,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;;EA+B3C"}
+{"version":3,"file":"createZeroClient.d.ts","sourceRoot":"","sources":["../src/createZeroClient.tsx"],"names":[],"mappings":"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"}

package/types/httpPull/auth.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auth.test.d.ts.map

package/types/httpPull/auth.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.test.d.ts","sourceRoot":"","sources":["../../src/httpPull/auth.test.ts"],"names":[],"mappings":""}

package/types/httpPull/churn.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=churn.test.d.ts.map

package/types/httpPull/churn.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"churn.test.d.ts","sourceRoot":"","sources":["../../src/httpPull/churn.test.ts"],"names":[],"mappings":""}