@sohanemon/utils 5.1.5 → 5.1.7

package/dist/functions/index.d.ts

@@ -1,5 +1,6 @@
 export * from './cookie';
 export * from './object';
-export * from './shield';
 export * from './poll';
+export * from './schedule';
+export * from './shield';
 export * from './utils';

package/dist/functions/index.js

@@ -1,5 +1,6 @@
 export * from './cookie';
 export * from './object';
-export * from './shield';
 export * from './poll';
+export * from './schedule';
+export * from './shield';
 export * from './utils';

package/dist/functions/schedule.d.ts

@@ -0,0 +1,11 @@
+type Task = () => Promise<void> | void;
+interface ScheduleOpts {
+    retry?: number;
+    delay?: number;
+}
+/**
+ * Runs a function asynchronously in the background.
+ * Returns immediately, retries on failure if configured.
+ */
+export declare function schedule(task: Task, options?: ScheduleOpts): void;
+export {};

package/dist/functions/schedule.js

@@ -0,0 +1,21 @@
+/**
+ * Runs a function asynchronously in the background.
+ * Returns immediately, retries on failure if configured.
+ */
+export function schedule(task, options = {}) {
+    const { retry = 0, delay = 0 } = options;
+    const attempt = async (triesLeft) => {
+        try {
+            await task();
+        }
+        catch (err) {
+            console.log('⚡[schedule.ts] err:', err);
+            if (triesLeft > 0) {
+                console.log(`⚡[schedule.ts] Retrying in ${delay}ms...`);
+                setTimeout(() => attempt(triesLeft - 1), delay);
+            }
+        }
+    };
+    // Schedule immediately
+    setTimeout(() => attempt(retry), 0);
+}

package/dist/types/gates.d.ts

@@ -3,12 +3,131 @@ export type BUFFER<T> = T;
 export type IMPLIES<T, U> = T extends U ? true : false;
 export type XOR_Binary<T, U> = T | U extends object ? (Without<T, U> & U) | (Without<U, T> & T) : T | U;
 export type XNOR_Binary<T, U> = (T & U) | (Without<T, U> & Without<U, T>);
+/**
+ * Computes a type-level AND (all must true) for a tuple of types.
+ *
+ * Truth table for 3 arguments:
+ *
+ * A  B  C  = AND
+ * 1  1  1  = 1
+ * 1  1  0  = 0
+ * 1  0  1  = 0
+ * 1  0  0  = 0
+ * 0  1  1  = 0
+ * 0  1  0  = 0
+ * 0  0  1  = 0
+ * 0  0  0  = 0
+ *
+ * @template T - Tuple of boolean-like types (1/0)
+ */
 export type AND<T extends any[]> = T extends [infer F, ...infer R] ? R extends any[] ? F & AND<R> : F : unknown;
+/**
+ * Computes a type-level OR (At least one) for a tuple of types.
+ *
+ * Truth table for 3 arguments:
+ *
+ * A  B  C  = OR
+ * 1  1  1  = 1
+ * 1  1  0  = 1
+ * 1  0  1  = 1
+ * 1  0  0  = 1
+ * 0  1  1  = 1
+ * 0  1  0  = 1
+ * 0  0  1  = 1
+ * 0  0  0  = 0
+ *
+ * @template T - Tuple of boolean-like types (1/0)
+ */
 export type OR<T extends any[]> = T extends [infer F, ...infer R] ? R extends any[] ? F | OR<R> : F : never;
+/**
+ * Computes a type-level XOR (only one/odd) for a tuple of types.
+ *
+ * Truth table for 3 arguments:
+ *
+ * A  B  C  = XOR
+ * 1  1  1  = 1
+ * 1  1  0  = 0
+ * 1  0  1  = 0
+ * 1  0  0  = 1
+ * 0  1  1  = 0
+ * 0  1  0  = 1
+ * 0  0  1  = 1
+ * 0  0  0  = 0
+ *
+ * @template T - Tuple of boolean-like types (1/0)
+ */
 export type XOR<T extends any[]> = T extends [infer F, ...infer R] ? R extends [infer S, ...infer Rest] ? XOR<[XOR_Binary<F, S>, ...Rest]> : F : never;
+/**
+ * Computes a type-level XNOR (All or None true) for a tuple of types.
+ *
+ * Truth table for 3 arguments:
+ *
+ * A  B  C  = XNOR
+ * 1  1  1  = 0
+ * 1  1  0  = 1
+ * 1  0  1  = 1
+ * 1  0  0  = 0
+ * 0  1  1  = 1
+ * 0  1  0  = 0
+ * 0  0  1  = 0
+ * 0  0  0  = 1
+ *
+ * @template T - Tuple of boolean-like types (1/0)
+ */
 export type XNOR<T extends any[]> = T extends [infer F, ...infer R] ? R extends [infer S, ...infer Rest] ? XNOR<[XNOR_Binary<F, S>, ...Rest]> : F : never;
+/**
+ * Computes a type-level NOT for a tuple of types.
+ *
+ * Truth table for 3 arguments:
+ *
+ * A  B  C  = NOT
+ * 1  1  1  = 0
+ * 1  1  0  = 0
+ * 1  0  1  = 0
+ * 1  0  0  = 0
+ * 0  1  1  = 0
+ * 0  1  0  = 0
+ * 0  0  1  = 0
+ * 0  0  0  = 1
+ *
+ * @template T - Tuple of boolean-like types (1/0)
+ */
 export type NOT<T> = {
     [P in keyof T]?: never;
 };
+/**
+ * Computes a type-level NAND for a tuple of types.
+ *
+ * Truth table for 3 arguments:
+ *
+ * A  B  C  = NAND
+ * 1  1  1  = 0
+ * 1  1  0  = 1
+ * 1  0  1  = 1
+ * 1  0  0  = 1
+ * 0  1  1  = 1
+ * 0  1  0  = 1
+ * 0  0  1  = 1
+ * 0  0  0  = 1
+ *
+ * @template T - Tuple of boolean-like types (1/0)
+ */
 export type NAND<T extends any[]> = NOT<AND<T>>;
+/**
+ * Computes a type-level NOR for a tuple of types.
+ *
+ * Truth table for 3 arguments:
+ *
+ * A  B  C  = NOR
+ * 1  1  1  = 0
+ * 1  1  0  = 0
+ * 1  0  1  = 0
+ * 1  0  0  = 0
+ * 0  1  1  = 0
+ * 0  1  0  = 0
+ * 0  0  1  = 0
+ * 0  0  0  = 1
+ *
+ * @template T - Tuple of boolean-like types (1/0)
+ */
 export type NOR<T extends any[]> = NOT<OR<T>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sohanemon/utils",
-  "version": "5.1.5",
+  "version": "5.1.7",
   "author": "Sohan Emon <sohanemon@outlook.com>",
   "description": "",
   "type": "module",