ubk.erp.webpack 1.4.3 → 1.4.4

package/README.md

@@ -562,15 +562,22 @@ const LibraryPage = ({ token }) => {
 import { AddStaff } from "ubk.erp.webpack";
 
 const AddStaffPage = ({ token }) => {
+  const handleStepComplete = (payload) => {
+    // Fires after Basic, Experience and Payroll each save successfully
+    console.log("Step saved:", payload.step, payload.staffId, payload.data);
+  };
+
   const handleFinished = (rec) => {
-    // Optionally refresh staff list or show a notification
-    console.log("Staff created successfully",rec);
+    // Fires once, after the final (Payroll) step saves
+    console.log("Staff created successfully", rec.staffId, rec);
   };
 
-  return <AddStaff token={token} onFinished={handleFinished} />;
+  return <AddStaff token={token} onStepComplete={handleStepComplete} onFinished={handleFinished} />;
 };
 ```
 
+`AddStaff` accepts the same callbacks as `StaffWizard` (`onStepComplete`, `onReturn`, `onFinished`) — see **StaffWizard — Return Callback** below. `onFinished` is only called after all three steps are saved.
+
 ### Store
 
 | Component | Description |
@@ -617,6 +624,7 @@ const AddStaffPage = ({ token }) => {
 | `onNavigate` | `(action: string, record: object) => void` | No | Called when the Edit button is clicked. Receives `("staff-edit", record)`. If provided, the parent handles navigation. |
 | `onFinished` | `(res: any) => void` | No | Called after the wizard (edit drawer) completes successfully. |
 | `onDelete` | `(payload: DeletePayload) => void` | No | Called after a staff member is deactivated. |
+| `onPasswordChange` | `(payload: PasswordChangePayload) => void` | No | Called after a staff member's password is changed successfully. Receives `{ id, password, record, response }` — `password` is the new password as entered, `response` is the API response from `updateStaffPassword`. |
 
 ## DeletePayload Shape
 
@@ -632,6 +640,7 @@ const AddStaffPage = ({ token }) => {
 
 - Clicking the **Edit** button: if `onNavigate` is provided, it calls `onNavigate("staff-edit", record)`. Otherwise, opens an inline edit drawer with `StaffWizard` in `mode="edit"`.
 - Clicking **Delete/Deactivate**: sends a deactivate request to the API. On success, refreshes the list and calls `onDelete({ id, record, response })`.
+- Clicking **Change password** (key icon): opens a modal with New Password + Confirm Password. On save it posts `{ staff_id, new_passwod }` to `api/branchapi/staff/updateStaffPassword` (override with `VITE_HR_STAFF_CHANGE_PASSWORD_URL`), then calls `onPasswordChange({ id, password, record, response })`.
 - `onFinished` fires after the edit wizard completes successfully, allowing the parent to refresh its own data.
 
 ## Usage
@@ -674,24 +683,26 @@ const StaffPage = ({ token }) => {
 | `mode` | `'add' \| 'edit'` | No | Determines whether basic info is edited or created. Default: `"add"`. |
 | `staffId` | `string` | No | Staff ID when editing; ignored when `mode="add"`. |
 | `onStepComplete` | `(payload: object) => void` | No | Called after **every** step's successful save. |
-| `onFinished` | `() => void` | No | Called after the final (Payroll) step completes. |
+| `onReturn` | `(payload: object) => void` | No | Alias of `onStepComplete` — receives the same payload. |
+| `onFinished` | `(result: object) => void` | No | Called after the final (Payroll) step completes. Receives `{ staffId, payroll, result, data }`. |
 
 ## Payload Shape
 
-The `onStepComplete` callback receives an object:
+The `onStepComplete` / `onReturn` callback receives an object:
 
 ```ts
 {
   step: "basic" | "experience" | "payroll";
-  data?: object;   // Step-specific data
+  staffId: string | number | null; // id of the staff being created/edited
+  data: object;                    // Step-specific data (below)
 }
 ```
 
 | Step | `data` contents |
 | :--- | :--- |
-| `"basic"` | `{ staffId, basic }` from Step1's `onSubmitted` |
-| `"experience"` | `{ experience, result }` from Step2's `onSubmitted` |
-| `"payroll"` | `{ payroll, result }` from Step3's `onSubmitted` |
+| `"basic"` | `{ staffId, basic, data }` from Step1 (`data` = raw API response) |
+| `"experience"` | `{ experience, result, data }` from Step2 |
+| `"payroll"` | `{ payroll, result, data }` from Step3 |
 
 ## Behavior
 

package/dist/Layout/HumanResource/AddStaff/AddStaff.d.ts

@@ -1,7 +1,8 @@
 import { default as React } from 'react';
 export default AddStaff;
-declare function AddStaff({ token, onFinished, onReturn }: {
+declare function AddStaff({ token, onStepComplete, onFinished, onReturn }: {
     token: any;
+    onStepComplete: any;
     onFinished: any;
     onReturn: any;
 }): React.JSX.Element;

package/dist/Layout/HumanResource/AddStaff/Pages/AddStaffPage.d.ts

@@ -1,7 +1,8 @@
 import { default as React } from 'react';
 export default AddStaffPage;
-declare function AddStaffPage({ token, onFinished, onReturn }: {
+declare function AddStaffPage({ token, onStepComplete, onFinished, onReturn }: {
     token: any;
+    onStepComplete: any;
     onFinished: any;
     onReturn: any;
 }): React.JSX.Element;

package/dist/Layout/HumanResource/AddStaff/Services/addStaffService.d.ts

@@ -3,6 +3,7 @@ export const addStaffEndpoints: {
     searchByRole: any;
     searchByKeywords: any;
     deactivate: any;
+    changePassword: any;
     basicById: any;
     experienceById: any;
     payrollById: any;

package/dist/Layout/HumanResource/Services/humanResourceService.d.ts

@@ -6,6 +6,7 @@ export namespace endpoints {
         let searchByRole: any;
         let searchByKeywords: any;
         let deactivate: any;
+        let changePassword: any;
         let basicById: any;
         let experienceById: any;
         let payrollById: any;

package/dist/Layout/HumanResource/StaffDirectory/Pages/StaffDirectoryPage.d.ts

@@ -1,8 +1,9 @@
 import { default as React } from 'react';
 export default StaffDirectoryPage;
-declare function StaffDirectoryPage({ token, onNavigate, onFinished, onDelete, }: {
+declare function StaffDirectoryPage({ token, onNavigate, onFinished, onDelete, onPasswordChange, }: {
     token: any;
     onNavigate: any;
     onFinished: any;
     onDelete: any;
+    onPasswordChange: any;
 }): React.JSX.Element;

package/dist/Layout/HumanResource/StaffDirectory/Services/staffDirectoryService.d.ts

@@ -3,6 +3,7 @@ export const staffEndpoints: {
     searchByRole: any;
     searchByKeywords: any;
     deactivate: any;
+    changePassword: any;
     basicById: any;
     experienceById: any;
     payrollById: any;

package/dist/Layout/HumanResource/StaffDirectory/StaffDirectory.d.ts

@@ -1,8 +1,9 @@
 import { default as React } from 'react';
 export default StaffDirectory;
-declare function StaffDirectory({ token, onNavigate, onFinished, onDelete }: {
+declare function StaffDirectory({ token, onNavigate, onFinished, onDelete, onPasswordChange }: {
     token: any;
     onNavigate: any;
     onFinished: any;
     onDelete: any;
+    onPasswordChange: any;
 }): React.JSX.Element;

package/dist/Layout/HumanResource/StaffWizard/StaffWizard.d.ts

@@ -1,9 +1,10 @@
 import { default as React } from 'react';
 export default StaffWizard;
-declare function StaffWizard({ token, mode, staffId: staffIdProp, onStepComplete, onFinished, }: {
+declare function StaffWizard({ token, mode, staffId: staffIdProp, onStepComplete, onFinished, onReturn, }: {
     token: any;
     mode?: string | undefined;
     staffId: any;
     onStepComplete: any;
     onFinished: any;
+    onReturn: any;
 }): React.JSX.Element;