@getbrevo/brevo 5.0.4 → 6.0.2

package/dist/esm/api/types/SendTransacSms.d.mts

@@ -1,11 +1,11 @@
 export interface SendTransacSms {
     /** A recognizable prefix will ensure your audience knows who you are. Recommended by U.S. carriers. This will be added as your Brand Name before the message content. **Prefer verifying maximum length of 160 characters including this prefix in message content to avoid multiple sending of same sms.** */
     organisationPrefix?: string | undefined;
-    /** Mobile number to send SMS with the country code */
+    /** Mobile number to send SMS with the country code. Must contain between 6 and 15 digits, optionally prefixed with '+'. */
     recipient: string;
-    /** Name of the sender. **The number of characters is limited to 11 for alphanumeric characters and 15 for numeric characters** */
+    /** Name of the sender. **The number of characters is limited to 11 for alphanumeric characters and 15 for numeric characters.** Alphanumeric sender names (up to 11 characters) must contain only letters and digits. Numeric sender names (12-15 characters) must contain only digits. */
     sender: string;
-    /** Tag of the message */
+    /** Tag of the message. Can be a single string or an array of strings (maximum 10 tags). Each tag must be a non-empty string. */
     tag?: SendTransacSms.Tag | undefined;
     /** Type of the SMS. Marketing SMS messages are those sent typically with marketing content. Transactional SMS messages are sent to individuals and are triggered in response to some action, such as a sign-up, purchase, etc. */
     type?: SendTransacSms.Type | undefined;
@@ -13,6 +13,8 @@ export interface SendTransacSms {
     unicodeEnabled?: boolean | undefined;
     /** Webhook to call for each event triggered by the message (delivered etc.) */
     webUrl?: string | undefined;
+    /** Pass the set of attributes to customize the template. For example, {"FNAME":"Joe", "LNAME":"Doe"}. These are the placeholder variables in the template that will be replaced with the corresponding values passed in the params object. Applicable only if `templateId` is used. */
+    params?: Record<string, unknown> | undefined;
     /** Template ID to send SMS with the template. When provided, overrides the content parameter. Mandatory if 'content' is not passed. */
     templateId?: number | undefined;
     /** Content of the message. If more than **160 characters** long, will be sent as multiple text messages. Mandatory if 'templateId' is not passed, ignored if 'templateId' is passed. */
@@ -20,18 +22,9 @@ export interface SendTransacSms {
 }
 export declare namespace SendTransacSms {
     /**
-     * Tag of the message
+     * Tag of the message. Can be a single string or an array of strings (maximum 10 tags). Each tag must be a non-empty string.
      */
-    interface Tag {
-        /** A tag can be a string or an array of strings. */
-        field?: Tag.Field | undefined;
-    }
-    namespace Tag {
-        /**
-         * A tag can be a string or an array of strings.
-         */
-        type Field = string | string[];
-    }
+    type Tag = string | string[];
     /** Type of the SMS. Marketing SMS messages are those sent typically with marketing content. Transactional SMS messages are sent to individuals and are triggered in response to some action, such as a sign-up, purchase, etc. */
     const Type: {
         readonly Transactional: "transactional";

package/dist/esm/api/types/Task.d.mts

@@ -2,16 +2,28 @@
  * Task Details
  */
 export interface Task {
-    /** Companies ids for companies a task is linked to */
-    companiesIds?: string[] | undefined;
-    /** Contact ids for contacts linked to this task */
-    contactsIds?: number[] | undefined;
-    /** Deal ids for deals a task is linked to */
-    dealsIds?: string[] | undefined;
     /** Unique task id */
     id?: string | undefined;
-    /** Name of task */
-    name: string;
     /** Id for type of task e.g Call / Email / Meeting etc. */
     taskTypeId: string;
+    /** Name of task */
+    name: string;
+    /** Companies ids for companies a task is linked to */
+    companiesIds?: string[] | undefined;
+    /** Deal ids for deals a task is linked to */
+    dealsIds?: string[] | undefined;
+    /** Contact ids for contacts linked to this task */
+    contactsIds?: number[] | undefined;
+    /** Account id of the user assigned to this task */
+    assignToId?: string | undefined;
+    /** Task due date and time */
+    date: string;
+    /** Notes added to a task */
+    notes?: string | undefined;
+    /** Whether the task is marked as done */
+    done?: boolean | undefined;
+    /** Task creation date/time */
+    createdAt?: string | undefined;
+    /** Task last update date/time */
+    updatedAt?: string | undefined;
 }

package/dist/esm/api/types/TierGroup.d.mts

@@ -15,6 +15,10 @@ export interface TierGroup {
     updatedAt?: string | undefined;
     /** Select real_time to upgrade tier on real time balance updates. Select membership_anniversary to upgrade tier on subscription anniversary. Select tier_anniversary to upgrade tier on tier anniversary. */
     upgradeStrategy?: TierGroup.UpgradeStrategy | undefined;
+    /** Schedule configuration for tier upgrades. */
+    upgradeSchedule?: TierGroup.UpgradeSchedule | undefined;
+    /** Schedule configuration for tier downgrades. */
+    downgradeSchedule?: TierGroup.DowngradeSchedule | undefined;
 }
 export declare namespace TierGroup {
     /** Select real_time to downgrade tier on real time balance updates. Select membership_anniversary to downgrade tier on subscription anniversary. Select tier_anniversary to downgrade tier on tier anniversary. */
@@ -31,4 +35,66 @@ export declare namespace TierGroup {
         readonly TierAnniversary: "tier_anniversary";
     };
     type UpgradeStrategy = (typeof UpgradeStrategy)[keyof typeof UpgradeStrategy];
+    /**
+     * Schedule configuration for tier upgrades.
+     */
+    interface UpgradeSchedule {
+        /** Schedule strategy type. */
+        strategy?: string | undefined;
+        /** Duration value for the schedule. */
+        durationValue?: number | undefined;
+        /** Duration unit for the schedule. */
+        durationUnit?: UpgradeSchedule.DurationUnit | undefined;
+        /** Modifier for the duration. */
+        durationModifier?: UpgradeSchedule.DurationModifier | undefined;
+        /** Scheduled date in DD/MM format. */
+        scheduledDate?: string | undefined;
+    }
+    namespace UpgradeSchedule {
+        /** Duration unit for the schedule. */
+        const DurationUnit: {
+            readonly Day: "day";
+            readonly Week: "week";
+            readonly Month: "month";
+            readonly Year: "year";
+        };
+        type DurationUnit = (typeof DurationUnit)[keyof typeof DurationUnit];
+        /** Modifier for the duration. */
+        const DurationModifier: {
+            readonly StartOfPeriod: "start_of_period";
+            readonly EndOfPeriod: "end_of_period";
+        };
+        type DurationModifier = (typeof DurationModifier)[keyof typeof DurationModifier];
+    }
+    /**
+     * Schedule configuration for tier downgrades.
+     */
+    interface DowngradeSchedule {
+        /** Schedule strategy type. */
+        strategy?: string | undefined;
+        /** Duration value for the schedule. */
+        durationValue?: number | undefined;
+        /** Duration unit for the schedule. */
+        durationUnit?: DowngradeSchedule.DurationUnit | undefined;
+        /** Modifier for the duration. */
+        durationModifier?: DowngradeSchedule.DurationModifier | undefined;
+        /** Scheduled date in DD/MM format. */
+        scheduledDate?: string | undefined;
+    }
+    namespace DowngradeSchedule {
+        /** Duration unit for the schedule. */
+        const DurationUnit: {
+            readonly Day: "day";
+            readonly Week: "week";
+            readonly Month: "month";
+            readonly Year: "year";
+        };
+        type DurationUnit = (typeof DurationUnit)[keyof typeof DurationUnit];
+        /** Modifier for the duration. */
+        const DurationModifier: {
+            readonly StartOfPeriod: "start_of_period";
+            readonly EndOfPeriod: "end_of_period";
+        };
+        type DurationModifier = (typeof DurationModifier)[keyof typeof DurationModifier];
+    }
 }

package/dist/esm/api/types/TierGroup.mjs

@@ -13,4 +13,34 @@ export var TierGroup;
         MembershipAnniversary: "membership_anniversary",
         TierAnniversary: "tier_anniversary",
     };
+    let UpgradeSchedule;
+    (function (UpgradeSchedule) {
+        /** Duration unit for the schedule. */
+        UpgradeSchedule.DurationUnit = {
+            Day: "day",
+            Week: "week",
+            Month: "month",
+            Year: "year",
+        };
+        /** Modifier for the duration. */
+        UpgradeSchedule.DurationModifier = {
+            StartOfPeriod: "start_of_period",
+            EndOfPeriod: "end_of_period",
+        };
+    })(UpgradeSchedule = TierGroup.UpgradeSchedule || (TierGroup.UpgradeSchedule = {}));
+    let DowngradeSchedule;
+    (function (DowngradeSchedule) {
+        /** Duration unit for the schedule. */
+        DowngradeSchedule.DurationUnit = {
+            Day: "day",
+            Week: "week",
+            Month: "month",
+            Year: "year",
+        };
+        /** Modifier for the duration. */
+        DowngradeSchedule.DurationModifier = {
+            StartOfPeriod: "start_of_period",
+            EndOfPeriod: "end_of_period",
+        };
+    })(DowngradeSchedule = TierGroup.DowngradeSchedule || (TierGroup.DowngradeSchedule = {}));
 })(TierGroup || (TierGroup = {}));

package/dist/esm/api/types/Transaction.d.mts

@@ -2,34 +2,53 @@
  * Represents a transaction involving a balance, including status and timestamps.
  */
 export interface Transaction {
+    /** Unique identifier (UUID) of the transaction. */
+    id?: string | undefined;
     /** The transaction amount. */
     amount?: number | undefined;
+    /** The type of the transaction. */
+    transactionType?: Transaction.TransactionType | undefined;
+    /** Optional metadata associated with the transaction. */
+    meta?: Record<string, unknown> | undefined;
+    /** The current status of the transaction. */
+    status?: Transaction.Status | undefined;
+    /** Unique identifier (UUID) of the associated loyalty program. */
+    loyaltyProgramId?: string | undefined;
     /** Unique identifier (UUID) of the associated balance definition. */
     balanceDefinitionId?: string | undefined;
-    /** Timestamp when the transaction was canceled (nullable). */
-    cancelledAt?: string | undefined;
-    /** Timestamp when the transaction was completed (nullable). */
-    completedAt?: string | undefined;
     /** Unique identifier of the contact associated with the transaction. */
     contactId?: number | undefined;
-    /** Timestamp when the transaction was created. */
-    createdAt?: string | undefined;
-    /** Optional timestamp indicating when the transaction event occurred. */
+    /** Optional timestamp indicating when the transaction event occurred (ISO 8601 format). */
     eventTime?: string | undefined;
-    /** Expiry date of the transaction (nullable). */
-    expirationDate?: string | undefined;
-    /** Unique identifier (UUID) of the transaction. */
-    id?: string | undefined;
-    /** Unique identifier (UUID) of the associated loyalty program. */
-    loyaltyProgramId?: string | undefined;
-    /** Optional metadata associated with the transaction. */
-    meta?: Record<string, unknown> | undefined;
     /** Reason for rejection if the transaction was declined (nullable). */
     rejectReason?: string | undefined;
     /** Timestamp when the transaction was rejected (nullable). */
     rejectedAt?: string | undefined;
-    /** The current status of the transaction (e.g., pending, completed, rejected). */
-    status?: string | undefined;
+    /** Expiry date of the transaction (nullable). */
+    expirationDate?: string | undefined;
+    /** Timestamp when the transaction was completed (nullable). */
+    completedAt?: string | undefined;
+    /** Timestamp when the transaction was canceled (nullable). */
+    cancelledAt?: string | undefined;
+    /** Timestamp when the transaction was created. */
+    createdAt?: string | undefined;
     /** Timestamp when the transaction was last updated. */
     updatedAt?: string | undefined;
 }
+export declare namespace Transaction {
+    /** The type of the transaction. */
+    const TransactionType: {
+        readonly Credit: "credit";
+        readonly Debit: "debit";
+    };
+    type TransactionType = (typeof TransactionType)[keyof typeof TransactionType];
+    /** The current status of the transaction. */
+    const Status: {
+        readonly Pending: "pending";
+        readonly Complete: "complete";
+        readonly Rejected: "rejected";
+        readonly Cancelled: "cancelled";
+        readonly Expired: "expired";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+}

package/dist/esm/api/types/Transaction.mjs

@@ -1,2 +1,17 @@
 // This file was auto-generated by Fern from our API Definition.
-export {};
+export var Transaction;
+(function (Transaction) {
+    /** The type of the transaction. */
+    Transaction.TransactionType = {
+        Credit: "credit",
+        Debit: "debit",
+    };
+    /** The current status of the transaction. */
+    Transaction.Status = {
+        Pending: "pending",
+        Complete: "complete",
+        Rejected: "rejected",
+        Cancelled: "cancelled",
+        Expired: "expired",
+    };
+})(Transaction || (Transaction = {}));

package/dist/esm/api/types/WalletPassInstallUrl.d.mts

@@ -0,0 +1,4 @@
+export interface WalletPassInstallUrl {
+    /** The wallet installation URL for the contact. Opening it lets the contact add the pass to their Apple Wallet or Google Wallet. */
+    url: string;
+}

package/dist/esm/api/types/WalletPassInstallUrl.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/index.d.mts

@@ -9,6 +9,9 @@ export * from "./BatchEventsResponse.mjs";
 export * from "./Cart.mjs";
 export * from "./Company.mjs";
 export * from "./Configuration.mjs";
+export * from "./ConsentGroup.mjs";
+export * from "./ConsentGroupItem.mjs";
+export * from "./ConsentGroupsListResponse.mjs";
 export * from "./ContactErrorModel.mjs";
 export * from "./ConversationsMessage.mjs";
 export * from "./ConversionSourceMetrics.mjs";
@@ -62,4 +65,5 @@ export * from "./UnauthorizedErrorBody.mjs";
 export * from "./UpdateCampaignStatus.mjs";
 export * from "./ValueResponse.mjs";
 export * from "./VariablesItems.mjs";
+export * from "./WalletPassInstallUrl.mjs";
 export * from "./WhatsappCampStats.mjs";

package/dist/esm/api/types/index.mjs

@@ -9,6 +9,9 @@ export * from "./BatchEventsResponse.mjs";
 export * from "./Cart.mjs";
 export * from "./Company.mjs";
 export * from "./Configuration.mjs";
+export * from "./ConsentGroup.mjs";
+export * from "./ConsentGroupItem.mjs";
+export * from "./ConsentGroupsListResponse.mjs";
 export * from "./ContactErrorModel.mjs";
 export * from "./ConversationsMessage.mjs";
 export * from "./ConversionSourceMetrics.mjs";
@@ -62,4 +65,5 @@ export * from "./UnauthorizedErrorBody.mjs";
 export * from "./UpdateCampaignStatus.mjs";
 export * from "./ValueResponse.mjs";
 export * from "./VariablesItems.mjs";
+export * from "./WalletPassInstallUrl.mjs";
 export * from "./WhatsappCampStats.mjs";

package/dist/esm/core/auth/AuthProvider.d.mts

@@ -5,3 +5,4 @@ export interface AuthProvider {
         endpointMetadata?: EndpointMetadata;
     }): Promise<AuthRequest>;
 }
+export declare function isAuthProvider(value: unknown): value is AuthProvider;

package/dist/esm/core/auth/AuthProvider.mjs

@@ -1 +1,6 @@
-export {};
+export function isAuthProvider(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "getAuthRequest" in value &&
+        typeof value.getAuthRequest === "function");
+}

package/dist/esm/core/auth/index.d.mts

@@ -1,4 +1,4 @@
-export type { AuthProvider } from "./AuthProvider.mjs";
+export { type AuthProvider, isAuthProvider } from "./AuthProvider.mjs";
 export type { AuthRequest } from "./AuthRequest.mjs";
 export { BasicAuth } from "./BasicAuth.mjs";
 export { BearerToken } from "./BearerToken.mjs";

package/dist/esm/core/auth/index.mjs

@@ -1,3 +1,4 @@
+export { isAuthProvider } from "./AuthProvider.mjs";
 export { BasicAuth } from "./BasicAuth.mjs";
 export { BearerToken } from "./BearerToken.mjs";
 export { NoOpAuthProvider } from "./NoOpAuthProvider.mjs";

package/dist/esm/core/fetcher/Fetcher.d.mts

@@ -8,7 +8,13 @@ export declare namespace Fetcher {
         method: string;
         contentType?: string;
         headers?: Record<string, unknown>;
+        /**
+         * @deprecated Prefer `queryString` (produced by `core.url.queryBuilder()`).
+         * Retained for backwards compatibility with custom fetchers and callers that
+         * still construct request args with a query-parameter object.
+         */
         queryParameters?: Record<string, unknown>;
+        queryString?: string;
         body?: unknown;
         timeoutMs?: number;
         maxRetries?: number;

package/dist/esm/core/fetcher/Fetcher.mjs

@@ -71,16 +71,11 @@ const SENSITIVE_QUERY_PARAMS = new Set([
 ]);
 function redactQueryParameters(queryParameters) {
     if (queryParameters == null) {
-        return queryParameters;
+        return undefined;
     }
     const redacted = {};
     for (const [key, value] of Object.entries(queryParameters)) {
-        if (SENSITIVE_QUERY_PARAMS.has(key.toLowerCase())) {
-            redacted[key] = "[REDACTED]";
-        }
-        else {
-            redacted[key] = value;
-        }
+        redacted[key] = SENSITIVE_QUERY_PARAMS.has(key.toLowerCase()) ? "[REDACTED]" : value;
     }
     return redacted;
 }
@@ -182,7 +177,13 @@ function getHeaders(args) {
 export function fetcherImpl(args) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a, _b, _c;
-        const url = createRequestUrl(args.url, args.queryParameters);
+        let url = args.url;
+        if (args.queryString != null && args.queryString.length > 0) {
+            url = `${url}?${args.queryString}`;
+        }
+        else {
+            url = createRequestUrl(args.url, args.queryParameters);
+        }
         const requestBody = yield getRequestBody({
             body: args.body,
             type: (_a = args.requestType) !== null && _a !== void 0 ? _a : "other",

package/dist/esm/core/fetcher/getResponseBody.mjs

@@ -9,6 +9,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { fromJson } from "../json.mjs";
 import { getBinaryResponse } from "./BinaryResponse.mjs";
+// Pins the upstream Response so undici's FinalizationRegistry can't GC it and cancel the body stream.
+function retainResponse(target, response) {
+    Object.defineProperty(target, "__fern_response_ref", {
+        value: response,
+        enumerable: false,
+        configurable: true,
+        writable: false,
+    });
+}
 export function getResponseBody(response, responseType) {
     return __awaiter(this, void 0, void 0, function* () {
         switch (responseType) {
@@ -28,6 +37,7 @@ export function getResponseBody(response, responseType) {
                         },
                     };
                 }
+                retainResponse(response.body, response);
                 return response.body;
             case "streaming":
                 if (response.body == null) {
@@ -39,6 +49,7 @@ export function getResponseBody(response, responseType) {
                         },
                     };
                 }
+                retainResponse(response.body, response);
                 return response.body;
             case "text":
                 return yield response.text();

package/dist/esm/core/fetcher/requestWithRetries.mjs

@@ -11,6 +11,9 @@ const INITIAL_RETRY_DELAY = 1000; // in milliseconds
 const MAX_RETRY_DELAY = 60000; // in milliseconds
 const DEFAULT_MAX_RETRIES = 2;
 const JITTER_FACTOR = 0.2; // 20% random jitter
+function isRetryableStatusCode(statusCode) {
+    return [408, 429].includes(statusCode) || statusCode >= 500;
+}
 function addPositiveJitter(delay) {
     const jitterMultiplier = 1 + Math.random() * JITTER_FACTOR;
     return delay * jitterMultiplier;
@@ -50,7 +53,7 @@ export function requestWithRetries(requestFn_1) {
     return __awaiter(this, arguments, void 0, function* (requestFn, maxRetries = DEFAULT_MAX_RETRIES) {
         let response = yield requestFn();
         for (let i = 0; i < maxRetries; ++i) {
-            if ([408, 429].includes(response.status) || response.status >= 500) {
+            if (isRetryableStatusCode(response.status)) {
                 const delay = getRetryDelayFromHeaders(response, i);
                 yield new Promise((resolve) => setTimeout(resolve, delay));
                 response = yield requestFn();

package/dist/esm/core/fetcher/signals.mjs

@@ -10,11 +10,19 @@ export function anySignal(...args) {
     for (const signal of signals) {
         if (signal.aborted) {
             controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason);
-            break;
+            return controller.signal;
         }
         signal.addEventListener("abort", () => controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason), {
             signal: controller.signal,
         });
+        // Re-check after adding listener: the signal may have aborted
+        // between the initial `signal.aborted` check and the `addEventListener`
+        // call above. If it did, the abort event was already dispatched and
+        // the listener will never fire — we must manually abort.
+        if (signal.aborted) {
+            controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason);
+            return controller.signal;
+        }
     }
     return controller.signal;
 }

package/dist/esm/core/url/QueryStringBuilder.d.mts

@@ -0,0 +1,47 @@
+/**
+ * Creates a fluent builder for constructing URL query strings.
+ *
+ * Each `.add()` call serializes its value immediately (like C#'s builder),
+ * so no format tracking is needed — the style is applied at add-time.
+ *
+ * Usage (generated code):
+ *
+ *     const qs = core.url.queryBuilder()
+ *         .add("limit", limit)
+ *         .add("tags", tags, { style: "comma" })   // explode: false
+ *         .mergeAdditional(requestOptions?.queryParams)
+ *         .build();
+ */
+export declare function queryBuilder(): QueryStringBuilder;
+declare class QueryStringBuilder {
+    private parts;
+    /**
+     * Adds a query parameter, serializing it immediately.
+     *
+     * By default arrays use "repeat" format (`key=a&key=b`).
+     * Pass `{ style: "comma" }` for OpenAPI `explode: false` parameters
+     * to get comma-separated values (`key=a,b,c`).
+     *
+     * Null / undefined values are silently skipped.
+     */
+    add(key: string, value: unknown, options?: {
+        style?: "comma";
+    }): this;
+    /**
+     * Adds multiple query parameters at once from a record.
+     * All parameters use the default "repeat" array format.
+     * Null / undefined values are silently skipped.
+     */
+    addMany(params: Record<string, unknown>): this;
+    /**
+     * Merges additional query parameters supplied at call-time via
+     * `requestOptions.queryParams`. Overrides existing keys (last-write-wins).
+     */
+    mergeAdditional(additionalParams?: Record<string, unknown>): this;
+    /**
+     * Returns the assembled query string (without the leading `?`).
+     * Returns an empty string when no parameters were added.
+     */
+    build(): string;
+}
+export {};

package/dist/esm/core/url/QueryStringBuilder.mjs

@@ -0,0 +1,80 @@
+import { toQueryString } from "./qs.mjs";
+/**
+ * Creates a fluent builder for constructing URL query strings.
+ *
+ * Each `.add()` call serializes its value immediately (like C#'s builder),
+ * so no format tracking is needed — the style is applied at add-time.
+ *
+ * Usage (generated code):
+ *
+ *     const qs = core.url.queryBuilder()
+ *         .add("limit", limit)
+ *         .add("tags", tags, { style: "comma" })   // explode: false
+ *         .mergeAdditional(requestOptions?.queryParams)
+ *         .build();
+ */
+export function queryBuilder() {
+    return new QueryStringBuilder();
+}
+class QueryStringBuilder {
+    constructor() {
+        this.parts = new Map();
+    }
+    /**
+     * Adds a query parameter, serializing it immediately.
+     *
+     * By default arrays use "repeat" format (`key=a&key=b`).
+     * Pass `{ style: "comma" }` for OpenAPI `explode: false` parameters
+     * to get comma-separated values (`key=a,b,c`).
+     *
+     * Null / undefined values are silently skipped.
+     */
+    add(key, value, options) {
+        if (value === undefined || value === null) {
+            return this;
+        }
+        const serialized = toQueryString({ [key]: value }, { arrayFormat: (options === null || options === void 0 ? void 0 : options.style) === "comma" ? "comma" : "repeat" });
+        if (serialized.length > 0) {
+            this.parts.set(key, serialized);
+        }
+        return this;
+    }
+    /**
+     * Adds multiple query parameters at once from a record.
+     * All parameters use the default "repeat" array format.
+     * Null / undefined values are silently skipped.
+     */
+    addMany(params) {
+        if (params != null) {
+            for (const [key, value] of Object.entries(params)) {
+                this.add(key, value);
+            }
+        }
+        return this;
+    }
+    /**
+     * Merges additional query parameters supplied at call-time via
+     * `requestOptions.queryParams`. Overrides existing keys (last-write-wins).
+     */
+    mergeAdditional(additionalParams) {
+        if (additionalParams != null) {
+            for (const [key, value] of Object.entries(additionalParams)) {
+                if (value === undefined || value === null) {
+                    continue;
+                }
+                const serialized = toQueryString({ [key]: value }, { arrayFormat: "repeat" });
+                if (serialized.length > 0) {
+                    this.parts.set(key, serialized);
+                }
+            }
+        }
+        return this;
+    }
+    /**
+     * Returns the assembled query string (without the leading `?`).
+     * Returns an empty string when no parameters were added.
+     */
+    build() {
+        return [...this.parts.values()].join("&");
+    }
+}

package/dist/esm/core/url/index.d.mts

@@ -1,3 +1,4 @@
 export { encodePathParam } from "./encodePathParam.mjs";
 export { join } from "./join.mjs";
+export { queryBuilder } from "./QueryStringBuilder.mjs";
 export { toQueryString } from "./qs.mjs";

package/dist/esm/core/url/index.mjs

@@ -1,3 +1,4 @@
 export { encodePathParam } from "./encodePathParam.mjs";
 export { join } from "./join.mjs";
+export { queryBuilder } from "./QueryStringBuilder.mjs";
 export { toQueryString } from "./qs.mjs";

package/dist/esm/core/url/qs.d.mts

@@ -1,5 +1,6 @@
+type ArrayFormat = "indices" | "repeat" | "comma";
 interface QueryStringOptions {
-    arrayFormat?: "indices" | "repeat";
+    arrayFormat?: ArrayFormat;
     encode?: boolean;
 }
 export declare function toQueryString(obj: unknown, options?: QueryStringOptions): string;