@tapra/sdk 0.0.0-stage → 0.1.2

package/dist/src/core/stream/Stream.js

@@ -0,0 +1,427 @@
+import { fromJson } from "../json.js";
+import { RUNTIME } from "../runtime/index.js";
+const DATA_PREFIX = "data:";
+const EVENT_PREFIX = "event:";
+const ID_PREFIX = "id:";
+const RETRY_PREFIX = "retry:";
+const DEFAULT_MAX_RECONNECTION_ATTEMPTS = 5;
+const DEFAULT_RECONNECT_DELAY_MS = 1_000;
+const MAX_RECONNECT_DELAY_MS = 30_000;
+export class Stream {
+    stream;
+    parse;
+    /**
+     * The prefix to use for each message. For example,
+     * for SSE, the prefix is "data: ".
+     */
+    prefix;
+    messageTerminator;
+    streamTerminator;
+    eventDiscriminator;
+    resumable;
+    reconnectionEnabled;
+    maxReconnectionAttempts;
+    reconnect;
+    controller = new AbortController();
+    decoder;
+    externalSignal;
+    onExternalAbort;
+    constructor({ stream, parse, eventShape, signal, reconnectionEnabled, maxReconnectionAttempts, reconnect, }) {
+        this.stream = stream;
+        this.parse = parse;
+        if (eventShape.type === "sse") {
+            this.prefix = DATA_PREFIX;
+            this.messageTerminator = "\n";
+            this.streamTerminator = eventShape.streamTerminator;
+            this.eventDiscriminator = eventShape.eventDiscriminator;
+            this.resumable = eventShape.resumable ?? false;
+        }
+        else {
+            this.messageTerminator = eventShape.messageTerminator;
+            this.resumable = false;
+        }
+        this.reconnectionEnabled = reconnectionEnabled ?? true;
+        this.maxReconnectionAttempts = maxReconnectionAttempts ?? DEFAULT_MAX_RECONNECTION_ATTEMPTS;
+        this.reconnect = reconnect;
+        if (signal != null) {
+            this.externalSignal = signal;
+            this.onExternalAbort = () => this.controller.abort();
+            signal.addEventListener("abort", this.onExternalAbort, { once: true });
+        }
+        // Initialize shared TextDecoder
+        if (typeof TextDecoder !== "undefined") {
+            this.decoder = new TextDecoder("utf-8");
+        }
+    }
+    async *iterMessages() {
+        if (this.eventDiscriminator != null) {
+            yield* this.iterSseEvents();
+        }
+        else {
+            yield* this.iterDataMessages();
+        }
+    }
+    async *iterDataMessages() {
+        let reconnectAttempts = 0;
+        let currentStream = this.stream;
+        let lastId;
+        // The id of the most recently *dispatched* event. Per the WHATWG
+        // EventSource spec, the "last event ID" is only committed when an event
+        // is dispatched, not when the `id:` line is parsed. Reconnecting with a
+        // parsed-but-undispatched id would skip an event that was never yielded
+        // (e.g. if the connection drops after `id:` but before the event's
+        // terminating blank line), so reconnection uses lastDispatchedId.
+        let lastDispatchedId;
+        let lastRetry;
+        while (true) {
+            const stream = readableStreamAsyncIterable(currentStream);
+            let buf = "";
+            let dataValue;
+            for await (const chunk of stream) {
+                buf += this.decodeChunk(chunk);
+                let terminatorIndex;
+                while ((terminatorIndex = buf.indexOf(this.messageTerminator)) >= 0) {
+                    const line = buf.slice(0, terminatorIndex);
+                    buf = buf.slice(terminatorIndex + this.messageTerminator.length);
+                    if (!line.trim()) {
+                        if (this.prefix != null && dataValue != null) {
+                            if (this.streamTerminator != null && dataValue.includes(this.streamTerminator)) {
+                                return;
+                            }
+                            const data = await this.parse(fromJson(dataValue));
+                            yield { data, id: lastId, retry: lastRetry, event: undefined };
+                            lastDispatchedId = lastId;
+                            reconnectAttempts = 0;
+                            dataValue = undefined;
+                        }
+                        continue;
+                    }
+                    if (line.startsWith(ID_PREFIX)) {
+                        const idValue = line.slice(ID_PREFIX.length).trim();
+                        if (!idValue.includes("\0")) {
+                            lastId = idValue;
+                        }
+                        continue;
+                    }
+                    if (line.startsWith(RETRY_PREFIX)) {
+                        const retryValue = line.slice(RETRY_PREFIX.length).trim();
+                        const parsed = parseInt(retryValue, 10);
+                        if (!Number.isNaN(parsed) && String(parsed) === retryValue) {
+                            lastRetry = parsed;
+                        }
+                        continue;
+                    }
+                    if (this.prefix != null) {
+                        const prefixIndex = line.indexOf(this.prefix);
+                        if (prefixIndex === -1) {
+                            continue;
+                        }
+                        const val = line.slice(prefixIndex + this.prefix.length).trim();
+                        dataValue = dataValue != null ? `${dataValue}\n${val}` : val;
+                    }
+                    else {
+                        if (this.streamTerminator != null && line.includes(this.streamTerminator)) {
+                            return;
+                        }
+                        const data = await this.parse(fromJson(line));
+                        yield { data, id: lastId, retry: lastRetry, event: undefined };
+                        lastDispatchedId = lastId;
+                        reconnectAttempts = 0;
+                    }
+                }
+            }
+            if (this.prefix != null && dataValue != null) {
+                if (this.streamTerminator != null && dataValue.includes(this.streamTerminator)) {
+                    return;
+                }
+                const data = await this.parse(fromJson(dataValue));
+                yield { data, id: lastId, retry: lastRetry, event: undefined };
+                lastDispatchedId = lastId;
+                reconnectAttempts = 0;
+            }
+            if (!this.shouldReconnect(lastDispatchedId, reconnectAttempts)) {
+                return;
+            }
+            reconnectAttempts++;
+            await this.delayReconnect(lastRetry);
+            if (this.controller.signal.aborted) {
+                return;
+            }
+            // Re-check after async delay; needed for TypeScript narrowing.
+            const reconnectFn = this.reconnect;
+            if (reconnectFn == null || lastDispatchedId == null) {
+                return;
+            }
+            try {
+                const reconnected = await reconnectFn(lastDispatchedId);
+                if (reconnected == null) {
+                    currentStream = this.createEmptyStream();
+                    continue;
+                }
+                currentStream = reconnected;
+            }
+            catch {
+                // Failed reconnect (e.g. HTTP error); assign an empty stream
+                // so the next iteration is a safe no-op before shouldReconnect.
+                currentStream = this.createEmptyStream();
+            }
+        }
+    }
+    async *iterSseEvents() {
+        let reconnectAttempts = 0;
+        let currentStream = this.stream;
+        let lastId;
+        // See iterDataMessages: reconnection uses the last *dispatched* id (per
+        // the EventSource spec), not the last *parsed* id, to avoid skipping an
+        // event that was never yielded when a drop lands mid-event.
+        let lastDispatchedId;
+        let lastRetry;
+        while (true) {
+            const stream = readableStreamAsyncIterable(currentStream);
+            let buf = "";
+            let eventType;
+            let dataValue;
+            for await (const chunk of stream) {
+                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 data = await this.dispatchSseEvent(dataValue, eventType);
+                            if (data == null) {
+                                return;
+                            }
+                            yield { data, id: lastId, retry: lastRetry, event: eventType };
+                            lastDispatchedId = lastId;
+                            reconnectAttempts = 0;
+                        }
+                        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;
+                    }
+                    else if (line.startsWith(ID_PREFIX)) {
+                        const idValue = line.slice(ID_PREFIX.length).trim();
+                        if (!idValue.includes("\0")) {
+                            lastId = idValue;
+                        }
+                    }
+                    else if (line.startsWith(RETRY_PREFIX)) {
+                        const retryValue = line.slice(RETRY_PREFIX.length).trim();
+                        const parsed = parseInt(retryValue, 10);
+                        if (!Number.isNaN(parsed) && String(parsed) === retryValue) {
+                            lastRetry = parsed;
+                        }
+                    }
+                }
+            }
+            if (dataValue != null) {
+                const data = await this.dispatchSseEvent(dataValue, eventType);
+                if (data != null) {
+                    yield { data, id: lastId, retry: lastRetry, event: eventType };
+                    lastDispatchedId = lastId;
+                    reconnectAttempts = 0;
+                }
+            }
+            if (!this.shouldReconnect(lastDispatchedId, reconnectAttempts)) {
+                return;
+            }
+            reconnectAttempts++;
+            await this.delayReconnect(lastRetry);
+            if (this.controller.signal.aborted) {
+                return;
+            }
+            // Re-check after async delay; needed for TypeScript narrowing.
+            const reconnectFn = this.reconnect;
+            if (reconnectFn == null || lastDispatchedId == null) {
+                return;
+            }
+            try {
+                const reconnected = await reconnectFn(lastDispatchedId);
+                if (reconnected == null) {
+                    currentStream = this.createEmptyStream();
+                    continue;
+                }
+                currentStream = reconnected;
+            }
+            catch {
+                // Failed reconnect (e.g. HTTP error); assign an empty stream
+                // so the next iteration is a safe no-op before shouldReconnect.
+                currentStream = this.createEmptyStream();
+            }
+        }
+    }
+    /**
+     * Parses and returns a single SSE event, or returns null if the event is a stream terminator.
+     */
+    async dispatchSseEvent(dataValue, eventType) {
+        if (this.streamTerminator != null && dataValue.includes(this.streamTerminator)) {
+            return null;
+        }
+        return this.parse(this.injectDiscriminator(fromJson(dataValue), eventType));
+    }
+    /**
+     * Determines whether a reconnection attempt should be made.
+     */
+    shouldReconnect(lastId, reconnectAttempts) {
+        if (!this.resumable) {
+            return false;
+        }
+        if (this.streamTerminator == null) {
+            // Without a terminator the client cannot distinguish a completed
+            // stream from a dropped connection, so reconnection is disabled.
+            return false;
+        }
+        // NOTE: When a terminator IS configured but the server never sends it
+        // (e.g. it drops the connection after emitting events every time),
+        // maxReconnectionAttempts is a per-consecutive-failure cap — each
+        // yielded event resets the counter. This matches EventSource semantics
+        // but means such a server can cause unbounded reconnections. Callers
+        // concerned about this should impose a wall-clock budget externally.
+        if (!this.reconnectionEnabled) {
+            return false;
+        }
+        if (this.reconnect == null) {
+            return false;
+        }
+        if (lastId == null || lastId === "") {
+            return false;
+        }
+        if (reconnectAttempts >= this.maxReconnectionAttempts) {
+            return false;
+        }
+        if (this.controller.signal.aborted) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Delays before reconnecting, using a server-sent retry directive if provided
+     * (clamped to MAX_RECONNECT_DELAY_MS), otherwise falling back to
+     * DEFAULT_RECONNECT_DELAY_MS. The delay is abortable: if the stream's abort
+     * signal fires during the wait, the promise resolves immediately.
+     */
+    async delayReconnect(lastRetry) {
+        const base = lastRetry != null && lastRetry > 0 ? lastRetry : DEFAULT_RECONNECT_DELAY_MS;
+        const delay = Math.min(base, MAX_RECONNECT_DELAY_MS);
+        const signal = this.controller.signal;
+        if (signal.aborted) {
+            return;
+        }
+        await new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                signal.removeEventListener("abort", onAbort);
+                resolve();
+            }, delay);
+            const onAbort = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+        });
+    }
+    createEmptyStream() {
+        return new ReadableStream({
+            start(controller) {
+                controller.close();
+            },
+        });
+    }
+    removeAbortListener() {
+        if (this.externalSignal != null && this.onExternalAbort != null) {
+            this.externalSignal.removeEventListener("abort", this.onExternalAbort);
+            this.onExternalAbort = undefined;
+        }
+    }
+    withMetadata() {
+        const self = this;
+        return {
+            async *[Symbol.asyncIterator]() {
+                try {
+                    yield* self.iterMessages();
+                }
+                finally {
+                    self.removeAbortListener();
+                }
+            },
+        };
+    }
+    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 { [this.eventDiscriminator]: eventType, ...obj };
+    }
+    async *[Symbol.asyncIterator]() {
+        try {
+            for await (const event of this.iterMessages()) {
+                yield event.data;
+            }
+        }
+        finally {
+            this.removeAbortListener();
+        }
+    }
+    decodeChunk(chunk) {
+        let decoded = "";
+        // If TextDecoder is available, use the streaming decoder instance
+        if (this.decoder != null) {
+            decoded += this.decoder.decode(chunk, { stream: true });
+        }
+        // Buffer is present in Node.js environment
+        else if (RUNTIME.type === "node" && typeof chunk !== "undefined") {
+            decoded += Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        }
+        return decoded;
+    }
+}
+/**
+ * Browser polyfill for ReadableStream
+ */
+// biome-ignore lint/suspicious/noExplicitAny: allow explicit any
+export function readableStreamAsyncIterable(stream) {
+    if (stream[Symbol.asyncIterator]) {
+        return stream;
+    }
+    const reader = stream.getReader();
+    return {
+        async next() {
+            try {
+                const result = await reader.read();
+                if (result?.done) {
+                    reader.releaseLock();
+                } // release lock when stream becomes closed
+                return result;
+            }
+            catch (e) {
+                reader.releaseLock(); // release lock when stream becomes errored
+                throw e;
+            }
+        },
+        async return() {
+            const cancelPromise = reader.cancel();
+            reader.releaseLock();
+            await cancelPromise;
+            return { done: true, value: undefined };
+        },
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+    };
+}
+//# sourceMappingURL=Stream.js.map

package/dist/src/core/stream/Stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stream.js","sourceRoot":"","sources":["../../../../src/core/stream/Stream.ts"],"names":[],"mappings":"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"}

package/dist/src/core/stream/index.d.ts

@@ -0,0 +1,2 @@
+export type { ServerSentEvent } from "./Stream.js";
+export { Stream } from "./Stream.js";

package/dist/src/core/stream/index.js

@@ -0,0 +1,2 @@
+export { Stream } from "./Stream.js";
+//# sourceMappingURL=index.js.map

package/dist/src/core/stream/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/stream/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/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/dist/src/core/url/QueryStringBuilder.js

@@ -0,0 +1,79 @@
+import { toQueryString } from "./qs.js";
+/**
+ * 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 {
+    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?.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("&");
+    }
+}
+//# sourceMappingURL=QueryStringBuilder.js.map

package/dist/src/core/url/QueryStringBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryStringBuilder.js","sourceRoot":"","sources":["../../../../src/core/url/QueryStringBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY;IACxB,OAAO,IAAI,kBAAkB,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,kBAAkB;IACZ,KAAK,GAAwB,IAAI,GAAG,EAAE,CAAC;IAE/C;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAW,EAAE,KAAc,EAAE,OAA6B;QAC1D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,UAAU,GAAG,aAAa,CAC5B,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAChB,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CACnE,CAAC;QACF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,MAA+B;QACnC,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACjB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACzB,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,gBAA0C;QACtD,IAAI,gBAAgB,IAAI,IAAI,EAAE,CAAC;YAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAC1D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACxC,SAAS;gBACb,CAAC;gBACD,MAAM,UAAU,GAAG,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC9E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;gBACpC,CAAC;YACL,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,KAAK;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;CACJ"}

package/dist/src/core/url/encodePathParam.d.ts

@@ -0,0 +1 @@
+export declare function encodePathParam(param: unknown): string;

package/dist/src/core/url/encodePathParam.js

@@ -0,0 +1,19 @@
+export function encodePathParam(param) {
+    if (param === null) {
+        return "null";
+    }
+    const typeofParam = typeof param;
+    switch (typeofParam) {
+        case "undefined":
+            return "undefined";
+        case "string":
+        case "number":
+        case "boolean":
+            break;
+        default:
+            param = String(param);
+            break;
+    }
+    return encodeURIComponent(param);
+}
+//# sourceMappingURL=encodePathParam.js.map

package/dist/src/core/url/encodePathParam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encodePathParam.js","sourceRoot":"","sources":["../../../../src/core/url/encodePathParam.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,KAAK,CAAC;IACjC,QAAQ,WAAW,EAAE,CAAC;QAClB,KAAK,WAAW;YACZ,OAAO,WAAW,CAAC;QACvB,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACV,MAAM;QACV;YACI,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,MAAM;IACd,CAAC;IACD,OAAO,kBAAkB,CAAC,KAAkC,CAAC,CAAC;AAClE,CAAC"}

package/dist/src/core/url/index.d.ts

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

package/dist/src/core/url/index.js

@@ -0,0 +1,5 @@
+export { encodePathParam } from "./encodePathParam.js";
+export { join } from "./join.js";
+export { queryBuilder } from "./QueryStringBuilder.js";
+export { toQueryString } from "./qs.js";
+//# sourceMappingURL=index.js.map

package/dist/src/core/url/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/url/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/src/core/url/join.d.ts

@@ -0,0 +1 @@
+export declare function join(base: string, ...segments: string[]): string;