@vbotma/toolkit 1.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Vladislav Kibenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/dts/casing/camelToKebab.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Converts string value from camel case to kebab case.
+ * @param value - value to convert.
+ */
+export declare function camelToKebab(value: string): string;

package/dist/dts/casing/camelToSnake.d.ts

@@ -0,0 +1,6 @@
+export type CamelToSnakeCase<T extends string> = T extends `${infer First}${infer Rest}` ? `${First extends Capitalize<First> ? '_' : ''}${Lowercase<First>}${CamelToSnakeCase<Rest>}` : T;
+/**
+ * Converts string value from camel case to snake case.
+ * @param value - value to convert.
+ */
+export declare function camelToSnake<T extends string>(value: T): CamelToSnakeCase<T>;

package/dist/dts/casing/camelToSnakeObjKeys.d.ts

@@ -0,0 +1,9 @@
+import { CamelToSnakeCase } from './camelToSnake.js';
+export type ConvertCamelKeysToSnakeCase<T> = {
+    [K in keyof T as CamelToSnakeCase<string & K>]: T[K];
+};
+/**
+ * Converts object keys from snake to camel case.
+ * @param value - value to convert.
+ */
+export declare function camelToSnakeObjKeys<T extends object>(value: T): ConvertCamelKeysToSnakeCase<T>;

package/dist/dts/casing/deepSnakeToCamelObjKeys.d.ts

@@ -0,0 +1,9 @@
+import { SnakeToCamelCase } from './snakeToCamel.js';
+export type DeepConvertSnakeKeysToCamelCase<T> = T extends infer U ? U extends object ? U extends Date ? U : U extends (infer Item)[] ? DeepConvertSnakeKeysToCamelCase<Item>[] : {
+    [K in keyof U as SnakeToCamelCase<string & K>]: DeepConvertSnakeKeysToCamelCase<U[K]>;
+} & {} : U : T;
+/**
+ * Deeply converts object keys from snake to camel case.
+ * @param value - value to convert.
+ */
+export declare function deepSnakeToCamelObjKeys<T extends object>(value: T): DeepConvertSnakeKeysToCamelCase<T>;

package/dist/dts/casing/snakeToCamel.d.ts

@@ -0,0 +1,6 @@
+export type SnakeToCamelCase<S extends string> = S extends `${infer Head}_${infer Tail}` ? `${Head}${Capitalize<SnakeToCamelCase<Tail>>}` : S;
+/**
+ * Converts string value from snake case to camel case.
+ * @param value - value to convert.
+ */
+export declare function snakeToCamel<T extends string>(value: T): SnakeToCamelCase<T>;

package/dist/dts/casing/snakeToCamelObjKeys.d.ts

@@ -0,0 +1,9 @@
+import { SnakeToCamelCase } from './snakeToCamel.js';
+export type ConvertSnakeKeysToCamelCase<T> = {
+    [K in keyof T as SnakeToCamelCase<string & K>]: T[K];
+};
+/**
+ * Converts object keys from snake to camel case.
+ * @param value - value to convert.
+ */
+export declare function snakeToCamelObjKeys<T extends object>(value: T): ConvertSnakeKeysToCamelCase<T>;

package/dist/dts/casing/snakeToKebab.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Converts string value from snake case to kebab case.
+ * @param value - value to convert.
+ */
+export declare function snakeToKebab(value: string): string;

package/dist/dts/createCbCollector.d.ts

@@ -0,0 +1,9 @@
+export type CallbackFn = () => void;
+/**
+ * Returns a tuple, containing function to add cleanup, call cleanup, and flag showing whether
+ * cleanup was called. Cleanup will not be performed in case, it was done before.
+ */
+export declare function createCbCollector(...cbs: (CallbackFn | CallbackFn[])[]): [
+    add: (...fns: CallbackFn[]) => void,
+    call: () => void
+];

package/dist/dts/createLogger.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Message log level.
+ */
+export type LogLevel = 'log' | 'error' | 'warn';
+export interface LoggerOptions {
+    bgColor?: string;
+    textColor?: string;
+    /**
+     * True if logs are enabled.
+     * @default true
+     */
+    shouldLog?: boolean | (() => boolean);
+}
+export type LoggerFn = (...args: any[]) => void;
+export type LoggerForceFn = (...args: any[]) => void;
+export interface Logger {
+    /**
+     * Prints an error message into the console.
+     * @param args - items to log.
+     */
+    error: LoggerFn;
+    /**
+     * Prints an error message into the console ignoring the `shouldLog`
+     * constructor option.
+     * @param args - items to log.
+     */
+    forceError: LoggerForceFn;
+    /**
+     * Prints a log message into the console ignoring the `shouldLog` constructor
+     * option.
+     * @param args - items to log.
+     */
+    forceLog: LoggerForceFn;
+    /**
+     * Prints a warning message into the console ignoring the `shouldLog`
+     * constructor option.
+     * @param args - items to log.
+     */
+    forceWarn: LoggerForceFn;
+    /**
+     * Prints a log message into the console.
+     * @param args - items to log.
+     */
+    log: LoggerFn;
+    /**
+     * Prints a warning message into the console.
+     * @param args - items to log.
+     */
+    warn: LoggerFn;
+}
+export declare function createLogger(scope: string, options?: LoggerOptions): Logger;

package/dist/dts/index.d.ts

@@ -0,0 +1,15 @@
+export * from './casing/camelToKebab.js';
+export * from './casing/camelToSnake.js';
+export * from './casing/camelToSnakeObjKeys.js';
+export * from './casing/deepSnakeToCamelObjKeys.js';
+export * from './casing/snakeToCamel.js';
+export * from './casing/snakeToCamelObjKeys.js';
+export * from './casing/snakeToKebab.js';
+export * from './storage/storage.js';
+export type * from './types/logical.js';
+export type * from './types/misc.js';
+export type * from './types/predicates.js';
+export type * from './types/unions.js';
+export * from './createCbCollector.js';
+export * from './createLogger.js';
+export * from './monads.js';

package/dist/dts/monads.d.ts

@@ -0,0 +1,21 @@
+import { BetterPromise, BetterPromiseExecutorContext, BetterPromiseOptions, TimeoutError } from 'better-promises';
+import { either as E, taskEither as TE } from 'fp-ts';
+import { AnyFn } from './types/misc.js';
+export type AnyEither<L = any, R = any> = E.Either<L, R> | TE.TaskEither<L, R>;
+export type AnyFnAnyEither<L = any, R = any> = (...args: any) => AnyEither<L, R>;
+export type RightOfEither<T extends AnyEither> = [T] extends [E.Either<any, infer U>] ? U : T extends TE.TaskEither<any, infer U> ? U : never;
+export type LeftOfEither<T extends AnyEither> = [T] extends [E.Either<infer U, any>] ? U : T extends TE.TaskEither<infer U, any> ? U : never;
+export type RightOfReturn<F extends AnyFnAnyEither> = RightOfEither<ReturnType<F>>;
+export type LeftOfReturn<F extends AnyFnAnyEither> = LeftOfEither<ReturnType<F>>;
+export type MaybeMonadToCommon<T> = [T] extends [E.Either<any, infer U>] ? U : T extends TE.TaskEither<any, infer U> ? BetterPromise<U> : T;
+export type MaybeCommonToMonad<T> = T extends AnyEither ? T : T extends PromiseLike<infer U> ? TE.TaskEither<unknown, U> : E.Either<unknown, T>;
+export type MaybeMonadReturnTypeToCommon<Fn extends AnyFn> = MaybeMonadToCommon<ReturnType<Fn>>;
+export type MaybeCommonReturnTypeToMonad<Fn extends AnyFn> = MaybeCommonToMonad<ReturnType<Fn>>;
+export declare function throwifyAnyEither<E extends AnyEither>(either: E): MaybeMonadToCommon<E>;
+export declare function throwifyFpFn<Fn extends AnyFnAnyEither>(fn: Fn): (((...args: Parameters<Fn>) => MaybeMonadReturnTypeToCommon<Fn>) & {
+    [K in keyof Fn]: Fn[K];
+});
+export type BetterTaskEitherError = TimeoutError;
+export declare const BetterTaskEither: (<E, T>(executor: (resolve: (data: T) => void, reject: (reason: E) => void, context: BetterPromiseExecutorContext<E.Either<E | BetterTaskEitherError, T>>) => (void | Promise<void>), options?: BetterPromiseOptions) => TE.TaskEither<E | BetterTaskEitherError, T>) & {
+    fn: <E, T>(fn_: (context: BetterPromiseExecutorContext<E.Either<E | BetterTaskEitherError, T>>) => (E.Either<E, T> | TE.TaskEither<E, T>), options?: BetterPromiseOptions) => TE.TaskEither<E | BetterTaskEitherError, T>;
+};

package/dist/dts/storage/storage.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Saves value in the storage.
+ * @param key - storage key.
+ * @param value - storage value.
+ */
+export declare function setStorageValue<T>(key: string, value: T): void;
+/**
+ * Extracts value from the storage.
+ * @param key - storage key.
+ */
+export declare function getStorageValue<R>(key: string): R | undefined;

package/dist/dts/types/logical.d.ts

@@ -0,0 +1,2 @@
+export type If<Cond extends boolean, True, False> = Cond extends true ? True : False;
+export type Or<A extends boolean, B extends boolean> = A extends true ? true : (B extends true ? true : false);

package/dist/dts/types/misc.d.ts

@@ -0,0 +1,2 @@
+export type Maybe<T> = T | undefined | null;
+export type AnyFn = (...args: any[]) => any;

package/dist/dts/types/predicates.d.ts

@@ -0,0 +1,2 @@
+export type IsNever<T> = [T] extends [never] ? true : false;
+export type IsUndefined<T> = [T] extends [undefined] ? true : false;

package/dist/dts/types/unions.d.ts

@@ -0,0 +1,7 @@
+export type UnionStringKeys<U> = U extends U ? {
+    [K in keyof U]-?: U[K] extends string | undefined ? K : never;
+}[keyof U] : never;
+export type UnionRequiredKeys<U> = U extends U ? {
+    [K in UnionStringKeys<U>]: ({} extends Pick<U, K> ? never : K);
+}[UnionStringKeys<U>] : never;
+export type UnionOptionalKeys<U> = Exclude<UnionStringKeys<U>, UnionRequiredKeys<U>>;

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("better-promises"),n=require("fp-ts");function w(t){return t.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`)}function m(t){return t.replace(/[A-Z]/g,e=>`_${e.toLowerCase()}`)}function $(t){return Object.entries(t).reduce((e,[r,o])=>(e[m(r)]=o,e),{})}function b(t){return t.replace(/_[a-z]/g,e=>e[1].toUpperCase())}function p(t){return Object.entries(t).reduce((e,[r,o])=>(e[b(r)]=o,e),{})}function l(t){const e=p(t);for(const r in e){const o=e[r];o&&typeof o=="object"&&!(o instanceof Date)&&(e[r]=Array.isArray(o)?o.map(l):l(o))}return e}function O(t){return t.replace(/_([a-z])/g,(e,r)=>`-${r.toLowerCase()}`)}function d(t){return`tapps/${t}`}function j(t,e){sessionStorage.setItem(d(t),JSON.stringify(e))}function K(t){const e=sessionStorage.getItem(d(t));try{return e?JSON.parse(e):void 0}catch{}}function L(...t){const e=t.flat(1);return[e.push.bind(e),()=>{e.forEach(r=>{r()})}]}function A(t,e){e||(e={});const{textColor:r,bgColor:o,shouldLog:i}=e,a=i===void 0?!0:i,C=typeof a=="boolean"?()=>a:a,f=(c,s,...u)=>{if(s||C()){const g="font-weight:bold;padding:0 5px;border-radius:100px",[T,S,E]={log:["#0089c3","white","INFO"],error:["#ff0000F0","white","ERR"],warn:["#D38E15","white","WARN"]}[c];console[c](`%c${E} ${Intl.DateTimeFormat("en-GB",{hour:"2-digit",minute:"2-digit",second:"2-digit",fractionalSecondDigits:3,timeZone:"UTC"}).format(new Date)}%c %c${t}`,`${g};background-color:${T};color:${S}`,"",`${g};${r?`color:${r};`:""}${o?`background-color:${o}`:""}`,...u)}};return[["log","forceLog"],["warn","forceWarn"],["error","forceError"]].reduce((c,[s,u])=>(c[s]=f.bind(void 0,s,!1),c[u]=f.bind(void 0,s,!0),c),{})}function k(t){const e=r=>{throw r};return typeof t=="function"?h.BetterPromise.resolve(n.function.pipe(t,n.taskEither.match(e,r=>r))()):n.function.pipe(t,n.either.match(e,r=>r))}function F(t){return Object.assign((...e)=>k(t(...e)),t)}const y=Object.assign((t,e)=>n.function.pipe(n.taskEither.tryCatch(()=>new h.BetterPromise((r,o,i)=>t(a=>r(n.either.right(a)),a=>r(n.either.left(a)),i),e),r=>r),n.taskEither.chainW(n.either.match(n.taskEither.left,n.taskEither.right))),{fn:(t,e)=>y((r,o,i)=>{const a=t(i);n.function.pipe(typeof a=="function"?a:n.taskEither.fromEither(a),n.taskEither.matchW(o,r))()},e)});exports.BetterTaskEither=y;exports.camelToKebab=w;exports.camelToSnake=m;exports.camelToSnakeObjKeys=$;exports.createCbCollector=L;exports.createLogger=A;exports.deepSnakeToCamelObjKeys=l;exports.getStorageValue=K;exports.setStorageValue=j;exports.snakeToCamel=b;exports.snakeToCamelObjKeys=p;exports.snakeToKebab=O;exports.throwifyAnyEither=k;exports.throwifyFpFn=F;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/casing/camelToKebab.ts","../src/casing/camelToSnake.ts","../src/casing/camelToSnakeObjKeys.ts","../src/casing/snakeToCamel.ts","../src/casing/snakeToCamelObjKeys.ts","../src/casing/deepSnakeToCamelObjKeys.ts","../src/casing/snakeToKebab.ts","../src/storage/storage.ts","../src/createCbCollector.ts","../src/createLogger.ts","../src/monads.ts"],"sourcesContent":["/**\n * Converts string value from camel case to kebab case.\n * @param value - value to convert.\n */\nexport function camelToKebab(value: string): string {\n  return value.replace(/[A-Z]/g, match => `-${match.toLowerCase()}`);\n}\n","export type CamelToSnakeCase<T extends string> = T extends `${infer First}${infer Rest}`\n  ? `${First extends Capitalize<First> ? '_' : ''}${Lowercase<First>}${CamelToSnakeCase<Rest>}`\n  : T;\n\n/**\n * Converts string value from camel case to snake case.\n * @param value - value to convert.\n */\nexport function camelToSnake<T extends string>(value: T): CamelToSnakeCase<T> {\n  return value.replace(/[A-Z]/g, match => `_${match.toLowerCase()}`) as CamelToSnakeCase<T>;\n}\n","import { camelToSnake, type CamelToSnakeCase } from '@/casing/camelToSnake.js';\n\nexport type ConvertCamelKeysToSnakeCase<T> = {\n  [K in keyof T as CamelToSnakeCase<string & K>]: T[K];\n};\n\n/**\n * Converts object keys from snake to camel case.\n * @param value - value to convert.\n */\nexport function camelToSnakeObjKeys<T extends object>(value: T): ConvertCamelKeysToSnakeCase<T> {\n  return Object.entries(value).reduce<ConvertCamelKeysToSnakeCase<T>>((acc, [k, v]) => {\n    acc[camelToSnake(k) as keyof ConvertCamelKeysToSnakeCase<T>] = v;\n    return acc;\n  }, {} as ConvertCamelKeysToSnakeCase<T>);\n}\n","export type SnakeToCamelCase<S extends string> =\n  S extends `${infer Head}_${infer Tail}`\n    ? `${Head}${Capitalize<SnakeToCamelCase<Tail>>}`\n    : S;\n\n/**\n * Converts string value from snake case to camel case.\n * @param value - value to convert.\n */\nexport function snakeToCamel<T extends string>(value: T): SnakeToCamelCase<T> {\n  return value.replace(/_[a-z]/g, m => m[1].toUpperCase()) as SnakeToCamelCase<T>;\n}\n","import { snakeToCamel, type SnakeToCamelCase } from '@/casing/snakeToCamel.js';\n\nexport type ConvertSnakeKeysToCamelCase<T> = {\n  [K in keyof T as SnakeToCamelCase<string & K>]: T[K];\n};\n\n/**\n * Converts object keys from snake to camel case.\n * @param value - value to convert.\n */\nexport function snakeToCamelObjKeys<T extends object>(value: T): ConvertSnakeKeysToCamelCase<T> {\n  return Object.entries(value).reduce<ConvertSnakeKeysToCamelCase<T>>((acc, [k, v]) => {\n    acc[snakeToCamel(k) as keyof ConvertSnakeKeysToCamelCase<T>] = v;\n    return acc;\n  }, {} as ConvertSnakeKeysToCamelCase<T>);\n}\n","import type { SnakeToCamelCase } from '@/casing/snakeToCamel.js';\nimport { snakeToCamelObjKeys } from '@/casing/snakeToCamelObjKeys.js';\n\nexport type DeepConvertSnakeKeysToCamelCase<T> = T extends infer U\n  ? U extends object\n    ? U extends Date\n      ? U\n      : U extends (infer Item)[]\n        ? DeepConvertSnakeKeysToCamelCase<Item>[]\n        : {\n          [K in keyof U as SnakeToCamelCase<string & K>]: DeepConvertSnakeKeysToCamelCase<U[K]>\n        } & {}\n    : U\n  : T;\n\n/**\n * Deeply converts object keys from snake to camel case.\n * @param value - value to convert.\n */\nexport function deepSnakeToCamelObjKeys<T extends object>(\n  value: T,\n): DeepConvertSnakeKeysToCamelCase<T> {\n  const camelCased = snakeToCamelObjKeys(value);\n  for (const key in camelCased) {\n    const value = camelCased[key];\n    if (value && typeof value === 'object' && !(value instanceof Date)) {\n      (camelCased as any)[key] = Array.isArray(value)\n        ? value.map(deepSnakeToCamelObjKeys)\n        : deepSnakeToCamelObjKeys(value);\n    }\n  }\n  return camelCased as DeepConvertSnakeKeysToCamelCase<T>;\n}\n","/**\n * Converts string value from snake case to kebab case.\n * @param value - value to convert.\n */\nexport function snakeToKebab(value: string): string {\n  return value.replace(/_([a-z])/g, (_, letter) => `-${letter.toLowerCase()}`);\n}\n","/**\n * Converts a passed storage key to the formatted state.\n * @param key - storage key.\n */\nfunction formatKey(key: string): string {\n  return `tapps/${key}`;\n}\n\n/**\n * Saves value in the storage.\n * @param key - storage key.\n * @param value - storage value.\n */\nexport function setStorageValue<T>(key: string, value: T): void {\n  sessionStorage.setItem(formatKey(key), JSON.stringify(value));\n}\n\n/**\n * Extracts value from the storage.\n * @param key - storage key.\n */\nexport function getStorageValue<R>(key: string): R | undefined {\n  const value = sessionStorage.getItem(formatKey(key));\n  try {\n    return value ? JSON.parse(value) as R : undefined;\n  } catch {\n  }\n}\n","export type CallbackFn = () => void;\n\n/**\n * Returns a tuple, containing function to add cleanup, call cleanup, and flag showing whether\n * cleanup was called. Cleanup will not be performed in case, it was done before.\n */\nexport function createCbCollector(...cbs: (CallbackFn | CallbackFn[])[]): [\n  add: (...fns: CallbackFn[]) => void,\n  call: () => void,\n] {\n  const callbacks = cbs.flat(1);\n\n  return [\n    callbacks.push.bind(callbacks),\n    () => {\n      callbacks.forEach(cb => {\n        cb();\n      });\n    },\n  ];\n}\n","/**\n * Message log level.\n */\nexport type LogLevel = 'log' | 'error' | 'warn';\n\nexport interface LoggerOptions {\n  bgColor?: string;\n  textColor?: string;\n  /**\n   * True if logs are enabled.\n   * @default true\n   */\n  shouldLog?: boolean | (() => boolean);\n}\n\nexport type LoggerFn = (...args: any[]) => void;\nexport type LoggerForceFn = (...args: any[]) => void;\n\nexport interface Logger {\n  /**\n   * Prints an error message into the console.\n   * @param args - items to log.\n   */\n  error: LoggerFn;\n  /**\n   * Prints an error message into the console ignoring the `shouldLog`\n   * constructor option.\n   * @param args - items to log.\n   */\n  forceError: LoggerForceFn;\n  /**\n   * Prints a log message into the console ignoring the `shouldLog` constructor\n   * option.\n   * @param args - items to log.\n   */\n  forceLog: LoggerForceFn;\n  /**\n   * Prints a warning message into the console ignoring the `shouldLog`\n   * constructor option.\n   * @param args - items to log.\n   */\n  forceWarn: LoggerForceFn;\n  /**\n   * Prints a log message into the console.\n   * @param args - items to log.\n   */\n  log: LoggerFn;\n  /**\n   * Prints a warning message into the console.\n   * @param args - items to log.\n   */\n  warn: LoggerFn;\n}\n\n/* @__NO_SIDE_EFFECTS__*/\nexport function createLogger(scope: string, options?: LoggerOptions): Logger {\n  options ||= {};\n  const {\n    textColor,\n    bgColor,\n    shouldLog: optionsShouldLog,\n  } = options;\n  const shouldLogValue = optionsShouldLog === undefined ? true : optionsShouldLog;\n  const shouldLog = typeof shouldLogValue === 'boolean'\n    ? () => shouldLogValue\n    : shouldLogValue;\n\n  /**\n   * Prints a message into the console.\n   * @param level - log level.\n   * @param force - should `shouldLog` value be ignored.\n   * @param args - arguments.\n   */\n  const print = (level: LogLevel, force: boolean, ...args: any[]): void => {\n    if (force || shouldLog()) {\n      const commonCss = 'font-weight:bold;padding:0 5px;border-radius:100px';\n      const [timeBgColor, timeTextColor, prefix] = {\n        log: ['#0089c3', 'white', 'INFO'],\n        error: ['#ff0000F0', 'white', 'ERR'],\n        warn: ['#D38E15', 'white', 'WARN'],\n      }[level];\n      console[level](\n        `%c${prefix} ${\n          Intl\n            .DateTimeFormat('en-GB', {\n              hour: '2-digit',\n              minute: '2-digit',\n              second: '2-digit',\n              fractionalSecondDigits: 3,\n              timeZone: 'UTC',\n            })\n            .format(new Date())\n        }%c %c${scope}`,\n        `${commonCss};background-color:${timeBgColor};color:${timeTextColor}`,\n        '',\n        `${commonCss};${textColor ? `color:${textColor};` : ''}${bgColor ? `background-color:${bgColor}` : ''}`,\n        ...args,\n      );\n    }\n  };\n\n  return ([\n    ['log', 'forceLog'],\n    ['warn', 'forceWarn'],\n    ['error', 'forceError'],\n  ] as const).reduce<Logger>((acc, [level, forceMethod]) => {\n    acc[level] = print.bind(undefined, level, false);\n    acc[forceMethod] = print.bind(undefined, level, true);\n    return acc;\n  }, {} as Logger);\n}\n","import {\n  BetterPromise,\n  type BetterPromiseExecutorContext,\n  type BetterPromiseOptions,\n  type TimeoutError,\n} from 'better-promises';\nimport { either as E, taskEither as TE, function as fn } from 'fp-ts';\n\nimport type { AnyFn } from '@/types/misc.js';\n\nexport type AnyEither<L = any, R = any> = E.Either<L, R> | TE.TaskEither<L, R>;\nexport type AnyFnAnyEither<L = any, R = any> = (...args: any) => AnyEither<L, R>;\n\nexport type RightOfEither<T extends AnyEither> = [T] extends [E.Either<any, infer U>]\n  ? U\n  : T extends TE.TaskEither<any, infer U>\n    ? U\n    : never;\nexport type LeftOfEither<T extends AnyEither> = [T] extends [E.Either<infer U, any>]\n  ? U\n  : T extends TE.TaskEither<infer U, any>\n    ? U\n    : never;\nexport type RightOfReturn<F extends AnyFnAnyEither> = RightOfEither<ReturnType<F>>;\nexport type LeftOfReturn<F extends AnyFnAnyEither> = LeftOfEither<ReturnType<F>>;\n\nexport type MaybeMonadToCommon<T> = [T] extends [E.Either<any, infer U>]\n  ? U\n  : T extends TE.TaskEither<any, infer U>\n    ? BetterPromise<U>\n    : T;\n\nexport type MaybeCommonToMonad<T> = T extends AnyEither\n  ? T\n  : T extends PromiseLike<infer U>\n    ? TE.TaskEither<unknown, U>\n    : E.Either<unknown, T>;\n\nexport type MaybeMonadReturnTypeToCommon<Fn extends AnyFn> = MaybeMonadToCommon<ReturnType<Fn>>;\n\nexport type MaybeCommonReturnTypeToMonad<Fn extends AnyFn> = MaybeCommonToMonad<ReturnType<Fn>>;\n\nexport function throwifyAnyEither<E extends AnyEither>(either: E): MaybeMonadToCommon<E> {\n  const onError = (e: unknown) => {\n    throw e;\n  };\n  return (\n    typeof either === 'function'\n      ? BetterPromise.resolve(fn.pipe(either, TE.match(onError, data => data))())\n      : fn.pipe(either, E.match(onError, data => data))\n  ) as MaybeMonadToCommon<E>;\n}\n\n// #__NO_SIDE_EFFECTS__\nexport function throwifyFpFn<Fn extends AnyFnAnyEither>(\n  fn: Fn,\n): (\n  & ((...args: Parameters<Fn>) => MaybeMonadReturnTypeToCommon<Fn>)\n  & { [K in keyof Fn]: Fn[K] }\n) {\n  return Object.assign(\n    (...args: Parameters<Fn>) => {\n      return throwifyAnyEither(fn(...args)) as MaybeMonadReturnTypeToCommon<Fn>;\n    },\n    fn,\n  );\n}\n\nexport type BetterTaskEitherError = TimeoutError;\n\nexport const BetterTaskEither = /* #__PURE__ */ Object.assign(\n  <E, T>(\n    executor: (\n      resolve: (data: T) => void,\n      reject: (reason: E) => void,\n      context: BetterPromiseExecutorContext<E.Either<E | BetterTaskEitherError, T>>,\n    ) => (void | Promise<void>),\n    options?: BetterPromiseOptions,\n  ): TE.TaskEither<E | BetterTaskEitherError, T> => {\n    return fn.pipe(\n      TE.tryCatch(\n        () => {\n          return new BetterPromise<E.Either<E, T>>((res, _rej, context) => {\n            return executor(\n              result => res(E.right(result)),\n              error => res(E.left(error)),\n              context,\n            );\n          }, options);\n        },\n        e => e as E,\n      ),\n      TE.chainW(E.match(TE.left, TE.right<E, T>)),\n    );\n  },\n  {\n    fn: <E, T>(\n      fn_: (context: BetterPromiseExecutorContext<E.Either<E | BetterTaskEitherError, T>>) => (\n        E.Either<E, T> | TE.TaskEither<E, T>\n      ),\n      options?: BetterPromiseOptions,\n    ): TE.TaskEither<E | BetterTaskEitherError, T> => {\n      return BetterTaskEither<E, T>((resolve, reject, context) => {\n        const result = fn_(context);\n        void fn.pipe(\n          typeof result === 'function' ? result : TE.fromEither(result),\n          TE.matchW(reject, resolve),\n        )();\n      }, options);\n    },\n  },\n);\n"],"names":["camelToKebab","value","match","camelToSnake","camelToSnakeObjKeys","acc","k","v","snakeToCamel","m","snakeToCamelObjKeys","deepSnakeToCamelObjKeys","camelCased","key","snakeToKebab","_","letter","formatKey","setStorageValue","getStorageValue","createCbCollector","cbs","callbacks","cb","createLogger","scope","options","textColor","bgColor","optionsShouldLog","shouldLogValue","shouldLog","print","level","force","args","commonCss","timeBgColor","timeTextColor","prefix","forceMethod","throwifyAnyEither","either","onError","e","BetterPromise","fn","TE","data","E","throwifyFpFn","BetterTaskEither","executor","res","_rej","context","result","error","fn_","resolve","reject"],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,139 @@
+import { BetterPromise as d } from "better-promises";
+import { function as f, taskEither as i, either as u } from "fp-ts";
+function L(t) {
+  return t.replace(/[A-Z]/g, (e) => `-${e.toLowerCase()}`);
+}
+function $(t) {
+  return t.replace(/[A-Z]/g, (e) => `_${e.toLowerCase()}`);
+}
+function x(t) {
+  return Object.entries(t).reduce((e, [o, r]) => (e[$(o)] = r, e), {});
+}
+function k(t) {
+  return t.replace(/_[a-z]/g, (e) => e[1].toUpperCase());
+}
+function S(t) {
+  return Object.entries(t).reduce((e, [o, r]) => (e[k(o)] = r, e), {});
+}
+function m(t) {
+  const e = S(t);
+  for (const o in e) {
+    const r = e[o];
+    r && typeof r == "object" && !(r instanceof Date) && (e[o] = Array.isArray(r) ? r.map(m) : m(r));
+  }
+  return e;
+}
+function A(t) {
+  return t.replace(/_([a-z])/g, (e, o) => `-${o.toLowerCase()}`);
+}
+function h(t) {
+  return `tapps/${t}`;
+}
+function K(t, e) {
+  sessionStorage.setItem(h(t), JSON.stringify(e));
+}
+function _(t) {
+  const e = sessionStorage.getItem(h(t));
+  try {
+    return e ? JSON.parse(e) : void 0;
+  } catch {
+  }
+}
+function v(...t) {
+  const e = t.flat(1);
+  return [
+    e.push.bind(e),
+    () => {
+      e.forEach((o) => {
+        o();
+      });
+    }
+  ];
+}
+// @__NO_SIDE_EFFECTS__
+function D(t, e) {
+  e || (e = {});
+  const {
+    textColor: o,
+    bgColor: r,
+    shouldLog: c
+  } = e, n = c === void 0 ? !0 : c, b = typeof n == "boolean" ? () => n : n, g = (a, s, ...l) => {
+    if (s || b()) {
+      const p = "font-weight:bold;padding:0 5px;border-radius:100px", [y, C, w] = {
+        log: ["#0089c3", "white", "INFO"],
+        error: ["#ff0000F0", "white", "ERR"],
+        warn: ["#D38E15", "white", "WARN"]
+      }[a];
+      console[a](
+        `%c${w} ${Intl.DateTimeFormat("en-GB", {
+          hour: "2-digit",
+          minute: "2-digit",
+          second: "2-digit",
+          fractionalSecondDigits: 3,
+          timeZone: "UTC"
+        }).format(/* @__PURE__ */ new Date())}%c %c${t}`,
+        `${p};background-color:${y};color:${C}`,
+        "",
+        `${p};${o ? `color:${o};` : ""}${r ? `background-color:${r}` : ""}`,
+        ...l
+      );
+    }
+  };
+  return [
+    ["log", "forceLog"],
+    ["warn", "forceWarn"],
+    ["error", "forceError"]
+  ].reduce((a, [s, l]) => (a[s] = g.bind(void 0, s, !1), a[l] = g.bind(void 0, s, !0), a), {});
+}
+function T(t) {
+  const e = (o) => {
+    throw o;
+  };
+  return typeof t == "function" ? d.resolve(f.pipe(t, i.match(e, (o) => o))()) : f.pipe(t, u.match(e, (o) => o));
+}
+// @__NO_SIDE_EFFECTS__
+function F(t) {
+  return Object.assign(
+    (...e) => T(t(...e)),
+    t
+  );
+}
+const O = /* @__PURE__ */ Object.assign(
+  (t, e) => f.pipe(
+    i.tryCatch(
+      () => new d((o, r, c) => t(
+        (n) => o(u.right(n)),
+        (n) => o(u.left(n)),
+        c
+      ), e),
+      (o) => o
+    ),
+    i.chainW(u.match(i.left, i.right))
+  ),
+  {
+    fn: (t, e) => O((o, r, c) => {
+      const n = t(c);
+      f.pipe(
+        typeof n == "function" ? n : i.fromEither(n),
+        i.matchW(r, o)
+      )();
+    }, e)
+  }
+);
+export {
+  O as BetterTaskEither,
+  L as camelToKebab,
+  $ as camelToSnake,
+  x as camelToSnakeObjKeys,
+  v as createCbCollector,
+  D as createLogger,
+  m as deepSnakeToCamelObjKeys,
+  _ as getStorageValue,
+  K as setStorageValue,
+  k as snakeToCamel,
+  S as snakeToCamelObjKeys,
+  A as snakeToKebab,
+  T as throwifyAnyEither,
+  F as throwifyFpFn
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/casing/camelToKebab.ts","../src/casing/camelToSnake.ts","../src/casing/camelToSnakeObjKeys.ts","../src/casing/snakeToCamel.ts","../src/casing/snakeToCamelObjKeys.ts","../src/casing/deepSnakeToCamelObjKeys.ts","../src/casing/snakeToKebab.ts","../src/storage/storage.ts","../src/createCbCollector.ts","../src/createLogger.ts","../src/monads.ts"],"sourcesContent":["/**\n * Converts string value from camel case to kebab case.\n * @param value - value to convert.\n */\nexport function camelToKebab(value: string): string {\n  return value.replace(/[A-Z]/g, match => `-${match.toLowerCase()}`);\n}\n","export type CamelToSnakeCase<T extends string> = T extends `${infer First}${infer Rest}`\n  ? `${First extends Capitalize<First> ? '_' : ''}${Lowercase<First>}${CamelToSnakeCase<Rest>}`\n  : T;\n\n/**\n * Converts string value from camel case to snake case.\n * @param value - value to convert.\n */\nexport function camelToSnake<T extends string>(value: T): CamelToSnakeCase<T> {\n  return value.replace(/[A-Z]/g, match => `_${match.toLowerCase()}`) as CamelToSnakeCase<T>;\n}\n","import { camelToSnake, type CamelToSnakeCase } from '@/casing/camelToSnake.js';\n\nexport type ConvertCamelKeysToSnakeCase<T> = {\n  [K in keyof T as CamelToSnakeCase<string & K>]: T[K];\n};\n\n/**\n * Converts object keys from snake to camel case.\n * @param value - value to convert.\n */\nexport function camelToSnakeObjKeys<T extends object>(value: T): ConvertCamelKeysToSnakeCase<T> {\n  return Object.entries(value).reduce<ConvertCamelKeysToSnakeCase<T>>((acc, [k, v]) => {\n    acc[camelToSnake(k) as keyof ConvertCamelKeysToSnakeCase<T>] = v;\n    return acc;\n  }, {} as ConvertCamelKeysToSnakeCase<T>);\n}\n","export type SnakeToCamelCase<S extends string> =\n  S extends `${infer Head}_${infer Tail}`\n    ? `${Head}${Capitalize<SnakeToCamelCase<Tail>>}`\n    : S;\n\n/**\n * Converts string value from snake case to camel case.\n * @param value - value to convert.\n */\nexport function snakeToCamel<T extends string>(value: T): SnakeToCamelCase<T> {\n  return value.replace(/_[a-z]/g, m => m[1].toUpperCase()) as SnakeToCamelCase<T>;\n}\n","import { snakeToCamel, type SnakeToCamelCase } from '@/casing/snakeToCamel.js';\n\nexport type ConvertSnakeKeysToCamelCase<T> = {\n  [K in keyof T as SnakeToCamelCase<string & K>]: T[K];\n};\n\n/**\n * Converts object keys from snake to camel case.\n * @param value - value to convert.\n */\nexport function snakeToCamelObjKeys<T extends object>(value: T): ConvertSnakeKeysToCamelCase<T> {\n  return Object.entries(value).reduce<ConvertSnakeKeysToCamelCase<T>>((acc, [k, v]) => {\n    acc[snakeToCamel(k) as keyof ConvertSnakeKeysToCamelCase<T>] = v;\n    return acc;\n  }, {} as ConvertSnakeKeysToCamelCase<T>);\n}\n","import type { SnakeToCamelCase } from '@/casing/snakeToCamel.js';\nimport { snakeToCamelObjKeys } from '@/casing/snakeToCamelObjKeys.js';\n\nexport type DeepConvertSnakeKeysToCamelCase<T> = T extends infer U\n  ? U extends object\n    ? U extends Date\n      ? U\n      : U extends (infer Item)[]\n        ? DeepConvertSnakeKeysToCamelCase<Item>[]\n        : {\n          [K in keyof U as SnakeToCamelCase<string & K>]: DeepConvertSnakeKeysToCamelCase<U[K]>\n        } & {}\n    : U\n  : T;\n\n/**\n * Deeply converts object keys from snake to camel case.\n * @param value - value to convert.\n */\nexport function deepSnakeToCamelObjKeys<T extends object>(\n  value: T,\n): DeepConvertSnakeKeysToCamelCase<T> {\n  const camelCased = snakeToCamelObjKeys(value);\n  for (const key in camelCased) {\n    const value = camelCased[key];\n    if (value && typeof value === 'object' && !(value instanceof Date)) {\n      (camelCased as any)[key] = Array.isArray(value)\n        ? value.map(deepSnakeToCamelObjKeys)\n        : deepSnakeToCamelObjKeys(value);\n    }\n  }\n  return camelCased as DeepConvertSnakeKeysToCamelCase<T>;\n}\n","/**\n * Converts string value from snake case to kebab case.\n * @param value - value to convert.\n */\nexport function snakeToKebab(value: string): string {\n  return value.replace(/_([a-z])/g, (_, letter) => `-${letter.toLowerCase()}`);\n}\n","/**\n * Converts a passed storage key to the formatted state.\n * @param key - storage key.\n */\nfunction formatKey(key: string): string {\n  return `tapps/${key}`;\n}\n\n/**\n * Saves value in the storage.\n * @param key - storage key.\n * @param value - storage value.\n */\nexport function setStorageValue<T>(key: string, value: T): void {\n  sessionStorage.setItem(formatKey(key), JSON.stringify(value));\n}\n\n/**\n * Extracts value from the storage.\n * @param key - storage key.\n */\nexport function getStorageValue<R>(key: string): R | undefined {\n  const value = sessionStorage.getItem(formatKey(key));\n  try {\n    return value ? JSON.parse(value) as R : undefined;\n  } catch {\n  }\n}\n","export type CallbackFn = () => void;\n\n/**\n * Returns a tuple, containing function to add cleanup, call cleanup, and flag showing whether\n * cleanup was called. Cleanup will not be performed in case, it was done before.\n */\nexport function createCbCollector(...cbs: (CallbackFn | CallbackFn[])[]): [\n  add: (...fns: CallbackFn[]) => void,\n  call: () => void,\n] {\n  const callbacks = cbs.flat(1);\n\n  return [\n    callbacks.push.bind(callbacks),\n    () => {\n      callbacks.forEach(cb => {\n        cb();\n      });\n    },\n  ];\n}\n","/**\n * Message log level.\n */\nexport type LogLevel = 'log' | 'error' | 'warn';\n\nexport interface LoggerOptions {\n  bgColor?: string;\n  textColor?: string;\n  /**\n   * True if logs are enabled.\n   * @default true\n   */\n  shouldLog?: boolean | (() => boolean);\n}\n\nexport type LoggerFn = (...args: any[]) => void;\nexport type LoggerForceFn = (...args: any[]) => void;\n\nexport interface Logger {\n  /**\n   * Prints an error message into the console.\n   * @param args - items to log.\n   */\n  error: LoggerFn;\n  /**\n   * Prints an error message into the console ignoring the `shouldLog`\n   * constructor option.\n   * @param args - items to log.\n   */\n  forceError: LoggerForceFn;\n  /**\n   * Prints a log message into the console ignoring the `shouldLog` constructor\n   * option.\n   * @param args - items to log.\n   */\n  forceLog: LoggerForceFn;\n  /**\n   * Prints a warning message into the console ignoring the `shouldLog`\n   * constructor option.\n   * @param args - items to log.\n   */\n  forceWarn: LoggerForceFn;\n  /**\n   * Prints a log message into the console.\n   * @param args - items to log.\n   */\n  log: LoggerFn;\n  /**\n   * Prints a warning message into the console.\n   * @param args - items to log.\n   */\n  warn: LoggerFn;\n}\n\n/* @__NO_SIDE_EFFECTS__*/\nexport function createLogger(scope: string, options?: LoggerOptions): Logger {\n  options ||= {};\n  const {\n    textColor,\n    bgColor,\n    shouldLog: optionsShouldLog,\n  } = options;\n  const shouldLogValue = optionsShouldLog === undefined ? true : optionsShouldLog;\n  const shouldLog = typeof shouldLogValue === 'boolean'\n    ? () => shouldLogValue\n    : shouldLogValue;\n\n  /**\n   * Prints a message into the console.\n   * @param level - log level.\n   * @param force - should `shouldLog` value be ignored.\n   * @param args - arguments.\n   */\n  const print = (level: LogLevel, force: boolean, ...args: any[]): void => {\n    if (force || shouldLog()) {\n      const commonCss = 'font-weight:bold;padding:0 5px;border-radius:100px';\n      const [timeBgColor, timeTextColor, prefix] = {\n        log: ['#0089c3', 'white', 'INFO'],\n        error: ['#ff0000F0', 'white', 'ERR'],\n        warn: ['#D38E15', 'white', 'WARN'],\n      }[level];\n      console[level](\n        `%c${prefix} ${\n          Intl\n            .DateTimeFormat('en-GB', {\n              hour: '2-digit',\n              minute: '2-digit',\n              second: '2-digit',\n              fractionalSecondDigits: 3,\n              timeZone: 'UTC',\n            })\n            .format(new Date())\n        }%c %c${scope}`,\n        `${commonCss};background-color:${timeBgColor};color:${timeTextColor}`,\n        '',\n        `${commonCss};${textColor ? `color:${textColor};` : ''}${bgColor ? `background-color:${bgColor}` : ''}`,\n        ...args,\n      );\n    }\n  };\n\n  return ([\n    ['log', 'forceLog'],\n    ['warn', 'forceWarn'],\n    ['error', 'forceError'],\n  ] as const).reduce<Logger>((acc, [level, forceMethod]) => {\n    acc[level] = print.bind(undefined, level, false);\n    acc[forceMethod] = print.bind(undefined, level, true);\n    return acc;\n  }, {} as Logger);\n}\n","import {\n  BetterPromise,\n  type BetterPromiseExecutorContext,\n  type BetterPromiseOptions,\n  type TimeoutError,\n} from 'better-promises';\nimport { either as E, taskEither as TE, function as fn } from 'fp-ts';\n\nimport type { AnyFn } from '@/types/misc.js';\n\nexport type AnyEither<L = any, R = any> = E.Either<L, R> | TE.TaskEither<L, R>;\nexport type AnyFnAnyEither<L = any, R = any> = (...args: any) => AnyEither<L, R>;\n\nexport type RightOfEither<T extends AnyEither> = [T] extends [E.Either<any, infer U>]\n  ? U\n  : T extends TE.TaskEither<any, infer U>\n    ? U\n    : never;\nexport type LeftOfEither<T extends AnyEither> = [T] extends [E.Either<infer U, any>]\n  ? U\n  : T extends TE.TaskEither<infer U, any>\n    ? U\n    : never;\nexport type RightOfReturn<F extends AnyFnAnyEither> = RightOfEither<ReturnType<F>>;\nexport type LeftOfReturn<F extends AnyFnAnyEither> = LeftOfEither<ReturnType<F>>;\n\nexport type MaybeMonadToCommon<T> = [T] extends [E.Either<any, infer U>]\n  ? U\n  : T extends TE.TaskEither<any, infer U>\n    ? BetterPromise<U>\n    : T;\n\nexport type MaybeCommonToMonad<T> = T extends AnyEither\n  ? T\n  : T extends PromiseLike<infer U>\n    ? TE.TaskEither<unknown, U>\n    : E.Either<unknown, T>;\n\nexport type MaybeMonadReturnTypeToCommon<Fn extends AnyFn> = MaybeMonadToCommon<ReturnType<Fn>>;\n\nexport type MaybeCommonReturnTypeToMonad<Fn extends AnyFn> = MaybeCommonToMonad<ReturnType<Fn>>;\n\nexport function throwifyAnyEither<E extends AnyEither>(either: E): MaybeMonadToCommon<E> {\n  const onError = (e: unknown) => {\n    throw e;\n  };\n  return (\n    typeof either === 'function'\n      ? BetterPromise.resolve(fn.pipe(either, TE.match(onError, data => data))())\n      : fn.pipe(either, E.match(onError, data => data))\n  ) as MaybeMonadToCommon<E>;\n}\n\n// #__NO_SIDE_EFFECTS__\nexport function throwifyFpFn<Fn extends AnyFnAnyEither>(\n  fn: Fn,\n): (\n  & ((...args: Parameters<Fn>) => MaybeMonadReturnTypeToCommon<Fn>)\n  & { [K in keyof Fn]: Fn[K] }\n) {\n  return Object.assign(\n    (...args: Parameters<Fn>) => {\n      return throwifyAnyEither(fn(...args)) as MaybeMonadReturnTypeToCommon<Fn>;\n    },\n    fn,\n  );\n}\n\nexport type BetterTaskEitherError = TimeoutError;\n\nexport const BetterTaskEither = /* #__PURE__ */ Object.assign(\n  <E, T>(\n    executor: (\n      resolve: (data: T) => void,\n      reject: (reason: E) => void,\n      context: BetterPromiseExecutorContext<E.Either<E | BetterTaskEitherError, T>>,\n    ) => (void | Promise<void>),\n    options?: BetterPromiseOptions,\n  ): TE.TaskEither<E | BetterTaskEitherError, T> => {\n    return fn.pipe(\n      TE.tryCatch(\n        () => {\n          return new BetterPromise<E.Either<E, T>>((res, _rej, context) => {\n            return executor(\n              result => res(E.right(result)),\n              error => res(E.left(error)),\n              context,\n            );\n          }, options);\n        },\n        e => e as E,\n      ),\n      TE.chainW(E.match(TE.left, TE.right<E, T>)),\n    );\n  },\n  {\n    fn: <E, T>(\n      fn_: (context: BetterPromiseExecutorContext<E.Either<E | BetterTaskEitherError, T>>) => (\n        E.Either<E, T> | TE.TaskEither<E, T>\n      ),\n      options?: BetterPromiseOptions,\n    ): TE.TaskEither<E | BetterTaskEitherError, T> => {\n      return BetterTaskEither<E, T>((resolve, reject, context) => {\n        const result = fn_(context);\n        void fn.pipe(\n          typeof result === 'function' ? result : TE.fromEither(result),\n          TE.matchW(reject, resolve),\n        )();\n      }, options);\n    },\n  },\n);\n"],"names":["camelToKebab","value","match","camelToSnake","camelToSnakeObjKeys","acc","k","v","snakeToCamel","m","snakeToCamelObjKeys","deepSnakeToCamelObjKeys","camelCased","key","snakeToKebab","_","letter","formatKey","setStorageValue","getStorageValue","createCbCollector","cbs","callbacks","cb","createLogger","scope","options","textColor","bgColor","optionsShouldLog","shouldLogValue","shouldLog","print","level","force","args","commonCss","timeBgColor","timeTextColor","prefix","forceMethod","throwifyAnyEither","either","onError","e","BetterPromise","fn","TE","data","E","throwifyFpFn","BetterTaskEither","executor","res","_rej","context","result","error","fn_","resolve","reject"],"mappings":"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"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@vbotma/toolkit",
+  "version": "1.0.4",
+  "description": "Internal toolkit used in the @vbot packages.",
+  "keywords": [
+    "vbot-mini-apps",
+    "typescript"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/dts/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/dts/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.cjs"
+    }
+  },
+  "devDependencies": {
+    "tsconfig": "0.0.2",
+    "test-utils": "0.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "better-promises": "^1.0.0",
+    "fp-ts": "^2.16.11"
+  },
+  "scripts": {
+    "test": "vitest --run",
+    "lint": "eslint src",
+    "lint:fix": "pnpm run lint --fix",
+    "typecheck": "tsc --noEmit -p tsconfig.build.json",
+    "build": "vite build -c vite.config.ts"
+  }
+}