bytekit

> Previously known as: @sebamar88/utils (v0.1.9 and earlier)

EN: Modern TypeScript utilities: an isomorphic ApiClient, structured logging/profiling helpers, and ready-to-use modules (DateUtils, StringUtils, StorageManager, etc.).
ES: Colección moderna de utilidades TypeScript: ApiClient isomórfico, logging/profiling estructurado y helpers listos (DateUtils, StringUtils, StorageManager, etc.).

📊 Status / Estado


---

✨ Highlights / Características

- ✅ EN: Fully ESM with .d.ts definitions and tree-shakeable exports. ES: Build 100% ESM con tipos listos y exports tree-shakeable.
- 🌐 EN: Works on Node.js 18+ and modern browsers (native fetch). ES: Compatible con Node.js 18+ y navegadores modernos (fetch nativo).
- 🔁 EN: ApiClient with retries, circuit breaker, localized errors, and flexible options. ES: ApiClient con reintentos, circuit breaker, errores localizados y configuración flexible.
- 🧩 EN: 28 helper modules (strings, dates, validators, env, storage, crypto, cache). ES: 28 módulos helpers (strings, fechas, validadores, env, storage, crypto, cache).
- 🪵 EN: Structured logging/profiling: createLogger, Profiler, withTiming. ES: Logging/profiling estructurado: createLogger, Profiler, withTiming.
- 🎯 EN: 95%+ test coverage with comprehensive test suite. ES: >95% de cobertura de tests con suite completa.
- 📦 EN: True zero dependencies (uses native fetch). ES: Verdadero zero dependencies (usa fetch nativo).
- ⚡ EN: Optimized for performance and small bundle size. ES: Optimizado para rendimiento y tamaño mínimo.

🚀 Quick Start / Inicio Rápido

$3

``bash
npm install bytekit


or / o

`bash
npm install -g bytekit


Then use / Luego usa:

`ts
import { ApiClient, createLogger, DateUtils, StringUtils } from "bytekit";

const http = new ApiClient({
baseUrl: "https://api.my-service.com",
defaultHeaders: { "X-Team": "@sebamar88" },
locale: "es",
errorMessages: {
es: { 418: "Soy una tetera ☕" },
},
});

const users = await http.get<{ id: string; name: string }[]>("/users");

const logger = createLogger({ namespace: "users-service", level: "info" });
logger.info("Users synced", { count: users.length });

const slug = StringUtils.slugify("New Users – October 2024");
`

$3

`ts
// Import specific modules to reduce bundle size
// Importa módulos específicos para reducir el tamaño del bundle

// Core modules / Módulos core
import { ApiClient } from "bytekit/api-client";
import { Logger } from "bytekit/logger";
import { RetryPolicy } from "bytekit/retry-policy";

// Helper modules / Módulos helpers
import { DateUtils } from "bytekit/date-utils";
import { StringUtils } from "bytekit/string-utils";
import { ArrayUtils } from "bytekit/array-utils";
`

🎯 Framework Support / Soporte de Frameworks

EN: Works seamlessly with React, Vue, Svelte, Angular, Next.js, Nuxt, SvelteKit, and more.
ES: Funciona perfectamente con React, Vue, Svelte, Angular, Next.js, Nuxt, SvelteKit y más.

$3

`jsx
import { createApiClient } from "bytekit";
import { useState, useEffect } from "react";

function Users() {
const client = createApiClient({ baseURL: "https://api.example.com" });
const [users, setUsers] = useState([]);

useEffect(() => {
client.get("/users").then(setUsers);
}, [client]);

return (


`ts
const api = new ApiClient({
baseUrl: "https://api.example.com",
retryPolicy: { maxAttempts: 3, initialDelayMs: 100 },
circuitBreaker: { failureThreshold: 5 },
});

const users = await api.get("/users");
`

$3

`ts
const logger = createLogger({ namespace: "app", level: "info" });
logger.info("User created", { userId: 123, email: "user@example.com" });
`

$3

`ts
const formatted = DateUtils.format(new Date(), "es-AR");
const slug = StringUtils.slugify("Hello World! 🌍");
const masked = StringUtils.mask("1234567890", { start: 4, end: 2 });
`

$3

`ts
const chunks = ArrayUtils.chunk([1, 2, 3, 4, 5], 2); // [[1,2], [3,4], [5]]
const picked = ObjectUtils.pick(user, ["id", "name", "email"]);
const grouped = ObjectUtils.groupBy(users, "department");
``

🚀 Live Examples / Ejemplos en Vivo

EN: Try bytekit in your browser with these interactive examples:
ES: Prueba bytekit en tu navegador con estos ejemplos interactivos:

- React Example - Complete React app with ApiClient
- Vue Example - Vue 3 composition API usage
- Svelte Example - Svelte integration example

📁 View Local Examples →

� Documentation / Documentación

EN: Comprehensive guides to help you get the most out of bytekit:
ES: Guías completas para aprovechar al máximo bytekit:

- 🚀 Getting Started - Installation, basic usage, and core concepts / Instalación, uso básico y conceptos core
- 🔬 Advanced Usage - Complex patterns and techniques / Patrones y técnicas complejas
- ✨ Best Practices - Production-ready patterns / Patrones para producción
- 📖 Examples & Snippets - Code samples and interactive demos / Ejemplos de código y demos interactivos

$3

- React Basic - ApiClient with React hooks / ApiClient con hooks de React
- Vue Basic - Composition API integration / Integración con Composition API
- Svelte Basic - Svelte stores integration / Integración con stores de Svelte

�🔗 Links / Enlaces

- 📦 NPM Package - Install and version info
- 📚 Full Documentation Wiki - Complete API reference
- 🚀 Live Examples - Working code samples
- 📋 Issues & Support - Bug reports and feature requests
- 🔄 Changelog - Version history

🤝 Contributing / Contribuir

EN: Contributions are welcome! Please read our contributing guidelines and feel free to submit issues and pull requests.
ES: ¡Las contribuciones son bienvenidas! Lee nuestras guías de contribución y no dudes en enviar issues y pull requests.

📄 License / Licencia

MIT © Sebastián Martinez

---

💡 Need help? Check the Wiki or open an issue.