@jskit-ai/connectors-catalog 0.2.3 → 0.2.4

package/src/server/linkedin.js

@@ -1,4 +1,4 @@
-import { ConnectorError } from "@jskit-ai/connectors-core/server";
+import { ConnectorError, providerStatusError } from "@jskit-ai/connectors-core/server";
 import { linkedinDefinition } from "../shared/linkedin.js";
 import { jsonOperation } from "./jsonOperation.js";
 
@@ -54,7 +54,7 @@ const linkedinProvider = Object.freeze({
         specificContent: { "com.linkedin.ugc.ShareContent": { shareCommentary: { text: options.body.text }, shareMediaCategory: "NONE" } },
         visibility: { "com.linkedin.ugc.MemberNetworkVisibility": options.body.visibility } }) });
     await response.body?.cancel();
-    if (!response.ok) throw Object.assign(new Error("LinkedIn publishing failed."), { status: response.status });
+    if (!response.ok) throw providerStatusError(response.status);
     if (response.status !== 201) throw new ConnectorError("connector_response_invalid", "LinkedIn did not confirm post creation.", { statusCode: 502, messageCode: "connectors.linkedin.didNotConfirmPostCreation" });
     return { id: response.headers.get("x-restli-id") };
   },

package/src/server/mcpTransport.js

@@ -1,6 +1,6 @@
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import { ConnectorError } from "@jskit-ai/connectors-core/server";
+import { ConnectorError, providerStatusError } from "@jskit-ai/connectors-core/server";
 import { jsonOperation } from "./jsonOperation.js";
 
 function mcpOperations(endpoint) {
@@ -21,6 +21,12 @@ function mcpOperations(endpoint) {
   };
 }
 
+/**
+ * Sends one MCP request to the provider's endpoint over the connection's fetch.
+ * @param {string} endpoint
+ * @param {{ headers: Record<string, string>, signal: AbortSignal, body: any }} options
+ * @param {import("@jskit-ai/connectors-core/server/types").ConnectorExchangeTransport} transport
+ */
 async function exchangeMcp(endpoint, { headers, signal, body }, { fetchImpl }) {
   const client = new Client({ name: "jskit-connectors", version: "0.1.0" }, { capabilities: {} });
   let cleanup = false;
@@ -37,9 +43,7 @@ async function exchangeMcp(endpoint, { headers, signal, body }, { fetchImpl }) {
       const response = await fetchImpl(address, { ...init, headers: requestHeaders, credentials: "omit", redirect: "error", signal: requestSignal });
       if (!response.ok && !(response.status === 405 && ["GET", "DELETE"].includes(init.method))) {
         await response.body?.cancel();
-        const error = new Error("MCP request failed.");
-        error.statusCode = response.status;
-        throw error;
+        throw providerStatusError(response.status);
       }
       return response;
     }

package/src/server/microsoft-fabric.js

@@ -2,10 +2,10 @@ import { isDeepStrictEqual } from "node:util";
 import { ConnectorError } from "@jskit-ai/connectors-core/server";
 import { microsoftFabricDefinition, delegatedScope, serviceScope } from "../shared/microsoft-fabric.js";
 import { jsonOperation } from "./jsonOperation.js";
+import { isRecord } from "@jskit-ai/kernel/shared/support/normalize";
 
-const object = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
 const name = (value) => typeof value === "string" && /^[_A-Za-z][_0-9A-Za-z]*$/u.test(value);
-const validResult = (value) => object(value?.data) &&
+const validResult = (value) => isRecord(value?.data) &&
   (value.errors === undefined || (Array.isArray(value.errors) && value.errors.length === 0));
 const endpoint = (settings) => settings.graphqlEndpoint;
 const permissions = [delegatedScope, serviceScope];
@@ -51,7 +51,7 @@ const microsoftFabricProvider = Object.freeze({
   operations: {
     "connection.check": fixedQuery("query ConnectorFabricCheck { __typename }", (data) => name(data.__typename)),
     "schema.types": fixedQuery("query ConnectorFabricTypes { __schema { types { name kind } queryType { name } mutationType { name } } }",
-      (data) => object(data.__schema) && Array.isArray(data.__schema.types) && data.__schema.types.every((type) => name(type?.name) &&
+      (data) => isRecord(data.__schema) && Array.isArray(data.__schema.types) && data.__schema.types.every((type) => name(type?.name) &&
         ["SCALAR", "OBJECT", "INTERFACE", "UNION", "ENUM", "INPUT_OBJECT", "LIST", "NON_NULL"].includes(type.kind)) &&
         name(data.__schema.queryType?.name) && (data.__schema.mutationType === null || name(data.__schema.mutationType?.name))),
     "graphql.execute": {

package/src/server/microsoft-onedrive.js

@@ -1,4 +1,4 @@
-import { ConnectorError } from "@jskit-ai/connectors-core/server";
+import { ConnectorError, providerStatusError } from "@jskit-ai/connectors-core/server";
 import { createSchema } from "json-rest-schema";
 import { validateSchemaPayload } from "@jskit-ai/kernel/shared/validators";
 import { microsoftOneDriveDefinition } from "../shared/microsoft.js";
@@ -50,7 +50,7 @@ const microsoftOneDriveProvider = Object.freeze({ ...base,
     const response = await fetchImpl(address, { ...options, credentials: "omit", redirect: "error" });
     if (!response.ok) {
       await response.body?.cancel();
-      throw Object.assign(new Error("OneDrive upload failed; inspect the folder before retrying."), { status: response.status });
+      throw providerStatusError(response.status);
     }
     return response.json();
   }

package/src/server/microsoft-onenote.js

@@ -1,8 +1,9 @@
 import { createSchema } from "json-rest-schema";
 import { validateSchemaPayload } from "@jskit-ai/kernel/shared/validators";
-import { ConnectorError } from "@jskit-ai/connectors-core/server";
+import { ConnectorError, providerStatusError } from "@jskit-ai/connectors-core/server";
 import { microsoftOneNoteDefinition } from "../shared/microsoft.js";
 import { graphRead, microsoftProvider, pageSize } from "./microsoft.js";
+import { hasStringId } from "./connectorValues.js";
 
 const id = { type: "string", required: true, minLength: 1, maxLength: 1024,
   validator: value => /^[A-Za-z0-9!_{}:.-]+$/u.test(value) && value !== "." && value !== ".." || "Use the returned OneNote resource ID." };
@@ -20,7 +21,7 @@ const base = microsoftProvider(microsoftOneNoteDefinition, "common", "notebooks.
     const { pageId } = validateSchemaPayload({ schema: contentSchema, mode: "replace" }, input, { statusCode: 422 });
     return { method: "GET", url: `${origin}/pages/${encodeURIComponent(pageId)}/content?includeIDs=true` };
   } },
-  "pages.create": { scopes: ["Notes.Create", "Notes.ReadWrite", "Notes.ReadWrite.All"], validateResult: value => typeof value?.id === "string", request(input) {
+  "pages.create": { scopes: ["Notes.Create", "Notes.ReadWrite", "Notes.ReadWrite.All"], validateResult: hasStringId, request(input) {
     const { sectionId, title, text } = validateSchemaPayload({ schema: createSchemaPage, mode: "replace" }, input, { statusCode: 422 });
     return { method: "POST", url: `${origin}/sections/${encodeURIComponent(sectionId)}/pages`, headers: { "Content-Type": "text/html" },
       body: `<!DOCTYPE html><html><head><title>${escape(title)}</title></head><body><p>${escape(text).replaceAll("\n", "<br />")}</p></body></html>` };
@@ -37,7 +38,7 @@ const microsoftOneNoteProvider = Object.freeze({ ...base,
     const create = new Headers(options.headers).get("content-type") === "text/html";
     if (!content && !create) return request(address, options);
     const response = await fetchImpl(address, { ...options, credentials: "omit", redirect: "error" });
-    if (!response.ok) { await response.body?.cancel(); throw Object.assign(new Error("OneNote request failed."), { status: response.status }); }
+    if (!response.ok) { await response.body?.cancel(); throw providerStatusError(response.status); }
     if (create) return response.json();
     const reader = response.body?.getReader(); const chunks = []; let size = 0;
     if (reader) try { while (true) {

package/src/server/microsoft-outlook.js

@@ -1,7 +1,8 @@
 import { createSchema } from "json-rest-schema";
 import { validateSchemaPayload } from "@jskit-ai/kernel/shared/validators";
-import { ConnectorError } from "@jskit-ai/connectors-core/server";
+import { ConnectorError, providerStatusError } from "@jskit-ai/connectors-core/server";
 import { microsoftOutlookDefinition } from "../shared/microsoft.js";
+import { hasStringId } from "./connectorValues.js";
 import { graphRead, microsoftProvider, pageSize } from "./microsoft.js";
 
 const id = { type: "string", required: true, minLength: 1, maxLength: 2048,
@@ -9,8 +10,7 @@ const id = { type: "string", required: true, minLength: 1, maxLength: 2048,
 const text = { type: "string", required: true, minLength: 1, maxLength: 100000, noTrim: true };
 const instant = { type: "string", required: true, maxLength: 30,
   validator: value => /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/u.test(value) && Number.isFinite(Date.parse(value)) || "Use a UTC ISO timestamp ending in Z." };
-const resource = value => typeof value?.id === "string";
-function operation(scopes, fields, destination, validateResult = resource) {
+function operation(scopes, fields, destination, validateResult = hasStringId) {
   const schema = createSchema(fields);
   return { scopes, validateResult, request(input) {
     return destination(validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 }));
@@ -19,9 +19,9 @@ function operation(scopes, fields, destination, validateResult = resource) {
 const url = path => `https://graph.microsoft.com/v1.0/me${path}`;
 
 const base = microsoftProvider(microsoftOutlookDefinition, "common", "folders.list", {
-  "messages.get": operation(["Mail.Read"], { messageId: id }, ({ messageId }) => ({ method: "GET", url: url(`/messages/${encodeURIComponent(messageId)}`), headers: { Prefer: 'outlook.body-content-type="text"' } }), value => resource(value) && typeof value.body?.content === "string"),
+  "messages.get": operation(["Mail.Read"], { messageId: id }, ({ messageId }) => ({ method: "GET", url: url(`/messages/${encodeURIComponent(messageId)}`), headers: { Prefer: 'outlook.body-content-type="text"' } }), value => hasStringId(value) && typeof value.body?.content === "string"),
   "attachments.list": graphRead("Mail.Read", { messageId: id }, ({ messageId }) => ({ pathname: `/me/messages/${encodeURIComponent(messageId)}/attachments` })),
-  "attachments.get": operation(["Mail.Read"], { messageId: id, attachmentId: id }, ({ messageId, attachmentId }) => ({ method: "GET", url: url(`/messages/${encodeURIComponent(messageId)}/attachments/${encodeURIComponent(attachmentId)}`) }), value => resource(value) && value["@odata.type"] === "#microsoft.graph.fileAttachment" && typeof value.contentBytes === "string" && value.contentBytes.length <= 6666668),
+  "attachments.get": operation(["Mail.Read"], { messageId: id, attachmentId: id }, ({ messageId, attachmentId }) => ({ method: "GET", url: url(`/messages/${encodeURIComponent(messageId)}/attachments/${encodeURIComponent(attachmentId)}`) }), value => hasStringId(value) && value["@odata.type"] === "#microsoft.graph.fileAttachment" && typeof value.contentBytes === "string" && value.contentBytes.length <= 6666668),
   "messages.setRead": operation(["Mail.ReadWrite"], { messageId: id, isRead: { type: "boolean", required: true } }, ({ messageId, isRead }) => ({ method: "PATCH", url: url(`/messages/${encodeURIComponent(messageId)}`), body: { isRead } })),
   "messages.move": operation(["Mail.ReadWrite"], { messageId: id, destinationId: id }, ({ messageId, destinationId }) => ({ method: "POST", url: url(`/messages/${encodeURIComponent(messageId)}/move`), body: { destinationId } })),
   "messages.send": operation(["Mail.Send"], {
@@ -51,7 +51,7 @@ const microsoftOutlookProvider = Object.freeze({ ...base,
     if (new URL(address).pathname !== "/v1.0/me/sendMail") return request(address, options);
     const response = await fetchImpl(address, { ...options, body: JSON.stringify(options.body), headers: { ...options.headers, "Content-Type": "application/json" }, credentials: "omit", redirect: "error" });
     await response.body?.cancel();
-    if (response.status !== 202) throw Object.assign(new Error("Outlook did not accept the message."), { status: response.ok ? 502 : response.status });
+    if (response.status !== 202) throw providerStatusError(response.status);
     return { accepted: true };
   }
 });

package/src/server/microsoft-sharepoint.js

@@ -3,6 +3,8 @@ import { validateSchemaPayload } from "@jskit-ai/kernel/shared/validators";
 import { microsoftSharePointDefinition } from "../shared/microsoft.js";
 import { graphRead, microsoftProvider, driveItemId, pageSize } from "./microsoft.js";
 import { microsoftOneDriveProvider } from "./microsoft-onedrive.js";
+import { hasStringId } from "./connectorValues.js";
+import { isRecord } from "@jskit-ai/kernel/shared/support/normalize";
 
 const siteId = { type: "string", required: true, minLength: 1, maxLength: 512,
   validator: value => /^[A-Za-z0-9.,_-]+$/u.test(value) && value !== "." && value !== ".." || "Use the site's returned ID, not its URL." };
@@ -33,11 +35,11 @@ const base = microsoftProvider(microsoftSharePointDefinition, "organizations", "
   "files.upload": fileOperation("files.upload", ["Sites.ReadWrite.All"]),
   "lists.list": graphRead("Sites.Read.All", { siteId }, ({ siteId }) => ({ pathname: `/sites/${encodeURIComponent(siteId)}/lists` })),
   "listItems.list": graphRead("Sites.Read.All", { siteId, listId, pageSize }, ({ siteId, listId, pageSize }) => ({ pathname: `/sites/${encodeURIComponent(siteId)}/lists/${encodeURIComponent(listId)}/items`, query: { $expand: "fields", $top: pageSize } })),
-  "listItems.create": { scopes: ["Sites.ReadWrite.All"], validateResult: value => typeof value?.id === "string", request(input) {
+  "listItems.create": { scopes: ["Sites.ReadWrite.All"], validateResult: hasStringId, request(input) {
     const { siteId, listId, fields } = validateSchemaPayload({ schema: createItemSchema, mode: "replace" }, input, { statusCode: 422 });
     return { method: "POST", url: `https://graph.microsoft.com/v1.0/sites/${encodeURIComponent(siteId)}/lists/${encodeURIComponent(listId)}/items`, body: { fields } };
   } },
-  "listItems.update": { scopes: ["Sites.ReadWrite.All"], validateResult: value => value !== null && typeof value === "object" && !Array.isArray(value), request(input) {
+  "listItems.update": { scopes: ["Sites.ReadWrite.All"], validateResult: isRecord, request(input) {
     const { siteId, listId, itemId, fields, eTag } = validateSchemaPayload({ schema: updateItemSchema, mode: "replace" }, input, { statusCode: 422 });
     return { method: "PATCH", url: `https://graph.microsoft.com/v1.0/sites/${encodeURIComponent(siteId)}/lists/${encodeURIComponent(listId)}/items/${encodeURIComponent(itemId)}/fields`, headers: { "If-Match": eTag }, body: fields };
   } }

package/src/server/microsoft-teams.js

@@ -2,6 +2,7 @@ import { createSchema } from "json-rest-schema";
 import { validateSchemaPayload } from "@jskit-ai/kernel/shared/validators";
 import { microsoftTeamsDefinition } from "../shared/microsoft.js";
 import { graphRead, microsoftProvider } from "./microsoft.js";
+import { hasStringId } from "./connectorValues.js";
 
 const id = { type: "string", required: true, minLength: 1, maxLength: 1024,
   validator: value => /^[A-Za-z0-9_:@.=-]+$/u.test(value) && value !== "." && value !== ".." || "Use the returned Teams resource ID." };
@@ -10,7 +11,7 @@ const pageSize = { type: "integer", min: 1, max: 50, defaultTo: 25 };
 const channelPath = ({ teamId, channelId }) => `/teams/${encodeURIComponent(teamId)}/channels/${encodeURIComponent(channelId)}`;
 function send(scope, fields, path) {
   const schema = createSchema({ ...fields, text: { type: "string", required: true, minLength: 1, maxLength: 20000, noTrim: true } });
-  return { scopes: [scope], validateResult: value => typeof value?.id === "string", request(input) {
+  return { scopes: [scope], validateResult: hasStringId, request(input) {
     const values = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
     return { method: "POST", url: `https://graph.microsoft.com/v1.0${path(values)}`, body: { body: { contentType: "text", content: values.text } } };
   } };

package/src/server/microsoft.js

@@ -1,6 +1,7 @@
 import { createSchema } from "json-rest-schema";
 import { validateSchemaPayload } from "@jskit-ai/kernel/shared/validators";
 import { ConnectorError } from "@jskit-ai/connectors-core/server";
+import { isRecord } from "@jskit-ai/kernel/shared/support/normalize";
 
 const graphOrigin = "https://graph.microsoft.com";
 const pageSize = { type: "integer", min: 1, max: 100, defaultTo: 25 };
@@ -48,13 +49,16 @@ function microsoftProvider(definition, authority, checkOperation, operations) {
       authorization_endpoint: `https://login.microsoftonline.com/${tenantId}/oauth2/v2.0/authorize`,
       token_endpoint: `https://login.microsoftonline.com/${tenantId}/oauth2/v2.0/token`
     }),
-    authorizationParameters: { response_mode: "query" }, apiOrigins: [graphOrigin], checkOperation, operations
+    authorizationParameters: { response_mode: "query" },
+    apiOrigins: [graphOrigin],
+    checkOperation,
+    operations
   });
 }
 
 function microsoftDocumentProvider(definition, extensions) {
   const fields = "id,name,size,webUrl,file,folder,parentReference,lastModifiedDateTime,eTag";
-  const facet = (value) => value === undefined || (value !== null && typeof value === "object" && !Array.isArray(value));
+  const facet = (value) => value === undefined || isRecord(value);
   const metadata = (value) => typeof value?.id === "string" && value.id.length > 0 &&
     typeof value.name === "string" && value.name.length > 0 && facet(value.file) && facet(value.folder);
   const matches = (value) => value?.file && extensions.includes(value.name.split(".").at(-1).toLowerCase());
@@ -72,18 +76,21 @@ function microsoftDocumentProvider(definition, extensions) {
       return { method: "GET", url: url.href };
     } }
   });
-  return Object.freeze({ ...provider, async exchange(address, options, { request }) {
-    const result = await request(address, options);
-    if (new URL(address).pathname.endsWith("/children")) {
-      if (!provider.operations["items.list"].validateResult(result)) {
-        throw new ConnectorError("connector_response_invalid", "Microsoft returned an invalid file list.", { statusCode: 502, messageCode: "connectors.microsoft.returnedInvalidFileList" });
+  return Object.freeze({
+    ...provider,
+    async exchange(address, options, { request }) {
+      const result = await request(address, options);
+      if (new URL(address).pathname.endsWith("/children")) {
+        if (!provider.operations["items.list"].validateResult(result)) {
+          throw new ConnectorError("connector_response_invalid", "Microsoft returned an invalid file list.", { statusCode: 502, messageCode: "connectors.microsoft.returnedInvalidFileList" });
+        }
+        return { ...result, value: result.value.filter((item) => item.folder || matches(item)) };
       }
-      return { ...result, value: result.value.filter((item) => item.folder || matches(item)) };
+      if (!metadata(result)) throw new ConnectorError("connector_response_invalid", "Microsoft returned invalid file metadata.", { statusCode: 502, messageCode: "connectors.microsoft.returnedInvalidFileMetadata" });
+      if (!matches(result)) throw new ConnectorError("connector_document_type_invalid", `Choose a ${definition.name} file.`,
+        { messageCode: "connectors.microsoft.chooseDocumentFile", messageParams: { product: definition.name } });
+      return result;
     }
-    if (!metadata(result)) throw new ConnectorError("connector_response_invalid", "Microsoft returned invalid file metadata.", { statusCode: 502, messageCode: "connectors.microsoft.returnedInvalidFileMetadata" });
-    if (!matches(result)) throw new ConnectorError("connector_document_type_invalid", `Choose a ${definition.name} file.`,
-      { messageCode: "connectors.microsoft.chooseDocumentFile", messageParams: { product: definition.name } });
-    return result;
-  } });
+  });
 }
 export { graphRead, microsoftProvider, microsoftDocumentProvider, pageSize, driveItemId };

package/src/server/notion.js

@@ -4,8 +4,9 @@ import { mcpOperations, exchangeMcp } from "./mcpTransport.js";
 import { mcpRegistrationFields, registerMcpClient } from "./mcpRegistration.js";
 import { notionDefinition } from "../shared/tokens.js";
 import { jsonOperation, validatedOperation } from "./jsonOperation.js";
+import { UUID_SOURCE } from "../shared/uuid.js";
 
-const identifier = { type: "string", required: true, pattern: "^(?:[a-fA-F0-9]{32}|[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})$" };
+const identifier = { type: "string", required: true, pattern: `^(?:[a-fA-F0-9]{32}|${UUID_SOURCE})$` };
 const document = { type: "object", additionalProperties: true,
   validator: value => Buffer.byteLength(JSON.stringify(value)) <= 65536 || "Keep each document below 64 KiB." };
 const pagination = { page_size: { type: "integer", min: 1, max: 100, defaultTo: 100 },

package/src/server/pipedrive.js

@@ -3,6 +3,7 @@ import { validateSchemaPayload } from "@jskit-ai/kernel/shared/validators";
 import { pipedriveDefinition } from "../shared/tokens.js";
 import { jsonOperation } from "./jsonOperation.js";
 import { ConnectorError } from "@jskit-ai/connectors-core/server";
+import { UUID_SOURCE } from "../shared/uuid.js";
 
 function companyApiDomain(value) {
   if (typeof value !== "string" || !/^https:\/\/[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.pipedrive\.com$/.test(value)) {
@@ -26,7 +27,7 @@ const recordFields = {
 };
 function crmOperation(collection, action) {
   const lead = collection === "leads", write = ["create", "update"].includes(action);
-  const id = lead ? { type: "string", pattern: "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$" } : numberId;
+  const id = lead ? { type: "string", pattern: `^${UUID_SOURCE}$` } : numberId;
   const primary = ["deals", "leads"].includes(collection) ? "title" : collection === "activities" ? "subject" : "name";
   const fields = write ? { ...recordFields[collection], ...(action === "create" ? { [primary]: { ...text, required: true } } : {}) } : action === "list"
     ? { limit: { type: "integer", min: 1, max: 500, defaultTo: 100 }, ...(lead ? { start: { type: "integer", min: 0 } } : { cursor: { type: "string", minLength: 1, maxLength: 4096 } }) } : {};

package/src/server/salesforce.js

@@ -1,19 +1,19 @@
 import { createSchema } from "json-rest-schema";
 import { validateSchemaPayload } from "@jskit-ai/kernel/shared/validators";
-import { ConnectorError } from "@jskit-ai/connectors-core/server";
+import { ConnectorError, providerStatusError } from "@jskit-ai/connectors-core/server";
 import { salesforceDefinition } from "../shared/salesforce.js";
 import { jsonOperation } from "./jsonOperation.js";
+import { isRecord } from "@jskit-ai/kernel/shared/support/normalize";
+import { accountOrigin } from "./connectorValues.js";
 
 const apiPath = "/services/data/v66.0";
-const origin = (settings) => new URL(settings.accountUrl).origin;
-const endpoint = (resource) => (settings) => `${origin(settings)}${apiPath}/${resource}`;
+const endpoint = (resource) => (settings) => `${accountOrigin(settings)}${apiPath}/${resource}`;
 const objectName = (value) => typeof value === "string" && /^[A-Za-z][A-Za-z0-9_]{0,254}$/u.test(value);
 const locator = (value) => typeof value === "string" && /^\/services\/data\/v66\.0\/query\/[A-Za-z0-9]{15,18}-[0-9]{1,10}$/u.test(value);
-const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
-const limits = (value) => record(value) && Number.isSafeInteger(value.DailyApiRequests?.Max) && value.DailyApiRequests.Max >= 0 &&
+const limits = (value) => isRecord(value) && Number.isSafeInteger(value.DailyApiRequests?.Max) && value.DailyApiRequests.Max >= 0 &&
   Number.isSafeInteger(value.DailyApiRequests.Remaining) && value.DailyApiRequests.Remaining >= 0;
 const queryResult = (value) => Number.isSafeInteger(value?.totalSize) && value.totalSize >= 0 && typeof value.done === "boolean" &&
-  Array.isArray(value.records) && value.records.length <= 2000 && value.records.every(record) && value.records.length <= value.totalSize &&
+  Array.isArray(value.records) && value.records.length <= 2000 && value.records.every(isRecord) && value.records.length <= value.totalSize &&
   (value.done ? value.nextRecordsUrl == null : locator(value.nextRecordsUrl));
 const describeSchema = createSchema({ object: { type: "string", required: true, validator: (value) => objectName(value) || "Use a Salesforce object API name." } });
 const nextSchema = createSchema({ nextRecordsUrl: { type: "string", required: true, noTrim: true,
@@ -21,13 +21,13 @@ const nextSchema = createSchema({ nextRecordsUrl: { type: "string", required: tr
 
 const salesforceProvider = Object.freeze({
   ...salesforceDefinition,
-  oauth: (settings) => ({ issuer: origin(settings), authorization_endpoint: `${origin(settings)}/services/oauth2/authorize`, token_endpoint: `${origin(settings)}/services/oauth2/token` }),
-  apiOrigins: (settings) => [origin(settings)], checkOperation: "limits.read",
+  oauth: (settings) => ({ issuer: accountOrigin(settings), authorization_endpoint: `${accountOrigin(settings)}/services/oauth2/authorize`, token_endpoint: `${accountOrigin(settings)}/services/oauth2/token` }),
+  apiOrigins: (settings) => [accountOrigin(settings)], checkOperation: "limits.read",
   async normalizeTokenResponse(response, { settings }) {
     if (!response.ok) return response;
     let value;
     try { value = await response.clone().json(); } catch { /* reported below */ }
-    if (!record(value) || ![origin(settings), origin(settings) + "/"].includes(value.instance_url) || typeof value.scope !== "string" || !value.scope.trim()) {
+    if (!isRecord(value) || ![accountOrigin(settings), accountOrigin(settings) + "/"].includes(value.instance_url) || typeof value.scope !== "string" || !value.scope.trim()) {
       throw new ConnectorError("connector_response_invalid", "Salesforce returned an invalid grant or a different organisation.", { statusCode: 502, messageCode: "connectors.salesforce.returnedInvalidGrantDifferentOrganisation" });
     }
     // Salesforce can omit expiry. Renew after five minutes of use as a local
@@ -54,7 +54,7 @@ const salesforceProvider = Object.freeze({
       scopes: ["api"],
       request(input, settings) {
         const values = validateSchemaPayload({ schema: nextSchema, mode: "replace" }, input, { statusCode: 422 });
-        return { method: "GET", url: origin(settings) + values.nextRecordsUrl };
+        return { method: "GET", url: accountOrigin(settings) + values.nextRecordsUrl };
       },
       validateResult: queryResult
     }
@@ -70,9 +70,9 @@ const salesforceProvider = Object.freeze({
       if (code === "INVALID_QUERY_LOCATOR") throw new ConnectorError("connector_cursor_expired", "Start the Salesforce query again; its result cursor is no longer valid.", { statusCode: 410, messageCode: "connectors.salesforce.startQueryAgainResultCursor" });
       if (response.status === 404) throw new ConnectorError("connector_resource_not_found", "This Salesforce resource is not available.", { statusCode: 404, messageCode: "connectors.shared.resourceUnavailable", messageParams: { provider: "Salesforce" } });
       if (response.status === 400) throw new ConnectorError("connector_query_invalid", "Salesforce rejected the query or object. Check its API names and the user's permissions.", { statusCode: 422, messageCode: "connectors.salesforce.rejectedQueryObjectCheckApi" });
-      throw Object.assign(new Error("Salesforce request failed."), { status: response.status });
+      throw providerStatusError(response.status);
     }
-    if (response.status !== 200 || !record(value)) throw new ConnectorError("connector_response_invalid", "Salesforce returned an unexpected response.", { statusCode: 502, messageCode: "connectors.shared.unexpectedResponse", messageParams: { provider: "Salesforce" } });
+    if (response.status !== 200 || !isRecord(value)) throw new ConnectorError("connector_response_invalid", "Salesforce returned an unexpected response.", { statusCode: 502, messageCode: "connectors.shared.unexpectedResponse", messageParams: { provider: "Salesforce" } });
     const url = new URL(address);
     if (url.pathname.endsWith("/describe") && value.name !== url.pathname.split("/").at(-2)) {
       throw new ConnectorError("connector_response_invalid", "Salesforce described a different object.", { statusCode: 502, messageCode: "connectors.salesforce.describedDifferentObject" });

package/src/server/semrush.js

@@ -3,6 +3,8 @@ import { validateSchemaPayload } from "@jskit-ai/kernel/shared/validators";
 import { ConnectorError } from "@jskit-ai/connectors-core/server";
 import { semrushDefinition } from "../shared/semrush.js";
 import { jsonOperation } from "./jsonOperation.js";
+import { isCount } from "./connectorValues.js";
+import { isRecord } from "@jskit-ai/kernel/shared/support/normalize";
 
 const projectsUrl = "https://api.semrush.com/apis/v4/projects/v1/projects";
 const projectSchema = createSchema({ projectId: { type: "integer", required: true, min: 1, max: Number.MAX_SAFE_INTEGER } });
@@ -60,7 +62,7 @@ function semrushKeywordReport(target, kind) {
   };
 }
 
-const trackingObject = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value) && value.error === undefined);
+const trackingObject = (value) => Boolean(isRecord(value) && value.error === undefined);
 
 function semrushTrackingReport(type, positions = false) {
   const operation = jsonOperation("https://api.semrush.com/", {
@@ -133,22 +135,21 @@ function v4Result(check, status = 200) {
     typeof value.meta.request_id === "string" && value.meta.request_id.length > 0 && value.error === undefined &&
     Boolean(check(value, new URL(request.url), request));
 }
-const count = (value) => Number.isSafeInteger(value) && value >= 0;
 // Backlink reports keep the requested scope and, when Semrush supplies them, the requested page bounds.
 function backlinkResult(report) {
   return v4Result((value, url) => {
     const { meta, data } = value;
     if (meta.scope !== undefined && meta.scope !== url.searchParams.get("scope")) return false;
-    if (report === "overview") return ["backlinks_count", "domains_count", "urls_count", "score"].every((field) => count(data?.[field]));
+    if (report === "overview") return ["backlinks_count", "domains_count", "urls_count", "score"].every((field) => isCount(data?.[field]));
     // Some report envelopes omit pagination metadata; validate it when supplied.
     return Array.isArray(data) && data.length <= Number(url.searchParams.get("limit")) && data.every((row) => {
       if (!row || typeof row !== "object" || Array.isArray(row)) return false;
       if (report === "links") return typeof row.source_url === "string" && typeof row.target_url === "string" &&
         typeof row.anchor === "string" && typeof row.is_nofollow === "boolean";
-      if (report === "ref-domains") return typeof row.domain === "string" && count(row.backlinks_count) && count(row.domain_score);
-      return typeof row.anchor === "string" && count(row.backlinks_count) && count(row.domains_count);
+      if (report === "ref-domains") return typeof row.domain === "string" && isCount(row.backlinks_count) && isCount(row.domain_score);
+      return typeof row.anchor === "string" && isCount(row.backlinks_count) && isCount(row.domains_count);
     }) && ["limit", "offset"].every((field) => meta[field] === undefined || String(meta[field]) === url.searchParams.get(field)) &&
-      (meta.total === undefined || count(meta.total));
+      (meta.total === undefined || isCount(meta.total));
   });
 }
 const requestedProject = (url) => Number(url.pathname.split("/").at(-1));
@@ -222,7 +223,7 @@ const semrushProvider = Object.freeze({
       validateResult: v4Result(({ meta, data }, url) => meta.keyword === url.searchParams.get("keyword") && meta.country === url.searchParams.get("country") &&
         typeof meta.month === "string" && /^\d{4}-(0[1-9]|1[0-2])$/u.test(meta.month) &&
         (!url.searchParams.has("month") || meta.month === url.searchParams.get("month")) &&
-        data !== null && typeof data === "object" && !Array.isArray(data) &&
+        isRecord(data) &&
         ["cpc", "number_of_results", "search_volume"].every((key) => typeof data[key] === "string" && /^\d+$/u.test(data[key])) &&
         ["competitive_density", "keyword_difficulty"].every((key) => Number.isFinite(data[key])) &&
         ["intents", "serp_features"].every((key) => Array.isArray(data[key]) && data[key].every((value) => typeof value === "string")) &&
@@ -249,7 +250,7 @@ const semrushProvider = Object.freeze({
     }, v4Result(({ meta, data }, url) => {
       const limit = Number(url.searchParams.get("limit"));
       return meta.scope === url.searchParams.get("scope") && meta.limit === limit && meta.offset === Number(url.searchParams.get("offset")) &&
-        count(meta.total_count) && Array.isArray(data) && data.length <= limit && data.length <= meta.total_count && data.every(validProject);
+        isCount(meta.total_count) && Array.isArray(data) && data.length <= limit && data.length <= meta.total_count && data.every(validProject);
     })),
     "projects.delete": {
       scopes: [],

package/src/server/snowflake.js

@@ -1,26 +1,26 @@
-import { ConnectorError } from "@jskit-ai/connectors-core/server";
+import { ConnectorError, providerStatusError } from "@jskit-ai/connectors-core/server";
 import { snowflakeDefinition } from "../shared/snowflake.js";
 import { jsonOperation } from "./jsonOperation.js";
+import { isRecord } from "@jskit-ai/kernel/shared/support/normalize";
+import { accountOrigin } from "./connectorValues.js";
+import { isUuid } from "../shared/uuid.js";
 
-const origin = (settings) => new URL(settings.accountUrl).origin;
-const object = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
-const database = (value) => object(value) && typeof value.name === "string" && value.name.length > 0 && value.name.length <= 255 &&
+const database = (value) => isRecord(value) && typeof value.name === "string" && value.name.length > 0 && value.name.length <= 255 &&
   ["owner", "comment", "kind", "created_on"].every((key) => value[key] == null || typeof value[key] === "string");
 const nameFilter = { type: "string", minLength: 1, maxLength: 255, noTrim: true };
-const databasesList = jsonOperation((settings) => `${origin(settings)}/api/v2/databases`, {
+const databasesList = jsonOperation((settings) => `${accountOrigin(settings)}/api/v2/databases`, {
   showLimit: { type: "integer", min: 1, max: 1000, defaultTo: 20 },
   like: nameFilter, startsWith: nameFilter, fromName: nameFilter, history: { type: "boolean", defaultTo: false }
 }, (value) => Array.isArray(value) && value.every(database));
 
-const uuid = (value) => typeof value === "string" && /^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/iu.test(value);
-const uuidField = { type: "string", required: true, validator: (value) => uuid(value) || "Use a Snowflake UUID." };
+const uuidField = { type: "string", required: true, validator: (value) => isUuid(value) || "Use a Snowflake UUID." };
 const bindings = { type: "object", additionalProperties: true, validator: (value) =>
   Object.keys(value).length <= 100 && Object.entries(value).every(([key, binding]) =>
-    /^[1-9][0-9]{0,2}$/u.test(key) && object(binding) && Object.keys(binding).every((name) => ["type", "value"].includes(name)) &&
+    /^[1-9][0-9]{0,2}$/u.test(key) && isRecord(binding) && Object.keys(binding).every((name) => ["type", "value"].includes(name)) &&
     ["FIXED", "REAL", "TEXT", "BINARY", "BOOLEAN", "DATE", "TIME", "TIMESTAMP_LTZ", "TIMESTAMP_NTZ", "TIMESTAMP_TZ"].includes(binding.type) &&
     (binding.value === null || (typeof binding.value === "string" && binding.value.length <= 65536))) || "Use at most 100 numbered typed bindings." };
-const sqlResult = (value) => object(value) && ["pending", "completed", "cancelled"].includes(value.status);
-const submit = jsonOperation((settings) => `${origin(settings)}/api/v2/statements`, {
+const sqlResult = (value) => isRecord(value) && ["pending", "completed", "cancelled"].includes(value.status);
+const submit = jsonOperation((settings) => `${accountOrigin(settings)}/api/v2/statements`, {
   statement: { type: "string", required: true, minLength: 1, maxLength: 65536, noTrim: true },
   requestId: uuidField, bindings, timeout: { type: "integer", min: 1, max: 3600, defaultTo: 60 }
 }, sqlResult, "POST");
@@ -34,7 +34,7 @@ const operations = { "databases.list": databasesList,
   } }
 };
 for (const [operation, cancel] of [["statements.get", false], ["statements.cancel", true]]) {
-  const base = jsonOperation((settings) => `${origin(settings)}/api/v2/statements`, {
+  const base = jsonOperation((settings) => `${accountOrigin(settings)}/api/v2/statements`, {
     handle: uuidField, ...(!cancel ? { partition: { type: "integer", min: 0, max: 100000 } } : {})
   }, sqlResult, "POST");
   operations[operation] = { ...base, request(input, settings) {
@@ -47,7 +47,7 @@ for (const action of ["create", "resize", "resume", "suspend", "delete"]) {
   const fields = { name: { ...nameFilter, required: true }, requestId: uuidField };
   if (["create", "resize"].includes(action)) fields.size = { type: "string", required: true,
     enum: ["XSMALL", "SMALL", "MEDIUM", "LARGE", "XLARGE", "XXLARGE", "XXXLARGE", "X4LARGE", "X5LARGE", "X6LARGE"] };
-  const base = jsonOperation((settings) => `${origin(settings)}/api/v2/statements`, fields, sqlResult, "POST");
+  const base = jsonOperation((settings) => `${accountOrigin(settings)}/api/v2/statements`, fields, sqlResult, "POST");
   operations[`warehouses.${action}`] = { ...base, request(input, settings) {
     const { body } = base.request(input, settings);
     const name = `"${body.name.replaceAll('"', '""')}"`;
@@ -68,9 +68,9 @@ for (const [name, operation] of Object.entries(operations)) {
 
 const snowflakeProvider = Object.freeze({
   ...snowflakeDefinition,
-  oauth: (settings) => ({ issuer: origin(settings), authorization_endpoint: `${origin(settings)}/oauth/authorize`,
-    token_endpoint: `${origin(settings)}/oauth/token-request` }),
-  apiOrigins: (settings) => [origin(settings)], checkOperation: "databases.list", scopesInAuthorizationResponse: true,
+  oauth: (settings) => ({ issuer: accountOrigin(settings), authorization_endpoint: `${accountOrigin(settings)}/oauth/authorize`,
+    token_endpoint: `${accountOrigin(settings)}/oauth/token-request` }),
+  apiOrigins: (settings) => [accountOrigin(settings)], checkOperation: "databases.list", scopesInAuthorizationResponse: true,
   async normalizeTokenResponse(response) {
     if (response.ok) {
       let value;
@@ -90,7 +90,7 @@ const snowflakeProvider = Object.freeze({
     const url = new URL(address);
     const sql = url.pathname.startsWith("/api/v2/statements");
     if (sql && response.status === 422) throw new ConnectorError("connector_operation_rejected", "Snowflake rejected the statement. Inspect query history with the authorized role.", { statusCode: 422, messageCode: "connectors.snowflake.rejectedStatementInspectQueryHistory" });
-    if (!response.ok) throw Object.assign(new Error("Snowflake request failed."), { status: response.status });
+    if (!response.ok) throw providerStatusError(response.status);
     const reader = response.body?.getReader();
     const chunks = [];
     let size = 0;
@@ -110,10 +110,10 @@ const snowflakeProvider = Object.freeze({
     try { result = JSON.parse(Buffer.concat(chunks).toString("utf8")); } catch { /* rejected below */ }
     if (sql) {
       const reject = () => { throw new ConnectorError("connector_response_invalid", "Snowflake returned an invalid statement response.", { statusCode: 502, messageCode: "connectors.snowflake.returnedInvalidStatementResponse" }); };
-      if (!object(result)) reject();
+      if (!isRecord(result)) reject();
       const requestedHandle = url.pathname.split("/")[4];
       const handle = result.statementHandle ?? requestedHandle;
-      if (!uuid(handle) || (requestedHandle && requestedHandle !== handle)) reject();
+      if (!isUuid(handle) || (requestedHandle && requestedHandle !== handle)) reject();
       if (response.status === 202 && result.code === "333334") return { status: "pending", handle };
       if (response.status !== 200) reject();
       if (url.pathname.endsWith("/cancel")) {
@@ -123,8 +123,8 @@ const snowflakeProvider = Object.freeze({
       if (result.code !== undefined && !["090001", "391908"].includes(result.code)) reject();
       if (!Array.isArray(result.data) || !result.data.every((row) => Array.isArray(row) && row.every((cell) => cell === null || typeof cell === "string"))) reject();
       const metadata = result.resultSetMetaData;
-      if (metadata !== undefined && (!object(metadata) || !Array.isArray(metadata.rowType) ||
-        !metadata.rowType.every((column) => object(column) && typeof column.name === "string" && typeof column.type === "string") ||
+      if (metadata !== undefined && (!isRecord(metadata) || !Array.isArray(metadata.rowType) ||
+        !metadata.rowType.every((column) => isRecord(column) && typeof column.name === "string" && typeof column.type === "string") ||
         !result.data.every((row) => row.length === metadata.rowType.length))) reject();
       if (metadata === undefined && !url.searchParams.has("partition")) reject();
       return { status: "completed", handle, data: result.data, ...(metadata ? { metadata } : {}),

package/src/server/storyblok.js

@@ -1,5 +1,6 @@
 import { storyblokDefinition } from "../shared/tokens.js";
 import { jsonOperation } from "./jsonOperation.js";
+import { isRecord } from "@jskit-ai/kernel/shared/support/normalize";
 
 const origins = {
   eu: "https://api.storyblok.com", us: "https://api-us.storyblok.com",
@@ -15,7 +16,7 @@ const contentFields = {
   resolve_assets: { type: "integer", enum: [0, 1] }
 };
 const story = (value) => Number.isSafeInteger(value?.id) && value.id > 0 &&
-  value.content !== null && typeof value.content === "object" && !Array.isArray(value.content);
+  isRecord(value.content);
 const getStory = jsonOperation((settings) => `${origins[settings.region]}/v2/cdn/stories`, {
   ...contentFields,
   id: { type: "string", required: true, minLength: 1, maxLength: 1024,

package/src/server/tally.js

@@ -3,11 +3,12 @@ import { validateSchemaPayload } from "@jskit-ai/kernel/shared/validators";
 import { ConnectorError } from "@jskit-ai/connectors-core/server";
 import { tallyDefinition } from "../shared/tokens.js";
 import { jsonOperation } from "./jsonOperation.js";
+import { isRecord } from "@jskit-ai/kernel/shared/support/normalize";
 
 const formIdField = { type: "string", required: true, noTrim: true,
   validator: (value) => /^[A-Za-z0-9_-]{1,128}$/u.test(value) || "Enter a Tally form ID, not a URL." };
 const blocksField = { type: "array", validator: (value) => value.length <= 500 &&
-  value.every((block) => block && typeof block === "object" && !Array.isArray(block) && typeof block.type === "string") || "Supply up to 500 native Tally block objects." };
+  value.every((block) => isRecord(block) && typeof block.type === "string") || "Supply up to 500 native Tally block objects." };
 const statusField = { type: "string", enum: ["BLANK", "DRAFT", "PUBLISHED"] };
 const formResult = (result) => typeof result?.id === "string" && typeof result.name === "string" &&
   ["BLANK", "DRAFT", "PUBLISHED"].includes(result.status);

package/src/server/telegram.js

@@ -1,13 +1,9 @@
-import { ConnectorError } from "@jskit-ai/connectors-core/server";
+import { ConnectorError, providerStatusError } from "@jskit-ai/connectors-core/server";
 import { telegramDefinition } from "../shared/tokens.js";
 import { jsonOperation } from "./jsonOperation.js";
 
 function telegramResult(response, validate) {
-  if (response?.ok === false) {
-    const error = new Error("Telegram rejected the operation.");
-    error.status = response.error_code;
-    throw error;
-  }
+  if (response?.ok === false) throw providerStatusError(Number(response.error_code));
   return response?.ok === true && validate(response.result);
 }