@singi-labs/sifa-sdk 0.12.56 → 0.12.58

package/dist/{types-Vf-kTiu1.d.ts → index-DMyroYoB.d.ts}

@@ -728,512 +728,4 @@ interface Profile {
     externalAccounts?: ExternalAccount[];
 }
 
-/**
- * Types for the `id.sifa.getProfileView` XRPC query: the aggregated public
- * professional profile view served by a Sifa AppView. This is a curated public
- * projection, viewer-specific and internal fields are not included and hidden
- * items are omitted. Mirrors the `id.sifa.getProfileView` lexicon in
- * @singi-labs/sifa-lexicons.
- */
-
-interface IndustryDomain {
-    industry: string;
-    domain?: string;
-}
-interface ProfileLocationView {
-    rkey: string;
-    type?: string;
-    label?: string;
-    isPrimary?: boolean;
-    locationCountry?: string;
-    locationRegion?: string;
-    locationLocality?: string;
-    countryCode?: string;
-    location?: string;
-}
-interface PositionView {
-    rkey: string;
-    title: string;
-    company?: string;
-    companyDid?: string;
-    entityRef?: string;
-    entityName?: string;
-    description?: string;
-    employmentType?: string;
-    workplaceType?: string;
-    locationCountry?: string;
-    locationRegion?: string;
-    locationLocality?: string;
-    countryCode?: string;
-    location?: string;
-    startedAt?: string;
-    endedAt?: string;
-    primary?: boolean;
-    skillRkeys?: string[];
-}
-interface EducationView {
-    rkey: string;
-    institution?: string;
-    institutionDid?: string;
-    entityRef?: string;
-    degree?: string;
-    fieldOfStudy?: string;
-    activities?: string;
-    description?: string;
-    startedAt?: string;
-    endedAt?: string;
-}
-interface SkillView {
-    rkey: string;
-    name: string;
-    category?: string;
-    /** Freeform user-defined grouping label nested under `category` (#305). */
-    subCategory?: string;
-    positionRkeys?: string[];
-}
-interface CertificationView {
-    rkey: string;
-    name: string;
-    issuingOrg?: string;
-    entityRef?: string;
-    issueDate?: string;
-    expiryDate?: string;
-    credentialUrl?: string;
-}
-interface ProjectView {
-    rkey: string;
-    name: string;
-    description?: string;
-    url?: string;
-    startDate?: string;
-    endDate?: string;
-    members?: ProjectMemberView[];
-    /** AT-URI of the same project as recorded elsewhere, when this entry duplicates another. */
-    /** AT-URI of the same record on another person's profile, when they keep one. */
-    sameAs?: string;
-}
-/** A person named as a member of a project. Identity fields appear only once confirmed. */
-interface ProjectMemberView {
-    did: string;
-    handle: string;
-    displayName?: string;
-    avatar?: string;
-    confirmed?: boolean;
-    confirmedStale?: boolean;
-    role?: string;
-    title?: string;
-}
-interface VolunteeringView {
-    rkey: string;
-    organization: string;
-    entityRef?: string;
-    role?: string;
-    cause?: string;
-    description?: string;
-    startDate?: string;
-    endDate?: string;
-}
-interface InvolvementLinkView {
-    url: string;
-    kind?: string;
-    label?: string;
-    verified?: boolean;
-    verifiedPlatform?: string;
-}
-interface InvolvementView {
-    rkey: string;
-    kind?: string;
-    upstream?: string;
-    upstreamDid?: string;
-    upstreamUrl?: string;
-    role?: string;
-    description?: string;
-    startedAt?: string;
-    endedAt?: string;
-    links: InvolvementLinkView[];
-    legacy: boolean;
-    /** Other people named on this involvement, hydrated from the stored DIDs. */
-    collaborators?: ProjectMemberView[];
-    /** AT-URI of the same involvement as recorded on another person's profile. */
-    sameAs?: string;
-}
-interface ContributorView {
-    name: string;
-    orcidId?: string;
-    did?: string;
-    handle?: string;
-}
-interface PublicationView {
-    rkey: string;
-    title: string;
-    subtitle?: string;
-    publisher?: string;
-    date?: string;
-    url?: string;
-    description?: string;
-    doi?: string;
-    type?: string;
-    typeLabel?: string;
-    contributors?: ContributorView[];
-    verified: boolean;
-    verifiedVia?: string;
-    orcidCorroborated?: boolean;
-    publicationUri?: string;
-    publicationUrl?: string;
-    publicationName?: string;
-    image?: string;
-}
-interface CourseView {
-    rkey: string;
-    name: string;
-    number?: string;
-    institution?: string;
-    entityRef?: string;
-    credentialRkey?: string;
-}
-interface DurationView {
-    minMinutes: number;
-    maxMinutes?: number;
-}
-/**
- * A co-speaker on a presentation delivery.
- *
- * `displayName` and `avatar` are served only once `confirmed` is true. The
- * lexicon also declares an unlinked free-text `name`, which the AppView has
- * never emitted -- the record field is `format: did`, so there is nothing to
- * emit it from.
- */
-interface CoSpeakerView {
-    did?: string;
-    handle?: string;
-    displayName?: string;
-    avatar?: string;
-    hasSifaProfile?: boolean;
-    confirmed?: boolean;
-    confirmedStale?: boolean;
-    name?: string;
-}
-interface PresentationDeliveryView {
-    rkey: string;
-    presentationRkey?: string;
-    title?: string;
-    role?: string;
-    eventName?: string;
-    date?: string;
-    location?: string;
-    locationCountry?: string;
-    locationRegion?: string;
-    locationLocality?: string;
-    countryCode?: string;
-    mode?: string;
-    status?: string;
-    links?: PresentationLinkView[];
-    eventUri?: string;
-    coSpeakers?: CoSpeakerView[];
-    /** AT-URI of the same session as recorded on another person's profile. */
-    sameAs?: string;
-}
-interface PresentationView {
-    rkey: string;
-    title: string;
-    description?: string;
-    duration?: DurationView;
-    intendedAudiences?: string[];
-    links?: PresentationLinkView[];
-    writeupUri?: string;
-    coverImageUrl?: string;
-    deliveries: PresentationDeliveryView[];
-}
-interface HonorView {
-    rkey: string;
-    title: string;
-    issuer?: string;
-    entityRef?: string;
-    description?: string;
-    date?: string;
-}
-interface LanguageView {
-    rkey: string;
-    language: string;
-    proficiency?: string;
-}
-interface ExternalAccountView {
-    rkey: string;
-    platform?: string;
-    url: string;
-    label?: string;
-    feedUrl?: string;
-    verifiable?: boolean;
-    verified?: boolean;
-    verifiedVia?: string;
-    primary?: boolean;
-}
-interface ActiveAppView {
-    id: string;
-    name: string;
-    category?: string;
-    recentCount?: number;
-    latestRecordAt?: string;
-}
-interface AtfundLinkView {
-    url: string;
-    label?: string;
-}
-/** Aggregated public professional profile view (`id.sifa.getProfileView#profileView`). */
-interface ProfileView {
-    did: string;
-    handle: string;
-    displayName?: string;
-    givenName?: string;
-    familyName?: string;
-    avatar?: string;
-    pronouns?: string;
-    headline?: string;
-    about?: string;
-    industries?: IndustryDomain[];
-    locationCountry?: string;
-    locationRegion?: string;
-    locationLocality?: string;
-    countryCode?: string;
-    location?: string;
-    locations?: ProfileLocationView[];
-    website?: string;
-    openTo?: string[];
-    preferredWorkplace?: string[];
-    availableFromUtc?: number;
-    availableToUtc?: number;
-    langs?: string[];
-    createdAt?: string;
-    positions?: PositionView[];
-    education?: EducationView[];
-    skills?: SkillView[];
-    certifications?: CertificationView[];
-    projects?: ProjectView[];
-    volunteering?: VolunteeringView[];
-    involvement?: InvolvementView[];
-    publications?: PublicationView[];
-    courses?: CourseView[];
-    presentations?: PresentationView[];
-    presentationDeliveries?: PresentationDeliveryView[];
-    honors?: HonorView[];
-    languages?: LanguageView[];
-    externalAccounts?: ExternalAccountView[];
-    atfundContribute?: AtfundLinkView;
-    followersCount?: number;
-    followingCount?: number;
-    connectionsCount?: number;
-    metInPersonCount?: number;
-    atprotoFollowersCount?: number;
-    blueskyVerified?: boolean;
-    blueskyVerifiedAt?: string;
-    activeApps?: ActiveAppView[];
-    pdsProvider?: PdsProviderInfo;
-    claimed?: boolean;
-}
-
-/**
- * Adult-content gating for Bluesky activity items.
- *
- * Bluesky's official moderation labeler attaches content labels to
- * `app.bsky.feed.defs#postView.labels`. The four sex-and-violence labels
- * below are the ones we hide by default on Sifa: media is replaced with an
- * `<AdultContentWarning>` placeholder card in sifa-web. Authenticated
- * viewers can reveal per-card; anonymous viewers cannot.
- *
- * The list mirrors Bluesky's own globalLabelStrings; if the official set
- * grows (e.g. a new `extreme-violence` label), update this constant.
- *
- * Why a constant + predicate live in the SDK: the same logic needs to run
- * in sifa-web today and sifa-app tomorrow, and the API only forwards the
- * raw labels — the hide decision is a client concern.
- */
-declare const ADULT_CONTENT_LABELS: readonly ["porn", "sexual", "nudity", "graphic-media"];
-type AdultContentLabel = (typeof ADULT_CONTENT_LABELS)[number];
-/**
- * A single label entry as emitted by `app.bsky.feed.defs#postView.labels`.
- * Matches `com.atproto.label.defs#label` (the on-wire shape after the AppView
- * resolves a `postView`). `neg: true` marks a retraction.
- */
-interface ActivityLabel {
-    val: string;
-    src: string;
-    uri: string;
-    cts?: string;
-    neg?: boolean;
-}
-/**
- * Return true if the item carries at least one adult-content label that is
- * not negated. Items without a `labels` field (every non-Bluesky source,
- * legacy responses) are treated as safe.
- */
-declare function hasAdultContent(item: {
-    labels?: ActivityLabel[];
-}): boolean;
-
-/**
- * The buckets a repo data-management UI shows instead of raw collections.
- *
- * "id.sifa.profile.presentationDelivery" means nothing to someone who has never
- * heard of a lexicon. Grouping is the whole difference between a developer tool
- * and something a user can act on, so it lives here rather than in one app: the
- * web settings page and a future native app must agree on what a bucket holds,
- * or the same repo reads differently depending where you look at it.
- *
- * Ids only, no display strings -- copy is translated at the surface.
- */
-type RepoGroupId = 'profile-basics' | 'work-history' | 'education' | 'skills-endorsements' | 'projects' | 'publications-talks' | 'people' | 'meetings' | 'other';
-interface RepoGroupDefinition {
-    id: RepoGroupId;
-    /** Collections this bucket claims, in the order a UI should list them. */
-    collections: readonly string[];
-}
-/**
- * Ordered so the buckets a user recognises come first and the machinery they
- * never think about (consents, access grants) comes last.
- *
- * `other` is deliberately absent: it is not a claim over a fixed set, it is
- * where anything unmapped lands. See {@link repoGroupForCollection}.
- */
-declare const SIFA_REPO_GROUPS: readonly RepoGroupDefinition[];
-/**
- * Which bucket a collection belongs to, or `other` when we have not mapped it.
- *
- * Unmapped falls through to a visible bucket rather than being filtered out. A
- * lexicon we mint later would otherwise be invisible on the one page whose job
- * is to show everything in the repo -- the user would be told their data is
- * accounted for while some of it was silently omitted.
- */
-declare function repoGroupForCollection(collection: string): RepoGroupId;
-
-/**
- * One line of text identifying a record to the person who wrote it.
- *
- * Split into parts rather than one joined string: joining needs a connective
- * ("Senior Engineer at Acme") and a connective is copy, which is translated at
- * the surface. Every value here comes straight from the user's own record, so
- * the SDK contributes no language of its own.
- */
-interface RepoRecordLabel {
-    /** The record's own identifying text, or the collection leaf when it has none. */
-    primary: string;
-    /** Employer, institution, event, or publisher, when the record names one. */
-    secondary?: string;
-    /** The date the record is about, not when it was written. May be partial ("2021-03"). */
-    date?: string;
-    /**
-     * The person a record is about, for records whose meaning is a relationship
-     * rather than text: endorsements, follows, confirmations, attestations.
-     *
-     * Kept out of {@link primary} so a surface can resolve it to a handle and
-     * avatar without parsing a DID back out of display text.
-     */
-    subjectDid?: string;
-    /**
-     * Handle and display name for {@link subjectDid}, when a surface resolved it.
-     *
-     * Records whose whole meaning is a relationship -- follows, meetings,
-     * endorsements -- carry only a DID. A page listing 33 of them shows 33
-     * identical rows and a column of did:plc: strings, which is unusable for
-     * deciding which one to remove. Resolution has to be batched by the caller,
-     * so the SDK leaves room for the answer rather than fetching it.
-     */
-    subjectHandle?: string;
-    subjectName?: string;
-    /**
-     * Set when the record carried no readable text and {@link primary} is the
-     * collection leaf rather than the user's own data.
-     *
-     * A surface must substitute its own wording for these -- a row reading
-     * "follow" or "location" tells the reader nothing about which record they
-     * are about to delete. The flag exists because the leaf is indistinguishable
-     * from real content once it is a string: a headline that genuinely says
-     * "location" must not be relabelled.
-     */
-    isFallback?: true;
-}
-/**
- * Describe one record from the user's repo in terms they will recognise.
- *
- * Never throws and never returns an empty primary. This runs over whatever is
- * actually in the repo, including records written by older versions of Sifa and
- * records hand-edited elsewhere. A page that crashes on one malformed record
- * would hide the rest, which is exactly the data the user came to manage.
- */
-declare function describeSifaRecord(collection: string, value: unknown): RepoRecordLabel;
-
-/** One record in the user's repo, reduced to what a management UI needs. */
-interface RepoRecordSummary {
-    /** Full AT-URI, the stable identity of the record. */
-    uri: string;
-    /** Record key, the part a delete request names. */
-    rkey: string;
-    collection: string;
-    label: RepoRecordLabel;
-    /** When the record was written, from its own `createdAt`. Absent if it has none. */
-    createdAt?: string;
-}
-/** One bucket of the inventory. Buckets the user has no records in are omitted. */
-interface RepoCollectionGroup {
-    id: RepoGroupId;
-    /** Collections in this bucket the user actually has records in. */
-    collections: string[];
-    recordCount: number;
-    records: RepoRecordSummary[];
-}
-/**
- * What is in the user's repo under id.sifa.*, as their PDS reports it.
- *
- * Read from the PDS rather than the AppView. This is the one surface whose
- * entire purpose is to say what the user owns, so an index that has drifted --
- * lagging the firehose, or holding records deleted elsewhere -- would be
- * lying about the thing the page exists to answer.
- */
-interface RepoInventory {
-    did: string;
-    /** When the PDS was read, so a UI can say how fresh this is. */
-    fetchedAt: string;
-    groups: RepoCollectionGroup[];
-    totalRecords: number;
-    /**
-     * Collections found in the repo that could not be listed. Their records are
-     * missing from `groups`, so a UI must not present the inventory as complete.
-     */
-    unreadableCollections?: string[];
-}
-/** What happened to one record in a delete request. */
-type RepoDeleteOutcome = 
-/** The PDS confirmed the record is gone. */
-'deleted'
-/** The delete was attempted and the record is still there. */
- | 'remaining'
-/** We could not establish either way. Not the same as `remaining`, and never success. */
- | 'unknown';
-interface RepoDeleteRecordResult {
-    rkey: string;
-    outcome: RepoDeleteOutcome;
-}
-/**
- * Result of a delete request.
- *
- * Carries no success flag of its own. The transport adds one meaning "the
- * request was accepted", which is not the same question: a request can be
- * accepted and still leave four of five records in place. What actually
- * happened to the data is in `results`, per record, and callers report that.
- */
-interface RepoDeleteResult {
-    collection: string;
-    results: RepoDeleteRecordResult[];
-    /**
-     * Set when the current OAuth grant cannot delete this collection, in which
-     * case nothing was attempted. `scope` is the value to request.
-     *
-     * Present instead of a failure so a UI sends the user to consent rather than
-     * telling them the delete failed for no stated reason.
-     */
-    needsScopeUpgrade?: {
-        scope: string;
-        collections: string[];
-    };
-}
-
-export { type ProfileCourse as $, type AdultContentLabel as A, type EndorsementData as B, type CoSpeaker as C, type DurationView as D, type ExternalAccount as E, type ExternalAccountKeytraceClaim as F, type ExternalAccountView as G, type FeedItem as H, type HonorView as I, type IndustryDomain as J, type InvolvementLinkView as K, type LocationValue as L, type InvolvementView as M, type LanguageProficiency as N, type LanguageView as O, type ProfileView as P, type OrgAddressView as Q, type RepoDeleteResult as R, type SkillSuggestion as S, type OrgFloorVerdict as T, type OrgLinkView as U, type OrgProfileView as V, PROJECT_ROLES as W, type PositionView as X, type PresentationDeliveryView as Y, type PresentationLinkView as Z, type PresentationView as _, type ActivityLabel as a, type ProfileIndustry as a0, type ProfileInvolvementLink as a1, type ProfileLocation as a2, type ProfileLocationView as a3, type ProfileOverrideSource as a4, type ProfilePresentation as a5, type ProfileVolunteering as a6, type ProjectMemberCard as a7, type ProjectMemberView as a8, type ProjectRole as a9, type ProjectView as aa, type PublicationContributor as ab, type PublicationView as ac, type RecognizedEntity as ad, type RepoCollectionGroup as ae, type RepoDeleteOutcome as af, type RepoDeleteRecordResult as ag, type RepoGroupDefinition as ah, type RepoGroupId as ai, type RepoRecordLabel as aj, type RepoRecordSummary as ak, SIFA_REPO_GROUPS as al, type SkillRef as am, type SkillView as an, type TrustStat as ao, type VerifiedAccount as ap, type VolunteeringView as aq, describeSifaRecord as ar, hasAdultContent as as, repoGroupForCollection as at, type RepoInventory as b, type ProfileSkill as c, type ProfilePresentationDelivery as d, type PdsProviderInfo as e, type Profile as f, type AccountFacetMode as g, type ProfilePosition as h, type ProfileCertification as i, type ProfileEducation as j, type ProfileHonor as k, type ProfileLanguage as l, type ProfileProject as m, type ProfilePublication as n, type ProfileInvolvement as o, ADULT_CONTENT_LABELS as p, type ActiveApp as q, type ActiveAppView as r, type ActorCard as s, type AtfundLinkView as t, type CertificationView as u, type CoSpeakerView as v, type ContributorView as w, type CourseView as x, type EducationView as y, type Endorsement as z };
+export { type AccountFacetMode as A, type ProfileOverrideSource as B, type CoSpeaker as C, type ProfilePresentation as D, type ExternalAccount as E, type FeedItem as F, type ProfileVolunteering as G, type ProjectMemberCard as H, type ProjectRole as I, type PublicationContributor as J, type SkillRef as K, type LocationValue as L, type OrgAddressView as O, type PresentationLinkView as P, type RecognizedEntity as R, type SkillSuggestion as S, type TrustStat as T, type VerifiedAccount as V, type PdsProviderInfo as a, type ProfileSkill as b, type ProfilePresentationDelivery as c, type Profile as d, type ProfilePosition as e, type ProfileCertification as f, type ProfileEducation as g, type ProfileHonor as h, type ProfileLanguage as i, type ProfileProject as j, type ProfilePublication as k, type ProfileInvolvement as l, type ActiveApp as m, type ActorCard as n, type Endorsement as o, type EndorsementData as p, type ExternalAccountKeytraceClaim as q, type LanguageProficiency as r, type OrgFloorVerdict as s, type OrgLinkView as t, type OrgProfileView as u, PROJECT_ROLES as v, type ProfileCourse as w, type ProfileIndustry as x, type ProfileInvolvementLink as y, type ProfileLocation as z };

package/dist/{index-DZGw-VDY.d.cts → index-Dqe0Nlck.d.cts}

@@ -1,7 +1,8 @@
-import { S as SifaApiConfig, A as ApiFetchOptions, C as CreateResult, W as WriteResult } from './org-CHVTcTcj.cjs';
-import { f as Profile, P as ProfileView, h as ProfilePosition, am as SkillRef } from './types-Vf-kTiu1.cjs';
+import { S as SifaApiConfig, A as ApiFetchOptions, C as CreateResult, W as WriteResult } from './org-GI1GVjZw.cjs';
+import { d as Profile, e as ProfilePosition, K as SkillRef } from './index-DMyroYoB.cjs';
+import { P as ProfileView } from './types-BiBx2Utr.cjs';
 import { i as EntitySearchResponse, k as EntitySearchResult, c as EntityMintDomainResponse, g as EntityResolveDomainResponse, m as EntitySelectRequest, o as EntitySelectResponse } from './feed-dOSy_48Z.cjs';
-import { S as SummarizeProfileViewOptions, P as ProfileSummary } from './profile-summary-CdLI8k7M.cjs';
+import { S as SummarizeProfileViewOptions, P as ProfileSummary } from './profile-summary-Bqj3TDVd.cjs';
 
 /**
  * Read the aggregated profile for a handle or DID.

package/dist/{index-GmKuSxp6.d.ts → index-czrerd84.d.ts}

@@ -1,7 +1,8 @@
-import { S as SifaApiConfig, A as ApiFetchOptions, C as CreateResult, W as WriteResult } from './org-fq2Xwg6Q.js';
-import { f as Profile, P as ProfileView, h as ProfilePosition, am as SkillRef } from './types-Vf-kTiu1.js';
+import { S as SifaApiConfig, A as ApiFetchOptions, C as CreateResult, W as WriteResult } from './org-66bQLHJd.js';
+import { d as Profile, e as ProfilePosition, K as SkillRef } from './index-DMyroYoB.js';
+import { P as ProfileView } from './types-BkRDvKTp.js';
 import { i as EntitySearchResponse, k as EntitySearchResult, c as EntityMintDomainResponse, g as EntityResolveDomainResponse, m as EntitySelectRequest, o as EntitySelectResponse } from './feed-dOSy_48Z.js';
-import { S as SummarizeProfileViewOptions, P as ProfileSummary } from './profile-summary-BS2GPBxw.js';
+import { S as SummarizeProfileViewOptions, P as ProfileSummary } from './profile-summary-YZXjMymn.js';
 
 /**
  * Read the aggregated profile for a handle or DID.

package/dist/index.cjs

@@ -2378,6 +2378,32 @@ function countryCodeToFlag(code) {
   return String.fromCodePoint(a - 65 + 127462, b - 65 + 127462);
 }
 
+// src/format/location-segments.ts
+function clean(value) {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : null;
+}
+function locationSegments(loc, options = {}) {
+  if (!loc) return [];
+  const ordered = [
+    { kind: "locality", value: clean(loc.locality ?? loc.city) },
+    { kind: "region", value: clean(loc.region) },
+    { kind: "country", value: clean(loc.country) }
+  ];
+  const segments = [];
+  for (const { kind, value } of ordered) {
+    if (value === null) continue;
+    const previous = segments[segments.length - 1];
+    if (previous && previous.label.toLowerCase() === value.toLowerCase()) continue;
+    segments.push({
+      kind,
+      label: value,
+      searchHref: kind === "country" && options.searchable !== false ? `/search?${new URLSearchParams({ country: value }).toString()}` : null
+    });
+  }
+  return segments;
+}
+
 // src/format/pds-utils.ts
 var BSKY_PROFILE_BASE = "https://bsky.app/profile/";
 var PDS_PROVIDERS = [
@@ -2659,27 +2685,27 @@ function meetsContrastAA(foreground, background) {
 }
 
 // src/import/presentation-csv.ts
-function clean(value) {
+function clean2(value) {
   return (value ?? "").trim();
 }
 function parsePresentationDuration(input) {
-  const numbers = (clean(input).match(/\d+/g) ?? []).map((n) => Number.parseInt(n, 10)).filter((n) => Number.isInteger(n) && n > 0);
+  const numbers = (clean2(input).match(/\d+/g) ?? []).map((n) => Number.parseInt(n, 10)).filter((n) => Number.isInteger(n) && n > 0);
   const min = numbers.at(0);
   if (min === void 0) return void 0;
   const max = numbers.at(1);
   return max !== void 0 && max >= min ? { minMinutes: min, maxMinutes: max } : { minMinutes: min };
 }
 function durationFromMinutes(minRaw, maxRaw) {
-  const min = Number.parseInt(clean(minRaw), 10);
+  const min = Number.parseInt(clean2(minRaw), 10);
   if (!Number.isInteger(min) || min < 1) return void 0;
-  const max = Number.parseInt(clean(maxRaw), 10);
+  const max = Number.parseInt(clean2(maxRaw), 10);
   return Number.isInteger(max) && max >= min ? { minMinutes: min, maxMinutes: max } : { minMinutes: min };
 }
 function parseIntendedAudiences(input, delimiter = ";") {
-  return clean(input).split(delimiter).map((s) => s.trim()).filter(Boolean);
+  return clean2(input).split(delimiter).map((s) => s.trim()).filter(Boolean);
 }
 function stripHtmlToText(input) {
-  const text = clean(input).replace(/<\s*br\s*\/?>/gi, "\n").replace(/<\/\s*(p|div|li|h[1-6])\s*>/gi, "\n").replace(/<[^>]*>/g, "").replace(/&nbsp;/gi, " ").replace(/&amp;/gi, "&").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, '"').replace(/&#0*39;|&apos;/gi, "'");
+  const text = clean2(input).replace(/<\s*br\s*\/?>/gi, "\n").replace(/<\/\s*(p|div|li|h[1-6])\s*>/gi, "\n").replace(/<[^>]*>/g, "").replace(/&nbsp;/gi, " ").replace(/&amp;/gi, "&").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, '"').replace(/&#0*39;|&apos;/gi, "'");
   return text.replace(/[ \t]+/g, " ").replace(/ *\n */g, "\n").replace(/\n{3,}/g, "\n\n").trim();
 }
 var ROLE_TOKENS = {
@@ -2691,7 +2717,7 @@ var ROLE_TOKENS = {
   host: "id.sifa.defs#host"
 };
 function normalizePresentationRole(value) {
-  const v = clean(value).toLowerCase();
+  const v = clean2(value).toLowerCase();
   if (!v) return void 0;
   if (v.startsWith("id.sifa.defs#")) return v;
   const exact = ROLE_TOKENS[v];
@@ -2716,14 +2742,14 @@ var MODE_FRAGMENTS = {
   hybrid: "#hybrid"
 };
 function normalizePresentationMode(value) {
-  const v = clean(value).toLowerCase();
+  const v = clean2(value).toLowerCase();
   if (!v) return void 0;
   if (v.startsWith("community.lexicon.calendar.event#")) return v;
   const fragment = MODE_FRAGMENTS[v];
   return fragment ? `community.lexicon.calendar.event${fragment}` : void 0;
 }
 function link(uri, type) {
-  const u = clean(uri);
+  const u = clean2(uri);
   return u ? { uri: u, type } : void 0;
 }
 function presentationCsvRowToRecord(row) {
@@ -2735,12 +2761,12 @@ function presentationCsvRowToRecord(row) {
     link(row.recording_url, "id.sifa.defs#linkRecording"),
     link(row.writeup_url, "id.sifa.defs#linkWriteup")
   ].filter((l) => l !== void 0);
-  const record = { title: clean(row.title) };
+  const record = { title: clean2(row.title) };
   if (description) record.description = description;
   if (duration) record.duration = duration;
   if (intendedAudiences.length) record.intendedAudiences = intendedAudiences;
   if (links.length) record.links = links;
-  return { key: clean(row.presentation_key) || void 0, record };
+  return { key: clean2(row.presentation_key) || void 0, record };
 }
 function presentationDeliveryCsvRowToRecord(row) {
   const links = [
@@ -2748,10 +2774,10 @@ function presentationDeliveryCsvRowToRecord(row) {
     link(row.recording_url, "id.sifa.defs#linkRecording")
   ].filter((l) => l !== void 0);
   const record = {};
-  const title = clean(row.title);
-  const eventName = clean(row.event_name);
-  const date = clean(row.date);
-  const location = clean(row.location);
+  const title = clean2(row.title);
+  const eventName = clean2(row.event_name);
+  const date = clean2(row.date);
+  const location = clean2(row.location);
   const role = normalizePresentationRole(row.role);
   const mode = normalizePresentationMode(row.mode);
   if (title) record.title = title;
@@ -2761,7 +2787,7 @@ function presentationDeliveryCsvRowToRecord(row) {
   if (location) record.location = location;
   if (mode) record.mode = mode;
   if (links.length) record.links = links;
-  return { presentationKey: clean(row.presentation_key) || void 0, record };
+  return { presentationKey: clean2(row.presentation_key) || void 0, record };
 }
 
 // src/cards/app-url-patterns.ts
@@ -5598,7 +5624,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.12.56";
+var SIFA_SDK_VERSION = "0.12.58";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VERBS = ACTIVITY_VERBS;
@@ -5783,6 +5809,7 @@ exports.isVisibleActivityItem = isVisibleActivityItem;
 exports.languageTagSchema = languageTagSchema;
 exports.lexiconDateExtractor = lexiconDateExtractor;
 exports.limitCombiningMarks = limitCombiningMarks;
+exports.locationSegments = locationSegments;
 exports.looksLikeDomain = looksLikeDomain;
 exports.makeGraphFollowRecordSchema = makeGraphFollowRecordSchema;
 exports.maxGraphemes = maxGraphemes;