runline 0.33.0 → 0.34.0

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

@@ -1,35 +1,22 @@
-const BASE = "https://onfleet.com/api/v2";
-async function apiRequest(apiKey, method, endpoint, body, qs) {
-    const url = new URL(`${BASE}/${endpoint}`);
-    if (qs) {
-        for (const [k, v] of Object.entries(qs)) {
-            if (v !== undefined && v !== null)
-                url.searchParams.set(k, String(v));
-        }
-    }
-    const init = {
+import { credentialJson, pathSegment } from "../../_shared/credentials.js";
+import { onfleetCredential } from "./credentials.js";
+function apiRequest(ctx, method, path, body, qs) {
+    return credentialJson(ctx, onfleetCredential, "onfleet", {
+        target: "api",
+        path,
         method,
-        headers: {
-            Authorization: `Basic ${btoa(`${apiKey}:`)}`,
-            "Content-Type": "application/json",
-            "User-Agent": "runline-onfleet",
-        },
-    };
-    if (body !== undefined && method !== "GET")
-        init.body = JSON.stringify(body);
-    const res = await fetch(url.toString(), init);
-    if (!res.ok)
-        throw new Error(`Onfleet error ${res.status}: ${await res.text()}`);
-    const text = await res.text();
-    return text ? JSON.parse(text) : {};
+        query: qs,
+        headers: { "User-Agent": "runline-onfleet" },
+        ...(body !== undefined && method !== "GET" ? { json: body } : {}),
+    });
 }
-function registerCrud(rl, resource, plural, key, createSchema) {
+function registerCrud(rl, resource, plural, createSchema) {
     rl.registerAction(`${resource}.create`, {
         access: "write",
         description: `Create a ${resource}`,
         inputSchema: createSchema,
         async execute(input, ctx) {
-            return apiRequest(key(ctx), "POST", plural, input);
+            return apiRequest(ctx, "POST", plural, input);
         },
     });
     rl.registerAction(`${resource}.get`, {
@@ -37,7 +24,7 @@ function registerCrud(rl, resource, plural, key, createSchema) {
         description: `Get a ${resource} by ID`,
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            return apiRequest(key(ctx), "GET", `${plural}/${input.id}`);
+            return apiRequest(ctx, "GET", `${plural}/${pathSegment(input.id)}`);
         },
     });
     rl.registerAction(`${resource}.list`, {
@@ -45,7 +32,7 @@ function registerCrud(rl, resource, plural, key, createSchema) {
         description: `List ${plural}`,
         inputSchema: { limit: { type: "number", required: false } },
         async execute(input, ctx) {
-            const data = (await apiRequest(key(ctx), "GET", plural));
+            const data = (await apiRequest(ctx, "GET", plural));
             const p = (input ?? {});
             return p.limit ? data.slice(0, p.limit) : data;
         },
@@ -59,7 +46,7 @@ function registerCrud(rl, resource, plural, key, createSchema) {
         },
         async execute(input, ctx) {
             const p = input;
-            return apiRequest(key(ctx), "PUT", `${plural}/${p.id}`, p.data);
+            return apiRequest(ctx, "PUT", `${plural}/${pathSegment(p.id)}`, p.data);
         },
     });
     rl.registerAction(`${resource}.delete`, {
@@ -67,7 +54,7 @@ function registerCrud(rl, resource, plural, key, createSchema) {
         description: `Delete a ${resource}`,
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            await apiRequest(key(ctx), "DELETE", `${plural}/${input.id}`);
+            await apiRequest(ctx, "DELETE", `${plural}/${pathSegment(input.id)}`);
             return { success: true };
         },
     });
@@ -75,6 +62,7 @@ function registerCrud(rl, resource, plural, key, createSchema) {
 export default function onfleet(rl) {
     rl.setName("onfleet");
     rl.setVersion("0.1.0");
+    rl.setCredential(onfleetCredential);
     rl.setConnectionSchema({
         apiKey: {
             type: "string",
@@ -83,14 +71,13 @@ export default function onfleet(rl) {
             env: "ONFLEET_API_KEY",
         },
     });
-    const key = (ctx) => ctx.connection.config.apiKey;
     // ── Organization ────────────────────────────────────
     rl.registerAction("organization.get", {
         access: "read",
         description: "Get organization details",
         inputSchema: {},
         async execute(_input, ctx) {
-            return apiRequest(key(ctx), "GET", "organization");
+            return apiRequest(ctx, "GET", "organization");
         },
     });
     // ── Task ────────────────────────────────────────────
@@ -121,7 +108,7 @@ export default function onfleet(rl) {
             notes: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            return apiRequest(key(ctx), "POST", "tasks", input);
+            return apiRequest(ctx, "POST", "tasks", input);
         },
     });
     rl.registerAction("task.get", {
@@ -130,8 +117,10 @@ export default function onfleet(rl) {
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
             const id = input.id;
-            const path = id.length <= 8 ? `tasks/shortId/${id}` : `tasks/${id}`;
-            return apiRequest(key(ctx), "GET", path);
+            const path = id.length <= 8
+                ? `tasks/shortId/${pathSegment(id)}`
+                : `tasks/${pathSegment(id)}`;
+            return apiRequest(ctx, "GET", path);
         },
     });
     rl.registerAction("task.list", {
@@ -151,7 +140,7 @@ export default function onfleet(rl) {
                 qs.from = Date.now() - 604800000;
             if (p.to)
                 qs.to = p.to;
-            const data = (await apiRequest(key(ctx), "GET", "tasks/all", undefined, qs));
+            const data = (await apiRequest(ctx, "GET", "tasks/all", undefined, qs));
             const tasks = data.tasks;
             return p.limit ? tasks.slice(0, p.limit) : tasks;
         },
@@ -165,7 +154,7 @@ export default function onfleet(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            return apiRequest(key(ctx), "PUT", `tasks/${p.id}`, p.data);
+            return apiRequest(ctx, "PUT", `tasks/${pathSegment(p.id)}`, p.data);
         },
     });
     rl.registerAction("task.delete", {
@@ -173,7 +162,7 @@ export default function onfleet(rl) {
         description: "Delete a task",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            await apiRequest(key(ctx), "DELETE", `tasks/${input.id}`);
+            await apiRequest(ctx, "DELETE", `tasks/${pathSegment(input.id)}`);
             return { success: true };
         },
     });
@@ -192,18 +181,18 @@ export default function onfleet(rl) {
             };
             if (p.notes)
                 body.completionDetails.notes = p.notes;
-            await apiRequest(key(ctx), "POST", `tasks/${p.id}/complete`, body);
+            await apiRequest(ctx, "POST", `tasks/${pathSegment(p.id)}/complete`, body);
             return { success: true };
         },
     });
     // ── Worker ──────────────────────────────────────────
-    registerCrud(rl, "worker", "workers", key, {
+    registerCrud(rl, "worker", "workers", {
         name: { type: "string", required: true },
         phone: { type: "string", required: true },
         teams: { type: "object", required: true, description: "Array of team IDs" },
     });
     // ── Admin ───────────────────────────────────────────
-    registerCrud(rl, "admin", "admins", key, {
+    registerCrud(rl, "admin", "admins", {
         name: { type: "string", required: true },
         email: { type: "string", required: true },
     });
@@ -216,7 +205,7 @@ export default function onfleet(rl) {
             address: { type: "object", required: true },
         },
         async execute(input, ctx) {
-            return apiRequest(key(ctx), "POST", "hubs", input);
+            return apiRequest(ctx, "POST", "hubs", input);
         },
     });
     rl.registerAction("hub.list", {
@@ -224,7 +213,7 @@ export default function onfleet(rl) {
         description: "List hubs",
         inputSchema: { limit: { type: "number", required: false } },
         async execute(input, ctx) {
-            const data = (await apiRequest(key(ctx), "GET", "hubs"));
+            const data = (await apiRequest(ctx, "GET", "hubs"));
             const p = (input ?? {});
             return p.limit ? data.slice(0, p.limit) : data;
         },
@@ -238,11 +227,11 @@ export default function onfleet(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            return apiRequest(key(ctx), "PUT", `hubs/${p.id}`, p.data);
+            return apiRequest(ctx, "PUT", `hubs/${pathSegment(p.id)}`, p.data);
         },
     });
     // ── Team ────────────────────────────────────────────
-    registerCrud(rl, "team", "teams", key, {
+    registerCrud(rl, "team", "teams", {
         name: { type: "string", required: true },
         workers: {
             type: "object",
@@ -265,7 +254,7 @@ export default function onfleet(rl) {
             notes: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            return apiRequest(key(ctx), "POST", "recipients", input);
+            return apiRequest(ctx, "POST", "recipients", input);
         },
     });
     rl.registerAction("recipient.get", {
@@ -273,7 +262,7 @@ export default function onfleet(rl) {
         description: "Get a recipient by ID",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            return apiRequest(key(ctx), "GET", `recipients/${input.id}`);
+            return apiRequest(ctx, "GET", `recipients/${pathSegment(input.id)}`);
         },
     });
     rl.registerAction("recipient.update", {
@@ -285,7 +274,7 @@ export default function onfleet(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            return apiRequest(key(ctx), "PUT", `recipients/${p.id}`, p.data);
+            return apiRequest(ctx, "PUT", `recipients/${pathSegment(p.id)}`, p.data);
         },
     });
     // ── Container ────────────────────────────────────────
@@ -302,7 +291,7 @@ export default function onfleet(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            return apiRequest(key(ctx), "GET", `containers/${p.containerType}/${p.containerId}`);
+            return apiRequest(ctx, "GET", `containers/${pathSegment(p.containerType)}/${pathSegment(p.containerId)}`);
         },
     });
     rl.registerAction("container.updateTasks", {
@@ -323,7 +312,7 @@ export default function onfleet(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            return apiRequest(key(ctx), "PUT", `containers/${p.containerType}/${p.containerId}`, { tasks: p.tasks });
+            return apiRequest(ctx, "PUT", `containers/${pathSegment(p.containerType)}/${pathSegment(p.containerId)}`, { tasks: p.tasks });
         },
     });
     rl.registerAction("team.getTimeEstimates", {
@@ -344,7 +333,7 @@ export default function onfleet(rl) {
         },
         async execute(input, ctx) {
             const { id, ...qs } = input;
-            return apiRequest(key(ctx), "GET", `teams/${id}/estimate`, undefined, qs);
+            return apiRequest(ctx, "GET", `teams/${pathSegment(id)}/estimate`, undefined, qs);
         },
     });
     rl.registerAction("team.autoDispatch", {
@@ -356,7 +345,7 @@ export default function onfleet(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            return apiRequest(key(ctx), "POST", `teams/${p.id}/dispatch`, p.data ?? {});
+            return apiRequest(ctx, "POST", `teams/${pathSegment(p.id)}/dispatch`, p.data ?? {});
         },
     });
     // ── Destination ─────────────────────────────────────
@@ -371,7 +360,7 @@ export default function onfleet(rl) {
             },
         },
         async execute(input, ctx) {
-            return apiRequest(key(ctx), "POST", "destinations", input);
+            return apiRequest(ctx, "POST", "destinations", input);
         },
     });
     rl.registerAction("destination.get", {
@@ -379,7 +368,7 @@ export default function onfleet(rl) {
         description: "Get a destination by ID",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            return apiRequest(key(ctx), "GET", `destinations/${input.id}`);
+            return apiRequest(ctx, "GET", `destinations/${pathSegment(input.id)}`);
         },
     });
 }

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

@@ -0,0 +1,13 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/** An API key, sent as a bearer to OpenAI's images API base. */
+export const openaiCredential = staticCredential({
+    id: "openai",
+    auth: { kind: "bearer" },
+    local: { secret: "apiKey" },
+    targets: {
+        api: {
+            baseUrl: "https://api.openai.com/v1/images/",
+            methods: ["POST"],
+        },
+    },
+});

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

@@ -15,9 +15,9 @@
  *   const { images } = await openai.image.create({ prompt: "a red bicycle on snow" })
  *   // images[0].path -> "/tmp/openai-image-….png"
  */
+import { credentialJson, multipartBody } from "../../_shared/credentials.js";
 import { readImageInput, SEND_FILE_NOTE, writeImageFile, } from "../../_shared/mediaFile.js";
-const ENDPOINT = "https://api.openai.com/v1/images/generations";
-const EDIT_ENDPOINT = "https://api.openai.com/v1/images/edits";
+import { openaiCredential } from "./credentials.js";
 /**
  * Newest GPT Image model; override per call or via the connection.
  *
@@ -50,6 +50,7 @@ function resolveModel(explicit, config) {
 export default function openai(rl) {
     rl.setName("openai");
     rl.setVersion("0.1.0");
+    rl.setCredential(openaiCredential);
     rl.setConnectionSchema({
         apiKey: {
             type: "string",
@@ -109,7 +110,6 @@ export default function openai(rl) {
             if (typeof p.prompt !== "string" || p.prompt.length === 0) {
                 throw new Error("openai: prompt is required");
             }
-            const apiKey = ctx.connection.config.apiKey;
             const model = resolveModel(p.model, ctx.connection.config);
             const body = {
                 model,
@@ -129,18 +129,12 @@ export default function openai(rl) {
                 body.quality = p.quality;
             if (p.style)
                 body.style = p.style;
-            const res = await fetch(ENDPOINT, {
+            const data = (await credentialJson(ctx, openaiCredential, "openai", {
+                target: "api",
+                path: "generations",
                 method: "POST",
-                headers: {
-                    "Content-Type": "application/json",
-                    Authorization: `Bearer ${apiKey}`,
-                },
-                body: JSON.stringify(body),
-            });
-            if (!res.ok) {
-                throw new Error(`OpenAI API error ${res.status}: ${await res.text()}`);
-            }
-            const data = (await res.json());
+                json: body,
+            }));
             const stamp = Date.now();
             const images = (data.data ?? []).map((d, i) => ({
                 ...writeImageFile({
@@ -214,7 +208,6 @@ export default function openai(rl) {
             if (paths.length === 0) {
                 throw new Error("openai: imagePath (or imagePaths) is required");
             }
-            const apiKey = ctx.connection.config.apiKey;
             const model = resolveModel(p.model, ctx.connection.config);
             const form = new FormData();
             form.append("model", model);
@@ -228,15 +221,14 @@ export default function openai(rl) {
                 const img = readImageInput(path, "openai");
                 form.append("image[]", new Blob([img.bytes], { type: img.mimeType }), img.fileName);
             }
-            const res = await fetch(EDIT_ENDPOINT, {
+            const { body: formBytes, contentType } = await multipartBody(form);
+            const data = (await credentialJson(ctx, openaiCredential, "openai", {
+                target: "api",
+                path: "edits",
                 method: "POST",
-                headers: { Authorization: `Bearer ${apiKey}` },
-                body: form,
-            });
-            if (!res.ok) {
-                throw new Error(`OpenAI API error ${res.status}: ${await res.text()}`);
-            }
-            const data = (await res.json());
+                body: formBytes,
+                headers: { "Content-Type": contentType },
+            }));
             const stamp = Date.now();
             const images = (data.data ?? []).map((d, i) => ({
                 ...writeImageFile({

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

@@ -0,0 +1,16 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/**
+ * An API key, appended by the transport as the APPID query parameter on
+ * OpenWeatherMap's data API.
+ */
+export const openweathermapCredential = staticCredential({
+    id: "openweathermap",
+    auth: { kind: "queryKey", param: "APPID" },
+    local: { secret: "apiKey" },
+    targets: {
+        api: {
+            baseUrl: "https://api.openweathermap.org/data/2.5/",
+            methods: ["GET"],
+        },
+    },
+});

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

@@ -1,4 +1,5 @@
-const BASE = "https://api.openweathermap.org/data/2.5";
+import { credentialJson } from "../../_shared/credentials.js";
+import { openweathermapCredential } from "./credentials.js";
 const locationSchema = {
     cityName: {
         type: "string",
@@ -28,27 +29,35 @@ const locationSchema = {
         description: "Language code (e.g. en, de)",
     },
 };
-function buildQs(apiKey, input) {
-    const qs = new URLSearchParams();
-    qs.set("APPID", apiKey);
-    qs.set("units", input.units ?? "metric");
+function buildQs(input) {
+    const qs = {
+        units: input.units ?? "metric",
+    };
     if (input.cityName)
-        qs.set("q", input.cityName);
+        qs.q = input.cityName;
     else if (input.cityId)
-        qs.set("id", String(input.cityId));
+        qs.id = String(input.cityId);
     else if (input.lat && input.lon) {
-        qs.set("lat", input.lat);
-        qs.set("lon", input.lon);
+        qs.lat = input.lat;
+        qs.lon = input.lon;
     }
     else if (input.zip)
-        qs.set("zip", input.zip);
+        qs.zip = input.zip;
     if (input.lang)
-        qs.set("lang", input.lang);
+        qs.lang = input.lang;
     return qs;
 }
+function apiRequest(ctx, path, query) {
+    return credentialJson(ctx, openweathermapCredential, "openweathermap", {
+        target: "api",
+        path,
+        query,
+    });
+}
 export default function openWeatherMap(rl) {
     rl.setName("openweathermap");
     rl.setVersion("0.1.0");
+    rl.setCredential(openweathermapCredential);
     rl.setConnectionSchema({
         apiKey: {
             type: "string",
@@ -57,18 +66,13 @@ export default function openWeatherMap(rl) {
             env: "OPENWEATHERMAP_API_KEY",
         },
     });
-    const key = (ctx) => ctx.connection.config.apiKey;
     rl.registerAction("weather.current", {
         access: "read",
         description: "Get current weather data for a location",
         inputSchema: locationSchema,
         async execute(input, ctx) {
             const p = (input ?? {});
-            const qs = buildQs(key(ctx), p);
-            const res = await fetch(`${BASE}/weather?${qs.toString()}`);
-            if (!res.ok)
-                throw new Error(`OpenWeatherMap error ${res.status}: ${await res.text()}`);
-            return res.json();
+            return apiRequest(ctx, "weather", buildQs(p));
         },
     });
     rl.registerAction("weather.forecast5day", {
@@ -77,11 +81,7 @@ export default function openWeatherMap(rl) {
         inputSchema: locationSchema,
         async execute(input, ctx) {
             const p = (input ?? {});
-            const qs = buildQs(key(ctx), p);
-            const res = await fetch(`${BASE}/forecast?${qs.toString()}`);
-            if (!res.ok)
-                throw new Error(`OpenWeatherMap error ${res.status}: ${await res.text()}`);
-            return res.json();
+            return apiRequest(ctx, "forecast", buildQs(p));
         },
     });
 }

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

@@ -0,0 +1,19 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/** A personal access token, sent as a bearer to Oura's one API origin. */
+export const ouraCredential = staticCredential({
+    id: "oura",
+    auth: { kind: "bearer" },
+    local: { secret: "accessToken" },
+    targets: {
+        api: {
+            baseUrl: "https://api.ouraring.com/v2/",
+            methods: ["GET"],
+        },
+    },
+    probe: {
+        target: "api",
+        path: "usercollection/personal_info",
+        method: "GET",
+        acceptedStatuses: [200],
+    },
+});

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

@@ -1,16 +1,11 @@
-const BASE = "https://api.ouraring.com/v2";
-async function apiRequest(token, endpoint, qs = {}) {
-    const url = new URL(`${BASE}${endpoint}`);
-    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(), {
-        headers: { Authorization: `Bearer ${token}` },
+import { credentialJson } from "../../_shared/credentials.js";
+import { ouraCredential } from "./credentials.js";
+function apiRequest(ctx, endpoint, qs = {}) {
+    return credentialJson(ctx, ouraCredential, "oura", {
+        target: "api",
+        path: endpoint,
+        query: qs,
     });
-    if (!res.ok)
-        throw new Error(`Oura API error ${res.status}: ${await res.text()}`);
-    return res.json();
 }
 function formatDate(d) {
     if (!d)
@@ -20,6 +15,7 @@ function formatDate(d) {
 export default function oura(rl) {
     rl.setName("oura");
     rl.setVersion("0.1.0");
+    rl.setCredential(ouraCredential);
     rl.setConnectionSchema({
         accessToken: {
             type: "string",
@@ -28,29 +24,28 @@ export default function oura(rl) {
             env: "OURA_ACCESS_TOKEN",
         },
     });
-    const key = (ctx) => ctx.connection.config.accessToken;
     rl.registerAction("profile.get", {
         access: "read",
         description: "Get the user's personal information",
         inputSchema: {},
         async execute(_input, ctx) {
-            return apiRequest(key(ctx), "/usercollection/personal_info");
+            return apiRequest(ctx, "usercollection/personal_info");
         },
     });
     const summaryEndpoints = [
         {
             name: "summary.activity",
-            path: "/usercollection/daily_activity",
+            path: "usercollection/daily_activity",
             description: "Get daily activity summary",
         },
         {
             name: "summary.readiness",
-            path: "/usercollection/daily_readiness",
+            path: "usercollection/daily_readiness",
             description: "Get daily readiness summary",
         },
         {
             name: "summary.sleep",
-            path: "/usercollection/daily_sleep",
+            path: "usercollection/daily_sleep",
             description: "Get daily sleep summary",
         },
     ];
@@ -82,7 +77,7 @@ export default function oura(rl) {
                     qs.start_date = formatDate(p.startDate);
                 if (p.endDate)
                     qs.end_date = formatDate(p.endDate);
-                const data = (await apiRequest(key(ctx), ep.path, qs));
+                const data = (await apiRequest(ctx, ep.path, qs));
                 let items = (data.data ?? []);
                 if (p.limit)
                     items = items.slice(0, p.limit);

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

@@ -0,0 +1,27 @@
+import { configFlag, staticCredential } from "../../_shared/credentials.js";
+/**
+ * The vendor ID and auth code, added by the transport as the vendor_id and
+ * vendor_auth_code fields of every JSON call. Stored together, so a code
+ * is never sent under another vendor. `sandbox` selects Paddle's sandbox
+ * host.
+ */
+export const paddleCredential = staticCredential({
+    id: "paddle",
+    auth: {
+        kind: "static",
+        parts: ["vendorId", "authCode"],
+        placements: [
+            { in: "body", part: "vendorId", name: "vendor_id" },
+            { in: "body", part: "authCode", name: "vendor_auth_code" },
+        ],
+    },
+    local: { vendorId: "vendorId", authCode: "vendorAuthCode" },
+    targets: (config) => ({
+        api: {
+            baseUrl: configFlag(config.sandbox)
+                ? "https://sandbox-vendors.paddle.com/api/"
+                : "https://vendors.paddle.com/api/",
+            methods: ["POST"],
+        },
+    }),
+});