@microsoft/windows-admin-center-sdk
Version:
Microsoft - Windows Admin Center Shell
576 lines (573 loc) • 28.4 kB
JavaScript
import { from, of, throwError } from 'rxjs';
import { catchError, filter, map, mergeMap, take } from 'rxjs/operators';
import { RpcForwardAutoClient } from './forward/rpc-forward-auto-client';
import { RpcForwardDownKey } from './forward/rpc-forward-model';
import { RpcForwardUpSubjectServer } from './forward/rpc-forward-up-subject-server';
/**
* RPC forwarder class.
* @dynamic
*/
export class RpcForwarder {
static rpcForwardUpSubjectServer;
static ready;
static forwardMap = new Map();
static waitForReady(rpc) {
// if we are ready to forward, just return an observable.
if (rpc.stateActive && RpcForwarder.ready) {
return of(null);
}
// if we are already waiting for the rpc, then return that observable
if (RpcForwarder.ready) {
return RpcForwarder.ready;
}
// if we are not ready to forward, then set up forwarding based on our window type and current rpc state
if (MsftSme.isShell()) {
// If we are shell then setup the the rpc subject server
RpcForwarder.rpcForwardUpSubjectServer = new RpcForwardUpSubjectServer(rpc);
RpcForwarder.rpcForwardUpSubjectServer.subject.subscribe(data => {
RpcForwarder.onForwardReceived(data.data).then(data.deferred.resolve, data.deferred.reject);
});
}
else {
if (!rpc.stateActive) {
// return the first rpc state change that sets the state to active.
// then register our rpc command before returning
RpcForwarder.ready = rpc.stateChanged
.pipe(filter(active => active), take(1), map(() => rpc.register(RpcForwardDownKey.command, RpcForwarder.onForwardReceived)));
return RpcForwarder.ready;
}
else {
// If we are not shell, then setup rpc registration for forwarded messages
rpc.register(RpcForwardDownKey.command, RpcForwarder.onForwardReceived);
}
}
RpcForwarder.ready = of(null);
return RpcForwarder.ready;
}
static register(serviceId, forwarder) {
// throw an error if the service has already been registered
if (RpcForwarder.forwardMap.has(serviceId)) {
const message = MsftSme.getStrings().MsftSmeShell.Core.Error.ForwarderIdConflict.message;
throw new Error(message.format(serviceId));
}
// register the forwarder using the serviceId
RpcForwarder.forwardMap.set(serviceId, forwarder);
}
static onForwardReceived(data) {
if (!RpcForwarder.forwardMap.has(data.service)) {
const message = MsftSme.getStrings().MsftSmeShell.Core.Error.ForwarderIdNotFound.message;
return Promise.reject(message.format(data.service));
}
else {
const target = RpcForwarder.forwardMap.get(data.service);
return target.handleForwardedMessage(data)
.pipe(map(result => ({ result: result })), catchError(error => {
// on error, make sure the error is serializable and return it as an observable
return of({ error: RpcForwarder.ensureSerializable(error) });
}))
.toPromise();
}
}
/**
* Transform object into something that can be serializable by dropping
* any non-serializable properties
*
* @param obj the object to make serializable.
* @return a new object that is serializable
*/
static ensureSerializable(obj) {
const type = typeof obj;
if (type === 'string' || type === 'number' || type === 'boolean') {
return obj;
}
if (obj && type === 'object') {
if (Array.isArray(obj)) {
return obj.map(v => RpcForwarder.ensureSerializable(v));
}
const keys = Object.keys(obj);
const result = {};
keys.forEach(key => {
result[key] = RpcForwarder.ensureSerializable(obj[key]);
});
return result;
}
// We will return null for symbol, function, null, undefined
return null;
}
}
/**
* Base class to allow 2+ instances of a service to behave as one across the iframe boundary
* three mechanisms are surfaced for communication:
* - Execute: expects a response with data from the receiver
* - Notify: expects a response with no data from the receiver just for confirmation that it was received
* - Init: always called from a child instance, used to synchronize parent and child as the child starts up
*/
export class RpcServiceForwarder {
serviceId;
rpc;
/**
* Instantiates a new instance of the RpcServiceForwarder
*/
constructor(serviceId, rpc) {
this.serviceId = serviceId;
this.rpc = rpc;
RpcForwarder.register(this.serviceId, this);
}
/**
* Called when a forwarded message is received from the rpc.
* @param data The RpcForwardReportData of the request
* @returns an observable for the result of the request call
*/
handleForwardedMessage(data) {
// in the future Rpc should have no knowledge of shell an module. Only child/parent.
const fromRpc = this.rpc.isShell ? 1 /* RpcRelationshipType.Child */ : 0 /* RpcRelationshipType.Parent */;
switch (data.type) {
case 2 /* RpcForwardType.Init */:
return this.onForwardInit();
case 0 /* RpcForwardType.Execute */:
return this.onForwardExecute(fromRpc, data.name, data.arguments);
case 1 /* RpcForwardType.Notify */:
return this.onForwardNotify(fromRpc, data.name, data.value);
default: {
const message = MsftSme.getStrings().MsftSmeShell.Core.Error.ForwarderUnknownType.message;
return throwError(() => message.format(data.type));
}
}
}
/**
* Initializes the service. The serviceReady observable is assigned to the output of this function.
*/
initialize() {
return RpcForwarder.waitForReady(this.rpc)
.pipe(mergeMap(() => {
if (!this.canForward(0 /* RpcRelationshipType.Parent */)) {
// since we dont have a parent we can stop here
return of(null);
}
// other wise we have a parent and should forward an init message
const data = {
service: this.serviceId,
type: 2 /* RpcForwardType.Init */
};
return from(RpcForwardAutoClient.forward(this.rpc, data));
}), map(result => result ? this.onForwardInitResponse(result) : null), map(() => true), take(1));
}
/**
* Reinitialize the forwarded service. This should poll any important data from parents.
*/
reinitializeForwardedData() {
if (!this.canForward(0 /* RpcRelationshipType.Parent */)) {
// since we dont have a parent we can stop here
return of(null);
}
// other wise we have a parent and should forward an init message
const data = {
service: this.serviceId,
type: 2 /* RpcForwardType.Init */
};
return from(RpcForwardAutoClient.forward(this.rpc, data))
.pipe(map(result => result ? this.onForwardInitResponse(result) : null));
}
/**
* Creates an observable that errors with name not found
* @returns an observable that will error with a name not found message
*/
nameNotFound(name) {
return throwError(() => new Error(`${name} not found in forwarded service: ${this.serviceId}`));
}
/**
* Determines if a message can be forwarded to the specified RpcRelationshipType
* @param to The RpcRelationshipType that needs to be checked
* @returns true if messages can be forwarded to the specified RpcRelationshipType
*/
canForward(to) {
// we can only forward if the rpc is active
if (this.rpc.stateActive) {
if (to === 0 /* RpcRelationshipType.Parent */) {
// we can only forward to parents if we are an extension window
return MsftSme.isExtension();
}
else if (to === 1 /* RpcRelationshipType.Child */) {
// when trying to forward to a child, we have to make sure that the rpc outbound is actually ready.
// rpc.StateActive will report true always fro the shell
if (!this.rpc.rpcManager || !this.rpc.rpcManager.rpcOutbound) {
return false;
}
// we can only forward to parents if we have child windows
return MsftSme.isShell() && window.frames.length > 0;
}
}
return false;
}
/**
* Forwards a execution of some named method to the target relationship type
* @param to The RpcRelationshipType that this request is intended for
* @param name The name of the method to execute
* @param value The arguments for the method
* @returns an observable for the result of the method call
*/
forwardExecute(to, name, args) {
// if we cant forward then just return
if (!this.canForward(to)) {
return;
}
const data = {
arguments: args,
name: name,
service: this.serviceId,
type: 0 /* RpcForwardType.Execute */
};
return from(RpcForwardAutoClient.forward(this.rpc, data))
.pipe(map(response => {
if (response.error) {
throw response.error;
}
else {
return response.result;
}
}));
}
/**
* Forwards a notification of some state change to the target relationship type
* @param to The RpcRelationshipType that this request is intended for
* @param name The name of the state change
* @param value The new value of some state
* @returns an observable that completes when the state has been changed on the target instance.
*/
forwardNotify(to, name, value, noPrimaryFrame = false) {
// if we cant forward then just return
if (!noPrimaryFrame && !this.canForward(to)) {
return;
}
const data = {
value: value,
name: name,
service: this.serviceId,
type: 1 /* RpcForwardType.Notify */
};
return from(RpcForwardAutoClient.forward(this.rpc, data))
.pipe(map(response => {
if (response.error) {
throw response.error;
}
else {
return response.result;
}
}));
}
}
//# sourceMappingURL=rpc-forwarder.js.map
// SIG // Begin signature block
// SIG // MIIoKwYJKoZIhvcNAQcCoIIoHDCCKBgCAQExDzANBglg
// SIG // hkgBZQMEAgEFADB3BgorBgEEAYI3AgEEoGkwZzAyBgor
// SIG // BgEEAYI3AgEeMCQCAQEEEBDgyQbOONQRoqMAEEvTUJAC
// SIG // AQACAQACAQACAQACAQAwMTANBglghkgBZQMEAgEFAAQg
// SIG // HNtgCMo+bva+KUSNvP/Otg5Lr7YyLs8oyaAjp/gSuleg
// 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/15n8G9bW1qyVJzEw16UM0xghoNMIIaCQIBATCBlTB+
// SIG // MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv
// SIG // bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWlj
// SIG // cm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNy
// SIG // b3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExAhMzAAAE
// SIG // BGx0Bv9XKydyAAAAAAQEMA0GCWCGSAFlAwQCAQUAoIGu
// SIG // MBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisG
// SIG // AQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3
// SIG // DQEJBDEiBCCfnw833s6acKh9UMqqJy3hShkq74KqHWp5
// SIG // hMHGMKO9yzBCBgorBgEEAYI3AgEMMTQwMqAUgBIATQBp
// SIG // AGMAcgBvAHMAbwBmAHShGoAYaHR0cDovL3d3dy5taWNy
// SIG // b3NvZnQuY29tMA0GCSqGSIb3DQEBAQUABIIBAE55MWlf
// SIG // 6ehMqbbCD5bgVIA7AtwTK5Yw75HZAQ7/xixA+0PmsyF6
// SIG // dQtQxkosEsZxESdVyDXvxAMrJhHieKuQOZdLC17X9kr/
// SIG // lmJBxx7OzdHlw8S0BeHUgMn3wJ3FD4bSRJGLDE/r4NSC
// SIG // xwYhgIvEK+XK5FbCKy+QZr23Zole+c+YZdZ2ledMc6yk
// SIG // XwiW1mqLUPglhgMBl5OtRlEmdxwDc2UfFz92fB3ynpt9
// SIG // DyAnBaWoS0LAk3q7vFghLYqjC+vHbJW1SkKcA7CY2uRe
// SIG // yo+IBoMoJcIyWb1zhLP/tg0yxw+47lCNbRME1hWPv33N
// SIG // taqC/ECfYU39b0Qfm/FyrxV34e+hgheXMIIXkwYKKwYB
// SIG // BAGCNwMDATGCF4Mwghd/BgkqhkiG9w0BBwKgghdwMIIX
// SIG // bAIBAzEPMA0GCWCGSAFlAwQCAQUAMIIBUgYLKoZIhvcN
// SIG // AQkQAQSgggFBBIIBPTCCATkCAQEGCisGAQQBhFkKAwEw
// SIG // MTANBglghkgBZQMEAgEFAAQgeL8YBArXRZ0wXGzSUXVe
// SIG // ratXTs/iFcjRuPpuGiplBmQCBmeuE6DXBRgTMjAyNTAy
// SIG // MjAxNTI4MzUuOTkxWjAEgAIB9KCB0aSBzjCByzELMAkG
// SIG // A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO
// SIG // BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m
// SIG // dCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0
// SIG // IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNo
// SIG // aWVsZCBUU1MgRVNOOjg5MDAtMDVFMC1EOTQ3MSUwIwYD
// SIG // VQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNl
// SIG // oIIR7TCCByAwggUIoAMCAQICEzMAAAHt4V/L1felXXMA
// SIG // AQAAAe0wDQYJKoZIhvcNAQELBQAwfDELMAkGA1UEBhMC
// SIG // VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT
// SIG // B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw
// SIG // b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUt
// SIG // U3RhbXAgUENBIDIwMTAwHhcNMjMxMjA2MTg0NTQxWhcN
// SIG // MjUwMzA1MTg0NTQxWjCByzELMAkGA1UEBhMCVVMxEzAR
// SIG // BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v
// SIG // bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
// SIG // bjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2EgT3Bl
// SIG // cmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNO
// SIG // Ojg5MDAtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3Nv
// SIG // ZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG
// SIG // 9w0BAQEFAAOCAg8AMIICCgKCAgEAqDDCbJK66mqcnC8T
// SIG // wtR+8w+4PPDaWxGkOko3EyEW8wlcmEDbM/E2i9aahUxA
// SIG // Dy9V+6Iy+PxGhFvlIzambP2sjMluGCKRT2T9seBQTFQn
// SIG // XbHhdovmjDIwx4tC3E0GcTNrN5hTKwmQFkny2F2AyIph
// SIG // Qc/I9KC1hst1YC5gUyjOMS6r+w2VM/AdkqAJmxLaetp4
// SIG // EpdITqDe90hcBPmNuErxkDFocpKRvr1w8HKVr8A3vk4J
// SIG // 6y0ewE0RVzeSUtunZtssukmBTEWJzBN3TBwkP1ECEEDQ
// SIG // vJy5iL3SpAKFhDF7SbBhKN0KzNktkgb+D6R0c0bpM07T
// SIG // /lAHHhsTPScq8FED+TghJlumHIRMkQ0sD+IVPX+wdAMo
// SIG // deD8PbyaO43sDY3jDyJJp3si0otK7r9qMf8URrXCfcgT
// SIG // QuQWkZLY8+7LT2qI0fjwwNn7gbQqPMSpZLed5lG+wGPg
// SIG // mRx6oS5u+qXTBegR79k78JVQXkETdtl42lVUcAoI4CZz
// SIG // XsLez3o3K6VJ9Khy4C6vtQTdQ82LpFpE6+8E9M5dIl6/
// SIG // jbalJFkjp1kX3vDdtbQerr91ZFvJxXQobW22Wc9uKXi7
// SIG // SRGbjazfF3/T0zzM2VwyQSNRHIkf/dUHBqGRZlWxVW9q
// SIG // 1CALNNfmZHsL24ZhlQ3n1/aGRuPyuIBlLE701vq9SWTM
// SIG // VE9jMKkCAwEAAaOCAUkwggFFMB0GA1UdDgQWBBTOG/Ds
// SIG // 994QKgRHypQGX9DSoeAiGTAfBgNVHSMEGDAWgBSfpxVd
// SIG // AF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQ
// SIG // hk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3Bz
// SIG // L2NybC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENB
// SIG // JTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwG
// SIG // CCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5j
// SIG // b20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUt
// SIG // U3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNVHRMB
// SIG // Af8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4G
// SIG // A1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEA
// SIG // ndYCtkXfnhi9Hh4vohOv6g2PLG27DuHpmp3Keijzfsau
// SIG // WQGrYgUeI5kUYZvvVYpNBaNAy1ovzdvGxSO3V2MNPad7
// SIG // woqW48uBKIn5tDbne/+FN9Ivfu0b1u1zkN68d+/lO76v
// SIG // ZZOsmKRgjadI5SdfPPwrkT4KiZ36uRHXmnx9gKBuOoSl
// SIG // k3gew7l2rBrerKSTnpxnnUq3t+DFmankyENK2jiLWZxb
// SIG // hg8uPsaA9akc9kFvrtoAh2hvAEI4WFDOLk4vbepLbY+n
// SIG // O12pq9s61rnHg4c+7Ci7bS0ye8LOWKwNiPHE5WzAH9il
// SIG // tBlYym2Bnfi2RnbhCu/+37OBlJDKnOdRbDXRtZ/s4HO8
// SIG // x7tqBhnggYOLPGUdGRcse47IJvbEhQikOQrGwL5a/+tD
// SIG // XZOU3jEfCbNpDVInLtgqmdN/N907L04JO4g9Si4H0teh
// SIG // xL4zepuFSiSoIyeziSc2m7UuCUIFJyayGX8qLJOA9fK2
// SIG // Z4vaVMDdN1oE5nddFk8ImTruIPFJ+oinDzGP4hak7uJ7
// SIG // ZMxVMQQaWxRupNQiDWZqIqxFpgrRt5cmdiHXZo7SHn05
// SIG // CLxlm+Ccc8+5dpvxNpBjosQyR7GoWVZsLKDb4cuZLv4p
// SIG // 1PvnVx88PoZb6k0hU/PayBVYXJrFjwyTzUUkqTIaCd91
// SIG // dmWv5ZCnG5FDNEm0IEvarHcwggdxMIIFWaADAgECAhMz
// 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 // ahC0HVUzWLOhcGbyoYIDUDCCAjgCAQEwgfmhgdGkgc4w
// SIG // gcsxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n
// SIG // dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
// SIG // aWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1p
// SIG // Y3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJzAlBgNV
// SIG // BAsTHm5TaGllbGQgVFNTIEVTTjo4OTAwLTA1RTAtRDk0
// SIG // NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAg
// SIG // U2VydmljZaIjCgEBMAcGBSsOAwIaAxUA7h2sikwmmLGM
// SIG // SYfqFk8erlTxcPmggYMwgYCkfjB8MQswCQYDVQQGEwJV
// SIG // UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH
// SIG // UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv
// SIG // cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1T
// SIG // dGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAOth
// SIG // I1IwIhgPMjAyNTAyMjAwMzQzMTRaGA8yMDI1MDIyMTAz
// SIG // NDMxNFowdzA9BgorBgEEAYRZCgQBMS8wLTAKAgUA62Ej
// SIG // UgIBADAKAgEAAgIeUwIB/zAHAgEAAgISqjAKAgUA62J0
// SIG // 0gIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZ
// SIG // CgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYagMA0GCSqG
// SIG // SIb3DQEBCwUAA4IBAQDFtsBBKC2jelFRIH2CDQeM3Dtn
// SIG // NegpCDOhl0+j00u9EhAd85/o0qBY59TRkhpLyBG2ZVnu
// SIG // Jgap82ZhqQg74CMz0GKMIkBtFiRZcovtkex73M6SS/Ru
// SIG // 0j8n2IbEbWDLRwYgVFV8jA3NAaZqav/7T99QTV1iRBYd
// SIG // Yq+P4faTR4eVP0V1MRLX02JLF7s5GanB/Ij98LAQze6H
// SIG // bsHgzE1CYP5W7w15fh2jwJU35wWXTpoYUyfLsbGzGKyb
// SIG // zQDcKEZV4SrzY5Fc5LXQ2UACP6UgigZ6HkWlloCavzaW
// SIG // MWqZc7kzeEo9VBPZXOolN/i888O2OoOLIIULIIYHj1vT
// SIG // z8YokCrpMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMC
// SIG // VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT
// SIG // B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw
// SIG // b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUt
// SIG // U3RhbXAgUENBIDIwMTACEzMAAAHt4V/L1felXXMAAQAA
// SIG // Ae0wDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJ
// SIG // AzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQg
// SIG // 3SxZd6d1GuwINMWF6PydmM+uvja2ggh6VmEQyytWVlIw
// SIG // gfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCCNLg1o
// SIG // NAhbHisStwNepdcKyMK7Eg612esUn9BeMWzKOTCBmDCB
// SIG // gKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo
// SIG // aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK
// SIG // ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT
// SIG // HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMz
// SIG // AAAB7eFfy9X3pV1zAAEAAAHtMCIEIKehpqPZNMWvWSU4
// SIG // xN85KGCCJ8ISrlck3EcHy8ijfNkaMA0GCSqGSIb3DQEB
// SIG // CwUABIICADVIgnXZSCuYtPvKOWRMdBEGbk+bx/A5+o+k
// SIG // QB5pCVO6iZ74zAeJAr55puaShAFmcrS6I6yx6pG59ymt
// SIG // m9sAwVPLgilZFKNlKu9VLc8zHYH5IL0ui1xt048qBgVb
// SIG // LEZ6pbmjOHKKk0e8TqsKch9gacOPfkQcWYUIC7ACI5t5
// SIG // RZzYKh9HQDFWQaGrd5N6k+mF+cTpk3bL5C2JiwCd7BbF
// SIG // jiIxb3TxrCkk/BlJ9tMjDIyAaTUHRndOxkY+ufcMPDD2
// SIG // obESPgrWyxp2qHUXSX4EZ3e3/HGr/0u430SnwKD08j//
// SIG // 23kGw/XCnF3OOAoMSDDJs5PmjRjbW4BBQGYLTXgDrLf8
// SIG // 0TiHLNlTe9AE74qyUpC6owZvZUMSftZxYO3g5YtsM4tk
// SIG // uzbbb0VGRDW1Jm8bDqDe6N9+O7YHUmxy7lwyjpaQLt88
// SIG // g1QTsylNK33/BRC+vc5+E19EU51fLz5Vm55yt6U7SQDo
// SIG // aFGH95YLx+UA5dWOFAE8r4SzNb8aNiM5DJM/grXlG2AX
// SIG // wdkD6VkRabIPsUCFR2e8/j7xXYqPLYVjWsz1HxAV82Zu
// SIG // WgeLM9+32aqs49Jo81JplyZ3mxbBNyYA1j9JcCm/gnUZ
// SIG // d71V0/1AdPJyF60XY/18ze1qytjampOVL3GLdkcyK1HE
// SIG // ProSvQgTbJL3BdLW1BR8Ptmfzj1kFhii
// SIG // End signature block