@treeviz/familysearch-sdk 1.0.25 → 2.0.1

package/dist/auth/index.cjs

@@ -289,9 +289,111 @@ function clearAllTokens() {
     localStorage.removeItem(key);
   });
 }
+var OAuthAPI = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Get OAuth endpoints for current environment
+   */
+  getEndpoints() {
+    return getOAuthEndpoints(this.config.environment);
+  }
+  /**
+   * Generate a cryptographically secure random state
+   */
+  generateState() {
+    return generateOAuthState();
+  }
+  /**
+   * Build authorization URL
+   */
+  buildAuthorizationUrl(state, options) {
+    return buildAuthorizationUrl(this.config, state, options);
+  }
+  /**
+   * Exchange authorization code for access token
+   */
+  async exchangeCodeForToken(code) {
+    return exchangeCodeForToken(code, this.config);
+  }
+  /**
+   * Refresh an access token
+   */
+  async refreshAccessToken(refreshToken) {
+    return refreshAccessToken(refreshToken, this.config);
+  }
+  /**
+   * Validate an access token
+   */
+  async validateAccessToken(accessToken) {
+    return validateAccessToken(accessToken, this.config.environment);
+  }
+  /**
+   * Get user info from access token
+   */
+  async getUserInfo(accessToken) {
+    return getUserInfo(accessToken, this.config.environment);
+  }
+  /**
+   * Store OAuth state in localStorage
+   */
+  storeState(state, options) {
+    return storeOAuthState(state, options);
+  }
+  /**
+   * Validate OAuth state from callback
+   */
+  validateState(state) {
+    return validateOAuthState(state);
+  }
+  /**
+   * Open OAuth authorization in popup
+   */
+  openPopup(authUrl, options) {
+    return openOAuthPopup(authUrl, options);
+  }
+  /**
+   * Parse OAuth callback parameters from URL
+   */
+  parseCallbackParams(url) {
+    return parseCallbackParams(url);
+  }
+  /**
+   * Store tokens for a user
+   */
+  storeTokens(userId, tokens) {
+    return storeTokens(userId, tokens);
+  }
+  /**
+   * Get stored access token for a user
+   */
+  getStoredAccessToken(userId) {
+    return getStoredAccessToken(userId);
+  }
+  /**
+   * Get stored refresh token for a user
+   */
+  getStoredRefreshToken(userId) {
+    return getStoredRefreshToken(userId);
+  }
+  /**
+   * Clear all stored tokens for a user
+   */
+  clearStoredTokens(userId) {
+    return clearStoredTokens(userId);
+  }
+  /**
+   * Clear all FamilySearch tokens from storage
+   */
+  clearAllTokens() {
+    return clearAllTokens();
+  }
+};
 
 exports.OAUTH_ENDPOINTS = OAUTH_ENDPOINTS;
 exports.OAUTH_STORAGE_KEYS = OAUTH_STORAGE_KEYS;
+exports.OAuthAPI = OAuthAPI;
 exports.buildAuthorizationUrl = buildAuthorizationUrl;
 exports.clearAllTokens = clearAllTokens;
 exports.clearStoredTokens = clearStoredTokens;

package/dist/auth/index.d.cts

@@ -1,124 +1 @@
-import { F as FamilySearchEnvironment, B as OAuthEndpoints, D as OAuthConfig, O as OAuthTokenResponse, G as OAuthStateValidation } from '../index-DqPXkWyy.cjs';
-
-/**
- * FamilySearch OAuth Authentication Module
- *
- * Provides OAuth 2.0 authentication utilities for FamilySearch API v3.
- * This module is designed to be framework-agnostic and can be used
- * in any JavaScript/TypeScript environment.
- */
-
-declare const OAUTH_ENDPOINTS: Record<FamilySearchEnvironment, OAuthEndpoints>;
-/**
- * Get OAuth endpoints for a specific environment
- */
-declare function getOAuthEndpoints(environment?: FamilySearchEnvironment): OAuthEndpoints;
-/**
- * Generate a cryptographically secure random state for CSRF protection
- */
-declare function generateOAuthState(): string;
-/**
- * Build the authorization URL for OAuth flow
- */
-declare function buildAuthorizationUrl(config: OAuthConfig, state: string, options?: {
-    scopes?: string[];
-    prompt?: string;
-}): string;
-/**
- * Exchange authorization code for access token
- */
-declare function exchangeCodeForToken(code: string, config: OAuthConfig): Promise<OAuthTokenResponse>;
-/**
- * Refresh an access token using a refresh token
- */
-declare function refreshAccessToken(refreshToken: string, config: OAuthConfig): Promise<OAuthTokenResponse>;
-/**
- * Validate an access token by making a test API call
- */
-declare function validateAccessToken(accessToken: string, environment?: FamilySearchEnvironment): Promise<boolean>;
-/**
- * Get user info from access token
- */
-declare function getUserInfo(accessToken: string, environment?: FamilySearchEnvironment): Promise<{
-    sub: string;
-    name?: string;
-    given_name?: string;
-    family_name?: string;
-    email?: string;
-    email_verified?: boolean;
-} | null>;
-/**
- * Storage keys for OAuth state management
- */
-declare const OAUTH_STORAGE_KEYS: {
-    readonly state: "fs_oauth_state";
-    readonly linkMode: "fs_oauth_link_mode";
-    readonly lang: "fs_oauth_lang";
-    readonly parentUid: "fs_oauth_parent_uid";
-};
-/**
- * Store OAuth state in localStorage for popup flow
- * Uses localStorage instead of sessionStorage because popup windows
- * don't share sessionStorage with the parent window
- */
-declare function storeOAuthState(state: string, options?: {
-    isLinkMode?: boolean;
-    lang?: string;
-    parentUid?: string;
-}): void;
-/**
- * Validate OAuth state from callback and extract metadata
- * Returns invalid state if localStorage is not available (SSR/Node.js environments)
- */
-declare function validateOAuthState(state: string): OAuthStateValidation;
-/**
- * Open OAuth authorization in a popup window
- */
-declare function openOAuthPopup(authUrl: string, options?: {
-    width?: number;
-    height?: number;
-    windowName?: string;
-}): Window | null;
-/**
- * Parse OAuth callback parameters from URL
- */
-declare function parseCallbackParams(url?: string): {
-    code?: string;
-    state?: string;
-    error?: string;
-    error_description?: string;
-};
-/**
- * Generate a storage key scoped to a user ID
- */
-declare function getTokenStorageKey(userId: string, type: "access" | "expires" | "refresh" | "environment"): string;
-/**
- * Store access token with expiration
- * Per FamilySearch compatibility requirements:
- * - Access tokens stored in sessionStorage (cleared on browser close)
- * - Refresh tokens stored in localStorage (for re-authentication)
- */
-declare function storeTokens(userId: string, tokens: {
-    accessToken: string;
-    expiresAt?: number;
-    refreshToken?: string;
-    environment?: string;
-}): void;
-/**
- * Get stored access token
- */
-declare function getStoredAccessToken(userId: string): string | null;
-/**
- * Get stored refresh token
- */
-declare function getStoredRefreshToken(userId: string): string | null;
-/**
- * Clear all stored tokens for a user
- */
-declare function clearStoredTokens(userId: string): void;
-/**
- * Clear all FamilySearch tokens from storage
- */
-declare function clearAllTokens(): void;
-
-export { OAUTH_ENDPOINTS, OAUTH_STORAGE_KEYS, buildAuthorizationUrl, clearAllTokens, clearStoredTokens, exchangeCodeForToken, generateOAuthState, getOAuthEndpoints, getStoredAccessToken, getStoredRefreshToken, getTokenStorageKey, getUserInfo, openOAuthPopup, parseCallbackParams, refreshAccessToken, storeOAuthState, storeTokens, validateAccessToken, validateOAuthState };
+export { y as OAUTH_ENDPOINTS, l as OAUTH_STORAGE_KEYS, z as OAuthAPI, i as buildAuthorizationUrl, x as clearAllTokens, w as clearStoredTokens, j as exchangeCodeForToken, h as generateOAuthState, g as getOAuthEndpoints, t as getStoredAccessToken, u as getStoredRefreshToken, n as getTokenStorageKey, k as getUserInfo, o as openOAuthPopup, p as parseCallbackParams, r as refreshAccessToken, s as storeOAuthState, q as storeTokens, v as validateAccessToken, m as validateOAuthState } from '../index-D-O_e-PM.cjs';

package/dist/auth/index.d.ts

@@ -1,124 +1 @@
-import { F as FamilySearchEnvironment, B as OAuthEndpoints, D as OAuthConfig, O as OAuthTokenResponse, G as OAuthStateValidation } from '../index-DqPXkWyy.js';
-
-/**
- * FamilySearch OAuth Authentication Module
- *
- * Provides OAuth 2.0 authentication utilities for FamilySearch API v3.
- * This module is designed to be framework-agnostic and can be used
- * in any JavaScript/TypeScript environment.
- */
-
-declare const OAUTH_ENDPOINTS: Record<FamilySearchEnvironment, OAuthEndpoints>;
-/**
- * Get OAuth endpoints for a specific environment
- */
-declare function getOAuthEndpoints(environment?: FamilySearchEnvironment): OAuthEndpoints;
-/**
- * Generate a cryptographically secure random state for CSRF protection
- */
-declare function generateOAuthState(): string;
-/**
- * Build the authorization URL for OAuth flow
- */
-declare function buildAuthorizationUrl(config: OAuthConfig, state: string, options?: {
-    scopes?: string[];
-    prompt?: string;
-}): string;
-/**
- * Exchange authorization code for access token
- */
-declare function exchangeCodeForToken(code: string, config: OAuthConfig): Promise<OAuthTokenResponse>;
-/**
- * Refresh an access token using a refresh token
- */
-declare function refreshAccessToken(refreshToken: string, config: OAuthConfig): Promise<OAuthTokenResponse>;
-/**
- * Validate an access token by making a test API call
- */
-declare function validateAccessToken(accessToken: string, environment?: FamilySearchEnvironment): Promise<boolean>;
-/**
- * Get user info from access token
- */
-declare function getUserInfo(accessToken: string, environment?: FamilySearchEnvironment): Promise<{
-    sub: string;
-    name?: string;
-    given_name?: string;
-    family_name?: string;
-    email?: string;
-    email_verified?: boolean;
-} | null>;
-/**
- * Storage keys for OAuth state management
- */
-declare const OAUTH_STORAGE_KEYS: {
-    readonly state: "fs_oauth_state";
-    readonly linkMode: "fs_oauth_link_mode";
-    readonly lang: "fs_oauth_lang";
-    readonly parentUid: "fs_oauth_parent_uid";
-};
-/**
- * Store OAuth state in localStorage for popup flow
- * Uses localStorage instead of sessionStorage because popup windows
- * don't share sessionStorage with the parent window
- */
-declare function storeOAuthState(state: string, options?: {
-    isLinkMode?: boolean;
-    lang?: string;
-    parentUid?: string;
-}): void;
-/**
- * Validate OAuth state from callback and extract metadata
- * Returns invalid state if localStorage is not available (SSR/Node.js environments)
- */
-declare function validateOAuthState(state: string): OAuthStateValidation;
-/**
- * Open OAuth authorization in a popup window
- */
-declare function openOAuthPopup(authUrl: string, options?: {
-    width?: number;
-    height?: number;
-    windowName?: string;
-}): Window | null;
-/**
- * Parse OAuth callback parameters from URL
- */
-declare function parseCallbackParams(url?: string): {
-    code?: string;
-    state?: string;
-    error?: string;
-    error_description?: string;
-};
-/**
- * Generate a storage key scoped to a user ID
- */
-declare function getTokenStorageKey(userId: string, type: "access" | "expires" | "refresh" | "environment"): string;
-/**
- * Store access token with expiration
- * Per FamilySearch compatibility requirements:
- * - Access tokens stored in sessionStorage (cleared on browser close)
- * - Refresh tokens stored in localStorage (for re-authentication)
- */
-declare function storeTokens(userId: string, tokens: {
-    accessToken: string;
-    expiresAt?: number;
-    refreshToken?: string;
-    environment?: string;
-}): void;
-/**
- * Get stored access token
- */
-declare function getStoredAccessToken(userId: string): string | null;
-/**
- * Get stored refresh token
- */
-declare function getStoredRefreshToken(userId: string): string | null;
-/**
- * Clear all stored tokens for a user
- */
-declare function clearStoredTokens(userId: string): void;
-/**
- * Clear all FamilySearch tokens from storage
- */
-declare function clearAllTokens(): void;
-
-export { OAUTH_ENDPOINTS, OAUTH_STORAGE_KEYS, buildAuthorizationUrl, clearAllTokens, clearStoredTokens, exchangeCodeForToken, generateOAuthState, getOAuthEndpoints, getStoredAccessToken, getStoredRefreshToken, getTokenStorageKey, getUserInfo, openOAuthPopup, parseCallbackParams, refreshAccessToken, storeOAuthState, storeTokens, validateAccessToken, validateOAuthState };
+export { y as OAUTH_ENDPOINTS, l as OAUTH_STORAGE_KEYS, z as OAuthAPI, i as buildAuthorizationUrl, x as clearAllTokens, w as clearStoredTokens, j as exchangeCodeForToken, h as generateOAuthState, g as getOAuthEndpoints, t as getStoredAccessToken, u as getStoredRefreshToken, n as getTokenStorageKey, k as getUserInfo, o as openOAuthPopup, p as parseCallbackParams, r as refreshAccessToken, s as storeOAuthState, q as storeTokens, v as validateAccessToken, m as validateOAuthState } from '../index-D-O_e-PM.js';

package/dist/auth/index.js

@@ -287,5 +287,106 @@ function clearAllTokens() {
     localStorage.removeItem(key);
   });
 }
+var OAuthAPI = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Get OAuth endpoints for current environment
+   */
+  getEndpoints() {
+    return getOAuthEndpoints(this.config.environment);
+  }
+  /**
+   * Generate a cryptographically secure random state
+   */
+  generateState() {
+    return generateOAuthState();
+  }
+  /**
+   * Build authorization URL
+   */
+  buildAuthorizationUrl(state, options) {
+    return buildAuthorizationUrl(this.config, state, options);
+  }
+  /**
+   * Exchange authorization code for access token
+   */
+  async exchangeCodeForToken(code) {
+    return exchangeCodeForToken(code, this.config);
+  }
+  /**
+   * Refresh an access token
+   */
+  async refreshAccessToken(refreshToken) {
+    return refreshAccessToken(refreshToken, this.config);
+  }
+  /**
+   * Validate an access token
+   */
+  async validateAccessToken(accessToken) {
+    return validateAccessToken(accessToken, this.config.environment);
+  }
+  /**
+   * Get user info from access token
+   */
+  async getUserInfo(accessToken) {
+    return getUserInfo(accessToken, this.config.environment);
+  }
+  /**
+   * Store OAuth state in localStorage
+   */
+  storeState(state, options) {
+    return storeOAuthState(state, options);
+  }
+  /**
+   * Validate OAuth state from callback
+   */
+  validateState(state) {
+    return validateOAuthState(state);
+  }
+  /**
+   * Open OAuth authorization in popup
+   */
+  openPopup(authUrl, options) {
+    return openOAuthPopup(authUrl, options);
+  }
+  /**
+   * Parse OAuth callback parameters from URL
+   */
+  parseCallbackParams(url) {
+    return parseCallbackParams(url);
+  }
+  /**
+   * Store tokens for a user
+   */
+  storeTokens(userId, tokens) {
+    return storeTokens(userId, tokens);
+  }
+  /**
+   * Get stored access token for a user
+   */
+  getStoredAccessToken(userId) {
+    return getStoredAccessToken(userId);
+  }
+  /**
+   * Get stored refresh token for a user
+   */
+  getStoredRefreshToken(userId) {
+    return getStoredRefreshToken(userId);
+  }
+  /**
+   * Clear all stored tokens for a user
+   */
+  clearStoredTokens(userId) {
+    return clearStoredTokens(userId);
+  }
+  /**
+   * Clear all FamilySearch tokens from storage
+   */
+  clearAllTokens() {
+    return clearAllTokens();
+  }
+};
 
-export { OAUTH_ENDPOINTS, OAUTH_STORAGE_KEYS, buildAuthorizationUrl, clearAllTokens, clearStoredTokens, exchangeCodeForToken, generateOAuthState, getOAuthEndpoints, getStoredAccessToken, getStoredRefreshToken, getTokenStorageKey, getUserInfo, openOAuthPopup, parseCallbackParams, refreshAccessToken, storeOAuthState, storeTokens, validateAccessToken, validateOAuthState };
+export { OAUTH_ENDPOINTS, OAUTH_STORAGE_KEYS, OAuthAPI, buildAuthorizationUrl, clearAllTokens, clearStoredTokens, exchangeCodeForToken, generateOAuthState, getOAuthEndpoints, getStoredAccessToken, getStoredRefreshToken, getTokenStorageKey, getUserInfo, openOAuthPopup, parseCallbackParams, refreshAccessToken, storeOAuthState, storeTokens, validateAccessToken, validateOAuthState };