cspell-io 6.4.2 → 6.5.0

package/dist/CSpellIO.d.ts

@@ -0,0 +1,11 @@
+import { BufferEncoding } from './models/BufferEncoding';
+import type { Stats } from './models';
+export interface CSpellIO {
+    readFile(uriOrFilename: string, encoding?: BufferEncoding): Promise<string>;
+    readFileSync(uriOrFilename: string, encoding?: BufferEncoding): string;
+    writeFile(uriOrFilename: string, content: string): Promise<void>;
+    getStat(uriOrFilename: string): Promise<Stats>;
+    getStatSync(uriOrFilename: string): Stats;
+    compareStats(left: Stats, right: Stats): number;
+}
+//# sourceMappingURL=CSpellIO.d.ts.map

package/dist/CSpellIO.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=CSpellIO.js.map

package/dist/CSpellIONode.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="node" />
+import { ServiceBus } from '@cspell/cspell-service-bus';
+import { CSpellIO } from './CSpellIO';
+import { Stats } from './models/Stats';
+export declare class CSpellIONode implements CSpellIO {
+    readonly serviceBus: ServiceBus;
+    constructor(serviceBus?: ServiceBus);
+    readFile(uriOrFilename: string, encoding?: BufferEncoding): Promise<string>;
+    readFileSync(uriOrFilename: string, encoding?: BufferEncoding): string;
+    writeFile(uriOrFilename: string, content: string): Promise<void>;
+    getStat(uriOrFilename: string): Promise<Stats>;
+    getStatSync(uriOrFilename: string): Stats;
+    compareStats(left: Stats, right: Stats): number;
+}
+//# sourceMappingURL=CSpellIONode.d.ts.map

package/dist/CSpellIONode.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CSpellIONode = void 0;
+const cspell_service_bus_1 = require("@cspell/cspell-service-bus");
+const stat_1 = require("./common/stat");
+const ErrorNotImplemented_1 = require("./errors/ErrorNotImplemented");
+const file_1 = require("./handlers/node/file");
+const util_1 = require("./node/file/util");
+const requests_1 = require("./requests");
+class CSpellIONode {
+    constructor(serviceBus = new cspell_service_bus_1.ServiceBus()) {
+        this.serviceBus = serviceBus;
+        (0, file_1.registerHandlers)(serviceBus);
+    }
+    readFile(uriOrFilename, encoding = 'utf8') {
+        const url = (0, util_1.toURL)(uriOrFilename);
+        const res = this.serviceBus.dispatch(requests_1.RequestFsReadFile.create({ url, encoding }));
+        if (!(0, cspell_service_bus_1.isServiceResponseSuccess)(res)) {
+            throw genError(res.error, 'readFile');
+        }
+        return res.value;
+    }
+    readFileSync(uriOrFilename, encoding = 'utf8') {
+        const url = (0, util_1.toURL)(uriOrFilename);
+        const res = this.serviceBus.dispatch(requests_1.RequestFsReadFileSync.create({ url, encoding }));
+        if (!(0, cspell_service_bus_1.isServiceResponseSuccess)(res)) {
+            throw genError(res.error, 'readFileSync');
+        }
+        return res.value;
+    }
+    writeFile(uriOrFilename, content) {
+        const url = (0, util_1.toURL)(uriOrFilename);
+        const res = this.serviceBus.dispatch(requests_1.RequestFsWriteFile.create({ url, content }));
+        if (!(0, cspell_service_bus_1.isServiceResponseSuccess)(res)) {
+            throw genError(res.error, 'writeFile');
+        }
+        return res.value;
+    }
+    getStat(uriOrFilename) {
+        const url = (0, util_1.toURL)(uriOrFilename);
+        const res = this.serviceBus.dispatch(requests_1.RequestFsStat.create({ url }));
+        if (!(0, cspell_service_bus_1.isServiceResponseSuccess)(res)) {
+            throw genError(res.error, 'getStat');
+        }
+        return res.value;
+    }
+    getStatSync(uriOrFilename) {
+        const url = (0, util_1.toURL)(uriOrFilename);
+        const res = this.serviceBus.dispatch(requests_1.RequestFsStatSync.create({ url }));
+        if (!(0, cspell_service_bus_1.isServiceResponseSuccess)(res)) {
+            throw genError(res.error, 'getStatSync');
+        }
+        return res.value;
+    }
+    compareStats(left, right) {
+        return (0, stat_1.compareStats)(left, right);
+    }
+}
+exports.CSpellIONode = CSpellIONode;
+function genError(err, alt) {
+    return err || new ErrorNotImplemented_1.ErrorNotImplemented(alt);
+}
+//# sourceMappingURL=CSpellIONode.js.map

package/dist/CSpellIOWeb.d.ts

@@ -0,0 +1,11 @@
+import { CSpellIO } from './CSpellIO';
+import { Stats } from './models/Stats';
+export declare class CSpellIOWeb implements CSpellIO {
+    readFile(_uriOrFilename: string): Promise<string>;
+    readFileSync(_uriOrFilename: string): string;
+    writeFile(_uriOrFilename: string, _content: string): Promise<void>;
+    getStat(_uriOrFilename: string): Promise<Stats>;
+    getStatSync(_uriOrFilename: string): Stats;
+    compareStats(left: Stats, right: Stats): number;
+}
+//# sourceMappingURL=CSpellIOWeb.d.ts.map

package/dist/CSpellIOWeb.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CSpellIOWeb = void 0;
+const ErrorNotImplemented_1 = require("./errors/ErrorNotImplemented");
+const stat_1 = require("./common/stat");
+class CSpellIOWeb {
+    readFile(_uriOrFilename) {
+        throw new ErrorNotImplemented_1.ErrorNotImplemented('readFile');
+    }
+    readFileSync(_uriOrFilename) {
+        throw new ErrorNotImplemented_1.ErrorNotImplemented('readFileSync');
+    }
+    writeFile(_uriOrFilename, _content) {
+        throw new ErrorNotImplemented_1.ErrorNotImplemented('writeFile');
+    }
+    getStat(_uriOrFilename) {
+        throw new ErrorNotImplemented_1.ErrorNotImplemented('getStat');
+    }
+    getStatSync(_uriOrFilename) {
+        throw new ErrorNotImplemented_1.ErrorNotImplemented('getStatSync');
+    }
+    compareStats(left, right) {
+        return (0, stat_1.compareStats)(left, right);
+    }
+}
+exports.CSpellIOWeb = CSpellIOWeb;
+//# sourceMappingURL=CSpellIOWeb.js.map

package/dist/common/stat.d.ts

@@ -0,0 +1,9 @@
+import { Stats } from '../models/Stats';
+/**
+ * Compare two Stats to see if they have the same value.
+ * @param left - Stats
+ * @param right - Stats
+ * @returns 0 - equal; 1 - left > right; -1 left < right
+ */
+export declare function compareStats(left: Stats, right: Stats): number;
+//# sourceMappingURL=stat.d.ts.map

package/dist/common/stat.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareStats = void 0;
+/**
+ * Compare two Stats to see if they have the same value.
+ * @param left - Stats
+ * @param right - Stats
+ * @returns 0 - equal; 1 - left > right; -1 left < right
+ */
+function compareStats(left, right) {
+    if (left === right)
+        return 0;
+    if (left.eTag || right.eTag)
+        return left.eTag === right.eTag ? 0 : (left.eTag || '') < (right.eTag || '') ? -1 : 1;
+    const diff = left.size - right.size || left.mtimeMs - right.mtimeMs;
+    return diff < 0 ? -1 : diff > 0 ? 1 : 0;
+}
+exports.compareStats = compareStats;
+//# sourceMappingURL=stat.js.map

package/dist/errors/ErrorNotImplemented.d.ts

@@ -0,0 +1,5 @@
+export declare class ErrorNotImplemented extends Error {
+    readonly method: string;
+    constructor(method: string);
+}
+//# sourceMappingURL=ErrorNotImplemented.d.ts.map

package/dist/errors/ErrorNotImplemented.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorNotImplemented = void 0;
+class ErrorNotImplemented extends Error {
+    constructor(method) {
+        super(`Method ${method} is not supported.`);
+        this.method = method;
+    }
+}
+exports.ErrorNotImplemented = ErrorNotImplemented;
+//# sourceMappingURL=ErrorNotImplemented.js.map

package/dist/errors/error.d.ts

@@ -0,0 +1,2 @@
+export declare function toError(e: unknown): Error;
+//# sourceMappingURL=error.d.ts.map

package/dist/errors/error.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toError = void 0;
+function toError(e) {
+    if (e instanceof Error)
+        return e;
+    if (typeof e === 'object' && e && typeof e.message === 'string') {
+        return e;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return Error(e && e.toString());
+}
+exports.toError = toError;
+//# sourceMappingURL=error.js.map

package/dist/errors/index.d.ts

@@ -0,0 +1,3 @@
+export { toError } from './error';
+export { ErrorNotImplemented } from './ErrorNotImplemented';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorNotImplemented = exports.toError = void 0;
+var error_1 = require("./error");
+Object.defineProperty(exports, "toError", { enumerable: true, get: function () { return error_1.toError; } });
+var ErrorNotImplemented_1 = require("./ErrorNotImplemented");
+Object.defineProperty(exports, "ErrorNotImplemented", { enumerable: true, get: function () { return ErrorNotImplemented_1.ErrorNotImplemented; } });
+//# sourceMappingURL=index.js.map

package/dist/file/index.d.ts

@@ -1,5 +1,4 @@
-export { readFile, readFileSync } from './fileReader';
-export { writeToFile, writeToFileIterable, writeToFileIterableP } from './fileWriter';
-export { getStat, getStatSync } from './stat';
-export type { Stats } from './stat';
+export { readFile, readFileSync } from './../node/file';
+export { writeToFile, writeToFileIterable, writeToFileIterableP } from './../node/file';
+export { getStat, getStatSync } from './../node/file';
 //# sourceMappingURL=index.d.ts.map

package/dist/file/index.js

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getStatSync = exports.getStat = exports.writeToFileIterableP = exports.writeToFileIterable = exports.writeToFile = exports.readFileSync = exports.readFile = void 0;
-var fileReader_1 = require("./fileReader");
-Object.defineProperty(exports, "readFile", { enumerable: true, get: function () { return fileReader_1.readFile; } });
-Object.defineProperty(exports, "readFileSync", { enumerable: true, get: function () { return fileReader_1.readFileSync; } });
-var fileWriter_1 = require("./fileWriter");
-Object.defineProperty(exports, "writeToFile", { enumerable: true, get: function () { return fileWriter_1.writeToFile; } });
-Object.defineProperty(exports, "writeToFileIterable", { enumerable: true, get: function () { return fileWriter_1.writeToFileIterable; } });
-Object.defineProperty(exports, "writeToFileIterableP", { enumerable: true, get: function () { return fileWriter_1.writeToFileIterableP; } });
-var stat_1 = require("./stat");
-Object.defineProperty(exports, "getStat", { enumerable: true, get: function () { return stat_1.getStat; } });
-Object.defineProperty(exports, "getStatSync", { enumerable: true, get: function () { return stat_1.getStatSync; } });
+var file_1 = require("./../node/file");
+Object.defineProperty(exports, "readFile", { enumerable: true, get: function () { return file_1.readFile; } });
+Object.defineProperty(exports, "readFileSync", { enumerable: true, get: function () { return file_1.readFileSync; } });
+var file_2 = require("./../node/file");
+Object.defineProperty(exports, "writeToFile", { enumerable: true, get: function () { return file_2.writeToFile; } });
+Object.defineProperty(exports, "writeToFileIterable", { enumerable: true, get: function () { return file_2.writeToFileIterable; } });
+Object.defineProperty(exports, "writeToFileIterableP", { enumerable: true, get: function () { return file_2.writeToFileIterableP; } });
+var file_3 = require("./../node/file");
+Object.defineProperty(exports, "getStat", { enumerable: true, get: function () { return file_3.getStat; } });
+Object.defineProperty(exports, "getStatSync", { enumerable: true, get: function () { return file_3.getStatSync; } });
 //# sourceMappingURL=index.js.map

package/dist/handlers/node/file.d.ts

@@ -0,0 +1,3 @@
+import { ServiceBus } from '@cspell/cspell-service-bus';
+export declare function registerHandlers(serviceBus: ServiceBus): void;
+//# sourceMappingURL=file.d.ts.map

package/dist/handlers/node/file.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHandlers = void 0;
+const cspell_service_bus_1 = require("@cspell/cspell-service-bus");
+const assert_1 = __importDefault(require("assert"));
+const fs_1 = require("fs");
+const zlib_1 = require("zlib");
+const errors_1 = require("../../errors");
+const fetch_1 = require("../../node/file/fetch");
+const stat_1 = require("../../node/file/stat");
+const requests_1 = require("../../requests");
+const isGzFileRegExp = /\.gz($|[?#])/;
+function isGzFile(url) {
+    return isGzFileRegExp.test(url.pathname);
+}
+/**
+ * Handle Binary File Reads
+ */
+const handleRequestFsReadBinaryFile = (0, cspell_service_bus_1.createRequestHandler)(requests_1.RequestFsReadBinaryFile, ({ params }) => (0, cspell_service_bus_1.createResponse)(fs_1.promises.readFile(params.url)), undefined, 'Node: Read Binary File.');
+/**
+ * Handle Binary File Sync Reads
+ */
+const handleRequestFsReadBinaryFileSync = (0, cspell_service_bus_1.createRequestHandler)(requests_1.RequestFsReadBinaryFileSync, ({ params }) => (0, cspell_service_bus_1.createResponse)((0, fs_1.readFileSync)(params.url)), undefined, 'Node: Sync Read Binary File.');
+/**
+ * Handle UTF-8 Text File Reads
+ */
+const handleRequestFsReadFile = (0, cspell_service_bus_1.createRequestHandler)(requests_1.RequestFsReadFile, (req, _, dispatcher) => {
+    const { url, encoding } = req.params;
+    const res = dispatcher.dispatch(requests_1.RequestFsReadBinaryFile.create({ url }));
+    if (!(0, cspell_service_bus_1.isServiceResponseSuccess)(res)) {
+        (0, assert_1.default)((0, cspell_service_bus_1.isServiceResponseFailure)(res));
+        return (0, cspell_service_bus_1.createResponseFail)(req, res.error);
+    }
+    return (0, cspell_service_bus_1.createResponse)(res.value.then((buf) => bufferToText(buf, encoding)));
+}, undefined, 'Node: Read Text File.');
+/**
+ * Handle UTF-8 Text File Reads
+ */
+const handleRequestFsReadFileSync = (0, cspell_service_bus_1.createRequestHandler)(requests_1.RequestFsReadFileSync, (req, _, dispatcher) => {
+    const { url, encoding } = req.params;
+    const res = dispatcher.dispatch(requests_1.RequestFsReadBinaryFileSync.create({ url }));
+    if (!(0, cspell_service_bus_1.isServiceResponseSuccess)(res)) {
+        (0, assert_1.default)((0, cspell_service_bus_1.isServiceResponseFailure)(res));
+        return (0, cspell_service_bus_1.createResponseFail)(req, res.error);
+    }
+    return (0, cspell_service_bus_1.createResponse)(bufferToText(res.value, encoding));
+}, undefined, 'Node: Sync Read Text File.');
+/**
+ * Handle deflating gzip data
+ */
+const handleRequestZlibInflate = (0, cspell_service_bus_1.createRequestHandler)(requests_1.RequestZlibInflate, ({ params }) => (0, cspell_service_bus_1.createResponse)((0, zlib_1.gunzipSync)(params.data).toString('utf-8')), undefined, 'Node: gz deflate.');
+const supportedFetchProtocols = { 'http:': true, 'https:': true };
+/**
+ * Handle reading gzip'ed text files.
+ */
+const handleRequestFsReadBinaryFileHttp = (0, cspell_service_bus_1.createRequestHandler)(requests_1.RequestFsReadBinaryFile, (req, next) => {
+    const { url } = req.params;
+    if (!(url.protocol in supportedFetchProtocols))
+        return next(req);
+    return (0, cspell_service_bus_1.createResponse)((0, fetch_1.fetchURL)(url));
+}, undefined, 'Node: Read Http(s) file.');
+function bufferToText(buf, encoding) {
+    return buf[0] === 0x1f && buf[1] === 0x8b ? bufferToText((0, zlib_1.gunzipSync)(buf), encoding) : buf.toString(encoding);
+}
+/**
+ * Handle fs:stat
+ */
+const handleRequestFsStat = (0, cspell_service_bus_1.createRequestHandler)(requests_1.RequestFsStat, ({ params }) => (0, cspell_service_bus_1.createResponse)(fs_1.promises.stat(params.url)), undefined, 'Node: fs.stat.');
+/**
+ * Handle fs:statSync
+ */
+const handleRequestFsStatSync = (0, cspell_service_bus_1.createRequestHandler)(requests_1.RequestFsStatSync, (req) => {
+    const { params } = req;
+    try {
+        return (0, cspell_service_bus_1.createResponse)((0, fs_1.statSync)(params.url));
+    }
+    catch (e) {
+        return (0, cspell_service_bus_1.createResponseFail)(req, (0, errors_1.toError)(e));
+    }
+}, undefined, 'Node: fs.stat.');
+/**
+ * Handle deflating gzip data
+ */
+const handleRequestFsStatHttp = (0, cspell_service_bus_1.createRequestHandler)(requests_1.RequestFsStat, (req, next) => {
+    const { url } = req.params;
+    if (!(url.protocol in supportedFetchProtocols))
+        return next(req);
+    return (0, cspell_service_bus_1.createResponse)((0, stat_1.getStatHttp)(url));
+}, undefined, 'Node: http get stat');
+/**
+ * Handle fs:writeFile
+ */
+const handleRequestFsWriteFile = (0, cspell_service_bus_1.createRequestHandler)(requests_1.RequestFsWriteFile, ({ params }) => (0, cspell_service_bus_1.createResponse)(fs_1.promises.writeFile(params.url, params.content)), undefined, 'Node: fs.writeFile');
+/**
+ * Handle fs:writeFile compressed
+ */
+const handleRequestFsWriteFileGz = (0, cspell_service_bus_1.createRequestHandler)(requests_1.RequestFsWriteFile, (req, next) => {
+    const { url, content } = req.params;
+    if (!isGzFile(url))
+        return next(req);
+    return (0, cspell_service_bus_1.createResponse)(fs_1.promises.writeFile(url, (0, zlib_1.gzipSync)(content)));
+}, undefined, 'Node: http get stat');
+function registerHandlers(serviceBus) {
+    /**
+     * Handlers are in order of low to high level
+     * Order is VERY important.
+     */
+    const handlers = [
+        handleRequestFsWriteFile,
+        handleRequestFsWriteFileGz,
+        handleRequestFsReadBinaryFile,
+        handleRequestFsReadBinaryFileSync,
+        handleRequestFsReadBinaryFileHttp,
+        handleRequestFsReadFile,
+        handleRequestFsReadFileSync,
+        handleRequestZlibInflate,
+        handleRequestFsStatSync,
+        handleRequestFsStat,
+        handleRequestFsStatHttp,
+    ];
+    handlers.forEach((handler) => serviceBus.addHandler(handler));
+}
+exports.registerHandlers = registerHandlers;
+//# sourceMappingURL=file.js.map

package/dist/index.d.ts

@@ -1,3 +1,7 @@
-export * from './file';
 export { toArray as asyncIterableToArray } from './async/asyncIterable';
+export { getStat, getStatSync, readFile, readFileSync, writeToFile, writeToFileIterable, writeToFileIterableP, } from './file';
+export type { Stats } from './models/Stats';
+export type { CSpellIO } from './CSpellIO';
+export { CSpellIONode } from './CSpellIONode';
+export { encodeDataUrl, toDataUrl } from './node/dataUrl';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,21 +1,19 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.asyncIterableToArray = void 0;
-__exportStar(require("./file"), exports);
+exports.toDataUrl = exports.encodeDataUrl = exports.CSpellIONode = exports.writeToFileIterableP = exports.writeToFileIterable = exports.writeToFile = exports.readFileSync = exports.readFile = exports.getStatSync = exports.getStat = exports.asyncIterableToArray = void 0;
 var asyncIterable_1 = require("./async/asyncIterable");
 Object.defineProperty(exports, "asyncIterableToArray", { enumerable: true, get: function () { return asyncIterable_1.toArray; } });
+var file_1 = require("./file");
+Object.defineProperty(exports, "getStat", { enumerable: true, get: function () { return file_1.getStat; } });
+Object.defineProperty(exports, "getStatSync", { enumerable: true, get: function () { return file_1.getStatSync; } });
+Object.defineProperty(exports, "readFile", { enumerable: true, get: function () { return file_1.readFile; } });
+Object.defineProperty(exports, "readFileSync", { enumerable: true, get: function () { return file_1.readFileSync; } });
+Object.defineProperty(exports, "writeToFile", { enumerable: true, get: function () { return file_1.writeToFile; } });
+Object.defineProperty(exports, "writeToFileIterable", { enumerable: true, get: function () { return file_1.writeToFileIterable; } });
+Object.defineProperty(exports, "writeToFileIterableP", { enumerable: true, get: function () { return file_1.writeToFileIterableP; } });
+var CSpellIONode_1 = require("./CSpellIONode");
+Object.defineProperty(exports, "CSpellIONode", { enumerable: true, get: function () { return CSpellIONode_1.CSpellIONode; } });
+var dataUrl_1 = require("./node/dataUrl");
+Object.defineProperty(exports, "encodeDataUrl", { enumerable: true, get: function () { return dataUrl_1.encodeDataUrl; } });
+Object.defineProperty(exports, "toDataUrl", { enumerable: true, get: function () { return dataUrl_1.toDataUrl; } });
 //# sourceMappingURL=index.js.map

package/dist/models/BufferEncoding.d.ts

@@ -0,0 +1,2 @@
+export declare type BufferEncoding = 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'ucs2' | 'ucs-2' | 'base64' | 'base64url' | 'latin1' | 'hex';
+//# sourceMappingURL=BufferEncoding.d.ts.map

package/dist/models/BufferEncoding.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=BufferEncoding.js.map

package/dist/models/Stats.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Subset of definition from the Node definition to avoid a dependency upon a specific version of Node
+ */
+export interface Stats {
+    /**
+     * Size of file in byes, -1 if unknown.
+     */
+    size: number;
+    /**
+     * Modification time, 0 if unknown.
+     */
+    mtimeMs: number;
+    /**
+     * Used by web requests to see if a resource has changed.
+     */
+    eTag?: string | undefined;
+}
+//# sourceMappingURL=Stats.d.ts.map

package/dist/models/Stats.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Subset of definition from the Node definition to avoid a dependency upon a specific version of Node
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Stats.js.map

package/dist/models/index.d.ts

@@ -0,0 +1,2 @@
+export type { Stats } from './Stats';
+//# sourceMappingURL=index.d.ts.map

package/dist/models/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/node/dataUrl.d.ts

@@ -0,0 +1,22 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/**
+ * Generates a string of the following format:
+ *
+ * `data:[mediaType][;charset=<encoding>[;base64],<data>`
+ *
+ * - `encoding` - defaults to `utf8` for text data
+ * @param data
+ * @param mediaType - The mediaType is a [MIME](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) type string
+ * @param attributes - Additional attributes
+ */
+export declare function encodeDataUrl(data: string | Buffer, mediaType: string, attributes?: Iterable<readonly [string, string]> | undefined): string;
+export declare function toDataUrl(data: string | Buffer, mediaType: string, attributes?: Iterable<[string, string]> | undefined): URL;
+export interface DecodedDataUrl {
+    data: Buffer;
+    mediaType: string;
+    encoding?: string | undefined;
+    attributes: Map<string, string>;
+}
+export declare function decodeDataUrl(url: string): DecodedDataUrl;
+//# sourceMappingURL=dataUrl.d.ts.map

package/dist/node/dataUrl.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeDataUrl = exports.toDataUrl = exports.encodeDataUrl = void 0;
+/**
+ * Generates a string of the following format:
+ *
+ * `data:[mediaType][;charset=<encoding>[;base64],<data>`
+ *
+ * - `encoding` - defaults to `utf8` for text data
+ * @param data
+ * @param mediaType - The mediaType is a [MIME](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) type string
+ * @param attributes - Additional attributes
+ */
+function encodeDataUrl(data, mediaType, attributes) {
+    if (typeof data === 'string')
+        return encodeString(data, mediaType, attributes);
+    const attribs = encodeAttributes(attributes || []);
+    return `data:${mediaType}${attribs};base64,${data.toString('base64url')}`;
+}
+exports.encodeDataUrl = encodeDataUrl;
+function toDataUrl(data, mediaType, attributes) {
+    return new URL(encodeDataUrl(data, mediaType, attributes));
+}
+exports.toDataUrl = toDataUrl;
+function encodeString(data, mediaType, attributes) {
+    mediaType = mediaType || 'text/plain';
+    attributes = attributes || [];
+    const asUrlComp = encodeURIComponent(data);
+    const asBase64 = Buffer.from(data).toString('base64url');
+    const useBase64 = asBase64.length < asUrlComp.length - 7;
+    const encoded = useBase64 ? asBase64 : asUrlComp;
+    // Ensure charset is first.
+    const attribMap = new Map([['charset', 'utf8']].concat([...attributes]));
+    attribMap.set('charset', 'utf8'); // Make sure it is always `utf8`.
+    const attribs = encodeAttributes(attribMap);
+    return `data:${mediaType}${attribs}${useBase64 ? ';base64' : ''},${encoded}`;
+}
+function encodeAttributes(attributes) {
+    return [...attributes].map(([key, value]) => `;${key}=${encodeURIComponent(value)}`).join('');
+}
+const dataUrlRegExHead = /^data:(?<mediaType>[^;,]*)(?<attributes>(?:;[^=]+=[^;,]*)*)(?<base64>;base64)?$/;
+function decodeDataUrl(url) {
+    const [head, encodedData] = url.split(',', 2);
+    if (!head || encodedData === undefined)
+        throw Error('Not a data url');
+    const match = head.match(dataUrlRegExHead);
+    if (!match || !match.groups)
+        throw Error('Not a data url');
+    const mediaType = match.groups['mediaType'] || '';
+    const rawAttributes = (match.groups['attributes'] || '')
+        .split(';')
+        .filter((a) => !!a)
+        .map((entry) => entry.split('=', 2))
+        .map(([key, value]) => [key, decodeURIComponent(value)]);
+    const attributes = new Map(rawAttributes);
+    const encoding = attributes.get('charset');
+    const isBase64 = !!match.groups['base64'];
+    const data = isBase64 ? Buffer.from(encodedData, 'base64url') : Buffer.from(decodeURIComponent(encodedData));
+    return { mediaType, data, encoding, attributes };
+}
+exports.decodeDataUrl = decodeDataUrl;
+//# sourceMappingURL=dataUrl.js.map

package/dist/{file → node/file}/fetch.d.ts

@@ -1,6 +1,8 @@
 /// <reference types="node" />
+/// <reference types="node" />
 import type { Headers } from 'node-fetch';
 import nodeFetch from 'node-fetch';
 export declare const fetch: typeof nodeFetch;
 export declare function fetchHead(request: string | URL): Promise<Headers>;
+export declare function fetchURL(url: URL): Promise<Buffer>;
 //# sourceMappingURL=fetch.d.ts.map

package/dist/{file → node/file}/fetch.js

@@ -3,12 +3,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchHead = exports.fetch = void 0;
+exports.fetchURL = exports.fetchHead = exports.fetch = void 0;
 const node_fetch_1 = __importDefault(require("node-fetch"));
+const FetchError_1 = require("./FetchError");
 exports.fetch = node_fetch_1.default;
 async function fetchHead(request) {
     const r = await (0, exports.fetch)(request, { method: 'HEAD' });
     return r.headers;
 }
 exports.fetchHead = fetchHead;
+async function fetchURL(url) {
+    const response = await (0, exports.fetch)(url);
+    if (!response.ok) {
+        throw FetchError_1.FetchUrlError.create(url, response.status);
+    }
+    return Buffer.from(await response.arrayBuffer());
+}
+exports.fetchURL = fetchURL;
 //# sourceMappingURL=fetch.js.map

package/dist/node/file/index.d.ts

@@ -0,0 +1,4 @@
+export { readFile, readFileSync } from './fileReader';
+export { writeToFile, writeToFileIterable, writeToFileIterableP } from './fileWriter';
+export { getStat, getStatSync } from './stat';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/file/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStatSync = exports.getStat = exports.writeToFileIterableP = exports.writeToFileIterable = exports.writeToFile = exports.readFileSync = exports.readFile = void 0;
+var fileReader_1 = require("./fileReader");
+Object.defineProperty(exports, "readFile", { enumerable: true, get: function () { return fileReader_1.readFile; } });
+Object.defineProperty(exports, "readFileSync", { enumerable: true, get: function () { return fileReader_1.readFileSync; } });
+var fileWriter_1 = require("./fileWriter");
+Object.defineProperty(exports, "writeToFile", { enumerable: true, get: function () { return fileWriter_1.writeToFile; } });
+Object.defineProperty(exports, "writeToFileIterable", { enumerable: true, get: function () { return fileWriter_1.writeToFileIterable; } });
+Object.defineProperty(exports, "writeToFileIterableP", { enumerable: true, get: function () { return fileWriter_1.writeToFileIterableP; } });
+var stat_1 = require("./stat");
+Object.defineProperty(exports, "getStat", { enumerable: true, get: function () { return stat_1.getStat; } });
+Object.defineProperty(exports, "getStatSync", { enumerable: true, get: function () { return stat_1.getStatSync; } });
+//# sourceMappingURL=index.js.map

package/dist/node/file/stat.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="node" />
+import { Stats } from '../../models/Stats';
+export declare function getStat(filenameOrUri: string): Promise<Stats | Error>;
+export declare function getStatSync(uri: string): Stats | Error;
+export declare function getStatHttp(url: URL): Promise<Stats>;
+//# sourceMappingURL=stat.d.ts.map

package/dist/{file → node/file}/stat.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getStatSync = exports.getStat = void 0;
+exports.getStatHttp = exports.getStatSync = exports.getStat = void 0;
 const fs_1 = require("fs");
 const util_1 = require("util");
 const fetch_1 = require("./fetch");
@@ -10,12 +10,7 @@ async function getStat(filenameOrUri) {
         const url = (0, util_2.toURL)(filenameOrUri);
         if (!(0, util_2.isFileURL)(url)) {
             try {
-                const headers = await (0, fetch_1.fetchHead)(url);
-                return {
-                    size: Number.parseInt(headers.get('content-length') || '0', 10),
-                    mtimeMs: 0,
-                    eTag: headers.get('etag') || undefined,
-                };
+                return await getStatHttp(url);
             }
             catch (e) {
                 return toError(e);
@@ -34,6 +29,17 @@ function getStatSync(uri) {
     }
 }
 exports.getStatSync = getStatSync;
+async function getStatHttp(url) {
+    const headers = await (0, fetch_1.fetchHead)(url);
+    const eTag = headers.get('etag') || undefined;
+    const guessSize = Number.parseInt(headers.get('content-length') || '0', 10);
+    return {
+        size: eTag ? -1 : guessSize,
+        mtimeMs: 0,
+        eTag,
+    };
+}
+exports.getStatHttp = getStatHttp;
 function toError(e) {
     if (isErrnoException(e) || e instanceof Error)
         return e;

package/dist/{file → node/file}/util.d.ts

@@ -1,5 +1,4 @@
 /// <reference types="node" />
-import { URL } from 'url';
 export declare function isZipped(filename: string | URL): boolean;
 export declare function isUrlLike(filename: string | URL): boolean;
 export declare function isSupportedURL(url: URL): boolean;

package/dist/{file → node/file}/util.js

@@ -11,7 +11,7 @@ function isZipped(filename) {
 }
 exports.isZipped = isZipped;
 function isUrlLike(filename) {
-    return filename instanceof url_1.URL || isURLRegExp.test(filename);
+    return filename instanceof URL || isURLRegExp.test(filename);
 }
 exports.isUrlLike = isUrlLike;
 function isSupportedURL(url) {
@@ -23,7 +23,11 @@ function isFileURL(url) {
 }
 exports.isFileURL = isFileURL;
 function toURL(filename) {
-    return filename instanceof url_1.URL ? filename : isUrlLike(filename) ? new url_1.URL(filename) : (0, url_1.pathToFileURL)(filename);
+    return filename instanceof URL || typeof filename !== 'string'
+        ? filename
+        : isUrlLike(filename)
+            ? new URL(filename)
+            : (0, url_1.pathToFileURL)(filename);
 }
 exports.toURL = toURL;
 //# sourceMappingURL=util.js.map

package/dist/requests/RequestFsReadBinaryFile.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="node" />
+/// <reference types="node" />
+interface RequestParams {
+    readonly url: URL;
+}
+export declare const RequestFsReadBinaryFile: import("@cspell/cspell-service-bus/request").ServiceRequestFactory<import("@cspell/cspell-service-bus").ServiceRequest<"fs:readBinaryFile", RequestParams, Promise<Buffer>>, RequestParams, "fs:readBinaryFile">;
+export declare const RequestFsReadBinaryFileSync: import("@cspell/cspell-service-bus/request").ServiceRequestFactory<import("@cspell/cspell-service-bus").ServiceRequest<"fs:readBinaryFileSync", RequestParams, Buffer>, RequestParams, "fs:readBinaryFileSync">;
+export {};
+//# sourceMappingURL=RequestFsReadBinaryFile.d.ts.map

package/dist/requests/RequestFsReadBinaryFile.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestFsReadBinaryFileSync = exports.RequestFsReadBinaryFile = void 0;
+const cspell_service_bus_1 = require("@cspell/cspell-service-bus");
+const RequestType = 'fs:readBinaryFile';
+exports.RequestFsReadBinaryFile = (0, cspell_service_bus_1.requestFactory)(RequestType);
+const RequestTypeSync = 'fs:readBinaryFileSync';
+exports.RequestFsReadBinaryFileSync = (0, cspell_service_bus_1.requestFactory)(RequestTypeSync);
+//# sourceMappingURL=RequestFsReadBinaryFile.js.map

package/dist/requests/RequestFsReadFile.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="node" />
+/// <reference types="node" />
+interface RequestParams {
+    readonly url: URL;
+    readonly encoding: BufferEncoding;
+}
+export declare const RequestFsReadFile: import("@cspell/cspell-service-bus/request").ServiceRequestFactory<import("@cspell/cspell-service-bus").ServiceRequest<"fs:readFile", RequestParams, Promise<string>>, RequestParams, "fs:readFile">;
+export {};
+//# sourceMappingURL=RequestFsReadFile.d.ts.map

package/dist/requests/RequestFsReadFile.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestFsReadFile = void 0;
+const cspell_service_bus_1 = require("@cspell/cspell-service-bus");
+const RequestType = 'fs:readFile';
+exports.RequestFsReadFile = (0, cspell_service_bus_1.requestFactory)(RequestType);
+//# sourceMappingURL=RequestFsReadFile.js.map

package/dist/requests/RequestFsReadFileSync.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="node" />
+/// <reference types="node" />
+interface RequestParams {
+    readonly url: URL;
+    readonly encoding: BufferEncoding;
+}
+export declare const RequestFsReadFileSync: import("@cspell/cspell-service-bus/request").ServiceRequestFactory<import("@cspell/cspell-service-bus").ServiceRequest<"fs:readFileSync", RequestParams, string>, RequestParams, "fs:readFileSync">;
+export {};
+//# sourceMappingURL=RequestFsReadFileSync.d.ts.map

package/dist/requests/RequestFsReadFileSync.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestFsReadFileSync = void 0;
+const cspell_service_bus_1 = require("@cspell/cspell-service-bus");
+const RequestType = 'fs:readFileSync';
+exports.RequestFsReadFileSync = (0, cspell_service_bus_1.requestFactory)(RequestType);
+//# sourceMappingURL=RequestFsReadFileSync.js.map

package/dist/requests/RequestFsStat.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="node" />
+import { Stats } from '../models';
+interface RequestStatParams {
+    readonly url: URL;
+}
+export declare const RequestFsStat: import("@cspell/cspell-service-bus/request").ServiceRequestFactory<import("@cspell/cspell-service-bus").ServiceRequest<"fs:stat", RequestStatParams, Promise<Stats>>, RequestStatParams, "fs:stat">;
+export declare const RequestFsStatSync: import("@cspell/cspell-service-bus/request").ServiceRequestFactory<import("@cspell/cspell-service-bus").ServiceRequest<"fs:statSync", RequestStatParams, Stats>, RequestStatParams, "fs:statSync">;
+export {};
+//# sourceMappingURL=RequestFsStat.d.ts.map

package/dist/requests/RequestFsStat.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestFsStatSync = exports.RequestFsStat = void 0;
+const cspell_service_bus_1 = require("@cspell/cspell-service-bus");
+const RequestTypeStat = 'fs:stat';
+exports.RequestFsStat = (0, cspell_service_bus_1.requestFactory)(RequestTypeStat);
+const RequestTypeStatSync = 'fs:statSync';
+exports.RequestFsStatSync = (0, cspell_service_bus_1.requestFactory)(RequestTypeStatSync);
+//# sourceMappingURL=RequestFsStat.js.map

package/dist/requests/RequestFsWriteFile.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="node" />
+interface RequestParams {
+    readonly url: URL;
+    readonly content: string;
+}
+export declare const RequestFsWriteFile: import("@cspell/cspell-service-bus/request").ServiceRequestFactory<import("@cspell/cspell-service-bus").ServiceRequest<"fs:writeFile", RequestParams, Promise<void>>, RequestParams, "fs:writeFile">;
+export {};
+//# sourceMappingURL=RequestFsWriteFile.d.ts.map

package/dist/requests/RequestFsWriteFile.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestFsWriteFile = void 0;
+const cspell_service_bus_1 = require("@cspell/cspell-service-bus");
+const RequestType = 'fs:writeFile';
+exports.RequestFsWriteFile = (0, cspell_service_bus_1.requestFactory)(RequestType);
+//# sourceMappingURL=RequestFsWriteFile.js.map

package/dist/requests/RequestZlibInflate.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="node" />
+interface RequestParams {
+    readonly data: Buffer;
+}
+export declare const RequestZlibInflate: import("@cspell/cspell-service-bus/request").ServiceRequestFactory<import("@cspell/cspell-service-bus").ServiceRequest<"zlib:inflate", RequestParams, string>, RequestParams, "zlib:inflate">;
+export {};
+//# sourceMappingURL=RequestZlibInflate.d.ts.map

package/dist/requests/RequestZlibInflate.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestZlibInflate = void 0;
+const cspell_service_bus_1 = require("@cspell/cspell-service-bus");
+const RequestType = 'zlib:inflate';
+exports.RequestZlibInflate = (0, cspell_service_bus_1.requestFactory)(RequestType);
+//# sourceMappingURL=RequestZlibInflate.js.map

package/dist/requests/index.d.ts

@@ -0,0 +1,7 @@
+export { RequestFsReadBinaryFile, RequestFsReadBinaryFileSync } from './RequestFsReadBinaryFile';
+export { RequestFsReadFile } from './RequestFsReadFile';
+export { RequestFsReadFileSync } from './RequestFsReadFileSync';
+export { RequestFsStat, RequestFsStatSync } from './RequestFsStat';
+export { RequestZlibInflate } from './RequestZlibInflate';
+export { RequestFsWriteFile } from './RequestFsWriteFile';
+//# sourceMappingURL=index.d.ts.map

package/dist/requests/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestFsWriteFile = exports.RequestZlibInflate = exports.RequestFsStatSync = exports.RequestFsStat = exports.RequestFsReadFileSync = exports.RequestFsReadFile = exports.RequestFsReadBinaryFileSync = exports.RequestFsReadBinaryFile = void 0;
+var RequestFsReadBinaryFile_1 = require("./RequestFsReadBinaryFile");
+Object.defineProperty(exports, "RequestFsReadBinaryFile", { enumerable: true, get: function () { return RequestFsReadBinaryFile_1.RequestFsReadBinaryFile; } });
+Object.defineProperty(exports, "RequestFsReadBinaryFileSync", { enumerable: true, get: function () { return RequestFsReadBinaryFile_1.RequestFsReadBinaryFileSync; } });
+var RequestFsReadFile_1 = require("./RequestFsReadFile");
+Object.defineProperty(exports, "RequestFsReadFile", { enumerable: true, get: function () { return RequestFsReadFile_1.RequestFsReadFile; } });
+var RequestFsReadFileSync_1 = require("./RequestFsReadFileSync");
+Object.defineProperty(exports, "RequestFsReadFileSync", { enumerable: true, get: function () { return RequestFsReadFileSync_1.RequestFsReadFileSync; } });
+var RequestFsStat_1 = require("./RequestFsStat");
+Object.defineProperty(exports, "RequestFsStat", { enumerable: true, get: function () { return RequestFsStat_1.RequestFsStat; } });
+Object.defineProperty(exports, "RequestFsStatSync", { enumerable: true, get: function () { return RequestFsStat_1.RequestFsStatSync; } });
+var RequestZlibInflate_1 = require("./RequestZlibInflate");
+Object.defineProperty(exports, "RequestZlibInflate", { enumerable: true, get: function () { return RequestZlibInflate_1.RequestZlibInflate; } });
+var RequestFsWriteFile_1 = require("./RequestFsWriteFile");
+Object.defineProperty(exports, "RequestFsWriteFile", { enumerable: true, get: function () { return RequestFsWriteFile_1.RequestFsWriteFile; } });
+//# sourceMappingURL=index.js.map

package/dist/test/helper.d.ts

@@ -0,0 +1,13 @@
+export declare function pathToSample(...parts: string[]): string;
+export declare function pathToRoot(...parts: string[]): string;
+export declare function makePathToFile(file: string): Promise<void>;
+export declare function testNameToDir(testName: string): string;
+/**
+ * Calculate a Uri for a path to a temporary directory that will be unique to the current test.
+ * Note: if a text is not currently running, then it is the path for the test file.
+ * @param baseFilename - name of file / directory wanted
+ * @param testFilename - optional full path to a test file.
+ * @returns full path to the requested temp file.
+ */
+export declare function pathToTemp(...parts: string[]): string;
+//# sourceMappingURL=helper.d.ts.map

package/dist/test/helper.js

@@ -0,0 +1,65 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pathToTemp = exports.testNameToDir = exports.makePathToFile = exports.pathToRoot = exports.pathToSample = void 0;
+const path = __importStar(require("path"));
+const fs_extra_1 = require("fs-extra");
+const pathPackageRoot = path.join(__dirname, '../..');
+const pathSamples = path.join(pathPackageRoot, 'samples');
+const pathTemp = path.join(pathPackageRoot, 'temp');
+function pathToSample(...parts) {
+    return path.resolve(pathSamples, ...parts);
+}
+exports.pathToSample = pathToSample;
+function pathToRoot(...parts) {
+    return path.resolve(pathPackageRoot, ...parts);
+}
+exports.pathToRoot = pathToRoot;
+function makePathToFile(file) {
+    return (0, fs_extra_1.mkdirp)(path.dirname(file));
+}
+exports.makePathToFile = makePathToFile;
+function testNameToDir(testName) {
+    return `test_${testName.replace(/\s/g, '-').replace(/[^\w.-]/gi, '_')}_test`;
+}
+exports.testNameToDir = testNameToDir;
+/**
+ * Calculate a Uri for a path to a temporary directory that will be unique to the current test.
+ * Note: if a text is not currently running, then it is the path for the test file.
+ * @param baseFilename - name of file / directory wanted
+ * @param testFilename - optional full path to a test file.
+ * @returns full path to the requested temp file.
+ */
+function pathToTemp(...parts) {
+    const testState = expect.getState();
+    const callerFile = testState.testPath || '.';
+    const testFile = path.relative(pathPackageRoot, callerFile);
+    expect.getState();
+    const testName = testState.currentTestName || '.';
+    const testDirName = testNameToDir(testName);
+    return path.resolve(pathTemp, testFile, testDirName, ...parts);
+}
+exports.pathToTemp = pathToTemp;
+//# sourceMappingURL=helper.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cspell-io",
-  "version": "6.4.2",
+  "version": "6.5.0",
   "description": "A library of useful I/O functions used across various cspell tools.",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
@@ -46,8 +46,9 @@
     "rimraf": "^3.0.2"
   },
   "dependencies": {
+    "@cspell/cspell-service-bus": "^6.5.0",
     "@types/node-fetch": "^2.6.2",
     "node-fetch": "^2.6.7"
   },
-  "gitHead": "1f7481fd7d6a561de92ba49870da6eb1441a9d20"
+  "gitHead": "65c80b01e17bb0d74b57ef8b29309684a8588e27"
 }

package/dist/file/stat.d.ts

@@ -1,13 +0,0 @@
-/**
- * Copied from the Node definition to avoid a dependency upon a specific version of Node
- */
-interface StatsBase<T> {
-    size: T;
-    mtimeMs: T;
-    eTag?: string | undefined;
-}
-export declare function getStat(filenameOrUri: string): Promise<Stats | Error>;
-export declare function getStatSync(uri: string): Stats | Error;
-export declare type Stats = StatsBase<number>;
-export {};
-//# sourceMappingURL=stat.d.ts.map