balda-js 0.0.1

package/.github/workflows/publish.yml

@@ -0,0 +1,38 @@
+name: Publish to NPM
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - v*
+
+jobs:
+  build:
+    name: Publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          ref: ${{github.ref_name}}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22.14.0'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Build package
+        run: |
+          yarn install --frozen-lockfile --non-interactive
+          yarn build
+
+      - name: Publish package
+        run: |
+          yarn publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.husky/pre-commit

@@ -0,0 +1,19 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+yarn format
+yarn build:test
+
+echo "Running tests..."
+
+echo "Running tests for Node..."
+yarn test
+
+echo "Running tests for Bun..."
+yarn test:bun
+
+echo "Running tests for Deno..."
+yarn test:deno
+
+echo "Adding changes..."
+git add .

package/.nvmrc

@@ -0,0 +1 @@
+v22.14.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 francesco sangiovanni
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# Balda.js
+
+A **cross-runtime, FastAPI-inspired Node.js backend framework** that aims to work seamlessly across **Node.js**, **Bun**, and **Deno** runtimes. Built with TypeScript and designed for modern web development.
+
+## Key Features
+
+- **Cross-Runtime Compatibility**: Single codebase that runs on Node.js, Bun, and Deno. It uses the native runtime apis for maximum performance (es. `Bun.serve`, `Deno.serve`, etc).
+- **Decorator-Based Architecture**: Balda-js is inspired by FastAPI, NestJS and ExpressJS syntax with type-safe request/response handling
+- **Advanced Validation**: TypeBox schema validation with AJV for high-performance validation
+- **Rich Plugin Ecosystem**: Rate limiting, CORS, file uploads, structured logging, and more
+- **Built-in CLI & Code Generation**: Scaffolding commands for controllers, plugins, and cron jobs
+- **Cron Job Support**: Decorator-based scheduling with cross-runtime execution
+- **Swagger Support**: Built-in Swagger UI and JSON specification
+
+## Quick Start
+
+```bash
+npm install balda-js
+```
+
+```typescript
+import { Server, controller, get } from 'balda-js';
+
+@controller('/api')
+class ApiController {
+  @get('/health')
+  async health(req: Request, res: Response) {
+    return res.json({ status: 'ok' });
+  }
+}
+
+const server = new Server();
+server.listen();
+```
+
+## Documentation
+
+Visit the comprehensive documentation: **[https://frasan00.github.io/balda-js/](https://frasan00.github.io/balda-js/)**
+
+## ⚠️ Development Status
+
+**This project is under active development. APIs and features may change, and breaking changes can occur between releases. Do not use in production**
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.