@zajno/common 2.0.0-beta.2 → 2.0.1

package/coverage/clover.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<coverage generated="1667121704830" clover="3.2.0">
-  <project timestamp="1667121704830" name="All files">
+<coverage generated="1667688309810" clover="3.2.0">
+  <project timestamp="1667688309810" name="All files">
     <metrics statements="1106" coveredstatements="944" conditionals="713" coveredconditionals="560" methods="284" coveredmethods="219" elements="2103" coveredelements="1723" complexity="0" loc="1106" ncloc="1106" packages="14" files="42" classes="42"/>
     <package name="__tests__.helpers">
       <metrics statements="8" coveredstatements="8" conditionals="0" coveredconditionals="0" methods="2" coveredmethods="2"/>

package/coverage/lcov-report/__tests__/helpers/expect.ts.html

@@ -79,7 +79,7 @@ export const expectAnythingOrNothing = expect.toBeOneOf([expect.anything(), unde
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/__tests__/helpers/index.html

@@ -116,7 +116,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/__tests__/helpers/main.ts.html

@@ -106,7 +106,7 @@ export const toArbitrary = (fakerGen) => {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/async/arrays.ts.html

@@ -184,7 +184,7 @@ export async function <span class="fstat-no" title="function not covered" >mapAs
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/async/index.html

@@ -116,7 +116,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/async/timeout.ts.html

@@ -322,7 +322,7 @@ export function timeoutPromise<T>(p: Promise<T>, timeoutMs: number,
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/dates/calc.ts.html

@@ -286,7 +286,7 @@ export function clamp(d: Date, low: Date, high: Date) {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/dates/convert.ts.html

@@ -643,7 +643,7 @@ export function getDaysStreak(dates: number[], descentOrder: boolean): number {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/dates/datex.ts.html

@@ -196,7 +196,7 @@ export namespace DateX {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/dates/format.ts.html

@@ -388,7 +388,7 @@ export namespace Format {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/dates/index.html

@@ -236,7 +236,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/dates/index.ts.html

@@ -97,7 +97,7 @@ export * from './yearDate';
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/dates/parse.ts.html

@@ -142,7 +142,7 @@ export namespace Parse {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/dates/period.ts.html

@@ -139,7 +139,7 @@ export namespace Period {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/dates/shift.ts.html

@@ -340,7 +340,7 @@ export function isSame(d1: Date | number, d2: Date | number, g: Granularity, loc
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/dates/types.ts.html

@@ -166,7 +166,7 @@ export namespace ConstantGranularity {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/dates/yearDate.ts.html

@@ -178,7 +178,7 @@ export namespace YearDate {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/fields/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/fields/update.ts.html

@@ -442,7 +442,7 @@ export function updateArray<T>(
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/functions/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/functions/safeCall.ts.html

@@ -88,7 +88,7 @@ export function safeCall<T extends (...args: any) => any>(cb: T | undef
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/index.html

@@ -296,7 +296,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/lazy/index.html

@@ -116,7 +116,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/lazy/promise.ts.html

@@ -226,7 +226,7 @@ export class LazyPromise<T> implements IDisposable {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/lazy/singleton.ts.html

@@ -166,7 +166,7 @@ export class Lazy<T> implements IDisposable {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/logger/batch.ts.html

@@ -97,7 +97,7 @@ export function batchLoggers(...loggers: ILogger[]): ILogger {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/logger/console.ts.html

@@ -226,7 +226,7 @@ export class BufferedConsoleLogger implements ILogger {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/logger/index.html

@@ -161,7 +161,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/logger/index.ts.html

@@ -283,7 +283,7 @@ function _createImplementation(overrideMode: typeof Mode = undefined): ILogger {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/logger/named.ts.html

@@ -211,7 +211,7 @@ export abstract class NamedLogger implements ILogger, ILoggerSwitchable {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/logger/proxy.ts.html

@@ -157,7 +157,7 @@ export class ProxyLogger extends NamedLogger {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/math/arrays.ts.html

@@ -892,7 +892,7 @@ export function <span class="fstat-no" title="function not covered" >chunkify&lt
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/math/calc.ts.html

@@ -277,7 +277,7 @@ export function <span class="fstat-no" title="function not covered" >badRandomSt
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/math/distribution.ts.html

@@ -130,7 +130,7 @@ export function extendDistribution<T extends keyof any>(count: number, typ
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/math/index.html

@@ -146,7 +146,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/math/index.ts.html

@@ -151,7 +151,7 @@ export function format(n: number, digits?: number) {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/observing/event.ts.html

@@ -343,7 +343,7 @@ export function oneTimeSubscription<T>(e: IEvent<T>, filter?: Predic
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/observing/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/structures/helpers/enum.ts.html

@@ -439,7 +439,7 @@ export class EnumBitwiseHelper<T extends number> extends EnumHelper<T&g
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/structures/helpers/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/structures/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/structures/queue/index.html

@@ -116,7 +116,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/structures/queue/parallel.ts.html

@@ -496,7 +496,7 @@ export class ParallelQueue {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/structures/queue/tasks.ts.html

@@ -343,7 +343,7 @@ export class TasksQueue<T> {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/structures/tempoCache.ts.html

@@ -124,7 +124,7 @@ export class TempoCache<T> {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/types/comparator.ts.html

@@ -88,7 +88,7 @@ export namespace Comparator {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/types/getter.ts.html

@@ -112,7 +112,7 @@ export namespace Getter {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/types/index.html

@@ -131,7 +131,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/types/index.ts.html

@@ -72,7 +72,15 @@
 <a name='L7'></a><a href='#L7'>7</a>
 <a name='L8'></a><a href='#L8'>8</a>
 <a name='L9'></a><a href='#L9'>9</a>
-<a name='L10'></a><a href='#L10'>10</a></td><td class="line-coverage quiet"><span class="cline-any cline-yes">6x</span>
+<a name='L10'></a><a href='#L10'>10</a>
+<a name='L11'></a><a href='#L11'>11</a>
+<a name='L12'></a><a href='#L12'>12</a>
+<a name='L13'></a><a href='#L13'>13</a>
+<a name='L14'></a><a href='#L14'>14</a>
+<a name='L15'></a><a href='#L15'>15</a>
+<a name='L16'></a><a href='#L16'>16</a>
+<a name='L17'></a><a href='#L17'>17</a>
+<a name='L18'></a><a href='#L18'>18</a></td><td class="line-coverage quiet"><span class="cline-any cline-yes">6x</span>
 <span class="cline-any cline-yes">6x</span>
 <span class="cline-any cline-yes">6x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -81,6 +89,14 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">export * from './deep';
 export * from './getter';
 export * from './comparator';
@@ -90,6 +106,14 @@ export type Predicate&lt;T&gt; = (value: T) =&gt; boolean;
 export type TypedKeys&lt;T extends Object, K&gt; = {
     [P in keyof T]: T[P] extends K ? P : never
 }[keyof T];
+&nbsp;
+export type ArrayTail&lt;T&gt; = T extends [any, ...infer P] ? [...P] : T;
+&nbsp;
+export type NestedPick&lt;T, K extends any[]&gt; = K extends Array&lt;never&gt; // empty arr
+    ? T
+    : {
+        [P in K[0]]: P extends keyof T ? NestedPick&lt;T[P], ArrayTail&lt;K&gt;&gt; : never;
+    };
 &nbsp;</pre></td></tr></table></pre>
 
                 <div class='push'></div><!-- for sticky footer -->
@@ -97,7 +121,7 @@ export type TypedKeys&lt;T extends Object, K&gt; = {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/validation/ValidationErrors.ts.html

@@ -148,7 +148,7 @@ export namespace <span class="branch-1 cbranch-no" title="branch not covered" >V
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/validation/creditCard.ts.html

@@ -145,7 +145,7 @@ export default {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/validation/helpers.ts.html

@@ -211,7 +211,7 @@ export function <span class="fstat-no" title="function not covered" >validateObj
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/validation/index.html

@@ -191,7 +191,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/validation/index.ts.html

@@ -97,7 +97,7 @@ export * from './helpers';
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/validation/types.ts.html

@@ -124,7 +124,7 @@ export class ValidationError<TErrors = ValidationErrors> extends Error {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/validation/validators.ts.html

@@ -235,7 +235,7 @@ export const Validators = {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/validation/wrappers.ts.html

@@ -148,7 +148,7 @@ export const Wrappers = {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2022-10-30T09:21:44.796Z
+                at 2022-11-05T22:45:09.773Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/lib/async/misc.d.ts

@@ -0,0 +1,3 @@
+export declare function OptAwait<T>(cb: () => (T | Promise<T>), doAwait: boolean): Promise<T>;
+export declare function chain(...promises: (() => Promise<void>)[]): Promise<void>;
+//# sourceMappingURL=misc.d.ts.map

package/lib/async/misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../src/async/misc.ts"],"names":[],"mappings":"AACA,wBAAsB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1F;AAED,wBAAsB,KAAK,CAAC,GAAG,QAAQ,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,iBAK/D"}

package/lib/async/misc.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chain = exports.OptAwait = void 0;
+async function OptAwait(cb, doAwait) {
+    return cb && (doAwait ? (await cb()) : cb());
+}
+exports.OptAwait = OptAwait;
+async function chain(...promises) {
+    const applyAsync = (acc, val) => acc.then(val);
+    return promises.reduce(applyAsync, Promise.resolve());
+}
+exports.chain = chain;
+//# sourceMappingURL=misc.js.map

package/lib/async/misc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../src/async/misc.ts"],"names":[],"mappings":";;;AACO,KAAK,UAAU,QAAQ,CAAI,EAA0B,EAAE,OAAgB;IAC1E,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAFD,4BAEC;AAEM,KAAK,UAAU,KAAK,CAAC,GAAG,QAAiC;IAE5D,MAAM,UAAU,GAAG,CAAC,GAAkB,EAAE,GAAwB,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEnF,OAAO,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAC1D,CAAC;AALD,sBAKC"}

package/lib/models/File.d.ts

@@ -0,0 +1,10 @@
+export declare type FileMetadata = {
+    name: string;
+    /** size in bytes */
+    size: number;
+    /** refers to MIME type */
+    type: string;
+    format?: string;
+    lang?: string;
+};
+//# sourceMappingURL=File.d.ts.map

package/lib/models/File.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"File.d.ts","sourceRoot":"","sources":["../../src/models/File.ts"],"names":[],"mappings":"AACA,oBAAY,YAAY,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IAEb,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/lib/models/File.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=File.js.map

package/lib/models/File.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"File.js","sourceRoot":"","sources":["../../src/models/File.ts"],"names":[],"mappings":""}

package/lib/observing/progressTracker.d.ts

@@ -0,0 +1,24 @@
+import { ILogger } from '../logger';
+export declare class ProgressTracker {
+    readonly log: boolean | ILogger;
+    private readonly _firstTimestamp;
+    private _lastTimestamp;
+    private _lastCompleted;
+    private _completed;
+    private _total;
+    private readonly _deltas;
+    private readonly _changed;
+    constructor(log?: boolean | ILogger);
+    get changed(): import("./event").IEvent<{
+        completed: number;
+        total: number;
+        currentProgress: number;
+        totalElapsedMs: number;
+        totalEstimatedMs: number;
+    }>;
+    private get logger();
+    setTotal(total: number): this;
+    add(amount?: number, restart?: boolean): void;
+    track(completed: number, total: number): void;
+}
+//# sourceMappingURL=progressTracker.d.ts.map

package/lib/observing/progressTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressTracker.d.ts","sourceRoot":"","sources":["../../src/observing/progressTracker.ts"],"names":[],"mappings":"AAEA,OAAe,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG5C,qBAAa,eAAe;IAaZ,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAX3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAc;IAC9C,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,cAAc,CAAgB;IAEtC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,MAAM,CAAK;IAEnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IAExC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgI;gBAEpI,GAAG,GAAE,OAAO,GAAG,OAAc;IAElD,IAAW,OAAO;;;;;;OAAqC;IAEvD,OAAO,KAAK,MAAM,GAIjB;IAEM,QAAQ,CAAC,KAAK,EAAE,MAAM;IAKtB,GAAG,CAAC,MAAM,SAAI,EAAE,OAAO,UAAQ;IAK/B,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAuChD"}

package/lib/observing/progressTracker.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgressTracker = void 0;
+const tslib_1 = require("tslib");
+const DateHelpers = tslib_1.__importStar(require("../dates"));
+const MathHelpers = tslib_1.__importStar(require("../math"));
+const logger_1 = tslib_1.__importDefault(require("../logger"));
+const event_1 = require("./event");
+class ProgressTracker {
+    constructor(log = true) {
+        this.log = log;
+        this._firstTimestamp = Date.now();
+        this._lastTimestamp = null;
+        this._lastCompleted = null;
+        this._completed = 0;
+        this._total = 0;
+        this._deltas = [];
+        this._changed = new event_1.Event();
+    }
+    get changed() { return this._changed.expose(); }
+    get logger() {
+        return this.log === true
+            ? logger_1.default
+            : (this.log || null);
+    }
+    setTotal(total) {
+        this._total = total;
+        return this;
+    }
+    add(amount = 1, restart = false) {
+        this._completed = restart ? amount : (this._completed + amount);
+        this.track(this._completed, this._total);
+    }
+    track(completed, total) {
+        if (!this._lastTimestamp) {
+            this._lastTimestamp = this._firstTimestamp;
+        }
+        const elapsedDelta = Date.now() - this._lastTimestamp;
+        const completedDelta = completed - (this._lastCompleted || 0);
+        this._lastCompleted = completed;
+        const timePerCompleted = completedDelta > 0 ? (elapsedDelta / completedDelta) : 0;
+        this._deltas.push(timePerCompleted);
+        if (this._deltas.length > 20) {
+            this._deltas.shift();
+        }
+        const currentProgress = Math.floor(completed / (total || 100) * 100);
+        const itemsLeft = total - completed;
+        const leftProgressTime = itemsLeft * (MathHelpers.arrayAverage(this._deltas, true) || 1000);
+        this._lastTimestamp = Date.now();
+        const totalElapsedMs = this._lastTimestamp - this._firstTimestamp;
+        if (this.log) {
+            const totalElapsed = msToString(totalElapsedMs);
+            const totalEstimated = msToString(leftProgressTime);
+            this.logger.log(`Progress: ${completed}/${total} ${totalElapsed}/${totalEstimated} => ${currentProgress}%`);
+        }
+        this._changed.trigger({
+            completed,
+            total,
+            currentProgress,
+            totalElapsedMs,
+            totalEstimatedMs: leftProgressTime,
+        });
+    }
+}
+exports.ProgressTracker = ProgressTracker;
+function msToString(ms) {
+    const decs = DateHelpers.decomposeMs(ms, 'second', 'minute', 'hour');
+    const nf = (n) => n.toString().padStart(2, '0');
+    return `${nf(decs.hour)}:${nf(decs.minute)}:${nf(decs.second)}`;
+}
+//# sourceMappingURL=progressTracker.js.map

package/lib/observing/progressTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressTracker.js","sourceRoot":"","sources":["../../src/observing/progressTracker.ts"],"names":[],"mappings":"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"}

package/lib/types/index.d.ts

@@ -5,4 +5,8 @@ export declare type Predicate<T> = (value: T) => boolean;
 export declare type TypedKeys<T extends Object, K> = {
     [P in keyof T]: T[P] extends K ? P : never;
 }[keyof T];
+export declare type ArrayTail<T> = T extends [any, ...infer P] ? [...P] : T;
+export declare type NestedPick<T, K extends any[]> = K extends Array<never> ? T : {
+    [P in K[0]]: P extends keyof T ? NestedPick<T[P], ArrayTail<K>> : never;
+};
 //# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAE7B,oBAAY,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;AAEjD,oBAAY,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IAAI;KACxC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK;CAC7C,CAAC,MAAM,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAE7B,oBAAY,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;AAEjD,oBAAY,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IAAI;KACxC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK;CAC7C,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,oBAAY,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AAEpE,oBAAY,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,GAAG,EAAE,IAAI,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,GAC7D,CAAC,GACD;KACG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CAC1E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zajno/common",
-  "version": "2.0.0-beta.2",
+  "version": "2.0.1",
   "description": "Zajno's re-usable utilities for JS/TS projects",
   "repository": {
     "type": "git",

package/src/async/misc.ts

@@ -0,0 +1,11 @@
+
+export async function OptAwait<T>(cb: () => (T | Promise<T>), doAwait: boolean): Promise<T> {
+    return cb && (doAwait ? (await cb()) : cb());
+}
+
+export async function chain(...promises: (() => Promise<void>)[]) {
+
+    const applyAsync = (acc: Promise<void>, val: () => Promise<void>) => acc.then(val);
+
+    return promises.reduce(applyAsync, Promise.resolve());
+}

package/src/models/File.ts

@@ -0,0 +1,14 @@
+
+export type FileMetadata = {
+    name: string;
+
+    /** size in bytes */
+    size: number;
+
+    /** refers to MIME type */
+    type: string;
+
+    format?: string;
+
+    lang?: string;
+};

package/src/observing/progressTracker.ts

@@ -0,0 +1,84 @@
+import * as DateHelpers from '../dates';
+import * as MathHelpers from '../math';
+import logger, { ILogger } from '../logger';
+import { Event } from './event';
+
+export class ProgressTracker {
+
+    private readonly _firstTimestamp = Date.now();
+    private _lastTimestamp: number = null;
+    private _lastCompleted: number = null;
+
+    private _completed = 0;
+    private _total = 0;
+
+    private readonly _deltas: number[] = [];
+
+    private readonly _changed = new Event<{ completed: number, total: number, currentProgress: number, totalElapsedMs: number, totalEstimatedMs: number }>();
+
+    constructor(readonly log: boolean | ILogger = true) { }
+
+    public get changed() { return this._changed.expose(); }
+
+    private get logger() {
+        return this.log === true
+            ? logger
+            : (this.log || null);
+    }
+
+    public setTotal(total: number) {
+        this._total = total;
+        return this;
+    }
+
+    public add(amount = 1, restart = false) {
+        this._completed = restart ? amount : (this._completed + amount);
+        this.track(this._completed, this._total);
+    }
+
+    public track(completed: number, total: number) {
+
+        if (!this._lastTimestamp) {
+            this._lastTimestamp = this._firstTimestamp;
+        }
+
+        const elapsedDelta = Date.now() - this._lastTimestamp;
+        const completedDelta = completed - (this._lastCompleted || 0);
+        this._lastCompleted = completed;
+        const timePerCompleted = completedDelta > 0 ? (elapsedDelta / completedDelta) : 0;
+
+        this._deltas.push(timePerCompleted);
+        if (this._deltas.length > 20) {
+            this._deltas.shift();
+        }
+
+        const currentProgress = Math.floor(completed / (total || 100) * 100);
+        const itemsLeft = total - completed;
+        const leftProgressTime = itemsLeft * (MathHelpers.arrayAverage(this._deltas, true) || 1000);
+
+        this._lastTimestamp = Date.now();
+
+        const totalElapsedMs = this._lastTimestamp - this._firstTimestamp;
+
+        if (this.log) {
+            const totalElapsed = msToString(totalElapsedMs);
+            const totalEstimated = msToString(leftProgressTime);
+
+            this.logger.log(`Progress: ${completed}/${total} ${totalElapsed}/${totalEstimated} => ${currentProgress}%`);
+        }
+
+        this._changed.trigger({
+            completed,
+            total,
+            currentProgress,
+            totalElapsedMs,
+            totalEstimatedMs: leftProgressTime,
+        });
+    }
+}
+
+function msToString(this: void, ms: number) {
+    const decs = DateHelpers.decomposeMs(ms, 'second', 'minute', 'hour');
+    const nf = (n: number) => n.toString().padStart(2, '0');
+    return `${nf(decs.hour)}:${nf(decs.minute)}:${nf(decs.second)}`;
+}

package/src/types/index.ts

@@ -7,3 +7,11 @@ export type Predicate<T> = (value: T) => boolean;
 export type TypedKeys<T extends Object, K> = {
     [P in keyof T]: T[P] extends K ? P : never
 }[keyof T];
+
+export type ArrayTail<T> = T extends [any, ...infer P] ? [...P] : T;
+
+export type NestedPick<T, K extends any[]> = K extends Array<never> // empty arr
+    ? T
+    : {
+        [P in K[0]]: P extends keyof T ? NestedPick<T[P], ArrayTail<K>> : never;
+    };

package/lib/async/opts.d.ts

@@ -1,2 +0,0 @@
-export declare function OptAwait<T>(cb: () => (T | Promise<T>), doAwait: boolean): Promise<T>;
-//# sourceMappingURL=opts.d.ts.map

package/lib/async/opts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"opts.d.ts","sourceRoot":"","sources":["../../src/async/opts.ts"],"names":[],"mappings":"AACA,wBAAsB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1F"}

package/lib/async/opts.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OptAwait = void 0;
-async function OptAwait(cb, doAwait) {
-    return cb && (doAwait ? (await cb()) : cb());
-}
-exports.OptAwait = OptAwait;
-//# sourceMappingURL=opts.js.map

package/lib/async/opts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"opts.js","sourceRoot":"","sources":["../../src/async/opts.ts"],"names":[],"mappings":";;;AACO,KAAK,UAAU,QAAQ,CAAI,EAA0B,EAAE,OAAgB;IAC1E,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAFD,4BAEC"}

package/src/async/opts.ts

@@ -1,4 +0,0 @@
-
-export async function OptAwait<T>(cb: () => (T | Promise<T>), doAwait: boolean): Promise<T> {
-    return cb && (doAwait ? (await cb()) : cb());
-}