@predictorsdk/client 0.1.1 → 0.2.0

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

@@ -0,0 +1,127 @@
+import { SchemaType } from "../../Schema.js";
+import { getErrorMessageForIncorrectType } from "../../utils/getErrorMessageForIncorrectType.js";
+import { isPlainObject } from "../../utils/isPlainObject.js";
+import { keys } from "../../utils/keys.js";
+import { maybeSkipValidation } from "../../utils/maybeSkipValidation.js";
+import { enum_ } from "../enum/index.js";
+import { getObjectLikeUtils } from "../object-like/index.js";
+import { getSchemaUtils } from "../schema-utils/index.js";
+// eslint-disable-next-line @typescript-eslint/unbound-method
+const _hasOwn = Object.prototype.hasOwnProperty;
+export function union(discriminant, union) {
+    const rawDiscriminant = typeof discriminant === "string" ? discriminant : discriminant.rawDiscriminant;
+    const parsedDiscriminant = typeof discriminant === "string"
+        ? discriminant
+        : discriminant.parsedDiscriminant;
+    const discriminantValueSchema = enum_(keys(union));
+    const baseSchema = {
+        parse: (raw, opts) => {
+            return transformAndValidateUnion({
+                value: raw,
+                discriminant: rawDiscriminant,
+                transformedDiscriminant: parsedDiscriminant,
+                transformDiscriminantValue: (discriminantValue) => discriminantValueSchema.parse(discriminantValue, {
+                    allowUnrecognizedEnumValues: opts?.allowUnrecognizedUnionMembers,
+                    breadcrumbsPrefix: [...(opts?.breadcrumbsPrefix ?? []), rawDiscriminant],
+                }),
+                getAdditionalPropertiesSchema: (discriminantValue) => union[discriminantValue],
+                allowUnrecognizedUnionMembers: opts?.allowUnrecognizedUnionMembers,
+                transformAdditionalProperties: (additionalProperties, additionalPropertiesSchema) => additionalPropertiesSchema.parse(additionalProperties, opts),
+                breadcrumbsPrefix: opts?.breadcrumbsPrefix,
+            });
+        },
+        json: (parsed, opts) => {
+            return transformAndValidateUnion({
+                value: parsed,
+                discriminant: parsedDiscriminant,
+                transformedDiscriminant: rawDiscriminant,
+                transformDiscriminantValue: (discriminantValue) => discriminantValueSchema.json(discriminantValue, {
+                    allowUnrecognizedEnumValues: opts?.allowUnrecognizedUnionMembers,
+                    breadcrumbsPrefix: [...(opts?.breadcrumbsPrefix ?? []), parsedDiscriminant],
+                }),
+                getAdditionalPropertiesSchema: (discriminantValue) => union[discriminantValue],
+                allowUnrecognizedUnionMembers: opts?.allowUnrecognizedUnionMembers,
+                transformAdditionalProperties: (additionalProperties, additionalPropertiesSchema) => additionalPropertiesSchema.json(additionalProperties, opts),
+                breadcrumbsPrefix: opts?.breadcrumbsPrefix,
+            });
+        },
+        getType: () => SchemaType.UNION,
+    };
+    return {
+        ...maybeSkipValidation(baseSchema),
+        ...getSchemaUtils(baseSchema),
+        ...getObjectLikeUtils(baseSchema),
+    };
+}
+function transformAndValidateUnion({ value, discriminant, transformedDiscriminant, transformDiscriminantValue, getAdditionalPropertiesSchema, allowUnrecognizedUnionMembers = false, transformAdditionalProperties, breadcrumbsPrefix = [], }) {
+    if (!isPlainObject(value)) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    path: breadcrumbsPrefix,
+                    message: getErrorMessageForIncorrectType(value, "object"),
+                },
+            ],
+        };
+    }
+    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,
+            errors: [
+                {
+                    path: breadcrumbsPrefix,
+                    message: `Missing discriminant ("${discriminant}")`,
+                },
+            ],
+        };
+    }
+    const transformedDiscriminantValue = transformDiscriminantValue(discriminantValue);
+    if (!transformedDiscriminantValue.ok) {
+        return {
+            ok: false,
+            errors: transformedDiscriminantValue.errors,
+        };
+    }
+    const additionalPropertiesSchema = getAdditionalPropertiesSchema(transformedDiscriminantValue.value);
+    if (additionalPropertiesSchema == null) {
+        if (allowUnrecognizedUnionMembers) {
+            return {
+                ok: true,
+                value: {
+                    [transformedDiscriminant]: transformedDiscriminantValue.value,
+                    ...additionalProperties,
+                },
+            };
+        }
+        else {
+            return {
+                ok: false,
+                errors: [
+                    {
+                        path: [...breadcrumbsPrefix, discriminant],
+                        message: "Unexpected discriminant value",
+                    },
+                ],
+            };
+        }
+    }
+    const transformedAdditionalProperties = transformAdditionalProperties(additionalProperties, additionalPropertiesSchema);
+    if (!transformedAdditionalProperties.ok) {
+        return transformedAdditionalProperties;
+    }
+    return {
+        ok: true,
+        value: {
+            [transformedDiscriminant]: discriminantValue,
+            ...transformedAdditionalProperties.value,
+        },
+    };
+}

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

@@ -0,0 +1,2 @@
+export * from "./builders/index.js";
+export type { inferParsed, inferRaw, Schema, SchemaOptions } from "./Schema.js";

package/dist/core/schemas/index.js

@@ -0,0 +1 @@
+export * from "./builders/index.js";

package/dist/core/schemas/utils/MaybePromise.d.ts

@@ -0,0 +1 @@
+export type MaybePromise<T> = T | Promise<T>;

package/dist/core/schemas/utils/MaybePromise.js

@@ -0,0 +1 @@
+export {};

package/dist/core/schemas/utils/addQuestionMarksToNullableProperties.d.ts

@@ -0,0 +1,7 @@
+export type addQuestionMarksToNullableProperties<T> = {
+    [K in OptionalKeys<T>]?: T[K];
+} & Pick<T, RequiredKeys<T>>;
+export type OptionalKeys<T> = {
+    [K in keyof T]-?: undefined extends T[K] ? K : never;
+}[keyof T];
+export type RequiredKeys<T> = Exclude<keyof T, OptionalKeys<T>>;

package/dist/core/schemas/utils/addQuestionMarksToNullableProperties.js

@@ -0,0 +1 @@
+export {};

package/dist/core/schemas/utils/createIdentitySchemaCreator.d.ts

@@ -0,0 +1,2 @@
+import type { MaybeValid, Schema, SchemaOptions, SchemaType } from "../Schema.js";
+export declare function createIdentitySchemaCreator<T>(schemaType: SchemaType, validate: (value: unknown, opts?: SchemaOptions) => MaybeValid<T>): () => Schema<T, T>;

package/dist/core/schemas/utils/createIdentitySchemaCreator.js

@@ -0,0 +1,15 @@
+import { getSchemaUtils } from "../builders/schema-utils/index.js";
+import { maybeSkipValidation } from "./maybeSkipValidation.js";
+export function createIdentitySchemaCreator(schemaType, validate) {
+    return () => {
+        const baseSchema = {
+            parse: validate,
+            json: validate,
+            getType: () => schemaType,
+        };
+        return {
+            ...maybeSkipValidation(baseSchema),
+            ...getSchemaUtils(baseSchema),
+        };
+    };
+}

package/dist/core/schemas/utils/entries.d.ts

@@ -0,0 +1 @@
+export declare function entries<T extends object>(object: T): [keyof T, T[keyof T]][];

package/dist/core/schemas/utils/entries.js

@@ -0,0 +1,3 @@
+export function entries(object) {
+    return Object.entries(object);
+}

package/dist/core/schemas/utils/filterObject.d.ts

@@ -0,0 +1 @@
+export declare function filterObject<T extends object, K extends keyof T>(obj: T, keysToInclude: K[]): Pick<T, K>;

package/dist/core/schemas/utils/filterObject.js

@@ -0,0 +1,10 @@
+export function filterObject(obj, keysToInclude) {
+    const keysToIncludeSet = new Set(keysToInclude);
+    return Object.entries(obj).reduce((acc, [key, value]) => {
+        if (keysToIncludeSet.has(key)) {
+            acc[key] = value;
+        }
+        return acc;
+        // eslint-disable-next-line @typescript-eslint/prefer-reduce-type-parameter
+    }, {});
+}

package/dist/core/schemas/utils/getErrorMessageForIncorrectType.d.ts

@@ -0,0 +1 @@
+export declare function getErrorMessageForIncorrectType(value: unknown, expectedType: string): string;

package/dist/core/schemas/utils/getErrorMessageForIncorrectType.js

@@ -0,0 +1,24 @@
+export function getErrorMessageForIncorrectType(value, expectedType) {
+    return `Expected ${expectedType}. Received ${getTypeAsString(value)}.`;
+}
+function getTypeAsString(value) {
+    if (Array.isArray(value)) {
+        return "list";
+    }
+    if (value === null) {
+        return "null";
+    }
+    if (value instanceof BigInt) {
+        return "BigInt";
+    }
+    switch (typeof value) {
+        case "string":
+            return `"${value}"`;
+        case "bigint":
+        case "number":
+        case "boolean":
+        case "undefined":
+            return `${value}`;
+    }
+    return typeof value;
+}

package/dist/core/schemas/utils/isPlainObject.d.ts

@@ -0,0 +1 @@
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;

package/dist/core/schemas/utils/isPlainObject.js

@@ -0,0 +1,12 @@
+// borrowed from https://github.com/lodash/lodash/blob/master/isPlainObject.js
+export function isPlainObject(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const proto = Object.getPrototypeOf(value);
+    if (proto === null) {
+        return true;
+    }
+    // Check that the prototype chain has exactly one level (i.e., proto is Object.prototype)
+    return Object.getPrototypeOf(proto) === null;
+}

package/dist/core/schemas/utils/keys.d.ts

@@ -0,0 +1 @@
+export declare function keys<T extends object>(object: T): (keyof T)[];

package/dist/core/schemas/utils/keys.js

@@ -0,0 +1,3 @@
+export function keys(object) {
+    return Object.keys(object);
+}

package/dist/core/schemas/utils/maybeSkipValidation.d.ts

@@ -0,0 +1,2 @@
+import type { BaseSchema } from "../Schema.js";
+export declare function maybeSkipValidation<S extends BaseSchema<Raw, Parsed>, Raw, Parsed>(schema: S): S;

package/dist/core/schemas/utils/maybeSkipValidation.js

@@ -0,0 +1,28 @@
+export function maybeSkipValidation(schema) {
+    return {
+        ...schema,
+        json: transformAndMaybeSkipValidation(schema.json),
+        parse: transformAndMaybeSkipValidation(schema.parse),
+    };
+}
+function transformAndMaybeSkipValidation(transform) {
+    return (value, opts) => {
+        const transformed = transform(value, opts);
+        const { skipValidation = false } = opts ?? {};
+        if (!transformed.ok && skipValidation) {
+            // biome-ignore lint/suspicious/noConsole: allow console
+            console.warn([
+                "Failed to validate.",
+                ...transformed.errors.map((error) => "  - " +
+                    (error.path.length > 0 ? `${error.path.join(".")}: ${error.message}` : error.message)),
+            ].join("\n"));
+            return {
+                ok: true,
+                value: value,
+            };
+        }
+        else {
+            return transformed;
+        }
+    };
+}

package/dist/core/schemas/utils/partition.d.ts

@@ -0,0 +1 @@
+export declare function partition<T>(items: readonly T[], predicate: (item: T) => boolean): [T[], T[]];

package/dist/core/schemas/utils/partition.js

@@ -0,0 +1,12 @@
+export function partition(items, predicate) {
+    const trueItems = [], falseItems = [];
+    for (const item of items) {
+        if (predicate(item)) {
+            trueItems.push(item);
+        }
+        else {
+            falseItems.push(item);
+        }
+    }
+    return [trueItems, falseItems];
+}

package/dist/index.d.ts

@@ -4,3 +4,4 @@ export { PredictorSDKClient } from "./Client.js";
 export { PredictorSDKEnvironment } from "./environments.js";
 export { PredictorSDKError, PredictorSDKTimeoutError } from "./errors/index.js";
 export * from "./exports.js";
+export * as serialization from "./serialization/index.js";

package/dist/index.js

@@ -3,3 +3,4 @@ export { PredictorSDKClient } from "./Client.js";
 export { PredictorSDKEnvironment } from "./environments.js";
 export { PredictorSDKError, PredictorSDKTimeoutError } from "./errors/index.js";
 export * from "./exports.js";
+export * as serialization from "./serialization/index.js";

package/dist/serialization/index.d.ts

@@ -0,0 +1 @@
+export * from "./types/index.js";

package/dist/serialization/index.js

@@ -0,0 +1 @@
+export * from "./types/index.js";

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

@@ -0,0 +1,11 @@
+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 CryptoPriceItem: core.serialization.ObjectSchema<serializers.CryptoPriceItem.Raw, PredictorSDK.CryptoPriceItem>;
+export declare namespace CryptoPriceItem {
+    interface Raw {
+        symbol: string;
+        value: number;
+        timestamp: number;
+    }
+}

package/dist/serialization/types/CryptoPriceItem.js

@@ -0,0 +1,7 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+export const CryptoPriceItem = core.serialization.object({
+    symbol: core.serialization.string(),
+    value: core.serialization.number(),
+    timestamp: core.serialization.number(),
+});

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

@@ -0,0 +1,12 @@
+import type * as PredictorSDK from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+import { CryptoPriceItem } from "./CryptoPriceItem.js";
+export declare const CryptoPricesResponse: core.serialization.ObjectSchema<serializers.CryptoPricesResponse.Raw, PredictorSDK.CryptoPricesResponse>;
+export declare namespace CryptoPricesResponse {
+    interface Raw {
+        prices: CryptoPriceItem.Raw[];
+        pagination_key?: string | null;
+        total?: number | null;
+    }
+}

package/dist/serialization/types/CryptoPricesResponse.js

@@ -0,0 +1,8 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+import { CryptoPriceItem } from "./CryptoPriceItem.js";
+export const CryptoPricesResponse = core.serialization.object({
+    prices: core.serialization.list(CryptoPriceItem),
+    paginationKey: core.serialization.property("pagination_key", core.serialization.string().optional()),
+    total: core.serialization.number().optional(),
+});

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

@@ -0,0 +1,11 @@
+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 ErrorResponse: core.serialization.ObjectSchema<serializers.ErrorResponse.Raw, PredictorSDK.ErrorResponse>;
+export declare namespace ErrorResponse {
+    interface Raw {
+        error: string;
+        message?: string | null;
+        status_code: number;
+    }
+}

package/dist/serialization/types/ErrorResponse.js

@@ -0,0 +1,7 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+export const ErrorResponse = core.serialization.object({
+    error: core.serialization.string(),
+    message: core.serialization.string().optional(),
+    statusCode: core.serialization.property("status_code", core.serialization.number()),
+});

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

@@ -0,0 +1,16 @@
+import type * as PredictorSDK from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+import { PlatformMarketPlatform } from "./PlatformMarketPlatform.js";
+export declare const PlatformMarket: core.serialization.ObjectSchema<serializers.PlatformMarket.Raw, PredictorSDK.PlatformMarket>;
+export declare namespace PlatformMarket {
+    interface Raw {
+        platform: PlatformMarketPlatform.Raw;
+        event_ticker?: string | null;
+        market_tickers?: string[] | null;
+        market_slug?: string | null;
+        token_ids?: string[] | null;
+        market_id?: string | null;
+        outcome_ids?: string[] | null;
+    }
+}

package/dist/serialization/types/PlatformMarket.js

@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+import { PlatformMarketPlatform } from "./PlatformMarketPlatform.js";
+export const PlatformMarket = core.serialization.object({
+    platform: PlatformMarketPlatform,
+    eventTicker: core.serialization.property("event_ticker", core.serialization.string().optional()),
+    marketTickers: core.serialization.property("market_tickers", core.serialization.list(core.serialization.string()).optional()),
+    marketSlug: core.serialization.property("market_slug", core.serialization.string().optional()),
+    tokenIds: core.serialization.property("token_ids", core.serialization.list(core.serialization.string()).optional()),
+    marketId: core.serialization.property("market_id", core.serialization.string().optional()),
+    outcomeIds: core.serialization.property("outcome_ids", core.serialization.list(core.serialization.string()).optional()),
+});

package/dist/serialization/types/PlatformMarketPlatform.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 PlatformMarketPlatform: core.serialization.Schema<serializers.PlatformMarketPlatform.Raw, PredictorSDK.PlatformMarketPlatform>;
+export declare namespace PlatformMarketPlatform {
+    type Raw = "KALSHI" | "POLYMARKET" | "PREDICT" | "SXBET";
+}

package/dist/serialization/types/PlatformMarketPlatform.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 PlatformMarketPlatform = core.serialization.enum_(["KALSHI", "POLYMARKET", "PREDICT", "SXBET"]);

package/dist/serialization/types/SportsMatchingResponse.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 { PlatformMarket } from "./PlatformMarket.js";
+export declare const SportsMatchingResponse: core.serialization.ObjectSchema<serializers.SportsMatchingResponse.Raw, PredictorSDK.SportsMatchingResponse>;
+export declare namespace SportsMatchingResponse {
+    interface Raw {
+        markets: Record<string, PlatformMarket.Raw[]>;
+    }
+}

package/dist/serialization/types/SportsMatchingResponse.js

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

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

@@ -0,0 +1,6 @@
+export * from "./CryptoPriceItem.js";
+export * from "./CryptoPricesResponse.js";
+export * from "./ErrorResponse.js";
+export * from "./PlatformMarket.js";
+export * from "./PlatformMarketPlatform.js";
+export * from "./SportsMatchingResponse.js";

package/dist/serialization/types/index.js

@@ -0,0 +1,6 @@
+export * from "./CryptoPriceItem.js";
+export * from "./CryptoPricesResponse.js";
+export * from "./ErrorResponse.js";
+export * from "./PlatformMarket.js";
+export * from "./PlatformMarketPlatform.js";
+export * from "./SportsMatchingResponse.js";

package/package.json

@@ -1,8 +1,17 @@
 {
   "name": "@predictorsdk/client",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "The official TypeScript/JavaScript client for the PredictorSDK matching markets API",
   "license": "MIT",
+  "keywords": [
+    "predictorsdk",
+    "sports",
+    "betting",
+    "prediction-markets",
+    "kalshi",
+    "polymarket",
+    "sdk"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,8 +27,10 @@
       "default": "./dist/index.js"
     }
   },
+  "sideEffects": false,
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "repository": {
     "type": "git",
@@ -36,7 +47,7 @@
     "node": ">=18"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
+    "@types/node": "^25.5.2",
     "typescript": "^5.7.0"
   }
 }