@fajarmaulana/komerce-lp-helper 0.4.15 → 0.4.16

package/README.md

@@ -306,24 +306,64 @@ const { mutate, isLoading, progress } = api.mutation<User, FormData>('/users/upl
 | Property | Type | Description |
 |---|---|---|
 | `data` | `T \| null` | Aggregated items. |
-| `fetchNextPage`| `() => Promise<void>` | Trigger fetch for next offset. |
+| `error` | `unknown` | Any encountered error. |
+| `isLoading` | `boolean` | Initial page request state. |
 | `hasNextPage`| `boolean` | More pages available. |
 | `isFetchingNextPage`| `boolean` | Fetching next page state. |
+| `fetchNextPage`| `() => Promise<void>` | Trigger fetch for next offset. |
+| `refetch` | `() => Promise<void>` | Reset state and trigger a fresh fetch from initial offset. |
+| `setData` | `(updater: T \| null \| ((prev: T \| null) => T \| null)) => void` | Manually update local cache data. |
+| `reset` | `() => void` | Reset all local states to initial values. |
 
 **Example:**
 ```tsx
-const { data, fetchNextPage, hasNextPage } = api.infinite<User[], number>(
-  '/users',
-  {
-    initialOffset: 0,
-    offsetKey: 'page',
-    setOffset: (lastItems, allItems, lastOffset) => {
-      return lastItems.length > 0 ? lastOffset + 1 : null
+import { createApi } from '@fajarmaulana/komerce-lp-helper'
+
+const api = createApi({ baseURL: 'https://api.example.com' })
+
+const UserList = () => {
+  const {
+    data: users,
+    error,
+    isLoading,
+    hasNextPage,
+    isFetchingNextPage,
+    fetchNextPage,
+    refetch,
+  } = api.infinite<User[], number>(
+    '/users',
+    {
+      initialOffset: 1,
+      offsetKey: 'page',
+      setOffset: (lastItems, allItems, lastOffset) => {
+        // Return next offset (page) or null if there is no more data
+        return lastItems && lastItems.length >= 10 ? lastOffset + 1 : null
+      }
     }
-  }
-)
+  )
+
+  if (isLoading) return <p>Loading...</p>
+  if (error) return <p>Error loading users</p>
+
+  return (
+    <div>
+      <button onClick={refetch}>Refetch</button>
+      <ul>
+        {users?.map(user => (
+          <li key={user.id}>{user.name}</li>
+        ))}
+      </ul>
+      {hasNextPage && (
+        <button onClick={fetchNextPage} disabled={isFetchingNextPage}>
+          {isFetchingNextPage ? 'Loading more...' : 'Load More'}
+        </button>
+      )}
+    </div>
+  )
+}
 ```
 
+
 **4. `batch<T>(initialRequests?)`**
 Execute multiple API requests in parallel. 
 
@@ -437,6 +477,20 @@ Type-safe wrappers for `localStorage`.
 | `removeLocals` | `keys: string[]`          | Removes multiple items.                 |
 | `clearLocals`  |                           | Clears local storage.                   |
 
+#### Session Storage
+
+Type-safe wrappers for `sessionStorage`.
+
+| Function         | Parameters                | Description                             |
+| ---------------- | ------------------------- | --------------------------------------- |
+| `setSession`     | `key: string, value: T`   | Stores a value (JSON stringified).      |
+| `setSessions`    | `items: { key, value }[]` | Stores multiple values.                 |
+| `getSession`     | `key: string`             | Retrieves and parses a value.           |
+| `getSessions`    | `keys: string[]`          | Retrieves multiple values as an object. |
+| `removeSession`  | `key: string`             | Removes an item.                        |
+| `removeSessions` | `keys: string[]`          | Removes multiple items.                 |
+| `clearSessions`  |                           | Clears session storage.                 |
+
 #### File
 
 Helpers for file and blob manipulation.
@@ -507,6 +561,10 @@ numbers, symbols, no spaces).
 
 - `params`: `{ field_id, field_value, field_error }`
 
-## License
+## 👨‍💻 Author & Creator
+
+* **Fajar Maulana** - *Initial Work & Creator* - [fajarmaulana-dev](https://github.com/fajarmaulana-dev)
+
+## 📄 License
 
-MIT
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/dist/index.d.ts

@@ -12,4 +12,5 @@ export * from './utils/error-provider';
 export * from './utils/file';
 export * from './utils/general';
 export * from './utils/local';
+export * from './utils/session';
 export { default as createApi } from './utils/useApi';

package/dist/index.js

@@ -12,4 +12,5 @@ export * from './utils/error-provider';
 export * from './utils/file';
 export * from './utils/general';
 export * from './utils/local';
+export * from './utils/session';
 export { default as createApi } from './utils/useApi';

package/dist/utils/session.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Clear sessionStorage.
+ */
+export declare const clearSessions: () => void;
+/**
+ * Removes an item from sessionStorage by key.
+ *
+ * @param key - The key of the item to remove.
+ */
+export declare const removeSession: (key: string) => void;
+/**
+ * Removes multiple sessionStorage items by keys.
+ *
+ * @param keys - Array of keys to remove.
+ */
+export declare const removeSessions: (keys: string[]) => void;
+/**
+ * Sets an item in sessionStorage after serializing it to JSON.
+ *
+ * @param key - The key under which to store the value.
+ * @param value - The value to store (will be JSON-stringified).
+ */
+export declare const setSession: <T>(key: string, value: T) => void;
+/**
+ * Sets multiple items in sessionStorage after serializing it to JSON.
+ *
+ * @param items - Array of session storage items to set.
+ */
+export declare const setSessions: <T extends Record<string, unknown>>(items: { [K in keyof T]: {
+    key: K & string;
+    value: T[K];
+}; }[keyof T][]) => void;
+/**
+ * Retrieves and parses a JSON item from sessionStorage by key.
+ *
+ * @param key - The key of the item to retrieve.
+ * @returns The parsed value from sessionStorage, or null if not found.
+ */
+export declare const getSession: <T>(key: string) => T | null;
+/**
+ * Retrieves and parses multiple JSON items from sessionStorage by key.
+ *
+ * @param keys - The keys of the items to retrieve.
+ * @returns The parsed values from sessionStorage.
+ */
+export declare const getSessions: <T extends Record<string, unknown>, K extends keyof T = keyof T>(keys: readonly K[]) => { [P in K]: T[P] | null; };

package/dist/utils/session.js

@@ -0,0 +1,60 @@
+/**
+ * Clear sessionStorage.
+ */
+export const clearSessions = () => sessionStorage.clear();
+/**
+ * Removes an item from sessionStorage by key.
+ *
+ * @param key - The key of the item to remove.
+ */
+export const removeSession = (key) => sessionStorage.removeItem(key);
+/**
+ * Removes multiple sessionStorage items by keys.
+ *
+ * @param keys - Array of keys to remove.
+ */
+export const removeSessions = (keys) => keys.forEach(key => removeSession(key));
+/**
+ * Sets an item in sessionStorage after serializing it to JSON.
+ *
+ * @param key - The key under which to store the value.
+ * @param value - The value to store (will be JSON-stringified).
+ */
+export const setSession = (key, value) => sessionStorage.setItem(key, JSON.stringify(value));
+/**
+ * Sets multiple items in sessionStorage after serializing it to JSON.
+ *
+ * @param items - Array of session storage items to set.
+ */
+export const setSessions = (items) => {
+    items.forEach(item => setSession(item.key, item.value));
+};
+/**
+ * Retrieves and parses a JSON item from sessionStorage by key.
+ *
+ * @param key - The key of the item to retrieve.
+ * @returns The parsed value from sessionStorage, or null if not found.
+ */
+export const getSession = (key) => {
+    const item = sessionStorage.getItem(key);
+    try {
+        if (item)
+            return JSON.parse(item);
+        return null;
+    }
+    catch {
+        return item;
+    }
+};
+/**
+ * Retrieves and parses multiple JSON items from sessionStorage by key.
+ *
+ * @param keys - The keys of the items to retrieve.
+ * @returns The parsed values from sessionStorage.
+ */
+export const getSessions = (keys) => {
+    return keys.reduce((acc, key) => {
+        acc[key] = getSession(key);
+        return acc;
+    }, {});
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fajarmaulana/komerce-lp-helper",
-  "version": "0.4.15",
+  "version": "0.4.16",
   "description": "Helper functions, hooks, and utils for Komerce LP",
   "type": "module",
   "main": "dist/index.js",
@@ -49,7 +49,7 @@
     "tsc-alias": "^1.8.16",
     "typescript": "^5.2.0"
   },
-  "author": "Fajar Maulana",
+  "author": "Fajar Maulana <fajarmaulana.dev@gmail.com> (https://github.com/fajarmaulana-dev)",
   "license": "MIT",
   "keywords": [
     "react",