@choksheak/ts-utils 0.3.1 → 0.3.3

package/storageAdapter.d.ts

@@ -19,8 +19,11 @@ type StoredObject<T> = {
 /**
  * Full interface for a storage implementation. Each method can be either sync
  * or async, and the interface works with either implementation scheme.
+ *
+ * Note: We are using `interface` instead of `type ... &` because typedoc
+ * cannot handle the `&` syntax to merge types.
  */
-type FullStorageAdapter<T> = StorageAdapter<T> & {
+interface FullStorageAdapter<T> extends StorageAdapter<T> {
     set: (key: string, value: T, expiryDeltaMs?: number | Duration) => Promise<void> | void;
     getStoredObject: (key: string) => Promise<StoredObject<T> | undefined> | StoredObject<T> | undefined;
     forEach(callback: (key: string, value: T, expiryMs: number, storedMs: number) => void | Promise<void>): Promise<void> | void;
@@ -28,6 +31,6 @@ type FullStorageAdapter<T> = StorageAdapter<T> & {
     asMap<T>(): Promise<Map<string, StoredObject<T>>> | Map<string, StoredObject<T>>;
     gc: () => Promise<void> | void;
     gcNow: () => Promise<void> | void;
-};
+}
 
 export type { FullStorageAdapter, StorageAdapter, StoredObject };

package/storageAdapter.min.cjs

@@ -1,2 +1,2 @@
-"use strict";var t=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var n=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var m=(r,e,d,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of n(e))!a.call(r,o)&&o!==d&&t(r,o,{get:()=>e[o],enumerable:!(i=s(e,o))||i.enumerable});return r};var v=r=>m(t({},"__esModule",{value:!0}),r);var u={};module.exports=v(u);
+"use strict";var t=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var n=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var m=(r,e,d,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of n(e))!a.call(r,i)&&i!==d&&t(r,i,{get:()=>e[i],enumerable:!(o=s(e,i))||o.enumerable});return r};var v=r=>m(t({},"__esModule",{value:!0}),r);var u={};module.exports=v(u);
 //# sourceMappingURL=storageAdapter.min.cjs.map

package/storageAdapter.min.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/storageAdapter.ts"],"sourcesContent":["import { Duration } from \"./duration\";\n\n/**\n * Most basic interface for a storage implementation. This is designed to be\n * quite easily implemented by users to plug in any new underlying storage.\n */\nexport type StorageAdapter<T> = {\n  set: (key: string, value: T) => Promise<void> | void;\n  get: (key: string) => Promise<T | undefined> | T | undefined;\n  delete: (key: string) => Promise<void> | void;\n  clear: () => Promise<void> | void;\n};\n\n/** Most basic interface for stored object. */\nexport type StoredObject<T> = {\n  value: T;\n  storedMs: number;\n  expiryMs: number;\n};\n\n/**\n * Full interface for a storage implementation. Each method can be either sync\n * or async, and the interface works with either implementation scheme.\n */\nexport type FullStorageAdapter<T> = StorageAdapter<T> & {\n  // Redefining `set()`, but with an optional expiration parameter.\n  set: (\n    key: string,\n    value: T,\n    expiryDeltaMs?: number | Duration,\n  ) => Promise<void> | void;\n\n  getStoredObject: (\n    key: string,\n  ) => Promise<StoredObject<T> | undefined> | StoredObject<T> | undefined;\n\n  forEach(\n    callback: (\n      key: string,\n      value: T,\n      expiryMs: number,\n      storedMs: number,\n    ) => void | Promise<void>,\n  ): Promise<void> | void;\n\n  size(): Promise<number> | number;\n\n  asMap<T>():\n    | Promise<Map<string, StoredObject<T>>>\n    | Map<string, StoredObject<T>>;\n\n  gc: () => Promise<void> | void;\n\n  gcNow: () => Promise<void> | void;\n};\n"],"mappings":"+WAAA,IAAAA,EAAA,kBAAAC,EAAAD","names":["storageAdapter_exports","__toCommonJS"]}
+{"version":3,"sources":["../src/storageAdapter.ts"],"sourcesContent":["import { Duration } from \"./duration\";\n\n/**\n * Most basic interface for a storage implementation. This is designed to be\n * quite easily implemented by users to plug in any new underlying storage.\n */\nexport type StorageAdapter<T> = {\n  set: (key: string, value: T) => Promise<void> | void;\n  get: (key: string) => Promise<T | undefined> | T | undefined;\n  delete: (key: string) => Promise<void> | void;\n  clear: () => Promise<void> | void;\n};\n\n/** Most basic interface for stored object. */\nexport type StoredObject<T> = {\n  value: T;\n  storedMs: number;\n  expiryMs: number;\n};\n\n/**\n * Full interface for a storage implementation. Each method can be either sync\n * or async, and the interface works with either implementation scheme.\n *\n * Note: We are using `interface` instead of `type ... &` because typedoc\n * cannot handle the `&` syntax to merge types.\n */\nexport interface FullStorageAdapter<T> extends StorageAdapter<T> {\n  // Redefining `set()`, but with an optional expiration parameter.\n  set: (\n    key: string,\n    value: T,\n    expiryDeltaMs?: number | Duration,\n  ) => Promise<void> | void;\n\n  getStoredObject: (\n    key: string,\n  ) => Promise<StoredObject<T> | undefined> | StoredObject<T> | undefined;\n\n  forEach(\n    callback: (\n      key: string,\n      value: T,\n      expiryMs: number,\n      storedMs: number,\n    ) => void | Promise<void>,\n  ): Promise<void> | void;\n\n  size(): Promise<number> | number;\n\n  asMap<T>():\n    | Promise<Map<string, StoredObject<T>>>\n    | Map<string, StoredObject<T>>;\n\n  gc: () => Promise<void> | void;\n\n  gcNow: () => Promise<void> | void;\n}\n"],"mappings":"+WAAA,IAAAA,EAAA,kBAAAC,EAAAD","names":["storageAdapter_exports","__toCommonJS"]}

package/sum.cjs

@@ -23,14 +23,24 @@ __export(sum_exports, {
   sum: () => sum
 });
 module.exports = __toCommonJS(sum_exports);
+
+// src/asNumber.ts
+function asNumber(u) {
+  if (typeof u === "number" && isFinite(u)) {
+    return u;
+  }
+  const n = Number(u);
+  if (typeof n === "number" && isFinite(n)) {
+    return n;
+  }
+  return 0;
+}
+
+// src/sum.ts
 function sum(numbers) {
-  return numbers.reduce(
-    (accumulated, current) => {
-      const value = typeof current === "number" && !isNaN(current) && isFinite(current) ? current : 0;
-      return accumulated + value;
-    },
-    0
-  );
+  return numbers.reduce((accumulated, current) => {
+    return accumulated + asNumber(current);
+  }, 0);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/sum.d.mts

@@ -1,7 +1,7 @@
 /**
- * Add all the numbers together in the given array. Treats null, undefined and
- * NaN as zero.
+ * Add all the numbers together in the given array.
+ * Non-numbers will be coerced into numbers if possible.
  */
-declare function sum(numbers: (number | null | undefined)[]): number;
+declare function sum(numbers: unknown[]): number;
 
 export { sum };

package/sum.d.ts

@@ -1,7 +1,7 @@
 /**
- * Add all the numbers together in the given array. Treats null, undefined and
- * NaN as zero.
+ * Add all the numbers together in the given array.
+ * Non-numbers will be coerced into numbers if possible.
  */
-declare function sum(numbers: (number | null | undefined)[]): number;
+declare function sum(numbers: unknown[]): number;
 
 export { sum };

package/sum.min.cjs

@@ -1,2 +1,2 @@
-"use strict";var b=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var r=Object.prototype.hasOwnProperty;var f=(n,e)=>{for(var u in e)b(n,u,{get:e[u],enumerable:!0})},o=(n,e,u,m)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of l(e))!r.call(n,i)&&i!==u&&b(n,i,{get:()=>e[i],enumerable:!(m=d(e,i))||m.enumerable});return n};var s=n=>o(b({},"__esModule",{value:!0}),n);var a={};f(a,{sum:()=>t});module.exports=s(a);function t(n){return n.reduce((e,u)=>{let m=typeof u=="number"&&!isNaN(u)&&isFinite(u)?u:0;return e+m},0)}0&&(module.exports={sum});
+"use strict";var t=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var s=(r,n)=>{for(var e in n)t(r,e,{get:n[e],enumerable:!0})},p=(r,n,e,o)=>{if(n&&typeof n=="object"||typeof n=="function")for(let u of b(n))!f.call(r,u)&&u!==e&&t(r,u,{get:()=>n[u],enumerable:!(o=m(n,u))||o.enumerable});return r};var c=r=>p(t({},"__esModule",{value:!0}),r);var w={};s(w,{sum:()=>k});module.exports=c(w);function i(r){if(typeof r=="number"&&isFinite(r))return r;let n=Number(r);return typeof n=="number"&&isFinite(n)?n:0}function k(r){return r.reduce((n,e)=>n+i(e),0)}0&&(module.exports={sum});
 //# sourceMappingURL=sum.min.cjs.map

package/sum.min.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/sum.ts"],"sourcesContent":["/**\n * Add all the numbers together in the given array. Treats null, undefined and\n * NaN as zero.\n */\nexport function sum(numbers: (number | null | undefined)[]): number {\n  return numbers.reduce(\n    (accumulated: number, current: number | null | undefined) => {\n      const value =\n        typeof current === \"number\" && !isNaN(current) && isFinite(current)\n          ? current\n          : 0;\n\n      return accumulated + value;\n    },\n    0,\n  );\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,SAAAE,IAAA,eAAAC,EAAAH,GAIO,SAASE,EAAIE,EAAgD,CAClE,OAAOA,EAAQ,OACb,CAACC,EAAqBC,IAAuC,CAC3D,IAAMC,EACJ,OAAOD,GAAY,UAAY,CAAC,MAAMA,CAAO,GAAK,SAASA,CAAO,EAC9DA,EACA,EAEN,OAAOD,EAAcE,CACvB,EACA,CACF,CACF","names":["sum_exports","__export","sum","__toCommonJS","numbers","accumulated","current","value"]}
+{"version":3,"sources":["../src/sum.ts","../src/asNumber.ts"],"sourcesContent":["import { asNumber } from \"./asNumber\";\n\n/**\n * Add all the numbers together in the given array.\n * Non-numbers will be coerced into numbers if possible.\n */\nexport function sum(numbers: unknown[]): number {\n  return numbers.reduce((accumulated: number, current: unknown) => {\n    return accumulated + asNumber(current);\n  }, 0);\n}\n","/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown): number {\n  // No transformation needed if u is already a number.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Try to make into a number if possible.\n  const n = Number(u);\n  if (typeof n === \"number\" && isFinite(n)) {\n    return n;\n  }\n\n  // Return 0 for everything else. This is usually ok if want to just ignore\n  // all other noise.\n  return 0;\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,SAAAE,IAAA,eAAAC,EAAAH,GCGO,SAASI,EAASC,EAAoB,CAE3C,GAAI,OAAOA,GAAM,UAAY,SAASA,CAAC,EACrC,OAAOA,EAIT,IAAM,EAAI,OAAOA,CAAC,EAClB,OAAI,OAAO,GAAM,UAAY,SAAS,CAAC,EAC9B,EAKF,CACT,CDZO,SAASC,EAAIC,EAA4B,CAC9C,OAAOA,EAAQ,OAAO,CAACC,EAAqBC,IACnCD,EAAcE,EAASD,CAAO,EACpC,CAAC,CACN","names":["sum_exports","__export","sum","__toCommonJS","asNumber","u","sum","numbers","accumulated","current","asNumber"]}

package/sum.min.mjs

@@ -1,2 +1,2 @@
-function m(n){return n.reduce((u,e)=>{let i=typeof e=="number"&&!isNaN(e)&&isFinite(e)?e:0;return u+i},0)}export{m as sum};
+function e(n){if(typeof n=="number"&&isFinite(n))return n;let r=Number(n);return typeof r=="number"&&isFinite(r)?r:0}function i(n){return n.reduce((r,u)=>r+e(u),0)}export{i as sum};
 //# sourceMappingURL=sum.min.mjs.map

package/sum.min.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/sum.ts"],"sourcesContent":["/**\n * Add all the numbers together in the given array. Treats null, undefined and\n * NaN as zero.\n */\nexport function sum(numbers: (number | null | undefined)[]): number {\n  return numbers.reduce(\n    (accumulated: number, current: number | null | undefined) => {\n      const value =\n        typeof current === \"number\" && !isNaN(current) && isFinite(current)\n          ? current\n          : 0;\n\n      return accumulated + value;\n    },\n    0,\n  );\n}\n"],"mappings":"AAIO,SAASA,EAAIC,EAAgD,CAClE,OAAOA,EAAQ,OACb,CAACC,EAAqBC,IAAuC,CAC3D,IAAMC,EACJ,OAAOD,GAAY,UAAY,CAAC,MAAMA,CAAO,GAAK,SAASA,CAAO,EAC9DA,EACA,EAEN,OAAOD,EAAcE,CACvB,EACA,CACF,CACF","names":["sum","numbers","accumulated","current","value"]}
+{"version":3,"sources":["../src/asNumber.ts","../src/sum.ts"],"sourcesContent":["/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown): number {\n  // No transformation needed if u is already a number.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Try to make into a number if possible.\n  const n = Number(u);\n  if (typeof n === \"number\" && isFinite(n)) {\n    return n;\n  }\n\n  // Return 0 for everything else. This is usually ok if want to just ignore\n  // all other noise.\n  return 0;\n}\n","import { asNumber } from \"./asNumber\";\n\n/**\n * Add all the numbers together in the given array.\n * Non-numbers will be coerced into numbers if possible.\n */\nexport function sum(numbers: unknown[]): number {\n  return numbers.reduce((accumulated: number, current: unknown) => {\n    return accumulated + asNumber(current);\n  }, 0);\n}\n"],"mappings":"AAGO,SAASA,EAASC,EAAoB,CAE3C,GAAI,OAAOA,GAAM,UAAY,SAASA,CAAC,EACrC,OAAOA,EAIT,IAAMC,EAAI,OAAOD,CAAC,EAClB,OAAI,OAAOC,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKF,CACT,CCZO,SAASC,EAAIC,EAA4B,CAC9C,OAAOA,EAAQ,OAAO,CAACC,EAAqBC,IACnCD,EAAcE,EAASD,CAAO,EACpC,CAAC,CACN","names":["asNumber","u","n","sum","numbers","accumulated","current","asNumber"]}

package/sum.mjs

@@ -1,12 +1,20 @@
+// src/asNumber.ts
+function asNumber(u) {
+  if (typeof u === "number" && isFinite(u)) {
+    return u;
+  }
+  const n = Number(u);
+  if (typeof n === "number" && isFinite(n)) {
+    return n;
+  }
+  return 0;
+}
+
 // src/sum.ts
 function sum(numbers) {
-  return numbers.reduce(
-    (accumulated, current) => {
-      const value = typeof current === "number" && !isNaN(current) && isFinite(current) ? current : 0;
-      return accumulated + value;
-    },
-    0
-  );
+  return numbers.reduce((accumulated, current) => {
+    return accumulated + asNumber(current);
+  }, 0);
 }
 export {
   sum