Home

@gregoiref/utils — Wiki

Zero-dependency TypeScript utilities for Node.js, Cloudflare Workers, and modern JS runtimes.

---

Pages

Page	Description
Architecture	Monorepo decisions, tooling, security layers, philosophy
Workflow: Commits & Releases	Full commit → changeset → PR → publish workflow
Integration: Astro	Patterns for Astro API routes
Integration: Nuxt 3	Patterns for Nuxt 3 server routes
Integration: Node.js / Hono	Full Hono app bootstrap

---

Quick install

# .npmrc
@gregoiref:registry=https://npm.pkg.github.com

pnpm add @gregoiref/result
pnpm add @gregoiref/crypto
pnpm add @gregoiref/http-client
pnpm add @gregoiref/logger
pnpm add @gregoiref/env-validator
pnpm add @gregoiref/ts-utils
pnpm add @gregoiref/date

---

Packages

Package	Description
@gregoiref/result	Typed Result<T, E> — no-throw error handling
@gregoiref/crypto	Web Crypto API — hashing, HMAC, AES-GCM, PBKDF2, random
@gregoiref/http-client	Fetch wrapper returning Result — no try/catch
@gregoiref/logger	Structured JSON logger with child context
@gregoiref/env-validator	Runtime env validation with types — fail fast at startup
@gregoiref/ts-utils	General TypeScript utilities
@gregoiref/date	Lightweight date formatting and comparison

---

Dev configs

Package	Description
@gregoiref/cz-config	Commitizen (cz-git) config with Gitmoji
@gregoiref/commitlint-config	commitlint config — Conventional Commits + emoji
@gregoiref/changeset-config	Changesets factory + emoji changelog formatter

---

Source

github.com/GregoireF/utils — MIT license