@elevenlabs/elevenlabs-js 2.51.0 → 2.53.0

package/core/schemas/builders/primitives/never.d.ts

@@ -1,2 +1,2 @@
-import { type Schema } from "../../Schema.js";
+import { type Schema } from "../../Schema";
 export declare const never: () => Schema<never, never>;

package/core/schemas/builders/primitives/never.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.never = void 0;
-const Schema_js_1 = require("../../Schema.js");
-const createIdentitySchemaCreator_js_1 = require("../../utils/createIdentitySchemaCreator.js");
-exports.never = (0, createIdentitySchemaCreator_js_1.createIdentitySchemaCreator)(Schema_js_1.SchemaType.NEVER, (_value, { breadcrumbsPrefix = [] } = {}) => ({
+const Schema_1 = require("../../Schema");
+const createIdentitySchemaCreator_1 = require("../../utils/createIdentitySchemaCreator");
+exports.never = (0, createIdentitySchemaCreator_1.createIdentitySchemaCreator)(Schema_1.SchemaType.NEVER, (_value, { breadcrumbsPrefix = [] } = {}) => ({
     ok: false,
     errors: [
         {

package/core/schemas/builders/record/index.d.ts

@@ -1,2 +1,2 @@
-export { record } from "./record";
-export type { BaseRecordSchema, RecordSchema } from "./types";
+export { partialRecord, record } from "./record";
+export type { BasePartialRecordSchema, BaseRecordSchema, PartialRecordSchema, RecordSchema } from "./types";

package/core/schemas/builders/record/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.record = void 0;
+exports.record = exports.partialRecord = void 0;
 var record_1 = require("./record");
+Object.defineProperty(exports, "partialRecord", { enumerable: true, get: function () { return record_1.partialRecord; } });
 Object.defineProperty(exports, "record", { enumerable: true, get: function () { return record_1.record; } });

package/core/schemas/builders/record/record.d.ts

@@ -1,3 +1,4 @@
 import { type Schema } from "../../Schema";
-import type { RecordSchema } from "./types";
+import type { PartialRecordSchema, RecordSchema } from "./types";
 export declare function record<RawKey extends string | number, RawValue, ParsedValue, ParsedKey extends string | number>(keySchema: Schema<RawKey, ParsedKey>, valueSchema: Schema<RawValue, ParsedValue>): RecordSchema<RawKey, RawValue, ParsedKey, ParsedValue>;
+export declare function partialRecord<RawKey extends string | number, RawValue, ParsedValue, ParsedKey extends string | number>(keySchema: Schema<RawKey, ParsedKey>, valueSchema: Schema<RawValue, ParsedValue>): PartialRecordSchema<RawKey, RawValue, ParsedKey, ParsedValue>;

package/core/schemas/builders/record/record.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.record = record;
+exports.partialRecord = partialRecord;
 const Schema_1 = require("../../Schema");
-const entries_1 = require("../../utils/entries");
 const getErrorMessageForIncorrectType_1 = require("../../utils/getErrorMessageForIncorrectType");
 const isPlainObject_1 = require("../../utils/isPlainObject");
 const maybeSkipValidation_1 = require("../../utils/maybeSkipValidation");
 const index_1 = require("../schema-utils/index");
+// eslint-disable-next-line @typescript-eslint/unbound-method
+const _hasOwn = Object.prototype.hasOwnProperty;
 function record(keySchema, valueSchema) {
     const baseSchema = {
         parse: (raw, opts) => {
@@ -43,6 +45,42 @@ function record(keySchema, valueSchema) {
     };
     return Object.assign(Object.assign({}, (0, maybeSkipValidation_1.maybeSkipValidation)(baseSchema)), (0, index_1.getSchemaUtils)(baseSchema));
 }
+function partialRecord(keySchema, valueSchema) {
+    const baseSchema = {
+        parse: (raw, opts) => {
+            return validateAndTransformRecord({
+                value: raw,
+                isKeyNumeric: keySchema.getType() === Schema_1.SchemaType.NUMBER,
+                transformKey: (key) => {
+                    var _a;
+                    return keySchema.parse(key, Object.assign(Object.assign({}, opts), { breadcrumbsPrefix: [...((_a = opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix) !== null && _a !== void 0 ? _a : []), `${key} (key)`] }));
+                },
+                transformValue: (value, key) => {
+                    var _a;
+                    return valueSchema.parse(value, Object.assign(Object.assign({}, opts), { breadcrumbsPrefix: [...((_a = opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix) !== null && _a !== void 0 ? _a : []), `${key}`] }));
+                },
+                breadcrumbsPrefix: opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix,
+            });
+        },
+        json: (parsed, opts) => {
+            return validateAndTransformRecord({
+                value: parsed,
+                isKeyNumeric: keySchema.getType() === Schema_1.SchemaType.NUMBER,
+                transformKey: (key) => {
+                    var _a;
+                    return keySchema.json(key, Object.assign(Object.assign({}, opts), { breadcrumbsPrefix: [...((_a = opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix) !== null && _a !== void 0 ? _a : []), `${key} (key)`] }));
+                },
+                transformValue: (value, key) => {
+                    var _a;
+                    return valueSchema.json(value, Object.assign(Object.assign({}, opts), { breadcrumbsPrefix: [...((_a = opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix) !== null && _a !== void 0 ? _a : []), `${key}`] }));
+                },
+                breadcrumbsPrefix: opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix,
+            });
+        },
+        getType: () => Schema_1.SchemaType.RECORD,
+    };
+    return Object.assign(Object.assign({}, (0, maybeSkipValidation_1.maybeSkipValidation)(baseSchema)), (0, index_1.getSchemaUtils)(baseSchema));
+}
 function validateAndTransformRecord({ value, isKeyNumeric, transformKey, transformValue, breadcrumbsPrefix = [], }) {
     if (!(0, isPlainObject_1.isPlainObject)(value)) {
         return {
@@ -55,11 +93,16 @@ function validateAndTransformRecord({ value, isKeyNumeric, transformKey, transfo
             ],
         };
     }
-    return (0, entries_1.entries)(value).reduce((accPromise, [stringKey, value]) => {
-        if (value === undefined) {
-            return accPromise;
+    const result = {};
+    const errors = [];
+    for (const stringKey in value) {
+        if (!_hasOwn.call(value, stringKey)) {
+            continue;
+        }
+        const entryValue = value[stringKey];
+        if (entryValue === undefined) {
+            continue;
         }
-        const acc = accPromise;
         let key = stringKey;
         if (isKeyNumeric) {
             const numberKey = stringKey.length > 0 ? Number(stringKey) : NaN;
@@ -68,26 +111,21 @@ function validateAndTransformRecord({ value, isKeyNumeric, transformKey, transfo
             }
         }
         const transformedKey = transformKey(key);
-        const transformedValue = transformValue(value, key);
-        if (acc.ok && transformedKey.ok && transformedValue.ok) {
-            return {
-                ok: true,
-                value: Object.assign(Object.assign({}, acc.value), { [transformedKey.value]: transformedValue.value }),
-            };
-        }
-        const errors = [];
-        if (!acc.ok) {
-            errors.push(...acc.errors);
+        const transformedValue = transformValue(entryValue, key);
+        if (transformedKey.ok && transformedValue.ok) {
+            result[transformedKey.value] = transformedValue.value;
         }
-        if (!transformedKey.ok) {
-            errors.push(...transformedKey.errors);
-        }
-        if (!transformedValue.ok) {
-            errors.push(...transformedValue.errors);
+        else {
+            if (!transformedKey.ok) {
+                errors.push(...transformedKey.errors);
+            }
+            if (!transformedValue.ok) {
+                errors.push(...transformedValue.errors);
+            }
         }
-        return {
-            ok: false,
-            errors,
-        };
-    }, { ok: true, value: {} });
+    }
+    if (errors.length === 0) {
+        return { ok: true, value: result };
+    }
+    return { ok: false, errors };
 }

package/core/schemas/builders/record/types.d.ts

@@ -2,3 +2,5 @@ import type { BaseSchema } from "../../Schema";
 import type { SchemaUtils } from "../schema-utils/index";
 export type RecordSchema<RawKey extends string | number, RawValue, ParsedKey extends string | number, ParsedValue> = BaseRecordSchema<RawKey, RawValue, ParsedKey, ParsedValue> & SchemaUtils<Record<RawKey, RawValue>, Record<ParsedKey, ParsedValue>>;
 export type BaseRecordSchema<RawKey extends string | number, RawValue, ParsedKey extends string | number, ParsedValue> = BaseSchema<Record<RawKey, RawValue>, Record<ParsedKey, ParsedValue>>;
+export type PartialRecordSchema<RawKey extends string | number, RawValue, ParsedKey extends string | number, ParsedValue> = BasePartialRecordSchema<RawKey, RawValue, ParsedKey, ParsedValue> & SchemaUtils<Record<RawKey, RawValue>, Partial<Record<ParsedKey, ParsedValue>>>;
+export type BasePartialRecordSchema<RawKey extends string | number, RawValue, ParsedKey extends string | number, ParsedValue> = BaseSchema<Record<RawKey, RawValue>, Partial<Record<ParsedKey, ParsedValue>>>;

package/core/schemas/builders/schema-utils/JsonError.js

@@ -6,7 +6,8 @@ class JsonError extends Error {
     constructor(errors) {
         super(errors.map(stringifyValidationErrors_1.stringifyValidationError).join("; "));
         this.errors = errors;
-        Object.setPrototypeOf(this, JsonError.prototype);
+        Object.setPrototypeOf(this, new.target.prototype);
+        this.name = this.constructor.name;
     }
 }
 exports.JsonError = JsonError;

package/core/schemas/builders/schema-utils/ParseError.js

@@ -6,7 +6,8 @@ class ParseError extends Error {
     constructor(errors) {
         super(errors.map(stringifyValidationErrors_1.stringifyValidationError).join("; "));
         this.errors = errors;
-        Object.setPrototypeOf(this, ParseError.prototype);
+        Object.setPrototypeOf(this, new.target.prototype);
+        this.name = this.constructor.name;
     }
 }
 exports.ParseError = ParseError;

package/core/schemas/builders/union/union.js

@@ -1,15 +1,4 @@
 "use strict";
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.union = union;
 const Schema_1 = require("../../Schema");
@@ -20,6 +9,8 @@ const maybeSkipValidation_1 = require("../../utils/maybeSkipValidation");
 const index_1 = require("../enum/index");
 const object_like_1 = require("../object-like");
 const index_2 = require("../schema-utils/index");
+// eslint-disable-next-line @typescript-eslint/unbound-method
+const _hasOwn = Object.prototype.hasOwnProperty;
 function union(discriminant, union) {
     const rawDiscriminant = typeof discriminant === "string" ? discriminant : discriminant.rawDiscriminant;
     const parsedDiscriminant = typeof discriminant === "string"
@@ -79,7 +70,13 @@ function transformAndValidateUnion({ value, discriminant, transformedDiscriminan
             ],
         };
     }
-    const _a = value, _b = discriminant, discriminantValue = _a[_b], additionalProperties = __rest(_a, [typeof _b === "symbol" ? _b : _b + ""]);
+    const discriminantValue = value[discriminant];
+    const additionalProperties = {};
+    for (const key in value) {
+        if (_hasOwn.call(value, key) && key !== discriminant) {
+            additionalProperties[key] = value[key];
+        }
+    }
     if (discriminantValue == null) {
         return {
             ok: false,

package/core/schemas/utils/isPlainObject.js

@@ -6,12 +6,10 @@ function isPlainObject(value) {
     if (typeof value !== "object" || value === null) {
         return false;
     }
-    if (Object.getPrototypeOf(value) === null) {
+    const proto = Object.getPrototypeOf(value);
+    if (proto === null) {
         return true;
     }
-    let proto = value;
-    while (Object.getPrototypeOf(proto) !== null) {
-        proto = Object.getPrototypeOf(proto);
-    }
-    return Object.getPrototypeOf(value) === proto;
+    // Check that the prototype chain has exactly one level (i.e., proto is Object.prototype)
+    return Object.getPrototypeOf(proto) === null;
 }

package/core/stream/Stream.d.ts

@@ -20,6 +20,7 @@ export declare namespace Stream {
     interface SseEvent {
         type: "sse";
         streamTerminator?: string;
+        eventDiscriminator?: string;
     }
 }
 export declare class Stream<T> implements AsyncIterable<T> {
@@ -32,12 +33,20 @@ export declare class Stream<T> implements AsyncIterable<T> {
     private prefix;
     private messageTerminator;
     private streamTerminator;
+    private eventDiscriminator;
     private controller;
     private decoder;
     constructor({ stream, parse, eventShape, signal }: Stream.Args & {
         parse: (val: unknown) => Promise<T>;
     });
     private iterMessages;
+    private iterDataMessages;
+    private iterSseEvents;
+    /**
+     * Parses and returns a single SSE event, or returns null if the event is a stream terminator.
+     */
+    private dispatchSseEvent;
+    private injectDiscriminator;
     [Symbol.asyncIterator](): AsyncIterator<T, void, unknown>;
     private decodeChunk;
 }

package/core/stream/Stream.js

@@ -16,6 +16,11 @@ var __asyncValues = (this && this.__asyncValues) || function (o) {
     function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
 };
 var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncDelegator = (this && this.__asyncDelegator) || function (o) {
+    var i, p;
+    return i = {}, verb("next"), verb("throw", function (e) { throw e; }), verb("return"), i[Symbol.iterator] = function () { return this; }, i;
+    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: false } : f ? f(v) : v; } : f; }
+};
 var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
     if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
     var g = generator.apply(thisArg, _arguments || []), i, q = [];
@@ -31,8 +36,10 @@ var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _ar
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Stream = void 0;
 exports.readableStreamAsyncIterable = readableStreamAsyncIterable;
+const json_1 = require("../json");
 const runtime_1 = require("../runtime");
 const DATA_PREFIX = "data:";
+const EVENT_PREFIX = "event:";
 class Stream {
     constructor({ stream, parse, eventShape, signal }) {
         this.controller = new AbortController();
@@ -42,6 +49,7 @@ class Stream {
             this.prefix = DATA_PREFIX;
             this.messageTerminator = "\n";
             this.streamTerminator = eventShape.streamTerminator;
+            this.eventDiscriminator = eventShape.eventDiscriminator;
         }
         else {
             this.messageTerminator = eventShape.messageTerminator;
@@ -54,8 +62,17 @@ class Stream {
     }
     iterMessages() {
         return __asyncGenerator(this, arguments, function* iterMessages_1() {
+            if (this.eventDiscriminator != null) {
+                yield __await(yield* __asyncDelegator(__asyncValues(this.iterSseEvents())));
+            }
+            else {
+                yield __await(yield* __asyncDelegator(__asyncValues(this.iterDataMessages())));
+            }
+        });
+    }
+    iterDataMessages() {
+        return __asyncGenerator(this, arguments, function* iterDataMessages_1() {
             var _a, e_1, _b, _c;
-            this.controller.signal;
             const stream = readableStreamAsyncIterable(this.stream);
             let buf = "";
             let prefixSeen = false;
@@ -83,7 +100,7 @@ class Stream {
                         if (this.streamTerminator != null && line.includes(this.streamTerminator)) {
                             return yield __await(void 0);
                         }
-                        const message = yield __await(this.parse(JSON.parse(line)));
+                        const message = yield __await(this.parse((0, json_1.fromJson)(line)));
                         yield yield __await(message);
                         prefixSeen = false;
                     }
@@ -98,9 +115,87 @@ class Stream {
             }
         });
     }
+    iterSseEvents() {
+        return __asyncGenerator(this, arguments, function* iterSseEvents_1() {
+            var _a, e_2, _b, _c;
+            const stream = readableStreamAsyncIterable(this.stream);
+            let buf = "";
+            let eventType;
+            let dataValue;
+            try {
+                for (var _d = true, stream_2 = __asyncValues(stream), stream_2_1; stream_2_1 = yield __await(stream_2.next()), _a = stream_2_1.done, !_a; _d = true) {
+                    _c = stream_2_1.value;
+                    _d = false;
+                    const chunk = _c;
+                    buf += this.decodeChunk(chunk);
+                    let terminatorIndex;
+                    while ((terminatorIndex = buf.indexOf("\n")) >= 0) {
+                        const line = buf.slice(0, terminatorIndex).replace(/\r$/, "");
+                        buf = buf.slice(terminatorIndex + 1);
+                        if (!line.trim()) {
+                            if (dataValue != null) {
+                                const message = yield __await(this.dispatchSseEvent(dataValue, eventType));
+                                if (message == null) {
+                                    return yield __await(void 0);
+                                }
+                                yield yield __await(message);
+                            }
+                            eventType = undefined;
+                            dataValue = undefined;
+                            continue;
+                        }
+                        if (line.startsWith(EVENT_PREFIX)) {
+                            eventType = line.slice(EVENT_PREFIX.length).trim();
+                        }
+                        else if (line.startsWith(DATA_PREFIX)) {
+                            const val = line.slice(DATA_PREFIX.length).trim();
+                            dataValue = dataValue != null ? `${dataValue}\n${val}` : val;
+                        }
+                    }
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = stream_2.return)) yield __await(_b.call(stream_2));
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+            if (dataValue != null) {
+                const message = yield __await(this.dispatchSseEvent(dataValue, eventType));
+                if (message != null) {
+                    yield yield __await(message);
+                }
+            }
+        });
+    }
+    /**
+     * Parses and returns a single SSE event, or returns null if the event is a stream terminator.
+     */
+    dispatchSseEvent(dataValue, eventType) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.streamTerminator != null && dataValue.includes(this.streamTerminator)) {
+                return null;
+            }
+            return this.parse(this.injectDiscriminator((0, json_1.fromJson)(dataValue), eventType));
+        });
+    }
+    injectDiscriminator(parsed, eventType) {
+        if (this.eventDiscriminator == null || eventType == null) {
+            return parsed;
+        }
+        if (parsed == null || typeof parsed !== "object" || Array.isArray(parsed)) {
+            return parsed;
+        }
+        const obj = parsed;
+        if (this.eventDiscriminator in obj) {
+            return parsed;
+        }
+        return Object.assign({ [this.eventDiscriminator]: eventType }, obj);
+    }
     [Symbol.asyncIterator]() {
         return __asyncGenerator(this, arguments, function* _a() {
-            var _b, e_2, _c, _d;
+            var _b, e_3, _c, _d;
             try {
                 for (var _e = true, _f = __asyncValues(this.iterMessages()), _g; _g = yield __await(_f.next()), _b = _g.done, !_b; _e = true) {
                     _d = _g.value;
@@ -109,12 +204,12 @@ class Stream {
                     yield yield __await(message);
                 }
             }
-            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            catch (e_3_1) { e_3 = { error: e_3_1 }; }
             finally {
                 try {
                     if (!_e && !_b && (_c = _f.return)) yield __await(_c.call(_f));
                 }
-                finally { if (e_2) throw e_2.error; }
+                finally { if (e_3) throw e_3.error; }
             }
         });
     }

package/core/url/QueryStringBuilder.d.ts

@@ -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/core/url/QueryStringBuilder.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryBuilder = queryBuilder;
+const qs_1 = require("./qs");
+/**
+ * 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();
+ */
+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 = (0, qs_1.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 = (0, qs_1.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/core/url/index.d.ts

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

package/core/url/index.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toQueryString = exports.join = exports.encodePathParam = void 0;
+exports.toQueryString = exports.queryBuilder = exports.join = exports.encodePathParam = void 0;
 var encodePathParam_1 = require("./encodePathParam");
 Object.defineProperty(exports, "encodePathParam", { enumerable: true, get: function () { return encodePathParam_1.encodePathParam; } });
 var join_1 = require("./join");
 Object.defineProperty(exports, "join", { enumerable: true, get: function () { return join_1.join; } });
+var QueryStringBuilder_1 = require("./QueryStringBuilder");
+Object.defineProperty(exports, "queryBuilder", { enumerable: true, get: function () { return QueryStringBuilder_1.queryBuilder; } });
 var qs_1 = require("./qs");
 Object.defineProperty(exports, "toQueryString", { enumerable: true, get: function () { return qs_1.toQueryString; } });

package/core/url/qs.d.ts

@@ -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;

package/core/url/qs.js

@@ -26,19 +26,31 @@ function stringifyObject(obj, prefix = "", options) {
             if (value.length === 0) {
                 continue;
             }
-            for (let i = 0; i < value.length; i++) {
-                const item = value[i];
-                if (item === undefined) {
-                    continue;
+            const effectiveFormat = options.arrayFormat;
+            if (effectiveFormat === "comma") {
+                const encodedKey = options.encode ? encodeURIComponent(fullKey) : fullKey;
+                const encodedValues = value
+                    .filter((item) => item !== undefined && item !== null)
+                    .map((item) => encodeValue(item, options.encode));
+                if (encodedValues.length > 0) {
+                    parts.push(`${encodedKey}=${encodedValues.join(",")}`);
                 }
-                if (typeof item === "object" && !Array.isArray(item) && item !== null) {
-                    const arrayKey = options.arrayFormat === "indices" ? `${fullKey}[${i}]` : fullKey;
-                    parts.push(...stringifyObject(item, arrayKey, options));
-                }
-                else {
-                    const arrayKey = options.arrayFormat === "indices" ? `${fullKey}[${i}]` : fullKey;
-                    const encodedKey = options.encode ? encodeURIComponent(arrayKey) : arrayKey;
-                    parts.push(`${encodedKey}=${encodeValue(item, options.encode)}`);
+            }
+            else {
+                for (let i = 0; i < value.length; i++) {
+                    const item = value[i];
+                    if (item === undefined) {
+                        continue;
+                    }
+                    if (typeof item === "object" && !Array.isArray(item) && item !== null) {
+                        const arrayKey = effectiveFormat === "indices" ? `${fullKey}[${i}]` : fullKey;
+                        parts.push(...stringifyObject(item, arrayKey, options));
+                    }
+                    else {
+                        const arrayKey = effectiveFormat === "indices" ? `${fullKey}[${i}]` : fullKey;
+                        const encodedKey = options.encode ? encodeURIComponent(arrayKey) : arrayKey;
+                        parts.push(`${encodedKey}=${encodeValue(item, options.encode)}`);
+                    }
                 }
             }
         }