@klerick/json-api-nestjs-sdk 10.0.0-beta.2

package/mjs/src/lib/utils/adapter-for-axios.js

@@ -0,0 +1,54 @@
+import { Observable } from 'rxjs';
+import { map } from 'rxjs/operators';
+class AxiosHttpClient {
+    axios;
+    constructor(axios) {
+        this.axios = axios;
+    }
+    observify(makeRequest, controller) {
+        return new Observable((subscriber) => {
+            makeRequest()
+                .then((response) => subscriber.next(response))
+                .catch((error) => subscriber.error(error))
+                .finally(() => subscriber.complete());
+            return { unsubscribe: () => controller.abort() };
+        });
+    }
+    makeCancellable() {
+        const controller = new AbortController();
+        const signal = controller.signal;
+        return {
+            controller,
+            signal,
+        };
+    }
+    delete(url, body) {
+        if (body) {
+            return this.request(url, 'DELETE', body);
+        }
+        return this.request(url, 'DELETE');
+    }
+    get(url, params) {
+        return this.request(url, 'GET', undefined, params ? params.params : undefined);
+    }
+    patch(url, body) {
+        return this.request(url, 'PATCH', body);
+    }
+    post(url, body) {
+        return this.request(url, 'POST', body);
+    }
+    request(url, method, data, params) {
+        const { controller, signal } = this.makeCancellable();
+        return this.observify(() => this.axios.request({
+            url,
+            method,
+            data,
+            signal,
+            params,
+        }), controller).pipe(map((r) => r.data));
+    }
+}
+export function adapterForAxios(axios) {
+    return new AxiosHttpClient(axios);
+}
+//# sourceMappingURL=adapter-for-axios.js.map

package/mjs/src/lib/utils/adapter-for-axios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-for-axios.js","sourceRoot":"","sources":["../../../../../../../../libs/json-api/json-api-nestjs-sdk/src/lib/utils/adapter-for-axios.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAYrC,MAAM,eAAe;IACC;IAApB,YAAoB,KAAY;QAAZ,UAAK,GAAL,KAAK,CAAO;IAAG,CAAC;IAE5B,SAAS,CACf,WAA6B,EAC7B,UAA2B;QAE3B,OAAO,IAAI,UAAU,CAAC,CAAC,UAAU,EAAE,EAAE;YACnC,WAAW,EAAE;iBACV,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;iBAC7C,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;iBAClD,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YAExC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,eAAe;QAIrB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAEjC,OAAO;YACL,UAAU;YACV,MAAM;SACP,CAAC;IACJ,CAAC;IAED,MAAM,CACJ,GAAW,EACX,IAA4C;QAE5C,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAcD,GAAG,CAQD,GAAW,EAAE,MAAgC;QAC7C,OAAO,IAAI,CAAC,OAAO,CACjB,GAAG,EACH,KAAK,EACL,SAAS,EACT,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CACnC,CAAC;IACJ,CAAC;IAcD,KAAK,CAKH,GAAW,EACX,IAA0D;QAI1D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAkBD,IAAI,CACF,GAAW,EACX,IAAsE;QAMtE,OAAO,IAAI,CAAC,OAAO,CAKjB,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACvB,CAAC;IAEO,OAAO,CACb,GAAW,EACX,MAAc,EACd,IAAQ,EACR,MAAoB;QAEpB,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC,SAAS,CACnB,GAAG,EAAE,CACH,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B;YAC5C,GAAG;YACH,MAAM;YACN,IAAI;YACJ,MAAM;YACN,MAAM;SACP,CAAC,EACJ,UAAU,CACX,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAY;IAC1C,OAAO,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/mjs/src/lib/utils/entity-array.d.ts

@@ -0,0 +1,9 @@
+import { PageProps } from '@klerick/json-api-nestjs-shared';
+export declare class EntityArray<T> extends Array<T> {
+    private pageProps;
+    constructor(items: T[], pageProps: PageProps);
+    static get [Symbol.species](): ArrayConstructor;
+    get totalItems(): number;
+    get pageSize(): number;
+    get pageNumber(): number;
+}

package/mjs/src/lib/utils/entity-array.js

@@ -0,0 +1,25 @@
+export class EntityArray extends Array {
+    pageProps;
+    constructor(items, pageProps) {
+        super(...items);
+        this.pageProps = pageProps;
+        Object.defineProperty(this, 'pageProps', {
+            writable: false,
+            enumerable: false,
+            value: pageProps,
+        });
+    }
+    static get [Symbol.species]() {
+        return Array;
+    }
+    get totalItems() {
+        return this.pageProps.totalItems;
+    }
+    get pageSize() {
+        return this.pageProps.pageSize;
+    }
+    get pageNumber() {
+        return this.pageProps.pageNumber;
+    }
+}
+//# sourceMappingURL=entity-array.js.map

package/mjs/src/lib/utils/entity-array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-array.js","sourceRoot":"","sources":["../../../../../../../../libs/json-api/json-api-nestjs-sdk/src/lib/utils/entity-array.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAe,SAAQ,KAAQ;IACV;IAAhC,YAAY,KAAU,EAAU,SAAoB;QAClD,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC;QADc,cAAS,GAAT,SAAS,CAAW;QAElD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE;YACvC,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAc,CAAC,MAAM,CAAC,OAAO,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;IACnC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;IACnC,CAAC;CACF"}

package/mjs/src/lib/utils/generate-atomic-body.d.ts

@@ -0,0 +1,22 @@
+import { RelationKeys } from '@klerick/json-api-nestjs-shared';
+import { AtomicMainOperations, JsonApiSdkConfig, BodyType } from '../types';
+import { JsonApiUtilsService } from '../service';
+export type AtomicVoidOperation = {
+    [K in keyof AtomicMainOperations<[]>]: (...arg: any) => void;
+};
+export declare class GenerateAtomicBody<Entity extends object = any, Rel extends RelationKeys<Entity> = any> implements AtomicVoidOperation {
+    private jsonApiUtilsService;
+    private jsonApiSdkConfig;
+    constructor(jsonApiUtilsService: JsonApiUtilsService, jsonApiSdkConfig: JsonApiSdkConfig);
+    private bodyData;
+    private skipEmpty;
+    get isSkipEmpty(): boolean;
+    private setToBody;
+    getBody(): BodyType;
+    postOne(entity: Entity): void;
+    patchOne(entity: Entity): void;
+    deleteOne(entity: Entity, skipEmpty: boolean): void;
+    patchRelationships(entity: Entity, relationType: Rel): void;
+    postRelationships(entity: Entity, relationType: Rel): void;
+    deleteRelationships(entity: Entity, relationType: Rel): void;
+}

package/mjs/src/lib/utils/generate-atomic-body.js

@@ -0,0 +1,83 @@
+import { Operation } from '@klerick/json-api-nestjs-shared';
+import { getTypeForReq } from './utils';
+export class GenerateAtomicBody {
+    jsonApiUtilsService;
+    jsonApiSdkConfig;
+    constructor(jsonApiUtilsService, jsonApiSdkConfig) {
+        this.jsonApiUtilsService = jsonApiUtilsService;
+        this.jsonApiSdkConfig = jsonApiSdkConfig;
+    }
+    bodyData;
+    skipEmpty = true;
+    get isSkipEmpty() {
+        return this.skipEmpty;
+    }
+    setToBody(op, entity, relationType) {
+        const type = getTypeForReq(entity.constructor.name);
+        const { relationships, attributes } = this.jsonApiUtilsService.generateBody(entity);
+        const id = Reflect.get(entity, this.jsonApiSdkConfig.idKey);
+        const idObj = op === 'add' && !relationType ? {} : { id: String(id) };
+        const data = relationType
+            ? this.jsonApiUtilsService.generateRelationshipsBody(entity[relationType])
+            : {
+                type: getTypeForReq(entity.constructor.name),
+                attributes,
+                ...(Object.keys(relationships).length > 0 ? { relationships } : {}),
+                ...idObj,
+            };
+        const rel = relationType ? { relationship: String(relationType) } : {};
+        const tmpId = op === 'add' && id && !relationType ? { tmpId: String(id) } : {};
+        this.bodyData = {
+            op,
+            ref: { type, ...idObj, ...rel, ...tmpId },
+            ...(op === 'remove' && !relationType ? {} : { data }),
+        };
+    }
+    getBody() {
+        return this.bodyData;
+    }
+    postOne(entity) {
+        this.setToBody(Operation.add, entity);
+    }
+    patchOne(entity) {
+        if (Reflect.get(entity, this.jsonApiSdkConfig.idKey) === undefined) {
+            throw new Error('Resource params should be instance of resource with id params');
+        }
+        this.setToBody(Operation.update, entity);
+    }
+    deleteOne(entity, skipEmpty) {
+        if (!Reflect.get(entity, this.jsonApiSdkConfig.idKey)) {
+            throw new Error('Resource params should be instance of resource with id params');
+        }
+        this.skipEmpty = skipEmpty;
+        this.setToBody(Operation.remove, entity);
+    }
+    patchRelationships(entity, relationType) {
+        if (!Reflect.get(entity, this.jsonApiSdkConfig.idKey)) {
+            throw new Error('Resource params should be instance of resource with id params');
+        }
+        if (entity[relationType] === undefined) {
+            new Error(`${relationType.toString()} should not be undefined in entity`);
+        }
+        this.setToBody(Operation.update, entity, relationType);
+    }
+    postRelationships(entity, relationType) {
+        if (!Reflect.get(entity, this.jsonApiSdkConfig.idKey)) {
+            throw new Error('Resource params should be instance of resource with id params');
+        }
+        if (entity[relationType] === undefined) {
+            throw new Error(`${relationType.toString()} should not be undefined in entity`);
+        }
+        this.setToBody(Operation.add, entity, relationType);
+    }
+    deleteRelationships(entity, relationType) {
+        if (!Reflect.get(entity, this.jsonApiSdkConfig.idKey)) {
+            throw new Error('Resource params should be instance of resource with id params');
+        }
+        if (entity[relationType] === undefined) {
+            throw new Error(`${relationType.toString()} should not be undefined in entity`);
+        }
+        this.setToBody(Operation.remove, entity, relationType);
+    }
+}
+//# sourceMappingURL=generate-atomic-body.js.map

package/mjs/src/lib/utils/generate-atomic-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-atomic-body.js","sourceRoot":"","sources":["../../../../../../../../libs/json-api/json-api-nestjs-sdk/src/lib/utils/generate-atomic-body.ts"],"names":[],"mappings":"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"}

package/mjs/src/lib/utils/http-params.d.ts

@@ -0,0 +1,154 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+/**
+ * A codec for encoding and decoding parameters in URLs.
+ *
+ * Used by `HttpParams`.
+ *
+ * @publicApi
+ **/
+export interface HttpParameterCodec {
+    encodeKey(key: string): string;
+    encodeValue(value: string): string;
+    decodeKey(key: string): string;
+    decodeValue(value: string): string;
+}
+/**
+ * Provides encoding and decoding of URL parameter and query-string values.
+ *
+ * Serializes and parses URL parameter keys and values to encode and decode them.
+ * If you pass URL query parameters without encoding,
+ * the query parameters can be misinterpreted at the receiving end.
+ *
+ *
+ * @publicApi
+ */
+export declare class HttpUrlEncodingCodec implements HttpParameterCodec {
+    /**
+     * Encodes a key name for a URL parameter or query-string.
+     * @param key The key name.
+     * @returns The encoded key name.
+     */
+    encodeKey(key: string): string;
+    /**
+     * Encodes the value of a URL parameter or query-string.
+     * @param value The value.
+     * @returns The encoded value.
+     */
+    encodeValue(value: string): string;
+    /**
+     * Decodes an encoded URL parameter or query-string key.
+     * @param key The encoded key name.
+     * @returns The decoded key name.
+     */
+    decodeKey(key: string): string;
+    /**
+     * Decodes an encoded URL parameter or query-string value.
+     * @param value The encoded value.
+     * @returns The decoded value.
+     */
+    decodeValue(value: string): string;
+}
+/**
+ * Options used to construct an `HttpParams` instance.
+ *
+ * @publicApi
+ */
+export interface HttpParamsOptions {
+    /**
+     * String representation of the HTTP parameters in URL-query-string format.
+     * Mutually exclusive with `fromObject`.
+     */
+    fromString?: string;
+    /** Object map of the HTTP parameters. Mutually exclusive with `fromString`. */
+    fromObject?: ParamObject;
+    /** Encoding codec used to parse and serialize the parameters. */
+    encoder?: HttpParameterCodec;
+}
+export type ParamObject = {
+    [param: string]: string | number | boolean | ReadonlyArray<string | number | boolean>;
+};
+/**
+ * An HTTP request/response body that represents serialized parameters,
+ * per the MIME type `application/x-www-form-urlencoded`.
+ *
+ * This class is immutable; all mutation operations return a new instance.
+ *
+ * @publicApi
+ */
+export declare class HttpParams {
+    private map;
+    private encoder;
+    private updates;
+    private cloneFrom;
+    constructor(options?: HttpParamsOptions);
+    /**
+     * Reports whether the body includes one or more values for a given parameter.
+     * @param param The parameter name.
+     * @returns True if the parameter has one or more values,
+     * false if it has no value or is not present.
+     */
+    has(param: string): boolean;
+    /**
+     * Retrieves the first value for a parameter.
+     * @param param The parameter name.
+     * @returns The first value of the given parameter,
+     * or `null` if the parameter is not present.
+     */
+    get(param: string): string | null;
+    /**
+     * Retrieves all values for a  parameter.
+     * @param param The parameter name.
+     * @returns All values in a string array,
+     * or `null` if the parameter not present.
+     */
+    getAll(param: string): string[] | null;
+    /**
+     * Retrieves all the parameters for this body.
+     * @returns The parameter names in a string array.
+     */
+    keys(): string[];
+    /**
+     * Appends a new value to existing values for a parameter.
+     * @param param The parameter name.
+     * @param value The new value to add.
+     * @return A new body with the appended value.
+     */
+    append(param: string, value: string | number | boolean): HttpParams;
+    /**
+     * Constructs a new body with appended values for the given parameter name.
+     * @param params parameters and values
+     * @return A new body with the new value.
+     */
+    appendAll(params: {
+        [param: string]: string | number | boolean | ReadonlyArray<string | number | boolean>;
+    }): HttpParams;
+    /**
+     * Replaces the value for a parameter.
+     * @param param The parameter name.
+     * @param value The new value.
+     * @return A new body with the new value.
+     */
+    set(param: string, value: string | number | boolean): HttpParams;
+    /**
+     * Removes a given value or all values from a parameter.
+     * @param param The parameter name.
+     * @param value The value to remove, if provided.
+     * @return A new body with the given value removed, or with all values
+     * removed if no value is specified.
+     */
+    delete(param: string, value?: string | number | boolean): HttpParams;
+    /**
+     * Serializes the body to an encoded string, where key-value pairs (separated by `=`) are
+     * separated by `&`s.
+     */
+    toString(): string;
+    toObject(): ParamObject;
+    private clone;
+    private init;
+}

package/mjs/src/lib/utils/http-params.js

@@ -0,0 +1,300 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+/**
+ * Provides encoding and decoding of URL parameter and query-string values.
+ *
+ * Serializes and parses URL parameter keys and values to encode and decode them.
+ * If you pass URL query parameters without encoding,
+ * the query parameters can be misinterpreted at the receiving end.
+ *
+ *
+ * @publicApi
+ */
+export class HttpUrlEncodingCodec {
+    /**
+     * Encodes a key name for a URL parameter or query-string.
+     * @param key The key name.
+     * @returns The encoded key name.
+     */
+    encodeKey(key) {
+        return standardEncoding(key);
+    }
+    /**
+     * Encodes the value of a URL parameter or query-string.
+     * @param value The value.
+     * @returns The encoded value.
+     */
+    encodeValue(value) {
+        return standardEncoding(value);
+    }
+    /**
+     * Decodes an encoded URL parameter or query-string key.
+     * @param key The encoded key name.
+     * @returns The decoded key name.
+     */
+    decodeKey(key) {
+        return decodeURIComponent(key);
+    }
+    /**
+     * Decodes an encoded URL parameter or query-string value.
+     * @param value The encoded value.
+     * @returns The decoded value.
+     */
+    decodeValue(value) {
+        return decodeURIComponent(value);
+    }
+}
+function paramParser(rawParams, codec) {
+    const map = new Map();
+    if (rawParams.length > 0) {
+        // The `window.location.search` can be used while creating an instance of the `HttpParams` class
+        // (e.g. `new HttpParams({ fromString: window.location.search })`). The `window.location.search`
+        // may start with the `?` char, so we strip it if it's present.
+        const params = rawParams.replace(/^\?/, '').split('&');
+        params.forEach((param) => {
+            const eqIdx = param.indexOf('=');
+            const [key, val] = eqIdx == -1
+                ? [codec.decodeKey(param), '']
+                : [
+                    codec.decodeKey(param.slice(0, eqIdx)),
+                    codec.decodeValue(param.slice(eqIdx + 1)),
+                ];
+            const list = map.get(key) || [];
+            list.push(val);
+            map.set(key, list);
+        });
+    }
+    return map;
+}
+/**
+ * Encode input string with standard encodeURIComponent and then un-encode specific characters.
+ */
+const STANDARD_ENCODING_REGEX = /%(\d[a-f0-9])/gi;
+const STANDARD_ENCODING_REPLACEMENTS = {
+    '40': '@',
+    '3A': ':',
+    '24': '$',
+    '2C': ',',
+    '3B': ';',
+    '3D': '=',
+    '3F': '?',
+    '2F': '/',
+};
+function standardEncoding(v) {
+    return encodeURIComponent(v).replace(STANDARD_ENCODING_REGEX, (s, t) => STANDARD_ENCODING_REPLACEMENTS[t] ?? s);
+}
+function valueToString(value) {
+    return `${value}`;
+}
+/**
+ * An HTTP request/response body that represents serialized parameters,
+ * per the MIME type `application/x-www-form-urlencoded`.
+ *
+ * This class is immutable; all mutation operations return a new instance.
+ *
+ * @publicApi
+ */
+export class HttpParams {
+    map;
+    encoder;
+    updates = null;
+    cloneFrom = null;
+    constructor(options = {}) {
+        this.encoder = options.encoder || new HttpUrlEncodingCodec();
+        if (!!options.fromString) {
+            if (!!options.fromObject) {
+                throw new Error(`Cannot specify both fromString and fromObject.`);
+            }
+            this.map = paramParser(options.fromString, this.encoder);
+        }
+        else if (!!options.fromObject) {
+            this.map = new Map();
+            Object.keys(options.fromObject).forEach((key) => {
+                const value = options.fromObject[key];
+                // convert the values to strings
+                const values = Array.isArray(value)
+                    ? value.map(valueToString)
+                    : [valueToString(value)];
+                this.map.set(key, values);
+            });
+        }
+        else {
+            this.map = null;
+        }
+    }
+    /**
+     * Reports whether the body includes one or more values for a given parameter.
+     * @param param The parameter name.
+     * @returns True if the parameter has one or more values,
+     * false if it has no value or is not present.
+     */
+    has(param) {
+        this.init();
+        return this.map.has(param);
+    }
+    /**
+     * Retrieves the first value for a parameter.
+     * @param param The parameter name.
+     * @returns The first value of the given parameter,
+     * or `null` if the parameter is not present.
+     */
+    get(param) {
+        this.init();
+        const res = this.map.get(param);
+        return !!res ? res[0] : null;
+    }
+    /**
+     * Retrieves all values for a  parameter.
+     * @param param The parameter name.
+     * @returns All values in a string array,
+     * or `null` if the parameter not present.
+     */
+    getAll(param) {
+        this.init();
+        return this.map.get(param) || null;
+    }
+    /**
+     * Retrieves all the parameters for this body.
+     * @returns The parameter names in a string array.
+     */
+    keys() {
+        this.init();
+        return Array.from(this.map.keys());
+    }
+    /**
+     * Appends a new value to existing values for a parameter.
+     * @param param The parameter name.
+     * @param value The new value to add.
+     * @return A new body with the appended value.
+     */
+    append(param, value) {
+        return this.clone({ param, value, op: 'a' });
+    }
+    /**
+     * Constructs a new body with appended values for the given parameter name.
+     * @param params parameters and values
+     * @return A new body with the new value.
+     */
+    appendAll(params) {
+        const updates = [];
+        Object.keys(params).forEach((param) => {
+            const value = params[param];
+            if (Array.isArray(value)) {
+                value.forEach((_value) => {
+                    updates.push({ param, value: _value, op: 'a' });
+                });
+            }
+            else {
+                updates.push({
+                    param,
+                    value: value,
+                    op: 'a',
+                });
+            }
+        });
+        return this.clone(updates);
+    }
+    /**
+     * Replaces the value for a parameter.
+     * @param param The parameter name.
+     * @param value The new value.
+     * @return A new body with the new value.
+     */
+    set(param, value) {
+        return this.clone({ param, value, op: 's' });
+    }
+    /**
+     * Removes a given value or all values from a parameter.
+     * @param param The parameter name.
+     * @param value The value to remove, if provided.
+     * @return A new body with the given value removed, or with all values
+     * removed if no value is specified.
+     */
+    delete(param, value) {
+        return this.clone({ param, value, op: 'd' });
+    }
+    /**
+     * Serializes the body to an encoded string, where key-value pairs (separated by `=`) are
+     * separated by `&`s.
+     */
+    toString() {
+        this.init();
+        return (this.keys()
+            .map((key) => {
+            const eKey = this.encoder.encodeKey(key);
+            // `a: ['1']` produces `'a=1'`
+            // `b: []` produces `''`
+            // `c: ['1', '2']` produces `'c=1&c=2'`
+            return this.map.get(key)
+                .map((value) => eKey + '=' + this.encoder.encodeValue(value))
+                .join('&');
+        })
+            // filter out empty values because `b: []` produces `''`
+            // which results in `a=1&&c=1&c=2` instead of `a=1&c=1&c=2` if we don't
+            .filter((param) => param !== '')
+            .join('&'));
+    }
+    toObject() {
+        return this.keys().reduce((acum, key) => {
+            const val = this.get(key);
+            if (val)
+                acum[key] = val;
+            return acum;
+        }, {});
+    }
+    clone(update) {
+        const clone = new HttpParams({
+            encoder: this.encoder,
+        });
+        clone.cloneFrom = this.cloneFrom || this;
+        clone.updates = (this.updates || []).concat(update);
+        return clone;
+    }
+    init() {
+        if (this.map === null) {
+            this.map = new Map();
+        }
+        if (this.cloneFrom !== null) {
+            this.cloneFrom.init();
+            this.cloneFrom
+                .keys()
+                .forEach((key) => this.map.set(key, this.cloneFrom.map.get(key)));
+            this.updates.forEach((update) => {
+                switch (update.op) {
+                    case 'a':
+                    case 's':
+                        const base = (update.op === 'a' ? this.map.get(update.param) : undefined) ||
+                            [];
+                        base.push(valueToString(update.value));
+                        this.map.set(update.param, base);
+                        break;
+                    case 'd':
+                        if (update.value !== undefined) {
+                            let base = this.map.get(update.param) || [];
+                            const idx = base.indexOf(valueToString(update.value));
+                            if (idx !== -1) {
+                                base.splice(idx, 1);
+                            }
+                            if (base.length > 0) {
+                                this.map.set(update.param, base);
+                            }
+                            else {
+                                this.map.delete(update.param);
+                            }
+                        }
+                        else {
+                            this.map.delete(update.param);
+                            break;
+                        }
+                }
+            });
+            this.cloneFrom = this.updates = null;
+        }
+    }
+}
+//# sourceMappingURL=http-params.js.map