@ls-stack/utils 1.3.0 → 1.5.0

package/dist/{chunk-HYFUWQ2E.js → chunk-ENNWIHHG.js}

@@ -215,4 +215,4 @@ export {
   NormalizedErrorWithMetadata,
   normalizeError
 };
-//# sourceMappingURL=chunk-HYFUWQ2E.js.map
+//# sourceMappingURL=chunk-ENNWIHHG.js.map

package/dist/{chunk-HYFUWQ2E.js.map → chunk-ENNWIHHG.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/rsResult.ts"],"sourcesContent":["import { isObject } from './assertions';\nimport { joinStrings } from './stringUtils';\n\ntype Ok<T> = {\n  ok: true;\n  error: false;\n  value: T;\n};\n\ntype NormalizedErrorResultProps = {\n  id: string;\n  message: string;\n  code?: number;\n  metadata?: ValidErrorMetadata;\n};\n\ntype IsExactlyAny<T> =\n  boolean extends (T extends never ? true : false) ? true : false;\n\ntype Err<E extends ResultValidErrors> = {\n  ok: false;\n  error: E;\n  errorResult: () => Result<any, E>;\n  normalizedErrorResult: (\n    normalizedErr: E extends NormalizedError ?\n      { withMetadata: ValidErrorMetadata } | NormalizedErrorResultProps\n    : NormalizedErrorResultProps,\n  ) => Result<any, NormalizedError>;\n};\n\ntype Unwrap<E, T> =\n  IsExactlyAny<E> extends true ? any\n  : E extends Error ? () => T\n  : unknown;\n\ntype ResultMethods<T, E> = {\n  /** Returns the value if the result is Ok, otherwise returns null */\n  unwrapOrNull: () => T | null;\n  /** Returns the value if the result is Ok, otherwise returns the provided default value */\n  unwrapOr: <R extends T>(defaultValue: R) => T | R;\n  unwrap: Unwrap<E, T>;\n};\n\n/**\n * Util for implementing something similar to Result<T, E> in Rust, for better error handling.\n *\n * Usage:\n *\n * @example\n * function doSomething(): Result<string, Error> {\n *  if (something) {\n *    return ok('success');\n *  }\n *\n *  return err(new Error('something went wrong'));\n * }\n *\n * const result = doSomething();\n *\n * if (result.ok) {\n *   // result.value is a string\n * } else {\n *   // result.error is an Error\n * }\n */\nexport type Result<T, E extends ResultValidErrors = NormalizedError> =\n  | OkResult<T, E, T>\n  | ErrResult<E, T>;\n\nfunction okUnwrapOr<T>(this: Ok<T>) {\n  return this.value;\n}\n\ntype OkResult<T, E extends ResultValidErrors, M = any> = Ok<T> &\n  ResultMethods<M, E>;\n\ntype ResultValidErrors = Error | Record<string, unknown> | [string];\n\nfunction ok(): OkResult<void, any>;\nfunction ok<T>(value: T): OkResult<T, any>;\nfunction ok(value: any = undefined): OkResult<any, any> {\n  return {\n    ok: true,\n    error: false,\n    value,\n    unwrapOrNull: okUnwrapOr,\n    unwrapOr: okUnwrapOr,\n    unwrap: okUnwrapOr,\n  };\n}\n\ntype ErrResult<E extends ResultValidErrors, T = any> = Err<E> &\n  ResultMethods<T, E>;\n\nfunction err<E extends ResultValidErrors>(error: E): ErrResult<E> {\n  return {\n    ok: false,\n    error,\n    unwrapOrNull: () => null,\n    unwrapOr: (defaultValue) => defaultValue,\n    errorResult() {\n      return err(error);\n    },\n    normalizedErrorResult(normalizedErr) {\n      return err(\n        'withMetadata' in normalizedErr && error instanceof NormalizedError ?\n          new NormalizedErrorWithMetadata({\n            error,\n            metadata: {\n              ...error.metadata,\n              ...normalizedErr.withMetadata,\n            },\n          })\n        : new NormalizedError({\n            id: (normalizedErr as NormalizedErrorResultProps).id,\n            message: (normalizedErr as NormalizedErrorResultProps).message,\n            code: (normalizedErr as NormalizedErrorResultProps).code,\n            cause: error instanceof Error ? error : undefined,\n          }),\n      );\n    },\n    unwrap: (() => {\n      throw error;\n    }) as any,\n  };\n}\n\nfunction normalizedUnknownErr(error: unknown) {\n  return err(normalizeError(error));\n}\n\nfunction normalizedErr(message: string): ErrResult<NormalizedError>;\nfunction normalizedErr<T extends string>(\n  id: T,\n  message: string,\n): ErrResult<NormalizedError<T>>;\nfunction normalizedErr<T extends string>(errorProps: {\n  id: T;\n  message: string;\n  code?: number;\n  cause?: Error;\n  metadata?: ValidErrorMetadata;\n}): ErrResult<NormalizedError<T>>;\nfunction normalizedErr(\n  idOrMessageOrErr:\n    | string\n    | {\n        id: string;\n        message: string;\n        code?: number;\n        metadata?: ValidErrorMetadata;\n        cause?: Error;\n      },\n  message?: string,\n): ErrResult<NormalizedError> {\n  if (typeof idOrMessageOrErr === 'object') {\n    return err(\n      new NormalizedError({\n        id: idOrMessageOrErr.id,\n        message: idOrMessageOrErr.message,\n        code: idOrMessageOrErr.code,\n        cause: idOrMessageOrErr.cause,\n        metadata: idOrMessageOrErr.metadata,\n      }),\n    );\n  }\n\n  if (message !== undefined) {\n    return err(\n      new NormalizedError({\n        id: idOrMessageOrErr,\n        message,\n      }),\n    );\n  }\n\n  return err(\n    new NormalizedError({\n      id: 'unknown',\n      message: idOrMessageOrErr,\n    }),\n  );\n}\n\n/** Unwraps a promise result */\nasync function unwrap<T>(result: Promise<Result<T, Error>>): Promise<T> {\n  const unwrapped = await result;\n\n  if (unwrapped.ok) {\n    return unwrapped.value;\n  }\n\n  throw unwrapped.error;\n}\n\nexport const Result = {\n  ok,\n  err,\n  normalizedErr,\n  normalizedUnknownErr,\n  unwrap,\n};\n\n/** transfor a function in a result function */\nexport function resultify<T, E extends ResultValidErrors = NormalizedError>(\n  fn: () => T,\n  errorNormalizer?: (err: unknown) => E,\n): Result<T, E> {\n  try {\n    return ok(fn());\n  } catch (error) {\n    return err(\n      errorNormalizer ?\n        errorNormalizer(error)\n      : (normalizeError(error) as unknown as E),\n    );\n  }\n}\n\n/** transform a async function in a result function */\nexport async function asyncResultify<T, E extends Error = NormalizedError>(\n  fn: () => Promise<T>,\n  errorNormalizer?: (err: unknown) => E,\n): Promise<Result<Awaited<T>, E>> {\n  try {\n    return ok(await fn());\n  } catch (error) {\n    return err(\n      errorNormalizer ?\n        errorNormalizer(error)\n      : (normalizeError(error) as unknown as E),\n    );\n  }\n}\n\nexport type ValidErrorMetadata = Record<string, unknown> | undefined;\n\nlet normalizedErrorSideEffects:\n  | ((normalizedError: NormalizedError) => void)\n  | undefined = undefined;\n\nexport function setNormalizedErrorSideEffects(\n  callback: (normalizedError: NormalizedError) => void,\n) {\n  normalizedErrorSideEffects = callback;\n}\n\nexport class NormalizedError<T = string> extends Error {\n  id: T;\n  metadata?: ValidErrorMetadata;\n  cause?: Error;\n  code: number;\n\n  constructor({\n    id,\n    message,\n    metadata,\n    cause,\n    code = 0,\n  }: {\n    id: T;\n    message: string;\n    metadata?: ValidErrorMetadata;\n    cause?: Error;\n    code?: number;\n  }) {\n    super(message);\n    this.id = id;\n    this.name = 'NormalizedError';\n    this.metadata = metadata;\n    this.cause = cause;\n    this.code = code;\n\n    setTimeout(() => {\n      if (normalizedErrorSideEffects) {\n        normalizedErrorSideEffects(this as NormalizedError);\n      }\n    }, 1);\n  }\n\n  toString() {\n    return joinStrings(\n      !!this.code && `${this.code}#`,\n      String(this.id),\n      `: ${this.message}`,\n      !!this.cause && `\\n  Caused by: ${this.cause}`,\n      !!this.metadata && `\\n  Metadata: ${JSON.stringify(this.metadata)}`,\n    );\n  }\n\n  toJSON() {\n    return {\n      id: this.id,\n      message: this.message,\n      metadata: this.metadata,\n      code: this.code,\n      cause:\n        this.cause ?\n          'toJSON' in this.cause ?\n            this.cause\n          : String(this.cause)\n        : undefined,\n    };\n  }\n}\n\nexport class NormalizedErrorWithMetadata<\n  M extends ValidErrorMetadata,\n  T = string,\n> extends NormalizedError<T> {\n  metadata: M;\n\n  constructor(\n    props:\n      | {\n          id: T;\n          message: string;\n          metadata: M;\n          cause?: Error;\n        }\n      | {\n          error: NormalizedError<T>;\n          metadata: M;\n        },\n  ) {\n    if ('error' in props) {\n      super({\n        id: props.error.id,\n        message: props.error.message,\n        cause: props.error.cause,\n      });\n      this.metadata = props.metadata;\n      this.stack = props.error.stack;\n    } else {\n      super(props);\n      this.metadata = props.metadata;\n    }\n  }\n}\n\nexport function normalizeError(error: unknown): NormalizedError {\n  if (error instanceof NormalizedError) return error;\n\n  if (typeof error === 'string') {\n    return new NormalizedError({\n      id: 'unknown',\n      message: error,\n    });\n  }\n\n  if (error instanceof Error) {\n    return new NormalizedError({\n      id: error.name,\n      message: error.message,\n      cause: error,\n    });\n  }\n\n  if (isObject(error)) {\n    return new NormalizedError({\n      id: 'id' in error ? String(error.id) : 'unknown',\n      message:\n        'message' in error ? String(error.message) : JSON.stringify(error),\n      metadata: error,\n    });\n  }\n\n  return new NormalizedError({\n    message: JSON.stringify(error),\n    id: 'unknown',\n  });\n}\n"],"mappings":"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","names":["normalizedErr"]}
+{"version":3,"sources":["../src/rsResult.ts"],"sourcesContent":["import { isObject } from './assertions';\nimport { joinStrings } from './stringUtils';\n\ntype Ok<T> = {\n  ok: true;\n  error: false;\n  value: T;\n};\n\ntype NormalizedErrorResultProps = {\n  id: string;\n  message: string;\n  code?: number;\n  metadata?: ValidErrorMetadata;\n};\n\ntype IsExactlyAny<T> =\n  boolean extends (T extends never ? true : false) ? true : false;\n\ntype Err<E extends ResultValidErrors> = {\n  ok: false;\n  error: E;\n  errorResult: () => Result<any, E>;\n  normalizedErrorResult: (\n    normalizedErr: E extends NormalizedError ?\n      { withMetadata: ValidErrorMetadata } | NormalizedErrorResultProps\n    : NormalizedErrorResultProps,\n  ) => Result<any, NormalizedError>;\n};\n\ntype Unwrap<E, T> =\n  IsExactlyAny<E> extends true ? any\n  : E extends Error ? () => T\n  : unknown;\n\ntype ResultMethods<T, E> = {\n  /** Returns the value if the result is Ok, otherwise returns null */\n  unwrapOrNull: () => T | null;\n  /** Returns the value if the result is Ok, otherwise returns the provided default value */\n  unwrapOr: <R extends T>(defaultValue: R) => T | R;\n  unwrap: Unwrap<E, T>;\n};\n\n/**\n * Util for implementing something similar to Result<T, E> in Rust, for better error handling.\n *\n * Usage:\n *\n * @example\n * function doSomething(): Result<string, Error> {\n *  if (something) {\n *    return ok('success');\n *  }\n *\n *  return err(new Error('something went wrong'));\n * }\n *\n * const result = doSomething();\n *\n * if (result.ok) {\n *   // result.value is a string\n * } else {\n *   // result.error is an Error\n * }\n */\nexport type Result<T, E extends ResultValidErrors = NormalizedError> =\n  | OkResult<T, E, T>\n  | ErrResult<E, T>;\n\nfunction okUnwrapOr<T>(this: Ok<T>) {\n  return this.value;\n}\n\ntype OkResult<T, E extends ResultValidErrors, M = any> = Ok<T> &\n  ResultMethods<M, E>;\n\ntype ResultValidErrors = Error | Record<string, unknown> | string[];\n\nfunction ok(): OkResult<void, any>;\nfunction ok<T>(value: T): OkResult<T, any>;\nfunction ok(value: any = undefined): OkResult<any, any> {\n  return {\n    ok: true,\n    error: false,\n    value,\n    unwrapOrNull: okUnwrapOr,\n    unwrapOr: okUnwrapOr,\n    unwrap: okUnwrapOr,\n  };\n}\n\ntype ErrResult<E extends ResultValidErrors, T = any> = Err<E> &\n  ResultMethods<T, E>;\n\nfunction err<E extends ResultValidErrors>(error: E): ErrResult<E> {\n  return {\n    ok: false,\n    error,\n    unwrapOrNull: () => null,\n    unwrapOr: (defaultValue) => defaultValue,\n    errorResult() {\n      return err(error);\n    },\n    normalizedErrorResult(normalizedErr) {\n      return err(\n        'withMetadata' in normalizedErr && error instanceof NormalizedError ?\n          new NormalizedErrorWithMetadata({\n            error,\n            metadata: {\n              ...error.metadata,\n              ...normalizedErr.withMetadata,\n            },\n          })\n        : new NormalizedError({\n            id: (normalizedErr as NormalizedErrorResultProps).id,\n            message: (normalizedErr as NormalizedErrorResultProps).message,\n            code: (normalizedErr as NormalizedErrorResultProps).code,\n            cause: error instanceof Error ? error : undefined,\n          }),\n      );\n    },\n    unwrap: (() => {\n      throw error;\n    }) as any,\n  };\n}\n\nfunction normalizedUnknownErr(error: unknown) {\n  return err(normalizeError(error));\n}\n\nfunction normalizedErr(message: string): ErrResult<NormalizedError>;\nfunction normalizedErr<T extends string>(\n  id: T,\n  message: string,\n): ErrResult<NormalizedError<T>>;\nfunction normalizedErr<T extends string>(errorProps: {\n  id: T;\n  message: string;\n  code?: number;\n  cause?: Error;\n  metadata?: ValidErrorMetadata;\n}): ErrResult<NormalizedError<T>>;\nfunction normalizedErr(\n  idOrMessageOrErr:\n    | string\n    | {\n        id: string;\n        message: string;\n        code?: number;\n        metadata?: ValidErrorMetadata;\n        cause?: Error;\n      },\n  message?: string,\n): ErrResult<NormalizedError> {\n  if (typeof idOrMessageOrErr === 'object') {\n    return err(\n      new NormalizedError({\n        id: idOrMessageOrErr.id,\n        message: idOrMessageOrErr.message,\n        code: idOrMessageOrErr.code,\n        cause: idOrMessageOrErr.cause,\n        metadata: idOrMessageOrErr.metadata,\n      }),\n    );\n  }\n\n  if (message !== undefined) {\n    return err(\n      new NormalizedError({\n        id: idOrMessageOrErr,\n        message,\n      }),\n    );\n  }\n\n  return err(\n    new NormalizedError({\n      id: 'unknown',\n      message: idOrMessageOrErr,\n    }),\n  );\n}\n\n/** Unwraps a promise result */\nasync function unwrap<T>(result: Promise<Result<T, Error>>): Promise<T> {\n  const unwrapped = await result;\n\n  if (unwrapped.ok) {\n    return unwrapped.value;\n  }\n\n  throw unwrapped.error;\n}\n\nexport const Result = {\n  ok,\n  err,\n  normalizedErr,\n  normalizedUnknownErr,\n  unwrap,\n};\n\n/** transfor a function in a result function */\nexport function resultify<T, E extends ResultValidErrors = NormalizedError>(\n  fn: () => T,\n  errorNormalizer?: (err: unknown) => E,\n): Result<T, E> {\n  try {\n    return ok(fn());\n  } catch (error) {\n    return err(\n      errorNormalizer ?\n        errorNormalizer(error)\n      : (normalizeError(error) as unknown as E),\n    );\n  }\n}\n\n/** transform a async function in a result function */\nexport async function asyncResultify<T, E extends Error = NormalizedError>(\n  fn: () => Promise<T>,\n  errorNormalizer?: (err: unknown) => E,\n): Promise<Result<Awaited<T>, E>> {\n  try {\n    return ok(await fn());\n  } catch (error) {\n    return err(\n      errorNormalizer ?\n        errorNormalizer(error)\n      : (normalizeError(error) as unknown as E),\n    );\n  }\n}\n\nexport type ValidErrorMetadata = Record<string, unknown> | undefined;\n\nlet normalizedErrorSideEffects:\n  | ((normalizedError: NormalizedError) => void)\n  | undefined = undefined;\n\nexport function setNormalizedErrorSideEffects(\n  callback: (normalizedError: NormalizedError) => void,\n) {\n  normalizedErrorSideEffects = callback;\n}\n\nexport class NormalizedError<T = string> extends Error {\n  id: T;\n  metadata?: ValidErrorMetadata;\n  cause?: Error;\n  code: number;\n\n  constructor({\n    id,\n    message,\n    metadata,\n    cause,\n    code = 0,\n  }: {\n    id: T;\n    message: string;\n    metadata?: ValidErrorMetadata;\n    cause?: Error;\n    code?: number;\n  }) {\n    super(message);\n    this.id = id;\n    this.name = 'NormalizedError';\n    this.metadata = metadata;\n    this.cause = cause;\n    this.code = code;\n\n    setTimeout(() => {\n      if (normalizedErrorSideEffects) {\n        normalizedErrorSideEffects(this as NormalizedError);\n      }\n    }, 1);\n  }\n\n  toString() {\n    return joinStrings(\n      !!this.code && `${this.code}#`,\n      String(this.id),\n      `: ${this.message}`,\n      !!this.cause && `\\n  Caused by: ${this.cause}`,\n      !!this.metadata && `\\n  Metadata: ${JSON.stringify(this.metadata)}`,\n    );\n  }\n\n  toJSON() {\n    return {\n      id: this.id,\n      message: this.message,\n      metadata: this.metadata,\n      code: this.code,\n      cause:\n        this.cause ?\n          'toJSON' in this.cause ?\n            this.cause\n          : String(this.cause)\n        : undefined,\n    };\n  }\n}\n\nexport class NormalizedErrorWithMetadata<\n  M extends ValidErrorMetadata,\n  T = string,\n> extends NormalizedError<T> {\n  metadata: M;\n\n  constructor(\n    props:\n      | {\n          id: T;\n          message: string;\n          metadata: M;\n          cause?: Error;\n        }\n      | {\n          error: NormalizedError<T>;\n          metadata: M;\n        },\n  ) {\n    if ('error' in props) {\n      super({\n        id: props.error.id,\n        message: props.error.message,\n        cause: props.error.cause,\n      });\n      this.metadata = props.metadata;\n      this.stack = props.error.stack;\n    } else {\n      super(props);\n      this.metadata = props.metadata;\n    }\n  }\n}\n\nexport function normalizeError(error: unknown): NormalizedError {\n  if (error instanceof NormalizedError) return error;\n\n  if (typeof error === 'string') {\n    return new NormalizedError({\n      id: 'unknown',\n      message: error,\n    });\n  }\n\n  if (error instanceof Error) {\n    return new NormalizedError({\n      id: error.name,\n      message: error.message,\n      cause: error,\n    });\n  }\n\n  if (isObject(error)) {\n    return new NormalizedError({\n      id: 'id' in error ? String(error.id) : 'unknown',\n      message:\n        'message' in error ? String(error.message) : JSON.stringify(error),\n      metadata: error,\n    });\n  }\n\n  return new NormalizedError({\n    message: JSON.stringify(error),\n    id: 'unknown',\n  });\n}\n"],"mappings":"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","names":["normalizedErr"]}

package/dist/exhaustiveMatch.d.ts

@@ -1,5 +1,6 @@
 declare function exhaustiveMatch<T extends string>(value: T): {
     with: <R>(pattern: { [K in T]: "_nxt" | "_never" | (() => R); }) => R;
+    withObject: <R_1>(pattern: Record<T, R_1>) => R_1;
 };
 
 export { exhaustiveMatch };

package/dist/exhaustiveMatch.js

@@ -17,8 +17,12 @@ function exhaustiveMatch(value) {
     }
     throw new Error(`Exhaustive match failed: no match for ${value}`);
   }
+  function withObject(pattern) {
+    return pattern[value];
+  }
   return {
-    with: matchWith
+    with: matchWith,
+    withObject
   };
 }
 export {

package/dist/exhaustiveMatch.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/exhaustiveMatch.ts"],"sourcesContent":["export function exhaustiveMatch<T extends string>(value: T) {\n  type Pattern<R> = {\n    [K in T]: (() => R) | '_nxt' | '_never';\n  };\n\n  /**\n   * The pattern can be:\n   * - a function that returns the result\n   * - '_nxt' to try the next pattern\n   * - '_never' to indicate that this pattern should never be matched\n   */\n  function matchWith<R>(pattern: Pattern<R>): R {\n    const result = pattern[value];\n\n    if (typeof result === 'function') {\n      return result();\n    }\n\n    if (result === '_nxt') {\n      const keys = Object.keys(pattern);\n\n      const nextIndex = keys.indexOf(value) + 1;\n\n      for (let i = nextIndex; i < keys.length; i++) {\n        const nextMatch = pattern[keys[i] as T];\n\n        if (typeof nextMatch === 'function') {\n          return nextMatch();\n        }\n      }\n    }\n\n    throw new Error(`Exhaustive match failed: no match for ${value}`);\n  }\n\n  return {\n    with: matchWith,\n  };\n}\n"],"mappings":";AAAO,SAAS,gBAAkC,OAAU;AAW1D,WAAS,UAAa,SAAwB;AAC5C,UAAM,SAAS,QAAQ,KAAK;AAE5B,QAAI,OAAO,WAAW,YAAY;AAChC,aAAO,OAAO;AAAA,IAChB;AAEA,QAAI,WAAW,QAAQ;AACrB,YAAM,OAAO,OAAO,KAAK,OAAO;AAEhC,YAAM,YAAY,KAAK,QAAQ,KAAK,IAAI;AAExC,eAAS,IAAI,WAAW,IAAI,KAAK,QAAQ,KAAK;AAC5C,cAAM,YAAY,QAAQ,KAAK,CAAC,CAAM;AAEtC,YAAI,OAAO,cAAc,YAAY;AACnC,iBAAO,UAAU;AAAA,QACnB;AAAA,MACF;AAAA,IACF;AAEA,UAAM,IAAI,MAAM,yCAAyC,KAAK,EAAE;AAAA,EAClE;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,EACR;AACF;","names":[]}
+{"version":3,"sources":["../src/exhaustiveMatch.ts"],"sourcesContent":["export function exhaustiveMatch<T extends string>(value: T) {\n  type Pattern<R> = {\n    [K in T]: (() => R) | '_nxt' | '_never';\n  };\n\n  /**\n   * The pattern can be:\n   * - a function that returns the result\n   * - '_nxt' to try the next pattern\n   * - '_never' to indicate that this pattern should never be matched\n   */\n  function matchWith<R>(pattern: Pattern<R>): R {\n    const result = pattern[value];\n\n    if (typeof result === 'function') {\n      return result();\n    }\n\n    if (result === '_nxt') {\n      const keys = Object.keys(pattern);\n\n      const nextIndex = keys.indexOf(value) + 1;\n\n      for (let i = nextIndex; i < keys.length; i++) {\n        const nextMatch = pattern[keys[i] as T];\n\n        if (typeof nextMatch === 'function') {\n          return nextMatch();\n        }\n      }\n    }\n\n    throw new Error(`Exhaustive match failed: no match for ${value}`);\n  }\n\n  /** match with early evaluation of the values */\n  function withObject<R>(pattern: Record<T, R>): R {\n    return pattern[value];\n  }\n\n  return {\n    with: matchWith,\n    withObject,\n  };\n}\n"],"mappings":";AAAO,SAAS,gBAAkC,OAAU;AAW1D,WAAS,UAAa,SAAwB;AAC5C,UAAM,SAAS,QAAQ,KAAK;AAE5B,QAAI,OAAO,WAAW,YAAY;AAChC,aAAO,OAAO;AAAA,IAChB;AAEA,QAAI,WAAW,QAAQ;AACrB,YAAM,OAAO,OAAO,KAAK,OAAO;AAEhC,YAAM,YAAY,KAAK,QAAQ,KAAK,IAAI;AAExC,eAAS,IAAI,WAAW,IAAI,KAAK,QAAQ,KAAK;AAC5C,cAAM,YAAY,QAAQ,KAAK,CAAC,CAAM;AAEtC,YAAI,OAAO,cAAc,YAAY;AACnC,iBAAO,UAAU;AAAA,QACnB;AAAA,MACF;AAAA,IACF;AAEA,UAAM,IAAI,MAAM,yCAAyC,KAAK,EAAE;AAAA,EAClE;AAGA,WAAS,WAAc,SAA0B;AAC/C,WAAO,QAAQ,KAAK;AAAA,EACtB;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,EACF;AACF;","names":[]}

package/dist/parallelAsyncResultCalls.js

@@ -1,7 +1,7 @@
 import {
   Result,
   normalizeError
-} from "./chunk-HYFUWQ2E.js";
+} from "./chunk-ENNWIHHG.js";
 import {
   sleep
 } from "./chunk-HLFWWIDK.js";

package/dist/rsResult.d.ts

@@ -27,7 +27,7 @@ type ResultMethods<T, E> = {
     unwrap: Unwrap<E, T>;
 };
 type OkResult<T, E extends ResultValidErrors, M = any> = Ok<T> & ResultMethods<M, E>;
-type ResultValidErrors = Error | Record<string, unknown> | [string];
+type ResultValidErrors = Error | Record<string, unknown> | string[];
 declare function ok(): OkResult<void, any>;
 declare function ok<T>(value: T): OkResult<T, any>;
 type ErrResult<E extends ResultValidErrors, T = any> = Err<E> & ResultMethods<T, E>;

package/dist/rsResult.js

@@ -6,7 +6,7 @@ import {
   normalizeError,
   resultify,
   setNormalizedErrorSideEffects
-} from "./chunk-HYFUWQ2E.js";
+} from "./chunk-ENNWIHHG.js";
 import "./chunk-4DRNU53E.js";
 import "./chunk-JT3EBBCA.js";
 export {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ls-stack/utils",
   "description": "Typescript utils",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "license": "MIT",
   "files": [
     "dist"