@awadheshs109/billing 1.0.0

package/README.md

@@ -0,0 +1,18 @@
+
+```
+zentris-billing
+├─ examples
+│  ├─ angular
+│  ├─ javascript
+│  ├─ node
+│  └─ react
+├─ package-lock.json
+├─ package.json
+├─ src
+│  ├─ constants
+│  ├─ core
+│  ├─ models
+│  └─ utils
+└─ tests
+
+```

package/dist/index.d.mts

@@ -0,0 +1,94 @@
+declare function calculateGST(amount: number, percent: number): number;
+declare function calculateTax(amount: number, taxRate: number): number;
+
+declare function calculateDiscount(amount: number, percent: number): number;
+
+type CurrencyType = 'INR' | 'USD' | 'EUR' | 'GBP';
+declare function formatCurrency(amount: number, currency?: CurrencyType): string;
+
+interface Customer {
+    id?: string;
+    name: string;
+    email: string;
+    phone?: string;
+    gstNumber?: string;
+    address?: string;
+}
+
+interface InvoiceItem {
+    name: string;
+    quantity: number;
+    price: number;
+}
+
+interface Invoice {
+    customer: Customer;
+    items: InvoiceItem[];
+    tax: number;
+    discount: number;
+    invoiceId?: string;
+    subtotal?: number;
+    taxAmount?: number;
+    discountAmount?: number;
+    total?: number;
+    generatedDate?: string;
+}
+
+declare function createInvoice(invoice: Invoice): {
+    invoiceId: string;
+    subtotal: number;
+    taxAmount: number;
+    discountAmount: number;
+    total: number;
+    generatedDate: string;
+    customer: Customer;
+    items: InvoiceItem[];
+    tax: number;
+    discount: number;
+};
+
+declare class Billing {
+    static calculateGST: typeof calculateGST;
+    static calculateTax: typeof calculateTax;
+    static calculateDiscount: typeof calculateDiscount;
+    static formatCurrency: typeof formatCurrency;
+    static createInvoice: typeof createInvoice;
+}
+
+declare class BillingError extends Error {
+    constructor(message: string);
+}
+declare class ValidationError extends Error {
+    constructor(message: string);
+}
+declare class InvoiceError extends Error {
+    constructor(message: string);
+}
+
+interface Tax {
+    name?: string;
+    rate: number;
+}
+
+interface BillingSummary {
+    subtotal: number;
+    taxAmount: number;
+    discountAmount: number;
+    total: number;
+}
+
+declare function formatDate(date?: Date, locale?: string): string;
+declare function getCurrentTimestamp(): number;
+
+declare function isValidEmail(email: string): boolean;
+declare function isValidPhone(phone: string): boolean;
+declare function isValidGST(gst: string): boolean;
+
+declare const TAX_RATES: {
+    readonly GST_5: 5;
+    readonly GST_12: 12;
+    readonly GST_18: 18;
+    readonly GST_28: 28;
+};
+
+export { Billing, BillingError, type BillingSummary, type CurrencyType, type Customer, type Invoice, InvoiceError, type InvoiceItem, TAX_RATES, type Tax, ValidationError, calculateDiscount, calculateGST, calculateTax, createInvoice, formatCurrency, formatDate, getCurrentTimestamp, isValidEmail, isValidGST, isValidPhone };

package/dist/index.d.ts

@@ -0,0 +1,94 @@
+declare function calculateGST(amount: number, percent: number): number;
+declare function calculateTax(amount: number, taxRate: number): number;
+
+declare function calculateDiscount(amount: number, percent: number): number;
+
+type CurrencyType = 'INR' | 'USD' | 'EUR' | 'GBP';
+declare function formatCurrency(amount: number, currency?: CurrencyType): string;
+
+interface Customer {
+    id?: string;
+    name: string;
+    email: string;
+    phone?: string;
+    gstNumber?: string;
+    address?: string;
+}
+
+interface InvoiceItem {
+    name: string;
+    quantity: number;
+    price: number;
+}
+
+interface Invoice {
+    customer: Customer;
+    items: InvoiceItem[];
+    tax: number;
+    discount: number;
+    invoiceId?: string;
+    subtotal?: number;
+    taxAmount?: number;
+    discountAmount?: number;
+    total?: number;
+    generatedDate?: string;
+}
+
+declare function createInvoice(invoice: Invoice): {
+    invoiceId: string;
+    subtotal: number;
+    taxAmount: number;
+    discountAmount: number;
+    total: number;
+    generatedDate: string;
+    customer: Customer;
+    items: InvoiceItem[];
+    tax: number;
+    discount: number;
+};
+
+declare class Billing {
+    static calculateGST: typeof calculateGST;
+    static calculateTax: typeof calculateTax;
+    static calculateDiscount: typeof calculateDiscount;
+    static formatCurrency: typeof formatCurrency;
+    static createInvoice: typeof createInvoice;
+}
+
+declare class BillingError extends Error {
+    constructor(message: string);
+}
+declare class ValidationError extends Error {
+    constructor(message: string);
+}
+declare class InvoiceError extends Error {
+    constructor(message: string);
+}
+
+interface Tax {
+    name?: string;
+    rate: number;
+}
+
+interface BillingSummary {
+    subtotal: number;
+    taxAmount: number;
+    discountAmount: number;
+    total: number;
+}
+
+declare function formatDate(date?: Date, locale?: string): string;
+declare function getCurrentTimestamp(): number;
+
+declare function isValidEmail(email: string): boolean;
+declare function isValidPhone(phone: string): boolean;
+declare function isValidGST(gst: string): boolean;
+
+declare const TAX_RATES: {
+    readonly GST_5: 5;
+    readonly GST_12: 12;
+    readonly GST_18: 18;
+    readonly GST_28: 28;
+};
+
+export { Billing, BillingError, type BillingSummary, type CurrencyType, type Customer, type Invoice, InvoiceError, type InvoiceItem, TAX_RATES, type Tax, ValidationError, calculateDiscount, calculateGST, calculateTax, createInvoice, formatCurrency, formatDate, getCurrentTimestamp, isValidEmail, isValidGST, isValidPhone };

package/dist/index.js

@@ -0,0 +1,247 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Billing: () => Billing,
+  BillingError: () => BillingError,
+  InvoiceError: () => InvoiceError,
+  TAX_RATES: () => TAX_RATES,
+  ValidationError: () => ValidationError,
+  calculateDiscount: () => calculateDiscount,
+  calculateGST: () => calculateGST,
+  calculateTax: () => calculateTax,
+  createInvoice: () => createInvoice,
+  formatCurrency: () => formatCurrency,
+  formatDate: () => formatDate,
+  getCurrentTimestamp: () => getCurrentTimestamp,
+  isValidEmail: () => isValidEmail,
+  isValidGST: () => isValidGST,
+  isValidPhone: () => isValidPhone
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/core/errors.ts
+var BillingError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "BillingError";
+  }
+};
+var ValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ValidationError";
+  }
+};
+var InvoiceError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "InvoiceError";
+  }
+};
+
+// src/core/tax.ts
+function calculateGST(amount, percent) {
+  if (amount < 0 || percent < 0) {
+    throw new BillingError(
+      "Amount and GST percentage cannot be negative"
+    );
+  }
+  return Number(
+    (amount * percent / 100).toFixed(2)
+  );
+}
+function calculateTax(amount, taxRate) {
+  if (amount < 0 || taxRate < 0) {
+    throw new BillingError(
+      "Amount and tax cannot be negative"
+    );
+  }
+  return Number(
+    (amount * taxRate / 100).toFixed(2)
+  );
+}
+
+// src/core/discount.ts
+function calculateDiscount(amount, percent) {
+  if (amount < 0 || percent < 0) {
+    throw new BillingError(
+      "Invalid discount values"
+    );
+  }
+  return Number(
+    (amount * percent / 100).toFixed(2)
+  );
+}
+
+// src/core/currency.ts
+var locales = {
+  INR: "en-IN",
+  USD: "en-US",
+  EUR: "de-DE",
+  GBP: "en-GB"
+};
+function formatCurrency(amount, currency = "INR") {
+  return new Intl.NumberFormat(
+    locales[currency],
+    {
+      style: "currency",
+      currency
+    }
+  ).format(amount);
+}
+
+// src/utils/validators.ts
+function isValidEmail(email) {
+  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+}
+function isValidPhone(phone) {
+  return /^[0-9]{10}$/.test(phone);
+}
+function isValidGST(gst) {
+  return /^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z]{1}[1-9A-Z]{1}Z[0-9A-Z]{1}$/i.test(gst);
+}
+
+// src/core/invoice.ts
+var invoiceCounter = 1;
+function generateInvoiceId() {
+  const date = /* @__PURE__ */ new Date();
+  const yyyy = date.getFullYear();
+  const mm = String(
+    date.getMonth() + 1
+  ).padStart(2, "0");
+  const dd = String(
+    date.getDate()
+  ).padStart(2, "0");
+  const count = String(
+    invoiceCounter++
+  ).padStart(6, "0");
+  return `INV-${yyyy}${mm}${dd}-${count}`;
+}
+function validateItems(items) {
+  for (const item of items) {
+    if (item.quantity <= 0) {
+      throw new ValidationError(
+        `Invalid quantity for ${item.name}`
+      );
+    }
+    if (item.price < 0) {
+      throw new ValidationError(
+        `Invalid price for ${item.name}`
+      );
+    }
+  }
+}
+function createInvoice(invoice) {
+  if (!invoice.customer.name) {
+    throw new ValidationError(
+      "Customer name required"
+    );
+  }
+  if (!isValidEmail(
+    invoice.customer.email
+  )) {
+    throw new ValidationError(
+      "Invalid email"
+    );
+  }
+  if (!invoice.items || invoice.items.length === 0) {
+    throw new InvoiceError(
+      "Invoice cannot be empty"
+    );
+  }
+  validateItems(
+    invoice.items
+  );
+  const subtotal = invoice.items.reduce(
+    (sum, item) => {
+      return sum + item.price * item.quantity;
+    },
+    0
+  );
+  const taxAmount = calculateTax(
+    subtotal,
+    invoice.tax
+  );
+  const discountAmount = calculateDiscount(
+    subtotal,
+    invoice.discount
+  );
+  const total = subtotal + taxAmount - discountAmount;
+  return {
+    ...invoice,
+    invoiceId: generateInvoiceId(),
+    subtotal,
+    taxAmount,
+    discountAmount,
+    total: Number(
+      total.toFixed(2)
+    ),
+    generatedDate: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+
+// src/core/billing.ts
+var Billing = class {
+};
+Billing.calculateGST = calculateGST;
+Billing.calculateTax = calculateTax;
+Billing.calculateDiscount = calculateDiscount;
+Billing.formatCurrency = formatCurrency;
+Billing.createInvoice = createInvoice;
+
+// src/utils/date.ts
+function formatDate(date = /* @__PURE__ */ new Date(), locale = "en-IN") {
+  return new Intl.DateTimeFormat(locale, {
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit"
+  }).format(date);
+}
+function getCurrentTimestamp() {
+  return Date.now();
+}
+
+// src/constants/tax-rates.ts
+var TAX_RATES = {
+  GST_5: 5,
+  GST_12: 12,
+  GST_18: 18,
+  GST_28: 28
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Billing,
+  BillingError,
+  InvoiceError,
+  TAX_RATES,
+  ValidationError,
+  calculateDiscount,
+  calculateGST,
+  calculateTax,
+  createInvoice,
+  formatCurrency,
+  formatDate,
+  getCurrentTimestamp,
+  isValidEmail,
+  isValidGST,
+  isValidPhone
+});

package/dist/index.mjs

@@ -0,0 +1,206 @@
+// src/core/errors.ts
+var BillingError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "BillingError";
+  }
+};
+var ValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ValidationError";
+  }
+};
+var InvoiceError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "InvoiceError";
+  }
+};
+
+// src/core/tax.ts
+function calculateGST(amount, percent) {
+  if (amount < 0 || percent < 0) {
+    throw new BillingError(
+      "Amount and GST percentage cannot be negative"
+    );
+  }
+  return Number(
+    (amount * percent / 100).toFixed(2)
+  );
+}
+function calculateTax(amount, taxRate) {
+  if (amount < 0 || taxRate < 0) {
+    throw new BillingError(
+      "Amount and tax cannot be negative"
+    );
+  }
+  return Number(
+    (amount * taxRate / 100).toFixed(2)
+  );
+}
+
+// src/core/discount.ts
+function calculateDiscount(amount, percent) {
+  if (amount < 0 || percent < 0) {
+    throw new BillingError(
+      "Invalid discount values"
+    );
+  }
+  return Number(
+    (amount * percent / 100).toFixed(2)
+  );
+}
+
+// src/core/currency.ts
+var locales = {
+  INR: "en-IN",
+  USD: "en-US",
+  EUR: "de-DE",
+  GBP: "en-GB"
+};
+function formatCurrency(amount, currency = "INR") {
+  return new Intl.NumberFormat(
+    locales[currency],
+    {
+      style: "currency",
+      currency
+    }
+  ).format(amount);
+}
+
+// src/utils/validators.ts
+function isValidEmail(email) {
+  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+}
+function isValidPhone(phone) {
+  return /^[0-9]{10}$/.test(phone);
+}
+function isValidGST(gst) {
+  return /^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z]{1}[1-9A-Z]{1}Z[0-9A-Z]{1}$/i.test(gst);
+}
+
+// src/core/invoice.ts
+var invoiceCounter = 1;
+function generateInvoiceId() {
+  const date = /* @__PURE__ */ new Date();
+  const yyyy = date.getFullYear();
+  const mm = String(
+    date.getMonth() + 1
+  ).padStart(2, "0");
+  const dd = String(
+    date.getDate()
+  ).padStart(2, "0");
+  const count = String(
+    invoiceCounter++
+  ).padStart(6, "0");
+  return `INV-${yyyy}${mm}${dd}-${count}`;
+}
+function validateItems(items) {
+  for (const item of items) {
+    if (item.quantity <= 0) {
+      throw new ValidationError(
+        `Invalid quantity for ${item.name}`
+      );
+    }
+    if (item.price < 0) {
+      throw new ValidationError(
+        `Invalid price for ${item.name}`
+      );
+    }
+  }
+}
+function createInvoice(invoice) {
+  if (!invoice.customer.name) {
+    throw new ValidationError(
+      "Customer name required"
+    );
+  }
+  if (!isValidEmail(
+    invoice.customer.email
+  )) {
+    throw new ValidationError(
+      "Invalid email"
+    );
+  }
+  if (!invoice.items || invoice.items.length === 0) {
+    throw new InvoiceError(
+      "Invoice cannot be empty"
+    );
+  }
+  validateItems(
+    invoice.items
+  );
+  const subtotal = invoice.items.reduce(
+    (sum, item) => {
+      return sum + item.price * item.quantity;
+    },
+    0
+  );
+  const taxAmount = calculateTax(
+    subtotal,
+    invoice.tax
+  );
+  const discountAmount = calculateDiscount(
+    subtotal,
+    invoice.discount
+  );
+  const total = subtotal + taxAmount - discountAmount;
+  return {
+    ...invoice,
+    invoiceId: generateInvoiceId(),
+    subtotal,
+    taxAmount,
+    discountAmount,
+    total: Number(
+      total.toFixed(2)
+    ),
+    generatedDate: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+
+// src/core/billing.ts
+var Billing = class {
+};
+Billing.calculateGST = calculateGST;
+Billing.calculateTax = calculateTax;
+Billing.calculateDiscount = calculateDiscount;
+Billing.formatCurrency = formatCurrency;
+Billing.createInvoice = createInvoice;
+
+// src/utils/date.ts
+function formatDate(date = /* @__PURE__ */ new Date(), locale = "en-IN") {
+  return new Intl.DateTimeFormat(locale, {
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit"
+  }).format(date);
+}
+function getCurrentTimestamp() {
+  return Date.now();
+}
+
+// src/constants/tax-rates.ts
+var TAX_RATES = {
+  GST_5: 5,
+  GST_12: 12,
+  GST_18: 18,
+  GST_28: 28
+};
+export {
+  Billing,
+  BillingError,
+  InvoiceError,
+  TAX_RATES,
+  ValidationError,
+  calculateDiscount,
+  calculateGST,
+  calculateTax,
+  createInvoice,
+  formatCurrency,
+  formatDate,
+  getCurrentTimestamp,
+  isValidEmail,
+  isValidGST,
+  isValidPhone
+};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@awadheshs109/billing",
+  "version": "1.0.0",
+  "description": "Framework-independent TypeScript billing library for Angular, React, Vue, Node.js and JavaScript projects",
+  "author": "Awadhesh Sharma",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "lint": "eslint ."
+  },
+  "keywords": [
+    "billing",
+    "invoice",
+    "gst",
+    "tax",
+    "typescript",
+    "javascript",
+    "react",
+    "angular",
+    "vue",
+    "nodejs"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Awadheshs109/zentris-billing.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Awadheshs109/zentris-billing/issues"
+  },
+  "homepage": "https://github.com/Awadheshs109",
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "eslint": "^10.4.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.22.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  }
+}