runline 0.33.0 → 0.35.0

package/dist/plugins/homeAssistant/src/index.js

@@ -1,44 +1,21 @@
-async function apiRequest(baseUrl, token, method, endpoint, body, qs) {
-    const url = new URL(`${baseUrl}/api${endpoint}`);
-    if (qs) {
-        for (const [k, v] of Object.entries(qs)) {
-            if (v !== undefined && v !== null)
-                url.searchParams.set(k, String(v));
-        }
-    }
-    const opts = {
-        method,
-        headers: {
-            Authorization: `Bearer ${token}`,
-            "Content-Type": "application/json",
-        },
-    };
-    if (body &&
-        Object.keys(body).length > 0 &&
-        method !== "GET" &&
-        method !== "DELETE")
-        opts.body = JSON.stringify(body);
-    const res = await fetch(url.toString(), opts);
-    if (!res.ok)
-        throw new Error(`Home Assistant API error ${res.status}: ${await res.text()}`);
-    return res.json();
-}
-function getConn(ctx) {
-    const cfg = ctx.connection.config;
-    const ssl = cfg.ssl === true || cfg.ssl === "true";
-    const proto = ssl ? "https" : "http";
-    return {
-        baseUrl: `${proto}://${cfg.host}:${cfg.port ?? 8123}`,
-        token: cfg.accessToken,
-    };
-}
+import { credentialJson, credentialOk, pathSegment, } from "../../_shared/credentials.js";
+import { homeAssistantCredential } from "./credentials.js";
+/** One Home Assistant call: every endpoint is a path beneath /api/. */
 function ha(ctx, method, endpoint, body, qs) {
-    const { baseUrl, token } = getConn(ctx);
-    return apiRequest(baseUrl, token, method, endpoint, body, qs);
+    return credentialJson(ctx, homeAssistantCredential, "homeAssistant", {
+        target: "api",
+        path: endpoint,
+        method,
+        query: qs,
+        ...(body && Object.keys(body).length > 0 && method !== "GET"
+            ? { json: body }
+            : {}),
+    });
 }
 export default function homeAssistant(rl) {
     rl.setName("homeAssistant");
     rl.setVersion("0.1.0");
+    rl.setCredential(homeAssistantCredential);
     rl.setConnectionSchema({
         host: {
             type: "string",
@@ -69,21 +46,21 @@ export default function homeAssistant(rl) {
         access: "read",
         description: "Get Home Assistant configuration",
         async execute(_input, ctx) {
-            return ha(ctx, "GET", "/config");
+            return ha(ctx, "GET", "config");
         },
     });
     rl.registerAction("config.check", {
         access: "read",
         description: "Check if configuration is valid",
         async execute(_input, ctx) {
-            return ha(ctx, "POST", "/config/core/check_config");
+            return ha(ctx, "POST", "config/core/check_config");
         },
     });
     rl.registerAction("service.list", {
         access: "read",
         description: "List available services",
         async execute(_input, ctx) {
-            return ha(ctx, "GET", "/services");
+            return ha(ctx, "GET", "services");
         },
     });
     rl.registerAction("service.call", {
@@ -108,14 +85,14 @@ export default function homeAssistant(rl) {
         },
         async execute(input, ctx) {
             const { domain, service, serviceData } = input;
-            return ha(ctx, "POST", `/services/${domain}/${service}`, serviceData ?? {});
+            return ha(ctx, "POST", `services/${pathSegment(domain)}/${pathSegment(service)}`, serviceData ?? {});
         },
     });
     rl.registerAction("state.list", {
         access: "read",
         description: "List all entity states",
         async execute(_input, ctx) {
-            return ha(ctx, "GET", "/states");
+            return ha(ctx, "GET", "states");
         },
     });
     rl.registerAction("state.get", {
@@ -129,7 +106,7 @@ export default function homeAssistant(rl) {
             },
         },
         async execute(input, ctx) {
-            return ha(ctx, "GET", `/states/${input.entityId}`);
+            return ha(ctx, "GET", `states/${pathSegment(input.entityId)}`);
         },
     });
     rl.registerAction("state.set", {
@@ -149,14 +126,14 @@ export default function homeAssistant(rl) {
             const body = { state };
             if (attributes)
                 body.attributes = attributes;
-            return ha(ctx, "POST", `/states/${entityId}`, body);
+            return ha(ctx, "POST", `states/${pathSegment(entityId)}`, body);
         },
     });
     rl.registerAction("event.list", {
         access: "read",
         description: "List event types",
         async execute(_input, ctx) {
-            return ha(ctx, "GET", "/events");
+            return ha(ctx, "GET", "events");
         },
     });
     rl.registerAction("event.fire", {
@@ -168,14 +145,14 @@ export default function homeAssistant(rl) {
         },
         async execute(input, ctx) {
             const { eventType, eventData } = input;
-            return ha(ctx, "POST", `/events/${eventType}`, eventData ?? {});
+            return ha(ctx, "POST", `events/${pathSegment(eventType)}`, eventData ?? {});
         },
     });
     rl.registerAction("log.getErrors", {
         access: "read",
         description: "Get error log",
         async execute(_input, ctx) {
-            return ha(ctx, "GET", "/error_log");
+            return ha(ctx, "GET", "error_log");
         },
     });
     rl.registerAction("log.getLogbook", {
@@ -200,9 +177,9 @@ export default function homeAssistant(rl) {
         },
         async execute(input, ctx) {
             const { entityId, startTime, endTime } = (input ?? {});
-            let endpoint = "/logbook";
+            let endpoint = "logbook";
             if (startTime)
-                endpoint += `/${startTime}`;
+                endpoint += `/${pathSegment(startTime)}`;
             const qs = {};
             if (entityId)
                 qs.entity = entityId;
@@ -222,9 +199,14 @@ export default function homeAssistant(rl) {
             },
         },
         async execute(input, ctx) {
-            return ha(ctx, "POST", "/template", {
-                template: input.template,
+            // /api/template answers the rendered value as plain text, not JSON.
+            const res = await credentialOk(ctx, homeAssistantCredential, "homeAssistant", {
+                target: "api",
+                path: "template",
+                method: "POST",
+                json: { template: input.template },
             });
+            return res.text();
         },
     });
     rl.registerAction("history.get", {
@@ -245,9 +227,9 @@ export default function homeAssistant(rl) {
         },
         async execute(input, ctx) {
             const { entityIds, startTime, endTime } = (input ?? {});
-            let endpoint = "/history/period";
+            let endpoint = "history/period";
             if (startTime)
-                endpoint += `/${startTime}`;
+                endpoint += `/${pathSegment(startTime)}`;
             const qs = {};
             if (entityIds)
                 qs.filter_entity_id = entityIds;

package/dist/plugins/hubspot/src/credentials.js

@@ -0,0 +1,16 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/**
+ * A private-app access token, sent as a bearer to HubSpot's one API
+ * origin: CRM v3 objects, legacy v1 lists and engagements, and forms.
+ */
+export const hubspotCredential = staticCredential({
+    id: "hubspot",
+    auth: { kind: "bearer" },
+    local: { secret: "accessToken" },
+    targets: {
+        api: {
+            baseUrl: "https://api.hubapi.com/",
+            methods: ["GET", "POST", "PATCH", "DELETE"],
+        },
+    },
+});

package/dist/plugins/hubspot/src/index.js

@@ -1,30 +1,18 @@
-const BASE_URL = "https://api.hubapi.com";
-async function apiRequest(token, method, endpoint, body, qs) {
-    const url = new URL(`${BASE_URL}${endpoint}`);
-    if (qs) {
-        for (const [k, v] of Object.entries(qs)) {
-            if (v !== undefined && v !== null)
-                url.searchParams.set(k, String(v));
-        }
-    }
-    const opts = {
+import { credentialJson, pathSegment } from "../../_shared/credentials.js";
+import { hubspotCredential } from "./credentials.js";
+function apiRequest(ctx, method, path, body, query) {
+    return credentialJson(ctx, hubspotCredential, "hubspot", {
+        target: "api",
+        path,
         method,
-        headers: {
-            Authorization: `Bearer ${token}`,
-            "Content-Type": "application/json",
-        },
-    };
-    if (body &&
-        Object.keys(body).length > 0 &&
-        method !== "GET" &&
-        method !== "DELETE")
-        opts.body = JSON.stringify(body);
-    const res = await fetch(url.toString(), opts);
-    if (!res.ok)
-        throw new Error(`HubSpot API error ${res.status}: ${await res.text()}`);
-    if (res.status === 204)
-        return { success: true };
-    return res.json();
+        query,
+        ...(body &&
+            Object.keys(body).length > 0 &&
+            method !== "GET" &&
+            method !== "DELETE"
+            ? { json: body }
+            : {}),
+    });
 }
 export default function hubspot(rl) {
     rl.setName("hubspot");
@@ -37,7 +25,7 @@ export default function hubspot(rl) {
             env: "HUBSPOT_ACCESS_TOKEN",
         },
     });
-    const tok = (ctx) => ctx.connection.config.accessToken;
+    rl.setCredential(hubspotCredential);
     // Helper for CRM objects (contacts, companies, deals, tickets)
     function registerCrmObject(resource, objectType) {
         rl.registerAction(`${resource}.create`, {
@@ -51,7 +39,7 @@ export default function hubspot(rl) {
                 },
             },
             async execute(input, ctx) {
-                return apiRequest(tok(ctx), "POST", `/crm/v3/objects/${objectType}`, {
+                return apiRequest(ctx, "POST", `crm/v3/objects/${objectType}`, {
                     properties: input
                         .properties,
                 });
@@ -73,7 +61,7 @@ export default function hubspot(rl) {
                 const qs = {};
                 if (properties && Array.isArray(properties))
                     qs.properties = properties.join(",");
-                return apiRequest(tok(ctx), "GET", `/crm/v3/objects/${objectType}/${id}`, undefined, qs);
+                return apiRequest(ctx, "GET", `crm/v3/objects/${objectType}/${pathSegment(id)}`, undefined, qs);
             },
         });
         rl.registerAction(`${resource}.list`, {
@@ -105,7 +93,7 @@ export default function hubspot(rl) {
                     qs.after = after;
                 if (properties && Array.isArray(properties))
                     qs.properties = properties.join(",");
-                return apiRequest(tok(ctx), "GET", `/crm/v3/objects/${objectType}`, undefined, qs);
+                return apiRequest(ctx, "GET", `crm/v3/objects/${objectType}`, undefined, qs);
             },
         });
         rl.registerAction(`${resource}.update`, {
@@ -121,7 +109,7 @@ export default function hubspot(rl) {
             },
             async execute(input, ctx) {
                 const { id, properties } = input;
-                return apiRequest(tok(ctx), "PATCH", `/crm/v3/objects/${objectType}/${id}`, { properties });
+                return apiRequest(ctx, "PATCH", `crm/v3/objects/${objectType}/${pathSegment(id)}`, { properties });
             },
         });
         rl.registerAction(`${resource}.delete`, {
@@ -131,7 +119,7 @@ export default function hubspot(rl) {
                 id: { type: "string", required: true, description: `${resource} ID` },
             },
             async execute(input, ctx) {
-                await apiRequest(tok(ctx), "DELETE", `/crm/v3/objects/${objectType}/${input.id}`);
+                await apiRequest(ctx, "DELETE", `crm/v3/objects/${objectType}/${pathSegment(input.id)}`);
                 return { success: true };
             },
         });
@@ -161,7 +149,7 @@ export default function hubspot(rl) {
                     body.limit = limit;
                 if (after)
                     body.after = after;
-                return apiRequest(tok(ctx), "POST", `/crm/v3/objects/${objectType}/search`, body);
+                return apiRequest(ctx, "POST", `crm/v3/objects/${objectType}/search`, body);
             },
         });
     }
@@ -183,7 +171,7 @@ export default function hubspot(rl) {
         },
         async execute(input, ctx) {
             const { listId, contactIds } = input;
-            return apiRequest(tok(ctx), "POST", `/contacts/v1/lists/${listId}/add`, {
+            return apiRequest(ctx, "POST", `contacts/v1/lists/${pathSegment(listId)}/add`, {
                 vids: contactIds,
             });
         },
@@ -201,7 +189,7 @@ export default function hubspot(rl) {
         },
         async execute(input, ctx) {
             const { listId, contactIds } = input;
-            return apiRequest(tok(ctx), "POST", `/contacts/v1/lists/${listId}/remove`, { vids: contactIds });
+            return apiRequest(ctx, "POST", `contacts/v1/lists/${pathSegment(listId)}/remove`, { vids: contactIds });
         },
     });
     // ── Engagement ──────────────────────────────────────
@@ -232,7 +220,7 @@ export default function hubspot(rl) {
             };
             if (associations)
                 body.associations = associations;
-            return apiRequest(tok(ctx), "POST", "/engagements/v1/engagements", body);
+            return apiRequest(ctx, "POST", "engagements/v1/engagements", body);
         },
     });
     rl.registerAction("engagement.get", {
@@ -246,7 +234,7 @@ export default function hubspot(rl) {
             },
         },
         async execute(input, ctx) {
-            return apiRequest(tok(ctx), "GET", `/engagements/v1/engagements/${input.engagementId}`);
+            return apiRequest(ctx, "GET", `engagements/v1/engagements/${pathSegment(input.engagementId)}`);
         },
     });
     rl.registerAction("engagement.list", {
@@ -263,7 +251,7 @@ export default function hubspot(rl) {
                 qs.limit = limit;
             if (offset)
                 qs.offset = offset;
-            return apiRequest(tok(ctx), "GET", "/engagements/v1/engagements/paged", undefined, qs);
+            return apiRequest(ctx, "GET", "engagements/v1/engagements/paged", undefined, qs);
         },
     });
     rl.registerAction("engagement.delete", {
@@ -277,7 +265,7 @@ export default function hubspot(rl) {
             },
         },
         async execute(input, ctx) {
-            await apiRequest(tok(ctx), "DELETE", `/engagements/v1/engagements/${input.engagementId}`);
+            await apiRequest(ctx, "DELETE", `engagements/v1/engagements/${pathSegment(input.engagementId)}`);
             return { success: true };
         },
     });
@@ -308,7 +296,7 @@ export default function hubspot(rl) {
             const body = { fields };
             if (context)
                 body.context = context;
-            return apiRequest(tok(ctx), "POST", `/submissions/v3/integration/secure/submit/${portalId}/${formId}`, body);
+            return apiRequest(ctx, "POST", `submissions/v3/integration/secure/submit/${pathSegment(portalId)}/${pathSegment(formId)}`, body);
         },
     });
     rl.registerAction("form.getFields", {
@@ -318,7 +306,7 @@ export default function hubspot(rl) {
             formId: { type: "string", required: true, description: "Form GUID" },
         },
         async execute(input, ctx) {
-            return apiRequest(tok(ctx), "GET", `/forms/v2/fields/${input.formId}`);
+            return apiRequest(ctx, "GET", `forms/v2/fields/${pathSegment(input.formId)}`);
         },
     });
 }

package/dist/plugins/humanticAi/src/credentials.js

@@ -0,0 +1,13 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/** An API key, appended by the transport as the apikey query parameter. */
+export const humanticAiCredential = staticCredential({
+    id: "humanticAi",
+    auth: { kind: "queryKey", param: "apikey" },
+    local: { secret: "apiKey" },
+    targets: {
+        api: {
+            baseUrl: "https://api.humantic.ai/v1/",
+            methods: ["GET", "POST"],
+        },
+    },
+});

package/dist/plugins/humanticAi/src/index.js

@@ -1,27 +1,20 @@
-const BASE_URL = "https://api.humantic.ai/v1";
-async function apiRequest(apiKey, method, endpoint, body, qs) {
-    const url = new URL(`${BASE_URL}${endpoint}`);
-    url.searchParams.set("apikey", apiKey);
-    if (qs) {
-        for (const [k, v] of Object.entries(qs)) {
-            if (v !== undefined && v !== null)
-                url.searchParams.set(k, String(v));
-        }
-    }
-    const opts = {
+import { credentialJson } from "../../_shared/credentials.js";
+import { humanticAiCredential } from "./credentials.js";
+function apiRequest(ctx, method, path, body, qs) {
+    return credentialJson(ctx, humanticAiCredential, "humanticAi", {
+        target: "api",
+        path,
         method,
-        headers: { "Content-Type": "application/json" },
-    };
-    if (body && Object.keys(body).length > 0 && method !== "GET")
-        opts.body = JSON.stringify(body);
-    const res = await fetch(url.toString(), opts);
-    if (!res.ok)
-        throw new Error(`Humantic AI error ${res.status}: ${await res.text()}`);
-    return res.json();
+        query: qs,
+        ...(body && Object.keys(body).length > 0 && method !== "GET"
+            ? { json: body }
+            : {}),
+    });
 }
 export default function humanticAi(rl) {
     rl.setName("humanticAi");
     rl.setVersion("0.1.0");
+    rl.setCredential(humanticAiCredential);
     rl.setConnectionSchema({
         apiKey: {
             type: "string",
@@ -57,7 +50,7 @@ export default function humanticAi(rl) {
                 body.linkedin_url = linkedinUrl;
             if (text)
                 body.text = text;
-            return apiRequest(ctx.connection.config.apiKey, "POST", "/user-profile/create", body);
+            return apiRequest(ctx, "POST", "user-profile/create", body);
         },
     });
     rl.registerAction("profile.get", {
@@ -80,7 +73,7 @@ export default function humanticAi(rl) {
             const qs = { userid: userId };
             if (persona)
                 qs.persona = persona;
-            return apiRequest(ctx.connection.config.apiKey, "GET", "/user-profile", undefined, qs);
+            return apiRequest(ctx, "GET", "user-profile", undefined, qs);
         },
     });
     rl.registerAction("profile.update", {
@@ -106,7 +99,7 @@ export default function humanticAi(rl) {
                 body.text = text;
             if (linkedinUrl)
                 body.linkedin_url = linkedinUrl;
-            return apiRequest(ctx.connection.config.apiKey, "POST", "/user-profile/create", body);
+            return apiRequest(ctx, "POST", "user-profile/create", body);
         },
     });
 }

package/dist/plugins/hunter/src/credentials.js

@@ -0,0 +1,13 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/**
+ * An API key, appended by the transport as the api_key query parameter.
+ * Callers may never supply api_key themselves; every action is a GET read.
+ */
+export const hunterCredential = staticCredential({
+    id: "hunter",
+    auth: { kind: "queryKey", param: "api_key" },
+    local: { secret: "apiKey" },
+    targets: {
+        api: { baseUrl: "https://api.hunter.io/v2/", methods: ["GET"] },
+    },
+});

package/dist/plugins/hunter/src/index.js

@@ -1,21 +1,16 @@
-const BASE_URL = "https://api.hunter.io/v2";
-async function apiRequest(apiKey, endpoint, qs) {
-    const url = new URL(`${BASE_URL}${endpoint}`);
-    url.searchParams.set("api_key", apiKey);
-    if (qs) {
-        for (const [k, v] of Object.entries(qs)) {
-            if (v !== undefined && v !== null)
-                url.searchParams.set(k, String(v));
-        }
-    }
-    const res = await fetch(url.toString());
-    if (!res.ok)
-        throw new Error(`Hunter API error ${res.status}: ${await res.text()}`);
-    return res.json();
+import { credentialJson } from "../../_shared/credentials.js";
+import { hunterCredential } from "./credentials.js";
+function apiRequest(ctx, path, qs) {
+    return credentialJson(ctx, hunterCredential, "hunter", {
+        target: "api",
+        path,
+        query: qs,
+    });
 }
 export default function hunter(rl) {
     rl.setName("hunter");
     rl.setVersion("0.1.0");
+    rl.setCredential(hunterCredential);
     rl.setConnectionSchema({
         apiKey: {
             type: "string",
@@ -47,7 +42,7 @@ export default function hunter(rl) {
                 qs.type = type;
             if (limit)
                 qs.limit = limit;
-            const data = (await apiRequest(ctx.connection.config.apiKey, "/domain-search", qs));
+            const data = (await apiRequest(ctx, "domain-search", qs));
             return data.data;
         },
     });
@@ -61,7 +56,11 @@ export default function hunter(rl) {
         },
         async execute(input, ctx) {
             const { domain, firstName, lastName } = input;
-            const data = (await apiRequest(ctx.connection.config.apiKey, "/email-finder", { domain, first_name: firstName, last_name: lastName }));
+            const data = (await apiRequest(ctx, "email-finder", {
+                domain,
+                first_name: firstName,
+                last_name: lastName,
+            }));
             return data.data;
         },
     });
@@ -72,7 +71,9 @@ export default function hunter(rl) {
             email: { type: "string", required: true, description: "Email to verify" },
         },
         async execute(input, ctx) {
-            const data = (await apiRequest(ctx.connection.config.apiKey, "/email-verifier", { email: input.email }));
+            const data = (await apiRequest(ctx, "email-verifier", {
+                email: input.email,
+            }));
             return data.data;
         },
     });

package/dist/plugins/intercom/src/credentials.js

@@ -0,0 +1,19 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/** An access token, sent as a bearer to Intercom's one API origin. */
+export const intercomCredential = staticCredential({
+    id: "intercom",
+    auth: { kind: "bearer" },
+    local: { secret: "accessToken" },
+    targets: {
+        api: {
+            baseUrl: "https://api.intercom.io/",
+            methods: ["GET", "POST", "PUT", "DELETE"],
+        },
+    },
+    probe: {
+        target: "api",
+        path: "me",
+        method: "GET",
+        acceptedStatuses: [200],
+    },
+});