ui-soxo-bootstrap-core 2.4.25-dev.8 → 2.4.25

package/README.md

@@ -1,260 +0,0 @@
-# 📦 NPM Release Workflow — Task-Based Development → Develop → Master
-
-This guide describes the complete workflow for publishing **task-based development builds** and **stable releases** using GitHub Actions, Git tags, and npm versioning.
-
-Incorrect versioning or incorrect tags will break the publish pipeline — follow the process exactly.
-
----
-
-# 📘 Table of Contents
-- Overview
-- Branch Strategy
-- Task Branch Workflow
-- Versioning Rules
-- Development Release Workflow (`develop`)
-- Promotion Workflow (Dev → Master)
-- Publishing via GitHub Release UI
-- How GitHub Action Detects Release Type
-- Summary Table
-- Common Mistakes & Fixes
-
----
-
-# 🧩 Overview
-
-We maintain two release channels:
-
-| Channel              | Branch   | Tag              | Purpose               |
-|---------------------|----------|------------------|-----------------------|
-| Stable (`latest`)   | master   | `vX.Y.Z`         | Production release    |
-| Development (`dev`) | develop  | `vX.Y.Z-dev.N`   | QA/internal testing   |
-
-Releases are triggered using Git tags:
-
-```
-npm version
-```
-
----
-
-# 🌿 Branch Strategy
-
-## `master`
-- Production-ready code  
-- Publishes **stable** builds  
-- Versions never include a `dev` suffix  
-
-## `develop`
-- Used for QA/internal testing  
-- Publishes **development** builds  
-- Versions always include `-dev.N`  
-
-## Task Branches
-- Create from `master`  
-- Naming: `task/<JIRA-ID>-<description>`  
-- After completing work, merge into `develop`  
-
----
-
-# 🏗️ Task Branch Workflow
-
-### 1. Create a task branch
-```bash
-git checkout master
-git pull origin master
-git checkout -b task/<JIRA-ID>-<description>
-```
-
-### 2. Work on the task
-```bash
-git add .
-git commit -m "TASK-123: Implement XYZ"
-```
-
-### 3. Merge into develop
-```bash
-git checkout develop
-git pull origin develop
-git merge task/<JIRA-ID>-<description>
-```
-
----
-
-# 🔧 Versioning Rules
-
-## Development Versions
-```
-X.Y.Z-dev.N
-```
-Example:
-```
-2.4.30-dev.0
-```
-
-## Stable Versions
-```
-X.Y.Z
-```
-
-## Rules
-- Each version must be unique  
-- Dev versions do **not** convert into stable versions  
-- Git tag must exactly match `package.json` version  
-
----
-
-# 🟦 Development Release Workflow (`develop`)
-
-### 1. Switch to develop
-```bash
-git checkout develop
-git pull origin develop
-```
-
-### 2. Create a new development version
-```bash
-npm version prerelease --preid=dev
-```
-
-### 3. Push commit + tag
-```bash
-git push --follow-tags
-```
-
-### 4. GitHub Action publishes dev build
-```
-npm publish --tag dev
-```
-
-### 5. Install the dev build
-```bash
-npm install soxo-bootstrap-core@dev
-```
-
----
-
-# 🟩 Promotion Workflow (Dev → Master)
-
-### 1. Switch to master
-```bash
-git checkout master
-git pull origin master
-```
-
-### 2. Merge develop into master
-```bash
-git merge develop
-```
-
-### 3. Bump the stable version
-```bash
-npm version patch
-# or
-npm version minor
-# or
-npm version major
-```
-
-### 4. Push with tags
-```bash
-git push --follow-tags
-```
-
-### 5. GitHub Action publishes stable build
-```
-npm publish
-```
-
-### 6. Install stable version
-```bash
-npm install soxo-bootstrap-core
-# or
-npm install soxo-bootstrap-core@<version>
-```
-
----
-
-# 🟧 Publishing via GitHub Release UI
-
-### Important
-**The tag must match the `package.json` version exactly**, including the `v` prefix.
-
-Example:
-```
-package.json: "version": "2.4.31-dev.0"
-GitHub Tag:  v2.4.31-dev.0
-```
-
----
-
-## Steps
-
-### 1. Ensure `develop` branch is up to date  
-Push your changes.
-
-### 2. Ensure version contains a dev suffix  
-If not:
-```bash
-npm version prerelease --preid=dev
-git push --follow-tags
-```
-
-### 3. Open GitHub → Releases → Draft a new release
-
-### 4. Create tag matching the version  
-Example:
-```
-v2.4.31-dev.0
-```
-
-### 5. Select target branch = `develop`
-
-### 6. Title = tag version  
-Description is optional.
-
-### 7. Publish the release  
-Triggers:
-```
-npm publish --tag dev
-```
-
----
-
-# ⚙️ How GitHub Action Detects Release Type
-
-If version contains `dev`:
-```
-npm publish --tag dev
-```
-
-Otherwise:
-```
-npm publish
-```
-
----
-
-# 📊 Summary Table
-
-| Step                     | Branch   | Command                                 | Tag              | Publish Type |
-|--------------------------|----------|------------------------------------------|------------------|--------------|
-| Create task branch       | master   | `git checkout -b task/<ID>`              | —                | —            |
-| Merge task → develop     | develop  | `git merge task/<ID>`                    | —                | —            |
-| Dev version              | develop  | `npm version prerelease --preid=dev`     | `vX.Y.Z-dev.N`   | dev          |
-| Publish dev build        | develop  | `git push --follow-tags`                 | —                | dev          |
-| Merge develop → master   | master   | `git merge develop`                      | —                | —            |
-| Stable version           | master   | `npm version patch/minor/major`          | `vX.Y.Z`         | latest       |
-| Publish stable build     | master   | `git push --follow-tags`                 | —                | latest       |
-
----
-
-# ⚠️ Common Mistakes & Fixes
-
-| Mistake                        | Issue                | Fix                             |
-|-------------------------------|----------------------|---------------------------------|
-| Tag doesn't match version     | Publish fails        | Always use `npm version`         |
-| Manual tag creation           | Version mismatch     | Avoid manual tagging             |
-| Dev publish from master       | Wrong channel        | Verify branch before tagging     |
-| Not pushing tags              | Workflow won’t run   | Use `git push --follow-tags`     |
-| Merging incomplete tasks      | Breaks dev builds    | Test before merging              |
-

package/core/lib/hooks/use-otp-timer.js

@@ -1,99 +0,0 @@
-import { useState, useEffect, useRef } from 'react';
-
-/**
- * Custom hook to manage an OTP (One-Time Password) countdown timer.
- *
- * Features:
- * - Can start a timer directly with seconds.
- * - Can start a timer using an expiry timestamp (from backend).
- * - Provides formatted remaining time (MM:SS).
- * - Tracks whether the timer has expired.
- *
- * @returns {Object} API
- * @returns {number} API.remaining - Remaining seconds.
- * @returns {boolean} API.expired - Whether the timer has expired.
- * @returns {string} API.formatted - Formatted remaining time (MM:SS).
- * @returns {(seconds: number) => void} API.start - Start timer with seconds.
- * @returns {(expirytime: string) => void} API.startFromExpiry - Start timer using expiry string (e.g. "2025-09-04T12:13:09.000Z").
- *
- * @example
- * const { remaining, expired, formatted, start, startFromExpiry } = useOtpTimer();
- *
- * // Start with 30 seconds
- * useEffect(() => {
- *   start(30);
- * }, []);
- *
- * // OR start from backend expiry timestamp
- * useEffect(() => {
- *   startFromExpiry("2025-09-04T12:13:09.000Z");
- * }, []);
- *
- * return (
- *   <div>
- *     <p>Time left: {formatted}</p>
- *     {expired && <p>OTP expired!</p>}
- *   </div>
- * );
- */
-
-// helper to format time
-const formatTime = (seconds) => {
-  const minutes = Math.floor((seconds % 3600) / 60);
-  const secs = seconds % 60;
-  return `${String(minutes).padStart(2, '0')}:${String(secs).padStart(2, '0')}`;
-};
-
-export const useOtpTimer = () => {
-  const [remaining, setRemaining] = useState(0);
-  const [expired, setExpired] = useState(false);
-  const intervalRef = useRef(null);
-
-  // Start timer by passing expiry string from backend
-  const startFromExpiry = (expirytime) => {
-    if (!expirytime) {
-      setRemaining(0);
-      setExpired(true);
-      return;
-    }
-
-    // Handle backend expiry string
-    const expiryTime = new Date(expirytime).getTime();
-    const now = Date.now();
-    const seconds = Math.max(0, Math.floor((expiryTime - now) / 1000));
-
-    start(seconds);
-  };
-
-  // Generic start (seconds)
-  const start = (seconds) => {
-    clearInterval(intervalRef.current);
-
-    if (!seconds || seconds <= 0) {
-      setRemaining(0);
-      setExpired(true);
-      return;
-    }
-
-    setRemaining(seconds);
-    setExpired(false);
-
-    intervalRef.current = setInterval(() => {
-      setRemaining((prev) => {
-        if (prev <= 1) {
-          clearInterval(intervalRef.current);
-          setExpired(true);
-          return 0;
-        }
-        return prev - 1;
-      });
-    }, 1000);
-  };
-
-  // Cleanup on unmount
-  useEffect(() => {
-    return () => clearInterval(intervalRef.current);
-  }, []);
-
-  return { remaining, expired, formatted: formatTime(remaining), start, startFromExpiry };
-};

package/core/models/staff/components/staff-add/staff-add.js

@@ -1,352 +0,0 @@
-import React, { useState, useEffect, useRef } from 'react';
-import './staff-add.scss';
-import { Modal, Tabs, Input, Form, Row, Col, message, Checkbox, Select } from 'antd';
-import { useTranslation, Button } from './../../../../lib/';
-import { UsersAPI } from '../../..';
-
-const StaffAdd = ({ visible, onCancel, staffId, staffData, onSuccess }) => {
-  const [form] = Form.useForm();
-  const { t } = useTranslation();
-
-  /** -------------------------------
-   *  STATE
-   * ------------------------------- */
-  const [loading, setLoading] = useState(false);
-  const [designations, setDesignations] = useState([]);
-  const [isSubmitDisabled, setIsSubmitDisabled] = useState(true);
-  const [codeStatus, setCodeStatus] = useState({ status: '', message: '' });
-
-  const nameInputRef = useRef(null);
-
-  const editMode = Boolean(staffId);
-
-  /** -------------------------------
-   *  FORM WATCHERS
-   * ------------------------------- */
-  const watchedName = Form.useWatch('shortName', form);
-  const watchedCode = Form.useWatch('id', form);
-  const watchedDesc = Form.useWatch('description', form);
-
-  /** -------------------------------
-   *  EFFECTS
-   * ------------------------------- */
-
-  // Auto-focus on open
-  useEffect(() => {
-    if (visible) {
-      setTimeout(() => nameInputRef.current?.focus(), 200);
-    }
-  }, [visible]);
-
-  // Control submit button
-  useEffect(() => {
-    setIsSubmitDisabled(!(watchedName && watchedCode && watchedDesc));
-  }, [watchedName, watchedCode, watchedDesc]);
-
-  // Load designations when modal opens
-  useEffect(() => {
-    if (visible) getDesignations();
-  }, [visible]);
-
-  // Reset or fill edit form
-  useEffect(() => {
-    if (visible) {
-      if (editMode && staffData) fillEditForm(staffData);
-    } else {
-      form.resetFields();
-    }
-  }, [visible]);
-
-  /** -------------------------------
-   *  API CALL – Designations
-   * ------------------------------- */
-  const getDesignations = () => {
-    setLoading(true);
-    UsersAPI.getDesignations()
-      .then((res) => {
-        if (res?.success && Array.isArray(res.result)) {
-          const formatted = res.result.map((ele) => ({
-            label: ele.dg_desc?.trim() || '',
-            value: ele.dg_code,
-          }));
-          setDesignations(formatted);
-        } else {
-          setDesignations([]);
-        }
-      })
-      .catch((err) => {
-        console.error('Error fetching designations:', err);
-        setDesignations([]);
-      })
-      .finally(() => setLoading(false));
-  };
-
-  /** -------------------------------
-   *  VALIDATION – Code
-   * ------------------------------- */
-  const validateDoctorCode = async (_, value) => {
-    if (editMode) return Promise.resolve(); // Skip validation if editing
-
-    if (!value) {
-      setCodeStatus({ status: '', message: '' });
-      return Promise.resolve();
-    }
-
-    try {
-      const res = await UsersAPI.getStaffCode(value);
-
-      if (res?.status === 409 || res?.success === false) {
-        setCodeStatus({ status: 'error', message: res.message || 'Code already exists' });
-        return Promise.reject(new Error(res.message || 'Code already exists'));
-      }
-
-      if (res?.status === 200 && res?.success === true) {
-        setCodeStatus({
-          status: 'success',
-          message: 'The entered code is valid for assigning a staff.',
-        });
-        return Promise.resolve();
-      }
-
-      setCodeStatus({ status: 'error', message: 'Unexpected response' });
-      return Promise.reject(new Error('Unexpected response'));
-    } catch {
-      setCodeStatus({ status: 'error', message: 'Validation failed' });
-      return Promise.reject(new Error('Validation failed'));
-    }
-  };
-
-  /** -------------------------------
-   *  UTIL – Enter Key Navigation
-   * ------------------------------- */
-  const handleEnterKey = (e) => {
-    if (e.key === 'Enter') {
-      e.preventDefault();
-      const fields = Array.from(document.querySelectorAll('.ant-input'));
-      const index = fields.indexOf(e.target);
-      if (index > -1 && index < fields.length - 1) {
-        fields[index + 1].focus();
-      }
-    }
-  };
-
-  /** -------------------------------
-   *  FORM FILL – Edit Mode
-   * ------------------------------- */
-  const fillEditForm = (data) => {
-    form.setFieldsValue({
-      id: data.id,
-      shortName: data.shortName,
-      description: data.description,
-      designation: data.designationPtr,
-      phone1: data.phone,
-      phone2: data.mobile || data.alternateMobile,
-      email1: data.email,
-      email2: data.alternateEmail,
-      slno: data.slNo,
-      active: data.active === 'Y' ? 'Y' : 'N',
-      remarks: data.remarks,
-      address1: data.address1,
-      address2: data.address2,
-      place: data.place,
-      zip: data.zip,
-    });
-  };
-
-  /** -------------------------------
-   *  SUBMIT HANDLER
-   * ------------------------------- */
-  const handleFinish = async (values) => {
-    setLoading(true);
-
-    const payload = {
-      id: values.id,
-      shortName: values.shortName,
-      description: values.description,
-      designationPtr: values.designation,
-      phone: values.phone1,
-      mobile: values.phone2,
-      alternateMobile: values.phone2,
-      email: values.email1,
-      alternateEmail: values.email2,
-      remarks: values.remarks,
-      slNo: values.slno ? Number(values.slno) : null,
-      active: values.active === 'Y' ? 'Y' : 'N',
-      address1: values.address1,
-      address2: values.address2,
-      place: values.place,
-      zip: values.zip,
-    };
-
-    try {
-      const res = editMode ? await UsersAPI.updateStaff(payload, staffData.id) : await UsersAPI.createStaff(payload);
-
-      if (res?.success) {
-        message.success(editMode ? 'Staff updated successfully' : 'Staff created successfully');
-        onSuccess?.();
-        onCancel();
-      } else {
-        message.error(res?.message || 'Operation failed');
-      }
-    } catch {
-      message.error('Something went wrong');
-    } finally {
-      setLoading(false);
-    }
-  };
-
-  /** -------------------------------
-   *  RENDER
-   * ------------------------------- */
-  return (
-    <Modal
-      title={editMode ? 'Edit Staff' : 'Add Staff'}
-      open={visible}
-      onCancel={onCancel}
-      width={950}
-      footer={null}
-      destroyOnClose
-      style={{ top: 10 }}
-    >
-      <Form form={form} layout="vertical" onFinish={handleFinish}>
-        {/* TOP SECTION */}
-        <Row gutter={16}>
-          <Col span={6}>
-            <Form.Item
-              label="Code"
-              name="id"
-              validateTrigger="onChange"
-              hasFeedback={!editMode}
-              rules={[{ required: true }, { validator: validateDoctorCode }]}
-            >
-              <Input placeholder="Enter Code" ref={nameInputRef} onKeyDown={handleEnterKey} disabled={editMode} />
-            </Form.Item>
-          </Col>
-
-          <Col span={6}>
-            <Form.Item label="Name" name="shortName" rules={[{ required: true }]}>
-              <Input placeholder="Enter Name" onKeyDown={handleEnterKey} />
-            </Form.Item>
-          </Col>
-
-          <Col span={12}>
-            <Form.Item label="Description" name="description" rules={[{ required: true }]}>
-              <Input placeholder="Enter Description" onKeyDown={handleEnterKey} />
-            </Form.Item>
-          </Col>
-        </Row>
-
-        <Tabs defaultActiveKey="1">
-          {/* GENERAL TAB */}
-          <Tabs.TabPane tab="GENERAL" key="1">
-            <Row gutter={16}>
-              <Col span={6}>
-                <Form.Item label="Phone Number 1" name="phone1">
-                  <Input maxLength={10} placeholder="Enter Phone Number" onKeyDown={handleEnterKey} />
-                </Form.Item>
-              </Col>
-
-              <Col span={6}>
-                <Form.Item label="Phone Number 2" name="phone2">
-                  <Input maxLength={10} placeholder="Enter Phone Number" onKeyDown={handleEnterKey} />
-                </Form.Item>
-              </Col>
-
-              <Col span={6}>
-                <Form.Item label="Email ID 1" name="email1">
-                  <Input placeholder="Enter Email" onKeyDown={handleEnterKey} />
-                </Form.Item>
-              </Col>
-
-              <Col span={6}>
-                <Form.Item label="Email ID 2" name="email2">
-                  <Input placeholder="Enter Email" onKeyDown={handleEnterKey} />
-                </Form.Item>
-              </Col>
-            </Row>
-
-            <Row gutter={16}>
-              <Col span={8}>
-                <Form.Item name="designation" label="Designation">
-                  <Select placeholder="Select Designation" options={designations} allowClear showSearch optionFilterProp="label" />
-                </Form.Item>
-              </Col>
-
-              <Col span={8}>
-                <Form.Item label="Serial Number" name="slno">
-                  <Input placeholder="Enter Serial Number" onKeyDown={handleEnterKey} />
-                </Form.Item>
-              </Col>
-
-              <Col span={8}>
-                <div style={{ display: 'flex', alignItems: 'center', gap: 10, marginTop: 30 }}>
-                  <label>Active</label>
-                  <Form.Item
-                    name="active"
-                    valuePropName="checked"
-                    getValueFromEvent={(e) => (e.target.checked ? 'Y' : 'N')}
-                    getValueProps={(value) => ({ checked: value === 'Y' })}
-                    style={{ marginBottom: 0 }}
-                  >
-                    <Checkbox />
-                  </Form.Item>
-                </div>
-              </Col>
-            </Row>
-
-            <Row>
-              <Col span={24}>
-                <Form.Item label="Remarks" name="remarks">
-                  <Input placeholder="Enter Remarks" onKeyDown={handleEnterKey} />
-                </Form.Item>
-              </Col>
-            </Row>
-          </Tabs.TabPane>
-
-          {/* ADDRESS TAB */}
-          <Tabs.TabPane tab="ADDRESS" key="2">
-            <Row gutter={16}>
-              <Col span={12}>
-                <Form.Item label="Address Line 1" name="address1">
-                  <Input placeholder="Enter Address" onKeyDown={handleEnterKey} />
-                </Form.Item>
-              </Col>
-
-              <Col span={12}>
-                <Form.Item label="Address Line 2" name="address2">
-                  <Input placeholder="Enter Address" onKeyDown={handleEnterKey} />
-                </Form.Item>
-              </Col>
-            </Row>
-
-            <Row gutter={16}>
-              <Col span={12}>
-                <Form.Item label="Place" name="place">
-                  <Input placeholder="Enter Place" onKeyDown={handleEnterKey} />
-                </Form.Item>
-              </Col>
-
-              <Col span={12}>
-                <Form.Item label="Zip Code" name="zip">
-                  <Input placeholder="Enter Zip Code" maxLength={7} onKeyDown={handleEnterKey} />
-                </Form.Item>
-              </Col>
-            </Row>
-          </Tabs.TabPane>
-        </Tabs>
-
-        {/* FOOTER BUTTONS */}
-        <div style={{ display: 'flex', justifyContent: 'flex-end', gap: 10 }}>
-          <Button onClick={onCancel} type="secondary">
-            Cancel
-          </Button>
-          <Button type="primary" htmlType="submit" loading={loading} disabled={isSubmitDisabled}>
-            {editMode ? 'Update' : 'Save'}
-          </Button>
-        </div>
-      </Form>
-    </Modal>
-  );
-};
-
-export default StaffAdd;