@predictorsdk/client 0.10.0 → 0.11.0

package/dist/Client.d.ts

@@ -9,7 +9,19 @@ export declare namespace PredictorSDKClient {
 }
 export declare class PredictorSDKClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<PredictorSDKClient.Options>;
-    constructor(options: PredictorSDKClient.Options);
+    constructor(options?: PredictorSDKClient.Options);
+    /**
+     * Returns the machine-readable public billing catalog used by API consumers and pricing surfaces. This endpoint is intentionally unauthenticated. Stripe price IDs and all other provisioning secrets are excluded from the response.
+     *
+     * @param {PredictorSDKClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link PredictorSDK.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.getPlans()
+     */
+    getPlans(requestOptions?: PredictorSDKClient.RequestOptions): core.HttpResponsePromise<PredictorSDK.PlansResponse>;
+    private __getPlans;
     /**
      * Find cross-platform market matches for sports events. When called without parameters, returns all currently matched sports markets with cursor-based pagination (default `limit=25`, max `100`). Provide a canonical event key, Kalshi event ticker, Polymarket slug, Predict market ID, or SX Bet market ID to look up a specific event — lookups return the full match immediately and skip pagination.
      *

package/dist/Client.js

@@ -9,9 +9,69 @@ import * as errors from "./errors/index.js";
 import * as serializers from "./serialization/index.js";
 export class PredictorSDKClient {
     _options;
-    constructor(options) {
+    constructor(options = {}) {
         this._options = normalizeClientOptionsWithAuth(options);
     }
+    /**
+     * Returns the machine-readable public billing catalog used by API consumers and pricing surfaces. This endpoint is intentionally unauthenticated. Stripe price IDs and all other provisioning secrets are excluded from the response.
+     *
+     * @param {PredictorSDKClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link PredictorSDK.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.getPlans()
+     */
+    getPlans(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getPlans(requestOptions));
+    }
+    async __getPlans(requestOptions) {
+        const _headers = mergeHeaders(this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.PredictorSDKEnvironment.Production, "v1/plans"),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: serializers.PlansResponse.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                    breadcrumbsPrefix: ["response"],
+                }),
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 503:
+                    throw new PredictorSDK.ServiceUnavailableError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }), _response.rawResponse);
+                default:
+                    throw new errors.PredictorSDKError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/plans");
+    }
     /**
      * Find cross-platform market matches for sports events. When called without parameters, returns all currently matched sports markets with cursor-based pagination (default `limit=25`, max `100`). Provide a canonical event key, Kalshi event ticker, Polymarket slug, Predict market ID, or SX Bet market ID to look up a specific event — lookups return the full match immediately and skip pagination.
      *

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

@@ -0,0 +1,22 @@
+/**
+ * Public plan metadata. Stripe price IDs and legacy provisioning IDs are intentionally absent.
+ */
+export interface Plan {
+    /** Stable public plan key. */
+    key: string;
+    name: string;
+    /** Runtime entitlement tier; empty for a manually provisioned contact-sales plan. */
+    billingTier: string;
+    trialDays: number;
+    tagline: string;
+    /** Monthly display price in US cents; zero for free or contact-sales plans. */
+    monthlyPriceCents: number;
+    includedRequestsPerMonth: number;
+    overageCentsPer1K: number;
+    rateLimitPerMin: number;
+    maxKeys: number;
+    features: string[];
+    ctaLabel: string;
+    highlighted: boolean;
+    contactSales: boolean;
+}

package/dist/api/types/Plan.js

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

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

@@ -0,0 +1,4 @@
+import type * as PredictorSDK from "../index.js";
+export interface PlansResponse {
+    data: PredictorSDK.Plan[];
+}

package/dist/api/types/PlansResponse.js

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

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

@@ -31,6 +31,8 @@ export * from "./MarketsListResponse.js";
 export * from "./PaginationBlock.js";
 export * from "./PaymentRequiredErrorAction.js";
 export * from "./PaymentRequiredErrorBody.js";
+export * from "./Plan.js";
+export * from "./PlansResponse.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";
 export * from "./PolymarketPosition.js";

package/dist/api/types/index.js

@@ -31,6 +31,8 @@ export * from "./MarketsListResponse.js";
 export * from "./PaginationBlock.js";
 export * from "./PaymentRequiredErrorAction.js";
 export * from "./PaymentRequiredErrorBody.js";
+export * from "./Plan.js";
+export * from "./PlansResponse.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";
 export * from "./PolymarketPosition.js";

package/dist/auth/BearerAuthProvider.d.ts

@@ -13,7 +13,7 @@ export declare namespace BearerAuthProvider {
     const AUTH_CONFIG_ERROR_MESSAGE: string;
     type Options = AuthOptions;
     type AuthOptions = {
-        [TOKEN_PARAM]: core.Supplier<core.BearerToken>;
+        [TOKEN_PARAM]?: core.Supplier<core.BearerToken>;
     };
     function createInstance(options: Options): core.AuthProvider;
 }

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

@@ -1 +1,2 @@
+export declare function getRetryDelayFromHeaders(response: Response, retryAttempt: number): number;
 export declare function requestWithRetries(requestFn: () => Promise<Response>, maxRetries?: number): Promise<Response>;

package/dist/core/fetcher/requestWithRetries.js

@@ -13,7 +13,7 @@ function addSymmetricJitter(delay) {
     const jitterMultiplier = 1 + (Math.random() - 0.5) * JITTER_FACTOR;
     return delay * jitterMultiplier;
 }
-function getRetryDelayFromHeaders(response, retryAttempt) {
+export function getRetryDelayFromHeaders(response, retryAttempt) {
     const retryAfter = response.headers.get("Retry-After");
     if (retryAfter) {
         const retryAfterSeconds = parseInt(retryAfter, 10);
@@ -32,7 +32,8 @@ function getRetryDelayFromHeaders(response, retryAttempt) {
     if (rateLimitReset) {
         const resetTime = parseInt(rateLimitReset, 10);
         if (!Number.isNaN(resetTime)) {
-            const delay = resetTime * 1000 - Date.now();
+            const resetTimeMilliseconds = resetTime >= 1_000_000_000_000 ? resetTime : resetTime * 1000;
+            const delay = resetTimeMilliseconds - Date.now();
             if (delay > 0) {
                 return addPositiveJitter(Math.min(delay, MAX_RETRY_DELAY));
             }

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

@@ -0,0 +1,22 @@
+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 Plan: core.serialization.ObjectSchema<serializers.Plan.Raw, PredictorSDK.Plan>;
+export declare namespace Plan {
+    interface Raw {
+        key: string;
+        name: string;
+        billing_tier: string;
+        trial_days: number;
+        tagline: string;
+        monthly_price_cents: number;
+        included_requests_per_month: number;
+        overage_cents_per_1k: number;
+        rate_limit_per_min: number;
+        max_keys: number;
+        features: string[];
+        cta_label: string;
+        highlighted: boolean;
+        contact_sales: boolean;
+    }
+}

package/dist/serialization/types/Plan.js

@@ -0,0 +1,18 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+export const Plan = core.serialization.object({
+    key: core.serialization.string(),
+    name: core.serialization.string(),
+    billingTier: core.serialization.property("billing_tier", core.serialization.string()),
+    trialDays: core.serialization.property("trial_days", core.serialization.number()),
+    tagline: core.serialization.string(),
+    monthlyPriceCents: core.serialization.property("monthly_price_cents", core.serialization.number()),
+    includedRequestsPerMonth: core.serialization.property("included_requests_per_month", core.serialization.number()),
+    overageCentsPer1K: core.serialization.property("overage_cents_per_1k", core.serialization.number()),
+    rateLimitPerMin: core.serialization.property("rate_limit_per_min", core.serialization.number()),
+    maxKeys: core.serialization.property("max_keys", core.serialization.number()),
+    features: core.serialization.list(core.serialization.string()),
+    ctaLabel: core.serialization.property("cta_label", core.serialization.string()),
+    highlighted: core.serialization.boolean(),
+    contactSales: core.serialization.property("contact_sales", core.serialization.boolean()),
+});

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

@@ -0,0 +1,10 @@
+import type * as PredictorSDK from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+import { Plan } from "./Plan.js";
+export declare const PlansResponse: core.serialization.ObjectSchema<serializers.PlansResponse.Raw, PredictorSDK.PlansResponse>;
+export declare namespace PlansResponse {
+    interface Raw {
+        data: Plan.Raw[];
+    }
+}

package/dist/serialization/types/PlansResponse.js

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+import { Plan } from "./Plan.js";
+export const PlansResponse = core.serialization.object({
+    data: core.serialization.list(Plan),
+});

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

@@ -31,6 +31,8 @@ export * from "./MarketsListResponse.js";
 export * from "./PaginationBlock.js";
 export * from "./PaymentRequiredErrorAction.js";
 export * from "./PaymentRequiredErrorBody.js";
+export * from "./Plan.js";
+export * from "./PlansResponse.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";
 export * from "./PolymarketPosition.js";

package/dist/serialization/types/index.js

@@ -31,6 +31,8 @@ export * from "./MarketsListResponse.js";
 export * from "./PaginationBlock.js";
 export * from "./PaymentRequiredErrorAction.js";
 export * from "./PaymentRequiredErrorBody.js";
+export * from "./Plan.js";
+export * from "./PlansResponse.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";
 export * from "./PolymarketPosition.js";

package/package.json

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