ayiin 2.0.14 → 2.0.15

package/methods/tools.d.ts

@@ -1,24 +1,67 @@
 declare class Tools {
     /**
-     * Format money
-     * @returns {string}
+     * Format money ke string sesuai locale
      * @memberof Tools
-     * @param {number} amount
-     * */
+     * @param {number} amount - jumlah uang
+     * @param {Intl.LocalesArgument} locales - default "id-ID"
+     * @param {Intl.NumberFormatOptions} options - default currency IDR
+     * @returns {string} string
+     */
     formatMoney: (amount: number, locales?: Intl.LocalesArgument, options?: Intl.NumberFormatOptions) => string;
     /**
-     * Generate a random string
+     * Generate unique ID dengan pilihan tipe
+     * @param {"number"|"string"|"mixed"} type - tipe ID (angka, string, atau campuran)
+     * @param {number} length - panjang ID (default 8)
+     * @returns {string} ID unik acak
+     */
+    uniqueId: ({ type, length, prefix, }: {
+        type?: "number" | "string" | "mixed";
+        length?: number;
+        prefix?: string;
+    }) => string;
+    /**
+     * Generate UUID v4 sederhana
      * @returns {string}
-     * @memberof Tools
-     * @param {number} length
-     * */
-    randomString: (length: number | string, prefix?: string) => string;
+     */
+    randomUuid: () => string;
     /**
      * Pick a random from array
      * @param {T[]} array
      * @memberof Tools
-     * @returns {T}
-     * */
+     * @returns {T} item acak dari array
+     */
     randomItem: <T>(array: T[]) => T | undefined;
+    /**
+     * Ambil beberapa item acak unik dari array
+     * @param {T[]} array
+     * @param {number} count - jumlah item
+     * @returns {T[]} array item acak unik dari array
+     */
+    randomMany: <T>(array: T[], count: number) => T[];
+    /**
+     * Validasi apakah string adalah email
+     * @param {string} str
+     * @returns {boolean} true jika string adalah email, false jika bukan
+     */
+    isEmail: (str: string) => boolean;
+    /**
+     * Validasi apakah string adalah URL
+     * @param {string} str
+     * @returns {boolean} true jika string adalah URL, false jika bukan
+     */
+    isUrl: (str: string) => boolean;
+    /**
+     * Format tanggal ke string sesuai locale
+     * @param {Date} date
+     * @param {Intl.LocalesArgument} locales - default "id-ID"
+     * @returns {string} string
+     */
+    formatDate: (date: Date, locales?: Intl.LocalesArgument) => string;
+    /**
+     * Hitung waktu relatif (misalnya "5 menit lalu")
+     * @param {Date} date
+     * @returns {string} string
+     */
+    timeAgo: (date: Date) => string;
 }
 export default Tools;

package/methods/tools.js

@@ -2,11 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 class Tools {
     /**
-     * Format money
-     * @returns {string}
+     * Format money ke string sesuai locale
      * @memberof Tools
-     * @param {number} amount
-     * */
+     * @param {number} amount - jumlah uang
+     * @param {Intl.LocalesArgument} locales - default "id-ID"
+     * @param {Intl.NumberFormatOptions} options - default currency IDR
+     * @returns {string} string
+     */
     formatMoney = (amount, locales = "id-ID", options = {
         style: "currency",
         currency: "IDR",
@@ -15,27 +17,115 @@ class Tools {
         return new Intl.NumberFormat(locales, options).format(amount);
     };
     /**
-     * Generate a random string
-     * @returns {string}
-     * @memberof Tools
-     * @param {number} length
-     * */
-    randomString = (length, prefix) => {
-        const alphabet = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
-        let random = "";
-        for (let i = 0; i < Number(length); i++) {
-            random += alphabet[Math.floor(Math.random() * alphabet.length)];
+     * Generate unique ID dengan pilihan tipe
+     * @param {"number"|"string"|"mixed"} type - tipe ID (angka, string, atau campuran)
+     * @param {number} length - panjang ID (default 8)
+     * @returns {string} ID unik acak
+     */
+    uniqueId = ({ type = "mixed", length = 8, prefix, }) => {
+        let chars;
+        switch (type) {
+            case "number":
+                chars = "0123456789";
+                break;
+            case "string":
+                chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+                break;
+            default:
+                chars =
+                    "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
         }
-        return prefix ? prefix + random : random;
+        let id = "";
+        for (let i = 0; i < length; i++) {
+            id += chars[Math.floor(Math.random() * chars.length)];
+        }
+        return prefix ? prefix + id : id;
+    };
+    /**
+     * Generate UUID v4 sederhana
+     * @returns {string}
+     */
+    randomUuid = () => {
+        return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+            const r = (Math.random() * 16) | 0;
+            const v = c === "x" ? r : (r & 0x3) | 0x8;
+            return v.toString(16);
+        });
     };
     /**
      * Pick a random from array
      * @param {T[]} array
      * @memberof Tools
-     * @returns {T}
-     * */
+     * @returns {T} item acak dari array
+     */
     randomItem = (array) => {
         return array[Math.floor(Math.random() * array.length)];
     };
+    /**
+     * Ambil beberapa item acak unik dari array
+     * @param {T[]} array
+     * @param {number} count - jumlah item
+     * @returns {T[]} array item acak unik dari array
+     */
+    randomMany = (array, count) => {
+        const copy = [...array];
+        for (let i = copy.length - 1; i > 0; i--) {
+            const j = Math.floor(Math.random() * (i + 1));
+            [copy[i], copy[j]] = [copy[j], copy[i]];
+        }
+        return copy.slice(0, count);
+    };
+    /**
+     * Validasi apakah string adalah email
+     * @param {string} str
+     * @returns {boolean} true jika string adalah email, false jika bukan
+     */
+    isEmail = (str) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(str);
+    /**
+     * Validasi apakah string adalah URL
+     * @param {string} str
+     * @returns {boolean} true jika string adalah URL, false jika bukan
+     */
+    isUrl = (str) => {
+        try {
+            new URL(str);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    /**
+     * Format tanggal ke string sesuai locale
+     * @param {Date} date
+     * @param {Intl.LocalesArgument} locales - default "id-ID"
+     * @returns {string} string
+     */
+    formatDate = (date, locales = "id-ID") => new Intl.DateTimeFormat(locales, {
+        year: "numeric",
+        month: "long",
+        day: "numeric",
+        hour: "2-digit",
+        minute: "2-digit",
+    }).format(date);
+    /**
+     * Hitung waktu relatif (misalnya "5 menit lalu")
+     * @param {Date} date
+     * @returns {string} string
+     */
+    timeAgo = (date) => {
+        const diff = Date.now() - date.getTime();
+        const seconds = Math.floor(diff / 1000);
+        if (seconds < 60)
+            return `${seconds} detik lalu`;
+        const minutes = Math.floor(seconds / 60);
+        if (minutes < 60)
+            return `${minutes} menit lalu`;
+        const hours = Math.floor(minutes / 60);
+        if (hours < 24)
+            return `${hours} jam lalu`;
+        const days = Math.floor(hours / 24);
+        return `${days} hari lalu`;
+    };
 }
 exports.default = Tools;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ayiin",
-  "version": "2.0.14",
+  "version": "2.0.15",
   "description": "Library Pribadi Yang Gak Ada Isinya",
   "main": "index.js",
   "bin": {