| \n\n### ๐ฏ **Type-Safe**\n\nStrict TypeScript with full type inference\n\n### ๐ฆ **Zero Dependencies**\n\nLightweight and completely tree-shakable\n\n### ๐ **Universal**\n\nWorks in browsers, Node.js, Deno, and Bun\n\n | \n\n\n### โก **Modern ESM**\n\nES Modules with CommonJS fallback\n\n### โ **Well Tested**\n\nComprehensive test coverage\n\n### ๐ **Standard Schema**\n\nCompatible with tRPC, TanStack, Hono & more\n\n | \n
![\"\"](\".assets/node-console@2x.png\")
\n\n**Browser output:**\n\n![\"\"](\".assets/safari-console.png\")
\n\n\n
\n\n---\n\n### โ๏ธ Async/Promise Utilities\n\nPowerful utilities for working with async operations:\n\n```ts\n// Wait for an event\nawait waitOn(emitter, 'action', 1000)\n\n// Sleep for milliseconds\nawait sleep(1000)\n\n// Timeout a promise\nawait timeout(asyncFn, 1000)\n\n// Ensure a value is a Promise\nawait promisify(returnValue)\n```\n\n---\n\n### ๐ Unique ID Generation\n\nMultiple ID generation strategies for different use cases:\n\n```ts\n// UUID (Base62, 22 chars) - cryptographically secure\nconst id = uuid()\n\n// Sortable UID with timestamp\nconst sortable = suid()\nsuidDate(sortable) // Extract timestamp\n\n// Named incremental IDs (great for debugging)\nuname('user') // => 'user-0'\nuname('user') // => 'user-1'\n\n// Classic UUID v4\nconst classic = uuidv4() // => 'a7755f8d-ef6f-45e9-8db3-d29347a4a2a1'\n```\n\n**Available ID types:** `uuid`, `uuidB32`, `suid`, `quid`, `uuidv4`\n\n---\n\n### ๐ฏ Typed Event Emitter\n\nType-safe, async event emitter with full TypeScript support:\n\n```ts\ninterface MyEvents {\n inc: (count: number) => number\n}\n\nconst e = new Emitter๐ Learn more about logging features
\n\n**Filtering:**\n\nBy default, logs are muted. Enable them with filters:\n\n**Browser:**\n\n```ts\nlocalStorage.zeed = '*'\n```\n\n**Node.js:**\n\n```sh\nZEED=* node myapp.js\n```\n\nYou can use advanced filters compatible with [debug syntax](https://github.com/visionmedia/debug#wildcards). Use `ZEED` or `DEBUG` environment variables (`ZEED` supersedes `DEBUG`).\n\nFilter by level: `ZEED_LEVEL=info` to hide debug logs.\n\nWrite to file: `ZEED_LOG=/path/to/file.log`\n\n**Log Handlers:**\n\n- `LoggerConsoleHandler(opt)` - Plain console output\n- `LoggerBrowserHandler(opt)` - Colorful browser logs\n- `LoggerNodeHandler(opt)` - Colorful Node.js logs\n- `LoggerFileHandler(path, opt)` - File output with optional rotation\n\n**Log Rotation Example:**\n\n```ts\nimport { LoggerFileHandler } from 'zeed'\n\nLoggerFileHandler('/var/log/app.log', {\n rotation: {\n size: '10M',\n maxFiles: 5,\n compress: 'gzip'\n }\n})\n```\n\n\n\n**๐ฏ Type-safe โข ๐ Standard Schema Compatible โข ๐ Zero Dependencies**\n\n
\n\nPowerful schema validation with full TypeScript inference and [Standard Schema](https://github.com/standard-schema/standard-schema) support:\n\n```ts\nimport { z } from 'zeed'\n\n// Define and validate schemas\nconst userSchema = z.object({\n name: z.string(),\n email: z.string(),\n age: z.number().optional(),\n role: z.stringLiterals(['admin', 'user', 'guest']),\n})\n\n// Full type inference\ntype User = z.infer\n
\n\n> ๐ [Complete schema documentation](./src/common/schema/README.md)\n\n---\n\n### ๐ Additional Utilities\n\n๐ Standard Schema Compatibility
\n\nCompatible with **tRPC**, **TanStack Form/Router**, **Hono**, and [40+ other libraries](https://github.com/standard-schema/standard-schema#what-tools--frameworks-accept-spec-compliant-schemas):\n\n```ts\n// Use with any standard-schema-compatible library\nconst schema = z.object({\n name: z.string(),\n count: z.number(),\n})\n\nconst result = schema['~standard'].validate({ name: 'test', count: 42 })\nif (result.issues) {\n console.error('Validation failed:', result.issues)\n}\nelse {\n console.log('Valid data:', result.value)\n}\n```\n\n**Features:**\n\n- Primitives: `string()`, `number()`, `int()`, `boolean()`, `any()`\n- Objects: `object()`, `record()`, `pick()`, `omit()`, `extend()`, `partial()`, `required()`\n- Arrays & Tuples: `array()`, `tuple()`\n- Unions & Literals: `union()`, `literal()`, `stringLiterals()`\n- Modifiers: `.optional()`, `.default()`, `.describe()`\n\n| \n\n**๐ CRDT Sorting**\n\n```ts\ninterface Row extends SortedItem {\n id: string\n title: string\n}\nsortedItems(rows)\n```\n\n**๐ Binary Encoding**\n\n```ts\nconst { encode, decode } = useBase(62)\ndecode(encode(data)) === data\n```\n\n | \n\n\n**๐ Deep Object Utils**\n\n```ts\ndeepEqual(obj1, obj2)\ndeepMerge(obj1, obj2)\n```\n\n**๐งน Resource Disposal**\n\n```ts\nconst dispose = useDispose()\ndispose.add(cleanup)\nawait dispose()\n```\n\n | \n
\n\n**Built with โค๏ธ by [Dirk Holtwick](https://holtwick.de)**\n\n[โญ Star on GitHub](https://github.com/holtwick/zeed) โข [๐ Documentation](https://zeed.holtwick.de/) โข [๐ Report Issue](https://github.com/holtwick/zeed/issues)\n\n
\n","readmeFilename":"README.md"}