@singi-labs/sifa-sdk 0.6.0 → 0.7.0

package/dist/query/index.d.cts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import { P as Profile } from '../index-IDRpze8y.cjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { UseMutationOptions, UseQueryOptions } from '@tanstack/react-query';
+import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
 
 /**
  * Foundation HTTP client for talking to the Sifa AppView.
@@ -122,15 +122,181 @@ interface CreateResult extends WriteResult {
  */
 declare function createPosition(config: SifaApiConfig, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<CreateResult>;
 
+/** 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;
+    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;
+    }[];
+}
 /**
- * React hook for creating a new position record. On success, invalidates
- * the owner's profile cache so the new position is reflected on the next
- * read.
- *
- * The owner DID is required so the mutation can target the correct
- * profile cache entry for invalidation.
+ * 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 useCreatePosition(ownerDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, Record<string, unknown>>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, Record<string, unknown>, unknown>;
+declare function fetchSearchProfiles(config: SifaApiConfig, filters: SearchFilters, options?: ApiFetchOptions): Promise<SearchResponse>;
+/**
+ * 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>;
+
+/** Lightweight profile representation used by discovery endpoints. */
+interface SimilarProfile {
+    did: string;
+    handle: string;
+    displayName?: string | null;
+    avatar?: string | null;
+    headline?: string | null;
+    currentRole?: string | null;
+    currentCompany?: string | null;
+    industry?: string | null;
+    domain?: string | null;
+}
+interface SuggestionProfile {
+    did: string;
+    handle: string;
+    displayName?: string;
+    headline?: string;
+    avatarUrl?: string;
+    source: string;
+    dismissed: boolean;
+    blueskyVerified?: boolean;
+}
+interface SuggestionsResponse {
+    onSifa: SuggestionProfile[];
+    notOnSifa: SuggestionProfile[];
+    cursor?: string;
+}
+interface FeaturedProfile {
+    did: string;
+    handle: string;
+    displayName?: string;
+    avatar?: string;
+    pronouns?: string;
+    headline?: string;
+    about?: string;
+    currentRole?: string;
+    currentCompany?: string;
+    locationCountry?: string;
+    locationRegion?: string;
+    /** Legacy alias for `locationLocality`; emitted by sifa-api during the additive response window. */
+    locationCity?: string;
+    /** community.lexicon.location.address field name -- prefer over `locationCity`. */
+    locationLocality?: string;
+    countryCode?: string;
+    location?: string;
+    website?: string;
+    openTo?: string[];
+    preferredWorkplace?: string[];
+    availableFromUtc?: number;
+    availableToUtc?: number;
+    followersCount?: number;
+    atprotoFollowersCount?: number;
+    pdsProvider?: {
+        name: string;
+        host: string;
+    } | null;
+    claimed: boolean;
+    featuredDate: string;
+}
+/** Profiles similar to the given DID (matchmaking). Returns `[]` on error. */
+declare function fetchSimilarProfiles(config: SifaApiConfig, did: string, opts?: {
+    limit?: number;
+} & ApiFetchOptions): Promise<SimilarProfile[]>;
+interface FetchSuggestionsOptions extends ApiFetchOptions {
+    source?: string;
+    includeDismissed?: boolean;
+    cursor?: string;
+    limit?: number;
+    /**
+     * Pass the caller's `Cookie` header on Next.js RSC server-side calls.
+     * `credentials: 'include'` does NOT propagate browser cookies in RSC,
+     * so authenticated server fetches must forward the header explicitly.
+     */
+    cookieHeader?: string;
+}
+/** Discovery suggestions feed. Resolves to empty arrays on error. */
+declare function fetchSuggestions(config: SifaApiConfig, opts?: FetchSuggestionsOptions): Promise<SuggestionsResponse>;
+/** Count of pending suggestions since an optional timestamp. */
+declare function fetchSuggestionCount(config: SifaApiConfig, since?: string, options?: ApiFetchOptions): Promise<number>;
+/** Featured profile (rotated by sifa-api). Returns `null` when none. */
+declare function fetchFeaturedProfile(config: SifaApiConfig, options?: ApiFetchOptions): Promise<FeaturedProfile | null>;
+
+interface FollowProfile {
+    did: string;
+    handle: string;
+    displayName?: string;
+    headline?: string;
+    avatarUrl?: string;
+    source: string;
+    claimed: boolean;
+    followedAt: string;
+    blueskyVerified?: boolean;
+    blueskyVerifiedAt?: string | null;
+}
+interface FollowingResponse {
+    follows: FollowProfile[];
+    cursor?: string;
+}
+/** People the authenticated user follows. Empty on error. */
+declare function fetchFollowing(config: SifaApiConfig, opts?: {
+    source?: string;
+    cursor?: string;
+    limit?: number;
+} & ApiFetchOptions): Promise<FollowingResponse>;
 
 /**
  * Query key factory for TanStack Query.
@@ -153,8 +319,25 @@ declare const sifaQueryKeys: {
         readonly all: () => readonly ["sifa", "position"];
         readonly byOwner: (did: string) => readonly ["sifa", "position", "by-owner", string];
     };
+    readonly search: {
+        readonly all: () => readonly ["sifa", "search"];
+        readonly profiles: (filters: Record<string, unknown>) => readonly ["sifa", "search", "profiles", Record<string, unknown>];
+        readonly skills: (query: string) => readonly ["sifa", "search", "skills", string];
+        readonly filters: () => readonly ["sifa", "search", "filters"];
+    };
+    readonly discovery: {
+        readonly all: () => readonly ["sifa", "discovery"];
+        readonly similar: (did: string, limit: number) => readonly ["sifa", "discovery", "similar", string, number];
+        readonly suggestions: (opts: Record<string, unknown>) => readonly ["sifa", "discovery", "suggestions", Record<string, unknown>];
+        readonly suggestionCount: (since: string | undefined) => readonly ["sifa", "discovery", "suggestion-count", string | null];
+        readonly featured: () => readonly ["sifa", "discovery", "featured"];
+    };
+    readonly follow: {
+        readonly all: () => readonly ["sifa", "follow"];
+        readonly following: (opts: Record<string, unknown>) => readonly ["sifa", "follow", "following", Record<string, unknown>];
+    };
 };
-type SifaQueryKey = ReturnType<typeof sifaQueryKeys.all> | ReturnType<typeof sifaQueryKeys.profile.all> | ReturnType<typeof sifaQueryKeys.profile.byHandle> | ReturnType<typeof sifaQueryKeys.position.all> | ReturnType<typeof sifaQueryKeys.position.byOwner>;
+type SifaQueryKey = ReturnType<typeof sifaQueryKeys.all> | ReturnType<typeof sifaQueryKeys.profile.all> | ReturnType<typeof sifaQueryKeys.profile.byHandle> | ReturnType<typeof sifaQueryKeys.position.all> | ReturnType<typeof sifaQueryKeys.position.byOwner> | ReturnType<typeof sifaQueryKeys.search.all> | ReturnType<typeof sifaQueryKeys.search.profiles> | ReturnType<typeof sifaQueryKeys.search.skills> | ReturnType<typeof sifaQueryKeys.search.filters> | ReturnType<typeof sifaQueryKeys.discovery.all> | ReturnType<typeof sifaQueryKeys.discovery.similar> | ReturnType<typeof sifaQueryKeys.discovery.suggestions> | ReturnType<typeof sifaQueryKeys.discovery.suggestionCount> | ReturnType<typeof sifaQueryKeys.discovery.featured> | ReturnType<typeof sifaQueryKeys.follow.all> | ReturnType<typeof sifaQueryKeys.follow.following>;
 
 /**
  * React hook that reads an aggregated profile by handle or DID via
@@ -165,4 +348,31 @@ type SifaQueryKey = ReturnType<typeof sifaQueryKeys.all> | ReturnType<typeof sif
  */
 declare function useProfile(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<Profile | null, Error, Profile | null, ReturnType<typeof sifaQueryKeys.profile.byHandle>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<Profile | null, Error>;
 
-export { ApiError, type ApiFetchOptions, type CreateResult, type SifaApiConfig, SifaProvider, type SifaProviderProps, type SifaQueryKey, type WriteResult, apiFetch, apiFetchOrNull, createPosition, fetchProfile, sifaQueryKeys, useCreatePosition, useProfile, useSifaConfig };
+/**
+ * React hook for creating a new position record. On success, invalidates
+ * the owner's profile cache so the new position is reflected on the next
+ * read.
+ *
+ * The owner DID is required so the mutation can target the correct
+ * profile cache entry for invalidation.
+ */
+declare function useCreatePosition(ownerDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, Record<string, unknown>>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, Record<string, unknown>, unknown>;
+
+declare function useSearchProfiles(filters: SearchFilters, options?: Omit<UseQueryOptions<SearchResponse, Error, SearchResponse, ReturnType<typeof sifaQueryKeys.search.profiles>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SearchResponse, Error>;
+declare function useSkillSuggestions(query: string, options?: Omit<UseQueryOptions<SkillSearchResult[], Error, SkillSearchResult[], ReturnType<typeof sifaQueryKeys.search.skills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SkillSearchResult[], Error>;
+declare function useSearchFilters(options?: Omit<UseQueryOptions<FilterOptions, Error, FilterOptions, ReturnType<typeof sifaQueryKeys.search.filters>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FilterOptions, Error>;
+
+declare function useSimilarProfiles(did: string | undefined | null, opts?: {
+    limit?: number;
+}, options?: Omit<UseQueryOptions<SimilarProfile[], Error, SimilarProfile[], ReturnType<typeof sifaQueryKeys.discovery.similar>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SimilarProfile[], Error>;
+declare function useSuggestions(opts?: Omit<FetchSuggestionsOptions, keyof Omit<FetchSuggestionsOptions, 'source' | 'includeDismissed' | 'cursor' | 'limit'>>, options?: Omit<UseQueryOptions<SuggestionsResponse, Error, SuggestionsResponse, ReturnType<typeof sifaQueryKeys.discovery.suggestions>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SuggestionsResponse, Error>;
+declare function useSuggestionCount(since?: string, options?: Omit<UseQueryOptions<number, Error, number, ReturnType<typeof sifaQueryKeys.discovery.suggestionCount>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<number, Error>;
+declare function useFeaturedProfile(options?: Omit<UseQueryOptions<FeaturedProfile | null, Error, FeaturedProfile | null, ReturnType<typeof sifaQueryKeys.discovery.featured>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FeaturedProfile | null, Error>;
+
+declare function useFollowing(opts?: {
+    source?: string;
+    cursor?: string;
+    limit?: number;
+}, options?: Omit<UseQueryOptions<FollowingResponse, Error, FollowingResponse, ReturnType<typeof sifaQueryKeys.follow.following>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FollowingResponse, Error>;
+
+export { ApiError, type ApiFetchOptions, type CreateResult, type FeaturedProfile, type FetchSuggestionsOptions, type FilterOptions, type FollowProfile, type FollowingResponse, type ProfileSearchResult, type SearchFilters, type SearchResponse, type SifaApiConfig, SifaProvider, type SifaProviderProps, type SifaQueryKey, type SimilarProfile, type SkillSearchResult, type SuggestionProfile, type SuggestionsResponse, type WriteResult, apiFetch, apiFetchOrNull, createPosition, fetchFeaturedProfile, fetchFollowing, fetchProfile, fetchSearchFilters, fetchSearchProfiles, fetchSimilarProfiles, fetchSkillSuggestions, fetchSuggestionCount, fetchSuggestions, sifaQueryKeys, useCreatePosition, useFeaturedProfile, useFollowing, useProfile, useSearchFilters, useSearchProfiles, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useSuggestionCount, useSuggestions };

package/dist/query/index.d.ts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import { P as Profile } from '../index-IDRpze8y.js';
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { UseMutationOptions, UseQueryOptions } from '@tanstack/react-query';
+import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
 
 /**
  * Foundation HTTP client for talking to the Sifa AppView.
@@ -122,15 +122,181 @@ interface CreateResult extends WriteResult {
  */
 declare function createPosition(config: SifaApiConfig, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<CreateResult>;
 
+/** 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;
+    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;
+    }[];
+}
 /**
- * React hook for creating a new position record. On success, invalidates
- * the owner's profile cache so the new position is reflected on the next
- * read.
- *
- * The owner DID is required so the mutation can target the correct
- * profile cache entry for invalidation.
+ * 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 useCreatePosition(ownerDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, Record<string, unknown>>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, Record<string, unknown>, unknown>;
+declare function fetchSearchProfiles(config: SifaApiConfig, filters: SearchFilters, options?: ApiFetchOptions): Promise<SearchResponse>;
+/**
+ * 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>;
+
+/** Lightweight profile representation used by discovery endpoints. */
+interface SimilarProfile {
+    did: string;
+    handle: string;
+    displayName?: string | null;
+    avatar?: string | null;
+    headline?: string | null;
+    currentRole?: string | null;
+    currentCompany?: string | null;
+    industry?: string | null;
+    domain?: string | null;
+}
+interface SuggestionProfile {
+    did: string;
+    handle: string;
+    displayName?: string;
+    headline?: string;
+    avatarUrl?: string;
+    source: string;
+    dismissed: boolean;
+    blueskyVerified?: boolean;
+}
+interface SuggestionsResponse {
+    onSifa: SuggestionProfile[];
+    notOnSifa: SuggestionProfile[];
+    cursor?: string;
+}
+interface FeaturedProfile {
+    did: string;
+    handle: string;
+    displayName?: string;
+    avatar?: string;
+    pronouns?: string;
+    headline?: string;
+    about?: string;
+    currentRole?: string;
+    currentCompany?: string;
+    locationCountry?: string;
+    locationRegion?: string;
+    /** Legacy alias for `locationLocality`; emitted by sifa-api during the additive response window. */
+    locationCity?: string;
+    /** community.lexicon.location.address field name -- prefer over `locationCity`. */
+    locationLocality?: string;
+    countryCode?: string;
+    location?: string;
+    website?: string;
+    openTo?: string[];
+    preferredWorkplace?: string[];
+    availableFromUtc?: number;
+    availableToUtc?: number;
+    followersCount?: number;
+    atprotoFollowersCount?: number;
+    pdsProvider?: {
+        name: string;
+        host: string;
+    } | null;
+    claimed: boolean;
+    featuredDate: string;
+}
+/** Profiles similar to the given DID (matchmaking). Returns `[]` on error. */
+declare function fetchSimilarProfiles(config: SifaApiConfig, did: string, opts?: {
+    limit?: number;
+} & ApiFetchOptions): Promise<SimilarProfile[]>;
+interface FetchSuggestionsOptions extends ApiFetchOptions {
+    source?: string;
+    includeDismissed?: boolean;
+    cursor?: string;
+    limit?: number;
+    /**
+     * Pass the caller's `Cookie` header on Next.js RSC server-side calls.
+     * `credentials: 'include'` does NOT propagate browser cookies in RSC,
+     * so authenticated server fetches must forward the header explicitly.
+     */
+    cookieHeader?: string;
+}
+/** Discovery suggestions feed. Resolves to empty arrays on error. */
+declare function fetchSuggestions(config: SifaApiConfig, opts?: FetchSuggestionsOptions): Promise<SuggestionsResponse>;
+/** Count of pending suggestions since an optional timestamp. */
+declare function fetchSuggestionCount(config: SifaApiConfig, since?: string, options?: ApiFetchOptions): Promise<number>;
+/** Featured profile (rotated by sifa-api). Returns `null` when none. */
+declare function fetchFeaturedProfile(config: SifaApiConfig, options?: ApiFetchOptions): Promise<FeaturedProfile | null>;
+
+interface FollowProfile {
+    did: string;
+    handle: string;
+    displayName?: string;
+    headline?: string;
+    avatarUrl?: string;
+    source: string;
+    claimed: boolean;
+    followedAt: string;
+    blueskyVerified?: boolean;
+    blueskyVerifiedAt?: string | null;
+}
+interface FollowingResponse {
+    follows: FollowProfile[];
+    cursor?: string;
+}
+/** People the authenticated user follows. Empty on error. */
+declare function fetchFollowing(config: SifaApiConfig, opts?: {
+    source?: string;
+    cursor?: string;
+    limit?: number;
+} & ApiFetchOptions): Promise<FollowingResponse>;
 
 /**
  * Query key factory for TanStack Query.
@@ -153,8 +319,25 @@ declare const sifaQueryKeys: {
         readonly all: () => readonly ["sifa", "position"];
         readonly byOwner: (did: string) => readonly ["sifa", "position", "by-owner", string];
     };
+    readonly search: {
+        readonly all: () => readonly ["sifa", "search"];
+        readonly profiles: (filters: Record<string, unknown>) => readonly ["sifa", "search", "profiles", Record<string, unknown>];
+        readonly skills: (query: string) => readonly ["sifa", "search", "skills", string];
+        readonly filters: () => readonly ["sifa", "search", "filters"];
+    };
+    readonly discovery: {
+        readonly all: () => readonly ["sifa", "discovery"];
+        readonly similar: (did: string, limit: number) => readonly ["sifa", "discovery", "similar", string, number];
+        readonly suggestions: (opts: Record<string, unknown>) => readonly ["sifa", "discovery", "suggestions", Record<string, unknown>];
+        readonly suggestionCount: (since: string | undefined) => readonly ["sifa", "discovery", "suggestion-count", string | null];
+        readonly featured: () => readonly ["sifa", "discovery", "featured"];
+    };
+    readonly follow: {
+        readonly all: () => readonly ["sifa", "follow"];
+        readonly following: (opts: Record<string, unknown>) => readonly ["sifa", "follow", "following", Record<string, unknown>];
+    };
 };
-type SifaQueryKey = ReturnType<typeof sifaQueryKeys.all> | ReturnType<typeof sifaQueryKeys.profile.all> | ReturnType<typeof sifaQueryKeys.profile.byHandle> | ReturnType<typeof sifaQueryKeys.position.all> | ReturnType<typeof sifaQueryKeys.position.byOwner>;
+type SifaQueryKey = ReturnType<typeof sifaQueryKeys.all> | ReturnType<typeof sifaQueryKeys.profile.all> | ReturnType<typeof sifaQueryKeys.profile.byHandle> | ReturnType<typeof sifaQueryKeys.position.all> | ReturnType<typeof sifaQueryKeys.position.byOwner> | ReturnType<typeof sifaQueryKeys.search.all> | ReturnType<typeof sifaQueryKeys.search.profiles> | ReturnType<typeof sifaQueryKeys.search.skills> | ReturnType<typeof sifaQueryKeys.search.filters> | ReturnType<typeof sifaQueryKeys.discovery.all> | ReturnType<typeof sifaQueryKeys.discovery.similar> | ReturnType<typeof sifaQueryKeys.discovery.suggestions> | ReturnType<typeof sifaQueryKeys.discovery.suggestionCount> | ReturnType<typeof sifaQueryKeys.discovery.featured> | ReturnType<typeof sifaQueryKeys.follow.all> | ReturnType<typeof sifaQueryKeys.follow.following>;
 
 /**
  * React hook that reads an aggregated profile by handle or DID via
@@ -165,4 +348,31 @@ type SifaQueryKey = ReturnType<typeof sifaQueryKeys.all> | ReturnType<typeof sif
  */
 declare function useProfile(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<Profile | null, Error, Profile | null, ReturnType<typeof sifaQueryKeys.profile.byHandle>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<Profile | null, Error>;
 
-export { ApiError, type ApiFetchOptions, type CreateResult, type SifaApiConfig, SifaProvider, type SifaProviderProps, type SifaQueryKey, type WriteResult, apiFetch, apiFetchOrNull, createPosition, fetchProfile, sifaQueryKeys, useCreatePosition, useProfile, useSifaConfig };
+/**
+ * React hook for creating a new position record. On success, invalidates
+ * the owner's profile cache so the new position is reflected on the next
+ * read.
+ *
+ * The owner DID is required so the mutation can target the correct
+ * profile cache entry for invalidation.
+ */
+declare function useCreatePosition(ownerDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, Record<string, unknown>>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, Record<string, unknown>, unknown>;
+
+declare function useSearchProfiles(filters: SearchFilters, options?: Omit<UseQueryOptions<SearchResponse, Error, SearchResponse, ReturnType<typeof sifaQueryKeys.search.profiles>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SearchResponse, Error>;
+declare function useSkillSuggestions(query: string, options?: Omit<UseQueryOptions<SkillSearchResult[], Error, SkillSearchResult[], ReturnType<typeof sifaQueryKeys.search.skills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SkillSearchResult[], Error>;
+declare function useSearchFilters(options?: Omit<UseQueryOptions<FilterOptions, Error, FilterOptions, ReturnType<typeof sifaQueryKeys.search.filters>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FilterOptions, Error>;
+
+declare function useSimilarProfiles(did: string | undefined | null, opts?: {
+    limit?: number;
+}, options?: Omit<UseQueryOptions<SimilarProfile[], Error, SimilarProfile[], ReturnType<typeof sifaQueryKeys.discovery.similar>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SimilarProfile[], Error>;
+declare function useSuggestions(opts?: Omit<FetchSuggestionsOptions, keyof Omit<FetchSuggestionsOptions, 'source' | 'includeDismissed' | 'cursor' | 'limit'>>, options?: Omit<UseQueryOptions<SuggestionsResponse, Error, SuggestionsResponse, ReturnType<typeof sifaQueryKeys.discovery.suggestions>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SuggestionsResponse, Error>;
+declare function useSuggestionCount(since?: string, options?: Omit<UseQueryOptions<number, Error, number, ReturnType<typeof sifaQueryKeys.discovery.suggestionCount>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<number, Error>;
+declare function useFeaturedProfile(options?: Omit<UseQueryOptions<FeaturedProfile | null, Error, FeaturedProfile | null, ReturnType<typeof sifaQueryKeys.discovery.featured>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FeaturedProfile | null, Error>;
+
+declare function useFollowing(opts?: {
+    source?: string;
+    cursor?: string;
+    limit?: number;
+}, options?: Omit<UseQueryOptions<FollowingResponse, Error, FollowingResponse, ReturnType<typeof sifaQueryKeys.follow.following>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FollowingResponse, Error>;
+
+export { ApiError, type ApiFetchOptions, type CreateResult, type FeaturedProfile, type FetchSuggestionsOptions, type FilterOptions, type FollowProfile, type FollowingResponse, type ProfileSearchResult, type SearchFilters, type SearchResponse, type SifaApiConfig, SifaProvider, type SifaProviderProps, type SifaQueryKey, type SimilarProfile, type SkillSearchResult, type SuggestionProfile, type SuggestionsResponse, type WriteResult, apiFetch, apiFetchOrNull, createPosition, fetchFeaturedProfile, fetchFollowing, fetchProfile, fetchSearchFilters, fetchSearchProfiles, fetchSimilarProfiles, fetchSkillSuggestions, fetchSuggestionCount, fetchSuggestions, sifaQueryKeys, useCreatePosition, useFeaturedProfile, useFollowing, useProfile, useSearchFilters, useSearchProfiles, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useSuggestionCount, useSuggestions };