A zero-dependency TypeScript utility library for universal JavaScript
Caution
The main repository is now at https://codeberg.org/holtwick/zeed to strengthen European sovereignty. Learn more at UnplugTrump.
|
Strict TypeScript with full type inference Lightweight and completely tree-shakable Works in browsers, Node.js, Deno, and Bun |
ES Modules with CommonJS fallback Comprehensive test coverage Compatible with tRPC, TanStack, Hono & more |
npm install zeed
# or
pnpm add zeed
# or
yarn add zeedPowerful, filterable logging for browser and terminal with colorful output and stack traces.
import { Logger } from 'zeed'
const log = Logger('demo')
log('Hello World')
log.info('Info')
log.warn('Warning')
log.error('Error')Terminal output:
Browser output:
📖 Learn more about logging features
Filtering:
By default, logs are muted. Enable them with filters:
Browser:
localStorage.zeed = '*'Node.js:
ZEED=* node myapp.jsYou can use advanced filters compatible with debug syntax. Use ZEED or DEBUG environment variables (ZEED supersedes DEBUG).
Filter by level: ZEED_LEVEL=info to hide debug logs.
Write to file: ZEED_LOG=/path/to/file.log
Log Handlers:
LoggerConsoleHandler(opt)- Plain console outputLoggerBrowserHandler(opt)- Colorful browser logsLoggerNodeHandler(opt)- Colorful Node.js logsLoggerFileHandler(path, opt)- File output with optional rotation
Log Rotation Example:
import { LoggerFileHandler } from 'zeed'
LoggerFileHandler('/var/log/app.log', {
rotation: {
size: '10M',
maxFiles: 5,
compress: 'gzip'
}
})Powerful utilities for working with async operations:
// Wait for an event
await waitOn(emitter, 'action', 1000)
// Sleep for milliseconds
await sleep(1000)
// Timeout a promise
await timeout(asyncFn, 1000)
// Ensure a value is a Promise
await promisify(returnValue)Multiple ID generation strategies for different use cases:
// UUID (Base62, 22 chars) - cryptographically secure
const id = uuid()
// Sortable UID with timestamp
const sortable = suid()
suidDate(sortable) // Extract timestamp
// Named incremental IDs (great for debugging)
uname('user') // => 'user-0'
uname('user') // => 'user-1'
// Classic UUID v4
const classic = uuidv4() // => 'a7755f8d-ef6f-45e9-8db3-d29347a4a2a1'Available ID types: uuid, uuidB32, suid, quid, uuidv4
Type-safe, async event emitter with full TypeScript support:
interface MyEvents {
inc: (count: number) => number
}
const e = new Emitter<MyEvents>()
e.on('inc', async count => counter + 1)
await e.emit('inc', 1)
// Or use the .call proxy
await e.call.inc(1)Global emitter for cross-module communication:
declare global {
interface ZeedGlobalEmitter {
test: (x: string) => void
}
}
getGlobalEmitter().call.test('Hello World')Type-safe messaging infrastructure for client-server communication:
const m = useMessageHub({ channel }).send<MyMessages>()
m.echo({ hello: 'world' })🎯 Type-safe • 🔄 Standard Schema Compatible • 🚀 Zero Dependencies
Powerful schema validation with full TypeScript inference and Standard Schema support:
import { z } from 'zeed'
// Define and validate schemas
const userSchema = z.object({
name: z.string(),
email: z.string(),
age: z.number().optional(),
role: z.stringLiterals(['admin', 'user', 'guest']),
})
// Full type inference
type User = z.infer<typeof userSchema>
// Parse and validate
const user = schemaParseObject(userSchema, data)🔗 Standard Schema Compatibility
Compatible with tRPC, TanStack Form/Router, Hono, and 40+ other libraries:
// Use with any standard-schema-compatible library
const schema = z.object({
name: z.string(),
count: z.number(),
})
const result = schema['~standard'].validate({ name: 'test', count: 42 })
if (result.issues) {
console.error('Validation failed:', result.issues)
}
else {
console.log('Valid data:', result.value)
}Features:
- Primitives:
string(),number(),int(),boolean(),any() - Objects:
object(),record(),pick(),omit(),extend(),partial(),required() - Arrays & Tuples:
array(),tuple() - Unions & Literals:
union(),literal(),stringLiterals() - Modifiers:
.optional(),.default(),.describe()
|
🔄 CRDT Sorting interface Row extends SortedItem {
id: string
title: string
}
sortedItems(rows)🔐 Binary Encoding const { encode, decode } = useBase(62)
decode(encode(data)) === data |
🔍 Deep Object Utils deepEqual(obj1, obj2)
deepMerge(obj1, obj2)🧹 Resource Disposal const dispose = useDispose()
dispose.add(cleanup)
await dispose() |
Zeed includes many more utilities - explore the full API documentation!
By the same author:
Similar utility libraries:
- lib0 - Fundamental utility functions
- antfu/utils - Collection of common utilities
- vueuse - Vue composition utilities
- unjs - Unified JavaScript tools
MIT
Built with ❤️ by Dirk Holtwick