@misterhomer1992/miit-bot-payment 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,245 @@
+# @miit-bot/payment-utils
+
+A TypeScript utility library for payment validation and formatting. This library provides robust validation for credit card numbers, payment amounts, CVV codes, and formatting utilities for displaying payment information.
+
+## Features
+
+- 💳 Credit card validation with Luhn algorithm
+- 🏦 Automatic card type detection (Visa, Mastercard, Amex, Discover)
+- 💰 Payment amount validation with customizable limits
+- 🔒 CVV/CVC validation
+- 🎨 Card number formatting and masking
+- 🌍 Currency formatting with internationalization support
+- 📅 Expiry date formatting
+- 🔧 Written in TypeScript with full type definitions
+- ✅ Zero dependencies (dev dependencies only)
+
+## Installation
+
+```bash
+npm install @miit-bot/payment-utils
+```
+
+or
+
+```bash
+yarn add @miit-bot/payment-utils
+```
+
+## Usage
+
+### Card Validation
+
+```typescript
+import { validateCardNumber, CardType } from '@miit-bot/payment-utils';
+
+// Validate a credit card number
+const result = validateCardNumber('4532015112830366');
+console.log(result);
+// {
+//   isValid: true,
+//   cardType: 'VISA',
+//   message: 'Valid card number'
+// }
+```
+
+### Amount Validation
+
+```typescript
+import { validateAmount } from '@miit-bot/payment-utils';
+
+// Validate payment amount
+const result = validateAmount(99.99);
+console.log(result);
+// {
+//   isValid: true,
+//   amount: 99.99,
+//   message: 'Valid amount'
+// }
+
+// With custom limits
+const customResult = validateAmount(150.0, 10, 100);
+console.log(customResult);
+// {
+//   isValid: false,
+//   amount: 150,
+//   message: 'Amount must not exceed 100'
+// }
+```
+
+### CVV Validation
+
+```typescript
+import { validateCVV, CardType } from '@miit-bot/payment-utils';
+
+// Validate CVV
+const isValid = validateCVV('123'); // true
+
+// Validate Amex CVV (4 digits)
+const isValidAmex = validateCVV('1234', CardType.AMEX); // true
+```
+
+### Card Formatting
+
+```typescript
+import { formatCardNumber, maskCardNumber } from '@miit-bot/payment-utils';
+
+// Format card number with spaces
+const formatted = formatCardNumber('4532015112830366');
+console.log(formatted); // '4532 0151 1283 0366'
+
+// Format and mask
+const masked = formatCardNumber('4532015112830366', true);
+console.log(masked); // '**** **** **** 0366'
+
+// Custom masking
+const customMask = maskCardNumber('4532015112830366', 4, 'X');
+console.log(customMask); // 'XXXXXXXXXXXX0366'
+```
+
+### Currency Formatting
+
+```typescript
+import { formatCurrency } from '@miit-bot/payment-utils';
+
+// Format as USD
+const usd = formatCurrency(1234.56);
+console.log(usd); // '$1,234.56'
+
+// Format with custom locale and currency
+const eur = formatCurrency(1234.56, {
+  locale: 'de-DE',
+  currency: 'EUR',
+});
+console.log(eur); // '1.234,56 €'
+```
+
+### Expiry Date Formatting
+
+```typescript
+import { formatExpiryDate } from '@miit-bot/payment-utils';
+
+// Format expiry date
+const expiry = formatExpiryDate(12, 2025);
+console.log(expiry); // '12/25'
+```
+
+## API Reference
+
+### Types
+
+#### CardType
+
+```typescript
+enum CardType {
+  VISA = 'VISA',
+  MASTERCARD = 'MASTERCARD',
+  AMEX = 'AMEX',
+  DISCOVER = 'DISCOVER',
+  UNKNOWN = 'UNKNOWN',
+}
+```
+
+#### CardValidationResult
+
+```typescript
+interface CardValidationResult {
+  isValid: boolean;
+  cardType: CardType;
+  message?: string;
+}
+```
+
+#### AmountValidationResult
+
+```typescript
+interface AmountValidationResult {
+  isValid: boolean;
+  amount?: number;
+  message?: string;
+}
+```
+
+### Validators
+
+#### validateCardNumber(cardNumber: string): CardValidationResult
+
+Validates a credit card number using the Luhn algorithm and detects the card type.
+
+#### validateAmount(amount: string | number, minAmount?: number, maxAmount?: number): AmountValidationResult
+
+Validates a payment amount with optional min/max limits. Defaults: min=0.01, max=999999.99
+
+#### validateCVV(cvv: string, cardType?: CardType): boolean
+
+Validates a CVV/CVC code. Returns true if valid (3 digits for most cards, 4 for Amex).
+
+### Formatters
+
+#### formatCardNumber(cardNumber: string, maskDigits?: boolean): string
+
+Formats a card number with spaces. Optionally masks all but the last 4 digits.
+
+#### formatCurrency(amount: number, options?: CurrencyFormatOptions): string
+
+Formats a number as currency with internationalization support.
+
+#### maskCardNumber(cardNumber: string, visibleDigits?: number, maskChar?: string): string
+
+Masks a card number showing only the last N digits.
+
+#### formatExpiryDate(month: number, year: number): string
+
+Formats an expiry date to MM/YY format.
+
+## Development
+
+### Setup
+
+```bash
+# Install dependencies
+npm install
+
+# Build the library
+npm run build
+
+# Run linter
+npm run lint
+
+# Format code
+npm run format
+
+# Watch mode for development
+npm run watch
+```
+
+### Building
+
+The library is built using TypeScript compiler. The build output is in the `dist` folder with:
+
+- Compiled JavaScript files
+- Type declaration files (.d.ts)
+- Source maps
+
+### Publishing
+
+```bash
+# Build and publish to npm
+npm publish
+```
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Author
+
+Your Name
+
+## Repository
+
+https://github.com/yourusername/miit-bot-payment

package/dist/formatters.d.ts

@@ -0,0 +1,31 @@
+import { CurrencyFormatOptions } from './types';
+/**
+ * Formats a credit card number for display (e.g., "1234 5678 9012 3456")
+ * @param cardNumber - The card number to format
+ * @param maskDigits - Whether to mask all but the last 4 digits
+ * @returns Formatted card number
+ */
+export declare function formatCardNumber(cardNumber: string, maskDigits?: boolean): string;
+/**
+ * Formats an amount as currency
+ * @param amount - The amount to format
+ * @param options - Formatting options
+ * @returns Formatted currency string
+ */
+export declare function formatCurrency(amount: number, options?: CurrencyFormatOptions): string;
+/**
+ * Masks a card number showing only the last N digits
+ * @param cardNumber - The card number to mask
+ * @param visibleDigits - Number of digits to show (default: 4)
+ * @param maskChar - Character to use for masking (default: '*')
+ * @returns Masked card number
+ */
+export declare function maskCardNumber(cardNumber: string, visibleDigits?: number, maskChar?: string): string;
+/**
+ * Formats an expiry date to MM/YY format
+ * @param month - Month (1-12)
+ * @param year - Year (full year or last 2 digits)
+ * @returns Formatted expiry date
+ */
+export declare function formatExpiryDate(month: number, year: number): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,GAAE,OAAe,GAAG,MAAM,CAUxF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAc1F;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,aAAa,GAAE,MAAU,EACzB,QAAQ,GAAE,MAAY,GACrB,MAAM,CAWR;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpE"}

package/dist/formatters.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatCardNumber = formatCardNumber;
+exports.formatCurrency = formatCurrency;
+exports.maskCardNumber = maskCardNumber;
+exports.formatExpiryDate = formatExpiryDate;
+/**
+ * Formats a credit card number for display (e.g., "1234 5678 9012 3456")
+ * @param cardNumber - The card number to format
+ * @param maskDigits - Whether to mask all but the last 4 digits
+ * @returns Formatted card number
+ */
+function formatCardNumber(cardNumber, maskDigits = false) {
+    const cleanedNumber = cardNumber.replace(/[\s-]/g, '');
+    if (maskDigits && cleanedNumber.length > 4) {
+        const lastFour = cleanedNumber.slice(-4);
+        const masked = '*'.repeat(cleanedNumber.length - 4);
+        return (masked + lastFour).replace(/(.{4})/g, '$1 ').trim();
+    }
+    return cleanedNumber.replace(/(.{4})/g, '$1 ').trim();
+}
+/**
+ * Formats an amount as currency
+ * @param amount - The amount to format
+ * @param options - Formatting options
+ * @returns Formatted currency string
+ */
+function formatCurrency(amount, options = {}) {
+    const { locale = 'en-US', currency = 'USD', minimumFractionDigits = 2, maximumFractionDigits = 2, } = options;
+    return new Intl.NumberFormat(locale, {
+        style: 'currency',
+        currency,
+        minimumFractionDigits,
+        maximumFractionDigits,
+    }).format(amount);
+}
+/**
+ * Masks a card number showing only the last N digits
+ * @param cardNumber - The card number to mask
+ * @param visibleDigits - Number of digits to show (default: 4)
+ * @param maskChar - Character to use for masking (default: '*')
+ * @returns Masked card number
+ */
+function maskCardNumber(cardNumber, visibleDigits = 4, maskChar = '*') {
+    const cleanedNumber = cardNumber.replace(/[\s-]/g, '');
+    if (cleanedNumber.length <= visibleDigits) {
+        return cleanedNumber;
+    }
+    const visiblePart = cleanedNumber.slice(-visibleDigits);
+    const maskedPart = maskChar.repeat(cleanedNumber.length - visibleDigits);
+    return maskedPart + visiblePart;
+}
+/**
+ * Formats an expiry date to MM/YY format
+ * @param month - Month (1-12)
+ * @param year - Year (full year or last 2 digits)
+ * @returns Formatted expiry date
+ */
+function formatExpiryDate(month, year) {
+    const monthStr = month.toString().padStart(2, '0');
+    const yearStr = year >= 2000 ? (year % 100).toString().padStart(2, '0') : year.toString().padStart(2, '0');
+    return `${monthStr}/${yearStr}`;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":";;AAQA,4CAUC;AAQD,wCAcC;AASD,wCAeC;AAQD,4CAMC;AA5ED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,UAAkB,EAAE,aAAsB,KAAK;IAC9E,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEvD,IAAI,UAAU,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACpD,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,CAAC;IAED,OAAO,aAAa,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,MAAc,EAAE,UAAiC,EAAE;IAChF,MAAM,EACJ,MAAM,GAAG,OAAO,EAChB,QAAQ,GAAG,KAAK,EAChB,qBAAqB,GAAG,CAAC,EACzB,qBAAqB,GAAG,CAAC,GAC1B,GAAG,OAAO,CAAC;IAEZ,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;QACnC,KAAK,EAAE,UAAU;QACjB,QAAQ;QACR,qBAAqB;QACrB,qBAAqB;KACtB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,UAAkB,EAClB,gBAAwB,CAAC,EACzB,WAAmB,GAAG;IAEtB,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEvD,IAAI,aAAa,CAAC,MAAM,IAAI,aAAa,EAAE,CAAC;QAC1C,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;IAEzE,OAAO,UAAU,GAAG,WAAW,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,KAAa,EAAE,IAAY;IAC1D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,OAAO,GACX,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE7F,OAAO,GAAG,QAAQ,IAAI,OAAO,EAAE,CAAC;AAClC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @miit-bot/payment-utils
+ * A TypeScript utility library for payment validation and formatting
+ */
+export * from './types';
+export { validateCardNumber, validateAmount, validateCVV } from './validators';
+export { formatCardNumber, formatCurrency, maskCardNumber, formatExpiryDate } from './formatters';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG/E,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * @miit-bot/payment-utils
+ * A TypeScript utility library for payment validation and formatting
+ */
+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 });
+exports.formatExpiryDate = exports.maskCardNumber = exports.formatCurrency = exports.formatCardNumber = exports.validateCVV = exports.validateAmount = exports.validateCardNumber = void 0;
+// Export types
+__exportStar(require("./types"), exports);
+// Export validators
+var validators_1 = require("./validators");
+Object.defineProperty(exports, "validateCardNumber", { enumerable: true, get: function () { return validators_1.validateCardNumber; } });
+Object.defineProperty(exports, "validateAmount", { enumerable: true, get: function () { return validators_1.validateAmount; } });
+Object.defineProperty(exports, "validateCVV", { enumerable: true, get: function () { return validators_1.validateCVV; } });
+// Export formatters
+var formatters_1 = require("./formatters");
+Object.defineProperty(exports, "formatCardNumber", { enumerable: true, get: function () { return formatters_1.formatCardNumber; } });
+Object.defineProperty(exports, "formatCurrency", { enumerable: true, get: function () { return formatters_1.formatCurrency; } });
+Object.defineProperty(exports, "maskCardNumber", { enumerable: true, get: function () { return formatters_1.maskCardNumber; } });
+Object.defineProperty(exports, "formatExpiryDate", { enumerable: true, get: function () { return formatters_1.formatExpiryDate; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,eAAe;AACf,0CAAwB;AAExB,oBAAoB;AACpB,2CAA+E;AAAtE,gHAAA,kBAAkB,OAAA;AAAE,4GAAA,cAAc,OAAA;AAAE,yGAAA,WAAW,OAAA;AAExD,oBAAoB;AACpB,2CAAkG;AAAzF,8GAAA,gBAAgB,OAAA;AAAE,4GAAA,cAAc,OAAA;AAAE,4GAAA,cAAc,OAAA;AAAE,8GAAA,gBAAgB,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Supported credit card types
+ */
+export declare enum CardType {
+    VISA = "VISA",
+    MASTERCARD = "MASTERCARD",
+    AMEX = "AMEX",
+    DISCOVER = "DISCOVER",
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * Credit card validation result
+ */
+export interface CardValidationResult {
+    isValid: boolean;
+    cardType: CardType;
+    message?: string;
+}
+/**
+ * Currency formatting options
+ */
+export interface CurrencyFormatOptions {
+    locale?: string;
+    currency?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+}
+/**
+ * Payment amount validation result
+ */
+export interface AmountValidationResult {
+    isValid: boolean;
+    amount?: number;
+    message?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IAClB,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardType = void 0;
+/**
+ * Supported credit card types
+ */
+var CardType;
+(function (CardType) {
+    CardType["VISA"] = "VISA";
+    CardType["MASTERCARD"] = "MASTERCARD";
+    CardType["AMEX"] = "AMEX";
+    CardType["DISCOVER"] = "DISCOVER";
+    CardType["UNKNOWN"] = "UNKNOWN";
+})(CardType || (exports.CardType = CardType = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,qCAAyB,CAAA;IACzB,yBAAa,CAAA;IACb,iCAAqB,CAAA;IACrB,+BAAmB,CAAA;AACrB,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB"}

package/dist/validators.d.ts

@@ -0,0 +1,23 @@
+import { CardType, CardValidationResult, AmountValidationResult } from './types';
+/**
+ * Validates a credit card number using the Luhn algorithm
+ * @param cardNumber - The credit card number to validate
+ * @returns Validation result with card type
+ */
+export declare function validateCardNumber(cardNumber: string): CardValidationResult;
+/**
+ * Validates a payment amount
+ * @param amount - The amount to validate (string or number)
+ * @param minAmount - Minimum allowed amount (default: 0.01)
+ * @param maxAmount - Maximum allowed amount (default: 999999.99)
+ * @returns Validation result
+ */
+export declare function validateAmount(amount: string | number, minAmount?: number, maxAmount?: number): AmountValidationResult;
+/**
+ * Validates a CVV/CVC code
+ * @param cvv - The CVV code to validate
+ * @param cardType - The card type (AMEX uses 4 digits, others use 3)
+ * @returns Whether the CVV is valid
+ */
+export declare function validateCVV(cvv: string, cardType?: CardType): boolean;
+//# sourceMappingURL=validators.d.ts.map

package/dist/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAiC3E;AA6DD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,SAAS,GAAE,MAAa,EACxB,SAAS,GAAE,MAAkB,GAC5B,sBAAsB,CAyCxB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,QAA2B,GAAG,OAAO,CAYvF"}

package/dist/validators.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateCardNumber = validateCardNumber;
+exports.validateAmount = validateAmount;
+exports.validateCVV = validateCVV;
+const types_1 = require("./types");
+/**
+ * Validates a credit card number using the Luhn algorithm
+ * @param cardNumber - The credit card number to validate
+ * @returns Validation result with card type
+ */
+function validateCardNumber(cardNumber) {
+    // Remove spaces and dashes
+    const cleanedNumber = cardNumber.replace(/[\s-]/g, '');
+    // Check if it contains only digits
+    if (!/^\d+$/.test(cleanedNumber)) {
+        return {
+            isValid: false,
+            cardType: types_1.CardType.UNKNOWN,
+            message: 'Card number must contain only digits',
+        };
+    }
+    // Check length (most cards are 13-19 digits)
+    if (cleanedNumber.length < 13 || cleanedNumber.length > 19) {
+        return {
+            isValid: false,
+            cardType: types_1.CardType.UNKNOWN,
+            message: 'Invalid card number length',
+        };
+    }
+    // Determine card type
+    const cardType = detectCardType(cleanedNumber);
+    // Luhn algorithm validation
+    const isValidLuhn = luhnCheck(cleanedNumber);
+    return {
+        isValid: isValidLuhn,
+        cardType,
+        message: isValidLuhn ? 'Valid card number' : 'Invalid card number (failed Luhn check)',
+    };
+}
+/**
+ * Performs Luhn algorithm check
+ * @param cardNumber - The card number to check
+ * @returns Whether the card passes the Luhn check
+ */
+function luhnCheck(cardNumber) {
+    let sum = 0;
+    let isEven = false;
+    // Loop through values starting from the rightmost digit
+    for (let i = cardNumber.length - 1; i >= 0; i--) {
+        let digit = parseInt(cardNumber[i], 10);
+        if (isEven) {
+            digit *= 2;
+            if (digit > 9) {
+                digit -= 9;
+            }
+        }
+        sum += digit;
+        isEven = !isEven;
+    }
+    return sum % 10 === 0;
+}
+/**
+ * Detects the card type based on the card number
+ * @param cardNumber - The card number
+ * @returns The detected card type
+ */
+function detectCardType(cardNumber) {
+    // Visa: starts with 4
+    if (/^4/.test(cardNumber)) {
+        return types_1.CardType.VISA;
+    }
+    // Mastercard: starts with 51-55 or 2221-2720
+    if (/^5[1-5]/.test(cardNumber) ||
+        /^2(22[1-9]|2[3-9]\d|[3-6]\d{2}|7[01]\d|720)/.test(cardNumber)) {
+        return types_1.CardType.MASTERCARD;
+    }
+    // American Express: starts with 34 or 37
+    if (/^3[47]/.test(cardNumber)) {
+        return types_1.CardType.AMEX;
+    }
+    // Discover: starts with 6011, 622126-622925, 644-649, or 65
+    if (/^(6011|65|64[4-9]|622)/.test(cardNumber)) {
+        return types_1.CardType.DISCOVER;
+    }
+    return types_1.CardType.UNKNOWN;
+}
+/**
+ * Validates a payment amount
+ * @param amount - The amount to validate (string or number)
+ * @param minAmount - Minimum allowed amount (default: 0.01)
+ * @param maxAmount - Maximum allowed amount (default: 999999.99)
+ * @returns Validation result
+ */
+function validateAmount(amount, minAmount = 0.01, maxAmount = 999999.99) {
+    const parsedAmount = typeof amount === 'string' ? parseFloat(amount) : amount;
+    if (isNaN(parsedAmount)) {
+        return {
+            isValid: false,
+            message: 'Invalid amount: not a number',
+        };
+    }
+    if (parsedAmount < minAmount) {
+        return {
+            isValid: false,
+            amount: parsedAmount,
+            message: `Amount must be at least ${minAmount}`,
+        };
+    }
+    if (parsedAmount > maxAmount) {
+        return {
+            isValid: false,
+            amount: parsedAmount,
+            message: `Amount must not exceed ${maxAmount}`,
+        };
+    }
+    // Check for valid decimal places (max 2)
+    const decimalPlaces = (parsedAmount.toString().split('.')[1] || '').length;
+    if (decimalPlaces > 2) {
+        return {
+            isValid: false,
+            amount: parsedAmount,
+            message: 'Amount must have at most 2 decimal places',
+        };
+    }
+    return {
+        isValid: true,
+        amount: parsedAmount,
+        message: 'Valid amount',
+    };
+}
+/**
+ * Validates a CVV/CVC code
+ * @param cvv - The CVV code to validate
+ * @param cardType - The card type (AMEX uses 4 digits, others use 3)
+ * @returns Whether the CVV is valid
+ */
+function validateCVV(cvv, cardType = types_1.CardType.UNKNOWN) {
+    const cleanedCVV = cvv.trim();
+    if (!/^\d+$/.test(cleanedCVV)) {
+        return false;
+    }
+    if (cardType === types_1.CardType.AMEX) {
+        return cleanedCVV.length === 4;
+    }
+    return cleanedCVV.length === 3;
+}
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@misterhomer1992/miit-bot-payment",
+  "version": "1.0.0",
+  "description": "A TypeScript utility library for payment validation and formatting",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "node --test dist/**/*.test.js",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "watch": "tsc --watch",
+    "example": "ts-node example.ts"
+  },
+  "keywords": [
+    "payment",
+    "validation",
+    "formatting",
+    "typescript",
+    "utilities"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^6.13.0",
+    "@typescript-eslint/parser": "^6.13.0",
+    "eslint": "^8.54.0",
+    "prettier": "^3.1.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.2"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/misterhomer1992/miit-bot-payment.git"
+  },
+  "bugs": {
+    "url": "https://github.com/misterhomer1992/miit-bot-payment/issues"
+  },
+  "homepage": "https://github.com/misterhomer1992/miit-bot-payment#readme"
+}