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

package/dist/api/pages.api.d.ts

@@ -1,5 +1,5 @@
 import type { NotionClient } from '../client';
-import type { NotionPage } from '../schemas';
+import type { MarkdownContentResponse, NotionPage, PageMarkdown } from '../schemas';
 import { Page } from '../models';
 import { BaseAPI } from './base.api';
 /**
@@ -35,6 +35,11 @@ export interface CreatePageOptions {
     cover?: unknown;
     /** Page content blocks (max 100) */
     children?: unknown[];
+    /**
+     * Page content as a markdown string, as an alternative to `properties`/`children`.
+     * Mutually exclusive with `properties` and `children`.
+     */
+    markdown?: string;
     /** Template to apply when creating the page */
     template?: {
         type: 'none';
@@ -56,6 +61,62 @@ export interface CreatePageOptions {
         type: 'page_end';
     };
 }
+/**
+ * Parent for moving a page.
+ */
+export type MovePageParent = {
+    type: 'page_id';
+    page_id: string;
+} | {
+    type: 'data_source_id';
+    data_source_id: string;
+};
+/**
+ * Options for retrieving a page's content as markdown.
+ */
+export interface GetPageMarkdownOptions {
+    /** Include meeting-note transcript content in the markdown output */
+    include_transcript?: boolean;
+}
+/**
+ * A single find-and-replace edit against a page's markdown content.
+ */
+export interface MarkdownContentUpdate {
+    /** The exact existing markdown substring to replace */
+    old_str: string;
+    /** The replacement markdown content */
+    new_str: string;
+    /** Replace all occurrences of `old_str` instead of just the first */
+    replace_all_matches?: boolean;
+}
+/**
+ * Options for updating a page's markdown content.
+ */
+export type UpdatePageMarkdownOptions = {
+    type: 'update_content';
+    content_updates: MarkdownContentUpdate[];
+    allow_deleting_content?: boolean;
+    allow_async?: boolean;
+} | {
+    type: 'replace_content';
+    new_str: string;
+    allow_deleting_content?: boolean;
+    allow_async?: boolean;
+} | {
+    type: 'insert_content';
+    content: string;
+    position?: {
+        type: 'start' | 'end';
+    };
+    after?: string;
+    allow_async?: boolean;
+} | {
+    type: 'replace_content_range';
+    content: string;
+    content_range: unknown;
+    allow_deleting_content?: boolean;
+    allow_async?: boolean;
+};
 /**
  * Options for updating a page.
  */
@@ -82,6 +143,8 @@ export interface UpdatePageOptions {
 }
 /**
  * Pages API client for working with Notion pages.
+ *
+ * @category Pages
  */
 export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
     protected readonly client: NotionClient;
@@ -98,6 +161,7 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                 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">;
@@ -131,6 +195,7 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                 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">;
@@ -156,6 +221,8 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                 id: import("zod").ZodUUID;
             }, import("zod/v4/core").$strip>]>;
             in_trash: import("zod").ZodBoolean;
+            is_archived: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            is_locked: import("zod").ZodOptional<import("zod").ZodBoolean>;
             icon: import("zod").ZodNullable<import("zod").ZodUnion<readonly [import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
                 type: import("zod").ZodLiteral<"file">;
                 file: import("zod").ZodObject<{
@@ -175,6 +242,30 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
             }, 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">;
@@ -208,6 +299,7 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                     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">;
@@ -300,6 +392,7 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                     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">;
@@ -335,11 +428,11 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                     id: import("zod").ZodString;
                     name: import("zod").ZodString;
                     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";
@@ -371,6 +464,7 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                     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">;
@@ -424,11 +518,11 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                         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";
@@ -493,6 +587,7 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                             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">;
@@ -525,11 +620,11 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                         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";
@@ -560,11 +655,11 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                         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";
@@ -636,11 +731,11 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                     id: import("zod").ZodString;
                     name: import("zod").ZodString;
                     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";
@@ -664,11 +759,11 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                     id: import("zod").ZodString;
                     name: import("zod").ZodString;
                     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";
@@ -703,11 +798,11 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                         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";
@@ -772,6 +867,7 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                             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">;
@@ -804,11 +900,11 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                         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";
@@ -839,11 +935,11 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                         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";
@@ -890,6 +986,7 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
                         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">;
@@ -937,6 +1034,9 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
             }, 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">;
             url: import("zod").ZodURL;
             public_url: import("zod").ZodNullable<import("zod").ZodURL>;
@@ -964,6 +1064,30 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
      * @see https://developers.notion.com/reference/post-page
      */
     create(options: CreatePageOptions): Promise<Page>;
+    /**
+     * Retrieve a page's content as markdown.
+     *
+     * @param pageId - The ID of the page to retrieve
+     * @param options - Options for retrieving the markdown content
+     * @returns The page's markdown content
+     *
+     * @see https://developers.notion.com/guides/data-apis/working-with-markdown-content
+     */
+    getMarkdown(pageId: string, options?: GetPageMarkdownOptions): Promise<PageMarkdown>;
+    /**
+     * Update a page's content as markdown.
+     *
+     * Set `allow_async: true` to allow asynchronous processing for large writes.
+     * In that case, the API returns an `async_task` handle instead of the completed
+     * content. Poll the task with `notion.asyncTasks.poll(task.id)`.
+     *
+     * @param pageId - The ID of the page to update
+     * @param options - The markdown update to apply
+     * @returns The updated markdown content, or an async task handle if processed asynchronously
+     *
+     * @see https://developers.notion.com/guides/data-apis/working-with-markdown-content
+     */
+    updateMarkdown(pageId: string, options: UpdatePageMarkdownOptions): Promise<MarkdownContentResponse>;
     /**
      * Update a page's properties, icon, cover, or trash status.
      *
@@ -974,6 +1098,16 @@ export declare class PagesAPI extends BaseAPI<NotionPage, Page> {
      * @see https://developers.notion.com/reference/patch-page
      */
     update(pageId: string, options: UpdatePageOptions): Promise<Page>;
+    /**
+     * Move a page to a new parent page or data source.
+     *
+     * @param pageId - The ID of the page to move
+     * @param parent - The new parent (a page or a data source)
+     * @returns The moved page wrapped in a Page model
+     *
+     * @see https://developers.notion.com/reference/move-page
+     */
+    move(pageId: string, parent: MovePageParent): Promise<Page>;
     /**
      * Move a page to trash (convenience method).
      *

package/dist/api/pages.api.js

@@ -5,8 +5,20 @@ const schemas_1 = require("../schemas");
 const models_1 = require("../models");
 const validation_1 = require("../validation");
 const base_api_1 = require("./base.api");
+/**
+ * Assert that `markdown` isn't combined with `properties`/`children` when creating a page.
+ *
+ * @throws {NotionValidationError}
+ */
+function validateMarkdownExclusivity(options) {
+    if (options.markdown !== undefined && (options.properties || options.children)) {
+        throw new validation_1.NotionValidationError('markdown cannot be combined with properties or children');
+    }
+}
 /**
  * Pages API client for working with Notion pages.
+ *
+ * @category Pages
  */
 class PagesAPI extends base_api_1.BaseAPI {
     constructor(client) {
@@ -42,11 +54,53 @@ class PagesAPI extends base_api_1.BaseAPI {
      * @see https://developers.notion.com/reference/post-page
      */
     async create(options) {
+        validateMarkdownExclusivity(options);
         if (options.children) {
             (0, validation_1.validateArrayLength)(options.children, validation_1.LIMITS.ARRAY_ELEMENTS, 'children');
         }
         return this.createResource('/pages', options);
     }
+    /**
+     * Retrieve a page's content as markdown.
+     *
+     * @param pageId - The ID of the page to retrieve
+     * @param options - Options for retrieving the markdown content
+     * @returns The page's markdown content
+     *
+     * @see https://developers.notion.com/guides/data-apis/working-with-markdown-content
+     */
+    async getMarkdown(pageId, options) {
+        const query = options?.include_transcript !== undefined
+            ? { include_transcript: String(options.include_transcript) }
+            : undefined;
+        const response = await this.client.request({
+            method: 'GET',
+            path: `/pages/${pageId}/markdown`,
+            query,
+        });
+        return schemas_1.pageMarkdownSchema.parse(response);
+    }
+    /**
+     * Update a page's content as markdown.
+     *
+     * Set `allow_async: true` to allow asynchronous processing for large writes.
+     * In that case, the API returns an `async_task` handle instead of the completed
+     * content. Poll the task with `notion.asyncTasks.poll(task.id)`.
+     *
+     * @param pageId - The ID of the page to update
+     * @param options - The markdown update to apply
+     * @returns The updated markdown content, or an async task handle if processed asynchronously
+     *
+     * @see https://developers.notion.com/guides/data-apis/working-with-markdown-content
+     */
+    async updateMarkdown(pageId, options) {
+        const response = await this.client.request({
+            method: 'PATCH',
+            path: `/pages/${pageId}/markdown`,
+            body: options,
+        });
+        return schemas_1.markdownContentResponseSchema.parse(response);
+    }
     /**
      * Update a page's properties, icon, cover, or trash status.
      *
@@ -59,6 +113,18 @@ class PagesAPI extends base_api_1.BaseAPI {
     async update(pageId, options) {
         return this.updateResource(`/pages/${pageId}`, options);
     }
+    /**
+     * Move a page to a new parent page or data source.
+     *
+     * @param pageId - The ID of the page to move
+     * @param parent - The new parent (a page or a data source)
+     * @returns The moved page wrapped in a Page model
+     *
+     * @see https://developers.notion.com/reference/move-page
+     */
+    async move(pageId, parent) {
+        return this.createResource(`/pages/${pageId}/move`, { parent });
+    }
     /**
      * Move a page to trash (convenience method).
      *

package/dist/api/search.api.d.ts

@@ -8,13 +8,21 @@ import { DataSource, Page } from '../models';
 export type SearchFilterObject = 'page' | 'data_source';
 /**
  * Search filter configuration.
+ *
+ * Combine `in_trash` with the object filter (`property`/`value`), or use it alone
+ * to list only trashed content.
  */
-export interface SearchFilter {
+export type SearchFilter = {
     /** Filter by object type */
     value: SearchFilterObject;
     /** Property to filter on (always "object" for this filter type) */
     property: 'object';
-}
+    /** Whether to list only trashed pages and data sources */
+    in_trash?: boolean;
+} | {
+    /** Whether to list only trashed pages and data sources */
+    in_trash: boolean;
+};
 /**
  * Search sort configuration.
  */
@@ -42,6 +50,8 @@ export interface SearchOptions extends PaginationParameters {
 export type SearchResult = Page | DataSource;
 /**
  * Search API client for searching across the workspace.
+ *
+ * @category Search
  */
 export declare class SearchAPI {
     private readonly client;

package/dist/api/search.api.js

@@ -3,8 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SearchAPI = void 0;
 const schemas_1 = require("../schemas");
 const models_1 = require("../models");
+const base_model_1 = require("../models/base.model");
 /**
  * Search API client for searching across the workspace.
+ *
+ * @category Search
  */
 class SearchAPI {
     constructor(client) {
@@ -41,11 +44,11 @@ class SearchAPI {
         const results = response.results.map((item) => {
             if (item.object === 'page') {
                 const parsed = schemas_1.pageSchema.parse(item);
-                return new models_1.Page(parsed);
+                return new models_1.Page(parsed, base_model_1.TRUSTED);
             }
             else {
                 const parsed = schemas_1.dataSourceSchema.parse(item);
-                return new models_1.DataSource(parsed);
+                return new models_1.DataSource(parsed, base_model_1.TRUSTED);
             }
         });
         return {

package/dist/api/users.api.d.ts

@@ -4,6 +4,8 @@ import { User } from '../models';
 import { BaseAPI } from './base.api';
 /**
  * Users API client for working with Notion users.
+ *
+ * @category Users
  */
 export declare class UsersAPI extends BaseAPI<NotionUser, User> {
     protected readonly client: NotionClient;
@@ -16,6 +18,7 @@ export declare class UsersAPI extends BaseAPI<NotionUser, User> {
             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">;

package/dist/api/users.api.js

@@ -6,6 +6,8 @@ const models_1 = require("../models");
 const base_api_1 = require("./base.api");
 /**
  * Users API client for working with Notion users.
+ *
+ * @category Users
  */
 class UsersAPI extends base_api_1.BaseAPI {
     constructor(client) {