@newyorkcompute/kalshi-core 0.1.0 → 0.1.1

package/dist/index.d.ts

@@ -6,4 +6,6 @@
 export { type KalshiConfig, DEFAULT_BASE_PATH, DEMO_BASE_PATH, getKalshiConfig, createSdkConfig, createMarketApi, createPortfolioApi, createOrdersApi, createEventsApi, } from "./config.js";
 export { formatPrice, formatCurrency, formatPercent, formatPriceChange, formatCompactNumber, formatRelativeTime, truncate, padString, } from "./format.js";
 export * from "./types.js";
+export { withTimeout, TimeoutError } from "./with-timeout.js";
+export { validateOrder, type OrderValidationInput, type OrderValidationResult, } from "./validate-order.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,KAAK,YAAY,EACjB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,WAAW,EACX,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACR,SAAS,GACV,MAAM,aAAa,CAAC;AAGrB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,KAAK,YAAY,EACjB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,WAAW,EACX,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACR,SAAS,GACV,MAAM,aAAa,CAAC;AAGrB,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAG9D,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -9,4 +9,8 @@ export { DEFAULT_BASE_PATH, DEMO_BASE_PATH, getKalshiConfig, createSdkConfig, cr
 export { formatPrice, formatCurrency, formatPercent, formatPriceChange, formatCompactNumber, formatRelativeTime, truncate, padString, } from "./format.js";
 // Types
 export * from "./types.js";
+// Utilities
+export { withTimeout, TimeoutError } from "./with-timeout.js";
+// Validation
+export { validateOrder, } from "./validate-order.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gBAAgB;AAChB,OAAO,EAEL,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,uBAAuB;AACvB,OAAO,EACL,WAAW,EACX,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACR,SAAS,GACV,MAAM,aAAa,CAAC;AAErB,QAAQ;AACR,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gBAAgB;AAChB,OAAO,EAEL,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,uBAAuB;AACvB,OAAO,EACL,WAAW,EACX,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACR,SAAS,GACV,MAAM,aAAa,CAAC;AAErB,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE9D,aAAa;AACb,OAAO,EACL,aAAa,GAGd,MAAM,qBAAqB,CAAC"}

package/dist/types.d.ts

@@ -38,6 +38,7 @@ export interface MarketDisplay {
     no_bid?: number;
     no_ask?: number;
     volume?: number;
+    volume_24h?: number;
     open_interest?: number;
     close_time?: string;
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACT,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,cAAc,EAAE,CAAC;IACtB,EAAE,EAAE,cAAc,EAAE,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACT,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,cAAc,EAAE,CAAC;IACtB,EAAE,EAAE,cAAc,EAAE,CAAC;CACtB"}

package/dist/validate-order.d.ts

@@ -0,0 +1,32 @@
+import type { MarketApi, PortfolioApi } from "kalshi-typescript";
+export interface OrderValidationInput {
+    ticker: string;
+    side: "yes" | "no";
+    action: "buy" | "sell";
+    count: number;
+    price?: number;
+}
+export interface OrderValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    estimatedCost?: number;
+    currentBalance?: number;
+    marketStatus?: string;
+}
+/**
+ * Validates an order before submission
+ *
+ * Performs pre-flight checks:
+ * - Market is open for trading
+ * - Sufficient balance for buy orders
+ * - Price is reasonable (warns if far from market)
+ * - Order quantity is valid
+ *
+ * @param input - Order parameters to validate
+ * @param marketApi - Market API client
+ * @param portfolioApi - Portfolio API client
+ * @returns Validation result with errors and warnings
+ */
+export declare function validateOrder(input: OrderValidationInput, marketApi: MarketApi, portfolioApi: PortfolioApi): Promise<OrderValidationResult>;
+//# sourceMappingURL=validate-order.d.ts.map

package/dist/validate-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-order.d.ts","sourceRoot":"","sources":["../src/validate-order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,oBAAoB,EAC3B,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,qBAAqB,CAAC,CAqFhC"}

package/dist/validate-order.js

@@ -0,0 +1,82 @@
+/**
+ * Validates an order before submission
+ *
+ * Performs pre-flight checks:
+ * - Market is open for trading
+ * - Sufficient balance for buy orders
+ * - Price is reasonable (warns if far from market)
+ * - Order quantity is valid
+ *
+ * @param input - Order parameters to validate
+ * @param marketApi - Market API client
+ * @param portfolioApi - Portfolio API client
+ * @returns Validation result with errors and warnings
+ */
+export async function validateOrder(input, marketApi, portfolioApi) {
+    const errors = [];
+    const warnings = [];
+    let estimatedCost = 0;
+    let currentBalance = 0;
+    let marketStatus = "unknown";
+    try {
+        // 1. Fetch market details
+        const marketResponse = await marketApi.getMarket(input.ticker);
+        const market = marketResponse.data.market;
+        marketStatus = market.status || "unknown";
+        // Check market is open
+        if (market.status?.toLowerCase() !== "open") {
+            errors.push(`Market ${input.ticker} is ${market.status}, not open for trading`);
+        }
+        // Get current market price
+        const currentPrice = input.side === "yes"
+            ? input.action === "buy"
+                ? market.yes_ask
+                : market.yes_bid
+            : input.action === "buy"
+                ? market.no_ask
+                : market.no_bid;
+        // Warn if user price is far from market
+        if (input.price && currentPrice) {
+            const priceDiff = Math.abs(input.price - currentPrice);
+            if (priceDiff > 20) {
+                warnings.push(`Your price (${input.price}¢) is ${priceDiff}¢ away from market (${currentPrice}¢)`);
+            }
+        }
+        // 2. Fetch balance
+        const balanceResponse = await portfolioApi.getBalance();
+        currentBalance = balanceResponse.data.balance || 0;
+        // Calculate estimated cost
+        // For buy orders: cost = count * price
+        // For sell orders: no cost (you receive money)
+        if (input.action === "buy") {
+            const price = input.price || currentPrice || 50; // Default to 50¢ if unknown
+            estimatedCost = input.count * price;
+            // Check sufficient balance
+            if (estimatedCost > currentBalance) {
+                errors.push(`Insufficient balance: need ${estimatedCost}¢, have ${currentBalance}¢`);
+            }
+        }
+        // 3. Sanity checks
+        if (input.count <= 0) {
+            errors.push("Order quantity must be positive");
+        }
+        if (input.count > 1000) {
+            warnings.push("Large order size may have poor execution");
+        }
+        if (input.price && (input.price < 1 || input.price > 99)) {
+            errors.push("Price must be between 1¢ and 99¢");
+        }
+    }
+    catch (error) {
+        errors.push(`Validation failed: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        estimatedCost,
+        currentBalance,
+        marketStatus,
+    };
+}
+//# sourceMappingURL=validate-order.js.map

package/dist/validate-order.js.map

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

package/dist/validate-order.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validate-order.test.d.ts.map

package/dist/validate-order.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-order.test.d.ts","sourceRoot":"","sources":["../src/validate-order.test.ts"],"names":[],"mappings":""}

package/dist/validate-order.test.js

@@ -0,0 +1,234 @@
+import { describe, it, expect, vi } from "vitest";
+import { validateOrder } from "./validate-order.js";
+describe("validateOrder", () => {
+    const mockGetMarket = vi.fn();
+    const mockGetBalance = vi.fn();
+    const mockMarketApi = {
+        getMarket: mockGetMarket,
+    };
+    const mockPortfolioApi = {
+        getBalance: mockGetBalance,
+    };
+    it("should validate successful order", async () => {
+        mockGetMarket.mockResolvedValue({
+            data: {
+                market: {
+                    ticker: "TEST-MARKET",
+                    status: "open",
+                    yes_ask: 50,
+                    yes_bid: 48,
+                },
+            },
+        });
+        mockGetBalance.mockResolvedValue({
+            data: { balance: 10000 },
+        });
+        const result = await validateOrder({
+            ticker: "TEST-MARKET",
+            side: "yes",
+            action: "buy",
+            count: 10,
+            price: 50,
+        }, mockMarketApi, mockPortfolioApi);
+        expect(result.valid).toBe(true);
+        expect(result.errors).toHaveLength(0);
+        expect(result.estimatedCost).toBe(500);
+    });
+    it("should reject order on closed market", async () => {
+        mockGetMarket.mockResolvedValue({
+            data: {
+                market: {
+                    ticker: "TEST-MARKET",
+                    status: "closed",
+                },
+            },
+        });
+        mockGetBalance.mockResolvedValue({
+            data: { balance: 10000 },
+        });
+        const result = await validateOrder({
+            ticker: "TEST-MARKET",
+            side: "yes",
+            action: "buy",
+            count: 10,
+            price: 50,
+        }, mockMarketApi, mockPortfolioApi);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some((e) => e.includes("closed"))).toBe(true);
+    });
+    it("should reject order with insufficient balance", async () => {
+        mockGetMarket.mockResolvedValue({
+            data: {
+                market: {
+                    ticker: "TEST-MARKET",
+                    status: "open",
+                    yes_ask: 50,
+                },
+            },
+        });
+        mockGetBalance.mockResolvedValue({
+            data: { balance: 100 }, // Only 100¢
+        });
+        const result = await validateOrder({
+            ticker: "TEST-MARKET",
+            side: "yes",
+            action: "buy",
+            count: 10,
+            price: 50, // Costs 500¢
+        }, mockMarketApi, mockPortfolioApi);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some((e) => e.includes("Insufficient balance"))).toBe(true);
+    });
+    it("should warn on price far from market", async () => {
+        mockGetMarket.mockResolvedValue({
+            data: {
+                market: {
+                    ticker: "TEST-MARKET",
+                    status: "open",
+                    yes_ask: 50,
+                },
+            },
+        });
+        mockGetBalance.mockResolvedValue({
+            data: { balance: 10000 },
+        });
+        const result = await validateOrder({
+            ticker: "TEST-MARKET",
+            side: "yes",
+            action: "buy",
+            count: 10,
+            price: 80, // 30¢ away from market
+        }, mockMarketApi, mockPortfolioApi);
+        expect(result.valid).toBe(true);
+        expect(result.warnings.length).toBeGreaterThan(0);
+        expect(result.warnings.some((w) => w.includes("away from market"))).toBe(true);
+    });
+    it("should reject negative quantity", async () => {
+        mockGetMarket.mockResolvedValue({
+            data: {
+                market: {
+                    ticker: "TEST-MARKET",
+                    status: "open",
+                    yes_ask: 50,
+                },
+            },
+        });
+        mockGetBalance.mockResolvedValue({
+            data: { balance: 10000 },
+        });
+        const result = await validateOrder({
+            ticker: "TEST-MARKET",
+            side: "yes",
+            action: "buy",
+            count: -5,
+            price: 50,
+        }, mockMarketApi, mockPortfolioApi);
+        expect(result.valid).toBe(false);
+        expect(result.errors).toContain("Order quantity must be positive");
+    });
+    it("should warn on large order size", async () => {
+        mockGetMarket.mockResolvedValue({
+            data: {
+                market: {
+                    ticker: "TEST-MARKET",
+                    status: "open",
+                    yes_ask: 50,
+                },
+            },
+        });
+        mockGetBalance.mockResolvedValue({
+            data: { balance: 100000 },
+        });
+        const result = await validateOrder({
+            ticker: "TEST-MARKET",
+            side: "yes",
+            action: "buy",
+            count: 1500,
+            price: 50,
+        }, mockMarketApi, mockPortfolioApi);
+        expect(result.valid).toBe(true);
+        expect(result.warnings).toContain("Large order size may have poor execution");
+    });
+    it("should reject invalid price range", async () => {
+        mockGetMarket.mockResolvedValue({
+            data: {
+                market: {
+                    ticker: "TEST-MARKET",
+                    status: "open",
+                    yes_ask: 50,
+                },
+            },
+        });
+        mockGetBalance.mockResolvedValue({
+            data: { balance: 10000 },
+        });
+        const result = await validateOrder({
+            ticker: "TEST-MARKET",
+            side: "yes",
+            action: "buy",
+            count: 10,
+            price: 150, // Invalid: >99
+        }, mockMarketApi, mockPortfolioApi);
+        expect(result.valid).toBe(false);
+        expect(result.errors).toContain("Price must be between 1¢ and 99¢");
+    });
+    it("should allow sell orders without balance check", async () => {
+        mockGetMarket.mockResolvedValue({
+            data: {
+                market: {
+                    ticker: "TEST-MARKET",
+                    status: "open",
+                    yes_bid: 50,
+                },
+            },
+        });
+        mockGetBalance.mockResolvedValue({
+            data: { balance: 0 }, // No balance
+        });
+        const result = await validateOrder({
+            ticker: "TEST-MARKET",
+            side: "yes",
+            action: "sell",
+            count: 10,
+            price: 50,
+        }, mockMarketApi, mockPortfolioApi);
+        expect(result.valid).toBe(true);
+        expect(result.estimatedCost).toBe(0);
+    });
+    it("should handle API errors gracefully", async () => {
+        mockGetMarket.mockRejectedValue(new Error("Network error"));
+        const result = await validateOrder({
+            ticker: "TEST-MARKET",
+            side: "yes",
+            action: "buy",
+            count: 10,
+            price: 50,
+        }, mockMarketApi, mockPortfolioApi);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some((e) => e.includes("Validation failed"))).toBe(true);
+    });
+    it("should use default price if not provided", async () => {
+        mockGetMarket.mockResolvedValue({
+            data: {
+                market: {
+                    ticker: "TEST-MARKET",
+                    status: "open",
+                    yes_ask: 60,
+                },
+            },
+        });
+        mockGetBalance.mockResolvedValue({
+            data: { balance: 10000 },
+        });
+        const result = await validateOrder({
+            ticker: "TEST-MARKET",
+            side: "yes",
+            action: "buy",
+            count: 10,
+            // No price provided
+        }, mockMarketApi, mockPortfolioApi);
+        expect(result.valid).toBe(true);
+        expect(result.estimatedCost).toBe(600); // Uses market price (60)
+    });
+});
+//# sourceMappingURL=validate-order.test.js.map

package/dist/validate-order.test.js.map

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

package/dist/with-timeout.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Custom error class for timeout errors
+ */
+export declare class TimeoutError extends Error {
+    constructor(message: string);
+}
+/**
+ * Wraps a promise with a timeout
+ *
+ * @param promise - The promise to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @param errorMessage - Custom error message for timeout
+ * @returns The promise result or throws TimeoutError
+ *
+ * @example
+ * ```typescript
+ * const result = await withTimeout(
+ *   fetch('https://api.example.com'),
+ *   5000,
+ *   'API request timed out'
+ * );
+ * ```
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, errorMessage?: string): Promise<T>;
+//# sourceMappingURL=with-timeout.d.ts.map

package/dist/with-timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-timeout.d.ts","sourceRoot":"","sources":["../src/with-timeout.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,SAAoB,GAC/B,OAAO,CAAC,CAAC,CAAC,CAMZ"}

package/dist/with-timeout.js

@@ -0,0 +1,33 @@
+/**
+ * Custom error class for timeout errors
+ */
+export class TimeoutError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TimeoutError";
+    }
+}
+/**
+ * Wraps a promise with a timeout
+ *
+ * @param promise - The promise to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @param errorMessage - Custom error message for timeout
+ * @returns The promise result or throws TimeoutError
+ *
+ * @example
+ * ```typescript
+ * const result = await withTimeout(
+ *   fetch('https://api.example.com'),
+ *   5000,
+ *   'API request timed out'
+ * );
+ * ```
+ */
+export async function withTimeout(promise, timeoutMs, errorMessage = "Request timeout") {
+    const timeout = new Promise((_, reject) => {
+        setTimeout(() => reject(new TimeoutError(errorMessage)), timeoutMs);
+    });
+    return Promise.race([promise, timeout]);
+}
+//# sourceMappingURL=with-timeout.js.map

package/dist/with-timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-timeout.js","sourceRoot":"","sources":["../src/with-timeout.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,SAAiB,EACjB,YAAY,GAAG,iBAAiB;IAEhC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/C,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,YAAY,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/with-timeout.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=with-timeout.test.d.ts.map

package/dist/with-timeout.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-timeout.test.d.ts","sourceRoot":"","sources":["../src/with-timeout.test.ts"],"names":[],"mappings":""}

package/dist/with-timeout.test.js

@@ -0,0 +1,72 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { withTimeout, TimeoutError } from "./with-timeout.js";
+describe("withTimeout", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it("should resolve if promise completes before timeout", async () => {
+        const promise = Promise.resolve("success");
+        const resultPromise = withTimeout(promise, 1000);
+        const result = await resultPromise;
+        expect(result).toBe("success");
+    });
+    it("should reject with TimeoutError if promise takes too long", async () => {
+        const promise = new Promise((resolve) => {
+            setTimeout(() => resolve("too late"), 2000);
+        });
+        const resultPromise = withTimeout(promise, 100, "Custom timeout message");
+        vi.advanceTimersByTime(100);
+        await expect(resultPromise).rejects.toThrow(TimeoutError);
+        await expect(resultPromise).rejects.toThrow("Custom timeout message");
+    });
+    it("should reject with original error if promise rejects", async () => {
+        const promise = Promise.reject(new Error("Network error"));
+        await expect(withTimeout(promise, 1000)).rejects.toThrow("Network error");
+    });
+    it("should use default error message if not provided", async () => {
+        const promise = new Promise((resolve) => {
+            setTimeout(() => resolve("too late"), 2000);
+        });
+        const resultPromise = withTimeout(promise, 100);
+        vi.advanceTimersByTime(100);
+        await expect(resultPromise).rejects.toThrow("Request timeout");
+    });
+    it("should handle promise that resolves exactly at timeout", async () => {
+        let resolvePromise;
+        const promise = new Promise((resolve) => {
+            resolvePromise = resolve;
+        });
+        const resultPromise = withTimeout(promise, 1000);
+        // Resolve just before timeout
+        vi.advanceTimersByTime(999);
+        resolvePromise("just in time");
+        const result = await resultPromise;
+        expect(result).toBe("just in time");
+    });
+    it("should handle different data types", async () => {
+        const numberPromise = Promise.resolve(42);
+        expect(await withTimeout(numberPromise, 1000)).toBe(42);
+        const objectPromise = Promise.resolve({ foo: "bar" });
+        expect(await withTimeout(objectPromise, 1000)).toEqual({ foo: "bar" });
+        const arrayPromise = Promise.resolve([1, 2, 3]);
+        expect(await withTimeout(arrayPromise, 1000)).toEqual([1, 2, 3]);
+    });
+    it("should have correct error name", async () => {
+        const promise = new Promise((resolve) => {
+            setTimeout(() => resolve("too late"), 2000);
+        });
+        const resultPromise = withTimeout(promise, 100);
+        vi.advanceTimersByTime(100);
+        try {
+            await resultPromise;
+        }
+        catch (error) {
+            expect(error).toBeInstanceOf(TimeoutError);
+            expect(error.name).toBe("TimeoutError");
+        }
+    });
+});
+//# sourceMappingURL=with-timeout.test.js.map

package/dist/with-timeout.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newyorkcompute/kalshi-core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Shared utilities for Kalshi prediction market tools — SDK configuration, formatting, and types",
   "author": "NewYorkCompute",
   "license": "MIT",
@@ -52,4 +52,3 @@
     "vitest": "^3.2.3"
   }
 }
-