js-dos 8.1.5 → 8.1.7

package/src/sockdrive/js/src/fatfs/dir.js

@@ -1,385 +0,0 @@
-const S = require("./structs.js");
-const _ = require("./helpers.js");
-
-const dir = exports;
-
-dir.iterator = function(dirChain, opts) {
-    opts || (opts = {});
-
-    const cache = { buffer: null, n: null };
-    function getSectorBuffer(n, cb) {
-        if (cache.n === n) cb(null, cache.buffer);
-        else {
-            cache.n = cache.buffer = null, dirChain.readSectors(n, _.allocBuffer(dirChain.sectorSize), function(e, d) {
-                if (e) cb(e);
-                else if (!d) return cb(null, null);
-                else {
-                    cache.n = n;
-                    cache.buffer = d;
-                    getSectorBuffer(n, cb);
-                }
-            });
-        }
-    }
-
-    let secIdx = 0;
-    const off = { bytes: 0 };
-    let long = null;
-    function getNextEntry(cb) {
-        if (off.bytes >= dirChain.sectorSize) {
-            secIdx += 1;
-            off.bytes -= dirChain.sectorSize;
-        }
-        const entryPos = { chain: dirChain, sector: secIdx, offset: off.bytes };
-        getSectorBuffer(secIdx, function(e, buf) {
-            if (e) return cb(S.err.IO());
-            else if (!buf) return cb(null, null, entryPos);
-
-            const entryIdx = off.bytes;
-            const signalByte = buf[entryIdx];
-            if (signalByte === S.entryDoneFlag) return cb(null, null, entryPos);
-            else if (signalByte === S.entryFreeFlag) {
-                off.bytes += S.dirEntry.size;
-                long = null;
-                if (opts.includeFree) return cb(null, { _free: true, _pos: entryPos }, entryPos);
-                else return getNextEntry(cb); // usually just skip these
-            }
-
-            const attrByte = buf[entryIdx+S.dirEntry.fields.Attr.offset];
-            const entryType = (attrByte === S.longDirFlag) ? S.longDirEntry : S.dirEntry_simple;
-            const entry = entryType.valueFromBytes(buf, off);
-            entry._pos = entryPos;
-            _.log(_.log.DBG, "entry:", entry, secIdx, entryIdx);
-            if (entryType === S.longDirEntry) {
-                let firstEntry;
-                if (entry.Ord & S.lastLongFlag) {
-                    firstEntry = true;
-                    entry.Ord &= ~S.lastLongFlag;
-                    long = {
-                        name: -1,
-                        sum: entry.Chksum,
-                        _rem: entry.Ord-1,
-                        _arr: [],
-                    };
-                }
-                if (firstEntry || long && entry.Chksum === long.sum && entry.Ord === long._rem--) {
-                    const S_lde_f = S.longDirEntry.fields;
-                    let namepart = entry.Name1;
-                    if (entry.Name1.length === S_lde_f.Name1.size/2) {
-                        namepart += entry.Name2;
-                        if (entry.Name2.length === S_lde_f.Name2.size/2) {
-                            namepart += entry.Name3;
-                        }
-                    }
-                    long._arr.push(namepart);
-                    if (!long._rem) {
-                        long.name = long._arr.reverse().join("");
-                        delete long._arr;
-                        delete long._rem;
-                    }
-                } else long = null;
-            } else if ((attrByte & 0x08) === 0) { // NOTE: checks `!entry.Attr.volume_id`
-                let bestName = null;
-                if (long && long.name) {
-                    const pos = entryIdx + S.dirEntry.fields["Name"].offset;
-                    const sum = _.checksumName(buf, pos);
-                    if (sum === long.sum) bestName = long.name;
-                }
-                if (!bestName) {
-                    if (signalByte === S.entryIsE5Flag) entry.Name.filename = "\u00E5"+entry.Name.filename.slice(1);
-
-                    const nam = entry.Name.filename.replace(/ +$/, "");
-                    const ext = entry.Name.extension.replace(/ +$/, "");
-                    // TODO: lowercase bits http://en.wikipedia.org/wiki/8.3_filename#Compatibility
-                    //       via NTRes, bits 0x08 and 0x10 http://www.fdos.org/kernel/fatplus.txt.1
-                    bestName = (ext) ? nam+"."+ext : nam;
-                }
-                entry._name = bestName;
-
-                // OPTIMIZATION: avoid processing any fields for non-matching entries
-                // TODO: we could make this automatic via getters, but…?
-                const _entryBuffer = buf.slice(off.bytes-S.dirEntry.size, off.bytes);
-                entry._full = function() {
-                    const _entry = S.dirEntry.valueFromBytes(_entryBuffer);
-                    _.extend(entry, _entry);
-                    entry._size = entry.FileSize;
-                    entry._firstCluster = (entry.FstClusHI << 16) + entry.FstClusLO;
-                    return entry;
-                };
-
-                long = null;
-                return cb(null, entry, entryPos);
-            } else long = null;
-            getNextEntry(cb);
-        });
-    }
-
-    function iter(cb) {
-        getNextEntry(cb);
-        return iter; // TODO: previous value can't be re-used, so why make caller re-assign?
-    }
-    return iter;
-};
-
-function _updateEntry(vol, entry, newStats) {
-    if ("size" in newStats) entry._size = entry.FileSize = newStats.size;
-
-    if ("_touch" in newStats) newStats.archive = newStats.atime = newStats.mtime = true;
-    if ("archive" in newStats) entry.Attr.archive = true; // TODO: also via newStats.mode?
-
-    let _now;
-    function applyDate(d, prefix, timeToo, tenthToo) {
-        if (d === true) d = _now || (_now = new Date());
-        entry[prefix+"Date"] = { year: d.getFullYear()-1980, month: d.getMonth()+1, day: d.getDate() };
-        if (timeToo) {
-            entry[prefix+"Time"] = { hours: d.getHours(), minutes: d.getMinutes(), seconds_2: d.getSeconds()>>>1 };
-            if (tenthToo) {
-                const msec = (d.getSeconds() % 2)*1000 + d.getMilliseconds();
-                entry[prefix+"TimeTenth"] = Math.floor(msec / 100);
-            }
-        }
-    }
-    if ("ctime" in newStats) applyDate(newStats.ctime, "Crt", true, true);
-    if ("mtime" in newStats) applyDate(newStats.mtime, "Wrt", true);
-    if ("atime" in newStats) applyDate(newStats.atime, "LstAcc");
-
-    if ("mode" in newStats) {
-        entry.Attr.directory = (newStats.mode & S._I.FDIR) ? true : false;
-        entry.Attr.volume_id = (newStats.mode & S._I.FREG) ? false : true;
-        if (vol.opts.modmode === 0o111) {
-            entry.Attr.archive = (newStats.mode & S._I.XUSR) ? true : false;
-            entry.Attr.system = (newStats.mode & S._I.XGRP) ? true : false;
-            entry.Attr.hidden = (newStats.mode & S._I.XOTH) ? true : false;
-            entry.Attr.readonly = (newStats.mode & S._I.WUSR) ? false : true;
-        } else if (vol.opts.modmode === 0o7000) {
-            entry.Attr.archive = (newStats.mode & S._I.SVTX) ? true : false;
-            entry.Attr.system = (newStats.mode & S._I.SGID) ? true : false;
-            entry.Attr.hidden = (newStats.mode & S._I.SUID) ? true : false;
-            entry.Attr.readonly = (
-                newStats.mode & S._I.WUSR ||
-                newStats.mode & S._I.WGRP ||
-                newStats.mode & S._I.WOTH
-            ) ? false : true;
-        }
-    }
-
-    if ("firstCluster" in newStats) {
-        entry.FstClusLO = newStats.firstCluster & 0xFFFF;
-        entry.FstClusHI = newStats.firstCluster >>> 16;
-        entry._firstCluster = newStats.firstCluster;
-    }
-    return entry;
-}
-
-dir.makeStat = function(vol, entry) {
-    const stats = {}; // TODO: return an actual `instanceof fs.Stat` somehow?
-
-    stats.isFile = function() {
-        return (!entry.Attr.volume_id && !entry.Attr.directory);
-    };
-    stats.isDirectory = function() {
-        return entry.Attr.directory;
-    };
-    stats.isBlockDevice = function() {
-        return false;
-    };
-    stats.isCharacterDevice = function() {
-        return false;
-    };
-    stats.isSymbolicLink = function() {
-        return false;
-    };
-    stats.isFIFO = function() {
-        return false;
-    };
-    stats.isSocket = function() {
-        return false;
-    };
-    stats.size = entry.FileSize;
-    stats.blksize = vol._sectorsPerCluster*vol._sectorSize;
-    stats.blocks = Math.ceil(stats.size / stats.blksize) || 1;
-    stats.nlink = 1;
-
-    stats.mode = S._I.RUSR | S._I.RGRP | S._I.ROTH;
-    if (!entry.Attr.readonly) stats.mode |= S._I.WUSR | S._I.WGRP | S._I.WOTH;
-    if (entry.Attr.directory) stats.mode |= S._I.FDIR;
-    else if (!entry.Attr.volume_id) stats.mode |= S._I.FREG;
-    // NOTE: discussion at https://github.com/natevw/fatfs/issues/7
-    if (vol.opts.modmode === 0o111) {
-        // expose using executable bits, like Samba
-        if (entry.Attr.archive) stats.mode |= S._I.XUSR;
-        if (entry.Attr.system) stats.mode |= S._I.XGRP;
-        if (entry.Attr.hidden) stats.mode |= S._I.XOTH;
-    } else if (vol.opts.modmode === 0o7000) {
-        // expose using setXid/sticky bits, like MKS
-        if (entry.Attr.archive) stats.mode |= S._I.SVTX;
-        if (entry.Attr.system) stats.mode |= S._I.SGID;
-        if (entry.Attr.hidden) stats.mode |= S._I.SUID;
-    }
-
-    stats.mode &= ~vol.opts.umask;
-    stats.uid = vol.opts.uid;
-    stats.gid = vol.opts.gid;
-
-    function extractDate(prefix) {
-        const date = entry[prefix+"Date"];
-        const time = entry[prefix+"Time"] || { hours: 0, minutes: 0, seconds_2: 0 };
-        let secs = time.seconds_2 * 2;
-        let sect = entry[prefix+"TimeTenth"] || 0;
-        if (sect > 100) {
-            secs += 1;
-            sect -= 100;
-        }
-        return new Date(date.year+1980, date.month-1, date.day, time.hours, time.minutes, secs, sect*100);
-    }
-    stats.atime = extractDate("LstAcc");
-    stats.mtime = extractDate("Wrt");
-    stats.ctime = extractDate("Crt");
-
-    entry = { // keep immutable copy (with only the fields we need)
-        Attr: _.extend({}, entry.Attr),
-    };
-
-    return stats;
-};
-
-dir.init = function(vol, dirInfo, cb) {
-    const dirChain = dirInfo.chain;
-    const isRootDir = ("numSectors" in dirChain); // HACK: all others would be a clusterChain
-    const initialCluster = _.allocBuffer(dirChain.sectorSize*vol._sectorsPerCluster);
-    const entriesOffset = { bytes: 0 };
-    initialCluster.fill(0);
-    function writeEntry(name, clusterNum) {
-        while (name.length < 8) name += " ";
-        S.dirEntry.bytesFromValue(_updateEntry(vol, {
-            Name: { filename: name, extension: "   " },
-            Attr: { directory: true },
-        }, { firstCluster: clusterNum, _touch: true, ctime: true }), initialCluster, entriesOffset);
-    }
-    if (!isRootDir) {
-        writeEntry(".", dirChain.firstCluster);
-        writeEntry("..", dirInfo.parent.chain.firstCluster);
-    };
-    dirChain.writeToPosition(0, initialCluster, cb);
-};
-
-dir.addFile = function(vol, dirChain, entryInfo, opts, cb) {
-    if (typeof opts === "function") {
-        cb = opts;
-        opts = {};
-    }
-    var name = entryInfo.name;
-    const entries = []; let mainEntry;
-    entries.push(mainEntry = {
-        Name: _.shortname(name),
-        Attr: { directory: opts.dir||false },
-        _name: name,
-    });
-    if (1 || mainEntry.Name._lossy) { // HACK: always write long names until `._lossy` is more useful!
-        const workaroundTessel427 = ("\uFFFF".length !== 1);
-        if (workaroundTessel427) throw Error("Your JS runtime does not have proper Unicode string support. (If Tessel, is your firmware up-to-date?)");
-
-        // name entries should be 0x0000-terminated and 0xFFFF-filled
-        const S_lde_f = S.longDirEntry.fields;
-        const ENTRY_CHUNK_LEN = (S_lde_f.Name1.size + S_lde_f.Name2.size + S_lde_f.Name3.size)/2;
-        const partialLen = name.length % ENTRY_CHUNK_LEN;
-        let paddingNeeded = partialLen && (ENTRY_CHUNK_LEN - partialLen);
-        if (paddingNeeded--) name += "\u0000";
-        while (paddingNeeded-- > 0) name += "\uFFFF";
-        // now fill in as many entries as it takes
-        let off = 0;
-        let ord = 1;
-        while (off < name.length) {
-            entries.push({
-                Ord: ord++,
-                Name1: name.slice(off, off+=S_lde_f.Name1.size/2),
-                Attr_raw: S.longDirFlag,
-                Chksum: null,
-                Name2: name.slice(off, off+=S_lde_f.Name2.size/2),
-                Name3: name.slice(off, off+=S_lde_f.Name3.size/2),
-            });
-        }
-        entries[entries.length - 1].Ord |= S.lastLongFlag;
-    }
-
-    if (entryInfo.tail) {
-        var name = mainEntry.Name.filename;
-        const suffix = "~"+entryInfo.tail;
-        const endIdx = name.indexOf(" ");
-        const sufIdx = (~endIdx) ? Math.min(endIdx, name.length-suffix.length) : name.length-suffix.length;
-        if (sufIdx < 0) return cb(S.err.NAMETOOLONG()); // TODO: would EXIST be more correct?
-        mainEntry.Name.filename = name.slice(0, sufIdx)+suffix+name.slice(sufIdx+suffix.length);
-        _.log(_.log.DBG, "Shortname amended to:", mainEntry.Name);
-    }
-
-    vol.allocateInFAT(dirChain.firstCluster || 2, function(e, fileCluster) {
-        if (e) return cb(e);
-
-        const nameBuf = S.dirEntry.fields["Name"].bytesFromValue(mainEntry.Name);
-        const nameSum = _.checksumName(nameBuf);
-        // TODO: finalize initial properties… (via `opts.mode` instead?)
-        _updateEntry(vol, mainEntry, { firstCluster: fileCluster, size: 0, ctime: true, _touch: true });
-        mainEntry._pos = _.adjustedPos(vol, entryInfo.target, S.dirEntry.size*(entries.length-1));
-        entries.slice(1).forEach(function(entry) {
-            entry.Chksum = nameSum;
-        });
-        entries.reverse();
-        if (entryInfo.lastEntry) entries.push({});
-
-        const entriesData = _.allocBuffer(S.dirEntry.size*entries.length);
-        const dataOffset = { bytes: 0 };
-        entries.forEach(function(entry) {
-            const entryType = ("Ord" in entry) ? S.longDirEntry : S.dirEntry;
-            entryType.bytesFromValue(entry, entriesData, dataOffset);
-        });
-
-        _.log(_.log.DBG, "Writing", entriesData.length, "byte directory entry", mainEntry, "into", dirChain.toJSON(), "at", entryInfo.target);
-        dirChain.writeToPosition(entryInfo.target, entriesData, function(e) {
-            // TODO: if we get error, what/should we clean up?
-            if (e) cb(e);
-            else cb(null, mainEntry, vol.chainForCluster(fileCluster, dirChain));
-        });
-    });
-};
-
-dir.findInDirectory = function(vol, dirChain, name, opts, cb) {
-    const matchName = name.toUpperCase();
-    const tailName = (opts.prepareForCreate) ? _.shortname(name) : null;
-    let maxTail = 0;
-
-    function processNext(next) {
-        next = next(function(e, d, entryPos) {
-            if (e) cb(e);
-            else if (!d) cb(S.err.NOENT(), { tail: maxTail, target: entryPos, lastEntry: true });
-            else if (d._free) processNext(next); // TODO: look for long enough reusable run
-            else if (d._name.toUpperCase() === matchName) return cb(null, d._full());
-            else if (!opts.prepareForCreate) processNext(next);
-            else {
-                let dNum = 1;
-                let dName = d.Name.filename;
-                const dTail = dName.match(/(.*)~(\d+)/);
-                if (dTail) {
-                    dNum = +dTail[2];
-                    dName = dTail[1];
-                }
-                if (tailName.extension === d.Name.extension &&
-                    tailName.filename.indexOf(dName) === 0) {
-                    maxTail = Math.max(dNum+1, maxTail);
-                }
-                processNext(next);
-            }
-        });
-    }
-    processNext(dir.iterator(dirChain, { includeFree: (0 && opts.prepareForCreate) }));
-};
-
-dir.updateEntry = function(vol, entry, newStats, cb) {
-    if (!entry._pos || !entry._pos.chain) throw Error("Entry source unknown!");
-
-    const entryPos = entry._pos;
-    const newEntry = _updateEntry(vol, entry, newStats);
-    const data = S.dirEntry.bytesFromValue(newEntry);
-    _.log(_.log.DBG, "UPDATING ENTRY", newStats, newEntry, entryPos, data);
-    // TODO: if write fails, then entry becomes corrupt!
-    entryPos.chain.writeToPosition(entryPos, data, cb);
-};

package/src/sockdrive/js/src/fatfs/helpers.js

@@ -1,210 +0,0 @@
-const S = require("./structs.js");
-const _xok = require("xok");
-
-// ponyfills for older node.js
-exports.allocBuffer = Buffer.alloc || function(len, val) {
-    const b = Buffer(len);
-    if (arguments.length > 1) b.fill(val);
-    return b;
-};
-exports.bufferFrom = Buffer.from || function(arg0, arg1) {
-    return (arguments.length > 1) ? Buffer(arg0, arg1) : Buffer(arg0);
-};
-
-// flag for WORKAROUND: https://github.com/tessel/beta/issues/380
-exports.workaroundTessel380 = !Buffer.from && function() {
-    const b = Buffer([0]);
-    const s = b.slice(0);
-    return ((s[0] = 0xFF) !== b[0]);
-}();
-
-
-// WORKAROUND: https://github.com/tessel/beta/issues/433
-let oldslice;
-if (!Buffer.alloc && Buffer(5).slice(10).length < 0) {
-    oldslice = Buffer.prototype.slice, Buffer.prototype.slice = function(s, e) {
-        if (s > this.length) s = this.length;
-        // ~WORKAROUND: https://github.com/tessel/beta/issues/434
-        return (arguments.length > 1) ? oldslice.call(this, s, e) : oldslice.call(this, s);
-    };
-}
-
-exports.absoluteSteps = function(path) {
-    const steps = [];
-    path.split("/").forEach(function(str) {
-        // NOTE: these should actually be fine, just wasteful…
-        if (str === "..") steps.pop();
-        else if (str && str !== ".") steps.push(str);
-    });
-    return steps.map(exports.longname);
-};
-
-exports.absolutePath = function(path) {
-    return "/"+exports.absoluteSteps(path).join("/");
-};
-
-exports.parseFlags = function(flags) {
-    // read, write, append, create, truncate, exclusive
-    let info; let _dir; // NOTE: there might be more clever ways to "parse", but…
-    if (flags[0] === "\\") {
-        // internal flag used internally to `fs.open` directories without `S.err.ISDIR()`
-        flags = flags.slice(1);
-        _dir = true;
-    }
-    switch (flags) {
-        case "r": info = { read: true, write: false, create: false }; break;
-        case "r+": info = { read: true, write: true, create: false }; break;
-        case "rs": info = { read: true, write: false, create: false, sync: true }; break;
-        case "rs+": info = { read: true, write: true, create: false, sync: true }; break;
-        case "w": info = { read: false, write: true, create: true, truncate: true }; break;
-        case "wx": info = { read: false, write: true, create: true, exclusive: true }; break;
-        case "w+": info = { read: true, write: true, create: true, truncate: true }; break;
-        case "wx+": info = { read: true, write: true, create: true, exclusive: true }; break;
-        case "a": info = { read: false, write: true, create: true, append: true }; break;
-        case "ax": info = { read: false, write: true, create: true, append: true, exclusive: true }; break;
-        case "a+": info = { read: true, write: true, create: true, append: true }; break;
-        case "ax+": info = { read: true, write: true, create: true, append: true, exclusive: true }; break;
-        default: throw Error("Uknown mode: "+flags); // TODO: throw as `S.err.INVAL`
-    }
-    if (info.sync) throw Error("Mode not implemented."); // TODO: what would this require of us?
-    if (_dir) info._openDir = true;
-    return info;
-};
-
-
-// TODO: these are great candidates for special test coverage!
-const _snInvalid = /[^A-Z0-9$%'-_@~`!(){}^#&.]/g; // NOTE: '.' is not valid but we split it away
-exports.shortname = function(name) {
-    let lossy = false;
-    // TODO: support preservation of case for otherwise non-lossy name!
-    name = name.toUpperCase().replace(/ /g, "").replace(/^\.+/, "");
-    name = name.replace(_snInvalid, function() {
-        lossy = true;
-        return "_";
-    });
-
-    const parts = name.split(".");
-    let basis3 = parts.pop();
-    let basis8 = parts.join("");
-    if (!parts.length) {
-        basis8 = basis3;
-        basis3 = "   ";
-    }
-    if (basis8.length > 8) {
-        basis8 = basis8.slice(0, 8);
-        // NOTE: technically, spec's "lossy conversion" flag is NOT set by excess length.
-        //       But since lossy conversion and truncated names both need a numeric tail…
-        lossy = true;
-    } else while (basis8.length < 8) basis8 += " ";
-    if (basis3.length > 3) {
-        basis3 = basis3.slice(0, 3);
-        lossy = true;
-    } else while (basis3.length < 3) basis3 += " ";
-
-    return { filename: basis8, extension: basis3, _lossy: lossy };
-    return { basis: [basis8, basis3], lossy: lossy };
-};
-// shortname("autoexec.bat") => {basis:['AUTOEXEC','BAT'],lossy:false}
-// shortname("autoexecutable.batch") => {basis:['AUTOEXEC','BAT'],lossy:true}
-// TODO: OS X stores `shortname("._.Trashes")` as ['~1', 'TRA'] — should we?
-
-const _lnInvalid = /[^a-zA-Z0-9$%'-_@~`!(){}^#&.+,;=[\] ]/g;
-exports.longname = function(name) {
-    name = name.trim().replace(/\.+$/, "").replace(_lnInvalid, function(c) {
-        if (c.length > 1) throw Error("Internal problem: unexpected match length!");
-        if (c.charCodeAt(0) > 127) return c;
-        else throw Error("Invalid character "+JSON.stringify(c)+" in name.");
-        lossy = true;
-        return "_";
-    });
-    if (name.length > 255) throw Error("Name is too long.");
-    return name;
-};
-
-function nameChkSum(sum, c) {
-    return ((sum & 1) ? 0x80 : 0) + (sum >>> 1) + c & 0xFF;
-}
-
-// WORKAROUND: https://github.com/tessel/beta/issues/335
-function reduceBuffer(buf, start, end, fn, res) {
-    // NOTE: does not handle missing `res` like Array.prototype.reduce would
-    for (let i = start; i < end; ++i) {
-        res = fn(res, buf[i]);
-    }
-    return res;
-}
-
-exports.checksumName = function(buf, off) {
-    off || (off = 0);
-    const len = S.dirEntry.fields["Name"].size;
-    return reduceBuffer(buf, off, off+len, nameChkSum, 0);
-};
-
-
-/* comparing C rounding trick from FAT spec with Math.ceil
-function tryBoth(d) {
-    var a = ((D.RootEntCnt * 32) + (D.BytsPerSec - 1)) / D.BytsPerSec >>> 0,
-        b = Math.ceil((D.RootEntCnt * 32) / D.BytsPerSec);
-    if (b !== a) console.log("try", b, a, (b === a) ? '' : '*');
-    return (b === a);
-}
-// BytsPerSec — "may take on only the following values: 512, 1024, 2048 or 4096"
-[512, 1024, 2048, 4096].forEach(function (bps) {
-    // RootEntCnt — "a count that when multiplied by 32 results in an even multiple of BPB_BytsPerSec"
-    for (var evenMultiplier = 0; evenMultiplier < 1024*1024*16; evenMultiplier += 2) {
-        var rec = (bps * evenMultiplier) / 32;
-        tryBoth({RootEntCnt:rec, BytsPerSec:bps});
-    }
-});
-*/
-
-exports.fmtHex = function(n, ff) {
-    return (1+ff+n).toString(16).slice(1);
-};
-
-exports.delayedCall = function(fn) {
-    if (!fn) throw Error("No function provided!"); // debug aid
-    const ctx = this;
-    const args = Array.prototype.slice.call(arguments, 1);
-    // @caiiiycuk: TODO invesitgate, is setImmediate acually needed?
-    // console.warn("setImmediate emulation, please remote it!");
-    // setTimeout(function() {
-        fn.apply(ctx, args);
-    // }, 4);
-};
-
-exports.adjustedPos = function(vol, pos, bytes) {
-    const _pos = {
-        chain: pos.chain,
-        sector: pos.sector,
-        offset: pos.offset + bytes,
-    }; const secSize = vol._sectorSize;
-    while (_pos.offset >= secSize) {
-        _pos.sector += 1;
-        _pos.offset -= secSize;
-    }
-    return _pos;
-};
-
-exports.extend = _xok;
-
-let _prevDbg = Date.now();
-const _thresh = 50;
-
-function log(level) {
-    if (level < log.level) return;
-
-    const now = Date.now();
-    const diff = now - _prevDbg;
-    arguments[0] = ((diff < _thresh) ? " " : "") + diff.toFixed(0) + "ms";
-    console.log.apply(console, arguments);
-    _prevDbg = now;
-}
-log.DBG = -4;
-log.INFO = -3;
-log.WARN = -2;
-log.ERR = -1;
-
-log.level = log.WARN;
-
-exports.log = log;