@treeviz/familysearch-sdk 2.0.7 → 2.0.9

package/dist/{index-CcZ9bR5K.d.ts → index-BfeojAOm.d.cts}

@@ -1,4 +1,4 @@
-import { A as AgentAPI, C as ConclusionsAPI, G as GroupsAPI, M as MatchesAPI, a as MergesAPI, N as NotesAPI, P as PedigreesAPI, b as PendingModificationsAPI, c as PersonsAPI, d as PreferencesAPI, R as RelationshipsAPI, S as SearchAPI, e as SourceAttachmentsAPI, f as SourceBoxAPI, g as SourcesAPI, T as TreeChangesAPI, h as TreesManagementAPI, i as addSourcesToCollection, j as allowPersonMerge, k as attachSourceToChildAndParentsRelationship, l as attachSourceToCoupleRelationship, m as attachSourceToPerson, n as canMergePersons, o as createChildAndParentsRelationship, p as createChildAndParentsRelationshipNote, q as createChildAndParentsRelationshipSourceReference, r as createCoupleRelationship, s as createCoupleRelationshipNote, t as createCoupleRelationshipSourceReference, u as createGroup, v as createNotAMatchDeclaration, w as createPerson, x as createPersonMemory, y as createPersonNote, z as createRelationshipGedcomx, B as createSourceDescription, D as createSourceFolder, E as createTree, F as deleteAllNotAMatchDeclarations, H as deleteChildAndParentsRelationship, I as deleteChildAndParentsRelationshipConclusion, J as deleteChildAndParentsRelationshipNote, K as deleteChildAndParentsRelationshipParent, L as deleteChildAndParentsRelationshipSourceReference, O as deleteCoupleRelationship, Q as deleteCoupleRelationshipConclusion, U as deleteCoupleRelationshipNote, V as deleteCoupleRelationshipSourceReference, W as deleteGroup, X as deleteNotAMatchDeclaration, Y as deletePerson, Z as deletePersonConclusion, _ as deletePersonDiscussionReference, $ as deletePersonMemoriesPersonaReference, a0 as deletePersonNotAMatch, a1 as deletePersonNotAMatches, a2 as deletePersonNote, a3 as deletePersonPortrait, a4 as deletePersonSourceReference, a5 as deletePreferredParentRelationship, a6 as deletePreferredSpouseRelationship, a7 as deleteSourceDescription, a8 as deleteTree, a9 as deleteTreePersonReference, aa as deleteUserDefinedCollection, ab as detachSourceFromChildAndParentsRelationship, ac as detachSourceFromCoupleRelationship, ad as detachSourceFromPerson, ae as exportGEDCOM, af as matchPerson, ag as mergePerson, ah as performPersonMatchesByExample, ai as readAgent, aj as readAncestry, ak as readChildAndParentRelationshipNote, al as readChildAndParentsRelationship, am as readChildAndParentsRelationshipChangeHistory, an as readChildAndParentsRelationshipNote, ao as readChildAndParentsRelationshipNotes, ap as readChildAndParentsRelationshipSourceReferences, aq as readChildAndParentsRelationshipSources, ar as readCollectionSourceDescriptions, as as readCoupleRelationship, at as readCoupleRelationshipChangeHistory, au as readCoupleRelationshipNote, av as readCoupleRelationshipNotes, aw as readCoupleRelationshipSourceReferences, ax as readCoupleRelationshipSources, ay as readDescendancy, az as readGroup, aA as readGroups, aB as readNotAMatchDeclarations, aC as readPendingModifications, aD as readPerson, aE as readPersonChangeHistory, aF as readPersonChildren, aG as readPersonDiscussions, aH as readPersonFamilies, aI as readPersonMatches, aJ as readPersonMemories, aK as readPersonMergeAnalysis, aL as readPersonNonMatches, aM as readPersonNotAMatches, aN as readPersonNote, aO as readPersonNotes, aP as readPersonParents, aQ as readPersonPortraits, aR as readPersonSources, aS as readPersonSpouses, aT as readPersonWithDetails, aU as readPreferredParentRelationship, aV as readPreferredSpouseRelationship, aW as readResearchTreePersons, aX as readSourceDescription, aY as readSourceDescriptionChanges, aZ as readSourceDescriptionHead, a_ as readSourceDescriptions, a$ as readSourceFolders, b0 as readTree, b1 as readTreeChanges, b2 as readTreeMatches, b3 as readUserDefinedCollection, b4 as readUserSourceDescriptions, b5 as readUserSourceFolders, b6 as removeSourcesFromCollection, b7 as restoreChange, b8 as restoreChildAndParentsRelationship, b9 as restoreCoupleRelationship, ba as restorePerson, bb as searchPersonByData, bc as searchPersons, bd as setParentOrder, be as setPreferredParentRelationship, bf as setPreferredSpouseRelationship, bg as setSpouseOrder, bh as updateChildAndParentsRelationship, bi as updateChildAndParentsRelationshipNote, bj as updateCoupleRelationship, bk as updateCoupleRelationshipNote, bl as updateGroup, bm as updateMatchResolution, bn as updatePerson, bo as updatePersonNotAMatches, bp as updatePersonNote, bq as updatePersonPortraits, br as updateSourceDescription, bs as updateUserDefinedCollection } from './index-CKi9wd-C.js';
+import { A as AgentAPI, C as ConclusionsAPI, G as GroupsAPI, M as MatchesAPI, a as MergesAPI, N as NotesAPI, P as PedigreesAPI, b as PendingModificationsAPI, c as PersonsAPI, d as PreferencesAPI, R as RelationshipsAPI, S as SearchAPI, e as SourceAttachmentsAPI, f as SourceBoxAPI, g as SourcesAPI, T as TreeChangesAPI, h as TreesManagementAPI, i as addSourcesToCollection, j as allowPersonMerge, k as attachSourceToChildAndParentsRelationship, l as attachSourceToCoupleRelationship, m as attachSourceToPerson, n as canMergePersons, o as createChildAndParentsRelationship, p as createChildAndParentsRelationshipNote, q as createChildAndParentsRelationshipSourceReference, r as createCoupleRelationship, s as createCoupleRelationshipNote, t as createCoupleRelationshipSourceReference, u as createGroup, v as createNotAMatchDeclaration, w as createPerson, x as createPersonMemory, y as createPersonNote, z as createRelationshipGedcomx, B as createSourceDescription, D as createSourceFolder, E as createTree, F as deleteAllNotAMatchDeclarations, H as deleteChildAndParentsRelationship, I as deleteChildAndParentsRelationshipConclusion, J as deleteChildAndParentsRelationshipNote, K as deleteChildAndParentsRelationshipParent, L as deleteChildAndParentsRelationshipSourceReference, O as deleteCoupleRelationship, Q as deleteCoupleRelationshipConclusion, U as deleteCoupleRelationshipNote, V as deleteCoupleRelationshipSourceReference, W as deleteGroup, X as deleteNotAMatchDeclaration, Y as deletePerson, Z as deletePersonConclusion, _ as deletePersonDiscussionReference, $ as deletePersonMemoriesPersonaReference, a0 as deletePersonNotAMatch, a1 as deletePersonNotAMatches, a2 as deletePersonNote, a3 as deletePersonPortrait, a4 as deletePersonSourceReference, a5 as deletePreferredParentRelationship, a6 as deletePreferredSpouseRelationship, a7 as deleteSourceDescription, a8 as deleteTree, a9 as deleteTreePersonReference, aa as deleteUserDefinedCollection, ab as detachSourceFromChildAndParentsRelationship, ac as detachSourceFromCoupleRelationship, ad as detachSourceFromPerson, ae as exportGEDCOM, af as matchPerson, ag as mergePerson, ah as performPersonMatchesByExample, ai as readAgent, aj as readAncestry, ak as readChildAndParentRelationshipNote, al as readChildAndParentsRelationship, am as readChildAndParentsRelationshipChangeHistory, an as readChildAndParentsRelationshipNote, ao as readChildAndParentsRelationshipNotes, ap as readChildAndParentsRelationshipSourceReferences, aq as readChildAndParentsRelationshipSources, ar as readCollectionSourceDescriptions, as as readCoupleRelationship, at as readCoupleRelationshipChangeHistory, au as readCoupleRelationshipNote, av as readCoupleRelationshipNotes, aw as readCoupleRelationshipSourceReferences, ax as readCoupleRelationshipSources, ay as readDescendancy, az as readGroup, aA as readGroups, aB as readNotAMatchDeclarations, aC as readPendingModifications, aD as readPerson, aE as readPersonChangeHistory, aF as readPersonChildren, aG as readPersonDiscussions, aH as readPersonFamilies, aI as readPersonMatches, aJ as readPersonMemories, aK as readPersonMergeAnalysis, aL as readPersonNonMatches, aM as readPersonNotAMatches, aN as readPersonNote, aO as readPersonNotes, aP as readPersonParents, aQ as readPersonPortraits, aR as readPersonSources, aS as readPersonSpouses, aT as readPersonWithDetails, aU as readPreferredParentRelationship, aV as readPreferredSpouseRelationship, aW as readResearchTreePersons, aX as readSourceDescription, aY as readSourceDescriptionChanges, aZ as readSourceDescriptionHead, a_ as readSourceDescriptions, a$ as readSourceFolders, b0 as readTree, b1 as readTreeChanges, b2 as readTreeMatches, b3 as readUserDefinedCollection, b4 as readUserSourceDescriptions, b5 as readUserSourceFolders, b6 as removeSourcesFromCollection, b7 as restoreChange, b8 as restoreChildAndParentsRelationship, b9 as restoreCoupleRelationship, ba as restorePerson, bb as searchPersonByData, bc as searchPersons, bd as setParentOrder, be as setPreferredParentRelationship, bf as setPreferredSpouseRelationship, bg as setSpouseOrder, bh as updateChildAndParentsRelationship, bi as updateChildAndParentsRelationshipNote, bj as updateCoupleRelationship, bk as updateCoupleRelationshipNote, bl as updateGroup, bm as updateMatchResolution, bn as updatePerson, bo as updatePersonNotAMatches, bp as updatePersonNote, bq as updatePersonPortraits, br as updateSourceDescription, bs as updateUserDefinedCollection } from './tree-changes-e0UMhVha.cjs';
 
 /**
  * FamilySearch Tree API

package/dist/{index-BMAcJBZJ.d.cts → index-CgIsZu6a.d.ts}

@@ -1,4 +1,4 @@
-import { A as AgentAPI, C as ConclusionsAPI, G as GroupsAPI, M as MatchesAPI, a as MergesAPI, N as NotesAPI, P as PedigreesAPI, b as PendingModificationsAPI, c as PersonsAPI, d as PreferencesAPI, R as RelationshipsAPI, S as SearchAPI, e as SourceAttachmentsAPI, f as SourceBoxAPI, g as SourcesAPI, T as TreeChangesAPI, h as TreesManagementAPI, i as addSourcesToCollection, j as allowPersonMerge, k as attachSourceToChildAndParentsRelationship, l as attachSourceToCoupleRelationship, m as attachSourceToPerson, n as canMergePersons, o as createChildAndParentsRelationship, p as createChildAndParentsRelationshipNote, q as createChildAndParentsRelationshipSourceReference, r as createCoupleRelationship, s as createCoupleRelationshipNote, t as createCoupleRelationshipSourceReference, u as createGroup, v as createNotAMatchDeclaration, w as createPerson, x as createPersonMemory, y as createPersonNote, z as createRelationshipGedcomx, B as createSourceDescription, D as createSourceFolder, E as createTree, F as deleteAllNotAMatchDeclarations, H as deleteChildAndParentsRelationship, I as deleteChildAndParentsRelationshipConclusion, J as deleteChildAndParentsRelationshipNote, K as deleteChildAndParentsRelationshipParent, L as deleteChildAndParentsRelationshipSourceReference, O as deleteCoupleRelationship, Q as deleteCoupleRelationshipConclusion, U as deleteCoupleRelationshipNote, V as deleteCoupleRelationshipSourceReference, W as deleteGroup, X as deleteNotAMatchDeclaration, Y as deletePerson, Z as deletePersonConclusion, _ as deletePersonDiscussionReference, $ as deletePersonMemoriesPersonaReference, a0 as deletePersonNotAMatch, a1 as deletePersonNotAMatches, a2 as deletePersonNote, a3 as deletePersonPortrait, a4 as deletePersonSourceReference, a5 as deletePreferredParentRelationship, a6 as deletePreferredSpouseRelationship, a7 as deleteSourceDescription, a8 as deleteTree, a9 as deleteTreePersonReference, aa as deleteUserDefinedCollection, ab as detachSourceFromChildAndParentsRelationship, ac as detachSourceFromCoupleRelationship, ad as detachSourceFromPerson, ae as exportGEDCOM, af as matchPerson, ag as mergePerson, ah as performPersonMatchesByExample, ai as readAgent, aj as readAncestry, ak as readChildAndParentRelationshipNote, al as readChildAndParentsRelationship, am as readChildAndParentsRelationshipChangeHistory, an as readChildAndParentsRelationshipNote, ao as readChildAndParentsRelationshipNotes, ap as readChildAndParentsRelationshipSourceReferences, aq as readChildAndParentsRelationshipSources, ar as readCollectionSourceDescriptions, as as readCoupleRelationship, at as readCoupleRelationshipChangeHistory, au as readCoupleRelationshipNote, av as readCoupleRelationshipNotes, aw as readCoupleRelationshipSourceReferences, ax as readCoupleRelationshipSources, ay as readDescendancy, az as readGroup, aA as readGroups, aB as readNotAMatchDeclarations, aC as readPendingModifications, aD as readPerson, aE as readPersonChangeHistory, aF as readPersonChildren, aG as readPersonDiscussions, aH as readPersonFamilies, aI as readPersonMatches, aJ as readPersonMemories, aK as readPersonMergeAnalysis, aL as readPersonNonMatches, aM as readPersonNotAMatches, aN as readPersonNote, aO as readPersonNotes, aP as readPersonParents, aQ as readPersonPortraits, aR as readPersonSources, aS as readPersonSpouses, aT as readPersonWithDetails, aU as readPreferredParentRelationship, aV as readPreferredSpouseRelationship, aW as readResearchTreePersons, aX as readSourceDescription, aY as readSourceDescriptionChanges, aZ as readSourceDescriptionHead, a_ as readSourceDescriptions, a$ as readSourceFolders, b0 as readTree, b1 as readTreeChanges, b2 as readTreeMatches, b3 as readUserDefinedCollection, b4 as readUserSourceDescriptions, b5 as readUserSourceFolders, b6 as removeSourcesFromCollection, b7 as restoreChange, b8 as restoreChildAndParentsRelationship, b9 as restoreCoupleRelationship, ba as restorePerson, bb as searchPersonByData, bc as searchPersons, bd as setParentOrder, be as setPreferredParentRelationship, bf as setPreferredSpouseRelationship, bg as setSpouseOrder, bh as updateChildAndParentsRelationship, bi as updateChildAndParentsRelationshipNote, bj as updateCoupleRelationship, bk as updateCoupleRelationshipNote, bl as updateGroup, bm as updateMatchResolution, bn as updatePerson, bo as updatePersonNotAMatches, bp as updatePersonNote, bq as updatePersonPortraits, br as updateSourceDescription, bs as updateUserDefinedCollection } from './index-CLkFtjZD.cjs';
+import { A as AgentAPI, C as ConclusionsAPI, G as GroupsAPI, M as MatchesAPI, a as MergesAPI, N as NotesAPI, P as PedigreesAPI, b as PendingModificationsAPI, c as PersonsAPI, d as PreferencesAPI, R as RelationshipsAPI, S as SearchAPI, e as SourceAttachmentsAPI, f as SourceBoxAPI, g as SourcesAPI, T as TreeChangesAPI, h as TreesManagementAPI, i as addSourcesToCollection, j as allowPersonMerge, k as attachSourceToChildAndParentsRelationship, l as attachSourceToCoupleRelationship, m as attachSourceToPerson, n as canMergePersons, o as createChildAndParentsRelationship, p as createChildAndParentsRelationshipNote, q as createChildAndParentsRelationshipSourceReference, r as createCoupleRelationship, s as createCoupleRelationshipNote, t as createCoupleRelationshipSourceReference, u as createGroup, v as createNotAMatchDeclaration, w as createPerson, x as createPersonMemory, y as createPersonNote, z as createRelationshipGedcomx, B as createSourceDescription, D as createSourceFolder, E as createTree, F as deleteAllNotAMatchDeclarations, H as deleteChildAndParentsRelationship, I as deleteChildAndParentsRelationshipConclusion, J as deleteChildAndParentsRelationshipNote, K as deleteChildAndParentsRelationshipParent, L as deleteChildAndParentsRelationshipSourceReference, O as deleteCoupleRelationship, Q as deleteCoupleRelationshipConclusion, U as deleteCoupleRelationshipNote, V as deleteCoupleRelationshipSourceReference, W as deleteGroup, X as deleteNotAMatchDeclaration, Y as deletePerson, Z as deletePersonConclusion, _ as deletePersonDiscussionReference, $ as deletePersonMemoriesPersonaReference, a0 as deletePersonNotAMatch, a1 as deletePersonNotAMatches, a2 as deletePersonNote, a3 as deletePersonPortrait, a4 as deletePersonSourceReference, a5 as deletePreferredParentRelationship, a6 as deletePreferredSpouseRelationship, a7 as deleteSourceDescription, a8 as deleteTree, a9 as deleteTreePersonReference, aa as deleteUserDefinedCollection, ab as detachSourceFromChildAndParentsRelationship, ac as detachSourceFromCoupleRelationship, ad as detachSourceFromPerson, ae as exportGEDCOM, af as matchPerson, ag as mergePerson, ah as performPersonMatchesByExample, ai as readAgent, aj as readAncestry, ak as readChildAndParentRelationshipNote, al as readChildAndParentsRelationship, am as readChildAndParentsRelationshipChangeHistory, an as readChildAndParentsRelationshipNote, ao as readChildAndParentsRelationshipNotes, ap as readChildAndParentsRelationshipSourceReferences, aq as readChildAndParentsRelationshipSources, ar as readCollectionSourceDescriptions, as as readCoupleRelationship, at as readCoupleRelationshipChangeHistory, au as readCoupleRelationshipNote, av as readCoupleRelationshipNotes, aw as readCoupleRelationshipSourceReferences, ax as readCoupleRelationshipSources, ay as readDescendancy, az as readGroup, aA as readGroups, aB as readNotAMatchDeclarations, aC as readPendingModifications, aD as readPerson, aE as readPersonChangeHistory, aF as readPersonChildren, aG as readPersonDiscussions, aH as readPersonFamilies, aI as readPersonMatches, aJ as readPersonMemories, aK as readPersonMergeAnalysis, aL as readPersonNonMatches, aM as readPersonNotAMatches, aN as readPersonNote, aO as readPersonNotes, aP as readPersonParents, aQ as readPersonPortraits, aR as readPersonSources, aS as readPersonSpouses, aT as readPersonWithDetails, aU as readPreferredParentRelationship, aV as readPreferredSpouseRelationship, aW as readResearchTreePersons, aX as readSourceDescription, aY as readSourceDescriptionChanges, aZ as readSourceDescriptionHead, a_ as readSourceDescriptions, a$ as readSourceFolders, b0 as readTree, b1 as readTreeChanges, b2 as readTreeMatches, b3 as readUserDefinedCollection, b4 as readUserSourceDescriptions, b5 as readUserSourceFolders, b6 as removeSourcesFromCollection, b7 as restoreChange, b8 as restoreChildAndParentsRelationship, b9 as restoreCoupleRelationship, ba as restorePerson, bb as searchPersonByData, bc as searchPersons, bd as setParentOrder, be as setPreferredParentRelationship, bf as setPreferredSpouseRelationship, bg as setSpouseOrder, bh as updateChildAndParentsRelationship, bi as updateChildAndParentsRelationshipNote, bj as updateCoupleRelationship, bk as updateCoupleRelationshipNote, bl as updateGroup, bm as updateMatchResolution, bn as updatePerson, bo as updatePersonNotAMatches, bp as updatePersonNote, bq as updatePersonPortraits, br as updateSourceDescription, bs as updateUserDefinedCollection } from './tree-changes-CFwJtBcK.js';
 
 /**
  * FamilySearch Tree API

package/dist/index.cjs

@@ -1668,6 +1668,10 @@ __export(tree_exports, {
 });
 
 // src/api/tree/persons.ts
+var PERSON_WRITE_HEADERS = {
+  "Content-Type": "application/x-fs-v1+json",
+  Accept: "application/x-fs-v1+json"
+};
 async function readPerson(sdk, personId) {
   try {
     const response = await sdk.get(
@@ -1700,7 +1704,7 @@ async function readPersonWithDetails(sdk, personId, options = {}) {
 }
 async function createPerson(sdk, person, reason) {
   try {
-    const headers = {};
+    const headers = { ...PERSON_WRITE_HEADERS };
     if (reason) {
       headers["X-Reason"] = reason;
     }
@@ -1717,7 +1721,7 @@ async function createPerson(sdk, person, reason) {
 }
 async function updatePerson(sdk, personId, person, reason) {
   try {
-    const headers = {};
+    const headers = { ...PERSON_WRITE_HEADERS };
     if (reason) {
       headers["X-Reason"] = reason;
     }
@@ -6064,6 +6068,16 @@ var PedigreeAPI = class {
   }
 };
 
+// src/utils/headers.ts
+var isLatin1 = (value) => [...value].every((char) => char.charCodeAt(0) <= 255);
+var toLatin1HeaderValue = (value) => [...value].map((char) => {
+  if (char.charCodeAt(0) <= 255) {
+    return char;
+  }
+  const stripped = char.normalize("NFKD").replace(/\p{M}/gu, "");
+  return stripped && isLatin1(stripped) ? stripped : "?";
+}).join("");
+
 // src/client.ts
 var ENVIRONMENT_CONFIGS = {
   production: {
@@ -6204,6 +6218,9 @@ var FamilySearchSDK = class {
         if (this.appKey) {
           headers["X-FS-App-Key"] = this.appKey;
         }
+        for (const key of Object.keys(headers)) {
+          headers[key] = toLatin1HeaderValue(headers[key]);
+        }
         this.logger.log(
           `[FamilySearch SDK] ${options.method || "GET"} ${fullUrl}`
         );
@@ -6218,7 +6235,7 @@ var FamilySearchSDK = class {
           });
           let data;
           const contentType = response.headers.get("content-type");
-          if (contentType && contentType.includes("application/json")) {
+          if (contentType && contentType.includes("json")) {
             try {
               data = await response.json();
             } catch (error) {
@@ -6374,6 +6391,40 @@ function resetFamilySearchSDK() {
   sdkInstance = null;
 }
 
+// src/places/gazetteer-id.ts
+var numericPlaceIdFromRef = (ref) => {
+  if (!ref) {
+    return void 0;
+  }
+  if (ref.includes("/places/description/") || ref.includes("ark:/")) {
+    return void 0;
+  }
+  const match = ref.match(/\/places\/(\d+)/);
+  return match?.[1];
+};
+var extractGazetteerPlaceId = (place) => {
+  const persistent = place.identifiers?.["http://gedcomx.org/Persistent"]?.[0];
+  const fromPersistent = numericPlaceIdFromRef(persistent);
+  if (fromPersistent) {
+    return fromPersistent;
+  }
+  return numericPlaceIdFromRef(place.place?.description);
+};
+var familySearchResearchPlaceUrl = (placeId, baseUrl = "https://www.familysearch.org") => `${baseUrl}/en/research/places/?focusedId=${placeId}`;
+var pickBestPlaceSearchResult = (results, query) => {
+  if (results.length === 0) {
+    return void 0;
+  }
+  const town = query.split(",")[0]?.trim().toLowerCase();
+  if (!town) {
+    return results[0];
+  }
+  const label = (result) => (result.fullName || result.name || result.title || "").toLowerCase();
+  return results.find(
+    (result) => label(result) === town || label(result).startsWith(`${town},`)
+  ) || results.find((result) => label(result).includes(town)) || results[0];
+};
+
 // src/utils/gedcom-converter.ts
 function transformFamilySearchUrl(url) {
   if (url.includes("/platform/tree/persons/https://")) {
@@ -7341,6 +7392,8 @@ exports.createErrorFromResponse = createErrorFromResponse;
 exports.createFamilySearchSDK = createFamilySearchSDK;
 exports.createNetworkError = createNetworkError;
 exports.exchangeCodeForToken = exchangeCodeForToken;
+exports.extractGazetteerPlaceId = extractGazetteerPlaceId;
+exports.familySearchResearchPlaceUrl = familySearchResearchPlaceUrl;
 exports.fetchMultiplePersons = fetchMultiplePersons;
 exports.fetchPedigree = fetchPedigree;
 exports.generateOAuthState = generateOAuthState;
@@ -7352,8 +7405,10 @@ exports.getTokenStorageKey = getTokenStorageKey;
 exports.getUserInfo = getUserInfo;
 exports.initFamilySearchSDK = initFamilySearchSDK;
 exports.isRetryableError = isRetryableError;
+exports.numericPlaceIdFromRef = numericPlaceIdFromRef;
 exports.openOAuthPopup = openOAuthPopup;
 exports.parseCallbackParams = parseCallbackParams;
+exports.pickBestPlaceSearchResult = pickBestPlaceSearchResult;
 exports.readCurrentUser = readCurrentUser2;
 exports.readPlaceAttributes = readPlaceAttributes;
 exports.readPlaceChildren = readPlaceChildren;
@@ -7372,6 +7427,7 @@ exports.searchParentPlaces = searchParentPlaces;
 exports.searchPlaces = searchPlaces;
 exports.storeOAuthState = storeOAuthState;
 exports.storeTokens = storeTokens;
+exports.toLatin1HeaderValue = toLatin1HeaderValue;
 exports.transformFamilySearchUrl = transformFamilySearchUrl;
 exports.validateAccessToken = validateAccessToken;
 exports.validateOAuthState = validateOAuthState;

package/dist/index.d.cts

@@ -1,10 +1,11 @@
-import { bt as GenealogyOtherAPI, bu as GenealogyPersonsAPI, bv as GenealogyRelationshipsAPI, bw as GenealogySourcesAPI, bx as TreesAPI, by as createGenealogyPerson, bz as createGenealogySourceDescription, bA as createGenealogyTree, bB as deleteGenealogyConclusion, bC as deleteGenealogyPerson, bD as deleteGenealogyRelationship, bE as deleteGenealogySourceDescription, bF as deleteGenealogyTree, bG as readGenealogyBulkMatch, bH as readGenealogyNote, bI as readGenealogyPerson, bJ as readGenealogyPersonMatches, bK as readGenealogyPersons, bL as readGenealogySourceDescription, bM as readGenealogyTree, bN as readGenealogyTrees, bO as restoreGenealogyPerson, bP as updateGenealogyPerson, bQ as updateGenealogyRelationship, bR as updateGenealogySourceDescription, bS as updateGenealogyTree, bT as DatesAPI, bU as NamesAPI, bV as PlaceSearchQuery, bW as PlacesAPI, bX as VocabulariesAPI, bY as checkPlaceIsChild, bZ as getNameScript, b_ as normalizeDate, b$ as readPlaceAttributes, c0 as readPlaceChildren, c1 as readPlaceDescription, c2 as readPlaceDescriptionWithRelated, c3 as readPlaceDescriptions, c4 as readPlaceDescriptionsGroup, c5 as readPlaceDetails, c6 as readPlaceType, c7 as readPlaceTypeGroup, c8 as readPlaceTypeGroups, c9 as readPlaceTypes, ca as readVocabularies, cb as readVocabularyConcept, cc as readVocabularyConcepts, cd as searchParentPlaces, ce as searchPlaces, cf as segmentAName } from './index-CLkFtjZD.cjs';
-export { cg as DateStandardizationResponse, ch as ENVIRONMENT_CONFIGS, ci as FamilySearchPlace, cj as FamilySearchSDK, ck as FamilySearchUser, cl as MemoriesAPI, cm as MemoryArtifact, cn as MemoryComment, co as MemoryPersona, cp as MemoryPersonaResponse, cq as MemoryPersonasResponse, cr as MemoryWithCommentsResponse, cs as NameScriptResponse, ct as NameSegment, cu as NameSegmentsResponse, cv as PedigreeAPI, cw as PersonMemoriesResponse, cx as PlaceDescription, cy as PlaceDetailsResponse, cz as PlaceSearchResponse, cA as PlaceSearchResult, cB as StandardizedDate, cC as UserAPI, cD as UserMemoriesResponse, cE as VocabAPI, cF as VocabulariesResponse, cG as VocabularyConceptDetail, cH as VocabularyConceptResponse, cI as VocabularyConceptsResponse, cJ as VocabularyMetadata, cK as createFamilySearchSDK, cL as fetchMultiplePersons, cM as fetchPedigree, cN as getFamilySearchSDK, cO as initFamilySearchSDK, cP as readCurrentUser, cQ as resetFamilySearchSDK } from './index-CLkFtjZD.cjs';
+import { bt as GenealogyOtherAPI, bu as GenealogyPersonsAPI, bv as GenealogyRelationshipsAPI, bw as GenealogySourcesAPI, bx as TreesAPI, by as createGenealogyPerson, bz as createGenealogySourceDescription, bA as createGenealogyTree, bB as deleteGenealogyConclusion, bC as deleteGenealogyPerson, bD as deleteGenealogyRelationship, bE as deleteGenealogySourceDescription, bF as deleteGenealogyTree, bG as readGenealogyBulkMatch, bH as readGenealogyNote, bI as readGenealogyPerson, bJ as readGenealogyPersonMatches, bK as readGenealogyPersons, bL as readGenealogySourceDescription, bM as readGenealogyTree, bN as readGenealogyTrees, bO as restoreGenealogyPerson, bP as updateGenealogyPerson, bQ as updateGenealogyRelationship, bR as updateGenealogySourceDescription, bS as updateGenealogyTree, bT as DatesAPI, bU as NamesAPI, bV as PlaceSearchQuery, bW as PlacesAPI, bX as VocabulariesAPI, bY as checkPlaceIsChild, bZ as getNameScript, b_ as normalizeDate, b$ as readPlaceAttributes, c0 as readPlaceChildren, c1 as readPlaceDescription, c2 as readPlaceDescriptionWithRelated, c3 as readPlaceDescriptions, c4 as readPlaceDescriptionsGroup, c5 as readPlaceDetails, c6 as readPlaceType, c7 as readPlaceTypeGroup, c8 as readPlaceTypeGroups, c9 as readPlaceTypes, ca as readVocabularies, cb as readVocabularyConcept, cc as readVocabularyConcepts, cd as searchParentPlaces, ce as searchPlaces, cf as segmentAName } from './tree-changes-e0UMhVha.cjs';
+export { cg as DateStandardizationResponse, ch as ENVIRONMENT_CONFIGS, ci as FamilySearchPlace, cj as FamilySearchSDK, ck as FamilySearchUser, cl as MemoriesAPI, cm as MemoryArtifact, cn as MemoryComment, co as MemoryPersona, cp as MemoryPersonaResponse, cq as MemoryPersonasResponse, cr as MemoryWithCommentsResponse, cs as NameScriptResponse, ct as NameSegment, cu as NameSegmentsResponse, cv as PedigreeAPI, cw as PersonMemoriesResponse, cx as PlaceDescription, cy as PlaceDetailsResponse, cz as PlaceSearchResponse, cA as PlaceSearchResult, cB as StandardizedDate, cC as UserAPI, cD as UserMemoriesResponse, cE as VocabAPI, cF as VocabulariesResponse, cG as VocabularyConceptDetail, cH as VocabularyConceptResponse, cI as VocabularyConceptsResponse, cJ as VocabularyMetadata, cK as createFamilySearchSDK, cL as fetchMultiplePersons, cM as fetchPedigree, cN as getFamilySearchSDK, cO as initFamilySearchSDK, cP as readCurrentUser, cQ as resetFamilySearchSDK } from './tree-changes-e0UMhVha.cjs';
 import { F as FamilySearchApiResponse } from './index-0PpnEPuZ.cjs';
 export { E as EnvironmentConfig, a as FamilySearchApiError, b as FamilySearchEnvironment, c as FamilySearchSDKConfig, O as OAUTH_ENDPOINTS, d as OAUTH_STORAGE_KEYS, e as OAuthAPI, f as OAuthConfig, g as OAuthEndpoints, h as OAuthStateValidation, i as OAuthTokenResponse, P as ProgressCallback, R as RateLimiterConfig, S as SDKLogger, j as buildAuthorizationUrl, k as clearAllTokens, l as clearStoredTokens, m as exchangeCodeForToken, n as generateOAuthState, o as getOAuthEndpoints, p as getStoredAccessToken, q as getStoredRefreshToken, r as getTokenStorageKey, s as getUserInfo, t as openOAuthPopup, u as parseCallbackParams, v as refreshAccessToken, w as storeOAuthState, x as storeTokens, y as validateAccessToken, z as validateOAuthState } from './index-0PpnEPuZ.cjs';
 export { A as AttachSourceInput, a as AttachSourceResponse, C as ChangeEntry, b as ChildAndParentsRelationship, c as CreateChildAndParentsRelationshipInput, d as CreateCoupleRelationshipInput, e as CreatePersonResponse, f as CreateRelationshipResponse, D as DeletePersonResponse, g as Discussion, h as DiscussionComment, E as EnhancedPedigreeData, i as EnhancedPerson, F as FamilySearchPerson, M as MatchesResponse, N as NameForm, j as Note, k as NoteInput, l as NoteResponse, P as PedigreeData, m as PedigreeResponse, n as PersonChangeHistoryResponse, o as PersonData, p as PersonDiscussionsResponse, q as PersonDisplay, r as PersonFact, s as PersonInput, t as PersonMatchInput, u as PersonMatchOptions, v as PersonMergeAnalysis, w as PersonMergeInput, x as PersonMergeResponse, y as PersonNotesResponse, z as PersonPortrait, B as PersonPortraitsResponse, G as PersonSearchResponse, H as PersonSearchResult, I as PersonSourcesResponse, J as PersonWithRelationships, R as Relationship, K as RelationshipDetails, S as SourceDescription, L as SourceDescriptionDetail, O as SourceDescriptionResponse, Q as SourceDescriptionsResponse, T as SourceReference, U as TreePersonMatchEntry, V as TreePersonMatchesOptions, W as TreePersonMatchesResponse, X as UpdatePersonResponse, Y as UpdateRelationshipResponse } from './tree-D7X-beAQ.cjs';
-export { GedcomConversionOptions, convertFamilySearchToGedcom, convertToGedcom, transformFamilySearchUrl } from './utils/index.cjs';
-export { i as TreeAPI } from './index-BMAcJBZJ.cjs';
+export { FamilySearchPlacePayload, extractGazetteerPlaceId, familySearchResearchPlaceUrl, numericPlaceIdFromRef, pickBestPlaceSearchResult } from './places/index.cjs';
+export { GedcomConversionOptions, convertFamilySearchToGedcom, convertToGedcom, toLatin1HeaderValue, transformFamilySearchUrl } from './utils/index.cjs';
+export { i as TreeAPI } from './index-BfeojAOm.cjs';
 
 /**
  * FamilySearch Genealogies API

package/dist/index.d.ts

@@ -1,10 +1,11 @@
-import { bt as GenealogyOtherAPI, bu as GenealogyPersonsAPI, bv as GenealogyRelationshipsAPI, bw as GenealogySourcesAPI, bx as TreesAPI, by as createGenealogyPerson, bz as createGenealogySourceDescription, bA as createGenealogyTree, bB as deleteGenealogyConclusion, bC as deleteGenealogyPerson, bD as deleteGenealogyRelationship, bE as deleteGenealogySourceDescription, bF as deleteGenealogyTree, bG as readGenealogyBulkMatch, bH as readGenealogyNote, bI as readGenealogyPerson, bJ as readGenealogyPersonMatches, bK as readGenealogyPersons, bL as readGenealogySourceDescription, bM as readGenealogyTree, bN as readGenealogyTrees, bO as restoreGenealogyPerson, bP as updateGenealogyPerson, bQ as updateGenealogyRelationship, bR as updateGenealogySourceDescription, bS as updateGenealogyTree, bT as DatesAPI, bU as NamesAPI, bV as PlaceSearchQuery, bW as PlacesAPI, bX as VocabulariesAPI, bY as checkPlaceIsChild, bZ as getNameScript, b_ as normalizeDate, b$ as readPlaceAttributes, c0 as readPlaceChildren, c1 as readPlaceDescription, c2 as readPlaceDescriptionWithRelated, c3 as readPlaceDescriptions, c4 as readPlaceDescriptionsGroup, c5 as readPlaceDetails, c6 as readPlaceType, c7 as readPlaceTypeGroup, c8 as readPlaceTypeGroups, c9 as readPlaceTypes, ca as readVocabularies, cb as readVocabularyConcept, cc as readVocabularyConcepts, cd as searchParentPlaces, ce as searchPlaces, cf as segmentAName } from './index-CKi9wd-C.js';
-export { cg as DateStandardizationResponse, ch as ENVIRONMENT_CONFIGS, ci as FamilySearchPlace, cj as FamilySearchSDK, ck as FamilySearchUser, cl as MemoriesAPI, cm as MemoryArtifact, cn as MemoryComment, co as MemoryPersona, cp as MemoryPersonaResponse, cq as MemoryPersonasResponse, cr as MemoryWithCommentsResponse, cs as NameScriptResponse, ct as NameSegment, cu as NameSegmentsResponse, cv as PedigreeAPI, cw as PersonMemoriesResponse, cx as PlaceDescription, cy as PlaceDetailsResponse, cz as PlaceSearchResponse, cA as PlaceSearchResult, cB as StandardizedDate, cC as UserAPI, cD as UserMemoriesResponse, cE as VocabAPI, cF as VocabulariesResponse, cG as VocabularyConceptDetail, cH as VocabularyConceptResponse, cI as VocabularyConceptsResponse, cJ as VocabularyMetadata, cK as createFamilySearchSDK, cL as fetchMultiplePersons, cM as fetchPedigree, cN as getFamilySearchSDK, cO as initFamilySearchSDK, cP as readCurrentUser, cQ as resetFamilySearchSDK } from './index-CKi9wd-C.js';
+import { bt as GenealogyOtherAPI, bu as GenealogyPersonsAPI, bv as GenealogyRelationshipsAPI, bw as GenealogySourcesAPI, bx as TreesAPI, by as createGenealogyPerson, bz as createGenealogySourceDescription, bA as createGenealogyTree, bB as deleteGenealogyConclusion, bC as deleteGenealogyPerson, bD as deleteGenealogyRelationship, bE as deleteGenealogySourceDescription, bF as deleteGenealogyTree, bG as readGenealogyBulkMatch, bH as readGenealogyNote, bI as readGenealogyPerson, bJ as readGenealogyPersonMatches, bK as readGenealogyPersons, bL as readGenealogySourceDescription, bM as readGenealogyTree, bN as readGenealogyTrees, bO as restoreGenealogyPerson, bP as updateGenealogyPerson, bQ as updateGenealogyRelationship, bR as updateGenealogySourceDescription, bS as updateGenealogyTree, bT as DatesAPI, bU as NamesAPI, bV as PlaceSearchQuery, bW as PlacesAPI, bX as VocabulariesAPI, bY as checkPlaceIsChild, bZ as getNameScript, b_ as normalizeDate, b$ as readPlaceAttributes, c0 as readPlaceChildren, c1 as readPlaceDescription, c2 as readPlaceDescriptionWithRelated, c3 as readPlaceDescriptions, c4 as readPlaceDescriptionsGroup, c5 as readPlaceDetails, c6 as readPlaceType, c7 as readPlaceTypeGroup, c8 as readPlaceTypeGroups, c9 as readPlaceTypes, ca as readVocabularies, cb as readVocabularyConcept, cc as readVocabularyConcepts, cd as searchParentPlaces, ce as searchPlaces, cf as segmentAName } from './tree-changes-CFwJtBcK.js';
+export { cg as DateStandardizationResponse, ch as ENVIRONMENT_CONFIGS, ci as FamilySearchPlace, cj as FamilySearchSDK, ck as FamilySearchUser, cl as MemoriesAPI, cm as MemoryArtifact, cn as MemoryComment, co as MemoryPersona, cp as MemoryPersonaResponse, cq as MemoryPersonasResponse, cr as MemoryWithCommentsResponse, cs as NameScriptResponse, ct as NameSegment, cu as NameSegmentsResponse, cv as PedigreeAPI, cw as PersonMemoriesResponse, cx as PlaceDescription, cy as PlaceDetailsResponse, cz as PlaceSearchResponse, cA as PlaceSearchResult, cB as StandardizedDate, cC as UserAPI, cD as UserMemoriesResponse, cE as VocabAPI, cF as VocabulariesResponse, cG as VocabularyConceptDetail, cH as VocabularyConceptResponse, cI as VocabularyConceptsResponse, cJ as VocabularyMetadata, cK as createFamilySearchSDK, cL as fetchMultiplePersons, cM as fetchPedigree, cN as getFamilySearchSDK, cO as initFamilySearchSDK, cP as readCurrentUser, cQ as resetFamilySearchSDK } from './tree-changes-CFwJtBcK.js';
 import { F as FamilySearchApiResponse } from './index-0PpnEPuZ.js';
 export { E as EnvironmentConfig, a as FamilySearchApiError, b as FamilySearchEnvironment, c as FamilySearchSDKConfig, O as OAUTH_ENDPOINTS, d as OAUTH_STORAGE_KEYS, e as OAuthAPI, f as OAuthConfig, g as OAuthEndpoints, h as OAuthStateValidation, i as OAuthTokenResponse, P as ProgressCallback, R as RateLimiterConfig, S as SDKLogger, j as buildAuthorizationUrl, k as clearAllTokens, l as clearStoredTokens, m as exchangeCodeForToken, n as generateOAuthState, o as getOAuthEndpoints, p as getStoredAccessToken, q as getStoredRefreshToken, r as getTokenStorageKey, s as getUserInfo, t as openOAuthPopup, u as parseCallbackParams, v as refreshAccessToken, w as storeOAuthState, x as storeTokens, y as validateAccessToken, z as validateOAuthState } from './index-0PpnEPuZ.js';
 export { A as AttachSourceInput, a as AttachSourceResponse, C as ChangeEntry, b as ChildAndParentsRelationship, c as CreateChildAndParentsRelationshipInput, d as CreateCoupleRelationshipInput, e as CreatePersonResponse, f as CreateRelationshipResponse, D as DeletePersonResponse, g as Discussion, h as DiscussionComment, E as EnhancedPedigreeData, i as EnhancedPerson, F as FamilySearchPerson, M as MatchesResponse, N as NameForm, j as Note, k as NoteInput, l as NoteResponse, P as PedigreeData, m as PedigreeResponse, n as PersonChangeHistoryResponse, o as PersonData, p as PersonDiscussionsResponse, q as PersonDisplay, r as PersonFact, s as PersonInput, t as PersonMatchInput, u as PersonMatchOptions, v as PersonMergeAnalysis, w as PersonMergeInput, x as PersonMergeResponse, y as PersonNotesResponse, z as PersonPortrait, B as PersonPortraitsResponse, G as PersonSearchResponse, H as PersonSearchResult, I as PersonSourcesResponse, J as PersonWithRelationships, R as Relationship, K as RelationshipDetails, S as SourceDescription, L as SourceDescriptionDetail, O as SourceDescriptionResponse, Q as SourceDescriptionsResponse, T as SourceReference, U as TreePersonMatchEntry, V as TreePersonMatchesOptions, W as TreePersonMatchesResponse, X as UpdatePersonResponse, Y as UpdateRelationshipResponse } from './tree-D7X-beAQ.js';
-export { GedcomConversionOptions, convertFamilySearchToGedcom, convertToGedcom, transformFamilySearchUrl } from './utils/index.js';
-export { i as TreeAPI } from './index-CcZ9bR5K.js';
+export { FamilySearchPlacePayload, extractGazetteerPlaceId, familySearchResearchPlaceUrl, numericPlaceIdFromRef, pickBestPlaceSearchResult } from './places/index.js';
+export { GedcomConversionOptions, convertFamilySearchToGedcom, convertToGedcom, toLatin1HeaderValue, transformFamilySearchUrl } from './utils/index.js';
+export { i as TreeAPI } from './index-CgIsZu6a.js';
 
 /**
  * FamilySearch Genealogies API

package/dist/index.js

@@ -1666,6 +1666,10 @@ __export(tree_exports, {
 });
 
 // src/api/tree/persons.ts
+var PERSON_WRITE_HEADERS = {
+  "Content-Type": "application/x-fs-v1+json",
+  Accept: "application/x-fs-v1+json"
+};
 async function readPerson(sdk, personId) {
   try {
     const response = await sdk.get(
@@ -1698,7 +1702,7 @@ async function readPersonWithDetails(sdk, personId, options = {}) {
 }
 async function createPerson(sdk, person, reason) {
   try {
-    const headers = {};
+    const headers = { ...PERSON_WRITE_HEADERS };
     if (reason) {
       headers["X-Reason"] = reason;
     }
@@ -1715,7 +1719,7 @@ async function createPerson(sdk, person, reason) {
 }
 async function updatePerson(sdk, personId, person, reason) {
   try {
-    const headers = {};
+    const headers = { ...PERSON_WRITE_HEADERS };
     if (reason) {
       headers["X-Reason"] = reason;
     }
@@ -6062,6 +6066,16 @@ var PedigreeAPI = class {
   }
 };
 
+// src/utils/headers.ts
+var isLatin1 = (value) => [...value].every((char) => char.charCodeAt(0) <= 255);
+var toLatin1HeaderValue = (value) => [...value].map((char) => {
+  if (char.charCodeAt(0) <= 255) {
+    return char;
+  }
+  const stripped = char.normalize("NFKD").replace(/\p{M}/gu, "");
+  return stripped && isLatin1(stripped) ? stripped : "?";
+}).join("");
+
 // src/client.ts
 var ENVIRONMENT_CONFIGS = {
   production: {
@@ -6202,6 +6216,9 @@ var FamilySearchSDK = class {
         if (this.appKey) {
           headers["X-FS-App-Key"] = this.appKey;
         }
+        for (const key of Object.keys(headers)) {
+          headers[key] = toLatin1HeaderValue(headers[key]);
+        }
         this.logger.log(
           `[FamilySearch SDK] ${options.method || "GET"} ${fullUrl}`
         );
@@ -6216,7 +6233,7 @@ var FamilySearchSDK = class {
           });
           let data;
           const contentType = response.headers.get("content-type");
-          if (contentType && contentType.includes("application/json")) {
+          if (contentType && contentType.includes("json")) {
             try {
               data = await response.json();
             } catch (error) {
@@ -6372,6 +6389,40 @@ function resetFamilySearchSDK() {
   sdkInstance = null;
 }
 
+// src/places/gazetteer-id.ts
+var numericPlaceIdFromRef = (ref) => {
+  if (!ref) {
+    return void 0;
+  }
+  if (ref.includes("/places/description/") || ref.includes("ark:/")) {
+    return void 0;
+  }
+  const match = ref.match(/\/places\/(\d+)/);
+  return match?.[1];
+};
+var extractGazetteerPlaceId = (place) => {
+  const persistent = place.identifiers?.["http://gedcomx.org/Persistent"]?.[0];
+  const fromPersistent = numericPlaceIdFromRef(persistent);
+  if (fromPersistent) {
+    return fromPersistent;
+  }
+  return numericPlaceIdFromRef(place.place?.description);
+};
+var familySearchResearchPlaceUrl = (placeId, baseUrl = "https://www.familysearch.org") => `${baseUrl}/en/research/places/?focusedId=${placeId}`;
+var pickBestPlaceSearchResult = (results, query) => {
+  if (results.length === 0) {
+    return void 0;
+  }
+  const town = query.split(",")[0]?.trim().toLowerCase();
+  if (!town) {
+    return results[0];
+  }
+  const label = (result) => (result.fullName || result.name || result.title || "").toLowerCase();
+  return results.find(
+    (result) => label(result) === town || label(result).startsWith(`${town},`)
+  ) || results.find((result) => label(result).includes(town)) || results[0];
+};
+
 // src/utils/gedcom-converter.ts
 function transformFamilySearchUrl(url) {
   if (url.includes("/platform/tree/persons/https://")) {
@@ -7309,4 +7360,4 @@ function addMarriageFacts(lines, relationships, person1, person2) {
 }
 var convertFamilySearchToGedcom = convertToGedcom;
 
-export { AuthenticationError, ENVIRONMENT_CONFIGS, FamilySearchError, FamilySearchSDK, genealogies_exports as GenealogiesAPI, memories_exports as MemoriesAPI, NetworkError, NotFoundError, OAUTH_ENDPOINTS, OAUTH_STORAGE_KEYS, OAuthAPI, PedigreeAPI, PlacesAPI, RateLimitError, ServerError, standards_exports as StandardsAPI, tree_exports as TreeAPI, user_exports as UserAPI, ValidationError, vocab_exports as VocabAPI, buildAuthorizationUrl, checkPlaceIsChild, clearAllTokens, clearStoredTokens, convertFamilySearchToGedcom, convertToGedcom, createErrorFromResponse, createFamilySearchSDK, createNetworkError, exchangeCodeForToken, fetchMultiplePersons, fetchPedigree, generateOAuthState, getFamilySearchSDK, getOAuthEndpoints, getStoredAccessToken, getStoredRefreshToken, getTokenStorageKey, getUserInfo, initFamilySearchSDK, isRetryableError, openOAuthPopup, parseCallbackParams, readCurrentUser2 as readCurrentUser, readPlaceAttributes, readPlaceChildren, readPlaceDescription, readPlaceDescriptionWithRelated, readPlaceDescriptions, readPlaceDescriptionsGroup, readPlaceDetails, readPlaceType, readPlaceTypeGroup, readPlaceTypeGroups, readPlaceTypes, refreshAccessToken, resetFamilySearchSDK, searchParentPlaces, searchPlaces, storeOAuthState, storeTokens, transformFamilySearchUrl, validateAccessToken, validateOAuthState };
+export { AuthenticationError, ENVIRONMENT_CONFIGS, FamilySearchError, FamilySearchSDK, genealogies_exports as GenealogiesAPI, memories_exports as MemoriesAPI, NetworkError, NotFoundError, OAUTH_ENDPOINTS, OAUTH_STORAGE_KEYS, OAuthAPI, PedigreeAPI, PlacesAPI, RateLimitError, ServerError, standards_exports as StandardsAPI, tree_exports as TreeAPI, user_exports as UserAPI, ValidationError, vocab_exports as VocabAPI, buildAuthorizationUrl, checkPlaceIsChild, clearAllTokens, clearStoredTokens, convertFamilySearchToGedcom, convertToGedcom, createErrorFromResponse, createFamilySearchSDK, createNetworkError, exchangeCodeForToken, extractGazetteerPlaceId, familySearchResearchPlaceUrl, fetchMultiplePersons, fetchPedigree, generateOAuthState, getFamilySearchSDK, getOAuthEndpoints, getStoredAccessToken, getStoredRefreshToken, getTokenStorageKey, getUserInfo, initFamilySearchSDK, isRetryableError, numericPlaceIdFromRef, openOAuthPopup, parseCallbackParams, pickBestPlaceSearchResult, readCurrentUser2 as readCurrentUser, readPlaceAttributes, readPlaceChildren, readPlaceDescription, readPlaceDescriptionWithRelated, readPlaceDescriptions, readPlaceDescriptionsGroup, readPlaceDetails, readPlaceType, readPlaceTypeGroup, readPlaceTypeGroups, readPlaceTypes, refreshAccessToken, resetFamilySearchSDK, searchParentPlaces, searchPlaces, storeOAuthState, storeTokens, toLatin1HeaderValue, transformFamilySearchUrl, validateAccessToken, validateOAuthState };

package/dist/places/index.cjs

@@ -298,8 +298,46 @@ var PlacesAPI = class {
   }
 };
 
+// src/places/gazetteer-id.ts
+var numericPlaceIdFromRef = (ref) => {
+  if (!ref) {
+    return void 0;
+  }
+  if (ref.includes("/places/description/") || ref.includes("ark:/")) {
+    return void 0;
+  }
+  const match = ref.match(/\/places\/(\d+)/);
+  return match?.[1];
+};
+var extractGazetteerPlaceId = (place) => {
+  const persistent = place.identifiers?.["http://gedcomx.org/Persistent"]?.[0];
+  const fromPersistent = numericPlaceIdFromRef(persistent);
+  if (fromPersistent) {
+    return fromPersistent;
+  }
+  return numericPlaceIdFromRef(place.place?.description);
+};
+var familySearchResearchPlaceUrl = (placeId, baseUrl = "https://www.familysearch.org") => `${baseUrl}/en/research/places/?focusedId=${placeId}`;
+var pickBestPlaceSearchResult = (results, query) => {
+  if (results.length === 0) {
+    return void 0;
+  }
+  const town = query.split(",")[0]?.trim().toLowerCase();
+  if (!town) {
+    return results[0];
+  }
+  const label = (result) => (result.fullName || result.name || result.title || "").toLowerCase();
+  return results.find(
+    (result) => label(result) === town || label(result).startsWith(`${town},`)
+  ) || results.find((result) => label(result).includes(town)) || results[0];
+};
+
 exports.PlacesAPI = PlacesAPI;
 exports.checkPlaceIsChild = checkPlaceIsChild;
+exports.extractGazetteerPlaceId = extractGazetteerPlaceId;
+exports.familySearchResearchPlaceUrl = familySearchResearchPlaceUrl;
+exports.numericPlaceIdFromRef = numericPlaceIdFromRef;
+exports.pickBestPlaceSearchResult = pickBestPlaceSearchResult;
 exports.readPlaceAttributes = readPlaceAttributes;
 exports.readPlaceChildren = readPlaceChildren;
 exports.readPlaceDescription = readPlaceDescription;

package/dist/places/index.d.cts

@@ -1,3 +1,42 @@
-export { bW as PlacesAPI, bY as checkPlaceIsChild, b$ as readPlaceAttributes, c0 as readPlaceChildren, c1 as readPlaceDescription, c2 as readPlaceDescriptionWithRelated, c3 as readPlaceDescriptions, c4 as readPlaceDescriptionsGroup, c5 as readPlaceDetails, c6 as readPlaceType, c7 as readPlaceTypeGroup, c8 as readPlaceTypeGroups, c9 as readPlaceTypes, cd as searchParentPlaces, ce as searchPlaces } from '../index-CLkFtjZD.cjs';
+export { bW as PlacesAPI, bY as checkPlaceIsChild, b$ as readPlaceAttributes, c0 as readPlaceChildren, c1 as readPlaceDescription, c2 as readPlaceDescriptionWithRelated, c3 as readPlaceDescriptions, c4 as readPlaceDescriptionsGroup, c5 as readPlaceDetails, c6 as readPlaceType, c7 as readPlaceTypeGroup, c8 as readPlaceTypeGroups, c9 as readPlaceTypes, cd as searchParentPlaces, ce as searchPlaces } from '../tree-changes-e0UMhVha.cjs';
 import '../tree-D7X-beAQ.cjs';
 import '../index-0PpnEPuZ.cjs';
+
+/**
+ * FamilySearch Places search returns Place Descriptions.
+ * `place.id` is a Description ID. The Places web UI `focusedId` is a
+ * gazetteer Place ID (different namespace). The Place ID lives on
+ * `identifiers["http://gedcomx.org/Persistent"]` or `place.place`.
+ *
+ * @see https://developers.familysearch.org/main/docs/places
+ */
+type FamilySearchPlacePayload = {
+    id?: string;
+    identifiers?: Record<string, string[]>;
+    place?: {
+        original?: string;
+        description?: string;
+    };
+    display?: {
+        name?: string;
+        fullName?: string;
+        type?: string;
+    };
+    names?: Array<{
+        value?: string;
+    }>;
+    type?: string;
+    latitude?: number;
+    longitude?: number;
+};
+/** Numeric ID from a Place authority URL, never from /places/description/. */
+declare const numericPlaceIdFromRef: (ref?: string) => string | undefined;
+declare const extractGazetteerPlaceId: (place: FamilySearchPlacePayload) => string | undefined;
+declare const familySearchResearchPlaceUrl: (placeId: string, baseUrl?: string) => string;
+declare const pickBestPlaceSearchResult: <T extends {
+    name?: string;
+    fullName?: string;
+    title?: string;
+}>(results: T[], query: string) => T | undefined;
+
+export { type FamilySearchPlacePayload, extractGazetteerPlaceId, familySearchResearchPlaceUrl, numericPlaceIdFromRef, pickBestPlaceSearchResult };

package/dist/places/index.d.ts

@@ -1,3 +1,42 @@
-export { bW as PlacesAPI, bY as checkPlaceIsChild, b$ as readPlaceAttributes, c0 as readPlaceChildren, c1 as readPlaceDescription, c2 as readPlaceDescriptionWithRelated, c3 as readPlaceDescriptions, c4 as readPlaceDescriptionsGroup, c5 as readPlaceDetails, c6 as readPlaceType, c7 as readPlaceTypeGroup, c8 as readPlaceTypeGroups, c9 as readPlaceTypes, cd as searchParentPlaces, ce as searchPlaces } from '../index-CKi9wd-C.js';
+export { bW as PlacesAPI, bY as checkPlaceIsChild, b$ as readPlaceAttributes, c0 as readPlaceChildren, c1 as readPlaceDescription, c2 as readPlaceDescriptionWithRelated, c3 as readPlaceDescriptions, c4 as readPlaceDescriptionsGroup, c5 as readPlaceDetails, c6 as readPlaceType, c7 as readPlaceTypeGroup, c8 as readPlaceTypeGroups, c9 as readPlaceTypes, cd as searchParentPlaces, ce as searchPlaces } from '../tree-changes-CFwJtBcK.js';
 import '../tree-D7X-beAQ.js';
 import '../index-0PpnEPuZ.js';
+
+/**
+ * FamilySearch Places search returns Place Descriptions.
+ * `place.id` is a Description ID. The Places web UI `focusedId` is a
+ * gazetteer Place ID (different namespace). The Place ID lives on
+ * `identifiers["http://gedcomx.org/Persistent"]` or `place.place`.
+ *
+ * @see https://developers.familysearch.org/main/docs/places
+ */
+type FamilySearchPlacePayload = {
+    id?: string;
+    identifiers?: Record<string, string[]>;
+    place?: {
+        original?: string;
+        description?: string;
+    };
+    display?: {
+        name?: string;
+        fullName?: string;
+        type?: string;
+    };
+    names?: Array<{
+        value?: string;
+    }>;
+    type?: string;
+    latitude?: number;
+    longitude?: number;
+};
+/** Numeric ID from a Place authority URL, never from /places/description/. */
+declare const numericPlaceIdFromRef: (ref?: string) => string | undefined;
+declare const extractGazetteerPlaceId: (place: FamilySearchPlacePayload) => string | undefined;
+declare const familySearchResearchPlaceUrl: (placeId: string, baseUrl?: string) => string;
+declare const pickBestPlaceSearchResult: <T extends {
+    name?: string;
+    fullName?: string;
+    title?: string;
+}>(results: T[], query: string) => T | undefined;
+
+export { type FamilySearchPlacePayload, extractGazetteerPlaceId, familySearchResearchPlaceUrl, numericPlaceIdFromRef, pickBestPlaceSearchResult };

package/dist/places/index.js

@@ -296,4 +296,38 @@ var PlacesAPI = class {
   }
 };
 
-export { PlacesAPI, checkPlaceIsChild, readPlaceAttributes, readPlaceChildren, readPlaceDescription, readPlaceDescriptionWithRelated, readPlaceDescriptions, readPlaceDescriptionsGroup, readPlaceDetails, readPlaceType, readPlaceTypeGroup, readPlaceTypeGroups, readPlaceTypes, searchParentPlaces, searchPlaces };
+// src/places/gazetteer-id.ts
+var numericPlaceIdFromRef = (ref) => {
+  if (!ref) {
+    return void 0;
+  }
+  if (ref.includes("/places/description/") || ref.includes("ark:/")) {
+    return void 0;
+  }
+  const match = ref.match(/\/places\/(\d+)/);
+  return match?.[1];
+};
+var extractGazetteerPlaceId = (place) => {
+  const persistent = place.identifiers?.["http://gedcomx.org/Persistent"]?.[0];
+  const fromPersistent = numericPlaceIdFromRef(persistent);
+  if (fromPersistent) {
+    return fromPersistent;
+  }
+  return numericPlaceIdFromRef(place.place?.description);
+};
+var familySearchResearchPlaceUrl = (placeId, baseUrl = "https://www.familysearch.org") => `${baseUrl}/en/research/places/?focusedId=${placeId}`;
+var pickBestPlaceSearchResult = (results, query) => {
+  if (results.length === 0) {
+    return void 0;
+  }
+  const town = query.split(",")[0]?.trim().toLowerCase();
+  if (!town) {
+    return results[0];
+  }
+  const label = (result) => (result.fullName || result.name || result.title || "").toLowerCase();
+  return results.find(
+    (result) => label(result) === town || label(result).startsWith(`${town},`)
+  ) || results.find((result) => label(result).includes(town)) || results[0];
+};
+
+export { PlacesAPI, checkPlaceIsChild, extractGazetteerPlaceId, familySearchResearchPlaceUrl, numericPlaceIdFromRef, pickBestPlaceSearchResult, readPlaceAttributes, readPlaceChildren, readPlaceDescription, readPlaceDescriptionWithRelated, readPlaceDescriptions, readPlaceDescriptionsGroup, readPlaceDetails, readPlaceType, readPlaceTypeGroup, readPlaceTypeGroups, readPlaceTypes, searchParentPlaces, searchPlaces };

package/dist/tree/index.cjs

@@ -1,6 +1,10 @@
 'use strict';
 
 // src/api/tree/persons.ts
+var PERSON_WRITE_HEADERS = {
+  "Content-Type": "application/x-fs-v1+json",
+  Accept: "application/x-fs-v1+json"
+};
 async function readPerson(sdk, personId) {
   try {
     const response = await sdk.get(
@@ -33,7 +37,7 @@ async function readPersonWithDetails(sdk, personId, options = {}) {
 }
 async function createPerson(sdk, person, reason) {
   try {
-    const headers = {};
+    const headers = { ...PERSON_WRITE_HEADERS };
     if (reason) {
       headers["X-Reason"] = reason;
     }
@@ -50,7 +54,7 @@ async function createPerson(sdk, person, reason) {
 }
 async function updatePerson(sdk, personId, person, reason) {
   try {
-    const headers = {};
+    const headers = { ...PERSON_WRITE_HEADERS };
     if (reason) {
       headers["X-Reason"] = reason;
     }

package/dist/tree/index.d.cts

@@ -1,3 +1,3 @@
-export { A as AgentAPI, C as ConclusionsAPI, G as GroupsAPI, M as MatchesAPI, a as MergesAPI, N as NotesAPI, P as PedigreesAPI, b as PendingModificationsAPI, c as PersonsAPI, d as PreferencesAPI, R as RelationshipsAPI, S as SearchAPI, e as SourceAttachmentsAPI, f as SourceBoxAPI, g as SourcesAPI, T as TreeChangesAPI, h as TreesManagementAPI, i as addSourcesToCollection, j as allowPersonMerge, k as attachSourceToChildAndParentsRelationship, l as attachSourceToCoupleRelationship, m as attachSourceToPerson, n as canMergePersons, o as createChildAndParentsRelationship, p as createChildAndParentsRelationshipNote, q as createChildAndParentsRelationshipSourceReference, r as createCoupleRelationship, s as createCoupleRelationshipNote, t as createCoupleRelationshipSourceReference, u as createGroup, v as createNotAMatchDeclaration, w as createPerson, x as createPersonMemory, y as createPersonNote, z as createRelationshipGedcomx, B as createSourceDescription, D as createSourceFolder, E as createTree, F as deleteAllNotAMatchDeclarations, H as deleteChildAndParentsRelationship, I as deleteChildAndParentsRelationshipConclusion, J as deleteChildAndParentsRelationshipNote, K as deleteChildAndParentsRelationshipParent, L as deleteChildAndParentsRelationshipSourceReference, O as deleteCoupleRelationship, Q as deleteCoupleRelationshipConclusion, U as deleteCoupleRelationshipNote, V as deleteCoupleRelationshipSourceReference, W as deleteGroup, X as deleteNotAMatchDeclaration, Y as deletePerson, Z as deletePersonConclusion, _ as deletePersonDiscussionReference, $ as deletePersonMemoriesPersonaReference, a0 as deletePersonNotAMatch, a1 as deletePersonNotAMatches, a2 as deletePersonNote, a3 as deletePersonPortrait, a4 as deletePersonSourceReference, a5 as deletePreferredParentRelationship, a6 as deletePreferredSpouseRelationship, a7 as deleteSourceDescription, a8 as deleteTree, a9 as deleteTreePersonReference, aa as deleteUserDefinedCollection, ab as detachSourceFromChildAndParentsRelationship, ac as detachSourceFromCoupleRelationship, ad as detachSourceFromPerson, ae as exportGEDCOM, af as matchPerson, ag as mergePerson, ah as performPersonMatchesByExample, ai as readAgent, aj as readAncestry, ak as readChildAndParentRelationshipNote, al as readChildAndParentsRelationship, am as readChildAndParentsRelationshipChangeHistory, an as readChildAndParentsRelationshipNote, ao as readChildAndParentsRelationshipNotes, ap as readChildAndParentsRelationshipSourceReferences, aq as readChildAndParentsRelationshipSources, ar as readCollectionSourceDescriptions, as as readCoupleRelationship, at as readCoupleRelationshipChangeHistory, au as readCoupleRelationshipNote, av as readCoupleRelationshipNotes, aw as readCoupleRelationshipSourceReferences, ax as readCoupleRelationshipSources, ay as readDescendancy, az as readGroup, aA as readGroups, aB as readNotAMatchDeclarations, aC as readPendingModifications, aD as readPerson, aE as readPersonChangeHistory, aF as readPersonChildren, aG as readPersonDiscussions, aH as readPersonFamilies, aI as readPersonMatches, aJ as readPersonMemories, aK as readPersonMergeAnalysis, aL as readPersonNonMatches, aM as readPersonNotAMatches, aN as readPersonNote, aO as readPersonNotes, aP as readPersonParents, aQ as readPersonPortraits, aR as readPersonSources, aS as readPersonSpouses, aT as readPersonWithDetails, aU as readPreferredParentRelationship, aV as readPreferredSpouseRelationship, aW as readResearchTreePersons, aX as readSourceDescription, aY as readSourceDescriptionChanges, aZ as readSourceDescriptionHead, a_ as readSourceDescriptions, a$ as readSourceFolders, b0 as readTree, b1 as readTreeChanges, b2 as readTreeMatches, b3 as readUserDefinedCollection, b4 as readUserSourceDescriptions, b5 as readUserSourceFolders, b6 as removeSourcesFromCollection, b7 as restoreChange, b8 as restoreChildAndParentsRelationship, b9 as restoreCoupleRelationship, ba as restorePerson, bb as searchPersonByData, bc as searchPersons, bd as setParentOrder, be as setPreferredParentRelationship, bf as setPreferredSpouseRelationship, bg as setSpouseOrder, bh as updateChildAndParentsRelationship, bi as updateChildAndParentsRelationshipNote, bj as updateCoupleRelationship, bk as updateCoupleRelationshipNote, bl as updateGroup, bm as updateMatchResolution, bn as updatePerson, bo as updatePersonNotAMatches, bp as updatePersonNote, bq as updatePersonPortraits, br as updateSourceDescription, bs as updateUserDefinedCollection } from '../index-CLkFtjZD.cjs';
+export { A as AgentAPI, C as ConclusionsAPI, G as GroupsAPI, M as MatchesAPI, a as MergesAPI, N as NotesAPI, P as PedigreesAPI, b as PendingModificationsAPI, c as PersonsAPI, d as PreferencesAPI, R as RelationshipsAPI, S as SearchAPI, e as SourceAttachmentsAPI, f as SourceBoxAPI, g as SourcesAPI, T as TreeChangesAPI, h as TreesManagementAPI, i as addSourcesToCollection, j as allowPersonMerge, k as attachSourceToChildAndParentsRelationship, l as attachSourceToCoupleRelationship, m as attachSourceToPerson, n as canMergePersons, o as createChildAndParentsRelationship, p as createChildAndParentsRelationshipNote, q as createChildAndParentsRelationshipSourceReference, r as createCoupleRelationship, s as createCoupleRelationshipNote, t as createCoupleRelationshipSourceReference, u as createGroup, v as createNotAMatchDeclaration, w as createPerson, x as createPersonMemory, y as createPersonNote, z as createRelationshipGedcomx, B as createSourceDescription, D as createSourceFolder, E as createTree, F as deleteAllNotAMatchDeclarations, H as deleteChildAndParentsRelationship, I as deleteChildAndParentsRelationshipConclusion, J as deleteChildAndParentsRelationshipNote, K as deleteChildAndParentsRelationshipParent, L as deleteChildAndParentsRelationshipSourceReference, O as deleteCoupleRelationship, Q as deleteCoupleRelationshipConclusion, U as deleteCoupleRelationshipNote, V as deleteCoupleRelationshipSourceReference, W as deleteGroup, X as deleteNotAMatchDeclaration, Y as deletePerson, Z as deletePersonConclusion, _ as deletePersonDiscussionReference, $ as deletePersonMemoriesPersonaReference, a0 as deletePersonNotAMatch, a1 as deletePersonNotAMatches, a2 as deletePersonNote, a3 as deletePersonPortrait, a4 as deletePersonSourceReference, a5 as deletePreferredParentRelationship, a6 as deletePreferredSpouseRelationship, a7 as deleteSourceDescription, a8 as deleteTree, a9 as deleteTreePersonReference, aa as deleteUserDefinedCollection, ab as detachSourceFromChildAndParentsRelationship, ac as detachSourceFromCoupleRelationship, ad as detachSourceFromPerson, ae as exportGEDCOM, af as matchPerson, ag as mergePerson, ah as performPersonMatchesByExample, ai as readAgent, aj as readAncestry, ak as readChildAndParentRelationshipNote, al as readChildAndParentsRelationship, am as readChildAndParentsRelationshipChangeHistory, an as readChildAndParentsRelationshipNote, ao as readChildAndParentsRelationshipNotes, ap as readChildAndParentsRelationshipSourceReferences, aq as readChildAndParentsRelationshipSources, ar as readCollectionSourceDescriptions, as as readCoupleRelationship, at as readCoupleRelationshipChangeHistory, au as readCoupleRelationshipNote, av as readCoupleRelationshipNotes, aw as readCoupleRelationshipSourceReferences, ax as readCoupleRelationshipSources, ay as readDescendancy, az as readGroup, aA as readGroups, aB as readNotAMatchDeclarations, aC as readPendingModifications, aD as readPerson, aE as readPersonChangeHistory, aF as readPersonChildren, aG as readPersonDiscussions, aH as readPersonFamilies, aI as readPersonMatches, aJ as readPersonMemories, aK as readPersonMergeAnalysis, aL as readPersonNonMatches, aM as readPersonNotAMatches, aN as readPersonNote, aO as readPersonNotes, aP as readPersonParents, aQ as readPersonPortraits, aR as readPersonSources, aS as readPersonSpouses, aT as readPersonWithDetails, aU as readPreferredParentRelationship, aV as readPreferredSpouseRelationship, aW as readResearchTreePersons, aX as readSourceDescription, aY as readSourceDescriptionChanges, aZ as readSourceDescriptionHead, a_ as readSourceDescriptions, a$ as readSourceFolders, b0 as readTree, b1 as readTreeChanges, b2 as readTreeMatches, b3 as readUserDefinedCollection, b4 as readUserSourceDescriptions, b5 as readUserSourceFolders, b6 as removeSourcesFromCollection, b7 as restoreChange, b8 as restoreChildAndParentsRelationship, b9 as restoreCoupleRelationship, ba as restorePerson, bb as searchPersonByData, bc as searchPersons, bd as setParentOrder, be as setPreferredParentRelationship, bf as setPreferredSpouseRelationship, bg as setSpouseOrder, bh as updateChildAndParentsRelationship, bi as updateChildAndParentsRelationshipNote, bj as updateCoupleRelationship, bk as updateCoupleRelationshipNote, bl as updateGroup, bm as updateMatchResolution, bn as updatePerson, bo as updatePersonNotAMatches, bp as updatePersonNote, bq as updatePersonPortraits, br as updateSourceDescription, bs as updateUserDefinedCollection } from '../tree-changes-e0UMhVha.cjs';
 import '../tree-D7X-beAQ.cjs';
 import '../index-0PpnEPuZ.cjs';

package/dist/tree/index.d.ts

@@ -1,3 +1,3 @@
-export { A as AgentAPI, C as ConclusionsAPI, G as GroupsAPI, M as MatchesAPI, a as MergesAPI, N as NotesAPI, P as PedigreesAPI, b as PendingModificationsAPI, c as PersonsAPI, d as PreferencesAPI, R as RelationshipsAPI, S as SearchAPI, e as SourceAttachmentsAPI, f as SourceBoxAPI, g as SourcesAPI, T as TreeChangesAPI, h as TreesManagementAPI, i as addSourcesToCollection, j as allowPersonMerge, k as attachSourceToChildAndParentsRelationship, l as attachSourceToCoupleRelationship, m as attachSourceToPerson, n as canMergePersons, o as createChildAndParentsRelationship, p as createChildAndParentsRelationshipNote, q as createChildAndParentsRelationshipSourceReference, r as createCoupleRelationship, s as createCoupleRelationshipNote, t as createCoupleRelationshipSourceReference, u as createGroup, v as createNotAMatchDeclaration, w as createPerson, x as createPersonMemory, y as createPersonNote, z as createRelationshipGedcomx, B as createSourceDescription, D as createSourceFolder, E as createTree, F as deleteAllNotAMatchDeclarations, H as deleteChildAndParentsRelationship, I as deleteChildAndParentsRelationshipConclusion, J as deleteChildAndParentsRelationshipNote, K as deleteChildAndParentsRelationshipParent, L as deleteChildAndParentsRelationshipSourceReference, O as deleteCoupleRelationship, Q as deleteCoupleRelationshipConclusion, U as deleteCoupleRelationshipNote, V as deleteCoupleRelationshipSourceReference, W as deleteGroup, X as deleteNotAMatchDeclaration, Y as deletePerson, Z as deletePersonConclusion, _ as deletePersonDiscussionReference, $ as deletePersonMemoriesPersonaReference, a0 as deletePersonNotAMatch, a1 as deletePersonNotAMatches, a2 as deletePersonNote, a3 as deletePersonPortrait, a4 as deletePersonSourceReference, a5 as deletePreferredParentRelationship, a6 as deletePreferredSpouseRelationship, a7 as deleteSourceDescription, a8 as deleteTree, a9 as deleteTreePersonReference, aa as deleteUserDefinedCollection, ab as detachSourceFromChildAndParentsRelationship, ac as detachSourceFromCoupleRelationship, ad as detachSourceFromPerson, ae as exportGEDCOM, af as matchPerson, ag as mergePerson, ah as performPersonMatchesByExample, ai as readAgent, aj as readAncestry, ak as readChildAndParentRelationshipNote, al as readChildAndParentsRelationship, am as readChildAndParentsRelationshipChangeHistory, an as readChildAndParentsRelationshipNote, ao as readChildAndParentsRelationshipNotes, ap as readChildAndParentsRelationshipSourceReferences, aq as readChildAndParentsRelationshipSources, ar as readCollectionSourceDescriptions, as as readCoupleRelationship, at as readCoupleRelationshipChangeHistory, au as readCoupleRelationshipNote, av as readCoupleRelationshipNotes, aw as readCoupleRelationshipSourceReferences, ax as readCoupleRelationshipSources, ay as readDescendancy, az as readGroup, aA as readGroups, aB as readNotAMatchDeclarations, aC as readPendingModifications, aD as readPerson, aE as readPersonChangeHistory, aF as readPersonChildren, aG as readPersonDiscussions, aH as readPersonFamilies, aI as readPersonMatches, aJ as readPersonMemories, aK as readPersonMergeAnalysis, aL as readPersonNonMatches, aM as readPersonNotAMatches, aN as readPersonNote, aO as readPersonNotes, aP as readPersonParents, aQ as readPersonPortraits, aR as readPersonSources, aS as readPersonSpouses, aT as readPersonWithDetails, aU as readPreferredParentRelationship, aV as readPreferredSpouseRelationship, aW as readResearchTreePersons, aX as readSourceDescription, aY as readSourceDescriptionChanges, aZ as readSourceDescriptionHead, a_ as readSourceDescriptions, a$ as readSourceFolders, b0 as readTree, b1 as readTreeChanges, b2 as readTreeMatches, b3 as readUserDefinedCollection, b4 as readUserSourceDescriptions, b5 as readUserSourceFolders, b6 as removeSourcesFromCollection, b7 as restoreChange, b8 as restoreChildAndParentsRelationship, b9 as restoreCoupleRelationship, ba as restorePerson, bb as searchPersonByData, bc as searchPersons, bd as setParentOrder, be as setPreferredParentRelationship, bf as setPreferredSpouseRelationship, bg as setSpouseOrder, bh as updateChildAndParentsRelationship, bi as updateChildAndParentsRelationshipNote, bj as updateCoupleRelationship, bk as updateCoupleRelationshipNote, bl as updateGroup, bm as updateMatchResolution, bn as updatePerson, bo as updatePersonNotAMatches, bp as updatePersonNote, bq as updatePersonPortraits, br as updateSourceDescription, bs as updateUserDefinedCollection } from '../index-CKi9wd-C.js';
+export { A as AgentAPI, C as ConclusionsAPI, G as GroupsAPI, M as MatchesAPI, a as MergesAPI, N as NotesAPI, P as PedigreesAPI, b as PendingModificationsAPI, c as PersonsAPI, d as PreferencesAPI, R as RelationshipsAPI, S as SearchAPI, e as SourceAttachmentsAPI, f as SourceBoxAPI, g as SourcesAPI, T as TreeChangesAPI, h as TreesManagementAPI, i as addSourcesToCollection, j as allowPersonMerge, k as attachSourceToChildAndParentsRelationship, l as attachSourceToCoupleRelationship, m as attachSourceToPerson, n as canMergePersons, o as createChildAndParentsRelationship, p as createChildAndParentsRelationshipNote, q as createChildAndParentsRelationshipSourceReference, r as createCoupleRelationship, s as createCoupleRelationshipNote, t as createCoupleRelationshipSourceReference, u as createGroup, v as createNotAMatchDeclaration, w as createPerson, x as createPersonMemory, y as createPersonNote, z as createRelationshipGedcomx, B as createSourceDescription, D as createSourceFolder, E as createTree, F as deleteAllNotAMatchDeclarations, H as deleteChildAndParentsRelationship, I as deleteChildAndParentsRelationshipConclusion, J as deleteChildAndParentsRelationshipNote, K as deleteChildAndParentsRelationshipParent, L as deleteChildAndParentsRelationshipSourceReference, O as deleteCoupleRelationship, Q as deleteCoupleRelationshipConclusion, U as deleteCoupleRelationshipNote, V as deleteCoupleRelationshipSourceReference, W as deleteGroup, X as deleteNotAMatchDeclaration, Y as deletePerson, Z as deletePersonConclusion, _ as deletePersonDiscussionReference, $ as deletePersonMemoriesPersonaReference, a0 as deletePersonNotAMatch, a1 as deletePersonNotAMatches, a2 as deletePersonNote, a3 as deletePersonPortrait, a4 as deletePersonSourceReference, a5 as deletePreferredParentRelationship, a6 as deletePreferredSpouseRelationship, a7 as deleteSourceDescription, a8 as deleteTree, a9 as deleteTreePersonReference, aa as deleteUserDefinedCollection, ab as detachSourceFromChildAndParentsRelationship, ac as detachSourceFromCoupleRelationship, ad as detachSourceFromPerson, ae as exportGEDCOM, af as matchPerson, ag as mergePerson, ah as performPersonMatchesByExample, ai as readAgent, aj as readAncestry, ak as readChildAndParentRelationshipNote, al as readChildAndParentsRelationship, am as readChildAndParentsRelationshipChangeHistory, an as readChildAndParentsRelationshipNote, ao as readChildAndParentsRelationshipNotes, ap as readChildAndParentsRelationshipSourceReferences, aq as readChildAndParentsRelationshipSources, ar as readCollectionSourceDescriptions, as as readCoupleRelationship, at as readCoupleRelationshipChangeHistory, au as readCoupleRelationshipNote, av as readCoupleRelationshipNotes, aw as readCoupleRelationshipSourceReferences, ax as readCoupleRelationshipSources, ay as readDescendancy, az as readGroup, aA as readGroups, aB as readNotAMatchDeclarations, aC as readPendingModifications, aD as readPerson, aE as readPersonChangeHistory, aF as readPersonChildren, aG as readPersonDiscussions, aH as readPersonFamilies, aI as readPersonMatches, aJ as readPersonMemories, aK as readPersonMergeAnalysis, aL as readPersonNonMatches, aM as readPersonNotAMatches, aN as readPersonNote, aO as readPersonNotes, aP as readPersonParents, aQ as readPersonPortraits, aR as readPersonSources, aS as readPersonSpouses, aT as readPersonWithDetails, aU as readPreferredParentRelationship, aV as readPreferredSpouseRelationship, aW as readResearchTreePersons, aX as readSourceDescription, aY as readSourceDescriptionChanges, aZ as readSourceDescriptionHead, a_ as readSourceDescriptions, a$ as readSourceFolders, b0 as readTree, b1 as readTreeChanges, b2 as readTreeMatches, b3 as readUserDefinedCollection, b4 as readUserSourceDescriptions, b5 as readUserSourceFolders, b6 as removeSourcesFromCollection, b7 as restoreChange, b8 as restoreChildAndParentsRelationship, b9 as restoreCoupleRelationship, ba as restorePerson, bb as searchPersonByData, bc as searchPersons, bd as setParentOrder, be as setPreferredParentRelationship, bf as setPreferredSpouseRelationship, bg as setSpouseOrder, bh as updateChildAndParentsRelationship, bi as updateChildAndParentsRelationshipNote, bj as updateCoupleRelationship, bk as updateCoupleRelationshipNote, bl as updateGroup, bm as updateMatchResolution, bn as updatePerson, bo as updatePersonNotAMatches, bp as updatePersonNote, bq as updatePersonPortraits, br as updateSourceDescription, bs as updateUserDefinedCollection } from '../tree-changes-CFwJtBcK.js';
 import '../tree-D7X-beAQ.js';
 import '../index-0PpnEPuZ.js';

package/dist/tree/index.js

@@ -1,4 +1,8 @@
 // src/api/tree/persons.ts
+var PERSON_WRITE_HEADERS = {
+  "Content-Type": "application/x-fs-v1+json",
+  Accept: "application/x-fs-v1+json"
+};
 async function readPerson(sdk, personId) {
   try {
     const response = await sdk.get(
@@ -31,7 +35,7 @@ async function readPersonWithDetails(sdk, personId, options = {}) {
 }
 async function createPerson(sdk, person, reason) {
   try {
-    const headers = {};
+    const headers = { ...PERSON_WRITE_HEADERS };
     if (reason) {
       headers["X-Reason"] = reason;
     }
@@ -48,7 +52,7 @@ async function createPerson(sdk, person, reason) {
 }
 async function updatePerson(sdk, personId, person, reason) {
   try {
-    const headers = {};
+    const headers = { ...PERSON_WRITE_HEADERS };
     if (reason) {
       headers["X-Reason"] = reason;
     }

package/dist/{index-CKi9wd-C.d.ts → tree-changes-CFwJtBcK.d.ts}

@@ -390,6 +390,8 @@ interface PlaceDescription {
     };
     latitude?: number;
     longitude?: number;
+    /** Persistent Place authority URLs (gazetteer Place IDs), not Description IDs */
+    identifiers?: Record<string, string[]>;
     place?: {
         original?: string;
         description?: string;
@@ -398,6 +400,11 @@ interface PlaceDescription {
         id?: string;
         name?: string;
     };
+    display?: {
+        name?: string;
+        fullName?: string;
+        type?: string;
+    };
     spatialDescription?: {
         type?: string;
         geojson?: unknown;
@@ -474,6 +481,8 @@ interface PlaceDescriptionsResponse {
  * Single place description response
  */
 interface PlaceDescriptionResponse {
+    /** Top-level places array returned by /platform/places/description/{id} */
+    places?: PlaceDescription[];
     sourceDescriptions?: Array<{
         id?: string;
         resourceType?: string;

package/dist/{index-CLkFtjZD.d.cts → tree-changes-e0UMhVha.d.cts}

@@ -390,6 +390,8 @@ interface PlaceDescription {
     };
     latitude?: number;
     longitude?: number;
+    /** Persistent Place authority URLs (gazetteer Place IDs), not Description IDs */
+    identifiers?: Record<string, string[]>;
     place?: {
         original?: string;
         description?: string;
@@ -398,6 +400,11 @@ interface PlaceDescription {
         id?: string;
         name?: string;
     };
+    display?: {
+        name?: string;
+        fullName?: string;
+        type?: string;
+    };
     spatialDescription?: {
         type?: string;
         geojson?: unknown;
@@ -474,6 +481,8 @@ interface PlaceDescriptionsResponse {
  * Single place description response
  */
 interface PlaceDescriptionResponse {
+    /** Top-level places array returned by /platform/places/description/{id} */
+    places?: PlaceDescription[];
     sourceDescriptions?: Array<{
         id?: string;
         resourceType?: string;

package/dist/utils/index.cjs

@@ -937,6 +937,17 @@ function addMarriageFacts(lines, relationships, person1, person2) {
 }
 var convertFamilySearchToGedcom = convertToGedcom;
 
+// src/utils/headers.ts
+var isLatin1 = (value) => [...value].every((char) => char.charCodeAt(0) <= 255);
+var toLatin1HeaderValue = (value) => [...value].map((char) => {
+  if (char.charCodeAt(0) <= 255) {
+    return char;
+  }
+  const stripped = char.normalize("NFKD").replace(/\p{M}/gu, "");
+  return stripped && isLatin1(stripped) ? stripped : "?";
+}).join("");
+
 exports.convertFamilySearchToGedcom = convertFamilySearchToGedcom;
 exports.convertToGedcom = convertToGedcom;
+exports.toLatin1HeaderValue = toLatin1HeaderValue;
 exports.transformFamilySearchUrl = transformFamilySearchUrl;

package/dist/utils/index.d.cts

@@ -49,4 +49,6 @@ interface GedcomConversionOptions {
 declare function convertToGedcom(pedigreeData: EnhancedPedigreeData, options?: GedcomConversionOptions): string;
 declare const convertFamilySearchToGedcom: typeof convertToGedcom;
 
-export { type GedcomConversionOptions, convertFamilySearchToGedcom, convertToGedcom, transformFamilySearchUrl };
+declare const toLatin1HeaderValue: (value: string) => string;
+
+export { type GedcomConversionOptions, convertFamilySearchToGedcom, convertToGedcom, toLatin1HeaderValue, transformFamilySearchUrl };

package/dist/utils/index.d.ts

@@ -49,4 +49,6 @@ interface GedcomConversionOptions {
 declare function convertToGedcom(pedigreeData: EnhancedPedigreeData, options?: GedcomConversionOptions): string;
 declare const convertFamilySearchToGedcom: typeof convertToGedcom;
 
-export { type GedcomConversionOptions, convertFamilySearchToGedcom, convertToGedcom, transformFamilySearchUrl };
+declare const toLatin1HeaderValue: (value: string) => string;
+
+export { type GedcomConversionOptions, convertFamilySearchToGedcom, convertToGedcom, toLatin1HeaderValue, transformFamilySearchUrl };

package/dist/utils/index.js

@@ -935,4 +935,14 @@ function addMarriageFacts(lines, relationships, person1, person2) {
 }
 var convertFamilySearchToGedcom = convertToGedcom;
 
-export { convertFamilySearchToGedcom, convertToGedcom, transformFamilySearchUrl };
+// src/utils/headers.ts
+var isLatin1 = (value) => [...value].every((char) => char.charCodeAt(0) <= 255);
+var toLatin1HeaderValue = (value) => [...value].map((char) => {
+  if (char.charCodeAt(0) <= 255) {
+    return char;
+  }
+  const stripped = char.normalize("NFKD").replace(/\p{M}/gu, "");
+  return stripped && isLatin1(stripped) ? stripped : "?";
+}).join("");
+
+export { convertFamilySearchToGedcom, convertToGedcom, toLatin1HeaderValue, transformFamilySearchUrl };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@treeviz/familysearch-sdk",
-	"version": "2.0.7",
+	"version": "2.0.9",
 	"description": "Modern TypeScript SDK for FamilySearch API v3 - OAuth, Places API, Tree API, and GEDCOM utilities",
 	"type": "module",
 	"main": "./dist/index.js",