@singi-labs/sifa-sdk 0.15.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

@@ -1152,8 +1152,8 @@ function categoryForApp(appId) {
 // src/taxonomy/activity-tiers.json
 var activity_tiers_default = {
   $schema: "https://sifa.id/schemas/activity-tiers/v1.json",
-  version: "1.1.0",
-  updated: "2026-07-29",
+  version: "1.2.0",
+  updated: "2026-08-25",
   tiers: {
     creation: {
       label: "Made",
@@ -1181,26 +1181,6 @@ var activity_tiers_default = {
       tier: "creation",
       app: "atmobb"
     },
-    "at.locale.project": {
-      tier: "creation",
-      app: "locale",
-      notes: "A localization project the actor owns: git source, source and target locales."
-    },
-    "at.locale.translation": {
-      tier: "creation",
-      app: "locale",
-      notes: "One authored translated string for a message key in a target locale."
-    },
-    "blog.pckt.mini.post": {
-      tier: "creation",
-      app: "pckt",
-      notes: "A pckt microblog post. Long-form pckt posts are site.standard.document instead."
-    },
-    "app.photosky.collection": {
-      tier: "creation",
-      app: "zeens",
-      notes: "A curated photo collection on Zeens (still the app.photosky namespace)."
-    },
     "app.beaconbits.beacon": {
       tier: "creation",
       app: "beaconbits"
@@ -1266,6 +1246,16 @@ var activity_tiers_default = {
       app: "bluesky",
       notes: "Diverges from app.bsky.graph.follow (action) on purpose: verifying another account's handle is a deliberate trust statement the actor authors, not a tap. Sifa renders it with its own card."
     },
+    "app.certified.actor.membership": {
+      tier: "creation",
+      app: "certified",
+      notes: "Joining a group is a commitment, same shape as a Colibri or Open Social membership."
+    },
+    "app.certified.badge.award": {
+      tier: "creation",
+      app: "certified",
+      notes: "An endorsement issued to another DID. A trust signal the actor contributes, like a Bluesky verification."
+    },
     "app.collectivesocial.feed.list": {
       tier: "creation",
       app: "collectivesocial",
@@ -1275,6 +1265,11 @@ var activity_tiers_default = {
       tier: "creation",
       app: "mcp"
     },
+    "app.photosky.collection": {
+      tier: "creation",
+      app: "zeens",
+      notes: "A curated photo collection on Zeens (still the app.photosky namespace)."
+    },
     "app.sidetrail.trail": {
       tier: "creation",
       app: "semble"
@@ -1292,6 +1287,16 @@ var activity_tiers_default = {
       app: "userinput",
       notes: "Replies are authored text, consistent with app.bsky.feed.post covering replies."
     },
+    "at.locale.project": {
+      tier: "creation",
+      app: "locale",
+      notes: "A localization project the actor owns: git source, source and target locales."
+    },
+    "at.locale.translation": {
+      tier: "creation",
+      app: "locale",
+      notes: "One authored translated string for a message key in a target locale."
+    },
     "at.margin.annotation": {
       tier: "creation",
       app: "margin",
@@ -1319,6 +1324,11 @@ var activity_tiers_default = {
       tier: "creation",
       app: "youandme"
     },
+    "blog.pckt.mini.post": {
+      tier: "creation",
+      app: "pckt",
+      notes: "A pckt microblog post. Long-form pckt posts are site.standard.document instead."
+    },
     "blue.flashes.feed.post": {
       tier: "creation",
       app: "flashes"
@@ -1336,6 +1346,11 @@ var activity_tiers_default = {
       tier: "creation",
       app: "minomobi"
     },
+    "com.shinolabs.pinksea.oekaki": {
+      tier: "creation",
+      app: "pinksea",
+      notes: "A drawing made in PinkSea's canvas, stored as an image blob with alt text and tags."
+    },
     "com.voxport.podcast.series": {
       tier: "creation",
       app: "voxport"
@@ -1497,6 +1512,11 @@ var activity_tiers_default = {
       app: "sifa",
       notes: "OAuth scope record."
     },
+    "id.sifa.confirmation": {
+      tier: "action",
+      app: "sifa",
+      notes: "Confirmation that a record naming the actor is accurate (co-speaker credit, project membership)."
+    },
     "id.sifa.endorsement": {
       tier: "creation",
       app: "sifa",
@@ -1507,11 +1527,6 @@ var activity_tiers_default = {
       app: "sifa",
       notes: "Confirmation/acceptance of an endorsement received."
     },
-    "id.sifa.confirmation": {
-      tier: "action",
-      app: "sifa",
-      notes: "Confirmation that a record naming the actor is accurate (co-speaker credit, project membership)."
-    },
     "id.sifa.graph.connection": {
       tier: "creation",
       app: "sifa",
@@ -1672,6 +1687,31 @@ var activity_tiers_default = {
       tier: "creation",
       app: "papili"
     },
+    "org.hypercerts.claim.activity": {
+      tier: "creation",
+      app: "hypercerts",
+      notes: "A hypercert: an authored claim of work done, with title, description, and weighted contributors."
+    },
+    "org.hypercerts.claim.collection": {
+      tier: "creation",
+      app: "hypercerts",
+      notes: "Older shape of the project container that groups claims. Superseded by org.hypercerts.collection."
+    },
+    "org.hypercerts.claim.evaluation": {
+      tier: "creation",
+      app: "hypercerts",
+      notes: "An assessment of a claim carrying a score and a written summary. An opinion with a body."
+    },
+    "org.hypercerts.collection": {
+      tier: "creation",
+      app: "hypercerts",
+      notes: "An authored project container grouping hypercert claims, with its own title, banner, and description."
+    },
+    "org.impactindexer.review.comment": {
+      tier: "creation",
+      app: "impactindexer",
+      notes: "A written review of a hypercert claim, like a Popfeed or BookHive review."
+    },
     "org.v-it.skill": {
       tier: "creation",
       app: "vit"
@@ -4028,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(),
@@ -4043,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) {
@@ -4766,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) };
   }
@@ -5982,7 +6036,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.15.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