runline 0.32.0 → 0.34.0

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

@@ -1,37 +1,19 @@
-const BASE_URL = "https://api.convertkit.com/v3";
-async function apiRequest(apiSecret, method, endpoint, body, qs) {
-    const url = new URL(`${BASE_URL}${endpoint}`);
-    // GET requests use api_secret as query param
-    if (method === "GET" || method === "DELETE") {
-        url.searchParams.set("api_secret", apiSecret);
-    }
-    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 { convertkitCredential } from "./credentials.js";
+/** Every write carries a JSON body, the one the API secret travels in. */
+function apiRequest(ctx, method, path, body, query) {
+    return credentialJson(ctx, convertkitCredential, "convertkit", {
+        target: "api",
+        path,
         method,
-        headers: { "Content-Type": "application/json" },
-    };
-    if (method === "POST" || method === "PUT") {
-        const b = { api_secret: apiSecret, ...body };
-        opts.body = JSON.stringify(b);
-    }
-    const res = await fetch(url.toString(), opts);
-    if (!res.ok)
-        throw new Error(`ConvertKit API error ${res.status}: ${await res.text()}`);
-    if (res.status === 204)
-        return { success: true };
-    return res.json();
-}
-function getSecret(ctx) {
-    return ctx.connection.config.apiSecret;
+        query,
+        ...(method === "POST" || method === "PUT" ? { json: body ?? {} } : {}),
+    });
 }
 export default function convertkit(rl) {
     rl.setName("convertkit");
     rl.setVersion("0.1.0");
+    rl.setCredential(convertkitCredential);
     rl.setConnectionSchema({
         apiSecret: {
             type: "string",
@@ -49,7 +31,7 @@ export default function convertkit(rl) {
         },
         async execute(input, ctx) {
             const { label } = input;
-            return apiRequest(getSecret(ctx), "POST", "/custom_fields", { label });
+            return apiRequest(ctx, "POST", "custom_fields", { label });
         },
     });
     rl.registerAction("customField.get", {
@@ -59,7 +41,7 @@ export default function convertkit(rl) {
             id: { type: "string", required: true, description: "Field ID" },
         },
         async execute(input, ctx) {
-            return apiRequest(getSecret(ctx), "GET", `/custom_fields/${input.id}`);
+            return apiRequest(ctx, "GET", `custom_fields/${pathSegment(input.id)}`);
         },
     });
     rl.registerAction("customField.list", {
@@ -69,7 +51,7 @@ export default function convertkit(rl) {
             limit: { type: "number", required: false, description: "Max results" },
         },
         async execute(input, ctx) {
-            const data = (await apiRequest(getSecret(ctx), "GET", "/custom_fields"));
+            const data = (await apiRequest(ctx, "GET", "custom_fields"));
             const fields = data.custom_fields ?? [];
             const { limit } = (input ?? {});
             if (limit)
@@ -86,7 +68,7 @@ export default function convertkit(rl) {
         },
         async execute(input, ctx) {
             const { id, label } = input;
-            await apiRequest(getSecret(ctx), "PUT", `/custom_fields/${id}`, {
+            await apiRequest(ctx, "PUT", `custom_fields/${pathSegment(id)}`, {
                 label,
             });
             return { success: true };
@@ -99,7 +81,7 @@ export default function convertkit(rl) {
             id: { type: "string", required: true, description: "Field ID" },
         },
         async execute(input, ctx) {
-            return apiRequest(getSecret(ctx), "DELETE", `/custom_fields/${input.id}`);
+            return apiRequest(ctx, "DELETE", `custom_fields/${pathSegment(input.id)}`);
         },
     });
     // ── Form ────────────────────────────────────────────
@@ -130,7 +112,7 @@ export default function convertkit(rl) {
                 body.tags = tags;
             if (fields)
                 body.fields = fields;
-            const data = (await apiRequest(getSecret(ctx), "POST", `/forms/${formId}/subscribe`, body));
+            const data = (await apiRequest(ctx, "POST", `forms/${pathSegment(formId)}/subscribe`, body));
             return data.subscription;
         },
     });
@@ -141,7 +123,7 @@ export default function convertkit(rl) {
             limit: { type: "number", required: false, description: "Max results" },
         },
         async execute(input, ctx) {
-            const data = (await apiRequest(getSecret(ctx), "GET", "/forms"));
+            const data = (await apiRequest(ctx, "GET", "forms"));
             const forms = data.forms ?? [];
             const { limit } = (input ?? {});
             if (limit)
@@ -166,7 +148,7 @@ export default function convertkit(rl) {
             const qs = {};
             if (subscriberState)
                 qs.subscriber_state = subscriberState;
-            const data = (await apiRequest(getSecret(ctx), "GET", `/forms/${formId}/subscriptions`, undefined, qs));
+            const data = (await apiRequest(ctx, "GET", `forms/${pathSegment(formId)}/subscriptions`, undefined, qs));
             const subs = data.subscriptions ?? [];
             if (limit)
                 return subs.slice(0, limit);
@@ -201,7 +183,7 @@ export default function convertkit(rl) {
                 body.tags = tags;
             if (fields)
                 body.fields = fields;
-            const data = (await apiRequest(getSecret(ctx), "POST", `/sequences/${sequenceId}/subscribe`, body));
+            const data = (await apiRequest(ctx, "POST", `sequences/${pathSegment(sequenceId)}/subscribe`, body));
             return data.subscription;
         },
     });
@@ -212,7 +194,7 @@ export default function convertkit(rl) {
             limit: { type: "number", required: false, description: "Max results" },
         },
         async execute(input, ctx) {
-            const data = (await apiRequest(getSecret(ctx), "GET", "/sequences"));
+            const data = (await apiRequest(ctx, "GET", "sequences"));
             const courses = data.courses ?? [];
             const { limit } = (input ?? {});
             if (limit)
@@ -241,7 +223,7 @@ export default function convertkit(rl) {
             const qs = {};
             if (subscriberState)
                 qs.subscriber_state = subscriberState;
-            const data = (await apiRequest(getSecret(ctx), "GET", `/sequences/${sequenceId}/subscriptions`, undefined, qs));
+            const data = (await apiRequest(ctx, "GET", `sequences/${pathSegment(sequenceId)}/subscriptions`, undefined, qs));
             const subs = data.subscriptions ?? [];
             if (limit)
                 return subs.slice(0, limit);
@@ -262,7 +244,7 @@ export default function convertkit(rl) {
         async execute(input, ctx) {
             const { names } = input;
             const tag = names.split(",").map((n) => ({ name: n.trim() }));
-            return apiRequest(getSecret(ctx), "POST", "/tags", { tag });
+            return apiRequest(ctx, "POST", "tags", { tag });
         },
     });
     rl.registerAction("tag.list", {
@@ -272,7 +254,7 @@ export default function convertkit(rl) {
             limit: { type: "number", required: false, description: "Max results" },
         },
         async execute(input, ctx) {
-            const data = (await apiRequest(getSecret(ctx), "GET", "/tags"));
+            const data = (await apiRequest(ctx, "GET", "tags"));
             const tags = data.tags ?? [];
             const { limit } = (input ?? {});
             if (limit)
@@ -301,7 +283,7 @@ export default function convertkit(rl) {
                 body.first_name = firstName;
             if (fields)
                 body.fields = fields;
-            const data = (await apiRequest(getSecret(ctx), "POST", `/tags/${tagId}/subscribe`, body));
+            const data = (await apiRequest(ctx, "POST", `tags/${pathSegment(tagId)}/subscribe`, body));
             return data.subscription;
         },
     });
@@ -314,7 +296,7 @@ export default function convertkit(rl) {
         },
         async execute(input, ctx) {
             const { tagId, limit } = input;
-            const data = (await apiRequest(getSecret(ctx), "GET", `/tags/${tagId}/subscriptions`));
+            const data = (await apiRequest(ctx, "GET", `tags/${pathSegment(tagId)}/subscriptions`));
             const subs = data.subscriptions ?? [];
             if (limit)
                 return subs.slice(0, limit);
@@ -334,7 +316,7 @@ export default function convertkit(rl) {
         },
         async execute(input, ctx) {
             const { tagId, email } = input;
-            return apiRequest(getSecret(ctx), "POST", `/tags/${tagId}/unsubscribe`, {
+            return apiRequest(ctx, "POST", `tags/${pathSegment(tagId)}/unsubscribe`, {
                 email,
             });
         },

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

@@ -0,0 +1,17 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/**
+ * A user API key in the X-PW-AccessToken header. Its public companions —
+ * X-PW-Application and the user's X-PW-UserEmail — ride as allowed headers.
+ */
+export const copperCredential = staticCredential({
+    id: "copper",
+    auth: { kind: "apiKey", header: "X-PW-AccessToken" },
+    local: { secret: "apiKey" },
+    targets: {
+        api: {
+            baseUrl: "https://api.copper.com/developer_api/v1/",
+            methods: ["GET", "POST", "PUT", "DELETE"],
+            allowedHeaders: ["X-PW-Application", "X-PW-UserEmail"],
+        },
+    },
+});

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

@@ -1,33 +1,23 @@
-const BASE_URL = "https://api.copper.com/developer_api/v1";
-async function apiRequest(apiKey, email, method, endpoint, body) {
-    const opts = {
+import { credentialJson, pathSegment } from "../../_shared/credentials.js";
+import { copperCredential } from "./credentials.js";
+function apiRequest(ctx, method, path, body) {
+    return credentialJson(ctx, copperCredential, "copper", {
+        target: "api",
+        path,
         method,
         headers: {
-            "Content-Type": "application/json",
-            "X-PW-AccessToken": apiKey,
             "X-PW-Application": "developer_api",
-            "X-PW-UserEmail": email,
+            "X-PW-UserEmail": String(ctx.connection.config.email ?? ""),
         },
-    };
-    if (body && Object.keys(body).length > 0) {
-        opts.body = JSON.stringify(body);
-    }
-    const res = await fetch(`${BASE_URL}${endpoint}`, opts);
-    if (!res.ok)
-        throw new Error(`Copper API error ${res.status}: ${await res.text()}`);
-    if (res.status === 204)
-        return { success: true };
-    const ct = res.headers.get("content-type") ?? "";
-    if (ct.includes("application/json"))
-        return res.json();
-    return { success: true };
+        ...(body && Object.keys(body).length > 0 ? { json: body } : {}),
+    });
 }
-async function searchAll(apiKey, email, endpoint, body, limit) {
+async function searchAll(ctx, path, body, limit) {
     const results = [];
     let page = 1;
     const size = 200;
     while (true) {
-        const data = (await apiRequest(apiKey, email, "POST", endpoint, {
+        const data = (await apiRequest(ctx, "POST", path, {
             ...body,
             page_number: page,
             page_size: size,
@@ -43,12 +33,6 @@ async function searchAll(apiKey, email, endpoint, body, limit) {
     }
     return results;
 }
-function getConn(ctx) {
-    return {
-        apiKey: ctx.connection.config.apiKey,
-        email: ctx.connection.config.email,
-    };
-}
 function registerCrud(rl, resource, endpoint, idParam, nameRequired, extraCreateFields) {
     rl.registerAction(`${resource}.create`, {
         access: "write",
@@ -66,8 +50,7 @@ function registerCrud(rl, resource, endpoint, idParam, nameRequired, extraCreate
             ...extraCreateFields,
         },
         async execute(input, ctx) {
-            const { apiKey, email } = getConn(ctx);
-            return apiRequest(apiKey, email, "POST", endpoint, (input ?? {}));
+            return apiRequest(ctx, "POST", endpoint, (input ?? {}));
         },
     });
     rl.registerAction(`${resource}.get`, {
@@ -81,8 +64,7 @@ function registerCrud(rl, resource, endpoint, idParam, nameRequired, extraCreate
             },
         },
         async execute(input, ctx) {
-            const { apiKey, email } = getConn(ctx);
-            return apiRequest(apiKey, email, "GET", `${endpoint}/${input[idParam]}`);
+            return apiRequest(ctx, "GET", `${endpoint}/${pathSegment(input[idParam])}`);
         },
     });
     rl.registerAction(`${resource}.list`, {
@@ -92,9 +74,8 @@ function registerCrud(rl, resource, endpoint, idParam, nameRequired, extraCreate
             limit: { type: "number", required: false, description: "Max results" },
         },
         async execute(input, ctx) {
-            const { apiKey, email } = getConn(ctx);
             const { limit } = (input ?? {});
-            return searchAll(apiKey, email, `${endpoint}/search`, undefined, limit);
+            return searchAll(ctx, `${endpoint}/search`, undefined, limit);
         },
     });
     rl.registerAction(`${resource}.update`, {
@@ -108,9 +89,8 @@ function registerCrud(rl, resource, endpoint, idParam, nameRequired, extraCreate
             },
         },
         async execute(input, ctx) {
-            const { apiKey, email } = getConn(ctx);
             const { [idParam]: id, ...body } = input;
-            return apiRequest(apiKey, email, "PUT", `${endpoint}/${id}`, body);
+            return apiRequest(ctx, "PUT", `${endpoint}/${pathSegment(id)}`, body);
         },
     });
     rl.registerAction(`${resource}.delete`, {
@@ -124,14 +104,14 @@ function registerCrud(rl, resource, endpoint, idParam, nameRequired, extraCreate
             },
         },
         async execute(input, ctx) {
-            const { apiKey, email } = getConn(ctx);
-            return apiRequest(apiKey, email, "DELETE", `${endpoint}/${input[idParam]}`);
+            return apiRequest(ctx, "DELETE", `${endpoint}/${pathSegment(input[idParam])}`);
         },
     });
 }
 export default function copper(rl) {
     rl.setName("copper");
     rl.setVersion("0.1.0");
+    rl.setCredential(copperCredential);
     rl.setConnectionSchema({
         apiKey: {
             type: "string",
@@ -147,9 +127,9 @@ export default function copper(rl) {
         },
     });
     // CRUD resources
-    registerCrud(rl, "company", "/companies", "companyId", true);
-    registerCrud(rl, "lead", "/leads", "leadId", true);
-    registerCrud(rl, "opportunity", "/opportunities", "opportunityId", true, {
+    registerCrud(rl, "company", "companies", "companyId", true);
+    registerCrud(rl, "lead", "leads", "leadId", true);
+    registerCrud(rl, "opportunity", "opportunities", "opportunityId", true, {
         customerSourceId: {
             type: "string",
             required: true,
@@ -161,9 +141,9 @@ export default function copper(rl) {
             description: "Primary contact ID",
         },
     });
-    registerCrud(rl, "person", "/people", "personId", true);
-    registerCrud(rl, "project", "/projects", "projectId", true);
-    registerCrud(rl, "task", "/tasks", "taskId", true);
+    registerCrud(rl, "person", "people", "personId", true);
+    registerCrud(rl, "project", "projects", "projectId", true);
+    registerCrud(rl, "task", "tasks", "taskId", true);
     // Read-only resources
     rl.registerAction("customerSource.list", {
         access: "read",
@@ -172,8 +152,7 @@ export default function copper(rl) {
             limit: { type: "number", required: false, description: "Max results" },
         },
         async execute(input, ctx) {
-            const { apiKey, email } = getConn(ctx);
-            const data = (await apiRequest(apiKey, email, "GET", "/customer_sources"));
+            const data = (await apiRequest(ctx, "GET", "customer_sources"));
             const { limit } = (input ?? {});
             if (limit)
                 return data.slice(0, limit);
@@ -187,9 +166,8 @@ export default function copper(rl) {
             limit: { type: "number", required: false, description: "Max results" },
         },
         async execute(input, ctx) {
-            const { apiKey, email } = getConn(ctx);
             const { limit } = (input ?? {});
-            return searchAll(apiKey, email, "/users/search", undefined, limit);
+            return searchAll(ctx, "users/search", undefined, limit);
         },
     });
 }

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

@@ -0,0 +1,28 @@
+import { httpsBase, staticCredential } from "../../_shared/credentials.js";
+/**
+ * The longest report wait analyzer.execute accepts. The waiting target
+ * declares that wait plus a 60 s allowance for the exchange itself, which
+ * lands exactly on the 10-minute host ceiling.
+ */
+export const MAX_WAIT_SECONDS = 540;
+/**
+ * A Cortex API key, sent as a bearer to the connection's own Cortex
+ * instance beneath /api/. The `wait` target is the same surface with the
+ * long deadline /job/{id}/waitreport holds a request open for.
+ */
+export const cortexCredential = staticCredential({
+    id: "cortex",
+    auth: { kind: "bearer" },
+    local: { secret: "apiKey" },
+    targets: (config) => {
+        const baseUrl = httpsBase(config.host, "api/");
+        return {
+            api: { baseUrl, methods: ["GET", "POST"] },
+            wait: {
+                baseUrl,
+                methods: ["GET"],
+                timeoutMs: MAX_WAIT_SECONDS * 1000 + 60_000,
+            },
+        };
+    },
+});

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

@@ -1,38 +1,20 @@
-async function apiRequest(host, apiKey, method, endpoint, body, qs) {
-    const url = new URL(`${host}/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 = {
+import { credentialJson, pathSegment } from "../../_shared/credentials.js";
+import { cortexCredential, MAX_WAIT_SECONDS } from "./credentials.js";
+function apiRequest(ctx, method, path, options = {}) {
+    return credentialJson(ctx, cortexCredential, "cortex", {
+        target: options.target ?? "api",
+        path,
         method,
-        headers: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${apiKey}`,
-        },
-    };
-    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(`Cortex API error ${res.status}: ${await res.text()}`);
-    return res.json();
-}
-function getConn(ctx) {
-    return {
-        host: ctx.connection.config.host.replace(/\/$/, ""),
-        apiKey: ctx.connection.config.apiKey,
-    };
+        query: options.query,
+        ...(options.json && Object.keys(options.json).length > 0
+            ? { json: options.json }
+            : {}),
+    });
 }
 export default function cortex(rl) {
     rl.setName("cortex");
     rl.setVersion("0.1.0");
+    rl.setCredential(cortexCredential);
     rl.setConnectionSchema({
         host: {
             type: "string",
@@ -72,24 +54,20 @@ export default function cortex(rl) {
             timeout: {
                 type: "number",
                 required: false,
-                description: "Wait for report (seconds). If set, blocks until report is ready.",
+                description: "Wait for report (seconds, at most 540). If set, blocks until " +
+                    "the report is ready.",
             },
         },
         async execute(input, ctx) {
             const { analyzerId, dataType, data, tlp = 2, force, timeout, } = input;
-            const { host, apiKey } = getConn(ctx);
-            const qs = {};
-            if (force)
-                qs.force = true;
-            const result = (await apiRequest(host, apiKey, "POST", `/analyzer/${analyzerId}/run`, {
-                dataType,
-                data,
-                tlp,
-            }, qs));
+            const result = (await apiRequest(ctx, "POST", `analyzer/${pathSegment(analyzerId)}/run`, {
+                json: { dataType, data, tlp },
+                ...(force ? { query: { force: true } } : {}),
+            }));
             if (timeout && result.id) {
-                return apiRequest(host, apiKey, "GET", `/job/${result.id}/waitreport`, undefined, {
-                    atMost: `${timeout}second`,
-                });
+                // The wait target's declared deadline covers the longest atMost.
+                const atMost = Math.min(Number(timeout), MAX_WAIT_SECONDS);
+                return apiRequest(ctx, "GET", `job/${pathSegment(result.id)}/waitreport`, { target: "wait", query: { atMost: `${atMost}second` } });
             }
             return result;
         },
@@ -103,8 +81,7 @@ export default function cortex(rl) {
         },
         async execute(input, ctx) {
             const { jobId } = input;
-            const { host, apiKey } = getConn(ctx);
-            return apiRequest(host, apiKey, "GET", `/job/${jobId}`);
+            return apiRequest(ctx, "GET", `job/${pathSegment(jobId)}`);
         },
     });
     rl.registerAction("job.getReport", {
@@ -115,8 +92,7 @@ export default function cortex(rl) {
         },
         async execute(input, ctx) {
             const { jobId } = input;
-            const { host, apiKey } = getConn(ctx);
-            return apiRequest(host, apiKey, "GET", `/job/${jobId}/report`);
+            return apiRequest(ctx, "GET", `job/${pathSegment(jobId)}/report`);
         },
     });
     // ── Responder ───────────────────────────────────────
@@ -153,7 +129,6 @@ export default function cortex(rl) {
         },
         async execute(input, ctx) {
             const { responderId, entityType, data, tlp = 2, pap = 2, message, } = input;
-            const { host, apiKey } = getConn(ctx);
             const entityData = {
                 _type: entityType,
                 ...data,
@@ -187,7 +162,9 @@ export default function cortex(rl) {
                     break;
             }
             body.label = label;
-            return apiRequest(host, apiKey, "POST", `/responder/${responderId}/run`, body);
+            return apiRequest(ctx, "POST", `responder/${pathSegment(responderId)}/run`, {
+                json: body,
+            });
         },
     });
 }

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

@@ -0,0 +1,19 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/** An API key, sent as a bearer to Currents' one API origin. */
+export const currentsCredential = staticCredential({
+    id: "currents",
+    auth: { kind: "bearer" },
+    local: { secret: "apiKey" },
+    targets: {
+        api: {
+            baseUrl: "https://api.currents.dev/v1/",
+            methods: ["GET", "POST", "PUT", "DELETE"],
+        },
+    },
+    probe: {
+        target: "api",
+        path: "projects",
+        method: "GET",
+        acceptedStatuses: [200],
+    },
+});