@singi-labs/sifa-sdk 0.7.4 → 0.7.6

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as ProfileSkill, L as LocationValue, a as PdsProviderInfo } from './index-CpM21_Oy.js';
-export { A as ActiveApp, E as Endorsement, b as EndorsementData, c as ExternalAccount, d as ExternalAccountKeytraceClaim, F as FeedItem, e as LanguageProficiency, f as Profile, g as ProfileCertification, h as ProfileCourse, i as ProfileEducation, j as ProfileHonor, k as ProfileIndustry, l as ProfileLanguage, m as ProfileLocation, n as ProfileOverrideSource, o as ProfilePosition, p as ProfileProject, q as ProfilePublication, r as ProfileVolunteering, s as PublicationContributor, S as SkillRef, t as SkillSuggestion, T as TrustStat, V as VerifiedAccount } from './index-CpM21_Oy.js';
+import { P as ProfileSkill, L as LocationValue, a as PdsProviderInfo } from './index-IxlRuFsK.js';
+export { A as ActiveApp, E as Endorsement, b as EndorsementData, c as ExternalAccount, d as ExternalAccountKeytraceClaim, F as FeedItem, e as LanguageProficiency, f as Profile, g as ProfileCertification, h as ProfileCourse, i as ProfileEducation, j as ProfileHonor, k as ProfileIndustry, l as ProfileLanguage, m as ProfileLocation, n as ProfileOverrideSource, o as ProfilePosition, p as ProfileProject, q as ProfilePublication, r as ProfileVolunteering, s as PublicationContributor, S as SkillRef, t as SkillSuggestion, T as TrustStat, V as VerifiedAccount } from './index-IxlRuFsK.js';
 export { EndorsementConfirmationRecord, EndorsementConfirmationRecordSchema, EndorsementRecord, EndorsementRecordSchema, GraphFollowRecord, GraphFollowRecordSchema, ProfileCertificationRecord, ProfileCertificationRecordSchema, ProfileCourseRecord, ProfileCourseRecordSchema, ProfileEducationRecord, ProfileEducationRecordSchema, ProfileExternalAccountRecord, ProfileExternalAccountRecordSchema, ProfileHonorRecord, ProfileHonorRecordSchema, ProfileLanguageRecord, ProfileLanguageRecordSchema, ProfilePositionRecord, ProfilePositionRecordSchema, ProfileProjectRecord, ProfileProjectRecordSchema, ProfilePublicationRecord, ProfilePublicationRecordSchema, ProfileSelfRecord, ProfileSelfRecordSchema, ProfileSkillRecord, ProfileSkillRecordSchema, ProfileVolunteeringRecord, ProfileVolunteeringRecordSchema, PublicationAuthor, PublicationAuthorSchema, atUriSchema, cidSchema, datetimeSchema, didSchema, languageTagSchema, maxGraphemes, selfLabelsSchema, strongRefSchema, uriSchema } from './schemas/index.js';
 import 'zod';
 
@@ -253,6 +253,34 @@ declare function contrastRatio(color1: RgbColor, color2: RgbColor): number;
  */
 declare function meetsContrastAA(foreground: RgbColor, background: RgbColor): boolean;
 
+/**
+ * Profile completeness scoring.
+ *
+ * Six binary signals, equal weight: headline filled, about filled, has at least
+ * one position, education, skill, certification.
+ *
+ * Score: integer 0..6. Percent: round(score / 6 * 100) -- discrete values
+ * {0, 17, 33, 50, 67, 83, 100}.
+ *
+ * Canonical source of truth for completeness scoring across Sifa clients.
+ * sifa-api computes the underlying `ProfileCompletion` shape inline (in SQL
+ * for admin-stats queries, in route handlers elsewhere) but defers scoring
+ * to this module.
+ */
+declare const COMPLETENESS_MAX_SCORE = 6;
+interface ProfileCompletion {
+    hasHeadline: boolean;
+    hasAbout: boolean;
+    positionCount: number;
+    educationCount: number;
+    skillCount: number;
+    certificationCount: number;
+}
+/** Pure-TS computation of the 0..6 score. */
+declare function completenessScore(c: ProfileCompletion): number;
+/** Completion as a rounded 0..100 integer percent (matches API serialisation). */
+declare function completenessPercent(c: ProfileCompletion): number;
+
 /**
  * Sifa SDK -- public client library for the Sifa AppView on AT Protocol.
  *
@@ -262,4 +290,4 @@ declare function meetsContrastAA(foreground: RgbColor, background: RgbColor): bo
  */
 declare const SIFA_SDK_VERSION: string;
 
-export { CATEGORY_LABELS, CATEGORY_ORDER, CONTINENTS, COUNTRIES, type ContinentCode, INDUSTRY_OPTIONS, type IndustryOption, LocationValue, type MergedProfileSkill, PLATFORM_LABELS, PLATFORM_OPTIONS, type PdsProvider, PdsProviderInfo, type PlatformId, ProfileSkill, type RgbColor, SIFA_SDK_VERSION, SKILL_CATEGORIES, type SkillCategory, certDateExtractor, contrastRatio, countryCodeToFlag, dateRangeExtractor, dedupeSkills, detectPdsProvider, findIndustry, formatDistanceToNow, formatLocation, formatRelativeTime, getContinent, getDisplayLabel, getFaviconUrl, getHandleStem, getIndustryLabelKey, getPdsDisplayName, getPlatformLabel, groupSkillsByCategory, isKnownPlatform, isValidRgbColor, lexiconDateExtractor, meetsContrastAA, parseLocationString, pdsProviderFromApi, relativeLuminance, rgbToString, sanitizeHandleInput, singleDateExtractor, sortByDateDesc, truncateGraphemes };
+export { CATEGORY_LABELS, CATEGORY_ORDER, COMPLETENESS_MAX_SCORE, CONTINENTS, COUNTRIES, type ContinentCode, INDUSTRY_OPTIONS, type IndustryOption, LocationValue, type MergedProfileSkill, PLATFORM_LABELS, PLATFORM_OPTIONS, type PdsProvider, PdsProviderInfo, type PlatformId, type ProfileCompletion, ProfileSkill, type RgbColor, SIFA_SDK_VERSION, SKILL_CATEGORIES, type SkillCategory, certDateExtractor, completenessPercent, completenessScore, contrastRatio, countryCodeToFlag, dateRangeExtractor, dedupeSkills, detectPdsProvider, findIndustry, formatDistanceToNow, formatLocation, formatRelativeTime, getContinent, getDisplayLabel, getFaviconUrl, getHandleStem, getIndustryLabelKey, getPdsDisplayName, getPlatformLabel, groupSkillsByCategory, isKnownPlatform, isValidRgbColor, lexiconDateExtractor, meetsContrastAA, parseLocationString, pdsProviderFromApi, relativeLuminance, rgbToString, sanitizeHandleInput, singleDateExtractor, sortByDateDesc, truncateGraphemes };

package/dist/index.js

@@ -926,6 +926,22 @@ function contrastRatio(color1, color2) {
 function meetsContrastAA(foreground, background) {
   return contrastRatio(foreground, background) >= 4.5;
 }
+
+// src/logic/profile-completeness.ts
+var COMPLETENESS_MAX_SCORE = 6;
+function completenessScore(c) {
+  let filled = 0;
+  if (c.hasHeadline) filled++;
+  if (c.hasAbout) filled++;
+  if (c.positionCount > 0) filled++;
+  if (c.educationCount > 0) filled++;
+  if (c.skillCount > 0) filled++;
+  if (c.certificationCount > 0) filled++;
+  return filled;
+}
+function completenessPercent(c) {
+  return Math.round(completenessScore(c) / COMPLETENESS_MAX_SCORE * 100);
+}
 function maxGraphemes(max) {
   return (value) => {
     const segmenter = new Intl.Segmenter(void 0, { granularity: "grapheme" });
@@ -1086,8 +1102,8 @@ var ProfileVolunteeringRecordSchema = z.object({
 });
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.7.4";
+var SIFA_SDK_VERSION = "0.7.6";
 
-export { CATEGORY_LABELS, CATEGORY_ORDER, CONTINENTS, COUNTRIES, EndorsementConfirmationRecordSchema, EndorsementRecordSchema, GraphFollowRecordSchema, INDUSTRY_OPTIONS, PLATFORM_LABELS, PLATFORM_OPTIONS, ProfileCertificationRecordSchema, ProfileCourseRecordSchema, ProfileEducationRecordSchema, ProfileExternalAccountRecordSchema, ProfileHonorRecordSchema, ProfileLanguageRecordSchema, ProfilePositionRecordSchema, ProfileProjectRecordSchema, ProfilePublicationRecordSchema, ProfileSelfRecordSchema, ProfileSkillRecordSchema, ProfileVolunteeringRecordSchema, PublicationAuthorSchema, SIFA_SDK_VERSION, SKILL_CATEGORIES, atUriSchema, certDateExtractor, cidSchema, contrastRatio, countryCodeToFlag, dateRangeExtractor, datetimeSchema, dedupeSkills, detectPdsProvider, didSchema, findIndustry, formatDistanceToNow, formatLocation, formatRelativeTime, getContinent, getDisplayLabel, getFaviconUrl, getHandleStem, getIndustryLabelKey, getPdsDisplayName, getPlatformLabel, groupSkillsByCategory, isKnownPlatform, isValidRgbColor, languageTagSchema, lexiconDateExtractor, maxGraphemes, meetsContrastAA, parseLocationString, pdsProviderFromApi, relativeLuminance, rgbToString, sanitizeHandleInput, selfLabelsSchema, singleDateExtractor, sortByDateDesc, strongRefSchema, truncateGraphemes, uriSchema };
+export { CATEGORY_LABELS, CATEGORY_ORDER, COMPLETENESS_MAX_SCORE, CONTINENTS, COUNTRIES, EndorsementConfirmationRecordSchema, EndorsementRecordSchema, GraphFollowRecordSchema, INDUSTRY_OPTIONS, PLATFORM_LABELS, PLATFORM_OPTIONS, ProfileCertificationRecordSchema, ProfileCourseRecordSchema, ProfileEducationRecordSchema, ProfileExternalAccountRecordSchema, ProfileHonorRecordSchema, ProfileLanguageRecordSchema, ProfilePositionRecordSchema, ProfileProjectRecordSchema, ProfilePublicationRecordSchema, ProfileSelfRecordSchema, ProfileSkillRecordSchema, ProfileVolunteeringRecordSchema, PublicationAuthorSchema, SIFA_SDK_VERSION, SKILL_CATEGORIES, atUriSchema, certDateExtractor, cidSchema, completenessPercent, completenessScore, contrastRatio, countryCodeToFlag, dateRangeExtractor, datetimeSchema, dedupeSkills, detectPdsProvider, didSchema, findIndustry, formatDistanceToNow, formatLocation, formatRelativeTime, getContinent, getDisplayLabel, getFaviconUrl, getHandleStem, getIndustryLabelKey, getPdsDisplayName, getPlatformLabel, groupSkillsByCategory, isKnownPlatform, isValidRgbColor, languageTagSchema, lexiconDateExtractor, maxGraphemes, meetsContrastAA, parseLocationString, pdsProviderFromApi, relativeLuminance, rgbToString, sanitizeHandleInput, selfLabelsSchema, singleDateExtractor, sortByDateDesc, strongRefSchema, truncateGraphemes, uriSchema };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map