@riktajs/core 0.4.1 → 0.4.2

package/README.md

@@ -1,179 +1,54 @@
-# 🧭 Rikta
-
-> **The Zero-Config TypeScript Framework for Modern Backends.**
- 
-Build scalable APIs with the power of Fastify and the elegance of decorators. No modules. No boilerplate. Just code.
-
-[![NPM Version](https://img.shields.io/npm/v/@riktajs/core)](https://www.npmjs.com/package/@riktajs/core)
-[![License](https://img.shields.io/npm/l/@riktajs/core)](LICENSE)
-
----
-
-## 🤔 Why Rikta?
-
-Are you tired of **"Module Hell"** in NestJS? Do you miss the simplicity of Express but need the structure of a real framework?
-
-**Rikta** is designed for developers who want to move fast without breaking things.
-
-*   🚀 **Zero-Config Autowiring:** No `imports: []`, `exports: []`, or `providers: []` arrays. Just decorate your class, and it works.
-*   ⚡ **Fastify Powered:** Built on top of Fastify for maximum performance and low overhead.
-*   🛡️ **Type-Safe by Default:** Native Zod integration for validation that infers your TypeScript types automatically.
-*   🔄 **Hybrid Lifecycle:** Powerful hooks and an event bus for complex application flows.
-
-Rikta is nordic for "guide". Let Rikta guide you to build better backends, faster.
-
----
-
-## ⚡ Quick Start
-
-### 1. Install
-
-```bash
-npm install @riktajs/core
-```
-
-### 2. Create your App
-
-No complex setup. Just one file is enough to start.
-
-```typescript
-// main.ts
-import { Rikta, Controller, Injectable, Get, Post, Body, Autowired, z } from '@riktajs/core';
-
-// 1. Define a Service (Auto-discovered!)
-@Injectable()
-class UserService {
-  private users = [{ id: 1, name: 'Rikta User' }];
-
-  findAll() { return this.users; }
-  
-  create(name: string) {
-    const user = { id: this.users.length + 1, name };
-    this.users.push(user);
-    return user;
-  }
-}
-
-// 2. Define a Schema (Type-safe!)
-const CreateUserSchema = z.object({
-  name: z.string().min(3)
-});
-
-// 3. Define a Controller (Auto-discovered!)
-@Controller('/users')
-export class UserController {
-  @Autowired()
-  private userService!: UserService; // Dependency Injection works like magic
-
-  @Get()
-  getUsers() {
-    return this.userService.findAll();
-  }
-
-  @Post()
-  createUser(@Body(CreateUserSchema) body: z.infer<typeof CreateUserSchema>) {
-    // 'body' is fully typed here!
-    return this.userService.create(body.name);
-  }
-}
-
-// 4. Run it!
-// autowired paths are resolved relative to your project, not node_modules!
-const app = await Rikta.create({ 
-  port: 3000, 
-  autowired: ['./src']  // Relative paths are resolved from YOUR project directory
-});
-await app.listen();
-console.log('🚀 Server running on http://localhost:3000');
-```
-
----
-
-## 📚 Documentation
-
-Everything you need to build production-ready APIs.
-
-| Guide | Description |
-|-------|-------------|
-| [**Architecture**](./docs/guide/architecture.md) | How Rikta's auto-discovery works under the hood. |
-| [**Dependency Injection**](./docs/guide/dependency-injection.md) | Using `@Autowired`, tokens, and scopes. |
-| [**Configuration**](./docs/guide/configuration.md) | Type-safe configuration with .env and Zod validation. |
-| [**Routing**](./docs/guide/routing.md) | Controllers, methods, and parameter handling. |
-| [**Validation**](./docs/guide/validation.md) | **New!** Type-safe validation with Zod. |
-| [**Lifecycle**](./docs/guide/lifecycle.md) | Hooks (`OnProviderInit`) and the Event Bus. |
-| [**Error Handling**](./docs/guide/error-handling.md) | Exception filters and standard JSON responses. |
-| [**Benchmarks**](./benchmarks/README.md) | Performance comparison with Fastify & NestJS. |
-
----
-
-## ⚡ Performance
-
-Rikta is built on Fastify and delivers **excellent performance**. From our [benchmarks](./benchmarks/README.md):
-
-| Metric | Rikta vs NestJS | Result |
-|--------|-----------------|--------|
-| **Startup** | 🟢 **-37.7%** | Rikta is faster |
-| **GET requests** | 🟢 **-44.3%** | Rikta is faster |
-| **POST requests** | 🟢 **-14.8%** | Rikta is faster |
-| **Param requests** | 🟢 **-36.7%** | Rikta is faster |
-| **Average** | 🟢 **-32.0%** | Rikta is faster |
-
-For detailed tests:
-```bash
-cd benchmarks
-npm install
-npm run bench
-```
-
-### Production Mode
-
-For maximum performance, use silent mode:
-
-```typescript
-const app = await Rikta.create({
-  port: 3000,
-  silent: true,   // Disable all console output
-  logger: false   // Disable Fastify logging
-});
-```
-
----
-
-## ✨ Key Features
-
-### 🚫 No Modules, Just Logic
-Forget about `AppModule`, `UserModule`, `SharedModule`. Rikta scans your code and resolves dependencies automatically.
-
-### ✅ Native Zod Validation
-Don't duplicate your types. Define a Zod schema, and Rikta validates the request *and* gives you the TypeScript type.
-
-```typescript
-@Post()
-create(@Body(UserSchema) user: z.infer<typeof UserSchema>) {
-  // If we get here, 'user' is valid and typed.
-  // If not, Rikta returns a 400 Bad Request automatically.
-}
-```
-
-### 🔌 Powerful Dependency Injection
-Support for Singleton (default) and Transient scopes, factory providers, and value tokens.
-
-```typescript
-@Injectable()
-class AuthService {
-  constructor(
-    @Autowired(DB_CONFIG) private config: Config,
-    @Autowired() private logger: LoggerService
-  ) {}
-}
-```
-
----
-
-## 🤝 Contributing
-
-We love contributions! Please check our [Contributing Guide](CONTRIBUTING.md) (Coming Soon) and join our community.
-
-## 📄 License
-
-Rikta is [MIT licensed](LICENSE).
+# @riktajs/core
+
+The core package of the Rikta framework.
+
+See the [main repository README](../../README.md) for full documentation.
+
+## Installation
+
+```bash
+npm install @riktajs/core
+```
+
+## Quick Start
+
+```typescript
+import { Rikta, Controller, Injectable, Get, Autowired } from '@riktajs/core';
+
+@Injectable()
+class HelloService {
+  getMessage() {
+    return { message: 'Hello from Rikta!' };
+  }
+}
+
+@Controller('/api')
+class HelloController {
+  @Autowired()
+  private helloService!: HelloService;
+
+  @Get('/hello')
+  getHello() {
+    return this.helloService.getMessage();
+  }
+}
+
+const app = await Rikta.create({ 
+  port: 3000, 
+  autowired: ['./src']
+});
+await app.listen();
+```
+
+## Features
+
+- 🚀 Zero-Config Autowiring
+- ⚡ Fastify Powered
+- 🛡️ Type-Safe by Default
+- 🔄 Hybrid Lifecycle
+- 📦 Built-in Dependency Injection
+- ✅ Zod Validation Integration
+
+## License
+
+MIT

package/dist/core/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,eAAe,eAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,cAAc,eAA2B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,eAAe,eAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,qBAAqB,eAAkC,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,eAAe,eAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAM7D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,eAAqC,CAAC;AAE3E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB,eAAqC,CAAC;AAE3E;;GAEG;AACH,oBAAY,SAAS;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAA0C,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,eAAe,eAAsC,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAA0C,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,cAAc,eAAqC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,eAAe,eAAsC,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,qBAAqB,eAA4C,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAA0C,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAAyC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAAuC,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,eAAe,eAAsC,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAA0C,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAAyC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,iBAAiB,eAAwC,CAAC;AAMvE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,eAAqC,CAAC;AAE3E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB,eAAqC,CAAC;AAE3E;;GAEG;AACH,oBAAY,SAAS;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC"}

package/dist/core/constants.js

@@ -1,61 +1,62 @@
 "use strict";
 // ============================================================================
 // Metadata Keys for Reflect API
+// Using Symbol.for() to ensure symbols are shared across packages
 // ============================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_CONFIG = exports.ParamType = exports.CONFIG_PROPERTY_METADATA = exports.CONFIG_PROVIDER_METADATA = exports.PROVIDER_METADATA = exports.AUTOWIRED_METADATA = exports.ZOD_SCHEMA_METADATA = exports.INJECT_METADATA = exports.HEADERS_METADATA = exports.HTTP_CODE_METADATA = exports.MIDDLEWARE_METADATA = exports.INTERCEPTORS_METADATA = exports.GUARDS_METADATA = exports.PARAM_METADATA = exports.INJECTABLE_METADATA = exports.ROUTES_METADATA = exports.CONTROLLER_METADATA = void 0;
 /**
  * Key for storing controller metadata (prefix, routes)
  */
-exports.CONTROLLER_METADATA = Symbol('controller:metadata');
+exports.CONTROLLER_METADATA = Symbol.for('rikta:controller:metadata');
 /**
  * Key for storing route definitions on a controller
  */
-exports.ROUTES_METADATA = Symbol('routes:metadata');
+exports.ROUTES_METADATA = Symbol.for('rikta:routes:metadata');
 /**
  * Key for storing injectable options
  */
-exports.INJECTABLE_METADATA = Symbol('injectable:metadata');
+exports.INJECTABLE_METADATA = Symbol.for('rikta:injectable:metadata');
 /**
  * Key for storing parameter injection metadata
  */
-exports.PARAM_METADATA = Symbol('param:metadata');
+exports.PARAM_METADATA = Symbol.for('rikta:param:metadata');
 /**
  * Key for storing guards
  */
-exports.GUARDS_METADATA = Symbol('guards:metadata');
+exports.GUARDS_METADATA = Symbol.for('rikta:guards:metadata');
 /**
  * Key for storing interceptors
  */
-exports.INTERCEPTORS_METADATA = Symbol('interceptors:metadata');
+exports.INTERCEPTORS_METADATA = Symbol.for('rikta:interceptors:metadata');
 /**
  * Key for storing middleware
  */
-exports.MIDDLEWARE_METADATA = Symbol('middleware:metadata');
+exports.MIDDLEWARE_METADATA = Symbol.for('rikta:middleware:metadata');
 /**
  * Key for storing response status code
  */
-exports.HTTP_CODE_METADATA = Symbol('http:code:metadata');
+exports.HTTP_CODE_METADATA = Symbol.for('rikta:http:code:metadata');
 /**
  * Key for storing response headers
  */
-exports.HEADERS_METADATA = Symbol('headers:metadata');
+exports.HEADERS_METADATA = Symbol.for('rikta:headers:metadata');
 /**
  * Key for storing @Inject() metadata on constructor parameters
  */
-exports.INJECT_METADATA = Symbol('inject:metadata');
+exports.INJECT_METADATA = Symbol.for('rikta:inject:metadata');
 /**
  * Key for storing Zod validation schema on parameters
  */
-exports.ZOD_SCHEMA_METADATA = Symbol('zod:schema:metadata');
+exports.ZOD_SCHEMA_METADATA = Symbol.for('rikta:zod:schema:metadata');
 /**
  * Key for storing @Autowired() property injection metadata
  */
-exports.AUTOWIRED_METADATA = Symbol('autowired:metadata');
+exports.AUTOWIRED_METADATA = Symbol.for('rikta:autowired:metadata');
 /**
  * Key for storing @Provider() metadata
  */
-exports.PROVIDER_METADATA = Symbol('provider:metadata');
+exports.PROVIDER_METADATA = Symbol.for('rikta:provider:metadata');
 // ============================================================================
 // Configuration Metadata Keys
 // ============================================================================

package/dist/core/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;;;AAE/E;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE;;GAEG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEzD;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE;;GAEG;AACU,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAEvD;;GAEG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEzD;;GAEG;AACU,QAAA,qBAAqB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAErE;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE;;GAEG;AACU,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAE/D;;GAEG;AACU,QAAA,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAE3D;;GAEG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEzD;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE;;GAEG;AACU,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAE/D;;GAEG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAE7D,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E;;;;;;;;;;;;;GAaG;AACU,QAAA,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAE3E;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAE3E;;GAEG;AACH,IAAY,SAQX;AARD,WAAY,SAAS;IACnB,0BAAa,CAAA;IACb,4BAAe,CAAA;IACf,4BAAe,CAAA;IACf,gCAAmB,CAAA;IACnB,gCAAmB,CAAA;IACnB,4BAAe,CAAA;IACf,gCAAmB,CAAA;AACrB,CAAC,EARW,SAAS,yBAAT,SAAS,QAQpB;AAED;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,EAAE;CACF,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,gCAAgC;AAChC,kEAAkE;AAClE,+EAA+E;;;AAE/E;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAE3E;;GAEG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAEnE;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAE3E;;GAEG;AACU,QAAA,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAEjE;;GAEG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAEnE;;GAEG;AACU,QAAA,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAE/E;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAE3E;;GAEG;AACU,QAAA,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAEzE;;GAEG;AACU,QAAA,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAErE;;GAEG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAEnE;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAE3E;;GAEG;AACU,QAAA,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAEzE;;GAEG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAEvE,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E;;;;;;;;;;;;;GAaG;AACU,QAAA,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAE3E;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAE3E;;GAEG;AACH,IAAY,SAQX;AARD,WAAY,SAAS;IACnB,0BAAa,CAAA;IACb,4BAAe,CAAA;IACf,4BAAe,CAAA;IACf,gCAAmB,CAAA;IACnB,gCAAmB,CAAA;IACnB,4BAAe,CAAA;IACf,gCAAmB,CAAA;AACrB,CAAC,EARW,SAAS,yBAAT,SAAS,QAQpB;AAED;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,EAAE;CACF,CAAC"}

package/dist/core/index.d.ts

@@ -10,6 +10,7 @@ export * from './decorators';
 export * from './exceptions';
 export * from './guards';
 export * from './config';
+export * from './metadata';
 export { z } from 'zod';
 export type { ZodType, ZodSchema, ZodError, ZodIssue, infer as ZodInfer } from 'zod';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AAKzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,KAAK,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAK3B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,KAAK,CAAC"}

package/dist/core/index.js

@@ -28,6 +28,7 @@ __exportStar(require("./decorators"), exports);
 __exportStar(require("./exceptions"), exports);
 __exportStar(require("./guards"), exports);
 __exportStar(require("./config"), exports);
+__exportStar(require("./metadata"), exports);
 // Re-export Zod for convenience
 // This allows users to import everything from '@riktajs/core':
 // import { z, Body, Controller } from '@riktajs/core';

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,eAAe;AACf,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B;AAC5B,6CAA2B;AAC3B,8CAA4B;AAC5B,8CAA4B;AAC5B,kDAAgC;AAChC,gDAA8B;AAC9B,+CAA6B;AAC7B,+CAA6B;AAC7B,2CAAyB;AACzB,2CAAyB;AAEzB,gCAAgC;AAChC,+DAA+D;AAC/D,uDAAuD;AACvD,2BAAwB;AAAf,wFAAA,CAAC,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,eAAe;AACf,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B;AAC5B,6CAA2B;AAC3B,8CAA4B;AAC5B,8CAA4B;AAC5B,kDAAgC;AAChC,gDAA8B;AAC9B,+CAA6B;AAC7B,+CAA6B;AAC7B,2CAAyB;AACzB,2CAAyB;AACzB,6CAA2B;AAE3B,gCAAgC;AAChC,+DAA+D;AAC/D,uDAAuD;AACvD,2BAAwB;AAAf,wFAAA,CAAC,OAAA"}

package/dist/core/metadata.d.ts

@@ -0,0 +1,66 @@
+import 'reflect-metadata';
+import type { RouteDefinition, ControllerMetadata } from './types';
+import type { ParamMetadata } from './decorators/param.decorator';
+type Constructor<T = unknown> = new (...args: any[]) => T;
+/**
+ * Get controller metadata (path prefix, etc.)
+ */
+export declare function getControllerMetadata(target: Constructor): ControllerMetadata | undefined;
+/**
+ * Check if a class is a controller
+ */
+export declare function isController(target: Constructor): boolean;
+/**
+ * Get controller path prefix
+ */
+export declare function getControllerPath(target: Constructor): string;
+/**
+ * Get all routes defined on a controller
+ */
+export declare function getRoutes(target: Constructor): RouteDefinition[];
+/**
+ * Check if a controller has any routes
+ */
+export declare function hasRoutes(target: Constructor): boolean;
+/**
+ * Get parameter metadata for a specific method
+ */
+export declare function getParamMetadata(target: Constructor, methodName: string | symbol): ParamMetadata[];
+/**
+ * Get parameter metadata by index
+ */
+export declare function getParamMetadataByIndex(target: Constructor, methodName: string | symbol, paramIndex: number): ParamMetadata | undefined;
+/**
+ * Get custom HTTP status code for a method
+ */
+export declare function getHttpCode(target: Constructor, methodName: string | symbol): number | undefined;
+/**
+ * Get guards for a controller or method
+ */
+export declare function getGuards(target: Constructor, methodName?: string | symbol): Function[];
+/**
+ * Get Zod schema metadata for a method parameter
+ */
+export declare function getZodSchema(target: Constructor, methodName: string | symbol): unknown;
+/**
+ * Get any metadata from a class
+ */
+export declare function getClassMetadata<T = unknown>(metadataKey: symbol, target: Constructor): T | undefined;
+/**
+ * Get any metadata from a method
+ */
+export declare function getMethodMetadata<T = unknown>(metadataKey: symbol, target: Constructor, methodName: string | symbol): T | undefined;
+/**
+ * Check if a class has specific metadata
+ */
+export declare function hasClassMetadata(metadataKey: symbol, target: Constructor): boolean;
+/**
+ * Check if a method has specific metadata
+ */
+export declare function hasMethodMetadata(metadataKey: symbol, target: Constructor, methodName: string | symbol): boolean;
+/**
+ * Get all method names that have a specific metadata key
+ */
+export declare function getMethodsWithMetadata(metadataKey: symbol, target: Constructor): (string | symbol)[];
+export {};
+//# sourceMappingURL=metadata.d.ts.map

package/dist/core/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/core/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAS1B,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,KAAK,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAM1D;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,kBAAkB,GAAG,SAAS,CAEzF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAG7D;AAMD;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,EAAE,CAEhE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAGtD;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GAAG,MAAM,GAC1B,aAAa,EAAE,CAEjB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,UAAU,EAAE,MAAM,GACjB,aAAa,GAAG,SAAS,CAG3B;AAMD;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GAAG,MAAM,GAC1B,MAAM,GAAG,SAAS,CAEpB;AAMD;;GAEG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAC3B,QAAQ,EAAE,CAUZ;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GAAG,MAAM,GAC1B,OAAO,CAET;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAC1C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,CAAC,GAAG,SAAS,CAEf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC3C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GAAG,MAAM,GAC1B,CAAC,GAAG,SAAS,CAEf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GAAG,MAAM,GAC1B,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAerB"}

package/dist/core/metadata.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getControllerMetadata = getControllerMetadata;
+exports.isController = isController;
+exports.getControllerPath = getControllerPath;
+exports.getRoutes = getRoutes;
+exports.hasRoutes = hasRoutes;
+exports.getParamMetadata = getParamMetadata;
+exports.getParamMetadataByIndex = getParamMetadataByIndex;
+exports.getHttpCode = getHttpCode;
+exports.getGuards = getGuards;
+exports.getZodSchema = getZodSchema;
+exports.getClassMetadata = getClassMetadata;
+exports.getMethodMetadata = getMethodMetadata;
+exports.hasClassMetadata = hasClassMetadata;
+exports.hasMethodMetadata = hasMethodMetadata;
+exports.getMethodsWithMetadata = getMethodsWithMetadata;
+require("reflect-metadata");
+const constants_1 = require("./constants");
+// ============================================================================
+// Controller Metadata
+// ============================================================================
+/**
+ * Get controller metadata (path prefix, etc.)
+ */
+function getControllerMetadata(target) {
+    return Reflect.getMetadata(constants_1.CONTROLLER_METADATA, target);
+}
+/**
+ * Check if a class is a controller
+ */
+function isController(target) {
+    return Reflect.hasMetadata(constants_1.CONTROLLER_METADATA, target);
+}
+/**
+ * Get controller path prefix
+ */
+function getControllerPath(target) {
+    const meta = getControllerMetadata(target);
+    return meta?.prefix ?? '';
+}
+// ============================================================================
+// Route Metadata
+// ============================================================================
+/**
+ * Get all routes defined on a controller
+ */
+function getRoutes(target) {
+    return Reflect.getMetadata(constants_1.ROUTES_METADATA, target) || [];
+}
+/**
+ * Check if a controller has any routes
+ */
+function hasRoutes(target) {
+    const routes = getRoutes(target);
+    return routes.length > 0;
+}
+// ============================================================================
+// Parameter Metadata
+// ============================================================================
+/**
+ * Get parameter metadata for a specific method
+ */
+function getParamMetadata(target, methodName) {
+    return Reflect.getMetadata(constants_1.PARAM_METADATA, target.prototype, methodName) || [];
+}
+/**
+ * Get parameter metadata by index
+ */
+function getParamMetadataByIndex(target, methodName, paramIndex) {
+    const params = getParamMetadata(target, methodName);
+    return params.find(p => p.index === paramIndex);
+}
+// ============================================================================
+// HTTP Code Metadata
+// ============================================================================
+/**
+ * Get custom HTTP status code for a method
+ */
+function getHttpCode(target, methodName) {
+    return Reflect.getMetadata(constants_1.HTTP_CODE_METADATA, target.prototype, methodName);
+}
+// ============================================================================
+// Guards Metadata
+// ============================================================================
+/**
+ * Get guards for a controller or method
+ */
+function getGuards(target, methodName) {
+    if (methodName) {
+        // Method-level guards
+        const methodGuards = Reflect.getMetadata(constants_1.GUARDS_METADATA, target.prototype, methodName) || [];
+        // Controller-level guards
+        const controllerGuards = Reflect.getMetadata(constants_1.GUARDS_METADATA, target) || [];
+        return [...controllerGuards, ...methodGuards];
+    }
+    // Controller-level only
+    return Reflect.getMetadata(constants_1.GUARDS_METADATA, target) || [];
+}
+// ============================================================================
+// Zod Schema Metadata
+// ============================================================================
+/**
+ * Get Zod schema metadata for a method parameter
+ */
+function getZodSchema(target, methodName) {
+    return Reflect.getMetadata(constants_1.ZOD_SCHEMA_METADATA, target.prototype, methodName);
+}
+// ============================================================================
+// Generic Metadata Access
+// ============================================================================
+/**
+ * Get any metadata from a class
+ */
+function getClassMetadata(metadataKey, target) {
+    return Reflect.getMetadata(metadataKey, target);
+}
+/**
+ * Get any metadata from a method
+ */
+function getMethodMetadata(metadataKey, target, methodName) {
+    return Reflect.getMetadata(metadataKey, target.prototype, methodName);
+}
+/**
+ * Check if a class has specific metadata
+ */
+function hasClassMetadata(metadataKey, target) {
+    return Reflect.hasMetadata(metadataKey, target);
+}
+/**
+ * Check if a method has specific metadata
+ */
+function hasMethodMetadata(metadataKey, target, methodName) {
+    return Reflect.hasMetadata(metadataKey, target.prototype, methodName);
+}
+/**
+ * Get all method names that have a specific metadata key
+ */
+function getMethodsWithMetadata(metadataKey, target) {
+    const methods = [];
+    const prototype = target.prototype;
+    // Get all property names including symbols
+    const propertyNames = Object.getOwnPropertyNames(prototype);
+    const propertySymbols = Object.getOwnPropertySymbols(prototype);
+    for (const name of [...propertyNames, ...propertySymbols]) {
+        if (name !== 'constructor' && Reflect.hasMetadata(metadataKey, prototype, name)) {
+            methods.push(name);
+        }
+    }
+    return methods;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/core/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/core/metadata.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riktajs/core",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "A fast and modern TypeScript backend framework with zero-config autowiring, powered by Fastify",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,16 +10,9 @@
   "scripts": {
     "build": "tsc",
     "dev": "ts-node-dev --respawn src/index.ts",
-    "example": "ts-node example/src/main.ts",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "lint": "eslint src --ext .ts",
-    "prepublishOnly": "npm run build",
-    "bench": "cd benchmarks && npm install && npm run bench",
-    "bench:startup": "cd benchmarks && npm install && npm run bench:startup",
-    "bench:requests": "cd benchmarks && npm install && npm run bench:requests",
-    "bench:autocannon": "cd benchmarks && npm install && npm run bench:autocannon"
+    "test:coverage": "vitest run --coverage"
   },
   "keywords": [
     "framework",

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 riktaHQ
-
-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/dist/core/decorators/provider-config.decorator.d.ts

@@ -1,107 +0,0 @@
-import 'reflect-metadata';
-import { Constructor } from '../types';
-/**
- * Config provider metadata stored on the class
- */
-export interface ConfigProviderMetadata {
-    /**
-     * The injection token for this config provider
-     * @example 'APP_CONFIG', 'DATABASE_CONFIG'
-     */
-    token: string;
-}
-/**
- * @ProviderConfig() decorator
- *
- * Marks a class as a configuration provider that will be auto-discovered.
- * Config providers extend AbstractConfigProvider and manage environment variables,
- * validation with Zod schemas, and property mapping via @ConfigProperty.
- *
- * The decorator automatically generates an injection token from the class name
- * if not explicitly provided, following the pattern: ClassName → CLASS_NAME_CONFIG
- *
- * @param token - Optional custom injection token (must be UPPERCASE)
- *
- * @example Auto-generated token:
- * ```typescript
- * import { ProviderConfig, AbstractConfigProvider } from '@riktajs/core';
- * import { z } from 'zod';
- *
- * @ProviderConfig() // Token: 'APP_CONFIG'
- * export class AppConfigProvider extends AbstractConfigProvider {
- *   schema() {
- *     return z.object({
- *       PORT: z.coerce.number().int().min(1).max(65535),
- *       HOST: z.string().default('localhost'),
- *     });
- *   }
- *
- *   @ConfigProperty()
- *   port!: number;
- *
- *   @ConfigProperty()
- *   host!: string;
- * }
- *
- * // Inject with auto-generated token
- * @Injectable()
- * class MyService {
- *   @Autowired('APP_CONFIG')
- *   private config!: AppConfigProvider;
- * }
- * ```
- *
- * @example Custom token:
- * ```typescript
- * @ProviderConfig('DATABASE_CONFIG')
- * export class DbConfigProvider extends AbstractConfigProvider {
- *   schema() {
- *     return z.object({
- *       DB_HOST: z.string(),
- *       DB_PORT: z.coerce.number().int(),
- *       DB_NAME: z.string(),
- *     });
- *   }
- * }
- *
- * // Inject with custom token
- * @Injectable()
- * class DatabaseService {
- *   @Autowired('DATABASE_CONFIG')
- *   private config!: DbConfigProvider;
- * }
- * ```
- *
- * @example Type-safe token export:
- * ```typescript
- * export const APP_CONFIG = 'APP_CONFIG' as const;
- *
- * @ProviderConfig(APP_CONFIG)
- * export class AppConfigProvider extends AbstractConfigProvider {
- *   // ...
- * }
- *
- * // Type-safe injection
- * @Injectable()
- * class MyService {
- *   @Autowired(APP_CONFIG)
- *   private config!: AppConfigProvider;
- * }
- * ```
- */
-export declare function ProviderConfig(token?: string): ClassDecorator;
-/**
- * Helper to retrieve config provider metadata from a class
- *
- * @param target - The class to retrieve metadata from
- * @returns The config provider metadata or undefined
- */
-export declare function getConfigProviderMetadata(target: Constructor): ConfigProviderMetadata | undefined;
-/**
- * Check if a class has @ProviderConfig decorator
- *
- * @param target - The class to check
- * @returns True if the class is decorated with @ProviderConfig
- */
-export declare function isConfigProvider(target: Constructor): boolean;
-//# sourceMappingURL=provider-config.decorator.d.ts.map

package/dist/core/decorators/provider-config.decorator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"provider-config.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/provider-config.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAkCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,CAgC7D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,WAAW,GAClB,sBAAsB,GAAG,SAAS,CAEpC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAE7D"}

package/dist/core/decorators/provider-config.decorator.js

@@ -1,156 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProviderConfig = ProviderConfig;
-exports.getConfigProviderMetadata = getConfigProviderMetadata;
-exports.isConfigProvider = isConfigProvider;
-require("reflect-metadata");
-const constants_1 = require("../constants");
-/**
- * Convert a class name to an uppercase config token
- *
- * @param className - The class name to convert
- * @returns Uppercase token name
- *
- * @example
- * ```typescript
- * generateToken('AppConfigProvider') // Returns 'APP_CONFIG'
- * generateToken('DatabaseConfigProvider') // Returns 'DATABASE_CONFIG'
- * generateToken('MyCustomConfig') // Returns 'MY_CUSTOM_CONFIG'
- * ```
- */
-function generateTokenFromClassName(className) {
-    // Remove 'Provider' suffix if present
-    let tokenName = className.replace(/Provider$/, '');
-    // Convert camelCase/PascalCase to UPPER_SNAKE_CASE
-    tokenName = tokenName
-        .replace(/([A-Z])/g, '_$1')
-        .toUpperCase()
-        .replace(/^_/, '');
-    // Ensure it ends with _CONFIG if not already present
-    // But don't add it if the name already ends with CONFIG (after conversion)
-    if (!tokenName.endsWith('_CONFIG') && tokenName !== 'CONFIG') {
-        tokenName = `${tokenName}_CONFIG`;
-    }
-    return tokenName;
-}
-/**
- * @ProviderConfig() decorator
- *
- * Marks a class as a configuration provider that will be auto-discovered.
- * Config providers extend AbstractConfigProvider and manage environment variables,
- * validation with Zod schemas, and property mapping via @ConfigProperty.
- *
- * The decorator automatically generates an injection token from the class name
- * if not explicitly provided, following the pattern: ClassName → CLASS_NAME_CONFIG
- *
- * @param token - Optional custom injection token (must be UPPERCASE)
- *
- * @example Auto-generated token:
- * ```typescript
- * import { ProviderConfig, AbstractConfigProvider } from '@riktajs/core';
- * import { z } from 'zod';
- *
- * @ProviderConfig() // Token: 'APP_CONFIG'
- * export class AppConfigProvider extends AbstractConfigProvider {
- *   schema() {
- *     return z.object({
- *       PORT: z.coerce.number().int().min(1).max(65535),
- *       HOST: z.string().default('localhost'),
- *     });
- *   }
- *
- *   @ConfigProperty()
- *   port!: number;
- *
- *   @ConfigProperty()
- *   host!: string;
- * }
- *
- * // Inject with auto-generated token
- * @Injectable()
- * class MyService {
- *   @Autowired('APP_CONFIG')
- *   private config!: AppConfigProvider;
- * }
- * ```
- *
- * @example Custom token:
- * ```typescript
- * @ProviderConfig('DATABASE_CONFIG')
- * export class DbConfigProvider extends AbstractConfigProvider {
- *   schema() {
- *     return z.object({
- *       DB_HOST: z.string(),
- *       DB_PORT: z.coerce.number().int(),
- *       DB_NAME: z.string(),
- *     });
- *   }
- * }
- *
- * // Inject with custom token
- * @Injectable()
- * class DatabaseService {
- *   @Autowired('DATABASE_CONFIG')
- *   private config!: DbConfigProvider;
- * }
- * ```
- *
- * @example Type-safe token export:
- * ```typescript
- * export const APP_CONFIG = 'APP_CONFIG' as const;
- *
- * @ProviderConfig(APP_CONFIG)
- * export class AppConfigProvider extends AbstractConfigProvider {
- *   // ...
- * }
- *
- * // Type-safe injection
- * @Injectable()
- * class MyService {
- *   @Autowired(APP_CONFIG)
- *   private config!: AppConfigProvider;
- * }
- * ```
- */
-function ProviderConfig(token) {
-    return (target) => {
-        const className = target.name;
-        // Generate token from class name if not provided
-        const configToken = token ?? generateTokenFromClassName(className);
-        // Validate token format
-        if (!configToken || typeof configToken !== 'string') {
-            throw new Error(`@ProviderConfig: Invalid token for class "${className}". Token must be a non-empty string.`);
-        }
-        // Ensure token is uppercase (convention)
-        if (configToken !== configToken.toUpperCase()) {
-            throw new Error(`@ProviderConfig: Token "${configToken}" for class "${className}" must be UPPERCASE. ` +
-                `Use "${configToken.toUpperCase()}" instead.`);
-        }
-        // Store metadata
-        const metadata = {
-            token: configToken,
-        };
-        Reflect.defineMetadata(constants_1.CONFIG_PROVIDER_METADATA, metadata, target);
-        // Note: Registration with the Registry will happen during auto-discovery (Step 3)
-        // For now, we just store the metadata
-    };
-}
-/**
- * Helper to retrieve config provider metadata from a class
- *
- * @param target - The class to retrieve metadata from
- * @returns The config provider metadata or undefined
- */
-function getConfigProviderMetadata(target) {
-    return Reflect.getMetadata(constants_1.CONFIG_PROVIDER_METADATA, target);
-}
-/**
- * Check if a class has @ProviderConfig decorator
- *
- * @param target - The class to check
- * @returns True if the class is decorated with @ProviderConfig
- */
-function isConfigProvider(target) {
-    return Reflect.hasMetadata(constants_1.CONFIG_PROVIDER_METADATA, target);
-}
-//# sourceMappingURL=provider-config.decorator.js.map

package/dist/core/decorators/provider-config.decorator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"provider-config.decorator.js","sourceRoot":"","sources":["../../../src/core/decorators/provider-config.decorator.ts"],"names":[],"mappings":";;AA8HA,wCAgCC;AAQD,8DAIC;AAQD,4CAEC;AApLD,4BAA0B;AAC1B,4CAAwD;AAcxD;;;;;;;;;;;;GAYG;AACH,SAAS,0BAA0B,CAAC,SAAiB;IACnD,sCAAsC;IACtC,IAAI,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAEnD,mDAAmD;IACnD,SAAS,GAAG,SAAS;SAClB,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;SAC1B,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAErB,qDAAqD;IACrD,2EAA2E;IAC3E,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC7D,SAAS,GAAG,GAAG,SAAS,SAAS,CAAC;IACpC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,CAA6B,MAAiB,EAAE,EAAE;QACvD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC;QAE9B,iDAAiD;QACjD,MAAM,WAAW,GAAG,KAAK,IAAI,0BAA0B,CAAC,SAAS,CAAC,CAAC;QAEnE,wBAAwB;QACxB,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CACb,6CAA6C,SAAS,sCAAsC,CAC7F,CAAC;QACJ,CAAC;QAED,yCAAyC;QACzC,IAAI,WAAW,KAAK,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CACb,2BAA2B,WAAW,gBAAgB,SAAS,uBAAuB;gBACtF,QAAQ,WAAW,CAAC,WAAW,EAAE,YAAY,CAC9C,CAAC;QACJ,CAAC;QAED,iBAAiB;QACjB,MAAM,QAAQ,GAA2B;YACvC,KAAK,EAAE,WAAqB;SAC7B,CAAC;QAEF,OAAO,CAAC,cAAc,CAAC,oCAAwB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEnE,kFAAkF;QAClF,sCAAsC;IACxC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,yBAAyB,CACvC,MAAmB;IAEnB,OAAO,OAAO,CAAC,WAAW,CAAC,oCAAwB,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,MAAmB;IAClD,OAAO,OAAO,CAAC,WAAW,CAAC,oCAAwB,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC"}