@singi-labs/sifa-sdk 0.16.0 → 0.17.0

package/dist/index.d.cts

@@ -1444,6 +1444,33 @@ declare function getPublisherFromSiteUrl(siteUrl: string): Publisher;
  * embeds, content labels) are layered on in sifa-web and are not part of the
  * shared contract.
  */
+interface HypercertContributorView {
+    displayName: string;
+    imageUrl?: string;
+    /**
+     * Where the contributor lives. A GitHub profile URL on every
+     * `contributorInformation` record sampled to date, never a DID or atproto
+     * handle, so this does not resolve to a Sifa profile.
+     */
+    identifier?: string;
+    /** Percentage share of the claim; weights across a claim sum to 100. */
+    weight?: number;
+}
+interface HypercertAttachmentView {
+    title?: string;
+    url: string;
+}
+/**
+ * Contributor and attachment detail for an `org.hypercerts.claim.activity`
+ * record, resolved by sifa-api out of sidecar records in the claim's own repo.
+ * A card cannot reach them itself.
+ */
+interface HypercertDetailsView {
+    contributors: HypercertContributorView[];
+    /** Total before truncation, so a renderer can show "+N more". */
+    contributorCount: number;
+    attachments: HypercertAttachmentView[];
+}
 interface ActivityItem {
     /** Full at-uri of the record: stable key + permalink source. */
     uri: string;
@@ -1487,6 +1514,12 @@ interface ActivityItem {
      * a `StreamCardVM` too.
      */
     subject?: ActivityItem;
+    /**
+     * Hypercert claim enrichment, set by sifa-api. Absent for non-hypercert
+     * items, for claims with neither contributors nor attachments, and for
+     * responses predating the field.
+     */
+    hypercertDetails?: HypercertDetailsView;
 }
 
 /**
@@ -1798,6 +1831,12 @@ interface StreamCardVM {
     externalLink?: StreamExternalLink;
     theme?: StreamTheme;
     subject?: StreamCardSubject;
+    /**
+     * Contributor and attachment detail for a hypercert claim, passed through
+     * from the `ActivityItem` sifa-api hydrated. Renderers show a credit roll
+     * and the claim's outbound links instead of a bare contributor count.
+     */
+    hypercertDetails?: HypercertDetailsView;
 }
 
 declare const streamSourceSchema: z.ZodType<StreamSource>;

package/dist/index.d.ts

@@ -1444,6 +1444,33 @@ declare function getPublisherFromSiteUrl(siteUrl: string): Publisher;
  * embeds, content labels) are layered on in sifa-web and are not part of the
  * shared contract.
  */
+interface HypercertContributorView {
+    displayName: string;
+    imageUrl?: string;
+    /**
+     * Where the contributor lives. A GitHub profile URL on every
+     * `contributorInformation` record sampled to date, never a DID or atproto
+     * handle, so this does not resolve to a Sifa profile.
+     */
+    identifier?: string;
+    /** Percentage share of the claim; weights across a claim sum to 100. */
+    weight?: number;
+}
+interface HypercertAttachmentView {
+    title?: string;
+    url: string;
+}
+/**
+ * Contributor and attachment detail for an `org.hypercerts.claim.activity`
+ * record, resolved by sifa-api out of sidecar records in the claim's own repo.
+ * A card cannot reach them itself.
+ */
+interface HypercertDetailsView {
+    contributors: HypercertContributorView[];
+    /** Total before truncation, so a renderer can show "+N more". */
+    contributorCount: number;
+    attachments: HypercertAttachmentView[];
+}
 interface ActivityItem {
     /** Full at-uri of the record: stable key + permalink source. */
     uri: string;
@@ -1487,6 +1514,12 @@ interface ActivityItem {
      * a `StreamCardVM` too.
      */
     subject?: ActivityItem;
+    /**
+     * Hypercert claim enrichment, set by sifa-api. Absent for non-hypercert
+     * items, for claims with neither contributors nor attachments, and for
+     * responses predating the field.
+     */
+    hypercertDetails?: HypercertDetailsView;
 }
 
 /**
@@ -1798,6 +1831,12 @@ interface StreamCardVM {
     externalLink?: StreamExternalLink;
     theme?: StreamTheme;
     subject?: StreamCardSubject;
+    /**
+     * Contributor and attachment detail for a hypercert claim, passed through
+     * from the `ActivityItem` sifa-api hydrated. Renderers show a credit roll
+     * and the claim's outbound links instead of a bare contributor count.
+     */
+    hypercertDetails?: HypercertDetailsView;
 }
 
 declare const streamSourceSchema: z.ZodType<StreamSource>;

package/dist/index.js

@@ -4068,6 +4068,18 @@ var streamCardSubjectSchema = z.discriminatedUnion("kind", [
     title: z.string().optional()
   })
 ]);
+var hypercertDetailsSchema = z.object({
+  contributors: z.array(
+    z.object({
+      displayName: z.string(),
+      imageUrl: z.string().optional(),
+      identifier: z.string().optional(),
+      weight: z.number().optional()
+    })
+  ),
+  contributorCount: z.number(),
+  attachments: z.array(z.object({ title: z.string().optional(), url: z.string() }))
+});
 var streamCardVMSchema = z.lazy(
   () => z.object({
     uri: z.string(),
@@ -4083,7 +4095,8 @@ var streamCardVMSchema = z.lazy(
     media: z.array(streamMediaSchema).optional(),
     externalLink: streamExternalLinkSchema.optional(),
     theme: streamThemeSchema.optional(),
-    subject: z.lazy(() => streamCardSubjectSchema).optional()
+    subject: z.lazy(() => streamCardSubjectSchema).optional(),
+    hypercertDetails: hypercertDetailsSchema.optional()
   })
 );
 function maxGraphemes(max) {
@@ -4806,6 +4819,7 @@ function toStreamCardVM(item, options = {}) {
     const sourceUrl = resolveSourceUrl(item, record);
     if (sourceUrl) vm.sourceUrl = sourceUrl;
   }
+  if (item.hypercertDetails) vm.hypercertDetails = item.hypercertDetails;
   if (item.subject) {
     vm.subject = { kind: "post", post: toStreamCardVM(item.subject, options) };
   }
@@ -6022,7 +6036,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.16.0";
+var SIFA_SDK_VERSION = "0.17.0";
 
 export { ACTIVITY_TIERS, ACTIVITY_VERBS, ACTIVITY_VISIBILITY_RULES, ADULT_CONTENT_LABELS, ALL_SECTIONS, APP_CATEGORIES, APP_CATEGORY_IDS, APP_CATEGORY_MAP, APP_URL_PATTERNS, ARTIFACT_LINK_KIND_LABELS, ARTIFACT_LINK_KIND_OPTIONS, ArtifactLinkSchema, AtmosphereFeedItemSchema, BlobRefSchema, CALENDAR_EVENT_MODE_LABELS, CALENDAR_EVENT_STATUS_LABELS, CATEGORY_LABELS, CATEGORY_ORDER, COLLECTION_TO_APP, COMPANY_OPTIONAL_EMPLOYMENT_TYPES, COMPANY_PAGE_MIN_FIRMOGRAPHIC_FIELDS, COMPLETENESS_MAX_SCORE, CONTINENTS, COUNTRIES, DIMENSIONS_MAX_SCORE, EMPLOYMENT_TYPE_GROUPS, EMPLOYMENT_TYPE_LABELS, ENTITY_REF_ANCHORS, EndorsementConfirmationRecordSchema, EndorsementRecordSchema, EntityImportSearchResponseSchema, EntityMintDomainResponseSchema, EntityResolveDomainRequestSchema, EntityResolveDomainResponseSchema, EntitySearchResponseSchema, EntitySearchResultSchema, EntitySelectRequestSchema, EntitySelectResponseSchema, FEATURE_FLAGS, FeatureAllowlistEntrySchema, FeedActorSchema, FollowFeedItemSchema, FollowFeedPageSchema, FollowProfilePageSchema, FollowProfileSchema, GraphFollowRecordSchema, INDUSTRY_OPTIONS, INVESTMENT_ROLE_LABELS, INVESTMENT_ROLE_OPTIONS, INVESTMENT_STAGE_LABELS, INVESTMENT_STAGE_OPTIONS, INVESTMENT_STATUS_LABELS, INVESTMENT_STATUS_OPTIONS, INVOLVEMENT_HEADING_ORDER, INVOLVEMENT_KIND_HEADINGS, INVOLVEMENT_KIND_LABELS, INVOLVEMENT_KIND_OPTIONS, InvestmentAmountSchema, MIN_SKILLS, ON_BEHALF_OF_EMPLOYMENT_TYPES, OPEN_TO_OPTIONS, OPEN_TO_TOKENS, OPEN_TO_TOKEN_TO_VALUE, OPEN_TO_VALUE_TO_TOKEN, OrgEmploymentAttestationRecordSchema, OrgProfileRecordSchema, PLATFORM_LABELS, PLATFORM_OPTIONS, PRESENTATION_LINK_TYPE_LABELS, PRESENTATION_LINK_TYPE_OPTIONS, PRESENTATION_ROLE_LABELS, PRESENTATION_ROLE_OPTIONS, PROFILE_INVESTMENT_NSID, PROFILE_INVOLVEMENT_NSID, PROJECT_ROLES, PUBLICATION_TYPE_LABELS, PUBLICATION_TYPE_OPTIONS, PUBLISHERS, PresentationDurationSchema, PresentationLinkSchema, ProfileCertificationRecordSchema, ProfileCourseRecordSchema, ProfileEducationRecordSchema, ProfileExternalAccountRecordSchema, ProfileHonorRecordSchema, ProfileInvestmentRecordSchema, ProfileInvolvementRecordSchema, ProfileLanguageRecordSchema, ProfilePositionRecordSchema, ProfilePresentationDeliveryRecordSchema, ProfilePresentationRecordSchema, ProfileProjectRecordSchema, ProfilePublicationRecordSchema, ProfileSelfRecordSchema, ProfileSkillRecordSchema, ProfileVolunteeringRecordSchema, PublicationAuthorSchema, ROADMAP_ISSUES_REPO, ROADMAP_ITEM_META, SECTION_GROUPS, SECTION_LABELS, SIFA_REPO_GROUPS, SIFA_SDK_VERSION, SKILL_CATEGORIES, STANDARD_PUBLISHER_ID, STREAM_VERBS, SifaFeedItemSchema, VERIFICATION_PROVIDERS, WORKPLACE_TYPE_LABELS, WORKPLACE_TYPE_OPTIONS, atUriSchema, buildMetaDescription, buildTalkSlug, categoryForApp, certDateExtractor, cidSchema, classifyEntityRef, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countRecentActivity, countryCodeToFlag, dateRangeExtractor, datetimeSchema, decodeFeedCursor, dedupeSkills, describeSifaRecord, detectPdsProvider, didSchema, dimensionsFromInputs, durationFromMinutes, encodeFeedCursor, entityDisambiguationLabel, entityResultKey, externalRecordRefSchema, filterHidden, findIndustry, formatCompanyName, formatDateRange, formatDisplayUrl, formatDistanceToNow, formatLocation, formatPresentationDuration, formatRelativeTime, formatTimelineDate, getActivityTaxonomyVersion, getActivityTier, getActivityVerbsVersion, getAppCategoryIcon, getAppIdForCollection, getArtifactLinkKindLabel, getCalendarEventModeLabel, getCalendarEventStatusLabel, getContinent, getDisplayLabel, getEmploymentTypeLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getInvestmentRoleLabel, getInvestmentStageLabel, getInvestmentStatusLabel, getInvolvementKindHeading, getInvolvementKindLabel, getLexiconEntry, getOpenToLabelKey, getPdsDisplayName, getPlatformLabel, getPresentationLinkTypeLabel, getPresentationRoleLabel, getPublicationTypeLabel, getPublisherByHost, getPublisherById, getPublisherFromSiteUrl, getTierMeta, getVerificationProvider, getVisibleSectionIds, getWorkplaceTypeLabel, groupInvolvementByHeading, groupSkillsByCategory, groupSkillsBySubCategory, groupSkillsForDisplay, hasAdultContent, hasPersonalProfileContent, hoistPrimary, isAppCategory, isCompanyPageIndexable, isCompanyRequired, isKnownAppId, isKnownPlatform, isKnownVerificationProvider, isLinked, isOnBehalfOfApplicable, isPseudoEmployer, isRegistrableDomainHandle, isRoleLineRedundant, isSectionPopulated, isValidRgbColor, isVisibleActivityItem, languageTagSchema, lexiconDateExtractor, limitCombiningMarks, locationSegments, looksLikeDomain, makeGraphFollowRecordSchema, maxGraphemes, meetsContrastAA, normalizeCompanyKey, normalizeDoi, normalizeLegalForm, normalizeOpenTo, normalizePlatformId, normalizePresentationMode, normalizePresentationRole, normalizeSkillCategory, normalizeWorkplaceTypes, openToTokenToValue, openToValueToToken, parseIntendedAudiences, parseLocationString, parsePresentationDuration, parseTalkRkey, partialDateSchema, pdsProviderFromApi, pickPrimaryPosition, presentationCsvRowToRecord, presentationDeliveryCsvRowToRecord, primaryVerification, profileToDimensionInputs, qualifiesAsOrg, relativeLuminance, rendersCompanyProfile, rendersPersonalProfile, repoGroupForCollection, resolveAccountFacetMode, resolveCardHealth, resolveCardUrl, resolveEmbed, resolveVerifierProvider, rgbToString, roadmapIssueUrl, sanitizeDisplayText, sanitizeHandleInput, searchResultDisambiguation, selfLabelsSchema, singleDateExtractor, skillRefSchema, slugifyTitle, sortByActiveDateRange, sortByDateDesc, sortCertifications, sortEducation, sortHonors, sortLanguages, sortLanguagesByProficiency, sortPositions, sortProjects, sortPublications, streamAddressSchema, streamAuthorSchema, streamCardBodySchema, streamCardSubjectSchema, streamCardVMSchema, streamExternalLinkSchema, streamGeoSchema, streamMediaSchema, streamRichSegmentSchema, streamSourceSchema, streamThemeSchema, streamVerbSchema, stripHtmlToText, strongRefSchema, summarizePresentationDeliveries, summarizeProfileView, toStreamCardVM, toStreamCardVMs, truncateGraphemes, uriSchema, verbForCollection, visibleItems, youtubeThumbnailUrl, youtubeVideoId };
 //# sourceMappingURL=index.js.map