18869 feature upgrade notion create page in data source action to support templates (#18888)

* Enhance Notion component with template support and version updates

- Added `listTemplates` method to the Notion client for retrieving available templates.
- Updated `create-page-from-database` action to support template selection, including new properties for template type and ID.
- Bumped version to 2.0.0 for the `create-page-from-database` action and updated package version to 1.0.6.
- Upgraded `@notionhq/client` dependency to version 5.3.0.

* pnpm update

* Update Notion component versions to latest releases

- Bumped versions for multiple actions and sources, including `append-block`, `complete-file-upload`, `create-comment`, `create-database`, `create-file-upload`, `create-page`, `delete-block`, `duplicate-page`, `get-current-user`, `list-all-users`, `list-file-uploads`, `query-database`, `retrieve-block`, `retrieve-database-content`, `retrieve-database-schema`, `retrieve-file-upload`, `retrieve-page`, `retrieve-page-property-item`, `retrieve-user`, `search`, `send-file-upload`, `update-block`, `update-database`, `update-page`, and various sources.
- Ensured all components are aligned with the latest API specifications.

* Refactor template retrieval in create-page-from-database action

- Updated the `listTemplates` method call to use a parameters object for improved readability and maintainability.
- Added support for optional `start_cursor` parameter to handle pagination when retrieving templates.

Author: luancazarine

components/notion/actions/append-block/append-block.mjs

@@ -7,7 +7,7 @@ export default {
   key: "notion-append-block",
   name: "Append Block to Parent",
   description: "Append new and/or existing blocks to the specified parent. [See the documentation](https://developers.notion.com/reference/patch-block-children)",
-  version: "0.4.0",
+  version: "0.4.1",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/notion/actions/complete-file-upload/complete-file-upload.mjs

@@ -6,7 +6,7 @@ export default {
   key: "notion-complete-file-upload",
   name: "Complete File Upload",
   description: "Use this action to finalize a `mode=multi_part` file upload after all of the parts have been sent successfully. [See the documentation](https://developers.notion.com/reference/complete-a-file-upload)",
-  version: "0.0.7",
+  version: "0.0.8",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/notion/actions/create-comment/create-comment.mjs

@@ -5,7 +5,7 @@ export default {
   key: "notion-create-comment",
   name: "Create Comment",
   description: "Create a comment in a page or existing discussion thread. [See the documentation](https://developers.notion.com/reference/create-a-comment)",
-  version: "0.0.9",
+  version: "0.0.10",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/notion/actions/create-database/create-database.mjs

@@ -7,7 +7,7 @@ export default {
   key: "notion-create-database",
   name: "Create Database",
   description: "Create a database and its initial data source. [See the documentation](https://developers.notion.com/reference/database-create)",
-  version: "0.1.4",
+  version: "0.1.5",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/notion/actions/create-file-upload/create-file-upload.mjs

@@ -6,7 +6,7 @@ export default {
   key: "notion-create-file-upload",
   name: "Create File Upload",
   description: "Create a file upload. [See the documentation](https://developers.notion.com/reference/create-a-file-upload)",
-  version: "0.0.7",
+  version: "0.0.8",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/notion/actions/create-page-from-database/create-page-from-database.mjs

@@ -1,15 +1,16 @@
+/* eslint-disable no-case-declarations */
+import pick from "lodash-es/pick.js";
 import NOTION_ICONS from "../../common/notion-icons.mjs";
 import utils from "../../common/utils.mjs";
 import notion from "../../notion.app.mjs";
 import base from "../common/base-page-builder.mjs";
-import pick from "lodash-es/pick.js";
 
 export default {
   ...base,
   key: "notion-create-page-from-database",
   name: "Create Page from Data Source",
   description: "Create a page from a data source. [See the documentation](https://developers.notion.com/reference/post-page)",
-  version: "1.1.0",
+  version: "2.0.0",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -25,13 +26,26 @@ export default {
       ],
       label: "Parent Data Source ID",
       description: "Select a parent data source or provide a data source ID",
-      reloadProps: true,
     },
-    Name: {
+    templateType: {
       type: "string",
-      label: "Name",
-      description: "The name of the page. Use this only if the data source has a `title` property named `Name`. Otherwise, use the `Properties` prop below to set the title property.",
-      optional: true,
+      label: "Template Type",
+      description: "The type of template to use for the page. [See the documentation](https://developers.notion.com/docs/creating-pages-from-templates) for more information.",
+      options: [
+        {
+          label: "No template. Provided children and properties are immediately applied.",
+          value: "none",
+        },
+        {
+          label: "Applies the data source's default template to the newly created page. `children` cannot be specified in the create page request.",
+          value: "default",
+        },
+        {
+          label: "Indicates which exact template to apply to the newly created page. children cannot be specified in the create page request.",
+          value: "template_id",
+        },
+      ],
+      reloadProps: true,
     },
     propertyTypes: {
       propDefinition: [
@@ -64,11 +78,6 @@ export default {
       description: "Cover [External URL](https://developers.notion.com/reference/file-object#external-file-objects)",
       optional: true,
     },
-    alert: {
-      type: "alert",
-      alertType: "info",
-      content: "This action will create an empty page by default. To add content, use the `Page Content` prop below.",
-    },
     pageContent: {
       propDefinition: [
         notion,
@@ -77,11 +86,64 @@ export default {
     },
   },
   async additionalProps() {
-    const { properties } = await this.notion.retrieveDataSource(this.parentDataSource);
-    const selectedProperties = pick(properties, this.propertyTypes);
-    return this.buildAdditionalProps({
-      properties: selectedProperties,
-    });
+    switch (this.templateType) {
+    case "none":
+      const { properties } = await this.notion.retrieveDataSource(this.parentDataSource);
+      const selectedProperties = pick(properties, this.propertyTypes);
+      return {
+        alert: {
+          type: "alert",
+          alertType: "info",
+          content: "This action will create an empty page by default. To add content, use the `Page Content` prop below.",
+        },
+        ...this.buildAdditionalProps({
+          properties: selectedProperties,
+        }),
+      };
+    case "default":
+      return {
+        alert: {
+          type: "alert",
+          alertType: "info",
+          content: "This action will create a page using the data source's default template. Using the `Page Content` prop below will `not` apply to the page.",
+        },
+      };
+    case "template_id":
+      return {
+        templateId: {
+          type: "string",
+          label: "Template ID",
+          description: "The ID of the template to use for the page. [See the documentation](https://developers.notion.com/docs/creating-pages-from-templates) for more information.",
+          options: async({ prevContext }) => {
+            const params = {
+              data_source_id: this.parentDataSource,
+            };
+            if (prevContext?.nCursor) {
+              params.start_cursor = prevContext.nCursor;
+            }
+            const {
+              templates, next_cursor: nCursor,
+            } = await this.notion.listTemplates(params);
+            return {
+              options: templates.map(({
+                name: label, id: value,
+              }) => ({
+                label,
+                value,
+              })),
+              context: {
+                nCursor,
+              },
+            };
+          },
+        },
+        alert: {
+          type: "alert",
+          alertType: "info",
+          content: "This action will create a page using the selected template. Using the `Page Content` prop below will `not` apply to the page.",
+        },
+      };
+    }
   },
   methods: {
     ...base.methods,
@@ -91,33 +153,45 @@ export default {
      * @returns the constructed page in Notion format
      */
     buildPage(parentDataSource) {
+      const meta = this.buildDataSourceMeta(parentDataSource);
       this.properties = utils.parseObject(this.properties);
       const properties = this.buildPageProperties(parentDataSource.properties);
-
-      const propertiesArray = [];
-      for (const property of Object.values(parentDataSource.properties)) {
-        if (properties[property.id]) {
-          propertiesArray.push({
-            label: property.name,
-            type: property.type,
-            value: this[property.name] || this.properties[property.name],
-          });
-        }
-      }
-
-      return propertiesArray;
+      const children = this.createBlocks(this.pageContent);
+      return {
+        ...meta,
+        properties,
+        children,
+      };
     },
   },
   async run({ $ }) {
+    const MAX_BLOCKS = 100;
     const parentPage = await this.notion.retrieveDataSource(this.parentDataSource);
-    const properties = await this.buildPage(parentPage);
-    const response = await this.buildPageFromDataSource({
-      pageContent: this.pageContent,
-      parentDataSourceId: this.parentDataSource,
-      properties,
-      icon: this.icon,
-      cover: this.cover,
+    const {
+      children, ...page
+    } = this.buildPage(parentPage);
+    const data = this.templateId
+      ? {
+        template: {
+          type: this.templateType,
+          template_id: this.templateId,
+        },
+      }
+      : {
+        children: children.slice(0, MAX_BLOCKS),
+      };
+    const response = await this.notion.createPage({
+      ...data,
+      ...page,
+      parent: {
+        data_source_id: this.parentDataSource,
+      },
     });
+    let remainingBlocks = children.slice(MAX_BLOCKS);
+    while (remainingBlocks.length > 0) {
+      await this.notion.appendBlock(response.id, remainingBlocks.slice(0, MAX_BLOCKS));
+      remainingBlocks = remainingBlocks.slice(MAX_BLOCKS);
+    }
     $.export("$summary", "Created page successfully");
     return response;
   },

components/notion/actions/create-page/create-page.mjs

@@ -6,7 +6,7 @@ export default {
   key: "notion-create-page",
   name: "Create Page",
   description: "Create a page from a parent page. [See the documentation](https://developers.notion.com/reference/post-page)",
-  version: "0.3.0",
+  version: "0.3.1",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/notion/actions/delete-block/delete-block.mjs

@@ -6,7 +6,7 @@ export default {
   key: "notion-delete-block",
   name: "Delete Block",
   description: "Sets a Block object, including page blocks, to archived: true using the ID specified. [See the documentation](https://developers.notion.com/reference/delete-a-block)",
-  version: "0.0.7",
+  version: "0.0.8",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

components/notion/actions/duplicate-page/duplicate-page.mjs

@@ -7,7 +7,7 @@ export default {
   key: "notion-duplicate-page",
   name: "Duplicate Page",
   description: "Create a new page copied from an existing page block. [See the documentation](https://developers.notion.com/reference/post-page)",
-  version: "0.0.22",
+  version: "0.0.23",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/notion/actions/get-current-user/get-current-user.mjs

@@ -4,7 +4,7 @@ export default {
   key: "notion-get-current-user",
   name: "Get Current User",
   description: "Retrieve the Notion identity tied to the current OAuth token, returning the full `users.retrieve` payload for `me` (person or bot). Includes the user ID, name, avatar URL, type (`person` vs `bot`), and workspace ownership metadata—useful for confirming which workspace is connected, adapting downstream queries, or giving an LLM the context it needs about who is operating inside Notion. [See the documentation](https://developers.notion.com/reference/get-user).",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,