chore: initial commit

Author: liorcodev

.gitignore

@@ -0,0 +1,34 @@
+# dependencies (bun install)
+node_modules
+
+# output
+out
+dist
+*.tgz
+
+# code coverage
+coverage
+*.lcov
+
+# logs
+logs
+_.log
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# caches
+.eslintcache
+.cache
+*.tsbuildinfo
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store

.husky/pre-commit

@@ -0,0 +1,17 @@
+#!/bin/sh
+
+echo "Running pre-commit checks..."
+
+echo "→ Format check..."
+bun run format:check || exit 1
+
+echo "→ Lint check..."
+bun run lint:check || exit 1
+
+echo "→ Type check..."
+bun run typecheck || exit 1
+
+echo "→ Running tests..."
+bun test || exit 1
+
+echo "✓ All checks passed!"

.prettierrc

@@ -0,0 +1,13 @@
+{
+  "printWidth": 120,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "none",
+  "bracketSpacing": true,
+  "arrowParens": "avoid",
+  "requirePragma": false,
+  "insertPragma": false,
+  "proseWrap": "always"
+}

.vscode/launch.json

@@ -0,0 +1,36 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "bun",
+      "internalConsoleOptions": "neverOpen",
+      "request": "launch",
+      "name": "Debug File",
+      "program": "${file}",
+      "cwd": "${workspaceFolder}",
+      "stopOnEntry": false,
+      "watchMode": false
+    },
+    {
+      "type": "bun",
+      "internalConsoleOptions": "neverOpen",
+      "request": "launch",
+      "name": "Run File",
+      "program": "${file}",
+      "cwd": "${workspaceFolder}",
+      "noDebug": true,
+      "watchMode": false
+    },
+    {
+      "type": "bun",
+      "internalConsoleOptions": "neverOpen",
+      "request": "attach",
+      "name": "Attach Bun",
+      "url": "ws://localhost:6499/",
+      "stopOnEntry": false
+    }
+  ]
+}

CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+## 1.0.0 (2026-03-27)
+
+### Features
+
+- **Core Framework** - `Doofpi` class with full request lifecycle: `createContext`, `onRequest`, `onResponse`, `onError`
+  hooks
+- **Endpoint Builder** - Fluent API for defining endpoints with `model()`, `meta()`, `middleware()`, `read()`, and
+  `write()` methods
+- **Read & Write Operations** - `GET`-based reads (input via query parameter) and `POST`-based writes (input via JSON
+  body)
+- **Zod Validation** - Input and output schema validation using Zod, with automatic error extraction
+- **Middleware** - Per-endpoint middleware chains with access to request context, meta, and `throwError`
+- **Default Meta** - `defaultMeta()` on the endpoint builder for shared metadata across endpoints
+- **Routing** - Dot-notation path routing powered by `extreme-router`, with configurable root (default: `/doofpi`)
+- **Type-Safe Client** - `createClient<Routes>()` proxy-based client that mirrors the server route structure with full
+  type inference
+- **Error System** - `DoofpiError`, `NotFoundError`, `MethodNotAllowedError`, `ValidationError`, `InternalServerError`
+  on the server; `DoofpiClientError` on the client
+- **Environment & Context** - `defineEnv()`, `defineExtra()`, `defineMeta()` for typed environment, extra bindings, and
+  metadata
+- **`InferContext` Utility** - Type helper to extract the context type from a `Doofpi` instance
+- **Web Standards** - Built on the `Request`/`Response` API - runs on Bun, Cloudflare Workers, Vercel, Netlify Edge
+  Functions, Deno and more

README.md

@@ -0,0 +1,74 @@
+<div align="center">
+  <br/>
+  <img src="./assets/logo.svg" alt="doofpi" width="80" />
+  <h1>doofpi</h1>
+  <p><strong>Edge-First TypeScript API Framework</strong></p>
+
+  <p>
+    <a href="https://www.npmjs.com/package/doofpi"><img src="https://img.shields.io/npm/v/doofpi.svg" alt="npm version" /></a>
+    &nbsp;
+    <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-orange.svg" alt="MIT License" /></a>
+  </p>
+
+  <p>
+    <a href="https://liorcodev.github.io/doofpi-docs/docs/quick-start"><strong>Quick Start</strong></a> ·
+    <a href="https://liorcodev.github.io/doofpi-docs/docs/core-concepts/read-and-write"><strong>Core Concepts</strong></a> ·
+    <a href="https://liorcodev.github.io/doofpi-docs/docs/api-reference/doofpi-class"><strong>API Reference</strong></a> ·
+    <a href="https://liorcodev.github.io/doofpi-docs"><strong>Documentation →</strong></a>
+  </p>
+  <br/>
+</div>
+
+---
+
+**doofpi** is a lightweight TypeScript framework based on web standards for building end-to-end type-safe APIs - no code
+generation, no build steps, no separate schema files to maintain
+
+```bash
+# Core install
+bun install doofpi
+
+npm install doofpi
+
+pnpm install doofpi
+```
+
+> **Optional:** Add `zod` for schema validation and type inference from schemas.
+>
+> ```bash
+> bun install doofpi zod
+> ```
+
+## Highlights
+
+|                            |                                                             |
+| -------------------------- | ----------------------------------------------------------- |
+| **Zero Boilerplate**       | No adapters, links, or transformers minimal setup           |
+| **End-to-End Type Safety** | Change your server, your client breaks at compile time      |
+| **Runtime Agnostic**       | Bun · Cloudflare Workers · Vercel · Netlify · Deno and more |
+| **Zod Validation**         | Optional input _and_ output validation at runtime           |
+| **Web Standards**          | Built on the native `Request` / `Response` API              |
+| **Thoroughly Tested**      | 100% code coverage across all core features                 |
+
+## Documentation
+
+Full documentation, guides, and API reference are available at
+**[liorcodev.github.io/doofpi-docs](https://liorcodev.github.io/doofpi-docs)**.
+
+|                                                                                            |                                                              |
+| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------ |
+| [Quick Start](https://liorcodev.github.io/doofpi-docs/docs/quick-start)                    | Get up and running in minutes                                |
+| [Core Concepts](https://liorcodev.github.io/doofpi-docs/docs/core-concepts/read-and-write) | Read & Write semantics, routing, Zod validation              |
+| [Guides](https://liorcodev.github.io/doofpi-docs/docs/guides/context-and-middleware)       | Context, middleware, error handling, and more                |
+| [API Reference](https://liorcodev.github.io/doofpi-docs/docs/api-reference/doofpi-class)   | Full API for `Doofpi`, `EndpointBuilder`, and `createClient` |
+| [Comparison](https://liorcodev.github.io/doofpi-docs/docs/comparison)                      | How doofpi compares to tRPC                                  |
+
+## Acknowledgments
+
+Inspired by [tRPC](https://trpc.io).
+
+---
+
+<div align="center">
+  <sub>MIT License · Built with ❤️ for the TypeScript community</sub>
+</div>