@react-pakistan/util-functions 2.0.2 → 3.0.1

package/general/generate-vacation-rental-schema.d.mts

@@ -0,0 +1,67 @@
+/**
+ * Generate schema.org `VacationRental` JSON-LD including optional reviews
+ * and `AggregateRating`.
+ *
+ * The function accepts address or geo information, images, host references,
+ * and occupancy data. Reviews and aggregate ratings are formatted into
+ * `Review` and `AggregateRating` objects when provided.
+ *
+ * See `VacationRentalOptions` below for supported inputs.
+ * @returns A JSON-LD compatible `VacationRental` object
+ */
+interface ImageRef {
+    url: string;
+    width?: number;
+    height?: number;
+}
+interface PersonRef {
+    name: string;
+    url?: string;
+}
+interface AddressRef {
+    streetAddress?: string;
+    addressLocality?: string;
+    addressRegion?: string;
+    postalCode?: string;
+    addressCountry?: string;
+}
+interface GeoRef {
+    latitude?: number | string;
+    longitude?: number | string;
+}
+interface RatingItem {
+    ratingValue: number | string;
+    bestRating?: number | string;
+    worstRating?: number | string;
+}
+interface ReviewItem {
+    author?: string | PersonRef;
+    datePublished?: string;
+    reviewBody?: string;
+    reviewRating?: RatingItem;
+}
+interface AggregateRatingOptions {
+    ratingValue: number | string;
+    reviewCount?: number;
+    ratingCount?: number;
+    bestRating?: number | string;
+    worstRating?: number | string;
+}
+interface VacationRentalOptions {
+    name: string;
+    description?: string;
+    image?: string | ImageRef | (string | ImageRef)[];
+    url?: string;
+    address?: string | AddressRef;
+    geo?: GeoRef;
+    numberOfRooms?: number;
+    numberOfBeds?: number;
+    priceRange?: string;
+    host?: string | PersonRef;
+    reviews?: ReviewItem[];
+    aggregateRating?: AggregateRatingOptions;
+    keywords?: string | string[];
+}
+declare const generateVacationRentalSchema: ({ name, description, image, url, address, geo, numberOfRooms, numberOfBeds, priceRange, host, reviews, aggregateRating, keywords, }: VacationRentalOptions) => any;
+
+export { generateVacationRentalSchema as default, generateVacationRentalSchema };

package/general/generate-vacation-rental-schema.mjs

@@ -0,0 +1 @@
+const A=t=>{if(t)return Array.isArray(t)?t.map(e=>typeof e=="string"?e:{"@type":"ImageObject",url:e.url,...e.width&&{width:e.width},...e.height&&{height:e.height}}):typeof t=="string"?t:{"@type":"ImageObject",url:t.url,...t.width&&{width:t.width},...t.height&&{height:t.height}}},c=t=>{if(!t)return;if(typeof t=="string")return{"@type":"Person",name:t};const e={"@type":"Person",name:t.name};return t.url&&(e.url=t.url),e},I=t=>{if(t)return typeof t=="string"?t:{"@type":"PostalAddress",...t.streetAddress&&{streetAddress:t.streetAddress},...t.addressLocality&&{addressLocality:t.addressLocality},...t.addressRegion&&{addressRegion:t.addressRegion},...t.postalCode&&{postalCode:t.postalCode},...t.addressCountry&&{addressCountry:t.addressCountry}}},P=t=>{const e={"@type":"Review"};return t.author&&(e.author=c(t.author)),t.datePublished&&(e.datePublished=t.datePublished),t.reviewBody&&(e.reviewBody=t.reviewBody),t.reviewRating&&(e.reviewRating={"@type":"Rating",ratingValue:t.reviewRating.ratingValue,...t.reviewRating.bestRating!=null&&{bestRating:t.reviewRating.bestRating},...t.reviewRating.worstRating!=null&&{worstRating:t.reviewRating.worstRating}}),e},V=({name:t,description:e,image:y,url:g,address:w,geo:s,numberOfRooms:d,numberOfBeds:l,priceRange:f,host:b,reviews:a,aggregateRating:r,keywords:o})=>{const n={"@context":"https://schema.org","@type":"VacationRental",name:t};e&&(n.description=e);const R=A(y);R&&(n.image=R),g&&(n.url=g);const m=I(w);m&&(n.address=m),s&&(n.geo={"@type":"GeoCoordinates",...s.latitude!=null&&{latitude:s.latitude},...s.longitude!=null&&{longitude:s.longitude}}),d!=null&&(n.numberOfRooms=d),l!=null&&(n.numberOfBeds=l),f&&(n.priceRange=f);const h=c(b);if(h&&(n.host=h),o&&(n.keywords=Array.isArray(o)?o.join(", "):o),a&&a.length>0){const p=a.map(P);if(n.review=p,!r){const u=a.map(i=>i.reviewRating?Number(i.reviewRating.ratingValue):NaN).filter(i=>!Number.isNaN(i));if(u.length>0){const i=u.reduce((v,C)=>v+C,0);n.aggregateRating={"@type":"AggregateRating",ratingValue:i/u.length,reviewCount:a.length,ratingCount:u.length}}}}return r&&(n.aggregateRating={"@type":"AggregateRating",ratingValue:r.ratingValue,...r.reviewCount!=null&&{reviewCount:r.reviewCount},...r.ratingCount!=null&&{ratingCount:r.ratingCount},...r.bestRating!=null&&{bestRating:r.bestRating},...r.worstRating!=null&&{worstRating:r.worstRating}}),n};var O=V;export{O as default,V as generateVacationRentalSchema};

package/general/generate-video-schema.d.mts

@@ -0,0 +1,75 @@
+/**
+ * Generate schema.org structured data for `VideoObject`, `Clip`, or
+ * `BroadcastEvent`.
+ *
+ * The `VideoOptions` input controls which type is produced and supports
+ * optional fields like `aggregateRating`, `reviews`, thumbnails and
+ * associated `Clip` or `BroadcastEvent` metadata. The result is a plain
+ * object ready to be stringified as JSON-LD for inclusion in a page.
+ *
+ * See `VideoOptions` below for accepted fields and shapes.
+ * @returns A JSON-LD compatible Video/Clip/BroadcastEvent object
+ */
+interface ImageRef {
+    url: string;
+    width?: number;
+    height?: number;
+}
+interface PersonRef {
+    name: string;
+    url?: string;
+}
+interface OrgRef {
+    name: string;
+    url?: string;
+}
+interface RatingItem {
+    ratingValue: number | string;
+    bestRating?: number | string;
+    worstRating?: number | string;
+}
+interface ReviewItem {
+    author?: string | PersonRef;
+    datePublished?: string;
+    reviewBody?: string;
+    reviewRating?: RatingItem;
+}
+interface ClipOptions {
+    name?: string;
+    startOffset?: number;
+    endOffset?: number;
+    url?: string;
+}
+interface BroadcastEventOptions {
+    name?: string;
+    startDate?: string;
+    endDate?: string;
+    isLiveBroadcast?: boolean;
+    url?: string;
+}
+interface AggregateRatingOptions {
+    ratingValue: number | string;
+    reviewCount?: number;
+    ratingCount?: number;
+    bestRating?: number | string;
+    worstRating?: number | string;
+}
+interface VideoOptions {
+    type?: 'VideoObject' | 'Clip' | 'BroadcastEvent';
+    name: string;
+    description?: string;
+    thumbnail?: string | ImageRef | (string | ImageRef)[];
+    uploadDate?: string;
+    duration?: string;
+    contentUrl?: string;
+    embedUrl?: string;
+    clip?: ClipOptions;
+    broadcastEvent?: BroadcastEventOptions;
+    publisher?: string | OrgRef;
+    author?: string | PersonRef;
+    reviews?: ReviewItem[];
+    aggregateRating?: AggregateRatingOptions;
+}
+declare const generateVideoSchema: ({ type, name, description, thumbnail, uploadDate, duration, contentUrl, embedUrl, clip, broadcastEvent, publisher, author, reviews, aggregateRating, }: VideoOptions) => any;
+
+export { generateVideoSchema as default, generateVideoSchema };

package/general/generate-video-schema.mjs

@@ -0,0 +1 @@
+const I=t=>{if(t)return Array.isArray(t)?t.map(e=>typeof e=="string"?e:{"@type":"ImageObject",url:e.url,...e.width&&{width:e.width},...e.height&&{height:e.height}}):typeof t=="string"?t:{"@type":"ImageObject",url:t.url,...t.width&&{width:t.width},...t.height&&{height:t.height}}},c=t=>{if(!t)return;if(typeof t=="string")return{"@type":"Person",name:t};const e={"@type":"Person",name:t.name};return t.url&&(e.url=t.url),e},V=t=>{if(!t)return;if(typeof t=="string")return{"@type":"Organization",name:t};const e={"@type":"Organization",name:t.name};return t.url&&(e.url=t.url),e},B=t=>{const e={"@type":"Review"};return t.author&&(e.author=c(t.author)),t.datePublished&&(e.datePublished=t.datePublished),t.reviewBody&&(e.reviewBody=t.reviewBody),t.reviewRating&&(e.reviewRating={"@type":"Rating",ratingValue:t.reviewRating.ratingValue,...t.reviewRating.bestRating!=null&&{bestRating:t.reviewRating.bestRating},...t.reviewRating.worstRating!=null&&{worstRating:t.reviewRating.worstRating}}),e},P=({type:t="VideoObject",name:e,description:o,thumbnail:p,uploadDate:l,duration:m,contentUrl:d,embedUrl:h,clip:s,broadcastEvent:r,publisher:b,author:O,reviews:g,aggregateRating:a})=>{const n={"@context":"https://schema.org","@type":t,name:e};o&&(n.description=o);const R=I(p);R&&(n.thumbnail=R),l&&(n.uploadDate=l),m&&(n.duration=m),d&&(n.contentUrl=d),h&&(n.embedUrl=h);const w=V(b);w&&(n.publisher=w);const y=c(O);if(y&&(n.author=y),s){const i={"@type":"Clip"};s.name&&(i.name=s.name),s.startOffset!=null&&(i.startOffset=s.startOffset),s.endOffset!=null&&(i.endOffset=s.endOffset),s.url&&(i.url=s.url),n.clip=i}if(r){const i={"@type":"BroadcastEvent"};r.name&&(i.name=r.name),r.startDate&&(i.startDate=r.startDate),r.endDate&&(i.endDate=r.endDate),r.isLiveBroadcast!=null&&(i.isLiveBroadcast=r.isLiveBroadcast),r.url&&(i.url=r.url),n.broadcaster=i}if(g&&g.length>0){const i=g.map(B);if(n.review=i,!a){const f=g.map(u=>u.reviewRating?Number(u.reviewRating.ratingValue):NaN).filter(u=>!Number.isNaN(u));if(f.length>0){const u=f.reduce((v,C)=>v+C,0);n.aggregateRating={"@type":"AggregateRating",ratingValue:u/f.length,reviewCount:g.length,ratingCount:f.length}}}}return a&&(n.aggregateRating={"@type":"AggregateRating",ratingValue:a.ratingValue,...a.reviewCount!=null&&{reviewCount:a.reviewCount},...a.ratingCount!=null&&{ratingCount:a.ratingCount},...a.bestRating!=null&&{bestRating:a.bestRating},...a.worstRating!=null&&{worstRating:a.worstRating}}),n};var D=P;export{D as default,P as generateVideoSchema};

package/general/generic-cache.d.mts

@@ -0,0 +1,193 @@
+/**
+ * Generic Cache Utilities
+ *
+ * A lightweight localStorage-backed cache used by module-level cache wrappers.
+ * Key behaviors:
+ * - Default expiration: 1 day (configurable per cache)
+ * - Search and filter requests bypass the cache and always fetch fresh data
+ * - Lists are stored as a normalized map (id -> item) for fast lookups
+ * - Provides both synchronous reads (`getCachedDataSync`) and async reads
+ *   with API fallback (`getCachedData`)
+ * - Single-item helpers available (`getCachedSingleItem`, `getCachedSingleItemSync`)
+ *
+ * The main async helper `getCachedData` now accepts a single options object
+ * (`GetCachedDataOptions`) which includes `config`, optional `searchQuery`,
+ * `filters`, `pageLimit` and extra `params` for the list API. Module cache
+ * wrappers should call `getCachedData({ config, searchQuery, filters, pageLimit, params, headers })`.
+ * Both `getCachedData` and `getCachedSingleItem` accept an optional `headers`
+ * object which will be forwarded to the underlying `fetchData` calls.
+ *
+ * Organization:
+ * - Types
+ * - List Cache Functions
+ * - Single Item Cache Functions
+ * - Cache Utilities
+ */
+interface CacheConfig {
+    cacheKey: string;
+    apiUrl: string;
+    expirationMs?: number;
+    responseKey?: string;
+    params?: Record<string, unknown>;
+}
+interface GetCachedDataOptions {
+    config: CacheConfig;
+    params?: Record<string, unknown>;
+    headers?: Record<string, string>;
+}
+interface CachedData<T> {
+    items: Record<string, T>;
+    cachedAt: string;
+    count: number;
+    currentPage?: number;
+}
+interface CachedSingleData<T> {
+    item: T;
+    cachedAt: string;
+}
+interface ListResponse<T> {
+    count: number;
+    items: T[];
+    currentPage?: number;
+}
+/**
+ * Get synchronous cached data for a module
+ * Returns empty result if cache is missing or stale
+ *
+ * @param cacheKey - localStorage key for the cache
+ * @param expirationMs - Cache expiration time in milliseconds (default: 1 day)
+ * @returns {count: number, items: T[]} - Cached data or empty array
+ *
+ * @example
+ * const users = getCachedDataSync<UserBE>(LS_KEYS.USERS);
+ * if (users.items.length > 0) {
+ *   console.log(users.items[0].name);
+ * }
+ */
+declare const getCachedDataSync: <T>(cacheKey: string, expirationMs?: number) => ListResponse<T>;
+/**
+ * Get cached data with API fallback for a module
+ *
+ * Accepts a single `GetCachedDataOptions` object. The function will return
+ * cached results when fresh, or fetch from the API when the cache is stale
+ * or when `searchQuery`/`filters` are present (those always bypass cache).
+ *
+ * @param opts - `GetCachedDataOptions` containing `config`, optional
+ *               `searchQuery`, `filters`, `pageLimit`, and extra `params`
+ * @returns Promise<{count: number, items: T[]}> - Cached or fresh data
+ *
+ * @example
+ * const config = { cacheKey: LS_KEYS.USERS, apiUrl: USER_API_ROUTES.LIST, responseKey: 'users' };
+ * // Basic usage (reads cache if fresh)
+ * const users = await getCachedData<UserBE>({ config });
+ *
+ * // With search (bypasses cache)
+ * const filtered = await getCachedData<UserBE>({ config, searchQuery: 'John' });
+ *
+ * // With filters and custom page limit
+ * const active = await getCachedData<UserBE>({ config, filters: { enabled: true }, pageLimit: 200 });
+ */
+declare const getCachedData: <T>(opts: GetCachedDataOptions) => Promise<ListResponse<T>>;
+/**
+ * Get single cached item by ID from a list cache
+ *
+ * @param cacheKey - localStorage key for the cache
+ * @param itemId - ID of the item to retrieve
+ * @returns T | null - Cached item or null
+ *
+ * @example
+ * const user = getCachedItemById<UserBE>(LS_KEYS.USERS, 'user-123');
+ * if (user) {
+ *   console.log(user.name);
+ * }
+ */
+declare const getCachedItemById: <T extends {
+    id: string;
+}>(cacheKey: string, itemId: string) => T | null;
+/**
+ * Get synchronous cached single item
+ * Returns null if cache is missing or stale
+ *
+ * @param cacheKey - localStorage key for the cache
+ * @param expirationMs - Cache expiration time in milliseconds (default: 1 day)
+ * @returns T | null - Cached item or null
+ *
+ * @example
+ * const workspace = getCachedSingleItemSync<WorkspaceBE>(LS_KEYS.WORKSPACE);
+ * if (workspace) {
+ *   console.log(workspace.name);
+ * }
+ */
+declare const getCachedSingleItemSync: <T>(cacheKey: string, expirationMs?: number) => T | null;
+/**
+ * Get cached single item with API fallback
+ * Useful for workspace, profile, settings, etc.
+ *
+ * @param config - Cache configuration (cacheKey, apiUrl, expirationMs, responseKey)
+ * @param params - Optional query parameters for API request
+ * @returns Promise<T | null> - Cached or fresh item
+ *
+ * @example
+ * const config = { cacheKey: LS_KEYS.WORKSPACE, apiUrl: '/api/workspace', responseKey: 'workspace' };
+ * const workspace = await getCachedSingleItem<WorkspaceBE>(config, { subdomain: 'school1' });
+ */
+declare const getCachedSingleItem: <T>(config: CacheConfig, params?: Record<string, string>, headers?: Record<string, string>) => Promise<T | null>;
+/**
+ * Get cached data but fall back to the API when sync cache is empty.
+ *
+ * This helper first performs a quick synchronous cache check via
+ * `getCachedDataSync`. If that returns an empty result it will call
+ * the async `getCachedData` to fetch fresh data from the API and return
+ * the result. Use this when callers want a fast-path cache read but also
+ * need the ability to recall the API transparently when cache is missing.
+ */
+declare const getCachedDataWithFallback: <T>(config: CacheConfig, params?: Record<string, unknown>, headers?: Record<string, string>) => Promise<ListResponse<T>>;
+/**
+ * Async variant to get a single item by ID with API fallback.
+ *
+ * Unlike `getCachedItemById` (sync), this function will call the API
+ * (via `getCachedDataWithFallback`) when the item is not available in
+ * the local cache. Requires a full `CacheConfig` so the API URL is
+ * available for fetching.
+ */
+declare const getCachedItemByIdAsync: <T extends {
+    id: string;
+}>(config: CacheConfig, itemId: string, params?: Record<string, unknown>, headers?: Record<string, string>) => Promise<T | null>;
+/**
+ * Invalidate (remove) cache for a module
+ * Useful after create/update/delete operations
+ *
+ * @param cacheKey - localStorage key for the cache
+ *
+ * @example
+ * invalidateCache(LS_KEYS.USERS);
+ * const freshUsers = await getCachedData(config);
+ */
+declare const invalidateCache: (cacheKey: string) => void;
+/**
+ * Preload cache for a module
+ * Useful to call on app initialization or login
+ *
+ * @param config - Cache configuration
+ * @returns Promise<ListResponse<T>> - Preloaded data
+ *
+ * @example
+ * const config = { cacheKey: LS_KEYS.USERS, apiUrl: USER_API_ROUTES.LIST, responseKey: 'users' };
+ * await preloadCache(config);
+ */
+declare const preloadCache: <T>(config: CacheConfig) => Promise<ListResponse<T>>;
+/**
+ * Check if cache is stale (older than expiration time)
+ *
+ * @param cacheKey - localStorage key for the cache
+ * @param expirationMs - Cache expiration time in milliseconds (default: 1 day)
+ * @returns boolean - True if cache is stale or doesn't exist
+ *
+ * @example
+ * if (isCacheStale(LS_KEYS.USERS)) {
+ *   await getCachedData(config); // This will fetch fresh data
+ * }
+ */
+declare const isCacheStale: (cacheKey: string, expirationMs?: number) => boolean;
+
+export { type CacheConfig, type CachedData, type CachedSingleData, type GetCachedDataOptions, type ListResponse, getCachedData, getCachedDataSync, getCachedDataWithFallback, getCachedItemById, getCachedItemByIdAsync, getCachedSingleItem, getCachedSingleItemSync, invalidateCache, isCacheStale, preloadCache };

package/general/generic-cache.mjs

@@ -0,0 +1 @@
+import{API_METHODS as x}from"../constants/api-methods";import{ONE_DAY_IN_MS as A}from"../constants/cache-time";import{fetchData as O}from"./fetch-data";import{getStorageValue as w}from"../local-storage/get-storage-value";import{setStorageValue as q}from"../local-storage/set-storage-value";function k(t){if(!t||typeof t!="object")return!1;const n=t;return Array.isArray(n.items)&&typeof n.cachedAt=="string"&&typeof n.count=="number"}function M(t){if(!t||typeof t!="object")return!1;const n=t;return n.items!==void 0&&typeof n.items=="object"&&!Array.isArray(n.items)&&typeof n.cachedAt=="string"}const z=(t,n=A)=>{try{const e=w(t);if(e==null)return{count:0,items:[]};const s=new Date().getTime();if(k(e)){const r=new Date(e.cachedAt).getTime();return s-r<n?{count:e.count??e.items.length,items:e.items,currentPage:e.currentPage??void 0}:{count:0,items:[]}}if(M(e)){const r=new Date(e.cachedAt).getTime();if(s-r<n){const a=Object.values(e.items||{});return{count:e.count??a.length,items:a,currentPage:e.currentPage??void 0}}return{count:0,items:[]}}return{count:0,items:[]}}catch(e){return console.error(`Error getting cached data for ${t}:`,e),{count:0,items:[]}}},J=async t=>{const{config:n,params:e,headers:s}=t,{cacheKey:r,apiUrl:u,responseKey:a}=n,T=n.expirationMs??A,D=e?.pageLimit?.toString()??"100",$=e?.currentPage?.toString()??"1",p=e?.filters,l=e?.searchQuery;try{if(l&&l.trim()||e?.filters){const o={...e||{}};o.filters!==void 0&&delete o.filters;const f=Object.keys(o).reduce((i,h)=>(i[h]=String(o[h]),i),{}),y={pageLimit:D,currentPage:$,...l&&{searchQuery:l},...p?Object.keys(p).reduce((i,h)=>(i[h]=String(p[h]),i),{}):{},...f},P=new URLSearchParams(y),d=await O({url:`${u}?${P.toString()}`,method:x.GET,headers:s}),g=a?d?.data?.[a]:d?.data?.items||d?.data,m=Array.isArray(g)?g:[],R=d?.data?.currentPage,L=R==null?void 0:Number(R),N=e?.currentPage?Number(e.currentPage):void 0;return{count:d?.data?.count||m.length,items:m,currentPage:L??N}}const c=w(r),U=new Date().getTime();if(k(c)){const o=new Date(c.cachedAt).getTime();if(U-o<T)return{count:c.count,items:c.items,currentPage:c.currentPage??void 0}}if(M(c)){const o=new Date(c.cachedAt).getTime();if(U-o<T){const y=Object.values(c.items||{}),P=c.count,d=c.currentPage,g=e?.currentPage?Number(e.currentPage):void 0;if(g!==void 0&&g!==d){const m={...e||{}};m.filters!==void 0&&delete m.filters;const R=Object.keys(m).reduce((C,S)=>(C[S]=String(m[S]),C),{}),L={pageLimit:D,currentPage:String(g),...R},N=new URLSearchParams(L),i=await O({url:`${u}?${N.toString()}`,method:x.GET,headers:s}),h=(a?i?.data?.[a]:i?.data?.items)||i?.data,te=Array.isArray(h)?h:[],W=i?.data?.count,_=i?.data?.currentPage,ne=_==null?void 0:Number(_),re=te.reduce((C,S,se)=>{const Y=S,ae=Y?.id??Y?.uid??se,ce=String(ae);return C[ce]=S,C},{}),K=Object.assign({},c.items||{},re),Q=Object.values(K),V=W??Q.length,H=ne??g;if(Array.isArray(h)&&typeof W=="number"){const C={items:K,cachedAt:new Date().toISOString(),count:V,currentPage:H};q(r,C)}return{count:V,items:Q,currentPage:H}}return{count:P??y.length,items:y,currentPage:c.currentPage??void 0}}}const I={...e||{}};I.filters!==void 0&&delete I.filters;const X=Object.keys(I).reduce((o,f)=>(o[f]=String(I[f]),o),{}),Z={pageLimit:D,currentPage:$,...X},ee=new URLSearchParams(Z),b=await O({url:`${u}?${ee.toString()}`,method:x.GET,headers:s}),j=(a?b?.data?.[a]:b?.data?.items)||b?.data,G=Array.isArray(j)?j:[],E=b?.data?.count,v=b?.data?.currentPage,B=v==null?void 0:Number(v),F=e?.currentPage?Number(e.currentPage):void 0;if(Array.isArray(j)&&typeof E=="number"){const f={items:G.reduce((y,P,d)=>{const g=P,m=g?.id??g?.uid??d,R=String(m);return y[R]=P,y},{}),cachedAt:new Date().toISOString(),count:E,currentPage:B??F};q(r,f)}return{count:E,items:G,currentPage:B??F}}catch(c){return console.error(`Error fetching data for ${r}:`,c),{count:0,items:[]}}},fe=(t,n)=>{if(!n)return null;try{const e=w(t);if(k(e))return e.items.find(r=>r.id===n)||null;if(M(e))return e.items&&e.items[n]||null;const{items:s}=z(t);return s.find(r=>r.id===n)||null}catch(e){return console.error(`Error getting cached item by ID for ${t}:`,e),null}},Te=(t,n=A)=>{try{const e=w(t);if(!e)return null;const s=new Date().getTime(),r=new Date(e.cachedAt).getTime();return s-r<n?e.item:null}catch(e){return console.error(`Error getting cached single item for ${t}:`,e),null}},pe=async(t,n,e)=>{const{cacheKey:s,apiUrl:r}=t,u=t.expirationMs??A;try{const a=w(s),T=new Date().getTime();if(a){const l=new Date(a.cachedAt).getTime();if(T-l<u)return a.item}const D=n?`?${new URLSearchParams(n).toString()}`:"",p=(await O({url:`${r}${D}`,method:x.GET,headers:e}))?.data||null;if(p){const l={item:p,cachedAt:new Date().toISOString()};q(s,l)}return p}catch(a){return console.error(`Error fetching single item for ${s}:`,a),null}},oe=async(t,n,e)=>{const s=t.expirationMs??A;try{const r=z(t.cacheKey,s);return r&&r.count>0&&Array.isArray(r.items)&&r.items.length>0?r:await J({config:t,params:n,headers:e})}catch(r){return console.error(`Error in getCachedDataWithFallback for ${t.cacheKey}:`,r),{count:0,items:[]}}},ye=async(t,n,e,s)=>{if(!n)return null;try{const r=w(t.cacheKey);if(k(r)){const a=r.items.find(T=>T.id===n);if(a)return a}return M(r)&&r.items&&r.items[n]?r.items[n]:(await oe(t,e,s)).items.find(a=>a.id===n)||null}catch(r){return console.error(`Error in getCachedItemByIdAsync for ${t.cacheKey}:`,r),null}},Ce=t=>{try{localStorage.removeItem(t)}catch(n){console.error(`Error invalidating cache for ${t}:`,n)}},we=async t=>J({config:t}),Pe=(t,n=A)=>{try{const e=w(t);if(e==null)return!0;if(k(e)||M(e)){const s=new Date(e.cachedAt).getTime();return new Date().getTime()-s>=n}return!0}catch(e){return console.error(`Error checking cache staleness for ${t}:`,e),!0}};export{J as getCachedData,z as getCachedDataSync,oe as getCachedDataWithFallback,fe as getCachedItemById,ye as getCachedItemByIdAsync,pe as getCachedSingleItem,Te as getCachedSingleItemSync,Ce as invalidateCache,Pe as isCacheStale,we as preloadCache};

package/general/get-available-page-limit.d.mts

@@ -0,0 +1,11 @@
+interface Return {
+    option: string;
+}
+/**
+ * Returns available page-limit dropdown options based on total record count.
+ * @param totalRecords - Total number of records.
+ * @returns Array of page-limit option objects.
+ */
+declare const getAvailablePageLimits: (totalRecords: number) => Array<Return>;
+
+export { getAvailablePageLimits };

package/general/get-available-page-limit.mjs

@@ -0,0 +1 @@
+import{dynamicPageLimit as o}from"./dynamic-page-limit";const s=n=>{const i=[10,15,25,100];if(n<i[0])return o([i[0]]);const a=i.filter(r=>r<n),t=i.find(r=>r>=n),e=[...a];return t&&!e.includes(t)&&e.push(t),o(e)};export{s as getAvailablePageLimits};

package/general/get-calendar-current-month.d.mts

@@ -0,0 +1,15 @@
+import { CalendarDay } from './type.mjs';
+
+interface Params {
+    month: number;
+    year: number;
+}
+/**
+ * Generates an array of CalendarDay objects for the current month.
+ * @param params.month - Month number (1-based).
+ * @param params.year - Full year number.
+ * @returns Array of CalendarDay objects for the month.
+ */
+declare const getCalendarCurrentMonth: ({ month, year, }: Params) => Array<CalendarDay>;
+
+export { getCalendarCurrentMonth };

package/general/get-calendar-current-month.js

@@ -1 +1 @@
-var f=Object.create;var o=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var D=Object.getOwnPropertyNames;var d=Object.getPrototypeOf,M=Object.prototype.hasOwnProperty;var p=(r,a)=>{for(var t in a)o(r,t,{get:a[t],enumerable:!0})},m=(r,a,t,n)=>{if(a&&typeof a=="object"||typeof a=="function")for(let e of D(a))!M.call(r,e)&&e!==t&&o(r,e,{get:()=>a[e],enumerable:!(n=u(a,e))||n.enumerable});return r};var C=(r,a,t)=>(t=r!=null?f(d(r)):{},m(a||!r||!r.__esModule?o(t,"default",{value:r,enumerable:!0}):t,r)),h=r=>m(o({},"__esModule",{value:!0}),r);var Y={};p(Y,{getCalendarCurrentMonth:()=>i});module.exports=h(Y);var y=C(require("dayjs")),s=require("./get-number-of-days-in-month");const i=({month:r,year:a})=>{const t=new Date().getDate();return[...Array((0,s.getNumberOfDaysInMonth)({year:a,month:r}))].map((n,e)=>({date:(0,y.default)(`${a}-${r}-${e+1}`).format("YYYY-MM-DD"),dayOfMonth:e+1,isCurrentMonth:!0,isToday:t===e+1}))};0&&(module.exports={getCalendarCurrentMonth});
+var m=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var D=Object.prototype.hasOwnProperty;var d=(a,r)=>{for(var t in r)m(a,t,{get:r[t],enumerable:!0})},f=(a,r,t,n)=>{if(r&&typeof r=="object"||typeof r=="function")for(let e of u(r))!D.call(a,e)&&e!==t&&m(a,e,{get:()=>r[e],enumerable:!(n=y(r,e))||n.enumerable});return a};var M=a=>f(m({},"__esModule",{value:!0}),a);var c={};d(c,{getCalendarCurrentMonth:()=>C});module.exports=M(c);var s=require("./get-number-of-days-in-month");const C=({month:a,year:r})=>{const t=require("dayjs"),n=new Date().getDate();return[...Array((0,s.getNumberOfDaysInMonth)({year:r,month:a}))].map((e,o)=>({date:t(`${r}-${a}-${o+1}`).format("YYYY-MM-DD"),dayOfMonth:o+1,isCurrentMonth:!0,isToday:n===o+1}))};0&&(module.exports={getCalendarCurrentMonth});

package/general/get-calendar-current-month.mjs

@@ -0,0 +1 @@
+import{getNumberOfDaysInMonth as o}from"./get-number-of-days-in-month";const D=({month:a,year:t})=>{const e=require("dayjs"),n=new Date().getDate();return[...Array(o({year:t,month:a}))].map((m,r)=>({date:e(`${t}-${a}-${r+1}`).format("YYYY-MM-DD"),dayOfMonth:r+1,isCurrentMonth:!0,isToday:n===r+1}))};export{D as getCalendarCurrentMonth};

package/general/get-calendar-dates.d.mts

@@ -0,0 +1,15 @@
+import { CalendarDay } from './type.mjs';
+
+interface Params {
+    month: number;
+    year: number;
+}
+/**
+ * Generates a full calendar month grid including overflow days from adjacent months.
+ * @param params.month - Month index (0-based).
+ * @param params.year - Full year number.
+ * @returns Array of CalendarDay objects for the entire grid.
+ */
+declare const getCalendarDates: ({ month, year, }: Params) => Array<CalendarDay>;
+
+export { getCalendarDates };

package/general/get-calendar-dates.js

@@ -1 +1 @@
-var u=Object.create;var e=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var M=Object.getPrototypeOf,l=Object.prototype.hasOwnProperty;var D=(t,r)=>{for(var o in r)e(t,o,{get:r[o],enumerable:!0})},m=(t,r,o,a)=>{if(r&&typeof r=="object"||typeof r=="function")for(let n of C(r))!l.call(t,n)&&n!==o&&e(t,n,{get:()=>r[n],enumerable:!(a=f(r,n))||a.enumerable});return t};var s=(t,r,o)=>(o=t!=null?u(M(t)):{},m(r||!t||!t.__esModule?e(o,"default",{value:t,enumerable:!0}):o,t)),g=t=>m(e({},"__esModule",{value:!0}),t);var P={};D(P,{getCalendarDates:()=>x});module.exports=g(P);var d=s(require("dayjs")),h=s(require("dayjs/plugin/weekday")),i=require("./get-calendar-previous-month"),p=require("./get-calendar-next-month"),y=require("./get-calendar-current-month");d.default.extend(h.default);const x=({month:t,year:r})=>{const o=t+1,a=(0,y.getCalendarCurrentMonth)({month:o,year:r}),n=(0,i.getCalendarPreviousMonth)({currentMonthDays:a,month:o,year:r}),c=(0,p.getCalendarNextMonth)({currentMonthDays:a,month:o,year:r});return[...n,...a,...c]};0&&(module.exports={getCalendarDates});
+var s=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var C=(n,t)=>{for(var e in t)s(n,e,{get:t[e],enumerable:!0})},M=(n,t,e,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of y(t))!p.call(n,r)&&r!==e&&s(n,r,{get:()=>t[r],enumerable:!(o=i(t,r))||o.enumerable});return n};var l=n=>M(s({},"__esModule",{value:!0}),n);var f={};C(f,{getCalendarDates:()=>D});module.exports=l(f);var m=require("./get-calendar-previous-month"),d=require("./get-calendar-next-month"),h=require("./get-calendar-current-month");const D=({month:n,year:t})=>{const e=require("dayjs"),o=require("dayjs/plugin/weekday");e.extend(o);const r=n+1,a=(0,h.getCalendarCurrentMonth)({month:r,year:t}),c=(0,m.getCalendarPreviousMonth)({currentMonthDays:a,month:r,year:t}),u=(0,d.getCalendarNextMonth)({currentMonthDays:a,month:r,year:t});return[...c,...a,...u]};0&&(module.exports={getCalendarDates});

package/general/get-calendar-dates.mjs

@@ -0,0 +1 @@
+import{getCalendarPreviousMonth as d}from"./get-calendar-previous-month";import{getCalendarNextMonth as h}from"./get-calendar-next-month";import{getCalendarCurrentMonth as c}from"./get-calendar-current-month";const l=({month:e,year:t})=>{const o=require("dayjs"),a=require("dayjs/plugin/weekday");o.extend(a);const n=e+1,r=c({month:n,year:t}),s=d({currentMonthDays:r,month:n,year:t}),m=h({currentMonthDays:r,month:n,year:t});return[...s,...r,...m]};export{l as getCalendarDates};

package/general/get-calendar-next-month.d.mts

@@ -0,0 +1,17 @@
+import { CalendarDay } from './type.mjs';
+
+interface Params {
+    currentMonthDays: Array<CalendarDay>;
+    month: number;
+    year: number;
+}
+/**
+ * Generates the overflow CalendarDay entries from the next month to fill the grid.
+ * @param params.currentMonthDays - Days of the current month.
+ * @param params.month - Month number (1-based).
+ * @param params.year - Full year number.
+ * @returns Array of CalendarDay objects for the overflow days.
+ */
+declare const getCalendarNextMonth: ({ year, month, currentMonthDays, }: Params) => Array<CalendarDay>;
+
+export { getCalendarNextMonth };

package/general/get-calendar-next-month.js

@@ -1 +1 @@
-var f=Object.create;var o=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var M=Object.getOwnPropertyNames;var D=Object.getPrototypeOf,$=Object.prototype.hasOwnProperty;var i=(a,r)=>{for(var t in r)o(a,t,{get:r[t],enumerable:!0})},s=(a,r,t,n)=>{if(r&&typeof r=="object"||typeof r=="function")for(let e of M(r))!$.call(a,e)&&e!==t&&o(a,e,{get:()=>r[e],enumerable:!(n=l(r,e))||n.enumerable});return a};var c=(a,r,t)=>(t=a!=null?f(D(a)):{},s(r||!a||!a.__esModule?o(t,"default",{value:a,enumerable:!0}):t,a)),u=a=>s(o({},"__esModule",{value:!0}),a);var C={};i(C,{getCalendarNextMonth:()=>p});module.exports=u(C);var m=c(require("dayjs")),d=require("./get-week-day");const p=({year:a,month:r,currentMonthDays:t})=>{const n=(0,d.getWeekday)(`${a}-${r}-${t.length}`),e=(0,m.default)(`${a}-${r}-01`).add(1,"month"),h=n&&7-n;return[...Array(h)].map((b,y)=>({date:(0,m.default)(`${e.year()}-${e.month()+1}-${y+1}`).format("YYYY-MM-DD"),dayOfMonth:y+1,isCurrentMonth:!1,isToday:!1}))};0&&(module.exports={getCalendarNextMonth});
+var o=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var M=(r,a)=>{for(var t in a)o(r,t,{get:a[t],enumerable:!0})},D=(r,a,t,n)=>{if(a&&typeof a=="object"||typeof a=="function")for(let e of f(a))!l.call(r,e)&&e!==t&&o(r,e,{get:()=>a[e],enumerable:!(n=h(a,e))||n.enumerable});return r};var $=r=>D(o({},"__esModule",{value:!0}),r);var i={};M(i,{getCalendarNextMonth:()=>c});module.exports=$(i);var m=require("./get-week-day");const c=({year:r,month:a,currentMonthDays:t})=>{const n=require("dayjs"),e=(0,m.getWeekday)(`${r}-${a}-${t.length}`),s=n(`${r}-${a}-01`).add(1,"month"),d=e&&7-e;return[...Array(d)].map((u,y)=>({date:n(`${s.year()}-${s.month()+1}-${y+1}`).format("YYYY-MM-DD"),dayOfMonth:y+1,isCurrentMonth:!1,isToday:!1}))};0&&(module.exports={getCalendarNextMonth});

package/general/get-calendar-next-month.mjs

@@ -0,0 +1 @@
+import{getWeekday as m}from"./get-week-day";const M=({year:r,month:e,currentMonthDays:s})=>{const t=require("dayjs"),a=m(`${r}-${e}-${s.length}`),n=t(`${r}-${e}-01`).add(1,"month"),y=a&&7-a;return[...Array(y)].map((d,o)=>({date:t(`${n.year()}-${n.month()+1}-${o+1}`).format("YYYY-MM-DD"),dayOfMonth:o+1,isCurrentMonth:!1,isToday:!1}))};export{M as getCalendarNextMonth};

package/general/get-calendar-previous-month.d.mts

@@ -0,0 +1,17 @@
+import { CalendarDay } from './type.mjs';
+
+interface Params {
+    currentMonthDays: Array<CalendarDay>;
+    month: number;
+    year: number;
+}
+/**
+ * Generates the overflow CalendarDay entries from the previous month to fill the grid.
+ * @param params.currentMonthDays - Days of the current month.
+ * @param params.month - Month number (1-based).
+ * @param params.year - Full year number.
+ * @returns Array of CalendarDay objects for the overflow days.
+ */
+declare const getCalendarPreviousMonth: ({ currentMonthDays, month, year, }: Params) => Array<CalendarDay>;
+
+export { getCalendarPreviousMonth };

package/general/get-calendar-previous-month.js

@@ -1 +1 @@
-var i=Object.create;var n=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var M=Object.getOwnPropertyNames;var c=Object.getPrototypeOf,D=Object.prototype.hasOwnProperty;var l=(a,r)=>{for(var t in r)n(a,t,{get:r[t],enumerable:!0})},f=(a,r,t,o)=>{if(r&&typeof r=="object"||typeof r=="function")for(let e of M(r))!D.call(a,e)&&e!==t&&n(a,e,{get:()=>r[e],enumerable:!(o=u(r,e))||o.enumerable});return a};var p=(a,r,t)=>(t=a!=null?i(c(a)):{},f(r||!a||!a.__esModule?n(t,"default",{value:a,enumerable:!0}):t,a)),b=a=>f(n({},"__esModule",{value:!0}),a);var C={};l(C,{getCalendarPreviousMonth:()=>v});module.exports=b(C);var s=p(require("dayjs")),h=require("./get-week-day");const v=({currentMonthDays:a,month:r,year:t})=>{const o=(0,h.getWeekday)(a[0].date),e=(0,s.default)(`${t}-${r}-01`).subtract(1,"month"),y=o?o-1:6,m=(0,s.default)(a[0].date).subtract(y,"day").date();return[...Array(y)].map(($,d)=>({date:(0,s.default)(`${e.year()}-${e.month()+1}-${m+d}`).format("YYYY-MM-DD"),dayOfMonth:m+d,isCurrentMonth:!1,isToday:!1}))};0&&(module.exports={getCalendarPreviousMonth});
+var n=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var M=(r,a)=>{for(var e in a)n(r,e,{get:a[e],enumerable:!0})},c=(r,a,e,o)=>{if(a&&typeof a=="object"||typeof a=="function")for(let t of u(a))!f.call(r,t)&&t!==e&&n(r,t,{get:()=>a[t],enumerable:!(o=i(a,t))||o.enumerable});return r};var D=r=>c(n({},"__esModule",{value:!0}),r);var b={};M(b,{getCalendarPreviousMonth:()=>l});module.exports=D(b);var h=require("./get-week-day");const l=({currentMonthDays:r,month:a,year:e})=>{const o=require("dayjs"),t=(0,h.getWeekday)(r[0].date),s=o(`${e}-${a}-01`).subtract(1,"month"),y=t?t-1:6,d=o(r[0].date).subtract(y,"day").date();return[...Array(y)].map((p,m)=>({date:o(`${s.year()}-${s.month()+1}-${d+m}`).format("YYYY-MM-DD"),dayOfMonth:d+m,isCurrentMonth:!1,isToday:!1}))};0&&(module.exports={getCalendarPreviousMonth});

package/general/get-calendar-previous-month.mjs

@@ -0,0 +1 @@
+import{getWeekday as m}from"./get-week-day";const M=({currentMonthDays:r,month:y,year:d})=>{const a=require("dayjs"),t=m(r[0].date),e=a(`${d}-${y}-01`).subtract(1,"month"),o=t?t-1:6,n=a(r[0].date).subtract(o,"day").date();return[...Array(o)].map((h,s)=>({date:a(`${e.year()}-${e.month()+1}-${n+s}`).format("YYYY-MM-DD"),dayOfMonth:n+s,isCurrentMonth:!1,isToday:!1}))};export{M as getCalendarPreviousMonth};

package/general/get-current-year.d.mts

@@ -0,0 +1,7 @@
+/**
+ * Returns the current 4-digit year.
+ * @returns The current year as a number.
+ */
+declare const getCurrentYear: () => number;
+
+export { getCurrentYear };

package/general/get-current-year.mjs

@@ -0,0 +1 @@
+const e=()=>new Date().getFullYear();export{e as getCurrentYear};

package/general/get-day-name.d.mts

@@ -0,0 +1,10 @@
+interface IDayMap {
+    /**
+     *
+     */
+    [key: number]: string;
+}
+declare const dayMap: IDayMap;
+declare const getDayName: (num: number) => string;
+
+export { type IDayMap, dayMap, getDayName };

package/general/get-day-name.mjs

@@ -0,0 +1 @@
+const e={0:"Sunday",1:"Monday",2:"Tuesday",3:"Wednesday",4:"Thursday",5:"Friday",6:"Saturday"},y=a=>e[a];export{e as dayMap,y as getDayName};

package/general/get-dial-code.d.mts

@@ -0,0 +1,8 @@
+/**
+ * Returns the dial code for a given ISO country code.
+ * @param countryCode - The ISO country code.
+ * @returns The dial code string, or undefined if not found.
+ */
+declare const getDialCode: (countryCode: string) => string | undefined;
+
+export { getDialCode };

package/general/get-dial-code.mjs

@@ -0,0 +1 @@
+import{dialCodeMap as t}from"../constants/dial-codes";const i=e=>t.get(e);export{i as getDialCode};

package/general/get-full-name.d.mts

@@ -0,0 +1,13 @@
+interface Params {
+    firstName: string;
+    lastName: string;
+}
+/**
+ * Combines first and last name into a full name string.
+ * @param params.firstName - The first name.
+ * @param params.lastName - The last name.
+ * @returns The combined full name.
+ */
+declare const getFullName: ({ firstName, lastName }: Params) => string;
+
+export { getFullName };

package/general/get-full-name.mjs

@@ -0,0 +1 @@
+const r=({firstName:a,lastName:t})=>`${a} ${t}`;export{r as getFullName};

package/general/get-href.d.mts

@@ -0,0 +1,11 @@
+/**
+ * A util function to get current window href
+ *
+ * @returns string - https://taimoor.io/
+ * @author Taimoor Khan
+ * @remarks Taimoor Resume 4
+ */
+/** End file docs */
+declare const getHref: () => string;
+
+export { getHref };

package/general/get-href.mjs

@@ -0,0 +1 @@
+const o=()=>window&&window.location.href;export{o as getHref};

package/general/get-month-name.d.mts

@@ -0,0 +1,10 @@
+interface IMonthMap {
+    /**
+     *
+     */
+    [key: number]: string;
+}
+declare const monthMap: IMonthMap;
+declare const getMonthName: (num: number) => string;
+
+export { type IMonthMap, getMonthName, monthMap };

package/general/get-month-name.mjs

@@ -0,0 +1 @@
+const r={0:"January",1:"February",2:"March",3:"April",4:"May",5:"June",6:"July",7:"August",8:"September",9:"October",10:"November",11:"December"},t=e=>r[e];export{t as getMonthName,r as monthMap};

package/general/get-month-number.d.mts

@@ -0,0 +1,15 @@
+interface IMonthNameMap {
+    /**
+     *
+     */
+    [key: string]: number;
+}
+declare const monthNameMap: IMonthNameMap;
+/**
+ * Get the UTC month number (0-11) from a month name
+ * @param monthName - The name of the month (case-insensitive)
+ * @returns The UTC month number (0-11), or -1 if the month name is invalid
+ */
+declare const getMonthNumber: (monthName: string) => number;
+
+export { type IMonthNameMap, getMonthNumber, monthNameMap };

package/general/get-month-number.mjs

@@ -0,0 +1 @@
+const r={january:0,february:1,march:2,april:3,may:4,june:5,july:6,august:7,september:8,october:9,november:10,december:11},n=t=>{const e=t.toLowerCase().trim();return r[e]!==void 0?r[e]:-1};export{n as getMonthNumber,r as monthNameMap};

package/general/get-number-of-days-in-month.d.mts

@@ -0,0 +1,13 @@
+interface Params {
+    year: number;
+    month: number;
+}
+/**
+ * Returns the number of days in a given month and year.
+ * @param params.year - The year.
+ * @param params.month - The month number (1-based).
+ * @returns Number of days in the month.
+ */
+declare const getNumberOfDaysInMonth: ({ year, month }: Params) => number;
+
+export { getNumberOfDaysInMonth };