devbrain-cli 0.2.0 → 0.3.0

package/dist/temp-prefix/node_modules/devbrain-cli/node_modules/@kwsites/file-exists/dist/src/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Synchronous validation of a path existing either as a file or as a directory.
+ *
+ * @param {string} path The path to check
+ * @param {number} type One or both of the exported numeric constants
+ */
+export declare function exists(path: string, type?: number): boolean;
+/**
+ * Constant representing a file
+ */
+export declare const FILE = 1;
+/**
+ * Constant representing a folder
+ */
+export declare const FOLDER = 2;
+/**
+ * Constant representing either a file or a folder
+ */
+export declare const READABLE: number;

package/dist/temp-prefix/node_modules/devbrain-cli/node_modules/@kwsites/file-exists/dist/src/index.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const debug_1 = __importDefault(require("debug"));
+const log = debug_1.default('@kwsites/file-exists');
+function check(path, isFile, isDirectory) {
+    log(`checking %s`, path);
+    try {
+        const stat = fs_1.statSync(path);
+        if (stat.isFile() && isFile) {
+            log(`[OK] path represents a file`);
+            return true;
+        }
+        if (stat.isDirectory() && isDirectory) {
+            log(`[OK] path represents a directory`);
+            return true;
+        }
+        log(`[FAIL] path represents something other than a file or directory`);
+        return false;
+    }
+    catch (e) {
+        if (e.code === 'ENOENT') {
+            log(`[FAIL] path is not accessible: %o`, e);
+            return false;
+        }
+        log(`[FATAL] %o`, e);
+        throw e;
+    }
+}
+/**
+ * Synchronous validation of a path existing either as a file or as a directory.
+ *
+ * @param {string} path The path to check
+ * @param {number} type One or both of the exported numeric constants
+ */
+function exists(path, type = exports.READABLE) {
+    return check(path, (type & exports.FILE) > 0, (type & exports.FOLDER) > 0);
+}
+exports.exists = exists;
+/**
+ * Constant representing a file
+ */
+exports.FILE = 1;
+/**
+ * Constant representing a folder
+ */
+exports.FOLDER = 2;
+/**
+ * Constant representing either a file or a folder
+ */
+exports.READABLE = exports.FILE + exports.FOLDER;
+//# sourceMappingURL=index.js.map

package/dist/temp-prefix/node_modules/devbrain-cli/node_modules/@kwsites/file-exists/dist/test/__mocks__/fs.d.ts

@@ -0,0 +1,7 @@
+export declare function statSync(...args: any[]): any;
+export declare function addStatSyncMock(fn: any): void;
+export declare function assertMocksUsed(): void;
+declare const mockFs: {
+    statSync: typeof statSync;
+};
+export default mockFs;

package/dist/temp-prefix/node_modules/devbrain-cli/node_modules/@kwsites/file-exists/dist/test/__mocks__/fs.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+let statSyncMocks = [];
+function statSync(...args) {
+    const mock = statSyncMocks.shift();
+    if (typeof mock !== 'function') {
+        throw new Error(`fs.statSync called without configuring a mock`);
+    }
+    return mock(...args);
+}
+exports.statSync = statSync;
+function addStatSyncMock(fn) {
+    statSyncMocks.push(fn);
+}
+exports.addStatSyncMock = addStatSyncMock;
+function assertMocksUsed() {
+    if (statSyncMocks.length) {
+        throw new Error(`fs.afterEach: statSync has ${statSyncMocks.length} unused mocks`);
+    }
+}
+exports.assertMocksUsed = assertMocksUsed;
+const mockFs = {
+    statSync,
+};
+exports.default = mockFs;
+//# sourceMappingURL=fs.js.map

package/dist/temp-prefix/node_modules/devbrain-cli/node_modules/@kwsites/file-exists/dist/test/exists.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/temp-prefix/node_modules/devbrain-cli/node_modules/@kwsites/file-exists/dist/test/exists.spec.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+jest.mock('fs');
+//@ts-ignore
+const fs_1 = require("fs");
+const src_1 = require("../src");
+describe(`exists`, () => {
+    let statSync;
+    let statSyncMock;
+    let path;
+    beforeEach(() => {
+        path = `./path/${Math.random()}`;
+        fs_1.addStatSyncMock(statSyncMock = jest.fn(() => statSync()));
+    });
+    afterEach(() => {
+        fs_1.assertMocksUsed();
+        statSync = statSyncMock = undefined;
+    });
+    describe('known errors', () => {
+        beforeEach(() => givenStatSyncThrows({ code: 'ENOENT' }));
+        it('with type', () => {
+            expect(src_1.exists(path, src_1.READABLE)).toBe(false);
+        });
+        it('with type omitted', () => {
+            expect(src_1.exists(path)).toBe(false);
+        });
+    });
+    describe('unknown errors', () => {
+        let err;
+        beforeEach(() => err = givenStatSyncThrows(new Error('something')));
+        it('with type', () => {
+            expect(() => src_1.exists(path, src_1.READABLE)).toThrow(err);
+        });
+        it('with type omitted', () => {
+            expect(() => src_1.exists(path)).toThrow(err);
+        });
+    });
+    describe('path is a file', () => {
+        beforeEach(() => givenStatSyncIsA('file'));
+        existsReturns(true, false, true);
+    });
+    describe('path is a folder', () => {
+        beforeEach(() => givenStatSyncIsA('folder'));
+        existsReturns(false, true, true);
+    });
+    describe('path is unknown', () => {
+        beforeEach(() => givenStatSyncIsA('unknown'));
+        existsReturns(false, false, false);
+    });
+    function existsReturns(file, folder, readable) {
+        it('when searching for a file', () => {
+            expect(src_1.exists(path, src_1.FILE)).toBe(file);
+        });
+        it('when searching for a folder', () => {
+            expect(src_1.exists(path, src_1.FOLDER)).toBe(folder);
+        });
+        it('when searching for either', () => {
+            expect(src_1.exists(path, src_1.READABLE)).toBe(readable);
+        });
+        it('when searching without a type', () => {
+            expect(src_1.exists(path)).toBe(readable);
+        });
+    }
+    function givenStatSyncThrows(err) {
+        statSync = () => { throw err; };
+        return err;
+    }
+    function givenStatSyncIsA(type) {
+        const mockStat = {
+            isFile() { return type === 'file'; },
+            isDirectory() { return type === 'folder'; },
+        };
+        statSync = () => mockStat;
+        return mockStat;
+    }
+});
+//# sourceMappingURL=exists.spec.js.map

package/dist/temp-prefix/node_modules/devbrain-cli/node_modules/@kwsites/file-exists/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@kwsites/file-exists",
+  "version": "1.1.1",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "repository": "git@github.com:kwsites/file-exists.git",
+  "author": "Steve King <steve@mydev.co>",
+  "contributors": [
+    {
+      "name": "Steve King",
+      "email": "steve@mydev.co"
+    }
+  ],
+  "files": [
+    "dist/**/*.*"
+  ],
+  "scripts": {
+    "clean": "rimraf ./dist",
+    "build": "yarn run clean && tsc",
+    "preversion": "yarn run clean && yarn run build && yarn test",
+    "postversion": "npm publish --access=public && git push && git push --tags",
+    "test": "jest --coverage",
+    "tsc": "tsc"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.10.1",
+    "@babel/preset-env": "^7.10.1",
+    "@babel/preset-typescript": "^7.10.1",
+    "@types/debug": "^4.1.5",
+    "@types/jest": "^26.0.0",
+    "@types/node": "^10.12.0",
+    "babel-jest": "^26.0.1",
+    "jest": "^25.3.0",
+    "rimraf": "^2.6.2",
+    "ts-node": "^8.10.2",
+    "typescript": "^3.1.3"
+  },
+  "dependencies": {
+    "debug": "^4.1.1"
+  }
+}

package/dist/temp-prefix/node_modules/devbrain-cli/node_modules/@kwsites/file-exists/readme.md

@@ -0,0 +1,41 @@
+# @kwsites/file-exists
+
+Synchronous validation of a path existing either as a file or as a directory.
+
+```
+const { exists, FILE, FOLDER, READABLE } = require('@kwsites/file-exists');
+
+// check for a folder existing
+assert(exists(__dirname, FOLDER));
+assert(!exists(__filename, FOLDER));
+
+// check for a file existing
+assert(!exists(__filename, FILE));
+assert(exists(__filename, FILE));
+
+// when no type is specified, both folders and files are allowed
+assert(exists(__dirname));
+assert(exists(__filename));
+
+// alternatively specify both files and folders
+assert(exists(__dirname, FILE + FOLDER));
+
+// or just that the path is readable (can be either a file or folder)
+assert(exists(__filename, READABLE));
+```
+
+## Troubleshooting
+
+This library uses [debug](https://www.npmjs.com/package/debug) to handle logging,
+to enable logging, use either the environment variable:
+
+```
+"DEBUG=@kwsites/file-exists" node ./your-app.js 
+``` 
+
+Or explicitly enable logging using the `debug` library itself:
+
+```javascript
+require('debug').enable('@kwsites/file-exists');
+``` 
+

package/dist/temp-prefix/node_modules/devbrain-cli/node_modules/@kwsites/promise-deferred/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 kwsites
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/temp-prefix/node_modules/devbrain-cli/node_modules/@kwsites/promise-deferred/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The `DeferredPromise` has a `promise` property in an initially pending state,
+ * that will be resolved when the `done` method is called or rejected when the
+ * `fail` method is called.
+ */
+export interface DeferredPromise<RESOLVES, REJECTS extends Error = Error> {
+    done(result: RESOLVES): void;
+    fail(error: REJECTS): void;
+    readonly status: DeferredPromiseStatus;
+    readonly fulfilled: boolean;
+    promise: Promise<RESOLVES>;
+}
+/**
+ * The three states the DeferredPromise can be in - initially pending then either
+ * resolved or rejected when it is fulfilled.
+ *
+ * ```typescript
+ import {createDeferred, DeferredPromiseStatus} from '@kwsites/promise-deferred`;
+
+ const pending: DeferredPromiseStatus = 'pending';
+ expect(createDeferred()).toHaveProperty('status', pending);
+ ```
+ */
+export declare type DeferredPromiseStatus = 'pending' | 'resolved' | 'rejected';
+/**
+ * Creates a new `DeferredPromise`
+ *
+ * ```typescript
+ import {deferred} from '@kwsites/promise-deferred`;
+ ```
+ */
+export declare function deferred<T extends any = void, E extends Error = Error>(): DeferredPromise<T, E>;
+/**
+ * Alias of the exported `deferred` function, to help consumers wanting to use `deferred` as the
+ * local variable name rather than the factory import name, without needing to rename on import.
+ *
+ * ```typescript
+ import {createDeferred} from '@kwsites/promise-deferred`;
+ ```
+ */
+export declare const createDeferred: typeof deferred;
+/**
+ * Default export allows use as:
+ *
+ * ```typescript
+ import deferred from '@kwsites/promise-deferred`;
+ ```
+ */
+export default deferred;

package/dist/temp-prefix/node_modules/devbrain-cli/node_modules/@kwsites/promise-deferred/dist/index.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDeferred = exports.deferred = void 0;
+/**
+ * Creates a new `DeferredPromise`
+ *
+ * ```typescript
+ import {deferred} from '@kwsites/promise-deferred`;
+ ```
+ */
+function deferred() {
+    let done;
+    let fail;
+    let status = 'pending';
+    const promise = new Promise((_done, _fail) => {
+        done = _done;
+        fail = _fail;
+    });
+    return {
+        promise,
+        done(result) {
+            if (status === 'pending') {
+                status = 'resolved';
+                done(result);
+            }
+        },
+        fail(error) {
+            if (status === 'pending') {
+                status = 'rejected';
+                fail(error);
+            }
+        },
+        get fulfilled() {
+            return status !== 'pending';
+        },
+        get status() {
+            return status;
+        },
+    };
+}
+exports.deferred = deferred;
+/**
+ * Alias of the exported `deferred` function, to help consumers wanting to use `deferred` as the
+ * local variable name rather than the factory import name, without needing to rename on import.
+ *
+ * ```typescript
+ import {createDeferred} from '@kwsites/promise-deferred`;
+ ```
+ */
+exports.createDeferred = deferred;
+/**
+ * Default export allows use as:
+ *
+ * ```typescript
+ import deferred from '@kwsites/promise-deferred`;
+ ```
+ */
+exports.default = deferred;
+//# sourceMappingURL=index.js.map

package/dist/temp-prefix/node_modules/devbrain-cli/node_modules/@kwsites/promise-deferred/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@kwsites/promise-deferred",
+  "description": "Minimalist creation of promise wrappers, exposing the ability to resolve or reject the inner promise",
+  "version": "1.1.1",
+  "private": false,
+  "author": "Steve King <steve@mydev.co>",
+  "contributors": [
+    {
+      "name": "Steve King",
+      "email": "steve@mydev.co"
+    }
+  ],
+  "main": "./dist/index",
+  "types": "./dist/index",
+  "license": "MIT",
+  "repository": "git://github.com/kwsites/promise-deferred.git",
+  "devDependencies": {
+    "@babel/core": "^7.10.3",
+    "@babel/preset-env": "^7.10.3",
+    "@babel/preset-typescript": "^7.10.1",
+    "@types/jest": "^26.0.0",
+    "@types/node": "^14.0.13",
+    "babel-jest": "^26.1.0",
+    "babel-preset-env": "^1.7.0",
+    "jest": "^26.1.0",
+    "ts-node": "^8.10.2",
+    "typescript": "^3.9.5"
+  },
+  "files": [
+    "LICENSE",
+    "dist/**/*.*"
+  ],
+  "scripts": {
+    "clean": "git clean -fxd -e .idea -e node_modules",
+    "clean:modules": "git clean -fxd node_modules",
+    "build": "tsc --build",
+    "build:clean": "yarn run clean && tsc",
+    "preversion": "yarn run build:clean && yarn test",
+    "postversion": "npm publish --access=public && git push && git push --tags",
+    "test": "jest --coverage",
+    "tsc": "tsc"
+  }
+}

package/dist/temp-prefix/node_modules/devbrain-cli/node_modules/@nodable/entities/README.md

@@ -0,0 +1,41 @@
+# @nodable/entities
+
+Fast, zero-dependency XML/HTML entity encoder and decoder for Node.js.
+
+## Install
+
+```bash
+npm install @nodable/entities
+```
+
+## Quick start
+
+```js
+import { EntityEncoder, EntityDecoder, ALL_ENTITIES } from '@nodable/entities';
+
+// Encode: plain text → entity references
+const enc = new EntityEncoder();
+enc.encode('Hello © 2024 & <stuff>');
+// → 'Hello &copy; 2024 &amp; &lt;stuff&gt;'
+
+// Decode: entity references → plain text
+const dec = new EntityDecoder({ namedEntities: ALL_ENTITIES });
+dec.decode('Hello &copy; 2024 &amp; &lt;stuff&gt;');
+// → 'Hello © 2024 & <stuff>'
+```
+
+## Performance
+
+|  | encode | decode |
+|---|---|---|
+| `entities` (npm) | 3.65 M req/s | 1.76 M req/s |
+| `@nodable/entities` | 3.33 M req/s | **5.19 M req/s** |
+
+## Documentation
+
+- [EntityEncoder](docs/EntityEncoder.md) — options, API, recipes
+- [EntityDecoder](docs/EntityDecoder.md) — options, API, security limits, entity sets
+
+## License
+
+MIT

package/dist/temp-prefix/node_modules/devbrain-cli/node_modules/@nodable/entities/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@nodable/entities",
+  "version": "2.2.0",
+  "description": "Entity parser for XML, HTML, External entites with security and NCR control",
+  "main": "./src/index.js",
+  "type": "module",
+  "sideEffects": false,
+  "types": "./src/index.d.ts",
+  "scripts": {
+    "test": "node --experimental-vm-modules node_modules/.bin/jest",
+    "test:watch": "node --experimental-vm-modules node_modules/.bin/jest --watch",
+    "test:coverage": "node --experimental-vm-modules node_modules/.bin/jest --coverage",
+    "lint": "eslint src/ test/"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nodable/val-parsers.git"
+  },
+  "keywords": [
+    "fast",
+    "xml",
+    "html",
+    "entity",
+    "entities",
+    "stringify",
+    "encode",
+    "decode",
+    "ncr",
+    "security",
+    "safe",
+    "performance"
+  ],
+  "author": "Amit Gupta (https://solothought.com)",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "jest": "^29.7.0"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/nodable"
+    }
+  ],
+  "jest": {
+    "testMatch": [
+      "**/?(*.)+(spec|test).[jt]s?(x)",
+      "**/*_spec.[jt]s?(x)"
+    ]
+  }
+}