@bgscore/react-core/dist/index.js

A React utility library that provides advanced API hooks (fetch, mutation, caching). Built for scalable and flexible data handling in modern React applications.

import X from'moment';import te,{createContext,useContext,useCallback,useRef,useState,useMemo,useEffect,useSyncExternalStore}from'react';import {jsx}from'react/jsx-runtime';import ce from'crypto-js/aes';import ue from'crypto-js/pbkdf2';import Se from'crypto-js/enc-utf8';import L from'crypto-js/enc-base64';import pe from'crypto-js/lib-typedarrays';import $e from'axios';function ze(){let e=()=>Math.random()*16%16|0;return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,t=>(t==="x"?e():e()&3|8).toString(16))}function _e(e,t){try{return JSON.stringify(e)!==JSON.stringify(t)}catch{return  false}}var Ge=e=>(Object.keys(e).forEach(t=>{e[t]===void 0&&(e[t]=null);}),e);function Xe(e,t){let n=false;return e&&typeof e=="object"&&Array.isArray(e)&&(typeof t=="number"?e.length>t&&(n=true):n=true),n}function F(e){return !(e==null||typeof e=="string"&&e.trim()===""||Array.isArray(e)&&e.length===0||typeof e=="object"&&e!==null&&!Array.isArray(e)&&Object.keys(e).length===0)}var se={camelCase:(e="")=>(e=e.split(".").map(t=>(t=t.charAt(0).toUpperCase()+t.slice(1),t)).join(" "),e=e.replace(/([a-z0-9])([A-Z])/g,"$1 $2"),e.charAt(0).toUpperCase()+e.slice(1)),snackCase:(e="")=>{let n=e.replace(/_([a-z])/g,(r,s)=>s.toUpperCase()).replace(/([A-Z])/g," $1");return n=n.charAt(0).toUpperCase()+n.slice(1),n},changeAll:(e="",t=false)=>{let n="";try{e=e?.split(".")[e?.split(".")?.length-1],e=e?.split("[]")[e?.split("[]")?.length-1],n=se.snackCase(se.camelCase(e)),t&&(n=n?.split(" ")?.map(r=>r?.length<=3?r?.toUpperCase():r)?.join(" "));}catch{}return n?.trim()}};function Ye(e,t){return typeof e=="function"?e(t):e}var k=(e,t,n="")=>{if(!e)return n;if(e.hasOwnProperty(t))return e[t];let r=t.replace(/\[(\d+)\]/g,".$1").split("."),s=e;for(let i of r){if(s==null)return n;s=s[i];}return s===void 0?n:s},Ze={desc:(e,t)=>(e||(e=[]),e.sort((n,r)=>{if(t){let s=k(n,t)?k(n,t):"",i=k(r,t)?k(n,t):"";return s<i?1:-1}else return n<r?1:-1})),asc:(e,t)=>(e||(e=[]),e.sort((n,r)=>{if(t){let s=k(n,t)?k(n,t):"",i=k(r,t)?k(r,t):"";return s>i?1:-1}else return n>r?1:-1}))},Qe=(e,t)=>{Array.isArray(e)||(e=[]);let n=[];return n=e.map(r=>Number(t?k(r,t)||0:r||0)),n.reduce((r,s)=>(r||0)+(s||0),0)||0};function et(e){try{return e&&JSON.parse(JSON.stringify(e))}catch{return e}}function xe(e){let t=new WeakSet;return JSON.stringify(e,function(n,r){return r!==null&&typeof r=="object"?t.has(r)?void 0:(t.add(r),Object.keys(r).sort().reduce((s,i)=>(s[i]=r[i],s),{})):r})??""}function ae(e,t){return xe([t??"undefined",e??"undefined"])}function ie(e=""){return typeof e!="string"&&(e=""),e.replace(/\b\w/g,t=>t.toUpperCase())}function tt(e,t=0){let n;return function(...r){clearTimeout(n),n=setTimeout(()=>{e(...r);},t*1e3);}}var le=createContext(void 0);function B(){let e=useContext(le);return e||{}}var Ae=({children:e,value:t})=>{let n={...t};return jsx(le.Provider,{value:n,children:e})};function J(e,t){let n=pe.random(16),r=pe.random(16),s=ue(t,n,{keySize:256/32,iterations:1e3}),i=ce.encrypt(JSON.stringify(e),s,{iv:r}).toString();return {salt:n.toString(L),iv:r.toString(L),encrypted:i}}function z(e,t){let{salt:n,iv:r,encrypted:s}=e,i=ue(t,L.parse(n),{keySize:256/32,iterations:1e3}),l=ce.decrypt(s,i,{iv:L.parse(r)}).toString(Se);return JSON.parse(l)}function fe(e,t){return JSON.stringify(J(e,t))}function de(e,t){return z(JSON.parse(e),t)}function j(){let{passphrase:e}=B();return {passphrase:e,encrypt(t,n){return J(t,n||e)},decrypt(t,n){return z(t,n||e)},encryptString(t,n){return fe(t,n||e)},decryptString(t,n){return de(t,n||e)}}}var me=()=>{let{encrypt:e,decrypt:t}=j(),n=useCallback((u,l)=>{try{let o=e(l);localStorage.setItem(u,JSON.stringify(o));}catch(o){console.error("Failed to save to storage:",o);}},[e]),r=useCallback(u=>{try{let l=localStorage.getItem(u);return l?t(JSON.parse(l)):null}catch(l){return console.error("Failed to get from storage:",l),null}},[t]),s=u=>{let[l,o]=useState(()=>{try{let p=localStorage.getItem(u);return p?t(JSON.parse(p)):null}catch(p){return console.error("Failed to parse localStorage value",p),null}});return useEffect(()=>{let p=y=>{if(y.key===u)if(y.newValue)try{o(t(JSON.parse(y.newValue)));}catch(R){console.error("Decrypt error from storage event",R);}else o(null);};return window.addEventListener("storage",p),()=>window.removeEventListener("storage",p)},[u,t]),l},i=useCallback(u=>{u?localStorage.removeItem(u):localStorage.clear();},[]);return {save:n,get:r,clear:i,useWatchStorage:s}};function ye(e){let t=e,n=new Set;function r(){return t}function s(l){return n.add(l),()=>{n.delete(l);}}function i(l){let o=typeof l=="function"?l(t):l;Object.is(o,t)||(t=o,n.forEach(p=>p()));}function u(l){let o=useRef(void 0);return useSyncExternalStore(s,()=>{let p=l?l(t):t;return Object.is(o.current,p)||(o.current=p),o.current},()=>l?l(t):t)}return {getSnapshot:r,subscribe:s,setState:i,useStore:u}}var G=new Map;function V(e){let t=G.get(e);if(t)return t.refCount++,t.store;let n=ye([null,{loading:false,isCancel:false,refresh:()=>{},abort:()=>{},clear:()=>{},clone:()=>{}}]);return G.set(e,{store:n,refCount:1}),n}function ge(e){G.delete(e);}function Ne(...e){let[t,n,r]=e,s=t.__isVoid,i=t.__path||t.name,u=useRef(false),l=s?void 0:n,o=s?n:r,p=o?.storeName||i,{storageKey:y,cache:R}=B(),P=me(),[N,D]=useState(false),[C,O]=useState(false),[E,q]=useState(),I=useRef(void 0),H=useRef(null),{cacheName:$,cacheKey:M,timeout:ne,timeoutUnit:re,persistence:f,cacheEnabled:d}=useMemo(()=>{let c=y?P.get(y):void 0,T=typeof o?.cache=="object"?o?.cache?.cacheName??i:i,A=ae({...l,session:c},typeof o?.cache=="object"?o?.cache?.cacheKey:void 0),g=false;typeof R?.enabled=="boolean"&&(g=R.enabled);let S=false;typeof R?.persistence=="boolean"&&(S=R?.persistence),typeof o?.cache=="object"&&typeof o?.cache?.persistence=="boolean"&&(S=o?.cache?.persistence??false);let b=60*5,U="s";return F(R?.timeout)&&(typeof R?.timeout=="number"?(b=R.timeout,U="s"):typeof R?.timeout=="object"&&(b=R?.timeout.value,U=R?.timeout.unit)),o?.cache&&(typeof o.cache!="boolean"?(typeof o.cache.enabled=="boolean"?g=o.cache.enabled:g=true,typeof o.cache.timeout=="number"?(b=o.cache.timeout,U="s"):typeof o.cache.timeout=="object"&&(b=o.cache.timeout.value,U=o.cache.timeout.unit)):g=o.cache),{cacheName:T,cacheKey:A,timeout:b,timeoutUnit:U,persistence:S,cacheEnabled:g}},[o?.cache,y,R]);useEffect(()=>{let c=JSON.stringify(F(I.current)?I.current:""),T=JSON.stringify(F(l)?l:""),A=I.current===void 0;(c!==T||A)&&!o?.hold&&(q(null),a(),I.current=l),o?.onChange&&o?.onChange(l,m);},[l,o?.hold,...o?.trigger||[]]),useEffect(()=>{let c=async()=>{!f&&$&&M&&(await caches.open($)).delete(M);};return window.addEventListener("beforeunload",c),()=>{u.current=true,window.removeEventListener("beforeunload",c),H.current?.abort(),ge(p);}},[]);let a=useCallback(async c=>{let T=l;if(o?.hold&&o?.logging&&console.log("Hold active"),o?.beforeRequest&&(T=o?.beforeRequest(l)),d&&!c&&!C){D(true),v({loading:true}),o?.onBeforeRequest&&o?.onBeforeRequest(l);let A=await caches.open($),S=await(await A.match(M))?.json();if(S){let{data:b,expired:U}=S;if(X().isAfter(U))await A.delete(M);else {o?.afterResponse&&b?.data&&(b.data=o?.afterResponse(b.data)),o?.logging&&console.log("After request: Using Cache",b),o?.onAfterResponse&&o?.onAfterResponse(b),D(false),q(b),v({loading:false,response:b});return}}}if(typeof t=="function"){H.current?.abort();let A=new AbortController;H.current=A,D(true),v({loading:true}),o?.logging&&console.log("Before request",l),o?.onBeforeRequest&&o?.onBeforeRequest(l);let g=s?await t(void 0,{...o,signal:A.signal}):await t(T,void 0,{...o,signal:A.signal});if(o?.afterResponse&&g?.data&&(g.data=o?.afterResponse(g.data)),o?.logging&&console.log("After request",g),o?.onAfterResponse&&o?.onAfterResponse(g),D(false),q(g),O(false),v({response:g,loading:false,isCancel:false}),d&&g.status){let S=X().add(ne,re).toISOString(),b={data:g,expired:S},U=await caches.open($),oe=new Response(JSON.stringify(b));await U.put(M,oe);}}},[l,t,o]);useEffect(()=>{if(o?.refreshInterval){let c=typeof o.refreshInterval=="number"?o.refreshInterval:o.refreshInterval.value,T=typeof o.refreshInterval=="number"?"s":o.refreshInterval.unit,A=setInterval(()=>{a();},X.duration(c,T).asMilliseconds());return ()=>clearInterval(A)}return ()=>{}},[o?.refreshInterval,a]),useEffect(()=>{if(!o?.refetchOnWindowFocus)return;let c=()=>{a();};return window.addEventListener("focus",c),()=>{window.removeEventListener("focus",c);}},[o?.refetchOnWindowFocus,a]);let h=()=>{H.current?.abort(),H.current=null,D(false),O(true),v({isCancel:true,loading:false});},x=()=>{D(false),q(null),v({response:void 0,loading:false});},w=useCallback((c,T)=>Ne(t,c,T),[t]),m={...E,loading:N,refresh:a,abort:h,clear:x,response:E,isCancel:C,clone:w},K=useMemo(()=>({refresh:a,abort:h,clear:x,clone:w}),[a,h,x,w]),v=useCallback(({response:c,loading:T,isCancel:A})=>{if(u.current)return;V(p).setState(S=>{let b=[c?.data,{...S?.[1],...c,loading:T,response:c,isCancel:A,...K}];return JSON.stringify(S)===JSON.stringify(b)?S:b});},[K,p]);return [E?.data,m]}async function Ut(e,t=()=>{}){let n=e*1e3;return new Promise(r=>{setInterval(()=>{t();},1e3);setTimeout(async()=>{await t(),r(true);},n);})}var Ue=(i=>(i.POST="POST",i.PUT="PUT",i.PATCH="PATCH",i.DELETE="DELETE",i.GET="GET",i))(Ue||{}),ke=(a=>(a.number="number",a.currency="currency",a.percent="percent",a.date="date",a.dateTime="dateTime",a.month="month",a.year="year",a.time="time",a.timestamp="timestamp",a.string="string",a.textarea="textarea",a.code="code",a.password="password",a.boolean="boolean",a.toggle="toggle",a.email="email",a.phone="phone",a.url="url",a.json="json",a.file="file",a.image="image",a.array="array",a.object="object",a.enum="enum",a.user="user",a.department="department",a.status="status",a))(ke||{});var Bt=(e,t,n)=>{let{format:r}=B();return t==="number"?Fe(e,{thouSep:r.number.thouSep,decDigits:r.number.decDigits,decSep:r.number.decSep,...n}):["date","dateTime","month","year","time"].some(s=>s===t)?Be(e,{display:r[t]?.display,value:r[t]?.value,...n}):t==="boolean"?ve(e,n):t==="string"?Ke(e,n):e?.toString()??""};function ve(e,t){let n=typeof e=="string"?e==="true":!!e,r=t?.trueLabel??"Yes",s=t?.falseLabel??"No";return n?r:s}function Ke(e,t){if(!F(e))return "";let n=String(e);switch(t?.textTransform){case "capitalize":n=ie(n);break;case "uppercase":n=n.toUpperCase();break;case "lowercase":n=n.toLowerCase();break}return t?.ellipsis&&n.length>t.ellipsis&&(n=n.slice(0,t.ellipsis)+"..."),n}function Fe(e,{thouSep:t,decSep:n,decDigits:r,method:s}){if(e==null||isNaN(Number(e)))return "";let i=typeof e=="string"?parseFloat(e):e;if(s)if(typeof r=="number"){let p=Math.pow(10,r);i=Math[s](i*p)/p;}else i=Math[s](i);else if(typeof r=="number"){let p=Math.pow(10,r);i=Math.floor(i*p)/p;}let u=0;if(r==="auto"){let p=i.toString(),y=p.indexOf(".");y!==-1&&(u=p.length-y-1);}let l={style:"decimal",useGrouping:true,minimumFractionDigits:r==="auto"?u:r||0,maximumFractionDigits:r==="auto"?u:r||0,minimumIntegerDigits:1};return i.toLocaleString("en-US",l).replace(/\./g,"decSep").replace(/,/g,"thouSep").replace(/decSep/g,n).replace(/thouSep/g,t)}function Be(e,{display:t,value:n}){if(!F(e))return e;let r=X(e,n);return r.isValid()?r.format(t):e}function It(e,{interval:t,lead:n}){let r=useRef(null);useEffect(()=>{r.current=e;},[e]),useEffect(()=>{let s=()=>r.current();if(n&&s(),t!==null){let i=setInterval(s,t);return ()=>clearInterval(i)}},[t]);}function jt(e,t,n){let[r,s]=useState(false),i=(p,y)=>typeof e=="string"&&p===e||typeof e=="number"&&y===e,u=p=>p!==null&&(["INPUT","TEXTAREA","SELECT","BUTTON"].includes(p.tagName)||p.hasAttribute("contentEditable")),l=p=>{let{key:y,keyCode:R}=p,P=p.ctrlKey,N=p.altKey,D=p.shiftKey;if(!u(document.activeElement))if(t)if(typeof t=="string")i(y,R)&&(t==="ctrl"&&P||t==="alt"&&N||t==="shift"&&D)&&(p.preventDefault(),n&&p.stopPropagation(),s(!r));else {let C=t.every(O=>O==="ctrl"?P:O==="alt"?N:O==="shift"?D:false);i(y,R)&&C&&(p.preventDefault(),n&&p.stopPropagation(),s(!r));}else i(y,R)&&(p.preventDefault(),n&&p.stopPropagation(),s(!r));},o=({key:p,keyCode:y})=>{i(p,y)&&s(false);};return useEffect(()=>(window.addEventListener("keydown",l),window.addEventListener("keyup",o),()=>{window.removeEventListener("keydown",l),window.removeEventListener("keyup",o);}),[]),r}var Xt=({url:e,token:t,beforeRequest:n,onCallback:r,headers:s,onUnauthorized:i,handleToast:u,handleAuthorization:l,disabledToastWhenCancel:o,withCredentials:p,encryptRequest:y,encryptResponse:R,passphrase:P})=>{let{encrypt:N,decrypt:D,passphrase:C}=j(),O=(f,d,a,h)=>{let x=h?.code==="ERR_CANCELED",w=f.status===401,m=f?.data;if((typeof a?.encryptResponse=="boolean"?a?.encryptResponse:R)&&m){let g=a?.passphrase?typeof a.passphrase=="boolean"&&a.passphrase?C:a.passphrase:P;try{m=D(m,g);}catch{try{m=D(m,C);}catch{}}}let c={...r({...f,data:m,isCancel:x,isUnauthorization:w},h),isCancel:x,isUnauthorization:w,httpCode:f.status},T=typeof a?.disabledToastWhenCancel=="boolean"?a?.disabledToastWhenCancel:o,A=l?l(c,a):!w;if((a?.infoSuccess&&c.status||a?.infoError&&!c.status)&&u&&(!x||!T)&&u(c),!A&&(!x||!a?.disabledHandleUnauthorized)){let g=a?.onUnauthorized||i;g&&g(c);}if(d)d(c);else return c},E=(f,d=()=>{})=>$e.create({baseURL:`${e}`,withCredentials:typeof f.withCredentials=="boolean"?f.withCredentials:p})(f).then(d).catch(h=>d(h.response,h)),q=(f,d,a,h,x)=>{let m={...{token:true,infoError:true,infoSuccess:true,responseType:"json"},...x},K={"Content-Type":"application/json",...s,...m.headers};if(m.token&&(typeof m.token=="boolean"?t&&(K.Authorization=`Bearer ${t}`):m.token&&(K.Authorization=`Bearer ${m.token}`)),n&&(a=n(a)),(typeof m?.encryptRequest=="boolean"?m?.encryptRequest:y)&&a){let c=x?.passphrase?typeof x.passphrase=="boolean"&&x.passphrase?C:x.passphrase:P;a=N(a,c);}return E({url:d,method:f,data:a,headers:K,responseType:m.responseType,signal:m.signal,withCredentials:m.withCredentials,onUploadProgress:c=>{m?.onUploadProgress&&m?.onUploadProgress(c);}},(c,T)=>O(c,h,m,T))};return {client:E,post:(f,d,a,h)=>q("POST",`${f}`,d,a,h),put:(f,d,a,h)=>q("PUT",`${f}`,d,a,h),patch:(f,d,a,h)=>q("PATCH",`${f}`,d,a,h),delete:(f,d,a)=>q("DELETE",`${f}`,null,d,a),get:(f,d,a)=>q("GET",`${f}`,null,d,a),upload:(f,d,a,h)=>{let x=new FormData;return Object.keys(d).forEach(w=>x.append(w,d[w])),q("POST",`${f}`,x,a,{infoSuccess:false,...h,headers:{"Content-Type":"multipart/form-data",...h?.headers}})}}};function Qt(e,t){let[n,r]=useState(false),[s,i]=useState(),[u,l]=useState(0),o=useRef(null);return useEffect(()=>{if(t?.abortOnUnmount)return ()=>{o.current?.abort();}},[]),[async P=>{o.current?.abort();let N=new AbortController;o.current=N,r(true),t?.beforeRequest&&(P=t?.beforeRequest(P)),t?.logging&&console.log("Before request",P);let D={...t,signal:N.signal,onUploadProgress:O=>{let E=Math.round(O.loaded*100/(O.total||1));l(E);}},C=e.__isVoid?await e(void 0,D):await e(P,void 0,D);t?.logging&&console.log("After response",C),i(C),r(false),l(0),C.status&&t?.onSuccess&&t?.onSuccess(C),!C.status&&t?.onError&&t?.onError(C),t?.afterResponse&&t?.afterResponse(C);},{...s,loading:n,abort:()=>{o.current?.abort(),o.current=null,r(false),l(0);},progress:u,reset:()=>{r(false),l(0),i(null);}}]}function Ve(e,t){let{disableHysteresis:n=false,threshold:r=100,target:s}=t,i=e.current;return s&&(typeof s.pageYOffset=="number"?e.current=s.pageYOffset:s.scrollTop!==void 0&&(e.current=s.scrollTop)),!n&&i!==void 0&&e.current<i?false:(e.current||0)>r}var We=typeof window<"u"?window:null;function nn(e={}){let{getTrigger:t=Ve,target:n=We,disableHysteresis:r=false,threshold:s=100}=e,i=te.useRef(0),[u,l]=te.useState(()=>t(i,{disableHysteresis:r,threshold:s,target:n}));return te.useEffect(()=>{let o=()=>{l(t(i,{disableHysteresis:r,threshold:s,target:n}));};if(o(),n)return n.addEventListener("scroll",o,{passive:true}),()=>{n.removeEventListener("scroll",o);}},[n,t,r,s]),u}var sn=(e,t)=>{let n=t||e.__path||e.name;return V(n).useStore()};var pn=(e,t)=>{let n=r=>e(r);return n.displayName=t,n},cn=(e,t)=>{let n={};n.others=[];let r=s=>{te.Children.forEach(s,i=>{if(te.isValidElement(i)){let u=i.type.displayName;if(t.includes(u))n[u]=i;else {let l=i;l.props?.children?r(l.props.children):n.others.push(i);}}else n.others.push(i);});};return r(e),n};function Je(e,t=[]){let n={};for(let r in e){let s=e[r];if(typeof s=="function"){let i=s.bind(null);i.__path=[...t,r].join("."),i.__isVoid=s.length===2,n[r]=i;}else typeof s=="object"&&s!==null?n[r]=Je(s,[...t,r]):n[r]=s;}return n}export{Ae as BgsCoreProvider,ke as DataTypeEnum,Ue as HttpMethod,ie as capitalizeWords,Xt as createApiHelper,pn as createElement,ye as createStore,tt as debounce,z as decrypt,de as decryptString,_e as diffJson,J as encrypt,fe as encryptString,ae as generateCacheKey,ze as generateUUID,k as getFieldValue,Xe as isArray,F as isNotEmpty,et as jsonCopy,se as labelFormatter,Ge as mappingUndefinedtoNull,Ye as renderChildren,Ze as sorting,cn as splitElement,xe as stableStringify,Qe as summary,Ne as useApiLoad,Qt as useApiSend,sn as useApiStore,B as useBgsCore,j as useCrypto,Ut as useDelay,Bt as useFormatted,It as useInterval,jt as useKeyPress,nn as useScrollTrigger,me as useStorage,Je as wrapApi};