semola 0.6.0 → 0.6.2

package/dist/lib/cron/index.d.cts

@@ -1,146 +1 @@
-//#region src/lib/cron/builder/types.d.ts
-declare const WeekDay: {
-  readonly sun: 0;
-  readonly mon: 1;
-  readonly tue: 2;
-  readonly wed: 3;
-  readonly thu: 4;
-  readonly fri: 5;
-  readonly sat: 6;
-};
-declare const Month: {
-  readonly jan: 1;
-  readonly feb: 2;
-  readonly mar: 3;
-  readonly apr: 4;
-  readonly may: 5;
-  readonly jun: 6;
-  readonly jul: 7;
-  readonly aug: 8;
-  readonly sep: 9;
-  readonly oct: 10;
-  readonly nov: 11;
-  readonly dec: 12;
-};
-type Enumerate<N extends number, Acc extends number[] = []> = Acc["length"] extends N ? Acc[number] : Enumerate<N, [...Acc, Acc["length"]]>;
-type IntRange<F extends number, T extends number> = Exclude<Enumerate<T>, Enumerate<F>>;
-type TimeType = IntRange<0, 60>;
-type HourType = IntRange<0, 24>;
-type DayType = IntRange<1, 32>;
-type MonthType = IntRange<1, 13>;
-type WeekDayType = IntRange<0, 7>;
-type CronRange<T> = {
-  min: NoInfer<T>;
-  max: NoInfer<T>;
-};
-type CronStep<T> = {
-  step: NoInfer<T>;
-  range?: {
-    min: NoInfer<T>;
-    max?: NoInfer<T>;
-  };
-};
-type CronField = "second" | "minute" | "hour" | "day" | "month" | "weekday";
-type CronListExpr<T> = Exclude<CronExpr<T>, {
-  type: "list";
-}>;
-type CronExpr<T> = {
-  type: "any";
-} | {
-  type: "value";
-  value: T;
-} | {
-  type: "range";
-  min: T;
-  max: T;
-} | {
-  type: "step";
-  step: T;
-  range?: {
-    min: T;
-    max?: T;
-  };
-} | {
-  type: "list";
-  values: CronListExpr<T>[];
-};
-interface IBuilder<Used extends CronField> {
-  second(expr: CronExpr<TimeType>): CronBuilderType<Used | "second">;
-  minute(expr: CronExpr<TimeType>): CronBuilderType<Used | "minute">;
-  hour(expr: CronExpr<HourType>): CronBuilderType<Used | "hour">;
-  day(expr: CronExpr<DayType>): CronBuilderType<Used | "day">;
-  month(expr: CronExpr<MonthType>): CronBuilderType<Used | "month">;
-  weekday(expr: CronExpr<WeekDayType>): CronBuilderType<Used | "weekday">;
-}
-type CronBuilderType<Used extends CronField = never> = Omit<IBuilder<Used>, Used>;
-type BuilderFn = (builder: CronBuilderType) => void;
-//#endregion
-//#region src/lib/cron/builder/index.d.ts
-declare class FieldWrapper<T> {
-  private fields;
-  add(expr: CronListExpr<T>): void;
-  read(): CronListExpr<T>[];
-}
-declare class CronListBuilder<T> {
-  private wrapper;
-  constructor(wrapper: FieldWrapper<T>);
-  any(): CronListBuilder<T>;
-  range(options: CronRange<T>): CronListBuilder<T>;
-  step(options: CronStep<T>): CronListBuilder<T>;
-  number(value: T): CronListBuilder<T>;
-}
-declare function range<T>(options: CronRange<T>): CronExpr<T>;
-declare function any<T>(): CronExpr<T>;
-declare function step<T>(options: CronStep<T>): CronExpr<T>;
-declare function list<T>(builderFn: (builder: CronListBuilder<T>) => CronListBuilder<T>): CronExpr<T>;
-declare function number<T>(value: T): {
-  type: "value";
-  value: T;
-};
-declare function cronJobBuilder(buildFn: BuilderFn): string;
-//#endregion
-//#region src/lib/cron/core/types.d.ts
-type CronAlias = "@yearly" | "@monthly" | "@weekly" | "@daily" | "@hourly" | "@minutely";
-type CronStatus = "idle" | "running" | "paused";
-type CronOptions = {
-  name: string;
-  schedule: CronAlias | (string & {});
-  handler: () => void | Promise<void>;
-};
-//#endregion
-//#region src/lib/cron/core/index.d.ts
-declare class Cron {
-  private options;
-  private status;
-  private timeoutId;
-  private second;
-  private minute;
-  private hour;
-  private day;
-  private month;
-  private dayOfWeek;
-  private hasSeconds;
-  private _dayWildcard;
-  private _dowWildcard;
-  private fillRange;
-  private handleStep;
-  private handleStepRange;
-  private handleStepSingle;
-  private handleRange;
-  private handleNumber;
-  constructor(options: CronOptions);
-  private resolveAlias;
-  private parse;
-  private handleField;
-  matches(date: Date): boolean;
-  getNextRun(): Date | null;
-  start(): void;
-  stop(): void;
-  pause(): void;
-  resume(): void;
-  getStatus(): CronStatus;
-  private next;
-  private run;
-}
-//#endregion
-export { Cron, Month, WeekDay, any, cronJobBuilder, list, number, range, step };
+export type * from './index.d.mts'

package/dist/lib/cron/index.d.mts

@@ -40,7 +40,7 @@ type CronStep<T> = {
     max?: NoInfer<T>;
   };
 };
-type CronField = "second" | "minute" | "hour" | "day" | "month" | "weekday";
+type CronField = "minute" | "hour" | "day" | "month" | "weekday";
 type CronListExpr<T> = Exclude<CronExpr<T>, {
   type: "list";
 }>;
@@ -65,7 +65,6 @@ type CronExpr<T> = {
   values: CronListExpr<T>[];
 };
 interface IBuilder<Used extends CronField> {
-  second(expr: CronExpr<TimeType>): CronBuilderType<Used | "second">;
   minute(expr: CronExpr<TimeType>): CronBuilderType<Used | "minute">;
   hour(expr: CronExpr<HourType>): CronBuilderType<Used | "hour">;
   day(expr: CronExpr<DayType>): CronBuilderType<Used | "day">;
@@ -100,47 +99,111 @@ declare function number<T>(value: T): {
 declare function cronJobBuilder(buildFn: BuilderFn): string;
 //#endregion
 //#region src/lib/cron/core/types.d.ts
-type CronAlias = "@yearly" | "@monthly" | "@weekly" | "@daily" | "@hourly" | "@minutely";
-type CronStatus = "idle" | "running" | "paused";
-type CronOptions = {
+type MinutelyAlias = "@minutely";
+type ErrorMetadataType = {
   name: string;
-  schedule: CronAlias | (string & {});
-  handler: () => void | Promise<void>;
+  failedAt: number;
+  error: Error;
 };
+type ScheduleType = Bun.CronWithAutocomplete | MinutelyAlias;
+type OnFailedAttemptContextType = {
+  error: Error;
+  attemptNumber: number;
+  retriesLeft: number;
+  delay: number;
+  jobName: string;
+};
+type RetryOnErrorContextType = {
+  error: Error;
+  jobName: string;
+};
+type RetryOptions = {
+  maxAttempts: number;
+  onError?: (error: ErrorMetadataType) => void | Promise<void>;
+  onFailedAttempt?: (ctx: OnFailedAttemptContextType) => void | Promise<void>;
+  retryOnError?: (ctx: RetryOnErrorContextType) => boolean;
+};
+type CronBaseOptions = {
+  name: string;
+  schedule: ScheduleType;
+};
+type CronOptions = CronBaseOptions & {
+  handler: () => unknown;
+  retry?: RetryObserver;
+};
+type CronOSOptions = CronBaseOptions & {
+  path: string;
+};
+type CronStatus = "idle" | "running";
+declare abstract class JobWithRetry {
+  protected constructor();
+  abstract run(): void;
+  abstract stop(): void;
+}
+type NotifyErrorContext = {
+  type: "error";
+  job: JobWithRetry;
+  error: Error;
+  name: string;
+};
+type NotifyAddRetryContext = {
+  type: "add";
+  name: string;
+};
+type NotifySuccessContext = {
+  type: "success";
+  name: string;
+};
+type NotifyContext = NotifySuccessContext | NotifyErrorContext | NotifyAddRetryContext;
+interface RetryObserver {
+  update(ctx: NotifyContext): Promise<void>;
+}
 //#endregion
 //#region src/lib/cron/core/index.d.ts
-declare class Cron {
+declare class RetryCronJob implements RetryObserver {
+  private options;
+  private jobs;
+  constructor(options: RetryOptions);
+  update(ctx: NotifyContext): Promise<void>;
+  private checkAttempts;
+  private runOnRetryError;
+  private runDelay;
+  private calculateDelay;
+}
+declare class Cron extends JobWithRetry {
   private options;
   private status;
-  private timeoutId;
-  private second;
-  private minute;
-  private hour;
-  private day;
-  private month;
-  private dayOfWeek;
-  private hasSeconds;
-  private _dayWildcard;
-  private _dowWildcard;
-  private fillRange;
-  private handleStep;
-  private handleStepRange;
-  private handleStepSingle;
-  private handleRange;
-  private handleNumber;
+  private cron;
+  private manager?;
+  private common;
   constructor(options: CronOptions);
-  private resolveAlias;
-  private parse;
-  private handleField;
-  matches(date: Date): boolean;
-  getNextRun(): Date | null;
-  start(): void;
-  stop(): void;
-  pause(): void;
-  resume(): void;
+  [Symbol.dispose](): void;
   getStatus(): CronStatus;
-  private next;
-  private run;
+  run(): void;
+  stop(): void;
+  ref(): void;
+  unref(): void;
+  getExpression(): string;
+  getJobName(): string;
+  next(from?: Date | number): Date | null;
+}
+declare class CronOS {
+  private options;
+  private common;
+  constructor(options: CronOSOptions);
+  run(): Promise<void>;
+  stop(): Promise<void>;
+  getExpression(): string;
+  getJobName(): string;
+  next(from?: Date | number): Date | null;
+}
+//#endregion
+//#region src/lib/cron/errors.d.ts
+declare class OutOfBoundError extends Error {
+  constructor(message: string);
+}
+declare class InvalidRetryError extends TypeError {
+  constructor(message: string);
 }
 //#endregion
-export { Cron, Month, WeekDay, any, cronJobBuilder, list, number, range, step };
+export { Cron, CronOS, InvalidRetryError, Month, OutOfBoundError, RetryCronJob, WeekDay, any, cronJobBuilder, list, number, range, step };