@flareone/common 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Flareone Contributors
+
+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/README.md

@@ -0,0 +1,36 @@
+# @flareone/common
+
+Common utilities, guards, pipes, and interceptors for Flareone framework.
+
+## Installation
+
+```bash
+npm install @flareone/common
+```
+
+## Features
+
+- **Guards**: `AuthGuard` base class
+- **Interceptors**: `LoggingInterceptor`, `TimeoutInterceptor`
+- **Pipes**: `ValidationPipe`, `ParseIntPipe`, `ParseBoolPipe`
+- **Exceptions**: Standard HTTP exceptions
+- **Decorators**: Helper decorators
+
+## Usage
+
+```typescript
+import { UseGuards, UsePipes } from '@flareone/core';
+import { AuthGuard, ValidationPipe } from '@flareone/common';
+
+@Controller('cats')
+@UseGuards(AuthGuard)
+export class CatsController {
+    @Post()
+    @UsePipes(ValidationPipe)
+    create(@Body() createCatDto: CreateCatDto) {
+        return 'This action adds a new cat';
+    }
+}
+```
+
+See [main repository](https://github.com/flareonejs/flareone) for full documentation.

package/dist/chunk-4TE4W4RZ.js

@@ -0,0 +1,231 @@
+import { __decorateClass, __publicField } from './chunk-XUS63JTZ.js';
+import { Injectable, BadRequestException } from '@flareone/core';
+
+var ParseIntPipe = class {
+  constructor(options = {}) {
+    this.options = options;
+  }
+  transform(value, metadata) {
+    if (this.options.optional && (value === void 0 || value === null || value === "")) {
+      return void 0;
+    }
+    const parsed = parseInt(value, 10);
+    if (isNaN(parsed)) {
+      throw new BadRequestException(
+        this.options.errorMessage ?? `Validation failed: ${metadata.name ?? "value"} must be an integer`
+      );
+    }
+    return parsed;
+  }
+};
+ParseIntPipe = __decorateClass([
+  Injectable()
+], ParseIntPipe);
+var ParseFloatPipe = class {
+  constructor(options = {}) {
+    this.options = options;
+  }
+  transform(value, metadata) {
+    if (this.options.optional && (value === void 0 || value === null || value === "")) {
+      return void 0;
+    }
+    const parsed = parseFloat(value);
+    if (isNaN(parsed)) {
+      throw new BadRequestException(
+        this.options.errorMessage ?? `Validation failed: ${metadata.name ?? "value"} must be a number`
+      );
+    }
+    return parsed;
+  }
+};
+ParseFloatPipe = __decorateClass([
+  Injectable()
+], ParseFloatPipe);
+var ParseBoolPipe = class {
+  constructor(options = {}) {
+    this.options = options;
+  }
+  transform(value, metadata) {
+    if (this.options.optional && (value === void 0 || value === null || value === "")) {
+      return void 0;
+    }
+    if (typeof value === "boolean") {
+      return value;
+    }
+    const lowered = String(value).toLowerCase();
+    if (lowered === "true" || lowered === "1" || lowered === "yes") {
+      return true;
+    }
+    if (lowered === "false" || lowered === "0" || lowered === "no") {
+      return false;
+    }
+    throw new BadRequestException(
+      this.options.errorMessage ?? `Validation failed: ${metadata.name ?? "value"} must be a boolean`
+    );
+  }
+};
+ParseBoolPipe = __decorateClass([
+  Injectable()
+], ParseBoolPipe);
+var ParseUUIDPipe = class {
+  constructor(options = {}) {
+    this.options = options;
+  }
+  transform(value, metadata) {
+    if (this.options.optional && (value === void 0 || value === null || value === "")) {
+      return void 0;
+    }
+    if (!ParseUUIDPipe.UUID_REGEX.test(value)) {
+      throw new BadRequestException(
+        this.options.errorMessage ?? `Validation failed: ${metadata.name ?? "value"} must be a valid UUID`
+      );
+    }
+    return value.toLowerCase();
+  }
+};
+__publicField(ParseUUIDPipe, "UUID_REGEX", /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i);
+ParseUUIDPipe = __decorateClass([
+  Injectable()
+], ParseUUIDPipe);
+var ParseArrayPipe = class {
+  constructor(options = {}) {
+    this.options = options;
+  }
+  transform(value, _metadata) {
+    if (this.options.optional && (value === void 0 || value === null || value === "")) {
+      return [];
+    }
+    const separator = this.options.separator ?? ",";
+    return value.split(separator).map((item) => item.trim()).filter(Boolean);
+  }
+};
+ParseArrayPipe = __decorateClass([
+  Injectable()
+], ParseArrayPipe);
+var ParseEnumPipe = class {
+  constructor(enumType, options = {}) {
+    this.options = options;
+    this.allowedValues = Object.values(enumType);
+  }
+  allowedValues;
+  transform(value, metadata) {
+    if (this.options.optional && (value === void 0 || value === null || value === "")) {
+      return void 0;
+    }
+    if (!this.allowedValues.includes(value)) {
+      throw new BadRequestException(
+        this.options.errorMessage ?? `Validation failed: ${metadata.name ?? "value"} must be one of: ${this.allowedValues.join(", ")}`
+      );
+    }
+    return value;
+  }
+};
+var ValidationPipe = class {
+  constructor(options = {}) {
+    this.options = options;
+  }
+  transform(value, _metadata) {
+    if (value === void 0 && this.options.skipUndefinedProperties) {
+      return value;
+    }
+    if (value === null && this.options.skipNullProperties) {
+      return value;
+    }
+    if ((value === null || value === void 0) && this.options.skipMissingProperties) {
+      return value;
+    }
+    if (typeof value !== "object" || value === null) {
+      return value;
+    }
+    const result = { ...value };
+    if (this.options.whitelist || this.options.forbidNonWhitelisted) {
+      const knownKeys = new Set(Object.keys(value));
+      if (this.options.forbidNonWhitelisted && knownKeys.size > 0) {
+        const unknownKeys = Array.from(knownKeys);
+        if (unknownKeys.length > 0) {
+          throw new BadRequestException(
+            `Unknown properties: ${unknownKeys.join(", ")}`
+          );
+        }
+      }
+      if (this.options.whitelist) {
+        for (const key of knownKeys) {
+          delete result[key];
+        }
+      }
+    }
+    return result;
+  }
+};
+ValidationPipe = __decorateClass([
+  Injectable()
+], ValidationPipe);
+var DefaultValuePipe = class {
+  constructor(defaultValue) {
+    this.defaultValue = defaultValue;
+  }
+  transform(value) {
+    if (value === void 0 || value === null || value === "") {
+      return this.defaultValue;
+    }
+    return value;
+  }
+};
+var TrimPipe = class {
+  transform(value) {
+    if (typeof value !== "string") {
+      return value;
+    }
+    return value.trim();
+  }
+};
+TrimPipe = __decorateClass([
+  Injectable()
+], TrimPipe);
+var LowerCasePipe = class {
+  transform(value) {
+    if (typeof value !== "string") {
+      return value;
+    }
+    return value.toLowerCase();
+  }
+};
+LowerCasePipe = __decorateClass([
+  Injectable()
+], LowerCasePipe);
+var UpperCasePipe = class {
+  transform(value) {
+    if (typeof value !== "string") {
+      return value;
+    }
+    return value.toUpperCase();
+  }
+};
+UpperCasePipe = __decorateClass([
+  Injectable()
+], UpperCasePipe);
+var FileValidationPipe = class {
+  constructor(options = {}) {
+    this.options = options;
+  }
+  async transform(value, _metadata) {
+    if (!(value instanceof File)) {
+      throw new BadRequestException("Expected a file");
+    }
+    if (this.options.maxSize && value.size > this.options.maxSize) {
+      throw new BadRequestException(
+        `File size exceeds maximum allowed size of ${this.options.maxSize} bytes`
+      );
+    }
+    if (this.options.mimeTypes && !this.options.mimeTypes.includes(value.type)) {
+      throw new BadRequestException(
+        `Invalid file type. Allowed types: ${this.options.mimeTypes.join(", ")}`
+      );
+    }
+    return value;
+  }
+};
+
+export { DefaultValuePipe, FileValidationPipe, LowerCasePipe, ParseArrayPipe, ParseBoolPipe, ParseEnumPipe, ParseFloatPipe, ParseIntPipe, ParseUUIDPipe, TrimPipe, UpperCasePipe, ValidationPipe };
+//# sourceMappingURL=chunk-4TE4W4RZ.js.map
+//# sourceMappingURL=chunk-4TE4W4RZ.js.map

package/dist/chunk-4TE4W4RZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pipes/index.ts"],"names":[],"mappings":"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","file":"chunk-4TE4W4RZ.js","sourcesContent":["/**\r\n * Built-in Pipes\r\n * simple data transformations.\r\n */\r\n\r\nimport {\r\n    type PipeTransform,\r\n    type ArgumentMetadata,\r\n    BadRequestException,\r\n    Injectable,\r\n} from '@flareone/core';\r\n\r\nexport interface ParsePipeOptions {\r\n    errorMessage?: string;\r\n    optional?: boolean;\r\n}\r\n\r\n/**\r\n * Parse and validate integer values\r\n */\r\n@Injectable()\r\nexport class ParseIntPipe implements PipeTransform<string, number> {\r\n    constructor(private readonly options: ParsePipeOptions = {}) { }\r\n\r\n    transform(value: string, metadata: ArgumentMetadata): number {\r\n        if (this.options.optional && (value === undefined || value === null || value === '')) {\r\n            return undefined as unknown as number;\r\n        }\r\n\r\n        const parsed = parseInt(value, 10);\r\n\r\n        if (isNaN(parsed)) {\r\n            throw new BadRequestException(\r\n                this.options.errorMessage ??\r\n                `Validation failed: ${metadata.name ?? 'value'} must be an integer`\r\n            );\r\n        }\r\n\r\n        return parsed;\r\n    }\r\n}\r\n\r\n/**\r\n * Parse and validate float values\r\n */\r\n@Injectable()\r\nexport class ParseFloatPipe implements PipeTransform<string, number> {\r\n    constructor(private readonly options: ParsePipeOptions = {}) { }\r\n\r\n    transform(value: string, metadata: ArgumentMetadata): number {\r\n        if (this.options.optional && (value === undefined || value === null || value === '')) {\r\n            return undefined as unknown as number;\r\n        }\r\n\r\n        const parsed = parseFloat(value);\r\n\r\n        if (isNaN(parsed)) {\r\n            throw new BadRequestException(\r\n                this.options.errorMessage ??\r\n                `Validation failed: ${metadata.name ?? 'value'} must be a number`\r\n            );\r\n        }\r\n\r\n        return parsed;\r\n    }\r\n}\r\n\r\n/**\r\n * Parse and validate boolean values\r\n */\r\n@Injectable()\r\nexport class ParseBoolPipe implements PipeTransform<string | boolean, boolean> {\r\n    constructor(private readonly options: ParsePipeOptions = {}) { }\r\n\r\n    transform(value: string | boolean, metadata: ArgumentMetadata): boolean {\r\n        if (this.options.optional && (value === undefined || value === null || value === '')) {\r\n            return undefined as unknown as boolean;\r\n        }\r\n\r\n        if (typeof value === 'boolean') {\r\n            return value;\r\n        }\r\n\r\n        const lowered = String(value).toLowerCase();\r\n\r\n        if (lowered === 'true' || lowered === '1' || lowered === 'yes') {\r\n            return true;\r\n        }\r\n\r\n        if (lowered === 'false' || lowered === '0' || lowered === 'no') {\r\n            return false;\r\n        }\r\n\r\n        throw new BadRequestException(\r\n            this.options.errorMessage ??\r\n            `Validation failed: ${metadata.name ?? 'value'} must be a boolean`\r\n        );\r\n    }\r\n}\r\n\r\n/**\r\n * Parse and validate UUID values\r\n */\r\n@Injectable()\r\nexport class ParseUUIDPipe implements PipeTransform<string, string> {\r\n    private static readonly UUID_REGEX =\r\n        /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\r\n\r\n    constructor(private readonly options: ParsePipeOptions = {}) { }\r\n\r\n    transform(value: string, metadata: ArgumentMetadata): string {\r\n        if (this.options.optional && (value === undefined || value === null || value === '')) {\r\n            return undefined as unknown as string;\r\n        }\r\n\r\n        if (!ParseUUIDPipe.UUID_REGEX.test(value)) {\r\n            throw new BadRequestException(\r\n                this.options.errorMessage ??\r\n                `Validation failed: ${metadata.name ?? 'value'} must be a valid UUID`\r\n            );\r\n        }\r\n\r\n        return value.toLowerCase();\r\n    }\r\n}\r\n\r\n/**\r\n * Parse array from comma-separated string\r\n */\r\n@Injectable()\r\nexport class ParseArrayPipe implements PipeTransform<string, string[]> {\r\n    constructor(\r\n        private readonly options: ParsePipeOptions & { separator?: string } = {}\r\n    ) { }\r\n\r\n    transform(value: string, _metadata: ArgumentMetadata): string[] {\r\n        if (this.options.optional && (value === undefined || value === null || value === '')) {\r\n            return [];\r\n        }\r\n\r\n        const separator = this.options.separator ?? ',';\r\n        return value.split(separator).map((item) => item.trim()).filter(Boolean);\r\n    }\r\n}\r\n\r\n/**\r\n * Parse and validate enum values\r\n */\r\nexport class ParseEnumPipe<T extends Record<string, string | number>>\r\n    implements PipeTransform<string, T[keyof T]> {\r\n    private readonly allowedValues: Array<string | number>;\r\n\r\n    constructor(\r\n        enumType: T,\r\n        private readonly options: ParsePipeOptions = {}\r\n    ) {\r\n        this.allowedValues = Object.values(enumType);\r\n    }\r\n\r\n    transform(value: string, metadata: ArgumentMetadata): T[keyof T] {\r\n        if (this.options.optional && (value === undefined || value === null || value === '')) {\r\n            return undefined as unknown as T[keyof T];\r\n        }\r\n\r\n        if (!this.allowedValues.includes(value)) {\r\n            throw new BadRequestException(\r\n                this.options.errorMessage ??\r\n                `Validation failed: ${metadata.name ?? 'value'} must be one of: ${this.allowedValues.join(', ')}`\r\n            );\r\n        }\r\n\r\n        return value as T[keyof T];\r\n    }\r\n}\r\n\r\nexport interface ValidationPipeOptions {\r\n    whitelist?: boolean;\r\n    forbidNonWhitelisted?: boolean;\r\n    transform?: boolean;\r\n    groups?: string[];\r\n    skipMissingProperties?: boolean;\r\n    skipUndefinedProperties?: boolean;\r\n    skipNullProperties?: boolean;\r\n}\r\n\r\n/**\r\n * Simple validation pipe using schema definition\r\n */\r\n@Injectable()\r\nexport class ValidationPipe implements PipeTransform {\r\n    constructor(private readonly options: ValidationPipeOptions = {}) { }\r\n\r\n    transform(value: unknown, _metadata: ArgumentMetadata): unknown {\r\n        if (value === undefined && this.options.skipUndefinedProperties) {\r\n            return value;\r\n        }\r\n\r\n        if (value === null && this.options.skipNullProperties) {\r\n            return value;\r\n        }\r\n\r\n        if ((value === null || value === undefined) && this.options.skipMissingProperties) {\r\n            return value;\r\n        }\r\n\r\n        if (typeof value !== 'object' || value === null) {\r\n            return value;\r\n        }\r\n\r\n        const result = { ...value } as Record<string, unknown>;\r\n\r\n        if (this.options.whitelist || this.options.forbidNonWhitelisted) {\r\n            const knownKeys = new Set(Object.keys(value));\r\n\r\n            if (this.options.forbidNonWhitelisted && knownKeys.size > 0) {\r\n                const unknownKeys = Array.from(knownKeys);\r\n                if (unknownKeys.length > 0) {\r\n                    throw new BadRequestException(\r\n                        `Unknown properties: ${unknownKeys.join(', ')}`\r\n                    );\r\n                }\r\n            }\r\n\r\n            if (this.options.whitelist) {\r\n                for (const key of knownKeys) {\r\n                    delete result[key];\r\n                }\r\n            }\r\n        }\r\n\r\n        return result;\r\n    }\r\n}\r\n\r\n/**\r\n * Default value pipe - provides a default when value is missing\r\n */\r\nexport class DefaultValuePipe<T = unknown> implements PipeTransform<T, T> {\r\n    constructor(private readonly defaultValue: T) { }\r\n\r\n    transform(value: T): T {\r\n        if (value === undefined || value === null || value === '') {\r\n            return this.defaultValue;\r\n        }\r\n        return value;\r\n    }\r\n}\r\n\r\n/**\r\n * Trim pipe - trims whitespace from strings\r\n */\r\n@Injectable()\r\nexport class TrimPipe implements PipeTransform<string, string> {\r\n    transform(value: string): string {\r\n        if (typeof value !== 'string') {\r\n            return value;\r\n        }\r\n        return value.trim();\r\n    }\r\n}\r\n\r\n/**\r\n * Lowercase pipe - converts strings to lowercase\r\n */\r\n@Injectable()\r\nexport class LowerCasePipe implements PipeTransform<string, string> {\r\n    transform(value: string): string {\r\n        if (typeof value !== 'string') {\r\n            return value;\r\n        }\r\n        return value.toLowerCase();\r\n    }\r\n}\r\n\r\n/**\r\n * Uppercase pipe - converts strings to uppercase\r\n */\r\n@Injectable()\r\nexport class UpperCasePipe implements PipeTransform<string, string> {\r\n    transform(value: string): string {\r\n        if (typeof value !== 'string') {\r\n            return value;\r\n        }\r\n        return value.toUpperCase();\r\n    }\r\n}\r\n\r\nexport interface FileValidatorOptions {\r\n    maxSize?: number;\r\n    mimeTypes?: string[];\r\n}\r\n\r\n/**\r\n * File validation pipe\r\n */\r\nexport class FileValidationPipe implements PipeTransform {\r\n    constructor(private readonly options: FileValidatorOptions = {}) { }\r\n\r\n    async transform(value: unknown, _metadata: ArgumentMetadata): Promise<unknown> {\r\n        if (!(value instanceof File)) {\r\n            throw new BadRequestException('Expected a file');\r\n        }\r\n\r\n        if (this.options.maxSize && value.size > this.options.maxSize) {\r\n            throw new BadRequestException(\r\n                `File size exceeds maximum allowed size of ${this.options.maxSize} bytes`\r\n            );\r\n        }\r\n\r\n        if (this.options.mimeTypes && !this.options.mimeTypes.includes(value.type)) {\r\n            throw new BadRequestException(\r\n                `Invalid file type. Allowed types: ${this.options.mimeTypes.join(', ')}`\r\n            );\r\n        }\r\n\r\n        return value;\r\n    }\r\n}\r\n"]}