@aibrains/shared-types 0.9.2 → 0.10.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"payment.schema.d.ts","sourceRoot":"","sources":["../../../src/schemas/finance/payment.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS/B,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAM1D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBhC,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAM5D,wDAAwD;AACxD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;EAOhC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE3E,iEAAiE;AACjE,eAAO,MAAM,6BAA6B;;;;IAIxC,qEAAqE;;IAErE,kFAAkF;;;;;;;;;;;;;;EAElF,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAMpF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASpC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAM/E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAMhF,eAAO,MAAM,iBAAiB;;;;;;EAE5B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM/D,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAMjE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BxB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAMpD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;EAO9B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMnE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;EAItC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

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

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Payment & Receipt Schemas
+ *
+ * Gateway-agnostic payment types supporting eSewa, Khalti, and manual methods.
+ * The frontend NEVER handles gateway credentials — all secrets stay server-side.
+ *
+ * Payment lifecycle: pending → processing → completed | failed | cancelled → refunded
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.currencyFormatOptionsSchema = exports.paymentFilterSchema = exports.receiptSchema = exports.receiptLineItemSchema = exports.createRefundSchema = exports.voidPaymentSchema = exports.verifyPaymentResponseSchema = exports.recordManualPaymentSchema = exports.initiatePaymentResponseSchema = exports.initiatePaymentSchema = exports.paymentResponseSchema = exports.refundResponseSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("./common");
+const common_2 = require("../common");
+// ============================================================================
+// REFUND
+// ============================================================================
+exports.refundResponseSchema = zod_1.z.object({
+    id: common_2.uuidSchema,
+    paymentId: common_2.uuidSchema,
+    amount: zod_1.z.number().positive(),
+    reason: zod_1.z.string(),
+    gatewayRefundId: zod_1.z.string().optional(),
+    status: zod_1.z.enum(['pending', 'completed', 'failed']),
+    refundedAt: zod_1.z.string().nullable(),
+    createdAt: zod_1.z.string(),
+});
+// ============================================================================
+// PAYMENT RESPONSE
+// ============================================================================
+exports.paymentResponseSchema = zod_1.z.object({
+    id: common_2.uuidSchema,
+    invoiceId: common_2.uuidSchema,
+    studentAccountId: common_2.uuidSchema,
+    schoolId: common_2.uuidSchema,
+    amount: zod_1.z.number().positive(),
+    currency: common_1.currencyEnum,
+    gateway: common_1.paymentGatewayEnum,
+    gatewayTransactionId: zod_1.z.string().optional(),
+    gatewaySessionId: zod_1.z.string().optional(),
+    status: common_1.paymentStatusEnum,
+    paidAt: zod_1.z.string().nullable(),
+    paidBy: zod_1.z.string().nullable(),
+    receiptNumber: zod_1.z.string().nullable(),
+    metadata: zod_1.z.record(zod_1.z.unknown()).default({}),
+    refunds: zod_1.z.array(exports.refundResponseSchema).default([]),
+    createdAt: zod_1.z.string(),
+    updatedAt: zod_1.z.string(),
+});
+// ============================================================================
+// INITIATE PAYMENT (gateway redirect flow)
+// ============================================================================
+/** Frontend sends this to initiate a gateway payment */
+exports.initiatePaymentSchema = zod_1.z.object({
+    invoiceId: common_2.uuidSchema,
+    gateway: common_1.paymentGatewayEnum,
+    amount: zod_1.z.number().positive(),
+    currency: common_1.currencyEnum.default('NPR'),
+    returnUrl: zod_1.z.string().url(),
+    cancelUrl: zod_1.z.string().url(),
+});
+/** Backend responds with redirect URL to gateway payment page */
+exports.initiatePaymentResponseSchema = zod_1.z.object({
+    paymentSessionId: zod_1.z.string(),
+    redirectUrl: zod_1.z.string(),
+    expiresAt: zod_1.z.string(),
+    /** For form_post gateways (eSewa), the form fields to auto-submit */
+    formData: zod_1.z.record(zod_1.z.string()).optional(),
+    /** 'redirect' for simple URL redirect, 'form_post' for hidden form auto-submit */
+    method: zod_1.z.enum(['redirect', 'form_post']).default('redirect'),
+});
+// ============================================================================
+// RECORD MANUAL PAYMENT (cash, bank_transfer, cheque)
+// ============================================================================
+exports.recordManualPaymentSchema = zod_1.z.object({
+    invoiceId: common_2.uuidSchema,
+    gateway: zod_1.z.enum(['cash', 'bank_transfer', 'cheque']),
+    amount: zod_1.z.number().positive(),
+    currency: common_1.currencyEnum.default('NPR'),
+    referenceNumber: zod_1.z.string().max(100).optional(),
+    notes: zod_1.z.string().max(500).optional(),
+    paidDate: zod_1.z.string().optional(),
+    idempotencyKey: zod_1.z.string().uuid().optional(),
+});
+// ============================================================================
+// VERIFY PAYMENT (gateway callback)
+// ============================================================================
+exports.verifyPaymentResponseSchema = zod_1.z.object({
+    payment: exports.paymentResponseSchema,
+    invoice: zod_1.z.object({
+        id: common_2.uuidSchema,
+        invoiceNumber: zod_1.z.string(),
+        status: zod_1.z.string(),
+        amountDue: zod_1.z.number(),
+        grandTotal: zod_1.z.number(),
+    }),
+    receipt: zod_1.z.lazy(() => exports.receiptSchema).nullable(),
+    status: zod_1.z.enum(['completed', 'failed', 'cancelled']),
+});
+// ============================================================================
+// VOID PAYMENT
+// ============================================================================
+exports.voidPaymentSchema = zod_1.z.object({
+    reason: zod_1.z.string().min(1).max(500),
+});
+// ============================================================================
+// REFUND REQUEST
+// ============================================================================
+exports.createRefundSchema = zod_1.z.object({
+    amount: zod_1.z.number().positive(),
+    reason: zod_1.z.string().min(1).max(500),
+});
+// ============================================================================
+// RECEIPT
+// ============================================================================
+exports.receiptLineItemSchema = zod_1.z.object({
+    description: zod_1.z.string(),
+    amount: zod_1.z.number(),
+    taxAmount: zod_1.z.number(),
+    total: zod_1.z.number(),
+});
+exports.receiptSchema = zod_1.z.object({
+    receiptNumber: zod_1.z.string(),
+    paymentId: common_2.uuidSchema,
+    invoiceNumber: zod_1.z.string(),
+    transactionId: zod_1.z.string(),
+    studentName: zod_1.z.string(),
+    studentId: common_2.uuidSchema,
+    schoolName: zod_1.z.string(),
+    schoolAddress: zod_1.z.string().optional(),
+    schoolPhone: zod_1.z.string().optional(),
+    paidDate: zod_1.z.string(),
+    amount: zod_1.z.number(),
+    currency: common_1.currencyEnum,
+    gateway: common_1.paymentGatewayEnum,
+    gatewayDisplayName: zod_1.z.string(),
+    lineItems: zod_1.z.array(exports.receiptLineItemSchema),
+    subtotal: zod_1.z.number(),
+    taxTotal: zod_1.z.number(),
+    discountTotal: zod_1.z.number(),
+    grandTotal: zod_1.z.number(),
+    taxBreakdown: zod_1.z.object({
+        panNumber: zod_1.z.string().optional(),
+        vatNumber: zod_1.z.string().optional(),
+        taxableAmount: zod_1.z.number(),
+        taxAmount: zod_1.z.number(),
+    }),
+    paidBy: zod_1.z.string(),
+    notes: zod_1.z.string().optional(),
+});
+// ============================================================================
+// PAYMENT FILTER
+// ============================================================================
+exports.paymentFilterSchema = zod_1.z.object({
+    status: zod_1.z.union([common_1.paymentStatusEnum, zod_1.z.array(common_1.paymentStatusEnum)]).optional(),
+    gateway: common_1.paymentGatewayEnum.optional(),
+    invoiceId: common_2.uuidSchema.optional(),
+    studentId: common_2.uuidSchema.optional(),
+    dateFrom: zod_1.z.string().optional(),
+    dateTo: zod_1.z.string().optional(),
+});
+// ============================================================================
+// CURRENCY FORMATTING
+// ============================================================================
+exports.currencyFormatOptionsSchema = zod_1.z.object({
+    locale: zod_1.z.enum(['en', 'ne']).default('en'),
+    showSymbol: zod_1.z.boolean().default(true),
+    decimals: zod_1.z.number().int().min(0).max(4).default(2),
+});
+//# sourceMappingURL=payment.schema.js.map

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

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

package/dist/schemas/finance/student-account.schema.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Student Account & Ledger Schemas
+ *
+ * Tracks a student's financial ledger within a school.
+ * One account per student per school.
+ */
+import { z } from 'zod';
+export declare const billingAccountResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    studentId: z.ZodString;
+    schoolId: z.ZodString;
+    studentName: z.ZodString;
+    balance: z.ZodNumber;
+    totalPaid: z.ZodNumber;
+    lastPaymentDate: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    createdAt: string;
+    updatedAt: string;
+    schoolId: string;
+    studentId: string;
+    id: string;
+    studentName: string;
+    balance: number;
+    totalPaid: number;
+    lastPaymentDate: string | null;
+}, {
+    createdAt: string;
+    updatedAt: string;
+    schoolId: string;
+    studentId: string;
+    id: string;
+    studentName: string;
+    balance: number;
+    totalPaid: number;
+    lastPaymentDate: string | null;
+}>;
+export type BillingAccount = z.infer<typeof billingAccountResponseSchema>;
+export declare const studentAccountFilterSchema: z.ZodObject<{
+    studentId: z.ZodOptional<z.ZodString>;
+    hasOutstandingBalance: z.ZodOptional<z.ZodBoolean>;
+    searchTerm: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    studentId?: string | undefined;
+    searchTerm?: string | undefined;
+    hasOutstandingBalance?: boolean | undefined;
+}, {
+    studentId?: string | undefined;
+    searchTerm?: string | undefined;
+    hasOutstandingBalance?: boolean | undefined;
+}>;
+export type StudentAccountFilterDto = z.infer<typeof studentAccountFilterSchema>;
+export declare const studentLedgerEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    studentAccountId: z.ZodString;
+    entryType: z.ZodEnum<["invoice", "payment", "refund", "adjustment", "write_off"]>;
+    referenceId: z.ZodString;
+    description: z.ZodString;
+    debit: z.ZodNumber;
+    credit: z.ZodNumber;
+    balance: z.ZodNumber;
+    date: z.ZodString;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    createdAt: string;
+    date: string;
+    description: string;
+    id: string;
+    studentAccountId: string;
+    balance: number;
+    entryType: "invoice" | "payment" | "refund" | "adjustment" | "write_off";
+    referenceId: string;
+    debit: number;
+    credit: number;
+}, {
+    createdAt: string;
+    date: string;
+    description: string;
+    id: string;
+    studentAccountId: string;
+    balance: number;
+    entryType: "invoice" | "payment" | "refund" | "adjustment" | "write_off";
+    referenceId: string;
+    debit: number;
+    credit: number;
+}>;
+export type StudentLedgerEntry = z.infer<typeof studentLedgerEntrySchema>;
+//# sourceMappingURL=student-account.schema.d.ts.map

package/dist/schemas/finance/student-account.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"student-account.schema.d.ts","sourceRoot":"","sources":["../../../src/schemas/finance/student-account.schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUvC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAM1E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAIrC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAMjF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/schemas/finance/student-account.schema.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Student Account & Ledger Schemas
+ *
+ * Tracks a student's financial ledger within a school.
+ * One account per student per school.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.studentLedgerEntrySchema = exports.studentAccountFilterSchema = exports.billingAccountResponseSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("./common");
+const common_2 = require("../common");
+// ============================================================================
+// STUDENT ACCOUNT RESPONSE
+// ============================================================================
+exports.billingAccountResponseSchema = zod_1.z.object({
+    id: common_2.uuidSchema,
+    studentId: common_2.uuidSchema,
+    schoolId: common_2.uuidSchema,
+    studentName: zod_1.z.string(),
+    balance: zod_1.z.number(),
+    totalPaid: zod_1.z.number(),
+    lastPaymentDate: zod_1.z.string().nullable(),
+    createdAt: zod_1.z.string(),
+    updatedAt: zod_1.z.string(),
+});
+// ============================================================================
+// STUDENT ACCOUNT FILTER
+// ============================================================================
+exports.studentAccountFilterSchema = zod_1.z.object({
+    studentId: common_2.uuidSchema.optional(),
+    hasOutstandingBalance: zod_1.z.coerce.boolean().optional(),
+    searchTerm: zod_1.z.string().max(100).optional(),
+});
+// ============================================================================
+// LEDGER ENTRY
+// ============================================================================
+exports.studentLedgerEntrySchema = zod_1.z.object({
+    id: common_2.uuidSchema,
+    studentAccountId: common_2.uuidSchema,
+    entryType: common_1.ledgerEntryTypeEnum,
+    referenceId: zod_1.z.string(),
+    description: zod_1.z.string(),
+    debit: zod_1.z.number().min(0),
+    credit: zod_1.z.number().min(0),
+    balance: zod_1.z.number(),
+    date: zod_1.z.string(),
+    createdAt: zod_1.z.string(),
+});
+//# sourceMappingURL=student-account.schema.js.map

package/dist/schemas/finance/student-account.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"student-account.schema.js","sourceRoot":"","sources":["../../../src/schemas/finance/student-account.schema.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,6BAAwB;AACxB,qCAA+C;AAC/C,sCAAuC;AAEvC,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAElE,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,EAAE,EAAE,mBAAU;IACd,SAAS,EAAE,mBAAU;IACrB,QAAQ,EAAE,mBAAU;IACpB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAIH,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAElE,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,SAAS,EAAE,mBAAU,CAAC,QAAQ,EAAE;IAChC,qBAAqB,EAAE,OAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpD,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAIH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAElE,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,EAAE,EAAE,mBAAU;IACd,gBAAgB,EAAE,mBAAU;IAC5B,SAAS,EAAE,4BAAmB;IAC9B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC"}

package/dist/schemas/index.d.ts

@@ -7,4 +7,5 @@ export * from './common';
 export * from './identity';
 export * from './academics';
 export * from './enrollment';
+export * from './finance';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/schemas/index.js

@@ -23,4 +23,5 @@ __exportStar(require("./common"), exports);
 __exportStar(require("./identity"), exports);
 __exportStar(require("./academics"), exports);
 __exportStar(require("./enrollment"), exports);
+__exportStar(require("./finance"), exports);
 //# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,2CAAyB;AACzB,6CAA2B;AAC3B,8CAA4B;AAC5B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,2CAAyB;AACzB,6CAA2B;AAC3B,8CAA4B;AAC5B,+CAA6B;AAC7B,4CAA0B"}

package/dist/utils/currency.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Currency Formatting Utilities
+ *
+ * NPR formatting with Nepal-style lakh/crore grouping.
+ * Pure utility functions — NOT in schema files.
+ */
+interface CurrencyFormatOpts {
+    locale?: 'en' | 'ne';
+    showSymbol?: boolean;
+    decimals?: number;
+}
+/**
+ * Format an amount as NPR currency string.
+ * Uses Nepal's number formatting (commas at lakh/crore positions).
+ *
+ * Examples:
+ *   formatNPR(12500)      → "NPR 12,500.00"
+ *   formatNPR(12500, { locale: 'ne', showSymbol: true }) → "रू १२,५००.००"
+ *   formatNPR(150000)     → "NPR 1,50,000.00" (lakh grouping)
+ */
+export declare function formatNPR(amount: number, options?: CurrencyFormatOpts): string;
+export {};
+//# sourceMappingURL=currency.d.ts.map

package/dist/utils/currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../src/utils/currency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,UAAU,kBAAkB;IAC1B,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CA8BR"}

package/dist/utils/currency.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Currency Formatting Utilities
+ *
+ * NPR formatting with Nepal-style lakh/crore grouping.
+ * Pure utility functions — NOT in schema files.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatNPR = formatNPR;
+/**
+ * Format an amount as NPR currency string.
+ * Uses Nepal's number formatting (commas at lakh/crore positions).
+ *
+ * Examples:
+ *   formatNPR(12500)      → "NPR 12,500.00"
+ *   formatNPR(12500, { locale: 'ne', showSymbol: true }) → "रू १२,५००.००"
+ *   formatNPR(150000)     → "NPR 1,50,000.00" (lakh grouping)
+ */
+function formatNPR(amount, options = {}) {
+    const { locale = 'en', showSymbol = true, decimals = 2 } = options;
+    // Format with Nepal-style grouping (##,##,###.##)
+    const fixed = Math.abs(amount).toFixed(decimals);
+    const [intPart, decPart] = fixed.split('.');
+    // Apply lakh/crore grouping: last 3 digits, then groups of 2
+    let grouped;
+    if (intPart.length <= 3) {
+        grouped = intPart;
+    }
+    else {
+        const last3 = intPart.slice(-3);
+        const rest = intPart.slice(0, -3);
+        const pairs = rest.replace(/\B(?=(\d{2})+(?!\d))/g, ',');
+        grouped = `${pairs},${last3}`;
+    }
+    // Convert digits to Devanagari for Nepali locale
+    let formatted = decPart ? `${grouped}.${decPart}` : grouped;
+    if (locale === 'ne') {
+        formatted = formatted.replace(/[0-9]/g, (d) => String.fromCharCode(0x0966 + Number(d)));
+    }
+    if (amount < 0)
+        formatted = `-${formatted}`;
+    const symbol = locale === 'ne' ? 'रू' : 'NPR';
+    return showSymbol ? `${symbol} ${formatted}` : formatted;
+}
+//# sourceMappingURL=currency.js.map

package/dist/utils/currency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.js","sourceRoot":"","sources":["../../src/utils/currency.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAiBH,8BAiCC;AA1CD;;;;;;;;GAQG;AACH,SAAgB,SAAS,CACvB,MAAc,EACd,UAA8B,EAAE;IAEhC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,QAAQ,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAEnE,kDAAkD;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE5C,6DAA6D;IAC7D,IAAI,OAAe,CAAC;IACpB,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,OAAO,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;QACzD,OAAO,GAAG,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,iDAAiD;IACjD,IAAI,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5D,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5C,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CACxC,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,GAAG,CAAC;QAAE,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;IAE5C,MAAM,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9C,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibrains/shared-types",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "Shared Zod schemas, TypeScript types, and validators for Education data models.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",