veloce-ts 1.0.0 → 1.2.0

package/CHANGELOG.md

@@ -7,6 +7,102 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.0] - 2026-06-27
+
+### Added
+
+- **CLI code generation** (`veloce generate`): scaffold controllers, services, modules, resolvers, DTOs, middleware, and plugins with a single command. `veloce new <name>` creates a full project with correct tsconfig and dependencies.
+  ```bash
+  veloce generate module school      # controller + service + dto + barrel
+  veloce generate controller users   # @Controller with full CRUD stubs
+  veloce generate resolver product   # @Resolver with @GQLQuery/@GQLMutation
+  veloce generate plugin cache       # Plugin interface implementation
+  ```
+
+- **Graceful shutdown** (`app.onShutdown()`): register async cleanup handlers executed on SIGTERM/SIGINT in reverse order, with a configurable timeout (default 30 s).
+  ```typescript
+  app.onShutdown(async () => { await db.end(); });
+  app.setShutdownTimeout(10_000);
+  ```
+
+- **Exception filters** (`@Catch`, `app.useFilter()`): centralised error handling per error class — no more try/catch in every controller.
+  ```typescript
+  @Catch(DrizzleError)
+  class DBFilter implements ExceptionFilter {
+    catch(err: DrizzleError, c: Context) { return c.json({ error: 'DB error' }, 500); }
+  }
+  app.useFilter(new DBFilter());
+  ```
+
+- **Interceptors** (`@UseInterceptor`, `app.useInterceptor()`): AOP middleware around handlers — logging, caching, retries, transforms.
+  ```typescript
+  app.useInterceptor(new LoggingInterceptor());
+  @UseInterceptor(CacheInterceptor)
+  @Get('/users') async getUsers() { ... }
+  ```
+
+- **Streaming responses** (`@SSE()`, `@Stream(contentType)`): return `AsyncGenerator` from any handler for SSE or raw byte streams.
+  ```typescript
+  @Get('/events') @SSE()
+  async* stream() { yield { data: 'ping' }; }
+
+  @Get('/export.csv') @Stream('text/csv')
+  async* csv() { yield 'id,name\n'; yield* rows; }
+  ```
+
+- **Event bus** (`EventBus`, `globalEvents`): lightweight in-process pub/sub with `on`, `once`, `off`, async `emit`, and `emitSync`.
+  ```typescript
+  globalEvents.on('user.created', async ({ userId }) => { ... });
+  await globalEvents.emit('user.created', { userId });
+  ```
+
+- **Extra decorators**:
+  - `@Throttle(limit, windowMs)` — per-endpoint rate limit override
+  - `@ApiVersion('v2')` — prefix route with version segment
+  - `@ResponseHeader(name, value)` — set response header declaratively
+  - `@Redirect(url, status?)` — 301/302/307/308 redirect
+  - `@Deprecated(message?)` — marks route in OpenAPI + emits warning
+
+- **Test isolation utilities** (`veloce-ts/testing`): `isolate()` resets shared singleton state between bun test files; `compileTestApp(app)` compiles and returns the Hono instance in one call.
+
+- **OpenAPI 3.1** output: `openapi: '3.1.0'`, `jsonSchemaDialect` field, `nullable: true` replaced with JSON Schema 2020-12 type arrays (`{ type: ['string', 'null'] }`), full `oneOf` fallback for complex unions.
+
+- **Benchmarks suite** (`benchmarks/`): `bun run benchmark` runs autocannon against veloce-ts, Hono, and Fastify across hello/json/params/validation routes and prints a comparison table.
+
+### Fixed
+
+- GraphQL templates in `veloce new` used `@Query`/`@Mutation` (wrong) — corrected to `@GQLQuery`/`@GQLMutation` with proper `veloce-ts/graphql` imports.
+
+## [1.0.1] - 2026-06-26
+
+### Fixed
+
+- **GraphQL decorator pipeline wired up.** `@Resolver`, `@GQLQuery`, `@GQLMutation`, `@GQLSubscription`, and `@Arg` decorators now correctly connect to `GraphQLPlugin`. Previously the decorators wrote metadata using local symbols that `GraphQLSchemaBuilder` never read — the schema was always empty.
+
+  Pass resolver classes to the plugin via the new `resolvers` option:
+  ```typescript
+  app.usePlugin(new GraphQLPlugin({ resolvers: [UserResolver, PostResolver] }));
+  ```
+  Or register them with `app.include()` before calling `usePlugin()`:
+  ```typescript
+  app.include(UserResolver);
+  app.usePlugin(new GraphQLPlugin());
+  ```
+
+- **`PermissionManager.revokePermission()` bug fixed.** When called without a `resourceId`, the filter condition `resourceId ? p.resourceId !== resourceId : true` always returned `true` (kept all records, removed nothing). Now correctly removes all permissions for the user+resource pair when no `resourceId` is specified.
+
+- **`app.include()` now recognises `@Resolver` classes.** Previously silently ignored — now registers resolver metadata into `MetadataRegistry` so `GraphQLPlugin` can pick it up automatically.
+
+### Added
+
+- **89 new tests** (507 total, 0 failures) covering:
+  - GraphQL decorator metadata pipeline end-to-end
+  - `app.include()` + `resolvers: []` option merge
+  - `PermissionPlugin` construction, `PermissionManager` unit logic, management route auth guards
+  - `HealthCheckPlugin` `/health`, `/ready`, `/live` endpoints, custom check logic, `HealthCheckers` factory
+  - `OAuthPlugin` route behavior, `BaseOAuthProvider`/`GoogleOAuthProvider`/`GitHubOAuthProvider`, `OAuthStateManager`, `PKCEUtils`
+  - Logger (`createLogger`, `getLogger`, `initializeLogger`, `createChildLogger`, child context propagation)
+
 ## [1.0.0] - 2026-06-26
 
 First stable release. Establishes a frozen public API with semver guarantees going forward.
@@ -830,22 +926,22 @@ This release brings powerful performance optimization features to Veloce-TS:
 - CLI tooling
 - Testing utilities
 
-[Unreleased]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v1.0.0...HEAD
-[1.0.0]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.4.18...v1.0.0
-[0.4.18]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.4.10...v0.4.18
-[0.4.10]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.4.9...v0.4.10
-[0.4.0]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.3.3...v0.4.0
-[0.3.3]: https://github.com/AlfredoMejia3001/veloce-ts/releases/tag/v0.3.3
-[0.3.2]: https://github.com/AlfredoMejia3001/veloce-ts/releases/tag/v0.3.2
-[0.3.1]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.3.0...v0.3.1
-[0.2.2]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.2.1...v0.2.2
-[0.2.1]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.2.0...v0.2.1
-[0.2.0]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.1.7...v0.2.0
-[0.1.7]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.1.6...v0.1.7
-[0.1.6]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.1.5...v0.1.6
-[0.1.5]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.1.4...v0.1.5
-[0.1.4]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.1.3...v0.1.4
-[0.1.3]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.1.2...v0.1.3
-[0.1.2]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.1.1...v0.1.2
-[0.1.1]: https://github.com/AlfredoMejia3001/veloce-ts/compare/v0.1.0...v0.1.1
-[0.1.0]: https://github.com/AlfredoMejia3001/veloce-ts/releases/tag/v0.1.0
+[Unreleased]: https://github.com/ExcessHawk/veloce-ts/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/ExcessHawk/veloce-ts/compare/v0.4.18...v1.0.0
+[0.4.18]: https://github.com/ExcessHawk/veloce-ts/compare/v0.4.10...v0.4.18
+[0.4.10]: https://github.com/ExcessHawk/veloce-ts/compare/v0.4.9...v0.4.10
+[0.4.0]: https://github.com/ExcessHawk/veloce-ts/compare/v0.3.3...v0.4.0
+[0.3.3]: https://github.com/ExcessHawk/veloce-ts/releases/tag/v0.3.3
+[0.3.2]: https://github.com/ExcessHawk/veloce-ts/releases/tag/v0.3.2
+[0.3.1]: https://github.com/ExcessHawk/veloce-ts/compare/v0.3.0...v0.3.1
+[0.2.2]: https://github.com/ExcessHawk/veloce-ts/compare/v0.2.1...v0.2.2
+[0.2.1]: https://github.com/ExcessHawk/veloce-ts/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/ExcessHawk/veloce-ts/compare/v0.1.7...v0.2.0
+[0.1.7]: https://github.com/ExcessHawk/veloce-ts/compare/v0.1.6...v0.1.7
+[0.1.6]: https://github.com/ExcessHawk/veloce-ts/compare/v0.1.5...v0.1.6
+[0.1.5]: https://github.com/ExcessHawk/veloce-ts/compare/v0.1.4...v0.1.5
+[0.1.4]: https://github.com/ExcessHawk/veloce-ts/compare/v0.1.3...v0.1.4
+[0.1.3]: https://github.com/ExcessHawk/veloce-ts/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/ExcessHawk/veloce-ts/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/ExcessHawk/veloce-ts/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/ExcessHawk/veloce-ts/releases/tag/v0.1.0

package/README.md

@@ -14,7 +14,7 @@
 [![Bun](https://img.shields.io/badge/Bun-1.0+-black.svg)](https://bun.sh/)
 [![Documentation](https://img.shields.io/badge/docs-online-brightgreen.svg)](https://docs.veloce-ts.com)
 
-[Documentation](https://docs.veloce-ts.com) • [Examples](https://docs.veloce-ts.com/guides/getting-started) • [API Reference](https://docs.veloce-ts.com/reference/api-reference)
+[Documentation](https://docs.veloce-ts.com) • [Examples](https://docs.veloce-ts.com/en/guides/getting-started) • [API Reference](https://docs.veloce-ts.com/en/reference/api-reference)
 
 ---
 
@@ -243,7 +243,7 @@ app.listen(3000);
 <summary><b>WebSocket Support</b></summary>
 
 ```typescript
-import { WebSocket, OnConnect, OnMessage, OnDisconnect } from 'veloce-ts';
+import { WebSocket, OnConnect, OnMessage, OnDisconnect, WebSocketConnection } from 'veloce-ts';
 import { z } from 'zod';
 
 const MessageSchema = z.object({
@@ -496,11 +496,32 @@ app.usePlugin(new OpenAPIPlugin({
   docsPath: '/docs',
 }));
 
-// GraphQL support
+// GraphQL support — pass resolver classes via the resolvers option
+import { Resolver, GQLQuery, GQLMutation, Arg } from 'veloce-ts/graphql';
+import { z } from 'zod';
+
+@Resolver('user')
+class UserResolver {
+  @GQLQuery('getUser')
+  async getUser(@Arg('id', z.string()) id: string) {
+    return { id, name: 'Alice' };
+  }
+
+  @GQLMutation('createUser')
+  async createUser(@Arg('name', z.string()) name: string) {
+    return { id: '1', name };
+  }
+}
+
 app.usePlugin(new GraphQLPlugin({
   path: '/graphql',
   playground: true,
+  resolvers: [UserResolver],   // pass all @Resolver classes here
 }));
+
+// Alternatively, register via app.include() before usePlugin():
+// app.include(UserResolver);
+// app.usePlugin(new GraphQLPlugin({ playground: true }));
 ```
 
 ## 🌐 Multi-Runtime Support
@@ -543,16 +564,16 @@ Directional priorities—not a release calendar. Items may ship in a different o
 
 **Completed in v0.4.18:** Security audit of auth routes, JWT blacklist correctness, MetadataCompiler cache isolation fix, ORM lazy-loading for optional peer deps, 375-test suite, internal micro-benchmarks.
 
-For the latest shipped changes, see [CHANGELOG](CHANGELOG.md). Discussion and proposals: [GitHub Discussions](https://github.com/AlfredoMejia3001/veloce-ts/discussions).
+For the latest shipped changes, see [CHANGELOG](CHANGELOG.md). Discussion and proposals: [GitHub Discussions](https://github.com/ExcessHawk/veloce-ts/discussions).
 
 ## 📖 Documentation
 
 | Resource | Description |
 |----------|-------------|
 | [📚 Full Documentation](https://docs.veloce-ts.com) | Complete guides and API reference |
-| [⚠️ Limitations & roadmap](https://docs.veloce-ts.com/guides/limitations-and-roadmap/) | Known gaps and planned direction |
-| [💡 Examples & Guides](https://docs.veloce-ts.com/guides/getting-started) | Tutorials and code examples |
-| [🔧 API Reference](https://docs.veloce-ts.com/reference/api-reference) | Detailed API documentation |
+| [⚠️ Limitations & roadmap](https://docs.veloce-ts.com/en/guides/limitations-and-roadmap/) | Known gaps and planned direction |
+| [💡 Examples & Guides](https://docs.veloce-ts.com/en/guides/getting-started) | Tutorials and code examples |
+| [🔧 API Reference](https://docs.veloce-ts.com/en/reference/api-reference) | Detailed API documentation |
 
 ## ⚙️ Requirements
 
@@ -587,7 +608,7 @@ For the latest shipped changes, see [CHANGELOG](CHANGELOG.md). Discussion and pr
 - 🔌 Plugin system and extensibility
 
 ### Alfredo Mejia - Project Founder
-**[@AlfredoMejia3001](https://github.com/AlfredoMejia3001)** - Project founder and maintainer
+**[@ExcessHawk](https://github.com/ExcessHawk)** - Project founder and maintainer
 
 ---
 
@@ -610,7 +631,7 @@ Built with ❤️ using:
 
 <div align="center">
 
-**[⭐ Star us on GitHub](https://github.com/AlfredoMejia3001/veloce-ts)** • **[📖 Read the Docs](https://docs.veloce-ts.com)** • **[💬 Join Discussions](https://github.com/AlfredoMejia3001/veloce-ts/discussions)**
+**[⭐ Star us on GitHub](https://github.com/ExcessHawk/veloce-ts)** • **[📖 Read the Docs](https://docs.veloce-ts.com)** • **[💬 Join Discussions](https://github.com/ExcessHawk/veloce-ts/discussions)**
 
 Made with ⚡ by the Veloce team