@singi-labs/sifa-sdk 0.11.13 → 0.11.15

package/dist/query/hooks/index.cjs

@@ -3,6 +3,7 @@
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 var reactQuery = require('@tanstack/react-query');
+var zod = require('zod');
 
 // src/query/config.tsx
 var SifaConfigContext = react.createContext(null);
@@ -169,6 +170,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],
@@ -2272,6 +2277,115 @@ function useDeleteAccount(options) {
     ...options
   });
 }
+var httpUrlNullable = zod.z.string().refine((s) => /^https?:\/\//i.test(s), { message: "must be an http(s) URL" }).nullable();
+var searchResultCommon = {
+  kind: zod.z.string(),
+  name: zod.z.string(),
+  domain: zod.z.string().nullable(),
+  country: zod.z.string().nullable(),
+  logoUrl: httpUrlNullable,
+  parentName: zod.z.string().nullable()
+};
+var EntitySearchResultSchema = zod.z.discriminatedUnion("source", [
+  zod.z.object({
+    source: zod.z.literal("entity"),
+    entityId: zod.z.number().int().positive(),
+    ...searchResultCommon
+  }),
+  zod.z.object({
+    source: zod.z.literal("pdl"),
+    pdlId: zod.z.string().min(1),
+    ...searchResultCommon
+  })
+]);
+var EntitySearchResponseSchema = zod.z.object({
+  results: zod.z.array(EntitySearchResultSchema),
+  hasMore: zod.z.boolean()
+});
+zod.z.object({
+  entityId: zod.z.number().int().positive().optional(),
+  pdlId: zod.z.string().min(1).optional()
+}).refine((v) => v.entityId != null !== (v.pdlId != null), {
+  message: "exactly one of entityId or pdlId is required"
+});
+var EntitySelectResponseSchema = zod.z.object({
+  entityId: zod.z.number().int().positive(),
+  slug: zod.z.string(),
+  kind: zod.z.string(),
+  canonicalName: zod.z.string(),
+  domain: zod.z.string().nullable(),
+  entityRef: httpUrlNullable
+});
+var EntityImportSearchResponseSchema = zod.z.object({
+  results: zod.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] = react.useState(value);
+  react.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 reactQuery.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 reactQuery.useMutation({
+    mutationFn: (body) => selectEntity(config, body),
+    ...options
+  });
+}
+function useImportSearchEntities(options) {
+  const config = useSifaConfig();
+  return reactQuery.useMutation({
+    mutationFn: (query) => importSearchEntities(config, query),
+    ...options
+  });
+}
 
 exports.SifaProvider = SifaProvider;
 exports.sifaQueryKeys = sifaQueryKeys;
@@ -2296,6 +2410,7 @@ exports.useCreateProfileLocation = useCreateProfileLocation;
 exports.useCreateReaction = useCreateReaction;
 exports.useCreateRecord = useCreateRecord;
 exports.useCreateSkill = useCreateSkill;
+exports.useDebouncedValue = useDebouncedValue;
 exports.useDeleteAccount = useDeleteAccount;
 exports.useDeleteAvatarOverride = useDeleteAvatarOverride;
 exports.useDeleteEducation = useDeleteEducation;
@@ -2306,6 +2421,7 @@ exports.useDeleteReaction = useDeleteReaction;
 exports.useDeleteRecord = useDeleteRecord;
 exports.useDeleteSkill = useDeleteSkill;
 exports.useEndorsementCount = useEndorsementCount;
+exports.useEntitySearch = useEntitySearch;
 exports.useExternalAccounts = useExternalAccounts;
 exports.useFeatureAllowlist = useFeatureAllowlist;
 exports.useFeaturedProfile = useFeaturedProfile;
@@ -2321,6 +2437,7 @@ exports.useHideOrcidPublication = useHideOrcidPublication;
 exports.useHideProfileItem = useHideProfileItem;
 exports.useHideSifaPublication = useHideSifaPublication;
 exports.useHideStandardPublication = useHideStandardPublication;
+exports.useImportSearchEntities = useImportSearchEntities;
 exports.useLinkSkillToPosition = useLinkSkillToPosition;
 exports.useMutuals = useMutuals;
 exports.useMyRoadmapVotes = useMyRoadmapVotes;
@@ -2336,6 +2453,7 @@ exports.useRevealMarqueDomain = useRevealMarqueDomain;
 exports.useRoadmapVotes = useRoadmapVotes;
 exports.useSearchFilters = useSearchFilters;
 exports.useSearchProfiles = useSearchProfiles;
+exports.useSelectEntity = useSelectEntity;
 exports.useSetExternalAccountPrimary = useSetExternalAccountPrimary;
 exports.useSetPositionPrimary = useSetPositionPrimary;
 exports.useSifaConfig = useSifaConfig;