@nauth-toolkit/social-facebook 0.1.13 → 0.1.17

package/dist/src/dto/social-login.dto.js

@@ -11,14 +11,45 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SocialAccountsResponseDTO = exports.SocialLoginResponseDTO = exports.UnlinkSocialAccountDTO = exports.LinkSocialAccountDTO = exports.SocialCallbackDTO = exports.SocialLoginDTO = exports.SocialProvider = void 0;
 const class_validator_1 = require("class-validator");
+/**
+ * Social provider enum
+ */
 var SocialProvider;
 (function (SocialProvider) {
     SocialProvider["GOOGLE"] = "google";
     SocialProvider["APPLE"] = "apple";
     SocialProvider["FACEBOOK"] = "facebook";
 })(SocialProvider || (exports.SocialProvider = SocialProvider = {}));
+/**
+ * DTO for initiating social login
+ * Used to generate OAuth URLs for social providers
+ *
+ * @example
+ * ```typescript
+ * // Generate Google OAuth URL
+ * const dto = new SocialLoginDTO();
+ * dto.provider = 'google';
+ * dto.state = 'random-state-string';
+ * ```
+ */
 class SocialLoginDTO {
+    /**
+     * Social provider name
+     * Must be one of the configured providers
+     *
+     * Validation:
+     * - Must be a valid SocialProvider enum value
+     */
     provider;
+    /**
+     * Optional state parameter for OAuth flow
+     * Used to prevent CSRF attacks and maintain state
+     * If not provided, a random state will be generated
+     *
+     * Validation:
+     * - Must be a string if present
+     * - Max 2000 characters (typical OAuth state length)
+     */
     state;
 }
 exports.SocialLoginDTO = SocialLoginDTO;
@@ -32,11 +63,63 @@ __decorate([
     (0, class_validator_1.MaxLength)(2000, { message: 'State must not exceed 2000 characters' }),
     __metadata("design:type", String)
 ], SocialLoginDTO.prototype, "state", void 0);
+/**
+ * DTO for handling OAuth callback
+ * Used to process the authorization code from OAuth providers
+ *
+ * @example
+ * ```typescript
+ * // Handle Google OAuth callback
+ * const dto = new SocialCallbackDTO();
+ * dto.provider = 'google';
+ * dto.code = 'authorization-code-from-google';
+ * dto.state = 'state-from-initial-request';
+ * ```
+ */
 class SocialCallbackDTO {
+    /**
+     * Social provider name
+     * Must match the provider used in the initial request
+     *
+     * Validation:
+     * - Must be a valid SocialProvider enum value
+     */
     provider;
+    /**
+     * Authorization code from OAuth provider
+     * This code is exchanged for access token and user info
+     *
+     * Validation:
+     * - Must be a string
+     * - Max 1000 characters (typical OAuth code length)
+     */
     code;
+    /**
+     * State parameter from OAuth flow
+     * Must match the state sent in the initial request
+     *
+     * Validation:
+     * - Must be a string
+     * - Max 500 characters (typical OAuth state length)
+     */
     state;
+    /**
+     * Optional error parameter from OAuth provider
+     * Used when user denies permission or other errors occur
+     *
+     * Validation:
+     * - Must be a string if present
+     * - Max 100 characters
+     */
     error;
+    /**
+     * Optional error description from OAuth provider
+     * Provides more details about the error
+     *
+     * Validation:
+     * - Must be a string if present
+     * - Max 500 characters
+     */
     error_description;
 }
 exports.SocialCallbackDTO = SocialCallbackDTO;
@@ -68,9 +151,45 @@ __decorate([
     (0, class_validator_1.MaxLength)(500, { message: 'Error description must not exceed 500 characters' }),
     __metadata("design:type", String)
 ], SocialCallbackDTO.prototype, "error_description", void 0);
+/**
+ * DTO for linking social account to existing user
+ * Used when an authenticated user wants to link a social provider
+ *
+ * @example
+ * ```typescript
+ * // Link Google account to current user
+ * const dto = new LinkSocialAccountDTO();
+ * dto.provider = 'google';
+ * dto.code = 'authorization-code-from-google';
+ * dto.state = 'state-from-initial-request';
+ * ```
+ */
 class LinkSocialAccountDTO {
+    /**
+     * Social provider name
+     * Must be one of the configured providers
+     *
+     * Validation:
+     * - Must be a valid SocialProvider enum value
+     */
     provider;
+    /**
+     * Authorization code from OAuth provider
+     * This code is exchanged for access token and user info
+     *
+     * Validation:
+     * - Must be a string
+     * - Max 1000 characters (typical OAuth code length)
+     */
     code;
+    /**
+     * State parameter from OAuth flow
+     * Must match the state sent in the initial request
+     *
+     * Validation:
+     * - Must be a string
+     * - Max 500 characters (typical OAuth state length)
+     */
     state;
 }
 exports.LinkSocialAccountDTO = LinkSocialAccountDTO;
@@ -90,7 +209,25 @@ __decorate([
     (0, class_validator_1.MaxLength)(500, { message: 'State must not exceed 500 characters' }),
     __metadata("design:type", String)
 ], LinkSocialAccountDTO.prototype, "state", void 0);
+/**
+ * DTO for unlinking social account
+ * Used when an authenticated user wants to remove a social provider
+ *
+ * @example
+ * ```typescript
+ * // Unlink Google account from current user
+ * const dto = new UnlinkSocialAccountDTO();
+ * dto.provider = 'google';
+ * ```
+ */
 class UnlinkSocialAccountDTO {
+    /**
+     * Social provider name to unlink
+     * Must be one of the currently linked providers
+     *
+     * Validation:
+     * - Must be a valid SocialProvider enum value
+     */
     provider;
 }
 exports.UnlinkSocialAccountDTO = UnlinkSocialAccountDTO;
@@ -98,11 +235,71 @@ __decorate([
     (0, class_validator_1.IsEnum)(SocialProvider, { message: 'Provider must be one of: google, apple, facebook' }),
     __metadata("design:type", String)
 ], UnlinkSocialAccountDTO.prototype, "provider", void 0);
+/**
+ * Response DTO for social login
+ * Contains authentication tokens and user information
+ *
+ * @example
+ * ```typescript
+ * // Response after successful social login
+ * {
+ *   "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+ *   "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+ *   "expiresIn": 900,
+ *   "user": {
+ *     "sub": "user-uuid",
+ *     "email": "user@example.com",
+ *     "firstName": "John",
+ *     "lastName": "Doe",
+ *     "isEmailVerified": true,
+ *     "socialProviders": ["google"]
+ *   }
+ * }
+ * ```
+ */
 class SocialLoginResponseDTO {
+    /**
+     * JWT access token for API authentication
+     *
+     * Validation:
+     * - Must be a string
+     * - Max 2048 characters (typical JWT length)
+     */
     accessToken;
+    /**
+     * JWT refresh token for token renewal
+     *
+     * Validation:
+     * - Must be a string
+     * - Max 2048 characters (typical JWT length)
+     */
     refreshToken;
+    /**
+     * Access token expiration timestamp (Unix timestamp in seconds)
+     *
+     * Validation:
+     * - Must be a number
+     */
     accessTokenExpiresAt;
+    /**
+     * Refresh token expiration timestamp (Unix timestamp in seconds)
+     *
+     * Validation:
+     * - Must be a number
+     */
     refreshTokenExpiresAt;
+    /**
+     * User information
+     *
+     * Validation:
+     * - Nested fields validated in service layer:
+     *   - sub: UUID v4 format, max 36 chars
+     *   - email: Valid email format, max 255 chars
+     *   - firstName: String, max 100 chars
+     *   - lastName: String, max 100 chars
+     *   - isEmailVerified: Boolean
+     *   - socialProviders: Array of strings, each max 50 chars
+     */
     user;
 }
 exports.SocialLoginResponseDTO = SocialLoginResponseDTO;
@@ -124,7 +321,29 @@ __decorate([
     (0, class_validator_1.IsNumber)({}, { message: 'Refresh token expiration must be a number' }),
     __metadata("design:type", Number)
 ], SocialLoginResponseDTO.prototype, "refreshTokenExpiresAt", void 0);
+/**
+ * Response DTO for social account information
+ * Contains details about linked social accounts
+ *
+ * @example
+ * ```typescript
+ * // Response for user's linked social accounts
+ * {
+ *   "accounts": [
+ *     {
+ *       "provider": "google",
+ *       "providerEmail": "user@gmail.com",
+ *       "linkedAt": "2023-01-01T00:00:00Z",
+ *       "lastUsedAt": "2023-01-15T12:00:00Z"
+ *     }
+ *   ]
+ * }
+ * ```
+ */
 class SocialAccountsResponseDTO {
+    /**
+     * Array of linked social accounts
+     */
     accounts;
 }
 exports.SocialAccountsResponseDTO = SocialAccountsResponseDTO;

package/dist/src/dto/social-login.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"social-login.dto.js","sourceRoot":"","sources":["../../../src/dto/social-login.dto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"social-login.dto.js","sourceRoot":"","sources":["../../../src/dto/social-login.dto.ts"],"names":[],"mappings":"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"}

package/dist/src/facebook-oauth.client.d.ts

@@ -1,15 +1,74 @@
 import { OAuthClient, OAuthConfig, OAuthUserProfile } from '@nauth-toolkit/core';
+/**
+ * Facebook OAuth Client Implementation (Platform-Agnostic)
+ *
+ * Handles OAuth flow with Facebook's Graph API
+ * Uses Facebook's Graph API for profile data
+ *
+ * This is a plain TypeScript class with no framework dependencies.
+ *
+ * @example
+ * ```typescript
+ * const client = new FacebookOAuthClient({
+ *   clientId: 'facebook_client_id',
+ *   clientSecret: 'facebook_client_secret',
+ *   redirectUri: 'https://myapp.com/auth/facebook/callback'
+ * });
+ *
+ * const profile = await client.getUserProfile(accessToken);
+ * ```
+ */
 export declare class FacebookOAuthClient implements OAuthClient {
     private readonly config;
     private readonly tokenEndpoint;
     private readonly userInfoEndpoint;
     constructor(config: OAuthConfig);
+    /**
+     * Exchange authorization code for access token
+     *
+     * @param code - Authorization code from Facebook OAuth callback
+     * @param redirectUri - Redirect URI used in OAuth flow
+     * @returns Access token and optional refresh token
+     * @throws {Error} When token exchange fails
+     *
+     * @example
+     * ```typescript
+     * const tokens = await client.exchangeCodeForToken(code, redirectUri);
+     * console.log(tokens.accessToken); // access_token_here
+     * ```
+     */
     exchangeCodeForToken(code: string, redirectUri: string): Promise<{
         accessToken: string;
         refreshToken?: string;
         expiresIn?: number;
     }>;
+    /**
+     * Get user profile from Facebook using access token
+     *
+     * @param accessToken - OAuth access token
+     * @returns User profile data
+     * @throws {Error} When API call fails or token is invalid
+     *
+     * @example
+     * ```typescript
+     * const profile = await client.getUserProfile(accessToken);
+     * console.log(profile.email); // user@facebook.com
+     * console.log(profile.firstName); // John
+     * ```
+     */
     getUserProfile(accessToken: string): Promise<OAuthUserProfile>;
+    /**
+     * Generate Facebook OAuth authorization URL
+     *
+     * @param state - Optional state parameter for CSRF protection
+     * @returns Authorization URL for redirecting user to Facebook
+     *
+     * @example
+     * ```typescript
+     * const authUrl = client.getAuthorizationUrl('random-state');
+     * // Redirect user to authUrl
+     * ```
+     */
     getAuthorizationUrl(state?: string): string;
 }
 //# sourceMappingURL=facebook-oauth.client.d.ts.map

package/dist/src/facebook-oauth.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"facebook-oauth.client.d.ts","sourceRoot":"","sources":["../../src/facebook-oauth.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAiC,MAAM,qBAAqB,CAAC;AAqBhH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyD;IACvF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyC;gBAE9D,MAAM,EAAE,WAAW;IAqBzB,oBAAoB,CACxB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QACT,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAqDI,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiEpE,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;CAc5C"}
+{"version":3,"file":"facebook-oauth.client.d.ts","sourceRoot":"","sources":["../../src/facebook-oauth.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAiC,MAAM,qBAAqB,CAAC;AAEhH;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyD;IACvF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyC;gBAE9D,MAAM,EAAE,WAAW;IAO/B;;;;;;;;;;;;;OAaG;IACG,oBAAoB,CACxB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QACT,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAuCF;;;;;;;;;;;;;OAaG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqDpE;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;CAc5C"}

package/dist/src/facebook-oauth.client.js

@@ -2,6 +2,25 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FacebookOAuthClient = void 0;
 const core_1 = require("@nauth-toolkit/core");
+/**
+ * Facebook OAuth Client Implementation (Platform-Agnostic)
+ *
+ * Handles OAuth flow with Facebook's Graph API
+ * Uses Facebook's Graph API for profile data
+ *
+ * This is a plain TypeScript class with no framework dependencies.
+ *
+ * @example
+ * ```typescript
+ * const client = new FacebookOAuthClient({
+ *   clientId: 'facebook_client_id',
+ *   clientSecret: 'facebook_client_secret',
+ *   redirectUri: 'https://myapp.com/auth/facebook/callback'
+ * });
+ *
+ * const profile = await client.getUserProfile(accessToken);
+ * ```
+ */
 class FacebookOAuthClient {
     config;
     tokenEndpoint = 'https://graph.facebook.com/v24.0/oauth/access_token';
@@ -12,6 +31,20 @@ class FacebookOAuthClient {
             ...config,
         };
     }
+    /**
+     * Exchange authorization code for access token
+     *
+     * @param code - Authorization code from Facebook OAuth callback
+     * @param redirectUri - Redirect URI used in OAuth flow
+     * @returns Access token and optional refresh token
+     * @throws {Error} When token exchange fails
+     *
+     * @example
+     * ```typescript
+     * const tokens = await client.exchangeCodeForToken(code, redirectUri);
+     * console.log(tokens.accessToken); // access_token_here
+     * ```
+     */
     async exchangeCodeForToken(code, redirectUri) {
         const params = new URLSearchParams({
             client_id: this.config.clientId,
@@ -20,6 +53,7 @@ class FacebookOAuthClient {
             redirect_uri: redirectUri,
         });
         try {
+            // Facebook returns the token in the URL, so we need to construct the URL
             const url = `${this.tokenEndpoint}?${params.toString()}`;
             const tokenResponse = await fetch(url);
             if (!tokenResponse.ok) {
@@ -29,7 +63,7 @@ class FacebookOAuthClient {
             const data = (await tokenResponse.json());
             return {
                 accessToken: data.access_token,
-                refreshToken: undefined,
+                refreshToken: undefined, // Facebook doesn't provide refresh tokens in this flow
                 expiresIn: data.expires_in,
             };
         }
@@ -40,8 +74,23 @@ class FacebookOAuthClient {
             throw new core_1.NAuthException(core_1.AuthErrorCode.SOCIAL_TOKEN_INVALID, 'Facebook token exchange failed: Unknown error');
         }
     }
+    /**
+     * Get user profile from Facebook using access token
+     *
+     * @param accessToken - OAuth access token
+     * @returns User profile data
+     * @throws {Error} When API call fails or token is invalid
+     *
+     * @example
+     * ```typescript
+     * const profile = await client.getUserProfile(accessToken);
+     * console.log(profile.email); // user@facebook.com
+     * console.log(profile.firstName); // John
+     * ```
+     */
     async getUserProfile(accessToken) {
         try {
+            // Facebook Graph API requires specific fields to be requested
             const fields = 'id,email,first_name,last_name,picture';
             const url = `${this.userInfoEndpoint}?fields=${fields}&access_token=${accessToken}`;
             const response = await fetch(url, {
@@ -58,16 +107,19 @@ class FacebookOAuthClient {
                 throw new core_1.NAuthException(core_1.AuthErrorCode.INTERNAL_ERROR, `Facebook API call failed: ${errorData.error?.message || response.statusText}`);
             }
             const data = (await response.json());
+            // CRITICAL: Require email from Facebook for signup
             if (!data.email) {
                 throw new core_1.NAuthException(core_1.AuthErrorCode.SOCIAL_EMAIL_REQUIRED, 'Email is required from Facebook. Please grant email permissions.');
             }
+            // Map Facebook's response to our standardized format
+            // Email is always verified if Facebook returns it (same as Google/Apple)
             return {
                 id: data.id,
                 email: data.email,
                 firstName: data.first_name || null,
                 lastName: data.last_name || null,
                 picture: data.picture?.data?.url || null,
-                verified: true,
+                verified: true, // Email is verified if provided by Facebook
                 raw: data,
             };
         }
@@ -78,6 +130,18 @@ class FacebookOAuthClient {
             throw new core_1.NAuthException(core_1.AuthErrorCode.INTERNAL_ERROR, 'Facebook profile fetch failed: Unknown error');
         }
     }
+    /**
+     * Generate Facebook OAuth authorization URL
+     *
+     * @param state - Optional state parameter for CSRF protection
+     * @returns Authorization URL for redirecting user to Facebook
+     *
+     * @example
+     * ```typescript
+     * const authUrl = client.getAuthorizationUrl('random-state');
+     * // Redirect user to authUrl
+     * ```
+     */
     getAuthorizationUrl(state) {
         const params = new URLSearchParams({
             client_id: this.config.clientId,

package/dist/src/facebook-oauth.client.js.map

@@ -1 +1 @@
-{"version":3,"file":"facebook-oauth.client.js","sourceRoot":"","sources":["../../src/facebook-oauth.client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"facebook-oauth.client.js","sourceRoot":"","sources":["../../src/facebook-oauth.client.ts"],"names":[],"mappings":"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"}

package/dist/src/facebook-social-auth.service.d.ts

@@ -1,6 +1,37 @@
 import { AuthService, SocialAuthService, ClientInfoService, NAuthConfig, NAuthLogger, OAuthUserProfile, PhoneVerificationService, ISocialAuthProviderService, ITokenVerifierService, BaseUser } from '@nauth-toolkit/core';
-import { BaseSocialAuthProviderService, JwtService, SessionService, AuthChallengeHelperService, AuthAuditService, TrustedDeviceService } from '@nauth-toolkit/core/internal';
+import { BaseSocialAuthProviderService, JwtService, SessionService, AuthChallengeHelperService, AuthAuditService, // Internal version with recordEvent()
+TrustedDeviceService } from '@nauth-toolkit/core/internal';
 import { Repository } from 'typeorm';
+/**
+ * Facebook Social Authentication Service (Platform-Agnostic)
+ *
+ * Handles Facebook OAuth flow including:
+ * - OAuth web flow (redirect-based)
+ * - Native mobile token verification
+ * - Account linking
+ *
+ * This is a plain TypeScript class with no framework dependencies.
+ * Use `@nauth-toolkit/social-facebook/nestjs` for NestJS integration.
+ *
+ * @example
+ * ```typescript
+ * // Direct instantiation (platform-agnostic)
+ * const facebookAuth = new FacebookSocialAuthService(
+ *   config,
+ *   logger,
+ *   authService,
+ *   socialAuthService,
+ *   jwtService,
+ *   sessionService,
+ *   challengeHelper,
+ *   clientInfoService,
+ *   auditService,
+ *   stateStore,
+ *   phoneVerificationService,
+ *   tokenVerifier
+ * );
+ * ```
+ */
 export declare class FacebookSocialAuthService extends BaseSocialAuthProviderService implements ISocialAuthProviderService {
     readonly providerName = "facebook";
     private readonly oauthClient;
@@ -9,8 +40,35 @@ export declare class FacebookSocialAuthService extends BaseSocialAuthProviderSer
         timestamp: number;
         provider: string;
     }>, userRepository: Repository<BaseUser>, phoneVerificationService?: PhoneVerificationService, auditService?: AuthAuditService, trustedDeviceService?: TrustedDeviceService, tokenVerifier?: ITokenVerifierService);
+    /**
+     * Generate OAuth authorization URL for Facebook
+     *
+     * @param state - Optional state parameter for CSRF protection
+     * @returns Authorization URL for redirecting user to Facebook
+     */
     getAuthUrl(state?: string): Promise<string>;
+    /**
+     * Get OAuth user profile from callback
+     *
+     * Exchanges authorization code for access token and fetches user profile.
+     *
+     * @param code - Authorization code from Facebook OAuth callback
+     * @param _state - State parameter (validated by base class)
+     * @returns User profile from Facebook
+     * @protected
+     */
     protected getOAuthProfile(code: string, _state: string): Promise<OAuthUserProfile>;
+    /**
+     * Verify Facebook access token from native mobile apps
+     *
+     * Facebook uses access tokens (not ID tokens) from native SDKs
+     *
+     * @param accessToken - Facebook access token from native SDK (passed as idToken parameter)
+     * @param _idToken - Not used for Facebook (Facebook uses access tokens)
+     * @param profileData - Optional profile data from native SDK
+     * @returns User profile from verified token
+     * @protected
+     */
     protected verifyNativeToken(idToken: string, _accessToken?: string, profileData?: unknown): Promise<OAuthUserProfile>;
 }
 //# sourceMappingURL=facebook-social-auth.service.d.ts.map

package/dist/src/facebook-social-auth.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"facebook-social-auth.service.d.ts","sourceRoot":"","sources":["../../src/facebook-social-auth.service.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,gBAAgB,EAGhB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,6BAA6B,EAC7B,UAAU,EACV,cAAc,EACd,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAmCrC,qBAAa,yBAA0B,SAAQ,6BAA8B,YAAW,0BAA0B;IAChH,QAAQ,CAAC,YAAY,cAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+B;gBAG3D,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,iBAAiB,EACpC,UAAU,EAAE,UAAU,EACtB,cAAc,EAAE,cAAc,EAC9B,eAAe,EAAE,0BAA0B,EAC3C,iBAAiB,EAAE,iBAAiB,EAEpC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,EAChE,cAAc,EAAE,UAAU,CAAC,QAAQ,CAAC,EAEpC,wBAAwB,CAAC,EAAE,wBAAwB,EAEnD,YAAY,CAAC,EAAE,gBAAgB,EAE/B,oBAAoB,CAAC,EAAE,oBAAoB,EAE3C,aAAa,CAAC,EAAE,qBAAqB;IAyDjC,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;cAkBjC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;cA2BxE,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,gBAAgB,CAAC;CAsD7B"}
+{"version":3,"file":"facebook-social-auth.service.d.ts","sourceRoot":"","sources":["../../src/facebook-social-auth.service.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,gBAAgB,EAGhB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,6BAA6B,EAC7B,UAAU,EACV,cAAc,EACd,0BAA0B,EAC1B,gBAAgB,EAAE,sCAAsC;AACxD,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,yBAA0B,SAAQ,6BAA8B,YAAW,0BAA0B;IAChH,QAAQ,CAAC,YAAY,cAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+B;gBAG3D,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,iBAAiB,EACpC,UAAU,EAAE,UAAU,EACtB,cAAc,EAAE,cAAc,EAC9B,eAAe,EAAE,0BAA0B,EAC3C,iBAAiB,EAAE,iBAAiB,EAEpC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,EAChE,cAAc,EAAE,UAAU,CAAC,QAAQ,CAAC,EAEpC,wBAAwB,CAAC,EAAE,wBAAwB,EAEnD,YAAY,CAAC,EAAE,gBAAgB,EAE/B,oBAAoB,CAAC,EAAE,oBAAoB,EAE3C,aAAa,CAAC,EAAE,qBAAqB;IAmDvC;;;;;OAKG;IACG,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQjD;;;;;;;;;OASG;cACa,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgBxF;;;;;;;;;;OAUG;cACa,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,gBAAgB,CAAC;CAsD7B"}