@forestnpm/n8n-nodes-forest 1.0.0

package/README.md

@@ -0,0 +1,73 @@
+# n8n-nodes-forest
+
+This is an n8n community node for integrating with Forest.
+
+## Installation
+
+### In n8n Desktop or Self-hosted
+
+1. Go to **Settings > Community Nodes**
+2. Select **Install**
+3. Enter `n8n-nodes-forest` in the input field
+4. Click **Install**
+
+### Manual Installation
+
+```bash
+pnpm install n8n-nodes-forest
+```
+
+## Development
+
+### Prerequisites
+
+- Node.js >= 18.10
+- pnpm >= 9.1
+
+### Setup
+
+```bash
+# Use Node.js 20
+nvm use 20
+
+# Install n8n
+npm install -g n8n
+
+# Install dependencies
+pnpm install
+
+# Build the project
+pnpm build
+
+# Run in development mode (watch)
+pnpm dev
+
+# Run n8n
+n8n
+```
+
+### Testing in n8n
+
+1. Build the package: `pnpm build`
+2. Link the package globally: `pnpm link --global`
+3. In your n8n installation directory: `pnpm link --global n8n-nodes-forest`
+4. Restart n8n
+
+## Credentials
+
+This node requires Forest API credentials:
+- **API Key**: Your Forest API key
+- **Base URL**: The Forest API base URL (default: https://api.forestadmin.com)
+
+## Usage
+
+For details on filters and aggregations syntax, see the [Forest Admin filters documentation](https://docs.forestadmin.com/developer-guide-agents-nodejs/data-sources/getting-started/queries/filters).
+
+## Resources
+
+- [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)
+- [Forest Documentation](https://docs.forestadmin.com/)
+
+## License
+
+MIT

package/dist/credentials/ForestApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class ForestApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/ForestApi.credentials.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForestApi = void 0;
+class ForestApi {
+    constructor() {
+        this.name = 'forestApi';
+        this.displayName = 'Forest API';
+        this.documentationUrl = 'https://docs.forestadmin.com/';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                required: true,
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://api.forestadmin.com',
+                required: true,
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/health',
+            },
+        };
+    }
+}
+exports.ForestApi = ForestApi;

package/dist/credentials/ForestMcpApi.credentials.d.ts

@@ -0,0 +1,7 @@
+import type { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class ForestMcpApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/ForestMcpApi.credentials.js

@@ -0,0 +1,66 @@
+var __n8n_g = Function("return this")();
+var __n8n_setTimeout = __n8n_g.setTimeout;
+var __n8n_clearTimeout = __n8n_g.clearTimeout;
+var __n8n_setInterval = __n8n_g.setInterval;
+var __n8n_clearInterval = __n8n_g.clearInterval;
+var __n8n_setImmediate = __n8n_g.setImmediate;
+var __n8n_clearImmediate = __n8n_g.clearImmediate;
+var __n8n_globalThis = __n8n_g.globalThis;
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// credentials/ForestMcpApi.credentials.ts
+var ForestMcpApi_credentials_exports = {};
+__export(ForestMcpApi_credentials_exports, {
+  ForestMcpApi: () => ForestMcpApi
+});
+module.exports = __toCommonJS(ForestMcpApi_credentials_exports);
+var ForestMcpApi = class {
+  constructor() {
+    this.name = "forestMcpApi";
+    this.displayName = "Forest MCP API";
+    this.documentationUrl = "https://docs.forestadmin.com/developer-guide-agents-nodejs/agent-customization/ai/mcp-server";
+    this.properties = [
+      {
+        displayName: "Server URL",
+        name: "serverUrl",
+        type: "string",
+        default: "",
+        required: true,
+        placeholder: "e.g. https://your-server.com",
+        description: "The Forest Admin server URL (without /mcp suffix)"
+      },
+      {
+        displayName: "Token",
+        name: "token",
+        type: "string",
+        typeOptions: {
+          password: true
+        },
+        default: "",
+        required: true,
+        description: "The Bearer token to authenticate with your Forest MCP server"
+      }
+    ];
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ForestMcpApi
+});

package/dist/credentials/ForestMcpOAuth2Api.credentials.d.ts

@@ -0,0 +1,8 @@
+import type { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class ForestMcpOAuth2Api implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    extends: string[];
+    properties: INodeProperties[];
+}

package/dist/credentials/ForestMcpOAuth2Api.credentials.js

@@ -0,0 +1,87 @@
+var __n8n_g = Function("return this")();
+var __n8n_setTimeout = __n8n_g.setTimeout;
+var __n8n_clearTimeout = __n8n_g.clearTimeout;
+var __n8n_setInterval = __n8n_g.setInterval;
+var __n8n_clearInterval = __n8n_g.clearInterval;
+var __n8n_setImmediate = __n8n_g.setImmediate;
+var __n8n_clearImmediate = __n8n_g.clearImmediate;
+var __n8n_globalThis = __n8n_g.globalThis;
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// credentials/ForestMcpOAuth2Api.credentials.ts
+var ForestMcpOAuth2Api_credentials_exports = {};
+__export(ForestMcpOAuth2Api_credentials_exports, {
+  ForestMcpOAuth2Api: () => ForestMcpOAuth2Api
+});
+module.exports = __toCommonJS(ForestMcpOAuth2Api_credentials_exports);
+var ForestMcpOAuth2Api = class {
+  constructor() {
+    this.name = "forestMcpOAuth2Api";
+    this.displayName = "Forest MCP OAuth2 API";
+    this.documentationUrl = "https://docs.forestadmin.com/developer-guide-agents-nodejs/agent-customization/ai/mcp-server";
+    this.extends = ["oAuth2Api"];
+    this.properties = [
+      {
+        displayName: "Server URL",
+        name: "serverUrl",
+        type: "string",
+        default: "",
+        required: true,
+        placeholder: "e.g. https://your-server.com",
+        description: "The url of your Forest Admin server (without /mcp suffix)"
+      },
+      {
+        displayName: "Use Dynamic Client Registration",
+        name: "useDynamicClientRegistration",
+        type: "boolean",
+        default: true,
+        description: "Whether to use OAuth 2.0 Dynamic Client Registration"
+      },
+      {
+        displayName: "Grant Type",
+        name: "grantType",
+        type: "hidden",
+        default: "authorizationCode"
+      },
+      {
+        displayName: "Authorization URL",
+        name: "authUrl",
+        type: "hidden",
+        default: ""
+      },
+      {
+        displayName: "Access Token URL",
+        name: "accessTokenUrl",
+        type: "hidden",
+        default: ""
+      },
+      {
+        displayName: "Authentication",
+        name: "authentication",
+        type: "hidden",
+        default: "body"
+      }
+    ];
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ForestMcpOAuth2Api
+});

package/dist/nodes/Forest/Forest.node.d.ts

@@ -0,0 +1,11 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription, NodeExecutionWithMetadata } from 'n8n-workflow';
+import * as listSearch from './listSearch';
+import * as resourceMapping from './resourceMapping';
+export declare class Forest implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        listSearch: typeof listSearch;
+        resourceMapping: typeof resourceMapping;
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][] | NodeExecutionWithMetadata[][] | null>;
+}