@thejob/schema 2.1.2 → 2.1.3

package/dist/index.cjs

@@ -80,6 +80,7 @@ __export(index_exports, {
   MIN_SALARY_LOWER_BOUND: () => MIN_SALARY_LOWER_BOUND,
   MIN_SALARY_UPPER_BOUND: () => MIN_SALARY_UPPER_BOUND,
   MailingListSchema: () => MailingListSchema,
+  NotificationChannel: () => NotificationChannel,
   PREFILL_MIRRORED_KEYS: () => PREFILL_MIRRORED_KEYS,
   PRIVATE_PROFILE_FIELDS: () => PRIVATE_PROFILE_FIELDS,
   PageSchema: () => PageSchema,
@@ -121,6 +122,7 @@ __export(index_exports, {
   SupportedJobSearchUrgencies: () => SupportedJobSearchUrgencies,
   SupportedJobStatuses: () => SupportedJobStatuses,
   SupportedJobSubCategories: () => SupportedJobSubCategories,
+  SupportedNotificationChannels: () => SupportedNotificationChannels,
   SupportedPageStatuses: () => SupportedPageStatuses,
   SupportedPageTypes: () => SupportedPageTypes,
   SupportedPostStatuses: () => SupportedPostStatuses,
@@ -2155,6 +2157,14 @@ var JobAlertFrequency = /* @__PURE__ */ ((JobAlertFrequency2) => {
   return JobAlertFrequency2;
 })(JobAlertFrequency || {});
 var SupportedJobAlertFrequencies = Object.values(JobAlertFrequency);
+var NotificationChannel = /* @__PURE__ */ ((NotificationChannel2) => {
+  NotificationChannel2["GroupActivity"] = "groupActivity";
+  NotificationChannel2["JobActivity"] = "jobActivity";
+  NotificationChannel2["ApplicationUpdates"] = "applicationUpdates";
+  NotificationChannel2["ProductUpdates"] = "productUpdates";
+  return NotificationChannel2;
+})(NotificationChannel || {});
+var SupportedNotificationChannels = Object.values(NotificationChannel);
 var SupportedSalaryCurrencies = ["USD", "EUR", "GBP", "SEK", "INR"];
 var MIN_SALARY_LOWER_BOUND = 0;
 var MIN_SALARY_UPPER_BOUND = 1e6;
@@ -2680,6 +2690,30 @@ var UserSchema = (0, import_yup36.object)({
      */
     jobAlertFrequency: (0, import_yup36.string)().oneOf(SupportedJobAlertFrequencies).optional().label("Job alert frequency")
   }).default({ subscribed: false }).label("Marketing Consent"),
+  /**
+   * Per-channel toggles for NOTIFICATION email — mail about activity on the
+   * user's own account (a group invite, a job of theirs expiring).
+   *
+   * Deliberately separate from `marketingConsent`, which they must NOT be
+   * collapsed into: the two have different legal footing, which the
+   * email-service footer rules already encode. Notifications are opt-OUT
+   * (default `true`) because a user who declined marketing still needs to hear
+   * that their group invite arrived; marketing stays opt-IN. `productUpdates`
+   * is the exception — it is promotional in character, so it defaults off.
+   *
+   * Transactional mail (magic-link, verification) ignores this object entirely.
+   */
+  notificationPrefs: (0, import_yup36.object)({
+    groupActivity: (0, import_yup36.boolean)().default(true).label("Group activity email"),
+    jobActivity: (0, import_yup36.boolean)().default(true).label("Job activity email"),
+    applicationUpdates: (0, import_yup36.boolean)().default(true).label("Application update email"),
+    productUpdates: (0, import_yup36.boolean)().default(false).label("Product update email")
+  }).default({
+    groupActivity: true,
+    jobActivity: true,
+    applicationUpdates: true,
+    productUpdates: false
+  }).label("Notification Preferences"),
   /**
    * Vector embedding of the user's profile for semantic/hybrid search.
    * Generated from a structured summary of skills, experience, education, etc.
@@ -2766,6 +2800,7 @@ var StudentCompletenessSchema = UserCompletenessSchema.omit([
   MIN_SALARY_LOWER_BOUND,
   MIN_SALARY_UPPER_BOUND,
   MailingListSchema,
+  NotificationChannel,
   PREFILL_MIRRORED_KEYS,
   PRIVATE_PROFILE_FIELDS,
   PageSchema,
@@ -2807,6 +2842,7 @@ var StudentCompletenessSchema = UserCompletenessSchema.omit([
   SupportedJobSearchUrgencies,
   SupportedJobStatuses,
   SupportedJobSubCategories,
+  SupportedNotificationChannels,
   SupportedPageStatuses,
   SupportedPageTypes,
   SupportedPostStatuses,

package/dist/index.d.cts

@@ -1689,6 +1689,27 @@ declare enum JobAlertFrequency {
     Weekly = "weekly"
 }
 declare const SupportedJobAlertFrequencies: JobAlertFrequency[];
+/**
+ * Channels of NOTIFICATION email — mail about activity on the user's own
+ * account (a group invite, a job of theirs expiring). Distinct from marketing:
+ * notifications are opt-OUT (default on, see `notificationPrefs`), marketing is
+ * opt-IN (`marketingConsent.subscribed`). Transactional mail (magic-link,
+ * verification) is governed by neither and always sends.
+ *
+ * Deliberately coarse: four channels a user will actually reason about, rather
+ * than one toggle per email template.
+ */
+declare enum NotificationChannel {
+    /** Group invites, join requests, membership approved/rejected. */
+    GroupActivity = "groupActivity",
+    /** Activity on jobs the user posted, e.g. a listing expiring. */
+    JobActivity = "jobActivity",
+    /** Status changes on jobs the user applied to. */
+    ApplicationUpdates = "applicationUpdates",
+    /** Product announcements and feature news. */
+    ProductUpdates = "productUpdates"
+}
+declare const SupportedNotificationChannels: NotificationChannel[];
 /** ISO-4217 currency codes accepted for the salary preference (extend as needed). */
 declare const SupportedSalaryCurrencies: readonly ["USD", "EUR", "GBP", "SEK", "INR"];
 type SupportedSalaryCurrency = (typeof SupportedSalaryCurrencies)[number];
@@ -1823,6 +1844,12 @@ declare const UserSchema: yup.ObjectSchema<{
         jobAlertFrequency?: JobAlertFrequency | undefined;
         subscribed: boolean;
     };
+    notificationPrefs: {
+        groupActivity: boolean;
+        jobActivity: boolean;
+        applicationUpdates: boolean;
+        productUpdates: boolean;
+    };
     embedding: {
         vector?: number[] | undefined;
         model?: string | undefined;
@@ -2022,6 +2049,12 @@ declare const UserSchema: yup.ObjectSchema<{
     marketingConsent: {
         subscribed: boolean;
     };
+    notificationPrefs: {
+        groupActivity: boolean;
+        jobActivity: boolean;
+        applicationUpdates: boolean;
+        productUpdates: boolean;
+    };
     embedding: {
         vector: undefined;
         model: undefined;
@@ -2910,4 +2943,4 @@ declare const StudentCompletenessSchema: yup.ObjectSchema<{
     };
 }, "">;
 
-export { AnswerChoiceType, ApplicationReceivePreference, CampaignSchema, CampaignStatus, ChoiceQuestionSchema, Common, CompensationType, CompletenessScoreSchema, ContactTypes, CoordinatorPageLinkSchema, DISPLAY_DATE_FORMAT, DISPLAY_DATE_FORMAT_SHORT, DateStringSchema, DbDefaultSchema, DefaultPaginatedResponse, DefaultPaginationOptions, DefaultUserRoles, DurationSchema, EMPTY_STRING, EducationLevel, EducationSchema, EmployeeCount, EmploymentType, ExperienceLevel, FEEDBACK_MESSAGE_MAX, FeedbackSchema, FeedbackStatus, FeedbackType, GeneraDetailFields, GroupManagedBy, GroupMembershipSchema, GroupMembershipStatus, GroupSchema, GroupStatus, GroupTranslationSchema, GroupVisibility, InputQuestionSchema, JOB_TAXONOMY, JobAlertFrequency, JobCategory, JobIndustry, JobSchema, JobSearchUrgency, JobStatus, JobSubCategory, ListFilterSchema, LocationSchema, MIN_SALARY_LOWER_BOUND, MIN_SALARY_UPPER_BOUND, MailingListSchema, PREFILL_MIRRORED_KEYS, PRIVATE_PROFILE_FIELDS, PageSchema, PageStatus, PageType, type PaginatedResponse, PaginationSchema, PostSchema, PostStatus, type PrefillMirroredKey, type PrivateProfileField, ProficiencyLevel, QuestionSchema, QuestionType, ReadAndAcknowledgeQuestionSchema, RecruiterPageLinkSchema, ReferralSource, ReportReason, ReportSchema, ResourceType, SITEMAP_FORMAT, SYSTEM_DATE_FORMAT, SkillSchema, SocialAccount, SocialAccountSchema, StudentCompletenessSchema, StudyType, SupportedAnswerChoiceTypes, SupportedApplicationReceivePreferences, SupportedCampaignStatuses, SupportedCompensationTypes, SupportedContactTypes, SupportedEducationLevels, SupportedEmployeeCounts, SupportedEmploymentTypes, SupportedExperienceLevels, SupportedFeedbackStatuses, SupportedFeedbackTypes, SupportedJobAlertFrequencies, SupportedJobCategories, SupportedJobIndustries, SupportedJobSearchUrgencies, SupportedJobStatuses, SupportedJobSubCategories, SupportedPageStatuses, SupportedPageTypes, SupportedPostStatuses, SupportedProficiencyLevels, SupportedQuestionTypes, SupportedReferralSources, SupportedReportReasons, SupportedResourceTypes, SupportedSalaryCurrencies, type SupportedSalaryCurrency, SupportedSocialAccounts, SupportedStudyTypes, SupportedUserProfileVisibilities, SupportedUserRoles, SupportedUserStatuses, SupportedWorkModes, TAXONOMY_LABELS, type TChoiceQuestionSchema, type TDurationSchema, type TInputQuestionSchema, type TJobSchema, type TPostSchema, type TQuestionSchema, type TReadAndAcknowledgeQuestionSchema, type TUserIdAndCreatedAtSchema, TermsAcceptedSchema, UserAdditionalInfoSchema, UserCertificationSchema, UserCompletenessSchema, UserCoordinatorProfileSchema, UserDetailType, UserGeneralDetailSchema, UserIdAndCreatedAtSchema, UserInterestSchema, UserJobPreferencesSchema, UserLanguageSchema, type UserProfileOverview, UserProfileVisibility, UserProjectSchema, UserRecruiterProfileSchema, UserRole, UserSchema, UserSkillSchema, UserStatus, WorkExperienceSchema, WorkMode, categoryOfIndustry, categoryOfSubCategory, dateString, deriveIndustry, getSchemaByQuestion, industriesOfCategory, industryOfSubCategory, subCategoriesOfIndustry };
+export { AnswerChoiceType, ApplicationReceivePreference, CampaignSchema, CampaignStatus, ChoiceQuestionSchema, Common, CompensationType, CompletenessScoreSchema, ContactTypes, CoordinatorPageLinkSchema, DISPLAY_DATE_FORMAT, DISPLAY_DATE_FORMAT_SHORT, DateStringSchema, DbDefaultSchema, DefaultPaginatedResponse, DefaultPaginationOptions, DefaultUserRoles, DurationSchema, EMPTY_STRING, EducationLevel, EducationSchema, EmployeeCount, EmploymentType, ExperienceLevel, FEEDBACK_MESSAGE_MAX, FeedbackSchema, FeedbackStatus, FeedbackType, GeneraDetailFields, GroupManagedBy, GroupMembershipSchema, GroupMembershipStatus, GroupSchema, GroupStatus, GroupTranslationSchema, GroupVisibility, InputQuestionSchema, JOB_TAXONOMY, JobAlertFrequency, JobCategory, JobIndustry, JobSchema, JobSearchUrgency, JobStatus, JobSubCategory, ListFilterSchema, LocationSchema, MIN_SALARY_LOWER_BOUND, MIN_SALARY_UPPER_BOUND, MailingListSchema, NotificationChannel, PREFILL_MIRRORED_KEYS, PRIVATE_PROFILE_FIELDS, PageSchema, PageStatus, PageType, type PaginatedResponse, PaginationSchema, PostSchema, PostStatus, type PrefillMirroredKey, type PrivateProfileField, ProficiencyLevel, QuestionSchema, QuestionType, ReadAndAcknowledgeQuestionSchema, RecruiterPageLinkSchema, ReferralSource, ReportReason, ReportSchema, ResourceType, SITEMAP_FORMAT, SYSTEM_DATE_FORMAT, SkillSchema, SocialAccount, SocialAccountSchema, StudentCompletenessSchema, StudyType, SupportedAnswerChoiceTypes, SupportedApplicationReceivePreferences, SupportedCampaignStatuses, SupportedCompensationTypes, SupportedContactTypes, SupportedEducationLevels, SupportedEmployeeCounts, SupportedEmploymentTypes, SupportedExperienceLevels, SupportedFeedbackStatuses, SupportedFeedbackTypes, SupportedJobAlertFrequencies, SupportedJobCategories, SupportedJobIndustries, SupportedJobSearchUrgencies, SupportedJobStatuses, SupportedJobSubCategories, SupportedNotificationChannels, SupportedPageStatuses, SupportedPageTypes, SupportedPostStatuses, SupportedProficiencyLevels, SupportedQuestionTypes, SupportedReferralSources, SupportedReportReasons, SupportedResourceTypes, SupportedSalaryCurrencies, type SupportedSalaryCurrency, SupportedSocialAccounts, SupportedStudyTypes, SupportedUserProfileVisibilities, SupportedUserRoles, SupportedUserStatuses, SupportedWorkModes, TAXONOMY_LABELS, type TChoiceQuestionSchema, type TDurationSchema, type TInputQuestionSchema, type TJobSchema, type TPostSchema, type TQuestionSchema, type TReadAndAcknowledgeQuestionSchema, type TUserIdAndCreatedAtSchema, TermsAcceptedSchema, UserAdditionalInfoSchema, UserCertificationSchema, UserCompletenessSchema, UserCoordinatorProfileSchema, UserDetailType, UserGeneralDetailSchema, UserIdAndCreatedAtSchema, UserInterestSchema, UserJobPreferencesSchema, UserLanguageSchema, type UserProfileOverview, UserProfileVisibility, UserProjectSchema, UserRecruiterProfileSchema, UserRole, UserSchema, UserSkillSchema, UserStatus, WorkExperienceSchema, WorkMode, categoryOfIndustry, categoryOfSubCategory, dateString, deriveIndustry, getSchemaByQuestion, industriesOfCategory, industryOfSubCategory, subCategoriesOfIndustry };

package/dist/index.d.ts

@@ -1689,6 +1689,27 @@ declare enum JobAlertFrequency {
     Weekly = "weekly"
 }
 declare const SupportedJobAlertFrequencies: JobAlertFrequency[];
+/**
+ * Channels of NOTIFICATION email — mail about activity on the user's own
+ * account (a group invite, a job of theirs expiring). Distinct from marketing:
+ * notifications are opt-OUT (default on, see `notificationPrefs`), marketing is
+ * opt-IN (`marketingConsent.subscribed`). Transactional mail (magic-link,
+ * verification) is governed by neither and always sends.
+ *
+ * Deliberately coarse: four channels a user will actually reason about, rather
+ * than one toggle per email template.
+ */
+declare enum NotificationChannel {
+    /** Group invites, join requests, membership approved/rejected. */
+    GroupActivity = "groupActivity",
+    /** Activity on jobs the user posted, e.g. a listing expiring. */
+    JobActivity = "jobActivity",
+    /** Status changes on jobs the user applied to. */
+    ApplicationUpdates = "applicationUpdates",
+    /** Product announcements and feature news. */
+    ProductUpdates = "productUpdates"
+}
+declare const SupportedNotificationChannels: NotificationChannel[];
 /** ISO-4217 currency codes accepted for the salary preference (extend as needed). */
 declare const SupportedSalaryCurrencies: readonly ["USD", "EUR", "GBP", "SEK", "INR"];
 type SupportedSalaryCurrency = (typeof SupportedSalaryCurrencies)[number];
@@ -1823,6 +1844,12 @@ declare const UserSchema: yup.ObjectSchema<{
         jobAlertFrequency?: JobAlertFrequency | undefined;
         subscribed: boolean;
     };
+    notificationPrefs: {
+        groupActivity: boolean;
+        jobActivity: boolean;
+        applicationUpdates: boolean;
+        productUpdates: boolean;
+    };
     embedding: {
         vector?: number[] | undefined;
         model?: string | undefined;
@@ -2022,6 +2049,12 @@ declare const UserSchema: yup.ObjectSchema<{
     marketingConsent: {
         subscribed: boolean;
     };
+    notificationPrefs: {
+        groupActivity: boolean;
+        jobActivity: boolean;
+        applicationUpdates: boolean;
+        productUpdates: boolean;
+    };
     embedding: {
         vector: undefined;
         model: undefined;
@@ -2910,4 +2943,4 @@ declare const StudentCompletenessSchema: yup.ObjectSchema<{
     };
 }, "">;
 
-export { AnswerChoiceType, ApplicationReceivePreference, CampaignSchema, CampaignStatus, ChoiceQuestionSchema, Common, CompensationType, CompletenessScoreSchema, ContactTypes, CoordinatorPageLinkSchema, DISPLAY_DATE_FORMAT, DISPLAY_DATE_FORMAT_SHORT, DateStringSchema, DbDefaultSchema, DefaultPaginatedResponse, DefaultPaginationOptions, DefaultUserRoles, DurationSchema, EMPTY_STRING, EducationLevel, EducationSchema, EmployeeCount, EmploymentType, ExperienceLevel, FEEDBACK_MESSAGE_MAX, FeedbackSchema, FeedbackStatus, FeedbackType, GeneraDetailFields, GroupManagedBy, GroupMembershipSchema, GroupMembershipStatus, GroupSchema, GroupStatus, GroupTranslationSchema, GroupVisibility, InputQuestionSchema, JOB_TAXONOMY, JobAlertFrequency, JobCategory, JobIndustry, JobSchema, JobSearchUrgency, JobStatus, JobSubCategory, ListFilterSchema, LocationSchema, MIN_SALARY_LOWER_BOUND, MIN_SALARY_UPPER_BOUND, MailingListSchema, PREFILL_MIRRORED_KEYS, PRIVATE_PROFILE_FIELDS, PageSchema, PageStatus, PageType, type PaginatedResponse, PaginationSchema, PostSchema, PostStatus, type PrefillMirroredKey, type PrivateProfileField, ProficiencyLevel, QuestionSchema, QuestionType, ReadAndAcknowledgeQuestionSchema, RecruiterPageLinkSchema, ReferralSource, ReportReason, ReportSchema, ResourceType, SITEMAP_FORMAT, SYSTEM_DATE_FORMAT, SkillSchema, SocialAccount, SocialAccountSchema, StudentCompletenessSchema, StudyType, SupportedAnswerChoiceTypes, SupportedApplicationReceivePreferences, SupportedCampaignStatuses, SupportedCompensationTypes, SupportedContactTypes, SupportedEducationLevels, SupportedEmployeeCounts, SupportedEmploymentTypes, SupportedExperienceLevels, SupportedFeedbackStatuses, SupportedFeedbackTypes, SupportedJobAlertFrequencies, SupportedJobCategories, SupportedJobIndustries, SupportedJobSearchUrgencies, SupportedJobStatuses, SupportedJobSubCategories, SupportedPageStatuses, SupportedPageTypes, SupportedPostStatuses, SupportedProficiencyLevels, SupportedQuestionTypes, SupportedReferralSources, SupportedReportReasons, SupportedResourceTypes, SupportedSalaryCurrencies, type SupportedSalaryCurrency, SupportedSocialAccounts, SupportedStudyTypes, SupportedUserProfileVisibilities, SupportedUserRoles, SupportedUserStatuses, SupportedWorkModes, TAXONOMY_LABELS, type TChoiceQuestionSchema, type TDurationSchema, type TInputQuestionSchema, type TJobSchema, type TPostSchema, type TQuestionSchema, type TReadAndAcknowledgeQuestionSchema, type TUserIdAndCreatedAtSchema, TermsAcceptedSchema, UserAdditionalInfoSchema, UserCertificationSchema, UserCompletenessSchema, UserCoordinatorProfileSchema, UserDetailType, UserGeneralDetailSchema, UserIdAndCreatedAtSchema, UserInterestSchema, UserJobPreferencesSchema, UserLanguageSchema, type UserProfileOverview, UserProfileVisibility, UserProjectSchema, UserRecruiterProfileSchema, UserRole, UserSchema, UserSkillSchema, UserStatus, WorkExperienceSchema, WorkMode, categoryOfIndustry, categoryOfSubCategory, dateString, deriveIndustry, getSchemaByQuestion, industriesOfCategory, industryOfSubCategory, subCategoriesOfIndustry };
+export { AnswerChoiceType, ApplicationReceivePreference, CampaignSchema, CampaignStatus, ChoiceQuestionSchema, Common, CompensationType, CompletenessScoreSchema, ContactTypes, CoordinatorPageLinkSchema, DISPLAY_DATE_FORMAT, DISPLAY_DATE_FORMAT_SHORT, DateStringSchema, DbDefaultSchema, DefaultPaginatedResponse, DefaultPaginationOptions, DefaultUserRoles, DurationSchema, EMPTY_STRING, EducationLevel, EducationSchema, EmployeeCount, EmploymentType, ExperienceLevel, FEEDBACK_MESSAGE_MAX, FeedbackSchema, FeedbackStatus, FeedbackType, GeneraDetailFields, GroupManagedBy, GroupMembershipSchema, GroupMembershipStatus, GroupSchema, GroupStatus, GroupTranslationSchema, GroupVisibility, InputQuestionSchema, JOB_TAXONOMY, JobAlertFrequency, JobCategory, JobIndustry, JobSchema, JobSearchUrgency, JobStatus, JobSubCategory, ListFilterSchema, LocationSchema, MIN_SALARY_LOWER_BOUND, MIN_SALARY_UPPER_BOUND, MailingListSchema, NotificationChannel, PREFILL_MIRRORED_KEYS, PRIVATE_PROFILE_FIELDS, PageSchema, PageStatus, PageType, type PaginatedResponse, PaginationSchema, PostSchema, PostStatus, type PrefillMirroredKey, type PrivateProfileField, ProficiencyLevel, QuestionSchema, QuestionType, ReadAndAcknowledgeQuestionSchema, RecruiterPageLinkSchema, ReferralSource, ReportReason, ReportSchema, ResourceType, SITEMAP_FORMAT, SYSTEM_DATE_FORMAT, SkillSchema, SocialAccount, SocialAccountSchema, StudentCompletenessSchema, StudyType, SupportedAnswerChoiceTypes, SupportedApplicationReceivePreferences, SupportedCampaignStatuses, SupportedCompensationTypes, SupportedContactTypes, SupportedEducationLevels, SupportedEmployeeCounts, SupportedEmploymentTypes, SupportedExperienceLevels, SupportedFeedbackStatuses, SupportedFeedbackTypes, SupportedJobAlertFrequencies, SupportedJobCategories, SupportedJobIndustries, SupportedJobSearchUrgencies, SupportedJobStatuses, SupportedJobSubCategories, SupportedNotificationChannels, SupportedPageStatuses, SupportedPageTypes, SupportedPostStatuses, SupportedProficiencyLevels, SupportedQuestionTypes, SupportedReferralSources, SupportedReportReasons, SupportedResourceTypes, SupportedSalaryCurrencies, type SupportedSalaryCurrency, SupportedSocialAccounts, SupportedStudyTypes, SupportedUserProfileVisibilities, SupportedUserRoles, SupportedUserStatuses, SupportedWorkModes, TAXONOMY_LABELS, type TChoiceQuestionSchema, type TDurationSchema, type TInputQuestionSchema, type TJobSchema, type TPostSchema, type TQuestionSchema, type TReadAndAcknowledgeQuestionSchema, type TUserIdAndCreatedAtSchema, TermsAcceptedSchema, UserAdditionalInfoSchema, UserCertificationSchema, UserCompletenessSchema, UserCoordinatorProfileSchema, UserDetailType, UserGeneralDetailSchema, UserIdAndCreatedAtSchema, UserInterestSchema, UserJobPreferencesSchema, UserLanguageSchema, type UserProfileOverview, UserProfileVisibility, UserProjectSchema, UserRecruiterProfileSchema, UserRole, UserSchema, UserSkillSchema, UserStatus, WorkExperienceSchema, WorkMode, categoryOfIndustry, categoryOfSubCategory, dateString, deriveIndustry, getSchemaByQuestion, industriesOfCategory, industryOfSubCategory, subCategoriesOfIndustry };

package/dist/index.js

@@ -1985,6 +1985,14 @@ var JobAlertFrequency = /* @__PURE__ */ ((JobAlertFrequency2) => {
   return JobAlertFrequency2;
 })(JobAlertFrequency || {});
 var SupportedJobAlertFrequencies = Object.values(JobAlertFrequency);
+var NotificationChannel = /* @__PURE__ */ ((NotificationChannel2) => {
+  NotificationChannel2["GroupActivity"] = "groupActivity";
+  NotificationChannel2["JobActivity"] = "jobActivity";
+  NotificationChannel2["ApplicationUpdates"] = "applicationUpdates";
+  NotificationChannel2["ProductUpdates"] = "productUpdates";
+  return NotificationChannel2;
+})(NotificationChannel || {});
+var SupportedNotificationChannels = Object.values(NotificationChannel);
 var SupportedSalaryCurrencies = ["USD", "EUR", "GBP", "SEK", "INR"];
 var MIN_SALARY_LOWER_BOUND = 0;
 var MIN_SALARY_UPPER_BOUND = 1e6;
@@ -2510,6 +2518,30 @@ var UserSchema = object33({
      */
     jobAlertFrequency: string31().oneOf(SupportedJobAlertFrequencies).optional().label("Job alert frequency")
   }).default({ subscribed: false }).label("Marketing Consent"),
+  /**
+   * Per-channel toggles for NOTIFICATION email — mail about activity on the
+   * user's own account (a group invite, a job of theirs expiring).
+   *
+   * Deliberately separate from `marketingConsent`, which they must NOT be
+   * collapsed into: the two have different legal footing, which the
+   * email-service footer rules already encode. Notifications are opt-OUT
+   * (default `true`) because a user who declined marketing still needs to hear
+   * that their group invite arrived; marketing stays opt-IN. `productUpdates`
+   * is the exception — it is promotional in character, so it defaults off.
+   *
+   * Transactional mail (magic-link, verification) ignores this object entirely.
+   */
+  notificationPrefs: object33({
+    groupActivity: boolean15().default(true).label("Group activity email"),
+    jobActivity: boolean15().default(true).label("Job activity email"),
+    applicationUpdates: boolean15().default(true).label("Application update email"),
+    productUpdates: boolean15().default(false).label("Product update email")
+  }).default({
+    groupActivity: true,
+    jobActivity: true,
+    applicationUpdates: true,
+    productUpdates: false
+  }).label("Notification Preferences"),
   /**
    * Vector embedding of the user's profile for semantic/hybrid search.
    * Generated from a structured summary of skills, experience, education, etc.
@@ -2595,6 +2627,7 @@ export {
   MIN_SALARY_LOWER_BOUND,
   MIN_SALARY_UPPER_BOUND,
   MailingListSchema,
+  NotificationChannel,
   PREFILL_MIRRORED_KEYS,
   PRIVATE_PROFILE_FIELDS,
   PageSchema,
@@ -2636,6 +2669,7 @@ export {
   SupportedJobSearchUrgencies,
   SupportedJobStatuses,
   SupportedJobSubCategories,
+  SupportedNotificationChannels,
   SupportedPageStatuses,
   SupportedPageTypes,
   SupportedPostStatuses,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thejob/schema",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

package/src/user/user.constant.ts

@@ -97,6 +97,29 @@ export enum JobAlertFrequency {
 
 export const SupportedJobAlertFrequencies = Object.values(JobAlertFrequency);
 
+/**
+ * Channels of NOTIFICATION email — mail about activity on the user's own
+ * account (a group invite, a job of theirs expiring). Distinct from marketing:
+ * notifications are opt-OUT (default on, see `notificationPrefs`), marketing is
+ * opt-IN (`marketingConsent.subscribed`). Transactional mail (magic-link,
+ * verification) is governed by neither and always sends.
+ *
+ * Deliberately coarse: four channels a user will actually reason about, rather
+ * than one toggle per email template.
+ */
+export enum NotificationChannel {
+  /** Group invites, join requests, membership approved/rejected. */
+  GroupActivity = "groupActivity",
+  /** Activity on jobs the user posted, e.g. a listing expiring. */
+  JobActivity = "jobActivity",
+  /** Status changes on jobs the user applied to. */
+  ApplicationUpdates = "applicationUpdates",
+  /** Product announcements and feature news. */
+  ProductUpdates = "productUpdates",
+}
+
+export const SupportedNotificationChannels = Object.values(NotificationChannel);
+
 /** ISO-4217 currency codes accepted for the salary preference (extend as needed). */
 export const SupportedSalaryCurrencies = ["USD", "EUR", "GBP", "SEK", "INR"] as const;
 export type SupportedSalaryCurrency = (typeof SupportedSalaryCurrencies)[number];

package/src/user/user.schema.ts

@@ -141,6 +141,33 @@ export const UserSchema = object({
     .default({ subscribed: false })
     .label("Marketing Consent"),
 
+  /**
+   * Per-channel toggles for NOTIFICATION email — mail about activity on the
+   * user's own account (a group invite, a job of theirs expiring).
+   *
+   * Deliberately separate from `marketingConsent`, which they must NOT be
+   * collapsed into: the two have different legal footing, which the
+   * email-service footer rules already encode. Notifications are opt-OUT
+   * (default `true`) because a user who declined marketing still needs to hear
+   * that their group invite arrived; marketing stays opt-IN. `productUpdates`
+   * is the exception — it is promotional in character, so it defaults off.
+   *
+   * Transactional mail (magic-link, verification) ignores this object entirely.
+   */
+  notificationPrefs: object({
+    groupActivity: boolean().default(true).label("Group activity email"),
+    jobActivity: boolean().default(true).label("Job activity email"),
+    applicationUpdates: boolean().default(true).label("Application update email"),
+    productUpdates: boolean().default(false).label("Product update email"),
+  })
+    .default({
+      groupActivity: true,
+      jobActivity: true,
+      applicationUpdates: true,
+      productUpdates: false,
+    })
+    .label("Notification Preferences"),
+
   /**
    * Vector embedding of the user's profile for semantic/hybrid search.
    * Generated from a structured summary of skills, experience, education, etc.