@plumile/backoffice-react 0.1.104 → 0.1.106

package/lib/esm/hooks/useBackofficeAuth.js

@@ -0,0 +1,89 @@
+import { useBackofficeConfig as e } from "../provider/BackofficeConfigContext.js";
+import { createUseAuth as t } from "./useAuth.js";
+import { useRelayEnvironment as n } from "../relay/useRelayEnvironment.js";
+import { useCallback as r, useMemo as i, useState as a } from "react";
+import * as o from "react-relay";
+//#region src/hooks/useBackofficeAuth.ts
+var { commitMutation: s } = o, c = (e) => e instanceof Error ? e : /* @__PURE__ */ Error("Unable to load auth mutation."), l = (e) => {
+	let t = n(), [i, o] = a(0);
+	return {
+		commit: r((n) => {
+			o((e) => e + 1);
+			let r = () => {
+				o((e) => Math.max(0, e - 1));
+			};
+			e().then((e) => {
+				if (e == null) throw Error("Missing auth mutation config.");
+				s(t, {
+					mutation: e,
+					variables: n.variables,
+					onCompleted: (e, t) => {
+						r(), n.onCompleted?.(e, t ?? null);
+					},
+					onError: (e) => {
+						r(), n.onError?.(e);
+					}
+				});
+			}).catch((e) => {
+				r(), n.onError?.(c(e));
+			});
+		}, [e, t]),
+		isInFlight: i > 0
+	};
+}, u = async (e, t, n) => e ?? (t == null ? null : n(await t.load()));
+function d() {
+	let { auth: n } = e(), { commit: a, isInFlight: o } = l(r(async () => u(n.login.get()?.loginMutation, n.login, (e) => e.loginMutation), [n.login])), { commit: s, isInFlight: c } = l(r(async () => (await n.logout.load()).logoutMutation, [n.logout])), { commit: d, isInFlight: f } = l(r(async () => u(n.login.get()?.completeMfaMutation, n.completeMfa, (e) => e.completeMfaMutation), [n.completeMfa, n.login])), { commit: p, isInFlight: m } = l(r(async () => u(n.login.get()?.beginPasskeyLoginMutation, n.passkeyLogin, (e) => e.beginPasskeyLoginMutation), [n.login, n.passkeyLogin])), { commit: h, isInFlight: g } = l(r(async () => u(n.login.get()?.finishPasskeyLoginMutation, n.passkeyLogin, (e) => e.finishPasskeyLoginMutation), [n.login, n.passkeyLogin])), { commit: _, isInFlight: v } = l(r(async () => u(n.login.get()?.beginAuthenticationMutation, n.authentication, (e) => e.beginAuthenticationMutation), [n.authentication, n.login])), { commit: y, isInFlight: b } = l(r(async () => u(n.login.get()?.acceptInvitationMutation, n.acceptInvitation, (e) => e.acceptInvitationMutation), [n.acceptInvitation, n.login])), x = n.login.get()?.acceptInvitationMutation != null || n.acceptInvitation != null;
+	return i(() => {
+		let e;
+		return x && (e = {
+			commit: y,
+			isInFlight: b
+		}), t({
+			login: {
+				commit: a,
+				isInFlight: o
+			},
+			logout: {
+				commit: s,
+				isInFlight: c
+			},
+			completeMfa: {
+				commit: d,
+				isInFlight: f
+			},
+			beginPasskeyLogin: {
+				commit: p,
+				isInFlight: m
+			},
+			finishPasskeyLogin: {
+				commit: h,
+				isInFlight: g
+			},
+			beginAuthentication: {
+				commit: _,
+				isInFlight: v
+			},
+			acceptInvitation: e
+		});
+	}, [
+		y,
+		_,
+		p,
+		d,
+		h,
+		a,
+		s,
+		x,
+		b,
+		v,
+		m,
+		f,
+		g,
+		o,
+		c
+	])();
+}
+//#endregion
+export { d as useBackofficeAuth };
+
+//# sourceMappingURL=useBackofficeAuth.js.map

package/lib/esm/hooks/useBackofficeAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackofficeAuth.js","names":[],"sources":["../../../src/hooks/useBackofficeAuth.ts"],"sourcesContent":["import { useCallback, useMemo, useState } from 'react';\nimport * as ReactRelay from 'react-relay';\nimport type { GraphQLTaggedNode, PayloadError } from 'relay-runtime';\n\nimport {\n  createUseAuth,\n  type UseAuthReturn,\n  type AcceptInvitationResponse,\n  type AcceptInvitationVariables,\n  type BeginAuthenticationResponse,\n  type BeginAuthenticationVariables,\n  type BeginPasskeyLoginResponse,\n  type BeginPasskeyLoginVariables,\n  type CompleteMfaResponse,\n  type CompleteMfaVariables,\n  type FinishPasskeyLoginResponse,\n  type FinishPasskeyLoginVariables,\n  type LoginResponse,\n  type LoginVariables,\n  type LogoutResponse,\n  type LogoutVariables,\n} from './useAuth.js';\nimport { useBackofficeConfig } from '../provider/BackofficeConfigContext.js';\nimport type { BackofficeLazyValue } from '../provider/lazyValue.js';\nimport { useRelayEnvironment } from '../relay/useRelayEnvironment.js';\n\nconst { commitMutation } = ReactRelay;\n\ntype MutationCommitConfig<TVariables, TResponse> = {\n  variables: TVariables;\n  onCompleted?: (\n    response: TResponse,\n    errors: readonly PayloadError[] | null,\n  ) => void;\n  onError?: (error: Error) => void;\n};\n\nconst toMutationLoadError = (error: unknown): Error => {\n  if (error instanceof Error) {\n    return error;\n  }\n  return new Error('Unable to load auth mutation.');\n};\n\nconst useDeferredMutation = <TVariables extends object, TResponse>(\n  loadMutation: () => Promise<GraphQLTaggedNode | null>,\n) => {\n  const relayEnvironment = useRelayEnvironment();\n  const [inFlightCount, setInFlightCount] = useState(0);\n\n  const commit = useCallback(\n    (config: MutationCommitConfig<TVariables, TResponse>) => {\n      setInFlightCount((count) => {\n        return count + 1;\n      });\n\n      const finish = () => {\n        setInFlightCount((count) => {\n          return Math.max(0, count - 1);\n        });\n      };\n\n      loadMutation()\n        .then((mutation) => {\n          if (mutation == null) {\n            throw new Error('Missing auth mutation config.');\n          }\n\n          commitMutation(relayEnvironment, {\n            mutation,\n            variables: config.variables,\n            onCompleted: (response, errors) => {\n              finish();\n              config.onCompleted?.(response as TResponse, errors ?? null);\n            },\n            onError: (error) => {\n              finish();\n              config.onError?.(error);\n            },\n          });\n        })\n        .catch((error: unknown) => {\n          finish();\n          config.onError?.(toMutationLoadError(error));\n        });\n    },\n    [loadMutation, relayEnvironment],\n  );\n\n  return {\n    commit,\n    isInFlight: inFlightCount > 0,\n  };\n};\n\nconst loadOptionalMutation = async <TConfig>(\n  eagerMutation: GraphQLTaggedNode | null | undefined,\n  lazyConfig: BackofficeLazyValue<TConfig> | null | undefined,\n  selectMutation: (config: TConfig) => GraphQLTaggedNode,\n): Promise<GraphQLTaggedNode | null> => {\n  if (eagerMutation != null) {\n    return eagerMutation;\n  }\n  if (lazyConfig == null) {\n    return null;\n  }\n  const loadedConfig = await lazyConfig.load();\n  return selectMutation(loadedConfig);\n};\n\n/**\n * Provides auth actions/state backed by Relay mutations from BackofficeProvider.\n */\nexport function useBackofficeAuth(): UseAuthReturn {\n  const { auth: authConfig } = useBackofficeConfig();\n  const { commit: commitLogin, isInFlight: isLoginInFlight } =\n    useDeferredMutation<LoginVariables, LoginResponse>(\n      useCallback(async () => {\n        const loginConfig = authConfig.login.get();\n        return loadOptionalMutation(\n          loginConfig?.loginMutation,\n          authConfig.login,\n          (config) => {\n            return config.loginMutation;\n          },\n        );\n      }, [authConfig.login]),\n    );\n  const { commit: commitLogout, isInFlight: isLogoutInFlight } =\n    useDeferredMutation<LogoutVariables, LogoutResponse>(\n      useCallback(async () => {\n        const logoutConfig = await authConfig.logout.load();\n        return logoutConfig.logoutMutation;\n      }, [authConfig.logout]),\n    );\n  const { commit: commitCompleteMfa, isInFlight: isCompleteMfaInFlight } =\n    useDeferredMutation<CompleteMfaVariables, CompleteMfaResponse>(\n      useCallback(async () => {\n        return loadOptionalMutation(\n          authConfig.login.get()?.completeMfaMutation,\n          authConfig.completeMfa,\n          (config) => {\n            return config.completeMfaMutation;\n          },\n        );\n      }, [authConfig.completeMfa, authConfig.login]),\n    );\n  const {\n    commit: commitBeginPasskeyLogin,\n    isInFlight: isBeginPasskeyLoginInFlight,\n  } = useDeferredMutation<\n    BeginPasskeyLoginVariables,\n    BeginPasskeyLoginResponse\n  >(\n    useCallback(async () => {\n      return loadOptionalMutation(\n        authConfig.login.get()?.beginPasskeyLoginMutation,\n        authConfig.passkeyLogin,\n        (config) => {\n          return config.beginPasskeyLoginMutation;\n        },\n      );\n    }, [authConfig.login, authConfig.passkeyLogin]),\n  );\n  const {\n    commit: commitFinishPasskeyLogin,\n    isInFlight: isFinishPasskeyLoginInFlight,\n  } = useDeferredMutation<\n    FinishPasskeyLoginVariables,\n    FinishPasskeyLoginResponse\n  >(\n    useCallback(async () => {\n      return loadOptionalMutation(\n        authConfig.login.get()?.finishPasskeyLoginMutation,\n        authConfig.passkeyLogin,\n        (config) => {\n          return config.finishPasskeyLoginMutation;\n        },\n      );\n    }, [authConfig.login, authConfig.passkeyLogin]),\n  );\n  const {\n    commit: commitBeginAuthentication,\n    isInFlight: isBeginAuthenticationInFlight,\n  } = useDeferredMutation<\n    BeginAuthenticationVariables,\n    BeginAuthenticationResponse\n  >(\n    useCallback(async () => {\n      return loadOptionalMutation(\n        authConfig.login.get()?.beginAuthenticationMutation,\n        authConfig.authentication,\n        (config) => {\n          return config.beginAuthenticationMutation;\n        },\n      );\n    }, [authConfig.authentication, authConfig.login]),\n  );\n  const {\n    commit: commitAcceptInvitation,\n    isInFlight: isAcceptInvitationInFlight,\n  } = useDeferredMutation<AcceptInvitationVariables, AcceptInvitationResponse>(\n    useCallback(async () => {\n      return loadOptionalMutation(\n        authConfig.login.get()?.acceptInvitationMutation,\n        authConfig.acceptInvitation,\n        (config) => {\n          return config.acceptInvitationMutation;\n        },\n      );\n    }, [authConfig.acceptInvitation, authConfig.login]),\n  );\n  const hasAcceptInvitationMutation =\n    authConfig.login.get()?.acceptInvitationMutation != null ||\n    authConfig.acceptInvitation != null;\n\n  const useAuthWithMutations = useMemo(() => {\n    let acceptInvitation:\n      | {\n          commit: typeof commitAcceptInvitation;\n          isInFlight: boolean;\n        }\n      | undefined;\n    if (hasAcceptInvitationMutation) {\n      acceptInvitation = {\n        commit: commitAcceptInvitation,\n        isInFlight: isAcceptInvitationInFlight,\n      };\n    }\n    return createUseAuth({\n      login: { commit: commitLogin, isInFlight: isLoginInFlight },\n      logout: { commit: commitLogout, isInFlight: isLogoutInFlight },\n      completeMfa: {\n        commit: commitCompleteMfa,\n        isInFlight: isCompleteMfaInFlight,\n      },\n      beginPasskeyLogin: {\n        commit: commitBeginPasskeyLogin,\n        isInFlight: isBeginPasskeyLoginInFlight,\n      },\n      finishPasskeyLogin: {\n        commit: commitFinishPasskeyLogin,\n        isInFlight: isFinishPasskeyLoginInFlight,\n      },\n      beginAuthentication: {\n        commit: commitBeginAuthentication,\n        isInFlight: isBeginAuthenticationInFlight,\n      },\n      acceptInvitation,\n    });\n  }, [\n    commitAcceptInvitation,\n    commitBeginAuthentication,\n    commitBeginPasskeyLogin,\n    commitCompleteMfa,\n    commitFinishPasskeyLogin,\n    commitLogin,\n    commitLogout,\n    hasAcceptInvitationMutation,\n    isAcceptInvitationInFlight,\n    isBeginAuthenticationInFlight,\n    isBeginPasskeyLoginInFlight,\n    isCompleteMfaInFlight,\n    isFinishPasskeyLoginInFlight,\n    isLoginInFlight,\n    isLogoutInFlight,\n  ]);\n\n  return useAuthWithMutations();\n}\n"],"mappings":"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"}

package/lib/esm/hooks/useBackofficeInfiniteScrollSentinel.js

@@ -0,0 +1,39 @@
+import { useCallback as e, useEffect as t, useRef as n, useState as r } from "react";
+//#region src/hooks/useBackofficeInfiniteScrollSentinel.ts
+function i({ enabled: i, hasNextPage: a, isLoading: o, onIntersect: s, root: c = null, rootMargin: l = "360px 0px", threshold: u = 0 }) {
+	let [d, f] = r(null), p = n(s), m = n(0);
+	return t(() => {
+		p.current = s;
+	}, [s]), t(() => {
+		if (!i || !a || o || d == null) return () => {};
+		let e = () => {
+			let e = Date.now();
+			e - m.current < 250 || (m.current = e, p.current());
+		};
+		if (typeof IntersectionObserver > "u") return e(), () => {};
+		let t = new IntersectionObserver((t) => {
+			t[0]?.isIntersecting === !0 && e();
+		}, {
+			root: c,
+			rootMargin: l,
+			threshold: u
+		});
+		return t.observe(d), () => {
+			t.disconnect();
+		};
+	}, [
+		i,
+		a,
+		o,
+		d,
+		c,
+		l,
+		u
+	]), { sentinelRef: e((e) => {
+		f(e);
+	}, []) };
+}
+//#endregion
+export { i as useBackofficeInfiniteScrollSentinel };
+
+//# sourceMappingURL=useBackofficeInfiniteScrollSentinel.js.map

package/lib/esm/hooks/useBackofficeInfiniteScrollSentinel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackofficeInfiniteScrollSentinel.js","names":[],"sources":["../../../src/hooks/useBackofficeInfiniteScrollSentinel.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\nexport type UseBackofficeInfiniteScrollSentinelOptions = {\n  enabled: boolean;\n  hasNextPage: boolean;\n  isLoading: boolean;\n  root?: Element | null;\n  rootMargin?: string;\n  threshold?: number;\n  onIntersect: () => void;\n};\n\nexport type UseBackofficeInfiniteScrollSentinelResult = {\n  sentinelRef: (node: HTMLElement | null) => void;\n};\n\n/**\n * Observes a sentinel element and triggers pagination when it enters the viewport.\n */\nexport function useBackofficeInfiniteScrollSentinel({\n  enabled,\n  hasNextPage,\n  isLoading,\n  onIntersect,\n  root = null,\n  rootMargin = '360px 0px',\n  threshold = 0,\n}: UseBackofficeInfiniteScrollSentinelOptions): UseBackofficeInfiniteScrollSentinelResult {\n  const [node, setNode] = useState<HTMLElement | null>(null);\n  const onIntersectRef = useRef(onIntersect);\n  const lastIntersectAtRef = useRef(0);\n\n  useEffect(() => {\n    onIntersectRef.current = onIntersect;\n  }, [onIntersect]);\n\n  useEffect(() => {\n    if (!enabled || !hasNextPage || isLoading || node == null) {\n      return () => {};\n    }\n\n    const triggerIntersect = () => {\n      const now = Date.now();\n      if (now - lastIntersectAtRef.current < 250) {\n        return;\n      }\n      lastIntersectAtRef.current = now;\n      onIntersectRef.current();\n    };\n\n    if (typeof IntersectionObserver === 'undefined') {\n      triggerIntersect();\n      return () => {};\n    }\n\n    const observer = new IntersectionObserver(\n      (entries) => {\n        const entry = entries[0];\n        if (entry?.isIntersecting === true) {\n          triggerIntersect();\n        }\n      },\n      {\n        root,\n        rootMargin,\n        threshold,\n      },\n    );\n\n    observer.observe(node);\n\n    return () => {\n      observer.disconnect();\n    };\n  }, [enabled, hasNextPage, isLoading, node, root, rootMargin, threshold]);\n\n  const sentinelRef = useCallback((next: HTMLElement | null) => {\n    setNode(next);\n  }, []);\n\n  return { sentinelRef };\n}\n"],"mappings":";;AAmBA,SAAgB,EAAoC,EAClD,YACA,gBACA,cACA,gBACA,UAAO,MACP,gBAAa,aACb,eAAY,KAC4E;CACxF,IAAM,CAAC,GAAM,KAAW,EAA6B,KAAK,EACpD,IAAiB,EAAO,EAAY,EACpC,IAAqB,EAAO,EAAE;CAkDpC,OAhDA,QAAgB;EACd,EAAe,UAAU;IACxB,CAAC,EAAY,CAAC,EAEjB,QAAgB;EACd,IAAI,CAAC,KAAW,CAAC,KAAe,KAAa,KAAQ,MACnD,aAAa;EAGf,IAAM,UAAyB;GAC7B,IAAM,IAAM,KAAK,KAAK;GAClB,IAAM,EAAmB,UAAU,QAGvC,EAAmB,UAAU,GAC7B,EAAe,SAAS;;EAG1B,IAAI,OAAO,uBAAyB,KAElC,OADA,GAAkB,QACL;EAGf,IAAM,IAAW,IAAI,sBAClB,MAAY;GAEX,AADc,EAAQ,IACX,mBAAmB,MAC5B,GAAkB;KAGtB;GACE;GACA;GACA;GACD,CACF;EAID,OAFA,EAAS,QAAQ,EAAK,QAET;GACX,EAAS,YAAY;;IAEtB;EAAC;EAAS;EAAa;EAAW;EAAM;EAAM;EAAY;EAAU,CAAC,EAMjE,EAAE,aAJW,GAAa,MAA6B;EAC5D,EAAQ,EAAK;IACZ,EAAE,CAEI,EAAa"}

package/lib/esm/hooks/useBackofficeListRefetch.js

@@ -0,0 +1,50 @@
+import { startTransition as e, useCallback as t, useEffect as n, useRef as r, useState as i } from "react";
+import { stableListVariablesKey as a } from "@plumile/backoffice-core/state/stableKey.js";
+//#region src/hooks/useBackofficeListRefetch.ts
+function o({ refetch: o, variables: s, defaults: c, fetchPolicy: l, buildQueryVariables: u }) {
+	let [d, f] = i(!1), p = r(0), m = r(a({
+		where: c.where,
+		sort: c.sort,
+		count: c.count
+	})), h = t((e) => u(e), [u]), g = t((t) => {
+		let n = p.current + 1;
+		p.current = n, f(!0);
+		let r = h({
+			...t,
+			cursor: null
+		});
+		try {
+			e(() => {
+				o(r, {
+					fetchPolicy: l,
+					onComplete: () => {
+						p.current === n && f(!1);
+					}
+				});
+			});
+		} catch (e) {
+			throw p.current === n && f(!1), e;
+		}
+	}, [
+		l,
+		o,
+		h
+	]);
+	return n(() => {
+		let e = a({
+			where: s.where,
+			sort: s.sort,
+			count: s.count
+		});
+		m.current !== e && (m.current = e, g(s));
+	}, [g, s]), {
+		isRefreshing: d,
+		onRefresh: t(() => {
+			g(s);
+		}, [g, s])
+	};
+}
+//#endregion
+export { o as useBackofficeListRefetch };
+
+//# sourceMappingURL=useBackofficeListRefetch.js.map

package/lib/esm/hooks/useBackofficeListRefetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackofficeListRefetch.js","names":[],"sources":["../../../src/hooks/useBackofficeListRefetch.ts"],"sourcesContent":["import {\n  startTransition,\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n} from 'react';\nimport type { FetchPolicy } from 'relay-runtime';\n\nimport { stableListVariablesKey } from '@plumile/backoffice-core/state/stableKey.js';\nimport type { BackofficeListVariables } from '@plumile/backoffice-core/types.js';\n\ntype RefetchFn<TVariables> = (\n  vars: TVariables,\n  opts: {\n    fetchPolicy: FetchPolicy;\n    onComplete?: (error: Error | null) => void;\n  },\n) => { dispose: () => void } | undefined;\n\ntype Params<Where, Sort extends string, Variables> = {\n  refetch: RefetchFn<Variables>;\n  variables: BackofficeListVariables<Where, Sort>;\n  defaults: BackofficeListVariables<Where, Sort>;\n  fetchPolicy: FetchPolicy;\n  buildQueryVariables: (\n    input: BackofficeListVariables<Where, Sort>,\n  ) => Variables;\n};\n\n/**\n * Standardizes refetch behavior for backoffice list components:\n * - Refetches when list URL state changes (where/sort/count), gated by a stable key.\n * - Exposes a manual refresh callback using the same variables.\n *\n * This hook must not call Relay hooks (`useFragment`, `usePaginationFragment`, ...).\n */\nexport function useBackofficeListRefetch<\n  Where,\n  Sort extends string,\n  Variables extends Record<string, unknown>,\n>({\n  refetch,\n  variables,\n  defaults,\n  fetchPolicy,\n  buildQueryVariables,\n}: Params<Where, Sort, Variables>): {\n  isRefreshing: boolean;\n  onRefresh: () => void;\n} {\n  const [isRefreshing, setIsRefreshing] = useState(false);\n  const requestIdRef = useRef(0);\n  const lastRefetchKeyRef = useRef<string | null>(\n    stableListVariablesKey({\n      where: defaults.where,\n      sort: defaults.sort,\n      count: defaults.count,\n    }),\n  );\n\n  const resolveVariables = useCallback(\n    (input: BackofficeListVariables<Where, Sort>) => {\n      return buildQueryVariables(input);\n    },\n    [buildQueryVariables],\n  );\n\n  const runRefetch = useCallback(\n    (input: BackofficeListVariables<Where, Sort>) => {\n      const requestId = requestIdRef.current + 1;\n      requestIdRef.current = requestId;\n      setIsRefreshing(true);\n\n      const nextVariables = resolveVariables({ ...input, cursor: null });\n      try {\n        startTransition(() => {\n          refetch(nextVariables, {\n            fetchPolicy,\n            onComplete: () => {\n              if (requestIdRef.current === requestId) {\n                setIsRefreshing(false);\n              }\n            },\n          });\n        });\n      } catch (error) {\n        if (requestIdRef.current === requestId) {\n          setIsRefreshing(false);\n        }\n        throw error;\n      }\n    },\n    [fetchPolicy, refetch, resolveVariables],\n  );\n\n  useEffect(() => {\n    const key = stableListVariablesKey({\n      where: variables.where,\n      sort: variables.sort,\n      count: variables.count,\n    });\n    if (lastRefetchKeyRef.current === key) {\n      return;\n    }\n    lastRefetchKeyRef.current = key;\n\n    runRefetch(variables);\n  }, [runRefetch, variables]);\n\n  const onRefresh = useCallback(() => {\n    runRefetch(variables);\n  }, [runRefetch, variables]);\n\n  return { isRefreshing, onRefresh };\n}\n"],"mappings":";;;AAqCA,SAAgB,EAId,EACA,YACA,cACA,aACA,gBACA,0BAIA;CACA,IAAM,CAAC,GAAc,KAAmB,EAAS,GAAM,EACjD,IAAe,EAAO,EAAE,EACxB,IAAoB,EACxB,EAAuB;EACrB,OAAO,EAAS;EAChB,MAAM,EAAS;EACf,OAAO,EAAS;EACjB,CAAC,CACH,EAEK,IAAmB,GACtB,MACQ,EAAoB,EAAM,EAEnC,CAAC,EAAoB,CACtB,EAEK,IAAa,GAChB,MAAgD;EAC/C,IAAM,IAAY,EAAa,UAAU;EAEzC,AADA,EAAa,UAAU,GACvB,EAAgB,GAAK;EAErB,IAAM,IAAgB,EAAiB;GAAE,GAAG;GAAO,QAAQ;GAAM,CAAC;EAClE,IAAI;GACF,QAAsB;IACpB,EAAQ,GAAe;KACrB;KACA,kBAAkB;MAChB,AAAI,EAAa,YAAY,KAC3B,EAAgB,GAAM;;KAG3B,CAAC;KACF;WACK,GAAO;GAId,MAHI,EAAa,YAAY,KAC3B,EAAgB,GAAM,EAElB;;IAGV;EAAC;EAAa;EAAS;EAAiB,CACzC;CAoBD,OAlBA,QAAgB;EACd,IAAM,IAAM,EAAuB;GACjC,OAAO,EAAU;GACjB,MAAM,EAAU;GAChB,OAAO,EAAU;GAClB,CAAC;EACE,EAAkB,YAAY,MAGlC,EAAkB,UAAU,GAE5B,EAAW,EAAU;IACpB,CAAC,GAAY,EAAU,CAAC,EAMpB;EAAE;EAAc,WAJL,QAAkB;GAClC,EAAW,EAAU;KACpB,CAAC,GAAY,EAAU,CAEH;EAAW"}

package/lib/esm/{useBackofficeListUrlState-D4fx5O7u.js → hooks/useBackofficeListUrlState.js}

@@ -32,6 +32,6 @@ function o(o) {
 	};
 }
 //#endregion
-export { o as t };
+export { o as useBackofficeListUrlState };
 
-//# sourceMappingURL=useBackofficeListUrlState-D4fx5O7u.js.map
+//# sourceMappingURL=useBackofficeListUrlState.js.map

package/lib/esm/hooks/useBackofficeListUrlState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackofficeListUrlState.js","names":[],"sources":["../../../src/hooks/useBackofficeListUrlState.ts"],"sourcesContent":["import { useCallback, useContext, useMemo } from 'react';\nimport { RoutingContext, useLocation } from '@plumile/router';\n\nimport type {\n  BackofficeListState,\n  BackofficeRuntimeResolvedListFacetConfig,\n} from '@plumile/backoffice-core/types.js';\n\n/** Normalizes a router `location.search` string into URLSearchParams. */\nfunction normalizeSearch(value: string): URLSearchParams {\n  if (value.trim() === '') {\n    return new URLSearchParams();\n  }\n  return new URLSearchParams(value);\n}\n\ntype ReturnValue<Where extends Record<string, unknown>, Sort extends string> = {\n  state: BackofficeListState<Where, Sort>;\n  pushState: (next: BackofficeListState<Where, Sort>) => void;\n};\n\n/** Keeps list state in sync with the URL search params for backoffice pages. */\nexport function useBackofficeListUrlState<\n  Where extends Record<string, unknown>,\n  Sort extends string,\n>(config: BackofficeRuntimeResolvedListFacetConfig): ReturnValue<Where, Sort> {\n  const routing = useContext(RoutingContext);\n  const { hash, pathname, search } = useLocation();\n  const fallbackState = useMemo(() => {\n    return {\n      where: null,\n      sort: null,\n    };\n  }, []);\n\n  const state = useMemo(() => {\n    if (config.listUrlCodec == null) {\n      return fallbackState;\n    }\n    return config.listUrlCodec.parse(\n      normalizeSearch(search),\n    ) as BackofficeListState<Where, Sort>;\n  }, [config.listUrlCodec, fallbackState, search]);\n\n  const pushState = useCallback(\n    (next: BackofficeListState<Where, Sort>) => {\n      if (routing == null) {\n        return;\n      }\n      if (config.listUrlCodec == null) {\n        return;\n      }\n\n      const params = config.listUrlCodec.serialize(next as never);\n      const qs = params.toString();\n\n      let nextSearch = '';\n      if (qs !== '') {\n        nextSearch = `?${qs}`;\n      }\n\n      routing.history.push({\n        pathname,\n        search: nextSearch,\n        hash,\n      });\n    },\n    [config.listUrlCodec, hash, pathname, routing],\n  );\n\n  return { state, pushState };\n}\n"],"mappings":";;;AASA,SAAS,EAAgB,GAAgC;CAIvD,OAHI,EAAM,MAAM,KAAK,KACZ,IAAI,iBAAiB,GAEvB,IAAI,gBAAgB,EAAM;;AASnC,SAAgB,EAGd,GAA4E;CAC5E,IAAM,IAAU,EAAW,EAAe,EACpC,EAAE,SAAM,aAAU,cAAW,GAAa,EAC1C,IAAgB,SACb;EACL,OAAO;EACP,MAAM;EACP,GACA,EAAE,CAAC;CAqCN,OAAO;EAAE,OAnCK,QACR,EAAO,gBAAgB,OAClB,IAEF,EAAO,aAAa,MACzB,EAAgB,EAAO,CACxB,EACA;GAAC,EAAO;GAAc;GAAe;GAAO,CA4BtC;EAAO,WA1BE,GACf,MAA2C;GAI1C,IAHI,KAAW,QAGX,EAAO,gBAAgB,MACzB;GAIF,IAAM,IADS,EAAO,aAAa,UAAU,EAClC,CAAO,UAAU,EAExB,IAAa;GAKjB,AAJI,MAAO,OACT,IAAa,IAAI,MAGnB,EAAQ,QAAQ,KAAK;IACnB;IACA,QAAQ;IACR;IACD,CAAC;KAEJ;GAAC,EAAO;GAAc;GAAM;GAAU;GAAQ,CAGhC;EAAW"}

package/lib/esm/hooks/useBackofficeLoadMore.js

@@ -0,0 +1,18 @@
+import { startTransition as e, useCallback as t } from "react";
+//#region src/hooks/useBackofficeLoadMore.ts
+function n({ hasNext: n, isLoadingNext: r, loadNext: i, count: a }) {
+	return t(() => {
+		!n || r || e(() => {
+			i(a);
+		});
+	}, [
+		a,
+		n,
+		r,
+		i
+	]);
+}
+//#endregion
+export { n as useBackofficeLoadMore };
+
+//# sourceMappingURL=useBackofficeLoadMore.js.map

package/lib/esm/hooks/useBackofficeLoadMore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackofficeLoadMore.js","names":[],"sources":["../../../src/hooks/useBackofficeLoadMore.ts"],"sourcesContent":["import { startTransition, useCallback } from 'react';\n\ntype Params = {\n  hasNext: boolean;\n  isLoadingNext: boolean;\n  loadNext: (count: number) => void;\n  count: number;\n};\n\n/**\n * Wraps Relay `loadNext()` with consistent guards and `startTransition()`.\n */\nexport function useBackofficeLoadMore({\n  hasNext,\n  isLoadingNext,\n  loadNext,\n  count,\n}: Params): () => void {\n  return useCallback(() => {\n    if (!hasNext || isLoadingNext) {\n      return;\n    }\n\n    startTransition(() => {\n      loadNext(count);\n    });\n  }, [count, hasNext, isLoadingNext, loadNext]);\n}\n"],"mappings":";;AAYA,SAAgB,EAAsB,EACpC,YACA,kBACA,aACA,YACqB;CACrB,OAAO,QAAkB;EACnB,CAAC,KAAW,KAIhB,QAAsB;GACpB,EAAS,EAAM;IACf;IACD;EAAC;EAAO;EAAS;EAAe;EAAS,CAAC"}

package/lib/esm/hooks/useBackofficeSessionAuth.js

@@ -0,0 +1,33 @@
+import { useBackofficeConfig as e } from "../provider/BackofficeConfigContext.js";
+import { useBackofficeAuthLogoutConfig as t } from "../provider/useBackofficeLazyValue.js";
+import * as n from "react-relay";
+//#region src/hooks/useBackofficeSessionAuth.ts
+var { useMutation: r } = n, i = (e) => e instanceof Error ? e : /* @__PURE__ */ Error("Logout cleanup failed."), a = () => {
+	let { auth: n } = e(), [a, o] = r(t().logoutMutation);
+	return {
+		logout: async () => new Promise((e, t) => {
+			a({
+				variables: {},
+				onCompleted: () => {
+					Promise.resolve(n.lifecycle?.onLogoutSuccess?.()).then(() => {
+						e();
+					}, (e) => {
+						t(i(e));
+					});
+				},
+				onError: (e) => {
+					if (e instanceof Error) {
+						t(e);
+						return;
+					}
+					t(/* @__PURE__ */ Error("Logout failed."));
+				}
+			});
+		}),
+		isLoading: o
+	};
+};
+//#endregion
+export { a as default, a as useBackofficeSessionAuth };
+
+//# sourceMappingURL=useBackofficeSessionAuth.js.map

package/lib/esm/hooks/useBackofficeSessionAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackofficeSessionAuth.js","names":[],"sources":["../../../src/hooks/useBackofficeSessionAuth.ts"],"sourcesContent":["import * as ReactRelay from 'react-relay';\nimport type { MutationParameters } from 'relay-runtime';\n\nimport type { LogoutResponse, LogoutVariables } from './useAuth.js';\nimport { useBackofficeConfig } from '../provider/BackofficeConfigContext.js';\nimport { useBackofficeAuthLogoutConfig } from '../provider/useBackofficeLazyValue.js';\n\nconst { useMutation } = ReactRelay;\n\nconst toLogoutCleanupError = (error: unknown): Error => {\n  if (error instanceof Error) {\n    return error;\n  }\n  return new Error('Logout cleanup failed.');\n};\n\nexport type BackofficeSessionAuth = {\n  logout: () => Promise<void>;\n  isLoading: boolean;\n};\n\nexport const useBackofficeSessionAuth = (): BackofficeSessionAuth => {\n  const { auth: authConfig } = useBackofficeConfig();\n  const auth = useBackofficeAuthLogoutConfig();\n\n  type LogoutMutation = MutationParameters & {\n    response: LogoutResponse;\n    variables: LogoutVariables;\n  };\n\n  const [commitLogout, isLogoutInFlight] = useMutation<LogoutMutation>(\n    auth.logoutMutation,\n  );\n\n  return {\n    logout: async () => {\n      return new Promise((resolve, reject) => {\n        commitLogout({\n          variables: {},\n          onCompleted: () => {\n            Promise.resolve(authConfig.lifecycle?.onLogoutSuccess?.()).then(\n              () => {\n                resolve();\n              },\n              (error: unknown) => {\n                reject(toLogoutCleanupError(error));\n              },\n            );\n          },\n          onError: (error) => {\n            if (error instanceof Error) {\n              reject(error);\n              return;\n            }\n            reject(new Error('Logout failed.'));\n          },\n        });\n      });\n    },\n    isLoading: isLogoutInFlight,\n  };\n};\n\nexport default useBackofficeSessionAuth;\n"],"mappings":";;;;AAOA,IAAM,EAAE,mBAAgB,GAElB,KAAwB,MACxB,aAAiB,QACZ,IAEF,gBAAI,MAAM,yBAAyB,EAQ/B,UAAwD;CACnE,IAAM,EAAE,MAAM,MAAe,GAAqB,EAQ5C,CAAC,GAAc,KAAoB,EAP5B,GAQX,CAAK,eACN;CAED,OAAO;EACL,QAAQ,YACC,IAAI,SAAS,GAAS,MAAW;GACtC,EAAa;IACX,WAAW,EAAE;IACb,mBAAmB;KACjB,QAAQ,QAAQ,EAAW,WAAW,mBAAmB,CAAC,CAAC,WACnD;MACJ,GAAS;SAEV,MAAmB;MAClB,EAAO,EAAqB,EAAM,CAAC;OAEtC;;IAEH,UAAU,MAAU;KAClB,IAAI,aAAiB,OAAO;MAC1B,EAAO,EAAM;MACb;;KAEF,EAAO,gBAAI,MAAM,iBAAiB,CAAC;;IAEtC,CAAC;IACF;EAEJ,WAAW;EACZ"}

package/lib/esm/hooks/useBackofficeSidebarPins.js

@@ -0,0 +1,89 @@
+import { useCallback as e, useEffect as t, useMemo as n, useState as r } from "react";
+//#region src/hooks/useBackofficeSidebarPins.ts
+var i = "backoffice.sidebar.pins.v1", a = (e) => {
+	if (typeof window > "u") return [];
+	try {
+		let t = window.localStorage.getItem(e);
+		if (t == null) return [];
+		let n = JSON.parse(t);
+		return Array.isArray(n) ? n.filter((e) => typeof e == "string") : [];
+	} catch {
+		return [];
+	}
+}, o = (e, t) => {
+	let n = [], r = /* @__PURE__ */ new Set();
+	return e.forEach((e) => {
+		t.has(e) && (r.has(e) || (r.add(e), n.push(e)));
+	}), n;
+}, s = (s) => {
+	let { enabled: c = !0, storageKey: l = i, visibleEntityIds: u } = s, d = n(() => new Set(u), [u]), [f, p] = r(() => c ? o(a(l), d) : []);
+	t(() => {
+		if (!c) {
+			p([]);
+			return;
+		}
+		p((e) => {
+			let t = o(e, d);
+			if (t.length === e.length) {
+				let n = !0;
+				for (let r = 0; r < t.length; r += 1) if (t[r] !== e[r]) {
+					n = !1;
+					break;
+				}
+				if (n) return e;
+			}
+			return t;
+		});
+	}, [c, d]), t(() => {
+		if (!c) {
+			p([]);
+			return;
+		}
+		p(o(a(l), d));
+	}, [
+		c,
+		l,
+		d
+	]), t(() => {
+		if (!(!c || typeof window > "u")) try {
+			window.localStorage.setItem(l, JSON.stringify(f));
+		} catch {}
+	}, [
+		c,
+		f,
+		l
+	]);
+	let m = n(() => new Set(f), [f]), h = e((e) => {
+		c && d.has(e) && p((t) => t.includes(e) ? t : [...t, e]);
+	}, [c, d]), g = e((e) => {
+		c && p((t) => t.filter((t) => t !== e));
+	}, [c]), _ = e((e) => {
+		m.has(e) ? g(e) : h(e);
+	}, [
+		h,
+		m,
+		g
+	]), v = e((e, t) => {
+		c && e !== t && p((n) => {
+			let r = n.indexOf(e), i = n.indexOf(t);
+			if (r === -1 || i === -1 || r === i) return n;
+			let a = [...n];
+			return a.splice(r, 1), a.splice(i, 0, e), a;
+		});
+	}, [c]);
+	return {
+		pins: f,
+		isPinned: e((e) => m.has(e), [m]),
+		pin: h,
+		unpin: g,
+		toggle: _,
+		reorder: v
+	};
+}, c = {
+	normalizePins: o,
+	readPinsFromStorage: a
+};
+//#endregion
+export { c as __test, s as default, s as useBackofficeSidebarPins };
+
+//# sourceMappingURL=useBackofficeSidebarPins.js.map

package/lib/esm/hooks/useBackofficeSidebarPins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackofficeSidebarPins.js","names":[],"sources":["../../../src/hooks/useBackofficeSidebarPins.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useState } from 'react';\n\nconst DEFAULT_STORAGE_KEY = 'backoffice.sidebar.pins.v1';\n\ntype PinsPayload = unknown;\n\nconst readPinsFromStorage = (storageKey: string): string[] => {\n  if (typeof window === 'undefined') {\n    return [];\n  }\n  try {\n    const raw = window.localStorage.getItem(storageKey);\n    if (raw == null) {\n      return [];\n    }\n    const parsed = JSON.parse(raw) as PinsPayload;\n    if (!Array.isArray(parsed)) {\n      return [];\n    }\n    return parsed.filter((entry): entry is string => {\n      return typeof entry === 'string';\n    });\n  } catch {\n    return [];\n  }\n};\n\nconst normalizePins = (\n  pins: readonly string[],\n  validIds: Set<string>,\n): string[] => {\n  const output: string[] = [];\n  const seen = new Set<string>();\n  pins.forEach((entry) => {\n    if (!validIds.has(entry)) {\n      return;\n    }\n    if (seen.has(entry)) {\n      return;\n    }\n    seen.add(entry);\n    output.push(entry);\n  });\n  return output;\n};\n\nexport type SidebarPinsState = {\n  pins: readonly string[];\n  isPinned: (id: string) => boolean;\n  pin: (id: string) => void;\n  unpin: (id: string) => void;\n  toggle: (id: string) => void;\n  reorder: (fromId: string, toId: string) => void;\n};\n\nexport type UseBackofficeSidebarPinsInput = {\n  enabled?: boolean;\n  storageKey?: string;\n  visibleEntityIds: readonly string[];\n};\n\nexport const useBackofficeSidebarPins = (\n  input: UseBackofficeSidebarPinsInput,\n): SidebarPinsState => {\n  const {\n    enabled = true,\n    storageKey = DEFAULT_STORAGE_KEY,\n    visibleEntityIds,\n  } = input;\n  const validIds = useMemo(() => {\n    return new Set(visibleEntityIds);\n  }, [visibleEntityIds]);\n\n  const [pins, setPins] = useState<string[]>(() => {\n    if (!enabled) {\n      return [];\n    }\n    const stored = readPinsFromStorage(storageKey);\n    return normalizePins(stored, validIds);\n  });\n\n  useEffect(() => {\n    if (!enabled) {\n      setPins([]);\n      return;\n    }\n    setPins((prev) => {\n      const normalized = normalizePins(prev, validIds);\n      if (normalized.length === prev.length) {\n        let unchanged = true;\n        for (let index = 0; index < normalized.length; index += 1) {\n          if (normalized[index] !== prev[index]) {\n            unchanged = false;\n            break;\n          }\n        }\n        if (unchanged) {\n          return prev;\n        }\n      }\n      return normalized;\n    });\n  }, [enabled, validIds]);\n\n  useEffect(() => {\n    if (!enabled) {\n      setPins([]);\n      return;\n    }\n    const stored = readPinsFromStorage(storageKey);\n    setPins(normalizePins(stored, validIds));\n  }, [enabled, storageKey, validIds]);\n\n  useEffect(() => {\n    if (!enabled || typeof window === 'undefined') {\n      return;\n    }\n    try {\n      window.localStorage.setItem(storageKey, JSON.stringify(pins));\n    } catch {\n      // Ignore storage errors in non-browser or restricted environments.\n    }\n  }, [enabled, pins, storageKey]);\n\n  const pinsSet = useMemo(() => {\n    return new Set(pins);\n  }, [pins]);\n\n  const pin = useCallback(\n    (id: string) => {\n      if (!enabled) {\n        return;\n      }\n      if (!validIds.has(id)) {\n        return;\n      }\n      setPins((prev) => {\n        if (prev.includes(id)) {\n          return prev;\n        }\n        return [...prev, id];\n      });\n    },\n    [enabled, validIds],\n  );\n\n  const unpin = useCallback(\n    (id: string) => {\n      if (!enabled) {\n        return;\n      }\n      setPins((prev) => {\n        return prev.filter((entry) => {\n          return entry !== id;\n        });\n      });\n    },\n    [enabled],\n  );\n\n  const toggle = useCallback(\n    (id: string) => {\n      if (pinsSet.has(id)) {\n        unpin(id);\n      } else {\n        pin(id);\n      }\n    },\n    [pin, pinsSet, unpin],\n  );\n\n  const reorder = useCallback(\n    (fromId: string, toId: string) => {\n      if (!enabled) {\n        return;\n      }\n      if (fromId === toId) {\n        return;\n      }\n      setPins((prev) => {\n        const fromIndex = prev.indexOf(fromId);\n        const toIndex = prev.indexOf(toId);\n        if (fromIndex === -1 || toIndex === -1) {\n          return prev;\n        }\n        if (fromIndex === toIndex) {\n          return prev;\n        }\n        const next = [...prev];\n        next.splice(fromIndex, 1);\n        next.splice(toIndex, 0, fromId);\n        return next;\n      });\n    },\n    [enabled],\n  );\n\n  const isPinned = useCallback(\n    (id: string) => {\n      return pinsSet.has(id);\n    },\n    [pinsSet],\n  );\n\n  return {\n    pins,\n    isPinned,\n    pin,\n    unpin,\n    toggle,\n    reorder,\n  };\n};\n\nexport const __test = {\n  normalizePins,\n  readPinsFromStorage,\n};\n\nexport default useBackofficeSidebarPins;\n"],"mappings":";;AAEA,IAAM,IAAsB,8BAItB,KAAuB,MAAiC;CAC5D,IAAI,OAAO,SAAW,KACpB,OAAO,EAAE;CAEX,IAAI;EACF,IAAM,IAAM,OAAO,aAAa,QAAQ,EAAW;EACnD,IAAI,KAAO,MACT,OAAO,EAAE;EAEX,IAAM,IAAS,KAAK,MAAM,EAAI;EAI9B,OAHK,MAAM,QAAQ,EAAO,GAGnB,EAAO,QAAQ,MACb,OAAO,KAAU,SACxB,GAJO,EAAE;SAKL;EACN,OAAO,EAAE;;GAIP,KACJ,GACA,MACa;CACb,IAAM,IAAmB,EAAE,EACrB,oBAAO,IAAI,KAAa;CAW9B,OAVA,EAAK,SAAS,MAAU;EACjB,EAAS,IAAI,EAAM,KAGpB,EAAK,IAAI,EAAM,KAGnB,EAAK,IAAI,EAAM,EACf,EAAO,KAAK,EAAM;GAClB,EACK;GAkBI,KACX,MACqB;CACrB,IAAM,EACJ,aAAU,IACV,gBAAa,GACb,wBACE,GACE,IAAW,QACR,IAAI,IAAI,EAAiB,EAC/B,CAAC,EAAiB,CAAC,EAEhB,CAAC,GAAM,KAAW,QACjB,IAIE,EADQ,EAAoB,EACd,EAAQ,EAAS,GAH7B,EAAE,CAIX;CAkCF,AAhCA,QAAgB;EACd,IAAI,CAAC,GAAS;GACZ,EAAQ,EAAE,CAAC;GACX;;EAEF,GAAS,MAAS;GAChB,IAAM,IAAa,EAAc,GAAM,EAAS;GAChD,IAAI,EAAW,WAAW,EAAK,QAAQ;IACrC,IAAI,IAAY;IAChB,KAAK,IAAI,IAAQ,GAAG,IAAQ,EAAW,QAAQ,KAAS,GACtD,IAAI,EAAW,OAAW,EAAK,IAAQ;KACrC,IAAY;KACZ;;IAGJ,IAAI,GACF,OAAO;;GAGX,OAAO;IACP;IACD,CAAC,GAAS,EAAS,CAAC,EAEvB,QAAgB;EACd,IAAI,CAAC,GAAS;GACZ,EAAQ,EAAE,CAAC;GACX;;EAGF,EAAQ,EADO,EAAoB,EACb,EAAQ,EAAS,CAAC;IACvC;EAAC;EAAS;EAAY;EAAS,CAAC,EAEnC,QAAgB;EACV,OAAC,KAAW,OAAO,SAAW,MAGlC,IAAI;GACF,OAAO,aAAa,QAAQ,GAAY,KAAK,UAAU,EAAK,CAAC;UACvD;IAGP;EAAC;EAAS;EAAM;EAAW,CAAC;CAE/B,IAAM,IAAU,QACP,IAAI,IAAI,EAAK,EACnB,CAAC,EAAK,CAAC,EAEJ,IAAM,GACT,MAAe;EACT,KAGA,EAAS,IAAI,EAAG,IAGrB,GAAS,MACH,EAAK,SAAS,EAAG,GACZ,IAEF,CAAC,GAAG,GAAM,EAAG,CACpB;IAEJ,CAAC,GAAS,EAAS,CACpB,EAEK,IAAQ,GACX,MAAe;EACT,KAGL,GAAS,MACA,EAAK,QAAQ,MACX,MAAU,EACjB,CACF;IAEJ,CAAC,EAAQ,CACV,EAEK,IAAS,GACZ,MAAe;EACd,AAAI,EAAQ,IAAI,EAAG,GACjB,EAAM,EAAG,GAET,EAAI,EAAG;IAGX;EAAC;EAAK;EAAS;EAAM,CACtB,EAEK,IAAU,GACb,GAAgB,MAAiB;EAC3B,KAGD,MAAW,KAGf,GAAS,MAAS;GAChB,IAAM,IAAY,EAAK,QAAQ,EAAO,EAChC,IAAU,EAAK,QAAQ,EAAK;GAIlC,IAHI,MAAc,MAAM,MAAY,MAGhC,MAAc,GAChB,OAAO;GAET,IAAM,IAAO,CAAC,GAAG,EAAK;GAGtB,OAFA,EAAK,OAAO,GAAW,EAAE,EACzB,EAAK,OAAO,GAAS,GAAG,EAAO,EACxB;IACP;IAEJ,CAAC,EAAQ,CACV;CASD,OAAO;EACL;EACA,UATe,GACd,MACQ,EAAQ,IAAI,EAAG,EAExB,CAAC,EAAQ,CAKT;EACA;EACA;EACA;EACA;EACD;GAGU,IAAS;CACpB;CACA;CACD"}

package/lib/esm/hooks/useConditionalSubscription.js

@@ -0,0 +1,63 @@
+import { getRelayTransportSnapshot as e, subscribeRelayTransport as t } from "../relay/environment.js";
+import { useCallback as n, useEffect as r, useMemo as i, useRef as a, useState as o, useSyncExternalStore as s } from "react";
+import * as c from "react-relay";
+//#region src/hooks/useConditionalSubscription.ts
+var l = [];
+function u() {
+	return Reflect.get(c, "default") ?? c;
+}
+var d = u();
+function f(c, u) {
+	let f = d.useRelayEnvironment(), [p, m] = o(null), [h, g] = o(!1), [_, v] = o(!1), y = s(t, () => e().generation, () => e().generation), { enabled: b = !0, deps: x = l, getVariables: S } = u, C = n(() => {
+		try {
+			return S == null ? c.variables : S();
+		} catch {
+			return null;
+		}
+	}, [c.variables, S]), w = i(() => C(), [C]), T = i(() => {
+		if (w == null) return null;
+		try {
+			return JSON.stringify(w);
+		} catch {
+			return null;
+		}
+	}, [w]), E = !!b, D = E && w != null && h && p == null && !_, O = a(null);
+	return r(() => {
+		let e = null, t = C();
+		return E && t != null && (m(null), v(!1), g(!0), e = d.requestSubscription(f, {
+			subscription: c.subscription,
+			variables: t,
+			cacheConfig: c.cacheConfig,
+			configs: c.configs,
+			onCompleted: () => {
+				v(!0), g(!1), c.onCompleted?.();
+			},
+			onError: (e) => {
+				m(e), g(!1), c.onError?.(e);
+			},
+			onNext: c.onNext,
+			updater: c.updater
+		}), O.current = e), () => {
+			if (g(!1), e != null) try {
+				e.dispose();
+			} catch {}
+			O.current === e && (O.current = null);
+		};
+	}, [
+		c,
+		x,
+		f,
+		E,
+		C,
+		T,
+		y
+	]), {
+		active: D,
+		completed: _,
+		error: p
+	};
+}
+//#endregion
+export { f as useConditionalSubscription };
+
+//# sourceMappingURL=useConditionalSubscription.js.map

package/lib/esm/hooks/useConditionalSubscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConditionalSubscription.js","names":[],"sources":["../../../src/hooks/useConditionalSubscription.ts"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from 'react';\nimport * as ReactRelay from 'react-relay';\nimport type { GraphQLSubscriptionConfig, OperationType } from 'relay-runtime';\n\nimport {\n  getRelayTransportSnapshot,\n  subscribeRelayTransport,\n} from '../relay/environment.js';\n\ntype ConditionalOptions<T extends OperationType> = {\n  enabled: boolean;\n  deps?: readonly unknown[];\n  getVariables?: () => T['variables'];\n};\n\ntype UseConditionalSubscriptionReturn = {\n  active: boolean;\n  completed: boolean;\n  error: Error | null;\n};\n\ntype Hop = { dispose: () => void } | null;\n\nconst EMPTY_DEPS: readonly unknown[] = [];\n\n/** Resolve the Relay module regardless of whether the package exposes a default export shim. */\nfunction resolveRelayApi(): typeof ReactRelay {\n  const relayDefault: unknown = Reflect.get(ReactRelay, 'default');\n  if (relayDefault != null) {\n    return relayDefault as typeof ReactRelay;\n  }\n  return ReactRelay;\n}\n\nconst relayApi = resolveRelayApi();\n\n/** Subscribe only when the caller enables the subscription and variables exist. */\nexport function useConditionalSubscription<T extends OperationType>(\n  config: GraphQLSubscriptionConfig<T>,\n  options: ConditionalOptions<T>,\n): UseConditionalSubscriptionReturn {\n  const environment = relayApi.useRelayEnvironment();\n  const [error, setError] = useState<Error | null>(null);\n  const [isSubscribed, setIsSubscribed] = useState(false);\n  const [completed, setCompleted] = useState(false);\n  const transportGeneration = useSyncExternalStore(\n    subscribeRelayTransport,\n    () => {\n      return getRelayTransportSnapshot().generation;\n    },\n    () => {\n      return getRelayTransportSnapshot().generation;\n    },\n  );\n\n  const { enabled = true, deps = EMPTY_DEPS, getVariables } = options;\n\n  const resolveVariables = useCallback((): T['variables'] | null => {\n    try {\n      if (getVariables != null) {\n        return getVariables();\n      }\n      return config.variables;\n    } catch {\n      return null;\n    }\n  }, [config.variables, getVariables]);\n\n  const resolvedVariables = useMemo<T['variables'] | null>(() => {\n    return resolveVariables();\n  }, [resolveVariables]);\n\n  const stableVarsString = useMemo(() => {\n    if (resolvedVariables == null) {\n      return null;\n    }\n    try {\n      return JSON.stringify(resolvedVariables);\n    } catch {\n      return null;\n    }\n  }, [resolvedVariables]);\n\n  const isEnabled = Boolean(enabled);\n  const variables = resolvedVariables;\n  const canSubscribe = isEnabled && variables != null;\n  const active = canSubscribe && isSubscribed && error == null && !completed;\n\n  const disposableRef = useRef<Hop>(null);\n\n  useEffect(() => {\n    let disposable: Hop = null;\n    const variables = resolveVariables();\n\n    if (isEnabled && variables != null) {\n      setError(null);\n      setCompleted(false);\n      setIsSubscribed(true);\n\n      disposable = relayApi.requestSubscription<T>(environment, {\n        subscription: config.subscription,\n        variables,\n        cacheConfig: config.cacheConfig,\n        configs: config.configs,\n        onCompleted: () => {\n          setCompleted(true);\n          setIsSubscribed(false);\n          config.onCompleted?.();\n        },\n        onError: (nextError) => {\n          setError(nextError);\n          setIsSubscribed(false);\n          config.onError?.(nextError);\n        },\n        onNext: config.onNext,\n        updater: config.updater,\n      });\n\n      disposableRef.current = disposable;\n    }\n\n    return () => {\n      setIsSubscribed(false);\n      if (disposable != null) {\n        try {\n          disposable.dispose();\n        } catch {\n          // ignore cleanup failures\n        }\n      }\n      if (disposableRef.current === disposable) {\n        disposableRef.current = null;\n      }\n    };\n  }, [\n    config,\n    deps,\n    environment,\n    isEnabled,\n    resolveVariables,\n    stableVarsString,\n    transportGeneration,\n  ]);\n\n  return { active, completed, error };\n}\n"],"mappings":";;;;AA8BA,IAAM,IAAiC,EAAE;AAGzC,SAAS,IAAqC;CAK5C,OAJ8B,QAAQ,IAAI,GAAY,UAClD,IAGG;;AAGT,IAAM,IAAW,GAAiB;AAGlC,SAAgB,EACd,GACA,GACkC;CAClC,IAAM,IAAc,EAAS,qBAAqB,EAC5C,CAAC,GAAO,KAAY,EAAuB,KAAK,EAChD,CAAC,GAAc,KAAmB,EAAS,GAAM,EACjD,CAAC,GAAW,KAAgB,EAAS,GAAM,EAC3C,IAAsB,EAC1B,SAES,GAA2B,CAAC,kBAG5B,GAA2B,CAAC,WAEtC,EAEK,EAAE,aAAU,IAAM,UAAO,GAAY,oBAAiB,GAEtD,IAAmB,QAAyC;EAChE,IAAI;GAIF,OAHI,KAAgB,OAGb,EAAO,YAFL,GAAc;UAGjB;GACN,OAAO;;IAER,CAAC,EAAO,WAAW,EAAa,CAAC,EAE9B,IAAoB,QACjB,GAAkB,EACxB,CAAC,EAAiB,CAAC,EAEhB,IAAmB,QAAc;EACrC,IAAI,KAAqB,MACvB,OAAO;EAET,IAAI;GACF,OAAO,KAAK,UAAU,EAAkB;UAClC;GACN,OAAO;;IAER,CAAC,EAAkB,CAAC,EAEjB,IAAY,EAAQ,GAGpB,IADe,KAAa,KAAa,QAChB,KAAgB,KAAS,QAAQ,CAAC,GAE3D,IAAgB,EAAY,KAAK;CAwDvC,OAtDA,QAAgB;EACd,IAAI,IAAkB,MAChB,IAAY,GAAkB;EA6BpC,OA3BI,KAAa,KAAa,SAC5B,EAAS,KAAK,EACd,EAAa,GAAM,EACnB,EAAgB,GAAK,EAErB,IAAa,EAAS,oBAAuB,GAAa;GACxD,cAAc,EAAO;GACrB;GACA,aAAa,EAAO;GACpB,SAAS,EAAO;GAChB,mBAAmB;IAGjB,AAFA,EAAa,GAAK,EAClB,EAAgB,GAAM,EACtB,EAAO,eAAe;;GAExB,UAAU,MAAc;IAGtB,AAFA,EAAS,EAAU,EACnB,EAAgB,GAAM,EACtB,EAAO,UAAU,EAAU;;GAE7B,QAAQ,EAAO;GACf,SAAS,EAAO;GACjB,CAAC,EAEF,EAAc,UAAU,UAGb;GAEX,IADA,EAAgB,GAAM,EAClB,KAAc,MAChB,IAAI;IACF,EAAW,SAAS;WACd;GAIV,AAAI,EAAc,YAAY,MAC5B,EAAc,UAAU;;IAG3B;EACD;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,EAEK;EAAE;EAAQ;EAAW;EAAO"}

package/lib/esm/hooks/useCopyToClipboard.js

@@ -0,0 +1,31 @@
+import { useCallback as e, useEffect as t, useRef as n, useState as r } from "react";
+//#region src/hooks/useCopyToClipboard.ts
+var i = "copy-to-clipboard-fallback";
+function a(e) {
+	if (typeof document > "u") return;
+	let t = document.getElementById(i);
+	t ?? (t = document.createElement("textarea"), t.id = i, t.setAttribute("readonly", ""), t.style.position = "absolute", t.style.left = "-9999px", t.style.top = "0", t.style.opacity = "0", document.body.appendChild(t)), t.value = e, t.select(), document.execCommand("copy");
+}
+function o(i = 2e3) {
+	let [o, s] = r(null), c = n(null);
+	return t(() => () => {
+		c.current != null && window.clearTimeout(c.current);
+	}, []), {
+		copiedKey: o,
+		copy: e(async (e, t) => {
+			let n = !1, r;
+			if (typeof navigator < "u" && (r = navigator.clipboard), r != null) try {
+				await r.writeText(e), n = !0;
+			} catch {
+				n = !1;
+			}
+			return n ||= (a(e), !0), t != null && (s(t), c.current != null && window.clearTimeout(c.current), c.current = window.setTimeout(() => {
+				s(null), c.current = null;
+			}, i)), n;
+		}, [i])
+	};
+}
+//#endregion
+export { o as default, o as useCopyToClipboard };
+
+//# sourceMappingURL=useCopyToClipboard.js.map

package/lib/esm/hooks/useCopyToClipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopyToClipboard.js","names":[],"sources":["../../../src/hooks/useCopyToClipboard.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\nconst FALLBACK_TEXTAREA_ID = 'copy-to-clipboard-fallback';\n\n/** Write to the clipboard via a hidden textarea when the Clipboard API is unavailable. */\nfunction writeWithFallback(value: string): void {\n  if (typeof document === 'undefined') {\n    return;\n  }\n\n  let textarea = document.getElementById(\n    FALLBACK_TEXTAREA_ID,\n  ) as HTMLTextAreaElement | null;\n\n  if (textarea == null) {\n    textarea = document.createElement('textarea');\n    textarea.id = FALLBACK_TEXTAREA_ID;\n    textarea.setAttribute('readonly', '');\n    textarea.style.position = 'absolute';\n    textarea.style.left = '-9999px';\n    textarea.style.top = '0';\n    textarea.style.opacity = '0';\n    document.body.appendChild(textarea);\n  }\n\n  textarea.value = value;\n  textarea.select();\n  document.execCommand('copy');\n}\n\n/** Copy text with best-effort browser fallback and short-lived copied state. */\nexport function useCopyToClipboard(timeoutMs = 2000): {\n  copiedKey: string | null;\n  copy: (value: string, key?: string) => Promise<boolean>;\n} {\n  const [copiedKey, setCopiedKey] = useState<string | null>(null);\n  const timeoutRef = useRef<number | null>(null);\n\n  useEffect(() => {\n    return () => {\n      if (timeoutRef.current != null) {\n        window.clearTimeout(timeoutRef.current);\n      }\n    };\n  }, []);\n\n  const copy = useCallback(\n    async (value: string, key?: string): Promise<boolean> => {\n      let succeeded = false;\n\n      let clipboard: Clipboard | undefined;\n      if (typeof navigator !== 'undefined') {\n        clipboard = navigator.clipboard;\n      }\n\n      if (clipboard != null) {\n        try {\n          await clipboard.writeText(value);\n          succeeded = true;\n        } catch {\n          succeeded = false;\n        }\n      }\n\n      if (!succeeded) {\n        writeWithFallback(value);\n        succeeded = true;\n      }\n\n      if (key != null) {\n        setCopiedKey(key);\n        if (timeoutRef.current != null) {\n          window.clearTimeout(timeoutRef.current);\n        }\n        timeoutRef.current = window.setTimeout(() => {\n          setCopiedKey(null);\n          timeoutRef.current = null;\n        }, timeoutMs);\n      }\n\n      return succeeded;\n    },\n    [timeoutMs],\n  );\n\n  return { copiedKey, copy };\n}\n\nexport default useCopyToClipboard;\n"],"mappings":";;AAEA,IAAM,IAAuB;AAG7B,SAAS,EAAkB,GAAqB;CAC9C,IAAI,OAAO,WAAa,KACtB;CAGF,IAAI,IAAW,SAAS,eACtB,EACD;CAeD,AAbI,MACF,IAAW,SAAS,cAAc,WAAW,EAC7C,EAAS,KAAK,GACd,EAAS,aAAa,YAAY,GAAG,EACrC,EAAS,MAAM,WAAW,YAC1B,EAAS,MAAM,OAAO,WACtB,EAAS,MAAM,MAAM,KACrB,EAAS,MAAM,UAAU,KACzB,SAAS,KAAK,YAAY,EAAS,GAGrC,EAAS,QAAQ,GACjB,EAAS,QAAQ,EACjB,SAAS,YAAY,OAAO;;AAI9B,SAAgB,EAAmB,IAAY,KAG7C;CACA,IAAM,CAAC,GAAW,KAAgB,EAAwB,KAAK,EACzD,IAAa,EAAsB,KAAK;CAiD9C,OA/CA,cACe;EACX,AAAI,EAAW,WAAW,QACxB,OAAO,aAAa,EAAW,QAAQ;IAG1C,EAAE,CAAC,EAyCC;EAAE;EAAW,MAvCP,EACX,OAAO,GAAe,MAAmC;GACvD,IAAI,IAAY,IAEZ;GAKJ,IAJI,OAAO,YAAc,QACvB,IAAY,UAAU,YAGpB,KAAa,MACf,IAAI;IAEF,AADA,MAAM,EAAU,UAAU,EAAM,EAChC,IAAY;WACN;IACN,IAAY;;GAoBhB,OAhBA,AAEE,OADA,EAAkB,EAAM,EACZ,KAGV,KAAO,SACT,EAAa,EAAI,EACb,EAAW,WAAW,QACxB,OAAO,aAAa,EAAW,QAAQ,EAEzC,EAAW,UAAU,OAAO,iBAAiB;IAE3C,AADA,EAAa,KAAK,EAClB,EAAW,UAAU;MACpB,EAAU,GAGR;KAET,CAAC,EAAU,CAGO;EAAM"}

package/lib/esm/hooks/useInfiniteConnection.js

@@ -0,0 +1,95 @@
+import { startTransition as e, useCallback as t, useEffect as n, useMemo as r, useRef as i, useState as a } from "react";
+//#region src/hooks/useInfiniteConnection.ts
+var o = ({ nodes: o, hasNext: s, isLoadingNext: c, runLoadMore: l, surface: u = "unknown", timeoutMs: d = 15e3, onTelemetry: f, onUiError: p, onError: m }) => {
+	let [h, g] = a(null), _ = i(!1), v = i(null), y = i(0), b = t(() => {
+		v.current != null && (clearTimeout(v.current), v.current = null);
+	}, []);
+	n(() => () => {
+		b();
+	}, [b]);
+	let x = t(() => {
+		if (!s || c || _.current) return;
+		_.current = !0;
+		let t = y.current + 1;
+		y.current = t, g(null);
+		let n = Date.now();
+		f?.("list_load_more_requested", {
+			surface: u,
+			loadedCount: o.length
+		}), b(), v.current = setTimeout(() => {
+			y.current === t && (y.current = t + 1, _.current = !1, g(/* @__PURE__ */ Error("timeout")), f?.("list_load_more_failed", {
+				surface: u,
+				durationMs: d
+			}), m?.({
+				scope: "infinite_scroll_timeout",
+				message: "Load more timed out",
+				payload: {
+					surface: u,
+					durationMs: d
+				}
+			}), p?.("infinite_scroll_timeout", "Load more timed out", {
+				surface: u,
+				durationMs: d
+			}));
+		}, d), e(() => {
+			l((e) => {
+				if (y.current !== t) return;
+				y.current = t + 1, _.current = !1, b();
+				let r = Date.now() - n;
+				if (e != null) {
+					g(e), f?.("list_load_more_failed", {
+						surface: u,
+						durationMs: r
+					}), m?.({
+						scope: "infinite_scroll",
+						message: e.message,
+						payload: {
+							surface: u,
+							durationMs: r
+						}
+					}), p?.("infinite_scroll", e.message, {
+						surface: u,
+						durationMs: r
+					});
+					return;
+				}
+				f?.("list_load_more_succeeded", {
+					surface: u,
+					durationMs: r
+				});
+			});
+		});
+	}, [
+		b,
+		s,
+		c,
+		o.length,
+		m,
+		f,
+		p,
+		l,
+		u,
+		d
+	]), S = t(() => {
+		x();
+	}, [x]);
+	return r(() => ({
+		nodes: o,
+		hasNext: s,
+		isLoadingNext: c,
+		incrementalError: h,
+		loadMoreSafe: x,
+		retryLoadMore: S
+	}), [
+		o,
+		s,
+		c,
+		h,
+		x,
+		S
+	]);
+};
+//#endregion
+export { o as default, o as useInfiniteConnection };
+
+//# sourceMappingURL=useInfiniteConnection.js.map

package/lib/esm/hooks/useInfiniteConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInfiniteConnection.js","names":[],"sources":["../../../src/hooks/useInfiniteConnection.ts"],"sourcesContent":["import {\n  startTransition,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\n\nexport type LoadMoreRunner = (\n  onComplete: (error: Error | null) => void,\n) => void;\n\nexport type InfiniteConnectionTelemetryPayload = {\n  surface: string;\n  loadedCount?: number;\n  durationMs?: number;\n};\n\nexport type InfiniteConnectionTelemetryEvent =\n  | 'list_load_more_requested'\n  | 'list_load_more_failed'\n  | 'list_load_more_succeeded';\n\nexport type InfiniteConnectionErrorEvent = {\n  scope: 'infinite_scroll' | 'infinite_scroll_timeout';\n  message: string;\n  payload: {\n    surface: string;\n    durationMs: number;\n  };\n};\n\nexport type UseInfiniteConnectionParams<TNode> = {\n  nodes: readonly TNode[];\n  hasNext: boolean;\n  isLoadingNext: boolean;\n  runLoadMore: LoadMoreRunner;\n  surface?: string;\n  timeoutMs?: number;\n  onTelemetry?: (\n    event: InfiniteConnectionTelemetryEvent,\n    payload: InfiniteConnectionTelemetryPayload,\n  ) => void;\n  onUiError?: (\n    scope: InfiniteConnectionErrorEvent['scope'],\n    message: string,\n    payload: InfiniteConnectionErrorEvent['payload'],\n  ) => void;\n  onError?: (event: InfiniteConnectionErrorEvent) => void;\n};\n\nexport type UseInfiniteConnectionResult<TNode> = {\n  nodes: readonly TNode[];\n  hasNext: boolean;\n  isLoadingNext: boolean;\n  incrementalError: Error | null;\n  loadMoreSafe: () => void;\n  retryLoadMore: () => void;\n};\n\nexport const useInfiniteConnection = <TNode>({\n  nodes,\n  hasNext,\n  isLoadingNext,\n  runLoadMore,\n  surface = 'unknown',\n  timeoutMs = 15_000,\n  onTelemetry,\n  onUiError,\n  onError,\n}: UseInfiniteConnectionParams<TNode>): UseInfiniteConnectionResult<TNode> => {\n  const [incrementalError, setIncrementalError] = useState<Error | null>(null);\n  const inFlightRef = useRef(false);\n  const timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const requestTokenRef = useRef(0);\n\n  const clearPendingTimeout = useCallback(() => {\n    if (timeoutRef.current == null) {\n      return;\n    }\n    clearTimeout(timeoutRef.current);\n    timeoutRef.current = null;\n  }, []);\n\n  useEffect(() => {\n    return () => {\n      clearPendingTimeout();\n    };\n  }, [clearPendingTimeout]);\n\n  const loadMoreSafe = useCallback(() => {\n    if (!hasNext || isLoadingNext || inFlightRef.current) {\n      return;\n    }\n    inFlightRef.current = true;\n    const requestToken = requestTokenRef.current + 1;\n    requestTokenRef.current = requestToken;\n    setIncrementalError(null);\n    const startedAt = Date.now();\n    onTelemetry?.('list_load_more_requested', {\n      surface,\n      loadedCount: nodes.length,\n    });\n    clearPendingTimeout();\n    timeoutRef.current = setTimeout(() => {\n      if (requestTokenRef.current !== requestToken) {\n        return;\n      }\n      requestTokenRef.current = requestToken + 1;\n      inFlightRef.current = false;\n      setIncrementalError(new Error('timeout'));\n      onTelemetry?.('list_load_more_failed', {\n        surface,\n        durationMs: timeoutMs,\n      });\n      onError?.({\n        scope: 'infinite_scroll_timeout',\n        message: 'Load more timed out',\n        payload: {\n          surface,\n          durationMs: timeoutMs,\n        },\n      });\n      onUiError?.('infinite_scroll_timeout', 'Load more timed out', {\n        surface,\n        durationMs: timeoutMs,\n      });\n    }, timeoutMs);\n\n    startTransition(() => {\n      runLoadMore((error) => {\n        if (requestTokenRef.current !== requestToken) {\n          return;\n        }\n        requestTokenRef.current = requestToken + 1;\n        inFlightRef.current = false;\n        clearPendingTimeout();\n        const durationMs = Date.now() - startedAt;\n        if (error != null) {\n          setIncrementalError(error);\n          onTelemetry?.('list_load_more_failed', {\n            surface,\n            durationMs,\n          });\n          onError?.({\n            scope: 'infinite_scroll',\n            message: error.message,\n            payload: {\n              surface,\n              durationMs,\n            },\n          });\n          onUiError?.('infinite_scroll', error.message, {\n            surface,\n            durationMs,\n          });\n          return;\n        }\n        onTelemetry?.('list_load_more_succeeded', {\n          surface,\n          durationMs,\n        });\n      });\n    });\n  }, [\n    clearPendingTimeout,\n    hasNext,\n    isLoadingNext,\n    nodes.length,\n    onError,\n    onTelemetry,\n    onUiError,\n    runLoadMore,\n    surface,\n    timeoutMs,\n  ]);\n\n  const retryLoadMore = useCallback(() => {\n    loadMoreSafe();\n  }, [loadMoreSafe]);\n\n  return useMemo(() => {\n    return {\n      nodes,\n      hasNext,\n      isLoadingNext,\n      incrementalError,\n      loadMoreSafe,\n      retryLoadMore,\n    };\n  }, [\n    nodes,\n    hasNext,\n    isLoadingNext,\n    incrementalError,\n    loadMoreSafe,\n    retryLoadMore,\n  ]);\n};\n\nexport default useInfiniteConnection;\n"],"mappings":";;AA6DA,IAAa,KAAgC,EAC3C,UACA,YACA,kBACA,gBACA,aAAU,WACV,eAAY,MACZ,gBACA,cACA,iBAC4E;CAC5E,IAAM,CAAC,GAAkB,KAAuB,EAAuB,KAAK,EACtE,IAAc,EAAO,GAAM,EAC3B,IAAa,EAA6C,KAAK,EAC/D,IAAkB,EAAO,EAAE,EAE3B,IAAsB,QAAkB;EACxC,EAAW,WAAW,SAG1B,aAAa,EAAW,QAAQ,EAChC,EAAW,UAAU;IACpB,EAAE,CAAC;CAEN,cACe;EACX,GAAqB;IAEtB,CAAC,EAAoB,CAAC;CAEzB,IAAM,IAAe,QAAkB;EACrC,IAAI,CAAC,KAAW,KAAiB,EAAY,SAC3C;EAEF,EAAY,UAAU;EACtB,IAAM,IAAe,EAAgB,UAAU;EAE/C,AADA,EAAgB,UAAU,GAC1B,EAAoB,KAAK;EACzB,IAAM,IAAY,KAAK,KAAK;EA+B5B,AA9BA,IAAc,4BAA4B;GACxC;GACA,aAAa,EAAM;GACpB,CAAC,EACF,GAAqB,EACrB,EAAW,UAAU,iBAAiB;GAChC,EAAgB,YAAY,MAGhC,EAAgB,UAAU,IAAe,GACzC,EAAY,UAAU,IACtB,EAAoB,gBAAI,MAAM,UAAU,CAAC,EACzC,IAAc,yBAAyB;IACrC;IACA,YAAY;IACb,CAAC,EACF,IAAU;IACR,OAAO;IACP,SAAS;IACT,SAAS;KACP;KACA,YAAY;KACb;IACF,CAAC,EACF,IAAY,2BAA2B,uBAAuB;IAC5D;IACA,YAAY;IACb,CAAC;KACD,EAAU,EAEb,QAAsB;GACpB,GAAa,MAAU;IACrB,IAAI,EAAgB,YAAY,GAC9B;IAIF,AAFA,EAAgB,UAAU,IAAe,GACzC,EAAY,UAAU,IACtB,GAAqB;IACrB,IAAM,IAAa,KAAK,KAAK,GAAG;IAChC,IAAI,KAAS,MAAM;KAcjB,AAbA,EAAoB,EAAM,EAC1B,IAAc,yBAAyB;MACrC;MACA;MACD,CAAC,EACF,IAAU;MACR,OAAO;MACP,SAAS,EAAM;MACf,SAAS;OACP;OACA;OACD;MACF,CAAC,EACF,IAAY,mBAAmB,EAAM,SAAS;MAC5C;MACA;MACD,CAAC;KACF;;IAEF,IAAc,4BAA4B;KACxC;KACA;KACD,CAAC;KACF;IACF;IACD;EACD;EACA;EACA;EACA,EAAM;EACN;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,EAEI,IAAgB,QAAkB;EACtC,GAAc;IACb,CAAC,EAAa,CAAC;CAElB,OAAO,SACE;EACL;EACA;EACA;EACA;EACA;EACA;EACD,GACA;EACD;EACA;EACA;EACA;EACA;EACA;EACD,CAAC"}