[ADF-3095] ability to intercept, pause and resume upload process (#3416)

* prevent and resume upload process

* upload fixes and confirmation dialog demo

* ability to toggle the upload confirmation demo

* fix tests

* unit tests

* docs update

* remove deprecation

* fix test name

lib/content-services/upload/components/upload-files.event.ts

@@ -0,0 +1,45 @@
+/*!
+ * @license
+ * Copyright 2016 Alfresco Software, Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { FileModel, UploadService } from '@alfresco/adf-core';
+
+export class UploadFilesEvent {
+
+    private isDefaultPrevented: boolean = false;
+
+    get defaultPrevented() {
+        return this.isDefaultPrevented;
+    }
+
+    preventDefault() {
+        this.isDefaultPrevented = true;
+    }
+
+    constructor(public files: Array<FileModel>, private uploadService: UploadService) {
+    }
+
+    pauseUpload() {
+        this.preventDefault();
+    }
+
+    resumeUpload() {
+        if (this.files && this.files.length > 0) {
+            this.uploadService.addToQueue(...this.files);
+            this.uploadService.uploadFilesInTheQueue();
+        }
+    }
+}