@atlantjs/arch 13.3.0 → 14.0.1

package/objects/password/password.edge.d.ts

@@ -1,8 +1,98 @@
 import { PasswordPolicyResultPolygon } from "./password.polygon";
+import { ValidationStepResult } from "./validation-step.type";
 export declare class PasswordEdge {
     private readonly password;
     private readonly validationSteps;
     constructor(password: string);
     protected validate(password: string): PasswordPolicyResultPolygon;
+    /**
+     * Retorna a senha como string.
+     * @returns String interna da senha
+     * @example
+     * new PasswordEdge("Abc@123").toString() // "Abc@123"
+     */
     toString(): string;
+    /**
+     * Retorna o comprimento da senha.
+     * @returns Número de caracteres da senha
+     * @example
+     * new PasswordEdge("Abc@123").length() // 7
+     */
+    length(): number;
+    /**
+     * Verifica se a senha contém ao menos uma letra maiúscula.
+     * @returns true se contém ao menos uma letra maiúscula, false caso contrário
+     * @example
+     * new PasswordEdge("Abc@123").hasUpperCase() // true
+     * new PasswordEdge("abc@123").hasUpperCase() // false
+     */
+    hasUpperCase(): boolean;
+    /**
+     * Verifica se a senha contém ao menos uma letra minúscula.
+     * @returns true se contém ao menos uma letra minúscula, false caso contrário
+     * @example
+     * new PasswordEdge("Abc@123").hasLowerCase() // true
+     * new PasswordEdge("ABC@123").hasLowerCase() // false
+     */
+    hasLowerCase(): boolean;
+    /**
+     * Verifica se a senha contém ao menos um dígito numérico.
+     * @returns true se contém ao menos um número, false caso contrário
+     * @example
+     * new PasswordEdge("Abc@123").hasNumber() // true
+     * new PasswordEdge("Abcdef@").hasNumber() // false
+     */
+    hasNumber(): boolean;
+    /**
+     * Verifica se a senha contém ao menos um caractere especial.
+     * @returns true se contém ao menos um caractere especial, false caso contrário
+     * @example
+     * new PasswordEdge("Abc@123").hasSpecialChar() // true
+     * new PasswordEdge("Abc1234").hasSpecialChar() // false
+     */
+    hasSpecialChar(): boolean;
+    /**
+     * Verifica se a senha contém espaços.
+     * @returns true se contém ao menos um espaço, false caso contrário
+     * @example
+     * new PasswordEdge("Abc @123").hasWhitespace() // true
+     * new PasswordEdge("Abc@123").hasWhitespace() // false
+     */
+    hasWhitespace(): boolean;
+    /**
+     * Verifica se a senha é igual a outra.
+     * @param password - String ou PasswordEdge para comparação
+     * @returns true se as senhas são iguais, false caso contrário
+     * @example
+     * new PasswordEdge("Abc@123").isEqual(new PasswordEdge("Abc@123")) // true
+     * new PasswordEdge("Abc@123").isEqual("Abc@123") // true
+     * new PasswordEdge("Abc@123").isEqual("xyz@999") // false
+     */
+    isEqual(password: string | PasswordEdge): boolean;
+    /**
+     * Avalia a força da senha com base em critérios de complexidade.
+     * @returns "weak" | "medium" | "strong" conforme a pontuação
+     * @example
+     * new PasswordEdge("abc@123").strength() // "weak"
+     * new PasswordEdge("Abcd@123").strength() // "medium"
+     * new PasswordEdge("Abcd@1234!X").strength() // "strong"
+     */
+    strength(): "weak" | "medium" | "strong";
+    /**
+     * Retorna o resultado detalhado de cada etapa de validação da senha.
+     * @returns Array com o resultado de cada ValidationStep
+     * @example
+     * new PasswordEdge("Abc@123").validationResults()
+     * // [{ name: "WithAtLeastOneLetterStep", valid: true }, ...]
+     */
+    validationResults(): ValidationStepResult[];
+    /**
+     * Verifica se uma string é uma senha válida sem lançar exceção.
+     * @param password - String a ser verificada
+     * @returns true se a senha é válida, false caso contrário
+     * @example
+     * PasswordEdge.isValid("Abc@123") // true
+     * PasswordEdge.isValid("abc") // false
+     */
+    static isValid(password: string): boolean;
 }

package/objects/password/password.edge.js

@@ -16,8 +16,9 @@ class PasswordEdge {
             new with_length_step_1.WithLengthStep({ min: 6, max: 999 }),
         ];
         const { valid, validationStepsResults } = this.validate(this.password);
-        if (valid.falsy()) {
-            throw new TypeError(`Password is invalid: ${validationStepsResults.map((result) => result.name)}`);
+        if (!valid) {
+            // 🐛 fix: valid é boolean, não tem método .falsy()
+            throw new TypeError(`Password is invalid: ${validationStepsResults.map((result) => result.name).join(", ")}`);
         }
     }
     validate(password) {
@@ -29,13 +30,146 @@ class PasswordEdge {
             validationStepsResults.push(step.validate(password));
         }
         const valid = validationStepsResults.every((result) => result.valid);
-        return {
-            valid,
-            validationStepsResults,
-        };
+        return { valid, validationStepsResults };
     }
+    // ==================== Getters ====================
+    /**
+     * Retorna a senha como string.
+     * @returns String interna da senha
+     * @example
+     * new PasswordEdge("Abc@123").toString() // "Abc@123"
+     */
     toString() {
         return this.password;
     }
+    /**
+     * Retorna o comprimento da senha.
+     * @returns Número de caracteres da senha
+     * @example
+     * new PasswordEdge("Abc@123").length() // 7
+     */
+    length() {
+        return this.password.length;
+    }
+    // ==================== Verificações ====================
+    /**
+     * Verifica se a senha contém ao menos uma letra maiúscula.
+     * @returns true se contém ao menos uma letra maiúscula, false caso contrário
+     * @example
+     * new PasswordEdge("Abc@123").hasUpperCase() // true
+     * new PasswordEdge("abc@123").hasUpperCase() // false
+     */
+    hasUpperCase() {
+        return /[A-Z]/.test(this.password);
+    }
+    /**
+     * Verifica se a senha contém ao menos uma letra minúscula.
+     * @returns true se contém ao menos uma letra minúscula, false caso contrário
+     * @example
+     * new PasswordEdge("Abc@123").hasLowerCase() // true
+     * new PasswordEdge("ABC@123").hasLowerCase() // false
+     */
+    hasLowerCase() {
+        return /[a-z]/.test(this.password);
+    }
+    /**
+     * Verifica se a senha contém ao menos um dígito numérico.
+     * @returns true se contém ao menos um número, false caso contrário
+     * @example
+     * new PasswordEdge("Abc@123").hasNumber() // true
+     * new PasswordEdge("Abcdef@").hasNumber() // false
+     */
+    hasNumber() {
+        return /[0-9]/.test(this.password);
+    }
+    /**
+     * Verifica se a senha contém ao menos um caractere especial.
+     * @returns true se contém ao menos um caractere especial, false caso contrário
+     * @example
+     * new PasswordEdge("Abc@123").hasSpecialChar() // true
+     * new PasswordEdge("Abc1234").hasSpecialChar() // false
+     */
+    hasSpecialChar() {
+        return /[^a-zA-Z0-9]/.test(this.password);
+    }
+    /**
+     * Verifica se a senha contém espaços.
+     * @returns true se contém ao menos um espaço, false caso contrário
+     * @example
+     * new PasswordEdge("Abc @123").hasWhitespace() // true
+     * new PasswordEdge("Abc@123").hasWhitespace() // false
+     */
+    hasWhitespace() {
+        return /\s/.test(this.password);
+    }
+    /**
+     * Verifica se a senha é igual a outra.
+     * @param password - String ou PasswordEdge para comparação
+     * @returns true se as senhas são iguais, false caso contrário
+     * @example
+     * new PasswordEdge("Abc@123").isEqual(new PasswordEdge("Abc@123")) // true
+     * new PasswordEdge("Abc@123").isEqual("Abc@123") // true
+     * new PasswordEdge("Abc@123").isEqual("xyz@999") // false
+     */
+    isEqual(password) {
+        const comparand = password instanceof PasswordEdge ? password.toString() : password;
+        return this.password === comparand;
+    }
+    /**
+     * Avalia a força da senha com base em critérios de complexidade.
+     * @returns "weak" | "medium" | "strong" conforme a pontuação
+     * @example
+     * new PasswordEdge("abc@123").strength() // "weak"
+     * new PasswordEdge("Abcd@123").strength() // "medium"
+     * new PasswordEdge("Abcd@1234!X").strength() // "strong"
+     */
+    strength() {
+        let score = 0;
+        if (this.hasUpperCase())
+            score++;
+        if (this.hasLowerCase())
+            score++;
+        if (this.hasNumber())
+            score++;
+        if (this.hasSpecialChar())
+            score++;
+        if (this.password.length >= 10)
+            score++;
+        if (this.password.length >= 16)
+            score++;
+        if (score <= 2)
+            return "weak";
+        if (score <= 4)
+            return "medium";
+        return "strong";
+    }
+    /**
+     * Retorna o resultado detalhado de cada etapa de validação da senha.
+     * @returns Array com o resultado de cada ValidationStep
+     * @example
+     * new PasswordEdge("Abc@123").validationResults()
+     * // [{ name: "WithAtLeastOneLetterStep", valid: true }, ...]
+     */
+    validationResults() {
+        return this.validate(this.password).validationStepsResults;
+    }
+    // ==================== Métodos Estáticos ====================
+    /**
+     * Verifica se uma string é uma senha válida sem lançar exceção.
+     * @param password - String a ser verificada
+     * @returns true se a senha é válida, false caso contrário
+     * @example
+     * PasswordEdge.isValid("Abc@123") // true
+     * PasswordEdge.isValid("abc") // false
+     */
+    static isValid(password) {
+        try {
+            new PasswordEdge(password);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
 }
 exports.PasswordEdge = PasswordEdge;

package/objects/primitives/boolean.edge.sketch.d.ts

@@ -1,7 +1,109 @@
 export declare abstract class BooleanEdgeSketch {
     private value;
     constructor(value: boolean);
-    toPoint(): boolean;
-    isEqual(value: BooleanEdgeSketch | boolean): boolean;
-    isDifferent(value: boolean): boolean;
+    /**
+     * Retorna o valor booleano interno.
+     * @returns Booleano interno do edge
+     * @example
+     * new MyBooleanEdge(true).toPoint() // true
+     */
+    toBoolean(): boolean;
+    /**
+     * Retorna o valor como string.
+     * @returns "true" ou "false"
+     * @example
+     * new MyBooleanEdge(true).toString() // "true"
+     * new MyBooleanEdge(false).toString() // "false"
+     */
+    toString(): string;
+    /**
+     * Retorna o valor como número (1 para true, 0 para false).
+     * @returns 1 se true, 0 se false
+     * @example
+     * new MyBooleanEdge(true).toNumber() // 1
+     * new MyBooleanEdge(false).toNumber() // 0
+     */
+    toNumber(): number;
+    /**
+     * Verifica se este valor é igual a outro.
+     * @param value - Booleano ou BooleanEdgeSketch para comparação
+     * @returns true se os valores são iguais, false caso contrário
+     * @example
+     * new MyBooleanEdge(true).isEqual(true) // true
+     * new MyBooleanEdge(true).isEqual(false) // false
+     */
+    isEqual(value: boolean | BooleanEdgeSketch): boolean;
+    /**
+     * Verifica se este valor é diferente de outro.
+     * @param value - Booleano ou BooleanEdgeSketch para comparação
+     * @returns true se os valores são diferentes, false caso contrário
+     * @example
+     * new MyBooleanEdge(true).isDifferent(false) // true
+     * new MyBooleanEdge(true).isDifferent(true) // false
+     */
+    isDifferent(value: boolean | BooleanEdgeSketch): boolean;
+    /**
+     * Verifica se o valor é true.
+     * @returns true se o valor interno é true, false caso contrário
+     * @example
+     * new MyBooleanEdge(true).isTrue() // true
+     * new MyBooleanEdge(false).isTrue() // false
+     */
+    isTrue(): boolean;
+    /**
+     * Verifica se o valor é false.
+     * @returns true se o valor interno é false, false caso contrário
+     * @example
+     * new MyBooleanEdge(false).isFalse() // true
+     * new MyBooleanEdge(true).isFalse() // false
+     */
+    isFalse(): boolean;
+    /**
+     * Retorna o valor negado (NOT lógico).
+     * @returns Negação do valor interno
+     * @example
+     * new MyBooleanEdge(true).negate() // false
+     * new MyBooleanEdge(false).negate() // true
+     */
+    negate(): boolean;
+    /**
+     * Realiza AND lógico entre este valor e outro.
+     * @param value - Booleano ou BooleanEdgeSketch para operação
+     * @returns Resultado do AND lógico
+     * @example
+     * new MyBooleanEdge(true).and(true) // true
+     * new MyBooleanEdge(true).and(false) // false
+     * new MyBooleanEdge(false).and(true) // false
+     */
+    and(value: boolean | BooleanEdgeSketch): boolean;
+    /**
+     * Realiza OR lógico entre este valor e outro.
+     * @param value - Booleano ou BooleanEdgeSketch para operação
+     * @returns Resultado do OR lógico
+     * @example
+     * new MyBooleanEdge(true).or(false) // true
+     * new MyBooleanEdge(false).or(false) // false
+     * new MyBooleanEdge(false).or(true) // true
+     */
+    or(value: boolean | BooleanEdgeSketch): boolean;
+    /**
+     * Realiza XOR lógico (OU exclusivo) entre este valor e outro.
+     * @param value - Booleano ou BooleanEdgeSketch para operação
+     * @returns true se os valores são diferentes, false se iguais
+     * @example
+     * new MyBooleanEdge(true).xor(false) // true
+     * new MyBooleanEdge(true).xor(true) // false
+     * new MyBooleanEdge(false).xor(false) // false
+     */
+    xor(value: boolean | BooleanEdgeSketch): boolean;
+    /**
+     * Retorna um valor baseado no estado booleano (ternário tipado).
+     * @param onTrue - Valor retornado se true
+     * @param onFalse - Valor retornado se false
+     * @returns onTrue se value é true, onFalse caso contrário
+     * @example
+     * new MyBooleanEdge(true).fold("yes", "no") // "yes"
+     * new MyBooleanEdge(false).fold("yes", "no") // "no"
+     */
+    fold<T>(onTrue: T, onFalse: T): T;
 }

package/objects/primitives/boolean.edge.sketch.js

@@ -5,17 +5,143 @@ class BooleanEdgeSketch {
     constructor(value) {
         this.value = value;
     }
-    toPoint() {
+    // ==================== Getters ====================
+    /**
+     * Retorna o valor booleano interno.
+     * @returns Booleano interno do edge
+     * @example
+     * new MyBooleanEdge(true).toPoint() // true
+     */
+    toBoolean() {
         return this.value;
     }
+    /**
+     * Retorna o valor como string.
+     * @returns "true" ou "false"
+     * @example
+     * new MyBooleanEdge(true).toString() // "true"
+     * new MyBooleanEdge(false).toString() // "false"
+     */
+    toString() {
+        return String(this.value);
+    }
+    /**
+     * Retorna o valor como número (1 para true, 0 para false).
+     * @returns 1 se true, 0 se false
+     * @example
+     * new MyBooleanEdge(true).toNumber() // 1
+     * new MyBooleanEdge(false).toNumber() // 0
+     */
+    toNumber() {
+        return this.value ? 1 : 0;
+    }
+    // ==================== Comparações ====================
+    /**
+     * Verifica se este valor é igual a outro.
+     * @param value - Booleano ou BooleanEdgeSketch para comparação
+     * @returns true se os valores são iguais, false caso contrário
+     * @example
+     * new MyBooleanEdge(true).isEqual(true) // true
+     * new MyBooleanEdge(true).isEqual(false) // false
+     */
     isEqual(value) {
-        if (value instanceof BooleanEdgeSketch) {
-            return value.toPoint() === this.value;
-        }
-        return this.value === value;
+        const comparand = value instanceof BooleanEdgeSketch ? value.toBoolean() : value;
+        return this.value === comparand;
     }
+    /**
+     * Verifica se este valor é diferente de outro.
+     * @param value - Booleano ou BooleanEdgeSketch para comparação
+     * @returns true se os valores são diferentes, false caso contrário
+     * @example
+     * new MyBooleanEdge(true).isDifferent(false) // true
+     * new MyBooleanEdge(true).isDifferent(true) // false
+     */
     isDifferent(value) {
-        return this.value !== value;
+        const comparand = value instanceof BooleanEdgeSketch ? value.toBoolean() : value;
+        return this.value !== comparand;
+    }
+    // ==================== Verificações ====================
+    /**
+     * Verifica se o valor é true.
+     * @returns true se o valor interno é true, false caso contrário
+     * @example
+     * new MyBooleanEdge(true).isTrue() // true
+     * new MyBooleanEdge(false).isTrue() // false
+     */
+    isTrue() {
+        return this.value === true;
+    }
+    /**
+     * Verifica se o valor é false.
+     * @returns true se o valor interno é false, false caso contrário
+     * @example
+     * new MyBooleanEdge(false).isFalse() // true
+     * new MyBooleanEdge(true).isFalse() // false
+     */
+    isFalse() {
+        return this.value === false;
+    }
+    // ==================== Operações Lógicas ====================
+    /**
+     * Retorna o valor negado (NOT lógico).
+     * @returns Negação do valor interno
+     * @example
+     * new MyBooleanEdge(true).negate() // false
+     * new MyBooleanEdge(false).negate() // true
+     */
+    negate() {
+        return !this.value;
+    }
+    /**
+     * Realiza AND lógico entre este valor e outro.
+     * @param value - Booleano ou BooleanEdgeSketch para operação
+     * @returns Resultado do AND lógico
+     * @example
+     * new MyBooleanEdge(true).and(true) // true
+     * new MyBooleanEdge(true).and(false) // false
+     * new MyBooleanEdge(false).and(true) // false
+     */
+    and(value) {
+        const operand = value instanceof BooleanEdgeSketch ? value.toBoolean() : value;
+        return this.value && operand;
+    }
+    /**
+     * Realiza OR lógico entre este valor e outro.
+     * @param value - Booleano ou BooleanEdgeSketch para operação
+     * @returns Resultado do OR lógico
+     * @example
+     * new MyBooleanEdge(true).or(false) // true
+     * new MyBooleanEdge(false).or(false) // false
+     * new MyBooleanEdge(false).or(true) // true
+     */
+    or(value) {
+        const operand = value instanceof BooleanEdgeSketch ? value.toBoolean() : value;
+        return this.value || operand;
+    }
+    /**
+     * Realiza XOR lógico (OU exclusivo) entre este valor e outro.
+     * @param value - Booleano ou BooleanEdgeSketch para operação
+     * @returns true se os valores são diferentes, false se iguais
+     * @example
+     * new MyBooleanEdge(true).xor(false) // true
+     * new MyBooleanEdge(true).xor(true) // false
+     * new MyBooleanEdge(false).xor(false) // false
+     */
+    xor(value) {
+        const operand = value instanceof BooleanEdgeSketch ? value.toBoolean() : value;
+        return this.value !== operand;
+    }
+    /**
+     * Retorna um valor baseado no estado booleano (ternário tipado).
+     * @param onTrue - Valor retornado se true
+     * @param onFalse - Valor retornado se false
+     * @returns onTrue se value é true, onFalse caso contrário
+     * @example
+     * new MyBooleanEdge(true).fold("yes", "no") // "yes"
+     * new MyBooleanEdge(false).fold("yes", "no") // "no"
+     */
+    fold(onTrue, onFalse) {
+        return this.value ? onTrue : onFalse;
     }
 }
 exports.BooleanEdgeSketch = BooleanEdgeSketch;