using ClassNotify.Server.Domain.Entities; using ClassNotify.Shared.Models; namespace ClassNotify.Server.Services; public sealed record DeviceConnectionRegistrationResult( string CurrentConnectionId, string? ReplacedConnectionId); public interface ISecurityService { // Auth & Identity Task LoginTeacherAsync(TeacherLoginDto dto, string? remoteIp = null); Task RegisterPersonalTeacherAsync(RegisterPersonalTeacherDto dto, string? remoteIp = null); Task ActivateDeviceAsync(DeviceActivationRequestDto dto); Task ValidateDeviceAsync(string deviceId, string deviceToken); Task<(Device Device, string RawDeviceToken)> EnsureDeviceProvisionedAsync(DeviceBootstrapRequestDto req); string GenerateJwtToken(User user, Tenant? tenant = null, bool isPasswordChangeOnly = false); // Password Recovery & Reset (Turn 62) Task ResetPasswordByRecoveryKeyAsync(ResetPasswordByRecoveryKeyDto dto, string? remoteIp = null); Task<(bool Success, string Message)> RequestPasswordResetEmailAsync(RequestPasswordResetEmailDto dto, string? remoteIp = null); Task<(bool Success, string Message)> ResetPasswordByTokenAsync(ResetPasswordByTokenDto dto, string? remoteIp = null); Task IssueAdminResetTicketAsync(string adminUserId, string adminUsername, string targetUserId, string? remoteIp = null); // Tenant & Classrooms Task GetClassroomAsync(string tenantId, string classId); Task> GetClassroomsAsync(string tenantId); Task CreateClassroomAsync(string tenantId, CreateClassroomDto dto); Task GetTenantAsync(string tenantId); Task> GetTenantsOverviewAsync(); // Users Task> GetUsersAsync(string tenantId); Task CreateUserAsync(string tenantId, CreateTeacherDto dto); // Devices & Metrics Task GetAdminMetricsAsync(); Task> GetAllDevicesAsync(); Task> GetTenantDevicesAsync(string tenantId); Task RegisterDeviceConnectionAsync(string connectionId, string deviceId, string tenantId, string classroomId, string? hostname, string? remoteIp, string? clientVersion, string? installationId = null, string? hardwareHash = null); Task UnregisterDeviceConnectionAsync(string connectionId); bool IsCurrentDeviceConnection(string deviceId, string connectionId); Task UpdateDeviceHeartbeatAsync(string connectionId, DeviceHeartbeatDto? heartbeat = null); string? GetDeviceConnectionId(string deviceId); Task InvalidateDeviceSessionAsync(string deviceId, string reason = "IdentityChanged"); Task InvalidateDeviceSessionByEndpointAsync(string? deviceId, string? installationId, string? hardwareHash, string reason = "EndpointReactivated"); Task<(bool Success, string Message, string? NewClassName)> UpdateDeviceClassNameAsync(string deviceId, string newClassName, string operatorName, string operatorRole); // Activation Codes & License Lifecycle (P3 & Commercial Pilot & Turn 50 Dual-Distribution) Task GenerateActivationCodeAsync(string tenantId, string classId, int? durationDays = 7, string tier = "Trial", string? notes = null, string? actor = null, string? actorRole = null, string? ip = null, string distributionMethod = "External", string? assignedTeacherId = null, string? assignedTeacherName = null, string? targetClassName = null, string? purpose = null); Task> GenerateActivationCodesAsync(string tenantId, string classId, int count, int? durationDays = 7, string tier = "Trial", string? notes = null, string? actor = null, string? actorRole = null, string? ip = null, string distributionMethod = "External", string? assignedTeacherId = null, string? assignedTeacherName = null, string? targetClassName = null, string? purpose = null); Task AssignActivationCodeAsync(string tenantId, AssignActivationCodeRequestDto dto, string? actor = null, string? actorRole = null, string? ip = null); Task> GetTeacherActivationCodesAsync(string tenantId, string teacherUserId); Task RevealTeacherActivationCodeAsync(string tenantId, string teacherUserId, string code, string? actor = null, string? ip = null); Task UpdateActivationCodeNotesAsync(List codes, string? notes, string? actor = null, string? actorRole = null, string? ip = null); Task> GetActivationCodesAsync(string? tenantId); Task GetDeviceLicenseStatusAsync(string deviceId); Task<(bool Success, string Message, DeviceLicenseStatusDto? Status)> RenewDeviceLicenseAsync(string deviceId, string? activationCode, int? extendDays = null, string? tier = null, string? operatorUser = null, string? reason = null, DateTimeOffset? validThroughDate = null); Task<(bool Success, string Message, List<(string DeviceId, DeviceLicenseStatusDto Status)> RenewedDevices)> BatchRenewDevicesLicenseAsync(List deviceIds, int? extendDays = null, string? tier = null, string? operatorUser = null, string? reason = null, DateTimeOffset? validThroughDate = null, string? clientRequestId = null, string? licenseKind = null, string? validThroughLocalDate = null, string? tenantId = null); Task> GetLicenseRecordsAsync(string? tenantId = null, int limit = 100); // Notifications & ACKs (PostgreSQL & NotificationReceipt per-device isolation) Task RecordNotificationAsync(NotificationDto notification, string? senderUserId, string senderName); Task RecordAckAsync(string messageId, string authenticatedDeviceId, AckReceiptDto ack); Task ValidateNotificationTargetAsync(string messageId, string tenantId, string classroomId); Task> GetNotificationsAsync(string? tenantId, string? classId, int limit = 50, string? currentUserId = null); Task> GetPendingNotificationsForDeviceAsync(string deviceId); Task CancelNotificationAsync(string notificationId, string actorUserId, string actorUsername, string role, string tenantId, string? ip, CancellationToken ct = default); Task DismissNotificationHistoryAsync(string notificationId, string tenantId, string actorUserId, CancellationToken ct = default); Task DeleteNotificationAsync(string notificationId, string tenantId, string actorUserId, string role, CancellationToken ct = default); Task ResetSchoolTeacherPasswordAsync(string schoolAdminTenantId, string teacherUserId, string newPassword, string actorUsername, string? ip, CancellationToken ct = default); Task SetSchoolTeacherLockAsync(string schoolAdminTenantId, string teacherUserId, bool isLocked, string actorUsername, string? ip, CancellationToken ct = default); Task GetBroadcastReceiptSummaryAsync(string broadcastId, CancellationToken ct = default); // Device Commands (P1 Batch 10) Task CreateDeviceCommandAsync(string? callerTenantId, string deviceId, string commandType, string? parameters, string createdBy, string? actorRole = null, string? ip = null); Task MarkCommandDispatchedAsync(string commandId); Task RecordCommandResultAsync(DeviceCommandResultDto result, string callerDeviceId, string? callerTenantId); Task GetDeviceCommandAsync(string commandId, string? callerTenantId = null); Task> GetPendingCommandsForDeviceAsync(string deviceId); Task> GetDeviceCommandHistoryAsync(string? tenantId, string? deviceId, string? status, int limit = 50); // SuperAdmin Control Plane Extensions Task CreateTenantAsync(string id, string name, string? actor = null, string? actorRole = null, string? ip = null); Task UpdateTenantAsync(string id, string name, bool isActive, string? actor = null, string? actorRole = null, string? ip = null); Task> GetAllUsersAdminAsync(string? tenantId, string? role, string? q = null); Task CreateUserAdminAsync(CreateUserAdminRequest req, string? actor = null, string? actorRole = null, string? ip = null); Task UpdateUserAdminAsync(string userId, UpdateUserAdminRequest req, string? actor = null, string? actorRole = null, string? ip = null); Task ResetPasswordAsync(string userId, string newPassword, string? actor = null, string? actorRole = null, string? ip = null); Task<(bool Success, string Message, string? NewToken)> ChangePasswordAsync(string userId, string newPassword, string? actor = null, string? ip = null); Task SetUserLockAsync(string userId, bool isLocked, string? actor = null, string? actorRole = null, string? ip = null); Task DeleteUserAsync(string userId, string? actor = null, string? actorRole = null, string? ip = null); Task UpdateDeviceAsync(string deviceId, string? hostname, string? classroomId, string? actor = null, string? actorRole = null, string? ip = null); Task DecommissionDeviceAsync(string deviceId, string? actor = null, string? actorRole = null, string? ip = null); Task DeleteActivationCodeAsync(string code, string? actor = null, string? actorRole = null, string? ip = null); Task GetSystemHealthAsync(); Task LogAdminAuditAsync(string actorUsername, string actorRole, string action, string targetType, string targetId, string? details, string? ip = null); Task> GetAdminAuditLogsAsync(int limit = 100); // Account Security & Recovery Key Rotation Task<(bool Success, string Message, string? NewRecoveryKey)> RotateRecoveryKeyAsync(string userId, string currentPassword, string? remoteIp = null); Task HasRecoveryKeyAsync(string userId); // Trial Anti-Freeload & Hardware Override Console (Turn 75) Task> GetTrialLedgersAsync(string? tenantId, string? q, bool onlyBlocked, string? overrideState, int limit = 100); Task<(bool Success, string Message, DeviceTrialLedgerAdminDto? Ledger)> GrantTrialOverrideAsync(string ledgerId, string reason, int validHours, string adminUser, string? ip = null); Task<(bool Success, string Message)> RevokeTrialOverrideAsync(string ledgerId, string? reason, string adminUser, string? ip = null); // Server-Side License Summary (Turn 75) Task GetLicenseRecordsSummaryAsync(string? tenantId = null); // Device DisplayLabel update (Turn 75) Task UpdateDeviceDisplayLabelAsync(string deviceId, string? displayLabel, string? actor = null, string? actorRole = null, string? ip = null); }