law-common 10.63.2-beta.13 → 10.63.2-beta.15

package/dist/src/entities/model/vendor.entity.model.d.ts

@@ -45,16 +45,16 @@ export declare class VendorEntityModel extends BaseEntityModel<EntityEnum.VENDOR
     static readonly VENDOR_ENTITY_DOCUMENT_TYPES: readonly ["pan", "gst"];
     /**
      * Default number of days added to the Invoice Date to calculate the Due Date,
-     * used as a fallback when the Vendor does not have a `dueDays` value configured.
+     * used as a fallback when the Vendor does not have a `paymentDueDays` value configured.
      *
      * @formula
-     * DueDate = InvoiceDate + (vendor.dueDays ?? VendorEntityModel.DEFAULT_DUE_DAYS)
+     * DueDate = InvoiceDate + (vendor.paymentDueDays ?? VendorEntityModel.DEFAULT_DUE_DAYS)
      *
      * @example
-     * vendor.dueDays = 30  → DueDate = InvoiceDate + 30
-     * vendor.dueDays = null → DueDate = InvoiceDate + 7  (this constant)
+     * vendor.paymentDueDays = 30  → DueDate = InvoiceDate + 30
+     * vendor.paymentDueDays = null → DueDate = InvoiceDate + 7  (this constant)
      *
-     * @see VendorEntityModel.dueDays
+     * @see VendorEntityModel.paymentDueDays
      */
     static readonly DEFAULT_DUE_DAYS = 7;
     populateOrganizationTypeModel(organizationTypeEntityModels: OrganizationTypeEntityModel[]): null;

package/dist/src/entities/model/vendor.entity.model.js

@@ -119,16 +119,16 @@ exports.VendorEntityModel = VendorEntityModel;
 VendorEntityModel.VENDOR_ENTITY_DOCUMENT_TYPES = ["pan", "gst"];
 /**
  * Default number of days added to the Invoice Date to calculate the Due Date,
- * used as a fallback when the Vendor does not have a `dueDays` value configured.
+ * used as a fallback when the Vendor does not have a `paymentDueDays` value configured.
  *
  * @formula
- * DueDate = InvoiceDate + (vendor.dueDays ?? VendorEntityModel.DEFAULT_DUE_DAYS)
+ * DueDate = InvoiceDate + (vendor.paymentDueDays ?? VendorEntityModel.DEFAULT_DUE_DAYS)
  *
  * @example
- * vendor.dueDays = 30  → DueDate = InvoiceDate + 30
- * vendor.dueDays = null → DueDate = InvoiceDate + 7  (this constant)
+ * vendor.paymentDueDays = 30  → DueDate = InvoiceDate + 30
+ * vendor.paymentDueDays = null → DueDate = InvoiceDate + 7  (this constant)
  *
- * @see VendorEntityModel.dueDays
+ * @see VendorEntityModel.paymentDueDays
  */
 VendorEntityModel.DEFAULT_DUE_DAYS = 7;
 VendorEntityModel.relationConfigs = [];

package/dist/src/entities/model/vendor_invoice.entity.model.d.ts

@@ -66,4 +66,48 @@ export declare class VendorInvoiceEntityModel extends BaseEntityModel<EntityEnum
     static getTotalNetAmount<T extends {
         netAmount: number;
     }>(data: T[]): number;
+    /**
+     * Generates the next sequential voucher number for a new Vendor Invoice.
+     *
+     * @format
+     * `<FY-1><FY><MM><DD><###>`
+     *
+     * Where:
+     * - `<FY-1><FY>` — 4-digit financial year code (e.g., "2526" for FY 2025–26)
+     * - `<MM>`       — 2-digit month of today's date (e.g., "03" for March)
+     * - `<DD>`       — 2-digit day of today's date (e.g., "27" for 27th)
+     * - `<###>`      — 3-digit sequence number, continuous within the FY (001–999)
+     *
+     * @sequence
+     * The sequence (`###`) is FY-scoped — it does NOT reset daily or monthly.
+     * It only resets when the Financial Year changes.
+     * The next number is always `max(existing sequences in current FY) + 1`.
+     *
+     * @example
+     * // Today: 27 March 2026 (FY 2025–26 → fyCode = "2526")
+     * // Existing vouchers this FY: ["25260326001", "25260326002", "25260120003"]
+     * // maxSequence = 3
+     * // Result:
+     * getNextVoucherNumber(existingInvoices) // → "25260327004"
+     *
+     * @example
+     * // Today: 27 March 2026, No existing vouchers in FY 2025–26
+     * // Result:
+     * getNextVoucherNumber([]) // → "25260327001"
+     *
+     * @example
+     * // FY changes: Today: 01 April 2026 (FY 2026–27 → fyCode = "2627")
+     * // Existing vouchers: ["25260327999"] (from previous FY, ignored)
+     * // Result:
+     * getNextVoucherNumber(existingInvoices) // → "26270401001" (sequence resets)
+     *
+     * @throws {Error} If the sequence reaches 999 within the same FY
+     *
+     * @param existingVendorInvoices - All existing VendorInvoiceEntityModel instances.
+     *   Invoices with undefined/null voucherNo are automatically skipped.
+     *   Invoices from previous FYs are automatically ignored.
+     *
+     * @returns The next voucher number string in format `<FY-1><FY><MM><DD><###>`
+     */
+    static getNextVoucherNumber(existingVendorInvoices: VendorInvoiceEntityModel[]): string;
 }

package/dist/src/entities/model/vendor_invoice.entity.model.js

@@ -119,6 +119,85 @@ class VendorInvoiceEntityModel extends base_entity_model_1.BaseEntityModel {
     static getTotalNetAmount(data) {
         return data.reduce((acc, item) => acc + item.netAmount, 0);
     }
+    /**
+     * Generates the next sequential voucher number for a new Vendor Invoice.
+     *
+     * @format
+     * `<FY-1><FY><MM><DD><###>`
+     *
+     * Where:
+     * - `<FY-1><FY>` — 4-digit financial year code (e.g., "2526" for FY 2025–26)
+     * - `<MM>`       — 2-digit month of today's date (e.g., "03" for March)
+     * - `<DD>`       — 2-digit day of today's date (e.g., "27" for 27th)
+     * - `<###>`      — 3-digit sequence number, continuous within the FY (001–999)
+     *
+     * @sequence
+     * The sequence (`###`) is FY-scoped — it does NOT reset daily or monthly.
+     * It only resets when the Financial Year changes.
+     * The next number is always `max(existing sequences in current FY) + 1`.
+     *
+     * @example
+     * // Today: 27 March 2026 (FY 2025–26 → fyCode = "2526")
+     * // Existing vouchers this FY: ["25260326001", "25260326002", "25260120003"]
+     * // maxSequence = 3
+     * // Result:
+     * getNextVoucherNumber(existingInvoices) // → "25260327004"
+     *
+     * @example
+     * // Today: 27 March 2026, No existing vouchers in FY 2025–26
+     * // Result:
+     * getNextVoucherNumber([]) // → "25260327001"
+     *
+     * @example
+     * // FY changes: Today: 01 April 2026 (FY 2026–27 → fyCode = "2627")
+     * // Existing vouchers: ["25260327999"] (from previous FY, ignored)
+     * // Result:
+     * getNextVoucherNumber(existingInvoices) // → "26270401001" (sequence resets)
+     *
+     * @throws {Error} If the sequence reaches 999 within the same FY
+     *
+     * @param existingVendorInvoices - All existing VendorInvoiceEntityModel instances.
+     *   Invoices with undefined/null voucherNo are automatically skipped.
+     *   Invoices from previous FYs are automatically ignored.
+     *
+     * @returns The next voucher number string in format `<FY-1><FY><MM><DD><###>`
+     */
+    static getNextVoucherNumber(existingVendorInvoices) {
+        // Always use today's date
+        const today = new Date();
+        // Get FY code e.g. "2526"
+        const fyCode = utils_1.DateCodeModel.getFinancialYearCode(today);
+        // Get MM and DD from today
+        const month = String(today.getMonth() + 1).padStart(2, "0");
+        const day = String(today.getDate()).padStart(2, "0");
+        // Base prefix e.g. "25260327"
+        const basePrefix = `${fyCode}${month}${day}`;
+        // Filter out undefined/null voucherNo AND filter only same FY
+        const matchingVoucherNumbers = existingVendorInvoices
+            .map((invoice) => invoice.voucherNo)
+            .filter((voucherNo) => !!voucherNo && voucherNo.startsWith(fyCode));
+        if (matchingVoucherNumbers.length === 0) {
+            return `${basePrefix}001`;
+        }
+        // Extract sequence numbers from ALL vouchers in this FY
+        const sequences = matchingVoucherNumbers
+            .map((voucherNo) => {
+            const match = voucherNo.match(/(\d{3})$/);
+            return match ? parseInt(match[1], 10) : null;
+        })
+            .filter((seq) => seq !== null);
+        if (sequences.length === 0) {
+            return `${basePrefix}001`;
+        }
+        console.log("sequences", sequences);
+        const maxSequence = Math.max(...sequences);
+        console.log("maxSequence", maxSequence);
+        if (maxSequence >= 999) {
+            throw new Error(`Voucher number sequence exhausted for FY ${fyCode}`);
+        }
+        console.log("nextInSquence", `${basePrefix}${String(maxSequence + 1).padStart(3, "0")}`);
+        return `${basePrefix}${String(maxSequence + 1).padStart(3, "0")}`;
+    }
 }
 exports.VendorInvoiceEntityModel = VendorInvoiceEntityModel;
 VendorInvoiceEntityModel.relationConfigs = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "law-common",
-  "version": "10.63.2-beta.13",
+  "version": "10.63.2-beta.15",
   "description": "",
   "main": "dist/index.js",
   "files": [