alepha 0.7.4 → 0.7.6

package/react.js

@@ -1 +1 @@
-export * from '@alepha/react';
+export * from '@alepha/react'

package/redis.cjs

@@ -1,12 +1,8 @@
 'use strict';
-
-var redis = require('@alepha/redis');
-
-
-
-Object.keys(redis).forEach(function (k) {
+var m = require('@alepha/redis');
+Object.keys(m).forEach(function (k) {
 	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,
-		get: function () { return redis[k]; }
+		get: function () { return m[k]; }
 	});
-});
+});

package/redis.d.ts

@@ -1,144 +1,71 @@
-import * as _alepha_core from '@alepha/core';
-import { Static, Alepha } from '@alepha/core';
-import { RedisClientType, createClient, SetOptions } from '@redis/client';
+import * as _alepha_core7 from "@alepha/core";
+import * as _alepha_core0 from "@alepha/core";
+import { Alepha, Static } from "@alepha/core";
+import { RedisClientType, SetOptions, createClient } from "@redis/client";
+import * as _sinclair_typebox3 from "@sinclair/typebox";
 
-/** Symbol key applied to readonly types */
-declare const ReadonlyKind: unique symbol;
-/** Symbol key applied to optional types */
-declare const OptionalKind: unique symbol;
-/** Symbol key applied to types */
-declare const Hint: unique symbol;
-/** Symbol key applied to types */
-declare const Kind: unique symbol;
-
-type StringFormatOption = 'date-time' | 'time' | 'date' | 'email' | 'idn-email' | 'hostname' | 'idn-hostname' | 'ipv4' | 'ipv6' | 'uri' | 'uri-reference' | 'iri' | 'uuid' | 'iri-reference' | 'uri-template' | 'json-pointer' | 'relative-json-pointer' | 'regex' | ({} & string);
-type StringContentEncodingOption = '7bit' | '8bit' | 'binary' | 'quoted-printable' | 'base64' | ({} & string);
-interface StringOptions extends SchemaOptions {
-    /** The maximum string length */
-    maxLength?: number;
-    /** The minimum string length */
-    minLength?: number;
-    /** A regular expression pattern this string should match */
-    pattern?: string;
-    /** A format this string should match */
-    format?: StringFormatOption;
-    /** The content encoding for this string */
-    contentEncoding?: StringContentEncodingOption;
-    /** The content media type for this string */
-    contentMediaType?: string;
-}
-interface TString extends TSchema, StringOptions {
-    [Kind]: 'String';
-    static: string;
-    type: 'string';
-}
-
-interface NumberOptions extends SchemaOptions {
-    exclusiveMaximum?: number;
-    exclusiveMinimum?: number;
-    maximum?: number;
-    minimum?: number;
-    multipleOf?: number;
-}
-interface TNumber extends TSchema, NumberOptions {
-    [Kind]: 'Number';
-    static: number;
-    type: 'number';
-}
-
-type TOptional<T extends TSchema> = T & {
-    [OptionalKind]: 'Optional';
-};
-
-interface SchemaOptions {
-    $schema?: string;
-    /** Id for this schema */
-    $id?: string;
-    /** Title of this schema */
-    title?: string;
-    /** Description of this schema */
-    description?: string;
-    /** Default value for this schema */
-    default?: any;
-    /** Example values matching this schema */
-    examples?: any;
-    /** Optional annotation for readOnly */
-    readOnly?: boolean;
-    /** Optional annotation for writeOnly */
-    writeOnly?: boolean;
-    [prop: string]: any;
-}
-interface TKind {
-    [Kind]: string;
-}
-interface TSchema extends TKind, SchemaOptions {
-    [ReadonlyKind]?: string;
-    [OptionalKind]?: string;
-    [Hint]?: string;
-    params: unknown[];
-    static: unknown;
-}
-
-declare const envSchema: _alepha_core.TObject<{
-    REDIS_PORT: TNumber;
-    REDIS_HOST: TString;
-    REDIS_PASSWORD: TOptional<TString>;
+//#region src/providers/RedisProvider.d.ts
+declare const envSchema: _alepha_core7.TObject<{
+  REDIS_PORT: _sinclair_typebox3.TNumber;
+  REDIS_HOST: _sinclair_typebox3.TString;
+  REDIS_PASSWORD: _sinclair_typebox3.TOptional<_sinclair_typebox3.TString>;
 }>;
 declare module "alepha" {
-    interface Env extends Partial<Static<typeof envSchema>> {
-    }
+  interface Env extends Partial<Static<typeof envSchema>> {}
 }
 type RedisClient = RedisClientType<{}, {}, {}, 3, {
-    36: BufferConstructor;
+  36: BufferConstructor;
 }>;
 type RedisClientOptions = Parameters<typeof createClient>[0];
 type RedisSetOptions = SetOptions;
 declare class RedisProvider {
-    protected readonly log: _alepha_core.Logger;
-    protected readonly alepha: Alepha;
-    protected readonly env: {
-        REDIS_PASSWORD?: string | undefined;
-        REDIS_PORT: number;
-        REDIS_HOST: string;
-    };
-    protected readonly client: RedisClient;
-    get publisher(): RedisClient;
-    protected readonly start: _alepha_core.HookDescriptor<"start">;
-    protected readonly stop: _alepha_core.HookDescriptor<"stop">;
-    /**
-     * Connect to the Redis server.
-     */
-    connect(): Promise<void>;
-    /**
-     * Close the connection to the Redis server.
-     */
-    close(): Promise<void>;
-    duplicate(options?: Partial<RedisClientOptions>): RedisClient;
-    get(key: string): Promise<Buffer | undefined>;
-    set(key: string, value: Buffer | string, options?: RedisSetOptions): Promise<Buffer>;
-    has(key: string): Promise<boolean>;
-    keys(pattern: string): Promise<string[]>;
-    del(keys: string[]): Promise<void>;
-    /**
-     * Redis subscriber client factory method.
-     */
-    protected createClient(): RedisClient;
+  protected readonly log: _alepha_core7.Logger;
+  protected readonly alepha: Alepha;
+  protected readonly env: {
+    REDIS_PASSWORD?: string | undefined;
+    REDIS_PORT: number;
+    REDIS_HOST: string;
+  };
+  protected readonly client: RedisClient;
+  get publisher(): RedisClient;
+  protected readonly start: _alepha_core7.HookDescriptor<"start">;
+  protected readonly stop: _alepha_core7.HookDescriptor<"stop">;
+  /**
+   * Connect to the Redis server.
+   */
+  connect(): Promise<void>;
+  /**
+   * Close the connection to the Redis server.
+   */
+  close(): Promise<void>;
+  duplicate(options?: Partial<RedisClientOptions>): RedisClient;
+  get(key: string): Promise<Buffer | undefined>;
+  set(key: string, value: Buffer | string, options?: RedisSetOptions): Promise<Buffer>;
+  has(key: string): Promise<boolean>;
+  keys(pattern: string): Promise<string[]>;
+  del(keys: string[]): Promise<void>;
+  /**
+   * Redis subscriber client factory method.
+   */
+  protected createClient(): RedisClient;
 }
-
+//#endregion
+//#region src/providers/RedisSubscriberProvider.d.ts
 declare class RedisSubscriberProvider {
-    protected readonly log: _alepha_core.Logger;
-    protected readonly alepha: Alepha;
-    protected readonly redisProvider: RedisProvider;
-    protected readonly client: RedisClient;
-    get subscriber(): RedisClient;
-    protected readonly start: _alepha_core.HookDescriptor<"start">;
-    protected readonly stop: _alepha_core.HookDescriptor<"stop">;
-    connect(): Promise<void>;
-    close(): Promise<void>;
-    /**
-     * Redis subscriber client factory method.
-     */
-    protected createClient(): RedisClient;
+  protected readonly log: _alepha_core0.Logger;
+  protected readonly alepha: Alepha;
+  protected readonly redisProvider: RedisProvider;
+  protected readonly client: RedisClient;
+  get subscriber(): RedisClient;
+  protected readonly start: _alepha_core0.HookDescriptor<"start">;
+  protected readonly stop: _alepha_core0.HookDescriptor<"stop">;
+  connect(): Promise<void>;
+  close(): Promise<void>;
+  /**
+   * Redis subscriber client factory method.
+   */
+  protected createClient(): RedisClient;
 }
-
-export { type RedisClient, type RedisClientOptions, RedisProvider, type RedisSetOptions, RedisSubscriberProvider };
+//#endregion
+export { RedisClient, RedisClientOptions, RedisProvider, RedisSetOptions, RedisSubscriberProvider };
+//# sourceMappingURL=index.d.ts.map

package/redis.js

@@ -1 +1 @@
-export * from '@alepha/redis';
+export * from '@alepha/redis'

package/retry.cjs

@@ -1,12 +1,8 @@
 'use strict';
-
-var retry = require('@alepha/retry');
-
-
-
-Object.keys(retry).forEach(function (k) {
+var m = require('@alepha/retry');
+Object.keys(m).forEach(function (k) {
 	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,
-		get: function () { return retry[k]; }
+		get: function () { return m[k]; }
 	});
-});
+});

package/retry.d.ts

@@ -1,4 +1,6 @@
-import { MaybePromise } from '@alepha/core';
+import { MaybePromise } from "@alepha/core";
+
+//#region src/descriptors/$retry.d.ts
 
 /**
  * `$retry` creates a retry descriptor.
@@ -34,35 +36,36 @@ declare const $retry: <T extends (...args: any[]) => any>(opts: RetryDescriptorO
  * Retry Descriptor options.
  */
 interface RetryDescriptorOptions<T extends (...args: any[]) => any> {
-    /**
-     * Maximum number of attempts.
-     *
-     * @default 3
-     */
-    max?: number;
-    /**
-     * Delay in milliseconds.
-     *
-     * @default 0
-     */
-    delay?: number;
-    /**
-     * Optional condition to determine when to retry.
-     */
-    when?: (error: Error) => boolean;
-    /**
-     * The function to retry.
-     */
-    handler: T;
-    /**
-     * Optional error handler.
-     *
-     * This will be called when an error occurs.
-     *
-     * @default undefined
-     */
-    onError?: (error: Error, attempt: number, ...parameters: Parameters<T>) => void;
+  /**
+   * Maximum number of attempts.
+   *
+   * @default 3
+   */
+  max?: number;
+  /**
+   * Delay in milliseconds.
+   *
+   * @default 0
+   */
+  delay?: number;
+  /**
+   * Optional condition to determine when to retry.
+   */
+  when?: (error: Error) => boolean;
+  /**
+   * The function to retry.
+   */
+  handler: T;
+  /**
+   * Optional error handler.
+   *
+   * This will be called when an error occurs.
+   *
+   * @default undefined
+   */
+  onError?: (error: Error, attempt: number, ...parameters: Parameters<T>) => void;
 }
 type RetryDescriptor<T extends (...args: any[]) => any> = (...parameters: Parameters<T>) => MaybePromise<ReturnType<T>>;
-
-export { $retry, type RetryDescriptor, type RetryDescriptorOptions };
+//#endregion
+export { $retry, RetryDescriptor, RetryDescriptorOptions };
+//# sourceMappingURL=index.d.ts.map

package/retry.js

@@ -1 +1 @@
-export * from '@alepha/retry';
+export * from '@alepha/retry'

package/scheduler.cjs

@@ -1,12 +1,8 @@
 'use strict';
-
-var scheduler = require('@alepha/scheduler');
-
-
-
-Object.keys(scheduler).forEach(function (k) {
+var m = require('@alepha/scheduler');
+Object.keys(m).forEach(function (k) {
 	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,
-		get: function () { return scheduler[k]; }
+		get: function () { return m[k]; }
 	});
-});
+});

package/scheduler.d.ts

@@ -1,176 +1,148 @@
-import * as _alepha_core from '@alepha/core';
-import { Async, KIND, OPTIONS, Static, Alepha } from '@alepha/core';
-import { DurationLike, DateTimeProvider, Interval } from '@alepha/datetime';
-import * as _alepha_lock from '@alepha/lock';
-import { ScheduledTask } from 'node-cron';
+import * as _alepha_core9 from "@alepha/core";
+import * as _alepha_core2 from "@alepha/core";
+import { Alepha, Async, KIND, OPTIONS, Static } from "@alepha/core";
+import * as _alepha_lock8 from "@alepha/lock";
+import { DateTime, DateTimeProvider, DurationLike, Interval } from "@alepha/datetime";
+import { Cron } from "cron-schedule";
+import * as _sinclair_typebox0 from "@sinclair/typebox";
+import * as dayjs10 from "dayjs";
 
+//#region src/descriptors/$scheduler.d.ts
 declare const KEY = "SCHEDULER";
 /**
  * Scheduler descriptor.
  */
 declare const $scheduler: {
-    (options: SchedulerDescriptorOptions): SchedulerDescriptor;
-    [KIND]: string;
+  (options: SchedulerDescriptorOptions): SchedulerDescriptor;
+  [KIND]: string;
 };
 declare const isScheduler: (value: any) => value is SchedulerDescriptor;
 type SchedulerDescriptorOptions = {
-    /**
-     * Function to run on schedule.
-     */
-    handler: () => Async<void>;
-    /**
-     * Name of the scheduler. Defaults to the function name.
-     */
-    name?: string;
-    /**
-     * Optional description of the scheduler.
-     */
-    description?: string;
-    /**
-     * Cron expression or interval to run the scheduler.
-     */
-    cron?: string;
-    /**
-     * Cron expression or interval to run the scheduler.
-     */
-    interval?: DurationLike;
-    /**
-     * If true, the scheduler will be locked and only one instance will run at a time.
-     * Defaults to true.
-     */
-    lock?: boolean;
+  /**
+   * Function to run on schedule.
+   */
+  handler: (args: SchedulerHandlerArguments) => Async<void>;
+  /**
+   * Name of the scheduler. Defaults to the function name.
+   */
+  name?: string;
+  /**
+   * Optional description of the scheduler.
+   */
+  description?: string;
+  /**
+   * Cron expression or interval to run the scheduler.
+   */
+  cron?: string;
+  /**
+   * Cron expression or interval to run the scheduler.
+   */
+  interval?: DurationLike;
+  /**
+   * If true, the scheduler will be locked and only one instance will run at a time.
+   * You probably need to import {@link AlephaLockRedis} for distributed locking.
+   *
+   * @default true
+   */
+  lock?: boolean;
 };
 interface SchedulerDescriptor {
-    [KIND]: typeof KEY;
-    [OPTIONS]: SchedulerDescriptorOptions;
-    (): Promise<void>;
+  [KIND]: typeof KEY;
+  [OPTIONS]: SchedulerDescriptorOptions;
+  (): Promise<void>;
 }
-
-/** Symbol key applied to readonly types */
-declare const ReadonlyKind: unique symbol;
-/** Symbol key applied to optional types */
-declare const OptionalKind: unique symbol;
-/** Symbol key applied to types */
-declare const Hint: unique symbol;
-/** Symbol key applied to types */
-declare const Kind: unique symbol;
-
-type StringFormatOption = 'date-time' | 'time' | 'date' | 'email' | 'idn-email' | 'hostname' | 'idn-hostname' | 'ipv4' | 'ipv6' | 'uri' | 'uri-reference' | 'iri' | 'uuid' | 'iri-reference' | 'uri-template' | 'json-pointer' | 'relative-json-pointer' | 'regex' | ({} & string);
-type StringContentEncodingOption = '7bit' | '8bit' | 'binary' | 'quoted-printable' | 'base64' | ({} & string);
-interface StringOptions extends SchemaOptions {
-    /** The maximum string length */
-    maxLength?: number;
-    /** The minimum string length */
-    minLength?: number;
-    /** A regular expression pattern this string should match */
-    pattern?: string;
-    /** A format this string should match */
-    format?: StringFormatOption;
-    /** The content encoding for this string */
-    contentEncoding?: StringContentEncodingOption;
-    /** The content media type for this string */
-    contentMediaType?: string;
-}
-interface TString extends TSchema, StringOptions {
-    [Kind]: 'String';
-    static: string;
-    type: 'string';
-}
-
-type TOptional<T extends TSchema> = T & {
-    [OptionalKind]: 'Optional';
-};
-
-interface SchemaOptions {
-    $schema?: string;
-    /** Id for this schema */
-    $id?: string;
-    /** Title of this schema */
-    title?: string;
-    /** Description of this schema */
-    description?: string;
-    /** Default value for this schema */
-    default?: any;
-    /** Example values matching this schema */
-    examples?: any;
-    /** Optional annotation for readOnly */
-    readOnly?: boolean;
-    /** Optional annotation for writeOnly */
-    writeOnly?: boolean;
-    [prop: string]: any;
+interface SchedulerHandlerArguments {
+  now: DateTime;
 }
-interface TKind {
-    [Kind]: string;
+//#endregion
+//#region src/providers/CronScheduler.d.ts
+interface CronJob {
+  handler: (context: {
+    now: DateTime;
+  }) => Promise<void>;
+  cron: Cron;
+  loop: boolean;
+  running?: boolean;
+  onError?: (error: Error) => void;
+  abort: AbortController;
 }
-interface TSchema extends TKind, SchemaOptions {
-    [ReadonlyKind]?: string;
-    [OptionalKind]?: string;
-    [Hint]?: string;
-    params: unknown[];
-    static: unknown;
+declare class CronProvider {
+  protected readonly dt: DateTimeProvider;
+  protected readonly alepha: Alepha;
+  protected readonly log: _alepha_core9.Logger;
+  start(cron: CronJob): void;
+  stop(cron: CronJob): void;
+  create(expression: string, handler: (context: {
+    now: DateTime;
+  }) => Promise<void>): CronJob;
+  run(task: CronJob, now?: dayjs10.Dayjs): void;
 }
-
-declare const envSchema: _alepha_core.TObject<{
-    SCHEDULER_PREFIX: TOptional<TString>;
+//#endregion
+//#region src/providers/SchedulerDescriptorProvider.d.ts
+declare const envSchema: _alepha_core2.TObject<{
+  SCHEDULER_PREFIX: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
 }>;
 declare module "alepha" {
-    interface Env extends Partial<Static<typeof envSchema>> {
-    }
+  interface Env extends Partial<Static<typeof envSchema>> {}
 }
 declare class SchedulerDescriptorProvider {
-    protected readonly log: _alepha_core.Logger;
-    protected readonly env: {
-        SCHEDULER_PREFIX?: string | undefined;
-    };
-    protected readonly alepha: Alepha;
-    protected readonly dateTimeProvider: DateTimeProvider;
-    protected readonly schedulers: Scheduler[];
-    protected readonly configure: _alepha_core.HookDescriptor<"configure">;
-    protected readonly start: _alepha_core.HookDescriptor<"start">;
-    protected readonly stop: _alepha_core.HookDescriptor<"stop">;
-    /**
-     * Get the schedulers.
-     */
-    getSchedulers(): Scheduler[];
-    /**
-     * Process scheduler descriptors.
-     *
-     * @protected
-     */
-    protected processSchedulerDescriptors(): void;
-    /**
-     * Create a scheduler.
-     *
-     * @param options - The scheduler options.
-     * @param instance - The instance of the scheduler.
-     * @param key - Property key name.
-     * @protected
-     */
-    protected createScheduler(options: SchedulerDescriptorOptions, instance: any, key: string): Scheduler;
-    trigger(name: string): Promise<void>;
-    protected runLock: _alepha_lock.LockDescriptor<(options: SchedulerDescriptorOptions & {
-        name: string;
-    }) => Promise<void>>;
-    protected run(options: SchedulerDescriptorOptions): Promise<void>;
-    /**
-     * Prefix the scheduler key.
-     */
-    protected prefix(key: string): string;
-    /**
-     *
-     * @param options
-     * @protected
-     */
-    protected getLockGracePeriod(options: SchedulerDescriptorOptions): number;
+  protected readonly log: _alepha_core2.Logger;
+  protected readonly env: {
+    SCHEDULER_PREFIX?: string | undefined;
+  };
+  protected readonly alepha: Alepha;
+  protected readonly dateTimeProvider: DateTimeProvider;
+  protected readonly cronProvider: CronProvider;
+  protected readonly schedulers: Scheduler[];
+  protected readonly configure: _alepha_core2.HookDescriptor<"configure">;
+  protected readonly start: _alepha_core2.HookDescriptor<"start">;
+  protected readonly stop: _alepha_core2.HookDescriptor<"stop">;
+  protected createContextId(): string;
+  /**
+   * Get the schedulers.
+   */
+  getSchedulers(): Scheduler[];
+  /**
+   * Process scheduler descriptors.
+   *
+   * @protected
+   */
+  protected processSchedulerDescriptors(): void;
+  /**
+   * Create a scheduler.
+   *
+   * @param options - The scheduler options.
+   * @param instance - The instance of the scheduler.
+   * @param key - Property key name.
+   * @protected
+   */
+  protected createScheduler(options: SchedulerDescriptorOptions, instance: any, key: string): Scheduler;
+  protected createHandler(name: string, options: SchedulerDescriptorOptions): (args: SchedulerHandlerArguments) => Promise<void>;
+  trigger(name: string): Promise<void>;
+  protected runLock: _alepha_lock8.LockDescriptor<(options: SchedulerDescriptorOptions & {
+    name: string;
+    args: SchedulerHandlerArguments;
+  }) => Promise<void>>;
+  /**
+   * Prefix the scheduler key.
+   */
+  protected prefix(key: string): string;
+  /**
+   *
+   * @param options
+   * @protected
+   */
+  protected getLockGracePeriod(options: SchedulerDescriptorOptions): number;
 }
 interface Scheduler {
-    name: string;
-    options: SchedulerDescriptorOptions;
-    trigger: () => Promise<void>;
-    cron?: ScheduledTask;
-    interval?: Interval;
+  name: string;
+  options: SchedulerDescriptorOptions;
+  trigger: (args: SchedulerHandlerArguments) => Promise<void>;
+  cron?: CronJob;
+  interval?: Interval;
 }
-
+//#endregion
+//#region src/index.d.ts
 /**
  * Alepha Scheduler Module
  *
@@ -180,8 +152,9 @@ interface Scheduler {
  * @module alepha.scheduler
  */
 declare class AlephaScheduler {
-    readonly name = "alepha.scheduler";
-    readonly $services: (alepha: Alepha) => Alepha;
+  readonly name = "alepha.scheduler";
+  readonly $services: (alepha: Alepha) => Alepha;
 }
-
-export { $scheduler, AlephaScheduler, type Scheduler, type SchedulerDescriptor, type SchedulerDescriptorOptions, SchedulerDescriptorProvider, isScheduler };
+//#endregion
+export { $scheduler, AlephaScheduler, Scheduler, SchedulerDescriptor, SchedulerDescriptorOptions, SchedulerDescriptorProvider, SchedulerHandlerArguments, isScheduler };
+//# sourceMappingURL=index.d.ts.map

package/scheduler.js

@@ -1 +1 @@
-export * from '@alepha/scheduler';
+export * from '@alepha/scheduler'