@mearie/react 0.1.0 → 0.2.0

package/dist/index.cjs

@@ -1,34 +1,8 @@
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-let __mearie_core = require("@mearie/core");
-__mearie_core = __toESM(__mearie_core);
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _mearie_core = require("@mearie/core");
 let react = require("react");
-react = __toESM(react);
 let react_jsx_runtime = require("react/jsx-runtime");
-react_jsx_runtime = __toESM(react_jsx_runtime);
-let __mearie_core_stream = require("@mearie/core/stream");
-__mearie_core_stream = __toESM(__mearie_core_stream);
+let _mearie_core_stream = require("@mearie/core/stream");
 
 //#region src/client-provider.tsx
 const ClientContext = (0, react.createContext)(null);
@@ -46,22 +20,24 @@ const useClient = () => {
 
 //#endregion
 //#region src/use-query.ts
-const useQuery = (query, ...[variables, options]) => {
+const useQuery = ((query, variables, options) => {
 	const client = useClient();
-	const [data, setData] = (0, react.useState)();
-	const [loading, setLoading] = (0, react.useState)(!options?.skip);
+	const [data, setData] = (0, react.useState)(options?.initialData);
+	const [loading, setLoading] = (0, react.useState)(!options?.skip && !options?.initialData);
 	const [error, setError] = (0, react.useState)();
 	const unsubscribe = (0, react.useRef)(null);
-	const stableVariables = (0, react.useMemo)(() => (0, __mearie_core.stringify)(variables), [variables]);
+	const initialized = (0, react.useRef)(false);
+	const stableVariables = (0, react.useMemo)(() => (0, _mearie_core.stringify)(variables), [variables]);
 	const stableOptions = (0, react.useMemo)(() => options, [options?.skip]);
 	const execute = (0, react.useCallback)(() => {
 		unsubscribe.current?.();
 		if (stableOptions?.skip) return;
-		setLoading(true);
+		if (!initialized.current && options?.initialData) setLoading(true);
+		initialized.current = true;
 		setError(void 0);
-		unsubscribe.current = (0, __mearie_core_stream.pipe)(client.executeQuery(query, variables, stableOptions), (0, __mearie_core_stream.subscribe)({ next: (result) => {
+		unsubscribe.current = (0, _mearie_core_stream.pipe)(client.executeQuery(query, variables, stableOptions), (0, _mearie_core_stream.subscribe)({ next: (result) => {
 			if (result.errors && result.errors.length > 0) {
-				setError(new __mearie_core.AggregatedError(result.errors));
+				setError(new _mearie_core.AggregatedError(result.errors));
 				setLoading(false);
 			} else {
 				setData(result.data);
@@ -85,7 +61,7 @@ const useQuery = (query, ...[variables, options]) => {
 		error,
 		refetch: execute
 	};
-};
+});
 
 //#endregion
 //#region src/use-subscription.ts
@@ -95,7 +71,7 @@ const useSubscription = (subscription, ...[variables, options]) => {
 	const [loading, setLoading] = (0, react.useState)(!options?.skip);
 	const [error, setError] = (0, react.useState)();
 	const unsubscribe = (0, react.useRef)(null);
-	const stableVariables = (0, react.useMemo)(() => (0, __mearie_core.stringify)(variables), [variables]);
+	const stableVariables = (0, react.useMemo)(() => (0, _mearie_core.stringify)(variables), [variables]);
 	const stableOptions = (0, react.useMemo)(() => options, [
 		options?.skip,
 		options?.onData,
@@ -106,9 +82,9 @@ const useSubscription = (subscription, ...[variables, options]) => {
 		if (stableOptions?.skip) return;
 		setLoading(true);
 		setError(void 0);
-		unsubscribe.current = (0, __mearie_core_stream.pipe)(client.executeSubscription(subscription, variables, stableOptions), (0, __mearie_core_stream.subscribe)({ next: (result) => {
+		unsubscribe.current = (0, _mearie_core_stream.pipe)(client.executeSubscription(subscription, variables, stableOptions), (0, _mearie_core_stream.subscribe)({ next: (result) => {
 			if (result.errors && result.errors.length > 0) {
-				const err = new __mearie_core.AggregatedError(result.errors);
+				const err = new _mearie_core.AggregatedError(result.errors);
 				setError(err);
 				setLoading(false);
 				stableOptions?.onError?.(err);
@@ -148,9 +124,9 @@ const useMutation = (mutation) => {
 		setLoading(true);
 		setError(void 0);
 		try {
-			const result = await (0, __mearie_core_stream.pipe)(client.executeMutation(mutation, variables, options), __mearie_core_stream.collect);
+			const result = await (0, _mearie_core_stream.pipe)(client.executeMutation(mutation, variables, options), (0, _mearie_core_stream.take)(1), _mearie_core_stream.collect);
 			if (result.errors && result.errors.length > 0) {
-				const err = new __mearie_core.AggregatedError(result.errors);
+				const err = new _mearie_core.AggregatedError(result.errors);
 				setError(err);
 				setLoading(false);
 				throw err;
@@ -159,7 +135,7 @@ const useMutation = (mutation) => {
 			setLoading(false);
 			return result.data;
 		} catch (err) {
-			if (err instanceof __mearie_core.AggregatedError) setError(err);
+			if (err instanceof _mearie_core.AggregatedError) setError(err);
 			setLoading(false);
 			throw err;
 		}
@@ -172,12 +148,16 @@ const useMutation = (mutation) => {
 
 //#endregion
 //#region src/use-fragment.ts
-const useFragment = (fragment, fragmentRef, options) => {
+const useFragment = ((fragment, fragmentRef, options) => {
 	const client = useClient();
 	const dataRef = (0, react.useRef)(void 0);
 	const subscribe_ = (0, react.useCallback)((onChange) => {
-		return (0, __mearie_core_stream.pipe)(client.executeFragment(fragment, fragmentRef, options), (0, __mearie_core_stream.subscribe)({ next: (result) => {
-			if (result.errors && result.errors.length > 0) throw new __mearie_core.AggregatedError(result.errors);
+		if (fragmentRef == null) {
+			dataRef.current = null;
+			return () => {};
+		}
+		return (0, _mearie_core_stream.pipe)(client.executeFragment(fragment, fragmentRef, options), (0, _mearie_core_stream.subscribe)({ next: (result) => {
+			if (result.errors && result.errors.length > 0) throw new _mearie_core.AggregatedError(result.errors);
 			dataRef.current = result.data;
 			onChange();
 		} }));
@@ -188,9 +168,10 @@ const useFragment = (fragment, fragmentRef, options) => {
 		options
 	]);
 	const snapshot = (0, react.useCallback)(() => {
+		if (fragmentRef == null) return null;
 		if (dataRef.current === void 0) {
-			const result = (0, __mearie_core_stream.pipe)(client.executeFragment(fragment, fragmentRef, options), __mearie_core_stream.peek);
-			if (result.errors && result.errors.length > 0) throw new __mearie_core.AggregatedError(result.errors);
+			const result = (0, _mearie_core_stream.pipe)(client.executeFragment(fragment, fragmentRef, options), _mearie_core_stream.peek);
+			if (result.errors && result.errors.length > 0) throw new _mearie_core.AggregatedError(result.errors);
 			dataRef.current = result.data;
 		}
 		return dataRef.current;
@@ -204,7 +185,7 @@ const useFragment = (fragment, fragmentRef, options) => {
 	return { get data() {
 		return data;
 	} };
-};
+});
 
 //#endregion
 exports.ClientProvider = ClientProvider;
@@ -213,9 +194,9 @@ exports.useFragment = useFragment;
 exports.useMutation = useMutation;
 exports.useQuery = useQuery;
 exports.useSubscription = useSubscription;
-Object.keys(__mearie_core).forEach(function (k) {
+Object.keys(_mearie_core).forEach(function (k) {
   if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
     enumerable: true,
-    get: function () { return __mearie_core[k]; }
+    get: function () { return _mearie_core[k]; }
   });
 });

package/dist/index.d.cts

@@ -14,6 +14,9 @@ declare const ClientProvider: <TMeta extends SchemaMeta = SchemaMeta>({
 declare const useClient: <TMeta extends SchemaMeta = SchemaMeta>() => Client<TMeta>;
 //#endregion
 //#region src/use-query.d.ts
+type UseQueryOptions<T extends Artifact<'query'> = Artifact<'query'>> = QueryOptions<T> & {
+  skip?: boolean;
+};
 type Query<T extends Artifact<'query'>> = {
   data: undefined;
   loading: true;
@@ -30,10 +33,29 @@ type Query<T extends Artifact<'query'>> = {
   error: AggregatedError;
   refetch: () => void;
 };
-type UseQueryOptions = QueryOptions & {
-  skip?: boolean;
+type DefinedQuery<T extends Artifact<'query'>> = {
+  data: DataOf<T>;
+  loading: true;
+  error: undefined;
+  refetch: () => void;
+} | {
+  data: DataOf<T>;
+  loading: false;
+  error: undefined;
+  refetch: () => void;
+} | {
+  data: DataOf<T>;
+  loading: false;
+  error: AggregatedError;
+  refetch: () => void;
+};
+type UseQueryFn = {
+  <T extends Artifact<'query'>>(query: T, variables: VariablesOf<T> | undefined, options: UseQueryOptions<T> & {
+    initialData: DataOf<T>;
+  }): DefinedQuery<T>;
+  <T extends Artifact<'query'>>(query: T, ...[variables, options]: VariablesOf<T> extends Record<string, never> ? [undefined?, UseQueryOptions<T>?] : [VariablesOf<T>, UseQueryOptions<T>?]): Query<T>;
 };
-declare const useQuery: <T extends Artifact<"query">>(query: T, ...[variables, options]: VariablesOf<T> extends Record<string, never> ? [undefined?, UseQueryOptions?] : [VariablesOf<T>, UseQueryOptions?]) => Query<T>;
+declare const useQuery: UseQueryFn;
 //#endregion
 //#region src/use-subscription.d.ts
 type Subscription<T extends Artifact<'subscription'>> = {
@@ -79,6 +101,17 @@ type UseFragmentOptions = FragmentOptions;
 type Fragment<T extends Artifact<'fragment'>> = {
   data: DataOf<T>;
 };
-declare const useFragment: <T extends Artifact<"fragment">>(fragment: T, fragmentRef: FragmentRefs<T["name"]>, options?: UseFragmentOptions) => Fragment<T>;
+type FragmentList<T extends Artifact<'fragment'>> = {
+  data: DataOf<T>[];
+};
+type OptionalFragment<T extends Artifact<'fragment'>> = {
+  data: DataOf<T> | null;
+};
+type UseFragmentFn = {
+  <T extends Artifact<'fragment'>>(fragment: T, fragmentRef: FragmentRefs<T['name']>[], options?: UseFragmentOptions): FragmentList<T>;
+  <T extends Artifact<'fragment'>>(fragment: T, fragmentRef: FragmentRefs<T['name']>, options?: UseFragmentOptions): Fragment<T>;
+  <T extends Artifact<'fragment'>>(fragment: T, fragmentRef: FragmentRefs<T['name']> | null | undefined, options?: UseFragmentOptions): OptionalFragment<T>;
+};
+declare const useFragment: UseFragmentFn;
 //#endregion
-export { ClientProvider, type Fragment, type Mutation, type Query, type Subscription, type UseFragmentOptions, type UseMutationOptions, type UseQueryOptions, type UseSubscriptionOptions, useClient, useFragment, useMutation, useQuery, useSubscription };
+export { ClientProvider, type DefinedQuery, type Fragment, type FragmentList, type Mutation, type OptionalFragment, type Query, type Subscription, type UseFragmentOptions, type UseMutationOptions, type UseQueryOptions, type UseSubscriptionOptions, useClient, useFragment, useMutation, useQuery, useSubscription };

package/dist/{index.d.ts → index.d.mts}

@@ -14,6 +14,9 @@ declare const ClientProvider: <TMeta extends SchemaMeta = SchemaMeta>({
 declare const useClient: <TMeta extends SchemaMeta = SchemaMeta>() => Client<TMeta>;
 //#endregion
 //#region src/use-query.d.ts
+type UseQueryOptions<T extends Artifact<'query'> = Artifact<'query'>> = QueryOptions<T> & {
+  skip?: boolean;
+};
 type Query<T extends Artifact<'query'>> = {
   data: undefined;
   loading: true;
@@ -30,10 +33,29 @@ type Query<T extends Artifact<'query'>> = {
   error: AggregatedError;
   refetch: () => void;
 };
-type UseQueryOptions = QueryOptions & {
-  skip?: boolean;
+type DefinedQuery<T extends Artifact<'query'>> = {
+  data: DataOf<T>;
+  loading: true;
+  error: undefined;
+  refetch: () => void;
+} | {
+  data: DataOf<T>;
+  loading: false;
+  error: undefined;
+  refetch: () => void;
+} | {
+  data: DataOf<T>;
+  loading: false;
+  error: AggregatedError;
+  refetch: () => void;
+};
+type UseQueryFn = {
+  <T extends Artifact<'query'>>(query: T, variables: VariablesOf<T> | undefined, options: UseQueryOptions<T> & {
+    initialData: DataOf<T>;
+  }): DefinedQuery<T>;
+  <T extends Artifact<'query'>>(query: T, ...[variables, options]: VariablesOf<T> extends Record<string, never> ? [undefined?, UseQueryOptions<T>?] : [VariablesOf<T>, UseQueryOptions<T>?]): Query<T>;
 };
-declare const useQuery: <T extends Artifact<"query">>(query: T, ...[variables, options]: VariablesOf<T> extends Record<string, never> ? [undefined?, UseQueryOptions?] : [VariablesOf<T>, UseQueryOptions?]) => Query<T>;
+declare const useQuery: UseQueryFn;
 //#endregion
 //#region src/use-subscription.d.ts
 type Subscription<T extends Artifact<'subscription'>> = {
@@ -79,6 +101,17 @@ type UseFragmentOptions = FragmentOptions;
 type Fragment<T extends Artifact<'fragment'>> = {
   data: DataOf<T>;
 };
-declare const useFragment: <T extends Artifact<"fragment">>(fragment: T, fragmentRef: FragmentRefs<T["name"]>, options?: UseFragmentOptions) => Fragment<T>;
+type FragmentList<T extends Artifact<'fragment'>> = {
+  data: DataOf<T>[];
+};
+type OptionalFragment<T extends Artifact<'fragment'>> = {
+  data: DataOf<T> | null;
+};
+type UseFragmentFn = {
+  <T extends Artifact<'fragment'>>(fragment: T, fragmentRef: FragmentRefs<T['name']>[], options?: UseFragmentOptions): FragmentList<T>;
+  <T extends Artifact<'fragment'>>(fragment: T, fragmentRef: FragmentRefs<T['name']>, options?: UseFragmentOptions): Fragment<T>;
+  <T extends Artifact<'fragment'>>(fragment: T, fragmentRef: FragmentRefs<T['name']> | null | undefined, options?: UseFragmentOptions): OptionalFragment<T>;
+};
+declare const useFragment: UseFragmentFn;
 //#endregion
-export { ClientProvider, type Fragment, type Mutation, type Query, type Subscription, type UseFragmentOptions, type UseMutationOptions, type UseQueryOptions, type UseSubscriptionOptions, useClient, useFragment, useMutation, useQuery, useSubscription };
+export { ClientProvider, type DefinedQuery, type Fragment, type FragmentList, type Mutation, type OptionalFragment, type Query, type Subscription, type UseFragmentOptions, type UseMutationOptions, type UseQueryOptions, type UseSubscriptionOptions, useClient, useFragment, useMutation, useQuery, useSubscription };

package/dist/{index.js → index.mjs}

@@ -1,7 +1,7 @@
 import { AggregatedError, stringify } from "@mearie/core";
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { jsx } from "react/jsx-runtime";
-import { collect, peek, pipe, subscribe } from "@mearie/core/stream";
+import { collect, peek, pipe, subscribe, take } from "@mearie/core/stream";
 
 export * from "@mearie/core"
 
@@ -21,18 +21,20 @@ const useClient = () => {
 
 //#endregion
 //#region src/use-query.ts
-const useQuery = (query, ...[variables, options]) => {
+const useQuery = ((query, variables, options) => {
 	const client = useClient();
-	const [data, setData] = useState();
-	const [loading, setLoading] = useState(!options?.skip);
+	const [data, setData] = useState(options?.initialData);
+	const [loading, setLoading] = useState(!options?.skip && !options?.initialData);
 	const [error, setError] = useState();
 	const unsubscribe = useRef(null);
+	const initialized = useRef(false);
 	const stableVariables = useMemo(() => stringify(variables), [variables]);
 	const stableOptions = useMemo(() => options, [options?.skip]);
 	const execute = useCallback(() => {
 		unsubscribe.current?.();
 		if (stableOptions?.skip) return;
-		setLoading(true);
+		if (!initialized.current && options?.initialData) setLoading(true);
+		initialized.current = true;
 		setError(void 0);
 		unsubscribe.current = pipe(client.executeQuery(query, variables, stableOptions), subscribe({ next: (result) => {
 			if (result.errors && result.errors.length > 0) {
@@ -60,7 +62,7 @@ const useQuery = (query, ...[variables, options]) => {
 		error,
 		refetch: execute
 	};
-};
+});
 
 //#endregion
 //#region src/use-subscription.ts
@@ -123,7 +125,7 @@ const useMutation = (mutation) => {
 		setLoading(true);
 		setError(void 0);
 		try {
-			const result = await pipe(client.executeMutation(mutation, variables, options), collect);
+			const result = await pipe(client.executeMutation(mutation, variables, options), take(1), collect);
 			if (result.errors && result.errors.length > 0) {
 				const err = new AggregatedError(result.errors);
 				setError(err);
@@ -147,10 +149,14 @@ const useMutation = (mutation) => {
 
 //#endregion
 //#region src/use-fragment.ts
-const useFragment = (fragment, fragmentRef, options) => {
+const useFragment = ((fragment, fragmentRef, options) => {
 	const client = useClient();
 	const dataRef = useRef(void 0);
 	const subscribe_ = useCallback((onChange) => {
+		if (fragmentRef == null) {
+			dataRef.current = null;
+			return () => {};
+		}
 		return pipe(client.executeFragment(fragment, fragmentRef, options), subscribe({ next: (result) => {
 			if (result.errors && result.errors.length > 0) throw new AggregatedError(result.errors);
 			dataRef.current = result.data;
@@ -163,6 +169,7 @@ const useFragment = (fragment, fragmentRef, options) => {
 		options
 	]);
 	const snapshot = useCallback(() => {
+		if (fragmentRef == null) return null;
 		if (dataRef.current === void 0) {
 			const result = pipe(client.executeFragment(fragment, fragmentRef, options), peek);
 			if (result.errors && result.errors.length > 0) throw new AggregatedError(result.errors);
@@ -179,7 +186,7 @@ const useFragment = (fragment, fragmentRef, options) => {
 	return { get data() {
 		return data;
 	} };
-};
+});
 
 //#endregion
 export { ClientProvider, useClient, useFragment, useMutation, useQuery, useSubscription };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearie/react",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Type-safe, zero-overhead GraphQL client",
   "keywords": [
     "graphql",
@@ -40,12 +40,12 @@
     "README.md"
   ],
   "dependencies": {
-    "@mearie/core": "0.1.0"
+    "@mearie/core": "0.2.0"
   },
   "devDependencies": {
-    "@types/react": "^19.2.2",
-    "react": "^19.2.0",
-    "tsdown": "^0.15.12",
+    "@types/react": "^19.2.14",
+    "react": "^19.2.4",
+    "tsdown": "^0.20.3",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {