@outilx/browser

Browser utility functions for arrays, caching, JSON, URL parsing, async processing, and more.

Installation

npm install @outilx/browser
# or
pnpm add @outilx/browser
# or
yarn add @outilx/browser

Usage

import { 
  toArray, 
  createIncrementingArray, 
  TipCache, 
  getUrlParams, 
  parseJsonWithFallback,
  createAsyncProcessor,
  MemoryCache,
  promisify
} from '@outilx/browser';

// Array utilities
const arr = toArray(1); // [1]
const nums = createIncrementingArray(5); // [1, 2, 3, 4, 5]

// Caching with LRU and TTL
const cache = new TipCache<string>(100); // maxSize: 100
cache.set('key', 'value', 5000); // 5 second TTL

// URL utilities (pass query string)
const params = getUrlParams('foo=bar&baz=qux');
// { foo: 'bar', baz: 'qux' }

// Safe JSON parsing
const data = parseJsonWithFallback('{"name":"John"}', {});

// Async processing with caching
function asyncAdd(a: number, b: number, cb: (err: null, result: number) => void) {
  setTimeout(() => cb(null, a + b), 1000);
}

const optimizedSum = createAsyncProcessor(asyncAdd, {
  mode: 'parallel',
  cache: new MemoryCache(),
  keyGenerator: (a, b) => `add_${a}_${b}`
});

// Promisify callback-style functions
const promisifiedAdd = promisify(asyncAdd);
const result = await promisifiedAdd(1, 2); // 3

Features

• Array utilities (toArray, shuffleArray, pipeFromArray, createIncrementingArray)
• LRU caching with TTL support
• Safe JSON operations
• URL query string parsing
• Network utilities
• Async processing with caching and execution strategies
• Promisify callback-style functions

License

MIT