@ls-stack/utils 2.14.0 → 3.1.0

package/dist/assertions.cjs

@@ -34,15 +34,15 @@ __export(assertions_exports, {
 module.exports = __toCommonJS(assertions_exports);
 var undefErrMsg = "not undefined assertion failed";
 var nullishErrMsg = "not nullish assertion failed";
-function notUndefined(value) {
+function notUndefined(value, message = undefErrMsg) {
   if (value === void 0) {
-    throw new Error(undefErrMsg);
+    throw new Error(message);
   }
   return value;
 }
-function notNullish(value) {
+function notNullish(value, message = nullishErrMsg) {
   if (value === void 0 || value === null) {
-    throw new Error(nullishErrMsg);
+    throw new Error(message);
   }
   return value;
 }
@@ -71,7 +71,7 @@ function isFunction(value) {
   return typeof value === "function";
 }
 function isPromise(value) {
-  return isObject(value) && "then" in value;
+  return isObject(value) && "then" in value && isFunction(value.then);
 }
 function isPlainObject(value) {
   if (!value || typeof value !== "object") return false;

package/dist/assertions.d.cts

@@ -1,8 +1,8 @@
 type NotUndefined<T> = T extends undefined ? never : T;
 type StrictNonUndefined<T, N = unknown> = undefined extends T ? NotUndefined<T> : N;
-declare function notUndefined<T>(value: T): StrictNonUndefined<T>;
+declare function notUndefined<T>(value: T, message?: string): StrictNonUndefined<T>;
 type StrictNonNullable<T, N = unknown> = undefined extends T ? NonNullable<T> : null extends T ? NonNullable<T> : N;
-declare function notNullish<T>(value: T): StrictNonNullable<T>;
+declare function notNullish<T>(value: T, message?: string): StrictNonNullable<T>;
 declare function assertIsNotNullish<T>(value: T, errorMsg?: string): asserts value is StrictNonNullable<T, never>;
 declare function assertIsNotUndefined<T>(value: T, errorMsg?: string): asserts value is StrictNonUndefined<T, never>;
 /** Use this function to assert that a certain condition is always true. */

package/dist/assertions.d.ts

@@ -1,8 +1,8 @@
 type NotUndefined<T> = T extends undefined ? never : T;
 type StrictNonUndefined<T, N = unknown> = undefined extends T ? NotUndefined<T> : N;
-declare function notUndefined<T>(value: T): StrictNonUndefined<T>;
+declare function notUndefined<T>(value: T, message?: string): StrictNonUndefined<T>;
 type StrictNonNullable<T, N = unknown> = undefined extends T ? NonNullable<T> : null extends T ? NonNullable<T> : N;
-declare function notNullish<T>(value: T): StrictNonNullable<T>;
+declare function notNullish<T>(value: T, message?: string): StrictNonNullable<T>;
 declare function assertIsNotNullish<T>(value: T, errorMsg?: string): asserts value is StrictNonNullable<T, never>;
 declare function assertIsNotUndefined<T>(value: T, errorMsg?: string): asserts value is StrictNonUndefined<T, never>;
 /** Use this function to assert that a certain condition is always true. */

package/dist/assertions.js

@@ -9,7 +9,7 @@ import {
   isPromise,
   notNullish,
   notUndefined
-} from "./chunk-4UGSP3L3.js";
+} from "./chunk-2TIVYE43.js";
 export {
   assertIsNotNullish,
   assertIsNotUndefined,

package/dist/cache.cjs

@@ -20,7 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/cache.ts
 var cache_exports = {};
 __export(cache_exports, {
-  RejectValue: () => RejectValue,
+  SkipCaching: () => SkipCaching,
   WithExpiration: () => WithExpiration,
   cachedGetter: () => cachedGetter,
   createCache: () => createCache
@@ -31,8 +31,11 @@ module.exports = __toCommonJS(cache_exports);
 function isObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function isFunction(value) {
+  return typeof value === "function";
+}
 function isPromise(value) {
-  return isObject(value) && "then" in value;
+  return isObject(value) && "then" in value && isFunction(value.then);
 }
 
 // src/time.ts
@@ -61,7 +64,7 @@ function cachedGetter(getter) {
     }
   };
 }
-var RejectValue = class {
+var SkipCaching = class {
   value;
   constructor(value) {
     this.value = value;
@@ -126,7 +129,7 @@ function createCache({
     return { value, timestamp: now, expiration: void 0 };
   }
   const utils = {
-    reject: (value) => new RejectValue(value),
+    skipCaching: (value) => new SkipCaching(value),
     withExpiration: (value, expiration) => {
       return new WithExpiration(value, expiration);
     }
@@ -137,10 +140,10 @@ function createCache({
       const entry = cache.get(cacheKey);
       if (!entry || isExpired(entry, now)) {
         const value = val(utils);
-        if (value instanceof RejectValue) {
+        if (value instanceof SkipCaching) {
           return value.value;
         }
-        if (options?.rejectWhen?.(value)) {
+        if (options?.skipCachingWhen?.(value)) {
           return value;
         }
         const unwrappedValue = unwrapValue(value, now);
@@ -166,14 +169,14 @@ function createCache({
         return entry.value;
       }
       const promise = val(utils).then((result) => {
-        if (result instanceof RejectValue) {
+        if (result instanceof SkipCaching) {
           const cacheValue = cache.get(cacheKey);
           if (cacheValue?.value === promise) {
             cache.delete(cacheKey);
           }
           return result.value;
         }
-        if (options?.rejectWhen?.(result)) {
+        if (options?.skipCachingWhen?.(result)) {
           const cacheValue = cache.get(cacheKey);
           if (cacheValue?.value === promise) {
             cache.delete(cacheKey);
@@ -223,7 +226,7 @@ function createCache({
     },
     async setAsync(cacheKey, value) {
       const promise = value(utils).then((result) => {
-        if (result instanceof RejectValue) {
+        if (result instanceof SkipCaching) {
           const cacheValue = cache.get(cacheKey);
           if (cacheValue?.value === promise) {
             cache.delete(cacheKey);
@@ -253,7 +256,7 @@ function createCache({
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  RejectValue,
+  SkipCaching,
   WithExpiration,
   cachedGetter,
   createCache

package/dist/cache.d.cts

@@ -20,7 +20,7 @@ type Options = {
      */
     expirationThrottle?: number;
 };
-declare class RejectValue<T> {
+declare class SkipCaching<T> {
     value: T;
     constructor(value: T);
 }
@@ -34,7 +34,7 @@ declare class WithExpiration<T> {
     constructor(value: T, expiration: DurationObj);
 }
 type Utils<T> = {
-    reject: (value: T) => RejectValue<T>;
+    skipCaching: (value: T) => SkipCaching<T>;
     /**
      * Create a new WithExpiration object with the given value and expiration time.
      * @param value - The value to store in the cache.
@@ -49,11 +49,11 @@ type GetOptions<T> = {
      * @param value The value to check
      * @returns true if the value should be rejected, false otherwise
      */
-    rejectWhen?: (value: T) => boolean;
+    skipCachingWhen?: (value: T) => boolean;
 };
 type Cache<T> = {
-    getOrInsert: (cacheKey: string, val: (utils: Utils<T>) => T | RejectValue<T>, options?: GetOptions<T>) => T;
-    getOrInsertAsync: (cacheKey: string, val: (utils: Utils<T>) => Promise<T | RejectValue<T>>, options?: GetOptions<T>) => Promise<T>;
+    getOrInsert: (cacheKey: string, val: (utils: Utils<T>) => T | SkipCaching<T>, options?: GetOptions<T>) => T;
+    getOrInsertAsync: (cacheKey: string, val: (utils: Utils<T>) => Promise<T | SkipCaching<T>>, options?: GetOptions<T>) => Promise<T>;
     clear: () => void;
     get: (cacheKey: string) => T | undefined;
     set: (cacheKey: string, value: T | WithExpiration<T>) => void;
@@ -69,4 +69,4 @@ type Cache<T> = {
 };
 declare function createCache<T>({ maxCacheSize, maxItemAge, expirationThrottle, }?: Options): Cache<T>;
 
-export { type Cache, RejectValue, WithExpiration, cachedGetter, createCache };
+export { type Cache, SkipCaching, WithExpiration, cachedGetter, createCache };

package/dist/cache.d.ts

@@ -20,7 +20,7 @@ type Options = {
      */
     expirationThrottle?: number;
 };
-declare class RejectValue<T> {
+declare class SkipCaching<T> {
     value: T;
     constructor(value: T);
 }
@@ -34,7 +34,7 @@ declare class WithExpiration<T> {
     constructor(value: T, expiration: DurationObj);
 }
 type Utils<T> = {
-    reject: (value: T) => RejectValue<T>;
+    skipCaching: (value: T) => SkipCaching<T>;
     /**
      * Create a new WithExpiration object with the given value and expiration time.
      * @param value - The value to store in the cache.
@@ -49,11 +49,11 @@ type GetOptions<T> = {
      * @param value The value to check
      * @returns true if the value should be rejected, false otherwise
      */
-    rejectWhen?: (value: T) => boolean;
+    skipCachingWhen?: (value: T) => boolean;
 };
 type Cache<T> = {
-    getOrInsert: (cacheKey: string, val: (utils: Utils<T>) => T | RejectValue<T>, options?: GetOptions<T>) => T;
-    getOrInsertAsync: (cacheKey: string, val: (utils: Utils<T>) => Promise<T | RejectValue<T>>, options?: GetOptions<T>) => Promise<T>;
+    getOrInsert: (cacheKey: string, val: (utils: Utils<T>) => T | SkipCaching<T>, options?: GetOptions<T>) => T;
+    getOrInsertAsync: (cacheKey: string, val: (utils: Utils<T>) => Promise<T | SkipCaching<T>>, options?: GetOptions<T>) => Promise<T>;
     clear: () => void;
     get: (cacheKey: string) => T | undefined;
     set: (cacheKey: string, value: T | WithExpiration<T>) => void;
@@ -69,4 +69,4 @@ type Cache<T> = {
 };
 declare function createCache<T>({ maxCacheSize, maxItemAge, expirationThrottle, }?: Options): Cache<T>;
 
-export { type Cache, RejectValue, WithExpiration, cachedGetter, createCache };
+export { type Cache, SkipCaching, WithExpiration, cachedGetter, createCache };

package/dist/cache.js

@@ -1,11 +1,11 @@
 import {
   durationObjToMs
-} from "./chunk-RK6PT7JY.js";
+} from "./chunk-5MNYPLZI.js";
 import "./chunk-HTCYUMDR.js";
 import {
   isPromise
-} from "./chunk-4UGSP3L3.js";
-import "./chunk-GBFS2I67.js";
+} from "./chunk-2TIVYE43.js";
+import "./chunk-II4R3VVX.js";
 
 // src/cache.ts
 function cachedGetter(getter) {
@@ -17,7 +17,7 @@ function cachedGetter(getter) {
     }
   };
 }
-var RejectValue = class {
+var SkipCaching = class {
   value;
   constructor(value) {
     this.value = value;
@@ -82,7 +82,7 @@ function createCache({
     return { value, timestamp: now, expiration: void 0 };
   }
   const utils = {
-    reject: (value) => new RejectValue(value),
+    skipCaching: (value) => new SkipCaching(value),
     withExpiration: (value, expiration) => {
       return new WithExpiration(value, expiration);
     }
@@ -93,10 +93,10 @@ function createCache({
       const entry = cache.get(cacheKey);
       if (!entry || isExpired(entry, now)) {
         const value = val(utils);
-        if (value instanceof RejectValue) {
+        if (value instanceof SkipCaching) {
           return value.value;
         }
-        if (options?.rejectWhen?.(value)) {
+        if (options?.skipCachingWhen?.(value)) {
           return value;
         }
         const unwrappedValue = unwrapValue(value, now);
@@ -122,14 +122,14 @@ function createCache({
         return entry.value;
       }
       const promise = val(utils).then((result) => {
-        if (result instanceof RejectValue) {
+        if (result instanceof SkipCaching) {
           const cacheValue = cache.get(cacheKey);
           if (cacheValue?.value === promise) {
             cache.delete(cacheKey);
           }
           return result.value;
         }
-        if (options?.rejectWhen?.(result)) {
+        if (options?.skipCachingWhen?.(result)) {
           const cacheValue = cache.get(cacheKey);
           if (cacheValue?.value === promise) {
             cache.delete(cacheKey);
@@ -179,7 +179,7 @@ function createCache({
     },
     async setAsync(cacheKey, value) {
       const promise = value(utils).then((result) => {
-        if (result instanceof RejectValue) {
+        if (result instanceof SkipCaching) {
           const cacheValue = cache.get(cacheKey);
           if (cacheValue?.value === promise) {
             cache.delete(cacheKey);
@@ -208,7 +208,7 @@ function createCache({
   };
 }
 export {
-  RejectValue,
+  SkipCaching,
   WithExpiration,
   cachedGetter,
   createCache

package/dist/castValues.cjs

@@ -29,11 +29,19 @@ function castToString(value) {
   return valueType === "string" || valueType === "number" || valueType === "boolean" || valueType === "bigint" ? String(value) : null;
 }
 function castToNumber(value) {
-  return isNumeric(value) ? Number(value) : null;
+  return isFiniteNumeric(value) ? Number(value) : null;
 }
-function isNumeric(num) {
-  const str = String(num);
-  return !isNaN(str) && !isNaN(parseFloat(str));
+function isFiniteNumeric(num) {
+  switch (typeof num) {
+    case "number":
+      return num - num === 0;
+    case "string":
+      return num.trim() !== "" && Number.isFinite(+num);
+    case "bigint":
+      return Number.isFinite(Number(num));
+    default:
+      return false;
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/castValues.js

@@ -1,7 +1,7 @@
 import {
   castToNumber,
   castToString
-} from "./chunk-GBFS2I67.js";
+} from "./chunk-II4R3VVX.js";
 export {
   castToNumber,
   castToString

package/dist/{chunk-4UGSP3L3.js → chunk-2TIVYE43.js}

@@ -1,15 +1,15 @@
 // src/assertions.ts
 var undefErrMsg = "not undefined assertion failed";
 var nullishErrMsg = "not nullish assertion failed";
-function notUndefined(value) {
+function notUndefined(value, message = undefErrMsg) {
   if (value === void 0) {
-    throw new Error(undefErrMsg);
+    throw new Error(message);
   }
   return value;
 }
-function notNullish(value) {
+function notNullish(value, message = nullishErrMsg) {
   if (value === void 0 || value === null) {
-    throw new Error(nullishErrMsg);
+    throw new Error(message);
   }
   return value;
 }
@@ -38,7 +38,7 @@ function isFunction(value) {
   return typeof value === "function";
 }
 function isPromise(value) {
-  return isObject(value) && "then" in value;
+  return isObject(value) && "then" in value && isFunction(value.then);
 }
 function isPlainObject(value) {
   if (!value || typeof value !== "object") return false;

package/dist/{chunk-T5WDDPFI.js → chunk-4DCLNY64.js}

@@ -1,6 +1,6 @@
 import {
   isFunction
-} from "./chunk-4UGSP3L3.js";
+} from "./chunk-2TIVYE43.js";
 
 // src/enhancedMap.ts
 var enhancedMapReject = Symbol();

package/dist/{chunk-KBFP7INB.js → chunk-55DQGPY3.js}

@@ -2,10 +2,12 @@ import {
   safeJsonStringify
 } from "./chunk-VAAMRG4K.js";
 import {
-  isObject
-} from "./chunk-4UGSP3L3.js";
+  isFunction,
+  isObject,
+  isPromise
+} from "./chunk-2TIVYE43.js";
 
-// src/rsResult.ts
+// src/tsResult.ts
 function okUnwrapOr() {
   return this.value;
 }
@@ -24,28 +26,40 @@ function mapOkAndErr({
 function returnResult() {
   return this;
 }
+function okOnOk(fn) {
+  if (this.ok) {
+    fn(this.value);
+  }
+  return this;
+}
+function errOnErr(fn) {
+  if (!this.ok) {
+    fn(this.error);
+  }
+  return this;
+}
 function ok(value = void 0) {
-  return {
-    ok: true,
-    error: false,
-    value,
+  const methods = {
     unwrapOrNull: okUnwrapOr,
     unwrapOr: okUnwrapOr,
     unwrap: okUnwrapOr,
     mapOk: okMap,
     mapErr: returnResult,
-    mapOkAndErr
+    mapOkAndErr,
+    ifOk: okOnOk,
+    ifErr: returnResult
+  };
+  return {
+    ok: true,
+    error: false,
+    value,
+    ...methods
   };
 }
 function err(error) {
-  return {
-    ok: false,
-    error,
+  const methods = {
     unwrapOrNull: () => null,
     unwrapOr: (defaultValue) => defaultValue,
-    errorResult() {
-      return err(error);
-    },
     unwrap: () => {
       if (error instanceof Error) {
         throw error;
@@ -54,7 +68,17 @@ function err(error) {
     },
     mapOk: returnResult,
     mapErr: errMap,
-    mapOkAndErr
+    mapOkAndErr,
+    ifOk: returnResult,
+    ifErr: errOnErr
+  };
+  return {
+    ok: false,
+    error,
+    errorResult() {
+      return err(error);
+    },
+    ...methods
   };
 }
 function unknownToResultError(error) {
@@ -94,20 +118,27 @@ var Result = {
   err,
   unknownToError: unknownToResultError,
   asyncUnwrap,
-  asyncMap
+  asyncMap,
+  getOkErr
 };
 function resultify(fn, errorNormalizer) {
-  try {
-    return ok(fn());
-  } catch (error) {
-    return err(
-      errorNormalizer ? errorNormalizer(error) : unknownToError(error)
+  if (!isFunction(fn)) {
+    return fn.then((value) => ok(value)).catch(
+      (error) => err(
+        errorNormalizer ? errorNormalizer(error) : unknownToError(error)
+      )
     );
   }
-}
-async function asyncResultify(fn, errorNormalizer) {
   try {
-    return ok(await fn());
+    const result = fn();
+    if (isPromise(result)) {
+      return result.then((value) => ok(value)).catch(
+        (error) => err(
+          errorNormalizer ? errorNormalizer(error) : unknownToError(error)
+        )
+      );
+    }
+    return ok(result);
   } catch (error) {
     return err(
       errorNormalizer ? errorNormalizer(error) : unknownToError(error)
@@ -129,23 +160,21 @@ function unknownToError(error) {
     cause: error
   });
 }
-function normalizeError(error) {
-  return unknownToError(error);
-}
-var safeJsonStringify2 = safeJsonStringify;
-function createTypedResult() {
-  return {
-    ok,
-    err
-  };
+var typedResult = {
+  ok,
+  err,
+  get _type() {
+    throw new Error("usage as value is not allowed");
+  }
+};
+function getOkErr() {
+  return typedResult;
 }
 
 export {
+  ok,
+  err,
   Result,
   resultify,
-  asyncResultify,
-  unknownToError,
-  normalizeError,
-  safeJsonStringify2 as safeJsonStringify,
-  createTypedResult
+  unknownToError
 };

package/dist/{chunk-RK6PT7JY.js → chunk-5MNYPLZI.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-HTCYUMDR.js";
 import {
   castToNumber
-} from "./chunk-GBFS2I67.js";
+} from "./chunk-II4R3VVX.js";
 
 // src/time.ts
 var MINUTE_AS_MS = 60 * 1e3;

package/dist/chunk-II4R3VVX.js

@@ -0,0 +1,25 @@
+// src/castValues.ts
+function castToString(value) {
+  const valueType = typeof value;
+  return valueType === "string" || valueType === "number" || valueType === "boolean" || valueType === "bigint" ? String(value) : null;
+}
+function castToNumber(value) {
+  return isFiniteNumeric(value) ? Number(value) : null;
+}
+function isFiniteNumeric(num) {
+  switch (typeof num) {
+    case "number":
+      return num - num === 0;
+    case "string":
+      return num.trim() !== "" && Number.isFinite(+num);
+    case "bigint":
+      return Number.isFinite(Number(num));
+    default:
+      return false;
+  }
+}
+
+export {
+  castToString,
+  castToNumber
+};

package/dist/createThrottleController.js

@@ -1,12 +1,12 @@
 import {
   EnhancedMap
-} from "./chunk-T5WDDPFI.js";
+} from "./chunk-4DCLNY64.js";
 import {
   durationObjToMs
-} from "./chunk-RK6PT7JY.js";
+} from "./chunk-5MNYPLZI.js";
 import "./chunk-HTCYUMDR.js";
-import "./chunk-4UGSP3L3.js";
-import "./chunk-GBFS2I67.js";
+import "./chunk-2TIVYE43.js";
+import "./chunk-II4R3VVX.js";
 
 // src/createThrottleController.ts
 function createThrottleController({

package/dist/enhancedMap.js

@@ -1,8 +1,8 @@
 import {
   EnhancedMap,
   enhancedMapReject
-} from "./chunk-T5WDDPFI.js";
-import "./chunk-4UGSP3L3.js";
+} from "./chunk-4DCLNY64.js";
+import "./chunk-2TIVYE43.js";
 export {
   EnhancedMap,
   enhancedMapReject

package/dist/exhaustiveMatch.cjs

@@ -20,7 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/exhaustiveMatch.ts
 var exhaustiveMatch_exports = {};
 __export(exhaustiveMatch_exports, {
-  exhaustiveMatch: () => exhaustiveMatch
+  exhaustiveMatch: () => exhaustiveMatch,
+  exhaustiveMatchObjUnion: () => exhaustiveMatchObjUnion
 });
 module.exports = __toCommonJS(exhaustiveMatch_exports);
 function exhaustiveMatch(value) {
@@ -49,7 +50,17 @@ function exhaustiveMatch(value) {
     withObject
   };
 }
+function exhaustiveMatchObjUnion(obj, key) {
+  function withLazy(pattern) {
+    const result = pattern[obj[key]];
+    if (typeof result === "function")
+      return result(obj);
+    throw new Error(`Exhaustive match failed: no match for ${obj[key]}`);
+  }
+  return { with: withLazy };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  exhaustiveMatch
+  exhaustiveMatch,
+  exhaustiveMatchObjUnion
 });

package/dist/exhaustiveMatch.d.cts

@@ -2,5 +2,8 @@ declare function exhaustiveMatch<T extends string>(value: T): {
     with: <R>(pattern: { [K in T]: "_nxt" | "_never" | (() => R); }) => R;
     withObject: <R>(pattern: Record<T, R>) => R;
 };
+declare function exhaustiveMatchObjUnion<T extends Record<string, unknown>, D extends keyof T, K extends T[D] & string>(obj: T, key: D): {
+    with: <R>(pattern: { [P in K]: "_never" | ((props: Extract<T, Record<D, P>>) => R); }) => R;
+};
 
-export { exhaustiveMatch };
+export { exhaustiveMatch, exhaustiveMatchObjUnion };

package/dist/exhaustiveMatch.d.ts

@@ -2,5 +2,8 @@ declare function exhaustiveMatch<T extends string>(value: T): {
     with: <R>(pattern: { [K in T]: "_nxt" | "_never" | (() => R); }) => R;
     withObject: <R>(pattern: Record<T, R>) => R;
 };
+declare function exhaustiveMatchObjUnion<T extends Record<string, unknown>, D extends keyof T, K extends T[D] & string>(obj: T, key: D): {
+    with: <R>(pattern: { [P in K]: "_never" | ((props: Extract<T, Record<D, P>>) => R); }) => R;
+};
 
-export { exhaustiveMatch };
+export { exhaustiveMatch, exhaustiveMatchObjUnion };

package/dist/exhaustiveMatch.js

@@ -25,6 +25,16 @@ function exhaustiveMatch(value) {
     withObject
   };
 }
+function exhaustiveMatchObjUnion(obj, key) {
+  function withLazy(pattern) {
+    const result = pattern[obj[key]];
+    if (typeof result === "function")
+      return result(obj);
+    throw new Error(`Exhaustive match failed: no match for ${obj[key]}`);
+  }
+  return { with: withLazy };
+}
 export {
-  exhaustiveMatch
+  exhaustiveMatch,
+  exhaustiveMatchObjUnion
 };