@jskit-ai/connectors-catalog 0.1.67 → 0.2.0

package/src/server/gong.js

@@ -14,9 +14,9 @@ const recordsValid = value => ["totalRecords", "currentPageSize", "currentPageNu
 function callOperation(path, field, extensive = false) {
   const schema = createSchema({ ...callFields, ...(extensive ? { includeMedia: { type: "boolean", defaultTo: false } } : {}) });
   return { scopes: [], request(input, settings) {
-    if (Array.isArray(input.callIds) && input.callIds.some(id => typeof id !== "string") || input.workspaceId !== undefined && typeof input.workspaceId !== "string") throw new ConnectorError("connector_input_invalid", "Supply Gong IDs as strings to preserve all digits.", { statusCode: 422 });
+    if (Array.isArray(input.callIds) && input.callIds.some(id => typeof id !== "string") || input.workspaceId !== undefined && typeof input.workspaceId !== "string") throw new ConnectorError("connector_input_invalid", "Supply Gong IDs as strings to preserve all digits.", { statusCode: 422, messageCode: "connectors.gong.supplyIdsStringsPreserveAll" });
     const { cursor, includeMedia, ...filter } = validateSchemaPayload({ schema, mode: "replace" }, input, { statusCode: 422 });
-    if ((!filter.fromDateTime !== !filter.toDateTime) || (filter.fromDateTime && Date.parse(filter.fromDateTime) >= Date.parse(filter.toDateTime)) || (!filter.callIds && !filter.fromDateTime)) throw new ConnectorError("connector_input_invalid", "Supply call IDs or an ordered timestamp range.", { statusCode: 422 });
+    if ((!filter.fromDateTime !== !filter.toDateTime) || (filter.fromDateTime && Date.parse(filter.fromDateTime) >= Date.parse(filter.toDateTime)) || (!filter.callIds && !filter.fromDateTime)) throw new ConnectorError("connector_input_invalid", "Supply call IDs or an ordered timestamp range.", { statusCode: 422, messageCode: "connectors.gong.supplyCallIdsOrderedTimestamp" });
     const body = { filter, ...(cursor ? { cursor } : {}) };
     if (extensive) body.contentSelector = { context: "Extended", contextTiming: ["Now", "TimeOfCall"], exposedFields: {
       parties: true, content: { brief: true, outline: true, topics: true, keyPoints: true, callOutcome: true },
@@ -36,9 +36,9 @@ const gongProvider = Object.freeze({
     "calls.extensive": callOperation("/v2/calls/extensive", "calls", true),
     "calls.transcripts": callOperation("/v2/calls/transcript", "callTranscripts"),
     "stats.interaction": { scopes: [], request(input, settings) {
-      if (Array.isArray(input.userIds) && input.userIds.some(id => typeof id !== "string")) throw new ConnectorError("connector_input_invalid", "Supply Gong IDs as strings to preserve all digits.", { statusCode: 422 });
+      if (Array.isArray(input.userIds) && input.userIds.some(id => typeof id !== "string")) throw new ConnectorError("connector_input_invalid", "Supply Gong IDs as strings to preserve all digits.", { statusCode: 422, messageCode: "connectors.gong.supplyIdsStringsPreserveAll" });
       const { cursor, ...filter } = validateSchemaPayload({ schema: statsSchema, mode: "replace" }, input, { statusCode: 422 });
-      if (filter.fromDate >= filter.toDate) throw new ConnectorError("connector_input_invalid", "The end date must follow the start date.", { statusCode: 422 });
+      if (filter.fromDate >= filter.toDate) throw new ConnectorError("connector_input_invalid", "The end date must follow the start date.", { statusCode: 422, messageCode: "connectors.gong.endDateMustFollowStart" });
       return { method: "POST", url: `${origin(settings)}/v2/stats/interaction`, body: { filter, ...(cursor ? { cursor } : {}) } };
     }, validateResult: value => Array.isArray(value?.peopleInteractionStats) && recordsValid(value) },
     "users.list": jsonOperation((settings) => `${origin(settings)}/v2/users`, {

package/src/server/google-ads-search.js

@@ -9,7 +9,7 @@ const api = "https://googleads.googleapis.com/v25";
 const scope = "https://www.googleapis.com/auth/adwords";
 const customerId = { type: "string", required: true, validator: value => /^[0-9]{10}$/.test(value) || "Use a ten-digit customer ID." };
 const id = { type: "string", required: true, validator: value => /^[0-9]{1,20}$/.test(value) || "Use a numeric campaign ID." };
-const error = message => { throw new ConnectorError("connector_input_invalid", message, { statusCode: 422 }); };
+const error = (message, codes) => { throw new ConnectorError("connector_input_invalid", message, { statusCode: 422, ...codes }); };
 const hash = value => createHash("sha256").update(JSON.stringify(value)).digest("hex");
 function requestOperation(fields, build, validateResult) {
   return validatedOperation(fields, (values, settings) => (
@@ -50,7 +50,7 @@ const googleAdsSearchOperations = {
 // Application composition: this service has no editor protocol, command runner or storage.
 function createGoogleAdsSearchService({ connections, configuration, context, integrationId }) {
   const slot = configuration.integrations?.[integrationId];
-  if (slot?.provider !== "google-ads") error("Choose a Google Ads integration.");
+  if (slot?.provider !== "google-ads") error("Choose a Google Ads integration.", { messageCode: "connectors.googleAdsSearch.chooseIntegration" });
   const invoke = (operation, input) => connections.invoke({ context, integrationId, operation, input });
   const query = async (customer, query) => (await invoke("reports.search", { customerId: customer, query })).results || [];
   const customer = value => validateSchemaPayload({ schema: createSchema({ customerId }), mode: "replace" }, { customerId: value }, { statusCode: 422 }).customerId;
@@ -59,14 +59,14 @@ function createGoogleAdsSearchService({ connections, configuration, context, int
   const review = data => hash([context.applicationId, context.subjectId, integrationId, slot, plan(), data]);
   async function account(id) {
     const rows = await query(customer(id), "SELECT customer.id, customer.descriptive_name, customer.currency_code, customer.time_zone, customer.status, customer.manager FROM customer LIMIT 1");
-    if (rows.length !== 1) error("Google did not return the selected account.");
+    if (rows.length !== 1) error("Google did not return the selected account.", { messageCode: "connectors.googleAdsSearch.didNotReturnSelectedAccount" });
     return rows[0].customer;
   }
   async function preview() {
     const p = plan(), selected = await account(p.customerId);
-    if (selected.manager || selected.status !== "ENABLED" || selected.currencyCode !== p.currency) error("Choose an active client account and match its currency.");
+    if (selected.manager || selected.status !== "ENABLED" || selected.currencyCode !== p.currency) error("Choose an active client account and match its currency.", { messageCode: "connectors.googleAdsSearch.chooseActiveClientAccountMatch" });
     const goals = await query(p.customerId, `SELECT conversion_action.id, conversion_action.name, conversion_action.status, conversion_action.type FROM conversion_action WHERE conversion_action.id = ${p.conversionActionId} LIMIT 1`);
-    if (goals[0]?.conversionAction?.status !== "ENABLED" || goals[0]?.conversionAction?.type !== "WEBPAGE") error("Choose an enabled website conversion action.");
+    if (goals[0]?.conversionAction?.status !== "ENABLED" || goals[0]?.conversionAction?.type !== "WEBPAGE") error("Choose an enabled website conversion action.", { messageCode: "connectors.googleAdsSearch.chooseEnabledWebsiteConversionAction" });
     await invoke("search.validate", p);
     const data = { plan: p, account: selected, conversion: goals[0].conversionAction };
     return { ...data, reviewId: review(data) };
@@ -74,7 +74,7 @@ function createGoogleAdsSearchService({ connections, configuration, context, int
   async function campaign(id) {
     const p = plan(), selected = campaignId(id);
     const rows = await query(p.customerId, `SELECT campaign.id, campaign.name, campaign.status, campaign.advertising_channel_type, campaign.bidding_strategy_type, campaign.network_settings.target_google_search, campaign.network_settings.target_search_network, campaign.network_settings.target_content_network, campaign.network_settings.target_partner_search_network, campaign.geo_target_type_setting.positive_geo_target_type, campaign.geo_target_type_setting.negative_geo_target_type, campaign.contains_eu_political_advertising, campaign_budget.amount_micros, campaign_budget.id FROM campaign WHERE campaign.id = ${selected} LIMIT 1`);
-    if (rows.length !== 1 || rows[0].campaign?.advertisingChannelType !== "SEARCH") error("Select an accessible Search campaign.");
+    if (rows.length !== 1 || rows[0].campaign?.advertisingChannelType !== "SEARCH") error("Select an accessible Search campaign.", { messageCode: "connectors.googleAdsSearch.selectAccessibleSearchCampaign" });
     const details = {
       customerId: p.customerId, account: await account(p.customerId), ...rows[0],
       ads: await query(p.customerId, `SELECT ad_group_ad.ad.id, ad_group_ad.ad.final_urls, ad_group_ad.ad.responsive_search_ad.headlines, ad_group_ad.ad.responsive_search_ad.descriptions, ad_group_ad.status, ad_group_ad.policy_summary.approval_status, ad_group.id, ad_group.status, ad_group.cpc_bid_micros FROM ad_group_ad WHERE campaign.id = ${selected} LIMIT 21`),
@@ -84,10 +84,10 @@ function createGoogleAdsSearchService({ connections, configuration, context, int
     };
     const goalResource = details.goals[0]?.conversionGoalCampaignConfig?.customConversionGoal;
     if (goalResource) {
-      if (!new RegExp(`^customers/${p.customerId}/customConversionGoals/[0-9]+$`).test(goalResource)) error("Google returned an invalid campaign goal.");
+      if (!new RegExp(`^customers/${p.customerId}/customConversionGoals/[0-9]+$`).test(goalResource)) error("Google returned an invalid campaign goal.", { messageCode: "connectors.googleAdsSearch.returnedInvalidCampaignGoal" });
       details.customGoals = await query(p.customerId, `SELECT custom_conversion_goal.name, custom_conversion_goal.status, custom_conversion_goal.conversion_actions FROM custom_conversion_goal WHERE custom_conversion_goal.resource_name = '${goalResource}' LIMIT 1`);
     }
-    if (details.ads.length > 20 || details.targets.length > 30 || details.keywords.length > 30) error("This campaign exceeds the bounded Search review. Manage it in Google Ads.");
+    if (details.ads.length > 20 || details.targets.length > 30 || details.keywords.length > 30) error("This campaign exceeds the bounded Search review. Manage it in Google Ads.", { messageCode: "connectors.googleAdsSearch.campaignExceedsBoundedSearchReview" });
     return { ...details, reviewId: review(details) };
   }
   return {
@@ -101,14 +101,14 @@ function createGoogleAdsSearchService({ connections, configuration, context, int
     },
     async targets(id, name) {
       customer(id);
-      if (typeof name !== "string" || !/^[\p{L}\p{N} .-]{2,80}$/u.test(name)) error("Enter a location name using letters, numbers, spaces, dots or hyphens.");
+      if (typeof name !== "string" || !/^[\p{L}\p{N} .-]{2,80}$/u.test(name)) error("Enter a location name using letters, numbers, spaces, dots or hyphens.", { messageCode: "connectors.googleAdsSearch.enterLocationNameUsingLetters" });
       return { locations: await query(id, `SELECT geo_target_constant.id, geo_target_constant.canonical_name, geo_target_constant.status FROM geo_target_constant WHERE geo_target_constant.name LIKE '%${name}%' AND geo_target_constant.status = 'ENABLED' LIMIT 20`),
         languages: await query(id, "SELECT language_constant.id, language_constant.name FROM language_constant WHERE language_constant.targetable = TRUE LIMIT 100") };
     },
     preview,
     async create(reviewId) {
       const checked = await preview();
-      if (reviewId !== checked.reviewId) error("The Search plan changed. Review it again before creation.");
+      if (reviewId !== checked.reviewId) error("The Search plan changed. Review it again before creation.", { messageCode: "connectors.googleAdsSearch.searchPlanChangedReviewAgain" });
       const response = await invoke("search.createPaused", checked.plan);
       const resource = response.mutateOperationResponses.find(item => item.campaignResult)?.campaignResult.resourceName;
       return { campaignId: resource.split("/").at(-1), status: "PAUSED" };
@@ -117,13 +117,13 @@ function createGoogleAdsSearchService({ connections, configuration, context, int
     campaign,
     async launch({ campaignId, reviewId, trackingConfirmed, billingConfirmed }) {
       const current = await campaign(campaignId);
-      if (current.reviewId !== reviewId) error("The campaign changed. Inspect and approve it again.");
-      if (trackingConfirmed !== true || billingConfirmed !== true) error("Confirm installed conversion tracking and billing/advertiser readiness before launch.");
-      if (current.account.manager || current.account.status !== "ENABLED") error("Choose an active client account.");
+      if (current.reviewId !== reviewId) error("The campaign changed. Inspect and approve it again.", { messageCode: "connectors.googleAdsSearch.campaignChangedInspectApproveAgain" });
+      if (trackingConfirmed !== true || billingConfirmed !== true) error("Confirm installed conversion tracking and billing/advertiser readiness before launch.", { messageCode: "connectors.googleAdsSearch.confirmInstalledConversionTrackingBilling" });
+      if (current.account.manager || current.account.status !== "ENABLED") error("Choose an active client account.", { messageCode: "connectors.googleAdsSearch.chooseActiveClientAccount" });
       if (current.campaign.containsEuPoliticalAdvertising !== "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING" ||
-          !current.customGoals?.length || current.customGoals[0].customConversionGoal?.status !== "ENABLED") error("Review a non-political Search campaign with an enabled custom conversion goal.");
-      if (!current.ads.length || !current.keywords.length || current.campaign.biddingStrategyType !== "MANUAL_CPC") error("This screen launches only Search campaigns with manual CPC, ads and keywords. Manage other campaigns in Google Ads.");
-      if (current.campaign.status !== "PAUSED") error("Only a paused campaign can be launched here.");
+          !current.customGoals?.length || current.customGoals[0].customConversionGoal?.status !== "ENABLED") error("Review a non-political Search campaign with an enabled custom conversion goal.", { messageCode: "connectors.googleAdsSearch.reviewNonPoliticalSearchCampaign" });
+      if (!current.ads.length || !current.keywords.length || current.campaign.biddingStrategyType !== "MANUAL_CPC") error("This screen launches only Search campaigns with manual CPC, ads and keywords. Manage other campaigns in Google Ads.", { messageCode: "connectors.googleAdsSearch.screenLaunchesSearchCampaignsManual" });
+      if (current.campaign.status !== "PAUSED") error("Only a paused campaign can be launched here.", { messageCode: "connectors.googleAdsSearch.pausedCampaignCanLaunchedHere" });
       return invoke("campaigns.setStatus", { customerId: current.customerId, campaignId, status: "ENABLED" });
     },
     pause: id => invoke("campaigns.setStatus", { customerId: plan().customerId, campaignId: campaignId(id), status: "PAUSED" }),

package/src/server/google-ads.js

@@ -57,22 +57,22 @@ const googleAdsProvider = Object.freeze({
       const errors = details.flatMap((detail) => Array.isArray(detail?.errors) ? detail.errors : []);
       const codes = errors.flatMap((error) => record(error?.errorCode) ? Object.values(error.errorCode) : []);
       if (response.status === 429 || value?.error?.status === "RESOURCE_EXHAUSTED" || errors.some((error) => error?.errorCode?.quotaError)) {
-        throw new ConnectorError("connector_rate_limited", "Google Ads API capacity is exhausted. Check the Cloud project and account quotas.", { statusCode: 429 });
+        throw new ConnectorError("connector_rate_limited", "Google Ads API capacity is exhausted. Check the Cloud project and account quotas.", { statusCode: 429, messageCode: "connectors.googleAds.apiCapacityExhaustedCheckCloud" });
       }
       if (details.some((detail) => detail?.reason === "ACCESS_TOKEN_SCOPE_INSUFFICIENT")) {
-        throw new ConnectorError("connector_scope_missing", "Connect Google Ads again with its required permission.", { statusCode: 403 });
+        throw new ConnectorError("connector_scope_missing", "Connect Google Ads again with its required permission.", { statusCode: 403, messageCode: "connectors.googleAds.connectAgainRequiredPermission" });
       }
       if (codes.some((code) => ["CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION"].includes(code))) {
-        throw new ConnectorError("connector_api_access_invalid", "Check Google Ads API access approval for the Cloud project that owns this OAuth client.", { statusCode: 403 });
+        throw new ConnectorError("connector_api_access_invalid", "Check Google Ads API access approval for the Cloud project that owns this OAuth client.", { statusCode: 403, messageCode: "connectors.googleAds.checkApiAccessApprovalCloud" });
       }
       if (codes.some((code) => ["OAUTH_TOKEN_INVALID", "OAUTH_TOKEN_EXPIRED", "OAUTH_TOKEN_REVOKED"].includes(code))) {
-        throw new ConnectorError("connector_reconnect_required", "Connect this Google Ads account again.", { statusCode: 401 });
+        throw new ConnectorError("connector_reconnect_required", "Connect this Google Ads account again.", { statusCode: 401, messageCode: "connectors.shared.reconnectAccount", messageParams: { provider: "Google Ads" } });
       }
-      if (response.status === 400) throw new ConnectorError("connector_input_invalid", "Google Ads rejected the operation. Check campaign fields, policy requirements and account permissions.", { statusCode: 422 });
-      if (response.status === 404) throw new ConnectorError("connector_resource_not_found", "This Google Ads resource is unavailable.", { statusCode: 404 });
+      if (response.status === 400) throw new ConnectorError("connector_input_invalid", "Google Ads rejected the operation. Check campaign fields, policy requirements and account permissions.", { statusCode: 422, messageCode: "connectors.googleAds.rejectedOperationCheckCampaignFields" });
+      if (response.status === 404) throw new ConnectorError("connector_resource_not_found", "This Google Ads resource is unavailable.", { statusCode: 404, messageCode: "connectors.googleAds.resourceUnavailable" });
       throw Object.assign(new Error("Google Ads request failed."), { status: response.ok ? 502 : response.status });
     }
-    if (response.status !== 200 || !record(value)) throw new ConnectorError("connector_response_invalid", "Google Ads returned an unexpected response.", { statusCode: 502 });
+    if (response.status !== 200 || !record(value)) throw new ConnectorError("connector_response_invalid", "Google Ads returned an unexpected response.", { statusCode: 502, messageCode: "connectors.shared.unexpectedResponse", messageParams: { provider: "Google Ads" } });
     return value;
   }
 });

package/src/server/google-drive.js

@@ -20,7 +20,7 @@ const baseProvider = googleProvider(googleDriveDefinition, origin, "files.list",
   "files.export": googleRead(contentScopes, { fileId, mimeType: { type: "string", required: true, minLength: 1, maxLength: 200 } }, ({ fileId, mimeType }) => ({ url: url(fileId, { mimeType }, "/export") }), validBytes),
   "files.create": googleOperation(writeScopes, { name: { type: "string", required: true, minLength: 1, maxLength: 1024 }, parentId: { ...fileId, required: false }, folder: { type: "boolean", defaultTo: false } }, ({ name, parentId, folder }) => ({ method: "POST", url: url(undefined, { supportsAllDrives: true, fields }), body: { name, ...(parentId ? { parents: [parentId] } : {}), ...(folder ? { mimeType: "application/vnd.google-apps.folder" } : {}) } }), validFile),
   "files.update": googleOperation([...writeScopes, "drive.metadata"], { fileId, name: { type: "string", minLength: 1, maxLength: 1024 }, description: { type: "string", maxLength: 16384 }, trashed: { type: "boolean" } }, ({ fileId, ...body }) => {
-    if (!Object.keys(body).length) throw inputInvalid("Supply a name, description or trashed value.");
+    if (!Object.keys(body).length) throw inputInvalid("Supply a name, description or trashed value.", { messageCode: "connectors.googleDrive.metadataChangeRequired" });
     return { method: "PATCH", url: url(fileId, { supportsAllDrives: true, fields }), body };
   }, validFile),
   "files.upload": googleOperation(writeScopes, {
@@ -28,11 +28,13 @@ const baseProvider = googleProvider(googleDriveDefinition, origin, "files.list",
     parentId: { ...fileId, required: false }, contentType: { type: "string", required: true, minLength: 3, maxLength: 200 },
     bodyBase64: { type: "string", required: true, maxLength: 6666668, noTrim: true }
   }, ({ fileId, name, parentId, contentType, bodyBase64 }) => {
-    if (!/^[A-Za-z0-9!#$&^_.+-]+\/[A-Za-z0-9!#$&^_.+-]+$/.test(contentType)) throw inputInvalid("Use a MIME type without header parameters.");
+    if (!/^[A-Za-z0-9!#$&^_.+-]+\/[A-Za-z0-9!#$&^_.+-]+$/.test(contentType)) throw inputInvalid("Use a MIME type without header parameters.", { messageCode: "connectors.googleDrive.mimeTypeInvalid" });
     const data = Buffer.from(bodyBase64, "base64");
-    if (data.toString("base64") !== bodyBase64) throw inputInvalid("Use standard padded base64 file data.");
-    if (data.byteLength > 5_000_000) throw inputInvalid("Uploads above 5 MB require the framework's native resumable client.", 413);
-    if (fileId && parentId) throw inputInvalid("parentId applies to new files; moving files requires native addParents/removeParents wiring.");
+    if (data.toString("base64") !== bodyBase64) throw inputInvalid("Use standard padded base64 file data.", { messageCode: "connectors.googleDrive.base64Invalid" });
+    if (data.byteLength > 5_000_000) throw inputInvalid("Uploads above 5 MB require the framework's native resumable client.",
+      { statusCode: 413, messageCode: "connectors.googleDrive.uploadTooLarge" });
+    if (fileId && parentId) throw inputInvalid("parentId applies to new files; moving files requires native addParents/removeParents wiring.",
+      { messageCode: "connectors.googleDrive.parentIdNewFilesOnly" });
     const boundary = `drive_${randomUUID()}`;
     const metadata = { name, ...(parentId ? { parents: [parentId] } : {}) };
     const body = Buffer.concat([Buffer.from(`--${boundary}\r\nContent-Type: application/json; charset=UTF-8\r\n\r\n${JSON.stringify(metadata)}\r\n--${boundary}\r\nContent-Type: ${contentType}\r\n\r\n`), data, Buffer.from(`\r\n--${boundary}--\r\n`)]);
@@ -60,7 +62,7 @@ const googleDriveProvider = Object.freeze({ ...baseProvider,
     if (reader) try { while (true) {
       const { done, value } = await reader.read(); if (done) break;
       size += value.byteLength;
-      if (size > 8 * 1024 * 1024) { await reader.cancel(); throw new ConnectorError("connector_response_too_large", "Use the framework's native Drive client for downloads or exports above 8 MiB.", { statusCode: 413 }); }
+      if (size > 8 * 1024 * 1024) { await reader.cancel(); throw new ConnectorError("connector_response_too_large", "Use the framework's native Drive client for downloads or exports above 8 MiB.", { statusCode: 413, messageCode: "connectors.googleDrive.useFrameworkNativeDriveClient" }); }
       chunks.push(value);
     } } finally { reader.releaseLock(); }
     const body = Buffer.concat(chunks);

package/src/server/google-maps-platform.js

@@ -16,15 +16,15 @@ const reverseSchema = createSchema({
 function validateGeocoding(result) {
   switch (result?.status) {
     case "OVER_QUERY_LIMIT":
-      throw new ConnectorError("connector_rate_limited", "The Google Maps request quota was reached.", { statusCode: 429 });
+      throw new ConnectorError("connector_rate_limited", "The Google Maps request quota was reached.", { statusCode: 429, messageCode: "connectors.googleMapsPlatform.requestQuotaReached" });
     case "OVER_DAILY_LIMIT":
-      throw new ConnectorError("connector_configuration_invalid", "Check the Google Maps server key, billing and usage cap.");
+      throw new ConnectorError("connector_configuration_invalid", "Check the Google Maps server key, billing and usage cap.", { messageCode: "connectors.googleMapsPlatform.checkServerKeyBillingUsage" });
     case "REQUEST_DENIED":
-      throw new ConnectorError("connector_permission_denied", "Google Maps denied access. Check the enabled API and key restrictions.", { statusCode: 403 });
+      throw new ConnectorError("connector_permission_denied", "Google Maps denied access. Check the enabled API and key restrictions.", { statusCode: 403, messageCode: "connectors.googleMapsPlatform.deniedAccessCheckEnabledApi" });
     case "INVALID_REQUEST":
-      throw new ConnectorError("connector_input_invalid", "Google Maps could not accept this geocoding request.", { statusCode: 422 });
+      throw new ConnectorError("connector_input_invalid", "Google Maps could not accept this geocoding request.", { statusCode: 422, messageCode: "connectors.googleMapsPlatform.couldNotAcceptGeocodingRequest" });
     case "UNKNOWN_ERROR":
-      throw new ConnectorError("connector_provider_failed", "Google Maps could not process the request. Try again.", { statusCode: 502 });
+      throw new ConnectorError("connector_provider_failed", "Google Maps could not process the request. Try again.", { statusCode: 502, messageCode: "connectors.googleMapsPlatform.couldNotProcessRequestTry" });
     case "ZERO_RESULTS":
       return Array.isArray(result.results) && result.results.length === 0;
     case "OK":

package/src/server/google-search-console.js

@@ -17,7 +17,7 @@ const googleSearchConsoleProvider = googleProvider(googleSearchConsoleDefinition
     type: { type: "string", enum: ["web", "image", "video", "news", "discover", "googleNews"], defaultTo: "web" },
     rowLimit: { type: "integer", min: 1, max: 25000, defaultTo: 1000 }, startRow: { type: "integer", min: 0, defaultTo: 0 }
   }, ({ siteUrl, filters, ...body }) => {
-    if (body.startDate > body.endDate) throw inputInvalid("startDate must not follow endDate.");
+    if (body.startDate > body.endDate) throw inputInvalid("startDate must not follow endDate.", { messageCode: "connectors.googleSearchConsole.datesOrder" });
     return { method: "POST", url: `${propertyPath(siteUrl)}/searchAnalytics/query`, body: { ...body, dataState: "final", ...(filters?.length ? { dimensionFilterGroups: [{ groupType: "and", filters }] } : {}) } };
   }, value => plain(value) && (value.rows === undefined || Array.isArray(value.rows))),
   "urlInspection.inspect": googleOperation(readScopes, { siteUrl, inspectionUrl: { ...feedpath }, languageCode: { type: "string", minLength: 2, maxLength: 35 } }, body => ({ method: "POST", url: `${origin}/v1/urlInspection/index:inspect`, body }), value => plain(value?.inspectionResult)),

package/src/server/google-sheets.js

@@ -13,7 +13,8 @@ const sheetUrl = id => `${origin}/v4/spreadsheets/${encodeURIComponent(id)}`;
 const get = googleRead(scopes, { spreadsheetId: documentId }, ({ spreadsheetId }) => ({ url: sheetUrl(spreadsheetId), query: { includeGridData: false } }), validSheet);
 function checkValues(rows) {
   if (!rows.length || rows.length > 10000 || rows.some(row => !Array.isArray(row) || row.some(cell => cell !== null && typeof cell !== "string" && typeof cell !== "boolean" && !(typeof cell === "number" && Number.isFinite(cell)))) || rows.reduce((count, row) => count + row.length, 0) > 10000 || Buffer.byteLength(JSON.stringify(rows)) > 1048576) {
-    throw inputInvalid("Supply a matrix of at most 10,000 cells and 1 MiB, containing strings, finite numbers, booleans or null.");
+    throw inputInvalid("Supply a matrix of at most 10,000 cells and 1 MiB, containing strings, finite numbers, booleans or null.",
+      { messageCode: "connectors.googleSheets.valuesMatrixInvalid" });
   }
   return rows;
 }
@@ -38,7 +39,7 @@ const base = googleProvider(googleSheetsDefinition, origin, "connection.verify",
   "values.clear": googleOperation(writable, { spreadsheetId: documentId, range }, ({ spreadsheetId, range }) => ({ method: "POST", url: `${sheetUrl(spreadsheetId)}/values/${encodeURIComponent(range)}:clear`, body: {} }), value => typeof value?.spreadsheetId === "string" && typeof value.clearedRange === "string"),
   "values.batchUpdate": googleOperation(writable, { spreadsheetId: documentId, data: { type: "array", required: true }, valueInputOption: inputOption }, ({ spreadsheetId, data, valueInputOption }) => {
     const schema = createSchema({ range, values });
-    if (!data.length || data.length > 100 || Buffer.byteLength(JSON.stringify(data)) > 1048576) throw inputInvalid("Supply 1–100 ranges within 1 MiB.");
+    if (!data.length || data.length > 100 || Buffer.byteLength(JSON.stringify(data)) > 1048576) throw inputInvalid("Supply 1–100 ranges within 1 MiB.", { messageCode: "connectors.googleSheets.rangesInvalid" });
     const ranges = data.map(value => {
       const parsed = validateSchemaPayload({ schema, mode: "replace" }, value, { statusCode: 422 });
       return { ...parsed, majorDimension: "ROWS", values: checkValues(parsed.values) };

package/src/server/google.js

@@ -13,14 +13,15 @@ const documentId = { type: "string", required: true, minLength: 1, maxLength: 10
 const pageToken = { type: "string", minLength: 1, maxLength: 4096 };
 
 // Request builders report rejected input as the caller's mistake, not a provider outage.
-const inputInvalid = (message, statusCode = 422) => new ConnectorError("connector_input_invalid", message, { statusCode });
+const inputInvalid = (message, { statusCode = 422, ...codes } = {}) => new ConnectorError("connector_input_invalid", message, { statusCode, ...codes });
 const nativeRequest = request => request && typeof request === "object" && !Array.isArray(request) && Object.keys(request).length === 1 &&
   /^[a-zA-Z][a-zA-Z0-9]+$/.test(Object.keys(request)[0]) && Boolean(Object.values(request)[0]) &&
   typeof Object.values(request)[0] === "object" && !Array.isArray(Object.values(request)[0]);
 // Docs, Slides and Sheets batchUpdate share one limit: 1-100 single-operation request objects within 1 MiB.
 function googleBatchRequests(requests, product) {
   if (!requests.length || requests.length > 100 || Buffer.byteLength(JSON.stringify(requests)) > 1048576 || !requests.every(nativeRequest)) {
-    throw inputInvalid(`Supply 1–100 native ${product} request objects, one operation per object, within 1 MiB.`);
+    throw inputInvalid(`Supply 1–100 native ${product} request objects, one operation per object, within 1 MiB.`,
+      { messageCode: "connectors.google.batchRequestsInvalid", messageParams: { product } });
   }
   return requests;
 }

package/src/server/granola.js

@@ -42,7 +42,7 @@ const granolaApiProvider = Object.freeze({
   ...granolaDefinition, apiOrigins: [apiOrigin], checkOperation: "notes.list",
   apiKey: { headers: (key) => {
     if (!key.startsWith("grn_") || key.length <= 4 || /[\s\p{Cc}]/u.test(key)) {
-      throw new ConnectorError("connector_binding_missing", "Use the Granola grn_ API key without whitespace or control characters.");
+      throw new ConnectorError("connector_binding_missing", "Use the Granola grn_ API key without whitespace or control characters.", { messageCode: "connectors.granola.useGrnApiKeyWithout" });
     }
     return { Authorization: `Bearer ${key}` };
   } },
@@ -66,18 +66,18 @@ const granolaApiProvider = Object.freeze({
   },
   async exchange(address, options, { fetchImpl }) {
     const response = await fetchImpl(address, { ...options, credentials: "omit" });
-    if (response.status === 404) throw new ConnectorError("connector_resource_not_found", "The Granola note is unavailable, inaccessible or still being processed.", { statusCode: 404 });
-    if (response.status === 413) throw new ConnectorError("connector_response_too_large", "Read the transcript in pages with transcripts.list.", { statusCode: 413 });
+    if (response.status === 404) throw new ConnectorError("connector_resource_not_found", "The Granola note is unavailable, inaccessible or still being processed.", { statusCode: 404, messageCode: "connectors.granola.noteUnavailable" });
+    if (response.status === 413) throw new ConnectorError("connector_response_too_large", "Read the transcript in pages with transcripts.list.", { statusCode: 413, messageCode: "connectors.granola.readTranscriptPagesTranscriptsList" });
     if (!response.ok) throw Object.assign(new Error("Granola request failed."), { status: response.status });
     let value;
     try { value = await response.json(); } catch { /* checked below */ }
     if (response.status !== 200 || !value || typeof value !== "object" || value.error) {
-      throw new ConnectorError("connector_response_invalid", "Granola returned an unexpected response.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "Granola returned an unexpected response.", { statusCode: 502, messageCode: "connectors.shared.unexpectedResponse", messageParams: { provider: "Granola" } });
     }
     const url = new URL(address);
     const list = url.pathname === "/v1/notes" ? "notes" : url.pathname === "/v1/folders" ? "folders" : url.pathname.endsWith("/transcript") ? "transcript" : null;
     if (list ? value[list]?.length > Number(url.searchParams.get("page_size")) : value.id !== url.pathname.split("/").at(-1)) {
-      throw new ConnectorError("connector_response_invalid", "Granola returned data that does not match this request.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "Granola returned data that does not match this request.", { statusCode: 502, messageCode: "connectors.granola.returnedDataDoesNotMatch" });
     }
     return value;
   }

package/src/server/hubspot.js

@@ -39,7 +39,9 @@ function objectOperations(object) {
       const body = validateSchemaPayload({ schema: create, mode: "replace" }, input, { statusCode: 422 });
       if (object === "contacts" ? !["email", "firstname", "lastname"].some(key => body.properties[key]?.trim()) :
         !body.properties.dealname?.trim() || !body.properties.dealstage?.trim()) {
-        throw new ConnectorError("connector_input_invalid", object === "contacts" ? "Supply email, firstname or lastname." : "Supply dealname and the internal dealstage ID.", { statusCode: 422 });
+        throw object === "contacts"
+          ? new ConnectorError("connector_input_invalid", "Supply email, firstname or lastname.", { statusCode: 422, messageCode: "connectors.hubspot.contactIdentityRequired" })
+          : new ConnectorError("connector_input_invalid", "Supply dealname and the internal dealstage ID.", { statusCode: 422, messageCode: "connectors.hubspot.dealNameStageRequired" });
       }
       return { method: "POST", url: `${base}/${object}`, body };
     }, validateResult: validRecord },
@@ -65,10 +67,10 @@ const hubspotProvider = Object.freeze({
     if (!response.ok) return response;
     let value;
     try { value = await response.clone().json(); } catch {
-      throw new ConnectorError("connector_response_invalid", "HubSpot returned an invalid token response.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "HubSpot returned an invalid token response.", { statusCode: 502, messageCode: "connectors.shared.invalidTokenResponse", messageParams: { provider: "HubSpot" } });
     }
     if (!Array.isArray(value?.scopes) || !value.scopes.every((scope) => typeof scope === "string" && /^[^\s]+$/u.test(scope))) {
-      throw new ConnectorError("connector_response_invalid", "HubSpot returned an invalid permission grant.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "HubSpot returned an invalid permission grant.", { statusCode: 502, messageCode: "connectors.shared.invalidPermissionGrant", messageParams: { provider: "HubSpot" } });
     }
     return Response.json({ ...value, scope: value.scopes.join(" ") }, { status: response.status });
   },

package/src/server/inngest.js

@@ -44,7 +44,7 @@ const inngestProvider = Object.freeze({
       key = await resolveReference(eventKeyRef);
       if (typeof key !== "string" || !key.trim() || /[\p{Cc}]/u.test(key)) throw new Error("Invalid Event Key.");
     } catch {
-      throw new ConnectorError("connector_binding_missing", "The Inngest Event Key binding is missing or invalid.");
+      throw new ConnectorError("connector_binding_missing", "The Inngest Event Key binding is missing or invalid.", { messageCode: "connectors.inngest.eventKeyBindingMissingInvalid" });
     }
     options.signal.throwIfAborted();
     // The Event API uses only the Event Key in its path. Never forward the Signing Key.
@@ -73,9 +73,9 @@ const inngestProvider = Object.freeze({
           body: { event, eventKeyRef: settings.eventKeyRef, branchEnvironment: settings.branchEnvironment } };
       },
       validateResult(result) {
-        if (result?.status === 401) throw new ConnectorError("connector_reconnect_required", "Configure a valid Inngest Event Key and reconnect.", { statusCode: 401 });
-        if (result?.status === 403) throw new ConnectorError("connector_permission_denied", "Inngest denied this event.", { statusCode: 403 });
-        if (result?.status === 429) throw new ConnectorError("connector_rate_limited", "Inngest's event limit was reached.", { statusCode: 429 });
+        if (result?.status === 401) throw new ConnectorError("connector_reconnect_required", "Configure a valid Inngest Event Key and reconnect.", { statusCode: 401, messageCode: "connectors.inngest.configureValidEventKeyReconnect" });
+        if (result?.status === 403) throw new ConnectorError("connector_permission_denied", "Inngest denied this event.", { statusCode: 403, messageCode: "connectors.inngest.deniedEvent" });
+        if (result?.status === 429) throw new ConnectorError("connector_rate_limited", "Inngest's event limit was reached.", { statusCode: 429, messageCode: "connectors.inngest.eventLimitReached" });
         return result?.status === 200 && !result.error && Array.isArray(result.ids) && result.ids.length === 1 &&
           result.ids.every((id) => typeof id === "string" && id.length > 0);
       }

package/src/server/klipy.js

@@ -12,7 +12,7 @@ const mediaFields = {
 
 function mediaResult(response) {
   if (response?.result === false) {
-    throw new ConnectorError("connector_provider_failed", "KLIPY rejected the operation.", { statusCode: 502 });
+    throw new ConnectorError("connector_provider_failed", "KLIPY rejected the operation.", { statusCode: 502, messageCode: "connectors.klipy.rejectedOperation" });
   }
   return response?.result === true && Array.isArray(response.data?.data);
 }

package/src/server/lightspeed.js

@@ -26,7 +26,7 @@ function collection(resource) {
       const request = operation.request(input, settings);
       const query = new URL(request.url).searchParams;
       if (query.has("after") && query.has("before") && Number(query.get("after")) >= Number(query.get("before"))) {
-        throw new ConnectorError("connector_input_invalid", "The lower version must be below the upper version.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "The lower version must be below the upper version.", { statusCode: 422, messageCode: "connectors.lightspeed.lowerVersionMustBelowUpper" });
       }
       return request;
     }
@@ -55,7 +55,7 @@ const lightspeedProvider = Object.freeze({
       if (value?.domain_prefix !== settings.domainPrefix || typeof value.refresh_token !== "string" || !value.refresh_token.trim() ||
         !Number.isSafeInteger(value.expires_in) || value.expires_in <= 0 ||
         typeof value.scope !== "string" || !/^[^\s]+(?: [^\s]+)*$/u.test(value.scope)) {
-        throw new ConnectorError("connector_response_invalid", "Lightspeed returned an invalid token grant or a different store.", { statusCode: 502 });
+        throw new ConnectorError("connector_response_invalid", "Lightspeed returned an invalid token grant or a different store.", { statusCode: 502, messageCode: "connectors.lightspeed.returnedInvalidTokenGrantDifferent" });
       }
     }
     return response;
@@ -65,7 +65,7 @@ const lightspeedProvider = Object.freeze({
       const request = inventoryRead.request(input, settings);
       const { after, before, variants, product_id } = request.body;
       if (after !== undefined && before !== undefined && after >= before || variants && !product_id)
-        throw new ConnectorError("connector_input_invalid", "Use ordered inventory version bounds and a product ID when requesting variants.", { statusCode: 422 });
+        throw new ConnectorError("connector_input_invalid", "Use ordered inventory version bounds and a product ID when requesting variants.", { statusCode: 422, messageCode: "connectors.lightspeed.useOrderedInventoryVersionBounds" });
       return request;
     } }
   },
@@ -74,7 +74,7 @@ const lightspeedProvider = Object.freeze({
     const inventory = new URL(address).pathname.endsWith("/inventory");
     const limit = inventory ? options.body.size : Number(new URL(address).searchParams.get("page_size"));
     if ((inventory ? result?.length : result?.data?.length) > limit) {
-      throw new ConnectorError("connector_response_invalid", "Lightspeed returned more records than requested.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "Lightspeed returned more records than requested.", { statusCode: 502, messageCode: "connectors.shared.tooManyRecords", messageParams: { provider: "Lightspeed" } });
     }
     return result;
   }

package/src/server/linear.js

@@ -20,12 +20,12 @@ const linearProvider = Object.freeze({
     if (!response.ok) return response;
     let value;
     try { value = await response.clone().json(); } catch {
-      throw new ConnectorError("connector_response_invalid", "Linear returned an invalid token response.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "Linear returned an invalid token response.", { statusCode: 502, messageCode: "connectors.shared.invalidTokenResponse", messageParams: { provider: "Linear" } });
     }
     // Linear accepts commas at authorization but returns space-separated grants.
     const scopes = typeof value?.scope === "string" ? value.scope.split(" ").filter(Boolean) : value?.scope;
     if (!Array.isArray(scopes) || !scopes.every(scope => typeof scope === "string" && /^[^\s,]+$/u.test(scope))) {
-      throw new ConnectorError("connector_response_invalid", "Linear returned an invalid permission grant.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "Linear returned an invalid permission grant.", { statusCode: 502, messageCode: "connectors.shared.invalidPermissionGrant", messageParams: { provider: "Linear" } });
     }
     return Response.json({ ...value, scope: scopes.join(",") }, { status: response.status });
   },

package/src/server/linkedin.js

@@ -6,21 +6,21 @@ async function normalizeTokenResponse(response, { grantType }) {
   let value;
   try { value = await response.clone().json(); } catch {
     if (!response.ok) return response;
-    throw new ConnectorError("connector_response_invalid", "LinkedIn returned an invalid token response.", { statusCode: 502 });
+    throw new ConnectorError("connector_response_invalid", "LinkedIn returned an invalid token response.", { statusCode: 502, messageCode: "connectors.shared.invalidTokenResponse", messageParams: { provider: "LinkedIn" } });
   }
   if (!response.ok) {
     if (grantType === "refresh_token" && response.status === 400 && value?.error === "invalid_request") {
-      throw new ConnectorError("connector_reconnect_required", "Connect this LinkedIn account again.", { statusCode: 401 });
+      throw new ConnectorError("connector_reconnect_required", "Connect this LinkedIn account again.", { statusCode: 401, messageCode: "connectors.shared.reconnectAccount", messageParams: { provider: "LinkedIn" } });
     }
     return response;
   }
   if (!value || typeof value !== "object" || Array.isArray(value) ||
     !Number.isSafeInteger(value.expires_in) || value.expires_in <= 0 ||
     (value.scope !== undefined && (typeof value.scope !== "string" || !/^[^\s]+(?: [^\s]+)*$/u.test(value.scope)))) {
-    throw new ConnectorError("connector_response_invalid", "LinkedIn returned an invalid permission grant.", { statusCode: 502 });
+    throw new ConnectorError("connector_response_invalid", "LinkedIn returned an invalid permission grant.", { statusCode: 502, messageCode: "connectors.shared.invalidPermissionGrant", messageParams: { provider: "LinkedIn" } });
   }
   if (value.scope !== undefined && !["openid", "profile"].every((scope) => value.scope.split(" ").includes(scope))) {
-    throw new ConnectorError("connector_reconnect_required", "Connect LinkedIn with OpenID and profile permissions.", { statusCode: 401 });
+    throw new ConnectorError("connector_reconnect_required", "Connect LinkedIn with OpenID and profile permissions.", { statusCode: 401, messageCode: "connectors.linkedin.connectOpenidProfilePermissions" });
   }
   // LinkedIn documents bearer responses without token_type. Identity tokens are
   // unused: this adapter reads userinfo with the access token, never logs users in.
@@ -47,7 +47,7 @@ const linkedinProvider = Object.freeze({
     if (address !== "https://api.linkedin.com/v2/ugcPosts") return request(address, options);
     const member = await request("https://api.linkedin.com/v2/userinfo", { ...options, method: "GET", body: undefined });
     if (typeof member?.sub !== "string" || !/^[a-zA-Z0-9_-]{1,1024}$/u.test(member.sub))
-      throw new ConnectorError("connector_response_invalid", "LinkedIn returned an invalid member identity.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "LinkedIn returned an invalid member identity.", { statusCode: 502, messageCode: "connectors.linkedin.returnedInvalidMemberIdentity" });
     const response = await fetchImpl(address, { ...options, credentials: "omit", redirect: "error",
       headers: { ...options.headers, "Content-Type": "application/json", "X-Restli-Protocol-Version": "2.0.0" },
       body: JSON.stringify({ author: `urn:li:person:${member.sub}`, lifecycleState: "PUBLISHED",
@@ -55,7 +55,7 @@ const linkedinProvider = Object.freeze({
         visibility: { "com.linkedin.ugc.MemberNetworkVisibility": options.body.visibility } }) });
     await response.body?.cancel();
     if (!response.ok) throw Object.assign(new Error("LinkedIn publishing failed."), { status: response.status });
-    if (response.status !== 201) throw new ConnectorError("connector_response_invalid", "LinkedIn did not confirm post creation.", { statusCode: 502 });
+    if (response.status !== 201) throw new ConnectorError("connector_response_invalid", "LinkedIn did not confirm post creation.", { statusCode: 502, messageCode: "connectors.linkedin.didNotConfirmPostCreation" });
     return { id: response.headers.get("x-restli-id") };
   },
   operations: {

package/src/server/mapbox.js

@@ -25,7 +25,7 @@ const mapboxProvider = Object.freeze({
       Number.isFinite(route.distance) && route.distance >= 0 && Number.isFinite(route.duration) && route.duration >= 0 && route.geometry?.type === "LineString" && Array.isArray(route.geometry.coordinates)) },
     "token.read": jsonOperation("https://api.mapbox.com/tokens/v2", {}, (result) => {
       if (["TokenMalformed", "TokenInvalid", "TokenExpired", "TokenRevoked"].includes(result?.code)) {
-        throw new ConnectorError("connector_reconnect_required", "Configure a valid Mapbox token and connect again.", { statusCode: 401 });
+        throw new ConnectorError("connector_reconnect_required", "Configure a valid Mapbox token and connect again.", { statusCode: 401, messageCode: "connectors.mapbox.configureValidTokenConnectAgain" });
       }
       return result?.code === "TokenValid" && ["pk", "sk", "tk"].includes(result.token?.usage) && typeof result.token.user === "string";
     }),

package/src/server/mcpRegistration.js

@@ -33,8 +33,9 @@ async function registerMcpClient(providerName, metadata, { clientName, callbackU
     return { clientId: client.client_id, clientSecret: client.client_secret,
       ...(client.client_secret_expires_at === undefined ? {} : { clientSecretExpiresAt: client.client_secret_expires_at }) };
   } catch {
-    if (requestSignal.aborted) throw new ConnectorError("connector_registration_interrupted", "Registration was interrupted. Check the provider before creating another client.");
-    throw new ConnectorError("connector_registration_failed", `${providerName} client registration failed. Check the provider before creating another client.`, { statusCode: 502 });
+    if (requestSignal.aborted) throw new ConnectorError("connector_registration_interrupted", "Registration was interrupted. Check the provider before creating another client.", { messageCode: "connectors.mcp.registrationInterrupted" });
+    throw new ConnectorError("connector_registration_failed", `${providerName} client registration failed. Check the provider before creating another client.`,
+      { statusCode: 502, messageCode: "connectors.mcp.registrationFailed", messageParams: { provider: providerName } });
   }
 }
 

package/src/server/mcpTransport.js

@@ -28,7 +28,7 @@ async function exchangeMcp(endpoint, { headers, signal, body }, { fetchImpl }) {
     reconnectionOptions: { initialReconnectionDelay: 1000, maxReconnectionDelay: 1000, reconnectionDelayGrowFactor: 1, maxRetries: 0 },
     fetch: async (address, init = {}) => {
       if (new URL(String(address)).href !== endpoint) {
-        throw new ConnectorError("connector_destination_invalid", "The MCP transport requested an unexpected destination.");
+        throw new ConnectorError("connector_destination_invalid", "The MCP transport requested an unexpected destination.", { messageCode: "connectors.mcp.transportRequestedUnexpectedDestination" });
       }
       const requestHeaders = new Headers(init.headers);
       // Keep MCP's Accept/protocol/session headers, and bind credentials to this endpoint only.

package/src/server/microsoft-fabric.js

@@ -31,7 +31,7 @@ const microsoftFabricProvider = Object.freeze({
       let error;
       try { error = (await response.clone().json())?.error; } catch { /* OAuth handles the response */ }
       if (["interaction_required", "login_required", "consent_required"].includes(error)) {
-        throw new ConnectorError("connector_reconnect_required", "Microsoft requires a new sign-in or consent.", { statusCode: 401 });
+        throw new ConnectorError("connector_reconnect_required", "Microsoft requires a new sign-in or consent.", { statusCode: 401, messageCode: "connectors.microsoftFabric.requiresNewSignConsent" });
       }
       return response;
     }
@@ -39,7 +39,7 @@ const microsoftFabricProvider = Object.freeze({
     try { value = await response.clone().json(); } catch { /* rejected below */ }
     if (!Number.isSafeInteger(value?.expires_in) || value.expires_in <= 30 ||
       (value.scope !== undefined && (typeof value.scope !== "string" || !/^[^\s]+(?: [^\s]+)*$/u.test(value.scope)))) {
-      throw new ConnectorError("connector_response_invalid", "Microsoft returned an invalid token grant.", { statusCode: 502 });
+      throw new ConnectorError("connector_response_invalid", "Microsoft returned an invalid token grant.", { statusCode: 502, messageCode: "connectors.shared.invalidTokenGrant", messageParams: { provider: "Microsoft" } });
     }
     // Entra may return the permission name without the resource URI requested in consent.
     if (value.scope?.split(" ").includes("GraphQLApi.Execute.All")) {
@@ -72,7 +72,7 @@ const microsoftFabricProvider = Object.freeze({
     const result = await request(address, options);
     if (Array.isArray(result?.errors) && result.errors.length > 0) {
       // A mutation can have taken effect before partial errors arrive. Do not replay or expose provider text.
-      throw new ConnectorError("connector_provider_failed", "Fabric could not complete the GraphQL document. Check its schema and permissions before retrying.", { statusCode: 502 });
+      throw new ConnectorError("connector_provider_failed", "Fabric could not complete the GraphQL document. Check its schema and permissions before retrying.", { statusCode: 502, messageCode: "connectors.microsoftFabric.couldNotCompleteGraphqlDocument" });
     }
     return result;
   }

package/src/server/microsoft-onedrive.js

@@ -37,7 +37,7 @@ const base = microsoftProvider(microsoftOneDriveDefinition, "common", "items.lis
     const { parentId, name, bodyBase64, conflictBehavior } = validateSchemaPayload({ schema: uploadSchema, mode: "replace" }, input, { statusCode: 422 });
     const body = Buffer.from(bodyBase64, "base64");
     if (body.toString("base64") !== bodyBase64 || body.length > 5_000_000) {
-      throw new ConnectorError("connector_input_invalid", "Use standard padded base64 up to 5 MB; larger files need a native upload session.", { statusCode: 422 });
+      throw new ConnectorError("connector_input_invalid", "Use standard padded base64 up to 5 MB; larger files need a native upload session.", { statusCode: 422, messageCode: "connectors.microsoftOnedrive.useStandardPaddedBase64Up" });
     }
     const url = new URL(`https://graph.microsoft.com/v1.0/me/drive/items/${encodeURIComponent(parentId)}:/${encodeURIComponent(name)}:/content`);
     url.searchParams.set("@microsoft.graph.conflictBehavior", conflictBehavior);

package/src/server/microsoft-onenote.js

@@ -43,7 +43,7 @@ const microsoftOneNoteProvider = Object.freeze({ ...base,
     if (reader) try { while (true) {
       const { done, value } = await reader.read(); if (done) break;
       size += value.byteLength;
-      if (size > 1048576) { await reader.cancel(); throw new ConnectorError("connector_response_too_large", "Use the native OneNote client for pages above 1 MiB.", { statusCode: 413 }); }
+      if (size > 1048576) { await reader.cancel(); throw new ConnectorError("connector_response_too_large", "Use the native OneNote client for pages above 1 MiB.", { statusCode: 413, messageCode: "connectors.microsoftOnenote.useNativeOnenoteClientPages" }); }
       chunks.push(value);
     } } finally { reader.releaseLock(); }
     return { html: Buffer.concat(chunks).toString("utf8") };

package/src/server/microsoft-outlook.js

@@ -31,7 +31,7 @@ const base = microsoftProvider(microsoftOutlookDefinition, "common", "folders.li
   "calendars.list": { ...graphRead("Calendars.Read", {}, () => ({ pathname: "/me/calendars" })), scopes: ["Calendars.Read", "Calendars.ReadWrite"] },
   "events.list": { ...graphRead("Calendars.Read", { calendarId: id, pageSize }, ({ calendarId, pageSize }) => ({ pathname: `/me/calendars/${encodeURIComponent(calendarId)}/events`, query: { $top: pageSize } })), scopes: ["Calendars.Read", "Calendars.ReadWrite"] },
   "events.create": operation(["Calendars.ReadWrite"], { calendarId: id, subject: { ...text, maxLength: 255 }, start: instant, end: instant }, ({ calendarId, subject, start, end }) => {
-    if (Date.parse(end) <= Date.parse(start)) throw new ConnectorError("connector_input_invalid", "End must follow start.", { statusCode: 422 });
+    if (Date.parse(end) <= Date.parse(start)) throw new ConnectorError("connector_input_invalid", "End must follow start.", { statusCode: 422, messageCode: "connectors.microsoftOutlook.endMustFollowStart" });
     return { method: "POST", url: url(`/calendars/${encodeURIComponent(calendarId)}/events`), body: { subject, start: { dateTime: start.slice(0, -1), timeZone: "UTC" }, end: { dateTime: end.slice(0, -1), timeZone: "UTC" } } };
   }),
   "folders.list": graphRead("Mail.Read", {

package/src/server/microsoft.js

@@ -76,12 +76,13 @@ function microsoftDocumentProvider(definition, extensions) {
     const result = await request(address, options);
     if (new URL(address).pathname.endsWith("/children")) {
       if (!provider.operations["items.list"].validateResult(result)) {
-        throw new ConnectorError("connector_response_invalid", "Microsoft returned an invalid file list.", { statusCode: 502 });
+        throw new ConnectorError("connector_response_invalid", "Microsoft returned an invalid file list.", { statusCode: 502, messageCode: "connectors.microsoft.returnedInvalidFileList" });
       }
       return { ...result, value: result.value.filter((item) => item.folder || matches(item)) };
     }
-    if (!metadata(result)) throw new ConnectorError("connector_response_invalid", "Microsoft returned invalid file metadata.", { statusCode: 502 });
-    if (!matches(result)) throw new ConnectorError("connector_document_type_invalid", `Choose a ${definition.name} file.`);
+    if (!metadata(result)) throw new ConnectorError("connector_response_invalid", "Microsoft returned invalid file metadata.", { statusCode: 502, messageCode: "connectors.microsoft.returnedInvalidFileMetadata" });
+    if (!matches(result)) throw new ConnectorError("connector_document_type_invalid", `Choose a ${definition.name} file.`,
+      { messageCode: "connectors.microsoft.chooseDocumentFile", messageParams: { product: definition.name } });
     return result;
   } });
 }