Workstudio — Utilities (Node)

Small collection of lightweight TypeScript utility functions used across Workstudio projects.

This package exposes a few focused helpers under src/utils/:

- random — random booleans, integers, floats, UUIDs, and secure strings
- formatter — date and currency formatting helpers
- converter — base64 / URL helpers and a small hashing helper

Usage

During development you can import directly from src:

``ts
import { randomUUID, randomString } from './src/utils/random';
import { formatDate, formatCurrency } from './src/utils/formatter';
import { base64Encode, base64Decode } from './src/utils/converter';

console.log(randomUUID());
console.log(formatDate(new Date()));
console.log(base64Encode({ hello: 'world' }));
`

Exported helpers

- randomBoolean(probability?: number): boolean — random boolean with optional probability of true (0..1)
- randomInteger(min?: number, max?: number): number — integer in inclusive range
- randomFloat(min?: number, max?: number): number — float in [min, max)
- randomUUID(): string — cryptographically generated UUID
- randomString(bytes?: number): string — secure hex string (bytes * 2 length)

- formatDate(date, locale?) — formats Date/ISO/timestamp to long human date
- formatCurrency(amount, currency?, locale?) — formats number as currency

- base64Encode(value) — base64 encode, JSON-stringifies objects
- base64Decode(str) — base64 decode and attempt JSON.parse, falls back to string
- urlEncode / urlDecode — wrappers around encodeURIComponent / decodeURIComponent
- hash(value, alg?) — return hex digest (default sha256)

Development

Run TypeScript checks / build from the package root:

`bash
pnpm install
pnpm run build
`

pnpm run build will compile to dist/ using the local tsconfig.json.

Contributing

Small, well-scoped improvements are welcome. Preferred changes:

- Add unit tests for helpers you modify
- Keep runtime dependencies minimal

License

MIT — see package.json` for details.