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

package/out/{react.js → zero-react/src/use-query.js}

@@ -1,170 +1,12 @@
-import {
-  MarkIcon
-} from "./chunk-VZOYWIRW.js";
-import {
-  Zero,
-  bindingsForZero,
-  connection_status_enum_exports
-} from "./chunk-FODUNUAD.js";
-import "./chunk-ASRS2LFV.js";
-import {
-  DEFAULT_TTL_MS,
-  stringCompare
-} from "./chunk-TAUDS4QP.js";
-import {
-  hasOwn
-} from "./chunk-EZM3XBAB.js";
-import "./chunk-424PT5DM.js";
-
-// ../zero-react/src/components/zero-inspector.tsx
-import { lazy, Suspense, useState } from "react";
-import { jsx } from "react/jsx-runtime";
-var Inspector = lazy(() => import("./inspector-GP3CBZRU.js"));
-function ZeroInspector({ zero }) {
-  const [show, setShow] = useState(false);
-  return show ? /* @__PURE__ */ jsx(Suspense, { fallback: /* @__PURE__ */ jsx("div", { children: "Loading Inspector..." }), children: /* @__PURE__ */ jsx(
-    Inspector,
-    {
-      zero,
-      onClose: () => setShow(false)
-    }
-  ) }) : /* @__PURE__ */ jsx(
-    "button",
-    {
-      onClick: () => setShow(!show),
-      style: {
-        position: "fixed",
-        bottom: 0,
-        right: 0,
-        zIndex: 1e3,
-        padding: "5px",
-        color: "white",
-        backgroundColor: "#333",
-        borderTopLeftRadius: "8px",
-        opacity: 0.95
-      },
-      children: /* @__PURE__ */ jsx(
-        MarkIcon,
-        {
-          style: {
-            width: "20px",
-            height: "20px",
-            fill: "currentColor"
-          }
-        }
-      )
-    }
-  );
-}
-
-// ../zero-react/src/use-query.tsx
 import { resolver } from "@rocicorp/resolver";
 import React, { useSyncExternalStore } from "react";
-
-// ../shared/src/deep-clone.ts
-function deepClone(value) {
-  const seen = [];
-  return internalDeepClone(value, seen);
-}
-function internalDeepClone(value, seen) {
-  switch (typeof value) {
-    case "boolean":
-    case "number":
-    case "string":
-    case "undefined":
-      return value;
-    case "object": {
-      if (value === null) {
-        return null;
-      }
-      if (seen.includes(value)) {
-        throw new Error("Cyclic object");
-      }
-      seen.push(value);
-      if (Array.isArray(value)) {
-        const rv = value.map((v) => internalDeepClone(v, seen));
-        seen.pop();
-        return rv;
-      }
-      const obj = {};
-      for (const k in value) {
-        if (hasOwn(value, k)) {
-          const v = value[k];
-          if (v !== void 0) {
-            obj[k] = internalDeepClone(v, seen);
-          }
-        }
-      }
-      seen.pop();
-      return obj;
-    }
-    default:
-      throw new Error(`Invalid type: ${typeof value}`);
-  }
-}
-
-// ../zero-react/src/zero-provider.tsx
-import {
-  createContext,
-  useContext,
-  useEffect,
-  useMemo,
-  useRef,
-  useState as useState2
-} from "react";
-import { jsx as jsx2 } from "react/jsx-runtime";
-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;
-}
-function createUseZero() {
-  return () => useZero();
-}
-var NO_AUTH_SET = Symbol();
-function ZeroProvider({ children, init, ...props }) {
-  const isExternalZero = "zero" in props;
-  const [zero, setZero] = useState2(
-    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) 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__ */ jsx2(ZeroContext.Provider, { value: zero, children });
-}
-
-// ../zero-react/src/use-query.tsx
-var reactUse = React.use;
-var suspend = reactUse ? reactUse : (p) => {
+import { deepClone } from "../../shared/src/deep-clone.js";
+import { bindingsForZero } from "../../zero-client/src/client/bindings.js";
+import "../../zero-protocol/src/ast.js";
+import { DEFAULT_TTL_MS } from "../../zql/src/query/ttl.js";
+import { useZero } from "./zero-provider.js";
+const reactUse = React.use;
+const suspend = reactUse ? reactUse : (p) => {
   throw p;
 };
 function useQuery(query, options) {
@@ -211,18 +53,18 @@ function useSuspenseQuery(query, options) {
   }
   return snapshot;
 }
-var emptyArray = [];
-var disabledSubscriber = () => () => {
+const emptyArray = [];
+const disabledSubscriber = () => () => {
 };
-var resultTypeUnknown = { type: "unknown" };
-var resultTypeComplete = { type: "complete" };
-var resultTypeError = { type: "error" };
-var emptySnapshotSingularUnknown = [void 0, resultTypeUnknown];
-var emptySnapshotSingularComplete = [void 0, resultTypeComplete];
-var emptySnapshotSingularErrorUnknown = [void 0, resultTypeError];
-var emptySnapshotPluralUnknown = [emptyArray, resultTypeUnknown];
-var emptySnapshotPluralComplete = [emptyArray, resultTypeComplete];
-var emptySnapshotErrorUnknown = [emptyArray, resultTypeError];
+const resultTypeUnknown = { type: "unknown" };
+const resultTypeComplete = { type: "complete" };
+const resultTypeError = { type: "error" };
+const emptySnapshotSingularUnknown = [void 0, resultTypeUnknown];
+const emptySnapshotSingularComplete = [void 0, resultTypeComplete];
+const emptySnapshotSingularErrorUnknown = [void 0, resultTypeError];
+const emptySnapshotPluralUnknown = [emptyArray, resultTypeUnknown];
+const emptySnapshotPluralComplete = [emptyArray, resultTypeComplete];
+const emptySnapshotErrorUnknown = [emptyArray, resultTypeError];
 function getDefaultSnapshot(singular) {
   return singular ? emptySnapshotSingularUnknown : emptySnapshotPluralUnknown;
 }
@@ -268,8 +110,6 @@ function getSnapshot(singular, data, resultType, retryFn, error) {
         data,
         makeError(retryFn, {
           error: "app",
-          id: "unknown",
-          name: "unknown",
           message: "An unknown error occurred"
         })
       ];
@@ -292,16 +132,14 @@ function makeError(retry, error) {
     }
   };
 }
-var ViewStore = class {
+class ViewStore {
   #views = /* @__PURE__ */ new Map();
   constructor() {
-    if (false) {
-      allViews.set(this, this.#views);
-    }
   }
   getView(zero, query, enabled, ttl) {
+    const q = query.toQuery(zero.context);
     const bindings = bindingsForZero(zero);
-    const format = bindings.format(query);
+    const format = bindings.format(q);
     if (!enabled) {
       return {
         getSnapshot: () => getDefaultSnapshot(format.singular),
@@ -314,10 +152,10 @@ var ViewStore = class {
         nonEmpty: false
       };
     }
-    const hash = bindings.hash(query) + zero.clientID;
+    const hash = bindings.hash(q) + zero.clientID;
     let existing = this.#views.get(hash);
     if (!existing) {
-      existing = new ViewWrapper(bindings, query, format, ttl, (view) => {
+      existing = new ViewWrapper(bindings, q, format, ttl, (view) => {
         const currentView = this.#views.get(hash);
         if (currentView && currentView !== view) {
           return;
@@ -330,9 +168,9 @@ var ViewStore = class {
     }
     return existing;
   }
-};
-var viewStore = new ViewStore();
-var ViewWrapper = class {
+}
+const viewStore = new ViewStore();
+class ViewWrapper {
   #view;
   #onDematerialized;
   #query;
@@ -437,39 +275,10 @@ var ViewWrapper = class {
   waitForNonEmpty() {
     return this.#nonEmptyResolver.promise;
   }
-};
-
-// ../zero-react/src/use-zero-connection-state.tsx
-import { useSyncExternalStore as useSyncExternalStore2 } from "react";
-function useZeroConnectionState() {
-  const zero = useZero();
-  return useSyncExternalStore2(
-    zero.connection.state.subscribe,
-    () => zero.connection.state.current,
-    () => zero.connection.state.current
-  );
-}
-
-// ../zero-react/src/use-zero-online.tsx
-import { useSyncExternalStore as useSyncExternalStore3 } from "react";
-function useZeroOnline() {
-  const zero = useZero();
-  return useSyncExternalStore3(
-    zero.onOnline,
-    () => zero.online,
-    () => zero.online
-  );
 }
 export {
-  connection_status_enum_exports as ConnectionStatus,
-  ZeroContext,
-  ZeroInspector,
-  ZeroProvider,
-  createUseZero,
+  ViewStore,
   useQuery,
-  useSuspenseQuery,
-  useZero,
-  useZeroConnectionState,
-  useZeroOnline
+  useSuspenseQuery
 };
-//# sourceMappingURL=react.js.map
+//# sourceMappingURL=use-query.js.map

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

@@ -0,0 +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 {deepClone} from '../../shared/src/deep-clone.ts';\nimport type {Immutable} from '../../shared/src/immutable.ts';\nimport type {ReadonlyJSONValue} from '../../shared/src/json.ts';\nimport {\n  bindingsForZero,\n  type BindingsForZero,\n} from '../../zero-client/src/client/bindings.ts';\nimport type {CustomMutatorDefs} from '../../zero-client/src/client/custom.ts';\nimport type {Zero} from '../../zero-client/src/client/zero.ts';\nimport type {\n  QueryErrorDetails,\n  QueryResultDetails,\n} from '../../zero-client/src/types/query-result.ts';\nimport type {ErroredQuery} from '../../zero-protocol/src/custom-queries.ts';\nimport type {Schema} from '../../zero-types/src/schema.ts';\nimport type {Format} from '../../zql/src/ivm/view.ts';\nimport type {AnyMutatorRegistry} from '../../zql/src/mutate/mutator-registry.ts';\nimport {\n  type HumanReadable,\n  type Query,\n  type ToQuery,\n} from '../../zql/src/query/query.ts';\nimport {DEFAULT_TTL_MS, type TTL} from '../../zql/src/query/ttl.ts';\nimport type {ResultType, TypedView} from '../../zql/src/query/typed-view.ts';\nimport {useZero} from './zero-provider.tsx';\n\nexport type QueryResult<TReturn> = readonly [\n  HumanReadable<TReturn>,\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\nexport function useQuery<\n  TSchema extends Schema,\n  TTable extends keyof TSchema['tables'] & string,\n  TReturn,\n  TContext,\n>(\n  query: ToQuery<TSchema, TTable, TReturn, TContext>,\n  options?: UseQueryOptions | boolean,\n): QueryResult<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 view = viewStore.getView(useZero(), query, enabled, ttl);\n  // https://react.dev/reference/react/useSyncExternalStore\n  return useSyncExternalStore(\n    view.subscribeReactInternals,\n    view.getSnapshot,\n    view.getSnapshot,\n  );\n}\n\nexport function useSuspenseQuery<\n  TSchema extends Schema,\n  TTable extends keyof TSchema['tables'] & string,\n  TReturn,\n  TContext,\n>(\n  query: ToQuery<TSchema, TTable, TReturn, TContext>,\n  options?: UseSuspenseQueryOptions | boolean,\n): QueryResult<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 view = viewStore.getView(useZero(), query, enabled, ttl);\n  // https://react.dev/reference/react/useSyncExternalStore\n  const snapshot = useSyncExternalStore(\n    view.subscribeReactInternals,\n    view.getSnapshot,\n    view.getSnapshot,\n  );\n\n  if (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 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    TSchema extends Schema,\n    TTable extends keyof TSchema['tables'] & string,\n    TReturn,\n    MD extends AnyMutatorRegistry | CustomMutatorDefs | undefined,\n    TContext,\n  >(\n    zero: Zero<TSchema, MD, TContext>,\n    query: ToQuery<TSchema, TTable, TReturn, TContext>,\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 q = query.toQuery(zero.context);\n    const bindings = bindingsForZero(zero);\n    const format = bindings.format(q);\n    if (!enabled) {\n      return {\n        getSnapshot: () => getDefaultSnapshot(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 = bindings.hash(q) + zero.clientID;\n    let existing = this.#views.get(hash);\n    if (!existing) {\n      existing = new ViewWrapper(bindings, q, format, 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<TSchema, TTable, 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  TSchema extends Schema,\n  TTable extends keyof TSchema['tables'] & string,\n  TReturn,\n  MD extends AnyMutatorRegistry | CustomMutatorDefs | undefined,\n  TContext,\n> {\n  #view: TypedView<HumanReadable<TReturn>> | undefined;\n  readonly #onDematerialized;\n  readonly #query: Query<TSchema, TTable, TReturn>;\n  readonly #format: Format;\n  #snapshot: QueryResult<TReturn>;\n  #reactInternals: Set<() => void>;\n  #ttl: TTL;\n  #complete = false;\n  #completeResolver = resolver<void>();\n  #nonEmpty = false;\n  #nonEmptyResolver = resolver<void>();\n  readonly #bindings: BindingsForZero<TSchema>;\n\n  constructor(\n    bindings: BindingsForZero<TSchema>,\n    query: Query<TSchema, TTable, TReturn>,\n    format: Format,\n    ttl: TTL,\n    onDematerialized: (\n      view: ViewWrapper<TSchema, TTable, TReturn, MD, TContext>,\n    ) => void,\n  ) {\n    this.#bindings = bindings;\n    this.#query = query;\n    this.#format = format;\n    this.#ttl = ttl;\n    this.#onDematerialized = onDematerialized;\n    this.#snapshot = getDefaultSnapshot(format.singular);\n    this.#reactInternals = new Set();\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.#format.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.#format.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.#bindings.materialize(this.#query, undefined, {\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    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        setTimeout(() => {\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":"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"}

package/out/zero-react/src/use-zero-connection-state.d.ts

@@ -1,4 +1,4 @@
-import type { ConnectionState } from '../../zero-client/src/client/connection-manager.ts';
+import type { ConnectionState } from '../../zero-client/src/client/connection.ts';
 /**
  * Hook to subscribe to the connection status of the Zero instance.
  *

package/out/zero-react/src/use-zero-connection-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-zero-connection-state.d.ts","sourceRoot":"","sources":["../../../../zero-react/src/use-zero-connection-state.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,oDAAoD,CAAC;AAGxF;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,CAOxD"}
+{"version":3,"file":"use-zero-connection-state.d.ts","sourceRoot":"","sources":["../../../../zero-react/src/use-zero-connection-state.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,4CAA4C,CAAC;AAGhF;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,CAOxD"}

package/out/zero-react/src/use-zero-connection-state.js

@@ -0,0 +1,14 @@
+import { useSyncExternalStore } from "react";
+import { useZero } from "./zero-provider.js";
+function useZeroConnectionState() {
+  const zero = useZero();
+  return useSyncExternalStore(
+    zero.connection.state.subscribe,
+    () => zero.connection.state.current,
+    () => zero.connection.state.current
+  );
+}
+export {
+  useZeroConnectionState
+};
+//# sourceMappingURL=use-zero-connection-state.js.map

package/out/zero-react/src/use-zero-connection-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-zero-connection-state.js","sources":["../../../../zero-react/src/use-zero-connection-state.tsx"],"sourcesContent":["import {useSyncExternalStore} from 'react';\nimport type {ConnectionState} from '../../zero-client/src/client/connection.ts';\nimport {useZero} from './zero-provider.tsx';\n\n/**\n * Hook to subscribe to the connection status of the Zero instance.\n *\n * @returns The connection status of the Zero instance.\n * @see {@link ConnectionState} for more details on the connection state.\n */\nexport function useZeroConnectionState(): ConnectionState {\n  const zero = useZero();\n  return useSyncExternalStore(\n    zero.connection.state.subscribe,\n    () => zero.connection.state.current,\n    () => zero.connection.state.current,\n  );\n}\n"],"names":[],"mappings":";;AAUO,SAAS,yBAA0C;AACxD,QAAM,OAAO,QAAA;AACb,SAAO;AAAA,IACL,KAAK,WAAW,MAAM;AAAA,IACtB,MAAM,KAAK,WAAW,MAAM;AAAA,IAC5B,MAAM,KAAK,WAAW,MAAM;AAAA,EAAA;AAEhC;"}

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

@@ -0,0 +1,14 @@
+import { useSyncExternalStore } from "react";
+import { useZero } from "./zero-provider.js";
+function useZeroOnline() {
+  const zero = useZero();
+  return useSyncExternalStore(
+    zero.onOnline,
+    () => zero.online,
+    () => zero.online
+  );
+}
+export {
+  useZeroOnline
+};
+//# sourceMappingURL=use-zero-online.js.map

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

@@ -0,0 +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 useZeroConnectionState} 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;"}

package/out/zero-react/src/zero-provider.d.ts

@@ -3,14 +3,15 @@ import type { CustomMutatorDefs } from '../../zero-client/src/client/custom.ts';
 import type { ZeroOptions } from '../../zero-client/src/client/options.ts';
 import { Zero } from '../../zero-client/src/client/zero.ts';
 import type { Schema } from '../../zero-types/src/schema.ts';
+import type { AnyMutatorRegistry } from '../../zql/src/mutate/mutator-registry.ts';
 export declare const ZeroContext: import("react").Context<unknown>;
-export declare function useZero<S extends Schema, MD extends CustomMutatorDefs | undefined = undefined, Context = unknown>(): Zero<S, MD, Context>;
-export declare function createUseZero<S extends Schema, MD extends CustomMutatorDefs | undefined = undefined, Context = unknown>(): () => Zero<S, MD, Context>;
-export type ZeroProviderProps<S extends Schema, MD extends CustomMutatorDefs | undefined = undefined, Context = unknown> = (ZeroOptions<S, MD, Context> | {
+export declare function useZero<S extends Schema, MD extends AnyMutatorRegistry | CustomMutatorDefs | undefined = undefined, Context = unknown>(): Zero<S, MD, Context>;
+export declare function createUseZero<S extends Schema, MD extends AnyMutatorRegistry | CustomMutatorDefs | undefined = undefined, Context = unknown>(): () => Zero<S, MD, Context>;
+export type ZeroProviderProps<S extends Schema, MD extends AnyMutatorRegistry | CustomMutatorDefs | undefined, Context> = (ZeroOptions<S, MD, Context> | {
     zero: Zero<S, MD, Context>;
 }) & {
     init?: (zero: Zero<S, MD, Context>) => void;
     children: ReactNode;
 };
-export declare function ZeroProvider<S extends Schema, MD extends CustomMutatorDefs | undefined = undefined, Context = unknown>({ children, init, ...props }: ZeroProviderProps<S, MD, Context>): import("react/jsx-runtime").JSX.Element | undefined;
+export declare function ZeroProvider<S extends Schema, MD extends AnyMutatorRegistry | CustomMutatorDefs | undefined, Context>({ children, init, ...props }: ZeroProviderProps<S, MD, Context>): import("react/jsx-runtime").JSX.Element | undefined;
 //# sourceMappingURL=zero-provider.d.ts.map

package/out/zero-react/src/zero-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zero-provider.d.ts","sourceRoot":"","sources":["../../../../zero-react/src/zero-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,wCAAwC,CAAC;AAC9E,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAC,IAAI,EAAC,MAAM,sCAAsC,CAAC;AAC1D,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,gCAAgC,CAAC;AAG3D,eAAO,MAAM,WAAW,kCAAgD,CAAC;AAEzE,wBAAgB,OAAO,CACrB,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,iBAAiB,GAAG,SAAS,GAAG,SAAS,EACpD,OAAO,GAAG,OAAO,KACd,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAMxB;AAED,wBAAgB,aAAa,CAC3B,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,iBAAiB,GAAG,SAAS,GAAG,SAAS,EACpD,OAAO,GAAG,OAAO,gCAGlB;AAED,MAAM,MAAM,iBAAiB,CAC3B,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,iBAAiB,GAAG,SAAS,GAAG,SAAS,EACpD,OAAO,GAAG,OAAO,IACf,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,GAAG;IAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;CAAC,CAAC,GAAG;IACjE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC5C,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAIF,wBAAgB,YAAY,CAC1B,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,iBAAiB,GAAG,SAAS,GAAG,SAAS,EACpD,OAAO,GAAG,OAAO,EACjB,EAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,EAAC,EAAE,iBAAiB,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,uDA0D9D"}
+{"version":3,"file":"zero-provider.d.ts","sourceRoot":"","sources":["../../../../zero-react/src/zero-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,wCAAwC,CAAC;AAC9E,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAC,IAAI,EAAC,MAAM,sCAAsC,CAAC;AAC1D,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,gCAAgC,CAAC;AAC3D,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,0CAA0C,CAAC;AAEjF,eAAO,MAAM,WAAW,kCAAgD,CAAC;AAEzE,wBAAgB,OAAO,CACrB,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,kBAAkB,GAAG,iBAAiB,GAAG,SAAS,GAAG,SAAS,EACzE,OAAO,GAAG,OAAO,KACd,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAMxB;AAED,wBAAgB,aAAa,CAC3B,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,kBAAkB,GAAG,iBAAiB,GAAG,SAAS,GAAG,SAAS,EACzE,OAAO,GAAG,OAAO,gCAGlB;AAED,MAAM,MAAM,iBAAiB,CAC3B,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,kBAAkB,GAAG,iBAAiB,GAAG,SAAS,EAC7D,OAAO,IACL,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,GAAG;IAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;CAAC,CAAC,GAAG;IACjE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC5C,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAIF,wBAAgB,YAAY,CAC1B,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,kBAAkB,GAAG,iBAAiB,GAAG,SAAS,EAC7D,OAAO,EACP,EAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,EAAC,EAAE,iBAAiB,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,uDA0D9D"}

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

@@ -0,0 +1,59 @@
+import { jsx } from "react/jsx-runtime";
+import { createContext, useContext, useState, useRef, useMemo, useEffect } from "react";
+import { stringCompare } from "../../shared/src/string-compare.js";
+import { Zero } from "../../zero-client/src/client/zero.js";
+const 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;
+}
+function createUseZero() {
+  return () => useZero();
+}
+const 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) 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 });
+}
+export {
+  ZeroContext,
+  ZeroProvider,
+  createUseZero,
+  useZero
+};
+//# sourceMappingURL=zero-provider.js.map

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

@@ -0,0 +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 type {CustomMutatorDefs} from '../../zero-client/src/client/custom.ts';\nimport type {ZeroOptions} from '../../zero-client/src/client/options.ts';\nimport {Zero} from '../../zero-client/src/client/zero.ts';\nimport type {Schema} from '../../zero-types/src/schema.ts';\nimport type {AnyMutatorRegistry} from '../../zql/src/mutate/mutator-registry.ts';\n\nexport const ZeroContext = createContext<unknown | undefined>(undefined);\n\nexport function useZero<\n  S extends Schema,\n  MD extends AnyMutatorRegistry | CustomMutatorDefs | undefined = undefined,\n  Context = unknown,\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\nexport function createUseZero<\n  S extends Schema,\n  MD extends AnyMutatorRegistry | CustomMutatorDefs | undefined = undefined,\n  Context = unknown,\n>() {\n  return () => useZero<S, MD, Context>();\n}\n\nexport type ZeroProviderProps<\n  S extends Schema,\n  MD extends AnyMutatorRegistry | CustomMutatorDefs | undefined,\n  Context,\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 Schema,\n  MD extends AnyMutatorRegistry | CustomMutatorDefs | undefined,\n  Context,\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) 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":";;;;AAgBO,MAAM,cAAc,cAAmC,MAAS;AAEhE,SAAS,UAIU;AACxB,QAAM,OAAO,WAAW,WAAW;AACnC,MAAI,SAAS,QAAW;AACtB,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AACA,SAAO;AACT;AAEO,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,KAAM;AAEX,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;"}

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

@@ -0,0 +1,27 @@
+function relationships(table, cb) {
+  const relationships2 = cb({ many, one });
+  return {
+    name: table.schema.name,
+    relationships: relationships2
+  };
+}
+function many(...args) {
+  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"
+  }));
+}
+export {
+  relationships
+};
+//# sourceMappingURL=relationship-builder.js.map

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

@@ -0,0 +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;"}

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

@@ -0,0 +1,88 @@
+import { h64 } from "../../../shared/src/hash.js";
+import { mapEntries } from "../../../shared/src/objects.js";
+import { normalizeClientSchema } from "../../../zero-protocol/src/client-schema.js";
+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
+  };
+}
+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];
+    });
+  });
+}
+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 };
+}
+export {
+  clientSchemaFrom,
+  createSchema
+};
+//# sourceMappingURL=schema-builder.js.map