runline 0.32.0 → 0.34.0

package/dist/plugins/shiftCrm/src/shared.js

@@ -1,6 +1,7 @@
 import * as t from "typebox";
 import { cursorSchema, enumSchema, idSchema, timestampSchema, } from "../../_shared/shiftCloud.js";
-export { enumSchema, idSchema, listParams, pathSegment, request, STRICT_OBJECT, STRICT_UPDATE_OBJECT, timestampSchema, withQuery, } from "../../_shared/shiftCloud.js";
+export { enumSchema, idSchema, pathSegment, STRICT_OBJECT, STRICT_UPDATE_OBJECT, timestampSchema, } from "../../_shared/shiftCloud.js";
+export { request } from "./credentials.js";
 export const CRM_BASE = "/v1/crm";
 export const CRM_ACCESS_ROLE = ["user", "admin"];
 export const CRM_RECORD_TYPE = [

package/dist/plugins/shiftCrm/src/tasks.js

@@ -1,5 +1,5 @@
 import * as t from "typebox";
-import { CRM_BASE, CRM_TASK_PRIORITY, CRM_TASK_STATUS, createRecordFields, enumSchema, idSchema, listParams, nullableTimestamp, paginationFields, pathSegment, request, STRICT_OBJECT, STRICT_UPDATE_OBJECT, timestampSchema, updateRecordFields, withQuery, } from "./shared.js";
+import { CRM_BASE, CRM_TASK_PRIORITY, CRM_TASK_STATUS, createRecordFields, enumSchema, idSchema, nullableTimestamp, paginationFields, pathSegment, request, STRICT_OBJECT, STRICT_UPDATE_OBJECT, timestampSchema, updateRecordFields, } from "./shared.js";
 const taskListFields = {
     linkedRecordId: t.Optional(idSchema("Filter by linked CRM record ID")),
     status: t.Optional(enumSchema("Task status", CRM_TASK_STATUS)),
@@ -12,7 +12,7 @@ export function registerTaskActions(rl) {
         description: "List the first page of CRM tasks.",
         inputSchema: t.Object(taskListFields, STRICT_OBJECT),
         async execute(input, ctx) {
-            const body = await request(ctx, withQuery(`${CRM_BASE}/tasks`, listParams(input)));
+            const body = await request(ctx, `${CRM_BASE}/tasks`, { query: input });
             return body.tasks;
         },
     });
@@ -21,7 +21,7 @@ export function registerTaskActions(rl) {
         description: "List a cursor-paginated page of CRM tasks.",
         inputSchema: t.Object(taskListFields, STRICT_OBJECT),
         async execute(input, ctx) {
-            return request(ctx, withQuery(`${CRM_BASE}/tasks`, listParams(input)));
+            return request(ctx, `${CRM_BASE}/tasks`, { query: input });
         },
     });
     rl.registerAction("task.get", {

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

@@ -0,0 +1,2 @@
+import { shiftClient } from "../../_shared/shiftCredentials.js";
+export const { credential: shiftObjectsCredential, request } = shiftClient("shiftObjects");

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

@@ -1,4 +1,5 @@
 import * as t from "typebox";
+import { shiftObjectsCredential } from "./credentials.js";
 import { registerObjectActions } from "./objects.js";
 /**
  * Shift Objects — the organization's durable object bucket in the
@@ -10,6 +11,7 @@ import { registerObjectActions } from "./objects.js";
 export default function shiftObjects(rl) {
     rl.setName("shiftObjects");
     rl.setVersion("0.1.0");
+    rl.setCredential(shiftObjectsCredential);
     rl.setConnectionSchema(t.Object({
         apiKey: t.String({
             description: "Shift Labs API key",

package/dist/plugins/shiftObjects/src/objects.js

@@ -1,8 +1,9 @@
 import { writeFile } from "node:fs/promises";
 import { basename } from "node:path";
 import * as t from "typebox";
-import { enumSchema, listParams, pathSegment, request, withQuery, } from "../../_shared/shiftCloud.js";
+import { enumSchema, pathSegment, STRICT_OBJECT, } from "../../_shared/shiftCloud.js";
 import { GENERAL_MEDIA_TYPES, mediaTypeFromPath, putThroughGrant, SIGNED_UPLOAD_MAX_BYTES, statUploadFile, } from "../../_shared/shiftUpload.js";
+import { request } from "./credentials.js";
 const OBJECTS_BASE = "/v1/services/objects";
 export const OBJECT_STATUS = ["pending_upload", "ready", "archived"];
 export const OBJECT_LINK_TARGET = [
@@ -11,7 +12,6 @@ export const OBJECT_LINK_TARGET = [
     "eval_case",
     "db_record",
 ];
-const STRICT_OBJECT = { additionalProperties: false };
 const Id = t.String({ minLength: 1, pattern: "\\S" });
 function linkSchema() {
     return t.Object({
@@ -98,7 +98,7 @@ export function registerObjectActions(rl) {
             ...provenanceFields,
         }, STRICT_OBJECT),
         async execute(input, ctx) {
-            const body = await request(ctx, withQuery(`${OBJECTS_BASE}/objects`, listParams(input)));
+            const body = await request(ctx, `${OBJECTS_BASE}/objects`, { query: input });
             return body.objects;
         },
     });

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

@@ -0,0 +1,8 @@
+import { shiftClient } from "../../_shared/shiftCredentials.js";
+/**
+ * Extraction runs synchronously; a long multi-page PDF takes minutes, not
+ * seconds. The target declares that deadline so the transport holds the
+ * request open for the whole extraction.
+ */
+export const EXTRACT_TIMEOUT_MS = 5 * 60_000;
+export const { credential: shiftOcrCredential, request } = shiftClient("shiftOcr", { timeoutMs: EXTRACT_TIMEOUT_MS });

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

@@ -1,8 +1,9 @@
 import { readFile } from "node:fs/promises";
 import { basename, extname } from "node:path";
 import * as t from "typebox";
-import { request, STRICT_OBJECT } from "../../_shared/shiftCloud.js";
+import { pathSegment, STRICT_OBJECT, } from "../../_shared/shiftCloud.js";
 import { putThroughGrant, SIGNED_UPLOAD_MAX_BYTES, statUploadFile, } from "../../_shared/shiftUpload.js";
+import { request, shiftOcrCredential } from "./credentials.js";
 /**
  * Shift OCR — text and structured-field extraction from images and
  * PDFs through the Shift cloud OCR service. The API key is the tenant
@@ -59,7 +60,7 @@ async function documentFromPath(ctx, path) {
         }),
     });
     await putThroughGrant(created.upload, path, mediaType, sizeBytes);
-    await request(ctx, `/v1/services/objects/objects/${created.object.id}/complete`, { method: "POST" });
+    await request(ctx, `/v1/services/objects/objects/${pathSegment(created.object.id)}/complete`, { method: "POST" });
     return { type: "object", objectId: created.object.id };
 }
 function documentFromUrl(url, kind) {
@@ -79,6 +80,7 @@ function documentFromUrl(url, kind) {
 export default function shiftOcr(rl) {
     rl.setName("shiftOcr");
     rl.setVersion("0.1.0");
+    rl.setCredential(shiftOcrCredential);
     rl.setConnectionSchema(t.Object({
         // Same Shift Labs API key as the shiftLabs plugin; the cloud
         // derives the organization from it, so no org ID is needed.
@@ -158,6 +160,7 @@ export default function shiftOcr(rl) {
                 : fields.path
                     ? await documentFromPath(ctx, fields.path)
                     : documentFromUrl(fields.url, fields.kind);
+            // The target's declared EXTRACT_TIMEOUT_MS covers the synchronous run.
             return await request(ctx, "/v1/services/ocr/extract", {
                 method: "POST",
                 body: JSON.stringify({

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

@@ -1,5 +1,6 @@
 import * as t from "typebox";
 import { registerPageActions } from "./pages.js";
+import { shiftPagesCredential } from "./shared.js";
 /**
  * Shift Pages — hosted HTML pages in the Shift cloud: draft, publish,
  * archive, share with invited viewers, and resolve authenticated
@@ -9,6 +10,7 @@ import { registerPageActions } from "./pages.js";
 export default function shiftPages(rl) {
     rl.setName("shiftPages");
     rl.setVersion("0.1.0");
+    rl.setCredential(shiftPagesCredential);
     rl.setConnectionSchema(t.Object({
         apiKey: t.String({
             description: "Shift Labs API key",

package/dist/plugins/shiftPages/src/pages.js

@@ -1,5 +1,5 @@
 import * as t from "typebox";
-import { enumSchema, idSchema, listParams, PAGE_STATUS, PAGE_TYPE, PAGE_VISIBILITY, pageRenderUrl, pathSegment, request, STRICT_OBJECT, timestampSchema, withQuery, } from "./shared.js";
+import { enumSchema, idSchema, PAGE_STATUS, PAGE_TYPE, PAGE_VISIBILITY, pageRenderUrl, pathSegment, request, STRICT_OBJECT, timestampSchema, } from "./shared.js";
 const PageSlug = t.String({
     minLength: 1,
     maxLength: 120,
@@ -26,7 +26,9 @@ export function registerPageActions(rl) {
             })),
         }, STRICT_OBJECT),
         async execute(input, ctx) {
-            const body = await request(ctx, withQuery("/v1/pages", listParams(input)));
+            const body = await request(ctx, "/v1/pages", {
+                query: input,
+            });
             return body.pages;
         },
     });
@@ -48,7 +50,7 @@ export function registerPageActions(rl) {
             "deployment must belong to the API key's organization.",
         inputSchema: t.Object({ deploymentId: idSchema("Managed Vex deployment ID") }, STRICT_OBJECT),
         async execute(input, ctx) {
-            const body = await request(ctx, withQuery("/v1/pages/vex-artifacts", listParams(input)));
+            const body = await request(ctx, "/v1/pages/vex-artifacts", { query: input });
             return body.artifacts;
         },
     });

package/dist/plugins/shiftPages/src/shared.js

@@ -1,5 +1,7 @@
 import { baseUrl, pathSegment } from "../../_shared/shiftCloud.js";
-export { enumSchema, idSchema, listParams, pathSegment, request, STRICT_OBJECT, timestampSchema, withQuery, } from "../../_shared/shiftCloud.js";
+import { shiftClient } from "../../_shared/shiftCredentials.js";
+export { enumSchema, idSchema, pathSegment, STRICT_OBJECT, timestampSchema, } from "../../_shared/shiftCloud.js";
+export const { credential: shiftPagesCredential, request } = shiftClient("shiftPages");
 export const PAGE_STATUS = ["draft", "published", "archived"];
 export const PAGE_TYPE = [
     "hosted_html",

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

@@ -1,4 +1,5 @@
 import * as t from "typebox";
+import { shiftTranscriptionCredential } from "./shared.js";
 import { registerTranscriptionActions } from "./transcription.js";
 /**
  * Shift Transcription — audio and video transcription through the
@@ -10,6 +11,7 @@ import { registerTranscriptionActions } from "./transcription.js";
 export default function shiftTranscription(rl) {
     rl.setName("shiftTranscription");
     rl.setVersion("0.2.0");
+    rl.setCredential(shiftTranscriptionCredential);
     rl.setConnectionSchema(t.Object({
         apiKey: t.String({
             description: "Shift Labs API key",

package/dist/plugins/shiftTranscription/src/shared.js

@@ -1,3 +1,13 @@
-export { enumSchema, pathSegment, request, } from "../../_shared/shiftCloud.js";
+import { shiftClient } from "../../_shared/shiftCredentials.js";
+export { enumSchema, pathSegment, STRICT_OBJECT, } from "../../_shared/shiftCloud.js";
+/** The longest server-held wait /await accepts: waitSeconds is capped at 120. */
+export const MAX_AWAIT_WAIT_MS = 120_000;
+/**
+ * The target's deadline: the /await endpoint holds the request open for up
+ * to MAX_AWAIT_WAIT_MS, so the transport allows that wait plus 60 s for the
+ * exchange itself. Every other transcription route answers well within it.
+ */
+export const AWAIT_DEADLINE_MS = MAX_AWAIT_WAIT_MS + 60_000;
+export const { credential: shiftTranscriptionCredential, request } = shiftClient("shiftTranscription", { timeoutMs: AWAIT_DEADLINE_MS });
 export const TRANSCRIPTION_LANGUAGE = ["auto", "en", "he"];
 export const TRANSCRIPT_FORMAT = ["txt", "srt", "vtt", "json"];

package/dist/plugins/shiftTranscription/src/transcription.js

@@ -1,9 +1,8 @@
 import * as t from "typebox";
 import { AUDIO_VIDEO_MEDIA_TYPES, putThroughGrant, requireMediaType, SIGNED_UPLOAD_MAX_BYTES, statUploadFile, } from "../../_shared/shiftUpload.js";
-import { enumSchema, pathSegment, request, TRANSCRIPT_FORMAT, TRANSCRIPTION_LANGUAGE, } from "./shared.js";
+import { enumSchema, pathSegment, request, STRICT_OBJECT, TRANSCRIPT_FORMAT, TRANSCRIPTION_LANGUAGE, } from "./shared.js";
 /** Transcript previews returned into the sandbox are capped, not truncated silently. */
 const MAX_TRANSCRIPT_BYTES = 2 * 1024 * 1024;
-const STRICT_OBJECT = { additionalProperties: false };
 const Id = t.String({ minLength: 1, pattern: "\\S" });
 export function registerTranscriptionActions(rl) {
     rl.registerAction("transcription.transcribe", {
@@ -64,6 +63,8 @@ export function registerTranscriptionActions(rl) {
             if (!fields.waitSeconds)
                 return job;
             const timeoutMs = Math.min(Math.max(fields.waitSeconds, 1), 120) * 1000;
+            // The server holds the request open for up to timeoutMs; the
+            // target's declared AWAIT_DEADLINE_MS covers that wait.
             return request(ctx, `/v1/services/transcription/jobs/${pathSegment(job.id)}/await?timeoutMs=${timeoutMs}`, { method: "POST" });
         },
     });

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

@@ -2,6 +2,7 @@ import * as t from "typebox";
 import { registerIssueViewActions } from "./issue-views.js";
 import { registerIssueActions } from "./issues.js";
 import { registerProjectActions } from "./projects.js";
+import { shiftWorkCredential } from "./shared.js";
 /**
  * Shift Work — the work-tracking domain of the Shift cloud: Projects,
  * Issues (with dependencies and comments), and saved Issue Views.
@@ -11,6 +12,7 @@ import { registerProjectActions } from "./projects.js";
 export default function shiftWork(rl) {
     rl.setName("shiftWork");
     rl.setVersion("0.1.0");
+    rl.setCredential(shiftWorkCredential);
     rl.setConnectionSchema(t.Object({
         apiKey: t.String({
             description: "Shift Labs API key",

package/dist/plugins/shiftWork/src/issue-views.js

@@ -1,5 +1,5 @@
 import * as t from "typebox";
-import { cursorSchema, enumSchema, ISSUE_PRIORITY, ISSUE_STATUS, ISSUE_VIEW_GROUP, ISSUE_VIEW_LAYOUT, ISSUE_VIEW_SORT, ISSUE_VIEW_VISIBILITY, idSchema, listParams, pathSegment, request, STRICT_OBJECT, STRICT_UPDATE_OBJECT, timestampSchema, withQuery, } from "./shared.js";
+import { cursorSchema, enumSchema, ISSUE_PRIORITY, ISSUE_STATUS, ISSUE_VIEW_GROUP, ISSUE_VIEW_LAYOUT, ISSUE_VIEW_SORT, ISSUE_VIEW_VISIBILITY, idSchema, pathSegment, request, STRICT_OBJECT, STRICT_UPDATE_OBJECT, timestampSchema, } from "./shared.js";
 const viewFields = {
     name: t.String({
         minLength: 1,
@@ -38,7 +38,7 @@ export function registerIssueViewActions(rl) {
         description: "List the first page of personal and organization Issue Views.",
         inputSchema: t.Object(listFields, STRICT_OBJECT),
         async execute(input, ctx) {
-            const body = await request(ctx, `/v1/issue-views?${listParams(input)}`);
+            const body = await request(ctx, "/v1/issue-views", { query: input });
             return body.views;
         },
     });
@@ -47,7 +47,7 @@ export function registerIssueViewActions(rl) {
         description: "List a cursor-paginated page of Issue Views.",
         inputSchema: t.Object(listFields, STRICT_OBJECT),
         async execute(input, ctx) {
-            return request(ctx, `/v1/issue-views?${listParams(input)}`);
+            return request(ctx, "/v1/issue-views", { query: input });
         },
     });
     rl.registerAction("issueView.get", {
@@ -69,7 +69,7 @@ export function registerIssueViewActions(rl) {
         }, STRICT_OBJECT),
         async execute(input, ctx) {
             const { id, ...pagination } = input;
-            const body = await request(ctx, withQuery(`/v1/issue-views/${pathSegment(id)}/issues`, listParams(pagination)));
+            const body = await request(ctx, `/v1/issue-views/${pathSegment(id)}/issues`, { query: pagination });
             return body.issues;
         },
     });
@@ -83,7 +83,7 @@ export function registerIssueViewActions(rl) {
         }, STRICT_OBJECT),
         async execute(input, ctx) {
             const { id, ...pagination } = input;
-            return request(ctx, withQuery(`/v1/issue-views/${pathSegment(id)}/issues`, listParams(pagination)));
+            return request(ctx, `/v1/issue-views/${pathSegment(id)}/issues`, { query: pagination });
         },
     });
     rl.registerAction("issueView.create", {

package/dist/plugins/shiftWork/src/issues.js

@@ -1,5 +1,5 @@
 import * as t from "typebox";
-import { cursorSchema, enumSchema, ISSUE_PRIORITY, ISSUE_SOURCE, ISSUE_STATUS, idSchema, listParams, pathSegment, request, STRICT_OBJECT, STRICT_UPDATE_OBJECT, timestampSchema, withQuery, } from "./shared.js";
+import { cursorSchema, enumSchema, ISSUE_PRIORITY, ISSUE_SOURCE, ISSUE_STATUS, idSchema, pathSegment, request, STRICT_OBJECT, STRICT_UPDATE_OBJECT, timestampSchema, } from "./shared.js";
 const issueFields = {
     title: t.String({
         minLength: 1,
@@ -54,7 +54,9 @@ export function registerIssueActions(rl) {
         description: "List the first page of Shift Labs Issues for the API key's organization.",
         inputSchema: t.Object(issueListFields, STRICT_OBJECT),
         async execute(input, ctx) {
-            const body = await request(ctx, `/v1/issues?${listParams(input)}`);
+            const body = await request(ctx, "/v1/issues", {
+                query: input,
+            });
             return body.issues;
         },
     });
@@ -63,7 +65,7 @@ export function registerIssueActions(rl) {
         description: "List a cursor-paginated page of Shift Labs Issues.",
         inputSchema: t.Object(issueListFields, STRICT_OBJECT),
         async execute(input, ctx) {
-            return request(ctx, `/v1/issues?${listParams(input)}`);
+            return request(ctx, "/v1/issues", { query: input });
         },
     });
     rl.registerAction("issue.get", {
@@ -193,7 +195,7 @@ export function registerIssueActions(rl) {
         inputSchema: t.Object(eventListFields, STRICT_OBJECT),
         async execute(input, ctx) {
             const { id, ...pagination } = input;
-            const body = await request(ctx, withQuery(`/v1/issues/${pathSegment(id)}/events`, listParams(pagination)));
+            const body = await request(ctx, `/v1/issues/${pathSegment(id)}/events`, { query: pagination });
             return body.events;
         },
     });
@@ -203,7 +205,7 @@ export function registerIssueActions(rl) {
         inputSchema: t.Object(eventListFields, STRICT_OBJECT),
         async execute(input, ctx) {
             const { id, ...pagination } = input;
-            return request(ctx, withQuery(`/v1/issues/${pathSegment(id)}/events`, listParams(pagination)));
+            return request(ctx, `/v1/issues/${pathSegment(id)}/events`, { query: pagination });
         },
     });
     rl.registerAction("issue.dependency.list", {
@@ -215,7 +217,7 @@ export function registerIssueActions(rl) {
         }, STRICT_OBJECT),
         async execute(input, ctx) {
             const { id, ...pagination } = input;
-            const body = await request(ctx, withQuery(`/v1/issues/${pathSegment(id)}/dependencies`, listParams(pagination)));
+            const body = await request(ctx, `/v1/issues/${pathSegment(id)}/dependencies`, { query: pagination });
             return body.dependencies;
         },
     });
@@ -229,7 +231,9 @@ export function registerIssueActions(rl) {
         }, STRICT_OBJECT),
         async execute(input, ctx) {
             const { id, ...pagination } = input;
-            return request(ctx, withQuery(`/v1/issues/${pathSegment(id)}/dependencies`, listParams(pagination)));
+            return request(ctx, `/v1/issues/${pathSegment(id)}/dependencies`, {
+                query: pagination,
+            });
         },
     });
     rl.registerAction("issue.dependency.add", {

package/dist/plugins/shiftWork/src/projects.js

@@ -1,5 +1,5 @@
 import * as t from "typebox";
-import { cursorSchema, enumSchema, idSchema, listParams, PROJECT_STATUS, pathSegment, request, STRICT_OBJECT, STRICT_UPDATE_OBJECT, timestampSchema, } from "./shared.js";
+import { cursorSchema, enumSchema, idSchema, PROJECT_STATUS, pathSegment, request, STRICT_OBJECT, STRICT_UPDATE_OBJECT, timestampSchema, } from "./shared.js";
 const projectListFields = {
     status: t.Optional(enumSchema("Project status", PROJECT_STATUS)),
     leadUserId: t.Optional(idSchema("Lead user ID")),
@@ -13,7 +13,7 @@ export function registerProjectActions(rl) {
         description: "List the first page of concrete Shift Labs Projects.",
         inputSchema: t.Object(projectListFields, STRICT_OBJECT),
         async execute(input, ctx) {
-            const body = await request(ctx, `/v1/projects?${listParams(input)}`);
+            const body = await request(ctx, "/v1/projects", { query: input });
             return body.projects;
         },
     });
@@ -22,7 +22,7 @@ export function registerProjectActions(rl) {
         description: "List a cursor-paginated page of concrete Projects.",
         inputSchema: t.Object(projectListFields, STRICT_OBJECT),
         async execute(input, ctx) {
-            return request(ctx, `/v1/projects?${listParams(input)}`);
+            return request(ctx, "/v1/projects", { query: input });
         },
     });
     rl.registerAction("project.get", {

package/dist/plugins/shiftWork/src/shared.js

@@ -1,4 +1,6 @@
-export { cursorSchema, enumDescription, enumSchema, idSchema, listParams, pathSegment, request, STRICT_OBJECT, STRICT_UPDATE_OBJECT, timestampSchema, withQuery, } from "../../_shared/shiftCloud.js";
+import { shiftClient } from "../../_shared/shiftCredentials.js";
+export { cursorSchema, enumDescription, enumSchema, idSchema, pathSegment, STRICT_OBJECT, STRICT_UPDATE_OBJECT, timestampSchema, } from "../../_shared/shiftCloud.js";
+export const { credential: shiftWorkCredential, request } = shiftClient("shiftWork");
 export const ISSUE_STATUS = [
     "backlog",
     "todo",

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

@@ -0,0 +1,16 @@
+import { hostLabel, staticCredential } from "../../_shared/credentials.js";
+/**
+ * An Admin API access token, sent as the X-Shopify-Access-Token header to
+ * the store's own myshopify.com host beneath /admin/api/2024-07/.
+ */
+export const shopifyCredential = staticCredential({
+    id: "shopify",
+    auth: { kind: "apiKey", header: "X-Shopify-Access-Token" },
+    local: { secret: "accessToken" },
+    targets: (config) => ({
+        api: {
+            baseUrl: `https://${hostLabel(config.shopSubdomain)}.myshopify.com/admin/api/2024-07/`,
+            methods: ["GET", "POST", "PUT", "DELETE"],
+        },
+    }),
+});

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

@@ -1,64 +1,39 @@
-function getConn(ctx) {
-    const c = ctx.connection.config;
-    const subdomain = c.shopSubdomain;
-    const base = `https://${subdomain}.myshopify.com/admin/api/2024-07`;
-    return { base, accessToken: c.accessToken };
-}
-async function apiRequest(conn, method, endpoint, body, qs) {
-    const url = new URL(`${conn.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, credentialOk, jsonAnswer, pathSegment, pathWithin, } from "../../_shared/credentials.js";
+import { shopifyCredential } from "./credentials.js";
+function apiRequest(ctx, method, path, body, qs) {
+    return credentialJson(ctx, shopifyCredential, "shopify", {
+        target: "api",
+        path,
         method,
-        headers: {
-            "X-Shopify-Access-Token": conn.accessToken,
-            "Content-Type": "application/json",
-        },
-    };
-    if (body !== undefined)
-        init.body = JSON.stringify(body);
-    const res = await fetch(url.toString(), init);
-    if (!res.ok)
-        throw new Error(`Shopify error ${res.status}: ${await res.text()}`);
-    const text = await res.text();
-    return text ? JSON.parse(text) : {};
+        query: qs,
+        ...(body !== undefined ? { json: body } : {}),
+    });
 }
-async function paginate(conn, propertyName, endpoint, qs = {}) {
+async function paginate(ctx, propertyName, path, qs = {}) {
     const all = [];
-    let nextUrl;
+    let nextPath;
     do {
-        const url = nextUrl ?? `${conn.base}${endpoint}`;
-        const u = new URL(url);
-        if (!nextUrl && qs) {
-            for (const [k, v] of Object.entries(qs)) {
-                if (v !== undefined && v !== null)
-                    u.searchParams.set(k, String(v));
-            }
-        }
-        const res = await fetch(u.toString(), {
-            headers: { "X-Shopify-Access-Token": conn.accessToken },
+        const res = await credentialOk(ctx, shopifyCredential, "shopify", {
+            target: "api",
+            path: nextPath ?? path,
+            ...(nextPath === undefined ? { query: qs } : {}),
         });
-        if (!res.ok)
-            throw new Error(`Shopify error ${res.status}: ${await res.text()}`);
-        const data = (await res.json());
+        const data = (await jsonAnswer(res));
         all.push(...(data[propertyName] ?? []));
-        nextUrl = undefined;
+        nextPath = undefined;
         const link = res.headers.get("link") ?? "";
         if (link.includes('rel="next"')) {
             const match = link.match(/<([^>]+)>;\s*rel="next"/);
             if (match)
-                nextUrl = match[1];
+                nextPath = pathWithin(ctx, shopifyCredential, "api", match[1]);
         }
-    } while (nextUrl);
+    } while (nextPath);
     return all;
 }
 export default function shopify(rl) {
     rl.setName("shopify");
     rl.setVersion("0.1.0");
+    rl.setCredential(shopifyCredential);
     rl.setConnectionSchema({
         shopSubdomain: {
             type: "string",
@@ -104,7 +79,7 @@ export default function shopify(rl) {
                 order.note = p.note;
             if (p.tags)
                 order.tags = p.tags;
-            const data = (await apiRequest(getConn(ctx), "POST", "/orders.json", {
+            const data = (await apiRequest(ctx, "POST", "orders.json", {
                 order,
             }));
             return data.order;
@@ -122,7 +97,7 @@ export default function shopify(rl) {
             const qs = {};
             if (p.fields)
                 qs.fields = p.fields;
-            const data = (await apiRequest(getConn(ctx), "GET", `/orders/${p.orderId}.json`, undefined, qs));
+            const data = (await apiRequest(ctx, "GET", `orders/${pathSegment(p.orderId)}.json`, undefined, qs));
             return data.order;
         },
     });
@@ -141,7 +116,6 @@ export default function shopify(rl) {
         },
         async execute(input, ctx) {
             const p = (input ?? {});
-            const conn = getConn(ctx);
             const qs = {};
             if (p.status)
                 qs.status = p.status;
@@ -151,10 +125,10 @@ export default function shopify(rl) {
                 qs.created_at_max = p.createdAtMax;
             if (p.limit) {
                 qs.limit = p.limit;
-                const d = (await apiRequest(conn, "GET", "/orders.json", undefined, qs));
+                const d = (await apiRequest(ctx, "GET", "orders.json", undefined, qs));
                 return d.orders;
             }
-            return paginate(conn, "orders", "/orders.json", qs);
+            return paginate(ctx, "orders", "orders.json", qs);
         },
     });
     rl.registerAction("order.update", {
@@ -175,7 +149,7 @@ export default function shopify(rl) {
                 order.tags = p.tags;
             if (p.email)
                 order.email = p.email;
-            const data = (await apiRequest(getConn(ctx), "PUT", `/orders/${p.orderId}.json`, { order }));
+            const data = (await apiRequest(ctx, "PUT", `orders/${pathSegment(p.orderId)}.json`, { order }));
             return data.order;
         },
     });
@@ -184,7 +158,7 @@ export default function shopify(rl) {
         description: "Delete an order",
         inputSchema: { orderId: { type: "string", required: true } },
         async execute(input, ctx) {
-            await apiRequest(getConn(ctx), "DELETE", `/orders/${input.orderId}.json`);
+            await apiRequest(ctx, "DELETE", `orders/${pathSegment(input.orderId)}.json`);
             return { success: true };
         },
     });
@@ -201,7 +175,7 @@ export default function shopify(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            const data = (await apiRequest(getConn(ctx), "POST", "/products.json", {
+            const data = (await apiRequest(ctx, "POST", "products.json", {
                 product: p,
             }));
             return data.product;
@@ -219,7 +193,7 @@ export default function shopify(rl) {
             const qs = {};
             if (p.fields)
                 qs.fields = p.fields;
-            const data = (await apiRequest(getConn(ctx), "GET", `/products/${p.productId}.json`, undefined, qs));
+            const data = (await apiRequest(ctx, "GET", `products/${pathSegment(p.productId)}.json`, undefined, qs));
             return data.product;
         },
     });
@@ -232,16 +206,15 @@ export default function shopify(rl) {
         },
         async execute(input, ctx) {
             const p = (input ?? {});
-            const conn = getConn(ctx);
             const qs = {};
             if (p.title)
                 qs.title = p.title;
             if (p.limit) {
                 qs.limit = p.limit;
-                const d = (await apiRequest(conn, "GET", "/products.json", undefined, qs));
+                const d = (await apiRequest(ctx, "GET", "products.json", undefined, qs));
                 return d.products;
             }
-            return paginate(conn, "products", "/products.json", qs);
+            return paginate(ctx, "products", "products.json", qs);
         },
     });
     rl.registerAction("product.update", {
@@ -257,7 +230,7 @@ export default function shopify(rl) {
         async execute(input, ctx) {
             const p = input;
             const { productId, ...fields } = p;
-            const data = (await apiRequest(getConn(ctx), "PUT", `/products/${productId}.json`, { product: fields }));
+            const data = (await apiRequest(ctx, "PUT", `products/${pathSegment(productId)}.json`, { product: fields }));
             return data.product;
         },
     });
@@ -266,7 +239,7 @@ export default function shopify(rl) {
         description: "Delete a product",
         inputSchema: { productId: { type: "string", required: true } },
         async execute(input, ctx) {
-            await apiRequest(getConn(ctx), "DELETE", `/products/${input.productId}.json`);
+            await apiRequest(ctx, "DELETE", `products/${pathSegment(input.productId)}.json`);
             return { success: true };
         },
     });

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

@@ -0,0 +1,17 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/** The team secret, which SIGNL4 takes as the webhook's path segment. */
+export const signl4Credential = staticCredential({
+    id: "signl4",
+    auth: {
+        kind: "static",
+        parts: ["teamSecret"],
+        placements: [{ in: "path", part: "teamSecret" }],
+    },
+    local: { teamSecret: "teamSecret" },
+    targets: {
+        webhook: {
+            baseUrl: "https://connect.signl4.com/webhook/",
+            methods: ["POST"],
+        },
+    },
+});