@kaiserofthenight/human-js 1.0.0

package/src/utils/helpers.js

@@ -0,0 +1,209 @@
+/**
+ * UTILITY HELPER FUNCTIONS
+ * 
+ * Common utilities for everyday development.
+ */
+
+/**
+ * Generate unique ID
+ */
+export function uid(prefix = 'id') {
+  return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+
+/**
+ * Deep clone object
+ */
+export function clone(obj) {
+  return JSON.parse(JSON.stringify(obj));
+}
+
+/**
+ * Deep merge objects
+ */
+export function merge(...objects) {
+  return objects.reduce((result, obj) => {
+    Object.keys(obj).forEach(key => {
+      if (typeof obj[key] === 'object' && !Array.isArray(obj[key])) {
+        result[key] = merge(result[key] || {}, obj[key]);
+      } else {
+        result[key] = obj[key];
+      }
+    });
+    return result;
+  }, {});
+}
+
+/**
+ * Format date
+ */
+export function formatDate(date, format = 'YYYY-MM-DD') {
+  const d = new Date(date);
+  const year = d.getFullYear();
+  const month = String(d.getMonth() + 1).padStart(2, '0');
+  const day = String(d.getDate()).padStart(2, '0');
+  const hours = String(d.getHours()).padStart(2, '0');
+  const minutes = String(d.getMinutes()).padStart(2, '0');
+  const seconds = String(d.getSeconds()).padStart(2, '0');
+  
+  return format
+    .replace('YYYY', year)
+    .replace('MM', month)
+    .replace('DD', day)
+    .replace('HH', hours)
+    .replace('mm', minutes)
+    .replace('ss', seconds);
+}
+
+/**
+ * Sleep/delay
+ */
+export function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+/**
+ * Capitalize string
+ */
+export function capitalize(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+/**
+ * Truncate string
+ */
+export function truncate(str, length = 50, suffix = '...') {
+  if (str.length <= length) return str;
+  return str.substring(0, length) + suffix;
+}
+
+/**
+ * Random number between min and max
+ */
+export function random(min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+
+/**
+ * Shuffle array
+ */
+export function shuffle(array) {
+  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;
+}
+
+/**
+ * Group array by key
+ */
+export function groupBy(array, key) {
+  return array.reduce((result, item) => {
+    const group = typeof key === 'function' ? key(item) : item[key];
+    if (!result[group]) result[group] = [];
+    result[group].push(item);
+    return result;
+  }, {});
+}
+
+/**
+ * Unique array values
+ */
+export function unique(array) {
+  return [...new Set(array)];
+}
+
+/**
+ * Check if object is empty
+ */
+export function isEmpty(obj) {
+  if (obj === null || obj === undefined) return true;
+  if (Array.isArray(obj)) return obj.length === 0;
+  if (typeof obj === 'object') return Object.keys(obj).length === 0;
+  return false;
+}
+
+/**
+ * Get nested object property safely
+ */
+export function get(obj, path, defaultValue = undefined) {
+  const keys = path.split('.');
+  let result = obj;
+  
+  for (const key of keys) {
+    if (result === null || result === undefined) {
+      return defaultValue;
+    }
+    result = result[key];
+  }
+  
+  return result !== undefined ? result : defaultValue;
+}
+
+/**
+ * Set nested object property
+ */
+export function set(obj, path, value) {
+  const keys = path.split('.');
+  const lastKey = keys.pop();
+  let current = obj;
+  
+  for (const key of keys) {
+    if (!current[key] || typeof current[key] !== 'object') {
+      current[key] = {};
+    }
+    current = current[key];
+  }
+  
+  current[lastKey] = value;
+  return obj;
+}
+
+/**
+ * Pick properties from object
+ */
+export function pick(obj, keys) {
+  return keys.reduce((result, key) => {
+    if (key in obj) result[key] = obj[key];
+    return result;
+  }, {});
+}
+
+/**
+ * Omit properties from object
+ */
+export function omit(obj, keys) {
+  const result = { ...obj };
+  keys.forEach(key => delete result[key]);
+  return result;
+}
+
+/**
+ * Wait for condition to be true
+ */
+export async function waitFor(condition, timeout = 5000) {
+  const startTime = Date.now();
+  
+  while (!condition()) {
+    if (Date.now() - startTime > timeout) {
+      throw new Error('Timeout waiting for condition');
+    }
+    await sleep(100);
+  }
+}
+
+/**
+ * Retry function on failure
+ */
+export async function retry(fn, maxAttempts = 3, delay = 1000) {
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      if (attempt === maxAttempts) throw error;
+      await sleep(delay);
+    }
+  }
+}