@singi-labs/sifa-sdk 0.19.32 → 0.19.34

package/dist/{types-mmGgHkik.d.cts → types-By-g5caY.d.cts}

@@ -1,4 +1,4 @@
-import { w as PresentationLinkView, b as PdsProviderInfo } from './index-piLIwMN1.cjs';
+import { w as PresentationLinkView, b as PdsProviderInfo, T as SkillSuggestion } from './index-CH8NiQwH.cjs';
 
 /**
  * Types for the `id.sifa.getProfileView` XRPC query: the aggregated public
@@ -177,6 +177,11 @@ interface PublicationView {
     publicationName?: string;
     image?: string;
     primary?: boolean;
+    relatedIdentifiers?: {
+        identifier: string;
+        identifierType?: string;
+        relationType: string;
+    }[];
 }
 interface CourseView {
     rkey: string;
@@ -335,6 +340,258 @@ interface ProfileView {
     claimed?: boolean;
 }
 
+/**
+ * Foundation HTTP client for talking to the Sifa AppView.
+ *
+ * Stateless. Consumers supply a {@link SifaApiConfig} per call (the React
+ * hooks read it from context; non-React consumers pass it explicitly). No
+ * singletons, no module-level state.
+ */
+/** Configuration passed to every fetcher. */
+interface SifaApiConfig {
+    /** Base URL of the sifa-api AppView, e.g. `https://api.sifa.id`. No trailing slash. */
+    baseUrl: string;
+    /**
+     * Optional fetch implementation. Defaults to {@link globalThis.fetch}.
+     * Lets Next.js consumers pass their cache-enhanced fetch; node/Expo
+     * consumers can leave this unset.
+     */
+    fetch?: typeof fetch;
+    /**
+     * Optional per-request auth-token minter for auth-required reads. The NATIVE
+     * app supplies this (it has no sifa-api session cookie): given a method NSID
+     * (`lxm`), it mints a short-lived AT Protocol service-auth JWT on the user's
+     * PDS (see the SDK's `/atproto` `mintServiceAuthToken`) and returns it; the
+     * fetcher attaches it as `Authorization: Bearer`. Web omits this and relies on
+     * its session cookie (`credentials: 'include'`). Return `null` to send no
+     * token. See `sifa-api` `createIdentityMiddleware`.
+     */
+    getAuthToken?: (lxm: string) => Promise<string | null>;
+}
+/** Options accepted by {@link apiFetch}. */
+interface ApiFetchOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    /** Request body. Serialized to JSON automatically. */
+    body?: unknown;
+    /** AbortSignal. Defaults to `AbortSignal.timeout(timeoutMs)` if `timeoutMs` is set. */
+    signal?: AbortSignal;
+    /** Per-call timeout in milliseconds. Default: 10_000. Ignored if `signal` is provided. */
+    timeoutMs?: number;
+    /** Retry on HTTP 429 up to 3 times with the server's `Retry-After` delay (capped at 3s). */
+    retryOn429?: boolean;
+    /** Additional headers. `Content-Type: application/json` is set automatically when `body` is present. */
+    headers?: Record<string, string>;
+    credentials?: RequestCredentials;
+    cache?: RequestCache;
+    /**
+     * Next.js-specific cache hints. Ignored on non-Next runtimes. Passed
+     * through transparently as part of {@link RequestInit}.
+     */
+    next?: {
+        revalidate?: number | false;
+        tags?: string[];
+    };
+}
+/** Error thrown by {@link apiFetch} on non-2xx responses. */
+declare class ApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+/**
+ * Generic fetcher used by all SDK query and mutation functions.
+ *
+ * Returns parsed JSON typed as `T`. Throws {@link ApiError} on non-2xx
+ * responses. Use {@link apiFetchOrNull} when 404 should resolve to `null`
+ * instead.
+ */
+declare function apiFetch<T = unknown>(config: SifaApiConfig, path: string, options?: ApiFetchOptions): Promise<T>;
+/**
+ * Variant of {@link apiFetch} that resolves to `null` on HTTP 404 instead
+ * of throwing. Useful for "fetch by handle" reads where missing is
+ * expected (e.g. unknown profile).
+ */
+declare function apiFetchOrNull<T>(config: SifaApiConfig, path: string, options?: ApiFetchOptions): Promise<T | null>;
+/**
+ * Result returned by record-write mutations (create / update / delete).
+ *
+ * Never throws -- writes against the user's PDS can fail in many ways
+ * (network, PDS unreachable, rate limit) and the UI needs structured
+ * results to render appropriate messages.
+ */
+interface WriteResult {
+    success: boolean;
+    error?: string;
+    /**
+     * PDS hostname returned by sifa-api when a write failed at the user's
+     * Personal Data Server (issue #167). Lets the UI render
+     * "Your data server (eurosky.social) isn't responding" instead of a
+     * generic "Request failed (500)".
+     */
+    pdsHost?: string;
+}
+/** Result returned by create mutations. Includes the newly created `rkey`. */
+interface CreateResult extends WriteResult {
+    rkey?: string;
+}
+/**
+ * Write mutation against the Sifa AppView. Wraps {@link apiFetch} with the
+ * never-throws contract used by all sifa-web mutations: returns a
+ * structured {@link WriteResult} on both success and failure, and
+ * preserves the `pdsHost` field when the AppView reports a PDS-side
+ * failure (issue #167).
+ *
+ * On success: returns `{ success: true, ...payload }` where `payload` is
+ * whatever the server returned in JSON (or `{}` for 204).
+ *
+ * On failure: returns `{ success: false, error, pdsHost? }`. Never throws.
+ *
+ * Use {@link apiWriteCreate} when you specifically need the `rkey` from a
+ * create response folded into the result shape.
+ */
+declare function apiWrite<TExtra extends object = Record<never, never>>(config: SifaApiConfig, path: string, method: 'POST' | 'PUT' | 'DELETE' | 'PATCH', options?: Omit<ApiFetchOptions, 'method'>): Promise<WriteResult & TExtra>;
+/**
+ * Write mutation that expects the server to return a record key (`rkey`)
+ * in its response body. Wraps {@link apiWrite} and folds the `rkey` into
+ * the result shape so consumers get `{ success, rkey?, error?, pdsHost? }`.
+ *
+ * If the server returns additional fields (e.g. `feedUrl` from external
+ * account creation), pass them via the `TExtra` generic to keep them
+ * typed.
+ */
+declare function apiWriteCreate<TExtra extends object = Record<never, never>>(config: SifaApiConfig, path: string, body: unknown, options?: Omit<ApiFetchOptions, 'method' | 'body'>): Promise<CreateResult & TExtra>;
+
+/** Profile entry returned by the search endpoint. */
+interface ProfileSearchResult {
+    did?: string;
+    handle: string;
+    displayName?: string;
+    headline?: string;
+    avatar?: string;
+    about?: string;
+    currentRole?: string;
+    currentCompany?: string;
+    industry?: string;
+    domain?: string;
+    countryCode?: string;
+    locationCountry?: string;
+    preferredWorkplace?: string[];
+    claimed?: boolean;
+    blueskyVerified?: boolean;
+    blueskyVerifiedAt?: string | null;
+}
+interface SearchFilters {
+    q?: string;
+    skill?: string;
+    country?: string;
+    industry?: string;
+    domain?: string;
+    workplace?: string;
+    app?: string;
+    /**
+     * Open-to filter. Values are short tokens (e.g. "fullTime", "mentor",
+     * "collab") matching `OPEN_TO_OPTIONS[].token` from the taxonomy. The
+     * API expands tokens to lex values server-side. Multiple tokens are
+     * OR-combined (profile matches if any selected token is set).
+     */
+    openTo?: string[];
+    limit?: number;
+}
+interface SearchResponse {
+    profiles: ProfileSearchResult[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/** Skill typeahead suggestion. */
+interface SkillSearchResult {
+    name: string;
+    slug: string;
+    category: string;
+    userCount: number;
+}
+interface FilterOptions {
+    countries: {
+        countryCode: string;
+        country: string;
+        count: number;
+    }[];
+    industries: {
+        industry: string;
+        count: number;
+    }[];
+    apps: {
+        appId: string;
+        count: number;
+    }[];
+    /**
+     * Distribution of openTo selections across indexed profiles. Each entry
+     * maps a short token (see {@link SearchFilters.openTo}) to the number of
+     * profiles that have it set. Omitted from older API responses; treat
+     * absence as "no data" rather than "all zero".
+     */
+    openTo?: {
+        token: string;
+        count: number;
+    }[];
+}
+/** Company entry returned by company search (workspace#299). */
+interface CompanySearchResult {
+    /** Immutable catalogue id; the durable `/c/{publicId}` link. */
+    publicId: string;
+    name: string;
+    domain: string | null;
+    country: string | null;
+    industry: string | null;
+    logoUrl: string | null;
+    employeeCount: number | null;
+}
+interface CompanySearchFilters {
+    q?: string;
+    /** ISO 3166-1 alpha-2. */
+    country?: string;
+    industry?: string;
+    limit?: number;
+}
+interface CompanySearchResponse {
+    results: CompanySearchResult[];
+    hasMore: boolean;
+}
+/**
+ * Search profiles by free-text query and optional filters. Returns an
+ * empty result set when no filters are provided (matching sifa-web's
+ * "no input, no fetch" behavior).
+ */
+declare function fetchSearchProfiles(config: SifaApiConfig, filters: SearchFilters, options?: ApiFetchOptions): Promise<SearchResponse>;
+/**
+ * Company search over the entity catalogue (workspace#299).
+ *
+ * A category of its own rather than part of profile search: the two rank
+ * differently and carry different filters, and a slow category should not hold
+ * up the rest of a blended results page.
+ *
+ * An empty query returns nothing without a network call. The API rejects a
+ * blank `q` rather than scanning ~200k rows, so asking would only spend a round
+ * trip to be told no.
+ */
+declare function fetchSearchCompanies(config: SifaApiConfig, filters: CompanySearchFilters, options?: ApiFetchOptions): Promise<CompanySearchResponse>;
+/**
+ * Skill typeahead. Returns up to 8 matches for the given prefix. Empty
+ * input returns an empty array without hitting the server.
+ */
+declare function fetchSkillSuggestions(config: SifaApiConfig, query: string, options?: ApiFetchOptions): Promise<SkillSearchResult[]>;
+/** Available filter facets (countries, industries, apps) for search UI. */
+declare function fetchSearchFilters(config: SifaApiConfig, options?: ApiFetchOptions): Promise<FilterOptions>;
+/**
+ * Canonical-skill search backing the position-editor and similar
+ * skill-pickers. Hits `/api/skills/search` (the canonical-skills DB
+ * lookup) which is distinct from {@link fetchSkillSuggestions}'s
+ * `/api/search/skills` (the profile-skill typeahead).
+ *
+ * Returns `[]` on empty input (no network call) or any error.
+ */
+declare function searchSkills(config: SifaApiConfig, query: string, limit?: number, options?: ApiFetchOptions): Promise<SkillSuggestion[]>;
+
 /**
  * Adult-content gating for Bluesky activity items.
  *
@@ -540,4 +797,4 @@ interface RepoDeleteResult {
     };
 }
 
-export { ADULT_CONTENT_LABELS as A, describeSifaRecord as B, type CertificationView as C, type DurationView as D, type EducationView as E, hasAdultContent as F, repoGroupForCollection as G, type HonorView as H, type IndustryDomain as I, type LanguageView as L, type PositionView as P, type RepoCollectionGroup as R, SIFA_REPO_GROUPS as S, type VolunteeringView as V, type ActiveAppView as a, type ActivityLabel as b, type AdultContentLabel as c, type AtfundLinkView as d, type CoSpeakerView as e, type ContributorView as f, type CourseView as g, type ExternalAccountView as h, type InvolvementLinkView as i, type InvolvementView as j, type PresentationDeliveryView as k, type PresentationView as l, type ProfileLocationView as m, type ProfileView as n, type ProjectMemberView as o, type ProjectView as p, type PublicationView as q, type RepoDeleteOutcome as r, type RepoDeleteRecordResult as s, type RepoDeleteResult as t, type RepoGroupDefinition as u, type RepoGroupId as v, type RepoInventory as w, type RepoRecordLabel as x, type RepoRecordSummary as y, type SkillView as z };
+export { apiWriteCreate as $, ADULT_CONTENT_LABELS as A, type SkillView as B, type CertificationView as C, type DurationView as D, type EducationView as E, describeSifaRecord as F, hasAdultContent as G, type HonorView as H, type IndustryDomain as I, repoGroupForCollection as J, type SifaApiConfig as K, type LanguageView as L, type ApiFetchOptions as M, type CreateResult as N, ApiError as O, type PositionView as P, type FilterOptions as Q, type RepoCollectionGroup as R, type SearchFilters as S, type ProfileSearchResult as T, type SearchResponse as U, type VolunteeringView as V, type WriteResult as W, type SkillSearchResult as X, apiFetch as Y, apiFetchOrNull as Z, apiWrite as _, type ActiveAppView as a, fetchSearchFilters as a0, fetchSearchProfiles as a1, fetchSkillSuggestions as a2, searchSkills as a3, type CompanySearchFilters as a4, type CompanySearchResponse as a5, type CompanySearchResult as a6, fetchSearchCompanies as a7, type ActivityLabel as b, type AdultContentLabel as c, type AtfundLinkView as d, type CoSpeakerView as e, type ContributorView as f, type CourseView as g, type ExternalAccountView as h, type InvolvementLinkView as i, type InvolvementView as j, type PresentationDeliveryView as k, type PresentationView as l, type ProfileLocationView as m, type ProfileView as n, type ProjectMemberView as o, type ProjectView as p, type PublicationView as q, type RepoDeleteOutcome as r, type RepoDeleteRecordResult as s, type RepoDeleteResult as t, type RepoGroupDefinition as u, type RepoGroupId as v, type RepoInventory as w, type RepoRecordLabel as x, type RepoRecordSummary as y, SIFA_REPO_GROUPS as z };

package/dist/{types-Mosj_JIx.d.ts → types-pK_aShdG.d.ts}

@@ -1,4 +1,4 @@
-import { w as PresentationLinkView, b as PdsProviderInfo } from './index-CpbCm2Fe.js';
+import { w as PresentationLinkView, b as PdsProviderInfo, T as SkillSuggestion } from './index-ayiu2kGy.js';
 
 /**
  * Types for the `id.sifa.getProfileView` XRPC query: the aggregated public
@@ -177,6 +177,11 @@ interface PublicationView {
     publicationName?: string;
     image?: string;
     primary?: boolean;
+    relatedIdentifiers?: {
+        identifier: string;
+        identifierType?: string;
+        relationType: string;
+    }[];
 }
 interface CourseView {
     rkey: string;
@@ -335,6 +340,258 @@ interface ProfileView {
     claimed?: boolean;
 }
 
+/**
+ * Foundation HTTP client for talking to the Sifa AppView.
+ *
+ * Stateless. Consumers supply a {@link SifaApiConfig} per call (the React
+ * hooks read it from context; non-React consumers pass it explicitly). No
+ * singletons, no module-level state.
+ */
+/** Configuration passed to every fetcher. */
+interface SifaApiConfig {
+    /** Base URL of the sifa-api AppView, e.g. `https://api.sifa.id`. No trailing slash. */
+    baseUrl: string;
+    /**
+     * Optional fetch implementation. Defaults to {@link globalThis.fetch}.
+     * Lets Next.js consumers pass their cache-enhanced fetch; node/Expo
+     * consumers can leave this unset.
+     */
+    fetch?: typeof fetch;
+    /**
+     * Optional per-request auth-token minter for auth-required reads. The NATIVE
+     * app supplies this (it has no sifa-api session cookie): given a method NSID
+     * (`lxm`), it mints a short-lived AT Protocol service-auth JWT on the user's
+     * PDS (see the SDK's `/atproto` `mintServiceAuthToken`) and returns it; the
+     * fetcher attaches it as `Authorization: Bearer`. Web omits this and relies on
+     * its session cookie (`credentials: 'include'`). Return `null` to send no
+     * token. See `sifa-api` `createIdentityMiddleware`.
+     */
+    getAuthToken?: (lxm: string) => Promise<string | null>;
+}
+/** Options accepted by {@link apiFetch}. */
+interface ApiFetchOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    /** Request body. Serialized to JSON automatically. */
+    body?: unknown;
+    /** AbortSignal. Defaults to `AbortSignal.timeout(timeoutMs)` if `timeoutMs` is set. */
+    signal?: AbortSignal;
+    /** Per-call timeout in milliseconds. Default: 10_000. Ignored if `signal` is provided. */
+    timeoutMs?: number;
+    /** Retry on HTTP 429 up to 3 times with the server's `Retry-After` delay (capped at 3s). */
+    retryOn429?: boolean;
+    /** Additional headers. `Content-Type: application/json` is set automatically when `body` is present. */
+    headers?: Record<string, string>;
+    credentials?: RequestCredentials;
+    cache?: RequestCache;
+    /**
+     * Next.js-specific cache hints. Ignored on non-Next runtimes. Passed
+     * through transparently as part of {@link RequestInit}.
+     */
+    next?: {
+        revalidate?: number | false;
+        tags?: string[];
+    };
+}
+/** Error thrown by {@link apiFetch} on non-2xx responses. */
+declare class ApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+/**
+ * Generic fetcher used by all SDK query and mutation functions.
+ *
+ * Returns parsed JSON typed as `T`. Throws {@link ApiError} on non-2xx
+ * responses. Use {@link apiFetchOrNull} when 404 should resolve to `null`
+ * instead.
+ */
+declare function apiFetch<T = unknown>(config: SifaApiConfig, path: string, options?: ApiFetchOptions): Promise<T>;
+/**
+ * Variant of {@link apiFetch} that resolves to `null` on HTTP 404 instead
+ * of throwing. Useful for "fetch by handle" reads where missing is
+ * expected (e.g. unknown profile).
+ */
+declare function apiFetchOrNull<T>(config: SifaApiConfig, path: string, options?: ApiFetchOptions): Promise<T | null>;
+/**
+ * Result returned by record-write mutations (create / update / delete).
+ *
+ * Never throws -- writes against the user's PDS can fail in many ways
+ * (network, PDS unreachable, rate limit) and the UI needs structured
+ * results to render appropriate messages.
+ */
+interface WriteResult {
+    success: boolean;
+    error?: string;
+    /**
+     * PDS hostname returned by sifa-api when a write failed at the user's
+     * Personal Data Server (issue #167). Lets the UI render
+     * "Your data server (eurosky.social) isn't responding" instead of a
+     * generic "Request failed (500)".
+     */
+    pdsHost?: string;
+}
+/** Result returned by create mutations. Includes the newly created `rkey`. */
+interface CreateResult extends WriteResult {
+    rkey?: string;
+}
+/**
+ * Write mutation against the Sifa AppView. Wraps {@link apiFetch} with the
+ * never-throws contract used by all sifa-web mutations: returns a
+ * structured {@link WriteResult} on both success and failure, and
+ * preserves the `pdsHost` field when the AppView reports a PDS-side
+ * failure (issue #167).
+ *
+ * On success: returns `{ success: true, ...payload }` where `payload` is
+ * whatever the server returned in JSON (or `{}` for 204).
+ *
+ * On failure: returns `{ success: false, error, pdsHost? }`. Never throws.
+ *
+ * Use {@link apiWriteCreate} when you specifically need the `rkey` from a
+ * create response folded into the result shape.
+ */
+declare function apiWrite<TExtra extends object = Record<never, never>>(config: SifaApiConfig, path: string, method: 'POST' | 'PUT' | 'DELETE' | 'PATCH', options?: Omit<ApiFetchOptions, 'method'>): Promise<WriteResult & TExtra>;
+/**
+ * Write mutation that expects the server to return a record key (`rkey`)
+ * in its response body. Wraps {@link apiWrite} and folds the `rkey` into
+ * the result shape so consumers get `{ success, rkey?, error?, pdsHost? }`.
+ *
+ * If the server returns additional fields (e.g. `feedUrl` from external
+ * account creation), pass them via the `TExtra` generic to keep them
+ * typed.
+ */
+declare function apiWriteCreate<TExtra extends object = Record<never, never>>(config: SifaApiConfig, path: string, body: unknown, options?: Omit<ApiFetchOptions, 'method' | 'body'>): Promise<CreateResult & TExtra>;
+
+/** Profile entry returned by the search endpoint. */
+interface ProfileSearchResult {
+    did?: string;
+    handle: string;
+    displayName?: string;
+    headline?: string;
+    avatar?: string;
+    about?: string;
+    currentRole?: string;
+    currentCompany?: string;
+    industry?: string;
+    domain?: string;
+    countryCode?: string;
+    locationCountry?: string;
+    preferredWorkplace?: string[];
+    claimed?: boolean;
+    blueskyVerified?: boolean;
+    blueskyVerifiedAt?: string | null;
+}
+interface SearchFilters {
+    q?: string;
+    skill?: string;
+    country?: string;
+    industry?: string;
+    domain?: string;
+    workplace?: string;
+    app?: string;
+    /**
+     * Open-to filter. Values are short tokens (e.g. "fullTime", "mentor",
+     * "collab") matching `OPEN_TO_OPTIONS[].token` from the taxonomy. The
+     * API expands tokens to lex values server-side. Multiple tokens are
+     * OR-combined (profile matches if any selected token is set).
+     */
+    openTo?: string[];
+    limit?: number;
+}
+interface SearchResponse {
+    profiles: ProfileSearchResult[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/** Skill typeahead suggestion. */
+interface SkillSearchResult {
+    name: string;
+    slug: string;
+    category: string;
+    userCount: number;
+}
+interface FilterOptions {
+    countries: {
+        countryCode: string;
+        country: string;
+        count: number;
+    }[];
+    industries: {
+        industry: string;
+        count: number;
+    }[];
+    apps: {
+        appId: string;
+        count: number;
+    }[];
+    /**
+     * Distribution of openTo selections across indexed profiles. Each entry
+     * maps a short token (see {@link SearchFilters.openTo}) to the number of
+     * profiles that have it set. Omitted from older API responses; treat
+     * absence as "no data" rather than "all zero".
+     */
+    openTo?: {
+        token: string;
+        count: number;
+    }[];
+}
+/** Company entry returned by company search (workspace#299). */
+interface CompanySearchResult {
+    /** Immutable catalogue id; the durable `/c/{publicId}` link. */
+    publicId: string;
+    name: string;
+    domain: string | null;
+    country: string | null;
+    industry: string | null;
+    logoUrl: string | null;
+    employeeCount: number | null;
+}
+interface CompanySearchFilters {
+    q?: string;
+    /** ISO 3166-1 alpha-2. */
+    country?: string;
+    industry?: string;
+    limit?: number;
+}
+interface CompanySearchResponse {
+    results: CompanySearchResult[];
+    hasMore: boolean;
+}
+/**
+ * Search profiles by free-text query and optional filters. Returns an
+ * empty result set when no filters are provided (matching sifa-web's
+ * "no input, no fetch" behavior).
+ */
+declare function fetchSearchProfiles(config: SifaApiConfig, filters: SearchFilters, options?: ApiFetchOptions): Promise<SearchResponse>;
+/**
+ * Company search over the entity catalogue (workspace#299).
+ *
+ * A category of its own rather than part of profile search: the two rank
+ * differently and carry different filters, and a slow category should not hold
+ * up the rest of a blended results page.
+ *
+ * An empty query returns nothing without a network call. The API rejects a
+ * blank `q` rather than scanning ~200k rows, so asking would only spend a round
+ * trip to be told no.
+ */
+declare function fetchSearchCompanies(config: SifaApiConfig, filters: CompanySearchFilters, options?: ApiFetchOptions): Promise<CompanySearchResponse>;
+/**
+ * Skill typeahead. Returns up to 8 matches for the given prefix. Empty
+ * input returns an empty array without hitting the server.
+ */
+declare function fetchSkillSuggestions(config: SifaApiConfig, query: string, options?: ApiFetchOptions): Promise<SkillSearchResult[]>;
+/** Available filter facets (countries, industries, apps) for search UI. */
+declare function fetchSearchFilters(config: SifaApiConfig, options?: ApiFetchOptions): Promise<FilterOptions>;
+/**
+ * Canonical-skill search backing the position-editor and similar
+ * skill-pickers. Hits `/api/skills/search` (the canonical-skills DB
+ * lookup) which is distinct from {@link fetchSkillSuggestions}'s
+ * `/api/search/skills` (the profile-skill typeahead).
+ *
+ * Returns `[]` on empty input (no network call) or any error.
+ */
+declare function searchSkills(config: SifaApiConfig, query: string, limit?: number, options?: ApiFetchOptions): Promise<SkillSuggestion[]>;
+
 /**
  * Adult-content gating for Bluesky activity items.
  *
@@ -540,4 +797,4 @@ interface RepoDeleteResult {
     };
 }
 
-export { ADULT_CONTENT_LABELS as A, describeSifaRecord as B, type CertificationView as C, type DurationView as D, type EducationView as E, hasAdultContent as F, repoGroupForCollection as G, type HonorView as H, type IndustryDomain as I, type LanguageView as L, type PositionView as P, type RepoCollectionGroup as R, SIFA_REPO_GROUPS as S, type VolunteeringView as V, type ActiveAppView as a, type ActivityLabel as b, type AdultContentLabel as c, type AtfundLinkView as d, type CoSpeakerView as e, type ContributorView as f, type CourseView as g, type ExternalAccountView as h, type InvolvementLinkView as i, type InvolvementView as j, type PresentationDeliveryView as k, type PresentationView as l, type ProfileLocationView as m, type ProfileView as n, type ProjectMemberView as o, type ProjectView as p, type PublicationView as q, type RepoDeleteOutcome as r, type RepoDeleteRecordResult as s, type RepoDeleteResult as t, type RepoGroupDefinition as u, type RepoGroupId as v, type RepoInventory as w, type RepoRecordLabel as x, type RepoRecordSummary as y, type SkillView as z };
+export { apiWriteCreate as $, ADULT_CONTENT_LABELS as A, type SkillView as B, type CertificationView as C, type DurationView as D, type EducationView as E, describeSifaRecord as F, hasAdultContent as G, type HonorView as H, type IndustryDomain as I, repoGroupForCollection as J, type SifaApiConfig as K, type LanguageView as L, type ApiFetchOptions as M, type CreateResult as N, ApiError as O, type PositionView as P, type FilterOptions as Q, type RepoCollectionGroup as R, type SearchFilters as S, type ProfileSearchResult as T, type SearchResponse as U, type VolunteeringView as V, type WriteResult as W, type SkillSearchResult as X, apiFetch as Y, apiFetchOrNull as Z, apiWrite as _, type ActiveAppView as a, fetchSearchFilters as a0, fetchSearchProfiles as a1, fetchSkillSuggestions as a2, searchSkills as a3, type CompanySearchFilters as a4, type CompanySearchResponse as a5, type CompanySearchResult as a6, fetchSearchCompanies as a7, type ActivityLabel as b, type AdultContentLabel as c, type AtfundLinkView as d, type CoSpeakerView as e, type ContributorView as f, type CourseView as g, type ExternalAccountView as h, type InvolvementLinkView as i, type InvolvementView as j, type PresentationDeliveryView as k, type PresentationView as l, type ProfileLocationView as m, type ProfileView as n, type ProjectMemberView as o, type ProjectView as p, type PublicationView as q, type RepoDeleteOutcome as r, type RepoDeleteRecordResult as s, type RepoDeleteResult as t, type RepoGroupDefinition as u, type RepoGroupId as v, type RepoInventory as w, type RepoRecordLabel as x, type RepoRecordSummary as y, SIFA_REPO_GROUPS as z };

package/dist/{use-org-notification-emails-Dsek36iZ.d.ts → use-org-notification-emails-BwYnA7tk.d.ts}

@@ -1,10 +1,10 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { S as SifaApiConfig, s as sifaQueryKeys, W as WriteResult, aI as RefreshPdsResult, b0 as UpdateProfileOverrideInput, b1 as UpdateProfileSelfInput, b2 as UploadAvatarResult, b3 as UploadPronunciationAudioResult, C as CreateResult, ar as PrimarySection, aW as SubCategoryBulkResult, aw as ProfileLocationInput, r as ExternalAccountInput, p as CreateExternalAccountResult, b4 as VerifyExternalAccountResult, E as EndorsementInput, n as ConfirmationInput, o as ConfirmationSubjectInput, a1 as GivenConfirmation, aq as PendingConfirmationsPage, ac as InboxCounts, q as DismissUnlinkedPositionInput, a$ as UnlinkedPositionsResult, as as ProfileCompleteness, aH as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, ab as HideProfileItemInput, a6 as HiddenActivityItem, aa as HideActivityItemInput, aZ as UnhideActivityItemInput, aV as StatsResponse, k as AppRegistryEntry, a7 as HiddenApp, d as AccountSummary, Q as FilterOptions, aQ as SearchFilters, aR as SearchResponse, aU as SkillSearchResult, cK as CompanySearchFilters, cL as CompanySearchResponse, t as FeaturedProfile, aT as SimilarProfile, O as FetchSuggestionsOptions, aY as SuggestionsResponse, V as FollowUserResult, y as FetchFollowListOptions, R as FollowListPage, _ as FollowingResponse, G as FetchFollowingFeedOptions, Z as FollowingFeedResponse, z as FetchFollowProfilePageOptions, U as FollowProfilePageResponse, F as FeatureAllowlistResponse, i as AdminReviewQueues, v as FetchActivityFeedOptions, e as ActivityFeedResponse, h as ActivityTeaserResponse, a5 as HeatmapResponse, ae as MyGithubPullRequestsResponse, c as AccountCheckResult, aG as ReactionStatus, aF as ReactionResult, aE as ReactionError, aP as RoadmapVotesResponse, l as CastRoadmapVoteResult, D as DeleteAccountResult, aK as ResetProfileResult, b5 as WipePreview, aJ as RepoDeleteInput, ag as OrgClaimResult, am as OrgProfileUpdateResult, ah as OrgDomainChallengeResult, ai as OrgDomainVerifyResult, aj as OrgNotificationEmailAddResult, ak as OrgNotificationEmailRemoveResult } from './org-Dx8K7Mh8.js';
+import { K as SifaApiConfig, n as ProfileView, W as WriteResult, N as CreateResult, Q as FilterOptions, S as SearchFilters, U as SearchResponse, X as SkillSearchResult, a4 as CompanySearchFilters, a5 as CompanySearchResponse, t as RepoDeleteResult, w as RepoInventory } from './types-pK_aShdG.js';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseMutationOptions, UseInfiniteQueryOptions, InfiniteData } from '@tanstack/react-query';
-import { c as Profile, d as ProfilePosition, S as SkillRef, p as ExternalAccount, Q as SkillSuggestion, s as OrgFloorVerdict } from './index-CpbCm2Fe.js';
-import { n as ProfileView, t as RepoDeleteResult, w as RepoInventory } from './types-Mosj_JIx.js';
+import { c as Profile, d as ProfilePosition, S as SkillRef, p as ExternalAccount, T as SkillSuggestion, s as OrgFloorVerdict } from './index-ayiu2kGy.js';
+import { s as sifaQueryKeys, aB as RefreshPdsResult, aS as UpdateProfileOverrideInput, aT as UpdateProfileSelfInput, aU as UploadAvatarResult, aV as UploadPronunciationAudioResult, al as PrimarySection, aM as SubCategoryBulkResult, aq as ProfileLocationInput, o as ExternalAccountInput, m as CreateExternalAccountResult, aW as VerifyExternalAccountResult, E as EndorsementInput, k as ConfirmationInput, l as ConfirmationSubjectInput, X as GivenConfirmation, ak as PendingConfirmationsPage, a6 as InboxCounts, n as DismissUnlinkedPositionInput, aR as UnlinkedPositionsResult, am as ProfileCompleteness, aA as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, a5 as HideProfileItemInput, a0 as HiddenActivityItem, a4 as HideActivityItemInput, aP as UnhideActivityItemInput, aL as StatsResponse, h as AppRegistryEntry, a1 as HiddenApp, b as AccountSummary, p as FeaturedProfile, aK as SimilarProfile, L as FetchSuggestionsOptions, aO as SuggestionsResponse, Q as FollowUserResult, v as FetchFollowListOptions, N as FollowListPage, U as FollowingResponse, x as FetchFollowingFeedOptions, T as FollowingFeedResponse, w as FetchFollowProfilePageOptions, P as FollowProfilePageResponse, F as FeatureAllowlistResponse, g as AdminReviewQueues, r as FetchActivityFeedOptions, c as ActivityFeedResponse, f as ActivityTeaserResponse, $ as HeatmapResponse, a8 as MyGithubPullRequestsResponse, A as AccountCheckResult, az as ReactionStatus, ay as ReactionResult, ax as ReactionError, aI as RoadmapVotesResponse, i as CastRoadmapVoteResult, D as DeleteAccountResult, aD as ResetProfileResult, aX as WipePreview, aC as RepoDeleteInput, aa as OrgClaimResult, ag as OrgProfileUpdateResult, ab as OrgDomainChallengeResult, ac as OrgDomainVerifyResult, ad as OrgNotificationEmailAddResult, ae as OrgNotificationEmailRemoveResult } from './org-C_s76iQT.js';
 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-D1l6pulB.js';
 import { O as OrgClaimRequestInput, a as OrgProfileUpdateRequestInput, b as OrgDomainChallengeRequestInput, c as OrgDomainVerifyRequestInput, d as OrgNotificationEmailRequestInput } from './org-settings-C73Sin5E.js';
 

package/dist/{use-org-notification-emails-OHgt6WRP.d.cts → use-org-notification-emails-DamYHmQc.d.cts}

@@ -1,10 +1,10 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { S as SifaApiConfig, s as sifaQueryKeys, W as WriteResult, aI as RefreshPdsResult, b0 as UpdateProfileOverrideInput, b1 as UpdateProfileSelfInput, b2 as UploadAvatarResult, b3 as UploadPronunciationAudioResult, C as CreateResult, ar as PrimarySection, aW as SubCategoryBulkResult, aw as ProfileLocationInput, r as ExternalAccountInput, p as CreateExternalAccountResult, b4 as VerifyExternalAccountResult, E as EndorsementInput, n as ConfirmationInput, o as ConfirmationSubjectInput, a1 as GivenConfirmation, aq as PendingConfirmationsPage, ac as InboxCounts, q as DismissUnlinkedPositionInput, a$ as UnlinkedPositionsResult, as as ProfileCompleteness, aH as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, ab as HideProfileItemInput, a6 as HiddenActivityItem, aa as HideActivityItemInput, aZ as UnhideActivityItemInput, aV as StatsResponse, k as AppRegistryEntry, a7 as HiddenApp, d as AccountSummary, Q as FilterOptions, aQ as SearchFilters, aR as SearchResponse, aU as SkillSearchResult, cK as CompanySearchFilters, cL as CompanySearchResponse, t as FeaturedProfile, aT as SimilarProfile, O as FetchSuggestionsOptions, aY as SuggestionsResponse, V as FollowUserResult, y as FetchFollowListOptions, R as FollowListPage, _ as FollowingResponse, G as FetchFollowingFeedOptions, Z as FollowingFeedResponse, z as FetchFollowProfilePageOptions, U as FollowProfilePageResponse, F as FeatureAllowlistResponse, i as AdminReviewQueues, v as FetchActivityFeedOptions, e as ActivityFeedResponse, h as ActivityTeaserResponse, a5 as HeatmapResponse, ae as MyGithubPullRequestsResponse, c as AccountCheckResult, aG as ReactionStatus, aF as ReactionResult, aE as ReactionError, aP as RoadmapVotesResponse, l as CastRoadmapVoteResult, D as DeleteAccountResult, aK as ResetProfileResult, b5 as WipePreview, aJ as RepoDeleteInput, ag as OrgClaimResult, am as OrgProfileUpdateResult, ah as OrgDomainChallengeResult, ai as OrgDomainVerifyResult, aj as OrgNotificationEmailAddResult, ak as OrgNotificationEmailRemoveResult } from './org-BIbPhHLx.cjs';
+import { K as SifaApiConfig, n as ProfileView, W as WriteResult, N as CreateResult, Q as FilterOptions, S as SearchFilters, U as SearchResponse, X as SkillSearchResult, a4 as CompanySearchFilters, a5 as CompanySearchResponse, t as RepoDeleteResult, w as RepoInventory } from './types-By-g5caY.cjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseMutationOptions, UseInfiniteQueryOptions, InfiniteData } from '@tanstack/react-query';
-import { c as Profile, d as ProfilePosition, S as SkillRef, p as ExternalAccount, Q as SkillSuggestion, s as OrgFloorVerdict } from './index-piLIwMN1.cjs';
-import { n as ProfileView, t as RepoDeleteResult, w as RepoInventory } from './types-mmGgHkik.cjs';
+import { c as Profile, d as ProfilePosition, S as SkillRef, p as ExternalAccount, T as SkillSuggestion, s as OrgFloorVerdict } from './index-CH8NiQwH.cjs';
+import { s as sifaQueryKeys, aB as RefreshPdsResult, aS as UpdateProfileOverrideInput, aT as UpdateProfileSelfInput, aU as UploadAvatarResult, aV as UploadPronunciationAudioResult, al as PrimarySection, aM as SubCategoryBulkResult, aq as ProfileLocationInput, o as ExternalAccountInput, m as CreateExternalAccountResult, aW as VerifyExternalAccountResult, E as EndorsementInput, k as ConfirmationInput, l as ConfirmationSubjectInput, X as GivenConfirmation, ak as PendingConfirmationsPage, a6 as InboxCounts, n as DismissUnlinkedPositionInput, aR as UnlinkedPositionsResult, am as ProfileCompleteness, aA as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, a5 as HideProfileItemInput, a0 as HiddenActivityItem, a4 as HideActivityItemInput, aP as UnhideActivityItemInput, aL as StatsResponse, h as AppRegistryEntry, a1 as HiddenApp, b as AccountSummary, p as FeaturedProfile, aK as SimilarProfile, L as FetchSuggestionsOptions, aO as SuggestionsResponse, Q as FollowUserResult, v as FetchFollowListOptions, N as FollowListPage, U as FollowingResponse, x as FetchFollowingFeedOptions, T as FollowingFeedResponse, w as FetchFollowProfilePageOptions, P as FollowProfilePageResponse, F as FeatureAllowlistResponse, g as AdminReviewQueues, r as FetchActivityFeedOptions, c as ActivityFeedResponse, f as ActivityTeaserResponse, $ as HeatmapResponse, a8 as MyGithubPullRequestsResponse, A as AccountCheckResult, az as ReactionStatus, ay as ReactionResult, ax as ReactionError, aI as RoadmapVotesResponse, i as CastRoadmapVoteResult, D as DeleteAccountResult, aD as ResetProfileResult, aX as WipePreview, aC as RepoDeleteInput, aa as OrgClaimResult, ag as OrgProfileUpdateResult, ab as OrgDomainChallengeResult, ac as OrgDomainVerifyResult, ad as OrgNotificationEmailAddResult, ae as OrgNotificationEmailRemoveResult } from './org-9B__E4ad.cjs';
 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-D1l6pulB.cjs';
 import { O as OrgClaimRequestInput, a as OrgProfileUpdateRequestInput, b as OrgDomainChallengeRequestInput, c as OrgDomainVerifyRequestInput, d as OrgNotificationEmailRequestInput } from './org-settings-C73Sin5E.cjs';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@singi-labs/sifa-sdk",
-  "version": "0.19.32",
+  "version": "0.19.34",
   "description": "Sifa SDK — public client library for the Sifa AppView on AT Protocol. Shared by sifa-web and sifa-app.",
   "license": "MIT",
   "type": "module",