@fragno-dev/core 0.0.1

package/dist/client/client.svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.svelte.js","names":["pathParams: Record<string, string | ReadableAtom<string>>","queryParams: Record<string, string | ReadableAtom<string>>"],"sources":["../../src/client/client.svelte.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { atom, type ReadableAtom } from \"nanostores\";\nimport type { NonGetHTTPMethod } from \"../api/api\";\nimport {\n  isGetHook,\n  isMutatorHook,\n  isStore,\n  type FragnoClientHookData,\n  type FragnoClientMutatorData,\n  type FragnoStoreData,\n} from \"./client\";\nimport type { FragnoClientError } from \"./client-error\";\nimport type { InferOr } from \"../util/types-util\";\nimport type { MaybeExtractPathParamsOrWiden, QueryParamsHint } from \"../api/internal/path\";\n\nimport { writable, type Readable, get } from \"svelte/store\";\nimport { onDestroy } from \"svelte\";\n\nexport type FragnoSvelteHook<\n  _TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = (args?: {\n  path?:\n    | MaybeExtractPathParamsOrWiden<TPath, string | Readable<string> | ReadableAtom<string>>\n    | (() => string);\n  query?: QueryParamsHint<\n    TQueryParameters,\n    string | Readable<string> | ReadableAtom<string> | (() => string)\n  >;\n}) => {\n  data: Readable<InferOr<TOutputSchema, undefined>>;\n  loading: Readable<boolean>;\n  error: Readable<FragnoClientError<TErrorCode[number]> | undefined>;\n};\n\nexport type FragnoSvelteMutator<\n  _TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = () => {\n  mutate: (args: {\n    body?: InferOr<TInputSchema, undefined>;\n    path?: MaybeExtractPathParamsOrWiden<\n      TPath,\n      string | Readable<string> | ReadableAtom<string> | (() => string)\n    >;\n    query?: QueryParamsHint<\n      TQueryParameters,\n      string | Readable<string> | ReadableAtom<string> | (() => string)\n    >;\n  }) => Promise<InferOr<TOutputSchema, undefined>>;\n  loading: Readable<boolean | undefined>;\n  error: Readable<FragnoClientError<TErrorCode[number]> | undefined>;\n  data: Readable<InferOr<TOutputSchema, undefined>>;\n};\n\nfunction isReadable(value: unknown): value is Readable<string> {\n  return typeof value === \"object\" && value !== null && \"subscribe\" in value;\n}\n\nfunction isCallable(value: unknown): value is () => string {\n  return typeof value === \"function\";\n}\n\nexport function readableToAtom<T>(value: Readable<T>): ReadableAtom<T> {\n  const a = atom(get(value));\n\n  value.subscribe((newVal) => {\n    a.set(newVal);\n  });\n\n  return a;\n}\n\nexport function runeToAtom<T>(value: () => T): ReadableAtom<T> {\n  const a = atom(value());\n\n  $effect(() => {\n    a.set(value());\n  });\n\n  return a;\n}\n\nfunction createSvelteHook<\n  TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientHookData<TMethod, TPath, TOutputSchema, TErrorCode, TQueryParameters>,\n): FragnoSvelteHook<TMethod, TPath, TOutputSchema, TErrorCode, TQueryParameters> {\n  return ({ path, query } = {}) => {\n    const pathParams: Record<string, string | ReadableAtom<string>> = {};\n    const queryParams: Record<string, string | ReadableAtom<string>> = {};\n\n    for (const [key, value] of Object.entries(path ?? {})) {\n      const v = value as string | Readable<string> | ReadableAtom<string> | (() => string);\n      if (isCallable(v)) {\n        pathParams[key] = runeToAtom(v);\n      } else {\n        pathParams[key] = isReadable(v) ? readableToAtom(v) : v;\n      }\n    }\n\n    for (const [key, value] of Object.entries(query ?? {})) {\n      const v = value as string | Readable<string> | ReadableAtom<string> | (() => string);\n      if (isCallable(v)) {\n        queryParams[key] = runeToAtom(v);\n      } else {\n        queryParams[key] = isReadable(v) ? readableToAtom(v) : v;\n      }\n    }\n\n    const store = hook.store({\n      path: pathParams as MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>,\n      query: queryParams,\n    });\n\n    const data = writable<InferOr<TOutputSchema, undefined>>(undefined);\n    const loading = writable<boolean>(false);\n    const error = writable<FragnoClientError<TErrorCode[number]> | undefined>(undefined);\n\n    const unsubscribe = store.subscribe((updatedStoreValue) => {\n      data.set(updatedStoreValue.data as InferOr<TOutputSchema, undefined>);\n      loading.set(updatedStoreValue.loading);\n      error.set(updatedStoreValue.error);\n    });\n\n    onDestroy(() => {\n      unsubscribe();\n    });\n\n    return {\n      data,\n      loading,\n      error,\n    };\n  };\n}\n\nfunction createSvelteMutator<\n  TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientMutatorData<\n    TMethod,\n    TPath,\n    TInputSchema,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  >,\n): FragnoSvelteMutator<TMethod, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters> {\n  return () => {\n    const data = writable<InferOr<TOutputSchema, undefined>>(undefined);\n    const loading = writable<boolean | undefined>(undefined);\n    const error = writable<FragnoClientError<TErrorCode[number]> | undefined>(undefined);\n\n    // Subscribe to the mutator store and sync with our Svelte stores\n    const unsubscribe = hook.mutatorStore.subscribe((storeValue) => {\n      data.set(storeValue.data as InferOr<TOutputSchema, undefined>);\n      loading.set(storeValue.loading);\n      error.set(storeValue.error);\n    });\n\n    onDestroy(() => {\n      unsubscribe();\n    });\n\n    // Create a wrapped mutate function that handles Svelte readable stores\n    const mutate = async (args: {\n      body?: InferOr<TInputSchema, undefined>;\n      path?: MaybeExtractPathParamsOrWiden<\n        TPath,\n        string | Readable<string> | ReadableAtom<string> | (() => string)\n      >;\n      query?: QueryParamsHint<\n        TQueryParameters,\n        string | Readable<string> | ReadableAtom<string> | (() => string)\n      >;\n    }) => {\n      const { body, path, query } = args;\n\n      const pathParams: Record<string, string | ReadableAtom<string>> = {};\n      const queryParams: Record<string, string | ReadableAtom<string>> = {};\n\n      for (const [key, value] of Object.entries(path ?? {})) {\n        const v = value as string | Readable<string> | ReadableAtom<string>;\n        pathParams[key] = isReadable(v) ? readableToAtom(v) : v;\n      }\n\n      for (const [key, value] of Object.entries(query ?? {})) {\n        const v = value as string | Readable<string> | ReadableAtom<string>;\n        queryParams[key] = isReadable(v) ? readableToAtom(v) : v;\n      }\n\n      // Call the store's mutate function with normalized params\n      return hook.mutatorStore.mutate({\n        body,\n        path: pathParams as MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>,\n        query: queryParams,\n      });\n    };\n\n    return {\n      mutate,\n      loading,\n      error,\n      data,\n    };\n  };\n}\n\nexport function createSvelteStore<T extends object>(hook: FragnoStoreData<T>): T {\n  // Since nanostores already implement Svelte's store contract,\n  // we can return the store object directly for use with $ syntax\n  return hook.obj;\n}\n\nexport function useFragno<T extends Record<string, unknown>>(\n  clientObj: T,\n): {\n  [K in keyof T]: T[K] extends FragnoClientHookData<\n    \"GET\",\n    infer TPath,\n    infer TOutputSchema,\n    infer TErrorCode,\n    infer TQueryParameters\n  >\n    ? FragnoSvelteHook<\"GET\", TPath, TOutputSchema, TErrorCode, TQueryParameters>\n    : T[K] extends FragnoClientMutatorData<\n          infer M,\n          infer TPath,\n          infer TInputSchema,\n          infer TOutputSchema,\n          infer TErrorCode,\n          infer TQueryParameters\n        >\n      ? FragnoSvelteMutator<M, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters>\n      : T[K] extends FragnoStoreData<infer TStoreObj>\n        ? TStoreObj\n        : T[K];\n} {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const result = {} as any;\n\n  for (const key in clientObj) {\n    if (!Object.prototype.hasOwnProperty.call(clientObj, key)) {\n      continue;\n    }\n\n    const hook = clientObj[key];\n    if (isGetHook(hook)) {\n      result[key] = createSvelteHook(hook);\n    } else if (isMutatorHook(hook)) {\n      result[key] = createSvelteMutator(hook);\n    } else if (isStore(hook)) {\n      result[key] = createSvelteStore(hook);\n    } else {\n      // Pass through non-hook values unchanged\n      result[key] = hook;\n    }\n  }\n\n  return result;\n}\n"],"mappings":"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"}

package/dist/client/react.d.ts

@@ -0,0 +1,58 @@
+import { ExtractPathParamsOrWiden, HasPathParams, InferOr, MaybeExtractPathParamsOrWiden, NonGetHTTPMethod, QueryParamsHint } from "../api-CBDGZiLC.js";
+import { FragnoClientError, FragnoClientHookData, FragnoClientMutatorData, FragnoStoreData } from "../client-XFdAy-IQ.js";
+import { ReadableAtom, Store, StoreValue } from "nanostores";
+import { FetcherValue } from "@nanostores/query";
+import * as react0 from "react";
+import { DependencyList } from "react";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/client/react.d.ts
+
+type FragnoReactHook<_TMethod extends "GET", TPath extends string, TOutputSchema extends StandardSchemaV1, TErrorCode extends string, TQueryParameters extends string> = (args?: {
+  path?: MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>;
+  query?: QueryParamsHint<TQueryParameters, string | ReadableAtom<string>>;
+}) => FetcherValue<StandardSchemaV1.InferOutput<TOutputSchema>, FragnoClientError<NonNullable<TErrorCode>>>;
+type FragnoReactMutator<_TMethod extends NonGetHTTPMethod, TPath extends string, TInputSchema extends StandardSchemaV1 | undefined, TOutputSchema extends StandardSchemaV1 | undefined, TErrorCode extends string, TQueryParameters extends string> = () => {
+  mutate: ({
+    body,
+    path,
+    query
+  }: {
+    body?: InferOr<TInputSchema, undefined>;
+    path?: HasPathParams<TPath> extends true ? ExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>> : undefined;
+    query?: QueryParamsHint<TQueryParameters, string | ReadableAtom<string>>;
+  }) => Promise<InferOr<TOutputSchema, undefined>>;
+  loading?: boolean | undefined;
+  error?: FragnoClientError<NonNullable<TErrorCode>[number]> | undefined;
+  data?: InferOr<TOutputSchema, undefined> | undefined;
+};
+/**
+ * Type helper that unwraps any Store fields of the object into StoreValues
+ */
+type FragnoReactStore<T extends object> = () => T extends Store<infer TStore> ? StoreValue<TStore> : { [K in keyof T]: T[K] extends Store ? StoreValue<T[K]> : T[K] };
+declare function useFragno<T extends Record<string, unknown>>(clientObj: T): { [K in keyof T]: T[K] extends FragnoClientHookData<"GET", infer TPath, infer TOutputSchema, infer TErrorCode, infer TQueryParameters> ? FragnoReactHook<"GET", TPath, TOutputSchema, TErrorCode, TQueryParameters> : T[K] extends FragnoClientMutatorData<infer TMethod, infer TPath, infer TInput, infer TOutput, infer TError, infer TQueryParameters> ? FragnoReactMutator<TMethod, TPath, TInput, TOutput, TError, TQueryParameters> : T[K] extends FragnoStoreData<infer TStoreObj> ? FragnoReactStore<TStoreObj> : T[K] };
+type StoreKeys<T> = T extends {
+  setKey: (k: infer K, v: unknown) => unknown;
+} ? K : never;
+interface UseStoreOptions<SomeStore> {
+  /**
+   * @default
+   * ```ts
+   * [store, options.keys]
+   * ```
+   */
+  deps?: DependencyList;
+  /**
+   * Will re-render components only on specific key changes.
+   */
+  keys?: StoreKeys<SomeStore>[];
+}
+declare function useStore<SomeStore extends Store>(store: SomeStore, options?: UseStoreOptions<SomeStore>): StoreValue<SomeStore>;
+declare function FragnoHydrator({
+  children
+}: {
+  children: React.ReactNode;
+}): react0.ReactNode;
+//#endregion
+export { FragnoHydrator, FragnoReactHook, FragnoReactMutator, FragnoReactStore, UseStoreOptions, useFragno, useStore };
+//# sourceMappingURL=react.d.ts.map

package/dist/client/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","names":[],"sources":["../../src/client/react.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/client/react.js

@@ -0,0 +1,80 @@
+import "../api-DgHfYjq2.js";
+import "../route-Bp6eByhz.js";
+import { isGetHook, isMutatorHook, isReadableAtom, isStore } from "../client-DWjxKDnE.js";
+import { hydrateFromWindow } from "../ssr-tJHqcNSw.js";
+import { listenKeys } from "nanostores";
+import { useCallback, useMemo, useRef, useSyncExternalStore } from "react";
+
+//#region src/client/react.ts
+function createReactHook(hook) {
+	return ({ path, query } = {}) => {
+		const pathParamValues = path ? Object.values(path) : [];
+		const queryParamValues = query ? Object.values(query) : [];
+		const deps = [...pathParamValues, ...queryParamValues];
+		const store = useMemo(() => hook.store({
+			path,
+			query
+		}), [hook, ...deps]);
+		if (typeof window === "undefined") return store.get();
+		return useStore(store);
+	};
+}
+function createReactMutator(hook) {
+	return () => {
+		const store = useMemo(() => hook.mutatorStore, [hook]);
+		return useStore(store);
+	};
+}
+function createReactStore(hook) {
+	if (isReadableAtom(hook.obj)) return () => useStore(hook.obj);
+	return () => {
+		const result = {};
+		for (const key in hook.obj) {
+			if (!Object.prototype.hasOwnProperty.call(hook.obj, key)) continue;
+			const value = hook.obj[key];
+			if (isReadableAtom(value)) result[key] = useStore(value);
+			else result[key] = value;
+		}
+		return result;
+	};
+}
+function useFragno(clientObj) {
+	const result = {};
+	for (const key in clientObj) {
+		if (!Object.prototype.hasOwnProperty.call(clientObj, key)) continue;
+		const hook = clientObj[key];
+		if (isGetHook(hook)) result[key] = createReactHook(hook);
+		else if (isMutatorHook(hook)) result[key] = createReactMutator(hook);
+		else if (isStore(hook)) result[key] = createReactStore(hook);
+		else result[key] = hook;
+	}
+	return result;
+}
+function useStore(store, options = {}) {
+	const snapshotRef = useRef(store.get());
+	const { keys, deps = [store, keys] } = options;
+	const subscribe = useCallback((onChange) => {
+		const emitChange = (value) => {
+			if (snapshotRef.current === value) return;
+			snapshotRef.current = value;
+			onChange();
+		};
+		emitChange(store.value);
+		if (keys?.length) return listenKeys(store, keys, emitChange);
+		return store.listen(emitChange);
+	}, deps);
+	const get = () => snapshotRef.current;
+	return useSyncExternalStore(subscribe, get, () => {
+		return get();
+	});
+}
+function FragnoHydrator({ children }) {
+	useMemo(() => {
+		hydrateFromWindow();
+	}, []);
+	return children;
+}
+
+//#endregion
+export { FragnoHydrator, useFragno, useStore };
+//# sourceMappingURL=react.js.map

package/dist/client/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","names":["result: any"],"sources":["../../src/client/react.ts"],"sourcesContent":["import type { FetcherValue } from \"@nanostores/query\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { listenKeys, type ReadableAtom, type Store, type StoreValue } from \"nanostores\";\nimport { useCallback, useMemo, useRef, useSyncExternalStore, type DependencyList } from \"react\";\nimport type { NonGetHTTPMethod } from \"../api/api\";\nimport type { FragnoClientMutatorData, FragnoClientHookData } from \"./client\";\nimport { isGetHook, isMutatorHook, isStore, type FragnoStoreData } from \"./client\";\nimport type { FragnoClientError } from \"./client-error\";\nimport { hydrateFromWindow } from \"../util/ssr\";\nimport type { InferOr } from \"../util/types-util\";\nimport type {\n  ExtractPathParamsOrWiden,\n  HasPathParams,\n  MaybeExtractPathParamsOrWiden,\n  QueryParamsHint,\n} from \"../api/internal/path\";\nimport { isReadableAtom } from \"../util/nanostores\";\n\nexport type FragnoReactHook<\n  _TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = (args?: {\n  path?: MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>;\n  query?: QueryParamsHint<TQueryParameters, string | ReadableAtom<string>>;\n}) => FetcherValue<\n  StandardSchemaV1.InferOutput<TOutputSchema>,\n  FragnoClientError<NonNullable<TErrorCode>>\n>;\n\nexport type FragnoReactMutator<\n  _TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = () => {\n  mutate: ({\n    body,\n    path,\n    query,\n  }: {\n    body?: InferOr<TInputSchema, undefined>;\n    path?: HasPathParams<TPath> extends true\n      ? ExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>\n      : undefined;\n    query?: QueryParamsHint<TQueryParameters, string | ReadableAtom<string>>;\n  }) => Promise<InferOr<TOutputSchema, undefined>>;\n  loading?: boolean | undefined;\n  error?: FragnoClientError<NonNullable<TErrorCode>[number]> | undefined;\n  data?: InferOr<TOutputSchema, undefined> | undefined;\n};\n\n// Helper function to create a React hook from a GET hook\nfunction createReactHook<\n  TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientHookData<TMethod, TPath, TOutputSchema, TErrorCode, TQueryParameters>,\n): FragnoReactHook<TMethod, TPath, TOutputSchema, TErrorCode, TQueryParameters> {\n  return ({ path, query } = {}) => {\n    const pathParamValues = path ? Object.values(path) : [];\n    const queryParamValues = query ? Object.values(query) : [];\n\n    const deps = [...pathParamValues, ...queryParamValues];\n\n    const store = useMemo(() => hook.store({ path, query }), [hook, ...deps]);\n\n    if (typeof window === \"undefined\") {\n      // TODO(Wilco): Handle server-side rendering. In React we have to implement onShellReady\n      // and onAllReady in renderToPipable stream.\n      const serverSideData = store.get();\n      return serverSideData;\n    }\n\n    return useStore(store);\n  };\n}\n\n// Helper function to create a React mutator from a mutator hook\nfunction createReactMutator<\n  TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInput extends StandardSchemaV1 | undefined,\n  TOutput extends StandardSchemaV1 | undefined,\n  TError extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientMutatorData<TMethod, TPath, TInput, TOutput, TError, TQueryParameters>,\n): FragnoReactMutator<TMethod, TPath, TInput, TOutput, TError, TQueryParameters> {\n  return () => {\n    const store = useMemo(() => hook.mutatorStore, [hook]);\n    return useStore(store);\n  };\n}\n\n/**\n * Type helper that unwraps any Store fields of the object into StoreValues\n */\nexport type FragnoReactStore<T extends object> = () => T extends Store<infer TStore>\n  ? StoreValue<TStore>\n  : {\n      [K in keyof T]: T[K] extends Store ? StoreValue<T[K]> : T[K];\n    };\n\nfunction createReactStore<const T extends object>(hook: FragnoStoreData<T>): FragnoReactStore<T> {\n  if (isReadableAtom(hook.obj)) {\n    return () => useStore(hook.obj as Store);\n  }\n\n  return () => {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const result: any = {};\n\n    for (const key in hook.obj) {\n      if (!Object.prototype.hasOwnProperty.call(hook.obj, key)) {\n        continue;\n      }\n\n      const value = hook.obj[key];\n      if (isReadableAtom(value)) {\n        result[key] = useStore(value);\n      } else {\n        result[key] = value;\n      }\n    }\n\n    return result;\n  };\n}\n\nexport function useFragno<T extends Record<string, unknown>>(\n  clientObj: T,\n): {\n  [K in keyof T]: T[K] extends FragnoClientHookData<\n    \"GET\",\n    infer TPath,\n    infer TOutputSchema,\n    infer TErrorCode,\n    infer TQueryParameters\n  >\n    ? FragnoReactHook<\"GET\", TPath, TOutputSchema, TErrorCode, TQueryParameters>\n    : T[K] extends FragnoClientMutatorData<\n          infer TMethod,\n          infer TPath,\n          infer TInput,\n          infer TOutput,\n          infer TError,\n          infer TQueryParameters\n        >\n      ? FragnoReactMutator<TMethod, TPath, TInput, TOutput, TError, TQueryParameters>\n      : T[K] extends FragnoStoreData<infer TStoreObj>\n        ? FragnoReactStore<TStoreObj>\n        : T[K];\n} {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const result = {} as any; // We need one any cast here due to TypeScript's limitations with mapped types\n\n  for (const key in clientObj) {\n    if (!Object.prototype.hasOwnProperty.call(clientObj, key)) {\n      continue;\n    }\n\n    const hook = clientObj[key];\n    if (isGetHook(hook)) {\n      result[key] = createReactHook(hook);\n    } else if (isMutatorHook(hook)) {\n      result[key] = createReactMutator(hook);\n    } else if (isStore(hook)) {\n      result[key] = createReactStore(hook);\n    } else {\n      // Pass through non-hook values unchanged\n      result[key] = hook;\n    }\n  }\n\n  return result;\n}\n\ntype StoreKeys<T> = T extends { setKey: (k: infer K, v: unknown) => unknown } ? K : never;\n\nexport interface UseStoreOptions<SomeStore> {\n  /**\n   * @default\n   * ```ts\n   * [store, options.keys]\n   * ```\n   */\n  deps?: DependencyList;\n\n  /**\n   * Will re-render components only on specific key changes.\n   */\n  keys?: StoreKeys<SomeStore>[];\n}\n\nexport function useStore<SomeStore extends Store>(\n  store: SomeStore,\n  options: UseStoreOptions<SomeStore> = {},\n): StoreValue<SomeStore> {\n  const snapshotRef = useRef<StoreValue<SomeStore>>(store.get());\n\n  const { keys, deps = [store, keys] } = options;\n\n  const subscribe = useCallback((onChange: () => void) => {\n    const emitChange = (value: StoreValue<SomeStore>) => {\n      if (snapshotRef.current === value) return;\n      snapshotRef.current = value;\n      onChange();\n    };\n\n    emitChange(store.value);\n    if (keys?.length) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      return listenKeys(store as any, keys, emitChange);\n    }\n    return store.listen(emitChange);\n  }, deps);\n\n  const get = () => snapshotRef.current as StoreValue<SomeStore>;\n\n  return useSyncExternalStore(subscribe, get, () => {\n    // Server-side rendering\n    return get();\n  });\n}\n\nexport function FragnoHydrator({ children }: { children: React.ReactNode }) {\n  // Ensure initial data is transferred from window before any hooks run\n  // Running in useMemo makes this happen during render, ahead of effects\n  useMemo(() => {\n    hydrateFromWindow();\n  }, []);\n  return children;\n}\n"],"mappings":";;;;;;;;AAyDA,SAAS,gBAOP,MAC8E;AAC9E,SAAQ,EAAE,MAAM,UAAU,EAAE,KAAK;EAC/B,MAAM,kBAAkB,OAAO,OAAO,OAAO,KAAK,GAAG,EAAE;EACvD,MAAM,mBAAmB,QAAQ,OAAO,OAAO,MAAM,GAAG,EAAE;EAE1D,MAAM,OAAO,CAAC,GAAG,iBAAiB,GAAG,iBAAiB;EAEtD,MAAM,QAAQ,cAAc,KAAK,MAAM;GAAE;GAAM;GAAO,CAAC,EAAE,CAAC,MAAM,GAAG,KAAK,CAAC;AAEzE,MAAI,OAAO,WAAW,YAIpB,QADuB,MAAM,KAAK;AAIpC,SAAO,SAAS,MAAM;;;AAK1B,SAAS,mBAQP,MAC+E;AAC/E,cAAa;EACX,MAAM,QAAQ,cAAc,KAAK,cAAc,CAAC,KAAK,CAAC;AACtD,SAAO,SAAS,MAAM;;;AAa1B,SAAS,iBAAyC,MAA+C;AAC/F,KAAI,eAAe,KAAK,IAAI,CAC1B,cAAa,SAAS,KAAK,IAAa;AAG1C,cAAa;EAEX,MAAMA,SAAc,EAAE;AAEtB,OAAK,MAAM,OAAO,KAAK,KAAK;AAC1B,OAAI,CAAC,OAAO,UAAU,eAAe,KAAK,KAAK,KAAK,IAAI,CACtD;GAGF,MAAM,QAAQ,KAAK,IAAI;AACvB,OAAI,eAAe,MAAM,CACvB,QAAO,OAAO,SAAS,MAAM;OAE7B,QAAO,OAAO;;AAIlB,SAAO;;;AAIX,SAAgB,UACd,WAsBA;CAEA,MAAM,SAAS,EAAE;AAEjB,MAAK,MAAM,OAAO,WAAW;AAC3B,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,WAAW,IAAI,CACvD;EAGF,MAAM,OAAO,UAAU;AACvB,MAAI,UAAU,KAAK,CACjB,QAAO,OAAO,gBAAgB,KAAK;WAC1B,cAAc,KAAK,CAC5B,QAAO,OAAO,mBAAmB,KAAK;WAC7B,QAAQ,KAAK,CACtB,QAAO,OAAO,iBAAiB,KAAK;MAGpC,QAAO,OAAO;;AAIlB,QAAO;;AAoBT,SAAgB,SACd,OACA,UAAsC,EAAE,EACjB;CACvB,MAAM,cAAc,OAA8B,MAAM,KAAK,CAAC;CAE9D,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,KAAK,KAAK;CAEvC,MAAM,YAAY,aAAa,aAAyB;EACtD,MAAM,cAAc,UAAiC;AACnD,OAAI,YAAY,YAAY,MAAO;AACnC,eAAY,UAAU;AACtB,aAAU;;AAGZ,aAAW,MAAM,MAAM;AACvB,MAAI,MAAM,OAER,QAAO,WAAW,OAAc,MAAM,WAAW;AAEnD,SAAO,MAAM,OAAO,WAAW;IAC9B,KAAK;CAER,MAAM,YAAY,YAAY;AAE9B,QAAO,qBAAqB,WAAW,WAAW;AAEhD,SAAO,KAAK;GACZ;;AAGJ,SAAgB,eAAe,EAAE,YAA2C;AAG1E,eAAc;AACZ,qBAAmB;IAClB,EAAE,CAAC;AACN,QAAO"}

package/dist/client/vanilla.d.ts

@@ -0,0 +1,61 @@
+import { ExtractPathParamsOrWiden, HasPathParams, InferOr, MaybeExtractPathParamsOrWiden, NonGetHTTPMethod } from "../api-CBDGZiLC.js";
+import { FragnoClientError, FragnoClientHookData, FragnoClientMutatorData } from "../client-XFdAy-IQ.js";
+import { ReadableAtom } from "nanostores";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/client/vanilla.d.ts
+
+type StoreData<TOutputSchema extends StandardSchemaV1 | undefined, TErrorCodes extends string> = {
+  loading: boolean;
+  error?: FragnoClientError<TErrorCodes>;
+  data?: InferOr<TOutputSchema, undefined>;
+};
+type FragnoVanillaListeners<_TMethod extends "GET", TPath extends string, TOutputSchema extends StandardSchemaV1, TErrorCode extends string, TQueryParameters extends string> = (args?: {
+  path?: MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>;
+  query?: Record<TQueryParameters, string | ReadableAtom<string>>;
+}) => {
+  /** Called for every change in the store. */
+  listen: (callback: (value: StoreData<TOutputSchema, TErrorCode[number]>) => void) => () => void;
+  /** Called once initially, then called for every change in the store. */
+  subscribe: (callback: (value: StoreData<TOutputSchema, TErrorCode[number]>) => void) => () => void;
+  get: () => StoreData<TOutputSchema, TErrorCode[number]>;
+  refetch: () => void;
+  /**
+   * Produces an item for every change in the store.
+   * Note: the iterator does NOT return.
+   *
+   * @example
+   * ```typescript
+   * const store = useFragno(clientObj).store;
+   * for await (const value of store[Symbol.asyncIterator]()) {
+   *   console.log(value);
+   * }
+   * ```
+   */
+  [Symbol.asyncIterator]: () => AsyncGenerator<StoreData<TOutputSchema, TErrorCode[number]>, void, unknown>;
+};
+type FragnoVanillaMutator<_TMethod extends NonGetHTTPMethod, TPath extends string, TInputSchema extends StandardSchemaV1 | undefined, TOutputSchema extends StandardSchemaV1 | undefined, TErrorCode extends string, TQueryParameters extends string> = (args?: {
+  path?: MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>;
+  query?: Record<TQueryParameters, string | ReadableAtom<string>>;
+}) => {
+  subscribe: (callback: (value: {
+    loading: boolean;
+    error?: FragnoClientError<TErrorCode[number]>;
+    data?: InferOr<TOutputSchema, undefined>;
+  }) => void) => () => void;
+  get: () => StoreData<TOutputSchema, TErrorCode[number]>;
+  mutate: ({
+    body,
+    path,
+    query
+  }: {
+    body?: InferOr<TInputSchema, undefined>;
+    path?: HasPathParams<TPath> extends true ? ExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>> : undefined;
+    query?: Record<string, string | ReadableAtom<string>>;
+  }) => Promise<InferOr<TOutputSchema, undefined>>;
+  [Symbol.asyncIterator]: () => AsyncGenerator<StoreData<TOutputSchema, TErrorCode[number]>, void, unknown>;
+};
+declare function useFragno<T extends Record<string, unknown>>(clientObj: T): { [K in keyof T]: T[K] extends FragnoClientHookData<"GET", infer TPath, infer TOutputSchema, infer TErrorCode, infer TQueryParameters> ? FragnoVanillaListeners<"GET", TPath, TOutputSchema, TErrorCode, TQueryParameters> : T[K] extends FragnoClientMutatorData<NonGetHTTPMethod, infer TPath, infer TInputSchema, infer TOutputSchema, infer TErrorCode, infer TQueryParameters> ? FragnoVanillaMutator<NonGetHTTPMethod, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters> : T[K] };
+//#endregion
+export { FragnoVanillaListeners, FragnoVanillaMutator, StoreData, useFragno };
+//# sourceMappingURL=vanilla.d.ts.map

package/dist/client/vanilla.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vanilla.d.ts","names":[],"sources":["../../src/client/vanilla.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/client/vanilla.js

@@ -0,0 +1,136 @@
+import "../api-DgHfYjq2.js";
+import "../route-Bp6eByhz.js";
+import { isGetHook, isMutatorHook } from "../client-DWjxKDnE.js";
+import "../ssr-tJHqcNSw.js";
+
+//#region src/util/async.ts
+/**
+* Creates an async iterator from a subscribe function that follows the observable pattern.
+*
+* @template T The type of values produced by the store.
+* @param subscribe A function that subscribes to store updates. It receives a callback to be
+*          called on each update, and returns an unsubscribe function.
+* @returns An async generator that yields store values as they are produced.
+*/
+function createAsyncIteratorFromCallback(subscribe) {
+	const queue = [];
+	let unsubscribe = null;
+	let resolveNext = null;
+	const unsubscribeFunc = subscribe((value) => {
+		if (resolveNext) {
+			resolveNext({
+				value,
+				done: false
+			});
+			resolveNext = null;
+		} else queue.push(value);
+	});
+	if (typeof unsubscribeFunc === "function") unsubscribe = unsubscribeFunc;
+	return (async function* () {
+		try {
+			while (true) if (queue.length > 0) yield queue.shift();
+			else yield await new Promise((resolve) => {
+				resolveNext = (result) => {
+					if (!result.done) resolve(result.value);
+				};
+			});
+		} finally {
+			if (unsubscribe) unsubscribe();
+		}
+	})();
+}
+
+//#endregion
+//#region src/client/vanilla.ts
+function createVanillaListeners(hook) {
+	return ({ path, query } = {}) => {
+		const store = hook.store({
+			path,
+			query
+		});
+		return {
+			listen: (callback) => {
+				return store.listen(({ loading, error, data }) => callback({
+					loading,
+					error,
+					data
+				}));
+			},
+			subscribe: (callback) => {
+				return store.subscribe(({ loading, error, data }) => callback({
+					loading,
+					error,
+					data
+				}));
+			},
+			refetch: () => {
+				return store.revalidate();
+			},
+			get: () => {
+				return store.get();
+			},
+			[Symbol.asyncIterator]() {
+				return createAsyncIteratorFromCallback((callback) => store.listen(({ loading, error, data }) => callback({
+					loading,
+					error,
+					data
+				})));
+			}
+		};
+	};
+}
+function createVanillaMutator(hook) {
+	return () => {
+		const store = hook.mutatorStore;
+		return {
+			subscribe: (callback) => {
+				return store.subscribe((value) => {
+					callback({
+						loading: value.loading ?? false,
+						error: value.error,
+						data: value.data
+					});
+				});
+			},
+			get: () => {
+				const { loading, error, data } = store.get();
+				return {
+					loading: loading ?? false,
+					error,
+					data
+				};
+			},
+			mutate: ({ body, path, query }) => {
+				return store.mutate({
+					body,
+					path,
+					query
+				});
+			},
+			[Symbol.asyncIterator]() {
+				return createAsyncIteratorFromCallback((callback) => store.listen((value) => {
+					callback({
+						loading: value.loading ?? false,
+						error: value.error,
+						data: value.data
+					});
+				}));
+			}
+		};
+	};
+}
+function useFragno(clientObj) {
+	const result = {};
+	for (const key in clientObj) {
+		if (!Object.prototype.hasOwnProperty.call(clientObj, key)) continue;
+		const hook = clientObj[key];
+		if (isGetHook(hook)) result[key] = createVanillaListeners(hook);
+		else if (isMutatorHook(hook)) result[key] = createVanillaMutator(hook);
+		else result[key] = hook;
+	}
+	return result;
+}
+
+//#endregion
+export { useFragno };
+//# sourceMappingURL=vanilla.js.map

package/dist/client/vanilla.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vanilla.js","names":["queue: T[]","unsubscribe: UnsubscribeFn | null","resolveNext: ((value: IteratorResult<T>) => void) | null"],"sources":["../../src/util/async.ts","../../src/client/vanilla.ts"],"sourcesContent":["type SubscribeFn<T> = (callback: (value: T) => void) => UnsubscribeFn | void;\ntype UnsubscribeFn = () => void;\n\n/**\n * Creates an async iterator from a subscribe function that follows the observable pattern.\n *\n * @template T The type of values produced by the store.\n * @param subscribe A function that subscribes to store updates. It receives a callback to be\n *          called on each update, and returns an unsubscribe function.\n * @returns An async generator that yields store values as they are produced.\n */\nexport function createAsyncIteratorFromCallback<T>(\n  subscribe: SubscribeFn<T>,\n): AsyncGenerator<T, void, unknown> {\n  const queue: T[] = [];\n  let unsubscribe: UnsubscribeFn | null = null;\n  let resolveNext: ((value: IteratorResult<T>) => void) | null = null;\n\n  const unsubscribeFunc = subscribe((value) => {\n    if (resolveNext) {\n      // If there's a pending promise, resolve it immediately\n      resolveNext({ value, done: false });\n      resolveNext = null;\n    } else {\n      // Otherwise, queue the value\n      queue.push(value);\n    }\n  });\n\n  // Store unsubscribe function if one was returned\n  if (typeof unsubscribeFunc === \"function\") {\n    unsubscribe = unsubscribeFunc;\n  }\n\n  return (async function* () {\n    try {\n      while (true) {\n        if (queue.length > 0) {\n          // Yield queued values\n          yield queue.shift()!;\n        } else {\n          // Wait for the next value\n          yield await new Promise<T>((resolve) => {\n            resolveNext = (result) => {\n              if (!result.done) {\n                resolve(result.value);\n              }\n            };\n          });\n        }\n      }\n    } finally {\n      // Clean up subscription on iterator termination\n      if (unsubscribe) {\n        unsubscribe();\n      }\n    }\n  })();\n}\n\n/**\n * Waits for an async iterator to yield a value that meets a condition.\n *\n * @template T The type of values produced by the iterator.\n * @param iterable The async iterable to wait for.\n * @param condition A function that checks if a value meets the condition.\n * @param options Optional configuration options.\n * @returns A promise that resolves to the first value that meets the condition.\n */\nexport async function waitForAsyncIterator<T>(\n  iterable: AsyncIterable<T>,\n  condition: (value: T) => boolean,\n  options: { timeout?: number } = {},\n): Promise<T> {\n  const { timeout = 1000 } = options;\n\n  // Create a timeout promise that rejects after the specified time\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    setTimeout(() => {\n      reject(new Error(`waitForAsyncIterator: Timeout after ${timeout}ms`));\n    }, timeout);\n  });\n\n  // Create a promise that resolves when the condition is met\n  const iteratorPromise = (async () => {\n    for await (const value of iterable) {\n      if (condition(value)) {\n        return value;\n      }\n    }\n    throw new Error(\"waitForAsyncIterator: Iterator completed without meeting condition\");\n  })();\n\n  // Race between the timeout and the iterator\n  return Promise.race([iteratorPromise, timeoutPromise]);\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { ReadableAtom } from \"nanostores\";\nimport type { NonGetHTTPMethod } from \"../api/api\";\nimport {\n  isGetHook,\n  isMutatorHook,\n  type FragnoClientMutatorData,\n  type FragnoClientHookData,\n} from \"./client\";\nimport type { FragnoClientError } from \"./client-error\";\nimport { createAsyncIteratorFromCallback } from \"../util/async\";\nimport type { InferOr } from \"../util/types-util\";\nimport type {\n  ExtractPathParamsOrWiden,\n  HasPathParams,\n  MaybeExtractPathParamsOrWiden,\n} from \"../api/internal/path\";\n\nexport type StoreData<\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCodes extends string,\n> = {\n  loading: boolean;\n  error?: FragnoClientError<TErrorCodes>;\n  data?: InferOr<TOutputSchema, undefined>;\n};\n\nexport type FragnoVanillaListeners<\n  _TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = (args?: {\n  path?: MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>;\n  query?: Record<TQueryParameters, string | ReadableAtom<string>>;\n}) => {\n  /** Called for every change in the store. */\n  listen: (callback: (value: StoreData<TOutputSchema, TErrorCode[number]>) => void) => () => void;\n  /** Called once initially, then called for every change in the store. */\n  subscribe: (\n    callback: (value: StoreData<TOutputSchema, TErrorCode[number]>) => void,\n  ) => () => void;\n  get: () => StoreData<TOutputSchema, TErrorCode[number]>;\n  refetch: () => void;\n  /**\n   * Produces an item for every change in the store.\n   * Note: the iterator does NOT return.\n   *\n   * @example\n   * ```typescript\n   * const store = useFragno(clientObj).store;\n   * for await (const value of store[Symbol.asyncIterator]()) {\n   *   console.log(value);\n   * }\n   * ```\n   */\n  [Symbol.asyncIterator]: () => AsyncGenerator<\n    StoreData<TOutputSchema, TErrorCode[number]>,\n    void,\n    unknown\n  >;\n};\n\nfunction createVanillaListeners<\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientHookData<\"GET\", TPath, TOutputSchema, TErrorCode, TQueryParameters>,\n): FragnoVanillaListeners<\"GET\", TPath, TOutputSchema, TErrorCode, TQueryParameters> {\n  return ({ path, query } = {}) => {\n    const store = hook.store({ path, query });\n\n    return {\n      listen: (callback) => {\n        return store.listen(({ loading, error, data }) =>\n          callback({\n            loading,\n            error,\n            data: data as InferOr<TOutputSchema, undefined>,\n          }),\n        );\n      },\n      subscribe: (callback) => {\n        return store.subscribe(({ loading, error, data }) =>\n          callback({\n            loading,\n            error,\n            data: data as InferOr<TOutputSchema, undefined>,\n          }),\n        );\n      },\n      refetch: () => {\n        return store.revalidate();\n      },\n      get: () => {\n        return store.get() as StoreData<TOutputSchema, TErrorCode[number]>;\n      },\n      [Symbol.asyncIterator]() {\n        return createAsyncIteratorFromCallback((callback) =>\n          store.listen(({ loading, error, data }) =>\n            callback({\n              loading,\n              error,\n              data: data as InferOr<TOutputSchema, undefined>,\n            }),\n          ),\n        );\n      },\n    };\n  };\n}\n\nexport type FragnoVanillaMutator<\n  _TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = (args?: {\n  path?: MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>;\n  query?: Record<TQueryParameters, string | ReadableAtom<string>>;\n}) => {\n  subscribe: (\n    callback: (value: {\n      loading: boolean;\n      error?: FragnoClientError<TErrorCode[number]>;\n      data?: InferOr<TOutputSchema, undefined>;\n    }) => void,\n  ) => () => void;\n  get: () => StoreData<TOutputSchema, TErrorCode[number]>;\n  mutate: ({\n    body,\n    path,\n    query,\n  }: {\n    body?: InferOr<TInputSchema, undefined>;\n    path?: HasPathParams<TPath> extends true\n      ? ExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>\n      : undefined;\n    query?: Record<string, string | ReadableAtom<string>>;\n  }) => Promise<InferOr<TOutputSchema, undefined>>;\n  [Symbol.asyncIterator]: () => AsyncGenerator<\n    StoreData<TOutputSchema, TErrorCode[number]>,\n    void,\n    unknown\n  >;\n};\n\nfunction createVanillaMutator<\n  _TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientMutatorData<\n    _TMethod,\n    TPath,\n    TInputSchema,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  >,\n): FragnoVanillaMutator<\n  _TMethod,\n  TPath,\n  TInputSchema,\n  TOutputSchema,\n  TErrorCode,\n  TQueryParameters\n> {\n  return () => {\n    // TODO(Wilco): it should be possible for `loading` to be undefined, before a mutation has taken place.\n    const store = hook.mutatorStore;\n    return {\n      subscribe: (callback) => {\n        return store.subscribe((value) => {\n          callback({\n            loading: value.loading ?? false,\n            error: value.error,\n            data: value.data,\n          });\n        });\n      },\n      get: () => {\n        const { loading, error, data } = store.get();\n        return {\n          loading: loading ?? false,\n          error,\n          data: data,\n        };\n      },\n      mutate: ({ body, path, query }) => {\n        return store.mutate({ body, path, query });\n      },\n      [Symbol.asyncIterator]() {\n        return createAsyncIteratorFromCallback((callback) =>\n          store.listen((value) => {\n            callback({\n              loading: value.loading ?? false,\n              error: value.error,\n              data: value.data,\n            });\n          }),\n        );\n      },\n    };\n  };\n}\n\nexport function useFragno<T extends Record<string, unknown>>(\n  clientObj: T,\n): {\n  [K in keyof T]: T[K] extends FragnoClientHookData<\n    \"GET\",\n    infer TPath,\n    infer TOutputSchema,\n    infer TErrorCode,\n    infer TQueryParameters\n  >\n    ? FragnoVanillaListeners<\"GET\", TPath, TOutputSchema, TErrorCode, TQueryParameters>\n    : T[K] extends FragnoClientMutatorData<\n          NonGetHTTPMethod,\n          infer TPath,\n          infer TInputSchema,\n          infer TOutputSchema,\n          infer TErrorCode,\n          infer TQueryParameters\n        >\n      ? FragnoVanillaMutator<\n          NonGetHTTPMethod,\n          TPath,\n          TInputSchema,\n          TOutputSchema,\n          TErrorCode,\n          TQueryParameters\n        >\n      : T[K];\n} {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const result = {} as any; // We need one any cast here due to TypeScript's limitations with mapped types\n\n  for (const key in clientObj) {\n    if (!Object.prototype.hasOwnProperty.call(clientObj, key)) {\n      continue;\n    }\n\n    const hook = clientObj[key];\n    if (isGetHook(hook)) {\n      result[key] = createVanillaListeners(hook);\n    } else if (isMutatorHook(hook)) {\n      result[key] = createVanillaMutator(hook);\n    } else {\n      // Pass through non-hook values unchanged\n      result[key] = hook;\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;AAWA,SAAgB,gCACd,WACkC;CAClC,MAAMA,QAAa,EAAE;CACrB,IAAIC,cAAoC;CACxC,IAAIC,cAA2D;CAE/D,MAAM,kBAAkB,WAAW,UAAU;AAC3C,MAAI,aAAa;AAEf,eAAY;IAAE;IAAO,MAAM;IAAO,CAAC;AACnC,iBAAc;QAGd,OAAM,KAAK,MAAM;GAEnB;AAGF,KAAI,OAAO,oBAAoB,WAC7B,eAAc;AAGhB,SAAQ,mBAAmB;AACzB,MAAI;AACF,UAAO,KACL,KAAI,MAAM,SAAS,EAEjB,OAAM,MAAM,OAAO;OAGnB,OAAM,MAAM,IAAI,SAAY,YAAY;AACtC,mBAAe,WAAW;AACxB,SAAI,CAAC,OAAO,KACV,SAAQ,OAAO,MAAM;;KAGzB;YAGE;AAER,OAAI,YACF,cAAa;;KAGf;;;;;ACON,SAAS,uBAMP,MACmF;AACnF,SAAQ,EAAE,MAAM,UAAU,EAAE,KAAK;EAC/B,MAAM,QAAQ,KAAK,MAAM;GAAE;GAAM;GAAO,CAAC;AAEzC,SAAO;GACL,SAAS,aAAa;AACpB,WAAO,MAAM,QAAQ,EAAE,SAAS,OAAO,WACrC,SAAS;KACP;KACA;KACM;KACP,CAAC,CACH;;GAEH,YAAY,aAAa;AACvB,WAAO,MAAM,WAAW,EAAE,SAAS,OAAO,WACxC,SAAS;KACP;KACA;KACM;KACP,CAAC,CACH;;GAEH,eAAe;AACb,WAAO,MAAM,YAAY;;GAE3B,WAAW;AACT,WAAO,MAAM,KAAK;;GAEpB,CAAC,OAAO,iBAAiB;AACvB,WAAO,iCAAiC,aACtC,MAAM,QAAQ,EAAE,SAAS,OAAO,WAC9B,SAAS;KACP;KACA;KACM;KACP,CAAC,CACH,CACF;;GAEJ;;;AAyCL,SAAS,qBAQP,MAeA;AACA,cAAa;EAEX,MAAM,QAAQ,KAAK;AACnB,SAAO;GACL,YAAY,aAAa;AACvB,WAAO,MAAM,WAAW,UAAU;AAChC,cAAS;MACP,SAAS,MAAM,WAAW;MAC1B,OAAO,MAAM;MACb,MAAM,MAAM;MACb,CAAC;MACF;;GAEJ,WAAW;IACT,MAAM,EAAE,SAAS,OAAO,SAAS,MAAM,KAAK;AAC5C,WAAO;KACL,SAAS,WAAW;KACpB;KACM;KACP;;GAEH,SAAS,EAAE,MAAM,MAAM,YAAY;AACjC,WAAO,MAAM,OAAO;KAAE;KAAM;KAAM;KAAO,CAAC;;GAE5C,CAAC,OAAO,iBAAiB;AACvB,WAAO,iCAAiC,aACtC,MAAM,QAAQ,UAAU;AACtB,cAAS;MACP,SAAS,MAAM,WAAW;MAC1B,OAAO,MAAM;MACb,MAAM,MAAM;MACb,CAAC;MACF,CACH;;GAEJ;;;AAIL,SAAgB,UACd,WA2BA;CAEA,MAAM,SAAS,EAAE;AAEjB,MAAK,MAAM,OAAO,WAAW;AAC3B,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,WAAW,IAAI,CACvD;EAGF,MAAM,OAAO,UAAU;AACvB,MAAI,UAAU,KAAK,CACjB,QAAO,OAAO,uBAAuB,KAAK;WACjC,cAAc,KAAK,CAC5B,QAAO,OAAO,qBAAqB,KAAK;MAGxC,QAAO,OAAO;;AAIlB,QAAO"}

package/dist/client/vue.d.ts

@@ -0,0 +1,39 @@
+import { InferOr, MaybeExtractPathParamsOrWiden, NonGetHTTPMethod, QueryParamsHint } from "../api-CBDGZiLC.js";
+import { FragnoClientError, FragnoClientHookData, FragnoClientMutatorData } from "../client-XFdAy-IQ.js";
+import { ReadableAtom, Store, StoreValue } from "nanostores";
+import { DeepReadonly, Ref, ShallowRef, UnwrapNestedRefs } from "vue";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/client/vue.d.ts
+
+type FragnoVueHook<_TMethod extends "GET", TPath extends string, TOutputSchema extends StandardSchemaV1, TErrorCode extends string, TQueryParameters extends string> = (args?: {
+  path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;
+  query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;
+}) => {
+  data: Ref<InferOr<TOutputSchema, undefined>>;
+  loading: Ref<boolean>;
+  error: Ref<FragnoClientError<TErrorCode[number]> | undefined>;
+};
+type FragnoVueMutator<_TMethod extends NonGetHTTPMethod, TPath extends string, TInputSchema extends StandardSchemaV1 | undefined, TOutputSchema extends StandardSchemaV1 | undefined, TErrorCode extends string, TQueryParameters extends string> = () => {
+  mutate: (args: {
+    body?: InferOr<TInputSchema, undefined>;
+    path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;
+    query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;
+  }) => Promise<InferOr<TOutputSchema, undefined>>;
+  loading: Ref<boolean | undefined>;
+  error: Ref<FragnoClientError<TErrorCode[number]> | undefined>;
+  data: Ref<InferOr<TOutputSchema, undefined>>;
+};
+/**
+ * Converts a Vue Ref to a NanoStore Atom.
+ *
+ * This is used to convert Vue refs to atoms, so that we can use them in the store.
+ *
+ * @private
+ */
+declare function refToAtom<T>(ref: Ref<T>): ReadableAtom<T>;
+declare function useFragno<T extends Record<string, unknown>>(clientObj: T): { [K in keyof T]: T[K] extends FragnoClientHookData<"GET", infer TPath, infer TOutputSchema, infer TErrorCode, infer TQueryParameters> ? FragnoVueHook<"GET", TPath, TOutputSchema, TErrorCode, TQueryParameters> : T[K] extends FragnoClientMutatorData<infer M, infer TPath, infer TInputSchema, infer TOutputSchema, infer TErrorCode, infer TQueryParameters> ? FragnoVueMutator<M, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters> : T[K] };
+declare function useStore<SomeStore extends Store, Value extends StoreValue<SomeStore>>(store: SomeStore): DeepReadonly<UnwrapNestedRefs<ShallowRef<Value>>>;
+//#endregion
+export { FragnoVueHook, FragnoVueMutator, refToAtom, useFragno, useStore };
+//# sourceMappingURL=vue.d.ts.map

package/dist/client/vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","names":[],"sources":["../../src/client/vue.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAeyB,KAAb,aAAa,CAAA,iBAAA,KAAA,EAAA,cAAA,MAAA,EAAA,sBAGD,gBAHC,EAAA,mBAAA,MAAA,EAAA,yBAAA,MAAA,CAAA,GAAA,CAAA,KAAA,EAAA;MAGD,CAAA,EAIf,6BAJe,CAIe,KAJf,EAAA,MAAA,GAI+B,GAJ/B,CAAA,MAAA,CAAA,GAI6C,YAJ7C,CAAA,MAAA,CAAA,CAAA;OAIe,CAAA,EAC7B,eAD6B,CACb,gBADa,EAAA,MAAA,GACc,GADd,CAAA,MAAA,CAAA,GAC4B,YAD5B,CAAA,MAAA,CAAA,CAAA;;MAA8B,EAG7D,GAH6D,CAGzD,OAHyD,CAGjD,aAHiD,EAAA,SAAA,CAAA,CAAA;SAA5D,EAIE,GAJF,CAAA,OAAA,CAAA;OACiB,EAIjB,GAJiB,CAIb,iBAJa,CAIK,UAJL,CAAA,MAAA,CAAA,CAAA,GAAA,SAAA,CAAA;;AAAyC,KAOvD,gBAPuD,CAAA,iBAQhD,gBARgD,EAAA,cAAA,MAAA,EAAA,qBAU5C,gBAV4C,GAAA,SAAA,EAAA,sBAW3C,gBAX2C,GAAA,SAAA,EAAA,mBAAA,MAAA,EAAA,yBAAA,MAAA,CAAA,GAAA,GAAA,GAAA;QAAzD,EAAA,CAAA,IAAA,EAAA;IAEU,IAAA,CAAA,EAcT,OAdS,CAcD,YAdC,EAAA,SAAA,CAAA;IAAR,IAAA,CAAA,EAeD,6BAfC,CAe6B,KAf7B,EAAA,MAAA,GAe6C,GAf7C,CAAA,MAAA,CAAA,GAe2D,YAf3D,CAAA,MAAA,CAAA,CAAA;IAAJ,KAAA,CAAA,EAgBI,eAhBJ,CAgBoB,gBAhBpB,EAAA,MAAA,GAgB+C,GAhB/C,CAAA,MAAA,CAAA,GAgB6D,YAhB7D,CAAA,MAAA,CAAA,CAAA;KACG,GAgBH,OAhBG,CAgBK,OAhBL,CAgBa,aAhBb,EAAA,SAAA,CAAA,CAAA;SACoB,EAgBpB,GAhBoB,CAAA,OAAA,GAAA,SAAA,CAAA;OAAlB,EAiBJ,GAjBI,CAiBA,iBAjBA,CAiBkB,UAjBlB,CAAA,MAAA,CAAA,CAAA,GAAA,SAAA,CAAA;MAAJ,EAkBD,GAlBC,CAkBG,OAlBH,CAkBW,aAlBX,EAAA,SAAA,CAAA,CAAA;CAAG;AAGZ;;;;;;;AAUyC,iBAezB,SAfyB,CAAA,CAAA,CAAA,CAAA,GAAA,EAeP,GAfO,CAeH,CAfG,CAAA,CAAA,EAeE,YAfF,CAee,CAff,CAAA;AAAgB,iBA+IzC,SA/IyC,CAAA,UA+IrB,MA/IqB,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,CAAA,SAAA,EAgJ5C,CAhJ4C,CAAA,EAAA,QAAc,MAkJzD,CAlJyD,GAkJrD,CAlJqD,CAkJnD,CAlJmD,CAAA,SAkJxC,oBAlJwC,CAAA,KAAA,EAAA,KAAA,MAAA,EAAA,KAAA,cAAA,EAAA,KAAA,WAAA,EAAA,KAAA,iBAAA,CAAA,GAyJjE,aAzJiE,CAAA,KAAA,EAyJ5C,KAzJ4C,EAyJrC,aAzJqC,EAyJtB,UAzJsB,EAyJV,gBAzJU,CAAA,GA0JjE,CA1JiE,CA0J/D,CA1J+D,CAAA,SA0JpD,uBA1JoD,CAAA,KAAA,EAAA,EAAA,KAAA,MAAA,EAAA,KAAA,aAAA,EAAA,KAAA,cAAA,EAAA,KAAA,WAAA,EAAA,KAAA,iBAAA,CAAA,GAkK/D,gBAlK+D,CAkK9C,CAlK8C,EAkK3C,KAlK2C,EAkKpC,YAlKoC,EAkKtB,aAlKsB,EAkKP,UAlKO,EAkKK,gBAlKL,CAAA,GAmK/D,CAnK+D,CAmK7D,CAnK6D,CAAA;AAC3C,iBA0LZ,QA1LY,CAAA,kBA0Le,KA1Lf,EAAA,cA0LoC,UA1LpC,CA0L+C,SA1L/C,CAAA,CAAA,CAAA,KAAA,EA2LnB,SA3LmB,CAAA,EA4LzB,YA5LyB,CA4LZ,gBA5LY,CA4LK,UA5LL,CA4LgB,KA5LhB,CAAA,CAAA,CAAA"}

package/dist/client/vue.js

@@ -0,0 +1,108 @@
+import "../api-DgHfYjq2.js";
+import "../route-Bp6eByhz.js";
+import { isGetHook, isMutatorHook } from "../client-DWjxKDnE.js";
+import "../ssr-tJHqcNSw.js";
+import { atom } from "nanostores";
+import { computed, getCurrentScope, isRef, onScopeDispose, ref, shallowRef, watch } from "vue";
+
+//#region src/client/vue.ts
+/**
+* Converts a Vue Ref to a NanoStore Atom.
+*
+* This is used to convert Vue refs to atoms, so that we can use them in the store.
+*
+* @private
+*/
+function refToAtom(ref$1) {
+	const a = atom(ref$1.value);
+	watch(ref$1, (newVal) => {
+		a.set(newVal);
+	});
+	return a;
+}
+function createVueHook(hook) {
+	return ({ path, query } = {}) => {
+		const pathParams = {};
+		const queryParams = {};
+		for (const [key, value] of Object.entries(path ?? {})) {
+			const v = value;
+			pathParams[key] = isRef(v) ? refToAtom(v) : v;
+		}
+		for (const [key, value] of Object.entries(query ?? {})) {
+			const v = value;
+			queryParams[key] = isRef(v) ? refToAtom(v) : v;
+		}
+		const store = hook.store({
+			path: pathParams,
+			query: queryParams
+		});
+		const data = ref();
+		const loading = ref();
+		const error = ref();
+		const unsubscribe = store.subscribe((updatedStoreValue) => {
+			data.value = updatedStoreValue.data;
+			loading.value = updatedStoreValue.loading;
+			error.value = updatedStoreValue.error;
+		});
+		if (getCurrentScope()) onScopeDispose(() => {
+			unsubscribe();
+		});
+		return {
+			data,
+			loading,
+			error
+		};
+	};
+}
+function createVueMutator(hook) {
+	return () => {
+		const store = useStore(hook.mutatorStore);
+		const mutate = async (args) => {
+			const { body, path, query } = args;
+			const pathParams = {};
+			const queryParams = {};
+			for (const [key, value] of Object.entries(path ?? {})) {
+				const v = value;
+				pathParams[key] = isRef(v) ? v.value : v;
+			}
+			for (const [key, value] of Object.entries(query ?? {})) {
+				const v = value;
+				queryParams[key] = isRef(v) ? v.value : v;
+			}
+			return store.value.mutate({
+				body,
+				path: pathParams,
+				query: queryParams
+			});
+		};
+		return {
+			mutate,
+			loading: computed(() => store.value.loading),
+			error: computed(() => store.value.error),
+			data: computed(() => store.value.data)
+		};
+	};
+}
+function useFragno(clientObj) {
+	const result = {};
+	for (const key in clientObj) {
+		if (!Object.prototype.hasOwnProperty.call(clientObj, key)) continue;
+		const hook = clientObj[key];
+		if (isGetHook(hook)) result[key] = createVueHook(hook);
+		else if (isMutatorHook(hook)) result[key] = createVueMutator(hook);
+		else result[key] = hook;
+	}
+	return result;
+}
+function useStore(store) {
+	const state = shallowRef();
+	const unsubscribe = store.subscribe((value) => {
+		state.value = value;
+	});
+	if (getCurrentScope()) onScopeDispose(unsubscribe);
+	return state;
+}
+
+//#endregion
+export { refToAtom, useFragno, useStore };
+//# sourceMappingURL=vue.js.map

package/dist/client/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","names":["ref","pathParams: Record<string, string | ReadableAtom<string>>","queryParams: Record<string, string | ReadableAtom<string>>"],"sources":["../../src/client/vue.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { atom, type ReadableAtom, type Store, type StoreValue } from \"nanostores\";\nimport type { DeepReadonly, Ref, ShallowRef, UnwrapNestedRefs } from \"vue\";\nimport { computed, getCurrentScope, isRef, onScopeDispose, ref, shallowRef, watch } from \"vue\";\nimport type { NonGetHTTPMethod } from \"../api/api\";\nimport {\n  isGetHook,\n  isMutatorHook,\n  type FragnoClientMutatorData,\n  type FragnoClientHookData,\n} from \"./client\";\nimport type { FragnoClientError } from \"./client-error\";\nimport type { MaybeExtractPathParamsOrWiden, QueryParamsHint } from \"../api/internal/path\";\nimport type { InferOr } from \"../util/types-util\";\n\nexport type FragnoVueHook<\n  _TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = (args?: {\n  path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n  query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n}) => {\n  data: Ref<InferOr<TOutputSchema, undefined>>;\n  loading: Ref<boolean>;\n  error: Ref<FragnoClientError<TErrorCode[number]> | undefined>;\n};\n\nexport type FragnoVueMutator<\n  _TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = () => {\n  mutate: (args: {\n    body?: InferOr<TInputSchema, undefined>;\n    path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n    query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n  }) => Promise<InferOr<TOutputSchema, undefined>>;\n  loading: Ref<boolean | undefined>;\n  error: Ref<FragnoClientError<TErrorCode[number]> | undefined>;\n  data: Ref<InferOr<TOutputSchema, undefined>>;\n};\n\n/**\n * Converts a Vue Ref to a NanoStore Atom.\n *\n * This is used to convert Vue refs to atoms, so that we can use them in the store.\n *\n * @private\n */\nexport function refToAtom<T>(ref: Ref<T>): ReadableAtom<T> {\n  const a = atom(ref.value);\n\n  watch(ref, (newVal) => {\n    a.set(newVal);\n  });\n\n  // TODO: Do we need to unsubscribe, or is this handled by `onScopeDispose` below?\n\n  return a;\n}\n\n// Helper function to create a Vue composable from a GET hook\n// We want 1 store per hook, so on updates to params, we need to update the store instead of creating a new one.\n// Nanostores only works with atoms (or strings), so we need to convert vue refs to atoms.\nfunction createVueHook<\n  TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientHookData<TMethod, TPath, TOutputSchema, TErrorCode, TQueryParameters>,\n): FragnoVueHook<TMethod, TPath, TOutputSchema, TErrorCode, TQueryParameters> {\n  return ({ path, query } = {}) => {\n    const pathParams: Record<string, string | ReadableAtom<string>> = {};\n    const queryParams: Record<string, string | ReadableAtom<string>> = {};\n\n    for (const [key, value] of Object.entries(path ?? {})) {\n      const v = value as string | Ref<string> | ReadableAtom<string>;\n      pathParams[key] = isRef(v) ? refToAtom(v) : v;\n    }\n\n    for (const [key, value] of Object.entries(query ?? {})) {\n      // Dunno why the cast is necessary\n      const v = value as string | Ref<string> | ReadableAtom<string>;\n      queryParams[key] = isRef(v) ? (refToAtom(v) as ReadableAtom<string>) : v;\n    }\n\n    const store = hook.store({\n      path: pathParams as MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>,\n      query: queryParams,\n    });\n\n    const data = ref();\n    const loading = ref();\n    const error = ref();\n\n    const unsubscribe = store.subscribe((updatedStoreValue) => {\n      data.value = updatedStoreValue.data;\n      loading.value = updatedStoreValue.loading;\n      error.value = updatedStoreValue.error;\n    });\n\n    if (getCurrentScope()) {\n      onScopeDispose(() => {\n        unsubscribe();\n      });\n    }\n\n    return {\n      data,\n      loading,\n      error,\n    };\n  };\n}\n\n// Helper function to create a Vue mutator from a mutator hook\nfunction createVueMutator<\n  TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientMutatorData<\n    TMethod,\n    TPath,\n    TInputSchema,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  >,\n): FragnoVueMutator<TMethod, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters> {\n  return () => {\n    const store = useStore(hook.mutatorStore);\n\n    // Create a wrapped mutate function that handles Vue refs\n    const mutate = async (args: {\n      body?: InferOr<TInputSchema, undefined>;\n      path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n      query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n    }) => {\n      const { body, path, query } = args;\n\n      const pathParams: Record<string, string | ReadableAtom<string>> = {};\n      const queryParams: Record<string, string | ReadableAtom<string>> = {};\n\n      for (const [key, value] of Object.entries(path ?? {})) {\n        const v = value as string | Ref<string> | ReadableAtom<string>;\n        pathParams[key] = isRef(v) ? v.value : v;\n      }\n\n      for (const [key, value] of Object.entries(query ?? {})) {\n        const v = value as string | Ref<string> | ReadableAtom<string>;\n        queryParams[key] = isRef(v) ? v.value : v;\n      }\n\n      // Call the store's mutate function with normalized params\n      return store.value.mutate({\n        body,\n        path: pathParams as MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>,\n        query: queryParams,\n      });\n    };\n\n    // Return the store-like object with Vue reactive refs\n    return {\n      mutate,\n      loading: computed(() => store.value.loading),\n      error: computed(() => store.value.error),\n      data: computed(() => store.value.data) as Ref<InferOr<TOutputSchema, undefined>>,\n    };\n  };\n}\n\nexport function useFragno<T extends Record<string, unknown>>(\n  clientObj: T,\n): {\n  [K in keyof T]: T[K] extends FragnoClientHookData<\n    \"GET\",\n    infer TPath,\n    infer TOutputSchema,\n    infer TErrorCode,\n    infer TQueryParameters\n  >\n    ? FragnoVueHook<\"GET\", TPath, TOutputSchema, TErrorCode, TQueryParameters>\n    : T[K] extends FragnoClientMutatorData<\n          infer M,\n          infer TPath,\n          infer TInputSchema,\n          infer TOutputSchema,\n          infer TErrorCode,\n          infer TQueryParameters\n        >\n      ? FragnoVueMutator<M, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters>\n      : T[K];\n} {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const result = {} as any;\n\n  for (const key in clientObj) {\n    if (!Object.prototype.hasOwnProperty.call(clientObj, key)) {\n      continue;\n    }\n\n    const hook = clientObj[key];\n    if (isGetHook(hook)) {\n      result[key] = createVueHook(hook);\n    } else if (isMutatorHook(hook)) {\n      result[key] = createVueMutator(hook);\n    } else {\n      // Pass through non-hook values unchanged\n      result[key] = hook;\n    }\n  }\n\n  return result;\n}\n\nexport function useStore<SomeStore extends Store, Value extends StoreValue<SomeStore>>(\n  store: SomeStore,\n): DeepReadonly<UnwrapNestedRefs<ShallowRef<Value>>> {\n  const state = shallowRef();\n\n  const unsubscribe = store.subscribe((value) => {\n    state.value = value;\n  });\n\n  if (getCurrentScope()) {\n    onScopeDispose(unsubscribe);\n  }\n\n  return state;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAuDA,SAAgB,UAAa,OAA8B;CACzD,MAAM,IAAI,KAAKA,MAAI,MAAM;AAEzB,OAAMA,QAAM,WAAW;AACrB,IAAE,IAAI,OAAO;GACb;AAIF,QAAO;;AAMT,SAAS,cAOP,MAC4E;AAC5E,SAAQ,EAAE,MAAM,UAAU,EAAE,KAAK;EAC/B,MAAMC,aAA4D,EAAE;EACpE,MAAMC,cAA6D,EAAE;AAErE,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE,CAAC,EAAE;GACrD,MAAM,IAAI;AACV,cAAW,OAAO,MAAM,EAAE,GAAG,UAAU,EAAE,GAAG;;AAG9C,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,EAAE,CAAC,EAAE;GAEtD,MAAM,IAAI;AACV,eAAY,OAAO,MAAM,EAAE,GAAI,UAAU,EAAE,GAA4B;;EAGzE,MAAM,QAAQ,KAAK,MAAM;GACvB,MAAM;GACN,OAAO;GACR,CAAC;EAEF,MAAM,OAAO,KAAK;EAClB,MAAM,UAAU,KAAK;EACrB,MAAM,QAAQ,KAAK;EAEnB,MAAM,cAAc,MAAM,WAAW,sBAAsB;AACzD,QAAK,QAAQ,kBAAkB;AAC/B,WAAQ,QAAQ,kBAAkB;AAClC,SAAM,QAAQ,kBAAkB;IAChC;AAEF,MAAI,iBAAiB,CACnB,sBAAqB;AACnB,gBAAa;IACb;AAGJ,SAAO;GACL;GACA;GACA;GACD;;;AAKL,SAAS,iBAQP,MAQ6F;AAC7F,cAAa;EACX,MAAM,QAAQ,SAAS,KAAK,aAAa;EAGzC,MAAM,SAAS,OAAO,SAIhB;GACJ,MAAM,EAAE,MAAM,MAAM,UAAU;GAE9B,MAAMD,aAA4D,EAAE;GACpE,MAAMC,cAA6D,EAAE;AAErE,QAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE,CAAC,EAAE;IACrD,MAAM,IAAI;AACV,eAAW,OAAO,MAAM,EAAE,GAAG,EAAE,QAAQ;;AAGzC,QAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,EAAE,CAAC,EAAE;IACtD,MAAM,IAAI;AACV,gBAAY,OAAO,MAAM,EAAE,GAAG,EAAE,QAAQ;;AAI1C,UAAO,MAAM,MAAM,OAAO;IACxB;IACA,MAAM;IACN,OAAO;IACR,CAAC;;AAIJ,SAAO;GACL;GACA,SAAS,eAAe,MAAM,MAAM,QAAQ;GAC5C,OAAO,eAAe,MAAM,MAAM,MAAM;GACxC,MAAM,eAAe,MAAM,MAAM,KAAK;GACvC;;;AAIL,SAAgB,UACd,WAoBA;CAEA,MAAM,SAAS,EAAE;AAEjB,MAAK,MAAM,OAAO,WAAW;AAC3B,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,WAAW,IAAI,CACvD;EAGF,MAAM,OAAO,UAAU;AACvB,MAAI,UAAU,KAAK,CACjB,QAAO,OAAO,cAAc,KAAK;WACxB,cAAc,KAAK,CAC5B,QAAO,OAAO,iBAAiB,KAAK;MAGpC,QAAO,OAAO;;AAIlB,QAAO;;AAGT,SAAgB,SACd,OACmD;CACnD,MAAM,QAAQ,YAAY;CAE1B,MAAM,cAAc,MAAM,WAAW,UAAU;AAC7C,QAAM,QAAQ;GACd;AAEF,KAAI,iBAAiB,CACnB,gBAAe,YAAY;AAG7B,QAAO"}