@microsoft/windows-admin-center-sdk
Version:
Microsoft - Windows Admin Center Shell
571 lines (568 loc) • 29.5 kB
JavaScript
import { EMPTY, merge, of, throwError } from 'rxjs';
import { catchError, expand, filter, map, switchMap, take, tap } from 'rxjs/operators';
import { PersistentWorkItemApplyState } from './persistent-work-item-apply-state';
import { PersistentWorkItemState } from './persistent-work-item-state';
/**
* The runner of workflow.
*/
export class PersistentWorkflowRunner {
persistentStore;
builder;
/**
* Workflow always starts from startingId which is "1".
*/
static startingId = 1;
/**
* The collection of workflows. It allows multiple instances of workflows to track.
*/
workflowCollection = {};
/**
* Initializes a new instance of the PersistentWorkflowRunner class.
*
* @param persistentStore The persistent store instance.
* @param builder The builder of the workflow.
*/
constructor(persistentStore, builder) {
this.persistentStore = persistentStore;
this.builder = builder;
}
/**
* Start a new single workflow.
*
* @param transitData the transit data for initialization for the first workflow.
*/
start(transitData) {
const workflow = this.builder.build();
const firstWorkItem = workflow.collection.find(item => item.id === PersistentWorkflowRunner.startingId);
if (!firstWorkItem || firstWorkItem.state !== PersistentWorkItemState.NotStarted) {
return throwError(() => new Error('Couldn\'t find first work item.'));
}
const context = {
transitData,
persistentData: null,
applyState: PersistentWorkItemApplyState.Required,
store: {
save: this.save.bind(this)
},
logs: [],
workflow
};
return this.checkpoint(firstWorkItem, context, PersistentWorkItemState.NotStarted)
.pipe(switchMap(instanceId => {
this.workflowCollection[instanceId] = workflow;
return this.process(firstWorkItem, context);
}));
}
/**
* Start workflows from existing snapshots data from the store.
*/
startFromStore() {
return this.persistentStore.restore()
.pipe(switchMap(list => {
if (list.length === 0) {
return EMPTY;
}
const observables = [];
for (const snapshot of list) {
const workflow = this.builder.build();
const firstWorkItem = workflow.collection.find(item => item.id === snapshot.workItemId);
if (!firstWorkItem) {
return throwError(() => new Error('Couldn\'t locate the work item to restart.'));
}
const context = {
transitData: null,
persistentData: snapshot.workItemData,
applyState: PersistentWorkItemApplyState.Required,
instanceId: snapshot.instanceId,
store: {
save: this.save.bind(this)
},
logs: [],
workflow,
restoreVersion: snapshot.version
};
firstWorkItem.state = snapshot.workItemState;
if (firstWorkItem.state === PersistentWorkItemState.Applying) {
// at default apply() call will be omitted.
context.applyState = PersistentWorkItemApplyState.Skip;
firstWorkItem.state = PersistentWorkItemState.PreValidateByRestore;
}
this.workflowCollection[snapshot.instanceId] = workflow;
observables.push(this.process(firstWorkItem, context));
}
return merge(...observables);
}));
}
process(workItem, context) {
return this.processNext(workItem, context)
.pipe(catchError((error) => this.processResult(workItem, context, error)), switchMap(innerContext => {
const loopContext = {
completed: !!context.error,
context: innerContext,
workItem
};
return this.processResult(loopContext.workItem, loopContext.context)
.pipe(map(() => loopContext));
}), expand((loopContext) => {
if (loopContext.completed) {
return EMPTY;
}
return this.processNext(loopContext.workItem, loopContext.context)
.pipe(tap(() => {
if (loopContext.workItem.state === PersistentWorkItemState.Completed) {
loopContext.workItem = this.processStep(loopContext.workItem, loopContext.context);
if (!loopContext.workItem) {
loopContext.completed = true;
}
}
}), catchError((error) => this.processResult(loopContext.workItem, loopContext.context, error)), switchMap(inner2Context => {
loopContext.completed = loopContext.completed || !!inner2Context.error;
loopContext.context = inner2Context;
return this.processResult(loopContext.workItem, loopContext.context)
.pipe(map(() => loopContext));
}));
}), filter(loopContext => loopContext.completed), take(1), map(innerContext => {
const result = {
logs: innerContext.context.logs,
result: innerContext.context.transitData,
instanceId: innerContext.context.instanceId,
clear: () => this.persistentStore.clear(innerContext.context.instanceId),
error: innerContext.context.error
};
return result;
}));
}
processResult(workItem, context, error) {
if (!workItem) {
return of(context);
}
if (context.error) {
return of(context);
}
let checkpoint = () => of(null);
if (!error) {
switch (workItem.state) {
case PersistentWorkItemState.PreValidatingByRestore:
checkpoint = () => this.checkpoint(workItem, context, PersistentWorkItemState.PreValidateByRestoreSuccess);
break;
case PersistentWorkItemState.PreValidating:
checkpoint = () => this.checkpoint(workItem, context, PersistentWorkItemState.PreValidateSuccess);
break;
case PersistentWorkItemState.Applying:
checkpoint = () => this.checkpoint(workItem, context, PersistentWorkItemState.ApplySuccess);
break;
case PersistentWorkItemState.PostValidating:
checkpoint = () => this.checkpoint(workItem, context, PersistentWorkItemState.PostValidateSuccess);
break;
case PersistentWorkItemState.NotStarted:
case PersistentWorkItemState.Completed:
break;
default:
checkpoint = () => throwError(() => new Error('Unexpected success handling state.'));
}
return of(null)
.pipe(switchMap(checkpoint), map(() => context));
}
context.error = error;
switch (workItem.state) {
case PersistentWorkItemState.PreValidatingByRestore:
checkpoint = () => this.checkpoint(workItem, context, PersistentWorkItemState.PreValidateByRestoreError);
break;
case PersistentWorkItemState.PreValidating:
checkpoint = () => this.checkpoint(workItem, context, PersistentWorkItemState.PreValidateError);
break;
case PersistentWorkItemState.Applying:
checkpoint = () => this.checkpoint(workItem, context, PersistentWorkItemState.ApplyError);
break;
case PersistentWorkItemState.PostValidating:
checkpoint = () => this.checkpoint(workItem, context, PersistentWorkItemState.PostValidateError);
break;
default:
return throwError(() => new Error('Unexpected error handling state.'));
}
return of(null)
.pipe(switchMap(checkpoint), map(() => context));
}
processNext(workItem, context) {
let checkpointFunction;
let observableFunction = null;
switch (workItem.state) {
case PersistentWorkItemState.PreValidateByRestore:
case PersistentWorkItemState.PreValidatingByRestore:
checkpointFunction = () => this.checkpoint(workItem, context, PersistentWorkItemState.PreValidatingByRestore);
observableFunction = () => workItem.preValidate(context);
break;
case PersistentWorkItemState.NotStarted:
case PersistentWorkItemState.PreValidating:
workItem.init(context);
checkpointFunction = () => this.checkpoint(workItem, context, PersistentWorkItemState.PreValidating);
observableFunction = () => workItem.preValidate(context);
break;
case PersistentWorkItemState.PreValidateByRestoreSuccess:
case PersistentWorkItemState.PreValidateSuccess:
if (context.applyState === PersistentWorkItemApplyState.Skip) {
checkpointFunction = () => this.checkpoint(workItem, context, PersistentWorkItemState.PostValidating);
observableFunction = () => workItem.postValidate(context);
}
else {
checkpointFunction = () => this.checkpoint(workItem, context, PersistentWorkItemState.Applying);
observableFunction = () => workItem.apply(context);
}
break;
case PersistentWorkItemState.PostValidating:
case PersistentWorkItemState.ApplySuccess:
checkpointFunction = () => this.checkpoint(workItem, context, PersistentWorkItemState.PostValidating);
observableFunction = () => workItem.postValidate(context);
break;
case PersistentWorkItemState.PostValidateSuccess:
case PersistentWorkItemState.Completed:
workItem.finalize(context);
context.applyState = PersistentWorkItemApplyState.Required;
checkpointFunction = () => this.checkpoint(workItem, context, PersistentWorkItemState.Completed);
break;
default:
return throwError(() => new Error('Unexpected process next state.'));
}
if (!observableFunction) {
return of(null)
.pipe(switchMap(checkpointFunction), map(() => context));
}
return of(null)
.pipe(switchMap(checkpointFunction), switchMap(observableFunction));
}
processStep(workItem, context) {
if (workItem.state === PersistentWorkItemState.ApplyError || workItem.state === PersistentWorkItemState.PostValidateError) {
return null;
}
if (workItem.state === PersistentWorkItemState.Completed && workItem.nextId < 0) {
return null;
}
return this.workflowCollection[context.instanceId].collection.find(item => item.id === workItem.nextId);
}
checkpoint(workItem, context, state) {
return this.persistentStore.save(context.workflow.version, workItem.id, state, context.persistentData, context.instanceId)
.pipe(map(snapshot => {
workItem.state = state;
context.logs.push({ time: Date.now(), name: workItem.name, state: PersistentWorkItemState[state] });
return context.instanceId = snapshot.instanceId;
}));
}
save(workItem, context) {
return this.checkpoint(workItem, context, workItem.state);
}
}
//# sourceMappingURL=persistent-workflow-runner.js.map
// SIG // Begin signature block
// SIG // MIIoKAYJKoZIhvcNAQcCoIIoGTCCKBUCAQExDzANBglg
// SIG // hkgBZQMEAgEFADB3BgorBgEEAYI3AgEEoGkwZzAyBgor
// SIG // BgEEAYI3AgEeMCQCAQEEEBDgyQbOONQRoqMAEEvTUJAC
// SIG // AQACAQACAQACAQACAQAwMTANBglghkgBZQMEAgEFAAQg
// SIG // sYw9Kw9vKp6+EO22IHUBeu85ZTvRzcYTEQ3qNBNZT2Og
// 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 // DQEJBDEiBCD4TvgtAocLca/PQ+fgf7cvwT34kQExyT+B
// SIG // +Gtf9SbXMzBCBgorBgEEAYI3AgEMMTQwMqAUgBIATQBp
// SIG // AGMAcgBvAHMAbwBmAHShGoAYaHR0cDovL3d3dy5taWNy
// SIG // b3NvZnQuY29tMA0GCSqGSIb3DQEBAQUABIIBAGNldwNZ
// SIG // 4odIxm8W2x5Ak3JJiDdsS8fuq5GiHOvvMaTW115HAlp4
// SIG // p7i/rifywWbyTaVLGNMwTmIw0zTcP9EYsLi7aUVDVrEa
// SIG // I/rxs51qZZ1Rvtmmz36nh2dTkFLj76HBJFD/22VCZEIS
// SIG // /aDeRYPgbazVq01yQ7WVos2XIhDC+A6+FuVG7lrv2Joj
// SIG // cWrT4Rjn71Mk/t35ZIAlEeGzs6z9SqfYvLonAMpIFNh0
// SIG // ymU4rCN4Ma/F96LVBqm+JiImRiGjaTdh/JYX1cP42N9H
// SIG // mVatIuvmaDsKfUyRumUulvb5V5vZMvxwpcxZwqSDEEwS
// SIG // zBwde2Rg4X5EYunoK2n0naizWYGhgheUMIIXkAYKKwYB
// SIG // BAGCNwMDATGCF4Awghd8BgkqhkiG9w0BBwKgghdtMIIX
// SIG // aQIBAzEPMA0GCWCGSAFlAwQCAQUAMIIBUgYLKoZIhvcN
// SIG // AQkQAQSgggFBBIIBPTCCATkCAQEGCisGAQQBhFkKAwEw
// SIG // MTANBglghkgBZQMEAgEFAAQgOtcqGp8Wa3s9hj8XppT/
// SIG // Q4bwOTIntgmai1JglSMR0pMCBmeuBCN1JBgTMjAyNTAy
// SIG // MjAxNTI4NDAuMzQ4WjAEgAIB9KCB0aSBzjCByzELMAkG
// 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 // BgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQg2NRM
// SIG // 06uE70UZKGXQZrFNR8L2tWK0pX5wg652iXSs6ZIwgfoG
// SIG // CyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCAq0trE1QKE
// SIG // IIJB0efaTaooHtMXyU9id1PFtUnPB/jrHTCBmDCBgKR+
// SIG // MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n
// SIG // dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
// SIG // aWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1p
// SIG // Y3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB
// SIG // 6FCwgM8rcplNAAEAAAHoMCIEILulQdh3oFLTIq5y+urR
// SIG // lRGa7Lb5Opb36+YP2FBx+jrTMA0GCSqGSIb3DQEBCwUA
// SIG // BIICAEhUsbDNOoOfn3SfpwhrjyvkcQamrAzCq5s3ohoF
// SIG // tXphuXRs4PufamGusgN8yZmVTes0yuDCnTjGaSLunuGh
// SIG // CGWSjVngkWNui8b0lLEyjRlzJoQ3rX37NvY53eo3Vuue
// SIG // LSPERp6V5Ek5qx9kDNNRyCWnIa3/i65pklldT3EHKtug
// SIG // 6r0Ts+E45+ZZu+bLvfMQ7N5DWsHJacVDlWTT9Qv98pau
// SIG // QLUMEGobEJ/NRqnVJj0eNLSWIyFaJ6WtsjJ/hVsLls6z
// SIG // wZg8Gvbd/5tllrFvKZnGYTuhNOE8zE4vBPeMLTSsHjhf
// SIG // o7XakqUe95DApsHThT1Fl6T5qgYuCP9zw2b0GwTor7f9
// SIG // 0HVcNnosKxiGmTj5xNmrNpfYz+sPgHLDIcSDGxDrmtMM
// SIG // o//Ajb3O/9Uma2zr3VWNEqOGKgvOFLIkMGsk26aeTVdP
// SIG // cV/4mTKXGU/5QEBMgsRjbvuikGnVQUK71xQxRTaVJUMs
// SIG // N50K4y4R3wSnB7Bm7zmbu99sPaN94h3Q/yRaB1OJIiUe
// SIG // Ehlwby5Oku5pX6EgWrF5m3AQWoux/cinG6vQqvsB9001
// SIG // bolUnh9sBMqGbDHnuq9ziCmtHZ/3hiUxfMI2s2bCQsHg
// SIG // VrOztsSkqW3CfrxA3PDijfu2y9tXARoPPi0wnsjbFTGL
// SIG // u2nfqUFcMPeriFuovhlhsaTdUF+5
// SIG // End signature block