izen-react-starter 2.3.9 → 2.4.0

package/README.md

@@ -763,6 +763,45 @@ function UsersScreen() {
 }
 ```
 
+### Utility helpers (payload, time, HTML)
+
+These utilities are exported from `izen-react-starter/lib`:
+
+- `formatPayloadForEndpoint` (alias: `formatAxiosData`) — normalize payloads per endpoint (e.g., multipart for file-heavy routes, boolean fixes, role permissions, employee shifts).
+- `buildMultipartFormData`, `buildRolePermissionsFormData`, `buildEmployeeShiftFormData` — helpers used by `formatPayloadForEndpoint` that you can also call directly.
+- `removeHtmlTags` — strip HTML tags from strings.
+- Time helpers: `parseTimeToMilliseconds`, `diffHoursFromTimestamps` (alias: `TimeDiffHours`), `subtractTimeStrings`, `sumTimeStrings`, `formatSecondsToHms` (aliases: `secondsToTime`, `formatTimeStr`).
+- Date helpers: `toUTCDateString`/`toUTCDateTimeString`, `getWeekRange` (alias: `getWeekBounds`).
+
+Example payload formatting:
+
+```ts
+import { formatPayloadForEndpoint } from 'izen-react-starter/lib';
+
+// Multipart for file upload endpoints
+const payload = { name: 'Test', image: myFile };
+const body = formatPayloadForEndpoint(payload, '/lessons');
+await axios.post('/lessons', body);
+
+// Role permissions (only true values become permissions[])
+const roleBody = formatPayloadForEndpoint({ name: 'admin', manage_users: true }, '/roles');
+await axios.post('/roles', roleBody);
+
+// Employee shifts schedule
+const shiftBody = formatPayloadForEndpoint({ employeeShifts: { mon: { start: '09:00', end: '17:00' } } }, '/employee-shifts/schedule-update');
+await axios.post('/employee-shifts/schedule-update', shiftBody);
+```
+
+Example time helpers:
+
+```ts
+import { parseTimeToMilliseconds, subtractTimeStrings, formatSecondsToHms } from 'izen-react-starter/lib';
+
+const ms = parseTimeToMilliseconds('09:30'); // 34200000
+const diff = subtractTimeStrings('10:30', '09:00'); // "01:30:00"
+const pretty = formatSecondsToHms(3661); // "01:01:01"
+```
+
 ### Role-Based Access Control (RBAC)
 
 The RBAC system is now fully configurable! Define your own roles, resources, and rules.

package/dist/lib/index.d.ts

@@ -1,4 +1,4 @@
-export { cn, capitalize, convertToHourMinuteString, formatErrorToList, formatDate, dateFromat, createChangeEvent, appendFormData, debounce, throttle } from './utils';
+export { cn, capitalize, convertToHourMinuteString, formatErrorToList, formatDate, dateFromat, createChangeEvent, appendFormData, buildMultipartFormData, buildRolePermissionsFormData, buildEmployeeShiftFormData, formatPayloadForEndpoint, formatAxiosData, removeHtmlTags, toUTCDateString, toUTCDateTimeString, parseTimeToMilliseconds, diffHoursFromTimestamps, subtractTimeStrings, sumTimeStrings, formatSecondsToHms, getWeekRange, debounce, throttle, } from './utils';
 export { handleEditCache, handleSingleEditCache } from './cache-util';
 export type { CacheEditOptions } from './cache-util';
 export * from './api';

package/dist/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACtK,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,EAAE,EACF,UAAU,EACV,yBAAyB,EACzB,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,QAAQ,EACR,QAAQ,GACR,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD,cAAc,OAAO,CAAC"}

package/dist/lib/utils.d.ts

@@ -3,6 +3,12 @@ import { ChangeEvent } from 'react';
 export declare function cn(...inputs: ClassValue[]): string;
 export declare function capitalize(str: string): string;
 export declare function convertToHourMinuteString(hours: number): string;
+/**
+ * Format payloads for specific endpoints (multipart, boolean fixes, etc.).
+ * This is the library-friendly replacement for the old formatAxiosData.
+ */
+export declare function formatPayloadForEndpoint(payload: any, endpoint: string): any;
+export declare const formatAxiosData: typeof formatPayloadForEndpoint;
 export declare function formatErrorToList(str: string[] | string): string;
 export declare function formatDate(date: Date | string, formatStr?: string): string;
 /**
@@ -19,6 +25,9 @@ export declare function formatDate(date: Date | string, formatStr?: string): str
  * ```
  */
 export declare const dateFromat: (date: string | Date) => string;
+export declare function removeHtmlTags(input?: string): string;
+export declare function toUTCDateString(date: Date): string;
+export declare function toUTCDateTimeString(date: Date): string;
 /**
  * Create a synthetic change event for form inputs
  * Useful for programmatic form updates when working with custom components
@@ -37,6 +46,25 @@ export declare const dateFromat: (date: string | Date) => string;
  */
 export declare const createChangeEvent: <T extends HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>(name: string, value: string) => ChangeEvent<T>;
 export declare function appendFormData(data: Record<string, any>): FormData;
+export declare const buildMultipartFormData: typeof appendFormData;
+export declare function buildRolePermissionsFormData(data: any): FormData;
+export declare function buildEmployeeShiftFormData(data: any): FormData;
 export declare function debounce<T extends (...args: any[]) => any>(func: T, wait: number): (...args: Parameters<T>) => void;
 export declare function throttle<T extends (...args: any[]) => any>(func: T, limit: number): (...args: Parameters<T>) => void;
+export declare function parseTimeToMilliseconds(timeStr?: string): number;
+export declare function diffHoursFromTimestamps(endMs: number, startMs: number): string;
+export declare function subtractTimeStrings(time1: string, time2: string): string;
+export declare function sumTimeStrings(time1: string, time2: string): string;
+export declare function formatSecondsToHms(totalSeconds: number): string;
+export declare function getWeekRange(selectedDate: Date): {
+    startDate: Date;
+    endDate: Date;
+};
+export declare const getUTCDate: typeof toUTCDateString;
+export declare const getUTCDateTime: typeof toUTCDateTimeString;
+export declare const TimeDiffHours: typeof diffHoursFromTimestamps;
+export declare const parseTime: typeof parseTimeToMilliseconds;
+export declare const formatTimeStr: typeof formatSecondsToHms;
+export declare const secondsToTime: typeof formatSecondsToHms;
+export declare const getWeekBounds: typeof getWeekRange;
 //# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,UAErC;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,UAMtD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,UAcvD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,SAAS,GAAE,MAAqB,GAAG,MAAM,CAYxF;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,GAAG,IAAI,KAAG,MAKhD,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,EACpG,MAAM,MAAM,EACZ,OAAO,MAAM,KACZ,WAAW,CAAC,CAAC,CAkBf,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,QAAQ,CAclE;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAclC;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAUlC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "izen-react-starter",
-  "version": "2.3.9",
+  "version": "2.4.0",
   "description": "A React component library with UI components, layout context, and data fetching",
   "type": "module",
   "main": "./dist/react-starter.umd.cjs",