filesystem.js 2.28 KB
/*
 *
 * ADOBE CONFIDENTIAL
 * __________________
 *
 *  Copyright 2017 Adobe Systems Incorporated
 *  All Rights Reserved.
 *
 * NOTICE:  All information contained herein is, and remains
 * the property of Adobe Systems Incorporated and its suppliers,
 * if any.  The intellectual and technical concepts contained
 * herein are proprietary to Adobe Systems Incorporated and its
 * suppliers and are protected by trade secret or copyright law.
 * Dissemination of this information or reproduction of this material
 * is strictly forbidden unless prior written permission is obtained
 * from Adobe Systems Incorporated.
 */
/* istanbul ignore next */
/* globals Promise */

define('screens/player/firmware/filesystem/spi/filesystem', [], function() {
    'use strict';

    /**
     * Defines the Filesystem SPI.
     *
     * @interface FilesystemSpi
     */
    return Object.freeze({

        /**
         * The service name
         * @property serviceName
         * @memberof FilesystemSpi
         * @constant
         */
        serviceName: 'com.adobe.cq.screens.player.filesystem.spi.filesystem',

        /**
         * Joins all given path segments together using the platform specific separator as a delimiter,
         * then normalizes the resulting path.
         * Zero-length path segments are ignored. If the joined path string is a zero-length string then '.'
         * will be returned, representing the current working directory.
         *
         * @function Filesystem#joinPath
         * @param {Array} paths specific normalised path
         * @return {String} Platform specific normalised path
         */
        joinPath: function() { return new Error('not implemented'); },

        /**
         * Returns the root path where the offline file will be extracted.
         * @function Filesystem#getUserDataPath
         * @return {Promise} Path to User data folder
         */
        getUserDataPath: function() { return Promise.reject('Not implemented.'); },

        /**
         * Returns the body of the given path as text.
         * @param {String} path The path to the file
         * @function Filesystem#readFileAsText
         * @return {Promise} The body of the given file as text.
         */
        readFileAsText: function(path) { return Promise.reject('Not implemented.'); }

    });

});