@thejob/schema 2.0.9 → 2.1.0

package/dist/index.cjs

@@ -2609,6 +2609,24 @@ 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")
+  }).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.

package/dist/index.d.cts

@@ -1768,6 +1768,11 @@ declare const UserSchema: yup.ObjectSchema<{
     }[];
     status: NonNullable<UserStatus | undefined>;
     roles: (UserRole | undefined)[];
+    marketingConsent: {
+        updatedAt?: number | undefined;
+        source?: string | undefined;
+        subscribed: boolean;
+    };
     embedding: {
         vector?: number[] | undefined;
         model?: string | undefined;
@@ -1964,6 +1969,9 @@ declare const UserSchema: yup.ObjectSchema<{
     additionalInfo: never[];
     status: undefined;
     roles: UserRole[];
+    marketingConsent: {
+        subscribed: boolean;
+    };
     embedding: {
         vector: undefined;
         model: undefined;

package/dist/index.d.ts

@@ -1768,6 +1768,11 @@ declare const UserSchema: yup.ObjectSchema<{
     }[];
     status: NonNullable<UserStatus | undefined>;
     roles: (UserRole | undefined)[];
+    marketingConsent: {
+        updatedAt?: number | undefined;
+        source?: string | undefined;
+        subscribed: boolean;
+    };
     embedding: {
         vector?: number[] | undefined;
         model?: string | undefined;
@@ -1964,6 +1969,9 @@ declare const UserSchema: yup.ObjectSchema<{
     additionalInfo: never[];
     status: undefined;
     roles: UserRole[];
+    marketingConsent: {
+        subscribed: boolean;
+    };
     embedding: {
         vector: undefined;
         model: undefined;

package/dist/index.js

@@ -2145,7 +2145,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 +2447,24 @@ 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")
+  }).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.

package/package.json

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

package/src/user/user.schema.ts

@@ -1,4 +1,4 @@
-import { array, number, object, string } from "yup";
+import { array, boolean, number, object, string } from "yup";
 
 import {
   DefaultUserRoles,
@@ -110,6 +110,27 @@ 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"),
+  })
+    .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.