@thejob/util 1.0.29 → 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/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/package.json

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