@thejob/schema 2.0.10 → 2.1.1

package/dist/index.cjs

@@ -64,6 +64,7 @@ __export(index_exports, {
   GroupVisibility: () => GroupVisibility,
   InputQuestionSchema: () => InputQuestionSchema,
   JOB_TAXONOMY: () => JOB_TAXONOMY,
+  JobAlertFrequency: () => JobAlertFrequency,
   JobCategory: () => JobCategory,
   JobIndustry: () => JobIndustry,
   JobSchema: () => JobSchema,
@@ -108,6 +109,7 @@ __export(index_exports, {
   SupportedEmployeeCounts: () => SupportedEmployeeCounts,
   SupportedEmploymentTypes: () => SupportedEmploymentTypes,
   SupportedExperienceLevels: () => SupportedExperienceLevels,
+  SupportedJobAlertFrequencies: () => SupportedJobAlertFrequencies,
   SupportedJobCategories: () => SupportedJobCategories,
   SupportedJobIndustries: () => SupportedJobIndustries,
   SupportedJobSearchUrgencies: () => SupportedJobSearchUrgencies,
@@ -2140,6 +2142,13 @@ var ReferralSource = /* @__PURE__ */ ((ReferralSource2) => {
   return ReferralSource2;
 })(ReferralSource || {});
 var SupportedReferralSources = Object.values(ReferralSource);
+var JobAlertFrequency = /* @__PURE__ */ ((JobAlertFrequency2) => {
+  JobAlertFrequency2["Off"] = "off";
+  JobAlertFrequency2["Daily"] = "daily";
+  JobAlertFrequency2["Weekly"] = "weekly";
+  return JobAlertFrequency2;
+})(JobAlertFrequency || {});
+var SupportedJobAlertFrequencies = Object.values(JobAlertFrequency);
 var SupportedSalaryCurrencies = ["USD", "EUR", "GBP", "SEK", "INR"];
 var MIN_SALARY_LOWER_BOUND = 0;
 var MIN_SALARY_UPPER_BOUND = 1e6;
@@ -2609,6 +2618,30 @@ var UserSchema = (0, import_yup35.object)({
    * Roles assigned to the user
    */
   roles: (0, import_yup35.array)().of((0, import_yup35.string)().oneOf(SupportedUserRoles)).required().default(DefaultUserRoles).label("Roles"),
+  /**
+   * Explicit consent to receive marketing email (newsletters, job alerts by
+   * broadcast, product updates). Marketing sends are HARD-GATED on
+   * `subscribed === true`: a user with no consent (existing users, anyone who
+   * hasn't finished onboarding) is NOT a valid marketing recipient. Transactional
+   * mail (verification, magic-link, account) is unaffected — it is not marketing.
+   *
+   * Captured at onboarding and flippable by the user; a one-click / footer
+   * unsubscribe sets `subscribed=false` so consent and the email-service
+   * suppression list stay consistent. Defaults to NOT subscribed (opt-in).
+   */
+  marketingConsent: (0, import_yup35.object)({
+    subscribed: (0, import_yup35.boolean)().default(false).label("Subscribed to marketing email"),
+    /** Epoch ms of the last consent change (opt-in or opt-out). */
+    updatedAt: (0, import_yup35.number)().optional().label("Consent updated at"),
+    /** Where the consent change originated, e.g. `onboarding`, `unsubscribe`, `settings`. */
+    source: (0, import_yup35.string)().optional().label("Consent source"),
+    /**
+     * How often the user receives job-alert emails. `off` disables job alerts
+     * only; other marketing stays governed by `subscribed`. Unset means the
+     * user has not chosen a cadence yet.
+     */
+    jobAlertFrequency: (0, import_yup35.string)().oneOf(SupportedJobAlertFrequencies).optional().label("Job alert frequency")
+  }).default({ subscribed: false }).label("Marketing Consent"),
   /**
    * Vector embedding of the user's profile for semantic/hybrid search.
    * Generated from a structured summary of skills, experience, education, etc.
@@ -2679,6 +2712,7 @@ var StudentCompletenessSchema = UserCompletenessSchema.omit([
   GroupVisibility,
   InputQuestionSchema,
   JOB_TAXONOMY,
+  JobAlertFrequency,
   JobCategory,
   JobIndustry,
   JobSchema,
@@ -2723,6 +2757,7 @@ var StudentCompletenessSchema = UserCompletenessSchema.omit([
   SupportedEmployeeCounts,
   SupportedEmploymentTypes,
   SupportedExperienceLevels,
+  SupportedJobAlertFrequencies,
   SupportedJobCategories,
   SupportedJobIndustries,
   SupportedJobSearchUrgencies,

package/dist/index.d.cts

@@ -1640,6 +1640,17 @@ declare enum ReferralSource {
     Other = "other"
 }
 declare const SupportedReferralSources: ReferralSource[];
+/**
+ * How often a subscribed user receives job-alert emails. `Off` disables job
+ * alerts specifically while leaving other marketing (newsletters, product
+ * updates) governed by `marketingConsent.subscribed`.
+ */
+declare enum JobAlertFrequency {
+    Off = "off",
+    Daily = "daily",
+    Weekly = "weekly"
+}
+declare const SupportedJobAlertFrequencies: JobAlertFrequency[];
 /** 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];
@@ -1768,6 +1779,12 @@ declare const UserSchema: yup.ObjectSchema<{
     }[];
     status: NonNullable<UserStatus | undefined>;
     roles: (UserRole | undefined)[];
+    marketingConsent: {
+        updatedAt?: number | undefined;
+        source?: string | undefined;
+        jobAlertFrequency?: JobAlertFrequency | undefined;
+        subscribed: boolean;
+    };
     embedding: {
         vector?: number[] | undefined;
         model?: string | undefined;
@@ -1964,6 +1981,9 @@ declare const UserSchema: yup.ObjectSchema<{
     additionalInfo: never[];
     status: undefined;
     roles: UserRole[];
+    marketingConsent: {
+        subscribed: boolean;
+    };
     embedding: {
         vector: undefined;
         model: undefined;
@@ -2852,4 +2872,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, GeneraDetailFields, GroupManagedBy, GroupMembershipSchema, GroupMembershipStatus, GroupSchema, GroupStatus, GroupTranslationSchema, GroupVisibility, InputQuestionSchema, JOB_TAXONOMY, 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, 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, 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, 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 };

package/dist/index.d.ts

@@ -1640,6 +1640,17 @@ declare enum ReferralSource {
     Other = "other"
 }
 declare const SupportedReferralSources: ReferralSource[];
+/**
+ * How often a subscribed user receives job-alert emails. `Off` disables job
+ * alerts specifically while leaving other marketing (newsletters, product
+ * updates) governed by `marketingConsent.subscribed`.
+ */
+declare enum JobAlertFrequency {
+    Off = "off",
+    Daily = "daily",
+    Weekly = "weekly"
+}
+declare const SupportedJobAlertFrequencies: JobAlertFrequency[];
 /** 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];
@@ -1768,6 +1779,12 @@ declare const UserSchema: yup.ObjectSchema<{
     }[];
     status: NonNullable<UserStatus | undefined>;
     roles: (UserRole | undefined)[];
+    marketingConsent: {
+        updatedAt?: number | undefined;
+        source?: string | undefined;
+        jobAlertFrequency?: JobAlertFrequency | undefined;
+        subscribed: boolean;
+    };
     embedding: {
         vector?: number[] | undefined;
         model?: string | undefined;
@@ -1964,6 +1981,9 @@ declare const UserSchema: yup.ObjectSchema<{
     additionalInfo: never[];
     status: undefined;
     roles: UserRole[];
+    marketingConsent: {
+        subscribed: boolean;
+    };
     embedding: {
         vector: undefined;
         model: undefined;
@@ -2852,4 +2872,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, GeneraDetailFields, GroupManagedBy, GroupMembershipSchema, GroupMembershipStatus, GroupSchema, GroupStatus, GroupTranslationSchema, GroupVisibility, InputQuestionSchema, JOB_TAXONOMY, 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, 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, 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, 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 };

package/dist/index.js

@@ -1978,6 +1978,13 @@ var ReferralSource = /* @__PURE__ */ ((ReferralSource2) => {
   return ReferralSource2;
 })(ReferralSource || {});
 var SupportedReferralSources = Object.values(ReferralSource);
+var JobAlertFrequency = /* @__PURE__ */ ((JobAlertFrequency2) => {
+  JobAlertFrequency2["Off"] = "off";
+  JobAlertFrequency2["Daily"] = "daily";
+  JobAlertFrequency2["Weekly"] = "weekly";
+  return JobAlertFrequency2;
+})(JobAlertFrequency || {});
+var SupportedJobAlertFrequencies = Object.values(JobAlertFrequency);
 var SupportedSalaryCurrencies = ["USD", "EUR", "GBP", "SEK", "INR"];
 var MIN_SALARY_LOWER_BOUND = 0;
 var MIN_SALARY_UPPER_BOUND = 1e6;
@@ -2145,7 +2152,7 @@ var ReportSchema = object20({
 }).label("Report Schema");
 
 // src/user/user.schema.ts
-import { array as array14, number as number10, object as object32, string as string30 } from "yup";
+import { array as array14, boolean as boolean15, number as number10, object as object32, string as string30 } from "yup";
 
 // src/user/work-experience.schema.ts
 import { boolean as boolean12, object as object21, string as string18 } from "yup";
@@ -2447,6 +2454,30 @@ var UserSchema = object32({
    * Roles assigned to the user
    */
   roles: array14().of(string30().oneOf(SupportedUserRoles)).required().default(DefaultUserRoles).label("Roles"),
+  /**
+   * Explicit consent to receive marketing email (newsletters, job alerts by
+   * broadcast, product updates). Marketing sends are HARD-GATED on
+   * `subscribed === true`: a user with no consent (existing users, anyone who
+   * hasn't finished onboarding) is NOT a valid marketing recipient. Transactional
+   * mail (verification, magic-link, account) is unaffected — it is not marketing.
+   *
+   * Captured at onboarding and flippable by the user; a one-click / footer
+   * unsubscribe sets `subscribed=false` so consent and the email-service
+   * suppression list stay consistent. Defaults to NOT subscribed (opt-in).
+   */
+  marketingConsent: object32({
+    subscribed: boolean15().default(false).label("Subscribed to marketing email"),
+    /** Epoch ms of the last consent change (opt-in or opt-out). */
+    updatedAt: number10().optional().label("Consent updated at"),
+    /** Where the consent change originated, e.g. `onboarding`, `unsubscribe`, `settings`. */
+    source: string30().optional().label("Consent source"),
+    /**
+     * How often the user receives job-alert emails. `off` disables job alerts
+     * only; other marketing stays governed by `subscribed`. Unset means the
+     * user has not chosen a cadence yet.
+     */
+    jobAlertFrequency: string30().oneOf(SupportedJobAlertFrequencies).optional().label("Job alert frequency")
+  }).default({ subscribed: false }).label("Marketing Consent"),
   /**
    * Vector embedding of the user's profile for semantic/hybrid search.
    * Generated from a structured summary of skills, experience, education, etc.
@@ -2516,6 +2547,7 @@ export {
   GroupVisibility,
   InputQuestionSchema,
   JOB_TAXONOMY,
+  JobAlertFrequency,
   JobCategory,
   JobIndustry,
   JobSchema,
@@ -2560,6 +2592,7 @@ export {
   SupportedEmployeeCounts,
   SupportedEmploymentTypes,
   SupportedExperienceLevels,
+  SupportedJobAlertFrequencies,
   SupportedJobCategories,
   SupportedJobIndustries,
   SupportedJobSearchUrgencies,

package/package.json

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

package/src/user/user.constant.ts

@@ -84,6 +84,19 @@ export enum ReferralSource {
 
 export const SupportedReferralSources = Object.values(ReferralSource);
 
+/**
+ * How often a subscribed user receives job-alert emails. `Off` disables job
+ * alerts specifically while leaving other marketing (newsletters, product
+ * updates) governed by `marketingConsent.subscribed`.
+ */
+export enum JobAlertFrequency {
+  Off = "off",
+  Daily = "daily",
+  Weekly = "weekly",
+}
+
+export const SupportedJobAlertFrequencies = Object.values(JobAlertFrequency);
+
 /** 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

@@ -1,7 +1,8 @@
-import { array, number, object, string } from "yup";
+import { array, boolean, number, object, string } from "yup";
 
 import {
   DefaultUserRoles,
+  SupportedJobAlertFrequencies,
   SupportedUserRoles,
   SupportedUserStatuses,
 } from "./user.constant.js";
@@ -110,6 +111,36 @@ export const UserSchema = object({
     .default(DefaultUserRoles)
     .label("Roles"),
 
+  /**
+   * Explicit consent to receive marketing email (newsletters, job alerts by
+   * broadcast, product updates). Marketing sends are HARD-GATED on
+   * `subscribed === true`: a user with no consent (existing users, anyone who
+   * hasn't finished onboarding) is NOT a valid marketing recipient. Transactional
+   * mail (verification, magic-link, account) is unaffected — it is not marketing.
+   *
+   * Captured at onboarding and flippable by the user; a one-click / footer
+   * unsubscribe sets `subscribed=false` so consent and the email-service
+   * suppression list stay consistent. Defaults to NOT subscribed (opt-in).
+   */
+  marketingConsent: object({
+    subscribed: boolean().default(false).label("Subscribed to marketing email"),
+    /** Epoch ms of the last consent change (opt-in or opt-out). */
+    updatedAt: number().optional().label("Consent updated at"),
+    /** Where the consent change originated, e.g. `onboarding`, `unsubscribe`, `settings`. */
+    source: string().optional().label("Consent source"),
+    /**
+     * How often the user receives job-alert emails. `off` disables job alerts
+     * only; other marketing stays governed by `subscribed`. Unset means the
+     * user has not chosen a cadence yet.
+     */
+    jobAlertFrequency: string()
+      .oneOf(SupportedJobAlertFrequencies)
+      .optional()
+      .label("Job alert frequency"),
+  })
+    .default({ subscribed: false })
+    .label("Marketing Consent"),
+
   /**
    * Vector embedding of the user's profile for semantic/hybrid search.
    * Generated from a structured summary of skills, experience, education, etc.