codingbuddy 2.0.0 → 2.2.0

package/dist/src/shared/filesystem.interface.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathValidationError = exports.FILE_SYSTEM = void 0;
+exports.FILE_SYSTEM = 'FILE_SYSTEM';
+class PathValidationError extends Error {
+    constructor(message, path, basePath) {
+        super(message);
+        this.path = path;
+        this.basePath = basePath;
+        this.name = 'PathValidationError';
+    }
+}
+exports.PathValidationError = PathValidationError;
+//# sourceMappingURL=filesystem.interface.js.map

package/dist/src/shared/filesystem.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.interface.js","sourceRoot":"","sources":["../../../src/shared/filesystem.interface.ts"],"names":[],"mappings":";;;AAwBa,QAAA,WAAW,GAAG,aAAa,CAAC;AAKzC,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YACE,OAAe,EACC,IAAY,EACZ,QAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,aAAQ,GAAR,QAAQ,CAAS;QAGjC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AATD,kDASC"}

package/dist/src/shared/node-filesystem.service.d.ts

@@ -0,0 +1,5 @@
+import type { IFileSystem } from './filesystem.interface';
+export declare class NodeFileSystemService implements IFileSystem {
+    readFile(path: string, encoding: BufferEncoding): Promise<string>;
+    existsSync(path: string): boolean;
+}

package/dist/src/shared/node-filesystem.service.js

@@ -0,0 +1,25 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeFileSystemService = void 0;
+const common_1 = require("@nestjs/common");
+const fs = require("fs/promises");
+const fs_1 = require("fs");
+let NodeFileSystemService = class NodeFileSystemService {
+    async readFile(path, encoding) {
+        return fs.readFile(path, encoding);
+    }
+    existsSync(path) {
+        return (0, fs_1.existsSync)(path);
+    }
+};
+exports.NodeFileSystemService = NodeFileSystemService;
+exports.NodeFileSystemService = NodeFileSystemService = __decorate([
+    (0, common_1.Injectable)()
+], NodeFileSystemService);
+//# sourceMappingURL=node-filesystem.service.js.map

package/dist/src/shared/node-filesystem.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-filesystem.service.js","sourceRoot":"","sources":["../../../src/shared/node-filesystem.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAC5C,kCAAkC;AAClC,2BAAgC;AAQzB,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,QAAwB;QACnD,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAA,eAAU,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF,CAAA;AARY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;GACA,qBAAqB,CAQjC"}

package/dist/src/shared/path.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"path.utils.js","sourceRoot":"","sources":["../../../src/shared/path.utils.ts"],"names":[],"mappings":";;AAIA,sCAEC;AAUD,kDAWC;AAvBD,SAAgB,aAAa,CAAC,QAAgB;IAC5C,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACtC,CAAC;AAUD,SAAgB,mBAAmB,CACjC,QAAgB,EAChB,OAAe;IAEf,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAE3C,OAAO,CACL,UAAU,CAAC,QAAQ,CAAC,IAAI,YAAY,GAAG,CAAC;QACxC,UAAU,CAAC,UAAU,CAAC,GAAG,YAAY,GAAG,CAAC,CAC1C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"path.utils.js","sourceRoot":"","sources":["../../../src/shared/path.utils.ts"],"names":[],"mappings":";;AAKA,sCAEC;AAUD,kDAWC;AAvBD,SAAgB,aAAa,CAAC,QAAgB;IAC5C,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACtC,CAAC;AAUD,SAAgB,mBAAmB,CACjC,QAAgB,EAChB,OAAe;IAEf,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAE3C,OAAO,CACL,UAAU,CAAC,QAAQ,CAAC,IAAI,YAAY,GAAG,CAAC;QACxC,UAAU,CAAC,UAAU,CAAC,GAAG,YAAY,GAAG,CAAC,CAC1C,CAAC;AACJ,CAAC"}

package/dist/src/shared/pattern-matcher.d.ts

@@ -0,0 +1,11 @@
+import { Minimatch, type MinimatchOptions } from 'minimatch';
+export interface CompiledPattern {
+    pattern: string;
+    matcher: Minimatch;
+}
+export type PatternMatcherOptions = MinimatchOptions;
+export declare function compilePattern(pattern: string, options?: PatternMatcherOptions): CompiledPattern;
+export declare function compilePatterns(patterns: string[], options?: PatternMatcherOptions): CompiledPattern[];
+export declare function compileCategoryPatterns(categoryPatterns: Record<string, string[]>, options?: PatternMatcherOptions): Map<string, CompiledPattern[]>;
+export declare function matchesAnyPattern(file: string, compiledPatterns: CompiledPattern[]): boolean;
+export declare function findMatchingCategory(file: string, categoryPatterns: Map<string, CompiledPattern[]>): string | null;

package/dist/src/shared/pattern-matcher.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compilePattern = compilePattern;
+exports.compilePatterns = compilePatterns;
+exports.compileCategoryPatterns = compileCategoryPatterns;
+exports.matchesAnyPattern = matchesAnyPattern;
+exports.findMatchingCategory = findMatchingCategory;
+const minimatch_1 = require("minimatch");
+const DEFAULT_OPTIONS = {
+    matchBase: true,
+};
+function compilePattern(pattern, options = DEFAULT_OPTIONS) {
+    return {
+        pattern,
+        matcher: new minimatch_1.Minimatch(pattern, options),
+    };
+}
+function compilePatterns(patterns, options = DEFAULT_OPTIONS) {
+    return patterns.map(pattern => compilePattern(pattern, options));
+}
+function compileCategoryPatterns(categoryPatterns, options = DEFAULT_OPTIONS) {
+    const compiled = new Map();
+    for (const [category, patterns] of Object.entries(categoryPatterns)) {
+        compiled.set(category, compilePatterns(patterns, options));
+    }
+    return compiled;
+}
+function matchesAnyPattern(file, compiledPatterns) {
+    return compiledPatterns.some(cp => cp.matcher.match(file));
+}
+function findMatchingCategory(file, categoryPatterns) {
+    for (const [category, patterns] of categoryPatterns) {
+        if (matchesAnyPattern(file, patterns)) {
+            return category;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=pattern-matcher.js.map

package/dist/src/shared/pattern-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.js","sourceRoot":"","sources":["../../../src/shared/pattern-matcher.ts"],"names":[],"mappings":";;AAuBA,wCAQC;AAKD,0CAKC;AAMD,0DAWC;AAKD,8CAKC;AAKD,oDAUC;AAnFD,yCAA6D;AAgB7D,MAAM,eAAe,GAA0B;IAC7C,SAAS,EAAE,IAAI;CAChB,CAAC;AAKF,SAAgB,cAAc,CAC5B,OAAe,EACf,UAAiC,eAAe;IAEhD,OAAO;QACL,OAAO;QACP,OAAO,EAAE,IAAI,qBAAS,CAAC,OAAO,EAAE,OAAO,CAAC;KACzC,CAAC;AACJ,CAAC;AAKD,SAAgB,eAAe,CAC7B,QAAkB,EAClB,UAAiC,eAAe;IAEhD,OAAO,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AACnE,CAAC;AAMD,SAAgB,uBAAuB,CACrC,gBAA0C,EAC1C,UAAiC,eAAe;IAEhD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEtD,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACpE,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAKD,SAAgB,iBAAiB,CAC/B,IAAY,EACZ,gBAAmC;IAEnC,OAAO,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7D,CAAC;AAKD,SAAgB,oBAAoB,CAClC,IAAY,EACZ,gBAAgD;IAEhD,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC;QACpD,IAAI,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;YACtC,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/shared/security.utils.d.ts

@@ -1,2 +1,19 @@
 export declare function containsDangerousKeys(obj: unknown, objPath?: string): string | null;
 export declare function isPathSafe(basePath: string, relativePath: string): boolean;
+export interface PathValidationResult {
+    valid: boolean;
+    error?: string;
+    resolvedPath?: string;
+}
+export interface ValidatePathOptions {
+    basePath: string;
+    allowAbsolute?: boolean;
+    allowedExtensions?: string[];
+}
+export declare function validatePath(targetPath: string, options: ValidatePathOptions): PathValidationResult;
+export declare function assertPathSafe(targetPath: string, options: ValidatePathOptions): string;
+export interface HandlerArgsSanitizeResult {
+    safe: boolean;
+    error?: string;
+}
+export declare function sanitizeHandlerArgs(args: Record<string, unknown> | undefined): HandlerArgsSanitizeResult;

package/dist/src/shared/security.utils.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.containsDangerousKeys = containsDangerousKeys;
 exports.isPathSafe = isPathSafe;
+exports.validatePath = validatePath;
+exports.assertPathSafe = assertPathSafe;
+exports.sanitizeHandlerArgs = sanitizeHandlerArgs;
 const path = require("path");
 const DANGEROUS_KEYS = ['__proto__', 'constructor', 'prototype'];
 function containsDangerousKeys(obj, objPath = '') {
@@ -43,4 +46,64 @@ function isPathSafe(basePath, relativePath) {
     }
     return resolvedTarget.startsWith(resolvedBase + path.sep);
 }
+function validatePath(targetPath, options) {
+    const { basePath, allowAbsolute = false, allowedExtensions } = options;
+    if (targetPath.includes('\x00')) {
+        return {
+            valid: false,
+            error: 'Path contains null bytes (possible null byte injection)',
+        };
+    }
+    if (!allowAbsolute && path.isAbsolute(targetPath)) {
+        return {
+            valid: false,
+            error: 'Absolute paths are not allowed',
+        };
+    }
+    const normalizedPath = targetPath.replace(/\\/g, '/');
+    const resolvedBase = path.resolve(basePath);
+    const resolvedTarget = path.resolve(basePath, normalizedPath);
+    const isContained = resolvedTarget === resolvedBase ||
+        resolvedTarget.startsWith(resolvedBase + path.sep);
+    if (!isContained) {
+        return {
+            valid: false,
+            error: `Path escapes base directory: ${targetPath} resolves outside ${basePath}`,
+        };
+    }
+    if (allowedExtensions && allowedExtensions.length > 0) {
+        const ext = path.extname(resolvedTarget).toLowerCase();
+        const normalizedAllowed = allowedExtensions.map(e => e.startsWith('.') ? e.toLowerCase() : `.${e.toLowerCase()}`);
+        if (!normalizedAllowed.includes(ext)) {
+            return {
+                valid: false,
+                error: `File extension '${ext}' not allowed. Allowed: ${normalizedAllowed.join(', ')}`,
+            };
+        }
+    }
+    return {
+        valid: true,
+        resolvedPath: resolvedTarget,
+    };
+}
+function assertPathSafe(targetPath, options) {
+    const result = validatePath(targetPath, options);
+    if (!result.valid) {
+        throw new Error(`Path validation failed: ${result.error}`);
+    }
+    return result.resolvedPath;
+}
+function sanitizeHandlerArgs(args) {
+    if (args === undefined) {
+        return { safe: true };
+    }
+    const dangerousPath = containsDangerousKeys(args);
+    if (dangerousPath !== null) {
+        return {
+            safe: false,
+            error: `Invalid argument: dangerous key detected at '${dangerousPath}'`,
+        };
+    }
+    return { safe: true };
+}
 //# sourceMappingURL=security.utils.js.map

package/dist/src/shared/security.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"security.utils.js","sourceRoot":"","sources":["../../../src/shared/security.utils.ts"],"names":[],"mappings":";;AAoBA,sDAqCC;AAmBD,gCAuBC;AA/FD,6BAA6B;AAM7B,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,CAAU,CAAC;AAU1E,SAAgB,qBAAqB,CACnC,GAAY,EACZ,OAAO,GAAG,EAAE;IAEZ,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;YACjE,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,MAAM,IAAI,GAAG,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAE7C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,cAAc,CAAC,QAAQ,CAAC,GAAsC,CAAC,EAAE,CAAC;YACpE,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7C,CAAC;IACH,CAAC;IAGD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAsC,CAAC,EAAE,CAAC;YACrE,MAAM,MAAM,GAAG,qBAAqB,CACjC,GAA+B,CAAC,GAAG,CAAC,EACrC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CACpC,CAAC;YACF,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAmBD,SAAgB,UAAU,CAAC,QAAgB,EAAE,YAAoB;IAE/D,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAID,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAG5D,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IAIlE,IAAI,cAAc,KAAK,YAAY,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAID,OAAO,cAAc,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"security.utils.js","sourceRoot":"","sources":["../../../src/shared/security.utils.ts"],"names":[],"mappings":"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"}

package/dist/src/shared/validation.constants.d.ts

@@ -9,3 +9,13 @@ export interface ValidationResult {
 export declare function validateQuery(query: string): ValidationResult;
 export declare function validatePrompt(prompt: string): ValidationResult;
 export declare function validateAgentName(name: string): ValidationResult;
+export declare const VALID_MODES: readonly ["PLAN", "ACT", "EVAL"];
+export type ValidMode = (typeof VALID_MODES)[number];
+export declare function isNonEmptyString(value: unknown): value is string;
+export declare function isString(value: unknown): value is string;
+export declare function isStringArray(value: unknown): value is string[];
+export declare function isValidMode(value: unknown): value is ValidMode;
+export declare function extractRequiredString(args: Record<string, unknown> | undefined, paramName: string): string | null;
+export declare function extractOptionalString(args: Record<string, unknown> | undefined, paramName: string): string | undefined;
+export declare function extractStringArray(args: Record<string, unknown> | undefined, paramName: string): string[] | undefined;
+export declare function extractMode(args: Record<string, unknown> | undefined, paramName?: string): ValidMode | null;

package/dist/src/shared/validation.constants.js

@@ -1,9 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AGENT_NAME_PATTERN = exports.MAX_AGENT_NAME_LENGTH = exports.MAX_PROMPT_LENGTH = exports.MAX_QUERY_LENGTH = void 0;
+exports.VALID_MODES = exports.AGENT_NAME_PATTERN = exports.MAX_AGENT_NAME_LENGTH = exports.MAX_PROMPT_LENGTH = exports.MAX_QUERY_LENGTH = void 0;
 exports.validateQuery = validateQuery;
 exports.validatePrompt = validatePrompt;
 exports.validateAgentName = validateAgentName;
+exports.isNonEmptyString = isNonEmptyString;
+exports.isString = isString;
+exports.isStringArray = isStringArray;
+exports.isValidMode = isValidMode;
+exports.extractRequiredString = extractRequiredString;
+exports.extractOptionalString = extractOptionalString;
+exports.extractStringArray = extractStringArray;
+exports.extractMode = extractMode;
 exports.MAX_QUERY_LENGTH = 1000;
 exports.MAX_PROMPT_LENGTH = 10000;
 exports.MAX_AGENT_NAME_LENGTH = 100;
@@ -50,4 +58,37 @@ function validateAgentName(name) {
     }
     return { valid: true };
 }
+exports.VALID_MODES = ['PLAN', 'ACT', 'EVAL'];
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function isString(value) {
+    return typeof value === 'string';
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every(item => typeof item === 'string');
+}
+function isValidMode(value) {
+    return typeof value === 'string' && exports.VALID_MODES.includes(value);
+}
+function extractRequiredString(args, paramName) {
+    const value = args?.[paramName];
+    return isNonEmptyString(value) ? value : null;
+}
+function extractOptionalString(args, paramName) {
+    const value = args?.[paramName];
+    if (value === undefined)
+        return undefined;
+    return isString(value) ? value : undefined;
+}
+function extractStringArray(args, paramName) {
+    const value = args?.[paramName];
+    if (value === undefined)
+        return undefined;
+    return isStringArray(value) ? value : undefined;
+}
+function extractMode(args, paramName = 'mode') {
+    const value = args?.[paramName];
+    return isValidMode(value) ? value : null;
+}
 //# sourceMappingURL=validation.constants.js.map

package/dist/src/shared/validation.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.constants.js","sourceRoot":"","sources":["../../../src/shared/validation.constants.ts"],"names":[],"mappings":";;;AAoDA,sCAWC;AAKD,wCAWC;AAKD,8CAkBC;AAvFY,QAAA,gBAAgB,GAAG,IAAI,CAAC;AAMxB,QAAA,iBAAiB,GAAG,KAAK,CAAC;AAM1B,QAAA,qBAAqB,GAAG,GAAG,CAAC;AAW5B,QAAA,kBAAkB,GAAG,cAAc,CAAC;AAcjD,SAAgB,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,wBAAgB,EAAE,CAAC;QACpC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,mCAAmC,wBAAgB,aAAa;SACxE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAKD,SAAgB,cAAc,CAAC,MAAc;IAC3C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,yBAAiB,EAAE,CAAC;QACtC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,oCAAoC,yBAAiB,aAAa;SAC1E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAKD,SAAgB,iBAAiB,CAAC,IAAY;IAC5C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC;IAC/D,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,6BAAqB,EAAE,CAAC;QACxC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,wCAAwC,6BAAqB,aAAa;SAClF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,0BAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EACH,sEAAsE;SACzE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC"}
+{"version":3,"file":"validation.constants.js","sourceRoot":"","sources":["../../../src/shared/validation.constants.ts"],"names":[],"mappings":"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"}