@rocicorp/zero 0.26.1 → 0.26.2-canary.1

package/out/zero-react/src/use-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-query.js","sources":["../../../../zero-react/src/use-query.tsx"],"sourcesContent":["import {resolver} from '@rocicorp/resolver';\nimport React, {useSyncExternalStore} from 'react';\nimport {\n  type Immutable,\n  addContextToQuery,\n  asQueryInternals,\n  deepClone,\n  DEFAULT_TTL_MS,\n} from './bindings.ts';\nimport {useZero} from './zero-provider.tsx';\nimport type {\n  AnyMutatorRegistry,\n  BaseDefaultContext,\n  BaseDefaultSchema,\n  CustomMutatorDefs,\n  DefaultContext,\n  DefaultSchema,\n  ErroredQuery,\n  Falsy,\n  HumanReadable,\n  PullRow,\n  Query,\n  QueryErrorDetails,\n  QueryOrQueryRequest,\n  QueryResultDetails,\n  ReadonlyJSONValue,\n  ResultType,\n  TTL,\n  TypedView,\n  Zero,\n} from './zero.ts';\n\nexport type QueryResult<TReturn> = readonly [\n  HumanReadable<TReturn>,\n  QueryResultDetails & {},\n];\n\n/**\n * Result type for \"maybe queries\" - queries that may be falsy.\n * The data value can be undefined when the query is falsy/disabled.\n */\nexport type MaybeQueryResult<TReturn> = readonly [\n  HumanReadable<TReturn> | undefined,\n  QueryResultDetails & {},\n];\n\nexport type UseQueryOptions = {\n  enabled?: boolean | undefined;\n  /**\n   * Time to live (TTL) in seconds. Controls how long query results are cached\n   * after the query is removed. During this time, Zero continues to sync the query.\n   * Default is 'never'.\n   */\n  ttl?: TTL | undefined;\n};\n\nexport type UseSuspenseQueryOptions = UseQueryOptions & {\n  /**\n   * Whether to suspend until:\n   * - 'partial': the query has partial results (partial array or defined\n   *   value for singular results) which may be of result type 'unknown',\n   *   or the query result type is 'complete' (in which case results may be\n   *   empty).  This is useful for suspending until there are partial\n   *   optimistic local results, or the query has completed loading from the\n   *   server.\n   * - 'complete': the query result type is 'complete'.\n   *\n   * Default is 'partial'.\n   */\n  suspendUntil?: 'complete' | 'partial';\n};\n\nconst reactUse = (React as {use?: (p: Promise<unknown>) => void}).use;\nconst suspend: (p: Promise<unknown>) => void = reactUse\n  ? reactUse\n  : p => {\n      throw p;\n    };\n\n// Overload 1: Query\nexport function useQuery<\n  TTable extends keyof TSchema['tables'] & string,\n  TInput extends ReadonlyJSONValue | undefined,\n  TOutput extends ReadonlyJSONValue | undefined,\n  TSchema extends BaseDefaultSchema = DefaultSchema,\n  TReturn = PullRow<TTable, TSchema>,\n  TContext extends BaseDefaultContext = DefaultContext,\n>(\n  query: QueryOrQueryRequest<\n    TTable,\n    TInput,\n    TOutput,\n    TSchema,\n    TReturn,\n    TContext\n  >,\n  options?: UseQueryOptions | boolean,\n): QueryResult<TReturn>;\n\n// Overload 2: Maybe query\nexport function useQuery<\n  TTable extends keyof TSchema['tables'] & string,\n  TInput extends ReadonlyJSONValue | undefined,\n  TOutput extends ReadonlyJSONValue | undefined,\n  TSchema extends BaseDefaultSchema = DefaultSchema,\n  TReturn = PullRow<TTable, TSchema>,\n  TContext extends BaseDefaultContext = DefaultContext,\n>(\n  query:\n    | QueryOrQueryRequest<TTable, TInput, TOutput, TSchema, TReturn, TContext>\n    | Falsy,\n  options?: UseQueryOptions | boolean,\n): MaybeQueryResult<TReturn>;\n\n// Implementation\nexport function useQuery<\n  TTable extends keyof TSchema['tables'] & string,\n  TInput extends ReadonlyJSONValue | undefined,\n  TOutput extends ReadonlyJSONValue | undefined,\n  TSchema extends BaseDefaultSchema = DefaultSchema,\n  TReturn = PullRow<TTable, TSchema>,\n  TContext extends BaseDefaultContext = DefaultContext,\n>(\n  query:\n    | QueryOrQueryRequest<TTable, TInput, TOutput, TSchema, TReturn, TContext>\n    | Falsy,\n  options?: UseQueryOptions | boolean,\n): QueryResult<TReturn> | MaybeQueryResult<TReturn> {\n  let enabled = true;\n  let ttl: TTL = DEFAULT_TTL_MS;\n  if (typeof options === 'boolean') {\n    enabled = options;\n  } else if (options) {\n    ({enabled = true, ttl = DEFAULT_TTL_MS} = options);\n  }\n\n  const zero = useZero<TSchema, undefined, TContext>();\n\n  // When query is falsy, use disabled subscriber/snapshot to maintain hook order\n  const q = query ? addContextToQuery(query, zero.context) : undefined;\n  const view = q ? viewStore.getView(zero, q, enabled, ttl) : undefined;\n\n  // https://react.dev/reference/react/useSyncExternalStore\n  // Always call useSyncExternalStore to maintain consistent hook order\n  return useSyncExternalStore(\n    view?.subscribeReactInternals ?? disabledSubscriber,\n    view?.getSnapshot ??\n      (getDisabledSnapshot as () => MaybeQueryResult<TReturn>),\n    view?.getSnapshot ??\n      (getDisabledSnapshot as () => MaybeQueryResult<TReturn>),\n  );\n}\n\n// Overload 1: Query\nexport function useSuspenseQuery<\n  TTable extends keyof TSchema['tables'] & string,\n  TInput extends ReadonlyJSONValue | undefined,\n  TOutput extends ReadonlyJSONValue | undefined,\n  TSchema extends BaseDefaultSchema = DefaultSchema,\n  TReturn = PullRow<TTable, TSchema>,\n  TContext extends BaseDefaultContext = DefaultContext,\n>(\n  query: QueryOrQueryRequest<\n    TTable,\n    TInput,\n    TOutput,\n    TSchema,\n    TReturn,\n    TContext\n  >,\n  options?: UseSuspenseQueryOptions | boolean,\n): QueryResult<TReturn>;\n\n// Overload 2: Maybe query\nexport function useSuspenseQuery<\n  TTable extends keyof TSchema['tables'] & string,\n  TInput extends ReadonlyJSONValue | undefined,\n  TOutput extends ReadonlyJSONValue | undefined,\n  TSchema extends BaseDefaultSchema = DefaultSchema,\n  TReturn = PullRow<TTable, TSchema>,\n  TContext extends BaseDefaultContext = DefaultContext,\n>(\n  query:\n    | QueryOrQueryRequest<TTable, TInput, TOutput, TSchema, TReturn, TContext>\n    | Falsy,\n  options?: UseSuspenseQueryOptions | boolean,\n): MaybeQueryResult<TReturn>;\n\n// Implementation\nexport function useSuspenseQuery<\n  TTable extends keyof TSchema['tables'] & string,\n  TInput extends ReadonlyJSONValue | undefined,\n  TOutput extends ReadonlyJSONValue | undefined,\n  TSchema extends BaseDefaultSchema = DefaultSchema,\n  TReturn = PullRow<TTable, TSchema>,\n  TContext extends BaseDefaultContext = DefaultContext,\n>(\n  query:\n    | QueryOrQueryRequest<TTable, TInput, TOutput, TSchema, TReturn, TContext>\n    | Falsy,\n  options?: UseSuspenseQueryOptions | boolean,\n): QueryResult<TReturn> | MaybeQueryResult<TReturn> {\n  let enabled = true;\n  let ttl: TTL = DEFAULT_TTL_MS;\n  let suspendUntil: 'complete' | 'partial' = 'partial';\n  if (typeof options === 'boolean') {\n    enabled = options;\n  } else if (options) {\n    ({\n      enabled = true,\n      ttl = DEFAULT_TTL_MS,\n      suspendUntil = 'complete',\n    } = options);\n  }\n\n  const zero = useZero<TSchema, undefined, TContext>();\n\n  // When query is falsy, use disabled subscriber/snapshot to maintain hook order\n  const q = query ? addContextToQuery(query, zero.context) : undefined;\n  const view = q ? viewStore.getView(zero, q, enabled, ttl) : undefined;\n\n  // https://react.dev/reference/react/useSyncExternalStore\n  // Always call useSyncExternalStore to maintain consistent hook order\n  const snapshot = useSyncExternalStore(\n    view?.subscribeReactInternals ?? disabledSubscriber,\n    view?.getSnapshot ??\n      (getDisabledSnapshot as () => MaybeQueryResult<TReturn>),\n    view?.getSnapshot ??\n      (getDisabledSnapshot as () => MaybeQueryResult<TReturn>),\n  );\n\n  if (view && enabled) {\n    if (suspendUntil === 'complete' && !view.complete) {\n      suspend(view.waitForComplete());\n    }\n\n    if (suspendUntil === 'partial' && !view.nonEmpty) {\n      suspend(view.waitForNonEmpty());\n    }\n  }\n\n  return snapshot;\n}\n\nconst emptyArray: unknown[] = [];\nconst disabledSubscriber = () => () => {};\n\nconst resultTypeUnknown = {type: 'unknown'} as const;\nconst resultTypeComplete = {type: 'complete'} as const;\nconst resultTypeError = {type: 'error'} as const;\n\nconst disabledQuerySnapshot = [undefined, resultTypeUnknown] as const;\nconst getDisabledSnapshot = () => disabledQuerySnapshot;\n\nconst emptySnapshotSingularUnknown = [undefined, resultTypeUnknown] as const;\nconst emptySnapshotSingularComplete = [undefined, resultTypeComplete] as const;\nconst emptySnapshotSingularErrorUnknown = [undefined, resultTypeError] as const;\nconst emptySnapshotPluralUnknown = [emptyArray, resultTypeUnknown] as const;\nconst emptySnapshotPluralComplete = [emptyArray, resultTypeComplete] as const;\nconst emptySnapshotErrorUnknown = [emptyArray, resultTypeError] as const;\n\nfunction getDefaultSnapshot<TReturn>(singular: boolean): QueryResult<TReturn> {\n  return (\n    singular ? emptySnapshotSingularUnknown : emptySnapshotPluralUnknown\n  ) as QueryResult<TReturn>;\n}\n\n/**\n * Returns a new snapshot or one of the empty predefined ones. Returning the\n * predefined ones is important to prevent unnecessary re-renders in React.\n */\nfunction getSnapshot<TReturn>(\n  singular: boolean,\n  data: HumanReadable<TReturn>,\n  resultType: ResultType,\n  retryFn: () => void,\n  error?: ErroredQuery,\n): QueryResult<TReturn> {\n  if (singular && data === undefined) {\n    switch (resultType) {\n      case 'error':\n        if (error) {\n          return [\n            undefined,\n            makeError(retryFn, error),\n          ] as unknown as QueryResult<TReturn>;\n        }\n        return emptySnapshotSingularErrorUnknown as unknown as QueryResult<TReturn>;\n      case 'complete':\n        return emptySnapshotSingularComplete as unknown as QueryResult<TReturn>;\n      case 'unknown':\n        return emptySnapshotSingularUnknown as unknown as QueryResult<TReturn>;\n    }\n  }\n\n  if (!singular && (data as unknown[]).length === 0) {\n    switch (resultType) {\n      case 'error':\n        if (error) {\n          return [\n            emptyArray,\n            makeError(retryFn, error),\n          ] as unknown as QueryResult<TReturn>;\n        }\n        return emptySnapshotErrorUnknown as unknown as QueryResult<TReturn>;\n      case 'complete':\n        return emptySnapshotPluralComplete as unknown as QueryResult<TReturn>;\n      case 'unknown':\n        return emptySnapshotPluralUnknown as unknown as QueryResult<TReturn>;\n    }\n  }\n\n  switch (resultType) {\n    case 'error':\n      if (error) {\n        return [data, makeError(retryFn, error)];\n      }\n      return [\n        data,\n        makeError(retryFn, {\n          error: 'app',\n          id: 'unknown',\n          name: 'unknown',\n          message: 'An unknown error occurred',\n        }),\n      ];\n    case 'complete':\n      return [data, resultTypeComplete];\n    case 'unknown':\n      return [data, resultTypeUnknown];\n  }\n}\n\nfunction makeError(retry: () => void, error: ErroredQuery): QueryErrorDetails {\n  const message = error.message ?? 'An unknown error occurred';\n  return {\n    type: 'error',\n    retry,\n    refetch: retry,\n    error: {\n      type: error.error,\n      message,\n      ...(error.details ? {details: error.details} : {}),\n    },\n  };\n}\n\ndeclare const TESTING: boolean;\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyViewWrapper = ViewWrapper<any, any, any, any, any>;\n\nconst allViews = new WeakMap<ViewStore, Map<string, AnyViewWrapper>>();\n\nexport function getAllViewsSizeForTesting(store: ViewStore): number {\n  if (TESTING) {\n    return allViews.get(store)?.size ?? 0;\n  }\n  return 0;\n}\n\n/**\n * A global store of all active views.\n *\n * React subscribes and unsubscribes to these views\n * via `useSyncExternalStore`.\n *\n * Managing views through `useEffect` or `useLayoutEffect` causes\n * inconsistencies because effects run after render.\n *\n * For example, if useQuery used use*Effect in the component below:\n * ```ts\n * function Foo({issueID}) {\n *   const issue = useQuery(z.query.issue.where('id', issueID).one());\n *   if (issue?.id !== undefined && issue.id !== issueID) {\n *     console.log('MISMATCH!', issue.id, issueID);\n *   }\n * }\n * ```\n *\n * `MISMATCH` will be printed whenever the `issueID` prop changes.\n *\n * This is because the component will render once with\n * the old state returned from `useQuery`. Then the effect inside\n * `useQuery` will run. The component will render again with the new\n * state. This inconsistent transition can cause unexpected results.\n *\n * Emulating `useEffect` via `useState` and `if` causes resource leaks.\n * That is:\n *\n * ```ts\n * function useQuery(q) {\n *   const [oldHash, setOldHash] = useState();\n *   if (hash(q) !== oldHash) {\n *      // make new view\n *   }\n *\n *   useEffect(() => {\n *     return () => view.destroy();\n *   }, []);\n * }\n * ```\n *\n * I'm not sure why but in strict mode the cleanup function\n * fails to be called for the first instance of the view and only\n * cleans up later instances.\n *\n * Swapping `useState` to `useRef` has similar problems.\n */\nexport class ViewStore {\n  #views = new Map<string, AnyViewWrapper>();\n\n  constructor() {\n    if (TESTING) {\n      allViews.set(this, this.#views);\n    }\n  }\n\n  getView<\n    TTable extends keyof TSchema['tables'] & string,\n    TSchema extends BaseDefaultSchema,\n    TReturn,\n    MD extends CustomMutatorDefs | undefined,\n    TContext extends BaseDefaultContext,\n  >(\n    zero: Zero<TSchema, MD, TContext>,\n    q: Query<TTable, TSchema, TReturn>,\n    enabled: boolean,\n    ttl: TTL,\n  ): {\n    getSnapshot: () => QueryResult<TReturn>;\n    subscribeReactInternals: (internals: () => void) => () => void;\n    updateTTL: (ttl: TTL) => void;\n    waitForComplete: () => Promise<void>;\n    waitForNonEmpty: () => Promise<void>;\n    complete: boolean;\n    nonEmpty: boolean;\n  } {\n    const qi = asQueryInternals(q);\n\n    if (!enabled) {\n      return {\n        getSnapshot: () => getDefaultSnapshot(qi.format.singular),\n        subscribeReactInternals: disabledSubscriber,\n        updateTTL: () => {},\n        waitForComplete: () => Promise.resolve(),\n        waitForNonEmpty: () => Promise.resolve(),\n        complete: false,\n        nonEmpty: false,\n      };\n    }\n\n    const hash = qi.hash() + zero.clientID;\n    let existing = this.#views.get(hash);\n    if (!existing) {\n      existing = new ViewWrapper(q, zero, ttl, view => {\n        const currentView = this.#views.get(hash);\n        if (currentView && currentView !== view) {\n          // we replaced the view with a new one already.\n          return;\n        }\n        this.#views.delete(hash);\n      });\n      this.#views.set(hash, existing);\n    } else {\n      existing.updateTTL(ttl);\n    }\n    return existing as ViewWrapper<TTable, TSchema, TReturn, MD, TContext>;\n  }\n}\n\nconst viewStore = new ViewStore();\n\n/**\n * This wraps and ref counts a view.\n *\n * The only signal we have from React as to whether or not it is\n * done with a view is when it calls `unsubscribe`.\n *\n * In non-strict-mode we can clean up the view as soon\n * as the listener count goes to 0.\n *\n * In strict-mode, the listener count will go to 0 then a\n * new listener for the same view is immediately added back.\n *\n * This is why the `onMaterialized` and `onDematerialized` callbacks exist --\n * they allow a view which React is still referencing to be added\n * back into the store when React re-subscribes to it.\n *\n * This wrapper also exists to deal with the various\n * `useSyncExternalStore` caveats that cause excessive\n * re-renders and materializations.\n *\n * See: https://react.dev/reference/react/useSyncExternalStore#caveats\n * Especially:\n * 1. The store snapshot returned by getSnapshot must be immutable. If the underlying store has mutable data, return a new immutable snapshot if the data has changed. Otherwise, return a cached last snapshot.\n * 2. If a different subscribe function is passed during a re-render, React will re-subscribe to the store using the newly passed subscribe function. You can prevent this by declaring subscribe outside the component.\n */\nclass ViewWrapper<\n  TTable extends keyof TSchema['tables'] & string,\n  TSchema extends BaseDefaultSchema,\n  TReturn,\n  MD extends AnyMutatorRegistry | CustomMutatorDefs | undefined,\n  TContext extends BaseDefaultContext,\n> {\n  #view: TypedView<HumanReadable<TReturn>> | undefined;\n  readonly #onDematerialized;\n  readonly #query: Query<TTable, TSchema, TReturn>;\n  #snapshot: QueryResult<TReturn>;\n  readonly #reactInternals: Set<() => void> = new Set();\n  #ttl: TTL;\n  #complete = false;\n  #completeResolver = resolver<void>();\n  #nonEmpty = false;\n  #nonEmptyResolver = resolver<void>();\n  readonly #zero: Pick<Zero<TSchema, undefined, TContext>, 'materialize'>;\n  readonly #singular: boolean;\n  #destroyTimer: ReturnType<typeof setTimeout> | undefined;\n\n  constructor(\n    query: Query<TTable, TSchema, TReturn>,\n    zero: Pick<Zero<TSchema, undefined, TContext>, 'materialize'>,\n    ttl: TTL,\n    onDematerialized: (\n      view: ViewWrapper<TTable, TSchema, TReturn, MD, TContext>,\n    ) => void,\n  ) {\n    this.#query = query;\n    this.#zero = zero;\n    this.#ttl = ttl;\n    this.#onDematerialized = onDematerialized;\n    const {singular} = asQueryInternals(query).format;\n    this.#singular = singular;\n    this.#snapshot = getDefaultSnapshot(singular);\n    this.#materializeIfNeeded();\n  }\n\n  #onData = (\n    snap: Immutable<HumanReadable<TReturn>>,\n    resultType: ResultType,\n    error?: ErroredQuery,\n  ) => {\n    const data =\n      snap === undefined\n        ? snap\n        : (deepClone(snap as ReadonlyJSONValue) as HumanReadable<TReturn>);\n    this.#snapshot = getSnapshot(\n      this.#singular,\n      data,\n      resultType,\n      this.#retry,\n      error,\n    );\n    if (resultType === 'complete' || resultType === 'error') {\n      this.#complete = true;\n      this.#completeResolver.resolve();\n      this.#nonEmpty = true;\n      this.#nonEmptyResolver.resolve();\n    }\n\n    if (\n      this.#singular\n        ? this.#snapshot[0] !== undefined\n        : (this.#snapshot[0] as unknown[]).length !== 0\n    ) {\n      this.#nonEmpty = true;\n      this.#nonEmptyResolver.resolve();\n    }\n\n    for (const internals of this.#reactInternals) {\n      internals();\n    }\n  };\n\n  /**\n   * Called by the user to force a retry of the query\n   * in the case the query errored.\n   */\n  #retry = () => {\n    this.#view?.destroy();\n    this.#view = undefined;\n    this.#materializeIfNeeded();\n  };\n\n  #materializeIfNeeded = () => {\n    if (this.#view) {\n      return;\n    }\n    this.#view = this.#zero.materialize(this.#query, {\n      ttl: this.#ttl,\n    });\n    this.#view.addListener(this.#onData);\n  };\n\n  getSnapshot = () => this.#snapshot;\n\n  subscribeReactInternals = (internals: () => void): (() => void) => {\n    this.#reactInternals.add(internals);\n    // Cancel any pending destroy timer from a previous unsubscribe.\n    // Without this, rapid unsub/resub cycles accumulate stale timers\n    // that can fire during a gap between unsubscribe and resubscribe,\n    // destroying the view even though it was actively used.\n    if (this.#destroyTimer !== undefined) {\n      clearTimeout(this.#destroyTimer);\n      this.#destroyTimer = undefined;\n    }\n    this.#materializeIfNeeded();\n    return () => {\n      this.#reactInternals.delete(internals);\n\n      // only schedule a cleanup task if we have no listeners left\n      if (this.#reactInternals.size === 0) {\n        this.#destroyTimer = setTimeout(() => {\n          this.#destroyTimer = undefined;\n\n          // We already destroyed the view\n          if (this.#view === undefined) {\n            return;\n          }\n\n          // Someone re-registered a listener on this view before the timeout elapsed.\n          // This happens often in strict-mode which forces a component\n          // to mount, unmount, remount.\n          if (this.#reactInternals.size > 0) {\n            return;\n          }\n\n          this.#view.destroy();\n          this.#view = undefined;\n          this.#complete = false;\n          this.#completeResolver = resolver();\n          this.#nonEmpty = false;\n          this.#nonEmptyResolver = resolver();\n          this.#onDematerialized(this);\n        }, 10);\n      }\n    };\n  };\n\n  updateTTL(ttl: TTL): void {\n    this.#ttl = ttl;\n    this.#view?.updateTTL(ttl);\n  }\n\n  get complete() {\n    return this.#complete;\n  }\n\n  waitForComplete(): Promise<void> {\n    return this.#completeResolver.promise;\n  }\n\n  get nonEmpty() {\n    return this.#nonEmpty;\n  }\n\n  waitForNonEmpty(): Promise<void> {\n    return this.#nonEmptyResolver.promise;\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;AAwEA,MAAM,WAAY,MAAgD;AAClE,MAAM,UAAyC,WAC3C,WACA,CAAA,MAAK;AACH,QAAM;AACR;AAsCG,SAAS,SAQd,OAGA,SACkD;AAClD,MAAI,UAAU;AACd,MAAI,MAAW;AACf,MAAI,OAAO,YAAY,WAAW;AAChC,cAAU;AAAA,EACZ,WAAW,SAAS;AAClB,KAAC,EAAC,UAAU,MAAM,MAAM,mBAAkB;AAAA,EAC5C;AAEA,QAAM,OAAO,QAAA;AAGb,QAAM,IAAI,QAAQ,kBAAkB,OAAO,KAAK,OAAO,IAAI;AAC3D,QAAM,OAAO,IAAI,UAAU,QAAQ,MAAM,GAAG,SAAS,GAAG,IAAI;AAI5D,SAAO;AAAA,IACL,MAAM,2BAA2B;AAAA,IACjC,MAAM,eACH;AAAA,IACH,MAAM,eACH;AAAA,EAAA;AAEP;AAsCO,SAAS,iBAQd,OAGA,SACkD;AAClD,MAAI,UAAU;AACd,MAAI,MAAW;AACf,MAAI,eAAuC;AAC3C,MAAI,OAAO,YAAY,WAAW;AAChC,cAAU;AAAA,EACZ,WAAW,SAAS;AAClB,KAAC;AAAA,MACC,UAAU;AAAA,MACV,MAAM;AAAA,MACN,eAAe;AAAA,IAAA,IACb;AAAA,EACN;AAEA,QAAM,OAAO,QAAA;AAGb,QAAM,IAAI,QAAQ,kBAAkB,OAAO,KAAK,OAAO,IAAI;AAC3D,QAAM,OAAO,IAAI,UAAU,QAAQ,MAAM,GAAG,SAAS,GAAG,IAAI;AAI5D,QAAM,WAAW;AAAA,IACf,MAAM,2BAA2B;AAAA,IACjC,MAAM,eACH;AAAA,IACH,MAAM,eACH;AAAA,EAAA;AAGL,MAAI,QAAQ,SAAS;AACnB,QAAI,iBAAiB,cAAc,CAAC,KAAK,UAAU;AACjD,cAAQ,KAAK,iBAAiB;AAAA,IAChC;AAEA,QAAI,iBAAiB,aAAa,CAAC,KAAK,UAAU;AAChD,cAAQ,KAAK,iBAAiB;AAAA,IAChC;AAAA,EACF;AAEA,SAAO;AACT;AAEA,MAAM,aAAwB,CAAA;AAC9B,MAAM,qBAAqB,MAAM,MAAM;AAAC;AAExC,MAAM,oBAAoB,EAAC,MAAM,UAAA;AACjC,MAAM,qBAAqB,EAAC,MAAM,WAAA;AAClC,MAAM,kBAAkB,EAAC,MAAM,QAAA;AAE/B,MAAM,wBAAwB,CAAC,QAAW,iBAAiB;AAC3D,MAAM,sBAAsB,MAAM;AAElC,MAAM,+BAA+B,CAAC,QAAW,iBAAiB;AAClE,MAAM,gCAAgC,CAAC,QAAW,kBAAkB;AACpE,MAAM,oCAAoC,CAAC,QAAW,eAAe;AACrE,MAAM,6BAA6B,CAAC,YAAY,iBAAiB;AACjE,MAAM,8BAA8B,CAAC,YAAY,kBAAkB;AACnE,MAAM,4BAA4B,CAAC,YAAY,eAAe;AAE9D,SAAS,mBAA4B,UAAyC;AAC5E,SACE,WAAW,+BAA+B;AAE9C;AAMA,SAAS,YACP,UACA,MACA,YACA,SACA,OACsB;AACtB,MAAI,YAAY,SAAS,QAAW;AAClC,YAAQ,YAAA;AAAA,MACN,KAAK;AACH,YAAI,OAAO;AACT,iBAAO;AAAA,YACL;AAAA,YACA,UAAU,SAAS,KAAK;AAAA,UAAA;AAAA,QAE5B;AACA,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,IAAA;AAAA,EAEb;AAEA,MAAI,CAAC,YAAa,KAAmB,WAAW,GAAG;AACjD,YAAQ,YAAA;AAAA,MACN,KAAK;AACH,YAAI,OAAO;AACT,iBAAO;AAAA,YACL;AAAA,YACA,UAAU,SAAS,KAAK;AAAA,UAAA;AAAA,QAE5B;AACA,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,IAAA;AAAA,EAEb;AAEA,UAAQ,YAAA;AAAA,IACN,KAAK;AACH,UAAI,OAAO;AACT,eAAO,CAAC,MAAM,UAAU,SAAS,KAAK,CAAC;AAAA,MACzC;AACA,aAAO;AAAA,QACL;AAAA,QACA,UAAU,SAAS;AAAA,UACjB,OAAO;AAAA,UAGP,SAAS;AAAA,QAAA,CACV;AAAA,MAAA;AAAA,IAEL,KAAK;AACH,aAAO,CAAC,MAAM,kBAAkB;AAAA,IAClC,KAAK;AACH,aAAO,CAAC,MAAM,iBAAiB;AAAA,EAAA;AAErC;AAEA,SAAS,UAAU,OAAmB,OAAwC;AAC5E,QAAM,UAAU,MAAM,WAAW;AACjC,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,SAAS;AAAA,IACT,OAAO;AAAA,MACL,MAAM,MAAM;AAAA,MACZ;AAAA,MACA,GAAI,MAAM,UAAU,EAAC,SAAS,MAAM,QAAA,IAAW,CAAA;AAAA,IAAC;AAAA,EAClD;AAEJ;AAgEO,MAAM,UAAU;AAAA,EACrB,6BAAa,IAAA;AAAA,EAEb,cAAc;AAAA,EAId;AAAA,EAEA,QAOE,MACA,GACA,SACA,KASA;AACA,UAAM,KAAK,iBAAiB,CAAC;AAE7B,QAAI,CAAC,SAAS;AACZ,aAAO;AAAA,QACL,aAAa,MAAM,mBAAmB,GAAG,OAAO,QAAQ;AAAA,QACxD,yBAAyB;AAAA,QACzB,WAAW,MAAM;AAAA,QAAC;AAAA,QAClB,iBAAiB,MAAM,QAAQ,QAAA;AAAA,QAC/B,iBAAiB,MAAM,QAAQ,QAAA;AAAA,QAC/B,UAAU;AAAA,QACV,UAAU;AAAA,MAAA;AAAA,IAEd;AAEA,UAAM,OAAO,GAAG,KAAA,IAAS,KAAK;AAC9B,QAAI,WAAW,KAAK,OAAO,IAAI,IAAI;AACnC,QAAI,CAAC,UAAU;AACb,iBAAW,IAAI,YAAY,GAAG,MAAM,KAAK,CAAA,SAAQ;AAC/C,cAAM,cAAc,KAAK,OAAO,IAAI,IAAI;AACxC,YAAI,eAAe,gBAAgB,MAAM;AAEvC;AAAA,QACF;AACA,aAAK,OAAO,OAAO,IAAI;AAAA,MACzB,CAAC;AACD,WAAK,OAAO,IAAI,MAAM,QAAQ;AAAA,IAChC,OAAO;AACL,eAAS,UAAU,GAAG;AAAA,IACxB;AACA,WAAO;AAAA,EACT;AACF;AAEA,MAAM,YAAY,IAAI,UAAA;AA2BtB,MAAM,YAMJ;AAAA,EACA;AAAA,EACS;AAAA,EACA;AAAA,EACT;AAAA,EACS,sCAAuC,IAAA;AAAA,EAChD;AAAA,EACA,YAAY;AAAA,EACZ,oBAAoB,SAAA;AAAA,EACpB,YAAY;AAAA,EACZ,oBAAoB,SAAA;AAAA,EACX;AAAA,EACA;AAAA,EACT;AAAA,EAEA,YACE,OACA,MACA,KACA,kBAGA;AACA,SAAK,SAAS;AACd,SAAK,QAAQ;AACb,SAAK,OAAO;AACZ,SAAK,oBAAoB;AACzB,UAAM,EAAC,SAAA,IAAY,iBAAiB,KAAK,EAAE;AAC3C,SAAK,YAAY;AACjB,SAAK,YAAY,mBAAmB,QAAQ;AAC5C,SAAK,qBAAA;AAAA,EACP;AAAA,EAEA,UAAU,CACR,MACA,YACA,UACG;AACH,UAAM,OACJ,SAAS,SACL,OACC,UAAU,IAAyB;AAC1C,SAAK,YAAY;AAAA,MACf,KAAK;AAAA,MACL;AAAA,MACA;AAAA,MACA,KAAK;AAAA,MACL;AAAA,IAAA;AAEF,QAAI,eAAe,cAAc,eAAe,SAAS;AACvD,WAAK,YAAY;AACjB,WAAK,kBAAkB,QAAA;AACvB,WAAK,YAAY;AACjB,WAAK,kBAAkB,QAAA;AAAA,IACzB;AAEA,QACE,KAAK,YACD,KAAK,UAAU,CAAC,MAAM,SACrB,KAAK,UAAU,CAAC,EAAgB,WAAW,GAChD;AACA,WAAK,YAAY;AACjB,WAAK,kBAAkB,QAAA;AAAA,IACzB;AAEA,eAAW,aAAa,KAAK,iBAAiB;AAC5C,gBAAA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,SAAS,MAAM;AACb,SAAK,OAAO,QAAA;AACZ,SAAK,QAAQ;AACb,SAAK,qBAAA;AAAA,EACP;AAAA,EAEA,uBAAuB,MAAM;AAC3B,QAAI,KAAK,OAAO;AACd;AAAA,IACF;AACA,SAAK,QAAQ,KAAK,MAAM,YAAY,KAAK,QAAQ;AAAA,MAC/C,KAAK,KAAK;AAAA,IAAA,CACX;AACD,SAAK,MAAM,YAAY,KAAK,OAAO;AAAA,EACrC;AAAA,EAEA,cAAc,MAAM,KAAK;AAAA,EAEzB,0BAA0B,CAAC,cAAwC;AACjE,SAAK,gBAAgB,IAAI,SAAS;AAKlC,QAAI,KAAK,kBAAkB,QAAW;AACpC,mBAAa,KAAK,aAAa;AAC/B,WAAK,gBAAgB;AAAA,IACvB;AACA,SAAK,qBAAA;AACL,WAAO,MAAM;AACX,WAAK,gBAAgB,OAAO,SAAS;AAGrC,UAAI,KAAK,gBAAgB,SAAS,GAAG;AACnC,aAAK,gBAAgB,WAAW,MAAM;AACpC,eAAK,gBAAgB;AAGrB,cAAI,KAAK,UAAU,QAAW;AAC5B;AAAA,UACF;AAKA,cAAI,KAAK,gBAAgB,OAAO,GAAG;AACjC;AAAA,UACF;AAEA,eAAK,MAAM,QAAA;AACX,eAAK,QAAQ;AACb,eAAK,YAAY;AACjB,eAAK,oBAAoB,SAAA;AACzB,eAAK,YAAY;AACjB,eAAK,oBAAoB,SAAA;AACzB,eAAK,kBAAkB,IAAI;AAAA,QAC7B,GAAG,EAAE;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAAA,EAEA,UAAU,KAAgB;AACxB,SAAK,OAAO;AACZ,SAAK,OAAO,UAAU,GAAG;AAAA,EAC3B;AAAA,EAEA,IAAI,WAAW;AACb,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,kBAAiC;AAC/B,WAAO,KAAK,kBAAkB;AAAA,EAChC;AAAA,EAEA,IAAI,WAAW;AACb,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,kBAAiC;AAC/B,WAAO,KAAK,kBAAkB;AAAA,EAChC;AACF;"}
+{"version":3,"file":"use-query.js","names":["#views","#onDematerialized","#query","#reactInternals","#zero","#singular","#ttl","#snapshot","#materializeIfNeeded","#retry","#complete","#completeResolver","#nonEmpty","#nonEmptyResolver","#view","#onData","#destroyTimer"],"sources":["../../../../zero-react/src/use-query.tsx"],"sourcesContent":["import {resolver} from '@rocicorp/resolver';\nimport React, {useSyncExternalStore} from 'react';\nimport {\n  type Immutable,\n  addContextToQuery,\n  asQueryInternals,\n  deepClone,\n  DEFAULT_TTL_MS,\n} from './bindings.ts';\nimport {useZero} from './zero-provider.tsx';\nimport type {\n  AnyMutatorRegistry,\n  BaseDefaultContext,\n  BaseDefaultSchema,\n  CustomMutatorDefs,\n  DefaultContext,\n  DefaultSchema,\n  ErroredQuery,\n  Falsy,\n  HumanReadable,\n  PullRow,\n  Query,\n  QueryErrorDetails,\n  QueryOrQueryRequest,\n  QueryResultDetails,\n  ReadonlyJSONValue,\n  ResultType,\n  TTL,\n  TypedView,\n  Zero,\n} from './zero.ts';\n\nexport type QueryResult<TReturn> = readonly [\n  HumanReadable<TReturn>,\n  QueryResultDetails & {},\n];\n\n/**\n * Result type for \"maybe queries\" - queries that may be falsy.\n * The data value can be undefined when the query is falsy/disabled.\n */\nexport type MaybeQueryResult<TReturn> = readonly [\n  HumanReadable<TReturn> | undefined,\n  QueryResultDetails & {},\n];\n\nexport type UseQueryOptions = {\n  enabled?: boolean | undefined;\n  /**\n   * Time to live (TTL) in seconds. Controls how long query results are cached\n   * after the query is removed. During this time, Zero continues to sync the query.\n   * Default is 'never'.\n   */\n  ttl?: TTL | undefined;\n};\n\nexport type UseSuspenseQueryOptions = UseQueryOptions & {\n  /**\n   * Whether to suspend until:\n   * - 'partial': the query has partial results (partial array or defined\n   *   value for singular results) which may be of result type 'unknown',\n   *   or the query result type is 'complete' (in which case results may be\n   *   empty).  This is useful for suspending until there are partial\n   *   optimistic local results, or the query has completed loading from the\n   *   server.\n   * - 'complete': the query result type is 'complete'.\n   *\n   * Default is 'partial'.\n   */\n  suspendUntil?: 'complete' | 'partial';\n};\n\nconst reactUse = (React as {use?: (p: Promise<unknown>) => void}).use;\nconst suspend: (p: Promise<unknown>) => void = reactUse\n  ? reactUse\n  : p => {\n      throw p;\n    };\n\n// Overload 1: Query\nexport function useQuery<\n  TTable extends keyof TSchema['tables'] & string,\n  TInput extends ReadonlyJSONValue | undefined,\n  TOutput extends ReadonlyJSONValue | undefined,\n  TSchema extends BaseDefaultSchema = DefaultSchema,\n  TReturn = PullRow<TTable, TSchema>,\n  TContext extends BaseDefaultContext = DefaultContext,\n>(\n  query: QueryOrQueryRequest<\n    TTable,\n    TInput,\n    TOutput,\n    TSchema,\n    TReturn,\n    TContext\n  >,\n  options?: UseQueryOptions | boolean,\n): QueryResult<TReturn>;\n\n// Overload 2: Maybe query\nexport function useQuery<\n  TTable extends keyof TSchema['tables'] & string,\n  TInput extends ReadonlyJSONValue | undefined,\n  TOutput extends ReadonlyJSONValue | undefined,\n  TSchema extends BaseDefaultSchema = DefaultSchema,\n  TReturn = PullRow<TTable, TSchema>,\n  TContext extends BaseDefaultContext = DefaultContext,\n>(\n  query:\n    | QueryOrQueryRequest<TTable, TInput, TOutput, TSchema, TReturn, TContext>\n    | Falsy,\n  options?: UseQueryOptions | boolean,\n): MaybeQueryResult<TReturn>;\n\n// Implementation\nexport function useQuery<\n  TTable extends keyof TSchema['tables'] & string,\n  TInput extends ReadonlyJSONValue | undefined,\n  TOutput extends ReadonlyJSONValue | undefined,\n  TSchema extends BaseDefaultSchema = DefaultSchema,\n  TReturn = PullRow<TTable, TSchema>,\n  TContext extends BaseDefaultContext = DefaultContext,\n>(\n  query:\n    | QueryOrQueryRequest<TTable, TInput, TOutput, TSchema, TReturn, TContext>\n    | Falsy,\n  options?: UseQueryOptions | boolean,\n): QueryResult<TReturn> | MaybeQueryResult<TReturn> {\n  let enabled = true;\n  let ttl: TTL = DEFAULT_TTL_MS;\n  if (typeof options === 'boolean') {\n    enabled = options;\n  } else if (options) {\n    ({enabled = true, ttl = DEFAULT_TTL_MS} = options);\n  }\n\n  const zero = useZero<TSchema, undefined, TContext>();\n\n  // When query is falsy, use disabled subscriber/snapshot to maintain hook order\n  const q = query ? addContextToQuery(query, zero.context) : undefined;\n  const view = q ? viewStore.getView(zero, q, enabled, ttl) : undefined;\n\n  // https://react.dev/reference/react/useSyncExternalStore\n  // Always call useSyncExternalStore to maintain consistent hook order\n  return useSyncExternalStore(\n    view?.subscribeReactInternals ?? disabledSubscriber,\n    view?.getSnapshot ??\n      (getDisabledSnapshot as () => MaybeQueryResult<TReturn>),\n    view?.getSnapshot ??\n      (getDisabledSnapshot as () => MaybeQueryResult<TReturn>),\n  );\n}\n\n// Overload 1: Query\nexport function useSuspenseQuery<\n  TTable extends keyof TSchema['tables'] & string,\n  TInput extends ReadonlyJSONValue | undefined,\n  TOutput extends ReadonlyJSONValue | undefined,\n  TSchema extends BaseDefaultSchema = DefaultSchema,\n  TReturn = PullRow<TTable, TSchema>,\n  TContext extends BaseDefaultContext = DefaultContext,\n>(\n  query: QueryOrQueryRequest<\n    TTable,\n    TInput,\n    TOutput,\n    TSchema,\n    TReturn,\n    TContext\n  >,\n  options?: UseSuspenseQueryOptions | boolean,\n): QueryResult<TReturn>;\n\n// Overload 2: Maybe query\nexport function useSuspenseQuery<\n  TTable extends keyof TSchema['tables'] & string,\n  TInput extends ReadonlyJSONValue | undefined,\n  TOutput extends ReadonlyJSONValue | undefined,\n  TSchema extends BaseDefaultSchema = DefaultSchema,\n  TReturn = PullRow<TTable, TSchema>,\n  TContext extends BaseDefaultContext = DefaultContext,\n>(\n  query:\n    | QueryOrQueryRequest<TTable, TInput, TOutput, TSchema, TReturn, TContext>\n    | Falsy,\n  options?: UseSuspenseQueryOptions | boolean,\n): MaybeQueryResult<TReturn>;\n\n// Implementation\nexport function useSuspenseQuery<\n  TTable extends keyof TSchema['tables'] & string,\n  TInput extends ReadonlyJSONValue | undefined,\n  TOutput extends ReadonlyJSONValue | undefined,\n  TSchema extends BaseDefaultSchema = DefaultSchema,\n  TReturn = PullRow<TTable, TSchema>,\n  TContext extends BaseDefaultContext = DefaultContext,\n>(\n  query:\n    | QueryOrQueryRequest<TTable, TInput, TOutput, TSchema, TReturn, TContext>\n    | Falsy,\n  options?: UseSuspenseQueryOptions | boolean,\n): QueryResult<TReturn> | MaybeQueryResult<TReturn> {\n  let enabled = true;\n  let ttl: TTL = DEFAULT_TTL_MS;\n  let suspendUntil: 'complete' | 'partial' = 'partial';\n  if (typeof options === 'boolean') {\n    enabled = options;\n  } else if (options) {\n    ({\n      enabled = true,\n      ttl = DEFAULT_TTL_MS,\n      suspendUntil = 'complete',\n    } = options);\n  }\n\n  const zero = useZero<TSchema, undefined, TContext>();\n\n  // When query is falsy, use disabled subscriber/snapshot to maintain hook order\n  const q = query ? addContextToQuery(query, zero.context) : undefined;\n  const view = q ? viewStore.getView(zero, q, enabled, ttl) : undefined;\n\n  // https://react.dev/reference/react/useSyncExternalStore\n  // Always call useSyncExternalStore to maintain consistent hook order\n  const snapshot = useSyncExternalStore(\n    view?.subscribeReactInternals ?? disabledSubscriber,\n    view?.getSnapshot ??\n      (getDisabledSnapshot as () => MaybeQueryResult<TReturn>),\n    view?.getSnapshot ??\n      (getDisabledSnapshot as () => MaybeQueryResult<TReturn>),\n  );\n\n  if (view && enabled) {\n    if (suspendUntil === 'complete' && !view.complete) {\n      suspend(view.waitForComplete());\n    }\n\n    if (suspendUntil === 'partial' && !view.nonEmpty) {\n      suspend(view.waitForNonEmpty());\n    }\n  }\n\n  return snapshot;\n}\n\nconst emptyArray: unknown[] = [];\nconst disabledSubscriber = () => () => {};\n\nconst resultTypeUnknown = {type: 'unknown'} as const;\nconst resultTypeComplete = {type: 'complete'} as const;\nconst resultTypeError = {type: 'error'} as const;\n\nconst disabledQuerySnapshot = [undefined, resultTypeUnknown] as const;\nconst getDisabledSnapshot = () => disabledQuerySnapshot;\n\nconst emptySnapshotSingularUnknown = [undefined, resultTypeUnknown] as const;\nconst emptySnapshotSingularComplete = [undefined, resultTypeComplete] as const;\nconst emptySnapshotSingularErrorUnknown = [undefined, resultTypeError] as const;\nconst emptySnapshotPluralUnknown = [emptyArray, resultTypeUnknown] as const;\nconst emptySnapshotPluralComplete = [emptyArray, resultTypeComplete] as const;\nconst emptySnapshotErrorUnknown = [emptyArray, resultTypeError] as const;\n\nfunction getDefaultSnapshot<TReturn>(singular: boolean): QueryResult<TReturn> {\n  return (\n    singular ? emptySnapshotSingularUnknown : emptySnapshotPluralUnknown\n  ) as QueryResult<TReturn>;\n}\n\n/**\n * Returns a new snapshot or one of the empty predefined ones. Returning the\n * predefined ones is important to prevent unnecessary re-renders in React.\n */\nfunction getSnapshot<TReturn>(\n  singular: boolean,\n  data: HumanReadable<TReturn>,\n  resultType: ResultType,\n  retryFn: () => void,\n  error?: ErroredQuery,\n): QueryResult<TReturn> {\n  if (singular && data === undefined) {\n    switch (resultType) {\n      case 'error':\n        if (error) {\n          return [\n            undefined,\n            makeError(retryFn, error),\n          ] as unknown as QueryResult<TReturn>;\n        }\n        return emptySnapshotSingularErrorUnknown as unknown as QueryResult<TReturn>;\n      case 'complete':\n        return emptySnapshotSingularComplete as unknown as QueryResult<TReturn>;\n      case 'unknown':\n        return emptySnapshotSingularUnknown as unknown as QueryResult<TReturn>;\n    }\n  }\n\n  if (!singular && (data as unknown[]).length === 0) {\n    switch (resultType) {\n      case 'error':\n        if (error) {\n          return [\n            emptyArray,\n            makeError(retryFn, error),\n          ] as unknown as QueryResult<TReturn>;\n        }\n        return emptySnapshotErrorUnknown as unknown as QueryResult<TReturn>;\n      case 'complete':\n        return emptySnapshotPluralComplete as unknown as QueryResult<TReturn>;\n      case 'unknown':\n        return emptySnapshotPluralUnknown as unknown as QueryResult<TReturn>;\n    }\n  }\n\n  switch (resultType) {\n    case 'error':\n      if (error) {\n        return [data, makeError(retryFn, error)];\n      }\n      return [\n        data,\n        makeError(retryFn, {\n          error: 'app',\n          id: 'unknown',\n          name: 'unknown',\n          message: 'An unknown error occurred',\n        }),\n      ];\n    case 'complete':\n      return [data, resultTypeComplete];\n    case 'unknown':\n      return [data, resultTypeUnknown];\n  }\n}\n\nfunction makeError(retry: () => void, error: ErroredQuery): QueryErrorDetails {\n  const message = error.message ?? 'An unknown error occurred';\n  return {\n    type: 'error',\n    retry,\n    refetch: retry,\n    error: {\n      type: error.error,\n      message,\n      ...(error.details ? {details: error.details} : {}),\n    },\n  };\n}\n\ndeclare const TESTING: boolean;\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyViewWrapper = ViewWrapper<any, any, any, any, any>;\n\nconst allViews = new WeakMap<ViewStore, Map<string, AnyViewWrapper>>();\n\nexport function getAllViewsSizeForTesting(store: ViewStore): number {\n  if (TESTING) {\n    return allViews.get(store)?.size ?? 0;\n  }\n  return 0;\n}\n\n/**\n * A global store of all active views.\n *\n * React subscribes and unsubscribes to these views\n * via `useSyncExternalStore`.\n *\n * Managing views through `useEffect` or `useLayoutEffect` causes\n * inconsistencies because effects run after render.\n *\n * For example, if useQuery used use*Effect in the component below:\n * ```ts\n * function Foo({issueID}) {\n *   const issue = useQuery(z.query.issue.where('id', issueID).one());\n *   if (issue?.id !== undefined && issue.id !== issueID) {\n *     console.log('MISMATCH!', issue.id, issueID);\n *   }\n * }\n * ```\n *\n * `MISMATCH` will be printed whenever the `issueID` prop changes.\n *\n * This is because the component will render once with\n * the old state returned from `useQuery`. Then the effect inside\n * `useQuery` will run. The component will render again with the new\n * state. This inconsistent transition can cause unexpected results.\n *\n * Emulating `useEffect` via `useState` and `if` causes resource leaks.\n * That is:\n *\n * ```ts\n * function useQuery(q) {\n *   const [oldHash, setOldHash] = useState();\n *   if (hash(q) !== oldHash) {\n *      // make new view\n *   }\n *\n *   useEffect(() => {\n *     return () => view.destroy();\n *   }, []);\n * }\n * ```\n *\n * I'm not sure why but in strict mode the cleanup function\n * fails to be called for the first instance of the view and only\n * cleans up later instances.\n *\n * Swapping `useState` to `useRef` has similar problems.\n */\nexport class ViewStore {\n  #views = new Map<string, AnyViewWrapper>();\n\n  constructor() {\n    if (TESTING) {\n      allViews.set(this, this.#views);\n    }\n  }\n\n  getView<\n    TTable extends keyof TSchema['tables'] & string,\n    TSchema extends BaseDefaultSchema,\n    TReturn,\n    MD extends CustomMutatorDefs | undefined,\n    TContext extends BaseDefaultContext,\n  >(\n    zero: Zero<TSchema, MD, TContext>,\n    q: Query<TTable, TSchema, TReturn>,\n    enabled: boolean,\n    ttl: TTL,\n  ): {\n    getSnapshot: () => QueryResult<TReturn>;\n    subscribeReactInternals: (internals: () => void) => () => void;\n    updateTTL: (ttl: TTL) => void;\n    waitForComplete: () => Promise<void>;\n    waitForNonEmpty: () => Promise<void>;\n    complete: boolean;\n    nonEmpty: boolean;\n  } {\n    const qi = asQueryInternals(q);\n\n    if (!enabled) {\n      return {\n        getSnapshot: () => getDefaultSnapshot(qi.format.singular),\n        subscribeReactInternals: disabledSubscriber,\n        updateTTL: () => {},\n        waitForComplete: () => Promise.resolve(),\n        waitForNonEmpty: () => Promise.resolve(),\n        complete: false,\n        nonEmpty: false,\n      };\n    }\n\n    const hash = qi.hash() + zero.clientID;\n    let existing = this.#views.get(hash);\n    if (!existing) {\n      existing = new ViewWrapper(q, zero, ttl, view => {\n        const currentView = this.#views.get(hash);\n        if (currentView && currentView !== view) {\n          // we replaced the view with a new one already.\n          return;\n        }\n        this.#views.delete(hash);\n      });\n      this.#views.set(hash, existing);\n    } else {\n      existing.updateTTL(ttl);\n    }\n    return existing as ViewWrapper<TTable, TSchema, TReturn, MD, TContext>;\n  }\n}\n\nconst viewStore = new ViewStore();\n\n/**\n * This wraps and ref counts a view.\n *\n * The only signal we have from React as to whether or not it is\n * done with a view is when it calls `unsubscribe`.\n *\n * In non-strict-mode we can clean up the view as soon\n * as the listener count goes to 0.\n *\n * In strict-mode, the listener count will go to 0 then a\n * new listener for the same view is immediately added back.\n *\n * This is why the `onMaterialized` and `onDematerialized` callbacks exist --\n * they allow a view which React is still referencing to be added\n * back into the store when React re-subscribes to it.\n *\n * This wrapper also exists to deal with the various\n * `useSyncExternalStore` caveats that cause excessive\n * re-renders and materializations.\n *\n * See: https://react.dev/reference/react/useSyncExternalStore#caveats\n * Especially:\n * 1. The store snapshot returned by getSnapshot must be immutable. If the underlying store has mutable data, return a new immutable snapshot if the data has changed. Otherwise, return a cached last snapshot.\n * 2. If a different subscribe function is passed during a re-render, React will re-subscribe to the store using the newly passed subscribe function. You can prevent this by declaring subscribe outside the component.\n */\nclass ViewWrapper<\n  TTable extends keyof TSchema['tables'] & string,\n  TSchema extends BaseDefaultSchema,\n  TReturn,\n  MD extends AnyMutatorRegistry | CustomMutatorDefs | undefined,\n  TContext extends BaseDefaultContext,\n> {\n  #view: TypedView<HumanReadable<TReturn>> | undefined;\n  readonly #onDematerialized;\n  readonly #query: Query<TTable, TSchema, TReturn>;\n  #snapshot: QueryResult<TReturn>;\n  readonly #reactInternals: Set<() => void> = new Set();\n  #ttl: TTL;\n  #complete = false;\n  #completeResolver = resolver<void>();\n  #nonEmpty = false;\n  #nonEmptyResolver = resolver<void>();\n  readonly #zero: Pick<Zero<TSchema, undefined, TContext>, 'materialize'>;\n  readonly #singular: boolean;\n  #destroyTimer: ReturnType<typeof setTimeout> | undefined;\n\n  constructor(\n    query: Query<TTable, TSchema, TReturn>,\n    zero: Pick<Zero<TSchema, undefined, TContext>, 'materialize'>,\n    ttl: TTL,\n    onDematerialized: (\n      view: ViewWrapper<TTable, TSchema, TReturn, MD, TContext>,\n    ) => void,\n  ) {\n    this.#query = query;\n    this.#zero = zero;\n    this.#ttl = ttl;\n    this.#onDematerialized = onDematerialized;\n    const {singular} = asQueryInternals(query).format;\n    this.#singular = singular;\n    this.#snapshot = getDefaultSnapshot(singular);\n    this.#materializeIfNeeded();\n  }\n\n  #onData = (\n    snap: Immutable<HumanReadable<TReturn>>,\n    resultType: ResultType,\n    error?: ErroredQuery,\n  ) => {\n    const data =\n      snap === undefined\n        ? snap\n        : (deepClone(snap as ReadonlyJSONValue) as HumanReadable<TReturn>);\n    this.#snapshot = getSnapshot(\n      this.#singular,\n      data,\n      resultType,\n      this.#retry,\n      error,\n    );\n    if (resultType === 'complete' || resultType === 'error') {\n      this.#complete = true;\n      this.#completeResolver.resolve();\n      this.#nonEmpty = true;\n      this.#nonEmptyResolver.resolve();\n    }\n\n    if (\n      this.#singular\n        ? this.#snapshot[0] !== undefined\n        : (this.#snapshot[0] as unknown[]).length !== 0\n    ) {\n      this.#nonEmpty = true;\n      this.#nonEmptyResolver.resolve();\n    }\n\n    for (const internals of this.#reactInternals) {\n      internals();\n    }\n  };\n\n  /**\n   * Called by the user to force a retry of the query\n   * in the case the query errored.\n   */\n  #retry = () => {\n    this.#view?.destroy();\n    this.#view = undefined;\n    this.#materializeIfNeeded();\n  };\n\n  #materializeIfNeeded = () => {\n    if (this.#view) {\n      return;\n    }\n    this.#view = this.#zero.materialize(this.#query, {\n      ttl: this.#ttl,\n    });\n    this.#view.addListener(this.#onData);\n  };\n\n  getSnapshot = () => this.#snapshot;\n\n  subscribeReactInternals = (internals: () => void): (() => void) => {\n    this.#reactInternals.add(internals);\n    // Cancel any pending destroy timer from a previous unsubscribe.\n    // Without this, rapid unsub/resub cycles accumulate stale timers\n    // that can fire during a gap between unsubscribe and resubscribe,\n    // destroying the view even though it was actively used.\n    if (this.#destroyTimer !== undefined) {\n      clearTimeout(this.#destroyTimer);\n      this.#destroyTimer = undefined;\n    }\n    this.#materializeIfNeeded();\n    return () => {\n      this.#reactInternals.delete(internals);\n\n      // only schedule a cleanup task if we have no listeners left\n      if (this.#reactInternals.size === 0) {\n        this.#destroyTimer = setTimeout(() => {\n          this.#destroyTimer = undefined;\n\n          // We already destroyed the view\n          if (this.#view === undefined) {\n            return;\n          }\n\n          // Someone re-registered a listener on this view before the timeout elapsed.\n          // This happens often in strict-mode which forces a component\n          // to mount, unmount, remount.\n          if (this.#reactInternals.size > 0) {\n            return;\n          }\n\n          this.#view.destroy();\n          this.#view = undefined;\n          this.#complete = false;\n          this.#completeResolver = resolver();\n          this.#nonEmpty = false;\n          this.#nonEmptyResolver = resolver();\n          this.#onDematerialized(this);\n        }, 10);\n      }\n    };\n  };\n\n  updateTTL(ttl: TTL): void {\n    this.#ttl = ttl;\n    this.#view?.updateTTL(ttl);\n  }\n\n  get complete() {\n    return this.#complete;\n  }\n\n  waitForComplete(): Promise<void> {\n    return this.#completeResolver.promise;\n  }\n\n  get nonEmpty() {\n    return this.#nonEmpty;\n  }\n\n  waitForNonEmpty(): Promise<void> {\n    return this.#nonEmptyResolver.promise;\n  }\n}\n"],"mappings":"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"}

package/out/zero-react/src/use-zero-online.js

@@ -1,14 +1,20 @@
-import { useSyncExternalStore } from "react";
 import { useZero } from "./zero-provider.js";
+import { useSyncExternalStore } from "react";
+//#region ../zero-react/src/use-zero-online.tsx
+/**
+* Hook to subscribe to the online status of the Zero instance.
+*
+* This is useful when you want to update state based on the online status.
+*
+* @returns The online status of the Zero instance.
+*
+* @deprecated Use {@linkcode useConnectionState} instead, which provides more detailed connection state.
+*/
 function useZeroOnline() {
-  const zero = useZero();
-  return useSyncExternalStore(
-    zero.onOnline,
-    () => zero.online,
-    () => zero.online
-  );
+	const zero = useZero();
+	return useSyncExternalStore(zero.onOnline, () => zero.online, () => zero.online);
 }
-export {
-  useZeroOnline
-};
-//# sourceMappingURL=use-zero-online.js.map
+//#endregion
+export { useZeroOnline };
+
+//# sourceMappingURL=use-zero-online.js.map

package/out/zero-react/src/use-zero-online.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-zero-online.js","sources":["../../../../zero-react/src/use-zero-online.tsx"],"sourcesContent":["import {useSyncExternalStore} from 'react';\nimport {useZero} from './zero-provider.tsx';\n\n/**\n * Hook to subscribe to the online status of the Zero instance.\n *\n * This is useful when you want to update state based on the online status.\n *\n * @returns The online status of the Zero instance.\n *\n * @deprecated Use {@linkcode useConnectionState} instead, which provides more detailed connection state.\n */\nexport function useZeroOnline(): boolean {\n  const zero = useZero();\n  return useSyncExternalStore(\n    zero.onOnline,\n    () => zero.online,\n    () => zero.online,\n  );\n}\n"],"names":[],"mappings":";;AAYO,SAAS,gBAAyB;AACvC,QAAM,OAAO,QAAA;AACb,SAAO;AAAA,IACL,KAAK;AAAA,IACL,MAAM,KAAK;AAAA,IACX,MAAM,KAAK;AAAA,EAAA;AAEf;"}
+{"version":3,"file":"use-zero-online.js","names":[],"sources":["../../../../zero-react/src/use-zero-online.tsx"],"sourcesContent":["import {useSyncExternalStore} from 'react';\nimport {useZero} from './zero-provider.tsx';\n\n/**\n * Hook to subscribe to the online status of the Zero instance.\n *\n * This is useful when you want to update state based on the online status.\n *\n * @returns The online status of the Zero instance.\n *\n * @deprecated Use {@linkcode useConnectionState} instead, which provides more detailed connection state.\n */\nexport function useZeroOnline(): boolean {\n  const zero = useZero();\n  return useSyncExternalStore(\n    zero.onOnline,\n    () => zero.online,\n    () => zero.online,\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAgB,gBAAyB;CACvC,MAAM,OAAO,SAAS;AACtB,QAAO,qBACL,KAAK,gBACC,KAAK,cACL,KAAK,OACZ"}

package/out/zero-react/src/zero-provider.js

@@ -1,77 +1,61 @@
-import { jsx } from "react/jsx-runtime";
-import { createContext, useContext, useState, useRef, useMemo, useEffect } from "react";
 import { stringCompare } from "../../shared/src/string-compare.js";
-import "../../shared/src/config.js";
-import "@rocicorp/resolver";
-import "../../shared/src/resolved-promises.js";
-import "../../shared/src/sleep.js";
-import "../../replicache/src/hash.js";
-import "../../replicache/src/deleted-clients.js";
-import "@rocicorp/lock";
-import "@rocicorp/logger";
-import "../../replicache/src/persist/client-groups.js";
-import "../../replicache/src/persist/clients.js";
-import "../../shared/src/json-schema.js";
-import "../../zero-protocol/src/custom-queries.js";
-import "js-xxhash";
-import "../../zero-protocol/src/client-schema.js";
-import "../../zero-schema/src/permissions.js";
-import "../../zero-protocol/src/ast.js";
 import { Zero } from "../../zero-client/src/client/zero.js";
-const ZeroContext = createContext(
-  void 0
-);
+import "./zero.js";
+import { createContext, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region ../zero-react/src/zero-provider.tsx
+var ZeroContext = createContext(void 0);
 function useZero() {
-  const zero = useContext(ZeroContext);
-  if (zero === void 0) {
-    throw new Error("useZero must be used within a ZeroProvider");
-  }
-  return zero;
+	const zero = useContext(ZeroContext);
+	if (zero === void 0) throw new Error("useZero must be used within a ZeroProvider");
+	return zero;
 }
+/**
+* @deprecated Use {@linkcode useZero} instead, alongside default types defined with:
+*
+* ```ts
+* declare module '@rocicorp/zero' {
+*   interface DefaultTypes {
+*     schema: typeof schema;
+*     context: Context;
+*   }
+* }
+*/
 function createUseZero() {
-  return () => useZero();
+	return () => useZero();
 }
-const NO_AUTH_SET = Symbol();
+var NO_AUTH_SET = Symbol();
 function ZeroProvider({ children, init, ...props }) {
-  const isExternalZero = "zero" in props;
-  const [zero, setZero] = useState(
-    isExternalZero ? props.zero : void 0
-  );
-  const auth = "auth" in props ? props.auth : NO_AUTH_SET;
-  const prevAuthRef = useRef(auth);
-  const keysWithoutAuth = useMemo(
-    () => Object.entries(props).filter(([key]) => key !== "auth").sort(([a], [b]) => stringCompare(a, b)).map(([_, value]) => value),
-    [props]
-  );
-  useEffect(() => {
-    if (isExternalZero) {
-      setZero(props.zero);
-      return;
-    }
-    const z = new Zero(props);
-    init?.(z);
-    setZero(z);
-    return () => {
-      void z.close();
-      setZero(void 0);
-    };
-  }, [init, ...keysWithoutAuth]);
-  useEffect(() => {
-    if (!zero || isExternalZero) return;
-    const authChanged = auth !== prevAuthRef.current;
-    if (authChanged) {
-      prevAuthRef.current = auth;
-      void zero.connection.connect({
-        auth: auth === NO_AUTH_SET ? void 0 : auth
-      });
-    }
-  }, [auth, zero]);
-  return zero && /* @__PURE__ */ jsx(ZeroContext.Provider, { value: zero, children });
+	const isExternalZero = "zero" in props;
+	const [zero, setZero] = useState(isExternalZero ? props.zero : void 0);
+	const auth = "auth" in props ? props.auth : NO_AUTH_SET;
+	const prevAuthRef = useRef(auth);
+	useEffect(() => {
+		if (isExternalZero) {
+			setZero(props.zero);
+			return;
+		}
+		const z = new Zero(props);
+		init?.(z);
+		setZero(z);
+		return () => {
+			z.close();
+			setZero(void 0);
+		};
+	}, [init, ...useMemo(() => Object.entries(props).filter(([key]) => key !== "auth").sort(([a], [b]) => stringCompare(a, b)).map(([_, value]) => value), [props])]);
+	useEffect(() => {
+		if (!zero || isExternalZero) return;
+		if (auth !== prevAuthRef.current) {
+			prevAuthRef.current = auth;
+			zero.connection.connect({ auth: auth === NO_AUTH_SET ? void 0 : auth });
+		}
+	}, [auth, zero]);
+	return zero && /* @__PURE__ */ jsx(ZeroContext.Provider, {
+		value: zero,
+		children
+	});
 }
-export {
-  ZeroContext,
-  ZeroProvider,
-  createUseZero,
-  useZero
-};
-//# sourceMappingURL=zero-provider.js.map
+//#endregion
+export { ZeroContext, ZeroProvider, createUseZero, useZero };
+
+//# sourceMappingURL=zero-provider.js.map

package/out/zero-react/src/zero-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"zero-provider.js","sources":["../../../../zero-react/src/zero-provider.tsx"],"sourcesContent":["import {\n  createContext,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from 'react';\nimport {stringCompare} from '../../shared/src/string-compare.ts';\nimport {\n  Zero,\n  type BaseDefaultContext,\n  type BaseDefaultSchema,\n  type CustomMutatorDefs,\n  type DefaultContext,\n  type DefaultSchema,\n  type ZeroOptions,\n} from './zero.ts';\n\n// oxlint-disable-next-line no-explicit-any\nexport const ZeroContext = createContext<Zero<any, any, any> | undefined>(\n  undefined,\n);\n\nexport function useZero<\n  S extends BaseDefaultSchema = DefaultSchema,\n  MD extends CustomMutatorDefs | undefined = undefined,\n  Context extends BaseDefaultContext = DefaultContext,\n>(): Zero<S, MD, Context> {\n  const zero = useContext(ZeroContext);\n  if (zero === undefined) {\n    throw new Error('useZero must be used within a ZeroProvider');\n  }\n  return zero as Zero<S, MD, Context>;\n}\n\n/**\n * @deprecated Use {@linkcode useZero} instead, alongside default types defined with:\n *\n * ```ts\n * declare module '@rocicorp/zero' {\n *   interface DefaultTypes {\n *     schema: typeof schema;\n *     context: Context;\n *   }\n * }\n */\nexport function createUseZero<\n  S extends BaseDefaultSchema = DefaultSchema,\n  MD extends CustomMutatorDefs | undefined = undefined,\n  Context extends BaseDefaultContext = DefaultContext,\n>() {\n  return () => useZero<S, MD, Context>();\n}\n\nexport type ZeroProviderProps<\n  S extends BaseDefaultSchema = DefaultSchema,\n  MD extends CustomMutatorDefs | undefined = undefined,\n  Context extends BaseDefaultContext = DefaultContext,\n> = (ZeroOptions<S, MD, Context> | {zero: Zero<S, MD, Context>}) & {\n  init?: (zero: Zero<S, MD, Context>) => void;\n  children: ReactNode;\n};\n\nconst NO_AUTH_SET = Symbol();\n\nexport function ZeroProvider<\n  S extends BaseDefaultSchema = DefaultSchema,\n  MD extends CustomMutatorDefs | undefined = undefined,\n  Context extends BaseDefaultContext = DefaultContext,\n>({children, init, ...props}: ZeroProviderProps<S, MD, Context>) {\n  const isExternalZero = 'zero' in props;\n\n  const [zero, setZero] = useState<Zero<S, MD, Context> | undefined>(\n    isExternalZero ? props.zero : undefined,\n  );\n\n  const auth = 'auth' in props ? props.auth : NO_AUTH_SET;\n  const prevAuthRef = useRef<typeof auth>(auth);\n\n  const keysWithoutAuth = useMemo(\n    () =>\n      Object.entries(props)\n        .filter(([key]) => key !== 'auth')\n        .sort(([a], [b]) => stringCompare(a, b))\n        .map(([_, value]) => value),\n    [props],\n  );\n\n  // If Zero is not passed in, we construct it, but only client-side.\n  // Zero doesn't really work SSR today so this is usually the right thing.\n  // When we support Zero SSR this will either become a breaking change or\n  // more likely server support will be opt-in with a new prop on this\n  // component.\n  useEffect(() => {\n    if (isExternalZero) {\n      setZero(props.zero);\n      return;\n    }\n\n    const z = new Zero(props);\n    init?.(z);\n    setZero(z);\n\n    return () => {\n      void z.close();\n      setZero(undefined);\n    };\n    // we intentionally don't include auth in the dependency array\n    // to avoid closing zero when auth changes\n  }, [init, ...keysWithoutAuth]);\n\n  useEffect(() => {\n    if (!zero || isExternalZero) return;\n\n    const authChanged = auth !== prevAuthRef.current;\n\n    if (authChanged) {\n      prevAuthRef.current = auth;\n      void zero.connection.connect({\n        auth: auth === NO_AUTH_SET ? undefined : auth,\n      });\n    }\n  }, [auth, zero]);\n\n  return (\n    zero && <ZeroContext.Provider value={zero}>{children}</ZeroContext.Provider>\n  );\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAqBO,MAAM,cAAc;AAAA,EACzB;AACF;AAEO,SAAS,UAIU;AACxB,QAAM,OAAO,WAAW,WAAW;AACnC,MAAI,SAAS,QAAW;AACtB,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AACA,SAAO;AACT;AAaO,SAAS,gBAIZ;AACF,SAAO,MAAM,QAAA;AACf;AAWA,MAAM,cAAc,OAAA;AAEb,SAAS,aAId,EAAC,UAAU,MAAM,GAAG,SAA2C;AAC/D,QAAM,iBAAiB,UAAU;AAEjC,QAAM,CAAC,MAAM,OAAO,IAAI;AAAA,IACtB,iBAAiB,MAAM,OAAO;AAAA,EAAA;AAGhC,QAAM,OAAO,UAAU,QAAQ,MAAM,OAAO;AAC5C,QAAM,cAAc,OAAoB,IAAI;AAE5C,QAAM,kBAAkB;AAAA,IACtB,MACE,OAAO,QAAQ,KAAK,EACjB,OAAO,CAAC,CAAC,GAAG,MAAM,QAAQ,MAAM,EAChC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,EACtC,IAAI,CAAC,CAAC,GAAG,KAAK,MAAM,KAAK;AAAA,IAC9B,CAAC,KAAK;AAAA,EAAA;AAQR,YAAU,MAAM;AACd,QAAI,gBAAgB;AAClB,cAAQ,MAAM,IAAI;AAClB;AAAA,IACF;AAEA,UAAM,IAAI,IAAI,KAAK,KAAK;AACxB,WAAO,CAAC;AACR,YAAQ,CAAC;AAET,WAAO,MAAM;AACX,WAAK,EAAE,MAAA;AACP,cAAQ,MAAS;AAAA,IACnB;AAAA,EAGF,GAAG,CAAC,MAAM,GAAG,eAAe,CAAC;AAE7B,YAAU,MAAM;AACd,QAAI,CAAC,QAAQ,eAAgB;AAE7B,UAAM,cAAc,SAAS,YAAY;AAEzC,QAAI,aAAa;AACf,kBAAY,UAAU;AACtB,WAAK,KAAK,WAAW,QAAQ;AAAA,QAC3B,MAAM,SAAS,cAAc,SAAY;AAAA,MAAA,CAC1C;AAAA,IACH;AAAA,EACF,GAAG,CAAC,MAAM,IAAI,CAAC;AAEf,SACE,QAAQ,oBAAC,YAAY,UAAZ,EAAqB,OAAO,MAAO,UAAS;AAEzD;"}
+{"version":3,"file":"zero-provider.js","names":[],"sources":["../../../../zero-react/src/zero-provider.tsx"],"sourcesContent":["import {\n  createContext,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from 'react';\nimport {stringCompare} from '../../shared/src/string-compare.ts';\nimport {\n  Zero,\n  type BaseDefaultContext,\n  type BaseDefaultSchema,\n  type CustomMutatorDefs,\n  type DefaultContext,\n  type DefaultSchema,\n  type ZeroOptions,\n} from './zero.ts';\n\n// oxlint-disable-next-line no-explicit-any\nexport const ZeroContext = createContext<Zero<any, any, any> | undefined>(\n  undefined,\n);\n\nexport function useZero<\n  S extends BaseDefaultSchema = DefaultSchema,\n  MD extends CustomMutatorDefs | undefined = undefined,\n  Context extends BaseDefaultContext = DefaultContext,\n>(): Zero<S, MD, Context> {\n  const zero = useContext(ZeroContext);\n  if (zero === undefined) {\n    throw new Error('useZero must be used within a ZeroProvider');\n  }\n  return zero as Zero<S, MD, Context>;\n}\n\n/**\n * @deprecated Use {@linkcode useZero} instead, alongside default types defined with:\n *\n * ```ts\n * declare module '@rocicorp/zero' {\n *   interface DefaultTypes {\n *     schema: typeof schema;\n *     context: Context;\n *   }\n * }\n */\nexport function createUseZero<\n  S extends BaseDefaultSchema = DefaultSchema,\n  MD extends CustomMutatorDefs | undefined = undefined,\n  Context extends BaseDefaultContext = DefaultContext,\n>() {\n  return () => useZero<S, MD, Context>();\n}\n\nexport type ZeroProviderProps<\n  S extends BaseDefaultSchema = DefaultSchema,\n  MD extends CustomMutatorDefs | undefined = undefined,\n  Context extends BaseDefaultContext = DefaultContext,\n> = (ZeroOptions<S, MD, Context> | {zero: Zero<S, MD, Context>}) & {\n  init?: (zero: Zero<S, MD, Context>) => void;\n  children: ReactNode;\n};\n\nconst NO_AUTH_SET = Symbol();\n\nexport function ZeroProvider<\n  S extends BaseDefaultSchema = DefaultSchema,\n  MD extends CustomMutatorDefs | undefined = undefined,\n  Context extends BaseDefaultContext = DefaultContext,\n>({children, init, ...props}: ZeroProviderProps<S, MD, Context>) {\n  const isExternalZero = 'zero' in props;\n\n  const [zero, setZero] = useState<Zero<S, MD, Context> | undefined>(\n    isExternalZero ? props.zero : undefined,\n  );\n\n  const auth = 'auth' in props ? props.auth : NO_AUTH_SET;\n  const prevAuthRef = useRef<typeof auth>(auth);\n\n  const keysWithoutAuth = useMemo(\n    () =>\n      Object.entries(props)\n        .filter(([key]) => key !== 'auth')\n        .sort(([a], [b]) => stringCompare(a, b))\n        .map(([_, value]) => value),\n    [props],\n  );\n\n  // If Zero is not passed in, we construct it, but only client-side.\n  // Zero doesn't really work SSR today so this is usually the right thing.\n  // When we support Zero SSR this will either become a breaking change or\n  // more likely server support will be opt-in with a new prop on this\n  // component.\n  useEffect(() => {\n    if (isExternalZero) {\n      setZero(props.zero);\n      return;\n    }\n\n    const z = new Zero(props);\n    init?.(z);\n    setZero(z);\n\n    return () => {\n      void z.close();\n      setZero(undefined);\n    };\n    // we intentionally don't include auth in the dependency array\n    // to avoid closing zero when auth changes\n  }, [init, ...keysWithoutAuth]);\n\n  useEffect(() => {\n    if (!zero || isExternalZero) return;\n\n    const authChanged = auth !== prevAuthRef.current;\n\n    if (authChanged) {\n      prevAuthRef.current = auth;\n      void zero.connection.connect({\n        auth: auth === NO_AUTH_SET ? undefined : auth,\n      });\n    }\n  }, [auth, zero]);\n\n  return (\n    zero && <ZeroContext.Provider value={zero}>{children}</ZeroContext.Provider>\n  );\n}\n"],"mappings":";;;;;;AAqBA,IAAa,cAAc,cACzB,KAAA,EACD;AAED,SAAgB,UAIU;CACxB,MAAM,OAAO,WAAW,YAAY;AACpC,KAAI,SAAS,KAAA,EACX,OAAM,IAAI,MAAM,6CAA6C;AAE/D,QAAO;;;;;;;;;;;;;AAcT,SAAgB,gBAIZ;AACF,cAAa,SAAyB;;AAYxC,IAAM,cAAc,QAAQ;AAE5B,SAAgB,aAId,EAAC,UAAU,MAAM,GAAG,SAA2C;CAC/D,MAAM,iBAAiB,UAAU;CAEjC,MAAM,CAAC,MAAM,WAAW,SACtB,iBAAiB,MAAM,OAAO,KAAA,EAC/B;CAED,MAAM,OAAO,UAAU,QAAQ,MAAM,OAAO;CAC5C,MAAM,cAAc,OAAoB,KAAK;AAgB7C,iBAAgB;AACd,MAAI,gBAAgB;AAClB,WAAQ,MAAM,KAAK;AACnB;;EAGF,MAAM,IAAI,IAAI,KAAK,MAAM;AACzB,SAAO,EAAE;AACT,UAAQ,EAAE;AAEV,eAAa;AACN,KAAE,OAAO;AACd,WAAQ,KAAA,EAAU;;IAInB,CAAC,MAAM,GA9Bc,cAEpB,OAAO,QAAQ,MAAM,CAClB,QAAQ,CAAC,SAAS,QAAQ,OAAO,CACjC,MAAM,CAAC,IAAI,CAAC,OAAO,cAAc,GAAG,EAAE,CAAC,CACvC,KAAK,CAAC,GAAG,WAAW,MAAM,EAC/B,CAAC,MAAM,CACR,CAuB4B,CAAC;AAE9B,iBAAgB;AACd,MAAI,CAAC,QAAQ,eAAgB;AAI7B,MAFoB,SAAS,YAAY,SAExB;AACf,eAAY,UAAU;AACjB,QAAK,WAAW,QAAQ,EAC3B,MAAM,SAAS,cAAc,KAAA,IAAY,MAC1C,CAAC;;IAEH,CAAC,MAAM,KAAK,CAAC;AAEhB,QACE,QAAQ,oBAAC,YAAY,UAAb;EAAsB,OAAO;EAAO;EAAgC,CAAA"}

package/out/zero-react/src/zero.js

@@ -0,0 +1,22 @@
+import "../../replicache/src/get-default-puller.js";
+import "../../replicache/src/kv/idb-store.js";
+import "../../replicache/src/make-idb-name.js";
+import "../../replicache/src/persist/collect-idb-databases.js";
+import "../../replicache/src/transaction-closed-error.js";
+import "../../zero-protocol/src/application-error.js";
+import "../../zero-protocol/src/custom-queries.js";
+import "../../zero-schema/src/builder/relationship-builder.js";
+import "../../zero-schema/src/builder/table-builder.js";
+import "../../zero-schema/src/builder/schema-builder.js";
+import "../../zero-schema/src/permissions.js";
+import "../../zql/src/mutate/mutator.js";
+import "../../zql/src/mutate/mutator-registry.js";
+import "../../zql/src/query/create-builder.js";
+import "../../zql/src/query/escape-like.js";
+import "../../zql/src/query/named.js";
+import "../../zql/src/query/query-registry.js";
+import "../../zero-client/src/client/connection-status-enum.js";
+import "../../zero-client/src/client/update-needed-reason-type-enum.js";
+import "../../zero-client/src/client/zero.js";
+import "../../zero-client/src/mod.js";
+export {};

package/out/zero-schema/src/builder/relationship-builder.js

@@ -1,27 +1,31 @@
+//#region ../zero-schema/src/builder/relationship-builder.ts
 function relationships(table, cb) {
-  const relationships2 = cb({ many, one });
-  return {
-    name: table.schema.name,
-    relationships: relationships2
-  };
+	const relationships = cb({
+		many,
+		one
+	});
+	return {
+		name: table.schema.name,
+		relationships
+	};
 }
 function many(...args) {
-  return args.map((arg) => ({
-    sourceField: arg.sourceField,
-    destField: arg.destField,
-    destSchema: arg.destSchema.schema.name,
-    cardinality: "many"
-  }));
+	return args.map((arg) => ({
+		sourceField: arg.sourceField,
+		destField: arg.destField,
+		destSchema: arg.destSchema.schema.name,
+		cardinality: "many"
+	}));
 }
 function one(...args) {
-  return args.map((arg) => ({
-    sourceField: arg.sourceField,
-    destField: arg.destField,
-    destSchema: arg.destSchema.schema.name,
-    cardinality: "one"
-  }));
+	return args.map((arg) => ({
+		sourceField: arg.sourceField,
+		destField: arg.destField,
+		destSchema: arg.destSchema.schema.name,
+		cardinality: "one"
+	}));
 }
-export {
-  relationships
-};
-//# sourceMappingURL=relationship-builder.js.map
+//#endregion
+export { relationships };
+
+//# sourceMappingURL=relationship-builder.js.map

package/out/zero-schema/src/builder/relationship-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"relationship-builder.js","sources":["../../../../../zero-schema/src/builder/relationship-builder.ts"],"sourcesContent":["/* oxlint-disable @typescript-eslint/no-explicit-any */\nimport type {Relationship, TableSchema} from '../table-schema.ts';\nimport type {TableBuilderWithColumns} from './table-builder.ts';\n\ntype ConnectArg<TSourceField, TDestField, TDest extends TableSchema> = {\n  readonly sourceField: TSourceField;\n  readonly destField: TDestField;\n  readonly destSchema: TableBuilderWithColumns<TDest>;\n};\n\ntype ManyConnection<TSourceField, TDestField, TDest extends TableSchema> = {\n  readonly sourceField: TSourceField;\n  readonly destField: TDestField;\n  readonly destSchema: TDest['name'];\n  readonly cardinality: 'many';\n};\n\ntype OneConnection<TSourceField, TDestField, TDest extends TableSchema> = {\n  readonly sourceField: TSourceField;\n  readonly destField: TDestField;\n  readonly destSchema: TDest['name'];\n  readonly cardinality: 'one';\n};\n\ntype Prev = [-1, 0, 1, 2, 3, 4, 5, 6];\n\nexport type PreviousSchema<\n  TSource extends TableSchema,\n  K extends number,\n  TDests extends TableSchema[],\n> = K extends 0 ? TSource : TDests[Prev[K]];\n\nexport type Relationships = {\n  name: string; // table name\n  relationships: Record<string, Relationship>; // relationships for that table\n};\n\n// Overloaded types for better inference\ntype ManyConnector<TSource extends TableSchema> = {\n  // Single direct relationship\n  <TDest extends TableSchema>(\n    arg: ConnectArg<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ): [\n    ManyConnection<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ];\n\n  // Junction relationship (two hops)\n  <TJunction extends TableSchema, TDest extends TableSchema>(\n    firstHop: ConnectArg<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TJunction['columns'] & string)[],\n      TJunction\n    >,\n    secondHop: ConnectArg<\n      readonly (keyof TJunction['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ): [\n    ManyConnection<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TJunction['columns'] & string)[],\n      TJunction\n    >,\n    ManyConnection<\n      readonly (keyof TJunction['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ];\n};\n\ntype OneConnector<TSource extends TableSchema> = {\n  // Single direct relationship\n  <TDest extends TableSchema>(\n    arg: ConnectArg<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ): [\n    OneConnection<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ];\n\n  // Two-hop relationship (e.g., invoice_line -> invoice -> customer)\n  <TIntermediate extends TableSchema, TDest extends TableSchema>(\n    firstHop: ConnectArg<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TIntermediate['columns'] & string)[],\n      TIntermediate\n    >,\n    secondHop: ConnectArg<\n      readonly (keyof TIntermediate['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ): [\n    OneConnection<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TIntermediate['columns'] & string)[],\n      TIntermediate\n    >,\n    OneConnection<\n      readonly (keyof TIntermediate['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ];\n};\n\nexport function relationships<\n  TSource extends TableSchema,\n  TRelationships extends Record<string, Relationship>,\n>(\n  table: TableBuilderWithColumns<TSource>,\n  cb: (connects: {\n    many: ManyConnector<TSource>;\n    one: OneConnector<TSource>;\n  }) => TRelationships,\n): {name: TSource['name']; relationships: TRelationships} {\n  const relationships = cb({many, one} as any);\n\n  return {\n    name: table.schema.name,\n    relationships,\n  };\n}\n\nfunction many(\n  ...args: readonly ConnectArg<any, any, TableSchema>[]\n): ManyConnection<any, any, any>[] {\n  return args.map(arg => ({\n    sourceField: arg.sourceField,\n    destField: arg.destField,\n    destSchema: arg.destSchema.schema.name,\n    cardinality: 'many',\n  }));\n}\n\nfunction one(\n  ...args: readonly ConnectArg<any, any, TableSchema>[]\n): OneConnection<any, any, any>[] {\n  return args.map(arg => ({\n    sourceField: arg.sourceField,\n    destField: arg.destField,\n    destSchema: arg.destSchema.schema.name,\n    cardinality: 'one',\n  }));\n}\n"],"names":["relationships"],"mappings":"AA0HO,SAAS,cAId,OACA,IAIwD;AACxD,QAAMA,iBAAgB,GAAG,EAAC,MAAM,KAAW;AAE3C,SAAO;AAAA,IACL,MAAM,MAAM,OAAO;AAAA,IACnB,eAAAA;AAAAA,EAAA;AAEJ;AAEA,SAAS,QACJ,MAC8B;AACjC,SAAO,KAAK,IAAI,CAAA,SAAQ;AAAA,IACtB,aAAa,IAAI;AAAA,IACjB,WAAW,IAAI;AAAA,IACf,YAAY,IAAI,WAAW,OAAO;AAAA,IAClC,aAAa;AAAA,EAAA,EACb;AACJ;AAEA,SAAS,OACJ,MAC6B;AAChC,SAAO,KAAK,IAAI,CAAA,SAAQ;AAAA,IACtB,aAAa,IAAI;AAAA,IACjB,WAAW,IAAI;AAAA,IACf,YAAY,IAAI,WAAW,OAAO;AAAA,IAClC,aAAa;AAAA,EAAA,EACb;AACJ;"}
+{"version":3,"file":"relationship-builder.js","names":[],"sources":["../../../../../zero-schema/src/builder/relationship-builder.ts"],"sourcesContent":["/* oxlint-disable @typescript-eslint/no-explicit-any */\nimport type {Relationship, TableSchema} from '../table-schema.ts';\nimport type {TableBuilderWithColumns} from './table-builder.ts';\n\ntype ConnectArg<TSourceField, TDestField, TDest extends TableSchema> = {\n  readonly sourceField: TSourceField;\n  readonly destField: TDestField;\n  readonly destSchema: TableBuilderWithColumns<TDest>;\n};\n\ntype ManyConnection<TSourceField, TDestField, TDest extends TableSchema> = {\n  readonly sourceField: TSourceField;\n  readonly destField: TDestField;\n  readonly destSchema: TDest['name'];\n  readonly cardinality: 'many';\n};\n\ntype OneConnection<TSourceField, TDestField, TDest extends TableSchema> = {\n  readonly sourceField: TSourceField;\n  readonly destField: TDestField;\n  readonly destSchema: TDest['name'];\n  readonly cardinality: 'one';\n};\n\ntype Prev = [-1, 0, 1, 2, 3, 4, 5, 6];\n\nexport type PreviousSchema<\n  TSource extends TableSchema,\n  K extends number,\n  TDests extends TableSchema[],\n> = K extends 0 ? TSource : TDests[Prev[K]];\n\nexport type Relationships = {\n  name: string; // table name\n  relationships: Record<string, Relationship>; // relationships for that table\n};\n\n// Overloaded types for better inference\ntype ManyConnector<TSource extends TableSchema> = {\n  // Single direct relationship\n  <TDest extends TableSchema>(\n    arg: ConnectArg<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ): [\n    ManyConnection<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ];\n\n  // Junction relationship (two hops)\n  <TJunction extends TableSchema, TDest extends TableSchema>(\n    firstHop: ConnectArg<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TJunction['columns'] & string)[],\n      TJunction\n    >,\n    secondHop: ConnectArg<\n      readonly (keyof TJunction['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ): [\n    ManyConnection<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TJunction['columns'] & string)[],\n      TJunction\n    >,\n    ManyConnection<\n      readonly (keyof TJunction['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ];\n};\n\ntype OneConnector<TSource extends TableSchema> = {\n  // Single direct relationship\n  <TDest extends TableSchema>(\n    arg: ConnectArg<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ): [\n    OneConnection<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ];\n\n  // Two-hop relationship (e.g., invoice_line -> invoice -> customer)\n  <TIntermediate extends TableSchema, TDest extends TableSchema>(\n    firstHop: ConnectArg<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TIntermediate['columns'] & string)[],\n      TIntermediate\n    >,\n    secondHop: ConnectArg<\n      readonly (keyof TIntermediate['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ): [\n    OneConnection<\n      readonly (keyof TSource['columns'] & string)[],\n      readonly (keyof TIntermediate['columns'] & string)[],\n      TIntermediate\n    >,\n    OneConnection<\n      readonly (keyof TIntermediate['columns'] & string)[],\n      readonly (keyof TDest['columns'] & string)[],\n      TDest\n    >,\n  ];\n};\n\nexport function relationships<\n  TSource extends TableSchema,\n  TRelationships extends Record<string, Relationship>,\n>(\n  table: TableBuilderWithColumns<TSource>,\n  cb: (connects: {\n    many: ManyConnector<TSource>;\n    one: OneConnector<TSource>;\n  }) => TRelationships,\n): {name: TSource['name']; relationships: TRelationships} {\n  const relationships = cb({many, one} as any);\n\n  return {\n    name: table.schema.name,\n    relationships,\n  };\n}\n\nfunction many(\n  ...args: readonly ConnectArg<any, any, TableSchema>[]\n): ManyConnection<any, any, any>[] {\n  return args.map(arg => ({\n    sourceField: arg.sourceField,\n    destField: arg.destField,\n    destSchema: arg.destSchema.schema.name,\n    cardinality: 'many',\n  }));\n}\n\nfunction one(\n  ...args: readonly ConnectArg<any, any, TableSchema>[]\n): OneConnection<any, any, any>[] {\n  return args.map(arg => ({\n    sourceField: arg.sourceField,\n    destField: arg.destField,\n    destSchema: arg.destSchema.schema.name,\n    cardinality: 'one',\n  }));\n}\n"],"mappings":";AA0HA,SAAgB,cAId,OACA,IAIwD;CACxD,MAAM,gBAAgB,GAAG;EAAC;EAAM;EAAI,CAAQ;AAE5C,QAAO;EACL,MAAM,MAAM,OAAO;EACnB;EACD;;AAGH,SAAS,KACP,GAAG,MAC8B;AACjC,QAAO,KAAK,KAAI,SAAQ;EACtB,aAAa,IAAI;EACjB,WAAW,IAAI;EACf,YAAY,IAAI,WAAW,OAAO;EAClC,aAAa;EACd,EAAE;;AAGL,SAAS,IACP,GAAG,MAC6B;AAChC,QAAO,KAAK,KAAI,SAAQ;EACtB,aAAa,IAAI;EACjB,WAAW,IAAI;EACf,YAAY,IAAI,WAAW,OAAO;EAClC,aAAa;EACd,EAAE"}

package/out/zero-schema/src/builder/schema-builder.js

@@ -1,88 +1,60 @@
 import { h64 } from "../../../shared/src/hash.js";
 import { mapEntries } from "../../../shared/src/objects.js";
 import { normalizeClientSchema } from "../../../zero-protocol/src/client-schema.js";
+//#region ../zero-schema/src/builder/schema-builder.ts
+/**
+* Note: the keys of the `tables` and `relationships` parameters do not matter.
+* You can assign them to any value you like. E.g.,
+*
+* ```ts
+* createSchema({rsdfgafg: table('users')...}, {sdfd: relationships(users, ...)})
+* ```
+*/
 function createSchema(options) {
-  const retTables = {};
-  const retRelationships = {};
-  const serverNames = /* @__PURE__ */ new Set();
-  options.tables.forEach((table) => {
-    const { serverName = table.schema.name } = table.schema;
-    if (serverNames.has(serverName)) {
-      throw new Error(`Multiple tables reference the name "${serverName}"`);
-    }
-    serverNames.add(serverName);
-    if (Object.hasOwn(retTables, table.schema.name)) {
-      throw new Error(
-        `Table "${table.schema.name}" is defined more than once in the schema`
-      );
-    }
-    retTables[table.schema.name] = table.build();
-  });
-  options.relationships?.forEach((relationships) => {
-    if (retRelationships[relationships.name]) {
-      throw new Error(
-        `Relationships for table "${relationships.name}" are defined more than once in the schema`
-      );
-    }
-    retRelationships[relationships.name] = relationships.relationships;
-    checkRelationship(
-      relationships.relationships,
-      relationships.name,
-      retTables
-    );
-  });
-  return {
-    tables: retTables,
-    relationships: retRelationships,
-    enableLegacyQueries: options.enableLegacyQueries,
-    enableLegacyMutators: options.enableLegacyMutators
-  };
+	const retTables = {};
+	const retRelationships = {};
+	const serverNames = /* @__PURE__ */ new Set();
+	options.tables.forEach((table) => {
+		const { serverName = table.schema.name } = table.schema;
+		if (serverNames.has(serverName)) throw new Error(`Multiple tables reference the name "${serverName}"`);
+		serverNames.add(serverName);
+		if (Object.hasOwn(retTables, table.schema.name)) throw new Error(`Table "${table.schema.name}" is defined more than once in the schema`);
+		retTables[table.schema.name] = table.build();
+	});
+	options.relationships?.forEach((relationships) => {
+		if (retRelationships[relationships.name]) throw new Error(`Relationships for table "${relationships.name}" are defined more than once in the schema`);
+		retRelationships[relationships.name] = relationships.relationships;
+		checkRelationship(relationships.relationships, relationships.name, retTables);
+	});
+	return {
+		tables: retTables,
+		relationships: retRelationships,
+		enableLegacyQueries: options.enableLegacyQueries,
+		enableLegacyMutators: options.enableLegacyMutators
+	};
 }
 function checkRelationship(relationships, tableName, tables) {
-  Object.entries(relationships).forEach(([name, rel]) => {
-    let source = tables[tableName];
-    if (source.columns[name] !== void 0) {
-      throw new Error(
-        `Relationship "${tableName}"."${name}" cannot have the same name as the column "${name}" on the the table "${source.name}"`
-      );
-    }
-    rel.forEach((connection) => {
-      if (!tables[connection.destSchema]) {
-        throw new Error(
-          `For relationship "${tableName}"."${name}", destination table "${connection.destSchema}" is missing in the schema`
-        );
-      }
-      if (!source.columns[connection.sourceField[0]]) {
-        throw new Error(
-          `For relationship "${tableName}"."${name}", the source field "${connection.sourceField[0]}" is missing in the table schema "${source.name}"`
-        );
-      }
-      source = tables[connection.destSchema];
-    });
-  });
+	Object.entries(relationships).forEach(([name, rel]) => {
+		let source = tables[tableName];
+		if (source.columns[name] !== void 0) throw new Error(`Relationship "${tableName}"."${name}" cannot have the same name as the column "${name}" on the the table "${source.name}"`);
+		rel.forEach((connection) => {
+			if (!tables[connection.destSchema]) throw new Error(`For relationship "${tableName}"."${name}", destination table "${connection.destSchema}" is missing in the schema`);
+			if (!source.columns[connection.sourceField[0]]) throw new Error(`For relationship "${tableName}"."${name}", the source field "${connection.sourceField[0]}" is missing in the table schema "${source.name}"`);
+			source = tables[connection.destSchema];
+		});
+	});
 }
 function clientSchemaFrom(schema) {
-  const client = {
-    tables: mapEntries(
-      schema.tables,
-      (name, { serverName, columns, primaryKey }) => [
-        serverName ?? name,
-        {
-          columns: mapEntries(columns, (name2, { serverName: serverName2, type }) => [
-            serverName2 ?? name2,
-            { type }
-          ]),
-          primaryKey: primaryKey.map((k) => columns[k].serverName ?? k)
-        }
-      ]
-    )
-  };
-  const clientSchema = normalizeClientSchema(client);
-  const hash = h64(JSON.stringify(clientSchema)).toString(36);
-  return { clientSchema, hash };
+	const clientSchema = normalizeClientSchema({ tables: mapEntries(schema.tables, (name, { serverName, columns, primaryKey }) => [serverName ?? name, {
+		columns: mapEntries(columns, (name, { serverName, type }) => [serverName ?? name, { type }]),
+		primaryKey: primaryKey.map((k) => columns[k].serverName ?? k)
+	}]) });
+	return {
+		clientSchema,
+		hash: h64(JSON.stringify(clientSchema)).toString(36)
+	};
 }
-export {
-  clientSchemaFrom,
-  createSchema
-};
-//# sourceMappingURL=schema-builder.js.map
+//#endregion
+export { clientSchemaFrom, createSchema };
+
+//# sourceMappingURL=schema-builder.js.map