@aibrains/shared-types 0.9.2 → 0.10.1

package/dist/index.d.ts

@@ -44,5 +44,6 @@ export type { ZodSchema, ZodType, ZodError } from 'zod';
 export * from './validators';
 export * from './schemas';
 export * from './mappers';
+export { formatNPR } from './utils/currency';
 export type { BaseEntity, RequestContext, Address, EntityStatus, PaginationQuery, ErrorResponse, } from './schemas/common';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAMxD,cAAc,cAAc,CAAC;AAM7B,cAAc,WAAW,CAAC;AAM1B,cAAc,WAAW,CAAC;AAQ1B,YAAY,EACV,UAAU,EACV,cAAc,EACd,OAAO,EACP,YAAY,EACZ,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAMxD,cAAc,cAAc,CAAC;AAM7B,cAAc,WAAW,CAAC;AAM1B,cAAc,WAAW,CAAC;AAM1B,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAQ7C,YAAY,EACV,UAAU,EACV,cAAc,EACd,OAAO,EACP,YAAY,EACZ,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -55,7 +55,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.z = void 0;
+exports.formatNPR = exports.z = void 0;
 // Re-export Zod for convenience
 var zod_1 = require("zod");
 Object.defineProperty(exports, "z", { enumerable: true, get: function () { return zod_1.z; } });
@@ -71,4 +71,9 @@ __exportStar(require("./schemas"), exports);
 // Ed-Fi Mappers (for compliance export)
 // ============================================
 __exportStar(require("./mappers"), exports);
+// ============================================
+// Utility Functions
+// ============================================
+var currency_1 = require("./utils/currency");
+Object.defineProperty(exports, "formatNPR", { enumerable: true, get: function () { return currency_1.formatNPR; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;;;;;;;;;;;;;;;;;AAEH,gCAAgC;AAChC,2BAAwB;AAAf,wFAAA,CAAC,OAAA;AAGV,+CAA+C;AAC/C,aAAa;AACb,+CAA+C;AAE/C,+CAA6B;AAE7B,+CAA+C;AAC/C,wBAAwB;AACxB,+CAA+C;AAE/C,4CAA0B;AAE1B,+CAA+C;AAC/C,wCAAwC;AACxC,+CAA+C;AAE/C,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;;;;;;;;;;;;;;;;;AAEH,gCAAgC;AAChC,2BAAwB;AAAf,wFAAA,CAAC,OAAA;AAGV,+CAA+C;AAC/C,aAAa;AACb,+CAA+C;AAE/C,+CAA6B;AAE7B,+CAA+C;AAC/C,wBAAwB;AACxB,+CAA+C;AAE/C,4CAA0B;AAE1B,+CAA+C;AAC/C,wCAAwC;AACxC,+CAA+C;AAE/C,4CAA0B;AAE1B,+CAA+C;AAC/C,oBAAoB;AACpB,+CAA+C;AAE/C,6CAA6C;AAApC,qGAAA,SAAS,OAAA"}

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

@@ -0,0 +1,41 @@
+/**
+ * Finance Domain — Common Enums & Base Types
+ *
+ * Shared across fee-structure, invoice, payment, student-account,
+ * and payment-gateway schemas.
+ */
+import { z } from 'zod';
+/** Fee categories aligned with Nepal school fee taxonomy */
+export declare const feeTypeEnum: z.ZodEnum<["tuition", "admission", "exam", "transport", "library", "lab", "hostel", "uniform", "miscellaneous", "custom"]>;
+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>;
+/** Nepal tax registration types */
+export declare const taxTypeEnum: z.ZodEnum<["PAN", "VAT", "none"]>;
+export type TaxType = z.infer<typeof taxTypeEnum>;
+/** Invoice lifecycle: draft → issued → partially_paid → paid → overdue → cancelled → written_off */
+export declare const invoiceStatusEnum: z.ZodEnum<["draft", "issued", "partially_paid", "paid", "overdue", "cancelled", "written_off"]>;
+export type InvoiceStatus = z.infer<typeof invoiceStatusEnum>;
+/** Payment lifecycle: pending → processing → completed | failed | cancelled → refunded */
+export declare const paymentStatusEnum: z.ZodEnum<["pending", "processing", "completed", "failed", "cancelled", "refunded", "partially_refunded"]>;
+export type PaymentStatus = z.infer<typeof paymentStatusEnum>;
+/** Supported payment gateways */
+export declare const paymentGatewayEnum: z.ZodEnum<["esewa", "khalti", "fonepay", "connectips", "stripe", "cash", "bank_transfer", "cheque"]>;
+export type PaymentGateway = z.infer<typeof paymentGatewayEnum>;
+/** Manual (offline) payment methods that don't require gateway redirect */
+export declare const OFFLINE_GATEWAYS: ReadonlySet<PaymentGateway>;
+export declare const ledgerEntryTypeEnum: z.ZodEnum<["invoice", "payment", "refund", "adjustment", "write_off"]>;
+export type LedgerEntryType = z.infer<typeof ledgerEntryTypeEnum>;
+/** Supported currencies (extensible without breaking change) */
+export declare const currencyEnum: z.ZodEnum<["NPR"]>;
+export type Currency = z.infer<typeof currencyEnum>;
+/** Positive monetary amount (NPR, max 10 million) */
+export declare const amountSchema: z.ZodNumber;
+/** Monetary amount that can be zero (max 10 million) */
+export declare const amountOrZeroSchema: z.ZodNumber;
+/** Tax rate as percentage (0–100) */
+export declare const taxRateSchema: z.ZodDefault<z.ZodNumber>;
+/** Discount amount (non-negative, max 10 million) */
+export declare const discountAmountSchema: z.ZodDefault<z.ZodNumber>;
+//# sourceMappingURL=common.d.ts.map

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

@@ -0,0 +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,oBAAkB,CAAC;AAC5C,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

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * Finance Domain — Common Enums & Base Types
+ *
+ * Shared across fee-structure, invoice, payment, student-account,
+ * 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;
+const zod_1 = require("zod");
+// ============================================================================
+// FEE ENUMS
+// ============================================================================
+/** Fee categories aligned with Nepal school fee taxonomy */
+exports.feeTypeEnum = zod_1.z.enum([
+    'tuition',
+    'admission',
+    'exam',
+    'transport',
+    'library',
+    'lab',
+    'hostel',
+    'uniform',
+    'miscellaneous',
+    'custom',
+]);
+/** How often the fee is charged */
+exports.feeFrequencyEnum = zod_1.z.enum([
+    'one_time',
+    'monthly',
+    'quarterly',
+    'annual',
+]);
+// ============================================================================
+// TAX ENUMS
+// ============================================================================
+/** Nepal tax registration types */
+exports.taxTypeEnum = zod_1.z.enum(['PAN', 'VAT', 'none']);
+// ============================================================================
+// INVOICE ENUMS
+// ============================================================================
+/** Invoice lifecycle: draft → issued → partially_paid → paid → overdue → cancelled → written_off */
+exports.invoiceStatusEnum = zod_1.z.enum([
+    'draft',
+    'issued',
+    'partially_paid',
+    'paid',
+    'overdue',
+    'cancelled',
+    'written_off',
+]);
+// ============================================================================
+// PAYMENT ENUMS
+// ============================================================================
+/** Payment lifecycle: pending → processing → completed | failed | cancelled → refunded */
+exports.paymentStatusEnum = zod_1.z.enum([
+    'pending',
+    'processing',
+    'completed',
+    'failed',
+    'cancelled',
+    'refunded',
+    'partially_refunded',
+]);
+/** Supported payment gateways */
+exports.paymentGatewayEnum = zod_1.z.enum([
+    'esewa',
+    'khalti',
+    'fonepay',
+    'connectips',
+    'stripe',
+    'cash',
+    'bank_transfer',
+    'cheque',
+]);
+/** Manual (offline) payment methods that don't require gateway redirect */
+exports.OFFLINE_GATEWAYS = new Set([
+    'cash',
+    'bank_transfer',
+    'cheque',
+]);
+// ============================================================================
+// LEDGER ENUMS
+// ============================================================================
+exports.ledgerEntryTypeEnum = zod_1.z.enum([
+    'invoice',
+    'payment',
+    'refund',
+    'adjustment',
+    'write_off',
+]);
+// ============================================================================
+// CURRENCY
+// ============================================================================
+/** Supported currencies (extensible without breaking change) */
+exports.currencyEnum = zod_1.z.enum(['NPR']);
+/** Positive monetary amount (NPR, max 10 million) */
+exports.amountSchema = zod_1.z.number().min(0).max(10000000);
+/** Monetary amount that can be zero (max 10 million) */
+exports.amountOrZeroSchema = zod_1.z.number().min(0).max(10000000);
+/** Tax rate as percentage (0–100) */
+exports.taxRateSchema = zod_1.z.number().min(0).max(100).default(0);
+/** Discount amount (non-negative, max 10 million) */
+exports.discountAmountSchema = zod_1.z.number().min(0).max(10000000).default(0);
+//# sourceMappingURL=common.js.map

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

@@ -0,0 +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,CAAC,CAAC,CAAC;AAG5C,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"}

package/dist/schemas/finance/fee-structure.schema.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Fee Structure Schemas
+ *
+ * Defines billable items a school charges students.
+ * Admin configures these; the system generates invoices from them.
+ */
+import { z } from 'zod';
+export declare const feeStructureResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    schoolId: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    academicYear: z.ZodString;
+    feeType: z.ZodEnum<["tuition", "admission", "exam", "transport", "library", "lab", "hostel", "uniform", "miscellaneous", "custom"]>;
+    amount: z.ZodNumber;
+    currency: z.ZodEnum<["NPR"]>;
+    taxRate: z.ZodNumber;
+    taxType: z.ZodEnum<["PAN", "VAT", "none"]>;
+    frequency: z.ZodEnum<["one_time", "monthly", "quarterly", "annual"]>;
+    gradeLevels: z.ZodArray<z.ZodString, "many">;
+    isActive: z.ZodBoolean;
+    effectiveFrom: z.ZodString;
+    effectiveTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    createdAt: string;
+    updatedAt: string;
+    name: string;
+    gradeLevels: string[];
+    schoolId: string;
+    isActive: boolean;
+    id: string;
+    academicYear: string;
+    feeType: "custom" | "lab" | "library" | "exam" | "tuition" | "admission" | "transport" | "hostel" | "uniform" | "miscellaneous";
+    amount: number;
+    currency: "NPR";
+    taxRate: number;
+    taxType: "none" | "PAN" | "VAT";
+    frequency: "annual" | "one_time" | "monthly" | "quarterly";
+    effectiveFrom: string;
+    description?: string | undefined;
+    effectiveTo?: string | null | undefined;
+}, {
+    createdAt: string;
+    updatedAt: string;
+    name: string;
+    gradeLevels: string[];
+    schoolId: string;
+    isActive: boolean;
+    id: string;
+    academicYear: string;
+    feeType: "custom" | "lab" | "library" | "exam" | "tuition" | "admission" | "transport" | "hostel" | "uniform" | "miscellaneous";
+    amount: number;
+    currency: "NPR";
+    taxRate: number;
+    taxType: "none" | "PAN" | "VAT";
+    frequency: "annual" | "one_time" | "monthly" | "quarterly";
+    effectiveFrom: string;
+    description?: string | undefined;
+    effectiveTo?: string | null | undefined;
+}>;
+export type FeeStructure = z.infer<typeof feeStructureResponseSchema>;
+export declare const createFeeStructureSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    academicYear: z.ZodString;
+    feeType: z.ZodEnum<["tuition", "admission", "exam", "transport", "library", "lab", "hostel", "uniform", "miscellaneous", "custom"]>;
+    amount: z.ZodNumber;
+    currency: z.ZodDefault<z.ZodEnum<["NPR"]>>;
+    taxRate: z.ZodDefault<z.ZodNumber>;
+    taxType: z.ZodDefault<z.ZodEnum<["PAN", "VAT", "none"]>>;
+    frequency: z.ZodEnum<["one_time", "monthly", "quarterly", "annual"]>;
+    gradeLevels: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    effectiveFrom: z.ZodEffects<z.ZodString, string, string>;
+    effectiveTo: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    gradeLevels: string[];
+    academicYear: string;
+    feeType: "custom" | "lab" | "library" | "exam" | "tuition" | "admission" | "transport" | "hostel" | "uniform" | "miscellaneous";
+    amount: number;
+    currency: "NPR";
+    taxRate: number;
+    taxType: "none" | "PAN" | "VAT";
+    frequency: "annual" | "one_time" | "monthly" | "quarterly";
+    effectiveFrom: string;
+    description?: string | undefined;
+    effectiveTo?: string | undefined;
+}, {
+    name: string;
+    academicYear: string;
+    feeType: "custom" | "lab" | "library" | "exam" | "tuition" | "admission" | "transport" | "hostel" | "uniform" | "miscellaneous";
+    amount: number;
+    frequency: "annual" | "one_time" | "monthly" | "quarterly";
+    effectiveFrom: string;
+    gradeLevels?: string[] | undefined;
+    description?: string | undefined;
+    currency?: "NPR" | undefined;
+    taxRate?: number | undefined;
+    taxType?: "none" | "PAN" | "VAT" | undefined;
+    effectiveTo?: string | undefined;
+}>;
+export type CreateFeeStructureDto = z.infer<typeof createFeeStructureSchema>;
+export declare const updateFeeStructureSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    taxRate: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    taxType: z.ZodOptional<z.ZodEnum<["PAN", "VAT", "none"]>>;
+    frequency: z.ZodOptional<z.ZodEnum<["one_time", "monthly", "quarterly", "annual"]>>;
+    gradeLevels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+    effectiveFrom: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    effectiveTo: z.ZodNullable<z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>>;
+}, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
+    gradeLevels?: string[] | undefined;
+    isActive?: boolean | undefined;
+    description?: string | undefined;
+    amount?: number | undefined;
+    taxRate?: number | undefined;
+    taxType?: "none" | "PAN" | "VAT" | undefined;
+    frequency?: "annual" | "one_time" | "monthly" | "quarterly" | undefined;
+    effectiveFrom?: string | undefined;
+    effectiveTo?: string | null | undefined;
+}, {
+    name?: string | undefined;
+    gradeLevels?: string[] | undefined;
+    isActive?: boolean | undefined;
+    description?: string | undefined;
+    amount?: number | undefined;
+    taxRate?: number | undefined;
+    taxType?: "none" | "PAN" | "VAT" | undefined;
+    frequency?: "annual" | "one_time" | "monthly" | "quarterly" | undefined;
+    effectiveFrom?: string | undefined;
+    effectiveTo?: string | null | undefined;
+}>;
+export type UpdateFeeStructureDto = z.infer<typeof updateFeeStructureSchema>;
+export declare const feeStructureFilterSchema: z.ZodObject<{
+    feeType: z.ZodOptional<z.ZodEnum<["tuition", "admission", "exam", "transport", "library", "lab", "hostel", "uniform", "miscellaneous", "custom"]>>;
+    frequency: z.ZodOptional<z.ZodEnum<["one_time", "monthly", "quarterly", "annual"]>>;
+    academicYear: z.ZodOptional<z.ZodString>;
+    gradeLevel: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+    searchTerm: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    isActive?: boolean | undefined;
+    gradeLevel?: string | undefined;
+    searchTerm?: string | undefined;
+    academicYear?: string | undefined;
+    feeType?: "custom" | "lab" | "library" | "exam" | "tuition" | "admission" | "transport" | "hostel" | "uniform" | "miscellaneous" | undefined;
+    frequency?: "annual" | "one_time" | "monthly" | "quarterly" | undefined;
+}, {
+    isActive?: boolean | undefined;
+    gradeLevel?: string | undefined;
+    searchTerm?: string | undefined;
+    academicYear?: string | undefined;
+    feeType?: "custom" | "lab" | "library" | "exam" | "tuition" | "admission" | "transport" | "hostel" | "uniform" | "miscellaneous" | undefined;
+    frequency?: "annual" | "one_time" | "monthly" | "quarterly" | undefined;
+}>;
+export type FeeStructureFilterDto = z.infer<typeof feeStructureFilterSchema>;
+//# sourceMappingURL=fee-structure.schema.d.ts.map

package/dist/schemas/finance/fee-structure.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee-structure.schema.d.ts","sourceRoot":"","sources":["../../../src/schemas/finance/fee-structure.schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBrC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAMtE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAanC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM7E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWnC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM7E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EAOnC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/schemas/finance/fee-structure.schema.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Fee Structure Schemas
+ *
+ * Defines billable items a school charges students.
+ * Admin configures these; the system generates invoices from them.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.feeStructureFilterSchema = exports.updateFeeStructureSchema = exports.createFeeStructureSchema = exports.feeStructureResponseSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("./common");
+const common_2 = require("../common");
+// ============================================================================
+// RESPONSE
+// ============================================================================
+exports.feeStructureResponseSchema = zod_1.z.object({
+    id: common_2.uuidSchema,
+    schoolId: common_2.uuidSchema,
+    name: zod_1.z.string(),
+    description: zod_1.z.string().optional(),
+    academicYear: zod_1.z.string(),
+    feeType: common_1.feeTypeEnum,
+    amount: common_1.amountSchema,
+    currency: common_1.currencyEnum,
+    taxRate: zod_1.z.number().min(0).max(100),
+    taxType: common_1.taxTypeEnum,
+    frequency: common_1.feeFrequencyEnum,
+    gradeLevels: zod_1.z.array(zod_1.z.string()),
+    isActive: zod_1.z.boolean(),
+    effectiveFrom: zod_1.z.string(),
+    effectiveTo: zod_1.z.string().optional().nullable(),
+    createdAt: zod_1.z.string(),
+    updatedAt: zod_1.z.string(),
+});
+// ============================================================================
+// CREATE
+// ============================================================================
+exports.createFeeStructureSchema = zod_1.z.object({
+    name: zod_1.z.string().min(1).max(200),
+    description: zod_1.z.string().max(1000).optional(),
+    academicYear: zod_1.z.string().min(1).max(20),
+    feeType: common_1.feeTypeEnum,
+    amount: common_1.amountSchema.positive('Amount must be greater than 0'),
+    currency: common_1.currencyEnum.default('NPR'),
+    taxRate: common_1.taxRateSchema,
+    taxType: common_1.taxTypeEnum.default('none'),
+    frequency: common_1.feeFrequencyEnum,
+    gradeLevels: zod_1.z.array(zod_1.z.string().min(1).max(10)).default([]),
+    effectiveFrom: common_2.dateSchema,
+    effectiveTo: common_2.dateSchema.optional(),
+});
+// ============================================================================
+// UPDATE
+// ============================================================================
+exports.updateFeeStructureSchema = zod_1.z.object({
+    name: zod_1.z.string().min(1).max(200).optional(),
+    description: zod_1.z.string().max(1000).optional(),
+    amount: common_1.amountSchema.positive('Amount must be greater than 0').optional(),
+    taxRate: common_1.taxRateSchema.optional(),
+    taxType: common_1.taxTypeEnum.optional(),
+    frequency: common_1.feeFrequencyEnum.optional(),
+    gradeLevels: zod_1.z.array(zod_1.z.string().min(1).max(10)).optional(),
+    isActive: zod_1.z.boolean().optional(),
+    effectiveFrom: common_2.dateSchema.optional(),
+    effectiveTo: common_2.dateSchema.optional().nullable(),
+});
+// ============================================================================
+// FILTER
+// ============================================================================
+exports.feeStructureFilterSchema = zod_1.z.object({
+    feeType: common_1.feeTypeEnum.optional(),
+    frequency: common_1.feeFrequencyEnum.optional(),
+    academicYear: zod_1.z.string().optional(),
+    gradeLevel: zod_1.z.string().optional(),
+    isActive: zod_1.z.coerce.boolean().optional(),
+    searchTerm: zod_1.z.string().max(100).optional(),
+});
+//# sourceMappingURL=fee-structure.schema.js.map

package/dist/schemas/finance/fee-structure.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee-structure.schema.js","sourceRoot":"","sources":["../../../src/schemas/finance/fee-structure.schema.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,12 @@
+/**
+ * Finance Domain Schemas
+ *
+ * Re-exports all finance-related Zod schemas and inferred types.
+ */
+export * from './common';
+export * from './fee-structure.schema';
+export * from './invoice.schema';
+export * from './payment.schema';
+export * from './student-account.schema';
+export * from './payment-gateway.schema';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schemas/finance/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC"}

package/dist/schemas/finance/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Finance Domain Schemas
+ *
+ * Re-exports all finance-related Zod schemas and inferred types.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./common"), exports);
+__exportStar(require("./fee-structure.schema"), exports);
+__exportStar(require("./invoice.schema"), exports);
+__exportStar(require("./payment.schema"), exports);
+__exportStar(require("./student-account.schema"), exports);
+__exportStar(require("./payment-gateway.schema"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schemas/finance/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,2CAAyB;AACzB,yDAAuC;AACvC,mDAAiC;AACjC,mDAAiC;AACjC,2DAAyC;AACzC,2DAAyC"}