@singi-labs/sifa-sdk 0.16.0 → 0.18.0

package/dist/index.d.cts

@@ -1444,6 +1444,71 @@ 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[];
+}
+/** An account a Certified record points at: a badge recipient, or a group. */
+interface CertifiedActorView {
+    did: string;
+    /**
+     * The account's handle. Falls back to the DID when nothing resolved. Note
+     * that some accounts in this ecosystem are not on Bluesky at all (the
+     * Hypercerts Foundation's own account resolves only through its DID
+     * document), so a Bluesky-only lookup is not sufficient.
+     */
+    handle: string;
+    displayName?: string;
+    avatar?: string;
+}
+/** The badge definition behind an award: what the badge is, and why. */
+interface CertifiedBadgeView {
+    title: string;
+    /** Why the badge exists, straight from the definition record. */
+    description?: string;
+    /** Emoji from the definition, e.g. a medal. */
+    icon?: string;
+    /** e.g. "endorsement", "evaluator". */
+    badgeType?: string;
+}
+/**
+ * Certified enrichment, resolved by sifa-api. Covers both directions: a badge
+ * the person awarded to someone else, and one they received and accepted.
+ */
+interface CertifiedDetailsView {
+    badge?: CertifiedBadgeView;
+    /** Who received the badge, for an award the person issued. */
+    recipient?: CertifiedActorView;
+    /** Who issued the badge, for one the person received and accepted. */
+    issuer?: CertifiedActorView;
+    /** The group joined, for a membership record. */
+    group?: CertifiedActorView;
+    /** Role on a membership, e.g. "owner", "admin", "member". */
+    role?: string;
+}
 interface ActivityItem {
     /** Full at-uri of the record: stable key + permalink source. */
     uri: string;
@@ -1487,6 +1552,17 @@ 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;
+    /**
+     * Certified enrichment: the badge behind an award and the resolved accounts
+     * it points at. Absent for non-Certified items and legacy responses.
+     */
+    certifiedDetails?: CertifiedDetailsView;
 }
 
 /**
@@ -1798,6 +1874,17 @@ 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;
+    /**
+     * Certified badge + resolved accounts, passed through from the ActivityItem
+     * sifa-api hydrated.
+     */
+    certifiedDetails?: CertifiedDetailsView;
 }
 
 declare const streamSourceSchema: z.ZodType<StreamSource>;

package/dist/index.d.ts

@@ -1444,6 +1444,71 @@ 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[];
+}
+/** An account a Certified record points at: a badge recipient, or a group. */
+interface CertifiedActorView {
+    did: string;
+    /**
+     * The account's handle. Falls back to the DID when nothing resolved. Note
+     * that some accounts in this ecosystem are not on Bluesky at all (the
+     * Hypercerts Foundation's own account resolves only through its DID
+     * document), so a Bluesky-only lookup is not sufficient.
+     */
+    handle: string;
+    displayName?: string;
+    avatar?: string;
+}
+/** The badge definition behind an award: what the badge is, and why. */
+interface CertifiedBadgeView {
+    title: string;
+    /** Why the badge exists, straight from the definition record. */
+    description?: string;
+    /** Emoji from the definition, e.g. a medal. */
+    icon?: string;
+    /** e.g. "endorsement", "evaluator". */
+    badgeType?: string;
+}
+/**
+ * Certified enrichment, resolved by sifa-api. Covers both directions: a badge
+ * the person awarded to someone else, and one they received and accepted.
+ */
+interface CertifiedDetailsView {
+    badge?: CertifiedBadgeView;
+    /** Who received the badge, for an award the person issued. */
+    recipient?: CertifiedActorView;
+    /** Who issued the badge, for one the person received and accepted. */
+    issuer?: CertifiedActorView;
+    /** The group joined, for a membership record. */
+    group?: CertifiedActorView;
+    /** Role on a membership, e.g. "owner", "admin", "member". */
+    role?: string;
+}
 interface ActivityItem {
     /** Full at-uri of the record: stable key + permalink source. */
     uri: string;
@@ -1487,6 +1552,17 @@ 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;
+    /**
+     * Certified enrichment: the badge behind an award and the resolved accounts
+     * it points at. Absent for non-Certified items and legacy responses.
+     */
+    certifiedDetails?: CertifiedDetailsView;
 }
 
 /**
@@ -1798,6 +1874,17 @@ 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;
+    /**
+     * Certified badge + resolved accounts, passed through from the ActivityItem
+     * sifa-api hydrated.
+     */
+    certifiedDetails?: CertifiedDetailsView;
 }
 
 declare const streamSourceSchema: z.ZodType<StreamSource>;

package/dist/index.js

@@ -1152,7 +1152,7 @@ function categoryForApp(appId) {
 // src/taxonomy/activity-tiers.json
 var activity_tiers_default = {
   $schema: "https://sifa.id/schemas/activity-tiers/v1.json",
-  version: "1.2.0",
+  version: "1.3.0",
   updated: "2026-08-25",
   tiers: {
     creation: {
@@ -1256,6 +1256,11 @@ var activity_tiers_default = {
       app: "certified",
       notes: "An endorsement issued to another DID. A trust signal the actor contributes, like a Bluesky verification."
     },
+    "app.certified.badge.response": {
+      tier: "creation",
+      app: "certified",
+      notes: "The recipient's acceptance of a badge someone else awarded them. An accepted badge is a credential the person holds; rejected ones are hidden by an ACTIVITY_VISIBILITY_RULES predicate."
+    },
     "app.collectivesocial.feed.list": {
       tier: "creation",
       app: "collectivesocial",
@@ -3703,11 +3708,15 @@ function marginAnnotationHasBody(record) {
   }
   return false;
 }
+function certifiedBadgeAccepted(record) {
+  return record.response === "accepted";
+}
 var ACTIVITY_VISIBILITY_RULES = Object.freeze({
   "buzz.bookhive.book": bookhiveHasOpinion,
   "app.beaconbits.beacon": beaconbitsHasContent,
   "at.margin.bookmark": marginBookmarkHasSource,
-  "at.margin.annotation": marginAnnotationHasBody
+  "at.margin.annotation": marginAnnotationHasBody,
+  "app.certified.badge.response": certifiedBadgeAccepted
 });
 function isVisibleActivityItem(collection, record) {
   if (record === null || typeof record !== "object") return false;
@@ -4068,6 +4077,36 @@ 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 certifiedActorSchema = z.object({
+  did: z.string(),
+  handle: z.string(),
+  displayName: z.string().optional(),
+  avatar: z.string().optional()
+});
+var certifiedDetailsSchema = z.object({
+  badge: z.object({
+    title: z.string(),
+    description: z.string().optional(),
+    icon: z.string().optional(),
+    badgeType: z.string().optional()
+  }).optional(),
+  recipient: certifiedActorSchema.optional(),
+  issuer: certifiedActorSchema.optional(),
+  group: certifiedActorSchema.optional(),
+  role: z.string().optional()
+});
 var streamCardVMSchema = z.lazy(
   () => z.object({
     uri: z.string(),
@@ -4083,7 +4122,9 @@ 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(),
+    certifiedDetails: certifiedDetailsSchema.optional()
   })
 );
 function maxGraphemes(max) {
@@ -4806,6 +4847,8 @@ function toStreamCardVM(item, options = {}) {
     const sourceUrl = resolveSourceUrl(item, record);
     if (sourceUrl) vm.sourceUrl = sourceUrl;
   }
+  if (item.hypercertDetails) vm.hypercertDetails = item.hypercertDetails;
+  if (item.certifiedDetails) vm.certifiedDetails = item.certifiedDetails;
   if (item.subject) {
     vm.subject = { kind: "post", post: toStreamCardVM(item.subject, options) };
   }
@@ -6022,7 +6065,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.16.0";
+var SIFA_SDK_VERSION = "0.18.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