@singi-labs/sifa-sdk 0.19.99 → 0.19.101

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/dist/{index-CL8l5aB-.d.cts → index-BQAKeEoj.d.cts} +13 -1
  2. package/dist/{index-5T1grOo4.d.ts → index-DDh2RLvx.d.ts} +13 -1
  3. package/dist/index.cjs +1 -1
  4. package/dist/index.cjs.map +1 -1
  5. package/dist/index.d.cts +5 -5
  6. package/dist/index.d.ts +5 -5
  7. package/dist/index.js +1 -1
  8. package/dist/index.js.map +1 -1
  9. package/dist/jev/index.cjs +0 -2
  10. package/dist/jev/index.cjs.map +1 -1
  11. package/dist/jev/index.d.cts +4 -0
  12. package/dist/jev/index.d.ts +4 -0
  13. package/dist/jev/index.js +0 -2
  14. package/dist/jev/index.js.map +1 -1
  15. package/dist/jev/issue.cjs.map +1 -1
  16. package/dist/jsonld/index.d.cts +1 -1
  17. package/dist/jsonld/index.d.ts +1 -1
  18. package/dist/{network-map-CkmtsHDY.d.cts → network-map-CVr1LskK.d.cts} +3 -3
  19. package/dist/{network-map-v2LJbj0p.d.ts → network-map-DTlhFNIf.d.ts} +3 -3
  20. package/dist/{profile-summary-BpDqAdtX.d.ts → profile-summary-0T0VS7Rz.d.ts} +1 -1
  21. package/dist/{profile-summary-yoljNqGz.d.cts → profile-summary-C5LlxPKK.d.cts} +1 -1
  22. package/dist/query/fetchers/index.d.cts +6 -6
  23. package/dist/query/fetchers/index.d.ts +6 -6
  24. package/dist/query/hooks/index.d.cts +4 -4
  25. package/dist/query/hooks/index.d.ts +4 -4
  26. package/dist/query/index.d.cts +9 -9
  27. package/dist/query/index.d.ts +9 -9
  28. package/dist/resume/index.d.cts +1 -1
  29. package/dist/resume/index.d.ts +1 -1
  30. package/dist/testing/index.d.cts +1 -1
  31. package/dist/testing/index.d.ts +1 -1
  32. package/dist/types/index.js.map +1 -1
  33. package/dist/{types-B9nkqX3O.d.ts → types-B0zZiWDH.d.ts} +1 -1
  34. package/dist/{types-C6ghq8Fv.d.cts → types-jE1ofoPI.d.cts} +1 -1
  35. package/dist/{use-user-settings-BNhxzw2f.d.ts → use-user-settings-CCAw3_Q2.d.ts} +3 -3
  36. package/dist/{use-user-settings-Bah9kEqH.d.cts → use-user-settings-DjnTECGe.d.cts} +3 -3
  37. package/dist/{user-settings-CdXeV4lU.d.cts → user-settings-C5sOgvhL.d.cts} +2 -2
  38. package/dist/{user-settings-C_8R5XSQ.d.ts → user-settings-D_DjukR6.d.ts} +2 -2
  39. package/package.json +1 -1
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["import type { AgentRef } from '../schemas/shared.js';\nimport type { AccountVerification } from '../taxonomy/verification-providers.js';\n\nexport interface LocationValue {\n city?: string;\n /** community.lexicon.location.address field -- preferred over `city`. */\n locality?: string;\n region?: string;\n country: string;\n countryCode?: string;\n postalCode?: string;\n geonameId?: number;\n}\n\nexport interface SkillRef {\n uri: string;\n}\n\nexport interface ProfilePosition {\n rkey: string;\n /**\n * Optional: omitted for self-employed / freelance / independent positions.\n * The lexicon and the record schema already make company optional.\n */\n company?: string;\n /**\n * Portable org entity identifier (Wikidata/ROR/LEI URI) written when the user\n * picks an organization from the resolver typeahead. Absent for free-text or\n * independent positions (#159).\n */\n entityRef?: string;\n /**\n * Resolved current canonical name of the durably-linked company (#240),\n * computed by the AppView at read time. Render this over `company` for a\n * linked position, so a name correction reaches every linked profile without\n * a PDS write. Absent for free-text or unresolved positions (fall back to\n * `company`).\n */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n /**\n * Company-page slug for a durably-linked position, resolved by the AppView at\n * read time alongside `entityName` (#159). Lets a consumer link the company\n * name to its `/c/{domain}` page without re-resolving `entityRef`. `domain` is\n * the readable form, `publicId` the durable fallback; build the link as\n * `/c/${companyDomain ?? companyPublicId}`. Both absent for free-text /\n * unlinked positions.\n */\n companyDomain?: string;\n companyPublicId?: string;\n title: string;\n description?: string;\n startedAt: string;\n endedAt?: string;\n location?: LocationValue | null;\n employmentType?: string;\n /**\n * Party this role is held on behalf of, when the person represents someone else --\n * most often a fund whose board seat this is. A disclosure rather than a role type,\n * so it is a separate field from `employmentType`. Absent for independent roles.\n */\n onBehalfOf?: string;\n /** DID of the represented party, when known. May be an organization or a person. */\n onBehalfOfDid?: string;\n /** Portable entity identifier for the represented party (Wikidata/ROR/LEI URI). */\n onBehalfOfEntityRef?: string;\n workplaceType?: string;\n skills?: SkillRef[];\n linkedSkills?: ProfileSkill[];\n primary?: boolean;\n hidden?: boolean;\n /**\n * Colleagues who confirmed this position (`id.sifa.defs#colleague`), as\n * resolved by the AppView. Descriptive only: who said so, never a score.\n * Absent when nobody has confirmed it.\n */\n confirmations?: PositionConfirmations;\n /**\n * What the signed-in viewer can do with this position. `available` means\n * they have a reason to know it (an overlapping position at the same\n * organization, or they are the organization's account) and have not\n * confirmed it yet; `confirmed` means they already did and can withdraw.\n * Absent for anonymous viewers, the owner, and anyone without a reason to know.\n */\n viewerConfirmation?: PositionViewerConfirmation;\n /**\n * The organization's own attestation of this position (sifa-workspace#622),\n * as indexed by the AppView. The strongest tier: only the org's account can\n * produce it. Absent when no attestation covers the position; absence is\n * not a negative signal.\n */\n orgVerification?: PositionOrgVerification;\n /**\n * A badged email verification of this position (sifa-workspace#162): the\n * person controls a mailbox at a domain recognized for the employer.\n * Domain only, never the address. Absent otherwise.\n */\n emailVerification?: PositionEmailVerification;\n}\n\n/** An email verification backing one position, as returned by the AppView. */\nexport interface PositionEmailVerification {\n /** Registrable domain of the verified mailbox. */\n emailDomain: string;\n /** When the mailbox was last verified (ISO). */\n verifiedAt: string;\n}\n\n/** An organization attestation covering one position, as returned by the AppView. */\nexport interface PositionOrgVerification {\n /** DID of the attesting organization's account. */\n orgDid: string;\n status: 'current' | 'past';\n /** How the attestation was written: by hand or by directory sync. */\n source: 'manual' | 'directory';\n /** When the organization attested it (the record's createdAt, ISO). */\n verifiedAt: string;\n /** The attested period, when the record carries one (YYYY-MM or YYYY-MM-DD). */\n startedAt: string | null;\n endedAt: string | null;\n /** The record's title or start-month snapshot no longer matches the live position. */\n stale: boolean;\n /** AT-URI of the attestation record in the organization's repository. */\n attestationUri: string;\n}\n\n/** Confirmations of one position, as returned by the AppView. */\nexport interface PositionConfirmations {\n /** Number of visible confirmers. Equal to `confirmers.length`. */\n count: number;\n /** The confirmers, oldest first. Blocked and suppressed accounts are left out. */\n confirmers: ActorCard[];\n}\n\n/** See {@link ProfilePosition.viewerConfirmation}. */\nexport type PositionViewerConfirmation = 'available' | 'confirmed';\n\nexport interface ProfileEducation {\n rkey: string;\n institution: string;\n /**\n * Portable org entity identifier (Wikidata/ROR/LEI URI) written when the user\n * links the institution to a resolved organization (#159/#241). Absent for\n * free-text entries. Mirrors `ProfilePosition.entityRef`; the AppView sends it\n * for display (the \"Linked\" badge).\n */\n entityRef?: string;\n /**\n * Resolved current canonical name of the durably-linked institution (#252),\n * computed by the AppView at read time. Render this over `institution` for a\n * linked entry, so a name correction reaches every linked profile without a\n * PDS write. Absent for free-text or unresolved entries (fall back to\n * `institution`).\n */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n degree?: string;\n fieldOfStudy?: string;\n /** European Qualifications Framework level, 1 to 8 (8 = doctoral). */\n eqfLevel?: number;\n description?: string;\n activities?: string;\n startedAt?: string;\n endedAt?: string;\n hidden?: boolean;\n /** User-flagged primary education entry, surfaced in the Highlights block. */\n primary?: boolean;\n}\n\nexport interface ProfileSkill {\n rkey: string;\n name: string;\n /**\n * CID of the skill record, needed as a strongRef when endorsing it. Often\n * absent: only the firehose carries a CID, so a skill added moments ago has\n * none indexed yet. Pass it to `createEndorsement` when present and omit it\n * otherwise -- the AppView resolves it from the owner's PDS.\n */\n cid?: string;\n category?: string;\n /**\n * Freeform user-defined grouping label nested under `category` (e.g.\n * \"Frontend\", \"Backend\"). No known values; renderers decide the display\n * label. See `groupSkillsBySubCategory`.\n */\n subCategory?: string;\n endorsementCount?: number;\n endorsed?: boolean;\n /**\n * Names this skill was endorsed under, where they differ from what it is\n * called now. Absent when nothing has drifted.\n *\n * A rename keeps the same record, so endorsements follow it and stay\n * counted. Showing the original name is what keeps that honest: a reader can\n * see that a skill now called one thing was vouched for as another, instead\n * of the rename quietly laundering the endorsement.\n */\n endorsedAs?: string[];\n activityBacked?: boolean;\n}\n\nexport interface SkillSuggestion {\n canonicalName: string;\n slug: string;\n category: string;\n}\n\nexport interface Endorsement {\n endorserDid: string;\n endorserHandle: string;\n endorserDisplayName?: string;\n endorserAvatar?: string;\n comment?: string;\n relationshipContext?: string;\n createdAt: string;\n}\n\nexport interface EndorsementData {\n skillRkey: string;\n comment?: string;\n relationshipContext?: string;\n}\n\nexport interface ProfileLocation {\n rkey: string;\n type: string;\n label?: string | null;\n isPrimary: boolean;\n locationCountry?: string | null;\n locationRegion?: string | null;\n /** Legacy alias for `locationLocality`; emitted by sifa-api during the additive response window. */\n locationCity?: string | null;\n /** community.lexicon.location.address field name -- prefer over `locationCity`. */\n locationLocality?: string | null;\n countryCode?: string | null;\n location?: string | null;\n}\n\nexport interface ProfileCertification {\n rkey: string;\n name: string;\n /**\n * Issuing organization. The write contract names this field `authority`\n * everywhere (record schema, DB column, PDS record); the AppView read view\n * emits `authority` as the canonical field (#249). Optional during the\n * deprecation window while consumers migrate off the legacy `issuingOrg`\n * alias below.\n */\n authority?: string;\n /**\n * @deprecated Legacy read-view alias for {@link authority} (#249). Carries the\n * same value; will be dropped once web + SDK consumers read `authority`.\n */\n issuingOrg?: string;\n /**\n * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the issuing\n * organization to a resolved entity (#159/#241). Absent for free-text entries.\n * Mirrors `ProfilePosition.entityRef`; the AppView sends it for display.\n */\n entityRef?: string;\n /**\n * Resolved current canonical name of the durably-linked issuing organization\n * (#252), computed by the AppView at read time. Render this over `authority`\n * for a linked entry. Absent for free-text or unresolved entries (fall back to\n * `authority`).\n */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n issueDate?: string;\n expiryDate?: string;\n credentialUrl?: string;\n hidden?: boolean;\n}\n\n/**\n * A calendar event a project organized or hosted, with display fields the\n * AppView resolved from the referenced community.lexicon.calendar.event.\n */\nexport interface ProjectEventView {\n /** AT-URI of the community.lexicon.calendar.event. */\n uri: string;\n /** The user's role at this occurrence, when it differs from the project's role. */\n role?: string;\n name?: string;\n /** ISO datetime. Use the date part for display; the time is not meaningful for past events. */\n startsAt?: string;\n /** community.lexicon.calendar.event mode token. */\n mode?: string;\n locality?: string;\n /** ISO 3166-1 alpha-2. */\n country?: string;\n url?: string;\n}\n\nexport interface ProfileProject {\n rkey: string;\n name: string;\n /** The user's own role on the project (#596), e.g. Maintainer. */\n role?: string;\n description?: string;\n url?: string;\n startDate?: string;\n endDate?: string;\n /** Other people named on this project, hydrated from the stored DIDs. */\n members?: ProjectMemberCard[];\n /**\n * AT-URI of the same project as recorded elsewhere, when this entry\n * duplicates another person's. Set so consumers can tell the two describe one\n * project; both still render from their own owner's record.\n */\n /** AT-URI of the same record on another person's profile, when they keep one. */\n sameAs?: string;\n /** Calendar events this project organized or hosted, newest first. */\n events?: ProjectEventView[];\n hidden?: boolean;\n /** User-flagged primary project, surfaced in the Highlights block. Ongoing only. */\n primary?: boolean;\n}\n\nexport interface PublicationContributor {\n name: string;\n orcidId?: string;\n did?: string;\n handle?: string;\n}\n\n/**\n * A co-author an importer produced that the profile owner can offer to link to\n * a Sifa account.\n *\n * Matched on verified ORCID iD only, never on name: \"A. Example\", \"Alice\n * Example\", and \"Example, A.\" are one person, and \"J. Smith\" is four hundred.\n *\n * A suggestion, never a claim. Nothing reaches any repository until the owner\n * acts, which is what makes ORCID re-syncing safe: matching writes nothing, so\n * a re-sync cannot generate a confirmation request.\n */\nexport interface AuthorSuggestion {\n /** ORCID iD the match was made on. The join key back to a contributor. */\n orcidId: string;\n did: string;\n handle: string;\n /** Display name on the matched account, for showing what is being proposed. */\n displayName?: string;\n}\n\n/**\n * A typed link from a work to another version or form of it\n * (`id.sifa.defs#relatedIdentifier`). `relationType` uses the DataCite\n * vocabulary, e.g. `IsPreprintOf` on a preprint pointing at its published\n * version. `identifierType` is `DOI` (the default when absent), `AT-URI` or `URL`.\n */\nexport interface RelatedIdentifier {\n identifier: string;\n identifierType?: string;\n relationType: string;\n}\n\nexport interface ProfilePublication {\n rkey: string;\n title: string;\n subtitle?: string;\n publisher?: string;\n date?: string;\n url?: string;\n description?: string;\n source?: 'sifa' | 'standard' | 'orcid';\n doi?: string;\n type?: string;\n typeLabel?: string;\n contributors?: PublicationContributor[];\n verified?: boolean;\n verifiedVia?: string;\n orcidPutCode?: number;\n hidden?: boolean;\n /** User-flagged primary publication, surfaced in the Highlights block. */\n primary?: boolean;\n orcidCorroborated?: boolean;\n pendingVerification?: boolean;\n appId?: string;\n /**\n * AT-URI of the parent `site.standard.publication` for Standard.site\n * articles — the subscribable unit. Used to group articles by publication\n * on the profile. Undefined for Sifa/ORCID publications.\n */\n publicationUri?: string | null;\n /** Canonical publication origin — the subscribe / link-out target. */\n publicationUrl?: string | null;\n /** Publication display name for the group header (falls back to host). */\n publicationName?: string | null;\n /**\n * Cover image URL for Standard.site articles — the document's `coverImage`\n * blob (CDN-served), falling back to the article page's og:image. Undefined\n * for Sifa/ORCID publications, null when none could be resolved.\n */\n image?: string | null;\n /**\n * Other versions or forms of this work: relations declared on the record\n * plus, for a DOI, those registered with DataCite or Crossref (#590). Feed\n * to `groupPublicationVersions` to fold a preprint under its published version.\n */\n relatedIdentifiers?: RelatedIdentifier[];\n /**\n * Times this work has been cited, as counted by OpenAlex for its DOI. Only\n * sent when the profile owner turned citation counts on and OpenAlex knows\n * the DOI. A display value, never a ranking signal.\n */\n citationCount?: number;\n /** OpenAlex work id (`W…`) the count belongs to; see `openAlexWorkUrl`. */\n openAlexId?: string;\n}\n\nexport interface ProfileVolunteering {\n rkey: string;\n organization: string;\n /**\n * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the\n * organization to a resolved entity (#159/#241). Absent for free-text entries.\n * Mirrors `ProfilePosition.entityRef`; the AppView sends it for display.\n */\n entityRef?: string;\n /**\n * Resolved current canonical name of the durably-linked organization (#252),\n * computed by the AppView at read time. Render this over `organization` for a\n * linked entry. Absent for free-text or unresolved entries (fall back to\n * `organization`).\n */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n role?: string;\n cause?: string;\n startDate?: string;\n endDate?: string;\n description?: string;\n hidden?: boolean;\n}\n\nexport interface ProfileHonor {\n rkey: string;\n title: string;\n issuer?: string;\n /**\n * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the issuer to a\n * resolved entity (#159/#241). Absent for free-text entries. Mirrors\n * `ProfilePosition.entityRef`; the AppView sends it for display.\n */\n entityRef?: string;\n /**\n * Resolved current canonical name of the durably-linked issuer (#252),\n * computed by the AppView at read time. Render this over `issuer` for a linked\n * entry. Absent for free-text or unresolved entries (fall back to `issuer`).\n */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n date?: string;\n description?: string;\n hidden?: boolean;\n}\n\n/**\n * One proof link on an involvement record, as served by the AppView. Mirrors\n * `id.sifa.defs#artifactLink`, plus the computed rung-2 verification signal.\n */\nexport interface ProfileInvolvementLink {\n url: string;\n kind?: string;\n label?: string;\n /**\n * Rung-2 cross-ref: true when the link host matches one of the owner's\n * *verified* `externalAccount` records (GitHub, GitLab, ORCID, ...).\n * Computed by the AppView; deterministic host match, no new primitive.\n */\n verified?: boolean;\n /**\n * Platform token of the matched verified external account (e.g.\n * `id.sifa.defs#platformGithub`), for the badge label. Absent when\n * `verified` is not true.\n */\n verifiedPlatform?: string;\n}\n\n/**\n * An involvement entry as served by the AppView: an `id.sifa.profile.involvement`\n * record, or a mapped legacy `id.sifa.profile.volunteering` record (`legacy`),\n * grouped in the UI by `kind` via the SDK's involvement-kind taxonomy.\n */\n/** One artifact link on an investment (round announcement, portfolio page, filing). */\nexport interface ProfileInvestmentLink {\n url: string;\n kind?: string;\n label?: string;\n}\n\n/** A capital position: money the person put in. Roles with duties are positions. */\nexport interface ProfileInvestment {\n rkey: string;\n /** For a limited-partner entry this names the fund, not a portfolio company. */\n company: string;\n companyDid?: string;\n entityRef?: string;\n /** Resolved canonical name of the linked company. Render over `company` when present. */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n /** How the capital went in. Angel, syndicate member or LP -- never GP. */\n role?: string;\n /** The company's funding stage at the time of the investment, not its stage today. */\n stage?: string;\n /** active / exited / written off / undisclosed. */\n status?: string;\n /** The vehicle the capital went through. Absent for a cheque in the person's own name. */\n via?: string;\n viaDid?: string;\n viaEntityRef?: string;\n /** Whole major currency units plus an ISO 4217 code. Absent unless the person opted in. */\n amount?: { value: number; currency: string };\n startedAt?: string;\n endedAt?: string;\n description?: string;\n links?: ProfileInvestmentLink[];\n hidden?: boolean;\n}\n\nexport interface ProfileInvolvement {\n rkey: string;\n /** Involvement-kind token; drives the display heading. Legacy rows map to charity. */\n kind: string;\n upstream?: string;\n upstreamDid?: string;\n upstreamUrl?: string;\n role?: string;\n description?: string;\n startedAt?: string;\n endedAt?: string;\n links?: ProfileInvolvementLink[];\n /**\n * Portable org entity identifier (Wikidata/ROR/LEI URI) written when the user\n * picks the upstream from the resolver typeahead. Absent for free-text or\n * one-off involvement.\n */\n entityRef?: string;\n /**\n * Resolved current canonical name of the durably-linked upstream, computed by\n * the AppView at read time. Render over `upstream` when present. Absent for\n * free-text or unresolved entries.\n */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n location?: LocationValue | null;\n skills?: SkillRef[];\n /** Skill records resolved from `skills`, for display. */\n linkedSkills?: ProfileSkill[];\n /**\n * True when this row is a mapped legacy `id.sifa.profile.volunteering` record\n * (no `kind`), rendered under \"Volunteering\". Editing it backfills to an\n * `involvement` record and deletes the legacy one.\n */\n legacy?: boolean;\n hidden?: boolean;\n /** User-flagged primary involvement, surfaced in the Highlights block. Ongoing only. */\n primary?: boolean;\n /** Other people named on this involvement, hydrated from the stored DIDs. */\n collaborators?: ProjectMemberCard[];\n /** AT-URI of the same involvement as recorded on another person's profile. */\n sameAs?: string;\n}\n\nexport type LanguageProficiency =\n 'elementary' | 'limited_working' | 'professional_working' | 'full_professional' | 'native';\n\nexport interface ProfileLanguage {\n rkey: string;\n language: string;\n proficiency?: LanguageProficiency;\n hidden?: boolean;\n}\n\nexport interface ProfileCourse {\n rkey: string;\n name: string;\n institution?: string;\n /**\n * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the institution\n * to a resolved entity (#159/#241). Absent for free-text entries. Mirrors\n * `ProfilePosition.entityRef`; the AppView sends it for display.\n */\n entityRef?: string;\n /**\n * Resolved current canonical name of the durably-linked institution (#252),\n * computed by the AppView at read time. Render this over `institution` for a\n * linked entry. Absent for free-text or unresolved entries (fall back to\n * `institution`).\n */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n number?: string;\n /** rkey of the associated certification, resolved from the course's\n * `credential` at-uri. Used to join the course to a certification in the\n * same profile payload (for the linked-credential date and link). */\n credentialRkey?: string;\n /** Date the course was completed, as an RFC 3339 datetime. Optional; the\n * editor collects month granularity (YYYY-MM). */\n completedAt?: string;\n /** `id.sifa.defs#courseRole` token. Absent means the user took the course. */\n role?: string;\n /** Teaching period of a taught or assisted course (YYYY, YYYY-MM or YYYY-MM-DD). */\n startedAt?: string;\n endedAt?: string;\n /** rkey of the position the course was part of (taught under it, or taken\n * as part of the job). The AppView resolves it from the record's `position`\n * at-uri when building the profile view. */\n positionRkey?: string;\n /** rkey of the education record the course was part of, resolved by the\n * AppView from the record's `education` at-uri. */\n educationRkey?: string;\n hidden?: boolean;\n}\n\n/** A related link on a presentation or delivery, as returned by the AppView. */\nexport interface PresentationLinkView {\n uri: string;\n label?: string;\n type?: string;\n}\n\n/**\n * Another person named on someone's record, as rendered by the AppView.\n *\n * `displayName` and `avatar` are present when the person's identity may be\n * shown -- i.e. when {@link actorShowsIdentity} holds (`confirmed` or\n * `claimed`). Otherwise the card is a bare handle with no identity attached and\n * no link to a profile: naming someone is a claim, and until they affirm it (or\n * hold a claimed Sifa account that can be notified of the claim) the claim must\n * not borrow their face.\n */\nexport interface ActorCard {\n did: string;\n handle: string;\n displayName?: string;\n avatar?: string;\n /**\n * True when Sifa has indexed this account at all -- including an unclaimed\n * atproto account seen via the firehose, which still renders at /p/<handle>.\n * Broader than {@link claimed}; not on its own a reason to show identity.\n */\n hasSifaProfile?: boolean;\n /**\n * True when the named person has a claimed Sifa account (has authenticated\n * via OAuth). A claimed account can be notified of a pending claim, so its\n * identity is shown even before confirmation -- see {@link actorShowsIdentity}.\n */\n claimed?: boolean;\n /** True once the named person has published a matching `id.sifa.confirmation`. */\n confirmed?: boolean;\n /**\n * True when the record was materially changed after being confirmed -- a\n * rename, or a changed role. The confirmation stands until withdrawn, but the\n * UI should say the claim has moved since it was affirmed.\n */\n confirmedStale?: boolean;\n}\n\n/** @deprecated Use {@link ActorCard}. Kept so existing co-speaker call sites keep compiling. */\nexport type CoSpeaker = ActorCard;\n\n/**\n * Roles shipped today. The lexicon declares these as `knownValues`, so the\n * field itself stays a plain string: a consumer meeting a role it does not\n * recognise should show it rather than discard it.\n *\n * Display only. A record living in someone else's repository cannot grant\n * write access to anything, and the UI must not imply that it does.\n */\nexport const PROJECT_ROLES = [\n 'id.sifa.defs#projectOwner',\n 'id.sifa.defs#projectCore',\n 'id.sifa.defs#projectContributor',\n] as const;\n\nexport type ProjectRole = (typeof PROJECT_ROLES)[number];\n\n/** A person named as a member of a project, with their role alongside the actor card. */\nexport interface ProjectMemberCard extends ActorCard {\n role?: string;\n title?: string;\n}\n\n/** An occasion on which a presentation was delivered (the AppView view-model). */\nexport interface ProfilePresentationDelivery {\n rkey: string;\n /** rkey of the parent presentation when this delivery references one. */\n presentationRkey?: string | null;\n /** Co-speakers at this occasion, hydrated from the stored DIDs. */\n coSpeakers?: CoSpeaker[];\n /** AT-URI of the same session as recorded on another person's profile. */\n sameAs?: string;\n title?: string | null;\n role?: string | null;\n eventName?: string | null;\n /** YYYY-MM-DD, or YYYY-MM / YYYY when the exact day is unknown. */\n date?: string | null;\n location?: string | null;\n locationCountry?: string | null;\n locationRegion?: string | null;\n locationLocality?: string | null;\n countryCode?: string | null;\n /** Full community.lexicon.calendar.event mode token. */\n mode?: string | null;\n /** Full community.lexicon.calendar.event status token. */\n status?: string | null;\n links?: PresentationLinkView[];\n /** at-uri of the linked calendar event, when present. */\n eventUri?: string | null;\n hidden?: boolean;\n}\n\n/** A reusable presentation with its deliveries grouped underneath (AppView view-model). */\nexport interface ProfilePresentation {\n rkey: string;\n title: string;\n description?: string | null;\n /** Duration in minutes: a fixed value (min only) or a range. */\n duration?: { minMinutes: number; maxMinutes?: number } | null;\n intendedAudiences?: string[];\n links?: PresentationLinkView[];\n /** at-uri of a long-form write-up (Leaflet / site.standard document). */\n writeupUri?: string | null;\n /** Resolved URL of the uploaded cover image, when present. */\n coverImageUrl?: string | null;\n hidden?: boolean;\n /** User-flagged primary talk, surfaced in the Highlights block. Talks only, not sessions. */\n primary?: boolean;\n deliveries?: ProfilePresentationDelivery[];\n}\n\nexport interface TrustStat {\n key: string;\n label: string;\n value: number;\n}\n\nexport interface ActiveApp {\n id: string;\n name: string;\n category: string;\n recentCount: number;\n latestRecordAt?: string | null;\n}\n\nexport interface VerifiedAccount {\n platform: string;\n identifier: string;\n url?: string;\n}\n\nexport interface ExternalAccountKeytraceClaim {\n rkey: string;\n claimedAt: string;\n}\n\nexport interface ExternalAccount {\n rkey: string;\n platform: string;\n url: string;\n label?: string;\n feedUrl?: string;\n primary?: boolean;\n verifiable: boolean;\n verified: boolean;\n verifiedVia?: string | null;\n source?: 'sifa' | 'keytrace' | 'keyoxide' | 'marque';\n hidden?: boolean;\n keytraceVerified?: boolean;\n keytraceClaim?: ExternalAccountKeytraceClaim;\n}\n\nexport interface FeedItem {\n title: string;\n excerpt: string;\n url: string;\n timestamp: string;\n source: string;\n}\n\nexport interface PdsProviderInfo {\n name: string;\n host: string;\n}\n\nexport interface ProfileIndustry {\n industry: string;\n domain?: string;\n}\n\nexport interface ProfileOverrideSource {\n headline?: string;\n about?: string;\n displayName?: string;\n avatarUrl?: string;\n}\n\n/**\n * A structured physical address on the org view. Mirrors\n * `community.lexicon.location.address`; every field is optional.\n */\nexport interface OrgAddressView {\n country: string | null;\n postalCode: string | null;\n region: string | null;\n locality: string | null;\n street: string | null;\n name: string | null;\n}\n\n/** A featured link on the org view. Both `name` and `url` are present. */\nexport interface OrgLinkView {\n name: string;\n url: string;\n}\n\n/**\n * A self-declared industry/domain pair on the org view. Mirrors the person\n * profile's industry/domain shape; `industry` is always present, `domain` is an\n * optional refinement (`null` when absent).\n */\nexport interface OrgIndustryView {\n industry: string;\n domain: string | null;\n}\n\n/**\n * The org-profile fields exposed on the profile resolve when the org rendering\n * floor is met. Narrow on purpose: `contact` is never included (not rendered\n * publicly); record URI/CID are internal. Mirrors sifa-api's `OrgProfileView`.\n */\nexport interface OrgProfileView {\n name: string;\n description: string | null;\n website: string | null;\n /** Blob CID (or resolved URL) of the org logo, when present. */\n logoBlob: string | null;\n entityRefs: string[] | null;\n addresses: OrgAddressView[] | null;\n /** Self-selected headcount range (declared bucket, never calculated). */\n companySize: string | null;\n companyType: string | null;\n links: OrgLinkView[] | null;\n /** Self-declared industry/domain pairs. */\n industries: OrgIndustryView[] | null;\n /** Self-declared founding date (year / YYYY-MM / YYYY-MM-DD). */\n founded: string | null;\n /** Self-declared \"also known as\" names / acronyms. */\n aliases: string[] | null;\n}\n\n/**\n * A company entity recognized purely from the handle's registrable domain\n * (#160 auto-recognize), independent of any org record. Present on the verdict\n * when `recognized` is true. `domain` is the handle's registrable domain and\n * round-trips through `/c/<domain>`; `publicId` is nullable because entities\n * minted before the public_id backfill have none.\n */\nexport interface RecognizedEntity {\n publicId: string | null;\n domain: string;\n name: string;\n}\n\n/**\n * Server-computed org rendering-floor verdict (#160), carried on the profile\n * resolve so clients need no extra round-trip. Read it via the `useOrgProfile`\n * hook.\n *\n * `isOrg` is the CLAIMED floor: true when the account has an\n * `id.sifa.org.profile` record AND its handle is a custom registrable domain\n * (the authoritative, PSL-backed check lives server-side).\n *\n * `recognized` is INDEPENDENT of `isOrg`: true when the handle's registrable\n * domain resolves to a known, non-suppressed, non-natural-person company entity\n * in Sifa's DB, even with no org record yet (auto-recognize known-company\n * domains). A known company that has not yet claimed is\n * `recognized: true, isOrg: false`; a claimed recognized company is both true.\n * Use it to treat a recognized-but-unclaimed company account as a company\n * (company onboarding, `/c/` routing) before it claims.\n */\nexport interface OrgFloorVerdict {\n isOrg: boolean;\n orgProfile?: OrgProfileView;\n recognized: boolean;\n /**\n * Whether the account's handle is a custom registrable apex domain, i.e.\n * eligible to CLAIM an org page (#306). Mirrors the `isBindableHandleDomain`\n * floor the api enforces at write time, surfaced so the `/claim` wizard can\n * gate on eligibility BEFORE the authority consent rather than failing the\n * final PDS write. Independent of `isOrg`/`recognized` -- purely the handle's\n * shape, so a `*.bsky.social` account reads false and a not-yet-claimed\n * custom domain reads true.\n *\n * Optional here (a tolerant reader): the api always emits it, but a profile\n * payload cached before this field shipped may omit it. Gate on the explicit\n * `customDomain === false` for the up-front block; treat absent as unknown and\n * let the api 403 stay the authoritative backstop -- never enforce on this\n * field alone.\n */\n customDomain?: boolean;\n /**\n * Whether the account also keeps a visible personal profile, from\n * `id.sifa.org.profile.personalProfileVisible`. True only for a claimed org\n * (`isOrg`) that opted in -- the sole-trader case, where one DID carries both\n * a person facet at `/p/` and a company facet at `/c/` and neither route\n * redirects to the other. Absent or false is the exclusive default: the\n * account presents solely as an organization and `/p/` redirects to `/c/`.\n */\n personalProfileVisible?: boolean;\n /**\n * Invariant (not encoded in the type, matching the flat wire shape the api\n * sends): present whenever `recognized` is true, absent when false. Callers\n * that read it after narrowing on `recognized === true` should still\n * defensively check, since the type does not enforce the pairing.\n */\n recognizedEntity?: RecognizedEntity;\n}\n\n/**\n * The account owner's answer to \"are you a person, a company, or both?\".\n *\n * `'person'` and `'company'` are Sifa-local overrides stored in\n * `account_render_overrides` (set via `POST /api/account/render-preference`).\n * `'both'` is NOT stored here -- it is the portable\n * `id.sifa.org.profile.personalProfileVisible` declaration in the account's own\n * PDS, so any AppView can evaluate it without asking Sifa. Resolve the combined\n * answer with `resolveAccountFacetMode`.\n */\nexport type AccountFacetMode = 'person' | 'company' | 'both';\n\nexport interface Profile {\n did: string;\n handle: string;\n /**\n * Sifa-local render override, absent when the account has never set one\n * (auto: today's recognition behaviour). `'person'` is the escape hatch for a\n * personal domain that Sifa catalogued as a company.\n */\n renderPreference?: 'person' | 'company' | null;\n /**\n * Org rendering-floor verdict (#160). Present on the profile resolve; absent\n * on payloads that predate the field. When `org.isOrg` is true the account\n * renders as an organization (`/c/`).\n */\n org?: OrgFloorVerdict;\n displayName?: string;\n /**\n * Given (first) name from `id.sifa.profile.self.givenName`. Schema.org\n * `Person.givenName`. Optional; absent for users who haven't filled in\n * structured name fields. Consumers wanting a rendered name should use\n * `formatStructuredName(givenName, familyName) ?? displayName ?? handle`.\n */\n givenName?: string;\n /**\n * Family (last) name from `id.sifa.profile.self.familyName`. Schema.org\n * `Person.familyName`. See `givenName` for fallback guidance.\n */\n familyName?: string;\n /**\n * Free-form phonetic respelling of the user's name from\n * `id.sifa.profile.self.namePronunciation` (e.g. `Foo-kuh`). Optional; a\n * native field with no `app.bsky.actor.profile` equivalent. Text only.\n */\n namePronunciation?: string;\n /**\n * Resolved URL of the name-pronunciation audio clip from\n * `id.sifa.profile.self.namePronunciationAudio`, served from the user's PDS\n * (`com.atproto.sync.getBlob`). Optional; absent when no clip is set.\n */\n namePronunciationAudioUrl?: string;\n avatar?: string;\n /**\n * `id.sifa.profile.self.avatarSource`, e.g. `actor.rpg.sprite` when the user\n * shows their rpg.actor character as their avatar. `avatar` already holds\n * the resolved picture; this only says where it comes from, so an editor\n * can show the current choice. Absent when the uploaded or Bluesky avatar\n * is used.\n */\n avatarSource?: string;\n pronouns?: string;\n headline?: string;\n about?: string;\n hasHeadlineOverride?: boolean;\n hasAboutOverride?: boolean;\n hasDisplayNameOverride?: boolean;\n hasAvatarUrlOverride?: boolean;\n source?: ProfileOverrideSource;\n industries?: ProfileIndustry[];\n location?: LocationValue | null;\n locations?: ProfileLocation[];\n /**\n * @deprecated Flat location field emitted at the response root during the\n * additive response window for `community.lexicon.location.address`.\n * Prefer the structured `locations[]` array (use the entry where\n * `isPrimary` is true).\n */\n locationCountry?: string | null;\n /**\n * @deprecated See `locationCountry`. Prefer `locations[].locationRegion`.\n */\n locationRegion?: string | null;\n /**\n * @deprecated Legacy alias for `locationLocality`; emitted alongside it\n * during the additive response window. Prefer `locations[].locationLocality`.\n */\n locationCity?: string | null;\n /**\n * @deprecated community.lexicon.location.address field name. Prefer\n * `locations[].locationLocality`.\n */\n locationLocality?: string | null;\n /**\n * @deprecated See `locationCountry`. Prefer `locations[].countryCode`.\n */\n countryCode?: string | null;\n website?: string;\n openTo?: string[];\n preferredWorkplace?: string[];\n availableFromUtc?: number;\n availableToUtc?: number;\n pdsProvider?: PdsProviderInfo | null;\n claimed: boolean;\n /**\n * User-set opt-out flag from `id.sifa.profile.self.discoverable`. When\n * `false`, the rendering app emits `noindex` and excludes the page from\n * sitemaps. Absent means default-true (current behavior for existing\n * records that predate this field).\n */\n discoverable?: boolean;\n isOwnProfile?: boolean;\n createdAt?: string;\n trustStats?: TrustStat[];\n verifiedAccounts?: VerifiedAccount[];\n activeApps?: ActiveApp[];\n blueskyVerified?: boolean;\n blueskyVerifiedAt?: string | null;\n /**\n * Every verification the account holds, across all recognized providers\n * (Bluesky and firehose-sourced ones like mu). Supersedes the Bluesky-only\n * `blueskyVerified` pair for badge rendering. Absent on older API responses.\n */\n verificationBadges?: AccountVerification[];\n followersCount: number;\n followingCount: number;\n connectionsCount: number;\n atprotoFollowersCount?: number;\n positions: ProfilePosition[];\n education: ProfileEducation[];\n skills: ProfileSkill[];\n certifications?: ProfileCertification[];\n projects?: ProfileProject[];\n publications?: ProfilePublication[];\n /**\n * Co-authors on imported publications that resolve to a Sifa account.\n *\n * Owner-only, and absent rather than empty for every other viewer, so a\n * consumer cannot tell \"no suggestions\" from \"not yours\". Join to a\n * publication contributor by `orcidId`.\n */\n authorSuggestions?: AuthorSuggestion[];\n volunteering?: ProfileVolunteering[];\n involvement?: ProfileInvolvement[];\n investments?: ProfileInvestment[];\n honors?: ProfileHonor[];\n languages?: ProfileLanguage[];\n courses?: ProfileCourse[];\n presentations?: ProfilePresentation[];\n presentationDeliveries?: ProfilePresentationDelivery[];\n externalAccounts?: ExternalAccount[];\n}\n"],"mappings":";AAwsBO,IAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AACF;","names":[]}
1
+ {"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["import type { AgentRef } from '../schemas/shared.js';\nimport type { AccountVerification } from '../taxonomy/verification-providers.js';\n\nexport interface LocationValue {\n city?: string;\n /** community.lexicon.location.address field -- preferred over `city`. */\n locality?: string;\n region?: string;\n country: string;\n countryCode?: string;\n postalCode?: string;\n geonameId?: number;\n}\n\nexport interface SkillRef {\n uri: string;\n}\n\nexport interface ProfilePosition {\n rkey: string;\n /**\n * Optional: omitted for self-employed / freelance / independent positions.\n * The lexicon and the record schema already make company optional.\n */\n company?: string;\n /**\n * Portable org entity identifier (Wikidata/ROR/LEI URI) written when the user\n * picks an organization from the resolver typeahead. Absent for free-text or\n * independent positions (#159).\n */\n entityRef?: string;\n /**\n * Resolved current canonical name of the durably-linked company (#240),\n * computed by the AppView at read time. Render this over `company` for a\n * linked position, so a name correction reaches every linked profile without\n * a PDS write. Absent for free-text or unresolved positions (fall back to\n * `company`).\n */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n /**\n * Company-page slug for a durably-linked position, resolved by the AppView at\n * read time alongside `entityName` (#159). Lets a consumer link the company\n * name to its `/c/{domain}` page without re-resolving `entityRef`. `domain` is\n * the readable form, `publicId` the durable fallback; build the link as\n * `/c/${companyDomain ?? companyPublicId}`. Both absent for free-text /\n * unlinked positions.\n */\n companyDomain?: string;\n companyPublicId?: string;\n title: string;\n description?: string;\n startedAt: string;\n endedAt?: string;\n location?: LocationValue | null;\n employmentType?: string;\n /**\n * Party this role is held on behalf of, when the person represents someone else --\n * most often a fund whose board seat this is. A disclosure rather than a role type,\n * so it is a separate field from `employmentType`. Absent for independent roles.\n */\n onBehalfOf?: string;\n /** DID of the represented party, when known. May be an organization or a person. */\n onBehalfOfDid?: string;\n /** Portable entity identifier for the represented party (Wikidata/ROR/LEI URI). */\n onBehalfOfEntityRef?: string;\n workplaceType?: string;\n skills?: SkillRef[];\n linkedSkills?: ProfileSkill[];\n primary?: boolean;\n hidden?: boolean;\n /**\n * Colleagues who confirmed this position (`id.sifa.defs#colleague`), as\n * resolved by the AppView. Descriptive only: who said so, never a score.\n * Absent when nobody has confirmed it.\n */\n confirmations?: PositionConfirmations;\n /**\n * What the signed-in viewer can do with this position. `available` means\n * they have a reason to know it (an overlapping position at the same\n * organization, or they are the organization's account) and have not\n * confirmed it yet; `confirmed` means they already did and can withdraw.\n * Absent for anonymous viewers, the owner, and anyone without a reason to know.\n */\n viewerConfirmation?: PositionViewerConfirmation;\n /**\n * The organization's own attestation of this position (sifa-workspace#622),\n * as indexed by the AppView. The strongest tier: only the org's account can\n * produce it. Absent when no attestation covers the position; absence is\n * not a negative signal.\n */\n orgVerification?: PositionOrgVerification;\n /**\n * A badged email verification of this position (sifa-workspace#162): the\n * person controls a mailbox at a domain recognized for the employer.\n * Domain only, never the address. Absent otherwise.\n */\n emailVerification?: PositionEmailVerification;\n /**\n * Verified colleagues vouched for the position (sifa-workspace#166): two\n * of them, or one verified at the same organization. Absent otherwise.\n */\n peerVerification?: PositionPeerVerification;\n}\n\n/** Peer vouches lifting one position to the peer tier, as returned by the AppView. */\nexport interface PositionPeerVerification {\n /** Verified colleagues whose confirmation counts. */\n vouchers: number;\n /** At least one voucher is verified at the same organization. */\n sameEntity: boolean;\n}\n\n/** An email verification backing one position, as returned by the AppView. */\nexport interface PositionEmailVerification {\n /** Registrable domain of the verified mailbox. */\n emailDomain: string;\n /** When the mailbox was last verified (ISO). */\n verifiedAt: string;\n}\n\n/** An organization attestation covering one position, as returned by the AppView. */\nexport interface PositionOrgVerification {\n /** DID of the attesting organization's account. */\n orgDid: string;\n status: 'current' | 'past';\n /** How the attestation was written: by hand or by directory sync. */\n source: 'manual' | 'directory';\n /** When the organization attested it (the record's createdAt, ISO). */\n verifiedAt: string;\n /** The attested period, when the record carries one (YYYY-MM or YYYY-MM-DD). */\n startedAt: string | null;\n endedAt: string | null;\n /** The record's title or start-month snapshot no longer matches the live position. */\n stale: boolean;\n /** AT-URI of the attestation record in the organization's repository. */\n attestationUri: string;\n}\n\n/** Confirmations of one position, as returned by the AppView. */\nexport interface PositionConfirmations {\n /** Number of visible confirmers. Equal to `confirmers.length`. */\n count: number;\n /** The confirmers, oldest first. Blocked and suppressed accounts are left out. */\n confirmers: ActorCard[];\n}\n\n/** See {@link ProfilePosition.viewerConfirmation}. */\nexport type PositionViewerConfirmation = 'available' | 'confirmed';\n\nexport interface ProfileEducation {\n rkey: string;\n institution: string;\n /**\n * Portable org entity identifier (Wikidata/ROR/LEI URI) written when the user\n * links the institution to a resolved organization (#159/#241). Absent for\n * free-text entries. Mirrors `ProfilePosition.entityRef`; the AppView sends it\n * for display (the \"Linked\" badge).\n */\n entityRef?: string;\n /**\n * Resolved current canonical name of the durably-linked institution (#252),\n * computed by the AppView at read time. Render this over `institution` for a\n * linked entry, so a name correction reaches every linked profile without a\n * PDS write. Absent for free-text or unresolved entries (fall back to\n * `institution`).\n */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n degree?: string;\n fieldOfStudy?: string;\n /** European Qualifications Framework level, 1 to 8 (8 = doctoral). */\n eqfLevel?: number;\n description?: string;\n activities?: string;\n startedAt?: string;\n endedAt?: string;\n hidden?: boolean;\n /** User-flagged primary education entry, surfaced in the Highlights block. */\n primary?: boolean;\n}\n\nexport interface ProfileSkill {\n rkey: string;\n name: string;\n /**\n * CID of the skill record, needed as a strongRef when endorsing it. Often\n * absent: only the firehose carries a CID, so a skill added moments ago has\n * none indexed yet. Pass it to `createEndorsement` when present and omit it\n * otherwise -- the AppView resolves it from the owner's PDS.\n */\n cid?: string;\n category?: string;\n /**\n * Freeform user-defined grouping label nested under `category` (e.g.\n * \"Frontend\", \"Backend\"). No known values; renderers decide the display\n * label. See `groupSkillsBySubCategory`.\n */\n subCategory?: string;\n endorsementCount?: number;\n endorsed?: boolean;\n /**\n * Names this skill was endorsed under, where they differ from what it is\n * called now. Absent when nothing has drifted.\n *\n * A rename keeps the same record, so endorsements follow it and stay\n * counted. Showing the original name is what keeps that honest: a reader can\n * see that a skill now called one thing was vouched for as another, instead\n * of the rename quietly laundering the endorsement.\n */\n endorsedAs?: string[];\n activityBacked?: boolean;\n}\n\nexport interface SkillSuggestion {\n canonicalName: string;\n slug: string;\n category: string;\n}\n\nexport interface Endorsement {\n endorserDid: string;\n endorserHandle: string;\n endorserDisplayName?: string;\n endorserAvatar?: string;\n comment?: string;\n relationshipContext?: string;\n createdAt: string;\n}\n\nexport interface EndorsementData {\n skillRkey: string;\n comment?: string;\n relationshipContext?: string;\n}\n\nexport interface ProfileLocation {\n rkey: string;\n type: string;\n label?: string | null;\n isPrimary: boolean;\n locationCountry?: string | null;\n locationRegion?: string | null;\n /** Legacy alias for `locationLocality`; emitted by sifa-api during the additive response window. */\n locationCity?: string | null;\n /** community.lexicon.location.address field name -- prefer over `locationCity`. */\n locationLocality?: string | null;\n countryCode?: string | null;\n location?: string | null;\n}\n\nexport interface ProfileCertification {\n rkey: string;\n name: string;\n /**\n * Issuing organization. The write contract names this field `authority`\n * everywhere (record schema, DB column, PDS record); the AppView read view\n * emits `authority` as the canonical field (#249). Optional during the\n * deprecation window while consumers migrate off the legacy `issuingOrg`\n * alias below.\n */\n authority?: string;\n /**\n * @deprecated Legacy read-view alias for {@link authority} (#249). Carries the\n * same value; will be dropped once web + SDK consumers read `authority`.\n */\n issuingOrg?: string;\n /**\n * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the issuing\n * organization to a resolved entity (#159/#241). Absent for free-text entries.\n * Mirrors `ProfilePosition.entityRef`; the AppView sends it for display.\n */\n entityRef?: string;\n /**\n * Resolved current canonical name of the durably-linked issuing organization\n * (#252), computed by the AppView at read time. Render this over `authority`\n * for a linked entry. Absent for free-text or unresolved entries (fall back to\n * `authority`).\n */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n issueDate?: string;\n expiryDate?: string;\n credentialUrl?: string;\n hidden?: boolean;\n}\n\n/**\n * A calendar event a project organized or hosted, with display fields the\n * AppView resolved from the referenced community.lexicon.calendar.event.\n */\nexport interface ProjectEventView {\n /** AT-URI of the community.lexicon.calendar.event. */\n uri: string;\n /** The user's role at this occurrence, when it differs from the project's role. */\n role?: string;\n name?: string;\n /** ISO datetime. Use the date part for display; the time is not meaningful for past events. */\n startsAt?: string;\n /** community.lexicon.calendar.event mode token. */\n mode?: string;\n locality?: string;\n /** ISO 3166-1 alpha-2. */\n country?: string;\n url?: string;\n}\n\nexport interface ProfileProject {\n rkey: string;\n name: string;\n /** The user's own role on the project (#596), e.g. Maintainer. */\n role?: string;\n description?: string;\n url?: string;\n startDate?: string;\n endDate?: string;\n /** Other people named on this project, hydrated from the stored DIDs. */\n members?: ProjectMemberCard[];\n /**\n * AT-URI of the same project as recorded elsewhere, when this entry\n * duplicates another person's. Set so consumers can tell the two describe one\n * project; both still render from their own owner's record.\n */\n /** AT-URI of the same record on another person's profile, when they keep one. */\n sameAs?: string;\n /** Calendar events this project organized or hosted, newest first. */\n events?: ProjectEventView[];\n hidden?: boolean;\n /** User-flagged primary project, surfaced in the Highlights block. Ongoing only. */\n primary?: boolean;\n}\n\nexport interface PublicationContributor {\n name: string;\n orcidId?: string;\n did?: string;\n handle?: string;\n}\n\n/**\n * A co-author an importer produced that the profile owner can offer to link to\n * a Sifa account.\n *\n * Matched on verified ORCID iD only, never on name: \"A. Example\", \"Alice\n * Example\", and \"Example, A.\" are one person, and \"J. Smith\" is four hundred.\n *\n * A suggestion, never a claim. Nothing reaches any repository until the owner\n * acts, which is what makes ORCID re-syncing safe: matching writes nothing, so\n * a re-sync cannot generate a confirmation request.\n */\nexport interface AuthorSuggestion {\n /** ORCID iD the match was made on. The join key back to a contributor. */\n orcidId: string;\n did: string;\n handle: string;\n /** Display name on the matched account, for showing what is being proposed. */\n displayName?: string;\n}\n\n/**\n * A typed link from a work to another version or form of it\n * (`id.sifa.defs#relatedIdentifier`). `relationType` uses the DataCite\n * vocabulary, e.g. `IsPreprintOf` on a preprint pointing at its published\n * version. `identifierType` is `DOI` (the default when absent), `AT-URI` or `URL`.\n */\nexport interface RelatedIdentifier {\n identifier: string;\n identifierType?: string;\n relationType: string;\n}\n\nexport interface ProfilePublication {\n rkey: string;\n title: string;\n subtitle?: string;\n publisher?: string;\n date?: string;\n url?: string;\n description?: string;\n source?: 'sifa' | 'standard' | 'orcid';\n doi?: string;\n type?: string;\n typeLabel?: string;\n contributors?: PublicationContributor[];\n verified?: boolean;\n verifiedVia?: string;\n orcidPutCode?: number;\n hidden?: boolean;\n /** User-flagged primary publication, surfaced in the Highlights block. */\n primary?: boolean;\n orcidCorroborated?: boolean;\n pendingVerification?: boolean;\n appId?: string;\n /**\n * AT-URI of the parent `site.standard.publication` for Standard.site\n * articles — the subscribable unit. Used to group articles by publication\n * on the profile. Undefined for Sifa/ORCID publications.\n */\n publicationUri?: string | null;\n /** Canonical publication origin — the subscribe / link-out target. */\n publicationUrl?: string | null;\n /** Publication display name for the group header (falls back to host). */\n publicationName?: string | null;\n /**\n * Cover image URL for Standard.site articles — the document's `coverImage`\n * blob (CDN-served), falling back to the article page's og:image. Undefined\n * for Sifa/ORCID publications, null when none could be resolved.\n */\n image?: string | null;\n /**\n * Other versions or forms of this work: relations declared on the record\n * plus, for a DOI, those registered with DataCite or Crossref (#590). Feed\n * to `groupPublicationVersions` to fold a preprint under its published version.\n */\n relatedIdentifiers?: RelatedIdentifier[];\n /**\n * Times this work has been cited, as counted by OpenAlex for its DOI. Only\n * sent when the profile owner turned citation counts on and OpenAlex knows\n * the DOI. A display value, never a ranking signal.\n */\n citationCount?: number;\n /** OpenAlex work id (`W…`) the count belongs to; see `openAlexWorkUrl`. */\n openAlexId?: string;\n}\n\nexport interface ProfileVolunteering {\n rkey: string;\n organization: string;\n /**\n * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the\n * organization to a resolved entity (#159/#241). Absent for free-text entries.\n * Mirrors `ProfilePosition.entityRef`; the AppView sends it for display.\n */\n entityRef?: string;\n /**\n * Resolved current canonical name of the durably-linked organization (#252),\n * computed by the AppView at read time. Render this over `organization` for a\n * linked entry. Absent for free-text or unresolved entries (fall back to\n * `organization`).\n */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n role?: string;\n cause?: string;\n startDate?: string;\n endDate?: string;\n description?: string;\n hidden?: boolean;\n}\n\nexport interface ProfileHonor {\n rkey: string;\n title: string;\n issuer?: string;\n /**\n * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the issuer to a\n * resolved entity (#159/#241). Absent for free-text entries. Mirrors\n * `ProfilePosition.entityRef`; the AppView sends it for display.\n */\n entityRef?: string;\n /**\n * Resolved current canonical name of the durably-linked issuer (#252),\n * computed by the AppView at read time. Render this over `issuer` for a linked\n * entry. Absent for free-text or unresolved entries (fall back to `issuer`).\n */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n date?: string;\n description?: string;\n hidden?: boolean;\n}\n\n/**\n * One proof link on an involvement record, as served by the AppView. Mirrors\n * `id.sifa.defs#artifactLink`, plus the computed rung-2 verification signal.\n */\nexport interface ProfileInvolvementLink {\n url: string;\n kind?: string;\n label?: string;\n /**\n * Rung-2 cross-ref: true when the link host matches one of the owner's\n * *verified* `externalAccount` records (GitHub, GitLab, ORCID, ...).\n * Computed by the AppView; deterministic host match, no new primitive.\n */\n verified?: boolean;\n /**\n * Platform token of the matched verified external account (e.g.\n * `id.sifa.defs#platformGithub`), for the badge label. Absent when\n * `verified` is not true.\n */\n verifiedPlatform?: string;\n}\n\n/**\n * An involvement entry as served by the AppView: an `id.sifa.profile.involvement`\n * record, or a mapped legacy `id.sifa.profile.volunteering` record (`legacy`),\n * grouped in the UI by `kind` via the SDK's involvement-kind taxonomy.\n */\n/** One artifact link on an investment (round announcement, portfolio page, filing). */\nexport interface ProfileInvestmentLink {\n url: string;\n kind?: string;\n label?: string;\n}\n\n/** A capital position: money the person put in. Roles with duties are positions. */\nexport interface ProfileInvestment {\n rkey: string;\n /** For a limited-partner entry this names the fund, not a portfolio company. */\n company: string;\n companyDid?: string;\n entityRef?: string;\n /** Resolved canonical name of the linked company. Render over `company` when present. */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n /** How the capital went in. Angel, syndicate member or LP -- never GP. */\n role?: string;\n /** The company's funding stage at the time of the investment, not its stage today. */\n stage?: string;\n /** active / exited / written off / undisclosed. */\n status?: string;\n /** The vehicle the capital went through. Absent for a cheque in the person's own name. */\n via?: string;\n viaDid?: string;\n viaEntityRef?: string;\n /** Whole major currency units plus an ISO 4217 code. Absent unless the person opted in. */\n amount?: { value: number; currency: string };\n startedAt?: string;\n endedAt?: string;\n description?: string;\n links?: ProfileInvestmentLink[];\n hidden?: boolean;\n}\n\nexport interface ProfileInvolvement {\n rkey: string;\n /** Involvement-kind token; drives the display heading. Legacy rows map to charity. */\n kind: string;\n upstream?: string;\n upstreamDid?: string;\n upstreamUrl?: string;\n role?: string;\n description?: string;\n startedAt?: string;\n endedAt?: string;\n links?: ProfileInvolvementLink[];\n /**\n * Portable org entity identifier (Wikidata/ROR/LEI URI) written when the user\n * picks the upstream from the resolver typeahead. Absent for free-text or\n * one-off involvement.\n */\n entityRef?: string;\n /**\n * Resolved current canonical name of the durably-linked upstream, computed by\n * the AppView at read time. Render over `upstream` when present. Absent for\n * free-text or unresolved entries.\n */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n location?: LocationValue | null;\n skills?: SkillRef[];\n /** Skill records resolved from `skills`, for display. */\n linkedSkills?: ProfileSkill[];\n /**\n * True when this row is a mapped legacy `id.sifa.profile.volunteering` record\n * (no `kind`), rendered under \"Volunteering\". Editing it backfills to an\n * `involvement` record and deletes the legacy one.\n */\n legacy?: boolean;\n hidden?: boolean;\n /** User-flagged primary involvement, surfaced in the Highlights block. Ongoing only. */\n primary?: boolean;\n /** Other people named on this involvement, hydrated from the stored DIDs. */\n collaborators?: ProjectMemberCard[];\n /** AT-URI of the same involvement as recorded on another person's profile. */\n sameAs?: string;\n}\n\nexport type LanguageProficiency =\n 'elementary' | 'limited_working' | 'professional_working' | 'full_professional' | 'native';\n\nexport interface ProfileLanguage {\n rkey: string;\n language: string;\n proficiency?: LanguageProficiency;\n hidden?: boolean;\n}\n\nexport interface ProfileCourse {\n rkey: string;\n name: string;\n institution?: string;\n /**\n * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the institution\n * to a resolved entity (#159/#241). Absent for free-text entries. Mirrors\n * `ProfilePosition.entityRef`; the AppView sends it for display.\n */\n entityRef?: string;\n /**\n * Resolved current canonical name of the durably-linked institution (#252),\n * computed by the AppView at read time. Render this over `institution` for a\n * linked entry. Absent for free-text or unresolved entries (fall back to\n * `institution`).\n */\n entityName?: string;\n /**\n * Canonical org reference (#511): a nested mirror of the flat\n * name / did / entityRef fields. Prefer it when present; the nested\n * shape wins over the flat fields (resolveAgentRef precedence).\n */\n agentRef?: AgentRef;\n number?: string;\n /** rkey of the associated certification, resolved from the course's\n * `credential` at-uri. Used to join the course to a certification in the\n * same profile payload (for the linked-credential date and link). */\n credentialRkey?: string;\n /** Date the course was completed, as an RFC 3339 datetime. Optional; the\n * editor collects month granularity (YYYY-MM). */\n completedAt?: string;\n /** `id.sifa.defs#courseRole` token. Absent means the user took the course. */\n role?: string;\n /** Teaching period of a taught or assisted course (YYYY, YYYY-MM or YYYY-MM-DD). */\n startedAt?: string;\n endedAt?: string;\n /** rkey of the position the course was part of (taught under it, or taken\n * as part of the job). The AppView resolves it from the record's `position`\n * at-uri when building the profile view. */\n positionRkey?: string;\n /** rkey of the education record the course was part of, resolved by the\n * AppView from the record's `education` at-uri. */\n educationRkey?: string;\n hidden?: boolean;\n}\n\n/** A related link on a presentation or delivery, as returned by the AppView. */\nexport interface PresentationLinkView {\n uri: string;\n label?: string;\n type?: string;\n}\n\n/**\n * Another person named on someone's record, as rendered by the AppView.\n *\n * `displayName` and `avatar` are present when the person's identity may be\n * shown -- i.e. when {@link actorShowsIdentity} holds (`confirmed` or\n * `claimed`). Otherwise the card is a bare handle with no identity attached and\n * no link to a profile: naming someone is a claim, and until they affirm it (or\n * hold a claimed Sifa account that can be notified of the claim) the claim must\n * not borrow their face.\n */\nexport interface ActorCard {\n did: string;\n handle: string;\n displayName?: string;\n avatar?: string;\n /**\n * True when Sifa has indexed this account at all -- including an unclaimed\n * atproto account seen via the firehose, which still renders at /p/<handle>.\n * Broader than {@link claimed}; not on its own a reason to show identity.\n */\n hasSifaProfile?: boolean;\n /**\n * True when the named person has a claimed Sifa account (has authenticated\n * via OAuth). A claimed account can be notified of a pending claim, so its\n * identity is shown even before confirmation -- see {@link actorShowsIdentity}.\n */\n claimed?: boolean;\n /** True once the named person has published a matching `id.sifa.confirmation`. */\n confirmed?: boolean;\n /**\n * True when the record was materially changed after being confirmed -- a\n * rename, or a changed role. The confirmation stands until withdrawn, but the\n * UI should say the claim has moved since it was affirmed.\n */\n confirmedStale?: boolean;\n}\n\n/** @deprecated Use {@link ActorCard}. Kept so existing co-speaker call sites keep compiling. */\nexport type CoSpeaker = ActorCard;\n\n/**\n * Roles shipped today. The lexicon declares these as `knownValues`, so the\n * field itself stays a plain string: a consumer meeting a role it does not\n * recognise should show it rather than discard it.\n *\n * Display only. A record living in someone else's repository cannot grant\n * write access to anything, and the UI must not imply that it does.\n */\nexport const PROJECT_ROLES = [\n 'id.sifa.defs#projectOwner',\n 'id.sifa.defs#projectCore',\n 'id.sifa.defs#projectContributor',\n] as const;\n\nexport type ProjectRole = (typeof PROJECT_ROLES)[number];\n\n/** A person named as a member of a project, with their role alongside the actor card. */\nexport interface ProjectMemberCard extends ActorCard {\n role?: string;\n title?: string;\n}\n\n/** An occasion on which a presentation was delivered (the AppView view-model). */\nexport interface ProfilePresentationDelivery {\n rkey: string;\n /** rkey of the parent presentation when this delivery references one. */\n presentationRkey?: string | null;\n /** Co-speakers at this occasion, hydrated from the stored DIDs. */\n coSpeakers?: CoSpeaker[];\n /** AT-URI of the same session as recorded on another person's profile. */\n sameAs?: string;\n title?: string | null;\n role?: string | null;\n eventName?: string | null;\n /** YYYY-MM-DD, or YYYY-MM / YYYY when the exact day is unknown. */\n date?: string | null;\n location?: string | null;\n locationCountry?: string | null;\n locationRegion?: string | null;\n locationLocality?: string | null;\n countryCode?: string | null;\n /** Full community.lexicon.calendar.event mode token. */\n mode?: string | null;\n /** Full community.lexicon.calendar.event status token. */\n status?: string | null;\n links?: PresentationLinkView[];\n /** at-uri of the linked calendar event, when present. */\n eventUri?: string | null;\n hidden?: boolean;\n}\n\n/** A reusable presentation with its deliveries grouped underneath (AppView view-model). */\nexport interface ProfilePresentation {\n rkey: string;\n title: string;\n description?: string | null;\n /** Duration in minutes: a fixed value (min only) or a range. */\n duration?: { minMinutes: number; maxMinutes?: number } | null;\n intendedAudiences?: string[];\n links?: PresentationLinkView[];\n /** at-uri of a long-form write-up (Leaflet / site.standard document). */\n writeupUri?: string | null;\n /** Resolved URL of the uploaded cover image, when present. */\n coverImageUrl?: string | null;\n hidden?: boolean;\n /** User-flagged primary talk, surfaced in the Highlights block. Talks only, not sessions. */\n primary?: boolean;\n deliveries?: ProfilePresentationDelivery[];\n}\n\nexport interface TrustStat {\n key: string;\n label: string;\n value: number;\n}\n\nexport interface ActiveApp {\n id: string;\n name: string;\n category: string;\n recentCount: number;\n latestRecordAt?: string | null;\n}\n\nexport interface VerifiedAccount {\n platform: string;\n identifier: string;\n url?: string;\n}\n\nexport interface ExternalAccountKeytraceClaim {\n rkey: string;\n claimedAt: string;\n}\n\nexport interface ExternalAccount {\n rkey: string;\n platform: string;\n url: string;\n label?: string;\n feedUrl?: string;\n primary?: boolean;\n verifiable: boolean;\n verified: boolean;\n verifiedVia?: string | null;\n source?: 'sifa' | 'keytrace' | 'keyoxide' | 'marque';\n hidden?: boolean;\n keytraceVerified?: boolean;\n keytraceClaim?: ExternalAccountKeytraceClaim;\n}\n\nexport interface FeedItem {\n title: string;\n excerpt: string;\n url: string;\n timestamp: string;\n source: string;\n}\n\nexport interface PdsProviderInfo {\n name: string;\n host: string;\n}\n\nexport interface ProfileIndustry {\n industry: string;\n domain?: string;\n}\n\nexport interface ProfileOverrideSource {\n headline?: string;\n about?: string;\n displayName?: string;\n avatarUrl?: string;\n}\n\n/**\n * A structured physical address on the org view. Mirrors\n * `community.lexicon.location.address`; every field is optional.\n */\nexport interface OrgAddressView {\n country: string | null;\n postalCode: string | null;\n region: string | null;\n locality: string | null;\n street: string | null;\n name: string | null;\n}\n\n/** A featured link on the org view. Both `name` and `url` are present. */\nexport interface OrgLinkView {\n name: string;\n url: string;\n}\n\n/**\n * A self-declared industry/domain pair on the org view. Mirrors the person\n * profile's industry/domain shape; `industry` is always present, `domain` is an\n * optional refinement (`null` when absent).\n */\nexport interface OrgIndustryView {\n industry: string;\n domain: string | null;\n}\n\n/**\n * The org-profile fields exposed on the profile resolve when the org rendering\n * floor is met. Narrow on purpose: `contact` is never included (not rendered\n * publicly); record URI/CID are internal. Mirrors sifa-api's `OrgProfileView`.\n */\nexport interface OrgProfileView {\n name: string;\n description: string | null;\n website: string | null;\n /** Blob CID (or resolved URL) of the org logo, when present. */\n logoBlob: string | null;\n entityRefs: string[] | null;\n addresses: OrgAddressView[] | null;\n /** Self-selected headcount range (declared bucket, never calculated). */\n companySize: string | null;\n companyType: string | null;\n links: OrgLinkView[] | null;\n /** Self-declared industry/domain pairs. */\n industries: OrgIndustryView[] | null;\n /** Self-declared founding date (year / YYYY-MM / YYYY-MM-DD). */\n founded: string | null;\n /** Self-declared \"also known as\" names / acronyms. */\n aliases: string[] | null;\n}\n\n/**\n * A company entity recognized purely from the handle's registrable domain\n * (#160 auto-recognize), independent of any org record. Present on the verdict\n * when `recognized` is true. `domain` is the handle's registrable domain and\n * round-trips through `/c/<domain>`; `publicId` is nullable because entities\n * minted before the public_id backfill have none.\n */\nexport interface RecognizedEntity {\n publicId: string | null;\n domain: string;\n name: string;\n}\n\n/**\n * Server-computed org rendering-floor verdict (#160), carried on the profile\n * resolve so clients need no extra round-trip. Read it via the `useOrgProfile`\n * hook.\n *\n * `isOrg` is the CLAIMED floor: true when the account has an\n * `id.sifa.org.profile` record AND its handle is a custom registrable domain\n * (the authoritative, PSL-backed check lives server-side).\n *\n * `recognized` is INDEPENDENT of `isOrg`: true when the handle's registrable\n * domain resolves to a known, non-suppressed, non-natural-person company entity\n * in Sifa's DB, even with no org record yet (auto-recognize known-company\n * domains). A known company that has not yet claimed is\n * `recognized: true, isOrg: false`; a claimed recognized company is both true.\n * Use it to treat a recognized-but-unclaimed company account as a company\n * (company onboarding, `/c/` routing) before it claims.\n */\nexport interface OrgFloorVerdict {\n isOrg: boolean;\n orgProfile?: OrgProfileView;\n recognized: boolean;\n /**\n * Whether the account's handle is a custom registrable apex domain, i.e.\n * eligible to CLAIM an org page (#306). Mirrors the `isBindableHandleDomain`\n * floor the api enforces at write time, surfaced so the `/claim` wizard can\n * gate on eligibility BEFORE the authority consent rather than failing the\n * final PDS write. Independent of `isOrg`/`recognized` -- purely the handle's\n * shape, so a `*.bsky.social` account reads false and a not-yet-claimed\n * custom domain reads true.\n *\n * Optional here (a tolerant reader): the api always emits it, but a profile\n * payload cached before this field shipped may omit it. Gate on the explicit\n * `customDomain === false` for the up-front block; treat absent as unknown and\n * let the api 403 stay the authoritative backstop -- never enforce on this\n * field alone.\n */\n customDomain?: boolean;\n /**\n * Whether the account also keeps a visible personal profile, from\n * `id.sifa.org.profile.personalProfileVisible`. True only for a claimed org\n * (`isOrg`) that opted in -- the sole-trader case, where one DID carries both\n * a person facet at `/p/` and a company facet at `/c/` and neither route\n * redirects to the other. Absent or false is the exclusive default: the\n * account presents solely as an organization and `/p/` redirects to `/c/`.\n */\n personalProfileVisible?: boolean;\n /**\n * Invariant (not encoded in the type, matching the flat wire shape the api\n * sends): present whenever `recognized` is true, absent when false. Callers\n * that read it after narrowing on `recognized === true` should still\n * defensively check, since the type does not enforce the pairing.\n */\n recognizedEntity?: RecognizedEntity;\n}\n\n/**\n * The account owner's answer to \"are you a person, a company, or both?\".\n *\n * `'person'` and `'company'` are Sifa-local overrides stored in\n * `account_render_overrides` (set via `POST /api/account/render-preference`).\n * `'both'` is NOT stored here -- it is the portable\n * `id.sifa.org.profile.personalProfileVisible` declaration in the account's own\n * PDS, so any AppView can evaluate it without asking Sifa. Resolve the combined\n * answer with `resolveAccountFacetMode`.\n */\nexport type AccountFacetMode = 'person' | 'company' | 'both';\n\nexport interface Profile {\n did: string;\n handle: string;\n /**\n * Sifa-local render override, absent when the account has never set one\n * (auto: today's recognition behaviour). `'person'` is the escape hatch for a\n * personal domain that Sifa catalogued as a company.\n */\n renderPreference?: 'person' | 'company' | null;\n /**\n * Org rendering-floor verdict (#160). Present on the profile resolve; absent\n * on payloads that predate the field. When `org.isOrg` is true the account\n * renders as an organization (`/c/`).\n */\n org?: OrgFloorVerdict;\n displayName?: string;\n /**\n * Given (first) name from `id.sifa.profile.self.givenName`. Schema.org\n * `Person.givenName`. Optional; absent for users who haven't filled in\n * structured name fields. Consumers wanting a rendered name should use\n * `formatStructuredName(givenName, familyName) ?? displayName ?? handle`.\n */\n givenName?: string;\n /**\n * Family (last) name from `id.sifa.profile.self.familyName`. Schema.org\n * `Person.familyName`. See `givenName` for fallback guidance.\n */\n familyName?: string;\n /**\n * Free-form phonetic respelling of the user's name from\n * `id.sifa.profile.self.namePronunciation` (e.g. `Foo-kuh`). Optional; a\n * native field with no `app.bsky.actor.profile` equivalent. Text only.\n */\n namePronunciation?: string;\n /**\n * Resolved URL of the name-pronunciation audio clip from\n * `id.sifa.profile.self.namePronunciationAudio`, served from the user's PDS\n * (`com.atproto.sync.getBlob`). Optional; absent when no clip is set.\n */\n namePronunciationAudioUrl?: string;\n avatar?: string;\n /**\n * `id.sifa.profile.self.avatarSource`, e.g. `actor.rpg.sprite` when the user\n * shows their rpg.actor character as their avatar. `avatar` already holds\n * the resolved picture; this only says where it comes from, so an editor\n * can show the current choice. Absent when the uploaded or Bluesky avatar\n * is used.\n */\n avatarSource?: string;\n pronouns?: string;\n headline?: string;\n about?: string;\n hasHeadlineOverride?: boolean;\n hasAboutOverride?: boolean;\n hasDisplayNameOverride?: boolean;\n hasAvatarUrlOverride?: boolean;\n source?: ProfileOverrideSource;\n industries?: ProfileIndustry[];\n location?: LocationValue | null;\n locations?: ProfileLocation[];\n /**\n * @deprecated Flat location field emitted at the response root during the\n * additive response window for `community.lexicon.location.address`.\n * Prefer the structured `locations[]` array (use the entry where\n * `isPrimary` is true).\n */\n locationCountry?: string | null;\n /**\n * @deprecated See `locationCountry`. Prefer `locations[].locationRegion`.\n */\n locationRegion?: string | null;\n /**\n * @deprecated Legacy alias for `locationLocality`; emitted alongside it\n * during the additive response window. Prefer `locations[].locationLocality`.\n */\n locationCity?: string | null;\n /**\n * @deprecated community.lexicon.location.address field name. Prefer\n * `locations[].locationLocality`.\n */\n locationLocality?: string | null;\n /**\n * @deprecated See `locationCountry`. Prefer `locations[].countryCode`.\n */\n countryCode?: string | null;\n website?: string;\n openTo?: string[];\n preferredWorkplace?: string[];\n availableFromUtc?: number;\n availableToUtc?: number;\n pdsProvider?: PdsProviderInfo | null;\n claimed: boolean;\n /**\n * User-set opt-out flag from `id.sifa.profile.self.discoverable`. When\n * `false`, the rendering app emits `noindex` and excludes the page from\n * sitemaps. Absent means default-true (current behavior for existing\n * records that predate this field).\n */\n discoverable?: boolean;\n isOwnProfile?: boolean;\n createdAt?: string;\n trustStats?: TrustStat[];\n verifiedAccounts?: VerifiedAccount[];\n activeApps?: ActiveApp[];\n blueskyVerified?: boolean;\n blueskyVerifiedAt?: string | null;\n /**\n * Every verification the account holds, across all recognized providers\n * (Bluesky and firehose-sourced ones like mu). Supersedes the Bluesky-only\n * `blueskyVerified` pair for badge rendering. Absent on older API responses.\n */\n verificationBadges?: AccountVerification[];\n followersCount: number;\n followingCount: number;\n connectionsCount: number;\n atprotoFollowersCount?: number;\n positions: ProfilePosition[];\n education: ProfileEducation[];\n skills: ProfileSkill[];\n certifications?: ProfileCertification[];\n projects?: ProfileProject[];\n publications?: ProfilePublication[];\n /**\n * Co-authors on imported publications that resolve to a Sifa account.\n *\n * Owner-only, and absent rather than empty for every other viewer, so a\n * consumer cannot tell \"no suggestions\" from \"not yours\". Join to a\n * publication contributor by `orcidId`.\n */\n authorSuggestions?: AuthorSuggestion[];\n volunteering?: ProfileVolunteering[];\n involvement?: ProfileInvolvement[];\n investments?: ProfileInvestment[];\n honors?: ProfileHonor[];\n languages?: ProfileLanguage[];\n courses?: ProfileCourse[];\n presentations?: ProfilePresentation[];\n presentationDeliveries?: ProfilePresentationDelivery[];\n externalAccounts?: ExternalAccount[];\n}\n"],"mappings":";AAqtBO,IAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AACF;","names":[]}
@@ -1,4 +1,4 @@
1
- import { B as PresentationLinkView, b as PdsProviderInfo, Y as SkillSuggestion } from './index-5T1grOo4.js';
1
+ import { D as PresentationLinkView, b as PdsProviderInfo, Z as SkillSuggestion } from './index-DDh2RLvx.js';
2
2
  import { a as AccountVerification } from './verification-providers-DeyGqaoC.js';
3
3
  import { z } from 'zod';
4
4
 
@@ -1,4 +1,4 @@
1
- import { B as PresentationLinkView, b as PdsProviderInfo, Y as SkillSuggestion } from './index-CL8l5aB-.cjs';
1
+ import { D as PresentationLinkView, b as PdsProviderInfo, Z as SkillSuggestion } from './index-BQAKeEoj.cjs';
2
2
  import { a as AccountVerification } from './verification-providers-DeyGqaoC.cjs';
3
3
  import { z } from 'zod';
4
4
 
@@ -1,10 +1,10 @@
1
1
  import * as react from 'react';
2
2
  import { ReactNode } from 'react';
3
- import { a1 as SifaApiConfig, a0 as ApiFetchOptions, a2 as WriteResult, o as ProfileView, a3 as CreateResult, a5 as FilterOptions, S as SearchFilters, a8 as SearchResponse, a9 as SkillSearchResult, ai as CompanySearchFilters, aj as CompanySearchResponse, u as RepoDeleteResult, x as RepoInventory } from './types-B9nkqX3O.js';
3
+ import { a1 as SifaApiConfig, a0 as ApiFetchOptions, a2 as WriteResult, o as ProfileView, a3 as CreateResult, a5 as FilterOptions, S as SearchFilters, a8 as SearchResponse, a9 as SkillSearchResult, ai as CompanySearchFilters, aj as CompanySearchResponse, u as RepoDeleteResult, x as RepoInventory } from './types-B0zZiWDH.js';
4
4
  import * as _tanstack_react_query from '@tanstack/react-query';
5
5
  import { UseQueryOptions, UseMutationOptions, UseInfiniteQueryOptions, InfiniteData } from '@tanstack/react-query';
6
- import { c as Profile, d as ProfilePosition, X as SkillRef, p as ExternalAccount, Y as SkillSuggestion, s as OrgFloorVerdict } from './index-5T1grOo4.js';
7
- import { s as sifaQueryKeys, aJ as RefreshPdsResult, b6 as UpdateProfileOverrideInput, b7 as UpdateProfileSelfInput, b8 as UploadAvatarResult, b9 as UploadPronunciationAudioResult, at as PrimarySection, a$ as SubCategoryBulkResult, ay as ProfileLocationInput, q as ExternalAccountInput, n as CreateExternalAccountResult, bd as VerifyExternalAccountResult, E as EndorsementInput, l as ConfirmationInput, m as ConfirmationSubjectInput, a3 as GivenConfirmation, as as PendingConfirmationsPage, ae as InboxCounts, p as DismissUnlinkedPositionInput, b4 as UnlinkedPositionsResult, o as DismissCompletenessSignalInput, au as ProfileCompleteness, aR as RpgClaimableResponse, aV as RpgStatusResponse, aI as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, ad as HideProfileItemInput, a8 as HiddenActivityItem, ac as HideActivityItemInput, b2 as UnhideActivityItemInput, f as ActivityPreferences, aZ as SiteActivityPresetResponse, b5 as UpdateActivityPreferencesInput, a_ as StatsResponse, i as AppRegistryEntry, a9 as HiddenApp, b as AccountSummary, r as FeaturedProfile, aY as SimilarProfile, Q as FetchSuggestionsOptions, b1 as SuggestionsResponse, W as FollowUserResult, y as FetchFollowListOptions, T as FollowListPage, a0 as FollowingResponse, G as FetchFollowingFeedOptions, _ as FollowingFeedResponse, $ as FollowingFeedVersion, z as FetchFollowProfilePageOptions, V as FollowProfilePageResponse, F as FeatureAllowlistResponse, h as AdminReviewQueues, u as FetchActivityFeedOptions, c as ActivityFeedResponse, g as ActivityTeaserResponse, a7 as HeatmapResponse, ag as MyGithubPullRequestsResponse, A as AccountCheckResult, aH as ReactionStatus, aG as ReactionResult, aF as ReactionError, aQ as RoadmapVotesResponse, j as CastRoadmapVoteResult, D as DeleteAccountResult, aL as ResetProfileResult, be as WipePreview, aK as RepoDeleteInput, ai as OrgClaimResult, ao as OrgProfileUpdateResult, aj as OrgDomainChallengeResult, ak as OrgDomainVerifyResult, al as OrgNotificationEmailAddResult, am as OrgNotificationEmailRemoveResult, ba as UserSettings } from './user-settings-C_8R5XSQ.js';
6
+ import { c as Profile, d as ProfilePosition, Y as SkillRef, p as ExternalAccount, Z as SkillSuggestion, s as OrgFloorVerdict } from './index-DDh2RLvx.js';
7
+ import { s as sifaQueryKeys, aJ as RefreshPdsResult, b6 as UpdateProfileOverrideInput, b7 as UpdateProfileSelfInput, b8 as UploadAvatarResult, b9 as UploadPronunciationAudioResult, at as PrimarySection, a$ as SubCategoryBulkResult, ay as ProfileLocationInput, q as ExternalAccountInput, n as CreateExternalAccountResult, bd as VerifyExternalAccountResult, E as EndorsementInput, l as ConfirmationInput, m as ConfirmationSubjectInput, a3 as GivenConfirmation, as as PendingConfirmationsPage, ae as InboxCounts, p as DismissUnlinkedPositionInput, b4 as UnlinkedPositionsResult, o as DismissCompletenessSignalInput, au as ProfileCompleteness, aR as RpgClaimableResponse, aV as RpgStatusResponse, aI as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, ad as HideProfileItemInput, a8 as HiddenActivityItem, ac as HideActivityItemInput, b2 as UnhideActivityItemInput, f as ActivityPreferences, aZ as SiteActivityPresetResponse, b5 as UpdateActivityPreferencesInput, a_ as StatsResponse, i as AppRegistryEntry, a9 as HiddenApp, b as AccountSummary, r as FeaturedProfile, aY as SimilarProfile, Q as FetchSuggestionsOptions, b1 as SuggestionsResponse, W as FollowUserResult, y as FetchFollowListOptions, T as FollowListPage, a0 as FollowingResponse, G as FetchFollowingFeedOptions, _ as FollowingFeedResponse, $ as FollowingFeedVersion, z as FetchFollowProfilePageOptions, V as FollowProfilePageResponse, F as FeatureAllowlistResponse, h as AdminReviewQueues, u as FetchActivityFeedOptions, c as ActivityFeedResponse, g as ActivityTeaserResponse, a7 as HeatmapResponse, ag as MyGithubPullRequestsResponse, A as AccountCheckResult, aH as ReactionStatus, aG as ReactionResult, aF as ReactionError, aQ as RoadmapVotesResponse, j as CastRoadmapVoteResult, D as DeleteAccountResult, aL as ResetProfileResult, be as WipePreview, aK as RepoDeleteInput, ai as OrgClaimResult, ao as OrgProfileUpdateResult, aj as OrgDomainChallengeResult, ak as OrgDomainVerifyResult, al as OrgNotificationEmailAddResult, am as OrgNotificationEmailRemoveResult, ba as UserSettings } from './user-settings-D_DjukR6.js';
8
8
  import { z } from 'zod';
9
9
  import { i as EntitySearchResponse, E as EntitySearchResult, c as EntityMintDomainResponse, g as EntityResolveDomainResponse, n as EntitySelectResponse, l as EntitySelectRequest, r as FeatureFlag } from './follow-profile-CVcA2w1v.js';
10
10
  import { O as OrgClaimRequestInput, h as OrgProfileUpdateRequestInput, b as OrgDomainChallengeRequestInput, d as OrgDomainVerifyRequestInput, f as OrgNotificationEmailRequestInput } from './org-settings-BShvhyFp.js';
@@ -1,10 +1,10 @@
1
1
  import * as react from 'react';
2
2
  import { ReactNode } from 'react';
3
- import { a1 as SifaApiConfig, a0 as ApiFetchOptions, a2 as WriteResult, o as ProfileView, a3 as CreateResult, a5 as FilterOptions, S as SearchFilters, a8 as SearchResponse, a9 as SkillSearchResult, ai as CompanySearchFilters, aj as CompanySearchResponse, u as RepoDeleteResult, x as RepoInventory } from './types-C6ghq8Fv.cjs';
3
+ import { a1 as SifaApiConfig, a0 as ApiFetchOptions, a2 as WriteResult, o as ProfileView, a3 as CreateResult, a5 as FilterOptions, S as SearchFilters, a8 as SearchResponse, a9 as SkillSearchResult, ai as CompanySearchFilters, aj as CompanySearchResponse, u as RepoDeleteResult, x as RepoInventory } from './types-jE1ofoPI.cjs';
4
4
  import * as _tanstack_react_query from '@tanstack/react-query';
5
5
  import { UseQueryOptions, UseMutationOptions, UseInfiniteQueryOptions, InfiniteData } from '@tanstack/react-query';
6
- import { c as Profile, d as ProfilePosition, X as SkillRef, p as ExternalAccount, Y as SkillSuggestion, s as OrgFloorVerdict } from './index-CL8l5aB-.cjs';
7
- import { s as sifaQueryKeys, aJ as RefreshPdsResult, b6 as UpdateProfileOverrideInput, b7 as UpdateProfileSelfInput, b8 as UploadAvatarResult, b9 as UploadPronunciationAudioResult, at as PrimarySection, a$ as SubCategoryBulkResult, ay as ProfileLocationInput, q as ExternalAccountInput, n as CreateExternalAccountResult, bd as VerifyExternalAccountResult, E as EndorsementInput, l as ConfirmationInput, m as ConfirmationSubjectInput, a3 as GivenConfirmation, as as PendingConfirmationsPage, ae as InboxCounts, p as DismissUnlinkedPositionInput, b4 as UnlinkedPositionsResult, o as DismissCompletenessSignalInput, au as ProfileCompleteness, aR as RpgClaimableResponse, aV as RpgStatusResponse, aI as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, ad as HideProfileItemInput, a8 as HiddenActivityItem, ac as HideActivityItemInput, b2 as UnhideActivityItemInput, f as ActivityPreferences, aZ as SiteActivityPresetResponse, b5 as UpdateActivityPreferencesInput, a_ as StatsResponse, i as AppRegistryEntry, a9 as HiddenApp, b as AccountSummary, r as FeaturedProfile, aY as SimilarProfile, Q as FetchSuggestionsOptions, b1 as SuggestionsResponse, W as FollowUserResult, y as FetchFollowListOptions, T as FollowListPage, a0 as FollowingResponse, G as FetchFollowingFeedOptions, _ as FollowingFeedResponse, $ as FollowingFeedVersion, z as FetchFollowProfilePageOptions, V as FollowProfilePageResponse, F as FeatureAllowlistResponse, h as AdminReviewQueues, u as FetchActivityFeedOptions, c as ActivityFeedResponse, g as ActivityTeaserResponse, a7 as HeatmapResponse, ag as MyGithubPullRequestsResponse, A as AccountCheckResult, aH as ReactionStatus, aG as ReactionResult, aF as ReactionError, aQ as RoadmapVotesResponse, j as CastRoadmapVoteResult, D as DeleteAccountResult, aL as ResetProfileResult, be as WipePreview, aK as RepoDeleteInput, ai as OrgClaimResult, ao as OrgProfileUpdateResult, aj as OrgDomainChallengeResult, ak as OrgDomainVerifyResult, al as OrgNotificationEmailAddResult, am as OrgNotificationEmailRemoveResult, ba as UserSettings } from './user-settings-CdXeV4lU.cjs';
6
+ import { c as Profile, d as ProfilePosition, Y as SkillRef, p as ExternalAccount, Z as SkillSuggestion, s as OrgFloorVerdict } from './index-BQAKeEoj.cjs';
7
+ import { s as sifaQueryKeys, aJ as RefreshPdsResult, b6 as UpdateProfileOverrideInput, b7 as UpdateProfileSelfInput, b8 as UploadAvatarResult, b9 as UploadPronunciationAudioResult, at as PrimarySection, a$ as SubCategoryBulkResult, ay as ProfileLocationInput, q as ExternalAccountInput, n as CreateExternalAccountResult, bd as VerifyExternalAccountResult, E as EndorsementInput, l as ConfirmationInput, m as ConfirmationSubjectInput, a3 as GivenConfirmation, as as PendingConfirmationsPage, ae as InboxCounts, p as DismissUnlinkedPositionInput, b4 as UnlinkedPositionsResult, o as DismissCompletenessSignalInput, au as ProfileCompleteness, aR as RpgClaimableResponse, aV as RpgStatusResponse, aI as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, ad as HideProfileItemInput, a8 as HiddenActivityItem, ac as HideActivityItemInput, b2 as UnhideActivityItemInput, f as ActivityPreferences, aZ as SiteActivityPresetResponse, b5 as UpdateActivityPreferencesInput, a_ as StatsResponse, i as AppRegistryEntry, a9 as HiddenApp, b as AccountSummary, r as FeaturedProfile, aY as SimilarProfile, Q as FetchSuggestionsOptions, b1 as SuggestionsResponse, W as FollowUserResult, y as FetchFollowListOptions, T as FollowListPage, a0 as FollowingResponse, G as FetchFollowingFeedOptions, _ as FollowingFeedResponse, $ as FollowingFeedVersion, z as FetchFollowProfilePageOptions, V as FollowProfilePageResponse, F as FeatureAllowlistResponse, h as AdminReviewQueues, u as FetchActivityFeedOptions, c as ActivityFeedResponse, g as ActivityTeaserResponse, a7 as HeatmapResponse, ag as MyGithubPullRequestsResponse, A as AccountCheckResult, aH as ReactionStatus, aG as ReactionResult, aF as ReactionError, aQ as RoadmapVotesResponse, j as CastRoadmapVoteResult, D as DeleteAccountResult, aL as ResetProfileResult, be as WipePreview, aK as RepoDeleteInput, ai as OrgClaimResult, ao as OrgProfileUpdateResult, aj as OrgDomainChallengeResult, ak as OrgDomainVerifyResult, al as OrgNotificationEmailAddResult, am as OrgNotificationEmailRemoveResult, ba as UserSettings } from './user-settings-C5sOgvhL.cjs';
8
8
  import { z } from 'zod';
9
9
  import { i as EntitySearchResponse, E as EntitySearchResult, c as EntityMintDomainResponse, g as EntityResolveDomainResponse, n as EntitySelectResponse, l as EntitySelectRequest, r as FeatureFlag } from './follow-profile-CgLLLQtJ.cjs';
10
10
  import { O as OrgClaimRequestInput, a as OrgProfileUpdateRequestInput, b as OrgDomainChallengeRequestInput, c as OrgDomainVerifyRequestInput, d as OrgNotificationEmailRequestInput } from './org-settings-C73Sin5E.cjs';
@@ -1,5 +1,5 @@
1
- import { a2 as WriteResult, a1 as SifaApiConfig, a0 as ApiFetchOptions, a3 as CreateResult, K as SiteActivityPreset, b as ActivityLabel, u as RepoDeleteResult, x as RepoInventory } from './types-C6ghq8Fv.cjs';
2
- import { p as ExternalAccount, z as PositionViewerConfirmation } from './index-CL8l5aB-.cjs';
1
+ import { a2 as WriteResult, a1 as SifaApiConfig, a0 as ApiFetchOptions, a3 as CreateResult, K as SiteActivityPreset, b as ActivityLabel, u as RepoDeleteResult, x as RepoInventory } from './types-jE1ofoPI.cjs';
2
+ import { p as ExternalAccount, B as PositionViewerConfirmation } from './index-BQAKeEoj.cjs';
3
3
  import { a as AccountVerification } from './verification-providers-DeyGqaoC.cjs';
4
4
  import { s as FollowProfileItem, p as FeatureAllowlistEntry, r as FeatureFlag } from './follow-profile-CgLLLQtJ.cjs';
5
5
  import { z } from 'zod';
@@ -1,5 +1,5 @@
1
- import { a2 as WriteResult, a1 as SifaApiConfig, a0 as ApiFetchOptions, a3 as CreateResult, K as SiteActivityPreset, b as ActivityLabel, u as RepoDeleteResult, x as RepoInventory } from './types-B9nkqX3O.js';
2
- import { p as ExternalAccount, z as PositionViewerConfirmation } from './index-5T1grOo4.js';
1
+ import { a2 as WriteResult, a1 as SifaApiConfig, a0 as ApiFetchOptions, a3 as CreateResult, K as SiteActivityPreset, b as ActivityLabel, u as RepoDeleteResult, x as RepoInventory } from './types-B0zZiWDH.js';
2
+ import { p as ExternalAccount, B as PositionViewerConfirmation } from './index-DDh2RLvx.js';
3
3
  import { a as AccountVerification } from './verification-providers-DeyGqaoC.js';
4
4
  import { s as FollowProfileItem, p as FeatureAllowlistEntry, r as FeatureFlag } from './follow-profile-CVcA2w1v.js';
5
5
  import { z } from 'zod';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@singi-labs/sifa-sdk",
3
- "version": "0.19.99",
3
+ "version": "0.19.101",
4
4
  "description": "Sifa SDK — public client library for the Sifa AppView on AT Protocol. Shared by sifa-web and sifa-app.",
5
5
  "license": "MIT",
6
6
  "type": "module",