@rocicorp/zero 1.6.0-canary.0 → 1.6.0-canary.10

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-connection-state.js","names":[],"sources":["../../../../../zero-react/src/use-connection-state.tsx"],"sourcesContent":["import {useSyncExternalStore} from 'react';\nimport {useZero} from './zero-provider.tsx';\nimport type {ConnectionState} from './zero.ts';\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 useConnectionState(): 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"],"mappings":";;;;;;;;;;;AAUA,SAAgB,qBAAsC;CACpD,MAAM,OAAO,QAAQ;CACrB,QAAA,GAAA,aAAA,sBACE,KAAK,WAAW,MAAM,iBAChB,KAAK,WAAW,MAAM,eACtB,KAAK,WAAW,MAAM,OAC9B;AACF"}

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

@@ -0,0 +1,301 @@
+import { __toESM } from "../../../_virtual/_rolldown/runtime.js";
+import { asQueryInternals } from "../../zql/src/query/query-internals.js";
+import { addContextToQuery } from "../../zql/src/query/query-registry.js";
+import { DEFAULT_TTL_MS } from "../../zql/src/query/ttl.js";
+import { deepClone } from "../../shared/src/deep-clone.js";
+import { require_react } from "../../../node_modules/.pnpm/react@18.3.1/node_modules/react/index.js";
+import { useZero } from "./zero-provider.js";
+import "./bindings.js";
+import { resolver } from "@rocicorp/resolver";
+//#region ../zero-react/src/use-query.tsx
+var import_react = /* @__PURE__ */ __toESM(require_react(), 1);
+var reactUse = import_react.default.use;
+var suspend = reactUse ? reactUse : (p) => {
+	throw p;
+};
+function useQuery(query, options) {
+	let enabled = true;
+	let ttl = DEFAULT_TTL_MS;
+	if (typeof options === "boolean") enabled = options;
+	else if (options) ({enabled = true, ttl = DEFAULT_TTL_MS} = options);
+	const zero = useZero();
+	const q = query ? addContextToQuery(query, zero.context) : void 0;
+	const view = q ? viewStore.getView(zero, q, enabled, ttl) : void 0;
+	return (0, import_react.useSyncExternalStore)(view?.subscribeReactInternals ?? disabledSubscriber, view?.getSnapshot ?? getDisabledSnapshot, view?.getSnapshot ?? getDisabledSnapshot);
+}
+function useSuspenseQuery(query, options) {
+	let enabled = true;
+	let ttl = DEFAULT_TTL_MS;
+	let suspendUntil = "partial";
+	if (typeof options === "boolean") enabled = options;
+	else if (options) ({enabled = true, ttl = DEFAULT_TTL_MS, suspendUntil = "complete"} = options);
+	const zero = useZero();
+	const q = query ? addContextToQuery(query, zero.context) : void 0;
+	const view = q ? viewStore.getView(zero, q, enabled, ttl) : void 0;
+	const snapshot = (0, import_react.useSyncExternalStore)(view?.subscribeReactInternals ?? disabledSubscriber, view?.getSnapshot ?? getDisabledSnapshot, view?.getSnapshot ?? getDisabledSnapshot);
+	if (view && enabled) {
+		if (suspendUntil === "complete" && !view.complete) suspend(view.waitForComplete());
+		if (suspendUntil === "partial" && !view.nonEmpty) suspend(view.waitForNonEmpty());
+	}
+	return snapshot;
+}
+var emptyArray = [];
+var disabledSubscriber = () => () => {};
+var resultTypeUnknown = { type: "unknown" };
+var resultTypeComplete = { type: "complete" };
+var resultTypeError = { type: "error" };
+var disabledQuerySnapshot = [void 0, resultTypeUnknown];
+var getDisabledSnapshot = () => disabledQuerySnapshot;
+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];
+function getDefaultSnapshot(singular) {
+	return singular ? emptySnapshotSingularUnknown : emptySnapshotPluralUnknown;
+}
+/**
+* Returns a new snapshot or one of the empty predefined ones. Returning the
+* predefined ones is important to prevent unnecessary re-renders in React.
+*/
+function getSnapshot(singular, data, resultType, retryFn, error) {
+	if (singular && data === void 0) switch (resultType) {
+		case "error":
+			if (error) return [void 0, makeError(retryFn, error)];
+			return emptySnapshotSingularErrorUnknown;
+		case "complete": return emptySnapshotSingularComplete;
+		case "unknown": return emptySnapshotSingularUnknown;
+	}
+	if (!singular && data.length === 0) switch (resultType) {
+		case "error":
+			if (error) return [emptyArray, makeError(retryFn, error)];
+			return emptySnapshotErrorUnknown;
+		case "complete": return emptySnapshotPluralComplete;
+		case "unknown": return emptySnapshotPluralUnknown;
+	}
+	switch (resultType) {
+		case "error":
+			if (error) return [data, makeError(retryFn, error)];
+			return [data, makeError(retryFn, {
+				error: "app",
+				id: "unknown",
+				name: "unknown",
+				message: "An unknown error occurred"
+			})];
+		case "complete": return [data, resultTypeComplete];
+		case "unknown": return [data, resultTypeUnknown];
+	}
+}
+function makeError(retry, error) {
+	const message = error.message ?? "An unknown error occurred";
+	return {
+		type: "error",
+		retry,
+		refetch: retry,
+		error: {
+			type: error.error,
+			message,
+			...error.details ? { details: error.details } : {}
+		}
+	};
+}
+/**
+* A global store of all active views.
+*
+* React subscribes and unsubscribes to these views
+* via `useSyncExternalStore`.
+*
+* Managing views through `useEffect` or `useLayoutEffect` causes
+* inconsistencies because effects run after render.
+*
+* For example, if useQuery used use*Effect in the component below:
+* ```ts
+* function Foo({issueID}) {
+*   const issue = useQuery(z.query.issue.where('id', issueID).one());
+*   if (issue?.id !== undefined && issue.id !== issueID) {
+*     console.log('MISMATCH!', issue.id, issueID);
+*   }
+* }
+* ```
+*
+* `MISMATCH` will be printed whenever the `issueID` prop changes.
+*
+* This is because the component will render once with
+* the old state returned from `useQuery`. Then the effect inside
+* `useQuery` will run. The component will render again with the new
+* state. This inconsistent transition can cause unexpected results.
+*
+* Emulating `useEffect` via `useState` and `if` causes resource leaks.
+* That is:
+*
+* ```ts
+* function useQuery(q) {
+*   const [oldHash, setOldHash] = useState();
+*   if (hash(q) !== oldHash) {
+*      // make new view
+*   }
+*
+*   useEffect(() => {
+*     return () => view.destroy();
+*   }, []);
+* }
+* ```
+*
+* I'm not sure why but in strict mode the cleanup function
+* fails to be called for the first instance of the view and only
+* cleans up later instances.
+*
+* Swapping `useState` to `useRef` has similar problems.
+*/
+var ViewStore = class {
+	#views = /* @__PURE__ */ new Map();
+	constructor() {}
+	getView(zero, q, enabled, ttl) {
+		const qi = asQueryInternals(q);
+		if (!enabled) return {
+			getSnapshot: () => getDefaultSnapshot(qi.format.singular),
+			subscribeReactInternals: disabledSubscriber,
+			updateTTL: () => {},
+			waitForComplete: () => Promise.resolve(),
+			waitForNonEmpty: () => Promise.resolve(),
+			complete: false,
+			nonEmpty: false
+		};
+		const hash = qi.hash() + zero.clientID;
+		let existing = this.#views.get(hash);
+		if (!existing) {
+			existing = new ViewWrapper(q, zero, ttl, (view) => {
+				const currentView = this.#views.get(hash);
+				if (currentView && currentView !== view) return;
+				this.#views.delete(hash);
+			});
+			this.#views.set(hash, existing);
+		} else existing.updateTTL(ttl);
+		return existing;
+	}
+};
+var viewStore = new ViewStore();
+/**
+* This wraps and ref counts a view.
+*
+* The only signal we have from React as to whether or not it is
+* done with a view is when it calls `unsubscribe`.
+*
+* In non-strict-mode we can clean up the view as soon
+* as the listener count goes to 0.
+*
+* In strict-mode, the listener count will go to 0 then a
+* new listener for the same view is immediately added back.
+*
+* This is why the `onMaterialized` and `onDematerialized` callbacks exist --
+* they allow a view which React is still referencing to be added
+* back into the store when React re-subscribes to it.
+*
+* This wrapper also exists to deal with the various
+* `useSyncExternalStore` caveats that cause excessive
+* re-renders and materializations.
+*
+* See: https://react.dev/reference/react/useSyncExternalStore#caveats
+* Especially:
+* 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.
+* 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.
+*/
+var ViewWrapper = class {
+	#view;
+	#onDematerialized;
+	#query;
+	#snapshot;
+	#reactInternals = /* @__PURE__ */ new Set();
+	#ttl;
+	#complete = false;
+	#completeResolver = resolver();
+	#nonEmpty = false;
+	#nonEmptyResolver = resolver();
+	#zero;
+	#singular;
+	#destroyTimer;
+	constructor(query, zero, ttl, onDematerialized) {
+		this.#query = query;
+		this.#zero = zero;
+		this.#ttl = ttl;
+		this.#onDematerialized = onDematerialized;
+		const { singular } = asQueryInternals(query).format;
+		this.#singular = singular;
+		this.#snapshot = getDefaultSnapshot(singular);
+		this.#materializeIfNeeded();
+	}
+	#onData = (snap, resultType, error) => {
+		const data = snap === void 0 ? snap : deepClone(snap);
+		this.#snapshot = getSnapshot(this.#singular, data, resultType, this.#retry, error);
+		if (resultType === "complete" || resultType === "error") {
+			this.#complete = true;
+			this.#completeResolver.resolve();
+			this.#nonEmpty = true;
+			this.#nonEmptyResolver.resolve();
+		}
+		if (this.#singular ? this.#snapshot[0] !== void 0 : this.#snapshot[0].length !== 0) {
+			this.#nonEmpty = true;
+			this.#nonEmptyResolver.resolve();
+		}
+		for (const internals of this.#reactInternals) internals();
+	};
+	/**
+	* Called by the user to force a retry of the query
+	* in the case the query errored.
+	*/
+	#retry = () => {
+		this.#view?.destroy();
+		this.#view = void 0;
+		this.#materializeIfNeeded();
+	};
+	#materializeIfNeeded = () => {
+		if (this.#view) return;
+		this.#view = this.#zero.materialize(this.#query, { ttl: this.#ttl });
+		this.#view.addListener(this.#onData);
+	};
+	getSnapshot = () => this.#snapshot;
+	subscribeReactInternals = (internals) => {
+		this.#reactInternals.add(internals);
+		if (this.#destroyTimer !== void 0) {
+			clearTimeout(this.#destroyTimer);
+			this.#destroyTimer = void 0;
+		}
+		this.#materializeIfNeeded();
+		return () => {
+			this.#reactInternals.delete(internals);
+			if (this.#reactInternals.size === 0) this.#destroyTimer = setTimeout(() => {
+				this.#destroyTimer = void 0;
+				if (this.#view === void 0) return;
+				if (this.#reactInternals.size > 0) return;
+				this.#view.destroy();
+				this.#view = void 0;
+				this.#complete = false;
+				this.#completeResolver = resolver();
+				this.#nonEmpty = false;
+				this.#nonEmptyResolver = resolver();
+				this.#onDematerialized(this);
+			}, 10);
+		};
+	};
+	updateTTL(ttl) {
+		this.#ttl = ttl;
+		this.#view?.updateTTL(ttl);
+	}
+	get complete() {
+		return this.#complete;
+	}
+	waitForComplete() {
+		return this.#completeResolver.promise;
+	}
+	get nonEmpty() {
+		return this.#nonEmpty;
+	}
+	waitForNonEmpty() {
+		return this.#nonEmptyResolver.promise;
+	}
+};
+//#endregion
+export { useQuery, useSuspenseQuery };
+
+//# sourceMappingURL=use-query.js.map

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

@@ -0,0 +1 @@
+{"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 {TESTING} from '../../shared/src/testing.ts';\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\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/packages/zero-react/src/use-zero-online.js

@@ -0,0 +1,22 @@
+import { __toESM } from "../../../_virtual/_rolldown/runtime.js";
+import { require_react } from "../../../node_modules/.pnpm/react@18.3.1/node_modules/react/index.js";
+import { useZero } from "./zero-provider.js";
+//#region ../zero-react/src/use-zero-online.tsx
+var import_react = /* @__PURE__ */ __toESM(require_react(), 1);
+/**
+* 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 (0, import_react.useSyncExternalStore)(zero.onOnline, () => zero.online, () => zero.online);
+}
+//#endregion
+export { useZeroOnline };
+
+//# sourceMappingURL=use-zero-online.js.map

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

@@ -0,0 +1 @@
+{"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,QAAQ;CACrB,QAAA,GAAA,aAAA,sBACE,KAAK,gBACC,KAAK,cACL,KAAK,MACb;AACF"}

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

@@ -0,0 +1,90 @@
+import { __toESM } from "../../../_virtual/_rolldown/runtime.js";
+import { stringCompare } from "../../shared/src/string-compare.js";
+import { Zero } from "../../zero-client/src/client/zero.js";
+import { require_react } from "../../../node_modules/.pnpm/react@18.3.1/node_modules/react/index.js";
+import "./zero.js";
+import { require_jsx_runtime } from "../../../node_modules/.pnpm/react@18.3.1/node_modules/react/jsx-runtime.js";
+//#region ../zero-react/src/zero-provider.tsx
+var import_react = /* @__PURE__ */ __toESM(require_react(), 1);
+var import_jsx_runtime = require_jsx_runtime();
+var ZeroContext = (0, import_react.createContext)(void 0);
+function useZero() {
+	const zero = (0, import_react.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();
+}
+function ZeroProvider({ children, init, ...props }) {
+	const isExternalZero = "zero" in props;
+	const [zero, setZero] = (0, import_react.useState)(isExternalZero ? props.zero : void 0);
+	const [rotationGeneration, setRotationGeneration] = (0, import_react.useState)(0);
+	const auth = "auth" in props ? props.auth : void 0;
+	const hasAuth = typeof auth === "string";
+	const prevAuthRef = (0, import_react.useRef)(auth);
+	const rotationPendingRef = (0, import_react.useRef)(false);
+	const scheduleRotation = () => {
+		if (rotationPendingRef.current) return;
+		rotationPendingRef.current = true;
+		setRotationGeneration((gen) => gen + 1);
+	};
+	(0, import_react.useEffect)(() => {
+		if (isExternalZero) {
+			rotationPendingRef.current = false;
+			setZero(props.zero);
+			return;
+		}
+		const z = new Zero({
+			...props,
+			onClientStateNotFound: () => {
+				if (rotationPendingRef.current) return;
+				if (props.onClientStateNotFound) try {
+					props.onClientStateNotFound();
+					return;
+				} catch {}
+				scheduleRotation();
+			}
+		});
+		prevAuthRef.current = auth;
+		init?.(z);
+		setZero(z);
+		rotationPendingRef.current = false;
+		return () => {
+			z.close();
+			setZero(void 0);
+		};
+	}, [
+		hasAuth,
+		init,
+		rotationGeneration,
+		...(0, import_react.useMemo)(() => Object.entries(props).filter(([key]) => key !== "auth").sort(([a], [b]) => stringCompare(a, b)).map(([_, value]) => value), [props])
+	]);
+	(0, import_react.useEffect)(() => {
+		if (!zero || isExternalZero) return;
+		const prevAuth = prevAuthRef.current;
+		if (auth !== prevAuth) {
+			prevAuthRef.current = auth;
+			if (typeof prevAuth === "string" && typeof auth === "string") zero.connection.connect({ auth });
+		}
+	}, [auth, zero]);
+	return zero && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ZeroContext.Provider, {
+		value: zero,
+		children
+	});
+}
+//#endregion
+export { ZeroContext, ZeroProvider, createUseZero, useZero };
+
+//# sourceMappingURL=zero-provider.js.map

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

@@ -0,0 +1 @@
+{"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  /**\n   * Called after ZeroProvider constructs a new Zero instance.\n   *\n   * This runs only when the provider creates Zero from options, and is not\n   * called when an existing instance is passed with `zero`.\n   */\n  init?: (zero: Zero<S, MD, Context>) => void;\n  children: ReactNode;\n};\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  const [rotationGeneration, setRotationGeneration] = useState(0);\n\n  const auth = 'auth' in props ? props.auth : undefined;\n  const hasAuth = typeof auth === 'string';\n  const prevAuthRef = useRef<typeof auth>(auth);\n  const rotationPendingRef = useRef(false);\n\n  const scheduleRotation = () => {\n    if (rotationPendingRef.current) {\n      return;\n    }\n    rotationPendingRef.current = true;\n    setRotationGeneration(gen => gen + 1);\n  };\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      rotationPendingRef.current = false;\n      setZero(props.zero);\n      return;\n    }\n\n    const z = new Zero({\n      ...props,\n      onClientStateNotFound: () => {\n        if (rotationPendingRef.current) {\n          return;\n        }\n\n        if (props.onClientStateNotFound) {\n          try {\n            props.onClientStateNotFound();\n            return;\n          } catch {\n            // rotate since zero client is now closed\n          }\n        }\n\n        scheduleRotation();\n      },\n    });\n    prevAuthRef.current = auth;\n    init?.(z);\n    setZero(z);\n    rotationPendingRef.current = false;\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  }, [hasAuth, init, rotationGeneration, ...keysWithoutAuth]);\n\n  useEffect(() => {\n    if (!zero || isExternalZero) return;\n\n    const prevAuth = prevAuthRef.current;\n    const authChanged = auth !== prevAuth;\n\n    if (authChanged) {\n      prevAuthRef.current = auth;\n\n      if (typeof prevAuth === 'string' && typeof auth === 'string') {\n        void zero.connection.connect({auth});\n      }\n    }\n  }, [auth, zero]);\n\n  return (\n    zero && <ZeroContext.Provider value={zero}>{children}</ZeroContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;AAqBA,IAAa,eAAA,GAAA,aAAA,eACX,KAAA,CACF;AAEA,SAAgB,UAIU;CACxB,MAAM,QAAA,GAAA,aAAA,YAAkB,WAAW;CACnC,IAAI,SAAS,KAAA,GACX,MAAM,IAAI,MAAM,4CAA4C;CAE9D,OAAO;AACT;;;;;;;;;;;;AAaA,SAAgB,gBAIZ;CACF,aAAa,QAAwB;AACvC;AAiBA,SAAgB,aAId,EAAC,UAAU,MAAM,GAAG,SAA2C;CAC/D,MAAM,iBAAiB,UAAU;CAEjC,MAAM,CAAC,MAAM,YAAA,GAAA,aAAA,UACX,iBAAiB,MAAM,OAAO,KAAA,CAChC;CACA,MAAM,CAAC,oBAAoB,0BAAA,GAAA,aAAA,UAAkC,CAAC;CAE9D,MAAM,OAAO,UAAU,QAAQ,MAAM,OAAO,KAAA;CAC5C,MAAM,UAAU,OAAO,SAAS;CAChC,MAAM,eAAA,GAAA,aAAA,QAAkC,IAAI;CAC5C,MAAM,sBAAA,GAAA,aAAA,QAA4B,KAAK;CAEvC,MAAM,yBAAyB;EAC7B,IAAI,mBAAmB,SACrB;EAEF,mBAAmB,UAAU;EAC7B,uBAAsB,QAAO,MAAM,CAAC;CACtC;CAgBA,CAAA,GAAA,aAAA,iBAAgB;EACd,IAAI,gBAAgB;GAClB,mBAAmB,UAAU;GAC7B,QAAQ,MAAM,IAAI;GAClB;EACF;EAEA,MAAM,IAAI,IAAI,KAAK;GACjB,GAAG;GACH,6BAA6B;IAC3B,IAAI,mBAAmB,SACrB;IAGF,IAAI,MAAM,uBACR,IAAI;KACF,MAAM,sBAAsB;KAC5B;IACF,QAAQ,CAER;IAGF,iBAAiB;GACnB;EACF,CAAC;EACD,YAAY,UAAU;EACtB,OAAO,CAAC;EACR,QAAQ,CAAC;EACT,mBAAmB,UAAU;EAE7B,aAAa;GACX,EAAO,MAAM;GACb,QAAQ,KAAA,CAAS;EACnB;CAGF,GAAG;EAAC;EAAS;EAAM;EAAoB,IAAA,GAAA,aAAA,eAjDnC,OAAO,QAAQ,KAAK,EACjB,QAAQ,CAAC,SAAS,QAAQ,MAAM,EAChC,MAAM,CAAC,IAAI,CAAC,OAAO,cAAc,GAAG,CAAC,CAAC,EACtC,KAAK,CAAC,GAAG,WAAW,KAAK,GAC9B,CAAC,KAAK,CA6CkC;CAAe,CAAC;CAE1D,CAAA,GAAA,aAAA,iBAAgB;EACd,IAAI,CAAC,QAAQ,gBAAgB;EAE7B,MAAM,WAAW,YAAY;EAG7B,IAFoB,SAAS,UAEZ;GACf,YAAY,UAAU;GAEtB,IAAI,OAAO,aAAa,YAAY,OAAO,SAAS,UAClD,KAAU,WAAW,QAAQ,EAAC,KAAI,CAAC;EAEvC;CACF,GAAG,CAAC,MAAM,IAAI,CAAC;CAEf,OACE,QAAQ,iBAAA,GAAA,mBAAA,KAAC,YAAY,UAAb;EAAsB,OAAO;EAAO;CAA+B,CAAA;AAE/E"}

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

@@ -0,0 +1 @@
+{"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;CAAG,CAAQ;CAE3C,OAAO;EACL,MAAM,MAAM,OAAO;EACnB;CACF;AACF;AAEA,SAAS,KACP,GAAG,MAC8B;CACjC,OAAO,KAAK,KAAI,SAAQ;EACtB,aAAa,IAAI;EACjB,WAAW,IAAI;EACf,YAAY,IAAI,WAAW,OAAO;EAClC,aAAa;CACf,EAAE;AACJ;AAEA,SAAS,IACP,GAAG,MAC6B;CAChC,OAAO,KAAK,KAAI,SAAQ;EACtB,aAAa,IAAI;EACjB,WAAW,IAAI;EACf,YAAY,IAAI,WAAW,OAAO;EAClC,aAAa;CACf,EAAE;AACJ"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder.js","names":[],"sources":["../../../../../../zero-schema/src/builder/schema-builder.ts"],"sourcesContent":["/* oxlint-disable @typescript-eslint/no-explicit-any */\nimport {h64} from '../../../shared/src/hash.ts';\nimport {mapEntries} from '../../../shared/src/objects.ts';\nimport {\n  normalizeClientSchema,\n  type ClientSchema,\n} from '../../../zero-protocol/src/client-schema.ts';\nimport type {\n  Relationship,\n  Schema,\n  TableSchema,\n} from '../../../zero-types/src/schema.ts';\nimport type {Relationships} from './relationship-builder.ts';\nimport {type TableBuilderWithColumns} from './table-builder.ts';\n\n/**\n * Note: the keys of the `tables` and `relationships` parameters do not matter.\n * You can assign them to any value you like. E.g.,\n *\n * ```ts\n * createSchema({rsdfgafg: table('users')...}, {sdfd: relationships(users, ...)})\n * ```\n */\nexport function createSchema<\n  const TTables extends readonly TableBuilderWithColumns<TableSchema>[],\n  const TRelationships extends readonly Relationships[],\n  const TEnableLegacyQueries extends boolean | undefined,\n  const TEnableLegacyMutators extends boolean | undefined,\n>(options: {\n  readonly tables: TTables;\n  readonly relationships?: TRelationships | undefined;\n  /** @see Schema.enableLegacyQueries */\n  readonly enableLegacyQueries?: TEnableLegacyQueries | undefined;\n  /** @see Schema.enableLegacyMutators */\n  readonly enableLegacyMutators?: TEnableLegacyMutators | undefined;\n}): {\n  tables: {\n    readonly [K in TTables[number]['schema']['name']]: Extract<\n      TTables[number]['schema'],\n      {name: K}\n    >;\n  };\n  relationships: {\n    readonly [K in TRelationships[number]['name']]: Extract<\n      TRelationships[number],\n      {name: K}\n    >['relationships'];\n  };\n  enableLegacyQueries: TEnableLegacyQueries;\n  enableLegacyMutators: TEnableLegacyMutators;\n} {\n  const retTables: Record<string, TableSchema> = {};\n  const retRelationships: Record<string, Record<string, Relationship>> = {};\n  const serverNames = new Set<string>();\n\n  options.tables.forEach(table => {\n    const {serverName = table.schema.name} = table.schema;\n    if (serverNames.has(serverName)) {\n      throw new Error(`Multiple tables reference the name \"${serverName}\"`);\n    }\n    serverNames.add(serverName);\n    if (Object.hasOwn(retTables, table.schema.name)) {\n      throw new Error(\n        `Table \"${table.schema.name}\" is defined more than once in the schema`,\n      );\n    }\n    retTables[table.schema.name] = table.build();\n  });\n  options.relationships?.forEach(relationships => {\n    if (retRelationships[relationships.name]) {\n      throw new Error(\n        `Relationships for table \"${relationships.name}\" are defined more than once in the schema`,\n      );\n    }\n    retRelationships[relationships.name] = relationships.relationships;\n    checkRelationship(\n      relationships.relationships,\n      relationships.name,\n      retTables,\n    );\n  });\n\n  return {\n    tables: retTables,\n    relationships: retRelationships,\n    enableLegacyQueries: options.enableLegacyQueries,\n    enableLegacyMutators: options.enableLegacyMutators,\n  } as any;\n}\n\nfunction checkRelationship(\n  relationships: Record<string, Relationship>,\n  tableName: string,\n  tables: Record<string, TableSchema>,\n) {\n  // TS should be able to check this for us but something is preventing it from happening.\n  Object.entries(relationships).forEach(([name, rel]) => {\n    let source = tables[tableName];\n    if (source.columns[name] !== undefined) {\n      throw new Error(\n        `Relationship \"${tableName}\".\"${name}\" cannot have the same name as the column \"${name}\" on the the table \"${source.name}\"`,\n      );\n    }\n    rel.forEach(connection => {\n      if (!tables[connection.destSchema]) {\n        throw new Error(\n          `For relationship \"${tableName}\".\"${name}\", destination table \"${connection.destSchema}\" is missing in the schema`,\n        );\n      }\n      if (!source.columns[connection.sourceField[0]]) {\n        throw new Error(\n          `For relationship \"${tableName}\".\"${name}\", the source field \"${connection.sourceField[0]}\" is missing in the table schema \"${source.name}\"`,\n        );\n      }\n      source = tables[connection.destSchema];\n    });\n  });\n}\n\nexport function clientSchemaFrom(schema: Schema): {\n  clientSchema: ClientSchema;\n  hash: string;\n} {\n  const client = {\n    tables: mapEntries(\n      schema.tables,\n      (name, {serverName, columns, primaryKey}) => [\n        serverName ?? name,\n        {\n          columns: mapEntries(columns, (name, {serverName, type}) => [\n            serverName ?? name,\n            {type},\n          ]),\n          primaryKey: primaryKey.map(k => columns[k].serverName ?? k),\n        },\n      ],\n    ),\n  } satisfies ClientSchema;\n  const clientSchema = normalizeClientSchema(client);\n  const hash = h64(JSON.stringify(clientSchema)).toString(36);\n  return {clientSchema, hash};\n}\n"],"mappings":";;;;;;;;;;;;AAuBA,SAAgB,aAKd,SAsBA;CACA,MAAM,YAAyC,CAAC;CAChD,MAAM,mBAAiE,CAAC;CACxE,MAAM,8BAAc,IAAI,IAAY;CAEpC,QAAQ,OAAO,SAAQ,UAAS;EAC9B,MAAM,EAAC,aAAa,MAAM,OAAO,SAAQ,MAAM;EAC/C,IAAI,YAAY,IAAI,UAAU,GAC5B,MAAM,IAAI,MAAM,uCAAuC,WAAW,EAAE;EAEtE,YAAY,IAAI,UAAU;EAC1B,IAAI,OAAO,OAAO,WAAW,MAAM,OAAO,IAAI,GAC5C,MAAM,IAAI,MACR,UAAU,MAAM,OAAO,KAAK,0CAC9B;EAEF,UAAU,MAAM,OAAO,QAAQ,MAAM,MAAM;CAC7C,CAAC;CACD,QAAQ,eAAe,SAAQ,kBAAiB;EAC9C,IAAI,iBAAiB,cAAc,OACjC,MAAM,IAAI,MACR,4BAA4B,cAAc,KAAK,2CACjD;EAEF,iBAAiB,cAAc,QAAQ,cAAc;EACrD,kBACE,cAAc,eACd,cAAc,MACd,SACF;CACF,CAAC;CAED,OAAO;EACL,QAAQ;EACR,eAAe;EACf,qBAAqB,QAAQ;EAC7B,sBAAsB,QAAQ;CAChC;AACF;AAEA,SAAS,kBACP,eACA,WACA,QACA;CAEA,OAAO,QAAQ,aAAa,EAAE,SAAS,CAAC,MAAM,SAAS;EACrD,IAAI,SAAS,OAAO;EACpB,IAAI,OAAO,QAAQ,UAAU,KAAA,GAC3B,MAAM,IAAI,MACR,iBAAiB,UAAU,KAAK,KAAK,6CAA6C,KAAK,sBAAsB,OAAO,KAAK,EAC3H;EAEF,IAAI,SAAQ,eAAc;GACxB,IAAI,CAAC,OAAO,WAAW,aACrB,MAAM,IAAI,MACR,qBAAqB,UAAU,KAAK,KAAK,wBAAwB,WAAW,WAAW,2BACzF;GAEF,IAAI,CAAC,OAAO,QAAQ,WAAW,YAAY,KACzC,MAAM,IAAI,MACR,qBAAqB,UAAU,KAAK,KAAK,uBAAuB,WAAW,YAAY,GAAG,oCAAoC,OAAO,KAAK,EAC5I;GAEF,SAAS,OAAO,WAAW;EAC7B,CAAC;CACH,CAAC;AACH;AAEA,SAAgB,iBAAiB,QAG/B;CAgBA,MAAM,eAAe,sBAAsB,EAdzC,QAAQ,WACN,OAAO,SACN,MAAM,EAAC,YAAY,SAAS,iBAAgB,CAC3C,cAAc,MACd;EACE,SAAS,WAAW,UAAU,MAAM,EAAC,YAAY,WAAU,CACzD,cAAc,MACd,EAAC,KAAI,CACP,CAAC;EACD,YAAY,WAAW,KAAI,MAAK,QAAQ,GAAG,cAAc,CAAC;CAC5D,CACF,CACF,EAEyC,CAAM;CAEjD,OAAO;EAAC;EAAc,MADT,IAAI,KAAK,UAAU,YAAY,CAAC,EAAE,SAAS,EAClC;CAAI;AAC5B"}

package/out/packages/zero-schema/src/builder/table-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-builder.js","names":["#schema"],"sources":["../../../../../../zero-schema/src/builder/table-builder.ts"],"sourcesContent":["import type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport type {PrimaryKey} from '../../../zero-protocol/src/primary-key.ts';\nimport type {SchemaValue, TableSchema} from '../table-schema.ts';\n\n/* oxlint-disable @typescript-eslint/no-explicit-any */\nexport function table<TName extends string>(name: TName) {\n  return new TableBuilder({\n    name,\n    columns: {},\n    primaryKey: [] as any as PrimaryKey,\n  });\n}\n\nexport function string<T extends string = string>() {\n  return new ColumnBuilder({\n    type: 'string',\n    optional: false,\n    customType: null as unknown as T,\n  });\n}\n\nexport function number<T extends number = number>() {\n  return new ColumnBuilder({\n    type: 'number',\n    optional: false,\n    customType: null as unknown as T,\n  });\n}\n\nexport function boolean<T extends boolean = boolean>() {\n  return new ColumnBuilder({\n    type: 'boolean',\n    optional: false,\n    customType: null as unknown as T,\n  });\n}\n\nexport function json<T extends ReadonlyJSONValue = ReadonlyJSONValue>() {\n  return new ColumnBuilder({\n    type: 'json',\n    optional: false,\n    customType: null as unknown as T,\n  });\n}\n\nexport function enumeration<T extends string>() {\n  return new ColumnBuilder({\n    type: 'string',\n    optional: false,\n    customType: null as unknown as T,\n  });\n}\n\nexport const column = {\n  string,\n  number,\n  boolean,\n  json,\n  enumeration,\n};\n\nexport class TableBuilder<TShape extends TableSchema> {\n  readonly #schema: TShape;\n  constructor(schema: TShape) {\n    this.#schema = schema;\n  }\n\n  from<ServerName extends string>(serverName: ServerName) {\n    return new TableBuilder<TShape>({\n      ...this.#schema,\n      // Strip the \"public.\" schema if specified, as tables in the upstream\n      // \"public\" schema are created without the schema prefix on the replica.\n      // See liteTableName() in zero-cache/src/types/names.ts\n      serverName: serverName.startsWith('public.')\n        ? serverName.substring('public.'.length)\n        : serverName,\n    });\n  }\n\n  columns<const TColumns extends Record<string, ColumnBuilder<SchemaValue>>>(\n    columns: TColumns,\n  ): TableBuilderWithColumns<{\n    name: TShape['name'];\n    columns: {[K in keyof TColumns]: TColumns[K]['schema']};\n    primaryKey: TShape['primaryKey'];\n  }> {\n    const columnSchemas = Object.fromEntries(\n      Object.entries(columns).map(([k, v]) => [k, v.schema]),\n    ) as {[K in keyof TColumns]: TColumns[K]['schema']};\n    return new TableBuilderWithColumns({\n      ...this.#schema,\n      columns: columnSchemas,\n    }) as any;\n  }\n}\n\nexport class TableBuilderWithColumns<TShape extends TableSchema> {\n  readonly #schema: TShape;\n\n  constructor(schema: TShape) {\n    this.#schema = schema;\n  }\n\n  primaryKey<TPKColNames extends (keyof TShape['columns'])[]>(\n    ...pkColumnNames: TPKColNames\n  ) {\n    return new TableBuilderWithColumns({\n      ...this.#schema,\n      primaryKey: pkColumnNames,\n    });\n  }\n\n  get schema() {\n    return this.#schema;\n  }\n\n  build() {\n    // We can probably get the type system to throw an error if primaryKey is not called\n    // before passing the schema to createSchema\n    // Till then --\n    if (this.#schema.primaryKey.length === 0) {\n      throw new Error(`Table \"${this.#schema.name}\" is missing a primary key`);\n    }\n    const names = new Set<string>();\n    for (const [col, {serverName}] of Object.entries(this.#schema.columns)) {\n      const name = serverName ?? col;\n      if (names.has(name)) {\n        throw new Error(\n          `Table \"${\n            this.#schema.name\n          }\" has multiple columns referencing \"${name}\"`,\n        );\n      }\n      names.add(name);\n    }\n    return this.#schema;\n  }\n}\n\nclass ColumnBuilder<TShape extends SchemaValue<any>> {\n  readonly #schema: TShape;\n  constructor(schema: TShape) {\n    this.#schema = schema;\n  }\n\n  from<ServerName extends string>(serverName: ServerName) {\n    return new ColumnBuilder<TShape & {serverName: string}>({\n      ...this.#schema,\n      serverName,\n    });\n  }\n\n  optional(): ColumnBuilder<Omit<TShape, 'optional'> & {optional: true}> {\n    return new ColumnBuilder({\n      ...this.#schema,\n      optional: true,\n    });\n  }\n\n  get schema() {\n    return this.#schema;\n  }\n}\n\nexport type {ColumnBuilder};\n"],"mappings":";AAKA,SAAgB,MAA4B,MAAa;CACvD,OAAO,IAAI,aAAa;EACtB;EACA,SAAS,CAAC;EACV,YAAY,CAAC;CACf,CAAC;AACH;AAEA,SAAgB,SAAoC;CAClD,OAAO,IAAI,cAAc;EACvB,MAAM;EACN,UAAU;EACV,YAAY;CACd,CAAC;AACH;AAEA,SAAgB,SAAoC;CAClD,OAAO,IAAI,cAAc;EACvB,MAAM;EACN,UAAU;EACV,YAAY;CACd,CAAC;AACH;AAEA,SAAgB,UAAuC;CACrD,OAAO,IAAI,cAAc;EACvB,MAAM;EACN,UAAU;EACV,YAAY;CACd,CAAC;AACH;AAEA,SAAgB,OAAwD;CACtE,OAAO,IAAI,cAAc;EACvB,MAAM;EACN,UAAU;EACV,YAAY;CACd,CAAC;AACH;AAEA,SAAgB,cAAgC;CAC9C,OAAO,IAAI,cAAc;EACvB,MAAM;EACN,UAAU;EACV,YAAY;CACd,CAAC;AACH;AAUA,IAAa,eAAb,MAAa,aAAyC;CACpD;CACA,YAAY,QAAgB;EAC1B,KAAKA,UAAU;CACjB;CAEA,KAAgC,YAAwB;EACtD,OAAO,IAAI,aAAqB;GAC9B,GAAG,KAAKA;GAIR,YAAY,WAAW,WAAW,SAAS,IACvC,WAAW,UAAU,CAAgB,IACrC;EACN,CAAC;CACH;CAEA,QACE,SAKC;EACD,MAAM,gBAAgB,OAAO,YAC3B,OAAO,QAAQ,OAAO,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CACvD;EACA,OAAO,IAAI,wBAAwB;GACjC,GAAG,KAAKA;GACR,SAAS;EACX,CAAC;CACH;AACF;AAEA,IAAa,0BAAb,MAAa,wBAAoD;CAC/D;CAEA,YAAY,QAAgB;EAC1B,KAAKA,UAAU;CACjB;CAEA,WACE,GAAG,eACH;EACA,OAAO,IAAI,wBAAwB;GACjC,GAAG,KAAKA;GACR,YAAY;EACd,CAAC;CACH;CAEA,IAAI,SAAS;EACX,OAAO,KAAKA;CACd;CAEA,QAAQ;EAIN,IAAI,KAAKA,QAAQ,WAAW,WAAW,GACrC,MAAM,IAAI,MAAM,UAAU,KAAKA,QAAQ,KAAK,2BAA2B;EAEzE,MAAM,wBAAQ,IAAI,IAAY;EAC9B,KAAK,MAAM,CAAC,KAAK,EAAC,iBAAgB,OAAO,QAAQ,KAAKA,QAAQ,OAAO,GAAG;GACtE,MAAM,OAAO,cAAc;GAC3B,IAAI,MAAM,IAAI,IAAI,GAChB,MAAM,IAAI,MACR,UACE,KAAKA,QAAQ,KACd,sCAAsC,KAAK,EAC9C;GAEF,MAAM,IAAI,IAAI;EAChB;EACA,OAAO,KAAKA;CACd;AACF;AAEA,IAAM,gBAAN,MAAM,cAA+C;CACnD;CACA,YAAY,QAAgB;EAC1B,KAAKA,UAAU;CACjB;CAEA,KAAgC,YAAwB;EACtD,OAAO,IAAI,cAA6C;GACtD,GAAG,KAAKA;GACR;EACF,CAAC;CACH;CAEA,WAAuE;EACrE,OAAO,IAAI,cAAc;GACvB,GAAG,KAAKA;GACR,UAAU;EACZ,CAAC;CACH;CAEA,IAAI,SAAS;EACX,OAAO,KAAKA;CACd;AACF"}

package/out/packages/zero-schema/src/compiled-permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-permissions.js","names":[],"sources":["../../../../../zero-schema/src/compiled-permissions.ts"],"sourcesContent":["import * as v from '../../shared/src/valita.ts';\nimport {conditionSchema} from '../../zero-protocol/src/ast.ts';\n\nconst ruleSchema = v.tuple([v.literal('allow'), conditionSchema]);\nexport type Rule = v.Infer<typeof ruleSchema>;\nconst policySchema = v.array(ruleSchema);\nexport type Policy = v.Infer<typeof policySchema>;\n\nconst assetSchema = v.object({\n  select: policySchema.optional(),\n  insert: policySchema.optional(),\n  update: v\n    .object({\n      preMutation: policySchema.optional(),\n      postMutation: policySchema.optional(),\n    })\n    .optional(),\n  delete: policySchema.optional(),\n});\n\nexport type AssetPermissions = v.Infer<typeof assetSchema>;\n\nconst tablePermissionsSchema = v.record(\n  v.object({\n    row: assetSchema.optional(),\n    cell: v.record(assetSchema).optional(),\n  }),\n);\n\nexport const permissionsConfigSchema = v.object({\n  tables: tablePermissionsSchema.optional(),\n});\n\nexport type TablePermissions = v.Infer<typeof tablePermissionsSchema>;\nexport type PermissionsConfig = v.Infer<typeof permissionsConfigSchema>;\n"],"mappings":";;;AAGA,IAAM,aAAa,eAAE,MAAM,CAAC,eAAE,QAAQ,OAAO,GAAG,eAAe,CAAC;AAEhE,IAAM,eAAe,eAAE,MAAM,UAAU;AAGvC,IAAM,cAAc,eAAE,OAAO;CAC3B,QAAQ,aAAa,SAAS;CAC9B,QAAQ,aAAa,SAAS;CAC9B,QAAQ,eACL,OAAO;EACN,aAAa,aAAa,SAAS;EACnC,cAAc,aAAa,SAAS;CACtC,CAAC,EACA,SAAS;CACZ,QAAQ,aAAa,SAAS;AAChC,CAAC;AAID,IAAM,yBAAyB,eAAE,OAC/B,eAAE,OAAO;CACP,KAAK,YAAY,SAAS;CAC1B,MAAM,eAAE,OAAO,WAAW,EAAE,SAAS;AACvC,CAAC,CACH;AAEA,IAAa,0BAA0B,eAAE,OAAO,EAC9C,QAAQ,uBAAuB,SAAS,EAC1C,CAAC"}

package/out/packages/zero-schema/src/name-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-mapper.js","names":[],"sources":["../../../../../zero-schema/src/name-mapper.ts"],"sourcesContent":["import {NameMapper} from '../../zero-types/src/name-mapper.ts';\nimport type {TableSchema} from './table-schema.ts';\n\nexport {NameMapper};\n\nexport function clientToServer(\n  tables: Record<string, TableSchema>,\n): NameMapper {\n  return createMapperFrom('client', tables);\n}\n\nexport function serverToClient(\n  tables: Record<string, TableSchema>,\n): NameMapper {\n  return createMapperFrom('server', tables);\n}\n\nfunction createMapperFrom(\n  src: 'client' | 'server',\n  tables: Record<string, TableSchema>,\n): NameMapper {\n  const mapping = new Map(\n    Object.entries(tables).map(\n      ([tableName, {serverName: serverTableName, columns}]) => {\n        let allColumnsSame = true;\n        const names: Record<string, string> = {};\n        for (const [name, {serverName}] of Object.entries(columns)) {\n          if (serverName && serverName !== name) {\n            allColumnsSame = false;\n          }\n          if (src === 'client') {\n            names[name] = serverName ?? name;\n          } else {\n            names[serverName ?? name] = name;\n          }\n        }\n        return [\n          src === 'client' ? tableName : (serverTableName ?? tableName),\n          {\n            tableName:\n              src === 'client' ? (serverTableName ?? tableName) : tableName,\n            columns: names,\n            allColumnsSame,\n          },\n        ];\n      },\n    ),\n  );\n  return new NameMapper(mapping);\n}\n\n/**\n * Returns an \"identity\" NameMapper that simply serves the purpose\n * of validating that all table and column names conform to the\n * specified `tablesToColumns` map.\n */\nexport function validator(tablesToColumns: Map<string, string[]>): NameMapper {\n  const identity = new Map(\n    Array.from(tablesToColumns.entries(), ([tableName, columns]) => [\n      tableName,\n      {\n        tableName,\n        columns: Object.fromEntries(columns.map(c => [c, c])),\n        allColumnsSame: true,\n      },\n    ]),\n  );\n  return new NameMapper(identity);\n}\n"],"mappings":";;AAKA,SAAgB,eACd,QACY;CACZ,OAAO,iBAAiB,UAAU,MAAM;AAC1C;AAEA,SAAgB,eACd,QACY;CACZ,OAAO,iBAAiB,UAAU,MAAM;AAC1C;AAEA,SAAS,iBACP,KACA,QACY;CA4BZ,OAAO,IAAI,WAAW,IA3BF,IAClB,OAAO,QAAQ,MAAM,EAAE,KACpB,CAAC,WAAW,EAAC,YAAY,iBAAiB,eAAc;EACvD,IAAI,iBAAiB;EACrB,MAAM,QAAgC,CAAC;EACvC,KAAK,MAAM,CAAC,MAAM,EAAC,iBAAgB,OAAO,QAAQ,OAAO,GAAG;GAC1D,IAAI,cAAc,eAAe,MAC/B,iBAAiB;GAEnB,IAAI,QAAQ,UACV,MAAM,QAAQ,cAAc;QAE5B,MAAM,cAAc,QAAQ;EAEhC;EACA,OAAO,CACL,QAAQ,WAAW,YAAa,mBAAmB,WACnD;GACE,WACE,QAAQ,WAAY,mBAAmB,YAAa;GACtD,SAAS;GACT;EACF,CACF;CACF,CACF,CAEoB,CAAO;AAC/B;;;;;;AAOA,SAAgB,UAAU,iBAAoD;CAW5E,OAAO,IAAI,WAAW,IAVD,IACnB,MAAM,KAAK,gBAAgB,QAAQ,IAAI,CAAC,WAAW,aAAa,CAC9D,WACA;EACE;EACA,SAAS,OAAO,YAAY,QAAQ,KAAI,MAAK,CAAC,GAAG,CAAC,CAAC,CAAC;EACpD,gBAAgB;CAClB,CACF,CAAC,CAEmB,CAAQ;AAChC"}

package/out/packages/zero-schema/src/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","names":["#anchor","#path"],"sources":["../../../../../zero-schema/src/permissions.ts"],"sourcesContent":["import {assert} from '../../shared/src/asserts.ts';\nimport {\n  mapCondition,\n  toStaticParam,\n  type Condition,\n  type Parameter,\n} from '../../zero-protocol/src/ast.ts';\nimport type {Schema} from '../../zero-types/src/schema.ts';\nimport type {ExpressionBuilder} from '../../zql/src/query/expression.ts';\nimport type {Query} from '../../zql/src/query/query.ts';\nimport {newExpressionBuilder} from '../../zql/src/query/static-query.ts';\nimport type {\n  AssetPermissions as CompiledAssetPermissions,\n  PermissionsConfig as CompiledPermissionsConfig,\n  TablePermissions,\n} from './compiled-permissions.ts';\nimport type {NameMapper} from './name-mapper.ts';\nimport {clientToServer} from './name-mapper.ts';\n\nexport const ANYONE_CAN = [\n  (_: unknown, eb: ExpressionBuilder<never, Schema>) => eb.and(),\n];\n\n/**\n * @deprecated Use {@link ANYONE_CAN} instead.\n */\nexport const ANYONE_CAN_DO_ANYTHING = {\n  row: {\n    select: ANYONE_CAN,\n    insert: ANYONE_CAN,\n    update: {\n      preMutation: ANYONE_CAN,\n      postMutation: ANYONE_CAN,\n    },\n    delete: ANYONE_CAN,\n  },\n};\n\nexport const NOBODY_CAN = [];\n\nexport type Anchor = 'authData' | 'preMutationRow';\n\nexport type Queries<TSchema extends Schema> = {\n  [K in keyof TSchema['tables']]: Query<K & string, TSchema>;\n};\n\nexport type PermissionRule<\n  TAuthDataShape,\n  TSchema extends Schema,\n  TTable extends keyof TSchema['tables'] & string,\n> = (\n  authData: TAuthDataShape,\n  eb: ExpressionBuilder<TTable, TSchema>,\n) => Condition;\n\nexport type AssetPermissions<\n  TAuthDataShape,\n  TSchema extends Schema,\n  TTable extends keyof TSchema['tables'] & string,\n> = {\n  // Why an array of rules?: https://github.com/rocicorp/mono/pull/3184/files#r1869680716\n  select?: PermissionRule<TAuthDataShape, TSchema, TTable>[] | undefined;\n  /**\n   * @deprecated Use Mutators instead.\n   * @see {@link https://zero.rocicorp.dev/docs/writing-data}\n   */\n  insert?: PermissionRule<TAuthDataShape, TSchema, TTable>[] | undefined;\n  /**\n   * @deprecated Use Mutators instead.\n   * @see {@link https://zero.rocicorp.dev/docs/writing-data}\n   */\n  update?:\n    | {\n        preMutation?: PermissionRule<TAuthDataShape, TSchema, TTable>[];\n        postMutation?: PermissionRule<TAuthDataShape, TSchema, TTable>[];\n      }\n    | undefined;\n  /**\n   * @deprecated Use Mutators instead.\n   * @see {@link https://zero.rocicorp.dev/docs/writing-data}\n   */\n  delete?: PermissionRule<TAuthDataShape, TSchema, TTable>[] | undefined;\n};\n\nexport type PermissionsConfig<TAuthDataShape, TSchema extends Schema> = {\n  [K in keyof TSchema['tables']]?: {\n    row?: AssetPermissions<TAuthDataShape, TSchema, K & string> | undefined;\n    cell?:\n      | {\n          [C in keyof TSchema['tables'][K]['columns']]?: Omit<\n            AssetPermissions<TAuthDataShape, TSchema, K & string>,\n            'cell'\n          >;\n        }\n      | undefined;\n  };\n};\n\n/**\n * @deprecated Use {@link defineMutators} and {@link defineQueries} instead.\n */\nexport async function definePermissions<TAuthDataShape, TSchema extends Schema>(\n  schema: TSchema,\n  definer: () =>\n    | Promise<PermissionsConfig<TAuthDataShape, TSchema>>\n    | PermissionsConfig<TAuthDataShape, TSchema>,\n): Promise<CompiledPermissionsConfig | undefined> {\n  const expressionBuilders = {} as Record<\n    string,\n    ExpressionBuilder<string, TSchema>\n  >;\n  for (const name of Object.keys(schema.tables)) {\n    expressionBuilders[name] = newExpressionBuilder(schema, name);\n  }\n\n  const config = await definer();\n  return compilePermissions(schema, config, expressionBuilders);\n}\n\nfunction compilePermissions<TAuthDataShape, TSchema extends Schema>(\n  schema: TSchema,\n  authz: PermissionsConfig<TAuthDataShape, TSchema> | undefined,\n  expressionBuilders: Record<string, ExpressionBuilder<string, TSchema>>,\n): CompiledPermissionsConfig | undefined {\n  if (!authz) {\n    return undefined;\n  }\n  const nameMapper = clientToServer(schema.tables);\n  const ret = {tables: {} as TablePermissions};\n  for (const [tableName, tableConfig] of Object.entries(authz)) {\n    const serverName = schema.tables[tableName].serverName ?? tableName;\n    ret.tables[serverName] = {\n      row: compileRowConfig(\n        nameMapper,\n        tableName,\n        tableConfig.row,\n        expressionBuilders[tableName],\n      ),\n      cell: compileCellConfig(\n        nameMapper,\n        tableName,\n        tableConfig.cell,\n        expressionBuilders[tableName],\n      ),\n    };\n  }\n\n  return ret;\n}\n\nfunction compileRowConfig<\n  TAuthDataShape,\n  TSchema extends Schema,\n  TTable extends keyof TSchema['tables'] & string,\n>(\n  clientToServer: NameMapper,\n  tableName: TTable,\n  rowRules: AssetPermissions<TAuthDataShape, TSchema, TTable> | undefined,\n  expressionBuilder: ExpressionBuilder<TTable, TSchema>,\n): CompiledAssetPermissions | undefined {\n  if (!rowRules) {\n    return undefined;\n  }\n  return {\n    select: compileRules(\n      clientToServer,\n      tableName,\n      rowRules.select,\n      expressionBuilder,\n    ),\n    insert: compileRules(\n      clientToServer,\n      tableName,\n      rowRules.insert,\n      expressionBuilder,\n    ),\n    update: {\n      preMutation: compileRules(\n        clientToServer,\n        tableName,\n        rowRules.update?.preMutation,\n        expressionBuilder,\n      ),\n      postMutation: compileRules(\n        clientToServer,\n        tableName,\n        rowRules.update?.postMutation,\n        expressionBuilder,\n      ),\n    },\n    delete: compileRules(\n      clientToServer,\n      tableName,\n      rowRules.delete,\n      expressionBuilder,\n    ),\n  };\n}\n\n/**\n * What is this \"allow\" and why are permissions policies an array of rules?\n *\n * Please read: https://github.com/rocicorp/mono/pull/3184/files#r1869680716\n */\nfunction compileRules<\n  TAuthDataShape,\n  TSchema extends Schema,\n  TTable extends keyof TSchema['tables'] & string,\n>(\n  clientToServer: NameMapper,\n  tableName: TTable,\n  rules: PermissionRule<TAuthDataShape, TSchema, TTable>[] | undefined,\n  expressionBuilder: ExpressionBuilder<TTable, TSchema>,\n): ['allow', Condition][] | undefined {\n  if (!rules) {\n    return undefined;\n  }\n\n  return rules.map(rule => {\n    const cond = rule(authDataRef as TAuthDataShape, expressionBuilder);\n    return ['allow', mapCondition(cond, tableName, clientToServer)] as const;\n  });\n}\n\nfunction compileCellConfig<\n  TAuthDataShape,\n  TSchema extends Schema,\n  TTable extends keyof TSchema['tables'] & string,\n>(\n  clientToServer: NameMapper,\n  tableName: TTable,\n  cellRules:\n    | Record<string, AssetPermissions<TAuthDataShape, TSchema, TTable>>\n    | undefined,\n  expressionBuilder: ExpressionBuilder<TTable, TSchema>,\n): Record<string, CompiledAssetPermissions> | undefined {\n  if (!cellRules) {\n    return undefined;\n  }\n  const ret: Record<string, CompiledAssetPermissions> = {};\n  for (const [columnName, rules] of Object.entries(cellRules)) {\n    ret[columnName] = {\n      select: compileRules(\n        clientToServer,\n        tableName,\n        rules.select,\n        expressionBuilder,\n      ),\n      insert: compileRules(\n        clientToServer,\n        tableName,\n        rules.insert,\n        expressionBuilder,\n      ),\n      update: {\n        preMutation: compileRules(\n          clientToServer,\n          tableName,\n          rules.update?.preMutation,\n          expressionBuilder,\n        ),\n        postMutation: compileRules(\n          clientToServer,\n          tableName,\n          rules.update?.postMutation,\n          expressionBuilder,\n        ),\n      },\n      delete: compileRules(\n        clientToServer,\n        tableName,\n        rules.delete,\n        expressionBuilder,\n      ),\n    };\n  }\n  return ret;\n}\n\nclass CallTracker {\n  readonly #anchor: Anchor;\n  readonly #path: string[];\n  constructor(anchor: Anchor, path: string[]) {\n    this.#anchor = anchor;\n    this.#path = path;\n  }\n\n  get(target: {[toStaticParam]: () => Parameter}, prop: string | symbol) {\n    if (prop === toStaticParam) {\n      return target[toStaticParam];\n    }\n    assert(\n      typeof prop === 'string',\n      () => `Expected prop to be a string, got ${typeof prop}`,\n    );\n    const path = [...this.#path, prop];\n    return new Proxy(\n      {\n        [toStaticParam]: () => staticParam(this.#anchor, path),\n      },\n      new CallTracker(this.#anchor, path),\n    );\n  }\n}\n\nfunction baseTracker(anchor: Anchor) {\n  return new Proxy(\n    {\n      [toStaticParam]: () => {\n        throw new Error('no JWT field specified');\n      },\n    },\n    new CallTracker(anchor, []),\n  );\n}\n\nexport const authDataRef = baseTracker('authData');\nexport const preMutationRowRef = baseTracker('preMutationRow');\nexport function staticParam(\n  anchorClass: 'authData' | 'preMutationRow',\n  field: string | string[],\n): Parameter {\n  return {\n    type: 'static',\n    anchor: anchorClass,\n    // for backwards compatibility\n    field: field.length === 1 ? field[0] : field,\n  };\n}\n"],"mappings":"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"}

package/out/packages/zero-schema/src/schema-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-config.js","names":[],"sources":["../../../../../zero-schema/src/schema-config.ts"],"sourcesContent":["import * as v from '../../shared/src/valita.ts';\nimport {compoundKeySchema} from '../../zero-protocol/src/ast.ts';\nimport {valueTypeSchema} from '../../zero-protocol/src/client-schema.ts';\nimport {primaryKeySchema} from '../../zero-protocol/src/primary-key.ts';\nimport type {Schema} from '../../zero-types/src/schema.ts';\nimport {type PermissionsConfig} from './compiled-permissions.ts';\nimport type {Relationship, TableSchema} from './table-schema.ts';\n\nexport type SchemaConfig = {\n  schema: Schema;\n  permissions: PermissionsConfig;\n};\n\nconst relationshipPart = v.readonlyObject({\n  sourceField: compoundKeySchema,\n  destField: compoundKeySchema,\n  destSchema: v.string(),\n  cardinality: v.literalUnion('one', 'many'),\n});\n\nexport const relationshipSchema: v.Type<Relationship> = v.union(\n  v.readonly(v.tuple([relationshipPart])),\n  v.readonly(v.tuple([relationshipPart, relationshipPart])),\n);\n\nexport const schemaValueSchema = v.readonlyObject({\n  type: valueTypeSchema,\n  serverName: v.string().optional(),\n  optional: v.boolean().optional(),\n});\n\nexport const tableSchemaSchema: v.Type<TableSchema> = v.readonlyObject({\n  name: v.string(),\n  serverName: v.string().optional(),\n  columns: v.record(schemaValueSchema),\n  primaryKey: primaryKeySchema,\n});\n\nexport const schemaSchema = v.readonlyObject({\n  tables: v.record(tableSchemaSchema),\n  relationships: v.record(v.record(relationshipSchema)),\n  enableLegacyQueries: v.boolean().optional(),\n  enableLegacyMutators: v.boolean().optional(),\n});\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nexport function isSchemaConfig(value: any): value is SchemaConfig {\n  // oxlint-disable-next-line eqeqeq\n  return value != null && 'schema' in value;\n}\n"],"mappings":";;;;;;AAaA,IAAM,mBAAmB,eAAiB;CACxC,aAAa;CACb,WAAW;CACX,YAAY,eAAE,OAAO;CACrB,aAAa,aAAe,OAAO,MAAM;AAC3C,CAAC;AAED,IAAa,qBAA2C,eAAE,MACxD,SAAW,eAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC,GACtC,SAAW,eAAE,MAAM,CAAC,kBAAkB,gBAAgB,CAAC,CAAC,CAC1D;AAEA,IAAa,oBAAoB,eAAiB;CAChD,MAAM;CACN,YAAY,eAAE,OAAO,EAAE,SAAS;CAChC,UAAU,eAAE,QAAQ,EAAE,SAAS;AACjC,CAAC;AAED,IAAa,oBAAyC,eAAiB;CACrE,MAAM,eAAE,OAAO;CACf,YAAY,eAAE,OAAO,EAAE,SAAS;CAChC,SAAS,eAAE,OAAO,iBAAiB;CACnC,YAAY;AACd,CAAC;AAE2B,eAAiB;CAC3C,QAAQ,eAAE,OAAO,iBAAiB;CAClC,eAAe,eAAE,OAAO,eAAE,OAAO,kBAAkB,CAAC;CACpD,qBAAqB,eAAE,QAAQ,EAAE,SAAS;CAC1C,sBAAsB,eAAE,QAAQ,EAAE,SAAS;AAC7C,CAAC;AAGD,SAAgB,eAAe,OAAmC;CAEhE,OAAO,SAAS,QAAQ,YAAY;AACtC"}

package/out/packages/zero-server/src/adapters/drizzle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.js","names":["#drizzle"],"sources":["../../../../../../zero-server/src/adapters/drizzle.ts"],"sourcesContent":["import type {\n  PgDatabase,\n  PgQueryResultHKT,\n  PgTransaction,\n} from 'drizzle-orm/pg-core';\nimport type {ExtractTablesWithRelations} from 'drizzle-orm/relations';\nimport type {AST} from '../../../zero-protocol/src/ast.ts';\nimport type {Format} from '../../../zero-types/src/format.ts';\nimport type {Schema} from '../../../zero-types/src/schema.ts';\nimport type {ServerSchema} from '../../../zero-types/src/server-schema.ts';\nimport type {\n  DBConnection,\n  DBTransaction,\n  Row,\n} from '../../../zql/src/mutate/custom.ts';\nimport type {HumanReadable} from '../../../zql/src/query/query.ts';\nimport {executePostgresQuery} from '../pg-query-executor.ts';\nimport {ZQLDatabase} from '../zql-database.ts';\n\nexport type {ZQLDatabase};\n\nexport type DrizzleDatabase<\n  TQueryResult extends PgQueryResultHKT = PgQueryResultHKT,\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n> = PgDatabase<TQueryResult, TSchema>;\n\n/**\n * Helper type for the wrapped transaction used by drizzle-orm.\n *\n * @remarks Use with `ServerTransaction` as `ServerTransaction<Schema, DrizzleTransaction<typeof drizzleDb>>`.\n */\nexport type DrizzleTransaction<\n  TDbOrSchema extends DrizzleDatabase | Record<string, unknown>,\n  TSchema extends Record<string, unknown> = TDbOrSchema extends PgDatabase<\n    PgQueryResultHKT,\n    infer TInferredSchema\n  >\n    ? TInferredSchema\n    : TDbOrSchema,\n> = PgTransaction<\n  PgQueryResultHKT,\n  TSchema,\n  ExtractTablesWithRelations<TSchema>\n>;\n\nexport class DrizzleConnection<\n  TDrizzle extends DrizzleDatabase,\n  TTransaction extends DrizzleTransaction<TDrizzle> =\n    DrizzleTransaction<TDrizzle>,\n> implements DBConnection<TTransaction> {\n  readonly #drizzle: TDrizzle;\n\n  constructor(drizzle: TDrizzle) {\n    this.#drizzle = drizzle;\n  }\n\n  transaction<T>(\n    fn: (tx: DBTransaction<TTransaction>) => Promise<T>,\n  ): Promise<T> {\n    return this.#drizzle.transaction(drizzleTx =>\n      fn(\n        new DrizzleInternalTransaction(\n          drizzleTx,\n        ) as DBTransaction<TTransaction>,\n      ),\n    );\n  }\n}\n\nclass DrizzleInternalTransaction<\n  TTransaction extends DrizzleTransaction<DrizzleDatabase>,\n> implements DBTransaction<TTransaction> {\n  readonly wrappedTransaction: TTransaction;\n\n  constructor(drizzleTx: TTransaction) {\n    this.wrappedTransaction = drizzleTx;\n  }\n\n  runQuery<TReturn>(\n    ast: AST,\n    format: Format,\n    schema: Schema,\n    serverSchema: ServerSchema,\n  ): Promise<HumanReadable<TReturn>> {\n    return executePostgresQuery<TReturn>(\n      this,\n      ast,\n      format,\n      schema,\n      serverSchema,\n    );\n  }\n\n  async query(sql: string, params: unknown[]): Promise<Iterable<Row>> {\n    const prepared = this.wrappedTransaction._.session.prepareQuery(\n      {sql, params},\n      undefined,\n      undefined,\n      false,\n    );\n    const result = await prepared.execute();\n    return toIterableRows(result);\n  }\n}\n\nfunction isIterable(value: unknown): value is Iterable<unknown> {\n  return (\n    // oxlint-disable-next-line eqeqeq\n    value != null &&\n    typeof (value as Iterable<unknown>)[Symbol.iterator] === 'function'\n  );\n}\n\nexport function toIterableRows(result: unknown): Iterable<Row> {\n  if (result === null || result === undefined) {\n    return [] as Row[];\n  }\n  if (Array.isArray(result)) {\n    return result as Row[];\n  }\n  if (isIterable(result)) {\n    return result as Iterable<Row>;\n  }\n  if (typeof result === 'object') {\n    const rows = (result as {rows?: unknown}).rows;\n    if (rows === null || rows === undefined) {\n      return [] as Row[];\n    }\n    if (Array.isArray(rows)) {\n      return rows as Row[];\n    }\n    if (isIterable(rows)) {\n      return rows as Iterable<Row>;\n    }\n  }\n  throw new TypeError('Drizzle query result is not iterable');\n}\n\n/**\n * Wrap a `drizzle-orm` database for Zero ZQL.\n *\n * Provides ZQL querying plus access to the underlying drizzle transaction.\n * Use {@link DrizzleTransaction} to type your server mutator transaction.\n *\n * @param schema - Zero schema.\n * @param client - Drizzle database.\n *\n * @example\n * ```ts\n * import {Pool} from 'pg';\n * import {drizzle} from 'drizzle-orm/node-postgres';\n * import {defineMutator, defineMutators} from '@rocicorp/zero';\n * import {zeroDrizzle} from '@rocicorp/zero/server/adapters/drizzle';\n * import {z} from 'zod/mini';\n *\n * const pool = new Pool({connectionString: process.env.ZERO_UPSTREAM_DB!});\n * const drizzleDb = drizzle(pool, {schema: drizzleSchema});\n * const zql = zeroDrizzle(schema, drizzleDb);\n *\n * export const serverMutators = defineMutators({\n *   user: {\n *     create: defineMutator(\n *       z.object({id: z.string(), name: z.string()}),\n *       async ({tx, args}) => {\n *         if (tx.location !== 'server') {\n *           throw new Error('Server-only mutator');\n *         }\n *         await tx.dbTransaction.wrappedTransaction\n *           .insert(drizzleSchema.user)\n *           .values({id: args.id, name: args.name, status: 'active'});\n *       },\n *     ),\n *   },\n * });\n * ```\n */\nexport function zeroDrizzle<\n  TSchema extends Schema,\n  TDrizzle extends DrizzleDatabase,\n>(\n  schema: TSchema,\n  client: TDrizzle,\n): ZQLDatabase<TSchema, DrizzleTransaction<TDrizzle>> {\n  return new ZQLDatabase(\n    new DrizzleConnection<TDrizzle, DrizzleTransaction<TDrizzle>>(client),\n    schema,\n  );\n}\n"],"mappings":";;;AA6CA,IAAa,oBAAb,MAIwC;CACtC;CAEA,YAAY,SAAmB;EAC7B,KAAKA,WAAW;CAClB;CAEA,YACE,IACY;EACZ,OAAO,KAAKA,SAAS,aAAY,cAC/B,GACE,IAAI,2BACF,SACF,CACF,CACF;CACF;AACF;AAEA,IAAM,6BAAN,MAEyC;CACvC;CAEA,YAAY,WAAyB;EACnC,KAAK,qBAAqB;CAC5B;CAEA,SACE,KACA,QACA,QACA,cACiC;EACjC,OAAO,qBACL,MACA,KACA,QACA,QACA,YACF;CACF;CAEA,MAAM,MAAM,KAAa,QAA2C;EAQlE,OAAO,eAAe,MAPL,KAAK,mBAAmB,EAAE,QAAQ,aACjD;GAAC;GAAK;EAAM,GACZ,KAAA,GACA,KAAA,GACA,KAEmB,EAAS,QAAQ,CACV;CAC9B;AACF;AAEA,SAAS,WAAW,OAA4C;CAC9D,OAEE,SAAS,QACT,OAAQ,MAA4B,OAAO,cAAc;AAE7D;AAEA,SAAgB,eAAe,QAAgC;CAC7D,IAAI,WAAW,QAAQ,WAAW,KAAA,GAChC,OAAO,CAAC;CAEV,IAAI,MAAM,QAAQ,MAAM,GACtB,OAAO;CAET,IAAI,WAAW,MAAM,GACnB,OAAO;CAET,IAAI,OAAO,WAAW,UAAU;EAC9B,MAAM,OAAQ,OAA4B;EAC1C,IAAI,SAAS,QAAQ,SAAS,KAAA,GAC5B,OAAO,CAAC;EAEV,IAAI,MAAM,QAAQ,IAAI,GACpB,OAAO;EAET,IAAI,WAAW,IAAI,GACjB,OAAO;CAEX;CACA,MAAM,IAAI,UAAU,sCAAsC;AAC5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,SAAgB,YAId,QACA,QACoD;CACpD,OAAO,IAAI,YACT,IAAI,kBAA0D,MAAM,GACpE,MACF;AACF"}