@cyberskill/shared 3.12.0 → 3.14.0

package/dist/node/ws/ws.util.js

@@ -1,17 +1,18 @@
-import { useServer as e } from "graphql-ws/use/ws";
-import { WebSocketServer as t } from "ws";
+import { log as e } from "../log/log.util.js";
+import { useServer as t } from "graphql-ws/use/ws";
+import { WebSocketServer as n } from "ws";
 //#region src/node/ws/ws.util.ts
-function n(e) {
-	let { server: n, path: r, sessionParser: i } = e;
-	if (!n) throw Error("[WS] HTTP server instance is required to create a WebSocket server.");
-	if (!r || !r.startsWith("/")) throw Error("[WS] WebSocket path must be a non-empty string starting with \"/\".");
-	if (i) {
-		let e = new t({ noServer: !0 });
-		return n.on("upgrade", (t, n, a) => {
+function r(t) {
+	let { server: r, path: i, sessionParser: a } = t;
+	if (!r) throw Error("[WS] HTTP server instance is required to create a WebSocket server.");
+	if (!i || !i.startsWith("/")) throw Error("[WS] WebSocket path must be a non-empty string starting with \"/\".");
+	if (a) {
+		let e = new n({ noServer: !0 });
+		return r.on("upgrade", (t, n, r) => {
 			try {
-				if (new URL(t.url || "", "http://localhost").pathname !== r) return;
-				i(t, {}, () => {
-					e.handleUpgrade(t, n, a, (n) => {
+				if (new URL(t.url || "", "http://localhost").pathname !== i) return;
+				a(t, {}, () => {
+					e.handleUpgrade(t, n, r, (n) => {
 						e.emit("connection", n, t);
 					});
 				});
@@ -20,14 +21,14 @@ function n(e) {
 			}
 		}), e;
 	}
-	return new t({
-		server: n,
-		path: r
+	return e.warn(`[WS] Creating unauthenticated WebSocket at "${i}". No sessionParser provided — any client can connect. Provide a sessionParser for authenticated endpoints.`), new n({
+		server: r,
+		path: i
 	});
 }
-function r(t) {
-	let { schema: n, server: r, context: i, onConnect: a } = t;
-	return e({
+function i(e) {
+	let { schema: n, server: r, context: i, onConnect: a } = e;
+	return t({
 		schema: n,
 		context: async (e) => {
 			let t = e.extra.request;
@@ -45,6 +46,6 @@ function r(t) {
 	}, r);
 }
 //#endregion
-export { n as createWSServer, r as initGraphQLWS };
+export { r as createWSServer, i as initGraphQLWS };
 
 //# sourceMappingURL=ws.util.js.map

package/dist/node/ws/ws.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"ws.util.js","names":[],"sources":["../../../src/node/ws/ws.util.ts"],"sourcesContent":["import type { Request, Response } from 'express';\nimport type { Buffer } from 'node:buffer';\nimport type { IncomingMessage } from 'node:http';\nimport type { Duplex } from 'node:stream';\n\nimport { useServer as createGraphQLWSServer } from 'graphql-ws/use/ws';\nimport { WebSocketServer } from 'ws';\n\nimport type { I_AuthenticatedRequest, I_GraphqlWSOptions, I_WSOptions } from './ws.type.js';\n\n/**\n * Creates a WebSocket server with the specified configuration.\n * This function creates a WebSocket server instance that can be attached to an HTTP server\n * and configured with a specific path for WebSocket connections.\n *\n * @param options - Configuration options including the HTTP server instance and WebSocket path.\n * @returns A configured WebSocket server instance ready to handle connections.\n */\nexport function createWSServer(options: I_WSOptions): WebSocketServer {\n    const { server, path, sessionParser } = options;\n\n    if (!server) {\n        throw new Error('[WS] HTTP server instance is required to create a WebSocket server.');\n    }\n\n    if (!path || !path.startsWith('/')) {\n        throw new Error('[WS] WebSocket path must be a non-empty string starting with \"/\".');\n    }\n\n    if (sessionParser) {\n        const wss = new WebSocketServer({ noServer: true });\n\n        server.on('upgrade', (req: IncomingMessage, socket: Duplex, head: Buffer) => {\n            try {\n                const url = new URL(req.url || '', 'http://localhost');\n                if (url.pathname !== path)\n                    return;\n\n                sessionParser(req as Request, {} as Response, () => {\n                    wss.handleUpgrade(req, socket, head, (ws) => {\n                        wss.emit('connection', ws, req);\n                    });\n                });\n            }\n            catch {\n                socket.destroy();\n            }\n        });\n\n        return wss;\n    }\n\n    return new WebSocketServer({ server, path });\n}\n\n/**\n * Initializes GraphQL WebSocket server with schema and WebSocket server.\n * This function sets up GraphQL subscriptions over WebSocket by creating a GraphQL WebSocket server\n * that can handle GraphQL operations including queries, mutations, and subscriptions.\n *\n * @param options - Configuration options including the GraphQL schema and WebSocket server instance.\n * @returns A configured GraphQL WebSocket server ready to handle GraphQL operations over WebSocket.\n */\nexport function initGraphQLWS(options: I_GraphqlWSOptions) {\n    const { schema, server, context: makeExtraContext, onConnect } = options;\n\n    return createGraphQLWSServer(\n        {\n            schema,\n            context: async (ctx) => {\n                const req = ctx.extra.request as I_AuthenticatedRequest;\n\n                const extra = makeExtraContext ? await makeExtraContext(req) : {};\n                return { req, ...extra };\n            },\n            onConnect: async (ctx) => {\n                if (onConnect) {\n                    const req = ctx.extra.request as I_AuthenticatedRequest;\n                    await onConnect(req);\n                }\n            },\n        },\n        server,\n    );\n}\n"],"mappings":";;;AAkBA,SAAgB,EAAe,GAAuC;CAClE,IAAM,EAAE,WAAQ,SAAM,qBAAkB;AAExC,KAAI,CAAC,EACD,OAAU,MAAM,sEAAsE;AAG1F,KAAI,CAAC,KAAQ,CAAC,EAAK,WAAW,IAAI,CAC9B,OAAU,MAAM,sEAAoE;AAGxF,KAAI,GAAe;EACf,IAAM,IAAM,IAAI,EAAgB,EAAE,UAAU,IAAM,CAAC;AAmBnD,SAjBA,EAAO,GAAG,YAAY,GAAsB,GAAgB,MAAiB;AACzE,OAAI;AAEA,QADY,IAAI,IAAI,EAAI,OAAO,IAAI,mBAAmB,CAC9C,aAAa,EACjB;AAEJ,MAAc,GAAgB,EAAE,QAAoB;AAChD,OAAI,cAAc,GAAK,GAAQ,IAAO,MAAO;AACzC,QAAI,KAAK,cAAc,GAAI,EAAI;OACjC;MACJ;WAEA;AACF,MAAO,SAAS;;IAEtB,EAEK;;AAGX,QAAO,IAAI,EAAgB;EAAE;EAAQ;EAAM,CAAC;;AAWhD,SAAgB,EAAc,GAA6B;CACvD,IAAM,EAAE,WAAQ,WAAQ,SAAS,GAAkB,iBAAc;AAEjE,QAAO,EACH;EACI;EACA,SAAS,OAAO,MAAQ;GACpB,IAAM,IAAM,EAAI,MAAM;AAGtB,UAAO;IAAE;IAAK,GADA,IAAmB,MAAM,EAAiB,EAAI,GAAG,EAAE;IACzC;;EAE5B,WAAW,OAAO,MAAQ;AACtB,OAAI,GAAW;IACX,IAAM,IAAM,EAAI,MAAM;AACtB,UAAM,EAAU,EAAI;;;EAG/B,EACD,EACH"}
+{"version":3,"file":"ws.util.js","names":[],"sources":["../../../src/node/ws/ws.util.ts"],"sourcesContent":["import type { Request, Response } from 'express';\nimport type { Buffer } from 'node:buffer';\nimport type { IncomingMessage } from 'node:http';\nimport type { Duplex } from 'node:stream';\n\nimport { useServer as createGraphQLWSServer } from 'graphql-ws/use/ws';\nimport { WebSocketServer } from 'ws';\n\nimport type { I_AuthenticatedRequest, I_GraphqlWSOptions, I_WSOptions } from './ws.type.js';\n\nimport { log } from '../log/index.js';\n\n/**\n * Creates a WebSocket server with the specified configuration.\n * This function creates a WebSocket server instance that can be attached to an HTTP server\n * and configured with a specific path for WebSocket connections.\n *\n * @remarks\n * **Authentication Warning:** When `sessionParser` is not provided, the WebSocket server\n * has **no session-based authentication**. Any client that can reach the endpoint can\n * establish a connection. Only omit `sessionParser` for truly public WebSocket endpoints\n * (e.g., health-check or anonymous broadcast channels). For authenticated subscriptions,\n * always provide a `sessionParser` to validate sessions on upgrade.\n *\n * @param options - Configuration options including the HTTP server instance and WebSocket path.\n * @returns A configured WebSocket server instance ready to handle connections.\n */\nexport function createWSServer(options: I_WSOptions): WebSocketServer {\n    const { server, path, sessionParser } = options;\n\n    if (!server) {\n        throw new Error('[WS] HTTP server instance is required to create a WebSocket server.');\n    }\n\n    if (!path || !path.startsWith('/')) {\n        throw new Error('[WS] WebSocket path must be a non-empty string starting with \"/\".');\n    }\n\n    if (sessionParser) {\n        const wss = new WebSocketServer({ noServer: true });\n\n        server.on('upgrade', (req: IncomingMessage, socket: Duplex, head: Buffer) => {\n            try {\n                const url = new URL(req.url || '', 'http://localhost');\n                if (url.pathname !== path)\n                    return;\n\n                sessionParser(req as Request, {} as Response, () => {\n                    wss.handleUpgrade(req, socket, head, (ws) => {\n                        wss.emit('connection', ws, req);\n                    });\n                });\n            }\n            catch {\n                /* Intentionally empty — destroy socket on any URL parsing or session error */\n                socket.destroy();\n            }\n        });\n\n        return wss;\n    }\n\n    log.warn(`[WS] Creating unauthenticated WebSocket at \"${path}\". No sessionParser provided — any client can connect. Provide a sessionParser for authenticated endpoints.`);\n\n    return new WebSocketServer({ server, path });\n}\n\n/**\n * Initializes GraphQL WebSocket server with schema and WebSocket server.\n * This function sets up GraphQL subscriptions over WebSocket by creating a GraphQL WebSocket server\n * that can handle GraphQL operations including queries, mutations, and subscriptions.\n *\n * @param options - Configuration options including the GraphQL schema and WebSocket server instance.\n * @returns A configured GraphQL WebSocket server ready to handle GraphQL operations over WebSocket.\n */\nexport function initGraphQLWS(options: I_GraphqlWSOptions) {\n    const { schema, server, context: makeExtraContext, onConnect } = options;\n\n    return createGraphQLWSServer(\n        {\n            schema,\n            context: async (ctx) => {\n                const req = ctx.extra.request as I_AuthenticatedRequest;\n\n                const extra = makeExtraContext ? await makeExtraContext(req) : {};\n                return { req, ...extra };\n            },\n            onConnect: async (ctx) => {\n                if (onConnect) {\n                    const req = ctx.extra.request as I_AuthenticatedRequest;\n                    await onConnect(req);\n                }\n            },\n        },\n        server,\n    );\n}\n"],"mappings":";;;;AA2BA,SAAgB,EAAe,GAAuC;CAClE,IAAM,EAAE,WAAQ,SAAM,qBAAkB;AAExC,KAAI,CAAC,EACD,OAAU,MAAM,sEAAsE;AAG1F,KAAI,CAAC,KAAQ,CAAC,EAAK,WAAW,IAAI,CAC9B,OAAU,MAAM,sEAAoE;AAGxF,KAAI,GAAe;EACf,IAAM,IAAM,IAAI,EAAgB,EAAE,UAAU,IAAM,CAAC;AAoBnD,SAlBA,EAAO,GAAG,YAAY,GAAsB,GAAgB,MAAiB;AACzE,OAAI;AAEA,QADY,IAAI,IAAI,EAAI,OAAO,IAAI,mBAAmB,CAC9C,aAAa,EACjB;AAEJ,MAAc,GAAgB,EAAE,QAAoB;AAChD,OAAI,cAAc,GAAK,GAAQ,IAAO,MAAO;AACzC,QAAI,KAAK,cAAc,GAAI,EAAI;OACjC;MACJ;WAEA;AAEF,MAAO,SAAS;;IAEtB,EAEK;;AAKX,QAFA,EAAI,KAAK,+CAA+C,EAAK,6GAA6G,EAEnK,IAAI,EAAgB;EAAE;EAAQ;EAAM,CAAC;;AAWhD,SAAgB,EAAc,GAA6B;CACvD,IAAM,EAAE,WAAQ,WAAQ,SAAS,GAAkB,iBAAc;AAEjE,QAAO,EACH;EACI;EACA,SAAS,OAAO,MAAQ;GACpB,IAAM,IAAM,EAAI,MAAM;AAGtB,UAAO;IAAE;IAAK,GADA,IAAmB,MAAM,EAAiB,EAAI,GAAG,EAAE;IACzC;;EAE5B,WAAW,OAAO,MAAQ;AACtB,OAAI,GAAW;IACX,IAAM,IAAM,EAAI,MAAM;AACtB,UAAM,EAAU,EAAI;;;EAG/B,EACD,EACH"}

package/dist/react/apollo-client/apollo-client.component.js.map

@@ -1 +1 @@
-{"version":3,"file":"apollo-client.component.js","names":[],"sources":["../../../src/react/apollo-client/apollo-client.component.tsx"],"sourcesContent":["import { ApolloProvider as ApolloProviderDefault } from '@apollo/client/react';\nimport * as React from 'react';\nimport { useMemo } from 'react';\n\nimport type { I_ApolloProviderProps } from './apollo-client.type.js';\n\nimport { ApolloErrorComponent, ApolloErrorProvider } from '../apollo-error/index.js';\nimport { Toaster } from '../toast/index.js';\nimport { ApolloClientProvider } from './apollo-client.context.js';\nimport { getClient } from './apollo-client.util.js';\n\n/**\n * Apollo Provider component that wraps the application with Apollo Client context.\n * This component provides the Apollo Client instance to all child components,\n * enabling GraphQL operations throughout the component tree. It includes\n * error handling and toast integration for a complete GraphQL experience.\n *\n * Features:\n * - Apollo Client context provision\n * - Error boundary integration\n * - Toast notification support\n * - Automatic error handling\n * - Development and production optimizations\n *\n * @param props - Component props containing options, children, and optional error override.\n * @param props.options - Apollo Client configuration options.\n * @param props.children - React children that will have access to Apollo Client context.\n * @param props.onError - Optional callback to override the default modal/toast error handling.\n * @returns A React component that provides Apollo Client context to its children.\n */\nexport function ApolloProvider({ options, children, onError }: I_ApolloProviderProps) {\n    const client = useMemo(\n        () => getClient(options ?? {}),\n        // Depend on stable primitive values to avoid recreating ApolloClient when parent re-renders\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n        [options?.uri, options?.wsUrl],\n    );\n\n    return (\n        <>\n            <ApolloErrorProvider onError={onError}>\n                <ApolloClientProvider client={client}>\n                    <ApolloProviderDefault client={client}>{children}</ApolloProviderDefault>\n                </ApolloClientProvider>\n                {!onError && <ApolloErrorComponent />}\n            </ApolloErrorProvider>\n            <Toaster position=\"top-right\" />\n        </>\n    );\n}\n"],"mappings":";;;;;;;;;AA8BA,SAAgB,EAAe,EAAE,YAAS,aAAU,cAAkC;CAClF,IAAM,IAAS,QACL,EAAU,KAAW,EAAE,CAAC,EAG9B,CAAC,GAAS,KAAK,GAAS,MAAM,CACjC;AAED,QACI,kBAAA,cAAA,EAAA,UAAA,MACI,kBAAA,cAAC,GAAD,EAA8B,YAKR,EAJlB,kBAAA,cAAC,GAAD,EAA8B,WAEP,EADnB,kBAAA,cAAC,GAAD,EAA+B,WAA0C,EAAjC,EAAiC,CACtD,EACtB,CAAC,KAAW,kBAAA,cAAC,GAAA,KAAuB,CACnB,EACtB,kBAAA,cAAC,GAAD,EAAS,UAAS,aAAc,CAAA,CACjC"}
+{"version":3,"file":"apollo-client.component.js","names":[],"sources":["../../../src/react/apollo-client/apollo-client.component.tsx"],"sourcesContent":["import { ApolloProvider as ApolloProviderDefault } from '@apollo/client/react';\nimport * as React from 'react';\nimport { useMemo } from 'react';\n\nimport type { I_ApolloProviderProps } from './apollo-client.type.js';\n\nimport { ApolloErrorComponent, ApolloErrorProvider } from '../apollo-error/index.js';\nimport { Toaster } from '../toast/index.js';\nimport { ApolloClientProvider } from './apollo-client.context.js';\nimport { getClient } from './apollo-client.util.js';\n\n/**\n * Apollo Provider component that wraps the application with Apollo Client context.\n * This component provides the Apollo Client instance to all child components,\n * enabling GraphQL operations throughout the component tree. It includes\n * error handling and toast integration for a complete GraphQL experience.\n *\n * Features:\n * - Apollo Client context provision\n * - Error boundary integration\n * - Toast notification support\n * - Automatic error handling\n * - Development and production optimizations\n *\n * @param props - Component props containing options, children, and optional error override.\n * @param props.options - Apollo Client configuration options.\n * @param props.children - React children that will have access to Apollo Client context.\n * @param props.onError - Optional callback to override the default modal/toast error handling.\n * @returns A React component that provides Apollo Client context to its children.\n */\nexport function ApolloProvider({ options, children, onError }: I_ApolloProviderProps) {\n    const client = useMemo(\n        () => getClient(options ?? {}),\n        // eslint-disable-next-line react/exhaustive-deps -- intended to only recreate on uri/wsUrl change\n        [options?.uri, options?.wsUrl],\n    );\n\n    return (\n        <>\n            <ApolloErrorProvider onError={onError}>\n                <ApolloClientProvider client={client}>\n                    <ApolloProviderDefault client={client}>{children}</ApolloProviderDefault>\n                </ApolloClientProvider>\n                {!onError && <ApolloErrorComponent />}\n            </ApolloErrorProvider>\n            <Toaster position=\"top-right\" />\n        </>\n    );\n}\n"],"mappings":";;;;;;;;;AA8BA,SAAgB,EAAe,EAAE,YAAS,aAAU,cAAkC;CAClF,IAAM,IAAS,QACL,EAAU,KAAW,EAAE,CAAC,EAE9B,CAAC,GAAS,KAAK,GAAS,MAAM,CACjC;AAED,QACI,kBAAA,cAAA,EAAA,UAAA,MACI,kBAAA,cAAC,GAAD,EAA8B,YAKR,EAJlB,kBAAA,cAAC,GAAD,EAA8B,WAEP,EADnB,kBAAA,cAAC,GAAD,EAA+B,WAA0C,EAAjC,EAAiC,CACtD,EACtB,CAAC,KAAW,kBAAA,cAAC,GAAA,KAAuB,CACnB,EACtB,kBAAA,cAAC,GAAD,EAAS,UAAS,aAAc,CAAA,CACjC"}

package/dist/{src/react → react}/apollo-client/apollo-client.type.d.ts

@@ -1,11 +1,13 @@
 import { ApolloClient } from '@apollo/client';
 import { ApolloLink } from '@apollo/client/link';
 import { GraphQLError } from 'graphql';
-import { I_Children } from '../../../typescript/index.js';
+import { I_Children } from '../../typescript/index.js';
 export interface I_ApolloOptions extends Omit<ApolloClient.Options, 'link' | 'cache'> {
     uri?: string;
     wsUrl?: string;
     customLinks?: ApolloLink[];
+    /** Enable round-trip timing logs for every GraphQL operation. Defaults to false. */
+    debug?: boolean;
 }
 export interface I_ApolloProviderProps extends I_Children {
     isNextJS?: boolean;

package/dist/react/apollo-client/apollo-client.util.js

@@ -33,19 +33,19 @@ var x = new l((e, t) => (e.setContext({ start: performance.now() }), t(e).pipe(b
 	}, "Error Details"))));
 });
 function C(e) {
-	let { uri: t, wsUrl: r, customLinks: i } = e, o = new g();
+	let { uri: t, wsUrl: r, customLinks: i, debug: o } = e, c = new g();
 	t || n.warn(`[Apollo] No GraphQL URI provided — using "${a}" as default`);
-	let c = s({
+	let u = s({
 		uri: t ?? "/graphql",
 		credentials: "include",
 		headers: { "apollo-require-preflight": "true" }
-	}), u = r ? new _(y({ url: r })) : l.empty(), d = r ? l.split(({ operationType: e }) => e === v.SUBSCRIPTION, u, c) : c;
+	}), d = r ? new _(y({ url: r })) : l.empty(), f = r ? l.split(({ operationType: e }) => e === v.SUBSCRIPTION, d, u) : u;
 	return [
-		x,
+		...o ? [x] : [],
 		S,
-		o,
+		c,
 		...i ?? [],
-		d
+		f
 	];
 }
 function w(e) {

package/dist/react/apollo-client/apollo-client.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"apollo-client.util.js","names":[],"sources":["../../../src/react/apollo-client/apollo-client.util.tsx"],"sourcesContent":["import { ApolloClient, CombinedGraphQLErrors, CombinedProtocolErrors, InMemoryCache, ServerError } from '@apollo/client/core';\nimport { ApolloLink } from '@apollo/client/link';\nimport { ErrorLink } from '@apollo/client/link/error';\nimport { RemoveTypenameFromVariablesLink } from '@apollo/client/link/remove-typename';\nimport { GraphQLWsLink } from '@apollo/client/link/subscriptions';\nimport { OperationTypeNode } from 'graphql';\nimport { createClient } from 'graphql-ws';\nimport * as React from 'react';\nimport { tap } from 'rxjs';\n\nimport { IS_BROWSER } from '#constant/index.js';\n\nimport type { I_ApolloOptions } from './apollo-client.type.js';\n\nimport { hasCustomApolloErrorHandler, showGlobalApolloError } from '../apollo-error/index.js';\nimport { log } from '../log/index.js';\nimport { toast } from '../toast/index.js';\nimport { GRAPHQL_URI_DEFAULT } from './apollo-client.constant.js';\nimport styles from './apollo-client.module.scss';\nimport { createUploadLink } from './links/index.js';\n\nconst roundTripLink = new ApolloLink((operation, forward) => {\n    operation.setContext({ start: performance.now() });\n\n    return forward(operation).pipe(\n        tap(() => {\n            const time = Math.round(performance.now() - operation.getContext()['start']);\n\n            log.info(`Operation ${operation.operationName} took ${time}ms to complete`);\n        }),\n    );\n});\n\nconst errorLink = new ErrorLink(({ error, operation }) => {\n    const opName = operation?.operationName || 'Unknown';\n    let errorMessage = '';\n\n    if (CombinedGraphQLErrors.is(error)) {\n        error.errors.forEach(({ message, locations, path }, index) => {\n            if (index === 0) {\n                errorMessage = message;\n            }\n\n            log.error(\n                `[GraphQL error] ${opName}: ${message}, Location: ${JSON.stringify(locations, null, 4)}, Path: ${path}`,\n            );\n        });\n    }\n    else if (CombinedProtocolErrors.is(error)) {\n        error.errors.forEach(({ message, extensions }, index) => {\n            if (index === 0) {\n                errorMessage = message;\n            }\n\n            log.error(\n                `[Protocol error]: ${message}, Extensions: ${JSON.stringify(extensions, null, 4)}`,\n            );\n        });\n    }\n    else if (ServerError.is(error)) {\n        errorMessage = error.message;\n\n        log.error(`[Server error]: ${error.message}`);\n    }\n    else {\n        errorMessage = error.message;\n\n        log.error(`[Network error]: ${error.message}`);\n    }\n\n    if (error && errorMessage && IS_BROWSER) {\n        if (hasCustomApolloErrorHandler()) {\n            showGlobalApolloError(error);\n        }\n        else {\n            toast.error((t: { id: string }) => (\n                <div className={styles['error-container']}>\n                    {errorMessage}\n                    <button\n                        type=\"button\"\n                        className={styles['error-details-button']}\n                        onClick={() => {\n                            showGlobalApolloError(error);\n\n                            toast.dismiss(t.id);\n                        }}\n                    >\n                        Error Details\n                    </button>\n                </div>\n            ));\n        }\n    }\n});\n\n/**\n * Creates a comprehensive Apollo Link chain with all necessary middleware.\n * This function sets up a complete Apollo Link chain including error handling,\n * logging, file uploads, WebSocket subscriptions, and custom links. The chain\n * is configured to handle both HTTP and WebSocket operations with proper routing.\n *\n * The link chain includes:\n * - Development logging for operation tracking\n * - Error handling with user-friendly notifications\n * - Type name removal for cleaner requests\n * - File upload support\n * - WebSocket subscription support\n * - Custom link integration\n *\n * @param options - Configuration options for the Apollo Client including URI, WebSocket URL, and custom links.\n * @returns An array of Apollo Links configured for the specified options.\n */\nexport function createApolloLinks(options: I_ApolloOptions): ApolloLink[] {\n    const { uri, wsUrl, customLinks } = options;\n\n    const removeTypenameLink = new RemoveTypenameFromVariablesLink();\n\n    if (!uri) {\n        log.warn(`[Apollo] No GraphQL URI provided — using \"${GRAPHQL_URI_DEFAULT}\" as default`);\n    }\n\n    const uploadLink = createUploadLink({\n        uri: uri ?? GRAPHQL_URI_DEFAULT,\n        credentials: 'include',\n        headers: {\n            'apollo-require-preflight': 'true',\n        },\n    });\n\n    const wsLink = wsUrl\n        ? new GraphQLWsLink(createClient({ url: wsUrl }))\n        : ApolloLink.empty();\n\n    const splitLink = wsUrl\n        ? ApolloLink.split(\n                ({ operationType }) => {\n                    return operationType === OperationTypeNode.SUBSCRIPTION;\n                },\n                wsLink,\n                uploadLink as unknown as ApolloLink,\n            )\n        : uploadLink;\n\n    return [\n        roundTripLink,\n        errorLink,\n        removeTypenameLink,\n        ...(customLinks ?? []),\n        splitLink as unknown as ApolloLink,\n    ];\n}\n\n/**\n * Creates a fully configured Apollo Client instance.\n * This function creates an Apollo Client with all necessary configuration including\n * the link chain, cache, and any additional options provided. The client is ready\n * for immediate use in React applications with comprehensive error handling and\n * development tooling.\n *\n * @param options - Configuration options for the Apollo Client including links, cache, and other settings.\n * @returns A fully configured Apollo Client instance ready for use.\n */\nexport function getClient(options: I_ApolloOptions) {\n    const link = ApolloLink.from(createApolloLinks(options));\n\n    return new ApolloClient({\n        link,\n        cache: new InMemoryCache(),\n        ...options,\n    });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAqBA,IAAM,IAAgB,IAAI,GAAY,GAAW,OAC7C,EAAU,WAAW,EAAE,OAAO,YAAY,KAAK,EAAE,CAAC,EAE3C,EAAQ,EAAU,CAAC,KACtB,QAAU;CACN,IAAM,IAAO,KAAK,MAAM,YAAY,KAAK,GAAG,EAAU,YAAY,CAAC,MAAS;AAE5E,GAAI,KAAK,aAAa,EAAU,cAAc,QAAQ,EAAK,gBAAgB;EAC7E,CACL,EACH,EAEI,IAAY,IAAI,GAAW,EAAE,UAAO,mBAAgB;CACtD,IAAM,IAAS,GAAW,iBAAiB,WACvC,IAAe;AAmCnB,CAjCI,EAAsB,GAAG,EAAM,GAC/B,EAAM,OAAO,SAAS,EAAE,YAAS,cAAW,WAAQ,MAAU;AAK1D,EAJI,MAAU,MACV,IAAe,IAGnB,EAAI,MACA,mBAAmB,EAAO,IAAI,EAAQ,cAAc,KAAK,UAAU,GAAW,MAAM,EAAE,CAAC,UAAU,IACpG;GACH,GAEG,EAAuB,GAAG,EAAM,GACrC,EAAM,OAAO,SAAS,EAAE,YAAS,iBAAc,MAAU;AAKrD,EAJI,MAAU,MACV,IAAe,IAGnB,EAAI,MACA,qBAAqB,EAAQ,gBAAgB,KAAK,UAAU,GAAY,MAAM,EAAE,GACnF;GACH,GAEG,EAAY,GAAG,EAAM,IAC1B,IAAe,EAAM,SAErB,EAAI,MAAM,mBAAmB,EAAM,UAAU,KAG7C,IAAe,EAAM,SAErB,EAAI,MAAM,oBAAoB,EAAM,UAAU,GAG9C,KAAS,KAAgB,MACrB,GAA6B,GAC7B,EAAsB,EAAM,GAG5B,EAAM,OAAO,MACT,kBAAA,cAAC,OAAD,EAAK,WAAW,EAAO,oBAajB,EAZD,GACD,kBAAA,cAAC,UAAD;EACI,MAAK;EACL,WAAW,EAAO;EAClB,eAAe;AAGX,GAFA,EAAsB,EAAM,EAE5B,EAAM,QAAQ,EAAE,GAAG;;EAIlB,EAFR,gBAEQ,CACP,CACR;EAGZ;AAmBF,SAAgB,EAAkB,GAAwC;CACtE,IAAM,EAAE,QAAK,UAAO,mBAAgB,GAE9B,IAAqB,IAAI,GAAiC;AAEhE,CAAK,KACD,EAAI,KAAK,6CAA6C,EAAoB,cAAc;CAG5F,IAAM,IAAa,EAAiB;EAChC,KAAK,KAAA;EACL,aAAa;EACb,SAAS,EACL,4BAA4B,QAC/B;EACJ,CAAC,EAEI,IAAS,IACT,IAAI,EAAc,EAAa,EAAE,KAAK,GAAO,CAAC,CAAC,GAC/C,EAAW,OAAO,EAElB,IAAY,IACZ,EAAW,OACJ,EAAE,uBACQ,MAAkB,EAAkB,cAE/C,GACA,EACH,GACH;AAEN,QAAO;EACH;EACA;EACA;EACA,GAAI,KAAe,EAAE;EACrB;EACH;;AAaL,SAAgB,EAAU,GAA0B;AAGhD,QAAO,IAAI,EAAa;EACpB,MAHS,EAAW,KAAK,EAAkB,EAAQ,CAAC;EAIpD,OAAO,IAAI,GAAe;EAC1B,GAAG;EACN,CAAC"}
+{"version":3,"file":"apollo-client.util.js","names":[],"sources":["../../../src/react/apollo-client/apollo-client.util.tsx"],"sourcesContent":["import { ApolloClient, CombinedGraphQLErrors, CombinedProtocolErrors, InMemoryCache, ServerError } from '@apollo/client/core';\nimport { ApolloLink } from '@apollo/client/link';\nimport { ErrorLink } from '@apollo/client/link/error';\nimport { RemoveTypenameFromVariablesLink } from '@apollo/client/link/remove-typename';\nimport { GraphQLWsLink } from '@apollo/client/link/subscriptions';\nimport { OperationTypeNode } from 'graphql';\nimport { createClient } from 'graphql-ws';\nimport * as React from 'react';\nimport { tap } from 'rxjs';\n\nimport { IS_BROWSER } from '#constant/index.js';\n\nimport type { I_ApolloOptions } from './apollo-client.type.js';\n\nimport { hasCustomApolloErrorHandler, showGlobalApolloError } from '../apollo-error/index.js';\nimport { log } from '../log/index.js';\nimport { toast } from '../toast/index.js';\nimport { GRAPHQL_URI_DEFAULT } from './apollo-client.constant.js';\nimport styles from './apollo-client.module.scss';\nimport { createUploadLink } from './links/index.js';\n\nconst roundTripLink = new ApolloLink((operation, forward) => {\n    operation.setContext({ start: performance.now() });\n\n    return forward(operation).pipe(\n        tap(() => {\n            const time = Math.round(performance.now() - operation.getContext()['start']);\n\n            log.info(`Operation ${operation.operationName} took ${time}ms to complete`);\n        }),\n    );\n});\n\nconst errorLink = new ErrorLink(({ error, operation }) => {\n    const opName = operation?.operationName || 'Unknown';\n    let errorMessage = '';\n\n    if (CombinedGraphQLErrors.is(error)) {\n        error.errors.forEach(({ message, locations, path }, index) => {\n            if (index === 0) {\n                errorMessage = message;\n            }\n\n            log.error(\n                `[GraphQL error] ${opName}: ${message}, Location: ${JSON.stringify(locations, null, 4)}, Path: ${path}`,\n            );\n        });\n    }\n    else if (CombinedProtocolErrors.is(error)) {\n        error.errors.forEach(({ message, extensions }, index) => {\n            if (index === 0) {\n                errorMessage = message;\n            }\n\n            log.error(\n                `[Protocol error]: ${message}, Extensions: ${JSON.stringify(extensions, null, 4)}`,\n            );\n        });\n    }\n    else if (ServerError.is(error)) {\n        errorMessage = error.message;\n\n        log.error(`[Server error]: ${error.message}`);\n    }\n    else {\n        errorMessage = error.message;\n\n        log.error(`[Network error]: ${error.message}`);\n    }\n\n    if (error && errorMessage && IS_BROWSER) {\n        if (hasCustomApolloErrorHandler()) {\n            showGlobalApolloError(error);\n        }\n        else {\n            toast.error((t: { id: string }) => (\n                <div className={styles['error-container']}>\n                    {errorMessage}\n                    <button\n                        type=\"button\"\n                        className={styles['error-details-button']}\n                        onClick={() => {\n                            showGlobalApolloError(error);\n\n                            toast.dismiss(t.id);\n                        }}\n                    >\n                        Error Details\n                    </button>\n                </div>\n            ));\n        }\n    }\n});\n\n/**\n * Creates a comprehensive Apollo Link chain with all necessary middleware.\n * This function sets up a complete Apollo Link chain including error handling,\n * logging, file uploads, WebSocket subscriptions, and custom links. The chain\n * is configured to handle both HTTP and WebSocket operations with proper routing.\n *\n * The link chain includes:\n * - Development logging for operation tracking\n * - Error handling with user-friendly notifications\n * - Type name removal for cleaner requests\n * - File upload support\n * - WebSocket subscription support\n * - Custom link integration\n *\n * @param options - Configuration options for the Apollo Client including URI, WebSocket URL, and custom links.\n * @returns An array of Apollo Links configured for the specified options.\n */\nexport function createApolloLinks(options: I_ApolloOptions): ApolloLink[] {\n    const { uri, wsUrl, customLinks, debug } = options;\n\n    const removeTypenameLink = new RemoveTypenameFromVariablesLink();\n\n    if (!uri) {\n        log.warn(`[Apollo] No GraphQL URI provided — using \"${GRAPHQL_URI_DEFAULT}\" as default`);\n    }\n\n    const uploadLink = createUploadLink({\n        uri: uri ?? GRAPHQL_URI_DEFAULT,\n        credentials: 'include',\n        headers: {\n            'apollo-require-preflight': 'true',\n        },\n    });\n\n    const wsLink = wsUrl\n        ? new GraphQLWsLink(createClient({ url: wsUrl }))\n        : ApolloLink.empty();\n\n    const splitLink = wsUrl\n        ? ApolloLink.split(\n                ({ operationType }) => {\n                    return operationType === OperationTypeNode.SUBSCRIPTION;\n                },\n                wsLink,\n                uploadLink as unknown as ApolloLink,\n            )\n        : uploadLink;\n\n    return [\n        ...(debug ? [roundTripLink] : []),\n        errorLink,\n        removeTypenameLink,\n        ...(customLinks ?? []),\n        splitLink as unknown as ApolloLink,\n    ];\n}\n\n/**\n * Creates a fully configured Apollo Client instance.\n * This function creates an Apollo Client with all necessary configuration including\n * the link chain, cache, and any additional options provided. The client is ready\n * for immediate use in React applications with comprehensive error handling and\n * development tooling.\n *\n * @param options - Configuration options for the Apollo Client including links, cache, and other settings.\n * @returns A fully configured Apollo Client instance ready for use.\n */\nexport function getClient(options: I_ApolloOptions) {\n    const link = ApolloLink.from(createApolloLinks(options));\n\n    return new ApolloClient({\n        link,\n        cache: new InMemoryCache(),\n        ...options,\n    });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAqBA,IAAM,IAAgB,IAAI,GAAY,GAAW,OAC7C,EAAU,WAAW,EAAE,OAAO,YAAY,KAAK,EAAE,CAAC,EAE3C,EAAQ,EAAU,CAAC,KACtB,QAAU;CACN,IAAM,IAAO,KAAK,MAAM,YAAY,KAAK,GAAG,EAAU,YAAY,CAAC,MAAS;AAE5E,GAAI,KAAK,aAAa,EAAU,cAAc,QAAQ,EAAK,gBAAgB;EAC7E,CACL,EACH,EAEI,IAAY,IAAI,GAAW,EAAE,UAAO,mBAAgB;CACtD,IAAM,IAAS,GAAW,iBAAiB,WACvC,IAAe;AAmCnB,CAjCI,EAAsB,GAAG,EAAM,GAC/B,EAAM,OAAO,SAAS,EAAE,YAAS,cAAW,WAAQ,MAAU;AAK1D,EAJI,MAAU,MACV,IAAe,IAGnB,EAAI,MACA,mBAAmB,EAAO,IAAI,EAAQ,cAAc,KAAK,UAAU,GAAW,MAAM,EAAE,CAAC,UAAU,IACpG;GACH,GAEG,EAAuB,GAAG,EAAM,GACrC,EAAM,OAAO,SAAS,EAAE,YAAS,iBAAc,MAAU;AAKrD,EAJI,MAAU,MACV,IAAe,IAGnB,EAAI,MACA,qBAAqB,EAAQ,gBAAgB,KAAK,UAAU,GAAY,MAAM,EAAE,GACnF;GACH,GAEG,EAAY,GAAG,EAAM,IAC1B,IAAe,EAAM,SAErB,EAAI,MAAM,mBAAmB,EAAM,UAAU,KAG7C,IAAe,EAAM,SAErB,EAAI,MAAM,oBAAoB,EAAM,UAAU,GAG9C,KAAS,KAAgB,MACrB,GAA6B,GAC7B,EAAsB,EAAM,GAG5B,EAAM,OAAO,MACT,kBAAA,cAAC,OAAD,EAAK,WAAW,EAAO,oBAajB,EAZD,GACD,kBAAA,cAAC,UAAD;EACI,MAAK;EACL,WAAW,EAAO;EAClB,eAAe;AAGX,GAFA,EAAsB,EAAM,EAE5B,EAAM,QAAQ,EAAE,GAAG;;EAIlB,EAFR,gBAEQ,CACP,CACR;EAGZ;AAmBF,SAAgB,EAAkB,GAAwC;CACtE,IAAM,EAAE,QAAK,UAAO,gBAAa,aAAU,GAErC,IAAqB,IAAI,GAAiC;AAEhE,CAAK,KACD,EAAI,KAAK,6CAA6C,EAAoB,cAAc;CAG5F,IAAM,IAAa,EAAiB;EAChC,KAAK,KAAA;EACL,aAAa;EACb,SAAS,EACL,4BAA4B,QAC/B;EACJ,CAAC,EAEI,IAAS,IACT,IAAI,EAAc,EAAa,EAAE,KAAK,GAAO,CAAC,CAAC,GAC/C,EAAW,OAAO,EAElB,IAAY,IACZ,EAAW,OACJ,EAAE,uBACQ,MAAkB,EAAkB,cAE/C,GACA,EACH,GACH;AAEN,QAAO;EACH,GAAI,IAAQ,CAAC,EAAc,GAAG,EAAE;EAChC;EACA;EACA,GAAI,KAAe,EAAE;EACrB;EACH;;AAaL,SAAgB,EAAU,GAA0B;AAGhD,QAAO,IAAI,EAAa;EACpB,MAHS,EAAW,KAAK,EAAkB,EAAQ,CAAC;EAIpD,OAAO,IAAI,GAAe;EAC1B,GAAG;EACN,CAAC"}

package/dist/react/apollo-client/index.d.ts

@@ -1 +1,9 @@
-export {}
+export * from './apollo-client.component.js';
+export * from './apollo-client.constant.js';
+export * from './apollo-client.context.js';
+export * from './apollo-client.hook.js';
+export * from './apollo-client.type.js';
+export * from './apollo-client.util.js';
+export * from './links/index.js';
+export { makeVar } from '@apollo/client/cache';
+export { useApolloClient, useBackgroundQuery, useFragment, useLazyQuery, useLoadableQuery, useMutation, useQuery, useQueryRefHandlers, useReactiveVar, useReadQuery, useSubscription, useSuspenseFragment, useSuspenseQuery } from '@apollo/client/react';

package/dist/react/apollo-client/links/index.d.ts

@@ -1 +1 @@
-export {}
+export * from './upload.js';

package/dist/react/apollo-client-nextjs/apollo-client-nextjs.rsc.d.ts

@@ -1 +1,16 @@
-export {}
+import { I_ApolloOptions } from '../apollo-client/index.js';
+/**
+ * Creates a registered Apollo Client factory for Next.js server components.
+ * This function creates a client factory that is registered with Next.js for
+ * proper server-side rendering support. The factory function ensures that
+ * each request gets its own Apollo Client instance, which is essential for
+ * SSR compatibility and preventing client state leakage between requests.
+ *
+ * @param options - Configuration options for the Apollo Client including URI, WebSocket URL, and custom links.
+ * @returns A registered Apollo Client factory function that can be used with Next.js server components.
+ */
+export declare const makeClient: (options?: I_ApolloOptions) => {
+    getClient: () => import('@apollo/client-integration-nextjs').ApolloClient;
+    query: <TData = unknown, TVariables extends import('@apollo/client').OperationVariables = import('@apollo/client').OperationVariables>(options: import("@apollo/client").ApolloClient.QueryOptions<TData, TVariables>) => Promise<import("@apollo/client").ApolloClient.QueryResult<import('@apollo/client').MaybeMasked<TData>>>;
+    PreloadQuery: import('@apollo/client-integration-nextjs').PreloadQueryComponent;
+};

package/dist/react/apollo-client-nextjs/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './apollo-client-nextjs.component.js';
+export * from './apollo-client-nextjs.util.js';

package/dist/react/apollo-error/apollo-error.component.js

@@ -23,7 +23,7 @@ function c() {
 		let t = [...u.current.querySelectorAll(s)].filter((e) => !e.hasAttribute("disabled"));
 		if (t.length === 0) return;
 		let n = t[0], r = t.at(-1);
-		!n || !r || (e.shiftKey ? document.activeElement === n && (e.preventDefault(), r.focus()) : document.activeElement === r && (e.preventDefault(), n.focus()));
+		!n || !r || (e.shiftKey ? (document.activeElement === n || document.activeElement === u.current) && (e.preventDefault(), r.focus()) : document.activeElement === r && (e.preventDefault(), n.focus()));
 	};
 	if (!c) return null;
 	let p = "locations" in c || "path" in c || "extensions" in c, m = "message" in c ? c.message : "Unknown error occurred";

package/dist/react/apollo-error/apollo-error.component.js.map

@@ -1 +1 @@
-{"version":3,"file":"apollo-error.component.js","names":[],"sources":["../../../src/react/apollo-error/apollo-error.component.tsx"],"sourcesContent":["import * as React from 'react';\nimport { use, useEffect, useRef } from 'react';\n\nimport { validate } from '#util/validate/validate.util.js';\n\nimport { ApolloErrorContext } from './apollo-error.context.js';\nimport style from './apollo-error.module.scss';\n\nconst FOCUSABLE_SELECTORS = 'button, [href], input, select, textarea, [tabindex]:not([tabindex=\"-1\"])';\n\n/**\n * Apollo Error Component that displays detailed error information in a modal.\n * This component provides a comprehensive error display interface that shows\n * GraphQL errors and other error types with detailed information for debugging purposes.\n *\n * Features:\n * - Modal overlay with backdrop for focus\n * - Detailed error categorization and display\n * - Reload functionality for error recovery\n * - Close button to dismiss the error modal\n * - Structured display of different error types\n * - Extra information display for debugging\n *\n * @returns A modal component displaying Apollo error details, or null if no error is present.\n */\nexport function ApolloErrorComponent() {\n    const context = use(ApolloErrorContext);\n    const { error, hideError } = context ?? {};\n    const dialogRef = useRef<HTMLDivElement>(null);\n    const previousFocusRef = useRef<HTMLElement | null>(null);\n\n    useEffect(() => {\n        if (!error || !hideError)\n            return;\n\n        const handleKeyDown = (event: KeyboardEvent) => {\n            if (event.key === 'Escape') {\n                hideError();\n            }\n        };\n\n        window.addEventListener('keydown', handleKeyDown);\n\n        return () => {\n            window.removeEventListener('keydown', handleKeyDown);\n        };\n    }, [error, hideError]);\n\n    useEffect(() => {\n        if (error && dialogRef.current) {\n            previousFocusRef.current = document.activeElement as HTMLElement;\n            dialogRef.current.focus();\n        }\n        else if (!error && previousFocusRef.current) {\n            previousFocusRef.current.focus();\n            previousFocusRef.current = null;\n        }\n    }, [error]);\n\n    const handleFocusTrap = (event: React.KeyboardEvent<HTMLDivElement>) => {\n        if (event.key !== 'Tab' || !dialogRef.current)\n            return;\n\n        const focusableElements = [...dialogRef.current.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTORS)].filter(el => !el.hasAttribute('disabled'));\n\n        if (focusableElements.length === 0)\n            return;\n\n        const firstElement = focusableElements[0];\n        const lastElement = focusableElements.at(-1);\n\n        if (!firstElement || !lastElement)\n            return;\n\n        if (event.shiftKey) {\n            if (document.activeElement === firstElement) {\n                event.preventDefault();\n                lastElement.focus();\n            }\n        }\n        else if (document.activeElement === lastElement) {\n            event.preventDefault();\n            firstElement.focus();\n        }\n    };\n\n    if (!error) {\n        return null;\n    }\n\n    const isGraphQLError = 'locations' in error || 'path' in error || 'extensions' in error;\n    const errorMessage = 'message' in error ? error.message : 'Unknown error occurred';\n\n    return (\n        <div className={style['modal-backdrop']} onClick={hideError}>\n            <div\n                ref={dialogRef}\n                className={style['modal-content']}\n                role=\"dialog\"\n                aria-modal=\"true\"\n                aria-labelledby=\"apollo-error-title\"\n                aria-describedby=\"apollo-error-details\"\n                tabIndex={-1}\n                onKeyDown={handleFocusTrap}\n                onClick={e => e.stopPropagation()}\n            >\n                <button\n                    type=\"button\"\n                    className={style['btn-close']}\n                    onClick={hideError}\n                    aria-label=\"Close error details (Esc)\"\n                    aria-keyshortcuts=\"Escape\"\n                    title=\"Close error details (Esc)\"\n                >\n                    ✕\n                </button>\n                <div className={style['error-title']}>\n                    <button\n                        type=\"button\"\n                        className={style['btn-retry']}\n                        onClick={() => window.location.reload()}\n                        aria-label=\"Reload page\"\n                    >\n                        Reload\n                    </button>\n                    {' '}\n                    <span id=\"apollo-error-title\">\n                        {errorMessage || 'Error details'}\n                    </span>\n                </div>\n                <div id=\"apollo-error-details\" className={style['error-details']}>\n                    {isGraphQLError && 'locations' in error && error.locations && (\n                        <pre className=\"locations\">\n                            <strong>Locations:</strong>\n                            {' '}\n                            {JSON.stringify(error.locations, null, 4)}\n                        </pre>\n                    )}\n                    {isGraphQLError && 'path' in error && error.path && (\n                        <pre className=\"path\">\n                            <strong>Path:</strong>\n                            {' '}\n                            {JSON.stringify(error.path, null, 4)}\n                        </pre>\n                    )}\n                    {isGraphQLError && 'extensions' in error && error.extensions && (\n                        <pre className=\"extensions\">\n                            <strong>Extensions:</strong>\n                            {' '}\n                            {JSON.stringify(error.extensions, null, 4)}\n                        </pre>\n                    )}\n                    {!isGraphQLError && (\n                        <pre className=\"error-details\">\n                            <strong>Error Details:</strong>\n                            {' '}\n                            {validate.isEmpty(error) ? errorMessage : JSON.stringify(error, null, 4)}\n                        </pre>\n                    )}\n                </div>\n            </div>\n        </div>\n    );\n}\n"],"mappings":"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"}
+{"version":3,"file":"apollo-error.component.js","names":[],"sources":["../../../src/react/apollo-error/apollo-error.component.tsx"],"sourcesContent":["import * as React from 'react';\nimport { use, useEffect, useRef } from 'react';\n\nimport { validate } from '#util/validate/validate.util.js';\n\nimport { ApolloErrorContext } from './apollo-error.context.js';\nimport style from './apollo-error.module.scss';\n\nconst FOCUSABLE_SELECTORS = 'button, [href], input, select, textarea, [tabindex]:not([tabindex=\"-1\"])';\n\n/**\n * Apollo Error Component that displays detailed error information in a modal.\n * This component provides a comprehensive error display interface that shows\n * GraphQL errors and other error types with detailed information for debugging purposes.\n *\n * Features:\n * - Modal overlay with backdrop for focus\n * - Detailed error categorization and display\n * - Reload functionality for error recovery\n * - Close button to dismiss the error modal\n * - Structured display of different error types\n * - Extra information display for debugging\n *\n * @returns A modal component displaying Apollo error details, or null if no error is present.\n */\nexport function ApolloErrorComponent() {\n    const context = use(ApolloErrorContext);\n    const { error, hideError } = context ?? {};\n    const dialogRef = useRef<HTMLDivElement>(null);\n    const previousFocusRef = useRef<HTMLElement | null>(null);\n\n    useEffect(() => {\n        if (!error || !hideError)\n            return;\n\n        const handleKeyDown = (event: KeyboardEvent) => {\n            if (event.key === 'Escape') {\n                hideError();\n            }\n        };\n\n        window.addEventListener('keydown', handleKeyDown);\n\n        return () => {\n            window.removeEventListener('keydown', handleKeyDown);\n        };\n    }, [error, hideError]);\n\n    useEffect(() => {\n        if (error && dialogRef.current) {\n            previousFocusRef.current = document.activeElement as HTMLElement;\n            dialogRef.current.focus();\n        }\n        else if (!error && previousFocusRef.current) {\n            previousFocusRef.current.focus();\n            previousFocusRef.current = null;\n        }\n    }, [error]);\n\n    const handleFocusTrap = (event: React.KeyboardEvent<HTMLDivElement>) => {\n        if (event.key !== 'Tab' || !dialogRef.current)\n            return;\n\n        const focusableElements = [...dialogRef.current.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTORS)].filter(el => !el.hasAttribute('disabled'));\n\n        if (focusableElements.length === 0)\n            return;\n\n        const firstElement = focusableElements[0];\n        const lastElement = focusableElements.at(-1);\n\n        if (!firstElement || !lastElement)\n            return;\n\n        if (event.shiftKey) {\n            if (document.activeElement === firstElement || document.activeElement === dialogRef.current) {\n                event.preventDefault();\n                lastElement.focus();\n            }\n        }\n        else if (document.activeElement === lastElement) {\n            event.preventDefault();\n            firstElement.focus();\n        }\n    };\n\n    if (!error) {\n        return null;\n    }\n\n    const isGraphQLError = 'locations' in error || 'path' in error || 'extensions' in error;\n    const errorMessage = 'message' in error ? error.message : 'Unknown error occurred';\n\n    return (\n        <div className={style['modal-backdrop']} onClick={hideError}>\n            <div\n                ref={dialogRef}\n                className={style['modal-content']}\n                role=\"dialog\"\n                aria-modal=\"true\"\n                aria-labelledby=\"apollo-error-title\"\n                aria-describedby=\"apollo-error-details\"\n                tabIndex={-1}\n                onKeyDown={handleFocusTrap}\n                onClick={e => e.stopPropagation()}\n            >\n                <button\n                    type=\"button\"\n                    className={style['btn-close']}\n                    onClick={hideError}\n                    aria-label=\"Close error details (Esc)\"\n                    aria-keyshortcuts=\"Escape\"\n                    title=\"Close error details (Esc)\"\n                >\n                    ✕\n                </button>\n                <div className={style['error-title']}>\n                    <button\n                        type=\"button\"\n                        className={style['btn-retry']}\n                        onClick={() => window.location.reload()}\n                        aria-label=\"Reload page\"\n                    >\n                        Reload\n                    </button>\n                    {' '}\n                    <span id=\"apollo-error-title\">\n                        {errorMessage || 'Error details'}\n                    </span>\n                </div>\n                <div id=\"apollo-error-details\" className={style['error-details']}>\n                    {isGraphQLError && 'locations' in error && error.locations && (\n                        <pre className=\"locations\">\n                            <strong>Locations:</strong>\n                            {' '}\n                            {JSON.stringify(error.locations, null, 4)}\n                        </pre>\n                    )}\n                    {isGraphQLError && 'path' in error && error.path && (\n                        <pre className=\"path\">\n                            <strong>Path:</strong>\n                            {' '}\n                            {JSON.stringify(error.path, null, 4)}\n                        </pre>\n                    )}\n                    {isGraphQLError && 'extensions' in error && error.extensions && (\n                        <pre className=\"extensions\">\n                            <strong>Extensions:</strong>\n                            {' '}\n                            {JSON.stringify(error.extensions, null, 4)}\n                        </pre>\n                    )}\n                    {!isGraphQLError && (\n                        <pre className=\"error-details\">\n                            <strong>Error Details:</strong>\n                            {' '}\n                            {validate.isEmpty(error) ? errorMessage : JSON.stringify(error, null, 4)}\n                        </pre>\n                    )}\n                </div>\n            </div>\n        </div>\n    );\n}\n"],"mappings":"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"}

package/dist/react/apollo-error/apollo-error.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"apollo-error.util.js","names":[],"sources":["../../../src/react/apollo-error/apollo-error.util.tsx"],"sourcesContent":["import type { GraphQLError } from 'graphql';\n\n/**\n * Global callback function for displaying Apollo errors.\n * This variable holds the callback function that will be called when a global\n * Apollo error needs to be displayed. It is set by the ApolloErrorProvider\n * and used throughout the application for consistent error handling.\n *\n * @remarks\n * **SSR Warning:** These module-level singletons are shared across all requests\n * in SSR environments. In server contexts, ensure the provider is properly\n * scoped per-request to avoid state leaking between concurrent renders.\n */\nlet showErrorCallback: ((err: GraphQLError | Error) => void) | null = null;\nlet hasCustomHandler = false;\n\n/**\n * Sets the global callback function for Apollo error handling.\n * This function registers a callback that will be called whenever a global\n * Apollo error needs to be displayed. The callback is typically set by the\n * ApolloErrorProvider component and used throughout the application for\n * consistent error handling.\n *\n * @param callback - The function to be called when a global Apollo error occurs.\n * @param isCustomHandler - Flag that identifies whether the handler was provided by the consumer.\n */\nexport function setGlobalApolloErrorCallback(\n    callback: (err: GraphQLError | Error) => void,\n    isCustomHandler = false,\n) {\n    showErrorCallback = callback;\n    hasCustomHandler = isCustomHandler;\n}\n\n/**\n * Clears the global callback function for Apollo error handling.\n * Useful when the ApolloErrorProvider unmounts to avoid stale references.\n */\nexport function clearGlobalApolloErrorCallback() {\n    showErrorCallback = null;\n    hasCustomHandler = false;\n}\n\n/**\n * Indicates whether a custom Apollo error handler is registered.\n *\n * @returns True if a custom handler is registered, otherwise false.\n */\nexport function hasCustomApolloErrorHandler() {\n    return hasCustomHandler;\n}\n\n/**\n * Displays a global Apollo error using the registered callback.\n * This function triggers the global error display system by calling the\n * registered callback function. If no callback is registered, the function\n * does nothing, providing safe error handling even when the provider is not set up.\n *\n * @param error - The Apollo error to display globally.\n */\nexport function showGlobalApolloError(error: GraphQLError | Error) {\n    showErrorCallback?.(error);\n}\n"],"mappings":";AAaA,IAAI,IAAkE,MAClE,IAAmB;AAYvB,SAAgB,EACZ,GACA,IAAkB,IACpB;AAEE,CADA,IAAoB,GACpB,IAAmB;;AAOvB,SAAgB,IAAiC;AAE7C,CADA,IAAoB,MACpB,IAAmB;;AAQvB,SAAgB,IAA8B;AAC1C,QAAO;;AAWX,SAAgB,EAAsB,GAA6B;AAC/D,KAAoB,EAAM"}
+{"version":3,"file":"apollo-error.util.js","names":[],"sources":["../../../src/react/apollo-error/apollo-error.util.tsx"],"sourcesContent":["import type { GraphQLError } from 'graphql';\n\n/**\n * Global callback function for displaying Apollo errors.\n * This variable holds the callback function that will be called when a global\n * Apollo error needs to be displayed. It is set by the ApolloErrorProvider\n * and used throughout the application for consistent error handling.\n *\n * @remarks\n * **SSR Warning — Known Limitation:** These module-level singletons are shared\n * across all requests in SSR environments (e.g., Next.js). In server contexts,\n * Request A's error handler could be invoked for Request B's error, causing\n * intermittent wrong-user error display. This module is designed for **client-side\n * use only**. For SSR, ensure the provider is properly scoped per-request\n * or use a request-scoped error handling strategy.\n */\nlet showErrorCallback: ((err: GraphQLError | Error) => void) | null = null;\nlet hasCustomHandler = false;\n\n/**\n * Sets the global callback function for Apollo error handling.\n * This function registers a callback that will be called whenever a global\n * Apollo error needs to be displayed. The callback is typically set by the\n * ApolloErrorProvider component and used throughout the application for\n * consistent error handling.\n *\n * @param callback - The function to be called when a global Apollo error occurs.\n * @param isCustomHandler - Flag that identifies whether the handler was provided by the consumer.\n */\nexport function setGlobalApolloErrorCallback(\n    callback: (err: GraphQLError | Error) => void,\n    isCustomHandler = false,\n) {\n    showErrorCallback = callback;\n    hasCustomHandler = isCustomHandler;\n}\n\n/**\n * Clears the global callback function for Apollo error handling.\n * Useful when the ApolloErrorProvider unmounts to avoid stale references.\n */\nexport function clearGlobalApolloErrorCallback() {\n    showErrorCallback = null;\n    hasCustomHandler = false;\n}\n\n/**\n * Indicates whether a custom Apollo error handler is registered.\n *\n * @returns True if a custom handler is registered, otherwise false.\n */\nexport function hasCustomApolloErrorHandler() {\n    return hasCustomHandler;\n}\n\n/**\n * Displays a global Apollo error using the registered callback.\n * This function triggers the global error display system by calling the\n * registered callback function. If no callback is registered, the function\n * does nothing, providing safe error handling even when the provider is not set up.\n *\n * @param error - The Apollo error to display globally.\n */\nexport function showGlobalApolloError(error: GraphQLError | Error) {\n    showErrorCallback?.(error);\n}\n"],"mappings":";AAgBA,IAAI,IAAkE,MAClE,IAAmB;AAYvB,SAAgB,EACZ,GACA,IAAkB,IACpB;AAEE,CADA,IAAoB,GACpB,IAAmB;;AAOvB,SAAgB,IAAiC;AAE7C,CADA,IAAoB,MACpB,IAAmB;;AAQvB,SAAgB,IAA8B;AAC1C,QAAO;;AAWX,SAAgB,EAAsB,GAA6B;AAC/D,KAAoB,EAAM"}

package/dist/react/apollo-error/index.d.ts

@@ -1 +1,6 @@
-export {}
+export * from './apollo-error.component.js';
+export * from './apollo-error.context.js';
+export * from './apollo-error.hook.js';
+export * from './apollo-error.provider.js';
+export * from './apollo-error.type.js';
+export * from './apollo-error.util.js';

package/dist/react/i18next/i18next.server.d.ts

@@ -0,0 +1,17 @@
+import { i18n as I18nInstance } from 'i18next';
+export interface I_GetTranslationsI18nextOptions {
+    /**
+     * Optional i18n instance. If not provided, it falls back to the global i18next instance.
+     */
+    i18n?: I18nInstance;
+}
+/**
+ * Retrieves the i18next translation function outside of React components.
+ * This provides access to translation functions for use in server components,
+ * non-React environments, or normal JS functions.
+ *
+ * @param namespace - Optional namespace to load translations from.
+ * @param options - Options object allowing injection of a specific i18n instance.
+ * @returns The translation function (`t`) bound to the specified namespace and instance.
+ */
+export declare function getTranslationsI18next(namespace?: string | null, options?: I_GetTranslationsI18nextOptions): import('i18next').TFunction<string, undefined>;

package/dist/react/i18next/i18next.server.js

@@ -0,0 +1,9 @@
+import e from "i18next";
+//#region src/react/i18next/i18next.server.ts
+function t(t, n) {
+	return (n?.i18n || e).getFixedT(null, t ?? null);
+}
+//#endregion
+export { t as getTranslationsI18next };
+
+//# sourceMappingURL=i18next.server.js.map

package/dist/react/i18next/i18next.server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18next.server.js","names":[],"sources":["../../../src/react/i18next/i18next.server.ts"],"sourcesContent":["import type { i18n as I18nInstance } from 'i18next';\n\nimport globalI18nextInstance from 'i18next';\n\nexport interface I_GetTranslationsI18nextOptions {\n    /**\n     * Optional i18n instance. If not provided, it falls back to the global i18next instance.\n     */\n    i18n?: I18nInstance;\n}\n\n/**\n * Retrieves the i18next translation function outside of React components.\n * This provides access to translation functions for use in server components,\n * non-React environments, or normal JS functions.\n *\n * @param namespace - Optional namespace to load translations from.\n * @param options - Options object allowing injection of a specific i18n instance.\n * @returns The translation function (`t`) bound to the specified namespace and instance.\n */\nexport function getTranslationsI18next(\n    namespace?: string | null,\n    options?: I_GetTranslationsI18nextOptions,\n) {\n    const instance = options?.i18n || globalI18nextInstance;\n\n    // We bind using getFixedT to ensure the namespace is locked to this t function\n    return instance.getFixedT(null, namespace ?? null);\n}\n"],"mappings":";;AAoBA,SAAgB,EACZ,GACA,GACF;AAIE,SAHiB,GAAS,QAAQ,GAGlB,UAAU,MAAM,KAAa,KAAK"}

package/dist/react/i18next/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './i18next.hook.js';
+export * from './i18next.util.js';

package/dist/react/loading/index.d.ts

@@ -1 +1,5 @@
-export {}
+export * from './loading.component.js';
+export * from './loading.context.js';
+export * from './loading.hook.js';
+export * from './loading.provider.js';
+export * from './loading.type.js';

package/dist/{src/react → react}/loading/loading.provider.d.ts

@@ -1,4 +1,4 @@
-import { I_Children } from '../../../typescript/index.js';
+import { I_Children } from '../../typescript/index.js';
 import * as React from 'react';
 /**
  * Provider component that manages loading state and provides loading context.

package/dist/react/log/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './log.type.js';
+export * from './log.util.js';

package/dist/react/log/log.type.d.ts

@@ -0,0 +1 @@
+export type { I_CatchErrorOptions } from '../../util/log/index.js';

package/dist/{src/react → react}/log/log.util.d.ts

@@ -1,4 +1,4 @@
-import { I_Log, I_Return } from '../../../typescript/index.js';
+import { I_Log, I_Return } from '../../typescript/index.js';
 import { I_CatchErrorOptions } from './log.type.js';
 /**
  * Browser-compatible logging interface using consola.

package/dist/react/next-intl/index.d.ts

@@ -1 +1,6 @@
-export {}
+export * from './next-intl.constant.js';
+export * from './next-intl.context.js';
+export * from './next-intl.hoc.js';
+export * from './next-intl.hook.js';
+export * from './next-intl.provider.js';
+export * from './next-intl.type.js';

package/dist/{src/react → react}/next-intl/next-intl.hoc.d.ts

@@ -1,7 +1,6 @@
 import { ComponentType } from 'react';
-import { I_Children } from '../../../typescript/index.js';
+import { I_Children } from '../../typescript/index.js';
 import { I_NextIntlLanguage, T_NextIntlMessageList } from './next-intl.type.js';
-import * as React from 'react';
 /**
  * Higher-Order Component (HOC) that wraps components with Next.js internationalization support.
  * This HOC provides internationalization capabilities to React components by wrapping them
@@ -18,10 +17,7 @@ import * as React from 'react';
  * @param Component - The React component to wrap with internationalization support.
  * @returns A new component with internationalization capabilities and additional props for languages and messages.
  */
-export declare function withNextIntl<T extends I_Children>(Component: ComponentType<T>): {
-    (props: T & {
-        languages: I_NextIntlLanguage[];
-        messages: T_NextIntlMessageList;
-    }): React.JSX.Element | null;
-    displayName: string;
-};
+export declare function withNextIntl<T extends I_Children>(Component: ComponentType<T>): ComponentType<T & {
+    languages: I_NextIntlLanguage[];
+    messages: T_NextIntlMessageList;
+}>;

package/dist/react/next-intl/next-intl.hoc.js

@@ -5,17 +5,21 @@ import * as r from "react";
 import { NextIntlClientProvider as i } from "next-intl";
 //#region src/react/next-intl/next-intl.hoc.tsx
 function a(a) {
-	let o = (o) => {
-		let { currentLanguage: s } = n(), { messages: c, languages: l } = o, u = c[s?.value || "en"], d = l.find((e) => e.value === s?.value)?.timezone ?? t.timezone;
-		return c ? /* @__PURE__ */ r.createElement(i, {
-			locale: s?.value || "en",
-			messages: u || null,
-			timeZone: d
-		}, /* @__PURE__ */ r.createElement(a, o)) : (e.warn(`Missing messages for language: ${s?.value || "en"}`), null);
-	};
-	return o.displayName = `withNextIntl(${a.displayName || a.name || "Component"})`, o;
+	let { currentLanguage: o } = n(), { messages: s, languages: c, TargetComponent: l } = a, u = s[o?.value || "en"], d = c.find((e) => e.value === o?.value)?.timezone ?? t.timezone;
+	return s ? /* @__PURE__ */ r.createElement(i, {
+		locale: o?.value || "en",
+		messages: u || null,
+		timeZone: d
+	}, /* @__PURE__ */ r.createElement(l, a)) : (e.warn(`Missing messages for language: ${o?.value || "en"}`), null);
+}
+function o(e) {
+	let t = (t) => /* @__PURE__ */ r.createElement(a, {
+		...t,
+		TargetComponent: e
+	});
+	return t.displayName = `withNextIntl(${e.displayName || e.name || "Component"})`, t;
 }
 //#endregion
-export { a as withNextIntl };
+export { o as withNextIntl };
 
 //# sourceMappingURL=next-intl.hoc.js.map

package/dist/react/next-intl/next-intl.hoc.js.map

@@ -1 +1 @@
-{"version":3,"file":"next-intl.hoc.js","names":[],"sources":["../../../src/react/next-intl/next-intl.hoc.tsx"],"sourcesContent":["import type { ComponentType } from 'react';\n\nimport { NextIntlClientProvider } from 'next-intl';\nimport * as React from 'react';\n\nimport type { I_Children } from '#typescript/index.js';\n\nimport type { I_NextIntlLanguage, T_NextIntlMessageList } from './next-intl.type.js';\n\nimport { log } from '../log/index.js';\nimport { NEXT_INTL_DEFAULT_LANGUAGE } from './next-intl.constant.js';\nimport { useNextIntl } from './next-intl.hook.js';\n\n/**\n * Higher-Order Component (HOC) that wraps components with Next.js internationalization support.\n * This HOC provides internationalization capabilities to React components by wrapping them\n * with the NextIntlClientProvider. It automatically handles language detection, message\n * loading, and timezone configuration based on the current language settings.\n *\n * Features:\n * - Automatic language detection and message loading\n * - Timezone configuration based on language settings\n * - Fallback to default language when messages are missing\n * - Warning logging for missing message configurations\n * - Proper display name preservation for debugging\n *\n * @param Component - The React component to wrap with internationalization support.\n * @returns A new component with internationalization capabilities and additional props for languages and messages.\n */\nexport function withNextIntl<T extends I_Children>(Component: ComponentType<T>) {\n    const PageWithI18n = (props: T & { languages: I_NextIntlLanguage[]; messages: T_NextIntlMessageList }) => {\n        const { currentLanguage } = useNextIntl();\n        const { messages, languages } = props;\n        const defaultLang = 'en';\n\n        const defaultMessages = messages[currentLanguage?.value || defaultLang];\n        const timeZone = languages.find(lang => lang.value === currentLanguage?.value)?.timezone ?? NEXT_INTL_DEFAULT_LANGUAGE.timezone;\n\n        if (!messages) {\n            log.warn(`Missing messages for language: ${currentLanguage?.value || defaultLang}`);\n            return null;\n        }\n\n        return (\n            <NextIntlClientProvider\n                locale={currentLanguage?.value || defaultLang}\n                messages={defaultMessages || null}\n                timeZone={timeZone}\n            >\n                <Component {...(props as T)} />\n            </NextIntlClientProvider>\n        );\n    };\n\n    PageWithI18n.displayName = `withNextIntl(${Component.displayName || Component.name || 'Component'})`;\n\n    return PageWithI18n;\n}\n"],"mappings":";;;;;;AA6BA,SAAgB,EAAmC,GAA6B;CAC5E,IAAM,KAAgB,MAAoF;EACtG,IAAM,EAAE,uBAAoB,GAAa,EACnC,EAAE,aAAU,iBAAc,GAG1B,IAAkB,EAAS,GAAiB,SAAS,OACrD,IAAW,EAAU,MAAK,MAAQ,EAAK,UAAU,GAAiB,MAAM,EAAE,YAAY,EAA2B;AAOvH,SALK,IAMD,kBAAA,cAAC,GAAD;GACI,QAAQ,GAAiB,SAAS;GAClC,UAAU,KAAmB;GACnB;GAGW,EADrB,kBAAA,cAAC,GAAe,EAAe,CACV,IAXzB,EAAI,KAAK,kCAAkC,GAAiB,SAAS,OAAc,EAC5E;;AAgBf,QAFA,EAAa,cAAc,gBAAgB,EAAU,eAAe,EAAU,QAAQ,YAAY,IAE3F"}
+{"version":3,"file":"next-intl.hoc.js","names":[],"sources":["../../../src/react/next-intl/next-intl.hoc.tsx"],"sourcesContent":["import type { ComponentType } from 'react';\n\nimport { NextIntlClientProvider } from 'next-intl';\nimport * as React from 'react';\n\nimport type { I_Children } from '#typescript/index.js';\n\nimport type { I_NextIntlLanguage, T_NextIntlMessageList } from './next-intl.type.js';\n\nimport { log } from '../log/index.js';\nimport { NEXT_INTL_DEFAULT_LANGUAGE } from './next-intl.constant.js';\nimport { useNextIntl } from './next-intl.hook.js';\n\n/**\n * Internal component wrapper for the HOC\n */\n// eslint-disable-next-line react-refresh/only-export-components -- HOC is an allowed export\nfunction PageWithI18nInternal<T extends I_Children>(\n    props: T & { languages: I_NextIntlLanguage[]; messages: T_NextIntlMessageList; TargetComponent: ComponentType<T> },\n) {\n    const { currentLanguage } = useNextIntl();\n    const { messages, languages, TargetComponent } = props;\n    const defaultLang = 'en';\n\n    const defaultMessages = messages[currentLanguage?.value || defaultLang];\n    const timeZone = languages.find(lang => lang.value === currentLanguage?.value)?.timezone ?? NEXT_INTL_DEFAULT_LANGUAGE.timezone;\n\n    if (!messages) {\n        log.warn(`Missing messages for language: ${currentLanguage?.value || defaultLang}`);\n        return null;\n    }\n\n    return (\n        <NextIntlClientProvider\n            locale={currentLanguage?.value || defaultLang}\n            messages={defaultMessages || null}\n            timeZone={timeZone}\n        >\n            <TargetComponent {...(props as T)} />\n        </NextIntlClientProvider>\n    );\n}\n\n/**\n * Higher-Order Component (HOC) that wraps components with Next.js internationalization support.\n * This HOC provides internationalization capabilities to React components by wrapping them\n * with the NextIntlClientProvider. It automatically handles language detection, message\n * loading, and timezone configuration based on the current language settings.\n *\n * Features:\n * - Automatic language detection and message loading\n * - Timezone configuration based on language settings\n * - Fallback to default language when messages are missing\n * - Warning logging for missing message configurations\n * - Proper display name preservation for debugging\n *\n * @param Component - The React component to wrap with internationalization support.\n * @returns A new component with internationalization capabilities and additional props for languages and messages.\n */\nexport function withNextIntl<T extends I_Children>(Component: ComponentType<T>) {\n    const hoc = (props: T & { languages: I_NextIntlLanguage[]; messages: T_NextIntlMessageList }) => {\n        return <PageWithI18nInternal {...props} TargetComponent={Component} />;\n    };\n\n    hoc.displayName = `withNextIntl(${Component.displayName || Component.name || 'Component'})`;\n\n    return hoc as unknown as ComponentType<T & { languages: I_NextIntlLanguage[]; messages: T_NextIntlMessageList }>;\n}\n"],"mappings":";;;;;;AAiBA,SAAS,EACL,GACF;CACE,IAAM,EAAE,uBAAoB,GAAa,EACnC,EAAE,aAAU,cAAW,uBAAoB,GAG3C,IAAkB,EAAS,GAAiB,SAAS,OACrD,IAAW,EAAU,MAAK,MAAQ,EAAK,UAAU,GAAiB,MAAM,EAAE,YAAY,EAA2B;AAOvH,QALK,IAMD,kBAAA,cAAC,GAAD;EACI,QAAQ,GAAiB,SAAS;EAClC,UAAU,KAAmB;EACnB;EAGW,EADrB,kBAAA,cAAC,GAAqB,EAAe,CAChB,IAXzB,EAAI,KAAK,kCAAkC,GAAiB,SAAS,OAAc,EAC5E;;AA8Bf,SAAgB,EAAmC,GAA6B;CAC5E,IAAM,KAAO,MACF,kBAAA,cAAC,GAAD;EAAsB,GAAI;EAAO,iBAAiB;EAAa,CAAA;AAK1E,QAFA,EAAI,cAAc,gBAAgB,EAAU,eAAe,EAAU,QAAQ,YAAY,IAElF"}

package/dist/react/next-intl/next-intl.server.d.ts

@@ -0,0 +1,10 @@
+import { getTranslations } from 'next-intl/server';
+/**
+ * Retrieves the translation function from Next.js internationalization context on the server.
+ * This function wraps next-intl/server's getTranslations, returning a Promise that resolves
+ * to the translation function. It enables asynchronous translation resolution for server components
+ * and server actions.
+ *
+ * @returns A Promise that resolves to the getTranslations function.
+ */
+export declare const getTranslationsNextIntl: typeof getTranslations;

package/dist/react/next-intl/next-intl.server.js

@@ -0,0 +1,7 @@
+import { getTranslations as e } from "next-intl/server";
+//#region src/react/next-intl/next-intl.server.ts
+var t = e;
+//#endregion
+export { t as getTranslationsNextIntl };
+
+//# sourceMappingURL=next-intl.server.js.map

package/dist/react/next-intl/next-intl.server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-intl.server.js","names":[],"sources":["../../../src/react/next-intl/next-intl.server.ts"],"sourcesContent":["import { getTranslations } from 'next-intl/server';\n\n/**\n * Retrieves the translation function from Next.js internationalization context on the server.\n * This function wraps next-intl/server's getTranslations, returning a Promise that resolves\n * to the translation function. It enables asynchronous translation resolution for server components\n * and server actions.\n *\n * @returns A Promise that resolves to the getTranslations function.\n */\nexport const getTranslationsNextIntl: typeof getTranslations = getTranslations;\n"],"mappings":";;AAUA,IAAa,IAAkD"}

package/dist/{src/react → react}/next-intl/next-intl.type.d.ts

@@ -1,6 +1,6 @@
 import { Locale } from 'date-fns';
 import { AbstractIntlMessages, Timezone } from 'next-intl';
-import { I_Children } from '../../../typescript/index.js';
+import { I_Children } from '../../typescript/index.js';
 export interface I_NextIntlLanguage {
     label: string;
     value: string;

package/dist/react/storage/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './storage.hook.js';
+export * from './storage.util.js';

package/dist/{src/react → react}/storage/storage.hook.d.ts

@@ -1,4 +1,4 @@
-import { I_Serializer } from '../../../util/serializer/index.js';
+import { I_Serializer } from '../../util/serializer/index.js';
 /**
  * React hook that provides persistent storage functionality with automatic serialization.
  * This hook manages state that persists across browser sessions using localStorage,

package/dist/{src/react → react}/storage/storage.util.d.ts

@@ -21,9 +21,13 @@ export declare const storage: {
      *
      * @param key - The unique identifier for the value to store.
      * @param value - The data to store (will be automatically serialized to JSON).
+     * @param options - Optional settings.
+     * @param options.ttlMs - The time-to-live in milliseconds.
      * @returns A promise that resolves when the storage operation is complete.
      */
-    set<T = unknown>(key: string, value: T): Promise<void>;
+    set<T = unknown>(key: string, value: T, options?: {
+        ttlMs?: number;
+    }): Promise<void>;
     /**
      * Removes a value from browser storage by key.
      * This method permanently deletes the stored data associated with the specified key.
@@ -41,4 +45,33 @@ export declare const storage: {
      * @returns A promise that resolves to an array of storage keys.
      */
     keys(): Promise<string[]>;
+    /**
+     * Checks if a key exists in browser storage.
+     * This method efficiently checks for key existence without deserializing the value.
+     * It also respects TTL — returns false if the key exists but has expired.
+     *
+     * @param key - The unique identifier to check.
+     * @returns A promise that resolves to true if the key exists and has not expired.
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Clears all values from browser storage.
+     * This method permanently removes all stored data.
+     *
+     * @returns A promise that resolves when the clear operation is complete.
+     */
+    clear(): Promise<void>;
+    /**
+     * Retrieves a value from browser storage, or creates and stores it if it doesn't exist.
+     * This method combines check, creation, and storage into a single convenient operation.
+     *
+     * @param key - The unique identifier for the value.
+     * @param factory - A function (sync or async) that generates the value if it's missing or expired.
+     * @param options - Optional storage options.
+     * @param options.ttlMs - The time-to-live in milliseconds.
+     * @returns A promise that resolves to the retrieved or newly created value.
+     */
+    getOrSet<T = unknown>(key: string, factory: () => T | Promise<T>, options?: {
+        ttlMs?: number;
+    }): Promise<T>;
 };