@pear-protocol/types 1.15.0 → 1.16.0

package/dist/rebalance/entities.d.ts

@@ -8,6 +8,7 @@ export declare const AutoRebalancePausedReason: z.ZodEnum<{
     USER: "USER";
     POSITION_CHANGED: "POSITION_CHANGED";
     REPEATED_FAILURES: "REPEATED_FAILURES";
+    INVALID_LIVE_BETA_EXPOSURE: "INVALID_LIVE_BETA_EXPOSURE";
 }>;
 export type AutoRebalancePausedReason = z.infer<typeof AutoRebalancePausedReason>;
 export declare const AutoRebalanceWeightSource: z.ZodEnum<{
@@ -39,6 +40,7 @@ export declare const AutoRebalanceConfig: z.ZodObject<{
         USER: "USER";
         POSITION_CHANGED: "POSITION_CHANGED";
         REPEATED_FAILURES: "REPEATED_FAILURES";
+        INVALID_LIVE_BETA_EXPOSURE: "INVALID_LIVE_BETA_EXPOSURE";
     }>>;
     weightSource: z.ZodEnum<{
         INITIAL_WEIGHT: "INITIAL_WEIGHT";

package/dist/rebalance/entities.js

@@ -3,7 +3,12 @@ import { UnsignedDecimalString } from '../common/schema';
 import { InstrumentId } from '../instrument';
 
 const AutoRebalanceStatus = z.enum(["ACTIVE", "PAUSED"]);
-const AutoRebalancePausedReason = z.enum(["USER", "POSITION_CHANGED", "REPEATED_FAILURES"]);
+const AutoRebalancePausedReason = z.enum([
+  "USER",
+  "POSITION_CHANGED",
+  "REPEATED_FAILURES",
+  "INVALID_LIVE_BETA_EXPOSURE"
+]);
 const AutoRebalanceWeightSource = z.enum(["INITIAL_WEIGHT", "LIVE_BETA"]);
 const AutoRebalanceTimeframe = z.enum(["1h", "4h", "1d"]);
 const RebalanceEventStatus = z.enum(["SUCCESS", "FAILED"]);

package/dist/rebalance/responses.d.ts

@@ -28,6 +28,7 @@ export declare const AutoRebalanceListResponse: z.ZodObject<{
             USER: "USER";
             POSITION_CHANGED: "POSITION_CHANGED";
             REPEATED_FAILURES: "REPEATED_FAILURES";
+            INVALID_LIVE_BETA_EXPOSURE: "INVALID_LIVE_BETA_EXPOSURE";
         }>>;
         weightSource: z.ZodEnum<{
             INITIAL_WEIGHT: "INITIAL_WEIGHT";
@@ -56,6 +57,7 @@ export declare const CreateAutoRebalanceResponse: z.ZodObject<{
             USER: "USER";
             POSITION_CHANGED: "POSITION_CHANGED";
             REPEATED_FAILURES: "REPEATED_FAILURES";
+            INVALID_LIVE_BETA_EXPOSURE: "INVALID_LIVE_BETA_EXPOSURE";
         }>>;
         weightSource: z.ZodEnum<{
             INITIAL_WEIGHT: "INITIAL_WEIGHT";

package/dist/sync/payloads.d.ts

@@ -325,6 +325,14 @@ export declare const ApplicablePosition: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type ApplicablePosition = z.output<typeof ApplicablePosition>;
+/**
+ * Headroom above server time still accepted for the sync watermark: absorbs
+ * NTP drift between exchange and server clocks plus the deliberate first-sync
+ * trim advance (the exchanges-sdk syncer sends externalMaxTs + OVERLAP_MS + 1,
+ * ~60s past the newest fill), while a unit mistake (seconds↔ms conversion)
+ * overshoots it by orders of magnitude.
+ */
+export declare const WATERMARK_FUTURE_SKEW_MS = 300000;
 /**
  * Cycle-level metadata for the unified sync request.
  */
@@ -332,11 +340,21 @@ export declare const SyncMeta: z.ZodObject<{
     externalMaxTs: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
 export type SyncMeta = z.output<typeof SyncMeta>;
+/**
+ * Cycle-level metadata for the fills-create request specifically — extends the
+ * shared SyncMeta with a first-sync boundary meaningful only to the fills-create
+ * checkpoint, so it does not leak into the unrelated funding-payments contract.
+ */
+export declare const CreateApplicablesMeta: z.ZodObject<{
+    externalMaxTs: z.ZodNullable<z.ZodNumber>;
+    firstSyncStartedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type CreateApplicablesMeta = z.output<typeof CreateApplicablesMeta>;
 /**
  * POST /sync/create request — the discover+apply phase of the cycle.
  * - applicables: baskets keyed by positionKey, find-or-created during apply.
  * - exchangePositions: the exchange snapshot, enforced source of truth at verify.
- * - meta: cycle metadata (watermark).
+ * - meta: cycle metadata (watermark, first-sync pre-fetch boundary).
  *
  */
 export declare const CreateApplicablesRequest: z.ZodObject<{
@@ -410,6 +428,7 @@ export declare const CreateApplicablesRequest: z.ZodObject<{
     }, z.core.$strip>>;
     meta: z.ZodObject<{
         externalMaxTs: z.ZodNullable<z.ZodNumber>;
+        firstSyncStartedAt: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type CreateApplicablesRequest = z.output<typeof CreateApplicablesRequest>;

package/dist/sync/payloads.js

@@ -103,13 +103,20 @@ const ApplicablePosition = z.object({
   fills: z.array(ApplicableFill).min(1, "Applicable must carry at least one fill"),
   metadata: ApplicableMetadata
 });
+const WATERMARK_FUTURE_SKEW_MS = 3e5;
 const SyncMeta = z.object({
-  externalMaxTs: z.number().int().nonnegative().nullable().describe("watermark advance source")
+  externalMaxTs: z.number().int().nonnegative().refine(
+    (timestamp) => timestamp <= Date.now() + WATERMARK_FUTURE_SKEW_MS,
+    "externalMaxTs must not be ahead of server time"
+  ).nullable().describe("watermark advance source")
+});
+const CreateApplicablesMeta = SyncMeta.extend({
+  firstSyncStartedAt: z.number().int().nonnegative().optional().describe("backend-issued timestamp returned before the first fill-history fetch")
 });
 const CreateApplicablesRequest = z.object({
   applicables: z.array(ApplicablePosition),
   exchangePositions: z.array(ExternalPosition),
-  meta: SyncMeta
+  meta: CreateApplicablesMeta
 });
 const OptionallySignedDecimalString = z.string().regex(/^[+-]?\d+(\.\d+)?$/, "Must be a valid signed decimal string");
 const FundingPaymentEntry = z.object({
@@ -127,4 +134,4 @@ const CreateFundingPaymentsRequest = z.object({
   meta: SyncMeta
 });
 
-export { ApplicableFill, ApplicableMetadata, ApplicablePosition, ConfirmFillsRequest, ConfirmableExternalFill, CreateApplicablesRequest, CreateFundingPaymentsRequest, ExternalPosition, FundingPaymentEntry, ReconcileFillsRequest, ReconcileReplacementExternalFill, SyncFillsSinceRequest, SyncFundingSinceRequest, SyncMeta, UnknownExternalFill };
+export { ApplicableFill, ApplicableMetadata, ApplicablePosition, ConfirmFillsRequest, ConfirmableExternalFill, CreateApplicablesMeta, CreateApplicablesRequest, CreateFundingPaymentsRequest, ExternalPosition, FundingPaymentEntry, ReconcileFillsRequest, ReconcileReplacementExternalFill, SyncFillsSinceRequest, SyncFundingSinceRequest, SyncMeta, UnknownExternalFill, WATERMARK_FUTURE_SKEW_MS };

package/dist/sync/responses.d.ts

@@ -3,6 +3,7 @@ export declare const SyncFillsResponse: z.ZodObject<{}, z.core.$strip>;
 export declare const SyncFillsSinceResponse: z.ZodObject<{
     sinceMs: z.ZodNumber;
     neverSynced: z.ZodBoolean;
+    firstSyncStartedAt: z.ZodOptional<z.ZodNumber>;
     confirmedExchangeFillIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export declare const SyncFundingSinceResponse: z.ZodObject<{

package/dist/sync/responses.js

@@ -7,6 +7,9 @@ const SyncFillsSinceResponse = z.object({
   // genesis. Clients use this to detect an account that has never imported its trade history —
   // `sinceMs === 0` alone is ambiguous (a clamped watermark also yields 0).
   neverSynced: z.boolean(),
+  // Backend-clock boundary returned only for a never-synced account. The syncer carries this
+  // through when an empty exchange fetch provides no fill-derived checkpoint.
+  firstSyncStartedAt: z.number().int().nonnegative().optional(),
   confirmedExchangeFillIds: z.array(z.string()).optional()
 });
 const SyncFundingSinceResponse = z.object({

package/package.json

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