runline 0.32.0 → 0.34.0

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

@@ -1,32 +1,15 @@
-function getConn(ctx) {
-    const host = ctx.connection.config.host.replace(/\/$/, "");
-    const token = ctx.connection.config.accessToken;
-    return { host, token };
-}
-async function api(host, token, method, path, body, qs) {
-    const url = new URL(`${host}${path}`);
-    if (qs) {
-        for (const [k, v] of Object.entries(qs)) {
-            if (v)
-                url.searchParams.set(k, v);
-        }
-    }
-    const init = {
+import { credentialJson, credentialOk, pathSegment, pathSegments, } from "../../_shared/credentials.js";
+import { databricksCredential } from "./credentials.js";
+function api(ctx, method, path, body, qs) {
+    return credentialJson(ctx, databricksCredential, "databricks", {
+        target: "workspace",
+        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 || res.headers.get("content-length") === "0")
-        return { success: true };
-    if (!res.ok)
-        throw new Error(`Databricks error ${res.status}: ${await res.text()}`);
-    const text = await res.text();
-    return text ? JSON.parse(text) : { success: true };
+        query: qs
+            ? Object.fromEntries(Object.entries(qs).filter(([, v]) => v))
+            : undefined,
+        ...(body && Object.keys(body).length > 0 ? { json: body } : {}),
+    });
 }
 function volumeParts(volumePath) {
     const parts = volumePath.split(".");
@@ -40,6 +23,7 @@ function sleep(ms) {
 export default function databricks(rl) {
     rl.setName("databricks");
     rl.setVersion("0.1.0");
+    rl.setCredential(databricksCredential);
     rl.setConnectionSchema({
         host: {
             type: "string",
@@ -72,7 +56,6 @@ export default function databricks(rl) {
             },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
             const params = (p.parameters ?? []);
             const body = {
@@ -83,7 +66,7 @@ export default function databricks(rl) {
             };
             if (params.length > 0)
                 body.parameters = params.map(({ name, value, type }) => type ? { name, value, type } : { name, value });
-            let result = (await api(host, token, "POST", "/api/2.0/sql/statements", body));
+            let result = (await api(ctx, "POST", "api/2.0/sql/statements", body));
             const statementId = result.statement_id;
             let status = result.status.state;
             let retries = 0;
@@ -92,7 +75,7 @@ export default function databricks(rl) {
                 status !== "CANCELED" &&
                 retries < 60) {
                 await sleep(5000);
-                result = (await api(host, token, "GET", `/api/2.0/sql/statements/${statementId}`));
+                result = (await api(ctx, "GET", `api/2.0/sql/statements/${pathSegment(statementId)}`));
                 status = result.status.state;
                 retries++;
             }
@@ -110,7 +93,7 @@ export default function databricks(rl) {
             }
             let chunkIdx = allRows.length > 0 ? 1 : 0;
             while (chunkIdx < totalChunks) {
-                const chunk = (await api(host, token, "GET", `/api/2.0/sql/statements/${statementId}/result/chunks/${chunkIdx}`));
+                const chunk = (await api(ctx, "GET", `api/2.0/sql/statements/${pathSegment(statementId)}/result/chunks/${pathSegment(chunkIdx)}`));
                 if (chunk.data_array)
                     allRows.push(...chunk.data_array);
                 chunkIdx++;
@@ -140,10 +123,9 @@ export default function databricks(rl) {
             directoryPath: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
             const [cat, sch, vol] = volumeParts(p.volumePath);
-            await api(host, token, "PUT", `/api/2.0/fs/directories/Volumes/${cat}/${sch}/${vol}/${p.directoryPath}`);
+            await api(ctx, "PUT", `api/2.0/fs/directories/Volumes/${pathSegment(cat)}/${pathSegment(sch)}/${pathSegment(vol)}/${pathSegments(p.directoryPath)}`);
             return { success: true, directoryPath: p.directoryPath };
         },
     });
@@ -159,10 +141,9 @@ export default function databricks(rl) {
             directoryPath: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
             const [cat, sch, vol] = volumeParts(p.volumePath);
-            await api(host, token, "DELETE", `/api/2.0/fs/directories/Volumes/${cat}/${sch}/${vol}/${p.directoryPath}`);
+            await api(ctx, "DELETE", `api/2.0/fs/directories/Volumes/${pathSegment(cat)}/${pathSegment(sch)}/${pathSegment(vol)}/${pathSegments(p.directoryPath)}`);
             return { success: true };
         },
     });
@@ -178,10 +159,9 @@ export default function databricks(rl) {
             filePath: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
             const [cat, sch, vol] = volumeParts(p.volumePath);
-            await api(host, token, "DELETE", `/api/2.0/fs/files/Volumes/${cat}/${sch}/${vol}/${p.filePath}`);
+            await api(ctx, "DELETE", `api/2.0/fs/files/Volumes/${pathSegment(cat)}/${pathSegment(sch)}/${pathSegment(vol)}/${pathSegments(p.filePath)}`);
             return { success: true };
         },
     });
@@ -197,16 +177,13 @@ export default function databricks(rl) {
             filePath: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
             const [cat, sch, vol] = volumeParts(p.volumePath);
-            const url = `${host}/api/2.0/fs/files/Volumes/${cat}/${sch}/${vol}/${p.filePath}`;
-            const res = await fetch(url, {
+            const res = await credentialOk(ctx, databricksCredential, "databricks", {
+                target: "workspace",
+                path: `api/2.0/fs/files/Volumes/${pathSegment(cat)}/${pathSegment(sch)}/${pathSegment(vol)}/${pathSegments(p.filePath)}`,
                 method: "HEAD",
-                headers: { Authorization: `Bearer ${token}` },
             });
-            if (!res.ok)
-                throw new Error(`Databricks error ${res.status}`);
             return {
                 filePath: p.filePath,
                 contentLength: res.headers.get("content-length"),
@@ -229,16 +206,15 @@ export default function databricks(rl) {
             pageToken: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
             const [cat, sch, vol] = volumeParts(p.volumePath);
-            const dir = p.directoryPath ? `/${p.directoryPath}` : "";
+            const dir = p.directoryPath ? `/${pathSegments(p.directoryPath)}` : "";
             const qs = {};
             if (p.pageSize)
                 qs.page_size = String(p.pageSize);
             if (p.pageToken)
                 qs.page_token = p.pageToken;
-            return api(host, token, "GET", `/api/2.0/fs/directories/Volumes/${cat}/${sch}/${vol}${dir}`, undefined, qs);
+            return api(ctx, "GET", `api/2.0/fs/directories/Volumes/${pathSegment(cat)}/${pathSegment(sch)}/${pathSegment(vol)}${dir}`, undefined, qs);
         },
     });
     // ── Genie ───────────────────────────────────────────
@@ -250,9 +226,8 @@ export default function databricks(rl) {
             initialMessage: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
-            return api(host, token, "POST", `/api/2.0/genie/spaces/${p.spaceId}/start-conversation`, { content: p.initialMessage });
+            return api(ctx, "POST", `api/2.0/genie/spaces/${pathSegment(p.spaceId)}/start-conversation`, { content: p.initialMessage });
         },
     });
     rl.registerAction("genie.createMessage", {
@@ -264,9 +239,8 @@ export default function databricks(rl) {
             message: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
-            return api(host, token, "POST", `/api/2.0/genie/spaces/${p.spaceId}/conversations/${p.conversationId}/messages`, { content: p.message });
+            return api(ctx, "POST", `api/2.0/genie/spaces/${pathSegment(p.spaceId)}/conversations/${pathSegment(p.conversationId)}/messages`, { content: p.message });
         },
     });
     rl.registerAction("genie.getMessage", {
@@ -278,9 +252,8 @@ export default function databricks(rl) {
             messageId: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
-            return api(host, token, "GET", `/api/2.0/genie/spaces/${p.spaceId}/conversations/${p.conversationId}/messages/${p.messageId}`);
+            return api(ctx, "GET", `api/2.0/genie/spaces/${pathSegment(p.spaceId)}/conversations/${pathSegment(p.conversationId)}/messages/${pathSegment(p.messageId)}`);
         },
     });
     rl.registerAction("genie.getQueryResults", {
@@ -293,9 +266,8 @@ export default function databricks(rl) {
             attachmentId: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
-            return api(host, token, "GET", `/api/2.0/genie/spaces/${p.spaceId}/conversations/${p.conversationId}/messages/${p.messageId}/attachments/${p.attachmentId}/query-result`);
+            return api(ctx, "GET", `api/2.0/genie/spaces/${pathSegment(p.spaceId)}/conversations/${pathSegment(p.conversationId)}/messages/${pathSegment(p.messageId)}/attachments/${pathSegment(p.attachmentId)}/query-result`);
         },
     });
     rl.registerAction("genie.executeMessageQuery", {
@@ -308,9 +280,8 @@ export default function databricks(rl) {
             attachmentId: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
-            return api(host, token, "POST", `/api/2.0/genie/spaces/${p.spaceId}/conversations/${p.conversationId}/messages/${p.messageId}/attachments/${p.attachmentId}/execute-query`);
+            return api(ctx, "POST", `api/2.0/genie/spaces/${pathSegment(p.spaceId)}/conversations/${pathSegment(p.conversationId)}/messages/${pathSegment(p.messageId)}/attachments/${pathSegment(p.attachmentId)}/execute-query`);
         },
     });
     rl.registerAction("genie.getSpace", {
@@ -318,8 +289,7 @@ export default function databricks(rl) {
         description: "Get a Genie space",
         inputSchema: { spaceId: { type: "string", required: true } },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
-            return api(host, token, "GET", `/api/2.0/genie/spaces/${input.spaceId}`);
+            return api(ctx, "GET", `api/2.0/genie/spaces/${pathSegment(input.spaceId)}`);
         },
     });
     // ── Model Serving ───────────────────────────────────
@@ -335,10 +305,9 @@ export default function databricks(rl) {
             },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
             const body = p.requestBody;
-            return api(host, token, "POST", `/serving-endpoints/${p.endpointName}/invocations`, body);
+            return api(ctx, "POST", `serving-endpoints/${pathSegment(p.endpointName)}/invocations`, body);
         },
     });
     // ── Unity Catalog: Catalogs ─────────────────────────
@@ -350,12 +319,11 @@ export default function databricks(rl) {
             comment: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
             const body = { name: p.name };
             if (p.comment)
                 body.comment = p.comment;
-            return api(host, token, "POST", "/api/2.1/unity-catalog/catalogs", body);
+            return api(ctx, "POST", "api/2.1/unity-catalog/catalogs", body);
         },
     });
     rl.registerAction("catalog.get", {
@@ -363,8 +331,7 @@ export default function databricks(rl) {
         description: "Get a catalog",
         inputSchema: { name: { type: "string", required: true } },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
-            return api(host, token, "GET", `/api/2.1/unity-catalog/catalogs/${input.name}`);
+            return api(ctx, "GET", `api/2.1/unity-catalog/catalogs/${pathSegment(input.name)}`);
         },
     });
     rl.registerAction("catalog.list", {
@@ -372,8 +339,7 @@ export default function databricks(rl) {
         description: "List all catalogs",
         inputSchema: {},
         async execute(_input, ctx) {
-            const { host, token } = getConn(ctx);
-            return api(host, token, "GET", "/api/2.1/unity-catalog/catalogs");
+            return api(ctx, "GET", "api/2.1/unity-catalog/catalogs");
         },
     });
     rl.registerAction("catalog.update", {
@@ -384,9 +350,8 @@ export default function databricks(rl) {
             comment: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
-            return api(host, token, "PATCH", `/api/2.1/unity-catalog/catalogs/${p.name}`, { comment: p.comment });
+            return api(ctx, "PATCH", `api/2.1/unity-catalog/catalogs/${pathSegment(p.name)}`, { comment: p.comment });
         },
     });
     rl.registerAction("catalog.delete", {
@@ -394,8 +359,7 @@ export default function databricks(rl) {
         description: "Delete a catalog",
         inputSchema: { name: { type: "string", required: true } },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
-            await api(host, token, "DELETE", `/api/2.1/unity-catalog/catalogs/${input.name}`);
+            await api(ctx, "DELETE", `api/2.1/unity-catalog/catalogs/${pathSegment(input.name)}`);
             return { success: true };
         },
     });
@@ -416,7 +380,6 @@ export default function databricks(rl) {
             comment: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
             const body = {
                 catalog_name: p.catalogName,
@@ -430,7 +393,7 @@ export default function databricks(rl) {
                 body.columns = p.columns;
             if (p.comment)
                 body.comment = p.comment;
-            return api(host, token, "POST", "/api/2.1/unity-catalog/tables", body);
+            return api(ctx, "POST", "api/2.1/unity-catalog/tables", body);
         },
     });
     rl.registerAction("table.get", {
@@ -444,8 +407,7 @@ export default function databricks(rl) {
             },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
-            return api(host, token, "GET", `/api/2.1/unity-catalog/tables/${input.fullName}`);
+            return api(ctx, "GET", `api/2.1/unity-catalog/tables/${pathSegment(input.fullName)}`);
         },
     });
     rl.registerAction("table.list", {
@@ -456,14 +418,13 @@ export default function databricks(rl) {
             schemaName: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = (input ?? {});
             const qs = {};
             if (p.catalogName)
                 qs.catalog_name = p.catalogName;
             if (p.schemaName)
                 qs.schema_name = p.schemaName;
-            return api(host, token, "GET", "/api/2.1/unity-catalog/tables", undefined, qs);
+            return api(ctx, "GET", "api/2.1/unity-catalog/tables", undefined, qs);
         },
     });
     rl.registerAction("table.delete", {
@@ -477,8 +438,7 @@ export default function databricks(rl) {
             },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
-            await api(host, token, "DELETE", `/api/2.1/unity-catalog/tables/${input.fullName}`);
+            await api(ctx, "DELETE", `api/2.1/unity-catalog/tables/${pathSegment(input.fullName)}`);
             return { success: true };
         },
     });
@@ -503,7 +463,6 @@ export default function databricks(rl) {
             comment: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
             if (p.volumeType === "EXTERNAL" && !p.storageLocation)
                 throw new Error("storageLocation required for EXTERNAL volumes");
@@ -517,7 +476,7 @@ export default function databricks(rl) {
                 body.storage_location = p.storageLocation;
             if (p.comment)
                 body.comment = p.comment;
-            return api(host, token, "POST", "/api/2.1/unity-catalog/volumes", body);
+            return api(ctx, "POST", "api/2.1/unity-catalog/volumes", body);
         },
     });
     rl.registerAction("volume.get", {
@@ -529,9 +488,8 @@ export default function databricks(rl) {
             volumeName: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
-            return api(host, token, "GET", `/api/2.1/unity-catalog/volumes/${p.catalogName}.${p.schemaName}.${p.volumeName}`);
+            return api(ctx, "GET", `api/2.1/unity-catalog/volumes/${pathSegment(p.catalogName)}.${pathSegment(p.schemaName)}.${pathSegment(p.volumeName)}`);
         },
     });
     rl.registerAction("volume.list", {
@@ -542,14 +500,13 @@ export default function databricks(rl) {
             schemaName: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = (input ?? {});
             const qs = {};
             if (p.catalogName)
                 qs.catalog_name = p.catalogName;
             if (p.schemaName)
                 qs.schema_name = p.schemaName;
-            return api(host, token, "GET", "/api/2.1/unity-catalog/volumes", undefined, qs);
+            return api(ctx, "GET", "api/2.1/unity-catalog/volumes", undefined, qs);
         },
     });
     rl.registerAction("volume.delete", {
@@ -561,9 +518,8 @@ export default function databricks(rl) {
             volumeName: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
-            await api(host, token, "DELETE", `/api/2.1/unity-catalog/volumes/${p.catalogName}.${p.schemaName}.${p.volumeName}`);
+            await api(ctx, "DELETE", `api/2.1/unity-catalog/volumes/${pathSegment(p.catalogName)}.${pathSegment(p.schemaName)}.${pathSegment(p.volumeName)}`);
             return { success: true };
         },
     });
@@ -597,7 +553,6 @@ export default function databricks(rl) {
             },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
             const params = (Array.isArray(p.inputParams)
                 ? p.inputParams
@@ -607,7 +562,7 @@ export default function databricks(rl) {
                 type_text: param.type_text ?? param.type_name,
                 type_json: param.type_json ?? JSON.stringify({ name: param.type_name }),
             }));
-            return api(host, token, "POST", "/api/2.1/unity-catalog/functions", {
+            return api(ctx, "POST", "api/2.1/unity-catalog/functions", {
                 function_info: {
                     name: p.functionName,
                     catalog_name: p.catalogName,
@@ -638,8 +593,7 @@ export default function databricks(rl) {
             },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
-            return api(host, token, "GET", `/api/2.1/unity-catalog/functions/${input.fullName}`);
+            return api(ctx, "GET", `api/2.1/unity-catalog/functions/${pathSegment(input.fullName)}`);
         },
     });
     rl.registerAction("function.list", {
@@ -650,14 +604,13 @@ export default function databricks(rl) {
             schemaName: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = (input ?? {});
             const qs = {};
             if (p.catalogName)
                 qs.catalog_name = p.catalogName;
             if (p.schemaName)
                 qs.schema_name = p.schemaName;
-            return api(host, token, "GET", "/api/2.1/unity-catalog/functions", undefined, qs);
+            return api(ctx, "GET", "api/2.1/unity-catalog/functions", undefined, qs);
         },
     });
     rl.registerAction("function.delete", {
@@ -671,8 +624,7 @@ export default function databricks(rl) {
             },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
-            await api(host, token, "DELETE", `/api/2.1/unity-catalog/functions/${input.fullName}`);
+            await api(ctx, "DELETE", `api/2.1/unity-catalog/functions/${pathSegment(input.fullName)}`);
             return { success: true };
         },
     });
@@ -701,7 +653,6 @@ export default function databricks(rl) {
             },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
             const body = {
                 name: p.indexName,
@@ -713,7 +664,7 @@ export default function databricks(rl) {
                 body.delta_sync_index_spec = p.deltaSyncIndexSpec;
             if (p.indexType === "DIRECT_ACCESS" && p.directAccessIndexSpec)
                 body.direct_access_index_spec = p.directAccessIndexSpec;
-            return api(host, token, "POST", "/api/2.0/vector-search/indexes", body);
+            return api(ctx, "POST", "api/2.0/vector-search/indexes", body);
         },
     });
     rl.registerAction("vectorSearch.getIndex", {
@@ -721,8 +672,7 @@ export default function databricks(rl) {
         description: "Get a vector search index",
         inputSchema: { indexName: { type: "string", required: true } },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
-            return api(host, token, "GET", `/api/2.0/vector-search/indexes/${input.indexName}`);
+            return api(ctx, "GET", `api/2.0/vector-search/indexes/${pathSegment(input.indexName)}`);
         },
     });
     rl.registerAction("vectorSearch.listIndexes", {
@@ -730,8 +680,7 @@ export default function databricks(rl) {
         description: "List vector search indexes for an endpoint",
         inputSchema: { endpointName: { type: "string", required: true } },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
-            return api(host, token, "GET", "/api/2.0/vector-search/indexes", undefined, {
+            return api(ctx, "GET", "api/2.0/vector-search/indexes", undefined, {
                 endpoint_name: input
                     .endpointName,
             });
@@ -775,7 +724,6 @@ export default function databricks(rl) {
             columnsToRerank: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            const { host, token } = getConn(ctx);
             const p = input;
             const body = {
                 num_results: p.numResults ?? 10,
@@ -804,7 +752,7 @@ export default function databricks(rl) {
                     },
                 };
             }
-            return api(host, token, "POST", `/api/2.0/vector-search/indexes/${p.indexName}/query`, body);
+            return api(ctx, "POST", `api/2.0/vector-search/indexes/${pathSegment(p.indexName)}/query`, body);
         },
     });
 }

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

@@ -0,0 +1,19 @@
+import { configChoice, staticCredential } from "../../_shared/credentials.js";
+/**
+ * An authentication key, sent as `Authorization: DeepL-Auth-Key {key}` to
+ * the plan's API host: api.deepl.com for pro, api-free.deepl.com for free
+ * (the default).
+ */
+export const deeplCredential = staticCredential({
+    id: "deepl",
+    auth: { kind: "apiKey", header: "Authorization", prefix: "DeepL-Auth-Key " },
+    local: { secret: "apiKey" },
+    targets: (config) => ({
+        api: {
+            baseUrl: configChoice(config.plan, ["free", "pro"], "free") === "pro"
+                ? "https://api.deepl.com/v2/"
+                : "https://api-free.deepl.com/v2/",
+            methods: ["GET", "POST"],
+        },
+    }),
+});

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

@@ -1,43 +1,19 @@
-async function apiRequest(apiKey, isPro, method, endpoint, params) {
-    const baseUrl = isPro
-        ? "https://api.deepl.com/v2"
-        : "https://api-free.deepl.com/v2";
-    const url = new URL(`${baseUrl}${endpoint}`);
-    const opts = {
+import { credentialJson } from "../../_shared/credentials.js";
+import { deeplCredential } from "./credentials.js";
+async function apiRequest(ctx, method, endpoint, params) {
+    const given = Object.values(params ?? {}).some((v) => v !== undefined && v !== null);
+    // DeepL takes form-encoded bodies, not JSON.
+    return credentialJson(ctx, deeplCredential, "deepl", {
+        target: "api",
+        path: endpoint,
         method,
-        headers: {
-            Authorization: `DeepL-Auth-Key ${apiKey}`,
-            "Content-Type": "application/x-www-form-urlencoded",
-        },
-    };
-    if (params && Object.keys(params).length > 0) {
-        if (method === "GET") {
-            for (const [k, v] of Object.entries(params)) {
-                if (v !== undefined && v !== null)
-                    url.searchParams.set(k, String(v));
-            }
-        }
-        else {
-            opts.body = new URLSearchParams(Object.entries(params)
-                .filter(([, v]) => v !== undefined && v !== null)
-                .map(([k, v]) => [k, String(v)])).toString();
-        }
-    }
-    const res = await fetch(url.toString(), opts);
-    if (!res.ok)
-        throw new Error(`DeepL API error ${res.status}: ${await res.text()}`);
-    return res.json();
-}
-function getConn(ctx) {
-    const cfg = ctx.connection.config;
-    return {
-        apiKey: cfg.apiKey,
-        isPro: cfg.plan === "pro",
-    };
+        ...(method === "GET" ? { query: params } : given ? { form: params } : {}),
+    });
 }
 export default function deepl(rl) {
     rl.setName("deepl");
     rl.setVersion("0.1.0");
+    rl.setCredential(deeplCredential);
     rl.setConnectionSchema({
         apiKey: {
             type: "string",
@@ -75,7 +51,6 @@ export default function deepl(rl) {
         },
         async execute(input, ctx) {
             const { text, targetLang, sourceLang } = input;
-            const { apiKey, isPro } = getConn(ctx);
             const params = {
                 text,
                 target_lang: targetLang,
@@ -85,7 +60,7 @@ export default function deepl(rl) {
                     ? "EN"
                     : sourceLang;
             }
-            const data = (await apiRequest(apiKey, isPro, "POST", "/translate", params));
+            const data = (await apiRequest(ctx, "POST", "translate", params));
             const translations = data.translations;
             return translations?.[0] ?? data;
         },
@@ -102,8 +77,7 @@ export default function deepl(rl) {
         },
         async execute(input, ctx) {
             const { type = "target" } = (input ?? {});
-            const { apiKey, isPro } = getConn(ctx);
-            return apiRequest(apiKey, isPro, "GET", "/languages", { type });
+            return apiRequest(ctx, "GET", "languages", { type });
         },
     });
 }

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

@@ -0,0 +1,26 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/** An API key and secret, sent as the Api-Key and Api-Secret headers to Demio's one API origin. */
+export const demioCredential = staticCredential({
+    id: "demio",
+    auth: {
+        kind: "static",
+        parts: ["key", "secret"],
+        placements: [
+            { in: "header", part: "key", name: "Api-Key" },
+            { in: "header", part: "secret", name: "Api-Secret" },
+        ],
+    },
+    local: { key: "apiKey", secret: "apiSecret" },
+    targets: {
+        api: {
+            baseUrl: "https://my.demio.com/api/v1/",
+            methods: ["GET", "PUT"],
+        },
+    },
+    probe: {
+        target: "api",
+        path: "ping",
+        method: "GET",
+        acceptedStatuses: [200],
+    },
+});