@jskit-ai/connectors-catalog 0.1.67 → 0.2.0

package/src/shared/microsoft.js

@@ -10,28 +10,28 @@ function definition(id, name, description, permission, label, organizationOnly =
     accountModes: ["shared", "per-user", "assistant"], authenticationMethods: ["oauth2"],
     scopes: [
       { value: permission, label, recommended: true },
-      { value: "offline_access", label: "Keep access when you are away", 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) ||
           `Use ${audiences.join(", ")} or your Directory (tenant) ID as a GUID.` }
     }),
-    settingsFields: [{ name: "tenantId", label: "Directory (tenant) ID", placeholder: authority,
-      hint: `Use ${authority} for the default audience, or the directory GUID for a single-tenant app. This is not the Application (client) ID.` }]
+    settingsFields: [{ name: "tenantId", label: "jskit.connectors.microsoft.fields.tenantId.label", placeholder: authority,
+      hint: { key: "jskit.connectors.microsoft.fields.tenantId.hint", params: { authority } } }]
   });
 }
 
 const microsoftOutlookDefinition = Object.freeze({
-  ...definition("microsoft-outlook", "Microsoft Outlook", "Read messages and files, send text mail, manage read/folder state and calendar appointments.", "Mail.Read", "Read your mail"),
+  ...definition("microsoft-outlook", "Microsoft Outlook", "jskit.connectors.microsoftOutlook.description", "Mail.Read", "jskit.connectors.microsoftOutlook.scopes.mailRead.label"),
   scopes: [
-    { value: "Mail.Read", label: "Read your mail", required: true, recommended: true },
-    { value: "Mail.ReadWrite", label: "Read and write your mail", recommended: true },
-    { value: "Mail.Send", label: "Send mail as you", recommended: true },
-    { value: "Mail.ReadBasic", label: "Read basic mail properties" },
-    { value: "Calendars.Read", label: "Read your calendars" },
-    { value: "Calendars.ReadWrite", label: "Read and write your calendars", recommended: true },
-    { value: "offline_access", label: "Keep access when you are away", recommended: true }
+    { value: "Mail.Read", label: "jskit.connectors.microsoftOutlook.scopes.mailRead.label", required: true, recommended: true },
+    { value: "Mail.ReadWrite", label: "jskit.connectors.microsoftOutlook.scopes.mailReadWrite.label", recommended: true },
+    { value: "Mail.Send", label: "jskit.connectors.microsoftOutlook.scopes.mailSend.label", recommended: true },
+    { value: "Mail.ReadBasic", label: "jskit.connectors.microsoftOutlook.scopes.mailReadBasic.label" },
+    { value: "Calendars.Read", label: "jskit.connectors.microsoftOutlook.scopes.calendarsRead.label" },
+    { value: "Calendars.ReadWrite", label: "jskit.connectors.microsoftOutlook.scopes.calendarsReadWrite.label", recommended: true },
+    { value: "offline_access", label: "jskit.connectors.microsoftOutlook.scopes.offlineAccess.label", recommended: true }
   ],
   setup: {
     url: registrationUrl,
@@ -50,14 +50,14 @@ const microsoftOutlookDefinition = Object.freeze({
   }
 });
 const microsoftOneDriveDefinition = Object.freeze({
-  ...definition("microsoft-onedrive", "Microsoft OneDrive", "Browse folders, obtain file downloads and upload small files.", "Files.Read", "Read your files"),
+  ...definition("microsoft-onedrive", "Microsoft OneDrive", "jskit.connectors.microsoftOneDrive.description", "Files.Read", "jskit.connectors.microsoftOneDrive.scopes.filesRead.label"),
   scopes: [
-    { value: "Files.Read", label: "Read your files", required: true, recommended: true },
-    { value: "Files.Read.All", label: "Read all files you can access", recommended: true },
-    { value: "Files.ReadWrite", label: "Read and write your files", recommended: true },
-    { value: "Files.ReadWrite.All", label: "Read and write all files you can access" },
-    { value: "Files.ReadWrite.AppFolder", label: "Read and write files in the application's folder" },
-    { value: "offline_access", label: "Keep access when you are away", recommended: true }
+    { value: "Files.Read", label: "jskit.connectors.microsoftOneDrive.scopes.filesRead.label", required: true, recommended: true },
+    { value: "Files.Read.All", label: "jskit.connectors.microsoftOneDrive.scopes.filesReadAll.label", recommended: true },
+    { value: "Files.ReadWrite", label: "jskit.connectors.microsoftOneDrive.scopes.filesReadWrite.label", recommended: true },
+    { value: "Files.ReadWrite.All", label: "jskit.connectors.microsoftOneDrive.scopes.filesReadWriteAll.label" },
+    { value: "Files.ReadWrite.AppFolder", label: "jskit.connectors.microsoftOneDrive.scopes.filesReadWriteAppFolder.label" },
+    { value: "offline_access", label: "jskit.connectors.microsoftOneDrive.scopes.offlineAccess.label", recommended: true }
   ],
   setup: {
     url: registrationUrl,
@@ -75,13 +75,13 @@ const microsoftOneDriveDefinition = Object.freeze({
   }
 });
 const microsoftExcelDefinition = Object.freeze({
-  ...definition("microsoft-excel", "Microsoft Excel", "Browse workbooks and read or update bounded cell ranges with explicit sessions.", "Files.Read", "Read your files"),
+  ...definition("microsoft-excel", "Microsoft Excel", "jskit.connectors.microsoftExcel.description", "Files.Read", "jskit.connectors.microsoftExcel.scopes.filesRead.label"),
   scopes: [
-    { value: "Files.Read", label: "Read your files", required: true, recommended: true },
-    { value: "Files.ReadWrite", label: "Read and write your files (required by Excel worksheets)", recommended: true },
-    { value: "Files.Read.All", label: "Read all files you can access" },
-    { value: "Files.ReadWrite.All", label: "Read and write all files you can access" },
-    { value: "offline_access", label: "Keep access when you are away", recommended: true }
+    { value: "Files.Read", label: "jskit.connectors.microsoftExcel.scopes.filesRead.label", required: true, recommended: true },
+    { value: "Files.ReadWrite", label: "jskit.connectors.microsoftExcel.scopes.filesReadWrite.label", recommended: true },
+    { value: "Files.Read.All", label: "jskit.connectors.microsoftExcel.scopes.filesReadAll.label" },
+    { value: "Files.ReadWrite.All", label: "jskit.connectors.microsoftExcel.scopes.filesReadWriteAll.label" },
+    { value: "offline_access", label: "jskit.connectors.microsoftExcel.scopes.offlineAccess.label", recommended: true }
   ],
   setup: {
     url: registrationUrl,
@@ -100,16 +100,16 @@ const microsoftExcelDefinition = Object.freeze({
   }
 });
 const microsoftTeamsDefinition = Object.freeze({
-  ...definition("microsoft-teams", "Microsoft Teams", "Browse teams/channels and read or send channel and existing-chat messages.", "Team.ReadBasic.All", "List joined teams", true),
+  ...definition("microsoft-teams", "Microsoft Teams", "jskit.connectors.microsoftTeams.description", "Team.ReadBasic.All", "jskit.connectors.microsoftTeams.scopes.teamReadBasicAll.label", true),
   scopes: [
-    { value: "Team.ReadBasic.All", label: "List joined teams", required: true, recommended: true },
-    { value: "Channel.ReadBasic.All", label: "List channels in teams", required: true, recommended: true },
-    { value: "User.Read", label: "Read user profile", required: true, recommended: true },
-    { value: "ChannelMessage.Send", label: "Send messages to channels", recommended: true },
-    { value: "ChannelMessage.Read.All", label: "Read channel messages" },
-    { value: "Chat.ReadWrite", label: "Read and send chat messages" },
-    { value: "User.Read.All", label: "Read all users' full profiles", recommended: true },
-    { value: "offline_access", label: "Keep access when you are away", recommended: true }
+    { value: "Team.ReadBasic.All", label: "jskit.connectors.microsoftTeams.scopes.teamReadBasicAll.label", required: true, recommended: true },
+    { value: "Channel.ReadBasic.All", label: "jskit.connectors.microsoftTeams.scopes.channelReadBasicAll.label", required: true, recommended: true },
+    { value: "User.Read", label: "jskit.connectors.microsoftTeams.scopes.userRead.label", required: true, recommended: true },
+    { value: "ChannelMessage.Send", label: "jskit.connectors.microsoftTeams.scopes.channelMessageSend.label", recommended: true },
+    { value: "ChannelMessage.Read.All", label: "jskit.connectors.microsoftTeams.scopes.channelMessageReadAll.label" },
+    { value: "Chat.ReadWrite", label: "jskit.connectors.microsoftTeams.scopes.chatReadWrite.label" },
+    { value: "User.Read.All", label: "jskit.connectors.microsoftTeams.scopes.userReadAll.label", recommended: true },
+    { value: "offline_access", label: "jskit.connectors.microsoftTeams.scopes.offlineAccess.label", recommended: true }
   ],
   setup: {
     url: registrationUrl,
@@ -127,14 +127,14 @@ const microsoftTeamsDefinition = Object.freeze({
   }
 });
 const microsoftOneNoteDefinition = Object.freeze({
-  ...definition("microsoft-onenote", "Microsoft OneNote", "Browse notebooks and pages, read content, and create or append text notes.", "Notes.Read", "Read your notebooks"),
+  ...definition("microsoft-onenote", "Microsoft OneNote", "jskit.connectors.microsoftOneNote.description", "Notes.Read", "jskit.connectors.microsoftOneNote.scopes.notesRead.label"),
   scopes: [
-    { value: "Notes.Read", label: "Read your notebooks", required: true, recommended: true },
-    { value: "Notes.Read.All", label: "Read notebooks you can access in your organization", recommended: true },
-    { value: "Notes.ReadWrite.All", label: "Read and modify notebooks you can access in your organization", recommended: true },
-    { value: "Notes.Create", label: "Create pages in OneNote notebooks", recommended: true },
-    { value: "Notes.ReadWrite", label: "Read and modify your notebooks", recommended: true },
-    { value: "offline_access", label: "Keep access when you are away", recommended: true }
+    { value: "Notes.Read", label: "jskit.connectors.microsoftOneNote.scopes.notesRead.label", required: true, recommended: true },
+    { value: "Notes.Read.All", label: "jskit.connectors.microsoftOneNote.scopes.notesReadAll.label", recommended: true },
+    { value: "Notes.ReadWrite.All", label: "jskit.connectors.microsoftOneNote.scopes.notesReadWriteAll.label", recommended: true },
+    { value: "Notes.Create", label: "jskit.connectors.microsoftOneNote.scopes.notesCreate.label", recommended: true },
+    { value: "Notes.ReadWrite", label: "jskit.connectors.microsoftOneNote.scopes.notesReadWrite.label", recommended: true },
+    { value: "offline_access", label: "jskit.connectors.microsoftOneNote.scopes.offlineAccess.label", recommended: true }
   ],
   setup: {
     url: registrationUrl,
@@ -152,18 +152,18 @@ const microsoftOneNoteDefinition = Object.freeze({
   }
 });
 const microsoftSharePointDefinition = Object.freeze({
-  ...definition("microsoft-sharepoint", "Microsoft SharePoint", "Browse sites/libraries, transfer small files and edit list items.", "Sites.Read.All", "Read items in all site collections", true, [
-    { name: "search", required: true, label: "Site search", hint: "Enter a search term for accessible SharePoint sites. Verification performs this search without changing a site." }
+  ...definition("microsoft-sharepoint", "Microsoft SharePoint", "jskit.connectors.microsoftSharePoint.description", "Sites.Read.All", "jskit.connectors.microsoftSharePoint.scopes.sitesReadAll.label", true, [
+    { name: "search", required: true, label: "jskit.connectors.microsoftSharePoint.verificationFields.search.label", hint: "jskit.connectors.microsoftSharePoint.verificationFields.search.hint" }
   ]),
   scopes: [
-    { value: "Sites.Read.All", label: "Read items in all site collections", required: true, recommended: true },
-    { value: "User.Read", label: "Read user profile", required: true, recommended: true },
-    { value: "Sites.ReadWrite.All", label: "Edit or delete items in all site collections", recommended: true },
-    { value: "Sites.Manage.All", label: "Create, edit, and delete items and lists in all site collections" },
-    { value: "Sites.FullControl.All", label: "Have full control of all site collections" },
-    { value: "Files.Read.All", label: "Read all files that user can access", recommended: true },
-    { value: "Files.ReadWrite.All", label: "Read and write all files that user can access" },
-    { value: "offline_access", label: "Keep access when you are away", recommended: true }
+    { value: "Sites.Read.All", label: "jskit.connectors.microsoftSharePoint.scopes.sitesReadAll.label", required: true, recommended: true },
+    { value: "User.Read", label: "jskit.connectors.microsoftSharePoint.scopes.userRead.label", required: true, recommended: true },
+    { value: "Sites.ReadWrite.All", label: "jskit.connectors.microsoftSharePoint.scopes.sitesReadWriteAll.label", recommended: true },
+    { value: "Sites.Manage.All", label: "jskit.connectors.microsoftSharePoint.scopes.sitesManageAll.label" },
+    { value: "Sites.FullControl.All", label: "jskit.connectors.microsoftSharePoint.scopes.sitesFullControlAll.label" },
+    { value: "Files.Read.All", label: "jskit.connectors.microsoftSharePoint.scopes.filesReadAll.label", recommended: true },
+    { value: "Files.ReadWrite.All", label: "jskit.connectors.microsoftSharePoint.scopes.filesReadWriteAll.label" },
+    { value: "offline_access", label: "jskit.connectors.microsoftSharePoint.scopes.offlineAccess.label", recommended: true }
   ],
   setup: {
     url: registrationUrl,
@@ -182,7 +182,7 @@ const microsoftSharePointDefinition = Object.freeze({
   }
 });
 const microsoftWordDefinition = Object.freeze({
-  ...definition("microsoft-word", "Microsoft Word", "Browse Word files and folders in your drive and read document metadata.", "Files.Read", "Read your files"),
+  ...definition("microsoft-word", "Microsoft Word", "jskit.connectors.microsoftWord.description", "Files.Read", "jskit.connectors.microsoftWord.scopes.filesRead.label"),
   setup: {
     url: registrationUrl,
     steps: [
@@ -197,7 +197,7 @@ const microsoftWordDefinition = Object.freeze({
   }
 });
 const microsoftPowerPointDefinition = Object.freeze({
-  ...definition("microsoft-powerpoint", "Microsoft PowerPoint", "Browse PowerPoint files and folders in your drive and read presentation metadata.", "Files.Read", "Read your files"),
+  ...definition("microsoft-powerpoint", "Microsoft PowerPoint", "jskit.connectors.microsoftPowerPoint.description", "Files.Read", "jskit.connectors.microsoftPowerPoint.scopes.filesRead.label"),
   setup: {
     url: registrationUrl,
     steps: [

package/src/shared/miro.js

@@ -1,11 +1,11 @@
 const miroDefinition = Object.freeze({
-  id: "miro", name: "Miro", description: "Use Miro board tools through the assistant owner's selected team.",
+  id: "miro", name: "Miro", description: "jskit.connectors.miro.description",
   accountModes: ["assistant"], authenticationMethods: ["oauth2"],
   scopes: [
-    { value: "boards:read", label: "Read boards", recommended: true },
-    { value: "boards:write", label: "Create and edit boards" },
-    { value: "openid", label: "Include account identity" },
-    { value: "email", label: "Read your email address" }
+    { value: "boards:read", label: "jskit.connectors.miro.scopes.boardsRead.label", recommended: true },
+    { value: "boards:write", label: "jskit.connectors.miro.scopes.boardsWrite.label" },
+    { value: "openid", label: "jskit.connectors.miro.scopes.openid.label" },
+    { value: "email", label: "jskit.connectors.miro.scopes.email.label" }
   ],
   setup: {
     url: "https://developers.miro.com/docs/connecting-to-miro-mcp",

package/src/shared/oura.js

@@ -1,11 +1,11 @@
 const ouraDefinition = Object.freeze({
-  id: "oura", name: "Oura", description: "Connect an individual's Oura account to read sleep, readiness, activity, heart-rate and permitted profile data.",
+  id: "oura", name: "Oura", description: "jskit.connectors.oura.description",
   accountModes: ["per-user"], authenticationMethods: ["oauth2"],
   scopes: [
-    { value: "daily", label: "Read daily sleep, activity and readiness summaries", required: true },
-    { value: "heartrate", label: "Read heart-rate samples" },
-    { value: "personal", label: "Read personal profile information" },
-    { value: "email", label: "Read the account email address" }
+    { value: "daily", label: "jskit.connectors.oura.scopes.daily.label", required: true },
+    { value: "heartrate", label: "jskit.connectors.oura.scopes.heartrate.label" },
+    { value: "personal", label: "jskit.connectors.oura.scopes.personal.label" },
+    { value: "email", label: "jskit.connectors.oura.scopes.email.label" }
   ],
   setup: {
     url: "https://support.ouraring.com/hc/en-us/articles/4415266939155-The-Oura-API",

package/src/shared/posthog.js

@@ -1,23 +1,23 @@
 import { createSchema } from "json-rest-schema";
 
 const posthogDefinition = Object.freeze({
-  id: "posthog", name: "PostHog", description: "Capture events and evaluate flags with a public project token.",
+  id: "posthog", name: "PostHog", description: "jskit.connectors.posthog.description",
   accountModes: ["shared", "assistant"], authenticationMethods: ["api-key"], scopes: [],
-  apiKeyReferenceLabel: "Project token reference",
-  verificationFields: [{ name: "distinct_id", required: true, label: "Verification user ID",
-    hint: "Enter the identity whose feature flags should be evaluated. This check does not submit an analytics event." }],
-  apiKeyReferenceHint: "Use an environment reference for the project's public token (phc_). Your app may expose that token in its frontend. It cannot read private analytics.",
+  apiKeyReferenceLabel: "jskit.connectors.posthog.apiKeyReferenceLabel",
+  verificationFields: [{ name: "distinct_id", required: true, label: "jskit.connectors.posthog.verificationFields.distinctId.label",
+    hint: "jskit.connectors.posthog.verificationFields.distinctId.hint" }],
+  apiKeyReferenceHint: "jskit.connectors.posthog.apiKeyReferenceHint",
   settingsSchema: createSchema({
     region: { type: "string", enum: ["eu", "us"], defaultTo: "eu" },
     projectId: { type: "string", required: true, minLength: 1, maxLength: 20,
       validator: (value) => /^[1-9][0-9]*$/u.test(value) || "Enter the numeric project ID from PostHog project settings." }
   }),
   settingsFields: [
-    { name: "region", label: "Region", hint: "Choose the PostHog Cloud region containing this project.", items: [
-      { value: "eu", title: "Europe (eu.i.posthog.com)" }, { value: "us", title: "United States (us.i.posthog.com)" }
+    { name: "region", label: "jskit.connectors.posthog.fields.region.label", hint: "jskit.connectors.posthog.fields.region.hint", items: [
+      { value: "eu", title: "jskit.connectors.posthog.fields.region.items.eu.title" }, { value: "us", title: "jskit.connectors.posthog.fields.region.items.us.title" }
     ] },
-    { name: "projectId", label: "Project ID", placeholder: "12345",
-      hint: "Public numeric ID from project settings. Public API requests use the token to select the project; verification does not match this ID to the token." }
+    { name: "projectId", label: "jskit.connectors.posthog.fields.projectId.label", placeholder: "12345",
+      hint: "jskit.connectors.posthog.fields.projectId.hint" }
   ],
   setup: {
     url: "https://posthog.com/docs/settings/projects",

package/src/shared/prestashop.js

@@ -2,13 +2,13 @@ import { createSchema } from "json-rest-schema";
 import { httpsSiteUrlField } from "./siteUrl.js";
 
 const prestashopDefinition = Object.freeze({
-  id: "prestashop", name: "PrestaShop", description: "Read products and orders from your PrestaShop store.",
+  id: "prestashop", name: "PrestaShop", description: "jskit.connectors.prestashop.description",
   accountModes: ["shared", "assistant"], authenticationMethods: ["api-key"], scopes: [],
-  apiKeyReferenceLabel: "Webservice API key reference",
-  apiKeyReferenceHint: "Store the Webservice key outside source. Grant GET for products, and for orders if the application needs order reads.",
+  apiKeyReferenceLabel: "jskit.connectors.prestashop.apiKeyReferenceLabel",
+  apiKeyReferenceHint: "jskit.connectors.prestashop.apiKeyReferenceHint",
   settingsSchema: createSchema({ siteUrl: httpsSiteUrlField }),
-  settingsFields: [{ name: "siteUrl", label: "Store URL", placeholder: "https://shop.example.com",
-    hint: "Use the HTTPS store address before /api, keeping any installation subdirectory." }],
+  settingsFields: [{ name: "siteUrl", label: "jskit.connectors.prestashop.fields.siteUrl.label", placeholder: "https://shop.example.com",
+    hint: "jskit.connectors.prestashop.fields.siteUrl.hint" }],
   setup: {
     url: "https://devdocs.prestashop-project.org/9/webservice/tutorials/creating-access/",
     steps: [

package/src/shared/resend.js

@@ -1,5 +1,5 @@
 const resendDefinition = Object.freeze({
-  id: "resend", name: "Resend", description: "Send transactional email and manage contact segments and draft broadcasts.",
+  id: "resend", name: "Resend", description: "jskit.connectors.resend.description",
   accountModes: ["shared", "assistant"], authenticationMethods: ["api-key"], scopes: [],
   setup: {
     url: "https://resend.com/docs/create-an-api-key",

package/src/shared/salesforce.js

@@ -4,7 +4,7 @@ const label = "[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?";
 const production = new RegExp(`^https://${label}(?:\\.develop)?\\.my\\.salesforce\\.com/?$`, "u");
 const sandbox = new RegExp(`^https://${label}\\.sandbox\\.my\\.salesforce\\.com/?$`, "u");
 const salesforceDefinition = Object.freeze({
-  id: "salesforce", name: "Salesforce", description: "Explore Salesforce objects and read records with your organisation's API permissions.",
+  id: "salesforce", name: "Salesforce", description: "jskit.connectors.salesforce.description",
   accountModes: ["shared", "per-user", "assistant"], authenticationMethods: ["oauth2"],
   oauthClientAuthenticationMethods: ["client_secret_post"],
   settingsSchema: createSchema({
@@ -13,16 +13,16 @@ const salesforceDefinition = Object.freeze({
       (object.environment === "sandbox" ? sandbox : production).test(value) || "Enter a lowercase HTTPS My Domain URL matching the selected environment, without a path, query or port." }
   }),
   settingsFields: [
-    { name: "environment", label: "Environment", items: [{ value: "production", title: "Production" }, { value: "sandbox", title: "Sandbox" }],
-      hint: "Production includes Developer Edition. Sandbox uses the org's .sandbox.my.salesforce.com domain." },
-    { name: "accountUrl", label: "Account URL", placeholder: "https://acme.my.salesforce.com",
-      hint: "Copy My Domain from Salesforce Setup. The same org receives authorization and API requests." }
+    { name: "environment", label: "jskit.connectors.salesforce.fields.environment.label", items: [{ value: "production", title: "jskit.connectors.salesforce.fields.environment.items.production.title" }, { value: "sandbox", title: "jskit.connectors.salesforce.fields.environment.items.sandbox.title" }],
+      hint: "jskit.connectors.salesforce.fields.environment.hint" },
+    { name: "accountUrl", label: "jskit.connectors.salesforce.fields.accountUrl.label", placeholder: "https://acme.my.salesforce.com",
+      hint: "jskit.connectors.salesforce.fields.accountUrl.hint" }
   ],
   scopes: [
-    { value: "api", label: "Access Salesforce APIs with this user's permissions", recommended: true },
-    { value: "refresh_token", label: "Keep access when the user is away", recommended: true }
+    { value: "api", label: "jskit.connectors.salesforce.scopes.api.label", recommended: true },
+    { value: "refresh_token", label: "jskit.connectors.salesforce.scopes.refreshToken.label", recommended: true }
   ],
-  permissionsHint: "Salesforce's api permission can allow writes. This runtime exposes reads; your app still authorizes each query. Connecting an account does not sign the person into your application.",
+  permissionsHint: "jskit.connectors.salesforce.permissionsHint",
   setup: { url: "https://help.salesforce.com/s/articleView?id=sf.external_client_apps.htm&type=5", steps: [
     "In Salesforce Setup, open My Domain and copy the org's login URL. Select Production for production/Developer Edition or Sandbox for a sandbox org.",
     "Open External Client App Manager and create an External Client App. Enter its name, API name and contact email; use Local for an app used only by this org.",

package/src/shared/semrush.js

@@ -2,14 +2,14 @@ import { createSchema } from "json-rest-schema";
 import { secretReference } from "@jskit-ai/connectors-core/shared/configuration";
 
 const semrushDefinition = Object.freeze({
-  id: "semrush", name: "Semrush", description: "Read keyword and backlink reports and manage Semrush projects using a V4 API key.",
+  id: "semrush", name: "Semrush", description: "jskit.connectors.semrush.description",
   accountModes: ["shared", "assistant"], authenticationMethods: ["api-key"], scopes: [],
   settingsSchema: createSchema({ v3ApiKeyRef: { ...secretReference, required: false } }),
-  settingsFields: [{ name: "v3ApiKeyRef", label: "V3 API key reference (optional)", placeholder: "env:SEMRUSH_V3_KEY",
-    environmentCredential: { label: "Semrush V3 API key", public: false },
-    hint: "For domain overview and domain/URL/subfolder keyword reports and position tracking: My profile > API Keys > copy your Version 3 key into this project's Env. Leave empty if only using V4 reports/projects." }],
-  apiKeyReferenceLabel: "V4 API key reference",
-  apiKeyReferenceHint: "Use a new Semrush V4 key: Read-only for reports and project reads, Read and write for creating, renaming or deleting projects. V3 keys and OAuth tokens are different credentials.",
+  settingsFields: [{ name: "v3ApiKeyRef", label: "jskit.connectors.semrush.fields.v3ApiKeyRef.label", placeholder: "env:SEMRUSH_V3_KEY",
+    environmentCredential: { label: "jskit.connectors.semrush.fields.v3ApiKeyRef.environmentCredential.label", public: false },
+    hint: "jskit.connectors.semrush.fields.v3ApiKeyRef.hint" }],
+  apiKeyReferenceLabel: "jskit.connectors.semrush.apiKeyReferenceLabel",
+  apiKeyReferenceHint: "jskit.connectors.semrush.apiKeyReferenceHint",
   setup: { url: "https://developer.semrush.com/api/v4/get-started/quick-start/", steps: [
     "Open the profile icon in Semrush, then My profile > API Keys > + Create API key.",
     "Create a V4 key for this application. Select Read-only for reports and project reads, or Read and write if the app creates, renames or deletes projects; choose an expiry. Projects access requires SEO Business and available API units.",

package/src/shared/shopify.js

@@ -1,42 +1,42 @@
 import { createSchema } from "json-rest-schema";
 
 const shopifyDefinition = Object.freeze({
-  id: "shopify", name: "Shopify", description: "Connect a Shopify store and control what the assistant may change.",
+  id: "shopify", name: "Shopify", description: "jskit.connectors.shopify.description",
   accountModes: ["shared", "assistant"], authenticationMethods: ["oauth2", "api-key"],
   oauthGrantTypes: ["client_credentials"], oauthClientAuthenticationMethods: ["client_secret_post"],
-  authenticationLabels: { oauth2: "App in your Shopify organization", "api-key": "Existing Admin API access token" },
-  authenticationHint: "Client credentials require the app and store in the same Shopify organization. Connecting another merchant requires a separate Shopify installation flow.",
-  apiKeyReferenceLabel: "Admin API access token reference",
-  apiKeyReferenceHint: "Use env:SHOPIFY_ADMIN_TOKEN. A Storefront token, client secret or App Automation Token cannot be used here.",
+  authenticationLabels: { oauth2: "jskit.connectors.shopify.authenticationLabels.oauth2", "api-key": "jskit.connectors.shopify.authenticationLabels.apiKey" },
+  authenticationHint: "jskit.connectors.shopify.authenticationHint",
+  apiKeyReferenceLabel: "jskit.connectors.shopify.apiKeyReferenceLabel",
+  apiKeyReferenceHint: "jskit.connectors.shopify.apiKeyReferenceHint",
   settingsSchema: createSchema({
     shopDomain: { type: "string", required: true, noTrim: true, maxLength: 77,
       validator: (value) => /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.myshopify\.com$/u.test(value) ||
         "Enter the store's permanent name.myshopify.com domain without a protocol, path or port." }
   }),
-  settingsFields: [{ name: "shopDomain", label: "Shopify store domain", placeholder: "your-store.myshopify.com",
-    hint: "Use the permanent myshopify.com address, including when your storefront uses a custom domain." }],
+  settingsFields: [{ name: "shopDomain", label: "jskit.connectors.shopify.fields.shopDomain.label", placeholder: "your-store.myshopify.com",
+    hint: "jskit.connectors.shopify.fields.shopDomain.hint" }],
   scopes: [
-    { value: "read_products", label: "Read products", recommended: true },
-    { value: "write_products", label: "Create, update and delete products" }
+    { value: "read_products", label: "jskit.connectors.shopify.scopes.readProducts.label", recommended: true },
+    { value: "write_products", label: "jskit.connectors.shopify.scopes.writeProducts.label" }
   ],
-  permissionsHint: "Match the scopes approved for the installed Shopify app. Write access includes reads. Assistant permission choices do not grant Shopify scopes or staff permissions.",
+  permissionsHint: "jskit.connectors.shopify.permissionsHint",
   assistantActions: [
-    { value: "enable", label: "Enable Shopify" },
-    { value: "connect", label: "Connect your Shopify store" },
-    { value: "claim", label: "Claim your store" },
-    { value: "products.list", label: "Read products" },
-    { value: "products.create", label: "Create product" },
-    { value: "products.update", label: "Update product" },
-    { value: "products.delete", label: "Delete product" },
-    { value: "variants.create", label: "Add product variant" },
-    { value: "variants.update", label: "Update product variant" },
-    { value: "variants.delete", label: "Delete product variant" },
-    { value: "discountCodes.create", label: "Create discount code" },
-    { value: "discountCodes.update", label: "Update discount code" },
-    { value: "discountCodes.delete", label: "Delete discount code" },
-    { value: "priceRules.create", label: "Create price rule" },
-    { value: "priceRules.update", label: "Update price rule" },
-    { value: "priceRules.delete", label: "Delete price rule" }
+    { value: "enable", label: "jskit.connectors.shopify.assistantActions.enable.label" },
+    { value: "connect", label: "jskit.connectors.shopify.assistantActions.connect.label" },
+    { value: "claim", label: "jskit.connectors.shopify.assistantActions.claim.label" },
+    { value: "products.list", label: "jskit.connectors.shopify.assistantActions.productsList.label" },
+    { value: "products.create", label: "jskit.connectors.shopify.assistantActions.productsCreate.label" },
+    { value: "products.update", label: "jskit.connectors.shopify.assistantActions.productsUpdate.label" },
+    { value: "products.delete", label: "jskit.connectors.shopify.assistantActions.productsDelete.label" },
+    { value: "variants.create", label: "jskit.connectors.shopify.assistantActions.variantsCreate.label" },
+    { value: "variants.update", label: "jskit.connectors.shopify.assistantActions.variantsUpdate.label" },
+    { value: "variants.delete", label: "jskit.connectors.shopify.assistantActions.variantsDelete.label" },
+    { value: "discountCodes.create", label: "jskit.connectors.shopify.assistantActions.discountCodesCreate.label" },
+    { value: "discountCodes.update", label: "jskit.connectors.shopify.assistantActions.discountCodesUpdate.label" },
+    { value: "discountCodes.delete", label: "jskit.connectors.shopify.assistantActions.discountCodesDelete.label" },
+    { value: "priceRules.create", label: "jskit.connectors.shopify.assistantActions.priceRulesCreate.label" },
+    { value: "priceRules.update", label: "jskit.connectors.shopify.assistantActions.priceRulesUpdate.label" },
+    { value: "priceRules.delete", label: "jskit.connectors.shopify.assistantActions.priceRulesDelete.label" }
   ],
   setup: { url: "https://shopify.dev/docs/apps/build/authentication-authorization/client-credentials-grant", steps: [
     "Open the Shopify Dev Dashboard, choose your organization, open Apps and create an app for your store.",

package/src/shared/slack.js

@@ -2,74 +2,74 @@ import { createSchema } from "json-rest-schema";
 import { secretReference } from "@jskit-ai/connectors-core/shared/configuration";
 
 const scopes = [
-  {"value": "channels:history", "label": "View messages and other content in public channels you are in", "actors": ["user", "bot"], "recommended": true},
-  {"value": "channels:read", "label": "View basic information about public channels in a workspace", "actors": ["user", "bot"], "recommended": true},
-  {"value": "bookmarks:read", "label": "List bookmarks", "actors": ["user", "bot"]},
-  {"value": "bookmarks:write", "label": "Create, edit, and remove bookmarks", "actors": ["user", "bot"]},
-  {"value": "calls:read", "label": "View information about ongoing and past calls", "actors": ["user", "bot"]},
-  {"value": "calls:write", "label": "Start and manage calls in a workspace", "actors": ["user", "bot"]},
-  {"value": "canvases:read", "label": "Access contents of canvases created inside Slack.", "actors": ["user", "bot"]},
-  {"value": "canvases:write", "label": "Create, edit and remove canvases", "actors": ["user", "bot"]},
-  {"value": "channels:write", "label": "Manage a user's public channels and create new ones on a user's behalf", "actors": ["user"]},
-  {"value": "channels:write.invites", "label": "Invite members to public channels", "actors": ["user", "bot"]},
-  {"value": "channels:write.topic", "label": "Set the description of public channels", "actors": ["user", "bot"]},
-  {"value": "chat:write", "label": "Send messages", "actors": ["user", "bot"]},
-  {"value": "dnd:read", "label": "View Do Not Disturb settings for people in a workspace", "actors": ["user", "bot"]},
-  {"value": "dnd:write", "label": "Edit a user's Do Not Disturb settings", "actors": ["user"]},
-  {"value": "emoji:read", "label": "View custom emoji in a workspace", "actors": ["user", "bot"]},
-  {"value": "files:read", "label": "View files shared in channels and conversations that your Slack app has been added to", "actors": ["user", "bot"]},
-  {"value": "files:write", "label": "Upload, edit, and delete files as your Slack app", "actors": ["user", "bot"]},
-  {"value": "groups:history", "label": "View messages and other content in private channels that your Slack app has been added to", "actors": ["user", "bot"]},
-  {"value": "groups:read", "label": "View basic information about private channels that your Slack app has been added to", "actors": ["user", "bot"]},
-  {"value": "groups:write", "label": "Manage private channels that your Slack app has been added to and create new ones", "actors": ["user", "bot"]},
-  {"value": "groups:write.invites", "label": "Invite members to private channels", "actors": ["user", "bot"]},
-  {"value": "groups:write.topic", "label": "Set the description of private channels", "actors": ["user", "bot"]},
-  {"value": "im:history", "label": "View messages and other content in direct messages you are in", "actors": ["user", "bot"]},
-  {"value": "im:read", "label": "View basic information about direct messages you are in", "actors": ["user", "bot"]},
-  {"value": "im:write", "label": "Start direct messages with people", "actors": ["user", "bot"]},
-  {"value": "im:write.topic", "label": "Set the description in direct messages", "actors": ["user", "bot"]},
-  {"value": "lists:read", "label": "View Slack Lists", "actors": ["user", "bot"]},
-  {"value": "lists:write", "label": "Create, edit, and delete Slack Lists", "actors": ["user", "bot"]},
-  {"value": "mpim:history", "label": "View messages and other content in group direct messages that your Slack app has been added to", "actors": ["user", "bot"]},
-  {"value": "mpim:read", "label": "View basic information about group direct messages that your Slack app has been added to", "actors": ["user", "bot"]},
-  {"value": "mpim:write", "label": "Start group direct messages with people", "actors": ["user", "bot"]},
-  {"value": "mpim:write.topic", "label": "Set the description in group direct messages", "actors": ["user", "bot"]},
-  {"value": "pins:read", "label": "View pinned content in channels and conversations that your Slack app has been added to", "actors": ["user", "bot"]},
-  {"value": "pins:write", "label": "Add and remove pinned messages and files", "actors": ["user", "bot"]},
-  {"value": "reactions:read", "label": "View emoji reactions", "actors": ["user", "bot"]},
-  {"value": "reactions:write", "label": "Add and edit emoji reactions", "actors": ["user", "bot"]},
-  {"value": "reminders:read", "label": "View reminders created by your Slack app", "actors": ["user"]},
-  {"value": "reminders:write", "label": "Add, remove, or mark reminders as complete", "actors": ["user"]},
-  {"value": "search:read.files", "label": "Search a workspace's content in files", "actors": ["user", "bot"]},
-  {"value": "search:read.im", "label": "Search a workspace's content in direct messages", "actors": ["user"]},
-  {"value": "search:read.mpim", "label": "Search a workspace's content in group direct messages", "actors": ["user"]},
-  {"value": "search:read.private", "label": "Search a workspace's content in private channels", "actors": ["user"]},
-  {"value": "search:read.public", "label": "Search a workspace's content in public channels", "actors": ["user", "bot"]},
-  {"value": "search:read.users", "label": "Search a workspace's users", "actors": ["user", "bot"]},
-  {"value": "team:read", "label": "View the name, email domain, and icon for workspaces your Slack app is connected to", "actors": ["user", "bot"]},
-  {"value": "usergroups:read", "label": "View user groups in a workspace", "actors": ["user", "bot"]},
-  {"value": "usergroups:write", "label": "Create and manage user groups", "actors": ["user", "bot"]},
-  {"value": "users:read", "label": "View people in a workspace", "actors": ["user", "bot"]},
-  {"value": "users:read.email", "label": "View email addresses of people in a workspace", "actors": ["user", "bot"]},
-  {"value": "users:write", "label": "Set presence for your Slack app", "actors": ["user", "bot"]},
-  {"value": "users.profile:read", "label": "View profile details about people in a workspace", "actors": ["user", "bot"]},
-  {"value": "users.profile:write", "label": "Edit a user's profile information and status", "actors": ["user"]},
-  {"value": "channels:join", "label": "Join public channels in a workspace", "actors": ["bot"]},
-  {"value": "channels:manage", "label": "Manage public channels that your Slack app has been added to and create new ones", "actors": ["bot"]},
-  {"value": "chat:write.customize", "label": "Customize the content of messages sent by your Slack app", "actors": ["bot"]},
-  {"value": "chat:write.public", "label": "Send messages to channels your Slack app isn't a member of", "actors": ["bot"]},
-  {"value": "metadata.message:read", "label": "Allows your Slack app to read message metadata in channels that your Slack app has been added to", "actors": ["bot"]}
+  {"value": "channels:history", "label": "jskit.connectors.slack.scopes.channelsHistory.label", "actors": ["user", "bot"], "recommended": true},
+  {"value": "channels:read", "label": "jskit.connectors.slack.scopes.channelsRead.label", "actors": ["user", "bot"], "recommended": true},
+  {"value": "bookmarks:read", "label": "jskit.connectors.slack.scopes.bookmarksRead.label", "actors": ["user", "bot"]},
+  {"value": "bookmarks:write", "label": "jskit.connectors.slack.scopes.bookmarksWrite.label", "actors": ["user", "bot"]},
+  {"value": "calls:read", "label": "jskit.connectors.slack.scopes.callsRead.label", "actors": ["user", "bot"]},
+  {"value": "calls:write", "label": "jskit.connectors.slack.scopes.callsWrite.label", "actors": ["user", "bot"]},
+  {"value": "canvases:read", "label": "jskit.connectors.slack.scopes.canvasesRead.label", "actors": ["user", "bot"]},
+  {"value": "canvases:write", "label": "jskit.connectors.slack.scopes.canvasesWrite.label", "actors": ["user", "bot"]},
+  {"value": "channels:write", "label": "jskit.connectors.slack.scopes.channelsWrite.label", "actors": ["user"]},
+  {"value": "channels:write.invites", "label": "jskit.connectors.slack.scopes.channelsWriteInvites.label", "actors": ["user", "bot"]},
+  {"value": "channels:write.topic", "label": "jskit.connectors.slack.scopes.channelsWriteTopic.label", "actors": ["user", "bot"]},
+  {"value": "chat:write", "label": "jskit.connectors.slack.scopes.chatWrite.label", "actors": ["user", "bot"]},
+  {"value": "dnd:read", "label": "jskit.connectors.slack.scopes.dndRead.label", "actors": ["user", "bot"]},
+  {"value": "dnd:write", "label": "jskit.connectors.slack.scopes.dndWrite.label", "actors": ["user"]},
+  {"value": "emoji:read", "label": "jskit.connectors.slack.scopes.emojiRead.label", "actors": ["user", "bot"]},
+  {"value": "files:read", "label": "jskit.connectors.slack.scopes.filesRead.label", "actors": ["user", "bot"]},
+  {"value": "files:write", "label": "jskit.connectors.slack.scopes.filesWrite.label", "actors": ["user", "bot"]},
+  {"value": "groups:history", "label": "jskit.connectors.slack.scopes.groupsHistory.label", "actors": ["user", "bot"]},
+  {"value": "groups:read", "label": "jskit.connectors.slack.scopes.groupsRead.label", "actors": ["user", "bot"]},
+  {"value": "groups:write", "label": "jskit.connectors.slack.scopes.groupsWrite.label", "actors": ["user", "bot"]},
+  {"value": "groups:write.invites", "label": "jskit.connectors.slack.scopes.groupsWriteInvites.label", "actors": ["user", "bot"]},
+  {"value": "groups:write.topic", "label": "jskit.connectors.slack.scopes.groupsWriteTopic.label", "actors": ["user", "bot"]},
+  {"value": "im:history", "label": "jskit.connectors.slack.scopes.imHistory.label", "actors": ["user", "bot"]},
+  {"value": "im:read", "label": "jskit.connectors.slack.scopes.imRead.label", "actors": ["user", "bot"]},
+  {"value": "im:write", "label": "jskit.connectors.slack.scopes.imWrite.label", "actors": ["user", "bot"]},
+  {"value": "im:write.topic", "label": "jskit.connectors.slack.scopes.imWriteTopic.label", "actors": ["user", "bot"]},
+  {"value": "lists:read", "label": "jskit.connectors.slack.scopes.listsRead.label", "actors": ["user", "bot"]},
+  {"value": "lists:write", "label": "jskit.connectors.slack.scopes.listsWrite.label", "actors": ["user", "bot"]},
+  {"value": "mpim:history", "label": "jskit.connectors.slack.scopes.mpimHistory.label", "actors": ["user", "bot"]},
+  {"value": "mpim:read", "label": "jskit.connectors.slack.scopes.mpimRead.label", "actors": ["user", "bot"]},
+  {"value": "mpim:write", "label": "jskit.connectors.slack.scopes.mpimWrite.label", "actors": ["user", "bot"]},
+  {"value": "mpim:write.topic", "label": "jskit.connectors.slack.scopes.mpimWriteTopic.label", "actors": ["user", "bot"]},
+  {"value": "pins:read", "label": "jskit.connectors.slack.scopes.pinsRead.label", "actors": ["user", "bot"]},
+  {"value": "pins:write", "label": "jskit.connectors.slack.scopes.pinsWrite.label", "actors": ["user", "bot"]},
+  {"value": "reactions:read", "label": "jskit.connectors.slack.scopes.reactionsRead.label", "actors": ["user", "bot"]},
+  {"value": "reactions:write", "label": "jskit.connectors.slack.scopes.reactionsWrite.label", "actors": ["user", "bot"]},
+  {"value": "reminders:read", "label": "jskit.connectors.slack.scopes.remindersRead.label", "actors": ["user"]},
+  {"value": "reminders:write", "label": "jskit.connectors.slack.scopes.remindersWrite.label", "actors": ["user"]},
+  {"value": "search:read.files", "label": "jskit.connectors.slack.scopes.searchReadFiles.label", "actors": ["user", "bot"]},
+  {"value": "search:read.im", "label": "jskit.connectors.slack.scopes.searchReadIm.label", "actors": ["user"]},
+  {"value": "search:read.mpim", "label": "jskit.connectors.slack.scopes.searchReadMpim.label", "actors": ["user"]},
+  {"value": "search:read.private", "label": "jskit.connectors.slack.scopes.searchReadPrivate.label", "actors": ["user"]},
+  {"value": "search:read.public", "label": "jskit.connectors.slack.scopes.searchReadPublic.label", "actors": ["user", "bot"]},
+  {"value": "search:read.users", "label": "jskit.connectors.slack.scopes.searchReadUsers.label", "actors": ["user", "bot"]},
+  {"value": "team:read", "label": "jskit.connectors.slack.scopes.teamRead.label", "actors": ["user", "bot"]},
+  {"value": "usergroups:read", "label": "jskit.connectors.slack.scopes.usergroupsRead.label", "actors": ["user", "bot"]},
+  {"value": "usergroups:write", "label": "jskit.connectors.slack.scopes.usergroupsWrite.label", "actors": ["user", "bot"]},
+  {"value": "users:read", "label": "jskit.connectors.slack.scopes.usersRead.label", "actors": ["user", "bot"]},
+  {"value": "users:read.email", "label": "jskit.connectors.slack.scopes.usersReadEmail.label", "actors": ["user", "bot"]},
+  {"value": "users:write", "label": "jskit.connectors.slack.scopes.usersWrite.label", "actors": ["user", "bot"]},
+  {"value": "users.profile:read", "label": "jskit.connectors.slack.scopes.usersProfileRead.label", "actors": ["user", "bot"]},
+  {"value": "users.profile:write", "label": "jskit.connectors.slack.scopes.usersProfileWrite.label", "actors": ["user"]},
+  {"value": "channels:join", "label": "jskit.connectors.slack.scopes.channelsJoin.label", "actors": ["bot"]},
+  {"value": "channels:manage", "label": "jskit.connectors.slack.scopes.channelsManage.label", "actors": ["bot"]},
+  {"value": "chat:write.customize", "label": "jskit.connectors.slack.scopes.chatWriteCustomize.label", "actors": ["bot"]},
+  {"value": "chat:write.public", "label": "jskit.connectors.slack.scopes.chatWritePublic.label", "actors": ["bot"]},
+  {"value": "metadata.message:read", "label": "jskit.connectors.slack.scopes.metadataMessageRead.label", "actors": ["bot"]}
 ];
 
 const slackDefinition = Object.freeze({
-  id: "slack", name: "Slack", description: "Connect as a Slack user or install a bot to read conversations and send messages.",
+  id: "slack", name: "Slack", description: "jskit.connectors.slack.description",
   accountModes: ["shared", "per-user", "assistant"], authenticationMethods: ["oauth2"],
   scopes,
   scopesForSettings: ({ actor = "user" } = {}) => scopes.filter((scope) => scope.actors.includes(actor)),
   settingsSchema: createSchema({ signingSecretRef: { ...secretReference, required: false }, actor: { type: "string", enum: ["user", "bot"], defaultTo: "user" } }),
-  settingsFields: [{ name: "signingSecretRef", label: "Signing secret reference (optional)", placeholder: "env:SLACK_SIGNING_SECRET", hint: "For incoming events and interactions: Basic Information → App Credentials → Signing Secret. Keep the value in application Env, separate from Client Secret." }, { name: "actor", label: "Act in Slack as", items: [
-    { value: "user", title: "Connected user" }, { value: "bot", title: "Installed bot" }
-  ], hint: "User access acts as the person who connects. Bot access acts as the app in its installed workspace. Changing this choice removes permissions unavailable to that identity and requires reconnecting." }],
+  settingsFields: [{ name: "signingSecretRef", label: "jskit.connectors.slack.fields.signingSecretRef.label", placeholder: "env:SLACK_SIGNING_SECRET", hint: "jskit.connectors.slack.fields.signingSecretRef.hint" }, { name: "actor", label: "jskit.connectors.slack.fields.actor.label", items: [
+    { value: "user", title: "jskit.connectors.slack.fields.actor.items.user.title" }, { value: "bot", title: "jskit.connectors.slack.fields.actor.items.bot.title" }
+  ], hint: "jskit.connectors.slack.fields.actor.hint" }],
   setup: {
     url: "https://docs.slack.dev/authentication/installing-with-oauth/",
     steps: [