@superutils/core 1.0.6 → 1.0.7

package/README.md

@@ -15,7 +15,7 @@ For full API reference check out the [docs page](https://alien45.github.io/super
     - [`is`](#is): Type checkers
     - [`deferred()`](#deferred): Debounce callbacks
     - [`throttle()`](#throttle): Throttle callbacks
-    - [`fallbackIfFails()`](#fallback-if-fails): Gracefully invoke functions
+    - [`fallbackIfFails()`](#fallback-if-fails): Gracefully invoke functions or promises with a fallback
     - [`objCopy()`](#obj-copy): Deep-copy objects
     - [`search()`](#search): Search iterable collections
 
@@ -110,9 +110,9 @@ handleChange({ target: { value 3 } }) // will be ignored
 
 <div id="fallback-if-fails"></div>
 
-### `fallbackIfFails(fn, args, fallback)`: gracefully invoke functions
+### `fallbackIfFails(target, args, fallback)`: Gracefully invoke functions or promises with a fallback
 
-Based on the function provided `fallbackIfFails` will either execute synchronously or asynchronously.
+The `fallbackIfFails` function can wrap a standard function, a promise-returning function, or a promise directly. It automatically handles both synchronous execution and asynchronous resolution, providing a fallback value if the function throws an error or the promise is rejected.
 
 #### Sync operations:
 
@@ -149,6 +149,13 @@ fallbackIfFails(
 	{ products: [] }, // Fallback value to be returned when function throws an error.
 ).then(console.log)
 // Prints the result when request is successful or fallback value when request fails
+
+
+// use a promise
+fallbackIfFails(
+	Promise.reject('error'),
+	[], // 
+)
 ```
 
 <div id="obj-copy"></div>
@@ -249,7 +256,7 @@ search(data, {
 	asMap: false, // Result type: true => Map (default, keys preserved), false => Array
 	ignoreCase: false, // For text case-sensitivity
 	limit: 10, // Number of items returned. Default: no limit
-	matchExact: true, // true: full text search. false (default): partial matching
+	matchExact: true, // true: match exact value. false (default): partial matching
 	matchAll: true, // if true, item will be matched only when all of the query properties match
 	query: {
 		age: /(2[5-9])|(3[0-5])/, // match ages 25-35

package/dist/index.d.ts

@@ -24,15 +24,19 @@ type CreateTuple<T, Length extends number, Output extends readonly unknown[] = [
  * @template TData The final return type.
  */
 type Curry<TData, TParams extends unknown[]> = <TArgs extends unknown[]>(...args: TArgs & KeepFirstN<TParams, TArgs['length']>) => DropFirstN<TParams, TArgs['length']> extends [unknown, ...unknown[]] ? Curry<TData, DropFirstN<TParams, TArgs['length']>> : TData;
+type CurriedArgs<TArgs extends unknown[], TArgsIsFinite extends boolean, TFunc extends (...args: any[]) => unknown, TArity extends number> = TArgsIsFinite extends false ? CreateTuple<Parameters<TFunc>[number], TArity> : KeepFirstN<[
+    ...KeepRequired<TArgs>,
+    ...KeepOptionals<TArgs, true, undefined>
+], TArity>;
 /**
- * Deferred function config
+ * Deferred function options
  */
-interface DeferredOptions<ThisArg = unknown> {
+type DeferredOptions<ThisArg = unknown> = {
     leading?: boolean | 'global';
     onError?: (err: unknown) => ValueOrPromise<unknown>;
     thisArg?: ThisArg;
     tid?: TimeoutId;
-}
+};
 /**
  * Drop the first item from an array/tuple and keep the rest
  * ---
@@ -249,10 +253,6 @@ type ValueOrPromise<T> = T | Promise<T>;
 declare function curry<TData, TArgs extends unknown[], TArgsIsFinite extends boolean = IsFiniteTuple<TArgs>, TArity extends TArgs['length'] = TArgsIsFinite extends true ? TupleMaxLength<TArgs> : number>(func: (...args: TArgs) => TData, ...[arity]: TArgsIsFinite extends true ? [arity?: TArity] : [
     arity: TArity
 ]): Curry<TData, CurriedArgs<TArgs, TArgsIsFinite, (...args: TArgs) => TData, TArity>>;
-type CurriedArgs<TArgs extends unknown[], TArgsIsFinite extends boolean, TFunc extends (...args: any[]) => unknown, TArity extends number> = TArgsIsFinite extends false ? CreateTuple<Parameters<TFunc>[number], TArity> : KeepFirstN<[
-    ...KeepRequired<TArgs>,
-    ...KeepOptionals<TArgs, true, undefined>
-], TArity>;
 
 /**
  * @function deferred AKA debounce

package/dist/index.js

@@ -1,14 +1,9 @@
-// src/forceCast.ts
-var asAny = (x) => x;
-var forceCast = (x) => x;
-var forceCast_default = forceCast;
-
 // src/curry.ts
 function curry(func, ...[arity = func.length]) {
   const curriedFn = (...args) => {
     const _args = args;
-    if (_args.length >= arity) return func(...forceCast_default(args));
-    return (...nextArgs) => asAny(curriedFn)(
+    if (_args.length >= arity) return func(...args);
+    return (...nextArgs) => curriedFn(
       ..._args,
       ...nextArgs
     );
@@ -248,6 +243,10 @@ function debounce(...args) {
   return deferred_default(...args);
 }
 
+// src/forceCast.ts
+var asAny = (x) => x;
+var forceCast = (x) => x;
+
 // src/throttled.ts
 var throttled = (callback, delay = 50, config = {}) => {
   const { defaults: d } = throttled;
@@ -346,7 +345,7 @@ var objCopy = (input, output, ignoreKeys, override = false, recursive = true) =>
     const value = input[key];
     const skip = _output.hasOwnProperty(key) && (override === "empty" ? !isEmpty(_output[key]) : isFn(override) ? !override(key, _output[key], value) : true);
     if (skip) continue;
-    const isPrimitive = [void 0, null, Infinity, NaN].includes(asAny(value)) || !isObj(value, false);
+    const isPrimitive = [void 0, null, Infinity, NaN].includes(value) || !isObj(value, false);
     if (isPrimitive) {
       _output[key] = value;
       continue;
@@ -356,26 +355,28 @@ var objCopy = (input, output, ignoreKeys, override = false, recursive = true) =>
         case Array.prototype:
           return clone(value, "[]");
         case ArrayBuffer.prototype:
-          return asAny(value).slice(0);
+          return value.slice(0);
         case Date.prototype:
-          return new Date(asAny(value).getTime());
+          return new Date(value.getTime());
         case Map.prototype:
           return new Map(
             clone(
-              Array.from(asAny(value)),
+              Array.from(
+                value
+              ),
               "[]"
             )
           );
         case RegExp.prototype:
-          return new RegExp(asAny(value));
+          return new RegExp(value);
         case Set.prototype:
           return new Set(
-            clone(Array.from(asAny(value)))
+            clone(Array.from(value))
           );
         case Uint8Array.prototype:
-          return new Uint8Array([...asAny(value)]);
+          return new Uint8Array([...value]);
         case URL.prototype:
-          return new URL(asAny(value));
+          return new URL(value);
         default:
           break;
       }

package/package.json

@@ -42,5 +42,5 @@
 	"sideEffects": false,
 	"type": "module",
 	"types": "dist/index.d.ts",
-	"version": "1.0.6"
+	"version": "1.0.7"
 }