@cyberskill/shared 2.19.0 → 2.20.0

package/dist/node/storage/storage.constant.js

@@ -0,0 +1,7 @@
+const E = "localforage-node-fs", o = ".json", _ = "cyberskill", s = "node-storage";
+export {
+  E as NODE_FS_DRIVER_NAME,
+  _ as STORAGE_INSTANCE_NAME,
+  o as STORAGE_KEY_EXTENSION,
+  s as STORAGE_STORE_NAME
+};

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

@@ -0,0 +1,14 @@
+import { default as localForage } from 'localforage';
+export type LocalForageDriver = Parameters<typeof localForage.defineDriver>[0];
+export interface NodeLocalForageOptions {
+    driver?: string | string[];
+    size?: number;
+    version?: number;
+    description?: string;
+    name?: string;
+    storeName?: string;
+    baseDir?: string;
+}
+export interface NodeFsDriverState {
+    baseDir: string;
+}

package/dist/node/storage/storage.util.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("node-persist"),f=require("../../config/env/env.util.cjs"),u=require("../log/log.util.cjs");var l=(r,e,n)=>new Promise((h,a)=>{var d=t=>{try{c(n.next(t))}catch(s){a(s)}},v=t=>{try{c(n.throw(t))}catch(s){a(s)}},c=t=>t.done?h(t.value):Promise.resolve(t.value).then(d,v);c((n=n.apply(r,e)).next())});const y=f.getEnv();function o(){return l(this,null,function*(){i.defaultInstance||(yield i.init({dir:y.CYBERSKILL_STORAGE_DIRECTORY}))})}const E={get(r){return l(this,null,function*(){try{yield o();const e=yield i.getItem(r);return e!=null?e:null}catch(e){return u.catchError(e,{returnValue:null})}})},set(r,e){return l(this,null,function*(){try{yield o(),yield i.setItem(r,e)}catch(n){u.catchError(n)}})},remove(r){return l(this,null,function*(){try{yield o(),yield i.removeItem(r)}catch(e){u.catchError(e)}})},keys(){return l(this,null,function*(){try{yield o();const r=yield i.keys();return Array.isArray(r)?r:(u.log.warn("[Storage:keys] Invalid keys response:",r),[])}catch(r){return u.catchError(r,{returnValue:[]})}})},getLogLink(r){return l(this,null,function*(){try{return`${y.CYBERSKILL_STORAGE_DIRECTORY} (key: ${r})`}catch(e){return u.catchError(e,{returnValue:null})}})}};exports.storage=E;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("localforage"),o=require("node:fs/promises"),D=require("node:path"),c=require("./storage.constant.cjs"),I=require("../../config/env/env.util.cjs"),s=require("../log/log.util.cjs");var n=(e,r,t)=>new Promise((i,y)=>{var h=u=>{try{v(t.next(u))}catch(_){y(_)}},O=u=>{try{v(t.throw(u))}catch(_){y(_)}},v=u=>u.done?i(u.value):Promise.resolve(u.value).then(h,O);v((t=t.apply(e,r)).next())});const E=I.getEnv(),l={baseDir:E.CYBERSKILL_STORAGE_DIRECTORY};function m(e){return`${encodeURIComponent(e)}${c.STORAGE_KEY_EXTENSION}`}function N(e){return decodeURIComponent(e.slice(0,-c.STORAGE_KEY_EXTENSION.length))}function R(e,r){return D.join(r,m(e))}const d={_driver:c.NODE_FS_DRIVER_NAME,_support:!0,_initStorage(e){return n(this,null,function*(){try{const r=typeof e=="object"&&e!==null&&"baseDir"in e?e.baseDir:void 0;typeof r=="string"&&r.length>0?l.baseDir=r:l.baseDir=E.CYBERSKILL_STORAGE_DIRECTORY,yield o.mkdir(l.baseDir,{recursive:!0})}catch(r){throw s.log.error("[Storage:init]",r),r}})},clear(){return n(this,null,function*(){const{baseDir:e}=l;yield o.rm(e,{recursive:!0,force:!0}),yield o.mkdir(e,{recursive:!0})})},getItem(e){return n(this,null,function*(){const{baseDir:r}=l,t=R(e,r);try{const i=yield o.readFile(t,"utf8");return JSON.parse(i)}catch(i){if(i.code==="ENOENT")return null;throw i}})},iterate(e){return n(this,null,function*(){const r=yield d.keys();let t=1;for(const i of r){const y=yield d.getItem(i),h=e(y,i,t);if(h!==void 0)return h;t+=1}})},key(e){return n(this,null,function*(){var r;return(r=(yield d.keys())[e])!=null?r:null})},keys(){return n(this,null,function*(){const{baseDir:e}=l;try{return(yield o.readdir(e)).filter(t=>t.endsWith(c.STORAGE_KEY_EXTENSION)).map(N)}catch(r){if(r.code==="ENOENT")return[];throw r}})},length(){return n(this,null,function*(){return(yield d.keys()).length})},removeItem(e){return n(this,null,function*(){const{baseDir:r}=l,t=R(e,r);yield o.rm(t,{force:!0})})},setItem(e,r){return n(this,null,function*(){const{baseDir:t}=l,i=R(e,t);return yield o.mkdir(t,{recursive:!0}),yield o.writeFile(i,JSON.stringify(r),"utf8"),r})}};let a=null,S=null;function f(){return n(this,null,function*(){return a?(yield a,S):(a=n(null,null,function*(){yield g.defineDriver(d),l.baseDir=E.CYBERSKILL_STORAGE_DIRECTORY;const e=yield g.getDriver(c.NODE_FS_DRIVER_NAME),r={baseDir:l.baseDir,name:c.STORAGE_INSTANCE_NAME,storeName:c.STORAGE_STORE_NAME};yield e._initStorage(r),S=e}).catch(e=>{throw a=null,e}),yield a,S)})}const T={get(e){return n(this,null,function*(){try{const t=yield(yield f()).getItem(e);return t!=null?t:null}catch(r){return s.catchError(r,{returnValue:null})}})},set(e,r){return n(this,null,function*(){try{yield(yield f()).setItem(e,r)}catch(t){s.catchError(t)}})},remove(e){return n(this,null,function*(){try{yield(yield f()).removeItem(e)}catch(r){s.catchError(r)}})},keys(){return n(this,null,function*(){try{const r=yield(yield f()).keys();return Array.isArray(r)?r:(s.log.warn("[Storage:keys] Invalid keys response:",r),[])}catch(e){return s.catchError(e,{returnValue:[]})}})},getLogLink(e){return n(this,null,function*(){try{return`${D.join(E.CYBERSKILL_STORAGE_DIRECTORY,m(e))} (key: ${e})`}catch(r){return s.catchError(r,{returnValue:null})}})}};exports.storage=T;

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

@@ -1,6 +1,6 @@
 /**
  * Persistent storage utility object for data persistence across application sessions.
- * This object provides methods for storing, retrieving, and managing data using node-persist,
+ * This object provides methods for storing, retrieving, and managing data using localForage,
  * with automatic initialization and error handling.
  */
 export declare const storage: {

package/dist/node/storage/storage.util.js

@@ -1,31 +1,143 @@
-import u from "node-persist";
-import { getEnv as m } from "../../config/env/env.util.js";
-import { catchError as i, log as v } from "../log/log.util.js";
-var l = (r, e, n) => new Promise((h, a) => {
-  var d = (t) => {
+import _ from "localforage";
+import l from "node:fs/promises";
+import g from "node:path";
+import { STORAGE_KEY_EXTENSION as R, NODE_FS_DRIVER_NAME as I, STORAGE_STORE_NAME as p, STORAGE_INSTANCE_NAME as b } from "./storage.constant.js";
+import { getEnv as N } from "../../config/env/env.util.js";
+import { catchError as s, log as S } from "../log/log.util.js";
+var n = (e, r, t) => new Promise((i, d) => {
+  var y = (u) => {
     try {
-      s(n.next(t));
-    } catch (c) {
-      a(c);
+      m(t.next(u));
+    } catch (v) {
+      d(v);
     }
-  }, f = (t) => {
+  }, O = (u) => {
     try {
-      s(n.throw(t));
-    } catch (c) {
-      a(c);
+      m(t.throw(u));
+    } catch (v) {
+      d(v);
     }
-  }, s = (t) => t.done ? h(t.value) : Promise.resolve(t.value).then(d, f);
-  s((n = n.apply(r, e)).next());
+  }, m = (u) => u.done ? i(u.value) : Promise.resolve(u.value).then(y, O);
+  m((t = t.apply(e, r)).next());
 });
-const y = m();
-function o() {
-  return l(this, null, function* () {
-    u.defaultInstance || (yield u.init({
-      dir: y.CYBERSKILL_STORAGE_DIRECTORY
-    }));
+const h = N(), o = {
+  baseDir: h.CYBERSKILL_STORAGE_DIRECTORY
+};
+function k(e) {
+  return `${encodeURIComponent(e)}${R}`;
+}
+function T(e) {
+  return decodeURIComponent(e.slice(0, -R.length));
+}
+function E(e, r) {
+  return g.join(r, k(e));
+}
+const a = {
+  _driver: I,
+  _support: !0,
+  /** Ensures the storage directory exists and respects custom baseDir overrides. */
+  _initStorage(e) {
+    return n(this, null, function* () {
+      try {
+        const r = typeof e == "object" && e !== null && "baseDir" in e ? e.baseDir : void 0;
+        typeof r == "string" && r.length > 0 ? o.baseDir = r : o.baseDir = h.CYBERSKILL_STORAGE_DIRECTORY, yield l.mkdir(o.baseDir, { recursive: !0 });
+      } catch (r) {
+        throw S.error("[Storage:init]", r), r;
+      }
+    });
+  },
+  /** Deletes all stored entries by recreating the directory. */
+  clear() {
+    return n(this, null, function* () {
+      const { baseDir: e } = o;
+      yield l.rm(e, { recursive: !0, force: !0 }), yield l.mkdir(e, { recursive: !0 });
+    });
+  },
+  /** Reads and parses a stored value; returns null when the file is missing. */
+  getItem(e) {
+    return n(this, null, function* () {
+      const { baseDir: r } = o, t = E(e, r);
+      try {
+        const i = yield l.readFile(t, "utf8");
+        return JSON.parse(i);
+      } catch (i) {
+        if (i.code === "ENOENT")
+          return null;
+        throw i;
+      }
+    });
+  },
+  /** Iterates through all keys, invoking the iterator until it returns a value. */
+  iterate(e) {
+    return n(this, null, function* () {
+      const r = yield a.keys();
+      let t = 1;
+      for (const i of r) {
+        const d = yield a.getItem(i), y = e(d, i, t);
+        if (y !== void 0)
+          return y;
+        t += 1;
+      }
+    });
+  },
+  /** Returns the key name at the given index or null when out of bounds. */
+  key(e) {
+    return n(this, null, function* () {
+      var r;
+      return (r = (yield a.keys())[e]) != null ? r : null;
+    });
+  },
+  /** Lists all stored keys. */
+  keys() {
+    return n(this, null, function* () {
+      const { baseDir: e } = o;
+      try {
+        return (yield l.readdir(e)).filter((t) => t.endsWith(R)).map(T);
+      } catch (r) {
+        if (r.code === "ENOENT")
+          return [];
+        throw r;
+      }
+    });
+  },
+  /** Returns the count of stored keys. */
+  length() {
+    return n(this, null, function* () {
+      return (yield a.keys()).length;
+    });
+  },
+  /** Removes a stored value for the given key. */
+  removeItem(e) {
+    return n(this, null, function* () {
+      const { baseDir: r } = o, t = E(e, r);
+      yield l.rm(t, { force: !0 });
+    });
+  },
+  /** Stores a value as JSON on disk. */
+  setItem(e, r) {
+    return n(this, null, function* () {
+      const { baseDir: t } = o, i = E(e, t);
+      return yield l.mkdir(t, { recursive: !0 }), yield l.writeFile(i, JSON.stringify(r), "utf8"), r;
+    });
+  }
+};
+let c = null, D = null;
+function f() {
+  return n(this, null, function* () {
+    return c ? (yield c, D) : (c = n(null, null, function* () {
+      yield _.defineDriver(a), o.baseDir = h.CYBERSKILL_STORAGE_DIRECTORY;
+      const e = yield _.getDriver(I), r = {
+        baseDir: o.baseDir,
+        name: b,
+        storeName: p
+      };
+      yield e._initStorage(r), D = e;
+    }).catch((e) => {
+      throw c = null, e;
+    }), yield c, D);
   });
 }
-const R = {
+const w = {
   /**
    * Retrieves a value from persistent storage by key.
    * This method fetches data that was previously stored using the set method.
@@ -34,14 +146,13 @@ const R = {
    * @param key - The unique identifier for the stored value.
    * @returns A promise that resolves to the stored value or null if not found.
    */
-  get(r) {
-    return l(this, null, function* () {
+  get(e) {
+    return n(this, null, function* () {
       try {
-        yield o();
-        const e = yield u.getItem(r);
-        return e != null ? e : null;
-      } catch (e) {
-        return i(e, { returnValue: null });
+        const t = yield (yield f()).getItem(e);
+        return t != null ? t : null;
+      } catch (r) {
+        return s(r, { returnValue: null });
       }
     });
   },
@@ -54,12 +165,12 @@ const R = {
    * @param value - The data to store (will be automatically serialized).
    * @returns A promise that resolves when the storage operation is complete.
    */
-  set(r, e) {
-    return l(this, null, function* () {
+  set(e, r) {
+    return n(this, null, function* () {
       try {
-        yield o(), yield u.setItem(r, e);
-      } catch (n) {
-        i(n);
+        yield (yield f()).setItem(e, r);
+      } catch (t) {
+        s(t);
       }
     });
   },
@@ -70,12 +181,12 @@ const R = {
    * @param key - The unique identifier of the value to remove.
    * @returns A promise that resolves when the removal operation is complete.
    */
-  remove(r) {
-    return l(this, null, function* () {
+  remove(e) {
+    return n(this, null, function* () {
       try {
-        yield o(), yield u.removeItem(r);
-      } catch (e) {
-        i(e);
+        yield (yield f()).removeItem(e);
+      } catch (r) {
+        s(r);
       }
     });
   },
@@ -87,13 +198,12 @@ const R = {
    * @returns A promise that resolves to an array of storage keys.
    */
   keys() {
-    return l(this, null, function* () {
+    return n(this, null, function* () {
       try {
-        yield o();
-        const r = yield u.keys();
-        return Array.isArray(r) ? r : (v.warn("[Storage:keys] Invalid keys response:", r), []);
-      } catch (r) {
-        return i(r, { returnValue: [] });
+        const r = yield (yield f()).keys();
+        return Array.isArray(r) ? r : (S.warn("[Storage:keys] Invalid keys response:", r), []);
+      } catch (e) {
+        return s(e, { returnValue: [] });
       }
     });
   },
@@ -105,16 +215,16 @@ const R = {
    * @param key - The storage key to generate a log link for.
    * @returns A promise that resolves to a formatted log link string or null if an error occurs.
    */
-  getLogLink(r) {
-    return l(this, null, function* () {
+  getLogLink(e) {
+    return n(this, null, function* () {
       try {
-        return `${y.CYBERSKILL_STORAGE_DIRECTORY} (key: ${r})`;
-      } catch (e) {
-        return i(e, { returnValue: null });
+        return `${g.join(h.CYBERSKILL_STORAGE_DIRECTORY, k(e))} (key: ${e})`;
+      } catch (r) {
+        return s(r, { returnValue: null });
       }
     });
   }
 };
 export {
-  R as storage
+  w as storage
 };

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;