@qoretechnologies/reqraft 0.10.62 → 0.10.63-pr.142.g0b675cd

package/src/hooks/useArgSchema.ts

@@ -1,37 +0,0 @@
-import { IQorusFormSchema } from '@qoretechnologies/ts-toolkit';
-import { useEffect, useState } from 'react';
-import { useFetch } from './useFetch/useFetch';
-
-export type TArgSchema = string | IQorusFormSchema | undefined;
-
-/**
- * Resolves an arg_schema value that is either:
- * - a string → fetch from /dataprovider/arg_schemas/{arg_schema}
- * - an object → use directly
- * - undefined → no schema
- */
-export const useArgSchema = (argSchema: TArgSchema) => {
-  const isUrl = typeof argSchema === 'string';
-  const [finalSchema, setFinalSchema] = useState<IQorusFormSchema | undefined>(
-    isUrl ? undefined : (argSchema as IQorusFormSchema | undefined)
-  );
-
-  const { data, loading, load } = useFetch<IQorusFormSchema>({
-    url: `/dataprovider/arg_schemas/${argSchema}`,
-    loadOnMount: isUrl,
-  });
-
-  useEffect(() => {
-    if (isUrl) {
-      setFinalSchema(data);
-    } else {
-      setFinalSchema(argSchema as IQorusFormSchema | undefined);
-    }
-  }, [isUrl, JSON.stringify(argSchema), JSON.stringify(data)]);
-
-  return {
-    schema: finalSchema,
-    loading: isUrl && loading,
-    retry: load,
-  };
-};

package/src/hooks/useCoarsePointer.ts

@@ -1,30 +0,0 @@
-// Copyright 2026 Qore Technologies, s.r.o.
-import { useEffect, useState } from 'react';
-
-/** The pointer a finger is: it cannot hover. */
-export const COARSE_POINTER_QUERY = '(pointer: coarse)';
-
-/**
- * Whether the primary pointer is coarse (a finger), from the media query itself.
- *
- * Starts `false` and settles after mount, so a server render and the first paint agree.
- */
-export const useCoarsePointer = (): boolean => {
-  const [coarse, setCoarse] = useState<boolean>(false);
-
-  useEffect(() => {
-    if (typeof window === 'undefined' || !window.matchMedia) {
-      return undefined;
-    }
-
-    const query = window.matchMedia(COARSE_POINTER_QUERY);
-    const sync = () => setCoarse(query.matches);
-
-    sync();
-    query.addEventListener?.('change', sync);
-
-    return () => query.removeEventListener?.('change', sync);
-  }, []);
-
-  return coarse;
-};

package/src/hooks/useFetch/useFetch.stories.tsx

@@ -1,379 +0,0 @@
-import { ReqoreSpinner, ReqoreTree } from '@qoretechnologies/reqore';
-import { StoryObj } from '@storybook/react-vite';
-import { testsWaitForText } from '../../../__tests__/utils';
-import { storyApiUrl } from '../../stories/storyNetwork';
-import { StoryMeta } from '../../types';
-import { useFetch } from './useFetch';
-
-const meta = {
-  title: 'Hooks/useFetch',
-  render: (args) => {
-    const {
-      data = {},
-      errorData,
-      load,
-      loading,
-    } = useFetch<any>({ url: 'public/info', method: args.method, loadOnMount: true });
-
-    return loading ? (
-      <ReqoreSpinner />
-    ) : (
-      <>
-        <ReqoreTree
-          data={errorData || data}
-          bottomActions={[{ label: 'Refetch', onClick: load }]}
-        />
-      </>
-    );
-  },
-} as StoryMeta<any>;
-
-export default meta;
-export type Story = StoryObj<typeof meta>;
-
-export const Get: Story = {
-  args: {
-    method: 'GET',
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          'Renders a useFetch demo that issues a GET against /public/info on mount and displays the returned Qorus system info as a tree.',
-      },
-    },
-    mockData: [
-      {
-        // An array of mock objects which will add in every story
-        url: storyApiUrl('public/info'),
-        method: 'GET',
-        status: 200,
-        delay: 200,
-        response: {
-          'instance-key': 'rippy-dev1',
-          'omq-version': '6.1.0_prod',
-          'omq-build': 'd115c45fbed95c03327aea880be455137e9778ba',
-          'qore-version': '2.0.0',
-          'omq-schema': 'omq@omq',
-          edition: 'Enterprise',
-          tz_region: 'Europe/Prague',
-          tz_utc_offset: 3600,
-          noauth: false,
-        },
-      },
-    ],
-  },
-  play: async () => {
-    await testsWaitForText('"rippy-dev1"');
-  },
-};
-
-export const Put: Story = {
-  args: {
-    method: 'PUT',
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          'Renders a useFetch demo that issues a PUT against /public/info on mount and displays the returned success status.',
-      },
-    },
-    mockData: [
-      {
-        // An array of mock objects which will add in every story
-        url: storyApiUrl('public/info'),
-        method: 'PUT',
-        status: 200,
-        response: {
-          status: 'Successfuly updated',
-        },
-      },
-    ],
-  },
-  play: async () => {
-    await testsWaitForText('"Successfuly updated"');
-  },
-};
-
-export const Post: Story = {
-  args: {
-    method: 'POST',
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          'Renders a useFetch demo that issues a POST against /public/info on mount and displays the returned success status.',
-      },
-    },
-    mockData: [
-      {
-        // An array of mock objects which will add in every story
-        url: storyApiUrl('public/info'),
-        method: 'POST',
-        status: 200,
-        response: {
-          status: 'Successfuly created',
-        },
-      },
-    ],
-  },
-  play: async () => {
-    await testsWaitForText('"Successfuly created"');
-  },
-};
-
-export const Del: Story = {
-  args: {
-    method: 'DELETE',
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          'Renders a useFetch demo that issues a DELETE against /public/info on mount and displays the returned success status.',
-      },
-    },
-    mockData: [
-      {
-        // An array of mock objects which will add in every story
-        url: storyApiUrl('public/info'),
-        method: 'DELETE',
-        status: 200,
-        response: {
-          status: 'Successfuly deleted',
-        },
-      },
-    ],
-  },
-  play: async () => {
-    await testsWaitForText('"Successfuly deleted"');
-  },
-};
-
-export const Error409: Story = {
-  args: {
-    method: 'POST',
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          'Renders a useFetch demo that issues a POST returning a 409 error — the hook exposes errorData and the Qorus stack trace is rendered in place of the response.',
-      },
-    },
-    mockData: [
-      {
-        // An array of mock objects which will add in every story
-        url: storyApiUrl('public/info'),
-        method: 'POST',
-        status: 409,
-        response: {
-          type: 'User',
-          file: 'AbstractQorusCoreService.qc',
-          line: 871,
-          endline: 871,
-          source: '',
-          offset: 0,
-          lang: 'Qore',
-          callstack: [
-            {
-              function: 'AbstractQorusCoreService::logRethrowException',
-              line: 984,
-              endline: 984,
-              file: '/export/home2/dnichols/src/Qorus/current/qlib/RestHandler.qm',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 3,
-              type: 'rethrow',
-            },
-            {
-              function: 'AbstractQorusCoreService::logRethrowException',
-              line: -1,
-              endline: -1,
-              file: '<builtin>',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 0,
-              type: 'user',
-              programid: 1,
-              statementid: 12282,
-            },
-            {
-              function: 'ServiceManagerBase::callMethod',
-              line: 3964,
-              endline: 3964,
-              file: 'QorusRestApiHandlerV8.qc',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 1,
-              type: 'builtin',
-              programid: 1,
-              statementid: 12282,
-            },
-            {
-              function: 'FsmsRestClassV8::doCreateFsmDraftFromText',
-              line: 3951,
-              endline: 3951,
-              file: 'QorusRestApiHandlerV8.qc',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 0,
-              type: 'user',
-              programid: 1,
-              statementid: 12266,
-            },
-            {
-              function: 'FsmsRestClassV8::postCreateDraftFromText',
-              line: -1,
-              endline: -1,
-              file: '<builtin>',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 0,
-              type: 'user',
-              programid: 20,
-              statementid: 28,
-            },
-            {
-              function: 'call_object_method_args',
-              line: 941,
-              endline: 941,
-              file: '/export/home2/dnichols/src/Qorus/current/qlib/RestHandler.qm',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 1,
-              type: 'builtin',
-              programid: 20,
-              statementid: 28,
-            },
-            {
-              function: 'AbstractRestClass::dispatch',
-              line: 1544,
-              endline: 1544,
-              file: 'QorusRestApiHandler.qc',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 0,
-              type: 'user',
-              programid: 1,
-              statementid: 22271,
-            },
-            {
-              function: 'QorusRestClass::dispatch',
-              line: 849,
-              endline: 849,
-              file: '/export/home2/dnichols/src/Qorus/current/qlib/RestHandler.qm',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 0,
-              type: 'user',
-              programid: 20,
-              statementid: 117,
-            },
-            {
-              function: 'AbstractRestClass::handleRequest',
-              line: 860,
-              endline: 860,
-              file: '/export/home2/dnichols/src/Qorus/current/qlib/RestHandler.qm',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 0,
-              type: 'user',
-              programid: 20,
-              statementid: 121,
-            },
-            {
-              function: 'AbstractRestClass::handleRequest',
-              line: 1569,
-              endline: 1569,
-              file: '/export/home2/dnichols/src/Qorus/current/qlib/RestHandler.qm',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 0,
-              type: 'user',
-              programid: 20,
-              statementid: 415,
-            },
-            {
-              function: 'RestHandler::dispatchRequest',
-              line: 1476,
-              endline: 1476,
-              file: '/export/home2/dnichols/src/Qorus/current/qlib/RestHandler.qm',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 0,
-              type: 'user',
-              programid: 20,
-              statementid: 270,
-            },
-            {
-              function: 'RestHandler::handleRequest',
-              line: 17303,
-              endline: 17303,
-              file: 'QorusRestApiHandler.qc',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 0,
-              type: 'user',
-              programid: 1,
-              statementid: 27032,
-            },
-            {
-              function: 'WebAppHandler::handleRequest',
-              line: 1781,
-              endline: 1781,
-              file: '/export/home2/dnichols/src/Qorus/current/qlib/HttpServer.qm',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 0,
-              type: 'user',
-              programid: 28,
-              statementid: 931,
-            },
-            {
-              function: 'HttpServer::handleRequest',
-              line: 2797,
-              endline: 2798,
-              file: '/export/home2/dnichols/src/Qorus/current/qlib/HttpServer.qm',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 0,
-              type: 'user',
-              programid: 28,
-              statementid: 346,
-            },
-            {
-              function: 'HttpListener::connectionThread',
-              line: 2599,
-              endline: 2599,
-              file: '/export/home2/dnichols/src/Qorus/current/qlib/HttpServer.qm',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 0,
-              type: 'user',
-              programid: 28,
-              statementid: 2,
-            },
-            {
-              function: 'HttpListener::<anonymous closure>',
-              line: -1,
-              endline: -1,
-              file: '<builtin>',
-              offset: 0,
-              lang: 'Qore',
-              typecode: 0,
-              type: 'user',
-            },
-          ],
-          err: 'ACTION-ERROR',
-          desc: 'system service: nli v6.1 (217):97 (Qore source "/export/home2/dnichols/src/Qorus/git/qorus/system/nli-v6.1.qsd":97) (while calling system.nli.buildFsm()): User exception: system service: nli v6.1 (217):97 (Qore source "/export/home2/dnichols/src/Qorus/git/qorus/system/nli-v6.1.qsd":97): ACTION-ERROR: Could not match any apps from the input\n  Nli::buildFsm() called at <builtin>:-1 (Qore user code)\n  call_object_method_args() called at LocalQorusService.qc:957 (Qore builtin code)\n  LocalQorusService::callMethodImpl() called at Service.qc:101 (Qore user code)\n  Service::callMethodImpl() called at <builtin>:-1 (Qore user code)\n  ServiceManagerBase::callMethod() called at QorusRestApiHandlerV8.qc:3964 (Qore builtin code)\n  FsmsRestClassV8::doCreateFsmDraftFromText() called at QorusRestApiHandlerV8.qc:3951 (Qore user code)\n  FsmsRestClassV8::postCreateDraftFromText() called at <builtin>:-1 (Qore user code)\n  call_object_method_args() called at /export/home2/dnichols/src/Qorus/current/qlib/RestHandler.qm:941 (Qore builtin code)\n  AbstractRestClass::dispatch() called at QorusRestApiHandler.qc:1544 (Qore user code)\n  QorusRestClass::dispatch() called at /export/home2/dnichols/src/Qorus/current/qlib/RestHandler.qm:849 (Qore user code)\n  AbstractRestClass::handleRequest() called at /export/home2/dnichols/src/Qorus/current/qlib/RestHandler.qm:860 (Qore user code)\n  AbstractRestClass::handleRequest() called at /export/home2/dnichols/src/Qorus/current/qlib/RestHandler.qm:1569 (Qore user code)\n  RestHandler::dispatchRequest() called at /export/home2/dnichols/src/Qorus/current/qlib/RestHandler.qm:1476 (Qore user code)\n  RestHandler::handleRequest() called at QorusRestApiHandler.qc:17303 (Qore user code)\n  WebAppHandler::handleRequest() called at /export/home2/dnichols/src/Qorus/current/qlib/HttpServer.qm:1781 (Qore user code)\n  HttpServer::handleRequest() called at /export/home2/dnichols/src/Qorus/current/qlib/HttpServer.qm:2797 (Qore user code)\n  HttpListener::connectionThread() called at /export/home2/dnichols/src/Qorus/current/qlib/HttpServer.qm:2599 (Qore user code)\n  HttpListener::<anonymous closure>() called at <builtin>:-1 (Qore user code)',
-        },
-      },
-    ],
-  },
-  play: async () => {
-    await testsWaitForText('"AbstractQorusCoreService.qc"');
-  },
-};

package/src/hooks/useFetch/useFetch.tsx

@@ -1,154 +0,0 @@
-import { QueryClient, useQueryClient } from '@tanstack/react-query';
-import { useCallback, useMemo, useState } from 'react';
-import { useEffectOnce } from 'react-use';
-import { useContextSelector } from 'use-context-selector';
-import { FetchContext } from '../../contexts/FetchContext';
-import { ReqraftQueryClient } from '../../providers/ReqraftProvider';
-import {
-  IReqraftFetchResponse,
-  IReqraftQueryConfig,
-  isQueryCancelled,
-  reqraftCacheKey,
-} from '../../utils/fetch';
-
-export interface IReqraftUseFetch<T> {
-  data: T | undefined;
-  loading: boolean;
-  load: () => Promise<T>;
-  error: Error | undefined;
-  errorData?: any;
-}
-
-export interface IReqraftUseFetchOptions<T> extends IReqraftQueryConfig {
-  defaultData?: T;
-  loadOnMount?: boolean;
-}
-
-export function useFetch<T>({
-  url,
-  method = 'GET',
-  body,
-  cache,
-  defaultData,
-  loadOnMount,
-  noApiPrefix,
-}: IReqraftUseFetchOptions<T>) {
-  const query = useContextSelector(FetchContext, (context) => {
-    switch (method) {
-      case 'GET':
-        return context.get;
-      case 'POST':
-        return context.post;
-      case 'PUT':
-        return context.put;
-      case 'DELETE':
-        return context.del;
-      default:
-        throw new Error('Invalid method');
-    }
-  });
-
-  /* An answer we ALREADY HAVE is not a loading state.
-     `loading` started at `loadOnMount` unconditionally, so every consumer that
-     mounted reported "loading" for at least one async turn even when the
-     response was sitting in the cache — and `FormEngine` renders its
-     `options-loading-skeleton` whenever any of its sources says that. So each
-     form appearing on a page flashed a skeleton whether or not anything was
-     actually fetched, which is what the repeated skeletons on an IDE page are:
-     measured on a fully warm SECOND visit to one page, three skeleton waves
-     against two requests, the last wave with no request anywhere near it.
-     Seeded from the query cache instead, so a resource already in hand renders
-     immediately. */
-  /* The provider is OPTIONAL here. `useQueryClient` THROWS when no
-     `QueryClientProvider` is above it, and plenty of consumers mount a form
-     with only a `FetchContext` — requiring one turned a rendering optimisation
-     into a hard dependency and took 131 tests down with it. `useContext` runs
-     before that throw, so hook order is unaffected and catching is safe. The
-     fallback is the same client `query` itself defaults to, so a cache hit is
-     found either way. */
-  let queryClient: QueryClient;
-  try {
-    queryClient = useQueryClient();
-  } catch {
-    queryClient = ReqraftQueryClient;
-  }
-
-  const cached = queryClient.getQueryData([
-    reqraftCacheKey({ url, method, body, noApiPrefix }),
-  ]) as { data?: T; ok?: boolean } | undefined;
-  const hasCachedAnswer = !!cached && cached.ok !== false && cached.data !== undefined;
-
-  const [loading, setLoading] = useState(!!loadOnMount && !hasCachedAnswer);
-  const [data, setData] = useState<T | undefined>(
-    hasCachedAnswer ? (cached?.data as T) : defaultData
-  );
-  const [response, setResponse] = useState<Response | undefined>();
-  const [error, setError] = useState<Error | undefined>();
-  const [errorData, setErrorData] = useState<any>();
-
-  const load = useCallback(
-    async ({
-      body: customBody,
-      mergeBodies,
-      silent,
-    }: {
-      body?: Record<string | number, any>;
-      mergeBodies?: boolean;
-      /** Revalidate without announcing a loading state — see the note above. */
-      silent?: boolean;
-    } = {}) => {
-      if (!silent) {
-        setLoading(true);
-      }
-
-      const _body = mergeBodies ? { ...body, ...customBody } : customBody || body;
-      let response: IReqraftFetchResponse<T>;
-
-      try {
-        response = await query<T>({ url, body: _body, cache, noApiPrefix });
-      } catch (error) {
-        if (!silent) {
-          setLoading(false);
-        }
-        /* An abandoned request (the query cache was cleared while it was in
-           flight) has no answer to keep: data and error stay as they were. It
-           used to reject out of the load-on-mount effect, unhandled - a story
-           runner reports that as the story failing - and left `loading` set. */
-        if (isQueryCancelled(error)) {
-          return;
-        }
-
-        throw error;
-      }
-
-      if (!silent) {
-        setLoading(false);
-      }
-
-      if (response.ok) {
-        setError(undefined);
-        setErrorData(undefined);
-        setData(response.data);
-      } else {
-        setError(response.error);
-        setErrorData(response.data);
-      }
-
-      setResponse(response.response);
-    },
-    [JSON.stringify(body), method, url, cache, noApiPrefix]
-  );
-
-  useEffectOnce(() => {
-    if (loadOnMount) {
-      // Still revalidates when the entry is cached — `query` honours its own
-      // staleness — but silently, so a cached answer never flashes a skeleton.
-      load({ silent: hasCachedAnswer });
-    }
-  });
-
-  return useMemo(
-    () => ({ data, loading, load, error, errorData, response }),
-    [JSON.stringify(data), loading, load, error, errorData, response]
-  );
-}

package/src/hooks/usePhoneViewport.ts

@@ -1,34 +0,0 @@
-import { useEffect, useState } from 'react';
-
-/** The width below which a surface takes its phone presentation; reqore's own breakpoint. */
-export const PHONE_VIEWPORT_QUERY = '(max-width: 480px)';
-
-/**
- * Phone-sized viewport, from the media query itself rather than reqore's
- * `isMobile` property. That property is pinned to `false` under
- * `NODE_ENV=test`, which is what a story run (and so every Qlip capture)
- * executes under, so a phone branch keyed on it never renders in a capture
- * and the story that exists to show it shows the desktop layout instead.
- *
- * Starts `false` and settles after mount, so a server render and the first
- * paint agree; pass `enabled: false` to skip the subscription entirely.
- */
-export const usePhoneViewport = (enabled = true): boolean => {
-  const [phone, setPhone] = useState<boolean>(false);
-
-  useEffect(() => {
-    if (!enabled || typeof window === 'undefined' || !window.matchMedia) {
-      return undefined;
-    }
-
-    const query = window.matchMedia(PHONE_VIEWPORT_QUERY);
-    const sync = () => setPhone(query.matches);
-
-    sync();
-    query.addEventListener('change', sync);
-
-    return () => query.removeEventListener('change', sync);
-  }, [enabled]);
-
-  return phone;
-};