file-upload-service.js

/*
 Copyright 2014 matrix.org
 
 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.
 */

'use strict';

// TODO determine if this is really required as a separate service to matrixService.
/*
 * Upload an HTML5 file to a server
 */
angular.module('mFileUpload', ['matrixService', 'mUtilities'])
.service('mFileUpload', ['$q', 'matrixService', 'mUtilities', function ($q, matrixService, mUtilities) {
        
    /*
     * Upload an HTML5 file or blob to a server and returned a promise
     * that will provide the URL of the uploaded file.
     * @param {File|Blob} file the file data to send
     */
    this.uploadFile = function(file) {
        var deferred = $q.defer();
        console.log("Uploading " + file.name + "... to /matrix/content");
        matrixService.uploadContent(file).then(
            function(response) {
                var content_url = location.origin + "/matrix/content/" + response.data.content_token;
                console.log("   -> Successfully uploaded! Available at " + content_url);
                deferred.resolve(content_url);
            },
            function(error) {
                console.log("   -> Failed to upload "  + file.name);
                deferred.reject(error);
            }
        );
        
        return deferred.promise;
    };
    
    /*
     * Upload an image file plus generate a thumbnail of it and upload it so that
     * we will have all information to fulfill an image message request data.
     * @param {File} imageFile the imageFile to send
     * @param {Integer} thumbnailSize the max side size of the thumbnail to create
     * @returns {promise} A promise that will be resolved by a image message object
     *   ready to be send with the Matrix API
     */
    this.uploadImageAndThumbnail = function(imageFile, thumbnailSize) {
        var self = this;
        var deferred = $q.defer();

        console.log("uploadImageAndThumbnail " + imageFile.name + " - thumbnailSize: " + thumbnailSize);

        // The message structure that will be returned in the promise
        var imageMessage = {
            msgtype: "m.image",
            url: undefined,
            body: {
                size: undefined,
                w: undefined,
                h: undefined,
                mimetype: undefined
            },
            thumbnail_url: undefined,
            thumbnail_info: {
                size: undefined,
                w: undefined,
                h: undefined,
                mimetype: undefined
            }
        };

        // First, get the image size
        mUtilities.getImageSize(imageFile).then(
            function(size) {

                // The final operation: send imageFile
                var uploadImage = function() {
                    self.uploadFile(imageFile).then(
                        function(url) {
                            // Update message metadata
                            imageMessage.url = url;
                            imageMessage.body = {
                                size: imageFile.size,
                                w: size.width,
                                h: size.height,
                                mimetype: imageFile.type
                            };

                            // If there is no thumbnail (because the original image is smaller than thumbnailSize),
                            // reuse the original image info for thumbnail data
                            if (!imageMessage.thumbnail_url) {
                                imageMessage.thumbnail_url = imageMessage.url;
                                imageMessage.thumbnail_info = imageMessage.body;
                            }

                            // We are done
                            deferred.resolve(imageMessage);
                        },
                        function(error) {
                            console.log("      -> Can't upload image");
                            deferred.reject(error); 
                        }
                    );
                };

                // Create a thumbnail if the image size exceeds thumbnailSize
                if (Math.max(size.width, size.height) > thumbnailSize) {
                    console.log("    Creating thumbnail...");
                    mUtilities.resizeImage(imageFile, thumbnailSize).then(
                        function(thumbnailBlob) {

                            // Get its size
                            mUtilities.getImageSize(thumbnailBlob).then(
                                function(thumbnailSize) {
                                    console.log("      -> Thumbnail size: " + JSON.stringify(thumbnailSize));

                                    // Upload it to the server
                                    self.uploadFile(thumbnailBlob).then(
                                        function(thumbnailUrl) {

                                            // Update image message data
                                            imageMessage.thumbnail_url = thumbnailUrl;
                                            imageMessage.thumbnail_info = {
                                                size: thumbnailBlob.size,
                                                w: thumbnailSize.width,
                                                h: thumbnailSize.height,
                                                mimetype: thumbnailBlob.type
                                            };

                                            // Then, upload the original image
                                            uploadImage();
                                        },
                                        function(error) {
                                            console.log("      -> Can't upload thumbnail");
                                            deferred.reject(error); 
                                        }
                                    );
                                },
                                function(error) {
                                    console.log("      -> Failed to get thumbnail size");
                                    deferred.reject(error); 
                                }
                            );

                        },
                        function(error) {
                            console.log("      -> Failed to create thumbnail: " + error);
                            deferred.reject(error); 
                        }
                    );
                }
                else {
                    // No need of thumbnail
                    console.log("   Thumbnail is not required");
                    uploadImage();
                }

            },
            function(error) {
                console.log("   -> Failed to get image size");
                deferred.reject(error); 
            }
        );

        return deferred.promise;
    };

}]);