@adaas/a-utils 0.2.8 → 0.2.9

package/dist/browser/a-polyfill.d.mts

@@ -0,0 +1,275 @@
+import { A_Component } from '@adaas/a-concept';
+import { A as A_Logger } from './A-Logger.component-Be-LMV3I.mjs';
+import './a-execution.mjs';
+
+interface Ifspolyfill {
+    readFileSync: (path: string, encoding: string) => string;
+    existsSync: (path: string) => boolean;
+    createReadStream: (path: string, options?: BufferEncoding) => any;
+}
+interface IcryptoInterface {
+    createTextHash(text: string, algorithm: string): Promise<string>;
+    createFileHash(filePath: string, algorithm: string): Promise<string>;
+}
+interface IhttpInterface {
+    request: (options: any, callback?: (res: any) => void) => any;
+    get: (url: string | any, callback?: (res: any) => void) => any;
+    createServer: (requestListener?: (req: any, res: any) => void) => any;
+}
+interface IhttpsInterface {
+    request: (options: any, callback?: (res: any) => void) => any;
+    get: (url: string | any, callback?: (res: any) => void) => any;
+    createServer: (options: any, requestListener?: (req: any, res: any) => void) => any;
+}
+interface IpathInterface {
+    join: (...paths: string[]) => string;
+    resolve: (...paths: string[]) => string;
+    dirname: (path: string) => string;
+    basename: (path: string, ext?: string) => string;
+    extname: (path: string) => string;
+    relative: (from: string, to: string) => string;
+    normalize: (path: string) => string;
+    isAbsolute: (path: string) => boolean;
+    parse: (path: string) => any;
+    format: (pathObject: any) => string;
+    sep: string;
+    delimiter: string;
+}
+interface IurlInterface {
+    parse: (urlString: string) => any;
+    format: (urlObject: any) => string;
+    resolve: (from: string, to: string) => string;
+    URL: typeof URL;
+    URLSearchParams: typeof URLSearchParams;
+}
+interface IbufferInterface {
+    from: (data: any, encoding?: string) => any;
+    alloc: (size: number, fill?: any) => any;
+    allocUnsafe: (size: number) => any;
+    isBuffer: (obj: any) => boolean;
+    concat: (list: any[], totalLength?: number) => any;
+}
+interface IprocessInterface {
+    env: Record<string, string | undefined>;
+    argv: string[];
+    platform: string;
+    version: string;
+    versions: Record<string, string>;
+    cwd: () => string;
+    exit: (code?: number) => never;
+    nextTick: (callback: Function, ...args: any[]) => void;
+}
+
+declare abstract class A_FSPolyfillBase {
+    protected logger: A_Logger;
+    protected _fs: Ifspolyfill;
+    protected _initialized: boolean;
+    constructor(logger: A_Logger);
+    get isInitialized(): boolean;
+    get(): Promise<Ifspolyfill>;
+    protected init(): Promise<void>;
+    protected abstract initImplementation(): Promise<void>;
+}
+
+declare class A_FSPolyfill extends A_FSPolyfillBase {
+    constructor(logger: A_Logger);
+    protected initImplementation(): Promise<void>;
+}
+
+declare abstract class A_CryptoPolyfillBase {
+    protected logger: A_Logger;
+    protected _crypto: IcryptoInterface;
+    protected _initialized: boolean;
+    protected _fsPolyfill?: Ifspolyfill;
+    constructor(logger: A_Logger);
+    get isInitialized(): boolean;
+    get(fsPolyfill?: Ifspolyfill): Promise<IcryptoInterface>;
+    protected init(): Promise<void>;
+    protected abstract initImplementation(): Promise<void>;
+}
+
+declare class A_CryptoPolyfill extends A_CryptoPolyfillBase {
+    constructor(logger: A_Logger);
+    protected initImplementation(): Promise<void>;
+}
+
+declare abstract class A_HttpPolyfillBase {
+    protected logger: A_Logger;
+    protected _http: IhttpInterface;
+    protected _initialized: boolean;
+    constructor(logger: A_Logger);
+    get isInitialized(): boolean;
+    get(): Promise<IhttpInterface>;
+    protected init(): Promise<void>;
+    protected abstract initImplementation(): Promise<void>;
+}
+
+declare class A_HttpPolyfill extends A_HttpPolyfillBase {
+    constructor(logger: A_Logger);
+    protected initImplementation(): Promise<void>;
+    private createMockRequest;
+}
+
+declare abstract class A_HttpsPolyfillBase {
+    protected logger: A_Logger;
+    protected _https: IhttpsInterface;
+    protected _initialized: boolean;
+    constructor(logger: A_Logger);
+    get isInitialized(): boolean;
+    get(): Promise<IhttpsInterface>;
+    protected init(): Promise<void>;
+    protected abstract initImplementation(): Promise<void>;
+}
+
+declare class A_HttpsPolyfill extends A_HttpsPolyfillBase {
+    constructor(logger: A_Logger);
+    protected initImplementation(): Promise<void>;
+    private createMockRequest;
+}
+
+declare abstract class A_PathPolyfillBase {
+    protected logger: A_Logger;
+    protected _path: IpathInterface;
+    protected _initialized: boolean;
+    constructor(logger: A_Logger);
+    get isInitialized(): boolean;
+    get(): Promise<IpathInterface>;
+    protected init(): Promise<void>;
+    protected abstract initImplementation(): Promise<void>;
+}
+
+declare class A_PathPolyfill extends A_PathPolyfillBase {
+    constructor(logger: A_Logger);
+    protected initImplementation(): Promise<void>;
+}
+
+declare abstract class A_UrlPolyfillBase {
+    protected logger: A_Logger;
+    protected _url: IurlInterface;
+    protected _initialized: boolean;
+    constructor(logger: A_Logger);
+    get isInitialized(): boolean;
+    get(): Promise<IurlInterface>;
+    protected init(): Promise<void>;
+    protected abstract initImplementation(): Promise<void>;
+}
+
+declare class A_UrlPolyfill extends A_UrlPolyfillBase {
+    constructor(logger: A_Logger);
+    protected initImplementation(): Promise<void>;
+}
+
+declare abstract class A_BufferPolyfillBase {
+    protected logger: A_Logger;
+    protected _buffer: IbufferInterface;
+    protected _initialized: boolean;
+    constructor(logger: A_Logger);
+    get isInitialized(): boolean;
+    get(): Promise<IbufferInterface>;
+    protected init(): Promise<void>;
+    protected abstract initImplementation(): Promise<void>;
+}
+
+declare class A_BufferPolyfill extends A_BufferPolyfillBase {
+    constructor(logger: A_Logger);
+    protected initImplementation(): Promise<void>;
+}
+
+declare abstract class A_ProcessPolyfillBase {
+    protected logger: A_Logger;
+    protected _process: IprocessInterface;
+    protected _initialized: boolean;
+    constructor(logger: A_Logger);
+    get isInitialized(): boolean;
+    get(): Promise<IprocessInterface>;
+    protected init(): Promise<void>;
+    protected abstract initImplementation(): Promise<void>;
+}
+
+declare class A_ProcessPolyfill extends A_ProcessPolyfillBase {
+    constructor(logger: A_Logger);
+    protected initImplementation(): Promise<void>;
+}
+
+declare class A_Polyfill extends A_Component {
+    protected logger: A_Logger;
+    protected _fsPolyfill: A_FSPolyfill;
+    protected _cryptoPolyfill: A_CryptoPolyfill;
+    protected _httpPolyfill: A_HttpPolyfill;
+    protected _httpsPolyfill: A_HttpsPolyfill;
+    protected _pathPolyfill: A_PathPolyfill;
+    protected _urlPolyfill: A_UrlPolyfill;
+    protected _bufferPolyfill: A_BufferPolyfill;
+    protected _processPolyfill: A_ProcessPolyfill;
+    protected _initializing: Promise<void> | null;
+    /**
+     * Indicates whether the channel is connected
+     */
+    protected _initialized?: Promise<void>;
+    constructor(logger: A_Logger);
+    /**
+     * Indicates whether the channel is connected
+     */
+    get ready(): Promise<void>;
+    load(): Promise<void>;
+    attachToWindow(): Promise<void>;
+    protected _loadInternal(): Promise<void>;
+    /**
+     * Allows to use the 'fs' polyfill methods regardless of the environment
+     * This method loads the 'fs' polyfill and returns its instance
+     *
+     * @returns
+     */
+    fs(): Promise<Ifspolyfill>;
+    /**
+     * Allows to use the 'crypto' polyfill methods regardless of the environment
+     * This method loads the 'crypto' polyfill and returns its instance
+     *
+     * @returns
+     */
+    crypto(): Promise<IcryptoInterface>;
+    /**
+     * Allows to use the 'http' polyfill methods regardless of the environment
+     * This method loads the 'http' polyfill and returns its instance
+     *
+     * @returns
+     */
+    http(): Promise<IhttpInterface>;
+    /**
+     * Allows to use the 'https' polyfill methods regardless of the environment
+     * This method loads the 'https' polyfill and returns its instance
+     *
+     * @returns
+     */
+    https(): Promise<IhttpsInterface>;
+    /**
+     * Allows to use the 'path' polyfill methods regardless of the environment
+     * This method loads the 'path' polyfill and returns its instance
+     *
+     * @returns
+     */
+    path(): Promise<IpathInterface>;
+    /**
+     * Allows to use the 'url' polyfill methods regardless of the environment
+     * This method loads the 'url' polyfill and returns its instance
+     *
+     * @returns
+     */
+    url(): Promise<IurlInterface>;
+    /**
+     * Allows to use the 'buffer' polyfill methods regardless of the environment
+     * This method loads the 'buffer' polyfill and returns its instance
+     *
+     * @returns
+     */
+    buffer(): Promise<IbufferInterface>;
+    /**
+     * Allows to use the 'process' polyfill methods regardless of the environment
+     * This method loads the 'process' polyfill and returns its instance
+     *
+     * @returns
+     */
+    process(): Promise<IprocessInterface>;
+}
+
+export { A_BufferPolyfill, A_BufferPolyfillBase, A_CryptoPolyfill, A_CryptoPolyfillBase, A_FSPolyfill, A_FSPolyfillBase, A_HttpPolyfillBase, A_HttpsPolyfill, A_HttpsPolyfillBase, A_PathPolyfill, A_PathPolyfillBase, A_Polyfill, A_ProcessPolyfill, A_ProcessPolyfillBase, A_UrlPolyfill, A_UrlPolyfillBase, type IbufferInterface, type IcryptoInterface, type Ifspolyfill, type IhttpInterface, type IhttpsInterface, type IpathInterface, type IprocessInterface, type IurlInterface };

package/dist/browser/a-polyfill.mjs

@@ -0,0 +1,4 @@
+export { A_BufferPolyfill, A_BufferPolyfillBase, A_CryptoPolyfill, A_CryptoPolyfillBase, A_FSPolyfill, A_FSPolyfillBase, A_HttpPolyfillBase, A_HttpsPolyfill, A_HttpsPolyfillBase, A_PathPolyfill, A_PathPolyfillBase, A_Polyfill, A_ProcessPolyfill, A_ProcessPolyfillBase, A_UrlPolyfill, A_UrlPolyfillBase } from './chunk-J6CLHXFQ.mjs';
+import './chunk-EQQGB2QZ.mjs';
+//# sourceMappingURL=a-polyfill.mjs.map
+//# sourceMappingURL=a-polyfill.mjs.map

package/dist/browser/a-polyfill.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"a-polyfill.mjs"}

package/dist/browser/a-route.d.mts

@@ -0,0 +1,25 @@
+import { A_Fragment } from '@adaas/a-concept';
+
+declare class A_Route<_TParams extends Record<string, any> = Record<string, any>, _TQuery extends Record<string, any> = Record<string, any>> extends A_Fragment {
+    url: string;
+    constructor(url: string | RegExp);
+    /**
+     * Returns path only without query and hash
+     */
+    get path(): string;
+    /**
+     * Returns array of parameter names in the route path
+     */
+    get params(): string[];
+    /**
+     * Returns protocol based on URL scheme
+     */
+    get protocol(): string;
+    extractParams(url: string): _TParams;
+    extractQuery(url: string): _TQuery;
+    toString(): string;
+    toRegExp(): RegExp;
+    toAFeatureExtension(extensionScope?: Array<string>): RegExp;
+}
+
+export { A_Route };

package/dist/browser/a-route.mjs

@@ -0,0 +1,98 @@
+import { __decorateClass } from './chunk-EQQGB2QZ.mjs';
+import { A_Fragment } from '@adaas/a-concept';
+import { A_Frame } from '@adaas/a-frame';
+
+var A_Route = class extends A_Fragment {
+  constructor(url) {
+    super();
+    this.url = url instanceof RegExp ? url.source : url;
+  }
+  /**
+   * Returns path only without query and hash
+   */
+  get path() {
+    const p = this.url.split("?")[0].split("#")[0];
+    if (p.includes("://")) {
+      const pathStartIndex = p.indexOf("/", p.indexOf("://") + 3);
+      if (pathStartIndex === -1) {
+        return "/";
+      } else {
+        const path = p.slice(pathStartIndex);
+        return path.endsWith("/") ? path.slice(0, -1) : path;
+      }
+    }
+    return p.endsWith("/") ? p.slice(0, -1) : p;
+  }
+  /**
+   * Returns array of parameter names in the route path
+   */
+  get params() {
+    return this.path.match(/:([^\/]+)/g)?.map((param) => param.slice(1)) || [];
+  }
+  /**
+   * Returns protocol based on URL scheme
+   */
+  get protocol() {
+    switch (true) {
+      case this.url.startsWith("http://"):
+        return "http";
+      case this.url.startsWith("https://"):
+        return "https";
+      case this.url.startsWith("ws://"):
+        return "ws";
+      case this.url.startsWith("wss://"):
+        return "wss";
+      default:
+        return this.url.includes("://") ? this.url.split("://")[0] : "http";
+    }
+  }
+  extractParams(url) {
+    const cleanUrl = url.split("?")[0];
+    const urlSegments = cleanUrl.split("/").filter(Boolean);
+    const maskSegments = this.path.split("/").filter(Boolean);
+    const params = {};
+    for (let i = 0; i < maskSegments.length; i++) {
+      const maskSegment = maskSegments[i];
+      const urlSegment = urlSegments[i];
+      if (maskSegment.startsWith(":")) {
+        const paramName = maskSegment.slice(1);
+        params[paramName] = urlSegment;
+      } else if (maskSegment !== urlSegment) {
+        return {};
+      }
+    }
+    return params;
+  }
+  extractQuery(url) {
+    const query = {};
+    const queryString = url.split("?")[1];
+    if (!queryString) return query;
+    const cleanQuery = queryString.split("#")[0];
+    for (const pair of cleanQuery.split("&")) {
+      if (!pair) continue;
+      const [key, value = ""] = pair.split("=");
+      query[decodeURIComponent(key)] = decodeURIComponent(value);
+    }
+    return query;
+  }
+  toString() {
+    return `${this.path}`;
+  }
+  toRegExp() {
+    return new RegExp(`^${this.path.replace(/\/:([^\/]+)/g, "/([^/]+)")}$`);
+  }
+  toAFeatureExtension(extensionScope = []) {
+    return new RegExp(`^${extensionScope.length ? `(${extensionScope.join("|")})` : ".*"}\\.${this.path.replace(/\/:([^\/]+)/g, "/([^/]+)")}$`);
+  }
+};
+A_Route = __decorateClass([
+  A_Frame.Fragment({
+    namespace: "A-Utils",
+    name: "A-Route",
+    description: "Route fragment that defines URL patterns for routing purposes. It supports dynamic parameters and query extraction, allowing for flexible route definitions. This fragment can be used in routing systems to match incoming URLs against defined routes and extract relevant parameters and query strings."
+  })
+], A_Route);
+
+export { A_Route };
+//# sourceMappingURL=a-route.mjs.map
+//# sourceMappingURL=a-route.mjs.map

package/dist/browser/a-route.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-Route/A-Route.entity.ts"],"names":[],"mappings":"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","file":"a-route.mjs","sourcesContent":["import { A_Fragment } from '@adaas/a-concept';\nimport { A_Frame } from '@adaas/a-frame';\n\n\n\n\n@A_Frame.Fragment({\n    namespace: 'A-Utils',\n    name: 'A-Route',\n    description: 'Route fragment that defines URL patterns for routing purposes. It supports dynamic parameters and query extraction, allowing for flexible route definitions. This fragment can be used in routing systems to match incoming URLs against defined routes and extract relevant parameters and query strings.'\n})\nexport class A_Route<\n    _TParams extends Record<string, any> = Record<string, any>,\n    _TQuery extends Record<string, any> = Record<string, any>\n> extends A_Fragment {\n\n    public url!: string;\n\n\n    constructor(\n        url: string | RegExp,\n    ) {\n        super();\n        this.url = url instanceof RegExp ? url.source : url;\n    }\n\n    /**\n     * Returns path only without query and hash\n     */\n    get path(): string {\n        const p = this.url.split('?')[0].split('#')[0];\n\n\n        //  ensure that last char is not /\n        //  and remove protocol and domain if present\n        if (p.includes('://')) {\n            const pathStartIndex = p.indexOf('/', p.indexOf('://') + 3);\n            if (pathStartIndex === -1) {\n                return '/';\n            } else {\n                const path = p.slice(pathStartIndex);\n                return path.endsWith('/') ? path.slice(0, -1) : path;\n            }\n        }\n        return p.endsWith('/') ? p.slice(0, -1) : p;\n    }\n    /**\n     * Returns array of parameter names in the route path\n     */\n    get params(): string[] {\n        return this.path\n            .match(/:([^\\/]+)/g)\n            ?.map((param) => param.slice(1))\n            || [];\n    }\n\n\n    /**\n     * Returns protocol based on URL scheme\n     */\n    get protocol(): string {\n        switch (true) {\n            case this.url.startsWith('http://'):\n                return 'http';\n            case this.url.startsWith('https://'):\n                return 'https';\n            case this.url.startsWith('ws://'):\n                return 'ws';\n            case this.url.startsWith('wss://'):\n                return 'wss';\n            default:\n                return this.url.includes('://') ? this.url.split('://')[0] : 'http';\n        }\n    }\n\n\n    extractParams(url: string): _TParams {\n        // Remove query string (anything after ?)\n        const cleanUrl = url.split('?')[0];\n\n        const urlSegments = cleanUrl.split('/').filter(Boolean);\n        const maskSegments = this.path.split('/').filter(Boolean);\n\n        const params = {};\n\n        for (let i = 0; i < maskSegments.length; i++) {\n\n            const maskSegment = maskSegments[i];\n            const urlSegment = urlSegments[i];\n\n            if (maskSegment.startsWith(':')) {\n                const paramName = maskSegment.slice(1); // Remove ':' from mask\n                params[paramName] = urlSegment;\n            } else if (maskSegment !== urlSegment) {\n                // If static segments don’t match → fail\n                return {} as _TParams;\n            }\n        }\n\n        return params as _TParams;\n    }\n\n    extractQuery(url: string): _TQuery {\n        const query: Record<string, string> = {};\n\n        // Take only the part after \"?\"\n        const queryString = url.split('?')[1];\n        if (!queryString) return query as _TQuery;\n\n        // Remove fragment (#...) if present\n        const cleanQuery = queryString.split('#')[0];\n\n        // Split into key=value pairs\n        for (const pair of cleanQuery.split('&')) {\n            if (!pair) continue;\n            const [key, value = ''] = pair.split('=');\n            query[decodeURIComponent(key)] = decodeURIComponent(value);\n        }\n\n        return query as _TQuery;\n    }\n\n\n\n    toString(): string {\n        // path can be like /api/v1/users/:id\n        // and because of that :id we need to replace it with regex that matches chars and numbers only   \n        return `${this.path}`;\n        // .replace(/\\/:([^\\/]+)/g, '\\\\/([^\\/]+)')\n    }\n\n    toRegExp(): RegExp {\n        return new RegExp(`^${this.path.replace(/\\/:([^\\/]+)/g, '/([^/]+)')}$`);\n    }\n\n    toAFeatureExtension(extensionScope: Array<string> = []): RegExp {\n        return new RegExp(`^${extensionScope.length\n            ? `(${extensionScope.join('|')})`\n            : '.*'\n            }\\\\.${this.path.replace(/\\/:([^\\/]+)/g, '/([^/]+)')}$`);\n    }\n}\n\n"]}

package/dist/browser/a-schedule.d.mts

@@ -0,0 +1,111 @@
+import { A_Component } from '@adaas/a-concept';
+
+type A_UTILS_TYPES__ScheduleObjectConfig = {
+    /**
+     * If the timeout is cleared, should the promise resolve or reject?
+     * BY Default it rejects
+     *
+     * !!!NOTE: If the property is set to true, the promise will resolve with undefined
+     */
+    resolveOnClear: boolean;
+};
+type A_UTILS_TYPES__ScheduleObjectCallback<T> = () => Promise<T>;
+
+declare class A_ScheduleObject<T extends any = any> {
+    private timeout;
+    private deferred;
+    private config;
+    /**
+     * Creates a scheduled object that will execute the action after specified milliseconds
+     *
+     *
+     * @param ms - milliseconds to wait before executing the action
+     * @param action - the action to execute
+     * @param config - configuration options for the schedule object
+     */
+    constructor(
+    /**
+     * Milliseconds to wait before executing the action
+     */
+    ms: number, 
+    /**
+     * The action to execute after the specified milliseconds
+     */
+    action: A_UTILS_TYPES__ScheduleObjectCallback<T>, 
+    /**
+     * Configuration options for the schedule object
+     */
+    config?: A_UTILS_TYPES__ScheduleObjectConfig);
+    get promise(): Promise<T>;
+    clear(): void;
+}
+
+declare class A_Schedule extends A_Component {
+    /**
+     * Allows to schedule a callback for particular time in the future
+     *
+     * @param timestamp - Unix timestamp in milliseconds
+     * @param callback - The callback to execute
+     * @returns A promise that resolves to the schedule object
+     */
+    schedule<T extends any = any>(
+    /**
+     * Unix timestamp in milliseconds
+     */
+    timestamp: number, 
+    /**
+     * The callback to execute
+     */
+    callback: A_UTILS_TYPES__ScheduleObjectCallback<T>, 
+    /**
+     * Configuration options for the schedule object
+     */
+    config?: A_UTILS_TYPES__ScheduleObjectConfig): Promise<A_ScheduleObject<T>>;
+    schedule<T extends any = any>(
+    /**
+     * ISO date string representing the date and time to schedule the callback for
+     */
+    date: string, 
+    /**
+     * The callback to execute
+     */
+    callback: A_UTILS_TYPES__ScheduleObjectCallback<T>, 
+    /**
+    * Configuration options for the schedule object
+    */
+    config?: A_UTILS_TYPES__ScheduleObjectConfig): Promise<A_ScheduleObject<T>>;
+    /**
+     * Allows to execute callback after particular delay in milliseconds
+     * So the callback will be executed after the specified delay
+     *
+     * @param ms
+     */
+    delay<T extends any = any>(
+    /**
+     * Delay in milliseconds
+     */
+    ms: number, 
+    /**
+     * The callback to execute after the delay
+     */
+    callback: A_UTILS_TYPES__ScheduleObjectCallback<T>, 
+    /**
+    * Configuration options for the schedule object
+    */
+    config?: A_UTILS_TYPES__ScheduleObjectConfig): Promise<A_ScheduleObject<T>>;
+}
+
+declare class A_Deferred<T> {
+    promise: Promise<T>;
+    private resolveFn;
+    private rejectFn;
+    /**
+     * Creates a deferred promise
+     * @returns A promise that can be resolved or rejected later
+     */
+    constructor();
+    resolve(value: T | PromiseLike<T>): void;
+    reject(reason?: any): void;
+}
+
+export { A_Deferred, A_Schedule, A_ScheduleObject, type A_UTILS_TYPES__ScheduleObjectCallback, type A_UTILS_TYPES__ScheduleObjectConfig };

package/dist/browser/a-schedule.mjs

@@ -0,0 +1,97 @@
+import { __decorateClass } from './chunk-EQQGB2QZ.mjs';
+import { A_Component, A_TypeGuards, A_Error } from '@adaas/a-concept';
+import { A_Frame } from '@adaas/a-frame';
+
+// src/lib/A-Schedule/A-Deferred.class.ts
+var A_Deferred = class {
+  /**
+   * Creates a deferred promise
+   * @returns A promise that can be resolved or rejected later
+   */
+  constructor() {
+    this.promise = new Promise((resolve, reject) => {
+      this.resolveFn = resolve;
+      this.rejectFn = reject;
+    });
+  }
+  resolve(value) {
+    this.resolveFn(value);
+  }
+  reject(reason) {
+    this.rejectFn(reason);
+  }
+};
+var A_ScheduleObject = class {
+  /**
+   * Creates a scheduled object that will execute the action after specified milliseconds
+   * 
+   * 
+   * @param ms - milliseconds to wait before executing the action
+   * @param action - the action to execute
+   * @param config - configuration options for the schedule object
+   */
+  constructor(ms, action, config) {
+    this.config = {
+      /**
+       * If the timeout is cleared, should the promise resolve or reject?
+       * BY Default it rejects
+       * 
+       * !!!NOTE: If the property is set to true, the promise will resolve with undefined
+       */
+      resolveOnClear: false
+    };
+    if (config)
+      this.config = { ...this.config, ...config };
+    this.deferred = new A_Deferred();
+    this.timeout = setTimeout(
+      () => action().then((...args) => this.deferred.resolve(...args)).catch((...args) => this.deferred.reject(...args)),
+      ms
+    );
+  }
+  get promise() {
+    return this.deferred.promise;
+  }
+  clear() {
+    if (this.timeout) {
+      clearTimeout(this.timeout);
+      if (this.config.resolveOnClear)
+        this.deferred.resolve(void 0);
+      else
+        this.deferred.reject(new A_Error("Timeout Cleared"));
+    }
+  }
+};
+var A_Schedule = class extends A_Component {
+  async schedule(date, callback, config) {
+    const timestamp = A_TypeGuards.isString(date) ? new Date(date).getTime() : date;
+    return new A_ScheduleObject(
+      timestamp - Date.now(),
+      callback,
+      config
+    );
+  }
+  /**
+   * Allows to execute callback after particular delay in milliseconds
+   * So the callback will be executed after the specified delay
+   * 
+   * @param ms 
+   */
+  async delay(ms, callback, config) {
+    return new A_ScheduleObject(
+      ms,
+      callback,
+      config
+    );
+  }
+};
+A_Schedule = __decorateClass([
+  A_Frame.Component({
+    namespace: "A-Utils",
+    name: "A-Schedule",
+    description: "Scheduling component that allows scheduling of callbacks to be executed at specific times or after certain delays. It provides methods to schedule callbacks based on Unix timestamps or ISO date strings, as well as a method to execute callbacks after a specified delay in milliseconds. This component is useful for managing timed operations within an application."
+  })
+], A_Schedule);
+
+export { A_Deferred, A_Schedule, A_ScheduleObject };
+//# sourceMappingURL=a-schedule.mjs.map
+//# sourceMappingURL=a-schedule.mjs.map

package/dist/browser/a-schedule.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-Schedule/A-Deferred.class.ts","../../src/lib/A-Schedule/A-ScheduleObject.class.ts","../../src/lib/A-Schedule/A-Schedule.component.ts"],"names":[],"mappings":";;;;;AAAO,IAAM,aAAN,MAAoB;AAAA;AAAA;AAAA;AAAA;AAAA,EASvB,WAAA,GAAc;AACV,IAAA,IAAA,CAAK,OAAA,GAAU,IAAI,OAAA,CAAW,CAAC,SAAS,MAAA,KAAW;AAC/C,MAAA,IAAA,CAAK,SAAA,GAAY,OAAA;AACjB,MAAA,IAAA,CAAK,QAAA,GAAW,MAAA;AAAA,IACpB,CAAC,CAAA;AAAA,EACL;AAAA,EAEA,QAAQ,KAAA,EAAiC;AACrC,IAAA,IAAA,CAAK,UAAU,KAAK,CAAA;AAAA,EACxB;AAAA,EAEA,OAAO,MAAA,EAAoB;AACvB,IAAA,IAAA,CAAK,SAAS,MAAM,CAAA;AAAA,EACxB;AACJ;ACnBO,IAAM,mBAAN,MAA4C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwB/C,WAAA,CAII,EAAA,EAIA,MAAA,EAIA,MAAA,EACF;AAhCF,IAAA,IAAA,CAAQ,MAAA,GAA8C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAOlD,cAAA,EAAgB;AAAA,KACpB;AAyBI,IAAA,IAAI,MAAA;AACA,MAAA,IAAA,CAAK,SAAS,EAAE,GAAG,IAAA,CAAK,MAAA,EAAQ,GAAG,MAAA,EAAO;AAE9C,IAAA,IAAA,CAAK,QAAA,GAAW,IAAI,UAAA,EAAc;AAElC,IAAA,IAAA,CAAK,OAAA,GAAU,UAAA;AAAA,MACX,MAAM,QAAO,CACR,IAAA,CAAK,IAAI,IAAA,KAAS,IAAA,CAAK,SAAS,OAAA,CAAQ,GAAG,IAAI,CAAC,CAAA,CAChD,MAAM,CAAA,GAAI,IAAA,KAAS,KAAK,QAAA,CAAS,MAAA,CAAO,GAAG,IAAI,CAAC,CAAA;AAAA,MACrD;AAAA,KACJ;AAAA,EACJ;AAAA,EAEA,IAAI,OAAA,GAAsB;AACtB,IAAA,OAAO,KAAK,QAAA,CAAS,OAAA;AAAA,EACzB;AAAA,EAEA,KAAA,GAAc;AACV,IAAA,IAAI,KAAK,OAAA,EAAS;AACd,MAAA,YAAA,CAAa,KAAK,OAAO,CAAA;AAEzB,MAAA,IAAI,KAAK,MAAA,CAAO,cAAA;AACZ,QAAA,IAAA,CAAK,QAAA,CAAS,QAAQ,MAAc,CAAA;AAAA;AAEpC,QAAA,IAAA,CAAK,QAAA,CAAS,MAAA,CAAO,IAAI,OAAA,CAAQ,iBAAiB,CAAC,CAAA;AAAA,IAC3D;AAAA,EACJ;AACJ;ACxDO,IAAM,UAAA,GAAN,cAAyB,WAAA,CAAY;AAAA,EAqCxC,MAAM,QAAA,CACF,IAAA,EACA,QAAA,EACA,MAAA,EAC4B;AAE5B,IAAA,MAAM,SAAA,GAAY,YAAA,CAAa,QAAA,CAAS,IAAI,CAAA,GACrC,IAAI,IAAA,CAAK,IAAI,CAAA,CAAG,OAAA,EAAQ,GACzB,IAAA;AAEN,IAAA,OAAO,IAAI,gBAAA;AAAA,MACP,SAAA,GAAY,KAAK,GAAA,EAAI;AAAA,MACrB,QAAA;AAAA,MACA;AAAA,KACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,KAAA,CAIF,EAAA,EAIA,QAAA,EAIA,MAAA,EAC4B;AAC5B,IAAA,OAAO,IAAI,gBAAA;AAAA,MACP,EAAA;AAAA,MACA,QAAA;AAAA,MACA;AAAA,KACJ;AAAA,EACJ;AACJ;AAlFa,UAAA,GAAN,eAAA,CAAA;AAAA,EALN,QAAQ,SAAA,CAAU;AAAA,IACf,SAAA,EAAW,SAAA;AAAA,IACX,IAAA,EAAM,YAAA;AAAA,IACN,WAAA,EAAa;AAAA,GAChB;AAAA,CAAA,EACY,UAAA,CAAA","file":"a-schedule.mjs","sourcesContent":["export class A_Deferred<T> {\n    public promise: Promise<T>;\n    private resolveFn!: (value: T | PromiseLike<T>) => void;\n    private rejectFn!: (reason?: any) => void;\n\n    /**\n     * Creates a deferred promise\n     * @returns A promise that can be resolved or rejected later\n     */\n    constructor() {\n        this.promise = new Promise<T>((resolve, reject) => {\n            this.resolveFn = resolve;\n            this.rejectFn = reject;\n        });\n    }\n\n    resolve(value: T | PromiseLike<T>): void {\n        this.resolveFn(value);\n    }\n\n    reject(reason?: any): void {\n        this.rejectFn(reason);\n    }\n}","import { A_Deferred } from \"./A-Deferred.class\";\nimport { A_Error } from \"@adaas/a-concept\";\nimport { A_UTILS_TYPES__ScheduleObjectCallback, A_UTILS_TYPES__ScheduleObjectConfig } from \"./A-Schedule.types\";\n\nexport class A_ScheduleObject<T extends any = any> {\n\n    private timeout!: NodeJS.Timeout;\n    private deferred!: A_Deferred<T>;\n\n    private config: A_UTILS_TYPES__ScheduleObjectConfig = {\n        /**\n         * If the timeout is cleared, should the promise resolve or reject?\n         * BY Default it rejects\n         * \n         * !!!NOTE: If the property is set to true, the promise will resolve with undefined\n         */\n        resolveOnClear: false\n    };\n\n\n    /**\n     * Creates a scheduled object that will execute the action after specified milliseconds\n     * \n     * \n     * @param ms - milliseconds to wait before executing the action\n     * @param action - the action to execute\n     * @param config - configuration options for the schedule object\n     */\n    constructor(\n        /**\n         * Milliseconds to wait before executing the action\n         */\n        ms: number,\n        /**\n         * The action to execute after the specified milliseconds\n         */\n        action: A_UTILS_TYPES__ScheduleObjectCallback<T>,\n        /**\n         * Configuration options for the schedule object\n         */\n        config?: A_UTILS_TYPES__ScheduleObjectConfig\n    ) {\n        if (config)\n            this.config = { ...this.config, ...config };\n\n        this.deferred = new A_Deferred<T>();\n\n        this.timeout = setTimeout(\n            () => action()\n                .then((...args) => this.deferred.resolve(...args))\n                .catch((...args) => this.deferred.reject(...args)),\n            ms\n        );\n    }\n\n    get promise(): Promise<T> {\n        return this.deferred.promise;\n    }\n\n    clear(): void {\n        if (this.timeout) {\n            clearTimeout(this.timeout);\n\n            if (this.config.resolveOnClear)\n                this.deferred.resolve(undefined as T);\n            else\n                this.deferred.reject(new A_Error(\"Timeout Cleared\"));\n        }\n    }\n}\n\n","import { A_Component, A_Fragment, A_TypeGuards } from \"@adaas/a-concept\";\nimport { A_ScheduleObject } from \"./A-ScheduleObject.class\";\nimport { A_UTILS_TYPES__ScheduleObjectCallback, A_UTILS_TYPES__ScheduleObjectConfig } from \"./A-Schedule.types\";\nimport { A_Frame } from \"@adaas/a-frame\";\n\n\n\n\n@A_Frame.Component({\n    namespace: 'A-Utils',\n    name: 'A-Schedule',\n    description: 'Scheduling component that allows scheduling of callbacks to be executed at specific times or after certain delays. It provides methods to schedule callbacks based on Unix timestamps or ISO date strings, as well as a method to execute callbacks after a specified delay in milliseconds. This component is useful for managing timed operations within an application.'\n})\nexport class A_Schedule extends A_Component {\n\n    /**\n     * Allows to schedule a callback for particular time in the future\n     * \n     * @param timestamp - Unix timestamp in milliseconds\n     * @param callback - The callback to execute\n     * @returns A promise that resolves to the schedule object\n     */\n    async schedule<T extends any = any>(\n        /**\n         * Unix timestamp in milliseconds\n         */\n        timestamp: number,\n        /**\n         * The callback to execute\n         */\n        callback: A_UTILS_TYPES__ScheduleObjectCallback<T>,\n        /**\n         * Configuration options for the schedule object\n         */\n        config?: A_UTILS_TYPES__ScheduleObjectConfig\n    ): Promise<A_ScheduleObject<T>>\n    async schedule<T extends any = any>(\n        /**\n         * ISO date string representing the date and time to schedule the callback for\n         */\n        date: string,\n        /**\n         * The callback to execute\n         */\n        callback: A_UTILS_TYPES__ScheduleObjectCallback<T>,\n        /**\n        * Configuration options for the schedule object\n        */\n        config?: A_UTILS_TYPES__ScheduleObjectConfig\n    ): Promise<A_ScheduleObject<T>>\n    async schedule<T extends any = any>(\n        date: string | number,\n        callback: A_UTILS_TYPES__ScheduleObjectCallback<T>,\n        config?: A_UTILS_TYPES__ScheduleObjectConfig\n    ): Promise<A_ScheduleObject<T>> {\n\n        const timestamp = A_TypeGuards.isString(date)\n            ? (new Date(date)).getTime()\n            : date;\n\n        return new A_ScheduleObject<T>(\n            timestamp - Date.now(),\n            callback,\n            config\n        );\n    }\n\n\n\n    /**\n     * Allows to execute callback after particular delay in milliseconds\n     * So the callback will be executed after the specified delay\n     * \n     * @param ms \n     */\n    async delay<T extends any = any>(\n        /**\n         * Delay in milliseconds\n         */\n        ms: number,\n        /**\n         * The callback to execute after the delay\n         */\n        callback: A_UTILS_TYPES__ScheduleObjectCallback<T>,\n        /**\n        * Configuration options for the schedule object\n        */\n        config?: A_UTILS_TYPES__ScheduleObjectConfig\n    ): Promise<A_ScheduleObject<T>> {\n        return new A_ScheduleObject<T>(\n            ms,\n            callback,\n            config\n        );\n    }\n}"]}