@cyberskill/shared 2.19.0 → 2.19.1

package/dist/config/eslint/index.d.ts

@@ -207,6 +207,7 @@ declare const _default: {
             DeviceOrientationEvent: false;
             devicePixelRatio: false;
             DevicePosture: false;
+            DigitalCredential: false;
             dispatchEvent: false;
             DisposableStack: false;
             document: false;
@@ -434,6 +435,7 @@ declare const _default: {
             IDBKeyRange: false;
             IDBObjectStore: false;
             IDBOpenDBRequest: false;
+            IDBRecord: false;
             IDBRequest: false;
             IDBTransaction: false;
             IDBVersionChangeEvent: false;
@@ -459,6 +461,7 @@ declare const _default: {
             InputDeviceInfo: false;
             InputEvent: false;
             IntegrityViolationReportBody: false;
+            InterestEvent: false;
             IntersectionObserver: false;
             IntersectionObserverEntry: false;
             isSecureContext: false;
@@ -548,6 +551,7 @@ declare const _default: {
             NavigationCurrentEntryChangeEvent: false;
             NavigationDestination: false;
             NavigationHistoryEntry: false;
+            NavigationPrecommitController: false;
             NavigationPreloadManager: false;
             NavigationTransition: false;
             navigator: false;
@@ -878,6 +882,7 @@ declare const _default: {
             SpeechRecognition: false;
             SpeechRecognitionErrorEvent: false;
             SpeechRecognitionEvent: false;
+            SpeechRecognitionPhrase: false;
             speechSynthesis: false;
             SpeechSynthesis: false;
             SpeechSynthesisErrorEvent: false;

package/dist/config/vitest/vitest.e2e.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("@vitejs/plugin-react-swc"),i=require("lodash-es"),o=require("../../node_modules/.pnpm/vitest@4.0.6_@types_debug@4.1.12_@types_node@24.9.2_jiti@2.6.1_jsdom@27.1.0_sass@1.93.3_tsx@4.20.6_yaml@2.8.1/node_modules/vitest/dist/config.cjs");function s(e){const r={plugins:[t()],test:{include:["**/*.test.e2e.?(c|m)[jt]s?(x)"],browser:{enabled:!0,provider:"playwright",instances:[{browser:"chromium"},{browser:"firefox"},{browser:"webkit"}]}}};return o.defineConfig(i.merge(r,e))}exports.vitestE2E=s;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("@vitejs/plugin-react-swc"),i=require("lodash-es"),o=require("../../node_modules/.pnpm/vitest@4.0.9_@types_debug@4.1.12_@types_node@24.10.1_jiti@2.6.1_jsdom@27.2.0_sass@1.94.0_tsx@4.20.6_yaml@2.8.1/node_modules/vitest/dist/config.cjs");function s(e){const r={plugins:[t()],test:{include:["**/*.test.e2e.?(c|m)[jt]s?(x)"],browser:{enabled:!0,provider:"playwright",instances:[{browser:"chromium"},{browser:"firefox"},{browser:"webkit"}]}}};return o.defineConfig(i.merge(r,e))}exports.vitestE2E=s;

package/dist/config/vitest/vitest.e2e.js

@@ -1,6 +1,6 @@
 import t from "@vitejs/plugin-react-swc";
 import { merge as o } from "lodash-es";
-import { defineConfig as i } from "../../node_modules/.pnpm/vitest@4.0.6_@types_debug@4.1.12_@types_node@24.9.2_jiti@2.6.1_jsdom@27.1.0_sass@1.93.3_tsx@4.20.6_yaml@2.8.1/node_modules/vitest/dist/config.js";
+import { defineConfig as i } from "../../node_modules/.pnpm/vitest@4.0.9_@types_debug@4.1.12_@types_node@24.10.1_jiti@2.6.1_jsdom@27.2.0_sass@1.94.0_tsx@4.20.6_yaml@2.8.1/node_modules/vitest/dist/config.js";
 function f(r) {
   const e = {
     plugins: [t()],

package/dist/config/vitest/vitest.unit.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("@vitejs/plugin-react-swc"),n=require("lodash-es"),s=require("../../node_modules/.pnpm/vitest@4.0.6_@types_debug@4.1.12_@types_node@24.9.2_jiti@2.6.1_jsdom@27.1.0_sass@1.93.3_tsx@4.20.6_yaml@2.8.1/node_modules/vitest/dist/config.cjs");function r(e){const t={plugins:[i()],test:{globals:!0,environment:"jsdom",pool:"vmThreads",include:["**/*.test.unit.?(c|m)[jt]s?(x)"],setupFiles:["./vitest.unit.setup.ts"]}};return s.defineConfig(n.merge(t,e))}exports.vitestUnit=r;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("@vitejs/plugin-react-swc"),n=require("lodash-es"),s=require("../../node_modules/.pnpm/vitest@4.0.9_@types_debug@4.1.12_@types_node@24.10.1_jiti@2.6.1_jsdom@27.2.0_sass@1.94.0_tsx@4.20.6_yaml@2.8.1/node_modules/vitest/dist/config.cjs");function r(e){const t={plugins:[i()],test:{globals:!0,environment:"jsdom",pool:"vmThreads",include:["**/*.test.unit.?(c|m)[jt]s?(x)"],setupFiles:["./vitest.unit.setup.ts"]}};return s.defineConfig(n.merge(t,e))}exports.vitestUnit=r;

package/dist/config/vitest/vitest.unit.js

@@ -1,6 +1,6 @@
 import i from "@vitejs/plugin-react-swc";
 import { merge as o } from "lodash-es";
-import { defineConfig as n } from "../../node_modules/.pnpm/vitest@4.0.6_@types_debug@4.1.12_@types_node@24.9.2_jiti@2.6.1_jsdom@27.1.0_sass@1.93.3_tsx@4.20.6_yaml@2.8.1/node_modules/vitest/dist/config.js";
+import { defineConfig as n } from "../../node_modules/.pnpm/vitest@4.0.9_@types_debug@4.1.12_@types_node@24.10.1_jiti@2.6.1_jsdom@27.2.0_sass@1.94.0_tsx@4.20.6_yaml@2.8.1/node_modules/vitest/dist/config.js";
 function u(t) {
   const e = {
     plugins: [i()],

package/dist/node/mongo/mongo.type.d.ts

@@ -1,11 +1,11 @@
 import { DeleteResult, Filter, InsertManyResult, InsertOneResult, OptionalUnlessRequiredId, UpdateResult, WithId, Collection, Db } from 'mongodb';
-import { AggregatePaginateModel, AggregatePaginateResult, ClientSession, ErrorHandlingMiddlewareFunction, ErrorHandlingMiddlewareWithOption, FilterQuery, InsertManyOptions, PaginateModel, PaginateOptions, PaginateResult, PipelineStage, PopulateOption, PopulateOptions, PostMiddlewareFunction, PreMiddlewareFunction, PreSaveMiddlewareFunction, ProjectionType, QueryOptions, QueryWithHelpers, Schema, SchemaDefinition, UpdateQuery, default as mongoose, Document, Model } from 'mongoose';
+import { AggregatePaginateModel, AggregatePaginateResult, ClientSession, ErrorHandlingMiddlewareFunction, ErrorHandlingMiddlewareWithOption, FilterQuery, InsertManyOptions, PaginateModel, PaginateOptions, PaginateResult, PipelineStage, PopulateOption, PopulateOptions, PostMiddlewareFunction, PreMiddlewareFunction, PreSaveMiddlewareFunction, ProjectionType, QueryOptions, QueryWithHelpers, Schema, SchemaDefinition, UpdateQuery, UpdateWriteOpResult, default as mongoose, Document, Model } from 'mongoose';
 export declare class C_Db extends Db {
 }
 export type T_Filter<T> = Filter<T>;
 export type T_InsertOneResult<T> = InsertOneResult<T>;
 export type T_InsertManyResult<T> = InsertManyResult<T>;
-export type T_UpdateResult = UpdateResult;
+export type T_UpdateResult = UpdateResult | UpdateWriteOpResult;
 export type T_DeleteResult = DeleteResult;
 export type T_WithId<T> = WithId<T>;
 export type T_OptionalUnlessRequiredId<T> = OptionalUnlessRequiredId<T>;

package/dist/node/mongo/mongo.util.d.ts

@@ -137,9 +137,9 @@ export declare const mongo: {
         }) => void;
         init(): Promise<void>;
         create(description: string): Promise<string>;
-        up(db: mongooseRaw.mongo.Db, client: mongooseRaw.mongo.MongoClient): Promise<string[]>;
-        down(db: mongooseRaw.mongo.Db, client: mongooseRaw.mongo.MongoClient): Promise<string[]>;
-        status(db: mongooseRaw.mongo.Db): Promise<migrate.MigrationStatus[]>;
+        up(db: import('mongodb').Db, client: import('mongodb').MongoClient): Promise<string[]>;
+        down(db: import('mongodb').Db, client: import('mongodb').MongoClient): Promise<string[]>;
+        status(db: import('mongodb').Db): Promise<migrate.MigrationStatus[]>;
         database: typeof migrate.database;
         config: typeof migrate.config;
     };

package/dist/react/apollo-client/apollo-client.component.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("@apollo/client/react"),e=require("react"),n=require("./apollo-client.context.cjs"),i=require("./apollo-client.util.cjs"),a=require("../apollo-error/apollo-error.provider.cjs"),u=require("../apollo-error/apollo-error.component.cjs"),c=require("react-hot-toast");function p({options:r,children:l}){const o=e.useMemo(()=>i.getClient(r!=null?r:{}),[r]);return e.createElement(e.Fragment,null,e.createElement(a.ApolloErrorProvider,null,e.createElement(n.ApolloClientProvider,{client:o},e.createElement(t.ApolloProvider,{client:o},l)),e.createElement(u.ApolloErrorComponent,null)),e.createElement(c.Toaster,{position:"top-right"}))}exports.ApolloProvider=p;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("@apollo/client/react"),e=require("react"),i=require("./apollo-client.context.cjs"),a=require("./apollo-client.util.cjs"),c=require("../apollo-error/apollo-error.provider.cjs"),u=require("../apollo-error/apollo-error.component.cjs"),p=require("react-hot-toast");function m({options:r,children:t,onError:o}){const l=e.useMemo(()=>a.getClient(r!=null?r:{}),[r]);return e.createElement(e.Fragment,null,e.createElement(c.ApolloErrorProvider,{onError:o},e.createElement(i.ApolloClientProvider,{client:l},e.createElement(n.ApolloProvider,{client:l},t)),!o&&e.createElement(u.ApolloErrorComponent,null)),e.createElement(p.Toaster,{position:"top-right"}))}exports.ApolloProvider=m;

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

@@ -13,9 +13,10 @@ import { I_ApolloProviderProps } from './apollo-client.type.js';
  * - Automatic error handling
  * - Development and production optimizations
  *
- * @param props - Component props containing options and children.
+ * @param props - Component props containing options, children, and optional error override.
  * @param props.options - Apollo Client configuration options.
  * @param props.children - React children that will have access to Apollo Client context.
+ * @param props.onError - Optional callback to override the default modal/toast error handling.
  * @returns A React component that provides Apollo Client context to its children.
  */
-export declare function ApolloProvider({ options, children }: I_ApolloProviderProps): React.JSX.Element;
+export declare function ApolloProvider({ options, children, onError }: I_ApolloProviderProps): React.JSX.Element;

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

@@ -1,17 +1,17 @@
-import { ApolloProvider as l } from "@apollo/client/react";
-import r, { useMemo as m } from "react";
+import { ApolloProvider as m } from "@apollo/client/react";
+import e, { useMemo as i } from "react";
 import { ApolloClientProvider as n } from "./apollo-client.context.js";
-import { getClient as i } from "./apollo-client.util.js";
-import { ApolloErrorProvider as p } from "../apollo-error/apollo-error.provider.js";
-import { ApolloErrorComponent as a } from "../apollo-error/apollo-error.component.js";
-import { Toaster as c } from "react-hot-toast";
-function g({ options: e, children: t }) {
-  const o = m(
-    () => i(e != null ? e : {}),
-    [e]
+import { getClient as p } from "./apollo-client.util.js";
+import { ApolloErrorProvider as a } from "../apollo-error/apollo-error.provider.js";
+import { ApolloErrorComponent as c } from "../apollo-error/apollo-error.component.js";
+import { Toaster as f } from "react-hot-toast";
+function s({ options: r, children: l, onError: o }) {
+  const t = i(
+    () => p(r != null ? r : {}),
+    [r]
   );
-  return /* @__PURE__ */ r.createElement(r.Fragment, null, /* @__PURE__ */ r.createElement(p, null, /* @__PURE__ */ r.createElement(n, { client: o }, /* @__PURE__ */ r.createElement(l, { client: o }, t)), /* @__PURE__ */ r.createElement(a, null)), /* @__PURE__ */ r.createElement(c, { position: "top-right" }));
+  return /* @__PURE__ */ e.createElement(e.Fragment, null, /* @__PURE__ */ e.createElement(a, { onError: o }, /* @__PURE__ */ e.createElement(n, { client: t }, /* @__PURE__ */ e.createElement(m, { client: t }, l)), !o && /* @__PURE__ */ e.createElement(c, null)), /* @__PURE__ */ e.createElement(f, { position: "top-right" }));
 }
 export {
-  g as ApolloProvider
+  s as ApolloProvider
 };

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

@@ -1,5 +1,6 @@
 import { ApolloClient } from '@apollo/client';
 import { ApolloLink } from '@apollo/client/link';
+import { GraphQLError } from 'graphql';
 import { I_Children } from '../../typescript/index.js';
 export interface I_ApolloOptions extends Omit<ApolloClient.Options, 'link' | 'cache'> {
     uri?: string;
@@ -9,5 +10,10 @@ export interface I_ApolloOptions extends Omit<ApolloClient.Options, 'link' | 'ca
 export interface I_ApolloProviderProps extends I_Children {
     isNextJS?: boolean;
     options?: I_ApolloOptions;
+    /**
+     * Optional callback to override the default Apollo error modal/toast handling.
+     * When provided, the consumer is responsible for surfacing GraphQL errors.
+     */
+    onError?: (error: GraphQLError | Error) => void;
 }
 export type { ApolloCache, ApolloClient, ErrorLike } from '@apollo/client';

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

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("@apollo/client/core"),p=require("@apollo/client/link"),_=require("@apollo/client/link/error"),y=require("@apollo/client/link/remove-typename"),q=require("@apollo/client/link/subscriptions"),h=require("graphql"),v=require("graphql-ws"),c=require("react"),E=require("rxjs"),m=require("./apollo-client.constant.cjs"),f=require("./apollo-client.module.scss.cjs"),b=require("./links/upload.cjs"),P=require("../apollo-error/apollo-error.util.cjs"),l=require("../log/log.util.cjs"),d=require("react-hot-toast");var A=Object.defineProperty,L=Object.getOwnPropertySymbols,C=Object.prototype.hasOwnProperty,O=Object.prototype.propertyIsEnumerable,g=(e,r,o)=>r in e?A(e,r,{enumerable:!0,configurable:!0,writable:!0,value:o}):e[r]=o,T=(e,r)=>{for(var o in r||(r={}))C.call(r,o)&&g(e,o,r[o]);if(L)for(var o of L(r))O.call(r,o)&&g(e,o,r[o]);return e};const N=new p.ApolloLink((e,r)=>(e.setContext({start:new Date}),r(e).pipe(E.tap(()=>{const o=new Date().getTime()-e.getContext().start;l.log.info(`Operation ${e.operationName} took ${o}ms to complete`)})))),$=new _.ErrorLink(({error:e,operation:r})=>{const o=(r==null?void 0:r.operationName)||"Unknown";let t="";a.CombinedGraphQLErrors.is(e)?e.errors.forEach(({message:n,locations:i,path:s},u)=>{u===0&&(t=n),l.log.error(`[GraphQL error] ${o}: ${n}, Location: ${JSON.stringify(i,null,4)}, Path: ${s}`)}):a.CombinedProtocolErrors.is(e)?e.errors.forEach(({message:n,extensions:i},s)=>{s===0&&(t=n),l.log.error(`[Protocol error]: ${n}, Extensions: ${JSON.stringify(i,null,4)}`)}):a.ServerError.is(e)?(t=e.message,l.log.error(`[Server error]: ${e.message}`)):(t=e.message,l.log.error(`[Network error]: ${e.message}`)),e&&t&&typeof window!="undefined"&&d.toast.error(n=>c.createElement("div",{className:f.default["error-container"]},t,c.createElement("button",{type:"button",className:f.default["error-details-button"],onClick:()=>{setTimeout(()=>{P.showGlobalApolloError(e)},0),d.toast.dismiss(n.id)}},"Error Details")))});function k(e){const{uri:r,wsUrl:o,customLinks:t}=e,n=new y.RemoveTypenameFromVariablesLink;r||l.log.warn(`[Apollo] No GraphQL URI provided — using "${m.GRAPHQL_URI_DEFAULT}" as default`);const i=b.createUploadLink({uri:r!=null?r:m.GRAPHQL_URI_DEFAULT,credentials:"include",headers:{"apollo-require-preflight":"true"}}),s=o?new q.GraphQLWsLink(v.createClient({url:o})):p.ApolloLink.empty(),u=o?p.ApolloLink.split(({operationType:w})=>w===h.OperationTypeNode.SUBSCRIPTION,s,i):i;return o&&u===i&&l.log.warn("[Apollo] WS URL is set, but subscriptions fallback to HTTP. Check your wsLink config."),[N,$,n,...t!=null?t:[],u]}function S(e){const r=p.ApolloLink.from(k(e));return new a.ApolloClient(T({link:r,cache:new a.InMemoryCache},e))}exports.createApolloLinks=k;exports.getClient=S;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("@apollo/client/core"),p=require("@apollo/client/link"),h=require("@apollo/client/link/error"),y=require("@apollo/client/link/remove-typename"),q=require("@apollo/client/link/subscriptions"),E=require("graphql"),b=require("graphql-ws"),f=require("react"),v=require("rxjs"),m=require("./apollo-client.constant.cjs"),d=require("./apollo-client.module.scss.cjs"),A=require("./links/upload.cjs"),c=require("../apollo-error/apollo-error.util.cjs"),i=require("../log/log.util.cjs"),L=require("react-hot-toast");var C=Object.defineProperty,g=Object.getOwnPropertySymbols,P=Object.prototype.hasOwnProperty,O=Object.prototype.propertyIsEnumerable,k=(e,r,o)=>r in e?C(e,r,{enumerable:!0,configurable:!0,writable:!0,value:o}):e[r]=o,T=(e,r)=>{for(var o in r||(r={}))P.call(r,o)&&k(e,o,r[o]);if(g)for(var o of g(r))O.call(r,o)&&k(e,o,r[o]);return e};const N=new p.ApolloLink((e,r)=>(e.setContext({start:new Date}),r(e).pipe(v.tap(()=>{const o=new Date().getTime()-e.getContext().start;i.log.info(`Operation ${e.operationName} took ${o}ms to complete`)})))),$=new h.ErrorLink(({error:e,operation:r})=>{const o=(r==null?void 0:r.operationName)||"Unknown";let t="";a.CombinedGraphQLErrors.is(e)?e.errors.forEach(({message:l,locations:n,path:s},u)=>{u===0&&(t=l),i.log.error(`[GraphQL error] ${o}: ${l}, Location: ${JSON.stringify(n,null,4)}, Path: ${s}`)}):a.CombinedProtocolErrors.is(e)?e.errors.forEach(({message:l,extensions:n},s)=>{s===0&&(t=l),i.log.error(`[Protocol error]: ${l}, Extensions: ${JSON.stringify(n,null,4)}`)}):a.ServerError.is(e)?(t=e.message,i.log.error(`[Server error]: ${e.message}`)):(t=e.message,i.log.error(`[Network error]: ${e.message}`)),e&&t&&typeof window!="undefined"&&(c.hasCustomApolloErrorHandler()?c.showGlobalApolloError(e):L.toast.error(l=>f.createElement("div",{className:d.default["error-container"]},t,f.createElement("button",{type:"button",className:d.default["error-details-button"],onClick:()=>{c.showGlobalApolloError(e),L.toast.dismiss(l.id)}},"Error Details"))))});function w(e){const{uri:r,wsUrl:o,customLinks:t}=e,l=new y.RemoveTypenameFromVariablesLink;r||i.log.warn(`[Apollo] No GraphQL URI provided — using "${m.GRAPHQL_URI_DEFAULT}" as default`);const n=A.createUploadLink({uri:r!=null?r:m.GRAPHQL_URI_DEFAULT,credentials:"include",headers:{"apollo-require-preflight":"true"}}),s=o?new q.GraphQLWsLink(b.createClient({url:o})):p.ApolloLink.empty(),u=o?p.ApolloLink.split(({operationType:_})=>_===E.OperationTypeNode.SUBSCRIPTION,s,n):n;return o&&u===n&&i.log.warn("[Apollo] WS URL is set, but subscriptions fallback to HTTP. Check your wsLink config."),[N,$,l,...t!=null?t:[],u]}function S(e){const r=p.ApolloLink.from(w(e));return new a.ApolloClient(T({link:r,cache:new a.InMemoryCache},e))}exports.createApolloLinks=w;exports.getClient=S;

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

@@ -1,86 +1,84 @@
-import { ApolloClient as k, InMemoryCache as y, CombinedGraphQLErrors as g, CombinedProtocolErrors as h, ServerError as v } from "@apollo/client/core";
+import { ApolloClient as y, InMemoryCache as h, CombinedGraphQLErrors as g, CombinedProtocolErrors as E, ServerError as v } from "@apollo/client/core";
 import { ApolloLink as m } from "@apollo/client/link";
-import { ErrorLink as E } from "@apollo/client/link/error";
-import { RemoveTypenameFromVariablesLink as _ } from "@apollo/client/link/remove-typename";
-import { GraphQLWsLink as O } from "@apollo/client/link/subscriptions";
-import { OperationTypeNode as P } from "graphql";
-import { createClient as b } from "graphql-ws";
+import { ErrorLink as _ } from "@apollo/client/link/error";
+import { RemoveTypenameFromVariablesLink as O } from "@apollo/client/link/remove-typename";
+import { GraphQLWsLink as P } from "@apollo/client/link/subscriptions";
+import { OperationTypeNode as b } from "graphql";
+import { createClient as C } from "graphql-ws";
 import p from "react";
 import { tap as N } from "rxjs";
 import { GRAPHQL_URI_DEFAULT as f } from "./apollo-client.constant.js";
 import c from "./apollo-client.module.scss.js";
-import { createUploadLink as C } from "./links/upload.js";
-import { showGlobalApolloError as $ } from "../apollo-error/apollo-error.util.js";
+import { createUploadLink as $ } from "./links/upload.js";
+import { hasCustomApolloErrorHandler as A, showGlobalApolloError as u } from "../apollo-error/apollo-error.util.js";
 import { log as s } from "../log/log.util.js";
-import { toast as u } from "react-hot-toast";
-var T = Object.defineProperty, d = Object.getOwnPropertySymbols, S = Object.prototype.hasOwnProperty, A = Object.prototype.propertyIsEnumerable, w = (r, e, o) => e in r ? T(r, e, { enumerable: !0, configurable: !0, writable: !0, value: o }) : r[e] = o, U = (r, e) => {
+import { toast as d } from "react-hot-toast";
+var S = Object.defineProperty, w = Object.getOwnPropertySymbols, T = Object.prototype.hasOwnProperty, U = Object.prototype.propertyIsEnumerable, L = (r, e, o) => e in r ? S(r, e, { enumerable: !0, configurable: !0, writable: !0, value: o }) : r[e] = o, I = (r, e) => {
   for (var o in e || (e = {}))
-    S.call(e, o) && w(r, o, e[o]);
-  if (d)
-    for (var o of d(e))
-      A.call(e, o) && w(r, o, e[o]);
+    T.call(e, o) && L(r, o, e[o]);
+  if (w)
+    for (var o of w(e))
+      U.call(e, o) && L(r, o, e[o]);
   return r;
 };
-const I = new m((r, e) => (r.setContext({ start: /* @__PURE__ */ new Date() }), e(r).pipe(
+const R = new m((r, e) => (r.setContext({ start: /* @__PURE__ */ new Date() }), e(r).pipe(
   N(() => {
     const o = (/* @__PURE__ */ new Date()).getTime() - r.getContext().start;
     s.info(`Operation ${r.operationName} took ${o}ms to complete`);
   })
-))), R = new E(({ error: r, operation: e }) => {
+))), G = new _(({ error: r, operation: e }) => {
   const o = (e == null ? void 0 : e.operationName) || "Unknown";
   let t = "";
   g.is(r) ? r.errors.forEach(({ message: n, locations: i, path: l }, a) => {
     a === 0 && (t = n), s.error(
       `[GraphQL error] ${o}: ${n}, Location: ${JSON.stringify(i, null, 4)}, Path: ${l}`
     );
-  }) : h.is(r) ? r.errors.forEach(({ message: n, extensions: i }, l) => {
+  }) : E.is(r) ? r.errors.forEach(({ message: n, extensions: i }, l) => {
     l === 0 && (t = n), s.error(
       `[Protocol error]: ${n}, Extensions: ${JSON.stringify(i, null, 4)}`
     );
-  }) : v.is(r) ? (t = r.message, s.error(`[Server error]: ${r.message}`)) : (t = r.message, s.error(`[Network error]: ${r.message}`)), r && t && typeof window != "undefined" && u.error((n) => /* @__PURE__ */ p.createElement("div", { className: c["error-container"] }, t, /* @__PURE__ */ p.createElement(
+  }) : v.is(r) ? (t = r.message, s.error(`[Server error]: ${r.message}`)) : (t = r.message, s.error(`[Network error]: ${r.message}`)), r && t && typeof window != "undefined" && (A() ? u(r) : d.error((n) => /* @__PURE__ */ p.createElement("div", { className: c["error-container"] }, t, /* @__PURE__ */ p.createElement(
     "button",
     {
       type: "button",
       className: c["error-details-button"],
       onClick: () => {
-        setTimeout(() => {
-          $(r);
-        }, 0), u.dismiss(n.id);
+        u(r), d.dismiss(n.id);
       }
     },
     "Error Details"
-  )));
+  ))));
 });
-function G(r) {
-  const { uri: e, wsUrl: o, customLinks: t } = r, n = new _();
+function Q(r) {
+  const { uri: e, wsUrl: o, customLinks: t } = r, n = new O();
   e || s.warn(`[Apollo] No GraphQL URI provided — using "${f}" as default`);
-  const i = C({
+  const i = $({
     uri: e != null ? e : f,
     credentials: "include",
     headers: {
       "apollo-require-preflight": "true"
     }
-  }), l = o ? new O(b({ url: o })) : m.empty(), a = o ? m.split(
-    ({ operationType: L }) => L === P.SUBSCRIPTION,
+  }), l = o ? new P(C({ url: o })) : m.empty(), a = o ? m.split(
+    ({ operationType: k }) => k === b.SUBSCRIPTION,
     l,
     i
   ) : i;
   return o && a === i && s.warn("[Apollo] WS URL is set, but subscriptions fallback to HTTP. Check your wsLink config."), [
-    I,
     R,
+    G,
     n,
     ...t != null ? t : [],
     a
   ];
 }
-function Y(r) {
-  const e = m.from(G(r));
-  return new k(U({
+function Z(r) {
+  const e = m.from(Q(r));
+  return new y(I({
     link: e,
-    cache: new y()
+    cache: new h()
   }, r));
 }
 export {
-  G as createApolloLinks,
-  Y as getClient
+  Q as createApolloLinks,
+  Z as getClient
 };

package/dist/react/apollo-client-nextjs/apollo-client-nextjs.component.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("@apollo/client-integration-nextjs"),e=require("react"),n=require("./apollo-client-nextjs.util.cjs"),i=require("../apollo-error/apollo-error.provider.cjs"),a=require("../apollo-error/apollo-error.component.cjs"),u=require("react-hot-toast");function p({options:r,children:o}){const t=e.useMemo(()=>()=>n.getClient(r||{}),[r]);return e.createElement(e.Fragment,null,e.createElement(i.ApolloErrorProvider,null,e.createElement(l.ApolloNextAppProvider,{makeClient:t},o),e.createElement(a.ApolloErrorComponent,null)),e.createElement(u.Toaster,{position:"top-right"}))}exports.ApolloProvider=p;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("@apollo/client-integration-nextjs"),e=require("react"),i=require("./apollo-client-nextjs.util.cjs"),a=require("../apollo-error/apollo-error.provider.cjs"),p=require("../apollo-error/apollo-error.component.cjs"),u=require("react-hot-toast");function c({options:r,children:o,onError:t}){const l=e.useMemo(()=>()=>i.getClient(r||{}),[r]);return e.createElement(e.Fragment,null,e.createElement(a.ApolloErrorProvider,{onError:t},e.createElement(n.ApolloNextAppProvider,{makeClient:l},o),!t&&e.createElement(p.ApolloErrorComponent,null)),e.createElement(u.Toaster,{position:"top-right"}))}exports.ApolloProvider=c;

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

@@ -13,9 +13,10 @@ import { I_ApolloProviderProps } from '../apollo-client/index.js';
  * - Automatic error handling
  * - Next.js specific optimizations
  *
- * @param props - Component props containing options and children.
+ * @param props - Component props containing options, children, and optional error override.
  * @param props.options - Apollo Client configuration options.
  * @param props.children - React children that will have access to Apollo Client context.
+ * @param props.onError - Optional callback to override the default modal/toast error handling.
  * @returns A React component that provides Apollo Client context to its children.
  */
-export declare function ApolloProvider({ options, children }: I_ApolloProviderProps): React.JSX.Element;
+export declare function ApolloProvider({ options, children, onError }: I_ApolloProviderProps): React.JSX.Element;

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

@@ -1,16 +1,16 @@
 import { ApolloNextAppProvider as l } from "@apollo/client-integration-nextjs";
-import e, { useMemo as m } from "react";
-import { getClient as n } from "./apollo-client-nextjs.util.js";
-import { ApolloErrorProvider as p } from "../apollo-error/apollo-error.provider.js";
-import { ApolloErrorComponent as i } from "../apollo-error/apollo-error.component.js";
-import { Toaster as a } from "react-hot-toast";
-function g({ options: r, children: o }) {
-  const t = m(
-    () => () => n(r || {}),
+import e, { useMemo as n } from "react";
+import { getClient as p } from "./apollo-client-nextjs.util.js";
+import { ApolloErrorProvider as i } from "../apollo-error/apollo-error.provider.js";
+import { ApolloErrorComponent as a } from "../apollo-error/apollo-error.component.js";
+import { Toaster as c } from "react-hot-toast";
+function s({ options: r, children: t, onError: o }) {
+  const m = n(
+    () => () => p(r || {}),
     [r]
   );
-  return /* @__PURE__ */ e.createElement(e.Fragment, null, /* @__PURE__ */ e.createElement(p, null, /* @__PURE__ */ e.createElement(l, { makeClient: t }, o), /* @__PURE__ */ e.createElement(i, null)), /* @__PURE__ */ e.createElement(a, { position: "top-right" }));
+  return /* @__PURE__ */ e.createElement(e.Fragment, null, /* @__PURE__ */ e.createElement(i, { onError: o }, /* @__PURE__ */ e.createElement(l, { makeClient: m }, t), !o && /* @__PURE__ */ e.createElement(a, null)), /* @__PURE__ */ e.createElement(c, { position: "top-right" }));
 }
 export {
-  g as ApolloProvider
+  s as ApolloProvider
 };

package/dist/react/apollo-error/apollo-error.provider.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("react"),u=require("./apollo-error.context.cjs"),n=require("./apollo-error.util.cjs");function a({children:l}){const[e,o]=r.useState(null);r.useEffect(()=>{n.setGlobalApolloErrorCallback(o)},[]);const t=r.useMemo(()=>({error:e,showError:o,hideError:()=>o(null)}),[e]);return r.createElement(u.ApolloErrorContext,{value:t},l)}exports.ApolloErrorProvider=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("react"),i=require("./apollo-error.context.cjs"),c=require("./apollo-error.util.cjs");function b({children:n,onError:e}){const[o,t]=l.useState(null),r=l.useCallback(u=>{if(e){e(u);return}t(u)},[e]);l.useEffect(()=>(c.setGlobalApolloErrorCallback(r,!!e),()=>{c.clearGlobalApolloErrorCallback()}),[r,e]);const a=l.useCallback(()=>t(null),[]),s=l.useMemo(()=>({error:e?null:o,showError:r,hideError:a}),[o,r,a,e]);return l.createElement(i.ApolloErrorContext,{value:s},n)}exports.ApolloErrorProvider=b;

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

@@ -1,4 +1,5 @@
-import { ReactNode, default as React } from 'react';
+import { default as React } from 'react';
+import { I_ApolloErrorProviderProps } from './apollo-error.type.js';
 /**
  * Provider component that manages Apollo error state and provides error context.
  * This component sets up error handling for Apollo Client operations and provides
@@ -8,12 +9,12 @@ import { ReactNode, default as React } from 'react';
  * - Global Apollo error state management
  * - Error context provision to child components
  * - Automatic error handling and display
+ * - Optional custom error handling callbacks
  * - Integration with error boundaries
  *
  * @param props - Component props containing children.
  * @param props.children - React children that will have access to the error context.
+ * @param props.onError - Optional callback to override the default error modal/toast flow.
  * @returns A React component that provides Apollo error context to its children.
  */
-export declare function ApolloErrorProvider({ children }: {
-    children: ReactNode;
-}): React.JSX.Element;
+export declare function ApolloErrorProvider({ children, onError }: I_ApolloErrorProviderProps): React.JSX.Element;

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

@@ -1,18 +1,24 @@
-import l, { useState as n, useEffect as u, useMemo as a } from "react";
-import { ApolloErrorContext as c } from "./apollo-error.context.js";
-import { setGlobalApolloErrorCallback as m } from "./apollo-error.util.js";
-function f({ children: e }) {
-  const [o, r] = n(null);
-  u(() => {
-    m(r);
-  }, []);
-  const t = a(() => ({
-    error: o,
-    showError: r,
-    hideError: () => r(null)
-  }), [o]);
-  return /* @__PURE__ */ l.createElement(c, { value: t }, e);
+import s, { useState as m, useCallback as c, useEffect as f, useMemo as i } from "react";
+import { ApolloErrorContext as p } from "./apollo-error.context.js";
+import { setGlobalApolloErrorCallback as b, clearGlobalApolloErrorCallback as A } from "./apollo-error.util.js";
+function k({ children: u, onError: l }) {
+  const [r, o] = m(null), e = c((a) => {
+    if (l) {
+      l(a);
+      return;
+    }
+    o(a);
+  }, [l]);
+  f(() => (b(e, !!l), () => {
+    A();
+  }), [e, l]);
+  const t = c(() => o(null), []), n = i(() => ({
+    error: l ? null : r,
+    showError: e,
+    hideError: t
+  }), [r, e, t, l]);
+  return /* @__PURE__ */ s.createElement(p, { value: n }, u);
 }
 export {
-  f as ApolloErrorProvider
+  k as ApolloErrorProvider
 };

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

@@ -1,7 +1,12 @@
 import { GraphQLError } from 'graphql';
+import { ReactNode } from 'react';
 export type { GraphQLError } from 'graphql';
 export interface I_ApolloErrorContext {
     error: GraphQLError | Error | null;
     showError: (error: GraphQLError | Error) => void;
     hideError: () => void;
 }
+export interface I_ApolloErrorProviderProps {
+    children: ReactNode;
+    onError?: (error: GraphQLError | Error) => void;
+}

package/dist/react/apollo-error/apollo-error.util.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});let o=null;function r(l){o=l}function a(l){o==null||o(l)}exports.setGlobalApolloErrorCallback=r;exports.showGlobalApolloError=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});let l=null,r=!1;function e(o,a=!1){l=o,r=a}function t(){l=null,r=!1}function n(){return r}function s(o){l==null||l(o)}exports.clearGlobalApolloErrorCallback=t;exports.hasCustomApolloErrorHandler=n;exports.setGlobalApolloErrorCallback=e;exports.showGlobalApolloError=s;

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

@@ -7,8 +7,20 @@ import { GraphQLError } from 'graphql';
  * consistent error handling.
  *
  * @param callback - The function to be called when a global Apollo error occurs.
+ * @param isCustomHandler - Flag that identifies whether the handler was provided by the consumer.
  */
-export declare function setGlobalApolloErrorCallback(callback: (err: GraphQLError | Error) => void): void;
+export declare function setGlobalApolloErrorCallback(callback: (err: GraphQLError | Error) => void, isCustomHandler?: boolean): void;
+/**
+ * Clears the global callback function for Apollo error handling.
+ * Useful when the ApolloErrorProvider unmounts to avoid stale references.
+ */
+export declare function clearGlobalApolloErrorCallback(): void;
+/**
+ * Indicates whether a custom Apollo error handler is registered.
+ *
+ * @returns True if a custom handler is registered, otherwise false.
+ */
+export declare function hasCustomApolloErrorHandler(): boolean;
 /**
  * Displays a global Apollo error using the registered callback.
  * This function triggers the global error display system by calling the

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

@@ -1,11 +1,19 @@
-let o = null;
-function r(l) {
-  o = l;
+let l = null, r = !1;
+function n(o, a = !1) {
+  l = o, r = a;
 }
-function a(l) {
-  o == null || o(l);
+function e() {
+  l = null, r = !1;
+}
+function t() {
+  return r;
+}
+function s(o) {
+  l == null || l(o);
 }
 export {
-  r as setGlobalApolloErrorCallback,
-  a as showGlobalApolloError
+  e as clearGlobalApolloErrorCallback,
+  t as hasCustomApolloErrorHandler,
+  n as setGlobalApolloErrorCallback,
+  s as showGlobalApolloError
 };

package/dist/react/apollo-error/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./apollo-error.component.cjs"),l=require("./apollo-error.context.cjs"),e=require("./apollo-error.hook.cjs"),p=require("./apollo-error.provider.cjs"),o=require("./apollo-error.util.cjs");exports.ApolloErrorComponent=r.ApolloErrorComponent;exports.ApolloErrorContext=l.ApolloErrorContext;exports.useApolloError=e.useApolloError;exports.ApolloErrorProvider=p.ApolloErrorProvider;exports.setGlobalApolloErrorCallback=o.setGlobalApolloErrorCallback;exports.showGlobalApolloError=o.showGlobalApolloError;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./apollo-error.component.cjs"),l=require("./apollo-error.context.cjs"),e=require("./apollo-error.hook.cjs"),a=require("./apollo-error.provider.cjs"),o=require("./apollo-error.util.cjs");exports.ApolloErrorComponent=r.ApolloErrorComponent;exports.ApolloErrorContext=l.ApolloErrorContext;exports.useApolloError=e.useApolloError;exports.ApolloErrorProvider=a.ApolloErrorProvider;exports.clearGlobalApolloErrorCallback=o.clearGlobalApolloErrorCallback;exports.hasCustomApolloErrorHandler=o.hasCustomApolloErrorHandler;exports.setGlobalApolloErrorCallback=o.setGlobalApolloErrorCallback;exports.showGlobalApolloError=o.showGlobalApolloError;

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

@@ -1,13 +1,15 @@
 import { ApolloErrorComponent as l } from "./apollo-error.component.js";
 import { ApolloErrorContext as e } from "./apollo-error.context.js";
-import { useApolloError as m } from "./apollo-error.hook.js";
-import { ApolloErrorProvider as A } from "./apollo-error.provider.js";
-import { setGlobalApolloErrorCallback as f, showGlobalApolloError as a } from "./apollo-error.util.js";
+import { useApolloError as t } from "./apollo-error.hook.js";
+import { ApolloErrorProvider as E } from "./apollo-error.provider.js";
+import { clearGlobalApolloErrorCallback as x, hasCustomApolloErrorHandler as b, setGlobalApolloErrorCallback as f, showGlobalApolloError as s } from "./apollo-error.util.js";
 export {
   l as ApolloErrorComponent,
   e as ApolloErrorContext,
-  A as ApolloErrorProvider,
+  E as ApolloErrorProvider,
+  x as clearGlobalApolloErrorCallback,
+  b as hasCustomApolloErrorHandler,
   f as setGlobalApolloErrorCallback,
-  a as showGlobalApolloError,
-  m as useApolloError
+  s as showGlobalApolloError,
+  t as useApolloError
 };

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@cyberskill/shared",
     "type": "module",
-    "version": "2.19.0",
+    "version": "2.19.1",
     "description": "CyberSkill Shared",
     "author": "Stephen Cheng",
     "license": "MIT",
@@ -208,19 +208,19 @@
     },
     "dependencies": {
         "@antfu/eslint-config": "6.2.0",
-        "@apollo/client": "4.0.8",
+        "@apollo/client": "4.0.9",
         "@apollo/client-integration-nextjs": "0.14.1",
         "@apollo/server": "5.1.0",
         "@as-integrations/express5": "1.1.2",
-        "@dotenvx/dotenvx": "1.51.0",
+        "@dotenvx/dotenvx": "1.51.1",
         "@eddeee888/gcg-typescript-resolver-files": "0.14.0",
-        "@eslint-react/eslint-plugin": "2.2.4",
-        "@graphql-codegen/cli": "6.0.1",
-        "@graphql-codegen/client-preset": "5.1.1",
-        "@nestjs/common": "11.1.8",
-        "@nestjs/core": "11.1.8",
+        "@eslint-react/eslint-plugin": "2.3.5",
+        "@graphql-codegen/cli": "6.0.2",
+        "@graphql-codegen/client-preset": "5.1.3",
+        "@nestjs/common": "11.1.9",
+        "@nestjs/core": "11.1.9",
         "@userback/widget": "0.3.11",
-        "@vitejs/plugin-react-swc": "4.2.0",
+        "@vitejs/plugin-react-swc": "4.2.2",
         "body-parser": "2.2.0",
         "chalk": "5.6.2",
         "clsx": "2.1.1",
@@ -230,41 +230,41 @@
         "cors": "2.8.5",
         "crypto-js": "4.2.0",
         "date-fns": "4.1.0",
-        "envalid": "8.1.0",
+        "envalid": "8.1.1",
         "eslint-plugin-format": "1.0.2",
         "eslint-plugin-react-hooks": "7.0.1",
         "eslint-plugin-react-refresh": "0.4.24",
         "express": "5.1.0",
         "express-session": "1.18.2",
-        "express-useragent": "2.0.1",
+        "express-useragent": "2.0.2",
         "extract-files": "13.0.0",
         "fs-extra": "11.3.2",
-        "globals": "16.4.0",
-        "graphql": "16.11.0",
+        "globals": "16.5.0",
+        "graphql": "16.12.0",
         "graphql-upload": "17.0.0",
         "graphql-ws": "6.0.6",
-        "i18next": "25.6.0",
-        "jsdom": "27.1.0",
+        "i18next": "25.6.2",
+        "jsdom": "27.2.0",
         "localforage": "1.10.0",
         "lodash-es": "4.17.21",
         "migrate-mongo": "12.1.3",
-        "mongodb": "6.20.0",
-        "mongoose": "8.19.2",
+        "mongodb": "7.0.0",
+        "mongoose": "8.19.4",
         "mongoose-aggregate-paginate-v2": "1.1.4",
         "mongoose-paginate-v2": "1.9.1",
-        "next-intl": "4.4.0",
+        "next-intl": "4.5.3",
         "node-fetch": "3.3.2",
         "node-persist": "4.0.4",
         "qs": "6.14.0",
         "react": "19.2.0",
         "react-dom": "19.2.0",
         "react-hot-toast": "2.6.0",
-        "react-i18next": "16.2.3",
+        "react-i18next": "16.3.3",
         "rxjs": "7.8.2",
         "slugify": "1.6.6",
         "unorm": "1.6.0",
         "uuid": "13.0.0",
-        "vite": "7.1.12",
+        "vite": "7.2.2",
         "ws": "8.18.3",
         "yargs": "18.0.0"
     },
@@ -272,7 +272,7 @@
         "@commitlint/cli": "20.1.0",
         "@commitlint/config-conventional": "20.0.0",
         "@eslint/config-inspector": "1.3.0",
-        "@next/eslint-plugin-next": "16.0.1",
+        "@next/eslint-plugin-next": "16.0.3",
         "@testing-library/jest-dom": "6.9.1",
         "@testing-library/react": "16.3.0",
         "@types/body-parser": "1.19.6",
@@ -287,29 +287,28 @@
         "@types/fs-extra": "11.0.4",
         "@types/graphql-upload": "17.0.0",
         "@types/lodash-es": "4.17.12",
-        "@types/migrate-mongo": "10.0.5",
-        "@types/node": "24.9.2",
+        "@types/migrate-mongo": "10.0.6",
+        "@types/node": "24.10.1",
         "@types/node-persist": "3.1.8",
-        "@types/react": "19.2.2",
-        "@types/react-dom": "19.2.2",
+        "@types/react": "19.2.4",
+        "@types/react-dom": "19.2.3",
         "@types/unorm": "1.3.31",
-        "@types/uuid": "11.0.0",
         "@types/ws": "8.18.1",
-        "@types/yargs": "17.0.34",
-        "@vitest/browser": "4.0.6",
-        "eslint": "9.38.0",
-        "eslint-config-next": "16.0.1",
+        "@types/yargs": "17.0.35",
+        "@vitest/browser": "4.0.9",
+        "eslint": "9.39.1",
+        "eslint-config-next": "16.0.3",
         "glob": "11.0.3",
         "lint-staged": "16.2.6",
         "node-modules-inspector": "1.2.0",
         "npm-run-all2": "8.0.4",
-        "sass": "1.93.3",
+        "sass": "1.94.0",
         "simple-git-hooks": "2.13.1",
         "tsx": "4.20.6",
         "typescript": "5.9.3",
-        "vite": "7.1.12",
+        "vite": "7.2.2",
         "vite-plugin-dts": "4.5.4",
-        "vitest": "4.0.6"
+        "vitest": "4.0.9"
     },
     "publishConfig": {
         "access": "public",