@saultechitsolutions/gighub-shared-core 1.0.0

package/dist/audit/audit.module.d.ts

@@ -0,0 +1,2 @@
+export declare class AuditModule {
+}

package/dist/audit/audit.module.js

@@ -0,0 +1,25 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditModule = void 0;
+const common_1 = require("@nestjs/common");
+const kafka_module_1 = require("../kafka/kafka.module");
+const request_context_module_1 = require("../context/request-context.module");
+const audit_service_1 = require("./audit.service");
+let AuditModule = class AuditModule {
+};
+exports.AuditModule = AuditModule;
+exports.AuditModule = AuditModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        imports: [kafka_module_1.KafkaModule, request_context_module_1.RequestContextModule],
+        providers: [audit_service_1.AuditService],
+        exports: [audit_service_1.AuditService],
+    })
+], AuditModule);
+//# sourceMappingURL=audit.module.js.map

package/dist/audit/audit.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.module.js","sourceRoot":"","sources":["../../src/audit/audit.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgD;AAChD,wDAAoD;AACpD,8EAAyE;AACzE,mDAA6C;AAQtC,IAAM,WAAW,GAAjB,MAAM,WAAW;CAAG,CAAA;AAAd,kCAAW;sBAAX,WAAW;IANvB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACJ,OAAO,EAAE,CAAC,0BAAW,EAAE,6CAAoB,CAAC;QAC5C,SAAS,EAAE,CAAC,4BAAY,CAAC;QACzB,OAAO,EAAE,CAAC,4BAAY,CAAC;KAC1B,CAAC;GACW,WAAW,CAAG"}

package/dist/audit/audit.service.d.ts

@@ -0,0 +1,16 @@
+import { KafkaService } from '../kafka/kafka.service';
+import { RequestContextService } from "../context/request-context.service";
+export declare class AuditService {
+    private readonly kafkaService;
+    private readonly requestContextService;
+    private readonly logger;
+    constructor(kafkaService: KafkaService, requestContextService: RequestContextService);
+    log(action: string, entity: string, entityId?: string | number, metadata?: any, before?: Record<string, any>, after?: Record<string, any>): Promise<void>;
+    logCreate(entity: string, entityId: string | number, data: Record<string, any>, metadata?: any): Promise<void>;
+    logUpdate(entity: string, entityId: string | number, before: Record<string, any>, after: Record<string, any>, metadata?: any): Promise<void>;
+    logDelete(entity: string, entityId: string | number, data: Record<string, any>, metadata?: any): Promise<void>;
+    logView(entity: string, entityId: string | number, metadata?: any): Promise<void>;
+    logAction(action: string, entity: string, entityId?: string | number, data?: Record<string, any>, metadata?: any): Promise<void>;
+    logAuth(action: 'login' | 'logout' | 'login.failed' | 'password.reset' | 'password.changed', userId?: string, metadata?: any): Promise<void>;
+    logSecurity(action: string, description: string, metadata?: any): Promise<void>;
+}

package/dist/audit/audit.service.js

@@ -0,0 +1,95 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var AuditService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditService = void 0;
+const common_1 = require("@nestjs/common");
+const kafka_service_1 = require("../kafka/kafka.service");
+const request_context_service_1 = require("../context/request-context.service");
+let AuditService = AuditService_1 = class AuditService {
+    constructor(kafkaService, requestContextService) {
+        this.kafkaService = kafkaService;
+        this.requestContextService = requestContextService;
+        this.logger = new common_1.Logger(AuditService_1.name);
+    }
+    async log(action, entity, entityId, metadata, before, after) {
+        try {
+            const context = this.requestContextService.getContext();
+            const event = {
+                userId: context.userId || 'system',
+                userRole: context.userRole,
+                userType: context.userType,
+                action,
+                entity,
+                entityId: entityId?.toString(),
+                before,
+                after,
+                ip: context.ip,
+                userAgent: context.userAgent,
+                device: context.device ? {
+                    type: context.device.type,
+                    os: context.device.os,
+                    browser: context.device.browser,
+                    isMobile: context.device.type === 'mobile',
+                } : undefined,
+                location: context.location ? {
+                    country: context.location.country,
+                    countryCode: context.location.countryCode,
+                    region: context.location.region,
+                    city: context.location.city,
+                    latitude: context.location.latitude,
+                    longitude: context.location.longitude,
+                    timezone: context.location.timezone,
+                } : undefined,
+                correlationId: context.correlationId,
+                requestId: context.requestId,
+                timestamp: Date.now(),
+                metadata,
+            };
+            await this.kafkaService.sendMessage('audit-events', JSON.stringify(event));
+            this.logger.log(`[AUDIT] ${event.action} by ${event.userId} on ${event.entity}${event.entityId ? ` #${event.entityId}` : ''}`);
+        }
+        catch (error) {
+            this.logger.error('Failed to publish audit event:', error);
+        }
+    }
+    async logCreate(entity, entityId, data, metadata) {
+        await this.log(`${entity.toLowerCase()}.created`, entity, entityId, metadata, undefined, data);
+    }
+    async logUpdate(entity, entityId, before, after, metadata) {
+        await this.log(`${entity.toLowerCase()}.updated`, entity, entityId, metadata, before, after);
+    }
+    async logDelete(entity, entityId, data, metadata) {
+        await this.log(`${entity.toLowerCase()}.deleted`, entity, entityId, metadata, data, undefined);
+    }
+    async logView(entity, entityId, metadata) {
+        await this.log(`${entity.toLowerCase()}.viewed`, entity, entityId, metadata);
+    }
+    async logAction(action, entity, entityId, data, metadata) {
+        await this.log(action, entity, entityId, metadata, undefined, data);
+    }
+    async logAuth(action, userId, metadata) {
+        await this.log(`auth.${action}`, 'Auth', userId, metadata);
+    }
+    async logSecurity(action, description, metadata) {
+        await this.log(`security.${action}`, 'Security', undefined, {
+            ...metadata,
+            description,
+        });
+    }
+};
+exports.AuditService = AuditService;
+exports.AuditService = AuditService = AuditService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [kafka_service_1.KafkaService,
+        request_context_service_1.RequestContextService])
+], AuditService);
+//# sourceMappingURL=audit.service.js.map

package/dist/audit/audit.service.js.map

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

package/dist/audit/interfaces/audit-log.interface.d.ts

@@ -0,0 +1,36 @@
+export interface AuditEvent {
+    userId: string;
+    tenantId?: string;
+    userRole?: string;
+    userType?: string;
+    action: string;
+    entity: string;
+    entityId?: string;
+    before?: Record<string, any>;
+    after?: Record<string, any>;
+    ip?: string;
+    userAgent?: string;
+    device?: {
+        type?: string;
+        os?: string;
+        osVersion?: string;
+        browser?: string;
+        browserVersion?: string;
+        brand?: string;
+        model?: string;
+        isMobile?: boolean;
+    };
+    location?: {
+        country?: string;
+        countryCode?: string;
+        region?: string;
+        city?: string;
+        latitude?: number;
+        longitude?: number;
+        timezone?: string;
+    };
+    correlationId?: string;
+    requestId?: string;
+    timestamp: number;
+    metadata?: any;
+}

package/dist/audit/interfaces/audit-log.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=audit-log.interface.js.map

package/dist/audit/interfaces/audit-log.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.interface.js","sourceRoot":"","sources":["../../../src/audit/interfaces/audit-log.interface.ts"],"names":[],"mappings":""}

package/dist/context/geolocation.service.d.ts

@@ -0,0 +1,19 @@
+import { RedisService } from "../redis/redis.service";
+export interface GeoLocation {
+    country?: string;
+    region?: string;
+    city?: string;
+    lat?: number;
+    lon?: number;
+}
+export declare class GeolocationService {
+    private readonly redisService;
+    private readonly logger;
+    private readonly cacheKeyPrefix;
+    constructor(redisService: RedisService);
+    getLocation(ip: string): Promise<GeoLocation | null>;
+    clearCache(): Promise<void>;
+    getStats(): Promise<{
+        note: string;
+    }>;
+}

package/dist/context/geolocation.service.js

@@ -0,0 +1,87 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var GeolocationService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeolocationService = void 0;
+const common_1 = require("@nestjs/common");
+const node_fetch_1 = require("node-fetch");
+const redis_service_1 = require("../redis/redis.service");
+let GeolocationService = GeolocationService_1 = class GeolocationService {
+    constructor(redisService) {
+        this.redisService = redisService;
+        this.logger = new common_1.Logger(GeolocationService_1.name);
+        this.cacheKeyPrefix = 'geo:';
+    }
+    async getLocation(ip) {
+        if (!ip ||
+            ip === 'unknown' ||
+            ip === '127.0.0.1' ||
+            ip === '::1' ||
+            ip.startsWith('192.168.') ||
+            ip.startsWith('10.') ||
+            ip.startsWith('172.')) {
+            return null;
+        }
+        const cacheKey = `${this.cacheKeyPrefix}${ip}`;
+        const cached = await this.redisService.get(cacheKey);
+        if (cached !== undefined) {
+            if (cached === null) {
+                this.logger.debug(`Geo cache HIT (null) for IP: ${ip}`);
+            }
+            else {
+                this.logger.debug(`Geo cache HIT for IP: ${ip}`);
+            }
+            return cached;
+        }
+        this.logger.debug(`Geo cache MISS for IP: ${ip} – fetching from ip-api.com`);
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 5000);
+            const response = await (0, node_fetch_1.default)(`http://ip-api.com/json/${ip}?fields=status,message,country,regionName,city,lat,lon`, { signal: controller.signal });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}`);
+            }
+            const data = await response.json();
+            if (data.status !== 'success') {
+                this.logger.warn(`ip-api.com failed for ${ip}: ${data.message || 'unknown'}`);
+                await this.redisService.set(cacheKey, null, 3600);
+                return null;
+            }
+            const location = {
+                country: data.country,
+                region: data.regionName,
+                city: data.city,
+                lat: data.lat,
+                lon: data.lon,
+            };
+            await this.redisService.set(cacheKey, location, 86400);
+            return location;
+        }
+        catch (error) {
+            this.logger.warn(`Geolocation lookup failed for ${ip}: ${error.message || error}`);
+            await this.redisService.set(cacheKey, null, 600);
+            return null;
+        }
+    }
+    async clearCache() {
+        this.logger.log('Cache clear requested – not implemented for in-memory store');
+    }
+    async getStats() {
+        return { note: 'Stats not available with default in-memory store' };
+    }
+};
+exports.GeolocationService = GeolocationService;
+exports.GeolocationService = GeolocationService = GeolocationService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [redis_service_1.RedisService])
+], GeolocationService);
+//# sourceMappingURL=geolocation.service.js.map

package/dist/context/geolocation.service.js.map

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

package/dist/context/interfaces/request-context.interface.d.ts

@@ -0,0 +1,29 @@
+export interface RequestContext {
+    correlationId: string;
+    requestId?: string;
+    userId?: string;
+    userEmail?: string;
+    userRole?: string;
+    userType?: string;
+    roles?: string[];
+    ip: string;
+    userAgent: string;
+    device?: {
+        type: string;
+        os?: string;
+        browser?: string;
+        version?: string;
+    };
+    location?: {
+        country?: string;
+        countryCode?: string;
+        region?: string;
+        city?: string;
+        latitude?: number;
+        longitude?: number;
+        timezone?: string;
+    };
+    path?: string;
+    method?: string;
+    timestamp?: Date;
+}

package/dist/context/interfaces/request-context.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=request-context.interface.js.map

package/dist/context/interfaces/request-context.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.interface.js","sourceRoot":"","sources":["../../../src/context/interfaces/request-context.interface.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,11 @@
+import { NestMiddleware } from '@nestjs/common';
+import { Request, Response, NextFunction } from 'express';
+import { RequestContextService } from './request-context.service';
+import { GeolocationService } from './geolocation.service';
+export declare class RequestContextMiddleware implements NestMiddleware {
+    private readonly contextService;
+    private readonly geolocationService;
+    private readonly logger;
+    constructor(contextService: RequestContextService, geolocationService: GeolocationService);
+    use(req: Request, res: Response, next: NextFunction): Promise<void>;
+}

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

@@ -0,0 +1,88 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var RequestContextMiddleware_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestContextMiddleware = void 0;
+const common_1 = require("@nestjs/common");
+const uuid_1 = require("uuid");
+const request_context_service_1 = require("./request-context.service");
+const geolocation_service_1 = require("./geolocation.service");
+let RequestContextMiddleware = RequestContextMiddleware_1 = class RequestContextMiddleware {
+    constructor(contextService, geolocationService) {
+        this.contextService = contextService;
+        this.geolocationService = geolocationService;
+        this.logger = new common_1.Logger(RequestContextMiddleware_1.name);
+    }
+    async use(req, res, next) {
+        const namespace = request_context_service_1.RequestContextService.getNamespace();
+        namespace.run(async () => {
+            try {
+                const correlationId = req.headers['x-correlation-id'] ||
+                    req.headers['x-request-id'] ||
+                    (0, uuid_1.v4)();
+                this.contextService.set('correlationId', correlationId);
+                this.contextService.set('requestId', (0, uuid_1.v4)());
+                res.setHeader('X-Correlation-Id', correlationId);
+                const ip = req.headers['x-forwarded-for']?.split(',')[0].trim() ||
+                    req.headers['x-real-ip'] ||
+                    req.ip ||
+                    req.socket.remoteAddress ||
+                    'unknown';
+                this.contextService.set('ip', ip);
+                const userAgent = req.headers['user-agent'] || 'unknown';
+                this.contextService.set('userAgent', userAgent);
+                this.contextService.parseDevice(userAgent);
+                this.contextService.set('path', req.path);
+                this.contextService.set('method', req.method);
+                this.contextService.set('timestamp', new Date());
+                if (req.user) {
+                    const user = req.user;
+                    this.contextService.set('userId', user.id?.toString() || user.sub?.toString());
+                    this.contextService.set('userEmail', user.email);
+                    this.contextService.set('userRole', user.role?.name || user.role);
+                    this.contextService.set('userType', user.userType || 'platform');
+                    if (user.roles && Array.isArray(user.roles)) {
+                        this.contextService.set('roles', user.roles);
+                    }
+                }
+                else {
+                    this.contextService.set('userId', 'anonymous');
+                    this.contextService.set('userRole', 'guest');
+                    this.contextService.set('userType', 'platform');
+                }
+                if (ip && !['127.0.0.1', '::1', 'unknown', 'localhost'].includes(ip)) {
+                    this.geolocationService
+                        .getLocation(ip)
+                        .then((location) => {
+                        if (location) {
+                            this.contextService.set('location', location);
+                        }
+                    })
+                        .catch((err) => {
+                        this.logger.warn(`Geolocation lookup failed for ${ip}:`, err.message);
+                    });
+                }
+                next();
+            }
+            catch (error) {
+                this.logger.error('Error in RequestContextMiddleware:', error);
+                next();
+            }
+        });
+    }
+};
+exports.RequestContextMiddleware = RequestContextMiddleware;
+exports.RequestContextMiddleware = RequestContextMiddleware = RequestContextMiddleware_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [request_context_service_1.RequestContextService,
+        geolocation_service_1.GeolocationService])
+], RequestContextMiddleware);
+//# sourceMappingURL=request-context.middleware.js.map

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

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

package/dist/context/request-context.module.d.ts

@@ -0,0 +1,4 @@
+import { MiddlewareConsumer, NestModule } from '@nestjs/common';
+export declare class RequestContextModule implements NestModule {
+    configure(consumer: MiddlewareConsumer): void;
+}

package/dist/context/request-context.module.js

@@ -0,0 +1,27 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestContextModule = void 0;
+const common_1 = require("@nestjs/common");
+const request_context_service_1 = require("./request-context.service");
+const request_context_middleware_1 = require("./request-context.middleware");
+const geolocation_service_1 = require("./geolocation.service");
+let RequestContextModule = class RequestContextModule {
+    configure(consumer) {
+        consumer.apply(request_context_middleware_1.RequestContextMiddleware).forRoutes('*');
+    }
+};
+exports.RequestContextModule = RequestContextModule;
+exports.RequestContextModule = RequestContextModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [request_context_service_1.RequestContextService, geolocation_service_1.GeolocationService],
+        exports: [request_context_service_1.RequestContextService, geolocation_service_1.GeolocationService],
+    })
+], RequestContextModule);
+//# sourceMappingURL=request-context.module.js.map

package/dist/context/request-context.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.module.js","sourceRoot":"","sources":["../../src/context/request-context.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgF;AAChF,uEAAkE;AAClE,6EAAwE;AACxE,+DAA2D;AAOpD,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC7B,SAAS,CAAC,QAA4B;QAClC,QAAQ,CAAC,KAAK,CAAC,qDAAwB,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC;CACJ,CAAA;AAJY,oDAAoB;+BAApB,oBAAoB;IALhC,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACJ,SAAS,EAAE,CAAC,+CAAqB,EAAE,wCAAkB,CAAC;QACtD,OAAO,EAAE,CAAC,+CAAqB,EAAE,wCAAkB,CAAC;KACvD,CAAC;GACW,oBAAoB,CAIhC"}

package/dist/context/request-context.service.d.ts

@@ -0,0 +1,24 @@
+import { RequestContext } from './interfaces/request-context.interface';
+export declare class RequestContextService {
+    private static namespace;
+    static getNamespace(): any;
+    set<K extends keyof RequestContext>(key: K, value: RequestContext[K]): void;
+    get<K extends keyof RequestContext>(key: K): RequestContext[K] | undefined;
+    setContext(context: Partial<RequestContext>): void;
+    getContext(): RequestContext;
+    getCorrelationId(): string | undefined;
+    getUserId(): string | undefined;
+    getUserEmail(): string | undefined;
+    getUserRole(): string | undefined;
+    getUserType(): string | undefined;
+    getRoles(): string[] | undefined;
+    getIp(): string | undefined;
+    getUserAgent(): string | undefined;
+    getDevice(): RequestContext['device'] | undefined;
+    getLocation(): RequestContext['location'] | undefined;
+    parseDevice(userAgent: string): void;
+    isAuthenticated(): boolean;
+    hasRole(role: string): boolean;
+    hasAnyRole(roles: string[]): boolean;
+    clear(): void;
+}