@singi-labs/sifa-sdk 0.19.44 → 0.19.46

package/dist/query/fetchers/publications.js

@@ -0,0 +1,66 @@
+// src/query/fetchers/publications.ts
+import { apiWrite } from "../client.js";
+function hideOrcidPublication(config, putCode, options = {}) {
+  return apiWrite(config, `/api/profile/orcid-publications/${putCode}/hide`, "POST", options);
+}
+function unhideOrcidPublication(config, putCode, options = {}) {
+  return apiWrite(config, `/api/profile/orcid-publications/${putCode}/hide`, "DELETE", options);
+}
+function hideStandardPublication(config, uri, options = {}) {
+  return apiWrite(
+    config,
+    `/api/profile/standard-publications/${encodeURIComponent(uri)}/hide`,
+    "POST",
+    options
+  );
+}
+function unhideStandardPublication(config, uri, options = {}) {
+  return apiWrite(
+    config,
+    `/api/profile/standard-publications/${encodeURIComponent(uri)}/hide`,
+    "DELETE",
+    options
+  );
+}
+function bulkHideStandardPublications(config, uris, options = {}) {
+  return apiWrite(config, "/api/profile/standard-publications/bulk-hide", "POST", {
+    body: { uris },
+    ...options
+  });
+}
+function bulkUnhideStandardPublications(config, uris, options = {}) {
+  return apiWrite(config, "/api/profile/standard-publications/bulk-hide", "DELETE", {
+    body: { uris },
+    ...options
+  });
+}
+function hideSifaPublication(config, rkey, options = {}) {
+  return apiWrite(config, `/api/profile/publications/${rkey}/hide`, "POST", options);
+}
+function unhideSifaPublication(config, rkey, options = {}) {
+  return apiWrite(config, `/api/profile/publications/${rkey}/hide`, "DELETE", options);
+}
+async function refreshOrcidPublications(config, options = {}) {
+  const result = await apiWrite(
+    config,
+    "/api/profile/orcid-publications/refresh",
+    "POST",
+    { body: {}, ...options }
+  );
+  if (result.success && result.error) {
+    return { success: false, error: result.error };
+  }
+  return result;
+}
+export {
+  bulkHideStandardPublications,
+  bulkUnhideStandardPublications,
+  hideOrcidPublication,
+  hideSifaPublication,
+  hideStandardPublication,
+  refreshOrcidPublications,
+  unhideOrcidPublication,
+  unhideSifaPublication,
+  unhideStandardPublication
+};
+//# sourceMappingURL=publications.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/publications.ts"],"sourcesContent":["import { apiWrite, type ApiFetchOptions, type SifaApiConfig, type WriteResult } from '../client.js';\n\n/** Extended result for {@link refreshOrcidPublications}. */\nexport interface RefreshOrcidPublicationsResult extends WriteResult {\n  added?: number;\n  removed?: number;\n}\n\n/**\n * Hide an ORCID-imported publication from the user's profile. The\n * `putCode` is the ORCID-side identifier; the underlying record stays\n * in the index, only its display is suppressed.\n */\nexport function hideOrcidPublication(\n  config: SifaApiConfig,\n  putCode: number,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, `/api/profile/orcid-publications/${putCode}/hide`, 'POST', options);\n}\n\n/** Restore a previously-hidden ORCID publication. */\nexport function unhideOrcidPublication(\n  config: SifaApiConfig,\n  putCode: number,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, `/api/profile/orcid-publications/${putCode}/hide`, 'DELETE', options);\n}\n\n/** Hide a standard (auto-imported) publication by its AT URI. */\nexport function hideStandardPublication(\n  config: SifaApiConfig,\n  uri: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(\n    config,\n    `/api/profile/standard-publications/${encodeURIComponent(uri)}/hide`,\n    'POST',\n    options,\n  );\n}\n\n/** Restore a previously-hidden standard publication. */\nexport function unhideStandardPublication(\n  config: SifaApiConfig,\n  uri: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(\n    config,\n    `/api/profile/standard-publications/${encodeURIComponent(uri)}/hide`,\n    'DELETE',\n    options,\n  );\n}\n\n/** Bulk-hide standard publications by AT URI list. */\nexport function bulkHideStandardPublications(\n  config: SifaApiConfig,\n  uris: string[],\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, '/api/profile/standard-publications/bulk-hide', 'POST', {\n    body: { uris },\n    ...options,\n  });\n}\n\n/** Bulk-unhide standard publications by AT URI list. */\nexport function bulkUnhideStandardPublications(\n  config: SifaApiConfig,\n  uris: string[],\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, '/api/profile/standard-publications/bulk-hide', 'DELETE', {\n    body: { uris },\n    ...options,\n  });\n}\n\n/** Hide an `id.sifa.profile.publication` (user-authored publication record). */\nexport function hideSifaPublication(\n  config: SifaApiConfig,\n  rkey: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, `/api/profile/publications/${rkey}/hide`, 'POST', options);\n}\n\n/** Restore a previously-hidden Sifa publication. */\nexport function unhideSifaPublication(\n  config: SifaApiConfig,\n  rkey: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, `/api/profile/publications/${rkey}/hide`, 'DELETE', options);\n}\n\n/**\n * Re-pull the authenticated user's ORCID publications. Returns counts\n * of added and removed records. The server returns `{ error: '...' }`\n * inline (not via HTTP status) on quota / linkage failures; the SDK\n * folds that into `{ success: false, error }` to keep the contract\n * consistent with other mutations.\n */\nexport async function refreshOrcidPublications(\n  config: SifaApiConfig,\n  options: ApiFetchOptions = {},\n): Promise<RefreshOrcidPublicationsResult> {\n  const result = await apiWrite<{ added?: number; removed?: number; error?: string }>(\n    config,\n    '/api/profile/orcid-publications/refresh',\n    'POST',\n    { body: {}, ...options },\n  );\n  if (result.success && result.error) {\n    return { success: false, error: result.error };\n  }\n  return result;\n}\n"],"mappings":";AAAA,SAAS,gBAA4E;AAa9E,SAAS,qBACd,QACA,SACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,mCAAmC,OAAO,SAAS,QAAQ,OAAO;AAC5F;AAGO,SAAS,uBACd,QACA,SACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,mCAAmC,OAAO,SAAS,UAAU,OAAO;AAC9F;AAGO,SAAS,wBACd,QACA,KACA,UAA2B,CAAC,GACN;AACtB,SAAO;AAAA,IACL;AAAA,IACA,sCAAsC,mBAAmB,GAAG,CAAC;AAAA,IAC7D;AAAA,IACA;AAAA,EACF;AACF;AAGO,SAAS,0BACd,QACA,KACA,UAA2B,CAAC,GACN;AACtB,SAAO;AAAA,IACL;AAAA,IACA,sCAAsC,mBAAmB,GAAG,CAAC;AAAA,IAC7D;AAAA,IACA;AAAA,EACF;AACF;AAGO,SAAS,6BACd,QACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,gDAAgD,QAAQ;AAAA,IAC9E,MAAM,EAAE,KAAK;AAAA,IACb,GAAG;AAAA,EACL,CAAC;AACH;AAGO,SAAS,+BACd,QACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,gDAAgD,UAAU;AAAA,IAChF,MAAM,EAAE,KAAK;AAAA,IACb,GAAG;AAAA,EACL,CAAC;AACH;AAGO,SAAS,oBACd,QACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,6BAA6B,IAAI,SAAS,QAAQ,OAAO;AACnF;AAGO,SAAS,sBACd,QACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,6BAA6B,IAAI,SAAS,UAAU,OAAO;AACrF;AASA,eAAsB,yBACpB,QACA,UAA2B,CAAC,GACa;AACzC,QAAM,SAAS,MAAM;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,IACA,EAAE,MAAM,CAAC,GAAG,GAAG,QAAQ;AAAA,EACzB;AACA,MAAI,OAAO,WAAW,OAAO,OAAO;AAClC,WAAO,EAAE,SAAS,OAAO,OAAO,OAAO,MAAM;AAAA,EAC/C;AACA,SAAO;AACT;","names":[]}

package/dist/query/fetchers/quoted-posts.js

@@ -0,0 +1,40 @@
+// src/query/fetchers/quoted-posts.ts
+import { apiFetch } from "../client.js";
+var QUOTED_POSTS_BATCH_MAX = 20;
+async function resolveQuotedPosts(config, uris, options = {}) {
+  if (uris.length === 0) return {};
+  const unique = [...new Set(uris)];
+  const batches = [];
+  for (let i = 0; i < unique.length; i += QUOTED_POSTS_BATCH_MAX) {
+    batches.push(unique.slice(i, i + QUOTED_POSTS_BATCH_MAX));
+  }
+  const headers = { ...options.headers ?? {} };
+  if (options.cookieHeader) headers.cookie = options.cookieHeader;
+  const results = {};
+  await Promise.all(
+    batches.map(async (batch) => {
+      try {
+        const data = await apiFetch(
+          config,
+          "/api/quoted-posts/resolve",
+          {
+            method: "POST",
+            body: { uris: batch },
+            credentials: "include",
+            timeoutMs: 8e3,
+            ...options,
+            headers
+          }
+        );
+        Object.assign(results, data);
+      } catch {
+      }
+    })
+  );
+  return results;
+}
+export {
+  QUOTED_POSTS_BATCH_MAX,
+  resolveQuotedPosts
+};
+//# sourceMappingURL=quoted-posts.js.map

package/dist/query/fetchers/quoted-posts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/quoted-posts.ts"],"sourcesContent":["import { apiFetch, type ApiFetchOptions, type SifaApiConfig } from '../client.js';\n\nexport interface QuotedPostAuthor {\n  did: string;\n  handle: string;\n  displayName?: string;\n  avatar?: string;\n}\n\nexport interface QuotedPostImage {\n  thumb: string;\n  fullsize: string;\n  alt?: string;\n}\n\nexport interface QuotedPostView {\n  uri: string;\n  cid: string;\n  author: QuotedPostAuthor;\n  text: string;\n  createdAt: string;\n  images?: QuotedPostImage[];\n}\n\nexport type QuotedPostResult =\n  | { status: 'ok'; record: QuotedPostView }\n  | { status: 'deleted'; uri: string }\n  | { status: 'unavailable'; uri: string };\n\n/** Max URIs per request to `POST /api/quoted-posts/resolve` (mirrors server cap). */\nexport const QUOTED_POSTS_BATCH_MAX = 20;\n\nexport interface ResolveQuotedPostsOptions extends ApiFetchOptions {\n  /** Cookie header for Next.js RSC server-side calls; ignored in browsers. */\n  cookieHeader?: string;\n}\n\n/**\n * Resolve a batch of AT-URIs to their quoted-post snapshots via the Sifa AppView.\n *\n * Auto-deduplicates input URIs and splits requests into chunks of\n * {@link QUOTED_POSTS_BATCH_MAX} so callers can pass an arbitrary-length array.\n * Each chunk is fired in parallel. The server caches results in Valkey, so\n * repeated calls for the same URI are cheap.\n *\n * Returns a map of `uri -> QuotedPostResult`. URIs that fail (network error,\n * non-2xx, or the server omitting them) are absent from the map; the caller\n * should render a skeleton or tombstone for those.\n */\nexport async function resolveQuotedPosts(\n  config: SifaApiConfig,\n  uris: string[],\n  options: ResolveQuotedPostsOptions = {},\n): Promise<Record<string, QuotedPostResult>> {\n  if (uris.length === 0) return {};\n\n  const unique = [...new Set(uris)];\n  const batches: string[][] = [];\n  for (let i = 0; i < unique.length; i += QUOTED_POSTS_BATCH_MAX) {\n    batches.push(unique.slice(i, i + QUOTED_POSTS_BATCH_MAX));\n  }\n\n  const headers: Record<string, string> = { ...(options.headers ?? {}) };\n  if (options.cookieHeader) headers.cookie = options.cookieHeader;\n\n  const results: Record<string, QuotedPostResult> = {};\n  await Promise.all(\n    batches.map(async (batch) => {\n      try {\n        const data = await apiFetch<Record<string, QuotedPostResult>>(\n          config,\n          '/api/quoted-posts/resolve',\n          {\n            method: 'POST',\n            body: { uris: batch },\n            credentials: 'include',\n            timeoutMs: 8000,\n            ...options,\n            headers,\n          },\n        );\n        Object.assign(results, data);\n      } catch {\n        // Leave failed URIs absent so the consumer can render a fallback.\n      }\n    }),\n  );\n\n  return results;\n}\n"],"mappings":";AAAA,SAAS,gBAA0D;AA8B5D,IAAM,yBAAyB;AAmBtC,eAAsB,mBACpB,QACA,MACA,UAAqC,CAAC,GACK;AAC3C,MAAI,KAAK,WAAW,EAAG,QAAO,CAAC;AAE/B,QAAM,SAAS,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC;AAChC,QAAM,UAAsB,CAAC;AAC7B,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,wBAAwB;AAC9D,YAAQ,KAAK,OAAO,MAAM,GAAG,IAAI,sBAAsB,CAAC;AAAA,EAC1D;AAEA,QAAM,UAAkC,EAAE,GAAI,QAAQ,WAAW,CAAC,EAAG;AACrE,MAAI,QAAQ,aAAc,SAAQ,SAAS,QAAQ;AAEnD,QAAM,UAA4C,CAAC;AACnD,QAAM,QAAQ;AAAA,IACZ,QAAQ,IAAI,OAAO,UAAU;AAC3B,UAAI;AACF,cAAM,OAAO,MAAM;AAAA,UACjB;AAAA,UACA;AAAA,UACA;AAAA,YACE,QAAQ;AAAA,YACR,MAAM,EAAE,MAAM,MAAM;AAAA,YACpB,aAAa;AAAA,YACb,WAAW;AAAA,YACX,GAAG;AAAA,YACH;AAAA,UACF;AAAA,QACF;AACA,eAAO,OAAO,SAAS,IAAI;AAAA,MAC7B,QAAQ;AAAA,MAER;AAAA,IACF,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}

package/dist/query/fetchers/reactions.js

@@ -0,0 +1,85 @@
+// src/query/fetchers/reactions.ts
+import {
+  apiFetch,
+  apiWrite
+} from "../client.js";
+async function fetchReactionStatus(config, uris, options = {}) {
+  if (uris.length === 0) return {};
+  const headers = { ...options.headers ?? {} };
+  if (options.cookieHeader) headers.cookie = options.cookieHeader;
+  try {
+    return await apiFetch(
+      config,
+      `/api/reactions/status?uris=${encodeURIComponent(uris.join(","))}`,
+      {
+        credentials: "include",
+        ...options,
+        headers
+      }
+    );
+  } catch {
+    return null;
+  }
+}
+async function checkAppAccount(config, appId, options = {}) {
+  const headers = { ...options.headers ?? {} };
+  if (options.cookieHeader) headers.cookie = options.cookieHeader;
+  try {
+    return await apiFetch(
+      config,
+      `/api/reactions/account-check/${encodeURIComponent(appId)}`,
+      {
+        credentials: "include",
+        ...options,
+        headers
+      }
+    );
+  } catch {
+    return null;
+  }
+}
+async function createReaction(config, targetUri, appId, targetCid, options = {}) {
+  const fetchFn = config.fetch ?? globalThis.fetch;
+  const url = `${config.baseUrl}/api/reactions`;
+  try {
+    const res = await fetchFn(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...options.headers ?? {} },
+      credentials: options.credentials ?? "include",
+      body: JSON.stringify({ targetUri, appId, targetCid }),
+      signal: options.signal ?? AbortSignal.timeout(options.timeoutMs ?? 1e4)
+    });
+    if (!res.ok) {
+      if (res.status === 403) {
+        try {
+          const body = await res.json();
+          if (body.error === "ScopeInsufficient") {
+            return {
+              ok: false,
+              error: { type: "scope_insufficient", requiredScope: body.requiredScope }
+            };
+          }
+        } catch {
+        }
+      }
+      return { ok: false, error: { type: "error" } };
+    }
+    const data = await res.json();
+    return { ok: true, data };
+  } catch {
+    return { ok: false, error: { type: "error" } };
+  }
+}
+function deleteReaction(config, targetUri, appId, options = {}) {
+  return apiWrite(config, "/api/reactions", "DELETE", {
+    body: { targetUri, appId },
+    ...options
+  });
+}
+export {
+  checkAppAccount,
+  createReaction,
+  deleteReaction,
+  fetchReactionStatus
+};
+//# sourceMappingURL=reactions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/reactions.ts"],"sourcesContent":["import {\n  apiFetch,\n  apiWrite,\n  type ApiFetchOptions,\n  type SifaApiConfig,\n  type WriteResult,\n} from '../client.js';\n\n/** Per-URI reaction state for the authenticated viewer. */\nexport interface ReactionStatus {\n  reacted: boolean;\n  rkey?: string;\n  collection?: string;\n}\n\n/** Result of checking whether the authenticated viewer has an account on a given app. */\nexport interface AccountCheckResult {\n  hasAccount: boolean;\n  appName: string;\n  appUrl: string;\n}\n\nexport interface FetchReactionStatusOptions 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 * Batch-look up reaction status for multiple URIs. Returns `{}` for an\n * empty input list (no network call) and `null` on any error.\n */\nexport async function fetchReactionStatus(\n  config: SifaApiConfig,\n  uris: string[],\n  options: FetchReactionStatusOptions = {},\n): Promise<Record<string, ReactionStatus> | null> {\n  if (uris.length === 0) return {};\n\n  const headers: Record<string, string> = { ...(options.headers ?? {}) };\n  if (options.cookieHeader) headers.cookie = options.cookieHeader;\n\n  try {\n    return await apiFetch<Record<string, ReactionStatus>>(\n      config,\n      `/api/reactions/status?uris=${encodeURIComponent(uris.join(','))}`,\n      {\n        credentials: 'include',\n        ...options,\n        headers,\n      },\n    );\n  } catch {\n    return null;\n  }\n}\n\nexport interface CheckAppAccountOptions extends ApiFetchOptions {\n  cookieHeader?: string;\n}\n\n/**\n * Check whether the authenticated viewer has an account on a given app.\n * Returns `null` on any error.\n */\nexport async function checkAppAccount(\n  config: SifaApiConfig,\n  appId: string,\n  options: CheckAppAccountOptions = {},\n): Promise<AccountCheckResult | null> {\n  const headers: Record<string, string> = { ...(options.headers ?? {}) };\n  if (options.cookieHeader) headers.cookie = options.cookieHeader;\n\n  try {\n    return await apiFetch<AccountCheckResult>(\n      config,\n      `/api/reactions/account-check/${encodeURIComponent(appId)}`,\n      {\n        credentials: 'include',\n        ...options,\n        headers,\n      },\n    );\n  } catch {\n    return null;\n  }\n}\n\n/** Result of a successful {@link createReaction}. */\nexport interface ReactionResult {\n  uri: string;\n  rkey: string;\n}\n\n/** Structured error returned by {@link createReaction} on failure. */\nexport interface ReactionError {\n  type: 'scope_insufficient' | 'error';\n  /** When `type === 'scope_insufficient'`, the lexicon scope the user must re-authorize for. */\n  requiredScope?: string;\n}\n\n/**\n * Create a reaction (like / star) on a target ATproto record.\n *\n * Returns a discriminated-union result instead of the generic\n * {@link WriteResult} shape because reactions have a distinct\n * \"scope insufficient\" failure that callers handle differently from\n * other errors (it triggers an OAuth scope-upgrade flow rather than\n * an error toast).\n *\n * Never throws.\n */\nexport async function createReaction(\n  config: SifaApiConfig,\n  targetUri: string,\n  appId: string,\n  targetCid?: string,\n  options: ApiFetchOptions = {},\n): Promise<{ ok: true; data: ReactionResult } | { ok: false; error: ReactionError }> {\n  const fetchFn = config.fetch ?? globalThis.fetch;\n  const url = `${config.baseUrl}/api/reactions`;\n\n  try {\n    const res = await fetchFn(url, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', ...(options.headers ?? {}) },\n      credentials: options.credentials ?? 'include',\n      body: JSON.stringify({ targetUri, appId, targetCid }),\n      signal: options.signal ?? AbortSignal.timeout(options.timeoutMs ?? 10_000),\n    });\n\n    if (!res.ok) {\n      if (res.status === 403) {\n        try {\n          const body = (await res.json()) as { error?: string; requiredScope?: string };\n          if (body.error === 'ScopeInsufficient') {\n            return {\n              ok: false,\n              error: { type: 'scope_insufficient', requiredScope: body.requiredScope },\n            };\n          }\n        } catch {\n          // Fall through to generic error\n        }\n      }\n      return { ok: false, error: { type: 'error' } };\n    }\n\n    const data = (await res.json()) as ReactionResult;\n    return { ok: true, data };\n  } catch {\n    return { ok: false, error: { type: 'error' } };\n  }\n}\n\n/**\n * Delete a reaction (like / star) on a target ATproto record. Returns\n * `{ success: true }` on 2xx, `{ success: false, error }` on failure.\n */\nexport function deleteReaction(\n  config: SifaApiConfig,\n  targetUri: string,\n  appId: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, '/api/reactions', 'DELETE', {\n    body: { targetUri, appId },\n    ...options,\n  });\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AA6BP,eAAsB,oBACpB,QACA,MACA,UAAsC,CAAC,GACS;AAChD,MAAI,KAAK,WAAW,EAAG,QAAO,CAAC;AAE/B,QAAM,UAAkC,EAAE,GAAI,QAAQ,WAAW,CAAC,EAAG;AACrE,MAAI,QAAQ,aAAc,SAAQ,SAAS,QAAQ;AAEnD,MAAI;AACF,WAAO,MAAM;AAAA,MACX;AAAA,MACA,8BAA8B,mBAAmB,KAAK,KAAK,GAAG,CAAC,CAAC;AAAA,MAChE;AAAA,QACE,aAAa;AAAA,QACb,GAAG;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAUA,eAAsB,gBACpB,QACA,OACA,UAAkC,CAAC,GACC;AACpC,QAAM,UAAkC,EAAE,GAAI,QAAQ,WAAW,CAAC,EAAG;AACrE,MAAI,QAAQ,aAAc,SAAQ,SAAS,QAAQ;AAEnD,MAAI;AACF,WAAO,MAAM;AAAA,MACX;AAAA,MACA,gCAAgC,mBAAmB,KAAK,CAAC;AAAA,MACzD;AAAA,QACE,aAAa;AAAA,QACb,GAAG;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AA0BA,eAAsB,eACpB,QACA,WACA,OACA,WACA,UAA2B,CAAC,GACuD;AACnF,QAAM,UAAU,OAAO,SAAS,WAAW;AAC3C,QAAM,MAAM,GAAG,OAAO,OAAO;AAE7B,MAAI;AACF,UAAM,MAAM,MAAM,QAAQ,KAAK;AAAA,MAC7B,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,oBAAoB,GAAI,QAAQ,WAAW,CAAC,EAAG;AAAA,MAC1E,aAAa,QAAQ,eAAe;AAAA,MACpC,MAAM,KAAK,UAAU,EAAE,WAAW,OAAO,UAAU,CAAC;AAAA,MACpD,QAAQ,QAAQ,UAAU,YAAY,QAAQ,QAAQ,aAAa,GAAM;AAAA,IAC3E,CAAC;AAED,QAAI,CAAC,IAAI,IAAI;AACX,UAAI,IAAI,WAAW,KAAK;AACtB,YAAI;AACF,gBAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,cAAI,KAAK,UAAU,qBAAqB;AACtC,mBAAO;AAAA,cACL,IAAI;AAAA,cACJ,OAAO,EAAE,MAAM,sBAAsB,eAAe,KAAK,cAAc;AAAA,YACzE;AAAA,UACF;AAAA,QACF,QAAQ;AAAA,QAER;AAAA,MACF;AACA,aAAO,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,QAAQ,EAAE;AAAA,IAC/C;AAEA,UAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,WAAO,EAAE,IAAI,MAAM,KAAK;AAAA,EAC1B,QAAQ;AACN,WAAO,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,QAAQ,EAAE;AAAA,EAC/C;AACF;AAMO,SAAS,eACd,QACA,WACA,OACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,kBAAkB,UAAU;AAAA,IAClD,MAAM,EAAE,WAAW,MAAM;AAAA,IACzB,GAAG;AAAA,EACL,CAAC;AACH;","names":[]}

package/dist/query/fetchers/received-endorsements.js

@@ -0,0 +1,20 @@
+// src/query/fetchers/received-endorsements.ts
+import { encodeIdentifier, apiFetch } from "../client.js";
+async function fetchReceivedEndorsements(config, did, options = {}) {
+  const { limit, ...fetchOptions } = options;
+  const qs = limit ? `?limit=${limit}` : "";
+  try {
+    const data = await apiFetch(
+      config,
+      `/api/endorsement/${encodeIdentifier(did)}${qs}`,
+      { cache: "no-store", timeoutMs: 5e3, ...fetchOptions }
+    );
+    return { endorsements: data?.endorsements ?? [], cursor: data?.cursor };
+  } catch {
+    return { endorsements: [] };
+  }
+}
+export {
+  fetchReceivedEndorsements
+};
+//# sourceMappingURL=received-endorsements.js.map

package/dist/query/fetchers/received-endorsements.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/received-endorsements.ts"],"sourcesContent":["import { encodeIdentifier, apiFetch, type ApiFetchOptions, type SifaApiConfig } from '../client.js';\n\nexport interface ReceivedEndorsement {\n  endorserDid: string;\n  /** Absent when the endorser has no Sifa profile yet. */\n  endorserHandle?: string;\n  endorserDisplayName?: string;\n  endorserAvatar?: string;\n  skillUri?: string;\n  skillCid?: string;\n  skillName: string;\n  comment?: string;\n  createdAt: string;\n}\n\nexport interface ReceivedEndorsementsPage {\n  endorsements: ReceivedEndorsement[];\n  cursor?: string;\n}\n\n/**\n * Confirmed endorsements a DID has received, newest first.\n *\n * Only confirmed ones exist here: the AppView inner-joins against the\n * confirmation records, so an endorsement the subject has not accepted is\n * absent rather than pending. Public -- no credentials needed.\n *\n * Returns an empty page on failure so a surface that merely decorates a page\n * cannot break it.\n */\nexport async function fetchReceivedEndorsements(\n  config: SifaApiConfig,\n  did: string,\n  options: { limit?: number } & ApiFetchOptions = {},\n): Promise<ReceivedEndorsementsPage> {\n  const { limit, ...fetchOptions } = options;\n  const qs = limit ? `?limit=${limit}` : '';\n  try {\n    const data = await apiFetch<ReceivedEndorsementsPage>(\n      config,\n      `/api/endorsement/${encodeIdentifier(did)}${qs}`,\n      { cache: 'no-store', timeoutMs: 5000, ...fetchOptions },\n    );\n    return { endorsements: data?.endorsements ?? [], cursor: data?.cursor };\n  } catch {\n    return { endorsements: [] };\n  }\n}\n"],"mappings":";AAAA,SAAS,kBAAkB,gBAA0D;AA8BrF,eAAsB,0BACpB,QACA,KACA,UAAgD,CAAC,GACd;AACnC,QAAM,EAAE,OAAO,GAAG,aAAa,IAAI;AACnC,QAAM,KAAK,QAAQ,UAAU,KAAK,KAAK;AACvC,MAAI;AACF,UAAM,OAAO,MAAM;AAAA,MACjB;AAAA,MACA,oBAAoB,iBAAiB,GAAG,CAAC,GAAG,EAAE;AAAA,MAC9C,EAAE,OAAO,YAAY,WAAW,KAAM,GAAG,aAAa;AAAA,IACxD;AACA,WAAO,EAAE,cAAc,MAAM,gBAAgB,CAAC,GAAG,QAAQ,MAAM,OAAO;AAAA,EACxE,QAAQ;AACN,WAAO,EAAE,cAAc,CAAC,EAAE;AAAA,EAC5B;AACF;","names":[]}

package/dist/query/fetchers/reciprocity.js

@@ -0,0 +1,23 @@
+// src/query/fetchers/reciprocity.ts
+import { apiFetch } from "../client.js";
+async function fetchReciprocityCandidate(config, options = {}) {
+  try {
+    const data = await apiFetch(
+      config,
+      "/api/endorsements/reciprocity-candidate",
+      {
+        cache: "no-store",
+        credentials: "include",
+        timeoutMs: 5e3,
+        ...options
+      }
+    );
+    return data?.candidate ?? null;
+  } catch {
+    return null;
+  }
+}
+export {
+  fetchReciprocityCandidate
+};
+//# sourceMappingURL=reciprocity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/reciprocity.ts"],"sourcesContent":["import { apiFetch, type ApiFetchOptions, type SifaApiConfig } from '../client.js';\n\nexport interface ReciprocitySkill {\n  name: string;\n  uri: string;\n  /** Absent until the firehose indexes the skill; the AppView resolves it. */\n  cid?: string;\n}\n\nexport interface ReciprocityCandidate {\n  did: string;\n  handle: string;\n  displayName?: string;\n  avatar?: string;\n  skills: ReciprocitySkill[];\n}\n\n/**\n * Someone the signed-in user follows on Sifa whose skills they could endorse.\n *\n * The AppView picks: it filters people already dismissed and anyone blocked,\n * requires at least one skill, and rotates the choice every twelve hours so\n * the same person is not offered indefinitely.\n *\n * `null` means there is nobody left to suggest -- a real state, not an error.\n * Failures also yield `null` so a broken suggestion never breaks the homepage.\n */\nexport async function fetchReciprocityCandidate(\n  config: SifaApiConfig,\n  options: ApiFetchOptions = {},\n): Promise<ReciprocityCandidate | null> {\n  try {\n    const data = await apiFetch<{ candidate: ReciprocityCandidate | null }>(\n      config,\n      '/api/endorsements/reciprocity-candidate',\n      {\n        cache: 'no-store',\n        credentials: 'include',\n        timeoutMs: 5000,\n        ...options,\n      },\n    );\n    return data?.candidate ?? null;\n  } catch {\n    return null;\n  }\n}\n"],"mappings":";AAAA,SAAS,gBAA0D;AA2BnE,eAAsB,0BACpB,QACA,UAA2B,CAAC,GACU;AACtC,MAAI;AACF,UAAM,OAAO,MAAM;AAAA,MACjB;AAAA,MACA;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,aAAa;AAAA,QACb,WAAW;AAAA,QACX,GAAG;AAAA,MACL;AAAA,IACF;AACA,WAAO,MAAM,aAAa;AAAA,EAC5B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/query/fetchers/records.js

@@ -0,0 +1,27 @@
+// src/query/fetchers/records.ts
+import {
+  apiWrite,
+  apiWriteCreate
+} from "../client.js";
+function createRecord(config, collection, data, options = {}) {
+  return apiWriteCreate(
+    config,
+    `/api/profile/records/${encodeURIComponent(collection)}`,
+    data,
+    options
+  );
+}
+function updateRecord(config, collection, rkey, data, options = {}) {
+  const path = `/api/profile/records/${encodeURIComponent(collection)}/${encodeURIComponent(rkey)}`;
+  return apiWrite(config, path, "PUT", { body: data, ...options });
+}
+function deleteRecord(config, collection, rkey, options = {}) {
+  const path = `/api/profile/records/${encodeURIComponent(collection)}/${encodeURIComponent(rkey)}`;
+  return apiWrite(config, path, "DELETE", options);
+}
+export {
+  createRecord,
+  deleteRecord,
+  updateRecord
+};
+//# sourceMappingURL=records.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/records.ts"],"sourcesContent":["import {\n  apiWrite,\n  apiWriteCreate,\n  type ApiFetchOptions,\n  type CreateResult,\n  type SifaApiConfig,\n  type WriteResult,\n} from '../client.js';\n\n/**\n * Generic record-create escape hatch. Most callers should prefer the\n * dedicated section helpers (`createPosition`, `createEducation`, etc.)\n * which take typed payloads and ship matching hooks. Use this when the\n * lexicon doesn't yet have a dedicated endpoint (certifications,\n * projects, publications, volunteering, honors, languages, courses).\n *\n * `collection` is a `id.sifa.profile.*` collection NSID. Routes to\n * `POST /api/profile/records/<collection>`.\n */\nexport function createRecord(\n  config: SifaApiConfig,\n  collection: string,\n  data: Record<string, unknown>,\n  options: ApiFetchOptions = {},\n): Promise<CreateResult> {\n  return apiWriteCreate(\n    config,\n    `/api/profile/records/${encodeURIComponent(collection)}`,\n    data,\n    options,\n  );\n}\n\n/** Generic record-update escape hatch. See {@link createRecord}. */\nexport function updateRecord(\n  config: SifaApiConfig,\n  collection: string,\n  rkey: string,\n  data: Record<string, unknown>,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  const path = `/api/profile/records/${encodeURIComponent(collection)}/${encodeURIComponent(rkey)}`;\n  return apiWrite(config, path, 'PUT', { body: data, ...options });\n}\n\n/** Generic record-delete escape hatch. See {@link createRecord}. */\nexport function deleteRecord(\n  config: SifaApiConfig,\n  collection: string,\n  rkey: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  const path = `/api/profile/records/${encodeURIComponent(collection)}/${encodeURIComponent(rkey)}`;\n  return apiWrite(config, path, 'DELETE', options);\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,OAKK;AAYA,SAAS,aACd,QACA,YACA,MACA,UAA2B,CAAC,GACL;AACvB,SAAO;AAAA,IACL;AAAA,IACA,wBAAwB,mBAAmB,UAAU,CAAC;AAAA,IACtD;AAAA,IACA;AAAA,EACF;AACF;AAGO,SAAS,aACd,QACA,YACA,MACA,MACA,UAA2B,CAAC,GACN;AACtB,QAAM,OAAO,wBAAwB,mBAAmB,UAAU,CAAC,IAAI,mBAAmB,IAAI,CAAC;AAC/F,SAAO,SAAS,QAAQ,MAAM,OAAO,EAAE,MAAM,MAAM,GAAG,QAAQ,CAAC;AACjE;AAGO,SAAS,aACd,QACA,YACA,MACA,UAA2B,CAAC,GACN;AACtB,QAAM,OAAO,wBAAwB,mBAAmB,UAAU,CAAC,IAAI,mBAAmB,IAAI,CAAC;AAC/F,SAAO,SAAS,QAAQ,MAAM,UAAU,OAAO;AACjD;","names":[]}

package/dist/query/fetchers/repo-inventory.js

@@ -0,0 +1,23 @@
+// src/query/fetchers/repo-inventory.ts
+import { apiFetch, apiWrite } from "../client.js";
+function fetchRepoInventory(config, options = {}) {
+  return apiFetch(config, "/api/me/repo-inventory", {
+    credentials: "include",
+    ...options
+  });
+}
+function deleteRepoRecords(config, input, options = {}) {
+  return apiWrite(config, "/api/me/repo-delete", "POST", {
+    body: input,
+    ...options
+  });
+}
+function repoExportUrl(config) {
+  return `${config.baseUrl}/api/me/repo-export`;
+}
+export {
+  deleteRepoRecords,
+  fetchRepoInventory,
+  repoExportUrl
+};
+//# sourceMappingURL=repo-inventory.js.map

package/dist/query/fetchers/repo-inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/repo-inventory.ts"],"sourcesContent":["import type { RepoDeleteResult, RepoInventory } from '../../repo/types.js';\nimport { apiFetch, apiWrite, type ApiFetchOptions, type SifaApiConfig } from '../client.js';\n\n/**\n * Read what the user's PDS actually holds under id.sifa.*.\n *\n * A failure is not flattened into an empty inventory. Zero records reads as\n * \"Sifa has stored nothing about you\", and a request that never arrived must\n * not be allowed to say that. Let it throw.\n */\nexport function fetchRepoInventory(\n  config: SifaApiConfig,\n  options: ApiFetchOptions = {},\n): Promise<RepoInventory> {\n  return apiFetch<RepoInventory>(config, '/api/me/repo-inventory', {\n    credentials: 'include',\n    ...options,\n  });\n}\n\nexport interface RepoDeleteInput {\n  collection: string;\n  /** The records to remove. Omit and set `all` to remove the whole collection. */\n  rkeys?: string[];\n  /**\n   * Remove every record in the collection, including ones written between the\n   * inventory read and this call. A UI offering \"delete all of X\" must send\n   * this rather than the rkeys it happened to see, or a record created in\n   * between silently survives a delete the user believes was complete.\n   */\n  all?: boolean;\n}\n\n/**\n * Delete records from the user's own repo.\n *\n * The returned `success` means the request was accepted, NOT that the records\n * are gone: read `results` for that, per record. `needsScopeUpgrade` means\n * nothing was attempted and the user has to grant the scope first.\n *\n * Destructive and not undoable -- a deleted record's CID cannot be restored.\n * The server enforces the id.sifa.* boundary and the session check; the SDK\n * adds no confirmation step, so wrap call sites in one.\n */\nexport function deleteRepoRecords(\n  config: SifaApiConfig,\n  input: RepoDeleteInput,\n  options: ApiFetchOptions = {},\n): Promise<RepoDeleteResult & { success: boolean; error?: string }> {\n  return apiWrite<RepoDeleteResult>(config, '/api/me/repo-delete', 'POST', {\n    body: input,\n    ...options,\n  });\n}\n\n/**\n * URL of the raw-record download.\n *\n * A URL rather than a fetcher: the response is a file the browser saves, and\n * routing it through fetch would buffer the whole repo in memory to hand it\n * straight back to a download anchor.\n */\nexport function repoExportUrl(config: SifaApiConfig): string {\n  return `${config.baseUrl}/api/me/repo-export`;\n}\n"],"mappings":";AACA,SAAS,UAAU,gBAA0D;AAStE,SAAS,mBACd,QACA,UAA2B,CAAC,GACJ;AACxB,SAAO,SAAwB,QAAQ,0BAA0B;AAAA,IAC/D,aAAa;AAAA,IACb,GAAG;AAAA,EACL,CAAC;AACH;AA0BO,SAAS,kBACd,QACA,OACA,UAA2B,CAAC,GACsC;AAClE,SAAO,SAA2B,QAAQ,uBAAuB,QAAQ;AAAA,IACvE,MAAM;AAAA,IACN,GAAG;AAAA,EACL,CAAC;AACH;AASO,SAAS,cAAc,QAA+B;AAC3D,SAAO,GAAG,OAAO,OAAO;AAC1B;","names":[]}

package/dist/query/fetchers/roadmap.js

@@ -0,0 +1,73 @@
+// src/query/fetchers/roadmap.ts
+import {
+  apiFetch,
+  apiWrite
+} from "../client.js";
+async function fetchRoadmapVotes(config, options = {}) {
+  try {
+    return await apiFetch(config, "/api/roadmap/votes", {
+      cache: "no-store",
+      ...options
+    });
+  } catch {
+    return {};
+  }
+}
+async function fetchMyRoadmapVotes(config, options = {}) {
+  const headers = { ...options.headers ?? {} };
+  if (options.cookieHeader) headers.cookie = options.cookieHeader;
+  try {
+    const data = await apiFetch(config, "/api/roadmap/votes/me", {
+      credentials: "include",
+      ...options,
+      headers
+    });
+    return data.voted ?? [];
+  } catch {
+    return [];
+  }
+}
+async function castRoadmapVote(config, key, options = {}) {
+  const fetchFn = config.fetch ?? globalThis.fetch;
+  const url = `${config.baseUrl}/api/roadmap/votes/${encodeURIComponent(key)}`;
+  try {
+    const res = await fetchFn(url, {
+      method: "POST",
+      // No body: the item key is in the URL. Do NOT declare a JSON content-type
+      // for an empty body — Fastify rejects that with a 400 before the handler
+      // runs. Only forward caller-provided headers.
+      ...options.headers ? { headers: options.headers } : {},
+      credentials: options.credentials ?? "include",
+      signal: options.signal ?? AbortSignal.timeout(options.timeoutMs ?? 1e4)
+    });
+    if (!res.ok) {
+      if (res.status === 403) {
+        try {
+          const body = await res.json();
+          if (body.error === "ScopeInsufficient") {
+            return {
+              ok: false,
+              error: { type: "scope_insufficient", requiredScope: body.requiredScope }
+            };
+          }
+        } catch {
+        }
+      }
+      return { ok: false, error: { type: "error" } };
+    }
+    const data = await res.json();
+    return { ok: true, data };
+  } catch {
+    return { ok: false, error: { type: "error" } };
+  }
+}
+function retractRoadmapVote(config, key, options = {}) {
+  return apiWrite(config, `/api/roadmap/votes/${encodeURIComponent(key)}`, "DELETE", options);
+}
+export {
+  castRoadmapVote,
+  fetchMyRoadmapVotes,
+  fetchRoadmapVotes,
+  retractRoadmapVote
+};
+//# sourceMappingURL=roadmap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/roadmap.ts"],"sourcesContent":["import {\n  apiFetch,\n  apiWrite,\n  type ApiFetchOptions,\n  type SifaApiConfig,\n  type WriteResult,\n} from '../client.js';\n\n/** Voter on a roadmap item. */\nexport interface RoadmapVoter {\n  did: string;\n  avatarUrl?: string;\n}\n\n/** Map of item key -> vote tally and voter list. */\nexport type RoadmapVotesResponse = Record<string, { count: number; voters: RoadmapVoter[] }>;\n\n/**\n * Public roadmap vote tallies, keyed by item. Returns `{}` on any error.\n */\nexport async function fetchRoadmapVotes(\n  config: SifaApiConfig,\n  options: ApiFetchOptions = {},\n): Promise<RoadmapVotesResponse> {\n  try {\n    return await apiFetch<RoadmapVotesResponse>(config, '/api/roadmap/votes', {\n      cache: 'no-store',\n      ...options,\n    });\n  } catch {\n    return {};\n  }\n}\n\nexport interface FetchMyRoadmapVotesOptions 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 * Roadmap items the authenticated user has voted on. Returns `[]` on any\n * error or when the response payload is shaped unexpectedly.\n */\nexport async function fetchMyRoadmapVotes(\n  config: SifaApiConfig,\n  options: FetchMyRoadmapVotesOptions = {},\n): Promise<string[]> {\n  const headers: Record<string, string> = { ...(options.headers ?? {}) };\n  if (options.cookieHeader) headers.cookie = options.cookieHeader;\n\n  try {\n    const data = await apiFetch<{ voted?: string[] }>(config, '/api/roadmap/votes/me', {\n      credentials: 'include',\n      ...options,\n      headers,\n    });\n    return data.voted ?? [];\n  } catch {\n    return [];\n  }\n}\n\n/** Result of a successful {@link castRoadmapVote} -- the created upvote record. */\nexport interface RoadmapVoteResult {\n  uri: string;\n  rkey: string;\n}\n\n/** Structured error returned by {@link castRoadmapVote} on failure. */\nexport interface RoadmapVoteError {\n  type: 'scope_insufficient' | 'error';\n  /**\n   * When `type === 'scope_insufficient'`, the lexicon collection the user must\n   * re-authorize for (e.g. `app.userinput.upvote`). sifa-web maps this to an\n   * OAuth scope-upgrade flow (`/oauth/reauth?scope=repo:<collection>`).\n   */\n  requiredScope?: string;\n}\n\n/**\n * Discriminated-union result of {@link castRoadmapVote}. Exported so the\n * `useCastRoadmapVote` hook and SDK consumers can type mutation handlers\n * against a single source of truth.\n */\nexport type CastRoadmapVoteResult =\n  { ok: true; data: RoadmapVoteResult } | { ok: false; error: RoadmapVoteError };\n\n/**\n * Cast a vote on a roadmap item by its key.\n *\n * Writes an `app.userinput.upvote` record into the viewer's PDS (server-side,\n * via their OAuth session). Returns a discriminated-union result rather than\n * the generic {@link WriteResult} because a first-time voter's PDS grant may\n * not yet include the `app.userinput.upvote` collection: the AppView responds\n * 403 `ScopeInsufficient`, which the caller handles by triggering an OAuth\n * scope upgrade rather than showing an error. Mirrors {@link createReaction}.\n *\n * Never throws.\n */\nexport async function castRoadmapVote(\n  config: SifaApiConfig,\n  key: string,\n  options: ApiFetchOptions = {},\n): Promise<CastRoadmapVoteResult> {\n  const fetchFn = config.fetch ?? globalThis.fetch;\n  const url = `${config.baseUrl}/api/roadmap/votes/${encodeURIComponent(key)}`;\n\n  try {\n    const res = await fetchFn(url, {\n      method: 'POST',\n      // No body: the item key is in the URL. Do NOT declare a JSON content-type\n      // for an empty body — Fastify rejects that with a 400 before the handler\n      // runs. Only forward caller-provided headers.\n      ...(options.headers ? { headers: options.headers } : {}),\n      credentials: options.credentials ?? 'include',\n      signal: options.signal ?? AbortSignal.timeout(options.timeoutMs ?? 10_000),\n    });\n\n    if (!res.ok) {\n      if (res.status === 403) {\n        try {\n          const body = (await res.json()) as { error?: string; requiredScope?: string };\n          if (body.error === 'ScopeInsufficient') {\n            return {\n              ok: false,\n              error: { type: 'scope_insufficient', requiredScope: body.requiredScope },\n            };\n          }\n        } catch {\n          // Fall through to generic error.\n        }\n      }\n      return { ok: false, error: { type: 'error' } };\n    }\n\n    const data = (await res.json()) as RoadmapVoteResult;\n    return { ok: true, data };\n  } catch {\n    return { ok: false, error: { type: 'error' } };\n  }\n}\n\n/** Retract a previously-cast roadmap vote. */\nexport function retractRoadmapVote(\n  config: SifaApiConfig,\n  key: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, `/api/roadmap/votes/${encodeURIComponent(key)}`, 'DELETE', options);\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AAcP,eAAsB,kBACpB,QACA,UAA2B,CAAC,GACG;AAC/B,MAAI;AACF,WAAO,MAAM,SAA+B,QAAQ,sBAAsB;AAAA,MACxE,OAAO;AAAA,MACP,GAAG;AAAA,IACL,CAAC;AAAA,EACH,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAeA,eAAsB,oBACpB,QACA,UAAsC,CAAC,GACpB;AACnB,QAAM,UAAkC,EAAE,GAAI,QAAQ,WAAW,CAAC,EAAG;AACrE,MAAI,QAAQ,aAAc,SAAQ,SAAS,QAAQ;AAEnD,MAAI;AACF,UAAM,OAAO,MAAM,SAA+B,QAAQ,yBAAyB;AAAA,MACjF,aAAa;AAAA,MACb,GAAG;AAAA,MACH;AAAA,IACF,CAAC;AACD,WAAO,KAAK,SAAS,CAAC;AAAA,EACxB,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAuCA,eAAsB,gBACpB,QACA,KACA,UAA2B,CAAC,GACI;AAChC,QAAM,UAAU,OAAO,SAAS,WAAW;AAC3C,QAAM,MAAM,GAAG,OAAO,OAAO,sBAAsB,mBAAmB,GAAG,CAAC;AAE1E,MAAI;AACF,UAAM,MAAM,MAAM,QAAQ,KAAK;AAAA,MAC7B,QAAQ;AAAA;AAAA;AAAA;AAAA,MAIR,GAAI,QAAQ,UAAU,EAAE,SAAS,QAAQ,QAAQ,IAAI,CAAC;AAAA,MACtD,aAAa,QAAQ,eAAe;AAAA,MACpC,QAAQ,QAAQ,UAAU,YAAY,QAAQ,QAAQ,aAAa,GAAM;AAAA,IAC3E,CAAC;AAED,QAAI,CAAC,IAAI,IAAI;AACX,UAAI,IAAI,WAAW,KAAK;AACtB,YAAI;AACF,gBAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,cAAI,KAAK,UAAU,qBAAqB;AACtC,mBAAO;AAAA,cACL,IAAI;AAAA,cACJ,OAAO,EAAE,MAAM,sBAAsB,eAAe,KAAK,cAAc;AAAA,YACzE;AAAA,UACF;AAAA,QACF,QAAQ;AAAA,QAER;AAAA,MACF;AACA,aAAO,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,QAAQ,EAAE;AAAA,IAC/C;AAEA,UAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,WAAO,EAAE,IAAI,MAAM,KAAK;AAAA,EAC1B,QAAQ;AACN,WAAO,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,QAAQ,EAAE;AAAA,EAC/C;AACF;AAGO,SAAS,mBACd,QACA,KACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,sBAAsB,mBAAmB,GAAG,CAAC,IAAI,UAAU,OAAO;AAC5F;","names":[]}

package/dist/query/fetchers/rpg.js

@@ -0,0 +1,36 @@
+// src/query/fetchers/rpg.ts
+import { z } from "zod";
+import { apiFetch } from "../client.js";
+var RpgItemStatusSchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  description: z.string(),
+  category: z.string(),
+  earned: z.boolean(),
+  state: z.enum(["locked", "earned", "given", "claimed"]),
+  iconUrl: z.string().url().nullable()
+});
+var RpgStatusResponseSchema = z.object({
+  hasCharacter: z.boolean(),
+  /** True when the user granted the `repo:equipment.rpg.item` OAuth scope. */
+  canWriteItems: z.boolean(),
+  items: z.array(RpgItemStatusSchema)
+});
+async function fetchRpgStatus(config, options = {}) {
+  const { cookieHeader, ...fetchOptions } = options;
+  const headers = { ...options.headers ?? {} };
+  if (cookieHeader) headers.cookie = cookieHeader;
+  const data = await apiFetch(config, "/api/rpg/status", {
+    credentials: "include",
+    cache: "no-store",
+    ...fetchOptions,
+    headers
+  });
+  return RpgStatusResponseSchema.parse(data);
+}
+export {
+  RpgItemStatusSchema,
+  RpgStatusResponseSchema,
+  fetchRpgStatus
+};
+//# sourceMappingURL=rpg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/rpg.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { apiFetch, type ApiFetchOptions, type SifaApiConfig } from '../client.js';\n\n/** One rpg.actor item and the viewer's progress on it, as served by `GET /api/rpg/status`. */\nexport const RpgItemStatusSchema = z.object({\n  id: z.string(),\n  title: z.string(),\n  description: z.string(),\n  category: z.string(),\n  earned: z.boolean(),\n  state: z.enum(['locked', 'earned', 'given', 'claimed']),\n  iconUrl: z.string().url().nullable(),\n});\nexport type RpgItemStatus = z.infer<typeof RpgItemStatusSchema>;\n\nexport const RpgStatusResponseSchema = z.object({\n  hasCharacter: z.boolean(),\n  /** True when the user granted the `repo:equipment.rpg.item` OAuth scope. */\n  canWriteItems: z.boolean(),\n  items: z.array(RpgItemStatusSchema),\n});\nexport type RpgStatusResponse = z.infer<typeof RpgStatusResponseSchema>;\n\nexport interface FetchRpgStatusOptions extends ApiFetchOptions {\n  /** Forwarded as the `cookie` header for server-side (SSR) calls. */\n  cookieHeader?: string;\n}\n\n/**\n * Fetch the authenticated viewer's rpg.actor item status. Auth-scoped: relies\n * on the session cookie (`credentials: 'include'`).\n */\nexport async function fetchRpgStatus(\n  config: SifaApiConfig,\n  options: FetchRpgStatusOptions = {},\n): Promise<RpgStatusResponse> {\n  const { cookieHeader, ...fetchOptions } = options;\n\n  const headers: Record<string, string> = { ...(options.headers ?? {}) };\n  if (cookieHeader) headers.cookie = cookieHeader;\n\n  const data = await apiFetch<unknown>(config, '/api/rpg/status', {\n    credentials: 'include',\n    cache: 'no-store',\n    ...fetchOptions,\n    headers,\n  });\n\n  return RpgStatusResponseSchema.parse(data);\n}\n"],"mappings":";AAAA,SAAS,SAAS;AAElB,SAAS,gBAA0D;AAG5D,IAAM,sBAAsB,EAAE,OAAO;AAAA,EAC1C,IAAI,EAAE,OAAO;AAAA,EACb,OAAO,EAAE,OAAO;AAAA,EAChB,aAAa,EAAE,OAAO;AAAA,EACtB,UAAU,EAAE,OAAO;AAAA,EACnB,QAAQ,EAAE,QAAQ;AAAA,EAClB,OAAO,EAAE,KAAK,CAAC,UAAU,UAAU,SAAS,SAAS,CAAC;AAAA,EACtD,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AACrC,CAAC;AAGM,IAAM,0BAA0B,EAAE,OAAO;AAAA,EAC9C,cAAc,EAAE,QAAQ;AAAA;AAAA,EAExB,eAAe,EAAE,QAAQ;AAAA,EACzB,OAAO,EAAE,MAAM,mBAAmB;AACpC,CAAC;AAYD,eAAsB,eACpB,QACA,UAAiC,CAAC,GACN;AAC5B,QAAM,EAAE,cAAc,GAAG,aAAa,IAAI;AAE1C,QAAM,UAAkC,EAAE,GAAI,QAAQ,WAAW,CAAC,EAAG;AACrE,MAAI,aAAc,SAAQ,SAAS;AAEnC,QAAM,OAAO,MAAM,SAAkB,QAAQ,mBAAmB;AAAA,IAC9D,aAAa;AAAA,IACb,OAAO;AAAA,IACP,GAAG;AAAA,IACH;AAAA,EACF,CAAC;AAED,SAAO,wBAAwB,MAAM,IAAI;AAC3C;","names":[]}

package/dist/query/fetchers/search.js

@@ -0,0 +1,78 @@
+// src/query/fetchers/search.ts
+import { apiFetch } from "../client.js";
+var EMPTY_SEARCH = { profiles: [], total: 0, limit: 20, offset: 0 };
+var EMPTY_FILTERS = { countries: [], industries: [], apps: [], openTo: [] };
+var EMPTY_COMPANY_SEARCH = { results: [], hasMore: false };
+async function fetchSearchProfiles(config, filters, options = {}) {
+  const params = new URLSearchParams();
+  if (filters.q) params.set("q", filters.q);
+  if (filters.skill) params.set("skill", filters.skill);
+  if (filters.country) params.set("country", filters.country);
+  if (filters.industry) params.set("industry", filters.industry);
+  if (filters.domain) params.set("domain", filters.domain);
+  if (filters.workplace) params.set("workplace", filters.workplace);
+  if (filters.app) params.set("app", filters.app);
+  if (filters.openTo && filters.openTo.length > 0) {
+    for (const token of filters.openTo) {
+      if (token) params.append("openTo", token);
+    }
+  }
+  if (filters.limit !== void 0) params.set("limit", String(filters.limit));
+  if (params.size === 0) return EMPTY_SEARCH;
+  return apiFetch(config, `/api/search/profiles?${params.toString()}`, {
+    cache: "no-store",
+    ...options
+  });
+}
+async function fetchSearchCompanies(config, filters, options = {}) {
+  const q = filters.q?.trim();
+  if (!q) return EMPTY_COMPANY_SEARCH;
+  const params = new URLSearchParams({ q });
+  if (filters.country) params.set("country", filters.country);
+  if (filters.industry) params.set("industry", filters.industry);
+  if (filters.limit !== void 0) params.set("limit", String(filters.limit));
+  return apiFetch(config, `/api/search/companies?${params.toString()}`, {
+    cache: "no-store",
+    ...options
+  });
+}
+async function fetchSkillSuggestions(config, query, options = {}) {
+  if (!query.trim()) return [];
+  const path = `/api/search/skills?q=${encodeURIComponent(query)}&limit=8`;
+  const data = await apiFetch(config, path, {
+    cache: "no-store",
+    ...options
+  });
+  return data.skills ?? [];
+}
+async function fetchSearchFilters(config, options = {}) {
+  try {
+    return await apiFetch(config, "/api/search/filters", {
+      next: { revalidate: 300 },
+      ...options
+    });
+  } catch {
+    return EMPTY_FILTERS;
+  }
+}
+async function searchSkills(config, query, limit = 10, options = {}) {
+  if (!query.trim()) return [];
+  const path = `/api/skills/search?q=${encodeURIComponent(query)}&limit=${limit}`;
+  try {
+    const data = await apiFetch(config, path, {
+      cache: "no-store",
+      ...options
+    });
+    return data.skills ?? [];
+  } catch {
+    return [];
+  }
+}
+export {
+  fetchSearchCompanies,
+  fetchSearchFilters,
+  fetchSearchProfiles,
+  fetchSkillSuggestions,
+  searchSkills
+};
+//# sourceMappingURL=search.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/search.ts"],"sourcesContent":["import type { SkillSuggestion } from '../../types/index.js';\nimport { apiFetch, type ApiFetchOptions, type SifaApiConfig } from '../client.js';\n\n/** Profile entry returned by the search endpoint. */\nexport interface ProfileSearchResult {\n  did?: string;\n  handle: string;\n  displayName?: string;\n  headline?: string;\n  avatar?: string;\n  about?: string;\n  currentRole?: string;\n  currentCompany?: string;\n  industry?: string;\n  domain?: string;\n  countryCode?: string;\n  locationCountry?: string;\n  preferredWorkplace?: string[];\n  claimed?: boolean;\n  blueskyVerified?: boolean;\n  blueskyVerifiedAt?: string | null;\n}\n\nexport interface SearchFilters {\n  q?: string;\n  skill?: string;\n  country?: string;\n  industry?: string;\n  domain?: string;\n  workplace?: string;\n  app?: string;\n  /**\n   * Open-to filter. Values are short tokens (e.g. \"fullTime\", \"mentor\",\n   * \"collab\") matching `OPEN_TO_OPTIONS[].token` from the taxonomy. The\n   * API expands tokens to lex values server-side. Multiple tokens are\n   * OR-combined (profile matches if any selected token is set).\n   */\n  openTo?: string[];\n  limit?: number;\n}\n\nexport interface SearchResponse {\n  profiles: ProfileSearchResult[];\n  total: number;\n  limit: number;\n  offset: number;\n}\n\n/** Skill typeahead suggestion. */\nexport interface SkillSearchResult {\n  name: string;\n  slug: string;\n  category: string;\n  userCount: number;\n}\n\nexport interface FilterOptions {\n  countries: { countryCode: string; country: string; count: number }[];\n  industries: { industry: string; count: number }[];\n  apps: { appId: string; count: number }[];\n  /**\n   * Distribution of openTo selections across indexed profiles. Each entry\n   * maps a short token (see {@link SearchFilters.openTo}) to the number of\n   * profiles that have it set. Omitted from older API responses; treat\n   * absence as \"no data\" rather than \"all zero\".\n   */\n  openTo?: { token: string; count: number }[];\n}\n\n/** Company entry returned by company search (workspace#299). */\nexport interface CompanySearchResult {\n  /** Immutable catalogue id; the durable `/c/{publicId}` link. */\n  publicId: string;\n  name: string;\n  domain: string | null;\n  country: string | null;\n  industry: string | null;\n  logoUrl: string | null;\n  employeeCount: number | null;\n}\n\nexport interface CompanySearchFilters {\n  q?: string;\n  /** ISO 3166-1 alpha-2. */\n  country?: string;\n  industry?: string;\n  limit?: number;\n}\n\nexport interface CompanySearchResponse {\n  results: CompanySearchResult[];\n  hasMore: boolean;\n}\n\nconst EMPTY_SEARCH: SearchResponse = { profiles: [], total: 0, limit: 20, offset: 0 };\nconst EMPTY_FILTERS: FilterOptions = { countries: [], industries: [], apps: [], openTo: [] };\nconst EMPTY_COMPANY_SEARCH: CompanySearchResponse = { results: [], hasMore: false };\n\n/**\n * Search profiles by free-text query and optional filters. Returns an\n * empty result set when no filters are provided (matching sifa-web's\n * \"no input, no fetch\" behavior).\n */\nexport async function fetchSearchProfiles(\n  config: SifaApiConfig,\n  filters: SearchFilters,\n  options: ApiFetchOptions = {},\n): Promise<SearchResponse> {\n  const params = new URLSearchParams();\n  if (filters.q) params.set('q', filters.q);\n  if (filters.skill) params.set('skill', filters.skill);\n  if (filters.country) params.set('country', filters.country);\n  if (filters.industry) params.set('industry', filters.industry);\n  if (filters.domain) params.set('domain', filters.domain);\n  if (filters.workplace) params.set('workplace', filters.workplace);\n  if (filters.app) params.set('app', filters.app);\n  if (filters.openTo && filters.openTo.length > 0) {\n    for (const token of filters.openTo) {\n      if (token) params.append('openTo', token);\n    }\n  }\n  if (filters.limit !== undefined) params.set('limit', String(filters.limit));\n\n  if (params.size === 0) return EMPTY_SEARCH;\n\n  return apiFetch<SearchResponse>(config, `/api/search/profiles?${params.toString()}`, {\n    cache: 'no-store',\n    ...options,\n  });\n}\n\n/**\n * Company search over the entity catalogue (workspace#299).\n *\n * A category of its own rather than part of profile search: the two rank\n * differently and carry different filters, and a slow category should not hold\n * up the rest of a blended results page.\n *\n * An empty query returns nothing without a network call. The API rejects a\n * blank `q` rather than scanning ~200k rows, so asking would only spend a round\n * trip to be told no.\n */\nexport async function fetchSearchCompanies(\n  config: SifaApiConfig,\n  filters: CompanySearchFilters,\n  options: ApiFetchOptions = {},\n): Promise<CompanySearchResponse> {\n  const q = filters.q?.trim();\n  if (!q) return EMPTY_COMPANY_SEARCH;\n\n  const params = new URLSearchParams({ q });\n  if (filters.country) params.set('country', filters.country);\n  if (filters.industry) params.set('industry', filters.industry);\n  if (filters.limit !== undefined) params.set('limit', String(filters.limit));\n\n  return apiFetch<CompanySearchResponse>(config, `/api/search/companies?${params.toString()}`, {\n    cache: 'no-store',\n    ...options,\n  });\n}\n\n/**\n * Skill typeahead. Returns up to 8 matches for the given prefix. Empty\n * input returns an empty array without hitting the server.\n */\nexport async function fetchSkillSuggestions(\n  config: SifaApiConfig,\n  query: string,\n  options: ApiFetchOptions = {},\n): Promise<SkillSearchResult[]> {\n  if (!query.trim()) return [];\n  const path = `/api/search/skills?q=${encodeURIComponent(query)}&limit=8`;\n  const data = await apiFetch<{ skills?: SkillSearchResult[] }>(config, path, {\n    cache: 'no-store',\n    ...options,\n  });\n  return data.skills ?? [];\n}\n\n/** Available filter facets (countries, industries, apps) for search UI. */\nexport async function fetchSearchFilters(\n  config: SifaApiConfig,\n  options: ApiFetchOptions = {},\n): Promise<FilterOptions> {\n  try {\n    return await apiFetch<FilterOptions>(config, '/api/search/filters', {\n      next: { revalidate: 300 },\n      ...options,\n    });\n  } catch {\n    return EMPTY_FILTERS;\n  }\n}\n\n/**\n * Canonical-skill search backing the position-editor and similar\n * skill-pickers. Hits `/api/skills/search` (the canonical-skills DB\n * lookup) which is distinct from {@link fetchSkillSuggestions}'s\n * `/api/search/skills` (the profile-skill typeahead).\n *\n * Returns `[]` on empty input (no network call) or any error.\n */\nexport async function searchSkills(\n  config: SifaApiConfig,\n  query: string,\n  limit = 10,\n  options: ApiFetchOptions = {},\n): Promise<SkillSuggestion[]> {\n  if (!query.trim()) return [];\n  const path = `/api/skills/search?q=${encodeURIComponent(query)}&limit=${limit}`;\n  try {\n    const data = await apiFetch<{ skills?: SkillSuggestion[] }>(config, path, {\n      cache: 'no-store',\n      ...options,\n    });\n    return data.skills ?? [];\n  } catch {\n    return [];\n  }\n}\n"],"mappings":";AACA,SAAS,gBAA0D;AA6FnE,IAAM,eAA+B,EAAE,UAAU,CAAC,GAAG,OAAO,GAAG,OAAO,IAAI,QAAQ,EAAE;AACpF,IAAM,gBAA+B,EAAE,WAAW,CAAC,GAAG,YAAY,CAAC,GAAG,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE;AAC3F,IAAM,uBAA8C,EAAE,SAAS,CAAC,GAAG,SAAS,MAAM;AAOlF,eAAsB,oBACpB,QACA,SACA,UAA2B,CAAC,GACH;AACzB,QAAM,SAAS,IAAI,gBAAgB;AACnC,MAAI,QAAQ,EAAG,QAAO,IAAI,KAAK,QAAQ,CAAC;AACxC,MAAI,QAAQ,MAAO,QAAO,IAAI,SAAS,QAAQ,KAAK;AACpD,MAAI,QAAQ,QAAS,QAAO,IAAI,WAAW,QAAQ,OAAO;AAC1D,MAAI,QAAQ,SAAU,QAAO,IAAI,YAAY,QAAQ,QAAQ;AAC7D,MAAI,QAAQ,OAAQ,QAAO,IAAI,UAAU,QAAQ,MAAM;AACvD,MAAI,QAAQ,UAAW,QAAO,IAAI,aAAa,QAAQ,SAAS;AAChE,MAAI,QAAQ,IAAK,QAAO,IAAI,OAAO,QAAQ,GAAG;AAC9C,MAAI,QAAQ,UAAU,QAAQ,OAAO,SAAS,GAAG;AAC/C,eAAW,SAAS,QAAQ,QAAQ;AAClC,UAAI,MAAO,QAAO,OAAO,UAAU,KAAK;AAAA,IAC1C;AAAA,EACF;AACA,MAAI,QAAQ,UAAU,OAAW,QAAO,IAAI,SAAS,OAAO,QAAQ,KAAK,CAAC;AAE1E,MAAI,OAAO,SAAS,EAAG,QAAO;AAE9B,SAAO,SAAyB,QAAQ,wBAAwB,OAAO,SAAS,CAAC,IAAI;AAAA,IACnF,OAAO;AAAA,IACP,GAAG;AAAA,EACL,CAAC;AACH;AAaA,eAAsB,qBACpB,QACA,SACA,UAA2B,CAAC,GACI;AAChC,QAAM,IAAI,QAAQ,GAAG,KAAK;AAC1B,MAAI,CAAC,EAAG,QAAO;AAEf,QAAM,SAAS,IAAI,gBAAgB,EAAE,EAAE,CAAC;AACxC,MAAI,QAAQ,QAAS,QAAO,IAAI,WAAW,QAAQ,OAAO;AAC1D,MAAI,QAAQ,SAAU,QAAO,IAAI,YAAY,QAAQ,QAAQ;AAC7D,MAAI,QAAQ,UAAU,OAAW,QAAO,IAAI,SAAS,OAAO,QAAQ,KAAK,CAAC;AAE1E,SAAO,SAAgC,QAAQ,yBAAyB,OAAO,SAAS,CAAC,IAAI;AAAA,IAC3F,OAAO;AAAA,IACP,GAAG;AAAA,EACL,CAAC;AACH;AAMA,eAAsB,sBACpB,QACA,OACA,UAA2B,CAAC,GACE;AAC9B,MAAI,CAAC,MAAM,KAAK,EAAG,QAAO,CAAC;AAC3B,QAAM,OAAO,wBAAwB,mBAAmB,KAAK,CAAC;AAC9D,QAAM,OAAO,MAAM,SAA2C,QAAQ,MAAM;AAAA,IAC1E,OAAO;AAAA,IACP,GAAG;AAAA,EACL,CAAC;AACD,SAAO,KAAK,UAAU,CAAC;AACzB;AAGA,eAAsB,mBACpB,QACA,UAA2B,CAAC,GACJ;AACxB,MAAI;AACF,WAAO,MAAM,SAAwB,QAAQ,uBAAuB;AAAA,MAClE,MAAM,EAAE,YAAY,IAAI;AAAA,MACxB,GAAG;AAAA,IACL,CAAC;AAAA,EACH,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAUA,eAAsB,aACpB,QACA,OACA,QAAQ,IACR,UAA2B,CAAC,GACA;AAC5B,MAAI,CAAC,MAAM,KAAK,EAAG,QAAO,CAAC;AAC3B,QAAM,OAAO,wBAAwB,mBAAmB,KAAK,CAAC,UAAU,KAAK;AAC7E,MAAI;AACF,UAAM,OAAO,MAAM,SAAyC,QAAQ,MAAM;AAAA,MACxE,OAAO;AAAA,MACP,GAAG;AAAA,IACL,CAAC;AACD,WAAO,KAAK,UAAU,CAAC;AAAA,EACzB,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;","names":[]}

package/dist/query/fetchers/section-primary.js

@@ -0,0 +1,23 @@
+// src/query/fetchers/section-primary.ts
+import { apiWrite } from "../client.js";
+function setSectionPrimary(config, section, rkey, options = {}) {
+  return apiWrite(
+    config,
+    `/api/profile/${section}/${encodeURIComponent(rkey)}/primary`,
+    "PUT",
+    options
+  );
+}
+function unsetSectionPrimary(config, section, rkey, options = {}) {
+  return apiWrite(
+    config,
+    `/api/profile/${section}/${encodeURIComponent(rkey)}/primary`,
+    "DELETE",
+    options
+  );
+}
+export {
+  setSectionPrimary,
+  unsetSectionPrimary
+};
+//# sourceMappingURL=section-primary.js.map

package/dist/query/fetchers/section-primary.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/section-primary.ts"],"sourcesContent":["import { apiWrite, type ApiFetchOptions, type SifaApiConfig, type WriteResult } from '../client.js';\n\n/**\n * Profile sections that support a user-chosen primary item feeding the Highlights\n * block. `position` is excluded: it predates this and keeps its own dedicated\n * endpoint (`setPositionPrimary` / `unsetPositionPrimary` in `positions.ts`).\n */\nexport type PrimarySection =\n  'education' | 'publication' | 'presentation' | 'involvement' | 'project';\n\n/**\n * Mark a section record as the user's primary item for that section. The AppView\n * flips `isPrimary` on the record via the user's OAuth session, clears the flag on\n * any sibling in the same section, and enforces the per-section eligibility rule.\n *\n * Never throws: inspect `result.success` and use `result.error` for UI messaging.\n */\nexport function setSectionPrimary(\n  config: SifaApiConfig,\n  section: PrimarySection,\n  rkey: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(\n    config,\n    `/api/profile/${section}/${encodeURIComponent(rkey)}/primary`,\n    'PUT',\n    options,\n  );\n}\n\n/** Clear the primary flag on a section record. */\nexport function unsetSectionPrimary(\n  config: SifaApiConfig,\n  section: PrimarySection,\n  rkey: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(\n    config,\n    `/api/profile/${section}/${encodeURIComponent(rkey)}/primary`,\n    'DELETE',\n    options,\n  );\n}\n"],"mappings":";AAAA,SAAS,gBAA4E;AAiB9E,SAAS,kBACd,QACA,SACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB,OAAO,IAAI,mBAAmB,IAAI,CAAC;AAAA,IACnD;AAAA,IACA;AAAA,EACF;AACF;AAGO,SAAS,oBACd,QACA,SACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB,OAAO,IAAI,mBAAmB,IAAI,CAAC;AAAA,IACnD;AAAA,IACA;AAAA,EACF;AACF;","names":[]}