@singi-labs/sifa-sdk 0.11.23 → 0.11.24

package/dist/{adult-content-DLMF0jAx.d.cts → adult-content-BaQjQsbN.d.cts}

@@ -47,6 +47,13 @@ interface ProfilePosition {
 interface ProfileEducation {
     rkey: string;
     institution: string;
+    /**
+     * Portable org entity identifier (Wikidata/ROR/LEI URI) written when the user
+     * links the institution to a resolved organization (#159/#241). Absent for
+     * free-text entries. Mirrors `ProfilePosition.entityRef`; the AppView sends it
+     * for display (the "Linked" badge).
+     */
+    entityRef?: string;
     degree?: string;
     fieldOfStudy?: string;
     description?: string;
@@ -100,6 +107,12 @@ interface ProfileCertification {
     rkey: string;
     name: string;
     issuingOrg: string;
+    /**
+     * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the issuing
+     * organization to a resolved entity (#159/#241). Absent for free-text entries.
+     * Mirrors `ProfilePosition.entityRef`; the AppView sends it for display.
+     */
+    entityRef?: string;
     issueDate?: string;
     expiryDate?: string;
     credentialUrl?: string;
@@ -160,6 +173,12 @@ interface ProfilePublication {
 interface ProfileVolunteering {
     rkey: string;
     organization: string;
+    /**
+     * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the
+     * organization to a resolved entity (#159/#241). Absent for free-text entries.
+     * Mirrors `ProfilePosition.entityRef`; the AppView sends it for display.
+     */
+    entityRef?: string;
     role?: string;
     cause?: string;
     startDate?: string;
@@ -171,6 +190,12 @@ interface ProfileHonor {
     rkey: string;
     title: string;
     issuer?: string;
+    /**
+     * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the issuer to a
+     * resolved entity (#159/#241). Absent for free-text entries. Mirrors
+     * `ProfilePosition.entityRef`; the AppView sends it for display.
+     */
+    entityRef?: string;
     date?: string;
     description?: string;
     hidden?: boolean;
@@ -232,6 +257,12 @@ interface ProfileCourse {
     rkey: string;
     name: string;
     institution?: string;
+    /**
+     * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the institution
+     * to a resolved entity (#159/#241). Absent for free-text entries. Mirrors
+     * `ProfilePosition.entityRef`; the AppView sends it for display.
+     */
+    entityRef?: string;
     number?: string;
     /** rkey of the associated certification, resolved from the course's
      * `credential` at-uri. Used to join the course to a certification in the

package/dist/{adult-content-DLMF0jAx.d.ts → adult-content-BaQjQsbN.d.ts}

@@ -47,6 +47,13 @@ interface ProfilePosition {
 interface ProfileEducation {
     rkey: string;
     institution: string;
+    /**
+     * Portable org entity identifier (Wikidata/ROR/LEI URI) written when the user
+     * links the institution to a resolved organization (#159/#241). Absent for
+     * free-text entries. Mirrors `ProfilePosition.entityRef`; the AppView sends it
+     * for display (the "Linked" badge).
+     */
+    entityRef?: string;
     degree?: string;
     fieldOfStudy?: string;
     description?: string;
@@ -100,6 +107,12 @@ interface ProfileCertification {
     rkey: string;
     name: string;
     issuingOrg: string;
+    /**
+     * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the issuing
+     * organization to a resolved entity (#159/#241). Absent for free-text entries.
+     * Mirrors `ProfilePosition.entityRef`; the AppView sends it for display.
+     */
+    entityRef?: string;
     issueDate?: string;
     expiryDate?: string;
     credentialUrl?: string;
@@ -160,6 +173,12 @@ interface ProfilePublication {
 interface ProfileVolunteering {
     rkey: string;
     organization: string;
+    /**
+     * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the
+     * organization to a resolved entity (#159/#241). Absent for free-text entries.
+     * Mirrors `ProfilePosition.entityRef`; the AppView sends it for display.
+     */
+    entityRef?: string;
     role?: string;
     cause?: string;
     startDate?: string;
@@ -171,6 +190,12 @@ interface ProfileHonor {
     rkey: string;
     title: string;
     issuer?: string;
+    /**
+     * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the issuer to a
+     * resolved entity (#159/#241). Absent for free-text entries. Mirrors
+     * `ProfilePosition.entityRef`; the AppView sends it for display.
+     */
+    entityRef?: string;
     date?: string;
     description?: string;
     hidden?: boolean;
@@ -232,6 +257,12 @@ interface ProfileCourse {
     rkey: string;
     name: string;
     institution?: string;
+    /**
+     * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the institution
+     * to a resolved entity (#159/#241). Absent for free-text entries. Mirrors
+     * `ProfilePosition.entityRef`; the AppView sends it for display.
+     */
+    entityRef?: string;
     number?: string;
     /** rkey of the associated certification, resolved from the course's
      * `credential` at-uri. Used to join the course to a certification in the

package/dist/{feed-DMWCGvKv.d.cts → feed--omSiO_S.d.cts}

@@ -96,6 +96,79 @@ declare const EntityImportSearchResponseSchema: z.ZodObject<{
     }, z.core.$strip>], "source">>;
 }, z.core.$strip>;
 type EntityImportSearchResponse = z.infer<typeof EntityImportSearchResponseSchema>;
+/**
+ * Body of the domain grow-on-demand endpoints (`POST /api/entities/resolve-domain`
+ * and `POST /api/entities/mint-domain`). The server re-validates the value as a
+ * registrable domain; 253 is the max DNS name length.
+ */
+declare const EntityResolveDomainRequestSchema: z.ZodObject<{
+    domain: z.ZodString;
+}, z.core.$strip>;
+type EntityResolveDomainRequest = z.infer<typeof EntityResolveDomainRequestSchema>;
+/**
+ * Response of `POST /api/entities/resolve-domain` (grow-on-demand Branch 1). Any
+ * notable companies whose official website is the domain, imported from Wikidata.
+ * `canMint` is true when nothing notable matched AND the domain is eligible for
+ * the user-initiated mint-from-domain path -- it drives the "Add <domain>"
+ * affordance.
+ */
+declare const EntityResolveDomainResponseSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodString;
+        name: z.ZodString;
+        domain: z.ZodNullable<z.ZodString>;
+        country: z.ZodNullable<z.ZodString>;
+        logoUrl: z.ZodNullable<z.ZodString>;
+        parentName: z.ZodNullable<z.ZodString>;
+        source: z.ZodLiteral<"entity">;
+        entityId: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodString;
+        name: z.ZodString;
+        domain: z.ZodNullable<z.ZodString>;
+        country: z.ZodNullable<z.ZodString>;
+        logoUrl: z.ZodNullable<z.ZodString>;
+        parentName: z.ZodNullable<z.ZodString>;
+        source: z.ZodLiteral<"pdl">;
+        pdlId: z.ZodString;
+    }, z.core.$strip>], "source">>;
+    canMint: z.ZodBoolean;
+}, z.core.$strip>;
+type EntityResolveDomainResponse = z.infer<typeof EntityResolveDomainResponseSchema>;
+/**
+ * Response of `POST /api/entities/mint-domain` (grow-on-demand Branch 2). The
+ * linkable entity minted from (or already resolved for) the domain. A non-2xx
+ * status (e.g. the domain is not mintable, a confusable look-alike, or the site
+ * yielded nothing usable) surfaces as a thrown error, not a null result.
+ *
+ * `pending` is true when the entity is a fresh hidden-pending mint: the
+ * requesting user's own link resolves to it immediately, but it stays out of
+ * other users' typeahead + aggregation until an admin approves it. Clients should
+ * reflect this ("added -- pending review") rather than "added & live".
+ */
+declare const EntityMintDomainResponseSchema: z.ZodObject<{
+    result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodString;
+        name: z.ZodString;
+        domain: z.ZodNullable<z.ZodString>;
+        country: z.ZodNullable<z.ZodString>;
+        logoUrl: z.ZodNullable<z.ZodString>;
+        parentName: z.ZodNullable<z.ZodString>;
+        source: z.ZodLiteral<"entity">;
+        entityId: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodString;
+        name: z.ZodString;
+        domain: z.ZodNullable<z.ZodString>;
+        country: z.ZodNullable<z.ZodString>;
+        logoUrl: z.ZodNullable<z.ZodString>;
+        parentName: z.ZodNullable<z.ZodString>;
+        source: z.ZodLiteral<"pdl">;
+        pdlId: z.ZodString;
+    }, z.core.$strip>], "source">;
+    pending: z.ZodBoolean;
+}, z.core.$strip>;
+type EntityMintDomainResponse = z.infer<typeof EntityMintDomainResponseSchema>;
 
 /**
  * Profile row shared across `/api/following`, `/api/profile/:handleOrDid/mutuals`,
@@ -348,4 +421,4 @@ interface FeedCursor {
 declare function encodeFeedCursor(cursor: FeedCursor): string;
 declare function decodeFeedCursor(encoded: string): FeedCursor;
 
-export { type AtmosphereFeedItem as A, encodeFeedCursor as B, type EntityImportSearchResponse as E, FEATURE_FLAGS as F, type SifaFeedItem as S, AtmosphereFeedItemSchema as a, EntityImportSearchResponseSchema as b, type EntitySearchResponse as c, EntitySearchResponseSchema as d, type EntitySearchResult as e, EntitySearchResultSchema as f, type EntitySelectRequest as g, EntitySelectRequestSchema as h, type EntitySelectResponse as i, EntitySelectResponseSchema as j, type FeatureAllowlistEntry as k, FeatureAllowlistEntrySchema as l, type FeatureFlag as m, type FeedActor as n, FeedActorSchema as o, type FeedCursor as p, type FollowFeedItem as q, FollowFeedItemSchema as r, type FollowFeedPage as s, FollowFeedPageSchema as t, type FollowProfileItem as u, type FollowProfilePage as v, FollowProfilePageSchema as w, FollowProfileSchema as x, SifaFeedItemSchema as y, decodeFeedCursor as z };
+export { type AtmosphereFeedItem as A, type FollowProfileItem as B, type FollowProfilePage as C, FollowProfilePageSchema as D, type EntityImportSearchResponse as E, FEATURE_FLAGS as F, FollowProfileSchema as G, SifaFeedItemSchema as H, decodeFeedCursor as I, encodeFeedCursor as J, type SifaFeedItem as S, AtmosphereFeedItemSchema as a, EntityImportSearchResponseSchema as b, type EntityMintDomainResponse as c, EntityMintDomainResponseSchema as d, type EntityResolveDomainRequest as e, EntityResolveDomainRequestSchema as f, type EntityResolveDomainResponse as g, EntityResolveDomainResponseSchema as h, type EntitySearchResponse as i, EntitySearchResponseSchema as j, type EntitySearchResult as k, EntitySearchResultSchema as l, type EntitySelectRequest as m, EntitySelectRequestSchema as n, type EntitySelectResponse as o, EntitySelectResponseSchema as p, type FeatureAllowlistEntry as q, FeatureAllowlistEntrySchema as r, type FeatureFlag as s, type FeedActor as t, FeedActorSchema as u, type FeedCursor as v, type FollowFeedItem as w, FollowFeedItemSchema as x, type FollowFeedPage as y, FollowFeedPageSchema as z };

package/dist/{feed-DMWCGvKv.d.ts → feed--omSiO_S.d.ts}

@@ -96,6 +96,79 @@ declare const EntityImportSearchResponseSchema: z.ZodObject<{
     }, z.core.$strip>], "source">>;
 }, z.core.$strip>;
 type EntityImportSearchResponse = z.infer<typeof EntityImportSearchResponseSchema>;
+/**
+ * Body of the domain grow-on-demand endpoints (`POST /api/entities/resolve-domain`
+ * and `POST /api/entities/mint-domain`). The server re-validates the value as a
+ * registrable domain; 253 is the max DNS name length.
+ */
+declare const EntityResolveDomainRequestSchema: z.ZodObject<{
+    domain: z.ZodString;
+}, z.core.$strip>;
+type EntityResolveDomainRequest = z.infer<typeof EntityResolveDomainRequestSchema>;
+/**
+ * Response of `POST /api/entities/resolve-domain` (grow-on-demand Branch 1). Any
+ * notable companies whose official website is the domain, imported from Wikidata.
+ * `canMint` is true when nothing notable matched AND the domain is eligible for
+ * the user-initiated mint-from-domain path -- it drives the "Add <domain>"
+ * affordance.
+ */
+declare const EntityResolveDomainResponseSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodString;
+        name: z.ZodString;
+        domain: z.ZodNullable<z.ZodString>;
+        country: z.ZodNullable<z.ZodString>;
+        logoUrl: z.ZodNullable<z.ZodString>;
+        parentName: z.ZodNullable<z.ZodString>;
+        source: z.ZodLiteral<"entity">;
+        entityId: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodString;
+        name: z.ZodString;
+        domain: z.ZodNullable<z.ZodString>;
+        country: z.ZodNullable<z.ZodString>;
+        logoUrl: z.ZodNullable<z.ZodString>;
+        parentName: z.ZodNullable<z.ZodString>;
+        source: z.ZodLiteral<"pdl">;
+        pdlId: z.ZodString;
+    }, z.core.$strip>], "source">>;
+    canMint: z.ZodBoolean;
+}, z.core.$strip>;
+type EntityResolveDomainResponse = z.infer<typeof EntityResolveDomainResponseSchema>;
+/**
+ * Response of `POST /api/entities/mint-domain` (grow-on-demand Branch 2). The
+ * linkable entity minted from (or already resolved for) the domain. A non-2xx
+ * status (e.g. the domain is not mintable, a confusable look-alike, or the site
+ * yielded nothing usable) surfaces as a thrown error, not a null result.
+ *
+ * `pending` is true when the entity is a fresh hidden-pending mint: the
+ * requesting user's own link resolves to it immediately, but it stays out of
+ * other users' typeahead + aggregation until an admin approves it. Clients should
+ * reflect this ("added -- pending review") rather than "added & live".
+ */
+declare const EntityMintDomainResponseSchema: z.ZodObject<{
+    result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodString;
+        name: z.ZodString;
+        domain: z.ZodNullable<z.ZodString>;
+        country: z.ZodNullable<z.ZodString>;
+        logoUrl: z.ZodNullable<z.ZodString>;
+        parentName: z.ZodNullable<z.ZodString>;
+        source: z.ZodLiteral<"entity">;
+        entityId: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodString;
+        name: z.ZodString;
+        domain: z.ZodNullable<z.ZodString>;
+        country: z.ZodNullable<z.ZodString>;
+        logoUrl: z.ZodNullable<z.ZodString>;
+        parentName: z.ZodNullable<z.ZodString>;
+        source: z.ZodLiteral<"pdl">;
+        pdlId: z.ZodString;
+    }, z.core.$strip>], "source">;
+    pending: z.ZodBoolean;
+}, z.core.$strip>;
+type EntityMintDomainResponse = z.infer<typeof EntityMintDomainResponseSchema>;
 
 /**
  * Profile row shared across `/api/following`, `/api/profile/:handleOrDid/mutuals`,
@@ -348,4 +421,4 @@ interface FeedCursor {
 declare function encodeFeedCursor(cursor: FeedCursor): string;
 declare function decodeFeedCursor(encoded: string): FeedCursor;
 
-export { type AtmosphereFeedItem as A, encodeFeedCursor as B, type EntityImportSearchResponse as E, FEATURE_FLAGS as F, type SifaFeedItem as S, AtmosphereFeedItemSchema as a, EntityImportSearchResponseSchema as b, type EntitySearchResponse as c, EntitySearchResponseSchema as d, type EntitySearchResult as e, EntitySearchResultSchema as f, type EntitySelectRequest as g, EntitySelectRequestSchema as h, type EntitySelectResponse as i, EntitySelectResponseSchema as j, type FeatureAllowlistEntry as k, FeatureAllowlistEntrySchema as l, type FeatureFlag as m, type FeedActor as n, FeedActorSchema as o, type FeedCursor as p, type FollowFeedItem as q, FollowFeedItemSchema as r, type FollowFeedPage as s, FollowFeedPageSchema as t, type FollowProfileItem as u, type FollowProfilePage as v, FollowProfilePageSchema as w, FollowProfileSchema as x, SifaFeedItemSchema as y, decodeFeedCursor as z };
+export { type AtmosphereFeedItem as A, type FollowProfileItem as B, type FollowProfilePage as C, FollowProfilePageSchema as D, type EntityImportSearchResponse as E, FEATURE_FLAGS as F, FollowProfileSchema as G, SifaFeedItemSchema as H, decodeFeedCursor as I, encodeFeedCursor as J, type SifaFeedItem as S, AtmosphereFeedItemSchema as a, EntityImportSearchResponseSchema as b, type EntityMintDomainResponse as c, EntityMintDomainResponseSchema as d, type EntityResolveDomainRequest as e, EntityResolveDomainRequestSchema as f, type EntityResolveDomainResponse as g, EntityResolveDomainResponseSchema as h, type EntitySearchResponse as i, EntitySearchResponseSchema as j, type EntitySearchResult as k, EntitySearchResultSchema as l, type EntitySelectRequest as m, EntitySelectRequestSchema as n, type EntitySelectResponse as o, EntitySelectResponseSchema as p, type FeatureAllowlistEntry as q, FeatureAllowlistEntrySchema as r, type FeatureFlag as s, type FeedActor as t, FeedActorSchema as u, type FeedCursor as v, type FollowFeedItem as w, FollowFeedItemSchema as x, type FollowFeedPage as y, FollowFeedPageSchema as z };

package/dist/index-BV2QGy4u.d.ts

@@ -0,0 +1,261 @@
+import { S as SifaApiConfig, A as ApiFetchOptions, j as CreateResult, W as WriteResult } from './keys-Czq74eql.js';
+import { d as Profile, t as ProfilePosition, z as SkillRef } from './adult-content-BaQjQsbN.js';
+import { i as EntitySearchResponse, k as EntitySearchResult, c as EntityMintDomainResponse, g as EntityResolveDomainResponse, m as EntitySelectRequest, o as EntitySelectResponse } from './feed--omSiO_S.js';
+
+/**
+ * Read the aggregated profile for a handle or DID.
+ *
+ * Returns `null` when the AppView has no profile for the given identifier
+ * (HTTP 404). Throws {@link ApiError} on other non-2xx responses.
+ *
+ * Server-callable (Next.js RSC) and client-callable (Expo, browser).
+ */
+declare function fetchProfile(config: SifaApiConfig, handleOrDid: string, options?: ApiFetchOptions): Promise<Profile | null>;
+/**
+ * Public AT Fund link for a profile, if one is configured. Returns `null`
+ * on any error or when the response payload's `url` field is missing or
+ * non-string.
+ */
+declare function fetchAtFundLink(config: SifaApiConfig, did: string, options?: ApiFetchOptions): Promise<string | null>;
+
+/**
+ * Create a new `id.sifa.profile.position` record on the authenticated
+ * user's PDS. The AppView signs and writes via the user's OAuth session.
+ *
+ * `data` should be a lexicon-shaped position record (without `createdAt`
+ * or `rkey`; the AppView fills both). Validate with
+ * `ProfilePositionRecordSchema.omit({ createdAt: true })` before calling
+ * if you want client-side guarantees.
+ *
+ * Never throws -- inspect `result.success` and use `result.error` /
+ * `result.pdsHost` for UI messaging.
+ */
+declare function createPosition(config: SifaApiConfig, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<CreateResult>;
+/** Update an existing position by `rkey`. */
+declare function updatePosition(config: SifaApiConfig, rkey: string, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Delete a position by `rkey`. */
+declare function deletePosition(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Mark a position as the user's primary (current) role. */
+declare function setPositionPrimary(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Clear the "primary" flag on a position. */
+declare function unsetPositionPrimary(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/**
+ * Add a skill link to a position. Idempotent: if the skill is already
+ * linked, resolves to `{ success: true }` without a network call.
+ *
+ * Implementation note: the AppView only exposes whole-record PUTs, so
+ * this helper rebuilds the position body with the new skills list.
+ */
+declare function linkSkillToPosition(config: SifaApiConfig, position: ProfilePosition, skillRef: SkillRef, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Remove a skill link from a position. */
+declare function unlinkSkillFromPosition(config: SifaApiConfig, position: ProfilePosition, skillRef: SkillRef, options?: ApiFetchOptions): Promise<WriteResult>;
+
+/**
+ * Create a new `id.sifa.profile.education` record on the authenticated
+ * user's PDS.
+ */
+declare function createEducation(config: SifaApiConfig, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<CreateResult>;
+/** Update an existing education record by `rkey`. */
+declare function updateEducation(config: SifaApiConfig, rkey: string, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Delete an education record by `rkey`. */
+declare function deleteEducation(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+
+/**
+ * Create a new `id.sifa.profile.skill` record on the authenticated
+ * user's PDS.
+ */
+declare function createSkill(config: SifaApiConfig, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<CreateResult>;
+/** Update an existing skill record by `rkey`. */
+declare function updateSkill(config: SifaApiConfig, rkey: string, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Delete a skill record by `rkey`. */
+declare function deleteSkill(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+
+/**
+ * Generic record-create escape hatch. Most callers should prefer the
+ * dedicated section helpers (`createPosition`, `createEducation`, etc.)
+ * which take typed payloads and ship matching hooks. Use this when the
+ * lexicon doesn't yet have a dedicated endpoint (certifications,
+ * projects, publications, volunteering, honors, languages, courses).
+ *
+ * `collection` is a `id.sifa.profile.*` collection NSID. Routes to
+ * `POST /api/profile/records/<collection>`.
+ */
+declare function createRecord(config: SifaApiConfig, collection: string, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<CreateResult>;
+/** Generic record-update escape hatch. See {@link createRecord}. */
+declare function updateRecord(config: SifaApiConfig, collection: string, rkey: string, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Generic record-delete escape hatch. See {@link createRecord}. */
+declare function deleteRecord(config: SifaApiConfig, collection: string, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+
+/**
+ * Hide a keytrace claim (verified-account claim discovered on the
+ * user's external accounts) from the user's profile. The claim itself
+ * stays in the index; only its display is suppressed.
+ */
+declare function hideKeytraceClaim(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Restore a previously-hidden keytrace claim. */
+declare function unhideKeytraceClaim(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+
+/**
+ * Make a Marque-registered domain public in the owner's Links section. Marque
+ * domains are owner-only by default; this reveals one. `domain` is the
+ * at.marque.domain rkey (the domain name itself).
+ */
+declare function revealMarqueDomain(config: SifaApiConfig, domain: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Make a previously-revealed Marque domain owner-only again. */
+declare function unrevealMarqueDomain(config: SifaApiConfig, domain: string, options?: ApiFetchOptions): Promise<WriteResult>;
+
+/**
+ * Organization typeahead. Returns curated entities first, then the PDL crawl,
+ * deduped by domain. Empty input returns an empty result without a network call.
+ */
+declare function fetchEntitySearch(config: SifaApiConfig, query: string, limit?: number, options?: ApiFetchOptions): Promise<EntitySearchResponse>;
+/**
+ * Record a selection: promote a PDL row into a canonical entity (dedupe by
+ * domain) or bump an existing entity's usage counter. Returns the entity plus
+ * its portable `entityRef` (null for PDL-only entities). Requires a session.
+ */
+declare function selectEntity(config: SifaApiConfig, body: EntitySelectRequest, options?: ApiFetchOptions): Promise<EntitySelectResponse>;
+/**
+ * Grow-on-demand: when the local typeahead misses, resolve the query live via
+ * Wikidata, import the org-class matches, and return them. Requires a session.
+ * Empty input returns an empty array without a network call.
+ */
+declare function importSearchEntities(config: SifaApiConfig, query: string, options?: ApiFetchOptions): Promise<EntitySearchResult[]>;
+/**
+ * Grow-on-demand by domain, Branch 1: when a domain-shaped typeahead query
+ * misses locally, resolve any notable company whose official website is that
+ * domain (Wikidata reverse P856), importing the matches. Read-only w.r.t.
+ * minting. `canMint` tells the caller whether to offer the user-initiated
+ * "Add <domain>" affordance. Requires a session.
+ */
+declare function resolveEntityDomain(config: SifaApiConfig, domain: string, options?: ApiFetchOptions): Promise<EntityResolveDomainResponse>;
+/**
+ * Grow-on-demand by domain, Branch 2 (user-initiated): mint a crawled-tier
+ * entity from the domain's own homepage (or resolve it to a notable company if
+ * one exists). Throws on a non-2xx response (domain not mintable, or the site
+ * yielded nothing usable). Requires a session.
+ */
+declare function mintEntityDomain(config: SifaApiConfig, domain: string, options?: ApiFetchOptions): Promise<EntityMintDomainResponse>;
+
+/**
+ * Counts confirmed endorsements received by a DID. The backend's
+ * `GET /api/endorsement/:did` already returns only confirmed endorsements
+ * (via inner join with `endorsementConfirmations`), so this helper just
+ * returns the array length. Failures return 0 so callers can route safely.
+ *
+ * Public endpoint -- no credentials needed.
+ */
+declare function fetchEndorsementCount(config: SifaApiConfig, did: string, options?: ApiFetchOptions): Promise<number>;
+
+interface FetchNetworkStreamCountOptions extends ApiFetchOptions {
+    /**
+     * Pass the caller's `Cookie` header on Next.js RSC server-side calls.
+     * Required for authenticated server fetches because `credentials: 'include'`
+     * does not propagate browser cookies in RSC.
+     *
+     * When omitted, the request falls back to `credentials: 'include'` so
+     * client-side calls work without extra plumbing.
+     */
+    cookieHeader?: string;
+}
+/**
+ * Counts items in the authenticated user's network stream digest. The
+ * underlying `GET /api/stream/network` endpoint may 404 while the feature
+ * is in development; in that case (and on any other error) this returns
+ * 0 so callers can route safely to a fallback experience.
+ */
+declare function fetchNetworkStreamCount(config: SifaApiConfig, did: string, options?: FetchNetworkStreamCountOptions): Promise<number>;
+
+/** A node in the personal network graph. */
+interface NetworkMapNode {
+    did: string;
+    handle: string;
+    displayName: string;
+    avatar: string | null;
+    /** Number of edges this node participates in within the rendered graph. */
+    degree: number;
+    /** Phase 2: community detection cluster id. */
+    cluster?: number;
+    /** Phase 2: pre-computed layout coordinates. */
+    x?: number;
+    y?: number;
+}
+/** A directed edge in the personal network graph. */
+interface NetworkMapEdge {
+    source: string;
+    target: string;
+    mutual: boolean;
+    /** Networks this edge was observed in, e.g. `['sifa', 'bluesky']`. */
+    sources: string[];
+}
+/** The graph payload itself, decoupled from response metadata. */
+interface NetworkMapGraphData {
+    nodes: NetworkMapNode[];
+    edges: NetworkMapEdge[];
+    /** Phase 2: cluster metadata for legend rendering. */
+    clusters?: Array<{
+        id: number;
+        label: string;
+        color: string;
+    }>;
+}
+/** Cached graph response. */
+interface NetworkMapResponse {
+    generatedAt: string;
+    expiresAt: string;
+    graph: NetworkMapGraphData;
+    stats: {
+        totalNodes: number;
+        totalEdges: number;
+        mutualCount: number;
+        sources: Record<string, number>;
+    };
+}
+/** Async job tracking generation progress. */
+interface NetworkMapGenerationJob {
+    jobId: string;
+    did: string;
+    status: 'pending' | 'complete' | 'failed';
+    /** 0..100 */
+    progress: number;
+    createdAt: string;
+    completedAt?: string;
+    error?: string;
+    /**
+     * Queue position when the job is still pending and not yet picked up
+     * by the worker. 0 = next to run. Absent for in-flight or terminal
+     * jobs (and for any backend that doesn't yet report position).
+     */
+    position?: number;
+    /**
+     * Estimated remaining seconds, derived server-side from the median
+     * historical duration for the user's follow-count bucket multiplied
+     * by `position + 1`. Absent when no historical data exists yet.
+     */
+    etaSeconds?: number;
+}
+/** Returned by `initiateNetworkMapGeneration` when a new job was started or one was already running. */
+interface NetworkMapPendingJob {
+    jobId: string;
+    status: 'pending' | 'cached';
+}
+/** Discriminate the union returned by `initiateNetworkMapGeneration`. */
+declare function isNetworkMapResponse(value: NetworkMapPendingJob | NetworkMapResponse): value is NetworkMapResponse;
+/**
+ * Kick off a personal network-map computation. The backend returns the
+ * cached map immediately when fresh, otherwise it returns a job id that
+ * the caller polls via `checkNetworkMapJobStatus`.
+ */
+declare function initiateNetworkMapGeneration(config: SifaApiConfig, options?: ApiFetchOptions): Promise<NetworkMapPendingJob | NetworkMapResponse>;
+/**
+ * Poll the status of an in-flight generation job. Throws on 404 (unknown
+ * or expired job) — callers may want to treat that as terminal failure.
+ */
+declare function checkNetworkMapJobStatus(config: SifaApiConfig, jobId: string, options?: ApiFetchOptions): Promise<NetworkMapGenerationJob>;
+/**
+ * Fetch the most recent cached network map for the authenticated user.
+ * Returns `null` when no map has ever been generated (404).
+ */
+declare function fetchNetworkMap(config: SifaApiConfig, options?: ApiFetchOptions): Promise<NetworkMapResponse | null>;
+
+export { resolveEntityDomain as A, revealMarqueDomain as B, selectEntity as C, setPositionPrimary as D, unhideKeytraceClaim as E, type FetchNetworkStreamCountOptions as F, unlinkSkillFromPosition as G, unrevealMarqueDomain as H, unsetPositionPrimary as I, updateEducation as J, updatePosition as K, updateRecord as L, updateSkill as M, type NetworkMapEdge as N, type NetworkMapGenerationJob as a, type NetworkMapGraphData as b, type NetworkMapNode as c, type NetworkMapPendingJob as d, type NetworkMapResponse as e, checkNetworkMapJobStatus as f, createEducation as g, createPosition as h, createRecord as i, createSkill as j, deleteEducation as k, deletePosition as l, deleteRecord as m, deleteSkill as n, fetchAtFundLink as o, fetchEndorsementCount as p, fetchEntitySearch as q, fetchNetworkMap as r, fetchNetworkStreamCount as s, fetchProfile as t, hideKeytraceClaim as u, importSearchEntities as v, initiateNetworkMapGeneration as w, isNetworkMapResponse as x, linkSkillToPosition as y, mintEntityDomain as z };