runid-lys 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- `RouteProvider` exposing the active route, the route map and helpers via `useRouteInfo`, wiring page context and chatbot auto-open, and rendering project-supplied private/public templates
+- `useRouteAccess` hook centralizing route permission checks (supports `string` and `string[]` any-of semantics for `mainWebserviceName`)
+- Export `RouteProvider`, `useRouteInfo`, `useRouteAccess`, and related types (`RouteContextValue`, `RouteProviderProps`, `RouteTemplateProps`) from `runid-lys/providers`
+
+### Changed
+
+- `RouteInterface.mainWebserviceName` and `PageDescriptionType.mainWebserviceName` accept `string | string[]` (any-of) in addition to `string`
+- `useRestrictedLink` delegates permission checking to `useRouteAccess` so single/array semantics stay in one place
+
+### Fixed
+
+- Empty-string URL query params are no longer coerced to `0` when forwarded to the chatbot page context
+
+## [0.6.0] - 2026-05-14
+
+### Added
+
+- `ChatbotBehaviourType.autoOpenOnEnter` flag, mapped to `RouteInterface.autoOpenChatbot` by `generateRouteFromDescription`
+- `ChatbotBehaviourType.showWelcomeMessage` flag, mapped to `RouteInterface.showChatbotWelcome` (welcome message resolved against `<transPrefix>chatbotWelcome`)
+
 ## [0.5.0] - 2026-03-28
 
 ### Added

package/dist/{hooks-CvhFUowR.js → PublicAppTemplate-DLKcJZVR.js}

@@ -1,4 +1,6 @@
-import { createContext, useContext } from "react";
+import { jsx, Fragment } from "react/jsx-runtime";
+import { createContext, useContext, useEffect } from "react";
+import { Navigate } from "react-router-dom";
 const ChatbotContext = createContext(null);
 const useChatbot = () => {
   const context = useContext(ChatbotContext);
@@ -28,10 +30,29 @@ const ConnectedUserContext = createContext({
 function useConnectedUserInfo() {
   return useContext(ConnectedUserContext);
 }
+const PublicAppTemplate = ({
+  route,
+  defaultPrivateRoute,
+  children
+}) => {
+  var _a;
+  const { user } = useConnectedUserInfo();
+  const { setIsChatbotEnabled } = useChatbot();
+  useEffect(() => {
+    setIsChatbotEnabled(false);
+    return () => setIsChatbotEnabled(true);
+  }, [setIsChatbotEnabled]);
+  const isOpened = ((_a = route.options) == null ? void 0 : _a.opened) === true;
+  if (user && !isOpened) {
+    return /* @__PURE__ */ jsx(Navigate, { to: defaultPrivateRoute.path, replace: true });
+  }
+  return /* @__PURE__ */ jsx(Fragment, { children });
+};
 export {
   ChatbotContext as C,
+  PublicAppTemplate as P,
   useConnectedUserInfo as a,
   ConnectedUserContext as b,
   useChatbot as u
 };
-//# sourceMappingURL=hooks-CvhFUowR.js.map
+//# sourceMappingURL=PublicAppTemplate-DLKcJZVR.js.map

package/dist/PublicAppTemplate-DLKcJZVR.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublicAppTemplate-DLKcJZVR.js","sources":["../src/providers/ChatbotProvider/hooks.ts","../src/providers/ConnectedUserProvider/hooks.ts","../src/templates/PublicAppTemplate.tsx"],"sourcesContent":["import {createContext, useContext} from \"react\";\nimport {ChatbotContextValue} from \"./types\";\n\nexport const ChatbotContext = createContext<ChatbotContextValue | null>(null);\n\nexport const useChatbot = (): ChatbotContextValue => {\n    const context = useContext(ChatbotContext);\n    if (!context) {\n        throw new Error(\"useChatbot must be used within a ChatbotProvider\");\n    }\n    return context;\n};\n","import {createContext, useContext} from \"react\";\nimport {ConnectedUserInterface} from \"./types\";\n\n/**\n * Connected user context\n */\nconst ConnectedUserContext = createContext<{\n    user: ConnectedUserInterface | undefined\n    push(webservice: () => void): void\n    login: [(login: string, password: string) => void, boolean],\n    logout: [() => void, boolean],\n    refresh: [() => void, boolean],\n    handleSessionExpired: (onRefreshSuccess?: () => void) => void\n}>({\n    user: undefined,\n    push: () => {\n        console.warn(\"ConnectedUserProvider not initialized: push\")\n    },\n    login: [() => {\n        console.warn(\"ConnectedUserProvider not initialized: login\")\n    }, false],\n    logout: [() => {\n        console.warn(\"ConnectedUserProvider not initialized: logout\")\n    }, false],\n    refresh: [() => {\n        console.warn(\"ConnectedUserProvider not initialized: refresh\")\n    }, false],\n    handleSessionExpired: () => {\n        console.warn(\"ConnectedUserProvider not initialized: handleSessionExpired\")\n    }\n});\n\n/**\n * Hook to access connected user info\n */\nfunction useConnectedUserInfo() {\n    return useContext(ConnectedUserContext)\n}\n\nexport {\n    ConnectedUserContext,\n    useConnectedUserInfo\n}\n","import * as React from \"react\";\nimport {useEffect} from \"react\";\nimport {Navigate} from \"react-router-dom\";\nimport {useConnectedUserInfo} from \"../providers/ConnectedUserProvider/hooks\";\nimport {useChatbot} from \"../providers/ChatbotProvider/hooks\";\nimport {RouteInterface} from \"../types/routeTypes\";\n\ninterface PublicAppTemplateProps {\n    route: RouteInterface\n    defaultPrivateRoute: RouteInterface\n    defaultPublicRoute: RouteInterface\n    children: React.ReactNode\n}\n\n/**\n * Public app template\n * Wraps public pages and redirects authenticated users to private area\n * Unless route.options?.opened is true (public pages accessible when connected)\n */\nconst PublicAppTemplate: React.ComponentType<PublicAppTemplateProps> = (\n    {\n        route,\n        defaultPrivateRoute,\n        children\n    }) => {\n\n    /*******************************************************************************************************************\n     *                                                  HOOKS\n     ******************************************************************************************************************/\n\n    const {user} = useConnectedUserInfo();\n    const {setIsChatbotEnabled} = useChatbot();\n\n    /*******************************************************************************************************************\n     *                                                  EFFECTS\n     ******************************************************************************************************************/\n\n    // Disable chatbot on public pages\n    useEffect(() => {\n        setIsChatbotEnabled(false);\n        return () => setIsChatbotEnabled(true);\n    }, [setIsChatbotEnabled]);\n\n    /*******************************************************************************************************************\n     *                                                  RENDER\n     ******************************************************************************************************************/\n\n    // Redirect authenticated users to private area (unless page is opened)\n    const isOpened = route.options?.opened === true;\n    if (user && !isOpened) {\n        return <Navigate to={defaultPrivateRoute.path} replace />;\n    }\n\n    return (\n        <>\n            {children}\n        </>\n    );\n};\n\nexport default PublicAppTemplate;\n"],"names":[],"mappings":";;;AAGO,MAAM,iBAAiB,cAA0C,IAAI;AAErE,MAAM,aAAa,MAA2B;AACjD,QAAM,UAAU,WAAW,cAAc;AACzC,MAAI,CAAC,SAAS;AACV,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACtE;AACA,SAAO;AACX;ACLA,MAAM,uBAAuB,cAO1B;AAAA,EACC,MAAM;AAAA,EACN,MAAM,MAAM;AACR,YAAQ,KAAK,6CAA6C;AAAA,EAC9D;AAAA,EACA,OAAO,CAAC,MAAM;AACV,YAAQ,KAAK,8CAA8C;AAAA,EAC/D,GAAG,KAAK;AAAA,EACR,QAAQ,CAAC,MAAM;AACX,YAAQ,KAAK,+CAA+C;AAAA,EAChE,GAAG,KAAK;AAAA,EACR,SAAS,CAAC,MAAM;AACZ,YAAQ,KAAK,gDAAgD;AAAA,EACjE,GAAG,KAAK;AAAA,EACR,sBAAsB,MAAM;AACxB,YAAQ,KAAK,6DAA6D;AAAA,EAC9E;AACJ,CAAC;AAKD,SAAS,uBAAuB;AAC5B,SAAO,WAAW,oBAAoB;AAC1C;AClBA,MAAM,oBAAiE,CACnE;AAAA,EACI;AAAA,EACA;AAAA,EACA;AACJ,MAAM;;AAMN,QAAM,EAAC,KAAA,IAAQ,qBAAA;AACf,QAAM,EAAC,oBAAA,IAAuB,WAAA;AAO9B,YAAU,MAAM;AACZ,wBAAoB,KAAK;AACzB,WAAO,MAAM,oBAAoB,IAAI;AAAA,EACzC,GAAG,CAAC,mBAAmB,CAAC;AAOxB,QAAM,aAAW,WAAM,YAAN,mBAAe,YAAW;AAC3C,MAAI,QAAQ,CAAC,UAAU;AACnB,+BAAQ,UAAA,EAAS,IAAI,oBAAoB,MAAM,SAAO,MAAC;AAAA,EAC3D;AAEA,yCAES,UACL;AAER;"}

package/dist/{constants-BLmcEnm4.js → constants-sdhUzJ0l.js}

@@ -4,13 +4,13 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 import { jsx, jsxs, Fragment } from "react/jsx-runtime";
 import * as React from "react";
 import React__default, { createContext, useContext, useMemo, useState, useCallback, useRef, useEffect, useReducer, forwardRef, Suspense, useImperativeHandle, useTransition } from "react";
-import { C as ChatbotContext, b as ConnectedUserContext, a as useConnectedUserInfo } from "./hooks-CvhFUowR.js";
+import { C as ChatbotContext, b as ConnectedUserContext, a as useConnectedUserInfo, u as useChatbot, P as PublicAppTemplate } from "./PublicAppTemplate-DLKcJZVR.js";
 import { useSearchParams, useLocation, matchPath, useNavigate } from "react-router-dom";
 import { usePreloadedQuery, useFragment, useMutation, useQueryLoader } from "react-relay";
 import { IntlProvider, useIntl } from "react-intl";
 import { c as clearRelayCache } from "./RelayEnvironment-D880U9SM.js";
 import { i as isErrorKey, e as errorTranslations } from "./errors-BOacmKM0.js";
-import { f as extractOperationNames, c as checkOperationsPermission, d as createComponentTranslations, t as toSnakeCase, j as generateUrlByRoute } from "./translationTools-RWoOzX2m.js";
+import { f as extractOperationNames, c as checkOperationsPermission, d as createComponentTranslations, t as toSnakeCase, j as generateUrlByRoute } from "./translationTools-CKk0l3jr.js";
 class ErrorBoundaryProvider extends React__default.Component {
   constructor() {
     super(...arguments);
@@ -2155,16 +2155,117 @@ const ClientProvider = ({ children, routes }) => {
   return /* @__PURE__ */ jsx(ClientContext.Provider, { value, children });
 };
 ClientProvider.displayName = "ClientProvider";
+const RouteContext = createContext({
+  route: null,
+  defaultPrivateRoute: null,
+  defaultPublicRoute: null,
+  allRoutes: {},
+  getRouteByName: () => void 0
+});
+const useRouteInfo = () => useContext(RouteContext);
+const RouteProvider = ({
+  route,
+  routes,
+  defaultPrivateRoute,
+  defaultPublicRoute,
+  privateTemplate: PrivateTemplate,
+  publicTemplate: PublicTemplate = PublicAppTemplate,
+  children
+}) => {
+  const { setPageContext } = usePageContext();
+  const { appliedParams } = useUrlQueries();
+  const { setIsChatbotMode } = useChatbot();
+  useEffect(() => {
+    const params = {};
+    let orderByField = null;
+    let orderDir = null;
+    appliedParams.forEach((value, key) => {
+      if (key === "orderBy") {
+        orderByField = value;
+        return;
+      }
+      if (key === "orderDir") {
+        orderDir = value;
+        return;
+      }
+      if (value !== "" && !isNaN(Number(value))) {
+        params[key] = Number(value);
+      } else {
+        params[key] = value;
+      }
+    });
+    if (orderByField) {
+      const isAscending = orderDir !== "DESC";
+      params.orderBy = { [orderByField]: isAscending };
+    }
+    setPageContext(route.name, params);
+  }, [route.name, appliedParams, setPageContext]);
+  useEffect(() => {
+    if (route.autoOpenChatbot) {
+      setIsChatbotMode(true);
+    }
+  }, [route.name, route.autoOpenChatbot, setIsChatbotMode]);
+  const allRoutes = useMemo(() => {
+    const routesMap = {};
+    routes.forEach((r) => {
+      routesMap[r.name] = r;
+    });
+    return routesMap;
+  }, [routes]);
+  const getRouteByName = useCallback(
+    (name) => allRoutes[name],
+    [allRoutes]
+  );
+  return /* @__PURE__ */ jsxs(RouteContext.Provider, { value: {
+    route,
+    defaultPrivateRoute,
+    defaultPublicRoute,
+    allRoutes,
+    getRouteByName
+  }, children: [
+    route.type === "public" && /* @__PURE__ */ jsx(
+      PublicTemplate,
+      {
+        route,
+        defaultPublicRoute,
+        defaultPrivateRoute,
+        children
+      }
+    ),
+    route.type === "private" && /* @__PURE__ */ jsx(
+      PrivateTemplate,
+      {
+        route,
+        defaultPublicRoute,
+        defaultPrivateRoute,
+        children
+      }
+    )
+  ] });
+};
+const useRouteAccess = () => {
+  const { checkWebserviceAccess } = useWebserviceAccess();
+  const { getRouteByName } = useRouteInfo();
+  return useCallback(
+    (routeOrName) => {
+      if (!routeOrName) return false;
+      const route = typeof routeOrName === "string" ? getRouteByName(routeOrName) : routeOrName;
+      if (!route) return false;
+      if (!route.mainWebserviceName) return true;
+      if (Array.isArray(route.mainWebserviceName)) {
+        return route.mainWebserviceName.some(checkWebserviceAccess);
+      }
+      return checkWebserviceAccess(route.mainWebserviceName);
+    },
+    [checkWebserviceAccess, getRouteByName]
+  );
+};
 const EMPTY_PARAMS = {};
 function useRestrictedLink(route, parameters = EMPTY_PARAMS, queryParameters = EMPTY_PARAMS) {
-  const { checkWebserviceAccess } = useWebserviceAccess();
+  const hasAccess = useRouteAccess();
   const routerNavigate = useNavigate();
   const [, startTransition] = useTransition();
-  const hasPermission = useMemo(() => {
-    if (!route) return false;
-    if (!route.mainWebserviceName) return true;
-    return checkWebserviceAccess(route.mainWebserviceName);
-  }, [route, checkWebserviceAccess]);
+  const hasPermission = useMemo(() => hasAccess(route), [hasAccess, route]);
   const navigate = useCallback(() => {
     if (!route) return;
     startTransition(() => {
@@ -2179,10 +2280,13 @@ function useRestrictedLink(route, parameters = EMPTY_PARAMS, queryParameters = E
 const GRAPHQL_ERROR = "GraphQL Error";
 export {
   AlertMessageProvider as A,
+  useUrlQueries as B,
   ChatbotProvider as C,
+  useWebserviceAccess as D,
   ErrorBoundaryProvider as E,
   FilterLabelsProvider as F,
   GRAPHQL_ERROR as G,
+  webserviceAccessProviderConfig as H,
   LocaleProvider as L,
   PageContextProvider as P,
   RefreshSignalContext as R,
@@ -2196,24 +2300,24 @@ export {
   LysLoadingContext as e,
   LysMutationProvider as f,
   LysQueryProvider as g,
-  useClientId as h,
-  useDialogWithUpdates as i,
-  useFilterLabels as j,
-  useLocale as k,
-  useLysDialog as l,
-  useLysLoadingFallback as m,
-  useLysMutation as n,
-  useLysQuery as o,
-  usePageContext as p,
-  usePermissionCheck as q,
-  useRefreshSignal as r,
-  useRestrictedLink as s,
-  useSignal as t,
+  RouteProvider as h,
+  useClientId as i,
+  useDialogWithUpdates as j,
+  useFilterLabels as k,
+  useLocale as l,
+  useLysDialog as m,
+  useLysLoadingFallback as n,
+  useLysMutation as o,
+  useLysQuery as p,
+  usePageContext as q,
+  usePermissionCheck as r,
+  useRefreshSignal as s,
+  useRestrictedLink as t,
   useAlertMessages as u,
-  useSignalRefresh as v,
-  useSignalSubscription as w,
-  useUrlQueries as x,
-  useWebserviceAccess as y,
-  webserviceAccessProviderConfig as z
+  useRouteAccess as v,
+  useRouteInfo as w,
+  useSignal as x,
+  useSignalRefresh as y,
+  useSignalSubscription as z
 };
-//# sourceMappingURL=constants-BLmcEnm4.js.map
+//# sourceMappingURL=constants-sdhUzJ0l.js.map