'use strict'; (function () { const asar = process._linkedBinding('electron_common_asar'); const v8Util = process._linkedBinding('electron_common_v8_util'); const { Buffer } = require('buffer'); const Module = require('module'); const path = require('path'); const util = require('util'); const Promise = global.Promise; const envNoAsar = process.env.ELECTRON_NO_ASAR && process.type !== 'browser' && process.type !== 'renderer'; const isAsarDisabled = () => process.noAsar || envNoAsar; const internalBinding = process.internalBinding; delete process.internalBinding; /** * @param {!Function} functionToCall * @param {!Array|undefined} args */ const nextTick = (functionToCall, args = []) => { process.nextTick(() => functionToCall(...args)); }; // Cache asar archive objects. const cachedArchives = new Map(); const getOrCreateArchive = archivePath => { const isCached = cachedArchives.has(archivePath); if (isCached) { return cachedArchives.get(archivePath); } const newArchive = asar.createArchive(archivePath); if (!newArchive) return null; cachedArchives.set(archivePath, newArchive); return newArchive; }; // Separate asar package's path from full path. const splitPath = archivePathOrBuffer => { // Shortcut for disabled asar. if (isAsarDisabled()) return { isAsar: false }; // Check for a bad argument type. let archivePath = archivePathOrBuffer; if (Buffer.isBuffer(archivePathOrBuffer)) { archivePath = archivePathOrBuffer.toString(); } if (typeof archivePath !== 'string') return { isAsar: false }; return asar.splitPath(path.normalize(archivePath)); }; // Convert asar archive's Stats object to fs's Stats object. let nextInode = 0; const uid = process.getuid != null ? process.getuid() : 0; const gid = process.getgid != null ? process.getgid() : 0; const fakeTime = new Date(); const msec = (date) => (date || fakeTime).getTime(); const asarStatsToFsStats = function (stats) { const { Stats, constants } = require('fs'); let mode = constants.S_IROTH ^ constants.S_IRGRP ^ constants.S_IRUSR ^ constants.S_IWUSR; if (stats.isFile) { mode ^= constants.S_IFREG; } else if (stats.isDirectory) { mode ^= constants.S_IFDIR; } else if (stats.isLink) { mode ^= constants.S_IFLNK; } return new Stats( 1, // dev mode, // mode 1, // nlink uid, gid, 0, // rdev undefined, // blksize ++nextInode, // ino stats.size, undefined, // blocks, msec(stats.atime), // atim_msec msec(stats.mtime), // mtim_msec msec(stats.ctime), // ctim_msec msec(stats.birthtime) // birthtim_msec ); }; const AsarError = { NOT_FOUND: 'NOT_FOUND', NOT_DIR: 'NOT_DIR', NO_ACCESS: 'NO_ACCESS', INVALID_ARCHIVE: 'INVALID_ARCHIVE' }; const createError = (errorType, { asarPath, filePath } = {}) => { let error; switch (errorType) { case AsarError.NOT_FOUND: error = new Error(`ENOENT, ${filePath} not found in ${asarPath}`); error.code = 'ENOENT'; error.errno = -2; break; case AsarError.NOT_DIR: error = new Error('ENOTDIR, not a directory'); error.code = 'ENOTDIR'; error.errno = -20; break; case AsarError.NO_ACCESS: error = new Error(`EACCES: permission denied, access '${filePath}'`); error.code = 'EACCES'; error.errno = -13; break; case AsarError.INVALID_ARCHIVE: error = new Error(`Invalid package ${asarPath}`); break; default: throw new Error(`Invalid error type "${errorType}" passed to createError.`); } return error; }; const overrideAPISync = function (module, name, pathArgumentIndex, fromAsync) { if (pathArgumentIndex == null) pathArgumentIndex = 0; const old = module[name]; const func = function () { const pathArgument = arguments[pathArgumentIndex]; const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return old.apply(this, arguments); const archive = getOrCreateArchive(asarPath); if (!archive) throw createError(AsarError.INVALID_ARCHIVE, { asarPath }); const newPath = archive.copyFileOut(filePath); if (!newPath) throw createError(AsarError.NOT_FOUND, { asarPath, filePath }); arguments[pathArgumentIndex] = newPath; return old.apply(this, arguments); }; if (fromAsync) { return func; } module[name] = func; }; const overrideAPI = function (module, name, pathArgumentIndex) { if (pathArgumentIndex == null) pathArgumentIndex = 0; const old = module[name]; module[name] = function () { const pathArgument = arguments[pathArgumentIndex]; const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return old.apply(this, arguments); const callback = arguments[arguments.length - 1]; if (typeof callback !== 'function') { return overrideAPISync(module, name, pathArgumentIndex, true).apply(this, arguments); } const archive = getOrCreateArchive(asarPath); if (!archive) { const error = createError(AsarError.INVALID_ARCHIVE, { asarPath }); nextTick(callback, [error]); return; } const newPath = archive.copyFileOut(filePath); if (!newPath) { const error = createError(AsarError.NOT_FOUND, { asarPath, filePath }); nextTick(callback, [error]); return; } arguments[pathArgumentIndex] = newPath; return old.apply(this, arguments); }; if (old[util.promisify.custom]) { module[name][util.promisify.custom] = makePromiseFunction(old[util.promisify.custom], pathArgumentIndex); } if (module.promises && module.promises[name]) { module.promises[name] = makePromiseFunction(module.promises[name], pathArgumentIndex); } }; const makePromiseFunction = function (orig, pathArgumentIndex) { return function (...args) { const pathArgument = args[pathArgumentIndex]; const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return orig.apply(this, args); const archive = getOrCreateArchive(asarPath); if (!archive) { return Promise.reject(createError(AsarError.INVALID_ARCHIVE, { asarPath })); } const newPath = archive.copyFileOut(filePath); if (!newPath) { return Promise.reject(createError(AsarError.NOT_FOUND, { asarPath, filePath })); } args[pathArgumentIndex] = newPath; return orig.apply(this, args); }; }; // Override fs APIs. exports.wrapFsWithAsar = fs => { const logFDs = {}; const logASARAccess = (asarPath, filePath, offset) => { if (!process.env.ELECTRON_LOG_ASAR_READS) return; if (!logFDs[asarPath]) { const path = require('path'); const logFilename = `${path.basename(asarPath, '.asar')}-access-log.txt`; const logPath = path.join(require('os').tmpdir(), logFilename); logFDs[asarPath] = fs.openSync(logPath, 'a'); } fs.writeSync(logFDs[asarPath], `${offset}: ${filePath}\n`); }; const { lstatSync } = fs; fs.lstatSync = (pathArgument, options) => { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return lstatSync(pathArgument, options); const archive = getOrCreateArchive(asarPath); if (!archive) throw createError(AsarError.INVALID_ARCHIVE, { asarPath }); const stats = archive.stat(filePath); if (!stats) throw createError(AsarError.NOT_FOUND, { asarPath, filePath }); return asarStatsToFsStats(stats); }; const { lstat } = fs; fs.lstat = function (pathArgument, options, callback) { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (typeof options === 'function') { callback = options; options = {}; } if (!isAsar) return lstat(pathArgument, options, callback); const archive = getOrCreateArchive(asarPath); if (!archive) { const error = createError(AsarError.INVALID_ARCHIVE, { asarPath }); nextTick(callback, [error]); return; } const stats = archive.stat(filePath); if (!stats) { const error = createError(AsarError.NOT_FOUND, { asarPath, filePath }); nextTick(callback, [error]); return; } const fsStats = asarStatsToFsStats(stats); nextTick(callback, [null, fsStats]); }; fs.promises.lstat = util.promisify(fs.lstat); const { statSync } = fs; fs.statSync = (pathArgument, options) => { const { isAsar } = splitPath(pathArgument); if (!isAsar) return statSync(pathArgument, options); // Do not distinguish links for now. return fs.lstatSync(pathArgument, options); }; const { stat } = fs; fs.stat = (pathArgument, options, callback) => { const { isAsar } = splitPath(pathArgument); if (typeof options === 'function') { callback = options; options = {}; } if (!isAsar) return stat(pathArgument, options, callback); // Do not distinguish links for now. process.nextTick(() => fs.lstat(pathArgument, options, callback)); }; fs.promises.stat = util.promisify(fs.stat); const wrapRealpathSync = function (realpathSync) { return function (pathArgument, options) { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return realpathSync.apply(this, arguments); const archive = getOrCreateArchive(asarPath); if (!archive) { throw createError(AsarError.INVALID_ARCHIVE, { asarPath }); } const fileRealPath = archive.realpath(filePath); if (fileRealPath === false) { throw createError(AsarError.NOT_FOUND, { asarPath, filePath }); } return path.join(realpathSync(asarPath, options), fileRealPath); }; }; const { realpathSync } = fs; fs.realpathSync = wrapRealpathSync(realpathSync); fs.realpathSync.native = wrapRealpathSync(realpathSync.native); const wrapRealpath = function (realpath) { return function (pathArgument, options, callback) { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return realpath.apply(this, arguments); if (arguments.length < 3) { callback = options; options = {}; } const archive = getOrCreateArchive(asarPath); if (!archive) { const error = createError(AsarError.INVALID_ARCHIVE, { asarPath }); nextTick(callback, [error]); return; } const fileRealPath = archive.realpath(filePath); if (fileRealPath === false) { const error = createError(AsarError.NOT_FOUND, { asarPath, filePath }); nextTick(callback, [error]); return; } realpath(asarPath, options, (error, archiveRealPath) => { if (error === null) { const fullPath = path.join(archiveRealPath, fileRealPath); callback(null, fullPath); } else { callback(error); } }); }; }; const { realpath } = fs; fs.realpath = wrapRealpath(realpath); fs.realpath.native = wrapRealpath(realpath.native); fs.promises.realpath = util.promisify(fs.realpath.native); const { exists } = fs; fs.exists = (pathArgument, callback) => { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return exists(pathArgument, callback); const archive = getOrCreateArchive(asarPath); if (!archive) { const error = createError(AsarError.INVALID_ARCHIVE, { asarPath }); nextTick(callback, [error]); return; } const pathExists = (archive.stat(filePath) !== false); nextTick(callback, [pathExists]); }; fs.exists[util.promisify.custom] = pathArgument => { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return exists[util.promisify.custom](pathArgument); const archive = getOrCreateArchive(asarPath); if (!archive) { const error = createError(AsarError.INVALID_ARCHIVE, { asarPath }); return Promise.reject(error); } return Promise.resolve(archive.stat(filePath) !== false); }; const { existsSync } = fs; fs.existsSync = pathArgument => { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return existsSync(pathArgument); const archive = getOrCreateArchive(asarPath); if (!archive) return false; return archive.stat(filePath) !== false; }; const { access } = fs; fs.access = function (pathArgument, mode, callback) { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return access.apply(this, arguments); if (typeof mode === 'function') { callback = mode; mode = fs.constants.F_OK; } const archive = getOrCreateArchive(asarPath); if (!archive) { const error = createError(AsarError.INVALID_ARCHIVE, { asarPath }); nextTick(callback, [error]); return; } const info = archive.getFileInfo(filePath); if (!info) { const error = createError(AsarError.NOT_FOUND, { asarPath, filePath }); nextTick(callback, [error]); return; } if (info.unpacked) { const realPath = archive.copyFileOut(filePath); return fs.access(realPath, mode, callback); } const stats = archive.stat(filePath); if (!stats) { const error = createError(AsarError.NOT_FOUND, { asarPath, filePath }); nextTick(callback, [error]); return; } if (mode & fs.constants.W_OK) { const error = createError(AsarError.NO_ACCESS, { asarPath, filePath }); nextTick(callback, [error]); return; } nextTick(callback); }; fs.promises.access = util.promisify(fs.access); const { accessSync } = fs; fs.accessSync = function (pathArgument, mode) { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return accessSync.apply(this, arguments); if (mode == null) mode = fs.constants.F_OK; const archive = getOrCreateArchive(asarPath); if (!archive) { throw createError(AsarError.INVALID_ARCHIVE, { asarPath }); } const info = archive.getFileInfo(filePath); if (!info) { throw createError(AsarError.NOT_FOUND, { asarPath, filePath }); } if (info.unpacked) { const realPath = archive.copyFileOut(filePath); return fs.accessSync(realPath, mode); } const stats = archive.stat(filePath); if (!stats) { throw createError(AsarError.NOT_FOUND, { asarPath, filePath }); } if (mode & fs.constants.W_OK) { throw createError(AsarError.NO_ACCESS, { asarPath, filePath }); } }; const { readFile } = fs; fs.readFile = function (pathArgument, options, callback) { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return readFile.apply(this, arguments); if (typeof options === 'function') { callback = options; options = { encoding: null }; } else if (typeof options === 'string') { options = { encoding: options }; } else if (options === null || options === undefined) { options = { encoding: null }; } else if (typeof options !== 'object') { throw new TypeError('Bad arguments'); } const { encoding } = options; const archive = getOrCreateArchive(asarPath); if (!archive) { const error = createError(AsarError.INVALID_ARCHIVE, { asarPath }); nextTick(callback, [error]); return; } const info = archive.getFileInfo(filePath); if (!info) { const error = createError(AsarError.NOT_FOUND, { asarPath, filePath }); nextTick(callback, [error]); return; } if (info.size === 0) { nextTick(callback, [null, encoding ? '' : Buffer.alloc(0)]); return; } if (info.unpacked) { const realPath = archive.copyFileOut(filePath); return fs.readFile(realPath, options, callback); } const buffer = Buffer.alloc(info.size); const fd = archive.getFd(); if (!(fd >= 0)) { const error = createError(AsarError.NOT_FOUND, { asarPath, filePath }); nextTick(callback, [error]); return; } logASARAccess(asarPath, filePath, info.offset); fs.read(fd, buffer, 0, info.size, info.offset, error => { callback(error, encoding ? buffer.toString(encoding) : buffer); }); }; fs.promises.readFile = util.promisify(fs.readFile); const { readFileSync } = fs; fs.readFileSync = function (pathArgument, options) { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return readFileSync.apply(this, arguments); const archive = getOrCreateArchive(asarPath); if (!archive) throw createError(AsarError.INVALID_ARCHIVE, { asarPath }); const info = archive.getFileInfo(filePath); if (!info) throw createError(AsarError.NOT_FOUND, { asarPath, filePath }); if (info.size === 0) return (options) ? '' : Buffer.alloc(0); if (info.unpacked) { const realPath = archive.copyFileOut(filePath); return fs.readFileSync(realPath, options); } if (!options) { options = { encoding: null }; } else if (typeof options === 'string') { options = { encoding: options }; } else if (typeof options !== 'object') { throw new TypeError('Bad arguments'); } const { encoding } = options; const buffer = Buffer.alloc(info.size); const fd = archive.getFd(); if (!(fd >= 0)) throw createError(AsarError.NOT_FOUND, { asarPath, filePath }); logASARAccess(asarPath, filePath, info.offset); fs.readSync(fd, buffer, 0, info.size, info.offset); return (encoding) ? buffer.toString(encoding) : buffer; }; const { readdir } = fs; fs.readdir = function (pathArgument, options = {}, callback) { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (typeof options === 'function') { callback = options; options = {}; } if (!isAsar) return readdir.apply(this, arguments); const archive = getOrCreateArchive(asarPath); if (!archive) { const error = createError(AsarError.INVALID_ARCHIVE, { asarPath }); nextTick(callback, [error]); return; } const files = archive.readdir(filePath); if (!files) { const error = createError(AsarError.NOT_FOUND, { asarPath, filePath }); nextTick(callback, [error]); return; } if (options.withFileTypes) { const dirents = []; for (const file of files) { const stats = archive.stat(file); if (stats.isFile) { dirents.push(new fs.Dirent(file, fs.constants.UV_DIRENT_FILE)); } else if (stats.isDirectory) { dirents.push(new fs.Dirent(file, fs.constants.UV_DIRENT_DIR)); } else if (stats.isLink) { dirents.push(new fs.Dirent(file, fs.constants.UV_DIRENT_LINK)); } } nextTick(callback, [null, dirents]); return; } nextTick(callback, [null, files]); }; fs.promises.readdir = util.promisify(fs.readdir); const { readdirSync } = fs; fs.readdirSync = function (pathArgument, options = {}) { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return readdirSync.apply(this, arguments); const archive = getOrCreateArchive(asarPath); if (!archive) { throw createError(AsarError.INVALID_ARCHIVE, { asarPath }); } const files = archive.readdir(filePath); if (!files) { throw createError(AsarError.NOT_FOUND, { asarPath, filePath }); } if (options.withFileTypes) { const dirents = []; for (const file of files) { const stats = archive.stat(file); if (stats.isFile) { dirents.push(new fs.Dirent(file, fs.constants.UV_DIRENT_FILE)); } else if (stats.isDirectory) { dirents.push(new fs.Dirent(file, fs.constants.UV_DIRENT_DIR)); } else if (stats.isLink) { dirents.push(new fs.Dirent(file, fs.constants.UV_DIRENT_LINK)); } } return dirents; } return files; }; const { internalModuleReadJSON } = internalBinding('fs'); internalBinding('fs').internalModuleReadJSON = pathArgument => { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return internalModuleReadJSON(pathArgument); const archive = getOrCreateArchive(asarPath); if (!archive) return; const info = archive.getFileInfo(filePath); if (!info) return; if (info.size === 0) return ''; if (info.unpacked) { const realPath = archive.copyFileOut(filePath); return fs.readFileSync(realPath, { encoding: 'utf8' }); } const buffer = Buffer.alloc(info.size); const fd = archive.getFd(); if (!(fd >= 0)) return; logASARAccess(asarPath, filePath, info.offset); fs.readSync(fd, buffer, 0, info.size, info.offset); return buffer.toString('utf8'); }; const { internalModuleStat } = internalBinding('fs'); internalBinding('fs').internalModuleStat = pathArgument => { const { isAsar, asarPath, filePath } = splitPath(pathArgument); if (!isAsar) return internalModuleStat(pathArgument); // -ENOENT const archive = getOrCreateArchive(asarPath); if (!archive) return -34; // -ENOENT const stats = archive.stat(filePath); if (!stats) return -34; return (stats.isDirectory) ? 1 : 0; }; // Calling mkdir for directory inside asar archive should throw ENOTDIR // error, but on Windows it throws ENOENT. if (process.platform === 'win32') { const { mkdir } = fs; fs.mkdir = (pathArgument, options, callback) => { if (typeof options === 'function') { callback = options; options = {}; } const { isAsar, filePath } = splitPath(pathArgument); if (isAsar && filePath.length > 0) { const error = createError(AsarError.NOT_DIR); nextTick(callback, [error]); return; } mkdir(pathArgument, options, callback); }; fs.promises.mkdir = util.promisify(fs.mkdir); const { mkdirSync } = fs; fs.mkdirSync = function (pathArgument, options) { const { isAsar, filePath } = splitPath(pathArgument); if (isAsar && filePath.length) throw createError(AsarError.NOT_DIR); return mkdirSync(pathArgument, options); }; } function invokeWithNoAsar (func) { return function () { const processNoAsarOriginalValue = process.noAsar; process.noAsar = true; try { return func.apply(this, arguments); } finally { process.noAsar = processNoAsarOriginalValue; } }; } // Strictly implementing the flags of fs.copyFile is hard, just do a simple // implementation for now. Doing 2 copies won't spend much time more as OS // has filesystem caching. overrideAPI(fs, 'copyFile'); overrideAPISync(fs, 'copyFileSync'); overrideAPI(fs, 'open'); overrideAPISync(process, 'dlopen', 1); overrideAPISync(Module._extensions, '.node', 1); overrideAPISync(fs, 'openSync'); const overrideChildProcess = (childProcess) => { // Executing a command string containing a path to an asar archive // confuses `childProcess.execFile`, which is internally called by // `childProcess.{exec,execSync}`, causing Electron to consider the full // command as a single path to an archive. const { exec, execSync } = childProcess; childProcess.exec = invokeWithNoAsar(exec); childProcess.exec[util.promisify.custom] = invokeWithNoAsar(exec[util.promisify.custom]); childProcess.execSync = invokeWithNoAsar(execSync); overrideAPI(childProcess, 'execFile'); overrideAPISync(childProcess, 'execFileSync'); }; // Lazily override the child_process APIs only when child_process is // fetched the first time. We will eagerly override the child_process APIs // when this env var is set so that stack traces generated inside node unit // tests will match. This env var will only slow things down in users apps // and should not be used. if (process.env.ELECTRON_EAGER_ASAR_HOOK_FOR_TESTING) { overrideChildProcess(require('child_process')); } else { const originalModuleLoad = Module._load; Module._load = (request, ...args) => { const loadResult = originalModuleLoad(request, ...args); if (request === 'child_process') { if (!v8Util.getHiddenValue(loadResult, 'asar-ready')) { v8Util.setHiddenValue(loadResult, 'asar-ready', true); // Just to make it obvious what we are dealing with here const childProcess = loadResult; overrideChildProcess(childProcess); } } return loadResult; }; } }; })();