@singi-labs/sifa-sdk 0.19.44 → 0.19.45

package/dist/taxonomy/skill-grouping.js

@@ -0,0 +1,90 @@
+// src/taxonomy/skill-grouping.ts
+import { CATEGORY_ORDER, normalizeSkillCategory } from "./skill-categories.js";
+import { compareText } from "../format/compare-text.js";
+function dedupeSkills(skills) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const skill of skills) {
+    const key = skill.name.trim().toLowerCase();
+    const existing = groups.get(key);
+    const positions = skill.positionRkeys ?? [];
+    if (!existing) {
+      groups.set(key, {
+        ...skill,
+        mergedRkeys: [skill.rkey],
+        positionRkeys: [...positions]
+      });
+      continue;
+    }
+    existing.mergedRkeys.push(skill.rkey);
+    if (!existing.category && skill.category) existing.category = skill.category;
+    const incomingSubCategory = skill.subCategory?.trim();
+    if (incomingSubCategory && !existing.subCategory?.trim()) {
+      existing.subCategory = incomingSubCategory;
+    }
+    if ((skill.endorsementCount ?? 0) > (existing.endorsementCount ?? 0)) {
+      existing.endorsementCount = skill.endorsementCount;
+    }
+    if (skill.endorsed) existing.endorsed = true;
+    if (skill.activityBacked) existing.activityBacked = true;
+    const merged = /* @__PURE__ */ new Set([...existing.positionRkeys ?? [], ...positions]);
+    existing.positionRkeys = Array.from(merged);
+  }
+  return Array.from(groups.values());
+}
+function groupSkillsByCategory(skills) {
+  const grouped = /* @__PURE__ */ new Map();
+  for (const skill of skills) {
+    const normalised = normalizeSkillCategory(skill.category) ?? "";
+    const key = CATEGORY_ORDER.includes(normalised) ? normalised : "other";
+    const bucket = grouped.get(key) ?? [];
+    bucket.push(skill);
+    grouped.set(key, bucket);
+  }
+  for (const [, groupSkills] of grouped) {
+    groupSkills.sort((a, b) => {
+      const countDiff = (b.endorsementCount ?? 0) - (a.endorsementCount ?? 0);
+      if (countDiff !== 0) return countDiff;
+      return compareText(a.name, b.name);
+    });
+  }
+  const ordered = [];
+  for (const cat of CATEGORY_ORDER) {
+    const group = grouped.get(cat);
+    if (group?.length) ordered.push([cat, group]);
+  }
+  const otherGroup = grouped.get("other");
+  if (otherGroup?.length) ordered.push(["other", otherGroup]);
+  return ordered;
+}
+function groupSkillsBySubCategory(skills) {
+  const labels = /* @__PURE__ */ new Map();
+  const grouped = /* @__PURE__ */ new Map();
+  for (const skill of skills) {
+    const raw = skill.subCategory?.trim();
+    const key = raw ? raw.toLowerCase() : "";
+    if (raw && !labels.has(key)) labels.set(key, raw);
+    const bucket = grouped.get(key) ?? [];
+    bucket.push(skill);
+    grouped.set(key, bucket);
+  }
+  const sortByRank = (groupSkills) => [...groupSkills].sort((a, b) => {
+    const countDiff = (b.endorsementCount ?? 0) - (a.endorsementCount ?? 0);
+    if (countDiff !== 0) return countDiff;
+    return compareText(a.name, b.name);
+  });
+  const ordered = [];
+  for (const key of [...labels.keys()].sort(compareText)) {
+    const label = labels.get(key);
+    const group = grouped.get(key);
+    if (label && group?.length) ordered.push([label, sortByRank(group)]);
+  }
+  const ungrouped = grouped.get("");
+  if (ungrouped?.length) ordered.push([null, sortByRank(ungrouped)]);
+  return ordered;
+}
+export {
+  dedupeSkills,
+  groupSkillsByCategory,
+  groupSkillsBySubCategory
+};
+//# sourceMappingURL=skill-grouping.js.map

package/dist/taxonomy/skill-grouping.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/taxonomy/skill-grouping.ts"],"sourcesContent":["import type { ProfileSkill } from '../types/index.js';\n\nimport { CATEGORY_ORDER, normalizeSkillCategory } from './skill-categories.js';\nimport { compareText } from '../format/compare-text.js';\n\nexport type MergedProfileSkill = ProfileSkill & {\n  mergedRkeys: string[];\n  positionRkeys?: string[];\n};\n\n/**\n * Collapses skills that resolve to the same name (case-insensitive, trimmed).\n *\n * LinkedIn import creates one skill record per (skill, position) pair, so a\n * profile can have several \"Ruby\" rows. We surface them as a single chip with\n * all underlying rkeys exposed via `mergedRkeys` so edit/delete can fan out.\n */\nexport function dedupeSkills(skills: ProfileSkill[]): MergedProfileSkill[] {\n  const groups = new Map<string, MergedProfileSkill>();\n\n  for (const skill of skills) {\n    const key = skill.name.trim().toLowerCase();\n    const existing = groups.get(key);\n    const positions = (skill as ProfileSkill & { positionRkeys?: string[] }).positionRkeys ?? [];\n\n    if (!existing) {\n      groups.set(key, {\n        ...skill,\n        mergedRkeys: [skill.rkey],\n        positionRkeys: [...positions],\n      });\n      continue;\n    }\n\n    existing.mergedRkeys.push(skill.rkey);\n    if (!existing.category && skill.category) existing.category = skill.category;\n    const incomingSubCategory = skill.subCategory?.trim();\n    if (incomingSubCategory && !existing.subCategory?.trim()) {\n      existing.subCategory = incomingSubCategory;\n    }\n    if ((skill.endorsementCount ?? 0) > (existing.endorsementCount ?? 0)) {\n      existing.endorsementCount = skill.endorsementCount;\n    }\n    if (skill.endorsed) existing.endorsed = true;\n    if (skill.activityBacked) existing.activityBacked = true;\n    const merged = new Set([...(existing.positionRkeys ?? []), ...positions]);\n    existing.positionRkeys = Array.from(merged);\n  }\n\n  return Array.from(groups.values());\n}\n\n/**\n * Groups skills by category in CATEGORY_ORDER, with unknown/empty categories\n * collected under \"other\". Within each group: sorted by endorsementCount desc,\n * then alphabetical by name. Empty groups are omitted.\n */\nexport function groupSkillsByCategory<T extends ProfileSkill>(skills: T[]): [string, T[]][] {\n  const grouped = new Map<string, T[]>();\n\n  for (const skill of skills) {\n    // Accepts the lexicon's own ref form (id.sifa.defs#technical) as well as\n    // the bare token, so a record written to spec is not bucketed as \"other\".\n    const normalised = normalizeSkillCategory(skill.category) ?? '';\n    const key = (CATEGORY_ORDER as readonly string[]).includes(normalised) ? normalised : 'other';\n    const bucket = grouped.get(key) ?? [];\n    bucket.push(skill);\n    grouped.set(key, bucket);\n  }\n\n  for (const [, groupSkills] of grouped) {\n    groupSkills.sort((a, b) => {\n      const countDiff = (b.endorsementCount ?? 0) - (a.endorsementCount ?? 0);\n      if (countDiff !== 0) return countDiff;\n      return compareText(a.name, b.name);\n    });\n  }\n\n  const ordered: [string, T[]][] = [];\n  for (const cat of CATEGORY_ORDER) {\n    const group = grouped.get(cat);\n    if (group?.length) ordered.push([cat, group]);\n  }\n  const otherGroup = grouped.get('other');\n  if (otherGroup?.length) ordered.push(['other', otherGroup]);\n\n  return ordered;\n}\n\n/**\n * Groups skills by their freeform `subCategory` label (#305), for renderers\n * that present skills in the user's own groups (Frontend, Backend, etc.).\n *\n * Labels are matched case-insensitively and surfaced under the first-seen\n * casing. Groups are ordered alphabetically by label; skills with no\n * `subCategory` collect under a trailing `null` bucket (omitted when empty).\n * Within each group: endorsementCount desc, then alphabetical by name.\n */\nexport function groupSkillsBySubCategory<T extends ProfileSkill>(\n  skills: T[],\n): [string | null, T[]][] {\n  const labels = new Map<string, string>();\n  const grouped = new Map<string, T[]>();\n\n  for (const skill of skills) {\n    const raw = skill.subCategory?.trim();\n    const key = raw ? raw.toLowerCase() : '';\n    if (raw && !labels.has(key)) labels.set(key, raw);\n    const bucket = grouped.get(key) ?? [];\n    bucket.push(skill);\n    grouped.set(key, bucket);\n  }\n\n  // Clone before sorting so the caller's arrays are never mutated in place.\n  const sortByRank = (groupSkills: T[]): T[] =>\n    [...groupSkills].sort((a, b) => {\n      const countDiff = (b.endorsementCount ?? 0) - (a.endorsementCount ?? 0);\n      if (countDiff !== 0) return countDiff;\n      return compareText(a.name, b.name);\n    });\n\n  const ordered: [string | null, T[]][] = [];\n  for (const key of [...labels.keys()].sort(compareText)) {\n    const label = labels.get(key);\n    const group = grouped.get(key);\n    if (label && group?.length) ordered.push([label, sortByRank(group)]);\n  }\n  const ungrouped = grouped.get('');\n  if (ungrouped?.length) ordered.push([null, sortByRank(ungrouped)]);\n\n  return ordered;\n}\n"],"mappings":";AAEA,SAAS,gBAAgB,8BAA8B;AACvD,SAAS,mBAAmB;AAcrB,SAAS,aAAa,QAA8C;AACzE,QAAM,SAAS,oBAAI,IAAgC;AAEnD,aAAW,SAAS,QAAQ;AAC1B,UAAM,MAAM,MAAM,KAAK,KAAK,EAAE,YAAY;AAC1C,UAAM,WAAW,OAAO,IAAI,GAAG;AAC/B,UAAM,YAAa,MAAsD,iBAAiB,CAAC;AAE3F,QAAI,CAAC,UAAU;AACb,aAAO,IAAI,KAAK;AAAA,QACd,GAAG;AAAA,QACH,aAAa,CAAC,MAAM,IAAI;AAAA,QACxB,eAAe,CAAC,GAAG,SAAS;AAAA,MAC9B,CAAC;AACD;AAAA,IACF;AAEA,aAAS,YAAY,KAAK,MAAM,IAAI;AACpC,QAAI,CAAC,SAAS,YAAY,MAAM,SAAU,UAAS,WAAW,MAAM;AACpE,UAAM,sBAAsB,MAAM,aAAa,KAAK;AACpD,QAAI,uBAAuB,CAAC,SAAS,aAAa,KAAK,GAAG;AACxD,eAAS,cAAc;AAAA,IACzB;AACA,SAAK,MAAM,oBAAoB,MAAM,SAAS,oBAAoB,IAAI;AACpE,eAAS,mBAAmB,MAAM;AAAA,IACpC;AACA,QAAI,MAAM,SAAU,UAAS,WAAW;AACxC,QAAI,MAAM,eAAgB,UAAS,iBAAiB;AACpD,UAAM,SAAS,oBAAI,IAAI,CAAC,GAAI,SAAS,iBAAiB,CAAC,GAAI,GAAG,SAAS,CAAC;AACxE,aAAS,gBAAgB,MAAM,KAAK,MAAM;AAAA,EAC5C;AAEA,SAAO,MAAM,KAAK,OAAO,OAAO,CAAC;AACnC;AAOO,SAAS,sBAA8C,QAA8B;AAC1F,QAAM,UAAU,oBAAI,IAAiB;AAErC,aAAW,SAAS,QAAQ;AAG1B,UAAM,aAAa,uBAAuB,MAAM,QAAQ,KAAK;AAC7D,UAAM,MAAO,eAAqC,SAAS,UAAU,IAAI,aAAa;AACtF,UAAM,SAAS,QAAQ,IAAI,GAAG,KAAK,CAAC;AACpC,WAAO,KAAK,KAAK;AACjB,YAAQ,IAAI,KAAK,MAAM;AAAA,EACzB;AAEA,aAAW,CAAC,EAAE,WAAW,KAAK,SAAS;AACrC,gBAAY,KAAK,CAAC,GAAG,MAAM;AACzB,YAAM,aAAa,EAAE,oBAAoB,MAAM,EAAE,oBAAoB;AACrE,UAAI,cAAc,EAAG,QAAO;AAC5B,aAAO,YAAY,EAAE,MAAM,EAAE,IAAI;AAAA,IACnC,CAAC;AAAA,EACH;AAEA,QAAM,UAA2B,CAAC;AAClC,aAAW,OAAO,gBAAgB;AAChC,UAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,QAAI,OAAO,OAAQ,SAAQ,KAAK,CAAC,KAAK,KAAK,CAAC;AAAA,EAC9C;AACA,QAAM,aAAa,QAAQ,IAAI,OAAO;AACtC,MAAI,YAAY,OAAQ,SAAQ,KAAK,CAAC,SAAS,UAAU,CAAC;AAE1D,SAAO;AACT;AAWO,SAAS,yBACd,QACwB;AACxB,QAAM,SAAS,oBAAI,IAAoB;AACvC,QAAM,UAAU,oBAAI,IAAiB;AAErC,aAAW,SAAS,QAAQ;AAC1B,UAAM,MAAM,MAAM,aAAa,KAAK;AACpC,UAAM,MAAM,MAAM,IAAI,YAAY,IAAI;AACtC,QAAI,OAAO,CAAC,OAAO,IAAI,GAAG,EAAG,QAAO,IAAI,KAAK,GAAG;AAChD,UAAM,SAAS,QAAQ,IAAI,GAAG,KAAK,CAAC;AACpC,WAAO,KAAK,KAAK;AACjB,YAAQ,IAAI,KAAK,MAAM;AAAA,EACzB;AAGA,QAAM,aAAa,CAAC,gBAClB,CAAC,GAAG,WAAW,EAAE,KAAK,CAAC,GAAG,MAAM;AAC9B,UAAM,aAAa,EAAE,oBAAoB,MAAM,EAAE,oBAAoB;AACrE,QAAI,cAAc,EAAG,QAAO;AAC5B,WAAO,YAAY,EAAE,MAAM,EAAE,IAAI;AAAA,EACnC,CAAC;AAEH,QAAM,UAAkC,CAAC;AACzC,aAAW,OAAO,CAAC,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,WAAW,GAAG;AACtD,UAAM,QAAQ,OAAO,IAAI,GAAG;AAC5B,UAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,QAAI,SAAS,OAAO,OAAQ,SAAQ,KAAK,CAAC,OAAO,WAAW,KAAK,CAAC,CAAC;AAAA,EACrE;AACA,QAAM,YAAY,QAAQ,IAAI,EAAE;AAChC,MAAI,WAAW,OAAQ,SAAQ,KAAK,CAAC,MAAM,WAAW,SAAS,CAAC,CAAC;AAEjE,SAAO;AACT;","names":[]}

package/dist/taxonomy/verification-providers.js

@@ -0,0 +1,69 @@
+// src/taxonomy/verification-providers.ts
+var MU_VERIFIER_DIDS = [
+  "did:plc:ooensn4mr5mhznzypvxelfa3",
+  // eurosky.social -- coordinates the trusted-verifier program
+  "did:plc:durcipmx2rwgzzagbiumobs5",
+  // france-atmosphe.re
+  "did:plc:zsf5p7rqilz2qvyd7ezmxrfj",
+  // belgium-atmosphe.re
+  "did:plc:hd564mpf6bekrwzyhvujs54b",
+  // medsky.network
+  "did:plc:u5zp7npt5kpueado77kuihyz",
+  // npmx.dev
+  "did:plc:6tndl5lqrzjrx7ahjom2gjbq",
+  // stewardshiplab.org
+  "did:plc:vnycpb2e4lh4tc7oyr3n2jvh",
+  // newsmastfoundation.org
+  "did:plc:dsiqe4pszk5ldbjk66fyryjv"
+  // cpesr.fr
+];
+var VERIFICATION_PROVIDERS = {
+  bluesky: {
+    id: "bluesky",
+    label: "Bluesky",
+    priority: 0,
+    source: "bluesky-api",
+    verifierDids: []
+  },
+  mu: {
+    id: "mu",
+    label: "mu (Eurosky)",
+    priority: 1,
+    source: "firehose",
+    verifierDids: MU_VERIFIER_DIDS
+  }
+};
+function isKnownVerificationProvider(id) {
+  return Object.hasOwn(VERIFICATION_PROVIDERS, id);
+}
+function getVerificationProvider(id) {
+  return isKnownVerificationProvider(id) ? VERIFICATION_PROVIDERS[id] : void 0;
+}
+function resolveVerifierProvider(issuerDid) {
+  for (const provider of Object.values(VERIFICATION_PROVIDERS)) {
+    if (provider.source !== "firehose") continue;
+    if (provider.verifierDids.includes(issuerDid)) return provider.id;
+  }
+  return null;
+}
+function primaryVerification(verifications) {
+  let best = null;
+  let bestPriority = Number.POSITIVE_INFINITY;
+  for (const verification of verifications) {
+    const provider = getVerificationProvider(verification.provider);
+    if (!provider) continue;
+    if (provider.priority < bestPriority) {
+      best = verification;
+      bestPriority = provider.priority;
+    }
+  }
+  return best;
+}
+export {
+  VERIFICATION_PROVIDERS,
+  getVerificationProvider,
+  isKnownVerificationProvider,
+  primaryVerification,
+  resolveVerifierProvider
+};
+//# sourceMappingURL=verification-providers.js.map

package/dist/taxonomy/verification-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/taxonomy/verification-providers.ts"],"sourcesContent":["/**\n * Verification providers -- the trust roots Sifa recognizes for AT Protocol\n * `app.bsky.graph.verification` records.\n *\n * Framing (see decisions/2026-07-13-third-party-verification-providers.md, D4):\n * a verification checkmark is ONE low-tier trust layer, not Sifa's headline.\n * Most of what it certifies is \"this account is who they claim to be\" -- useful,\n * and worth carrying because it's an already-recognized network signal, but low\n * value on its own. It sits among Sifa's other trust signals and never becomes a\n * score or a gate. This registry only decides which issuers Sifa displays and\n * with what provenance.\n *\n * Data-only: badge colors and icons are consumer concerns (React DOM on web,\n * React Native on mobile), same split as {@link PLATFORM_LABELS}. Consumers map\n * a provider id to a token/color.\n */\n\nexport type VerificationProviderId = 'bluesky' | 'mu';\n\n/** How Sifa learns about a provider's verifications. */\nexport type VerificationSource = 'bluesky-api' | 'firehose';\n\nexport interface VerificationProvider {\n  id: VerificationProviderId;\n  /** Human label for the badge popover, e.g. \"Bluesky\", \"mu (Eurosky)\". */\n  label: string;\n  /**\n   * Primary-display priority (D1): when an account holds verifications from\n   * multiple providers, the lowest number wins the single inline badge and the\n   * rest move into the popover. Must be unique across providers.\n   */\n  priority: number;\n  /**\n   * - `bluesky-api`: sourced from Bluesky's public-API `verifiedStatus`. Bluesky\n   *   maintains its own trusted-verifier set, so Sifa keeps no local DID list.\n   * - `firehose`: sourced from the Jetstream, gated on {@link verifierDids}.\n   */\n  source: VerificationSource;\n  /**\n   * Trusted verifier DIDs for firehose-sourced providers. A verification record\n   * counts only if its ISSUER DID is in this list. Empty for `bluesky-api`\n   * providers (Bluesky's AppView owns that decision). DIDs, not handles: a handle\n   * takeover must never confer verifier status.\n   */\n  verifierDids: readonly string[];\n}\n\n/**\n * A verification held by an account, as surfaced to the UI. `issuerDid` is\n * present for firehose-sourced providers and absent for `bluesky-api`.\n */\nexport interface AccountVerification {\n  provider: VerificationProviderId;\n  verifiedAt?: string | null;\n  issuerDid?: string | null;\n}\n\n/**\n * mu / Eurosky trusted verifiers (see https://hello.mu.social/verification).\n * Sifa-maintained allowlist -- this is the governance commitment. Add a DID here\n * only after confirming the organization is a mu trusted verifier. Handles are\n * comments for humans; the DID is what the firehose issuer gate matches.\n */\nconst MU_VERIFIER_DIDS = [\n  'did:plc:ooensn4mr5mhznzypvxelfa3', // eurosky.social -- coordinates the trusted-verifier program\n  'did:plc:durcipmx2rwgzzagbiumobs5', // france-atmosphe.re\n  'did:plc:zsf5p7rqilz2qvyd7ezmxrfj', // belgium-atmosphe.re\n  'did:plc:hd564mpf6bekrwzyhvujs54b', // medsky.network\n  'did:plc:u5zp7npt5kpueado77kuihyz', // npmx.dev\n  'did:plc:6tndl5lqrzjrx7ahjom2gjbq', // stewardshiplab.org\n  'did:plc:vnycpb2e4lh4tc7oyr3n2jvh', // newsmastfoundation.org\n  'did:plc:dsiqe4pszk5ldbjk66fyryjv', // cpesr.fr\n] as const;\n\nexport const VERIFICATION_PROVIDERS: Record<VerificationProviderId, VerificationProvider> = {\n  bluesky: {\n    id: 'bluesky',\n    label: 'Bluesky',\n    priority: 0,\n    source: 'bluesky-api',\n    verifierDids: [],\n  },\n  mu: {\n    id: 'mu',\n    label: 'mu (Eurosky)',\n    priority: 1,\n    source: 'firehose',\n    verifierDids: MU_VERIFIER_DIDS,\n  },\n};\n\nexport function isKnownVerificationProvider(id: string): id is VerificationProviderId {\n  // Object.hasOwn, not `in`: `in` also matches inherited Object.prototype keys\n  // ('toString', 'constructor', ...), which would wrongly narrow those strings\n  // and make getVerificationProvider return a prototype function.\n  return Object.hasOwn(VERIFICATION_PROVIDERS, id);\n}\n\nexport function getVerificationProvider(id: string): VerificationProvider | undefined {\n  return isKnownVerificationProvider(id) ? VERIFICATION_PROVIDERS[id] : undefined;\n}\n\n/**\n * The firehose issuer gate: given the DID that authored an\n * `app.bsky.graph.verification` record, return the provider it verifies for, or\n * `null` if the issuer is not a recognized firehose verifier. API-sourced\n * providers (Bluesky) are never matched here -- their verifications do not enter\n * through the firehose, so a self-issued record cannot resolve to them.\n */\nexport function resolveVerifierProvider(issuerDid: string): VerificationProviderId | null {\n  for (const provider of Object.values(VERIFICATION_PROVIDERS)) {\n    if (provider.source !== 'firehose') continue;\n    if (provider.verifierDids.includes(issuerDid)) return provider.id;\n  }\n  return null;\n}\n\n/**\n * D1 primary-provider selection: from all verifications an account holds, pick\n * the one whose provider has the highest priority (lowest `priority` number) for\n * the single inline badge. The rest belong in the popover. Verifications from\n * unknown providers are ignored. Returns `null` when nothing is displayable.\n */\nexport function primaryVerification(\n  verifications: readonly AccountVerification[],\n): AccountVerification | null {\n  let best: AccountVerification | null = null;\n  let bestPriority = Number.POSITIVE_INFINITY;\n  for (const verification of verifications) {\n    const provider = getVerificationProvider(verification.provider);\n    if (!provider) continue;\n    if (provider.priority < bestPriority) {\n      best = verification;\n      bestPriority = provider.priority;\n    }\n  }\n  return best;\n}\n"],"mappings":";AA+DA,IAAM,mBAAmB;AAAA,EACvB;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AACF;AAEO,IAAM,yBAA+E;AAAA,EAC1F,SAAS;AAAA,IACP,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,cAAc,CAAC;AAAA,EACjB;AAAA,EACA,IAAI;AAAA,IACF,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,cAAc;AAAA,EAChB;AACF;AAEO,SAAS,4BAA4B,IAA0C;AAIpF,SAAO,OAAO,OAAO,wBAAwB,EAAE;AACjD;AAEO,SAAS,wBAAwB,IAA8C;AACpF,SAAO,4BAA4B,EAAE,IAAI,uBAAuB,EAAE,IAAI;AACxE;AASO,SAAS,wBAAwB,WAAkD;AACxF,aAAW,YAAY,OAAO,OAAO,sBAAsB,GAAG;AAC5D,QAAI,SAAS,WAAW,WAAY;AACpC,QAAI,SAAS,aAAa,SAAS,SAAS,EAAG,QAAO,SAAS;AAAA,EACjE;AACA,SAAO;AACT;AAQO,SAAS,oBACd,eAC4B;AAC5B,MAAI,OAAmC;AACvC,MAAI,eAAe,OAAO;AAC1B,aAAW,gBAAgB,eAAe;AACxC,UAAM,WAAW,wBAAwB,aAAa,QAAQ;AAC9D,QAAI,CAAC,SAAU;AACf,QAAI,SAAS,WAAW,cAAc;AACpC,aAAO;AACP,qBAAe,SAAS;AAAA,IAC1B;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/taxonomy/workplace-type.js

@@ -0,0 +1,38 @@
+// src/taxonomy/workplace-type.ts
+var WORKPLACE_TYPE_OPTIONS = [
+  { value: "id.sifa.defs#onSite", label: "On-site" },
+  { value: "id.sifa.defs#hybrid", label: "Hybrid" },
+  { value: "id.sifa.defs#remoteLocal", label: "Remote (same country)" },
+  { value: "id.sifa.defs#remoteRegion", label: "Remote (same region)" },
+  { value: "id.sifa.defs#remoteGlobal", label: "Remote (anywhere)" }
+];
+var WORKPLACE_TYPE_LABELS = {
+  ...Object.fromEntries(WORKPLACE_TYPE_OPTIONS.map((o) => [o.value, o.label])),
+  "id.sifa.defs#remote": "Remote"
+};
+function getWorkplaceTypeLabel(value) {
+  if (!value) return void 0;
+  return WORKPLACE_TYPE_LABELS[value] ?? value;
+}
+var WORKPLACE_TYPE_LEGACY_ALIASES = {
+  "id.sifa.defs#remote": "id.sifa.defs#remoteGlobal"
+};
+function normalizeWorkplaceTypes(values) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const value of values) {
+    const canonical = WORKPLACE_TYPE_LEGACY_ALIASES[value] ?? value;
+    if (seen.has(canonical)) continue;
+    seen.add(canonical);
+    out.push(canonical);
+  }
+  return out;
+}
+export {
+  WORKPLACE_TYPE_LABELS,
+  WORKPLACE_TYPE_LEGACY_ALIASES,
+  WORKPLACE_TYPE_OPTIONS,
+  getWorkplaceTypeLabel,
+  normalizeWorkplaceTypes
+};
+//# sourceMappingURL=workplace-type.js.map

package/dist/taxonomy/workplace-type.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/taxonomy/workplace-type.ts"],"sourcesContent":["/**\n * Workplace-type taxonomy. Mirrors `id.sifa.defs#workplaceType.knownValues`\n * from sifa-lexicons. `remote` is retained for legacy records but the scoped\n * variants (`remoteLocal`, `remoteRegion`, `remoteGlobal`) are preferred for\n * new records per the lexicon description.\n */\n\nexport interface WorkplaceTypeOption {\n  value: string;\n  label: string;\n}\n\nexport const WORKPLACE_TYPE_OPTIONS: WorkplaceTypeOption[] = [\n  { value: 'id.sifa.defs#onSite', label: 'On-site' },\n  { value: 'id.sifa.defs#hybrid', label: 'Hybrid' },\n  { value: 'id.sifa.defs#remoteLocal', label: 'Remote (same country)' },\n  { value: 'id.sifa.defs#remoteRegion', label: 'Remote (same region)' },\n  { value: 'id.sifa.defs#remoteGlobal', label: 'Remote (anywhere)' },\n];\n\nexport const WORKPLACE_TYPE_LABELS: Record<string, string> = {\n  ...Object.fromEntries(WORKPLACE_TYPE_OPTIONS.map((o) => [o.value, o.label])),\n  'id.sifa.defs#remote': 'Remote',\n};\n\n/** Resolve a label for a workplace-type token. Falls back to the raw value. */\nexport function getWorkplaceTypeLabel(value: string | undefined | null): string | undefined {\n  if (!value) return undefined;\n  return WORKPLACE_TYPE_LABELS[value] ?? value;\n}\n\n/**\n * Legacy workplace tokens the lexicon retains for old records, mapped to their\n * current canonical token. `id.sifa.defs#remote` is \"Treated as remoteGlobal by\n * AppViews\" per the lexicon, so it resolves to the scoped `remoteGlobal`.\n */\nexport const WORKPLACE_TYPE_LEGACY_ALIASES: Record<string, string> = {\n  'id.sifa.defs#remote': 'id.sifa.defs#remoteGlobal',\n};\n\n/**\n * Normalize a list of workplace-type tokens: resolve legacy aliases to their\n * canonical token, then dedup while preserving first-seen order. Unknown tokens\n * pass through untouched (forward-compat). Used by the editor (so a legacy token\n * maps onto a real option and migrates forward on save) and by display (so a\n * record carrying both the legacy and canonical token renders a single badge).\n */\nexport function normalizeWorkplaceTypes(values: readonly string[]): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const value of values) {\n    const canonical = WORKPLACE_TYPE_LEGACY_ALIASES[value] ?? value;\n    if (seen.has(canonical)) continue;\n    seen.add(canonical);\n    out.push(canonical);\n  }\n  return out;\n}\n"],"mappings":";AAYO,IAAM,yBAAgD;AAAA,EAC3D,EAAE,OAAO,uBAAuB,OAAO,UAAU;AAAA,EACjD,EAAE,OAAO,uBAAuB,OAAO,SAAS;AAAA,EAChD,EAAE,OAAO,4BAA4B,OAAO,wBAAwB;AAAA,EACpE,EAAE,OAAO,6BAA6B,OAAO,uBAAuB;AAAA,EACpE,EAAE,OAAO,6BAA6B,OAAO,oBAAoB;AACnE;AAEO,IAAM,wBAAgD;AAAA,EAC3D,GAAG,OAAO,YAAY,uBAAuB,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAAA,EAC3E,uBAAuB;AACzB;AAGO,SAAS,sBAAsB,OAAsD;AAC1F,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,sBAAsB,KAAK,KAAK;AACzC;AAOO,IAAM,gCAAwD;AAAA,EACnE,uBAAuB;AACzB;AASO,SAAS,wBAAwB,QAAqC;AAC3E,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,MAAgB,CAAC;AACvB,aAAW,SAAS,QAAQ;AAC1B,UAAM,YAAY,8BAA8B,KAAK,KAAK;AAC1D,QAAI,KAAK,IAAI,SAAS,EAAG;AACzB,SAAK,IAAI,SAAS;AAClB,QAAI,KAAK,SAAS;AAAA,EACpB;AACA,SAAO;AACT;","names":[]}

package/dist/tokens/colors.js

@@ -0,0 +1,11 @@
+// src/tokens/colors.ts
+var colors = {
+  /** Flexoki Blue -- Sifa's primary accent. */
+  primary: "#4385BE",
+  /** Flexoki Purple -- secondary accent, shared across Singi Labs products. */
+  secondary: "#8B7EC8"
+};
+export {
+  colors
+};
+//# sourceMappingURL=colors.js.map

package/dist/tokens/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tokens/colors.ts"],"sourcesContent":["/**\n * Sifa brand colors -- accent values from the Singi Labs design system.\n *\n * Source of truth: `Singi Labs/brand/design-system.md` §Colors. Sifa uses a\n * distinct Flexoki accent from sibling Singi Labs products (Barazo, Singi\n * Labs itself); Flexoki Purple is the shared secondary accent across the\n * product family.\n *\n * NOTE: Neutral scales (background, surface, border, text) are not encoded\n * here. They come from Radix Colors (12-step scales with automatic\n * light/dark mode) and resolve at runtime via CSS variables in\n * `sifa-web`'s `globals.css`. Encoding them as TS constants would\n * misrepresent how they're consumed.\n */\n\nexport const colors = {\n  /** Flexoki Blue -- Sifa's primary accent. */\n  primary: '#4385BE',\n  /** Flexoki Purple -- secondary accent, shared across Singi Labs products. */\n  secondary: '#8B7EC8',\n} as const;\n\nexport type Colors = typeof colors;\n"],"mappings":";AAeO,IAAM,SAAS;AAAA;AAAA,EAEpB,SAAS;AAAA;AAAA,EAET,WAAW;AACb;","names":[]}

package/dist/tokens/icons.js

@@ -0,0 +1,15 @@
+// src/tokens/icons.ts
+var iconSet = "phosphor";
+var iconWeights = {
+  /** UI chrome -- buttons, nav, default state. */
+  uiChrome: "regular",
+  /** Interactive / active states -- selected items, primary buttons. */
+  interactive: "bold",
+  /** Decorative / illustration -- empty states, hero sections. */
+  decorative: "duotone"
+};
+export {
+  iconSet,
+  iconWeights
+};
+//# sourceMappingURL=icons.js.map

package/dist/tokens/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tokens/icons.ts"],"sourcesContent":["/**\n * Sifa icon-set conventions.\n *\n * Source of truth: `Singi Labs/brand/design-system.md` §Icons. Phosphor\n * Icons is the only icon library used across Singi Labs products; mixing\n * icon families within a product is forbidden by convention.\n *\n * The weight conventions are guidance for consumers, not enforced. Encoded\n * here so tooling (e.g., a future \"design lint\" check) can reference them.\n */\n\nexport const iconSet = 'phosphor' as const;\n\nexport const iconWeights = {\n  /** UI chrome -- buttons, nav, default state. */\n  uiChrome: 'regular',\n  /** Interactive / active states -- selected items, primary buttons. */\n  interactive: 'bold',\n  /** Decorative / illustration -- empty states, hero sections. */\n  decorative: 'duotone',\n} as const;\n\nexport type IconSet = typeof iconSet;\nexport type IconWeights = typeof iconWeights;\n"],"mappings":";AAWO,IAAM,UAAU;AAEhB,IAAM,cAAc;AAAA;AAAA,EAEzB,UAAU;AAAA;AAAA,EAEV,aAAa;AAAA;AAAA,EAEb,YAAY;AACd;","names":[]}

package/dist/tokens/index.js

@@ -1,41 +1,12 @@
-// src/tokens/colors.ts
-var colors = {
-  /** Flexoki Blue -- Sifa's primary accent. */
-  primary: "#4385BE",
-  /** Flexoki Purple -- secondary accent, shared across Singi Labs products. */
-  secondary: "#8B7EC8"
+// src/tokens/index.ts
+import { colors } from "./colors.js";
+import { fonts, fontFallbackStacks } from "./typography.js";
+import { iconSet, iconWeights } from "./icons.js";
+export {
+  colors,
+  fontFallbackStacks,
+  fonts,
+  iconSet,
+  iconWeights
 };
-
-// src/tokens/typography.ts
-var SYSTEM_SANS_FALLBACK = "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif";
-var SYSTEM_MONO_FALLBACK = "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";
-var INTL_SCRIPT_FALLBACK = "'Noto Sans', 'Noto Sans Arabic', 'Noto Sans Devanagari', 'Noto Sans Thai', 'Noto Sans Hebrew'";
-var CJK_SYSTEM_FALLBACK = "'Hiragino Kaku Gothic ProN', 'Hiragino Sans', 'Yu Gothic UI', 'Meiryo', 'Noto Sans CJK JP', 'PingFang SC', 'Microsoft YaHei', 'Noto Sans CJK SC', 'PingFang TC', 'Microsoft JhengHei', 'Noto Sans CJK TC', 'Apple SD Gothic Neo', 'Malgun Gothic', 'Noto Sans CJK KR'";
-var fonts = {
-  /** Body text -- iA Writer Quattro (self-hosted, OFL-licensed). */
-  sans: "iA Writer Quattro",
-  /** Headings (h1-h3) -- Space Grotesk Bold (self-hosted). Single weight (700). */
-  display: "Space Grotesk",
-  /** Code / monospace -- Source Code Pro (loaded via `next/font` in Next.js consumers). */
-  mono: "Source Code Pro"
-};
-var fontFallbackStacks = {
-  sans: `'${fonts.sans}', ${INTL_SCRIPT_FALLBACK}, ${CJK_SYSTEM_FALLBACK}, ${SYSTEM_SANS_FALLBACK}`,
-  display: `'${fonts.display}', '${fonts.sans}', ${INTL_SCRIPT_FALLBACK}, ${CJK_SYSTEM_FALLBACK}, system-ui, sans-serif`,
-  mono: `'${fonts.mono}', ${SYSTEM_MONO_FALLBACK}`
-};
-
-// src/tokens/icons.ts
-var iconSet = "phosphor";
-var iconWeights = {
-  /** UI chrome -- buttons, nav, default state. */
-  uiChrome: "regular",
-  /** Interactive / active states -- selected items, primary buttons. */
-  interactive: "bold",
-  /** Decorative / illustration -- empty states, hero sections. */
-  decorative: "duotone"
-};
-
-export { colors, fontFallbackStacks, fonts, iconSet, iconWeights };
-//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/tokens/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tokens/colors.ts","../../src/tokens/typography.ts","../../src/tokens/icons.ts"],"names":[],"mappings":";AAeO,IAAM,MAAA,GAAS;AAAA;AAAA,EAEpB,OAAA,EAAS,SAAA;AAAA;AAAA,EAET,SAAA,EAAW;AACb;;;ACRA,IAAM,oBAAA,GAAuB,mEAAA;AAC7B,IAAM,oBAAA,GAAuB,0DAAA;AAK7B,IAAM,oBAAA,GACJ,+FAAA;AAMF,IAAM,mBAAA,GACJ,uQAAA;AAKK,IAAM,KAAA,GAAQ;AAAA;AAAA,EAEnB,IAAA,EAAM,mBAAA;AAAA;AAAA,EAEN,OAAA,EAAS,eAAA;AAAA;AAAA,EAET,IAAA,EAAM;AACR;AAEO,IAAM,kBAAA,GAAqB;AAAA,EAChC,IAAA,EAAM,IAAI,KAAA,CAAM,IAAI,MAAM,oBAAoB,CAAA,EAAA,EAAK,mBAAmB,CAAA,EAAA,EAAK,oBAAoB,CAAA,CAAA;AAAA,EAC/F,OAAA,EAAS,CAAA,CAAA,EAAI,KAAA,CAAM,OAAO,CAAA,IAAA,EAAO,MAAM,IAAI,CAAA,GAAA,EAAM,oBAAoB,CAAA,EAAA,EAAK,mBAAmB,CAAA,uBAAA,CAAA;AAAA,EAC7F,IAAA,EAAM,CAAA,CAAA,EAAI,KAAA,CAAM,IAAI,MAAM,oBAAoB,CAAA;AAChD;;;ACjCO,IAAM,OAAA,GAAU;AAEhB,IAAM,WAAA,GAAc;AAAA;AAAA,EAEzB,QAAA,EAAU,SAAA;AAAA;AAAA,EAEV,WAAA,EAAa,MAAA;AAAA;AAAA,EAEb,UAAA,EAAY;AACd","file":"index.js","sourcesContent":["/**\n * Sifa brand colors -- accent values from the Singi Labs design system.\n *\n * Source of truth: `Singi Labs/brand/design-system.md` §Colors. Sifa uses a\n * distinct Flexoki accent from sibling Singi Labs products (Barazo, Singi\n * Labs itself); Flexoki Purple is the shared secondary accent across the\n * product family.\n *\n * NOTE: Neutral scales (background, surface, border, text) are not encoded\n * here. They come from Radix Colors (12-step scales with automatic\n * light/dark mode) and resolve at runtime via CSS variables in\n * `sifa-web`'s `globals.css`. Encoding them as TS constants would\n * misrepresent how they're consumed.\n */\n\nexport const colors = {\n  /** Flexoki Blue -- Sifa's primary accent. */\n  primary: '#4385BE',\n  /** Flexoki Purple -- secondary accent, shared across Singi Labs products. */\n  secondary: '#8B7EC8',\n} as const;\n\nexport type Colors = typeof colors;\n","/**\n * Sifa typography tokens -- font families and fallback stacks.\n *\n * Source of truth: `Singi Labs/brand/design-system.md` §Typography. Three\n * families, with explicit fallback chains so consumers can paste straight\n * into a CSS `font-family` declaration or a React Native style.\n *\n * Self-hosted fonts (Sifa-web ships `iA Writer Quattro` + `Space Grotesk`\n * WOFF2 files; sifa-app will need to bundle equivalents). The SDK only\n * encodes the names + fallbacks; consumers handle font loading.\n */\n\nconst SYSTEM_SANS_FALLBACK = \"-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif\";\nconst SYSTEM_MONO_FALLBACK = 'ui-monospace, SFMono-Regular, Menlo, Consolas, monospace';\n\n// Noto Sans subsets layered after the brand fonts to cover scripts the\n// brand fonts don't ship. Consumers wire @font-face with `unicode-range`\n// so browsers fetch a file only when a glyph in that range is rendered.\nconst INTL_SCRIPT_FALLBACK =\n  \"'Noto Sans', 'Noto Sans Arabic', 'Noto Sans Devanagari', 'Noto Sans Thai', 'Noto Sans Hebrew'\";\n\n// OS-installed CJK fonts. Sifa intentionally does not ship CJK web fonts:\n// every CJK user already has an OS-level CJK font and vendoring them\n// would add 14+ MB. Listed JP-first, then SC, TC, KR, with Noto Sans CJK\n// per-script as the Linux fallback.\nconst CJK_SYSTEM_FALLBACK =\n  \"'Hiragino Kaku Gothic ProN', 'Hiragino Sans', 'Yu Gothic UI', 'Meiryo', 'Noto Sans CJK JP', \" +\n  \"'PingFang SC', 'Microsoft YaHei', 'Noto Sans CJK SC', \" +\n  \"'PingFang TC', 'Microsoft JhengHei', 'Noto Sans CJK TC', \" +\n  \"'Apple SD Gothic Neo', 'Malgun Gothic', 'Noto Sans CJK KR'\";\n\nexport const fonts = {\n  /** Body text -- iA Writer Quattro (self-hosted, OFL-licensed). */\n  sans: 'iA Writer Quattro',\n  /** Headings (h1-h3) -- Space Grotesk Bold (self-hosted). Single weight (700). */\n  display: 'Space Grotesk',\n  /** Code / monospace -- Source Code Pro (loaded via `next/font` in Next.js consumers). */\n  mono: 'Source Code Pro',\n} as const;\n\nexport const fontFallbackStacks = {\n  sans: `'${fonts.sans}', ${INTL_SCRIPT_FALLBACK}, ${CJK_SYSTEM_FALLBACK}, ${SYSTEM_SANS_FALLBACK}`,\n  display: `'${fonts.display}', '${fonts.sans}', ${INTL_SCRIPT_FALLBACK}, ${CJK_SYSTEM_FALLBACK}, system-ui, sans-serif`,\n  mono: `'${fonts.mono}', ${SYSTEM_MONO_FALLBACK}`,\n} as const;\n\nexport type Fonts = typeof fonts;\nexport type FontFallbackStacks = typeof fontFallbackStacks;\n","/**\n * Sifa icon-set conventions.\n *\n * Source of truth: `Singi Labs/brand/design-system.md` §Icons. Phosphor\n * Icons is the only icon library used across Singi Labs products; mixing\n * icon families within a product is forbidden by convention.\n *\n * The weight conventions are guidance for consumers, not enforced. Encoded\n * here so tooling (e.g., a future \"design lint\" check) can reference them.\n */\n\nexport const iconSet = 'phosphor' as const;\n\nexport const iconWeights = {\n  /** UI chrome -- buttons, nav, default state. */\n  uiChrome: 'regular',\n  /** Interactive / active states -- selected items, primary buttons. */\n  interactive: 'bold',\n  /** Decorative / illustration -- empty states, hero sections. */\n  decorative: 'duotone',\n} as const;\n\nexport type IconSet = typeof iconSet;\nexport type IconWeights = typeof iconWeights;\n"]}
+{"version":3,"sources":["../../src/tokens/index.ts"],"sourcesContent":["/**\n * `@singi-labs/sifa-sdk/tokens` -- Sifa brand design tokens.\n *\n * Encoded from `Singi Labs/brand/design-system.md`. Optional for third\n * parties; primary consumers are `sifa-web` (Tailwind config + font CSS)\n * and the planned `sifa-app` (React Native style objects).\n *\n * Decision (2026-05-14, reaffirmed 2026-05-16): TS constants only. No CSS\n * variable strings, no Style Dictionary output. Consumers translate to\n * their own format.\n */\n\nexport { colors, type Colors } from './colors.js';\nexport { fonts, fontFallbackStacks, type Fonts, type FontFallbackStacks } from './typography.js';\nexport { iconSet, iconWeights, type IconSet, type IconWeights } from './icons.js';\n"],"mappings":";AAYA,SAAS,cAA2B;AACpC,SAAS,OAAO,0BAA+D;AAC/E,SAAS,SAAS,mBAAmD;","names":[]}

package/dist/tokens/typography.js

@@ -0,0 +1,23 @@
+// src/tokens/typography.ts
+var SYSTEM_SANS_FALLBACK = "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif";
+var SYSTEM_MONO_FALLBACK = "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";
+var INTL_SCRIPT_FALLBACK = "'Noto Sans', 'Noto Sans Arabic', 'Noto Sans Devanagari', 'Noto Sans Thai', 'Noto Sans Hebrew'";
+var CJK_SYSTEM_FALLBACK = "'Hiragino Kaku Gothic ProN', 'Hiragino Sans', 'Yu Gothic UI', 'Meiryo', 'Noto Sans CJK JP', 'PingFang SC', 'Microsoft YaHei', 'Noto Sans CJK SC', 'PingFang TC', 'Microsoft JhengHei', 'Noto Sans CJK TC', 'Apple SD Gothic Neo', 'Malgun Gothic', 'Noto Sans CJK KR'";
+var fonts = {
+  /** Body text -- iA Writer Quattro (self-hosted, OFL-licensed). */
+  sans: "iA Writer Quattro",
+  /** Headings (h1-h3) -- Space Grotesk Bold (self-hosted). Single weight (700). */
+  display: "Space Grotesk",
+  /** Code / monospace -- Source Code Pro (loaded via `next/font` in Next.js consumers). */
+  mono: "Source Code Pro"
+};
+var fontFallbackStacks = {
+  sans: `'${fonts.sans}', ${INTL_SCRIPT_FALLBACK}, ${CJK_SYSTEM_FALLBACK}, ${SYSTEM_SANS_FALLBACK}`,
+  display: `'${fonts.display}', '${fonts.sans}', ${INTL_SCRIPT_FALLBACK}, ${CJK_SYSTEM_FALLBACK}, system-ui, sans-serif`,
+  mono: `'${fonts.mono}', ${SYSTEM_MONO_FALLBACK}`
+};
+export {
+  fontFallbackStacks,
+  fonts
+};
+//# sourceMappingURL=typography.js.map

package/dist/tokens/typography.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tokens/typography.ts"],"sourcesContent":["/**\n * Sifa typography tokens -- font families and fallback stacks.\n *\n * Source of truth: `Singi Labs/brand/design-system.md` §Typography. Three\n * families, with explicit fallback chains so consumers can paste straight\n * into a CSS `font-family` declaration or a React Native style.\n *\n * Self-hosted fonts (Sifa-web ships `iA Writer Quattro` + `Space Grotesk`\n * WOFF2 files; sifa-app will need to bundle equivalents). The SDK only\n * encodes the names + fallbacks; consumers handle font loading.\n */\n\nconst SYSTEM_SANS_FALLBACK = \"-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif\";\nconst SYSTEM_MONO_FALLBACK = 'ui-monospace, SFMono-Regular, Menlo, Consolas, monospace';\n\n// Noto Sans subsets layered after the brand fonts to cover scripts the\n// brand fonts don't ship. Consumers wire @font-face with `unicode-range`\n// so browsers fetch a file only when a glyph in that range is rendered.\nconst INTL_SCRIPT_FALLBACK =\n  \"'Noto Sans', 'Noto Sans Arabic', 'Noto Sans Devanagari', 'Noto Sans Thai', 'Noto Sans Hebrew'\";\n\n// OS-installed CJK fonts. Sifa intentionally does not ship CJK web fonts:\n// every CJK user already has an OS-level CJK font and vendoring them\n// would add 14+ MB. Listed JP-first, then SC, TC, KR, with Noto Sans CJK\n// per-script as the Linux fallback.\nconst CJK_SYSTEM_FALLBACK =\n  \"'Hiragino Kaku Gothic ProN', 'Hiragino Sans', 'Yu Gothic UI', 'Meiryo', 'Noto Sans CJK JP', \" +\n  \"'PingFang SC', 'Microsoft YaHei', 'Noto Sans CJK SC', \" +\n  \"'PingFang TC', 'Microsoft JhengHei', 'Noto Sans CJK TC', \" +\n  \"'Apple SD Gothic Neo', 'Malgun Gothic', 'Noto Sans CJK KR'\";\n\nexport const fonts = {\n  /** Body text -- iA Writer Quattro (self-hosted, OFL-licensed). */\n  sans: 'iA Writer Quattro',\n  /** Headings (h1-h3) -- Space Grotesk Bold (self-hosted). Single weight (700). */\n  display: 'Space Grotesk',\n  /** Code / monospace -- Source Code Pro (loaded via `next/font` in Next.js consumers). */\n  mono: 'Source Code Pro',\n} as const;\n\nexport const fontFallbackStacks = {\n  sans: `'${fonts.sans}', ${INTL_SCRIPT_FALLBACK}, ${CJK_SYSTEM_FALLBACK}, ${SYSTEM_SANS_FALLBACK}`,\n  display: `'${fonts.display}', '${fonts.sans}', ${INTL_SCRIPT_FALLBACK}, ${CJK_SYSTEM_FALLBACK}, system-ui, sans-serif`,\n  mono: `'${fonts.mono}', ${SYSTEM_MONO_FALLBACK}`,\n} as const;\n\nexport type Fonts = typeof fonts;\nexport type FontFallbackStacks = typeof fontFallbackStacks;\n"],"mappings":";AAYA,IAAM,uBAAuB;AAC7B,IAAM,uBAAuB;AAK7B,IAAM,uBACJ;AAMF,IAAM,sBACJ;AAKK,IAAM,QAAQ;AAAA;AAAA,EAEnB,MAAM;AAAA;AAAA,EAEN,SAAS;AAAA;AAAA,EAET,MAAM;AACR;AAEO,IAAM,qBAAqB;AAAA,EAChC,MAAM,IAAI,MAAM,IAAI,MAAM,oBAAoB,KAAK,mBAAmB,KAAK,oBAAoB;AAAA,EAC/F,SAAS,IAAI,MAAM,OAAO,OAAO,MAAM,IAAI,MAAM,oBAAoB,KAAK,mBAAmB;AAAA,EAC7F,MAAM,IAAI,MAAM,IAAI,MAAM,oBAAoB;AAChD;","names":[]}

package/dist/types/index.js

@@ -0,0 +1,10 @@
+// src/types/index.ts
+var PROJECT_ROLES = [
+  "id.sifa.defs#projectOwner",
+  "id.sifa.defs#projectCore",
+  "id.sifa.defs#projectContributor"
+];
+export {
+  PROJECT_ROLES
+};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["import type { AgentRef } from '../schemas/shared.js';\n\nexport interface LocationValue {\n  city?: string;\n  /** community.lexicon.location.address field -- preferred over `city`. */\n  locality?: string;\n  region?: string;\n  country: string;\n  countryCode?: string;\n  postalCode?: string;\n  geonameId?: number;\n}\n\nexport interface SkillRef {\n  uri: string;\n}\n\nexport interface ProfilePosition {\n  rkey: string;\n  /**\n   * Optional: omitted for self-employed / freelance / independent positions.\n   * The lexicon and the record schema already make company optional.\n   */\n  company?: string;\n  /**\n   * Portable org entity identifier (Wikidata/ROR/LEI URI) written when the user\n   * picks an organization from the resolver typeahead. Absent for free-text or\n   * independent positions (#159).\n   */\n  entityRef?: string;\n  /**\n   * Resolved current canonical name of the durably-linked company (#240),\n   * computed by the AppView at read time. Render this over `company` for a\n   * linked position, so a name correction reaches every linked profile without\n   * a PDS write. Absent for free-text or unresolved positions (fall back to\n   * `company`).\n   */\n  entityName?: string;\n  /**\n   * Canonical org reference (#511): a nested mirror of the flat\n   * name / did / entityRef fields. Prefer it when present; the nested\n   * shape wins over the flat fields (resolveAgentRef precedence).\n   */\n  agentRef?: AgentRef;\n  /**\n   * Company-page slug for a durably-linked position, resolved by the AppView at\n   * read time alongside `entityName` (#159). Lets a consumer link the company\n   * name to its `/c/{domain}` page without re-resolving `entityRef`. `domain` is\n   * the readable form, `publicId` the durable fallback; build the link as\n   * `/c/${companyDomain ?? companyPublicId}`. Both absent for free-text /\n   * unlinked positions.\n   */\n  companyDomain?: string;\n  companyPublicId?: string;\n  title: string;\n  description?: string;\n  startedAt: string;\n  endedAt?: string;\n  location?: LocationValue | null;\n  employmentType?: string;\n  /**\n   * Party this role is held on behalf of, when the person represents someone else --\n   * most often a fund whose board seat this is. A disclosure rather than a role type,\n   * so it is a separate field from `employmentType`. Absent for independent roles.\n   */\n  onBehalfOf?: string;\n  /** DID of the represented party, when known. May be an organization or a person. */\n  onBehalfOfDid?: string;\n  /** Portable entity identifier for the represented party (Wikidata/ROR/LEI URI). */\n  onBehalfOfEntityRef?: string;\n  workplaceType?: string;\n  skills?: SkillRef[];\n  linkedSkills?: ProfileSkill[];\n  primary?: boolean;\n  hidden?: boolean;\n}\n\nexport interface ProfileEducation {\n  rkey: string;\n  institution: string;\n  /**\n   * Portable org entity identifier (Wikidata/ROR/LEI URI) written when the user\n   * links the institution to a resolved organization (#159/#241). Absent for\n   * free-text entries. Mirrors `ProfilePosition.entityRef`; the AppView sends it\n   * for display (the \"Linked\" badge).\n   */\n  entityRef?: string;\n  /**\n   * Resolved current canonical name of the durably-linked institution (#252),\n   * computed by the AppView at read time. Render this over `institution` for a\n   * linked entry, so a name correction reaches every linked profile without a\n   * PDS write. Absent for free-text or unresolved entries (fall back to\n   * `institution`).\n   */\n  entityName?: string;\n  /**\n   * Canonical org reference (#511): a nested mirror of the flat\n   * name / did / entityRef fields. Prefer it when present; the nested\n   * shape wins over the flat fields (resolveAgentRef precedence).\n   */\n  agentRef?: AgentRef;\n  degree?: string;\n  fieldOfStudy?: string;\n  /** European Qualifications Framework level, 1 to 8 (8 = doctoral). */\n  eqfLevel?: number;\n  description?: string;\n  activities?: string;\n  startedAt?: string;\n  endedAt?: string;\n  hidden?: boolean;\n  /** User-flagged primary education entry, surfaced in the Highlights block. */\n  primary?: boolean;\n}\n\nexport interface ProfileSkill {\n  rkey: string;\n  name: string;\n  /**\n   * CID of the skill record, needed as a strongRef when endorsing it. Often\n   * absent: only the firehose carries a CID, so a skill added moments ago has\n   * none indexed yet. Pass it to `createEndorsement` when present and omit it\n   * otherwise -- the AppView resolves it from the owner's PDS.\n   */\n  cid?: string;\n  category?: string;\n  /**\n   * Freeform user-defined grouping label nested under `category` (e.g.\n   * \"Frontend\", \"Backend\"). No known values; renderers decide the display\n   * label. See `groupSkillsBySubCategory`.\n   */\n  subCategory?: string;\n  endorsementCount?: number;\n  endorsed?: boolean;\n  /**\n   * Names this skill was endorsed under, where they differ from what it is\n   * called now. Absent when nothing has drifted.\n   *\n   * A rename keeps the same record, so endorsements follow it and stay\n   * counted. Showing the original name is what keeps that honest: a reader can\n   * see that a skill now called one thing was vouched for as another, instead\n   * of the rename quietly laundering the endorsement.\n   */\n  endorsedAs?: string[];\n  activityBacked?: boolean;\n}\n\nexport interface SkillSuggestion {\n  canonicalName: string;\n  slug: string;\n  category: string;\n}\n\nexport interface Endorsement {\n  endorserDid: string;\n  endorserHandle: string;\n  endorserDisplayName?: string;\n  endorserAvatar?: string;\n  comment?: string;\n  relationshipContext?: string;\n  createdAt: string;\n}\n\nexport interface EndorsementData {\n  skillRkey: string;\n  comment?: string;\n  relationshipContext?: string;\n}\n\nexport interface ProfileLocation {\n  rkey: string;\n  type: string;\n  label?: string | null;\n  isPrimary: boolean;\n  locationCountry?: string | null;\n  locationRegion?: string | null;\n  /** Legacy alias for `locationLocality`; emitted by sifa-api during the additive response window. */\n  locationCity?: string | null;\n  /** community.lexicon.location.address field name -- prefer over `locationCity`. */\n  locationLocality?: string | null;\n  countryCode?: string | null;\n  location?: string | null;\n}\n\nexport interface ProfileCertification {\n  rkey: string;\n  name: string;\n  /**\n   * Issuing organization. The write contract names this field `authority`\n   * everywhere (record schema, DB column, PDS record); the AppView read view\n   * emits `authority` as the canonical field (#249). Optional during the\n   * deprecation window while consumers migrate off the legacy `issuingOrg`\n   * alias below.\n   */\n  authority?: string;\n  /**\n   * @deprecated Legacy read-view alias for {@link authority} (#249). Carries the\n   * same value; will be dropped once web + SDK consumers read `authority`.\n   */\n  issuingOrg?: string;\n  /**\n   * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the issuing\n   * organization to a resolved entity (#159/#241). Absent for free-text entries.\n   * Mirrors `ProfilePosition.entityRef`; the AppView sends it for display.\n   */\n  entityRef?: string;\n  /**\n   * Resolved current canonical name of the durably-linked issuing organization\n   * (#252), computed by the AppView at read time. Render this over `authority`\n   * for a linked entry. Absent for free-text or unresolved entries (fall back to\n   * `authority`).\n   */\n  entityName?: string;\n  /**\n   * Canonical org reference (#511): a nested mirror of the flat\n   * name / did / entityRef fields. Prefer it when present; the nested\n   * shape wins over the flat fields (resolveAgentRef precedence).\n   */\n  agentRef?: AgentRef;\n  issueDate?: string;\n  expiryDate?: string;\n  credentialUrl?: string;\n  hidden?: boolean;\n}\n\nexport interface ProfileProject {\n  rkey: string;\n  name: string;\n  /** The user's own role on the project (#596), e.g. Maintainer. */\n  role?: string;\n  description?: string;\n  url?: string;\n  startDate?: string;\n  endDate?: string;\n  /** Other people named on this project, hydrated from the stored DIDs. */\n  members?: ProjectMemberCard[];\n  /**\n   * AT-URI of the same project as recorded elsewhere, when this entry\n   * duplicates another person's. Set so consumers can tell the two describe one\n   * project; both still render from their own owner's record.\n   */\n  /** AT-URI of the same record on another person's profile, when they keep one. */\n  sameAs?: string;\n  hidden?: boolean;\n  /** User-flagged primary project, surfaced in the Highlights block. Ongoing only. */\n  primary?: boolean;\n}\n\nexport interface PublicationContributor {\n  name: string;\n  orcidId?: string;\n  did?: string;\n  handle?: string;\n}\n\n/**\n * A co-author an importer produced that the profile owner can offer to link to\n * a Sifa account.\n *\n * Matched on verified ORCID iD only, never on name: \"A. Example\", \"Alice\n * Example\", and \"Example, A.\" are one person, and \"J. Smith\" is four hundred.\n *\n * A suggestion, never a claim. Nothing reaches any repository until the owner\n * acts, which is what makes ORCID re-syncing safe: matching writes nothing, so\n * a re-sync cannot generate a confirmation request.\n */\nexport interface AuthorSuggestion {\n  /** ORCID iD the match was made on. The join key back to a contributor. */\n  orcidId: string;\n  did: string;\n  handle: string;\n  /** Display name on the matched account, for showing what is being proposed. */\n  displayName?: string;\n}\n\n/**\n * A typed link from a work to another version or form of it\n * (`id.sifa.defs#relatedIdentifier`). `relationType` uses the DataCite\n * vocabulary, e.g. `IsPreprintOf` on a preprint pointing at its published\n * version. `identifierType` is `DOI` (the default when absent), `AT-URI` or `URL`.\n */\nexport interface RelatedIdentifier {\n  identifier: string;\n  identifierType?: string;\n  relationType: string;\n}\n\nexport interface ProfilePublication {\n  rkey: string;\n  title: string;\n  subtitle?: string;\n  publisher?: string;\n  date?: string;\n  url?: string;\n  description?: string;\n  source?: 'sifa' | 'standard' | 'orcid';\n  doi?: string;\n  type?: string;\n  typeLabel?: string;\n  contributors?: PublicationContributor[];\n  verified?: boolean;\n  verifiedVia?: string;\n  orcidPutCode?: number;\n  hidden?: boolean;\n  /** User-flagged primary publication, surfaced in the Highlights block. */\n  primary?: boolean;\n  orcidCorroborated?: boolean;\n  pendingVerification?: boolean;\n  appId?: string;\n  /**\n   * AT-URI of the parent `site.standard.publication` for Standard.site\n   * articles — the subscribable unit. Used to group articles by publication\n   * on the profile. Undefined for Sifa/ORCID publications.\n   */\n  publicationUri?: string | null;\n  /** Canonical publication origin — the subscribe / link-out target. */\n  publicationUrl?: string | null;\n  /** Publication display name for the group header (falls back to host). */\n  publicationName?: string | null;\n  /**\n   * Cover image URL for Standard.site articles — the document's `coverImage`\n   * blob (CDN-served), falling back to the article page's og:image. Undefined\n   * for Sifa/ORCID publications, null when none could be resolved.\n   */\n  image?: string | null;\n  /**\n   * Other versions or forms of this work: relations declared on the record\n   * plus, for a DOI, those registered with DataCite or Crossref (#590). Feed\n   * to `groupPublicationVersions` to fold a preprint under its published version.\n   */\n  relatedIdentifiers?: RelatedIdentifier[];\n}\n\nexport interface ProfileVolunteering {\n  rkey: string;\n  organization: string;\n  /**\n   * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the\n   * organization to a resolved entity (#159/#241). Absent for free-text entries.\n   * Mirrors `ProfilePosition.entityRef`; the AppView sends it for display.\n   */\n  entityRef?: string;\n  /**\n   * Resolved current canonical name of the durably-linked organization (#252),\n   * computed by the AppView at read time. Render this over `organization` for a\n   * linked entry. Absent for free-text or unresolved entries (fall back to\n   * `organization`).\n   */\n  entityName?: string;\n  /**\n   * Canonical org reference (#511): a nested mirror of the flat\n   * name / did / entityRef fields. Prefer it when present; the nested\n   * shape wins over the flat fields (resolveAgentRef precedence).\n   */\n  agentRef?: AgentRef;\n  role?: string;\n  cause?: string;\n  startDate?: string;\n  endDate?: string;\n  description?: string;\n  hidden?: boolean;\n}\n\nexport interface ProfileHonor {\n  rkey: string;\n  title: string;\n  issuer?: string;\n  /**\n   * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the issuer to a\n   * resolved entity (#159/#241). Absent for free-text entries. Mirrors\n   * `ProfilePosition.entityRef`; the AppView sends it for display.\n   */\n  entityRef?: string;\n  /**\n   * Resolved current canonical name of the durably-linked issuer (#252),\n   * computed by the AppView at read time. Render this over `issuer` for a linked\n   * entry. Absent for free-text or unresolved entries (fall back to `issuer`).\n   */\n  entityName?: string;\n  /**\n   * Canonical org reference (#511): a nested mirror of the flat\n   * name / did / entityRef fields. Prefer it when present; the nested\n   * shape wins over the flat fields (resolveAgentRef precedence).\n   */\n  agentRef?: AgentRef;\n  date?: string;\n  description?: string;\n  hidden?: boolean;\n}\n\n/**\n * One proof link on an involvement record, as served by the AppView. Mirrors\n * `id.sifa.defs#artifactLink`, plus the computed rung-2 verification signal.\n */\nexport interface ProfileInvolvementLink {\n  url: string;\n  kind?: string;\n  label?: string;\n  /**\n   * Rung-2 cross-ref: true when the link host matches one of the owner's\n   * *verified* `externalAccount` records (GitHub, GitLab, ORCID, ...).\n   * Computed by the AppView; deterministic host match, no new primitive.\n   */\n  verified?: boolean;\n  /**\n   * Platform token of the matched verified external account (e.g.\n   * `id.sifa.defs#platformGithub`), for the badge label. Absent when\n   * `verified` is not true.\n   */\n  verifiedPlatform?: string;\n}\n\n/**\n * An involvement entry as served by the AppView: an `id.sifa.profile.involvement`\n * record, or a mapped legacy `id.sifa.profile.volunteering` record (`legacy`),\n * grouped in the UI by `kind` via the SDK's involvement-kind taxonomy.\n */\n/** One artifact link on an investment (round announcement, portfolio page, filing). */\nexport interface ProfileInvestmentLink {\n  url: string;\n  kind?: string;\n  label?: string;\n}\n\n/** A capital position: money the person put in. Roles with duties are positions. */\nexport interface ProfileInvestment {\n  rkey: string;\n  /** For a limited-partner entry this names the fund, not a portfolio company. */\n  company: string;\n  companyDid?: string;\n  entityRef?: string;\n  /** Resolved canonical name of the linked company. Render over `company` when present. */\n  entityName?: string;\n  /**\n   * Canonical org reference (#511): a nested mirror of the flat\n   * name / did / entityRef fields. Prefer it when present; the nested\n   * shape wins over the flat fields (resolveAgentRef precedence).\n   */\n  agentRef?: AgentRef;\n  /** How the capital went in. Angel, syndicate member or LP -- never GP. */\n  role?: string;\n  /** The company's funding stage at the time of the investment, not its stage today. */\n  stage?: string;\n  /** active / exited / written off / undisclosed. */\n  status?: string;\n  /** The vehicle the capital went through. Absent for a cheque in the person's own name. */\n  via?: string;\n  viaDid?: string;\n  viaEntityRef?: string;\n  /** Whole major currency units plus an ISO 4217 code. Absent unless the person opted in. */\n  amount?: { value: number; currency: string };\n  startedAt?: string;\n  endedAt?: string;\n  description?: string;\n  links?: ProfileInvestmentLink[];\n  hidden?: boolean;\n}\n\nexport interface ProfileInvolvement {\n  rkey: string;\n  /** Involvement-kind token; drives the display heading. Legacy rows map to charity. */\n  kind: string;\n  upstream?: string;\n  upstreamDid?: string;\n  upstreamUrl?: string;\n  role?: string;\n  description?: string;\n  startedAt?: string;\n  endedAt?: string;\n  links?: ProfileInvolvementLink[];\n  /**\n   * Portable org entity identifier (Wikidata/ROR/LEI URI) written when the user\n   * picks the upstream from the resolver typeahead. Absent for free-text or\n   * one-off involvement.\n   */\n  entityRef?: string;\n  /**\n   * Resolved current canonical name of the durably-linked upstream, computed by\n   * the AppView at read time. Render over `upstream` when present. Absent for\n   * free-text or unresolved entries.\n   */\n  entityName?: string;\n  /**\n   * Canonical org reference (#511): a nested mirror of the flat\n   * name / did / entityRef fields. Prefer it when present; the nested\n   * shape wins over the flat fields (resolveAgentRef precedence).\n   */\n  agentRef?: AgentRef;\n  location?: LocationValue | null;\n  skills?: SkillRef[];\n  /** Skill records resolved from `skills`, for display. */\n  linkedSkills?: ProfileSkill[];\n  /**\n   * True when this row is a mapped legacy `id.sifa.profile.volunteering` record\n   * (no `kind`), rendered under \"Volunteering\". Editing it backfills to an\n   * `involvement` record and deletes the legacy one.\n   */\n  legacy?: boolean;\n  hidden?: boolean;\n  /** User-flagged primary involvement, surfaced in the Highlights block. Ongoing only. */\n  primary?: boolean;\n  /** Other people named on this involvement, hydrated from the stored DIDs. */\n  collaborators?: ProjectMemberCard[];\n  /** AT-URI of the same involvement as recorded on another person's profile. */\n  sameAs?: string;\n}\n\nexport type LanguageProficiency =\n  'elementary' | 'limited_working' | 'professional_working' | 'full_professional' | 'native';\n\nexport interface ProfileLanguage {\n  rkey: string;\n  language: string;\n  proficiency?: LanguageProficiency;\n  hidden?: boolean;\n}\n\nexport interface ProfileCourse {\n  rkey: string;\n  name: string;\n  institution?: string;\n  /**\n   * Portable org entity identifier (Wikidata/ROR/LEI URI) linking the institution\n   * to a resolved entity (#159/#241). Absent for free-text entries. Mirrors\n   * `ProfilePosition.entityRef`; the AppView sends it for display.\n   */\n  entityRef?: string;\n  /**\n   * Resolved current canonical name of the durably-linked institution (#252),\n   * computed by the AppView at read time. Render this over `institution` for a\n   * linked entry. Absent for free-text or unresolved entries (fall back to\n   * `institution`).\n   */\n  entityName?: string;\n  /**\n   * Canonical org reference (#511): a nested mirror of the flat\n   * name / did / entityRef fields. Prefer it when present; the nested\n   * shape wins over the flat fields (resolveAgentRef precedence).\n   */\n  agentRef?: AgentRef;\n  number?: string;\n  /** rkey of the associated certification, resolved from the course's\n   * `credential` at-uri. Used to join the course to a certification in the\n   * same profile payload (for the linked-credential date and link). */\n  credentialRkey?: string;\n  /** Date the course was completed, as an RFC 3339 datetime. Optional; the\n   * editor collects month granularity (YYYY-MM). */\n  completedAt?: string;\n  /** `id.sifa.defs#courseRole` token. Absent means the user took the course. */\n  role?: string;\n  /** Teaching period of a taught or assisted course (YYYY, YYYY-MM or YYYY-MM-DD). */\n  startedAt?: string;\n  endedAt?: string;\n  /** rkey of the position the course was part of (taught under it, or taken\n   * as part of the job). The AppView resolves it from the record's `position`\n   * at-uri when building the profile view. */\n  positionRkey?: string;\n  /** rkey of the education record the course was part of, resolved by the\n   * AppView from the record's `education` at-uri. */\n  educationRkey?: string;\n  hidden?: boolean;\n}\n\n/** A related link on a presentation or delivery, as returned by the AppView. */\nexport interface PresentationLinkView {\n  uri: string;\n  label?: string;\n  type?: string;\n}\n\n/**\n * Another person named on someone's record, as rendered by the AppView.\n *\n * `displayName` and `avatar` are present when the person's identity may be\n * shown -- i.e. when {@link actorShowsIdentity} holds (`confirmed` or\n * `claimed`). Otherwise the card is a bare handle with no identity attached and\n * no link to a profile: naming someone is a claim, and until they affirm it (or\n * hold a claimed Sifa account that can be notified of the claim) the claim must\n * not borrow their face.\n */\nexport interface ActorCard {\n  did: string;\n  handle: string;\n  displayName?: string;\n  avatar?: string;\n  /**\n   * True when Sifa has indexed this account at all -- including an unclaimed\n   * atproto account seen via the firehose, which still renders at /p/<handle>.\n   * Broader than {@link claimed}; not on its own a reason to show identity.\n   */\n  hasSifaProfile?: boolean;\n  /**\n   * True when the named person has a claimed Sifa account (has authenticated\n   * via OAuth). A claimed account can be notified of a pending claim, so its\n   * identity is shown even before confirmation -- see {@link actorShowsIdentity}.\n   */\n  claimed?: boolean;\n  /** True once the named person has published a matching `id.sifa.confirmation`. */\n  confirmed?: boolean;\n  /**\n   * True when the record was materially changed after being confirmed -- a\n   * rename, or a changed role. The confirmation stands until withdrawn, but the\n   * UI should say the claim has moved since it was affirmed.\n   */\n  confirmedStale?: boolean;\n}\n\n/** @deprecated Use {@link ActorCard}. Kept so existing co-speaker call sites keep compiling. */\nexport type CoSpeaker = ActorCard;\n\n/**\n * Roles shipped today. The lexicon declares these as `knownValues`, so the\n * field itself stays a plain string: a consumer meeting a role it does not\n * recognise should show it rather than discard it.\n *\n * Display only. A record living in someone else's repository cannot grant\n * write access to anything, and the UI must not imply that it does.\n */\nexport const PROJECT_ROLES = [\n  'id.sifa.defs#projectOwner',\n  'id.sifa.defs#projectCore',\n  'id.sifa.defs#projectContributor',\n] as const;\n\nexport type ProjectRole = (typeof PROJECT_ROLES)[number];\n\n/** A person named as a member of a project, with their role alongside the actor card. */\nexport interface ProjectMemberCard extends ActorCard {\n  role?: string;\n  title?: string;\n}\n\n/** An occasion on which a presentation was delivered (the AppView view-model). */\nexport interface ProfilePresentationDelivery {\n  rkey: string;\n  /** rkey of the parent presentation when this delivery references one. */\n  presentationRkey?: string | null;\n  /** Co-speakers at this occasion, hydrated from the stored DIDs. */\n  coSpeakers?: CoSpeaker[];\n  /** AT-URI of the same session as recorded on another person's profile. */\n  sameAs?: string;\n  title?: string | null;\n  role?: string | null;\n  eventName?: string | null;\n  /** YYYY-MM-DD, or YYYY-MM / YYYY when the exact day is unknown. */\n  date?: string | null;\n  location?: string | null;\n  locationCountry?: string | null;\n  locationRegion?: string | null;\n  locationLocality?: string | null;\n  countryCode?: string | null;\n  /** Full community.lexicon.calendar.event mode token. */\n  mode?: string | null;\n  /** Full community.lexicon.calendar.event status token. */\n  status?: string | null;\n  links?: PresentationLinkView[];\n  /** at-uri of the linked calendar event, when present. */\n  eventUri?: string | null;\n  hidden?: boolean;\n}\n\n/** A reusable presentation with its deliveries grouped underneath (AppView view-model). */\nexport interface ProfilePresentation {\n  rkey: string;\n  title: string;\n  description?: string | null;\n  /** Duration in minutes: a fixed value (min only) or a range. */\n  duration?: { minMinutes: number; maxMinutes?: number } | null;\n  intendedAudiences?: string[];\n  links?: PresentationLinkView[];\n  /** at-uri of a long-form write-up (Leaflet / site.standard document). */\n  writeupUri?: string | null;\n  /** Resolved URL of the uploaded cover image, when present. */\n  coverImageUrl?: string | null;\n  hidden?: boolean;\n  /** User-flagged primary talk, surfaced in the Highlights block. Talks only, not sessions. */\n  primary?: boolean;\n  deliveries?: ProfilePresentationDelivery[];\n}\n\nexport interface TrustStat {\n  key: string;\n  label: string;\n  value: number;\n}\n\nexport interface ActiveApp {\n  id: string;\n  name: string;\n  category: string;\n  recentCount: number;\n  latestRecordAt?: string | null;\n}\n\nexport interface VerifiedAccount {\n  platform: string;\n  identifier: string;\n  url?: string;\n}\n\nexport interface ExternalAccountKeytraceClaim {\n  rkey: string;\n  claimedAt: string;\n}\n\nexport interface ExternalAccount {\n  rkey: string;\n  platform: string;\n  url: string;\n  label?: string;\n  feedUrl?: string;\n  primary?: boolean;\n  verifiable: boolean;\n  verified: boolean;\n  verifiedVia?: string | null;\n  source?: 'sifa' | 'keytrace' | 'keyoxide' | 'marque';\n  hidden?: boolean;\n  keytraceVerified?: boolean;\n  keytraceClaim?: ExternalAccountKeytraceClaim;\n}\n\nexport interface FeedItem {\n  title: string;\n  excerpt: string;\n  url: string;\n  timestamp: string;\n  source: string;\n}\n\nexport interface PdsProviderInfo {\n  name: string;\n  host: string;\n}\n\nexport interface ProfileIndustry {\n  industry: string;\n  domain?: string;\n}\n\nexport interface ProfileOverrideSource {\n  headline?: string;\n  about?: string;\n  displayName?: string;\n  avatarUrl?: string;\n}\n\n/**\n * A structured physical address on the org view. Mirrors\n * `community.lexicon.location.address`; every field is optional.\n */\nexport interface OrgAddressView {\n  country: string | null;\n  postalCode: string | null;\n  region: string | null;\n  locality: string | null;\n  street: string | null;\n  name: string | null;\n}\n\n/** A featured link on the org view. Both `name` and `url` are present. */\nexport interface OrgLinkView {\n  name: string;\n  url: string;\n}\n\n/**\n * A self-declared industry/domain pair on the org view. Mirrors the person\n * profile's industry/domain shape; `industry` is always present, `domain` is an\n * optional refinement (`null` when absent).\n */\nexport interface OrgIndustryView {\n  industry: string;\n  domain: string | null;\n}\n\n/**\n * The org-profile fields exposed on the profile resolve when the org rendering\n * floor is met. Narrow on purpose: `contact` is never included (not rendered\n * publicly); record URI/CID are internal. Mirrors sifa-api's `OrgProfileView`.\n */\nexport interface OrgProfileView {\n  name: string;\n  description: string | null;\n  website: string | null;\n  /** Blob CID (or resolved URL) of the org logo, when present. */\n  logoBlob: string | null;\n  entityRefs: string[] | null;\n  addresses: OrgAddressView[] | null;\n  /** Self-selected headcount range (declared bucket, never calculated). */\n  companySize: string | null;\n  companyType: string | null;\n  links: OrgLinkView[] | null;\n  /** Self-declared industry/domain pairs. */\n  industries: OrgIndustryView[] | null;\n  /** Self-declared founding date (year / YYYY-MM / YYYY-MM-DD). */\n  founded: string | null;\n  /** Self-declared \"also known as\" names / acronyms. */\n  aliases: string[] | null;\n}\n\n/**\n * A company entity recognized purely from the handle's registrable domain\n * (#160 auto-recognize), independent of any org record. Present on the verdict\n * when `recognized` is true. `domain` is the handle's registrable domain and\n * round-trips through `/c/<domain>`; `publicId` is nullable because entities\n * minted before the public_id backfill have none.\n */\nexport interface RecognizedEntity {\n  publicId: string | null;\n  domain: string;\n  name: string;\n}\n\n/**\n * Server-computed org rendering-floor verdict (#160), carried on the profile\n * resolve so clients need no extra round-trip. Read it via the `useOrgProfile`\n * hook.\n *\n * `isOrg` is the CLAIMED floor: true when the account has an\n * `id.sifa.org.profile` record AND its handle is a custom registrable domain\n * (the authoritative, PSL-backed check lives server-side).\n *\n * `recognized` is INDEPENDENT of `isOrg`: true when the handle's registrable\n * domain resolves to a known, non-suppressed, non-natural-person company entity\n * in Sifa's DB, even with no org record yet (auto-recognize known-company\n * domains). A known company that has not yet claimed is\n * `recognized: true, isOrg: false`; a claimed recognized company is both true.\n * Use it to treat a recognized-but-unclaimed company account as a company\n * (company onboarding, `/c/` routing) before it claims.\n */\nexport interface OrgFloorVerdict {\n  isOrg: boolean;\n  orgProfile?: OrgProfileView;\n  recognized: boolean;\n  /**\n   * Whether the account's handle is a custom registrable apex domain, i.e.\n   * eligible to CLAIM an org page (#306). Mirrors the `isBindableHandleDomain`\n   * floor the api enforces at write time, surfaced so the `/claim` wizard can\n   * gate on eligibility BEFORE the authority consent rather than failing the\n   * final PDS write. Independent of `isOrg`/`recognized` -- purely the handle's\n   * shape, so a `*.bsky.social` account reads false and a not-yet-claimed\n   * custom domain reads true.\n   *\n   * Optional here (a tolerant reader): the api always emits it, but a profile\n   * payload cached before this field shipped may omit it. Gate on the explicit\n   * `customDomain === false` for the up-front block; treat absent as unknown and\n   * let the api 403 stay the authoritative backstop -- never enforce on this\n   * field alone.\n   */\n  customDomain?: boolean;\n  /**\n   * Whether the account also keeps a visible personal profile, from\n   * `id.sifa.org.profile.personalProfileVisible`. True only for a claimed org\n   * (`isOrg`) that opted in -- the sole-trader case, where one DID carries both\n   * a person facet at `/p/` and a company facet at `/c/` and neither route\n   * redirects to the other. Absent or false is the exclusive default: the\n   * account presents solely as an organization and `/p/` redirects to `/c/`.\n   */\n  personalProfileVisible?: boolean;\n  /**\n   * Invariant (not encoded in the type, matching the flat wire shape the api\n   * sends): present whenever `recognized` is true, absent when false. Callers\n   * that read it after narrowing on `recognized === true` should still\n   * defensively check, since the type does not enforce the pairing.\n   */\n  recognizedEntity?: RecognizedEntity;\n}\n\n/**\n * The account owner's answer to \"are you a person, a company, or both?\".\n *\n * `'person'` and `'company'` are Sifa-local overrides stored in\n * `account_render_overrides` (set via `POST /api/account/render-preference`).\n * `'both'` is NOT stored here -- it is the portable\n * `id.sifa.org.profile.personalProfileVisible` declaration in the account's own\n * PDS, so any AppView can evaluate it without asking Sifa. Resolve the combined\n * answer with `resolveAccountFacetMode`.\n */\nexport type AccountFacetMode = 'person' | 'company' | 'both';\n\nexport interface Profile {\n  did: string;\n  handle: string;\n  /**\n   * Sifa-local render override, absent when the account has never set one\n   * (auto: today's recognition behaviour). `'person'` is the escape hatch for a\n   * personal domain that Sifa catalogued as a company.\n   */\n  renderPreference?: 'person' | 'company' | null;\n  /**\n   * Org rendering-floor verdict (#160). Present on the profile resolve; absent\n   * on payloads that predate the field. When `org.isOrg` is true the account\n   * renders as an organization (`/c/`).\n   */\n  org?: OrgFloorVerdict;\n  displayName?: string;\n  /**\n   * Given (first) name from `id.sifa.profile.self.givenName`. Schema.org\n   * `Person.givenName`. Optional; absent for users who haven't filled in\n   * structured name fields. Consumers wanting a rendered name should use\n   * `formatStructuredName(givenName, familyName) ?? displayName ?? handle`.\n   */\n  givenName?: string;\n  /**\n   * Family (last) name from `id.sifa.profile.self.familyName`. Schema.org\n   * `Person.familyName`. See `givenName` for fallback guidance.\n   */\n  familyName?: string;\n  /**\n   * Free-form phonetic respelling of the user's name from\n   * `id.sifa.profile.self.namePronunciation` (e.g. `Foo-kuh`). Optional; a\n   * native field with no `app.bsky.actor.profile` equivalent. Text only.\n   */\n  namePronunciation?: string;\n  /**\n   * Resolved URL of the name-pronunciation audio clip from\n   * `id.sifa.profile.self.namePronunciationAudio`, served from the user's PDS\n   * (`com.atproto.sync.getBlob`). Optional; absent when no clip is set.\n   */\n  namePronunciationAudioUrl?: string;\n  avatar?: string;\n  pronouns?: string;\n  headline?: string;\n  about?: string;\n  hasHeadlineOverride?: boolean;\n  hasAboutOverride?: boolean;\n  hasDisplayNameOverride?: boolean;\n  hasAvatarUrlOverride?: boolean;\n  source?: ProfileOverrideSource;\n  industries?: ProfileIndustry[];\n  location?: LocationValue | null;\n  locations?: ProfileLocation[];\n  /**\n   * @deprecated Flat location field emitted at the response root during the\n   * additive response window for `community.lexicon.location.address`.\n   * Prefer the structured `locations[]` array (use the entry where\n   * `isPrimary` is true).\n   */\n  locationCountry?: string | null;\n  /**\n   * @deprecated See `locationCountry`. Prefer `locations[].locationRegion`.\n   */\n  locationRegion?: string | null;\n  /**\n   * @deprecated Legacy alias for `locationLocality`; emitted alongside it\n   * during the additive response window. Prefer `locations[].locationLocality`.\n   */\n  locationCity?: string | null;\n  /**\n   * @deprecated community.lexicon.location.address field name. Prefer\n   * `locations[].locationLocality`.\n   */\n  locationLocality?: string | null;\n  /**\n   * @deprecated See `locationCountry`. Prefer `locations[].countryCode`.\n   */\n  countryCode?: string | null;\n  website?: string;\n  openTo?: string[];\n  preferredWorkplace?: string[];\n  availableFromUtc?: number;\n  availableToUtc?: number;\n  pdsProvider?: PdsProviderInfo | null;\n  claimed: boolean;\n  /**\n   * User-set opt-out flag from `id.sifa.profile.self.discoverable`. When\n   * `false`, the rendering app emits `noindex` and excludes the page from\n   * sitemaps. Absent means default-true (current behavior for existing\n   * records that predate this field).\n   */\n  discoverable?: boolean;\n  isOwnProfile?: boolean;\n  createdAt?: string;\n  trustStats?: TrustStat[];\n  verifiedAccounts?: VerifiedAccount[];\n  activeApps?: ActiveApp[];\n  blueskyVerified?: boolean;\n  blueskyVerifiedAt?: string | null;\n  followersCount: number;\n  followingCount: number;\n  connectionsCount: number;\n  atprotoFollowersCount?: number;\n  positions: ProfilePosition[];\n  education: ProfileEducation[];\n  skills: ProfileSkill[];\n  certifications?: ProfileCertification[];\n  projects?: ProfileProject[];\n  publications?: ProfilePublication[];\n  /**\n   * Co-authors on imported publications that resolve to a Sifa account.\n   *\n   * Owner-only, and absent rather than empty for every other viewer, so a\n   * consumer cannot tell \"no suggestions\" from \"not yours\". Join to a\n   * publication contributor by `orcidId`.\n   */\n  authorSuggestions?: AuthorSuggestion[];\n  volunteering?: ProfileVolunteering[];\n  involvement?: ProfileInvolvement[];\n  investments?: ProfileInvestment[];\n  honors?: ProfileHonor[];\n  languages?: ProfileLanguage[];\n  courses?: ProfileCourse[];\n  presentations?: ProfilePresentation[];\n  presentationDeliveries?: ProfilePresentationDelivery[];\n  externalAccounts?: ExternalAccount[];\n}\n"],"mappings":";AAymBO,IAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AACF;","names":[]}

package/dist/types/profile-view.js

@@ -0,0 +1 @@
+//# sourceMappingURL=profile-view.js.map

package/dist/types/profile-view.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{use-org-notification-emails-0hjt-dEw.d.ts → use-org-notification-emails-CWWi1D8t.d.ts}

@@ -4,9 +4,9 @@ import { K as SifaApiConfig, n as ProfileView, W as WriteResult, N as CreateResu
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseMutationOptions, UseInfiniteQueryOptions, InfiniteData } from '@tanstack/react-query';
 import { c as Profile, d as ProfilePosition, S as SkillRef, p as ExternalAccount, T as SkillSuggestion, s as OrgFloorVerdict } from './index-D9GC0u__.js';
-import { s as sifaQueryKeys, aB as RefreshPdsResult, aS as UpdateProfileOverrideInput, aT as UpdateProfileSelfInput, aU as UploadAvatarResult, aV as UploadPronunciationAudioResult, al as PrimarySection, aM as SubCategoryBulkResult, aq as ProfileLocationInput, o as ExternalAccountInput, m as CreateExternalAccountResult, aW as VerifyExternalAccountResult, E as EndorsementInput, k as ConfirmationInput, l as ConfirmationSubjectInput, X as GivenConfirmation, ak as PendingConfirmationsPage, a6 as InboxCounts, n as DismissUnlinkedPositionInput, aR as UnlinkedPositionsResult, am as ProfileCompleteness, aA as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, a5 as HideProfileItemInput, a0 as HiddenActivityItem, a4 as HideActivityItemInput, aP as UnhideActivityItemInput, aL as StatsResponse, h as AppRegistryEntry, a1 as HiddenApp, b as AccountSummary, p as FeaturedProfile, aK as SimilarProfile, L as FetchSuggestionsOptions, aO as SuggestionsResponse, Q as FollowUserResult, v as FetchFollowListOptions, N as FollowListPage, U as FollowingResponse, x as FetchFollowingFeedOptions, T as FollowingFeedResponse, w as FetchFollowProfilePageOptions, P as FollowProfilePageResponse, F as FeatureAllowlistResponse, g as AdminReviewQueues, r as FetchActivityFeedOptions, c as ActivityFeedResponse, f as ActivityTeaserResponse, $ as HeatmapResponse, a8 as MyGithubPullRequestsResponse, A as AccountCheckResult, az as ReactionStatus, ay as ReactionResult, ax as ReactionError, aI as RoadmapVotesResponse, i as CastRoadmapVoteResult, D as DeleteAccountResult, aD as ResetProfileResult, aX as WipePreview, aC as RepoDeleteInput, aa as OrgClaimResult, ag as OrgProfileUpdateResult, ab as OrgDomainChallengeResult, ac as OrgDomainVerifyResult, ad as OrgNotificationEmailAddResult, ae as OrgNotificationEmailRemoveResult } from './org-BCrvebcf.js';
+import { s as sifaQueryKeys, aB as RefreshPdsResult, aS as UpdateProfileOverrideInput, aT as UpdateProfileSelfInput, aU as UploadAvatarResult, aV as UploadPronunciationAudioResult, al as PrimarySection, aM as SubCategoryBulkResult, aq as ProfileLocationInput, o as ExternalAccountInput, m as CreateExternalAccountResult, aW as VerifyExternalAccountResult, E as EndorsementInput, k as ConfirmationInput, l as ConfirmationSubjectInput, X as GivenConfirmation, ak as PendingConfirmationsPage, a6 as InboxCounts, n as DismissUnlinkedPositionInput, aR as UnlinkedPositionsResult, am as ProfileCompleteness, aA as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, a5 as HideProfileItemInput, a0 as HiddenActivityItem, a4 as HideActivityItemInput, aP as UnhideActivityItemInput, aL as StatsResponse, h as AppRegistryEntry, a1 as HiddenApp, b as AccountSummary, p as FeaturedProfile, aK as SimilarProfile, L as FetchSuggestionsOptions, aO as SuggestionsResponse, Q as FollowUserResult, v as FetchFollowListOptions, N as FollowListPage, U as FollowingResponse, x as FetchFollowingFeedOptions, T as FollowingFeedResponse, w as FetchFollowProfilePageOptions, P as FollowProfilePageResponse, F as FeatureAllowlistResponse, g as AdminReviewQueues, r as FetchActivityFeedOptions, c as ActivityFeedResponse, f as ActivityTeaserResponse, $ as HeatmapResponse, a8 as MyGithubPullRequestsResponse, A as AccountCheckResult, az as ReactionStatus, ay as ReactionResult, ax as ReactionError, aI as RoadmapVotesResponse, i as CastRoadmapVoteResult, D as DeleteAccountResult, aD as ResetProfileResult, aX as WipePreview, aC as RepoDeleteInput, aa as OrgClaimResult, ag as OrgProfileUpdateResult, ab as OrgDomainChallengeResult, ac as OrgDomainVerifyResult, ad as OrgNotificationEmailAddResult, ae as OrgNotificationEmailRemoveResult } from './org-CxTEjjrm.js';
 import { i as EntitySearchResponse, E as EntitySearchResult, c as EntityMintDomainResponse, g as EntityResolveDomainResponse, n as EntitySelectResponse, l as EntitySelectRequest, r as FeatureFlag } from './follow-profile-D1l6pulB.js';
-import { O as OrgClaimRequestInput, a as OrgProfileUpdateRequestInput, b as OrgDomainChallengeRequestInput, c as OrgDomainVerifyRequestInput, d as OrgNotificationEmailRequestInput } from './org-settings-C73Sin5E.js';
+import { O as OrgClaimRequestInput, h as OrgProfileUpdateRequestInput, b as OrgDomainChallengeRequestInput, d as OrgDomainVerifyRequestInput, f as OrgNotificationEmailRequestInput } from './org-settings-BShvhyFp.js';
 
 interface SifaProviderProps {
     config: SifaApiConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@singi-labs/sifa-sdk",
-  "version": "0.19.44",
+  "version": "0.19.45",
   "description": "Sifa SDK — public client library for the Sifa AppView on AT Protocol. Shared by sifa-web and sifa-app.",
   "license": "MIT",
   "type": "module",
@@ -192,7 +192,7 @@
     "./dist/badge/index.cjs"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsup",
     "dev": "tsup --watch",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
@@ -207,7 +207,8 @@
     "version-packages": "changeset version",
     "release": "pnpm run build && changeset publish",
     "build:flags": "node scripts/build-flags.mjs",
-    "sync:term-mappings": "node scripts/sync-term-mappings.mjs"
+    "sync:term-mappings": "node scripts/sync-term-mappings.mjs",
+    "check:dist": "node scripts/check-dist.mjs"
   },
   "engines": {
     "node": ">=22"