@centrali-io/centrali-sdk 6.0.0 → 6.1.0

package/dist/index.d.ts

@@ -923,15 +923,23 @@ type SortClause = {
  * Two pagination modes. Per contract §6 they are mutually exclusive — `cursor`
  * is forbidden in offset mode and `offset` is forbidden in cursor mode so a
  * caller cannot construct an ambiguous request.
+ *
+ * `withTotal` is opt-in (default false). When omitted, executors skip the
+ * accompanying `count(*)` query and return `meta.total` undefined; `hasMore`
+ * is still accurate (executors fetch `limit + 1` rows). Set `withTotal: true`
+ * when the caller actually renders a total — e.g. page-1 of a numbered
+ * paginator. CEN-1259.
  */
 type PageClause = {
     limit: number;
     offset?: number;
     cursor?: never;
+    withTotal?: boolean;
 } | {
     limit: number;
     cursor?: string;
     offset?: never;
+    withTotal?: boolean;
 };
 /**
  * Records Phase 1 page defaults (contract §6).

package/dist/index.js

@@ -5376,7 +5376,8 @@ var sortClauseSchema = external_exports.object({
 var pageClauseSchema = external_exports.object({
   limit: external_exports.number().int().positive().max(RECORDS_PAGE_MAX_LIMIT2),
   offset: external_exports.number().int().nonnegative().optional(),
-  cursor: external_exports.string().optional()
+  cursor: external_exports.string().optional(),
+  withTotal: external_exports.boolean().optional()
 }).superRefine((page, ctx) => {
   if (page.offset !== void 0 && page.cursor !== void 0) {
     ctx.addIssue({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@centrali-io/centrali-sdk",
-  "version": "6.0.0",
+  "version": "6.1.0",
   "description": "Centrali Node SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/query-types.ts

@@ -300,10 +300,16 @@ export type SortClause = {
  * Two pagination modes. Per contract §6 they are mutually exclusive — `cursor`
  * is forbidden in offset mode and `offset` is forbidden in cursor mode so a
  * caller cannot construct an ambiguous request.
+ *
+ * `withTotal` is opt-in (default false). When omitted, executors skip the
+ * accompanying `count(*)` query and return `meta.total` undefined; `hasMore`
+ * is still accurate (executors fetch `limit + 1` rows). Set `withTotal: true`
+ * when the caller actually renders a total — e.g. page-1 of a numbered
+ * paginator. CEN-1259.
  */
 export type PageClause =
-  | { limit: number; offset?: number; cursor?: never }
-  | { limit: number; cursor?: string; offset?: never };
+  | { limit: number; offset?: number; cursor?: never; withTotal?: boolean }
+  | { limit: number; cursor?: string; offset?: never; withTotal?: boolean };
 
 /**
  * Records Phase 1 page defaults (contract §6).