@notionhq/client 5.25.2 → 5.27.0

package/build/src/Client.js

@@ -10,8 +10,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _Client_auth, _Client_logLevel, _Client_logger, _Client_prefixUrl, _Client_timeoutMs, _Client_notionVersion, _Client_fetch, _Client_agent, _Client_userAgent, _Client_maxRetries, _Client_initialRetryDelayMs, _Client_maxRetryDelayMs;
+var _Client_endpointMethods, _Client_auth, _Client_logLevel, _Client_logger, _Client_prefixUrl, _Client_timeoutMs, _Client_notionVersion, _Client_fetch, _Client_agent, _Client_userAgent, _Client_maxRetries, _Client_initialRetryDelayMs, _Client_maxRetryDelayMs, _Client_dangerouslyAllowBrowser;
 Object.defineProperty(exports, "__esModule", { value: true });
+const api_endpoint_methods_1 = require("./api-endpoint-methods");
 const logging_1 = require("./logging");
 const errors_1 = require("./errors");
 const utils_1 = require("./utils");
@@ -20,9 +21,27 @@ const api_endpoints_1 = require("./api-endpoints");
 const meeting_notes_1 = require("./api-endpoints/meeting-notes");
 const package_json_1 = require("../package.json");
 const START_CURSOR_PARAM_NAME = "start_cursor";
+/**
+ * True inside a browser page, web worker, or service worker: the places where
+ * every visitor downloads the script, so a token in it is public. Node, Bun,
+ * Deno, and edge runtimes have neither `window.document` nor
+ * `WorkerGlobalScope`. Test runners that emulate a browser, such as jsdom,
+ * also count as a browser here.
+ */
+function isBrowserEnvironment() {
+    const maybeWindow = globalThis.window;
+    if (maybeWindow !== undefined && maybeWindow.document !== undefined) {
+        return true;
+    }
+    return "WorkerGlobalScope" in globalThis;
+}
 class Client {
     constructor(options) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+        _Client_endpointMethods.set(this, (0, api_endpoint_methods_1.createEndpointMethods)({
+            request: args => this.request(args),
+            warnUnknownParams: (args, endpoint) => this.warnUnknownParams(args, endpoint),
+        }));
         _Client_auth.set(this, void 0);
         _Client_logLevel.set(this, void 0);
         _Client_logger.set(this, void 0);
@@ -35,106 +54,76 @@ class Client {
         _Client_maxRetries.set(this, void 0);
         _Client_initialRetryDelayMs.set(this, void 0);
         _Client_maxRetryDelayMs.set(this, void 0);
+        _Client_dangerouslyAllowBrowser.set(this, void 0);
         /*
          * Notion API endpoints
          */
-        this.asyncTasks = {
+        this.plugins = {
+            list: __classPrivateFieldGet(this, _Client_endpointMethods, "f").plugins.list,
+            retrieve: (args) => __classPrivateFieldGet(this, _Client_endpointMethods, "f").plugins.retrieve({
+                ...args,
+                // Plugin IDs can be tag IDs containing URL delimiters, not just UUIDs.
+                id: encodeURIComponent(args.id),
+            }),
+        };
+        this.skills = __classPrivateFieldGet(this, _Client_endpointMethods, "f").skills;
+        this.agents = __classPrivateFieldGet(this, _Client_endpointMethods, "f").agents;
+        this.sessions = {
             /**
-             * Retrieve an async task
+             * Retrieve a session
              */
-            retrieve: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.getAsyncTask);
-                return this.request({
-                    path: api_endpoints_1.getAsyncTask.path(args),
-                    method: api_endpoints_1.getAsyncTask.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.getAsyncTask.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.getAsyncTask.bodyParams),
+            retrieve: __classPrivateFieldGet(this, _Client_endpointMethods, "f").sessions.retrieve,
+            /**
+             * Update a session
+             */
+            update: __classPrivateFieldGet(this, _Client_endpointMethods, "f").sessions.update,
+            /**
+             * Open a session stream
+             */
+            stream: (args) => {
+                this.warnUnknownParams(args, api_endpoints_1.updateSessionStream);
+                return this.streamRequest({
+                    path: api_endpoints_1.updateSessionStream.path(),
+                    method: api_endpoints_1.updateSessionStream.method,
+                    query: (0, utils_1.pick)(args, api_endpoints_1.updateSessionStream.queryParams),
+                    body: (0, utils_1.pick)(args, api_endpoints_1.updateSessionStream.bodyParams),
+                    headers: api_endpoints_1.updateSessionStream.headers,
                     auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
+                }, parseSessionStreamEvent);
             },
+            /**
+             * Cancel a session
+             */
+            cancel: __classPrivateFieldGet(this, _Client_endpointMethods, "f").sessions.cancel,
+            /**
+             * Query sessions
+             */
+            query: __classPrivateFieldGet(this, _Client_endpointMethods, "f").sessions.query,
+            /**
+             * Query session events
+             */
+            queryEvents: __classPrivateFieldGet(this, _Client_endpointMethods, "f").sessions.queryEvents,
         };
+        this.asyncTasks = __classPrivateFieldGet(this, _Client_endpointMethods, "f").asyncTasks;
         this.blocks = {
             /**
              * Retrieve block
              */
-            retrieve: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.getBlock);
-                return this.request({
-                    path: api_endpoints_1.getBlock.path(args),
-                    method: api_endpoints_1.getBlock.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.getBlock.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.getBlock.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
+            retrieve: __classPrivateFieldGet(this, _Client_endpointMethods, "f").blocks.retrieve,
             /**
              * Update block
              */
-            update: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.updateBlock);
-                return this.request({
-                    path: api_endpoints_1.updateBlock.path(args),
-                    method: api_endpoints_1.updateBlock.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.updateBlock.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.updateBlock.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
+            update: __classPrivateFieldGet(this, _Client_endpointMethods, "f").blocks.update,
             /**
              * Delete block
              */
-            delete: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.deleteBlock);
-                return this.request({
-                    path: api_endpoints_1.deleteBlock.path(args),
-                    method: api_endpoints_1.deleteBlock.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.deleteBlock.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.deleteBlock.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-            children: {
-                /**
-                 * Append block children
-                 */
-                append: (args) => {
-                    this.warnUnknownParams(args, api_endpoints_1.appendBlockChildren);
-                    return this.request({
-                        path: api_endpoints_1.appendBlockChildren.path(args),
-                        method: api_endpoints_1.appendBlockChildren.method,
-                        query: (0, utils_1.pick)(args, api_endpoints_1.appendBlockChildren.queryParams),
-                        body: (0, utils_1.pick)(args, api_endpoints_1.appendBlockChildren.bodyParams),
-                        auth: args === null || args === void 0 ? void 0 : args.auth,
-                    });
-                },
-                /**
-                 * Retrieve block children
-                 */
-                list: (args) => {
-                    this.warnUnknownParams(args, api_endpoints_1.listBlockChildren);
-                    return this.request({
-                        path: api_endpoints_1.listBlockChildren.path(args),
-                        method: api_endpoints_1.listBlockChildren.method,
-                        query: (0, utils_1.pick)(args, api_endpoints_1.listBlockChildren.queryParams),
-                        body: (0, utils_1.pick)(args, api_endpoints_1.listBlockChildren.bodyParams),
-                        auth: args === null || args === void 0 ? void 0 : args.auth,
-                    });
-                },
-            },
+            delete: __classPrivateFieldGet(this, _Client_endpointMethods, "f").blocks.delete,
+            children: __classPrivateFieldGet(this, _Client_endpointMethods, "f").blocks.children,
             meetingNotes: {
                 /**
                  * Create a meeting note
                  */
-                create: (args) => {
-                    this.warnUnknownParams(args, meeting_notes_1.createMeetingNote);
-                    return this.request({
-                        path: meeting_notes_1.createMeetingNote.path(),
-                        method: meeting_notes_1.createMeetingNote.method,
-                        query: (0, utils_1.pick)(args, meeting_notes_1.createMeetingNote.queryParams),
-                        body: (0, utils_1.pick)(args, meeting_notes_1.createMeetingNote.bodyParams),
-                        auth: args === null || args === void 0 ? void 0 : args.auth,
-                    });
-                },
+                create: __classPrivateFieldGet(this, _Client_endpointMethods, "f").blocks.meetingNotes.create,
                 /**
                  * Query meeting notes
                  */
@@ -149,167 +138,25 @@ class Client {
                 },
             },
         };
-        this.databases = {
-            /**
-             * Retrieve a database
-             */
-            retrieve: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.getDatabase);
-                return this.request({
-                    path: api_endpoints_1.getDatabase.path(args),
-                    method: api_endpoints_1.getDatabase.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.getDatabase.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.getDatabase.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-            /**
-             * Create a database
-             */
-            create: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.createDatabase);
-                return this.request({
-                    path: api_endpoints_1.createDatabase.path(),
-                    method: api_endpoints_1.createDatabase.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.createDatabase.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.createDatabase.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-            /**
-             * Update a database
-             */
-            update: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.updateDatabase);
-                return this.request({
-                    path: api_endpoints_1.updateDatabase.path(args),
-                    method: api_endpoints_1.updateDatabase.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.updateDatabase.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.updateDatabase.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-        };
-        this.dataSources = {
-            /**
-             * Retrieve a data source
-             */
-            retrieve: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.getDataSource);
-                return this.request({
-                    path: api_endpoints_1.getDataSource.path(args),
-                    method: api_endpoints_1.getDataSource.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.getDataSource.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.getDataSource.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-            /**
-             * Query a data source
-             */
-            query: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.queryDataSource);
-                return this.request({
-                    path: api_endpoints_1.queryDataSource.path(args),
-                    method: api_endpoints_1.queryDataSource.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.queryDataSource.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.queryDataSource.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-            /**
-             * Create a data source
-             */
-            create: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.createDataSource);
-                return this.request({
-                    path: api_endpoints_1.createDataSource.path(),
-                    method: api_endpoints_1.createDataSource.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.createDataSource.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.createDataSource.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-            /**
-             * Update a data source
-             */
-            update: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.updateDataSource);
-                return this.request({
-                    path: api_endpoints_1.updateDataSource.path(args),
-                    method: api_endpoints_1.updateDataSource.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.updateDataSource.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.updateDataSource.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-            /**
-             * List page templates that are available for a data source
-             */
-            listTemplates: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.listDataSourceTemplates);
-                return this.request({
-                    path: api_endpoints_1.listDataSourceTemplates.path(args),
-                    method: api_endpoints_1.listDataSourceTemplates.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.listDataSourceTemplates.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.listDataSourceTemplates.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-        };
+        this.databases = __classPrivateFieldGet(this, _Client_endpointMethods, "f").databases;
+        this.dataSources = __classPrivateFieldGet(this, _Client_endpointMethods, "f").dataSources;
         this.pages = {
             /**
              * Create a page
              */
-            create: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.createPage);
-                return this.request({
-                    path: api_endpoints_1.createPage.path(),
-                    method: api_endpoints_1.createPage.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.createPage.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.createPage.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
+            create: __classPrivateFieldGet(this, _Client_endpointMethods, "f").pages.create,
             /**
              * Retrieve a page
              */
-            retrieve: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.getPage);
-                return this.request({
-                    path: api_endpoints_1.getPage.path(args),
-                    method: api_endpoints_1.getPage.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.getPage.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.getPage.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
+            retrieve: __classPrivateFieldGet(this, _Client_endpointMethods, "f").pages.retrieve,
             /**
              * Update page properties
              */
-            update: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.updatePage);
-                return this.request({
-                    path: api_endpoints_1.updatePage.path(args),
-                    method: api_endpoints_1.updatePage.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.updatePage.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.updatePage.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
+            update: __classPrivateFieldGet(this, _Client_endpointMethods, "f").pages.update,
             /**
              * Move a page
              */
-            move: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.movePage);
-                return this.request({
-                    path: api_endpoints_1.movePage.path(args),
-                    method: api_endpoints_1.movePage.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.movePage.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.movePage.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
+            move: __classPrivateFieldGet(this, _Client_endpointMethods, "f").pages.move,
             /**
              * Retrieve a page as markdown
              */
@@ -334,63 +181,9 @@ class Client {
                     auth: args === null || args === void 0 ? void 0 : args.auth,
                 });
             },
-            properties: {
-                /**
-                 * Retrieve page property
-                 */
-                retrieve: (args) => {
-                    this.warnUnknownParams(args, api_endpoints_1.getPageProperty);
-                    return this.request({
-                        path: api_endpoints_1.getPageProperty.path(args),
-                        method: api_endpoints_1.getPageProperty.method,
-                        query: (0, utils_1.pick)(args, api_endpoints_1.getPageProperty.queryParams),
-                        body: (0, utils_1.pick)(args, api_endpoints_1.getPageProperty.bodyParams),
-                        auth: args === null || args === void 0 ? void 0 : args.auth,
-                    });
-                },
-            },
-        };
-        this.users = {
-            /**
-             * Retrieve a user
-             */
-            retrieve: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.getUser);
-                return this.request({
-                    path: api_endpoints_1.getUser.path(args),
-                    method: api_endpoints_1.getUser.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.getUser.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.getUser.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-            /**
-             * List all users
-             */
-            list: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.listUsers);
-                return this.request({
-                    path: api_endpoints_1.listUsers.path(),
-                    method: api_endpoints_1.listUsers.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.listUsers.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.listUsers.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-            /**
-             * Get details about bot
-             */
-            me: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.getSelf);
-                return this.request({
-                    path: api_endpoints_1.getSelf.path(),
-                    method: api_endpoints_1.getSelf.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.getSelf.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.getSelf.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
+            properties: __classPrivateFieldGet(this, _Client_endpointMethods, "f").pages.properties,
         };
+        this.users = __classPrivateFieldGet(this, _Client_endpointMethods, "f").users;
         this.customEmojis = {
             /**
              * List custom emojis
@@ -406,87 +199,12 @@ class Client {
                 });
             },
         };
-        this.comments = {
-            /**
-             * Create a comment
-             */
-            create: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.createComment);
-                return this.request({
-                    path: api_endpoints_1.createComment.path(),
-                    method: api_endpoints_1.createComment.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.createComment.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.createComment.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-            /**
-             * List comments
-             */
-            list: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.listComments);
-                return this.request({
-                    path: api_endpoints_1.listComments.path(),
-                    method: api_endpoints_1.listComments.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.listComments.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.listComments.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-            /**
-             * Retrieve a comment
-             */
-            retrieve: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.getComment);
-                return this.request({
-                    path: api_endpoints_1.getComment.path(args),
-                    method: api_endpoints_1.getComment.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.getComment.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.getComment.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-            /**
-             * Update a comment
-             */
-            update: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.updateComment);
-                return this.request({
-                    path: api_endpoints_1.updateComment.path(args),
-                    method: api_endpoints_1.updateComment.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.updateComment.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.updateComment.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-            /**
-             * Delete a comment
-             */
-            delete: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.deleteComment);
-                return this.request({
-                    path: api_endpoints_1.deleteComment.path(args),
-                    method: api_endpoints_1.deleteComment.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.deleteComment.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.deleteComment.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
-        };
+        this.comments = __classPrivateFieldGet(this, _Client_endpointMethods, "f").comments;
         this.fileUploads = {
             /**
              * Create a file upload
              */
-            create: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.createFileUpload);
-                return this.request({
-                    path: api_endpoints_1.createFileUpload.path(),
-                    method: api_endpoints_1.createFileUpload.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.createFileUpload.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.createFileUpload.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
+            create: __classPrivateFieldGet(this, _Client_endpointMethods, "f").fileUploads.create,
             /**
              * Retrieve a file upload
              */
@@ -577,16 +295,7 @@ class Client {
             /**
              * Retrieve a view
              */
-            retrieve: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.getView);
-                return this.request({
-                    path: api_endpoints_1.getView.path(args),
-                    method: api_endpoints_1.getView.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.getView.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.getView.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
+            retrieve: __classPrivateFieldGet(this, _Client_endpointMethods, "f").views.retrieve,
             /**
              * Update a view
              */
@@ -608,29 +317,11 @@ class Client {
             /**
              * Delete a view
              */
-            delete: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.deleteView);
-                return this.request({
-                    path: api_endpoints_1.deleteView.path(args),
-                    method: api_endpoints_1.deleteView.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.deleteView.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.deleteView.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
+            delete: __classPrivateFieldGet(this, _Client_endpointMethods, "f").views.delete,
             /**
              * List views for a database
              */
-            list: (args) => {
-                this.warnUnknownParams(args, api_endpoints_1.listDatabaseViews);
-                return this.request({
-                    path: api_endpoints_1.listDatabaseViews.path(),
-                    method: api_endpoints_1.listDatabaseViews.method,
-                    query: (0, utils_1.pick)(args, api_endpoints_1.listDatabaseViews.queryParams),
-                    body: (0, utils_1.pick)(args, api_endpoints_1.listDatabaseViews.bodyParams),
-                    auth: args === null || args === void 0 ? void 0 : args.auth,
-                });
-            },
+            list: __classPrivateFieldGet(this, _Client_endpointMethods, "f").views.list,
             queries: {
                 /**
                  * Create a view query
@@ -647,44 +338,17 @@ class Client {
                 /**
                  * Get view query results
                  */
-                results: (args) => {
-                    this.warnUnknownParams(args, api_endpoints_1.getViewQueryResults);
-                    return this.request({
-                        path: api_endpoints_1.getViewQueryResults.path(args),
-                        method: api_endpoints_1.getViewQueryResults.method,
-                        query: (0, utils_1.pick)(args, api_endpoints_1.getViewQueryResults.queryParams),
-                        body: (0, utils_1.pick)(args, api_endpoints_1.getViewQueryResults.bodyParams),
-                        auth: args === null || args === void 0 ? void 0 : args.auth,
-                    });
-                },
+                results: __classPrivateFieldGet(this, _Client_endpointMethods, "f").views.queries.results,
                 /**
                  * Delete a view query
                  */
-                delete: (args) => {
-                    this.warnUnknownParams(args, api_endpoints_1.deleteViewQuery);
-                    return this.request({
-                        path: api_endpoints_1.deleteViewQuery.path(args),
-                        method: api_endpoints_1.deleteViewQuery.method,
-                        query: (0, utils_1.pick)(args, api_endpoints_1.deleteViewQuery.queryParams),
-                        body: (0, utils_1.pick)(args, api_endpoints_1.deleteViewQuery.bodyParams),
-                        auth: args === null || args === void 0 ? void 0 : args.auth,
-                    });
-                },
+                delete: __classPrivateFieldGet(this, _Client_endpointMethods, "f").views.queries.delete,
             },
         };
         /**
          * Search
          */
-        this.search = (args) => {
-            this.warnUnknownParams(args, api_endpoints_1.search);
-            return this.request({
-                path: api_endpoints_1.search.path(),
-                method: api_endpoints_1.search.method,
-                query: (0, utils_1.pick)(args, api_endpoints_1.search.queryParams),
-                body: (0, utils_1.pick)(args, api_endpoints_1.search.bodyParams),
-                auth: args === null || args === void 0 ? void 0 : args.auth,
-            });
-        };
+        this.search = __classPrivateFieldGet(this, _Client_endpointMethods, "f").search;
         this.oauth = {
             /**
              * Get token
@@ -751,6 +415,10 @@ class Client {
             __classPrivateFieldSet(this, _Client_initialRetryDelayMs, (_k = (_j = options === null || options === void 0 ? void 0 : options.retry) === null || _j === void 0 ? void 0 : _j.initialRetryDelayMs) !== null && _k !== void 0 ? _k : constants_1.DEFAULT_INITIAL_RETRY_DELAY_MS, "f");
             __classPrivateFieldSet(this, _Client_maxRetryDelayMs, (_m = (_l = options === null || options === void 0 ? void 0 : options.retry) === null || _l === void 0 ? void 0 : _l.maxRetryDelayMs) !== null && _m !== void 0 ? _m : constants_1.DEFAULT_MAX_RETRY_DELAY_MS, "f");
         }
+        __classPrivateFieldSet(this, _Client_dangerouslyAllowBrowser, (_o = options === null || options === void 0 ? void 0 : options.dangerouslyAllowBrowser) !== null && _o !== void 0 ? _o : false, "f");
+        if ((options === null || options === void 0 ? void 0 : options.auth) !== undefined) {
+            this.assertTokenAllowedHere();
+        }
     }
     /**
      * Sends a request.
@@ -769,7 +437,76 @@ class Client {
             path,
             headers,
             body: bodyAsJsonString !== null && bodyAsJsonString !== void 0 ? bodyAsJsonString : formData,
-        });
+        }, request => this.executeSingleRequest(request));
+    }
+    /**
+     * Opens an SSE response and yields each parsed event as it arrives.
+     */
+    async *streamRequest(args, parseEvent) {
+        var _a;
+        const { path, method, query, body, auth } = args;
+        (0, errors_1.validateRequestPath)(path);
+        this.log(logging_1.LogLevel.INFO, "stream request start", { method, path });
+        const url = this.buildRequestUrl(path, query);
+        const bodyAsJsonString = this.serializeBody(body);
+        const headers = this.buildRequestHeaders(args.headers, auth, bodyAsJsonString);
+        const response = await this.executeWithRetry({
+            url,
+            method,
+            path,
+            headers,
+            body: bodyAsJsonString,
+        }, request => this.executeSingleStreamRequest(request));
+        this.log(logging_1.LogLevel.INFO, "stream request opened", { method, path });
+        if (response.body === undefined || response.body === null) {
+            for (const frame of takeSseFrames({
+                content: await response.text(),
+                complete: true,
+            }).frames) {
+                yield parseEvent(frame);
+            }
+            return;
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let remaining = "";
+        let complete = false;
+        try {
+            while (!complete) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    complete = true;
+                    continue;
+                }
+                if (value === undefined) {
+                    throw new Error("SSE response body ended without a data chunk.");
+                }
+                const frames = takeSseFrames({
+                    content: `${remaining}${decoder.decode(value, { stream: true })}`,
+                    complete: false,
+                });
+                remaining = frames.remaining;
+                for (const frame of frames.frames) {
+                    yield parseEvent(frame);
+                }
+            }
+            for (const frame of takeSseFrames({
+                content: `${remaining}${decoder.decode()}`,
+                complete: true,
+            }).frames) {
+                yield parseEvent(frame);
+            }
+        }
+        finally {
+            try {
+                if (!complete) {
+                    await ((_a = reader.cancel) === null || _a === void 0 ? void 0 : _a.call(reader));
+                }
+            }
+            finally {
+                reader.releaseLock();
+            }
+        }
     }
     /**
      * Builds the full URL with query parameters.
@@ -821,8 +558,12 @@ class Client {
             ...customHeaders,
             ...authorizationHeader,
             "Notion-Version": __classPrivateFieldGet(this, _Client_notionVersion, "f"),
-            "user-agent": __classPrivateFieldGet(this, _Client_userAgent, "f"),
         };
+        // Firefox and Safari send a custom user-agent, which the API's CORS
+        // preflight does not allow, so every browser request would fail.
+        if (!isBrowserEnvironment()) {
+            headers["user-agent"] = __classPrivateFieldGet(this, _Client_userAgent, "f");
+        }
         if (bodyAsJsonString !== undefined) {
             headers["content-type"] = "application/json";
         }
@@ -832,6 +573,9 @@ class Client {
      * Builds the authorization header based on auth type.
      */
     buildAuthHeader(auth) {
+        if (auth !== undefined) {
+            this.assertTokenAllowedHere();
+        }
         if (typeof auth === "object") {
             const unencodedCredential = `${auth.client_id}:${auth.client_secret}`;
             const encodedCredential = Buffer.from(unencodedCredential).toString("base64");
@@ -862,13 +606,13 @@ class Client {
     /**
      * Executes the request with retry logic.
      */
-    async executeWithRetry(args) {
+    async executeWithRetry(args, execute) {
         const { url, method, path, headers, body } = args;
         let attempt = 0;
         // eslint-disable-next-line no-constant-condition
         while (true) {
             try {
-                return await this.executeSingleRequest({
+                return await execute({
                     url,
                     method,
                     path,
@@ -920,6 +664,24 @@ class Client {
         });
         return responseJson;
     }
+    /**
+     * Opens an SSE response without consuming its body. Retry orchestration is
+     * shared with JSON requests so only the initial, retryable HTTP failures are
+     * retried; once a stream has opened, its events are never replayed.
+     */
+    async executeSingleStreamRequest(args) {
+        const { url, method, body } = args;
+        const response = await errors_1.RequestTimeoutError.rejectAfterTimeout(__classPrivateFieldGet(this, _Client_fetch, "f").call(this, url.toString(), {
+            method: method.toUpperCase(),
+            headers: args.headers,
+            body,
+            agent: __classPrivateFieldGet(this, _Client_agent, "f"),
+        }), __classPrivateFieldGet(this, _Client_timeoutMs, "f"));
+        if (!response.ok) {
+            throw (0, errors_1.buildRequestError)(response, await response.text());
+        }
+        return response;
+    }
     /**
      * Logs a request error with appropriate detail level.
      */
@@ -1024,8 +786,9 @@ class Client {
      */
     warnUnknownParams(args, endpoint) {
         var _a;
-        if (!args || typeof args !== "object")
+        if (!args || typeof args !== "object") {
             return;
+        }
         const unknownKeys = (0, utils_1.getUnknownParams)(args, endpoint);
         if (unknownKeys.length > 0) {
             this.log(logging_1.LogLevel.WARN, "unknown parameters were ignored", {
@@ -1050,6 +813,19 @@ class Client {
             __classPrivateFieldGet(this, _Client_logger, "f").call(this, level, message, extraInfo);
         }
     }
+    /**
+     * Blocks a token or client secret inside a browser unless the caller opted
+     * in. Covers both the constructor `auth` and per-request `auth`, since a
+     * page that asks the visitor to type a token usually uses the latter. A
+     * client without a token stays usable, for example behind a proxy that
+     * adds the token on a server.
+     */
+    assertTokenAllowedHere() {
+        if (__classPrivateFieldGet(this, _Client_dangerouslyAllowBrowser, "f") || !isBrowserEnvironment()) {
+            return;
+        }
+        throw new errors_1.BrowserTokenNotAllowedError();
+    }
     /**
      * Transforms an API key or access token into a headers object suitable for an HTTP request.
      *
@@ -1068,7 +844,75 @@ class Client {
         return headers;
     }
 }
-_Client_auth = new WeakMap(), _Client_logLevel = new WeakMap(), _Client_logger = new WeakMap(), _Client_prefixUrl = new WeakMap(), _Client_timeoutMs = new WeakMap(), _Client_notionVersion = new WeakMap(), _Client_fetch = new WeakMap(), _Client_agent = new WeakMap(), _Client_userAgent = new WeakMap(), _Client_maxRetries = new WeakMap(), _Client_initialRetryDelayMs = new WeakMap(), _Client_maxRetryDelayMs = new WeakMap();
+_Client_endpointMethods = new WeakMap(), _Client_auth = new WeakMap(), _Client_logLevel = new WeakMap(), _Client_logger = new WeakMap(), _Client_prefixUrl = new WeakMap(), _Client_timeoutMs = new WeakMap(), _Client_notionVersion = new WeakMap(), _Client_fetch = new WeakMap(), _Client_agent = new WeakMap(), _Client_userAgent = new WeakMap(), _Client_maxRetries = new WeakMap(), _Client_initialRetryDelayMs = new WeakMap(), _Client_maxRetryDelayMs = new WeakMap(), _Client_dangerouslyAllowBrowser = new WeakMap();
 Client.defaultNotionVersion = "2025-09-03";
 exports.default = Client;
+const sessionStreamEventTypes = new Set([
+    "session.snapshot",
+    "event.provisional",
+    "event.committed",
+    "stream.timeout",
+    "stream.end",
+    "stream.error",
+]);
+function takeSseFrames(args) {
+    const frames = [];
+    let remaining = args.content.replace(/\r\n/g, "\n");
+    let boundary = remaining.indexOf("\n\n");
+    while (boundary !== -1) {
+        const frame = parseSseFrame(remaining.slice(0, boundary));
+        if (frame !== undefined) {
+            frames.push(frame);
+        }
+        remaining = remaining.slice(boundary + 2);
+        boundary = remaining.indexOf("\n\n");
+    }
+    if (args.complete && remaining !== "") {
+        const frame = parseSseFrame(remaining);
+        if (frame !== undefined) {
+            frames.push(frame);
+        }
+        remaining = "";
+    }
+    return { frames, remaining };
+}
+function parseSseFrame(content) {
+    let eventName;
+    const dataLines = [];
+    for (const line of content.split("\n")) {
+        if (line.startsWith(":")) {
+            continue;
+        }
+        const colonIndex = line.indexOf(":");
+        if (colonIndex === -1) {
+            continue;
+        }
+        const field = line.slice(0, colonIndex);
+        const valueStart = line.charAt(colonIndex + 1) === " " ? colonIndex + 2 : colonIndex + 1;
+        const value = line.slice(valueStart);
+        if (field === "event") {
+            eventName = value;
+        }
+        else if (field === "data") {
+            dataLines.push(value);
+        }
+    }
+    if (dataLines.length === 0) {
+        return undefined;
+    }
+    if (eventName === undefined) {
+        throw new Error("Session stream event is missing its SSE event name.");
+    }
+    return { eventName, data: dataLines.join("\n") };
+}
+function parseSessionStreamEvent(frame) {
+    const event = JSON.parse(frame.data);
+    if (typeof event !== "object" ||
+        event === null ||
+        !sessionStreamEventTypes.has(event.type) ||
+        event.type !== frame.eventName) {
+        throw new Error("Session stream event does not match its SSE event name.");
+    }
+    return event;
+}
 //# sourceMappingURL=Client.js.map