@entrolytics/utilities

Common utilities and helper functions for Entrolytics projects.

Installation

npm install @entrolytics/utilities

# or

pnpm add @entrolytics/utilities

# or

yarn add @entrolytics/utilities

Features

• 🧵 String utilities (truncate, capitalize, slugify, case conversion)
• 📅 Date utilities (formatting, ranges, comparisons)
• 🔗 URL utilities (parsing, validation, building)
• 🔐 Hash utilities (simple hashing, ID generation)
• 🔄 Retry with exponential backoff
• ⏱️ Debounce and throttle functions
• 💾 Safe localStorage/sessionStorage wrappers
• 🌲 Tree-shakeable exports
• 📦 Zero dependencies

Usage

String Utilities

import { truncate, slugify, toKebabCase } from "@entrolytics/utilities";

truncate("Long text here", 10); // 'Long te...'
slugify("Hello World!"); // 'hello-world'
toKebabCase("camelCaseString"); // 'camel-case-string'

Date Utilities

import { getLastNDays, toDateString, addDays } from "@entrolytics/utilities";

const { startDate, endDate } = getLastNDays(7);
toDateString(new Date()); // '2025-12-26'
addDays(new Date(), 5); // Date 5 days from now

URL Utilities

import { parseQueryParams, getDomain, combineUrl } from "@entrolytics/utilities";

parseQueryParams("https://example.com?foo=bar"); // { foo: 'bar' }
getDomain("https://example.com/path"); // 'example.com'
combineUrl("https://api.com", "v1", "users"); // 'https://api.com/v1/users'

Retry with Backoff

import { retry } from "@entrolytics/utilities";

await retry(
  async () => {
    const response = await fetch("https://api.example.com/data");
    return response.json();
  },
  {
    maxAttempts: 3,
    delayMs: 1000,
    backoffMultiplier: 2,
    onRetry: (error, attempt) => {
      console.log(`Retry attempt ${attempt}:`, error.message);
    },
  },
);

Debounce & Throttle

import { debounce, throttle } from "@entrolytics/utilities";

const debouncedSearch = debounce((query: string) => {
  console.log("Searching for:", query);
}, 300);

const throttledScroll = throttle(() => {
  console.log("Scrolling...");
}, 100);

Storage Utilities

import { storage, sessionStorage } from "@entrolytics/utilities";

// localStorage
storage.set("user", { name: "John", id: 123 });
const user = storage.get("user"); // { name: 'John', id: 123 }
storage.remove("user");

// sessionStorage
sessionStorage.set("tempData", { value: 42 });
const data = sessionStorage.get("tempData");

API Reference

See source code for full API documentation with TypeScript types.

License

MIT © Entrolytics