forked from public/fvtt-cthulhu-eternal
Initial import with skill sheet working
This commit is contained in:
21
node_modules/async-done/LICENSE
generated
vendored
Normal file
21
node_modules/async-done/LICENSE
generated
vendored
Normal file
@ -0,0 +1,21 @@
|
||||
The MIT License (MIT)
|
||||
|
||||
Copyright (c) 2015-2019, 2021 Blaine Bublitz <blaine.bublitz@gmail.com> and Eric Schoffstall <yo@contra.io>
|
||||
|
||||
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.
|
122
node_modules/async-done/README.md
generated
vendored
Normal file
122
node_modules/async-done/README.md
generated
vendored
Normal file
@ -0,0 +1,122 @@
|
||||
<p align="center">
|
||||
<a href="http://gulpjs.com">
|
||||
<img height="257" width="114" src="https://raw.githubusercontent.com/gulpjs/artwork/master/gulp-2x.png">
|
||||
</a>
|
||||
</p>
|
||||
|
||||
# async-done
|
||||
|
||||
[![NPM version][npm-image]][npm-url] [![Downloads][downloads-image]][npm-url] [![Build Status][ci-image]][ci-url] [![Coveralls Status][coveralls-image]][coveralls-url]
|
||||
|
||||
Allows libraries to handle various caller provided asynchronous functions uniformly. Maps promises, observables, child processes and streams, and callbacks to callback style.
|
||||
|
||||
As async conventions evolve, it is useful to be able to deal with several different _styles_ of async completion uniformly. With this module you can handle completion using a node-style callback, regardless of a return value that's a promise, observable, child process or stream.
|
||||
|
||||
## Usage
|
||||
|
||||
### Successful completion
|
||||
|
||||
```js
|
||||
var asyncDone = require('async-done');
|
||||
|
||||
asyncDone(
|
||||
function (done) {
|
||||
// do async things
|
||||
done(null, 2);
|
||||
},
|
||||
function (error, result) {
|
||||
// `error` will be null on successful execution of the first function.
|
||||
// `result` will be the result from the first function.
|
||||
}
|
||||
);
|
||||
```
|
||||
|
||||
### Failed completion
|
||||
|
||||
```js
|
||||
var asyncDone = require('async-done');
|
||||
|
||||
asyncDone(
|
||||
function (done) {
|
||||
// do async things
|
||||
done(new Error('Some Error Occurred'));
|
||||
},
|
||||
function (error, result) {
|
||||
// `error` will be an error from the first function.
|
||||
// `result` will be undefined on failed execution of the first function.
|
||||
}
|
||||
);
|
||||
```
|
||||
|
||||
## API
|
||||
|
||||
### `asyncDone(fn, callback)`
|
||||
|
||||
Takes a function to execute (`fn`) and a function to call on completion (`callback`).
|
||||
|
||||
#### `fn([done])`
|
||||
|
||||
Optionally takes a callback to call when async tasks are complete.
|
||||
|
||||
#### Completion and Error Resolution
|
||||
|
||||
- `Callback` (`done`) called
|
||||
- Completion: called with null error
|
||||
- Error: called with non-null error
|
||||
- `Stream` or `EventEmitter` returned
|
||||
- Completion: [end-of-stream][end-of-stream] module
|
||||
- Error: [domains][domains]
|
||||
- **Note:** Only actual streams are supported, not faux-streams; Therefore, modules like [`event-stream`][event-stream] are not supported.
|
||||
- `Child Process` returned
|
||||
- Completion [end-of-stream][end-of-stream] module
|
||||
- Error: [domains][domains]
|
||||
- `Promise` returned
|
||||
- Completion: [onFulfilled][promise-onfulfilled] method called
|
||||
- Error: [onRejected][promise-onrejected] method called
|
||||
- `Observable` (e.g. from [RxJS v5][rxjs5-observable] or [RxJS v4][rxjs4-observable]) returned
|
||||
- Completion: [complete][rxjs5-observer-complete] method called
|
||||
- Error: [error][rxjs5-observer-error] method called
|
||||
|
||||
**Warning:** Sync tasks are **not supported** and your function will never complete if the one of the above strategies is not used to signal completion. However, thrown errors will be caught by the domain.
|
||||
|
||||
#### `callback(error, result)`
|
||||
|
||||
If an error doesn't occur in the execution of the `fn` function, the `callback` method will receive the results as its second argument. Note: Some streams don't received any results.
|
||||
|
||||
If an error occurred in the execution of the `fn` function, The `callback` method will receive an error as its first argument.
|
||||
|
||||
Errors can be caused by:
|
||||
|
||||
- A thrown error
|
||||
- An error passed to a `done` callback
|
||||
- An `error` event emitted on a returned `Stream`, `EventEmitter` or `Child Process`
|
||||
- A rejection of a returned `Promise` - If the `Promise` is not rejected with a value, we generate a new `Error`
|
||||
- The `onError` handler being called on an `Observable`
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
|
||||
<!-- prettier-ignore-start -->
|
||||
[downloads-image]: https://img.shields.io/npm/dm/async-done.svg?style=flat-square
|
||||
[npm-url]: https://www.npmjs.com/package/async-done
|
||||
[npm-image]: https://img.shields.io/npm/v/async-done.svg?style=flat-square
|
||||
|
||||
[ci-url]: https://github.com/gulpjs/async-done/actions?query=workflow:dev
|
||||
[ci-image]: https://img.shields.io/github/workflow/status/gulpjs/async-done/dev?style=flat-square
|
||||
|
||||
[coveralls-url]: https://coveralls.io/r/gulpjs/async-done
|
||||
[coveralls-image]: https://img.shields.io/coveralls/gulpjs/async-done/master.svg?style=flat-square
|
||||
<!-- prettier-ignore-end -->
|
||||
|
||||
<!-- prettier-ignore-start -->
|
||||
[end-of-stream]: https://www.npmjs.com/package/end-of-stream
|
||||
[domains]: http://nodejs.org/api/domain.html
|
||||
[event-stream]: https://github.com/dominictarr/event-stream
|
||||
[promise-onfulfilled]: http://promisesaplus.com/#point-26
|
||||
[promise-onrejected]: http://promisesaplus.com/#point-30
|
||||
[rxjs4-observable]: https://github.com/Reactive-Extensions/RxJS/blob/master/doc/api/core/observable.md
|
||||
[rxjs5-observable]: http://reactivex.io/rxjs/class/es6/Observable.js~Observable.html
|
||||
[rxjs5-observer-complete]: http://reactivex.io/rxjs/class/es6/MiscJSDoc.js~ObserverDoc.html#instance-method-complete
|
||||
[rxjs5-observer-error]: http://reactivex.io/rxjs/class/es6/MiscJSDoc.js~ObserverDoc.html#instance-method-error
|
||||
<!-- prettier-ignore-end -->
|
112
node_modules/async-done/index.d.ts
generated
vendored
Normal file
112
node_modules/async-done/index.d.ts
generated
vendored
Normal file
@ -0,0 +1,112 @@
|
||||
/**
|
||||
* Notes about these type definitions:
|
||||
*
|
||||
* - Callbacks returning multiple completion values using multiple arguments are not supported by these types.
|
||||
* Prefer to use Node's style by grouping your values in a single object or array.
|
||||
* Support for this kind of callback is blocked by Microsoft/TypeScript#5453
|
||||
*
|
||||
* - For ease of use, `asyncDone` lets you pass callback functions with a result type `T` instead of `T | undefined`.
|
||||
* This matches Node's types but can lead to unsound code being typechecked.
|
||||
*
|
||||
* The following code typechecks but fails at runtime:
|
||||
* ```typescript
|
||||
* async function getString(): Promise<string> {
|
||||
* return "Hello, World!";
|
||||
* }
|
||||
*
|
||||
* async function evilGetString(): Promise<string> {
|
||||
* throw new Error("Hello, World!");
|
||||
* }
|
||||
*
|
||||
* function cb(err: Error | null, result: string): void {
|
||||
* // This is unsound because `result` is `undefined` when `err` is not `null`.
|
||||
* console.log(result.toLowerCase());
|
||||
* }
|
||||
*
|
||||
* asyncDone(getString, cb); // Prints `hello, world!`
|
||||
* asyncDone(evilGetString, cb); // Runtime error: `TypeError: Cannot read property 'toLowerCase' of undefined`
|
||||
* ```
|
||||
*
|
||||
* Enforcing stricter callbacks would require developers to use `result?: string` and assert the existence
|
||||
* of the result either by checking it directly or using the `!` assertion operator after testing for errors.
|
||||
* ```typescript
|
||||
* function stricterCb1(err: Error | null, result?: string): void {
|
||||
* if (err !== null) {
|
||||
* console.error(err);
|
||||
* return;
|
||||
* }
|
||||
* console.log(result!.toLowerCase());
|
||||
* }
|
||||
*
|
||||
* function stricterCb2(err: Error | null, result?: string): void {
|
||||
* if (result === undefined) {
|
||||
* console.error("Undefined result. Error:);
|
||||
* console.error(err);
|
||||
* return;
|
||||
* }
|
||||
* console.log(result.toLowerCase());
|
||||
* }
|
||||
* ```
|
||||
*/
|
||||
import { ChildProcess } from 'child_process';
|
||||
import { EventEmitter } from 'events';
|
||||
import { Stream } from 'stream';
|
||||
|
||||
declare namespace asyncDone {
|
||||
/**
|
||||
* Represents a callback function used to signal the completion of a
|
||||
* task without any result value.
|
||||
*/
|
||||
type VoidCallback = (err: Error | null | void) => void;
|
||||
|
||||
/**
|
||||
* Represents a callback function used to signal the completion of a
|
||||
* task with a single result value.
|
||||
*/
|
||||
interface Callback<T> {
|
||||
(err: null, result: T): void;
|
||||
|
||||
// Use `result?: T` or `result: undefined` to require the consumer to assert the existence of the result
|
||||
// (even in case of success). See comment at the top of the file.
|
||||
(err: Error, result?: any): void;
|
||||
}
|
||||
|
||||
/**
|
||||
* Minimal `Observable` interface compatible with `async-done`.
|
||||
*
|
||||
* @see https://github.com/ReactiveX/rxjs/blob/c3c56867eaf93f302ac7cd588034c7d8712f2834/src/internal/Observable.ts#L77
|
||||
*/
|
||||
interface Observable<T = any> {
|
||||
subscribe(
|
||||
next?: (value: T) => void,
|
||||
error?: (error: any) => void,
|
||||
complete?: () => void
|
||||
): any;
|
||||
}
|
||||
|
||||
/**
|
||||
* Represents an async operation.
|
||||
*/
|
||||
export type AsyncTask<R = any> =
|
||||
| ((done: VoidCallback) => void)
|
||||
| ((done: Callback<R>) => void)
|
||||
| (() =>
|
||||
| ChildProcess
|
||||
| EventEmitter
|
||||
| Observable<R>
|
||||
| PromiseLike<R>
|
||||
| Stream);
|
||||
}
|
||||
|
||||
/**
|
||||
* Takes a function to execute (`fn`) and a function to call on completion (`callback`).
|
||||
*
|
||||
* @param fn Function to execute.
|
||||
* @param callback Function to call on completion.
|
||||
*/
|
||||
declare function asyncDone<R = any>(
|
||||
fn: asyncDone.AsyncTask<R>,
|
||||
callback: asyncDone.Callback<R>
|
||||
): void;
|
||||
|
||||
export = asyncDone;
|
85
node_modules/async-done/index.js
generated
vendored
Normal file
85
node_modules/async-done/index.js
generated
vendored
Normal file
@ -0,0 +1,85 @@
|
||||
'use strict';
|
||||
|
||||
var domain = require('domain');
|
||||
|
||||
var eos = require('end-of-stream');
|
||||
var once = require('once');
|
||||
var exhaust = require('stream-exhaust');
|
||||
|
||||
var eosConfig = {};
|
||||
|
||||
function rethrowAsync(err) {
|
||||
process.nextTick(rethrow);
|
||||
|
||||
function rethrow() {
|
||||
throw err;
|
||||
}
|
||||
}
|
||||
|
||||
function tryCatch(fn, args) {
|
||||
try {
|
||||
return fn.apply(null, args);
|
||||
} catch (err) {
|
||||
rethrowAsync(err);
|
||||
}
|
||||
}
|
||||
|
||||
function asyncDone(fn, cb) {
|
||||
cb = once(cb);
|
||||
|
||||
var d = domain.create();
|
||||
d.once('error', onError);
|
||||
var domainBoundFn = d.bind(fn);
|
||||
|
||||
function done() {
|
||||
d.removeListener('error', onError);
|
||||
d.exit();
|
||||
return tryCatch(cb, arguments);
|
||||
}
|
||||
|
||||
function onSuccess(result) {
|
||||
done(null, result);
|
||||
}
|
||||
|
||||
function onError(error) {
|
||||
if (!error) {
|
||||
error = new Error('Promise rejected without Error');
|
||||
}
|
||||
done(error);
|
||||
}
|
||||
|
||||
function asyncRunner() {
|
||||
var result = domainBoundFn(done);
|
||||
|
||||
function onNext(state) {
|
||||
onNext.state = state;
|
||||
}
|
||||
|
||||
function onCompleted() {
|
||||
onSuccess(onNext.state);
|
||||
}
|
||||
|
||||
if (result && typeof result.on === 'function') {
|
||||
// Assume node stream
|
||||
d.add(result);
|
||||
eos(exhaust(result), eosConfig, done);
|
||||
return;
|
||||
}
|
||||
|
||||
if (result && typeof result.subscribe === 'function') {
|
||||
// Assume RxJS observable
|
||||
result.subscribe(onNext, onError, onCompleted);
|
||||
return;
|
||||
}
|
||||
|
||||
if (result && typeof result.then === 'function') {
|
||||
// Assume promise
|
||||
result.then(onSuccess, onError);
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
process.nextTick(asyncRunner);
|
||||
}
|
||||
|
||||
module.exports = asyncDone;
|
71
node_modules/async-done/package.json
generated
vendored
Normal file
71
node_modules/async-done/package.json
generated
vendored
Normal file
@ -0,0 +1,71 @@
|
||||
{
|
||||
"name": "async-done",
|
||||
"version": "2.0.0",
|
||||
"description": "Allows libraries to handle various caller provided asynchronous functions uniformly. Maps promises, observables, child processes and streams, and callbacks to callback style.",
|
||||
"author": "Gulp Team <team@gulpjs.com> (https://gulpjs.com/)",
|
||||
"contributors": [
|
||||
"Blaine Bublitz <blaine.bublitz@gmail.com>",
|
||||
"Pawel Kozlowski <pkozlowski.opensource@gmail.com>",
|
||||
"Matthew Podwysocki <matthew.podwysocki@gmail.com>",
|
||||
"Charles Samborski <demurgos@demurgos.net>"
|
||||
],
|
||||
"repository": "gulpjs/async-done",
|
||||
"license": "MIT",
|
||||
"engines": {
|
||||
"node": ">= 10.13.0"
|
||||
},
|
||||
"main": "index.js",
|
||||
"types": "index.d.ts",
|
||||
"files": [
|
||||
"index.js",
|
||||
"index.d.ts",
|
||||
"LICENSE"
|
||||
],
|
||||
"scripts": {
|
||||
"lint": "eslint .",
|
||||
"pretest": "npm run lint",
|
||||
"test": "nyc mocha --async-only",
|
||||
"test-types": "tsc -p test/types"
|
||||
},
|
||||
"dependencies": {
|
||||
"end-of-stream": "^1.4.4",
|
||||
"once": "^1.4.0",
|
||||
"stream-exhaust": "^1.0.2"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/node": "^16.11.7",
|
||||
"eslint": "^7.32.0",
|
||||
"eslint-config-gulp": "^5.0.1",
|
||||
"eslint-plugin-node": "^11.1.0",
|
||||
"expect": "^27.3.1",
|
||||
"mocha": "^8.4.0",
|
||||
"nyc": "^15.1.0",
|
||||
"pumpify": "^2.0.1",
|
||||
"rxjs": "^7.4.0",
|
||||
"streamx": "^2.12.0",
|
||||
"through2": "^4.0.2",
|
||||
"typescript": "^4.4.4"
|
||||
},
|
||||
"nyc": {
|
||||
"reporter": [
|
||||
"lcov",
|
||||
"text-summary"
|
||||
]
|
||||
},
|
||||
"prettier": {
|
||||
"singleQuote": true
|
||||
},
|
||||
"keywords": [
|
||||
"promises",
|
||||
"callbacks",
|
||||
"observables",
|
||||
"streams",
|
||||
"end",
|
||||
"completion",
|
||||
"complete",
|
||||
"finish",
|
||||
"done",
|
||||
"async",
|
||||
"error handling"
|
||||
]
|
||||
}
|
Reference in New Issue
Block a user