@jskit-ai/workspaces-core 0.2.6 → 0.2.8

package/CHANGELOG.md

@@ -1,5 +1,79 @@
 # Changelog
 
+## Unreleased
+
+- The workspace, settings, member and invitation field messages are sent in the coded form `{ code, message, params }`, so their field errors translate. The English is unchanged.
+- The resources' save, delete and validation feedback names catalog keys under `jskit.workspaces.feedback.*` instead of plain English; JSKIT's forms render them with `text()`, so the English shown is unchanged.
+- The invitation email writes its expiry date with `Intl` in the recipient's locale and saved time zone (UTC without one), for example "November 2, 2026 at 12:00 AM UTC", instead of the raw ISO timestamp. An app's own `workspaces.invite-email-template` also receives the recipient's `timeZone` next to `locale`.
+
+### New codes (21)
+
+<details><summary>Code list</summary>
+
+- `workspaces.workspace.avatarUrlInvalid`
+- `workspaces.invite.decisionRequired`
+- `workspaces.invite.decisionInvalid`
+- `workspaces.settings.lightPrimaryColor.required`
+- `workspaces.settings.lightPrimaryColor.invalid`
+- `workspaces.settings.lightSecondaryColor.required`
+- `workspaces.settings.lightSecondaryColor.invalid`
+- `workspaces.settings.lightSurfaceColor.required`
+- `workspaces.settings.lightSurfaceColor.invalid`
+- `workspaces.settings.lightSurfaceVariantColor.required`
+- `workspaces.settings.lightSurfaceVariantColor.invalid`
+- `workspaces.settings.darkPrimaryColor.required`
+- `workspaces.settings.darkPrimaryColor.invalid`
+- `workspaces.settings.darkSecondaryColor.required`
+- `workspaces.settings.darkSecondaryColor.invalid`
+- `workspaces.settings.darkSurfaceColor.required`
+- `workspaces.settings.darkSurfaceColor.invalid`
+- `workspaces.settings.darkSurfaceVariantColor.required`
+- `workspaces.settings.darkSurfaceVariantColor.invalid`
+- `workspaces.settings.invitesEnabled.required`
+- `workspaces.settings.invitesEnabled.invalid`
+
+</details>
+
+### New message keys (33)
+
+<details><summary>Key list</summary>
+
+- `jskit.workspaces.workspace.avatarUrlInvalid`
+- `jskit.workspaces.invite.decisionRequired`
+- `jskit.workspaces.invite.decisionInvalid`
+- `jskit.workspaces.feedback.validationFailed`
+- `jskit.workspaces.feedback.fixInvalidValues`
+- `jskit.workspaces.feedback.recordSaved`
+- `jskit.workspaces.feedback.recordSaveFailed`
+- `jskit.workspaces.feedback.recordDeleted`
+- `jskit.workspaces.feedback.recordDeleteFailed`
+- `jskit.workspaces.feedback.workspaceInvalid`
+- `jskit.workspaces.feedback.workspaceUpdated`
+- `jskit.workspaces.feedback.workspaceUpdateFailed`
+- `jskit.workspaces.feedback.settingsInvalid`
+- `jskit.workspaces.feedback.settingsUpdated`
+- `jskit.workspaces.feedback.settingsUpdateFailed`
+- `jskit.workspaces.settings.lightPrimaryColor.required`
+- `jskit.workspaces.settings.lightPrimaryColor.invalid`
+- `jskit.workspaces.settings.lightSecondaryColor.required`
+- `jskit.workspaces.settings.lightSecondaryColor.invalid`
+- `jskit.workspaces.settings.lightSurfaceColor.required`
+- `jskit.workspaces.settings.lightSurfaceColor.invalid`
+- `jskit.workspaces.settings.lightSurfaceVariantColor.required`
+- `jskit.workspaces.settings.lightSurfaceVariantColor.invalid`
+- `jskit.workspaces.settings.darkPrimaryColor.required`
+- `jskit.workspaces.settings.darkPrimaryColor.invalid`
+- `jskit.workspaces.settings.darkSecondaryColor.required`
+- `jskit.workspaces.settings.darkSecondaryColor.invalid`
+- `jskit.workspaces.settings.darkSurfaceColor.required`
+- `jskit.workspaces.settings.darkSurfaceColor.invalid`
+- `jskit.workspaces.settings.darkSurfaceVariantColor.required`
+- `jskit.workspaces.settings.darkSurfaceVariantColor.invalid`
+- `jskit.workspaces.settings.invitesEnabled.required`
+- `jskit.workspaces.settings.invitesEnabled.invalid`
+
+</details>
+
 ## 0.2.0 - 2026-10-29
 
 - Translation ready: every user-visible text is a message key with its English in `locales/en.json`, so an app translates it by supplying translation files only. With no translations, texts and behaviour are unchanged. See the guide "Translating a JSKIT app".

package/locales/en.json

@@ -12,7 +12,8 @@
         "contextDisabled": "Workspace context is disabled.",
         "slugRequired": "workspaceSlug is required.",
         "notFound": "Workspace not found.",
-        "accessDenied": "You do not have access to this workspace."
+        "accessDenied": "You do not have access to this workspace.",
+        "avatarUrlInvalid": "Workspace avatar URL must be a valid absolute URL (http:// or https://)."
       },
       "member": {
         "roleNotAssignable": "Role is not assignable.",
@@ -36,7 +37,9 @@
         "emailMismatchAccount": "Invitation email does not match account email.",
         "notAvailable": "Invitation is not available.",
         "mailerUnconfigured": "No workspace invite mailer is configured.",
-        "sendFailed": "Unable to send workspace invite email."
+        "sendFailed": "Unable to send workspace invite email.",
+        "decisionRequired": "Decision is required.",
+        "decisionInvalid": "Decision must be accept or refuse."
       },
       "inviteEmail": {
         "subject": "You're invited to {workspace}",
@@ -46,6 +49,58 @@
         "openLink": "Open this link to accept the invitation:",
         "accept": "Accept invitation",
         "workspaceFallback": "the workspace"
+      },
+      "feedback": {
+        "validationFailed": "Validation failed.",
+        "fixInvalidValues": "Fix invalid values and try again.",
+        "recordSaved": "Record saved.",
+        "recordSaveFailed": "Unable to save record.",
+        "recordDeleted": "Record deleted.",
+        "recordDeleteFailed": "Unable to delete record.",
+        "workspaceInvalid": "Fix invalid workspace values and try again.",
+        "workspaceUpdated": "Workspace updated.",
+        "workspaceUpdateFailed": "Unable to update workspace.",
+        "settingsInvalid": "Fix invalid workspace settings values and try again.",
+        "settingsUpdated": "Workspace settings updated.",
+        "settingsUpdateFailed": "Unable to update workspace settings."
+      },
+      "settings": {
+        "lightPrimaryColor": {
+          "required": "Light primary color is required.",
+          "invalid": "Light primary color must be a hex color like #1867C0."
+        },
+        "lightSecondaryColor": {
+          "required": "Light secondary color is required.",
+          "invalid": "Light secondary color must be a hex color like #48A9A6."
+        },
+        "lightSurfaceColor": {
+          "required": "Light surface color is required.",
+          "invalid": "Light surface color must be a hex color like #FFFFFF."
+        },
+        "lightSurfaceVariantColor": {
+          "required": "Light surface variant color is required.",
+          "invalid": "Light surface variant color must be a hex color like #424242."
+        },
+        "darkPrimaryColor": {
+          "required": "Dark primary color is required.",
+          "invalid": "Dark primary color must be a hex color like #2196F3."
+        },
+        "darkSecondaryColor": {
+          "required": "Dark secondary color is required.",
+          "invalid": "Dark secondary color must be a hex color like #54B6B2."
+        },
+        "darkSurfaceColor": {
+          "required": "Dark surface color is required.",
+          "invalid": "Dark surface color must be a hex color like #212121."
+        },
+        "darkSurfaceVariantColor": {
+          "required": "Dark surface variant color is required.",
+          "invalid": "Dark surface variant color must be a hex color like #C8C8C8."
+        },
+        "invitesEnabled": {
+          "required": "invitesEnabled is required.",
+          "invalid": "invitesEnabled must be a boolean."
+        }
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/workspaces-core",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "type": "module",
   "scripts": {
     "test": "node --test --test-concurrency=1"
@@ -22,11 +22,11 @@
     "./locales/en.json": "./locales/en.json"
   },
   "dependencies": {
-    "@jskit-ai/database-runtime": "0.1.254",
-    "@jskit-ai/json-rest-api-core": "0.2.5",
-    "@jskit-ai/resource-core": "0.1.196",
-    "@jskit-ai/resource-crud-core": "0.1.196",
-    "@jskit-ai/users-core": "0.2.6",
+    "@jskit-ai/database-runtime": "0.1.256",
+    "@jskit-ai/json-rest-api-core": "0.2.7",
+    "@jskit-ai/resource-core": "0.1.198",
+    "@jskit-ai/resource-crud-core": "0.1.198",
+    "@jskit-ai/users-core": "0.2.8",
     "json-rest-schema": "^1.0.17"
   },
   "description": "Workspace tenancy runtime plus HTTP routes, role catalog, and workspace config scaffolding.",
@@ -198,8 +198,8 @@
     }
   },
   "peerDependencies": {
-    "@jskit-ai/auth-core": "0.2.5",
-    "@jskit-ai/http-runtime": "0.2.5",
-    "@jskit-ai/kernel": "0.2.5"
+    "@jskit-ai/auth-core": "0.2.7",
+    "@jskit-ai/http-runtime": "0.2.7",
+    "@jskit-ai/kernel": "0.2.7"
   }
 }

package/src/server/types.js

@@ -27,7 +27,7 @@
 /**
  * The `workspaces.invite-email-template` capability: renders an invitation
  * email's `{ subject, text, html }`.
- * @typedef {(input: { email: string, inviteUrl: string, workspace: object, inviter: object | null, roleSid: string, roleLabel?: string, expiresAt: string, locale: string, t: (key: string, params?: object) => string }) => object | Promise<object>} WorkspaceInviteEmailTemplate
+ * @typedef {(input: { email: string, inviteUrl: string, workspace: object, inviter: object | null, roleSid: string, roleLabel?: string, expiresAt: string, locale: string, timeZone: string, t: (key: string, params?: object) => string }) => object | Promise<object>} WorkspaceInviteEmailTemplate
  */
 
 /**

package/src/server/workspaceMembers/defaultWorkspaceInviteEmail.js

@@ -7,18 +7,60 @@ function escapeHtml(value) {
     .replaceAll("'", "'");
 }
 
+const EXPIRY_FORMAT = Object.freeze({
+  year: "numeric",
+  month: "long",
+  day: "numeric",
+  hour: "numeric",
+  minute: "2-digit",
+  timeZoneName: "short"
+});
+
+/**
+ * The expiry date in the recipient's language and time zone. A locale or time zone
+ * Intl does not know falls back to English or UTC; a value that is not a date is
+ * shown as sent.
+ * @param {string} expiresAt
+ * @param {string} locale
+ * @param {string} timeZone
+ */
+function formatInviteExpiry(expiresAt, locale, timeZone) {
+  const date = new Date(expiresAt);
+  if (!expiresAt || Number.isNaN(date.getTime())) {
+    return String(expiresAt || "");
+  }
+  for (const [tryLocale, tryTimeZone] of [[locale, timeZone], [locale, "UTC"], ["en", "UTC"]]) {
+    try {
+      return new Intl.DateTimeFormat(tryLocale || "en", { ...EXPIRY_FORMAT, timeZone: tryTimeZone || "UTC" }).format(date);
+    } catch {
+      // An unknown locale or time zone: try the next fallback.
+    }
+  }
+  return String(expiresAt);
+}
+
 /**
  * The `workspaces.invite-email-template` default. t renders a message in the
  * recipient's language. The markup stays here; each translated fragment,
  * parameters included, is escaped before it enters the HTML.
  * @type {import("../types.js").WorkspaceInviteEmailTemplate}
  */
-function renderDefaultWorkspaceInviteEmail({ inviteUrl, workspace, inviter, roleSid, roleLabel, expiresAt, t }) {
+function renderDefaultWorkspaceInviteEmail({
+  inviteUrl,
+  workspace,
+  inviter,
+  roleSid,
+  roleLabel,
+  expiresAt,
+  locale = "en",
+  timeZone = "UTC",
+  t
+}) {
   const workspaceName =
     String(workspace.name || workspace.slug || "").trim() || t("jskit.workspaces.inviteEmail.workspaceFallback");
   const inviterName = String(inviter?.displayName || inviter?.email || "").trim();
   const roleName = roleLabel || roleSid;
-  const expiryText = t("jskit.workspaces.inviteEmail.expiry", { expiresAt });
+  const expiryText = t("jskit.workspaces.inviteEmail.expiry", { expiresAt: formatInviteExpiry(expiresAt, locale, timeZone) });
   const intro = inviterName
     ? t("jskit.workspaces.inviteEmail.introFromInviter", { inviter: inviterName, workspace: workspaceName, role: roleName })
     : t("jskit.workspaces.inviteEmail.intro", { workspace: workspaceName, role: roleName });
@@ -38,4 +80,4 @@ function renderDefaultWorkspaceInviteEmail({ inviteUrl, workspace, inviter, role
   };
 }
 
-export { renderDefaultWorkspaceInviteEmail };
+export { formatInviteExpiry, renderDefaultWorkspaceInviteEmail };

package/src/server/workspaceMembers/workspaceMembersService.js

@@ -11,6 +11,7 @@ import {
 } from "./unconfiguredWorkspaceInviteMailer.js";
 
 const DEFAULT_LOCALE = "en";
+const DEFAULT_TIME_ZONE = "UTC";
 
 function roleNotAssignableError() {
   return createValidationError({
@@ -128,15 +129,19 @@ function createService({
     };
   }
 
-  // The saved locale of an existing account with the invited email, else English.
-  // A failed lookup must not stop the invitation, so it also falls back to English.
-  async function resolveRecipientLocale(email, options = {}) {
+  // The saved locale and time zone of an existing account with the invited email,
+  // else English and UTC. A failed lookup must not stop the invitation, so it also
+  // falls back to them.
+  async function resolveRecipientSettings(email, options = {}) {
     try {
       const profile = await userProfilesRepository.findByEmail(email, options);
       const settings = profile?.id ? await userSettingsRepository.findByUserId(profile.id, options) : null;
-      return normalizeText(settings?.locale) || DEFAULT_LOCALE;
+      return {
+        locale: normalizeText(settings?.locale) || DEFAULT_LOCALE,
+        timeZone: normalizeText(settings?.timeZone) || DEFAULT_TIME_ZONE
+      };
     } catch {
-      return DEFAULT_LOCALE;
+      return { locale: DEFAULT_LOCALE, timeZone: DEFAULT_TIME_ZONE };
     }
   }
 
@@ -148,7 +153,7 @@ function createService({
     }
     try {
       const roleLabel = roleCatalog.roles.find((role) => role.id === invite.roleSid)?.label;
-      const locale = await resolveRecipientLocale(invite.email, options);
+      const { locale, timeZone } = await resolveRecipientSettings(invite.email, options);
       const message = await workspaceInviteEmailTemplate({
         email: invite.email,
         inviteUrl,
@@ -158,6 +163,7 @@ function createService({
         ...(roleLabel ? { roleLabel } : {}),
         expiresAt: invite.expiresAt,
         locale,
+        timeZone,
         t: (key, params) => i18n.t(locale, key, params)
       });
       const result = await workspaceInviteMailer.sendWorkspaceInvite({

package/src/shared/operationMessages.js

@@ -1,7 +1,11 @@
-/** The messages a resource's operations show when their input fails validation. */
+/**
+ * The messages a resource's operations show when their input fails validation:
+ * validation is a message key the client renders; apiValidation is the API's
+ * English with its code.
+ */
 const OPERATION_MESSAGES = Object.freeze({
-  validation: "Validation failed.",
-  apiValidation: "Validation failed."
+  validation: "jskit.workspaces.feedback.validationFailed",
+  apiValidation: Object.freeze({ code: "validation_failed", message: "Validation failed." })
 });
 
 export { OPERATION_MESSAGES };

package/src/shared/resources/workspaceInvitesResource.js

@@ -150,11 +150,11 @@ const workspaceInvitesResource = defineCrudResource({
     }
   },
   messages: {
-    validation: "Fix invalid values and try again.",
-    saveSuccess: "Record saved.",
-    saveError: "Unable to save record.",
-    deleteSuccess: "Record deleted.",
-    deleteError: "Unable to delete record."
+    validation: "jskit.workspaces.feedback.fixInvalidValues",
+    saveSuccess: "jskit.workspaces.feedback.recordSaved",
+    saveError: "jskit.workspaces.feedback.recordSaveFailed",
+    deleteSuccess: "jskit.workspaces.feedback.recordDeleted",
+    deleteError: "jskit.workspaces.feedback.recordDeleteFailed"
   },
   crudOperations: ["list", "view", "create", "patch"]
 });

package/src/shared/resources/workspaceMembersResource.js

@@ -1,9 +1,18 @@
 import { RECORD_ID_PATTERN } from "@jskit-ai/kernel/shared/validators";
 import { createSchema } from "json-rest-schema";
+import { deepFreeze } from "@jskit-ai/kernel/shared/support/deepFreeze";
 import { defineResource } from "@jskit-ai/resource-core/shared/resource";
 import { OPERATION_MESSAGES } from "../operationMessages.js";
 import { workspaceRoleCatalogSchema } from "./workspaceRoleCatalogSchema.js";
 
+// Each field message: its English and the code a client renders it from in the user's language.
+const WORKSPACE_MEMBERS_FIELD_MESSAGES = deepFreeze({
+  inviteTokenRequired: { code: "workspaces.invite.tokenRequired", message: "Invite token is required." },
+  inviteTokenInvalid: { code: "workspaces.invite.tokenInvalid", message: "Invite token is invalid." },
+  decisionRequired: { code: "workspaces.invite.decisionRequired", message: "Decision is required." },
+  decisionInvalid: { code: "workspaces.invite.decisionInvalid", message: "Decision must be accept or refuse." }
+});
+
 const workspaceSummaryOutputSchema = createSchema({
   id: { type: "string", required: true, minLength: 1, pattern: RECORD_ID_PATTERN },
   slug: { type: "string", required: true, minLength: 1, maxLength: 120 },
@@ -180,9 +189,9 @@ const redeemInviteBodySchema = createSchema({
     required: true,
     minLength: 1,
     messages: {
-      required: "Invite token is required.",
-      minLength: "Invite token is required.",
-      default: "Invite token is invalid."
+      required: WORKSPACE_MEMBERS_FIELD_MESSAGES.inviteTokenRequired,
+      minLength: WORKSPACE_MEMBERS_FIELD_MESSAGES.inviteTokenRequired,
+      default: WORKSPACE_MEMBERS_FIELD_MESSAGES.inviteTokenInvalid
     }
   },
   decision: {
@@ -190,8 +199,8 @@ const redeemInviteBodySchema = createSchema({
     required: true,
     enum: ["accept", "refuse"],
     messages: {
-      required: "Decision is required.",
-      default: "Decision must be accept or refuse."
+      required: WORKSPACE_MEMBERS_FIELD_MESSAGES.decisionRequired,
+      default: WORKSPACE_MEMBERS_FIELD_MESSAGES.decisionInvalid
     }
   }
 });

package/src/shared/resources/workspaceMembershipsResource.js

@@ -87,11 +87,11 @@ const workspaceMembershipsResource = defineCrudResource({
     }
   },
   messages: {
-    validation: "Fix invalid values and try again.",
-    saveSuccess: "Record saved.",
-    saveError: "Unable to save record.",
-    deleteSuccess: "Record deleted.",
-    deleteError: "Unable to delete record."
+    validation: "jskit.workspaces.feedback.fixInvalidValues",
+    saveSuccess: "jskit.workspaces.feedback.recordSaved",
+    saveError: "jskit.workspaces.feedback.recordSaveFailed",
+    deleteSuccess: "jskit.workspaces.feedback.recordDeleted",
+    deleteError: "jskit.workspaces.feedback.recordDeleteFailed"
   },
   crudOperations: ["list", "view", "create", "patch"]
 });

package/src/shared/resources/workspacePendingInvitationsResource.js

@@ -1,17 +1,24 @@
 import { RECORD_ID_PATTERN } from "@jskit-ai/kernel/shared/validators";
 import { createSchema } from "json-rest-schema";
+import { deepFreeze } from "@jskit-ai/kernel/shared/support/deepFreeze";
 import { defineResource } from "@jskit-ai/resource-core/shared/resource";
 import { OPERATION_MESSAGES } from "../operationMessages.js";
 
+// Each field message: its English and the code a client renders it from in the user's language.
+const WORKSPACE_PENDING_INVITATIONS_FIELD_MESSAGES = deepFreeze({
+  inviteTokenRequired: { code: "workspaces.invite.tokenRequired", message: "Invite token is required." },
+  inviteTokenInvalid: { code: "workspaces.invite.tokenInvalid", message: "Invite token is invalid." }
+});
+
 const invitationTokenQuerySchema = createSchema({
   token: {
     type: "string",
     required: true,
     minLength: 1,
     messages: {
-      required: "Invite token is required.",
-      minLength: "Invite token is required.",
-      default: "Invite token is invalid."
+      required: WORKSPACE_PENDING_INVITATIONS_FIELD_MESSAGES.inviteTokenRequired,
+      minLength: WORKSPACE_PENDING_INVITATIONS_FIELD_MESSAGES.inviteTokenRequired,
+      default: WORKSPACE_PENDING_INVITATIONS_FIELD_MESSAGES.inviteTokenInvalid
     }
   }
 });

package/src/shared/resources/workspaceResource.js

@@ -1,8 +1,18 @@
 import { createSchema } from "json-rest-schema";
+import { deepFreeze } from "@jskit-ai/kernel/shared/support/deepFreeze";
 import { normalizeLowerText, normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
 import { RECORD_ID_PATTERN } from "@jskit-ai/kernel/shared/validators";
 import { defineCrudResource } from "@jskit-ai/resource-crud-core/shared/crudResource";
 import { createSchemaDefinition } from "@jskit-ai/resource-core/shared/resource";
+import { OPERATION_MESSAGES } from "../operationMessages.js";
+
+// Each field message: its English and the code a client renders it from in the user's language.
+const WORKSPACE_FIELD_MESSAGES = deepFreeze({
+  avatarUrlInvalid: {
+    code: "workspaces.workspace.avatarUrlInvalid",
+    message: "Workspace avatar URL must be a valid absolute URL (http:// or https://)."
+  }
+});
 
 function normalizeWorkspaceAvatarUrl(value) {
   const avatarUrl = normalizeText(value);
@@ -50,8 +60,8 @@ const workspacePatchBodySchema = createSchema({
     required: false,
     pattern: "^(https?://.+)?$",
     messages: {
-      pattern: "Workspace avatar URL must be a valid absolute URL (http:// or https://).",
-      default: "Workspace avatar URL must be a valid absolute URL (http:// or https://)."
+      pattern: WORKSPACE_FIELD_MESSAGES.avatarUrlInvalid,
+      default: WORKSPACE_FIELD_MESSAGES.avatarUrlInvalid
     }
   }
 });
@@ -133,10 +143,10 @@ const resource = defineCrudResource({
     }
   },
   messages: {
-    validation: "Fix invalid workspace values and try again.",
-    saveSuccess: "Workspace updated.",
-    saveError: "Unable to update workspace.",
-    apiValidation: "Validation failed."
+    validation: "jskit.workspaces.feedback.workspaceInvalid",
+    saveSuccess: "jskit.workspaces.feedback.workspaceUpdated",
+    saveError: "jskit.workspaces.feedback.workspaceUpdateFailed",
+    apiValidation: OPERATION_MESSAGES.apiValidation
   },
   crudOperations: ["view", "list", "create", "replace", "patch"],
   crud: {

package/src/shared/resources/workspaceSettingsResource.js

@@ -9,6 +9,83 @@ import {
   DEFAULT_WORKSPACE_LIGHT_PALETTE,
   WORKSPACE_SETTINGS_COLOR_FIELDS
 } from "../settings.js";
+import { OPERATION_MESSAGES } from "../operationMessages.js";
+
+// Each field message: its English and the code a client renders it from in the user's language.
+const WORKSPACE_SETTINGS_FIELD_MESSAGES = deepFreeze({
+  lightPrimaryColorRequired: {
+    code: "workspaces.settings.lightPrimaryColor.required",
+    message: "Light primary color is required."
+  },
+  lightPrimaryColorInvalid: {
+    code: "workspaces.settings.lightPrimaryColor.invalid",
+    message: "Light primary color must be a hex color like #1867C0."
+  },
+  lightSecondaryColorRequired: {
+    code: "workspaces.settings.lightSecondaryColor.required",
+    message: "Light secondary color is required."
+  },
+  lightSecondaryColorInvalid: {
+    code: "workspaces.settings.lightSecondaryColor.invalid",
+    message: "Light secondary color must be a hex color like #48A9A6."
+  },
+  lightSurfaceColorRequired: {
+    code: "workspaces.settings.lightSurfaceColor.required",
+    message: "Light surface color is required."
+  },
+  lightSurfaceColorInvalid: {
+    code: "workspaces.settings.lightSurfaceColor.invalid",
+    message: "Light surface color must be a hex color like #FFFFFF."
+  },
+  lightSurfaceVariantColorRequired: {
+    code: "workspaces.settings.lightSurfaceVariantColor.required",
+    message: "Light surface variant color is required."
+  },
+  lightSurfaceVariantColorInvalid: {
+    code: "workspaces.settings.lightSurfaceVariantColor.invalid",
+    message: "Light surface variant color must be a hex color like #424242."
+  },
+  darkPrimaryColorRequired: {
+    code: "workspaces.settings.darkPrimaryColor.required",
+    message: "Dark primary color is required."
+  },
+  darkPrimaryColorInvalid: {
+    code: "workspaces.settings.darkPrimaryColor.invalid",
+    message: "Dark primary color must be a hex color like #2196F3."
+  },
+  darkSecondaryColorRequired: {
+    code: "workspaces.settings.darkSecondaryColor.required",
+    message: "Dark secondary color is required."
+  },
+  darkSecondaryColorInvalid: {
+    code: "workspaces.settings.darkSecondaryColor.invalid",
+    message: "Dark secondary color must be a hex color like #54B6B2."
+  },
+  darkSurfaceColorRequired: {
+    code: "workspaces.settings.darkSurfaceColor.required",
+    message: "Dark surface color is required."
+  },
+  darkSurfaceColorInvalid: {
+    code: "workspaces.settings.darkSurfaceColor.invalid",
+    message: "Dark surface color must be a hex color like #212121."
+  },
+  darkSurfaceVariantColorRequired: {
+    code: "workspaces.settings.darkSurfaceVariantColor.required",
+    message: "Dark surface variant color is required."
+  },
+  darkSurfaceVariantColorInvalid: {
+    code: "workspaces.settings.darkSurfaceVariantColor.invalid",
+    message: "Dark surface variant color must be a hex color like #C8C8C8."
+  },
+  invitesEnabledRequired: {
+    code: "workspaces.settings.invitesEnabled.required",
+    message: "invitesEnabled is required."
+  },
+  invitesEnabledInvalid: {
+    code: "workspaces.settings.invitesEnabled.invalid",
+    message: "invitesEnabled must be a boolean."
+  }
+});
 
 const WORKSPACE_SETTINGS_FIELD_KEYS = deepFreeze([...WORKSPACE_SETTINGS_COLOR_FIELDS, "invitesEnabled"]);
 
@@ -20,9 +97,9 @@ const workspaceSettingsBodySchema = createSchema({
     maxLength: 7,
     pattern: "^#[0-9A-Fa-f]{6}$",
     messages: {
-      required: "Light primary color is required.",
-      pattern: "Light primary color must be a hex color like #1867C0.",
-      default: "Light primary color must be a hex color like #1867C0."
+      required: WORKSPACE_SETTINGS_FIELD_MESSAGES.lightPrimaryColorRequired,
+      pattern: WORKSPACE_SETTINGS_FIELD_MESSAGES.lightPrimaryColorInvalid,
+      default: WORKSPACE_SETTINGS_FIELD_MESSAGES.lightPrimaryColorInvalid
     }
   },
   lightSecondaryColor: {
@@ -32,9 +109,9 @@ const workspaceSettingsBodySchema = createSchema({
     maxLength: 7,
     pattern: "^#[0-9A-Fa-f]{6}$",
     messages: {
-      required: "Light secondary color is required.",
-      pattern: "Light secondary color must be a hex color like #48A9A6.",
-      default: "Light secondary color must be a hex color like #48A9A6."
+      required: WORKSPACE_SETTINGS_FIELD_MESSAGES.lightSecondaryColorRequired,
+      pattern: WORKSPACE_SETTINGS_FIELD_MESSAGES.lightSecondaryColorInvalid,
+      default: WORKSPACE_SETTINGS_FIELD_MESSAGES.lightSecondaryColorInvalid
     }
   },
   lightSurfaceColor: {
@@ -44,9 +121,9 @@ const workspaceSettingsBodySchema = createSchema({
     maxLength: 7,
     pattern: "^#[0-9A-Fa-f]{6}$",
     messages: {
-      required: "Light surface color is required.",
-      pattern: "Light surface color must be a hex color like #FFFFFF.",
-      default: "Light surface color must be a hex color like #FFFFFF."
+      required: WORKSPACE_SETTINGS_FIELD_MESSAGES.lightSurfaceColorRequired,
+      pattern: WORKSPACE_SETTINGS_FIELD_MESSAGES.lightSurfaceColorInvalid,
+      default: WORKSPACE_SETTINGS_FIELD_MESSAGES.lightSurfaceColorInvalid
     }
   },
   lightSurfaceVariantColor: {
@@ -56,9 +133,9 @@ const workspaceSettingsBodySchema = createSchema({
     maxLength: 7,
     pattern: "^#[0-9A-Fa-f]{6}$",
     messages: {
-      required: "Light surface variant color is required.",
-      pattern: "Light surface variant color must be a hex color like #424242.",
-      default: "Light surface variant color must be a hex color like #424242."
+      required: WORKSPACE_SETTINGS_FIELD_MESSAGES.lightSurfaceVariantColorRequired,
+      pattern: WORKSPACE_SETTINGS_FIELD_MESSAGES.lightSurfaceVariantColorInvalid,
+      default: WORKSPACE_SETTINGS_FIELD_MESSAGES.lightSurfaceVariantColorInvalid
     }
   },
   darkPrimaryColor: {
@@ -68,9 +145,9 @@ const workspaceSettingsBodySchema = createSchema({
     maxLength: 7,
     pattern: "^#[0-9A-Fa-f]{6}$",
     messages: {
-      required: "Dark primary color is required.",
-      pattern: "Dark primary color must be a hex color like #2196F3.",
-      default: "Dark primary color must be a hex color like #2196F3."
+      required: WORKSPACE_SETTINGS_FIELD_MESSAGES.darkPrimaryColorRequired,
+      pattern: WORKSPACE_SETTINGS_FIELD_MESSAGES.darkPrimaryColorInvalid,
+      default: WORKSPACE_SETTINGS_FIELD_MESSAGES.darkPrimaryColorInvalid
     }
   },
   darkSecondaryColor: {
@@ -80,9 +157,9 @@ const workspaceSettingsBodySchema = createSchema({
     maxLength: 7,
     pattern: "^#[0-9A-Fa-f]{6}$",
     messages: {
-      required: "Dark secondary color is required.",
-      pattern: "Dark secondary color must be a hex color like #54B6B2.",
-      default: "Dark secondary color must be a hex color like #54B6B2."
+      required: WORKSPACE_SETTINGS_FIELD_MESSAGES.darkSecondaryColorRequired,
+      pattern: WORKSPACE_SETTINGS_FIELD_MESSAGES.darkSecondaryColorInvalid,
+      default: WORKSPACE_SETTINGS_FIELD_MESSAGES.darkSecondaryColorInvalid
     }
   },
   darkSurfaceColor: {
@@ -92,9 +169,9 @@ const workspaceSettingsBodySchema = createSchema({
     maxLength: 7,
     pattern: "^#[0-9A-Fa-f]{6}$",
     messages: {
-      required: "Dark surface color is required.",
-      pattern: "Dark surface color must be a hex color like #212121.",
-      default: "Dark surface color must be a hex color like #212121."
+      required: WORKSPACE_SETTINGS_FIELD_MESSAGES.darkSurfaceColorRequired,
+      pattern: WORKSPACE_SETTINGS_FIELD_MESSAGES.darkSurfaceColorInvalid,
+      default: WORKSPACE_SETTINGS_FIELD_MESSAGES.darkSurfaceColorInvalid
     }
   },
   darkSurfaceVariantColor: {
@@ -104,9 +181,9 @@ const workspaceSettingsBodySchema = createSchema({
     maxLength: 7,
     pattern: "^#[0-9A-Fa-f]{6}$",
     messages: {
-      required: "Dark surface variant color is required.",
-      pattern: "Dark surface variant color must be a hex color like #C8C8C8.",
-      default: "Dark surface variant color must be a hex color like #C8C8C8."
+      required: WORKSPACE_SETTINGS_FIELD_MESSAGES.darkSurfaceVariantColorRequired,
+      pattern: WORKSPACE_SETTINGS_FIELD_MESSAGES.darkSurfaceVariantColorInvalid,
+      default: WORKSPACE_SETTINGS_FIELD_MESSAGES.darkSurfaceVariantColorInvalid
     }
   },
   invitesEnabled: {
@@ -114,8 +191,8 @@ const workspaceSettingsBodySchema = createSchema({
     required: true,
     strictBoolean: true,
     messages: {
-      required: "invitesEnabled is required.",
-      default: "invitesEnabled must be a boolean."
+      required: WORKSPACE_SETTINGS_FIELD_MESSAGES.invitesEnabledRequired,
+      default: WORKSPACE_SETTINGS_FIELD_MESSAGES.invitesEnabledInvalid
     }
   }
 });
@@ -273,10 +350,10 @@ const workspaceSettingsResource = defineCrudResource({
     }
   },
   messages: {
-    validation: "Fix invalid workspace settings values and try again.",
-    saveSuccess: "Workspace settings updated.",
-    saveError: "Unable to update workspace settings.",
-    apiValidation: "Validation failed."
+    validation: "jskit.workspaces.feedback.settingsInvalid",
+    saveSuccess: "jskit.workspaces.feedback.settingsUpdated",
+    saveError: "jskit.workspaces.feedback.settingsUpdateFailed",
+    apiValidation: OPERATION_MESSAGES.apiValidation
   },
   crudOperations: ["view", "list", "create", "replace", "patch"],
   crud: {

package/test/roleLabels.test.js

@@ -11,7 +11,10 @@ import { createWorkspacesServerI18n } from "../src/server/i18n.js";
 import { noInviteAcceptanceParticipant } from "../src/server/workspacePendingInvitations/noInviteAcceptanceParticipant.js";
 import { createService as createSettingsService } from "../src/server/workspaceSettings/workspaceSettingsService.js";
 import { createService as createPendingService } from "../src/server/workspacePendingInvitations/workspacePendingInvitationsService.js";
-import { renderDefaultWorkspaceInviteEmail } from "../src/server/workspaceMembers/defaultWorkspaceInviteEmail.js";
+import {
+  formatInviteExpiry,
+  renderDefaultWorkspaceInviteEmail
+} from "../src/server/workspaceMembers/defaultWorkspaceInviteEmail.js";
 import { createWorkspaceInviteUrlBuilder } from "../src/server/workspaceMembers/workspaceInviteUrls.js";
 import { unconfiguredWorkspaceInviteMailer } from "../src/server/workspaceMembers/unconfiguredWorkspaceInviteMailer.js";
 
@@ -155,3 +158,33 @@ test("default invitation email uses the configured label with HTML escaping and
   assert.match(labelled.html, /as Member <team>/u);
   assert.match(renderDefaultWorkspaceInviteEmail(input).text, /as worker/u);
 });
+
+test("default invitation email writes the expiry as a date in the recipient's locale and time zone", () => {
+  const i18n = createWorkspacesServerI18n();
+  const message = renderDefaultWorkspaceInviteEmail({
+    email: "reader@example.test",
+    inviteUrl: "/invite/abc",
+    workspace: { name: "Acme", slug: "acme" },
+    inviter: null,
+    roleSid: "worker",
+    expiresAt: "2026-11-02T00:00:00.000Z",
+    locale: "en",
+    timeZone: "UTC",
+    t: (key, params) => i18n.t("en", key, params)
+  });
+  assert.match(message.text, /November 2, 2026/u);
+  assert.doesNotMatch(message.text, /2026-11-02T00:00:00\.000Z/u);
+
+  assert.match(formatInviteExpiry("2026-11-02T00:00:00.000Z", "it", "Europe/Rome"), /2 novembre 2026/u);
+  assert.match(formatInviteExpiry("2026-11-02T00:00:00.000Z", "en", "America/New_York"), /November 1, 2026/u);
+  // An unknown time zone or locale falls back to UTC or English; a value that is not a date is shown as sent.
+  assert.equal(
+    formatInviteExpiry("2026-11-02T00:00:00.000Z", "en", "Not/AZone"),
+    formatInviteExpiry("2026-11-02T00:00:00.000Z", "en", "UTC")
+  );
+  assert.equal(
+    formatInviteExpiry("2026-11-02T00:00:00.000Z", "not a locale!", "UTC"),
+    formatInviteExpiry("2026-11-02T00:00:00.000Z", "en", "UTC")
+  );
+  assert.equal(formatInviteExpiry("soon", "en", "UTC"), "soon");
+});