@jskit-ai/connectors-catalog 0.2.2 → 0.2.4

package/src/server/xero.js

@@ -1,12 +1,12 @@
 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 { xeroDefinition } from "../shared/xero.js";
 import { jsonOperation } from "./jsonOperation.js";
+import { isUuid } from "../shared/uuid.js";
+import { isRecord } from "@jskit-ai/kernel/shared/support/normalize";
 
-const uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
-const uuid = (value) => typeof value === "string" && uuidPattern.test(value);
-const tenantId = { type: "string", required: true, validator: (value) => uuid(value) || "Choose an organisation ID returned by connections.list." };
+const tenantId = { type: "string", required: true, validator: (value) => isUuid(value) || "Choose an organisation ID returned by connections.list." };
 const paging = {
   page: { type: "integer", min: 1, max: 1_000_000, defaultTo: 1 },
   pageSize: { type: "integer", min: 1, max: 200, defaultTo: 100 }
@@ -22,12 +22,12 @@ const reportFields = {
   timeframe: { type: "string", enum: ["MONTH", "QUARTER", "YEAR"] },
   standardLayout: { type: "boolean" }, paymentsOnly: { type: "boolean" }
 };
-const reportRow = row => row !== null && typeof row === "object" && !Array.isArray(row) && typeof row.RowType === "string" &&
+const reportRow = row => isRecord(row) && typeof row.RowType === "string" &&
   (row.Cells === undefined || Array.isArray(row.Cells) && row.Cells.every(cell => typeof cell?.Value === "string"));
 const reportResult = value => Array.isArray(value?.Reports) && value.Reports.length === 1 && value.Reports.every(report =>
   typeof report?.ReportID === "string" && Array.isArray(report.Rows) && report.Rows.every(row => reportRow(row) &&
     (row.Rows === undefined || Array.isArray(row.Rows) && row.Rows.every(reportRow))));
-const validConnections = (value) => Array.isArray(value) && value.every((entry) => uuid(entry?.id) && uuid(entry.tenantId) &&
+const validConnections = (value) => Array.isArray(value) && value.every((entry) => isUuid(entry?.id) && isUuid(entry.tenantId) &&
   ["ORGANISATION", "PRACTICEMANAGER", "PRACTICE"].includes(entry.tenantType) && (entry.tenantName === null || typeof entry.tenantName === "string"));
 
 function accountingRead(resource, fields, scopes, validateResult) {
@@ -49,7 +49,7 @@ function accountingRead(resource, fields, scopes, validateResult) {
 }
 
 function accountingRecord(resource, idName, scopes, fields = {}) {
-  const schema = createSchema({ tenantId, ...fields, id: { type: "string", required: true, validator: value => uuid(value) || "Use the record ID returned by Xero." } });
+  const schema = createSchema({ tenantId, ...fields, id: { type: "string", required: true, validator: value => isUuid(value) || "Use the record ID returned by Xero." } });
   return {
     scopes,
     request(input) {
@@ -62,7 +62,7 @@ function accountingRecord(resource, idName, scopes, fields = {}) {
       return { method: "GET", url: url.href,
         headers: { "Xero-tenant-id": tenant.toLowerCase() } };
     },
-    validateResult: value => Array.isArray(value?.[resource]) && value[resource].length === 1 && uuid(value[resource][0]?.[idName])
+    validateResult: value => Array.isArray(value?.[resource]) && value[resource].length === 1 && isUuid(value[resource][0]?.[idName])
   };
 }
 
@@ -70,7 +70,7 @@ function contactWrite(update) {
   const schema = createSchema({
     tenantId,
     idempotencyKey: idempotencyField,
-    ...(update ? { id: { type: "string", required: true, validator: value => uuid(value) || "Use the contact ID returned by Xero." } } : {}),
+    ...(update ? { id: { type: "string", required: true, validator: value => isUuid(value) || "Use the contact ID returned by Xero." } } : {}),
     Name: { type: "string", required: !update, minLength: 1, maxLength: 255 },
     FirstName: { type: "string", maxLength: 255 }, LastName: { type: "string", maxLength: 255 },
     EmailAddress: { type: "string", maxLength: 255 }, ContactNumber: { type: "string", maxLength: 50 }
@@ -83,15 +83,15 @@ function contactWrite(update) {
       return { method: update ? "POST" : "PUT", url: `https://api.xero.com/api.xro/2.0/Contacts${update ? `/${id.toLowerCase()}` : ""}`,
         headers: { "Xero-tenant-id": tenant.toLowerCase(), "Idempotency-Key": idempotencyKey }, body: { Contacts: [contact] } };
     },
-    validateResult: value => Array.isArray(value?.Contacts) && value.Contacts.length === 1 && uuid(value.Contacts[0]?.ContactID) &&
+    validateResult: value => Array.isArray(value?.Contacts) && value.Contacts.length === 1 && isUuid(value.Contacts[0]?.ContactID) &&
       value.Contacts[0].HasValidationErrors !== true && !value.Contacts[0].ValidationErrors?.length
   };
 }
 
 const paymentSchema = createSchema({
   tenantId, idempotencyKey: idempotencyField,
-  invoiceId: { type: "string", required: true, validator: value => uuid(value) || "Choose an invoice ID." },
-  accountId: { type: "string", required: true, validator: value => uuid(value) || "Choose an account ID." },
+  invoiceId: { type: "string", required: true, validator: value => isUuid(value) || "Choose an invoice ID." },
+  accountId: { type: "string", required: true, validator: value => isUuid(value) || "Choose an account ID." },
   Date: dateField,
   Amount: { type: "number", required: true, validator: value => Number.isFinite(value) && value > 0 && value <= Number.MAX_SAFE_INTEGER || "Use a positive finite payment amount." },
   CurrencyRate: { type: "number", validator: value => Number.isFinite(value) && value > 0 || "Use a positive finite exchange rate." },
@@ -101,9 +101,9 @@ const finiteAmount = { type: "number", validator: value => Number.isFinite(value
 function invoiceWrite(update) {
   const schema = createSchema({
     tenantId, idempotencyKey: idempotencyField,
-    ...(update ? { id: { type: "string", required: true, validator: value => uuid(value) || "Choose the invoice ID." } } : {}),
+    ...(update ? { id: { type: "string", required: true, validator: value => isUuid(value) || "Choose the invoice ID." } } : {}),
     Type: { type: "string", required: !update, enum: ["ACCREC", "ACCPAY"] },
-    contactId: { type: "string", required: !update, validator: value => uuid(value) || "Choose a contact ID." },
+    contactId: { type: "string", required: !update, validator: value => isUuid(value) || "Choose a contact ID." },
     Date: { ...dateField, required: !update }, DueDate: { ...dateField, required: false },
     CurrencyCode: { type: "string", required: !update, validator: value => /^[A-Z]{3}$/u.test(value) || "Use the three-letter invoice currency code." },
     LineAmountTypes: { type: "string", required: !update, enum: ["Exclusive", "Inclusive", "NoTax"] },
@@ -111,7 +111,7 @@ function invoiceWrite(update) {
     Reference: { type: "string", maxLength: 255 }, InvoiceNumber: { type: "string", maxLength: 255 },
     LineItems: { type: "array", required: !update, validator: values => values.length > 0 && values.length <= 100 || "Supply 1–100 invoice lines.",
       items: { type: "object", schema: createSchema({
-        LineItemID: { type: "string", validator: value => uuid(value) || "Use the existing line item ID." },
+        LineItemID: { type: "string", validator: value => isUuid(value) || "Use the existing line item ID." },
         Description: { type: "string", required: true, minLength: 1, maxLength: 4000 },
         Quantity: { ...finiteAmount, required: true, min: 0.0001 },
         UnitAmount: { ...finiteAmount, required: true }, AccountCode: { type: "string", required: true, minLength: 1, maxLength: 50 },
@@ -131,7 +131,7 @@ function invoiceWrite(update) {
       return { method: update ? "POST" : "PUT", url: `https://api.xero.com/api.xro/2.0/Invoices${update ? `/${id.toLowerCase()}` : ""}?unitdp=4`,
         headers: { "Xero-tenant-id": tenant.toLowerCase(), "Idempotency-Key": idempotencyKey }, body: { Invoices: [invoice] } };
     },
-    validateResult: value => Array.isArray(value?.Invoices) && value.Invoices.length === 1 && uuid(value.Invoices[0]?.InvoiceID) &&
+    validateResult: value => Array.isArray(value?.Invoices) && value.Invoices.length === 1 && isUuid(value.Invoices[0]?.InvoiceID) &&
       value.Invoices[0].HasErrors !== true && !value.Invoices[0].ValidationErrors?.length
   };
 }
@@ -141,8 +141,8 @@ function attachmentOperation(action) {
   const schema = createSchema({
     tenantId,
     resource: { type: "string", required: true, enum: ["Contacts", "Invoices", "BankTransactions", "ManualJournals"] },
-    id: { type: "string", required: true, validator: value => uuid(value) || "Choose the parent record ID." },
-    ...(action === "download" ? { attachmentId: { type: "string", required: true, validator: value => uuid(value) || "Choose an attachment ID from attachments.list." } } : {}),
+    id: { type: "string", required: true, validator: value => isUuid(value) || "Choose the parent record ID." },
+    ...(action === "download" ? { attachmentId: { type: "string", required: true, validator: value => isUuid(value) || "Choose an attachment ID from attachments.list." } } : {}),
     ...(writing ? {
       idempotencyKey: idempotencyField,
       filename: { type: "string", required: true, minLength: 1, maxLength: 255,
@@ -172,24 +172,24 @@ function attachmentOperation(action) {
     validateResult: action === "download"
       ? value => typeof value?.contentBase64 === "string" && Number.isInteger(value.size) && value.size > 0
       : value => Array.isArray(value?.Attachments) && (!writing || value.Attachments.length === 1) && value.Attachments.every(file =>
-          uuid(file?.AttachmentID) && typeof file.FileName === "string" && Number.isInteger(file.ContentLength) && file.ContentLength >= 0)
+          isUuid(file?.AttachmentID) && typeof file.FileName === "string" && Number.isInteger(file.ContentLength) && file.ContentLength >= 0)
   };
 }
 
 function bankTransactionWrite(update) {
   const schema = createSchema({
     tenantId, idempotencyKey: idempotencyField,
-    ...(update ? { id: { type: "string", required: true, validator: value => uuid(value) || "Choose a bank transaction ID." } } : {}),
+    ...(update ? { id: { type: "string", required: true, validator: value => isUuid(value) || "Choose a bank transaction ID." } } : {}),
     Type: { type: "string", required: !update, enum: ["SPEND", "RECEIVE"] },
-    contactId: { type: "string", required: !update, validator: value => uuid(value) || "Choose a contact ID." },
-    bankAccountId: { type: "string", required: !update, validator: value => uuid(value) || "Choose a bank account ID." },
+    contactId: { type: "string", required: !update, validator: value => isUuid(value) || "Choose a contact ID." },
+    bankAccountId: { type: "string", required: !update, validator: value => isUuid(value) || "Choose a bank account ID." },
     Date: { ...dateField, required: !update }, Reference: { type: "string", maxLength: 255 },
     CurrencyRate: { type: "number", validator: value => Number.isFinite(value) && value > 0 || "Use a positive finite exchange rate." },
     LineAmountTypes: { type: "string", required: !update, enum: ["Exclusive", "Inclusive", "NoTax"] },
     ...(update ? { Status: { type: "string", enum: ["AUTHORISED", "DELETED"] } } : {}),
     LineItems: { type: "array", required: !update, validator: values => values.length > 0 && values.length <= 100 || "Supply 1–100 transaction lines.",
       items: { type: "object", schema: createSchema({
-        LineItemID: { type: "string", validator: value => uuid(value) || "Use the existing line item ID." },
+        LineItemID: { type: "string", validator: value => isUuid(value) || "Use the existing line item ID." },
         Description: { type: "string", required: true, minLength: 1, maxLength: 4000 },
         Quantity: { ...finiteAmount, required: true, min: 0.0001 }, UnitAmount: { ...finiteAmount, required: true },
         AccountCode: { type: "string", required: true, minLength: 1, maxLength: 50 }, TaxType: { type: "string", maxLength: 50 }
@@ -207,7 +207,7 @@ function bankTransactionWrite(update) {
       return { method: update ? "POST" : "PUT", url: `https://api.xero.com/api.xro/2.0/BankTransactions${update ? `/${id.toLowerCase()}` : ""}?unitdp=4`,
         headers: { "Xero-tenant-id": tenant.toLowerCase(), "Idempotency-Key": idempotencyKey }, body: { BankTransactions: [transaction] } };
     },
-    validateResult: value => Array.isArray(value?.BankTransactions) && value.BankTransactions.length === 1 && uuid(value.BankTransactions[0]?.BankTransactionID) &&
+    validateResult: value => Array.isArray(value?.BankTransactions) && value.BankTransactions.length === 1 && isUuid(value.BankTransactions[0]?.BankTransactionID) &&
       !value.BankTransactions[0].ValidationErrors?.length
   };
 }
@@ -215,7 +215,7 @@ function bankTransactionWrite(update) {
 function manualJournalWrite(update) {
   const schema = createSchema({
     tenantId, idempotencyKey: idempotencyField,
-    ...(update ? { id: { type: "string", required: true, validator: value => uuid(value) || "Choose a manual journal ID." } } : {}),
+    ...(update ? { id: { type: "string", required: true, validator: value => isUuid(value) || "Choose a manual journal ID." } } : {}),
     Narration: { type: "string", required: !update, minLength: 1, maxLength: 4000 },
     Date: { ...dateField, required: !update },
     LineAmountTypes: { type: "string", required: !update, enum: ["Exclusive", "Inclusive", "NoTax"] },
@@ -244,7 +244,7 @@ function manualJournalWrite(update) {
       return { method: update ? "POST" : "PUT", url: `https://api.xero.com/api.xro/2.0/ManualJournals${update ? `/${id.toLowerCase()}` : ""}`,
         headers: { "Xero-tenant-id": tenant.toLowerCase(), "Idempotency-Key": idempotencyKey }, body: { ManualJournals: [journal] } };
     },
-    validateResult: value => Array.isArray(value?.ManualJournals) && value.ManualJournals.length === 1 && uuid(value.ManualJournals[0]?.ManualJournalID) &&
+    validateResult: value => Array.isArray(value?.ManualJournals) && value.ManualJournals.length === 1 && isUuid(value.ManualJournals[0]?.ManualJournalID) &&
       !value.ManualJournals[0].ValidationErrors?.length
   };
 }
@@ -260,20 +260,20 @@ const xeroProvider = Object.freeze({
     "attachments.replace": attachmentOperation("replace"),
     "connections.list": jsonOperation(connectionsUrl, {}, validConnections),
     "accounts.list": accountingRead("Accounts", {}, ["accounting.settings.read", "accounting.settings"],
-      value => Array.isArray(value?.Accounts) && value.Accounts.every(account => uuid(account?.AccountID) && typeof account.Type === "string")),
+      value => Array.isArray(value?.Accounts) && value.Accounts.every(account => isUuid(account?.AccountID) && typeof account.Type === "string")),
     "currencies.list": accountingRead("Currencies", {}, ["accounting.settings.read", "accounting.settings"],
       value => Array.isArray(value?.Currencies) && value.Currencies.every(currency => /^[A-Z]{3}$/u.test(currency?.Code) && typeof currency.Description === "string")),
     "taxRates.list": accountingRead("TaxRates", {}, ["accounting.settings.read", "accounting.settings"],
       value => Array.isArray(value?.TaxRates) && value.TaxRates.every(rate => typeof rate?.TaxType === "string" && typeof rate.Name === "string")),
     "trackingCategories.list": accountingRead("TrackingCategories", { includeArchived: { type: "boolean", defaultTo: false } },
       ["accounting.settings.read", "accounting.settings"],
-      value => Array.isArray(value?.TrackingCategories) && value.TrackingCategories.every(category => uuid(category?.TrackingCategoryID) && typeof category.Name === "string")),
+      value => Array.isArray(value?.TrackingCategories) && value.TrackingCategories.every(category => isUuid(category?.TrackingCategoryID) && typeof category.Name === "string")),
     "reports.agedReceivables": accountingRead("Reports/AgedReceivablesByContact", {
-      contactId: { type: "string", required: true, validator: value => uuid(value) || "Choose a contact ID." },
+      contactId: { type: "string", required: true, validator: value => isUuid(value) || "Choose a contact ID." },
       date: dateField, fromDate: { ...dateField, required: false }, toDate: { ...dateField, required: false }
     }, ["accounting.reports.aged.read"], reportResult),
     "reports.agedPayables": accountingRead("Reports/AgedPayablesByContact", {
-      contactId: { type: "string", required: true, validator: value => uuid(value) || "Choose a contact ID." },
+      contactId: { type: "string", required: true, validator: value => isUuid(value) || "Choose a contact ID." },
       date: dateField, fromDate: { ...dateField, required: false }, toDate: { ...dateField, required: false }
     }, ["accounting.reports.aged.read"], reportResult),
     "reports.executiveSummary": accountingRead("Reports/ExecutiveSummary", { date: dateField },
@@ -285,7 +285,7 @@ const xeroProvider = Object.freeze({
     "budgets.list": accountingRead("Budgets", {
       DateFrom: { ...dateField, required: false }, DateTo: { ...dateField, required: false }
     }, ["accounting.budgets.read"],
-      value => Array.isArray(value?.Budgets) && value.Budgets.every(budget => uuid(budget?.BudgetID) && ["OVERALL", "TRACKING"].includes(budget.Type))),
+      value => Array.isArray(value?.Budgets) && value.Budgets.every(budget => isUuid(budget?.BudgetID) && ["OVERALL", "TRACKING"].includes(budget.Type))),
     "budgets.get": accountingRecord("Budgets", "BudgetID", ["accounting.budgets.read"], {
       DateFrom: { ...dateField, required: false }, DateTo: { ...dateField, required: false }
     }),
@@ -297,13 +297,13 @@ const xeroProvider = Object.freeze({
     "bankTransactions.update": bankTransactionWrite(true),
     "bankTransactions.list": accountingRead("BankTransactions", { page: paging.page },
       ["accounting.banktransactions.read", "accounting.banktransactions"],
-      value => Array.isArray(value?.BankTransactions) && value.BankTransactions.length <= 100 && value.BankTransactions.every(record => uuid(record?.BankTransactionID))),
+      value => Array.isArray(value?.BankTransactions) && value.BankTransactions.length <= 100 && value.BankTransactions.every(record => isUuid(record?.BankTransactionID))),
     "bankTransactions.get": accountingRecord("BankTransactions", "BankTransactionID", ["accounting.banktransactions.read", "accounting.banktransactions"]),
     "manualJournals.create": manualJournalWrite(false),
     "manualJournals.update": manualJournalWrite(true),
     "manualJournals.list": accountingRead("ManualJournals", { page: paging.page },
       ["accounting.manualjournals.read", "accounting.manualjournals"],
-      value => Array.isArray(value?.ManualJournals) && value.ManualJournals.length <= 100 && value.ManualJournals.every(record => uuid(record?.ManualJournalID))),
+      value => Array.isArray(value?.ManualJournals) && value.ManualJournals.length <= 100 && value.ManualJournals.every(record => isUuid(record?.ManualJournalID))),
     "manualJournals.get": accountingRecord("ManualJournals", "ManualJournalID", ["accounting.manualjournals.read", "accounting.manualjournals"]),
     "payments.create": {
       scopes: ["accounting.payments"],
@@ -313,7 +313,7 @@ const xeroProvider = Object.freeze({
           headers: { "Xero-tenant-id": tenant.toLowerCase(), "Idempotency-Key": idempotencyKey },
           body: { Payments: [{ ...payment, Invoice: { InvoiceID: invoiceId }, Account: { AccountID: accountId } }] } };
       },
-      validateResult: value => Array.isArray(value?.Payments) && value.Payments.length === 1 && uuid(value.Payments[0]?.PaymentID) &&
+      validateResult: value => Array.isArray(value?.Payments) && value.Payments.length === 1 && isUuid(value.Payments[0]?.PaymentID) &&
         Number.isFinite(value.Payments[0].Amount) && value.Payments[0].HasValidationErrors !== true && !value.Payments[0].ValidationErrors?.length
     },
     "contacts.get": accountingRecord("Contacts", "ContactID", ["accounting.contacts.read", "accounting.contacts"]),
@@ -329,13 +329,13 @@ const xeroProvider = Object.freeze({
     "payments.list": accountingRead("Payments", { page: paging.page, pageSize: { ...paging.pageSize, max: 100 } },
       ["accounting.payments.read", "accounting.payments"],
       (value) => Array.isArray(value?.Payments) && value.Payments.length <= 100 && value.Payments.every((entry) =>
-        uuid(entry?.PaymentID) && Number.isFinite(entry.Amount) && typeof entry.Status === "string")),
+        isUuid(entry?.PaymentID) && Number.isFinite(entry.Amount) && typeof entry.Status === "string")),
     "organisation.read": accountingRead("Organisation", {}, ["accounting.settings.read", "accounting.settings"],
-      (value) => Array.isArray(value?.Organisations) && value.Organisations.length === 1 && uuid(value.Organisations[0]?.OrganisationID)),
+      (value) => Array.isArray(value?.Organisations) && value.Organisations.length === 1 && isUuid(value.Organisations[0]?.OrganisationID)),
     "contacts.list": accountingRead("Contacts", { ...paging, includeArchived: { type: "boolean", defaultTo: false }, searchTerm: { type: "string", minLength: 1, maxLength: 255 } },
-      ["accounting.contacts.read", "accounting.contacts"], (value) => Array.isArray(value?.Contacts) && value.Contacts.length <= 200 && value.Contacts.every((entry) => uuid(entry?.ContactID))),
+      ["accounting.contacts.read", "accounting.contacts"], (value) => Array.isArray(value?.Contacts) && value.Contacts.length <= 200 && value.Contacts.every((entry) => isUuid(entry?.ContactID))),
     "invoices.list": accountingRead("Invoices", paging, ["accounting.invoices.read", "accounting.invoices"],
-      (value) => Array.isArray(value?.Invoices) && value.Invoices.length <= 200 && value.Invoices.every((entry) => uuid(entry?.InvoiceID)))
+      (value) => Array.isArray(value?.Invoices) && value.Invoices.length <= 200 && value.Invoices.every((entry) => isUuid(entry?.InvoiceID)))
   },
   async exchange(address, options, { request, fetchImpl }) {
     if (address !== connectionsUrl) {
@@ -354,7 +354,7 @@ const xeroProvider = Object.freeze({
         headers: { ...options.headers, Accept: downloading ? "application/octet-stream" : "application/json" } });
       if (!response.ok) {
         await response.body?.cancel();
-        throw Object.assign(new Error("Xero attachment request failed."), { status: response.status });
+        throw providerStatusError(response.status);
       }
       const reader = response.body?.getReader(); const chunks = []; let size = 0;
       if (reader) try {
@@ -380,7 +380,7 @@ const xeroProvider = Object.freeze({
     if (record) {
       const idName = { Contacts: "ContactID", Invoices: "InvoiceID", Budgets: "BudgetID", BankTransactions: "BankTransactionID", ManualJournals: "ManualJournalID" }[record[1]];
       const returnedId = result?.[record[1]]?.[0]?.[idName];
-      if (!uuid(returnedId) || returnedId.toLowerCase() !== record[2].toLowerCase()) {
+      if (!isUuid(returnedId) || returnedId.toLowerCase() !== record[2].toLowerCase()) {
         throw new ConnectorError("connector_response_invalid", "Xero returned a different record.", { statusCode: 502, messageCode: "connectors.shared.differentRecord", messageParams: { provider: "Xero" } });
       }
     }

package/src/server/zoho-books.js

@@ -1,15 +1,15 @@
 import { createSchema } from "json-rest-schema";
 import { validateSchemaPayload } from "@jskit-ai/kernel/shared/validators";
-import { ConnectorError } from "@jskit-ai/connectors-core/server";
-import { zohoBooksDefinition, zohoBooksIdentifier, zohoBooksOrganizationField } from "../shared/zoho-books.js";
-import { zohoRegions } from "../shared/zoho-regions.js";
+import { ConnectorError, providerStatusError } from "@jskit-ai/connectors-core/server";
+import { zohoBooksDefinition, zohoBooksOrganizationField } from "../shared/zoho-books.js";
+import { isZohoId, zohoRegions } from "../shared/zoho.js";
 import { jsonOperation } from "./jsonOperation.js";
 import { zohoAuthorizationParameters, zohoOAuthMetadata, normalizeZohoTokenResponse } from "./zohoOAuth.js";
 
 const regionFor = ({ region = "eu" } = {}) => zohoRegions.find(({ value }) => value === region);
 const apiOrigin = (settings) => `https://www.zohoapis.${regionFor(settings).suffix}`;
 const validOrganizations = (value) => Array.isArray(value?.organizations) && value.organizations.every((org) =>
-  zohoBooksIdentifier(org?.organization_id) && typeof org.name === "string" && typeof org.is_org_active === "boolean");
+  isZohoId(org?.organization_id) && typeof org.name === "string" && typeof org.is_org_active === "boolean");
 
 function booksList(resource, identifier) {
   const schema = createSchema({
@@ -33,7 +33,7 @@ function booksList(resource, identifier) {
       return { method: "GET", url: url.href };
     },
     validateResult: (value) => Array.isArray(value?.[resource]) && value[resource].length <= 200 &&
-      value[resource].every((record) => zohoBooksIdentifier(record?.[identifier])) && typeof value.page_context?.has_more_page === "boolean"
+      value[resource].every((record) => isZohoId(record?.[identifier])) && typeof value.page_context?.has_more_page === "boolean"
   };
 }
 
@@ -57,7 +57,7 @@ const zohoBooksProvider = Object.freeze({
     const response = await fetchImpl(address, { ...options, headers, credentials: "omit" });
     if (!response.ok) {
       if (response.status === 404) throw new ConnectorError("connector_resource_not_found", "This Books resource is not available.", { statusCode: 404, messageCode: "connectors.zohoBooks.resourceNotAvailable" });
-      throw Object.assign(new Error("Zoho Books request failed."), { status: response.status });
+      throw providerStatusError(response.status);
     }
     let value;
     try { value = await response.json(); } catch { /* validated below */ }

package/src/server/zoho-crm.js

@@ -1,13 +1,13 @@
 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 { isZohoId } from "../shared/zoho.js";
 import { zohoCrmDefinition, zohoCrmRegions } from "../shared/zoho-crm.js";
 import { jsonOperation } from "./jsonOperation.js";
 import { zohoAuthorizationParameters, zohoOAuthMetadata, normalizeZohoTokenResponse } from "./zohoOAuth.js";
 
 const regionFor = ({ region = "us" } = {}) => zohoCrmRegions.find(({ value }) => value === region);
 const apiOrigin = (settings = {}) => `https://${settings.environment === "sandbox" ? "sandbox" : settings.environment === "developer" ? "developer" : "www"}.zohoapis.${regionFor(settings).suffix}`;
-const identifier = (value) => typeof value === "string" && /^[1-9][0-9]{0,29}$/u.test(value);
 const pageToken = (value) => typeof value === "string" && value.length > 0 && value.length <= 4096 && !/[\s\p{Cc}]/u.test(value);
 
 function recordsList(module, defaults) {
@@ -32,7 +32,7 @@ function recordsList(module, defaults) {
       for (const [name, value] of Object.entries(values)) url.searchParams.set(name, String(value));
       return { method: "GET", url: url.href };
     },
-    validateResult: (result) => Array.isArray(result?.data) && result.data.length <= 200 && result.data.every((record) => identifier(record?.id)) &&
+    validateResult: (result) => Array.isArray(result?.data) && result.data.length <= 200 && result.data.every((record) => isZohoId(record?.id)) &&
       Number.isSafeInteger(result.info?.count) && result.info.count === result.data.length &&
       Number.isSafeInteger(result.info.per_page) && result.info.per_page >= 1 && result.info.per_page <= 200 &&
       typeof result.info.more_records === "boolean" &&
@@ -51,7 +51,7 @@ const zohoCrmProvider = Object.freeze({
   operations: {
     "users.current": {
       ...jsonOperation((settings) => `${apiOrigin(settings)}/crm/v8/users?type=CurrentUser`, {},
-        (value) => Array.isArray(value?.users) && value.users.length === 1 && identifier(value.users[0]?.id)),
+        (value) => Array.isArray(value?.users) && value.users.length === 1 && isZohoId(value.users[0]?.id)),
       scopes: ["ZohoCRM.users.READ", "ZohoCRM.users.ALL"]
     },
     "leads.list": recordsList("Leads", "Last_Name,Email"),
@@ -73,7 +73,7 @@ const zohoCrmProvider = Object.freeze({
     if (!response.ok) {
       if (response.status === 404) throw new ConnectorError("connector_resource_not_found", "This CRM resource is not available.", { statusCode: 404, messageCode: "connectors.zohoCrm.resourceNotAvailable" });
       // The shared runtime maps HTTP status without exposing provider response text.
-      throw Object.assign(new Error("Zoho CRM request failed."), { status: response.status });
+      throw providerStatusError(response.status);
     }
     if (response.status !== 200 || !value || value.status === "error" || value.code) {
       throw new ConnectorError("connector_response_invalid", "Zoho CRM returned an unexpected response.", { statusCode: 502, messageCode: "connectors.shared.unexpectedResponse", messageParams: { provider: "Zoho CRM" } });

package/src/shared/confidence.js

@@ -7,7 +7,12 @@ const confidenceScopes = [
 
 function definition(id, name, description) {
   return Object.freeze({
-    id, name, description, accountModes: ["assistant"], authenticationMethods: ["oauth2"], scopes: confidenceScopes,
+    id,
+    name,
+    description,
+    accountModes: ["assistant"],
+    authenticationMethods: ["oauth2"],
+    scopes: confidenceScopes,
     setup: { url: "https://confidence.spotify.com/docs/sdks/mcp-servers", clientRegistrationEndpoint: "https://mcp.confidence.dev/register", steps: [
       "Use a Confidence account with access to the intended organisation. This assistant connection uses browser OAuth, not a flag client secret or management API token.",
       "Confirm the suggested callback is the route your application will serve. Choose Register client and connect to create a project-owned client and save its ID, secret and callback through project Env. Existing Env values are preserved. Manual users can send the displayed registration JSON with Content-Type application/json; CLI users can call registerConfidenceClient.",

package/src/shared/dbt-semantic-layer.js

@@ -25,7 +25,7 @@ const dbtSemanticLayerDefinition = Object.freeze({
     "Return to Project details and copy the GraphQL hostname and Environment ID from the Semantic Layer connection details. Enter them here, preserving every ID digit. Enter env:DBT_SERVICE_TOKEN in Service token reference and save configuration. Choose Set credential in Env, paste the token as DBT_SERVICE_TOKEN and save it there.",
     "Return here and choose Connect account / Verify again. Check connection only reads saved status. Verification reads environment metadata; an explicitly wired application can then create metric queries and request their status and JSON result pages. If denied, check the host, environment, linked warehouse credential and token permissions. Replace the token through Env when rotating it; local Disconnect does not revoke it in dbt.",
     "Query execution uses your warehouse capacity. The app owns permitted metrics, trusted dimension/time filters and bounded polling. JSON results suit small tables; use dbt’s native Arrow tooling for large production workloads. Do not retry an uncertain query submission automatically. Your application must explicitly expose approved dbt tools to its assistant.",
-    "This token flow has no OAuth callback or app-user login. Public and Online need the customer's own account, permissions and capacity."
+    "This token flow has no OAuth callback or app-user login. Every deployment needs the customer's own account, permissions and capacity."
   ] }
 });
 

package/src/shared/figma.js

@@ -12,7 +12,7 @@ const figmaDefinition = Object.freeze({
       "Save, begin authorization, sign into Figma and review its consent screen. A personal access token cannot replace this MCP OAuth registration.",
       "The host must authorize each tool and its arguments. The MCP permission can expose write tools; listing a tool does not authorize an edit.",
       "Use a Figma file/frame link to identify the allowed file and node. The assistant host consumes returned design text/images and chooses its framework; connecting alone does not generate screens. Assistant tool attachment requires explicit host integration.",
-      "Remote MCP supports both local and hosted assistant applications. Desktop MCP must run beside the consuming desktop client; a VPS localhost address points to the VPS, not your laptop. Do not enter a desktop localhost URL as the hosted remote endpoint.",
+      "Remote MCP supports both local and hosted assistant applications. Desktop MCP must run beside the consuming desktop client; a server's localhost address points to that server, not your laptop. Do not enter a desktop localhost URL as the hosted remote endpoint.",
       "Disconnect removes the local grant; it does not undo design edits or revoke all provider access. This uses Figma's remote server. Desktop MCP, app-user login and automatic assistant attachment are separate capabilities."
     ]
   }

package/src/shared/google.js

@@ -1,10 +1,14 @@
 import { createSchema } from "json-rest-schema";
-const scope = (name) => name.startsWith("https:") ? name : `https://www.googleapis.com/auth/${name}`;
+import { googleScope } from "./googleScope.js";
 function definition(id, name, api, description, recommended, permissions, verificationFields = [], setupNotes = []) {
   return Object.freeze({
-    id, name, description, verificationFields,
-    accountModes: ["shared", "per-user", "assistant"], authenticationMethods: ["oauth2"],
-    scopes: permissions.map(([value, label, required = false]) => ({ value: scope(value), label,
+    id,
+    name,
+    description,
+    verificationFields,
+    accountModes: ["shared", "per-user", "assistant"],
+    authenticationMethods: ["oauth2"],
+    scopes: permissions.map(([value, label, required = false]) => ({ value: googleScope(value), label,
       recommended: Array.isArray(recommended) ? recommended.includes(value) : value === recommended, ...(required ? { required: true } : {}) })),
     setup: {
       url: "https://developers.google.com/identity/protocols/oauth2/web-server",

package/src/shared/googleScope.js

@@ -0,0 +1,4 @@
+// A Google OAuth scope's full URL; a scope already given as a URL is kept.
+const googleScope = (name) => name.startsWith("https:") ? name : `https://www.googleapis.com/auth/${name}`;
+
+export { googleScope };

package/src/shared/microsoft-fabric.js

@@ -1,10 +1,9 @@
 import { createSchema } from "json-rest-schema";
+import { UUID_SOURCE, isUuid } from "./uuid.js";
 
 const delegatedScope = "https://analysis.windows.net/powerbi/api/GraphQLApi.Execute.All";
 const serviceScope = "https://api.fabric.microsoft.com/.default";
-const guid = "[a-fA-F0-9]{8}-(?:[a-fA-F0-9]{4}-){3}[a-fA-F0-9]{12}";
-const guidPattern = new RegExp(`^${guid}$`, "u");
-const endpointPattern = new RegExp(`^https://api\\.fabric\\.microsoft\\.com/v1/workspaces/${guid}/(?:graphqlapis|graphQLApis|GraphQLApis)/${guid}/graphql$`, "u");
+const endpointPattern = new RegExp(`^https://api\\.fabric\\.microsoft\\.com/v1/workspaces/${UUID_SOURCE}/(?:graphqlapis|graphQLApis|GraphQLApis)/${UUID_SOURCE}/graphql$`, "u");
 const scopes = [
   { value: delegatedScope, label: "jskit.connectors.microsoftFabric.scopes.delegatedScope.label", recommended: true },
   { value: "offline_access", label: "jskit.connectors.microsoftFabric.scopes.offlineAccess.label", recommended: true },
@@ -16,11 +15,11 @@ const microsoftFabricDefinition = Object.freeze({
   description: "jskit.connectors.microsoftFabric.description",
   accountModes: ["shared", "per-user", "assistant"], authenticationMethods: ["oauth2"],
   oauthGrantTypes: ["authorization_code", "client_credentials"], oauthClientAuthenticationMethods: ["client_secret_post"],
-  validateClientId: (value) => guidPattern.test(value) || "Enter the Application (client) ID as a GUID.",
+  validateClientId: (value) => isUuid(value) || "Enter the Application (client) ID as a GUID.",
   oauthGrantHint: "jskit.connectors.microsoftFabric.oauthGrantHint",
   settingsSchema: createSchema({
     tenantId: { type: "string", required: true, maxLength: 36,
-      validator: (value) => guidPattern.test(value) || "Enter the Directory (tenant) ID as a GUID, not common or a client ID." },
+      validator: (value) => isUuid(value) || "Enter the Directory (tenant) ID as a GUID, not common or a client ID." },
     graphqlEndpoint: { type: "string", required: true, maxLength: 256,
       validator: (value) => endpointPattern.test(value) || "Copy the Fabric GraphQL API endpoint with workspace and API IDs, without a query string or fragment." }
   }),

package/src/shared/microsoft.js

@@ -1,4 +1,5 @@
 import { createSchema } from "json-rest-schema";
+import { isUuid } from "./uuid.js";
 
 const registrationUrl = "https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app";
 
@@ -6,15 +7,19 @@ function definition(id, name, description, permission, label, organizationOnly =
   const authority = organizationOnly ? "organizations" : "common";
   const audiences = organizationOnly ? ["organizations"] : ["common", "organizations", "consumers"];
   return Object.freeze({
-    id, name, description, verificationFields,
-    accountModes: ["shared", "per-user", "assistant"], authenticationMethods: ["oauth2"],
+    id,
+    name,
+    description,
+    verificationFields,
+    accountModes: ["shared", "per-user", "assistant"],
+    authenticationMethods: ["oauth2"],
     scopes: [
       { value: permission, label, recommended: true },
       { value: "offline_access", label: "jskit.connectors.microsoft.scopes.offlineAccess.label", recommended: true }
     ],
     settingsSchema: createSchema({
       tenantId: { type: "string", maxLength: 36, defaultTo: authority,
-        validator: (value) => audiences.includes(value) || /^[a-f0-9]{8}-(?:[a-f0-9]{4}-){3}[a-f0-9]{12}$/iu.test(value) ||
+        validator: (value) => audiences.includes(value) || isUuid(value) ||
           `Use ${audiences.join(", ")} or your Directory (tenant) ID as a GUID.` }
     }),
     settingsFields: [{ name: "tenantId", label: "jskit.connectors.microsoft.fields.tenantId.label", placeholder: authority,

package/src/shared/salesforce.js

@@ -29,7 +29,7 @@ const salesforceDefinition = Object.freeze({
     "Enable OAuth, register the exact backend callback, and select api plus refresh_token/offline_access. Keep PKCE enabled and require the secret for Web Server and Refresh Token flows.",
     "Open the app's Settings, then Consumer Key and Secret. Copy the key as Client ID; put the secret and callback in Env and save their references here.",
     "An administrator grants API access and authorizes the app/users through its policies and permission sets. Save configuration, then start consent from your application's connection flow.",
-    "Public/Online registrations need separate provisioning and distribution decisions. Local apps cannot serve unrelated customer orgs; packaged apps require installation and subscriber policies. Org API quotas remain shared."
+    "Registrations shared beyond this org need separate provisioning and distribution decisions. Local apps cannot serve unrelated customer orgs; packaged apps require installation and subscriber policies. Org API quotas remain shared."
   ] }
 });
 

package/src/shared/tokens.js

@@ -2,8 +2,13 @@ import { createSchema } from "json-rest-schema";
 
 function definition(id, name, description, url, steps) {
   return Object.freeze({
-    id, name, description, accountModes: ["shared", "assistant"],
-    authenticationMethods: ["api-key"], scopes: [], setup: { url, steps }
+    id,
+    name,
+    description,
+    accountModes: ["shared", "assistant"],
+    authenticationMethods: ["api-key"],
+    scopes: [],
+    setup: { url, steps }
   });
 }
 
@@ -725,7 +730,6 @@ const clayDefinition = Object.freeze({
     ]),
   apiKeyReferenceLabel: "jskit.connectors.clay.apiKeyReferenceLabel"
 });
-
 const tokenDefinitions = Object.freeze([
   airtableDefinition, notionDefinition, brevoDefinition, elevenlabsDefinition, githubApiDefinition, apifyDefinition,
   calendlyDefinition, hubspotDefinition, linearDefinition, pipedriveDefinition, gitlabApiDefinition, tallyDefinition, contentfulDefinition, asanaDefinition,

package/src/shared/uuid.js

@@ -0,0 +1,13 @@
+// The UUID form providers give account, tenant, site and resource IDs.
+
+/** A hyphenated hexadecimal UUID in either case, for building larger patterns. */
+const UUID_SOURCE = "[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}";
+const uuidPattern = new RegExp(`^${UUID_SOURCE}$`, "u");
+
+/**
+ * A UUID in its hyphenated hexadecimal form.
+ * @param {unknown} value
+ */
+const isUuid = (value) => typeof value === "string" && uuidPattern.test(value);
+
+export { UUID_SOURCE, isUuid };

package/src/shared/wix.js

@@ -1,15 +1,16 @@
 import { createSchema } from "json-rest-schema";
+import { isUuid } from "./uuid.js";
 
 const wixDefinition = Object.freeze({
   id: "wix", name: "Wix", description: "jskit.connectors.wix.description",
   accountModes: ["shared", "assistant"], authenticationMethods: ["api-key"], scopes: [],
   settingsSchema: createSchema({ accountId: { type: "string", required: true, minLength: 36, maxLength: 36,
-    validator: (value) => /^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/iu.test(value) || "Enter the Account ID from Wix's API Keys Manager." },
+    validator: (value) => isUuid(value) || "Enter the Account ID from Wix's API Keys Manager." },
     selectableSiteIds: { type: "string", maxLength: 4000, validator: value => {
       const ids = value.split(",").map(id => id.trim());
-      return ids.length <= 100 && ids.every(id => /^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/iu.test(id)) && new Set(ids.map(id => id.toLowerCase())).size === ids.length || "Enter up to 100 distinct Site IDs separated by commas.";
+      return ids.length <= 100 && ids.every(id => isUuid(id)) && new Set(ids.map(id => id.toLowerCase())).size === ids.length || "Enter up to 100 distinct Site IDs separated by commas.";
     } },
-    siteId: { type: "string", minLength: 36, maxLength: 36, validator: value => /^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/iu.test(value) || "Copy the Site ID from the Wix site dashboard URL." } }),
+    siteId: { type: "string", minLength: 36, maxLength: 36, validator: value => isUuid(value) || "Copy the Site ID from the Wix site dashboard URL." } }),
   settingsFields: [{ name: "accountId", label: "jskit.connectors.wix.fields.accountId.label", placeholder: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
     hint: "jskit.connectors.wix.fields.accountId.hint" },
     { name: "selectableSiteIds", label: "jskit.connectors.wix.fields.selectableSiteIds.label", placeholder: "jskit.connectors.wix.fields.selectableSiteIds.placeholder", hint: "jskit.connectors.wix.fields.selectableSiteIds.hint" },

package/src/shared/zoho-books.js

@@ -1,9 +1,8 @@
 import { createSchema } from "json-rest-schema";
-import { zohoRegions } from "./zoho-regions.js";
+import { isZohoId, zohoRegions } from "./zoho.js";
 
-const zohoBooksIdentifier = (value) => typeof value === "string" && /^[1-9][0-9]{0,29}$/u.test(value);
 const zohoBooksOrganizationField = { type: "string", noTrim: true,
-  validator: (value) => zohoBooksIdentifier(value) || "Use an organisation ID containing digits only." };
+  validator: (value) => isZohoId(value) || "Use an organisation ID containing digits only." };
 
 const zohoBooksDefinition = Object.freeze({
   id: "zoho-books", name: "Zoho Books", description: "jskit.connectors.zohoBooks.description",
@@ -36,4 +35,4 @@ const zohoBooksDefinition = Object.freeze({
   ] }
 });
 
-export { zohoBooksDefinition, zohoBooksIdentifier, zohoBooksOrganizationField };
+export { zohoBooksDefinition, zohoBooksOrganizationField };

package/src/shared/zoho-crm.js

@@ -1,5 +1,5 @@
 import { createSchema } from "json-rest-schema";
-import { zohoRegions } from "./zoho-regions.js";
+import { zohoRegions } from "./zoho.js";
 
 const zohoCrmRegions = Object.freeze(zohoRegions.filter(({ value }) => value !== "sa"));
 

package/src/shared/{zoho-regions.js → zoho.js}

@@ -9,4 +9,7 @@ const zohoRegions = Object.freeze([
   { value: "sa", title: "jskit.connectors.zoho.regions.sa.title", accounts: "https://accounts.zoho.sa", suffix: "sa" }
 ]);
 
-export { zohoRegions };
+// Zoho's organisation and record IDs: up to 30 digits, without a leading zero.
+const isZohoId = (value) => typeof value === "string" && /^[1-9][0-9]{0,29}$/u.test(value);
+
+export { isZohoId, zohoRegions };

package/test/ai.test.js

@@ -9,7 +9,7 @@ import { parseIntegrationConfiguration, validateIntegrationConfiguration } from
 const configuration = (patch = {}) => ({ schemaVersion: 1, registrations: {}, integrations: {
   suggestions: { provider: "ai", accountMode: "shared", scopes: [], authentication: { method: "none" }, ...patch }
 } });
-const actor = { applicationId: "dogandgroom", subjectId: "customer-one" };
+const actor = { applicationId: "bookings", subjectId: "customer-one" };
 const request = { context: actor, integrationId: "suggestions" };
 const authorize = async (context) => context?.applicationId === actor.applicationId ? context : null;
 const validate = (config) => validateIntegrationConfiguration(config, { providers: [aiDefinition] });