@koine/utils 2.0.0-beta.187 → 2.0.0-beta.189

package/createConsole.cjs.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let createConsole=e=>{let o=(o,r,...t)=>{"development"===process.env.NODE_ENV&&console[o]("\x1b[90m%s\x1b[0m"+r,e?"["+e+"] ":"",...t);},r=e=>{let r=(r,...t)=>o(e,r,...t);if("development"===process.env.NODE_ENV){let t=new Set,n="";r.once=(r,...n)=>{t.has(r)||(t.add(r),o(e,r,...n));},r.first=(r,...t)=>{r!==n&&(n=r,o(e,r,...t));};}else r.once=(...e)=>void 0,r.first=(...e)=>void 0;return r},t={};return ["log","info","warn","error","debug"].forEach(e=>{t[e]=r(e);}),t};
+let createConsole=e=>{let r=(r,o,...t)=>{console[r]("\x1b[90m%s\x1b[0m"+o,e?"["+e+"] ":"",...t);},o=e=>{let o=(o,...t)=>r(e,o,...t),t=new Set,n="";return o.once=(o,...n)=>{t.has(o)||(t.add(o),r(e,o,...n));},o.first=(o,...t)=>{o!==n&&(n=o,r(e,o,...t));},o},t={};return ["log","info","warn","error","debug"].forEach(e=>{t[e]=o(e);}),t};
 
 exports.createConsole = createConsole;
 exports.default = createConsole;

package/createConsole.d.ts

@@ -1,5 +1,5 @@
 /**
- * A basic native `console` enhancement enabled only when `process.env["NODE_ENV"] === "development"`:
+ * A basic native `console` enhancement:
  * - optional _prefix_ to all messages
  * - `first` logging method which prints only the first message among equals (a kind of more basic throttling)
  * - `once` logging method which prints only once a message among equals

package/createConsole.esm.js

@@ -1,3 +1,3 @@
-let createConsole=e=>{let o=(o,r,...t)=>{"development"===process.env.NODE_ENV&&console[o]("\x1b[90m%s\x1b[0m"+r,e?"["+e+"] ":"",...t);},r=e=>{let r=(r,...t)=>o(e,r,...t);if("development"===process.env.NODE_ENV){let t=new Set,n="";r.once=(r,...n)=>{t.has(r)||(t.add(r),o(e,r,...n));},r.first=(r,...t)=>{r!==n&&(n=r,o(e,r,...t));};}else r.once=(...e)=>void 0,r.first=(...e)=>void 0;return r},t={};return ["log","info","warn","error","debug"].forEach(e=>{t[e]=r(e);}),t};
+let createConsole=e=>{let r=(r,o,...t)=>{console[r]("\x1b[90m%s\x1b[0m"+o,e?"["+e+"] ":"",...t);},o=e=>{let o=(o,...t)=>r(e,o,...t),t=new Set,n="";return o.once=(o,...n)=>{t.has(o)||(t.add(o),r(e,o,...n));},o.first=(o,...t)=>{o!==n&&(n=o,r(e,o,...t));},o},t={};return ["log","info","warn","error","debug"].forEach(e=>{t[e]=o(e);}),t};
 
 export { createConsole, createConsole as default };

package/index.cjs.js

@@ -153,6 +153,7 @@ var uid = require('./uid.cjs.js');
 var updateLinkParams = require('./updateLinkParams.cjs.js');
 var updateUrlQueryParams = require('./updateUrlQueryParams.cjs.js');
 var uppercase = require('./uppercase.cjs.js');
+var urlSearchParamsSerializer = require('./urlSearchParamsSerializer.cjs.js');
 var uuid = require('./uuid.cjs.js');
 var uuidNumeric = require('./uuidNumeric.cjs.js');
 var wait = require('./wait.cjs.js');
@@ -312,6 +313,7 @@ exports.uid = uid.uid;
 exports.updateLinkParams = updateLinkParams.updateLinkParams;
 exports.updateUrlQueryParams = updateUrlQueryParams.updateUrlQueryParams;
 exports.uppercase = uppercase.uppercase;
+exports.urlSearchParamsSerializer = urlSearchParamsSerializer.urlSearchParamsSerializer;
 exports.uuid = uuid.uuid;
 exports.uuidNumeric = uuidNumeric.uuidNumeric;
 exports.wait = wait.wait;

package/index.d.ts

@@ -153,10 +153,11 @@ export { uid } from "./uid";
 export { updateLinkParams } from "./updateLinkParams";
 export { updateUrlQueryParams } from "./updateUrlQueryParams";
 export { uppercase } from "./uppercase";
+export { urlSearchParamsSerializer, type UrlSearchParamSerializer } from "./urlSearchParamsSerializer";
 export { uuid } from "./uuid";
 export { uuidNumeric } from "./uuidNumeric";
 export { wait } from "./wait";
-export type { AnythingFalsy, FlatObjectFirstLevel, KeysStartsWith, KeysTailsStartsWith, NonNullableObjectDeep, NullableObjectDeep, OmitNever, PickStartsWith, PickStartsWithTails, RequiredNonNullableObjectDeep, RequiredObjectDeep, Reverse, TestType, } from "./types";
+export type { AnythingFalsy, FlatObjectFirstLevel, KeysStartsWith, KeysTailsStartsWith, KeysOfValue, NonNullableObjectDeep, NullableObjectDeep, OmitNever, PickStartsWith, PickStartsWithTails, RequiredNonNullableObjectDeep, RequiredObjectDeep, Reverse, TestType, OverloadsToTuple } from "./types";
 /**
  * These types should not be documented by using [`excludeExternals` TypeDoc flag](https://typedoc.org/options/input/#excludeexternals)
  */

package/index.esm.js

@@ -151,6 +151,7 @@ export { uid } from './uid.esm.js';
 export { updateLinkParams } from './updateLinkParams.esm.js';
 export { updateUrlQueryParams } from './updateUrlQueryParams.esm.js';
 export { uppercase } from './uppercase.esm.js';
+export { urlSearchParamsSerializer } from './urlSearchParamsSerializer.esm.js';
 export { uuid } from './uuid.esm.js';
 export { uuidNumeric } from './uuidNumeric.esm.js';
 export { wait } from './wait.esm.js';

package/package.json

@@ -984,6 +984,12 @@
       "import": "./uppercase.cjs.mjs",
       "default": "./uppercase.cjs.js"
     },
+    "./urlSearchParamsSerializer": {
+      "module": "./urlSearchParamsSerializer.esm.js",
+      "types": "./urlSearchParamsSerializer.esm.d.ts",
+      "import": "./urlSearchParamsSerializer.cjs.mjs",
+      "default": "./urlSearchParamsSerializer.cjs.js"
+    },
     "./uuid": {
       "module": "./uuid.esm.js",
       "types": "./uuid.esm.d.ts",
@@ -1015,5 +1021,5 @@
   "module": "./index.esm.js",
   "main": "./index.cjs.js",
   "types": "./index.esm.d.ts",
-  "version": "2.0.0-beta.187"
+  "version": "2.0.0-beta.189"
 }

package/types.d.ts

@@ -64,6 +64,13 @@ export type PickStartsWithTails<T extends object, S extends string> = {
  * @category type
  */
 export type KeysTailsStartsWith<T extends object, S extends string> = keyof PickStartsWithTails<T, S>;
+/**
+ * @borrows [Matt Pocock's _Get Keys of an Object Where Values Are of a Given Type_](https://www.totaltypescript.com/get-keys-of-an-object-where-values-are-of-a-given-type)
+ * @category type
+ */
+export type KeysOfValue<T, TCondition> = {
+    [K in keyof T]: T[K] extends TCondition ? K : never;
+}[keyof T];
 /**
  * @borrows [SO's answer by 钵钵鸡实力代购](https://stackoverflow.com/a/64994122/1938970)
  */
@@ -118,3 +125,30 @@ type B = OmitNever<{ a: never; b: 1 }> // B = { b: 1; }
 export type OmitNever<T> = {
     [K in keyof T as T[K] extends never ? never : K]: T[K];
 };
+export type OverloadsToTuple<T> = OverloadsToTuple5<T>;
+type OverloadsToTuple5<T> = T extends {
+    (...args: infer P1): infer R1;
+    (...args: infer P2): infer R2;
+    (...args: infer P3): infer R3;
+    (...args: infer P4): infer R4;
+    (...args: infer P5): infer R5;
+} ? [(...args: P1) => R1, (...args: P2) => R2, (...args: P3) => R3, (...args: P4) => R4, (...args: P5) => R5] : OverloadsToTuple4<T>;
+type OverloadsToTuple4<T> = T extends {
+    (...args: infer P1): infer R1;
+    (...args: infer P2): infer R2;
+    (...args: infer P3): infer R3;
+    (...args: infer P4): infer R4;
+} ? [(...args: P1) => R1, (...args: P2) => R2, (...args: P3) => R3, (...args: P4) => R4] : OverloadsToTuple3<T>;
+type OverloadsToTuple3<T> = T extends {
+    (...args: infer P1): infer R1;
+    (...args: infer P2): infer R2;
+    (...args: infer P3): infer R3;
+} ? [(...args: P1) => R1, (...args: P2) => R2, (...args: P3) => R3] : OverloadsToTuple2<T>;
+type OverloadsToTuple2<T> = T extends {
+    (...args: infer P1): infer R1;
+    (...args: infer P2): infer R2;
+} ? [(...args: P1) => R1, (...args: P2) => R2] : OverloadsToTuple1<T>;
+type OverloadsToTuple1<T> = T extends {
+    (...args: infer P1): infer R1;
+} ? [(...args: P1) => R1] : never;
+export {};

package/urlSearchParamsSerializer.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./urlSearchParamsSerializer";
+export { default } from "./urlSearchParamsSerializer";

package/urlSearchParamsSerializer.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./urlSearchParamsSerializer.cjs.js').default;

package/urlSearchParamsSerializer.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const urlSearchParamsSerializer=(e,r)=>{let t=Object.keys(e).reduce((r,t)=>(r[t]=e[t][1],r),{}),l=e=>r?`${r}_${e}`:e,a=Object.keys(e).reduce((r,t)=>(r[t]=l(e[t][0]),r),{});return {names:Object.values(a),toNames:a,defaults:t,fromUrl:r=>{let t={};for(let a in e){let[u,c,o]=e[a],s=r.get(l(u));t[a]=s?o(s):c;}return t},toUrl:r=>{let a={};for(let u in t){let[t,c,,o]=e[u],s=o(r[u]??c);s&&(a[l(t)]=s);}return a}}};
+
+exports.default = urlSearchParamsSerializer;
+exports.urlSearchParamsSerializer = urlSearchParamsSerializer;

package/urlSearchParamsSerializer.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './urlSearchParamsSerializer.cjs.js';
+export { _default as default } from './urlSearchParamsSerializer.cjs.default.js';

package/urlSearchParamsSerializer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @param {string} searchParamName
+ * @param {any} defaultValue
+ * @param {(valueFromUrl: string) => DefaultValue} serializeFromUrlSearchParamValue
+ * @param {(valueToUrl: DefaultValue) => string}  serializeToUrlSearchParamValue
+ */
+export type UrlSearchParamSerializer<NameInUrl extends string, DefaultValue> = [
+    NameInUrl,
+    DefaultValue,
+    (valueFromUrl: string) => DefaultValue,
+    (valueToUrl: DefaultValue) => string
+];
+export declare const urlSearchParamsSerializer: <Serializers extends Record<string, UrlSearchParamSerializer<any, any>>, Prefix extends string | undefined>(serializers: Serializers, prefix?: Prefix) => {
+    /**
+     * Array of the search params `names` as they appear in the URL
+     */
+    names: { [Key in keyof Serializers]: Prefix extends undefined ? Serializers[Key][0] : `${Prefix}_${Serializers[Key][0]}`; }[keyof Serializers][];
+    /**
+     * Map of the search params `state` name to the `name` as it appears in the URL
+     */
+    toNames: { [Key in keyof Serializers]: Prefix extends undefined ? Serializers[Key][0] : `${Prefix}_${Serializers[Key][0]}`; };
+    /**
+     * Default state of the search params value
+     */
+    defaults: { [Key_1 in keyof Serializers]: Serializers[Key_1][1]; };
+    /**
+     * Deserialize search params state from the URL ones
+     */
+    fromUrl: (searchParams: URLSearchParams) => { [Key_2 in keyof Serializers]: Serializers[Key_2][1]; };
+    /**
+     * Serialize state to URL search params
+     */
+    toUrl: (data: { [Key_2 in keyof Serializers]?: Serializers[Key_2][1]; }) => Record<string, string>;
+};
+export default urlSearchParamsSerializer;

package/urlSearchParamsSerializer.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./urlSearchParamsSerializer";
+export { default } from "./urlSearchParamsSerializer";

package/urlSearchParamsSerializer.esm.js

@@ -0,0 +1,3 @@
+const urlSearchParamsSerializer=(e,r)=>{let t=Object.keys(e).reduce((r,t)=>(r[t]=e[t][1],r),{}),l=e=>r?`${r}_${e}`:e,a=Object.keys(e).reduce((r,t)=>(r[t]=l(e[t][0]),r),{});return {names:Object.values(a),toNames:a,defaults:t,fromUrl:r=>{let t={};for(let a in e){let[u,c,o]=e[a],s=r.get(l(u));t[a]=s?o(s):c;}return t},toUrl:r=>{let a={};for(let u in t){let[t,c,,o]=e[u],s=o(r[u]??c);s&&(a[l(t)]=s);}return a}}};
+
+export { urlSearchParamsSerializer as default, urlSearchParamsSerializer };