@nauth-toolkit/social-google 0.1.14 → 0.1.18

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"google-social-auth.module.d.ts","sourceRoot":"","sources":["../../nestjs/google-social-auth.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAY5E,OAAO,EAIL,sBAAsB,EAGvB,MAAM,8BAA8B,CAAC;AAoCtC,qBAsEa,sBAAuB,YAAW,YAAY;IAEvD,OAAO,CAAC,QAAQ,CAAC,uBAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBADhB,uBAAuB,EAAE,uBAAuB,EAChD,gBAAgB,EAAE,sBAAsB;IAQ3D,YAAY,IAAI,IAAI;CAUrB"}
+{"version":3,"file":"google-social-auth.module.d.ts","sourceRoot":"","sources":["../../nestjs/google-social-auth.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAY5E,OAAO,EAIL,sBAAsB,EAGvB,MAAM,8BAA8B,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAsEa,sBAAuB,YAAW,YAAY;IAEvD,OAAO,CAAC,QAAQ,CAAC,uBAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBADhB,uBAAuB,EAAE,uBAAuB,EAChD,gBAAgB,EAAE,sBAAsB;IAG3D;;;;OAIG;IACH,YAAY,IAAI,IAAI;CAUrB"}

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

@@ -12,9 +12,44 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GoogleSocialAuthModule = void 0;
 const common_1 = require("@nestjs/common");
 const google_social_auth_service_1 = require("../src/google-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");
+/**
+ * Google Social Authentication Module (NestJS Adapter)
+ *
+ * Provides Google OAuth integration for nauth-toolkit in NestJS applications.
+ * Automatically registers itself with SocialAuthService when imported.
+ *
+ * **Usage:**
+ * ```typescript
+ * import { AuthModule } from '@nauth-toolkit/nestjs';
+ * import { GoogleSocialAuthModule } from '@nauth-toolkit/social-google/nestjs';
+ *
+ * @Module({
+ *   imports: [
+ *     AuthModule.forRoot(config),
+ *     GoogleSocialAuthModule, // 👈 Auto-registers with SocialAuthService
+ *   ],
+ * })
+ * export class AppModule {}
+ *
+ * // Use via registry (recommended for dynamic access)
+ * constructor(private socialAuthService: SocialAuthService) {}
+ *
+ * @Get('social/google')
+ * async getGoogleAuthUrl() {
+ *   const googleProvider = this.socialAuthService.getProvider('google');
+ *   const authUrl = await googleProvider.getAuthUrl();
+ *   return { authUrl };
+ * }
+ *
+ * // Or inject directly
+ * constructor(private googleAuth: GoogleSocialAuthService) {}
+ * ```
+ */
 let GoogleSocialAuthModule = class GoogleSocialAuthModule {
     googleSocialAuthService;
     providerRegistry;
@@ -22,18 +57,28 @@ let GoogleSocialAuthModule = class GoogleSocialAuthModule {
         this.googleSocialAuthService = googleSocialAuthService;
         this.providerRegistry = providerRegistry;
     }
+    /**
+     * Auto-register Google provider with the SocialProviderRegistry
+     * when the module is initialized.
+     * Only registers if the provider is enabled in config.
+     */
     onModuleInit() {
+        // Check if provider is enabled by checking if oauthClient was initialized
+        // Service sets oauthClient to null when disabled
         const config = this.googleSocialAuthService['config'];
         const providerConfig = config.social?.google;
         if (providerConfig?.enabled) {
             this.providerRegistry.registerProvider(this.googleSocialAuthService);
         }
+        // If disabled, silently skip registration - module can exist but provider won't be available
     }
 };
 exports.GoogleSocialAuthModule = GoogleSocialAuthModule;
 exports.GoogleSocialAuthModule = GoogleSocialAuthModule = __decorate([
     (0, common_1.Module)({
+        // No imports needed - AuthModule is @Global() so its providers are available
         providers: [
+            // Token verifier for Google ID tokens
             {
                 provide: 'GOOGLE_TOKEN_VERIFIER',
                 useFactory: (config) => {
@@ -41,9 +86,15 @@ exports.GoogleSocialAuthModule = GoogleSocialAuthModule = __decorate([
                 },
                 inject: ['NAUTH_CONFIG'],
             },
+            // Google Social Auth Service (factory provider)
+            // Only create service if Google OAuth is enabled in config
             {
                 provide: google_social_auth_service_1.GoogleSocialAuthService,
-                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) => {
+                    // Service can be created even when disabled - it handles gracefully
+                    // Schema validation ensures credentials are present when enabled=true
                     return new google_social_auth_service_1.GoogleSocialAuthService(config, logger, authService, socialAuthService, jwtService, sessionService, challengeHelper, clientInfoService, stateStore, userRepository, phoneVerificationService, auditService, trustedDeviceService, tokenVerifier);
                 },
                 inject: [
@@ -58,8 +109,8 @@ exports.GoogleSocialAuthModule = GoogleSocialAuthModule = __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: 'GOOGLE_TOKEN_VERIFIER', optional: true },
                 ],
             },

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

@@ -1 +1 @@
-{"version":3,"file":"google-social-auth.module.js","sourceRoot":"","sources":["../../nestjs/google-social-auth.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AACtD,kFAA4E;AAE5E,8CAQ6B;AAE7B,2DAOsC;AACtC,0EAAmG;AAyG5F,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAEd;IACA;IAFnB,YACmB,uBAAgD,EAChD,gBAAwC;QADxC,4BAAuB,GAAvB,uBAAuB,CAAyB;QAChD,qBAAgB,GAAhB,gBAAgB,CAAwB;IACxD,CAAC;IAOJ,YAAY;QAGV,MAAM,MAAM,GAAG,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAgB,CAAC;QACrE,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;QAC7C,IAAI,cAAc,EAAE,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACvE,CAAC;IAEH,CAAC;CACF,CAAA;AArBY,wDAAsB;iCAAtB,sBAAsB;IAtElC,IAAA,eAAM,EAAC;QAEN,SAAS,EAAE;YAET;gBACE,OAAO,EAAE,uBAAuB;gBAChC,UAAU,EAAE,CAAC,MAAmB,EAAE,EAAE;oBAClC,OAAO,IAAI,6CAA0B,CAAC,MAAM,CAAC,CAAC;gBAChD,CAAC;gBACD,MAAM,EAAE,CAAC,cAAc,CAAC;aACzB;YAGD;gBACE,OAAO,EAAE,oDAAuB;gBAChC,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,EACZ,EAAE;oBAG3B,OAAO,IAAI,oDAAuB,CAChC,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,uBAAuB,EAAE,QAAQ,EAAE,IAAI,EAAE;iBACnD;aACF;SACF;QACD,OAAO,EAAE,CAAC,oDAAuB,CAAC;KACnC,CAAC;qCAG4C,oDAAuB;QAC9B,iCAAsB;GAHhD,sBAAsB,CAqBlC"}
+{"version":3,"file":"google-social-auth.module.js","sourceRoot":"","sources":["../../nestjs/google-social-auth.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AACtD,kFAA4E;AAC5E,qBAAqB;AACrB,8CAQ6B;AAC7B,sDAAsD;AACtD,2DAOsC;AACtC,0EAAmG;AAEnG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAuEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAEd;IACA;IAFnB,YACmB,uBAAgD,EAChD,gBAAwC;QADxC,4BAAuB,GAAvB,uBAAuB,CAAyB;QAChD,qBAAgB,GAAhB,gBAAgB,CAAwB;IACxD,CAAC;IAEJ;;;;OAIG;IACH,YAAY;QACV,0EAA0E;QAC1E,iDAAiD;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAgB,CAAC;QACrE,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;QAC7C,IAAI,cAAc,EAAE,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACvE,CAAC;QACD,6FAA6F;IAC/F,CAAC;CACF,CAAA;AArBY,wDAAsB;iCAAtB,sBAAsB;IAtElC,IAAA,eAAM,EAAC;QACN,6EAA6E;QAC7E,SAAS,EAAE;YACT,sCAAsC;YACtC;gBACE,OAAO,EAAE,uBAAuB;gBAChC,UAAU,EAAE,CAAC,MAAmB,EAAE,EAAE;oBAClC,OAAO,IAAI,6CAA0B,CAAC,MAAM,CAAC,CAAC;gBAChD,CAAC;gBACD,MAAM,EAAE,CAAC,cAAc,CAAC;aACzB;YACD,gDAAgD;YAChD,2DAA2D;YAC3D;gBACE,OAAO,EAAE,oDAAuB;gBAChC,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,EACZ,EAAE;oBAC3B,oEAAoE;oBACpE,sEAAsE;oBACtE,OAAO,IAAI,oDAAuB,CAChC,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,uBAAuB,EAAE,QAAQ,EAAE,IAAI,EAAE;iBACnD;aACF;SACF;QACD,OAAO,EAAE,CAAC,oDAAuB,CAAC;KACnC,CAAC;qCAG4C,oDAAuB;QAC9B,iCAAsB;GAHhD,sBAAsB,CAqBlC"}

package/dist/nestjs/index.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @nauth-toolkit/social-google/nestjs
+ *
+ * NestJS adapter for Google Social Authentication
+ */
 export { GoogleSocialAuthModule } from './google-social-auth.module';
 export * from '../src/google-social-auth.service';
 export * from '../src/google-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,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,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,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,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-google/nestjs
+ *
+ * NestJS adapter for Google 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.GoogleSocialAuthModule = void 0;
 var google_social_auth_module_1 = require("./google-social-auth.module");
 Object.defineProperty(exports, "GoogleSocialAuthModule", { enumerable: true, get: function () { return google_social_auth_module_1.GoogleSocialAuthModule; } });
+// Re-export core Google social auth components
 __exportStar(require("../src/google-social-auth.service"), exports);
 __exportStar(require("../src/google-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,yEAAqE;AAA5D,mIAAA,sBAAsB,OAAA;AAG/B,oEAAkD;AAClD,6DAA2C;AAC3C,gEAA8C;AAC9C,0EAAwD;AACxD,8DAA4C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../nestjs/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;AAEH,yEAAqE;AAA5D,mIAAA,sBAAsB,OAAA;AAE/B,+CAA+C;AAC/C,oEAAkD;AAClD,6DAA2C;AAC3C,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 500 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"}