❄️ wintkit

Modern utility library for Edge & Serverless

Features • Install • Modules • Why wintkit?

Why wintkit?

Lodash is great, but it wasn't built for Edge. wintkit is zero-dependency, tree-shakable, and runs anywhere — Cloudflare Workers, Vercel Edge, Deno, Bun.

// Import only what you need. Nothing else touches your bundle.
import { chunk } from 'wintkit/array'
import { retryFetch } from 'wintkit/fetch'

Features

| | | |---|---| | 🌐 WinterCG Compliant | No Buffer, fs, path — pure Web APIs | | 📦 Zero Dependencies | Nothing but your code | | 🌳 Tree-shakable | Import one function, ship one function | | 🔷 TypeScript First | Full inference, strict types | | ⚡ Stream Utilities | Web Streams API helpers | | 🔄 Retry Fetch | Exponential backoff built-in |

Install

# npm
npm install wintkit

# pnpm
pnpm add wintkit

# bun
bun add wintkit

# deno (jsr)
deno add @wintkit/core

# jsr universal
npx jsr add @wintkit/core

Modules

📚 Array

import { chunk, groupBy, unique, partition, shuffle } from 'wintkit/array'

chunk([1, 2, 3, 4, 5], 2)        // [[1,2], [3,4], [5]]
groupBy(users, u => u.role)      // { admin: [...], user: [...] }
unique([1, 2, 2, 3])             // [1, 2, 3]
partition(nums, n => n > 0)      // [[positives], [negatives]]

🔧 Object

import { deepMerge, get, set, pick, omit } from 'wintkit/object'

deepMerge({ a: { b: 1 } }, { a: { c: 2 } })  // { a: { b: 1, c: 2 } }
get(obj, 'user.profile.name', 'default')
set(obj, 'settings.theme', 'dark')           // immutable, returns new obj

✂️ String

import { slugify, truncate, template, escapeHtml } from 'wintkit/string'

slugify('Merhaba Dünya')                      // 'merhaba-dunya'
truncate('long text', { length: 8 })          // 'long...'
template('Hello {{name}}', { name: 'World' }) // 'Hello World'

🌊 Stream

import { streamMap, toAsyncIterable, jsonToStream } from 'wintkit/stream'

// Transform stream chunks
const doubled = streamMap(stream, n => n * 2)

// Use with for-await
for await (const chunk of toAsyncIterable(stream)) {
  process(chunk)
}

// Stream JSON response
return new Response(jsonToStream({ data }))

🔁 Fetch

import { retryFetch, fetchTimeout, QueryBuilder } from 'wintkit/fetch'

// Retry with exponential backoff
await retryFetch('/api/data', { maxRetries: 3 })

// Timeout after 5s
await fetchTimeout('/api', { timeout: 5000 })

// Build query strings
new QueryBuilder().set('page', 1).set('limit', 20).toURL('/api')

📡 Events

import { winterEvents } from 'wintkit/events'

// Global typed event bus
winterEvents.on('fetch:retry', ({ url, attempt }) => {
  console.log(`Retry #${attempt}: ${url}`)
})

Runtime Support

| Runtime | Status | |---------|--------| | Node.js 18+ | ✅ | | Deno | ✅ | | Bun | ✅ | | Cloudflare Workers | ✅ | | Vercel Edge | ✅ | | Browsers (ES2022) | ✅ |

Bundle Size

Each function is in its own file — import one, ship one.

wintkit/array   ~800B gzipped
wintkit/stream  ~1.2KB gzipped
wintkit/fetch   ~1.5KB gzipped

Contributing

Pull requests are welcome! For major changes, please open an issue first.

License

MIT © qanteSm