runline 0.33.0 → 0.34.0

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

@@ -1,24 +1,18 @@
-const BASE_URL = "https://rest.moceanapi.com";
-async function apiRequest(apiKey, apiSecret, endpoint, body) {
-    body["mocean-api-key"] = apiKey;
-    body["mocean-api-secret"] = apiSecret;
-    body["mocean-resp-format"] = "JSON";
-    const form = new URLSearchParams();
-    for (const [k, v] of Object.entries(body)) {
-        if (v !== undefined && v !== null)
-            form.set(k, String(v));
-    }
-    const res = await fetch(`${BASE_URL}${endpoint}`, {
+import { credentialJson } from "../../_shared/credentials.js";
+import { moceanCredential } from "./credentials.js";
+/** A Mocean form call, answered in JSON. */
+function apiRequest(ctx, endpoint, body) {
+    return credentialJson(ctx, moceanCredential, "mocean", {
+        target: "api",
+        path: endpoint,
         method: "POST",
-        body: form,
+        form: { ...body, "mocean-resp-format": "JSON" },
     });
-    if (!res.ok)
-        throw new Error(`Mocean API error ${res.status}: ${await res.text()}`);
-    return res.json();
 }
 export default function mocean(rl) {
     rl.setName("mocean");
     rl.setVersion("0.1.0");
+    rl.setCredential(moceanCredential);
     rl.setConnectionSchema({
         apiKey: {
             type: "string",
@@ -33,10 +27,6 @@ export default function mocean(rl) {
             env: "MOCEAN_API_SECRET",
         },
     });
-    const creds = (ctx) => ({
-        apiKey: ctx.connection.config.apiKey,
-        apiSecret: ctx.connection.config.apiSecret,
-    });
     rl.registerAction("sms.send", {
         access: "write",
         description: "Send an SMS message",
@@ -52,7 +42,6 @@ export default function mocean(rl) {
         },
         async execute(input, ctx) {
             const { from, to, message, dlrUrl } = input;
-            const { apiKey, apiSecret } = creds(ctx);
             const body = {
                 "mocean-from": from,
                 "mocean-to": to,
@@ -62,7 +51,7 @@ export default function mocean(rl) {
                 body["mocean-dlr-url"] = dlrUrl;
                 body["mocean-dlr-mask"] = "1";
             }
-            const data = (await apiRequest(apiKey, apiSecret, "/rest/2/sms", body));
+            const data = (await apiRequest(ctx, "sms", body));
             return data.messages;
         },
     });
@@ -81,14 +70,13 @@ export default function mocean(rl) {
         },
         async execute(input, ctx) {
             const { from, to, message, language = "en-US", } = input;
-            const { apiKey, apiSecret } = creds(ctx);
             const command = [{ action: "say", language, text: message }];
             const body = {
                 "mocean-from": from,
                 "mocean-to": to,
                 "mocean-command": JSON.stringify(command),
             };
-            const data = (await apiRequest(apiKey, apiSecret, "/rest/2/voice/dial", body));
+            const data = (await apiRequest(ctx, "voice/dial", body));
             return data.voice;
         },
     });

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

@@ -0,0 +1,14 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/** An API token, sent raw in the Authorization header to the GraphQL endpoint. */
+export const mondayCredential = staticCredential({
+    id: "monday",
+    auth: { kind: "apiKey", header: "Authorization" },
+    local: { secret: "apiToken" },
+    targets: {
+        api: {
+            baseUrl: "https://api.monday.com/v2/",
+            methods: ["POST"],
+            allowedHeaders: ["API-Version"],
+        },
+    },
+});

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

@@ -1,23 +1,21 @@
-async function gql(token, query, variables = {}) {
-    const res = await fetch("https://api.monday.com/v2/", {
+import { credentialJson, graphqlFailed } from "../../_shared/credentials.js";
+import { mondayCredential } from "./credentials.js";
+async function gql(ctx, query, variables = {}) {
+    const data = (await credentialJson(ctx, mondayCredential, "monday", {
+        target: "api",
+        path: "",
         method: "POST",
-        headers: {
-            Authorization: token,
-            "API-Version": "2023-10",
-            "Content-Type": "application/json",
-        },
-        body: JSON.stringify({ query, variables }),
-    });
-    if (!res.ok)
-        throw new Error(`Monday.com API error ${res.status}: ${await res.text()}`);
-    const data = (await res.json());
+        headers: { "API-Version": "2023-10" },
+        json: { query, variables },
+    }));
     if (data.errors)
-        throw new Error(`Monday.com GraphQL errors: ${JSON.stringify(data.errors)}`);
+        throw graphqlFailed("monday", data.errors);
     return data.data;
 }
 export default function monday(rl) {
     rl.setName("monday");
     rl.setVersion("0.1.0");
+    rl.setCredential(mondayCredential);
     rl.setConnectionSchema({
         apiToken: {
             type: "string",
@@ -26,7 +24,6 @@ export default function monday(rl) {
             env: "MONDAY_API_TOKEN",
         },
     });
-    const tok = (ctx) => ctx.connection.config.apiToken;
     // ── Board ───────────────────────────────────────────
     rl.registerAction("board.create", {
         access: "write",
@@ -45,7 +42,7 @@ export default function monday(rl) {
             const vars = { name, kind };
             if (templateId)
                 vars.templateId = templateId;
-            const data = await gql(tok(ctx), `mutation ($name: String!, $kind: BoardKind!, $templateId: ID) { create_board (board_name: $name, board_kind: $kind, template_id: $templateId) { id } }`, vars);
+            const data = await gql(ctx, `mutation ($name: String!, $kind: BoardKind!, $templateId: ID) { create_board (board_name: $name, board_kind: $kind, template_id: $templateId) { id } }`, vars);
             return data.create_board;
         },
     });
@@ -54,7 +51,7 @@ export default function monday(rl) {
         description: "Archive a board",
         inputSchema: { boardId: { type: "string", required: true } },
         async execute(input, ctx) {
-            const data = await gql(tok(ctx), `mutation ($id: ID!) { archive_board (board_id: $id) { id } }`, { id: input.boardId });
+            const data = await gql(ctx, `mutation ($id: ID!) { archive_board (board_id: $id) { id } }`, { id: input.boardId });
             return data.archive_board;
         },
     });
@@ -63,7 +60,7 @@ export default function monday(rl) {
         description: "Get a board by ID",
         inputSchema: { boardId: { type: "string", required: true } },
         async execute(input, ctx) {
-            const data = await gql(tok(ctx), `query ($id: [ID!]) { boards (ids: $id) { id name description state board_folder_id board_kind owners { id } } }`, { id: input.boardId });
+            const data = await gql(ctx, `query ($id: [ID!]) { boards (ids: $id) { id name description state board_folder_id board_kind owners { id } } }`, { id: input.boardId });
             return data.boards?.[0];
         },
     });
@@ -73,7 +70,7 @@ export default function monday(rl) {
         inputSchema: { limit: { type: "number", required: false } },
         async execute(input, ctx) {
             const { limit } = (input ?? {});
-            const data = await gql(tok(ctx), `query ($limit: Int) { boards (limit: $limit) { id name description state board_folder_id board_kind owners { id } } }`, limit ? { limit } : {});
+            const data = await gql(ctx, `query ($limit: Int) { boards (limit: $limit) { id name description state board_folder_id board_kind owners { id } } }`, limit ? { limit } : {});
             return data.boards;
         },
     });
@@ -100,7 +97,7 @@ export default function monday(rl) {
             const vars = { boardId, title, columnType };
             if (defaults)
                 vars.defaults = JSON.stringify(JSON.parse(defaults));
-            const data = await gql(tok(ctx), `mutation ($boardId: ID!, $title: String!, $columnType: ColumnType!, $defaults: JSON) { create_column (board_id: $boardId, title: $title, column_type: $columnType, defaults: $defaults) { id } }`, vars);
+            const data = await gql(ctx, `mutation ($boardId: ID!, $title: String!, $columnType: ColumnType!, $defaults: JSON) { create_column (board_id: $boardId, title: $title, column_type: $columnType, defaults: $defaults) { id } }`, vars);
             return data.create_column;
         },
     });
@@ -109,7 +106,7 @@ export default function monday(rl) {
         description: "List columns on a board",
         inputSchema: { boardId: { type: "string", required: true } },
         async execute(input, ctx) {
-            const data = await gql(tok(ctx), `query ($boardId: [ID!]) { boards (ids: $boardId) { columns { id title type settings_str archived } } }`, { boardId: input.boardId });
+            const data = await gql(ctx, `query ($boardId: [ID!]) { boards (ids: $boardId) { columns { id title type settings_str archived } } }`, { boardId: input.boardId });
             return data.boards?.[0]?.columns;
         },
     });
@@ -123,7 +120,7 @@ export default function monday(rl) {
         },
         async execute(input, ctx) {
             const { boardId, name } = input;
-            const data = await gql(tok(ctx), `mutation ($boardId: ID!, $groupName: String!) { create_group (board_id: $boardId, group_name: $groupName) { id } }`, { boardId, groupName: name });
+            const data = await gql(ctx, `mutation ($boardId: ID!, $groupName: String!) { create_group (board_id: $boardId, group_name: $groupName) { id } }`, { boardId, groupName: name });
             return data.create_group;
         },
     });
@@ -136,7 +133,7 @@ export default function monday(rl) {
         },
         async execute(input, ctx) {
             const { boardId, groupId } = input;
-            const data = await gql(tok(ctx), `mutation ($boardId: ID!, $groupId: String!) { delete_group (board_id: $boardId, group_id: $groupId) { id } }`, { boardId, groupId });
+            const data = await gql(ctx, `mutation ($boardId: ID!, $groupId: String!) { delete_group (board_id: $boardId, group_id: $groupId) { id } }`, { boardId, groupId });
             return data.delete_group;
         },
     });
@@ -145,7 +142,7 @@ export default function monday(rl) {
         description: "List groups on a board",
         inputSchema: { boardId: { type: "string", required: true } },
         async execute(input, ctx) {
-            const data = await gql(tok(ctx), `query ($boardId: [ID!]) { boards (ids: $boardId) { id groups { id title color position archived } } }`, { boardId: input.boardId });
+            const data = await gql(ctx, `query ($boardId: [ID!]) { boards (ids: $boardId) { id groups { id title color position archived } } }`, { boardId: input.boardId });
             return data.boards?.[0]?.groups;
         },
     });
@@ -172,7 +169,7 @@ export default function monday(rl) {
             };
             if (columnValues)
                 vars.columnValues = JSON.stringify(JSON.parse(columnValues));
-            const data = await gql(tok(ctx), `mutation ($boardId: ID!, $groupId: String!, $itemName: String!, $columnValues: JSON) { create_item (board_id: $boardId, group_id: $groupId, item_name: $itemName, column_values: $columnValues) { id } }`, vars);
+            const data = await gql(ctx, `mutation ($boardId: ID!, $groupId: String!, $itemName: String!, $columnValues: JSON) { create_item (board_id: $boardId, group_id: $groupId, item_name: $itemName, column_values: $columnValues) { id } }`, vars);
             return data.create_item;
         },
     });
@@ -190,7 +187,7 @@ export default function monday(rl) {
             const ids = input.itemIds
                 .split(",")
                 .map((s) => s.trim());
-            const data = await gql(tok(ctx), `query ($itemId: [ID!]) { items (ids: $itemId) { id name created_at state column_values { id text type value column { title archived description settings_str } } } }`, { itemId: ids });
+            const data = await gql(ctx, `query ($itemId: [ID!]) { items (ids: $itemId) { id name created_at state column_values { id text type value column { title archived description settings_str } } } }`, { itemId: ids });
             return data.items;
         },
     });
@@ -204,19 +201,9 @@ export default function monday(rl) {
         },
         async execute(input, ctx) {
             const { boardId, groupId, limit = 100, } = input;
-            const data = await gql(tok(ctx), `query ($boardId: [ID!], $groupId: [String], $limit: Int) { boards(ids: $boardId) { groups(ids: $groupId) { id items_page(limit: $limit) { cursor items { id name created_at state column_values { id text type value column { title archived description settings_str } } } } } } }`, { boardId, groupId, limit });
-            return data.boards?.[0]
-                ? data.boards[0].groups?.[0]
-                    ? data.boards[0]
-                        .groups[0]
-                        ? data.boards[0]
-                            .groups[0].items_page
-                            ? data.boards[0]
-                                .groups[0].items_page
-                            : []
-                        : []
-                    : []
-                : [];
+            const data = await gql(ctx, `query ($boardId: [ID!], $groupId: [String], $limit: Int) { boards(ids: $boardId) { groups(ids: $groupId) { id items_page(limit: $limit) { cursor items { id name created_at state column_values { id text type value column { title archived description settings_str } } } } } } }`, { boardId, groupId, limit });
+            const boards = data.boards;
+            return boards?.[0]?.groups?.[0]?.items_page ?? [];
         },
     });
     rl.registerAction("boardItem.delete", {
@@ -224,7 +211,7 @@ export default function monday(rl) {
         description: "Delete an item",
         inputSchema: { itemId: { type: "string", required: true } },
         async execute(input, ctx) {
-            const data = await gql(tok(ctx), `mutation ($itemId: ID!) { delete_item (item_id: $itemId) { id } }`, { itemId: input.itemId });
+            const data = await gql(ctx, `mutation ($itemId: ID!) { delete_item (item_id: $itemId) { id } }`, { itemId: input.itemId });
             return data.delete_item;
         },
     });
@@ -237,7 +224,7 @@ export default function monday(rl) {
         },
         async execute(input, ctx) {
             const { itemId, groupId } = input;
-            const data = await gql(tok(ctx), `mutation ($groupId: String!, $itemId: ID!) { move_item_to_group (group_id: $groupId, item_id: $itemId) { id } }`, { groupId, itemId });
+            const data = await gql(ctx, `mutation ($groupId: String!, $itemId: ID!) { move_item_to_group (group_id: $groupId, item_id: $itemId) { id } }`, { groupId, itemId });
             return data.move_item_to_group;
         },
     });
@@ -254,7 +241,7 @@ export default function monday(rl) {
         },
         async execute(input, ctx) {
             const { itemId, value } = input;
-            const data = await gql(tok(ctx), `mutation ($itemId: ID!, $value: String!) { create_update (item_id: $itemId, body: $value) { id } }`, { itemId, value });
+            const data = await gql(ctx, `mutation ($itemId: ID!, $value: String!) { create_update (item_id: $itemId, body: $value) { id } }`, { itemId, value });
             return data.create_update;
         },
     });
@@ -273,7 +260,7 @@ export default function monday(rl) {
         },
         async execute(input, ctx) {
             const { boardId, itemId, columnId, value } = input;
-            const data = await gql(tok(ctx), `mutation ($boardId: ID!, $itemId: ID!, $columnId: String!, $value: JSON!) { change_column_value (board_id: $boardId, item_id: $itemId, column_id: $columnId, value: $value) { id } }`, {
+            const data = await gql(ctx, `mutation ($boardId: ID!, $itemId: ID!, $columnId: String!, $value: JSON!) { change_column_value (board_id: $boardId, item_id: $itemId, column_id: $columnId, value: $value) { id } }`, {
                 boardId,
                 itemId,
                 columnId,
@@ -296,7 +283,7 @@ export default function monday(rl) {
         },
         async execute(input, ctx) {
             const { boardId, itemId, columnValues } = input;
-            const data = await gql(tok(ctx), `mutation ($boardId: ID!, $itemId: ID!, $columnValues: JSON!) { change_multiple_column_values (board_id: $boardId, item_id: $itemId, column_values: $columnValues) { id } }`, {
+            const data = await gql(ctx, `mutation ($boardId: ID!, $itemId: ID!, $columnValues: JSON!) { change_multiple_column_values (board_id: $boardId, item_id: $itemId, column_values: $columnValues) { id } }`, {
                 boardId,
                 itemId,
                 columnValues: JSON.stringify(JSON.parse(columnValues)),
@@ -315,7 +302,7 @@ export default function monday(rl) {
         },
         async execute(input, ctx) {
             const { boardId, columnId, columnValue, limit = 100, } = input;
-            const data = await gql(tok(ctx), `query ($boardId: ID!, $columnId: String!, $columnValue: String!, $limit: Int) { items_page_by_column_values (limit: $limit, board_id: $boardId, columns: [{column_id: $columnId, column_values: [$columnValue]}]) { cursor items { id name created_at state board { id } column_values { id text type value column { title archived description settings_str } } } } }`, { boardId, columnId, columnValue, limit });
+            const data = await gql(ctx, `query ($boardId: ID!, $columnId: String!, $columnValue: String!, $limit: Int) { items_page_by_column_values (limit: $limit, board_id: $boardId, columns: [{column_id: $columnId, column_values: [$columnValue]}]) { cursor items { id name created_at state board { id } column_values { id text type value column { title archived description settings_str } } } } }`, { boardId, columnId, columnValue, limit });
             return data.items_page_by_column_values
                 ?.items;
         },

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

@@ -0,0 +1,19 @@
+import { httpsBase, staticCredential } from "../../_shared/credentials.js";
+/** An API token, sent as a bearer to the instance's own /api/ (hosted Monica by default). */
+export const monicaCrmCredential = staticCredential({
+    id: "monicaCrm",
+    auth: { kind: "bearer" },
+    local: { secret: "apiToken" },
+    targets: (config) => ({
+        api: {
+            baseUrl: httpsBase(config.url || "https://app.monicahq.com", "api/"),
+            methods: ["GET", "POST", "PUT", "DELETE"],
+        },
+    }),
+    probe: {
+        target: "api",
+        path: "me",
+        method: "GET",
+        acceptedStatuses: [200],
+    },
+});

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

@@ -1,39 +1,21 @@
-function getConn(ctx) {
-    const c = ctx.connection.config;
-    const base = (c.url || "https://app.monicahq.com").replace(/\/$/, "");
-    return { url: base, token: c.apiToken };
-}
-async function api(conn, method, endpoint, body, qs) {
-    const url = new URL(`${conn.url}/api${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 { monicaCrmCredential } from "./credentials.js";
+function api(ctx, method, endpoint, body, qs) {
+    return credentialJson(ctx, monicaCrmCredential, "monicaCrm", {
+        target: "api",
+        path: endpoint,
         method,
-        headers: {
-            Authorization: `Bearer ${conn.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.ok)
-        throw new Error(`Monica 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: body } : {}),
+    });
 }
-function registerCrud(rl, resource, plural, conn, createSchema) {
+function registerCrud(rl, resource, plural, createSchema) {
     rl.registerAction(`${resource}.create`, {
         access: "write",
         description: `Create a ${resource}`,
         inputSchema: createSchema,
         async execute(input, ctx) {
-            const data = (await api(conn(ctx), "POST", `/${plural}`, input));
+            const data = (await api(ctx, "POST", plural, input));
             return data.data;
         },
     });
@@ -42,7 +24,7 @@ function registerCrud(rl, resource, plural, conn, createSchema) {
         description: `Get a ${resource}`,
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            const data = (await api(conn(ctx), "GET", `/${plural}/${input.id}`));
+            const data = (await api(ctx, "GET", `${plural}/${pathSegment(input.id)}`));
             return data.data;
         },
     });
@@ -54,7 +36,7 @@ function registerCrud(rl, resource, plural, conn, createSchema) {
             const qs = {
                 limit: (input ?? {}).limit ?? 100,
             };
-            const data = (await api(conn(ctx), "GET", `/${plural}`, undefined, qs));
+            const data = (await api(ctx, "GET", plural, undefined, qs));
             return data.data;
         },
     });
@@ -67,7 +49,7 @@ function registerCrud(rl, resource, plural, conn, createSchema) {
         },
         async execute(input, ctx) {
             const p = input;
-            const data = (await api(conn(ctx), "PUT", `/${plural}/${p.id}`, p.data));
+            const data = (await api(ctx, "PUT", `${plural}/${pathSegment(p.id)}`, p.data));
             return data.data;
         },
     });
@@ -76,7 +58,7 @@ function registerCrud(rl, resource, plural, conn, createSchema) {
         description: `Delete a ${resource}`,
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            await api(conn(ctx), "DELETE", `/${plural}/${input.id}`);
+            await api(ctx, "DELETE", `${plural}/${pathSegment(input.id)}`);
             return { success: true };
         },
     });
@@ -84,6 +66,7 @@ function registerCrud(rl, resource, plural, conn, createSchema) {
 export default function monicaCrm(rl) {
     rl.setName("monicaCrm");
     rl.setVersion("0.1.0");
+    rl.setCredential(monicaCrmCredential);
     rl.setConnectionSchema({
         apiToken: {
             type: "string",
@@ -98,32 +81,32 @@ export default function monicaCrm(rl) {
             env: "MONICA_URL",
         },
     });
-    registerCrud(rl, "contact", "contacts", getConn, {
+    registerCrud(rl, "contact", "contacts", {
         first_name: { type: "string", required: true },
         last_name: { type: "string", required: false },
         gender_id: { type: "number", required: false },
     });
-    registerCrud(rl, "activity", "activities", getConn, {
+    registerCrud(rl, "activity", "activities", {
         summary: { type: "string", required: true },
         description: { type: "string", required: false },
         activity_type_id: { type: "number", required: false },
     });
-    registerCrud(rl, "note", "notes", getConn, {
+    registerCrud(rl, "note", "notes", {
         contact_id: { type: "number", required: true },
         body: { type: "string", required: true },
     });
-    registerCrud(rl, "task", "tasks", getConn, {
+    registerCrud(rl, "task", "tasks", {
         title: { type: "string", required: true },
         contact_id: { type: "number", required: false },
     });
-    registerCrud(rl, "tag", "tags", getConn, {
+    registerCrud(rl, "tag", "tags", {
         name: { type: "string", required: true },
     });
-    registerCrud(rl, "journalEntry", "journal", getConn, {
+    registerCrud(rl, "journalEntry", "journal", {
         title: { type: "string", required: true },
         post: { type: "string", required: true },
     });
-    registerCrud(rl, "reminder", "reminders", getConn, {
+    registerCrud(rl, "reminder", "reminders", {
         contact_id: { type: "number", required: true },
         title: { type: "string", required: true },
         initial_date: { type: "string", required: true },
@@ -133,12 +116,12 @@ export default function monicaCrm(rl) {
             description: "one_time, week, month, year",
         },
     });
-    registerCrud(rl, "call", "calls", getConn, {
+    registerCrud(rl, "call", "calls", {
         contact_id: { type: "number", required: true },
         content: { type: "string", required: false },
         called_at: { type: "string", required: false },
     });
-    registerCrud(rl, "conversation", "conversations", getConn, {
+    registerCrud(rl, "conversation", "conversations", {
         contact_id: { type: "number", required: true },
         contact_field_type_id: { type: "number", required: true },
         happened_at: { type: "string", required: true },

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

@@ -0,0 +1,10 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/** The auth key, appended by the transport as the authkey query parameter. */
+export const msg91Credential = staticCredential({
+    id: "msg91",
+    auth: { kind: "queryKey", param: "authkey" },
+    local: { secret: "authkey" },
+    targets: {
+        api: { baseUrl: "https://api.msg91.com/api/", methods: ["GET"] },
+    },
+});

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

@@ -1,6 +1,9 @@
+import { credentialOk } from "../../_shared/credentials.js";
+import { msg91Credential } from "./credentials.js";
 export default function msg91(rl) {
     rl.setName("msg91");
     rl.setVersion("0.1.0");
+    rl.setCredential(msg91Credential);
     rl.setConnectionSchema({
         authkey: {
             type: "string",
@@ -23,17 +26,18 @@ export default function msg91(rl) {
         },
         async execute(input, ctx) {
             const { from, to, message } = input;
-            const authkey = ctx.connection.config.authkey;
-            const url = new URL("https://api.msg91.com/api/sendhttp.php");
-            url.searchParams.set("authkey", authkey);
-            url.searchParams.set("route", "4");
-            url.searchParams.set("country", "0");
-            url.searchParams.set("sender", from);
-            url.searchParams.set("mobiles", to);
-            url.searchParams.set("message", message);
-            const res = await fetch(url.toString());
-            if (!res.ok)
-                throw new Error(`MSG91 API error ${res.status}: ${await res.text()}`);
+            // The response body is a bare request ID, not JSON.
+            const res = await credentialOk(ctx, msg91Credential, "msg91", {
+                target: "api",
+                path: "sendhttp.php",
+                query: {
+                    route: "4",
+                    country: "0",
+                    sender: from,
+                    mobiles: to,
+                    message,
+                },
+            });
             const text = await res.text();
             return { requestId: text };
         },

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

@@ -0,0 +1,22 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/**
+ * An API key, appended by the transport as the api_key query parameter on
+ * NASA's one API origin.
+ */
+export const nasaCredential = staticCredential({
+    id: "nasa",
+    auth: { kind: "queryKey", param: "api_key" },
+    local: { secret: "apiKey" },
+    targets: {
+        api: {
+            baseUrl: "https://api.nasa.gov/",
+            methods: ["GET"],
+        },
+    },
+    probe: {
+        target: "api",
+        path: "planetary/apod",
+        method: "GET",
+        acceptedStatuses: [200],
+    },
+});