@0xmonaco/types 0.0.0-develop-20260120180031

package/dist/validation/market.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Market API Validation Schemas
+ */
+import { z } from "zod";
+/**
+ * Candlestick interval validation
+ */
+export declare const IntervalSchema: z.ZodEnum<{
+    "1m": "1m";
+    "5m": "5m";
+    "15m": "15m";
+    "30m": "30m";
+    "1h": "1h";
+    "4h": "4h";
+    "1d": "1d";
+    "1w": "1w";
+    "1M": "1M";
+}>;
+/**
+ * Timestamp validation (milliseconds since epoch)
+ *
+ * Validates that the timestamp is:
+ * - A positive integer
+ * - At least Jan 1, 2000 (catches seconds vs milliseconds errors)
+ * - Within JavaScript's safe integer range
+ * - Not unreasonably far in the future (max 1 year ahead)
+ *
+ * **Why these bounds matter:**
+ * - Prevents typos (e.g., using seconds instead of milliseconds: 1609459200 vs 1609459200000)
+ * - Catches date calculation errors (e.g., Date.now() * 1000 instead of Date.now())
+ * - Ensures timestamps won't cause precision issues in JavaScript
+ *
+ * @example
+ * ```typescript
+ * // Valid timestamps (milliseconds)
+ * validate(TimestampSchema, 1609459200000);  // Jan 1, 2021 ✅
+ * validate(TimestampSchema, Date.now());      // Current time ✅
+ * validate(TimestampSchema, Date.now() + 86400000);  // Tomorrow ✅
+ *
+ * // Invalid timestamps
+ * validate(TimestampSchema, 1609459200);      // Seconds instead of ms (Jan 19, 1970) ❌
+ * validate(TimestampSchema, Date.now() * 1000);  // Way too large ❌
+ * validate(TimestampSchema, 9999999999999999);   // Far future (year 2286) ❌
+ * validate(TimestampSchema, 100000);          // Too old (Jan 1, 1970) ❌
+ * ```
+ */
+export declare const TimestampSchema: z.ZodNumber;
+/**
+ * Get Candlesticks validation schema (by trading pair ID)
+ *
+ * Validates parameters for fetching candlestick (OHLCV) data using a trading pair UUID.
+ * Ensures that the time range is valid by checking that startTime < endTime.
+ *
+ * @example
+ * ```typescript
+ * // Valid request
+ * validate(GetCandlesticksSchema, {
+ *   tradingPairId: "123e4567-e89b-12d3-a456-426614174000",
+ *   interval: "1h",
+ *   startTime: 1609459200000,  // Jan 1, 2021
+ *   endTime: 1640995200000      // Jan 1, 2022
+ * });
+ *
+ * // Invalid: backwards time range
+ * validate(GetCandlesticksSchema, {
+ *   tradingPairId: "123e4567-e89b-12d3-a456-426614174000",
+ *   interval: "1h",
+ *   startTime: 1640995200000,  // Jan 1, 2022
+ *   endTime: 1609459200000      // Jan 1, 2021
+ * });
+ * // ValidationError: startTime must be less than endTime
+ * ```
+ */
+export declare const GetCandlesticksSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+    interval: z.ZodEnum<{
+        "1m": "1m";
+        "5m": "5m";
+        "15m": "15m";
+        "30m": "30m";
+        "1h": "1h";
+        "4h": "4h";
+        "1d": "1d";
+        "1w": "1w";
+        "1M": "1M";
+    }>;
+    startTime: z.ZodNumber;
+    endTime: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Trading pair symbol validation
+ *
+ * Validates trading pair symbols like "BTC/USDT", "ETH/USD", etc.
+ * Symbol format: BASE/QUOTE where:
+ * - BASE and QUOTE are 1-10 alphanumeric characters
+ * - Separated by a forward slash
+ *
+ * @example
+ * ```typescript
+ * // Valid symbols
+ * validate(TradingPairSymbolSchema, "BTC/USDT");   ✅
+ * validate(TradingPairSymbolSchema, "ETH/USD");    ✅
+ * validate(TradingPairSymbolSchema, "MTK/USDCo");  ✅
+ *
+ * // Invalid symbols
+ * validate(TradingPairSymbolSchema, "BTC");        ❌ Missing quote token
+ * validate(TradingPairSymbolSchema, "BTC-USDT");   ❌ Wrong separator
+ * validate(TradingPairSymbolSchema, "/USDT");      ❌ Missing base token
+ * ```
+ */
+export declare const TradingPairSymbolSchema: z.ZodString;
+/**
+ * Candlestick limit validation
+ *
+ * Validates the limit parameter for candlestick queries:
+ * - Must be a positive integer
+ * - Maximum of 500 bars per request
+ * - Server defaults to 350 if not specified
+ */
+export declare const CandlestickLimitSchema: z.ZodOptional<z.ZodNumber>;
+/**
+ * Get Candlesticks By Trading Pair ID validation schema
+ *
+ * Validates parameters for fetching candlestick (OHLCV) data using a trading pair UUID.
+ * All time parameters are optional and can be used independently:
+ * - Use `endTime` + `limit` for backward pagination (TradingView primary pattern)
+ * - Use `startTime` + `limit` for forward pagination
+ * - Use just `limit` for most recent bars
+ * - Use `startTime` + `endTime` + `limit` for a specific range (capped at limit)
+ *
+ * @example
+ * ```typescript
+ * // Get 350 most recent bars
+ * validate(GetCandlesticksByPairIdSchema, {
+ *   tradingPairId: "123e4567-e89b-12d3-a456-426614174000",
+ *   interval: "1h",
+ *   limit: 350
+ * });
+ *
+ * // Backward pagination (TradingView pattern)
+ * validate(GetCandlesticksByPairIdSchema, {
+ *   tradingPairId: "123e4567-e89b-12d3-a456-426614174000",
+ *   interval: "1h",
+ *   endTime: 1640995200000,
+ *   limit: 350
+ * });
+ *
+ * // Specific range
+ * validate(GetCandlesticksByPairIdSchema, {
+ *   tradingPairId: "123e4567-e89b-12d3-a456-426614174000",
+ *   interval: "1h",
+ *   startTime: 1609459200000,
+ *   endTime: 1640995200000,
+ *   limit: 350
+ * });
+ * ```
+ */
+export declare const GetCandlesticksByPairIdSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+    interval: z.ZodEnum<{
+        "1m": "1m";
+        "5m": "5m";
+        "15m": "15m";
+        "30m": "30m";
+        "1h": "1h";
+        "4h": "4h";
+        "1d": "1d";
+        "1w": "1w";
+        "1M": "1M";
+    }>;
+    startTime: z.ZodOptional<z.ZodNumber>;
+    endTime: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * @deprecated Use GetCandlesticksByPairIdSchema instead. Symbol-based lookups are no longer supported.
+ */
+export declare const GetCandlesticksBySymbolSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+    interval: z.ZodEnum<{
+        "1m": "1m";
+        "5m": "5m";
+        "15m": "15m";
+        "30m": "30m";
+        "1h": "1h";
+        "4h": "4h";
+        "1d": "1d";
+        "1w": "1w";
+        "1M": "1M";
+    }>;
+    startTime: z.ZodOptional<z.ZodNumber>;
+    endTime: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Get Trading Pair validation schema
+ */
+export declare const GetTradingPairSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Search Trading Pairs validation schema
+ */
+export declare const SearchTradingPairsSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Get Market Metadata validation schema
+ */
+export declare const GetMarketMetadataSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=market.d.ts.map

package/dist/validation/market.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"market.d.ts","sourceRoot":"","sources":["../../src/validation/market.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;EAEzB,CAAC;AAkBH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,eAAe,aAcxB,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;iBAU9B,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,uBAAuB,aAKhC,CAAC;AAEL;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,4BAKtB,CAAC;AAEd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;iBAoBvC,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;iBAAgC,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;iBAInC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;iBAElC,CAAC"}

package/dist/validation/market.js

@@ -0,0 +1,226 @@
+/**
+ * Market API Validation Schemas
+ */
+import { z } from "zod";
+import { UUIDSchema } from "./trading";
+/**
+ * Candlestick interval validation
+ */
+export const IntervalSchema = z.enum(["1m", "5m", "15m", "30m", "1h", "4h", "1d", "1w", "1M"], {
+    message: 'Interval must be one of: "1m", "5m", "15m", "30m", "1h", "4h", "1d", "1w", "1M"',
+});
+/**
+ * Maximum allowed future offset for timestamps (1 year in milliseconds)
+ *
+ * Allows queries for future dates (e.g., for scheduling or filtering) but
+ * prevents unreasonably far future dates that are likely input errors.
+ */
+const MAX_TIMESTAMP_FUTURE_OFFSET_MS = 365 * 24 * 60 * 60 * 1000; // 1 year
+/**
+ * Minimum allowed timestamp (Jan 1, 2000 in milliseconds)
+ *
+ * This catches the common error of passing timestamps in seconds instead of milliseconds.
+ * Any timestamp before year 2000 is likely an error (either seconds or invalid date).
+ */
+const MIN_TIMESTAMP_MS = 946684800000; // Jan 1, 2000 00:00:00 UTC
+/**
+ * Timestamp validation (milliseconds since epoch)
+ *
+ * Validates that the timestamp is:
+ * - A positive integer
+ * - At least Jan 1, 2000 (catches seconds vs milliseconds errors)
+ * - Within JavaScript's safe integer range
+ * - Not unreasonably far in the future (max 1 year ahead)
+ *
+ * **Why these bounds matter:**
+ * - Prevents typos (e.g., using seconds instead of milliseconds: 1609459200 vs 1609459200000)
+ * - Catches date calculation errors (e.g., Date.now() * 1000 instead of Date.now())
+ * - Ensures timestamps won't cause precision issues in JavaScript
+ *
+ * @example
+ * ```typescript
+ * // Valid timestamps (milliseconds)
+ * validate(TimestampSchema, 1609459200000);  // Jan 1, 2021 ✅
+ * validate(TimestampSchema, Date.now());      // Current time ✅
+ * validate(TimestampSchema, Date.now() + 86400000);  // Tomorrow ✅
+ *
+ * // Invalid timestamps
+ * validate(TimestampSchema, 1609459200);      // Seconds instead of ms (Jan 19, 1970) ❌
+ * validate(TimestampSchema, Date.now() * 1000);  // Way too large ❌
+ * validate(TimestampSchema, 9999999999999999);   // Far future (year 2286) ❌
+ * validate(TimestampSchema, 100000);          // Too old (Jan 1, 1970) ❌
+ * ```
+ */
+export const TimestampSchema = z
+    .number()
+    .int()
+    .positive({
+    message: "Timestamp must be a positive integer (milliseconds since epoch)",
+})
+    .min(MIN_TIMESTAMP_MS, {
+    message: "Timestamp must be at least Jan 1, 2000 (946684800000 ms). Did you pass seconds instead of milliseconds?",
+})
+    .max(Number.MAX_SAFE_INTEGER, {
+    message: "Timestamp must not exceed JavaScript's maximum safe integer",
+})
+    .refine((value) => value <= Date.now() + MAX_TIMESTAMP_FUTURE_OFFSET_MS, {
+    message: "Timestamp must not be unreasonably far in the future (max 1 year ahead)",
+});
+/**
+ * Get Candlesticks validation schema (by trading pair ID)
+ *
+ * Validates parameters for fetching candlestick (OHLCV) data using a trading pair UUID.
+ * Ensures that the time range is valid by checking that startTime < endTime.
+ *
+ * @example
+ * ```typescript
+ * // Valid request
+ * validate(GetCandlesticksSchema, {
+ *   tradingPairId: "123e4567-e89b-12d3-a456-426614174000",
+ *   interval: "1h",
+ *   startTime: 1609459200000,  // Jan 1, 2021
+ *   endTime: 1640995200000      // Jan 1, 2022
+ * });
+ *
+ * // Invalid: backwards time range
+ * validate(GetCandlesticksSchema, {
+ *   tradingPairId: "123e4567-e89b-12d3-a456-426614174000",
+ *   interval: "1h",
+ *   startTime: 1640995200000,  // Jan 1, 2022
+ *   endTime: 1609459200000      // Jan 1, 2021
+ * });
+ * // ValidationError: startTime must be less than endTime
+ * ```
+ */
+export const GetCandlesticksSchema = z
+    .object({
+    tradingPairId: UUIDSchema,
+    interval: IntervalSchema,
+    startTime: TimestampSchema,
+    endTime: TimestampSchema,
+})
+    .refine((data) => data.startTime < data.endTime, {
+    message: "startTime must be less than endTime",
+    path: ["endTime"],
+});
+/**
+ * Trading pair symbol validation
+ *
+ * Validates trading pair symbols like "BTC/USDT", "ETH/USD", etc.
+ * Symbol format: BASE/QUOTE where:
+ * - BASE and QUOTE are 1-10 alphanumeric characters
+ * - Separated by a forward slash
+ *
+ * @example
+ * ```typescript
+ * // Valid symbols
+ * validate(TradingPairSymbolSchema, "BTC/USDT");   ✅
+ * validate(TradingPairSymbolSchema, "ETH/USD");    ✅
+ * validate(TradingPairSymbolSchema, "MTK/USDCo");  ✅
+ *
+ * // Invalid symbols
+ * validate(TradingPairSymbolSchema, "BTC");        ❌ Missing quote token
+ * validate(TradingPairSymbolSchema, "BTC-USDT");   ❌ Wrong separator
+ * validate(TradingPairSymbolSchema, "/USDT");      ❌ Missing base token
+ * ```
+ */
+export const TradingPairSymbolSchema = z
+    .string()
+    .min(1, "Trading pair symbol cannot be empty")
+    .regex(/^[A-Za-z0-9]{1,10}\/[A-Za-z0-9]{1,10}$/, {
+    message: 'Trading pair symbol must be in format "BASE/QUOTE" (e.g., "BTC/USDT", "ETH/USD")',
+});
+/**
+ * Candlestick limit validation
+ *
+ * Validates the limit parameter for candlestick queries:
+ * - Must be a positive integer
+ * - Maximum of 500 bars per request
+ * - Server defaults to 350 if not specified
+ */
+export const CandlestickLimitSchema = z
+    .number()
+    .int()
+    .positive({ message: "Limit must be a positive integer" })
+    .max(500, { message: "Limit cannot exceed 500 bars per request" })
+    .optional();
+/**
+ * Get Candlesticks By Trading Pair ID validation schema
+ *
+ * Validates parameters for fetching candlestick (OHLCV) data using a trading pair UUID.
+ * All time parameters are optional and can be used independently:
+ * - Use `endTime` + `limit` for backward pagination (TradingView primary pattern)
+ * - Use `startTime` + `limit` for forward pagination
+ * - Use just `limit` for most recent bars
+ * - Use `startTime` + `endTime` + `limit` for a specific range (capped at limit)
+ *
+ * @example
+ * ```typescript
+ * // Get 350 most recent bars
+ * validate(GetCandlesticksByPairIdSchema, {
+ *   tradingPairId: "123e4567-e89b-12d3-a456-426614174000",
+ *   interval: "1h",
+ *   limit: 350
+ * });
+ *
+ * // Backward pagination (TradingView pattern)
+ * validate(GetCandlesticksByPairIdSchema, {
+ *   tradingPairId: "123e4567-e89b-12d3-a456-426614174000",
+ *   interval: "1h",
+ *   endTime: 1640995200000,
+ *   limit: 350
+ * });
+ *
+ * // Specific range
+ * validate(GetCandlesticksByPairIdSchema, {
+ *   tradingPairId: "123e4567-e89b-12d3-a456-426614174000",
+ *   interval: "1h",
+ *   startTime: 1609459200000,
+ *   endTime: 1640995200000,
+ *   limit: 350
+ * });
+ * ```
+ */
+export const GetCandlesticksByPairIdSchema = z
+    .object({
+    tradingPairId: UUIDSchema,
+    interval: IntervalSchema,
+    startTime: TimestampSchema.optional(),
+    endTime: TimestampSchema.optional(),
+    limit: CandlestickLimitSchema,
+})
+    .refine((data) => {
+    // Only validate startTime < endTime if both are provided
+    if (data.startTime !== undefined && data.endTime !== undefined) {
+        return data.startTime < data.endTime;
+    }
+    return true;
+}, {
+    message: "startTime must be less than endTime",
+    path: ["endTime"],
+});
+/**
+ * @deprecated Use GetCandlesticksByPairIdSchema instead. Symbol-based lookups are no longer supported.
+ */
+export const GetCandlesticksBySymbolSchema = GetCandlesticksByPairIdSchema;
+/**
+ * Get Trading Pair validation schema
+ */
+export const GetTradingPairSchema = z.object({
+    tradingPairId: UUIDSchema,
+});
+/**
+ * Search Trading Pairs validation schema
+ */
+export const SearchTradingPairsSchema = z.object({
+    query: z.string().min(1, "Search query cannot be empty").optional(),
+    limit: z.number().int().min(1).max(100).optional(),
+    offset: z.number().int().min(0).optional(),
+});
+/**
+ * Get Market Metadata validation schema
+ */
+export const GetMarketMetadataSchema = z.object({
+    tradingPairId: UUIDSchema,
+});
+//# sourceMappingURL=market.js.map

package/dist/validation/market.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"market.js","sourceRoot":"","sources":["../../src/validation/market.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;IAC7F,OAAO,EAAE,iFAAiF;CAC3F,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,8BAA8B,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,SAAS;AAE3E;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG,YAAY,CAAC,CAAC,2BAA2B;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,EAAE;KACR,GAAG,EAAE;KACL,QAAQ,CAAC;IACR,OAAO,EAAE,iEAAiE;CAC3E,CAAC;KACD,GAAG,CAAC,gBAAgB,EAAE;IACrB,OAAO,EAAE,yGAAyG;CACnH,CAAC;KACD,GAAG,CAAC,MAAM,CAAC,gBAAgB,EAAE;IAC5B,OAAO,EAAE,6DAA6D;CACvE,CAAC;KACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,8BAA8B,EAAE;IACvE,OAAO,EAAE,yEAAyE;CACnF,CAAC,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe;IAC1B,OAAO,EAAE,eAAe;CACzB,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE;IAC/C,OAAO,EAAE,qCAAqC;IAC9C,IAAI,EAAE,CAAC,SAAS,CAAC;CAClB,CAAC,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,EAAE,qCAAqC,CAAC;KAC7C,KAAK,CAAC,wCAAwC,EAAE;IAC/C,OAAO,EAAE,kFAAkF;CAC5F,CAAC,CAAC;AAEL;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,EAAE;KACR,GAAG,EAAE;KACL,QAAQ,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;KACzD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;KACjE,QAAQ,EAAE,CAAC;AAEd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC;KAC3C,MAAM,CAAC;IACN,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe,CAAC,QAAQ,EAAE;IACrC,OAAO,EAAE,eAAe,CAAC,QAAQ,EAAE;IACnC,KAAK,EAAE,sBAAsB;CAC9B,CAAC;KACD,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,yDAAyD;IACzD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,EACD;IACE,OAAO,EAAE,qCAAqC;IAC9C,IAAI,EAAE,CAAC,SAAS,CAAC;CAClB,CACF,CAAC;AAEJ;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,6BAA6B,CAAC;AAE3E;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,aAAa,EAAE,UAAU;CAC1B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,8BAA8B,CAAC,CAAC,QAAQ,EAAE;IACnE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,UAAU;CAC1B,CAAC,CAAC"}

package/dist/validation/trading.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Trading API Validation Schemas
+ *
+ * Zod schemas for validating trading API inputs before making requests.
+ * Provides clear, actionable error messages for invalid parameters.
+ */
+import { z } from "zod";
+/**
+ * Order side validation
+ */
+export declare const OrderSideSchema: z.ZodEnum<{
+    BUY: "BUY";
+    SELL: "SELL";
+}>;
+/**
+ * Trading mode validation
+ */
+export declare const TradingModeSchema: z.ZodEnum<{
+    SPOT: "SPOT";
+    MARGIN: "MARGIN";
+}>;
+/**
+ * Time in force validation
+ */
+export declare const TimeInForceSchema: z.ZodEnum<{
+    GTC: "GTC";
+    IOC: "IOC";
+    FOK: "FOK";
+}>;
+/**
+ * Positive decimal string validation (for quantities and prices)
+ */
+export declare const PositiveDecimalStringSchema: z.ZodString;
+/**
+ * Non-negative decimal string validation (allows 0)
+ */
+export declare const NonNegativeDecimalStringSchema: z.ZodString;
+/**
+ * UUID validation
+ */
+export declare const UUIDSchema: z.ZodString;
+/**
+ * ISO 8601 date string validation
+ */
+export declare const ISO8601DateSchema: z.ZodString;
+/**
+ * Slippage tolerance validation (0 to 1, where 0.01 = 1%)
+ */
+export declare const SlippageToleranceSchema: z.ZodOptional<z.ZodNumber>;
+/**
+ * Place Limit Order validation schema
+ */
+export declare const PlaceLimitOrderSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+    side: z.ZodEnum<{
+        BUY: "BUY";
+        SELL: "SELL";
+    }>;
+    quantity: z.ZodString;
+    price: z.ZodString;
+    options: z.ZodOptional<z.ZodObject<{
+        tradingMode: z.ZodOptional<z.ZodEnum<{
+            SPOT: "SPOT";
+            MARGIN: "MARGIN";
+        }>>;
+        useMasterBalance: z.ZodOptional<z.ZodBoolean>;
+        expirationDate: z.ZodOptional<z.ZodString>;
+        timeInForce: z.ZodOptional<z.ZodEnum<{
+            GTC: "GTC";
+            IOC: "IOC";
+            FOK: "FOK";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Place Market Order validation schema
+ */
+export declare const PlaceMarketOrderSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+    side: z.ZodEnum<{
+        BUY: "BUY";
+        SELL: "SELL";
+    }>;
+    quantity: z.ZodString;
+    options: z.ZodOptional<z.ZodObject<{
+        tradingMode: z.ZodOptional<z.ZodEnum<{
+            SPOT: "SPOT";
+            MARGIN: "MARGIN";
+        }>>;
+        slippageTolerance: z.ZodOptional<z.ZodNumber>;
+        timeInForce: z.ZodOptional<z.ZodEnum<{
+            GTC: "GTC";
+            IOC: "IOC";
+            FOK: "FOK";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Cancel Order validation schema
+ */
+export declare const CancelOrderSchema: z.ZodObject<{
+    orderId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Replace Order validation schema
+ *
+ * Validates parameters for replacing an existing order.
+ * Matches the replaceOrder method signature which accepts:
+ * - orderId: string (UUID)
+ * - newOrder: { price?: string, quantity?: string, useMasterBalance?: boolean }
+ */
+export declare const ReplaceOrderSchema: z.ZodObject<{
+    orderId: z.ZodString;
+    newOrder: z.ZodObject<{
+        price: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodOptional<z.ZodString>;
+        useMasterBalance: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Get Paginated Orders validation schema
+ *
+ * Validates parameters for fetching paginated orders.
+ * Status field accepts all valid OrderStatus values for comprehensive filtering.
+ */
+export declare const GetOrdersSchema: z.ZodObject<{
+    tradingPairId: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodObject<{
+        status: z.ZodOptional<z.ZodEnum<{
+            PENDING: "PENDING";
+            SUBMITTED: "SUBMITTED";
+            ACKNOWLEDGED: "ACKNOWLEDGED";
+            PARTIALLY_FILLED: "PARTIALLY_FILLED";
+            FILLED: "FILLED";
+            SETTLED: "SETTLED";
+            CANCELLED: "CANCELLED";
+            REJECTED: "REJECTED";
+            EXPIRED: "EXPIRED";
+        }>>;
+        side: z.ZodOptional<z.ZodEnum<{
+            BUY: "BUY";
+            SELL: "SELL";
+        }>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+//# sourceMappingURL=trading.d.ts.map

package/dist/validation/trading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trading.d.ts","sourceRoot":"","sources":["../../src/validation/trading.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,eAAe;;;EAE1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;EAE5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;EAE5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,2BAA2B,aAOpC,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,8BAA8B,aAOvC,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,UAAU,aAErB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,aAE5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB,4BAIvB,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;iBAahC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;iBAWjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;iBAE5B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB;;;;;;;iBAO7B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;iBAU1B,CAAC"}