wynkjs 1.0.0

package/dist/decorators/param.decorators.js

@@ -0,0 +1,205 @@
+import "reflect-metadata";
+/**
+ * Helper to register parameter metadata
+ */
+function createParamDecorator(type, data, pipes) {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey)
+            return;
+        const existingParams = Reflect.getMetadata("params", target, propertyKey) || [];
+        existingParams.push({
+            index: parameterIndex,
+            type,
+            data,
+            pipes,
+        });
+        Reflect.defineMetadata("params", existingParams, target, propertyKey);
+    };
+}
+/**
+ * @Body decorator - Extracts request body
+ * @param property Optional property name to extract from body
+ * @param pipes Optional validation/transformation pipes
+ * @example
+ * @Post()
+ * create(@Body() dto: CreateDto) {}
+ *
+ * @Post()
+ * update(@Body('name') name: string) {}
+ */
+export function Body(property, ...pipes) {
+    return createParamDecorator("body", property, pipes);
+}
+/**
+ * @Param decorator - Extracts route parameters
+ * @param property Optional parameter name
+ * @param pipes Optional validation/transformation pipes
+ * @example
+ * @Get('/:id')
+ * findOne(@Param('id') id: string) {}
+ *
+ * @Get('/:id')
+ * findOne(@Param() params: any) {}
+ */
+export function Param(property, ...pipes) {
+    return createParamDecorator("param", property, pipes);
+}
+/**
+ * @Query decorator - Extracts query parameters
+ * @param property Optional query parameter name
+ * @param pipes Optional validation/transformation pipes
+ * @example
+ * @Get()
+ * findAll(@Query('page') page: number) {}
+ *
+ * @Get()
+ * findAll(@Query() query: QueryDto) {}
+ */
+export function Query(property, ...pipes) {
+    return createParamDecorator("query", property, pipes);
+}
+/**
+ * @Headers decorator - Extracts request headers
+ * @param property Optional header name
+ * @example
+ * @Get()
+ * getData(@Headers('authorization') auth: string) {}
+ *
+ * @Get()
+ * getData(@Headers() headers: any) {}
+ */
+export function Headers(property) {
+    return createParamDecorator("headers", property);
+}
+/**
+ * @Req decorator - Injects full request object
+ * @example
+ * @Get()
+ * getData(@Req() request: Request) {}
+ */
+export function Req() {
+    return createParamDecorator("request");
+}
+/**
+ * @Request decorator - Alias for @Req
+ */
+export const Request = Req;
+/**
+ * @Res decorator - Injects response object
+ * @example
+ * @Get()
+ * getData(@Res() response: Response) {}
+ */
+export function Res() {
+    return createParamDecorator("response");
+}
+/**
+ * @Response decorator - Alias for @Res
+ */
+export const Response = Res;
+/**
+ * @Context decorator - Injects full Elysia context
+ * @example
+ * @Get()
+ * getData(@Context() ctx: any) {}
+ */
+export function Context() {
+    return createParamDecorator("context");
+}
+/**
+ * @User decorator - Extracts user from context (after authentication)
+ * @param property Optional user property to extract
+ * @example
+ * @Get('/profile')
+ * @UseGuards(AuthGuard)
+ * getProfile(@User() user: UserEntity) {}
+ *
+ * @Get('/profile')
+ * getProfile(@User('id') userId: string) {}
+ */
+export function User(property) {
+    return createParamDecorator("user", property);
+}
+/**
+ * @UploadedFile decorator - Extracts uploaded file
+ * @example
+ * @Post('/upload')
+ * uploadFile(@UploadedFile() file: File) {}
+ */
+export function UploadedFile() {
+    return createParamDecorator("file");
+}
+/**
+ * @UploadedFiles decorator - Extracts multiple uploaded files
+ * @example
+ * @Post('/upload-multiple')
+ * uploadFiles(@UploadedFiles() files: File[]) {}
+ */
+export function UploadedFiles() {
+    return createParamDecorator("files");
+}
+/**
+ * @Ip decorator - Extracts client IP address
+ * @example
+ * @Get()
+ * getData(@Ip() ip: string) {}
+ */
+export function Ip() {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey)
+            return;
+        const existingParams = Reflect.getMetadata("params", target, propertyKey) || [];
+        existingParams.push({
+            index: parameterIndex,
+            type: "headers",
+            data: "x-forwarded-for",
+        });
+        Reflect.defineMetadata("params", existingParams, target, propertyKey);
+    };
+}
+/**
+ * @Session decorator - Extracts session data
+ * @param property Optional session property name
+ * @example
+ * @Get()
+ * getData(@Session() session: any) {}
+ *
+ * @Get()
+ * getData(@Session('userId') userId: string) {}
+ */
+export function Session(property) {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey)
+            return;
+        const existingParams = Reflect.getMetadata("params", target, propertyKey) || [];
+        existingParams.push({
+            index: parameterIndex,
+            type: "context",
+            data: property ? `session.${property}` : "session",
+        });
+        Reflect.defineMetadata("params", existingParams, target, propertyKey);
+    };
+}
+/**
+ * @HostParam decorator - Extracts subdomain parameters
+ * @param property Host parameter name
+ * @example
+ * @Controller({ host: ':account.example.com' })
+ * export class AccountController {
+ *   @Get()
+ *   getData(@HostParam('account') account: string) {}
+ * }
+ */
+export function HostParam(property) {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey)
+            return;
+        const existingParams = Reflect.getMetadata("params", target, propertyKey) || [];
+        existingParams.push({
+            index: parameterIndex,
+            type: "context",
+            data: `host.${property}`,
+        });
+        Reflect.defineMetadata("params", existingParams, target, propertyKey);
+    };
+}

package/dist/decorators/pipe.advanced.d.ts

@@ -0,0 +1,125 @@
+import "reflect-metadata";
+import { WynkPipeTransform, ArgumentMetadata } from "./pipe.decorators";
+/**
+ * Advanced Pipes for WynkJS Framework
+ * Additional pipes for common transformations and validations
+ */
+/**
+ * Parse Date Pipe - Converts string to Date object
+ * @example
+ * @Get('/:date')
+ * async getByDate(@Param('date', ParseDatePipe) date: Date) {}
+ */
+export declare class ParseDatePipe implements WynkPipeTransform<string, Date> {
+    transform(value: string, metadata?: ArgumentMetadata): Date;
+}
+/**
+ * Parse File Pipe - Validates and transforms file uploads
+ * @example
+ * @Post('/upload')
+ * async uploadFile(@UploadedFile(ParseFilePipe) file: any) {}
+ */
+export declare class ParseFilePipe implements WynkPipeTransform<any, any> {
+    private options?;
+    constructor(options?: {
+        maxSize?: number;
+        allowedTypes?: string[];
+        required?: boolean;
+    } | undefined);
+    transform(value: any, metadata?: ArgumentMetadata): any;
+}
+/**
+ * Sanitize Pipe - Sanitizes input by removing dangerous characters
+ * @example
+ * @Post()
+ * async create(@Body(SanitizePipe) data: any) {}
+ */
+export declare class SanitizePipe implements WynkPipeTransform {
+    private dangerousPatterns;
+    transform(value: any, metadata?: ArgumentMetadata): any;
+    private sanitizeString;
+}
+/**
+ * Transform Case Pipe - Transforms string case
+ * @example
+ * @Post()
+ * async create(@Body('email', new TransformCasePipe('lower')) email: string) {}
+ */
+export declare class TransformCasePipe implements WynkPipeTransform<string, string> {
+    private caseType;
+    constructor(caseType?: "lower" | "upper" | "title");
+    transform(value: string, metadata?: ArgumentMetadata): string;
+}
+/**
+ * Parse JSON Pipe - Parses JSON strings
+ * @example
+ * @Post()
+ * async create(@Body('metadata', ParseJSONPipe) metadata: any) {}
+ */
+export declare class ParseJSONPipe implements WynkPipeTransform<string, any> {
+    transform(value: string, metadata?: ArgumentMetadata): any;
+}
+/**
+ * Validate Email Pipe - Validates email format
+ * @example
+ * @Post()
+ * async create(@Body('email', ValidateEmailPipe) email: string) {}
+ */
+export declare class ValidateEmailPipe implements WynkPipeTransform<string, string> {
+    private emailRegex;
+    transform(value: string, metadata?: ArgumentMetadata): string;
+}
+/**
+ * Validate Length Pipe - Validates string/array length
+ * @example
+ * @Post()
+ * async create(@Body('username', new ValidateLengthPipe(3, 20)) username: string) {}
+ */
+export declare class ValidateLengthPipe implements WynkPipeTransform {
+    private min?;
+    private max?;
+    constructor(min?: number | undefined, max?: number | undefined);
+    transform(value: any, metadata?: ArgumentMetadata): any;
+}
+/**
+ * Validate Range Pipe - Validates number is within range
+ * @example
+ * @Get()
+ * async getData(@Query('page', new ValidateRangePipe(1, 100)) page: number) {}
+ */
+export declare class ValidateRangePipe implements WynkPipeTransform<number, number> {
+    private min?;
+    private max?;
+    constructor(min?: number | undefined, max?: number | undefined);
+    transform(value: number, metadata?: ArgumentMetadata): number;
+}
+/**
+ * Strip HTML Pipe - Removes HTML tags from string
+ * @example
+ * @Post()
+ * async create(@Body('comment', StripHTMLPipe) comment: string) {}
+ */
+export declare class StripHTMLPipe implements WynkPipeTransform<string, string> {
+    transform(value: string, metadata?: ArgumentMetadata): string;
+}
+/**
+ * Slugify Pipe - Converts string to URL-friendly slug
+ * @example
+ * @Post()
+ * async create(@Body('title', SlugifyPipe) slug: string) {}
+ */
+export declare class SlugifyPipe implements WynkPipeTransform<string, string> {
+    transform(value: string, metadata?: ArgumentMetadata): string;
+}
+/**
+ * Parse Comma Separated Pipe - Converts comma-separated string to array
+ * @example
+ * @Get()
+ * async search(@Query('tags', ParseCommaSeparatedPipe) tags: string[]) {}
+ */
+export declare class ParseCommaSeparatedPipe implements WynkPipeTransform<string, string[]> {
+    private trim;
+    constructor(trim?: boolean);
+    transform(value: string, metadata?: ArgumentMetadata): string[];
+}
+//# sourceMappingURL=pipe.advanced.d.ts.map

package/dist/decorators/pipe.advanced.d.ts.map

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

package/dist/decorators/pipe.advanced.js

@@ -0,0 +1,263 @@
+import "reflect-metadata";
+import { BadRequestException } from "./exception.decorators";
+/**
+ * Advanced Pipes for WynkJS Framework
+ * Additional pipes for common transformations and validations
+ */
+/**
+ * Parse Date Pipe - Converts string to Date object
+ * @example
+ * @Get('/:date')
+ * async getByDate(@Param('date', ParseDatePipe) date: Date) {}
+ */
+export class ParseDatePipe {
+    transform(value, metadata) {
+        if (!value) {
+            throw new BadRequestException("Date value is required");
+        }
+        const date = new Date(value);
+        if (isNaN(date.getTime())) {
+            throw new BadRequestException(`"${value}" is not a valid date`);
+        }
+        return date;
+    }
+}
+/**
+ * Parse File Pipe - Validates and transforms file uploads
+ * @example
+ * @Post('/upload')
+ * async uploadFile(@UploadedFile(ParseFilePipe) file: any) {}
+ */
+export class ParseFilePipe {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    transform(value, metadata) {
+        if (!value) {
+            if (this.options?.required) {
+                throw new BadRequestException("File is required");
+            }
+            return null;
+        }
+        // Check file size
+        if (this.options?.maxSize && value.size > this.options.maxSize) {
+            const maxSizeMB = (this.options.maxSize / (1024 * 1024)).toFixed(2);
+            throw new BadRequestException(`File size exceeds ${maxSizeMB}MB limit`);
+        }
+        // Check file type
+        if (this.options?.allowedTypes &&
+            !this.options.allowedTypes.includes(value.type)) {
+            throw new BadRequestException(`File type must be one of: ${this.options.allowedTypes.join(", ")}`);
+        }
+        return value;
+    }
+}
+/**
+ * Sanitize Pipe - Sanitizes input by removing dangerous characters
+ * @example
+ * @Post()
+ * async create(@Body(SanitizePipe) data: any) {}
+ */
+export class SanitizePipe {
+    dangerousPatterns = [
+        /<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi,
+        /javascript:/gi,
+        /on\w+\s*=/gi,
+    ];
+    transform(value, metadata) {
+        if (typeof value === "string") {
+            return this.sanitizeString(value);
+        }
+        if (Array.isArray(value)) {
+            return value.map((item) => this.transform(item, metadata));
+        }
+        if (value && typeof value === "object") {
+            const sanitized = {};
+            for (const key in value) {
+                sanitized[key] = this.transform(value[key], metadata);
+            }
+            return sanitized;
+        }
+        return value;
+    }
+    sanitizeString(str) {
+        let sanitized = str;
+        for (const pattern of this.dangerousPatterns) {
+            sanitized = sanitized.replace(pattern, "");
+        }
+        return sanitized;
+    }
+}
+/**
+ * Transform Case Pipe - Transforms string case
+ * @example
+ * @Post()
+ * async create(@Body('email', new TransformCasePipe('lower')) email: string) {}
+ */
+export class TransformCasePipe {
+    caseType;
+    constructor(caseType = "lower") {
+        this.caseType = caseType;
+    }
+    transform(value, metadata) {
+        if (typeof value !== "string") {
+            return value;
+        }
+        switch (this.caseType) {
+            case "lower":
+                return value.toLowerCase();
+            case "upper":
+                return value.toUpperCase();
+            case "title":
+                return value.replace(/\w\S*/g, (txt) => {
+                    return txt.charAt(0).toUpperCase() + txt.substr(1).toLowerCase();
+                });
+            default:
+                return value;
+        }
+    }
+}
+/**
+ * Parse JSON Pipe - Parses JSON strings
+ * @example
+ * @Post()
+ * async create(@Body('metadata', ParseJSONPipe) metadata: any) {}
+ */
+export class ParseJSONPipe {
+    transform(value, metadata) {
+        if (!value || typeof value !== "string") {
+            return value;
+        }
+        try {
+            return JSON.parse(value);
+        }
+        catch (error) {
+            throw new BadRequestException("Invalid JSON format");
+        }
+    }
+}
+/**
+ * Validate Email Pipe - Validates email format
+ * @example
+ * @Post()
+ * async create(@Body('email', ValidateEmailPipe) email: string) {}
+ */
+export class ValidateEmailPipe {
+    emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    transform(value, metadata) {
+        if (!value) {
+            throw new BadRequestException("Email is required");
+        }
+        if (!this.emailRegex.test(value)) {
+            throw new BadRequestException("Invalid email format");
+        }
+        return value.toLowerCase();
+    }
+}
+/**
+ * Validate Length Pipe - Validates string/array length
+ * @example
+ * @Post()
+ * async create(@Body('username', new ValidateLengthPipe(3, 20)) username: string) {}
+ */
+export class ValidateLengthPipe {
+    min;
+    max;
+    constructor(min, max) {
+        this.min = min;
+        this.max = max;
+    }
+    transform(value, metadata) {
+        if (!value) {
+            return value;
+        }
+        const length = typeof value === "string" || Array.isArray(value) ? value.length : 0;
+        if (this.min !== undefined && length < this.min) {
+            throw new BadRequestException(`Length must be at least ${this.min} characters`);
+        }
+        if (this.max !== undefined && length > this.max) {
+            throw new BadRequestException(`Length must not exceed ${this.max} characters`);
+        }
+        return value;
+    }
+}
+/**
+ * Validate Range Pipe - Validates number is within range
+ * @example
+ * @Get()
+ * async getData(@Query('page', new ValidateRangePipe(1, 100)) page: number) {}
+ */
+export class ValidateRangePipe {
+    min;
+    max;
+    constructor(min, max) {
+        this.min = min;
+        this.max = max;
+    }
+    transform(value, metadata) {
+        const num = typeof value === "string" ? parseFloat(value) : value;
+        if (isNaN(num)) {
+            throw new BadRequestException("Value must be a number");
+        }
+        if (this.min !== undefined && num < this.min) {
+            throw new BadRequestException(`Value must be at least ${this.min}`);
+        }
+        if (this.max !== undefined && num > this.max) {
+            throw new BadRequestException(`Value must not exceed ${this.max}`);
+        }
+        return num;
+    }
+}
+/**
+ * Strip HTML Pipe - Removes HTML tags from string
+ * @example
+ * @Post()
+ * async create(@Body('comment', StripHTMLPipe) comment: string) {}
+ */
+export class StripHTMLPipe {
+    transform(value, metadata) {
+        if (typeof value !== "string") {
+            return value;
+        }
+        return value.replace(/<[^>]*>/g, "");
+    }
+}
+/**
+ * Slugify Pipe - Converts string to URL-friendly slug
+ * @example
+ * @Post()
+ * async create(@Body('title', SlugifyPipe) slug: string) {}
+ */
+export class SlugifyPipe {
+    transform(value, metadata) {
+        if (typeof value !== "string") {
+            return value;
+        }
+        return value
+            .toLowerCase()
+            .trim()
+            .replace(/[^\w\s-]/g, "")
+            .replace(/[\s_-]+/g, "-")
+            .replace(/^-+|-+$/g, "");
+    }
+}
+/**
+ * Parse Comma Separated Pipe - Converts comma-separated string to array
+ * @example
+ * @Get()
+ * async search(@Query('tags', ParseCommaSeparatedPipe) tags: string[]) {}
+ */
+export class ParseCommaSeparatedPipe {
+    trim;
+    constructor(trim = true) {
+        this.trim = trim;
+    }
+    transform(value, metadata) {
+        if (!value || typeof value !== "string") {
+            return [];
+        }
+        const items = value.split(",");
+        return this.trim ? items.map((item) => item.trim()) : items;
+    }
+}