@singi-labs/sifa-sdk 0.19.44 → 0.19.46

package/dist/query/fetchers/investments.js

@@ -0,0 +1,18 @@
+// src/query/fetchers/investments.ts
+import { PROFILE_INVESTMENT_NSID } from "../../schemas/profile-investment.js";
+import { createRecord, updateRecord, deleteRecord } from "./records.js";
+function createInvestment(config, data, options = {}) {
+  return createRecord(config, PROFILE_INVESTMENT_NSID, data, options);
+}
+function updateInvestment(config, rkey, data, options = {}) {
+  return updateRecord(config, PROFILE_INVESTMENT_NSID, rkey, data, options);
+}
+function deleteInvestment(config, rkey, options = {}) {
+  return deleteRecord(config, PROFILE_INVESTMENT_NSID, rkey, options);
+}
+export {
+  createInvestment,
+  deleteInvestment,
+  updateInvestment
+};
+//# sourceMappingURL=investments.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/investments.ts"],"sourcesContent":["import { PROFILE_INVESTMENT_NSID } from '../../schemas/profile-investment.js';\nimport { createRecord, updateRecord, deleteRecord } from './records.js';\nimport type { ApiFetchOptions, CreateResult, SifaApiConfig, WriteResult } from '../client.js';\n\nexport type { CreateResult, WriteResult } from '../client.js';\n\n/**\n * Typed wrappers over the generic record routes for\n * `id.sifa.profile.investment`. sifa-api serves every collection without a\n * bespoke handler through `POST|PUT|DELETE /api/profile/records/<collection>`,\n * so these exist for call-site readability, not for a different endpoint.\n *\n * Never throw -- inspect `result.success` and use `result.error` /\n * `result.pdsHost` for UI messaging.\n */\nexport function createInvestment(\n  config: SifaApiConfig,\n  data: Record<string, unknown>,\n  options: ApiFetchOptions = {},\n): Promise<CreateResult> {\n  return createRecord(config, PROFILE_INVESTMENT_NSID, data, options);\n}\n\n/** Update an existing investment by `rkey`. */\nexport function updateInvestment(\n  config: SifaApiConfig,\n  rkey: string,\n  data: Record<string, unknown>,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return updateRecord(config, PROFILE_INVESTMENT_NSID, rkey, data, options);\n}\n\n/** Delete an investment by `rkey`. */\nexport function deleteInvestment(\n  config: SifaApiConfig,\n  rkey: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return deleteRecord(config, PROFILE_INVESTMENT_NSID, rkey, options);\n}\n"],"mappings":";AAAA,SAAS,+BAA+B;AACxC,SAAS,cAAc,cAAc,oBAAoB;AAclD,SAAS,iBACd,QACA,MACA,UAA2B,CAAC,GACL;AACvB,SAAO,aAAa,QAAQ,yBAAyB,MAAM,OAAO;AACpE;AAGO,SAAS,iBACd,QACA,MACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO,aAAa,QAAQ,yBAAyB,MAAM,MAAM,OAAO;AAC1E;AAGO,SAAS,iBACd,QACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO,aAAa,QAAQ,yBAAyB,MAAM,OAAO;AACpE;","names":[]}

package/dist/query/fetchers/keytrace-claims.js

@@ -0,0 +1,23 @@
+// src/query/fetchers/keytrace-claims.ts
+import { apiWrite } from "../client.js";
+function hideKeytraceClaim(config, rkey, options = {}) {
+  return apiWrite(
+    config,
+    `/api/profile/keytrace-claims/${encodeURIComponent(rkey)}/hide`,
+    "POST",
+    options
+  );
+}
+function unhideKeytraceClaim(config, rkey, options = {}) {
+  return apiWrite(
+    config,
+    `/api/profile/keytrace-claims/${encodeURIComponent(rkey)}/hide`,
+    "DELETE",
+    options
+  );
+}
+export {
+  hideKeytraceClaim,
+  unhideKeytraceClaim
+};
+//# sourceMappingURL=keytrace-claims.js.map

package/dist/query/fetchers/keytrace-claims.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/keytrace-claims.ts"],"sourcesContent":["import { apiWrite, type ApiFetchOptions, type SifaApiConfig, type WriteResult } from '../client.js';\n\n/**\n * Hide a keytrace claim (verified-account claim discovered on the\n * user's external accounts) from the user's profile. The claim itself\n * stays in the index; only its display is suppressed.\n */\nexport function hideKeytraceClaim(\n  config: SifaApiConfig,\n  rkey: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(\n    config,\n    `/api/profile/keytrace-claims/${encodeURIComponent(rkey)}/hide`,\n    'POST',\n    options,\n  );\n}\n\n/** Restore a previously-hidden keytrace claim. */\nexport function unhideKeytraceClaim(\n  config: SifaApiConfig,\n  rkey: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(\n    config,\n    `/api/profile/keytrace-claims/${encodeURIComponent(rkey)}/hide`,\n    'DELETE',\n    options,\n  );\n}\n"],"mappings":";AAAA,SAAS,gBAA4E;AAO9E,SAAS,kBACd,QACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO;AAAA,IACL;AAAA,IACA,gCAAgC,mBAAmB,IAAI,CAAC;AAAA,IACxD;AAAA,IACA;AAAA,EACF;AACF;AAGO,SAAS,oBACd,QACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO;AAAA,IACL;AAAA,IACA,gCAAgC,mBAAmB,IAAI,CAAC;AAAA,IACxD;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/query/fetchers/marque-domains.js

@@ -0,0 +1,23 @@
+// src/query/fetchers/marque-domains.ts
+import { apiWrite } from "../client.js";
+function revealMarqueDomain(config, domain, options = {}) {
+  return apiWrite(
+    config,
+    `/api/profile/marque-domains/${encodeURIComponent(domain)}/reveal`,
+    "POST",
+    options
+  );
+}
+function unrevealMarqueDomain(config, domain, options = {}) {
+  return apiWrite(
+    config,
+    `/api/profile/marque-domains/${encodeURIComponent(domain)}/reveal`,
+    "DELETE",
+    options
+  );
+}
+export {
+  revealMarqueDomain,
+  unrevealMarqueDomain
+};
+//# sourceMappingURL=marque-domains.js.map

package/dist/query/fetchers/marque-domains.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/marque-domains.ts"],"sourcesContent":["import { apiWrite, type ApiFetchOptions, type SifaApiConfig, type WriteResult } from '../client.js';\n\n/**\n * Make a Marque-registered domain public in the owner's Links section. Marque\n * domains are owner-only by default; this reveals one. `domain` is the\n * at.marque.domain rkey (the domain name itself).\n */\nexport function revealMarqueDomain(\n  config: SifaApiConfig,\n  domain: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(\n    config,\n    `/api/profile/marque-domains/${encodeURIComponent(domain)}/reveal`,\n    'POST',\n    options,\n  );\n}\n\n/** Make a previously-revealed Marque domain owner-only again. */\nexport function unrevealMarqueDomain(\n  config: SifaApiConfig,\n  domain: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(\n    config,\n    `/api/profile/marque-domains/${encodeURIComponent(domain)}/reveal`,\n    'DELETE',\n    options,\n  );\n}\n"],"mappings":";AAAA,SAAS,gBAA4E;AAO9E,SAAS,mBACd,QACA,QACA,UAA2B,CAAC,GACN;AACtB,SAAO;AAAA,IACL;AAAA,IACA,+BAA+B,mBAAmB,MAAM,CAAC;AAAA,IACzD;AAAA,IACA;AAAA,EACF;AACF;AAGO,SAAS,qBACd,QACA,QACA,UAA2B,CAAC,GACN;AACtB,SAAO;AAAA,IACL;AAAA,IACA,+BAA+B,mBAAmB,MAAM,CAAC;AAAA,IACzD;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/query/fetchers/network-map.js

@@ -0,0 +1,36 @@
+// src/query/fetchers/network-map.ts
+import { apiFetch, apiFetchOrNull } from "../client.js";
+function isNetworkMapResponse(value) {
+  return "graph" in value;
+}
+async function initiateNetworkMapGeneration(config, options = {}) {
+  return apiFetch(config, "/api/network-map/generate", {
+    method: "POST",
+    credentials: "include",
+    ...options
+  });
+}
+async function checkNetworkMapJobStatus(config, jobId, options = {}) {
+  return apiFetch(
+    config,
+    `/api/network-map/status/${encodeURIComponent(jobId)}`,
+    {
+      credentials: "include",
+      ...options
+    }
+  );
+}
+async function fetchNetworkMap(config, options = {}) {
+  return apiFetchOrNull(config, "/api/network-map", {
+    credentials: "include",
+    cache: "no-store",
+    ...options
+  });
+}
+export {
+  checkNetworkMapJobStatus,
+  fetchNetworkMap,
+  initiateNetworkMapGeneration,
+  isNetworkMapResponse
+};
+//# sourceMappingURL=network-map.js.map

package/dist/query/fetchers/network-map.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/network-map.ts"],"sourcesContent":["import { apiFetch, apiFetchOrNull, type ApiFetchOptions, type SifaApiConfig } from '../client.js';\n\n/** A node in the personal network graph. */\nexport interface NetworkMapNode {\n  did: string;\n  handle: string;\n  displayName: string;\n  avatar: string | null;\n  /** Number of edges this node participates in within the rendered graph. */\n  degree: number;\n  /** Phase 2: community detection cluster id. */\n  cluster?: number;\n  /** Phase 2: pre-computed layout coordinates. */\n  x?: number;\n  y?: number;\n}\n\n/** A directed edge in the personal network graph. */\nexport interface NetworkMapEdge {\n  source: string;\n  target: string;\n  mutual: boolean;\n  /** Networks this edge was observed in, e.g. `['sifa', 'bluesky']`. */\n  sources: string[];\n}\n\n/** The graph payload itself, decoupled from response metadata. */\nexport interface NetworkMapGraphData {\n  nodes: NetworkMapNode[];\n  edges: NetworkMapEdge[];\n  /** Phase 2: cluster metadata for legend rendering. */\n  clusters?: Array<{ id: number; label: string; color: string }>;\n}\n\n/** Cached graph response. */\nexport interface NetworkMapResponse {\n  generatedAt: string;\n  expiresAt: string;\n  graph: NetworkMapGraphData;\n  stats: {\n    totalNodes: number;\n    totalEdges: number;\n    mutualCount: number;\n    sources: Record<string, number>;\n  };\n}\n\n/** Async job tracking generation progress. */\nexport interface NetworkMapGenerationJob {\n  jobId: string;\n  did: string;\n  status: 'pending' | 'complete' | 'failed';\n  /** 0..100 */\n  progress: number;\n  createdAt: string;\n  completedAt?: string;\n  error?: string;\n  /**\n   * Queue position when the job is still pending and not yet picked up\n   * by the worker. 0 = next to run. Absent for in-flight or terminal\n   * jobs (and for any backend that doesn't yet report position).\n   */\n  position?: number;\n  /**\n   * Estimated remaining seconds, derived server-side from the median\n   * historical duration for the user's follow-count bucket multiplied\n   * by `position + 1`. Absent when no historical data exists yet.\n   */\n  etaSeconds?: number;\n}\n\n/** Returned by `initiateNetworkMapGeneration` when a new job was started or one was already running. */\nexport interface NetworkMapPendingJob {\n  jobId: string;\n  status: 'pending' | 'cached';\n}\n\n/** Discriminate the union returned by `initiateNetworkMapGeneration`. */\nexport function isNetworkMapResponse(\n  value: NetworkMapPendingJob | NetworkMapResponse,\n): value is NetworkMapResponse {\n  return 'graph' in value;\n}\n\n/**\n * Kick off a personal network-map computation. The backend returns the\n * cached map immediately when fresh, otherwise it returns a job id that\n * the caller polls via `checkNetworkMapJobStatus`.\n */\nexport async function initiateNetworkMapGeneration(\n  config: SifaApiConfig,\n  options: ApiFetchOptions = {},\n): Promise<NetworkMapPendingJob | NetworkMapResponse> {\n  return apiFetch<NetworkMapPendingJob | NetworkMapResponse>(config, '/api/network-map/generate', {\n    method: 'POST',\n    credentials: 'include',\n    ...options,\n  });\n}\n\n/**\n * Poll the status of an in-flight generation job. Throws on 404 (unknown\n * or expired job) — callers may want to treat that as terminal failure.\n */\nexport async function checkNetworkMapJobStatus(\n  config: SifaApiConfig,\n  jobId: string,\n  options: ApiFetchOptions = {},\n): Promise<NetworkMapGenerationJob> {\n  return apiFetch<NetworkMapGenerationJob>(\n    config,\n    `/api/network-map/status/${encodeURIComponent(jobId)}`,\n    {\n      credentials: 'include',\n      ...options,\n    },\n  );\n}\n\n/**\n * Fetch the most recent cached network map for the authenticated user.\n * Returns `null` when no map has ever been generated (404).\n */\nexport async function fetchNetworkMap(\n  config: SifaApiConfig,\n  options: ApiFetchOptions = {},\n): Promise<NetworkMapResponse | null> {\n  return apiFetchOrNull<NetworkMapResponse>(config, '/api/network-map', {\n    credentials: 'include',\n    cache: 'no-store',\n    ...options,\n  });\n}\n"],"mappings":";AAAA,SAAS,UAAU,sBAAgE;AA8E5E,SAAS,qBACd,OAC6B;AAC7B,SAAO,WAAW;AACpB;AAOA,eAAsB,6BACpB,QACA,UAA2B,CAAC,GACwB;AACpD,SAAO,SAAoD,QAAQ,6BAA6B;AAAA,IAC9F,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,GAAG;AAAA,EACL,CAAC;AACH;AAMA,eAAsB,yBACpB,QACA,OACA,UAA2B,CAAC,GACM;AAClC,SAAO;AAAA,IACL;AAAA,IACA,2BAA2B,mBAAmB,KAAK,CAAC;AAAA,IACpD;AAAA,MACE,aAAa;AAAA,MACb,GAAG;AAAA,IACL;AAAA,EACF;AACF;AAMA,eAAsB,gBACpB,QACA,UAA2B,CAAC,GACQ;AACpC,SAAO,eAAmC,QAAQ,oBAAoB;AAAA,IACpE,aAAa;AAAA,IACb,OAAO;AAAA,IACP,GAAG;AAAA,EACL,CAAC;AACH;","names":[]}

package/dist/query/fetchers/org.js

@@ -0,0 +1,48 @@
+// src/query/fetchers/org.ts
+import { apiWrite } from "../client.js";
+function submitOrgClaim(config, body, options = {}) {
+  return apiWrite(config, "/api/org/claim", "POST", { body, ...options });
+}
+function updateOrgProfile(config, body, options = {}) {
+  return apiWrite(config, "/api/org/profile", "PUT", {
+    body,
+    ...options
+  });
+}
+function requestOrgDomainChallenge(config, body, options = {}) {
+  return apiWrite(config, "/api/org/domains/challenge", "POST", {
+    body,
+    ...options
+  });
+}
+function verifyOrgDomain(config, body, options = {}) {
+  return apiWrite(config, "/api/org/domains/verify", "POST", {
+    body,
+    ...options
+  });
+}
+function addOrgNotificationEmail(config, body, options = {}) {
+  return apiWrite(
+    config,
+    "/api/org/notification-emails",
+    "POST",
+    { body, ...options }
+  );
+}
+function removeOrgNotificationEmail(config, body, options = {}) {
+  return apiWrite(
+    config,
+    "/api/org/notification-emails",
+    "DELETE",
+    { body, ...options }
+  );
+}
+export {
+  addOrgNotificationEmail,
+  removeOrgNotificationEmail,
+  requestOrgDomainChallenge,
+  submitOrgClaim,
+  updateOrgProfile,
+  verifyOrgDomain
+};
+//# sourceMappingURL=org.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/org.ts"],"sourcesContent":["import { apiWrite, type ApiFetchOptions, type SifaApiConfig, type WriteResult } from '../client.js';\nimport type { OrgClaimRequestInput } from '../../schemas/write/org-claim.js';\nimport type {\n  OrgDomainChallengeRequestInput,\n  OrgDomainVerifyRequestInput,\n  OrgNotificationEmailRequestInput,\n  OrgProfileUpdateRequestInput,\n} from '../../schemas/write/org-settings.js';\n\n/** How a single entity binding was resolved during a claim. */\nexport interface OrgClaimBinding {\n  entityId: number;\n  entityRef: string;\n  validatedBy: string | null;\n  status: 'active' | 'pending';\n  dissolved: boolean;\n}\n\n/** The public org-profile echo returned by claim / update endpoints (no `contact`). */\nexport interface OrgProfileEcho {\n  name: string;\n  description: string | null;\n  website: string | null;\n  entityRefs: string[];\n}\n\n/** Response body of `POST /api/org/claim`. */\nexport interface OrgClaimResult {\n  orgDid: string;\n  status: 'active' | 'review';\n  bindings: OrgClaimBinding[];\n  orgProfile: OrgProfileEcho;\n}\n\n/** Response body of `PUT /api/org/profile`. */\nexport interface OrgProfileUpdateResult {\n  ok: boolean;\n  orgProfile: OrgProfileEcho;\n}\n\n/** Response body of `POST /api/org/domains/challenge`. */\nexport interface OrgDomainChallengeResult {\n  domain: string;\n  txtRecordName: string;\n  txtRecordValue: string;\n}\n\n/** Response body of `POST /api/org/domains/verify` (happy path). */\nexport interface OrgDomainVerifyResult {\n  status: 'verified' | 'pending';\n  domain: string;\n}\n\n/** Response body of `POST /api/org/notification-emails`. */\nexport interface OrgNotificationEmailAddResult {\n  ok: boolean;\n  status: string;\n}\n\n/** Response body of `DELETE /api/org/notification-emails`. */\nexport interface OrgNotificationEmailRemoveResult {\n  ok: boolean;\n  removed: number;\n}\n\n/**\n * Finalize an org profile claim (`POST /api/org/claim`). Auth-gated (org-claim\n * JIT scope) and floor-checked server-side. Never throws -- returns the\n * structured {@link OrgClaimResult} folded into a {@link WriteResult} on success,\n * or `{ success: false, error, pdsHost? }` on failure.\n */\nexport function submitOrgClaim(\n  config: SifaApiConfig,\n  body: OrgClaimRequestInput,\n  options: Omit<ApiFetchOptions, 'method' | 'body'> = {},\n): Promise<WriteResult & Partial<OrgClaimResult>> {\n  return apiWrite<Partial<OrgClaimResult>>(config, '/api/org/claim', 'POST', { body, ...options });\n}\n\n/**\n * Edit the org record (`PUT /api/org/profile`). Fresh-from-body server-side PUT\n * (a cleared optional field is dropped, no spread-merge). Never throws.\n */\nexport function updateOrgProfile(\n  config: SifaApiConfig,\n  body: OrgProfileUpdateRequestInput,\n  options: Omit<ApiFetchOptions, 'method' | 'body'> = {},\n): Promise<WriteResult & Partial<OrgProfileUpdateResult>> {\n  return apiWrite<Partial<OrgProfileUpdateResult>>(config, '/api/org/profile', 'PUT', {\n    body,\n    ...options,\n  });\n}\n\n/**\n * Issue a one-time DNS TXT domain challenge (`POST /api/org/domains/challenge`).\n * Returns the TXT record name + value the org must publish. Never throws.\n */\nexport function requestOrgDomainChallenge(\n  config: SifaApiConfig,\n  body: OrgDomainChallengeRequestInput,\n  options: Omit<ApiFetchOptions, 'method' | 'body'> = {},\n): Promise<WriteResult & Partial<OrgDomainChallengeResult>> {\n  return apiWrite<Partial<OrgDomainChallengeResult>>(config, '/api/org/domains/challenge', 'POST', {\n    body,\n    ...options,\n  });\n}\n\n/**\n * Verify a DNS TXT domain challenge (`POST /api/org/domains/verify`). On success\n * `status` is `verified` or `pending`. Expired / confusable / not-found map to\n * non-2xx server responses and surface as `{ success: false, error }`. Never\n * throws.\n */\nexport function verifyOrgDomain(\n  config: SifaApiConfig,\n  body: OrgDomainVerifyRequestInput,\n  options: Omit<ApiFetchOptions, 'method' | 'body'> = {},\n): Promise<WriteResult & Partial<OrgDomainVerifyResult>> {\n  return apiWrite<Partial<OrgDomainVerifyResult>>(config, '/api/org/domains/verify', 'POST', {\n    body,\n    ...options,\n  });\n}\n\n/**\n * Add an org notification email (`POST /api/org/notification-emails`). The\n * address must use a domain the org controls (checked server-side). An\n * individual verification email is enqueued through the (dormant) sending\n * pipeline. Never throws.\n */\nexport function addOrgNotificationEmail(\n  config: SifaApiConfig,\n  body: OrgNotificationEmailRequestInput,\n  options: Omit<ApiFetchOptions, 'method' | 'body'> = {},\n): Promise<WriteResult & Partial<OrgNotificationEmailAddResult>> {\n  return apiWrite<Partial<OrgNotificationEmailAddResult>>(\n    config,\n    '/api/org/notification-emails',\n    'POST',\n    { body, ...options },\n  );\n}\n\n/**\n * Remove an org notification email (`DELETE /api/org/notification-emails`).\n * Never throws.\n */\nexport function removeOrgNotificationEmail(\n  config: SifaApiConfig,\n  body: OrgNotificationEmailRequestInput,\n  options: Omit<ApiFetchOptions, 'method' | 'body'> = {},\n): Promise<WriteResult & Partial<OrgNotificationEmailRemoveResult>> {\n  return apiWrite<Partial<OrgNotificationEmailRemoveResult>>(\n    config,\n    '/api/org/notification-emails',\n    'DELETE',\n    { body, ...options },\n  );\n}\n"],"mappings":";AAAA,SAAS,gBAA4E;AAuE9E,SAAS,eACd,QACA,MACA,UAAoD,CAAC,GACL;AAChD,SAAO,SAAkC,QAAQ,kBAAkB,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;AACjG;AAMO,SAAS,iBACd,QACA,MACA,UAAoD,CAAC,GACG;AACxD,SAAO,SAA0C,QAAQ,oBAAoB,OAAO;AAAA,IAClF;AAAA,IACA,GAAG;AAAA,EACL,CAAC;AACH;AAMO,SAAS,0BACd,QACA,MACA,UAAoD,CAAC,GACK;AAC1D,SAAO,SAA4C,QAAQ,8BAA8B,QAAQ;AAAA,IAC/F;AAAA,IACA,GAAG;AAAA,EACL,CAAC;AACH;AAQO,SAAS,gBACd,QACA,MACA,UAAoD,CAAC,GACE;AACvD,SAAO,SAAyC,QAAQ,2BAA2B,QAAQ;AAAA,IACzF;AAAA,IACA,GAAG;AAAA,EACL,CAAC;AACH;AAQO,SAAS,wBACd,QACA,MACA,UAAoD,CAAC,GACU;AAC/D,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,EAAE,MAAM,GAAG,QAAQ;AAAA,EACrB;AACF;AAMO,SAAS,2BACd,QACA,MACA,UAAoD,CAAC,GACa;AAClE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,EAAE,MAAM,GAAG,QAAQ;AAAA,EACrB;AACF;","names":[]}

package/dist/query/fetchers/positions.js

@@ -0,0 +1,77 @@
+// src/query/fetchers/positions.ts
+import {
+  apiWrite,
+  apiWriteCreate
+} from "../client.js";
+function createPosition(config, data, options = {}) {
+  return apiWriteCreate(config, "/api/profile/position", data, options);
+}
+function updatePosition(config, rkey, data, options = {}) {
+  return apiWrite(config, `/api/profile/position/${encodeURIComponent(rkey)}`, "PUT", {
+    body: data,
+    ...options
+  });
+}
+function deletePosition(config, rkey, options = {}) {
+  return apiWrite(config, `/api/profile/position/${encodeURIComponent(rkey)}`, "DELETE", options);
+}
+function setPositionPrimary(config, rkey, options = {}) {
+  return apiWrite(
+    config,
+    `/api/profile/position/${encodeURIComponent(rkey)}/primary`,
+    "PUT",
+    options
+  );
+}
+function unsetPositionPrimary(config, rkey, options = {}) {
+  return apiWrite(
+    config,
+    `/api/profile/position/${encodeURIComponent(rkey)}/primary`,
+    "DELETE",
+    options
+  );
+}
+function buildPositionPayload(position, skills) {
+  return {
+    company: position.company,
+    title: position.title,
+    description: position.description,
+    startedAt: position.startedAt,
+    endedAt: position.endedAt,
+    location: position.location ?? void 0,
+    // Carry the form-controlled optional fields the AppView merge would
+    // otherwise clear when absent from the PUT body. Omitting them here made
+    // every link/unlink strip employmentType, workplaceType, and entityRef
+    // off the position (id.sifa.profile.position#skills round-trip).
+    employmentType: position.employmentType,
+    workplaceType: position.workplaceType,
+    entityRef: position.entityRef,
+    skills
+  };
+}
+function linkSkillToPosition(config, position, skillRef, options = {}) {
+  const currentSkills = position.skills ?? [];
+  if (currentSkills.some((s) => s.uri === skillRef.uri)) {
+    return Promise.resolve({ success: true });
+  }
+  return updatePosition(
+    config,
+    position.rkey,
+    buildPositionPayload(position, [...currentSkills, skillRef]),
+    options
+  );
+}
+function unlinkSkillFromPosition(config, position, skillRef, options = {}) {
+  const remaining = (position.skills ?? []).filter((s) => s.uri !== skillRef.uri);
+  return updatePosition(config, position.rkey, buildPositionPayload(position, remaining), options);
+}
+export {
+  createPosition,
+  deletePosition,
+  linkSkillToPosition,
+  setPositionPrimary,
+  unlinkSkillFromPosition,
+  unsetPositionPrimary,
+  updatePosition
+};
+//# sourceMappingURL=positions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/positions.ts"],"sourcesContent":["import type { ProfilePosition, SkillRef } from '../../types/index.js';\nimport {\n  apiWrite,\n  apiWriteCreate,\n  type ApiFetchOptions,\n  type CreateResult,\n  type SifaApiConfig,\n  type WriteResult,\n} from '../client.js';\n\nexport type { CreateResult, WriteResult } from '../client.js';\n\n/**\n * Create a new `id.sifa.profile.position` record on the authenticated\n * user's PDS. The AppView signs and writes via the user's OAuth session.\n *\n * `data` should be a lexicon-shaped position record (without `createdAt`\n * or `rkey`; the AppView fills both). Validate with\n * `ProfilePositionRecordSchema.omit({ createdAt: true })` before calling\n * if you want client-side guarantees.\n *\n * Never throws -- inspect `result.success` and use `result.error` /\n * `result.pdsHost` for UI messaging.\n */\nexport function createPosition(\n  config: SifaApiConfig,\n  data: Record<string, unknown>,\n  options: ApiFetchOptions = {},\n): Promise<CreateResult> {\n  return apiWriteCreate(config, '/api/profile/position', data, options);\n}\n\n/** Update an existing position by `rkey`. */\nexport function updatePosition(\n  config: SifaApiConfig,\n  rkey: string,\n  data: Record<string, unknown>,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, `/api/profile/position/${encodeURIComponent(rkey)}`, 'PUT', {\n    body: data,\n    ...options,\n  });\n}\n\n/** Delete a position by `rkey`. */\nexport function deletePosition(\n  config: SifaApiConfig,\n  rkey: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, `/api/profile/position/${encodeURIComponent(rkey)}`, 'DELETE', options);\n}\n\n/** Mark a position as the user's primary (current) role. */\nexport function setPositionPrimary(\n  config: SifaApiConfig,\n  rkey: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(\n    config,\n    `/api/profile/position/${encodeURIComponent(rkey)}/primary`,\n    'PUT',\n    options,\n  );\n}\n\n/** Clear the \"primary\" flag on a position. */\nexport function unsetPositionPrimary(\n  config: SifaApiConfig,\n  rkey: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(\n    config,\n    `/api/profile/position/${encodeURIComponent(rkey)}/primary`,\n    'DELETE',\n    options,\n  );\n}\n\n/**\n * Build the PUT-body for a position update. Strips `null` `location`\n * (so JSON.stringify drops it) and includes the provided `skills` list.\n */\nfunction buildPositionPayload(\n  position: ProfilePosition,\n  skills: SkillRef[],\n): Record<string, unknown> {\n  return {\n    company: position.company,\n    title: position.title,\n    description: position.description,\n    startedAt: position.startedAt,\n    endedAt: position.endedAt,\n    location: position.location ?? undefined,\n    // Carry the form-controlled optional fields the AppView merge would\n    // otherwise clear when absent from the PUT body. Omitting them here made\n    // every link/unlink strip employmentType, workplaceType, and entityRef\n    // off the position (id.sifa.profile.position#skills round-trip).\n    employmentType: position.employmentType,\n    workplaceType: position.workplaceType,\n    entityRef: position.entityRef,\n    skills,\n  };\n}\n\n/**\n * Add a skill link to a position. Idempotent: if the skill is already\n * linked, resolves to `{ success: true }` without a network call.\n *\n * Implementation note: the AppView only exposes whole-record PUTs, so\n * this helper rebuilds the position body with the new skills list.\n */\nexport function linkSkillToPosition(\n  config: SifaApiConfig,\n  position: ProfilePosition,\n  skillRef: SkillRef,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  const currentSkills = position.skills ?? [];\n  if (currentSkills.some((s) => s.uri === skillRef.uri)) {\n    return Promise.resolve({ success: true });\n  }\n  return updatePosition(\n    config,\n    position.rkey,\n    buildPositionPayload(position, [...currentSkills, skillRef]),\n    options,\n  );\n}\n\n/** Remove a skill link from a position. */\nexport function unlinkSkillFromPosition(\n  config: SifaApiConfig,\n  position: ProfilePosition,\n  skillRef: SkillRef,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  const remaining = (position.skills ?? []).filter((s) => s.uri !== skillRef.uri);\n  return updatePosition(config, position.rkey, buildPositionPayload(position, remaining), options);\n}\n"],"mappings":";AACA;AAAA,EACE;AAAA,EACA;AAAA,OAKK;AAgBA,SAAS,eACd,QACA,MACA,UAA2B,CAAC,GACL;AACvB,SAAO,eAAe,QAAQ,yBAAyB,MAAM,OAAO;AACtE;AAGO,SAAS,eACd,QACA,MACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,yBAAyB,mBAAmB,IAAI,CAAC,IAAI,OAAO;AAAA,IAClF,MAAM;AAAA,IACN,GAAG;AAAA,EACL,CAAC;AACH;AAGO,SAAS,eACd,QACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,yBAAyB,mBAAmB,IAAI,CAAC,IAAI,UAAU,OAAO;AAChG;AAGO,SAAS,mBACd,QACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO;AAAA,IACL;AAAA,IACA,yBAAyB,mBAAmB,IAAI,CAAC;AAAA,IACjD;AAAA,IACA;AAAA,EACF;AACF;AAGO,SAAS,qBACd,QACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO;AAAA,IACL;AAAA,IACA,yBAAyB,mBAAmB,IAAI,CAAC;AAAA,IACjD;AAAA,IACA;AAAA,EACF;AACF;AAMA,SAAS,qBACP,UACA,QACyB;AACzB,SAAO;AAAA,IACL,SAAS,SAAS;AAAA,IAClB,OAAO,SAAS;AAAA,IAChB,aAAa,SAAS;AAAA,IACtB,WAAW,SAAS;AAAA,IACpB,SAAS,SAAS;AAAA,IAClB,UAAU,SAAS,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA,IAK/B,gBAAgB,SAAS;AAAA,IACzB,eAAe,SAAS;AAAA,IACxB,WAAW,SAAS;AAAA,IACpB;AAAA,EACF;AACF;AASO,SAAS,oBACd,QACA,UACA,UACA,UAA2B,CAAC,GACN;AACtB,QAAM,gBAAgB,SAAS,UAAU,CAAC;AAC1C,MAAI,cAAc,KAAK,CAAC,MAAM,EAAE,QAAQ,SAAS,GAAG,GAAG;AACrD,WAAO,QAAQ,QAAQ,EAAE,SAAS,KAAK,CAAC;AAAA,EAC1C;AACA,SAAO;AAAA,IACL;AAAA,IACA,SAAS;AAAA,IACT,qBAAqB,UAAU,CAAC,GAAG,eAAe,QAAQ,CAAC;AAAA,IAC3D;AAAA,EACF;AACF;AAGO,SAAS,wBACd,QACA,UACA,UACA,UAA2B,CAAC,GACN;AACtB,QAAM,aAAa,SAAS,UAAU,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,SAAS,GAAG;AAC9E,SAAO,eAAe,QAAQ,SAAS,MAAM,qBAAqB,UAAU,SAAS,GAAG,OAAO;AACjG;","names":[]}

package/dist/query/fetchers/profile-completeness.js

@@ -0,0 +1,45 @@
+// src/query/fetchers/profile-completeness.ts
+import { apiFetch } from "../client.js";
+var PROFILE_COMPLETENESS_SIGNALS = [
+  "headline",
+  "about",
+  "position",
+  "education",
+  "skill",
+  "certification"
+];
+async function fetchProfileCompleteness(config, options = {}) {
+  const { cookieHeader, ...rest } = options;
+  const headers = { ...rest.headers ?? {} };
+  if (cookieHeader) headers.cookie = cookieHeader;
+  const empty = {
+    complete: true,
+    score: PROFILE_COMPLETENESS_SIGNALS.length,
+    total: PROFILE_COMPLETENESS_SIGNALS.length,
+    missing: []
+  };
+  try {
+    const data = await apiFetch(config, "/api/profile/completeness", {
+      cache: "no-store",
+      credentials: "include",
+      timeoutMs: 5e3,
+      ...rest,
+      headers
+    });
+    if (!data) return empty;
+    const missing = Array.isArray(data.missing) ? data.missing : [];
+    return {
+      complete: data.complete ?? missing.length === 0,
+      score: data.score ?? PROFILE_COMPLETENESS_SIGNALS.length - missing.length,
+      total: data.total ?? PROFILE_COMPLETENESS_SIGNALS.length,
+      missing
+    };
+  } catch {
+    return empty;
+  }
+}
+export {
+  PROFILE_COMPLETENESS_SIGNALS,
+  fetchProfileCompleteness
+};
+//# sourceMappingURL=profile-completeness.js.map

package/dist/query/fetchers/profile-completeness.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/profile-completeness.ts"],"sourcesContent":["import { apiFetch, type ApiFetchOptions, type SifaApiConfig } from '../client.js';\n\n/**\n * The binary profile-completeness signals the AppView tracks. Each maps to a\n * concrete \"add this to your profile\" step in the unified Inbox checklist.\n */\nexport const PROFILE_COMPLETENESS_SIGNALS = [\n  'headline',\n  'about',\n  'position',\n  'education',\n  'skill',\n  'certification',\n] as const;\n\nexport type ProfileCompletenessSignal = (typeof PROFILE_COMPLETENESS_SIGNALS)[number];\n\n/**\n * Completeness of the signed-in user's own profile: which of the tracked signals\n * are still missing. `missing.length === 0` means complete.\n */\nexport interface ProfileCompleteness {\n  /** True when no tracked signal is missing. */\n  complete: boolean;\n  /** Signals present (of {@link PROFILE_COMPLETENESS_SIGNALS}). */\n  score: number;\n  /** Total tracked signals. */\n  total: number;\n  /** The signals still missing, for the checklist. */\n  missing: ProfileCompletenessSignal[];\n}\n\nexport interface FetchProfileCompletenessOptions 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   * so authenticated server fetches must forward the header explicitly.\n   */\n  cookieHeader?: string;\n}\n\n/**\n * Completeness of the signed-in user's own profile, an \"open task\" surfaced in\n * the unified Inbox as a checklist. Requires credentials -- the AppView reads\n * the owner from the session. Returns a complete-looking result on any failure\n * (no missing signals) so a broken call degrades to \"nothing to do\" rather than\n * nagging the user with a phantom checklist.\n */\nexport async function fetchProfileCompleteness(\n  config: SifaApiConfig,\n  options: FetchProfileCompletenessOptions = {},\n): Promise<ProfileCompleteness> {\n  const { cookieHeader, ...rest } = options;\n  const headers: Record<string, string> = { ...(rest.headers ?? {}) };\n  if (cookieHeader) headers.cookie = cookieHeader;\n\n  const empty: ProfileCompleteness = {\n    complete: true,\n    score: PROFILE_COMPLETENESS_SIGNALS.length,\n    total: PROFILE_COMPLETENESS_SIGNALS.length,\n    missing: [],\n  };\n\n  try {\n    const data = await apiFetch<ProfileCompleteness>(config, '/api/profile/completeness', {\n      cache: 'no-store',\n      credentials: 'include',\n      timeoutMs: 5000,\n      ...rest,\n      headers,\n    });\n    if (!data) return empty;\n    const missing = Array.isArray(data.missing) ? data.missing : [];\n    return {\n      complete: data.complete ?? missing.length === 0,\n      score: data.score ?? PROFILE_COMPLETENESS_SIGNALS.length - missing.length,\n      total: data.total ?? PROFILE_COMPLETENESS_SIGNALS.length,\n      missing,\n    };\n  } catch {\n    return empty;\n  }\n}\n"],"mappings":";AAAA,SAAS,gBAA0D;AAM5D,IAAM,+BAA+B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAmCA,eAAsB,yBACpB,QACA,UAA2C,CAAC,GACd;AAC9B,QAAM,EAAE,cAAc,GAAG,KAAK,IAAI;AAClC,QAAM,UAAkC,EAAE,GAAI,KAAK,WAAW,CAAC,EAAG;AAClE,MAAI,aAAc,SAAQ,SAAS;AAEnC,QAAM,QAA6B;AAAA,IACjC,UAAU;AAAA,IACV,OAAO,6BAA6B;AAAA,IACpC,OAAO,6BAA6B;AAAA,IACpC,SAAS,CAAC;AAAA,EACZ;AAEA,MAAI;AACF,UAAM,OAAO,MAAM,SAA8B,QAAQ,6BAA6B;AAAA,MACpF,OAAO;AAAA,MACP,aAAa;AAAA,MACb,WAAW;AAAA,MACX,GAAG;AAAA,MACH;AAAA,IACF,CAAC;AACD,QAAI,CAAC,KAAM,QAAO;AAClB,UAAM,UAAU,MAAM,QAAQ,KAAK,OAAO,IAAI,KAAK,UAAU,CAAC;AAC9D,WAAO;AAAA,MACL,UAAU,KAAK,YAAY,QAAQ,WAAW;AAAA,MAC9C,OAAO,KAAK,SAAS,6BAA6B,SAAS,QAAQ;AAAA,MACnE,OAAO,KAAK,SAAS,6BAA6B;AAAA,MAClD;AAAA,IACF;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/query/fetchers/profile-items-hide.js

@@ -0,0 +1,36 @@
+// src/query/fetchers/profile-items-hide.ts
+import { apiWrite } from "../client.js";
+var HIDDEN_ITEM_TYPES = [
+  "position",
+  "education",
+  "certification",
+  "project",
+  "volunteering",
+  "publication",
+  "course",
+  "honor",
+  "language",
+  "externalAccount"
+];
+var HIDDEN_ITEM_SOURCES = ["pds", "standard", "orcid"];
+function hideProfileItem(config, input, options = {}) {
+  return apiWrite(config, "/api/profile/items/hide", "POST", { ...options, body: input });
+}
+function unhideProfileItem(config, input, options = {}) {
+  return apiWrite(config, "/api/profile/items/hide", "DELETE", { ...options, body: input });
+}
+function bulkHideProfileItems(config, input, options = {}) {
+  return apiWrite(config, "/api/profile/items/bulk-hide", "POST", { ...options, body: input });
+}
+function bulkUnhideProfileItems(config, input, options = {}) {
+  return apiWrite(config, "/api/profile/items/bulk-hide", "DELETE", { ...options, body: input });
+}
+export {
+  HIDDEN_ITEM_SOURCES,
+  HIDDEN_ITEM_TYPES,
+  bulkHideProfileItems,
+  bulkUnhideProfileItems,
+  hideProfileItem,
+  unhideProfileItem
+};
+//# sourceMappingURL=profile-items-hide.js.map

package/dist/query/fetchers/profile-items-hide.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/profile-items-hide.ts"],"sourcesContent":["import { apiWrite, type ApiFetchOptions, type SifaApiConfig, type WriteResult } from '../client.js';\n\n/** Item types that can be hidden on the authenticated user's profile. */\nexport const HIDDEN_ITEM_TYPES = [\n  'position',\n  'education',\n  'certification',\n  'project',\n  'volunteering',\n  'publication',\n  'course',\n  'honor',\n  'language',\n  'externalAccount',\n] as const;\nexport type HiddenItemType = (typeof HIDDEN_ITEM_TYPES)[number];\n\n/** Source from which an item originates; disambiguates `item_id`. */\nexport const HIDDEN_ITEM_SOURCES = ['pds', 'standard', 'orcid'] as const;\nexport type HiddenItemSource = (typeof HIDDEN_ITEM_SOURCES)[number];\n\nexport interface HideProfileItemInput {\n  itemType: HiddenItemType;\n  source: HiddenItemSource;\n  /** rkey for `pds`, AT-URI for `standard`, ORCID putCode as text for `orcid`. */\n  itemId: string;\n}\n\nexport interface BulkHideProfileItemInput {\n  itemType: HiddenItemType;\n  source: HiddenItemSource;\n  itemIds: string[];\n}\n\n/**\n * Hide one profile item. The underlying record stays on the user's PDS;\n * only its display on sifa.id is suppressed.\n */\nexport function hideProfileItem(\n  config: SifaApiConfig,\n  input: HideProfileItemInput,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, '/api/profile/items/hide', 'POST', { ...options, body: input });\n}\n\n/** Restore a previously-hidden profile item. */\nexport function unhideProfileItem(\n  config: SifaApiConfig,\n  input: HideProfileItemInput,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, '/api/profile/items/hide', 'DELETE', { ...options, body: input });\n}\n\n/** Bulk-hide profile items sharing the same `itemType` + `source`. */\nexport function bulkHideProfileItems(\n  config: SifaApiConfig,\n  input: BulkHideProfileItemInput,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, '/api/profile/items/bulk-hide', 'POST', { ...options, body: input });\n}\n\n/** Bulk-unhide profile items sharing the same `itemType` + `source`. */\nexport function bulkUnhideProfileItems(\n  config: SifaApiConfig,\n  input: BulkHideProfileItemInput,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, '/api/profile/items/bulk-hide', 'DELETE', { ...options, body: input });\n}\n"],"mappings":";AAAA,SAAS,gBAA4E;AAG9E,IAAM,oBAAoB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,IAAM,sBAAsB,CAAC,OAAO,YAAY,OAAO;AAoBvD,SAAS,gBACd,QACA,OACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,2BAA2B,QAAQ,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AACxF;AAGO,SAAS,kBACd,QACA,OACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,2BAA2B,UAAU,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AAC1F;AAGO,SAAS,qBACd,QACA,OACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,gCAAgC,QAAQ,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AAC7F;AAGO,SAAS,uBACd,QACA,OACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,gCAAgC,UAAU,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AAC/F;","names":[]}

package/dist/query/fetchers/profile-locations.js

@@ -0,0 +1,23 @@
+// src/query/fetchers/profile-locations.ts
+import {
+  apiWrite,
+  apiWriteCreate
+} from "../client.js";
+function createProfileLocation(config, data, options = {}) {
+  return apiWriteCreate(config, "/api/profile/location", data, options);
+}
+function updateProfileLocation(config, rkey, data, options = {}) {
+  return apiWrite(config, `/api/profile/location/${encodeURIComponent(rkey)}`, "PUT", {
+    body: data,
+    ...options
+  });
+}
+function deleteProfileLocation(config, rkey, options = {}) {
+  return apiWrite(config, `/api/profile/location/${encodeURIComponent(rkey)}`, "DELETE", options);
+}
+export {
+  createProfileLocation,
+  deleteProfileLocation,
+  updateProfileLocation
+};
+//# sourceMappingURL=profile-locations.js.map

package/dist/query/fetchers/profile-locations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/profile-locations.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 * Address payload accepted by `/api/profile/location` endpoints.\n *\n * Accepts both shapes during the community.lexicon.location.address\n * migration. Prefer `country` + `locality` (new) over `countryCode` +\n * `city` (legacy). The API's `locationSchema` is a Zod union that\n * accepts either pair.\n */\nexport interface ProfileLocationAddress {\n  /** Legacy alias for `country` (alpha-2). */\n  countryCode?: string;\n  /** community.lexicon.location.address field -- prefer over `countryCode`. */\n  country?: string;\n  region?: string;\n  /** Legacy alias for `locality`. */\n  city?: string;\n  /** community.lexicon.location.address field -- prefer over `city`. */\n  locality?: string;\n}\n\n/** Body accepted by {@link createProfileLocation} / {@link updateProfileLocation}. */\nexport interface ProfileLocationInput {\n  address: ProfileLocationAddress;\n  type: string;\n  label?: string;\n  isPrimary?: boolean;\n}\n\n/** Create a new profile location entry. */\nexport function createProfileLocation(\n  config: SifaApiConfig,\n  data: ProfileLocationInput,\n  options: ApiFetchOptions = {},\n): Promise<CreateResult> {\n  return apiWriteCreate(config, '/api/profile/location', data, options);\n}\n\n/** Update an existing profile location by `rkey`. */\nexport function updateProfileLocation(\n  config: SifaApiConfig,\n  rkey: string,\n  data: ProfileLocationInput,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, `/api/profile/location/${encodeURIComponent(rkey)}`, 'PUT', {\n    body: data,\n    ...options,\n  });\n}\n\n/** Delete a profile location by `rkey`. */\nexport function deleteProfileLocation(\n  config: SifaApiConfig,\n  rkey: string,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, `/api/profile/location/${encodeURIComponent(rkey)}`, 'DELETE', options);\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,OAKK;AA+BA,SAAS,sBACd,QACA,MACA,UAA2B,CAAC,GACL;AACvB,SAAO,eAAe,QAAQ,yBAAyB,MAAM,OAAO;AACtE;AAGO,SAAS,sBACd,QACA,MACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,yBAAyB,mBAAmB,IAAI,CAAC,IAAI,OAAO;AAAA,IAClF,MAAM;AAAA,IACN,GAAG;AAAA,EACL,CAAC;AACH;AAGO,SAAS,sBACd,QACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,yBAAyB,mBAAmB,IAAI,CAAC,IAAI,UAAU,OAAO;AAChG;","names":[]}

package/dist/query/fetchers/profile-mutations.js

@@ -0,0 +1,82 @@
+// src/query/fetchers/profile-mutations.ts
+import { apiWrite } from "../client.js";
+function updateProfileSelf(config, data, options = {}) {
+  return apiWrite(config, "/api/profile/self", "PUT", { body: data, ...options });
+}
+function updateProfileOverride(config, data, options = {}) {
+  return apiWrite(config, "/api/profile/override", "PUT", { body: data, ...options });
+}
+function refreshPds(config, options = {}) {
+  return apiWrite(
+    config,
+    "/api/profile/refresh-pds",
+    "POST",
+    options
+  );
+}
+async function uploadAvatar(config, file, options = {}) {
+  const fetchFn = config.fetch ?? globalThis.fetch;
+  const url = `${config.baseUrl}/api/profile/avatar`;
+  const formData = new FormData();
+  formData.append("file", file);
+  try {
+    const res = await fetchFn(url, {
+      method: "POST",
+      credentials: options.credentials ?? "include",
+      body: formData,
+      signal: options.signal ?? AbortSignal.timeout(options.timeoutMs ?? 3e4),
+      headers: options.headers
+    });
+    if (!res.ok) {
+      const errBody = await res.json().catch(() => ({}));
+      const msg = errBody.message ?? `Request failed (${res.status})`;
+      const pdsHost = errBody.pdsHost;
+      return { success: false, error: msg, ...pdsHost ? { pdsHost } : {} };
+    }
+    const data = await res.json();
+    return { success: true, url: data.url };
+  } catch {
+    return { success: false, error: "Network error" };
+  }
+}
+function deleteAvatarOverride(config, options = {}) {
+  return apiWrite(config, "/api/profile/avatar", "DELETE", options);
+}
+async function uploadNamePronunciationAudio(config, file, options = {}) {
+  const fetchFn = config.fetch ?? globalThis.fetch;
+  const url = `${config.baseUrl}/api/profile/pronunciation-audio`;
+  const formData = new FormData();
+  formData.append("file", file);
+  try {
+    const res = await fetchFn(url, {
+      method: "POST",
+      credentials: options.credentials ?? "include",
+      body: formData,
+      signal: options.signal ?? AbortSignal.timeout(options.timeoutMs ?? 3e4),
+      headers: options.headers
+    });
+    if (!res.ok) {
+      const errBody = await res.json().catch(() => ({}));
+      const msg = errBody.message ?? `Request failed (${res.status})`;
+      const pdsHost = errBody.pdsHost;
+      return { success: false, error: msg, ...pdsHost ? { pdsHost } : {} };
+    }
+    const data = await res.json();
+    return { success: true, url: data.url };
+  } catch {
+    return { success: false, error: "Network error" };
+  }
+}
+function deleteNamePronunciationAudio(config, options = {}) {
+  return apiWrite(config, "/api/profile/pronunciation-audio", "DELETE", options);
+}
+export {
+  deleteAvatarOverride,
+  deleteNamePronunciationAudio,
+  refreshPds,
+  updateProfileOverride,
+  updateProfileSelf,
+  uploadAvatar,
+  uploadNamePronunciationAudio
+};
+//# sourceMappingURL=profile-mutations.js.map

package/dist/query/fetchers/profile-mutations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/profile-mutations.ts"],"sourcesContent":["import { apiWrite, type ApiFetchOptions, type SifaApiConfig, type WriteResult } from '../client.js';\n\n/** Industry/domain entry on the profile self record. */\nexport interface ProfileIndustryInput {\n  industry: string;\n  domain?: string;\n}\n\n/**\n * Location payload accepted by `updateProfileSelf`.\n *\n * Accepts both shapes during the community.lexicon.location.address\n * migration. Prefer `locality` (new) over `city` (legacy) when sending.\n * The API's locationSchema is a Zod union that resolves either input.\n */\nexport interface ProfileSelfLocation {\n  country: string;\n  countryCode?: string;\n  region?: string;\n  city?: string;\n  locality?: string;\n}\n\n/** Body accepted by {@link updateProfileSelf}. */\nexport interface UpdateProfileSelfInput {\n  headline?: string;\n  about?: string;\n  /** Schema.org Person.givenName from id.sifa.profile.self.givenName. */\n  givenName?: string;\n  /** Schema.org Person.familyName from id.sifa.profile.self.familyName. */\n  familyName?: string;\n  /** Free-form phonetic respelling of the name from id.sifa.profile.self.namePronunciation. */\n  namePronunciation?: string;\n  industries?: ProfileIndustryInput[];\n  location?: ProfileSelfLocation;\n  website?: string;\n  openTo?: string[];\n  preferredWorkplace?: string[];\n  availableFromUtc?: number;\n  availableToUtc?: number;\n}\n\n/** Update the authenticated user's `id.sifa.profile.self` record. */\nexport function updateProfileSelf(\n  config: SifaApiConfig,\n  data: UpdateProfileSelfInput,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, '/api/profile/self', 'PUT', { body: data, ...options });\n}\n\n/** Body accepted by {@link updateProfileOverride}. */\nexport interface UpdateProfileOverrideInput {\n  headline?: string | null;\n  about?: string | null;\n  displayName?: string | null;\n  pronouns?: string | null;\n}\n\n/**\n * Override aggregated profile fields with sifa-specific values. `null`\n * clears the override and falls back to the upstream PDS value.\n */\nexport function updateProfileOverride(\n  config: SifaApiConfig,\n  data: UpdateProfileOverrideInput,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, '/api/profile/override', 'PUT', { body: data, ...options });\n}\n\n/** Extended result for {@link refreshPds}. */\nexport interface RefreshPdsResult extends WriteResult {\n  displayName?: string | null;\n  avatar?: string | null;\n}\n\n/**\n * Re-pull the authenticated user's `app.bsky.actor.profile` from their\n * PDS. Returns the freshly resolved `displayName` and `avatar` on\n * success so the UI can update without a full profile refetch.\n */\nexport function refreshPds(\n  config: SifaApiConfig,\n  options: ApiFetchOptions = {},\n): Promise<RefreshPdsResult> {\n  return apiWrite<{ displayName?: string | null; avatar?: string | null }>(\n    config,\n    '/api/profile/refresh-pds',\n    'POST',\n    options,\n  );\n}\n\n/** Extended result for {@link uploadAvatar}. */\nexport interface UploadAvatarResult extends WriteResult {\n  /** Publicly accessible URL of the newly uploaded avatar. */\n  url?: string;\n}\n\n/**\n * Upload a new avatar via `multipart/form-data`. Pass either a `File`\n * (browser) or any `Blob` (Expo, node). The SDK leaves `Content-Type`\n * unset so the runtime can set the multipart boundary automatically.\n *\n * Never throws -- inspect `result.success` and `result.url`.\n */\nexport async function uploadAvatar(\n  config: SifaApiConfig,\n  file: Blob,\n  options: ApiFetchOptions = {},\n): Promise<UploadAvatarResult> {\n  const fetchFn = config.fetch ?? globalThis.fetch;\n  const url = `${config.baseUrl}/api/profile/avatar`;\n  const formData = new FormData();\n  formData.append('file', file);\n\n  try {\n    const res = await fetchFn(url, {\n      method: 'POST',\n      credentials: options.credentials ?? 'include',\n      body: formData,\n      signal: options.signal ?? AbortSignal.timeout(options.timeoutMs ?? 30_000),\n      headers: options.headers,\n    });\n    if (!res.ok) {\n      const errBody = (await res.json().catch(() => ({}))) as {\n        message?: string;\n        pdsHost?: string;\n      };\n      const msg = errBody.message ?? `Request failed (${res.status})`;\n      const pdsHost = errBody.pdsHost;\n      return { success: false, error: msg, ...(pdsHost ? { pdsHost } : {}) };\n    }\n    const data = (await res.json()) as { url: string };\n    return { success: true, url: data.url };\n  } catch {\n    return { success: false, error: 'Network error' };\n  }\n}\n\n/** Delete the authenticated user's avatar override (revert to PDS avatar). */\nexport function deleteAvatarOverride(\n  config: SifaApiConfig,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, '/api/profile/avatar', 'DELETE', options);\n}\n\n/** Extended result for {@link uploadNamePronunciationAudio}. */\nexport interface UploadPronunciationAudioResult extends WriteResult {\n  /** Publicly accessible URL of the newly uploaded audio clip. */\n  url?: string;\n}\n\n/**\n * Upload a name-pronunciation audio clip via `multipart/form-data`. Pass a\n * `File` (browser) or any `Blob` (Expo, node). The SDK leaves `Content-Type`\n * unset so the runtime sets the multipart boundary automatically.\n *\n * Never throws -- inspect `result.success` and `result.url`.\n */\nexport async function uploadNamePronunciationAudio(\n  config: SifaApiConfig,\n  file: Blob,\n  options: ApiFetchOptions = {},\n): Promise<UploadPronunciationAudioResult> {\n  const fetchFn = config.fetch ?? globalThis.fetch;\n  const url = `${config.baseUrl}/api/profile/pronunciation-audio`;\n  const formData = new FormData();\n  formData.append('file', file);\n\n  try {\n    const res = await fetchFn(url, {\n      method: 'POST',\n      credentials: options.credentials ?? 'include',\n      body: formData,\n      signal: options.signal ?? AbortSignal.timeout(options.timeoutMs ?? 30_000),\n      headers: options.headers,\n    });\n    if (!res.ok) {\n      const errBody = (await res.json().catch(() => ({}))) as {\n        message?: string;\n        pdsHost?: string;\n      };\n      const msg = errBody.message ?? `Request failed (${res.status})`;\n      const pdsHost = errBody.pdsHost;\n      return { success: false, error: msg, ...(pdsHost ? { pdsHost } : {}) };\n    }\n    const data = (await res.json()) as { url: string };\n    return { success: true, url: data.url };\n  } catch {\n    return { success: false, error: 'Network error' };\n  }\n}\n\n/** Delete the name-pronunciation audio clip from the user's profile. */\nexport function deleteNamePronunciationAudio(\n  config: SifaApiConfig,\n  options: ApiFetchOptions = {},\n): Promise<WriteResult> {\n  return apiWrite(config, '/api/profile/pronunciation-audio', 'DELETE', options);\n}\n"],"mappings":";AAAA,SAAS,gBAA4E;AA2C9E,SAAS,kBACd,QACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,qBAAqB,OAAO,EAAE,MAAM,MAAM,GAAG,QAAQ,CAAC;AAChF;AAcO,SAAS,sBACd,QACA,MACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,yBAAyB,OAAO,EAAE,MAAM,MAAM,GAAG,QAAQ,CAAC;AACpF;AAaO,SAAS,WACd,QACA,UAA2B,CAAC,GACD;AAC3B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAeA,eAAsB,aACpB,QACA,MACA,UAA2B,CAAC,GACC;AAC7B,QAAM,UAAU,OAAO,SAAS,WAAW;AAC3C,QAAM,MAAM,GAAG,OAAO,OAAO;AAC7B,QAAM,WAAW,IAAI,SAAS;AAC9B,WAAS,OAAO,QAAQ,IAAI;AAE5B,MAAI;AACF,UAAM,MAAM,MAAM,QAAQ,KAAK;AAAA,MAC7B,QAAQ;AAAA,MACR,aAAa,QAAQ,eAAe;AAAA,MACpC,MAAM;AAAA,MACN,QAAQ,QAAQ,UAAU,YAAY,QAAQ,QAAQ,aAAa,GAAM;AAAA,MACzE,SAAS,QAAQ;AAAA,IACnB,CAAC;AACD,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,UAAW,MAAM,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AAIlD,YAAM,MAAM,QAAQ,WAAW,mBAAmB,IAAI,MAAM;AAC5D,YAAM,UAAU,QAAQ;AACxB,aAAO,EAAE,SAAS,OAAO,OAAO,KAAK,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC,EAAG;AAAA,IACvE;AACA,UAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,WAAO,EAAE,SAAS,MAAM,KAAK,KAAK,IAAI;AAAA,EACxC,QAAQ;AACN,WAAO,EAAE,SAAS,OAAO,OAAO,gBAAgB;AAAA,EAClD;AACF;AAGO,SAAS,qBACd,QACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,uBAAuB,UAAU,OAAO;AAClE;AAeA,eAAsB,6BACpB,QACA,MACA,UAA2B,CAAC,GACa;AACzC,QAAM,UAAU,OAAO,SAAS,WAAW;AAC3C,QAAM,MAAM,GAAG,OAAO,OAAO;AAC7B,QAAM,WAAW,IAAI,SAAS;AAC9B,WAAS,OAAO,QAAQ,IAAI;AAE5B,MAAI;AACF,UAAM,MAAM,MAAM,QAAQ,KAAK;AAAA,MAC7B,QAAQ;AAAA,MACR,aAAa,QAAQ,eAAe;AAAA,MACpC,MAAM;AAAA,MACN,QAAQ,QAAQ,UAAU,YAAY,QAAQ,QAAQ,aAAa,GAAM;AAAA,MACzE,SAAS,QAAQ;AAAA,IACnB,CAAC;AACD,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,UAAW,MAAM,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AAIlD,YAAM,MAAM,QAAQ,WAAW,mBAAmB,IAAI,MAAM;AAC5D,YAAM,UAAU,QAAQ;AACxB,aAAO,EAAE,SAAS,OAAO,OAAO,KAAK,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC,EAAG;AAAA,IACvE;AACA,UAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,WAAO,EAAE,SAAS,MAAM,KAAK,KAAK,IAAI;AAAA,EACxC,QAAQ;AACN,WAAO,EAAE,SAAS,OAAO,OAAO,gBAAgB;AAAA,EAClD;AACF;AAGO,SAAS,6BACd,QACA,UAA2B,CAAC,GACN;AACtB,SAAO,SAAS,QAAQ,oCAAoC,UAAU,OAAO;AAC/E;","names":[]}

package/dist/query/fetchers/profile-summary.js

@@ -0,0 +1,14 @@
+// src/query/fetchers/profile-summary.ts
+import {
+  summarizeProfileView
+} from "../../logic/profile-summary.js";
+import { fetchGetProfileView } from "./get-profile-view.js";
+async function fetchProfileSummary(config, actor, options = {}) {
+  const { maxSkills, ...fetchOptions } = options;
+  const view = await fetchGetProfileView(config, actor, fetchOptions);
+  return view ? summarizeProfileView(view, { maxSkills }) : null;
+}
+export {
+  fetchProfileSummary
+};
+//# sourceMappingURL=profile-summary.js.map

package/dist/query/fetchers/profile-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/profile-summary.ts"],"sourcesContent":["import {\n  summarizeProfileView,\n  type ProfileSummary,\n  type SummarizeProfileViewOptions,\n} from '../../logic/profile-summary.js';\nimport { fetchGetProfileView } from './get-profile-view.js';\nimport type { ApiFetchOptions, SifaApiConfig } from '../client.js';\n\n/**\n * Fetch the aggregated public profile via `id.sifa.getProfileView` and reduce it\n * to a compact {@link ProfileSummary} (identity, headline, current role/employer,\n * top skills). Convenience over `fetchGetProfileView` + `summarizeProfileView`,\n * for third-party surfaces that only want the headline facts.\n *\n * Returns `null` when the AppView has no profile for the actor. Server-callable\n * (Next.js RSC) and client-callable (Expo, browser).\n */\nexport async function fetchProfileSummary(\n  config: SifaApiConfig,\n  actor: string,\n  options: SummarizeProfileViewOptions & ApiFetchOptions = {},\n): Promise<ProfileSummary | null> {\n  const { maxSkills, ...fetchOptions } = options;\n  const view = await fetchGetProfileView(config, actor, fetchOptions);\n  return view ? summarizeProfileView(view, { maxSkills }) : null;\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,OAGK;AACP,SAAS,2BAA2B;AAYpC,eAAsB,oBACpB,QACA,OACA,UAAyD,CAAC,GAC1B;AAChC,QAAM,EAAE,WAAW,GAAG,aAAa,IAAI;AACvC,QAAM,OAAO,MAAM,oBAAoB,QAAQ,OAAO,YAAY;AAClE,SAAO,OAAO,qBAAqB,MAAM,EAAE,UAAU,CAAC,IAAI;AAC5D;","names":[]}

package/dist/query/fetchers/profile.js

@@ -0,0 +1,31 @@
+// src/query/fetchers/profile.ts
+import {
+  encodeIdentifier,
+  apiFetch,
+  apiFetchOrNull
+} from "../client.js";
+function fetchProfile(config, handleOrDid, options = {}) {
+  const path = `/api/profile/${encodeIdentifier(handleOrDid)}`;
+  return apiFetchOrNull(config, path, {
+    retryOn429: true,
+    ...options
+  });
+}
+async function fetchAtFundLink(config, did, options = {}) {
+  const path = `/api/profiles/${encodeIdentifier(did)}/at-fund-link`;
+  try {
+    const data = await apiFetch(config, path, {
+      next: { revalidate: 3600 },
+      timeoutMs: 5e3,
+      ...options
+    });
+    return typeof data.url === "string" ? data.url : null;
+  } catch {
+    return null;
+  }
+}
+export {
+  fetchAtFundLink,
+  fetchProfile
+};
+//# sourceMappingURL=profile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/query/fetchers/profile.ts"],"sourcesContent":["import type { Profile } from '../../types/index.js';\nimport {\n  encodeIdentifier,\n  apiFetch,\n  apiFetchOrNull,\n  type ApiFetchOptions,\n  type SifaApiConfig,\n} from '../client.js';\n\n/**\n * Read the aggregated profile for a handle or DID.\n *\n * Returns `null` when the AppView has no profile for the given identifier\n * (HTTP 404). Throws {@link ApiError} on other non-2xx responses.\n *\n * Server-callable (Next.js RSC) and client-callable (Expo, browser).\n */\nexport function fetchProfile(\n  config: SifaApiConfig,\n  handleOrDid: string,\n  options: ApiFetchOptions = {},\n): Promise<Profile | null> {\n  const path = `/api/profile/${encodeIdentifier(handleOrDid)}`;\n  return apiFetchOrNull<Profile>(config, path, {\n    retryOn429: true,\n    ...options,\n  });\n}\n\n/**\n * Public AT Fund link for a profile, if one is configured. Returns `null`\n * on any error or when the response payload's `url` field is missing or\n * non-string.\n */\nexport async function fetchAtFundLink(\n  config: SifaApiConfig,\n  did: string,\n  options: ApiFetchOptions = {},\n): Promise<string | null> {\n  const path = `/api/profiles/${encodeIdentifier(did)}/at-fund-link`;\n  try {\n    const data = await apiFetch<{ url?: unknown }>(config, path, {\n      next: { revalidate: 3600 },\n      timeoutMs: 5000,\n      ...options,\n    });\n    return typeof data.url === 'string' ? data.url : null;\n  } catch {\n    return null;\n  }\n}\n"],"mappings":";AACA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAUA,SAAS,aACd,QACA,aACA,UAA2B,CAAC,GACH;AACzB,QAAM,OAAO,gBAAgB,iBAAiB,WAAW,CAAC;AAC1D,SAAO,eAAwB,QAAQ,MAAM;AAAA,IAC3C,YAAY;AAAA,IACZ,GAAG;AAAA,EACL,CAAC;AACH;AAOA,eAAsB,gBACpB,QACA,KACA,UAA2B,CAAC,GACJ;AACxB,QAAM,OAAO,iBAAiB,iBAAiB,GAAG,CAAC;AACnD,MAAI;AACF,UAAM,OAAO,MAAM,SAA4B,QAAQ,MAAM;AAAA,MAC3D,MAAM,EAAE,YAAY,KAAK;AAAA,MACzB,WAAW;AAAA,MACX,GAAG;AAAA,IACL,CAAC;AACD,WAAO,OAAO,KAAK,QAAQ,WAAW,KAAK,MAAM;AAAA,EACnD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}