false, 'error' => 'invalid_request']; } $db = DB::handle(); $db->begin_transaction(); try { $event = UserLifecycleAuditService::findDeleteEventForRestore($auditId, true); if (!$event) { $db->rollback(); return ['ok' => false, 'error' => 'audit_event_not_found']; } if (!empty($event['restored_at'])) { $db->rollback(); return ['ok' => false, 'error' => 'audit_event_already_restored']; } $snapshot = UserLifecycleAuditService::decryptSnapshot($event); if (!$snapshot) { $db->rollback(); return ['ok' => false, 'error' => 'snapshot_unavailable']; } $uuid = trim((string) ($snapshot['uuid'] ?? '')); $email = trim((string) ($snapshot['email'] ?? '')); if ($uuid === '' || $email === '') { $db->rollback(); return ['ok' => false, 'error' => 'snapshot_invalid']; } if (UserRepository::findByUuid($uuid)) { $db->rollback(); return ['ok' => false, 'error' => 'restore_uuid_exists']; } if (UserRepository::findByEmail($email)) { $db->rollback(); return ['ok' => false, 'error' => 'restore_email_exists']; } $createdId = UserRepository::create([ 'uuid' => $uuid, 'first_name' => trim((string) ($snapshot['first_name'] ?? '')), 'last_name' => trim((string) ($snapshot['last_name'] ?? '')), 'email' => $email, 'profile_description' => self::nullableText($snapshot['profile_description'] ?? null), 'job_title' => self::nullableText($snapshot['job_title'] ?? null), 'phone' => self::nullableText($snapshot['phone'] ?? null), 'mobile' => self::nullableText($snapshot['mobile'] ?? null), 'short_dial' => self::nullableText($snapshot['short_dial'] ?? null), 'address' => self::nullableText($snapshot['address'] ?? null), 'postal_code' => self::nullableText($snapshot['postal_code'] ?? null), 'city' => self::nullableText($snapshot['city'] ?? null), 'country' => self::nullableText($snapshot['country'] ?? null), 'region' => self::nullableText($snapshot['region'] ?? null), 'hire_date' => self::nullableDate($snapshot['hire_date'] ?? null), 'password' => self::randomPassword(), 'locale' => self::nullableText($snapshot['locale'] ?? null), 'totp_secret' => '', 'theme' => self::normalizeTheme($snapshot['theme'] ?? null), 'primary_tenant_id' => null, 'current_tenant_id' => null, 'created_by' => $actorUserId, 'active' => 0, 'active_changed_at' => gmdate('Y-m-d H:i:s'), 'active_changed_by' => $actorUserId, ]); if (!$createdId) { $db->rollback(); return ['ok' => false, 'error' => 'restore_create_failed']; } $restoredUserId = (int) $createdId; $marked = UserLifecycleAuditService::markDeleteEventRestored($auditId, $actorUserId, $restoredUserId); if (!$marked) { $db->rollback(); return ['ok' => false, 'error' => 'restore_mark_failed']; } UserLifecycleAuditService::logRestore( RepoQuery::uuidV4(), 'manual', [ 'deactivate_days' => (int) ($event['policy_deactivate_days'] ?? 0), 'delete_days' => (int) ($event['policy_delete_days'] ?? 0), ], $actorUserId, [ 'id' => $restoredUserId, 'uuid' => $uuid, 'email' => $email, ], 'success', null ); $db->commit(); return [ 'ok' => true, 'restored_user_id' => $restoredUserId, 'restored_user_uuid' => $uuid, 'audit_id' => $auditId, ]; } catch (\Throwable $exception) { if ($db->errno === 0) { $db->rollback(); } else { $db->rollback(); } return ['ok' => false, 'error' => 'restore_unexpected_error']; } } private static function nullableText(mixed $value): ?string { $value = trim((string) $value); return $value !== '' ? $value : null; } private static function nullableDate(mixed $value): ?string { $value = trim((string) $value); if ($value === '') { return null; } if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $value)) { return null; } return $value; } private static function randomPassword(): string { return bin2hex(random_bytes(24)); } private static function normalizeTheme(mixed $value): string { $theme = strtolower(trim((string) $value)); $themes = appThemes(); return isset($themes[$theme]) ? $theme : appDefaultTheme(); } }