@singi-labs/sifa-sdk 0.7.7 → 0.7.8

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { P as ProfileSkill, L as LocationValue, a as PdsProviderInfo } from './index-IxlRuFsK.cjs';
-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.cjs';
+import { P as ProfileSkill, L as LocationValue, a as PdsProviderInfo, b as Profile } from './index-D0a04T88.cjs';
+export { A as ActiveApp, E as Endorsement, c as EndorsementData, d as ExternalAccount, e as ExternalAccountKeytraceClaim, F as FeedItem, f as LanguageProficiency, 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-D0a04T88.cjs';
 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.cjs';
 import 'zod';
 
@@ -281,6 +281,56 @@ declare function completenessScore(c: ProfileCompletion): number;
 /** Completion as a rounded 0..100 integer percent (matches API serialisation). */
 declare function completenessPercent(c: ProfileCompletion): number;
 
+/**
+ * Profile dimensions -- the routing signal used by the Sifa homepage to choose
+ * between the V3 "still building" and V4 "established" variants.
+ *
+ * Six binary signals, equal weight: avatar, headline, about, current position,
+ * minimum-skill threshold, and at least one education entry. The routing
+ * threshold itself (e.g. ">= 4 of 6 -> ESTABLISHED") lives in the consumer
+ * because different surfaces may want to cut at different bars over time.
+ *
+ * Canonical source of truth for dimension scoring across Sifa clients.
+ * sifa-api computes the underlying `ProfileDimensionInputs` shape inline
+ * (in SQL on the session route) but defers scoring to this module so the
+ * frontend and backend cannot drift on what "filled" means.
+ *
+ * See `docs/plans/2026-04-27-homepage-variants.md` (sifa-web) for the
+ * history of why these six were chosen over the original eight.
+ */
+
+declare const DIMENSIONS_MAX_SCORE = 6;
+declare const MIN_SKILLS = 3;
+type DimensionKey = 'avatar' | 'headline' | 'about' | 'currentPosition' | 'skills' | 'education';
+type DimensionMap = Record<DimensionKey, boolean>;
+/**
+ * Minimal raw inputs needed to compute the dimension map. sifa-api can
+ * populate this from a single composite SQL query without loading the full
+ * Profile shape, which is the whole point of putting this in the SDK.
+ */
+interface ProfileDimensionInputs {
+    hasAvatar: boolean;
+    hasHeadline: boolean;
+    hasAbout: boolean;
+    currentPositionCount: number;
+    skillCount: number;
+    educationCount: number;
+}
+/**
+ * Pure-TS computation of the 6-key boolean map from minimal inputs.
+ * Use this when you already have aggregate counts (e.g. server-side).
+ */
+declare function dimensionsFromInputs(inputs: ProfileDimensionInputs): DimensionMap;
+/**
+ * Derives `ProfileDimensionInputs` from a full Profile. Use this on the
+ * client when you already have the profile loaded.
+ */
+declare function profileToDimensionInputs(profile: Profile): ProfileDimensionInputs;
+/** Convenience: full Profile -> dimension boolean map. */
+declare function getFilledDimensionsMap(profile: Profile): DimensionMap;
+/** Count of filled dimensions, 0..6. Accepts either raw inputs or a full Profile. */
+declare function countFilledDimensions(input: ProfileDimensionInputs | Profile): number;
+
 /**
  * Sifa SDK -- public client library for the Sifa AppView on AT Protocol.
  *
@@ -290,4 +340,4 @@ declare function completenessPercent(c: ProfileCompletion): number;
  */
 declare const SIFA_SDK_VERSION: string;
 
-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 };
+export { CATEGORY_LABELS, CATEGORY_ORDER, COMPLETENESS_MAX_SCORE, CONTINENTS, COUNTRIES, type ContinentCode, DIMENSIONS_MAX_SCORE, type DimensionKey, type DimensionMap, INDUSTRY_OPTIONS, type IndustryOption, LocationValue, MIN_SKILLS, type MergedProfileSkill, PLATFORM_LABELS, PLATFORM_OPTIONS, type PdsProvider, PdsProviderInfo, type PlatformId, Profile, type ProfileCompletion, type ProfileDimensionInputs, ProfileSkill, type RgbColor, SIFA_SDK_VERSION, SKILL_CATEGORIES, type SkillCategory, certDateExtractor, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countryCodeToFlag, dateRangeExtractor, dedupeSkills, detectPdsProvider, dimensionsFromInputs, findIndustry, formatDistanceToNow, formatLocation, formatRelativeTime, getContinent, getDisplayLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getPdsDisplayName, getPlatformLabel, groupSkillsByCategory, isKnownPlatform, isValidRgbColor, lexiconDateExtractor, meetsContrastAA, parseLocationString, pdsProviderFromApi, profileToDimensionInputs, relativeLuminance, rgbToString, sanitizeHandleInput, singleDateExtractor, sortByDateDesc, truncateGraphemes };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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';
+import { P as ProfileSkill, L as LocationValue, a as PdsProviderInfo, b as Profile } from './index-D0a04T88.js';
+export { A as ActiveApp, E as Endorsement, c as EndorsementData, d as ExternalAccount, e as ExternalAccountKeytraceClaim, F as FeedItem, f as LanguageProficiency, 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-D0a04T88.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';
 
@@ -281,6 +281,56 @@ declare function completenessScore(c: ProfileCompletion): number;
 /** Completion as a rounded 0..100 integer percent (matches API serialisation). */
 declare function completenessPercent(c: ProfileCompletion): number;
 
+/**
+ * Profile dimensions -- the routing signal used by the Sifa homepage to choose
+ * between the V3 "still building" and V4 "established" variants.
+ *
+ * Six binary signals, equal weight: avatar, headline, about, current position,
+ * minimum-skill threshold, and at least one education entry. The routing
+ * threshold itself (e.g. ">= 4 of 6 -> ESTABLISHED") lives in the consumer
+ * because different surfaces may want to cut at different bars over time.
+ *
+ * Canonical source of truth for dimension scoring across Sifa clients.
+ * sifa-api computes the underlying `ProfileDimensionInputs` shape inline
+ * (in SQL on the session route) but defers scoring to this module so the
+ * frontend and backend cannot drift on what "filled" means.
+ *
+ * See `docs/plans/2026-04-27-homepage-variants.md` (sifa-web) for the
+ * history of why these six were chosen over the original eight.
+ */
+
+declare const DIMENSIONS_MAX_SCORE = 6;
+declare const MIN_SKILLS = 3;
+type DimensionKey = 'avatar' | 'headline' | 'about' | 'currentPosition' | 'skills' | 'education';
+type DimensionMap = Record<DimensionKey, boolean>;
+/**
+ * Minimal raw inputs needed to compute the dimension map. sifa-api can
+ * populate this from a single composite SQL query without loading the full
+ * Profile shape, which is the whole point of putting this in the SDK.
+ */
+interface ProfileDimensionInputs {
+    hasAvatar: boolean;
+    hasHeadline: boolean;
+    hasAbout: boolean;
+    currentPositionCount: number;
+    skillCount: number;
+    educationCount: number;
+}
+/**
+ * Pure-TS computation of the 6-key boolean map from minimal inputs.
+ * Use this when you already have aggregate counts (e.g. server-side).
+ */
+declare function dimensionsFromInputs(inputs: ProfileDimensionInputs): DimensionMap;
+/**
+ * Derives `ProfileDimensionInputs` from a full Profile. Use this on the
+ * client when you already have the profile loaded.
+ */
+declare function profileToDimensionInputs(profile: Profile): ProfileDimensionInputs;
+/** Convenience: full Profile -> dimension boolean map. */
+declare function getFilledDimensionsMap(profile: Profile): DimensionMap;
+/** Count of filled dimensions, 0..6. Accepts either raw inputs or a full Profile. */
+declare function countFilledDimensions(input: ProfileDimensionInputs | Profile): number;
+
 /**
  * Sifa SDK -- public client library for the Sifa AppView on AT Protocol.
  *
@@ -290,4 +340,4 @@ declare function completenessPercent(c: ProfileCompletion): number;
  */
 declare const SIFA_SDK_VERSION: string;
 
-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 };
+export { CATEGORY_LABELS, CATEGORY_ORDER, COMPLETENESS_MAX_SCORE, CONTINENTS, COUNTRIES, type ContinentCode, DIMENSIONS_MAX_SCORE, type DimensionKey, type DimensionMap, INDUSTRY_OPTIONS, type IndustryOption, LocationValue, MIN_SKILLS, type MergedProfileSkill, PLATFORM_LABELS, PLATFORM_OPTIONS, type PdsProvider, PdsProviderInfo, type PlatformId, Profile, type ProfileCompletion, type ProfileDimensionInputs, ProfileSkill, type RgbColor, SIFA_SDK_VERSION, SKILL_CATEGORIES, type SkillCategory, certDateExtractor, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countryCodeToFlag, dateRangeExtractor, dedupeSkills, detectPdsProvider, dimensionsFromInputs, findIndustry, formatDistanceToNow, formatLocation, formatRelativeTime, getContinent, getDisplayLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getPdsDisplayName, getPlatformLabel, groupSkillsByCategory, isKnownPlatform, isValidRgbColor, lexiconDateExtractor, meetsContrastAA, parseLocationString, pdsProviderFromApi, profileToDimensionInputs, relativeLuminance, rgbToString, sanitizeHandleInput, singleDateExtractor, sortByDateDesc, truncateGraphemes };

package/dist/index.js

@@ -942,6 +942,48 @@ function completenessScore(c) {
 function completenessPercent(c) {
   return Math.round(completenessScore(c) / COMPLETENESS_MAX_SCORE * 100);
 }
+
+// src/logic/profile-dimensions.ts
+var DIMENSIONS_MAX_SCORE = 6;
+var MIN_SKILLS = 3;
+function nonEmptyString(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function dimensionsFromInputs(inputs) {
+  return {
+    avatar: inputs.hasAvatar,
+    headline: inputs.hasHeadline,
+    about: inputs.hasAbout,
+    currentPosition: inputs.currentPositionCount > 0,
+    skills: inputs.skillCount >= MIN_SKILLS,
+    education: inputs.educationCount > 0
+  };
+}
+function profileToDimensionInputs(profile) {
+  const positions = profile.positions ?? [];
+  const skills = profile.skills ?? [];
+  const education = profile.education ?? [];
+  const currentPositionCount = positions.filter((p) => !p.endedAt).length;
+  return {
+    hasAvatar: nonEmptyString(profile.avatar),
+    hasHeadline: nonEmptyString(profile.headline),
+    hasAbout: nonEmptyString(profile.about),
+    currentPositionCount,
+    skillCount: skills.length,
+    educationCount: education.length
+  };
+}
+function getFilledDimensionsMap(profile) {
+  return dimensionsFromInputs(profileToDimensionInputs(profile));
+}
+function countFilledDimensions(input) {
+  const map = "hasAvatar" in input ? dimensionsFromInputs(input) : getFilledDimensionsMap(input);
+  let n = 0;
+  for (const v of Object.values(map)) {
+    if (v) n++;
+  }
+  return n;
+}
 function maxGraphemes(max) {
   return (value) => {
     const segmenter = new Intl.Segmenter(void 0, { granularity: "grapheme" });
@@ -1102,8 +1144,8 @@ var ProfileVolunteeringRecordSchema = z.object({
 });
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.7.7";
+var SIFA_SDK_VERSION = "0.7.8";
 
-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 };
+export { CATEGORY_LABELS, CATEGORY_ORDER, COMPLETENESS_MAX_SCORE, CONTINENTS, COUNTRIES, DIMENSIONS_MAX_SCORE, EndorsementConfirmationRecordSchema, EndorsementRecordSchema, GraphFollowRecordSchema, INDUSTRY_OPTIONS, MIN_SKILLS, 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, countFilledDimensions, countryCodeToFlag, dateRangeExtractor, datetimeSchema, dedupeSkills, detectPdsProvider, didSchema, dimensionsFromInputs, findIndustry, formatDistanceToNow, formatLocation, formatRelativeTime, getContinent, getDisplayLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getPdsDisplayName, getPlatformLabel, groupSkillsByCategory, isKnownPlatform, isValidRgbColor, languageTagSchema, lexiconDateExtractor, maxGraphemes, meetsContrastAA, parseLocationString, pdsProviderFromApi, profileToDimensionInputs, relativeLuminance, rgbToString, sanitizeHandleInput, selfLabelsSchema, singleDateExtractor, sortByDateDesc, strongRefSchema, truncateGraphemes, uriSchema };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map