@hedystia/swagger 1.1.5

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@hedystia/swagger",
+  "module": "index.ts",
+  "version": "1.1.5",
+  "devDependencies": {
+    "@types/bun": "latest",
+    "tsup": "^8.3.5"
+  },
+  "dependencies": {
+    "@apidevtools/swagger-parser": "^10.1.1",
+    "hedystia": "^1.1.5",
+    "openapi-types": "^12.1.3"
+  },
+  "peerDependencies": {
+    "@apidevtools/swagger-parser": "^10.1.1",
+    "typescript": ">= 5.0.0",
+    "hedystia": ">= 1.1.0",
+    "openapi-types": ">= 12.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@apidevtools/swagger-parser": {
+      "optional": false
+    },
+    "typescript": {
+      "optional": true
+    },
+    "hedystia": {
+      "optional": false
+    },
+    "openapi-types": {
+      "optional": true
+    }
+  },
+  "private": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "bun --watch --no-clear-screen run src/index.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Hedystia/Framework"
+  },
+  "author": {
+    "name": "Zastinian",
+    "email": "contact@zastinian.com",
+    "url": "https://github.com/Zastinian"
+  },
+  "type": "commonjs",
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js"
+}

package/readme.md

@@ -0,0 +1,164 @@
+<div align="center">
+  <p>
+    <strong>🚀 Hedystia Framework</strong>
+  </p>
+
+  <p>
+    <strong>Next-gen TypeScript framework for building type-safe APIs at lightspeed! ⚡</strong>
+  </p>
+
+  <p>
+    <a href="https://www.npmjs.com/package/hedystia"><img src="https://img.shields.io/npm/v/hedystia.svg?style=flat-square" alt="npm version"></a>
+    <a href="https://www.npmjs.com/package/hedystia"><img src="https://img.shields.io/npm/dm/hedystia.svg?style=flat-square" alt="npm downloads"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/github/license/Hedystia/Framework.svg?style=flat-square" alt="license"></a>
+    <img src="https://img.shields.io/badge/Bun-powered-FFD43B?style=flat-square&logo=bun" alt="Bun powered">
+  </p>
+</div>
+
+## 🚨 Early Access Notice
+> **Warning**
+> Framework is in active development. Core features are stable but some advanced functionality still being implemented.
+
+## 🌟 Superpowers
+
+- 🔒 **End-to-end type safety** - From params to response, full TypeScript integration
+- ⚡ **Bun-native performance** - Built for Bun runtime with zod dependency
+- 🧩 **Client integration** - Auto-generated type-safe HTTP client
+- 🛡️ **Validation built-in** - Zod integration for runtime safety
+- 🔌 **Extensible architecture** - Middleware, hooks and macros system
+
+## 🚀 Launch in 30 Seconds
+
+1. Install with Bun:
+```bash
+bun add hedystia
+```
+
+2. Create your first API:
+```typescript
+import { Hedystia, z } from "hedystia";
+
+const app = new Hedystia()
+  .get("/hello/:name", (ctx) => `Hello ${ctx.params.name}!`, {
+    params: z.object({ name: z.string() }),
+    response: z.string()
+  })
+  .listen(3000);
+```
+
+3. Generate client and consume API:
+```typescript
+import { createClient } from "@hedystia/client";
+
+const client = createClient<typeof app>("http://localhost:3000");
+
+// Fully typed request!
+const { data } = await client.hello.name("World").get();
+console.log(data); // "Hello World!"
+```
+
+## 💡 Why Developers Love Hedystia
+
+### 🔄 Full-stack Type Safety
+```typescript
+// Server-side validation
+.post("/users", (ctx) => {...}, {
+  body: z.object({
+    email: z.string().email(),
+    age: z.number().positive()
+  })
+})
+
+// Client-side types
+await client.users.post({
+  email: "user@example.com", // Autocompletes!
+  age: 25 // Type-checked
+});
+```
+
+### 📖 Swagger Integration
+
+```typescript
+import { swagger } from "@hedystia/swagger";
+
+const swaggerPlugin = swagger({
+  title: "My API",
+  description: "An example API with Swagger",
+  version: "1.0.0",
+  tags: [
+    { name: "users", description: "User operations" },
+  ],
+});
+
+swaggerPlugin.captureRoutes(app);
+
+app.use("/swagger", swaggerPlugin.plugin).listen(3000);
+```
+
+### ⚡ Performance First
+- Bun runtime optimized
+- Only zod dependency
+- Faster than Express
+- Built-in response compression
+
+### 🧩 Modern Feature Set
+```typescript
+// File uploads
+.post("/upload", async (ctx) => {
+  const formData = await ctx.body; // FormData type
+})
+
+// Binary responses
+.get("/pdf", () => new Blob([...]), {
+  response: z.instanceof(Blob)
+})
+
+// Nested routing
+.group("/api/v1", (v1) => v1
+  .group("/users", (users) => users
+    .get("/:id", ...)
+  )
+)
+```
+
+## 🛠️ Development Roadmap
+
+### Core Features
+- ✅ HTTP Methods: GET, POST, PUT, PATCH, DELETE
+- ✅ Response Types: JSON, Text, FormData, Blob, ArrayBuffer
+- ✅ Router Groups & Middleware
+- ✅ Type-safe Client Generation
+- ✅ WebSocket Support
+
+### Advanced Capabilities
+- ✅ Zod Validation
+- ✅ Hooks System (onRequest, onError, etc)
+- ✅ Macro System for Auth/Rate Limiting
+- 🚧 File System Routing
+- ✅ OpenAPI - Swagger Integration
+
+## 💼 Production Ready
+```typescript
+// Error handling
+.onError((err) => {
+  return Response.json({ 
+    error: err.message 
+  }, { status: 500 })
+})
+
+// Rate limiting macro
+.macro({
+  rateLimit: () => ({
+    resolve: async (ctx) => {
+      // Implement your logic
+    }
+  })
+})
+```
+
+## 📜 License
+MIT License © 2025 Hedystia
+
+## 🗣️ Community
+- [GitHub Issues](https://github.com/Hedystia/Framework/issues)
+- [Discord Server](https://hedystia.com/support)