@ubkinfotech/tecaher-erp 0.1.0 → 0.1.2

package/README.md

@@ -2,7 +2,9 @@
 
 Professional React Native Teacher ERP module package with a centralized `ERPProvider`.
 
-It lets you configure your API once and reuse production-ready teacher flows such as:
+It provides reusable teacher ERP screens with internal API handling, production-style UI flows, and a single place to configure authentication and base URLs.
+
+## Included Modules
 
 - `AssignmentScreen`
 - `AttendanceScreen`
@@ -19,10 +21,10 @@ It lets you configure your API once and reuse production-ready teacher flows suc
 
 - Centralized API configuration with `ERPProvider`
 - Supports `authToken` or async `getAuthToken()`
-- Automatic `Authorization` header attachment through Axios interceptors
-- Internal pagination and API management for list-based modules
-- Real screen flows for teacher ERP modules instead of JSON placeholders
-- Optional support for image picking, document picking, PDF viewing, and local file handling
+- Automatic `Authorization` header handling through the internal API client
+- Real teacher ERP flows instead of JSON placeholder screens
+- Internal pagination, refresh, and list management where applicable
+- Optional support for calendar, image picker, document picker, PDF preview, and local file viewing
 
 ## Installation
 
@@ -38,14 +40,14 @@ Install the required peer dependencies:
 npm i @tanstack/react-query react-native-safe-area-context
 ```
 
-Your app must already use compatible versions of:
+Your app should already use compatible versions of:
 
 - `react >= 18`
 - `react-native >= 0.75`
 
 ## Optional Native Prerequisites
 
-Some modules support file upload, image preview, document viewing, and PDF preview. Install these only if you need those features:
+Install these only if your selected modules need them:
 
 ```bash
 npm i react-native-calendars
@@ -57,20 +59,22 @@ npm i react-native-file-viewer
 npm i react-native-pdf
 ```
 
-## Module Prerequisite Matrix
-
-| Module | Required Props | Optional Native Packages |
-| --- | --- | --- |
-| `AssignmentScreen` | `sessionId` recommended | `react-native-document-picker`, `react-native-image-picker`, `react-native-image-viewing`, `react-native-fs`, `react-native-file-viewer`, `react-native-pdf` |
-| `AttendanceScreen` | `classId`, `sectionId`, `sessionId` recommended | `react-native-calendars` if your host app uses calendar-based date flows |
-| `LeaveRequestScreen` | none | `react-native-document-picker`, `react-native-image-picker` for attachments |
-| `MarksScreen` | `sessionId` recommended | none |
-| `MyAttendanceScreen` | `staffId`, `sessionId` recommended | none |
-| `NotesScreen` | `sessionId` recommended | `react-native-document-picker`, `react-native-image-picker`, `react-native-image-viewing`, `react-native-fs`, `react-native-file-viewer`, `react-native-pdf` |
-| `NoticeBoardScreen` | none | none |
-| `NotificationScreen` | none | none |
-| `PromoteStudentScreen` | `classId`, `sectionId` recommended | none |
-| `TimeTableScreen` | `staffId` + `sessionId` for teacher mode, or `classId` + `sectionId` + `sessionId` for class mode | none |
+## Module Requirements
+
+The current recommended usage is based on the live integration in `src/screens/TestNpm/Testnpm.jsx`.
+
+| Module | Current Usage | Notes | Optional Native Packages |
+| --- | --- | --- | --- |
+| `AssignmentScreen` | `sessionId` | Required in current integration | `react-native-document-picker`, `react-native-image-picker`, `react-native-image-viewing`, `react-native-fs`, `react-native-file-viewer`, `react-native-pdf` |
+| `AttendanceScreen` | `sessionId` | Class and section are managed internally in the screen | `react-native-calendars` |
+| `LeaveRequestScreen` | none | Fully managed internally | `react-native-document-picker`, `react-native-image-picker` |
+| `MarksScreen` | `sessionId` | Required in current integration | none |
+| `MyAttendanceScreen` | `staffId`, `sessionId` | Required in current integration | none |
+| `NotesScreen` | `sessionId` | Required in current integration | `react-native-document-picker`, `react-native-image-picker`, `react-native-image-viewing`, `react-native-fs`, `react-native-file-viewer`, `react-native-pdf` |
+| `NoticeBoardScreen` | none | Fully managed internally | none |
+| `NotificationScreen` | none | Fully managed internally | none |
+| `PromoteStudentScreen` | none | Source class and section are selected inside the screen | none |
+| `TimeTableScreen` | `staffId`, `sessionId` | Teacher mode in current integration | none |
 
 ## Provider Setup
 
@@ -140,25 +144,74 @@ export function ERPApp({children}: {children: React.ReactNode}) {
 | `onError` | `(error) => void` | no | Global API error callback |
 | `onUnauthorized` | `(error) => void` | no | Callback for unauthorized responses |
 
-## Basic Usage
+## Recommended App Integration
+
+This example matches the current `Testnpm.jsx` usage pattern.
 
 ```tsx
-import React from 'react';
-import AsyncStorage from '@react-native-async-storage/async-storage';
+import React, {useContext, useMemo, useState} from 'react';
+import {View, Text} from 'react-native';
+import {AuthContext} from '../context/AuthContext';
+import {UserContext} from '../context/UserContext';
 import {
   ERPProvider,
+  AssignmentScreen,
   AttendanceScreen,
+  LeaveRequestScreen,
+  MarksScreen,
+  MyAttendanceScreen,
+  NotesScreen,
+  NoticeBoardScreen,
+  NotificationScreen,
+  PromoteStudentScreen,
+  TimeTableScreen,
 } from '@ubkinfotech/tecaher-erp';
 
 const API_BASE_URL = 'https://example.com/';
+const API_DOWNLOAD_URL = 'https://example.com/uploads/';
+
+export function TeacherErpHost() {
+  const {authToken} = useContext(AuthContext);
+  const {user} = useContext(UserContext);
+  const [selected, setSelected] = useState('Attendance');
+
+  const sessionId = user?.session_id ?? 1;
+  const staffId = user?.id ?? 1;
+
+  const content = useMemo(() => {
+    switch (selected) {
+      case 'Assignment':
+        return <AssignmentScreen sessionId={sessionId} />;
+      case 'Attendance':
+        return <AttendanceScreen sessionId={sessionId} />;
+      case 'LeaveRequest':
+        return <LeaveRequestScreen />;
+      case 'Marks':
+        return <MarksScreen sessionId={sessionId} />;
+      case 'MyAttendance':
+        return <MyAttendanceScreen staffId={staffId} sessionId={sessionId} />;
+      case 'Notes':
+        return <NotesScreen sessionId={sessionId} />;
+      case 'Notice':
+        return <NoticeBoardScreen />;
+      case 'Notification':
+        return <NotificationScreen />;
+      case 'PromoteStudent':
+        return <PromoteStudentScreen />;
+      case 'TimeTable':
+        return <TimeTableScreen staffId={staffId} sessionId={sessionId} />;
+      default:
+        return <Text>Pick a module</Text>;
+    }
+  }, [selected, sessionId, staffId]);
 
-export function AppRoot() {
   return (
     <ERPProvider
       baseUrl={API_BASE_URL}
-      getAuthToken={() => AsyncStorage.getItem('token')}
+      fileBaseUrl={API_DOWNLOAD_URL}
+      authToken={authToken}
     >
-      <AttendanceScreen classId={1} sectionId={1} sessionId={1} />
+      <View style={{flex: 1}}>{content}</View>
     </ERPProvider>
   );
 }
@@ -195,14 +248,20 @@ import {ERPProvider, AssignmentScreen} from '@ubkinfotech/tecaher-erp';
 const API_BASE_URL = 'https://example.com/';
 const API_DOWNLOAD_URL = 'https://example.com/uploads/';
 
-export function AssignmentExample({authToken}: {authToken: string}) {
+export function AssignmentExample({
+  authToken,
+  sessionId,
+}: {
+  authToken: string;
+  sessionId: number;
+}) {
   return (
     <ERPProvider
       baseUrl={API_BASE_URL}
       fileBaseUrl={API_DOWNLOAD_URL}
       authToken={authToken}
     >
-      <AssignmentScreen sessionId={1} />
+      <AssignmentScreen sessionId={sessionId} />
     </ERPProvider>
   );
 }
@@ -210,7 +269,7 @@ export function AssignmentExample({authToken}: {authToken: string}) {
 
 ### AttendanceScreen
 
-Use this for teacher attendance take/view flow.
+Use this for teacher attendance take and view flow. In the current setup, only `sessionId` is passed from the host app.
 
 ```tsx
 import React from 'react';
@@ -218,10 +277,16 @@ import {ERPProvider, AttendanceScreen} from '@ubkinfotech/tecaher-erp';
 
 const API_BASE_URL = 'https://example.com/';
 
-export function AttendanceExample({authToken}: {authToken: string}) {
+export function AttendanceExample({
+  authToken,
+  sessionId,
+}: {
+  authToken: string;
+  sessionId: number;
+}) {
   return (
     <ERPProvider baseUrl={API_BASE_URL} authToken={authToken}>
-      <AttendanceScreen classId={1} sectionId={1} sessionId={1} />
+      <AttendanceScreen sessionId={sessionId} />
     </ERPProvider>
   );
 }
@@ -256,10 +321,16 @@ import {ERPProvider, MarksScreen} from '@ubkinfotech/tecaher-erp';
 
 const API_BASE_URL = 'https://example.com/';
 
-export function MarksExample({authToken}: {authToken: string}) {
+export function MarksExample({
+  authToken,
+  sessionId,
+}: {
+  authToken: string;
+  sessionId: number;
+}) {
   return (
     <ERPProvider baseUrl={API_BASE_URL} authToken={authToken}>
-      <MarksScreen sessionId={1} />
+      <MarksScreen sessionId={sessionId} />
     </ERPProvider>
   );
 }
@@ -267,7 +338,7 @@ export function MarksExample({authToken}: {authToken: string}) {
 
 ### MyAttendanceScreen
 
-Use this for teacher attendance summary and daily report.
+Use this for teacher attendance filters, summary cards, and daily report.
 
 ```tsx
 import React from 'react';
@@ -275,10 +346,18 @@ import {ERPProvider, MyAttendanceScreen} from '@ubkinfotech/tecaher-erp';
 
 const API_BASE_URL = 'https://example.com/';
 
-export function MyAttendanceExample({authToken}: {authToken: string}) {
+export function MyAttendanceExample({
+  authToken,
+  staffId,
+  sessionId,
+}: {
+  authToken: string;
+  staffId: number;
+  sessionId: number;
+}) {
   return (
     <ERPProvider baseUrl={API_BASE_URL} authToken={authToken}>
-      <MyAttendanceScreen staffId={12} sessionId={1} />
+      <MyAttendanceScreen staffId={staffId} sessionId={sessionId} />
     </ERPProvider>
   );
 }
@@ -286,7 +365,7 @@ export function MyAttendanceExample({authToken}: {authToken: string}) {
 
 ### NotesScreen
 
-Use this for note listing, note detail, create note, edit note, upload image/document, and preview flows.
+Use this for note listing, details, create, edit, upload, image preview, and PDF/document preview flows.
 
 ```tsx
 import React from 'react';
@@ -295,14 +374,20 @@ import {ERPProvider, NotesScreen} from '@ubkinfotech/tecaher-erp';
 const API_BASE_URL = 'https://example.com/';
 const API_DOWNLOAD_URL = 'https://example.com/uploads/';
 
-export function NotesExample({authToken}: {authToken: string}) {
+export function NotesExample({
+  authToken,
+  sessionId,
+}: {
+  authToken: string;
+  sessionId: number;
+}) {
   return (
     <ERPProvider
       baseUrl={API_BASE_URL}
       fileBaseUrl={API_DOWNLOAD_URL}
       authToken={authToken}
     >
-      <NotesScreen sessionId={1} />
+      <NotesScreen sessionId={sessionId} />
     </ERPProvider>
   );
 }
@@ -310,7 +395,7 @@ export function NotesExample({authToken}: {authToken: string}) {
 
 ### NoticeBoardScreen
 
-Use this for notice board list and notice detail view.
+Use this for notice board list and notice details.
 
 ```tsx
 import React from 'react';
@@ -329,7 +414,7 @@ export function NoticeBoardExample({authToken}: {authToken: string}) {
 
 ### NotificationScreen
 
-Use this for notification list with built-in pagination and refresh.
+Use this for notification listing with built-in pagination and refresh.
 
 ```tsx
 import React from 'react';
@@ -348,7 +433,7 @@ export function NotificationExample({authToken}: {authToken: string}) {
 
 ### PromoteStudentScreen
 
-Use this for search, destination selection, and student promotion submission flow.
+Use this for student search, destination selection, and promotion submission. In the current setup, class and section are selected inside the screen.
 
 ```tsx
 import React from 'react';
@@ -359,7 +444,7 @@ const API_BASE_URL = 'https://example.com/';
 export function PromoteStudentExample({authToken}: {authToken: string}) {
   return (
     <ERPProvider baseUrl={API_BASE_URL} authToken={authToken}>
-      <PromoteStudentScreen classId={1} sectionId={1} />
+      <PromoteStudentScreen />
     </ERPProvider>
   );
 }
@@ -367,7 +452,7 @@ export function PromoteStudentExample({authToken}: {authToken: string}) {
 
 ### TimeTableScreen
 
-Teacher mode:
+The current host integration uses teacher mode with `staffId` and `sessionId`.
 
 ```tsx
 import React from 'react';
@@ -375,27 +460,18 @@ import {ERPProvider, TimeTableScreen} from '@ubkinfotech/tecaher-erp';
 
 const API_BASE_URL = 'https://example.com/';
 
-export function TeacherTimeTableExample({authToken}: {authToken: string}) {
-  return (
-    <ERPProvider baseUrl={API_BASE_URL} authToken={authToken}>
-      <TimeTableScreen staffId={12} sessionId={1} />
-    </ERPProvider>
-  );
-}
-```
-
-Class mode:
-
-```tsx
-import React from 'react';
-import {ERPProvider, TimeTableScreen} from '@ubkinfotech/tecaher-erp';
-
-const API_BASE_URL = 'https://example.com/';
-
-export function ClassTimeTableExample({authToken}: {authToken: string}) {
+export function TeacherTimeTableExample({
+  authToken,
+  staffId,
+  sessionId,
+}: {
+  authToken: string;
+  staffId: number;
+  sessionId: number;
+}) {
   return (
     <ERPProvider baseUrl={API_BASE_URL} authToken={authToken}>
-      <TimeTableScreen classId={1} sectionId={1} sessionId={1} />
+      <TimeTableScreen staffId={staffId} sessionId={sessionId} />
     </ERPProvider>
   );
 }
@@ -404,9 +480,9 @@ export function ClassTimeTableExample({authToken}: {authToken: string}) {
 ## Notes
 
 - The published package name is intentionally `@ubkinfotech/tecaher-erp`.
-- `fileBaseUrl` is strongly recommended for modules that render attachments, documents, and images.
-- Most list modules internally manage pagination, refresh, and API calls.
-- Use `sessionId`, `staffId`, `classId`, and `sectionId` from your authenticated user/session context whenever possible.
+- `fileBaseUrl` is strongly recommended for modules that render attachments, images, and documents.
+- `NoticeBoardScreen`, `NotificationScreen`, `LeaveRequestScreen`, and `PromoteStudentScreen` are currently used without extra module props in the host app.
+- `AssignmentScreen`, `AttendanceScreen`, `MarksScreen`, `MyAttendanceScreen`, `NotesScreen`, and `TimeTableScreen` still use authenticated session or staff values in the current integration.
 
 ## License
 

package/lib/commonjs/core/api/endpoints.js

@@ -95,7 +95,7 @@ const endpoints = exports.endpoints = {
       return `staff/teacherAPP/attendenceSection/getsectionDropdownforTeacher?class_id=${args.classId}`;
     },
     teacherSubjectsByClass: args => {
-      return `staff/teacherAPP/StaffHomework/getsubjectDropdownByClass?class_id=${args.classId}&session_id=${args.sessionId}`;
+      return `staff/teacherAPP/teacherbasicDetails/getteacherSubjectsaccordingtoClass?session_id=${args.sessionId}&class_id=${args.classId}`;
     },
     details: args => {
       return `staff/teacherAPP/Notes/getNotedatabyID?id=${args.noteId}`;

package/lib/commonjs/core/auth/authContext.js

@@ -7,8 +7,7 @@ exports.AuthContext = void 0;
 exports.AuthProvider = AuthProvider;
 var _react = _interopRequireWildcard(require("react"));
 var _jsxRuntime = require("react/jsx-runtime");
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 const AuthContext = exports.AuthContext = /*#__PURE__*/(0, _react.createContext)(null);
 function AuthProvider({
   children

package/lib/commonjs/core/provider/ERPProvider.js

@@ -9,8 +9,7 @@ var _react = _interopRequireWildcard(require("react"));
 var _reactQuery = require("@tanstack/react-query");
 var _apiClient = require("../api/apiClient");
 var _jsxRuntime = require("react/jsx-runtime");
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 const ERPContext = exports.ERPContext = /*#__PURE__*/(0, _react.createContext)(null);
 function ERPProvider(props) {
   const queryClient = (0, _react.useMemo)(() => {