runline 0.33.0 → 0.35.0

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

@@ -1,18 +1,18 @@
-const BASE_URL = "https://mandrillapp.com/api/1.0";
-async function apiRequest(apiKey, endpoint, body = {}) {
-    body.key = apiKey;
-    const res = await fetch(`${BASE_URL}${endpoint}.json`, {
+import { credentialJson } from "../../_shared/credentials.js";
+import { mandrillCredential } from "./credentials.js";
+/** Every Mandrill call is a JSON POST to `<endpoint>.json`. */
+function apiRequest(ctx, endpoint, body) {
+    return credentialJson(ctx, mandrillCredential, "mandrill", {
+        target: "api",
+        path: `${endpoint}.json`,
         method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(body),
+        json: body,
     });
-    if (!res.ok)
-        throw new Error(`Mandrill API error ${res.status}: ${await res.text()}`);
-    return res.json();
 }
 export default function mandrill(rl) {
     rl.setName("mandrill");
     rl.setVersion("0.1.0");
+    rl.setCredential(mandrillCredential);
     rl.setConnectionSchema({
         apiKey: {
             type: "string",
@@ -21,7 +21,6 @@ export default function mandrill(rl) {
             env: "MANDRILL_API_KEY",
         },
     });
-    const key = (ctx) => ctx.connection.config.apiKey;
     function buildMessage(p) {
         const message = {
             from_email: p.fromEmail,
@@ -171,7 +170,7 @@ export default function mandrill(rl) {
             };
             if (p.sendAt)
                 body.send_at = p.sendAt;
-            return apiRequest(key(ctx), "/messages/send", body);
+            return apiRequest(ctx, "messages/send", body);
         },
     });
     rl.registerAction("message.sendTemplate", {
@@ -194,7 +193,7 @@ export default function mandrill(rl) {
             };
             if (p.sendAt)
                 body.send_at = p.sendAt;
-            return apiRequest(key(ctx), "/messages/send-template", body);
+            return apiRequest(ctx, "messages/send-template", body);
         },
     });
 }

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

@@ -0,0 +1,16 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/**
+ * An access key, appended by the transport as the access_key query
+ * parameter on Marketstack's v1 base. Requests are always HTTPS.
+ */
+export const marketstackCredential = staticCredential({
+    id: "marketstack",
+    auth: { kind: "queryKey", param: "access_key" },
+    local: { secret: "apiKey" },
+    targets: {
+        api: {
+            baseUrl: "https://api.marketstack.com/v1/",
+            methods: ["GET"],
+        },
+    },
+});

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

@@ -1,22 +1,18 @@
-async function apiRequest(apiKey, useHttps, method, endpoint, qs = {}) {
-    const protocol = useHttps ? "https" : "http";
-    const url = new URL(`${protocol}://api.marketstack.com/v1${endpoint}`);
-    url.searchParams.set("access_key", apiKey);
-    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(), { method });
-    if (!res.ok)
-        throw new Error(`Marketstack API error ${res.status}: ${await res.text()}`);
-    return res.json();
+import { credentialJson, pathSegment } from "../../_shared/credentials.js";
+import { marketstackCredential } from "./credentials.js";
+function api(ctx, endpoint, qs = {}) {
+    return credentialJson(ctx, marketstackCredential, "marketstack", {
+        target: "api",
+        path: endpoint,
+        query: qs,
+    });
 }
-async function paginateAll(apiKey, useHttps, endpoint, qs = {}, limit) {
+async function paginateAll(ctx, endpoint, qs = {}, limit) {
     const all = [];
     qs.offset = 0;
     let resp;
     do {
-        resp = (await apiRequest(apiKey, useHttps, "GET", endpoint, qs));
+        resp = (await api(ctx, endpoint, qs));
         const data = resp.data;
         if (data)
             all.push(...data);
@@ -29,6 +25,7 @@ async function paginateAll(apiKey, useHttps, endpoint, qs = {}, limit) {
 export default function marketstack(rl) {
     rl.setName("marketstack");
     rl.setVersion("0.1.0");
+    rl.setCredential(marketstackCredential);
     rl.setConnectionSchema({
         apiKey: {
             type: "string",
@@ -39,14 +36,10 @@ export default function marketstack(rl) {
         useHttps: {
             type: "boolean",
             required: false,
-            description: "Use HTTPS (requires paid plan). Default: false",
+            description: "Ignored: requests always use HTTPS",
             default: false,
         },
     });
-    const conn = (ctx) => ({
-        apiKey: ctx.connection.config.apiKey,
-        useHttps: ctx.connection.config.useHttps ?? false,
-    });
     // ── End-of-Day Data ─────────────────────────────────
     rl.registerAction("endOfDayData.list", {
         access: "read",
@@ -87,7 +80,6 @@ export default function marketstack(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            const { apiKey, useHttps } = conn(ctx);
             const qs = { symbols: p.symbols };
             if (p.sort)
                 qs.sort = p.sort;
@@ -95,20 +87,20 @@ export default function marketstack(rl) {
                 qs.exchange = p.exchange;
             let endpoint;
             if (p.latest) {
-                endpoint = "/eod/latest";
+                endpoint = "eod/latest";
             }
             else if (p.specificDate) {
-                endpoint = `/eod/${p.specificDate.split("T")[0]}`;
+                endpoint = `eod/${pathSegment(p.specificDate.split("T")[0])}`;
             }
             else if (p.dateFrom && p.dateTo) {
-                endpoint = "/eod";
+                endpoint = "eod";
                 qs.date_from = p.dateFrom.split("T")[0];
                 qs.date_to = p.dateTo.split("T")[0];
             }
             else {
                 throw new Error("Specify one of: latest (true), specificDate, or dateFrom+dateTo");
             }
-            return paginateAll(apiKey, useHttps, endpoint, qs, p.limit);
+            return paginateAll(ctx, endpoint, qs, p.limit);
         },
     });
     // ── Exchange ────────────────────────────────────────
@@ -123,8 +115,7 @@ export default function marketstack(rl) {
             },
         },
         async execute(input, ctx) {
-            const { apiKey, useHttps } = conn(ctx);
-            return apiRequest(apiKey, useHttps, "GET", `/exchanges/${input.exchange}`);
+            return api(ctx, `exchanges/${pathSegment(input.exchange)}`);
         },
     });
     // ── Ticker ──────────────────────────────────────────
@@ -139,8 +130,7 @@ export default function marketstack(rl) {
             },
         },
         async execute(input, ctx) {
-            const { apiKey, useHttps } = conn(ctx);
-            return apiRequest(apiKey, useHttps, "GET", `/tickers/${input.symbol}`);
+            return api(ctx, `tickers/${pathSegment(input.symbol)}`);
         },
     });
 }

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

@@ -0,0 +1,19 @@
+import { httpsBase, staticCredential } from "../../_shared/credentials.js";
+/** An access token, sent as a bearer to the configured homeserver's client API. */
+export const matrixCredential = staticCredential({
+    id: "matrix",
+    auth: { kind: "bearer" },
+    local: { secret: "accessToken" },
+    targets: (config) => ({
+        api: {
+            baseUrl: httpsBase(config.homeserverUrl, "_matrix/client/r0/"),
+            methods: ["GET", "POST", "PUT"],
+        },
+    }),
+    probe: {
+        target: "api",
+        path: "account/whoami",
+        method: "GET",
+        acceptedStatuses: [200],
+    },
+});

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

@@ -1,34 +1,18 @@
-async function apiRequest(homeserver, token, method, endpoint, body, qs) {
-    const url = new URL(`${homeserver}/_matrix/client/r0${endpoint}`);
-    if (qs) {
-        for (const [k, v] of Object.entries(qs)) {
-            if (v !== undefined && v !== null && v !== "")
-                url.searchParams.set(k, String(v));
-        }
-    }
-    const opts = {
+import { credentialJson, pathSegment } from "../../_shared/credentials.js";
+import { matrixCredential } from "./credentials.js";
+function apiRequest(ctx, method, path, body, query) {
+    return credentialJson(ctx, matrixCredential, "matrix", {
+        target: "api",
+        path,
         method,
-        headers: {
-            Authorization: `Bearer ${token}`,
-            "Content-Type": "application/json; charset=utf-8",
-        },
-    };
-    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(`Matrix API error ${res.status}: ${await res.text()}`);
-    return res.json();
-}
-function generateTxnId() {
-    return crypto.randomUUID();
+        query,
+        ...(body && Object.keys(body).length > 0 ? { json: body } : {}),
+    });
 }
 export default function matrix(rl) {
     rl.setName("matrix");
     rl.setVersion("0.1.0");
+    rl.setCredential(matrixCredential);
     rl.setConnectionSchema({
         homeserverUrl: {
             type: "string",
@@ -43,17 +27,12 @@ export default function matrix(rl) {
             env: "MATRIX_ACCESS_TOKEN",
         },
     });
-    const conn = (ctx) => ({
-        homeserver: ctx.connection.config.homeserverUrl.replace(/\/$/, ""),
-        token: ctx.connection.config.accessToken,
-    });
     // ── Account ─────────────────────────────────────────
     rl.registerAction("account.me", {
         access: "read",
         description: "Get info about the authenticated user",
         async execute(_input, ctx) {
-            const { homeserver, token } = conn(ctx);
-            return apiRequest(homeserver, token, "GET", "/account/whoami");
+            return apiRequest(ctx, "GET", "account/whoami");
         },
     });
     // ── Room ────────────────────────────────────────────
@@ -75,11 +54,10 @@ export default function matrix(rl) {
         },
         async execute(input, ctx) {
             const { name, preset, roomAlias } = input;
-            const { homeserver, token } = conn(ctx);
             const body = { name, preset };
             if (roomAlias)
                 body.room_alias_name = roomAlias;
-            return apiRequest(homeserver, token, "POST", "/createRoom", body);
+            return apiRequest(ctx, "POST", "createRoom", body);
         },
     });
     rl.registerAction("room.join", {
@@ -93,8 +71,7 @@ export default function matrix(rl) {
             },
         },
         async execute(input, ctx) {
-            const { homeserver, token } = conn(ctx);
-            return apiRequest(homeserver, token, "POST", `/rooms/${encodeURIComponent(input.roomIdOrAlias)}/join`);
+            return apiRequest(ctx, "POST", `rooms/${pathSegment(input.roomIdOrAlias)}/join`);
         },
     });
     rl.registerAction("room.leave", {
@@ -102,8 +79,7 @@ export default function matrix(rl) {
         description: "Leave a room",
         inputSchema: { roomId: { type: "string", required: true } },
         async execute(input, ctx) {
-            const { homeserver, token } = conn(ctx);
-            return apiRequest(homeserver, token, "POST", `/rooms/${encodeURIComponent(input.roomId)}/leave`);
+            return apiRequest(ctx, "POST", `rooms/${pathSegment(input.roomId)}/leave`);
         },
     });
     rl.registerAction("room.invite", {
@@ -119,8 +95,9 @@ export default function matrix(rl) {
         },
         async execute(input, ctx) {
             const { roomId, userId } = input;
-            const { homeserver, token } = conn(ctx);
-            return apiRequest(homeserver, token, "POST", `/rooms/${encodeURIComponent(roomId)}/invite`, { user_id: userId });
+            return apiRequest(ctx, "POST", `rooms/${pathSegment(roomId)}/invite`, {
+                user_id: userId,
+            });
         },
     });
     rl.registerAction("room.kick", {
@@ -137,11 +114,10 @@ export default function matrix(rl) {
         },
         async execute(input, ctx) {
             const { roomId, userId, reason } = input;
-            const { homeserver, token } = conn(ctx);
             const body = { user_id: userId };
             if (reason)
                 body.reason = reason;
-            return apiRequest(homeserver, token, "POST", `/rooms/${encodeURIComponent(roomId)}/kick`, body);
+            return apiRequest(ctx, "POST", `rooms/${pathSegment(roomId)}/kick`, body);
         },
     });
     // ── Message ─────────────────────────────────────────
@@ -173,7 +149,6 @@ export default function matrix(rl) {
         },
         async execute(input, ctx) {
             const { roomId, text, messageType = "m.text", messageFormat, fallbackText, } = input;
-            const { homeserver, token } = conn(ctx);
             const body = {
                 msgtype: messageType,
                 body: text,
@@ -183,8 +158,7 @@ export default function matrix(rl) {
                 body.formatted_body = text;
                 body.body = fallbackText || text;
             }
-            const txnId = generateTxnId();
-            return apiRequest(homeserver, token, "PUT", `/rooms/${encodeURIComponent(roomId)}/send/m.room.message/${txnId}`, body);
+            return apiRequest(ctx, "PUT", `rooms/${pathSegment(roomId)}/send/m.room.message/${crypto.randomUUID()}`, body);
         },
     });
     rl.registerAction("message.list", {
@@ -205,12 +179,11 @@ export default function matrix(rl) {
         },
         async execute(input, ctx) {
             const { roomId, limit, filter } = (input ?? {});
-            const { homeserver, token } = conn(ctx);
             if (limit) {
                 const qs = { dir: "b", limit };
                 if (filter)
                     qs.filter = filter;
-                const data = (await apiRequest(homeserver, token, "GET", `/rooms/${encodeURIComponent(roomId)}/messages`, undefined, qs));
+                const data = (await apiRequest(ctx, "GET", `rooms/${pathSegment(roomId)}/messages`, undefined, qs));
                 return data.chunk;
             }
             // Paginate all
@@ -223,7 +196,7 @@ export default function matrix(rl) {
                     qs.from = from;
                 if (filter)
                     qs.filter = filter;
-                const data = (await apiRequest(homeserver, token, "GET", `/rooms/${encodeURIComponent(roomId)}/messages`, undefined, qs));
+                const data = (await apiRequest(ctx, "GET", `rooms/${pathSegment(roomId)}/messages`, undefined, qs));
                 chunk = data.chunk;
                 all.push(...chunk);
                 from = data.end;
@@ -245,8 +218,7 @@ export default function matrix(rl) {
         },
         async execute(input, ctx) {
             const { roomId, eventId } = input;
-            const { homeserver, token } = conn(ctx);
-            return apiRequest(homeserver, token, "GET", `/rooms/${encodeURIComponent(roomId)}/event/${encodeURIComponent(eventId)}`);
+            return apiRequest(ctx, "GET", `rooms/${pathSegment(roomId)}/event/${pathSegment(eventId)}`);
         },
     });
     // ── Room Member ─────────────────────────────────────
@@ -268,13 +240,12 @@ export default function matrix(rl) {
         },
         async execute(input, ctx) {
             const { roomId, membership, notMembership } = (input ?? {});
-            const { homeserver, token } = conn(ctx);
             const qs = {};
             if (membership)
                 qs.membership = membership;
             if (notMembership)
                 qs.not_membership = notMembership;
-            const data = (await apiRequest(homeserver, token, "GET", `/rooms/${encodeURIComponent(roomId)}/members`, undefined, qs));
+            const data = (await apiRequest(ctx, "GET", `rooms/${pathSegment(roomId)}/members`, undefined, qs));
             return data.chunk;
         },
     });

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

@@ -0,0 +1,19 @@
+import { httpsBase, staticCredential } from "../../_shared/credentials.js";
+/** A personal access or bot token, sent as a bearer to the configured server. */
+export const mattermostCredential = staticCredential({
+    id: "mattermost",
+    auth: { kind: "bearer" },
+    local: { secret: "accessToken" },
+    targets: (config) => ({
+        api: {
+            baseUrl: httpsBase(config.baseUrl, "api/v4/"),
+            methods: ["GET", "POST", "DELETE"],
+        },
+    }),
+    probe: {
+        target: "api",
+        path: "users/me",
+        method: "GET",
+        acceptedStatuses: [200],
+    },
+});