mirror of
https://github.com/laurent22/joplin.git
synced 2024-12-24 10:27:10 +02:00
367 lines
11 KiB
TypeScript
367 lines
11 KiB
TypeScript
import FsDriverBase, { ReadDirStatsOptions } from '@joplin/lib/fs-driver-base';
|
|
const RNFetchBlob = require('rn-fetch-blob').default;
|
|
import * as RNFS from 'react-native-fs';
|
|
import RNSAF, { DocumentFileDetail, openDocumentTree } from '@joplin/react-native-saf-x';
|
|
import { Platform } from 'react-native';
|
|
import tarCreate from './tarCreate';
|
|
import tarExtract from './tarExtract';
|
|
import JoplinError from '@joplin/lib/JoplinError';
|
|
const md5 = require('md5');
|
|
import { resolve } from 'path';
|
|
|
|
|
|
const ANDROID_URI_PREFIX = 'content://';
|
|
|
|
function isScopedUri(path: string) {
|
|
return path.includes(ANDROID_URI_PREFIX);
|
|
}
|
|
|
|
// Encodings supported by rn-fetch-blob, RNSAF, and
|
|
// RNFS.
|
|
// See also
|
|
// - https://github.com/itinance/react-native-fs#readfilefilepath-string-encoding-string-promisestring
|
|
// - https://github.com/joltup/rn-fetch-blob/blob/cf9e8843599de92031df2660d5a1da18491fa3c0/android/src/main/java/com/RNFetchBlob/RNFetchBlobFS.java#L1049
|
|
export enum SupportedEncoding {
|
|
Utf8 = 'utf8',
|
|
Ascii = 'ascii',
|
|
Base64 = 'base64',
|
|
}
|
|
const supportedEncodings = Object.values<string>(SupportedEncoding);
|
|
|
|
// Converts some encodings specifiers that work with NodeJS into encodings
|
|
// that work with RNSAF, RNFetchBlob.fs, and RNFS.
|
|
//
|
|
// Throws if an encoding can't be normalized.
|
|
const normalizeEncoding = (encoding: string): SupportedEncoding => {
|
|
encoding = encoding.toLowerCase();
|
|
|
|
// rn-fetch-blob and RNSAF require the exact string "utf8", but NodeJS (and thus
|
|
// fs-driver-node) support variants on this like "UtF-8" and "utf-8". Convert them:
|
|
if (encoding === 'utf-8') {
|
|
encoding = 'utf8';
|
|
}
|
|
|
|
if (!supportedEncodings.includes(encoding)) {
|
|
throw new Error(`Unsupported encoding: ${encoding}.`);
|
|
}
|
|
|
|
return encoding as SupportedEncoding;
|
|
};
|
|
|
|
export default class FsDriverRN extends FsDriverBase {
|
|
public appendFileSync() {
|
|
throw new Error('Not implemented: appendFileSync');
|
|
}
|
|
|
|
// Requires that the file already exists.
|
|
// TODO: Update for compatibility with fs-driver-node's appendFile (which does not
|
|
// require that the file exists).
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
|
|
public appendFile(path: string, content: any, rawEncoding = 'base64') {
|
|
const encoding = normalizeEncoding(rawEncoding);
|
|
|
|
if (isScopedUri(path)) {
|
|
return RNSAF.writeFile(path, content, { encoding, append: true });
|
|
}
|
|
return RNFS.appendFile(path, content, encoding);
|
|
}
|
|
|
|
// Encoding can be either "utf8", "utf-8", or "base64"
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
|
|
public writeFile(path: string, content: any, rawEncoding = 'base64') {
|
|
const encoding = normalizeEncoding(rawEncoding);
|
|
|
|
if (isScopedUri(path)) {
|
|
return RNSAF.writeFile(path, content, { encoding: encoding });
|
|
}
|
|
|
|
// We need to use rn-fetch-blob here due to this bug:
|
|
// https://github.com/itinance/react-native-fs/issues/700
|
|
return RNFetchBlob.fs.writeFile(path, content, encoding);
|
|
}
|
|
|
|
// same as rm -rf
|
|
public async remove(path: string) {
|
|
return await this.unlink(path);
|
|
}
|
|
|
|
// Returns a format compatible with Node.js format
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
|
|
private rnfsStatToStd_(stat: any, path: string) {
|
|
let birthtime;
|
|
const mtime = stat.lastModified ? new Date(stat.lastModified) : stat.mtime;
|
|
if (stat.lastModified) {
|
|
birthtime = new Date(stat.lastModified);
|
|
} else if (stat.ctime) {
|
|
// Confusingly, "ctime" normally means "change time" but here it's used as "creation time". Also sometimes it is null
|
|
birthtime = stat.ctime;
|
|
} else {
|
|
birthtime = stat.mtime;
|
|
}
|
|
return {
|
|
birthtime,
|
|
mtime,
|
|
isDirectory: () => stat.type ? stat.type === 'directory' : stat.isDirectory(),
|
|
path: path,
|
|
size: stat.size,
|
|
};
|
|
}
|
|
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
|
|
public async readDirStats(path: string, options: any = null) {
|
|
if (!options) options = {};
|
|
if (!('recursive' in options)) options.recursive = false;
|
|
|
|
const isScoped = isScopedUri(path);
|
|
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
|
|
let stats: any[] = [];
|
|
try {
|
|
if (isScoped) {
|
|
stats = await RNSAF.listFiles(path);
|
|
} else {
|
|
stats = await RNFS.readDir(path);
|
|
}
|
|
} catch (error) {
|
|
throw new Error(`Could not read directory: ${path}: ${error.message}`);
|
|
}
|
|
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
|
|
let output: any[] = [];
|
|
for (let i = 0; i < stats.length; i++) {
|
|
const stat = stats[i];
|
|
const relativePath = (isScoped ? stat.uri : stat.path).substr(path.length + 1);
|
|
const standardStat = this.rnfsStatToStd_(stat, relativePath);
|
|
output.push(standardStat);
|
|
|
|
if (isScoped) {
|
|
// readUriDirStatsHandleRecursion_ expects stat to have a URI property.
|
|
// Use the original stat.
|
|
output = await this.readUriDirStatsHandleRecursion_(stat, output, options);
|
|
} else {
|
|
output = await this.readDirStatsHandleRecursion_(path, standardStat, output, options);
|
|
}
|
|
}
|
|
return output;
|
|
}
|
|
|
|
|
|
protected async readUriDirStatsHandleRecursion_(stat: DocumentFileDetail, output: DocumentFileDetail[], options: ReadDirStatsOptions) {
|
|
if (options.recursive && stat.type === 'directory') {
|
|
const subStats = await this.readDirStats(stat.uri, options);
|
|
for (let j = 0; j < subStats.length; j++) {
|
|
const subStat = subStats[j];
|
|
output.push(subStat);
|
|
}
|
|
}
|
|
return output;
|
|
}
|
|
|
|
public async move(source: string, dest: string) {
|
|
if (isScopedUri(source) || isScopedUri(dest)) {
|
|
await RNSAF.moveFile(source, dest, { replaceIfDestinationExists: true });
|
|
}
|
|
return RNFS.moveFile(source, dest);
|
|
}
|
|
|
|
public async rename(source: string, dest: string) {
|
|
if (isScopedUri(source) || isScopedUri(dest)) {
|
|
await RNSAF.rename(source, dest);
|
|
}
|
|
return RNFS.moveFile(source, dest);
|
|
}
|
|
|
|
public async exists(path: string) {
|
|
if (isScopedUri(path)) {
|
|
return RNSAF.exists(path);
|
|
}
|
|
return RNFS.exists(path);
|
|
}
|
|
|
|
public async mkdir(path: string) {
|
|
if (isScopedUri(path)) {
|
|
await RNSAF.mkdir(path);
|
|
return;
|
|
}
|
|
|
|
// Also creates parent directories: Works like mkdir -p
|
|
return RNFS.mkdir(path);
|
|
}
|
|
|
|
public async stat(path: string) {
|
|
try {
|
|
let r;
|
|
if (isScopedUri(path)) {
|
|
r = await RNSAF.stat(path);
|
|
} else {
|
|
r = await RNFS.stat(path);
|
|
}
|
|
return this.rnfsStatToStd_(r, path);
|
|
} catch (error) {
|
|
if (error && (error.code === 'ENOENT' || !(await this.exists(path)))) {
|
|
// Probably { [Error: File does not exist] framesToPop: 1, code: 'EUNSPECIFIED' }
|
|
// or { [Error: The file {file} couldn’t be opened because there is no such file.], code: 'ENSCOCOAERRORDOMAIN260' }
|
|
// which unfortunately does not have a proper error code. Can be ignored.
|
|
return null;
|
|
} else {
|
|
throw error;
|
|
}
|
|
}
|
|
}
|
|
|
|
// NOTE: DOES NOT WORK - no error is thrown and the function is called with the right
|
|
// arguments but the function returns `false` and the timestamp is not set.
|
|
// Current setTimestamp is not really used so keep it that way, but careful if it
|
|
// becomes needed.
|
|
public async setTimestamp() {
|
|
// return RNFS.touch(path, timestampDate, timestampDate);
|
|
}
|
|
|
|
public async open(path: string, mode: string) {
|
|
if (isScopedUri(path)) {
|
|
throw new Error('open() not implemented in FsDriverAndroid');
|
|
}
|
|
// Note: RNFS.read() doesn't provide any way to know if the end of file has been reached.
|
|
// So instead we stat the file here and use stat.size to manually check for end of file.
|
|
// Bug: https://github.com/itinance/react-native-fs/issues/342
|
|
const stat = await this.stat(path);
|
|
return {
|
|
path: path,
|
|
offset: 0,
|
|
mode: mode,
|
|
stat: stat,
|
|
};
|
|
}
|
|
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
|
|
public close(_handle: any): Promise<void> {
|
|
// Nothing
|
|
return null;
|
|
}
|
|
|
|
public readFile(path: string, rawEncoding = 'utf8') {
|
|
const encoding = normalizeEncoding(rawEncoding);
|
|
|
|
if (isScopedUri(path)) {
|
|
return RNSAF.readFile(path, { encoding: encoding });
|
|
}
|
|
return RNFS.readFile(path, encoding);
|
|
}
|
|
|
|
// Always overwrite destination
|
|
public async copy(source: string, dest: string) {
|
|
let retry = false;
|
|
try {
|
|
if (isScopedUri(source) || isScopedUri(dest)) {
|
|
await RNSAF.copyFile(source, dest, { replaceIfDestinationExists: true });
|
|
return;
|
|
}
|
|
await RNFS.copyFile(source, dest);
|
|
} catch (error) {
|
|
// On iOS it will throw an error if the file already exist
|
|
retry = true;
|
|
await this.unlink(dest);
|
|
}
|
|
|
|
if (retry) {
|
|
if (isScopedUri(source) || isScopedUri(dest)) {
|
|
await RNSAF.copyFile(source, dest, { replaceIfDestinationExists: true });
|
|
} else {
|
|
await RNFS.copyFile(source, dest);
|
|
}
|
|
}
|
|
}
|
|
|
|
public async unlink(path: string) {
|
|
try {
|
|
if (isScopedUri(path)) {
|
|
await RNSAF.unlink(path);
|
|
return;
|
|
}
|
|
await RNFS.unlink(path);
|
|
} catch (error) {
|
|
if (error && ((error.message && error.message.indexOf('exist') >= 0) || error.code === 'ENOENT')) {
|
|
// Probably { [Error: File does not exist] framesToPop: 1, code: 'EUNSPECIFIED' }
|
|
// which unfortunately does not have a proper error code. Can be ignored.
|
|
} else {
|
|
throw error;
|
|
}
|
|
}
|
|
}
|
|
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
|
|
public async readFileChunk(handle: any, length: number, rawEncoding = 'base64') {
|
|
if (!handle?.stat) {
|
|
throw new JoplinError('File does not exist (reading file chunk).', 'ENOENT');
|
|
}
|
|
|
|
const encoding = normalizeEncoding(rawEncoding);
|
|
|
|
if (handle.offset + length > handle.stat.size) {
|
|
length = handle.stat.size - handle.offset;
|
|
}
|
|
|
|
if (!length) return null;
|
|
const output = await RNFS.read(handle.path, length, handle.offset, encoding);
|
|
// eslint-disable-next-line require-atomic-updates
|
|
handle.offset += length;
|
|
return output ? output : null;
|
|
}
|
|
|
|
public resolve(...paths: string[]): string {
|
|
return resolve(...paths);
|
|
}
|
|
|
|
public async md5File(path: string): Promise<string> {
|
|
if (isScopedUri(path)) {
|
|
// Warning: Slow
|
|
const fileData = Buffer.from(await this.readFile(path, 'base64'), 'base64');
|
|
return md5(fileData);
|
|
} else {
|
|
return await RNFS.hash(path, 'md5');
|
|
}
|
|
}
|
|
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
|
|
public async tarExtract(options: any) {
|
|
await tarExtract({
|
|
cwd: RNFS.DocumentDirectoryPath,
|
|
...options,
|
|
});
|
|
}
|
|
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
|
|
public async tarCreate(options: any, filePaths: string[]) {
|
|
await tarCreate({
|
|
cwd: RNFS.DocumentDirectoryPath,
|
|
...options,
|
|
}, filePaths);
|
|
}
|
|
|
|
public async getExternalDirectoryPath(): Promise<string | undefined> {
|
|
let directory;
|
|
if (this.isUsingAndroidSAF()) {
|
|
const doc = await openDocumentTree(true);
|
|
if (doc?.uri) {
|
|
directory = doc?.uri;
|
|
}
|
|
} else {
|
|
directory = RNFS.ExternalDirectoryPath;
|
|
}
|
|
return directory;
|
|
}
|
|
|
|
public getCacheDirectoryPath() {
|
|
return RNFS.CachesDirectoryPath;
|
|
}
|
|
|
|
public getAppDirectoryPath() {
|
|
return RNFetchBlob.fs.dirs.DocumentDir;
|
|
}
|
|
|
|
public isUsingAndroidSAF() {
|
|
return Platform.OS === 'android' && Platform.Version > 28;
|
|
}
|
|
|
|
}
|