@thejob/schema 2.1.1 → 2.1.3

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;
@@ -2151,55 +2159,87 @@ var ReportSchema = object20({
   comment: string17().max(1e3).optional().label("Comment")
 }).label("Report Schema");
 
+// src/feedback/feedback.schema.ts
+import { mixed as mixed5, object as object21, string as string18 } from "yup";
+
+// src/feedback/feedback.constant.ts
+var FeedbackType = /* @__PURE__ */ ((FeedbackType3) => {
+  FeedbackType3["Bug"] = "bug";
+  FeedbackType3["Feature"] = "feature";
+  FeedbackType3["Suggestion"] = "suggestion";
+  FeedbackType3["Report"] = "report";
+  FeedbackType3["Other"] = "other";
+  return FeedbackType3;
+})(FeedbackType || {});
+var SupportedFeedbackTypes = Object.values(FeedbackType);
+var FeedbackStatus = /* @__PURE__ */ ((FeedbackStatus3) => {
+  FeedbackStatus3["New"] = "new";
+  FeedbackStatus3["InReview"] = "in_review";
+  FeedbackStatus3["Resolved"] = "resolved";
+  FeedbackStatus3["Archived"] = "archived";
+  return FeedbackStatus3;
+})(FeedbackStatus || {});
+var SupportedFeedbackStatuses = Object.values(FeedbackStatus);
+var FEEDBACK_MESSAGE_MAX = 4e3;
+
+// src/feedback/feedback.schema.ts
+var FeedbackSchema = object21({
+  type: mixed5().oneOf(SupportedFeedbackTypes).required().label("Type"),
+  message: string18().trim().required("Please enter a message").max(FEEDBACK_MESSAGE_MAX).label("Message"),
+  email: string18().email().optional().label("Email"),
+  pageUrl: string18().optional().label("Page URL"),
+  status: mixed5().oneOf(SupportedFeedbackStatuses).optional().label("Status")
+}).label("Feedback Schema");
+
 // src/user/user.schema.ts
-import { array as array14, boolean as boolean15, number as number10, object as object32, string as string30 } from "yup";
+import { array as array14, boolean as boolean15, number as number10, object as object33, string as string31 } from "yup";
 
 // src/user/work-experience.schema.ts
-import { boolean as boolean12, object as object21, string as string18 } from "yup";
-var WorkExperienceSchema = object21().shape({
+import { boolean as boolean12, object as object22, string as string19 } from "yup";
+var WorkExperienceSchema = object22().shape({
   company: PageSchema.pick(["name", "slug", "type", "logo"]).deepPartial().concat(PageSchema.pick(["name", "type"])).required().label("Company"),
-  designation: string18().trim().required().label("Designation"),
+  designation: string19().trim().required().label("Designation"),
   duration: DurationSchema({
     format: "YYYY-MM",
     startLabel: "Start Date",
     endLabel: "End Date"
   }).required().label("Duration"),
-  description: string18().trim().max(3e3).optional().label("Description"),
+  description: string19().trim().max(3e3).optional().label("Description"),
   location: LocationSchema.required().label("Location"),
   isRemote: boolean12().oneOf([true, false]).default(false).label("Is Remote")
 }).noUnknown().strict().label("Work Experience");
 
 // src/user/education.schema.ts
-import { boolean as boolean13, object as object22, string as string19 } from "yup";
-var EducationSchema = object22({
+import { boolean as boolean13, object as object23, string as string20 } from "yup";
+var EducationSchema = object23({
   institute: PageSchema.pick(["name", "slug", "type", "logo"]).deepPartial().concat(PageSchema.pick(["name", "type"])).required().label("Institute"),
-  course: string19().trim().required().label("Course"),
-  fieldOfStudy: string19().trim().required().label("Field of Study"),
+  course: string20().trim().required().label("Course"),
+  fieldOfStudy: string20().trim().required().label("Field of Study"),
   duration: DurationSchema({
     format: "YYYY-MM",
     startLabel: "Start Date",
     endLabel: "End Date"
   }).required().label("Duration"),
-  description: string19().trim().max(3e3).optional().label("Description"),
+  description: string20().trim().max(3e3).optional().label("Description"),
   isDistanceLearning: boolean13().default(false).label("Is Distance Learning"),
   location: LocationSchema.required().label("Location"),
-  studyType: string19().oneOf(SupportedStudyTypes).trim().max(50).required().label("Study Type")
+  studyType: string20().oneOf(SupportedStudyTypes).trim().max(50).required().label("Study Type")
 }).noUnknown().strict().label("Education");
 
 // src/user/user-skill.schema.ts
-import { object as object23, string as string20 } from "yup";
-var UserSkillSchema = object23({
-  name: string20().required().label("Name"),
-  proficiencyLevel: string20().oneOf(SupportedProficiencyLevels).required().label("Proficiency Level"),
+import { object as object24, string as string21 } from "yup";
+var UserSkillSchema = object24({
+  name: string21().required().label("Name"),
+  proficiencyLevel: string21().oneOf(SupportedProficiencyLevels).required().label("Proficiency Level"),
   lastUsed: dateString().format("YYYY-MM").nullable().optional().label("Last Used")
 }).noUnknown().strict().label("Skill");
 
 // src/user/project.schema.ts
-import { object as object24, string as string21 } from "yup";
-var UserProjectSchema = object24({
-  name: string21().trim().max(50).required().label("Name"),
-  url: string21().optional().label("URL"),
-  description: string21().trim().min(100).max(3e3).required().label("Description"),
+import { object as object25, string as string22 } from "yup";
+var UserProjectSchema = object25({
+  name: string22().trim().max(50).required().label("Name"),
+  url: string22().optional().label("URL"),
+  description: string22().trim().min(100).max(3e3).required().label("Description"),
   duration: DurationSchema({
     format: "YYYY-MM",
     startLabel: "Start Date",
@@ -2208,65 +2248,65 @@ var UserProjectSchema = object24({
 }).noUnknown().strict().label("Project");
 
 // src/user/user-certification.schema.ts
-import { object as object25, string as string22 } from "yup";
-var UserCertificationSchema = object25({
-  name: string22().trim().max(100).required().label("Name"),
+import { object as object26, string as string23 } from "yup";
+var UserCertificationSchema = object26({
+  name: string23().trim().max(100).required().label("Name"),
   // TODO: Add validation for authority
-  authority: string22().trim().max(100).required().label("Authority"),
-  licenseNumber: string22().trim().max(50).optional().label("License Number"),
+  authority: string23().trim().max(100).required().label("Authority"),
+  licenseNumber: string23().trim().max(50).optional().label("License Number"),
   duration: DurationSchema({
     format: "YYYY-MM",
     startLabel: "Start Date",
     endLabel: "End Date"
   }).optional().nullable().label("Duration"),
-  url: string22().optional().label("URL")
+  url: string23().optional().label("URL")
 }).noUnknown().strict().label("Certification");
 
 // src/user/user-interest.schema.ts
-import { string as string23 } from "yup";
-var UserInterestSchema = string23().trim().required().label("Interest");
+import { string as string24 } from "yup";
+var UserInterestSchema = string24().trim().required().label("Interest");
 
 // src/user/user-language.schema.ts
-import { object as object26, string as string24 } from "yup";
-var UserLanguageSchema = object26({
-  name: string24().trim().required().label("Name"),
-  proficiencyLevel: string24().oneOf(SupportedProficiencyLevels).trim().max(50).required().label("Proficiency Level")
+import { object as object27, string as string25 } from "yup";
+var UserLanguageSchema = object27({
+  name: string25().trim().required().label("Name"),
+  proficiencyLevel: string25().oneOf(SupportedProficiencyLevels).trim().max(50).required().label("Proficiency Level")
 }).noUnknown().strict().label("Language");
 
 // src/user/user-additional-info.schema.ts
-import { object as object27, string as string25 } from "yup";
-var UserAdditionalInfoSchema = object27({
-  title: string25().trim().max(60).required().label("Title"),
-  description: string25().trim().max(1e3).required().label("Description")
+import { object as object28, string as string26 } from "yup";
+var UserAdditionalInfoSchema = object28({
+  title: string26().trim().max(60).required().label("Title"),
+  description: string26().trim().max(1e3).required().label("Description")
 }).noUnknown().strict().label("User Additional Info");
 
 // src/user/general-detail.schema.ts
-import { object as object28, string as string26 } from "yup";
-var UserGeneralDetailSchema = object28({
-  id: string26().optional().label("ID"),
-  name: object28().shape({
-    first: string26().trim().max(50).required().label("First Name"),
-    last: string26().trim().max(50).optional().label("Last Name")
+import { object as object29, string as string27 } from "yup";
+var UserGeneralDetailSchema = object29({
+  id: string27().optional().label("ID"),
+  name: object29().shape({
+    first: string27().trim().max(50).required().label("First Name"),
+    last: string27().trim().max(50).optional().label("Last Name")
   }).required().label("Name"),
-  headline: string26().trim().max(200).optional().label("Headline"),
-  image: string26().optional().label("Image"),
-  aboutMe: string26().trim().max(3e3).optional().label("About Me"),
-  email: string26().required().label("Email"),
-  mobile: string26().nullable().optional().label("Mobile"),
-  emailVerified: string26().nullable().optional().label("Email Verified"),
-  mobileVerified: string26().nullable().optional().label("Mobile Verified"),
-  experienceLevel: string26().oneOf(SupportedExperienceLevels).required().label("Experience level"),
+  headline: string27().trim().max(200).optional().label("Headline"),
+  image: string27().optional().label("Image"),
+  aboutMe: string27().trim().max(3e3).optional().label("About Me"),
+  email: string27().required().label("Email"),
+  mobile: string27().nullable().optional().label("Mobile"),
+  emailVerified: string27().nullable().optional().label("Email Verified"),
+  mobileVerified: string27().nullable().optional().label("Mobile Verified"),
+  experienceLevel: string27().oneOf(SupportedExperienceLevels).required().label("Experience level"),
   location: LocationSchema.required().label("Location"),
-  region: object28().shape({
-    country: string26().trim().required().label("Region Country"),
-    lang: string26().trim().required().label("Region Language")
+  region: object29().shape({
+    country: string27().trim().required().label("Region Country"),
+    lang: string27().trim().required().label("Region Language")
   }).optional().default(void 0).label("Region"),
-  profileVisibility: string26().oneOf(SupportedUserProfileVisibilities).default("public" /* Public */).label("Profile Visibility")
+  profileVisibility: string27().oneOf(SupportedUserProfileVisibilities).default("public" /* Public */).label("Profile Visibility")
 }).noUnknown().strict().label("General Detail");
 
 // src/user/user-job-preferences.schema.ts
-import { array as array11, boolean as boolean14, date as date2, number as number9, object as object29, string as string27 } from "yup";
-var UserJobPreferencesSchema = object29({
+import { array as array11, boolean as boolean14, date as date2, number as number9, object as object30, string as string28 } from "yup";
+var UserJobPreferencesSchema = object30({
   /**
    * Whether the job seeker is openly signalling availability. Surfaces the
    * "Open to work" badge on the public profile and boosts visibility in
@@ -2278,7 +2318,7 @@ var UserJobPreferencesSchema = object29({
    * and can downgrade the visibility of expired or low-relevance postings for
    * users in `passively_browsing` mode.
    */
-  jobSearchUrgency: string27().oneOf(SupportedJobSearchUrgencies).required().label("Job Search Urgency"),
+  jobSearchUrgency: string28().oneOf(SupportedJobSearchUrgencies).required().label("Job Search Urgency"),
   /**
    * Locations the user wants to work in. Stores the full `LocationSchema`
    * shape (country, city, state, geo, etc.) as returned by the locations
@@ -2295,7 +2335,7 @@ var UserJobPreferencesSchema = object29({
    * Both reuse the same `ExperienceLevel` taxonomy from `common.constant.ts`
    * so search/match logic doesn't have to translate between two vocabularies.
    */
-  targetExperienceLevels: array11().of(string27().oneOf(SupportedExperienceLevels).required()).min(1, "Pick at least one experience level.").max(2, "You can select at most 2 experience levels.").required().label("Target Experience Levels"),
+  targetExperienceLevels: array11().of(string28().oneOf(SupportedExperienceLevels).required()).min(1, "Pick at least one experience level.").max(2, "You can select at most 2 experience levels.").required().label("Target Experience Levels"),
   /**
    * Specializations the user is searching for - free-form titles.
    *
@@ -2304,7 +2344,7 @@ var UserJobPreferencesSchema = object29({
    * surfaces a curated "Popular Roles" picker for discovery, but the user
    * can ultimately add any title; matching/normalization happens downstream.
    */
-  jobRoles: array11().of(string27().trim().max(120).required()).min(1, "Pick at least one role.").required().label("Job Roles"),
+  jobRoles: array11().of(string28().trim().max(120).required()).min(1, "Pick at least one role.").required().label("Job Roles"),
   /**
    * Minimum acceptable annual base salary, in `minSalaryCurrency`.
    * Stored as an integer in the currency's major unit (e.g. dollars, not cents).
@@ -2312,11 +2352,11 @@ var UserJobPreferencesSchema = object29({
    * has a floor, even if it's zero.
    */
   minSalary: number9().integer().min(MIN_SALARY_LOWER_BOUND).max(MIN_SALARY_UPPER_BOUND).default(0).required().label("Minimum Salary"),
-  minSalaryCurrency: string27().oneOf(SupportedSalaryCurrencies).default("USD").required().label("Minimum Salary Currency"),
+  minSalaryCurrency: string28().oneOf(SupportedSalaryCurrencies).default("USD").required().label("Minimum Salary Currency"),
   /**
    * Marketing-attribution capture from the final onboarding step.
    */
-  referralSource: string27().oneOf(SupportedReferralSources).required().label("Referral Source"),
+  referralSource: string28().oneOf(SupportedReferralSources).required().label("Referral Source"),
   /**
    * Resumes the user has uploaded. Embedded directly on the user document
    * (capped at 5) - they're cheap to denormalize, every wizard step that
@@ -2331,15 +2371,15 @@ var UserJobPreferencesSchema = object29({
    * live in their own collection.
    */
   resumes: array11().of(
-    object29({
+    object30({
       // Stable id assigned on upload - used to address a specific entry
       // for delete / set-primary operations without exposing the GCS URL
       // as a route key.
-      id: string27().required().label("ID"),
-      url: string27().required().label("Resume URL"),
-      filename: string27().trim().max(255).optional().label("Filename"),
+      id: string28().required().label("ID"),
+      url: string28().required().label("Resume URL"),
+      filename: string28().trim().max(255).optional().label("Filename"),
       sizeBytes: number9().integer().min(0).optional().label("Size (bytes)"),
-      mimeType: string27().trim().max(120).optional().label("MIME Type"),
+      mimeType: string28().trim().max(120).optional().label("MIME Type"),
       uploadedAt: date2().required().label("Uploaded At"),
       isPrimary: boolean14().default(false).label("Is Primary")
     }).noUnknown().strict().label("Resume")
@@ -2368,12 +2408,12 @@ var UserJobPreferencesSchema = object29({
    *   APIs. If `user.<field>` is empty there, the correct behavior is empty,
    *   because the user has not confirmed it yet.
    */
-  pendingPrefill: object29({
-    headline: string27().trim().optional().label("Pending Headline"),
-    aboutMe: string27().trim().optional().label("Pending About Me"),
-    mobile: string27().trim().optional().label("Pending Mobile"),
+  pendingPrefill: object30({
+    headline: string28().trim().optional().label("Pending Headline"),
+    aboutMe: string28().trim().optional().label("Pending About Me"),
+    mobile: string28().trim().optional().label("Pending Mobile"),
     location: LocationSchema.optional().default(void 0).label("Pending Location"),
-    experienceLevel: string27().oneOf(SupportedExperienceLevels).optional().label("Pending Experience Level"),
+    experienceLevel: string28().oneOf(SupportedExperienceLevels).optional().label("Pending Experience Level"),
     socialAccounts: array11().of(SocialAccountSchema.required()).optional().label("Pending Social Accounts"),
     workExperiences: array11().of(WorkExperienceSchema.required()).optional().label("Pending Work Experiences"),
     educations: array11().of(EducationSchema.required()).optional().label("Pending Educations")
@@ -2381,35 +2421,35 @@ var UserJobPreferencesSchema = object29({
 }).noUnknown().strict().label("User Job Preferences Schema");
 
 // src/user/user-recruiter-profile.schema.ts
-import { array as array12, object as object30, string as string28 } from "yup";
-var RecruiterPageLinkSchema = object30({
+import { array as array12, object as object31, string as string29 } from "yup";
+var RecruiterPageLinkSchema = object31({
   page: PageSchema.pick(["name", "slug", "type", "logo"]).deepPartial().concat(PageSchema.pick(["name", "type"])).required().label("Company Page"),
-  jobTitle: string28().trim().max(100).optional().label("Job Title")
+  jobTitle: string29().trim().max(100).optional().label("Job Title")
 }).noUnknown().strict().label("Recruiter Page Link");
-var UserRecruiterProfileSchema = object30({
-  recruiterProfile: object30({
+var UserRecruiterProfileSchema = object31({
+  recruiterProfile: object31({
     hiringFor: array12().of(RecruiterPageLinkSchema).default([]).label("Hiring For")
   }).optional().default(void 0).label("Recruiter Profile")
 }).noUnknown().strict().label("User Recruiter Profile");
 
 // src/user/user-coordinator-profile.schema.ts
-import { array as array13, object as object31, string as string29 } from "yup";
-var CoordinatorPageLinkSchema = object31({
+import { array as array13, object as object32, string as string30 } from "yup";
+var CoordinatorPageLinkSchema = object32({
   page: PageSchema.pick(["name", "slug", "type", "logo"]).deepPartial().concat(PageSchema.pick(["name", "type"])).required().label("Institute Page"),
-  jobTitle: string29().trim().max(100).optional().label("Job Title")
+  jobTitle: string30().trim().max(100).optional().label("Job Title")
 }).noUnknown().strict().label("Coordinator Page Link");
-var UserCoordinatorProfileSchema = object31({
-  coordinatorProfile: object31({
+var UserCoordinatorProfileSchema = object32({
+  coordinatorProfile: object32({
     coordinatesAt: array13().of(CoordinatorPageLinkSchema).default([]).label("Coordinates At")
   }).optional().default(void 0).label("Coordinator Profile")
 }).noUnknown().strict().label("User Coordinator Profile");
 
 // src/user/user.schema.ts
-var UserSchema = object32({
+var UserSchema = object33({
   /**
    * Related auth account id from auth Server (e.g. Better auth https://auth.thejob.dev)
    */
-  authAccountId: string30().required().label("Auth Account ID"),
+  authAccountId: string31().required().label("Auth Account ID"),
   /**
    * Social media information about the user (e.g. LinkedIn, GitHub, etc.)
    */
@@ -2449,11 +2489,11 @@ var UserSchema = object32({
   /**
    * Status of the user account
    */
-  status: string30().oneOf(SupportedUserStatuses).required().label("Status"),
+  status: string31().oneOf(SupportedUserStatuses).required().label("Status"),
   /**
    * Roles assigned to the user
    */
-  roles: array14().of(string30().oneOf(SupportedUserRoles)).required().default(DefaultUserRoles).label("Roles"),
+  roles: array14().of(string31().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
@@ -2465,33 +2505,57 @@ var UserSchema = object32({
    * unsubscribe sets `subscribed=false` so consent and the email-service
    * suppression list stay consistent. Defaults to NOT subscribed (opt-in).
    */
-  marketingConsent: object32({
+  marketingConsent: object33({
     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"),
+    source: string31().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")
+    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.
    * Only generated for public profiles with sufficient completeness (≥60%).
    */
-  embedding: object32({
+  embedding: object33({
     vector: array14(number10().required()).optional().label("Embedding vector"),
-    model: string30().optional().label("Embedding model")
+    model: string31().optional().label("Embedding model")
   }).nullable().optional().label("Embedding")
 }).concat(UserGeneralDetailSchema).concat(UserJobPreferencesSchema).concat(UserRecruiterProfileSchema).concat(UserCoordinatorProfileSchema).noUnknown().strict().label("User Schema");
 
 // src/user/user-completeness.schema.ts
-import { object as object33 } from "yup";
-var UserCompletenessSchema = object33({
+import { object as object34 } from "yup";
+var UserCompletenessSchema = object34({
   additionalInfo: CompletenessScoreSchema(0).label("Additional Info"),
   // Optional
   certifications: CompletenessScoreSchema(0).label("Certifications"),
@@ -2537,6 +2601,10 @@ export {
   EmployeeCount,
   EmploymentType,
   ExperienceLevel,
+  FEEDBACK_MESSAGE_MAX,
+  FeedbackSchema,
+  FeedbackStatus,
+  FeedbackType,
   GeneraDetailFields,
   GroupManagedBy,
   GroupMembershipSchema,
@@ -2559,6 +2627,7 @@ export {
   MIN_SALARY_LOWER_BOUND,
   MIN_SALARY_UPPER_BOUND,
   MailingListSchema,
+  NotificationChannel,
   PREFILL_MIRRORED_KEYS,
   PRIVATE_PROFILE_FIELDS,
   PageSchema,
@@ -2592,12 +2661,15 @@ export {
   SupportedEmployeeCounts,
   SupportedEmploymentTypes,
   SupportedExperienceLevels,
+  SupportedFeedbackStatuses,
+  SupportedFeedbackTypes,
   SupportedJobAlertFrequencies,
   SupportedJobCategories,
   SupportedJobIndustries,
   SupportedJobSearchUrgencies,
   SupportedJobStatuses,
   SupportedJobSubCategories,
+  SupportedNotificationChannels,
   SupportedPageStatuses,
   SupportedPageTypes,
   SupportedPostStatuses,

package/package.json

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

package/src/feedback/feedback.constant.ts

@@ -0,0 +1,21 @@
+export enum FeedbackType {
+  Bug = "bug",
+  Feature = "feature",
+  Suggestion = "suggestion",
+  Report = "report",
+  Other = "other",
+}
+
+export const SupportedFeedbackTypes = Object.values(FeedbackType);
+
+export enum FeedbackStatus {
+  New = "new",
+  InReview = "in_review",
+  Resolved = "resolved",
+  Archived = "archived",
+}
+
+export const SupportedFeedbackStatuses = Object.values(FeedbackStatus);
+
+/** Max length of a feedback message body (enforced client + server). */
+export const FEEDBACK_MESSAGE_MAX = 4000;

package/src/feedback/feedback.schema.ts

@@ -0,0 +1,32 @@
+import { mixed, object, string } from "yup";
+import {
+  FEEDBACK_MESSAGE_MAX,
+  FeedbackStatus,
+  FeedbackType,
+  SupportedFeedbackStatuses,
+  SupportedFeedbackTypes,
+} from "./feedback.constant.js";
+
+/**
+ * A user-submitted feedback / report record (bug, feature request, suggestion,
+ * abuse report, …) captured by the app-wide feedback widget and stored by
+ * common-service. `email` is an optional reply-to for signed-out submitters;
+ * the rest of the identity/diagnostic fields are attached server-side.
+ */
+export const FeedbackSchema = object({
+  type: mixed<FeedbackType>()
+    .oneOf(SupportedFeedbackTypes)
+    .required()
+    .label("Type"),
+  message: string()
+    .trim()
+    .required("Please enter a message")
+    .max(FEEDBACK_MESSAGE_MAX)
+    .label("Message"),
+  email: string().email().optional().label("Email"),
+  pageUrl: string().optional().label("Page URL"),
+  status: mixed<FeedbackStatus>()
+    .oneOf(SupportedFeedbackStatuses)
+    .optional()
+    .label("Status"),
+}).label("Feedback Schema");

package/src/index.ts

@@ -68,6 +68,12 @@ export * from "./pagination/pagination.constant.js";
 export * from "./report/report.schema.js";
 export * from "./report/report.constant.js";
 
+/**
+ * Feedback schemas and constants (feedback widget + reports inbox).
+ */
+export * from "./feedback/feedback.schema.js";
+export * from "./feedback/feedback.constant.js";
+
 /**
  * Skill schemas and constants.
  */

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.