@singi-labs/sifa-sdk 0.12.92 → 0.13.0

package/dist/{network-map-C3KyOHRU.d.ts → network-map-CC9Dito-.d.ts}

@@ -1,4 +1,4 @@
-import { c as Profile, d as ProfilePosition, S as SkillRef } from './index-jNyd5QP7.js';
+import { c as Profile, d as ProfilePosition, S as SkillRef, w as PresentationLinkView } from './index-jNyd5QP7.js';
 import { S as SifaApiConfig, A as ApiFetchOptions, C as CreateResult, W as WriteResult } from './org-zMZg_r7v.js';
 import { n as ProfileView } from './types-8JaS6abh.js';
 import { S as SummarizeProfileViewOptions, P as ProfileSummary } from './profile-summary-8fapqzHv.js';
@@ -237,6 +237,98 @@ declare function revealMarqueDomain(config: SifaApiConfig, domain: string, optio
 /** Make a previously-revealed Marque domain owner-only again. */
 declare function unrevealMarqueDomain(config: SifaApiConfig, domain: string, options?: ApiFetchOptions): Promise<WriteResult>;
 
+/**
+ * Which claim a listed speaker makes about a topic. Phase 1 has no confirmed
+ * data, so groups are named by the CLAIM, never a "proven" label:
+ *   - `spoke_about_it` — has a topic-matching delivery (or, with a topic set,
+ *     a matching presentation plus at least one delivery)
+ *   - `skilled` — holds the matching canonical skill but has no matching talk
+ *     (only appears when a topic is supplied)
+ *   - `open_to_speaking` — opted in but has never delivered (only appears when
+ *     no topic is supplied)
+ */
+type SpeakerGroup = 'spoke_about_it' | 'skilled' | 'open_to_speaking';
+/** One person in the speaker directory. Everyone listed has opted in. */
+interface SpeakerCard {
+    did: string;
+    handle: string;
+    displayName: string | null;
+    avatar: string | null;
+    headline: string | null;
+    currentRole: string | null;
+    currentCompany: string | null;
+    deliveryCount: number;
+    group: SpeakerGroup;
+    matchedTopics: string[];
+    /**
+     * Self-reported event names from the speaker's own presentationDelivery
+     * records — unconfirmed in Phase 1. `eventsSelfReported` is always true;
+     * the web layer labels these as such.
+     */
+    recentEvents: string[];
+    eventsSelfReported: boolean;
+}
+interface SpeakersResponse {
+    speakers: SpeakerCard[];
+}
+/** The reusable talk, or a standalone delivery when it has no parent talk. */
+interface TalkEvent {
+    eventName: string | null;
+    date: string | null;
+}
+/** Compact speaker card embedded in a talk row. */
+interface TalkSpeaker {
+    did: string;
+    handle: string;
+    displayName: string | null;
+    avatar: string | null;
+    headline: string | null;
+    currentRole: string | null;
+    currentCompany: string | null;
+}
+interface TalkRow {
+    /**
+     * `presentation` = a reusable `id.sifa.profile.presentation` record.
+     * `delivery` = a standalone presentationDelivery with no parent presentation.
+     */
+    kind: 'presentation' | 'delivery';
+    rkey: string;
+    title: string | null;
+    snippet: string | null;
+    links: PresentationLinkView[];
+    writeupUri: string | null;
+    speaker: TalkSpeaker;
+    events: TalkEvent[];
+    eventsSelfReported: boolean;
+    deliveryCount: number;
+    matchedTopics: string[];
+}
+interface TalksResponse {
+    talks: TalkRow[];
+}
+interface SpeakerDirectoryFilters {
+    /** Free-text topic (canonical skill name/slug/alias, talk title, or event). */
+    topic?: string;
+    /** Max rows to return; the API caps this at 50. */
+    limit?: number;
+}
+/**
+ * Speaker directory (Phase 1, read-only POC). Everyone returned has opted in to
+ * speaking; past deliveries are a ranking signal, not an inclusion path. An
+ * optional `topic` filters to people who hold the matching canonical skill,
+ * have a matching presentation, or have a matching delivery. Results come
+ * grouped and ordered by the API.
+ *
+ * Returns an empty list on any error so callers can render a graceful state.
+ */
+declare function fetchSpeakers(config: SifaApiConfig, filters?: SpeakerDirectoryFilters, options?: ApiFetchOptions): Promise<SpeakersResponse>;
+/**
+ * Talk directory (Phase 1, read-only POC). Lists talks by opted-in speakers,
+ * delivered-first, then latest delivery date. Same optional `topic` filter as
+ * {@link fetchSpeakers}. Returns an empty list on any error.
+ */
+declare function fetchTalks(config: SifaApiConfig, filters?: SpeakerDirectoryFilters, options?: ApiFetchOptions): Promise<TalksResponse>;
+
 /**
  * Organization typeahead. Returns curated entities first, then the PDL crawl,
  * deduped by domain. Empty input returns an empty result without a network call.
@@ -391,4 +483,4 @@ declare function checkNetworkMapJobStatus(config: SifaApiConfig, jobId: string,
  */
 declare function fetchNetworkMap(config: SifaApiConfig, options?: ApiFetchOptions): Promise<NetworkMapResponse | null>;
 
-export { fetchReceivedEndorsements as A, fetchReciprocityCandidate as B, hideKeytraceClaim as C, type DismissEndorsementInput as D, importSearchEntities as E, type FetchNetworkStreamCountOptions as F, initiateNetworkMapGeneration as G, isNetworkMapResponse as H, linkSkillToPosition as I, mintEntityDomain as J, resolveEntityDomain as K, revealMarqueDomain as L, selectEntity as M, type NetworkMapEdge as N, setPositionPrimary as O, type PendingEndorsementsPage as P, unhideKeytraceClaim as Q, type ReceivedEndorsementsPage as R, unlinkSkillFromPosition as S, unrevealMarqueDomain as T, unsetPositionPrimary as U, updateEducation as V, updatePosition as W, updateRecord as X, type ReciprocityCandidate as a, type NetworkMapGenerationJob as b, type NetworkMapGraphData as c, type NetworkMapNode as d, type NetworkMapPendingJob as e, type NetworkMapResponse as f, type PendingEndorsement as g, type ReceivedEndorsement as h, type ReciprocitySkill as i, checkNetworkMapJobStatus as j, createEducation as k, createPosition as l, createRecord as m, deleteEducation as n, deletePosition as o, deleteRecord as p, dismissEndorsement as q, fetchAtFundLink as r, fetchEndorsementCount as s, fetchEntitySearch as t, fetchGetProfileView as u, fetchNetworkMap as v, fetchNetworkStreamCount as w, fetchPendingEndorsements as x, fetchProfile as y, fetchProfileSummary as z };
+export { unhideKeytraceClaim as $, fetchGetProfileView as A, fetchNetworkMap as B, fetchNetworkStreamCount as C, type DismissEndorsementInput as D, fetchPendingEndorsements as E, type FetchNetworkStreamCountOptions as F, fetchProfile as G, fetchProfileSummary as H, fetchReceivedEndorsements as I, fetchReciprocityCandidate as J, fetchSpeakers as K, fetchTalks as L, hideKeytraceClaim as M, type NetworkMapEdge as N, importSearchEntities as O, type PendingEndorsementsPage as P, initiateNetworkMapGeneration as Q, type ReceivedEndorsementsPage as R, type SpeakerCard as S, type TalkEvent as T, isNetworkMapResponse as U, linkSkillToPosition as V, mintEntityDomain as W, resolveEntityDomain as X, revealMarqueDomain as Y, selectEntity as Z, setPositionPrimary as _, type ReciprocityCandidate as a, unlinkSkillFromPosition as a0, unrevealMarqueDomain as a1, unsetPositionPrimary as a2, updateEducation as a3, updatePosition as a4, updateRecord as a5, type NetworkMapGenerationJob as b, type NetworkMapGraphData as c, type NetworkMapNode as d, type NetworkMapPendingJob as e, type NetworkMapResponse as f, type PendingEndorsement as g, type ReceivedEndorsement as h, type ReciprocitySkill as i, type SpeakerDirectoryFilters as j, type SpeakerGroup as k, type SpeakersResponse as l, type TalkRow as m, type TalkSpeaker as n, type TalksResponse as o, checkNetworkMapJobStatus as p, createEducation as q, createPosition as r, createRecord as s, deleteEducation as t, deletePosition as u, deleteRecord as v, dismissEndorsement as w, fetchAtFundLink as x, fetchEndorsementCount as y, fetchEntitySearch as z };

package/dist/{network-map-BcugllI5.d.cts → network-map-D223f7DM.d.cts}

@@ -1,4 +1,4 @@
-import { c as Profile, d as ProfilePosition, S as SkillRef } from './index-jNyd5QP7.cjs';
+import { c as Profile, d as ProfilePosition, S as SkillRef, w as PresentationLinkView } from './index-jNyd5QP7.cjs';
 import { S as SifaApiConfig, A as ApiFetchOptions, C as CreateResult, W as WriteResult } from './org-DCHb1xhw.cjs';
 import { n as ProfileView } from './types-8wAWvS-T.cjs';
 import { S as SummarizeProfileViewOptions, P as ProfileSummary } from './profile-summary-DY78IoL9.cjs';
@@ -237,6 +237,98 @@ declare function revealMarqueDomain(config: SifaApiConfig, domain: string, optio
 /** Make a previously-revealed Marque domain owner-only again. */
 declare function unrevealMarqueDomain(config: SifaApiConfig, domain: string, options?: ApiFetchOptions): Promise<WriteResult>;
 
+/**
+ * Which claim a listed speaker makes about a topic. Phase 1 has no confirmed
+ * data, so groups are named by the CLAIM, never a "proven" label:
+ *   - `spoke_about_it` — has a topic-matching delivery (or, with a topic set,
+ *     a matching presentation plus at least one delivery)
+ *   - `skilled` — holds the matching canonical skill but has no matching talk
+ *     (only appears when a topic is supplied)
+ *   - `open_to_speaking` — opted in but has never delivered (only appears when
+ *     no topic is supplied)
+ */
+type SpeakerGroup = 'spoke_about_it' | 'skilled' | 'open_to_speaking';
+/** One person in the speaker directory. Everyone listed has opted in. */
+interface SpeakerCard {
+    did: string;
+    handle: string;
+    displayName: string | null;
+    avatar: string | null;
+    headline: string | null;
+    currentRole: string | null;
+    currentCompany: string | null;
+    deliveryCount: number;
+    group: SpeakerGroup;
+    matchedTopics: string[];
+    /**
+     * Self-reported event names from the speaker's own presentationDelivery
+     * records — unconfirmed in Phase 1. `eventsSelfReported` is always true;
+     * the web layer labels these as such.
+     */
+    recentEvents: string[];
+    eventsSelfReported: boolean;
+}
+interface SpeakersResponse {
+    speakers: SpeakerCard[];
+}
+/** The reusable talk, or a standalone delivery when it has no parent talk. */
+interface TalkEvent {
+    eventName: string | null;
+    date: string | null;
+}
+/** Compact speaker card embedded in a talk row. */
+interface TalkSpeaker {
+    did: string;
+    handle: string;
+    displayName: string | null;
+    avatar: string | null;
+    headline: string | null;
+    currentRole: string | null;
+    currentCompany: string | null;
+}
+interface TalkRow {
+    /**
+     * `presentation` = a reusable `id.sifa.profile.presentation` record.
+     * `delivery` = a standalone presentationDelivery with no parent presentation.
+     */
+    kind: 'presentation' | 'delivery';
+    rkey: string;
+    title: string | null;
+    snippet: string | null;
+    links: PresentationLinkView[];
+    writeupUri: string | null;
+    speaker: TalkSpeaker;
+    events: TalkEvent[];
+    eventsSelfReported: boolean;
+    deliveryCount: number;
+    matchedTopics: string[];
+}
+interface TalksResponse {
+    talks: TalkRow[];
+}
+interface SpeakerDirectoryFilters {
+    /** Free-text topic (canonical skill name/slug/alias, talk title, or event). */
+    topic?: string;
+    /** Max rows to return; the API caps this at 50. */
+    limit?: number;
+}
+/**
+ * Speaker directory (Phase 1, read-only POC). Everyone returned has opted in to
+ * speaking; past deliveries are a ranking signal, not an inclusion path. An
+ * optional `topic` filters to people who hold the matching canonical skill,
+ * have a matching presentation, or have a matching delivery. Results come
+ * grouped and ordered by the API.
+ *
+ * Returns an empty list on any error so callers can render a graceful state.
+ */
+declare function fetchSpeakers(config: SifaApiConfig, filters?: SpeakerDirectoryFilters, options?: ApiFetchOptions): Promise<SpeakersResponse>;
+/**
+ * Talk directory (Phase 1, read-only POC). Lists talks by opted-in speakers,
+ * delivered-first, then latest delivery date. Same optional `topic` filter as
+ * {@link fetchSpeakers}. Returns an empty list on any error.
+ */
+declare function fetchTalks(config: SifaApiConfig, filters?: SpeakerDirectoryFilters, options?: ApiFetchOptions): Promise<TalksResponse>;
+
 /**
  * Organization typeahead. Returns curated entities first, then the PDL crawl,
  * deduped by domain. Empty input returns an empty result without a network call.
@@ -391,4 +483,4 @@ declare function checkNetworkMapJobStatus(config: SifaApiConfig, jobId: string,
  */
 declare function fetchNetworkMap(config: SifaApiConfig, options?: ApiFetchOptions): Promise<NetworkMapResponse | null>;
 
-export { fetchReceivedEndorsements as A, fetchReciprocityCandidate as B, hideKeytraceClaim as C, type DismissEndorsementInput as D, importSearchEntities as E, type FetchNetworkStreamCountOptions as F, initiateNetworkMapGeneration as G, isNetworkMapResponse as H, linkSkillToPosition as I, mintEntityDomain as J, resolveEntityDomain as K, revealMarqueDomain as L, selectEntity as M, type NetworkMapEdge as N, setPositionPrimary as O, type PendingEndorsementsPage as P, unhideKeytraceClaim as Q, type ReceivedEndorsementsPage as R, unlinkSkillFromPosition as S, unrevealMarqueDomain as T, unsetPositionPrimary as U, updateEducation as V, updatePosition as W, updateRecord as X, type ReciprocityCandidate as a, type NetworkMapGenerationJob as b, type NetworkMapGraphData as c, type NetworkMapNode as d, type NetworkMapPendingJob as e, type NetworkMapResponse as f, type PendingEndorsement as g, type ReceivedEndorsement as h, type ReciprocitySkill as i, checkNetworkMapJobStatus as j, createEducation as k, createPosition as l, createRecord as m, deleteEducation as n, deletePosition as o, deleteRecord as p, dismissEndorsement as q, fetchAtFundLink as r, fetchEndorsementCount as s, fetchEntitySearch as t, fetchGetProfileView as u, fetchNetworkMap as v, fetchNetworkStreamCount as w, fetchPendingEndorsements as x, fetchProfile as y, fetchProfileSummary as z };
+export { unhideKeytraceClaim as $, fetchGetProfileView as A, fetchNetworkMap as B, fetchNetworkStreamCount as C, type DismissEndorsementInput as D, fetchPendingEndorsements as E, type FetchNetworkStreamCountOptions as F, fetchProfile as G, fetchProfileSummary as H, fetchReceivedEndorsements as I, fetchReciprocityCandidate as J, fetchSpeakers as K, fetchTalks as L, hideKeytraceClaim as M, type NetworkMapEdge as N, importSearchEntities as O, type PendingEndorsementsPage as P, initiateNetworkMapGeneration as Q, type ReceivedEndorsementsPage as R, type SpeakerCard as S, type TalkEvent as T, isNetworkMapResponse as U, linkSkillToPosition as V, mintEntityDomain as W, resolveEntityDomain as X, revealMarqueDomain as Y, selectEntity as Z, setPositionPrimary as _, type ReciprocityCandidate as a, unlinkSkillFromPosition as a0, unrevealMarqueDomain as a1, unsetPositionPrimary as a2, updateEducation as a3, updatePosition as a4, updateRecord as a5, type NetworkMapGenerationJob as b, type NetworkMapGraphData as c, type NetworkMapNode as d, type NetworkMapPendingJob as e, type NetworkMapResponse as f, type PendingEndorsement as g, type ReceivedEndorsement as h, type ReciprocitySkill as i, type SpeakerDirectoryFilters as j, type SpeakerGroup as k, type SpeakersResponse as l, type TalkRow as m, type TalkSpeaker as n, type TalksResponse as o, checkNetworkMapJobStatus as p, createEducation as q, createPosition as r, createRecord as s, deleteEducation as t, deletePosition as u, deleteRecord as v, dismissEndorsement as w, fetchAtFundLink as x, fetchEndorsementCount as y, fetchEntitySearch as z };

package/dist/query/fetchers/index.cjs

@@ -755,6 +755,43 @@ async function searchSkills(config, query, limit = 10, options = {}) {
   }
 }
 
+// src/query/fetchers/speakers.ts
+var EMPTY_SPEAKERS = { speakers: [] };
+var EMPTY_TALKS = { talks: [] };
+function buildParams(filters) {
+  const params = new URLSearchParams();
+  const topic = filters.topic?.trim();
+  if (topic) params.set("topic", topic);
+  if (filters.limit !== void 0) params.set("limit", String(filters.limit));
+  return params;
+}
+async function fetchSpeakers(config, filters = {}, options = {}) {
+  const params = buildParams(filters);
+  const query = params.toString();
+  const path = query ? `/api/speakers?${query}` : "/api/speakers";
+  try {
+    return await apiFetch(config, path, {
+      cache: "no-store",
+      ...options
+    });
+  } catch {
+    return EMPTY_SPEAKERS;
+  }
+}
+async function fetchTalks(config, filters = {}, options = {}) {
+  const params = buildParams(filters);
+  const query = params.toString();
+  const path = query ? `/api/talks?${query}` : "/api/talks";
+  try {
+    return await apiFetch(config, path, {
+      cache: "no-store",
+      ...options
+    });
+  } catch {
+    return EMPTY_TALKS;
+  }
+}
+
 // src/query/fetchers/discovery.ts
 async function fetchSimilarProfiles(config, did, opts = {}) {
   const limit = opts.limit ?? 5;
@@ -1869,9 +1906,11 @@ exports.fetchSearchFilters = fetchSearchFilters;
 exports.fetchSearchProfiles = fetchSearchProfiles;
 exports.fetchSimilarProfiles = fetchSimilarProfiles;
 exports.fetchSkillSuggestions = fetchSkillSuggestions;
+exports.fetchSpeakers = fetchSpeakers;
 exports.fetchStats = fetchStats;
 exports.fetchSuggestionCount = fetchSuggestionCount;
 exports.fetchSuggestions = fetchSuggestions;
+exports.fetchTalks = fetchTalks;
 exports.fetchWipePreview = fetchWipePreview;
 exports.followUser = followUser;
 exports.getAdminReviewQueues = getAdminReviewQueues;