@zerowidth/workbench-sdk 2.0.0-alpha.0

package/nodes/http-request/http-request.config.json

@@ -0,0 +1,90 @@
+{
+  "display_name": "HTTP Request",
+  "tagline": "Make HTTP requests",
+  "description": "Makes HTTP requests (GET, POST, PUT, PATCH, DELETE, etc.) to a specified URL with optional headers, query parameters, and body.",
+  "icon": "globe",
+  "category": "network",
+  "inputs": [
+    {
+      "name": "url",
+      "display_name": "URL",
+      "type": "string",
+      "description": "The URL to send the request to.",
+      "required": true
+    },
+    {
+      "name": "method",
+      "display_name": "Method",
+      "type": "string",
+      "description": "The HTTP method to use.",
+      "default": "GET",
+      "options": ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]
+    },
+    {
+      "name": "headers",
+      "display_name": "Headers",
+      "type": "object",
+      "description": "Optional HTTP headers as key-value pairs.",
+      "required": false
+    },
+    {
+      "name": "query",
+      "display_name": "Query Parameters",
+      "type": "object",
+      "description": "Optional query parameters as key-value pairs.",
+      "required": false
+    },
+    {
+      "name": "body",
+      "display_name": "Body",
+      "type": "any",
+      "description": "Optional request body (for POST, PUT, PATCH, etc.).",
+      "required": false
+    }
+  ],
+  "outputs": [
+    {
+      "name": "status",
+      "display_name": "Status",
+      "type": "number",
+      "description": "The HTTP status code returned by the server."
+    },
+    {
+      "name": "headers",
+      "display_name": "Response Headers",
+      "type": "object",
+      "description": "The response headers as key-value pairs."
+    },
+    {
+      "name": "body",
+      "display_name": "Response Body",
+      "type": "any",
+      "description": "The response body, parsed as JSON if possible, otherwise as text."
+    },
+    {
+      "name": "error",
+      "display_name": "Error",
+      "type": "string",
+      "description": "Error message if the request failed.",
+      "required": false
+    }
+  ],
+  "settings": [
+    {
+      "name": "timeout",
+      "display_name": "Timeout (ms)",
+      "type": "number",
+      "description": "Request timeout in milliseconds.",
+      "default": 10000
+    },
+    {
+      "name": "follow_redirects",
+      "display_name": "Follow Redirects",
+      "type": "boolean",
+      "description": "Whether to follow HTTP redirects.",
+      "default": true
+    }
+  ],
+  "timeout": 15000,
+  "retry_limit": 1
+} 

package/nodes/http-request/http-request.process.js

@@ -0,0 +1,89 @@
+import axios from 'axios';
+
+export default async ({inputs, settings, config, nodeConfig}) => {
+
+  const url = inputs.url;
+  const method = (inputs.method || 'GET').toUpperCase();
+  const headers = inputs.headers || {};
+  const query = inputs.query || {};
+  const body = inputs.body;
+  const timeout = settings.timeout || 10000;
+  const followRedirects = settings.follow_redirects !== false;
+
+  let fullUrl = url;
+  // Append query params if provided
+  if (query && Object.keys(query).length > 0) {
+    const params = new URLSearchParams(query).toString();
+    fullUrl += (url.includes('?') ? '&' : '?') + params;
+  }
+
+  const startTime = Date.now();
+
+  try {
+    const response = await axios({
+      url: fullUrl,
+      method,
+      headers,
+      data: body,
+      timeout,
+      maxRedirects: followRedirects ? 5 : 0,
+      validateStatus: () => true // Always resolve, never throw for HTTP errors
+    });
+
+    if (config._emitAPICall) {
+      await config._emitAPICall({
+        timestamp: startTime,
+        integration: 'http-request',
+        nodeId: nodeConfig?.id || null,
+        nodeType: nodeConfig?.type || 'http-request',
+        request: { method, url: fullUrl, headers, body: body || null },
+        response: { status: response.status, statusText: response.statusText },
+        duration: Date.now() - startTime,
+        error: null
+      });
+    }
+
+    let parsedBody = response.data;
+    const contentType = response.headers['content-type'] || '';
+    // If content-type is JSON and data is a string, try to parse
+    if (contentType.includes('application/json') && typeof parsedBody === 'string') {
+      try {
+        parsedBody = JSON.parse(parsedBody);
+      } catch (e) {
+        // Not valid JSON, keep as string
+      }
+    }
+
+    let error = undefined;
+    if (response.status >= 400) {
+      error = `HTTP error: ${response.status}`;
+    }
+
+    return {
+      status: response.status,
+      headers: response.headers,
+      body: parsedBody,
+      ...(error ? { error } : {})
+    };
+  } catch (err) {
+    if (config._emitAPICall) {
+      await config._emitAPICall({
+        timestamp: startTime,
+        integration: 'http-request',
+        nodeId: nodeConfig?.id || null,
+        nodeType: nodeConfig?.type || 'http-request',
+        request: { method, url: fullUrl, headers, body: body || null },
+        response: { status: err.response ? err.response.status : 0, statusText: err.response ? err.response.statusText : 'Error' },
+        duration: Date.now() - startTime,
+        error: err.message
+      });
+    }
+
+    return {
+      status: err.response ? err.response.status : null,
+      headers: err.response ? err.response.headers : {},
+      body: err.response ? err.response.data : null,
+      error: err.message
+    };
+  }
+};

package/nodes/http-request/http-request.tests.json

@@ -0,0 +1,115 @@
+[
+  {
+    "description": "GET request to httpbin returns status 200 and JSON body",
+    "inputs": {
+      "url": "https://httpbin.org/get",
+      "method": "GET"
+    },
+    "settings": {},
+    "expectedSchema": {
+      "status": { "type": "number", "const": 200 },
+      "headers": { "type": "object" },
+      "body": { "type": "object", "required": ["url"] }
+    }
+  },
+  {
+    "description": "GET request with query params",
+    "inputs": {
+      "url": "https://httpbin.org/get",
+      "method": "GET",
+      "query": { "foo": "bar", "baz": "qux" }
+    },
+    "settings": {},
+    "expectedSchema": {
+      "status": { "type": "number", "const": 200 },
+      "body": {
+        "type": "object",
+        "properties": {
+          "args": {
+            "type": "object",
+            "properties": {
+              "foo": { "type": "string", "const": "bar" },
+              "baz": { "type": "string", "const": "qux" }
+            },
+            "required": ["foo", "baz"]
+          }
+        },
+        "required": ["args"]
+      }
+    }
+  },
+  {
+    "description": "POST request with JSON body",
+    "inputs": {
+      "url": "https://httpbin.org/post",
+      "method": "POST",
+      "headers": { "Content-Type": "application/json" },
+      "body": { "hello": "world" }
+    },
+    "settings": {},
+    "expectedSchema": {
+      "status": { "type": "number", "const": 200 },
+      "body": {
+        "type": "object",
+        "properties": {
+          "json": {
+            "type": "object",
+            "properties": {
+              "hello": { "type": "string", "const": "world" }
+            },
+            "required": ["hello"]
+          }
+        },
+        "required": ["json"]
+      }
+    }
+  },
+  {
+    "description": "Custom headers are sent and received",
+    "inputs": {
+      "url": "https://httpbin.org/headers",
+      "method": "GET",
+      "headers": { "X-Test-Header": "test-value" }
+    },
+    "settings": {},
+    "expectedSchema": {
+      "status": { "type": "number", "const": 200 },
+      "body": {
+        "type": "object",
+        "properties": {
+          "headers": {
+            "type": "object",
+            "properties": {
+              "X-Test-Header": { "type": "string", "const": "test-value" }
+            },
+            "required": ["X-Test-Header"]
+          }
+        },
+        "required": ["headers"]
+      }
+    }
+  },
+  {
+    "description": "404 error returns status and error message",
+    "inputs": {
+      "url": "https://httpbin.org/status/404",
+      "method": "GET"
+    },
+    "settings": {},
+    "expectedSchema": {
+      "status": { "type": "number", "const": 404 },
+      "error": { "type": "string" }
+    }
+  },
+  {
+    "description": "Timeout triggers error",
+    "inputs": {
+      "url": "https://httpbin.org/delay/3",
+      "method": "GET"
+    },
+    "settings": { "timeout": 1000 },
+    "expectedSchema": {
+      "error": { "type": "string" }
+    }
+  }
+] 

package/nodes/hubspot-read-contacts/hubspot-read-contacts.config.json

@@ -0,0 +1,71 @@
+{
+  "display_name": "Read Hubspot Contacts",
+  "tagline": "Read HubSpot contacts",
+  "description": "Retrieve all contacts from HubSpot CRM using query parameters to specify the information that gets returned",
+  "category": "third-party",
+  "provider": ["hubspot"],
+  "needs_key_from": ["hubspot"],
+  "is_plugin": true,
+  "inputs": [
+    {
+      "name": "properties",
+      "display_name": "Properties",
+      "type": "string or array of strings",
+      "description": "Comma-separated list or array of properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored",
+      "default": "email,firstname,lastname,phone"
+    },
+    {
+      "name": "associations",
+      "display_name": "Associations",
+      "type": "string or array of strings",
+      "description": "Comma-separated list or array of object types to retrieve associated IDs for (e.g., 'companies', 'deals'). If any of the specified associations do not exist, they will be ignored"
+    },
+    {
+      "name": "after",
+      "display_name": "After",
+      "type": "string",
+      "description": "The paging cursor token from the previous page response (from paging.next.after)"
+    },
+    {
+      "name": "limit",
+      "display_name": "Limit",
+      "type": "number",
+      "description": "The maximum number of results to display per page",
+      "default": 10
+    }
+  ],
+  "outputs": [
+    {
+      "name": "contacts",
+      "display_name": "Contacts",
+      "type": "array of objects",
+      "description": "Array of contact objects with properties, timestamps, and associations"
+    },
+    {
+      "name": "paging_next_after",
+      "display_name": "Paging Next After",
+      "type": "string",
+      "description": "Cursor token for retrieving the next page of results (from paging.next.after)"
+    },
+    {
+      "name": "paging_next_link",
+      "display_name": "Paging Next Link",
+      "type": "string",
+      "description": "URL that can be used to retrieve the next page of results"
+    },
+    {
+      "name": "paging_prev_before",
+      "display_name": "Paging Previous Before",
+      "type": "string",
+      "description": "Cursor token for retrieving the previous page of results (from paging.prev.before)"
+    },
+    {
+      "name": "paging_prev_link",
+      "display_name": "Paging Previous Link",
+      "type": "string",
+      "description": "URL that can be used to retrieve the previous page of results"
+    }
+  ],
+  "settings": []
+}
+

package/nodes/hubspot-read-contacts/hubspot-read-contacts.process.js

@@ -0,0 +1,56 @@
+export default async ({inputs, settings, config, nodeConfig}) => {
+  // Get HubSpot integration
+  const hubspot = config.integrations?.hubspot;
+  if (!hubspot) {
+    throw new Error("HubSpot integration not found");
+  }
+
+  // Build query parameters
+  const params = {};
+
+  // Add limit if provided (default is handled by API, but we can be explicit)
+  if (inputs.limit !== null && inputs.limit !== undefined) {
+    params.limit = inputs.limit;
+  }
+
+  // Add after (paging cursor) if provided
+  if (inputs.after) {
+    params.after = inputs.after;
+  }
+
+  // Handle properties - convert array to comma-separated string if needed
+  // Default value is set in config, so this will always have a value
+  if (inputs.properties) {
+    if (Array.isArray(inputs.properties)) {
+      params.properties = inputs.properties.join(',');
+    } else if (typeof inputs.properties === 'string') {
+      params.properties = inputs.properties;
+    }
+  }
+
+  // Handle associations - convert array to comma-separated string if needed
+  if (inputs.associations) {
+    if (Array.isArray(inputs.associations)) {
+      params.associations = inputs.associations.join(',');
+    } else if (typeof inputs.associations === 'string') {
+      params.associations = inputs.associations;
+    }
+  }
+
+  // Make API request
+  const response = await hubspot.get('/crm/v3/objects/contacts', params);
+
+  // Extract results and paging information
+  const contacts = response.results || [];
+  const paging = response.paging || {};
+
+  // Return formatted output
+  return {
+    contacts: contacts,
+    paging_next_after: paging.next?.after || null,
+    paging_next_link: paging.next?.link || null,
+    paging_prev_before: paging.prev?.before || null,
+    paging_prev_link: paging.prev?.link || null
+  };
+};
+

package/nodes/hubspot-search-contacts/hubspot-search-contacts.config.json

@@ -0,0 +1,89 @@
+{
+  "display_name": "Search Hubspot Contacts",
+  "tagline": "Search HubSpot contacts",
+  "description": "Search for contacts by filtering on properties, searching through associations, and sorting results",
+  "category": "third-party",
+  "provider": ["hubspot"],
+  "needs_key_from": ["hubspot"],
+  "is_plugin": true,
+  "inputs": [
+    {
+      "name": "query",
+      "display_name": "Search Query",
+      "type": "string",
+      "description": "The search query string, up to 3000 characters",
+      "required": true
+    },
+    {
+      "name": "properties",
+      "display_name": "Properties",
+      "type": "string or array of strings",
+      "description": "Comma-separated list or array of properties to include in the response",
+      "default": "email,firstname,lastname,phone"
+    },
+    {
+      "name": "limit",
+      "display_name": "Limit",
+      "type": "number",
+      "description": "The maximum number of results to return (up to 200)",
+      "default": 10
+    },
+    {
+      "name": "sorts",
+      "display_name": "Sorts",
+      "type": "string or array of strings",
+      "description": "Comma-separated list or array of property names to sort by. Prefix with '-' for descending order (e.g., 'lastname' or '-createdAt')"
+    },
+    {
+      "name": "after",
+      "display_name": "After",
+      "type": "string",
+      "description": "A paging cursor token from the previous page response (from paging.next.after) for retrieving subsequent pages"
+    }
+  ],
+  "outputs": [
+    {
+      "name": "contacts",
+      "display_name": "Contacts",
+      "type": "array of objects",
+      "description": "Array of contact objects matching the search criteria"
+    },
+    {
+      "name": "total",
+      "display_name": "Total",
+      "type": "number",
+      "description": "The total number of available results matching the search"
+    },
+    {
+      "name": "paging_next_after",
+      "display_name": "Paging Next After",
+      "type": "string",
+      "description": "Cursor token for retrieving the next page of results (from paging.next.after)"
+    },
+    {
+      "name": "paging_next_link",
+      "display_name": "Paging Next Link",
+      "type": "string",
+      "description": "URL that can be used to retrieve the next page of results"
+    },
+    {
+      "name": "paging_prev_before",
+      "display_name": "Paging Previous Before",
+      "type": "string",
+      "description": "Cursor token for retrieving the previous page of results (from paging.prev.before)"
+    },
+    {
+      "name": "paging_prev_link",
+      "display_name": "Paging Previous Link",
+      "type": "string",
+      "description": "URL that can be used to retrieve the previous page of results"
+    }
+  ],
+  "settings": []
+}
+
+
+
+
+
+

package/nodes/hubspot-search-contacts/hubspot-search-contacts.process.js

@@ -0,0 +1,71 @@
+export default async ({inputs, settings, config, nodeConfig}) => {
+  // Get HubSpot integration
+  const hubspot = config.integrations?.hubspot;
+  if (!hubspot) {
+    throw new Error("HubSpot integration not found");
+  }
+
+  // Build request body
+  const body = {
+    query: inputs.query
+  };
+
+  // Add properties - convert array to array if needed (API expects array)
+  if (inputs.properties) {
+    if (Array.isArray(inputs.properties)) {
+      body.properties = inputs.properties;
+    } else if (typeof inputs.properties === 'string') {
+      // Split comma-separated string into array
+      body.properties = inputs.properties.split(',').map(p => p.trim()).filter(p => p.length > 0);
+    }
+  }
+
+  // Add limit if provided
+  if (inputs.limit !== null && inputs.limit !== undefined) {
+    body.limit = Math.min(inputs.limit, 200); // Cap at 200 as per API
+  }
+
+  // Add after (paging cursor) if provided
+  if (inputs.after) {
+    body.after = inputs.after;
+  }
+
+  // Add sorts - convert string to array if needed
+  if (inputs.sorts) {
+    if (Array.isArray(inputs.sorts)) {
+      body.sorts = inputs.sorts;
+    } else if (typeof inputs.sorts === 'string') {
+      // Split comma-separated string into array
+      body.sorts = inputs.sorts.split(',').map(s => s.trim()).filter(s => s.length > 0);
+    }
+  }
+
+  // Add filterGroups if provided (complex object, pass as-is)
+  if (inputs.filter_groups && Array.isArray(inputs.filter_groups)) {
+    body.filterGroups = inputs.filter_groups;
+  }
+
+  // Make API request (POST)
+  const response = await hubspot.post('/crm/v3/objects/contacts/search', body);
+
+  // Extract results and paging information
+  const contacts = response.results || [];
+  const total = response.total || 0;
+  const paging = response.paging || {};
+
+  // Return formatted output
+  return {
+    contacts: contacts,
+    total: total,
+    paging_next_after: paging.next?.after || null,
+    paging_next_link: paging.next?.link || null,
+    paging_prev_before: paging.prev?.before || null,
+    paging_prev_link: paging.prev?.link || null
+  };
+};
+
+
+
+
+
+

package/nodes/if-else/if-else.config.json

@@ -0,0 +1,50 @@
+{
+  "display_name": "If/Else",
+  "tagline": "Route conditionally",
+  "description": "Routes data based on a condition",
+  "category": "logic",
+  "inputs": [
+    {
+      "name": "condition",
+      "display_name": "Condition",
+      "description": "Boolean condition to evaluate",
+      "type": "boolean",
+      "required": true
+    },
+    {
+      "name": "if_true",
+      "display_name": "If True",
+      "description": "Value to output if condition is true",
+      "type": "any"
+    },
+    {
+      "name": "if_false",
+      "display_name": "If False",
+      "description": "Value to output if condition is false",
+      "type": "any"
+    }
+  ],
+  "outputs": [
+    {
+      "name": "result",
+      "display_name": "Result",
+      "description": "Output based on condition",
+      "type": "any",
+      "conditional": true
+    },
+    {
+      "name": "true_path",
+      "display_name": "True Path",
+      "description": "Triggered only when condition is true",
+      "type": "boolean",
+      "conditional": true
+    },
+    {
+      "name": "false_path",
+      "display_name": "False Path",
+      "description": "Triggered only when condition is false",
+      "type": "boolean",
+      "conditional": true
+    }
+  ]
+} 

package/nodes/if-else/if-else.process.js

@@ -0,0 +1,39 @@
+export default async ({inputs, settings, config}) => {
+
+  // Convert various truthy/falsy values to boolean
+  let condition = false;
+  
+  if (typeof inputs.condition === 'boolean') {
+    condition = inputs.condition;
+  } else if (typeof inputs.condition === 'number') {
+    condition = inputs.condition !== 0;
+  } else if (typeof inputs.condition === 'string') {
+    const lowered = inputs.condition.toLowerCase().trim();
+    condition = lowered !== '' && 
+                lowered !== 'false' && 
+                lowered !== '0' && 
+                lowered !== 'no' &&
+                lowered !== 'null' &&
+                lowered !== 'undefined';
+  } else {
+    condition = !!inputs.condition;
+  }
+  
+  // Prepare result based on condition
+  const result = condition ? inputs.if_true : inputs.if_false;
+  
+  // Return different outputs based on condition
+  if (condition) {
+    return {
+      result,
+      true_path: true,
+      // false_path is intentionally not set
+    };
+  } else {
+    return {
+      result,
+      false_path: true
+      // true_path is intentionally not set
+    };
+  }
+};