@atlantjs/arch 14.0.4 → 15.0.0

package/@tool-box/utils/validators/is-schedule.d.ts

@@ -1,2 +1,2 @@
 import { ValidationOptions } from "class-validator";
-export declare function IsSchedule(validationOptions?: ValidationOptions): (object: Object, propertyName: string) => void;
+export declare function IsScheduling(validationOptions?: ValidationOptions): (object: Object, propertyName: string) => void;

package/@tool-box/utils/validators/is-schedule.js

@@ -6,7 +6,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IsSchedule = IsSchedule;
+exports.IsScheduling = IsScheduling;
 const class_validator_1 = require("class-validator");
 function isValidScheduleFormat(value) {
     const cron5Regex = /^(\*|([0-5]?\d)(\/\d+)?|([0-5]?\d)-([0-5]?\d)(\/\d+)?)(,(\*|([0-5]?\d)(\/\d+)?|([0-5]?\d)-([0-5]?\d)(\/\d+)?))*\s+(\*|([01]?\d|2[0-3])(\/\d+)?|([01]?\d|2[0-3])-([01]?\d|2[0-3])(\/\d+)?)(,(\*|([01]?\d|2[0-3])(\/\d+)?|([01]?\d|2[0-3])-([01]?\d|2[0-3])(\/\d+)?))*\s+(\*|([1-9]|[12]\d|3[01])(\/\d+)?|([1-9]|[12]\d|3[01])-([1-9]|[12]\d|3[01])(\/\d+)?)(,(\*|([1-9]|[12]\d|3[01])(\/\d+)?|([1-9]|[12]\d|3[01])-([1-9]|[12]\d|3[01])(\/\d+)?))*\s+(\*|(1[0-2]|[1-9])(\/\d+)?|(1[0-2]|[1-9])-(1[0-2]|[1-9])(\/\d+)?)(,(\*|(1[0-2]|[1-9])(\/\d+)?|(1[0-2]|[1-2]|[1-9])-(1[0-2]|[1-9])(\/\d+)?))*\s+(\*|([0-7])(\/\d+)?|([0-7])-([0-7])(\/\d+)?)(,(\*|([0-7])(\/\d+)?|([0-7])-([0-7])(\/\d+)?))*$/;
@@ -30,7 +30,7 @@ let IsScheduleConstraint = class IsScheduleConstraint {
 IsScheduleConstraint = __decorate([
     (0, class_validator_1.ValidatorConstraint)({ name: "isSchedule", async: false })
 ], IsScheduleConstraint);
-function IsSchedule(validationOptions) {
+function IsScheduling(validationOptions) {
     return (object, propertyName) => {
         (0, class_validator_1.registerDecorator)({
             target: object.constructor,

package/index.d.ts

@@ -5,8 +5,7 @@ export { IsPasswordPolicy } from "./@tool-box/utils/validators/is-password-polic
 export { c } from "./@tool-box/utils/logger";
 export { HttpProvider } from "./@tool-box/utils/http-provider/http-provider";
 export { InstanceOf, Plainify } from "./@tool-box/utils/datatypes/plainify";
-export { IsSchedule } from "./@tool-box/utils/validators/is-schedule";
-export { CronExpressionEdge } from "./objects/@common/edges/cron-expression.edge";
+export { IsScheduling } from "./@tool-box/utils/validators/is-schedule";
 export { StringEdgeSketch } from "./objects/primitives/string.edge.sketch";
 export { NumberEdgeSketch } from "./objects/primitives/number.edge.sketch";
 export { DatetimeEdgeSketch } from "./objects/primitives/datetime.edge.sketch";
@@ -43,7 +42,7 @@ export { Return, Success, Failure } from "./@tool-box/utils/ducts/return-type";
 export { MonthMapper } from "./@tool-box/utils/datetime/mappers/month.mapper";
 export { MonthAbbreviationEnum } from "./@tool-box/utils/datetime/mappers/points/month-abbreviation.enum";
 export { MonthNumberEnum } from "./@tool-box/utils/datetime/mappers/points/month-number.enum";
-export { ScheduleEdge } from "./objects/schedule/schedule.edge";
+export { SchedulingEdge } from "./objects/scheduling/scheduling.edge";
 export { EdgeAbstract } from "./objects-interface/edges/edge.abstract";
 export { MetadataEdge } from "./objects-interface/edges/metadata.edge";
 export { MetadataPolygon } from "./objects-interface/edges/metadata.polygon";

package/index.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UvAbstract = exports.SolidAbstract = exports.FaceAbstract = exports.MetadataUv = exports.MetadataEdge = exports.EdgeAbstract = exports.ScheduleEdge = exports.MonthNumberEnum = exports.MonthAbbreviationEnum = exports.MonthMapper = exports.Failure = exports.Success = exports.Return = exports.faker = exports.CreateFakeCommand = exports.UsernameEdgeBuilder = exports.EmailEdgeBuilder = exports.FailureEdgeBuilder = exports.BuilderAbstract = exports.IsCronExpression = exports.MapAbstract = exports.Optional = exports.Nothing = exports.Random = exports._ = exports.ResponseAbstract = exports.PayloadAbstract = exports.UuidSketchEdge = exports.UlidSketchEdge = exports.UsernameEdge = exports.UrlEdge = exports.EmailEdge = exports.EnvironmentPoint = exports.HttpStatusCodes = exports.HeaderTokenNamePoint = exports.WeekDayEnum = exports.MonthNameEnum = exports.DatetimeEdge = exports.FailureAbstract = exports.PasswordEdge = exports.BooleanEdgeSketch = exports.DatetimeEdgeSketch = exports.NumberEdgeSketch = exports.StringEdgeSketch = exports.CronExpressionEdge = exports.IsSchedule = exports.HttpProvider = exports.c = exports.IsPasswordPolicy = exports.IsPasswordsMatch = void 0;
-exports.IsULID = exports.IsTimeString = exports.IsUv = exports.registerDecorator = exports.IsNotEmptyObject = exports.IsObject = exports.IsArray = exports.IsString = exports.IsInt = exports.IsEnum = exports.IsNumber = exports.IsDate = exports.IsBoolean = exports.IsNumberString = exports.IsUrl = exports.IsUUID = exports.IsJWT = exports.IsJSON = exports.IsPort = exports.IsIP = exports.IsCurrency = exports.IsEmail = exports.IsBase64 = exports.IsDecimal = exports.MaxDate = exports.MinDate = exports.Min = exports.Max = exports.IsNegative = exports.IsPositive = exports.IsNotEmpty = exports.IsEmpty = exports.IsLongitude = exports.IsLatitude = exports.IsLatLong = exports.ValidateInner = exports.IsOptional = exports.ObjectUnitPoint = exports.ConvertUnit = exports.AmountUv = exports.WeekDayPoint = exports.VolumeUnitPoint = exports.MonthNamePoint = exports.MassUnitPoint = exports.LengthUnitPoint = exports.EnergyUnitPoint = exports.DurationUnitPoint = exports.AmountEdge = exports.TimeEdge = exports.VertexAbstract = void 0;
-exports.IsDateString = void 0;
+exports.VertexAbstract = exports.UvAbstract = exports.SolidAbstract = exports.FaceAbstract = exports.MetadataUv = exports.MetadataEdge = exports.EdgeAbstract = exports.SchedulingEdge = exports.MonthNumberEnum = exports.MonthAbbreviationEnum = exports.MonthMapper = exports.Failure = exports.Success = exports.Return = exports.faker = exports.CreateFakeCommand = exports.UsernameEdgeBuilder = exports.EmailEdgeBuilder = exports.FailureEdgeBuilder = exports.BuilderAbstract = exports.IsCronExpression = exports.MapAbstract = exports.Optional = exports.Nothing = exports.Random = exports._ = exports.ResponseAbstract = exports.PayloadAbstract = exports.UuidSketchEdge = exports.UlidSketchEdge = exports.UsernameEdge = exports.UrlEdge = exports.EmailEdge = exports.EnvironmentPoint = exports.HttpStatusCodes = exports.HeaderTokenNamePoint = exports.WeekDayEnum = exports.MonthNameEnum = exports.DatetimeEdge = exports.FailureAbstract = exports.PasswordEdge = exports.BooleanEdgeSketch = exports.DatetimeEdgeSketch = exports.NumberEdgeSketch = exports.StringEdgeSketch = exports.IsScheduling = exports.HttpProvider = exports.c = exports.IsPasswordPolicy = exports.IsPasswordsMatch = void 0;
+exports.IsDateString = exports.IsULID = exports.IsTimeString = exports.IsUv = exports.registerDecorator = exports.IsNotEmptyObject = exports.IsObject = exports.IsArray = exports.IsString = exports.IsInt = exports.IsEnum = exports.IsNumber = exports.IsDate = exports.IsBoolean = exports.IsNumberString = exports.IsUrl = exports.IsUUID = exports.IsJWT = exports.IsJSON = exports.IsPort = exports.IsIP = exports.IsCurrency = exports.IsEmail = exports.IsBase64 = exports.IsDecimal = exports.MaxDate = exports.MinDate = exports.Min = exports.Max = exports.IsNegative = exports.IsPositive = exports.IsNotEmpty = exports.IsEmpty = exports.IsLongitude = exports.IsLatitude = exports.IsLatLong = exports.ValidateInner = exports.IsOptional = exports.ObjectUnitPoint = exports.ConvertUnit = exports.AmountUv = exports.WeekDayPoint = exports.VolumeUnitPoint = exports.MonthNamePoint = exports.MassUnitPoint = exports.LengthUnitPoint = exports.EnergyUnitPoint = exports.DurationUnitPoint = exports.AmountEdge = exports.TimeEdge = void 0;
 require("./@tool-box/utils/datatypes/string-utils");
 require("./@tool-box/utils/datatypes/boolean-utils");
 var is_password_match_1 = require("./@tool-box/utils/validators/is-password-match");
@@ -14,9 +13,7 @@ Object.defineProperty(exports, "c", { enumerable: true, get: function () { retur
 var http_provider_1 = require("./@tool-box/utils/http-provider/http-provider");
 Object.defineProperty(exports, "HttpProvider", { enumerable: true, get: function () { return http_provider_1.HttpProvider; } });
 var is_schedule_1 = require("./@tool-box/utils/validators/is-schedule");
-Object.defineProperty(exports, "IsSchedule", { enumerable: true, get: function () { return is_schedule_1.IsSchedule; } });
-var cron_expression_edge_1 = require("./objects/@common/edges/cron-expression.edge");
-Object.defineProperty(exports, "CronExpressionEdge", { enumerable: true, get: function () { return cron_expression_edge_1.CronExpressionEdge; } });
+Object.defineProperty(exports, "IsScheduling", { enumerable: true, get: function () { return is_schedule_1.IsScheduling; } });
 var string_edge_sketch_1 = require("./objects/primitives/string.edge.sketch");
 Object.defineProperty(exports, "StringEdgeSketch", { enumerable: true, get: function () { return string_edge_sketch_1.StringEdgeSketch; } });
 var number_edge_sketch_1 = require("./objects/primitives/number.edge.sketch");
@@ -88,8 +85,8 @@ var month_abbreviation_enum_1 = require("./@tool-box/utils/datetime/mappers/poin
 Object.defineProperty(exports, "MonthAbbreviationEnum", { enumerable: true, get: function () { return month_abbreviation_enum_1.MonthAbbreviationEnum; } });
 var month_number_enum_1 = require("./@tool-box/utils/datetime/mappers/points/month-number.enum");
 Object.defineProperty(exports, "MonthNumberEnum", { enumerable: true, get: function () { return month_number_enum_1.MonthNumberEnum; } });
-var schedule_edge_1 = require("./objects/schedule/schedule.edge");
-Object.defineProperty(exports, "ScheduleEdge", { enumerable: true, get: function () { return schedule_edge_1.ScheduleEdge; } });
+var scheduling_edge_1 = require("./objects/scheduling/scheduling.edge");
+Object.defineProperty(exports, "SchedulingEdge", { enumerable: true, get: function () { return scheduling_edge_1.SchedulingEdge; } });
 var edge_abstract_1 = require("./objects-interface/edges/edge.abstract");
 Object.defineProperty(exports, "EdgeAbstract", { enumerable: true, get: function () { return edge_abstract_1.EdgeAbstract; } });
 var metadata_edge_1 = require("./objects-interface/edges/metadata.edge");

package/objects/{schedule/schedule.edge.d.ts → scheduling/scheduling.edge.d.ts}

@@ -1,11 +1,14 @@
+import { Optional } from "../../@tool-box/utils/ducts/optional-type";
 import { Return } from "../../@tool-box/utils/ducts/return-type";
-import { CronExpressionEdge } from "../@common/edges/cron-expression.edge";
 import { DatetimeEdge } from "../datetime/edges/datetime.edge";
 import { FailureAbstract } from "../failure/edges/failure.abstract";
+import { StringEdgeSketch } from "../primitives/string.edge.sketch";
 import { TimeEdge } from "../time/time.edge";
-export declare class ScheduleEdge {
-    protected _moment: CronExpressionEdge | DatetimeEdge;
-    constructor(_moment: CronExpressionEdge | DatetimeEdge);
+export declare class SchedulingEdge extends StringEdgeSketch {
+    protected _cronExpression: string;
+    expiresInPacked: Optional<DatetimeEdge>;
+    constructor(_cronExpression: string);
+    protected validateCronExpression(): void;
     /**
      * Verifica se o agendamento é recorrente (baseado em expressão cron).
      * @returns true se o agendamento é recorrente, false se é um datetime fixo
@@ -15,39 +18,10 @@ export declare class ScheduleEdge {
      */
     isRecurrent(): boolean;
     /**
-     * Verifica se o agendamento é um evento único (baseado em DatetimeEdge).
+     * Verifica se o agendamento é um evento único (baseado no momento de expiracao).
      * @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
@@ -112,29 +86,33 @@ export declare class ScheduleEdge {
      */
     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 * * *")
+     * Retorna os campos da expressão cron.
      */
-    getMoment(): CronExpressionEdge | DatetimeEdge;
+    getFields(): string[];
     /**
-     * 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)
+     * Retorna a próxima execução a partir de uma data base.
+     */
+    nextDate(fromDate?: Date): Date;
+    /**
+     * Retorna a execução anterior a partir de uma data base.
      */
-    getDatetime(): Return<DatetimeEdge, FailureAbstract>;
+    previousDate(fromDate?: Date): Date;
+    /**
+     * Retorna as próximas N execuções.
+     */
+    nextDates(count: number, fromDate?: Date): Date[];
+    /**
+     * Valida expressão cron sem lançar exceção.
+     */
+    static isValid(expression: string): boolean;
     /**
      * 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)
+     * new ScheduleEdge(cron).getCronExpression() // CronExpressionEdge("0 8 * * *")
      */
-    getCronExpression(): Return<CronExpressionEdge, FailureAbstract>;
+    getCronExpression(): string;
     /**
      * Cria uma cópia independente desta instância de ScheduleEdge.
      * @returns Nova instância com o mesmo momento interno
@@ -142,43 +120,16 @@ export declare class ScheduleEdge {
      * 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;
+    clone(): SchedulingEdge;
     /**
-     * Cria um ScheduleEdge de evento único a partir de um objeto Date.
-     * @param date - Data e hora do evento único
+     * Cria um ScheduleEdge de evento único a partir de um objeto Datetime.
+     * @param datetime - 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"))
+     * ScheduleEdge.fromDatetime(new Datetime("2026-12-25T08:00:00"))
      * // agendamento para o Natal de 2026 às 8h
      */
-    static fromDate(date: Date): ScheduleEdge;
+    static fromDatetime(datetime: DatetimeEdge): SchedulingEdge;
     /**
      * Cria um ScheduleEdge para agendamentos diários em um horário específico.
      * @param time - Horário do agendamento no formato TimeEdge
@@ -186,7 +137,7 @@ export declare class ScheduleEdge {
      * @example
      * ScheduleEdge.daily(new TimeEdge("08:00")) // todos os dias às 8h -> "0 8 * * *"
      */
-    static daily(time: TimeEdge): ScheduleEdge;
+    static daily(time: TimeEdge): SchedulingEdge;
     /**
      * 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)
@@ -196,7 +147,7 @@ export declare class ScheduleEdge {
      * ScheduleEdge.weekly(1, new TimeEdge("08:00"))
      * // toda segunda-feira às 8h -> "0 8 * * 1"
      */
-    static weekly(dayOfWeek: number, time: TimeEdge): ScheduleEdge;
+    static weekly(dayOfWeek: number, time: TimeEdge): SchedulingEdge;
     /**
      * Cria um ScheduleEdge para agendamentos mensais em um dia e horário específico.
      * @param dayOfMonth - Dia do mês (1-31)
@@ -206,5 +157,5 @@ export declare class ScheduleEdge {
      * 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;
+    static monthly(dayOfMonth: number, time: TimeEdge): SchedulingEdge;
 }

package/objects/{schedule/schedule.edge.failure.d.ts → scheduling/scheduling.edge.failure.d.ts}

@@ -1,4 +1,4 @@
 import { FailureAbstract } from "../failure/edges/failure.abstract";
-export declare class RecurringScheduleEdgeFailure extends FailureAbstract {
+export declare class RecurringSchedulingEdgeFailure extends FailureAbstract {
     constructor(schedule: string, error?: any);
 }

package/objects/{schedule/schedule.edge.failure.js → scheduling/scheduling.edge.failure.js}

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RecurringScheduleEdgeFailure = void 0;
+exports.RecurringSchedulingEdgeFailure = void 0;
 const failure_abstract_1 = require("../failure/edges/failure.abstract");
-class RecurringScheduleEdgeFailure extends failure_abstract_1.FailureAbstract {
+class RecurringSchedulingEdgeFailure extends failure_abstract_1.FailureAbstract {
     constructor(schedule, error) {
         super({
-            failureClass: RecurringScheduleEdgeFailure,
+            failureClass: RecurringSchedulingEdgeFailure,
             message: `${schedule} is not a recurring schedule`,
             stackTrace: error,
         });
     }
 }
-exports.RecurringScheduleEdgeFailure = RecurringScheduleEdgeFailure;
+exports.RecurringSchedulingEdgeFailure = RecurringSchedulingEdgeFailure;

package/objects/{schedule/schedule.edge.js → scheduling/scheduling.edge.js}

@@ -1,15 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ScheduleEdge = void 0;
+exports.SchedulingEdge = void 0;
 const cron_parser_1 = require("cron-parser");
+const optional_type_1 = require("../../@tool-box/utils/ducts/optional-type");
 const return_type_1 = require("../../@tool-box/utils/ducts/return-type");
-const cron_expression_edge_1 = require("../@common/edges/cron-expression.edge");
 const datetime_edge_1 = require("../datetime/edges/datetime.edge");
-const schedule_edge_failure_1 = require("./schedule.edge.failure");
+const string_edge_sketch_1 = require("../primitives/string.edge.sketch");
 const time_edge_1 = require("../time/time.edge");
-class ScheduleEdge {
-    constructor(_moment) {
-        this._moment = _moment;
+class SchedulingEdge extends string_edge_sketch_1.StringEdgeSketch {
+    constructor(_cronExpression) {
+        // normaliza espaços múltiplos para evitar inconsistência de validação
+        super(_cronExpression.replace(/\s+/g, " "));
+        this._cronExpression = _cronExpression;
+        this.expiresInPacked = optional_type_1.Nothing;
+        this.validateCronExpression();
+    }
+    validateCronExpression() {
+        try {
+            cron_parser_1.CronExpressionParser.parse(this.toString());
+        }
+        catch {
+            throw new Error(`${this.toString()} should be a valid Cron Expression.`);
+        }
     }
     // ==================== Verificações ====================
     /**
@@ -20,58 +32,14 @@ class ScheduleEdge {
      * new ScheduleEdge(new DatetimeEdge(new Date())).isRecurrent() // false
      */
     isRecurrent() {
-        return this._moment instanceof cron_expression_edge_1.CronExpressionEdge;
+        return this.expiresInPacked.hasSomething();
     }
     /**
-     * Verifica se o agendamento é um evento único (baseado em DatetimeEdge).
+     * Verifica se o agendamento é um evento único (baseado no momento de expiracao).
      * @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() {
-        return this._moment instanceof datetime_edge_1.DatetimeEdge;
-    }
-    /**
-     * 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() {
-        if (this._moment instanceof cron_expression_edge_1.CronExpressionEdge)
-            return false;
-        return this._moment.isBefore(new datetime_edge_1.DatetimeEdge(new Date()));
-    }
-    /**
-     * 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() {
-        if (this._moment instanceof cron_expression_edge_1.CronExpressionEdge)
-            return true;
-        return this._moment.isAfter(new datetime_edge_1.DatetimeEdge(new Date()));
-    }
-    /**
-     * 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() {
-        if (this._moment instanceof datetime_edge_1.DatetimeEdge) {
-            return this._moment.isToday();
-        }
-        const next = cron_parser_1.CronExpressionParser.parse(this._moment.toString()).next();
-        const nextDatetime = new datetime_edge_1.DatetimeEdge(next.toDate());
-        return nextDatetime.isToday();
+        return this.expiresInPacked.hasNothing();
     }
     // ==================== Ocorrências ====================
     /**
@@ -82,10 +50,7 @@ class ScheduleEdge {
      * schedule.nextOccurrence() // Success(DatetimeEdge com a próxima ocorrência às 8h)
      */
     nextOccurrence() {
-        if (this._moment instanceof datetime_edge_1.DatetimeEdge) {
-            return (0, return_type_1.Failure)(new schedule_edge_failure_1.RecurringScheduleEdgeFailure(this._moment.toISOString()));
-        }
-        const cronDate = cron_parser_1.CronExpressionParser.parse(this._moment.toString()).next();
+        const cronDate = cron_parser_1.CronExpressionParser.parse(this._cronExpression.toString()).next();
         return (0, return_type_1.Success)(new datetime_edge_1.DatetimeEdge(cronDate.toDate()));
     }
     /**
@@ -97,10 +62,7 @@ class ScheduleEdge {
      * schedule.nextOccurrences(3) // Success([DatetimeEdge, DatetimeEdge, DatetimeEdge])
      */
     nextOccurrences(quantity) {
-        if (this._moment instanceof datetime_edge_1.DatetimeEdge) {
-            return (0, return_type_1.Failure)(new schedule_edge_failure_1.RecurringScheduleEdgeFailure(this._moment.toISOString()));
-        }
-        const cronDates = cron_parser_1.CronExpressionParser.parse(this._moment.toString()).take(quantity);
+        const cronDates = cron_parser_1.CronExpressionParser.parse(this._cronExpression.toString()).take(quantity);
         return (0, return_type_1.Success)(cronDates.map((cronDate) => new datetime_edge_1.DatetimeEdge(cronDate.toDate())));
     }
     /**
@@ -111,10 +73,7 @@ class ScheduleEdge {
      * schedule.previousOccurrence() // Success(DatetimeEdge com a última ocorrência às 8h)
      */
     previousOccurrence() {
-        if (this._moment instanceof datetime_edge_1.DatetimeEdge) {
-            return (0, return_type_1.Failure)(new schedule_edge_failure_1.RecurringScheduleEdgeFailure(this._moment.toISOString()));
-        }
-        const cronDate = cron_parser_1.CronExpressionParser.parse(this._moment.toString()).prev();
+        const cronDate = cron_parser_1.CronExpressionParser.parse(this._cronExpression.toString()).prev();
         return (0, return_type_1.Success)(new datetime_edge_1.DatetimeEdge(cronDate.toDate()));
     }
     /**
@@ -126,10 +85,7 @@ class ScheduleEdge {
      * schedule.previousOccurrences(3) // Success([DatetimeEdge, DatetimeEdge, DatetimeEdge])
      */
     previousOccurrences(quantity) {
-        if (this._moment instanceof datetime_edge_1.DatetimeEdge) {
-            return (0, return_type_1.Failure)(new schedule_edge_failure_1.RecurringScheduleEdgeFailure(this._moment.toISOString()));
-        }
-        const cronDates = cron_parser_1.CronExpressionParser.parse(this._moment.toString()).take(-quantity);
+        const cronDates = cron_parser_1.CronExpressionParser.parse(this._cronExpression.toString()).take(-quantity);
         return (0, return_type_1.Success)(cronDates.map((cronDate) => new datetime_edge_1.DatetimeEdge(cronDate.toDate())));
     }
     /**
@@ -143,10 +99,7 @@ class ScheduleEdge {
      * // Success([DatetimeEdge, DatetimeEdge, ...])
      */
     occurrencesBetween(start, end) {
-        if (this._moment instanceof datetime_edge_1.DatetimeEdge) {
-            return (0, return_type_1.Failure)(new schedule_edge_failure_1.RecurringScheduleEdgeFailure(this._moment.toISOString()));
-        }
-        const interval = cron_parser_1.CronExpressionParser.parse(this._moment.toString(), {
+        const interval = cron_parser_1.CronExpressionParser.parse(this._cronExpression.toString(), {
             currentDate: start.toDate(),
             endDate: end.toDate(),
         });
@@ -186,46 +139,73 @@ class ScheduleEdge {
      * // TimeEdge("08:00")
      */
     getTime() {
-        const interval = cron_parser_1.CronExpressionParser.parse(this._moment.toString()).fields;
+        const interval = cron_parser_1.CronExpressionParser.parse(this._cronExpression.toString()).fields;
         const hour = String(interval.hour.values.toString()).padStart(2, "0");
         const minute = String(interval.minute.values.toString()).padStart(2, "0");
         return new time_edge_1.TimeEdge(`${hour}:${minute}`);
     }
     /**
-     * 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 * * *")
+     * Retorna os campos da expressão cron.
      */
-    getMoment() {
-        return this._moment;
+    getFields() {
+        return this.toString().split(/\s+/);
     }
+    // ==================== Cálculo de Execução ====================
     /**
-     * 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)
+     * Retorna a próxima execução a partir de uma data base.
      */
-    getDatetime() {
-        if (this._moment instanceof cron_expression_edge_1.CronExpressionEdge) {
-            return (0, return_type_1.Failure)(new schedule_edge_failure_1.RecurringScheduleEdgeFailure(this._moment.toString()));
+    nextDate(fromDate = new Date()) {
+        const interval = cron_parser_1.CronExpressionParser.parse(this.toString(), {
+            currentDate: fromDate,
+        });
+        return interval.next().toDate();
+    }
+    /**
+     * Retorna a execução anterior a partir de uma data base.
+     */
+    previousDate(fromDate = new Date()) {
+        const interval = cron_parser_1.CronExpressionParser.parse(this.toString(), {
+            currentDate: fromDate,
+        });
+        return interval.prev().toDate();
+    }
+    /**
+     * Retorna as próximas N execuções.
+     */
+    nextDates(count, fromDate = new Date()) {
+        if (count <= 0)
+            return [];
+        const interval = cron_parser_1.CronExpressionParser.parse(this.toString(), {
+            currentDate: fromDate,
+        });
+        const dates = [];
+        for (let i = 0; i < count; i++) {
+            dates.push(interval.next().toDate());
+        }
+        return dates;
+    }
+    // ==================== Métodos Estáticos ====================
+    /**
+     * Valida expressão cron sem lançar exceção.
+     */
+    static isValid(expression) {
+        try {
+            cron_parser_1.CronExpressionParser.parse(expression.trim().replace(/\s+/g, " "));
+            return true;
+        }
+        catch {
+            return false;
         }
-        return (0, return_type_1.Success)(this._moment);
     }
     /**
      * 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)
+     * new ScheduleEdge(cron).getCronExpression() // CronExpressionEdge("0 8 * * *")
      */
     getCronExpression() {
-        if (this._moment instanceof datetime_edge_1.DatetimeEdge) {
-            return (0, return_type_1.Failure)(new schedule_edge_failure_1.RecurringScheduleEdgeFailure(this._moment.toISOString()));
-        }
-        return (0, return_type_1.Success)(this._moment);
+        return this._cronExpression;
     }
     // ==================== Clonagem e Imutabilidade ====================
     /**
@@ -236,53 +216,28 @@ class ScheduleEdge {
      * const clone = schedule.clone(); // instância independente
      */
     clone() {
-        return new ScheduleEdge(this._moment);
-    }
-    /**
-     * 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) {
-        return new ScheduleEdge(moment);
-    }
-    // ==================== Formatação ====================
-    /**
-     * 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() {
-        return this._moment.toString();
+        return new SchedulingEdge(this._cronExpression);
     }
     // ==================== Métodos Estáticos ====================
     /**
-     * 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) {
-        return new ScheduleEdge(new cron_expression_edge_1.CronExpressionEdge(expression));
-    }
-    /**
-     * Cria um ScheduleEdge de evento único a partir de um objeto Date.
-     * @param date - Data e hora do evento único
+     * Cria um ScheduleEdge de evento único a partir de um objeto Datetime.
+     * @param datetime - 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"))
+     * ScheduleEdge.fromDatetime(new Datetime("2026-12-25T08:00:00"))
      * // agendamento para o Natal de 2026 às 8h
      */
-    static fromDate(date) {
-        return new ScheduleEdge(new datetime_edge_1.DatetimeEdge(date));
+    static fromDatetime(datetime) {
+        const date = datetime.toDate();
+        const minute = date.getMinutes();
+        const hour = date.getHours();
+        const day = date.getDate();
+        const month = date.getMonth() + 1;
+        const dayOfWeek = date.getDay();
+        const cron = `${minute} ${hour} ${day} ${month} ${dayOfWeek}`;
+        const scheduledFor = new SchedulingEdge(cron);
+        scheduledFor.expiresInPacked = (0, optional_type_1.Optional)(datetime);
+        return scheduledFor;
     }
     /**
      * Cria um ScheduleEdge para agendamentos diários em um horário específico.
@@ -293,7 +248,7 @@ class ScheduleEdge {
      */
     static daily(time) {
         const expression = `${time.getMinutes()} ${time.getHours()} * * *`;
-        return ScheduleEdge.fromCron(expression);
+        return new SchedulingEdge(expression);
     }
     /**
      * Cria um ScheduleEdge para agendamentos semanais em um dia e horário específico.
@@ -306,7 +261,7 @@ class ScheduleEdge {
      */
     static weekly(dayOfWeek, time) {
         const expression = `${time.getMinutes()} ${time.getHours()} * * ${dayOfWeek}`;
-        return ScheduleEdge.fromCron(expression);
+        return new SchedulingEdge(expression);
     }
     /**
      * Cria um ScheduleEdge para agendamentos mensais em um dia e horário específico.
@@ -319,7 +274,7 @@ class ScheduleEdge {
      */
     static monthly(dayOfMonth, time) {
         const expression = `${time.getMinutes()} ${time.getHours()} ${dayOfMonth} * *`;
-        return ScheduleEdge.fromCron(expression);
+        return new SchedulingEdge(expression);
     }
 }
-exports.ScheduleEdge = ScheduleEdge;
+exports.SchedulingEdge = SchedulingEdge;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlantjs/arch",
-	"version": "14.0.4",
+	"version": "15.0.0",
 	"main": "index.js",
 	"license": "UNLICENSED",
 	"publishConfig": {