@dismissible/nestjs-validation 0.0.2-canary.c91edbc.0 → 0.0.2-canary.d2f56d7.0

package/jest.config.ts

@@ -7,4 +7,21 @@ export default {
   },
   moduleFileExtensions: ['ts', 'js', 'html'],
   coverageDirectory: '../../coverage/libs/validation',
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.spec.ts',
+    '!src/**/*.interface.ts',
+    '!src/**/*.dto.ts',
+    '!src/**/*.enum.ts',
+    '!src/**/index.ts',
+    '!src/**/*.module.ts',
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 80,
+      functions: 80,
+      lines: 80,
+      statements: 80,
+    },
+  },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dismissible/nestjs-validation",
-  "version": "0.0.2-canary.c91edbc.0",
+  "version": "0.0.2-canary.d2f56d7.0",
   "description": "Validation service module for NestJS applications using class-validator and class-transformer",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",

package/src/index.ts

@@ -1,2 +1,4 @@
 export * from './validation.service';
 export * from './validation.module';
+export * from './transform-boolean.decorator';
+export * from './transform-comma-separated.decorator';

package/src/transform-boolean.decorator.spec.ts

@@ -0,0 +1,102 @@
+import 'reflect-metadata';
+import { IsBoolean } from 'class-validator';
+import { plainToInstance } from 'class-transformer';
+import { TransformBoolean } from './transform-boolean.decorator';
+
+class TestConfig {
+  @IsBoolean()
+  @TransformBoolean()
+  value!: boolean;
+}
+
+class TestConfigWithDefault {
+  @IsBoolean()
+  @TransformBoolean(true)
+  value!: boolean;
+}
+
+describe('TransformBoolean', () => {
+  describe('without default value', () => {
+    it('should transform string "true" to boolean true', () => {
+      const config = plainToInstance(TestConfig, { value: 'true' });
+      expect(config.value).toBe(true);
+    });
+
+    it('should transform string "false" to boolean false', () => {
+      const config = plainToInstance(TestConfig, { value: 'false' });
+      expect(config.value).toBe(false);
+    });
+
+    it('should keep boolean true as true', () => {
+      const config = plainToInstance(TestConfig, { value: true });
+      expect(config.value).toBe(true);
+    });
+
+    it('should keep boolean false as false', () => {
+      const config = plainToInstance(TestConfig, { value: false });
+      expect(config.value).toBe(false);
+    });
+
+    it('should transform other string values to false', () => {
+      const config = plainToInstance(TestConfig, { value: 'yes' });
+      expect(config.value).toBe(false);
+    });
+
+    it('should handle case-insensitive "true"', () => {
+      const config = plainToInstance(TestConfig, { value: 'TRUE' });
+      expect(config.value).toBe(true);
+    });
+
+    it('should handle case-insensitive "True"', () => {
+      const config = plainToInstance(TestConfig, { value: 'True' });
+      expect(config.value).toBe(true);
+    });
+
+    it('should preserve undefined when no default provided', () => {
+      const config = plainToInstance(TestConfig, { value: undefined });
+      expect(config.value).toBeUndefined();
+    });
+
+    it('should preserve null when no default provided', () => {
+      const config = plainToInstance(TestConfig, { value: null });
+      expect(config.value).toBeNull();
+    });
+
+    it('should preserve other types when no default provided', () => {
+      const config = plainToInstance(TestConfig, { value: 123 });
+      expect(config.value).toBe(123);
+    });
+  });
+
+  describe('with default value', () => {
+    it('should use default value for undefined', () => {
+      const config = plainToInstance(TestConfigWithDefault, { value: undefined });
+      expect(config.value).toBe(true);
+    });
+
+    it('should use default value for null', () => {
+      const config = plainToInstance(TestConfigWithDefault, { value: null });
+      expect(config.value).toBe(true);
+    });
+
+    it('should use default value for other types', () => {
+      const config = plainToInstance(TestConfigWithDefault, { value: 123 });
+      expect(config.value).toBe(true);
+    });
+
+    it('should still transform string "true" to boolean true', () => {
+      const config = plainToInstance(TestConfigWithDefault, { value: 'true' });
+      expect(config.value).toBe(true);
+    });
+
+    it('should still transform string "false" to boolean false', () => {
+      const config = plainToInstance(TestConfigWithDefault, { value: 'false' });
+      expect(config.value).toBe(false);
+    });
+
+    it('should still keep boolean true as true', () => {
+      const config = plainToInstance(TestConfigWithDefault, { value: true });
+      expect(config.value).toBe(true);
+    });
+  });
+});

package/src/transform-boolean.decorator.ts

@@ -0,0 +1,29 @@
+import { Transform } from 'class-transformer';
+
+/**
+ * Transforms string values to boolean, preserving existing boolean values.
+ * Useful for environment variable configuration where boolean values may be passed as strings.
+ *
+ * @param defaultValue - Optional default value to return if the value is not a boolean or string.
+ *                       If not provided, the original value is returned unchanged.
+ *
+ * @example
+ * ```typescript
+ * class Config {
+ *   @IsBoolean()
+ *   @TransformBoolean()
+ *   enabled!: boolean;
+ * }
+ * ```
+ */
+export function TransformBoolean(defaultValue?: boolean): PropertyDecorator {
+  return Transform(({ value }) => {
+    if (typeof value === 'boolean') {
+      return value;
+    }
+    if (typeof value === 'string') {
+      return value.toLowerCase() === 'true';
+    }
+    return defaultValue !== undefined ? defaultValue : value;
+  });
+}

package/src/transform-comma-separated.decorator.spec.ts

@@ -0,0 +1,40 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { TransformCommaSeparated } from './transform-comma-separated.decorator';
+
+class TestConfig {
+  @TransformCommaSeparated()
+  value!: string[] | string;
+}
+
+describe('TransformCommaSeparated', () => {
+  it('should transform comma-separated string into array of trimmed strings', () => {
+    const config = plainToInstance(TestConfig, { value: 'GET,POST,DELETE' });
+    expect(config.value).toEqual(['GET', 'POST', 'DELETE']);
+  });
+
+  it('should trim whitespace from each element', () => {
+    const config = plainToInstance(TestConfig, { value: 'a , b , c' });
+    expect(config.value).toEqual(['a', 'b', 'c']);
+  });
+
+  it('should handle single value string', () => {
+    const config = plainToInstance(TestConfig, { value: 'GET' });
+    expect(config.value).toEqual(['GET']);
+  });
+
+  it('should return array as-is when value is already an array', () => {
+    const config = plainToInstance(TestConfig, { value: ['a', 'b'] });
+    expect(config.value).toEqual(['a', 'b']);
+  });
+
+  it('should handle empty string', () => {
+    const config = plainToInstance(TestConfig, { value: '' });
+    expect(config.value).toEqual(['']);
+  });
+
+  it('should handle string with only whitespace', () => {
+    const config = plainToInstance(TestConfig, { value: '  ' });
+    expect(config.value).toEqual(['']);
+  });
+});

package/src/transform-comma-separated.decorator.ts

@@ -0,0 +1,16 @@
+import { Transform } from 'class-transformer';
+
+/**
+ * Transforms a comma-separated string into an array of trimmed strings.
+ * If the value is already an array, it is returned as-is.
+ *
+ * @example
+ * // Input: "GET,POST,DELETE" → Output: ["GET", "POST", "DELETE"]
+ * // Input: "a , b , c" → Output: ["a", "b", "c"]
+ * // Input: ["a", "b"] → Output: ["a", "b"]
+ */
+export function TransformCommaSeparated(): PropertyDecorator {
+  return Transform(({ value }) =>
+    typeof value === 'string' ? value.split(',').map((s) => s.trim()) : value,
+  );
+}

package/tsconfig.json

@@ -5,6 +5,9 @@
   "references": [
     {
       "path": "./tsconfig.lib.json"
+    },
+    {
+      "path": "./tsconfig.spec.json"
     }
   ],
   "compilerOptions": {

package/tsconfig.spec.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "module": "commonjs",
+    "types": ["node", "jest"],
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "target": "ES2021"
+  },
+  "include": ["src/**/*.spec.ts", "src/**/*.test.ts"]
+}