@0xmonaco/types 1.0.62 → 1.0.64

package/dist/trading/responses.d.ts

@@ -170,12 +170,13 @@ export interface GetPaginatedOrdersParams {
      * - Non-empty: an opaque cursor from a previous response's
      *   `nextPageToken`; results resume immediately after that position.
      *
-     * In either cursor-walk state (empty or non-empty), `page` is ignored, the
-     * response omits exact totals (`total`/`totalPages`/`page` are 0), and
-     * results cover full order history — hot and archived rows merged —
-     * unlike page-number mode, which only ever sees recent history. Clients
-     * that need complete order history must use the cursor form (pass `""` to
-     * start, then follow `nextPageToken`) rather than `page`.
+     * In either cursor-walk state (empty or non-empty), `page` is ignored (it
+     * comes back as 0), but `total` and `totalPages` ARE populated — bounded by
+     * the server count ceiling, see `totalCapped`. Results cover full order
+     * history — hot and archived rows merged — unlike page-number mode, which
+     * only ever sees recent history. Clients that need complete order history
+     * must use the cursor form (pass `""` to start, then follow `nextPageToken`)
+     * rather than `page`.
      */
     pageToken?: string;
 }
@@ -186,10 +187,9 @@ export interface GetPaginatedOrdersResponse {
     /** Array of historical orders from PostgreSQL (paginated) */
     orders: Order[];
     /**
-     * Total number of orders matching the query.
-     *
-     * @deprecated Only populated by legacy page-number (offset) responses; 0 in
-     * cursor mode, which has no exact total. Walk `nextPageToken` instead.
+     * Total number of orders matching the query, populated in BOTH pagination
+     * modes and bounded by the server count ceiling — see `totalCapped`. When
+     * `totalCapped` is `true` this is a lower bound (at least this many exist).
      */
     total: number;
     /**
@@ -202,10 +202,9 @@ export interface GetPaginatedOrdersResponse {
     /** Number of orders per page */
     pageSize: number;
     /**
-     * Total number of pages.
-     *
-     * @deprecated Only populated by legacy page-number (offset) responses; 0 in
-     * cursor mode, which has no exact total. Walk `nextPageToken` instead.
+     * Total number of pages at this `pageSize`, populated in BOTH pagination
+     * modes and bounded by the server count ceiling — see `totalCapped`. A lower
+     * bound when `totalCapped` is `true`.
      */
     totalPages: number;
     /**
@@ -223,6 +222,13 @@ export interface GetPaginatedOrdersResponse {
      * history.
      */
     nextPageToken: string;
+    /**
+     * `true` when MORE than the server ceiling of orders matched, so the count
+     * stopped at the ceiling and `total` / `totalPages` are a lower bound (more
+     * than `total` orders exist). `false` when `total` is the exact count —
+     * including exactly the ceiling, which is still reported exactly.
+     */
+    totalCapped: boolean;
 }
 /**
  * Response from getting a single order by ID

package/dist/wire/schema.d.ts

@@ -6288,8 +6288,7 @@ export interface components {
             orders?: components["schemas"]["GetOrderResponse"][] | null;
             /**
              * Format: uint32
-             * @deprecated
-             * @description Deprecated: total number of orders matching the filter (legacy offset mode only; 0 in cursor mode)
+             * @description Total number of orders matching the filter, populated in both pagination modes; bounded by the server ceiling — a lower bound when totalCapped is true.
              * @example 150
              */
             total?: number | null;
@@ -6308,8 +6307,7 @@ export interface components {
             pageSize?: number | null;
             /**
              * Format: uint32
-             * @deprecated
-             * @description Deprecated: total number of pages (legacy offset mode only; 0 in cursor mode)
+             * @description Total number of pages at this pageSize, populated in both pagination modes; bounded by the server ceiling — a lower bound when totalCapped is true.
              * @example 8
              */
             totalPages?: number | null;
@@ -6329,6 +6327,11 @@ export interface components {
              *      means page-number mode does not participate in cursor continuation.
              */
             nextPageToken?: string | null;
+            /**
+             * @description True when more than the server ceiling of orders matched, so the count stopped at the ceiling and total/totalPages are a lower bound (more than total exist). False when total is the exact count, including exactly the ceiling.
+             * @example false
+             */
+            totalCapped?: boolean | null;
         };
         ListPendingWithdrawalsResponse: {
             withdrawals?: components["schemas"]["PendingWithdrawal"][] | null;
@@ -12650,13 +12653,14 @@ export interface operations {
                  *       - Non-empty: an opaque cursor from a previous response's
                  *         `next_page_token`; results resume immediately after that position.
                  *
-                 *      In either cursor-walk state (empty or non-empty), `page` is ignored, the
-                 *      response omits exact totals (total/total_pages/page are 0), and results
-                 *      cover full order history — hot and archived rows merged — unlike
-                 *      page-number mode, which only ever sees recent history. Clients that need
-                 *      complete order history must use the cursor form (start with an empty
-                 *      string, then follow next_page_token) rather than `page`. Filters and
-                 *      orderBy must match the request that produced the token.
+                 *      In either cursor-walk state (empty or non-empty), `page` is ignored (it
+                 *      comes back as 0), but `total` and `total_pages` ARE populated — bounded by
+                 *      the server count ceiling, see `total_capped`. Results cover full order
+                 *      history — hot and archived rows merged — unlike page-number mode, which
+                 *      only ever sees recent history. Clients that need complete order history
+                 *      must use the cursor form (start with an empty string, then follow
+                 *      next_page_token) rather than `page`. Filters and orderBy must match the
+                 *      request that produced the token.
                  */
                 pageToken?: string;
             };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.62",
+	"version": "1.0.64",
 	"type": "module",
 	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
@@ -16,7 +16,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.62",
+		"@0xmonaco/contracts": "1.0.64",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {