@microsoft/windows-admin-center-sdk
Version:
Microsoft - Windows Admin Center Shell
689 lines (686 loc) • 31.6 kB
JavaScript
import { EMPTY, ReplaySubject } from 'rxjs';
import { Globalization } from '../data/globalization';
import { Net } from '../data/net';
import { LogLevel } from '../diagnostics/log-level';
import { Logging } from '../diagnostics/logging';
import { SmeWebTelemetry } from '../diagnostics/sme-web-telemetry';
import { RpcNotificationSubjectServer } from '../rpc/notification/rpc-notification-subject-server';
import { RpcWorkItemFindSubjectServer } from '../rpc/work-item-find/rpc-work-item-find-subject-server';
import { Notification, NotificationChangeEvent } from './notification';
import { NotificationState } from './notification-state';
/**
* Mock the IFrameService class in app folder
*/
export class IFrameService {
getActiveToolIFrameData;
}
/**
* Notification manager class.
*/
export class NotificationManager {
rpc;
collection;
psSessionIdToNotificationIdMap = new Map();
notificationIdToPsSessionIdMap = new Map();
rpcNotifySubscription;
rpcQuerySubscription;
changedEventSubject;
rpcWorkItemFindSubjectServer;
rpcNotificationSubjectServer;
iFrameService;
/**
* Initializes a new instance of the NotificationManager class.
*
* @param rpc the RPC object.
*/
constructor(rpc) {
this.rpc = rpc;
this.changedEventSubject = new ReplaySubject(1);
this.initialize();
}
/**
* register iframe service from shell
* @param iFrameService the iframe service from shell
*/
registerIFrameService(iFrameService) {
this.iFrameService = iFrameService;
}
/**
* Gets the items from current notification collection including dismissed.
*/
get items() {
const items = [];
for (const item in this.collection) {
if (this.collection.hasOwnProperty(item)) {
items.push(this.collection[item]);
}
}
return items;
}
/**
* Gets the subject of notification changed event.
*/
get changed() {
return this.changedEventSubject;
}
/**
* Initializes the rpc notification call.
*/
initialize() {
this.collection = {};
// notification request from rpc...
this.rpcNotificationSubjectServer = new RpcNotificationSubjectServer(this.rpc);
this.rpcNotifySubscription = this.rpcNotificationSubjectServer.subject
.subscribe({
next: item => {
this.notify(item.data).toPromise().then(item.deferred.resolve, item.deferred.reject);
},
error: error => {
const message = MsftSme.getStrings().MsftSmeShell.Core.Error.NotificationRpcInitialization.message;
Logging.log({
source: 'Notification',
level: LogLevel.Error,
message: message.format(Net.getErrorMessage(error))
});
}
});
this.rpcWorkItemFindSubjectServer = new RpcWorkItemFindSubjectServer(this.rpc);
this.rpcQuerySubscription = this.rpcWorkItemFindSubjectServer.subject
.subscribe({
next: item => {
item.deferred.resolve(this.workItemFind(item.data));
},
error: error => {
const message = MsftSme.getStrings().MsftSmeShell.Core.Error.NotificationRpcInitialization.message;
Logging.log({
source: 'Notification',
level: LogLevel.Error,
message: message.format(Net.getErrorMessage(error))
});
}
});
this.addEvent(NotificationChangeEvent.Initialized);
}
/**
* Stop the notification manager.
*/
uninitialize() {
if (this.rpcNotifySubscription) {
this.rpcNotifySubscription.unsubscribe();
this.rpcNotifySubscription = null;
}
if (this.rpcQuerySubscription) {
this.rpcQuerySubscription.unsubscribe();
this.rpcQuerySubscription = null;
}
}
/**
* Find a notification.
*
* @param id the notification id.
*/
find(id) {
const notificationId = this.psSessionIdToNotificationIdMap[id] || id;
return this.collection[notificationId];
}
/**
* Remove a notification.
* There is no dismiss API on the gateway, this just remove from the list.
* Don't remove active notification. Use dismiss api instead, so it doesn't displays to .items property.
*
* @param id the session id (notification id).
* @return boolean true if removed.
*/
remove(id) {
const notification = this.find(id);
if (notification) {
const psSessionId = this.notificationIdToPsSessionIdMap[id];
delete this.psSessionIdToNotificationIdMap[psSessionId];
delete this.notificationIdToPsSessionIdMap[id];
delete this.collection[id];
this.addEvent(NotificationChangeEvent.Remove, notification);
return true;
}
return false;
}
/**
* Dismiss a notification to mark dismiss property.
*
* @param id the session id (notification id).
* @return boolean true if dismissed.
*/
dismiss(id) {
const notification = this.find(id);
if (notification) {
notification.dismissed = true;
this.addEvent(NotificationChangeEvent.Remove, notification);
return true;
}
return false;
}
/**
* Set dismissed to false for notification updated that was previously dismissed
*
* @param id the session id (notification id).
* @return boolean true if undismissed.
*/
undismiss(id) {
const notification = this.find(id);
if (notification) {
notification.dismissed = false;
this.addEvent(NotificationChangeEvent.Change, notification);
return true;
}
return false;
}
/**
* Add notification from WorkItem.
*
* @param psSessionId the psSession ID.
* @param workItem the RPC work item.
* @param state the initial state.
* @param object the object from query result.
* @return notification the notification object.
*/
addFromWorkItem(notificationId, workItem, state) {
const notification = Notification.createFromWorkItem(notificationId, workItem, state, this.iFrameService);
const existingNotification = this.find(notificationId);
this.collection[notificationId] = notification;
if (!notification.isDisabled) {
if (existingNotification) {
this.addEvent(NotificationChangeEvent.Change, notification);
}
else {
this.addEvent(NotificationChangeEvent.Add, notification);
}
}
}
/**
* Update an existing work item with psSession Id information.
*
* @param notificationId the id of the notification.
* @param psSessionId the psSession ID.
* @param workItem the work item.
* @param state the state of the work item.
* @param object the object from query result.
*/
updateWorkItemWithPsSession(notificationId, psSessionId, workItem, state, object) {
const notification = this.find(notificationId);
this.psSessionIdToNotificationIdMap[psSessionId] = notificationId;
this.notificationIdToPsSessionIdMap[notificationId] = psSessionId;
if (notification) {
if (notification.updateFromWorkItem(notificationId, workItem, state, object)) {
this.addEvent(NotificationChangeEvent.Change, notification);
}
return true;
}
return false;
}
/**
* Add notification from Recover.
*
* @param id the notification ID.
* @param workItem the RPC work item.
* @param state the initial state.
* @param object the object from query result.
* @return notification the notification object.
*/
addFromRecover(recover) {
const notification = Notification.createFromRecover(recover, this.iFrameService);
this.collection[recover.id] = notification;
this.psSessionIdToNotificationIdMap[recover.id] = recover.id;
this.notificationIdToPsSessionIdMap[recover.id] = recover.id;
this.addEvent(NotificationChangeEvent.Add, notification);
}
/**
* Add initial notification for Message Notification.
*
* @param id the notification ID.
* @param workItem the RPC work item.
* @param state the initial state.
* @param object the object from query result.
* @return notification the notification object.
*/
addForNotificationMessage(state, message) {
if (this.collection[message.id]) {
return false;
}
const notification = new Notification(message.id);
const now = new Date();
notification.isFromRecover = true;
notification.state = state;
notification.object = {};
notification.nodeName = message.sourceName;
notification.moduleDisplayName = message.sourceName;
notification.startTimestamp = Globalization.timeOnly(now);
notification.changedTimestamp = Globalization.timeOnly(now);
notification.changedTimestampValue = now.getTime();
notification.description = null;
notification.typeId = null;
notification.title = message.title;
notification.message = message.message;
this.collection[message.id] = notification;
this.psSessionIdToNotificationIdMap[message.id] = message.id;
this.notificationIdToPsSessionIdMap[message.id] = message.id;
this.addEvent(NotificationChangeEvent.Add, notification);
return true;
}
/**
* Update notification from socket message.
*
* @param psSessionId the psSession ID.
* @param message the socket message.
*/
updateFromMessage(psSessionId, message) {
const notificationId = this.psSessionIdToNotificationIdMap[psSessionId];
const notification = this.find(notificationId);
if (notification) {
if (notification.updateFromMessage(message)) {
this.addEvent(NotificationChangeEvent.Change, notification);
}
return true;
}
return false;
}
/**
* Update notification from socket message.
*
* @param psSessionId the psSession ID.
* @param message the socket message.
*/
updateFromNotificationMessage(state, item) {
const notification = this.find(item.id);
if (notification) {
notification.updateFromNotificationMessage(state, item);
this.addEvent(NotificationChangeEvent.Change, notification);
return true;
}
return false;
}
/**
* Add or update client notification.
*
* @param clientNotification the client notification object.
* @param Observable the observable of void.
*/
notify(clientNotification) {
// convert alert into notification
if (MsftSme.isNullOrWhiteSpace(clientNotification.title)) {
clientNotification.title = clientNotification.message;
clientNotification.message = null;
}
SmeWebTelemetry.traceClientNotification(clientNotification);
let notification = this.find(clientNotification.id);
if (notification) {
if (notification.updateFromClient(clientNotification)) {
this.addEvent(NotificationChangeEvent.Change, notification);
}
return EMPTY;
}
notification = Notification.createFromClient(clientNotification, this.iFrameService);
this.collection[clientNotification.id] = notification;
this.addEvent(NotificationChangeEvent.Add, notification);
return EMPTY;
}
/**
* Find current work item by the typeId/sourceName/nodeName.
*
* @param workItemFind the query notification object.
* @param RpcWorkItemFindResult the result of query.
*/
workItemFind(workItemFind) {
const keys = Object.keys(this.collection);
const results = keys
.map(key => ({ key: key, notification: this.collection[key] }))
.filter(data => data.notification.moduleName === workItemFind.moduleName
&& data.notification.nodeName === workItemFind.nodeName
&& data.notification.typeId === workItemFind.typeId)
.map(data => ({
id: data.key,
state: data.notification.state,
percent: data.notification.percent,
error: data.notification.error,
object: data.notification.object
}));
const notificationResult = {
results: results,
typeId: workItemFind.typeId,
moduleName: workItemFind.moduleName,
nodeName: workItemFind.nodeName
};
return notificationResult;
}
/**
* Add an event to report the change of notification data or collection.
*
* @param changeEvent the changed event.
* @param notification the notification object. (optional)
*/
addEvent(changeEvent, notification) {
// need to copy otherwise every change to original notification will be shown on UI without event
const notificationCopy = {};
if (notification) {
MsftSme.shallowCopyFromObject(notificationCopy, notification);
}
this.changedEventSubject.next({ notification: notificationCopy, changeEvent: changeEvent });
// no localization.
Logging.logVerbose('Notification', notification ?
'addEvent: {0}/{1}\n{2}\n{3}\n{4}'.format(NotificationChangeEvent[changeEvent], NotificationState[notification.state], notification.title, notification.message, notification.link)
: 'addEvent: {0}'.format(NotificationChangeEvent[changeEvent]));
}
}
//# sourceMappingURL=notification-manager.js.map
// SIG // Begin signature block
// SIG // MIIoKAYJKoZIhvcNAQcCoIIoGTCCKBUCAQExDzANBglg
// SIG // hkgBZQMEAgEFADB3BgorBgEEAYI3AgEEoGkwZzAyBgor
// SIG // BgEEAYI3AgEeMCQCAQEEEBDgyQbOONQRoqMAEEvTUJAC
// SIG // AQACAQACAQACAQACAQAwMTANBglghkgBZQMEAgEFAAQg
// SIG // SKtWhODYjZTlkdjy41nsL8mVnx4vtYXUCovQIbSNFxyg
// SIG // gg12MIIF9DCCA9ygAwIBAgITMwAABARsdAb/VysncgAA
// SIG // AAAEBDANBgkqhkiG9w0BAQsFADB+MQswCQYDVQQGEwJV
// SIG // UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH
// SIG // UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv
// SIG // cmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQgQ29kZSBT
// SIG // aWduaW5nIFBDQSAyMDExMB4XDTI0MDkxMjIwMTExNFoX
// SIG // DTI1MDkxMTIwMTExNFowdDELMAkGA1UEBhMCVVMxEzAR
// SIG // BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v
// SIG // bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
// SIG // bjEeMBwGA1UEAxMVTWljcm9zb2Z0IENvcnBvcmF0aW9u
// SIG // MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA
// SIG // tCg32mOdDA6rBBnZSMwxwXegqiDEUFlvQH9Sxww07hY3
// SIG // w7L52tJxLg0mCZjcszQddI6W4NJYb5E9QM319kyyE0l8
// SIG // EvA/pgcxgljDP8E6XIlgVf6W40ms286Cr0azaA1f7vaJ
// SIG // jjNhGsMqOSSSXTZDNnfKs5ENG0bkXeB2q5hrp0qLsm/T
// SIG // WO3oFjeROZVHN2tgETswHR3WKTm6QjnXgGNj+V6rSZJO
// SIG // /WkTqc8NesAo3Up/KjMwgc0e67x9llZLxRyyMWUBE9co
// SIG // T2+pUZqYAUDZ84nR1djnMY3PMDYiA84Gw5JpceeED38O
// SIG // 0cEIvKdX8uG8oQa047+evMfDRr94MG9EWwIDAQABo4IB
// SIG // czCCAW8wHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYB
// SIG // BQUHAwMwHQYDVR0OBBYEFPIboTWxEw1PmVpZS+AzTDwo
// SIG // oxFOMEUGA1UdEQQ+MDykOjA4MR4wHAYDVQQLExVNaWNy
// SIG // b3NvZnQgQ29ycG9yYXRpb24xFjAUBgNVBAUTDTIzMDAx
// SIG // Mis1MDI5MjMwHwYDVR0jBBgwFoAUSG5k5VAF04KqFzc3
// SIG // IrVtqMp1ApUwVAYDVR0fBE0wSzBJoEegRYZDaHR0cDov
// SIG // L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwvTWlj
// SIG // Q29kU2lnUENBMjAxMV8yMDExLTA3LTA4LmNybDBhBggr
// SIG // BgEFBQcBAQRVMFMwUQYIKwYBBQUHMAKGRWh0dHA6Ly93
// SIG // d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWlj
// SIG // Q29kU2lnUENBMjAxMV8yMDExLTA3LTA4LmNydDAMBgNV
// SIG // HRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4ICAQCI5g/S
// SIG // KUFb3wdUHob6Qhnu0Hk0JCkO4925gzI8EqhS+K4umnvS
// SIG // BU3acsJ+bJprUiMimA59/5x7WhJ9F9TQYy+aD9AYwMtb
// SIG // KsQ/rst+QflfML+Rq8YTAyT/JdkIy7R/1IJUkyIS6srf
// SIG // G1AKlX8n6YeAjjEb8MI07wobQp1F1wArgl2B1mpTqHND
// SIG // lNqBjfpjySCScWjUHNbIwbDGxiFr93JoEh5AhJqzL+8m
// SIG // onaXj7elfsjzIpPnl8NyH2eXjTojYC9a2c4EiX0571Ko
// SIG // mhENF3RtR25A7/X7+gk6upuE8tyMy4sBkl2MUSF08U+E
// SIG // 2LOVcR8trhYxV1lUi9CdgEU2CxODspdcFwxdT1+G8YNc
// SIG // gzHyjx3BNSI4nOZcdSnStUpGhCXbaOIXfvtOSfQX/UwJ
// SIG // oruhCugvTnub0Wna6CQiturglCOMyIy/6hu5rMFvqk9A
// SIG // ltIJ0fSR5FwljW6PHHDJNbCWrZkaEgIn24M2mG1M/Ppb
// SIG // /iF8uRhbgJi5zWxo2nAdyDBqWvpWxYIoee/3yIWpquVY
// SIG // cYGhJp/1I1sq/nD4gBVrk1SKX7Do2xAMMO+cFETTNSJq
// SIG // fTSSsntTtuBLKRB5mw5qglHKuzapDiiBuD1Zt4QwxA/1
// SIG // kKcyQ5L7uBayG78kxlVNNbyrIOFH3HYmdH0Pv1dIX/Mq
// SIG // 7avQpAfIiLpOWwcbjzCCB3owggVioAMCAQICCmEOkNIA
// SIG // AAAAAAMwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYT
// SIG // AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH
// SIG // EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y
// SIG // cG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290
// SIG // IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTEx
// SIG // MDcwODIwNTkwOVoXDTI2MDcwODIxMDkwOVowfjELMAkG
// SIG // A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO
// SIG // BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m
// SIG // dCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0
// SIG // IENvZGUgU2lnbmluZyBQQ0EgMjAxMTCCAiIwDQYJKoZI
// SIG // hvcNAQEBBQADggIPADCCAgoCggIBAKvw+nIQHC6t2G6q
// SIG // ghBNNLrytlghn0IbKmvpWlCquAY4GgRJun/DDB7dN2vG
// SIG // EtgL8DjCmQawyDnVARQxQtOJDXlkh36UYCRsr55JnOlo
// SIG // XtLfm1OyCizDr9mpK656Ca/XllnKYBoF6WZ26DJSJhIv
// SIG // 56sIUM+zRLdd2MQuA3WraPPLbfM6XKEW9Ea64DhkrG5k
// SIG // NXimoGMPLdNAk/jj3gcN1Vx5pUkp5w2+oBN3vpQ97/vj
// SIG // K1oQH01WKKJ6cuASOrdJXtjt7UORg9l7snuGG9k+sYxd
// SIG // 6IlPhBryoS9Z5JA7La4zWMW3Pv4y07MDPbGyr5I4ftKd
// SIG // gCz1TlaRITUlwzluZH9TupwPrRkjhMv0ugOGjfdf8NBS
// SIG // v4yUh7zAIXQlXxgotswnKDglmDlKNs98sZKuHCOnqWbs
// SIG // YR9q4ShJnV+I4iVd0yFLPlLEtVc/JAPw0XpbL9Uj43Bd
// SIG // D1FGd7P4AOG8rAKCX9vAFbO9G9RVS+c5oQ/pI0m8GLhE
// SIG // fEXkwcNyeuBy5yTfv0aZxe/CHFfbg43sTUkwp6uO3+xb
// SIG // n6/83bBm4sGXgXvt1u1L50kppxMopqd9Z4DmimJ4X7Iv
// SIG // hNdXnFy/dygo8e1twyiPLI9AN0/B4YVEicQJTMXUpUMv
// SIG // dJX3bvh4IFgsE11glZo+TzOE2rCIF96eTvSWsLxGoGyY
// SIG // 0uDWiIwLAgMBAAGjggHtMIIB6TAQBgkrBgEEAYI3FQEE
// SIG // AwIBADAdBgNVHQ4EFgQUSG5k5VAF04KqFzc3IrVtqMp1
// SIG // ApUwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYD
// SIG // VR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0j
// SIG // BBgwFoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0f
// SIG // BFMwUTBPoE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQu
// SIG // Y29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0
// SIG // MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRS
// SIG // MFAwTgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9z
// SIG // b2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0MjAx
// SIG // MV8yMDExXzAzXzIyLmNydDCBnwYDVR0gBIGXMIGUMIGR
// SIG // BgkrBgEEAYI3LgMwgYMwPwYIKwYBBQUHAgEWM2h0dHA6
// SIG // Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvZG9jcy9w
// SIG // cmltYXJ5Y3BzLmh0bTBABggrBgEFBQcCAjA0HjIgHQBM
// SIG // AGUAZwBhAGwAXwBwAG8AbABpAGMAeQBfAHMAdABhAHQA
// SIG // ZQBtAGUAbgB0AC4gHTANBgkqhkiG9w0BAQsFAAOCAgEA
// SIG // Z/KGpZjgVHkaLtPYdGcimwuWEeFjkplCln3SeQyQwWVf
// SIG // Liw++MNy0W2D/r4/6ArKO79HqaPzadtjvyI1pZddZYSQ
// SIG // fYtGUFXYDJJ80hpLHPM8QotS0LD9a+M+By4pm+Y9G6XU
// SIG // tR13lDni6WTJRD14eiPzE32mkHSDjfTLJgJGKsKKELuk
// SIG // qQUMm+1o+mgulaAqPyprWEljHwlpblqYluSD9MCP80Yr
// SIG // 3vw70L01724lruWvJ+3Q3fMOr5kol5hNDj0L8giJ1h/D
// SIG // Mhji8MUtzluetEk5CsYKwsatruWy2dsViFFFWDgycSca
// SIG // f7H0J/jeLDogaZiyWYlobm+nt3TDQAUGpgEqKD6CPxNN
// SIG // ZgvAs0314Y9/HG8VfUWnduVAKmWjw11SYobDHWM2l4bf
// SIG // 2vP48hahmifhzaWX0O5dY0HjWwechz4GdwbRBrF1HxS+
// SIG // YWG18NzGGwS+30HHDiju3mUv7Jf2oVyW2ADWoUa9WfOX
// SIG // pQlLSBCZgB/QACnFsZulP0V3HjXG0qKin3p6IvpIlR+r
// SIG // +0cjgPWe+L9rt0uX4ut1eBrs6jeZeRhL/9azI2h15q/6
// SIG // /IvrC4DqaTuv/DDtBEyO3991bWORPdGdVk5Pv4BXIqF4
// SIG // ETIheu9BCrE/+6jMpF3BoYibV3FWTkhFwELJm3ZbCoBI
// SIG // a/15n8G9bW1qyVJzEw16UM0xghoKMIIaBgIBATCBlTB+
// SIG // MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv
// SIG // bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWlj
// SIG // cm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNy
// SIG // b3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExAhMzAAAE
// SIG // BGx0Bv9XKydyAAAAAAQEMA0GCWCGSAFlAwQCAQUAoIGu
// SIG // MBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisG
// SIG // AQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3
// SIG // DQEJBDEiBCAWmoiEd2LUFgnNa+IlkftX5lPM9b9A07f6
// SIG // wCSDVxmj9TBCBgorBgEEAYI3AgEMMTQwMqAUgBIATQBp
// SIG // AGMAcgBvAHMAbwBmAHShGoAYaHR0cDovL3d3dy5taWNy
// SIG // b3NvZnQuY29tMA0GCSqGSIb3DQEBAQUABIIBAA51be3N
// SIG // YnX5PVvdrpVeksFgGlf1XNGiM9kfMJCh75pfxCzF2hbX
// SIG // LpkJ3Xpo70PiNa1LiU3AtDuJ4RE3WIphduzwbAC6O13K
// SIG // Ir971KW+yDN/XsvOThaamvY9dIRmaUsresLP94cZ7Ukv
// SIG // c4O95LeCKNeJ7YsCXpnPPIko/4h0bO7bJ2AF6AezAzy9
// SIG // P/Fqo5cZHZ9QQTkremUUm4IGsMZrK6jt/TpapYteOrHv
// SIG // H9eWGf7WXQSvaNL9nlc//UmbKMInVWwKmbnP9cLAtcd5
// SIG // oJ61QCSq9KmqNsNlMxiv7bWIrt6fqQUc1eZRyT9EWw44
// SIG // Lf7Zah3wEMM3VWtQeqM6bwor3aKhgheUMIIXkAYKKwYB
// SIG // BAGCNwMDATGCF4Awghd8BgkqhkiG9w0BBwKgghdtMIIX
// SIG // aQIBAzEPMA0GCWCGSAFlAwQCAQUAMIIBUgYLKoZIhvcN
// SIG // AQkQAQSgggFBBIIBPTCCATkCAQEGCisGAQQBhFkKAwEw
// SIG // MTANBglghkgBZQMEAgEFAAQgGm/9egNCuUiMRp66PtCN
// SIG // AtuSjXCrYXYsAceidS0tMfsCBmeuBCN0XxgTMjAyNTAy
// SIG // MjAxNTI4MzUuNDgxWjAEgAIB9KCB0aSBzjCByzELMAkG
// SIG // A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO
// SIG // BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m
// SIG // dCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0
// SIG // IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNo
// SIG // aWVsZCBUU1MgRVNOOkRDMDAtMDVFMC1EOTQ3MSUwIwYD
// SIG // VQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNl
// SIG // oIIR6jCCByAwggUIoAMCAQICEzMAAAHoULCAzytymU0A
// SIG // AQAAAegwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UEBhMC
// SIG // VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT
// SIG // B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw
// SIG // b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUt
// SIG // U3RhbXAgUENBIDIwMTAwHhcNMjMxMjA2MTg0NTIyWhcN
// SIG // MjUwMzA1MTg0NTIyWjCByzELMAkGA1UEBhMCVVMxEzAR
// SIG // BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v
// SIG // bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
// SIG // bjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2EgT3Bl
// SIG // cmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNO
// SIG // OkRDMDAtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3Nv
// SIG // ZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG
// SIG // 9w0BAQEFAAOCAg8AMIICCgKCAgEA4UF3RNFs1xu8M3gv
// SIG // UhnR+nlcHRpRemIKVO8HjhQZKVvcrhJiUgxNQAwcf9A0
// SIG // 7kQWqZUg/AkdUKskJsUQw/wnbw8nmRQHGepdvp5TLLJm
// SIG // cgvEz7dRk1gFLdxl1FOoNBdLSKxTS4KHwozr5txtI+PN
// SIG // lbrSkuMGU+mzVZwVbAoa9gI5lWxgzf+kLPxKmpC+XMKR
// SIG // npdbXu1Dtd3VMGj4zstFotamDZkfIu09Zbo9iXRXX2YT
// SIG // D8qsqvzQ52bjjUm4/BTOcSgaGq9dq2oAvP9Ql2i9TjFw
// SIG // cBmkaCU2LZLIvZ47quMA5HAMIrQmeQbUNjaj2dJS4kAe
// SIG // ztdAZvc6R1p/cdfx5nQJ+JKDFilA8B+bHf8w7uL4vPOx
// SIG // VsZueJJFjb5PBXkO2WdEOYKhiluIOq3r1diHQMQaG1na
// SIG // K6sL86i+9FnbIA1Pz+XNC/L2CLJFCWXnQhhzNoRyLDUc
// SIG // sPRBaEqJQzPsgnnZM+ve/O7PJyKeeYnC3w6CsOYWpORu
// SIG // jFhene9bXDc1ffr/UUCjGulMH8qrq3nXebKl1gl7/voX
// SIG // pOANeVsmyHOrn09IpWsymGbw76GrMIIz9Eni1u5r5nMN
// SIG // BRC8xdf7lmlxJSxzlyJYnihdov2M0OlOdCvXW4ZzGg3C
// SIG // UrBtIVy0U8vy0G7Dg9IcOxbitJ5s6LUsf+X6PYO3ws6B
// SIG // Y5N7QxMCAwEAAaOCAUkwggFFMB0GA1UdDgQWBBT6OVvK
// SIG // PfNJDH0VUG2uk9+B8HpS2jAfBgNVHSMEGDAWgBSfpxVd
// SIG // AF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQ
// SIG // hk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3Bz
// SIG // L2NybC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENB
// SIG // JTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwG
// SIG // CCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5j
// SIG // b20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUt
// SIG // U3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNVHRMB
// SIG // Af8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4G
// SIG // A1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEA
// SIG // ln3CZtq8F7T4u+JJujygJJ4vfgVqLavkLQxoHk+Rd66O
// SIG // z7CFDSkZFMrbhqiPLYS9yXK29N8egzqaWCRAPqW+qNqj
// SIG // 4xXXTtUy6r0l62JvjoAiy/u/txZkZn5EbvKx76a2m9Dt
// SIG // fcA27pIDvCOTotUXoDCZfLeZP1LRNFm98wJTh5woyxks
// SIG // z/w6N6bcIV6JJNNiLw+0mRAWz26Bm7cOCwh7E9qRWpKR
// SIG // jgYfiElDFwX/N+QrlTX3XcMZshrzUs8hMhJOYdVYe7ac
// SIG // D+8+6yfh7Ij+LHagY4+gL6Kbn+K8VAH6xG1emo/LcBbO
// SIG // 1lRzYiIKxzZ2v+eZMqwBvWLdfQj75FMMWCtLmbz5dlgt
// SIG // /Z33NIzk44rwu7PyFKMxOLX8tyTZMkNXDbb2X7Yl94+Q
// SIG // 7fniznrhg474Sb2DCBJKZFevFyzR+/mQX2Gvj5n0WGqB
// SIG // RRwiShKEUmdz2wyTwYhIWfcrsTHXaDDENfU5Mn7aLehM
// SIG // 9F4UpsI2Aat/Q7wRVoZcgxgYa1NxrXg1olXfWBkgdlp8
// SIG // bhTMuX2wCuqPD1s/EETIqbVxytxwwa9sFlhHK64HE7h2
// SIG // SCU6nqTaGJcfVURb4/7wl2gBXJpFtZ5O1RPqMGl6+USY
// SIG // 68g6vbm5Mg6tZnaxf4HmkQC13DWW3zVyJIV81wOmvAom
// SIG // pnEFvw4JiyaYlUDa4mWAhyAwggdxMIIFWaADAgECAhMz
// SIG // AAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3DQEBCwUA
// SIG // MIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu
// SIG // Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV
// SIG // TWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylN
// SIG // aWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3Jp
// SIG // dHkgMjAxMDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAx
// SIG // ODMyMjVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX
// SIG // YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD
// SIG // VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV
// SIG // BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw
// SIG // MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA
// SIG // 5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1
// SIG // V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64NmeF
// SIG // RiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1hlDc
// SIG // wUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmvHaus
// SIG // 9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl3GoPz130
// SIG // /o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3KNi1wjjHI
// SIG // NSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3tpK56KTes
// SIG // y+uDRedGbsoy1cCGMFxPLOJiss254o2I5JasAUq7vnGp
// SIG // F1tnYN74kpEeHT39IM9zfUGaRnXNxF803RKJ1v2lIH1+
// SIG // /NmeRd+2ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fz
// SIG // pk03dJQcNIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNO
// SIG // wTM5TI4CvEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLi
// SIG // Mxhy16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5
// SIG // UPkLiWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9Q
// SIG // BXpsxREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6H
// SIG // XtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIG
// SIG // CSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYE
// SIG // FCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQWBBSf
// SIG // pxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBTMFEG
// SIG // DCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNodHRw
// SIG // Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL0RvY3Mv
// SIG // UmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYIKwYBBQUH
// SIG // AwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYD
// SIG // VR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0j
// SIG // BBgwFoAU1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0f
// SIG // BE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQu
// SIG // Y29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0
// SIG // XzIwMTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBK
// SIG // BggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQu
// SIG // Y29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0w
// SIG // Ni0yMy5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1Vffwq
// SIG // reEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1
// SIG // OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpT
// SIG // Td2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pvvinL
// SIG // btg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbzaN9l
// SIG // 9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3+SmJ
// SIG // w7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWKNsIdw2Fz
// SIG // Lixre24/LAl4FOmRsqlb30mjdAy87JGA0j3mSj5mO0+7
// SIG // hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY
// SIG // 3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+c23Kjgm9swFX
// SIG // SVRk2XPXfx5bRAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFU
// SIG // a2pFEUep8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz
// SIG // /gq77EFmPWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/
// SIG // AsGConsXHRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1
// SIG // ZyvgDbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328
// SIG // y+l7vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEG
// SIG // ahC0HVUzWLOhcGbyoYIDTTCCAjUCAQEwgfmhgdGkgc4w
// SIG // gcsxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n
// SIG // dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
// SIG // aWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1p
// SIG // Y3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJzAlBgNV
// SIG // BAsTHm5TaGllbGQgVFNTIEVTTjpEQzAwLTA1RTAtRDk0
// SIG // NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAg
// SIG // U2VydmljZaIjCgEBMAcGBSsOAwIaAxUAjCRuL4NI7jDl
// SIG // Z9gbigAlLz/NBbqggYMwgYCkfjB8MQswCQYDVQQGEwJV
// SIG // UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH
// SIG // UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv
// SIG // cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1T
// SIG // dGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAOth
// SIG // vJQwIhgPMjAyNTAyMjAxNDM3MDhaGA8yMDI1MDIyMTE0
// SIG // MzcwOFowdDA6BgorBgEEAYRZCgQBMSwwKjAKAgUA62G8
// SIG // lAIBADAHAgEAAgIrAzAHAgEAAgITETAKAgUA62MOFAIB
// SIG // ADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMC
// SIG // oAowCAIBAAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3
// SIG // DQEBCwUAA4IBAQCX48qIUQNcvZRZEADtJhlFWbVsDWkh
// SIG // TVbRKQV078Q1S3ScvC6x9UeMrfnjYUEtxBDjh8/jrN+C
// SIG // Z5WTQ5fePiw2meKZvl1YajQIC/qtr2AmTbQYVbmIdiwG
// SIG // V22IDUgRMLyYyy3ql54hdTE+uMBeQ8/NeZQYhGYsiMQa
// SIG // p2zRbLVzhc6OEs2ozOtpU1A7Jxla3iceotWbYpUT3LP2
// SIG // 9weAi9nQ+6m9IGF6ko8Q4Ny6qbdfte0TFZe5nVSI7y8G
// SIG // gV0leupEjzp0+ODekvDlL+mbzHY80EdQEl2W72ucnvGY
// SIG // 4ofhXe/5cqZV9t18sYWjJEtoyqwl+CwhZkez6dQG4VuG
// SIG // 1cDWMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMx
// SIG // EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl
// SIG // ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh
// SIG // dGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3Rh
// SIG // bXAgUENBIDIwMTACEzMAAAHoULCAzytymU0AAQAAAegw
// SIG // DQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzEN
// SIG // BgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgrpwH
// SIG // QecpLod68pUzG6c4DJjC4mJjYgTYnfJ9Ze8mREowgfoG
// SIG // CyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCAq0trE1QKE
// SIG // IIJB0efaTaooHtMXyU9id1PFtUnPB/jrHTCBmDCBgKR+
// SIG // MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n
// SIG // dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
// SIG // aWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1p
// SIG // Y3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB
// SIG // 6FCwgM8rcplNAAEAAAHoMCIEILulQdh3oFLTIq5y+urR
// SIG // lRGa7Lb5Opb36+YP2FBx+jrTMA0GCSqGSIb3DQEBCwUA
// SIG // BIICAJKaJlK5BK8LlmefykYssdySIY+pt2hb+hwX7SZn
// SIG // L+XCjdMwTgwu7acLyHJY603Faj3Nb6tYkID9S4BFt196
// SIG // V0vYhYmj+WmPK+dZBFiIKMl+NgfN4maoOkO+jidIM0Ks
// SIG // sokGbKB0wuhibBfGtVK746SfL3zQDyemwyQV59WtzBrz
// SIG // o8cebmFSMZ8misJJSzt6aOj5mOs52QI3T6SNjj/8F21G
// SIG // 4K0UM1BKPY0lfTmn/QHSo40iyAVXZG3bhBdM0HfQkCxs
// SIG // BSJ1fcKntl0spnedl5pDSmN8d4UGDvLQT59U15WL23fZ
// SIG // jnQPfbnx+JVIrQbBZ/g6bE3ZGtFosmFR1B3pgoyNYGp3
// SIG // LaDkTbsx9+RA7oaOSJtaAEemi1mTJlb2O/5piTuNtf41
// SIG // Wp6iXLsbxJwOiXUqziI+H9ODqLiiNf/Y8XO8OZPe+djJ
// SIG // rwydaw8+3MoF3XO0/gnLmMcmwwW4cPbW7bA4nzg/8JaK
// SIG // mGUtFT1UnNKC18DPnLuusUwFm+v+e7ELDDZ/cYXfk1ti
// SIG // +JdomquaQQQcXGVJ92RZRHkgnMJARfLrqvMw8eIgjtEC
// SIG // 4omuw385EqItcf0JKNZu1GZJ7i9XQMp+UWdNbkoJ9jiM
// SIG // G130lVxNdOnhB7krjHOqR00l/vcpqwymLdG+9Pl4dIx9
// SIG // hHK1DGtnuHH6IJa7Od2pL9C2Efre
// SIG // End signature block