@singi-labs/sifa-sdk 0.19.74 → 0.19.76

package/dist/query/fetchers/activity-preferences.js

@@ -0,0 +1,43 @@
+// src/query/fetchers/activity-preferences.ts
+import {
+  apiFetch,
+  apiWrite,
+  encodeIdentifier
+} from "../client.js";
+async function fetchActivityPreferences(config, options = {}) {
+  const headers = { ...options.headers ?? {} };
+  if (options.cookieHeader) headers.cookie = options.cookieHeader;
+  try {
+    return await apiFetch(config, "/api/activity-preferences", {
+      credentials: "include",
+      cache: "no-store",
+      ...options,
+      headers
+    });
+  } catch {
+    return null;
+  }
+}
+function updateActivityPreferences(config, input, options = {}) {
+  return apiWrite(config, "/api/activity-preferences", "PUT", {
+    ...options,
+    body: input
+  });
+}
+async function fetchSiteActivityPreset(config, handleOrDid, options = {}) {
+  try {
+    return await apiFetch(
+      config,
+      `/api/activity-preferences/site-preset/${encodeIdentifier(handleOrDid)}`,
+      options
+    );
+  } catch {
+    return null;
+  }
+}
+export {
+  fetchActivityPreferences,
+  fetchSiteActivityPreset,
+  updateActivityPreferences
+};
+//# sourceMappingURL=activity-preferences.js.map

package/dist/query/fetchers/activity-preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/activity-preferences.ts"],"sourcesContent":["import type { SiteActivityPreset } from '../../logic/site-activity-preset.js';\nimport {\n  apiFetch,\n  apiWrite,\n  encodeIdentifier,\n  type ApiFetchOptions,\n  type SifaApiConfig,\n  type WriteResult,\n} from '../client.js';\n\n/**\n * The authenticated user's activity preferences, resolved to an answer for\n * every known key. `sitePreset` is the personal-site \"show only\" filter; both\n * lists empty means no preset.\n */\nexport interface ActivityPreferences {\n  streamCategories: Record<string, boolean>;\n  digestItemTypes: Record<string, boolean>;\n  sitePreset: SiteActivityPreset;\n}\n\n/**\n * Partial update. Only the keys present change. `sitePreset`, when present,\n * replaces the whole stored preset; send empty lists to clear it.\n */\nexport interface UpdateActivityPreferencesInput {\n  streamCategories?: Record<string, boolean>;\n  digestItemTypes?: Record<string, boolean>;\n  sitePreset?: SiteActivityPreset;\n}\n\n/** A user's personal-site preset as anyone can read it. */\nexport interface SiteActivityPresetResponse extends SiteActivityPreset {\n  did: string;\n  /** False when both lists are empty, i.e. the site shows all activity. */\n  active: boolean;\n}\n\nexport interface FetchActivityPreferencesOptions extends ApiFetchOptions {\n  /**\n   * Pass the caller's `Cookie` header on Next.js RSC server-side calls.\n   * `credentials: 'include'` does NOT propagate browser cookies in RSC.\n   */\n  cookieHeader?: string;\n}\n\n/** The caller's own preferences. Returns `null` on any error. */\nexport async function fetchActivityPreferences(\n  config: SifaApiConfig,\n  options: FetchActivityPreferencesOptions = {},\n): Promise<ActivityPreferences | null> {\n  const headers: Record<string, string> = { ...(options.headers ?? {}) };\n  if (options.cookieHeader) headers.cookie = options.cookieHeader;\n\n  try {\n    return await apiFetch<ActivityPreferences>(config, '/api/activity-preferences', {\n      credentials: 'include',\n      cache: 'no-store',\n      ...options,\n      headers,\n    });\n  } catch {\n    return null;\n  }\n}\n\n/** Update the caller's own preferences. */\nexport function updateActivityPreferences(\n  config: SifaApiConfig,\n  input: UpdateActivityPreferencesInput,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult<Partial<ActivityPreferences>>> {\n  return apiWrite<Partial<ActivityPreferences>>(config, '/api/activity-preferences', 'PUT', {\n    ...options,\n    body: input,\n  });\n}\n\n/**\n * Public read of a user's personal-site preset, by handle or DID. Site\n * builders use it to show the same activity page.sifa.id shows. Returns\n * `null` on any error.\n */\nexport async function fetchSiteActivityPreset(\n  config: SifaApiConfig,\n  handleOrDid: string,\n  options: ApiFetchOptions = {},\n): Promise<SiteActivityPresetResponse | null> {\n  try {\n    return await apiFetch<SiteActivityPresetResponse>(\n      config,\n      `/api/activity-preferences/site-preset/${encodeIdentifier(handleOrDid)}`,\n      options,\n    );\n  } catch {\n    return null;\n  }\n}\n"],"mappings":";AACA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAuCP,eAAsB,yBACpB,QACA,UAA2C,CAAC,GACP;AACrC,QAAM,UAAkC,EAAE,GAAI,QAAQ,WAAW,CAAC,EAAG;AACrE,MAAI,QAAQ,aAAc,SAAQ,SAAS,QAAQ;AAEnD,MAAI;AACF,WAAO,MAAM,SAA8B,QAAQ,6BAA6B;AAAA,MAC9E,aAAa;AAAA,MACb,OAAO;AAAA,MACP,GAAG;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGO,SAAS,0BACd,QACA,OACA,UAA2B,CAAC,GACwB;AACpD,SAAO,SAAuC,QAAQ,6BAA6B,OAAO;AAAA,IACxF,GAAG;AAAA,IACH,MAAM;AAAA,EACR,CAAC;AACH;AAOA,eAAsB,wBACpB,QACA,aACA,UAA2B,CAAC,GACgB;AAC5C,MAAI;AACF,WAAO,MAAM;AAAA,MACX;AAAA,MACA,yCAAyC,iBAAiB,WAAW,CAAC;AAAA,MACtE;AAAA,IACF;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/query/fetchers/activity.js

@@ -33,6 +33,9 @@ async function fetchActivityTeaser(config, handleOrDid, options = {}) {
 async function fetchActivityFeed(config, handleOrDid, options = {}) {
   const params = new URLSearchParams();
   if (options.category) params.set("category", options.category);
+  if (options.categories?.length) params.set("categories", options.categories.join(","));
+  if (options.tags?.length) params.set("tags", options.tags.join(","));
+  if (options.preset) params.set("preset", options.preset);
   if (options.limit) params.set("limit", String(options.limit));
   if (options.cursor) params.set("cursor", options.cursor);
   const qs = params.toString();

package/dist/query/fetchers/activity.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/query/fetchers/activity.ts"],"sourcesContent":["import type { ActivityLabel } from '../../cards/adult-content.js';\nimport { encodeIdentifier, apiFetch, type ApiFetchOptions, type SifaApiConfig } from '../client.js';\nimport type { QuotedPostResult } from './quoted-posts.js';\n\n/**\n * Liveness of an activity card's destination, as reported by sifa-api's\n * `/api/activity` enrichment (see sifa-api `url-health-checker`). How liveness\n * is measured depends on the card's health strategy (see `resolveCardHealth`):\n * first-party permalinks (`record`) are checked by record existence on the PDS;\n * foreign/derived targets (`url`) by HTTP reachability (HEAD, then GET).\n *\n *   ok           -- record exists, or the URL returned 2xx/3xx\n *   broken       -- confirmed dead (record deleted, or >=2 consecutive 4xx / >=5 consecutive 5xx)\n *   unverifiable -- 403/429, PDS unreachable, or network error; NOT dead\n *   unknown      -- newly seen, not yet checked\n *\n * Consumers should only suppress UI on `'broken'`. All other values\n * (including missing) mean \"render normally\".\n */\nexport type ActivityItemLinkHealth = 'ok' | 'broken' | 'unverifiable' | 'unknown';\n\nexport interface HeatmapDay {\n  date: string;\n  total: number;\n  apps: { appId: string; count: number }[];\n}\n\nexport interface HeatmapResponse {\n  days: HeatmapDay[];\n  appTotals: { appId: string; appName: string; total: number }[];\n  thresholds: [number, number, number, number];\n}\n\nexport interface ActivityItem {\n  uri: string;\n  cid: string;\n  collection: string;\n  rkey: string;\n  record: Record<string, unknown>;\n  appId: string;\n  appName: string;\n  category: string;\n  indexedAt: string;\n  /**\n   * The record author's handle / display name / avatar, injected by the server\n   * on MULTI-author feeds (the following feed) so a card can show whose activity\n   * it is. Unset on the per-author activity feed (all one author). Mirrors the\n   * stream `ActivityItem`'s author fields the view-model transform reads.\n   */\n  authorHandle?: string;\n  authorDisplayName?: string;\n  authorAvatar?: string;\n  /**\n   * Set by the server when an `app.bsky.embed.record` quote was already\n   * resolved upstream (AppView path). Mutually exclusive with `quotedPostUri`.\n   */\n  quotedPost?: QuotedPostResult;\n  /**\n   * Set by the server when an `app.bsky.embed.record` quote needs client-side\n   * resolution (PDS path). Pass batches to {@link resolveQuotedPosts}.\n   * Mutually exclusive with `quotedPost`.\n   */\n  quotedPostUri?: string;\n  /**\n   * Reachability of the card's external destination as last checked by\n   * sifa-api. Undefined for legacy responses; treat as 'unknown'.\n   * See {@link ActivityItemLinkHealth}.\n   */\n  linkHealth?: ActivityItemLinkHealth;\n  /**\n   * Content labels from `app.bsky.feed.defs#postView.labels`. Set by\n   * sifa-api for Bluesky posts; undefined for other sources and legacy\n   * responses. Pass items to {@link hasAdultContent} to decide whether to\n   * gate media. See {@link ActivityLabel}.\n   */\n  labels?: ActivityLabel[];\n  /**\n   * The owner has hidden this item from their profile. Only ever set on the\n   * owner's own view of their feed -- every other surface omits hidden items\n   * rather than flagging them -- so a card can offer an unhide in place.\n   */\n  hidden?: boolean;\n}\n\nexport interface ActivityTeaserResponse {\n  items: ActivityItem[];\n  blueskyGated?: boolean;\n  backfillPending?: boolean;\n  failedApps?: string[];\n}\n\nexport interface ActivityFeedResponse {\n  items: ActivityItem[];\n  cursor: string | null;\n  hasMore: boolean;\n  availableCategories?: string[];\n  blueskyGated?: boolean;\n  failedApps?: string[];\n}\n\n/**\n * Per-day activity counts for a profile across all ATproto apps. Returns\n * `null` on any error so callers can render a graceful empty state.\n */\nexport async function fetchHeatmapData(\n  config: SifaApiConfig,\n  handleOrDid: string,\n  days: number,\n  options: ApiFetchOptions = {},\n): Promise<HeatmapResponse | null> {\n  const path = `/api/activity/${encodeIdentifier(handleOrDid)}/heatmap?days=${days}`;\n  try {\n    return await apiFetch<HeatmapResponse>(config, path, {\n      next: { revalidate: 900, tags: [`heatmap-${handleOrDid}`] },\n      ...options,\n    });\n  } catch {\n    return null;\n  }\n}\n\nexport interface FetchActivityTeaserOptions extends ApiFetchOptions {\n  /**\n   * Pass the caller's `Cookie` header on Next.js RSC server-side calls.\n   * Required for authenticated server fetches because `credentials: 'include'`\n   * does not propagate browser cookies in RSC.\n   */\n  cookieHeader?: string;\n}\n\n/**\n * Recent activity teaser for a profile (homepage-sized slice). Caps the\n * upstream wait so the SSR path cannot hang. Returns `null` on any error.\n */\nexport async function fetchActivityTeaser(\n  config: SifaApiConfig,\n  handleOrDid: string,\n  options: FetchActivityTeaserOptions = {},\n): Promise<ActivityTeaserResponse | null> {\n  const headers: Record<string, string> = { ...(options.headers ?? {}) };\n  if (options.cookieHeader) headers.cookie = options.cookieHeader;\n\n  try {\n    return await apiFetch<ActivityTeaserResponse>(\n      config,\n      `/api/activity/${encodeIdentifier(handleOrDid)}/teaser`,\n      {\n        credentials: 'include',\n        timeoutMs: 8000,\n        next: { revalidate: 300, tags: [`activity-teaser-${handleOrDid}`] },\n        ...options,\n        headers,\n      },\n    );\n  } catch {\n    return null;\n  }\n}\n\nexport interface FetchActivityFeedOptions extends ApiFetchOptions {\n  category?: string;\n  limit?: number;\n  cursor?: string;\n  cookieHeader?: string;\n}\n\n/**\n * Paginated activity feed for a profile. Always fresh (`cache: 'no-store'`).\n * Returns `null` on any error.\n */\nexport async function fetchActivityFeed(\n  config: SifaApiConfig,\n  handleOrDid: string,\n  options: FetchActivityFeedOptions = {},\n): Promise<ActivityFeedResponse | null> {\n  const params = new URLSearchParams();\n  if (options.category) params.set('category', options.category);\n  if (options.limit) params.set('limit', String(options.limit));\n  if (options.cursor) params.set('cursor', options.cursor);\n  const qs = params.toString();\n\n  const headers: Record<string, string> = { ...(options.headers ?? {}) };\n  if (options.cookieHeader) headers.cookie = options.cookieHeader;\n\n  try {\n    return await apiFetch<ActivityFeedResponse>(\n      config,\n      `/api/activity/${encodeIdentifier(handleOrDid)}${qs ? `?${qs}` : ''}`,\n      {\n        credentials: 'include',\n        cache: 'no-store',\n        ...options,\n        headers,\n      },\n    );\n  } catch {\n    return null;\n  }\n}\n"],"mappings":";AACA,SAAS,kBAAkB,gBAA0D;AAuGrF,eAAsB,iBACpB,QACA,aACA,MACA,UAA2B,CAAC,GACK;AACjC,QAAM,OAAO,iBAAiB,iBAAiB,WAAW,CAAC,iBAAiB,IAAI;AAChF,MAAI;AACF,WAAO,MAAM,SAA0B,QAAQ,MAAM;AAAA,MACnD,MAAM,EAAE,YAAY,KAAK,MAAM,CAAC,WAAW,WAAW,EAAE,EAAE;AAAA,MAC1D,GAAG;AAAA,IACL,CAAC;AAAA,EACH,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAeA,eAAsB,oBACpB,QACA,aACA,UAAsC,CAAC,GACC;AACxC,QAAM,UAAkC,EAAE,GAAI,QAAQ,WAAW,CAAC,EAAG;AACrE,MAAI,QAAQ,aAAc,SAAQ,SAAS,QAAQ;AAEnD,MAAI;AACF,WAAO,MAAM;AAAA,MACX;AAAA,MACA,iBAAiB,iBAAiB,WAAW,CAAC;AAAA,MAC9C;AAAA,QACE,aAAa;AAAA,QACb,WAAW;AAAA,QACX,MAAM,EAAE,YAAY,KAAK,MAAM,CAAC,mBAAmB,WAAW,EAAE,EAAE;AAAA,QAClE,GAAG;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAaA,eAAsB,kBACpB,QACA,aACA,UAAoC,CAAC,GACC;AACtC,QAAM,SAAS,IAAI,gBAAgB;AACnC,MAAI,QAAQ,SAAU,QAAO,IAAI,YAAY,QAAQ,QAAQ;AAC7D,MAAI,QAAQ,MAAO,QAAO,IAAI,SAAS,OAAO,QAAQ,KAAK,CAAC;AAC5D,MAAI,QAAQ,OAAQ,QAAO,IAAI,UAAU,QAAQ,MAAM;AACvD,QAAM,KAAK,OAAO,SAAS;AAE3B,QAAM,UAAkC,EAAE,GAAI,QAAQ,WAAW,CAAC,EAAG;AACrE,MAAI,QAAQ,aAAc,SAAQ,SAAS,QAAQ;AAEnD,MAAI;AACF,WAAO,MAAM;AAAA,MACX;AAAA,MACA,iBAAiB,iBAAiB,WAAW,CAAC,GAAG,KAAK,IAAI,EAAE,KAAK,EAAE;AAAA,MACnE;AAAA,QACE,aAAa;AAAA,QACb,OAAO;AAAA,QACP,GAAG;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}
+{"version":3,"sources":["../../../src/query/fetchers/activity.ts"],"sourcesContent":["import type { ActivityLabel } from '../../cards/adult-content.js';\nimport { encodeIdentifier, apiFetch, type ApiFetchOptions, type SifaApiConfig } from '../client.js';\nimport type { QuotedPostResult } from './quoted-posts.js';\n\n/**\n * Liveness of an activity card's destination, as reported by sifa-api's\n * `/api/activity` enrichment (see sifa-api `url-health-checker`). How liveness\n * is measured depends on the card's health strategy (see `resolveCardHealth`):\n * first-party permalinks (`record`) are checked by record existence on the PDS;\n * foreign/derived targets (`url`) by HTTP reachability (HEAD, then GET).\n *\n *   ok           -- record exists, or the URL returned 2xx/3xx\n *   broken       -- confirmed dead (record deleted, or >=2 consecutive 4xx / >=5 consecutive 5xx)\n *   unverifiable -- 403/429, PDS unreachable, or network error; NOT dead\n *   unknown      -- newly seen, not yet checked\n *\n * Consumers should only suppress UI on `'broken'`. All other values\n * (including missing) mean \"render normally\".\n */\nexport type ActivityItemLinkHealth = 'ok' | 'broken' | 'unverifiable' | 'unknown';\n\nexport interface HeatmapDay {\n  date: string;\n  total: number;\n  apps: { appId: string; count: number }[];\n}\n\nexport interface HeatmapResponse {\n  days: HeatmapDay[];\n  appTotals: { appId: string; appName: string; total: number }[];\n  thresholds: [number, number, number, number];\n}\n\nexport interface ActivityItem {\n  uri: string;\n  cid: string;\n  collection: string;\n  rkey: string;\n  record: Record<string, unknown>;\n  appId: string;\n  appName: string;\n  category: string;\n  indexedAt: string;\n  /**\n   * The record author's handle / display name / avatar, injected by the server\n   * on MULTI-author feeds (the following feed) so a card can show whose activity\n   * it is. Unset on the per-author activity feed (all one author). Mirrors the\n   * stream `ActivityItem`'s author fields the view-model transform reads.\n   */\n  authorHandle?: string;\n  authorDisplayName?: string;\n  authorAvatar?: string;\n  /**\n   * Set by the server when an `app.bsky.embed.record` quote was already\n   * resolved upstream (AppView path). Mutually exclusive with `quotedPostUri`.\n   */\n  quotedPost?: QuotedPostResult;\n  /**\n   * Set by the server when an `app.bsky.embed.record` quote needs client-side\n   * resolution (PDS path). Pass batches to {@link resolveQuotedPosts}.\n   * Mutually exclusive with `quotedPost`.\n   */\n  quotedPostUri?: string;\n  /**\n   * Reachability of the card's external destination as last checked by\n   * sifa-api. Undefined for legacy responses; treat as 'unknown'.\n   * See {@link ActivityItemLinkHealth}.\n   */\n  linkHealth?: ActivityItemLinkHealth;\n  /**\n   * Content labels from `app.bsky.feed.defs#postView.labels`. Set by\n   * sifa-api for Bluesky posts; undefined for other sources and legacy\n   * responses. Pass items to {@link hasAdultContent} to decide whether to\n   * gate media. See {@link ActivityLabel}.\n   */\n  labels?: ActivityLabel[];\n  /**\n   * The owner has hidden this item from their profile. Only ever set on the\n   * owner's own view of their feed -- every other surface omits hidden items\n   * rather than flagging them -- so a card can offer an unhide in place.\n   */\n  hidden?: boolean;\n}\n\nexport interface ActivityTeaserResponse {\n  items: ActivityItem[];\n  blueskyGated?: boolean;\n  backfillPending?: boolean;\n  failedApps?: string[];\n}\n\nexport interface ActivityFeedResponse {\n  items: ActivityItem[];\n  cursor: string | null;\n  hasMore: boolean;\n  availableCategories?: string[];\n  blueskyGated?: boolean;\n  failedApps?: string[];\n}\n\n/**\n * Per-day activity counts for a profile across all ATproto apps. Returns\n * `null` on any error so callers can render a graceful empty state.\n */\nexport async function fetchHeatmapData(\n  config: SifaApiConfig,\n  handleOrDid: string,\n  days: number,\n  options: ApiFetchOptions = {},\n): Promise<HeatmapResponse | null> {\n  const path = `/api/activity/${encodeIdentifier(handleOrDid)}/heatmap?days=${days}`;\n  try {\n    return await apiFetch<HeatmapResponse>(config, path, {\n      next: { revalidate: 900, tags: [`heatmap-${handleOrDid}`] },\n      ...options,\n    });\n  } catch {\n    return null;\n  }\n}\n\nexport interface FetchActivityTeaserOptions extends ApiFetchOptions {\n  /**\n   * Pass the caller's `Cookie` header on Next.js RSC server-side calls.\n   * Required for authenticated server fetches because `credentials: 'include'`\n   * does not propagate browser cookies in RSC.\n   */\n  cookieHeader?: string;\n}\n\n/**\n * Recent activity teaser for a profile (homepage-sized slice). Caps the\n * upstream wait so the SSR path cannot hang. Returns `null` on any error.\n */\nexport async function fetchActivityTeaser(\n  config: SifaApiConfig,\n  handleOrDid: string,\n  options: FetchActivityTeaserOptions = {},\n): Promise<ActivityTeaserResponse | null> {\n  const headers: Record<string, string> = { ...(options.headers ?? {}) };\n  if (options.cookieHeader) headers.cookie = options.cookieHeader;\n\n  try {\n    return await apiFetch<ActivityTeaserResponse>(\n      config,\n      `/api/activity/${encodeIdentifier(handleOrDid)}/teaser`,\n      {\n        credentials: 'include',\n        timeoutMs: 8000,\n        next: { revalidate: 300, tags: [`activity-teaser-${handleOrDid}`] },\n        ...options,\n        headers,\n      },\n    );\n  } catch {\n    return null;\n  }\n}\n\nexport interface FetchActivityFeedOptions extends ApiFetchOptions {\n  category?: string;\n  /**\n   * Show only these app categories. Applies when `category` is unset (the\n   * \"all\" view).\n   */\n  categories?: string[];\n  /**\n   * Show only long-form posts carrying one of these tags. Other activity is\n   * not filtered on tags. See `SiteActivityPreset`.\n   */\n  tags?: string[];\n  /**\n   * Apply the profile owner's saved preset for this surface. Explicit\n   * `categories` / `tags` override the matching half of the preset.\n   */\n  preset?: 'site';\n  limit?: number;\n  cursor?: string;\n  cookieHeader?: string;\n}\n\n/**\n * Paginated activity feed for a profile. Always fresh (`cache: 'no-store'`).\n * Returns `null` on any error.\n */\nexport async function fetchActivityFeed(\n  config: SifaApiConfig,\n  handleOrDid: string,\n  options: FetchActivityFeedOptions = {},\n): Promise<ActivityFeedResponse | null> {\n  const params = new URLSearchParams();\n  if (options.category) params.set('category', options.category);\n  if (options.categories?.length) params.set('categories', options.categories.join(','));\n  if (options.tags?.length) params.set('tags', options.tags.join(','));\n  if (options.preset) params.set('preset', options.preset);\n  if (options.limit) params.set('limit', String(options.limit));\n  if (options.cursor) params.set('cursor', options.cursor);\n  const qs = params.toString();\n\n  const headers: Record<string, string> = { ...(options.headers ?? {}) };\n  if (options.cookieHeader) headers.cookie = options.cookieHeader;\n\n  try {\n    return await apiFetch<ActivityFeedResponse>(\n      config,\n      `/api/activity/${encodeIdentifier(handleOrDid)}${qs ? `?${qs}` : ''}`,\n      {\n        credentials: 'include',\n        cache: 'no-store',\n        ...options,\n        headers,\n      },\n    );\n  } catch {\n    return null;\n  }\n}\n"],"mappings":";AACA,SAAS,kBAAkB,gBAA0D;AAuGrF,eAAsB,iBACpB,QACA,aACA,MACA,UAA2B,CAAC,GACK;AACjC,QAAM,OAAO,iBAAiB,iBAAiB,WAAW,CAAC,iBAAiB,IAAI;AAChF,MAAI;AACF,WAAO,MAAM,SAA0B,QAAQ,MAAM;AAAA,MACnD,MAAM,EAAE,YAAY,KAAK,MAAM,CAAC,WAAW,WAAW,EAAE,EAAE;AAAA,MAC1D,GAAG;AAAA,IACL,CAAC;AAAA,EACH,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAeA,eAAsB,oBACpB,QACA,aACA,UAAsC,CAAC,GACC;AACxC,QAAM,UAAkC,EAAE,GAAI,QAAQ,WAAW,CAAC,EAAG;AACrE,MAAI,QAAQ,aAAc,SAAQ,SAAS,QAAQ;AAEnD,MAAI;AACF,WAAO,MAAM;AAAA,MACX;AAAA,MACA,iBAAiB,iBAAiB,WAAW,CAAC;AAAA,MAC9C;AAAA,QACE,aAAa;AAAA,QACb,WAAW;AAAA,QACX,MAAM,EAAE,YAAY,KAAK,MAAM,CAAC,mBAAmB,WAAW,EAAE,EAAE;AAAA,QAClE,GAAG;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AA4BA,eAAsB,kBACpB,QACA,aACA,UAAoC,CAAC,GACC;AACtC,QAAM,SAAS,IAAI,gBAAgB;AACnC,MAAI,QAAQ,SAAU,QAAO,IAAI,YAAY,QAAQ,QAAQ;AAC7D,MAAI,QAAQ,YAAY,OAAQ,QAAO,IAAI,cAAc,QAAQ,WAAW,KAAK,GAAG,CAAC;AACrF,MAAI,QAAQ,MAAM,OAAQ,QAAO,IAAI,QAAQ,QAAQ,KAAK,KAAK,GAAG,CAAC;AACnE,MAAI,QAAQ,OAAQ,QAAO,IAAI,UAAU,QAAQ,MAAM;AACvD,MAAI,QAAQ,MAAO,QAAO,IAAI,SAAS,OAAO,QAAQ,KAAK,CAAC;AAC5D,MAAI,QAAQ,OAAQ,QAAO,IAAI,UAAU,QAAQ,MAAM;AACvD,QAAM,KAAK,OAAO,SAAS;AAE3B,QAAM,UAAkC,EAAE,GAAI,QAAQ,WAAW,CAAC,EAAG;AACrE,MAAI,QAAQ,aAAc,SAAQ,SAAS,QAAQ;AAEnD,MAAI;AACF,WAAO,MAAM;AAAA,MACX;AAAA,MACA,iBAAiB,iBAAiB,WAAW,CAAC,GAAG,KAAK,IAAI,EAAE,KAAK,EAAE;AAAA,MACnE;AAAA,QACE,aAAa;AAAA,QACb,OAAO;AAAA,QACP,GAAG;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/query/fetchers/index.cjs

@@ -801,6 +801,39 @@ async function fetchHiddenActivityItems(config, options = {}) {
   }
 }
 
+// src/query/fetchers/activity-preferences.ts
+async function fetchActivityPreferences(config, options = {}) {
+  const headers = { ...options.headers ?? {} };
+  if (options.cookieHeader) headers.cookie = options.cookieHeader;
+  try {
+    return await apiFetch(config, "/api/activity-preferences", {
+      credentials: "include",
+      cache: "no-store",
+      ...options,
+      headers
+    });
+  } catch {
+    return null;
+  }
+}
+function updateActivityPreferences(config, input, options = {}) {
+  return apiWrite(config, "/api/activity-preferences", "PUT", {
+    ...options,
+    body: input
+  });
+}
+async function fetchSiteActivityPreset(config, handleOrDid, options = {}) {
+  try {
+    return await apiFetch(
+      config,
+      `/api/activity-preferences/site-preset/${encodeIdentifier(handleOrDid)}`,
+      options
+    );
+  } catch {
+    return null;
+  }
+}
+
 // src/query/fetchers/stats.ts
 async function fetchStats(config, options = {}) {
   try {
@@ -1282,6 +1315,9 @@ async function fetchActivityTeaser(config, handleOrDid, options = {}) {
 async function fetchActivityFeed(config, handleOrDid, options = {}) {
   const params = new URLSearchParams();
   if (options.category) params.set("category", options.category);
+  if (options.categories?.length) params.set("categories", options.categories.join(","));
+  if (options.tags?.length) params.set("tags", options.tags.join(","));
+  if (options.preset) params.set("preset", options.preset);
   if (options.limit) params.set("limit", String(options.limit));
   if (options.cursor) params.set("cursor", options.cursor);
   const qs = params.toString();
@@ -1843,6 +1879,45 @@ async function fetchProfileSummary(config, actor, options = {}) {
   const view = await fetchGetProfileView(config, actor, fetchOptions);
   return view ? summarizeProfileView(view, { maxSkills }) : null;
 }
+var UserSettingsSchema = zod.z.object({
+  respectBskyBlocks: zod.z.boolean(),
+  autoLinkCompanies: zod.z.boolean(),
+  /**
+   * Show per-publication citation counts from OpenAlex on the profile.
+   * Off by default; an API that predates the setting reads as off.
+   */
+  showCitationCounts: zod.z.boolean().default(false)
+});
+async function fetchUserSettings(config, options = {}) {
+  const { cookieHeader, ...rest } = options;
+  const headers = { ...rest.headers ?? {} };
+  if (cookieHeader) headers.cookie = cookieHeader;
+  try {
+    const data = await apiFetch(config, "/api/settings", {
+      cache: "no-store",
+      credentials: "include",
+      ...rest,
+      headers
+    });
+    const parsed = UserSettingsSchema.safeParse(data);
+    return parsed.success ? parsed.data : null;
+  } catch {
+    return null;
+  }
+}
+async function updateUserSettings(config, patch) {
+  try {
+    const data = await apiFetch(config, "/api/settings", {
+      method: "PATCH",
+      credentials: "include",
+      body: patch
+    });
+    const parsed = UserSettingsSchema.safeParse(data);
+    return parsed.success ? parsed.data : null;
+  } catch {
+    return null;
+  }
+}
 
 // src/query/keys.ts
 var sifaQueryKeys = {
@@ -1926,7 +2001,10 @@ var sifaQueryKeys = {
     feed: (handleOrDid, opts) => ["sifa", "activity", "feed", handleOrDid, opts],
     // Session-scoped: the AppView reads the caller's own hides from their
     // cookie, so there is only ever one list per client.
-    hiddenItems: () => ["sifa", "activity", "hidden-items"]
+    hiddenItems: () => ["sifa", "activity", "hidden-items"],
+    // Session-scoped, like hiddenItems: the caller's own preferences.
+    preferences: () => ["sifa", "activity", "preferences"],
+    sitePreset: (handleOrDid) => ["sifa", "activity", "site-preset", handleOrDid]
   },
   github: {
     all: () => ["sifa", "github"],
@@ -1982,6 +2060,9 @@ var sifaQueryKeys = {
     all: () => ["sifa", "bsky-preferences"],
     contentLabels: () => ["sifa", "bsky-preferences", "content-labels"]
   },
+  userSettings: {
+    all: () => ["sifa", "user-settings"]
+  },
   repoInventory: {
     all: () => ["sifa", "repo-inventory"],
     list: () => ["sifa", "repo-inventory", "list"]
@@ -2143,6 +2224,7 @@ exports.PROFILE_COMPLETENESS_SIGNALS = PROFILE_COMPLETENESS_SIGNALS;
 exports.QUOTED_POSTS_BATCH_MAX = QUOTED_POSTS_BATCH_MAX;
 exports.RpgItemStatusSchema = RpgItemStatusSchema;
 exports.RpgStatusResponseSchema = RpgStatusResponseSchema;
+exports.UserSettingsSchema = UserSettingsSchema;
 exports.addFeatureAllowlist = addFeatureAllowlist;
 exports.addOrgNotificationEmail = addOrgNotificationEmail;
 exports.apiFetch = apiFetch;
@@ -2184,6 +2266,7 @@ exports.dismissEndorsement = dismissEndorsement;
 exports.dismissUnlinkedPosition = dismissUnlinkedPosition;
 exports.fetchAccounts = fetchAccounts;
 exports.fetchActivityFeed = fetchActivityFeed;
+exports.fetchActivityPreferences = fetchActivityPreferences;
 exports.fetchActivityTeaser = fetchActivityTeaser;
 exports.fetchAppsRegistry = fetchAppsRegistry;
 exports.fetchAtFundLink = fetchAtFundLink;
@@ -2219,6 +2302,7 @@ exports.fetchSearchCompanies = fetchSearchCompanies;
 exports.fetchSearchFilters = fetchSearchFilters;
 exports.fetchSearchProfiles = fetchSearchProfiles;
 exports.fetchSimilarProfiles = fetchSimilarProfiles;
+exports.fetchSiteActivityPreset = fetchSiteActivityPreset;
 exports.fetchSkillSuggestions = fetchSkillSuggestions;
 exports.fetchSpeakers = fetchSpeakers;
 exports.fetchStats = fetchStats;
@@ -2226,6 +2310,7 @@ exports.fetchSuggestionCount = fetchSuggestionCount;
 exports.fetchSuggestions = fetchSuggestions;
 exports.fetchTalks = fetchTalks;
 exports.fetchUnlinkedPositions = fetchUnlinkedPositions;
+exports.fetchUserSettings = fetchUserSettings;
 exports.fetchViewerPositionConfirmations = fetchViewerPositionConfirmations;
 exports.fetchWipePreview = fetchWipePreview;
 exports.followUser = followUser;
@@ -2277,6 +2362,7 @@ exports.unrevealMarqueDomain = unrevealMarqueDomain;
 exports.unsetExternalAccountPrimary = unsetExternalAccountPrimary;
 exports.unsetPositionPrimary = unsetPositionPrimary;
 exports.unsetSectionPrimary = unsetSectionPrimary;
+exports.updateActivityPreferences = updateActivityPreferences;
 exports.updateEducation = updateEducation;
 exports.updateExternalAccount = updateExternalAccount;
 exports.updateInvestment = updateInvestment;
@@ -2287,6 +2373,7 @@ exports.updateProfileOverride = updateProfileOverride;
 exports.updateProfileSelf = updateProfileSelf;
 exports.updateRecord = updateRecord;
 exports.updateSkill = updateSkill;
+exports.updateUserSettings = updateUserSettings;
 exports.uploadAvatar = uploadAvatar;
 exports.uploadNamePronunciationAudio = uploadNamePronunciationAudio;
 exports.verifyExternalAccount = verifyExternalAccount;