runline 0.33.0 → 0.35.0

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

@@ -1,43 +1,24 @@
-function buildBaseUrl(subdomain) {
-    return `https://api.bamboohr.com/api/gateway.php/${subdomain}/v1`;
-}
-async function apiRequest(subdomain, apiKey, method, endpoint, body) {
-    const url = `${buildBaseUrl(subdomain)}/${endpoint}`;
-    const opts = {
+import { credentialOk, jsonAnswer, jsonOrAcknowledged, pathSegment, } from "../../_shared/credentials.js";
+import { bambooHrCredential } from "./credentials.js";
+async function apiRequest(ctx, method, path, body, query) {
+    const res = await credentialOk(ctx, bambooHrCredential, "bambooHr", {
+        target: "api",
+        path,
         method,
-        headers: {
-            "Content-Type": "application/json",
-            Accept: "application/json",
-            Authorization: `Basic ${btoa(`${apiKey}:x`)}`,
-        },
-    };
-    if (body &&
-        Object.keys(body).length > 0 &&
-        method !== "GET" &&
-        method !== "DELETE") {
-        opts.body = JSON.stringify(body);
-    }
-    const res = await fetch(url, opts);
-    if (!res.ok) {
-        const text = await res.text();
-        throw new Error(`BambooHR API error ${res.status}: ${text}`);
-    }
-    if (res.status === 204 || res.headers.get("content-length") === "0")
-        return { success: true };
-    const contentType = res.headers.get("content-type") ?? "";
-    if (contentType.includes("application/json"))
-        return res.json();
-    return { success: true };
-}
-function getConn(ctx) {
-    return {
-        subdomain: ctx.connection.config.subdomain,
-        apiKey: ctx.connection.config.apiKey,
-    };
+        query,
+        ...(body &&
+            Object.keys(body).length > 0 &&
+            method !== "GET" &&
+            method !== "DELETE"
+            ? { json: body }
+            : {}),
+    });
+    return jsonOrAcknowledged(res);
 }
 export default function bambooHr(rl) {
     rl.setName("bambooHr");
     rl.setVersion("0.1.0");
+    rl.setCredential(bambooHrCredential);
     rl.setConnectionSchema({
         subdomain: {
             type: "string",
@@ -93,19 +74,13 @@ export default function bambooHr(rl) {
             },
         },
         async execute(input, ctx) {
-            const { subdomain, apiKey } = getConn(ctx);
             const body = input;
-            const res = await fetch(`${buildBaseUrl(subdomain)}/employees`, {
+            const res = await credentialOk(ctx, bambooHrCredential, "bambooHr", {
+                target: "api",
+                path: "employees",
                 method: "POST",
-                headers: {
-                    "Content-Type": "application/json",
-                    Accept: "application/json",
-                    Authorization: `Basic ${btoa(`${apiKey}:x`)}`,
-                },
-                body: JSON.stringify(body),
+                json: body,
             });
-            if (!res.ok)
-                throw new Error(`BambooHR error ${res.status}: ${await res.text()}`);
             const location = res.headers.get("location") ?? "";
             const employeeId = location.split("/").pop();
             return { id: employeeId };
@@ -128,14 +103,15 @@ export default function bambooHr(rl) {
         },
         async execute(input, ctx) {
             const { employeeId, fields } = input;
-            const { subdomain, apiKey } = getConn(ctx);
             let fieldList = fields ?? "all";
             if (fieldList === "all") {
-                const dir = (await apiRequest(subdomain, apiKey, "GET", "employees/directory"));
+                const dir = (await apiRequest(ctx, "GET", "employees/directory"));
                 const dirFields = dir.fields ?? [];
                 fieldList = dirFields.map((f) => f.id).join(",");
             }
-            return apiRequest(subdomain, apiKey, "GET", `employees/${employeeId}?fields=${fieldList}`);
+            return apiRequest(ctx, "GET", `employees/${pathSegment(employeeId)}`, undefined, {
+                fields: fieldList,
+            });
         },
     });
     rl.registerAction("employee.list", {
@@ -150,8 +126,7 @@ export default function bambooHr(rl) {
         },
         async execute(input, ctx) {
             const { limit } = (input ?? {});
-            const { subdomain, apiKey } = getConn(ctx);
-            const data = (await apiRequest(subdomain, apiKey, "GET", "employees/directory"));
+            const data = (await apiRequest(ctx, "GET", "employees/directory"));
             const employees = data.employees ?? [];
             if (limit)
                 return employees.slice(0, limit);
@@ -190,8 +165,7 @@ export default function bambooHr(rl) {
         },
         async execute(input, ctx) {
             const { employeeId, ...fields } = input;
-            const { subdomain, apiKey } = getConn(ctx);
-            await apiRequest(subdomain, apiKey, "POST", `employees/${employeeId}`, fields);
+            await apiRequest(ctx, "POST", `employees/${pathSegment(employeeId)}`, fields);
             return { success: true };
         },
     });
@@ -213,8 +187,7 @@ export default function bambooHr(rl) {
         },
         async execute(input, ctx) {
             const { employeeId, limit } = input;
-            const { subdomain, apiKey } = getConn(ctx);
-            const data = (await apiRequest(subdomain, apiKey, "GET", `employees/${employeeId}/files/view/`));
+            const data = (await apiRequest(ctx, "GET", `employees/${pathSegment(employeeId)}/files/view/`));
             const categories = data.categories ?? [];
             // Flatten files from all categories
             const files = [];
@@ -240,8 +213,7 @@ export default function bambooHr(rl) {
         },
         async execute(input, ctx) {
             const { employeeId, fileId } = input;
-            const { subdomain, apiKey } = getConn(ctx);
-            await apiRequest(subdomain, apiKey, "DELETE", `employees/${employeeId}/files/${fileId}`);
+            await apiRequest(ctx, "DELETE", `employees/${pathSegment(employeeId)}/files/${pathSegment(fileId)}`);
             return { success: true };
         },
     });
@@ -263,10 +235,9 @@ export default function bambooHr(rl) {
         },
         async execute(input, ctx) {
             const { employeeId, fileId, shareWithEmployee } = input;
-            const { subdomain, apiKey } = getConn(ctx);
             const body = {};
             body.shareWithEmployee = shareWithEmployee ? "yes" : "no";
-            await apiRequest(subdomain, apiKey, "POST", `employees/${employeeId}/files/${fileId}`, body);
+            await apiRequest(ctx, "POST", `employees/${pathSegment(employeeId)}/files/${pathSegment(fileId)}`, body);
             return { success: true };
         },
     });
@@ -283,8 +254,7 @@ export default function bambooHr(rl) {
         },
         async execute(input, ctx) {
             const { limit } = (input ?? {});
-            const { subdomain, apiKey } = getConn(ctx);
-            const data = (await apiRequest(subdomain, apiKey, "GET", "files/view"));
+            const data = (await apiRequest(ctx, "GET", "files/view"));
             const categories = data.categories ?? [];
             const files = [];
             for (const cat of categories) {
@@ -304,8 +274,7 @@ export default function bambooHr(rl) {
         },
         async execute(input, ctx) {
             const { fileId } = input;
-            const { subdomain, apiKey } = getConn(ctx);
-            await apiRequest(subdomain, apiKey, "DELETE", `files/${fileId}`);
+            await apiRequest(ctx, "DELETE", `files/${pathSegment(fileId)}`);
             return { success: true };
         },
     });
@@ -322,8 +291,7 @@ export default function bambooHr(rl) {
         },
         async execute(input, ctx) {
             const { fileId, shareWithEmployee } = input;
-            const { subdomain, apiKey } = getConn(ctx);
-            await apiRequest(subdomain, apiKey, "POST", `files/${fileId}`, {
+            await apiRequest(ctx, "POST", `files/${pathSegment(fileId)}`, {
                 shareWithEmployee: shareWithEmployee ? "yes" : "no",
             });
             return { success: true };
@@ -338,13 +306,19 @@ export default function bambooHr(rl) {
             format: {
                 type: "string",
                 required: false,
-                description: "Format: JSON, CSV, XLS, XML, PDF (default: JSON)",
+                description: "Format: JSON (default, parsed), CSV or XML (returned as text)",
             },
         },
         async execute(input, ctx) {
             const { reportId, format = "JSON" } = input;
-            const { subdomain, apiKey } = getConn(ctx);
-            return apiRequest(subdomain, apiKey, "GET", `reports/${reportId}/?format=${format}&fd=true&onlyCurrent=true`);
+            if (!["JSON", "CSV", "XML"].includes(format))
+                throw new Error("bambooHr: format must be JSON, CSV, or XML");
+            const res = await credentialOk(ctx, bambooHrCredential, "bambooHr", {
+                target: "api",
+                path: `reports/${pathSegment(reportId)}/`,
+                query: { format, fd: "true", onlyCurrent: "true" },
+            });
+            return format === "JSON" ? jsonAnswer(res) : res.text();
         },
     });
 }

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

@@ -0,0 +1,19 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/** A project API key, sent as a bearer to Bannerbear's one API origin. */
+export const bannerbearCredential = staticCredential({
+    id: "bannerbear",
+    auth: { kind: "bearer" },
+    local: { secret: "apiKey" },
+    targets: {
+        api: {
+            baseUrl: "https://api.bannerbear.com/v2/",
+            methods: ["GET", "POST"],
+        },
+    },
+    probe: {
+        target: "api",
+        path: "account",
+        method: "GET",
+        acceptedStatuses: [200],
+    },
+});

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

@@ -1,29 +1,18 @@
-const BASE_URL = "https://api.bannerbear.com/v2";
-async function apiRequest(apiKey, method, endpoint, body) {
-    const opts = {
+import { credentialJson, pathSegment } from "../../_shared/credentials.js";
+import { bannerbearCredential } from "./credentials.js";
+function apiRequest(ctx, method, path, body) {
+    const json = body && Object.keys(body).length > 0 && method !== "GET" ? body : undefined;
+    return credentialJson(ctx, bannerbearCredential, "bannerbear", {
+        target: "api",
+        path,
         method,
-        headers: {
-            "Content-Type": "application/json",
-            Accept: "application/json",
-            Authorization: `Bearer ${apiKey}`,
-        },
-    };
-    if (body && Object.keys(body).length > 0 && method !== "GET") {
-        opts.body = JSON.stringify(body);
-    }
-    const res = await fetch(`${BASE_URL}${endpoint}`, opts);
-    if (!res.ok) {
-        const text = await res.text();
-        throw new Error(`Bannerbear API error ${res.status}: ${text}`);
-    }
-    return res.json();
-}
-function getKey(ctx) {
-    return ctx.connection.config.apiKey;
+        ...(json !== undefined ? { json } : {}),
+    });
 }
 export default function bannerbear(rl) {
     rl.setName("bannerbear");
     rl.setVersion("0.1.0");
+    rl.setCredential(bannerbearCredential);
     rl.setConnectionSchema({
         apiKey: {
             type: "string",
@@ -70,7 +59,6 @@ export default function bannerbear(rl) {
         },
         async execute(input, ctx) {
             const { templateId, modifications, webhookUrl, metadata, waitForImage, maxTries = 3, } = (input ?? {});
-            const apiKey = getKey(ctx);
             const body = { template: templateId };
             if (modifications)
                 body.modifications = modifications;
@@ -78,12 +66,12 @@ export default function bannerbear(rl) {
                 body.webhook_url = webhookUrl;
             if (metadata)
                 body.metadata = metadata;
-            let result = (await apiRequest(apiKey, "POST", "/images", body));
+            let result = (await apiRequest(ctx, "POST", "images", body));
             if (waitForImage && result.status !== "completed") {
                 let tries = maxTries;
                 while (tries > 0) {
                     await new Promise((r) => setTimeout(r, 2000));
-                    result = (await apiRequest(apiKey, "GET", `/images/${result.uid}`));
+                    result = (await apiRequest(ctx, "GET", `images/${pathSegment(result.uid)}`));
                     if (result.status === "completed")
                         break;
                     tries--;
@@ -103,7 +91,7 @@ export default function bannerbear(rl) {
         },
         async execute(input, ctx) {
             const { imageId } = input;
-            return apiRequest(getKey(ctx), "GET", `/images/${imageId}`);
+            return apiRequest(ctx, "GET", `images/${pathSegment(imageId)}`);
         },
     });
     // ── Template ────────────────────────────────────────
@@ -119,14 +107,14 @@ export default function bannerbear(rl) {
         },
         async execute(input, ctx) {
             const { templateId } = input;
-            return apiRequest(getKey(ctx), "GET", `/templates/${templateId}`);
+            return apiRequest(ctx, "GET", `templates/${pathSegment(templateId)}`);
         },
     });
     rl.registerAction("template.list", {
         access: "read",
         description: "List all templates",
         async execute(_input, ctx) {
-            return apiRequest(getKey(ctx), "GET", "/templates");
+            return apiRequest(ctx, "GET", "templates");
         },
     });
 }

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

@@ -0,0 +1,17 @@
+import { httpsBase, staticCredential } from "../../_shared/credentials.js";
+/**
+ * A database token, sent as `Authorization: Token {token}` to the
+ * configured host's /api/ base — Baserow's cloud unless the connection
+ * names a self-hosted one, which must be HTTPS.
+ */
+export const baserowCredential = staticCredential({
+    id: "baserow",
+    auth: { kind: "apiKey", header: "Authorization", prefix: "Token " },
+    local: { secret: "token" },
+    targets: (config) => ({
+        api: {
+            baseUrl: httpsBase(config.host ?? "https://api.baserow.io", "api/"),
+            methods: ["GET", "POST", "PATCH", "DELETE"],
+        },
+    }),
+});

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

@@ -1,36 +1,21 @@
-async function apiRequest(host, token, method, endpoint, body, qs) {
-    const url = new URL(`${host}${endpoint}`);
-    if (qs) {
-        for (const [k, v] of Object.entries(qs)) {
-            if (v !== undefined)
-                url.searchParams.set(k, String(v));
-        }
-    }
-    const opts = {
+import { credentialJson, pathSegment } from "../../_shared/credentials.js";
+import { baserowCredential } from "./credentials.js";
+/** A path beneath the host's /api/ base, signed through the credential. */
+function apiRequest(ctx, method, path, body, query) {
+    return credentialJson(ctx, baserowCredential, "baserow", {
+        target: "api",
+        path,
         method,
-        headers: {
-            "Content-Type": "application/json",
-            Authorization: `Token ${token}`,
-        },
-    };
-    if (body && method !== "GET" && method !== "DELETE") {
-        opts.body = JSON.stringify(body);
-    }
-    const res = await fetch(url.toString(), opts);
-    if (!res.ok) {
-        const text = await res.text();
-        throw new Error(`Baserow API error ${res.status}: ${text}`);
-    }
-    if (res.status === 204)
-        return { success: true };
-    return res.json();
+        query,
+        ...(body && method !== "GET" && method !== "DELETE" ? { json: body } : {}),
+    });
 }
-async function paginateAll(host, token, endpoint, qs, limit) {
+async function paginateAll(ctx, path, qs, limit) {
     const results = [];
     let page = 1;
     const size = 100;
     while (true) {
-        const data = (await apiRequest(host, token, "GET", endpoint, undefined, {
+        const data = (await apiRequest(ctx, "GET", path, undefined, {
             ...qs,
             page,
             size,
@@ -44,15 +29,10 @@ async function paginateAll(host, token, endpoint, qs, limit) {
     }
     return results;
 }
-function getConn(ctx) {
-    return {
-        host: ctx.connection.config.host.replace(/\/$/, ""),
-        token: ctx.connection.config.token,
-    };
-}
 export default function baserow(rl) {
     rl.setName("baserow");
     rl.setVersion("0.1.0");
+    rl.setCredential(baserowCredential);
     rl.setConnectionSchema({
         host: {
             type: "string",
@@ -82,8 +62,7 @@ export default function baserow(rl) {
         },
         async execute(input, ctx) {
             const { tableId, fields } = input;
-            const { host, token } = getConn(ctx);
-            return apiRequest(host, token, "POST", `/api/database/rows/table/${tableId}/`, fields);
+            return apiRequest(ctx, "POST", `database/rows/table/${pathSegment(tableId)}/`, fields);
         },
     });
     rl.registerAction("row.get", {
@@ -95,8 +74,7 @@ export default function baserow(rl) {
         },
         async execute(input, ctx) {
             const { tableId, rowId } = input;
-            const { host, token } = getConn(ctx);
-            return apiRequest(host, token, "GET", `/api/database/rows/table/${tableId}/${rowId}/`);
+            return apiRequest(ctx, "GET", `database/rows/table/${pathSegment(tableId)}/${pathSegment(rowId)}/`);
         },
     });
     rl.registerAction("row.list", {
@@ -118,13 +96,12 @@ export default function baserow(rl) {
         },
         async execute(input, ctx) {
             const { tableId, search, orderBy, limit } = input;
-            const { host, token } = getConn(ctx);
             const qs = {};
             if (search)
                 qs.search = search;
             if (orderBy)
                 qs.order_by = orderBy;
-            return paginateAll(host, token, `/api/database/rows/table/${tableId}/`, qs, limit);
+            return paginateAll(ctx, `database/rows/table/${pathSegment(tableId)}/`, qs, limit);
         },
     });
     rl.registerAction("row.update", {
@@ -141,8 +118,7 @@ export default function baserow(rl) {
         },
         async execute(input, ctx) {
             const { tableId, rowId, fields } = input;
-            const { host, token } = getConn(ctx);
-            return apiRequest(host, token, "PATCH", `/api/database/rows/table/${tableId}/${rowId}/`, fields);
+            return apiRequest(ctx, "PATCH", `database/rows/table/${pathSegment(tableId)}/${pathSegment(rowId)}/`, fields);
         },
     });
     rl.registerAction("row.delete", {
@@ -154,8 +130,7 @@ export default function baserow(rl) {
         },
         async execute(input, ctx) {
             const { tableId, rowId } = input;
-            const { host, token } = getConn(ctx);
-            await apiRequest(host, token, "DELETE", `/api/database/rows/table/${tableId}/${rowId}/`);
+            await apiRequest(ctx, "DELETE", `database/rows/table/${pathSegment(tableId)}/${pathSegment(rowId)}/`);
             return { success: true };
         },
     });
@@ -172,8 +147,9 @@ export default function baserow(rl) {
         },
         async execute(input, ctx) {
             const { tableId, items } = input;
-            const { host, token } = getConn(ctx);
-            return apiRequest(host, token, "POST", `/api/database/rows/table/${tableId}/batch/`, { items });
+            return apiRequest(ctx, "POST", `database/rows/table/${pathSegment(tableId)}/batch/`, {
+                items,
+            });
         },
     });
     rl.registerAction("row.batchUpdate", {
@@ -189,8 +165,7 @@ export default function baserow(rl) {
         },
         async execute(input, ctx) {
             const { tableId, items } = input;
-            const { host, token } = getConn(ctx);
-            return apiRequest(host, token, "PATCH", `/api/database/rows/table/${tableId}/batch/`, { items });
+            return apiRequest(ctx, "PATCH", `database/rows/table/${pathSegment(tableId)}/batch/`, { items });
         },
     });
     rl.registerAction("row.batchDelete", {
@@ -206,8 +181,7 @@ export default function baserow(rl) {
         },
         async execute(input, ctx) {
             const { tableId, rowIds } = input;
-            const { host, token } = getConn(ctx);
-            await apiRequest(host, token, "POST", `/api/database/rows/table/${tableId}/batch-delete/`, {
+            await apiRequest(ctx, "POST", `database/rows/table/${pathSegment(tableId)}/batch-delete/`, {
                 items: rowIds,
             });
             return { success: true, deleted: rowIds };

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

@@ -0,0 +1,19 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/** A personal API token, sent as the auth_token query parameter. */
+export const beeminderCredential = staticCredential({
+    id: "beeminder",
+    auth: { kind: "queryKey", param: "auth_token" },
+    local: { secret: "apiToken" },
+    targets: {
+        api: {
+            baseUrl: "https://www.beeminder.com/api/v1/",
+            methods: ["GET", "POST", "PUT", "DELETE"],
+        },
+    },
+    probe: {
+        target: "api",
+        path: "users/me.json",
+        method: "GET",
+        acceptedStatuses: [200],
+    },
+});