@oomol-lab/open-connector 1.9.1 → 1.9.3

package/src/providers/close/runtime.js

@@ -1,6 +1,6 @@
 import { Buffer } from "node:buffer";
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, requiredResponseRecord, } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, requiredResponseRecord, providerInputError, } from "../provider-runtime.js";
 export const closeApiBaseUrl = "https://api.close.com/api/v1";
 export const closeActionHandlers = {
     list_leads(input, context) {
@@ -241,10 +241,10 @@ function buildCloseError(status, payload, mode) {
         optionalString(payload.message) ??
         `Close request failed with status ${status || 502}`;
     if (mode === "validation" && (status === 401 || status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status === 400 || status === 404) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status === 429) {
         return new ProviderRequestError(429, message);

package/src/providers/cloudconvert/runtime.js

@@ -1,10 +1,9 @@
 import { Buffer } from "node:buffer";
 import { compactObject, optionalIntegerLike, optionalNumber, optionalRecord, optionalString } from "../../core/cast.js";
 import { assertPublicHttpUrl } from "../../core/request.js";
-import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, providerInputError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const cloudconvertApiBaseUrl = "https://api.cloudconvert.com/v2";
 const cloudconvertSyncApiBaseUrl = "https://sync.api.cloudconvert.com/v2";
-const cloudconvertDefaultRequestTimeoutMs = 30_000;
 const cloudconvertWaitRequestTimeoutMs = 300_000;
 const cloudconvertJobTasksInclude = ["tasks"];
 const reservedConvertTaskOptionKeys = new Set([
@@ -307,7 +306,7 @@ function buildConversionTypeQuery(input) {
 function buildUrlConversionJobPayload(input) {
     const sourceUrl = assertPublicHttpUrl(requireInputString(input.sourceUrl, "sourceUrl"), {
         fieldName: "sourceUrl",
-        createError: (message) => new ProviderRequestError(400, message),
+        createError: providerInputError,
     }).toString();
     const outputFormat = requireInputString(input.outputFormat, "outputFormat");
     const conversionOptions = optionalRecord(input.conversionOptions) ?? {};
@@ -449,7 +448,7 @@ async function cloudconvertFetch(input) {
         headers.set("content-type", "application/json");
         body = JSON.stringify(input.body);
     }
-    const timeout = createProviderTimeout(input.signal, input.timeoutMs ?? cloudconvertDefaultRequestTimeoutMs);
+    const timeout = createProviderTimeout(input.signal, input.timeoutMs);
     try {
         return await input.fetcher(url, {
             method: input.method ?? "GET",
@@ -460,7 +459,7 @@ async function cloudconvertFetch(input) {
     }
     catch (error) {
         if (isAbortLikeError(error) && timeout.didTimeout()) {
-            throw new ProviderRequestError(504, `CloudConvert ${input.path} request timed out after ${Math.max(1, Math.ceil((input.timeoutMs ?? cloudconvertDefaultRequestTimeoutMs) / 1000))} seconds`);
+            throw new ProviderRequestError(504, `CloudConvert ${input.path} request timed out after ${Math.max(1, Math.ceil((input.timeoutMs ?? defaultProviderRequestTimeoutMs) / 1000))} seconds`);
         }
         throw new ProviderRequestError(502, `CloudConvert ${input.path} request failed: ${error instanceof Error ? error.message : String(error)}`);
     }
@@ -472,13 +471,13 @@ async function toCloudconvertError(response, phase, notFoundAsInvalidInput) {
     const payload = await readCloudconvertPayload(response);
     const message = extractCloudconvertErrorMessage(payload, response.status);
     if (phase === "validate" && (response.status === 401 || response.status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (response.status === 400 || response.status === 422) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (response.status === 404 && notFoundAsInvalidInput) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (response.status === 429) {
         return new ProviderRequestError(429, message);
@@ -550,7 +549,7 @@ function readOptionalPositiveInteger(value, fieldName) {
     if (value == null) {
         return undefined;
     }
-    const parsed = optionalIntegerLike(value, fieldName, (message) => new ProviderRequestError(400, message));
+    const parsed = optionalIntegerLike(value, fieldName, providerInputError);
     if (parsed === undefined || parsed <= 0) {
         throw new ProviderRequestError(400, `${fieldName} must be a positive integer`);
     }

package/src/providers/cloudflare_dns/runtime.js

@@ -1,6 +1,6 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString } from "../../core/cast.js";
 import { queryParams } from "../../core/request.js";
-import { ProviderRequestError, providerUserAgent } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, providerInputError } from "../provider-runtime.js";
 import { readCloudflareCurrentUser } from "./runtime-user.js";
 const cloudflareApiBaseUrl = "https://api.cloudflare.com/client/v4";
 export const cloudflareDnsActionHandlers = {
@@ -277,7 +277,7 @@ function normalizeCloudflareError(response, envelope, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && [400, 401, 403, 404].includes(response.status)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && (response.status === 400 || response.status === 404)) {
         return new ProviderRequestError(response.status, message);

package/src/providers/cloudflare_email_routing/runtime.js

@@ -1,6 +1,6 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalNumber, optionalRecord, optionalString, } from "../../core/cast.js";
 import { queryParams } from "../../core/request.js";
-import { ProviderRequestError, providerUserAgent } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, providerInputError } from "../provider-runtime.js";
 export const cloudflareEmailRoutingApiBaseUrl = "https://api.cloudflare.com/client/v4";
 export const cloudflareEmailRoutingActionHandlers = {
     list_routing_rules(input, context) {
@@ -182,7 +182,7 @@ function normalizeError(response, envelope, phase) {
     if (response.status === 429)
         return new ProviderRequestError(429, message);
     if (phase === "validate" && [400, 401, 403, 404].includes(response.status))
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     return new ProviderRequestError(response.status >= 500 ? 502 : response.status, message);
 }
 function readErrorMessage(envelope) {

package/src/providers/cloudflare_r2/runtime.js

@@ -1,7 +1,7 @@
 import { base64Bytes, compactObject, integer, optionalInteger, optionalRecord, optionalString, requiredRawString, requiredString, } from "../../core/cast.js";
 import { assertPublicHttpUrl, queryParams, readBoundedResponseBytes, storeResponseInTransit, } from "../../core/request.js";
 import { readCloudflareCurrentUser } from "../cloudflare_dns/runtime-user.js";
-import { combineProviderActionHandlers, providerFetch, providerInputError, ProviderRequestError, providerUserAgent, runProviderRequest, } from "../provider-runtime.js";
+import { combineProviderActionHandlers, providerFetch, providerInputError, ProviderRequestError, providerUserAgent, runProviderRequest, providerResponseError, } from "../provider-runtime.js";
 import { cloudflareR2AccountActionHandlers } from "./runtime-account.js";
 import { cloudflareR2BucketSettingsActionHandlers } from "./runtime-bucket-settings.js";
 import { cloudflareR2DomainActionHandlers } from "./runtime-domains.js";
@@ -48,8 +48,8 @@ export const cloudflareR2ActionHandlers = combineProviderActionHandlers("cloudfl
     },
 });
 export async function validateCloudflareR2Credential(values, fetcher, signal) {
-    const apiToken = requiredString(values.apiKey, "apiKey", (message) => new ProviderRequestError(400, message));
-    const accountId = requiredString(values.accountId, "accountId", (message) => new ProviderRequestError(400, message));
+    const apiToken = requiredString(values.apiKey, "apiKey", providerInputError);
+    const accountId = requiredString(values.accountId, "accountId", providerInputError);
     const envelope = await cloudflareR2RequestEnvelope(apiToken, {
         path: `/accounts/${encodeURIComponent(accountId)}/r2/buckets`,
         query: { per_page: 1 },
@@ -327,7 +327,7 @@ async function downloadSourceFile(sourceUrl, signal) {
             // An upstream 401/403 is not our authorization failure, so it must not
             // pass through as this action's own status.
             const message = `failed to download sourceUrl: ${response.status} ${response.statusText}`.trim();
-            throw response.status >= 500 ? new ProviderRequestError(502, message) : providerInputError(message);
+            throw response.status >= 500 ? providerResponseError(message) : providerInputError(message);
         }
         const bytes = await readBoundedResponseBytes(response, {
             maxBytes: maxSourceBytes,
@@ -558,7 +558,7 @@ function normalizeCloudflareR2Error(response, envelope, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && [400, 401, 403, 404].includes(response.status)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && (response.status === 400 || response.status === 404)) {
         return new ProviderRequestError(response.status, message);

package/src/providers/cloudflare_worker/runtime.js

@@ -1,7 +1,7 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString, requiredString, } from "../../core/cast.js";
 import { queryParams } from "../../core/request.js";
 import { readCloudflareCurrentUser } from "../cloudflare_dns/runtime-user.js";
-import { ProviderRequestError, providerUserAgent } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, providerInputError } from "../provider-runtime.js";
 const cloudflareApiBaseUrl = "https://api.cloudflare.com/client/v4";
 const defaultModuleName = "main.js";
 const defaultModuleContentType = "application/javascript+module";
@@ -83,8 +83,8 @@ export const cloudflareWorkerActionHandlers = {
     },
 };
 export async function validateCloudflareWorkerCredential(values, fetcher, signal) {
-    const apiToken = requiredString(values.apiKey, "apiKey", (message) => new ProviderRequestError(400, message));
-    const accountId = requiredString(values.accountId, "accountId", (message) => new ProviderRequestError(400, message));
+    const apiToken = requiredString(values.apiKey, "apiKey", providerInputError);
+    const accountId = requiredString(values.accountId, "accountId", providerInputError);
     let verificationResult;
     try {
         verificationResult = await verifyCloudflareWorkerToken(apiToken, "/user/tokens/verify", { fetcher, signal });
@@ -266,7 +266,7 @@ async function searchWorkerScripts(input, context) {
 }
 async function listBuildTriggers(input, context) {
     const accountId = resolveAccountId(input, context);
-    const scriptTag = requiredString(input.scriptTag, "scriptTag", (message) => new ProviderRequestError(400, message));
+    const scriptTag = requiredString(input.scriptTag, "scriptTag", providerInputError);
     const envelope = await requestEnvelope(context, {
         path: `/accounts/${encodeURIComponent(accountId)}/builds/workers/${encodeURIComponent(scriptTag)}/triggers`,
     }, "execute");
@@ -274,7 +274,7 @@ async function listBuildTriggers(input, context) {
 }
 async function createManualBuild(input, context) {
     const accountId = resolveAccountId(input, context);
-    const triggerUuid = requiredString(input.triggerUuid, "triggerUuid", (message) => new ProviderRequestError(400, message));
+    const triggerUuid = requiredString(input.triggerUuid, "triggerUuid", providerInputError);
     const branch = optionalString(input.branch);
     const commitHash = optionalString(input.commitHash);
     if (!branch && !commitHash) {
@@ -293,7 +293,7 @@ async function createManualBuild(input, context) {
 }
 async function listBuilds(input, context) {
     const accountId = resolveAccountId(input, context);
-    const scriptTag = requiredString(input.scriptTag, "scriptTag", (message) => new ProviderRequestError(400, message));
+    const scriptTag = requiredString(input.scriptTag, "scriptTag", providerInputError);
     const envelope = await requestEnvelope(context, {
         path: `/accounts/${encodeURIComponent(accountId)}/builds/workers/${encodeURIComponent(scriptTag)}/builds`,
         query: {
@@ -308,13 +308,13 @@ async function listBuilds(input, context) {
 }
 async function getBuild(input, context) {
     const accountId = resolveAccountId(input, context);
-    const buildUuid = requiredString(input.buildUuid, "buildUuid", (message) => new ProviderRequestError(400, message));
+    const buildUuid = requiredString(input.buildUuid, "buildUuid", providerInputError);
     const envelope = await requestEnvelope(context, { path: `/accounts/${encodeURIComponent(accountId)}/builds/builds/${encodeURIComponent(buildUuid)}` }, "execute");
     return { build: normalizeBuild(envelope.result) };
 }
 async function getBuildLogs(input, context) {
     const accountId = resolveAccountId(input, context);
-    const buildUuid = requiredString(input.buildUuid, "buildUuid", (message) => new ProviderRequestError(400, message));
+    const buildUuid = requiredString(input.buildUuid, "buildUuid", providerInputError);
     const envelope = await requestEnvelope(context, {
         path: `/accounts/${encodeURIComponent(accountId)}/builds/builds/${encodeURIComponent(buildUuid)}/logs`,
         query: { cursor: optionalString(input.cursor) },
@@ -328,7 +328,7 @@ async function getBuildLogs(input, context) {
 }
 async function cancelBuild(input, context) {
     const accountId = resolveAccountId(input, context);
-    const buildUuid = requiredString(input.buildUuid, "buildUuid", (message) => new ProviderRequestError(400, message));
+    const buildUuid = requiredString(input.buildUuid, "buildUuid", providerInputError);
     const envelope = await requestEnvelope(context, {
         method: "PUT",
         path: `/accounts/${encodeURIComponent(accountId)}/builds/builds/${encodeURIComponent(buildUuid)}/cancel`,
@@ -713,7 +713,7 @@ function normalizeCloudflareError(response, envelope, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && [400, 401, 403, 404].includes(response.status)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && (response.status === 400 || response.status === 404)) {
         return new ProviderRequestError(response.status, message);

package/src/providers/cloudinary/runtime.js

@@ -1,6 +1,6 @@
 import { optionalInteger, optionalRecord, optionalString, requiredRecord, requiredString } from "../../core/cast.js";
 import { assertPublicHttpUrl } from "../../core/request.js";
-import { providerInputError, ProviderRequestError, providerUserAgent } from "../provider-runtime.js";
+import { providerInputError, ProviderRequestError, providerUserAgent, providerResponseError, } from "../provider-runtime.js";
 const cloudinaryApiBaseUrl = "https://api.cloudinary.com/v1_1";
 export const cloudinaryActionHandlers = {
     upload_asset(input, context) {
@@ -179,7 +179,7 @@ function createCloudinaryError(status, payload, phase, fallbackMessage) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && (status === 400 || status === 401 || status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && (status === 400 || status === 404 || status === 409)) {
         return new ProviderRequestError(status === 409 ? 409 : 400, message);
@@ -229,7 +229,7 @@ function normalizeCloudinaryAsset(payload) {
 }
 function readCloudinaryRecord(payload, label) {
     try {
-        return requiredRecord(payload, label, (message) => new ProviderRequestError(502, message));
+        return requiredRecord(payload, label, providerResponseError);
     }
     catch {
         throw new ProviderRequestError(502, `${label} is not an object`);
@@ -255,7 +255,7 @@ function readCloudinaryUploadSource(input) {
     if (fileUrl) {
         return assertPublicHttpUrl(fileUrl, {
             fieldName: "fileUrl",
-            createError: (message) => new ProviderRequestError(400, message),
+            createError: providerInputError,
         }).toString();
     }
     return fileDataUri;

package/src/providers/cloudlayer/runtime.js

@@ -1,6 +1,6 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalNumber, optionalRecord, optionalString, requiredRecord, } from "../../core/cast.js";
 import { assertPublicHttpUrl } from "../../core/request.js";
-import { ProviderRequestError, providerUserAgent } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, providerInputError, providerResponseError, } from "../provider-runtime.js";
 const cloudlayerApiBaseUrl = "https://api.cloudlayer.io";
 const cloudlayerAccountPath = "/v2/account";
 const cloudlayerJobsPath = "/v2/jobs";
@@ -149,13 +149,13 @@ function createCloudlayerError(response, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if ((response.status === 401 || response.status === 403) && phase === "validate") {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (response.status === 401 || response.status === 403) {
         return new ProviderRequestError(401, message);
     }
     if ([400, 404, 422].includes(response.status)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status || 500, message);
 }
@@ -254,7 +254,7 @@ function buildCreatePdfJobBody(input) {
         url: url
             ? assertPublicHttpUrl(url, {
                 fieldName: "url",
-                createError: (message) => new ProviderRequestError(400, message),
+                createError: providerInputError,
             }).toString()
             : undefined,
         template: optionalString(input.template),
@@ -280,7 +280,7 @@ function buildListPath(path, input) {
     return `${url.pathname}${url.search}`;
 }
 function readRecord(value) {
-    return requiredRecord(value, "cloudlayer response", (message) => new ProviderRequestError(502, message));
+    return requiredRecord(value, "cloudlayer response", providerResponseError);
 }
 function readRequiredString(value, fieldName) {
     const parsed = optionalString(value);

package/src/providers/codacy/runtime.js

@@ -177,10 +177,10 @@ async function toCodacyError(response, phase, notFoundAsInvalidInput) {
         return new ProviderRequestError(429, message);
     }
     if (response.status === 400 || response.status === 422) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (response.status === 404 && notFoundAsInvalidInput) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status || 500, message);
 }

package/src/providers/codemagic/runtime.js

@@ -244,10 +244,10 @@ async function toCodemagicError(response, phase, notFoundAsInvalidInput, isV3) {
         return new ProviderRequestError(429, message);
     }
     if (response.status === 400) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (response.status === 404 && notFoundAsInvalidInput) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status || 502, message);
 }

package/src/providers/confluence/executors.js

@@ -1,7 +1,7 @@
 import { Buffer } from "node:buffer";
 import { compactObject, optionalRecord, optionalString, optionalStringArray, requiredString } from "../../core/cast.js";
-import { createProviderTimeout, defineProviderExecutors, defineProviderProxy, isAbortLikeError, ProviderRequestError, readProviderJsonBody, providerUserAgent, } from "../provider-runtime.js";
-import { buildConfluenceOAuthApiBaseUrls, confluenceActionHandlers, confluenceDefaultTimeoutMs, validateConfluenceCredential, } from "./runtime.js";
+import { createProviderTimeout, defineProviderExecutors, defineProviderProxy, isAbortLikeError, ProviderRequestError, readProviderJsonBody, providerUserAgent, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
+import { buildConfluenceOAuthApiBaseUrls, confluenceActionHandlers, validateConfluenceCredential } from "./runtime.js";
 import { confluencePageReadScope, confluencePageWriteScope, confluenceSearchScope, confluenceSpaceReadScope, } from "./scopes.js";
 const service = "confluence";
 const confluenceAccessibleResourcesUrl = "https://api.atlassian.com/oauth/token/accessible-resources";
@@ -49,7 +49,7 @@ export const credentialValidators = {
     },
 };
 async function validateConfluenceOAuthCredential(credential, fetcher, signal) {
-    const timeout = createProviderTimeout(signal, confluenceDefaultTimeoutMs);
+    const timeout = createProviderTimeout(signal);
     let resourcesResponse;
     let resourcesPayload;
     try {
@@ -69,7 +69,7 @@ async function validateConfluenceOAuthCredential(credential, fetcher, signal) {
     }
     catch (error) {
         if (timeout.didTimeout() || isAbortLikeError(error)) {
-            throw new ProviderRequestError(504, `Confluence request timed out after ${Math.ceil(confluenceDefaultTimeoutMs / 1000)} seconds`);
+            throw new ProviderRequestError(504, `Confluence request timed out after ${Math.ceil(defaultProviderRequestTimeoutMs / 1000)} seconds`);
         }
         if (error instanceof ProviderRequestError) {
             throw error;

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

@@ -1,7 +1,6 @@
 import type { CredentialValidationResult } from "../../core/types.ts";
 import type { ProviderActionHandlers } from "../provider-runtime.ts";
 export declare const confluenceValidationPath = "/spaces";
-export declare const confluenceDefaultTimeoutMs = 30000;
 export type ConfluencePhase = "validate" | "execute";
 export interface ConfluenceBasicAuth {
     type: "basic";

package/src/providers/confluence/runtime.js

@@ -1,8 +1,7 @@
 import { Buffer } from "node:buffer";
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString, requiredString, } from "../../core/cast.js";
-import { createProviderTimeout, isAbortLikeError, providerInputError, ProviderRequestError, providerUserAgent, requiredInputString, } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, providerInputError, ProviderRequestError, providerUserAgent, requiredInputString, providerResponseError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 export const confluenceValidationPath = "/spaces";
-export const confluenceDefaultTimeoutMs = 30_000;
 const defaultLimit = 25;
 const atlassianApiOrigin = "https://api.atlassian.com";
 export const confluenceActionHandlers = {
@@ -194,7 +193,7 @@ export async function requestConfluenceJson(input) {
             url.searchParams.set(key, String(value));
         }
     }
-    const timeout = createProviderTimeout(input.signal, confluenceDefaultTimeoutMs);
+    const timeout = createProviderTimeout(input.signal);
     let response;
     let payload;
     try {
@@ -208,7 +207,7 @@ export async function requestConfluenceJson(input) {
     }
     catch (error) {
         if (timeout.didTimeout() || isAbortLikeError(error)) {
-            throw new ProviderRequestError(504, `Confluence request timed out after ${Math.ceil(confluenceDefaultTimeoutMs / 1000)} seconds`);
+            throw new ProviderRequestError(504, `Confluence request timed out after ${Math.ceil(defaultProviderRequestTimeoutMs / 1000)} seconds`);
         }
         if (error instanceof ProviderRequestError) {
             throw error;
@@ -252,13 +251,13 @@ async function readConfluencePayload(response) {
 function createConfluenceError(response, payload, phase, notFoundAsInvalidInput) {
     const message = extractConfluenceErrorMessage(payload) ?? response.statusText ?? "Confluence request failed";
     if (phase === "validate" && (response.status === 401 || response.status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (notFoundAsInvalidInput && response.status === 404) {
         return new ProviderRequestError(404, message);
     }
     if (response.status === 400) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status || 502, message, payload);
 }
@@ -384,7 +383,7 @@ function buildOptionalPageBody(input) {
 function requireObject(value, message) {
     const object = optionalRecord(value);
     if (!object) {
-        throw new ProviderRequestError(502, message);
+        throw providerResponseError(message);
     }
     return object;
 }

package/src/providers/contactout/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalInteger, optionalRecord, optionalString, requiredRecord } from "../../core/cast.js";
-import { ProviderRequestError, providerUserAgent, requiredResponseRecord } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, requiredResponseRecord, providerInputError, } from "../provider-runtime.js";
 export const contactoutApiBaseUrl = "https://api.contactout.com";
 export const contactoutActionHandlers = {
     enrich_linkedin_profile(input, context) {
@@ -158,13 +158,13 @@ async function readContactoutPayload(response) {
 function mapContactoutError(status, payload, phase) {
     const message = readContactoutErrorMessage(payload, status);
     if (phase === "validate" && (status === 400 || status === 401)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && (status === 401 || status === 403)) {
         return new ProviderRequestError(status, message);
     }
     if (status === 400 || status === 401 || status === 403 || status === 404 || status === 422) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status || 500, message, payload);
 }
@@ -191,7 +191,7 @@ function flattenFiltersInput(input, passthroughKeys) {
     return body;
 }
 function requireFilters(value) {
-    const filters = requiredRecord(value, "filters", (message) => new ProviderRequestError(400, message));
+    const filters = requiredRecord(value, "filters", providerInputError);
     if (Object.keys(filters).length === 0) {
         throw new ProviderRequestError(400, "filters must contain at least one search filter.");
     }
@@ -214,5 +214,5 @@ function assertAnyString(input, keys, message) {
     if (keys.some((key) => optionalString(input[key]))) {
         return;
     }
-    throw new ProviderRequestError(400, message);
+    throw providerInputError(message);
 }

package/src/providers/contentful/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString } from "../../core/cast.js";
-import { ProviderRequestError, providerUserAgent, requiredInputString, requiredResponseRecord, } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, requiredInputString, requiredResponseRecord, providerInputError, } from "../provider-runtime.js";
 export const contentfulApiBaseUrl = "https://api.contentful.com";
 export const contentfulJsonContentType = "application/vnd.contentful.management.v1+json";
 export const contentfulActionHandlers = {
@@ -263,7 +263,7 @@ function buildContentfulHeaders(apiKey, extraHeaders, includeJsonContentType = f
 function createContentfulError(response, payload, notFoundMessage, invalidInputMessage) {
     const message = optionalString(optionalRecord(payload)?.message);
     if (response.status === 404 && notFoundMessage) {
-        return new ProviderRequestError(400, notFoundMessage);
+        return providerInputError(notFoundMessage);
     }
     if (response.status === 400) {
         return new ProviderRequestError(400, message ?? "invalid Contentful request");

package/src/providers/contentstack_content_delivery/runtime.js

@@ -272,7 +272,7 @@ async function readContentstackPayload(response) {
 function createContentstackError(status, payload, phase) {
     const message = extractContentstackErrorMessage(payload) ?? `Contentstack Content Delivery request failed with status ${status}`;
     if (phase === "validate" && status >= 400 && status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status >= 400 && status < 500) {
         return new ProviderRequestError(status, message);

package/src/providers/contextdev/actions.d.ts

@@ -0,0 +1,14 @@
+import type { ActionDefinition } from "../../core/types.ts";
+export interface ContextdevEndpoint {
+    name: string;
+    path: string;
+    method: "GET" | "POST" | "PATCH" | "DELETE";
+    pathKeys: readonly string[];
+    queryKeys: readonly string[];
+    headerKeys: Readonly<Record<string, string>>;
+    action: ActionDefinition;
+}
+declare const contextdevEndpoints: readonly ContextdevEndpoint[];
+export declare const contextdevActions: readonly ActionDefinition[];
+export declare const contextdevEndpointByName: Map<string, (typeof contextdevEndpoints)[number]>;
+export {};