@noony-serverless/core 0.3.2 → 0.3.3

package/build/utils/container.utils.d.ts

@@ -2,12 +2,12 @@ import type { Context } from '../core/core';
 /**
  * Get a service from the dependency injection container
  *
- * Type-safe utility to resolve services from the TypeDI container
- * without casting.
+ * Type-safe utility to resolve services from the TypeDI container.
+ * Supports both class constructors and string identifiers.
  *
  * @template T The service type to resolve
  * @param context - Request context containing the DI container
- * @param serviceClass - Service class constructor
+ * @param serviceIdentifier - Service class constructor OR string identifier
  * @returns Service instance
  * @throws Error if container is not initialized
  *
@@ -16,13 +16,26 @@ import type { Context } from '../core/core';
  * import { getService } from '@noony-serverless/core';
  * import { UserService } from '../services/user.service';
  *
- * export async function createUserController(context: Context<CreateUserRequest>) {
- *   const userService = getService(context, UserService); // Type-safe!
+ * // ✅ Best: Class-based access (type inferred automatically)
+ * export async function handler(context: Context) {
+ *   const userService = getService(context, UserService);
+ *   // userService is typed as UserService automatically
+ *   const users = await userService.getUsers();
+ * }
+ *
+ * // ✅ Good: String-based with explicit generic (when manual instantiation required)
+ * export async function handler(context: Context) {
+ *   const planRepo = getService<ActionPlanRepository>(context, 'ActionPlanRepository');
+ *   // planRepo is typed as ActionPlanRepository via explicit generic
+ *   const plan = await planRepo.findById(id);
+ * }
  *
- *   const user = await userService.createUser(context.req.parsedBody);
- *   context.res.status(201).json({ data: user });
+ * // ⚠️ Avoid: String without generic (only for quick prototypes)
+ * export async function handler(context: Context) {
+ *   const repo = getService(context, 'ActionPlanRepository');
+ *   // repo has type 'unknown' - requires manual type assertion
  * }
  * ```
  */
-export declare function getService<T>(context: Context<unknown, unknown>, serviceClass: new (...args: any[]) => T): T;
+export declare function getService<T>(context: Context<unknown, unknown>, serviceIdentifier: (new (...args: any[]) => T) | string): T;
 //# sourceMappingURL=container.utils.d.ts.map

package/build/utils/container.utils.js

@@ -4,12 +4,12 @@ exports.getService = getService;
 /**
  * Get a service from the dependency injection container
  *
- * Type-safe utility to resolve services from the TypeDI container
- * without casting.
+ * Type-safe utility to resolve services from the TypeDI container.
+ * Supports both class constructors and string identifiers.
  *
  * @template T The service type to resolve
  * @param context - Request context containing the DI container
- * @param serviceClass - Service class constructor
+ * @param serviceIdentifier - Service class constructor OR string identifier
  * @returns Service instance
  * @throws Error if container is not initialized
  *
@@ -18,18 +18,31 @@ exports.getService = getService;
  * import { getService } from '@noony-serverless/core';
  * import { UserService } from '../services/user.service';
  *
- * export async function createUserController(context: Context<CreateUserRequest>) {
- *   const userService = getService(context, UserService); // Type-safe!
+ * // ✅ Best: Class-based access (type inferred automatically)
+ * export async function handler(context: Context) {
+ *   const userService = getService(context, UserService);
+ *   // userService is typed as UserService automatically
+ *   const users = await userService.getUsers();
+ * }
+ *
+ * // ✅ Good: String-based with explicit generic (when manual instantiation required)
+ * export async function handler(context: Context) {
+ *   const planRepo = getService<ActionPlanRepository>(context, 'ActionPlanRepository');
+ *   // planRepo is typed as ActionPlanRepository via explicit generic
+ *   const plan = await planRepo.findById(id);
+ * }
  *
- *   const user = await userService.createUser(context.req.parsedBody);
- *   context.res.status(201).json({ data: user });
+ * // ⚠️ Avoid: String without generic (only for quick prototypes)
+ * export async function handler(context: Context) {
+ *   const repo = getService(context, 'ActionPlanRepository');
+ *   // repo has type 'unknown' - requires manual type assertion
  * }
  * ```
  */
-function getService(context, serviceClass) {
+function getService(context, serviceIdentifier) {
     if (!context.container) {
         throw new Error('Container not initialized. Did you forget to add DependencyInjectionMiddleware?');
     }
-    return context.container.get(serviceClass);
+    return context.container.get(serviceIdentifier);
 }
 //# sourceMappingURL=container.utils.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noony-serverless/core",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "A Middy base framework compatible with Firebase and GCP Cloud Functions with TypeScript",
   "main": "build/index.js",
   "types": "build/index.d.ts",