@pear-protocol/types 1.24.0 → 1.25.0

package/dist/auth/api-keys.js

@@ -1,11 +1,16 @@
 import { z } from 'zod';
 
-const ApiKeyScope = z.enum(["read", "read_write"]).describe("API key access scope");
+const ApiKeyScope = z.enum([
+  "read",
+  "read_write"
+]).describe("API key access scope");
 const CreateApiKeyInput = z.object({
   label: z.string().trim().min(1, "Label is required").max(100).describe("Human label for the key"),
   scope: ApiKeyScope.default("read"),
   /** ISO-8601 datetime; omit for a key that never expires. */
-  expiresAt: z.iso.datetime({ offset: true }).optional().describe("Optional expiry (ISO-8601)")
+  expiresAt: z.iso.datetime({
+    offset: true
+  }).optional().describe("Optional expiry (ISO-8601)")
 }).describe("Create a new API key");
 const CreateApiKeyOutput = z.object({
   id: z.uuid(),
@@ -27,7 +32,10 @@ const ApiKeySummary = z.object({
 const ListApiKeysOutput = z.array(ApiKeySummary).describe("All API keys for the user");
 const ApiKeyMeResponse = z.object({
   id: z.uuid().describe("User UUID that owns the API key"),
-  role: z.enum(["basic", "pro"]).describe("User role"),
+  role: z.enum([
+    "basic",
+    "pro"
+  ]).describe("User role"),
   scope: ApiKeyScope,
   authMethod: z.literal("api_key")
 }).describe("Identity of the caller authenticated via an API key");

package/dist/auth/entities.js

@@ -1,9 +1,17 @@
 import { z } from 'zod';
 
-const LoginMethod = z.enum(["email", "evm_wallet", "oauth", "x"]).describe("Authentication provider used for the current session");
+const LoginMethod = z.enum([
+  "email",
+  "evm_wallet",
+  "oauth",
+  "x"
+]).describe("Authentication provider used for the current session");
 const AuthenticatedUser = z.object({
   id: z.uuid().describe("User UUID"),
-  role: z.enum(["basic", "pro"]).describe("User role"),
+  role: z.enum([
+    "basic",
+    "pro"
+  ]).describe("User role"),
   providerId: z.string().nullable().describe("Provider identifier (wallet address or email)"),
   loginMethod: LoginMethod.describe("Authentication provider used for the current session")
 }).describe("Current authenticated user info");

package/dist/auth/payloads.d.ts

@@ -20,6 +20,12 @@ export declare const StartXLinkRequest: z.ZodObject<{
 }, z.core.$strip>;
 export declare const StartXLoginRequest: z.ZodObject<{
     returnTo: z.ZodOptional<z.ZodString>;
+    handoffId: z.ZodString;
+    handoffChallenge: z.ZodString;
+}, z.core.$strip>;
+export declare const ExchangeXLoginRequest: z.ZodObject<{
+    ticket: z.ZodString;
+    handoffVerifier: z.ZodString;
 }, z.core.$strip>;
 export declare const WalletLoginRequest: z.ZodObject<{
     method: z.ZodLiteral<"wallet">;
@@ -78,6 +84,7 @@ export type LinkEmailRequest = z.infer<typeof LinkEmailRequest>;
 export type LinkWalletRequest = z.infer<typeof LinkWalletRequest>;
 export type StartXLinkRequest = z.infer<typeof StartXLinkRequest>;
 export type StartXLoginRequest = z.infer<typeof StartXLoginRequest>;
+export type ExchangeXLoginRequest = z.infer<typeof ExchangeXLoginRequest>;
 export type EmailLoginRequest = z.infer<typeof EmailLoginRequest>;
 export type LoginRequest = z.infer<typeof LoginRequest>;
 export type RefreshTokenRequest = z.infer<typeof RefreshTokenRequest>;

package/dist/auth/payloads.js

@@ -22,15 +22,18 @@ const LinkWalletRequest = z.object({
   nonce: SignedNonce
 }).describe("Link wallet credentials to the authenticated account");
 const StartXLinkRequest = z.object({
-  returnTo: z.string().optional().describe(
-    "Page to send the browser back to once the link finishes, normally the page the user is on. Must be on the calling origin; defaults to that origin."
-  )
+  returnTo: z.string().optional().describe("Page to send the browser back to once the link finishes, normally the page the user is on. Must be on the calling origin; defaults to that origin.")
 }).describe("Start of the X account link flow");
+const PkceValue = z.string().regex(/^[A-Za-z0-9_-]{43}$/, "Must be 43 base64url characters");
 const StartXLoginRequest = z.object({
-  returnTo: z.string().optional().describe(
-    "Page to send the browser back to once the sign-in finishes, normally the page the user is on. Must be on the calling origin; defaults to that origin."
-  )
+  returnTo: z.string().optional().describe("Page to send the browser back to once the sign-in finishes, normally the page the user is on. Must be on the calling origin; defaults to that origin. Any fragment is dropped - the flow returns its ticket there."),
+  handoffId: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/, "Must be 1-64 URL-safe characters").describe("Names this sign-in attempt. Echoed back on the return URL so a browser that started more than one knows which secret this outcome belongs to."),
+  handoffChallenge: PkceValue.describe("Base64url SHA-256 of a random verifier this browser keeps. The finished sign-in is redeemed by presenting that verifier, so only the browser that started the flow can collect it.")
 }).describe("Start of the X sign-in flow");
+const ExchangeXLoginRequest = z.object({
+  ticket: z.string().min(1, "Ticket is required").describe("Single-use ticket from the return URL fragment"),
+  handoffVerifier: PkceValue.describe("The verifier whose challenge started this sign-in")
+}).describe("Redemption of a finished X sign-in for a session");
 const WalletLoginRequest = z.object({
   method: z.literal("wallet").describe('Must be "wallet" for wallet authentication'),
   address: EthereumAddress,
@@ -58,7 +61,10 @@ const ResetPasswordRequest = z.object({
   token: z.string().min(1, "Token is required").describe("Password reset token"),
   password: Password.describe("New password to set")
 }).describe("Reset password using a password reset token");
-const LoginRequest = z.discriminatedUnion("method", [WalletLoginRequest, EmailLoginRequest]);
+const LoginRequest = z.discriminatedUnion("method", [
+  WalletLoginRequest,
+  EmailLoginRequest
+]);
 const RefreshTokenRequest = z.object({
   refreshToken: z.string().min(1, "Refresh token is required").describe("Refresh token")
 }).describe("Refresh token request");
@@ -69,9 +75,7 @@ const LogoutRequest = z.object({
   refreshToken: z.string().min(1, "Refresh token is required").describe("Refresh token to revoke")
 }).describe("Logout and revoke refresh token");
 const OauthInteractionConfirmRequest = z.object({
-  scopes: z.array(z.string()).default([]).describe(
-    "The scope set the user granted at consent (opaque to the AS; empty resolves to the read-only fail-safe)"
-  )
+  scopes: z.array(z.string()).default([]).describe("The scope set the user granted at consent (opaque to the AS; empty resolves to the read-only fail-safe)")
 }).describe("Consent confirmation body \u2014 the granted scope set");
 
-export { ChangePasswordRequest, EmailLoginRequest, EmailRegisterRequest, ForgotPasswordRequest, LinkEmailRequest, LinkWalletRequest, LoginRequest, LogoutRequest, OauthInteractionConfirmRequest, RefreshTokenRequest, RequestNonceRequest, ResendVerificationForRegisterRequest, ResetPasswordRequest, StartXLinkRequest, StartXLoginRequest, VerifyEmailRequest, WalletLoginRequest };
+export { ChangePasswordRequest, EmailLoginRequest, EmailRegisterRequest, ExchangeXLoginRequest, ForgotPasswordRequest, LinkEmailRequest, LinkWalletRequest, LoginRequest, LogoutRequest, OauthInteractionConfirmRequest, RefreshTokenRequest, RequestNonceRequest, ResendVerificationForRegisterRequest, ResetPasswordRequest, StartXLinkRequest, StartXLoginRequest, VerifyEmailRequest, WalletLoginRequest };

package/dist/auth/response.js

@@ -26,7 +26,10 @@ const ResetPasswordResponse = z.void().describe("Successful password reset respo
 const VerifyEmailResponse = z.object({
   verified: z.literal(true).describe("Always true; the claim behind the token is now verified"),
   email: z.string().describe("Email address the verified claim belongs to"),
-  flow: z.enum(["register", "link"]).describe("Claim flow the token was issued for"),
+  flow: z.enum([
+    "register",
+    "link"
+  ]).describe("Claim flow the token was issued for"),
   verifiedAt: z.string().describe("ISO-8601 timestamp of when the claim was verified")
 }).describe("Successful email verification response");
 const LinkEmailResponse = z.void().describe("Successful email verification response");

package/dist/common/array.js

@@ -1,10 +1,17 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 function normalizeArray(val) {
   if (!val) return void 0;
   if (Array.isArray(val)) return val;
   if (typeof val === "string") {
-    return val.includes(",") ? val.split(",").map((s) => s.trim()) : [val];
+    return val.includes(",") ? val.split(",").map((s) => s.trim()) : [
+      val
+    ];
   }
-  return [String(val)];
+  return [
+    String(val)
+  ];
 }
+__name(normalizeArray, "normalizeArray");
 
 export { normalizeArray };

package/dist/common/refinement.js

@@ -1,52 +1,58 @@
-import 'zod';
-
-const RefineMinimumOneSymbol = (basket, ctx) => {
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const RefineMinimumOneSymbol = /* @__PURE__ */ __name((basket, ctx) => {
   if (basket.length < 1) {
     ctx.addIssue({
       code: "custom",
       message: "At least one symbol is required."
     });
   }
-};
-const RefineMinimumTwoSymbols = (basket, ctx) => {
+}, "RefineMinimumOneSymbol");
+const RefineMinimumTwoSymbols = /* @__PURE__ */ __name((basket, ctx) => {
   if (basket.length < 2) {
     ctx.addIssue({
       code: "custom",
       message: "At least two symbols are required."
     });
   }
-};
-const RefineTwoUniqueSymbols = (pair, ctx) => {
+}, "RefineMinimumTwoSymbols");
+const RefineTwoUniqueSymbols = /* @__PURE__ */ __name((pair, ctx) => {
   if (pair.symbol_a === pair.symbol_b) {
     ctx.addIssue({
       code: "custom",
       message: "Symbols cannot be the same."
     });
   }
-};
-const RefineUniqueSymbols = (basket, ctx) => {
+}, "RefineTwoUniqueSymbols");
+const RefineUniqueSymbols = /* @__PURE__ */ __name((basket, ctx) => {
   const symbols = basket.map((item) => item.symbol);
   const uniqueSymbols = new Set(symbols);
   if (symbols.length !== uniqueSymbols.size) {
     const duplicates = symbols.filter((symbol, index) => symbols.indexOf(symbol) !== index);
     ctx.addIssue({
       code: "custom",
-      message: `Duplicate symbols found: ${[...new Set(duplicates)].join(", ")}`,
-      path: ["basket"]
+      message: `Duplicate symbols found: ${[
+        ...new Set(duplicates)
+      ].join(", ")}`,
+      path: [
+        "basket"
+      ]
     });
   }
-};
-const RefineWeightingSum = (basket, ctx) => {
+}, "RefineUniqueSymbols");
+const RefineWeightingSum = /* @__PURE__ */ __name((basket, ctx) => {
   const totalWeight = basket.reduce((acc, curr) => acc + curr.weight, 0);
   if (Math.abs(totalWeight - 1) > 1e-9) {
     ctx.addIssue({
       code: "custom",
       message: `The sum of weights must be exactly 1, but got ${totalWeight}`,
-      path: ["basket"]
+      path: [
+        "basket"
+      ]
     });
   }
-};
-const RefineMinimumOneBuyOneSell = (basket, ctx) => {
+}, "RefineWeightingSum");
+const RefineMinimumOneBuyOneSell = /* @__PURE__ */ __name((basket, ctx) => {
   const buyCount = basket.filter((item) => item.side === "BUY").length;
   const sellCount = basket.filter((item) => item.side === "SELL").length;
   if (buyCount < 1 || sellCount < 1) {
@@ -55,14 +61,14 @@ const RefineMinimumOneBuyOneSell = (basket, ctx) => {
       message: "At least one BUY and one SELL are required."
     });
   }
-};
-const RefineMinimumOneKeyValuePair = (data, ctx) => {
+}, "RefineMinimumOneBuyOneSell");
+const RefineMinimumOneKeyValuePair = /* @__PURE__ */ __name((data, ctx) => {
   if (Object.keys(data).length < 1) {
     ctx.addIssue({
       code: "custom",
       message: "Empty object is not allowed."
     });
   }
-};
+}, "RefineMinimumOneKeyValuePair");
 
 export { RefineMinimumOneBuyOneSell, RefineMinimumOneKeyValuePair, RefineMinimumOneSymbol, RefineMinimumTwoSymbols, RefineTwoUniqueSymbols, RefineUniqueSymbols, RefineWeightingSum };

package/dist/common/request.js

@@ -2,22 +2,22 @@ import { z } from 'zod';
 
 const CursorFindParams = z.object({
   /**
-   * The maximum number of items to retrieve.
-   */
+  * The maximum number of items to retrieve.
+  */
   limit: z.coerce.number().int().positive().max(2e3).optional().default(20),
   /**
-   * Opaque pagination cursor returned by the API.
-   */
+  * Opaque pagination cursor returned by the API.
+  */
   cursor: z.string().optional()
 });
 const PaginationFindParams = z.object({
   /**
-   * The maximum number of items to retrieve.
-   */
+  * The maximum number of items to retrieve.
+  */
   limit: z.coerce.number().int().positive().max(100).optional().default(20),
   /**
-   * The number of items to skip before retrieving the returned items.
-   */
+  * The number of items to skip before retrieving the returned items.
+  */
   offset: z.coerce.number().int().min(0).optional().default(0)
 });
 

package/dist/common/response.js

@@ -2,26 +2,26 @@ import { z } from 'zod';
 
 const PaginatedResponse = z.object({
   /**
-   * The maximum number of items retrieved.
-   */
+  * The maximum number of items retrieved.
+  */
   limit: z.number(),
   /**
-   * The number of items to skip before retrieving the returned items.
-   */
+  * The number of items to skip before retrieving the returned items.
+  */
   offset: z.number(),
   /**
-   * The total number of items.
-   */
+  * The total number of items.
+  */
   count: z.number()
 });
 const CursorResponse = z.object({
   /**
-   * The maximum number of items retrieved.
-   */
+  * The maximum number of items retrieved.
+  */
   limit: z.number(),
   /**
-   * The cursor to use for pagination.
-   */
+  * The cursor to use for pagination.
+  */
   nextCursor: z.string().optional()
 });
 

package/dist/common/schema.js

@@ -2,9 +2,16 @@ import z from 'zod';
 
 const UnsignedDecimalString = z.string().regex(/^\d+(\.\d+)?$/, "Must be a valid decimal string");
 const SignedDecimalString = z.string().regex(/^[+-]\d+(\.\d+)?$/, "Must be a valid signed decimal string").transform((val) => val);
-const Side = z.enum(["BUY", "SELL"], {
+const Side = z.enum([
+  "BUY",
+  "SELL"
+], {
   message: "Side must be either BUY or SELL"
 });
-const AssetWeight = z.number().positive({ message: "Weight must be greater than 0" }).max(1, { message: "Weight must be less than 1" });
+const AssetWeight = z.number().positive({
+  message: "Weight must be greater than 0"
+}).max(1, {
+  message: "Weight must be less than 1"
+});
 
 export { AssetWeight, Side, SignedDecimalString, UnsignedDecimalString };

package/dist/common/trade-legs.js

@@ -2,29 +2,34 @@ import { z } from 'zod';
 import { InstrumentId } from '../instrument';
 import { UnsignedDecimalString, Side } from './schema';
 
-const TradeLegMode = z.enum(["QUANTITY", "USD"]);
+const TradeLegMode = z.enum([
+  "QUANTITY",
+  "USD"
+]);
 const TradeLeg = z.object({
   /**
-   * Instrument ID
-   */
+  * Instrument ID
+  */
   symbol: InstrumentId,
   /**
-   * Side
-   */
+  * Side
+  */
   side: Side,
   /**
-   * Mode to interpret the amount
-   */
+  * Mode to interpret the amount
+  */
   mode: TradeLegMode,
   /**
-   * Quantity or USD amount
-   */
+  * Quantity or USD amount
+  */
   amount: UnsignedDecimalString,
   /**
-   * Reduce only flag
-   */
+  * Reduce only flag
+  */
   reduceOnly: z.boolean()
 });
-const TradeLegPostOnly = TradeLeg.omit({ reduceOnly: true });
+const TradeLegPostOnly = TradeLeg.omit({
+  reduceOnly: true
+});
 
 export { TradeLeg, TradeLegPostOnly };

package/dist/connector/index.js

@@ -1,5 +1,11 @@
 import { z } from 'zod';
 
-const Connector = z.enum(["hyperliquid", "binance", "bybit", "okx", "lighter"]);
+const Connector = z.enum([
+  "hyperliquid",
+  "binance",
+  "bybit",
+  "okx",
+  "lighter"
+]);
 
 export { Connector };

package/dist/execution/entities.js

@@ -5,129 +5,158 @@ import { InstrumentId } from '../instrument';
 import { Order } from '../order';
 import { Position } from '../position';
 
-const ExecutionIntent = z.enum(["OPEN", "CLOSE", "ADJUST", "REVERSE"]);
-const ExecutionOrderType = z.enum(["MARKET"]);
-const ExecutionStatus = z.enum(["IDLE", "ACTIVE", "COMPLETED", "FAILED", "CANCELLED"]);
-const ExecutionLegMode = z.enum(["QUANTITY", "USD"]);
+const ExecutionIntent = z.enum([
+  "OPEN",
+  "CLOSE",
+  "ADJUST",
+  "REVERSE"
+]);
+const ExecutionOrderType = z.enum([
+  "MARKET"
+]);
+const ExecutionStatus = z.enum([
+  "IDLE",
+  "ACTIVE",
+  "COMPLETED",
+  "FAILED",
+  "CANCELLED"
+]);
+const ExecutionLegMode = z.enum([
+  "QUANTITY",
+  "USD"
+]);
 const ExecutionLeg = z.object({
   /**
-   * Instrument ID
-   */
+  * Instrument ID
+  */
   symbol: InstrumentId,
   /**
-   * Side
-   */
+  * Side
+  */
   side: Side,
   /**
-   * Mode to interpret the amount
-   */
+  * Mode to interpret the amount
+  */
   mode: ExecutionLegMode,
   /**
-   * Quantity or USD amount
-   */
+  * Quantity or USD amount
+  */
   amount: UnsignedDecimalString,
   /**
-   * Reduce only flag
-   */
+  * Reduce only flag
+  */
   reduceOnly: z.boolean()
 });
 const BaseExecution = z.object({
   /**
-   * Execution UUID
-   */
+  * Execution UUID
+  */
   id: z.uuid(),
   /**
-   * Connector
-   */
+  * Connector
+  */
   connector: Connector,
   /**
-   * Intent
-   */
+  * Intent
+  */
   intent: ExecutionIntent,
   /**
-   * Order type
-   */
+  * Order type
+  */
   orderType: ExecutionOrderType,
   /**
-   * Status
-   */
+  * Status
+  */
   status: ExecutionStatus,
   /**
-   * Error message
-   */
+  * Error message
+  */
   error: z.string().optional(),
   /**
-   * Created at timestamp
-   */
+  * Created at timestamp
+  */
   createdAt: z.string(),
   /**
-   * Updated at timestamp
-   */
+  * Updated at timestamp
+  */
   updatedAt: z.string(),
   /**
-   * Orders
-   */
+  * Orders
+  */
   orders: z.array(Order).optional()
 });
 const MarketOpenExecution = BaseExecution.extend({
   /**
-   * Intent
-   */
+  * Intent
+  */
   intent: z.literal("OPEN"),
   /**
-   * Order type
-   */
+  * Order type
+  */
   orderType: z.literal("MARKET"),
   /**
-   * Requested legs
-   */
-  legs: z.tuple([ExecutionLeg]).rest(ExecutionLeg)
+  * Requested legs
+  */
+  legs: z.tuple([
+    ExecutionLeg
+  ]).rest(ExecutionLeg)
 });
 const MarketAdjustExecution = BaseExecution.extend({
   /**
-   * Intent
-   */
+  * Intent
+  */
   intent: z.literal("ADJUST"),
   /**
-   * Order type
-   */
+  * Order type
+  */
   orderType: z.literal("MARKET"),
   /**
-   * Position
-   */
-  position: Position.pick({ id: true, exposure: true }),
-  /**
-   * Requested legs
-   */
-  legs: z.tuple([ExecutionLeg]).rest(ExecutionLeg)
+  * Position
+  */
+  position: Position.pick({
+    id: true,
+    exposure: true
+  }),
+  /**
+  * Requested legs
+  */
+  legs: z.tuple([
+    ExecutionLeg
+  ]).rest(ExecutionLeg)
 });
 const MarketCloseExecution = BaseExecution.extend({
   /**
-   * Intent
-   */
+  * Intent
+  */
   intent: z.literal("CLOSE"),
   /**
-   * Order type
-   */
+  * Order type
+  */
   orderType: z.literal("MARKET"),
   /**
-   * Position
-   */
-  position: Position.pick({ id: true, exposure: true })
+  * Position
+  */
+  position: Position.pick({
+    id: true,
+    exposure: true
+  })
 });
 const MarketReverseExecution = BaseExecution.extend({
   /**
-   * Intent
-   */
+  * Intent
+  */
   intent: z.literal("REVERSE"),
   /**
-   * Order type
-   */
+  * Order type
+  */
   orderType: z.literal("MARKET"),
   /**
-   * Position
-   */
-  position: Position.pick({ id: true, exposure: true })
+  * Position
+  */
+  position: Position.pick({
+    id: true,
+    exposure: true
+  })
 });
 const MarketExecution = z.discriminatedUnion("intent", [
   MarketOpenExecution,
@@ -135,6 +164,8 @@ const MarketExecution = z.discriminatedUnion("intent", [
   MarketCloseExecution,
   MarketReverseExecution
 ]);
-const Execution = z.discriminatedUnion("orderType", [MarketExecution]);
+const Execution = z.discriminatedUnion("orderType", [
+  MarketExecution
+]);
 
 export { BaseExecution, Execution, ExecutionIntent, ExecutionLegMode, ExecutionOrderType, ExecutionStatus, MarketAdjustExecution, MarketCloseExecution, MarketExecution, MarketOpenExecution, MarketReverseExecution };

package/dist/execution/queries.js

@@ -2,7 +2,11 @@ import { z } from 'zod';
 import { normalizeArray, CursorFindParams } from '../common';
 import { Connector } from '../connector';
 
-const StatusEnum = z.enum(["ACTIVE", "COMPLETED", "CANCELLED"]);
+const StatusEnum = z.enum([
+  "ACTIVE",
+  "COMPLETED",
+  "CANCELLED"
+]);
 const StatusArray = z.preprocess((arg) => normalizeArray(arg), z.array(StatusEnum));
 const ExecutionListParams = CursorFindParams.extend({
   connector: Connector.optional(),

package/dist/execution/responses.js

@@ -5,6 +5,8 @@ import { Execution } from './entities';
 const ExecutionListResponse = CursorResponse.extend({
   executions: z.array(Execution)
 });
-const GetExecutionResponse = z.object({ execution: Execution });
+const GetExecutionResponse = z.object({
+  execution: Execution
+});
 
 export { ExecutionListResponse, GetExecutionResponse };