@jsnw/kalshi-client 0.0.1 → 0.2.0

package/dist/index.mjs

@@ -3,6 +3,7 @@ import { z } from "zod";
 import { v4 } from "uuid";
 import { WebSocket } from "ws";
 import { setTimeout as setTimeout$1 } from "node:timers/promises";
+import { ApiClient as ApiClient$1, createRouter } from "@jsnw/api-client";
 //#region src/request-signer.ts
 var RequestSigner = class {
 	privkey;
@@ -77,8 +78,39 @@ const primitives$fixedPointSchema = z.string().regex(/^\d{1,14}\.\d{2,8}$/);
 const primitives$orderSideSchema = z.enum(["yes", "no"]);
 const primitives$bookSideSchema = z.enum(["bid", "ask"]);
 const primitives$orderActionSchema = z.enum(["buy", "sell"]);
+const primitives$rateLimitBucketMetaSchema = z.object({
+	refill_rate: z.number(),
+	bucket_capacity: z.number()
+});
+//#endregion
+//#region src/schemas/http.ts
+const http$errorMessageSchema = z.object({
+	code: z.number(),
+	message: z.string().optional(),
+	details: z.any().optional(),
+	service: z.any().optional()
+});
+//#endregion
+//#region src/schemas/account.ts
+const account$accountTierSchema = z.enum([
+	"basic",
+	"advanced",
+	"expert",
+	"premier",
+	"paragon",
+	"prime",
+	"prestige"
+]);
+const account$subaccountSchema = z.number().min(0).max(63).default(0);
+const account$accountGrantSchema = z.object({
+	exchange_instance: z.enum(["event_contract", "margined"]),
+	level: account$accountTierSchema,
+	source: z.enum(["volume", "manual"]),
+	expires_ts: z.number().nullable().default(null)
+});
 //#endregion
 //#region src/schemas/orders.ts
+const orders$clientOrderIdSchema = z.string().nullable().optional();
 const orders$orderStatusSchema = z.enum([
 	"resting",
 	"canceled",
@@ -86,17 +118,22 @@ const orders$orderStatusSchema = z.enum([
 ]);
 const orders$orderTypeSchema = z.enum(["limit", "market"]);
 const orders$selfTradePreventionTypeSchema = z.enum(["taker_at_cross", "maker"]);
+const orders$timeInForceSchema = z.enum([
+	"fill_or_kill",
+	"good_till_canceled",
+	"immediate_or_cancel"
+]);
 const orders$orderDetailedSchema = z.object({
 	order_id: z.uuid(),
 	user_id: z.uuid(),
-	subaccount_number: z.number().min(0).max(32).default(0),
-	order_group_id: z.uuid().nullable().optional(),
+	client_order_id: orders$clientOrderIdSchema,
+	order_group_id: z.string().nullable().optional(),
+	subaccount_number: account$subaccountSchema,
 	exchange_index: z.number().min(0).default(0),
-	client_order_id: z.string(),
 	ticker: z.string(),
+	type: orders$orderTypeSchema,
 	outcome_side: primitives$orderSideSchema,
 	book_side: primitives$bookSideSchema,
-	type: orders$orderTypeSchema,
 	status: orders$orderStatusSchema,
 	yes_price_dollars: primitives$fixedPointSchema,
 	no_price_dollars: primitives$fixedPointSchema,
@@ -107,11 +144,11 @@ const orders$orderDetailedSchema = z.object({
 	maker_fill_cost_dollars: primitives$fixedPointSchema,
 	taker_fees_dollars: primitives$fixedPointSchema,
 	maker_fees_dollars: primitives$fixedPointSchema,
-	self_trade_prevention_type: orders$selfTradePreventionTypeSchema.nullable().optional(),
+	self_trade_prevention_type: orders$selfTradePreventionTypeSchema,
 	cancel_order_on_pause: z.boolean(),
 	created_time: z.iso.datetime(),
-	expiration_time: z.iso.datetime().nullable().optional(),
-	last_update_time: z.iso.datetime().nullable().optional()
+	last_update_time: z.iso.datetime().nullable().optional(),
+	expiration_time: z.iso.datetime().nullable().optional()
 });
 const orders$orderWsSchema = orders$orderDetailedSchema.omit({
 	exchange_index: true,
@@ -124,12 +161,32 @@ const orders$orderWsSchema = orders$orderDetailedSchema.omit({
 	last_updated_ts_ms: z.number().positive().optional(),
 	expiration_ts_ms: z.number().positive().optional()
 });
+const orders$createOrderDtoSchema = z.object({
+	client_order_id: z.string().optional(),
+	order_group_id: z.string().optional(),
+	exchange_index: z.number().min(0).default(0),
+	ticker: z.string(),
+	side: primitives$bookSideSchema,
+	count: primitives$fixedPointSchema,
+	subaccount: account$subaccountSchema,
+	price: primitives$fixedPointSchema,
+	post_only: z.boolean().default(false),
+	reduce_only: z.boolean().default(false),
+	cancel_order_on_pause: z.boolean(),
+	self_trade_prevention_type: orders$selfTradePreventionTypeSchema,
+	time_in_force: orders$timeInForceSchema,
+	expiration_time: z.number().optional()
+});
 //#endregion
 //#region src/consts.ts
 const KALSHI_WS_URL = {
 	"development": "wss://external-api-ws.demo.kalshi.co",
 	"production": "wss://external-api-ws.kalshi.com"
 };
+const KALSHI_API_URL = {
+	"development": "https://external-api.demo.kalshi.co",
+	"production": "https://external-api.kalshi.com"
+};
 //#endregion
 //#region src/typed-emitter.ts
 var TypedEmitter = class {
@@ -501,6 +558,8 @@ var WsKalshiError = class extends Error {
 		this.code = code;
 	}
 };
+var WsClosedError = class extends Error {};
+var WsClosedByUserError = class extends Error {};
 //#endregion
 //#region src/ws/ws-client.ts
 var WsClient = class extends TypedEmitter {
@@ -545,9 +604,39 @@ var WsClient = class extends TypedEmitter {
 		this.ws.on("reconnecting", this.onReconnecting);
 		this.ws.on("close", this.onClose);
 	}
+	/**
+	* @return {Promise<void>}
+	*/
+	connect() {
+		return this.ws.open();
+	}
+	/**
+	* @return {Promise<void>}
+	*/
+	async subscribe(options) {
+		const { channel, timeoutMs, ...rest } = options;
+		const messageId = ++this.lastMessageId;
+		const payload = {
+			id: messageId,
+			cmd: "subscribe",
+			params: {
+				channels: [channel],
+				...rest
+			}
+		};
+		const promise = this.subscribeAwaiters.add(messageId, timeoutMs ?? 2e3);
+		await this.ws.send(JSON.stringify(payload));
+		return promise;
+	}
+	/**
+	* @return {Promise<void>}
+	*/
+	close() {
+		this.subscribeAwaiters.clear(new WsClosedByUserError());
+		return this.ws.close();
+	}
 	onReady = async (afterReconnect) => {
-		this.log("debug", "WebSocket connection ready", { afterReconnect });
-		this.emit("ready");
+		this.emit("ready", afterReconnect);
 	};
 	/**
 	* @param {WebSocket.RawData} data
@@ -581,21 +670,19 @@ var WsClient = class extends TypedEmitter {
 	* @param {number} attempt
 	*/
 	onReconnecting = (attempt) => {
-		this.log("debug", "reconnecting", { attempt });
 		this.emit("reconnect", attempt);
 	};
 	/**
 	* @param {Error} err
 	*/
 	onError = (err) => {
-		this.log("error", "WebSocket error", { err });
+		this.emit("ws_error", err);
 	};
 	/**
 	*/
 	onClose = () => {
-		this.log("debug", "WebSocket connection closed");
 		this.emit("close");
-		this.subscribeAwaiters.clear();
+		this.subscribeAwaiters.clear(new WsClosedError());
 	};
 	/**
 	* @param {WsAnyMessage} msg
@@ -649,4 +736,155 @@ const WS_KALSHI_SERVER_ERRORS = [
 	WS_KALSHI_ERRORS.COMMAND_TIMEOUT
 ];
 //#endregion
-export { InMemoryCredentialsProvider, RequestSigner, WS_KALSHI_ERRORS, WS_KALSHI_SERVER_ERRORS, WsClient, WsKalshiError, orders$orderDetailedSchema, orders$orderStatusSchema, orders$orderTypeSchema, orders$orderWsSchema, orders$selfTradePreventionTypeSchema, primitives$bookSideSchema, primitives$fixedPointSchema, primitives$orderActionSchema, primitives$orderSideSchema, wsAnyMessageSchema, wsErrorMessageSchema, wsOkMessageSchema, wsSubscribedMessageSchema, wsUserOrderMessageSchema };
+//#region src/api/metadata.ts
+const METADATA = { NO_AUTH: Symbol("no-auth") };
+//#endregion
+//#region src/api/router/index.ts
+const apiRouter = createRouter({
+	exchange: createRouter({
+		getStatus: {
+			method: "get",
+			path: "/status",
+			responses: { 200: z.object({
+				exchange_active: z.boolean(),
+				trading_active: z.boolean(),
+				exchange_estimated_resume_time: z.iso.datetime().nullable().optional()
+			}) }
+		},
+		getUserDataTimestamp: {
+			method: "get",
+			path: "/user_data_timestamp",
+			responses: { 200: z.object({ as_of_time: z.iso.datetime() }) }
+		}
+	}, {
+		path: "exchange",
+		metadata: { [METADATA.NO_AUTH]: true }
+	}),
+	account: createRouter({
+		getLimits: {
+			method: "get",
+			path: "/limits",
+			responses: { 200: z.object({
+				usage_tier: account$accountTierSchema,
+				read: primitives$rateLimitBucketMetaSchema,
+				write: primitives$rateLimitBucketMetaSchema,
+				grants: z.array(account$accountGrantSchema)
+			}) }
+		},
+		listNonDefaultEndpointCosts: {
+			method: "get",
+			path: "/endpoint_costs",
+			responses: { 200: z.object({
+				default_cost: z.number().min(0),
+				endpoint_costs: z.array(z.object({
+					method: z.string(),
+					path: z.string(),
+					cost: z.number().min(0)
+				}))
+			}) },
+			metadata: { [METADATA.NO_AUTH]: true }
+		}
+	}, { path: "/account" }),
+	orders: createRouter({
+		getOrder: {
+			method: "get",
+			path: "/orders/:order_id",
+			params: z.object({ order_id: z.uuid() }),
+			responses: { 200: z.object({ order: orders$orderDetailedSchema }) }
+		},
+		createOrder: {
+			method: "post",
+			path: "/events/orders",
+			body: orders$createOrderDtoSchema,
+			responses: { 201: z.object({
+				order_id: z.uuid(),
+				client_order_id: orders$clientOrderIdSchema,
+				fill_count: primitives$fixedPointSchema,
+				remaining_count: primitives$fixedPointSchema,
+				average_fill_price: primitives$fixedPointSchema.nullable().optional(),
+				average_fee_paid: primitives$fixedPointSchema.nullable().optional(),
+				ts_ms: z.number().min(0)
+			}) }
+		},
+		cancelOrderV1: {
+			method: "delete",
+			path: "/orders/:order_id",
+			params: z.object({ order_id: z.uuid() }),
+			query: z.object({
+				subaccount: z.number().min(0).max(63).default(0),
+				exchange_index: z.number().min(0).default(0)
+			}).prefault({}),
+			responses: { 200: z.object({
+				order: orders$orderDetailedSchema,
+				reduced_by_fp: primitives$fixedPointSchema
+			}) }
+		},
+		cancelOrderV2: {
+			method: "delete",
+			path: "/events/orders/:order_id",
+			params: z.object({ order_id: z.uuid() }),
+			query: z.object({
+				subaccount: z.number().min(0).max(63).default(0),
+				exchange_index: z.number().min(0).default(0)
+			}).prefault({}),
+			responses: { 200: z.object({
+				order_id: z.uuid(),
+				client_order_id: orders$clientOrderIdSchema,
+				reduced_by: primitives$fixedPointSchema,
+				ts_ms: z.number().min(0)
+			}) }
+		},
+		getOrderQueuePosition: {
+			method: "get",
+			path: "/orders/:order_id/queue_position",
+			params: z.object({ order_id: z.uuid() }),
+			responses: { 200: z.object({ queue_position_fp: primitives$fixedPointSchema }) }
+		}
+	}, { path: "/portfolio" })
+}, { path: "/trade-api/v2" });
+//#endregion
+//#region src/api/client.ts
+var ApiClient = class extends ApiClient$1 {
+	/**
+	* @param {ApiClientConfig} config
+	*/
+	constructor(config) {
+		super(apiRouter, {
+			...config,
+			baseURL: KALSHI_API_URL[config.environment ?? "development"],
+			qsArrayFormat: "brackets",
+			contentType: "application/json"
+		});
+	}
+	/**
+	* @template {Route} TRoute
+	* @param {TRoute} route
+	* @param {ApiRequestParams<TRoute>} params
+	* @param {ApiCallOptions} options
+	* @return {Promise<ApiResponse<TRoute>>}
+	*/
+	/**
+	* @param {"force"} force
+	* @return {Promise<void>}
+	* @private
+	*/
+	/**
+	* @param {ApiRawRequest} req
+	* @return {ApiRawRequest}
+	* @protected
+	*/
+	onBeforeRequest(req) {
+		if (req.route.metadata?.[METADATA.NO_AUTH] && req.route.metadata[METADATA.NO_AUTH] === true) return req;
+		const ts = Date.now();
+		req.headers["kalshi-access-key"] = this.config.credentialsProvider.getAccessKey();
+		req.headers["kalshi-access-timestamp"] = ts.toString();
+		req.headers["kalshi-access-signature"] = this.config.credentialsProvider.getSignature({
+			httpMethod: req.route.method,
+			path: req.path,
+			timestamp: ts
+		});
+		return req;
+	}
+};
+//#endregion
+export { ApiClient, InMemoryCredentialsProvider, RequestSigner, WS_KALSHI_ERRORS, WS_KALSHI_SERVER_ERRORS, WsClient, WsClosedByUserError, WsClosedError, WsKalshiError, account$accountGrantSchema, account$accountTierSchema, account$subaccountSchema, http$errorMessageSchema, orders$clientOrderIdSchema, orders$createOrderDtoSchema, orders$orderDetailedSchema, orders$orderStatusSchema, orders$orderTypeSchema, orders$orderWsSchema, orders$selfTradePreventionTypeSchema, orders$timeInForceSchema, primitives$bookSideSchema, primitives$fixedPointSchema, primitives$orderActionSchema, primitives$orderSideSchema, primitives$rateLimitBucketMetaSchema, wsAnyMessageSchema, wsErrorMessageSchema, wsOkMessageSchema, wsSubscribedMessageSchema, wsUserOrderMessageSchema };

package/package.json

@@ -4,7 +4,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.0.1",
+  "version": "0.2.0",
   "engines": {
     "node": ">=22"
   },
@@ -24,6 +24,8 @@
     "dist"
   ],
   "dependencies": {
+    "@jsnw/api-client": "^0.7.1",
+    "@ts-rest/core": "3.53.0-rc.1",
     "uuid": "^14.0.0",
     "ws": "^8.21.0",
     "zod": "^4.4.3"
@@ -32,12 +34,11 @@
     "bufferutil": "^4.1.0"
   },
   "devDependencies": {
-    "@types/node": "^24.12.4",
+    "@types/node": "^24.13.1",
     "@types/ws": "^8.18.1",
     "nodemon": "^3.1.14",
-    "rimraf": "^6.1.3",
     "ts-node": "^10.9.2",
-    "tsdown": "^0.22.1",
+    "tsdown": "^0.22.2",
     "typescript": "^5.9.3"
   },
   "scripts": {