@everysk/apps-sdk 0.1.0 → 0.3.0-beta-20261016180126

package/dist/api/workspace.js

@@ -1,4 +1,4 @@
-import { isAxiosError } from "axios";
+import { pageParams, request } from "./request.js";
 //#region src/api/workspace.ts
 var baseUrl = "workspaces";
 /**
@@ -8,45 +8,40 @@ var baseUrl = "workspaces";
 *
 * @param {AxiosInstance} api - Axios instance.
 * @param {string} name - Workspace name.
+* @param {AbortSignal} [signal] - Aborts the request itself; the entity hooks pass the query's own.
 * @returns {Promise<Workspace>} The fetched workspace.
 *
 * @throws {Error} If the request fails.
 */
-var getWorkspace = async (api, name) => {
+var getWorkspace = async (api, name, signal) => {
 	if (!name) throw new Error("Workspace name is required to fetch a workspace");
-	try {
-		return (await api.get(`${baseUrl}/${name}`)).data.workspace;
-	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching workspace");
-		if (error instanceof Error) throw error;
-		throw new Error("Error while fetching workspace");
-	}
+	return (await request(() => api.get(`${baseUrl}/${name}`, { signal }), "Error fetching workspace")).workspace;
 };
 /**
 * listWorkspaces
 *
-* Fetches a list of workspaces with optional cursor-based pagination.
+* Lists the account's workspaces, a page at a time.
+*
+* The one list that takes no workspace: the docs exempt it, and the endpoint ignores one. This
+* function used to send it anyway, documented as "required by some API configurations".
 *
 * @param {AxiosInstance} api - Axios instance.
-* @param {string} [workspace] - Current workspace name. Sent as a query param via the legacy method, required by some API configurations.
-* @param {number} [pageSize] - Number of items per page.
-* @param {string} [pageToken] - Cursor token for the next page.
-* @returns {Promise<WorkspaceListResponse>} List of workspaces.
+* @param {WorkspaceListParams} [params] - Search and paging.
+* @param {AbortSignal} [signal] - Aborts the request itself; the list hooks pass the query's own.
+* @returns {Promise<WorkspaceListResponse>} A page of workspaces, with the cursor to the next one.
 *
 * @throws {Error} If the request fails.
 */
-var listWorkspaces = async (api, workspace, pageSize, pageToken) => {
-	const params = {};
-	if (workspace) params.workspace = workspace;
-	if (pageSize) params.page_size = pageSize;
-	if (pageToken) params.page_token = pageToken;
-	try {
-		return (await api.get(baseUrl, { params })).data;
-	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching workspaces");
-		if (error instanceof Error) throw error;
-		throw new Error("Error while fetching workspaces");
-	}
+var listWorkspaces = async (api, { search, pageSize, pageToken } = {}, signal) => {
+	const params = pageParams({
+		search,
+		pageSize,
+		pageToken
+	});
+	return request(() => api.get(baseUrl, {
+		params,
+		signal
+	}), "Error listing workspaces");
 };
 //#endregion
 export { getWorkspace, listWorkspaces };

package/dist/api/workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.js","names":[],"sources":["../../src/api/workspace.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { Workspace, WorkspaceListResponse, WorkspaceSingleResponse } from \"@/types/workspace\";\n\nconst baseUrl = \"workspaces\";\n\n/**\n * getWorkspace\n *\n * Fetches a single workspace by name.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} name - Workspace name.\n * @returns {Promise<Workspace>} The fetched workspace.\n *\n * @throws {Error} If the request fails.\n */\nexport const getWorkspace = async (api: AxiosInstance, name: string): Promise<Workspace> => {\n  if (!name) throw new Error(\"Workspace name is required to fetch a workspace\");\n\n  try {\n    const response: AxiosResponse<WorkspaceSingleResponse> = await api.get(`${baseUrl}/${name}`);\n    return response.data.workspace;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while fetching workspace\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while fetching workspace\");\n  }\n};\n\n/**\n * listWorkspaces\n *\n * Fetches a list of workspaces with optional cursor-based pagination.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} [workspace] - Current workspace name. Sent as a query param via the legacy method, required by some API configurations.\n * @param {number} [pageSize] - Number of items per page.\n * @param {string} [pageToken] - Cursor token for the next page.\n * @returns {Promise<WorkspaceListResponse>} List of workspaces.\n *\n * @throws {Error} If the request fails.\n */\nexport const listWorkspaces = async (api: AxiosInstance, workspace?: string, pageSize?: number, pageToken?: string): Promise<WorkspaceListResponse> => {\n  const params: AnyRecord = {};\n\n  if (workspace) params.workspace = workspace;\n  if (pageSize) params.page_size = pageSize;\n  if (pageToken) params.page_token = pageToken;\n\n  try {\n    const response: AxiosResponse<WorkspaceListResponse> = await api.get(baseUrl, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while fetching workspaces\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while fetching workspaces\");\n  }\n};\n"],"mappings":";;AAKA,IAAM,UAAU;;;;;;;;;;;;AAahB,IAAa,eAAe,OAAO,KAAoB,SAAqC;CAC1F,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,iDAAiD;CAE5E,IAAI;EAEF,QAAO,MADwD,IAAI,IAAI,GAAG,QAAQ,GAAG,MAAM,EAAA,CAC3E,KAAK;CACvB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,gCAAgC;EAGnE,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,gCAAgC;CAClD;AACF;;;;;;;;;;;;;;AAeA,IAAa,iBAAiB,OAAO,KAAoB,WAAoB,UAAmB,cAAuD;CACrJ,MAAM,SAAoB,CAAC;CAE3B,IAAI,WAAW,OAAO,YAAY;CAClC,IAAI,UAAU,OAAO,YAAY;CACjC,IAAI,WAAW,OAAO,aAAa;CAEnC,IAAI;EAEF,QAAO,MADsD,IAAI,IAAI,SAAS,EAAE,OAAO,CAAC,EAAA,CACxE;CAClB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,iCAAiC;EAGpE,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,iCAAiC;CACnD;AACF"}
+{"version":3,"file":"workspace.js","names":[],"sources":["../../src/api/workspace.ts"],"sourcesContent":["import type { AxiosInstance } from \"axios\";\n\nimport type { EntitySingleResponse } from \"@/types/entityQuery\";\nimport type { Workspace, WorkspaceListResponse } from \"@/types/workspace\";\nimport { pageParams, request } from \"./request\";\n\nconst baseUrl = \"workspaces\";\n\n/** The endpoint's envelope, private: `getWorkspace` returns the workspace itself. */\ntype WorkspaceSingleResponse = EntitySingleResponse<\"workspace\", Workspace>;\n\n/**\n * getWorkspace\n *\n * Fetches a single workspace by name.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} name - Workspace name.\n * @param {AbortSignal} [signal] - Aborts the request itself; the entity hooks pass the query's own.\n * @returns {Promise<Workspace>} The fetched workspace.\n *\n * @throws {Error} If the request fails.\n */\nexport const getWorkspace = async (\n    api: AxiosInstance,\n    name: string,\n    signal?: AbortSignal,\n): Promise<Workspace> => {\n    if (!name) throw new Error(\"Workspace name is required to fetch a workspace\");\n\n    const body = await request(\n        () => api.get<WorkspaceSingleResponse>(`${baseUrl}/${name}`, { signal }),\n        \"Error fetching workspace\",\n    );\n    return body.workspace;\n};\n\n/** What `listWorkspaces` sends. */\nexport type WorkspaceListParams = {\n    /** A name prefix. Sent as `query`. */\n    search?: string;\n    pageSize?: number;\n    pageToken?: string;\n};\n\n/**\n * listWorkspaces\n *\n * Lists the account's workspaces, a page at a time.\n *\n * The one list that takes no workspace: the docs exempt it, and the endpoint ignores one. This\n * function used to send it anyway, documented as \"required by some API configurations\".\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {WorkspaceListParams} [params] - Search and paging.\n * @param {AbortSignal} [signal] - Aborts the request itself; the list hooks pass the query's own.\n * @returns {Promise<WorkspaceListResponse>} A page of workspaces, with the cursor to the next one.\n *\n * @throws {Error} If the request fails.\n */\nexport const listWorkspaces = async (\n    api: AxiosInstance,\n    { search, pageSize, pageToken }: WorkspaceListParams = {},\n    signal?: AbortSignal,\n): Promise<WorkspaceListResponse> => {\n    const params = pageParams({ search, pageSize, pageToken });\n\n    return request(\n        () => api.get<WorkspaceListResponse>(baseUrl, { params, signal }),\n        \"Error listing workspaces\",\n    );\n};\n"],"mappings":";;AAMA,IAAM,UAAU;;;;;;;;;;;;;AAiBhB,IAAa,eAAe,OACxB,KACA,MACA,WACqB;CACrB,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,iDAAiD;CAM5E,QAAO,MAJY,cACT,IAAI,IAA6B,GAAG,QAAQ,GAAG,QAAQ,EAAE,OAAO,CAAC,GACvE,0BACJ,EAAA,CACY;AAChB;;;;;;;;;;;;;;;;AAyBA,IAAa,iBAAiB,OAC1B,KACA,EAAE,QAAQ,UAAU,cAAmC,CAAC,GACxD,WACiC;CACjC,MAAM,SAAS,WAAW;EAAE;EAAQ;EAAU;CAAU,CAAC;CAEzD,OAAO,cACG,IAAI,IAA2B,SAAS;EAAE;EAAQ;CAAO,CAAC,GAChE,0BACJ;AACJ"}

package/dist/components/ui/Footer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/Footer/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAQ9C,eAAO,MAAM,MAAM,GAAI,yBAAyB,iBAAiB,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,gCAqBxF,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/Footer/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAQ/C,eAAO,MAAM,MAAM,GAAI,yBAAyB,iBAAiB,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,gCAsBxF,CAAC"}

package/dist/components/ui/Footer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/ui/Footer/index.tsx"],"sourcesContent":["import type { PropsWithChildren } from \"react\"\n\nimport { clsx } from 'clsx';\nimport Paper from \"@mui/material/Paper\";\nimport { useTheme, type Theme } from \"@mui/material/styles\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\n\nexport const Footer = ({ className, children }: PropsWithChildren<{ className?: string }>) => {\n    const theme: Theme = useTheme();\n    const paperProps: AnyRecord = {\n        light: {\n            variant: 'outlined',\n        },\n        dark: {\n            variant: 'elevation'\n        }\n    };\n\n    return (\n        <Paper\n            square\n            elevation={1}\n            component=\"footer\"\n            className={clsx(\"flex shrink-0 grow-0 basis-auto h-16 pl-6 pr-6\", className)}\n            {...paperProps?.[theme.palette.mode]} >\n            {children}\n        </Paper>\n    );\n}\n"],"mappings":";;;;;AAQA,IAAa,UAAU,EAAE,WAAW,eAA0D;CAC1F,MAAM,QAAe,SAAS;CAU9B,OACI,oBAAC,OAAD;EACI,QAAA;EACA,WAAW;EACX,WAAU;EACV,WAAW,KAAK,kDAAkD,SAAS;EAC3E,GAAI;GAdR,OAAO,EACH,SAAS,WACb;GACA,MAAM,EACF,SAAS,YACb;EASQ,EAAa,MAAM,QAAQ;EAC9B;CACE,CAAA;AAEf"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/ui/Footer/index.tsx"],"sourcesContent":["import type { PropsWithChildren } from \"react\";\n\nimport { clsx } from \"clsx\";\nimport Paper from \"@mui/material/Paper\";\nimport { useTheme, type Theme } from \"@mui/material/styles\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\n\nexport const Footer = ({ className, children }: PropsWithChildren<{ className?: string }>) => {\n    const theme: Theme = useTheme();\n    const paperProps: AnyRecord = {\n        light: {\n            variant: \"outlined\",\n        },\n        dark: {\n            variant: \"elevation\",\n        },\n    };\n\n    return (\n        <Paper\n            square\n            elevation={1}\n            component=\"footer\"\n            className={clsx(\"flex shrink-0 grow-0 basis-auto h-16 pl-6 pr-6\", className)}\n            {...paperProps?.[theme.palette.mode]}\n        >\n            {children}\n        </Paper>\n    );\n};\n"],"mappings":";;;;;AAQA,IAAa,UAAU,EAAE,WAAW,eAA0D;CAC1F,MAAM,QAAe,SAAS;CAU9B,OACI,oBAAC,OAAD;EACI,QAAA;EACA,WAAW;EACX,WAAU;EACV,WAAW,KAAK,kDAAkD,SAAS;EAC3E,GAAI;GAdR,OAAO,EACH,SAAS,WACb;GACA,MAAM,EACF,SAAS,YACb;EASQ,EAAa,MAAM,QAAQ;EAE9B;CACE,CAAA;AAEf"}

package/dist/components/ui/GlobalLoading/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/GlobalLoading/index.tsx"],"names":[],"mappings":"AAKA,UAAU,kBAAkB;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,GAAI,kCAAyC,kBAAkB,uCA0BxF,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/GlobalLoading/index.tsx"],"names":[],"mappings":"AAKA,UAAU,kBAAkB;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,GAAI,kCAAyC,kBAAkB,uCAoCxF,CAAC"}

package/dist/components/ui/GlobalLoading/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/ui/GlobalLoading/index.tsx"],"sourcesContent":["import Backdrop from \"@mui/material/Backdrop\";\nimport Box from \"@mui/material/Box\";\nimport CircularProgress from \"@mui/material/CircularProgress\";\nimport Typography from \"@mui/material/Typography\";\n\ninterface GlobalLoadingProps {\n    isLoading: boolean;\n    backdrop?: boolean;\n    message?: string;\n}\n\nexport const GlobalLoading = ({ isLoading, backdrop = true, message }: GlobalLoadingProps) => {\n    if (!isLoading) return null;\n\n    const content = (\n        <Box sx={{ display: \"flex\", flexDirection: \"column\", alignItems: \"center\", gap: 2 }}>\n            <CircularProgress color=\"primary\" />\n            {message && <Typography color=\"text.secondary\">{message}</Typography>}\n        </Box>\n    );\n\n    if (!backdrop) {\n        return (\n            <Box sx={{ display: \"flex\", justifyContent: \"center\", alignItems: \"center\", height: \"100%\" }}>\n                {content}\n            </Box>\n        );\n    }\n\n    return (\n        <Backdrop\n            open\n            sx={{ zIndex: (theme) => theme.zIndex.modal + 1, backgroundColor: \"rgba(0, 0, 0, 0.3)\" }}\n        >\n            {content}\n        </Backdrop>\n    );\n}\n"],"mappings":";;;;;;AAWA,IAAa,iBAAiB,EAAE,WAAW,WAAW,MAAM,cAAkC;CAC1F,IAAI,CAAC,WAAW,OAAO;CAEvB,MAAM,UACF,qBAAC,KAAD;EAAK,IAAI;GAAE,SAAS;GAAQ,eAAe;GAAU,YAAY;GAAU,KAAK;EAAE;EAAlF,UAAA,CACI,oBAAC,kBAAD,EAAkB,OAAM,UAAW,CAAA,GAClC,WAAW,oBAAC,YAAD;GAAY,OAAM;GAAkB,UAAA;EAAoB,CAAA,CACnE;;CAGT,IAAI,CAAC,UACD,OACI,oBAAC,KAAD;EAAK,IAAI;GAAE,SAAS;GAAQ,gBAAgB;GAAU,YAAY;GAAU,QAAQ;EAAO;EACtF,UAAA;CACA,CAAA;CAIb,OACI,oBAAC,UAAD;EACI,MAAA;EACA,IAAI;GAAE,SAAS,UAAU,MAAM,OAAO,QAAQ;GAAG,iBAAiB;EAAqB;EAEtF,UAAA;CACK,CAAA;AAElB"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/ui/GlobalLoading/index.tsx"],"sourcesContent":["import Backdrop from \"@mui/material/Backdrop\";\nimport Box from \"@mui/material/Box\";\nimport CircularProgress from \"@mui/material/CircularProgress\";\nimport Typography from \"@mui/material/Typography\";\n\ninterface GlobalLoadingProps {\n    isLoading: boolean;\n    backdrop?: boolean;\n    message?: string;\n}\n\nexport const GlobalLoading = ({ isLoading, backdrop = true, message }: GlobalLoadingProps) => {\n    if (!isLoading) return null;\n\n    const content = (\n        <Box sx={{ display: \"flex\", flexDirection: \"column\", alignItems: \"center\", gap: 2 }}>\n            <CircularProgress color=\"primary\" />\n            {message && <Typography color=\"text.secondary\">{message}</Typography>}\n        </Box>\n    );\n\n    if (!backdrop) {\n        return (\n            <Box\n                sx={{\n                    display: \"flex\",\n                    justifyContent: \"center\",\n                    alignItems: \"center\",\n                    height: \"100%\",\n                }}\n            >\n                {content}\n            </Box>\n        );\n    }\n\n    return (\n        <Backdrop\n            open\n            sx={{\n                zIndex: (theme) => theme.zIndex.modal + 1,\n                backgroundColor: \"rgba(0, 0, 0, 0.3)\",\n            }}\n        >\n            {content}\n        </Backdrop>\n    );\n};\n"],"mappings":";;;;;;AAWA,IAAa,iBAAiB,EAAE,WAAW,WAAW,MAAM,cAAkC;CAC1F,IAAI,CAAC,WAAW,OAAO;CAEvB,MAAM,UACF,qBAAC,KAAD;EAAK,IAAI;GAAE,SAAS;GAAQ,eAAe;GAAU,YAAY;GAAU,KAAK;EAAE;EAAlF,UAAA,CACI,oBAAC,kBAAD,EAAkB,OAAM,UAAW,CAAA,GAClC,WAAW,oBAAC,YAAD;GAAY,OAAM;GAAkB,UAAA;EAAoB,CAAA,CACnE;;CAGT,IAAI,CAAC,UACD,OACI,oBAAC,KAAD;EACI,IAAI;GACA,SAAS;GACT,gBAAgB;GAChB,YAAY;GACZ,QAAQ;EACZ;EAEC,UAAA;CACA,CAAA;CAIb,OACI,oBAAC,UAAD;EACI,MAAA;EACA,IAAI;GACA,SAAS,UAAU,MAAM,OAAO,QAAQ;GACxC,iBAAiB;EACrB;EAEC,UAAA;CACK,CAAA;AAElB"}

package/dist/components/ui/PageContainer/index.d.ts

@@ -1,5 +1,5 @@
 import type { PropsWithChildren, ReactNode } from "react";
-export declare const PageContainer: ({ header, footer, contentClassName, children }: PropsWithChildren<{
+export declare const PageContainer: ({ header, footer, contentClassName, children, }: PropsWithChildren<{
     header?: ReactNode;
     footer?: ReactNode;
     contentClassName?: string;

package/dist/components/ui/PageContainer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/PageContainer/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1D,eAAO,MAAM,aAAa,GAAI,gDAAgD,iBAAiB,CAAC;IAAE,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,gCAUrK,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/PageContainer/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1D,eAAO,MAAM,aAAa,GAAI,iDAK3B,iBAAiB,CAAC;IAAE,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,gCAY1F,CAAC"}

package/dist/components/ui/PageContainer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/ui/PageContainer/index.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport type { PropsWithChildren, ReactNode } from \"react\";\n\nexport const PageContainer = ({ header, footer, contentClassName, children }: PropsWithChildren<{ header?: ReactNode, footer?: ReactNode, contentClassName?: string }>) => {\n    return (\n        <div className=\"flex flex-col w-full h-full overflow-hidden\">\n            {header}\n            <div className={clsx(\"flex shrink-1 grow-1 basis-auto overflow-auto\", contentClassName)}>\n                {children}\n            </div>\n            {footer}\n        </div>\n    );\n};\n"],"mappings":";;;AAGA,IAAa,iBAAiB,EAAE,QAAQ,QAAQ,kBAAkB,eAAyG;CACvK,OACI,qBAAC,OAAD;EAAK,WAAU;EAAf,UAAA;GACK;GACD,oBAAC,OAAD;IAAK,WAAW,OAAK,iDAAiD,gBAAgB;IACjF;GACA,CAAA;GACJ;EACA;;AAEb"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/ui/PageContainer/index.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport type { PropsWithChildren, ReactNode } from \"react\";\n\nexport const PageContainer = ({\n    header,\n    footer,\n    contentClassName,\n    children,\n}: PropsWithChildren<{ header?: ReactNode; footer?: ReactNode; contentClassName?: string }>) => {\n    return (\n        <div className=\"flex flex-col w-full h-full overflow-hidden\">\n            {header}\n            <div\n                className={clsx(\"flex shrink-1 grow-1 basis-auto overflow-auto\", contentClassName)}\n            >\n                {children}\n            </div>\n            {footer}\n        </div>\n    );\n};\n"],"mappings":";;;AAGA,IAAa,iBAAiB,EAC1B,QACA,QACA,kBACA,eAC4F;CAC5F,OACI,qBAAC,OAAD;EAAK,WAAU;EAAf,UAAA;GACK;GACD,oBAAC,OAAD;IACI,WAAW,OAAK,iDAAiD,gBAAgB;IAEhF;GACA,CAAA;GACJ;EACA;;AAEb"}

package/dist/components/ui/Toolbar/index.d.ts

@@ -1,5 +1,42 @@
-import type { PropsWithChildren } from 'react';
-export declare const Toolbar: ({ children, className }: PropsWithChildren<{
+import type { PropsWithChildren, ReactNode } from "react";
+import { type AppBarProps } from "@mui/material/AppBar";
+/**
+ * The names follow MUI's own header components: `title`, `subheader` and `action` are
+ * `CardHeader`'s, `logo` is Toolpad's `branding.logo`, and the boolean reads as what turning
+ * it *on* does (`hideLogo`), because an MUI boolean defaults to `false`.
+ */
+export type ToolbarProps = PropsWithChildren<{
+    /**
+     * Rendered before the logo. It is a slot rather than `onToggleMenu`/`onBack` props because
+     * the buttons that go here belong to whatever shell hosts the bar (a drawer toggle, a back
+     * button), and a prop per button would make the bar grow with every shell.
+     */
+    startAction?: ReactNode;
+    /** Replaces the Everysk mark, for an app that carries its client's. */
+    logo?: ReactNode;
+    /**
+     * A flag rather than `logo={null}` or `logo={false}` (MUI's `Alert.icon` spelling), so
+     * that no single prop means default, replace and remove at once. It wins over `logo`.
+     */
+    hideLogo?: boolean;
+    /** The page heading. An `h1`: the bar is where the page says what it is. */
+    title?: ReactNode;
+    subheader?: ReactNode;
+    /** Pushed to the far end of the bar, so no page has to align it with `justify-between`. */
+    action?: ReactNode;
+    /**
+     * `relative` by default: in `PageContainer` only the content scrolls, so the bar stays put
+     * by layout. `sticky` is for a page that scrolls as a whole.
+     */
+    position?: AppBarProps["position"];
+    /** Applied to the content row. */
     className?: string;
-}>) => import("react").JSX.Element;
+}>;
+/**
+ * What a page supplies, as opposed to what the chrome around it decides (`startAction`, the
+ * logo, `position`). A shell that renders the bar for its pages holds this, and a page
+ * publishes it without ever rendering the bar itself.
+ */
+export type ToolbarContent = Pick<ToolbarProps, "title" | "subheader" | "action" | "children">;
+export declare const Toolbar: ({ startAction, logo, hideLogo, title, subheader, action, position, className, children, }: ToolbarProps) => import("react").JSX.Element;
 //# sourceMappingURL=index.d.ts.map

package/dist/components/ui/Toolbar/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/Toolbar/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAY/C,eAAO,MAAM,OAAO,GAAI,yBAAyB,iBAAiB,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,gCA+BzF,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/Toolbar/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1D,OAAe,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAShE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,iBAAiB,CAAC;IACzC;;;;OAIG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,uEAAuE;IACvE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IACnC,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC,CAAC;AAsB/F,eAAO,MAAM,OAAO,GAAI,2FAUrB,YAAY,gCAqCd,CAAC"}

package/dist/components/ui/Toolbar/index.js

@@ -2,27 +2,54 @@ import { EveryskIcon } from "../EveryskIcon/index.js";
 import { useTheme } from "@mui/material/styles";
 import { jsx, jsxs } from "react/jsx-runtime";
 import clsx$1 from "clsx";
+import Typography from "@mui/material/Typography";
 import AppBar from "@mui/material/AppBar";
 import MuiToolbar from "@mui/material/Toolbar";
 //#region src/components/ui/Toolbar/index.tsx
-var Toolbar = ({ children, className }) => {
+var MODE_PROPS = {
+	light: {
+		color: "transparent",
+		elevation: 0,
+		sx: { border: "1px solid rgba(0, 0, 0, 0.12)" }
+	},
+	dark: {
+		color: "default",
+		elevation: 1
+	}
+};
+var Toolbar = ({ startAction, logo, hideLogo = false, title, subheader, action, position = "relative", className, children }) => {
 	const theme = useTheme();
 	return /* @__PURE__ */ jsx(AppBar, {
-		position: "relative",
-		...{
-			light: {
-				color: "transparent",
-				elevation: 0,
-				sx: { border: "1px solid rgba(0, 0, 0, 0.12)" }
-			},
-			dark: {
-				color: "default",
-				elevation: 1
-			}
-		}[theme.palette.mode],
+		position,
+		...MODE_PROPS[theme.palette.mode],
 		children: /* @__PURE__ */ jsx(MuiToolbar, { children: /* @__PURE__ */ jsxs("div", {
-			className: clsx$1("flex items-center gap-4", className),
-			children: [/* @__PURE__ */ jsx(EveryskIcon, {}), children]
+			className: clsx$1("flex items-center gap-4 w-full min-w-0", className),
+			children: [
+				startAction && /* @__PURE__ */ jsx("div", {
+					className: "flex items-center shrink-0",
+					children: startAction
+				}),
+				!hideLogo && (logo ?? /* @__PURE__ */ jsx(EveryskIcon, { titleAccess: "Everysk" })),
+				(title || subheader) && /* @__PURE__ */ jsxs("div", {
+					className: "flex flex-col min-w-0",
+					children: [title && /* @__PURE__ */ jsx(Typography, {
+						variant: "h6",
+						component: "h1",
+						noWrap: true,
+						children: title
+					}), subheader && /* @__PURE__ */ jsx(Typography, {
+						variant: "body2",
+						color: "text.secondary",
+						noWrap: true,
+						children: subheader
+					})]
+				}),
+				children,
+				action && /* @__PURE__ */ jsx("div", {
+					className: "flex items-center gap-3 ml-auto shrink-0",
+					children: action
+				})
+			]
 		}) })
 	});
 };

package/dist/components/ui/Toolbar/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/ui/Toolbar/index.tsx"],"sourcesContent":["import type { PropsWithChildren } from 'react';\n\nimport AppBar from '@mui/material/AppBar';\nimport { useTheme, type Theme } from '@mui/material/styles';\nimport MuiToolbar from '@mui/material/Toolbar';\n\nimport clsx from 'clsx';\n\nimport { EveryskIcon } from '@/components/ui/EveryskIcon';\n\nimport type { AnyRecord } from '@/types/anyRecord';\n\nexport const Toolbar = ({ children, className }: PropsWithChildren<{ className?: string }>) => {\n    const theme: Theme = useTheme();\n\n    const styles: AnyRecord = {\n        light: {\n            color: 'transparent',\n            elevation: 0,\n            sx: {\n                border: \"1px solid rgba(0, 0, 0, 0.12)\"\n            }\n        },\n        dark: {\n            // 'default', not ''. An empty string is not a value the AppBar API takes — it\n            // produced the class `MuiAppBar-color` with no variant suffix, which rendered the\n            // same only because the brand theme overrides AppBar anyway. This is the explicit\n            // spelling of what already happens, and it survives a theme that does not.\n            color: 'default',\n            elevation: 1\n        }\n    };\n\n    return (\n        <AppBar position='relative' {...styles?.[theme.palette.mode]}>\n            <MuiToolbar >\n                <div className={clsx(\"flex items-center gap-4\", className)}>\n                    <EveryskIcon />\n                    {children}\n                </div>\n            </MuiToolbar>\n        </AppBar>\n    );\n}\n"],"mappings":";;;;;;;AAYA,IAAa,WAAW,EAAE,UAAU,gBAA2D;CAC3F,MAAM,QAAe,SAAS;CAoB9B,OACI,oBAAC,QAAD;EAAQ,UAAS;EAAW,GAAI;GAlBhC,OAAO;IACH,OAAO;IACP,WAAW;IACX,IAAI,EACA,QAAQ,gCACZ;GACJ;GACA,MAAM;IAKF,OAAO;IACP,WAAW;GACf;EAIgC,EAAS,MAAM,QAAQ;EACnD,UAAA,oBAAC,YAAD,EAAA,UACI,qBAAC,OAAD;GAAK,WAAW,OAAK,2BAA2B,SAAS;GAAzD,UAAA,CACI,oBAAC,aAAD,CAAc,CAAA,GACb,QACA;EACG,CAAA,EAAA,CAAA;CACR,CAAA;AAEhB"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/ui/Toolbar/index.tsx"],"sourcesContent":["import type { PropsWithChildren, ReactNode } from \"react\";\n\nimport AppBar, { type AppBarProps } from \"@mui/material/AppBar\";\nimport { useTheme, type PaletteMode, type Theme } from \"@mui/material/styles\";\nimport MuiToolbar from \"@mui/material/Toolbar\";\nimport Typography from \"@mui/material/Typography\";\n\nimport clsx from \"clsx\";\n\nimport { EveryskIcon } from \"@/components/ui/EveryskIcon\";\n\n/**\n * The names follow MUI's own header components: `title`, `subheader` and `action` are\n * `CardHeader`'s, `logo` is Toolpad's `branding.logo`, and the boolean reads as what turning\n * it *on* does (`hideLogo`), because an MUI boolean defaults to `false`.\n */\nexport type ToolbarProps = PropsWithChildren<{\n    /**\n     * Rendered before the logo. It is a slot rather than `onToggleMenu`/`onBack` props because\n     * the buttons that go here belong to whatever shell hosts the bar (a drawer toggle, a back\n     * button), and a prop per button would make the bar grow with every shell.\n     */\n    startAction?: ReactNode;\n    /** Replaces the Everysk mark, for an app that carries its client's. */\n    logo?: ReactNode;\n    /**\n     * A flag rather than `logo={null}` or `logo={false}` (MUI's `Alert.icon` spelling), so\n     * that no single prop means default, replace and remove at once. It wins over `logo`.\n     */\n    hideLogo?: boolean;\n    /** The page heading. An `h1`: the bar is where the page says what it is. */\n    title?: ReactNode;\n    subheader?: ReactNode;\n    /** Pushed to the far end of the bar, so no page has to align it with `justify-between`. */\n    action?: ReactNode;\n    /**\n     * `relative` by default: in `PageContainer` only the content scrolls, so the bar stays put\n     * by layout. `sticky` is for a page that scrolls as a whole.\n     */\n    position?: AppBarProps[\"position\"];\n    /** Applied to the content row. */\n    className?: string;\n}>;\n\n/**\n * What a page supplies, as opposed to what the chrome around it decides (`startAction`, the\n * logo, `position`). A shell that renders the bar for its pages holds this, and a page\n * publishes it without ever rendering the bar itself.\n */\nexport type ToolbarContent = Pick<ToolbarProps, \"title\" | \"subheader\" | \"action\" | \"children\">;\n\n// Typed as AppBar props, not `AnyRecord`: a loose map here is what let an invalid `color: ''`\n// through for as long as it did.\nconst MODE_PROPS: Record<PaletteMode, AppBarProps> = {\n    light: {\n        color: \"transparent\",\n        elevation: 0,\n        sx: {\n            border: \"1px solid rgba(0, 0, 0, 0.12)\",\n        },\n    },\n    dark: {\n        // 'default', not ''. An empty string is not a value the AppBar API takes — it\n        // produced the class `MuiAppBar-color` with no variant suffix, which rendered the\n        // same only because the brand theme overrides AppBar anyway. This is the explicit\n        // spelling of what already happens, and it survives a theme that does not.\n        color: \"default\",\n        elevation: 1,\n    },\n};\n\nexport const Toolbar = ({\n    startAction,\n    logo,\n    hideLogo = false,\n    title,\n    subheader,\n    action,\n    position = \"relative\",\n    className,\n    children,\n}: ToolbarProps) => {\n    const theme: Theme = useTheme();\n\n    return (\n        <AppBar position={position} {...MODE_PROPS[theme.palette.mode]}>\n            <MuiToolbar>\n                <div className={clsx(\"flex items-center gap-4 w-full min-w-0\", className)}>\n                    {startAction && <div className=\"flex items-center shrink-0\">{startAction}</div>}\n\n                    {!hideLogo && (logo ?? <EveryskIcon titleAccess=\"Everysk\" />)}\n\n                    {(title || subheader) && (\n                        // `min-w-0` is what lets the title truncate instead of pushing the\n                        // action out of the bar.\n                        <div className=\"flex flex-col min-w-0\">\n                            {title && (\n                                <Typography variant=\"h6\" component=\"h1\" noWrap>\n                                    {title}\n                                </Typography>\n                            )}\n                            {subheader && (\n                                <Typography variant=\"body2\" color=\"text.secondary\" noWrap>\n                                    {subheader}\n                                </Typography>\n                            )}\n                        </div>\n                    )}\n\n                    {children}\n\n                    {action && (\n                        <div className=\"flex items-center gap-3 ml-auto shrink-0\">{action}</div>\n                    )}\n                </div>\n            </MuiToolbar>\n        </AppBar>\n    );\n};\n"],"mappings":";;;;;;;;AAqDA,IAAM,aAA+C;CACjD,OAAO;EACH,OAAO;EACP,WAAW;EACX,IAAI,EACA,QAAQ,gCACZ;CACJ;CACA,MAAM;EAKF,OAAO;EACP,WAAW;CACf;AACJ;AAEA,IAAa,WAAW,EACpB,aACA,MACA,WAAW,OACX,OACA,WACA,QACA,WAAW,YACX,WACA,eACgB;CAChB,MAAM,QAAe,SAAS;CAE9B,OACI,oBAAC,QAAD;EAAkB;EAAU,GAAI,WAAW,MAAM,QAAQ;EACrD,UAAA,oBAAC,YAAD,EAAA,UACI,qBAAC,OAAD;GAAK,WAAW,OAAK,0CAA0C,SAAS;GAAxE,UAAA;IACK,eAAe,oBAAC,OAAD;KAAK,WAAU;KAA8B,UAAA;IAAiB,CAAA;IAE7E,CAAC,aAAa,QAAQ,oBAAC,aAAD,EAAa,aAAY,UAAW,CAAA;KAEzD,SAAS,cAGP,qBAAC,OAAD;KAAK,WAAU;KAAf,UAAA,CACK,SACG,oBAAC,YAAD;MAAY,SAAQ;MAAK,WAAU;MAAK,QAAA;MACnC,UAAA;KACO,CAAA,GAEf,aACG,oBAAC,YAAD;MAAY,SAAQ;MAAQ,OAAM;MAAiB,QAAA;MAC9C,UAAA;KACO,CAAA,CAEf;;IAGR;IAEA,UACG,oBAAC,OAAD;KAAK,WAAU;KAA4C,UAAA;IAAY,CAAA;GAE1E;EACG,CAAA,EAAA,CAAA;CACR,CAAA;AAEhB"}

package/dist/contexts/appAlertContext/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","names":[],"sources":["../../../src/contexts/appAlertContext/provider.tsx"],"sourcesContent":["import { useCallback, useMemo, useState, type PropsWithChildren } from \"react\";\nimport Alert from \"@mui/material/Alert\";\nimport Snackbar, { type SnackbarCloseReason } from \"@mui/material/Snackbar\";\n\nimport { AppAlertContext } from \".\";\nimport type { AppAlertContextType, AppAlertState, ShowAlertOptions } from \"./types\";\n\n/**\n * AppAlertProvider\n *\n * React context provider responsible for exposing a global application alert API and rendering\n * a Material UI `Snackbar` + `Alert` pair anchored to the viewport.\n *\n * What this provider does:\n * - Maintains an internal `AppAlertState` that controls:\n *   - visibility (`open`)\n *   - displayed text (`message`)\n *   - alert tone (`severity`)\n *   - auto-dismiss timing (`autoHideDuration`)\n *   - screen position (`anchorOrigin`)\n * - Exposes an imperative API via context:\n *   - `showAlert(options)` to open/update the alert\n *   - `hideAlert()` to close the alert\n * - Renders the `Snackbar`/`Alert` components once (at the provider level), so any descendant can\n *   trigger alerts without needing to manage UI state locally.\n *\n * Behavior:\n * - `showAlert(options)` performs a shallow merge of the provided options into the current state\n *   and forces `open: true`.\n * - `hideAlert()` sets `open: false` (preserving the remaining state).\n * - Snackbar `onClose` ignores the `\"clickaway\"` reason to prevent accidental dismissals when the user\n *   clicks outside the toast.\n *\n * Performance / stability:\n * - `showAlert` and `hideAlert` should be stable (e.g., created with `useCallback`) so the context value\n *   does not change on every render, avoiding unnecessary re-renders in consumers.\n *\n * Usage:\n * ```ts\n * <AppAlertProvider>\n *   <App />\n * </AppAlertProvider>\n * ```\n */\n\nexport const AppAlertProvider = ({ children }: PropsWithChildren) => {\n    const [state, setState] = useState<AppAlertState>({\n        open: false,\n        message: \"\",\n        severity: \"info\",\n        autoHideDuration: 4000,\n        anchorOrigin: { vertical: \"bottom\", horizontal: \"right\" },\n    });\n\n    const hideAlert = useCallback(() => {\n        setState((prev) => ({ ...prev, open: false }));\n    }, []);\n\n    const showAlert = useCallback((options: ShowAlertOptions) => {\n        setState((prev) => ({\n            ...prev,\n            ...options,\n            open: true,\n        }));\n    }, []);\n\n    const value: AppAlertContextType = useMemo(\n        () => ({ showAlert, hideAlert }),\n        [showAlert, hideAlert]\n    );\n\n    return (\n        <AppAlertContext.Provider value={value}>\n            {children}\n\n            <Snackbar\n                open={state.open}\n                message={state.message}\n                autoHideDuration={state.autoHideDuration}\n                anchorOrigin={state.anchorOrigin}\n                onClose={(_, reason: SnackbarCloseReason) => {\n                    if (reason === \"clickaway\") return;\n                    hideAlert();\n                }}\n            >\n                <Alert onClose={hideAlert} severity={state.severity} variant=\"filled\" elevation={6}>\n                    {state.message}\n                </Alert>\n            </Snackbar>\n        </AppAlertContext.Provider>\n    );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,IAAa,oBAAoB,EAAE,eAAkC;CACjE,MAAM,CAAC,OAAO,YAAY,SAAwB;EAC9C,MAAM;EACN,SAAS;EACT,UAAU;EACV,kBAAkB;EAClB,cAAc;GAAE,UAAU;GAAU,YAAY;EAAQ;CAC5D,CAAC;CAED,MAAM,YAAY,kBAAkB;EAChC,UAAU,UAAU;GAAE,GAAG;GAAM,MAAM;EAAM,EAAE;CACjD,GAAG,CAAC,CAAC;CAEL,MAAM,YAAY,aAAa,YAA8B;EACzD,UAAU,UAAU;GAChB,GAAG;GACH,GAAG;GACH,MAAM;EACV,EAAE;CACN,GAAG,CAAC,CAAC;CAEL,MAAM,QAA6B,eACxB;EAAE;EAAW;CAAU,IAC9B,CAAC,WAAW,SAAS,CACzB;CAEA,OACI,qBAAC,gBAAgB,UAAjB;EAAiC;EAAjC,UAAA,CACK,UAED,oBAAC,UAAD;GACI,MAAM,MAAM;GACZ,SAAS,MAAM;GACf,kBAAkB,MAAM;GACxB,cAAc,MAAM;GACpB,UAAU,GAAG,WAAgC;IACzC,IAAI,WAAW,aAAa;IAC5B,UAAU;GACd;GAEA,UAAA,oBAAC,OAAD;IAAO,SAAS;IAAW,UAAU,MAAM;IAAU,SAAQ;IAAS,WAAW;IAC5E,UAAA,MAAM;GACJ,CAAA;EACD,CAAA,CACY;;AAElC"}
+{"version":3,"file":"provider.js","names":[],"sources":["../../../src/contexts/appAlertContext/provider.tsx"],"sourcesContent":["import { useCallback, useMemo, useState, type PropsWithChildren } from \"react\";\nimport Alert from \"@mui/material/Alert\";\nimport Snackbar, { type SnackbarCloseReason } from \"@mui/material/Snackbar\";\n\nimport { AppAlertContext } from \".\";\nimport type { AppAlertContextType, AppAlertState, ShowAlertOptions } from \"./types\";\n\n/**\n * AppAlertProvider\n *\n * React context provider responsible for exposing a global application alert API and rendering\n * a Material UI `Snackbar` + `Alert` pair anchored to the viewport.\n *\n * What this provider does:\n * - Maintains an internal `AppAlertState` that controls:\n *   - visibility (`open`)\n *   - displayed text (`message`)\n *   - alert tone (`severity`)\n *   - auto-dismiss timing (`autoHideDuration`)\n *   - screen position (`anchorOrigin`)\n * - Exposes an imperative API via context:\n *   - `showAlert(options)` to open/update the alert\n *   - `hideAlert()` to close the alert\n * - Renders the `Snackbar`/`Alert` components once (at the provider level), so any descendant can\n *   trigger alerts without needing to manage UI state locally.\n *\n * Behavior:\n * - `showAlert(options)` performs a shallow merge of the provided options into the current state\n *   and forces `open: true`.\n * - `hideAlert()` sets `open: false` (preserving the remaining state).\n * - Snackbar `onClose` ignores the `\"clickaway\"` reason to prevent accidental dismissals when the user\n *   clicks outside the toast.\n *\n * Performance / stability:\n * - `showAlert` and `hideAlert` should be stable (e.g., created with `useCallback`) so the context value\n *   does not change on every render, avoiding unnecessary re-renders in consumers.\n *\n * Usage:\n * ```ts\n * <AppAlertProvider>\n *   <App />\n * </AppAlertProvider>\n * ```\n */\n\nexport const AppAlertProvider = ({ children }: PropsWithChildren) => {\n    const [state, setState] = useState<AppAlertState>({\n        open: false,\n        message: \"\",\n        severity: \"info\",\n        autoHideDuration: 4000,\n        anchorOrigin: { vertical: \"bottom\", horizontal: \"right\" },\n    });\n\n    const hideAlert = useCallback(() => {\n        setState((prev) => ({ ...prev, open: false }));\n    }, []);\n\n    const showAlert = useCallback((options: ShowAlertOptions) => {\n        setState((prev) => ({\n            ...prev,\n            ...options,\n            open: true,\n        }));\n    }, []);\n\n    const value: AppAlertContextType = useMemo(\n        () => ({ showAlert, hideAlert }),\n        [showAlert, hideAlert],\n    );\n\n    return (\n        <AppAlertContext.Provider value={value}>\n            {children}\n\n            <Snackbar\n                open={state.open}\n                message={state.message}\n                autoHideDuration={state.autoHideDuration}\n                anchorOrigin={state.anchorOrigin}\n                onClose={(_, reason: SnackbarCloseReason) => {\n                    if (reason === \"clickaway\") return;\n                    hideAlert();\n                }}\n            >\n                <Alert onClose={hideAlert} severity={state.severity} variant=\"filled\" elevation={6}>\n                    {state.message}\n                </Alert>\n            </Snackbar>\n        </AppAlertContext.Provider>\n    );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,IAAa,oBAAoB,EAAE,eAAkC;CACjE,MAAM,CAAC,OAAO,YAAY,SAAwB;EAC9C,MAAM;EACN,SAAS;EACT,UAAU;EACV,kBAAkB;EAClB,cAAc;GAAE,UAAU;GAAU,YAAY;EAAQ;CAC5D,CAAC;CAED,MAAM,YAAY,kBAAkB;EAChC,UAAU,UAAU;GAAE,GAAG;GAAM,MAAM;EAAM,EAAE;CACjD,GAAG,CAAC,CAAC;CAEL,MAAM,YAAY,aAAa,YAA8B;EACzD,UAAU,UAAU;GAChB,GAAG;GACH,GAAG;GACH,MAAM;EACV,EAAE;CACN,GAAG,CAAC,CAAC;CAEL,MAAM,QAA6B,eACxB;EAAE;EAAW;CAAU,IAC9B,CAAC,WAAW,SAAS,CACzB;CAEA,OACI,qBAAC,gBAAgB,UAAjB;EAAiC;EAAjC,UAAA,CACK,UAED,oBAAC,UAAD;GACI,MAAM,MAAM;GACZ,SAAS,MAAM;GACf,kBAAkB,MAAM;GACxB,cAAc,MAAM;GACpB,UAAU,GAAG,WAAgC;IACzC,IAAI,WAAW,aAAa;IAC5B,UAAU;GACd;GAEA,UAAA,oBAAC,OAAD;IAAO,SAAS;IAAW,UAAU,MAAM;IAAU,SAAQ;IAAS,WAAW;IAC5E,UAAA,MAAM;GACJ,CAAA;EACD,CAAA,CACY;;AAElC"}

package/dist/contexts/appAlertContext/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/contexts/appAlertContext/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,GAAG;IAC9E,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,GAAG;IAClE,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC/C,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/contexts/appAlertContext/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,GAAG;IAC9E,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,GAAG;IAClE,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC/C,SAAS,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC"}

package/dist/contexts/appConfigContext/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contexts/appConfigContext/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,eAAO,MAAM,gBAAgB,sDAAmD,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contexts/appConfigContext/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,eAAO,MAAM,gBAAgB,sDAAmD,CAAC"}

package/dist/contexts/appConfigContext/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/contexts/appConfigContext/index.tsx"],"sourcesContent":["import { createContext } from \"react\";\nimport type { AppConfigContextType } from \"./types\";\n\nexport const AppConfigContext = createContext<AppConfigContextType | null>(null)\n"],"mappings":";;AAGA,IAAa,mBAAmB,cAA2C,IAAI"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/contexts/appConfigContext/index.tsx"],"sourcesContent":["import { createContext } from \"react\";\nimport type { AppConfigContextType } from \"./types\";\n\nexport const AppConfigContext = createContext<AppConfigContextType | null>(null);\n"],"mappings":";;AAGA,IAAa,mBAAmB,cAA2C,IAAI"}

package/dist/contexts/appConfigContext/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/contexts/appConfigContext/provider.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAwB,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,iBAAiB,GAAI,yCAI/B,sBAAsB,gCAexB,CAAC"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/contexts/appConfigContext/provider.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAwB,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,iBAAiB,GAAI,yCAI/B,sBAAsB,gCAWxB,CAAC"}

package/dist/contexts/appConfigContext/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","names":[],"sources":["../../../src/contexts/appConfigContext/provider.tsx"],"sourcesContent":["import { useMemo } from \"react\";\n\nimport { AppConfigContext } from \".\";\nimport type { AppConfigContextType, AppConfigProviderProps } from \"./types\";\n\n/**\n * AppConfigProvider\n *\n * React context provider responsible for exposing the application's runtime configuration\n * (`AppConfigContextType`) to the component tree.\n *\n * Configuration sources, in order of precedence:\n *\n * 1. The `appId` / `appEnvironmentVar` props.\n *    Explicit injection, for tests and for hosts that resolve configuration themselves rather\n *    than through the page globals. A prop wins over the corresponding global; passing\n *    `appId={null}` forces \"no app id\" instead of falling through to `window.APP_ID`.\n *\n * 2. `window.APP_ID` and `window.APP_CONFIG`.\n *    Injected into the page by the platform (from the app's `config.json` `env_vars`) before\n *    the bundle executes.\n *\n * In dev there is no platform to inject them, so the app's dev server serves the `env_vars` at\n * `/app-config.json` and the app merges them into `window.APP_CONFIG` during bootstrap, before\n * React mounts. That merge is shallow and belongs to the app, not to this provider: nested\n * objects are replaced whole, not deep-merged.\n *\n * Lifecycle notes:\n * - This provider performs no network request and does not update its value after mount.\n * - Because configuration is resolved before `createRoot(...).render(...)`, the tree receives a\n *   consistent configuration from the first render.\n *\n * Example:\n * ```tsx\n * <AppConfigProvider>\n *   <App />\n * </AppConfigProvider>\n *\n * // In a test, with no page globals:\n * <AppConfigProvider appId=\"app_42\" appEnvironmentVar={{ API_URL: \"/api\" }}>\n *   <ComponentUnderTest />\n * </AppConfigProvider>\n *\n * // Consumer hook usage\n * const { appId, appEnvironmentVar } = useAppConfig();\n * ```\n */\nexport const AppConfigProvider = ({\n    children,\n    appId,\n    appEnvironmentVar,\n}: AppConfigProviderProps) => {\n    const value: AppConfigContextType = useMemo(() => {\n        const globalConfig = (globalThis.window?.APP_CONFIG ?? {}) as Record<string, unknown>;\n\n        return {\n            appId: appId !== undefined ? appId : (globalThis.window?.APP_ID ?? null),\n            appEnvironmentVar: appEnvironmentVar ?? globalConfig,\n        };\n    }, [appId, appEnvironmentVar]);\n\n    return (\n        <AppConfigContext.Provider value={value}>\n            {children}\n        </AppConfigContext.Provider>\n    );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,IAAa,qBAAqB,EAC9B,UACA,OACA,wBAC0B;CAC1B,MAAM,QAA8B,cAAc;EAC9C,MAAM,eAAgB,WAAW,QAAQ,cAAc,CAAC;EAExD,OAAO;GACH,OAAO,UAAU,KAAA,IAAY,QAAS,WAAW,QAAQ,UAAU;GACnE,mBAAmB,qBAAqB;EAC5C;CACJ,GAAG,CAAC,OAAO,iBAAiB,CAAC;CAE7B,OACI,oBAAC,iBAAiB,UAAlB;EAAkC;EAC7B;CACsB,CAAA;AAEnC"}
+{"version":3,"file":"provider.js","names":[],"sources":["../../../src/contexts/appConfigContext/provider.tsx"],"sourcesContent":["import { useMemo } from \"react\";\n\nimport { AppConfigContext } from \".\";\nimport type { AppConfigContextType, AppConfigProviderProps } from \"./types\";\n\n/**\n * AppConfigProvider\n *\n * React context provider responsible for exposing the application's runtime configuration\n * (`AppConfigContextType`) to the component tree.\n *\n * Configuration sources, in order of precedence:\n *\n * 1. The `appId` / `appEnvironmentVar` props.\n *    Explicit injection, for tests and for hosts that resolve configuration themselves rather\n *    than through the page globals. A prop wins over the corresponding global; passing\n *    `appId={null}` forces \"no app id\" instead of falling through to `window.APP_ID`.\n *\n * 2. `window.APP_ID` and `window.APP_CONFIG`.\n *    Injected into the page by the platform (from the app's `config.json` `env_vars`) before\n *    the bundle executes.\n *\n * In dev there is no platform to inject them, so the app's dev server serves the `env_vars` at\n * `/app-config.json` and the app merges them into `window.APP_CONFIG` during bootstrap, before\n * React mounts. That merge is shallow and belongs to the app, not to this provider: nested\n * objects are replaced whole, not deep-merged.\n *\n * Lifecycle notes:\n * - This provider performs no network request and does not update its value after mount.\n * - Because configuration is resolved before `createRoot(...).render(...)`, the tree receives a\n *   consistent configuration from the first render.\n *\n * Example:\n * ```tsx\n * <AppConfigProvider>\n *   <App />\n * </AppConfigProvider>\n *\n * // In a test, with no page globals:\n * <AppConfigProvider appId=\"app_42\" appEnvironmentVar={{ API_URL: \"/api\" }}>\n *   <ComponentUnderTest />\n * </AppConfigProvider>\n *\n * // Consumer hook usage\n * const { appId, appEnvironmentVar } = useAppConfig();\n * ```\n */\nexport const AppConfigProvider = ({\n    children,\n    appId,\n    appEnvironmentVar,\n}: AppConfigProviderProps) => {\n    const value: AppConfigContextType = useMemo(() => {\n        const globalConfig = (globalThis.window?.APP_CONFIG ?? {}) as Record<string, unknown>;\n\n        return {\n            appId: appId !== undefined ? appId : (globalThis.window?.APP_ID ?? null),\n            appEnvironmentVar: appEnvironmentVar ?? globalConfig,\n        };\n    }, [appId, appEnvironmentVar]);\n\n    return <AppConfigContext.Provider value={value}>{children}</AppConfigContext.Provider>;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,IAAa,qBAAqB,EAC9B,UACA,OACA,wBAC0B;CAC1B,MAAM,QAA8B,cAAc;EAC9C,MAAM,eAAgB,WAAW,QAAQ,cAAc,CAAC;EAExD,OAAO;GACH,OAAO,UAAU,KAAA,IAAY,QAAS,WAAW,QAAQ,UAAU;GACnE,mBAAmB,qBAAqB;EAC5C;CACJ,GAAG,CAAC,OAAO,iBAAiB,CAAC;CAE7B,OAAO,oBAAC,iBAAiB,UAAlB;EAAkC;EAAQ;CAAoC,CAAA;AACzF"}

package/dist/contexts/webSocketContext/handler.d.ts

@@ -1,4 +1,5 @@
-import type { WebSocketNotification, WebSocketStatus, WebsocketsConfig } from "./types";
+import type { WebsocketsConfig } from "../../api/websocketsConfig.js";
+import type { WebSocketNotification, WebSocketStatus } from "./types";
 type StatusListener = (status: Exclude<WebSocketStatus, "idle">) => void;
 type WebSocketHandlerConfig = WebsocketsConfig & {
     onStatusChange?: StatusListener;
@@ -20,7 +21,7 @@ export declare class WebSocketHandler {
     private _socket;
     private _everyskUID;
     private _listeners;
-    constructor({ appConnectionURL, appChannelID, everyskUID, onStatusChange }: WebSocketHandlerConfig);
+    constructor({ appConnectionURL, appChannelID, everyskUID, onStatusChange, }: WebSocketHandlerConfig);
     private _isEcho;
     /**
      * listen

package/dist/contexts/webSocketContext/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/contexts/webSocketContext/handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAWxF,KAAK,cAAc,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AAEzE,KAAK,sBAAsB,GAAG,gBAAgB,GAAG;IAC7C,cAAc,CAAC,EAAE,cAAc,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAwD;gBAE9D,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,sBAAsB;IAoClG,OAAO,CAAC,OAAO;IAUf;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKlE;;;;;OAKG;IACH,KAAK,IAAI,IAAI;CAKhB"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/contexts/webSocketContext/handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAWtE,KAAK,cAAc,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AAEzE,KAAK,sBAAsB,GAAG,gBAAgB,GAAG;IAC7C,cAAc,CAAC,EAAE,cAAc,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAwD;gBAE9D,EACR,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,cAAc,GACjB,EAAE,sBAAsB;IAoCzB,OAAO,CAAC,OAAO;IAUf;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKlE;;;;;OAKG;IACH,KAAK,IAAI,IAAI;CAKhB"}

package/dist/contexts/webSocketContext/handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"handler.js","names":[],"sources":["../../../src/contexts/webSocketContext/handler.ts"],"sourcesContent":["import { io, type Socket } from \"socket.io-client\";\n\nimport type { WebSocketNotification, WebSocketStatus, WebsocketsConfig } from \"./types\";\n\nfunction isWebSocketNotification(value: unknown): value is WebSocketNotification {\n    return (\n        typeof value === \"object\" &&\n        value !== null &&\n        typeof (value as Record<string, unknown>)[\"event_type\"] === \"string\"\n    );\n}\nimport { JOIN_EVENT, NOTIFICATION_EVENT } from \"./constants\";\n\ntype StatusListener = (status: Exclude<WebSocketStatus, \"idle\">) => void;\n\ntype WebSocketHandlerConfig = WebsocketsConfig & {\n    onStatusChange?: StatusListener;\n};\n\n/**\n * WebSocketHandler\n *\n * Low-level Socket.IO wrapper with a pub/sub layer.\n *\n * - Connects to the notification server.\n * - Joins the per-user channel.\n * - Forwards notifications to registered listeners.\n *\n * API:\n * - `listen(callback)`: register a notification listener; returns an unsubscribe function.\n * - `close()`: disconnect the socket and clear all listeners.\n */\nexport class WebSocketHandler {\n    private _socket: Socket;\n    private _everyskUID: string;\n    private _listeners: Set<(msg: WebSocketNotification) => void> = new Set();\n\n    constructor({ appConnectionURL, appChannelID, everyskUID, onStatusChange }: WebSocketHandlerConfig) {\n        this._everyskUID = everyskUID;\n\n        this._socket = io(appConnectionURL, {\n            auth: { appChannelID, everyskUID },\n            transports: [\"websocket\"],\n        });\n\n        this._socket.on(\"connect\", () => {\n            this._socket.emit(JOIN_EVENT, appChannelID);\n            onStatusChange?.(\"connected\");\n        });\n\n        this._socket.on(\"connect_error\", (error) => {\n            console.error(\"Socket.IO connection error:\", error);\n            onStatusChange?.(\"error\");\n        });\n\n        this._socket.on(\"disconnect\", (reason: string) => {\n            console.error(\"Socket.IO disconnected:\", reason);\n            onStatusChange?.(reason === \"io server disconnect\" ? \"error\" : \"connecting\");\n        });\n\n        this._socket.on(NOTIFICATION_EVENT, (msg: unknown) => {\n            if (!isWebSocketNotification(msg)) return;\n            if (this._isEcho(msg)) return;\n            this._listeners.forEach((callback) => {\n                try {\n                    callback(msg);\n                } catch (error) {\n                    console.error(\"Socket.IO notification listener threw:\", error);\n                }\n            });\n        });\n    }\n\n    private _isEcho(msg: WebSocketNotification): boolean {\n        // Echo-cancellation is disabled by default.\n        // Set ECHO_UID_FIELD to the message field that carries the originating uid\n        // once the server team confirms the field name.\n        const ECHO_UID_FIELD: string | null = null;\n        if (!ECHO_UID_FIELD) return false;\n        const originating = (msg as Record<string, unknown>)[ECHO_UID_FIELD];\n        return originating === this._everyskUID;\n    }\n\n    /**\n     * listen\n     *\n     * Registers a listener that receives every incoming notification.\n     *\n     * @param {(msg: WebSocketNotification) => void} callback - Invoked for each notification.\n     * @returns {() => void} Unsubscribe function.\n     */\n    listen(callback: (msg: WebSocketNotification) => void): () => void {\n        this._listeners.add(callback);\n        return () => this._listeners.delete(callback);\n    }\n\n    /**\n     * close\n     *\n     * Clears all listeners and disconnects the socket.\n     * After calling this, the handler should be considered unusable.\n     */\n    close(): void {\n        this._listeners.clear();\n        this._socket.removeAllListeners();\n        this._socket.disconnect();\n    }\n}\n"],"mappings":";;;AAIA,SAAS,wBAAwB,OAAgD;CAC7E,OACI,OAAO,UAAU,YACjB,UAAU,QACV,OAAQ,MAAkC,kBAAkB;AAEpE;;;;;;;;;;;;;;AAsBA,IAAa,mBAAb,MAA8B;CAC1B;CACA;CACA,6BAAgE,IAAI,IAAI;CAExE,YAAY,EAAE,kBAAkB,cAAc,YAAY,kBAA0C;EAChG,KAAK,cAAc;EAEnB,KAAK,UAAU,GAAG,kBAAkB;GAChC,MAAM;IAAE;IAAc;GAAW;GACjC,YAAY,CAAC,WAAW;EAC5B,CAAC;EAED,KAAK,QAAQ,GAAG,iBAAiB;GAC7B,KAAK,QAAQ,KAAK,YAAY,YAAY;GAC1C,iBAAiB,WAAW;EAChC,CAAC;EAED,KAAK,QAAQ,GAAG,kBAAkB,UAAU;GACxC,QAAQ,MAAM,+BAA+B,KAAK;GAClD,iBAAiB,OAAO;EAC5B,CAAC;EAED,KAAK,QAAQ,GAAG,eAAe,WAAmB;GAC9C,QAAQ,MAAM,2BAA2B,MAAM;GAC/C,iBAAiB,WAAW,yBAAyB,UAAU,YAAY;EAC/E,CAAC;EAED,KAAK,QAAQ,GAAG,qBAAqB,QAAiB;GAClD,IAAI,CAAC,wBAAwB,GAAG,GAAG;GACnC,IAAI,KAAK,QAAQ,GAAG,GAAG;GACvB,KAAK,WAAW,SAAS,aAAa;IAClC,IAAI;KACA,SAAS,GAAG;IAChB,SAAS,OAAO;KACZ,QAAQ,MAAM,0CAA0C,KAAK;IACjE;GACJ,CAAC;EACL,CAAC;CACL;CAEA,QAAgB,KAAqC;EAK5B,OAAO;CAGhC;;;;;;;;;CAUA,OAAO,UAA4D;EAC/D,KAAK,WAAW,IAAI,QAAQ;EAC5B,aAAa,KAAK,WAAW,OAAO,QAAQ;CAChD;;;;;;;CAQA,QAAc;EACV,KAAK,WAAW,MAAM;EACtB,KAAK,QAAQ,mBAAmB;EAChC,KAAK,QAAQ,WAAW;CAC5B;AACJ"}
+{"version":3,"file":"handler.js","names":[],"sources":["../../../src/contexts/webSocketContext/handler.ts"],"sourcesContent":["import { io, type Socket } from \"socket.io-client\";\n\nimport type { WebsocketsConfig } from \"@/api/websocketsConfig\";\nimport type { WebSocketNotification, WebSocketStatus } from \"./types\";\n\nfunction isWebSocketNotification(value: unknown): value is WebSocketNotification {\n    return (\n        typeof value === \"object\" &&\n        value !== null &&\n        typeof (value as Record<string, unknown>)[\"event_type\"] === \"string\"\n    );\n}\nimport { JOIN_EVENT, NOTIFICATION_EVENT } from \"./constants\";\n\ntype StatusListener = (status: Exclude<WebSocketStatus, \"idle\">) => void;\n\ntype WebSocketHandlerConfig = WebsocketsConfig & {\n    onStatusChange?: StatusListener;\n};\n\n/**\n * WebSocketHandler\n *\n * Low-level Socket.IO wrapper with a pub/sub layer.\n *\n * - Connects to the notification server.\n * - Joins the per-user channel.\n * - Forwards notifications to registered listeners.\n *\n * API:\n * - `listen(callback)`: register a notification listener; returns an unsubscribe function.\n * - `close()`: disconnect the socket and clear all listeners.\n */\nexport class WebSocketHandler {\n    private _socket: Socket;\n    private _everyskUID: string;\n    private _listeners: Set<(msg: WebSocketNotification) => void> = new Set();\n\n    constructor({\n        appConnectionURL,\n        appChannelID,\n        everyskUID,\n        onStatusChange,\n    }: WebSocketHandlerConfig) {\n        this._everyskUID = everyskUID;\n\n        this._socket = io(appConnectionURL, {\n            auth: { appChannelID, everyskUID },\n            transports: [\"websocket\"],\n        });\n\n        this._socket.on(\"connect\", () => {\n            this._socket.emit(JOIN_EVENT, appChannelID);\n            onStatusChange?.(\"connected\");\n        });\n\n        this._socket.on(\"connect_error\", (error) => {\n            console.error(\"Socket.IO connection error:\", error);\n            onStatusChange?.(\"error\");\n        });\n\n        this._socket.on(\"disconnect\", (reason: string) => {\n            console.error(\"Socket.IO disconnected:\", reason);\n            onStatusChange?.(reason === \"io server disconnect\" ? \"error\" : \"connecting\");\n        });\n\n        this._socket.on(NOTIFICATION_EVENT, (msg: unknown) => {\n            if (!isWebSocketNotification(msg)) return;\n            if (this._isEcho(msg)) return;\n            this._listeners.forEach((callback) => {\n                try {\n                    callback(msg);\n                } catch (error) {\n                    console.error(\"Socket.IO notification listener threw:\", error);\n                }\n            });\n        });\n    }\n\n    private _isEcho(msg: WebSocketNotification): boolean {\n        // Echo-cancellation is disabled by default.\n        // Set ECHO_UID_FIELD to the message field that carries the originating uid\n        // once the server team confirms the field name.\n        const ECHO_UID_FIELD: string | null = null;\n        if (!ECHO_UID_FIELD) return false;\n        const originating = (msg as Record<string, unknown>)[ECHO_UID_FIELD];\n        return originating === this._everyskUID;\n    }\n\n    /**\n     * listen\n     *\n     * Registers a listener that receives every incoming notification.\n     *\n     * @param {(msg: WebSocketNotification) => void} callback - Invoked for each notification.\n     * @returns {() => void} Unsubscribe function.\n     */\n    listen(callback: (msg: WebSocketNotification) => void): () => void {\n        this._listeners.add(callback);\n        return () => this._listeners.delete(callback);\n    }\n\n    /**\n     * close\n     *\n     * Clears all listeners and disconnects the socket.\n     * After calling this, the handler should be considered unusable.\n     */\n    close(): void {\n        this._listeners.clear();\n        this._socket.removeAllListeners();\n        this._socket.disconnect();\n    }\n}\n"],"mappings":";;;AAKA,SAAS,wBAAwB,OAAgD;CAC7E,OACI,OAAO,UAAU,YACjB,UAAU,QACV,OAAQ,MAAkC,kBAAkB;AAEpE;;;;;;;;;;;;;;AAsBA,IAAa,mBAAb,MAA8B;CAC1B;CACA;CACA,6BAAgE,IAAI,IAAI;CAExE,YAAY,EACR,kBACA,cACA,YACA,kBACuB;EACvB,KAAK,cAAc;EAEnB,KAAK,UAAU,GAAG,kBAAkB;GAChC,MAAM;IAAE;IAAc;GAAW;GACjC,YAAY,CAAC,WAAW;EAC5B,CAAC;EAED,KAAK,QAAQ,GAAG,iBAAiB;GAC7B,KAAK,QAAQ,KAAK,YAAY,YAAY;GAC1C,iBAAiB,WAAW;EAChC,CAAC;EAED,KAAK,QAAQ,GAAG,kBAAkB,UAAU;GACxC,QAAQ,MAAM,+BAA+B,KAAK;GAClD,iBAAiB,OAAO;EAC5B,CAAC;EAED,KAAK,QAAQ,GAAG,eAAe,WAAmB;GAC9C,QAAQ,MAAM,2BAA2B,MAAM;GAC/C,iBAAiB,WAAW,yBAAyB,UAAU,YAAY;EAC/E,CAAC;EAED,KAAK,QAAQ,GAAG,qBAAqB,QAAiB;GAClD,IAAI,CAAC,wBAAwB,GAAG,GAAG;GACnC,IAAI,KAAK,QAAQ,GAAG,GAAG;GACvB,KAAK,WAAW,SAAS,aAAa;IAClC,IAAI;KACA,SAAS,GAAG;IAChB,SAAS,OAAO;KACZ,QAAQ,MAAM,0CAA0C,KAAK;IACjE;GACJ,CAAC;EACL,CAAC;CACL;CAEA,QAAgB,KAAqC;EAK5B,OAAO;CAGhC;;;;;;;;;CAUA,OAAO,UAA4D;EAC/D,KAAK,WAAW,IAAI,QAAQ;EAC5B,aAAa,KAAK,WAAW,OAAO,QAAQ;CAChD;;;;;;;CAQA,QAAc;EACV,KAAK,WAAW,MAAM;EACtB,KAAK,QAAQ,mBAAmB;EAChC,KAAK,QAAQ,WAAW;CAC5B;AACJ"}

package/dist/contexts/webSocketContext/hooks/useWebSocket/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Convenience hook that reads the WebSocket API from `WebSocketContext`.
  *
- * Returns: `{ subscribe, lastMessage, status }` (see `WebSocketContextType`).
+ * Returns: `{ subscribe, subscribeStatus, lastMessage, status }` (see `WebSocketContextType`).
  *
  * @throws {Error} If used outside of `<WebSocketProvider>`.
  */

package/dist/contexts/webSocketContext/hooks/useWebSocket/index.js

@@ -6,7 +6,7 @@ import { useContext } from "react";
 *
 * Convenience hook that reads the WebSocket API from `WebSocketContext`.
 *
-* Returns: `{ subscribe, lastMessage, status }` (see `WebSocketContextType`).
+* Returns: `{ subscribe, subscribeStatus, lastMessage, status }` (see `WebSocketContextType`).
 *
 * @throws {Error} If used outside of `<WebSocketProvider>`.
 */

package/dist/contexts/webSocketContext/hooks/useWebSocket/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/contexts/webSocketContext/hooks/useWebSocket/index.ts"],"sourcesContent":["import { useContext } from \"react\";\n\nimport { WebSocketContext } from \"../..\";\n\n/**\n * useWebSocket\n *\n * Convenience hook that reads the WebSocket API from `WebSocketContext`.\n *\n * Returns: `{ subscribe, lastMessage, status }` (see `WebSocketContextType`).\n *\n * @throws {Error} If used outside of `<WebSocketProvider>`.\n */\nexport const useWebSocket = () => {\n    const context = useContext(WebSocketContext);\n    if (!context) throw new Error(\"useWebSocket must be used within <WebSocketProvider>.\");\n    return context;\n};\n"],"mappings":";;;;;;;;;;;;AAaA,IAAa,qBAAqB;CAC9B,MAAM,UAAU,WAAW,gBAAgB;CAC3C,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,uDAAuD;CACrF,OAAO;AACX"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/contexts/webSocketContext/hooks/useWebSocket/index.ts"],"sourcesContent":["import { useContext } from \"react\";\n\nimport { WebSocketContext } from \"../..\";\n\n/**\n * useWebSocket\n *\n * Convenience hook that reads the WebSocket API from `WebSocketContext`.\n *\n * Returns: `{ subscribe, subscribeStatus, lastMessage, status }` (see `WebSocketContextType`).\n *\n * @throws {Error} If used outside of `<WebSocketProvider>`.\n */\nexport const useWebSocket = () => {\n    const context = useContext(WebSocketContext);\n    if (!context) throw new Error(\"useWebSocket must be used within <WebSocketProvider>.\");\n    return context;\n};\n"],"mappings":";;;;;;;;;;;;AAaA,IAAa,qBAAqB;CAC9B,MAAM,UAAU,WAAW,gBAAgB;CAC3C,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,uDAAuD;CACrF,OAAO;AACX"}

package/dist/contexts/webSocketContext/provider.d.ts

@@ -6,9 +6,10 @@ import type { WebSocketProviderProps } from "./types";
  *
  * What this provider does:
  * - Fetches `/api/websockets_config` once on mount to get the connection URL, channel id,
- *   and session uid. Socket.IO handles reconnection internally — the config is not re-fetched.
+ *   and session uid. Socket.IO handles reconnection internally — the config is not re-fetched,
+ *   and the effect that does it runs once (`changeStatus`, its only dependency, is stable).
  * - Opens a `WebSocketHandler` instance that connects and joins the per-user channel.
- * - Exposes `subscribe`, `lastMessage`, and `status` via `WebSocketContext`.
+ * - Exposes `subscribe`, `subscribeStatus`, `lastMessage`, and `status` via `WebSocketContext`.
  *
  * Why the pending buffer exists (`pendingRef`):
  * - The handler is created asynchronously (after the config fetch resolves).
@@ -32,8 +33,10 @@ import type { WebSocketProviderProps } from "./types";
  * Context value (WebSocketContextType):
  * @returns {object}
  *  - `subscribe(fn)`: register a listener; returns an unsubscribe function.
+ *  - `subscribeStatus(fn)`: hear the current status at once, then every status the socket
+ *    reports, repeats included; returns an unsubscribe function.
  *  - `lastMessage`: the most recently received notification (or null).
- *  - `status`: current connection status ("connecting" | "connected" | "error").
+ *  - `status`: current connection status ("idle" | "connecting" | "connected" | "error").
  */
 export declare const WebSocketProvider: ({ children }: WebSocketProviderProps) => import("react").JSX.Element;
 //# sourceMappingURL=provider.d.ts.map

package/dist/contexts/webSocketContext/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/contexts/webSocketContext/provider.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAA+C,sBAAsB,EAAmB,MAAM,SAAS,CAAC;AAEpH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,iBAAiB,GAAI,cAAc,sBAAsB,gCA+ErE,CAAC"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/contexts/webSocketContext/provider.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAGR,sBAAsB,EAEzB,MAAM,SAAS,CAAC;AAcjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,iBAAiB,GAAI,cAAc,sBAAsB,gCA6GrE,CAAC"}

package/dist/contexts/webSocketContext/provider.js

@@ -7,15 +7,27 @@ import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/contexts/webSocketContext/provider.tsx
 /**
+* Calls a status listener, logging and skipping one that throws, as notification listeners are,
+* so it cannot keep the others from hearing the change.
+*/
+var tellStatus = (listener, status) => {
+	try {
+		listener(status);
+	} catch (error) {
+		console.error("WebSocket status listener threw:", error);
+	}
+};
+/**
 * WebSocketProvider
 *
 * React context provider that exposes a receive-only pub/sub API backed by Socket.IO.
 *
 * What this provider does:
 * - Fetches `/api/websockets_config` once on mount to get the connection URL, channel id,
-*   and session uid. Socket.IO handles reconnection internally — the config is not re-fetched.
+*   and session uid. Socket.IO handles reconnection internally — the config is not re-fetched,
+*   and the effect that does it runs once (`changeStatus`, its only dependency, is stable).
 * - Opens a `WebSocketHandler` instance that connects and joins the per-user channel.
-* - Exposes `subscribe`, `lastMessage`, and `status` via `WebSocketContext`.
+* - Exposes `subscribe`, `subscribeStatus`, `lastMessage`, and `status` via `WebSocketContext`.
 *
 * Why the pending buffer exists (`pendingRef`):
 * - The handler is created asynchronously (after the config fetch resolves).
@@ -39,8 +51,10 @@ import { jsx } from "react/jsx-runtime";
 * Context value (WebSocketContextType):
 * @returns {object}
 *  - `subscribe(fn)`: register a listener; returns an unsubscribe function.
+*  - `subscribeStatus(fn)`: hear the current status at once, then every status the socket
+*    reports, repeats included; returns an unsubscribe function.
 *  - `lastMessage`: the most recently received notification (or null).
-*  - `status`: current connection status ("connecting" | "connected" | "error").
+*  - `status`: current connection status ("idle" | "connecting" | "connected" | "error").
 */
 var WebSocketProvider = ({ children }) => {
 	const { api } = useAxios();
@@ -57,16 +71,28 @@ var WebSocketProvider = ({ children }) => {
 	const unsubscribeProviderRef = useRef(null);
 	const [lastMessage, setLastMessage] = useState(null);
 	const [status, setStatus] = useState("idle");
+	const statusListenersRef = useRef(/* @__PURE__ */ new Set());
+	const currentStatusRef = useRef("idle");
+	/**
+	* Sets `status` and tells the status listeners, so both see the same sequence. The current
+	* status is also kept in a ref, so a new listener is told it at once rather than from React
+	* state, which lags a change until the next render.
+	*/
+	const changeStatus = useCallback((next) => {
+		currentStatusRef.current = next;
+		setStatus(next);
+		statusListenersRef.current.forEach((listener) => tellStatus(listener, next));
+	}, []);
 	const pendingRef = useRef(/* @__PURE__ */ new Map());
 	useEffect(() => {
 		let cancelled = false;
 		const pending = pendingRef.current;
 		getWebsocketsConfig(apiRef.current).then((config) => {
 			if (cancelled) return;
-			setStatus("connecting");
+			changeStatus("connecting");
 			const handler = new WebSocketHandler({
 				...config,
-				onStatusChange: (s) => setStatus(s)
+				onStatusChange: changeStatus
 			});
 			handlerRef.current = handler;
 			unsubscribeProviderRef.current = handler.listen((message) => setLastMessage(message));
@@ -77,7 +103,7 @@ var WebSocketProvider = ({ children }) => {
 		}).catch((error) => {
 			if (cancelled) return;
 			console.error("Failed to initialize WebSocket connection:", error);
-			setStatus("error");
+			changeStatus("error");
 			showAlertRef.current({
 				message: "Real-time notifications are unavailable. Please refresh the page.",
 				severity: "error"
@@ -91,7 +117,7 @@ var WebSocketProvider = ({ children }) => {
 			handlerRef.current = null;
 			pending.clear();
 		};
-	}, []);
+	}, [changeStatus]);
 	const subscribe = useCallback((fn) => {
 		if (handlerRef.current) return handlerRef.current.listen(fn);
 		pendingRef.current.set(fn, null);
@@ -101,12 +127,21 @@ var WebSocketProvider = ({ children }) => {
 			pendingRef.current.delete(fn);
 		};
 	}, []);
+	const subscribeStatus = useCallback((listener) => {
+		statusListenersRef.current.add(listener);
+		tellStatus(listener, currentStatusRef.current);
+		return () => {
+			statusListenersRef.current.delete(listener);
+		};
+	}, []);
 	const value = useMemo(() => ({
 		subscribe,
+		subscribeStatus,
 		lastMessage,
 		status
 	}), [
 		subscribe,
+		subscribeStatus,
 		lastMessage,
 		status
 	]);