@predictorsdk/client 0.3.0 → 0.3.2

package/dist/BaseClient.d.ts

@@ -1,6 +1,7 @@
 import { BearerAuthProvider } from "./auth/BearerAuthProvider.js";
 import * as core from "./core/index.js";
 import type * as environments from "./environments.js";
+export type AuthOption = false | core.AuthProvider["getAuthRequest"] | core.AuthProvider | BearerAuthProvider.AuthOptions;
 export type BaseClientOptions = {
     environment?: core.Supplier<environments.PredictorSDKEnvironment | string>;
     /** Specify a custom URL to connect the client to. */
@@ -15,6 +16,8 @@ export type BaseClientOptions = {
     fetch?: typeof fetch;
     /** Configure logging for the client. */
     logging?: core.logging.LogConfig | core.logging.Logger;
+    /** Override auth. Pass false to disable, a function returning auth headers, an AuthProvider, or auth options. */
+    auth?: AuthOption;
 } & BearerAuthProvider.AuthOptions;
 export interface BaseRequestOptions {
     /** The maximum time to wait for a response in seconds. */

package/dist/BaseClient.js

@@ -16,6 +16,21 @@ export function normalizeClientOptions(options) {
 }
 export function normalizeClientOptionsWithAuth(options) {
     const normalized = normalizeClientOptions(options);
+    if (options.auth === false) {
+        normalized.authProvider = new core.NoOpAuthProvider();
+        return normalized;
+    }
+    if (options.auth != null) {
+        if (typeof options.auth === "function") {
+            normalized.authProvider = { getAuthRequest: options.auth };
+            return normalized;
+        }
+        if (core.isAuthProvider(options.auth)) {
+            normalized.authProvider = options.auth;
+            return normalized;
+        }
+        Object.assign(normalized, options.auth);
+    }
     const normalizedWithNoOpAuthProvider = withNoOpAuthProvider(normalized);
     normalized.authProvider ??= new BearerAuthProvider(normalizedWithNoOpAuthProvider);
     return normalized;

package/dist/Client.d.ts

@@ -18,6 +18,7 @@ export declare class PredictorSDKClient {
      *
      * @throws {@link PredictorSDK.BadRequestError}
      * @throws {@link PredictorSDK.UnauthorizedError}
+     * @throws {@link PredictorSDK.PaymentRequiredError}
      * @throws {@link PredictorSDK.ForbiddenError}
      * @throws {@link PredictorSDK.TooManyRequestsError}
      * @throws {@link PredictorSDK.ServiceUnavailableError}
@@ -35,9 +36,9 @@ export declare class PredictorSDKClient {
      *
      * @throws {@link PredictorSDK.BadRequestError}
      * @throws {@link PredictorSDK.UnauthorizedError}
+     * @throws {@link PredictorSDK.PaymentRequiredError}
      * @throws {@link PredictorSDK.ForbiddenError}
      * @throws {@link PredictorSDK.TooManyRequestsError}
-     * @throws {@link PredictorSDK.InternalServerError}
      * @throws {@link PredictorSDK.ServiceUnavailableError}
      *
      * @example
@@ -53,6 +54,7 @@ export declare class PredictorSDKClient {
      *
      * @throws {@link PredictorSDK.BadRequestError}
      * @throws {@link PredictorSDK.UnauthorizedError}
+     * @throws {@link PredictorSDK.PaymentRequiredError}
      * @throws {@link PredictorSDK.ForbiddenError}
      * @throws {@link PredictorSDK.TooManyRequestsError}
      * @throws {@link PredictorSDK.BadGatewayError}

package/dist/Client.js

@@ -20,6 +20,7 @@ export class PredictorSDKClient {
      *
      * @throws {@link PredictorSDK.BadRequestError}
      * @throws {@link PredictorSDK.UnauthorizedError}
+     * @throws {@link PredictorSDK.PaymentRequiredError}
      * @throws {@link PredictorSDK.ForbiddenError}
      * @throws {@link PredictorSDK.TooManyRequestsError}
      * @throws {@link PredictorSDK.ServiceUnavailableError}
@@ -49,7 +50,11 @@ export class PredictorSDKClient {
                 environments.PredictorSDKEnvironment.Production, "v1/matching-markets/sports"),
             method: "GET",
             headers: _headers,
-            queryParameters: { ..._queryParams, ...requestOptions?.queryParams },
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
             timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
             maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
             abortSignal: requestOptions?.abortSignal,
@@ -86,6 +91,14 @@ export class PredictorSDKClient {
                         skipValidation: true,
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
+                case 402:
+                    throw new PredictorSDK.PaymentRequiredError(serializers.PaymentRequiredErrorBody.parseOrThrow(_response.error.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }), _response.rawResponse);
                 case 403:
                     throw new PredictorSDK.ForbiddenError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",
@@ -128,9 +141,9 @@ export class PredictorSDKClient {
      *
      * @throws {@link PredictorSDK.BadRequestError}
      * @throws {@link PredictorSDK.UnauthorizedError}
+     * @throws {@link PredictorSDK.PaymentRequiredError}
      * @throws {@link PredictorSDK.ForbiddenError}
      * @throws {@link PredictorSDK.TooManyRequestsError}
-     * @throws {@link PredictorSDK.InternalServerError}
      * @throws {@link PredictorSDK.ServiceUnavailableError}
      *
      * @example
@@ -153,7 +166,11 @@ export class PredictorSDKClient {
                 environments.PredictorSDKEnvironment.Production, "v1/markets"),
             method: "GET",
             headers: _headers,
-            queryParameters: { ..._queryParams, ...requestOptions?.queryParams },
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
             timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
             maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
             abortSignal: requestOptions?.abortSignal,
@@ -190,24 +207,24 @@ export class PredictorSDKClient {
                         skipValidation: true,
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
-                case 403:
-                    throw new PredictorSDK.ForbiddenError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                case 402:
+                    throw new PredictorSDK.PaymentRequiredError(serializers.PaymentRequiredErrorBody.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
                         skipValidation: true,
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
-                case 429:
-                    throw new PredictorSDK.TooManyRequestsError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                case 403:
+                    throw new PredictorSDK.ForbiddenError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
                         skipValidation: true,
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
-                case 500:
-                    throw new PredictorSDK.InternalServerError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                case 429:
+                    throw new PredictorSDK.TooManyRequestsError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -240,6 +257,7 @@ export class PredictorSDKClient {
      *
      * @throws {@link PredictorSDK.BadRequestError}
      * @throws {@link PredictorSDK.UnauthorizedError}
+     * @throws {@link PredictorSDK.PaymentRequiredError}
      * @throws {@link PredictorSDK.ForbiddenError}
      * @throws {@link PredictorSDK.TooManyRequestsError}
      * @throws {@link PredictorSDK.BadGatewayError}
@@ -270,7 +288,11 @@ export class PredictorSDKClient {
                 environments.PredictorSDKEnvironment.Production, "v1/crypto-prices/binance"),
             method: "GET",
             headers: _headers,
-            queryParameters: { ..._queryParams, ...requestOptions?.queryParams },
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
             timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
             maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
             abortSignal: requestOptions?.abortSignal,
@@ -307,6 +329,14 @@ export class PredictorSDKClient {
                         skipValidation: true,
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
+                case 402:
+                    throw new PredictorSDK.PaymentRequiredError(serializers.PaymentRequiredErrorBody.parseOrThrow(_response.error.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }), _response.rawResponse);
                 case 403:
                     throw new PredictorSDK.ForbiddenError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",

package/dist/api/errors/BadGatewayError.d.ts

@@ -2,5 +2,6 @@ import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
 import type * as PredictorSDK from "../index.js";
 export declare class BadGatewayError extends errors.PredictorSDKError {
+    readonly body: PredictorSDK.ErrorResponse;
     constructor(body: PredictorSDK.ErrorResponse, rawResponse?: core.RawResponse);
 }

package/dist/api/errors/BadRequestError.d.ts

@@ -2,5 +2,6 @@ import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
 import type * as PredictorSDK from "../index.js";
 export declare class BadRequestError extends errors.PredictorSDKError {
+    readonly body: PredictorSDK.ErrorResponse;
     constructor(body: PredictorSDK.ErrorResponse, rawResponse?: core.RawResponse);
 }

package/dist/api/errors/ForbiddenError.d.ts

@@ -2,5 +2,6 @@ import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
 import type * as PredictorSDK from "../index.js";
 export declare class ForbiddenError extends errors.PredictorSDKError {
+    readonly body: PredictorSDK.ErrorResponse;
     constructor(body: PredictorSDK.ErrorResponse, rawResponse?: core.RawResponse);
 }

package/dist/api/errors/PaymentRequiredError.d.ts

@@ -0,0 +1,7 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as PredictorSDK from "../index.js";
+export declare class PaymentRequiredError extends errors.PredictorSDKError {
+    readonly body: PredictorSDK.PaymentRequiredErrorBody;
+    constructor(body: PredictorSDK.PaymentRequiredErrorBody, rawResponse?: core.RawResponse);
+}

package/dist/api/errors/{InternalServerError.js → PaymentRequiredError.js}

@@ -1,10 +1,10 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as errors from "../../errors/index.js";
-export class InternalServerError extends errors.PredictorSDKError {
+export class PaymentRequiredError extends errors.PredictorSDKError {
     constructor(body, rawResponse) {
         super({
-            message: "InternalServerError",
-            statusCode: 500,
+            message: "PaymentRequiredError",
+            statusCode: 402,
             body: body,
             rawResponse: rawResponse,
         });

package/dist/api/errors/ServiceUnavailableError.d.ts

@@ -2,5 +2,6 @@ import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
 import type * as PredictorSDK from "../index.js";
 export declare class ServiceUnavailableError extends errors.PredictorSDKError {
+    readonly body: PredictorSDK.ErrorResponse;
     constructor(body: PredictorSDK.ErrorResponse, rawResponse?: core.RawResponse);
 }

package/dist/api/errors/TooManyRequestsError.d.ts

@@ -2,5 +2,6 @@ import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
 import type * as PredictorSDK from "../index.js";
 export declare class TooManyRequestsError extends errors.PredictorSDKError {
+    readonly body: PredictorSDK.ErrorResponse;
     constructor(body: PredictorSDK.ErrorResponse, rawResponse?: core.RawResponse);
 }

package/dist/api/errors/UnauthorizedError.d.ts

@@ -2,5 +2,6 @@ import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
 import type * as PredictorSDK from "../index.js";
 export declare class UnauthorizedError extends errors.PredictorSDKError {
+    readonly body: PredictorSDK.ErrorResponse;
     constructor(body: PredictorSDK.ErrorResponse, rawResponse?: core.RawResponse);
 }

package/dist/api/errors/index.d.ts

@@ -1,7 +1,7 @@
 export * from "./BadGatewayError.js";
 export * from "./BadRequestError.js";
 export * from "./ForbiddenError.js";
-export * from "./InternalServerError.js";
+export * from "./PaymentRequiredError.js";
 export * from "./ServiceUnavailableError.js";
 export * from "./TooManyRequestsError.js";
 export * from "./UnauthorizedError.js";

package/dist/api/errors/index.js

@@ -1,7 +1,7 @@
 export * from "./BadGatewayError.js";
 export * from "./BadRequestError.js";
 export * from "./ForbiddenError.js";
-export * from "./InternalServerError.js";
+export * from "./PaymentRequiredError.js";
 export * from "./ServiceUnavailableError.js";
 export * from "./TooManyRequestsError.js";
 export * from "./UnauthorizedError.js";

package/dist/api/types/PaymentRequiredErrorAction.d.ts

@@ -0,0 +1,6 @@
+/** Recommended client action for this 402. */
+export declare const PaymentRequiredErrorAction: {
+    readonly UpgradePlan: "upgrade_plan";
+    readonly ResolvePayment: "resolve_payment";
+};
+export type PaymentRequiredErrorAction = (typeof PaymentRequiredErrorAction)[keyof typeof PaymentRequiredErrorAction];

package/dist/api/types/PaymentRequiredErrorAction.js

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Recommended client action for this 402. */
+export const PaymentRequiredErrorAction = {
+    UpgradePlan: "upgrade_plan",
+    ResolvePayment: "resolve_payment",
+};

package/dist/api/types/PaymentRequiredErrorBody.d.ts

@@ -0,0 +1,20 @@
+import type * as PredictorSDK from "../index.js";
+/**
+ * Error body returned with HTTP 402. The `action` discriminator lets clients route to the correct recovery flow: `upgrade_plan` means the caller is on a lower tier than the endpoint requires, or the Free monthly allowance is exhausted; `resolve_payment` means the caller had a paid subscription that entered a payment-recovery state (past_due/unpaid/paused/incomplete) and the backend has already downgraded them to Free — the fix is in the billing portal, not a new purchase. `required_tier` / `current_tier` are always populated; `included_requests_per_month` and `current_period_requests` are only set when a Free caller hits the monthly allowance.
+ */
+export interface PaymentRequiredErrorBody {
+    error: string;
+    /** Additional detail about the error. */
+    message?: string;
+    statusCode: number;
+    /** Recommended client action for this 402. */
+    action: PredictorSDK.PaymentRequiredErrorAction;
+    /** Billing tier that would satisfy the gate (e.g. `starter`, `pro`, `business`, `enterprise`). */
+    requiredTier: string;
+    /** Billing tier currently associated with the caller. */
+    currentTier: string;
+    /** Monthly Free-tier allowance. Present only when the 402 is caused by the Free cap. */
+    includedRequestsPerMonth?: number;
+    /** Requests the Free caller has made in the current calendar month. Present only when the 402 is caused by the Free cap. */
+    currentPeriodRequests?: number;
+}

package/dist/api/types/PaymentRequiredErrorBody.js

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

package/dist/api/types/index.d.ts

@@ -3,6 +3,8 @@ export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
 export * from "./MarketsListResponse.js";
 export * from "./PaginationBlock.js";
+export * from "./PaymentRequiredErrorAction.js";
+export * from "./PaymentRequiredErrorBody.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";
 export * from "./SportsMatchingResponse.js";

package/dist/api/types/index.js

@@ -3,6 +3,8 @@ export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
 export * from "./MarketsListResponse.js";
 export * from "./PaginationBlock.js";
+export * from "./PaymentRequiredErrorAction.js";
+export * from "./PaymentRequiredErrorBody.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";
 export * from "./SportsMatchingResponse.js";

package/dist/core/auth/AuthProvider.d.ts

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

package/dist/core/auth/AuthProvider.js

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

package/dist/core/auth/index.d.ts

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

package/dist/core/auth/index.js

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

package/dist/core/fetcher/Fetcher.d.ts

@@ -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/core/fetcher/Fetcher.js

@@ -62,16 +62,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;
 }
@@ -168,7 +163,13 @@ async function getHeaders(args) {
     return newHeaders;
 }
 export async function fetcherImpl(args) {
-    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 = await getRequestBody({
         body: args.body,
         type: args.requestType ?? "other",

package/dist/core/fetcher/requestWithRetries.js

@@ -2,6 +2,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;
@@ -40,7 +43,7 @@ function getRetryDelayFromHeaders(response, retryAttempt) {
 export async function requestWithRetries(requestFn, maxRetries = DEFAULT_MAX_RETRIES) {
     let response = await 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);
             await new Promise((resolve) => setTimeout(resolve, delay));
             response = await requestFn();

package/dist/core/schemas/builders/enum/enum.d.ts

@@ -1,2 +1,3 @@
 import { type Schema } from "../../Schema.js";
 export declare function enum_<U extends string, E extends U[]>(values: E): Schema<E[number], E[number]>;
+export declare function forwardCompatibleEnum_<U extends string, E extends U[]>(values: E): Schema<E[number], string>;

package/dist/core/schemas/builders/enum/enum.js

@@ -33,3 +33,9 @@ export function enum_(values) {
     });
     return schemaCreator();
 }
+export function forwardCompatibleEnum_(values) {
+    return enum_(values).transform({
+        transform: (val) => val,
+        untransform: (val) => val,
+    });
+}

package/dist/core/schemas/builders/enum/index.d.ts

@@ -1 +1 @@
-export { enum_ } from "./enum.js";
+export { enum_, forwardCompatibleEnum_ } from "./enum.js";

package/dist/core/schemas/builders/enum/index.js

@@ -1 +1 @@
-export { enum_ } from "./enum.js";
+export { enum_, forwardCompatibleEnum_ } from "./enum.js";

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

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

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

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

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

@@ -0,0 +1,78 @@
+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("&");
+    }
+}

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

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

package/dist/core/url/index.js

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

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

@@ -23,19 +23,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)}`);
+                    }
                 }
             }
         }

package/dist/serialization/types/PaymentRequiredErrorAction.d.ts

@@ -0,0 +1,7 @@
+import type * as PredictorSDK from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+export declare const PaymentRequiredErrorAction: core.serialization.Schema<serializers.PaymentRequiredErrorAction.Raw, PredictorSDK.PaymentRequiredErrorAction>;
+export declare namespace PaymentRequiredErrorAction {
+    type Raw = "upgrade_plan" | "resolve_payment";
+}

package/dist/serialization/types/PaymentRequiredErrorAction.js

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+export const PaymentRequiredErrorAction = core.serialization.enum_(["upgrade_plan", "resolve_payment"]);

package/dist/serialization/types/PaymentRequiredErrorBody.d.ts

@@ -0,0 +1,17 @@
+import type * as PredictorSDK from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+import { PaymentRequiredErrorAction } from "./PaymentRequiredErrorAction.js";
+export declare const PaymentRequiredErrorBody: core.serialization.ObjectSchema<serializers.PaymentRequiredErrorBody.Raw, PredictorSDK.PaymentRequiredErrorBody>;
+export declare namespace PaymentRequiredErrorBody {
+    interface Raw {
+        error: string;
+        message?: string | null;
+        status_code: number;
+        action: PaymentRequiredErrorAction.Raw;
+        required_tier: string;
+        current_tier: string;
+        included_requests_per_month?: number | null;
+        current_period_requests?: number | null;
+    }
+}

package/dist/serialization/types/PaymentRequiredErrorBody.js

@@ -0,0 +1,13 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+import { PaymentRequiredErrorAction } from "./PaymentRequiredErrorAction.js";
+export const PaymentRequiredErrorBody = core.serialization.object({
+    error: core.serialization.string(),
+    message: core.serialization.string().optional(),
+    statusCode: core.serialization.property("status_code", core.serialization.number()),
+    action: PaymentRequiredErrorAction,
+    requiredTier: core.serialization.property("required_tier", core.serialization.string()),
+    currentTier: core.serialization.property("current_tier", core.serialization.string()),
+    includedRequestsPerMonth: core.serialization.property("included_requests_per_month", core.serialization.number().optional()),
+    currentPeriodRequests: core.serialization.property("current_period_requests", core.serialization.number().optional()),
+});

package/dist/serialization/types/index.d.ts

@@ -3,6 +3,8 @@ export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
 export * from "./MarketsListResponse.js";
 export * from "./PaginationBlock.js";
+export * from "./PaymentRequiredErrorAction.js";
+export * from "./PaymentRequiredErrorBody.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";
 export * from "./SportsMatchingResponse.js";

package/dist/serialization/types/index.js

@@ -3,6 +3,8 @@ export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
 export * from "./MarketsListResponse.js";
 export * from "./PaginationBlock.js";
+export * from "./PaymentRequiredErrorAction.js";
+export * from "./PaymentRequiredErrorBody.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";
 export * from "./SportsMatchingResponse.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@predictorsdk/client",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "The official TypeScript/JavaScript client for the PredictorSDK matching markets API",
   "license": "MIT",
   "keywords": [

package/dist/api/errors/InternalServerError.d.ts

@@ -1,6 +0,0 @@
-import type * as core from "../../core/index.js";
-import * as errors from "../../errors/index.js";
-import type * as PredictorSDK from "../index.js";
-export declare class InternalServerError extends errors.PredictorSDKError {
-    constructor(body: PredictorSDK.ErrorResponse, rawResponse?: core.RawResponse);
-}