@junobuild/utils 0.0.21 → 0.0.22

package/dist/browser/index.js

@@ -1,2 +1,2 @@
-var a=(r,n)=>{let o;return(...e)=>{let m=()=>r(...e);o&&clearTimeout(o),o=setTimeout(m,n!==void 0&&n>0?n:300)}};import{Principal as u}from"@dfinity/principal";var c=r=>r==null,t=r=>!c(r),i=class extends Error{},x=(r,n)=>{if(c(r))throw new i(n)};var s="__bigint__",f="__principal__",p="__uint8array__",T=(r,n)=>typeof n=="bigint"?{[s]:`${n}`}:t(n)&&n instanceof u?{[f]:n.toText()}:t(n)&&n instanceof Uint8Array?{[p]:Array.from(n)}:n,l=(r,n)=>{let o=e=>n[e];return t(n)&&typeof n=="object"&&s in n?BigInt(o(s)):t(n)&&typeof n=="object"&&f in n?u.fromText(o(f)):t(n)&&typeof n=="object"&&p in n?Uint8Array.from(o(p)):n};var g=r=>t(r)?[r]:[],j=r=>r?.[0],R=async r=>{let n=new Blob([JSON.stringify(r,T)],{type:"application/json; charset=utf-8"});return new Uint8Array(await n.arrayBuffer())},B=async r=>{let n=new Blob([r instanceof Uint8Array?r:new Uint8Array(r)],{type:"application/json; charset=utf-8"});return JSON.parse(await n.text(),l)};var h=()=>typeof window<"u";export{i as NullishError,x as assertNonNullish,a as debounce,B as fromArray,j as fromNullable,h as isBrowser,c as isNullish,T as jsonReplacer,l as jsonReviver,t as nonNullish,R as toArray,g as toNullable};
+var m=(r,n)=>{let o;return(...e)=>{let a=()=>r(...e);o&&clearTimeout(o),o=setTimeout(a,n!==void 0&&n>0?n:300)}};import{Principal as u}from"@dfinity/principal";var c=r=>r==null,t=r=>!c(r),i=class extends Error{},x=(r,n)=>{if(c(r))throw new i(n)};var s="__bigint__",f="__principal__",p="__uint8array__",T=(r,n)=>typeof n=="bigint"?{[s]:`${n}`}:t(n)&&n instanceof u?{[f]:n.toText()}:t(n)&&n instanceof Uint8Array?{[p]:Array.from(n)}:n,l=(r,n)=>{let o=e=>n[e];return t(n)&&typeof n=="object"&&s in n?BigInt(o(s)):t(n)&&typeof n=="object"&&f in n?u.fromText(o(f)):t(n)&&typeof n=="object"&&p in n?Uint8Array.from(o(p)):n};var g=r=>t(r)?[r]:[],j=r=>r?.[0],R=async r=>{let n=new Blob([JSON.stringify(r,T)],{type:"application/json; charset=utf-8"});return new Uint8Array(await n.arrayBuffer())},B=async r=>{let n=new Blob([r instanceof Uint8Array?r:new Uint8Array(r)],{type:"application/json; charset=utf-8"});return JSON.parse(await n.text(),l)};var h=()=>typeof window<"u";export{i as NullishError,x as assertNonNullish,m as debounce,B as fromArray,j as fromNullable,h as isBrowser,c as isNullish,T as jsonReplacer,l as jsonReviver,t as nonNullish,R as toArray,g as toNullable};
 //# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/debounce.utils.ts", "../../src/utils/json.utils.ts", "../../src/utils/null.utils.ts", "../../src/utils/did.utils.ts", "../../src/utils/env.utils.ts"],
-  "sourcesContent": ["/* eslint-disable-next-line @typescript-eslint/ban-types */\nexport const debounce = (func: Function, timeout?: number) => {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n\n  return (...args: unknown[]) => {\n    const next = () => func(...args);\n\n    if (timer) {\n      clearTimeout(timer);\n    }\n\n    timer = setTimeout(next, timeout !== undefined && timeout > 0 ? timeout : 300);\n  };\n};\n", "import {Principal} from '@dfinity/principal';\nimport {nonNullish} from './null.utils';\n\nconst JSON_KEY_BIGINT = '__bigint__';\nconst JSON_KEY_PRINCIPAL = '__principal__';\nconst JSON_KEY_UINT8ARRAY = '__uint8array__';\n\n/**\n * A parser that interprets revived BigInt, Principal, and Uint8Array when constructing JavaScript values or objects.\n */\nexport const jsonReplacer = (_key: string, value: unknown): unknown => {\n  if (typeof value === 'bigint') {\n    return {[JSON_KEY_BIGINT]: `${value}`};\n  }\n\n  if (nonNullish(value) && value instanceof Principal) {\n    return {[JSON_KEY_PRINCIPAL]: value.toText()};\n  }\n\n  if (nonNullish(value) && value instanceof Uint8Array) {\n    return {[JSON_KEY_UINT8ARRAY]: Array.from(value)};\n  }\n\n  return value;\n};\n\n/**\n * A function that alters the behavior of the stringification process for BigInt, Principal and Uint8Array.\n */\nexport const jsonReviver = (_key: string, value: unknown): unknown => {\n  const mapValue = <T>(key: string): T => (value as Record<string, T>)[key];\n\n  if (nonNullish(value) && typeof value === 'object' && JSON_KEY_BIGINT in value) {\n    return BigInt(mapValue(JSON_KEY_BIGINT));\n  }\n\n  if (nonNullish(value) && typeof value === 'object' && JSON_KEY_PRINCIPAL in value) {\n    return Principal.fromText(mapValue(JSON_KEY_PRINCIPAL));\n  }\n\n  if (nonNullish(value) && typeof value === 'object' && JSON_KEY_UINT8ARRAY in value) {\n    return Uint8Array.from(mapValue(JSON_KEY_UINT8ARRAY));\n  }\n\n  return value;\n};\n", "/** Is null or undefined */\nexport const isNullish = <T>(argument: T | undefined | null): argument is undefined | null =>\n  argument === null || argument === undefined;\n\n/** Not null and not undefined */\nexport const nonNullish = <T>(argument: T | undefined | null): argument is NonNullable<T> =>\n  !isNullish(argument);\n\nexport class NullishError extends Error {}\n\nexport const assertNonNullish: <T>(\n  value: T,\n  message?: string\n) => asserts value is NonNullable<T> = <T>(value: T, message?: string): void => {\n  if (isNullish(value)) {\n    throw new NullishError(message);\n  }\n};\n", "import {jsonReplacer, jsonReviver} from './json.utils';\nimport {nonNullish} from './null.utils';\n\nexport const toNullable = <T>(value?: T): [] | [T] => {\n  return nonNullish(value) ? [value] : [];\n};\n\nexport const fromNullable = <T>(value: [] | [T]): T | undefined => {\n  return value?.[0];\n};\n\nexport const toArray = async <T>(data: T): Promise<Uint8Array> => {\n  const blob: Blob = new Blob([JSON.stringify(data, jsonReplacer)], {\n    type: 'application/json; charset=utf-8'\n  });\n  return new Uint8Array(await blob.arrayBuffer());\n};\n\nexport const fromArray = async <T>(data: Uint8Array | number[]): Promise<T> => {\n  const blob: Blob = new Blob([data instanceof Uint8Array ? data : new Uint8Array(data)], {\n    type: 'application/json; charset=utf-8'\n  });\n  return JSON.parse(await blob.text(), jsonReviver);\n};\n", "export const isBrowser = () => typeof window !== `undefined`;\n"],
-  "mappings": "AACO,IAAMA,EAAW,CAACC,EAAgBC,IAAqB,CAC5D,IAAIC,EAEJ,MAAO,IAAIC,IAAoB,CAC7B,IAAMC,EAAO,IAAMJ,EAAK,GAAGG,CAAI,EAE3BD,GACF,aAAaA,CAAK,EAGpBA,EAAQ,WAAWE,EAAMH,IAAY,QAAaA,EAAU,EAAIA,EAAU,GAAG,CAC/E,CACF,ECbA,OAAQ,aAAAI,MAAgB,qBCCjB,IAAMC,EAAgBC,GAC3BA,GAAa,KAGFC,EAAiBD,GAC5B,CAACD,EAAUC,CAAQ,EAERE,EAAN,cAA2B,KAAM,CAAC,EAE5BC,EAG0B,CAAIC,EAAUC,IAA2B,CAC9E,GAAIN,EAAUK,CAAK,EACjB,MAAM,IAAIF,EAAaG,CAAO,CAElC,EDdA,IAAMC,EAAkB,aAClBC,EAAqB,gBACrBC,EAAsB,iBAKfC,EAAe,CAACC,EAAcC,IACrC,OAAOA,GAAU,SACZ,CAAC,CAACL,CAAe,EAAG,GAAGK,CAAK,EAAE,EAGnCC,EAAWD,CAAK,GAAKA,aAAiBE,EACjC,CAAC,CAACN,CAAkB,EAAGI,EAAM,OAAO,CAAC,EAG1CC,EAAWD,CAAK,GAAKA,aAAiB,WACjC,CAAC,CAACH,CAAmB,EAAG,MAAM,KAAKG,CAAK,CAAC,EAG3CA,EAMIG,EAAc,CAACJ,EAAcC,IAA4B,CACpE,IAAMI,EAAeC,GAAoBL,EAA4BK,CAAG,EAExE,OAAIJ,EAAWD,CAAK,GAAK,OAAOA,GAAU,UAAYL,KAAmBK,EAChE,OAAOI,EAAST,CAAe,CAAC,EAGrCM,EAAWD,CAAK,GAAK,OAAOA,GAAU,UAAYJ,KAAsBI,EACnEE,EAAU,SAASE,EAASR,CAAkB,CAAC,EAGpDK,EAAWD,CAAK,GAAK,OAAOA,GAAU,UAAYH,KAAuBG,EACpE,WAAW,KAAKI,EAASP,CAAmB,CAAC,EAG/CG,CACT,EE1CO,IAAMM,EAAiBC,GACrBC,EAAWD,CAAK,EAAI,CAACA,CAAK,EAAI,CAAC,EAG3BE,EAAmBF,GACvBA,IAAQ,CAAC,EAGLG,EAAU,MAAUC,GAAiC,CAChE,IAAMC,EAAa,IAAI,KAAK,CAAC,KAAK,UAAUD,EAAME,CAAY,CAAC,EAAG,CAChE,KAAM,iCACR,CAAC,EACD,OAAO,IAAI,WAAW,MAAMD,EAAK,YAAY,CAAC,CAChD,EAEaE,EAAY,MAAUH,GAA4C,CAC7E,IAAMC,EAAa,IAAI,KAAK,CAACD,aAAgB,WAAaA,EAAO,IAAI,WAAWA,CAAI,CAAC,EAAG,CACtF,KAAM,iCACR,CAAC,EACD,OAAO,KAAK,MAAM,MAAMC,EAAK,KAAK,EAAGG,CAAW,CAClD,ECvBO,IAAMC,EAAY,IAAM,OAAO,OAAW",
+  "sourcesContent": ["/**\n * Creates a debounced function that delays invoking the provided function until after the specified timeout.\n * @param {Function} func - The function to debounce.\n * @param {number} [timeout=300] - The number of milliseconds to delay. Defaults to 300ms if not specified or invalid.\n * @returns {Function} A debounced function.\n */\n/* eslint-disable-next-line @typescript-eslint/ban-types */\nexport const debounce = (func: Function, timeout?: number): Function => {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n\n  return (...args: unknown[]) => {\n    const next = () => func(...args);\n\n    if (timer) {\n      clearTimeout(timer);\n    }\n\n    timer = setTimeout(next, timeout !== undefined && timeout > 0 ? timeout : 300);\n  };\n};\n", "import {Principal} from '@dfinity/principal';\nimport {nonNullish} from './null.utils';\n\nconst JSON_KEY_BIGINT = '__bigint__';\nconst JSON_KEY_PRINCIPAL = '__principal__';\nconst JSON_KEY_UINT8ARRAY = '__uint8array__';\n\n/**\n * A function that alters the behavior of the stringification process for BigInt, Principal, and Uint8Array.\n * @param {string} _key - The key of the value being stringified.\n * @param {unknown} value - The value being stringified.\n * @returns {unknown} The altered value for stringification.\n */\nexport const jsonReplacer = (_key: string, value: unknown): unknown => {\n  if (typeof value === 'bigint') {\n    return {[JSON_KEY_BIGINT]: `${value}`};\n  }\n\n  if (nonNullish(value) && value instanceof Principal) {\n    return {[JSON_KEY_PRINCIPAL]: value.toText()};\n  }\n\n  if (nonNullish(value) && value instanceof Uint8Array) {\n    return {[JSON_KEY_UINT8ARRAY]: Array.from(value)};\n  }\n\n  return value;\n};\n\n/**\n * A parser that interprets revived BigInt, Principal, and Uint8Array when constructing JavaScript values or objects.\n * @param {string} _key - The key of the value being parsed.\n * @param {unknown} value - The value being parsed.\n * @returns {unknown} The parsed value.\n */\nexport const jsonReviver = (_key: string, value: unknown): unknown => {\n  const mapValue = <T>(key: string): T => (value as Record<string, T>)[key];\n\n  if (nonNullish(value) && typeof value === 'object' && JSON_KEY_BIGINT in value) {\n    return BigInt(mapValue(JSON_KEY_BIGINT));\n  }\n\n  if (nonNullish(value) && typeof value === 'object' && JSON_KEY_PRINCIPAL in value) {\n    return Principal.fromText(mapValue(JSON_KEY_PRINCIPAL));\n  }\n\n  if (nonNullish(value) && typeof value === 'object' && JSON_KEY_UINT8ARRAY in value) {\n    return Uint8Array.from(mapValue(JSON_KEY_UINT8ARRAY));\n  }\n\n  return value;\n};\n", "/**\n * Checks if the provided argument is null or undefined.\n * @template T\n * @param {T | undefined | null} argument - The argument to check.\n * @returns {boolean} True if the argument is null or undefined, false otherwise.\n */\nexport const isNullish = <T>(argument: T | undefined | null): argument is undefined | null =>\n  argument === null || argument === undefined;\n\n/**\n * Checks if the provided argument is neither null nor undefined.\n * @template T\n * @param {T | undefined | null} argument - The argument to check.\n * @returns {boolean} True if the argument is neither null nor undefined, false otherwise.\n */\nexport const nonNullish = <T>(argument: T | undefined | null): argument is NonNullable<T> =>\n  !isNullish(argument);\n\n/**\n * Represents an error thrown when a value is null or undefined.\n * @class\n * @extends {Error}\n */\nexport class NullishError extends Error {}\n\n/**\n * Asserts that a value is neither null nor undefined.\n * @template T\n * @param {T} value - The value to check.\n * @param {string} [message] - The optional error message to use if the assertion fails.\n * @throws {NullishError} If the value is null or undefined.\n * @returns {asserts value is NonNullable<T>} Asserts that the value is neither null nor undefined.\n */\nexport const assertNonNullish: <T>(\n  value: T,\n  message?: string\n) => asserts value is NonNullable<T> = <T>(value: T, message?: string): void => {\n  if (isNullish(value)) {\n    throw new NullishError(message);\n  }\n};\n", "import {jsonReplacer, jsonReviver} from './json.utils';\nimport {nonNullish} from './null.utils';\n\n/**\n * Converts a value to a nullable array.\n * @template T\n * @param {T} [value] - The value to convert.\n * @returns {([] | [T])} A nullable array containing the value if non-nullish, or an empty array if nullish.\n */\nexport const toNullable = <T>(value?: T): [] | [T] => {\n  return nonNullish(value) ? [value] : [];\n};\n\n/**\n * Extracts a value from a nullable array.\n * @template T\n * @param {([] | [T])} value - The nullable array.\n * @returns {(T | undefined)} The value if present, or undefined if the array is empty.\n */\nexport const fromNullable = <T>(value: [] | [T]): T | undefined => {\n  return value?.[0];\n};\n\n/**\n * Converts data to a Uint8Array for transmission or storage.\n * @template T\n * @param {T} data - The data to convert.\n * @returns {Promise<Uint8Array>} A promise that resolves to a Uint8Array representation of the data.\n */\nexport const toArray = async <T>(data: T): Promise<Uint8Array> => {\n  const blob: Blob = new Blob([JSON.stringify(data, jsonReplacer)], {\n    type: 'application/json; charset=utf-8'\n  });\n  return new Uint8Array(await blob.arrayBuffer());\n};\n\n/**\n * Converts a Uint8Array or number array back to the original data type.\n * @template T\n * @param {(Uint8Array | number[])} data - The array to convert.\n * @returns {Promise<T>} A promise that resolves to the original data.\n */\nexport const fromArray = async <T>(data: Uint8Array | number[]): Promise<T> => {\n  const blob: Blob = new Blob([data instanceof Uint8Array ? data : new Uint8Array(data)], {\n    type: 'application/json; charset=utf-8'\n  });\n  return JSON.parse(await blob.text(), jsonReviver);\n};\n", "/**\n * Checks if the current environment is a browser.\n * @returns {boolean} True if the current environment is a browser, false otherwise.\n */\nexport const isBrowser = (): boolean => typeof window !== `undefined`;\n"],
+  "mappings": "AAOO,IAAMA,EAAW,CAACC,EAAgBC,IAA+B,CACtE,IAAIC,EAEJ,MAAO,IAAIC,IAAoB,CAC7B,IAAMC,EAAO,IAAMJ,EAAK,GAAGG,CAAI,EAE3BD,GACF,aAAaA,CAAK,EAGpBA,EAAQ,WAAWE,EAAMH,IAAY,QAAaA,EAAU,EAAIA,EAAU,GAAG,CAC/E,CACF,ECnBA,OAAQ,aAAAI,MAAgB,qBCMjB,IAAMC,EAAgBC,GAC3BA,GAAa,KAQFC,EAAiBD,GAC5B,CAACD,EAAUC,CAAQ,EAORE,EAAN,cAA2B,KAAM,CAAC,EAU5BC,EAG0B,CAAIC,EAAUC,IAA2B,CAC9E,GAAIN,EAAUK,CAAK,EACjB,MAAM,IAAIF,EAAaG,CAAO,CAElC,EDrCA,IAAMC,EAAkB,aAClBC,EAAqB,gBACrBC,EAAsB,iBAQfC,EAAe,CAACC,EAAcC,IACrC,OAAOA,GAAU,SACZ,CAAC,CAACL,CAAe,EAAG,GAAGK,CAAK,EAAE,EAGnCC,EAAWD,CAAK,GAAKA,aAAiBE,EACjC,CAAC,CAACN,CAAkB,EAAGI,EAAM,OAAO,CAAC,EAG1CC,EAAWD,CAAK,GAAKA,aAAiB,WACjC,CAAC,CAACH,CAAmB,EAAG,MAAM,KAAKG,CAAK,CAAC,EAG3CA,EASIG,EAAc,CAACJ,EAAcC,IAA4B,CACpE,IAAMI,EAAeC,GAAoBL,EAA4BK,CAAG,EAExE,OAAIJ,EAAWD,CAAK,GAAK,OAAOA,GAAU,UAAYL,KAAmBK,EAChE,OAAOI,EAAST,CAAe,CAAC,EAGrCM,EAAWD,CAAK,GAAK,OAAOA,GAAU,UAAYJ,KAAsBI,EACnEE,EAAU,SAASE,EAASR,CAAkB,CAAC,EAGpDK,EAAWD,CAAK,GAAK,OAAOA,GAAU,UAAYH,KAAuBG,EACpE,WAAW,KAAKI,EAASP,CAAmB,CAAC,EAG/CG,CACT,EE1CO,IAAMM,EAAiBC,GACrBC,EAAWD,CAAK,EAAI,CAACA,CAAK,EAAI,CAAC,EAS3BE,EAAmBF,GACvBA,IAAQ,CAAC,EASLG,EAAU,MAAUC,GAAiC,CAChE,IAAMC,EAAa,IAAI,KAAK,CAAC,KAAK,UAAUD,EAAME,CAAY,CAAC,EAAG,CAChE,KAAM,iCACR,CAAC,EACD,OAAO,IAAI,WAAW,MAAMD,EAAK,YAAY,CAAC,CAChD,EAQaE,EAAY,MAAUH,GAA4C,CAC7E,IAAMC,EAAa,IAAI,KAAK,CAACD,aAAgB,WAAaA,EAAO,IAAI,WAAWA,CAAI,CAAC,EAAG,CACtF,KAAM,iCACR,CAAC,EACD,OAAO,KAAK,MAAM,MAAMC,EAAK,KAAK,EAAGG,CAAW,CAClD,EC3CO,IAAMC,EAAY,IAAe,OAAO,OAAW",
   "names": ["debounce", "func", "timeout", "timer", "args", "next", "Principal", "isNullish", "argument", "nonNullish", "NullishError", "assertNonNullish", "value", "message", "JSON_KEY_BIGINT", "JSON_KEY_PRINCIPAL", "JSON_KEY_UINT8ARRAY", "jsonReplacer", "_key", "value", "nonNullish", "Principal", "jsonReviver", "mapValue", "key", "toNullable", "value", "nonNullish", "fromNullable", "toArray", "data", "blob", "jsonReplacer", "fromArray", "jsonReviver", "isBrowser"]
 }

package/dist/node/index.mjs

@@ -1,4 +1,4 @@
 import { createRequire as topLevelCreateRequire } from 'module';
  const require = topLevelCreateRequire(import.meta.url);
-var a=(r,n)=>{let o;return(...e)=>{let m=()=>r(...e);o&&clearTimeout(o),o=setTimeout(m,n!==void 0&&n>0?n:300)}};import{Principal as u}from"@dfinity/principal";var c=r=>r==null,t=r=>!c(r),i=class extends Error{},x=(r,n)=>{if(c(r))throw new i(n)};var s="__bigint__",f="__principal__",p="__uint8array__",T=(r,n)=>typeof n=="bigint"?{[s]:`${n}`}:t(n)&&n instanceof u?{[f]:n.toText()}:t(n)&&n instanceof Uint8Array?{[p]:Array.from(n)}:n,l=(r,n)=>{let o=e=>n[e];return t(n)&&typeof n=="object"&&s in n?BigInt(o(s)):t(n)&&typeof n=="object"&&f in n?u.fromText(o(f)):t(n)&&typeof n=="object"&&p in n?Uint8Array.from(o(p)):n};var g=r=>t(r)?[r]:[],j=r=>r?.[0],R=async r=>{let n=new Blob([JSON.stringify(r,T)],{type:"application/json; charset=utf-8"});return new Uint8Array(await n.arrayBuffer())},B=async r=>{let n=new Blob([r instanceof Uint8Array?r:new Uint8Array(r)],{type:"application/json; charset=utf-8"});return JSON.parse(await n.text(),l)};var h=()=>typeof window<"u";export{i as NullishError,x as assertNonNullish,a as debounce,B as fromArray,j as fromNullable,h as isBrowser,c as isNullish,T as jsonReplacer,l as jsonReviver,t as nonNullish,R as toArray,g as toNullable};
+var m=(r,n)=>{let o;return(...e)=>{let a=()=>r(...e);o&&clearTimeout(o),o=setTimeout(a,n!==void 0&&n>0?n:300)}};import{Principal as u}from"@dfinity/principal";var c=r=>r==null,t=r=>!c(r),i=class extends Error{},x=(r,n)=>{if(c(r))throw new i(n)};var s="__bigint__",f="__principal__",p="__uint8array__",T=(r,n)=>typeof n=="bigint"?{[s]:`${n}`}:t(n)&&n instanceof u?{[f]:n.toText()}:t(n)&&n instanceof Uint8Array?{[p]:Array.from(n)}:n,l=(r,n)=>{let o=e=>n[e];return t(n)&&typeof n=="object"&&s in n?BigInt(o(s)):t(n)&&typeof n=="object"&&f in n?u.fromText(o(f)):t(n)&&typeof n=="object"&&p in n?Uint8Array.from(o(p)):n};var g=r=>t(r)?[r]:[],j=r=>r?.[0],R=async r=>{let n=new Blob([JSON.stringify(r,T)],{type:"application/json; charset=utf-8"});return new Uint8Array(await n.arrayBuffer())},B=async r=>{let n=new Blob([r instanceof Uint8Array?r:new Uint8Array(r)],{type:"application/json; charset=utf-8"});return JSON.parse(await n.text(),l)};var h=()=>typeof window<"u";export{i as NullishError,x as assertNonNullish,m as debounce,B as fromArray,j as fromNullable,h as isBrowser,c as isNullish,T as jsonReplacer,l as jsonReviver,t as nonNullish,R as toArray,g as toNullable};
 //# sourceMappingURL=index.mjs.map

package/dist/node/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/debounce.utils.ts", "../../src/utils/json.utils.ts", "../../src/utils/null.utils.ts", "../../src/utils/did.utils.ts", "../../src/utils/env.utils.ts"],
-  "sourcesContent": ["/* eslint-disable-next-line @typescript-eslint/ban-types */\nexport const debounce = (func: Function, timeout?: number) => {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n\n  return (...args: unknown[]) => {\n    const next = () => func(...args);\n\n    if (timer) {\n      clearTimeout(timer);\n    }\n\n    timer = setTimeout(next, timeout !== undefined && timeout > 0 ? timeout : 300);\n  };\n};\n", "import {Principal} from '@dfinity/principal';\nimport {nonNullish} from './null.utils';\n\nconst JSON_KEY_BIGINT = '__bigint__';\nconst JSON_KEY_PRINCIPAL = '__principal__';\nconst JSON_KEY_UINT8ARRAY = '__uint8array__';\n\n/**\n * A parser that interprets revived BigInt, Principal, and Uint8Array when constructing JavaScript values or objects.\n */\nexport const jsonReplacer = (_key: string, value: unknown): unknown => {\n  if (typeof value === 'bigint') {\n    return {[JSON_KEY_BIGINT]: `${value}`};\n  }\n\n  if (nonNullish(value) && value instanceof Principal) {\n    return {[JSON_KEY_PRINCIPAL]: value.toText()};\n  }\n\n  if (nonNullish(value) && value instanceof Uint8Array) {\n    return {[JSON_KEY_UINT8ARRAY]: Array.from(value)};\n  }\n\n  return value;\n};\n\n/**\n * A function that alters the behavior of the stringification process for BigInt, Principal and Uint8Array.\n */\nexport const jsonReviver = (_key: string, value: unknown): unknown => {\n  const mapValue = <T>(key: string): T => (value as Record<string, T>)[key];\n\n  if (nonNullish(value) && typeof value === 'object' && JSON_KEY_BIGINT in value) {\n    return BigInt(mapValue(JSON_KEY_BIGINT));\n  }\n\n  if (nonNullish(value) && typeof value === 'object' && JSON_KEY_PRINCIPAL in value) {\n    return Principal.fromText(mapValue(JSON_KEY_PRINCIPAL));\n  }\n\n  if (nonNullish(value) && typeof value === 'object' && JSON_KEY_UINT8ARRAY in value) {\n    return Uint8Array.from(mapValue(JSON_KEY_UINT8ARRAY));\n  }\n\n  return value;\n};\n", "/** Is null or undefined */\nexport const isNullish = <T>(argument: T | undefined | null): argument is undefined | null =>\n  argument === null || argument === undefined;\n\n/** Not null and not undefined */\nexport const nonNullish = <T>(argument: T | undefined | null): argument is NonNullable<T> =>\n  !isNullish(argument);\n\nexport class NullishError extends Error {}\n\nexport const assertNonNullish: <T>(\n  value: T,\n  message?: string\n) => asserts value is NonNullable<T> = <T>(value: T, message?: string): void => {\n  if (isNullish(value)) {\n    throw new NullishError(message);\n  }\n};\n", "import {jsonReplacer, jsonReviver} from './json.utils';\nimport {nonNullish} from './null.utils';\n\nexport const toNullable = <T>(value?: T): [] | [T] => {\n  return nonNullish(value) ? [value] : [];\n};\n\nexport const fromNullable = <T>(value: [] | [T]): T | undefined => {\n  return value?.[0];\n};\n\nexport const toArray = async <T>(data: T): Promise<Uint8Array> => {\n  const blob: Blob = new Blob([JSON.stringify(data, jsonReplacer)], {\n    type: 'application/json; charset=utf-8'\n  });\n  return new Uint8Array(await blob.arrayBuffer());\n};\n\nexport const fromArray = async <T>(data: Uint8Array | number[]): Promise<T> => {\n  const blob: Blob = new Blob([data instanceof Uint8Array ? data : new Uint8Array(data)], {\n    type: 'application/json; charset=utf-8'\n  });\n  return JSON.parse(await blob.text(), jsonReviver);\n};\n", "export const isBrowser = () => typeof window !== `undefined`;\n"],
-  "mappings": ";;AACO,IAAMA,EAAW,CAACC,EAAgBC,IAAqB,CAC5D,IAAIC,EAEJ,MAAO,IAAIC,IAAoB,CAC7B,IAAMC,EAAO,IAAMJ,EAAK,GAAGG,CAAI,EAE3BD,GACF,aAAaA,CAAK,EAGpBA,EAAQ,WAAWE,EAAMH,IAAY,QAAaA,EAAU,EAAIA,EAAU,GAAG,CAC/E,CACF,ECbA,OAAQ,aAAAI,MAAgB,qBCCjB,IAAMC,EAAgBC,GAC3BA,GAAa,KAGFC,EAAiBD,GAC5B,CAACD,EAAUC,CAAQ,EAERE,EAAN,cAA2B,KAAM,CAAC,EAE5BC,EAG0B,CAAIC,EAAUC,IAA2B,CAC9E,GAAIN,EAAUK,CAAK,EACjB,MAAM,IAAIF,EAAaG,CAAO,CAElC,EDdA,IAAMC,EAAkB,aAClBC,EAAqB,gBACrBC,EAAsB,iBAKfC,EAAe,CAACC,EAAcC,IACrC,OAAOA,GAAU,SACZ,CAAC,CAACL,CAAe,EAAG,GAAGK,CAAK,EAAE,EAGnCC,EAAWD,CAAK,GAAKA,aAAiBE,EACjC,CAAC,CAACN,CAAkB,EAAGI,EAAM,OAAO,CAAC,EAG1CC,EAAWD,CAAK,GAAKA,aAAiB,WACjC,CAAC,CAACH,CAAmB,EAAG,MAAM,KAAKG,CAAK,CAAC,EAG3CA,EAMIG,EAAc,CAACJ,EAAcC,IAA4B,CACpE,IAAMI,EAAeC,GAAoBL,EAA4BK,CAAG,EAExE,OAAIJ,EAAWD,CAAK,GAAK,OAAOA,GAAU,UAAYL,KAAmBK,EAChE,OAAOI,EAAST,CAAe,CAAC,EAGrCM,EAAWD,CAAK,GAAK,OAAOA,GAAU,UAAYJ,KAAsBI,EACnEE,EAAU,SAASE,EAASR,CAAkB,CAAC,EAGpDK,EAAWD,CAAK,GAAK,OAAOA,GAAU,UAAYH,KAAuBG,EACpE,WAAW,KAAKI,EAASP,CAAmB,CAAC,EAG/CG,CACT,EE1CO,IAAMM,EAAiBC,GACrBC,EAAWD,CAAK,EAAI,CAACA,CAAK,EAAI,CAAC,EAG3BE,EAAmBF,GACvBA,IAAQ,CAAC,EAGLG,EAAU,MAAUC,GAAiC,CAChE,IAAMC,EAAa,IAAI,KAAK,CAAC,KAAK,UAAUD,EAAME,CAAY,CAAC,EAAG,CAChE,KAAM,iCACR,CAAC,EACD,OAAO,IAAI,WAAW,MAAMD,EAAK,YAAY,CAAC,CAChD,EAEaE,EAAY,MAAUH,GAA4C,CAC7E,IAAMC,EAAa,IAAI,KAAK,CAACD,aAAgB,WAAaA,EAAO,IAAI,WAAWA,CAAI,CAAC,EAAG,CACtF,KAAM,iCACR,CAAC,EACD,OAAO,KAAK,MAAM,MAAMC,EAAK,KAAK,EAAGG,CAAW,CAClD,ECvBO,IAAMC,EAAY,IAAM,OAAO,OAAW",
+  "sourcesContent": ["/**\n * Creates a debounced function that delays invoking the provided function until after the specified timeout.\n * @param {Function} func - The function to debounce.\n * @param {number} [timeout=300] - The number of milliseconds to delay. Defaults to 300ms if not specified or invalid.\n * @returns {Function} A debounced function.\n */\n/* eslint-disable-next-line @typescript-eslint/ban-types */\nexport const debounce = (func: Function, timeout?: number): Function => {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n\n  return (...args: unknown[]) => {\n    const next = () => func(...args);\n\n    if (timer) {\n      clearTimeout(timer);\n    }\n\n    timer = setTimeout(next, timeout !== undefined && timeout > 0 ? timeout : 300);\n  };\n};\n", "import {Principal} from '@dfinity/principal';\nimport {nonNullish} from './null.utils';\n\nconst JSON_KEY_BIGINT = '__bigint__';\nconst JSON_KEY_PRINCIPAL = '__principal__';\nconst JSON_KEY_UINT8ARRAY = '__uint8array__';\n\n/**\n * A function that alters the behavior of the stringification process for BigInt, Principal, and Uint8Array.\n * @param {string} _key - The key of the value being stringified.\n * @param {unknown} value - The value being stringified.\n * @returns {unknown} The altered value for stringification.\n */\nexport const jsonReplacer = (_key: string, value: unknown): unknown => {\n  if (typeof value === 'bigint') {\n    return {[JSON_KEY_BIGINT]: `${value}`};\n  }\n\n  if (nonNullish(value) && value instanceof Principal) {\n    return {[JSON_KEY_PRINCIPAL]: value.toText()};\n  }\n\n  if (nonNullish(value) && value instanceof Uint8Array) {\n    return {[JSON_KEY_UINT8ARRAY]: Array.from(value)};\n  }\n\n  return value;\n};\n\n/**\n * A parser that interprets revived BigInt, Principal, and Uint8Array when constructing JavaScript values or objects.\n * @param {string} _key - The key of the value being parsed.\n * @param {unknown} value - The value being parsed.\n * @returns {unknown} The parsed value.\n */\nexport const jsonReviver = (_key: string, value: unknown): unknown => {\n  const mapValue = <T>(key: string): T => (value as Record<string, T>)[key];\n\n  if (nonNullish(value) && typeof value === 'object' && JSON_KEY_BIGINT in value) {\n    return BigInt(mapValue(JSON_KEY_BIGINT));\n  }\n\n  if (nonNullish(value) && typeof value === 'object' && JSON_KEY_PRINCIPAL in value) {\n    return Principal.fromText(mapValue(JSON_KEY_PRINCIPAL));\n  }\n\n  if (nonNullish(value) && typeof value === 'object' && JSON_KEY_UINT8ARRAY in value) {\n    return Uint8Array.from(mapValue(JSON_KEY_UINT8ARRAY));\n  }\n\n  return value;\n};\n", "/**\n * Checks if the provided argument is null or undefined.\n * @template T\n * @param {T | undefined | null} argument - The argument to check.\n * @returns {boolean} True if the argument is null or undefined, false otherwise.\n */\nexport const isNullish = <T>(argument: T | undefined | null): argument is undefined | null =>\n  argument === null || argument === undefined;\n\n/**\n * Checks if the provided argument is neither null nor undefined.\n * @template T\n * @param {T | undefined | null} argument - The argument to check.\n * @returns {boolean} True if the argument is neither null nor undefined, false otherwise.\n */\nexport const nonNullish = <T>(argument: T | undefined | null): argument is NonNullable<T> =>\n  !isNullish(argument);\n\n/**\n * Represents an error thrown when a value is null or undefined.\n * @class\n * @extends {Error}\n */\nexport class NullishError extends Error {}\n\n/**\n * Asserts that a value is neither null nor undefined.\n * @template T\n * @param {T} value - The value to check.\n * @param {string} [message] - The optional error message to use if the assertion fails.\n * @throws {NullishError} If the value is null or undefined.\n * @returns {asserts value is NonNullable<T>} Asserts that the value is neither null nor undefined.\n */\nexport const assertNonNullish: <T>(\n  value: T,\n  message?: string\n) => asserts value is NonNullable<T> = <T>(value: T, message?: string): void => {\n  if (isNullish(value)) {\n    throw new NullishError(message);\n  }\n};\n", "import {jsonReplacer, jsonReviver} from './json.utils';\nimport {nonNullish} from './null.utils';\n\n/**\n * Converts a value to a nullable array.\n * @template T\n * @param {T} [value] - The value to convert.\n * @returns {([] | [T])} A nullable array containing the value if non-nullish, or an empty array if nullish.\n */\nexport const toNullable = <T>(value?: T): [] | [T] => {\n  return nonNullish(value) ? [value] : [];\n};\n\n/**\n * Extracts a value from a nullable array.\n * @template T\n * @param {([] | [T])} value - The nullable array.\n * @returns {(T | undefined)} The value if present, or undefined if the array is empty.\n */\nexport const fromNullable = <T>(value: [] | [T]): T | undefined => {\n  return value?.[0];\n};\n\n/**\n * Converts data to a Uint8Array for transmission or storage.\n * @template T\n * @param {T} data - The data to convert.\n * @returns {Promise<Uint8Array>} A promise that resolves to a Uint8Array representation of the data.\n */\nexport const toArray = async <T>(data: T): Promise<Uint8Array> => {\n  const blob: Blob = new Blob([JSON.stringify(data, jsonReplacer)], {\n    type: 'application/json; charset=utf-8'\n  });\n  return new Uint8Array(await blob.arrayBuffer());\n};\n\n/**\n * Converts a Uint8Array or number array back to the original data type.\n * @template T\n * @param {(Uint8Array | number[])} data - The array to convert.\n * @returns {Promise<T>} A promise that resolves to the original data.\n */\nexport const fromArray = async <T>(data: Uint8Array | number[]): Promise<T> => {\n  const blob: Blob = new Blob([data instanceof Uint8Array ? data : new Uint8Array(data)], {\n    type: 'application/json; charset=utf-8'\n  });\n  return JSON.parse(await blob.text(), jsonReviver);\n};\n", "/**\n * Checks if the current environment is a browser.\n * @returns {boolean} True if the current environment is a browser, false otherwise.\n */\nexport const isBrowser = (): boolean => typeof window !== `undefined`;\n"],
+  "mappings": ";;AAOO,IAAMA,EAAW,CAACC,EAAgBC,IAA+B,CACtE,IAAIC,EAEJ,MAAO,IAAIC,IAAoB,CAC7B,IAAMC,EAAO,IAAMJ,EAAK,GAAGG,CAAI,EAE3BD,GACF,aAAaA,CAAK,EAGpBA,EAAQ,WAAWE,EAAMH,IAAY,QAAaA,EAAU,EAAIA,EAAU,GAAG,CAC/E,CACF,ECnBA,OAAQ,aAAAI,MAAgB,qBCMjB,IAAMC,EAAgBC,GAC3BA,GAAa,KAQFC,EAAiBD,GAC5B,CAACD,EAAUC,CAAQ,EAORE,EAAN,cAA2B,KAAM,CAAC,EAU5BC,EAG0B,CAAIC,EAAUC,IAA2B,CAC9E,GAAIN,EAAUK,CAAK,EACjB,MAAM,IAAIF,EAAaG,CAAO,CAElC,EDrCA,IAAMC,EAAkB,aAClBC,EAAqB,gBACrBC,EAAsB,iBAQfC,EAAe,CAACC,EAAcC,IACrC,OAAOA,GAAU,SACZ,CAAC,CAACL,CAAe,EAAG,GAAGK,CAAK,EAAE,EAGnCC,EAAWD,CAAK,GAAKA,aAAiBE,EACjC,CAAC,CAACN,CAAkB,EAAGI,EAAM,OAAO,CAAC,EAG1CC,EAAWD,CAAK,GAAKA,aAAiB,WACjC,CAAC,CAACH,CAAmB,EAAG,MAAM,KAAKG,CAAK,CAAC,EAG3CA,EASIG,EAAc,CAACJ,EAAcC,IAA4B,CACpE,IAAMI,EAAeC,GAAoBL,EAA4BK,CAAG,EAExE,OAAIJ,EAAWD,CAAK,GAAK,OAAOA,GAAU,UAAYL,KAAmBK,EAChE,OAAOI,EAAST,CAAe,CAAC,EAGrCM,EAAWD,CAAK,GAAK,OAAOA,GAAU,UAAYJ,KAAsBI,EACnEE,EAAU,SAASE,EAASR,CAAkB,CAAC,EAGpDK,EAAWD,CAAK,GAAK,OAAOA,GAAU,UAAYH,KAAuBG,EACpE,WAAW,KAAKI,EAASP,CAAmB,CAAC,EAG/CG,CACT,EE1CO,IAAMM,EAAiBC,GACrBC,EAAWD,CAAK,EAAI,CAACA,CAAK,EAAI,CAAC,EAS3BE,EAAmBF,GACvBA,IAAQ,CAAC,EASLG,EAAU,MAAUC,GAAiC,CAChE,IAAMC,EAAa,IAAI,KAAK,CAAC,KAAK,UAAUD,EAAME,CAAY,CAAC,EAAG,CAChE,KAAM,iCACR,CAAC,EACD,OAAO,IAAI,WAAW,MAAMD,EAAK,YAAY,CAAC,CAChD,EAQaE,EAAY,MAAUH,GAA4C,CAC7E,IAAMC,EAAa,IAAI,KAAK,CAACD,aAAgB,WAAaA,EAAO,IAAI,WAAWA,CAAI,CAAC,EAAG,CACtF,KAAM,iCACR,CAAC,EACD,OAAO,KAAK,MAAM,MAAMC,EAAK,KAAK,EAAGG,CAAW,CAClD,EC3CO,IAAMC,EAAY,IAAe,OAAO,OAAW",
   "names": ["debounce", "func", "timeout", "timer", "args", "next", "Principal", "isNullish", "argument", "nonNullish", "NullishError", "assertNonNullish", "value", "message", "JSON_KEY_BIGINT", "JSON_KEY_PRINCIPAL", "JSON_KEY_UINT8ARRAY", "jsonReplacer", "_key", "value", "nonNullish", "Principal", "jsonReviver", "mapValue", "key", "toNullable", "value", "nonNullish", "fromNullable", "toArray", "data", "blob", "jsonReplacer", "fromArray", "jsonReviver", "isBrowser"]
 }

package/dist/types/utils/debounce.utils.d.ts

@@ -1 +1,7 @@
-export declare const debounce: (func: Function, timeout?: number) => (...args: unknown[]) => void;
+/**
+ * Creates a debounced function that delays invoking the provided function until after the specified timeout.
+ * @param {Function} func - The function to debounce.
+ * @param {number} [timeout=300] - The number of milliseconds to delay. Defaults to 300ms if not specified or invalid.
+ * @returns {Function} A debounced function.
+ */
+export declare const debounce: (func: Function, timeout?: number) => Function;

package/dist/types/utils/did.utils.d.ts

@@ -1,4 +1,28 @@
+/**
+ * Converts a value to a nullable array.
+ * @template T
+ * @param {T} [value] - The value to convert.
+ * @returns {([] | [T])} A nullable array containing the value if non-nullish, or an empty array if nullish.
+ */
 export declare const toNullable: <T>(value?: T) => [] | [T];
+/**
+ * Extracts a value from a nullable array.
+ * @template T
+ * @param {([] | [T])} value - The nullable array.
+ * @returns {(T | undefined)} The value if present, or undefined if the array is empty.
+ */
 export declare const fromNullable: <T>(value: [] | [T]) => T | undefined;
+/**
+ * Converts data to a Uint8Array for transmission or storage.
+ * @template T
+ * @param {T} data - The data to convert.
+ * @returns {Promise<Uint8Array>} A promise that resolves to a Uint8Array representation of the data.
+ */
 export declare const toArray: <T>(data: T) => Promise<Uint8Array>;
+/**
+ * Converts a Uint8Array or number array back to the original data type.
+ * @template T
+ * @param {(Uint8Array | number[])} data - The array to convert.
+ * @returns {Promise<T>} A promise that resolves to the original data.
+ */
 export declare const fromArray: <T>(data: Uint8Array | number[]) => Promise<T>;

package/dist/types/utils/env.utils.d.ts

@@ -1 +1,5 @@
+/**
+ * Checks if the current environment is a browser.
+ * @returns {boolean} True if the current environment is a browser, false otherwise.
+ */
 export declare const isBrowser: () => boolean;

package/dist/types/utils/json.utils.d.ts

@@ -1,8 +1,14 @@
 /**
- * A parser that interprets revived BigInt, Principal, and Uint8Array when constructing JavaScript values or objects.
+ * A function that alters the behavior of the stringification process for BigInt, Principal, and Uint8Array.
+ * @param {string} _key - The key of the value being stringified.
+ * @param {unknown} value - The value being stringified.
+ * @returns {unknown} The altered value for stringification.
  */
 export declare const jsonReplacer: (_key: string, value: unknown) => unknown;
 /**
- * A function that alters the behavior of the stringification process for BigInt, Principal and Uint8Array.
+ * A parser that interprets revived BigInt, Principal, and Uint8Array when constructing JavaScript values or objects.
+ * @param {string} _key - The key of the value being parsed.
+ * @param {unknown} value - The value being parsed.
+ * @returns {unknown} The parsed value.
  */
 export declare const jsonReviver: (_key: string, value: unknown) => unknown;

package/dist/types/utils/null.utils.d.ts

@@ -1,7 +1,30 @@
-/** Is null or undefined */
+/**
+ * Checks if the provided argument is null or undefined.
+ * @template T
+ * @param {T | undefined | null} argument - The argument to check.
+ * @returns {boolean} True if the argument is null or undefined, false otherwise.
+ */
 export declare const isNullish: <T>(argument: T | undefined | null) => argument is null | undefined;
-/** Not null and not undefined */
+/**
+ * Checks if the provided argument is neither null nor undefined.
+ * @template T
+ * @param {T | undefined | null} argument - The argument to check.
+ * @returns {boolean} True if the argument is neither null nor undefined, false otherwise.
+ */
 export declare const nonNullish: <T>(argument: T | undefined | null) => argument is NonNullable<T>;
+/**
+ * Represents an error thrown when a value is null or undefined.
+ * @class
+ * @extends {Error}
+ */
 export declare class NullishError extends Error {
 }
+/**
+ * Asserts that a value is neither null nor undefined.
+ * @template T
+ * @param {T} value - The value to check.
+ * @param {string} [message] - The optional error message to use if the assertion fails.
+ * @throws {NullishError} If the value is null or undefined.
+ * @returns {asserts value is NonNullable<T>} Asserts that the value is neither null nor undefined.
+ */
 export declare const assertNonNullish: <T>(value: T, message?: string) => asserts value is NonNullable<T>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@junobuild/utils",
-  "version": "0.0.21",
+  "version": "0.0.22",
   "description": "A collection of utilities and constants for Juno JS libs.",
   "author": "David Dal Busco (https://daviddalbusco.com)",
   "license": "MIT",