win-portal-auth-sdk 1.3.1 → 1.4.0

package/README.md

@@ -554,15 +554,14 @@ try {
 
 📚 **[Complete Documentation →](./docs/README.md)**
 
-- [API Functions Reference](./docs/api/functions.md) - สรุปฟังก์ชันทั้งหมดที่ SDK รองรับ 🆕
-- [Frontend Examples](./docs/guides/frontend-examples.md) - Next.js, React usage
-- [Middleware Guide](./docs/middleware/usage.md) - Express & NestJS
-- [Type Safety Guide](./docs/middleware/type-safety.md) - Express type augmentation 🆕
-- [Type Names Guide](./docs/guides/type-names.md) - SDK-friendly type names 🆕
-- [Next.js Guide](./docs/guides/nextjs.md) - คู่มือ Next.js ภาษาไทย
+- [Next.js Guide](./docs/guides/nextjs.md) - คู่มือ Next.js ภาษาไทย (ครบถ้วน) ⭐
 - [OAuth Next.js Guide](./docs/guides/oauth-nextjs.md) - คู่มือ OAuth กับ Next.js
 - [NestJS Guide](./docs/guides/nestjs.md) - คู่มือ NestJS
-- [Thai Documentation](./docs/guides/getting-started.md) - คู่มือภาษาไทย
+- [Middleware Guide](./docs/middleware/usage.md) - Express & NestJS (English & ไทย)
+- [Middleware Examples](./docs/middleware/examples.md) - Complete backend examples
+- [Type Safety Guide](./docs/middleware/type-safety.md) - Express type augmentation
+- [API Functions Reference](./docs/api/functions.md) - สรุปฟังก์ชันทั้งหมดที่ SDK รองรับ
+- [Type Names Guide](./docs/guides/type-names.md) - SDK-friendly type names
 - [Publishing Guide](./docs/development/publish.md) - How to publish updates
 
 ## License

package/dist/index.d.ts

@@ -3,10 +3,15 @@
  *
  * Authentication SDK for Win Portal applications
  * Provides HTTP client with automatic API key injection
+ *
+ * Core exports - ใช้ได้ทุกที่ (Frontend & Backend)
+ *
+ * สำหรับ Backend-specific features:
+ * - Express Middleware: import from 'win-portal-auth-sdk/middleware'
+ * - NestJS Components: import from 'win-portal-auth-sdk/nestjs'
  */
 export * from './types';
 export * from './client';
-export * from './middleware';
 export * from './utils/token-utils';
 export { logger } from './utils/logger';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,cAAc,CAAC;AAG7B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -4,6 +4,12 @@
  *
  * Authentication SDK for Win Portal applications
  * Provides HTTP client with automatic API key injection
+ *
+ * Core exports - ใช้ได้ทุกที่ (Frontend & Backend)
+ *
+ * สำหรับ Backend-specific features:
+ * - Express Middleware: import from 'win-portal-auth-sdk/middleware'
+ * - NestJS Components: import from 'win-portal-auth-sdk/nestjs'
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -25,9 +31,12 @@ exports.logger = void 0;
 __exportStar(require("./types"), exports);
 // Client (Frontend & Backend)
 __exportStar(require("./client"), exports);
-// Middleware (Backend only - Express & NestJS)
-__exportStar(require("./middleware"), exports);
 // Utils
 __exportStar(require("./utils/token-utils"), exports);
 var logger_1 = require("./utils/logger");
 Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+// Note: Middleware และ NestJS components ไม่ได้ export จาก root
+// เพื่อป้องกันการ bundle backend code ใน frontend applications
+// ใช้ subpath exports แทน:
+// - 'win-portal-auth-sdk/middleware' สำหรับ Express middleware
+// - 'win-portal-auth-sdk/nestjs' สำหรับ NestJS components

package/dist/nestjs/decorators/current-token.decorator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Current Token Decorator
+ *
+ * Parameter decorator to extract the current authentication token from the request.
+ * Requires that a guard has set request.token (e.g., OAuthAuthGuard).
+ */
+/**
+ * Current Token Decorator
+ *
+ * Extracts the authentication token from request.token.
+ * Returns null if no token is available.
+ *
+ * @example
+ * ```typescript
+ * @Controller('api')
+ * @UseGuards(OAuthAuthGuard)
+ * export class ApiController {
+ *   @Get('token-info')
+ *   getTokenInfo(@CurrentToken() token: string) {
+ *     return {
+ *       token: token.substring(0, 20) + '...',
+ *       length: token.length,
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export declare const CurrentToken: any;
+//# sourceMappingURL=current-token.decorator.d.ts.map

package/dist/nestjs/decorators/current-token.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-token.decorator.d.ts","sourceRoot":"","sources":["../../../src/nestjs/decorators/current-token.decorator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,YAAY,KAGvB,CAAC"}

package/dist/nestjs/decorators/current-token.decorator.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Current Token Decorator
+ *
+ * Parameter decorator to extract the current authentication token from the request.
+ * Requires that a guard has set request.token (e.g., OAuthAuthGuard).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CurrentToken = void 0;
+// @ts-expect-error - @nestjs/common is a peer dependency, will be available at runtime in NestJS apps
+const common_1 = require("@nestjs/common");
+/**
+ * Current Token Decorator
+ *
+ * Extracts the authentication token from request.token.
+ * Returns null if no token is available.
+ *
+ * @example
+ * ```typescript
+ * @Controller('api')
+ * @UseGuards(OAuthAuthGuard)
+ * export class ApiController {
+ *   @Get('token-info')
+ *   getTokenInfo(@CurrentToken() token: string) {
+ *     return {
+ *       token: token.substring(0, 20) + '...',
+ *       length: token.length,
+ *     };
+ *   }
+ * }
+ * ```
+ */
+exports.CurrentToken = (0, common_1.createParamDecorator)((data, ctx) => {
+    const request = ctx.switchToHttp().getRequest();
+    return request.token || null;
+});

package/dist/nestjs/decorators/current-user.decorator.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Current User Decorator
+ *
+ * Parameter decorator to extract the current authenticated user from the request.
+ * Requires that a guard has set request.user (e.g., OAuthAuthGuard).
+ */
+/**
+ * Current User Decorator
+ *
+ * Extracts the authenticated user from request.user.
+ * Returns null if no user is authenticated.
+ *
+ * @example
+ * ```typescript
+ * @Controller('users')
+ * @UseGuards(OAuthAuthGuard)
+ * export class UsersController {
+ *   @Get('profile')
+ *   getProfile(@CurrentUser() user: User) {
+ *     return user;
+ *   }
+ * }
+ * ```
+ */
+export declare const CurrentUser: any;
+//# sourceMappingURL=current-user.decorator.d.ts.map

package/dist/nestjs/decorators/current-user.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-user.decorator.d.ts","sourceRoot":"","sources":["../../../src/nestjs/decorators/current-user.decorator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,WAAW,KAKvB,CAAC"}

package/dist/nestjs/decorators/current-user.decorator.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Current User Decorator
+ *
+ * Parameter decorator to extract the current authenticated user from the request.
+ * Requires that a guard has set request.user (e.g., OAuthAuthGuard).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CurrentUser = void 0;
+// @ts-expect-error - @nestjs/common is a peer dependency, will be available at runtime in NestJS apps
+const common_1 = require("@nestjs/common");
+/**
+ * Current User Decorator
+ *
+ * Extracts the authenticated user from request.user.
+ * Returns null if no user is authenticated.
+ *
+ * @example
+ * ```typescript
+ * @Controller('users')
+ * @UseGuards(OAuthAuthGuard)
+ * export class UsersController {
+ *   @Get('profile')
+ *   getProfile(@CurrentUser() user: User) {
+ *     return user;
+ *   }
+ * }
+ * ```
+ */
+exports.CurrentUser = (0, common_1.createParamDecorator)((data, ctx) => {
+    const request = ctx.switchToHttp().getRequest();
+    return request.user || null;
+});

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

@@ -0,0 +1,9 @@
+/**
+ * NestJS Decorators
+ *
+ * Decorators for NestJS applications using win-portal-auth-sdk
+ */
+export { CurrentUser } from './current-user.decorator';
+export { CurrentToken } from './current-token.decorator';
+export { Public, IS_PUBLIC_KEY } from './public.decorator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/nestjs/decorators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/nestjs/decorators/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * NestJS Decorators
+ *
+ * Decorators for NestJS applications using win-portal-auth-sdk
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IS_PUBLIC_KEY = exports.Public = exports.CurrentToken = exports.CurrentUser = void 0;
+var current_user_decorator_1 = require("./current-user.decorator");
+Object.defineProperty(exports, "CurrentUser", { enumerable: true, get: function () { return current_user_decorator_1.CurrentUser; } });
+var current_token_decorator_1 = require("./current-token.decorator");
+Object.defineProperty(exports, "CurrentToken", { enumerable: true, get: function () { return current_token_decorator_1.CurrentToken; } });
+var public_decorator_1 = require("./public.decorator");
+Object.defineProperty(exports, "Public", { enumerable: true, get: function () { return public_decorator_1.Public; } });
+Object.defineProperty(exports, "IS_PUBLIC_KEY", { enumerable: true, get: function () { return public_decorator_1.IS_PUBLIC_KEY; } });

package/dist/nestjs/decorators/public.decorator.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Public Decorator
+ *
+ * Decorator to mark endpoints as public (skip authentication)
+ * Used with guards that support the IS_PUBLIC_KEY metadata.
+ */
+/**
+ * Metadata key for public endpoints
+ */
+export declare const IS_PUBLIC_KEY = "isPublic";
+/**
+ * Public decorator factory
+ *
+ * Marks an endpoint or controller as public, allowing access without authentication.
+ * Guards that support this decorator will skip authentication checks.
+ *
+ * @example
+ * ```typescript
+ * @Controller('api')
+ * @UseGuards(OAuthAuthGuard)
+ * export class ApiController {
+ *   @Public()
+ *   @Get('health')
+ *   healthCheck() {
+ *     return { status: 'ok' };
+ *   }
+ * }
+ * ```
+ */
+export declare const Public: () => any;
+//# sourceMappingURL=public.decorator.d.ts.map

package/dist/nestjs/decorators/public.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.decorator.d.ts","sourceRoot":"","sources":["../../../src/nestjs/decorators/public.decorator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,aAAa,CAAC;AAKxC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,MAAM,WAAyC,CAAC"}

package/dist/nestjs/decorators/public.decorator.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Public Decorator
+ *
+ * Decorator to mark endpoints as public (skip authentication)
+ * Used with guards that support the IS_PUBLIC_KEY metadata.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Public = exports.IS_PUBLIC_KEY = void 0;
+/**
+ * Metadata key for public endpoints
+ */
+exports.IS_PUBLIC_KEY = 'isPublic';
+// @ts-expect-error - @nestjs/common is a peer dependency, will be available at runtime in NestJS apps
+const common_1 = require("@nestjs/common");
+/**
+ * Public decorator factory
+ *
+ * Marks an endpoint or controller as public, allowing access without authentication.
+ * Guards that support this decorator will skip authentication checks.
+ *
+ * @example
+ * ```typescript
+ * @Controller('api')
+ * @UseGuards(OAuthAuthGuard)
+ * export class ApiController {
+ *   @Public()
+ *   @Get('health')
+ *   healthCheck() {
+ *     return { status: 'ok' };
+ *   }
+ * }
+ * ```
+ */
+const Public = () => (0, common_1.SetMetadata)(exports.IS_PUBLIC_KEY, true);
+exports.Public = Public;

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

@@ -0,0 +1,7 @@
+/**
+ * NestJS Guards
+ *
+ * Guards for NestJS applications using win-portal-auth-sdk
+ */
+export { OAuthAuthGuard, createOAuthAuthGuard, OAuthAuthGuardConfig } from './oauth-auth.guard';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/nestjs/guards/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/nestjs/guards/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * NestJS Guards
+ *
+ * Guards for NestJS applications using win-portal-auth-sdk
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOAuthAuthGuard = exports.OAuthAuthGuard = void 0;
+var oauth_auth_guard_1 = require("./oauth-auth.guard");
+Object.defineProperty(exports, "OAuthAuthGuard", { enumerable: true, get: function () { return oauth_auth_guard_1.OAuthAuthGuard; } });
+Object.defineProperty(exports, "createOAuthAuthGuard", { enumerable: true, get: function () { return oauth_auth_guard_1.createOAuthAuthGuard; } });

package/dist/nestjs/guards/oauth-auth.guard.d.ts

@@ -0,0 +1,139 @@
+/**
+ * OAuth Auth Guard
+ *
+ * Extended guard with OAuth-first validation, Public decorator support,
+ * and optional RequestContextService integration.
+ *
+ * Features:
+ * - OAuth-first validation: Tries OAuth token validation first, falls back to JWT
+ * - Public decorator support: Skips authentication for endpoints marked with @Public()
+ * - Optional RequestContextService integration: Sets user context if service is available
+ *
+ * @note This guard requires @nestjs/common and @nestjs/core as peer dependencies.
+ * The guard uses dynamic imports to avoid requiring NestJS as a direct dependency.
+ */
+import { AuthClient } from '../../client';
+import { User } from '../../types';
+import { MiddlewareConfig } from '../../middleware/types';
+/**
+ * Configuration for OAuthAuthGuard
+ */
+export interface OAuthAuthGuardConfig extends Omit<MiddlewareConfig, 'optional'> {
+    /**
+     * AuthClient instance (injected via DI)
+     * If not provided, guard will create its own instance
+     */
+    authClient?: AuthClient;
+}
+/**
+ * OAuth Auth Guard Class
+ *
+ * This guard extends the base SDK guard and adds:
+ * - Public decorator support
+ * - OAuth-first token validation
+ * - Optional RequestContextService integration
+ *
+ * @example
+ * ```typescript
+ * // In your module
+ * @Module({
+ *   providers: [
+ *     {
+ *       provide: 'AUTH_CLIENT',
+ *       useFactory: () => new AuthClient({
+ *         baseURL: process.env.AUTH_API_URL,
+ *         apiKey: process.env.AUTH_API_KEY,
+ *       }),
+ *     },
+ *   ],
+ * })
+ * export class AuthModule {}
+ *
+ * // In your controller
+ * @Controller('api')
+ * @UseGuards(OAuthAuthGuard)
+ * export class ApiController {
+ *   @Get('profile')
+ *   getProfile(@CurrentUser() user: User) {
+ *     return user;
+ *   }
+ *
+ *   @Public()
+ *   @Get('health')
+ *   healthCheck() {
+ *     return { status: 'ok' };
+ *   }
+ * }
+ * ```
+ */
+export declare class OAuthAuthGuard {
+    readonly baseGuard: any;
+    readonly authClient?: AuthClient;
+    readonly reflector: any;
+    readonly logger: any;
+    constructor(config: OAuthAuthGuardConfig, reflector: any, authClient?: AuthClient);
+    canActivate(context: any): Promise<boolean>;
+    /**
+     * Set user info in RequestContextService if available
+     * @internal
+     */
+    setRequestContext(user: User, token: string): void;
+    /**
+     * Handle successful authentication
+     * @internal
+     */
+    handleSuccess(request: any, token: string | null): boolean;
+}
+/**
+ * Factory function to create OAuthAuthGuard
+ *
+ * This factory creates a guard class that can be used with NestJS dependency injection.
+ *
+ * @example
+ * ```typescript
+ * // In your module
+ * @Module({
+ *   providers: [
+ *     {
+ *       provide: 'AUTH_CLIENT',
+ *       useFactory: () => new AuthClient({
+ *         baseURL: process.env.AUTH_API_URL,
+ *         apiKey: process.env.AUTH_API_KEY,
+ *       }),
+ *     },
+ *   ],
+ * })
+ * export class AuthModule {}
+ *
+ * // Create guard instance
+ * const guard = createOAuthAuthGuard({
+ *   baseURL: process.env.AUTH_API_URL || '',
+ *   apiKey: process.env.AUTH_API_KEY || '',
+ * });
+ *
+ * // Use in controller
+ * @Controller('api')
+ * @UseGuards(guard)
+ * export class ApiController {}
+ * ```
+ */
+export declare function createOAuthAuthGuard(config: OAuthAuthGuardConfig): {
+    new (reflector: any, authClient?: AuthClient): {
+        readonly baseGuard: any;
+        readonly authClient?: AuthClient | undefined;
+        readonly reflector: any;
+        readonly logger: any;
+        canActivate(context: any): Promise<boolean>;
+        /**
+         * Set user info in RequestContextService if available
+         * @internal
+         */
+        setRequestContext(user: User, token: string): void;
+        /**
+         * Handle successful authentication
+         * @internal
+         */
+        handleSuccess(request: any, token: string | null): boolean;
+    };
+};
+//# sourceMappingURL=oauth-auth.guard.d.ts.map

package/dist/nestjs/guards/oauth-auth.guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-auth.guard.d.ts","sourceRoot":"","sources":["../../../src/nestjs/guards/oauth-auth.guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAC9E;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAAa,cAAc;IAGzB,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;gBAGnB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,GAAG,EACd,UAAU,CAAC,EAAE,UAAU;IAgCnB,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAyGjD;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAmBlD;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;CAM3D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB;oBAEtC,GAAG,eAAe,UAAU;;;;;;QAtErD;;;WAGG;;QAoBH;;;WAGG;;;EAiDJ"}

package/dist/nestjs/guards/oauth-auth.guard.js

@@ -0,0 +1,257 @@
+"use strict";
+/**
+ * OAuth Auth Guard
+ *
+ * Extended guard with OAuth-first validation, Public decorator support,
+ * and optional RequestContextService integration.
+ *
+ * Features:
+ * - OAuth-first validation: Tries OAuth token validation first, falls back to JWT
+ * - Public decorator support: Skips authentication for endpoints marked with @Public()
+ * - Optional RequestContextService integration: Sets user context if service is available
+ *
+ * @note This guard requires @nestjs/common and @nestjs/core as peer dependencies.
+ * The guard uses dynamic imports to avoid requiring NestJS as a direct dependency.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOAuthAuthGuard = exports.OAuthAuthGuard = void 0;
+const decorators_1 = require("../decorators");
+const middleware_1 = require("../../middleware");
+const request_context_types_1 = require("../types/request-context.types");
+/**
+ * Base Auth Guard from SDK
+ * This is the foundation guard that handles JWT validation
+ */
+function createBaseAuthGuard(config) {
+    return (0, middleware_1.createAuthGuard)(config);
+}
+/**
+ * OAuth Auth Guard Class
+ *
+ * This guard extends the base SDK guard and adds:
+ * - Public decorator support
+ * - OAuth-first token validation
+ * - Optional RequestContextService integration
+ *
+ * @example
+ * ```typescript
+ * // In your module
+ * @Module({
+ *   providers: [
+ *     {
+ *       provide: 'AUTH_CLIENT',
+ *       useFactory: () => new AuthClient({
+ *         baseURL: process.env.AUTH_API_URL,
+ *         apiKey: process.env.AUTH_API_KEY,
+ *       }),
+ *     },
+ *   ],
+ * })
+ * export class AuthModule {}
+ *
+ * // In your controller
+ * @Controller('api')
+ * @UseGuards(OAuthAuthGuard)
+ * export class ApiController {
+ *   @Get('profile')
+ *   getProfile(@CurrentUser() user: User) {
+ *     return user;
+ *   }
+ *
+ *   @Public()
+ *   @Get('health')
+ *   healthCheck() {
+ *     return { status: 'ok' };
+ *   }
+ * }
+ * ```
+ */
+class OAuthAuthGuard {
+    constructor(config, reflector, authClient) {
+        // Create base guard for fallback JWT validation
+        this.baseGuard = createBaseAuthGuard({
+            baseURL: config.baseURL,
+            apiKey: config.apiKey,
+            apiKeyHeader: config.apiKeyHeader || 'X-API-Key',
+            tokenStrategy: config.tokenStrategy || 'bearer',
+            cacheTimeout: config.cacheTimeout || 300,
+        });
+        this.authClient = authClient || config.authClient;
+        this.reflector = reflector;
+        // Try to get Logger from @nestjs/common
+        // Use dynamic require to avoid requiring @nestjs/common as direct dependency
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { Logger } = require('@nestjs/common');
+            this.logger = new Logger('OAuthAuthGuard');
+        }
+        catch {
+            // Fallback logger if @nestjs/common is not available
+            // This should not happen in normal NestJS usage
+            this.logger = {
+                debug: () => { },
+                log: () => { },
+                warn: () => { },
+                error: () => { },
+            };
+        }
+    }
+    async canActivate(context) {
+        // Check if endpoint is marked as public
+        const isPublic = this.reflector?.getAllAndOverride
+            ? this.reflector.getAllAndOverride(decorators_1.IS_PUBLIC_KEY, [context.getHandler(), context.getClass()])
+            : undefined;
+        if (isPublic) {
+            this.logger.debug('Public endpoint - skipping authentication');
+            return true;
+        }
+        const request = context.switchToHttp().getRequest();
+        const authHeader = request.headers?.authorization;
+        if (!authHeader) {
+            // Try base guard (might handle missing token differently)
+            const result = await this.baseGuard.canActivate(context);
+            if (!result) {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const { UnauthorizedException } = require('@nestjs/common');
+                throw new UnauthorizedException('Missing authorization token');
+            }
+            return this.handleSuccess(request, request.token);
+        }
+        // Extract token from Authorization header
+        const token = authHeader.replace(/^Bearer\s+/i, '');
+        if (!token) {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { UnauthorizedException } = require('@nestjs/common');
+            throw new UnauthorizedException('Missing authorization token');
+        }
+        // Check environment variables
+        const authApiUrl = process.env.AUTH_API_URL;
+        const authApiKey = process.env.AUTH_API_KEY;
+        if (!authApiUrl || !authApiKey) {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { UnauthorizedException } = require('@nestjs/common');
+            throw new UnauthorizedException('Authentication service not configured');
+        }
+        try {
+            // Try OAuth validation first if AuthClient is available
+            if (this.authClient) {
+                try {
+                    this.authClient.setToken(token, 'oauth');
+                    const user = await this.authClient.auth.profile();
+                    // Set user and token in request
+                    request.user = user;
+                    request.token = token;
+                    // Set user info in RequestContextService (if available)
+                    this.setRequestContext(user, token);
+                    this.logger.debug(`OAuth authentication successful for user: ${user.id}`);
+                    return true;
+                }
+                catch (oauthError) {
+                    // OAuth validation failed, try base guard (JWT fallback)
+                    this.logger.debug('OAuth validation failed, trying JWT fallback');
+                }
+            }
+            // Fallback to base guard (JWT validation)
+            const result = await this.baseGuard.canActivate(context);
+            if (result === false) {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const { UnauthorizedException } = require('@nestjs/common');
+                throw new UnauthorizedException('Invalid or expired token');
+            }
+            // Set user info in RequestContextService (if available)
+            if (request.user) {
+                this.setRequestContext(request.user, token);
+            }
+            return true;
+        }
+        catch (error) {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { UnauthorizedException, HttpException } = require('@nestjs/common');
+            if (error instanceof UnauthorizedException) {
+                throw error;
+            }
+            if (error instanceof HttpException) {
+                const httpError = error;
+                const status = httpError.getStatus();
+                if (status === 401 || status === 403) {
+                    throw new UnauthorizedException('Invalid or expired token');
+                }
+                throw error;
+            }
+            throw new UnauthorizedException('Invalid or expired token');
+        }
+    }
+    /**
+     * Set user info in RequestContextService if available
+     * @internal
+     */
+    setRequestContext(user, token) {
+        const requestContextService = (0, request_context_types_1.getRequestContextService)();
+        if (requestContextService) {
+            try {
+                requestContextService.setUserInfo(user.id, user.email, undefined, token);
+                if (user.permissions) {
+                    requestContextService.setUserPermissions(user.permissions, user.roles || []);
+                }
+            }
+            catch (error) {
+                // RequestContextService not available or error setting context
+                // This is fine - guard will work without it
+                this.logger.debug('RequestContextService not available or error setting context');
+            }
+        }
+    }
+    /**
+     * Handle successful authentication
+     * @internal
+     */
+    handleSuccess(request, token) {
+        if (request.user && token) {
+            this.setRequestContext(request.user, token);
+        }
+        return true;
+    }
+}
+exports.OAuthAuthGuard = OAuthAuthGuard;
+/**
+ * Factory function to create OAuthAuthGuard
+ *
+ * This factory creates a guard class that can be used with NestJS dependency injection.
+ *
+ * @example
+ * ```typescript
+ * // In your module
+ * @Module({
+ *   providers: [
+ *     {
+ *       provide: 'AUTH_CLIENT',
+ *       useFactory: () => new AuthClient({
+ *         baseURL: process.env.AUTH_API_URL,
+ *         apiKey: process.env.AUTH_API_KEY,
+ *       }),
+ *     },
+ *   ],
+ * })
+ * export class AuthModule {}
+ *
+ * // Create guard instance
+ * const guard = createOAuthAuthGuard({
+ *   baseURL: process.env.AUTH_API_URL || '',
+ *   apiKey: process.env.AUTH_API_KEY || '',
+ * });
+ *
+ * // Use in controller
+ * @Controller('api')
+ * @UseGuards(guard)
+ * export class ApiController {}
+ * ```
+ */
+function createOAuthAuthGuard(config) {
+    class OAuthAuthGuardInstance extends OAuthAuthGuard {
+        constructor(reflector, authClient) {
+            super(config, reflector, authClient);
+        }
+    }
+    return OAuthAuthGuardInstance;
+}
+exports.createOAuthAuthGuard = createOAuthAuthGuard;

package/dist/nestjs/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * NestJS Integration Module
+ *
+ * Complete NestJS integration for win-portal-auth-sdk
+ * Includes guards, decorators, and middleware for easy setup.
+ *
+ * @example
+ * ```typescript
+ * // Import everything you need
+ * import {
+ *   OAuthAuthGuard,
+ *   createOAuthAuthGuard,
+ *   CurrentUser,
+ *   CurrentToken,
+ *   Public,
+ *   RequestContextMiddleware,
+ * } from 'win-portal-auth-sdk/nestjs';
+ *
+ * // Or import from specific modules
+ * import { OAuthAuthGuard } from 'win-portal-auth-sdk/nestjs/guards';
+ * import { CurrentUser, Public } from 'win-portal-auth-sdk/nestjs/decorators';
+ * ```
+ */
+export * from './guards';
+export * from './decorators';
+export * from './middleware';
+export * from './types/request-context.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,cAAc,CAAC;AAG7B,cAAc,cAAc,CAAC;AAG7B,cAAc,+BAA+B,CAAC"}

package/dist/nestjs/index.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * NestJS Integration Module
+ *
+ * Complete NestJS integration for win-portal-auth-sdk
+ * Includes guards, decorators, and middleware for easy setup.
+ *
+ * @example
+ * ```typescript
+ * // Import everything you need
+ * import {
+ *   OAuthAuthGuard,
+ *   createOAuthAuthGuard,
+ *   CurrentUser,
+ *   CurrentToken,
+ *   Public,
+ *   RequestContextMiddleware,
+ * } from 'win-portal-auth-sdk/nestjs';
+ *
+ * // Or import from specific modules
+ * import { OAuthAuthGuard } from 'win-portal-auth-sdk/nestjs/guards';
+ * import { CurrentUser, Public } from 'win-portal-auth-sdk/nestjs/decorators';
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Guards
+__exportStar(require("./guards"), exports);
+// Decorators
+__exportStar(require("./decorators"), exports);
+// Middleware
+__exportStar(require("./middleware"), exports);
+// Types
+__exportStar(require("./types/request-context.types"), exports);

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

@@ -0,0 +1,7 @@
+/**
+ * NestJS Middleware
+ *
+ * Middleware for NestJS applications using win-portal-auth-sdk
+ */
+export { RequestContextMiddleware, createRequestContextMiddleware, } from './request-context.middleware';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/nestjs/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,8BAA8B,CAAC"}

package/dist/nestjs/middleware/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * NestJS Middleware
+ *
+ * Middleware for NestJS applications using win-portal-auth-sdk
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRequestContextMiddleware = exports.RequestContextMiddleware = void 0;
+var request_context_middleware_1 = require("./request-context.middleware");
+Object.defineProperty(exports, "RequestContextMiddleware", { enumerable: true, get: function () { return request_context_middleware_1.RequestContextMiddleware; } });
+Object.defineProperty(exports, "createRequestContextMiddleware", { enumerable: true, get: function () { return request_context_middleware_1.createRequestContextMiddleware; } });

package/dist/nestjs/middleware/request-context.middleware.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Request Context Middleware
+ *
+ * Optional middleware for managing request context with RequestContextService.
+ * This middleware creates a request context with requestId, ipAddress, userAgent,
+ * and runs the request within AsyncLocalStorage context.
+ *
+ * Note: This middleware requires RequestContextService to be available in the application.
+ * If RequestContextService is not available, the middleware will still work but
+ * won't set up the context.
+ *
+ * @example
+ * ```typescript
+ * // In your AppModule
+ * import { RequestContextMiddleware } from 'win-portal-auth-sdk/nestjs';
+ *
+ * @Module({})
+ * export class AppModule implements NestModule {
+ *   configure(consumer: MiddlewareConsumer) {
+ *     consumer.apply(RequestContextMiddleware).forRoutes('*');
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Request Context Middleware Class
+ *
+ * Creates request context and runs request within AsyncLocalStorage context.
+ */
+export declare class RequestContextMiddleware {
+    /**
+     * Generate request ID
+     * Uses uuid v4 if available, otherwise generates a simple ID
+     */
+    private generateRequestId;
+    /**
+     * Get client IP address from request
+     */
+    private getClientIP;
+    /**
+     * Middleware handler
+     */
+    use(req: any, res: any, next: () => void): void;
+}
+/**
+ * Factory function to create RequestContextMiddleware
+ *
+ * @example
+ * ```typescript
+ * // In your AppModule
+ * import { createRequestContextMiddleware } from 'win-portal-auth-sdk/nestjs';
+ *
+ * @Module({})
+ * export class AppModule implements NestModule {
+ *   configure(consumer: MiddlewareConsumer) {
+ *     consumer.apply(createRequestContextMiddleware()).forRoutes('*');
+ *   }
+ * }
+ * ```
+ */
+export declare function createRequestContextMiddleware(): RequestContextMiddleware;
+//# sourceMappingURL=request-context.middleware.d.ts.map

package/dist/nestjs/middleware/request-context.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.middleware.d.ts","sourceRoot":"","sources":["../../../src/nestjs/middleware/request-context.middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH;;;;GAIG;AACH,qBAAa,wBAAwB;IACnC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI;CA2ChD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,8BAA8B,6BAE7C"}

package/dist/nestjs/middleware/request-context.middleware.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * Request Context Middleware
+ *
+ * Optional middleware for managing request context with RequestContextService.
+ * This middleware creates a request context with requestId, ipAddress, userAgent,
+ * and runs the request within AsyncLocalStorage context.
+ *
+ * Note: This middleware requires RequestContextService to be available in the application.
+ * If RequestContextService is not available, the middleware will still work but
+ * won't set up the context.
+ *
+ * @example
+ * ```typescript
+ * // In your AppModule
+ * import { RequestContextMiddleware } from 'win-portal-auth-sdk/nestjs';
+ *
+ * @Module({})
+ * export class AppModule implements NestModule {
+ *   configure(consumer: MiddlewareConsumer) {
+ *     consumer.apply(RequestContextMiddleware).forRoutes('*');
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRequestContextMiddleware = exports.RequestContextMiddleware = void 0;
+const request_context_types_1 = require("../types/request-context.types");
+/**
+ * Request Context Middleware Class
+ *
+ * Creates request context and runs request within AsyncLocalStorage context.
+ */
+class RequestContextMiddleware {
+    /**
+     * Generate request ID
+     * Uses uuid v4 if available, otherwise generates a simple ID
+     */
+    generateRequestId() {
+        try {
+            const { v4: uuidv4 } = require('uuid');
+            return uuidv4();
+        }
+        catch {
+            // Fallback if uuid is not available
+            return `req-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        }
+    }
+    /**
+     * Get client IP address from request
+     */
+    getClientIP(req) {
+        return (req.headers['x-forwarded-for']?.split(',')[0]?.trim() ||
+            req.headers['x-real-ip'] ||
+            req.connection?.remoteAddress ||
+            req.socket?.remoteAddress ||
+            '127.0.0.1');
+    }
+    /**
+     * Middleware handler
+     */
+    use(req, res, next) {
+        const requestId = this.generateRequestId();
+        const ipAddress = this.getClientIP(req);
+        const userAgent = req.get('user-agent') || req.headers['user-agent'] || 'Unknown';
+        const origin = req.get('origin') || req.get('referer');
+        // Set request ID in response headers for debugging
+        if (res && typeof res.setHeader === 'function') {
+            res.setHeader('X-Request-ID', requestId);
+        }
+        // Store context in request object
+        const requestContext = {
+            requestId,
+            ipAddress,
+            userAgent,
+            origin,
+            method: req.method,
+            url: req.url,
+            timestamp: new Date(),
+        };
+        // Attach to request object
+        req.requestContext = requestContext;
+        // Try to use RequestContextService if available
+        const requestContextService = (0, request_context_types_1.getRequestContextService)();
+        if (requestContextService) {
+            try {
+                // Run the entire request pipeline within AsyncLocalStorage context
+                requestContextService.runWithContext(req, () => {
+                    next();
+                });
+                return;
+            }
+            catch (error) {
+                // RequestContextService not available or error
+                // Continue without it
+            }
+        }
+        // If RequestContextService is not available, just continue
+        next();
+    }
+}
+exports.RequestContextMiddleware = RequestContextMiddleware;
+/**
+ * Factory function to create RequestContextMiddleware
+ *
+ * @example
+ * ```typescript
+ * // In your AppModule
+ * import { createRequestContextMiddleware } from 'win-portal-auth-sdk/nestjs';
+ *
+ * @Module({})
+ * export class AppModule implements NestModule {
+ *   configure(consumer: MiddlewareConsumer) {
+ *     consumer.apply(createRequestContextMiddleware()).forRoutes('*');
+ *   }
+ * }
+ * ```
+ */
+function createRequestContextMiddleware() {
+    return new RequestContextMiddleware();
+}
+exports.createRequestContextMiddleware = createRequestContextMiddleware;

package/dist/nestjs/types/request-context.types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Request Context Types
+ *
+ * Type definitions for optional RequestContextService integration
+ * These types allow SDK components to work with RequestContextService
+ * if it's available in the application, without requiring it as a dependency.
+ */
+/**
+ * Request Context Data Interface
+ *
+ * Matches the structure used by RequestContextService in applications
+ */
+export interface RequestContextData {
+    requestId: string;
+    ipAddress: string;
+    userAgent: string;
+    origin?: string;
+    userId?: string;
+    userEmail?: string;
+    sessionId?: string;
+    method: string;
+    url: string;
+    timestamp: Date;
+    authToken?: string;
+    permissions?: string[];
+    roles?: Array<{
+        id: string;
+        name: string;
+    }>;
+    roleCodes?: string[];
+    applicationId?: string;
+    applicationName?: string;
+    apiKeyId?: string;
+}
+/**
+ * Optional RequestContextService Interface
+ *
+ * This interface represents the static methods available on RequestContextService
+ * that SDK components can use if the service is available.
+ */
+export interface RequestContextServiceInterface {
+    /**
+     * Get current request context
+     */
+    getContext(): RequestContextData | undefined;
+    /**
+     * Run function with request context
+     */
+    runWithContext<T>(req: any, fn: () => T): T;
+    /**
+     * Set user info in current context
+     */
+    setUserInfo(userId: string, userEmail: string, sessionId?: string, authToken?: string): void;
+    /**
+     * Set user permissions and roles in context
+     */
+    setUserPermissions(permissions: string[], roles: string[] | Array<{
+        id: string;
+        name: string;
+    }>): void;
+}
+/**
+ * Helper function to safely access RequestContextService
+ *
+ * This function checks if RequestContextService is available and returns
+ * a typed interface if it exists, or undefined if not.
+ */
+export declare function getRequestContextService(): RequestContextServiceInterface | undefined;
+//# sourceMappingURL=request-context.types.d.ts.map

package/dist/nestjs/types/request-context.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.types.d.ts","sourceRoot":"","sources":["../../../src/nestjs/types/request-context.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,UAAU,IAAI,kBAAkB,GAAG,SAAS,CAAC;IAE7C;;OAEG;IACH,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAE5C;;OAEG;IACH,WAAW,CACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAAC;IAER;;OAEG;IACH,kBAAkB,CAChB,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GACpD,IAAI,CAAC;CACT;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,8BAA8B,GAAG,SAAS,CAcrF"}

package/dist/nestjs/types/request-context.types.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Request Context Types
+ *
+ * Type definitions for optional RequestContextService integration
+ * These types allow SDK components to work with RequestContextService
+ * if it's available in the application, without requiring it as a dependency.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRequestContextService = void 0;
+/**
+ * Helper function to safely access RequestContextService
+ *
+ * This function checks if RequestContextService is available and returns
+ * a typed interface if it exists, or undefined if not.
+ */
+function getRequestContextService() {
+    // Try to access RequestContextService from global scope or module
+    // This is a safe way to check if the service exists without requiring it
+    try {
+        // Check if RequestContextService exists in the runtime
+        // Applications that use RequestContextService will have it available
+        const RequestContextService = global.RequestContextService;
+        if (RequestContextService && typeof RequestContextService.setUserInfo === 'function') {
+            return RequestContextService;
+        }
+    }
+    catch {
+        // RequestContextService not available
+    }
+    return undefined;
+}
+exports.getRequestContextService = getRequestContextService;

package/package.json

@@ -1,9 +1,31 @@
 {
   "name": "win-portal-auth-sdk",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "Shared authentication SDK for Win Portal applications with JWT and OAuth support",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware/index.d.ts",
+      "default": "./dist/middleware/index.js"
+    },
+    "./nestjs": {
+      "types": "./dist/nestjs/index.d.ts",
+      "default": "./dist/nestjs/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "default": "./dist/client/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/types/index.js"
+    }
+  },
   "files": [
     "dist",
     "README.md",
@@ -47,6 +69,22 @@
   "dependencies": {
     "axios": "^1.6.0"
   },
+  "peerDependencies": {
+    "@nestjs/common": "^10.0.0 || ^11.0.0",
+    "@nestjs/core": "^10.0.0 || ^11.0.0",
+    "uuid": "^9.0.0 || ^10.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/common": {
+      "optional": true
+    },
+    "@nestjs/core": {
+      "optional": true
+    },
+    "uuid": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "typescript": "^5.3.0"