@nauth-toolkit/social-facebook 0.1.14 → 0.1.17

package/dist/nestjs/facebook-social-auth.module.d.ts

@@ -1,10 +1,47 @@
 import { OnModuleInit } from '@nestjs/common';
 import { FacebookSocialAuthService } from '../src/facebook-social-auth.service';
 import { SocialProviderRegistry } from '@nauth-toolkit/core/internal';
+/**
+ * Facebook Social Authentication Module (NestJS Adapter)
+ *
+ * Provides Facebook OAuth integration for nauth-toolkit in NestJS applications.
+ * Automatically registers itself with SocialAuthService when imported.
+ *
+ * **Usage:**
+ * ```typescript
+ * import { AuthModule } from '@nauth-toolkit/nestjs';
+ * import { FacebookSocialAuthModule } from '@nauth-toolkit/social-facebook/nestjs';
+ *
+ * @Module({
+ *   imports: [
+ *     AuthModule.forRoot(config),
+ *     FacebookSocialAuthModule, // 👈 Auto-registers with SocialAuthService
+ *   ],
+ * })
+ * export class AppModule {}
+ *
+ * // Use via registry (recommended for dynamic access)
+ * constructor(private socialAuthService: SocialAuthService) {}
+ *
+ * @Get('social/facebook')
+ * async getFacebookAuthUrl() {
+ *   const facebookProvider = this.socialAuthService.getProvider('facebook');
+ *   const authUrl = await facebookProvider.getAuthUrl();
+ *   return { authUrl };
+ * }
+ *
+ * // Or inject directly
+ * constructor(private facebookAuth: FacebookSocialAuthService) {}
+ * ```
+ */
 export declare class FacebookSocialAuthModule implements OnModuleInit {
     private readonly facebookSocialAuthService;
     private readonly providerRegistry;
     constructor(facebookSocialAuthService: FacebookSocialAuthService, providerRegistry: SocialProviderRegistry);
+    /**
+     * Auto-register Facebook provider with the SocialProviderRegistry
+     * when the module is initialized (only if enabled in config).
+     */
     onModuleInit(): void;
 }
 //# sourceMappingURL=facebook-social-auth.module.d.ts.map

package/dist/nestjs/facebook-social-auth.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"facebook-social-auth.module.d.ts","sourceRoot":"","sources":["../../nestjs/facebook-social-auth.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAYhF,OAAO,EAIL,sBAAsB,EAGvB,MAAM,8BAA8B,CAAC;AAoCtC,qBAmEa,wBAAyB,YAAW,YAAY;IAEzD,OAAO,CAAC,QAAQ,CAAC,yBAAyB;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBADhB,yBAAyB,EAAE,yBAAyB,EACpD,gBAAgB,EAAE,sBAAsB;IAO3D,YAAY,IAAI,IAAI;CAOrB"}
+{"version":3,"file":"facebook-social-auth.module.d.ts","sourceRoot":"","sources":["../../nestjs/facebook-social-auth.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAYhF,OAAO,EAIL,sBAAsB,EAGvB,MAAM,8BAA8B,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAmEa,wBAAyB,YAAW,YAAY;IAEzD,OAAO,CAAC,QAAQ,CAAC,yBAAyB;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBADhB,yBAAyB,EAAE,yBAAyB,EACpD,gBAAgB,EAAE,sBAAsB;IAG3D;;;OAGG;IACH,YAAY,IAAI,IAAI;CAOrB"}

package/dist/nestjs/facebook-social-auth.module.js

@@ -12,9 +12,44 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FacebookSocialAuthModule = void 0;
 const common_1 = require("@nestjs/common");
 const facebook_social_auth_service_1 = require("../src/facebook-social-auth.service");
+// Public API imports
 const core_1 = require("@nauth-toolkit/core");
+// Internal API imports (for provider implementations)
 const internal_1 = require("@nauth-toolkit/core/internal");
 const token_verifier_service_1 = require("../src/token-verifier.service");
+/**
+ * Facebook Social Authentication Module (NestJS Adapter)
+ *
+ * Provides Facebook OAuth integration for nauth-toolkit in NestJS applications.
+ * Automatically registers itself with SocialAuthService when imported.
+ *
+ * **Usage:**
+ * ```typescript
+ * import { AuthModule } from '@nauth-toolkit/nestjs';
+ * import { FacebookSocialAuthModule } from '@nauth-toolkit/social-facebook/nestjs';
+ *
+ * @Module({
+ *   imports: [
+ *     AuthModule.forRoot(config),
+ *     FacebookSocialAuthModule, // 👈 Auto-registers with SocialAuthService
+ *   ],
+ * })
+ * export class AppModule {}
+ *
+ * // Use via registry (recommended for dynamic access)
+ * constructor(private socialAuthService: SocialAuthService) {}
+ *
+ * @Get('social/facebook')
+ * async getFacebookAuthUrl() {
+ *   const facebookProvider = this.socialAuthService.getProvider('facebook');
+ *   const authUrl = await facebookProvider.getAuthUrl();
+ *   return { authUrl };
+ * }
+ *
+ * // Or inject directly
+ * constructor(private facebookAuth: FacebookSocialAuthService) {}
+ * ```
+ */
 let FacebookSocialAuthModule = class FacebookSocialAuthModule {
     facebookSocialAuthService;
     providerRegistry;
@@ -22,8 +57,12 @@ let FacebookSocialAuthModule = class FacebookSocialAuthModule {
         this.facebookSocialAuthService = facebookSocialAuthService;
         this.providerRegistry = providerRegistry;
     }
+    /**
+     * Auto-register Facebook provider with the SocialProviderRegistry
+     * when the module is initialized (only if enabled in config).
+     */
     onModuleInit() {
-        const config = this.facebookSocialAuthService['config'];
+        const config = this.facebookSocialAuthService['config']; // Access protected config
         const providerConfig = config.social?.facebook;
         if (providerConfig?.enabled) {
             this.providerRegistry.registerProvider(this.facebookSocialAuthService);
@@ -33,7 +72,9 @@ let FacebookSocialAuthModule = class FacebookSocialAuthModule {
 exports.FacebookSocialAuthModule = FacebookSocialAuthModule;
 exports.FacebookSocialAuthModule = FacebookSocialAuthModule = __decorate([
     (0, common_1.Module)({
+        // No imports needed - AuthModule is @Global() so its providers are available
         providers: [
+            // Token verifier for Facebook access tokens
             {
                 provide: 'FACEBOOK_TOKEN_VERIFIER',
                 useFactory: (config) => {
@@ -41,9 +82,12 @@ exports.FacebookSocialAuthModule = FacebookSocialAuthModule = __decorate([
                 },
                 inject: ['NAUTH_CONFIG'],
             },
+            // Facebook Social Auth Service (factory provider)
             {
                 provide: facebook_social_auth_service_1.FacebookSocialAuthService,
-                useFactory: (config, logger, authService, socialAuthService, jwtService, sessionService, challengeHelper, clientInfoService, stateStore, userRepository, phoneVerificationService, auditService, trustedDeviceService, tokenVerifier) => {
+                useFactory: (config, logger, authService, socialAuthService, jwtService, sessionService, challengeHelper, clientInfoService, stateStore, userRepository, phoneVerificationService, auditService, // Optional - only available when auditLogs.enabled is true
+                trustedDeviceService, // Optional - only available when rememberDevices is enabled
+                tokenVerifier) => {
                     return new facebook_social_auth_service_1.FacebookSocialAuthService(config, logger, authService, socialAuthService, jwtService, sessionService, challengeHelper, clientInfoService, stateStore, userRepository, phoneVerificationService, auditService, trustedDeviceService, tokenVerifier);
                 },
                 inject: [
@@ -58,8 +102,8 @@ exports.FacebookSocialAuthModule = FacebookSocialAuthModule = __decorate([
                     'SOCIAL_AUTH_STATE_STORE',
                     'UserRepository',
                     { token: core_1.PhoneVerificationService, optional: true },
-                    { token: internal_1.AuthAuditService, optional: true },
-                    { token: internal_1.TrustedDeviceService, optional: true },
+                    { token: internal_1.AuthAuditService, optional: true }, // Optional - only available when auditLogs.enabled is true
+                    { token: internal_1.TrustedDeviceService, optional: true }, // Optional - only available when rememberDevices is enabled
                     { token: 'FACEBOOK_TOKEN_VERIFIER', optional: true },
                 ],
             },

package/dist/nestjs/facebook-social-auth.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"facebook-social-auth.module.js","sourceRoot":"","sources":["../../nestjs/facebook-social-auth.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AACtD,sFAAgF;AAEhF,8CAQ6B;AAE7B,2DAOsC;AACtC,0EAAqG;AAsG9F,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;IAEhB;IACA;IAFnB,YACmB,yBAAoD,EACpD,gBAAwC;QADxC,8BAAyB,GAAzB,yBAAyB,CAA2B;QACpD,qBAAgB,GAAhB,gBAAgB,CAAwB;IACxD,CAAC;IAMJ,YAAY;QACV,MAAM,MAAM,GAAG,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAgB,CAAC;QACvE,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC/C,IAAI,cAAc,EAAE,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;CACF,CAAA;AAjBY,4DAAwB;mCAAxB,wBAAwB;IAnEpC,IAAA,eAAM,EAAC;QAEN,SAAS,EAAE;YAET;gBACE,OAAO,EAAE,yBAAyB;gBAClC,UAAU,EAAE,CAAC,MAAmB,EAAE,EAAE;oBAClC,OAAO,IAAI,6CAA4B,CAAC,MAAM,CAAC,CAAC;gBAClD,CAAC;gBACD,MAAM,EAAE,CAAC,cAAc,CAAC;aACzB;YAED;gBACE,OAAO,EAAE,wDAAyB;gBAClC,UAAU,EAAE,CACV,MAAmB,EACnB,MAAmB,EACnB,WAAwB,EACxB,iBAAoC,EACpC,UAAsB,EACtB,cAA8B,EAC9B,eAA2C,EAC3C,iBAAoC,EACpC,UAAgE,EAChE,cAAmB,EACnB,wBAAmD,EACnD,YAAuC,EACvC,oBAA2C,EAC3C,aAAqC,EACrC,EAAE;oBACF,OAAO,IAAI,wDAAyB,CAClC,MAAM,EACN,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,wBAAwB,EACxB,YAAY,EACZ,oBAAoB,EACpB,aAAa,CACd,CAAC;gBACJ,CAAC;gBACD,MAAM,EAAE;oBACN,cAAc;oBACd,cAAc;oBACd,kBAAW;oBACX,wBAAiB;oBACjB,qBAAU;oBACV,yBAAc;oBACd,qCAA0B;oBAC1B,wBAAiB;oBACjB,yBAAyB;oBACzB,gBAAgB;oBAChB,EAAE,KAAK,EAAE,+BAAwB,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACnD,EAAE,KAAK,EAAE,2BAAwB,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACnD,EAAE,KAAK,EAAE,+BAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAC/C,EAAE,KAAK,EAAE,yBAAyB,EAAE,QAAQ,EAAE,IAAI,EAAE;iBACrD;aACF;SACF;QACD,OAAO,EAAE,CAAC,wDAAyB,CAAC;KACrC,CAAC;qCAG8C,wDAAyB;QAClC,iCAAsB;GAHhD,wBAAwB,CAiBpC"}
+{"version":3,"file":"facebook-social-auth.module.js","sourceRoot":"","sources":["../../nestjs/facebook-social-auth.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AACtD,sFAAgF;AAChF,qBAAqB;AACrB,8CAQ6B;AAC7B,sDAAsD;AACtD,2DAOsC;AACtC,0EAAqG;AAErG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAoEI,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;IAEhB;IACA;IAFnB,YACmB,yBAAoD,EACpD,gBAAwC;QADxC,8BAAyB,GAAzB,yBAAyB,CAA2B;QACpD,qBAAgB,GAAhB,gBAAgB,CAAwB;IACxD,CAAC;IAEJ;;;OAGG;IACH,YAAY;QACV,MAAM,MAAM,GAAG,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAgB,CAAC,CAAC,0BAA0B;QAClG,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC/C,IAAI,cAAc,EAAE,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;CACF,CAAA;AAjBY,4DAAwB;mCAAxB,wBAAwB;IAnEpC,IAAA,eAAM,EAAC;QACN,6EAA6E;QAC7E,SAAS,EAAE;YACT,4CAA4C;YAC5C;gBACE,OAAO,EAAE,yBAAyB;gBAClC,UAAU,EAAE,CAAC,MAAmB,EAAE,EAAE;oBAClC,OAAO,IAAI,6CAA4B,CAAC,MAAM,CAAC,CAAC;gBAClD,CAAC;gBACD,MAAM,EAAE,CAAC,cAAc,CAAC;aACzB;YACD,kDAAkD;YAClD;gBACE,OAAO,EAAE,wDAAyB;gBAClC,UAAU,EAAE,CACV,MAAmB,EACnB,MAAmB,EACnB,WAAwB,EACxB,iBAAoC,EACpC,UAAsB,EACtB,cAA8B,EAC9B,eAA2C,EAC3C,iBAAoC,EACpC,UAAgE,EAChE,cAAmB,EACnB,wBAAmD,EACnD,YAAuC,EAAE,2DAA2D;gBACpG,oBAA2C,EAAE,4DAA4D;gBACzG,aAAqC,EACrC,EAAE;oBACF,OAAO,IAAI,wDAAyB,CAClC,MAAM,EACN,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,wBAAwB,EACxB,YAAY,EACZ,oBAAoB,EACpB,aAAa,CACd,CAAC;gBACJ,CAAC;gBACD,MAAM,EAAE;oBACN,cAAc;oBACd,cAAc;oBACd,kBAAW;oBACX,wBAAiB;oBACjB,qBAAU;oBACV,yBAAc;oBACd,qCAA0B;oBAC1B,wBAAiB;oBACjB,yBAAyB;oBACzB,gBAAgB;oBAChB,EAAE,KAAK,EAAE,+BAAwB,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACnD,EAAE,KAAK,EAAE,2BAAwB,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,2DAA2D;oBAChH,EAAE,KAAK,EAAE,+BAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,4DAA4D;oBAC7G,EAAE,KAAK,EAAE,yBAAyB,EAAE,QAAQ,EAAE,IAAI,EAAE;iBACrD;aACF;SACF;QACD,OAAO,EAAE,CAAC,wDAAyB,CAAC;KACrC,CAAC;qCAG8C,wDAAyB;QAClC,iCAAsB;GAHhD,wBAAwB,CAiBpC"}

package/dist/nestjs/index.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @nauth-toolkit/social-facebook/nestjs
+ *
+ * NestJS adapter for Facebook Social Authentication
+ */
 export { FacebookSocialAuthModule } from './facebook-social-auth.module';
 export * from '../src/facebook-social-auth.service';
 export * from '../src/facebook-oauth.client';

package/dist/nestjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../nestjs/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../nestjs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,6BAA6B,CAAC"}

package/dist/nestjs/index.js

@@ -1,4 +1,9 @@
 "use strict";
+/**
+ * @nauth-toolkit/social-facebook/nestjs
+ *
+ * NestJS adapter for Facebook Social Authentication
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -17,6 +22,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FacebookSocialAuthModule = void 0;
 var facebook_social_auth_module_1 = require("./facebook-social-auth.module");
 Object.defineProperty(exports, "FacebookSocialAuthModule", { enumerable: true, get: function () { return facebook_social_auth_module_1.FacebookSocialAuthModule; } });
+// Re-export core Facebook social auth components
 __exportStar(require("../src/facebook-social-auth.service"), exports);
 __exportStar(require("../src/facebook-oauth.client"), exports);
 __exportStar(require("../src/token-verifier.service"), exports);

package/dist/nestjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../nestjs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAMA,6EAAyE;AAAhE,uIAAA,wBAAwB,OAAA;AAGjC,sEAAoD;AACpD,+DAA6C;AAC7C,gEAA8C;AAC9C,0EAAwD;AACxD,8DAA4C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../nestjs/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;AAEH,6EAAyE;AAAhE,uIAAA,wBAAwB,OAAA;AAEjC,iDAAiD;AACjD,sEAAoD;AACpD,+DAA6C;AAC7C,gEAA8C;AAC9C,0EAAwD;AACxD,8DAA4C"}

package/dist/src/dto/social-login.dto.d.ts

@@ -1,32 +1,229 @@
+/**
+ * Social provider enum
+ */
 export declare enum SocialProvider {
     GOOGLE = "google",
     APPLE = "apple",
     FACEBOOK = "facebook"
 }
+/**
+ * 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';
+ * ```
+ */
 export declare class SocialLoginDTO {
+    /**
+     * Social provider name
+     * Must be one of the configured providers
+     *
+     * Validation:
+     * - Must be a valid SocialProvider enum value
+     */
     provider: SocialProvider;
+    /**
+     * 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?: string;
 }
+/**
+ * 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';
+ * ```
+ */
 export declare class SocialCallbackDTO {
+    /**
+     * Social provider name
+     * Must match the provider used in the initial request
+     *
+     * Validation:
+     * - Must be a valid SocialProvider enum value
+     */
     provider: SocialProvider;
+    /**
+     * 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: string;
+    /**
+     * 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: string;
+    /**
+     * 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?: string;
+    /**
+     * Optional error description from OAuth provider
+     * Provides more details about the error
+     *
+     * Validation:
+     * - Must be a string if present
+     * - Max 500 characters
+     */
     error_description?: string;
 }
+/**
+ * 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';
+ * ```
+ */
 export declare class LinkSocialAccountDTO {
+    /**
+     * Social provider name
+     * Must be one of the configured providers
+     *
+     * Validation:
+     * - Must be a valid SocialProvider enum value
+     */
     provider: SocialProvider;
+    /**
+     * 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: string;
+    /**
+     * 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: string;
 }
+/**
+ * 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';
+ * ```
+ */
 export declare class UnlinkSocialAccountDTO {
+    /**
+     * Social provider name to unlink
+     * Must be one of the currently linked providers
+     *
+     * Validation:
+     * - Must be a valid SocialProvider enum value
+     */
     provider: SocialProvider;
 }
+/**
+ * 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"]
+ *   }
+ * }
+ * ```
+ */
 export declare class SocialLoginResponseDTO {
+    /**
+     * JWT access token for API authentication
+     *
+     * Validation:
+     * - Must be a string
+     * - Max 2048 characters (typical JWT length)
+     */
     accessToken: string;
+    /**
+     * JWT refresh token for token renewal
+     *
+     * Validation:
+     * - Must be a string
+     * - Max 2048 characters (typical JWT length)
+     */
     refreshToken: string;
+    /**
+     * Access token expiration timestamp (Unix timestamp in seconds)
+     *
+     * Validation:
+     * - Must be a number
+     */
     accessTokenExpiresAt: number;
+    /**
+     * Refresh token expiration timestamp (Unix timestamp in seconds)
+     *
+     * Validation:
+     * - Must be a number
+     */
     refreshTokenExpiresAt: number;
+    /**
+     * 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: {
         sub: string;
         email: string;
@@ -36,7 +233,29 @@ export declare class SocialLoginResponseDTO {
         socialProviders?: string[];
     };
 }
+/**
+ * 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"
+ *     }
+ *   ]
+ * }
+ * ```
+ */
 export declare class SocialAccountsResponseDTO {
+    /**
+     * Array of linked social accounts
+     */
     accounts: Array<{
         provider: string;
         providerEmail?: string;

package/dist/src/dto/social-login.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"social-login.dto.d.ts","sourceRoot":"","sources":["../../../src/dto/social-login.dto.ts"],"names":[],"mappings":"AAKA,oBAAY,cAAc;IACxB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,QAAQ,aAAa;CACtB;AAcD,qBAAa,cAAc;IASzB,QAAQ,EAAG,cAAc,CAAC;IAc1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAeD,qBAAa,iBAAiB;IAS5B,QAAQ,EAAG,cAAc,CAAC;IAa1B,IAAI,EAAG,MAAM,CAAC;IAad,KAAK,EAAG,MAAM,CAAC;IAaf,KAAK,CAAC,EAAE,MAAM,CAAC;IAaf,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAeD,qBAAa,oBAAoB;IAS/B,QAAQ,EAAG,cAAc,CAAC;IAa1B,IAAI,EAAG,MAAM,CAAC;IAad,KAAK,EAAG,MAAM,CAAC;CAChB;AAaD,qBAAa,sBAAsB;IASjC,QAAQ,EAAG,cAAc,CAAC;CAC3B;AAwBD,qBAAa,sBAAsB;IAUjC,WAAW,EAAG,MAAM,CAAC;IAWrB,YAAY,EAAG,MAAM,CAAC;IAStB,oBAAoB,EAAG,MAAM,CAAC;IAS9B,qBAAqB,EAAG,MAAM,CAAC;IAc/B,IAAI,EAAG;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,OAAO,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH;AAqBD,qBAAa,yBAAyB;IAIpC,QAAQ,EAAG,KAAK,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,IAAI,CAAC;QACf,UAAU,CAAC,EAAE,IAAI,CAAC;KACnB,CAAC,CAAC;CACJ"}
+{"version":3,"file":"social-login.dto.d.ts","sourceRoot":"","sources":["../../../src/dto/social-login.dto.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,cAAc;IACxB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,QAAQ,aAAa;CACtB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IACzB;;;;;;OAMG;IAEH,QAAQ,EAAG,cAAc,CAAC;IAE1B;;;;;;;;OAQG;IAIH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;OAMG;IAEH,QAAQ,EAAG,cAAc,CAAC;IAE1B;;;;;;;OAOG;IAIH,IAAI,EAAG,MAAM,CAAC;IAEd;;;;;;;OAOG;IAIH,KAAK,EAAG,MAAM,CAAC;IAEf;;;;;;;OAOG;IAIH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;;OAOG;IAIH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAoB;IAC/B;;;;;;OAMG;IAEH,QAAQ,EAAG,cAAc,CAAC;IAE1B;;;;;;;OAOG;IAIH,IAAI,EAAG,MAAM,CAAC;IAEd;;;;;;;OAOG;IAIH,KAAK,EAAG,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,sBAAsB;IACjC;;;;;;OAMG;IAEH,QAAQ,EAAG,cAAc,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,sBAAsB;IACjC;;;;;;OAMG;IAGH,WAAW,EAAG,MAAM,CAAC;IAErB;;;;;;OAMG;IAGH,YAAY,EAAG,MAAM,CAAC;IAEtB;;;;;OAKG;IAEH,oBAAoB,EAAG,MAAM,CAAC;IAE9B;;;;;OAKG;IAEH,qBAAqB,EAAG,MAAM,CAAC;IAE/B;;;;;;;;;;;OAWG;IACH,IAAI,EAAG;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,OAAO,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,yBAAyB;IACpC;;OAEG;IACH,QAAQ,EAAG,KAAK,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,IAAI,CAAC;QACf,UAAU,CAAC,EAAE,IAAI,CAAC;KACnB,CAAC,CAAC;CACJ"}