@singi-labs/sifa-sdk 0.19.61 → 0.19.63

package/dist/rpg/index.d.cts

@@ -24,8 +24,12 @@ declare const RpgItemSchema: z.ZodObject<{
     kind: z.ZodEnum<{
         layer: "layer";
         held: "held";
+        overlay: "overlay";
     }>;
     category: z.ZodString;
+    channels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    assetCid: z.ZodString;
+    iconCid: z.ZodString;
     unlock: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"hasRecord">;
         collection: z.ZodEnum<{
@@ -48,8 +52,8 @@ declare const RpgItemSchema: z.ZodObject<{
 type RpgItem = z.infer<typeof RpgItemSchema>;
 type RpgUnlock = z.infer<typeof RpgUnlockSchema>;
 /**
- * The Sifa item catalog for rpg.actor. PLACEHOLDER titles/categories until
- * rpg.actor transfers the real item cores.
+ * The Sifa item catalog for rpg.actor. Ids, titles, descriptions, kinds,
+ * categories, channels and image CIDs come from rpg.actor's item cores.
  */
 declare const RPG_ITEMS: readonly RpgItem[];
 
@@ -71,4 +75,21 @@ interface RpgUnlockResult {
 /** Evaluate every enabled item (ANY matching unlock earns it); disabled items are omitted. */
 declare function evaluateRpgUnlocks(signals: RpgUnlockSignals, items?: readonly RpgItem[]): RpgUnlockResult[];
 
-export { RPG_ITEMS, type RpgItem, RpgItemSchema, type RpgUnlock, type RpgUnlockResult, RpgUnlockSchema, type RpgUnlockSignals, evaluateRpgUnlocks };
+/** Base URL of rpg.actor. */
+declare const RPG_ACTOR_URL = "https://rpg.actor";
+/**
+ * Record key of the `equipment.rpg.give` Sifa writes for an item. rpg.actor
+ * stores the accepted `equipment.rpg.item` under the same key, so this also
+ * identifies the item in the player's own account.
+ *
+ * The DID is used as-is: AT Protocol record keys allow `A-Za-z0-9 . - _ : ~`
+ * (https://atproto.com/specs/record-key), so the colons in `did:plc:` are
+ * valid. The format is already live in written gift records; do not change it.
+ */
+declare function rpgGiveRkey(itemId: string, recipientDid: string): string;
+/** The player's character page on rpg.actor, where pending gifts can be accepted. */
+declare function rpgActorCharacterUrl(handleOrDid: string): string;
+/** Deep link that opens the Wear action for an accepted Sifa item on the character page. */
+declare function rpgActorWearUrl(handleOrDid: string, itemId: string, recipientDid: string): string;
+
+export { RPG_ACTOR_URL, RPG_ITEMS, type RpgItem, RpgItemSchema, type RpgUnlock, type RpgUnlockResult, RpgUnlockSchema, type RpgUnlockSignals, evaluateRpgUnlocks, rpgActorCharacterUrl, rpgActorWearUrl, rpgGiveRkey };

package/dist/rpg/index.d.ts

@@ -24,8 +24,12 @@ declare const RpgItemSchema: z.ZodObject<{
     kind: z.ZodEnum<{
         layer: "layer";
         held: "held";
+        overlay: "overlay";
     }>;
     category: z.ZodString;
+    channels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    assetCid: z.ZodString;
+    iconCid: z.ZodString;
     unlock: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"hasRecord">;
         collection: z.ZodEnum<{
@@ -48,8 +52,8 @@ declare const RpgItemSchema: z.ZodObject<{
 type RpgItem = z.infer<typeof RpgItemSchema>;
 type RpgUnlock = z.infer<typeof RpgUnlockSchema>;
 /**
- * The Sifa item catalog for rpg.actor. PLACEHOLDER titles/categories until
- * rpg.actor transfers the real item cores.
+ * The Sifa item catalog for rpg.actor. Ids, titles, descriptions, kinds,
+ * categories, channels and image CIDs come from rpg.actor's item cores.
  */
 declare const RPG_ITEMS: readonly RpgItem[];
 
@@ -71,4 +75,21 @@ interface RpgUnlockResult {
 /** Evaluate every enabled item (ANY matching unlock earns it); disabled items are omitted. */
 declare function evaluateRpgUnlocks(signals: RpgUnlockSignals, items?: readonly RpgItem[]): RpgUnlockResult[];
 
-export { RPG_ITEMS, type RpgItem, RpgItemSchema, type RpgUnlock, type RpgUnlockResult, RpgUnlockSchema, type RpgUnlockSignals, evaluateRpgUnlocks };
+/** Base URL of rpg.actor. */
+declare const RPG_ACTOR_URL = "https://rpg.actor";
+/**
+ * Record key of the `equipment.rpg.give` Sifa writes for an item. rpg.actor
+ * stores the accepted `equipment.rpg.item` under the same key, so this also
+ * identifies the item in the player's own account.
+ *
+ * The DID is used as-is: AT Protocol record keys allow `A-Za-z0-9 . - _ : ~`
+ * (https://atproto.com/specs/record-key), so the colons in `did:plc:` are
+ * valid. The format is already live in written gift records; do not change it.
+ */
+declare function rpgGiveRkey(itemId: string, recipientDid: string): string;
+/** The player's character page on rpg.actor, where pending gifts can be accepted. */
+declare function rpgActorCharacterUrl(handleOrDid: string): string;
+/** Deep link that opens the Wear action for an accepted Sifa item on the character page. */
+declare function rpgActorWearUrl(handleOrDid: string, itemId: string, recipientDid: string): string;
+
+export { RPG_ACTOR_URL, RPG_ITEMS, type RpgItem, RpgItemSchema, type RpgUnlock, type RpgUnlockResult, RpgUnlockSchema, type RpgUnlockSignals, evaluateRpgUnlocks, rpgActorCharacterUrl, rpgActorWearUrl, rpgGiveRkey };

package/dist/rpg/index.js

@@ -5,10 +5,15 @@ import {
   RpgUnlockSchema
 } from "./catalog.js";
 import { evaluateRpgUnlocks } from "./unlocks.js";
+import { RPG_ACTOR_URL, rpgActorCharacterUrl, rpgActorWearUrl, rpgGiveRkey } from "./links.js";
 export {
+  RPG_ACTOR_URL,
   RPG_ITEMS,
   RpgItemSchema,
   RpgUnlockSchema,
-  evaluateRpgUnlocks
+  evaluateRpgUnlocks,
+  rpgActorCharacterUrl,
+  rpgActorWearUrl,
+  rpgGiveRkey
 };
 //# sourceMappingURL=index.js.map

package/dist/rpg/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/rpg/index.ts"],"sourcesContent":["/**\n * `@singi-labs/sifa-sdk/rpg` -- the Sifa item catalog for rpg.actor and the\n * pure predicate that decides which items a profile has earned. No network\n * calls; safe to import anywhere.\n */\nexport {\n  RPG_ITEMS,\n  RpgItemSchema,\n  RpgUnlockSchema,\n  type RpgItem,\n  type RpgUnlock,\n} from './catalog.js';\nexport { evaluateRpgUnlocks, type RpgUnlockResult, type RpgUnlockSignals } from './unlocks.js';\n"],"mappings":";AAKA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,0BAAuE;","names":[]}
+{"version":3,"sources":["../../src/rpg/index.ts"],"sourcesContent":["/**\n * `@singi-labs/sifa-sdk/rpg` -- the Sifa item catalog for rpg.actor and the\n * pure predicate that decides which items a profile has earned. No network\n * calls; safe to import anywhere.\n */\nexport {\n  RPG_ITEMS,\n  RpgItemSchema,\n  RpgUnlockSchema,\n  type RpgItem,\n  type RpgUnlock,\n} from './catalog.js';\nexport { evaluateRpgUnlocks, type RpgUnlockResult, type RpgUnlockSignals } from './unlocks.js';\nexport { RPG_ACTOR_URL, rpgActorCharacterUrl, rpgActorWearUrl, rpgGiveRkey } from './links.js';\n"],"mappings":";AAKA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,0BAAuE;AAChF,SAAS,eAAe,sBAAsB,iBAAiB,mBAAmB;","names":[]}

package/dist/rpg/links.js

@@ -0,0 +1,18 @@
+// src/rpg/links.ts
+var RPG_ACTOR_URL = "https://rpg.actor";
+function rpgGiveRkey(itemId, recipientDid) {
+  return `sifa-${itemId}-${recipientDid}`;
+}
+function rpgActorCharacterUrl(handleOrDid) {
+  return `${RPG_ACTOR_URL}/${encodeURIComponent(handleOrDid.replace(/^@+/, ""))}`;
+}
+function rpgActorWearUrl(handleOrDid, itemId, recipientDid) {
+  return `${rpgActorCharacterUrl(handleOrDid)}?wear=${encodeURIComponent(rpgGiveRkey(itemId, recipientDid))}`;
+}
+export {
+  RPG_ACTOR_URL,
+  rpgActorCharacterUrl,
+  rpgActorWearUrl,
+  rpgGiveRkey
+};
+//# sourceMappingURL=links.js.map

package/dist/rpg/links.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/rpg/links.ts"],"sourcesContent":["/** Base URL of rpg.actor. */\nexport const RPG_ACTOR_URL = 'https://rpg.actor';\n\n/**\n * Record key of the `equipment.rpg.give` Sifa writes for an item. rpg.actor\n * stores the accepted `equipment.rpg.item` under the same key, so this also\n * identifies the item in the player's own account.\n *\n * The DID is used as-is: AT Protocol record keys allow `A-Za-z0-9 . - _ : ~`\n * (https://atproto.com/specs/record-key), so the colons in `did:plc:` are\n * valid. The format is already live in written gift records; do not change it.\n */\nexport function rpgGiveRkey(itemId: string, recipientDid: string): string {\n  return `sifa-${itemId}-${recipientDid}`;\n}\n\n/** The player's character page on rpg.actor, where pending gifts can be accepted. */\nexport function rpgActorCharacterUrl(handleOrDid: string): string {\n  return `${RPG_ACTOR_URL}/${encodeURIComponent(handleOrDid.replace(/^@+/, ''))}`;\n}\n\n/** Deep link that opens the Wear action for an accepted Sifa item on the character page. */\nexport function rpgActorWearUrl(handleOrDid: string, itemId: string, recipientDid: string): string {\n  return `${rpgActorCharacterUrl(handleOrDid)}?wear=${encodeURIComponent(rpgGiveRkey(itemId, recipientDid))}`;\n}\n"],"mappings":";AACO,IAAM,gBAAgB;AAWtB,SAAS,YAAY,QAAgB,cAA8B;AACxE,SAAO,QAAQ,MAAM,IAAI,YAAY;AACvC;AAGO,SAAS,qBAAqB,aAA6B;AAChE,SAAO,GAAG,aAAa,IAAI,mBAAmB,YAAY,QAAQ,OAAO,EAAE,CAAC,CAAC;AAC/E;AAGO,SAAS,gBAAgB,aAAqB,QAAgB,cAA8B;AACjG,SAAO,GAAG,qBAAqB,WAAW,CAAC,SAAS,mBAAmB,YAAY,QAAQ,YAAY,CAAC,CAAC;AAC3G;","names":[]}

package/dist/{use-org-notification-emails-B8e4vgs-.d.cts → use-org-notification-emails-B4INNGOe.d.cts}

@@ -39,7 +39,7 @@ declare function useSifaConfig(): SifaApiConfig;
  * Pass `{ enabled: false }` (or an empty `handleOrDid`) to defer the
  * fetch.
  */
-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<NoInfer<Profile | null>, Error>;
+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>;
 /**
  * React hook for a profile's AT Fund link. Returns `null` data on error
  * or when the profile has no link configured.
@@ -53,7 +53,7 @@ declare function useAtFundLink(did: string | undefined | null, options?: Omit<Us
  *
  * Pass `{ enabled: false }` (or an empty `actor`) to defer the fetch.
  */
-declare function useGetProfileView(actor: string | undefined | null, options?: Omit<UseQueryOptions<ProfileView | null, Error, ProfileView | null, ReturnType<typeof sifaQueryKeys.profile.view>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<ProfileView | null>, Error>;
+declare function useGetProfileView(actor: string | undefined | null, options?: Omit<UseQueryOptions<ProfileView | null, Error, ProfileView | null, ReturnType<typeof sifaQueryKeys.profile.view>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<ProfileView | null, Error>;
 
 /**
  * React hook for updating the authenticated user's profile self record.
@@ -199,7 +199,7 @@ declare function useUpdateProfileLocation(ownerHandleOrDid: string, options?: Om
 declare function useDeleteProfileLocation(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
 
 /** React hook for reading the external-accounts list. Returns `[]` data on error. */
-declare function useExternalAccounts(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<ExternalAccount[], Error, ExternalAccount[], ReturnType<typeof sifaQueryKeys.profile.externalAccounts>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<ExternalAccount[]>, Error>;
+declare function useExternalAccounts(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<ExternalAccount[], Error, ExternalAccount[], ReturnType<typeof sifaQueryKeys.profile.externalAccounts>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<ExternalAccount[], Error>;
 /** React hook for creating an external account. */
 declare function useCreateExternalAccount(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<CreateExternalAccountResult, Error, ExternalAccountInput>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateExternalAccountResult, Error, ExternalAccountInput, unknown>;
 /** Variables for {@link useUpdateExternalAccount}. */
@@ -232,7 +232,7 @@ declare function useCreateEndorsement(endorsedHandleOrDid: string | null, option
  * page when signed out or on error, so callers can render "nothing pending"
  * without special-casing either.
  */
-declare function usePendingConfirmations(options?: Omit<UseQueryOptions<PendingConfirmationsPage, Error, PendingConfirmationsPage, ReturnType<typeof sifaQueryKeys.confirmation.pending>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<PendingConfirmationsPage>, Error>;
+declare function usePendingConfirmations(options?: Omit<UseQueryOptions<PendingConfirmationsPage, Error, PendingConfirmationsPage, ReturnType<typeof sifaQueryKeys.confirmation.pending>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<PendingConfirmationsPage, Error>;
 /**
  * Confirmations the signed-in user has already given, with whether each has
  * drifted since. Returns an empty list when signed out or on error.
@@ -241,9 +241,9 @@ declare function useGivenConfirmations(options?: Omit<UseQueryOptions<{
     confirmations: GivenConfirmation[];
 }, Error, {
     confirmations: GivenConfirmation[];
-}, ReturnType<typeof sifaQueryKeys.confirmation.given>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<{
+}, ReturnType<typeof sifaQueryKeys.confirmation.given>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<{
     confirmations: GivenConfirmation[];
-}>, Error>;
+}, Error>;
 /**
  * Affirm a claim naming you. On success it leaves the inbox and starts
  * rendering with your name and avatar on the claimer's profile, so both the
@@ -271,14 +271,14 @@ declare function useRevokeConfirmation(claimerHandleOrDid: string | null, option
  * waiting" without special-casing. See {@link InboxCounts} for what `tasks`
  * covers and why the two numbers are disjoint.
  */
-declare function useInboxCounts(options?: Omit<UseQueryOptions<InboxCounts, Error, InboxCounts, ReturnType<typeof sifaQueryKeys.inbox.counts>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<InboxCounts>, Error>;
+declare function useInboxCounts(options?: Omit<UseQueryOptions<InboxCounts, Error, InboxCounts, ReturnType<typeof sifaQueryKeys.inbox.counts>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<InboxCounts, Error>;
 
 /**
  * Positions on the signed-in user's profile whose company is not yet linked to a
  * canonical entity, for the unified Inbox. Returns an empty list when signed out
  * or on error.
  */
-declare function useUnlinkedPositions(options?: Omit<UseQueryOptions<UnlinkedPositionsResult, Error, UnlinkedPositionsResult, ReturnType<typeof sifaQueryKeys.position.unlinked>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<UnlinkedPositionsResult>, Error>;
+declare function useUnlinkedPositions(options?: Omit<UseQueryOptions<UnlinkedPositionsResult, Error, UnlinkedPositionsResult, ReturnType<typeof sifaQueryKeys.position.unlinked>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<UnlinkedPositionsResult, Error>;
 /**
  * Dismiss the unlinked-company task for one position. On success the position
  * leaves the Inbox and the bell count, so both the unlinked-positions list and
@@ -291,7 +291,7 @@ declare function useDismissUnlinkedPosition(options?: Omit<UseMutationOptions<Wr
  * missing), for the unified Inbox checklist. Returns a complete result when
  * signed out or on error.
  */
-declare function useProfileCompleteness(options?: Omit<UseQueryOptions<ProfileCompleteness, Error, ProfileCompleteness, ReturnType<typeof sifaQueryKeys.profile.completeness>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<ProfileCompleteness>, Error>;
+declare function useProfileCompleteness(options?: Omit<UseQueryOptions<ProfileCompleteness, Error, ProfileCompleteness, ReturnType<typeof sifaQueryKeys.profile.completeness>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<ProfileCompleteness, Error>;
 
 /** React hook for hiding a keytrace claim. Variable: the claim `rkey` string. */
 declare function useHideKeytraceClaim(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
@@ -339,7 +339,7 @@ declare const useBulkUnhideProfileItems: (ownerHandleOrDid: string, options?: Om
  * Everything the authenticated user has hidden from their activity, for the
  * unhide list in settings.
  */
-declare function useHiddenActivityItems(options?: Omit<UseQueryOptions<HiddenActivityItem[], Error, HiddenActivityItem[], ReturnType<typeof sifaQueryKeys.activity.hiddenItems>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<HiddenActivityItem[]>, Error>;
+declare function useHiddenActivityItems(options?: Omit<UseQueryOptions<HiddenActivityItem[], Error, HiddenActivityItem[], ReturnType<typeof sifaQueryKeys.activity.hiddenItems>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<HiddenActivityItem[], Error>;
 /**
  * Hide one activity item from the caller's own profile. The record stays on
  * their PDS; only its appearance on sifa.id is suppressed.
@@ -351,39 +351,39 @@ declare const useUnhideActivityItem: (options?: Omit<UseMutationOptions<WriteRes
 /**
  * React hook for the public homepage stats. Returns `null` data on error.
  */
-declare function useStats(options?: Omit<UseQueryOptions<StatsResponse | null, Error, StatsResponse | null, ReturnType<typeof sifaQueryKeys.stats.homepage>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<StatsResponse | null>, Error>;
+declare function useStats(options?: Omit<UseQueryOptions<StatsResponse | null, Error, StatsResponse | null, ReturnType<typeof sifaQueryKeys.stats.homepage>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<StatsResponse | null, Error>;
 
 /** React hook for the public app registry. */
-declare function useAppsRegistry(options?: Omit<UseQueryOptions<AppRegistryEntry[], Error, AppRegistryEntry[], ReturnType<typeof sifaQueryKeys.apps.registry>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<AppRegistryEntry[]>, Error>;
+declare function useAppsRegistry(options?: Omit<UseQueryOptions<AppRegistryEntry[], Error, AppRegistryEntry[], ReturnType<typeof sifaQueryKeys.apps.registry>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<AppRegistryEntry[], Error>;
 /**
  * React hook for the authenticated user's hidden-apps list. Requires a
  * client-side session (relies on `credentials: 'include'`).
  */
-declare function useHiddenApps(options?: Omit<UseQueryOptions<HiddenApp[], Error, HiddenApp[], ReturnType<typeof sifaQueryKeys.apps.hidden>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<HiddenApp[]>, Error>;
+declare function useHiddenApps(options?: Omit<UseQueryOptions<HiddenApp[], Error, HiddenApp[], ReturnType<typeof sifaQueryKeys.apps.hidden>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<HiddenApp[], Error>;
 
 /**
  * React hook for the accounts attached to this browser (the account switcher).
  * Requires a client-side session (relies on `credentials: 'include'`).
  * Returns `[]` when unauthenticated.
  */
-declare function useAccounts(options?: Omit<UseQueryOptions<AccountSummary[], Error, AccountSummary[], ReturnType<typeof sifaQueryKeys.auth.accounts>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<AccountSummary[]>, Error>;
+declare function useAccounts(options?: Omit<UseQueryOptions<AccountSummary[], Error, AccountSummary[], ReturnType<typeof sifaQueryKeys.auth.accounts>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<AccountSummary[], Error>;
 
-declare function useSearchProfiles(filters: SearchFilters, options?: Omit<UseQueryOptions<SearchResponse, Error, SearchResponse, ReturnType<typeof sifaQueryKeys.search.profiles>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SearchResponse>, Error>;
-declare function useSkillSuggestions(query: string, options?: Omit<UseQueryOptions<SkillSearchResult[], Error, SkillSearchResult[], ReturnType<typeof sifaQueryKeys.search.skills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SkillSearchResult[]>, Error>;
+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>;
 /**
  * Canonical-skill search hook. Hits `/api/skills/search` (the
  * canonical-skills DB lookup, distinct from {@link useSkillSuggestions}'s
  * `/api/search/skills` profile-skill typeahead). Skips the network call
  * when the query is empty.
  */
-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>;
+declare function useCanonicalSkillSearch(query: string, limit?: number, options?: Omit<UseQueryOptions<SkillSuggestion[], Error, SkillSuggestion[], ReturnType<typeof sifaQueryKeys.search.canonicalSkills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SkillSuggestion[], Error>;
+declare function useSearchFilters(options?: Omit<UseQueryOptions<FilterOptions, Error, FilterOptions, ReturnType<typeof sifaQueryKeys.search.filters>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FilterOptions, Error>;
 /**
  * Company search (workspace#299). Separate hook from `useSearchProfiles` so a
  * blended results page can render each category as it resolves instead of
  * waiting for the slowest.
  */
-declare function useSearchCompanies(filters: CompanySearchFilters, options?: Omit<UseQueryOptions<CompanySearchResponse, Error, CompanySearchResponse, ReturnType<typeof sifaQueryKeys.search.companies>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<CompanySearchResponse>, Error>;
+declare function useSearchCompanies(filters: CompanySearchFilters, options?: Omit<UseQueryOptions<CompanySearchResponse, Error, CompanySearchResponse, ReturnType<typeof sifaQueryKeys.search.companies>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<CompanySearchResponse, Error>;
 
 /** Debounce a rapidly-changing value (e.g. a typeahead input). */
 declare function useDebouncedValue<T>(value: T, delayMs?: number): T;
@@ -399,7 +399,7 @@ interface UseEntitySearchOptions {
  * 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<{
+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<{
     results: ({
         kind: string;
         name: string;
@@ -420,7 +420,7 @@ declare function useEntitySearch(query: string, opts?: UseEntitySearchOptions, q
         pdlId: string;
     })[];
     hasMore: boolean;
-}>, Error>;
+}, 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;
@@ -512,10 +512,10 @@ declare function useMintEntityDomain(options?: Omit<UseMutationOptions<EntityMin
 
 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>;
-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<NoInfer<SuggestionsResponse>, Error>;
+}, 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<NoInfer<FeaturedProfile | null>, 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>;
 
 /**
  * Legacy "people I follow" query. Kept as-is for back-compat with sifa-web
@@ -527,7 +527,7 @@ 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<NoInfer<FollowingResponse>, Error>;
+}, options?: Omit<UseQueryOptions<FollowingResponse, Error, FollowingResponse, ReturnType<typeof sifaQueryKeys.follow.following>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FollowingResponse, Error>;
 /** Variables for {@link useFollow}. */
 interface FollowVariables {
     handle: string;
@@ -568,14 +568,14 @@ declare function useFollowingList(handle: string, opts?: Omit<FetchFollowListOpt
  * See {@link fetchFollowingFeed}. v1 is a finite first page (no infinite scroll
  * yet). The native app must set `config.getAuthToken`; web uses its cookie.
  */
-declare function useFollowingFeed(opts?: FetchFollowingFeedOptions, options?: Omit<UseQueryOptions<FollowingFeedResponse, Error, FollowingFeedResponse, ReturnType<typeof sifaQueryKeys.follow.feed>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<FollowingFeedResponse>, Error>;
+declare function useFollowingFeed(opts?: FetchFollowingFeedOptions, options?: Omit<UseQueryOptions<FollowingFeedResponse, Error, FollowingFeedResponse, ReturnType<typeof sifaQueryKeys.follow.feed>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FollowingFeedResponse, Error>;
 /**
  * When the cached following feed for the same query was built, and a
  * fingerprint of its items (or null). Poll it while a `stale` feed is shown,
  * e.g. with `refetchInterval`, and offer the newer feed once
  * {@link isNewerFollowingFeed} is true.
  */
-declare function useFollowingFeedVersion(opts?: FetchFollowingFeedOptions, options?: Omit<UseQueryOptions<FollowingFeedVersion | null, Error, FollowingFeedVersion | null, ReturnType<typeof sifaQueryKeys.follow.feedVersion>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<FollowingFeedVersion | null>, Error>;
+declare function useFollowingFeedVersion(opts?: FetchFollowingFeedOptions, options?: Omit<UseQueryOptions<FollowingFeedVersion | null, Error, FollowingFeedVersion | null, ReturnType<typeof sifaQueryKeys.follow.feedVersion>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FollowingFeedVersion | null, Error>;
 
 /**
  * Infinite-query hook for the mutuals list of `handleOrDid`. Backed by
@@ -595,7 +595,7 @@ declare function useBlueskySuggestions(opts?: Omit<FetchFollowProfilePageOptions
  * Read hook for the admin allowlist of a given feature flag. Admin-gated on
  * the server; non-admins get an empty list (the fetcher swallows 403).
  */
-declare function useFeatureAllowlist(flag: FeatureFlag, options?: Omit<UseQueryOptions<FeatureAllowlistResponse, Error, FeatureAllowlistResponse, ReturnType<typeof sifaQueryKeys.admin.featureAllowlist>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<FeatureAllowlistResponse>, Error>;
+declare function useFeatureAllowlist(flag: FeatureFlag, options?: Omit<UseQueryOptions<FeatureAllowlistResponse, Error, FeatureAllowlistResponse, ReturnType<typeof sifaQueryKeys.admin.featureAllowlist>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FeatureAllowlistResponse, Error>;
 /** Snapshot of the previous cache entry; returned from `onMutate` for rollback. */
 interface AllowlistMutationContext {
     previous: FeatureAllowlistResponse | undefined;
@@ -629,11 +629,11 @@ declare function useRemoveFeatureAllowlist(flag: FeatureFlag, options?: Omit<Use
  *
  * Admin-gated on the server; non-admins get an error rather than zeroes.
  */
-declare function useAdminReviewQueues(options?: Omit<UseQueryOptions<AdminReviewQueues, Error, AdminReviewQueues, ReturnType<typeof sifaQueryKeys.admin.reviewQueues>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<AdminReviewQueues>, Error>;
+declare function useAdminReviewQueues(options?: Omit<UseQueryOptions<AdminReviewQueues, Error, AdminReviewQueues, ReturnType<typeof sifaQueryKeys.admin.reviewQueues>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<AdminReviewQueues, Error>;
 
-declare function useHeatmapData(handleOrDid: string | undefined | null, days: number, options?: Omit<UseQueryOptions<HeatmapResponse | null, Error, HeatmapResponse | null, ReturnType<typeof sifaQueryKeys.activity.heatmap>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<HeatmapResponse | null>, Error>;
-declare function useActivityTeaser(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<ActivityTeaserResponse | null, Error, ActivityTeaserResponse | null, ReturnType<typeof sifaQueryKeys.activity.teaser>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<ActivityTeaserResponse | null>, Error>;
-declare function useActivityFeed(handleOrDid: string | undefined | null, opts?: Pick<FetchActivityFeedOptions, 'category' | 'limit' | 'cursor'>, options?: Omit<UseQueryOptions<ActivityFeedResponse | null, Error, ActivityFeedResponse | null, ReturnType<typeof sifaQueryKeys.activity.feed>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<ActivityFeedResponse | null>, Error>;
+declare function useHeatmapData(handleOrDid: string | undefined | null, days: number, options?: Omit<UseQueryOptions<HeatmapResponse | null, Error, HeatmapResponse | null, ReturnType<typeof sifaQueryKeys.activity.heatmap>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<HeatmapResponse | null, Error>;
+declare function useActivityTeaser(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<ActivityTeaserResponse | null, Error, ActivityTeaserResponse | null, ReturnType<typeof sifaQueryKeys.activity.teaser>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<ActivityTeaserResponse | null, Error>;
+declare function useActivityFeed(handleOrDid: string | undefined | null, opts?: Pick<FetchActivityFeedOptions, 'category' | 'limit' | 'cursor'>, options?: Omit<UseQueryOptions<ActivityFeedResponse | null, Error, ActivityFeedResponse | null, ReturnType<typeof sifaQueryKeys.activity.feed>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<ActivityFeedResponse | null, Error>;
 
 interface UseMyGithubPullRequestsParams {
     limit?: number;
@@ -643,7 +643,7 @@ interface UseMyGithubPullRequestsParams {
  * The authenticated viewer's own ingested merged PRs (newest first). Auth-scoped
  * via the session cookie. Backs the sifa-web GitHub importer (issue #302).
  */
-declare function useMyGithubPullRequests(params?: UseMyGithubPullRequestsParams, options?: Omit<UseQueryOptions<MyGithubPullRequestsResponse, Error, MyGithubPullRequestsResponse, ReturnType<typeof sifaQueryKeys.github.myPullRequests>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<{
+declare function useMyGithubPullRequests(params?: UseMyGithubPullRequestsParams, options?: Omit<UseQueryOptions<MyGithubPullRequestsResponse, Error, MyGithubPullRequestsResponse, ReturnType<typeof sifaQueryKeys.github.myPullRequests>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<{
     items: {
         prNumber: number;
         repoOwner: string;
@@ -656,7 +656,7 @@ declare function useMyGithubPullRequests(params?: UseMyGithubPullRequestsParams,
         mergedAt: string;
     }[];
     hasMore: boolean;
-}>, Error>;
+}, Error>;
 
 /** Count of confirmed endorsements for a DID. Returns 0 on error. */
 declare function useEndorsementCount(did: string | undefined | null, options?: Omit<UseQueryOptions<number, Error, number, ReturnType<typeof sifaQueryKeys.endorsement.count>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<number, Error>;
@@ -671,9 +671,9 @@ declare function useNetworkStreamCount(did: string | undefined | null, options?:
  * Batch-look up reaction status for multiple URIs. Skips the network call
  * when `uris` is empty.
  */
-declare function useReactionStatus(uris: string[], options?: Omit<UseQueryOptions<Record<string, ReactionStatus> | null, Error, Record<string, ReactionStatus> | null, ReturnType<typeof sifaQueryKeys.reactions.status>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<Record<string, ReactionStatus> | null>, Error>;
+declare function useReactionStatus(uris: string[], options?: Omit<UseQueryOptions<Record<string, ReactionStatus> | null, Error, Record<string, ReactionStatus> | null, ReturnType<typeof sifaQueryKeys.reactions.status>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<Record<string, ReactionStatus> | null, Error>;
 /** Check whether the authenticated viewer has an account on the given app. */
-declare function useAppAccountCheck(appId: string | undefined | null, options?: Omit<UseQueryOptions<AccountCheckResult | null, Error, AccountCheckResult | null, ReturnType<typeof sifaQueryKeys.reactions.accountCheck>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<AccountCheckResult | null>, Error>;
+declare function useAppAccountCheck(appId: string | undefined | null, options?: Omit<UseQueryOptions<AccountCheckResult | null, Error, AccountCheckResult | null, ReturnType<typeof sifaQueryKeys.reactions.accountCheck>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<AccountCheckResult | null, Error>;
 
 /** Variables for {@link useCreateReaction}. */
 interface CreateReactionVariables {
@@ -713,9 +713,9 @@ interface DeleteReactionVariables {
 declare function useDeleteReaction(options?: Omit<UseMutationOptions<WriteResult, Error, DeleteReactionVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, DeleteReactionVariables, unknown>;
 
 /** Public roadmap vote tallies. Returns `{}` data on error. */
-declare function useRoadmapVotes(options?: Omit<UseQueryOptions<RoadmapVotesResponse, Error, RoadmapVotesResponse, ReturnType<typeof sifaQueryKeys.roadmap.votes>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<RoadmapVotesResponse>, Error>;
+declare function useRoadmapVotes(options?: Omit<UseQueryOptions<RoadmapVotesResponse, Error, RoadmapVotesResponse, ReturnType<typeof sifaQueryKeys.roadmap.votes>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<RoadmapVotesResponse, Error>;
 /** Roadmap items the authenticated viewer has voted on. Returns `[]` data on error. */
-declare function useMyRoadmapVotes(options?: Omit<UseQueryOptions<string[], Error, string[], ReturnType<typeof sifaQueryKeys.roadmap.myVotes>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<string[]>, Error>;
+declare function useMyRoadmapVotes(options?: Omit<UseQueryOptions<string[], Error, string[], ReturnType<typeof sifaQueryKeys.roadmap.myVotes>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<string[], Error>;
 
 /**
  * React hook for casting a roadmap vote. Variable: the item key.
@@ -736,7 +736,7 @@ declare function useRetractRoadmapVote(options?: Omit<UseMutationOptions<WriteRe
  * and the grant changes underneath this hook when the user returns from the
  * consent screen. A stale "no gaps" here is the failure this exists to prevent.
  */
-declare function useWipePreview(options?: Omit<UseQueryOptions<WipePreview, Error, WipePreview, ReturnType<typeof sifaQueryKeys.destructive.wipePreview>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<WipePreview>, Error>;
+declare function useWipePreview(options?: Omit<UseQueryOptions<WipePreview, Error, WipePreview, ReturnType<typeof sifaQueryKeys.destructive.wipePreview>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<WipePreview, Error>;
 /**
  * React hook for resetting the authenticated user's Sifa profile.
  * Variable: `deletePdsData` boolean.
@@ -762,7 +762,7 @@ declare function useDeleteAccount(options?: Omit<UseMutationOptions<DeleteAccoun
  * it again from cache. The server caches the PDS read briefly, which is where
  * that cost belongs.
  */
-declare function useRepoInventory(options?: Omit<UseQueryOptions<RepoInventory, Error, RepoInventory, ReturnType<typeof sifaQueryKeys.repoInventory.list>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<RepoInventory>, Error>;
+declare function useRepoInventory(options?: Omit<UseQueryOptions<RepoInventory, Error, RepoInventory, ReturnType<typeof sifaQueryKeys.repoInventory.list>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<RepoInventory, Error>;
 /**
  * Delete records from the authenticated user's repo.
  *
@@ -787,7 +787,7 @@ declare function useDeleteRepoRecords(options?: Omit<UseMutationOptions<RepoDele
  * `OrgFloorVerdict | null` (`null` when the profile is missing or predates the
  * `org` field).
  */
-declare function useOrgProfile(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<Profile | null, Error, OrgFloorVerdict | null, ReturnType<typeof sifaQueryKeys.profile.byHandle>>, 'queryKey' | 'queryFn' | 'select'>): _tanstack_react_query.UseQueryResult<NoInfer<OrgFloorVerdict | null>, Error>;
+declare function useOrgProfile(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<Profile | null, Error, OrgFloorVerdict | null, ReturnType<typeof sifaQueryKeys.profile.byHandle>>, 'queryKey' | 'queryFn' | 'select'>): _tanstack_react_query.UseQueryResult<OrgFloorVerdict | null, Error>;
 
 type OrgClaimMutationResult = WriteResult<Partial<OrgClaimResult>>;
 /**