@thejob/util 1.0.24 → 1.0.26

package/dist/cjs/completeness/completeness.d.ts

@@ -1,2 +1,9 @@
-export {};
+import { TCompletenessScoreSchema, TUserCompletenessSchema, TUserSchema } from "@thejob/schema";
+/**
+ * Calculates the profile completeness score for a given user object.
+ * Pure function — no database calls required.
+ *
+ * Mirrors the section weights used in UsersService.getCompleteness().
+ */
+export declare function calculateProfileCompleteness(user: Partial<TUserSchema>): Record<keyof TUserCompletenessSchema, TCompletenessScoreSchema>;
 //# sourceMappingURL=completeness.d.ts.map

package/dist/cjs/completeness/completeness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completeness.d.ts","sourceRoot":"","sources":["../../../src/completeness/completeness.ts"],"names":[],"mappings":""}
+{"version":3,"file":"completeness.d.ts","sourceRoot":"","sources":["../../../src/completeness/completeness.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,WAAW,EAEZ,MAAM,gBAAgB,CAAC;AAGxB;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GACzB,MAAM,CAAC,MAAM,uBAAuB,EAAE,wBAAwB,CAAC,CA6GjE"}

package/dist/cjs/completeness/completeness.js

@@ -1,119 +1,104 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const extractFields = (schema, prefix = "", includeOptionals = false) => {
-    if (!schema?.fields)
-        return [];
-    const schemaFields = schema.fields;
-    let extractedFields = [];
-    const processField = (key, fieldSchema, currentPath) => {
-        const isRequired = !fieldSchema.spec?.optional;
-        const type = fieldSchema.type;
-        const innerType = fieldSchema.innerType?.type;
-        if (!isRequired && !includeOptionals)
-            return;
-        if (type === "array") {
-            const minItems = fieldSchema.tests?.find((t) => t.OPTIONS?.name === "min")?.OPTIONS
-                ?.params?.min || 0;
-            const itemSchema = fieldSchema.innerType;
-            // Handle required array items
-            for (let i = 0; i < minItems; i++) {
-                const indexPath = `${currentPath}.${i}`;
-                const itemFields = extractFields(itemSchema, indexPath, includeOptionals);
-                extractedFields.push(...itemFields);
-                if (itemFields.length === 0) {
-                    extractedFields.push({ key: indexPath, required: true });
-                }
-            }
-            // Handle optional array items
-            if (includeOptionals) {
-                const optionalFields = extractFields(itemSchema, currentPath, includeOptionals).map((f) => ({ ...f, key: `${f.key}[]`, required: false }));
-                extractedFields.push(...optionalFields);
-            }
-        }
-        else if (type === "object" || innerType === "object") {
-            const targetSchema = type === "object" ? fieldSchema : fieldSchema.innerType;
-            const nestedFields = extractFields(targetSchema, currentPath, includeOptionals);
-            extractedFields.push(...nestedFields);
-        }
-        else {
-            extractedFields.push({ key: currentPath, required: isRequired });
-        }
+exports.calculateProfileCompleteness = calculateProfileCompleteness;
+const schema_1 = require("@thejob/schema");
+const utils_1 = require("../common/utils");
+/**
+ * Calculates the profile completeness score for a given user object.
+ * Pure function — no database calls required.
+ *
+ * Mirrors the section weights used in UsersService.getCompleteness().
+ */
+function calculateProfileCompleteness(user) {
+    const { educations, workExperiences, projects, skills, languages, interests, certifications, socialAccounts, additionalInfo, } = user;
+    // General (7 steps: name, headline, aboutMe, email, mobile, location, image)
+    const generalTotalSteps = 7;
+    const generalCompletedSteps = [
+        !!user.name,
+        !!user.headline,
+        !!user.aboutMe,
+        !!user.email,
+        !!user.mobile,
+        !!user.location,
+        !!user.image,
+    ].filter(Boolean).length;
+    // Sections with 1 step each (has at least one item)
+    const workExperiencesCompleted = workExperiences?.length ? 1 : 0;
+    const educationsCompleted = educations?.length ? 1 : 0;
+    const projectsCompleted = projects?.length ? 1 : 0;
+    const skillsCompleted = skills?.length ? 1 : 0;
+    const languagesCompleted = languages?.length ? 1 : 0;
+    const interestsCompleted = interests?.length ? 1 : 0;
+    const certificationsCompleted = certifications?.length ? 1 : 0;
+    const socialAccountsCompleted = socialAccounts?.length ? 1 : 0;
+    const additionalInfoCompleted = additionalInfo?.length ? 1 : 0;
+    // Overview total excludes additionalInfo (matches original service logic)
+    const totalSteps = generalTotalSteps + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1; // 15
+    const completedSteps = generalCompletedSteps +
+        workExperiencesCompleted +
+        educationsCompleted +
+        projectsCompleted +
+        skillsCompleted +
+        languagesCompleted +
+        interestsCompleted +
+        certificationsCompleted +
+        socialAccountsCompleted;
+    const score = (completedSteps / totalSteps) * 100;
+    return {
+        [schema_1.UserDetailType.Overview]: {
+            score: (0, utils_1.toPositiveWholeNumber)(score),
+            completedSteps,
+            totalSteps,
+        },
+        [schema_1.UserDetailType.General]: {
+            score: (0, utils_1.toPositiveWholeNumber)((generalCompletedSteps / generalTotalSteps) * 100),
+            completedSteps: generalCompletedSteps,
+            totalSteps: generalTotalSteps,
+        },
+        [schema_1.UserDetailType.WorkExperiences]: {
+            score: (0, utils_1.toPositiveWholeNumber)(workExperiencesCompleted * 100),
+            completedSteps: workExperiencesCompleted,
+            totalSteps: 1,
+        },
+        [schema_1.UserDetailType.Educations]: {
+            score: (0, utils_1.toPositiveWholeNumber)(educationsCompleted * 100),
+            completedSteps: educationsCompleted,
+            totalSteps: 1,
+        },
+        [schema_1.UserDetailType.Projects]: {
+            score: (0, utils_1.toPositiveWholeNumber)(projectsCompleted * 100),
+            completedSteps: projectsCompleted,
+            totalSteps: 1,
+        },
+        [schema_1.UserDetailType.Skills]: {
+            score: (0, utils_1.toPositiveWholeNumber)(skillsCompleted * 100),
+            completedSteps: skillsCompleted,
+            totalSteps: 1,
+        },
+        [schema_1.UserDetailType.Languages]: {
+            score: (0, utils_1.toPositiveWholeNumber)(languagesCompleted * 100),
+            completedSteps: languagesCompleted,
+            totalSteps: 1,
+        },
+        [schema_1.UserDetailType.Interests]: {
+            score: (0, utils_1.toPositiveWholeNumber)(interestsCompleted * 100),
+            completedSteps: interestsCompleted,
+            totalSteps: 1,
+        },
+        [schema_1.UserDetailType.Certifications]: {
+            score: (0, utils_1.toPositiveWholeNumber)(certificationsCompleted * 100),
+            completedSteps: certificationsCompleted,
+            totalSteps: 1,
+        },
+        [schema_1.UserDetailType.SocialAccounts]: {
+            score: (0, utils_1.toPositiveWholeNumber)(socialAccountsCompleted * 100),
+            completedSteps: socialAccountsCompleted,
+            totalSteps: 1,
+        },
+        [schema_1.UserDetailType.AdditionalInfo]: {
+            score: (0, utils_1.toPositiveWholeNumber)(additionalInfoCompleted * 100),
+            completedSteps: additionalInfoCompleted,
+            totalSteps: 1,
+        },
     };
-    for (const key in schemaFields) {
-        const fieldSchema = schemaFields[key];
-        if (!fieldSchema)
-            continue;
-        const currentPath = prefix ? `${prefix}.${key}` : key;
-        processField(key, fieldSchema, currentPath);
-    }
-    return extractedFields;
-};
-// const getValueByPath = (data: any, path: string) => {
-//   const parts = path.replace("[]", "").split(".");
-//   return parts.reduce((acc, part) => {
-//     if (acc === undefined || acc === null) return undefined;
-//     const match = part.match(/^(\d+)$/);
-//     if (match && match[1]) {
-//       const index = parseInt(match[1]);
-//       return Array.isArray(acc) ? acc[index] : undefined;
-//     }
-//     return acc[part];
-//   }, data);
-// };
-// export const getCompletenessScore = <T>(
-//   schema: any,
-//   data: T | T[],
-//   options: CompletenessOptions = { includeOptionals: false }
-// ): CompletenessScore => {
-//   const { includeOptionals = false, emptyArrayScore } = options;
-//   if (Array.isArray(data)) {
-//     if (data.length === 0) {
-//       return {
-//         score: emptyArrayScore === "perfect" ? 100 : 0,
-//         completedSteps: 0,
-//         totalSteps: 0,
-//         children: [],
-//       };
-//     }
-//     const children = data.map((item) =>
-//       getCompletenessScore(schema, item, options)
-//     );
-//     const contentScore =
-//       children.reduce((sum, child) => sum + child.score, 0) / children.length;
-//     return {
-//       score: Math.round(contentScore),
-//       completedSteps: children.reduce((sum, c) => sum + c.completedSteps, 0),
-//       totalSteps: children.reduce((sum, c) => sum + c.totalSteps, 0),
-//       children,
-//     };
-//   }
-//   const fields = extractFields(schema, "", includeOptionals);
-//   const requiredFields = fields.filter((f) => f.required);
-//   const totalSteps = includeOptionals ? fields.length : requiredFields.length;
-//   let completedSteps = 0;
-//   const meta = {
-//     steps: fields.map((f) => f.key),
-//     completed: [] as string[],
-//     incomplete: [] as string[],
-//   };
-//   fields.forEach(({ key, required }) => {
-//     const value = getValueByPath(data, key);
-//     const exists = value !== undefined && value !== null && value !== "";
-//     if (exists) {
-//       meta.completed.push(key);
-//       if (includeOptionals || required) completedSteps++;
-//     } else {
-//       if (includeOptionals || required) meta.incomplete.push(key);
-//     }
-//   });
-//   const score =
-//     totalSteps > 0 ? Math.floor((completedSteps / totalSteps) * 100) : 100;
-//   return {
-//     score,
-//     completedSteps: includeOptionals
-//       ? completedSteps
-//       : Math.min(completedSteps, requiredFields.length),
-//     totalSteps,
-//     meta,
-//   };
-// };
+}

package/dist/cjs/user/utils.d.ts

@@ -1,3 +1,38 @@
+/**
+ * Prepares a user profile for vector embedding by creating a semantic narrative.
+ * Mirrors prepareJobForEmbedding() — same "Label: Value" format for Voyage AI.
+ *
+ * Strategy:
+ * 1. Core identity (headline + location)
+ * 2. About me (intent/personality signal)
+ * 3. Flattened structured data (skills, experience, education)
+ */
+export declare function prepareUserForEmbedding(user: {
+    headline?: string;
+    aboutMe?: string;
+    location?: {
+        city?: string;
+        stateCode?: string;
+        state?: string;
+        country?: string;
+    };
+    skills?: Array<{
+        name: string;
+    }>;
+    experienceLevel?: string;
+    workExperiences?: Array<{
+        title?: string;
+        company?: string;
+    }>;
+    educations?: Array<{
+        degree?: string;
+        fieldOfStudy?: string;
+        institution?: string;
+    }>;
+    languages?: Array<{
+        name: string;
+    }>;
+}): string;
 export declare const parseName: (name: string | {
     first: string;
     last?: string;

package/dist/cjs/user/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/user/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;WAAvB,MAAM;WAAS,MAAM;CAWtE,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/user/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrF,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrC,GAAG,MAAM,CA8CT;AAED,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;WAAvB,MAAM;WAAS,MAAM;CAWtE,CAAC"}

package/dist/cjs/user/utils.js

@@ -1,6 +1,62 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseName = void 0;
+exports.prepareUserForEmbedding = prepareUserForEmbedding;
+/**
+ * Prepares a user profile for vector embedding by creating a semantic narrative.
+ * Mirrors prepareJobForEmbedding() — same "Label: Value" format for Voyage AI.
+ *
+ * Strategy:
+ * 1. Core identity (headline + location)
+ * 2. About me (intent/personality signal)
+ * 3. Flattened structured data (skills, experience, education)
+ */
+function prepareUserForEmbedding(user) {
+    const headline = user.headline?.trim() || '';
+    const about = user.aboutMe?.replace(/\n/g, ' ').trim() || '';
+    const locationParts = [
+        user.location?.city,
+        user.location?.stateCode || user.location?.state,
+        user.location?.country,
+    ].filter(Boolean);
+    const location = locationParts.join(', ');
+    const skillsList = user.skills
+        ?.map((s) => s.name.toLowerCase())
+        .filter(Boolean)
+        .join(', ') || '';
+    const experienceList = user.workExperiences
+        ?.map((w) => [w.title, w.company].filter(Boolean).join(' at '))
+        .filter(Boolean)
+        .join('; ') || '';
+    const educationList = user.educations
+        ?.map((e) => [e.degree, e.fieldOfStudy, e.institution ? `at ${e.institution}` : '']
+        .filter(Boolean)
+        .join(' '))
+        .filter(Boolean)
+        .join('; ') || '';
+    const languagesList = user.languages
+        ?.map((l) => l.name)
+        .filter(Boolean)
+        .join(', ') || '';
+    const parts = [];
+    if (headline)
+        parts.push(`Headline: ${headline}`);
+    if (about)
+        parts.push(`About: ${about}`);
+    if (skillsList)
+        parts.push(`Skills: ${skillsList}`);
+    if (location)
+        parts.push(`Location: ${location}`);
+    if (user.experienceLevel)
+        parts.push(`Level: ${user.experienceLevel}`);
+    if (experienceList)
+        parts.push(`Experience: ${experienceList}`);
+    if (educationList)
+        parts.push(`Education: ${educationList}`);
+    if (languagesList)
+        parts.push(`Languages: ${languagesList}`);
+    return parts.join('. ').replace(/\s\s+/g, ' ').trim();
+}
 const parseName = (name) => {
     if (typeof name === "string") {
         const nameParts = name.trim().split(/\s+/); // Split by spaces, ensuring no extra whitespace

package/dist/esm/completeness/completeness.d.ts

@@ -1,2 +1,9 @@
-export {};
+import { TCompletenessScoreSchema, TUserCompletenessSchema, TUserSchema } from "@thejob/schema";
+/**
+ * Calculates the profile completeness score for a given user object.
+ * Pure function — no database calls required.
+ *
+ * Mirrors the section weights used in UsersService.getCompleteness().
+ */
+export declare function calculateProfileCompleteness(user: Partial<TUserSchema>): Record<keyof TUserCompletenessSchema, TCompletenessScoreSchema>;
 //# sourceMappingURL=completeness.d.ts.map

package/dist/esm/completeness/completeness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completeness.d.ts","sourceRoot":"","sources":["../../../src/completeness/completeness.ts"],"names":[],"mappings":""}
+{"version":3,"file":"completeness.d.ts","sourceRoot":"","sources":["../../../src/completeness/completeness.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,WAAW,EAEZ,MAAM,gBAAgB,CAAC;AAGxB;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GACzB,MAAM,CAAC,MAAM,uBAAuB,EAAE,wBAAwB,CAAC,CA6GjE"}

package/dist/esm/completeness/completeness.js

@@ -1,118 +1,101 @@
-const extractFields = (schema, prefix = "", includeOptionals = false) => {
-    if (!schema?.fields)
-        return [];
-    const schemaFields = schema.fields;
-    let extractedFields = [];
-    const processField = (key, fieldSchema, currentPath) => {
-        const isRequired = !fieldSchema.spec?.optional;
-        const type = fieldSchema.type;
-        const innerType = fieldSchema.innerType?.type;
-        if (!isRequired && !includeOptionals)
-            return;
-        if (type === "array") {
-            const minItems = fieldSchema.tests?.find((t) => t.OPTIONS?.name === "min")?.OPTIONS
-                ?.params?.min || 0;
-            const itemSchema = fieldSchema.innerType;
-            // Handle required array items
-            for (let i = 0; i < minItems; i++) {
-                const indexPath = `${currentPath}.${i}`;
-                const itemFields = extractFields(itemSchema, indexPath, includeOptionals);
-                extractedFields.push(...itemFields);
-                if (itemFields.length === 0) {
-                    extractedFields.push({ key: indexPath, required: true });
-                }
-            }
-            // Handle optional array items
-            if (includeOptionals) {
-                const optionalFields = extractFields(itemSchema, currentPath, includeOptionals).map((f) => ({ ...f, key: `${f.key}[]`, required: false }));
-                extractedFields.push(...optionalFields);
-            }
-        }
-        else if (type === "object" || innerType === "object") {
-            const targetSchema = type === "object" ? fieldSchema : fieldSchema.innerType;
-            const nestedFields = extractFields(targetSchema, currentPath, includeOptionals);
-            extractedFields.push(...nestedFields);
-        }
-        else {
-            extractedFields.push({ key: currentPath, required: isRequired });
-        }
+import { UserDetailType, } from "@thejob/schema";
+import { toPositiveWholeNumber } from "../common/utils";
+/**
+ * Calculates the profile completeness score for a given user object.
+ * Pure function — no database calls required.
+ *
+ * Mirrors the section weights used in UsersService.getCompleteness().
+ */
+export function calculateProfileCompleteness(user) {
+    const { educations, workExperiences, projects, skills, languages, interests, certifications, socialAccounts, additionalInfo, } = user;
+    // General (7 steps: name, headline, aboutMe, email, mobile, location, image)
+    const generalTotalSteps = 7;
+    const generalCompletedSteps = [
+        !!user.name,
+        !!user.headline,
+        !!user.aboutMe,
+        !!user.email,
+        !!user.mobile,
+        !!user.location,
+        !!user.image,
+    ].filter(Boolean).length;
+    // Sections with 1 step each (has at least one item)
+    const workExperiencesCompleted = workExperiences?.length ? 1 : 0;
+    const educationsCompleted = educations?.length ? 1 : 0;
+    const projectsCompleted = projects?.length ? 1 : 0;
+    const skillsCompleted = skills?.length ? 1 : 0;
+    const languagesCompleted = languages?.length ? 1 : 0;
+    const interestsCompleted = interests?.length ? 1 : 0;
+    const certificationsCompleted = certifications?.length ? 1 : 0;
+    const socialAccountsCompleted = socialAccounts?.length ? 1 : 0;
+    const additionalInfoCompleted = additionalInfo?.length ? 1 : 0;
+    // Overview total excludes additionalInfo (matches original service logic)
+    const totalSteps = generalTotalSteps + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1; // 15
+    const completedSteps = generalCompletedSteps +
+        workExperiencesCompleted +
+        educationsCompleted +
+        projectsCompleted +
+        skillsCompleted +
+        languagesCompleted +
+        interestsCompleted +
+        certificationsCompleted +
+        socialAccountsCompleted;
+    const score = (completedSteps / totalSteps) * 100;
+    return {
+        [UserDetailType.Overview]: {
+            score: toPositiveWholeNumber(score),
+            completedSteps,
+            totalSteps,
+        },
+        [UserDetailType.General]: {
+            score: toPositiveWholeNumber((generalCompletedSteps / generalTotalSteps) * 100),
+            completedSteps: generalCompletedSteps,
+            totalSteps: generalTotalSteps,
+        },
+        [UserDetailType.WorkExperiences]: {
+            score: toPositiveWholeNumber(workExperiencesCompleted * 100),
+            completedSteps: workExperiencesCompleted,
+            totalSteps: 1,
+        },
+        [UserDetailType.Educations]: {
+            score: toPositiveWholeNumber(educationsCompleted * 100),
+            completedSteps: educationsCompleted,
+            totalSteps: 1,
+        },
+        [UserDetailType.Projects]: {
+            score: toPositiveWholeNumber(projectsCompleted * 100),
+            completedSteps: projectsCompleted,
+            totalSteps: 1,
+        },
+        [UserDetailType.Skills]: {
+            score: toPositiveWholeNumber(skillsCompleted * 100),
+            completedSteps: skillsCompleted,
+            totalSteps: 1,
+        },
+        [UserDetailType.Languages]: {
+            score: toPositiveWholeNumber(languagesCompleted * 100),
+            completedSteps: languagesCompleted,
+            totalSteps: 1,
+        },
+        [UserDetailType.Interests]: {
+            score: toPositiveWholeNumber(interestsCompleted * 100),
+            completedSteps: interestsCompleted,
+            totalSteps: 1,
+        },
+        [UserDetailType.Certifications]: {
+            score: toPositiveWholeNumber(certificationsCompleted * 100),
+            completedSteps: certificationsCompleted,
+            totalSteps: 1,
+        },
+        [UserDetailType.SocialAccounts]: {
+            score: toPositiveWholeNumber(socialAccountsCompleted * 100),
+            completedSteps: socialAccountsCompleted,
+            totalSteps: 1,
+        },
+        [UserDetailType.AdditionalInfo]: {
+            score: toPositiveWholeNumber(additionalInfoCompleted * 100),
+            completedSteps: additionalInfoCompleted,
+            totalSteps: 1,
+        },
     };
-    for (const key in schemaFields) {
-        const fieldSchema = schemaFields[key];
-        if (!fieldSchema)
-            continue;
-        const currentPath = prefix ? `${prefix}.${key}` : key;
-        processField(key, fieldSchema, currentPath);
-    }
-    return extractedFields;
-};
-export {};
-// const getValueByPath = (data: any, path: string) => {
-//   const parts = path.replace("[]", "").split(".");
-//   return parts.reduce((acc, part) => {
-//     if (acc === undefined || acc === null) return undefined;
-//     const match = part.match(/^(\d+)$/);
-//     if (match && match[1]) {
-//       const index = parseInt(match[1]);
-//       return Array.isArray(acc) ? acc[index] : undefined;
-//     }
-//     return acc[part];
-//   }, data);
-// };
-// export const getCompletenessScore = <T>(
-//   schema: any,
-//   data: T | T[],
-//   options: CompletenessOptions = { includeOptionals: false }
-// ): CompletenessScore => {
-//   const { includeOptionals = false, emptyArrayScore } = options;
-//   if (Array.isArray(data)) {
-//     if (data.length === 0) {
-//       return {
-//         score: emptyArrayScore === "perfect" ? 100 : 0,
-//         completedSteps: 0,
-//         totalSteps: 0,
-//         children: [],
-//       };
-//     }
-//     const children = data.map((item) =>
-//       getCompletenessScore(schema, item, options)
-//     );
-//     const contentScore =
-//       children.reduce((sum, child) => sum + child.score, 0) / children.length;
-//     return {
-//       score: Math.round(contentScore),
-//       completedSteps: children.reduce((sum, c) => sum + c.completedSteps, 0),
-//       totalSteps: children.reduce((sum, c) => sum + c.totalSteps, 0),
-//       children,
-//     };
-//   }
-//   const fields = extractFields(schema, "", includeOptionals);
-//   const requiredFields = fields.filter((f) => f.required);
-//   const totalSteps = includeOptionals ? fields.length : requiredFields.length;
-//   let completedSteps = 0;
-//   const meta = {
-//     steps: fields.map((f) => f.key),
-//     completed: [] as string[],
-//     incomplete: [] as string[],
-//   };
-//   fields.forEach(({ key, required }) => {
-//     const value = getValueByPath(data, key);
-//     const exists = value !== undefined && value !== null && value !== "";
-//     if (exists) {
-//       meta.completed.push(key);
-//       if (includeOptionals || required) completedSteps++;
-//     } else {
-//       if (includeOptionals || required) meta.incomplete.push(key);
-//     }
-//   });
-//   const score =
-//     totalSteps > 0 ? Math.floor((completedSteps / totalSteps) * 100) : 100;
-//   return {
-//     score,
-//     completedSteps: includeOptionals
-//       ? completedSteps
-//       : Math.min(completedSteps, requiredFields.length),
-//     totalSteps,
-//     meta,
-//   };
-// };
+}

package/dist/esm/user/utils.d.ts

@@ -1,3 +1,38 @@
+/**
+ * Prepares a user profile for vector embedding by creating a semantic narrative.
+ * Mirrors prepareJobForEmbedding() — same "Label: Value" format for Voyage AI.
+ *
+ * Strategy:
+ * 1. Core identity (headline + location)
+ * 2. About me (intent/personality signal)
+ * 3. Flattened structured data (skills, experience, education)
+ */
+export declare function prepareUserForEmbedding(user: {
+    headline?: string;
+    aboutMe?: string;
+    location?: {
+        city?: string;
+        stateCode?: string;
+        state?: string;
+        country?: string;
+    };
+    skills?: Array<{
+        name: string;
+    }>;
+    experienceLevel?: string;
+    workExperiences?: Array<{
+        title?: string;
+        company?: string;
+    }>;
+    educations?: Array<{
+        degree?: string;
+        fieldOfStudy?: string;
+        institution?: string;
+    }>;
+    languages?: Array<{
+        name: string;
+    }>;
+}): string;
 export declare const parseName: (name: string | {
     first: string;
     last?: string;

package/dist/esm/user/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/user/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;WAAvB,MAAM;WAAS,MAAM;CAWtE,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/user/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrF,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrC,GAAG,MAAM,CA8CT;AAED,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;WAAvB,MAAM;WAAS,MAAM;CAWtE,CAAC"}

package/dist/esm/user/utils.js

@@ -1,3 +1,58 @@
+/**
+ * Prepares a user profile for vector embedding by creating a semantic narrative.
+ * Mirrors prepareJobForEmbedding() — same "Label: Value" format for Voyage AI.
+ *
+ * Strategy:
+ * 1. Core identity (headline + location)
+ * 2. About me (intent/personality signal)
+ * 3. Flattened structured data (skills, experience, education)
+ */
+export function prepareUserForEmbedding(user) {
+    const headline = user.headline?.trim() || '';
+    const about = user.aboutMe?.replace(/\n/g, ' ').trim() || '';
+    const locationParts = [
+        user.location?.city,
+        user.location?.stateCode || user.location?.state,
+        user.location?.country,
+    ].filter(Boolean);
+    const location = locationParts.join(', ');
+    const skillsList = user.skills
+        ?.map((s) => s.name.toLowerCase())
+        .filter(Boolean)
+        .join(', ') || '';
+    const experienceList = user.workExperiences
+        ?.map((w) => [w.title, w.company].filter(Boolean).join(' at '))
+        .filter(Boolean)
+        .join('; ') || '';
+    const educationList = user.educations
+        ?.map((e) => [e.degree, e.fieldOfStudy, e.institution ? `at ${e.institution}` : '']
+        .filter(Boolean)
+        .join(' '))
+        .filter(Boolean)
+        .join('; ') || '';
+    const languagesList = user.languages
+        ?.map((l) => l.name)
+        .filter(Boolean)
+        .join(', ') || '';
+    const parts = [];
+    if (headline)
+        parts.push(`Headline: ${headline}`);
+    if (about)
+        parts.push(`About: ${about}`);
+    if (skillsList)
+        parts.push(`Skills: ${skillsList}`);
+    if (location)
+        parts.push(`Location: ${location}`);
+    if (user.experienceLevel)
+        parts.push(`Level: ${user.experienceLevel}`);
+    if (experienceList)
+        parts.push(`Experience: ${experienceList}`);
+    if (educationList)
+        parts.push(`Education: ${educationList}`);
+    if (languagesList)
+        parts.push(`Languages: ${languagesList}`);
+    return parts.join('. ').replace(/\s\s+/g, ' ').trim();
+}
 export const parseName = (name) => {
     if (typeof name === "string") {
         const nameParts = name.trim().split(/\s+/); // Split by spaces, ensuring no extra whitespace

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thejob/util",
-  "version": "1.0.24",
+  "version": "1.0.26",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/esm/index.d.ts",
@@ -34,7 +34,7 @@
     "typescript": "^5.7.3"
   },
   "dependencies": {
-    "@thejob/schema": "^1.0.88",
+    "@thejob/schema": "^1.0.97",
     "dayjs": "^1.11.13",
     "mongoose": "^8.11.0",
     "nanoid": "3.3.5",