@visus-io/notion-sdk-ts 3.0.1 → 3.1.0

package/dist/api/pages.api.js

@@ -5,6 +5,16 @@ 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.
  */
@@ -42,11 +52,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.
+     *
+     * When `allow_async: true` is set and the write is large, the API may return an
+     * `async_task` handle instead of completing synchronously -- poll it via
+     * `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 +111,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.
+ *
+ * `in_trash` can be combined with the object filter (`property`/`value`) or
+ * used on its own 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.
  */

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

@@ -16,6 +16,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/views.api.d.ts

@@ -0,0 +1,284 @@
+import type { NotionClient } from '../client';
+import { Page, View } from '../models';
+import { type NotionView, type PaginatedList, type PaginationParameters, type RequestStatus, type ViewDeleteResult, type ViewType } from '../schemas';
+import { BaseAPI } from './base.api';
+import type { DataSourceSort } from './dataSources.api';
+/**
+ * Options for listing views. Exactly one of `database_id`/`data_source_id` must be provided.
+ */
+export interface ListViewsOptions extends PaginationParameters {
+    /** List views for this database (mutually exclusive with data_source_id) */
+    database_id?: string;
+    /** List views for this data source (mutually exclusive with database_id) */
+    data_source_id?: string;
+}
+/**
+ * Options for creating a view. Exactly one of `database_id`/`view_id`/`create_database`
+ * must be provided to select the parent context.
+ */
+export interface CreateViewOptions {
+    /** The data source the view displays */
+    data_source_id: string;
+    /** The view name */
+    name: string;
+    /** The view layout type */
+    type: ViewType;
+    /** Attach the view to this existing database */
+    database_id?: string;
+    /** Clone the configuration of this existing view */
+    view_id?: string;
+    /** Create a new database to hold the view */
+    create_database?: true;
+    /** Filter configuration */
+    filter?: Record<string, unknown>;
+    /** Sort configuration */
+    sorts?: DataSourceSort[];
+    /** Quick filter configuration */
+    quick_filters?: Record<string, unknown>;
+    /** Per-layout configuration */
+    configuration?: Record<string, unknown>;
+    /** Where to place the new view relative to existing views */
+    position?: Record<string, unknown>;
+}
+/**
+ * Options for updating a view. All fields optional; passing `null` for
+ * filter/sorts/quick_filters clears the existing value.
+ */
+export interface UpdateViewOptions {
+    /** Rename the view */
+    name?: string;
+    /** Update or clear (`null`) the filter configuration */
+    filter?: Record<string, unknown> | null;
+    /** Update or clear (`null`) the sort configuration */
+    sorts?: DataSourceSort[] | null;
+    /** Update or clear (`null`) the quick filter configuration */
+    quick_filters?: Record<string, unknown> | null;
+    /** Shallow-merged per-layout configuration update */
+    configuration?: Record<string, unknown>;
+}
+/**
+ * Options for creating a view query.
+ */
+export interface CreateViewQueryOptions extends PaginationParameters {
+    /** Filter configuration */
+    filter?: Record<string, unknown>;
+    /** Sort configuration */
+    sorts?: DataSourceSort[];
+}
+/**
+ * Result of a view query. Non-standard pagination shape distinct from
+ * {@link PaginatedList} -- includes `totalCount` and an `expiresAt` after which the
+ * query can no longer be retrieved via {@link ViewsAPI.queries.get}.
+ */
+export interface ViewQueryResult {
+    id: string;
+    viewId: string;
+    expiresAt: Date;
+    totalCount: number;
+    results: Page[];
+    nextCursor: string | null;
+    hasMore: boolean;
+    requestStatus?: RequestStatus;
+}
+/**
+ * Views API client for working with Notion views.
+ *
+ * Views control how a database/data source's rows are displayed (table, board,
+ * calendar, etc.). Requires API version 2025-09-03 or later.
+ */
+export declare class ViewsAPI extends BaseAPI<NotionView, View> {
+    protected readonly client: NotionClient;
+    protected config: {
+        schema: import("zod").ZodObject<{
+            object: import("zod").ZodLiteral<"view">;
+            id: import("zod").ZodUUID;
+            parent: import("zod").ZodObject<{
+                type: import("zod").ZodLiteral<"database_id">;
+                database_id: import("zod").ZodUUID;
+            }, import("zod/v4/core").$strip>;
+            data_source_id: import("zod").ZodNullable<import("zod").ZodUUID>;
+            name: import("zod").ZodString;
+            type: import("zod").ZodEnum<{
+                map: "map";
+                table: "table";
+                list: "list";
+                board: "board";
+                calendar: "calendar";
+                timeline: "timeline";
+                gallery: "gallery";
+                form: "form";
+                chart: "chart";
+                dashboard: "dashboard";
+            }>;
+            filter: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>>;
+            sorts: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>>>;
+            quick_filters: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>>;
+            configuration: import("zod").ZodOptional<import("zod").ZodObject<{
+                type: import("zod").ZodEnum<{
+                    map: "map";
+                    table: "table";
+                    list: "list";
+                    board: "board";
+                    calendar: "calendar";
+                    timeline: "timeline";
+                    gallery: "gallery";
+                    form: "form";
+                    chart: "chart";
+                    dashboard: "dashboard";
+                }>;
+            }, import("zod/v4/core").$catchall<import("zod").ZodUnknown>>>;
+            created_time: import("zod").ZodUnion<readonly [import("zod").ZodISODateTime, import("zod").ZodISODate]>;
+            last_edited_time: import("zod").ZodUnion<readonly [import("zod").ZodISODateTime, import("zod").ZodISODate]>;
+            created_by: import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+                object: import("zod").ZodLiteral<"user">;
+                id: import("zod").ZodUUID;
+                type: import("zod").ZodLiteral<"person">;
+                name: import("zod").ZodOptional<import("zod").ZodString>;
+                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">;
+                id: import("zod").ZodUUID;
+                type: import("zod").ZodLiteral<"bot">;
+                name: import("zod").ZodOptional<import("zod").ZodString>;
+                avatar_url: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodURL, import("zod").ZodNull]>>;
+                bot: import("zod").ZodObject<{
+                    owner: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+                        type: import("zod").ZodLiteral<"workspace">;
+                        workspace: import("zod").ZodLiteral<true>;
+                    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                        type: import("zod").ZodLiteral<"user">;
+                    }, import("zod/v4/core").$strip>], "type">;
+                    workspace_name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+                    workspace_id: import("zod").ZodOptional<import("zod").ZodString>;
+                    workspace_limits: import("zod").ZodOptional<import("zod").ZodObject<{
+                        max_file_upload_size_in_bytes: import("zod").ZodInt;
+                    }, import("zod/v4/core").$strip>>;
+                }, import("zod/v4/core").$strip>;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                object: import("zod").ZodLiteral<"user">;
+                id: import("zod").ZodUUID;
+            }, import("zod/v4/core").$strip>]>;
+            last_edited_by: import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+                object: import("zod").ZodLiteral<"user">;
+                id: import("zod").ZodUUID;
+                type: import("zod").ZodLiteral<"person">;
+                name: import("zod").ZodOptional<import("zod").ZodString>;
+                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">;
+                id: import("zod").ZodUUID;
+                type: import("zod").ZodLiteral<"bot">;
+                name: import("zod").ZodOptional<import("zod").ZodString>;
+                avatar_url: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodURL, import("zod").ZodNull]>>;
+                bot: import("zod").ZodObject<{
+                    owner: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+                        type: import("zod").ZodLiteral<"workspace">;
+                        workspace: import("zod").ZodLiteral<true>;
+                    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                        type: import("zod").ZodLiteral<"user">;
+                    }, import("zod/v4/core").$strip>], "type">;
+                    workspace_name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+                    workspace_id: import("zod").ZodOptional<import("zod").ZodString>;
+                    workspace_limits: import("zod").ZodOptional<import("zod").ZodObject<{
+                        max_file_upload_size_in_bytes: import("zod").ZodInt;
+                    }, import("zod/v4/core").$strip>>;
+                }, import("zod/v4/core").$strip>;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                object: import("zod").ZodLiteral<"user">;
+                id: import("zod").ZodUUID;
+            }, import("zod/v4/core").$strip>]>;
+            url: import("zod").ZodURL;
+            dashboard_view_id: import("zod").ZodOptional<import("zod").ZodUUID>;
+        }, import("zod/v4/core").$strip>;
+        ModelClass: typeof View;
+        listType: "view";
+    };
+    constructor(client: NotionClient);
+    /**
+     * List the views for a database or data source.
+     *
+     * @param options - Exactly one of `database_id`/`data_source_id`, plus pagination
+     * @returns Paginated list of views
+     *
+     * @throws {NotionValidationError} If neither or both of `database_id`/`data_source_id` are provided
+     *
+     * @see https://developers.notion.com/guides/data-apis/working-with-views
+     */
+    list(options: ListViewsOptions): Promise<PaginatedList<View>>;
+    /**
+     * Retrieve a view by ID.
+     *
+     * @param viewId - The ID of the view to retrieve
+     * @returns The view wrapped in a View model
+     *
+     * @see https://developers.notion.com/guides/data-apis/working-with-views
+     */
+    retrieve(viewId: string): Promise<View>;
+    /**
+     * Create a new view.
+     *
+     * @param options - Options for creating the view
+     * @returns The created view wrapped in a View model
+     *
+     * @throws {NotionValidationError} If not exactly one of `database_id`/`view_id`/`create_database` is provided
+     *
+     * @see https://developers.notion.com/guides/data-apis/working-with-views
+     */
+    create(options: CreateViewOptions): Promise<View>;
+    /**
+     * Update a view's name, filter, sorts, quick filters, or configuration.
+     *
+     * @param viewId - The ID of the view to update
+     * @param options - Options for updating the view
+     * @returns The updated view wrapped in a View model
+     *
+     * @see https://developers.notion.com/guides/data-apis/working-with-views
+     */
+    update(viewId: string, options: UpdateViewOptions): Promise<View>;
+    /**
+     * Delete a view.
+     *
+     * Note: unlike other delete methods, Notion's delete-view response only includes
+     * `object`/`id`/`parent`/`type` (not the full view shape), so this returns the raw
+     * parsed result rather than a full {@link View} model.
+     *
+     * @param viewId - The ID of the view to delete
+     * @returns The partial view object returned by the API
+     *
+     * @see https://developers.notion.com/guides/data-apis/working-with-views
+     */
+    delete(viewId: string): Promise<ViewDeleteResult>;
+    /**
+     * Sub-resource for querying a view's rows. View queries are non-standard: they
+     * return a `total_count` and `expires_at`, and the query result itself expires
+     * roughly 15 minutes after creation.
+     */
+    readonly queries: {
+        /**
+         * Create a new query against a view.
+         *
+         * @see https://developers.notion.com/guides/data-apis/working-with-views
+         */
+        create: (viewId: string, options?: CreateViewQueryOptions) => Promise<ViewQueryResult>;
+        /**
+         * Retrieve the results of a previously created view query.
+         *
+         * @see https://developers.notion.com/guides/data-apis/working-with-views
+         */
+        get: (viewId: string, queryId: string) => Promise<ViewQueryResult>;
+        /**
+         * Delete a view query.
+         *
+         * @see https://developers.notion.com/guides/data-apis/working-with-views
+         */
+        delete: (viewId: string, queryId: string) => Promise<void>;
+    };
+}

package/dist/api/views.api.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewsAPI = void 0;
+const models_1 = require("../models");
+const schemas_1 = require("../schemas");
+const validation_1 = require("../validation");
+const base_api_1 = require("./base.api");
+function toViewQueryResult(response) {
+    const parsed = schemas_1.viewQueryResponseSchema.parse(response);
+    return {
+        id: parsed.id,
+        viewId: parsed.view_id,
+        expiresAt: new Date(parsed.expires_at),
+        totalCount: parsed.total_count,
+        results: parsed.results.map((page) => new models_1.Page(page)),
+        nextCursor: parsed.next_cursor,
+        hasMore: parsed.has_more,
+        requestStatus: parsed.request_status,
+    };
+}
+/**
+ * Views API client for working with Notion views.
+ *
+ * Views control how a database/data source's rows are displayed (table, board,
+ * calendar, etc.). Requires API version 2025-09-03 or later.
+ */
+class ViewsAPI extends base_api_1.BaseAPI {
+    constructor(client) {
+        super(client);
+        this.client = client;
+        this.config = {
+            schema: schemas_1.viewSchema,
+            ModelClass: models_1.View,
+            listType: 'view',
+        };
+        /**
+         * Sub-resource for querying a view's rows. View queries are non-standard: they
+         * return a `total_count` and `expires_at`, and the query result itself expires
+         * roughly 15 minutes after creation.
+         */
+        this.queries = {
+            /**
+             * Create a new query against a view.
+             *
+             * @see https://developers.notion.com/guides/data-apis/working-with-views
+             */
+            create: async (viewId, options) => {
+                const body = {};
+                if (options?.filter) {
+                    body.filter = options.filter;
+                }
+                if (options?.sorts) {
+                    body.sorts = options.sorts;
+                }
+                Object.assign(body, this.buildPaginationBody(options));
+                const response = await this.client.request({
+                    method: 'POST',
+                    path: `/views/${viewId}/queries`,
+                    body: Object.keys(body).length > 0 ? body : undefined,
+                });
+                return toViewQueryResult(response);
+            },
+            /**
+             * Retrieve the results of a previously created view query.
+             *
+             * @see https://developers.notion.com/guides/data-apis/working-with-views
+             */
+            get: async (viewId, queryId) => {
+                const response = await this.client.request({
+                    method: 'GET',
+                    path: `/views/${viewId}/queries/${queryId}`,
+                });
+                return toViewQueryResult(response);
+            },
+            /**
+             * Delete a view query.
+             *
+             * @see https://developers.notion.com/guides/data-apis/working-with-views
+             */
+            delete: async (viewId, queryId) => {
+                await this.client.request({
+                    method: 'DELETE',
+                    path: `/views/${viewId}/queries/${queryId}`,
+                });
+            },
+        };
+    }
+    /**
+     * List the views for a database or data source.
+     *
+     * @param options - Exactly one of `database_id`/`data_source_id`, plus pagination
+     * @returns Paginated list of views
+     *
+     * @throws {NotionValidationError} If neither or both of `database_id`/`data_source_id` are provided
+     *
+     * @see https://developers.notion.com/guides/data-apis/working-with-views
+     */
+    async list(options) {
+        if (Boolean(options.database_id) === Boolean(options.data_source_id)) {
+            throw new validation_1.NotionValidationError('Exactly one of database_id or data_source_id must be provided');
+        }
+        const query = {
+            ...(options.database_id ? { database_id: options.database_id } : {}),
+            ...(options.data_source_id ? { data_source_id: options.data_source_id } : {}),
+            ...this.buildPaginationQuery(options),
+        };
+        return this.listResources('/views', query);
+    }
+    /**
+     * Retrieve a view by ID.
+     *
+     * @param viewId - The ID of the view to retrieve
+     * @returns The view wrapped in a View model
+     *
+     * @see https://developers.notion.com/guides/data-apis/working-with-views
+     */
+    async retrieve(viewId) {
+        return this.retrieveResource(`/views/${viewId}`);
+    }
+    /**
+     * Create a new view.
+     *
+     * @param options - Options for creating the view
+     * @returns The created view wrapped in a View model
+     *
+     * @throws {NotionValidationError} If not exactly one of `database_id`/`view_id`/`create_database` is provided
+     *
+     * @see https://developers.notion.com/guides/data-apis/working-with-views
+     */
+    async create(options) {
+        const selectorCount = [options.database_id, options.view_id, options.create_database].filter((value) => value !== undefined).length;
+        if (selectorCount !== 1) {
+            throw new validation_1.NotionValidationError('Exactly one of database_id, view_id, or create_database must be provided');
+        }
+        return this.createResource('/views', options);
+    }
+    /**
+     * Update a view's name, filter, sorts, quick filters, or configuration.
+     *
+     * @param viewId - The ID of the view to update
+     * @param options - Options for updating the view
+     * @returns The updated view wrapped in a View model
+     *
+     * @see https://developers.notion.com/guides/data-apis/working-with-views
+     */
+    async update(viewId, options) {
+        return this.updateResource(`/views/${viewId}`, options);
+    }
+    /**
+     * Delete a view.
+     *
+     * Note: unlike other delete methods, Notion's delete-view response only includes
+     * `object`/`id`/`parent`/`type` (not the full view shape), so this returns the raw
+     * parsed result rather than a full {@link View} model.
+     *
+     * @param viewId - The ID of the view to delete
+     * @returns The partial view object returned by the API
+     *
+     * @see https://developers.notion.com/guides/data-apis/working-with-views
+     */
+    async delete(viewId) {
+        const response = await this.client.request({
+            method: 'DELETE',
+            path: `/views/${viewId}`,
+        });
+        return schemas_1.viewDeleteResponseSchema.parse(response);
+    }
+}
+exports.ViewsAPI = ViewsAPI;

package/dist/client.d.ts

@@ -26,7 +26,7 @@ export interface NotionClientOptions {
 export interface RequestOptions {
     method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
     path: string;
-    query?: Record<string, string | number | boolean | undefined>;
+    query?: Record<string, string | number | boolean | string[] | undefined>;
     body?: unknown;
 }
 /**

package/dist/client.js

@@ -29,10 +29,10 @@ class NotionClient {
                 return await this.makeRequest(options);
             }
             catch (error) {
-                // Only retry on rate limit errors if retry is enabled
+                // Retry rate-limited requests (if enabled) and service-overload (529)
+                // responses, which the API recommends always retrying.
                 if (error instanceof errors_1.NotionAPIError &&
-                    error.isRateLimited() &&
-                    this.retryOnRateLimit &&
+                    ((error.isRateLimited() && this.retryOnRateLimit) || error.isServiceOverloaded()) &&
                     attempt < this.maxRetries) {
                     // Prefer the server-supplied Retry-After value; fall back to
                     // exponential backoff when the header is absent.
@@ -110,7 +110,13 @@ class NotionClient {
         const url = new URL(`${this.baseUrl}/v1${path}`);
         if (query) {
             Object.entries(query).forEach(([key, value]) => {
-                if (value !== undefined) {
+                if (value === undefined) {
+                    return;
+                }
+                if (Array.isArray(value)) {
+                    value.forEach((item) => url.searchParams.append(key, item));
+                }
+                else {
                     url.searchParams.append(key, String(value));
                 }
             });

package/dist/errors.d.ts

@@ -1,7 +1,7 @@
 /**
  * Notion API error codes based on official documentation.
  */
-export type NotionErrorCode = 'invalid_json' | 'invalid_request_url' | 'invalid_request' | 'validation_error' | 'missing_version' | 'unauthorized' | 'restricted_resource' | 'object_not_found' | 'conflict_error' | 'rate_limited' | 'internal_server_error' | 'service_unavailable' | 'database_connection_unavailable' | 'gateway_timeout';
+export type NotionErrorCode = 'invalid_json' | 'invalid_request_url' | 'invalid_request' | 'validation_error' | 'missing_version' | 'unauthorized' | 'restricted_resource' | 'object_not_found' | 'conflict_error' | 'rate_limited' | 'internal_server_error' | 'service_unavailable' | 'service_overload' | 'database_connection_unavailable' | 'gateway_timeout';
 /**
  * Notion API error response structure.
  */
@@ -24,6 +24,10 @@ export declare class NotionAPIError extends Error {
      * Check if the error is a rate limit error.
      */
     isRateLimited(): boolean;
+    /**
+     * Check if the error is a service overload error (HTTP 529).
+     */
+    isServiceOverloaded(): boolean;
     /**
      * Check if the error is an authentication error.
      */

package/dist/errors.js

@@ -23,6 +23,12 @@ class NotionAPIError extends Error {
     isRateLimited() {
         return this.code === 'rate_limited';
     }
+    /**
+     * Check if the error is a service overload error (HTTP 529).
+     */
+    isServiceOverloaded() {
+        return this.code === 'service_overload';
+    }
     /**
      * Check if the error is an authentication error.
      */