@pear-protocol/types 1.15.0 → 1.15.1

package/dist/sync/payloads.d.ts

@@ -332,11 +332,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 +420,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

@@ -106,10 +106,13 @@ const ApplicablePosition = z.object({
 const SyncMeta = z.object({
   externalMaxTs: z.number().int().nonnegative().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 +130,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 };

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.15.1",
   "description": "Pear Protocol Types definitions",
   "private": false,
   "type": "module",