NativeScript/file-system/file-system.impl.ts

import file_access_module = require("file-system/file-system-access");
import promises = require("promises");

// The FileSystemAccess implementation, used through all the APIs.
var fileAccess;
var getFileAccess = function (): file_access_module.FileSystemAccess {
    if (!fileAccess) {
        fileAccess = new file_access_module.FileSystemAccess();
    }

    return fileAccess;
};

// we are defining these as private variables within the IO scope and will use them to access the corresponding properties for each FSEntity instance.
// this allows us to encapsulate (hide) the explicit property setters and force the users go through the exposed APIs to receive FSEntity instances.
var nameProperty = "_name";
var pathProperty = "_path";
var isKnownProperty = "_isKnown";
var fileLockedProperty = "_locked";
var extensionProperty = "_extension";
var lastModifiedProperty = "_lastModified";

var createFile = function (info: { path: string; name: string; extension: string }) {
    var file = new File();
    file[pathProperty] = info.path;
    file[nameProperty] = info.name;
    file[extensionProperty] = info.extension;

    return file;
};

var createFolder = function (info: { path: string; name: string; }) {
    var documents = knownFolders.documents();
    if (info.path === documents.path) {
        return documents;
    }

    var temp = knownFolders.temp();
    if (info.path === temp.path) {
        return temp;
    }

    var folder = new Folder();

    folder[pathProperty] = info.path;
    folder[nameProperty] = info.name;

    return folder;
};

export class FileSystemEntity {
    get parent(): Folder {
        var onError = function (error) {
            throw error;
        }

        var folderInfo = getFileAccess().getParent(this.path, onError);
        if (!folderInfo) {
            return undefined;
        }

        return createFolder(folderInfo);
    }

    public remove(): promises.Promise<any> {
        var fileAccess = getFileAccess();
        var promise = promises.defer<any>();

        var localSucces = function () {
            promise.resolve();
        }
        var localError = function (error: any) {
            promise.reject(error);
        }

        if (this instanceof File) {
            fileAccess.deleteFile(this.path, localSucces, localError);
        } else if (this instanceof Folder) {
            fileAccess.deleteFolder(this.path, this[isKnownProperty], localSucces, localError);
        }

        return promise.promise();
    }

    public rename(newName: string): promises.Promise<any> {
        var deferred = promises.defer<any>();

        if (this instanceof Folder) {
            if (this[isKnownProperty]) {
                deferred.reject(new Error("Cannot rename known folder."));
                return deferred.promise();
            }
        }

        var parentFolder = this.parent;
        if (!parentFolder) {
            deferred.reject(new Error("No parent folder."));
            return deferred.promise();
        }

        var fileAccess = getFileAccess();
        var path = parentFolder.path;
        var newPath = fileAccess.joinPath(path, newName);

        var that = this;
        var localSucceess = function () {
            that[pathProperty] = newPath;
            that[nameProperty] = newName;

            if (that instanceof File) {
                that[extensionProperty] = fileAccess.getFileExtension(newPath);
            }

            deferred.resolve();
        }

        var localError = function (error) {
            deferred.reject(error);
        }

        fileAccess.rename(this.path, newPath, localSucceess, localError);

        return deferred.promise();
    }

    get name(): string {
        return this[nameProperty];
    }

    get path(): string {
        return this[pathProperty];
    }

    get lastModified(): Date {
        var value = this[lastModifiedProperty];
        if (!this[lastModifiedProperty]) {
            value = this[lastModifiedProperty] = getFileAccess().getLastModified(this.path);
        }

        return value;
    }
}

export class File extends FileSystemEntity {

    public static fromPath(path: string) {
        var onError = function (error) {
            throw error;
        }

        var fileInfo = getFileAccess().getFile(path, onError);
        if (!fileInfo) {
            return undefined;
        }

        return createFile(fileInfo);
    }

    public static exists(path: string): boolean {
        return getFileAccess().fileExists(path);
    }

    get extension(): string {
        return this[extensionProperty];
    }

    get isLocked(): boolean {
        return this[fileLockedProperty];
    }

    public readText(encoding?: string): promises.Promise<string> {
        this.checkAccess();

        var deferred = promises.defer<string>();
        this[fileLockedProperty] = true;

        var that = this;
        var localSuccess = function (content: string) {
            that[fileLockedProperty] = false;
            deferred.resolve(content);
        }

        var localError = function (error) {
            that[fileLockedProperty] = false;
            deferred.reject(error);
        }

        // TODO: Asyncronous
        getFileAccess().readText(this.path, localSuccess, localError, encoding);

        return deferred.promise();
    }

    public writeText(content: string, encoding?: string): promises.Promise<any> {
        this.checkAccess();

        var deferred = promises.defer<string>();
        this[fileLockedProperty] = true;

        var that = this;
        var localSuccess = function () {
            that[fileLockedProperty] = false;
            deferred.resolve();
        };

        var localError = function (error) {
            that[fileLockedProperty] = false;
            deferred.reject(error);
        };

        // TODO: Asyncronous
        getFileAccess().writeText(this.path, content, localSuccess, localError, encoding);

        return deferred.promise();
    }

    private checkAccess() {
        if (this.isLocked) {
            throw new Error("Cannot access a locked file.");
        }
    }
}

export class Folder extends FileSystemEntity {

    public static fromPath(path: string): Folder {
        var onError = function (error) {
            throw error;
        }

        var folderInfo = getFileAccess().getFolder(path, onError);
        if (!folderInfo) {
            return undefined;
        }

        return createFolder(folderInfo);
    }

    public static exists(path: string): boolean {
        return getFileAccess().folderExists(path);
    }

    public contains(name: string): boolean {
        var fileAccess = getFileAccess();
        var path = fileAccess.joinPath(this.path, name);

        if (fileAccess.fileExists(path)) {
            return true;
        }

        return fileAccess.folderExists(path);
    }

    public clear(): promises.Promise<any> {
        var deferred = promises.defer<any>();

        var onSuccess = function () {
            deferred.resolve();
        }
        var onError = function (error) {
            deferred.reject(error);
        }

        getFileAccess().emptyFolder(this.path, onSuccess, onError);

        return deferred.promise();
    }

    get isKnown(): boolean {
        return this[isKnownProperty];
    }

    public getFile(name: string): File {
        var fileAccess = getFileAccess();
        var path = fileAccess.joinPath(this.path, name);

        var onError = function (error) {
            throw error;
        }

        var fileInfo = fileAccess.getFile(path, onError);
        if (!fileInfo) {
            return undefined;
        }

        return createFile(fileInfo);
    }

    public getFolder(name: string): Folder {
        var fileAccess = getFileAccess();
        var path = fileAccess.joinPath(this.path, name);

        var onError = function (error) {
            throw error;
        }

        var folderInfo = fileAccess.getFolder(path, onError);
        if (!folderInfo) {
            return undefined;
        }

        return createFolder(folderInfo);
    }

    public getEntities(): promises.Promise<Array<FileSystemEntity>> {
        var deferred = promises.defer<Array<FileSystemEntity>>();

        var onSuccess = function (fileInfos: Array<{ path: string; name: string; extension: string }>) {
            var entities = new Array<FileSystemEntity>();
            var i,
                path: string,
                entity: FileSystemEntity;

            for (i = 0; i < fileInfos.length; i++) {
                if (fileInfos[i].extension) {
                    entities.push(createFile(fileInfos[i]));
                } else {
                    entities.push(createFolder(fileInfos[i]));
                }
            }

            deferred.resolve(entities);
        }

        var onError = function (error) {
            throw error;
        }

        getFileAccess().getEntities(this.path, onSuccess, onError);

        return deferred.promise();
    }

    public eachEntity(onEntity: (entity: FileSystemEntity) => boolean) {
        if (!onEntity) {
            return;
        }

        var onSuccess = function (fileInfo: { path: string; name: string; extension: string }): boolean {
            var entity;
            if (fileInfo.extension) {
                entity = createFile(fileInfo);
            } else {
                entity = createFolder(fileInfo);
            }

            return onEntity(entity);
        }

        var onError = function (error) {
            throw error;
        }

        getFileAccess().eachEntity(this.path, onSuccess, onError);
    }
}

export module knownFolders {
    var _documents: Folder;
    var _temp: Folder;

    export var documents = function (): Folder {
        if (!_documents) {
            var path = getFileAccess().getDocumentsFolderPath();
            _documents = new Folder();
            _documents[pathProperty] = path;
            _documents[isKnownProperty] = true;
        }

        return _documents;
    };

    export var temp = function (): Folder {
        if (!_temp) {
            var path = getFileAccess().getTempFolderPath();
            _temp = new Folder();
            _temp[pathProperty] = path;
            _temp[isKnownProperty] = true;
        }

        return _temp;
    }
}

export module path {

    export function normalize(path: string): string {
        return getFileAccess().normalizePath(path);
    }

    export function join(...paths: string[]): string {
        var fileAccess = getFileAccess();
        return fileAccess.joinPaths(paths);
    }

    export var separator = getFileAccess().getPathSeparator();
}