@augment-vir/common 16.4.1 → 17.0.0

package/dist/cjs/augments/string/search-params.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchParamStringToObject = exports.objectToSearchParamsString = void 0;
+const boolean_1 = require("../boolean");
+const matches_object_shape_1 = require("../object/matches-object-shape");
+const runtime_type_of_1 = require("../runtime-type-of");
+function objectToSearchParamsString(inputObject) {
+    const valueStrings = Object.entries(inputObject)
+        .map(([key, value,]) => {
+        if (value == undefined) {
+            return undefined;
+        }
+        return `${key}=${String(value)}`;
+    })
+        .filter(boolean_1.isTruthy);
+    if (valueStrings.length) {
+        return `?${valueStrings.join('&')}`;
+    }
+    else {
+        return '';
+    }
+}
+exports.objectToSearchParamsString = objectToSearchParamsString;
+function searchParamStringToObject(inputUrl, verifyShape) {
+    const urlForSearchParams = (0, runtime_type_of_1.isRuntimeTypeOf)(inputUrl, 'string') ? new URL(inputUrl) : inputUrl;
+    const searchEntries = Array.from(urlForSearchParams.searchParams.entries());
+    const paramsObject = Object.fromEntries(searchEntries);
+    if (verifyShape) {
+        (0, matches_object_shape_1.assertMatchesObjectShape)(paramsObject, verifyShape);
+    }
+    return paramsObject;
+}
+exports.searchParamStringToObject = searchParamStringToObject;

package/dist/cjs/index.js

@@ -41,6 +41,7 @@ __exportStar(require("./augments/object/typed-has-property"), exports);
 __exportStar(require("./augments/promise"), exports);
 __exportStar(require("./augments/regexp"), exports);
 __exportStar(require("./augments/runtime-type-of"), exports);
+__exportStar(require("./augments/string/search-params"), exports);
 __exportStar(require("./augments/string/suffixes"), exports);
 __exportStar(require("./augments/string/url"), exports);
 __exportStar(require("./augments/string/uuid"), exports);

package/dist/esm/augments/string/search-params.js

@@ -0,0 +1,28 @@
+import { isTruthy } from '../boolean';
+import { assertMatchesObjectShape } from '../object/matches-object-shape';
+import { isRuntimeTypeOf } from '../runtime-type-of';
+export function objectToSearchParamsString(inputObject) {
+    const valueStrings = Object.entries(inputObject)
+        .map(([key, value,]) => {
+        if (value == undefined) {
+            return undefined;
+        }
+        return `${key}=${String(value)}`;
+    })
+        .filter(isTruthy);
+    if (valueStrings.length) {
+        return `?${valueStrings.join('&')}`;
+    }
+    else {
+        return '';
+    }
+}
+export function searchParamStringToObject(inputUrl, verifyShape) {
+    const urlForSearchParams = isRuntimeTypeOf(inputUrl, 'string') ? new URL(inputUrl) : inputUrl;
+    const searchEntries = Array.from(urlForSearchParams.searchParams.entries());
+    const paramsObject = Object.fromEntries(searchEntries);
+    if (verifyShape) {
+        assertMatchesObjectShape(paramsObject, verifyShape);
+    }
+    return paramsObject;
+}

package/dist/esm/index.js

@@ -25,6 +25,7 @@ export * from './augments/object/typed-has-property';
 export * from './augments/promise';
 export * from './augments/regexp';
 export * from './augments/runtime-type-of';
+export * from './augments/string/search-params';
 export * from './augments/string/suffixes';
 export * from './augments/string/url';
 export * from './augments/string/uuid';

package/dist/types/augments/string/search-params.d.ts

@@ -0,0 +1,5 @@
+import { Primitive } from 'type-fest';
+export type SearchParamObjectBase = Record<string, Exclude<Primitive, symbol>>;
+export declare function objectToSearchParamsString(inputObject: SearchParamObjectBase): string;
+export declare function searchParamStringToObject<VerifyShapeGeneric extends SearchParamObjectBase>(inputUrl: string | Pick<URL, 'searchParams'>, verifyShape: VerifyShapeGeneric): VerifyShapeGeneric;
+export declare function searchParamStringToObject<VerifyShapeGeneric extends SearchParamObjectBase>(inputUrl: string | Pick<URL, 'searchParams'>, verifyShape?: VerifyShapeGeneric | undefined): Record<string, string>;

package/dist/types/index.d.ts

@@ -25,6 +25,7 @@ export * from './augments/object/typed-has-property';
 export * from './augments/promise';
 export * from './augments/regexp';
 export * from './augments/runtime-type-of';
+export * from './augments/string/search-params';
 export * from './augments/string/suffixes';
 export * from './augments/string/url';
 export * from './augments/string/uuid';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/common",
-    "version": "16.4.1",
+    "version": "17.0.0",
     "homepage": "https://github.com/electrovir/augment-vir/tree/main/packages/common",
     "bugs": {
         "url": "https://github.com/electrovir/augment-vir/issues"