@treeviz/familysearch-sdk 1.0.10

package/dist/places/index.js

@@ -0,0 +1,89 @@
+// src/places/places.ts
+async function searchPlaces(sdk, query, options) {
+  const queryParts = [`name:"${query}"`];
+  if (options?.date) {
+    queryParts.push(`+date:${options.date}`);
+  }
+  if (options?.parentId) {
+    queryParts.push(`+parentId:${options.parentId}`);
+  }
+  const finalQuery = queryParts.join(" ");
+  const params = new URLSearchParams({
+    q: finalQuery,
+    ...options?.count && { count: options.count.toString() },
+    ...options?.start && { start: options.start.toString() }
+  });
+  const response = await sdk.get(
+    `/platform/places/search?${params.toString()}`
+  );
+  const data = response.data || {};
+  if (!data?.entries?.length) {
+    if (options?.date) {
+      const { date: _date, ...optionsWithoutDate } = options;
+      return searchPlaces(sdk, query, optionsWithoutDate);
+    }
+    return [];
+  }
+  return data.entries?.map((entry) => {
+    const place = entry.content?.gedcomx?.places?.[0];
+    return {
+      id: place?.id || entry.id,
+      title: entry.title,
+      fullyQualifiedName: entry.title,
+      names: place?.names,
+      standardized: place?.jurisdiction ? {
+        id: place.jurisdiction.id,
+        fullyQualifiedName: place.jurisdiction.name
+      } : void 0,
+      jurisdiction: place?.jurisdiction,
+      temporalDescription: place?.temporalDescription
+    };
+  }) || [];
+}
+async function getPlaceById(sdk, id) {
+  const response = await sdk.get(
+    `/platform/places/${id}`
+  );
+  return response.data?.places?.[0] || null;
+}
+async function getPlaceChildren(sdk, id, options) {
+  const params = new URLSearchParams({
+    ...options?.count && { count: options.count.toString() },
+    ...options?.start && { start: options.start.toString() }
+  });
+  const queryString = params.toString();
+  const url = `/platform/places/${id}/children${queryString ? `?${queryString}` : ""}`;
+  const response = await sdk.get(url);
+  const data = response.data || {};
+  return data.entries?.map((entry) => {
+    const place = entry.content?.gedcomx?.places?.[0];
+    return {
+      id: place?.id || entry.id,
+      title: entry.title,
+      fullyQualifiedName: entry.title,
+      names: place?.names,
+      jurisdiction: place?.jurisdiction
+    };
+  }) || [];
+}
+async function getPlaceDetails(sdk, id) {
+  const place = await getPlaceById(sdk, id);
+  if (!place) {
+    return null;
+  }
+  const primaryName = place.names?.find((n) => n.lang === "en")?.value || place.names?.[0]?.value || "";
+  const aliases = place.names?.filter((n) => n.value !== primaryName).map((n) => n.value || "").filter(Boolean) || [];
+  return {
+    id: place.id || id,
+    name: primaryName,
+    standardizedName: place.jurisdiction?.name,
+    aliases,
+    latitude: place.latitude,
+    longitude: place.longitude,
+    jurisdiction: place.jurisdiction?.name
+  };
+}
+
+export { getPlaceById, getPlaceChildren, getPlaceDetails, searchPlaces };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/places/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/places/places.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * FamilySearch Places API Module\n *\n * Provides helpers for searching and retrieving place information\n * from the FamilySearch Places API.\n *\n * API Documentation: https://developers.familysearch.org/main/page/places-endpoints\n */\n\nimport type { FamilySearchSDK } from \"../client\";\nimport type {\n\tPlaceDescription,\n\tPlaceDetailsResponse,\n\tPlaceSearchResponse,\n\tPlaceSearchResult,\n} from \"../types\";\n\n/**\n * Search for places by name\n *\n * @param sdk - FamilySearch SDK instance\n * @param query - The search query string\n * @param options - Optional search parameters\n * @returns Promise with search results\n *\n * @example\n * ```typescript\n * const results = await searchPlaces(sdk, \"London\", { date: \"1850\" });\n * ```\n */\nexport async function searchPlaces(\n\tsdk: FamilySearchSDK,\n\tquery: string,\n\toptions?: {\n\t\tcount?: number;\n\t\tstart?: number;\n\t\tdate?: string;\n\t\tparentId?: string;\n\t}\n): Promise<PlaceSearchResult[]> {\n\t// Build query parameters according to FamilySearch API docs\n\tconst queryParts = [`name:\"${query}\"`];\n\n\t// Add date to query if provided\n\tif (options?.date) {\n\t\tqueryParts.push(`+date:${options.date}`);\n\t}\n\n\t// Add parentId to query if provided\n\tif (options?.parentId) {\n\t\tqueryParts.push(`+parentId:${options.parentId}`);\n\t}\n\n\tconst finalQuery = queryParts.join(\" \");\n\n\tconst params = new URLSearchParams({\n\t\tq: finalQuery,\n\t\t...(options?.count && { count: options.count.toString() }),\n\t\t...(options?.start && { start: options.start.toString() }),\n\t});\n\n\tconst response = await sdk.get<PlaceSearchResponse>(\n\t\t`/platform/places/search?${params.toString()}`\n\t);\n\n\tconst data = response.data || {};\n\n\t// Check if entries exist\n\tif (!data?.entries?.length) {\n\t\t// If we had a date filter and got no results, try again without it\n\t\tif (options?.date) {\n\t\t\tconst { date: _date, ...optionsWithoutDate } = options;\n\t\t\treturn searchPlaces(sdk, query, optionsWithoutDate);\n\t\t}\n\t\treturn [];\n\t}\n\n\t// Transform the response into a cleaner format\n\treturn (\n\t\tdata.entries?.map((entry) => {\n\t\t\tconst place = entry.content?.gedcomx?.places?.[0];\n\t\t\treturn {\n\t\t\t\tid: place?.id || entry.id,\n\t\t\t\ttitle: entry.title,\n\t\t\t\tfullyQualifiedName: entry.title,\n\t\t\t\tnames: place?.names,\n\t\t\t\tstandardized: place?.jurisdiction\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tid: place.jurisdiction.id,\n\t\t\t\t\t\t\tfullyQualifiedName: place.jurisdiction.name,\n\t\t\t\t\t\t}\n\t\t\t\t\t: undefined,\n\t\t\t\tjurisdiction: place?.jurisdiction,\n\t\t\t\ttemporalDescription: place?.temporalDescription,\n\t\t\t};\n\t\t}) || []\n\t);\n}\n\n/**\n * Get a specific place by its ID\n *\n * @param sdk - FamilySearch SDK instance\n * @param id - The FamilySearch place ID\n * @returns Promise with place details\n */\nexport async function getPlaceById(\n\tsdk: FamilySearchSDK,\n\tid: string\n): Promise<PlaceDescription | null> {\n\tconst response = await sdk.get<PlaceDetailsResponse>(\n\t\t`/platform/places/${id}`\n\t);\n\treturn response.data?.places?.[0] || null;\n}\n\n/**\n * Get child places of a specific place\n *\n * @param sdk - FamilySearch SDK instance\n * @param id - The parent place ID\n * @param options - Optional parameters\n * @returns Promise with child places\n */\nexport async function getPlaceChildren(\n\tsdk: FamilySearchSDK,\n\tid: string,\n\toptions?: {\n\t\tcount?: number;\n\t\tstart?: number;\n\t}\n): Promise<PlaceSearchResult[]> {\n\tconst params = new URLSearchParams({\n\t\t...(options?.count && { count: options.count.toString() }),\n\t\t...(options?.start && { start: options.start.toString() }),\n\t});\n\n\tconst queryString = params.toString();\n\tconst url = `/platform/places/${id}/children${queryString ? `?${queryString}` : \"\"}`;\n\n\tconst response = await sdk.get<PlaceSearchResponse>(url);\n\tconst data = response.data || {};\n\n\t// Transform the response\n\treturn (\n\t\tdata.entries?.map((entry) => {\n\t\t\tconst place = entry.content?.gedcomx?.places?.[0];\n\t\t\treturn {\n\t\t\t\tid: place?.id || entry.id,\n\t\t\t\ttitle: entry.title,\n\t\t\t\tfullyQualifiedName: entry.title,\n\t\t\t\tnames: place?.names,\n\t\t\t\tjurisdiction: place?.jurisdiction,\n\t\t\t};\n\t\t}) || []\n\t);\n}\n\n/**\n * Get detailed information about a place including standardized names and aliases\n *\n * @param sdk - FamilySearch SDK instance\n * @param id - The FamilySearch place ID\n * @returns Promise with detailed place information\n */\nexport async function getPlaceDetails(\n\tsdk: FamilySearchSDK,\n\tid: string\n): Promise<{\n\tid: string;\n\tname: string;\n\tstandardizedName?: string;\n\taliases: string[];\n\tlatitude?: number;\n\tlongitude?: number;\n\tjurisdiction?: string;\n} | null> {\n\tconst place = await getPlaceById(sdk, id);\n\n\tif (!place) {\n\t\treturn null;\n\t}\n\n\t// Extract primary name (first name entry or English name)\n\tconst primaryName =\n\t\tplace.names?.find((n) => n.lang === \"en\")?.value ||\n\t\tplace.names?.[0]?.value ||\n\t\t\"\";\n\n\t// Extract all alternative names as aliases\n\tconst aliases =\n\t\tplace.names\n\t\t\t?.filter((n) => n.value !== primaryName)\n\t\t\t.map((n) => n.value || \"\")\n\t\t\t.filter(Boolean) || [];\n\n\treturn {\n\t\tid: place.id || id,\n\t\tname: primaryName,\n\t\tstandardizedName: place.jurisdiction?.name,\n\t\taliases,\n\t\tlatitude: place.latitude,\n\t\tlongitude: place.longitude,\n\t\tjurisdiction: place.jurisdiction?.name,\n\t};\n}\n"]}

package/dist/tree/index.cjs

@@ -0,0 +1,191 @@
+'use strict';
+
+// src/tree/pedigree.ts
+async function fetchPedigree(sdk, personId, options = {}) {
+  const {
+    generations = 4,
+    onProgress,
+    includeDetails = true,
+    includeNotes = true,
+    includeRelationshipDetails = true
+  } = options;
+  let targetPersonId = personId;
+  if (!targetPersonId) {
+    onProgress?.({
+      stage: "getting_current_user",
+      current: 0,
+      total: 1,
+      percent: 0
+    });
+    const currentUser = await sdk.getCurrentUser();
+    targetPersonId = currentUser?.personId || currentUser?.treeUserId || currentUser?.id;
+    if (!targetPersonId) {
+      throw new Error("Could not determine person ID for current user");
+    }
+  }
+  onProgress?.({
+    stage: "fetching_ancestry_structure",
+    current: 1,
+    total: 3,
+    percent: 10
+  });
+  const ancestryResponse = await sdk.getAncestry(targetPersonId, generations);
+  const ancestry = ancestryResponse.data;
+  if (!ancestry.persons || ancestry.persons.length === 0) {
+    throw new Error("No persons found in ancestry");
+  }
+  onProgress?.({
+    stage: "fetching_person_details",
+    current: 0,
+    total: ancestry.persons.length,
+    percent: 20
+  });
+  const personsWithDetails = [];
+  for (let i = 0; i < ancestry.persons.length; i++) {
+    const person = ancestry.persons[i];
+    onProgress?.({
+      stage: "fetching_person_details",
+      current: i + 1,
+      total: ancestry.persons.length,
+      percent: 20 + Math.floor((i + 1) / ancestry.persons.length * 45)
+    });
+    try {
+      const enhanced = { ...person };
+      if (includeDetails) {
+        enhanced.fullDetails = await sdk.getPersonWithDetails(
+          person.id
+        );
+      }
+      if (includeNotes) {
+        enhanced.notes = await sdk.getPersonNotes(
+          person.id
+        );
+      }
+      personsWithDetails.push(enhanced);
+    } catch {
+      personsWithDetails.push(person);
+    }
+  }
+  onProgress?.({
+    stage: "fetching_relationship_details",
+    current: 0,
+    total: ancestry.relationships?.length || 0,
+    percent: 65
+  });
+  const relationshipsWithDetails = [];
+  if (ancestry.relationships && includeRelationshipDetails) {
+    for (let i = 0; i < ancestry.relationships.length; i++) {
+      const rel = ancestry.relationships[i];
+      onProgress?.({
+        stage: "fetching_relationship_details",
+        current: i + 1,
+        total: ancestry.relationships.length,
+        percent: 65 + Math.floor((i + 1) / ancestry.relationships.length * 25)
+      });
+      try {
+        if (rel.type?.includes?.("Couple")) {
+          const relDetails = await sdk.getCoupleRelationship(rel.id);
+          relationshipsWithDetails.push({
+            ...rel,
+            details: relDetails
+          });
+        } else {
+          relationshipsWithDetails.push(rel);
+        }
+      } catch {
+        relationshipsWithDetails.push(rel);
+      }
+    }
+  } else if (ancestry.relationships) {
+    relationshipsWithDetails.push(...ancestry.relationships);
+  }
+  onProgress?.({
+    stage: "extracting_additional_relationships",
+    current: 0,
+    total: 1,
+    percent: 90
+  });
+  const allRelationships = [...relationshipsWithDetails];
+  const relationshipIds = new Set(relationshipsWithDetails.map((r) => r.id));
+  personsWithDetails.forEach((person) => {
+    const childAndParentsRels = person.fullDetails?.childAndParentsRelationships;
+    if (childAndParentsRels && Array.isArray(childAndParentsRels)) {
+      childAndParentsRels.forEach((rel) => {
+        if (!relationshipIds.has(rel.id)) {
+          relationshipIds.add(rel.id);
+          allRelationships.push({
+            id: rel.id,
+            type: "http://gedcomx.org/ParentChild",
+            person1: rel.parent1,
+            person2: rel.child,
+            parent2: rel.parent2
+          });
+        }
+      });
+    }
+    const relationships = person.fullDetails?.relationships;
+    if (relationships && Array.isArray(relationships)) {
+      relationships.forEach((rel) => {
+        if (rel.type?.includes?.("Couple") && !relationshipIds.has(rel.id)) {
+          relationshipIds.add(rel.id);
+          allRelationships.push({
+            id: rel.id,
+            type: rel.type,
+            person1: rel.person1,
+            person2: rel.person2,
+            facts: rel.facts
+          });
+        }
+      });
+    }
+  });
+  onProgress?.({
+    stage: "completing_data_fetch",
+    current: 1,
+    total: 1,
+    percent: 98
+  });
+  return {
+    persons: personsWithDetails,
+    relationships: allRelationships,
+    environment: sdk.getEnvironment()
+  };
+}
+async function getCurrentUser(sdk) {
+  return sdk.getCurrentUser();
+}
+async function getPersonWithDetails(sdk, personId) {
+  try {
+    const [details, notes] = await Promise.all([
+      sdk.getPersonWithDetails(personId),
+      sdk.getPersonNotes(personId)
+    ]);
+    if (!details) {
+      return null;
+    }
+    const fullDetails = details;
+    const personData = fullDetails?.persons?.[0];
+    if (!personData) {
+      return null;
+    }
+    return {
+      ...personData,
+      fullDetails,
+      notes
+    };
+  } catch {
+    return null;
+  }
+}
+async function fetchMultiplePersons(sdk, personIds) {
+  const pids = personIds.join(",");
+  const response = await sdk.get(`/platform/tree/persons?pids=${pids}`);
+  return response.data;
+}
+
+exports.fetchMultiplePersons = fetchMultiplePersons;
+exports.fetchPedigree = fetchPedigree;
+exports.getCurrentUser = getCurrentUser;
+exports.getPersonWithDetails = getPersonWithDetails;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/tree/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tree/pedigree.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * FamilySearch Tree/Pedigree API Module\n *\n * Provides helpers for fetching and managing family tree data\n * including pedigree, ancestry, and relationship information.\n */\n\nimport type { FamilySearchSDK } from \"../client\";\nimport type {\n\tEnhancedPedigreeData,\n\tEnhancedPerson,\n\tFamilySearchUser,\n\tPedigreeData,\n\tProgressCallback,\n\tRelationship,\n} from \"../types\";\n\n/**\n * Fetch pedigree/ancestry data with enhanced details\n *\n * @param sdk - FamilySearch SDK instance\n * @param personId - Optional person ID to start from. If not provided, uses current user.\n * @param options - Fetch options\n * @returns Promise with enhanced pedigree data\n *\n * @example\n * ```typescript\n * const pedigree = await fetchPedigree(sdk, \"XXXX-YYY\", {\n *   generations: 5,\n *   onProgress: (p) => console.log(`${p.percent}% complete`)\n * });\n * ```\n */\nexport async function fetchPedigree(\n\tsdk: FamilySearchSDK,\n\tpersonId?: string,\n\toptions: {\n\t\tgenerations?: number;\n\t\tonProgress?: ProgressCallback;\n\t\tincludeDetails?: boolean;\n\t\tincludeNotes?: boolean;\n\t\tincludeRelationshipDetails?: boolean;\n\t} = {}\n): Promise<EnhancedPedigreeData> {\n\tconst {\n\t\tgenerations = 4,\n\t\tonProgress,\n\t\tincludeDetails = true,\n\t\tincludeNotes = true,\n\t\tincludeRelationshipDetails = true,\n\t} = options;\n\n\t// Get current user's person ID if not provided\n\tlet targetPersonId = personId;\n\tif (!targetPersonId) {\n\t\tonProgress?.({\n\t\t\tstage: \"getting_current_user\",\n\t\t\tcurrent: 0,\n\t\t\ttotal: 1,\n\t\t\tpercent: 0,\n\t\t});\n\n\t\tconst currentUser = await sdk.getCurrentUser();\n\t\ttargetPersonId =\n\t\t\tcurrentUser?.personId ||\n\t\t\tcurrentUser?.treeUserId ||\n\t\t\tcurrentUser?.id;\n\n\t\tif (!targetPersonId) {\n\t\t\tthrow new Error(\"Could not determine person ID for current user\");\n\t\t}\n\t}\n\n\t// Step 1: Fetch ancestry structure\n\tonProgress?.({\n\t\tstage: \"fetching_ancestry_structure\",\n\t\tcurrent: 1,\n\t\ttotal: 3,\n\t\tpercent: 10,\n\t});\n\n\tconst ancestryResponse = await sdk.getAncestry(targetPersonId, generations);\n\tconst ancestry = ancestryResponse.data as PedigreeData;\n\n\tif (!ancestry.persons || ancestry.persons.length === 0) {\n\t\tthrow new Error(\"No persons found in ancestry\");\n\t}\n\n\t// Step 2: Enhance each person with detailed data\n\tonProgress?.({\n\t\tstage: \"fetching_person_details\",\n\t\tcurrent: 0,\n\t\ttotal: ancestry.persons.length,\n\t\tpercent: 20,\n\t});\n\n\tconst personsWithDetails: EnhancedPerson[] = [];\n\tfor (let i = 0; i < ancestry.persons.length; i++) {\n\t\tconst person = ancestry.persons[i];\n\n\t\tonProgress?.({\n\t\t\tstage: \"fetching_person_details\",\n\t\t\tcurrent: i + 1,\n\t\t\ttotal: ancestry.persons.length,\n\t\t\tpercent: 20 + Math.floor(((i + 1) / ancestry.persons.length) * 45),\n\t\t});\n\n\t\ttry {\n\t\t\tconst enhanced: EnhancedPerson = { ...person };\n\n\t\t\t// Fetch full person details with sources\n\t\t\tif (includeDetails) {\n\t\t\t\tenhanced.fullDetails = (await sdk.getPersonWithDetails(\n\t\t\t\t\tperson.id\n\t\t\t\t)) as EnhancedPerson[\"fullDetails\"];\n\t\t\t}\n\n\t\t\t// Fetch notes\n\t\t\tif (includeNotes) {\n\t\t\t\tenhanced.notes = (await sdk.getPersonNotes(\n\t\t\t\t\tperson.id\n\t\t\t\t)) as EnhancedPerson[\"notes\"];\n\t\t\t}\n\n\t\t\tpersonsWithDetails.push(enhanced);\n\t\t} catch {\n\t\t\t// Fallback to basic person data\n\t\t\tpersonsWithDetails.push(person as EnhancedPerson);\n\t\t}\n\t}\n\n\t// Step 3: Enhance couple relationships with marriage details\n\tonProgress?.({\n\t\tstage: \"fetching_relationship_details\",\n\t\tcurrent: 0,\n\t\ttotal: ancestry.relationships?.length || 0,\n\t\tpercent: 65,\n\t});\n\n\tconst relationshipsWithDetails: Relationship[] = [];\n\tif (ancestry.relationships && includeRelationshipDetails) {\n\t\tfor (let i = 0; i < ancestry.relationships.length; i++) {\n\t\t\tconst rel = ancestry.relationships[i];\n\n\t\t\tonProgress?.({\n\t\t\t\tstage: \"fetching_relationship_details\",\n\t\t\t\tcurrent: i + 1,\n\t\t\t\ttotal: ancestry.relationships.length,\n\t\t\t\tpercent:\n\t\t\t\t\t65 +\n\t\t\t\t\tMath.floor(((i + 1) / ancestry.relationships.length) * 25),\n\t\t\t});\n\n\t\t\ttry {\n\t\t\t\t// Only fetch details for couple relationships\n\t\t\t\tif (rel.type?.includes?.(\"Couple\")) {\n\t\t\t\t\tconst relDetails = await sdk.getCoupleRelationship(rel.id);\n\t\t\t\t\trelationshipsWithDetails.push({\n\t\t\t\t\t\t...rel,\n\t\t\t\t\t\tdetails: relDetails as Relationship[\"details\"],\n\t\t\t\t\t});\n\t\t\t\t} else {\n\t\t\t\t\trelationshipsWithDetails.push(rel);\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\trelationshipsWithDetails.push(rel);\n\t\t\t}\n\t\t}\n\t} else if (ancestry.relationships) {\n\t\trelationshipsWithDetails.push(...ancestry.relationships);\n\t}\n\n\t// Step 4: Extract additional relationships from person details\n\tonProgress?.({\n\t\tstage: \"extracting_additional_relationships\",\n\t\tcurrent: 0,\n\t\ttotal: 1,\n\t\tpercent: 90,\n\t});\n\n\tconst allRelationships = [...relationshipsWithDetails];\n\tconst relationshipIds = new Set(relationshipsWithDetails.map((r) => r.id));\n\n\tpersonsWithDetails.forEach((person) => {\n\t\t// Extract child-parent relationships from person details\n\t\tconst childAndParentsRels =\n\t\t\tperson.fullDetails?.childAndParentsRelationships;\n\t\tif (childAndParentsRels && Array.isArray(childAndParentsRels)) {\n\t\t\tchildAndParentsRels.forEach((rel) => {\n\t\t\t\tif (!relationshipIds.has(rel.id)) {\n\t\t\t\t\trelationshipIds.add(rel.id);\n\t\t\t\t\tallRelationships.push({\n\t\t\t\t\t\tid: rel.id,\n\t\t\t\t\t\ttype: \"http://gedcomx.org/ParentChild\",\n\t\t\t\t\t\tperson1: rel.parent1,\n\t\t\t\t\t\tperson2: rel.child,\n\t\t\t\t\t\tparent2: rel.parent2,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\n\t\t// Extract couple relationships from person details\n\t\tconst relationships = person.fullDetails?.relationships;\n\t\tif (relationships && Array.isArray(relationships)) {\n\t\t\trelationships.forEach((rel) => {\n\t\t\t\tif (rel.type?.includes?.(\"Couple\") && !relationshipIds.has(rel.id)) {\n\t\t\t\t\trelationshipIds.add(rel.id);\n\t\t\t\t\tallRelationships.push({\n\t\t\t\t\t\tid: rel.id,\n\t\t\t\t\t\ttype: rel.type,\n\t\t\t\t\t\tperson1: rel.person1,\n\t\t\t\t\t\tperson2: rel.person2,\n\t\t\t\t\t\tfacts: rel.facts,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t});\n\n\tonProgress?.({\n\t\tstage: \"completing_data_fetch\",\n\t\tcurrent: 1,\n\t\ttotal: 1,\n\t\tpercent: 98,\n\t});\n\n\treturn {\n\t\tpersons: personsWithDetails,\n\t\trelationships: allRelationships,\n\t\tenvironment: sdk.getEnvironment(),\n\t};\n}\n\n/**\n * Get current user information\n */\nexport async function getCurrentUser(\n\tsdk: FamilySearchSDK\n): Promise<FamilySearchUser | null> {\n\treturn sdk.getCurrentUser();\n}\n\n/**\n * Get person by ID with full details\n */\nexport async function getPersonWithDetails(\n\tsdk: FamilySearchSDK,\n\tpersonId: string\n): Promise<EnhancedPerson | null> {\n\ttry {\n\t\tconst [details, notes] = await Promise.all([\n\t\t\tsdk.getPersonWithDetails(personId),\n\t\t\tsdk.getPersonNotes(personId),\n\t\t]);\n\n\t\tif (!details) {\n\t\t\treturn null;\n\t\t}\n\n\t\t// The details response contains the person data in persons array\n\t\tconst fullDetails = details as EnhancedPerson[\"fullDetails\"];\n\t\tconst personData = fullDetails?.persons?.[0];\n\n\t\tif (!personData) {\n\t\t\treturn null;\n\t\t}\n\n\t\treturn {\n\t\t\t...personData,\n\t\t\tfullDetails: fullDetails,\n\t\t\tnotes: notes as EnhancedPerson[\"notes\"],\n\t\t};\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Fetch multiple persons at once\n */\nexport async function fetchMultiplePersons(\n\tsdk: FamilySearchSDK,\n\tpersonIds: string[]\n): Promise<unknown> {\n\tconst pids = personIds.join(\",\");\n\tconst response = await sdk.get(`/platform/tree/persons?pids=${pids}`);\n\treturn response.data;\n}\n"]}

package/dist/tree/index.d.cts

@@ -0,0 +1,47 @@
+import { F as FamilySearchSDK } from '../client-ohjqX4t5.cjs';
+import { v as ProgressCallback, r as EnhancedPedigreeData, d as FamilySearchUser, q as EnhancedPerson } from '../index-D6H-lvis.cjs';
+
+/**
+ * FamilySearch Tree/Pedigree API Module
+ *
+ * Provides helpers for fetching and managing family tree data
+ * including pedigree, ancestry, and relationship information.
+ */
+
+/**
+ * Fetch pedigree/ancestry data with enhanced details
+ *
+ * @param sdk - FamilySearch SDK instance
+ * @param personId - Optional person ID to start from. If not provided, uses current user.
+ * @param options - Fetch options
+ * @returns Promise with enhanced pedigree data
+ *
+ * @example
+ * ```typescript
+ * const pedigree = await fetchPedigree(sdk, "XXXX-YYY", {
+ *   generations: 5,
+ *   onProgress: (p) => console.log(`${p.percent}% complete`)
+ * });
+ * ```
+ */
+declare function fetchPedigree(sdk: FamilySearchSDK, personId?: string, options?: {
+    generations?: number;
+    onProgress?: ProgressCallback;
+    includeDetails?: boolean;
+    includeNotes?: boolean;
+    includeRelationshipDetails?: boolean;
+}): Promise<EnhancedPedigreeData>;
+/**
+ * Get current user information
+ */
+declare function getCurrentUser(sdk: FamilySearchSDK): Promise<FamilySearchUser | null>;
+/**
+ * Get person by ID with full details
+ */
+declare function getPersonWithDetails(sdk: FamilySearchSDK, personId: string): Promise<EnhancedPerson | null>;
+/**
+ * Fetch multiple persons at once
+ */
+declare function fetchMultiplePersons(sdk: FamilySearchSDK, personIds: string[]): Promise<unknown>;
+
+export { fetchMultiplePersons, fetchPedigree, getCurrentUser, getPersonWithDetails };

package/dist/tree/index.d.ts

@@ -0,0 +1,47 @@
+import { F as FamilySearchSDK } from '../client-DIpYSHtx.js';
+import { v as ProgressCallback, r as EnhancedPedigreeData, d as FamilySearchUser, q as EnhancedPerson } from '../index-D6H-lvis.js';
+
+/**
+ * FamilySearch Tree/Pedigree API Module
+ *
+ * Provides helpers for fetching and managing family tree data
+ * including pedigree, ancestry, and relationship information.
+ */
+
+/**
+ * Fetch pedigree/ancestry data with enhanced details
+ *
+ * @param sdk - FamilySearch SDK instance
+ * @param personId - Optional person ID to start from. If not provided, uses current user.
+ * @param options - Fetch options
+ * @returns Promise with enhanced pedigree data
+ *
+ * @example
+ * ```typescript
+ * const pedigree = await fetchPedigree(sdk, "XXXX-YYY", {
+ *   generations: 5,
+ *   onProgress: (p) => console.log(`${p.percent}% complete`)
+ * });
+ * ```
+ */
+declare function fetchPedigree(sdk: FamilySearchSDK, personId?: string, options?: {
+    generations?: number;
+    onProgress?: ProgressCallback;
+    includeDetails?: boolean;
+    includeNotes?: boolean;
+    includeRelationshipDetails?: boolean;
+}): Promise<EnhancedPedigreeData>;
+/**
+ * Get current user information
+ */
+declare function getCurrentUser(sdk: FamilySearchSDK): Promise<FamilySearchUser | null>;
+/**
+ * Get person by ID with full details
+ */
+declare function getPersonWithDetails(sdk: FamilySearchSDK, personId: string): Promise<EnhancedPerson | null>;
+/**
+ * Fetch multiple persons at once
+ */
+declare function fetchMultiplePersons(sdk: FamilySearchSDK, personIds: string[]): Promise<unknown>;
+
+export { fetchMultiplePersons, fetchPedigree, getCurrentUser, getPersonWithDetails };

package/dist/tree/index.js

@@ -0,0 +1,186 @@
+// src/tree/pedigree.ts
+async function fetchPedigree(sdk, personId, options = {}) {
+  const {
+    generations = 4,
+    onProgress,
+    includeDetails = true,
+    includeNotes = true,
+    includeRelationshipDetails = true
+  } = options;
+  let targetPersonId = personId;
+  if (!targetPersonId) {
+    onProgress?.({
+      stage: "getting_current_user",
+      current: 0,
+      total: 1,
+      percent: 0
+    });
+    const currentUser = await sdk.getCurrentUser();
+    targetPersonId = currentUser?.personId || currentUser?.treeUserId || currentUser?.id;
+    if (!targetPersonId) {
+      throw new Error("Could not determine person ID for current user");
+    }
+  }
+  onProgress?.({
+    stage: "fetching_ancestry_structure",
+    current: 1,
+    total: 3,
+    percent: 10
+  });
+  const ancestryResponse = await sdk.getAncestry(targetPersonId, generations);
+  const ancestry = ancestryResponse.data;
+  if (!ancestry.persons || ancestry.persons.length === 0) {
+    throw new Error("No persons found in ancestry");
+  }
+  onProgress?.({
+    stage: "fetching_person_details",
+    current: 0,
+    total: ancestry.persons.length,
+    percent: 20
+  });
+  const personsWithDetails = [];
+  for (let i = 0; i < ancestry.persons.length; i++) {
+    const person = ancestry.persons[i];
+    onProgress?.({
+      stage: "fetching_person_details",
+      current: i + 1,
+      total: ancestry.persons.length,
+      percent: 20 + Math.floor((i + 1) / ancestry.persons.length * 45)
+    });
+    try {
+      const enhanced = { ...person };
+      if (includeDetails) {
+        enhanced.fullDetails = await sdk.getPersonWithDetails(
+          person.id
+        );
+      }
+      if (includeNotes) {
+        enhanced.notes = await sdk.getPersonNotes(
+          person.id
+        );
+      }
+      personsWithDetails.push(enhanced);
+    } catch {
+      personsWithDetails.push(person);
+    }
+  }
+  onProgress?.({
+    stage: "fetching_relationship_details",
+    current: 0,
+    total: ancestry.relationships?.length || 0,
+    percent: 65
+  });
+  const relationshipsWithDetails = [];
+  if (ancestry.relationships && includeRelationshipDetails) {
+    for (let i = 0; i < ancestry.relationships.length; i++) {
+      const rel = ancestry.relationships[i];
+      onProgress?.({
+        stage: "fetching_relationship_details",
+        current: i + 1,
+        total: ancestry.relationships.length,
+        percent: 65 + Math.floor((i + 1) / ancestry.relationships.length * 25)
+      });
+      try {
+        if (rel.type?.includes?.("Couple")) {
+          const relDetails = await sdk.getCoupleRelationship(rel.id);
+          relationshipsWithDetails.push({
+            ...rel,
+            details: relDetails
+          });
+        } else {
+          relationshipsWithDetails.push(rel);
+        }
+      } catch {
+        relationshipsWithDetails.push(rel);
+      }
+    }
+  } else if (ancestry.relationships) {
+    relationshipsWithDetails.push(...ancestry.relationships);
+  }
+  onProgress?.({
+    stage: "extracting_additional_relationships",
+    current: 0,
+    total: 1,
+    percent: 90
+  });
+  const allRelationships = [...relationshipsWithDetails];
+  const relationshipIds = new Set(relationshipsWithDetails.map((r) => r.id));
+  personsWithDetails.forEach((person) => {
+    const childAndParentsRels = person.fullDetails?.childAndParentsRelationships;
+    if (childAndParentsRels && Array.isArray(childAndParentsRels)) {
+      childAndParentsRels.forEach((rel) => {
+        if (!relationshipIds.has(rel.id)) {
+          relationshipIds.add(rel.id);
+          allRelationships.push({
+            id: rel.id,
+            type: "http://gedcomx.org/ParentChild",
+            person1: rel.parent1,
+            person2: rel.child,
+            parent2: rel.parent2
+          });
+        }
+      });
+    }
+    const relationships = person.fullDetails?.relationships;
+    if (relationships && Array.isArray(relationships)) {
+      relationships.forEach((rel) => {
+        if (rel.type?.includes?.("Couple") && !relationshipIds.has(rel.id)) {
+          relationshipIds.add(rel.id);
+          allRelationships.push({
+            id: rel.id,
+            type: rel.type,
+            person1: rel.person1,
+            person2: rel.person2,
+            facts: rel.facts
+          });
+        }
+      });
+    }
+  });
+  onProgress?.({
+    stage: "completing_data_fetch",
+    current: 1,
+    total: 1,
+    percent: 98
+  });
+  return {
+    persons: personsWithDetails,
+    relationships: allRelationships,
+    environment: sdk.getEnvironment()
+  };
+}
+async function getCurrentUser(sdk) {
+  return sdk.getCurrentUser();
+}
+async function getPersonWithDetails(sdk, personId) {
+  try {
+    const [details, notes] = await Promise.all([
+      sdk.getPersonWithDetails(personId),
+      sdk.getPersonNotes(personId)
+    ]);
+    if (!details) {
+      return null;
+    }
+    const fullDetails = details;
+    const personData = fullDetails?.persons?.[0];
+    if (!personData) {
+      return null;
+    }
+    return {
+      ...personData,
+      fullDetails,
+      notes
+    };
+  } catch {
+    return null;
+  }
+}
+async function fetchMultiplePersons(sdk, personIds) {
+  const pids = personIds.join(",");
+  const response = await sdk.get(`/platform/tree/persons?pids=${pids}`);
+  return response.data;
+}
+
+export { fetchMultiplePersons, fetchPedigree, getCurrentUser, getPersonWithDetails };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/tree/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tree/pedigree.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * FamilySearch Tree/Pedigree API Module\n *\n * Provides helpers for fetching and managing family tree data\n * including pedigree, ancestry, and relationship information.\n */\n\nimport type { FamilySearchSDK } from \"../client\";\nimport type {\n\tEnhancedPedigreeData,\n\tEnhancedPerson,\n\tFamilySearchUser,\n\tPedigreeData,\n\tProgressCallback,\n\tRelationship,\n} from \"../types\";\n\n/**\n * Fetch pedigree/ancestry data with enhanced details\n *\n * @param sdk - FamilySearch SDK instance\n * @param personId - Optional person ID to start from. If not provided, uses current user.\n * @param options - Fetch options\n * @returns Promise with enhanced pedigree data\n *\n * @example\n * ```typescript\n * const pedigree = await fetchPedigree(sdk, \"XXXX-YYY\", {\n *   generations: 5,\n *   onProgress: (p) => console.log(`${p.percent}% complete`)\n * });\n * ```\n */\nexport async function fetchPedigree(\n\tsdk: FamilySearchSDK,\n\tpersonId?: string,\n\toptions: {\n\t\tgenerations?: number;\n\t\tonProgress?: ProgressCallback;\n\t\tincludeDetails?: boolean;\n\t\tincludeNotes?: boolean;\n\t\tincludeRelationshipDetails?: boolean;\n\t} = {}\n): Promise<EnhancedPedigreeData> {\n\tconst {\n\t\tgenerations = 4,\n\t\tonProgress,\n\t\tincludeDetails = true,\n\t\tincludeNotes = true,\n\t\tincludeRelationshipDetails = true,\n\t} = options;\n\n\t// Get current user's person ID if not provided\n\tlet targetPersonId = personId;\n\tif (!targetPersonId) {\n\t\tonProgress?.({\n\t\t\tstage: \"getting_current_user\",\n\t\t\tcurrent: 0,\n\t\t\ttotal: 1,\n\t\t\tpercent: 0,\n\t\t});\n\n\t\tconst currentUser = await sdk.getCurrentUser();\n\t\ttargetPersonId =\n\t\t\tcurrentUser?.personId ||\n\t\t\tcurrentUser?.treeUserId ||\n\t\t\tcurrentUser?.id;\n\n\t\tif (!targetPersonId) {\n\t\t\tthrow new Error(\"Could not determine person ID for current user\");\n\t\t}\n\t}\n\n\t// Step 1: Fetch ancestry structure\n\tonProgress?.({\n\t\tstage: \"fetching_ancestry_structure\",\n\t\tcurrent: 1,\n\t\ttotal: 3,\n\t\tpercent: 10,\n\t});\n\n\tconst ancestryResponse = await sdk.getAncestry(targetPersonId, generations);\n\tconst ancestry = ancestryResponse.data as PedigreeData;\n\n\tif (!ancestry.persons || ancestry.persons.length === 0) {\n\t\tthrow new Error(\"No persons found in ancestry\");\n\t}\n\n\t// Step 2: Enhance each person with detailed data\n\tonProgress?.({\n\t\tstage: \"fetching_person_details\",\n\t\tcurrent: 0,\n\t\ttotal: ancestry.persons.length,\n\t\tpercent: 20,\n\t});\n\n\tconst personsWithDetails: EnhancedPerson[] = [];\n\tfor (let i = 0; i < ancestry.persons.length; i++) {\n\t\tconst person = ancestry.persons[i];\n\n\t\tonProgress?.({\n\t\t\tstage: \"fetching_person_details\",\n\t\t\tcurrent: i + 1,\n\t\t\ttotal: ancestry.persons.length,\n\t\t\tpercent: 20 + Math.floor(((i + 1) / ancestry.persons.length) * 45),\n\t\t});\n\n\t\ttry {\n\t\t\tconst enhanced: EnhancedPerson = { ...person };\n\n\t\t\t// Fetch full person details with sources\n\t\t\tif (includeDetails) {\n\t\t\t\tenhanced.fullDetails = (await sdk.getPersonWithDetails(\n\t\t\t\t\tperson.id\n\t\t\t\t)) as EnhancedPerson[\"fullDetails\"];\n\t\t\t}\n\n\t\t\t// Fetch notes\n\t\t\tif (includeNotes) {\n\t\t\t\tenhanced.notes = (await sdk.getPersonNotes(\n\t\t\t\t\tperson.id\n\t\t\t\t)) as EnhancedPerson[\"notes\"];\n\t\t\t}\n\n\t\t\tpersonsWithDetails.push(enhanced);\n\t\t} catch {\n\t\t\t// Fallback to basic person data\n\t\t\tpersonsWithDetails.push(person as EnhancedPerson);\n\t\t}\n\t}\n\n\t// Step 3: Enhance couple relationships with marriage details\n\tonProgress?.({\n\t\tstage: \"fetching_relationship_details\",\n\t\tcurrent: 0,\n\t\ttotal: ancestry.relationships?.length || 0,\n\t\tpercent: 65,\n\t});\n\n\tconst relationshipsWithDetails: Relationship[] = [];\n\tif (ancestry.relationships && includeRelationshipDetails) {\n\t\tfor (let i = 0; i < ancestry.relationships.length; i++) {\n\t\t\tconst rel = ancestry.relationships[i];\n\n\t\t\tonProgress?.({\n\t\t\t\tstage: \"fetching_relationship_details\",\n\t\t\t\tcurrent: i + 1,\n\t\t\t\ttotal: ancestry.relationships.length,\n\t\t\t\tpercent:\n\t\t\t\t\t65 +\n\t\t\t\t\tMath.floor(((i + 1) / ancestry.relationships.length) * 25),\n\t\t\t});\n\n\t\t\ttry {\n\t\t\t\t// Only fetch details for couple relationships\n\t\t\t\tif (rel.type?.includes?.(\"Couple\")) {\n\t\t\t\t\tconst relDetails = await sdk.getCoupleRelationship(rel.id);\n\t\t\t\t\trelationshipsWithDetails.push({\n\t\t\t\t\t\t...rel,\n\t\t\t\t\t\tdetails: relDetails as Relationship[\"details\"],\n\t\t\t\t\t});\n\t\t\t\t} else {\n\t\t\t\t\trelationshipsWithDetails.push(rel);\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\trelationshipsWithDetails.push(rel);\n\t\t\t}\n\t\t}\n\t} else if (ancestry.relationships) {\n\t\trelationshipsWithDetails.push(...ancestry.relationships);\n\t}\n\n\t// Step 4: Extract additional relationships from person details\n\tonProgress?.({\n\t\tstage: \"extracting_additional_relationships\",\n\t\tcurrent: 0,\n\t\ttotal: 1,\n\t\tpercent: 90,\n\t});\n\n\tconst allRelationships = [...relationshipsWithDetails];\n\tconst relationshipIds = new Set(relationshipsWithDetails.map((r) => r.id));\n\n\tpersonsWithDetails.forEach((person) => {\n\t\t// Extract child-parent relationships from person details\n\t\tconst childAndParentsRels =\n\t\t\tperson.fullDetails?.childAndParentsRelationships;\n\t\tif (childAndParentsRels && Array.isArray(childAndParentsRels)) {\n\t\t\tchildAndParentsRels.forEach((rel) => {\n\t\t\t\tif (!relationshipIds.has(rel.id)) {\n\t\t\t\t\trelationshipIds.add(rel.id);\n\t\t\t\t\tallRelationships.push({\n\t\t\t\t\t\tid: rel.id,\n\t\t\t\t\t\ttype: \"http://gedcomx.org/ParentChild\",\n\t\t\t\t\t\tperson1: rel.parent1,\n\t\t\t\t\t\tperson2: rel.child,\n\t\t\t\t\t\tparent2: rel.parent2,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\n\t\t// Extract couple relationships from person details\n\t\tconst relationships = person.fullDetails?.relationships;\n\t\tif (relationships && Array.isArray(relationships)) {\n\t\t\trelationships.forEach((rel) => {\n\t\t\t\tif (rel.type?.includes?.(\"Couple\") && !relationshipIds.has(rel.id)) {\n\t\t\t\t\trelationshipIds.add(rel.id);\n\t\t\t\t\tallRelationships.push({\n\t\t\t\t\t\tid: rel.id,\n\t\t\t\t\t\ttype: rel.type,\n\t\t\t\t\t\tperson1: rel.person1,\n\t\t\t\t\t\tperson2: rel.person2,\n\t\t\t\t\t\tfacts: rel.facts,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t});\n\n\tonProgress?.({\n\t\tstage: \"completing_data_fetch\",\n\t\tcurrent: 1,\n\t\ttotal: 1,\n\t\tpercent: 98,\n\t});\n\n\treturn {\n\t\tpersons: personsWithDetails,\n\t\trelationships: allRelationships,\n\t\tenvironment: sdk.getEnvironment(),\n\t};\n}\n\n/**\n * Get current user information\n */\nexport async function getCurrentUser(\n\tsdk: FamilySearchSDK\n): Promise<FamilySearchUser | null> {\n\treturn sdk.getCurrentUser();\n}\n\n/**\n * Get person by ID with full details\n */\nexport async function getPersonWithDetails(\n\tsdk: FamilySearchSDK,\n\tpersonId: string\n): Promise<EnhancedPerson | null> {\n\ttry {\n\t\tconst [details, notes] = await Promise.all([\n\t\t\tsdk.getPersonWithDetails(personId),\n\t\t\tsdk.getPersonNotes(personId),\n\t\t]);\n\n\t\tif (!details) {\n\t\t\treturn null;\n\t\t}\n\n\t\t// The details response contains the person data in persons array\n\t\tconst fullDetails = details as EnhancedPerson[\"fullDetails\"];\n\t\tconst personData = fullDetails?.persons?.[0];\n\n\t\tif (!personData) {\n\t\t\treturn null;\n\t\t}\n\n\t\treturn {\n\t\t\t...personData,\n\t\t\tfullDetails: fullDetails,\n\t\t\tnotes: notes as EnhancedPerson[\"notes\"],\n\t\t};\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Fetch multiple persons at once\n */\nexport async function fetchMultiplePersons(\n\tsdk: FamilySearchSDK,\n\tpersonIds: string[]\n): Promise<unknown> {\n\tconst pids = personIds.join(\",\");\n\tconst response = await sdk.get(`/platform/tree/persons?pids=${pids}`);\n\treturn response.data;\n}\n"]}