vest-utils 0.1.0-dev-c4ba9b → 0.1.0-dev-d315d9

package/dist/umd/vest-utils.development.js

@@ -5,32 +5,26 @@
 })(this, (function (exports) { 'use strict';
 
   function bindNot(fn) {
-      return function () {
-          var args = [];
-          for (var _i = 0; _i < arguments.length; _i++) {
-              args[_i] = arguments[_i];
-          }
-          return !fn.apply(void 0, args);
-      };
+      return (...args) => !fn(...args);
   }
 
   function isNumeric(value) {
-      var str = String(value);
-      var num = Number(value);
-      var result = !isNaN(parseFloat(str)) && !isNaN(Number(value)) && isFinite(num);
+      const str = String(value);
+      const num = Number(value);
+      const result = !isNaN(parseFloat(str)) && !isNaN(Number(value)) && isFinite(num);
       return Boolean(result);
   }
-  var isNotNumeric = bindNot(isNumeric);
+  const isNotNumeric = bindNot(isNumeric);
 
   function numberEquals(value, eq) {
       return isNumeric(value) && isNumeric(eq) && Number(value) === Number(eq);
   }
-  var numberNotEquals = bindNot(numberEquals);
+  const numberNotEquals = bindNot(numberEquals);
 
   function lengthEquals(value, arg1) {
       return numberEquals(value.length, arg1);
   }
-  var lengthNotEquals = bindNot(lengthEquals);
+  const lengthNotEquals = bindNot(lengthEquals);
 
   function greaterThan(value, gt) {
       return isNumeric(value) && isNumeric(gt) && Number(value) > Number(gt);
@@ -43,54 +37,48 @@
   /**
    * Creates a cache function
    */
-  function createCache(maxSize) {
-      if (maxSize === void 0) { maxSize = 1; }
-      var cacheStorage = [];
-      var cache = function (deps, cacheAction) {
-          var cacheHit = cache.get(deps);
+  function createCache(maxSize = 1) {
+      const cacheStorage = [];
+      const cache = (deps, cacheAction) => {
+          const cacheHit = cache.get(deps);
           // cache hit is not null
           if (cacheHit)
               return cacheHit[1];
-          var result = cacheAction();
+          const result = cacheAction();
           cacheStorage.unshift([deps.concat(), result]);
           if (longerThan(cacheStorage, maxSize))
               cacheStorage.length = maxSize;
           return result;
       };
       // invalidate an item in the cache by its dependencies
-      cache.invalidate = function (deps) {
-          var index = findIndex(deps);
+      cache.invalidate = (deps) => {
+          const index = findIndex(deps);
           if (index > -1)
               cacheStorage.splice(index, 1);
       };
       // Retrieves an item from the cache.
-      cache.get = function (deps) {
-          return cacheStorage[findIndex(deps)] || null;
-      };
+      cache.get = (deps) => cacheStorage[findIndex(deps)] || null;
       return cache;
       function findIndex(deps) {
-          return cacheStorage.findIndex(function (_a) {
-              var cachedDeps = _a[0];
-              return lengthEquals(deps, cachedDeps.length) &&
-                  deps.every(function (dep, i) { return dep === cachedDeps[i]; });
-          });
+          return cacheStorage.findIndex(([cachedDeps]) => lengthEquals(deps, cachedDeps.length) &&
+              deps.every((dep, i) => dep === cachedDeps[i]));
       }
   }
 
   function isNull(value) {
       return value === null;
   }
-  var isNotNull = bindNot(isNull);
+  const isNotNull = bindNot(isNull);
 
   function isUndefined(value) {
       return value === undefined;
   }
-  var isNotUndefined = bindNot(isUndefined);
+  const isNotUndefined = bindNot(isUndefined);
 
   function isNullish(value) {
       return isNull(value) || isUndefined(value);
   }
-  var isNotNullish = bindNot(isNullish);
+  const isNotNullish = bindNot(isNullish);
 
   function asArray(possibleArg) {
       return [].concat(possibleArg);
@@ -100,12 +88,8 @@
       return typeof value === 'function';
   }
 
-  function optionalFunctionValue(value) {
-      var args = [];
-      for (var _i = 1; _i < arguments.length; _i++) {
-          args[_i - 1] = arguments[_i];
-      }
-      return isFunction(value) ? value.apply(void 0, args) : value;
+  function optionalFunctionValue(value, ...args) {
+      return isFunction(value) ? value(...args) : value;
   }
 
   function defaultTo(value, defaultValue) {
@@ -119,10 +103,10 @@
   function isArray(value) {
       return Boolean(Array.isArray(value));
   }
-  var isNotArray = bindNot(isArray);
+  const isNotArray = bindNot(isArray);
 
   function last(values) {
-      var valuesArray = asArray(values);
+      const valuesArray = asArray(values);
       return valuesArray[valuesArray.length - 1];
   }
 
@@ -130,14 +114,13 @@
   // Normally, behaves like a nested-array map,
   // but returning `null` will drop the element from the array
   function transform(array, cb) {
-      var res = [];
-      for (var _i = 0, array_1 = array; _i < array_1.length; _i++) {
-          var v = array_1[_i];
+      const res = [];
+      for (const v of array) {
           if (isArray(v)) {
               res.push(transform(v, cb));
           }
           else {
-              var output = cb(v);
+              const output = cb(v);
               if (isNotNull(output)) {
                   res.push(output);
               }
@@ -149,12 +132,12 @@
       return getCurrent(array, path)[last(path)];
   }
   function setValueAtPath(array, path, value) {
-      var current = getCurrent(array, path);
+      const current = getCurrent(array, path);
       current[last(path)] = value;
       return array;
   }
   function flatten(values) {
-      return asArray(values).reduce(function (acc, value) {
+      return asArray(values).reduce((acc, value) => {
           if (isArray(value)) {
               return acc.concat(flatten(value));
           }
@@ -162,9 +145,8 @@
       }, []);
   }
   function getCurrent(array, path) {
-      var current = array;
-      for (var _i = 0, _a = path.slice(0, -1); _i < _a.length; _i++) {
-          var p = _a[_i];
+      let current = array;
+      for (const p of path.slice(0, -1)) {
           current[p] = defaultTo(current[p], []);
           current = current[p];
       }
@@ -181,7 +163,7 @@
   });
 
   function callEach(arr) {
-      return arr.forEach(function (fn) { return fn(); });
+      return arr.forEach(fn => fn());
   }
 
   /**
@@ -228,27 +210,27 @@
   }
 
   function deferThrow(message) {
-      setTimeout(function () {
+      setTimeout(() => {
           throw new Error(message);
       }, 0);
   }
 
   function createBus() {
-      var listeners = {};
+      const listeners = {};
       return {
-          emit: function (event, data) {
-              listener(event).forEach(function (handler) {
+          emit(event, data) {
+              listener(event).forEach(handler => {
                   handler(data);
               });
           },
-          on: function (event, handler) {
+          on(event, handler) {
               listeners[event] = listener(event).concat(handler);
               return {
-                  off: function () {
-                      listeners[event] = listener(event).filter(function (h) { return h !== handler; });
-                  }
+                  off() {
+                      listeners[event] = listener(event).filter(h => h !== handler);
+                  },
               };
-          }
+          },
       };
       function listener(event) {
           return listeners[event] || [];
@@ -263,14 +245,15 @@
   /**
    * @returns a unique numeric id.
    */
-  var seq = (function (n) { return function () {
-      return "".concat(n++);
-  }; })(0);
+  const seq = genSeq();
+  function genSeq(namespace) {
+      return ((n) => () => `${namespace ? namespace + '_' : ''}${n++}`)(0);
+  }
 
   function mapFirst(array, callback) {
-      var broke = false;
-      var breakoutValue = null;
-      for (var i = 0; i < array.length; i++) {
+      let broke = false;
+      let breakoutValue = null;
+      for (let i = 0; i < array.length; i++) {
           callback(array[i], breakout, i);
           if (broke) {
               return breakoutValue;
@@ -296,12 +279,29 @@
       }
       return false;
   }
-  var isNotEmpty = bindNot(isEmpty);
+  const isNotEmpty = bindNot(isEmpty);
 
   function isPositive(value) {
       return greaterThan(value, 0);
   }
 
+  function createTinyState(initialValue) {
+      let value;
+      resetValue();
+      return () => [value, setValue, resetValue];
+      function setValue(nextValue) {
+          value = optionalFunctionValue(nextValue, value);
+      }
+      function resetValue() {
+          setValue(optionalFunctionValue(initialValue));
+      }
+  }
+
+  var tinyState = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    createTinyState: createTinyState
+  });
+
   exports.StringObject = StringObject;
   exports.asArray = asArray;
   exports.assign = assign;
@@ -312,6 +312,7 @@
   exports.defaultTo = defaultTo;
   exports.deferThrow = deferThrow;
   exports.either = either;
+  exports.genSeq = genSeq;
   exports.greaterThan = greaterThan;
   exports.hasOwnProperty = hasOwnProperty;
   exports.invariant = invariant;
@@ -342,6 +343,7 @@
   exports.numberNotEquals = numberNotEquals;
   exports.optionalFunctionValue = optionalFunctionValue;
   exports.seq = seq;
+  exports.tinyState = tinyState;
 
   Object.defineProperty(exports, '__esModule', { value: true });
 

package/dist/umd/vest-utils.production.js

@@ -1 +1 @@
-!function(n,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((n="undefined"!=typeof globalThis?globalThis:n||self)["vest-utils"]={})}(this,(function(n){"use strict";function t(n){return function(){for(var t=[],r=0;r<arguments.length;r++)t[r]=arguments[r];return!n.apply(void 0,t)}}function r(n){var t=String(n),r=Number(n),e=!isNaN(parseFloat(t))&&!isNaN(Number(n))&&isFinite(r);return Boolean(e)}var e=t(r);function u(n,t){return r(n)&&r(t)&&Number(n)===Number(t)}var i=t(u);function o(n,t){return u(n.length,t)}var f=t(o);function c(n,t){return r(n)&&r(t)&&Number(n)>Number(t)}function a(n,t){return c(n.length,t)}function l(n){return null===n}var s=t(l);function v(n){return void 0===n}var h=t(v);function d(n){return l(n)||v(n)}var g=t(d);function p(n){return[].concat(n)}function N(n){return"function"==typeof n}function y(n){for(var t=[],r=1;r<arguments.length;r++)t[r-1]=arguments[r];return N(n)?n.apply(void 0,t):n}function b(n,t){var r;return null!==(r=y(n))&&void 0!==r?r:y(t)}function m(n){return Boolean(Array.isArray(n))}var E=t(m);function O(n){var t=p(n);return t[t.length-1]}function _(n,t){for(var r=n,e=0,u=t.slice(0,-1);e<u.length;e++){var i=u[e];r[i]=b(r[i],[]),r=r[i]}return r}var j=Object.freeze({__proto__:null,transform:function n(t,r){for(var e=[],u=0,i=t;u<i.length;u++){var o=i[u];if(m(o))e.push(n(o,r));else{var f=r(o);s(f)&&e.push(f)}}return e},valueAtPath:function(n,t){return _(n,t)[O(t)]},setValueAtPath:function(n,t,r){return _(n,t)[O(t)]=r,n},flatten:function n(t){return p(t).reduce((function(t,r){return m(r)?t.concat(n(r)):p(t).concat(r)}),[])},getCurrent:_});function w(n,t){return Object.prototype.hasOwnProperty.call(n,t)}var A=Object.assign;var P,T=Object.freeze({__proto__:null,createBus:function(){var n={};return{emit:function(n,r){t(n).forEach((function(n){n(r)}))},on:function(r,e){return n[r]=t(r).concat(e),{off:function(){n[r]=t(r).filter((function(n){return n!==e}))}}}};function t(t){return n[t]||[]}}}),S=(P=0,function(){return"".concat(P++)});function q(n){return!n||(w(n,"length")?o(n,0):"object"==typeof n&&o(Object.keys(n),0))}var F=t(q);n.StringObject=function(n){return new String(y(n))},n.asArray=p,n.assign=A,n.bindNot=t,n.bus=T,n.cache=function(n){void 0===n&&(n=1);var t=[],r=function(e,u){var i=r.get(e);if(i)return i[1];var o=u();return t.unshift([e.concat(),o]),a(t,n)&&(t.length=n),o};return r.invalidate=function(n){var r=e(n);r>-1&&t.splice(r,1)},r.get=function(n){return t[e(n)]||null},r;function e(n){return t.findIndex((function(t){var r=t[0];return o(n,r.length)&&n.every((function(n,t){return n===r[t]}))}))}},n.callEach=function(n){return n.forEach((function(n){return n()}))},n.defaultTo=b,n.deferThrow=function(n){setTimeout((function(){throw new Error(n)}),0)},n.either=function(n,t){return!!n!=!!t},n.greaterThan=c,n.hasOwnProperty=w,n.invariant=function(n,t){if(!n)throw t instanceof String?t.valueOf():new Error(t?y(t):t)},n.isArray=m,n.isBoolean=function(n){return!!n===n},n.isEmpty=q,n.isFunction=N,n.isNotArray=E,n.isNotEmpty=F,n.isNotNull=s,n.isNotNullish=g,n.isNotNumeric=e,n.isNotUndefined=h,n.isNull=l,n.isNullish=d,n.isNumeric=r,n.isPositive=function(n){return c(n,0)},n.isPromise=function(n){return n&&N(n.then)},n.isStringValue=function(n){return String(n)===n},n.isUndefined=v,n.last=O,n.lengthEquals=o,n.lengthNotEquals=f,n.longerThan=a,n.mapFirst=function(n,t){for(var r=!1,e=null,u=0;u<n.length;u++)if(t(n[u],i,u),r)return e;function i(n,t){n&&(r=!0,e=t)}},n.nestedArray=j,n.numberEquals=u,n.numberNotEquals=i,n.optionalFunctionValue=y,n.seq=S,Object.defineProperty(n,"__esModule",{value:!0})}));
+!function(n,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((n="undefined"!=typeof globalThis?globalThis:n||self)["vest-utils"]={})}(this,(function(n){"use strict";function t(n){return(...t)=>!n(...t)}function e(n){const t=String(n),e=Number(n),r=!isNaN(parseFloat(t))&&!isNaN(Number(n))&&isFinite(e);return Boolean(r)}const r=t(e);function o(n,t){return e(n)&&e(t)&&Number(n)===Number(t)}const u=t(o);function i(n,t){return o(n.length,t)}const c=t(i);function s(n,t){return e(n)&&e(t)&&Number(n)>Number(t)}function f(n,t){return s(n.length,t)}function l(n){return null===n}const a=t(l);function h(n){return void 0===n}const d=t(h);function g(n){return l(n)||h(n)}const p=t(g);function N(n){return[].concat(n)}function b(n){return"function"==typeof n}function y(n,...t){return b(n)?n(...t):n}function m(n,t){var e;return null!==(e=y(n))&&void 0!==e?e:y(t)}function v(n){return Boolean(Array.isArray(n))}const _=t(v);function E(n){const t=N(n);return t[t.length-1]}function O(n,t){let e=n;for(const n of t.slice(0,-1))e[n]=m(e[n],[]),e=e[n];return e}var j=Object.freeze({__proto__:null,transform:function n(t,e){const r=[];for(const o of t)if(v(o))r.push(n(o,e));else{const n=e(o);a(n)&&r.push(n)}return r},valueAtPath:function(n,t){return O(n,t)[E(t)]},setValueAtPath:function(n,t,e){return O(n,t)[E(t)]=e,n},flatten:function n(t){return N(t).reduce(((t,e)=>v(e)?t.concat(n(e)):N(t).concat(e)),[])},getCurrent:O});function S(n,t){return Object.prototype.hasOwnProperty.call(n,t)}var w=Object.assign;var A=Object.freeze({__proto__:null,createBus:function(){const n={};return{emit(n,e){t(n).forEach((n=>{n(e)}))},on:(e,r)=>(n[e]=t(e).concat(r),{off(){n[e]=t(e).filter((n=>n!==r))}})};function t(t){return n[t]||[]}}});const T=P();function P(n){return t=0,()=>`${n?n+"_":""}${t++}`;var t}function q(n){return!n||(S(n,"length")?i(n,0):"object"==typeof n&&i(Object.keys(n),0))}const F=t(q);var x=Object.freeze({__proto__:null,createTinyState:function(n){let t;return r(),()=>[t,e,r];function e(n){t=y(n,t)}function r(){e(y(n))}}});n.StringObject=function(n){return new String(y(n))},n.asArray=N,n.assign=w,n.bindNot=t,n.bus=A,n.cache=function(n=1){const t=[],e=(r,o)=>{const u=e.get(r);if(u)return u[1];const i=o();return t.unshift([r.concat(),i]),f(t,n)&&(t.length=n),i};return e.invalidate=n=>{const e=r(n);e>-1&&t.splice(e,1)},e.get=n=>t[r(n)]||null,e;function r(n){return t.findIndex((([t])=>i(n,t.length)&&n.every(((n,e)=>n===t[e]))))}},n.callEach=function(n){return n.forEach((n=>n()))},n.defaultTo=m,n.deferThrow=function(n){setTimeout((()=>{throw new Error(n)}),0)},n.either=function(n,t){return!!n!=!!t},n.genSeq=P,n.greaterThan=s,n.hasOwnProperty=S,n.invariant=function(n,t){if(!n)throw t instanceof String?t.valueOf():new Error(t?y(t):t)},n.isArray=v,n.isBoolean=function(n){return!!n===n},n.isEmpty=q,n.isFunction=b,n.isNotArray=_,n.isNotEmpty=F,n.isNotNull=a,n.isNotNullish=p,n.isNotNumeric=r,n.isNotUndefined=d,n.isNull=l,n.isNullish=g,n.isNumeric=e,n.isPositive=function(n){return s(n,0)},n.isPromise=function(n){return n&&b(n.then)},n.isStringValue=function(n){return String(n)===n},n.isUndefined=h,n.last=E,n.lengthEquals=i,n.lengthNotEquals=c,n.longerThan=f,n.mapFirst=function(n,t){let e=!1,r=null;for(let u=0;u<n.length;u++)if(t(n[u],o,u),e)return r;function o(n,t){n&&(e=!0,r=t)}},n.nestedArray=j,n.numberEquals=o,n.numberNotEquals=u,n.optionalFunctionValue=y,n.seq=T,n.tinyState=x,Object.defineProperty(n,"__esModule",{value:!0})}));

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.0-dev-c4ba9b",
+  "version": "0.1.0-dev-d315d9",
   "name": "vest-utils",
   "author": "ealush",
   "scripts": {
@@ -42,6 +42,6 @@
       "default": "./dist/cjs/vest-utils.production.js"
     },
     "./package.json": "./package.json",
-    "./": "./"
+    "./*": "./*"
   }
 }

package/src/__tests__/cache.test.ts

@@ -95,8 +95,8 @@ describe('lib: cache', () => {
     describe('On cache hit', () => {
       it('Should return cached key and item from cache storage', () => {
         const res = c([1, 2, 3], Math.random);
-        expect(c.get([1, 2, 3])[0]).toEqual([1, 2, 3]);
-        expect(c.get([1, 2, 3])[1]).toEqual(res);
+        expect(c.get([1, 2, 3])?.[0]).toEqual([1, 2, 3]);
+        expect(c.get([1, 2, 3])?.[1]).toEqual(res);
       });
     });
   });

package/src/__tests__/greaterThan.test.ts

@@ -1,11 +1,13 @@
-import { random, datatype } from 'faker';
+import { faker } from '@faker-js/faker';
 
 import { greaterThan } from 'greaterThan';
 
-describe('Tests greaterThan rule', () => {
-  let arg0;
+const { random, datatype } = faker;
 
+describe('Tests greaterThan rule', () => {
   describe('Arguments are numbers', () => {
+    let arg0: number;
+
     beforeEach(() => {
       arg0 = datatype.number();
     });
@@ -30,9 +32,15 @@ describe('Tests greaterThan rule', () => {
   });
 
   describe('Arguments are numeric strings', () => {
+    let arg0: string;
+
+    beforeEach(() => {
+      arg0 = datatype.number().toString();
+    });
+
     describe('When first argument is larger', () => {
       it('Should return true', () => {
-        expect(greaterThan(`${arg0}`, `${arg0 - 1}`)).toBe(true);
+        expect(greaterThan('100', '99')).toBe(true);
       });
     });
 
@@ -52,6 +60,7 @@ describe('Tests greaterThan rule', () => {
   describe('Arguments are non numeric', () => {
     [random.word(), `${datatype.number()}`.split(''), {}].forEach(element => {
       it('Should return false', () => {
+        // @ts-expect-error - testing invalid input
         expect(greaterThan(element, 0)).toBe(false);
       });
     });

package/src/__tests__/lengthEquals.test.ts

@@ -1,4 +1,4 @@
-import faker from 'faker';
+import { faker } from '@faker-js/faker';
 
 import { lengthEquals } from 'lengthEquals';
 
@@ -46,10 +46,12 @@ describe('Tests lengthEquals rule', () => {
     });
 
     it('Should return false for number argument', () => {
-      expect(lengthEquals(length, 0)).toBe(false);
+      // @ts-expect-error - testing wrong input
+      expect(lengthEquals(100, 0)).toBe(false);
     });
 
     it('Should return false for boolean argument', () => {
+      // @ts-expect-error - testing wrong input
       expect(lengthEquals(boolean, 0)).toBe(false);
     });
   });

package/src/__tests__/longerThan.test.ts

@@ -1,4 +1,4 @@
-import faker from 'faker';
+import { faker } from '@faker-js/faker';
 
 import { longerThan } from 'longerThan';
 
@@ -46,10 +46,12 @@ describe('Tests longerThan rule', () => {
     });
 
     it('Should return false for number argument', () => {
+      // @ts-expect-error - testing wrong input
       expect(longerThan(length, 0)).toBe(false);
     });
 
     it('Should return false for boolean argument', () => {
+      // @ts-expect-error - testing wrong input
       expect(longerThan(boolean, 0)).toBe(false);
     });
   });

package/src/__tests__/numberEquals.test.ts

@@ -1,11 +1,12 @@
-import { random, datatype } from 'faker';
+import { faker } from '@faker-js/faker';
 
 import { numberEquals } from 'numberEquals';
 
-describe('Tests numberEquals rule', () => {
-  let arg0;
+const { random, datatype } = faker;
 
+describe('Tests numberEquals rule', () => {
   describe('Arguments are numbers', () => {
+    let arg0: number;
     beforeEach(() => {
       arg0 = datatype.number();
     });
@@ -30,9 +31,15 @@ describe('Tests numberEquals rule', () => {
   });
 
   describe('Arguments are numeric strings', () => {
+    let arg0: string;
+
+    beforeEach(() => {
+      arg0 = datatype.number().toString();
+    });
+
     describe('When first argument is larger', () => {
       it('Should return false', () => {
-        expect(numberEquals(`${arg0}`, `${arg0 - 1}`)).toBe(false);
+        expect(numberEquals(`${arg0}`, `${Number(arg0) - 1}`)).toBe(false);
       });
     });
 
@@ -44,7 +51,7 @@ describe('Tests numberEquals rule', () => {
 
     describe('When values are equal', () => {
       it('Should return true', () => {
-        expect(numberEquals(arg0, arg0)).toBe(true);
+        expect(numberEquals('100', '100')).toBe(true);
       });
     });
   });
@@ -52,6 +59,7 @@ describe('Tests numberEquals rule', () => {
   describe('Arguments are non numeric', () => {
     [random.word(), `${datatype.number()}`.split(''), {}].forEach(element => {
       it('Should return false', () => {
+        // @ts-expect-error - testing invalid input
         expect(numberEquals(element, 0)).toBe(false);
       });
     });

package/src/__tests__/seq.test.ts

@@ -1,4 +1,4 @@
-import seq from 'seq';
+import seq, { genSeq } from 'seq';
 
 describe('lib:seq', () => {
   it('Should return a new id on each run', () => {
@@ -9,4 +9,20 @@ describe('lib:seq', () => {
       return existing;
     }, {});
   });
+
+  describe('genSeq', () => {
+    it('Creates a namespaced sequence', () => {
+      const seq = genSeq('test');
+      expect(seq()).toBe('test_0');
+      expect(seq()).toBe('test_1');
+      expect(seq()).toBe('test_2');
+
+      const seq2 = genSeq('test2');
+      expect(seq2()).toBe('test2_0');
+      expect(seq2()).toBe('test2_1');
+      expect(seq2()).toBe('test2_2');
+
+      expect(seq()).toBe('test_3');
+    });
+  });
 });

package/src/__tests__/tinyState.test.ts

@@ -0,0 +1,67 @@
+import { createTinyState } from 'tinyState';
+
+describe('tinyTest', () => {
+  it('Should be a function', () => {
+    expect(typeof createTinyState).toBe('function');
+  });
+
+  it('Should return a function', () => {
+    expect(typeof createTinyState(1)).toBe('function');
+  });
+
+  it('Should return a function that returns an array', () => {
+    expect(Array.isArray(createTinyState(1)())).toBe(true);
+  });
+
+  it('Should return a function that returns an array with three items', () => {
+    expect(createTinyState(1)()).toHaveLength(3);
+  });
+
+  it('Should return a function that returns an array with three items, the first being the initial value', () => {
+    expect(createTinyState('initial_value')()[0]).toBe('initial_value');
+
+    const initialValue = {};
+    expect(createTinyState(initialValue)()[0]).toBe(initialValue);
+  });
+
+  it('Should return a function that returns an array with three items, the second being a function', () => {
+    expect(typeof createTinyState(1)()[1]).toBe('function');
+  });
+
+  it('Should return a function that returns an array with three items, the third being a function', () => {
+    expect(typeof createTinyState(1)()[2]).toBe('function');
+  });
+
+  it('Updates the value when the second item is called', () => {
+    const testState = createTinyState('initial_value');
+
+    {
+      const [, setValue] = testState();
+      setValue('new_value');
+    }
+
+    {
+      const [value] = testState();
+      expect(value).toBe('new_value');
+    }
+  });
+
+  it('resets the value when the third item is called', () => {
+    const testState = createTinyState('initial_value');
+
+    {
+      const [, setValue] = testState();
+      setValue('new_value');
+    }
+
+    {
+      const [, , resetValue] = testState();
+      resetValue();
+    }
+
+    {
+      const [value] = testState();
+      expect(value).toBe('initial_value');
+    }
+  });
+});

package/src/bus.ts

@@ -1,9 +1,6 @@
 import type { CB } from 'utilityTypes';
 
-export function createBus(): {
-  on: (event: string, handler: CB) => OnReturn;
-  emit: (event: string, ...args: any[]) => void;
-} {
+export function createBus(): BusType {
   const listeners: Record<string, CB[]> = {};
 
   return {
@@ -30,3 +27,8 @@ export function createBus(): {
 }
 
 type OnReturn = { off: () => void };
+
+export type BusType = {
+  on: (event: string, handler: CB) => OnReturn;
+  emit: (event: string, ...args: any[]) => void;
+};

package/src/cache.ts

@@ -4,14 +4,16 @@ import { longerThan } from 'longerThan';
 /**
  * Creates a cache function
  */
-export default function createCache(maxSize = 1): {
-  <T>(deps: unknown[], cacheAction: (...args: unknown[]) => T): T;
-  get(deps: unknown[]): any;
+export default function createCache<T = unknown>(
+  maxSize = 1
+): {
+  (deps: unknown[], cacheAction: (...args: unknown[]) => T): T;
+  get(deps: unknown[]): [unknown[], T] | null;
   invalidate(item: any): void;
 } {
-  const cacheStorage: Array<[unknown[], any]> = [];
+  const cacheStorage: Array<[unknown[], T]> = [];
 
-  const cache = <T>(
+  const cache = (
     deps: unknown[],
     cacheAction: (...args: unknown[]) => T
   ): T => {
@@ -34,7 +36,7 @@ export default function createCache(maxSize = 1): {
   };
 
   // Retrieves an item from the cache.
-  cache.get = (deps: unknown[]): [unknown[], any] | null =>
+  cache.get = (deps: unknown[]): [unknown[], T] | null =>
     cacheStorage[findIndex(deps)] || null;
 
   return cache;
@@ -47,3 +49,9 @@ export default function createCache(maxSize = 1): {
     );
   }
 }
+
+export type CacheApi<T = unknown> = {
+  (deps: unknown[], cacheAction: (...args: unknown[]) => T): T;
+  get(deps: unknown[]): [unknown[], T] | null;
+  invalidate(item: any): void;
+};

package/src/deferThrow.ts

@@ -3,3 +3,5 @@ export default function deferThrow(message?: string): void {
     throw new Error(message);
   }, 0);
 }
+
+export type TDeferThrow = typeof deferThrow;

package/src/seq.ts

@@ -2,9 +2,13 @@
  * @returns a unique numeric id.
  */
 
-const seq: () => string = (
-  (n: number) => (): string =>
-    `${n++}`
-)(0);
+const seq = genSeq();
 
 export default seq;
+
+export function genSeq(namespace?: string): () => string {
+  return (
+    (n: number) => () =>
+      `${namespace ? namespace + '_' : ''}${n++}`
+  )(0);
+}