@atlantjs/arch 13.3.0 → 14.0.1

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

@@ -1,10 +1,158 @@
 export declare abstract class StringEdgeSketch {
     private value;
     constructor(value: string);
+    /**
+     * Retorna o valor da string.
+     * @returns String interna do edge
+     * @example
+     * new MyStringEdge("hello").toString() // "hello"
+     */
     toString(): string;
+    /**
+     * Retorna o comprimento da string.
+     * @returns Número de caracteres da string
+     * @example
+     * new MyStringEdge("hello").length() // 5
+     */
+    length(): number;
+    /**
+     * Verifica se a string contém uma substring específica.
+     * @param value - Substring a ser procurada
+     * @returns true se a substring foi encontrada, false caso contrário
+     * @example
+     * new MyStringEdge("hello world").has("world") // true
+     * new MyStringEdge("hello world").has("foo") // false
+     */
     has(value: string): boolean;
+    /**
+     * Verifica se a string começa com uma substring específica.
+     * @param value - Substring a ser verificada no início
+     * @returns true se a string começa com a substring, false caso contrário
+     * @example
+     * new MyStringEdge("hello world").startsWith("hello") // true
+     * new MyStringEdge("hello world").startsWith("world") // false
+     */
+    startsWith(value: string): boolean;
+    /**
+     * Verifica se a string termina com uma substring específica.
+     * @param value - Substring a ser verificada no final
+     * @returns true se a string termina com a substring, false caso contrário
+     * @example
+     * new MyStringEdge("hello world").endsWith("world") // true
+     * new MyStringEdge("hello world").endsWith("hello") // false
+     */
+    endsWith(value: string): boolean;
+    /**
+     * Verifica se a string é igual a outra (case-sensitive).
+     * @param value - String para comparação
+     * @returns true se as strings são iguais, false caso contrário
+     * @example
+     * new MyStringEdge("hello").isEqual("hello") // true
+     * new MyStringEdge("hello").isEqual("Hello") // false
+     */
+    isEqual(value: string): boolean;
+    /**
+     * Verifica se a string é igual a outra ignorando maiúsculas/minúsculas.
+     * @param value - String para comparação
+     * @returns true se as strings são iguais (case-insensitive), false caso contrário
+     * @example
+     * new MyStringEdge("hello").isEqualIgnoreCase("HELLO") // true
+     * new MyStringEdge("hello").isEqualIgnoreCase("world") // false
+     */
+    isEqualIgnoreCase(value: string): boolean;
+    /**
+     * Extrai uma substring entre dois delimitadores (exclusivo).
+     * @param start - Delimitador de início (não incluído no resultado)
+     * @param end - Delimitador de fim (não incluído no resultado)
+     * @returns Substring entre os delimitadores
+     * @example
+     * new MyStringEdge("[hello]").extract("[", "]") // "hello"
+     * new MyStringEdge("(foo bar)").extract("(", ")") // "foo bar"
+     */
     extract(start: string, end: string): string;
+    /**
+     * Retorna uma fatia da string entre dois índices.
+     * @param start - Índice inicial (inclusivo)
+     * @param end - Índice final (exclusivo, opcional)
+     * @returns Substring entre os índices fornecidos
+     * @example
+     * new MyStringEdge("hello world").slice(0, 5) // "hello"
+     * new MyStringEdge("hello world").slice(6) // "world"
+     */
+    slice(start: number, end?: number): string;
+    /**
+     * Remove todas as ocorrências das substrings fornecidas.
+     * @param substrings - Array de substrings a serem removidas
+     * @returns Nova string sem as substrings fornecidas
+     * @example
+     * new MyStringEdge("hello world").remove(["hello", " "]) // "world"
+     * new MyStringEdge("foo-bar_baz").remove(["-", "_"]) // "foobarbaz"
+     */
     remove(substrings: string[]): string;
+    /**
+     * Substitui a primeira ocorrência de uma substring por outra.
+     * @param search - Substring a ser substituída
+     * @param replacement - Substring substituta
+     * @returns Nova string com a primeira ocorrência substituída
+     * @example
+     * new MyStringEdge("foo bar foo").replace("foo", "baz") // "baz bar foo"
+     */
+    replace(search: string, replacement: string): string;
+    /**
+     * Substitui todas as ocorrências de uma substring por outra.
+     * @param search - Substring a ser substituída
+     * @param replacement - Substring substituta
+     * @returns Nova string com todas as ocorrências substituídas
+     * @example
+     * new MyStringEdge("foo bar foo").replaceAll("foo", "baz") // "baz bar baz"
+     */
+    replaceAll(search: string, replacement: string): string;
+    /**
+     * Converte a string para letras maiúsculas.
+     * @returns String em maiúsculas
+     * @example
+     * new MyStringEdge("hello").toUpperCase() // "HELLO"
+     */
+    toUpperCase(): string;
+    /**
+     * Converte a string para letras minúsculas.
+     * @returns String em minúsculas
+     * @example
+     * new MyStringEdge("HELLO").toLowerCase() // "hello"
+     */
+    toLowerCase(): string;
+    /**
+     * Reverte os caracteres da string.
+     * @returns String com os caracteres em ordem inversa
+     * @example
+     * new MyStringEdge("hello").reverse() // "olleh"
+     */
+    reverse(): string;
+    /**
+     * Trunca a string para um comprimento máximo, adicionando "..." ao final.
+     * Se a string já for menor ou igual ao comprimento, retorna sem alteração.
+     * @param length - Comprimento máximo da string resultante (incluindo "...")
+     * @returns String truncada com "..." se necessário
+     * @example
+     * new MyStringEdge("Hello World").truncate(8) // "Hello..."
+     * new MyStringEdge("Hi").truncate(8) // "Hi"
+     */
+    truncate(length: number): string;
+    /**
+     * Conta o número de ocorrências de uma substring na string.
+     * @param substring - Substring a ser contada
+     * @returns Número de ocorrências encontradas
+     * @example
+     * new MyStringEdge("hello world hello").countOccurrences("hello") // 2
+     */
+    countOccurrences(substring: string): number;
+    /**
+     * Remove espaços extras no início e no fim da string.
+     */
     private sanitize;
+    /**
+     * Valida se a string não está vazia após o sanitize.
+     * @throws {TypeError} Se a string estiver vazia
+     */
     private validate;
 }

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

@@ -7,27 +7,211 @@ class StringEdgeSketch {
         this.sanitize();
         this.validate();
     }
+    // ==================== Getters ====================
+    /**
+     * Retorna o valor da string.
+     * @returns String interna do edge
+     * @example
+     * new MyStringEdge("hello").toString() // "hello"
+     */
     toString() {
         return this.value;
     }
+    /**
+     * Retorna o comprimento da string.
+     * @returns Número de caracteres da string
+     * @example
+     * new MyStringEdge("hello").length() // 5
+     */
+    length() {
+        return this.value.length;
+    }
+    // ==================== Verificações ====================
+    /**
+     * Verifica se a string contém uma substring específica.
+     * @param value - Substring a ser procurada
+     * @returns true se a substring foi encontrada, false caso contrário
+     * @example
+     * new MyStringEdge("hello world").has("world") // true
+     * new MyStringEdge("hello world").has("foo") // false
+     */
     has(value) {
-        return !this.value.indexOf(value);
+        return this.value.includes(value); // 🐛 fix: !indexOf() falha quando index é 0
+    }
+    /**
+     * Verifica se a string começa com uma substring específica.
+     * @param value - Substring a ser verificada no início
+     * @returns true se a string começa com a substring, false caso contrário
+     * @example
+     * new MyStringEdge("hello world").startsWith("hello") // true
+     * new MyStringEdge("hello world").startsWith("world") // false
+     */
+    startsWith(value) {
+        return this.value.startsWith(value);
+    }
+    /**
+     * Verifica se a string termina com uma substring específica.
+     * @param value - Substring a ser verificada no final
+     * @returns true se a string termina com a substring, false caso contrário
+     * @example
+     * new MyStringEdge("hello world").endsWith("world") // true
+     * new MyStringEdge("hello world").endsWith("hello") // false
+     */
+    endsWith(value) {
+        return this.value.endsWith(value);
+    }
+    /**
+     * Verifica se a string é igual a outra (case-sensitive).
+     * @param value - String para comparação
+     * @returns true se as strings são iguais, false caso contrário
+     * @example
+     * new MyStringEdge("hello").isEqual("hello") // true
+     * new MyStringEdge("hello").isEqual("Hello") // false
+     */
+    isEqual(value) {
+        return this.value === value;
     }
+    /**
+     * Verifica se a string é igual a outra ignorando maiúsculas/minúsculas.
+     * @param value - String para comparação
+     * @returns true se as strings são iguais (case-insensitive), false caso contrário
+     * @example
+     * new MyStringEdge("hello").isEqualIgnoreCase("HELLO") // true
+     * new MyStringEdge("hello").isEqualIgnoreCase("world") // false
+     */
+    isEqualIgnoreCase(value) {
+        return this.value.toLowerCase() === value.toLowerCase();
+    }
+    // ==================== Extração ====================
+    /**
+     * Extrai uma substring entre dois delimitadores (exclusivo).
+     * @param start - Delimitador de início (não incluído no resultado)
+     * @param end - Delimitador de fim (não incluído no resultado)
+     * @returns Substring entre os delimitadores
+     * @example
+     * new MyStringEdge("[hello]").extract("[", "]") // "hello"
+     * new MyStringEdge("(foo bar)").extract("(", ")") // "foo bar"
+     */
     extract(start, end) {
-        const indexStartValue = this.value.indexOf(start);
-        const indexEndValue = this.value.lastIndexOf(end) + 1;
-        return this.value.substring(indexStartValue, indexEndValue);
+        const indexStart = this.value.indexOf(start) + start.length; // 🐛 fix: incluir tamanho do delimitador
+        const indexEnd = this.value.lastIndexOf(end); // 🐛 fix: remover + 1 que incluía o char final
+        return this.value.substring(indexStart, indexEnd);
+    }
+    /**
+     * Retorna uma fatia da string entre dois índices.
+     * @param start - Índice inicial (inclusivo)
+     * @param end - Índice final (exclusivo, opcional)
+     * @returns Substring entre os índices fornecidos
+     * @example
+     * new MyStringEdge("hello world").slice(0, 5) // "hello"
+     * new MyStringEdge("hello world").slice(6) // "world"
+     */
+    slice(start, end) {
+        return this.value.slice(start, end);
     }
+    // ==================== Transformação ====================
+    /**
+     * Remove todas as ocorrências das substrings fornecidas.
+     * @param substrings - Array de substrings a serem removidas
+     * @returns Nova string sem as substrings fornecidas
+     * @example
+     * new MyStringEdge("hello world").remove(["hello", " "]) // "world"
+     * new MyStringEdge("foo-bar_baz").remove(["-", "_"]) // "foobarbaz"
+     */
     remove(substrings) {
-        const regex = new RegExp(`[${substrings.join("")}]`, "g");
-        return this.value.replace(regex, "");
+        return substrings.reduce(
+        // 🐛 fix: regex com [...] quebra para substrings com mais de 1 char
+        (acc, substring) => acc.split(substring).join(""), this.value);
+    }
+    /**
+     * Substitui a primeira ocorrência de uma substring por outra.
+     * @param search - Substring a ser substituída
+     * @param replacement - Substring substituta
+     * @returns Nova string com a primeira ocorrência substituída
+     * @example
+     * new MyStringEdge("foo bar foo").replace("foo", "baz") // "baz bar foo"
+     */
+    replace(search, replacement) {
+        return this.value.replace(search, replacement);
+    }
+    /**
+     * Substitui todas as ocorrências de uma substring por outra.
+     * @param search - Substring a ser substituída
+     * @param replacement - Substring substituta
+     * @returns Nova string com todas as ocorrências substituídas
+     * @example
+     * new MyStringEdge("foo bar foo").replaceAll("foo", "baz") // "baz bar baz"
+     */
+    replaceAll(search, replacement) {
+        return this.value.split(search).join(replacement);
+    }
+    /**
+     * Converte a string para letras maiúsculas.
+     * @returns String em maiúsculas
+     * @example
+     * new MyStringEdge("hello").toUpperCase() // "HELLO"
+     */
+    toUpperCase() {
+        return this.value.toUpperCase();
+    }
+    /**
+     * Converte a string para letras minúsculas.
+     * @returns String em minúsculas
+     * @example
+     * new MyStringEdge("HELLO").toLowerCase() // "hello"
+     */
+    toLowerCase() {
+        return this.value.toLowerCase();
+    }
+    /**
+     * Reverte os caracteres da string.
+     * @returns String com os caracteres em ordem inversa
+     * @example
+     * new MyStringEdge("hello").reverse() // "olleh"
+     */
+    reverse() {
+        return this.value.split("").reverse().join("");
+    }
+    /**
+     * Trunca a string para um comprimento máximo, adicionando "..." ao final.
+     * Se a string já for menor ou igual ao comprimento, retorna sem alteração.
+     * @param length - Comprimento máximo da string resultante (incluindo "...")
+     * @returns String truncada com "..." se necessário
+     * @example
+     * new MyStringEdge("Hello World").truncate(8) // "Hello..."
+     * new MyStringEdge("Hi").truncate(8) // "Hi"
+     */
+    truncate(length) {
+        if (this.value.length <= length)
+            return this.value;
+        return `${this.value.substring(0, length - 3)}...`;
+    }
+    /**
+     * Conta o número de ocorrências de uma substring na string.
+     * @param substring - Substring a ser contada
+     * @returns Número de ocorrências encontradas
+     * @example
+     * new MyStringEdge("hello world hello").countOccurrences("hello") // 2
+     */
+    countOccurrences(substring) {
+        if (substring.length === 0)
+            return 0;
+        return this.value.split(substring).length - 1;
     }
+    // ==================== Privados ====================
+    /**
+     * Remove espaços extras no início e no fim da string.
+     */
     sanitize() {
         this.value = this.value.trim();
     }
+    /**
+     * Valida se a string não está vazia após o sanitize.
+     * @throws {TypeError} Se a string estiver vazia
+     */
     validate() {
         if (this.value.length <= 0) {
-            throw TypeError(`${this.constructor.name} should not be empty.`);
+            throw new TypeError(`${this.constructor.name} should not be empty.`);
         }
     }
 }

package/objects/schedule/schedule.edge.d.ts

@@ -6,11 +6,205 @@ import { TimeEdge } from "../time/time.edge";
 export declare class ScheduleEdge {
     protected _moment: CronExpressionEdge | DatetimeEdge;
     constructor(_moment: CronExpressionEdge | DatetimeEdge);
+    /**
+     * Verifica se o agendamento é recorrente (baseado em expressão cron).
+     * @returns true se o agendamento é recorrente, false se é um datetime fixo
+     * @example
+     * new ScheduleEdge(new CronExpressionEdge("0 8 * * *")).isRecurrent() // true
+     * new ScheduleEdge(new DatetimeEdge(new Date())).isRecurrent() // false
+     */
     isRecurrent(): boolean;
+    /**
+     * Verifica se o agendamento é um evento único (baseado em DatetimeEdge).
+     * @returns true se o agendamento é um evento único, false se é recorrente
+     * @example
+     * new ScheduleEdge(new DatetimeEdge(new Date())).isOneTime() // true
+     * new ScheduleEdge(new CronExpressionEdge("0 8 * * *")).isOneTime() // false
+     */
+    isOneTime(): boolean;
+    /**
+     * Verifica se o agendamento já passou em relação à data/hora atual.
+     * Para agendamentos recorrentes, sempre retorna false.
+     * @returns true se a data do agendamento é anterior ao momento atual
+     * @example
+     * new ScheduleEdge(new DatetimeEdge(new Date("2020-01-01"))).isPast() // true
+     * new ScheduleEdge(new DatetimeEdge(new Date("2099-01-01"))).isPast() // false
+     */
+    isPast(): boolean;
+    /**
+     * Verifica se o agendamento ainda está no futuro em relação à data/hora atual.
+     * Para agendamentos recorrentes, sempre retorna true.
+     * @returns true se a data do agendamento é posterior ao momento atual
+     * @example
+     * new ScheduleEdge(new DatetimeEdge(new Date("2099-01-01"))).isFuture() // true
+     * new ScheduleEdge(new DatetimeEdge(new Date("2020-01-01"))).isFuture() // false
+     */
+    isFuture(): boolean;
+    /**
+     * Verifica se o agendamento ocorre hoje.
+     * Para agendamentos recorrentes, verifica se há uma ocorrência hoje.
+     * @returns true se há uma ocorrência hoje, false caso contrário
+     * @example
+     * new ScheduleEdge(new DatetimeEdge(new Date())).isToday() // true
+     */
+    isToday(): boolean;
+    /**
+     * Retorna a próxima ocorrência de um agendamento recorrente.
+     * @returns Success com a próxima ocorrência ou Failure se o agendamento não for recorrente
+     * @example
+     * const schedule = new ScheduleEdge(new CronExpressionEdge("0 8 * * *"));
+     * schedule.nextOccurrence() // Success(DatetimeEdge com a próxima ocorrência às 8h)
+     */
     nextOccurrence(): Return<DatetimeEdge, FailureAbstract>;
+    /**
+     * Retorna as próximas N ocorrências de um agendamento recorrente.
+     * @param quantity - Número de ocorrências a retornar
+     * @returns Success com array das próximas ocorrências ou Failure se não for recorrente
+     * @example
+     * const schedule = new ScheduleEdge(new CronExpressionEdge("0 8 * * *"));
+     * schedule.nextOccurrences(3) // Success([DatetimeEdge, DatetimeEdge, DatetimeEdge])
+     */
     nextOccurrences(quantity: number): Return<DatetimeEdge[], FailureAbstract>;
+    /**
+     * Retorna a ocorrência anterior de um agendamento recorrente.
+     * @returns Success com a ocorrência anterior ou Failure se o agendamento não for recorrente
+     * @example
+     * const schedule = new ScheduleEdge(new CronExpressionEdge("0 8 * * *"));
+     * schedule.previousOccurrence() // Success(DatetimeEdge com a última ocorrência às 8h)
+     */
     previousOccurrence(): Return<DatetimeEdge, FailureAbstract>;
+    /**
+     * Retorna as N ocorrências anteriores de um agendamento recorrente.
+     * @param quantity - Número de ocorrências a retornar
+     * @returns Success com array das ocorrências anteriores ou Failure se não for recorrente
+     * @example
+     * const schedule = new ScheduleEdge(new CronExpressionEdge("0 8 * * *"));
+     * schedule.previousOccurrences(3) // Success([DatetimeEdge, DatetimeEdge, DatetimeEdge])
+     */
     previousOccurrences(quantity: number): Return<DatetimeEdge[], FailureAbstract>;
+    /**
+     * Retorna todas as ocorrências dentro de um intervalo de datas.
+     * @param start - Data de início do intervalo
+     * @param end - Data de fim do intervalo
+     * @returns Success com array das ocorrências no intervalo ou Failure se não for recorrente
+     * @example
+     * const schedule = new ScheduleEdge(new CronExpressionEdge("0 8 * * *"));
+     * schedule.occurrencesBetween(startDate, endDate)
+     * // Success([DatetimeEdge, DatetimeEdge, ...])
+     */
+    occurrencesBetween(start: DatetimeEdge, end: DatetimeEdge): Return<DatetimeEdge[], FailureAbstract>;
+    /**
+     * Conta quantas ocorrências existem dentro de um intervalo de datas.
+     * @param start - Data de início do intervalo
+     * @param end - Data de fim do intervalo
+     * @returns Success com o número de ocorrências ou Failure se não for recorrente
+     * @example
+     * const schedule = new ScheduleEdge(new CronExpressionEdge("0 8 * * 1-5"));
+     * schedule.countOccurrencesBetween(startDate, endDate) // Success(5) em uma semana
+     */
+    countOccurrencesBetween(start: DatetimeEdge, end: DatetimeEdge): Return<number, FailureAbstract>;
+    /**
+     * Retorna o horário do agendamento como um TimeEdge.
+     * @returns TimeEdge com hora e minuto do agendamento
+     * @example
+     * new ScheduleEdge(new CronExpressionEdge("0 8 * * *")).getTime()
+     * // TimeEdge("08:00")
+     */
     getTime(): TimeEdge;
+    /**
+     * Retorna o momento interno do agendamento (CronExpressionEdge ou DatetimeEdge).
+     * @returns Instância de CronExpressionEdge ou DatetimeEdge
+     * @example
+     * new ScheduleEdge(new CronExpressionEdge("0 8 * * *")).getMoment()
+     * // CronExpressionEdge("0 8 * * *")
+     */
+    getMoment(): CronExpressionEdge | DatetimeEdge;
+    /**
+     * Retorna o DatetimeEdge do agendamento se for um evento único.
+     * @returns Success com o DatetimeEdge ou Failure se o agendamento for recorrente
+     * @example
+     * const date = new DatetimeEdge(new Date());
+     * new ScheduleEdge(date).getDatetime() // Success(DatetimeEdge)
+     */
+    getDatetime(): Return<DatetimeEdge, FailureAbstract>;
+    /**
+     * Retorna a CronExpressionEdge do agendamento se for recorrente.
+     * @returns Success com a CronExpressionEdge ou Failure se for evento único
+     * @example
+     * const cron = new CronExpressionEdge("0 8 * * *");
+     * new ScheduleEdge(cron).getCronExpression() // Success(CronExpressionEdge)
+     */
+    getCronExpression(): Return<CronExpressionEdge, FailureAbstract>;
+    /**
+     * Cria uma cópia independente desta instância de ScheduleEdge.
+     * @returns Nova instância com o mesmo momento interno
+     * @example
+     * const schedule = new ScheduleEdge(new CronExpressionEdge("0 8 * * *"));
+     * const clone = schedule.clone(); // instância independente
+     */
+    clone(): ScheduleEdge;
+    /**
+     * Retorna uma nova instância com o momento alterado.
+     * @param moment - Novo momento (CronExpressionEdge ou DatetimeEdge)
+     * @returns Nova instância com o momento alterado
+     * @example
+     * const schedule = new ScheduleEdge(new CronExpressionEdge("0 8 * * *"));
+     * const updated = schedule.withMoment(new CronExpressionEdge("0 10 * * *"));
+     */
+    withMoment(moment: CronExpressionEdge | DatetimeEdge): ScheduleEdge;
+    /**
+     * Retorna a representação em string do momento do agendamento.
+     * Para cron, retorna a expressão cron. Para datetime, retorna a ISO string.
+     * @returns String representando o agendamento
+     * @example
+     * new ScheduleEdge(new CronExpressionEdge("0 8 * * *")).toString() // "0 8 * * *"
+     * new ScheduleEdge(new DatetimeEdge(new Date())).toString() // "2026-03-12T14:00:00.000Z"
+     */
     toString(): string;
+    /**
+     * Cria um ScheduleEdge recorrente a partir de uma expressão cron.
+     * @param expression - Expressão cron válida
+     * @returns Nova instância de ScheduleEdge recorrente
+     * @example
+     * ScheduleEdge.fromCron("0 8 * * *") // agendamento diário às 8h
+     * ScheduleEdge.fromCron("0 8 * * 1-5") // agendamento de segunda a sexta às 8h
+     */
+    static fromCron(expression: string): ScheduleEdge;
+    /**
+     * Cria um ScheduleEdge de evento único a partir de um objeto Date.
+     * @param date - Data e hora do evento único
+     * @returns Nova instância de ScheduleEdge para evento único
+     * @example
+     * ScheduleEdge.fromDate(new Date("2026-12-25T08:00:00"))
+     * // agendamento para o Natal de 2026 às 8h
+     */
+    static fromDate(date: Date): ScheduleEdge;
+    /**
+     * Cria um ScheduleEdge para agendamentos diários em um horário específico.
+     * @param time - Horário do agendamento no formato TimeEdge
+     * @returns Nova instância de ScheduleEdge com recorrência diária
+     * @example
+     * ScheduleEdge.daily(new TimeEdge("08:00")) // todos os dias às 8h -> "0 8 * * *"
+     */
+    static daily(time: TimeEdge): ScheduleEdge;
+    /**
+     * Cria um ScheduleEdge para agendamentos semanais em um dia e horário específico.
+     * @param dayOfWeek - Dia da semana (0=domingo, 1=segunda, ..., 6=sábado)
+     * @param time - Horário do agendamento no formato TimeEdge
+     * @returns Nova instância de ScheduleEdge com recorrência semanal
+     * @example
+     * ScheduleEdge.weekly(1, new TimeEdge("08:00"))
+     * // toda segunda-feira às 8h -> "0 8 * * 1"
+     */
+    static weekly(dayOfWeek: number, time: TimeEdge): ScheduleEdge;
+    /**
+     * Cria um ScheduleEdge para agendamentos mensais em um dia e horário específico.
+     * @param dayOfMonth - Dia do mês (1-31)
+     * @param time - Horário do agendamento no formato TimeEdge
+     * @returns Nova instância de ScheduleEdge com recorrência mensal
+     * @example
+     * ScheduleEdge.monthly(15, new TimeEdge("08:00"))
+     * // todo dia 15 de cada mês às 8h -> "0 8 15 * *"
+     */
+    static monthly(dayOfMonth: number, time: TimeEdge): ScheduleEdge;
 }