@singi-labs/sifa-sdk 0.19.74 → 0.19.76

package/dist/format/index.js

@@ -24,6 +24,7 @@ import {
   sortByDateDesc
 } from "./sort-by-date.js";
 import { normalizeDoi } from "./doi.js";
+import { openAlexWorkUrl } from "./openalex.js";
 import {
   formatRelationship,
   parseEndorsementComment
@@ -86,6 +87,7 @@ export {
   normalizeCompanyKey,
   normalizeDoi,
   normalizeLegalForm,
+  openAlexWorkUrl,
   parseEndorsementComment,
   parseLocationString,
   parseTalkRkey,

package/dist/format/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/format/index.ts"],"sourcesContent":["export { formatCompanyName } from './company-name.js';\nexport { normalizeLegalForm } from './normalize-legal-form.js';\nexport { normalizeCompanyKey } from './normalize-company-key.js';\nexport { formatIsoTitle, formatRelativeTime } from './format-time.js';\nexport { formatPresentationDuration } from './format-duration.js';\nexport {\n  formatCredentialDateRange,\n  formatDateRange,\n  formatPositionDateRange,\n  formatTimelineDate,\n} from './timeline.js';\nexport {\n  collapseContributors,\n  type CollapseContributorsOptions,\n  type CollapsedContributors,\n} from './collapse-contributors.js';\nexport {\n  summarizePresentationDeliveries,\n  type PresentationDeliverySummary,\n} from './summarize-deliveries.js';\nexport {\n  certDateExtractor,\n  dateRangeExtractor,\n  lexiconDateExtractor,\n  singleDateExtractor,\n  sortByDateDesc,\n} from './sort-by-date.js';\nexport { normalizeDoi } from './doi.js';\nexport {\n  formatRelationship,\n  parseEndorsementComment,\n  type ParsedEndorsementComment,\n} from './endorsement-context.js';\nexport { sanitizeHandleInput } from './handle-utils.js';\nexport { countryCodeToFlag, formatLocation, parseLocationString } from './location-utils.js';\nexport { locationSegments } from './location-segments.js';\nexport type {\n  LocationSegment,\n  LocationSegmentKind,\n  LocationSegmentsOptions,\n} from './location-segments.js';\nexport {\n  detectPdsProvider,\n  formatStructuredName,\n  getDisplayLabel,\n  getHandleStem,\n  getPdsDisplayName,\n  pdsProviderFromApi,\n  type PdsProvider,\n} from './pds-utils.js';\nexport { resolveEmbed, youtubeVideoId, youtubeThumbnailUrl, type EmbedResult } from './embed.js';\nexport { buildTalkSlug, parseTalkRkey, slugifyTitle } from './talk-slug.js';\nexport { buildMetaDescription } from './meta-description.js';\nexport type { MetaDescriptionInput, MetaDescriptionPosition } from './meta-description.js';\nexport { limitCombiningMarks, sanitizeDisplayText } from './text-sanitize.js';\nexport { truncateGraphemes } from './text-truncate.js';\nexport { formatDisplayUrl } from './format-display-url.js';\nexport type { DisplayUrl, FormatDisplayUrlOptions, UrlPathPolicy } from './format-display-url.js';\nexport { formatDistanceToNow } from './time-utils.js';\nexport {\n  contrastRatio,\n  isValidRgbColor,\n  meetsContrastAA,\n  relativeLuminance,\n  rgbToString,\n  type RgbColor,\n} from './wcag-contrast.js';\n"],"mappings":";AAAA,SAAS,yBAAyB;AAClC,SAAS,0BAA0B;AACnC,SAAS,2BAA2B;AACpC,SAAS,gBAAgB,0BAA0B;AACnD,SAAS,kCAAkC;AAC3C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,OAGK;AACP;AAAA,EACE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,oBAAoB;AAC7B;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,SAAS,2BAA2B;AACpC,SAAS,mBAAmB,gBAAgB,2BAA2B;AACvE,SAAS,wBAAwB;AAMjC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,cAAc,gBAAgB,2BAA6C;AACpF,SAAS,eAAe,eAAe,oBAAoB;AAC3D,SAAS,4BAA4B;AAErC,SAAS,qBAAqB,2BAA2B;AACzD,SAAS,yBAAyB;AAClC,SAAS,wBAAwB;AAEjC,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;","names":[]}
+{"version":3,"sources":["../../src/format/index.ts"],"sourcesContent":["export { formatCompanyName } from './company-name.js';\nexport { normalizeLegalForm } from './normalize-legal-form.js';\nexport { normalizeCompanyKey } from './normalize-company-key.js';\nexport { formatIsoTitle, formatRelativeTime } from './format-time.js';\nexport { formatPresentationDuration } from './format-duration.js';\nexport {\n  formatCredentialDateRange,\n  formatDateRange,\n  formatPositionDateRange,\n  formatTimelineDate,\n} from './timeline.js';\nexport {\n  collapseContributors,\n  type CollapseContributorsOptions,\n  type CollapsedContributors,\n} from './collapse-contributors.js';\nexport {\n  summarizePresentationDeliveries,\n  type PresentationDeliverySummary,\n} from './summarize-deliveries.js';\nexport {\n  certDateExtractor,\n  dateRangeExtractor,\n  lexiconDateExtractor,\n  singleDateExtractor,\n  sortByDateDesc,\n} from './sort-by-date.js';\nexport { normalizeDoi } from './doi.js';\nexport { openAlexWorkUrl } from './openalex.js';\nexport {\n  formatRelationship,\n  parseEndorsementComment,\n  type ParsedEndorsementComment,\n} from './endorsement-context.js';\nexport { sanitizeHandleInput } from './handle-utils.js';\nexport { countryCodeToFlag, formatLocation, parseLocationString } from './location-utils.js';\nexport { locationSegments } from './location-segments.js';\nexport type {\n  LocationSegment,\n  LocationSegmentKind,\n  LocationSegmentsOptions,\n} from './location-segments.js';\nexport {\n  detectPdsProvider,\n  formatStructuredName,\n  getDisplayLabel,\n  getHandleStem,\n  getPdsDisplayName,\n  pdsProviderFromApi,\n  type PdsProvider,\n} from './pds-utils.js';\nexport { resolveEmbed, youtubeVideoId, youtubeThumbnailUrl, type EmbedResult } from './embed.js';\nexport { buildTalkSlug, parseTalkRkey, slugifyTitle } from './talk-slug.js';\nexport { buildMetaDescription } from './meta-description.js';\nexport type { MetaDescriptionInput, MetaDescriptionPosition } from './meta-description.js';\nexport { limitCombiningMarks, sanitizeDisplayText } from './text-sanitize.js';\nexport { truncateGraphemes } from './text-truncate.js';\nexport { formatDisplayUrl } from './format-display-url.js';\nexport type { DisplayUrl, FormatDisplayUrlOptions, UrlPathPolicy } from './format-display-url.js';\nexport { formatDistanceToNow } from './time-utils.js';\nexport {\n  contrastRatio,\n  isValidRgbColor,\n  meetsContrastAA,\n  relativeLuminance,\n  rgbToString,\n  type RgbColor,\n} from './wcag-contrast.js';\n"],"mappings":";AAAA,SAAS,yBAAyB;AAClC,SAAS,0BAA0B;AACnC,SAAS,2BAA2B;AACpC,SAAS,gBAAgB,0BAA0B;AACnD,SAAS,kCAAkC;AAC3C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,OAGK;AACP;AAAA,EACE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,oBAAoB;AAC7B,SAAS,uBAAuB;AAChC;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,SAAS,2BAA2B;AACpC,SAAS,mBAAmB,gBAAgB,2BAA2B;AACvE,SAAS,wBAAwB;AAMjC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,cAAc,gBAAgB,2BAA6C;AACpF,SAAS,eAAe,eAAe,oBAAoB;AAC3D,SAAS,4BAA4B;AAErC,SAAS,qBAAqB,2BAA2B;AACzD,SAAS,yBAAyB;AAClC,SAAS,wBAAwB;AAEjC,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;","names":[]}

package/dist/format/openalex.js

@@ -0,0 +1,10 @@
+// src/format/openalex.ts
+var WORK_ID = /^(?:https:\/\/openalex\.org\/)?(W\d+)$/;
+function openAlexWorkUrl(id) {
+  const match = id ? WORK_ID.exec(id.trim()) : null;
+  return match ? `https://openalex.org/${match[1]}` : void 0;
+}
+export {
+  openAlexWorkUrl
+};
+//# sourceMappingURL=openalex.js.map

package/dist/format/openalex.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/format/openalex.ts"],"sourcesContent":["const WORK_ID = /^(?:https:\\/\\/openalex\\.org\\/)?(W\\d+)$/;\n\n/**\n * The openalex.org page for an OpenAlex work id (`W2741809807`, or the full\n * `https://openalex.org/W2741809807` the API returns). A citation count links\n * here so a reader can see where the number comes from. Anything that is not a\n * work id returns `undefined`, so the caller renders the count without a link.\n */\nexport function openAlexWorkUrl(id: string | undefined): string | undefined {\n  const match = id ? WORK_ID.exec(id.trim()) : null;\n  return match ? `https://openalex.org/${match[1]}` : undefined;\n}\n"],"mappings":";AAAA,IAAM,UAAU;AAQT,SAAS,gBAAgB,IAA4C;AAC1E,QAAM,QAAQ,KAAK,QAAQ,KAAK,GAAG,KAAK,CAAC,IAAI;AAC7C,SAAO,QAAQ,wBAAwB,MAAM,CAAC,CAAC,KAAK;AACtD;","names":[]}

package/dist/{index-BFdNI6jA.d.ts → index-DAiJZvPg.d.ts}

@@ -382,6 +382,14 @@ interface ProfilePublication {
      * to `groupPublicationVersions` to fold a preprint under its published version.
      */
     relatedIdentifiers?: RelatedIdentifier[];
+    /**
+     * Times this work has been cited, as counted by OpenAlex for its DOI. Only
+     * sent when the profile owner turned citation counts on and OpenAlex knows
+     * the DOI. A display value, never a ranking signal.
+     */
+    citationCount?: number;
+    /** OpenAlex work id (`W…`) the count belongs to; see `openAlexWorkUrl`. */
+    openAlexId?: string;
 }
 interface ProfileVolunteering {
     rkey: string;

package/dist/{index-BzkaABDb.d.cts → index-k6tBrbEU.d.cts}

@@ -382,6 +382,14 @@ interface ProfilePublication {
      * to `groupPublicationVersions` to fold a preprint under its published version.
      */
     relatedIdentifiers?: RelatedIdentifier[];
+    /**
+     * Times this work has been cited, as counted by OpenAlex for its DOI. Only
+     * sent when the profile owner turned citation counts on and OpenAlex knows
+     * the DOI. A display value, never a ranking signal.
+     */
+    citationCount?: number;
+    /** OpenAlex work id (`W…`) the count belongs to; see `openAlexWorkUrl`. */
+    openAlexId?: string;
 }
 interface ProfileVolunteering {
     rkey: string;

package/dist/index.cjs

@@ -2958,6 +2958,13 @@ function normalizeDoi(value) {
   return value.trim().replace(/^https?:\/\/(dx\.)?doi\.org\//i, "").replace(/^doi:\s*/i, "");
 }
 
+// src/format/openalex.ts
+var WORK_ID = /^(?:https:\/\/openalex\.org\/)?(W\d+)$/;
+function openAlexWorkUrl(id) {
+  const match = id ? WORK_ID.exec(id.trim()) : null;
+  return match ? `https://openalex.org/${match[1]}` : void 0;
+}
+
 // src/format/endorsement-context.ts
 var RELATIONSHIP_PREFIX = /^\[(\w+?)(?:: ([^\]]+))?\]\s*/;
 function formatRelationship(type, detail) {
@@ -5980,6 +5987,56 @@ function excludeSelfApp(apps) {
 function actorShowsIdentity(actor) {
   return !!(actor.confirmed || actor.claimed);
 }
+var SITE_PRESET_MAX_TAGS = 20;
+var SITE_PRESET_MAX_TAG_LENGTH = 64;
+var siteActivityPresetSchema = zod.z.object({
+  categories: zod.z.array(zod.z.string().min(1).max(100)).max(100),
+  tags: zod.z.array(zod.z.string().min(1).max(SITE_PRESET_MAX_TAG_LENGTH)).max(SITE_PRESET_MAX_TAGS)
+});
+var EMPTY_SITE_ACTIVITY_PRESET = { categories: [], tags: [] };
+var SITE_PRESET_TAG_CATEGORY = "Articles";
+function normalizeSitePresetTag(raw) {
+  const tag = raw.trim().replace(/^#+/, "").trim().replace(/\s+/g, " ").toLowerCase();
+  if (tag.length === 0 || tag.length > SITE_PRESET_MAX_TAG_LENGTH) return null;
+  return tag;
+}
+function parseSitePresetTags(input) {
+  const parts = (typeof input === "string" ? [input] : input).flatMap((s) => s.split(/[,\n]/));
+  const out = [];
+  for (const part of parts) {
+    const tag = normalizeSitePresetTag(part);
+    if (tag && !out.includes(tag)) out.push(tag);
+    if (out.length >= SITE_PRESET_MAX_TAGS) break;
+  }
+  return out;
+}
+function isSiteActivityPresetActive(preset) {
+  return preset.categories.length > 0 || preset.tags.length > 0;
+}
+function recordTags(record) {
+  if (typeof record !== "object" || record === null) return [];
+  const tags = "tags" in record ? record.tags : void 0;
+  if (!Array.isArray(tags)) return [];
+  const out = [];
+  for (const t of tags) {
+    if (typeof t !== "string") continue;
+    const tag = normalizeSitePresetTag(t);
+    if (tag) out.push(tag);
+  }
+  return out;
+}
+function matchesSitePresetTags(item, tags) {
+  if (tags.length === 0 || item.category !== SITE_PRESET_TAG_CATEGORY) return true;
+  return recordTags(item.record).some((t) => tags.includes(t));
+}
+function matchesSiteActivityPreset(item, preset) {
+  if (preset.categories.length > 0 && !preset.categories.includes(item.category)) return false;
+  return matchesSitePresetTags(item, preset.tags);
+}
+var siteActivityPresetUpdateSchema = zod.z.object({
+  categories: zod.z.array(zod.z.string().refine(isAppCategory, { message: "Unknown category" })).max(100).transform((list) => [...new Set(list)]),
+  tags: zod.z.array(zod.z.string().max(200)).max(100).transform((list) => parseSitePresetTags(list))
+});
 
 // src/profile/range-sort.ts
 var hasValue = (date) => !!date;
@@ -7250,7 +7307,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.74";
+var SIFA_SDK_VERSION = "0.19.76";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VERBS = ACTIVITY_VERBS;
@@ -7288,6 +7345,7 @@ exports.DIMENSIONS_MAX_SCORE = DIMENSIONS_MAX_SCORE;
 exports.EMPLOYMENT_STATUS_TOKENS = EMPLOYMENT_STATUS_TOKENS;
 exports.EMPLOYMENT_TYPE_GROUPS = EMPLOYMENT_TYPE_GROUPS;
 exports.EMPLOYMENT_TYPE_LABELS = EMPLOYMENT_TYPE_LABELS;
+exports.EMPTY_SITE_ACTIVITY_PRESET = EMPTY_SITE_ACTIVITY_PRESET;
 exports.ENTITY_REF_ANCHORS = ENTITY_REF_ANCHORS;
 exports.EQF_LEVEL_LABELS = EQF_LEVEL_LABELS;
 exports.EQF_LEVEL_OPTIONS = EQF_LEVEL_OPTIONS;
@@ -7373,6 +7431,9 @@ exports.SECTION_LABELS = SECTION_LABELS;
 exports.SELF_APP_ID = SELF_APP_ID;
 exports.SIFA_REPO_GROUPS = SIFA_REPO_GROUPS;
 exports.SIFA_SDK_VERSION = SIFA_SDK_VERSION;
+exports.SITE_PRESET_MAX_TAGS = SITE_PRESET_MAX_TAGS;
+exports.SITE_PRESET_MAX_TAG_LENGTH = SITE_PRESET_MAX_TAG_LENGTH;
+exports.SITE_PRESET_TAG_CATEGORY = SITE_PRESET_TAG_CATEGORY;
 exports.SKILL_CATEGORIES = SKILL_CATEGORIES;
 exports.STANDARD_PUBLISHER_ID = STANDARD_PUBLISHER_ID;
 exports.STREAM_VERBS = STREAM_VERBS;
@@ -7492,6 +7553,7 @@ exports.isRelationalActivity = isRelationalActivity;
 exports.isRoleLineRedundant = isRoleLineRedundant;
 exports.isSectionPopulated = isSectionPopulated;
 exports.isSelfAuthoredRich = isSelfAuthoredRich;
+exports.isSiteActivityPresetActive = isSiteActivityPresetActive;
 exports.isTeachingCourse = isTeachingCourse;
 exports.isUpcomingStart = isUpcomingStart;
 exports.isValidRgbColor = isValidRgbColor;
@@ -7502,6 +7564,8 @@ exports.limitCombiningMarks = limitCombiningMarks;
 exports.locationSegments = locationSegments;
 exports.looksLikeDomain = looksLikeDomain;
 exports.makeGraphFollowRecordSchema = makeGraphFollowRecordSchema;
+exports.matchesSiteActivityPreset = matchesSiteActivityPreset;
+exports.matchesSitePresetTags = matchesSitePresetTags;
 exports.maxGraphemes = maxGraphemes;
 exports.meetsContrastAA = meetsContrastAA;
 exports.normalizeCompanyKey = normalizeCompanyKey;
@@ -7511,14 +7575,17 @@ exports.normalizeOpenTo = normalizeOpenTo;
 exports.normalizePlatformId = normalizePlatformId;
 exports.normalizePresentationMode = normalizePresentationMode;
 exports.normalizePresentationRole = normalizePresentationRole;
+exports.normalizeSitePresetTag = normalizeSitePresetTag;
 exports.normalizeSkillCategory = normalizeSkillCategory;
 exports.normalizeWorkplaceTypes = normalizeWorkplaceTypes;
+exports.openAlexWorkUrl = openAlexWorkUrl;
 exports.openToTokenToValue = openToTokenToValue;
 exports.openToValueToToken = openToValueToToken;
 exports.parseEndorsementComment = parseEndorsementComment;
 exports.parseIntendedAudiences = parseIntendedAudiences;
 exports.parseLocationString = parseLocationString;
 exports.parsePresentationDuration = parsePresentationDuration;
+exports.parseSitePresetTags = parseSitePresetTags;
 exports.parseTalkRkey = parseTalkRkey;
 exports.partialDateSchema = partialDateSchema;
 exports.pdsProviderFromApi = pdsProviderFromApi;
@@ -7530,6 +7597,7 @@ exports.primaryVerification = primaryVerification;
 exports.profileToDimensionInputs = profileToDimensionInputs;
 exports.qualifiesAsOrg = qualifiesAsOrg;
 exports.readEqfLevel = readEqfLevel;
+exports.recordTags = recordTags;
 exports.relativeLuminance = relativeLuminance;
 exports.renderAsLine = renderAsLine;
 exports.rendersCompanyProfile = rendersCompanyProfile;
@@ -7550,6 +7618,8 @@ exports.searchResultDisambiguation = searchResultDisambiguation;
 exports.selfLabelsSchema = selfLabelsSchema;
 exports.shouldRenderHighlights = shouldRenderHighlights;
 exports.singleDateExtractor = singleDateExtractor;
+exports.siteActivityPresetSchema = siteActivityPresetSchema;
+exports.siteActivityPresetUpdateSchema = siteActivityPresetUpdateSchema;
 exports.skillRefSchema = skillRefSchema;
 exports.slugifyTitle = slugifyTitle;
 exports.sortByActiveDateRange = sortByActiveDateRange;