@thejob/util 1.0.28 → 1.0.30

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

@@ -1,2 +1,3 @@
 export * from "./completeness";
+export * from "./job-match-completeness";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/completeness/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/completeness/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC"}

package/dist/cjs/completeness/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./completeness"), exports);
+__exportStar(require("./job-match-completeness"), exports);

package/dist/cjs/completeness/job-match-completeness.d.ts

@@ -0,0 +1,21 @@
+import { TUserSchema } from "@thejob/schema";
+/**
+ * Calculates a job-match completeness score (0–100) based only on the fields
+ * that directly affect search ranking and candidate-job matching quality.
+ *
+ * Intentionally excludes profile UX fields (image, mobile, socialAccounts,
+ * certifications, projects, interests, additionalInfo) that have no bearing
+ * on whether a candidate can be accurately ranked against a job.
+ *
+ * Weights:
+ *   headline        25  — strongest FTS + embedding signal
+ *   skills          25  — directly matched against job requirements
+ *   workExperiences 20  — seniority and title signals
+ *   experienceLevel 15  — level fit (entry / mid / senior)
+ *   aboutMe         10  — semantic narrative and intent
+ *   educations       5  — degree / field matching
+ *                  ---
+ *                  100
+ */
+export declare function calculateJobMatchCompleteness(user: Partial<TUserSchema>): number;
+//# sourceMappingURL=job-match-completeness.d.ts.map

package/dist/cjs/completeness/job-match-completeness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-match-completeness.d.ts","sourceRoot":"","sources":["../../../src/completeness/job-match-completeness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GACzB,MAAM,CAWR"}

package/dist/cjs/completeness/job-match-completeness.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateJobMatchCompleteness = calculateJobMatchCompleteness;
+const utils_1 = require("../common/utils");
+/**
+ * Calculates a job-match completeness score (0–100) based only on the fields
+ * that directly affect search ranking and candidate-job matching quality.
+ *
+ * Intentionally excludes profile UX fields (image, mobile, socialAccounts,
+ * certifications, projects, interests, additionalInfo) that have no bearing
+ * on whether a candidate can be accurately ranked against a job.
+ *
+ * Weights:
+ *   headline        25  — strongest FTS + embedding signal
+ *   skills          25  — directly matched against job requirements
+ *   workExperiences 20  — seniority and title signals
+ *   experienceLevel 15  — level fit (entry / mid / senior)
+ *   aboutMe         10  — semantic narrative and intent
+ *   educations       5  — degree / field matching
+ *                  ---
+ *                  100
+ */
+function calculateJobMatchCompleteness(user) {
+    let score = 0;
+    if (user.headline?.trim())
+        score += 25;
+    if ((user.skills?.length ?? 0) > 0)
+        score += 25;
+    if ((user.workExperiences?.length ?? 0) > 0)
+        score += 20;
+    if (user.experienceLevel)
+        score += 15;
+    if (user.aboutMe?.trim())
+        score += 10;
+    if ((user.educations?.length ?? 0) > 0)
+        score += 5;
+    return (0, utils_1.toPositiveWholeNumber)(score);
+}

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

@@ -8,7 +8,7 @@ import { TUserSchema } from "@thejob/schema";
  * 2. About me (intent/personality signal)
  * 3. Flattened structured data (skills, experience, education)
  */
-export declare function prepareUserForEmbedding1(user: TUserSchema): string;
+export declare function prepareUserForEmbedding(user: TUserSchema): 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,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAmElE;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"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/user/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAmEjE;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,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseName = void 0;
-exports.prepareUserForEmbedding1 = prepareUserForEmbedding1;
+exports.prepareUserForEmbedding = prepareUserForEmbedding;
 const common_1 = require("../common");
 /**
  * Prepares a user profile for vector embedding by creating a semantic narrative.
@@ -12,7 +12,7 @@ const common_1 = require("../common");
  * 2. About me (intent/personality signal)
  * 3. Flattened structured data (skills, experience, education)
  */
-function prepareUserForEmbedding1(user) {
+function prepareUserForEmbedding(user) {
     const headline = user.headline?.trim() || "";
     const about = user.aboutMe?.replace(/\n/g, " ").trim() || "";
     const locationParts = [

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

@@ -1,2 +1,3 @@
 export * from "./completeness";
+export * from "./job-match-completeness";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/completeness/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/completeness/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC"}

package/dist/esm/completeness/index.js

@@ -1 +1,2 @@
 export * from "./completeness";
+export * from "./job-match-completeness";

package/dist/esm/completeness/job-match-completeness.d.ts

@@ -0,0 +1,21 @@
+import { TUserSchema } from "@thejob/schema";
+/**
+ * Calculates a job-match completeness score (0–100) based only on the fields
+ * that directly affect search ranking and candidate-job matching quality.
+ *
+ * Intentionally excludes profile UX fields (image, mobile, socialAccounts,
+ * certifications, projects, interests, additionalInfo) that have no bearing
+ * on whether a candidate can be accurately ranked against a job.
+ *
+ * Weights:
+ *   headline        25  — strongest FTS + embedding signal
+ *   skills          25  — directly matched against job requirements
+ *   workExperiences 20  — seniority and title signals
+ *   experienceLevel 15  — level fit (entry / mid / senior)
+ *   aboutMe         10  — semantic narrative and intent
+ *   educations       5  — degree / field matching
+ *                  ---
+ *                  100
+ */
+export declare function calculateJobMatchCompleteness(user: Partial<TUserSchema>): number;
+//# sourceMappingURL=job-match-completeness.d.ts.map

package/dist/esm/completeness/job-match-completeness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-match-completeness.d.ts","sourceRoot":"","sources":["../../../src/completeness/job-match-completeness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GACzB,MAAM,CAWR"}

package/dist/esm/completeness/job-match-completeness.js

@@ -0,0 +1,35 @@
+import { toPositiveWholeNumber } from "../common/utils";
+/**
+ * Calculates a job-match completeness score (0–100) based only on the fields
+ * that directly affect search ranking and candidate-job matching quality.
+ *
+ * Intentionally excludes profile UX fields (image, mobile, socialAccounts,
+ * certifications, projects, interests, additionalInfo) that have no bearing
+ * on whether a candidate can be accurately ranked against a job.
+ *
+ * Weights:
+ *   headline        25  — strongest FTS + embedding signal
+ *   skills          25  — directly matched against job requirements
+ *   workExperiences 20  — seniority and title signals
+ *   experienceLevel 15  — level fit (entry / mid / senior)
+ *   aboutMe         10  — semantic narrative and intent
+ *   educations       5  — degree / field matching
+ *                  ---
+ *                  100
+ */
+export function calculateJobMatchCompleteness(user) {
+    let score = 0;
+    if (user.headline?.trim())
+        score += 25;
+    if ((user.skills?.length ?? 0) > 0)
+        score += 25;
+    if ((user.workExperiences?.length ?? 0) > 0)
+        score += 20;
+    if (user.experienceLevel)
+        score += 15;
+    if (user.aboutMe?.trim())
+        score += 10;
+    if ((user.educations?.length ?? 0) > 0)
+        score += 5;
+    return toPositiveWholeNumber(score);
+}

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

@@ -8,7 +8,7 @@ import { TUserSchema } from "@thejob/schema";
  * 2. About me (intent/personality signal)
  * 3. Flattened structured data (skills, experience, education)
  */
-export declare function prepareUserForEmbedding1(user: TUserSchema): string;
+export declare function prepareUserForEmbedding(user: TUserSchema): 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,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAmElE;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"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/user/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAmEjE;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

@@ -8,7 +8,7 @@ import { displayByName, displayLocation, fromWithOtherValue } from "../common";
  * 2. About me (intent/personality signal)
  * 3. Flattened structured data (skills, experience, education)
  */
-export function prepareUserForEmbedding1(user) {
+export function prepareUserForEmbedding(user) {
     const headline = user.headline?.trim() || "";
     const about = user.aboutMe?.replace(/\n/g, " ").trim() || "";
     const locationParts = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thejob/util",
-  "version": "1.0.28",
+  "version": "1.0.30",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/esm/index.d.ts",