@treeviz/familysearch-sdk 1.0.10

package/dist/client-DIpYSHtx.d.ts

@@ -0,0 +1,162 @@
+import { a as FamilySearchSDKConfig, F as FamilySearchEnvironment, E as EnvironmentConfig, b as FamilySearchApiResponse, d as FamilySearchUser, e as FamilySearchPerson, i as PersonWithRelationships, j as PersonNotesResponse, w as PersonMemoriesResponse, h as RelationshipDetails, p as PedigreeData, x as PersonSearchResponse, k as FamilySearchPlace } from './index-D6H-lvis.js';
+
+/**
+ * FamilySearch SDK Client
+ *
+ * A modern, TypeScript-first SDK for FamilySearch API v3
+ *
+ * Features:
+ * - Full TypeScript support with comprehensive type definitions
+ * - OAuth v3 compatible
+ * - Promise-based API
+ * - Environment support (production, beta, integration)
+ * - Configurable logging
+ */
+
+declare const ENVIRONMENT_CONFIGS: Record<FamilySearchEnvironment, EnvironmentConfig>;
+/**
+ * FamilySearch SDK Client
+ *
+ * @example
+ * ```typescript
+ * const sdk = new FamilySearchSDK({
+ *   environment: 'production',
+ *   accessToken: 'your-oauth-token'
+ * });
+ *
+ * const user = await sdk.getCurrentUser();
+ * console.log(user?.displayName);
+ * ```
+ */
+declare class FamilySearchSDK {
+    private environment;
+    private accessToken;
+    private appKey;
+    private logger;
+    constructor(config?: FamilySearchSDKConfig);
+    /**
+     * Get the current environment
+     */
+    getEnvironment(): FamilySearchEnvironment;
+    /**
+     * Set OAuth access token
+     */
+    setAccessToken(token: string): void;
+    /**
+     * Get current access token
+     */
+    getAccessToken(): string | null;
+    /**
+     * Clear access token
+     */
+    clearAccessToken(): void;
+    /**
+     * Check if SDK has a valid access token
+     */
+    hasAccessToken(): boolean;
+    /**
+     * Get environment configuration
+     */
+    getConfig(): EnvironmentConfig;
+    /**
+     * Make authenticated API request
+     */
+    private request;
+    /**
+     * GET request
+     */
+    get<T>(url: string, options?: RequestInit): Promise<FamilySearchApiResponse<T>>;
+    /**
+     * POST request
+     */
+    post<T>(url: string, body?: unknown, options?: RequestInit): Promise<FamilySearchApiResponse<T>>;
+    /**
+     * PUT request
+     */
+    put<T>(url: string, body?: unknown, options?: RequestInit): Promise<FamilySearchApiResponse<T>>;
+    /**
+     * DELETE request
+     */
+    delete<T>(url: string, options?: RequestInit): Promise<FamilySearchApiResponse<T>>;
+    /**
+     * Get current authenticated user
+     */
+    getCurrentUser(): Promise<FamilySearchUser | null>;
+    /**
+     * Get person by ID
+     */
+    getPerson(personId: string): Promise<FamilySearchPerson | null>;
+    /**
+     * Get person with full details including sources
+     */
+    getPersonWithDetails(personId: string): Promise<PersonWithRelationships | null>;
+    /**
+     * Get notes for a person
+     */
+    getPersonNotes(personId: string): Promise<PersonNotesResponse | null>;
+    /**
+     * Get memories for a person
+     */
+    getPersonMemories(personId: string): Promise<PersonMemoriesResponse | null>;
+    /**
+     * Get couple relationship details
+     */
+    getCoupleRelationship(relationshipId: string): Promise<RelationshipDetails | null>;
+    /**
+     * Get child-and-parents relationship details
+     */
+    getChildAndParentsRelationship(relationshipId: string): Promise<RelationshipDetails | null>;
+    /**
+     * Get ancestry for a person
+     */
+    getAncestry(personId: string, generations?: number): Promise<FamilySearchApiResponse<PedigreeData>>;
+    /**
+     * Get descendancy for a person
+     */
+    getDescendancy(personId: string, generations?: number): Promise<FamilySearchApiResponse<PedigreeData>>;
+    /**
+     * Search for persons
+     */
+    searchPersons(query: Record<string, string>, options?: {
+        start?: number;
+        count?: number;
+    }): Promise<FamilySearchApiResponse<PersonSearchResponse>>;
+    /**
+     * Search for places
+     */
+    searchPlaces(name: string, options?: {
+        parentId?: string;
+        typeId?: string;
+        date?: string;
+        start?: number;
+        count?: number;
+    }): Promise<{
+        places: FamilySearchPlace[];
+    } | null>;
+    /**
+     * Get place by ID
+     */
+    getPlace(placeId: string): Promise<FamilySearchPlace | null>;
+    /**
+     * Get GEDCOM export for a person and their ancestors
+     */
+    exportGEDCOM(personId: string): Promise<string | null>;
+}
+/**
+ * Initialize the global SDK instance
+ */
+declare function initFamilySearchSDK(config?: FamilySearchSDKConfig): FamilySearchSDK;
+/**
+ * Get the global SDK instance
+ */
+declare function getFamilySearchSDK(): FamilySearchSDK;
+/**
+ * Create a new SDK instance (for testing or multiple environments)
+ */
+declare function createFamilySearchSDK(config?: FamilySearchSDKConfig): FamilySearchSDK;
+/**
+ * Reset the global SDK instance (mainly for testing)
+ */
+declare function resetFamilySearchSDK(): void;
+
+export { ENVIRONMENT_CONFIGS as E, FamilySearchSDK as F, createFamilySearchSDK as c, getFamilySearchSDK as g, initFamilySearchSDK as i, resetFamilySearchSDK as r };

package/dist/client-ohjqX4t5.d.cts

@@ -0,0 +1,162 @@
+import { a as FamilySearchSDKConfig, F as FamilySearchEnvironment, E as EnvironmentConfig, b as FamilySearchApiResponse, d as FamilySearchUser, e as FamilySearchPerson, i as PersonWithRelationships, j as PersonNotesResponse, w as PersonMemoriesResponse, h as RelationshipDetails, p as PedigreeData, x as PersonSearchResponse, k as FamilySearchPlace } from './index-D6H-lvis.cjs';
+
+/**
+ * FamilySearch SDK Client
+ *
+ * A modern, TypeScript-first SDK for FamilySearch API v3
+ *
+ * Features:
+ * - Full TypeScript support with comprehensive type definitions
+ * - OAuth v3 compatible
+ * - Promise-based API
+ * - Environment support (production, beta, integration)
+ * - Configurable logging
+ */
+
+declare const ENVIRONMENT_CONFIGS: Record<FamilySearchEnvironment, EnvironmentConfig>;
+/**
+ * FamilySearch SDK Client
+ *
+ * @example
+ * ```typescript
+ * const sdk = new FamilySearchSDK({
+ *   environment: 'production',
+ *   accessToken: 'your-oauth-token'
+ * });
+ *
+ * const user = await sdk.getCurrentUser();
+ * console.log(user?.displayName);
+ * ```
+ */
+declare class FamilySearchSDK {
+    private environment;
+    private accessToken;
+    private appKey;
+    private logger;
+    constructor(config?: FamilySearchSDKConfig);
+    /**
+     * Get the current environment
+     */
+    getEnvironment(): FamilySearchEnvironment;
+    /**
+     * Set OAuth access token
+     */
+    setAccessToken(token: string): void;
+    /**
+     * Get current access token
+     */
+    getAccessToken(): string | null;
+    /**
+     * Clear access token
+     */
+    clearAccessToken(): void;
+    /**
+     * Check if SDK has a valid access token
+     */
+    hasAccessToken(): boolean;
+    /**
+     * Get environment configuration
+     */
+    getConfig(): EnvironmentConfig;
+    /**
+     * Make authenticated API request
+     */
+    private request;
+    /**
+     * GET request
+     */
+    get<T>(url: string, options?: RequestInit): Promise<FamilySearchApiResponse<T>>;
+    /**
+     * POST request
+     */
+    post<T>(url: string, body?: unknown, options?: RequestInit): Promise<FamilySearchApiResponse<T>>;
+    /**
+     * PUT request
+     */
+    put<T>(url: string, body?: unknown, options?: RequestInit): Promise<FamilySearchApiResponse<T>>;
+    /**
+     * DELETE request
+     */
+    delete<T>(url: string, options?: RequestInit): Promise<FamilySearchApiResponse<T>>;
+    /**
+     * Get current authenticated user
+     */
+    getCurrentUser(): Promise<FamilySearchUser | null>;
+    /**
+     * Get person by ID
+     */
+    getPerson(personId: string): Promise<FamilySearchPerson | null>;
+    /**
+     * Get person with full details including sources
+     */
+    getPersonWithDetails(personId: string): Promise<PersonWithRelationships | null>;
+    /**
+     * Get notes for a person
+     */
+    getPersonNotes(personId: string): Promise<PersonNotesResponse | null>;
+    /**
+     * Get memories for a person
+     */
+    getPersonMemories(personId: string): Promise<PersonMemoriesResponse | null>;
+    /**
+     * Get couple relationship details
+     */
+    getCoupleRelationship(relationshipId: string): Promise<RelationshipDetails | null>;
+    /**
+     * Get child-and-parents relationship details
+     */
+    getChildAndParentsRelationship(relationshipId: string): Promise<RelationshipDetails | null>;
+    /**
+     * Get ancestry for a person
+     */
+    getAncestry(personId: string, generations?: number): Promise<FamilySearchApiResponse<PedigreeData>>;
+    /**
+     * Get descendancy for a person
+     */
+    getDescendancy(personId: string, generations?: number): Promise<FamilySearchApiResponse<PedigreeData>>;
+    /**
+     * Search for persons
+     */
+    searchPersons(query: Record<string, string>, options?: {
+        start?: number;
+        count?: number;
+    }): Promise<FamilySearchApiResponse<PersonSearchResponse>>;
+    /**
+     * Search for places
+     */
+    searchPlaces(name: string, options?: {
+        parentId?: string;
+        typeId?: string;
+        date?: string;
+        start?: number;
+        count?: number;
+    }): Promise<{
+        places: FamilySearchPlace[];
+    } | null>;
+    /**
+     * Get place by ID
+     */
+    getPlace(placeId: string): Promise<FamilySearchPlace | null>;
+    /**
+     * Get GEDCOM export for a person and their ancestors
+     */
+    exportGEDCOM(personId: string): Promise<string | null>;
+}
+/**
+ * Initialize the global SDK instance
+ */
+declare function initFamilySearchSDK(config?: FamilySearchSDKConfig): FamilySearchSDK;
+/**
+ * Get the global SDK instance
+ */
+declare function getFamilySearchSDK(): FamilySearchSDK;
+/**
+ * Create a new SDK instance (for testing or multiple environments)
+ */
+declare function createFamilySearchSDK(config?: FamilySearchSDKConfig): FamilySearchSDK;
+/**
+ * Reset the global SDK instance (mainly for testing)
+ */
+declare function resetFamilySearchSDK(): void;
+
+export { ENVIRONMENT_CONFIGS as E, FamilySearchSDK as F, createFamilySearchSDK as c, getFamilySearchSDK as g, initFamilySearchSDK as i, resetFamilySearchSDK as r };