@noony-serverless/core 0.3.1 → 0.3.2

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

@@ -0,0 +1,28 @@
+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.
+ *
+ * @template T The service type to resolve
+ * @param context - Request context containing the DI container
+ * @param serviceClass - Service class constructor
+ * @returns Service instance
+ * @throws Error if container is not initialized
+ *
+ * @example
+ * ```typescript
+ * 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!
+ *
+ *   const user = await userService.createUser(context.req.parsedBody);
+ *   context.res.status(201).json({ data: user });
+ * }
+ * ```
+ */
+export declare function getService<T>(context: Context<unknown, unknown>, serviceClass: new (...args: any[]) => T): T;
+//# sourceMappingURL=container.utils.d.ts.map

package/build/utils/container.utils.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getService = getService;
+/**
+ * Get a service from the dependency injection container
+ *
+ * Type-safe utility to resolve services from the TypeDI container
+ * without casting.
+ *
+ * @template T The service type to resolve
+ * @param context - Request context containing the DI container
+ * @param serviceClass - Service class constructor
+ * @returns Service instance
+ * @throws Error if container is not initialized
+ *
+ * @example
+ * ```typescript
+ * 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!
+ *
+ *   const user = await userService.createUser(context.req.parsedBody);
+ *   context.res.status(201).json({ data: user });
+ * }
+ * ```
+ */
+function getService(context, serviceClass) {
+    if (!context.container) {
+        throw new Error('Container not initialized. Did you forget to add DependencyInjectionMiddleware?');
+    }
+    return context.container.get(serviceClass);
+}
+//# sourceMappingURL=container.utils.js.map

package/build/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utility functions for Noony Core
+ */
+export { getService } from './container.utils';
+export { asString, asStringArray, asNumber, asBoolean, } from './query-param.utils';
+//# sourceMappingURL=index.d.ts.map

package/build/utils/index.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Utility functions for Noony Core
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asBoolean = exports.asNumber = exports.asStringArray = exports.asString = exports.getService = void 0;
+// Container utilities
+var container_utils_1 = require("./container.utils");
+Object.defineProperty(exports, "getService", { enumerable: true, get: function () { return container_utils_1.getService; } });
+// Query parameter utilities
+var query_param_utils_1 = require("./query-param.utils");
+Object.defineProperty(exports, "asString", { enumerable: true, get: function () { return query_param_utils_1.asString; } });
+Object.defineProperty(exports, "asStringArray", { enumerable: true, get: function () { return query_param_utils_1.asStringArray; } });
+Object.defineProperty(exports, "asNumber", { enumerable: true, get: function () { return query_param_utils_1.asNumber; } });
+Object.defineProperty(exports, "asBoolean", { enumerable: true, get: function () { return query_param_utils_1.asBoolean; } });
+//# sourceMappingURL=index.js.map

package/build/utils/query-param.utils.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Query parameter utility functions for type-safe handling of query parameters
+ * that can be string | string[] | undefined
+ */
+/**
+ * Convert query parameter to single string
+ * Takes the first value if array is provided
+ *
+ * @param value - Query parameter value
+ * @returns First string value or undefined
+ *
+ * @example
+ * ```typescript
+ * const search = asString(context.req.query.search);
+ * // If query.search = "hello" → "hello"
+ * // If query.search = ["hello", "world"] → "hello"
+ * // If query.search = undefined → undefined
+ * ```
+ */
+export declare function asString(value: string | string[] | undefined): string | undefined;
+/**
+ * Convert query parameter to string array
+ * Returns array if single value is provided
+ *
+ * @param value - Query parameter value
+ * @returns Array of strings or undefined
+ *
+ * @example
+ * ```typescript
+ * const tags = asStringArray(context.req.query.tags);
+ * // If query.tags = "javascript" → ["javascript"]
+ * // If query.tags = ["javascript", "typescript"] → ["javascript", "typescript"]
+ * // If query.tags = undefined → undefined
+ * ```
+ */
+export declare function asStringArray(value: string | string[] | undefined): string[] | undefined;
+/**
+ * Convert query parameter to number
+ * Parses the value as integer (base 10)
+ *
+ * @param value - Query parameter value
+ * @returns Parsed number or undefined if invalid
+ *
+ * @example
+ * ```typescript
+ * const page = asNumber(context.req.query.page) || 1;
+ * // If query.page = "5" → 5
+ * // If query.page = ["10", "20"] → 10 (first value)
+ * // If query.page = "invalid" → undefined
+ * // If query.page = undefined → undefined
+ * ```
+ */
+export declare function asNumber(value: string | string[] | undefined): number | undefined;
+/**
+ * Convert query parameter to boolean
+ * Treats "true" and "1" as true, everything else as false
+ *
+ * @param value - Query parameter value
+ * @returns Boolean value or undefined if not provided
+ *
+ * @example
+ * ```typescript
+ * const isActive = asBoolean(context.req.query.active);
+ * // If query.active = "true" → true
+ * // If query.active = "1" → true
+ * // If query.active = "false" → false
+ * // If query.active = "0" → false
+ * // If query.active = undefined → undefined
+ * ```
+ */
+export declare function asBoolean(value: string | string[] | undefined): boolean | undefined;
+//# sourceMappingURL=query-param.utils.d.ts.map

package/build/utils/query-param.utils.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Query parameter utility functions for type-safe handling of query parameters
+ * that can be string | string[] | undefined
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asString = asString;
+exports.asStringArray = asStringArray;
+exports.asNumber = asNumber;
+exports.asBoolean = asBoolean;
+/**
+ * Convert query parameter to single string
+ * Takes the first value if array is provided
+ *
+ * @param value - Query parameter value
+ * @returns First string value or undefined
+ *
+ * @example
+ * ```typescript
+ * const search = asString(context.req.query.search);
+ * // If query.search = "hello" → "hello"
+ * // If query.search = ["hello", "world"] → "hello"
+ * // If query.search = undefined → undefined
+ * ```
+ */
+function asString(value) {
+    if (Array.isArray(value)) {
+        return value[0];
+    }
+    return value;
+}
+/**
+ * Convert query parameter to string array
+ * Returns array if single value is provided
+ *
+ * @param value - Query parameter value
+ * @returns Array of strings or undefined
+ *
+ * @example
+ * ```typescript
+ * const tags = asStringArray(context.req.query.tags);
+ * // If query.tags = "javascript" → ["javascript"]
+ * // If query.tags = ["javascript", "typescript"] → ["javascript", "typescript"]
+ * // If query.tags = undefined → undefined
+ * ```
+ */
+function asStringArray(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (Array.isArray(value)) {
+        return value;
+    }
+    return [value];
+}
+/**
+ * Convert query parameter to number
+ * Parses the value as integer (base 10)
+ *
+ * @param value - Query parameter value
+ * @returns Parsed number or undefined if invalid
+ *
+ * @example
+ * ```typescript
+ * const page = asNumber(context.req.query.page) || 1;
+ * // If query.page = "5" → 5
+ * // If query.page = ["10", "20"] → 10 (first value)
+ * // If query.page = "invalid" → undefined
+ * // If query.page = undefined → undefined
+ * ```
+ */
+function asNumber(value) {
+    const str = asString(value);
+    if (!str) {
+        return undefined;
+    }
+    const num = parseInt(str, 10);
+    return isNaN(num) ? undefined : num;
+}
+/**
+ * Convert query parameter to boolean
+ * Treats "true" and "1" as true, everything else as false
+ *
+ * @param value - Query parameter value
+ * @returns Boolean value or undefined if not provided
+ *
+ * @example
+ * ```typescript
+ * const isActive = asBoolean(context.req.query.active);
+ * // If query.active = "true" → true
+ * // If query.active = "1" → true
+ * // If query.active = "false" → false
+ * // If query.active = "0" → false
+ * // If query.active = undefined → undefined
+ * ```
+ */
+function asBoolean(value) {
+    const str = asString(value);
+    if (str === undefined) {
+        return undefined;
+    }
+    return str.toLowerCase() === 'true' || str === '1';
+}
+//# sourceMappingURL=query-param.utils.js.map

package/package.json

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