@react-pakistan/util-functions 3.0.1 → 3.0.3

package/edu-pilot-pro/calculate-student-fee-fine.d.mts

@@ -0,0 +1,27 @@
+/**
+ * Calculates the late fine for a student fee based on payment delay.
+ *
+ * Rules:
+ * - Returns 0 if the fee status is `CANCELLED` or `REFUNDED`.
+ * - Returns the existing `fee.fine` value if it is set and greater than 0.
+ * - Returns 0 if `perDateRate` ≤ 0 or `fee.amountDue` ≤ 0.
+ * - When payment is in the same calendar month as the due date, fine days = payment day - dueDateLength.
+ * - When payment crosses into a later month, fine days = days from the 1st of the due month to the last day of the month before payment.
+ * - Fine amount = fineDays × perDateRate × (amountDue / amount), rounded to 2 decimal places.
+ *
+ * @param fee - The fee object containing amount, amountDue, dueDate, optional fine and paidAt, and status
+ * @param dueDateLength - The day of the month after which a fine starts accruing (e.g. 10 means fine starts on the 11th)
+ * @param perDateRate - The fine rate per day
+ * @param asOf - Optional reference date used when paidAt is not provided (defaults to current date)
+ * @returns The calculated fine amount rounded to 2 decimal places
+ */
+declare function calculateStudentFeeFine(fee: {
+    amount: number;
+    amountDue: number;
+    dueDate: Date;
+    fine?: number | null;
+    paidAt?: Date | null;
+    status: string;
+}, dueDateLength: number, perDateRate: number, asOf?: Date): number;
+
+export { calculateStudentFeeFine };

package/edu-pilot-pro/calculate-student-fee-fine.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Calculates the late fine for a student fee based on payment delay.
+ *
+ * Rules:
+ * - Returns 0 if the fee status is `CANCELLED` or `REFUNDED`.
+ * - Returns the existing `fee.fine` value if it is set and greater than 0.
+ * - Returns 0 if `perDateRate` ≤ 0 or `fee.amountDue` ≤ 0.
+ * - When payment is in the same calendar month as the due date, fine days = payment day - dueDateLength.
+ * - When payment crosses into a later month, fine days = days from the 1st of the due month to the last day of the month before payment.
+ * - Fine amount = fineDays × perDateRate × (amountDue / amount), rounded to 2 decimal places.
+ *
+ * @param fee - The fee object containing amount, amountDue, dueDate, optional fine and paidAt, and status
+ * @param dueDateLength - The day of the month after which a fine starts accruing (e.g. 10 means fine starts on the 11th)
+ * @param perDateRate - The fine rate per day
+ * @param asOf - Optional reference date used when paidAt is not provided (defaults to current date)
+ * @returns The calculated fine amount rounded to 2 decimal places
+ */
+declare function calculateStudentFeeFine(fee: {
+    amount: number;
+    amountDue: number;
+    dueDate: Date;
+    fine?: number | null;
+    paidAt?: Date | null;
+    status: string;
+}, dueDateLength: number, perDateRate: number, asOf?: Date): number;
+
+export { calculateStudentFeeFine };

package/edu-pilot-pro/calculate-student-fee-fine.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var h=(t,n)=>{for(var a in n)o(t,a,{get:n[a],enumerable:!0})},M=(t,n,a,u)=>{if(n&&typeof n=="object"||typeof n=="function")for(let e of d(n))!g.call(t,e)&&e!==a&&o(t,e,{get:()=>n[e],enumerable:!(u=c(n,e))||u.enumerable});return t};var b=t=>M(o({},"__esModule",{value:!0}),t);var f={};h(f,{calculateStudentFeeFine:()=>p});module.exports=b(f);function y(t,n){return t.getFullYear()===n.getFullYear()&&t.getMonth()===n.getMonth()}function F(t,n){return Math.round((n.getTime()-t.getTime())/(1e3*60*60*24))}function p(t,n,a,u){if(t.status==="CANCELLED"||t.status==="REFUNDED")return 0;if(t.fine!=null&&t.fine>0)return t.fine;if(a<=0||t.amountDue<=0)return 0;const e=t.paidAt??u??new Date,m=y(t.dueDate,e);let r;if(m){if(r=e.getDate()-n,r<=0)return 0}else{const D=new Date(t.dueDate.getFullYear(),t.dueDate.getMonth(),1),s=new Date(e.getFullYear(),e.getMonth(),0);r=F(D,s)+1}const i=t.amount>0?t.amountDue/t.amount:0,l=r*a*i;return Math.round(l*100)/100}0&&(module.exports={calculateStudentFeeFine});

package/edu-pilot-pro/calculate-student-fee-fine.mjs

@@ -0,0 +1 @@
+function s(t,n){return t.getFullYear()===n.getFullYear()&&t.getMonth()===n.getMonth()}function c(t,n){return Math.round((n.getTime()-t.getTime())/(1e3*60*60*24))}function d(t,n,u,o){if(t.status==="CANCELLED"||t.status==="REFUNDED")return 0;if(t.fine!=null&&t.fine>0)return t.fine;if(u<=0||t.amountDue<=0)return 0;const e=t.paidAt??o??new Date,D=s(t.dueDate,e);let a;if(D){if(a=e.getDate()-n,a<=0)return 0}else{const r=new Date(t.dueDate.getFullYear(),t.dueDate.getMonth(),1),l=new Date(e.getFullYear(),e.getMonth(),0);a=c(r,l)+1}const m=t.amount>0?t.amountDue/t.amount:0,i=a*u*m;return Math.round(i*100)/100}export{d as calculateStudentFeeFine};

package/edu-pilot-pro/types/academics.d.mts

@@ -0,0 +1,2 @@
+import './enums.mjs';
+export { A as AttendanceBE, o as ClassBE, p as CourseBE, q as EnrollmentBE, r as FamilyBE, s as FamilyMemberBE, G as GradeBE, t as ScheduleBE, u as SectionBE, v as StudentProfileBE, w as SubjectBE, T as TeacherBE } from './admission.mjs';

package/edu-pilot-pro/types/academics.d.ts

@@ -0,0 +1,2 @@
+import './enums.js';
+export { A as AttendanceBE, o as ClassBE, p as CourseBE, q as EnrollmentBE, r as FamilyBE, s as FamilyMemberBE, G as GradeBE, t as ScheduleBE, u as SectionBE, v as StudentProfileBE, w as SubjectBE, T as TeacherBE } from './admission.js';

package/edu-pilot-pro/types/academics.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var o=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var d=(t,e,i,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of o(e))!a.call(t,n)&&n!==i&&s(t,n,{get:()=>e[n],enumerable:!(r=l(e,n))||r.enumerable});return t};var g=t=>d(s({},"__esModule",{value:!0}),t);var u={};module.exports=g(u);