runline 0.32.0 → 0.34.0

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

@@ -1,38 +1,19 @@
-function getConn(ctx) {
-    const c = ctx.connection.config;
-    return {
-        subdomain: c.subdomain,
-        email: c.email,
-        apiToken: c.apiToken,
-    };
-}
-async function api(conn, method, endpoint, body, qs) {
-    const url = new URL(`https://${conn.subdomain}.zendesk.com/api/v2${endpoint}.json`);
-    if (qs) {
-        for (const [k, v] of Object.entries(qs)) {
-            if (v !== undefined && v !== null)
-                url.searchParams.set(k, String(v));
-        }
-    }
-    const init = {
+import { credentialJson, pathSegment } from "../../_shared/credentials.js";
+import { zendeskCredential } from "./credentials.js";
+/** One Zendesk call: every endpoint is a .json path beneath /api/v2/. */
+function api(ctx, method, endpoint, body, qs) {
+    return credentialJson(ctx, zendeskCredential, "zendesk", {
+        target: "api",
+        path: `${endpoint}.json`,
         method,
-        headers: {
-            Authorization: `Basic ${btoa(`${conn.email}/token:${conn.apiToken}`)}`,
-            "Content-Type": "application/json",
-        },
-    };
-    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(`Zendesk error ${res.status}: ${await res.text()}`);
-    if (res.status === 204)
-        return { success: true };
-    return res.json();
+        query: qs,
+        ...(body && Object.keys(body).length > 0 ? { json: body } : {}),
+    });
 }
 export default function zendesk(rl) {
     rl.setName("zendesk");
     rl.setVersion("0.1.0");
+    rl.setCredential(zendeskCredential);
     rl.setConnectionSchema({
         subdomain: {
             type: "string",
@@ -83,7 +64,7 @@ export default function zendesk(rl) {
                 ticket.tags = p.tags;
             if (p.customFields)
                 ticket.custom_fields = p.customFields;
-            const data = (await api(getConn(ctx), "POST", "/tickets", {
+            const data = (await api(ctx, "POST", "tickets", {
                 ticket,
             }));
             return data.ticket;
@@ -94,7 +75,7 @@ export default function zendesk(rl) {
         description: "Get a ticket",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            const data = (await api(getConn(ctx), "GET", `/tickets/${input.id}`));
+            const data = (await api(ctx, "GET", `tickets/${pathSegment(input.id)}`));
             return data.ticket;
         },
     });
@@ -120,7 +101,7 @@ export default function zendesk(rl) {
             const qs = { query: q };
             if (p.limit)
                 qs.per_page = p.limit;
-            const data = (await api(getConn(ctx), "GET", "/search", undefined, qs));
+            const data = (await api(ctx, "GET", "search", undefined, qs));
             return data.results;
         },
     });
@@ -137,7 +118,7 @@ export default function zendesk(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            const data = (await api(getConn(ctx), "PUT", `/tickets/${p.id}`, {
+            const data = (await api(ctx, "PUT", `tickets/${pathSegment(p.id)}`, {
                 ticket: p.data,
             }));
             return data.ticket;
@@ -148,7 +129,7 @@ export default function zendesk(rl) {
         description: "Delete a ticket",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            await api(getConn(ctx), "DELETE", `/tickets/${input.id}`);
+            await api(ctx, "DELETE", `tickets/${pathSegment(input.id)}`);
             return { success: true };
         },
     });
@@ -162,7 +143,7 @@ export default function zendesk(rl) {
             role: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            const data = (await api(getConn(ctx), "POST", "/users", {
+            const data = (await api(ctx, "POST", "users", {
                 user: input,
             }));
             return data.user;
@@ -173,7 +154,7 @@ export default function zendesk(rl) {
         description: "Get a user",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            const data = (await api(getConn(ctx), "GET", `/users/${input.id}`));
+            const data = (await api(ctx, "GET", `users/${pathSegment(input.id)}`));
             return data.user;
         },
     });
@@ -185,7 +166,7 @@ export default function zendesk(rl) {
             const qs = {};
             if (input?.limit)
                 qs.per_page = input.limit;
-            const data = (await api(getConn(ctx), "GET", "/users", undefined, qs));
+            const data = (await api(ctx, "GET", "users", undefined, qs));
             return data.users;
         },
     });
@@ -198,7 +179,7 @@ export default function zendesk(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            const data = (await api(getConn(ctx), "PUT", `/users/${p.id}`, {
+            const data = (await api(ctx, "PUT", `users/${pathSegment(p.id)}`, {
                 user: p.data,
             }));
             return data.user;
@@ -209,7 +190,7 @@ export default function zendesk(rl) {
         description: "Delete a user",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            const data = (await api(getConn(ctx), "DELETE", `/users/${input.id}`));
+            const data = (await api(ctx, "DELETE", `users/${pathSegment(input.id)}`));
             return data.user;
         },
     });
@@ -225,7 +206,7 @@ export default function zendesk(rl) {
             const qs = { query: p.query };
             if (p.limit)
                 qs.per_page = p.limit;
-            const data = (await api(getConn(ctx), "GET", "/users/search", undefined, qs));
+            const data = (await api(ctx, "GET", "users/search", undefined, qs));
             return data.users;
         },
     });
@@ -235,7 +216,7 @@ export default function zendesk(rl) {
         description: "Create an organization",
         inputSchema: { name: { type: "string", required: true } },
         async execute(input, ctx) {
-            const data = (await api(getConn(ctx), "POST", "/organizations", {
+            const data = (await api(ctx, "POST", "organizations", {
                 organization: input,
             }));
             return data.organization;
@@ -246,7 +227,7 @@ export default function zendesk(rl) {
         description: "Get an organization",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            const data = (await api(getConn(ctx), "GET", `/organizations/${input.id}`));
+            const data = (await api(ctx, "GET", `organizations/${pathSegment(input.id)}`));
             return data.organization;
         },
     });
@@ -258,7 +239,7 @@ export default function zendesk(rl) {
             const qs = {};
             if (input?.limit)
                 qs.per_page = input.limit;
-            const data = (await api(getConn(ctx), "GET", "/organizations", undefined, qs));
+            const data = (await api(ctx, "GET", "organizations", undefined, qs));
             return data.organizations;
         },
     });
@@ -271,7 +252,7 @@ export default function zendesk(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            const data = (await api(getConn(ctx), "PUT", `/organizations/${p.id}`, {
+            const data = (await api(ctx, "PUT", `organizations/${pathSegment(p.id)}`, {
                 organization: p.data,
             }));
             return data.organization;
@@ -282,7 +263,7 @@ export default function zendesk(rl) {
         description: "Delete an organization",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            await api(getConn(ctx), "DELETE", `/organizations/${input.id}`);
+            await api(ctx, "DELETE", `organizations/${pathSegment(input.id)}`);
             return { success: true };
         },
     });
@@ -292,7 +273,7 @@ export default function zendesk(rl) {
         description: "Get a ticket field",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            const data = (await api(getConn(ctx), "GET", `/ticket_fields/${input.id}`));
+            const data = (await api(ctx, "GET", `ticket_fields/${pathSegment(input.id)}`));
             return data.ticket_field;
         },
     });
@@ -301,7 +282,7 @@ export default function zendesk(rl) {
         description: "List ticket fields",
         inputSchema: {},
         async execute(_input, ctx) {
-            const data = (await api(getConn(ctx), "GET", "/ticket_fields"));
+            const data = (await api(ctx, "GET", "ticket_fields"));
             return data.ticket_fields;
         },
     });

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

@@ -0,0 +1,17 @@
+import { httpsBase, staticCredential } from "../../_shared/credentials.js";
+/**
+ * An OAuth2 access token, sent as `Authorization: Zoho-oauthtoken …` to the
+ * CRM API on the connection's data-center domain.
+ */
+export const zohoCredential = staticCredential({
+    id: "zoho",
+    auth: { kind: "apiKey", header: "Authorization", prefix: "Zoho-oauthtoken " },
+    local: { secret: "accessToken" },
+    targets: (config) => ({
+        api: {
+            baseUrl: httpsBase((typeof config.apiDomain === "string" && config.apiDomain) ||
+                "https://www.zohoapis.com", "crm/v2/"),
+            methods: ["GET", "POST", "PUT", "DELETE"],
+        },
+    }),
+});

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

@@ -1,33 +1,13 @@
-function getConn(ctx) {
-    const c = ctx.connection.config;
-    return {
-        accessToken: c.accessToken,
-        apiDomain: (c.apiDomain || "https://www.zohoapis.com").replace(/\/$/, ""),
-    };
-}
-async function api(conn, method, endpoint, body, qs) {
-    const url = new URL(`${conn.apiDomain}/crm/v2${endpoint}`);
-    if (qs) {
-        for (const [k, v] of Object.entries(qs)) {
-            if (v !== undefined && v !== null)
-                url.searchParams.set(k, String(v));
-        }
-    }
-    const init = {
+import { credentialJson, pathSegment } from "../../_shared/credentials.js";
+import { zohoCredential } from "./credentials.js";
+function api(ctx, method, endpoint, body, qs) {
+    return credentialJson(ctx, zohoCredential, "zoho", {
+        target: "api",
+        path: endpoint,
         method,
-        headers: {
-            Authorization: `Zoho-oauthtoken ${conn.accessToken}`,
-            "Content-Type": "application/json",
-        },
-    };
-    if (body && Object.keys(body).length > 0)
-        init.body = JSON.stringify({ data: [body] });
-    const res = await fetch(url.toString(), init);
-    if (!res.ok)
-        throw new Error(`Zoho CRM error ${res.status}: ${await res.text()}`);
-    if (res.status === 204)
-        return { success: true };
-    return res.json();
+        query: qs,
+        ...(body && Object.keys(body).length > 0 ? { json: { data: [body] } } : {}),
+    });
 }
 const MODULES = {
     account: "Accounts",
@@ -41,7 +21,7 @@ const MODULES = {
     vendor: "Vendors",
     quote: "Quotes",
 };
-function registerCrmResource(rl, resource, conn) {
+function registerCrmResource(rl, resource) {
     const mod = MODULES[resource];
     rl.registerAction(`${resource}.create`, {
         access: "write",
@@ -50,7 +30,7 @@ function registerCrmResource(rl, resource, conn) {
             data: { type: "object", required: true, description: "Record fields" },
         },
         async execute(input, ctx) {
-            const data = (await api(conn(ctx), "POST", `/${mod}`, input.data));
+            const data = (await api(ctx, "POST", `${mod}`, input.data));
             return data.data;
         },
     });
@@ -59,7 +39,7 @@ function registerCrmResource(rl, resource, conn) {
         description: `Get a ${resource} by ID`,
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            const data = (await api(conn(ctx), "GET", `/${mod}/${input.id}`));
+            const data = (await api(ctx, "GET", `${mod}/${pathSegment(input.id)}`));
             return data.data;
         },
     });
@@ -81,7 +61,7 @@ function registerCrmResource(rl, resource, conn) {
                 qs.per_page = p.limit;
             if (p.fields)
                 qs.fields = p.fields;
-            const data = (await api(conn(ctx), "GET", `/${mod}`, undefined, qs));
+            const data = (await api(ctx, "GET", `${mod}`, undefined, qs));
             return data.data ?? [];
         },
     });
@@ -95,7 +75,7 @@ function registerCrmResource(rl, resource, conn) {
         async execute(input, ctx) {
             const p = input;
             const body = { ...p.data, id: p.id };
-            const data = (await api(conn(ctx), "PUT", `/${mod}`, body));
+            const data = (await api(ctx, "PUT", `${mod}`, body));
             return data.data;
         },
     });
@@ -104,7 +84,7 @@ function registerCrmResource(rl, resource, conn) {
         description: `Delete a ${resource}`,
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            const data = (await api(conn(ctx), "DELETE", `/${mod}`, undefined, {
+            const data = (await api(ctx, "DELETE", `${mod}`, undefined, {
                 ids: input.id,
             }));
             return data.data;
@@ -124,13 +104,12 @@ function registerCrmResource(rl, resource, conn) {
         async execute(input, ctx) {
             const p = input;
             const body = p.data;
-            const qs = {};
             if (p.duplicateCheckFields) {
                 body.duplicate_check_fields = p.duplicateCheckFields
                     .split(",")
                     .map((f) => f.trim());
             }
-            const data = (await api(conn(ctx), "POST", `/${mod}/upsert`, body));
+            const data = (await api(ctx, "POST", `${mod}/upsert`, body));
             return data.data;
         },
     });
@@ -138,6 +117,7 @@ function registerCrmResource(rl, resource, conn) {
 export default function zoho(rl) {
     rl.setName("zoho");
     rl.setVersion("0.1.0");
+    rl.setCredential(zohoCredential);
     rl.setConnectionSchema({
         accessToken: {
             type: "string",
@@ -153,6 +133,6 @@ export default function zoho(rl) {
         },
     });
     for (const resource of Object.keys(MODULES)) {
-        registerCrmResource(rl, resource, getConn);
+        registerCrmResource(rl, resource);
     }
 }

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

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

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

@@ -1,32 +1,18 @@
-const BASE = "https://api.zoom.us/v2";
-async function apiRequest(token, method, endpoint, body, qs) {
-    const url = new URL(`${BASE}${endpoint}`);
-    if (qs) {
-        for (const [k, v] of Object.entries(qs)) {
-            if (v !== undefined && v !== null)
-                url.searchParams.set(k, String(v));
-        }
-    }
-    const init = {
+import { credentialJson, pathSegment } from "../../_shared/credentials.js";
+import { zoomCredential } from "./credentials.js";
+async function apiRequest(ctx, method, path, body, qs) {
+    return credentialJson(ctx, zoomCredential, "zoom", {
+        target: "api",
+        path,
         method,
-        headers: {
-            Authorization: `Bearer ${token}`,
-            "Content-Type": "application/json",
-        },
-    };
-    if (body && Object.keys(body).length > 0)
-        init.body = JSON.stringify(body);
-    const res = await fetch(url.toString(), init);
-    if (res.status === 204)
-        return { success: true };
-    if (!res.ok)
-        throw new Error(`Zoom error ${res.status}: ${await res.text()}`);
-    const text = await res.text();
-    return text ? JSON.parse(text) : { success: true };
+        query: qs,
+        ...(body && Object.keys(body).length > 0 ? { json: body } : {}),
+    });
 }
 export default function zoom(rl) {
     rl.setName("zoom");
     rl.setVersion("0.1.0");
+    rl.setCredential(zoomCredential);
     rl.setConnectionSchema({
         accessToken: {
             type: "string",
@@ -35,7 +21,6 @@ export default function zoom(rl) {
             env: "ZOOM_ACCESS_TOKEN",
         },
     });
-    const key = (ctx) => ctx.connection.config.accessToken;
     rl.registerAction("meeting.create", {
         access: "write",
         description: "Create a Zoom meeting",
@@ -82,7 +67,7 @@ export default function zoom(rl) {
                 body.agenda = p.agenda;
             if (p.settings)
                 body.settings = p.settings;
-            return apiRequest(key(ctx), "POST", "/users/me/meetings", body);
+            return apiRequest(ctx, "POST", "users/me/meetings", body);
         },
     });
     rl.registerAction("meeting.get", {
@@ -90,7 +75,7 @@ export default function zoom(rl) {
         description: "Get a meeting by ID",
         inputSchema: { meetingId: { type: "string", required: true } },
         async execute(input, ctx) {
-            return apiRequest(key(ctx), "GET", `/meetings/${input.meetingId}`);
+            return apiRequest(ctx, "GET", `meetings/${pathSegment(input.meetingId)}`);
         },
     });
     rl.registerAction("meeting.list", {
@@ -111,7 +96,7 @@ export default function zoom(rl) {
                 qs.page_size = p.limit;
             if (p.type)
                 qs.type = p.type;
-            const data = (await apiRequest(key(ctx), "GET", "/users/me/meetings", undefined, qs));
+            const data = (await apiRequest(ctx, "GET", "users/me/meetings", undefined, qs));
             return data.meetings;
         },
     });
@@ -145,7 +130,7 @@ export default function zoom(rl) {
                 body.agenda = fields.agenda;
             if (fields.settings)
                 body.settings = fields.settings;
-            await apiRequest(key(ctx), "PATCH", `/meetings/${meetingId}`, body);
+            await apiRequest(ctx, "PATCH", `meetings/${pathSegment(meetingId)}`, body);
             return { success: true };
         },
     });
@@ -154,7 +139,7 @@ export default function zoom(rl) {
         description: "Delete a meeting",
         inputSchema: { meetingId: { type: "string", required: true } },
         async execute(input, ctx) {
-            await apiRequest(key(ctx), "DELETE", `/meetings/${input.meetingId}`);
+            await apiRequest(ctx, "DELETE", `meetings/${pathSegment(input.meetingId)}`);
             return { success: true };
         },
     });

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

@@ -0,0 +1,16 @@
+import { httpsBase, staticCredential } from "../../_shared/credentials.js";
+/**
+ * The bot's email and API key as a Basic pair, beneath the connection's
+ * own Zulip server. The server must be HTTPS.
+ */
+export const zulipCredential = staticCredential({
+    id: "zulip",
+    auth: { kind: "basic" },
+    local: { username: "email", password: "apiKey" },
+    targets: (config) => ({
+        api: {
+            baseUrl: httpsBase(config.url, "api/v1/"),
+            methods: ["GET", "POST", "PATCH", "DELETE"],
+        },
+    }),
+});