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

package/dist/api/databases.api.d.ts

@@ -11,7 +11,7 @@ export interface RetrieveDatabaseOptions {
 }
 /**
  * Filter condition for database 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/post-database-query-filter
  */
 export type DatabaseFilter = Record<string, unknown>;
@@ -62,8 +62,8 @@ export interface InitialDataSource {
 }
 /**
  * Options for creating a database.
- * As of API version 2025-09-03, databases are created with an initial_data_source
- * containing the properties schema, rather than properties at the top level.
+ * As of API version 2025-09-03, databases require an `initial_data_source` object.
+ * This object holds the properties schema. It replaces top-level properties.
  */
 export interface CreateDatabaseOptions {
     /** The parent object (page or workspace) */
@@ -81,8 +81,8 @@ export interface CreateDatabaseOptions {
 }
 /**
  * Options for updating a database.
- * As of API version 2025-09-03, properties are managed at the data source level.
- * Use the DataSourcesAPI to update properties.
+ * As of API version 2025-09-03, manage properties at the data source level.
+ * Use DataSourcesAPI to update properties.
  */
 export interface UpdateDatabaseOptions {
     /** Update the database title */
@@ -93,6 +93,8 @@ export interface UpdateDatabaseOptions {
     cover?: unknown;
     /** Move to trash or restore from trash */
     in_trash?: boolean;
+    /** Lock or unlock the database from editing */
+    is_locked?: boolean;
     /** Whether the database is inline */
     is_inline?: boolean;
     /** Move the database to a different parent */
@@ -100,6 +102,8 @@ export interface UpdateDatabaseOptions {
 }
 /**
  * Databases API client for working with Notion databases.
+ *
+ * @category Databases & Data Sources
  */
 export declare class DatabasesAPI extends BaseAPI<NotionDatabase, Database> {
     protected readonly client: NotionClient;
@@ -120,6 +124,7 @@ export declare class DatabasesAPI extends BaseAPI<NotionDatabase, Database> {
                 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">;
@@ -153,6 +158,7 @@ export declare class DatabasesAPI extends BaseAPI<NotionDatabase, Database> {
                 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">;
@@ -192,11 +198,11 @@ export declare class DatabasesAPI extends BaseAPI<NotionDatabase, Database> {
                     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";
@@ -261,6 +267,7 @@ export declare class DatabasesAPI extends BaseAPI<NotionDatabase, Database> {
                         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">;
@@ -293,11 +300,11 @@ export declare class DatabasesAPI extends BaseAPI<NotionDatabase, Database> {
                     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";
@@ -328,11 +335,11 @@ export declare class DatabasesAPI extends BaseAPI<NotionDatabase, Database> {
                     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";
@@ -367,11 +374,11 @@ export declare class DatabasesAPI extends BaseAPI<NotionDatabase, Database> {
                     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";
@@ -436,6 +443,7 @@ export declare class DatabasesAPI extends BaseAPI<NotionDatabase, Database> {
                         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">;
@@ -468,11 +476,11 @@ export declare class DatabasesAPI extends BaseAPI<NotionDatabase, Database> {
                     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";
@@ -503,11 +511,11 @@ export declare class DatabasesAPI extends BaseAPI<NotionDatabase, Database> {
                     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";
@@ -546,6 +554,30 @@ export declare class DatabasesAPI extends BaseAPI<NotionDatabase, Database> {
             }, 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">;
@@ -580,10 +612,14 @@ export declare class DatabasesAPI extends BaseAPI<NotionDatabase, Database> {
             }, 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;
             in_trash: import("zod").ZodBoolean;
             is_inline: import("zod").ZodBoolean;
+            is_locked: import("zod").ZodOptional<import("zod").ZodBoolean>;
             public_url: import("zod").ZodNullable<import("zod").ZodURL>;
         }, import("zod/v4/core").$strip>;
         ModelClass: typeof Database;

package/dist/api/databases.api.js

@@ -3,10 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DatabasesAPI = 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");
 /**
  * Databases API client for working with Notion databases.
+ *
+ * @category Databases & Data Sources
  */
 class DatabasesAPI extends base_api_1.BaseAPI {
     constructor(client) {
@@ -60,7 +63,7 @@ class DatabasesAPI 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',

package/dist/api/fileUploads.api.d.ts

@@ -19,6 +19,8 @@ export interface InitiateFileUploadOptions {
 export type FileData = Buffer | ArrayBuffer | Blob | ReadableStream;
 /**
  * FileUploads API client for uploading files to Notion.
+ *
+ * @category File Uploads
  */
 export declare class FileUploadsAPI extends BaseAPI<NotionFileUpload, FileUpload> {
     protected readonly client: NotionClient;
@@ -29,10 +31,10 @@ export declare class FileUploadsAPI extends BaseAPI<NotionFileUpload, FileUpload
             created_time: import("zod").ZodUnion<readonly [import("zod").ZodISODateTime, import("zod").ZodISODate]>;
             expiry_time: import("zod").ZodNullable<import("zod").ZodUnion<readonly [import("zod").ZodISODateTime, import("zod").ZodISODate]>>;
             status: import("zod").ZodEnum<{
+                failed: "failed";
                 pending: "pending";
                 uploaded: "uploaded";
                 expired: "expired";
-                failed: "failed";
             }>;
             filename: import("zod").ZodString;
             content_type: import("zod").ZodNullable<import("zod").ZodString>;
@@ -55,7 +57,8 @@ export declare class FileUploadsAPI extends BaseAPI<NotionFileUpload, FileUpload
     initiate(options: InitiateFileUploadOptions): Promise<FileUpload>;
     /**
      * Upload file data to the upload URL.
-     * This is a direct PUT request to the upload URL (not through Notion API).
+     * This method sends a PUT request directly to the upload URL. It does not go
+     * through the Notion API.
      *
      * @param uploadUrl - The upload URL from initiate()
      * @param fileData - The file data to upload
@@ -74,9 +77,9 @@ export declare class FileUploadsAPI extends BaseAPI<NotionFileUpload, FileUpload
      */
     complete(completeUrl: string): Promise<FileUpload>;
     /**
-     * Extracts the request path from a complete URL, accepting both absolute
-     * URLs (e.g. `https://api.notion.com/v1/file_uploads/.../complete`) and
-     * relative paths (e.g. `/v1/file_uploads/.../complete` or the path alone).
+     * Extract the request path from a complete URL.
+     * Accept absolute URLs, for example `https://api.notion.com/v1/file_uploads/.../complete`.
+     * Accept relative paths too, for example `/v1/file_uploads/.../complete` or the path alone.
      */
     private static toRequestPath;
     /**

package/dist/api/fileUploads.api.js

@@ -3,9 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileUploadsAPI = void 0;
 const schemas_1 = require("../schemas");
 const models_1 = require("../models");
+const base_model_1 = require("../models/base.model");
 const base_api_1 = require("./base.api");
 /**
  * FileUploads API client for uploading files to Notion.
+ *
+ * @category File Uploads
  */
 class FileUploadsAPI extends base_api_1.BaseAPI {
     constructor(client) {
@@ -31,11 +34,12 @@ class FileUploadsAPI extends base_api_1.BaseAPI {
             body: options,
         });
         const parsed = schemas_1.fileUploadSchema.parse(response);
-        return new models_1.FileUpload(parsed);
+        return new models_1.FileUpload(parsed, base_model_1.TRUSTED);
     }
     /**
      * Upload file data to the upload URL.
-     * This is a direct PUT request to the upload URL (not through Notion API).
+     * This method sends a PUT request directly to the upload URL. It does not go
+     * through the Notion API.
      *
      * @param uploadUrl - The upload URL from initiate()
      * @param fileData - The file data to upload
@@ -70,12 +74,12 @@ class FileUploadsAPI extends base_api_1.BaseAPI {
             body: {},
         });
         const parsed = schemas_1.fileUploadSchema.parse(response);
-        return new models_1.FileUpload(parsed);
+        return new models_1.FileUpload(parsed, base_model_1.TRUSTED);
     }
     /**
-     * Extracts the request path from a complete URL, accepting both absolute
-     * URLs (e.g. `https://api.notion.com/v1/file_uploads/.../complete`) and
-     * relative paths (e.g. `/v1/file_uploads/.../complete` or the path alone).
+     * Extract the request path from a complete URL.
+     * Accept absolute URLs, for example `https://api.notion.com/v1/file_uploads/.../complete`.
+     * Accept relative paths too, for example `/v1/file_uploads/.../complete` or the path alone.
      */
     static toRequestPath(completeUrl) {
         let path;
@@ -136,7 +140,7 @@ class FileUploadsAPI extends base_api_1.BaseAPI {
             path: `/file_uploads/${fileUploadId}`,
         });
         const parsed = schemas_1.fileUploadSchema.parse(response);
-        return new models_1.FileUpload(parsed);
+        return new models_1.FileUpload(parsed, base_model_1.TRUSTED);
     }
 }
 exports.FileUploadsAPI = FileUploadsAPI;

package/dist/api/index.d.ts

@@ -1,8 +1,11 @@
+export { AsyncTasksAPI } from './asyncTasks.api';
 export { BlocksAPI } from './blocks.api';
 export { CommentsAPI } from './comments.api';
+export { CustomEmojisAPI } from './customEmojis.api';
 export { DatabasesAPI } from './databases.api';
 export { DataSourcesAPI } from './dataSources.api';
 export { FileUploadsAPI } from './fileUploads.api';
 export { PagesAPI } from './pages.api';
 export { SearchAPI } from './search.api';
 export { UsersAPI } from './users.api';
+export { ViewsAPI } from './views.api';

package/dist/api/index.js

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UsersAPI = exports.SearchAPI = exports.PagesAPI = exports.FileUploadsAPI = exports.DataSourcesAPI = exports.DatabasesAPI = exports.CommentsAPI = exports.BlocksAPI = void 0;
+exports.ViewsAPI = exports.UsersAPI = exports.SearchAPI = exports.PagesAPI = exports.FileUploadsAPI = exports.DataSourcesAPI = exports.DatabasesAPI = exports.CustomEmojisAPI = exports.CommentsAPI = exports.BlocksAPI = exports.AsyncTasksAPI = void 0;
+var asyncTasks_api_1 = require("./asyncTasks.api");
+Object.defineProperty(exports, "AsyncTasksAPI", { enumerable: true, get: function () { return asyncTasks_api_1.AsyncTasksAPI; } });
 var blocks_api_1 = require("./blocks.api");
 Object.defineProperty(exports, "BlocksAPI", { enumerable: true, get: function () { return blocks_api_1.BlocksAPI; } });
 var comments_api_1 = require("./comments.api");
 Object.defineProperty(exports, "CommentsAPI", { enumerable: true, get: function () { return comments_api_1.CommentsAPI; } });
+var customEmojis_api_1 = require("./customEmojis.api");
+Object.defineProperty(exports, "CustomEmojisAPI", { enumerable: true, get: function () { return customEmojis_api_1.CustomEmojisAPI; } });
 var databases_api_1 = require("./databases.api");
 Object.defineProperty(exports, "DatabasesAPI", { enumerable: true, get: function () { return databases_api_1.DatabasesAPI; } });
 var dataSources_api_1 = require("./dataSources.api");
@@ -17,3 +21,5 @@ var search_api_1 = require("./search.api");
 Object.defineProperty(exports, "SearchAPI", { enumerable: true, get: function () { return search_api_1.SearchAPI; } });
 var users_api_1 = require("./users.api");
 Object.defineProperty(exports, "UsersAPI", { enumerable: true, get: function () { return users_api_1.UsersAPI; } });
+var views_api_1 = require("./views.api");
+Object.defineProperty(exports, "ViewsAPI", { enumerable: true, get: function () { return views_api_1.ViewsAPI; } });