@pear-protocol/types 1.20.0 → 1.22.0

package/dist/trigger/payloads/index.d.ts

@@ -152,6 +152,78 @@ export declare const AttachTriggerMarketClose: z.ZodUnion<readonly [z.ZodObject<
         activationValue: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
 }, z.core.$strip>]>;
+export declare const AttachTriggerMarketCloseList: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+    intent: z.ZodLiteral<"CLOSE">;
+    type: z.ZodLiteral<"MARKET">;
+    bracketType: z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+    }>;
+    condition: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"notional">;
+        data: z.ZodObject<{
+            priceSource: z.ZodEnum<{
+                mid: "mid";
+                mark: "mark";
+            }>;
+            threshold: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"upnl">;
+        data: z.ZodObject<{
+            priceSource: z.ZodEnum<{
+                mid: "mid";
+                mark: "mark";
+            }>;
+            threshold: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"upnl_bps">;
+        data: z.ZodObject<{
+            priceSource: z.ZodEnum<{
+                mid: "mid";
+                mark: "mark";
+            }>;
+            threshold: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>], "type">;
+}, z.core.$strip>, z.ZodObject<{
+    intent: z.ZodLiteral<"CLOSE">;
+    type: z.ZodLiteral<"MARKET">;
+    condition: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"notional_trailing">;
+        data: z.ZodObject<{
+            priceSource: z.ZodEnum<{
+                mid: "mid";
+                mark: "mark";
+            }>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"upnl_trailing">;
+        data: z.ZodObject<{
+            priceSource: z.ZodEnum<{
+                mid: "mid";
+                mark: "mark";
+            }>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"upnl_bps_trailing">;
+        data: z.ZodObject<{
+            priceSource: z.ZodEnum<{
+                mid: "mid";
+                mark: "mark";
+            }>;
+        }, z.core.$strip>;
+    }, z.core.$strip>], "type">;
+    trailing: z.ZodObject<{
+        mode: z.ZodEnum<{
+            RELATIVE_BPS: "RELATIVE_BPS";
+            ABSOLUTE_POINTS: "ABSOLUTE_POINTS";
+        }>;
+        deltaValue: z.ZodNumber;
+        activationValue: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>]>>;
 export declare const CreateTriggerMarketOpen: z.ZodObject<{
     intent: z.ZodLiteral<"OPEN">;
     type: z.ZodLiteral<"MARKET">;
@@ -480,6 +552,10 @@ export declare const CreateTriggerMarketCloseStatic: z.ZodObject<{
         TAKE_PROFIT: "TAKE_PROFIT";
         NONE: "NONE";
     }>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+    }>>;
     condition: z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"ratio">;
         data: z.ZodObject<{
@@ -631,6 +707,10 @@ export declare const CreateTriggerMarketClose: z.ZodUnion<readonly [z.ZodObject<
         TAKE_PROFIT: "TAKE_PROFIT";
         NONE: "NONE";
     }>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+    }>>;
     condition: z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"ratio">;
         data: z.ZodObject<{
@@ -1099,6 +1179,10 @@ export declare const CreateTriggerClose: z.ZodUnion<readonly [z.ZodObject<{
         TAKE_PROFIT: "TAKE_PROFIT";
         NONE: "NONE";
     }>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+    }>>;
     condition: z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"ratio">;
         data: z.ZodObject<{
@@ -1248,6 +1332,7 @@ export type CreateTriggerMarketClose = z.output<typeof CreateTriggerMarketClose>
 export type AttachTriggerMarketCloseStatic = z.output<typeof AttachTriggerMarketCloseStatic>;
 export type AttachTriggerMarketCloseTrailing = z.output<typeof AttachTriggerMarketCloseTrailing>;
 export type AttachTriggerMarketClose = z.output<typeof AttachTriggerMarketClose>;
+export type AttachTriggerMarketCloseList = z.output<typeof AttachTriggerMarketCloseList>;
 export type CreateTriggerOpen = z.output<typeof CreateTriggerOpen>;
 export type CreateTriggerClose = z.output<typeof CreateTriggerClose>;
 export type TrailingConfig = z.output<typeof TrailingConfig>;

package/dist/trigger/payloads/index.js

@@ -30,19 +30,20 @@ const AttachTriggerMarketCloseTrailing = z.object({
   trailing: TrailingConfig
 }).superRefine(RefineTrailingLogicalRules);
 const AttachTriggerMarketClose = z.union([AttachTriggerMarketCloseStatic, AttachTriggerMarketCloseTrailing]);
+const AttachTriggerMarketCloseList = z.array(AttachTriggerMarketClose).max(MAX_ATTACH_TRIGGERS, `At most ${MAX_ATTACH_TRIGGERS} close triggers can be attached.`).superRefine((attachTriggers, ctx) => {
+  const trailingCount = attachTriggers.filter(isAttachTriggerMarketCloseTrailing).length;
+  if (trailingCount > 1) {
+    ctx.addIssue({
+      code: "custom",
+      message: "At most one trailing close trigger can be attached."
+    });
+  }
+});
 const CreateTriggerMarketOpen = z.object({
   intent: z.literal("OPEN"),
   type: z.literal("MARKET"),
   condition: CreateTriggerConditionOpen,
-  attachTriggers: z.array(AttachTriggerMarketClose).max(MAX_ATTACH_TRIGGERS, `A market-open trigger can attach at most ${MAX_ATTACH_TRIGGERS} close triggers.`).superRefine((attachTriggers, ctx) => {
-    const trailingCount = attachTriggers.filter(isAttachTriggerMarketCloseTrailing).length;
-    if (trailingCount > 1) {
-      ctx.addIssue({
-        code: "custom",
-        message: "A market-open trigger can attach at most one trailing close trigger."
-      });
-    }
-  }).optional(),
+  attachTriggers: AttachTriggerMarketCloseList.optional(),
   payload: CreateTriggerMarketPayload,
   /**
    * Attribution route code (client_ids.code)
@@ -65,6 +66,9 @@ const CreateTriggerMarketCloseStatic = z.object({
   type: z.literal("MARKET"),
   positionId: z.uuid(),
   bracketType: BracketType,
+  // User intent when bracketType is a side-dependent price-crossing encoding.
+  // Optional so older clients remain wire-compatible during rollout.
+  semanticBracketType: TpSlBracketType.optional(),
   condition: CreateTriggerConditionCloseStatic,
   /**
    * Attribution route code (client_ids.code)
@@ -89,4 +93,4 @@ function isAttachTriggerMarketCloseTrailing(attachedTrigger) {
   return "trailing" in attachedTrigger && attachedTrigger.trailing !== void 0;
 }
 
-export { AttachTriggerMarketClose, AttachTriggerMarketCloseStatic, AttachTriggerMarketCloseTrailing, CreateTriggerClose, CreateTriggerMarketAdjust, CreateTriggerMarketClose, CreateTriggerMarketCloseStatic, CreateTriggerMarketCloseTrailing, CreateTriggerMarketOpen, CreateTriggerOpen, TrailingConfig, isAttachTriggerMarketCloseTrailing };
+export { AttachTriggerMarketClose, AttachTriggerMarketCloseList, AttachTriggerMarketCloseStatic, AttachTriggerMarketCloseTrailing, CreateTriggerClose, CreateTriggerMarketAdjust, CreateTriggerMarketClose, CreateTriggerMarketCloseStatic, CreateTriggerMarketCloseTrailing, CreateTriggerMarketOpen, CreateTriggerOpen, TrailingConfig, isAttachTriggerMarketCloseTrailing };

package/dist/trigger/refinement/static.refinement.d.ts

@@ -1,17 +1,25 @@
 import type { z } from 'zod';
-import type { BracketType } from '../common';
 import type { CreateTriggerConditionCloseStatic } from '../payloads/conditions';
 type ValidationFieldIssue = {
     field: 'threshold';
     message: string;
 };
 type ConditionType = CreateTriggerConditionCloseStatic['type'];
+/** Surface every logical threshold issue on a static close trigger as a zod issue. */
 export declare const RefineStaticLogicalRules: (value: {
-    bracketType: BracketType;
     condition: CreateTriggerConditionCloseStatic;
 }, context: z.RefinementCtx) => void;
+/**
+ * Validate a static close trigger's threshold against the rules its condition type implies.
+ *
+ * Deliberately blind to `bracketType`: it selects only the comparison direction (TAKE_PROFIT ->
+ * PEAK, STOP_LOSS -> TROUGH, NONE -> PEAK), and every sign pairs coherently with either direction. A positive
+ * STOP_LOSS is a profit floor ("close if my gain falls back to +10%") and a negative TAKE_PROFIT
+ * is a recovery exit ("close when my -30% loss recovers to -24%"); both are supported orders. A
+ * threshold that is already satisfied fires on the next evaluation pass, but catching that needs
+ * the position's current uPnL, which no pure function can see — it belongs in the usecase.
+ */
 export declare function getStaticLogicalIssues(input: {
-    bracketType: BracketType;
     conditionType: ConditionType;
     threshold: number;
 }): ValidationFieldIssue[];

package/dist/trigger/refinement/static.refinement.js

@@ -1,6 +1,5 @@
 const RefineStaticLogicalRules = (value, context) => {
   for (const issue of getStaticLogicalIssues({
-    bracketType: value.bracketType,
     conditionType: value.condition.type,
     threshold: value.condition.data.threshold
   })) {
@@ -23,7 +22,15 @@ function getStaticLogicalIssues(input) {
       }
       break;
     }
-    case "upnl":
+    case "upnl": {
+      if (threshold === 0) {
+        issues.push({
+          field: "threshold",
+          message: "threshold must not be 0 for uPnL static triggers"
+        });
+      }
+      break;
+    }
     case "upnl_bps": {
       if (threshold === 0) {
         issues.push({

package/dist/trigger/responses.d.ts

@@ -71,6 +71,11 @@ export declare const TriggerListResponse: z.ZodObject<{
             TAKE_PROFIT: "TAKE_PROFIT";
             NONE: "NONE";
         }>;
+        semanticBracketType: z.ZodOptional<z.ZodEnum<{
+            STOP_LOSS: "STOP_LOSS";
+            TAKE_PROFIT: "TAKE_PROFIT";
+            NONE: "NONE";
+        }>>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         intent: z.ZodLiteral<"OPEN">;
@@ -272,6 +277,11 @@ export declare const TriggerListResponse: z.ZodObject<{
             TAKE_PROFIT: "TAKE_PROFIT";
             NONE: "NONE";
         }>;
+        semanticBracketType: z.ZodOptional<z.ZodEnum<{
+            STOP_LOSS: "STOP_LOSS";
+            TAKE_PROFIT: "TAKE_PROFIT";
+            NONE: "NONE";
+        }>>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         intent: z.ZodLiteral<"ADJUST">;
@@ -519,6 +529,11 @@ export declare const TriggerListResponse: z.ZodObject<{
             TAKE_PROFIT: "TAKE_PROFIT";
             NONE: "NONE";
         }>;
+        semanticBracketType: z.ZodOptional<z.ZodEnum<{
+            STOP_LOSS: "STOP_LOSS";
+            TAKE_PROFIT: "TAKE_PROFIT";
+            NONE: "NONE";
+        }>>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         intent: z.ZodLiteral<"CLOSE">;
@@ -804,6 +819,11 @@ export declare const CreateTriggerResponse: z.ZodObject<{
             TAKE_PROFIT: "TAKE_PROFIT";
             NONE: "NONE";
         }>;
+        semanticBracketType: z.ZodOptional<z.ZodEnum<{
+            STOP_LOSS: "STOP_LOSS";
+            TAKE_PROFIT: "TAKE_PROFIT";
+            NONE: "NONE";
+        }>>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         intent: z.ZodLiteral<"OPEN">;
@@ -1005,6 +1025,11 @@ export declare const CreateTriggerResponse: z.ZodObject<{
             TAKE_PROFIT: "TAKE_PROFIT";
             NONE: "NONE";
         }>;
+        semanticBracketType: z.ZodOptional<z.ZodEnum<{
+            STOP_LOSS: "STOP_LOSS";
+            TAKE_PROFIT: "TAKE_PROFIT";
+            NONE: "NONE";
+        }>>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         intent: z.ZodLiteral<"ADJUST">;
@@ -1252,6 +1277,11 @@ export declare const CreateTriggerResponse: z.ZodObject<{
             TAKE_PROFIT: "TAKE_PROFIT";
             NONE: "NONE";
         }>;
+        semanticBracketType: z.ZodOptional<z.ZodEnum<{
+            STOP_LOSS: "STOP_LOSS";
+            TAKE_PROFIT: "TAKE_PROFIT";
+            NONE: "NONE";
+        }>>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         intent: z.ZodLiteral<"CLOSE">;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/types",
-  "version": "1.20.0",
+  "version": "1.22.0",
   "description": "Pear Protocol Types definitions",
   "private": false,
   "type": "module",