@jskit-ai/connectors-catalog 0.1.67 → 0.2.0

package/src/server/woocommerce.js

@@ -41,10 +41,10 @@ function deleteRecord(resource) {
   return {
     scopes: [],
     request(input, settings) {
-      if (typeof input?.force !== "boolean") throw new ConnectorError("connector_input_invalid", "Choose explicitly whether to permanently delete.", { statusCode: 422 });
+      if (typeof input?.force !== "boolean") throw new ConnectorError("connector_input_invalid", "Choose explicitly whether to permanently delete.", { statusCode: 422, messageCode: "connectors.woocommerce.chooseExplicitlyWhetherPermanentlyDelete" });
       const { id, force, product_id, reassign } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
-      if (permanentOnly && !force) throw new ConnectorError("connector_input_invalid", "This resource does not support trash; permanent deletion requires force=true.", { statusCode: 422 });
-      if (reassign === id) throw new ConnectorError("connector_input_invalid", "Choose a different reassignment user.", { statusCode: 422 });
+      if (permanentOnly && !force) throw new ConnectorError("connector_input_invalid", "This resource does not support trash; permanent deletion requires force=true.", { statusCode: 422, messageCode: "connectors.woocommerce.resourceDoesNotSupportTrash" });
+      if (reassign === id) throw new ConnectorError("connector_input_invalid", "Choose a different reassignment user.", { statusCode: 422, messageCode: "connectors.woocommerce.chooseDifferentReassignmentUser" });
       const path = resource === "variations" ? `products/${product_id}/variations` : resource;
       const url = new URL(`${baseUrl(settings)}/${path}/${id}`);
       url.searchParams.set("force", String(force));
@@ -75,11 +75,11 @@ function categoryOperation(action) {
     scopes: [],
     request(input, settings) {
       const { id, ...fields } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
-      if (action === "delete" && input.force !== true) throw new ConnectorError("connector_input_invalid", "Category deletion is permanent and requires force=true.", { statusCode: 422 });
-      if (id && fields.parent === id) throw new ConnectorError("connector_input_invalid", "A category cannot be its own parent.", { statusCode: 422 });
+      if (action === "delete" && input.force !== true) throw new ConnectorError("connector_input_invalid", "Category deletion is permanent and requires force=true.", { statusCode: 422, messageCode: "connectors.woocommerce.categoryDeletionPermanentRequiresForce" });
+      if (id && fields.parent === id) throw new ConnectorError("connector_input_invalid", "A category cannot be its own parent.", { statusCode: 422, messageCode: "connectors.woocommerce.categoryCannotOwnParent" });
       const url = new URL(`${baseUrl(settings)}/products/categories${id ? `/${id}` : ""}`);
       if (writing) {
-        if (!Object.keys(fields).length) throw new ConnectorError("connector_input_invalid", "Supply category changes.", { statusCode: 422 });
+        if (!Object.keys(fields).length) throw new ConnectorError("connector_input_invalid", "Supply category changes.", { statusCode: 422, messageCode: "connectors.woocommerce.supplyCategoryChanges" });
         return { method: action === "create" ? "POST" : "PUT", url: url.href, body: fields };
       }
       for (const [key, value] of Object.entries(fields)) url.searchParams.set(key, String(value));
@@ -109,9 +109,9 @@ function couponWrite(update) {
     scopes: [],
     request(input, settings) {
       const { id, ...body } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
-      if (!Object.keys(body).length) throw new ConnectorError("connector_input_invalid", "Supply coupon changes.", { statusCode: 422 });
+      if (!Object.keys(body).length) throw new ConnectorError("connector_input_invalid", "Supply coupon changes.", { statusCode: 422, messageCode: "connectors.woocommerce.supplyCouponChanges" });
       if (body.discount_type === "percent" && body.amount !== undefined && Number(body.amount) > 100) {
-        throw new ConnectorError("connector_input_invalid", "Percentage discounts cannot exceed 100.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "Percentage discounts cannot exceed 100.", { statusCode: 422, messageCode: "connectors.woocommerce.percentageDiscountsCannotExceed100" });
       }
       return { method: update ? "PUT" : "POST", url: `${baseUrl(settings)}/coupons${update ? `/${id}` : ""}`, body };
     }, validateResult: validRecord.coupons
@@ -147,11 +147,11 @@ function productWrite(update) {
     request(input, settings) {
       for (const field of ["regular_price", "sale_price"]) {
         if (input?.[field] !== undefined && typeof input[field] !== "string") {
-          throw new ConnectorError("connector_input_invalid", "Product prices must be decimal strings.", { statusCode: 422 });
+          throw new ConnectorError("connector_input_invalid", "Product prices must be decimal strings.", { statusCode: 422, messageCode: "connectors.woocommerce.productPricesMustDecimalStrings" });
         }
       }
       const { id, ...body } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
-      if (!Object.keys(body).length) throw new ConnectorError("connector_input_invalid", "Supply product changes.", { statusCode: 422 });
+      if (!Object.keys(body).length) throw new ConnectorError("connector_input_invalid", "Supply product changes.", { statusCode: 422, messageCode: "connectors.woocommerce.supplyProductChanges" });
       return { method: update ? "PUT" : "POST", url: `${baseUrl(settings)}/products${update ? `/${id}` : ""}`, body };
     }, validateResult: validRecord.products
   };
@@ -177,7 +177,7 @@ function customerWrite(update) {
     request(input, settings) {
       const { id, ...body } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
       if (!Object.keys(body).length || [body.billing, body.shipping].some(value => value && !Object.keys(value).length)) {
-        throw new ConnectorError("connector_input_invalid", "Supply customer changes and non-empty address objects.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "Supply customer changes and non-empty address objects.", { statusCode: 422, messageCode: "connectors.woocommerce.supplyCustomerChangesNonEmpty" });
       }
       return { method: update ? "PUT" : "POST", url: `${baseUrl(settings)}/customers${update ? `/${id}` : ""}`, body };
     }, validateResult: validRecord.customers
@@ -207,12 +207,12 @@ function variationOperation(action) {
     scopes: [],
     request(input, settings) {
       for (const field of ["regular_price", "sale_price"]) {
-        if (input?.[field] !== undefined && typeof input[field] !== "string") throw new ConnectorError("connector_input_invalid", "Variation prices must be decimal strings.", { statusCode: 422 });
+        if (input?.[field] !== undefined && typeof input[field] !== "string") throw new ConnectorError("connector_input_invalid", "Variation prices must be decimal strings.", { statusCode: 422, messageCode: "connectors.woocommerce.variationPricesMustDecimalStrings" });
       }
       const { product_id, id, ...fields } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
       const url = new URL(`${baseUrl(settings)}/products/${product_id}/variations${id ? `/${id}` : ""}`);
       if (writing) {
-        if (!Object.keys(fields).length) throw new ConnectorError("connector_input_invalid", "Supply variation changes.", { statusCode: 422 });
+        if (!Object.keys(fields).length) throw new ConnectorError("connector_input_invalid", "Supply variation changes.", { statusCode: 422, messageCode: "connectors.woocommerce.supplyVariationChanges" });
         return { method: action === "create" ? "POST" : "PUT", url: url.href, body: fields };
       }
       for (const [key, value] of Object.entries(fields)) url.searchParams.set(key, String(value));
@@ -243,11 +243,11 @@ function refundOperation(action) {
     request(input, settings) {
       if (action === "create" && (typeof input?.amount !== "string" || typeof input.api_refund !== "boolean" || typeof input.api_restock !== "boolean" ||
           input.line_items?.some?.(line => typeof line?.refund_total !== "string"))) {
-        throw new ConnectorError("connector_input_invalid", "Choose explicit refund/restock flags and decimal-string amounts.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "Choose explicit refund/restock flags and decimal-string amounts.", { statusCode: 422, messageCode: "connectors.woocommerce.chooseExplicitRefundRestockFlags" });
       }
       const { order_id, id, ...fields } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
       if (action === "create" && fields.api_restock && !fields.line_items?.some(line => line.quantity > 0)) {
-        throw new ConnectorError("connector_input_invalid", "Restocking requires selected order lines and positive quantities.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "Restocking requires selected order lines and positive quantities.", { statusCode: 422, messageCode: "connectors.woocommerce.restockingRequiresSelectedOrderLines" });
       }
       const url = new URL(`${baseUrl(settings)}/orders/${order_id}/refunds${id ? `/${id}` : ""}`);
       if (action === "create") return { method: "POST", url: url.href, body: fields };
@@ -268,7 +268,7 @@ function reportOperation(report) {
       const fields = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
       if ((fields.date_min === undefined) !== (fields.date_max === undefined) ||
           (fields.period && fields.date_min) || (fields.date_min && fields.date_min > fields.date_max)) {
-        throw new ConnectorError("connector_input_invalid", "Choose a period or a complete ascending date range.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "Choose a period or a complete ascending date range.", { statusCode: 422, messageCode: "connectors.woocommerce.choosePeriodCompleteAscendingDate" });
       }
       const url = new URL(`${baseUrl(settings)}/reports/${report}`);
       for (const [key, value] of Object.entries(fields)) url.searchParams.set(key, value);
@@ -316,13 +316,13 @@ const woocommerceProvider = Object.freeze({
   async exchange(address, options, { request }) {
     const result = await request(address, options);
     const match = /\/wp-json\/wc\/v3\/(?:products|orders|customers|coupons)\/(\d+)$/u.exec(new URL(address).pathname);
-    if (match && result?.id !== Number(match[1])) throw new ConnectorError("connector_response_invalid", "WooCommerce returned a different record.", { statusCode: 502 });
+    if (match && result?.id !== Number(match[1])) throw new ConnectorError("connector_response_invalid", "WooCommerce returned a different record.", { statusCode: 502, messageCode: "connectors.shared.differentRecord", messageParams: { provider: "WooCommerce" } });
     const variation = /\/wp-json\/wc\/v3\/products\/\d+\/variations\/(\d+)$/u.exec(new URL(address).pathname);
-    if (variation && result?.id !== Number(variation[1])) throw new ConnectorError("connector_response_invalid", "WooCommerce returned a different variation.", { statusCode: 502 });
+    if (variation && result?.id !== Number(variation[1])) throw new ConnectorError("connector_response_invalid", "WooCommerce returned a different variation.", { statusCode: 502, messageCode: "connectors.woocommerce.returnedDifferentVariation" });
     const category = /\/wp-json\/wc\/v3\/products\/categories\/(\d+)$/u.exec(new URL(address).pathname);
-    if (category && result?.id !== Number(category[1])) throw new ConnectorError("connector_response_invalid", "WooCommerce returned a different category.", { statusCode: 502 });
+    if (category && result?.id !== Number(category[1])) throw new ConnectorError("connector_response_invalid", "WooCommerce returned a different category.", { statusCode: 502, messageCode: "connectors.woocommerce.returnedDifferentCategory" });
     const refund = /\/wp-json\/wc\/v3\/orders\/\d+\/refunds\/(\d+)$/u.exec(new URL(address).pathname);
-    if (refund && result?.id !== Number(refund[1])) throw new ConnectorError("connector_response_invalid", "WooCommerce returned a different refund.", { statusCode: 502 });
+    if (refund && result?.id !== Number(refund[1])) throw new ConnectorError("connector_response_invalid", "WooCommerce returned a different refund.", { statusCode: 502, messageCode: "connectors.woocommerce.returnedDifferentRefund" });
     return result;
   },
   operations: {
@@ -362,7 +362,7 @@ const woocommerceProvider = Object.freeze({
       scopes: [],
       request(input, settings) {
         const { id, ...body } = validateSchemaPayload({ schema: orderUpdateSchema, mode: "replace" }, input, { statusCode: 422 });
-        if (!Object.keys(body).length) throw new ConnectorError("connector_input_invalid", "Supply order changes.", { statusCode: 422 });
+        if (!Object.keys(body).length) throw new ConnectorError("connector_input_invalid", "Supply order changes.", { statusCode: 422, messageCode: "connectors.woocommerce.supplyOrderChanges" });
         return { method: "PUT", url: `${baseUrl(settings)}/orders/${id}`, body };
       }, validateResult: validRecord.orders
     },
@@ -399,12 +399,12 @@ function verifyWooCommerceWebhook({ rawBody, signature, secret } = {}) {
   if (!(rawBody instanceof Uint8Array) || rawBody.byteLength > 2 * 1024 * 1024 ||
       typeof secret !== "string" || !secret || typeof signature !== "string" ||
       !/^[A-Za-z0-9+/]{43}=$/u.test(signature)) {
-    throw new ConnectorError("connector_webhook_invalid", "Invalid WooCommerce webhook signature inputs.", { statusCode: 401 });
+    throw new ConnectorError("connector_webhook_invalid", "Invalid WooCommerce webhook signature inputs.", { statusCode: 401, messageCode: "connectors.woocommerce.invalidWebhookSignatureInputs" });
   }
   const supplied = Buffer.from(signature, "base64");
   const expected = createHmac("sha256", secret).update(rawBody).digest();
   if (supplied.toString("base64") !== signature || !timingSafeEqual(expected, supplied)) {
-    throw new ConnectorError("connector_webhook_invalid", "Invalid WooCommerce webhook signature.", { statusCode: 401 });
+    throw new ConnectorError("connector_webhook_invalid", "Invalid WooCommerce webhook signature.", { statusCode: 401, messageCode: "connectors.shared.invalidWebhookSignature", messageParams: { provider: "WooCommerce" } });
   }
   return true;
 }

package/src/server/wordpress-com.js

@@ -44,7 +44,7 @@ function siteOperation(action, fields, { resource = "posts", scope = resource, r
       const { siteId, postId, mediaId, commentId, termSlug, context, ...values } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
       delete values.confirmDeletion;
       if (changesRequired && !Object.keys(values).length) {
-        throw new ConnectorError("connector_input_invalid", "Supply at least one change.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "Supply at least one change.", { statusCode: 422, messageCode: "connectors.shared.supplyLeastChange" });
       }
       const target = termSlug === undefined ? postId ?? mediaId ?? commentId ?? (collection ? "" : "new") : `slug:${encodeURIComponent(termSlug)}`;
       const url = new URL(`https://public-api.wordpress.com/rest/v1.1/sites/${siteId}/${resource}/${target}${action ? `/${action}` : ""}`);
@@ -115,7 +115,7 @@ const wordpressComProvider = Object.freeze({
   apiOrigins: ["https://public-api.wordpress.com"], checkOperation: "profile.read",
   grantedScopesFromVerification(profile, { clientId }) {
     if (String(profile.token_client_id) !== clientId) {
-      throw new ConnectorError("connector_response_invalid", "The verified token belongs to a different application.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "The verified token belongs to a different application.", { statusCode: 502, messageCode: "connectors.wordpressCom.verifiedTokenBelongsDifferentApplication" });
     }
     return profile.token_scope;
   },
@@ -194,7 +194,7 @@ const wordpressComProvider = Object.freeze({
         const { siteId, filename, mimeType, contentBase64, ...metadata } = validateSchemaPayload({ schema: mediaUploadSchema, mode: "replace" }, input, { statusCode: 422 });
         const bytes = Buffer.from(contentBase64, "base64");
         if (!bytes.length || bytes.length > 5 * 1024 * 1024 || bytes.toString("base64") !== contentBase64) {
-          throw new ConnectorError("connector_input_invalid", "Supply canonical base64 for a nonempty file of at most 5 MiB.", { statusCode: 422 });
+          throw new ConnectorError("connector_input_invalid", "Supply canonical base64 for a nonempty file of at most 5 MiB.", { statusCode: 422, messageCode: "connectors.shared.supplyCanonicalBase64NonemptyFile" });
         }
         const body = new FormData();
         body.append("media[0]", new Blob([bytes], { type: mimeType }), filename);

package/src/server/wordpress-self-hosted.js

@@ -24,7 +24,7 @@ function wordpressOperation(resource, fields, method, validateResult, { write =
     const { id: resourceId, ...values } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
     const url = new URL(`${baseUrl(settings)}/${resource}${resourceId ? `/${resourceId}` : ""}`);
     if (write) {
-      if (!Object.keys(values).length) throw new ConnectorError("connector_input_invalid", "Supply at least one change.", { statusCode: 422 });
+      if (!Object.keys(values).length) throw new ConnectorError("connector_input_invalid", "Supply at least one change.", { statusCode: 422, messageCode: "connectors.shared.supplyLeastChange" });
       return { method, url: url.href, body: values };
     }
     for (const [key, value] of Object.entries(values)) url.searchParams.set(key, String(value));
@@ -96,7 +96,7 @@ const wordpressSelfHostedProvider = Object.freeze({
       const { filename, mimeType, contentBase64, ...metadata } = validateSchemaPayload({ schema: uploadSchema, mode: "replace" }, input, { statusCode: 422 });
       const bytes = Buffer.from(contentBase64, "base64");
       if (!bytes.length || bytes.length > 5 * 1024 * 1024 || bytes.toString("base64") !== contentBase64) {
-        throw new ConnectorError("connector_input_invalid", "Supply canonical base64 for a nonempty file of at most 5 MiB.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "Supply canonical base64 for a nonempty file of at most 5 MiB.", { statusCode: 422, messageCode: "connectors.shared.supplyCanonicalBase64NonemptyFile" });
       }
       const body = new FormData();
       body.append("file", new Blob([bytes], { type: mimeType }), filename);

package/src/server/workday.js

@@ -56,7 +56,7 @@ function absenceRead(kind) {
     request(input, settings) {
       const { worker: workerId, ...query } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
       if (query.fromDate && query.toDate && query.fromDate > query.toDate) {
-        throw new ConnectorError("connector_input_invalid", "The start date must not follow the end date.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "The start date must not follow the end date.", { statusCode: 422, messageCode: "connectors.workday.datesOrder" });
       }
       const { host, prefix = "", tenant } = workdayRestEndpoint(settings.restApiEndpoint);
       const path = kind === "statuses" ? "values/timeOff/status/" : kind === "balances" ? "balances" : `workers/${workerId}/timeOffDetails`;
@@ -105,11 +105,11 @@ const workdayProvider = Object.freeze({
         const url = new URL(`https://${host}/ccx/service/customreport2/${tenant}/${encodeURIComponent(owner)}/${encodeURIComponent(report)}`);
         const names = new Set();
         for (const { name, value } of prompts) {
-          if (names.has(name)) throw new ConnectorError("connector_input_invalid", "Supply each report prompt once; join multi-instance WIDs with !.", { statusCode: 422 });
+          if (names.has(name)) throw new ConnectorError("connector_input_invalid", "Supply each report prompt once; join multi-instance WIDs with !.", { statusCode: 422, messageCode: "connectors.workday.supplyReportPromptOnceJoin" });
           names.add(name); url.searchParams.set(name, value);
         }
         url.searchParams.set("format", "json");
-        if (url.href.length > 16384) throw new ConnectorError("connector_input_invalid", "Use a smaller report prompt request.", { statusCode: 422 });
+        if (url.href.length > 16384) throw new ConnectorError("connector_input_invalid", "Use a smaller report prompt request.", { statusCode: 422, messageCode: "connectors.workday.useSmallerReportPromptRequest" });
         return { method: "GET", url: url.href };
       },
       validateResult: result => object(result) && !result.error && !result.errors && Array.isArray(result.Report_Entry) && result.Report_Entry.every(object)

package/src/server/x-twitter.js

@@ -39,7 +39,7 @@ const xTwitterProvider = Object.freeze({
   ...xTwitterDefinition, apiOrigins: ["https://api.x.com"],
   apiKey: { headers: (key) => {
     if (!/^[\x21-\x7e]+$/u.test(key) || key.length > 8192) {
-      throw new ConnectorError("connector_binding_missing", "Use the X app-only token without spaces, control characters or a Bearer prefix.");
+      throw new ConnectorError("connector_binding_missing", "Use the X app-only token without spaces, control characters or a Bearer prefix.", { messageCode: "connectors.xTwitter.useAppTokenWithoutSpaces" });
     }
     return { Authorization: `Bearer ${key}` };
   } },
@@ -76,7 +76,7 @@ const xTwitterProvider = Object.freeze({
       request(input) {
         // Snowflake IDs exceed JS's safe integer range; reject numbers before the schema can coerce them.
         if (typeof input?.userId !== "string") {
-          const error = new ConnectorError("connector_input_invalid", "Pass the X user ID as a string.", { statusCode: 422 });
+          const error = new ConnectorError("connector_input_invalid", "Pass the X user ID as a string.", { statusCode: 422, messageCode: "connectors.xTwitter.passUserIdString" });
           error.fieldErrors = { userId: "Pass the X user ID as a string." };
           throw error;
         }
@@ -94,17 +94,17 @@ const xTwitterProvider = Object.freeze({
     let result;
     try { result = await request(address, options); } catch (error) {
       const status = Number(error?.status || error?.statusCode);
-      if (status === 402) throw new ConnectorError("connector_billing_required", "Check this X application's API credits and billing access.", { statusCode: 402 });
-      if (status === 404) throw new ConnectorError("connector_resource_not_found", "The X resource was not found or is not available.", { statusCode: 404 });
+      if (status === 402) throw new ConnectorError("connector_billing_required", "Check this X application's API credits and billing access.", { statusCode: 402, messageCode: "connectors.xTwitter.checkApplicationApiCreditsBilling" });
+      if (status === 404) throw new ConnectorError("connector_resource_not_found", "The X resource was not found or is not available.", { statusCode: 404, messageCode: "connectors.xTwitter.resourceNotFoundNotAvailable" });
       throw error;
     }
     if (Array.isArray(result?.errors) && result.errors.length) {
       if (!result.data && result.errors.every((error) => [
         "https://api.x.com/2/problems/resource-not-found", "https://api.twitter.com/2/problems/resource-not-found"
       ].includes(error?.type))) {
-        throw new ConnectorError("connector_resource_not_found", "The X resource was not found or is not available.", { statusCode: 404 });
+        throw new ConnectorError("connector_resource_not_found", "The X resource was not found or is not available.", { statusCode: 404, messageCode: "connectors.xTwitter.resourceNotFoundNotAvailable" });
       }
-      throw new ConnectorError("connector_response_incomplete", "X could not return the complete requested data.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_incomplete", "X could not return the complete requested data.", { statusCode: 502, messageCode: "connectors.xTwitter.couldNotReturnCompleteRequested" });
     }
     return result;
   }

package/src/server/xero.js

@@ -38,7 +38,7 @@ function accountingRead(resource, fields, scopes, validateResult) {
       const { tenantId, ...values } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
       if (values.fromDate && values.toDate && values.fromDate > values.toDate ||
           values.DateFrom && values.DateTo && values.DateFrom > values.DateTo) {
-        throw new ConnectorError("connector_input_invalid", "The report start date must not follow its end date.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "The report start date must not follow its end date.", { statusCode: 422, messageCode: "connectors.xero.reportDatesOrder" });
       }
       const url = new URL(`https://api.xero.com/api.xro/2.0/${resource}`);
       for (const [name, value] of Object.entries(values)) url.searchParams.set(name, String(value));
@@ -55,7 +55,7 @@ function accountingRecord(resource, idName, scopes, fields = {}) {
     request(input) {
       const { tenantId: tenant, id, ...values } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
       if (values.DateFrom && values.DateTo && values.DateFrom > values.DateTo) {
-        throw new ConnectorError("connector_input_invalid", "The budget start date must not follow its end date.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "The budget start date must not follow its end date.", { statusCode: 422, messageCode: "connectors.xero.budgetDatesOrder" });
       }
       const url = new URL(`https://api.xero.com/api.xro/2.0/${resource}/${id.toLowerCase()}`);
       for (const [name, value] of Object.entries(values)) url.searchParams.set(name, String(value));
@@ -79,7 +79,7 @@ function contactWrite(update) {
     scopes: ["accounting.contacts"],
     request(input) {
       const { tenantId: tenant, idempotencyKey, id, ...contact } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
-      if (Object.keys(contact).length === 0) throw new ConnectorError("connector_input_invalid", "Supply a contact field to change.", { statusCode: 422 });
+      if (Object.keys(contact).length === 0) throw new ConnectorError("connector_input_invalid", "Supply a contact field to change.", { statusCode: 422, messageCode: "connectors.xero.supplyContactFieldChange" });
       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] } };
     },
@@ -123,9 +123,9 @@ function invoiceWrite(update) {
     scopes: ["accounting.invoices"],
     request(input) {
       const { tenantId: tenant, idempotencyKey, id, contactId, ...invoice } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
-      if (!contactId && !Object.keys(invoice).length) throw new ConnectorError("connector_input_invalid", "Supply an invoice field to change.", { statusCode: 422 });
+      if (!contactId && !Object.keys(invoice).length) throw new ConnectorError("connector_input_invalid", "Supply an invoice field to change.", { statusCode: 422, messageCode: "connectors.xero.supplyInvoiceFieldChange" });
       if (invoice.Type === "ACCPAY" && invoice.LineItems?.some(line => line.DiscountRate !== undefined)) {
-        throw new ConnectorError("connector_input_invalid", "Discount rates apply only to sales invoices.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "Discount rates apply only to sales invoices.", { statusCode: 422, messageCode: "connectors.xero.discountRatesApplySalesInvoices" });
       }
       if (contactId) invoice.Contact = { ContactID: contactId };
       return { method: update ? "POST" : "PUT", url: `https://api.xero.com/api.xro/2.0/Invoices${update ? `/${id.toLowerCase()}` : ""}?unitdp=4`,
@@ -161,7 +161,7 @@ function attachmentOperation(action) {
       if (writing) {
         body = Buffer.from(contentBase64, "base64");
         if (!body.length || body.length > 3 * 1024 * 1024 || body.toString("base64") !== contentBase64) {
-          throw new ConnectorError("connector_input_invalid", "Supply canonical base64 for a nonempty attachment of at most 3 MiB.", { statusCode: 422 });
+          throw new ConnectorError("connector_input_invalid", "Supply canonical base64 for a nonempty attachment of at most 3 MiB.", { statusCode: 422, messageCode: "connectors.xero.supplyCanonicalBase64NonemptyAttachment" });
         }
         headers["Content-Type"] = "application/octet-stream";
         headers["Idempotency-Key"] = idempotencyKey;
@@ -200,7 +200,7 @@ function bankTransactionWrite(update) {
     scopes: ["accounting.banktransactions"],
     request(input) {
       const { tenantId: tenant, idempotencyKey, id, contactId, bankAccountId, ...transaction } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
-      if (!contactId && !bankAccountId && !Object.keys(transaction).length) throw new ConnectorError("connector_input_invalid", "Supply a bank transaction field to change.", { statusCode: 422 });
+      if (!contactId && !bankAccountId && !Object.keys(transaction).length) throw new ConnectorError("connector_input_invalid", "Supply a bank transaction field to change.", { statusCode: 422, messageCode: "connectors.xero.supplyBankTransactionFieldChange" });
       if (contactId) transaction.Contact = { ContactID: contactId };
       if (bankAccountId) transaction.BankAccount = { AccountID: bankAccountId };
       if (update) transaction.BankTransactionID = id.toLowerCase();
@@ -239,7 +239,7 @@ function manualJournalWrite(update) {
     scopes: ["accounting.manualjournals"],
     request(input) {
       const { tenantId: tenant, idempotencyKey, id, ...journal } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
-      if (!Object.keys(journal).length) throw new ConnectorError("connector_input_invalid", "Supply a journal field to change.", { statusCode: 422 });
+      if (!Object.keys(journal).length) throw new ConnectorError("connector_input_invalid", "Supply a journal field to change.", { statusCode: 422, messageCode: "connectors.xero.supplyJournalFieldChange" });
       if (update) journal.ManualJournalID = id.toLowerCase();
       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] } };
@@ -342,9 +342,9 @@ const xeroProvider = Object.freeze({
       const tenant = options.headers["Xero-tenant-id"];
       const headers = Object.fromEntries(Object.entries(options.headers).filter(([key]) => ["authorization", "accept"].includes(key.toLowerCase())));
       const connections = await request(connectionsUrl, { ...options, method: "GET", body: undefined, headers });
-      if (!validConnections(connections)) throw new ConnectorError("connector_response_invalid", "Xero returned invalid connections.", { statusCode: 502 });
+      if (!validConnections(connections)) throw new ConnectorError("connector_response_invalid", "Xero returned invalid connections.", { statusCode: 502, messageCode: "connectors.xero.returnedInvalidConnections" });
       if (!connections.some((entry) => entry.tenantType === "ORGANISATION" && entry.tenantId.toLowerCase() === tenant)) {
-        throw new ConnectorError("connector_permission_denied", "This Xero organisation is not connected to this account.", { statusCode: 403 });
+        throw new ConnectorError("connector_permission_denied", "This Xero organisation is not connected to this account.", { statusCode: 403, messageCode: "connectors.xero.organisationNotConnectedAccount" });
       }
     }
     const attachmentFile = /\/Attachments\/[^/]+$/u.test(new URL(address).pathname);
@@ -363,7 +363,7 @@ const xeroProvider = Object.freeze({
           size += value.byteLength;
           if (size > 3 * 1024 * 1024) {
             await reader.cancel();
-            throw new ConnectorError("connector_response_too_large", "Xero attachment responses are limited to 3 MiB.", { statusCode: 413 });
+            throw new ConnectorError("connector_response_too_large", "Xero attachment responses are limited to 3 MiB.", { statusCode: 413, messageCode: "connectors.xero.attachmentResponsesLimited3Mib" });
           }
           chunks.push(value);
         }
@@ -372,7 +372,7 @@ const xeroProvider = Object.freeze({
       if (downloading) return { contentBase64: bytes.toString("base64"), size,
         contentType: response.headers.get("content-type")?.split(";")[0] || "application/octet-stream" };
       try { return JSON.parse(bytes.toString("utf8")); }
-      catch { throw new ConnectorError("connector_response_invalid", "Xero returned an invalid attachment response.", { statusCode: 502 }); }
+      catch { throw new ConnectorError("connector_response_invalid", "Xero returned an invalid attachment response.", { statusCode: 502, messageCode: "connectors.xero.returnedInvalidAttachmentResponse" }); }
     }
     const result = await request(address, options);
     const url = new URL(address);
@@ -381,15 +381,15 @@ const xeroProvider = Object.freeze({
       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()) {
-        throw new ConnectorError("connector_response_invalid", "Xero returned a different record.", { statusCode: 502 });
+        throw new ConnectorError("connector_response_invalid", "Xero returned a different record.", { statusCode: 502, messageCode: "connectors.shared.differentRecord", messageParams: { provider: "Xero" } });
       }
     }
     if (url.pathname.endsWith("/Organisation") && result?.Organisations?.[0]?.OrganisationID?.toLowerCase() !== options.headers["Xero-tenant-id"]) {
-      throw new ConnectorError("connector_response_invalid", "Xero returned a different organisation.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "Xero returned a different organisation.", { statusCode: 502, messageCode: "connectors.xero.returnedDifferentOrganisation" });
     }
     const records = url.pathname.endsWith("/Contacts") ? result?.Contacts : url.pathname.endsWith("/Invoices") ? result?.Invoices : url.pathname.endsWith("/Payments") ? result?.Payments : null;
     if (url.searchParams.has("pageSize") && Array.isArray(records) && records.length > Number(url.searchParams.get("pageSize"))) {
-      throw new ConnectorError("connector_response_invalid", "Xero returned more records than requested.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "Xero returned more records than requested.", { statusCode: 502, messageCode: "connectors.shared.tooManyRecords", messageParams: { provider: "Xero" } });
     }
     return result;
   }

package/src/server/zoho-books.js

@@ -22,11 +22,11 @@ function booksList(resource, identifier) {
     request(input, settings = {}) {
       const values = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
       if (settings.organizationId && values.organization_id && values.organization_id !== settings.organizationId) {
-        throw new ConnectorError("connector_input_invalid", "This integration is configured for a different organisation.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "This integration is configured for a different organisation.", { statusCode: 422, messageCode: "connectors.zohoBooks.integrationConfiguredDifferentOrganisation" });
       }
       values.organization_id = settings.organizationId || values.organization_id;
       if (!values.organization_id) {
-        throw new ConnectorError("connector_input_invalid", "Choose an organisation ID from organizations.list or configure one for this integration.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "Choose an organisation ID from organizations.list or configure one for this integration.", { statusCode: 422, messageCode: "connectors.zohoBooks.chooseOrganisationIdOrganizationsList" });
       }
       const url = new URL(`${apiOrigin(settings)}/books/v3/${resource}`);
       for (const [name, value] of Object.entries(values)) url.searchParams.set(name, String(value));
@@ -56,31 +56,31 @@ const zohoBooksProvider = Object.freeze({
     headers.set("Authorization", headers.get("Authorization").replace(/^Bearer /u, "Zoho-oauthtoken "));
     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 });
+      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 });
     }
     let value;
     try { value = await response.json(); } catch { /* validated below */ }
     if (response.status !== 200 || value?.code !== 0) {
-      throw new ConnectorError("connector_response_invalid", "Zoho Books returned an unexpected response.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "Zoho Books returned an unexpected response.", { statusCode: 502, messageCode: "connectors.shared.unexpectedResponse", messageParams: { provider: "Zoho Books" } });
     }
     const url = new URL(address);
     if (url.pathname.endsWith("/organizations")) {
-      if (!validOrganizations(value)) throw new ConnectorError("connector_response_invalid", "Zoho Books returned invalid organisations.", { statusCode: 502 });
+      if (!validOrganizations(value)) throw new ConnectorError("connector_response_invalid", "Zoho Books returned invalid organisations.", { statusCode: 502, messageCode: "connectors.zohoBooks.returnedInvalidOrganisations" });
       if (settings.organizationId && !value.organizations.some((org) => org.organization_id === settings.organizationId && org.is_org_active)) {
-        throw new ConnectorError("connector_permission_denied", "The configured Books organisation is not active and accessible to this account.", { statusCode: 403 });
+        throw new ConnectorError("connector_permission_denied", "The configured Books organisation is not active and accessible to this account.", { statusCode: 403, messageCode: "connectors.zohoBooks.configuredOrganisationNotActiveAccessible" });
       }
     } else {
       const resource = url.pathname.split("/").at(-1);
       // Books documents invoice page_context as a singleton array; other lists use an object.
       if (resource === "invoices" && Array.isArray(value.page_context)) {
-        if (value.page_context.length !== 1) throw new ConnectorError("connector_response_invalid", "Zoho Books returned ambiguous pagination.", { statusCode: 502 });
+        if (value.page_context.length !== 1) throw new ConnectorError("connector_response_invalid", "Zoho Books returned ambiguous pagination.", { statusCode: 502, messageCode: "connectors.zohoBooks.returnedAmbiguousPagination" });
         value.page_context = value.page_context[0];
       }
       if (value[resource]?.length > Number(url.searchParams.get("per_page")) ||
         value.page_context?.per_page !== Number(url.searchParams.get("per_page")) ||
         value.page_context?.page !== Number(url.searchParams.get("page"))) {
-        throw new ConnectorError("connector_response_invalid", "Zoho Books returned an unexpected page.", { statusCode: 502 });
+        throw new ConnectorError("connector_response_invalid", "Zoho Books returned an unexpected page.", { statusCode: 502, messageCode: "connectors.shared.unexpectedPage", messageParams: { provider: "Zoho Books" } });
       }
     }
     return value;

package/src/server/zoho-crm.js

@@ -25,7 +25,7 @@ function recordsList(module, defaults) {
     request(input, settings) {
       const values = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
       if (values.page !== undefined && values.page_token !== undefined) {
-        throw new ConnectorError("connector_input_invalid", "Use either a page number or a page token.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "Use either a page number or a page token.", { statusCode: 422, messageCode: "connectors.zohoCrm.useEitherPageNumberPage" });
       }
       if (!values.page_token && values.page === undefined) values.page = 1;
       const url = new URL(`${apiOrigin(settings)}/crm/v8/${module}`);
@@ -69,18 +69,18 @@ const zohoCrmProvider = Object.freeze({
     if (response.status === 204 && list) return { data: [], info: { count: 0, per_page: perPage, more_records: false } };
     let value;
     try { value = await response.json(); } catch { /* checked after status mapping */ }
-    if (value?.code === "OAUTH_SCOPE_MISMATCH") throw new ConnectorError("connector_scope_missing", "Connect again with the CRM permissions needed for this operation.", { statusCode: 403 });
+    if (value?.code === "OAUTH_SCOPE_MISMATCH") throw new ConnectorError("connector_scope_missing", "Connect again with the CRM permissions needed for this operation.", { statusCode: 403, messageCode: "connectors.zohoCrm.connectAgainPermissionsNeededOperation" });
     if (!response.ok) {
-      if (response.status === 404) throw new ConnectorError("connector_resource_not_found", "This CRM resource is not available.", { statusCode: 404 });
+      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 });
     }
     if (response.status !== 200 || !value || value.status === "error" || value.code) {
-      throw new ConnectorError("connector_response_invalid", "Zoho CRM returned an unexpected response.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "Zoho CRM returned an unexpected response.", { statusCode: 502, messageCode: "connectors.shared.unexpectedResponse", messageParams: { provider: "Zoho CRM" } });
     }
     if (list && (value.data?.length > perPage || value.info?.per_page !== perPage ||
       url.searchParams.has("page") && value.info?.page !== Number(url.searchParams.get("page")))) {
-      throw new ConnectorError("connector_response_invalid", "Zoho CRM returned an unexpected page.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "Zoho CRM returned an unexpected page.", { statusCode: 502, messageCode: "connectors.shared.unexpectedPage", messageParams: { provider: "Zoho CRM" } });
     }
     return value;
   }

package/src/server/zohoOAuth.js

@@ -13,7 +13,7 @@ async function normalizeZohoTokenResponse(response, expectedApiOrigin) {
     return Response.json({ error: value.error === "invalid_code" ? "invalid_grant" : value.error }, { status: 400 });
   }
   if (response.ok && value?.api_domain !== expectedApiOrigin) {
-    throw new ConnectorError("connector_response_invalid", "Zoho returned a token for a different data center or environment.", { statusCode: 502 });
+    throw new ConnectorError("connector_response_invalid", "Zoho returned a token for a different data center or environment.", { statusCode: 502, messageCode: "connectors.zoho.returnedTokenDifferentDataCenter" });
   }
   return response;
 }

package/src/shared/ai.js

@@ -1,11 +1,18 @@
 import { createSchema } from "json-rest-schema";
 import snapshot from "./ai-models.json" with { type: "json" };
 
+// Message keys; render them with the app's text helper (useJskitText().text).
 const aiAccessLabels = Object.freeze({
-  "free-no-setup": "Free · no account or key",
-  "free-with-connection": "Free · connection required",
-  paid: "Paid · connection required",
-  unknown: "Pricing unknown · check provider"
+  "free-no-setup": "jskit.connectors.ai.access.freeNoSetup",
+  "free-with-connection": "jskit.connectors.ai.access.freeWithConnection",
+  paid: "jskit.connectors.ai.access.paid",
+  unknown: "jskit.connectors.ai.access.unknown"
+});
+const selectedModelHints = Object.freeze({
+  "free-no-setup": "jskit.connectors.ai.fields.model.selectedHint.freeNoSetup",
+  "free-with-connection": "jskit.connectors.ai.fields.model.selectedHint.freeWithConnection",
+  paid: "jskit.connectors.ai.fields.model.selectedHint.paid",
+  unknown: "jskit.connectors.ai.fields.model.selectedHint.unknown"
 });
 // These direct API-key routes need no coding subscription or cloud identity
 // exchange. Other upstream entries remain available as framework metadata.
@@ -15,8 +22,7 @@ const aiCatalogue = Object.freeze({ ...snapshot, providers: Object.freeze(snapsh
   ...provider, connection: directProviders.has(provider.id) ? "api-key" : "framework",
   models: Object.freeze(provider.models.map((model) => Object.freeze({ ...model, key: `${provider.id}/${model.id}`, providerId: provider.id })))
 }))) });
-const catalogueDate = new Intl.DateTimeFormat("en-GB", { day: "numeric", month: "long", year: "numeric", timeZone: "UTC" })
-  .format(new Date(snapshot.extractedAt));
+const catalogueDateFormat = Object.freeze({ day: "numeric", month: "long", year: "numeric", timeZone: "UTC" });
 const models = new Map(aiCatalogue.providers.flatMap((provider) => provider.models.map((model) => [model.key, model])));
 
 function getAiModel(key) { return models.get(key); }
@@ -34,21 +40,26 @@ const modelItems = Object.freeze(listAiModels({ configurableOnly: true }).map((m
   value: model.key, title: `${model.name} (${model.providerId})`, props: { subtitle: aiAccessLabels[model.access] }
 })));
 const aiDefinition = Object.freeze({
-  id: "ai", name: "AI", description: "Choose an app AI provider, model and whose account pays. No model is preselected.",
+  id: "ai", name: "AI", description: "jskit.connectors.ai.description",
   accountModes: ["shared", "per-user"], authenticationMethods: ["api-key", "none"], scopes: [],
   authenticationMethodsForSettings: (settings = {}) => getAiModel(settings.model)?.access === "free-no-setup"
     ? ["none", "api-key"] : ["api-key"],
-  authenticationLabels: { none: "Free access · no account or key", "api-key": "Use a provider API key" },
-  authenticationHint: "Your app calls the provider directly. A shared account belongs to the app administrator; individual accounts belong to each signed-in app user.",
+  authenticationLabels: { none: "jskit.connectors.ai.authenticationLabels.none", "api-key": "jskit.connectors.ai.authenticationLabels.apiKey" },
+  authenticationHint: "jskit.connectors.ai.authenticationHint",
   settingsSchema: createSchema({ model: { type: "string", required: true,
     enum: modelItems.map((item) => item.value) } }),
-  settingsFields: [{ name: "model", label: "AI model", searchable: true, items: modelItems,
+  settingsFields: [{ name: "model", label: "jskit.connectors.ai.fields.model.label", searchable: true, items: modelItems,
     credentialScope: (key) => getAiModel(key)?.providerId,
-    hint: (settings = {}) => {
+    // The catalogue date is display text: formatDate (useJskitText's) uses the app's active
+    // locale; without an app language it keeps its fixed English form.
+    hint: (settings = {}, { formatDate } = {}) => {
       const model = getAiModel(settings.model);
-      return `${model ? `${model.name}: ${aiAccessLabels[model.access]}. ` : "Choose a provider and model. "}Search by provider or model. Catalogue dated ${catalogueDate}; availability can change. No automatic paid fallback.`;
+      const date = formatDate ? formatDate(snapshot.extractedAt, catalogueDateFormat)
+        : new Date(snapshot.extractedAt).toLocaleDateString("en-GB", catalogueDateFormat);
+      return model ? { key: selectedModelHints[model.access], params: { model: model.name, date } }
+        : { key: "jskit.connectors.ai.fields.model.hint", params: { date } };
     } }],
-  apiKeyReferenceHint: "Use an environment reference for an administrator key. For individual accounts, use a private reference your app resolves for the authenticated user. Never put a key in this file.",
+  apiKeyReferenceHint: "jskit.connectors.ai.apiKeyReferenceHint",
   setup: {
     url: "https://opencode.ai/docs/zen/",
     steps: [

package/src/shared/algolia.js

@@ -2,7 +2,7 @@ import { createSchema } from "json-rest-schema";
 import { secretReference } from "@jskit-ai/connectors-core/shared/configuration";
 
 const algoliaDefinition = Object.freeze({
-  id: "algolia", name: "Algolia", description: "Search and maintain index records, and check indexing completion.",
+  id: "algolia", name: "Algolia", description: "jskit.connectors.algolia.description",
   accountModes: ["shared", "assistant"], authenticationMethods: ["api-key"], scopes: [],
   settingsSchema: createSchema({
     applicationId: { type: "string", required: true, minLength: 1, maxLength: 63,
@@ -10,9 +10,9 @@ const algoliaDefinition = Object.freeze({
     publicApiKeyRef: { ...secretReference, required: false }
   }),
   settingsFields: [
-    { name: "applicationId", label: "Application ID", hint: "Copy the ID from your Algolia application's API Keys page. This ID can be public." },
-    { name: "publicApiKeyRef", environmentCredential: { label: "Public frontend API key", public: true }, label: "Public API key reference (optional)", placeholder: "env:ALGOLIA_SEARCH_KEY",
-      hint: "Optional search-only key for your frontend. Enter its reference; your app decides whether to expose its value." }
+    { name: "applicationId", label: "jskit.connectors.algolia.fields.applicationId.label", hint: "jskit.connectors.algolia.fields.applicationId.hint" },
+    { name: "publicApiKeyRef", environmentCredential: { label: "jskit.connectors.algolia.fields.publicApiKeyRef.environmentCredential.label", public: true }, label: "jskit.connectors.algolia.fields.publicApiKeyRef.label", placeholder: "env:ALGOLIA_SEARCH_KEY",
+      hint: "jskit.connectors.algolia.fields.publicApiKeyRef.hint" }
   ],
   setup: {
     url: "https://www.algolia.com/doc/guides/security/api-keys",