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

package/dist/api/blocks.api.js

@@ -3,10 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BlocksAPI = void 0;
 const schemas_1 = require("../schemas");
 const models_1 = require("../models");
+const base_model_1 = require("../models/base.model");
 const validation_1 = require("../validation");
 const base_api_1 = require("./base.api");
 /**
  * Blocks API client for working with Notion blocks.
+ *
+ * @category Blocks
  */
 class BlocksAPI extends base_api_1.BaseAPI {
     constructor(client) {
@@ -53,12 +56,51 @@ class BlocksAPI extends base_api_1.BaseAPI {
                 const listSchema = (0, schemas_1.paginatedListSchema)(schemas_1.blockSchema);
                 const parsed = listSchema.parse(response);
                 return {
-                    results: parsed.results.map((block) => new models_1.Block(block)),
+                    results: parsed.results.map((block) => new models_1.Block(block, base_model_1.TRUSTED)),
                     next_cursor: parsed.next_cursor,
                     has_more: parsed.has_more,
                 };
             },
         };
+        /**
+         * Meeting-notes query operations.
+         */
+        this.meetingNotes = {
+            /**
+             * Query meeting-notes blocks across the workspace.
+             *
+             * @param options - Filter, sort, and limit options
+             * @returns Matching meeting-notes blocks
+             *
+             * @see https://developers.notion.com/reference/query-meeting-notes
+             */
+            query: async (options) => {
+                if (options?.sort) {
+                    (0, validation_1.validateArrayLength)(options.sort, validation_1.LIMITS.ARRAY_ELEMENTS, 'sort');
+                }
+                const body = {};
+                if (options?.filter) {
+                    body.filter = options.filter;
+                }
+                if (options?.sort) {
+                    body.sort = options.sort;
+                }
+                if (options?.limit) {
+                    body.limit = options.limit;
+                }
+                const response = await this.client.request({
+                    method: 'POST',
+                    path: '/blocks/meeting_notes/query',
+                    body: Object.keys(body).length > 0 ? body : undefined,
+                });
+                const parsed = schemas_1.meetingNotesQueryResponseSchema.parse(response);
+                return {
+                    results: parsed.results.map((b) => new models_1.Block(b, base_model_1.TRUSTED)),
+                    hasMore: parsed.has_more,
+                    requestStatus: parsed.request_status,
+                };
+            },
+        };
     }
     /**
      * Retrieve a block by ID.

package/dist/api/comments.api.d.ts

@@ -36,15 +36,28 @@ export interface CreateCommentOptions {
     };
     /** Optional discussion thread ID to add the comment to */
     discussion_id?: string;
-    /** The comment content as rich text array (max 100 items) */
-    rich_text: unknown[];
+    /** The comment content as rich text array (max 100 items). Exactly one of `rich_text`/`markdown` must be provided. */
+    rich_text?: unknown[];
+    /** The comment content as a markdown string (inline formatting only). Exactly one of `rich_text`/`markdown` must be provided. */
+    markdown?: string;
     /** File attachments (max 3 allowed) */
     attachments?: CommentAttachment[];
     /** Custom display name for the comment */
     display_name?: CommentDisplayName;
 }
+/**
+ * Options for updating a comment.
+ */
+export interface UpdateCommentOptions {
+    /** The comment content as rich text array (max 100 items). Exactly one of `rich_text`/`markdown` must be provided. */
+    rich_text?: unknown[];
+    /** The comment content as a markdown string (inline formatting only). Exactly one of `rich_text`/`markdown` must be provided. */
+    markdown?: string;
+}
 /**
  * Comments API client for working with Notion comments.
+ *
+ * @category Comments
  */
 export declare class CommentsAPI extends BaseAPI<NotionComment, Comment> {
     protected readonly client: NotionClient;
@@ -68,6 +81,9 @@ export declare class CommentsAPI extends BaseAPI<NotionComment, Comment> {
             }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
                 type: import("zod").ZodLiteral<"block_id">;
                 block_id: import("zod").ZodUUID;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                type: import("zod").ZodLiteral<"agent_id">;
+                agent_id: import("zod").ZodUUID;
             }, import("zod/v4/core").$strip>], "type">;
             discussion_id: import("zod").ZodUUID;
             created_time: import("zod").ZodUnion<readonly [import("zod").ZodISODateTime, import("zod").ZodISODate]>;
@@ -79,6 +95,7 @@ export declare class CommentsAPI extends BaseAPI<NotionComment, Comment> {
                 avatar_url: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodURL, import("zod").ZodNull]>>;
                 person: import("zod").ZodObject<{
                     email: import("zod").ZodEmail;
+                    email_verified: import("zod").ZodOptional<import("zod").ZodBoolean>;
                 }, import("zod/v4/core").$strip>;
             }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
                 object: import("zod").ZodLiteral<"user">;
@@ -119,11 +136,11 @@ export declare class CommentsAPI extends BaseAPI<NotionComment, Comment> {
                     underline: import("zod").ZodBoolean;
                     code: import("zod").ZodBoolean;
                     color: import("zod").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";
@@ -188,6 +205,7 @@ export declare class CommentsAPI extends BaseAPI<NotionComment, Comment> {
                         avatar_url: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodURL, import("zod").ZodNull]>>;
                         person: import("zod").ZodObject<{
                             email: import("zod").ZodEmail;
+                            email_verified: import("zod").ZodOptional<import("zod").ZodBoolean>;
                         }, import("zod/v4/core").$strip>;
                     }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
                         object: import("zod").ZodLiteral<"user">;
@@ -220,11 +238,11 @@ export declare class CommentsAPI extends BaseAPI<NotionComment, Comment> {
                     underline: import("zod").ZodBoolean;
                     code: import("zod").ZodBoolean;
                     color: import("zod").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";
@@ -255,11 +273,11 @@ export declare class CommentsAPI extends BaseAPI<NotionComment, Comment> {
                     underline: import("zod").ZodBoolean;
                     code: import("zod").ZodBoolean;
                     color: import("zod").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";
@@ -323,4 +341,23 @@ export declare class CommentsAPI extends BaseAPI<NotionComment, Comment> {
      * @see https://developers.notion.com/reference/create-a-comment
      */
     create(options: CreateCommentOptions): Promise<Comment>;
+    /**
+     * Update an existing comment's content.
+     *
+     * @param commentId - The ID of the comment to update
+     * @param options - The updated comment content (`rich_text` or `markdown`)
+     * @returns The updated comment wrapped in a Comment model
+     *
+     * @see https://developers.notion.com/reference/update-a-comment
+     */
+    update(commentId: string, options: UpdateCommentOptions): Promise<Comment>;
+    /**
+     * Delete a comment. A connection can only delete comments it created.
+     *
+     * @param commentId - The ID of the comment to delete
+     * @returns The deleted comment wrapped in a Comment model
+     *
+     * @see https://developers.notion.com/reference/delete-a-comment
+     */
+    delete(commentId: string): Promise<Comment>;
 }

package/dist/api/comments.api.js

@@ -5,8 +5,22 @@ const schemas_1 = require("../schemas");
 const models_1 = require("../models");
 const validation_1 = require("../validation");
 const base_api_1 = require("./base.api");
+/**
+ * Assert that exactly one of `rich_text`/`markdown` is provided for a comment body.
+ *
+ * @throws {NotionValidationError}
+ */
+function validateCommentContent(options) {
+    const hasRichText = options.rich_text !== undefined;
+    const hasMarkdown = options.markdown !== undefined;
+    if (hasRichText === hasMarkdown) {
+        throw new validation_1.NotionValidationError('Exactly one of rich_text or markdown must be provided');
+    }
+}
 /**
  * Comments API client for working with Notion comments.
+ *
+ * @category Comments
  */
 class CommentsAPI extends base_api_1.BaseAPI {
     constructor(client) {
@@ -43,11 +57,41 @@ class CommentsAPI extends base_api_1.BaseAPI {
      * @see https://developers.notion.com/reference/create-a-comment
      */
     async create(options) {
-        (0, validation_1.validateArrayLength)(options.rich_text, validation_1.LIMITS.ARRAY_ELEMENTS, 'rich_text');
+        validateCommentContent(options);
+        if (options.rich_text) {
+            (0, validation_1.validateArrayLength)(options.rich_text, validation_1.LIMITS.ARRAY_ELEMENTS, 'rich_text');
+        }
         if (options.attachments) {
             (0, validation_1.validateArrayLength)(options.attachments, validation_1.LIMITS.COMMENT_ATTACHMENTS, 'attachments');
         }
         return this.createResource('/comments', options);
     }
+    /**
+     * Update an existing comment's content.
+     *
+     * @param commentId - The ID of the comment to update
+     * @param options - The updated comment content (`rich_text` or `markdown`)
+     * @returns The updated comment wrapped in a Comment model
+     *
+     * @see https://developers.notion.com/reference/update-a-comment
+     */
+    async update(commentId, options) {
+        validateCommentContent(options);
+        if (options.rich_text) {
+            (0, validation_1.validateArrayLength)(options.rich_text, validation_1.LIMITS.ARRAY_ELEMENTS, 'rich_text');
+        }
+        return this.updateResource(`/comments/${commentId}`, options);
+    }
+    /**
+     * Delete a comment. A connection can only delete comments it created.
+     *
+     * @param commentId - The ID of the comment to delete
+     * @returns The deleted comment wrapped in a Comment model
+     *
+     * @see https://developers.notion.com/reference/delete-a-comment
+     */
+    async delete(commentId) {
+        return this.deleteResource(`/comments/${commentId}`);
+    }
 }
 exports.CommentsAPI = CommentsAPI;

package/dist/api/customEmojis.api.d.ts

@@ -0,0 +1,38 @@
+import type { NotionClient } from '../client';
+import { type NotionCustomEmoji, type PaginatedList, type PaginationParameters } from '../schemas';
+import { CustomEmoji } from '../models';
+import { BaseAPI } from './base.api';
+/**
+ * Options for listing custom emojis.
+ */
+export interface ListCustomEmojisOptions extends PaginationParameters {
+    /** Filter custom emojis by exact name match */
+    name?: string;
+}
+/**
+ * Custom Emojis API client for working with Notion workspace custom emojis.
+ *
+ * @category Custom Emoji & Icons
+ */
+export declare class CustomEmojisAPI extends BaseAPI<NotionCustomEmoji, CustomEmoji> {
+    protected readonly client: NotionClient;
+    protected config: {
+        schema: import("zod").ZodObject<{
+            id: import("zod").ZodUUID;
+            name: import("zod").ZodString;
+            url: import("zod").ZodURL;
+        }, import("zod/v4/core").$strip>;
+        ModelClass: typeof CustomEmoji;
+        listType: "custom_emoji";
+    };
+    constructor(client: NotionClient);
+    /**
+     * List the custom emojis available in the workspace (paginated).
+     *
+     * @param options - Options for filtering by name and paginating results
+     * @returns Paginated list of custom emojis
+     *
+     * @see https://developers.notion.com/reference/list-custom-emojis
+     */
+    list(options?: ListCustomEmojisOptions): Promise<PaginatedList<CustomEmoji>>;
+}

package/dist/api/customEmojis.api.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomEmojisAPI = void 0;
+const schemas_1 = require("../schemas");
+const models_1 = require("../models");
+const base_api_1 = require("./base.api");
+/**
+ * Custom Emojis API client for working with Notion workspace custom emojis.
+ *
+ * @category Custom Emoji & Icons
+ */
+class CustomEmojisAPI extends base_api_1.BaseAPI {
+    constructor(client) {
+        super(client);
+        this.client = client;
+        this.config = {
+            schema: schemas_1.customEmojiSchema,
+            ModelClass: models_1.CustomEmoji,
+            listType: 'custom_emoji',
+        };
+    }
+    /**
+     * List the custom emojis available in the workspace (paginated).
+     *
+     * @param options - Options for filtering by name and paginating results
+     * @returns Paginated list of custom emojis
+     *
+     * @see https://developers.notion.com/reference/list-custom-emojis
+     */
+    async list(options) {
+        const query = {
+            ...(options?.name ? { name: options.name } : {}),
+            ...this.buildPaginationQuery(options),
+        };
+        return this.listResources('/custom_emojis', query);
+    }
+}
+exports.CustomEmojisAPI = CustomEmojisAPI;

package/dist/api/dataSources.api.d.ts

@@ -1,5 +1,5 @@
 import type { NotionClient } from '../client';
-import { type NotionDataSource, type PaginatedList, type PaginationParameters } from '../schemas';
+import { type DataSourceTemplateList, type NotionDataSource, type PaginatedList, type PaginationParameters } from '../schemas';
 import { DataSource, Page } from '../models';
 import { BaseAPI } from './base.api';
 /**
@@ -43,9 +43,16 @@ export interface RetrieveDataSourceOptions {
     /** Filter properties to include in the response */
     filter_properties?: string[];
 }
+/**
+ * Options for listing a data source's templates.
+ */
+export interface ListDataSourceTemplatesOptions extends PaginationParameters {
+    /** Filter templates by name (case-insensitive substring match) */
+    name?: string;
+}
 /**
  * Filter condition for data source queries.
- * This is a simplified type - the actual Notion API supports many filter types.
+ * This type is simplified. The Notion API supports many more filter types.
  * See: https://developers.notion.com/reference/filter-data-source-entries
  */
 export type DataSourceFilter = Record<string, unknown>;
@@ -82,8 +89,8 @@ export interface QueryDataSourceOptions extends PaginationParameters {
     /**
      * Whether to return only trashed pages (true) or only non-trashed pages (false).
      *
-     * @deprecated Use `is_archived` instead. Kept as an alias forwarded into
-     * `is_archived`; if both are provided, `is_archived` takes precedence.
+     * @deprecated Use `is_archived` instead. This field is an alias that forwards
+     * into `is_archived`. If you provide both fields, `is_archived` takes precedence.
      */
     in_trash?: boolean;
 }
@@ -92,6 +99,8 @@ export interface QueryDataSourceOptions extends PaginationParameters {
  *
  * Data sources are individual tables of data that live under a Notion database.
  * As of API version 2025-09-03, data sources have their own API endpoints.
+ *
+ * @category Databases & Data Sources
  */
 export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource> {
     protected readonly client: NotionClient;
@@ -165,9 +174,9 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
                         id: import("zod").ZodString;
                         name: import("zod").ZodString;
                         color: import("zod").ZodEnum<{
+                            default: "default";
                             blue: "blue";
                             brown: "brown";
-                            default: "default";
                             gray: "gray";
                             green: "green";
                             orange: "orange";
@@ -309,9 +318,9 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
                         id: import("zod").ZodString;
                         name: import("zod").ZodString;
                         color: import("zod").ZodEnum<{
+                            default: "default";
                             blue: "blue";
                             brown: "brown";
-                            default: "default";
                             gray: "gray";
                             green: "green";
                             orange: "orange";
@@ -332,9 +341,9 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
                         id: import("zod").ZodString;
                         name: import("zod").ZodString;
                         color: import("zod").ZodEnum<{
+                            default: "default";
                             blue: "blue";
                             brown: "brown";
-                            default: "default";
                             gray: "gray";
                             green: "green";
                             orange: "orange";
@@ -348,9 +357,9 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
                         id: import("zod").ZodString;
                         name: import("zod").ZodString;
                         color: import("zod").ZodEnum<{
+                            default: "default";
                             blue: "blue";
                             brown: "brown";
-                            default: "default";
                             gray: "gray";
                             green: "green";
                             orange: "orange";
@@ -399,6 +408,9 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
             }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
                 type: import("zod").ZodLiteral<"block_id">;
                 block_id: import("zod").ZodUUID;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                type: import("zod").ZodLiteral<"agent_id">;
+                agent_id: import("zod").ZodUUID;
             }, import("zod/v4/core").$strip>], "type">;
             database_parent: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
                 type: import("zod").ZodLiteral<"database_id">;
@@ -416,6 +428,9 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
             }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
                 type: import("zod").ZodLiteral<"block_id">;
                 block_id: import("zod").ZodUUID;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                type: import("zod").ZodLiteral<"agent_id">;
+                agent_id: import("zod").ZodUUID;
             }, import("zod/v4/core").$strip>], "type">;
             created_time: import("zod").ZodUnion<readonly [import("zod").ZodISODateTime, import("zod").ZodISODate]>;
             created_by: import("zod").ZodUnion<readonly [import("zod").ZodObject<{
@@ -426,6 +441,7 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
                 avatar_url: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodURL, import("zod").ZodNull]>>;
                 person: import("zod").ZodObject<{
                     email: import("zod").ZodEmail;
+                    email_verified: import("zod").ZodOptional<import("zod").ZodBoolean>;
                 }, import("zod/v4/core").$strip>;
             }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
                 object: import("zod").ZodLiteral<"user">;
@@ -459,6 +475,7 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
                 avatar_url: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodURL, import("zod").ZodNull]>>;
                 person: import("zod").ZodObject<{
                     email: import("zod").ZodEmail;
+                    email_verified: import("zod").ZodOptional<import("zod").ZodBoolean>;
                 }, import("zod/v4/core").$strip>;
             }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
                 object: import("zod").ZodLiteral<"user">;
@@ -498,11 +515,11 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
                     underline: import("zod").ZodBoolean;
                     code: import("zod").ZodBoolean;
                     color: import("zod").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";
@@ -567,6 +584,7 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
                         avatar_url: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodURL, import("zod").ZodNull]>>;
                         person: import("zod").ZodObject<{
                             email: import("zod").ZodEmail;
+                            email_verified: import("zod").ZodOptional<import("zod").ZodBoolean>;
                         }, import("zod/v4/core").$strip>;
                     }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
                         object: import("zod").ZodLiteral<"user">;
@@ -599,11 +617,11 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
                     underline: import("zod").ZodBoolean;
                     code: import("zod").ZodBoolean;
                     color: import("zod").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";
@@ -634,11 +652,11 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
                     underline: import("zod").ZodBoolean;
                     code: import("zod").ZodBoolean;
                     color: import("zod").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";
@@ -673,11 +691,11 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
                     underline: import("zod").ZodBoolean;
                     code: import("zod").ZodBoolean;
                     color: import("zod").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";
@@ -742,6 +760,7 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
                         avatar_url: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodURL, import("zod").ZodNull]>>;
                         person: import("zod").ZodObject<{
                             email: import("zod").ZodEmail;
+                            email_verified: import("zod").ZodOptional<import("zod").ZodBoolean>;
                         }, import("zod/v4/core").$strip>;
                     }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
                         object: import("zod").ZodLiteral<"user">;
@@ -774,11 +793,11 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
                     underline: import("zod").ZodBoolean;
                     code: import("zod").ZodBoolean;
                     color: import("zod").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";
@@ -809,11 +828,11 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
                     underline: import("zod").ZodBoolean;
                     code: import("zod").ZodBoolean;
                     color: import("zod").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";
@@ -852,6 +871,30 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
             }, import("zod/v4/core").$strip>], "type">, import("zod").ZodObject<{
                 type: import("zod").ZodLiteral<"emoji">;
                 emoji: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                type: import("zod").ZodLiteral<"icon">;
+                icon: import("zod").ZodObject<{
+                    name: import("zod").ZodString;
+                    color: import("zod").ZodOptional<import("zod").ZodEnum<{
+                        blue: "blue";
+                        brown: "brown";
+                        gray: "gray";
+                        green: "green";
+                        orange: "orange";
+                        pink: "pink";
+                        purple: "purple";
+                        red: "red";
+                        yellow: "yellow";
+                        lightgray: "lightgray";
+                    }>>;
+                }, import("zod/v4/core").$strip>;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                type: import("zod").ZodLiteral<"custom_emoji">;
+                custom_emoji: import("zod").ZodObject<{
+                    id: import("zod").ZodUUID;
+                    name: import("zod").ZodOptional<import("zod").ZodString>;
+                    url: import("zod").ZodOptional<import("zod").ZodURL>;
+                }, import("zod/v4/core").$strip>;
             }, import("zod/v4/core").$strip>]>>;
             cover: import("zod").ZodNullable<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
                 type: import("zod").ZodLiteral<"file">;
@@ -889,6 +932,16 @@ export declare class DataSourcesAPI extends BaseAPI<NotionDataSource, DataSource
      * @see https://developers.notion.com/reference/retrieve-a-data-source
      */
     retrieve(dataSourceId: string, options?: RetrieveDataSourceOptions): Promise<DataSource>;
+    /**
+     * List the templates available for a data source.
+     *
+     * @param dataSourceId - The ID of the data source
+     * @param options - Options for filtering by name and paginating results
+     * @returns The list of templates, along with pagination metadata
+     *
+     * @see https://developers.notion.com/reference/list-data-source-templates
+     */
+    listTemplates(dataSourceId: string, options?: ListDataSourceTemplatesOptions): Promise<DataSourceTemplateList>;
     /**
      * Query a data source with optional filters and sorts.
      * Returns pages that match the query.

package/dist/api/dataSources.api.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DataSourcesAPI = void 0;
 const schemas_1 = require("../schemas");
 const models_1 = require("../models");
+const base_model_1 = require("../models/base.model");
 const validation_1 = require("../validation");
 const base_api_1 = require("./base.api");
 /**
@@ -10,6 +11,8 @@ const base_api_1 = require("./base.api");
  *
  * Data sources are individual tables of data that live under a Notion database.
  * As of API version 2025-09-03, data sources have their own API endpoints.
+ *
+ * @category Databases & Data Sources
  */
 class DataSourcesAPI extends base_api_1.BaseAPI {
     constructor(client) {
@@ -36,6 +39,27 @@ class DataSourcesAPI extends base_api_1.BaseAPI {
         };
         return this.retrieveResource(`/data_sources/${dataSourceId}`, query);
     }
+    /**
+     * List the templates available for a data source.
+     *
+     * @param dataSourceId - The ID of the data source
+     * @param options - Options for filtering by name and paginating results
+     * @returns The list of templates, along with pagination metadata
+     *
+     * @see https://developers.notion.com/reference/list-data-source-templates
+     */
+    async listTemplates(dataSourceId, options) {
+        const query = {
+            ...(options?.name ? { name: options.name } : {}),
+            ...this.buildPaginationQuery(options),
+        };
+        const response = await this.client.request({
+            method: 'GET',
+            path: `/data_sources/${dataSourceId}/templates`,
+            query: Object.keys(query).length > 0 ? query : undefined,
+        });
+        return schemas_1.dataSourceTemplateListSchema.parse(response);
+    }
     /**
      * Query a data source with optional filters and sorts.
      * Returns pages that match the query.
@@ -82,10 +106,11 @@ class DataSourcesAPI extends base_api_1.BaseAPI {
         const parsed = listSchema.parse(response);
         return {
             object: 'list',
-            results: parsed.results.map((page) => new models_1.Page(page)),
+            results: parsed.results.map((page) => new models_1.Page(page, base_model_1.TRUSTED)),
             next_cursor: parsed.next_cursor,
             has_more: parsed.has_more,
             type: 'page',
+            request_status: parsed.request_status,
         };
     }
     /**