@visus-io/notion-sdk-ts 3.0.2 → 3.1.1

package/dist/schemas/pageProperties.schema.d.ts

@@ -2,9 +2,9 @@ import * as z from 'zod';
 /**
  * Page property value schemas.
  *
- * These define the actual data values stored in page properties (database columns).
- * Different from property objects which define the schema/configuration.
- * Supports 23 property types including title, rich text, number, select, etc.
+ * These schemas define the data values in page properties (database columns).
+ * Property objects define the schema and configuration instead.
+ * This file supports 22 property types, including title, rich text, number, and select.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/page-property-values
@@ -27,6 +27,7 @@ declare const createdByPropertySchema: z.ZodObject<{
         avatar_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>>;
         person: z.ZodObject<{
             email: z.ZodEmail;
+            email_verified: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         object: z.ZodLiteral<"user">;
@@ -131,6 +132,7 @@ declare const lastEditedByPropertySchema: z.ZodObject<{
         avatar_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>>;
         person: z.ZodObject<{
             email: z.ZodEmail;
+            email_verified: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         object: z.ZodLiteral<"user">;
@@ -170,11 +172,11 @@ declare const multiSelectPropertySchema: z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         color: z.ZodEnum<{
+            default: "default";
             blue: "blue";
             blue_background: "blue_background";
             brown: "brown";
             brown_background: "brown_background";
-            default: "default";
             gray: "gray";
             gray_background: "gray_background";
             green: "green";
@@ -210,6 +212,7 @@ declare const peoplePropertySchema: z.ZodObject<{
         avatar_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>>;
         person: z.ZodObject<{
             email: z.ZodEmail;
+            email_verified: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         object: z.ZodLiteral<"user">;
@@ -269,11 +272,11 @@ declare const richTextPropertySchema: z.ZodObject<{
             underline: z.ZodBoolean;
             code: z.ZodBoolean;
             color: z.ZodEnum<{
+                default: "default";
                 blue: "blue";
                 blue_background: "blue_background";
                 brown: "brown";
                 brown_background: "brown_background";
-                default: "default";
                 gray: "gray";
                 gray_background: "gray_background";
                 green: "green";
@@ -338,6 +341,7 @@ declare const richTextPropertySchema: z.ZodObject<{
                 avatar_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>>;
                 person: z.ZodObject<{
                     email: z.ZodEmail;
+                    email_verified: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>;
             }, z.core.$strip>, z.ZodObject<{
                 object: z.ZodLiteral<"user">;
@@ -370,11 +374,11 @@ declare const richTextPropertySchema: z.ZodObject<{
             underline: z.ZodBoolean;
             code: z.ZodBoolean;
             color: z.ZodEnum<{
+                default: "default";
                 blue: "blue";
                 blue_background: "blue_background";
                 brown: "brown";
                 brown_background: "brown_background";
-                default: "default";
                 gray: "gray";
                 gray_background: "gray_background";
                 green: "green";
@@ -405,11 +409,11 @@ declare const richTextPropertySchema: z.ZodObject<{
             underline: z.ZodBoolean;
             code: z.ZodBoolean;
             color: z.ZodEnum<{
+                default: "default";
                 blue: "blue";
                 blue_background: "blue_background";
                 brown: "brown";
                 brown_background: "brown_background";
-                default: "default";
                 gray: "gray";
                 gray_background: "gray_background";
                 green: "green";
@@ -485,11 +489,11 @@ declare const selectPropertySchema: z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         color: z.ZodEnum<{
+            default: "default";
             blue: "blue";
             blue_background: "blue_background";
             brown: "brown";
             brown_background: "brown_background";
-            default: "default";
             gray: "gray";
             gray_background: "gray_background";
             green: "green";
@@ -515,11 +519,11 @@ declare const statusPropertySchema: z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         color: z.ZodEnum<{
+            default: "default";
             blue: "blue";
             blue_background: "blue_background";
             brown: "brown";
             brown_background: "brown_background";
-            default: "default";
             gray: "gray";
             gray_background: "gray_background";
             green: "green";
@@ -556,11 +560,11 @@ declare const titlePropertySchema: z.ZodObject<{
             underline: z.ZodBoolean;
             code: z.ZodBoolean;
             color: z.ZodEnum<{
+                default: "default";
                 blue: "blue";
                 blue_background: "blue_background";
                 brown: "brown";
                 brown_background: "brown_background";
-                default: "default";
                 gray: "gray";
                 gray_background: "gray_background";
                 green: "green";
@@ -625,6 +629,7 @@ declare const titlePropertySchema: z.ZodObject<{
                 avatar_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>>;
                 person: z.ZodObject<{
                     email: z.ZodEmail;
+                    email_verified: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>;
             }, z.core.$strip>, z.ZodObject<{
                 object: z.ZodLiteral<"user">;
@@ -657,11 +662,11 @@ declare const titlePropertySchema: z.ZodObject<{
             underline: z.ZodBoolean;
             code: z.ZodBoolean;
             color: z.ZodEnum<{
+                default: "default";
                 blue: "blue";
                 blue_background: "blue_background";
                 brown: "brown";
                 brown_background: "brown_background";
-                default: "default";
                 gray: "gray";
                 gray_background: "gray_background";
                 green: "green";
@@ -692,11 +697,11 @@ declare const titlePropertySchema: z.ZodObject<{
             underline: z.ZodBoolean;
             code: z.ZodBoolean;
             color: z.ZodEnum<{
+                default: "default";
                 blue: "blue";
                 blue_background: "blue_background";
                 brown: "brown";
                 brown_background: "brown_background";
-                default: "default";
                 gray: "gray";
                 gray_background: "gray_background";
                 green: "green";
@@ -749,6 +754,7 @@ declare const verificationPropertySchema: z.ZodObject<{
             avatar_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>>;
             person: z.ZodObject<{
                 email: z.ZodEmail;
+                email_verified: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             object: z.ZodLiteral<"user">;
@@ -780,6 +786,9 @@ declare const verificationPropertySchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/**
+ * @category Page Properties
+ */
 export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     id: z.ZodString;
     type: z.ZodLiteral<"checkbox">;
@@ -795,6 +804,7 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         avatar_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>>;
         person: z.ZodObject<{
             email: z.ZodEmail;
+            email_verified: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         object: z.ZodLiteral<"user">;
@@ -887,6 +897,7 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         avatar_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>>;
         person: z.ZodObject<{
             email: z.ZodEmail;
+            email_verified: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         object: z.ZodLiteral<"user">;
@@ -922,11 +933,11 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         id: z.ZodString;
         name: z.ZodString;
         color: z.ZodEnum<{
+            default: "default";
             blue: "blue";
             blue_background: "blue_background";
             brown: "brown";
             brown_background: "brown_background";
-            default: "default";
             gray: "gray";
             gray_background: "gray_background";
             green: "green";
@@ -958,6 +969,7 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         avatar_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>>;
         person: z.ZodObject<{
             email: z.ZodEmail;
+            email_verified: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         object: z.ZodLiteral<"user">;
@@ -1011,11 +1023,11 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
             underline: z.ZodBoolean;
             code: z.ZodBoolean;
             color: z.ZodEnum<{
+                default: "default";
                 blue: "blue";
                 blue_background: "blue_background";
                 brown: "brown";
                 brown_background: "brown_background";
-                default: "default";
                 gray: "gray";
                 gray_background: "gray_background";
                 green: "green";
@@ -1080,6 +1092,7 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
                 avatar_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>>;
                 person: z.ZodObject<{
                     email: z.ZodEmail;
+                    email_verified: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>;
             }, z.core.$strip>, z.ZodObject<{
                 object: z.ZodLiteral<"user">;
@@ -1112,11 +1125,11 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
             underline: z.ZodBoolean;
             code: z.ZodBoolean;
             color: z.ZodEnum<{
+                default: "default";
                 blue: "blue";
                 blue_background: "blue_background";
                 brown: "brown";
                 brown_background: "brown_background";
-                default: "default";
                 gray: "gray";
                 gray_background: "gray_background";
                 green: "green";
@@ -1147,11 +1160,11 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
             underline: z.ZodBoolean;
             code: z.ZodBoolean;
             color: z.ZodEnum<{
+                default: "default";
                 blue: "blue";
                 blue_background: "blue_background";
                 brown: "brown";
                 brown_background: "brown_background";
-                default: "default";
                 gray: "gray";
                 gray_background: "gray_background";
                 green: "green";
@@ -1223,11 +1236,11 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         id: z.ZodString;
         name: z.ZodString;
         color: z.ZodEnum<{
+            default: "default";
             blue: "blue";
             blue_background: "blue_background";
             brown: "brown";
             brown_background: "brown_background";
-            default: "default";
             gray: "gray";
             gray_background: "gray_background";
             green: "green";
@@ -1251,11 +1264,11 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         id: z.ZodString;
         name: z.ZodString;
         color: z.ZodEnum<{
+            default: "default";
             blue: "blue";
             blue_background: "blue_background";
             brown: "brown";
             brown_background: "brown_background";
-            default: "default";
             gray: "gray";
             gray_background: "gray_background";
             green: "green";
@@ -1290,11 +1303,11 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
             underline: z.ZodBoolean;
             code: z.ZodBoolean;
             color: z.ZodEnum<{
+                default: "default";
                 blue: "blue";
                 blue_background: "blue_background";
                 brown: "brown";
                 brown_background: "brown_background";
-                default: "default";
                 gray: "gray";
                 gray_background: "gray_background";
                 green: "green";
@@ -1359,6 +1372,7 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
                 avatar_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>>;
                 person: z.ZodObject<{
                     email: z.ZodEmail;
+                    email_verified: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>;
             }, z.core.$strip>, z.ZodObject<{
                 object: z.ZodLiteral<"user">;
@@ -1391,11 +1405,11 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
             underline: z.ZodBoolean;
             code: z.ZodBoolean;
             color: z.ZodEnum<{
+                default: "default";
                 blue: "blue";
                 blue_background: "blue_background";
                 brown: "brown";
                 brown_background: "brown_background";
-                default: "default";
                 gray: "gray";
                 gray_background: "gray_background";
                 green: "green";
@@ -1426,11 +1440,11 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
             underline: z.ZodBoolean;
             code: z.ZodBoolean;
             color: z.ZodEnum<{
+                default: "default";
                 blue: "blue";
                 blue_background: "blue_background";
                 brown: "brown";
                 brown_background: "brown_background";
-                default: "default";
                 gray: "gray";
                 gray_background: "gray_background";
                 green: "green";
@@ -1477,6 +1491,7 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
             avatar_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>>;
             person: z.ZodObject<{
                 email: z.ZodEmail;
+                email_verified: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             object: z.ZodLiteral<"user">;
@@ -1508,27 +1523,96 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>], "type">;
+/**
+ * @category Page Properties
+ */
 export type NotionPageProperties = z.infer<typeof pagePropertiesSchema>;
+/**
+ * @category Page Properties
+ */
 export type CheckboxProperty = z.infer<typeof checkboxPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type CreatedByProperty = z.infer<typeof createdByPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type CreatedTimeProperty = z.infer<typeof createdTimePropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type DateProperty = z.infer<typeof datePropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type EmailProperty = z.infer<typeof emailPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type FilesProperty = z.infer<typeof filesPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type FormulaProperty = z.infer<typeof formulaPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type LastEditedByProperty = z.infer<typeof lastEditedByPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type LastEditedTimeProperty = z.infer<typeof lastEditedTimePropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type MultiSelectProperty = z.infer<typeof multiSelectPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type NumberProperty = z.infer<typeof numberPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type PeopleProperty = z.infer<typeof peoplePropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type PhoneNumberProperty = z.infer<typeof phoneNumberPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type RelationProperty = z.infer<typeof relationPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type RichTextProperty = z.infer<typeof richTextPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type RollupProperty = z.infer<typeof rollupPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type SelectProperty = z.infer<typeof selectPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type StatusProperty = z.infer<typeof statusPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type TitleProperty = z.infer<typeof titlePropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type UrlProperty = z.infer<typeof urlPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type UniqueIdProperty = z.infer<typeof uniqueIdPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type VerificationProperty = z.infer<typeof verificationPropertySchema>;
 export {};

package/dist/schemas/pageProperties.schema.js

@@ -42,9 +42,9 @@ const user_schema_1 = require("./user.schema");
 /**
  * Page property value schemas.
  *
- * These define the actual data values stored in page properties (database columns).
- * Different from property objects which define the schema/configuration.
- * Supports 23 property types including title, rich text, number, select, etc.
+ * These schemas define the data values in page properties (database columns).
+ * Property objects define the schema and configuration instead.
+ * This file supports 22 property types, including title, rich text, number, and select.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/page-property-values
@@ -200,15 +200,14 @@ const rollupPropertySchema = z.object({
             'unchecked',
             'unique',
         ]),
-        number: z.number().nullable().optional(),
+        number: z.number().nullish(),
         date: z
             .object({
             start: shared_schema_1.notionDateStringSchema,
             end: shared_schema_1.notionDateStringSchema.nullable(),
             time_zone: z.string().trim().nullable(),
         })
-            .nullable()
-            .optional(),
+            .nullish(),
         array: z.array(z.unknown()).optional(),
     }),
 });
@@ -275,6 +274,9 @@ const verificationPropertySchema = z.object({
     })
         .nullable(),
 });
+/**
+ * @category Page Properties
+ */
 exports.pagePropertiesSchema = z.discriminatedUnion('type', [
     checkboxPropertySchema,
     createdByPropertySchema,

package/dist/schemas/pagination.schema.d.ts

@@ -3,20 +3,53 @@ import * as z from 'zod';
  * Pagination schemas and utilities.
  *
  * The Notion API uses cursor-based pagination for list endpoints. Responses include
- * results, a next_cursor, and has_more flag. This file provides reusable schemas
- * and types for working with paginated responses.
+ * results, a next_cursor, and a has_more flag. This file provides reusable schemas
+ * and types to work with paginated responses.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/intro#pagination
  */
 /**
  * Paginated list response type.
- * As of API version 2025-09-03, 'data_source' and 'page_or_data_source' are used
- * instead of 'database' and 'page_or_database' in search results.
+ * As of API version 2025-09-03, search results use 'data_source' and
+ * 'page_or_data_source' instead of 'database' and 'page_or_database'.
+ *
+ * @category Pagination
+ */
+export type PaginatedListType = 'block' | 'comment' | 'custom_emoji' | 'database' | 'data_source' | 'page' | 'page_or_database' | 'page_or_data_source' | 'property_item' | 'user' | 'view';
+/**
+ * Reasons why a query result can be incomplete even when `has_more` is `false`.
+ * This happens only when a query hits the 10,000-result pagination depth cap.
+ *
+ * @category Pagination
+ */
+export declare const REQUEST_STATUS_INCOMPLETE_REASONS: readonly ["query_result_limit_reached"];
+/**
+ * @category Pagination
+ */
+export type RequestStatusIncompleteReason = (typeof REQUEST_STATUS_INCOMPLETE_REASONS)[number];
+/**
+ * This schema flags a truncated query even though `has_more` is `false`. For example,
+ * data source, view, and meeting-notes queries cap at 10,000 results. Callers that need
+ * every row must detect this. Then they must re-query with a narrower filter (see the
+ * pagination helpers).
+ *
+ * @category Pagination
+ */
+export declare const requestStatusSchema: z.ZodObject<{
+    type: z.ZodLiteral<"incomplete">;
+    incomplete_reason: z.ZodEnum<{
+        query_result_limit_reached: "query_result_limit_reached";
+    }>;
+}, z.core.$strip>;
+/**
+ * @category Pagination
  */
-export type PaginatedListType = 'block' | 'comment' | 'database' | 'data_source' | 'page' | 'page_or_database' | 'page_or_data_source' | 'property_item' | 'user';
+export type RequestStatus = z.infer<typeof requestStatusSchema>;
 /**
  * Base paginated list response schema.
+ *
+ * @category Pagination
  */
 export declare const paginatedListSchema: <T extends z.ZodTypeAny>(resultSchema: T) => z.ZodObject<{
     object: z.ZodLiteral<"list">;
@@ -24,6 +57,7 @@ export declare const paginatedListSchema: <T extends z.ZodTypeAny>(resultSchema:
     next_cursor: z.ZodNullable<z.ZodString>;
     has_more: z.ZodBoolean;
     type: z.ZodEnum<{
+        custom_emoji: "custom_emoji";
         user: "user";
         database: "database";
         page: "page";
@@ -33,19 +67,34 @@ export declare const paginatedListSchema: <T extends z.ZodTypeAny>(resultSchema:
         page_or_database: "page_or_database";
         page_or_data_source: "page_or_data_source";
         property_item: "property_item";
+        view: "view";
     }>;
+    request_status: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"incomplete">;
+        incomplete_reason: z.ZodEnum<{
+            query_result_limit_reached: "query_result_limit_reached";
+        }>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
  * Pagination parameters for requests.
+ *
+ * @category Pagination
  */
 export interface PaginationParameters {
     /** The number of items to return (default: 100, max: 100) */
     page_size?: number;
-    /** The cursor value from a previous response to continue pagination */
-    start_cursor?: string;
+    /**
+     * The cursor value from a previous response.
+     * Pass it to continue pagination.
+     * The SDK treats `null` the same as omitted.
+     */
+    start_cursor?: string | null;
 }
 /**
  * Helper to create paginated response type.
+ *
+ * @category Pagination
  */
 export type PaginatedList<T> = {
     object: 'list';
@@ -53,4 +102,5 @@ export type PaginatedList<T> = {
     next_cursor: string | null;
     has_more: boolean;
     type: PaginatedListType;
+    request_status?: RequestStatus;
 };

package/dist/schemas/pagination.schema.js

@@ -33,10 +33,31 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.paginatedListSchema = void 0;
+exports.paginatedListSchema = exports.requestStatusSchema = exports.REQUEST_STATUS_INCOMPLETE_REASONS = void 0;
 const z = __importStar(require("zod"));
+/**
+ * Reasons why a query result can be incomplete even when `has_more` is `false`.
+ * This happens only when a query hits the 10,000-result pagination depth cap.
+ *
+ * @category Pagination
+ */
+exports.REQUEST_STATUS_INCOMPLETE_REASONS = ['query_result_limit_reached'];
+/**
+ * This schema flags a truncated query even though `has_more` is `false`. For example,
+ * data source, view, and meeting-notes queries cap at 10,000 results. Callers that need
+ * every row must detect this. Then they must re-query with a narrower filter (see the
+ * pagination helpers).
+ *
+ * @category Pagination
+ */
+exports.requestStatusSchema = z.object({
+    type: z.literal('incomplete'),
+    incomplete_reason: z.enum(exports.REQUEST_STATUS_INCOMPLETE_REASONS),
+});
 /**
  * Base paginated list response schema.
+ *
+ * @category Pagination
  */
 // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 const paginatedListSchema = (resultSchema) => {
@@ -48,6 +69,7 @@ const paginatedListSchema = (resultSchema) => {
         type: z.enum([
             'block',
             'comment',
+            'custom_emoji',
             'database',
             'data_source',
             'page',
@@ -55,7 +77,9 @@ const paginatedListSchema = (resultSchema) => {
             'page_or_data_source',
             'property_item',
             'user',
+            'view',
         ]),
+        request_status: exports.requestStatusSchema.optional(),
     });
 };
 exports.paginatedListSchema = paginatedListSchema;