@singi-labs/sifa-sdk 0.19.32 → 0.19.33

package/dist/{index-piLIwMN1.d.cts → index-CH8NiQwH.d.cts}

@@ -255,6 +255,17 @@ interface AuthorSuggestion {
     /** Display name on the matched account, for showing what is being proposed. */
     displayName?: string;
 }
+/**
+ * A typed link from a work to another version or form of it
+ * (`id.sifa.defs#relatedIdentifier`). `relationType` uses the DataCite
+ * vocabulary, e.g. `IsPreprintOf` on a preprint pointing at its published
+ * version. `identifierType` is `DOI` (the default when absent), `AT-URI` or `URL`.
+ */
+interface RelatedIdentifier {
+    identifier: string;
+    identifierType?: string;
+    relationType: string;
+}
 interface ProfilePublication {
     rkey: string;
     title: string;
@@ -293,6 +304,12 @@ interface ProfilePublication {
      * for Sifa/ORCID publications, null when none could be resolved.
      */
     image?: string | null;
+    /**
+     * Other versions or forms of this work: relations declared on the record
+     * plus, for a DOI, those registered with DataCite or Crossref (#590). Feed
+     * to `groupPublicationVersions` to fold a preprint under its published version.
+     */
+    relatedIdentifiers?: RelatedIdentifier[];
 }
 interface ProfileVolunteering {
     rkey: string;
@@ -932,4 +949,4 @@ interface Profile {
     externalAccounts?: ExternalAccount[];
 }
 
-export { type AccountFacetMode as A, type ProfileInvestmentLink as B, type CoSpeaker as C, type ProfileInvolvementLink as D, type Endorsement as E, type FeedItem as F, type ProfileLocation as G, type ProfileOverrideSource as H, type ProfilePresentation as I, type ProfileVolunteering as J, type ProjectMemberCard as K, type LocationValue as L, type ProjectRole as M, type PublicationContributor as N, type OrgAddressView as O, type ProfileSkill as P, type SkillSuggestion as Q, type RecognizedEntity as R, type SkillRef as S, type TrustStat as T, type VerifiedAccount as V, type ProfilePresentationDelivery as a, type PdsProviderInfo as b, type Profile as c, type ProfilePosition as d, type ProfileCertification as e, type ProfileEducation as f, type ProfileHonor as g, type ProfileLanguage as h, type ProfileProject as i, type ProfilePublication as j, type ProfileInvolvement as k, type ActiveApp as l, type ActorCard as m, type AuthorSuggestion as n, type EndorsementData as o, type ExternalAccount as p, type ExternalAccountKeytraceClaim as q, type LanguageProficiency as r, type OrgFloorVerdict as s, type OrgLinkView as t, type OrgProfileView as u, PROJECT_ROLES as v, type PresentationLinkView as w, type ProfileCourse as x, type ProfileIndustry as y, type ProfileInvestment as z };
+export { type AccountFacetMode as A, type ProfileInvestmentLink as B, type CoSpeaker as C, type ProfileInvolvementLink as D, type Endorsement as E, type FeedItem as F, type ProfileLocation as G, type ProfileOverrideSource as H, type ProfilePresentation as I, type ProfileVolunteering as J, type ProjectMemberCard as K, type LocationValue as L, type ProjectRole as M, type PublicationContributor as N, type OrgAddressView as O, type ProfileSkill as P, type RecognizedEntity as Q, type RelatedIdentifier as R, type SkillRef as S, type SkillSuggestion as T, type TrustStat as U, type VerifiedAccount as V, type ProfilePresentationDelivery as a, type PdsProviderInfo as b, type Profile as c, type ProfilePosition as d, type ProfileCertification as e, type ProfileEducation as f, type ProfileHonor as g, type ProfileLanguage as h, type ProfileProject as i, type ProfilePublication as j, type ProfileInvolvement as k, type ActiveApp as l, type ActorCard as m, type AuthorSuggestion as n, type EndorsementData as o, type ExternalAccount as p, type ExternalAccountKeytraceClaim as q, type LanguageProficiency as r, type OrgFloorVerdict as s, type OrgLinkView as t, type OrgProfileView as u, PROJECT_ROLES as v, type PresentationLinkView as w, type ProfileCourse as x, type ProfileIndustry as y, type ProfileInvestment as z };

package/dist/{index-CpbCm2Fe.d.ts → index-ayiu2kGy.d.ts}

@@ -255,6 +255,17 @@ interface AuthorSuggestion {
     /** Display name on the matched account, for showing what is being proposed. */
     displayName?: string;
 }
+/**
+ * A typed link from a work to another version or form of it
+ * (`id.sifa.defs#relatedIdentifier`). `relationType` uses the DataCite
+ * vocabulary, e.g. `IsPreprintOf` on a preprint pointing at its published
+ * version. `identifierType` is `DOI` (the default when absent), `AT-URI` or `URL`.
+ */
+interface RelatedIdentifier {
+    identifier: string;
+    identifierType?: string;
+    relationType: string;
+}
 interface ProfilePublication {
     rkey: string;
     title: string;
@@ -293,6 +304,12 @@ interface ProfilePublication {
      * for Sifa/ORCID publications, null when none could be resolved.
      */
     image?: string | null;
+    /**
+     * Other versions or forms of this work: relations declared on the record
+     * plus, for a DOI, those registered with DataCite or Crossref (#590). Feed
+     * to `groupPublicationVersions` to fold a preprint under its published version.
+     */
+    relatedIdentifiers?: RelatedIdentifier[];
 }
 interface ProfileVolunteering {
     rkey: string;
@@ -932,4 +949,4 @@ interface Profile {
     externalAccounts?: ExternalAccount[];
 }
 
-export { type AccountFacetMode as A, type ProfileInvestmentLink as B, type CoSpeaker as C, type ProfileInvolvementLink as D, type Endorsement as E, type FeedItem as F, type ProfileLocation as G, type ProfileOverrideSource as H, type ProfilePresentation as I, type ProfileVolunteering as J, type ProjectMemberCard as K, type LocationValue as L, type ProjectRole as M, type PublicationContributor as N, type OrgAddressView as O, type ProfileSkill as P, type SkillSuggestion as Q, type RecognizedEntity as R, type SkillRef as S, type TrustStat as T, type VerifiedAccount as V, type ProfilePresentationDelivery as a, type PdsProviderInfo as b, type Profile as c, type ProfilePosition as d, type ProfileCertification as e, type ProfileEducation as f, type ProfileHonor as g, type ProfileLanguage as h, type ProfileProject as i, type ProfilePublication as j, type ProfileInvolvement as k, type ActiveApp as l, type ActorCard as m, type AuthorSuggestion as n, type EndorsementData as o, type ExternalAccount as p, type ExternalAccountKeytraceClaim as q, type LanguageProficiency as r, type OrgFloorVerdict as s, type OrgLinkView as t, type OrgProfileView as u, PROJECT_ROLES as v, type PresentationLinkView as w, type ProfileCourse as x, type ProfileIndustry as y, type ProfileInvestment as z };
+export { type AccountFacetMode as A, type ProfileInvestmentLink as B, type CoSpeaker as C, type ProfileInvolvementLink as D, type Endorsement as E, type FeedItem as F, type ProfileLocation as G, type ProfileOverrideSource as H, type ProfilePresentation as I, type ProfileVolunteering as J, type ProjectMemberCard as K, type LocationValue as L, type ProjectRole as M, type PublicationContributor as N, type OrgAddressView as O, type ProfileSkill as P, type RecognizedEntity as Q, type RelatedIdentifier as R, type SkillRef as S, type SkillSuggestion as T, type TrustStat as U, type VerifiedAccount as V, type ProfilePresentationDelivery as a, type PdsProviderInfo as b, type Profile as c, type ProfilePosition as d, type ProfileCertification as e, type ProfileEducation as f, type ProfileHonor as g, type ProfileLanguage as h, type ProfileProject as i, type ProfilePublication as j, type ProfileInvolvement as k, type ActiveApp as l, type ActorCard as m, type AuthorSuggestion as n, type EndorsementData as o, type ExternalAccount as p, type ExternalAccountKeytraceClaim as q, type LanguageProficiency as r, type OrgFloorVerdict as s, type OrgLinkView as t, type OrgProfileView as u, PROJECT_ROLES as v, type PresentationLinkView as w, type ProfileCourse as x, type ProfileIndustry as y, type ProfileInvestment as z };

package/dist/index.cjs

@@ -5669,6 +5669,100 @@ function groupInvolvementByHeading(items) {
   return groups;
 }
 
+// src/profile/publication-versions.ts
+var PREPRINT_OF = /* @__PURE__ */ new Set(["IsPreprintOf", "IsPublishedIn"]);
+var DEFERS_TO = /* @__PURE__ */ new Set(["IsVersionOf", "IsPreviousVersionOf"]);
+var doiKey = (doi) => `doi:${normalizeDoi(doi).toLowerCase()}`;
+function targetKey(rel) {
+  const id = rel.identifier?.trim();
+  if (!id) return void 0;
+  const type = rel.identifierType ?? "DOI";
+  if (type === "AT-URI") return `uri:${id}`;
+  if (type === "URL") {
+    const bare = normalizeDoi(id);
+    return bare.startsWith("10.") ? doiKey(bare) : `url:${id}`;
+  }
+  return doiKey(id);
+}
+function groupPublicationVersions(pubs, options = {}) {
+  const keyToIndex = /* @__PURE__ */ new Map();
+  pubs.forEach((p, i) => {
+    if (p.doi) keyToIndex.set(doiKey(p.doi), i);
+    if (options.ownerDid && (!p.source || p.source === "sifa")) {
+      keyToIndex.set(`uri:at://${options.ownerDid}/id.sifa.profile.publication/${p.rkey}`, i);
+    }
+    if (p.publicationUri) keyToIndex.set(`uri:${p.publicationUri}`, i);
+  });
+  const parent = pubs.map((_, i) => i);
+  const find = (i) => {
+    while (parent[i] !== i) {
+      parent[i] = parent[parent[i]];
+      i = parent[i];
+    }
+    return i;
+  };
+  const union = (a, b) => {
+    const ra = find(a);
+    const rb = find(b);
+    if (ra !== rb) parent[rb] = ra;
+  };
+  const preprints = /* @__PURE__ */ new Set();
+  const deferring = /* @__PURE__ */ new Set();
+  const siblingsOf = /* @__PURE__ */ new Map();
+  pubs.forEach((p, i) => {
+    if (p.type === "preprint") preprints.add(i);
+    for (const rel of p.relatedIdentifiers ?? []) {
+      const key = targetKey(rel);
+      if (!key) continue;
+      const j = keyToIndex.get(key);
+      if (j === void 0) {
+        if (rel.relationType === "IsVersionOf") {
+          const first = siblingsOf.get(key);
+          if (first === void 0) siblingsOf.set(key, i);
+          else union(first, i);
+        }
+        continue;
+      }
+      if (j === i) continue;
+      union(i, j);
+      if (PREPRINT_OF.has(rel.relationType)) preprints.add(i);
+      if (DEFERS_TO.has(rel.relationType)) deferring.add(i);
+      if (rel.relationType === "HasPreprint") preprints.add(j);
+    }
+  });
+  const members = /* @__PURE__ */ new Map();
+  pubs.forEach((_, i) => {
+    const root = find(i);
+    const list = members.get(root);
+    if (list) list.push(i);
+    else members.set(root, [i]);
+  });
+  const newestFirst = (a, b) => {
+    const da = pubs[a].date ?? "";
+    const db = pubs[b].date ?? "";
+    if (da !== db) return db.localeCompare(da);
+    const fa = deferring.has(a) ? 1 : 0;
+    const fb = deferring.has(b) ? 1 : 0;
+    if (fa !== fb) return fa - fb;
+    return a - b;
+  };
+  const groups = [];
+  for (const indexes of members.values()) {
+    const primary = indexes.find((i) => pubs[i].primary);
+    const published = indexes.filter((i) => !preprints.has(i));
+    const pool = published.length ? published : indexes;
+    const lead = primary ?? [...pool].sort(newestFirst)[0];
+    groups.push({
+      order: Math.min(...indexes),
+      group: {
+        lead: pubs[lead],
+        versions: indexes.filter((i) => i !== lead).sort(newestFirst).map((i) => ({ pub: pubs[i], kind: preprints.has(i) ? "preprint" : "version" }))
+      }
+    });
+  }
+  return groups.sort((a, b) => a.order - b.order).map((g) => g.group);
+}
+
 // src/profile/highlights.ts
 function coPeopleLabel(people, self) {
   const names = (people ?? []).filter((p) => p.did !== self.did && (!p.handle || p.handle !== self.handle)).map((p) => p.displayName ?? p.name ?? p.handle).filter((n) => Boolean(n && n.trim()));
@@ -6326,6 +6420,11 @@ var PublicationAuthorSchema = zod.z.object({
   name: zod.z.string().min(1).refine(maxGraphemes(100)).max(1e3),
   did: didSchema.optional()
 });
+var RelatedIdentifierSchema = zod.z.object({
+  identifier: zod.z.string().min(1).max(2048),
+  identifierType: zod.z.string().max(32).optional(),
+  relationType: zod.z.string().min(1).max(64)
+});
 var ProfilePublicationRecordSchema = zod.z.object({
   title: zod.z.string().min(1).refine(maxGraphemes(200)).max(2e3),
   subtitle: zod.z.string().refine(maxGraphemes(200)).max(2e3).optional(),
@@ -6333,6 +6432,7 @@ var ProfilePublicationRecordSchema = zod.z.object({
   url: uriSchema.optional(),
   description: zod.z.string().refine(maxGraphemes(5e3)).max(5e4).optional(),
   authors: zod.z.array(PublicationAuthorSchema).max(50).optional(),
+  relatedIdentifiers: zod.z.array(RelatedIdentifierSchema).max(20).optional(),
   publishedAt: partialDateSchema.optional(),
   isPrimary: zod.z.boolean().optional(),
   createdAt: datetimeSchema
@@ -6696,7 +6796,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.32";
+var SIFA_SDK_VERSION = "0.19.33";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VERBS = ACTIVITY_VERBS;
@@ -6802,6 +6902,7 @@ exports.ProfileVolunteeringRecordSchema = ProfileVolunteeringRecordSchema;
 exports.PublicationAuthorSchema = PublicationAuthorSchema;
 exports.ROADMAP_ISSUES_REPO = ROADMAP_ISSUES_REPO;
 exports.ROADMAP_ITEM_META = ROADMAP_ITEM_META;
+exports.RelatedIdentifierSchema = RelatedIdentifierSchema;
 exports.SECTION_GROUPS = SECTION_GROUPS;
 exports.SECTION_LABELS = SECTION_LABELS;
 exports.SELF_APP_ID = SELF_APP_ID;
@@ -6896,6 +6997,7 @@ exports.getVerificationProvider = getVerificationProvider;
 exports.getVisibleSectionIds = getVisibleSectionIds;
 exports.getWorkplaceTypeLabel = getWorkplaceTypeLabel;
 exports.groupInvolvementByHeading = groupInvolvementByHeading;
+exports.groupPublicationVersions = groupPublicationVersions;
 exports.groupSkillsByCategory = groupSkillsByCategory;
 exports.groupSkillsBySubCategory = groupSkillsBySubCategory;
 exports.groupSkillsForDisplay = groupSkillsForDisplay;