runline 0.33.0 → 0.35.0

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

@@ -1,30 +1,18 @@
-const BASE_URL = "https://api.helpscout.net/v2";
-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 { credentialOk, jsonAnswer, pathSegment, } from "../../_shared/credentials.js";
+import { helpscoutCredential } from "./credentials.js";
+async function apiRequest(ctx, method, endpoint, body, qs) {
+    const res = await credentialOk(ctx, helpscoutCredential, "helpscout", {
+        target: "api",
+        path: endpoint,
         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(`HelpScout API error ${res.status}: ${await res.text()}`);
+        query: qs,
+        ...(body && Object.keys(body).length > 0 && method !== "GET"
+            ? { json: body }
+            : {}),
+    });
     if (res.status === 201 || res.status === 204)
         return { success: true, location: res.headers.get("Location") };
-    return res.json();
+    return jsonAnswer(res);
 }
 function unwrapEmbedded(data, key) {
     if (data &&
@@ -37,6 +25,7 @@ function unwrapEmbedded(data, key) {
 export default function helpscout(rl) {
     rl.setName("helpscout");
     rl.setVersion("0.1.0");
+    rl.setCredential(helpscoutCredential);
     rl.setConnectionSchema({
         accessToken: {
             type: "string",
@@ -45,7 +34,6 @@ export default function helpscout(rl) {
             env: "HELPSCOUT_ACCESS_TOKEN",
         },
     });
-    const tok = (ctx) => ctx.connection.config.accessToken;
     // ── Conversation ────────────────────────────────────
     rl.registerAction("conversation.create", {
         access: "write",
@@ -88,7 +76,7 @@ export default function helpscout(rl) {
                 body.status = status;
             if (tags)
                 body.tags = tags;
-            return apiRequest(tok(ctx), "POST", "/conversations", body);
+            return apiRequest(ctx, "POST", "conversations", body);
         },
     });
     rl.registerAction("conversation.get", {
@@ -102,7 +90,7 @@ export default function helpscout(rl) {
             },
         },
         async execute(input, ctx) {
-            return apiRequest(tok(ctx), "GET", `/conversations/${input.conversationId}`);
+            return apiRequest(ctx, "GET", `conversations/${pathSegment(input.conversationId)}`);
         },
     });
     rl.registerAction("conversation.list", {
@@ -133,7 +121,7 @@ export default function helpscout(rl) {
                 qs.pageSize = limit;
             if (page)
                 qs.page = page;
-            return unwrapEmbedded(await apiRequest(tok(ctx), "GET", "/conversations", undefined, qs), "conversations");
+            return unwrapEmbedded(await apiRequest(ctx, "GET", "conversations", undefined, qs), "conversations");
         },
     });
     rl.registerAction("conversation.delete", {
@@ -147,7 +135,7 @@ export default function helpscout(rl) {
             },
         },
         async execute(input, ctx) {
-            await apiRequest(tok(ctx), "DELETE", `/conversations/${input.conversationId}`);
+            await apiRequest(ctx, "DELETE", `conversations/${pathSegment(input.conversationId)}`);
             return { success: true };
         },
     });
@@ -174,7 +162,7 @@ export default function helpscout(rl) {
                 body.emails = emails;
             if (phones)
                 body.phones = phones;
-            return apiRequest(tok(ctx), "POST", "/customers", body);
+            return apiRequest(ctx, "POST", "customers", body);
         },
     });
     rl.registerAction("customer.get", {
@@ -188,7 +176,7 @@ export default function helpscout(rl) {
             },
         },
         async execute(input, ctx) {
-            return apiRequest(tok(ctx), "GET", `/customers/${input.customerId}`);
+            return apiRequest(ctx, "GET", `customers/${pathSegment(input.customerId)}`);
         },
     });
     rl.registerAction("customer.list", {
@@ -205,7 +193,7 @@ export default function helpscout(rl) {
                 qs.pageSize = limit;
             if (page)
                 qs.page = page;
-            return unwrapEmbedded(await apiRequest(tok(ctx), "GET", "/customers", undefined, qs), "customers");
+            return unwrapEmbedded(await apiRequest(ctx, "GET", "customers", undefined, qs), "customers");
         },
     });
     rl.registerAction("customer.update", {
@@ -225,7 +213,7 @@ export default function helpscout(rl) {
         },
         async execute(input, ctx) {
             const { customerId, properties } = input;
-            return apiRequest(tok(ctx), "PUT", `/customers/${customerId}`, properties);
+            return apiRequest(ctx, "PUT", `customers/${pathSegment(customerId)}`, properties);
         },
     });
     rl.registerAction("customer.getProperties", {
@@ -239,7 +227,7 @@ export default function helpscout(rl) {
             },
         },
         async execute(input, ctx) {
-            return apiRequest(tok(ctx), "GET", `/customers/${input.customerId}/properties`);
+            return apiRequest(ctx, "GET", `customers/${pathSegment(input.customerId)}/properties`);
         },
     });
     // ── Mailbox ─────────────────────────────────────────
@@ -250,14 +238,14 @@ export default function helpscout(rl) {
             mailboxId: { type: "number", required: true, description: "Mailbox ID" },
         },
         async execute(input, ctx) {
-            return apiRequest(tok(ctx), "GET", `/mailboxes/${input.mailboxId}`);
+            return apiRequest(ctx, "GET", `mailboxes/${pathSegment(input.mailboxId)}`);
         },
     });
     rl.registerAction("mailbox.list", {
         access: "read",
         description: "List mailboxes",
         async execute(_input, ctx) {
-            return unwrapEmbedded(await apiRequest(tok(ctx), "GET", "/mailboxes"), "mailboxes");
+            return unwrapEmbedded(await apiRequest(ctx, "GET", "mailboxes"), "mailboxes");
         },
     });
     // ── Thread ──────────────────────────────────────────
@@ -291,7 +279,7 @@ export default function helpscout(rl) {
             const body = { type, text };
             if (customer)
                 body.customer = customer;
-            return apiRequest(tok(ctx), "POST", `/conversations/${conversationId}/reply`, body);
+            return apiRequest(ctx, "POST", `conversations/${pathSegment(conversationId)}/reply`, body);
         },
     });
     rl.registerAction("thread.list", {
@@ -305,7 +293,7 @@ export default function helpscout(rl) {
             },
         },
         async execute(input, ctx) {
-            return unwrapEmbedded(await apiRequest(tok(ctx), "GET", `/conversations/${input.conversationId}/threads`), "threads");
+            return unwrapEmbedded(await apiRequest(ctx, "GET", `conversations/${pathSegment(input.conversationId)}/threads`), "threads");
         },
     });
 }

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

@@ -0,0 +1,19 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/** The API version header every HighLevel request carries. */
+export const HIGHLEVEL_VERSION = "2021-07-28";
+/**
+ * An OAuth2 access token, sent as a bearer to HighLevel's one API origin.
+ * The Version header is a public API-version marker, not a credential.
+ */
+export const highlevelCredential = staticCredential({
+    id: "highlevel",
+    auth: { kind: "bearer" },
+    local: { secret: "accessToken" },
+    targets: {
+        api: {
+            baseUrl: "https://services.leadconnectorhq.com/",
+            methods: ["GET", "POST", "PUT", "DELETE"],
+            allowedHeaders: ["Version"],
+        },
+    },
+});

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

@@ -1,38 +1,22 @@
-const BASE = "https://services.leadconnectorhq.com";
-function getConn(ctx) {
-    return {
-        token: ctx.connection.config.accessToken,
-        locationId: ctx.connection.config.locationId,
-    };
+import { credentialJson, pathSegment } from "../../_shared/credentials.js";
+import { HIGHLEVEL_VERSION, highlevelCredential } from "./credentials.js";
+function locationOf(ctx) {
+    return ctx.connection.config.locationId;
 }
-async function api(token, method, path, body, qs) {
-    const url = new URL(`${BASE}${path}`);
-    if (qs) {
-        for (const [k, v] of Object.entries(qs)) {
-            if (v !== undefined && v !== null)
-                url.searchParams.set(k, String(v));
-        }
-    }
-    const init = {
+function api(ctx, method, path, body, qs) {
+    return credentialJson(ctx, highlevelCredential, "highlevel", {
+        target: "api",
+        path,
         method,
-        headers: {
-            Authorization: `Bearer ${token}`,
-            "Content-Type": "application/json",
-            Accept: "application/json",
-            Version: "2021-07-28",
-        },
-    };
-    if (body && Object.keys(body).length > 0)
-        init.body = JSON.stringify(body);
-    const res = await fetch(url.toString(), init);
-    if (!res.ok)
-        throw new Error(`HighLevel error ${res.status}: ${await res.text()}`);
-    const text = await res.text();
-    return text ? JSON.parse(text) : { success: true };
+        query: qs,
+        headers: { Version: HIGHLEVEL_VERSION },
+        ...(body && Object.keys(body).length > 0 ? { json: body } : {}),
+    });
 }
 export default function highlevel(rl) {
     rl.setName("highlevel");
     rl.setVersion("0.1.0");
+    rl.setCredential(highlevelCredential);
     rl.setConnectionSchema({
         accessToken: {
             type: "string",
@@ -77,13 +61,16 @@ export default function highlevel(rl) {
             },
         },
         async execute(input, ctx) {
-            const { token, locationId } = getConn(ctx);
-            const body = { ...input, locationId };
+            const locationId = locationOf(ctx);
+            const body = {
+                ...input,
+                locationId,
+            };
             if (typeof body.tags === "string")
                 body.tags = body.tags
                     .split(",")
                     .map((t) => t.trim());
-            const res = (await api(token, "POST", "/contacts/upsert/", body));
+            const res = (await api(ctx, "POST", "contacts/upsert/", body));
             return res.contact ?? res;
         },
     });
@@ -92,8 +79,7 @@ export default function highlevel(rl) {
         description: "Get a contact by ID",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            const { token } = getConn(ctx);
-            const res = (await api(token, "GET", `/contacts/${input.id}/`));
+            const res = (await api(ctx, "GET", `contacts/${pathSegment(input.id)}/`));
             return res.contact ?? res;
         },
     });
@@ -115,7 +101,7 @@ export default function highlevel(rl) {
             order: { type: "string", required: false, description: "asc or desc" },
         },
         async execute(input, ctx) {
-            const { token, locationId } = getConn(ctx);
+            const locationId = locationOf(ctx);
             const p = (input ?? {});
             const qs = { locationId };
             if (p.limit)
@@ -126,7 +112,7 @@ export default function highlevel(rl) {
                 qs.sortBy = p.sortBy;
             if (p.order)
                 qs.order = p.order;
-            const res = (await api(token, "GET", "/contacts/", undefined, qs));
+            const res = (await api(ctx, "GET", "contacts/", undefined, qs));
             return res.contacts ?? res;
         },
     });
@@ -150,13 +136,12 @@ export default function highlevel(rl) {
             customFields: { type: "object", required: false },
         },
         async execute(input, ctx) {
-            const { token } = getConn(ctx);
             const { id, ...body } = input;
             if (typeof body.tags === "string")
                 body.tags = body.tags
                     .split(",")
                     .map((t) => t.trim());
-            const res = (await api(token, "PUT", `/contacts/${id}/`, body));
+            const res = (await api(ctx, "PUT", `contacts/${pathSegment(id)}/`, body));
             return res.contact ?? res;
         },
     });
@@ -165,8 +150,7 @@ export default function highlevel(rl) {
         description: "Delete a contact",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            const { token } = getConn(ctx);
-            await api(token, "DELETE", `/contacts/${input.id}/`);
+            await api(ctx, "DELETE", `contacts/${pathSegment(input.id)}/`);
             return { success: true };
         },
     });
@@ -194,8 +178,11 @@ export default function highlevel(rl) {
             tags: { type: "object", required: false },
         },
         async execute(input, ctx) {
-            const { token, locationId } = getConn(ctx);
-            const body = { ...input, locationId };
+            const locationId = locationOf(ctx);
+            const body = {
+                ...input,
+                locationId,
+            };
             if (body.stageId) {
                 body.pipelineStageId = body.stageId;
                 delete body.stageId;
@@ -204,7 +191,7 @@ export default function highlevel(rl) {
                 body.tags = body.tags
                     .split(",")
                     .map((t) => t.trim());
-            return api(token, "POST", "/opportunities/", body);
+            return api(ctx, "POST", "opportunities/", body);
         },
     });
     rl.registerAction("opportunity.get", {
@@ -212,8 +199,7 @@ export default function highlevel(rl) {
         description: "Get an opportunity",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            const { token } = getConn(ctx);
-            return api(token, "GET", `/opportunities/${input.id}`);
+            return api(ctx, "GET", `opportunities/${pathSegment(input.id)}`);
         },
     });
     rl.registerAction("opportunity.list", {
@@ -230,7 +216,7 @@ export default function highlevel(rl) {
             endDate: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            const { token, locationId } = getConn(ctx);
+            const locationId = locationOf(ctx);
             const p = (input ?? {});
             const qs = { location_id: locationId };
             if (p.limit)
@@ -249,7 +235,7 @@ export default function highlevel(rl) {
                 qs.startDate = new Date(p.startDate).getTime();
             if (p.endDate)
                 qs.endDate = new Date(p.endDate).getTime();
-            const res = (await api(token, "GET", "/opportunities/search", undefined, qs));
+            const res = (await api(ctx, "GET", "opportunities/search", undefined, qs));
             return res.opportunities ?? res;
         },
     });
@@ -266,13 +252,12 @@ export default function highlevel(rl) {
             assignedTo: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            const { token } = getConn(ctx);
             const { id, ...body } = input;
             if (body.stageId) {
                 body.pipelineStageId = body.stageId;
                 delete body.stageId;
             }
-            return api(token, "PUT", `/opportunities/${id}`, body);
+            return api(ctx, "PUT", `opportunities/${pathSegment(id)}`, body);
         },
     });
     rl.registerAction("opportunity.delete", {
@@ -280,8 +265,7 @@ export default function highlevel(rl) {
         description: "Delete an opportunity",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            const { token } = getConn(ctx);
-            await api(token, "DELETE", `/opportunities/${input.id}`);
+            await api(ctx, "DELETE", `opportunities/${pathSegment(input.id)}`);
             return { success: true };
         },
     });
@@ -298,9 +282,8 @@ export default function highlevel(rl) {
             assignedTo: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            const { token } = getConn(ctx);
             const { contactId, ...body } = input;
-            return api(token, "POST", `/contacts/${contactId}/tasks/`, body);
+            return api(ctx, "POST", `contacts/${pathSegment(contactId)}/tasks/`, body);
         },
     });
     rl.registerAction("task.get", {
@@ -311,9 +294,8 @@ export default function highlevel(rl) {
             taskId: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            const { token } = getConn(ctx);
             const p = input;
-            return api(token, "GET", `/contacts/${p.contactId}/tasks/${p.taskId}/`);
+            return api(ctx, "GET", `contacts/${pathSegment(p.contactId)}/tasks/${pathSegment(p.taskId)}/`);
         },
     });
     rl.registerAction("task.list", {
@@ -321,8 +303,7 @@ export default function highlevel(rl) {
         description: "List tasks for a contact",
         inputSchema: { contactId: { type: "string", required: true } },
         async execute(input, ctx) {
-            const { token } = getConn(ctx);
-            const res = (await api(token, "GET", `/contacts/${input.contactId}/tasks/`));
+            const res = (await api(ctx, "GET", `contacts/${pathSegment(input.contactId)}/tasks/`));
             return res.tasks ?? res;
         },
     });
@@ -339,9 +320,8 @@ export default function highlevel(rl) {
             assignedTo: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            const { token } = getConn(ctx);
             const { contactId, taskId, ...body } = input;
-            return api(token, "PUT", `/contacts/${contactId}/tasks/${taskId}/`, body);
+            return api(ctx, "PUT", `contacts/${pathSegment(contactId)}/tasks/${pathSegment(taskId)}/`, body);
         },
     });
     rl.registerAction("task.delete", {
@@ -352,9 +332,8 @@ export default function highlevel(rl) {
             taskId: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            const { token } = getConn(ctx);
             const p = input;
-            await api(token, "DELETE", `/contacts/${p.contactId}/tasks/${p.taskId}/`);
+            await api(ctx, "DELETE", `contacts/${pathSegment(p.contactId)}/tasks/${pathSegment(p.taskId)}/`);
             return { success: true };
         },
     });
@@ -383,8 +362,7 @@ export default function highlevel(rl) {
             toNotify: { type: "boolean", required: false },
         },
         async execute(input, ctx) {
-            const { token } = getConn(ctx);
-            return api(token, "POST", "/calendars/events/appointments", input);
+            return api(ctx, "POST", "calendars/events/appointments", input);
         },
     });
     rl.registerAction("calendar.getFreeSlots", {
@@ -406,7 +384,6 @@ export default function highlevel(rl) {
             userId: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            const { token } = getConn(ctx);
             const p = input;
             const qs = {
                 startDate: p.startDate,
@@ -416,7 +393,7 @@ export default function highlevel(rl) {
                 qs.timezone = p.timezone;
             if (p.userId)
                 qs.userId = p.userId;
-            return api(token, "GET", `/calendars/${p.calendarId}/free-slots`, undefined, qs);
+            return api(ctx, "GET", `calendars/${pathSegment(p.calendarId)}/free-slots`, undefined, qs);
         },
     });
 }

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

@@ -0,0 +1,27 @@
+import { configFlag, httpsBase, staticCredential, } from "../../_shared/credentials.js";
+/**
+ * A long-lived access token, sent as a bearer to the instance's own /api/
+ * base. The target carries the scheme `ssl` selects, and config-derived
+ * hosts are HTTPS-only: httpsBase refuses the plain-http base that
+ * `ssl: false` (the default) selects, as invalid_credentials.
+ */
+export const homeAssistantCredential = staticCredential({
+    id: "homeAssistant",
+    auth: { kind: "bearer" },
+    local: { secret: "accessToken" },
+    targets: (config) => {
+        const scheme = configFlag(config.ssl) ? "https" : "http";
+        return {
+            api: {
+                baseUrl: httpsBase(`${scheme}://${String(config.host)}:${config.port ?? 8123}`, "api/"),
+                methods: ["GET", "POST"],
+            },
+        };
+    },
+    probe: {
+        target: "api",
+        path: "config",
+        method: "GET",
+        acceptedStatuses: [200],
+    },
+});