@oomol-lab/open-connector 1.9.1 → 1.9.3

package/src/providers/search_api/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalNumber, optionalRecord, optionalString } from "../../core/cast.js";
-import { providerUserAgent, ProviderRequestError } from "../provider-runtime.js";
+import { providerUserAgent, ProviderRequestError, providerInputError } from "../provider-runtime.js";
 const searchApiOrigin = "https://www.searchapi.io";
 const searchApiBasePath = "/api/v1/";
 export const searchApiBaseUrl = "https://www.searchapi.io/api/v1";
@@ -201,7 +201,7 @@ async function readJsonPayload(response) {
 function createSearchApiError(status, payload, phase) {
     const message = extractSearchApiMessage(payload) ?? `SearchApi request failed with ${status || 500}`;
     if (phase === "validate" && (status === 401 || status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status || 500, message);
 }

package/src/providers/securitytrails/executors.js

@@ -1,5 +1,5 @@
 import { optionalInteger, optionalRecord, optionalString } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, providerInputError, } from "../provider-runtime.js";
 const service = "securitytrails";
 const securitytrailsApiBaseUrl = "https://api.securitytrails.com";
 export const securitytrailsActionHandlers = {
@@ -117,7 +117,7 @@ async function readSecuritytrailsPayload(response) {
 function buildSecuritytrailsError(status, payload, phase) {
     const message = readSecuritytrailsMessage(payload) ?? `SecurityTrails request failed with ${status || 500}`;
     if (phase === "validate" && status >= 400 && status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status || 500, message);
 }

package/src/providers/semantic_scholar/executors.js

@@ -1,6 +1,6 @@
 import { compactObject, looseArray, optionalRawString, optionalRecord, rawStringOrNull, recordOrEmpty, } from "../../core/cast.js";
 import { encodePathSegment } from "../../core/request.js";
-import { defineProviderExecutors, defineProviderProxy, mapProviderActionSources, providerProxyEndpointPrefixes, ProviderRequestError, providerUserAgent, requireApiKeyCredential, runProviderRequest, } from "../provider-runtime.js";
+import { defineProviderExecutors, defineProviderProxy, mapProviderActionSources, providerProxyEndpointPrefixes, ProviderRequestError, providerUserAgent, requireApiKeyCredential, runProviderRequest, providerInputError, } from "../provider-runtime.js";
 const service = "semantic_scholar";
 const graphApiBaseUrl = "https://api.semanticscholar.org/graph/v1";
 const recommendationsApiBaseUrl = "https://api.semanticscholar.org/recommendations/v1";
@@ -331,7 +331,7 @@ function createSemanticScholarError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && status >= 400 && status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && (status === 401 || status === 403)) {
         return new ProviderRequestError(401, message);

package/src/providers/sendbird/executors.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalRawString, pickOptionalString } from "../../core/cast.js";
-import { defineProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, requireApiKeyCredential, } from "../provider-runtime.js";
+import { defineProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, requireApiKeyCredential, providerInputError, } from "../provider-runtime.js";
 const sendbirdUserAgent = providerUserAgent;
 const sendbirdValidationPath = "/applications/settings_global";
 export const sendbirdActionHandlers = {
@@ -510,7 +510,7 @@ function createSendbirdError(response, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && (response.status === 401 || response.status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (response.status === 400 || response.status === 404) {
         return new ProviderRequestError(response.status, message);

package/src/providers/sendfox/executors.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalNumber, optionalRawString, optionalRecord } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, providerInputError, } from "../provider-runtime.js";
 const sendfoxApiBaseUrl = "https://api.sendfox.com";
 export const sendfoxActionHandlers = {
     list_contacts(input, context) {
@@ -235,7 +235,7 @@ function createSendfoxError(response, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && (response.status === 401 || response.status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (response.status === 401) {
         return new ProviderRequestError(401, message);
@@ -244,7 +244,7 @@ function createSendfoxError(response, payload, phase) {
         return new ProviderRequestError(403, message);
     }
     if (response.status === 404 || response.status === 400 || response.status === 409 || response.status === 422) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status >= 500 ? 502 : response.status, message);
 }

package/src/providers/sendgrid/executors.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalNumber, optionalRawString, optionalRecord } from "../../core/cast.js";
-import { defineProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, requireApiKeyCredential, } from "../provider-runtime.js";
+import { defineProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, requireApiKeyCredential, providerInputError, providerResponseError, } from "../provider-runtime.js";
 const sendgridDefaultBaseUrl = "https://api.sendgrid.com";
 const sendgridTemplatesPath = "/v3/templates";
 const sendgridMailSendPath = "/v3/mail/send";
@@ -363,13 +363,13 @@ function sendgridHeaders(apiKey, hasBody) {
 function mapSendgridError(status, message, mode) {
     if (status === 401) {
         if (mode === "validate") {
-            return new ProviderRequestError(400, message);
+            return providerInputError(message);
         }
         return new ProviderRequestError(401, message);
     }
     if (status === 403) {
         if (mode === "validate") {
-            return new ProviderRequestError(400, message);
+            return providerInputError(message);
         }
         return new ProviderRequestError(403, message);
     }
@@ -377,9 +377,9 @@ function mapSendgridError(status, message, mode) {
         return new ProviderRequestError(429, message);
     }
     if (status === 400 || status === 404) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
-    return new ProviderRequestError(502, message);
+    return providerResponseError(message);
 }
 async function readSendgridError(response) {
     try {

package/src/providers/sendmator/runtime.js

@@ -1,7 +1,6 @@
 import { compactObject, optionalBoolean, optionalRecord, optionalString, requiredString } from "../../core/cast.js";
-import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 export const sendmatorApiBaseUrl = "https://api.sendmator.com/api/v1";
-const sendmatorDefaultRequestTimeoutMs = 30_000;
 export const sendmatorActionHandlers = {
     list_contacts(input, context) {
         return executeListContacts(input, context);
@@ -126,7 +125,7 @@ async function requestSendmatorJson(input) {
     if (input.body) {
         headers["content-type"] = "application/json";
     }
-    const timeout = createProviderTimeout(input.signal, sendmatorDefaultRequestTimeoutMs);
+    const timeout = createProviderTimeout(input.signal);
     let response;
     try {
         response = await input.fetcher(url.toString(), {
@@ -138,7 +137,7 @@ async function requestSendmatorJson(input) {
     }
     catch (error) {
         throw new ProviderRequestError(502, timeout.didTimeout() || isAbortLikeError(error)
-            ? `sendmator request timed out after ${sendmatorDefaultRequestTimeoutMs}ms`
+            ? `sendmator request timed out after ${defaultProviderRequestTimeoutMs}ms`
             : `sendmator request failed: ${error instanceof Error ? error.message : "Unknown transport error"}`);
     }
     finally {

package/src/providers/sentry/executors.d.ts

@@ -1,4 +1,6 @@
 import type { CredentialValidators, ProviderExecutors, ProviderProxyExecutor } from "../../core/types.ts";
+import type { IntegrationDefinition } from "../../triggers/common/integration.ts";
 export declare const executors: ProviderExecutors;
 export declare const proxy: ProviderProxyExecutor;
 export declare const credentialValidators: CredentialValidators;
+export declare const triggers: readonly IntegrationDefinition[];

package/src/providers/sentry/executors.js

@@ -1,5 +1,6 @@
 import { defineOAuthProviderExecutors, defineProviderProxy } from "../provider-runtime.js";
 import { sentryActionHandlers, sentryApiBaseUrl, validateSentryCredential } from "./runtime.js";
+import { sentryIssueAlert } from "./trigger-on-issue-alert.js";
 const service = "sentry";
 export const executors = defineOAuthProviderExecutors(service, sentryActionHandlers);
 export const proxy = defineProviderProxy({
@@ -12,3 +13,4 @@ export const credentialValidators = {
         return validateSentryCredential(input.accessToken, fetcher);
     },
 };
+export const triggers = [sentryIssueAlert];

package/src/providers/sentry/trigger-on-issue-alert.d.ts

@@ -0,0 +1,2 @@
+import type { IntegrationDefinition } from "../../triggers/common/integration.ts";
+export declare const sentryIssueAlert: IntegrationDefinition;

package/src/providers/sentry/trigger-on-issue-alert.definition.d.ts

@@ -0,0 +1,4 @@
+import type { TriggerKeySnapshot } from "../../triggers/common/types.ts";
+export declare const snapshot: TriggerKeySnapshot & {
+    readonly type: "integration";
+};

package/src/providers/sentry/trigger-on-issue-alert.definition.js

@@ -0,0 +1,64 @@
+export const snapshot = {
+    key: "sentry.on_issue_alert",
+    provider: "sentry",
+    name: "on_issue_alert",
+    displayName: "Issue Alert",
+    description: "Receives Issue Alert Rule notifications from a verified Sentry Custom Integration installation.",
+    definitionVersion: 2,
+    type: "integration",
+    endpoint: {
+        methods: ["POST"],
+        body: { formats: ["json"], allowArray: false, allowEmpty: false },
+        successStatus: 200,
+    },
+    configInputs: [
+        {
+            handle: "projectIds",
+            jsonSchema: {
+                type: "array",
+                items: { type: "string", pattern: "^[0-9]+$" },
+                uniqueItems: true,
+                title: "Project IDs",
+            },
+            nullable: true,
+        },
+        {
+            handle: "ruleNames",
+            jsonSchema: {
+                type: "array",
+                items: { type: "string", minLength: 1 },
+                uniqueItems: true,
+                title: "Alert rule names",
+            },
+            nullable: true,
+        },
+        {
+            handle: "sourceId",
+            jsonSchema: { type: "string", pattern: "^source_[0-9a-f]{32}$", title: "Event source" },
+            nullable: false,
+        },
+        {
+            handle: "eventTypes",
+            jsonSchema: {
+                type: "array",
+                items: {
+                    type: "string",
+                    enum: ["issue.alert"],
+                },
+                minItems: 1,
+                maxItems: 1,
+                uniqueItems: true,
+                title: "Events",
+            },
+            nullable: false,
+            value: ["issue.alert"],
+        },
+    ],
+    outputs: [
+        { handle: "event", jsonSchema: { type: "string" }, nullable: false },
+        { handle: "deliveryId", jsonSchema: { type: "string" }, nullable: false },
+        { handle: "organizationId", jsonSchema: { type: "string" }, nullable: false },
+        { handle: "issueId", jsonSchema: { type: "string" }, nullable: false },
+        { handle: "body", jsonSchema: { type: "object" }, nullable: false },
+    ],
+};

package/src/providers/sentry/trigger-on-issue-alert.js

@@ -0,0 +1,80 @@
+import { PermanentIntegrationError } from "../../triggers/common/integration.js";
+import { isJsonObject } from "../../triggers/common/json.js";
+import { webhookRequest } from "../../triggers/managed-webhook.js";
+import { sentryApplication } from "../../triggers/sources/sentry.js";
+import { snapshot } from "./trigger-on-issue-alert.definition.js";
+export const sentryIssueAlert = {
+    snapshot,
+    eventSource: "sentry",
+    source: sentryApplication,
+    async sourceIdentity(context) {
+        const accountId = context.connector.providerAccountId;
+        const { appId, installationId, organizationId } = context.config;
+        if (!accountId ||
+            typeof organizationId !== "string" ||
+            !organizationId ||
+            typeof appId !== "string" ||
+            !appId ||
+            typeof installationId !== "string" ||
+            !installationId)
+            throw new PermanentIntegrationError("Sentry requires a verified organization, application UUID and installation UUID.");
+        const organizationResponse = await webhookRequest(context, {
+            method: "GET",
+            endpoint: `/organizations/${encodeURIComponent(organizationId)}/`,
+        });
+        const organization = organizationResponse.data;
+        if (!isJsonObject(organization) || typeof organization.id !== "string" || typeof organization.slug !== "string")
+            throw new PermanentIntegrationError("Invalid Sentry organization response.");
+        const seen = new Set();
+        let cursor;
+        for (;;) {
+            const result = await webhookRequest(context, {
+                method: "GET",
+                endpoint: `/organizations/${encodeURIComponent(organizationId)}/sentry-app-installations/`,
+                query: cursor == null ? {} : { cursor },
+            });
+            if (!Array.isArray(result.data))
+                throw new PermanentIntegrationError("Invalid Sentry installations response.");
+            for (const item of result.data) {
+                if (!isJsonObject(item) || !isJsonObject(item.app) || !isJsonObject(item.organization))
+                    throw new PermanentIntegrationError("Invalid Sentry installation.");
+                if (item.uuid !== installationId)
+                    continue;
+                if (item.app.uuid !== appId || item.status !== "installed" || item.organization.slug !== organization.slug)
+                    throw new PermanentIntegrationError("Sentry integration is not installed in the connected organization.");
+                return {
+                    accountId,
+                    organizationId: organization.id,
+                    organizationSlug: organization.slug,
+                    appId,
+                    installationId,
+                };
+            }
+            const next = (result.headers?.link ?? "")
+                .split(",")
+                .find((link) => /rel="next"/.test(link) && /results="true"/.test(link));
+            if (next == null)
+                break;
+            const match = /cursor="([^"]+)"/.exec(next);
+            if (!match || seen.has(match[1]))
+                throw new PermanentIntegrationError("Invalid Sentry installation pagination.");
+            cursor = match[1];
+            seen.add(cursor);
+        }
+        throw new PermanentIntegrationError("Install the selected Sentry integration in the connected organization first.");
+    },
+    receive(context) {
+        if (context.eventSourceId !== context.config.sourceId)
+            return { outcome: "respond", status: 404, body: "", contentType: "text/plain" };
+        const payload = context.payload;
+        if (!isJsonObject(payload) ||
+            typeof payload.deliveryId !== "string" ||
+            !payload.deliveryId ||
+            !isJsonObject(payload.body))
+            throw new PermanentIntegrationError("Invalid shared Sentry event.");
+        return { outcome: "event", dedupeKey: payload.deliveryId, outputs: payload };
+    },
+    async reconcile() {
+        throw new PermanentIntegrationError("This deployment does not support shared Sentry event sources.");
+    },
+};

package/src/providers/seqera/runtime.js

@@ -1,9 +1,8 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString, requiredString, } from "../../core/cast.js";
 import { assertPublicHttpUrl, isPrivateNetworkAccessAllowed } from "../../core/request.js";
-import { createProviderTimeout, defineProviderExecutors, isAbortLikeError, providerUserAgent, ProviderRequestError, requireApiKeyCredential, requiredResponseRecord, } from "../provider-runtime.js";
+import { createProviderTimeout, defineProviderExecutors, isAbortLikeError, providerUserAgent, ProviderRequestError, requireApiKeyCredential, requiredResponseRecord, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const service = "seqera";
 const defaultSeqeraApiBaseUrl = "https://api.cloud.seqera.io";
-const seqeraRequestTimeoutMs = 30_000;
 const seqeraValidationEndpoint = "/user-info";
 export const seqeraActionHandlers = {
     get_current_user(_input, context) {
@@ -263,7 +262,7 @@ async function seqeraFetch(input) {
         headers.set("Content-Type", "application/json");
         body = JSON.stringify(input.body);
     }
-    const timeout = createProviderTimeout(input.signal, seqeraRequestTimeoutMs);
+    const timeout = createProviderTimeout(input.signal);
     try {
         return await input.fetcher(url, {
             method: input.method ?? "GET",
@@ -274,7 +273,7 @@ async function seqeraFetch(input) {
     }
     catch (error) {
         if (timeout.didTimeout() || isAbortLikeError(error)) {
-            throw new ProviderRequestError(502, `seqera ${input.path} request timed out after ${Math.max(1, Math.ceil(seqeraRequestTimeoutMs / 1000))} seconds`);
+            throw new ProviderRequestError(502, `seqera ${input.path} request timed out after ${Math.max(1, Math.ceil(defaultProviderRequestTimeoutMs / 1000))} seconds`);
         }
         throw new ProviderRequestError(502, error instanceof Error ? error.message : "Seqera request failed");
     }

package/src/providers/serveravatar/executors.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderTimeout, defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, readProviderJsonBody, } from "../provider-runtime.js";
+import { createProviderTimeout, defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, readProviderJsonBody, providerInputError, providerResponseError, } from "../provider-runtime.js";
 const service = "serveravatar";
 const serverAvatarApiBaseUrl = "https://api.serveravatar.com";
 export const serverAvatarActionHandlers = {
@@ -140,12 +140,12 @@ function mapServerAvatarError(status, payload, phase) {
         return new ProviderRequestError(401, message);
     }
     if (status === 400 || status === 404 || status === 422) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status === 429) {
         return new ProviderRequestError(429, message);
     }
-    return new ProviderRequestError(502, message);
+    return providerResponseError(message);
 }
 function extractServerAvatarErrorMessage(payload) {
     if (typeof payload === "string" && payload.trim()) {

package/src/providers/sf_express/runtime.d.ts

@@ -1,6 +1,5 @@
 import type { CredentialValidationResult } from "../../core/types.ts";
 import type { ProviderFetch, ProviderRuntimeHandler } from "../provider-runtime.ts";
-export declare const sfExpressApiBaseUrl = "https://bspgw.sf-express.com/std/service";
 type SfExpressPhase = "validate" | "execute";
 /**
  * The msgDigest algorithm a partnerID is bound to. SF fixes the choice when the
@@ -27,21 +26,6 @@ export declare function optionalFlagNumber(value: unknown): 1 | 0 | undefined;
 /** Read an optional value-added service list (name + value…value4) from action input. */
 export declare function readServiceValueList(value: unknown, fieldName: string): Array<Record<string, unknown>> | undefined;
 export declare function validateSfExpressCredential(values: Record<string, string>, fetcher: ProviderFetch, signal?: AbortSignal): Promise<CredentialValidationResult>;
-/**
- * Sign one request with the algorithm the application was created against. All
- * three sign the same `msgData + timestamp + checkWord` string and differ only
- * in how they turn it into msgDigest:
- *
- * - `standard_md5` runs it through `URLEncoder.encode(text, "UTF-8")`
- *   first, then Base64(MD5(...)). Skipping that step fails verification for
- *   every payload, because JSON always carries characters the encoder rewrites.
- * - `simple_md5` is the same Base64(MD5(...)) over the raw string.
- * - `sm3` is the lowercase hexadecimal SM3 digest of the raw string.
- *
- * Standard MD5 is the default because SF used it before offering
- * the choice and what every application created back then still uses.
- */
-export declare function signSfExpressPayload(msgData: string, timestamp: string, checkWord: string, algorithm?: SfExpressSignatureAlgorithm): string;
 /**
  * Call one SF Express Open Platform service: POST form-urlencoded with the
  * business JSON in msgData, signed by {@link signSfExpressPayload}. msgData is

package/src/providers/sf_express/runtime.js

@@ -2,7 +2,7 @@ import { createHash, randomUUID } from "node:crypto";
 import { compactObject, objectArray, optionalBoolean, optionalNumberLike, optionalRecord, optionalString, } from "../../core/cast.js";
 import { sm3Hex } from "../../core/sm3.js";
 import { parseProviderJsonBodyText, ProviderRequestError, providerInputError, providerResponseError, providerUserAgent, readProviderJson, requiredInputString, requiredResponseRecord, runProviderRequest, } from "../provider-runtime.js";
-export const sfExpressApiBaseUrl = "https://bspgw.sf-express.com/std/service";
+const sfExpressApiBaseUrl = "https://bspgw.sf-express.com/std/service";
 /** The sandbox gateway; every documented sandbox-environment row names this host. */
 const sfExpressSandboxBaseUrl = "https://sfapi-sbox.sf-express.com/std/service";
 /** Endpoints whose production URL differs from the default gateway, per their documented common-parameters sections. */
@@ -157,7 +157,7 @@ function javaFormUrlEncode(value) {
  * Standard MD5 is the default because SF used it before offering
  * the choice and what every application created back then still uses.
  */
-export function signSfExpressPayload(msgData, timestamp, checkWord, algorithm = "standard_md5") {
+function signSfExpressPayload(msgData, timestamp, checkWord, algorithm = "standard_md5") {
     const text = msgData + timestamp + checkWord;
     if (algorithm === "sm3") {
         return sm3Hex(text);

package/src/providers/sheetdb/runtime.js

@@ -1,5 +1,5 @@
 import { optionalInteger, optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderTimeout, providerUserAgent, ProviderRequestError } from "../provider-runtime.js";
+import { createProviderTimeout, providerUserAgent, ProviderRequestError, providerInputError, } from "../provider-runtime.js";
 export const sheetDbApiBaseUrl = "https://sheetdb.io";
 export const sheetDbActionHandlers = {
     list_rows(input, context) {
@@ -252,7 +252,7 @@ function mapSheetDbError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (status === 400 || status === 404 || status === 422) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status >= 500 ? status : 502, message);
 }

package/src/providers/short_menu/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString, requiredString } from "../../core/cast.js";
-import { ProviderRequestError, providerUserAgent } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, providerInputError } from "../provider-runtime.js";
 const shortMenuApiBaseUrl = "https://api.shortmenu.com";
 const shortMenuValidationPath = "/links";
 export const shortMenuActionHandlers = {
@@ -145,13 +145,13 @@ async function toShortMenuError(response, phase, notFoundAsInvalidInput) {
         return new ProviderRequestError(phase === "validate" ? 400 : 401, message);
     }
     if (response.status === 404 && notFoundAsInvalidInput) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (response.status === 400 && errorCode === "LINK_LIMIT_REACHED") {
         return new ProviderRequestError(429, message);
     }
     if (response.status === 400) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status || 502, message);
 }

package/src/providers/shortcut/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString } from "../../core/cast.js";
-import { providerFetch, ProviderRequestError, providerUserAgent, requiredResponseRecord } from "../provider-runtime.js";
+import { providerFetch, ProviderRequestError, providerUserAgent, requiredResponseRecord, providerInputError, } from "../provider-runtime.js";
 export const shortcutApiBaseUrl = "https://api.app.shortcut.com/api/v3/";
 const shortcutValidatePath = "member";
 export const shortcutActionHandlers = {
@@ -297,13 +297,13 @@ function createShortcutError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && [400, 401, 403, 404].includes(status)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && (status === 401 || status === 403)) {
         return new ProviderRequestError(401, message);
     }
     if (phase === "execute" && [400, 404, 422].includes(status)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status >= 500 ? status : 502, message);
 }

package/src/providers/shortpixel/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString, requiredString } from "../../core/cast.js";
-import { ProviderRequestError, providerUserAgent, runProviderRequest } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, runProviderRequest, providerInputError, } from "../provider-runtime.js";
 const shortpixelAccountApiBaseUrl = "https://api.shortpixel.com/v2";
 const shortpixelCdnApiBaseUrl = "https://no-cdn.shortpixel.ai";
 export const shortpixelActionHandlers = {
@@ -110,7 +110,7 @@ function createShortpixelHttpError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && (status === 401 || status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status >= 500 ? status : 502, message);
 }

package/src/providers/shotstack/runtime.js

@@ -1,6 +1,6 @@
 import { optionalBoolean, optionalNumber, optionalRecord, optionalString, requiredString } from "../../core/cast.js";
 import { jsonObject } from "../../core/request.js";
-import { createProviderTimeout, providerUserAgent, ProviderRequestError } from "../provider-runtime.js";
+import { createProviderTimeout, providerUserAgent, ProviderRequestError, providerInputError, } from "../provider-runtime.js";
 const shotstackApiBaseUrl = "https://api.shotstack.io/edit/v1";
 export const shotstackProxyBaseUrl = "https://api.shotstack.io";
 export const shotstackActionHandlers = {
@@ -54,7 +54,7 @@ async function renderEdit(input, context) {
     return { render: { id, message } };
 }
 async function getRender(input, context) {
-    const id = requiredString(input.id, "id", (message) => new ProviderRequestError(400, message));
+    const id = requiredString(input.id, "id", providerInputError);
     const query = new URLSearchParams();
     const data = optionalBoolean(input.data);
     const merged = optionalBoolean(input.merged);
@@ -164,13 +164,13 @@ function createShotstackError(response, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && response.status >= 400 && response.status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && (response.status === 401 || response.status === 403)) {
         return new ProviderRequestError(401, message);
     }
     if (response.status >= 400 && response.status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status || 502, message);
 }

package/src/providers/signpath/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString, requiredString } from "../../core/cast.js";
-import { createProviderTimeout, defineProviderExecutors, ProviderRequestError, providerUserAgent, requireApiKeyCredential, } from "../provider-runtime.js";
+import { createProviderTimeout, defineProviderExecutors, ProviderRequestError, providerUserAgent, requireApiKeyCredential, providerInputError, } from "../provider-runtime.js";
 export const signpathApiBaseUrl = "https://app.signpath.io/api/v1";
 export const signpathActionHandlers = {
     async list_signing_policies(input, context) {
@@ -152,7 +152,7 @@ function createSignpathError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (status >= 400 && status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status || 502, message);
 }

package/src/providers/signwell/runtime.js

@@ -1,8 +1,7 @@
 import { compactObject, optionalBoolean, optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, providerInputError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const signwellApiBaseUrl = "https://www.signwell.com";
 const signwellValidationPath = "/api/v1/me";
-const signwellDefaultTimeoutMs = 30_000;
 export const signwellActionHandlers = {
     get_me(_input, context) {
         return getMe(context);
@@ -205,7 +204,7 @@ function buildReminderRequestBody(input) {
     });
 }
 async function requestSignwellJson(input) {
-    const timeoutHandle = createProviderTimeout(input.signal, signwellDefaultTimeoutMs);
+    const timeoutHandle = createProviderTimeout(input.signal);
     try {
         const response = await input.fetcher(new URL(input.path, signwellApiBaseUrl), {
             method: input.method ?? "GET",
@@ -231,7 +230,7 @@ async function requestSignwellJson(input) {
             throw error;
         }
         if (timeoutHandle.didTimeout() || isAbortLikeError(error)) {
-            throw new ProviderRequestError(504, `SignWell request timed out after ${Math.max(1, Math.ceil(signwellDefaultTimeoutMs / 1000))} seconds`);
+            throw new ProviderRequestError(504, `SignWell request timed out after ${Math.max(1, Math.ceil(defaultProviderRequestTimeoutMs / 1000))} seconds`);
         }
         throw new ProviderRequestError(502, error instanceof Error ? `SignWell request failed: ${error.message}` : "SignWell request failed");
     }
@@ -265,13 +264,13 @@ function createSignwellError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && (status === 401 || status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && (status === 401 || status === 403)) {
         return new ProviderRequestError(401, message);
     }
     if (status === 404 || status === 400 || status === 422) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status >= 400 && status < 500) {
         return new ProviderRequestError(status, message);

package/src/providers/similarweb_digitalrank_api/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString } from "../../core/cast.js";
-import { providerUserAgent, ProviderRequestError } from "../provider-runtime.js";
+import { providerUserAgent, ProviderRequestError, providerInputError } from "../provider-runtime.js";
 export const similarwebApiBaseUrl = "https://api.similarweb.com";
 export const similarwebDigitalRankApiActionHandlers = {
     get_subscription_status(_input, context) {
@@ -105,13 +105,13 @@ function createSimilarwebError(response, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && (response.status === 401 || response.status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && response.status === 401) {
         return new ProviderRequestError(401, message);
     }
     if (response.status === 400) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status || 500, message);
 }