@aibrains/shared-types 0.17.0 → 0.19.0

package/dist/schemas/finance/common.d.ts

@@ -11,6 +11,9 @@ export type FeeType = z.infer<typeof feeTypeEnum>;
 /** How often the fee is charged */
 export declare const feeFrequencyEnum: z.ZodEnum<["one_time", "monthly", "quarterly", "annual"]>;
 export type FeeFrequency = z.infer<typeof feeFrequencyEnum>;
+/** Enrollment types for fee applicability filtering */
+export declare const enrollmentTypeEnum: z.ZodEnum<["new_admission", "transfer", "returning", "re_enrollment"]>;
+export type FeeEnrollmentType = z.infer<typeof enrollmentTypeEnum>;
 /** Nepal tax registration types */
 export declare const taxTypeEnum: z.ZodEnum<["PAN", "VAT", "none"]>;
 export type TaxType = z.infer<typeof taxTypeEnum>;

package/dist/schemas/finance/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/schemas/finance/common.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,4DAA4D;AAC5D,eAAO,MAAM,WAAW,4HAWtB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAElD,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,2DAK3B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAM5D,mCAAmC;AACnC,eAAO,MAAM,WAAW,mCAAiC,CAAC;AAC1D,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAMlD,oGAAoG;AACpG,eAAO,MAAM,iBAAiB,iGAQ5B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM9D,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,4GAQ5B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE9D,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,sGAS7B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEhE,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,cAAc,CAIvD,CAAC;AAMH,eAAO,MAAM,mBAAmB,wEAM9B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMlE,gEAAgE;AAChE,eAAO,MAAM,YAAY,uDAAqD,CAAC;AAC/E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEpD,qDAAqD;AACrD,eAAO,MAAM,YAAY,aAAoC,CAAC;AAE9D,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,aAAoC,CAAC;AAEpE,qCAAqC;AACrC,eAAO,MAAM,aAAa,2BAAwC,CAAC;AAEnE,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,2BAA+C,CAAC"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/schemas/finance/common.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,4DAA4D;AAC5D,eAAO,MAAM,WAAW,4HAWtB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAElD,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,2DAK3B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAM5D,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,wEAAsE,CAAC;AACtG,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAMnE,mCAAmC;AACnC,eAAO,MAAM,WAAW,mCAAiC,CAAC;AAC1D,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAMlD,oGAAoG;AACpG,eAAO,MAAM,iBAAiB,iGAQ5B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM9D,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,4GAQ5B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE9D,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,sGAS7B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEhE,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,cAAc,CAIvD,CAAC;AAMH,eAAO,MAAM,mBAAmB,wEAM9B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMlE,gEAAgE;AAChE,eAAO,MAAM,YAAY,uDAAqD,CAAC;AAC/E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEpD,qDAAqD;AACrD,eAAO,MAAM,YAAY,aAAoC,CAAC;AAE9D,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,aAAoC,CAAC;AAEpE,qCAAqC;AACrC,eAAO,MAAM,aAAa,2BAAwC,CAAC;AAEnE,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,2BAA+C,CAAC"}

package/dist/schemas/finance/common.js

@@ -6,7 +6,7 @@
  * and payment-gateway schemas.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.discountAmountSchema = exports.taxRateSchema = exports.amountOrZeroSchema = exports.amountSchema = exports.currencyEnum = exports.ledgerEntryTypeEnum = exports.OFFLINE_GATEWAYS = exports.paymentGatewayEnum = exports.paymentStatusEnum = exports.invoiceStatusEnum = exports.taxTypeEnum = exports.feeFrequencyEnum = exports.feeTypeEnum = void 0;
+exports.discountAmountSchema = exports.taxRateSchema = exports.amountOrZeroSchema = exports.amountSchema = exports.currencyEnum = exports.ledgerEntryTypeEnum = exports.OFFLINE_GATEWAYS = exports.paymentGatewayEnum = exports.paymentStatusEnum = exports.invoiceStatusEnum = exports.taxTypeEnum = exports.enrollmentTypeEnum = exports.feeFrequencyEnum = exports.feeTypeEnum = void 0;
 const zod_1 = require("zod");
 // ============================================================================
 // FEE ENUMS
@@ -32,6 +32,11 @@ exports.feeFrequencyEnum = zod_1.z.enum([
     'annual',
 ]);
 // ============================================================================
+// ENROLLMENT ENUMS
+// ============================================================================
+/** Enrollment types for fee applicability filtering */
+exports.enrollmentTypeEnum = zod_1.z.enum(['new_admission', 'transfer', 'returning', 're_enrollment']);
+// ============================================================================
 // TAX ENUMS
 // ============================================================================
 /** Nepal tax registration types */

package/dist/schemas/finance/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/schemas/finance/common.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,6BAAwB;AAExB,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,4DAA4D;AAC/C,QAAA,WAAW,GAAG,OAAC,CAAC,IAAI,CAAC;IAChC,SAAS;IACT,WAAW;IACX,MAAM;IACN,WAAW;IACX,SAAS;IACT,KAAK;IACL,QAAQ;IACR,SAAS;IACT,eAAe;IACf,QAAQ;CACT,CAAC,CAAC;AAGH,mCAAmC;AACtB,QAAA,gBAAgB,GAAG,OAAC,CAAC,IAAI,CAAC;IACrC,UAAU;IACV,SAAS;IACT,WAAW;IACX,QAAQ;CACT,CAAC,CAAC;AAGH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,mCAAmC;AACtB,QAAA,WAAW,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAG1D,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,oGAAoG;AACvF,QAAA,iBAAiB,GAAG,OAAC,CAAC,IAAI,CAAC;IACtC,OAAO;IACP,QAAQ;IACR,gBAAgB;IAChB,MAAM;IACN,SAAS;IACT,WAAW;IACX,aAAa;CACd,CAAC,CAAC;AAGH,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,0FAA0F;AAC7E,QAAA,iBAAiB,GAAG,OAAC,CAAC,IAAI,CAAC;IACtC,SAAS;IACT,YAAY;IACZ,WAAW;IACX,QAAQ;IACR,WAAW;IACX,UAAU;IACV,oBAAoB;CACrB,CAAC,CAAC;AAGH,iCAAiC;AACpB,QAAA,kBAAkB,GAAG,OAAC,CAAC,IAAI,CAAC;IACvC,OAAO;IACP,QAAQ;IACR,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,MAAM;IACN,eAAe;IACf,QAAQ;CACT,CAAC,CAAC;AAGH,2EAA2E;AAC9D,QAAA,gBAAgB,GAAgC,IAAI,GAAG,CAAC;IACnE,MAAM;IACN,eAAe;IACf,QAAQ;CACT,CAAC,CAAC;AAEH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAElE,QAAA,mBAAmB,GAAG,OAAC,CAAC,IAAI,CAAC;IACxC,SAAS;IACT,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,WAAW;CACZ,CAAC,CAAC;AAGH,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,gEAAgE;AACnD,QAAA,YAAY,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAG/E,qDAAqD;AACxC,QAAA,YAAY,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAU,CAAC,CAAC;AAE9D,wDAAwD;AAC3C,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAU,CAAC,CAAC;AAEpE,qCAAqC;AACxB,QAAA,aAAa,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAEnE,qDAAqD;AACxC,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/schemas/finance/common.ts"],"names":[],"mappings":"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"}

package/dist/schemas/finance/credit-note.schema.d.ts

@@ -50,7 +50,7 @@ export declare const creditNoteResponseSchema: z.ZodObject<{
     id: string;
     approvedBy: string;
     amount: number;
-    currency: "NPR" | "USD" | "INR" | "GBP" | "CAD" | "AUD";
+    currency: "USD" | "NPR" | "INR" | "GBP" | "CAD" | "AUD";
     studentAccountId: string;
     remainingAmount: number;
     appliedToInvoices: {
@@ -72,7 +72,7 @@ export declare const creditNoteResponseSchema: z.ZodObject<{
     id: string;
     approvedBy: string;
     amount: number;
-    currency: "NPR" | "USD" | "INR" | "GBP" | "CAD" | "AUD";
+    currency: "USD" | "NPR" | "INR" | "GBP" | "CAD" | "AUD";
     studentAccountId: string;
     remainingAmount: number;
     fundingSource?: string | undefined;
@@ -99,7 +99,7 @@ export declare const createCreditNoteSchema: z.ZodObject<{
     effectiveDate: string;
     studentId: string;
     amount: number;
-    currency: "NPR" | "USD" | "INR" | "GBP" | "CAD" | "AUD";
+    currency: "USD" | "NPR" | "INR" | "GBP" | "CAD" | "AUD";
     fundingSource?: string | undefined;
     expiryDate?: string | undefined;
 }, {
@@ -108,7 +108,7 @@ export declare const createCreditNoteSchema: z.ZodObject<{
     effectiveDate: string;
     studentId: string;
     amount: number;
-    currency?: "NPR" | "USD" | "INR" | "GBP" | "CAD" | "AUD" | undefined;
+    currency?: "USD" | "NPR" | "INR" | "GBP" | "CAD" | "AUD" | undefined;
     fundingSource?: string | undefined;
     expiryDate?: string | undefined;
 }>;

package/dist/schemas/finance/dashboard.schema.d.ts

@@ -0,0 +1,335 @@
+/**
+ * Dashboard Summary Schema
+ *
+ * Zod schemas for finance dashboard API responses.
+ * Mirrors the DashboardSummary interface in dashboard.service.ts.
+ */
+import { z } from 'zod';
+export declare const gradeLevelBreakdownSchema: z.ZodObject<{
+    gradeLevel: z.ZodString;
+    invoiceCount: z.ZodNumber;
+    totalInvoiced: z.ZodNumber;
+    totalCollected: z.ZodNumber;
+    outstanding: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    gradeLevel: string;
+    invoiceCount: number;
+    totalInvoiced: number;
+    totalCollected: number;
+    outstanding: number;
+}, {
+    gradeLevel: string;
+    invoiceCount: number;
+    totalInvoiced: number;
+    totalCollected: number;
+    outstanding: number;
+}>;
+export type GradeLevelBreakdown = z.infer<typeof gradeLevelBreakdownSchema>;
+export declare const feeTypeBreakdownSchema: z.ZodObject<{
+    feeType: z.ZodString;
+    invoiceCount: z.ZodNumber;
+    totalAmount: z.ZodNumber;
+    collectedAmount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    feeType: string;
+    invoiceCount: number;
+    totalAmount: number;
+    collectedAmount: number;
+}, {
+    feeType: string;
+    invoiceCount: number;
+    totalAmount: number;
+    collectedAmount: number;
+}>;
+export type FeeTypeBreakdown = z.infer<typeof feeTypeBreakdownSchema>;
+export declare const agingBucketSchema: z.ZodObject<{
+    label: z.ZodString;
+    minDays: z.ZodNumber;
+    maxDays: z.ZodNullable<z.ZodNumber>;
+    count: z.ZodNumber;
+    amount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    count: number;
+    amount: number;
+    minDays: number;
+    maxDays: number | null;
+}, {
+    label: string;
+    count: number;
+    amount: number;
+    minDays: number;
+    maxDays: number | null;
+}>;
+export type AgingBucket = z.infer<typeof agingBucketSchema>;
+export declare const monthlyCollectionSchema: z.ZodObject<{
+    month: z.ZodString;
+    collected: z.ZodNumber;
+    invoiced: z.ZodNumber;
+    paymentCount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    month: string;
+    collected: number;
+    invoiced: number;
+    paymentCount: number;
+}, {
+    month: string;
+    collected: number;
+    invoiced: number;
+    paymentCount: number;
+}>;
+export type MonthlyCollection = z.infer<typeof monthlyCollectionSchema>;
+export declare const dashboardSummarySchema: z.ZodObject<{
+    totalInvoiced: z.ZodNumber;
+    totalCollected: z.ZodNumber;
+    outstanding: z.ZodNumber;
+    overdue: z.ZodNumber;
+    collectionRate: z.ZodNumber;
+    invoicesByStatus: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    paymentsByGateway: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    byGradeLevel: z.ZodArray<z.ZodObject<{
+        gradeLevel: z.ZodString;
+        invoiceCount: z.ZodNumber;
+        totalInvoiced: z.ZodNumber;
+        totalCollected: z.ZodNumber;
+        outstanding: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        gradeLevel: string;
+        invoiceCount: number;
+        totalInvoiced: number;
+        totalCollected: number;
+        outstanding: number;
+    }, {
+        gradeLevel: string;
+        invoiceCount: number;
+        totalInvoiced: number;
+        totalCollected: number;
+        outstanding: number;
+    }>, "many">;
+    byFeeType: z.ZodArray<z.ZodObject<{
+        feeType: z.ZodString;
+        invoiceCount: z.ZodNumber;
+        totalAmount: z.ZodNumber;
+        collectedAmount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        feeType: string;
+        invoiceCount: number;
+        totalAmount: number;
+        collectedAmount: number;
+    }, {
+        feeType: string;
+        invoiceCount: number;
+        totalAmount: number;
+        collectedAmount: number;
+    }>, "many">;
+    agingReport: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        minDays: z.ZodNumber;
+        maxDays: z.ZodNullable<z.ZodNumber>;
+        count: z.ZodNumber;
+        amount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        count: number;
+        amount: number;
+        minDays: number;
+        maxDays: number | null;
+    }, {
+        label: string;
+        count: number;
+        amount: number;
+        minDays: number;
+        maxDays: number | null;
+    }>, "many">;
+    monthlyCollections: z.ZodArray<z.ZodObject<{
+        month: z.ZodString;
+        collected: z.ZodNumber;
+        invoiced: z.ZodNumber;
+        paymentCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        month: string;
+        collected: number;
+        invoiced: number;
+        paymentCount: number;
+    }, {
+        month: string;
+        collected: number;
+        invoiced: number;
+        paymentCount: number;
+    }>, "many">;
+    recentPayments: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        amount: z.ZodNumber;
+        gateway: z.ZodString;
+        status: z.ZodString;
+        receiptNumber: z.ZodOptional<z.ZodString>;
+        paidAt: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        createdAt: string;
+        id: string;
+        amount: number;
+        gateway: string;
+        paidAt?: string | undefined;
+        receiptNumber?: string | undefined;
+    }, {
+        status: string;
+        createdAt: string;
+        id: string;
+        amount: number;
+        gateway: string;
+        paidAt?: string | undefined;
+        receiptNumber?: string | undefined;
+    }>, "many">;
+    recentInvoices: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        invoiceNumber: z.ZodString;
+        studentName: z.ZodString;
+        grandTotal: z.ZodNumber;
+        amountDue: z.ZodNumber;
+        status: z.ZodString;
+        issuedDate: z.ZodString;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        createdAt: string;
+        id: string;
+        studentName: string;
+        invoiceNumber: string;
+        grandTotal: number;
+        amountDue: number;
+        issuedDate: string;
+    }, {
+        status: string;
+        createdAt: string;
+        id: string;
+        studentName: string;
+        invoiceNumber: string;
+        grandTotal: number;
+        amountDue: number;
+        issuedDate: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    byGradeLevel: {
+        gradeLevel: string;
+        invoiceCount: number;
+        totalInvoiced: number;
+        totalCollected: number;
+        outstanding: number;
+    }[];
+    overdue: number;
+    totalInvoiced: number;
+    totalCollected: number;
+    outstanding: number;
+    collectionRate: number;
+    invoicesByStatus: Record<string, number>;
+    paymentsByGateway: Record<string, number>;
+    byFeeType: {
+        feeType: string;
+        invoiceCount: number;
+        totalAmount: number;
+        collectedAmount: number;
+    }[];
+    agingReport: {
+        label: string;
+        count: number;
+        amount: number;
+        minDays: number;
+        maxDays: number | null;
+    }[];
+    monthlyCollections: {
+        month: string;
+        collected: number;
+        invoiced: number;
+        paymentCount: number;
+    }[];
+    recentPayments: {
+        status: string;
+        createdAt: string;
+        id: string;
+        amount: number;
+        gateway: string;
+        paidAt?: string | undefined;
+        receiptNumber?: string | undefined;
+    }[];
+    recentInvoices: {
+        status: string;
+        createdAt: string;
+        id: string;
+        studentName: string;
+        invoiceNumber: string;
+        grandTotal: number;
+        amountDue: number;
+        issuedDate: string;
+    }[];
+}, {
+    byGradeLevel: {
+        gradeLevel: string;
+        invoiceCount: number;
+        totalInvoiced: number;
+        totalCollected: number;
+        outstanding: number;
+    }[];
+    overdue: number;
+    totalInvoiced: number;
+    totalCollected: number;
+    outstanding: number;
+    collectionRate: number;
+    invoicesByStatus: Record<string, number>;
+    paymentsByGateway: Record<string, number>;
+    byFeeType: {
+        feeType: string;
+        invoiceCount: number;
+        totalAmount: number;
+        collectedAmount: number;
+    }[];
+    agingReport: {
+        label: string;
+        count: number;
+        amount: number;
+        minDays: number;
+        maxDays: number | null;
+    }[];
+    monthlyCollections: {
+        month: string;
+        collected: number;
+        invoiced: number;
+        paymentCount: number;
+    }[];
+    recentPayments: {
+        status: string;
+        createdAt: string;
+        id: string;
+        amount: number;
+        gateway: string;
+        paidAt?: string | undefined;
+        receiptNumber?: string | undefined;
+    }[];
+    recentInvoices: {
+        status: string;
+        createdAt: string;
+        id: string;
+        studentName: string;
+        invoiceNumber: string;
+        grandTotal: number;
+        amountDue: number;
+        issuedDate: string;
+    }[];
+}>;
+export type DashboardSummary = z.infer<typeof dashboardSummarySchema>;
+export declare const dashboardFiltersSchema: z.ZodObject<{
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    academicYear: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    from?: string | undefined;
+    to?: string | undefined;
+    academicYear?: string | undefined;
+}, {
+    from?: string | undefined;
+    to?: string | undefined;
+    academicYear?: string | undefined;
+}>;
+export type DashboardFilters = z.infer<typeof dashboardFiltersSchema>;
+//# sourceMappingURL=dashboard.schema.d.ts.map

package/dist/schemas/finance/dashboard.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.schema.d.ts","sourceRoot":"","sources":["../../../src/schemas/finance/dashboard.schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;EAMpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAKjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/schemas/finance/dashboard.schema.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Dashboard Summary Schema
+ *
+ * Zod schemas for finance dashboard API responses.
+ * Mirrors the DashboardSummary interface in dashboard.service.ts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dashboardFiltersSchema = exports.dashboardSummarySchema = exports.monthlyCollectionSchema = exports.agingBucketSchema = exports.feeTypeBreakdownSchema = exports.gradeLevelBreakdownSchema = void 0;
+const zod_1 = require("zod");
+exports.gradeLevelBreakdownSchema = zod_1.z.object({
+    gradeLevel: zod_1.z.string(),
+    invoiceCount: zod_1.z.number().int(),
+    totalInvoiced: zod_1.z.number(),
+    totalCollected: zod_1.z.number(),
+    outstanding: zod_1.z.number(),
+});
+exports.feeTypeBreakdownSchema = zod_1.z.object({
+    feeType: zod_1.z.string(),
+    invoiceCount: zod_1.z.number().int(),
+    totalAmount: zod_1.z.number(),
+    collectedAmount: zod_1.z.number(),
+});
+exports.agingBucketSchema = zod_1.z.object({
+    label: zod_1.z.string(),
+    minDays: zod_1.z.number().int(),
+    maxDays: zod_1.z.number().int().nullable(),
+    count: zod_1.z.number().int(),
+    amount: zod_1.z.number(),
+});
+exports.monthlyCollectionSchema = zod_1.z.object({
+    month: zod_1.z.string(), // YYYY-MM
+    collected: zod_1.z.number(),
+    invoiced: zod_1.z.number(),
+    paymentCount: zod_1.z.number().int(),
+});
+exports.dashboardSummarySchema = zod_1.z.object({
+    totalInvoiced: zod_1.z.number(),
+    totalCollected: zod_1.z.number(),
+    outstanding: zod_1.z.number(),
+    overdue: zod_1.z.number(),
+    collectionRate: zod_1.z.number(),
+    invoicesByStatus: zod_1.z.record(zod_1.z.number()),
+    paymentsByGateway: zod_1.z.record(zod_1.z.number()),
+    byGradeLevel: zod_1.z.array(exports.gradeLevelBreakdownSchema),
+    byFeeType: zod_1.z.array(exports.feeTypeBreakdownSchema),
+    agingReport: zod_1.z.array(exports.agingBucketSchema),
+    monthlyCollections: zod_1.z.array(exports.monthlyCollectionSchema),
+    recentPayments: zod_1.z.array(zod_1.z.object({
+        id: zod_1.z.string(),
+        amount: zod_1.z.number(),
+        gateway: zod_1.z.string(),
+        status: zod_1.z.string(),
+        receiptNumber: zod_1.z.string().optional(),
+        paidAt: zod_1.z.string().optional(),
+        createdAt: zod_1.z.string(),
+    })),
+    recentInvoices: zod_1.z.array(zod_1.z.object({
+        id: zod_1.z.string(),
+        invoiceNumber: zod_1.z.string(),
+        studentName: zod_1.z.string(),
+        grandTotal: zod_1.z.number(),
+        amountDue: zod_1.z.number(),
+        status: zod_1.z.string(),
+        issuedDate: zod_1.z.string(),
+        createdAt: zod_1.z.string(),
+    })),
+});
+exports.dashboardFiltersSchema = zod_1.z.object({
+    from: zod_1.z.string().optional(),
+    to: zod_1.z.string().optional(),
+    academicYear: zod_1.z.string().optional(),
+});
+//# sourceMappingURL=dashboard.schema.js.map

package/dist/schemas/finance/dashboard.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.schema.js","sourceRoot":"","sources":["../../../src/schemas/finance/dashboard.schema.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,6BAAwB;AAEX,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE;IACtB,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC9B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE;IACzB,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;IAC1B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAIU,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC9B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE;CAC5B,CAAC,CAAC;AAIU,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACzB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACpC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAIU,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,UAAU;IAC7B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CAC/B,CAAC,CAAC;AAIU,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE;IACzB,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;IAC1B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;IAC1B,gBAAgB,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;IACtC,iBAAiB,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;IACvC,YAAY,EAAE,OAAC,CAAC,KAAK,CAAC,iCAAyB,CAAC;IAChD,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,8BAAsB,CAAC;IAC1C,WAAW,EAAE,OAAC,CAAC,KAAK,CAAC,yBAAiB,CAAC;IACvC,kBAAkB,EAAE,OAAC,CAAC,KAAK,CAAC,+BAAuB,CAAC;IACpD,cAAc,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;QAC/B,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;QACd,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;QAClB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;QACnB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;QAClB,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACpC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;KACtB,CAAC,CAAC;IACH,cAAc,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;QAC/B,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;QACd,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE;QACzB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;QACvB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE;QACtB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;QACrB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;QAClB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE;QACtB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;KACtB,CAAC,CAAC;CACJ,CAAC,CAAC;AAIU,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC"}