Notion markdown addition (#16194)

* add notion-to-md package

* Adding markdown page retrieval

* Description and clarity updates

Author: GTFalcao

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

@@ -2,9 +2,9 @@ import notion from "../../notion.app.mjs";
 
 export default {
   key: "notion-retrieve-block",
-  name: "Retrieve Block",
-  description: "Get details of a block, which can be text, lists, media, a page, among others. [See the documentation](https://developers.notion.com/reference/retrieve-a-block)",
-  version: "0.0.6",
+  name: "Retrieve Page Content",
+  description: "Get page content as block objects or markdown. Blocks can be text, lists, media, a page, among others. [See the documentation](https://developers.notion.com/reference/retrieve-a-block)",
+  version: "0.1.0",
   type: "action",
   props: {
     notion,
@@ -13,18 +13,28 @@ export default {
         notion,
         "pageId",
       ],
-      label: "Block ID",
-      description: "Select a block or provide a block ID",
     },
     retrieveChildren: {
       type: "boolean",
-      label: "Retrieve Children",
-      description: "Retrieve all the children (recursively) for the specified block. [See the documentation](https://developers.notion.com/reference/get-block-children) for more information",
+      label: "Retrieve Content (Child Blocks)",
+      description: "Retrieve all the children (recursively) for the specified page. [See the documentation](https://developers.notion.com/reference/get-block-children) for more information",
       optional: true,
       default: false,
     },
+    retrieveMarkdown: {
+      type: "boolean",
+      label: "Retrieve as Markdown",
+      description: "Return the page content as markdown instead of block objects.",
+      optional: true,
+    },
   },
   async run({ $ }) {
+    if (this.retrieveMarkdown) {
+      const response = await this.notion.getPageAsMarkdown(this.blockId);
+      $.export("$summary", "Successfully retrieved page as markdown");
+      return response;
+    }
+
     const block = await this.notion.retrieveBlock(this.blockId);
     if (this.retrieveChildren) {
       block.children = await this.notion.retrieveBlockChildren(block);

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

@@ -2,12 +2,17 @@ import notion from "../../notion.app.mjs";
 
 export default {
   key: "notion-retrieve-page",
-  name: "Retrieve Page",
+  name: "Retrieve Page Metadata",
   description: "Get details of a page. [See the documentation](https://developers.notion.com/reference/retrieve-a-page)",
-  version: "0.0.6",
+  version: "0.0.7",
   type: "action",
   props: {
     notion,
+    infoLabel: {
+      type: "alert",
+      alertType: "info",
+      content: "If you need to retrieve page content or block objects, use the **Retrieve Page Content** action instead.",
+    },
     pageId: {
       propDefinition: [
         notion,

components/notion/notion.app.mjs

@@ -1,6 +1,8 @@
 import notion from "@notionhq/client";
 import NOTION_META from "./common/notion-meta-selection.mjs";
 import { ConfigurationError } from "@pipedream/platform";
+import { NotionConverter } from "notion-to-md";
+import { DefaultExporter } from "notion-to-md/plugins/exporter";
 
 export default {
   type: "app",
@@ -355,5 +357,19 @@ export default {
 
       return response.results;
     },
+    async getPageAsMarkdown(pageId) {
+      const client = this._getNotionClient();
+
+      const buffer = {};
+      const exporter = new DefaultExporter({
+        outputType: "buffer",
+        buffer,
+      });
+
+      const n2m = new NotionConverter(client).withExporter(exporter);
+      await n2m.convert(pageId);
+
+      return Object.values(buffer)[0];
+    },
   },
 };

components/notion/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/notion",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Pipedream Notion Components",
   "main": "notion.app.mjs",
   "keywords": [
@@ -13,7 +13,8 @@
     "@notionhq/client": "^2.2.3",
     "@pipedream/platform": "^3.0.3",
     "@tryfabric/martian": "^1.2.4",
-    "lodash-es": "^4.17.21"
+    "lodash-es": "^4.17.21",
+    "notion-to-md": "^4.0.0-alpha.4"
   },
   "publishConfig": {
     "access": "public"