@singi-labs/sifa-sdk 0.11.13 → 0.11.14

package/dist/query/hooks/index.d.cts

@@ -1,11 +1,11 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { S as SifaApiConfig, s as sifaQueryKeys, W as WriteResult, a5 as RefreshPdsResult, aj as UpdateProfileOverrideInput, ak as UpdateProfileSelfInput, al as UploadAvatarResult, j as CreateResult, U as ProfileLocationInput, k as ExternalAccountInput, i as CreateExternalAccountResult, am as VerifyExternalAccountResult, E as EndorsementInput, a4 as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, P as HideProfileItemInput, ag as StatsResponse, g as AppRegistryEntry, M as HiddenApp, w as FilterOptions, ab as SearchFilters, ac as SearchResponse, af as SkillSearchResult, l as FeaturedProfile, ae as SimilarProfile, v as FetchSuggestionsOptions, ai as SuggestionsResponse, G as FollowUserResult, o as FetchFollowListOptions, x as FollowListPage, H as FollowingResponse, q as FetchFollowingFeedOptions, p as FetchFollowProfilePageOptions, z as FollowProfilePageResponse, F as FeatureAllowlistResponse, m as FetchActivityFeedOptions, b as ActivityFeedResponse, e as ActivityTeaserResponse, L as HeatmapResponse, a as AccountCheckResult, a3 as ReactionStatus, a2 as ReactionResult, a1 as ReactionError, aa as RoadmapVotesResponse, C as CastRoadmapVoteResult, D as DeleteAccountResult } from '../../keys-K8kCuA5J.cjs';
-export { ad as SifaQueryKey } from '../../keys-K8kCuA5J.cjs';
+import { S as SifaApiConfig, s as sifaQueryKeys, W as WriteResult, a5 as RefreshPdsResult, aj as UpdateProfileOverrideInput, ak as UpdateProfileSelfInput, al as UploadAvatarResult, j as CreateResult, U as ProfileLocationInput, k as ExternalAccountInput, i as CreateExternalAccountResult, am as VerifyExternalAccountResult, E as EndorsementInput, a4 as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, P as HideProfileItemInput, ag as StatsResponse, g as AppRegistryEntry, M as HiddenApp, w as FilterOptions, ab as SearchFilters, ac as SearchResponse, af as SkillSearchResult, l as FeaturedProfile, ae as SimilarProfile, v as FetchSuggestionsOptions, ai as SuggestionsResponse, G as FollowUserResult, o as FetchFollowListOptions, x as FollowListPage, H as FollowingResponse, q as FetchFollowingFeedOptions, p as FetchFollowProfilePageOptions, z as FollowProfilePageResponse, F as FeatureAllowlistResponse, m as FetchActivityFeedOptions, b as ActivityFeedResponse, e as ActivityTeaserResponse, L as HeatmapResponse, a as AccountCheckResult, a3 as ReactionStatus, a2 as ReactionResult, a1 as ReactionError, aa as RoadmapVotesResponse, C as CastRoadmapVoteResult, D as DeleteAccountResult } from '../../keys-DLxYsNCp.cjs';
+export { ad as SifaQueryKey } from '../../keys-DLxYsNCp.cjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseMutationOptions, UseInfiniteQueryOptions, InfiniteData } from '@tanstack/react-query';
 import { d as Profile, t as ProfilePosition, z as SkillRef, E as ExternalAccount, S as SkillSuggestion } from '../../adult-content-BpZD_3ow.cjs';
-import { F as FollowFeedPage, c as FeatureFlag } from '../../feed-DHTy7fUN.cjs';
+import { g as EntitySearchResponse, E as EntitySearchResult, l as EntitySelectResponse, j as EntitySelectRequest, F as FollowFeedPage, c as FeatureFlag } from '../../feed-BaHtJXYR.cjs';
 import 'zod';
 
 interface SifaProviderProps {
@@ -258,6 +258,75 @@ declare function useSkillSuggestions(query: string, options?: Omit<UseQueryOptio
 declare function useCanonicalSkillSearch(query: string, limit?: number, options?: Omit<UseQueryOptions<SkillSuggestion[], Error, SkillSuggestion[], ReturnType<typeof sifaQueryKeys.search.canonicalSkills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SkillSuggestion[]>, Error>;
 declare function useSearchFilters(options?: Omit<UseQueryOptions<FilterOptions, Error, FilterOptions, ReturnType<typeof sifaQueryKeys.search.filters>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<FilterOptions>, Error>;
 
+/** Debounce a rapidly-changing value (e.g. a typeahead input). */
+declare function useDebouncedValue<T>(value: T, delayMs?: number): T;
+interface UseEntitySearchOptions {
+    /** Max rows to request (default 5). */
+    limit?: number;
+    /** Debounce delay in ms (default 250). */
+    debounceMs?: number;
+    enabled?: boolean;
+}
+/**
+ * Debounced organization typeahead. The query is debounced internally, so
+ * consumers can pass the raw input value on every keystroke. Skips the network
+ * call while the (trimmed, debounced) query is empty.
+ */
+declare function useEntitySearch(query: string, opts?: UseEntitySearchOptions, queryOptions?: Omit<UseQueryOptions<EntitySearchResponse, Error, EntitySearchResponse, ReturnType<typeof sifaQueryKeys.entity.search>>, 'queryKey' | 'queryFn' | 'enabled'>): _tanstack_react_query.UseQueryResult<NoInfer<{
+    results: ({
+        kind: string;
+        name: string;
+        domain: string | null;
+        country: string | null;
+        logoUrl: string | null;
+        parentName: string | null;
+        source: "entity";
+        entityId: number;
+    } | {
+        kind: string;
+        name: string;
+        domain: string | null;
+        country: string | null;
+        logoUrl: string | null;
+        parentName: string | null;
+        source: "pdl";
+        pdlId: string;
+    })[];
+    hasMore: boolean;
+}>, Error>;
+/** Mutation: record a selection (promote a PDL row or bump an entity). */
+declare function useSelectEntity(options?: Omit<UseMutationOptions<EntitySelectResponse, Error, EntitySelectRequest>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    entityId: number;
+    slug: string;
+    kind: string;
+    canonicalName: string;
+    domain: string | null;
+    entityRef: string | null;
+}, Error, {
+    entityId?: number | undefined;
+    pdlId?: string | undefined;
+}, unknown>;
+/** Mutation: grow-on-demand Wikidata import for a typeahead miss. */
+declare function useImportSearchEntities(options?: Omit<UseMutationOptions<EntitySearchResult[], Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<({
+    kind: string;
+    name: string;
+    domain: string | null;
+    country: string | null;
+    logoUrl: string | null;
+    parentName: string | null;
+    source: "entity";
+    entityId: number;
+} | {
+    kind: string;
+    name: string;
+    domain: string | null;
+    country: string | null;
+    logoUrl: string | null;
+    parentName: string | null;
+    source: "pdl";
+    pdlId: string;
+})[], Error, string, unknown>;
+
 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<NoInfer<SimilarProfile[]>, Error>;
@@ -487,4 +556,4 @@ declare function useResetProfile(options?: Omit<UseMutationOptions<WriteResult,
  */
 declare function useDeleteAccount(options?: Omit<UseMutationOptions<DeleteAccountResult, Error, boolean>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<DeleteAccountResult, Error, boolean, unknown>;
 
-export { type AddFeatureAllowlistVariables, type CreateReactionVariables, type CreateRecordVariables, type DeleteReactionVariables, type DeleteRecordVariables, type FollowVariables, type PositionSkillLinkVariables, type RemoveFeatureAllowlistVariables, SifaProvider, type SifaProviderProps, type UnfollowVariables, type UpdateEducationVariables, type UpdateExternalAccountVariables, type UpdatePositionVariables, type UpdateProfileLocationVariables, type UpdateRecordVariables, type UpdateSkillVariables, sifaQueryKeys, useActivityFeed, useActivityTeaser, useAddFeatureAllowlist, useAppAccountCheck, useAppsRegistry, useAtFundLink, useBlueskySuggestions, useBulkHideProfileItems, useBulkHideStandardPublications, useBulkUnhideProfileItems, useBulkUnhideStandardPublications, useCanonicalSkillSearch, useCastRoadmapVote, useCreateEducation, useCreateEndorsement, useCreateExternalAccount, useCreatePosition, useCreateProfileLocation, useCreateReaction, useCreateRecord, useCreateSkill, useDeleteAccount, useDeleteAvatarOverride, useDeleteEducation, useDeleteExternalAccount, useDeletePosition, useDeleteProfileLocation, useDeleteReaction, useDeleteRecord, useDeleteSkill, useEndorsementCount, useExternalAccounts, useFeatureAllowlist, useFeaturedProfile, useFollow, useFollowers, useFollowing, useFollowingFeed, useFollowingList, useHeatmapData, useHiddenApps, useHideKeytraceClaim, useHideOrcidPublication, useHideProfileItem, useHideSifaPublication, useHideStandardPublication, useLinkSkillToPosition, useMutuals, useMyRoadmapVotes, useNetworkStreamCount, useProfile, useReactionStatus, useRefreshOrcidPublications, useRefreshPds, useRemoveFeatureAllowlist, useResetProfile, useRetractRoadmapVote, useRevealMarqueDomain, useRoadmapVotes, useSearchFilters, useSearchProfiles, useSetExternalAccountPrimary, useSetPositionPrimary, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useStats, useSuggestionCount, useSuggestions, useUnfollow, useUnhideKeytraceClaim, useUnhideOrcidPublication, useUnhideProfileItem, useUnhideSifaPublication, useUnhideStandardPublication, useUnlinkSkillFromPosition, useUnrevealMarqueDomain, useUnsetExternalAccountPrimary, useUnsetPositionPrimary, useUpdateEducation, useUpdateExternalAccount, useUpdatePosition, useUpdateProfileLocation, useUpdateProfileOverride, useUpdateProfileSelf, useUpdateRecord, useUpdateSkill, useUploadAvatar, useVerifyExternalAccount };
+export { type AddFeatureAllowlistVariables, type CreateReactionVariables, type CreateRecordVariables, type DeleteReactionVariables, type DeleteRecordVariables, type FollowVariables, type PositionSkillLinkVariables, type RemoveFeatureAllowlistVariables, SifaProvider, type SifaProviderProps, type UnfollowVariables, type UpdateEducationVariables, type UpdateExternalAccountVariables, type UpdatePositionVariables, type UpdateProfileLocationVariables, type UpdateRecordVariables, type UpdateSkillVariables, type UseEntitySearchOptions, sifaQueryKeys, useActivityFeed, useActivityTeaser, useAddFeatureAllowlist, useAppAccountCheck, useAppsRegistry, useAtFundLink, useBlueskySuggestions, useBulkHideProfileItems, useBulkHideStandardPublications, useBulkUnhideProfileItems, useBulkUnhideStandardPublications, useCanonicalSkillSearch, useCastRoadmapVote, useCreateEducation, useCreateEndorsement, useCreateExternalAccount, useCreatePosition, useCreateProfileLocation, useCreateReaction, useCreateRecord, useCreateSkill, useDebouncedValue, useDeleteAccount, useDeleteAvatarOverride, useDeleteEducation, useDeleteExternalAccount, useDeletePosition, useDeleteProfileLocation, useDeleteReaction, useDeleteRecord, useDeleteSkill, useEndorsementCount, useEntitySearch, useExternalAccounts, useFeatureAllowlist, useFeaturedProfile, useFollow, useFollowers, useFollowing, useFollowingFeed, useFollowingList, useHeatmapData, useHiddenApps, useHideKeytraceClaim, useHideOrcidPublication, useHideProfileItem, useHideSifaPublication, useHideStandardPublication, useImportSearchEntities, useLinkSkillToPosition, useMutuals, useMyRoadmapVotes, useNetworkStreamCount, useProfile, useReactionStatus, useRefreshOrcidPublications, useRefreshPds, useRemoveFeatureAllowlist, useResetProfile, useRetractRoadmapVote, useRevealMarqueDomain, useRoadmapVotes, useSearchFilters, useSearchProfiles, useSelectEntity, useSetExternalAccountPrimary, useSetPositionPrimary, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useStats, useSuggestionCount, useSuggestions, useUnfollow, useUnhideKeytraceClaim, useUnhideOrcidPublication, useUnhideProfileItem, useUnhideSifaPublication, useUnhideStandardPublication, useUnlinkSkillFromPosition, useUnrevealMarqueDomain, useUnsetExternalAccountPrimary, useUnsetPositionPrimary, useUpdateEducation, useUpdateExternalAccount, useUpdatePosition, useUpdateProfileLocation, useUpdateProfileOverride, useUpdateProfileSelf, useUpdateRecord, useUpdateSkill, useUploadAvatar, useVerifyExternalAccount };

package/dist/query/hooks/index.d.ts

@@ -1,11 +1,11 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { S as SifaApiConfig, s as sifaQueryKeys, W as WriteResult, a5 as RefreshPdsResult, aj as UpdateProfileOverrideInput, ak as UpdateProfileSelfInput, al as UploadAvatarResult, j as CreateResult, U as ProfileLocationInput, k as ExternalAccountInput, i as CreateExternalAccountResult, am as VerifyExternalAccountResult, E as EndorsementInput, a4 as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, P as HideProfileItemInput, ag as StatsResponse, g as AppRegistryEntry, M as HiddenApp, w as FilterOptions, ab as SearchFilters, ac as SearchResponse, af as SkillSearchResult, l as FeaturedProfile, ae as SimilarProfile, v as FetchSuggestionsOptions, ai as SuggestionsResponse, G as FollowUserResult, o as FetchFollowListOptions, x as FollowListPage, H as FollowingResponse, q as FetchFollowingFeedOptions, p as FetchFollowProfilePageOptions, z as FollowProfilePageResponse, F as FeatureAllowlistResponse, m as FetchActivityFeedOptions, b as ActivityFeedResponse, e as ActivityTeaserResponse, L as HeatmapResponse, a as AccountCheckResult, a3 as ReactionStatus, a2 as ReactionResult, a1 as ReactionError, aa as RoadmapVotesResponse, C as CastRoadmapVoteResult, D as DeleteAccountResult } from '../../keys-DuICaiIq.js';
-export { ad as SifaQueryKey } from '../../keys-DuICaiIq.js';
+import { S as SifaApiConfig, s as sifaQueryKeys, W as WriteResult, a5 as RefreshPdsResult, aj as UpdateProfileOverrideInput, ak as UpdateProfileSelfInput, al as UploadAvatarResult, j as CreateResult, U as ProfileLocationInput, k as ExternalAccountInput, i as CreateExternalAccountResult, am as VerifyExternalAccountResult, E as EndorsementInput, a4 as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, P as HideProfileItemInput, ag as StatsResponse, g as AppRegistryEntry, M as HiddenApp, w as FilterOptions, ab as SearchFilters, ac as SearchResponse, af as SkillSearchResult, l as FeaturedProfile, ae as SimilarProfile, v as FetchSuggestionsOptions, ai as SuggestionsResponse, G as FollowUserResult, o as FetchFollowListOptions, x as FollowListPage, H as FollowingResponse, q as FetchFollowingFeedOptions, p as FetchFollowProfilePageOptions, z as FollowProfilePageResponse, F as FeatureAllowlistResponse, m as FetchActivityFeedOptions, b as ActivityFeedResponse, e as ActivityTeaserResponse, L as HeatmapResponse, a as AccountCheckResult, a3 as ReactionStatus, a2 as ReactionResult, a1 as ReactionError, aa as RoadmapVotesResponse, C as CastRoadmapVoteResult, D as DeleteAccountResult } from '../../keys-C0AracRc.js';
+export { ad as SifaQueryKey } from '../../keys-C0AracRc.js';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseMutationOptions, UseInfiniteQueryOptions, InfiniteData } from '@tanstack/react-query';
 import { d as Profile, t as ProfilePosition, z as SkillRef, E as ExternalAccount, S as SkillSuggestion } from '../../adult-content-BpZD_3ow.js';
-import { F as FollowFeedPage, c as FeatureFlag } from '../../feed-DHTy7fUN.js';
+import { g as EntitySearchResponse, E as EntitySearchResult, l as EntitySelectResponse, j as EntitySelectRequest, F as FollowFeedPage, c as FeatureFlag } from '../../feed-BaHtJXYR.js';
 import 'zod';
 
 interface SifaProviderProps {
@@ -258,6 +258,75 @@ declare function useSkillSuggestions(query: string, options?: Omit<UseQueryOptio
 declare function useCanonicalSkillSearch(query: string, limit?: number, options?: Omit<UseQueryOptions<SkillSuggestion[], Error, SkillSuggestion[], ReturnType<typeof sifaQueryKeys.search.canonicalSkills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SkillSuggestion[]>, Error>;
 declare function useSearchFilters(options?: Omit<UseQueryOptions<FilterOptions, Error, FilterOptions, ReturnType<typeof sifaQueryKeys.search.filters>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<FilterOptions>, Error>;
 
+/** Debounce a rapidly-changing value (e.g. a typeahead input). */
+declare function useDebouncedValue<T>(value: T, delayMs?: number): T;
+interface UseEntitySearchOptions {
+    /** Max rows to request (default 5). */
+    limit?: number;
+    /** Debounce delay in ms (default 250). */
+    debounceMs?: number;
+    enabled?: boolean;
+}
+/**
+ * Debounced organization typeahead. The query is debounced internally, so
+ * consumers can pass the raw input value on every keystroke. Skips the network
+ * call while the (trimmed, debounced) query is empty.
+ */
+declare function useEntitySearch(query: string, opts?: UseEntitySearchOptions, queryOptions?: Omit<UseQueryOptions<EntitySearchResponse, Error, EntitySearchResponse, ReturnType<typeof sifaQueryKeys.entity.search>>, 'queryKey' | 'queryFn' | 'enabled'>): _tanstack_react_query.UseQueryResult<NoInfer<{
+    results: ({
+        kind: string;
+        name: string;
+        domain: string | null;
+        country: string | null;
+        logoUrl: string | null;
+        parentName: string | null;
+        source: "entity";
+        entityId: number;
+    } | {
+        kind: string;
+        name: string;
+        domain: string | null;
+        country: string | null;
+        logoUrl: string | null;
+        parentName: string | null;
+        source: "pdl";
+        pdlId: string;
+    })[];
+    hasMore: boolean;
+}>, Error>;
+/** Mutation: record a selection (promote a PDL row or bump an entity). */
+declare function useSelectEntity(options?: Omit<UseMutationOptions<EntitySelectResponse, Error, EntitySelectRequest>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    entityId: number;
+    slug: string;
+    kind: string;
+    canonicalName: string;
+    domain: string | null;
+    entityRef: string | null;
+}, Error, {
+    entityId?: number | undefined;
+    pdlId?: string | undefined;
+}, unknown>;
+/** Mutation: grow-on-demand Wikidata import for a typeahead miss. */
+declare function useImportSearchEntities(options?: Omit<UseMutationOptions<EntitySearchResult[], Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<({
+    kind: string;
+    name: string;
+    domain: string | null;
+    country: string | null;
+    logoUrl: string | null;
+    parentName: string | null;
+    source: "entity";
+    entityId: number;
+} | {
+    kind: string;
+    name: string;
+    domain: string | null;
+    country: string | null;
+    logoUrl: string | null;
+    parentName: string | null;
+    source: "pdl";
+    pdlId: string;
+})[], Error, string, unknown>;
+
 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<NoInfer<SimilarProfile[]>, Error>;
@@ -487,4 +556,4 @@ declare function useResetProfile(options?: Omit<UseMutationOptions<WriteResult,
  */
 declare function useDeleteAccount(options?: Omit<UseMutationOptions<DeleteAccountResult, Error, boolean>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<DeleteAccountResult, Error, boolean, unknown>;
 
-export { type AddFeatureAllowlistVariables, type CreateReactionVariables, type CreateRecordVariables, type DeleteReactionVariables, type DeleteRecordVariables, type FollowVariables, type PositionSkillLinkVariables, type RemoveFeatureAllowlistVariables, SifaProvider, type SifaProviderProps, type UnfollowVariables, type UpdateEducationVariables, type UpdateExternalAccountVariables, type UpdatePositionVariables, type UpdateProfileLocationVariables, type UpdateRecordVariables, type UpdateSkillVariables, sifaQueryKeys, useActivityFeed, useActivityTeaser, useAddFeatureAllowlist, useAppAccountCheck, useAppsRegistry, useAtFundLink, useBlueskySuggestions, useBulkHideProfileItems, useBulkHideStandardPublications, useBulkUnhideProfileItems, useBulkUnhideStandardPublications, useCanonicalSkillSearch, useCastRoadmapVote, useCreateEducation, useCreateEndorsement, useCreateExternalAccount, useCreatePosition, useCreateProfileLocation, useCreateReaction, useCreateRecord, useCreateSkill, useDeleteAccount, useDeleteAvatarOverride, useDeleteEducation, useDeleteExternalAccount, useDeletePosition, useDeleteProfileLocation, useDeleteReaction, useDeleteRecord, useDeleteSkill, useEndorsementCount, useExternalAccounts, useFeatureAllowlist, useFeaturedProfile, useFollow, useFollowers, useFollowing, useFollowingFeed, useFollowingList, useHeatmapData, useHiddenApps, useHideKeytraceClaim, useHideOrcidPublication, useHideProfileItem, useHideSifaPublication, useHideStandardPublication, useLinkSkillToPosition, useMutuals, useMyRoadmapVotes, useNetworkStreamCount, useProfile, useReactionStatus, useRefreshOrcidPublications, useRefreshPds, useRemoveFeatureAllowlist, useResetProfile, useRetractRoadmapVote, useRevealMarqueDomain, useRoadmapVotes, useSearchFilters, useSearchProfiles, useSetExternalAccountPrimary, useSetPositionPrimary, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useStats, useSuggestionCount, useSuggestions, useUnfollow, useUnhideKeytraceClaim, useUnhideOrcidPublication, useUnhideProfileItem, useUnhideSifaPublication, useUnhideStandardPublication, useUnlinkSkillFromPosition, useUnrevealMarqueDomain, useUnsetExternalAccountPrimary, useUnsetPositionPrimary, useUpdateEducation, useUpdateExternalAccount, useUpdatePosition, useUpdateProfileLocation, useUpdateProfileOverride, useUpdateProfileSelf, useUpdateRecord, useUpdateSkill, useUploadAvatar, useVerifyExternalAccount };
+export { type AddFeatureAllowlistVariables, type CreateReactionVariables, type CreateRecordVariables, type DeleteReactionVariables, type DeleteRecordVariables, type FollowVariables, type PositionSkillLinkVariables, type RemoveFeatureAllowlistVariables, SifaProvider, type SifaProviderProps, type UnfollowVariables, type UpdateEducationVariables, type UpdateExternalAccountVariables, type UpdatePositionVariables, type UpdateProfileLocationVariables, type UpdateRecordVariables, type UpdateSkillVariables, type UseEntitySearchOptions, sifaQueryKeys, useActivityFeed, useActivityTeaser, useAddFeatureAllowlist, useAppAccountCheck, useAppsRegistry, useAtFundLink, useBlueskySuggestions, useBulkHideProfileItems, useBulkHideStandardPublications, useBulkUnhideProfileItems, useBulkUnhideStandardPublications, useCanonicalSkillSearch, useCastRoadmapVote, useCreateEducation, useCreateEndorsement, useCreateExternalAccount, useCreatePosition, useCreateProfileLocation, useCreateReaction, useCreateRecord, useCreateSkill, useDebouncedValue, useDeleteAccount, useDeleteAvatarOverride, useDeleteEducation, useDeleteExternalAccount, useDeletePosition, useDeleteProfileLocation, useDeleteReaction, useDeleteRecord, useDeleteSkill, useEndorsementCount, useEntitySearch, useExternalAccounts, useFeatureAllowlist, useFeaturedProfile, useFollow, useFollowers, useFollowing, useFollowingFeed, useFollowingList, useHeatmapData, useHiddenApps, useHideKeytraceClaim, useHideOrcidPublication, useHideProfileItem, useHideSifaPublication, useHideStandardPublication, useImportSearchEntities, useLinkSkillToPosition, useMutuals, useMyRoadmapVotes, useNetworkStreamCount, useProfile, useReactionStatus, useRefreshOrcidPublications, useRefreshPds, useRemoveFeatureAllowlist, useResetProfile, useRetractRoadmapVote, useRevealMarqueDomain, useRoadmapVotes, useSearchFilters, useSearchProfiles, useSelectEntity, useSetExternalAccountPrimary, useSetPositionPrimary, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useStats, useSuggestionCount, useSuggestions, useUnfollow, useUnhideKeytraceClaim, useUnhideOrcidPublication, useUnhideProfileItem, useUnhideSifaPublication, useUnhideStandardPublication, useUnlinkSkillFromPosition, useUnrevealMarqueDomain, useUnsetExternalAccountPrimary, useUnsetPositionPrimary, useUpdateEducation, useUpdateExternalAccount, useUpdatePosition, useUpdateProfileLocation, useUpdateProfileOverride, useUpdateProfileSelf, useUpdateRecord, useUpdateSkill, useUploadAvatar, useVerifyExternalAccount };

package/dist/query/hooks/index.js

@@ -1,6 +1,7 @@
-import { createContext, useContext } from 'react';
+import { createContext, useContext, useState, useEffect } from 'react';
 import { jsx } from 'react/jsx-runtime';
 import { useQuery, useQueryClient, useMutation, useInfiniteQuery } from '@tanstack/react-query';
+import { z } from 'zod';
 
 // src/query/config.tsx
 var SifaConfigContext = createContext(null);
@@ -167,6 +168,10 @@ var sifaQueryKeys = {
     canonicalSkills: (query, limit) => ["sifa", "search", "canonical-skills", query, limit],
     filters: () => ["sifa", "search", "filters"]
   },
+  entity: {
+    all: () => ["sifa", "entity"],
+    search: (query, limit) => ["sifa", "entity", "search", query, limit]
+  },
   discovery: {
     all: () => ["sifa", "discovery"],
     similar: (did, limit) => ["sifa", "discovery", "similar", did, limit],
@@ -2270,7 +2275,116 @@ function useDeleteAccount(options) {
     ...options
   });
 }
+var httpUrlNullable = z.string().refine((s) => /^https?:\/\//i.test(s), { message: "must be an http(s) URL" }).nullable();
+var searchResultCommon = {
+  kind: z.string(),
+  name: z.string(),
+  domain: z.string().nullable(),
+  country: z.string().nullable(),
+  logoUrl: httpUrlNullable,
+  parentName: z.string().nullable()
+};
+var EntitySearchResultSchema = z.discriminatedUnion("source", [
+  z.object({
+    source: z.literal("entity"),
+    entityId: z.number().int().positive(),
+    ...searchResultCommon
+  }),
+  z.object({
+    source: z.literal("pdl"),
+    pdlId: z.string().min(1),
+    ...searchResultCommon
+  })
+]);
+var EntitySearchResponseSchema = z.object({
+  results: z.array(EntitySearchResultSchema),
+  hasMore: z.boolean()
+});
+z.object({
+  entityId: z.number().int().positive().optional(),
+  pdlId: z.string().min(1).optional()
+}).refine((v) => v.entityId != null !== (v.pdlId != null), {
+  message: "exactly one of entityId or pdlId is required"
+});
+var EntitySelectResponseSchema = z.object({
+  entityId: z.number().int().positive(),
+  slug: z.string(),
+  kind: z.string(),
+  canonicalName: z.string(),
+  domain: z.string().nullable(),
+  entityRef: httpUrlNullable
+});
+var EntityImportSearchResponseSchema = z.object({
+  results: z.array(EntitySearchResultSchema)
+});
+
+// src/query/fetchers/entities.ts
+var EMPTY_SEARCH2 = { results: [], hasMore: false };
+async function fetchEntitySearch(config, query, limit, options = {}) {
+  if (!query.trim()) return EMPTY_SEARCH2;
+  const params = new URLSearchParams({ q: query });
+  if (limit !== void 0) params.set("limit", String(limit));
+  const data = await apiFetch(config, `/api/entities/search?${params.toString()}`, {
+    cache: "no-store",
+    ...options
+  });
+  return EntitySearchResponseSchema.parse(data);
+}
+async function selectEntity(config, body, options = {}) {
+  const data = await apiFetch(config, "/api/entities/select", {
+    method: "POST",
+    body,
+    credentials: "include",
+    ...options
+  });
+  return EntitySelectResponseSchema.parse(data);
+}
+async function importSearchEntities(config, query, options = {}) {
+  if (!query.trim()) return [];
+  const data = await apiFetch(config, "/api/entities/import-search", {
+    method: "POST",
+    body: { q: query },
+    credentials: "include",
+    ...options
+  });
+  return EntityImportSearchResponseSchema.parse(data).results;
+}
+
+// src/query/hooks/use-entity-search.ts
+function useDebouncedValue(value, delayMs = 250) {
+  const [debounced, setDebounced] = useState(value);
+  useEffect(() => {
+    const timer = setTimeout(() => setDebounced(value), delayMs);
+    return () => clearTimeout(timer);
+  }, [value, delayMs]);
+  return debounced;
+}
+function useEntitySearch(query, opts = {}, queryOptions) {
+  const config = useSifaConfig();
+  const { limit = 5, debounceMs = 250, enabled = true } = opts;
+  const debounced = useDebouncedValue(query.trim(), debounceMs);
+  return useQuery({
+    queryKey: sifaQueryKeys.entity.search(debounced, limit),
+    queryFn: () => fetchEntitySearch(config, debounced, limit),
+    enabled: enabled && debounced.length > 0,
+    ...queryOptions
+  });
+}
+function useSelectEntity(options) {
+  const config = useSifaConfig();
+  return useMutation({
+    mutationFn: (body) => selectEntity(config, body),
+    ...options
+  });
+}
+function useImportSearchEntities(options) {
+  const config = useSifaConfig();
+  return useMutation({
+    mutationFn: (query) => importSearchEntities(config, query),
+    ...options
+  });
+}
 
-export { SifaProvider, sifaQueryKeys, useActivityFeed, useActivityTeaser, useAddFeatureAllowlist, useAppAccountCheck, useAppsRegistry, useAtFundLink, useBlueskySuggestions, useBulkHideProfileItems, useBulkHideStandardPublications, useBulkUnhideProfileItems, useBulkUnhideStandardPublications, useCanonicalSkillSearch, useCastRoadmapVote, useCreateEducation, useCreateEndorsement, useCreateExternalAccount, useCreatePosition, useCreateProfileLocation, useCreateReaction, useCreateRecord, useCreateSkill, useDeleteAccount, useDeleteAvatarOverride, useDeleteEducation, useDeleteExternalAccount, useDeletePosition, useDeleteProfileLocation, useDeleteReaction, useDeleteRecord, useDeleteSkill, useEndorsementCount, useExternalAccounts, useFeatureAllowlist, useFeaturedProfile, useFollow, useFollowers, useFollowing, useFollowingFeed, useFollowingList, useHeatmapData, useHiddenApps, useHideKeytraceClaim, useHideOrcidPublication, useHideProfileItem, useHideSifaPublication, useHideStandardPublication, useLinkSkillToPosition, useMutuals, useMyRoadmapVotes, useNetworkStreamCount, useProfile, useReactionStatus, useRefreshOrcidPublications, useRefreshPds, useRemoveFeatureAllowlist, useResetProfile, useRetractRoadmapVote, useRevealMarqueDomain, useRoadmapVotes, useSearchFilters, useSearchProfiles, useSetExternalAccountPrimary, useSetPositionPrimary, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useStats, useSuggestionCount, useSuggestions, useUnfollow, useUnhideKeytraceClaim, useUnhideOrcidPublication, useUnhideProfileItem, useUnhideSifaPublication, useUnhideStandardPublication, useUnlinkSkillFromPosition, useUnrevealMarqueDomain, useUnsetExternalAccountPrimary, useUnsetPositionPrimary, useUpdateEducation, useUpdateExternalAccount, useUpdatePosition, useUpdateProfileLocation, useUpdateProfileOverride, useUpdateProfileSelf, useUpdateRecord, useUpdateSkill, useUploadAvatar, useVerifyExternalAccount };
+export { SifaProvider, sifaQueryKeys, useActivityFeed, useActivityTeaser, useAddFeatureAllowlist, useAppAccountCheck, useAppsRegistry, useAtFundLink, useBlueskySuggestions, useBulkHideProfileItems, useBulkHideStandardPublications, useBulkUnhideProfileItems, useBulkUnhideStandardPublications, useCanonicalSkillSearch, useCastRoadmapVote, useCreateEducation, useCreateEndorsement, useCreateExternalAccount, useCreatePosition, useCreateProfileLocation, useCreateReaction, useCreateRecord, useCreateSkill, useDebouncedValue, useDeleteAccount, useDeleteAvatarOverride, useDeleteEducation, useDeleteExternalAccount, useDeletePosition, useDeleteProfileLocation, useDeleteReaction, useDeleteRecord, useDeleteSkill, useEndorsementCount, useEntitySearch, useExternalAccounts, useFeatureAllowlist, useFeaturedProfile, useFollow, useFollowers, useFollowing, useFollowingFeed, useFollowingList, useHeatmapData, useHiddenApps, useHideKeytraceClaim, useHideOrcidPublication, useHideProfileItem, useHideSifaPublication, useHideStandardPublication, useImportSearchEntities, useLinkSkillToPosition, useMutuals, useMyRoadmapVotes, useNetworkStreamCount, useProfile, useReactionStatus, useRefreshOrcidPublications, useRefreshPds, useRemoveFeatureAllowlist, useResetProfile, useRetractRoadmapVote, useRevealMarqueDomain, useRoadmapVotes, useSearchFilters, useSearchProfiles, useSelectEntity, useSetExternalAccountPrimary, useSetPositionPrimary, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useStats, useSuggestionCount, useSuggestions, useUnfollow, useUnhideKeytraceClaim, useUnhideOrcidPublication, useUnhideProfileItem, useUnhideSifaPublication, useUnhideStandardPublication, useUnlinkSkillFromPosition, useUnrevealMarqueDomain, useUnsetExternalAccountPrimary, useUnsetPositionPrimary, useUpdateEducation, useUpdateExternalAccount, useUpdatePosition, useUpdateProfileLocation, useUpdateProfileOverride, useUpdateProfileSelf, useUpdateRecord, useUpdateSkill, useUploadAvatar, useVerifyExternalAccount };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map