@lakutata/core 1.0.60 → 3.0.0-beta.1

package/README.md

@@ -1,39 +1,189 @@
-<div style="text-align:center">
-	<img src="https://gitee.com/nnxr/lakutata-core/raw/master/assets/lakutata-banner.png" />
-</div>
+# @lakutata/core
 
-[![NPM Version](https://img.shields.io/npm/v/@lakutata/core?color=informational&style=flat-square)](https://npmjs.org/package/@lakutata/core)
-[![NODE Version](https://img.shields.io/node/v/@lakutata/core?color=informational&style=flat-square)](https://npmjs.org/package/@lakutata/core)
-[![Known Vulnerabilities](https://snyk.io/test/npm/@lakutata/core/badge.svg?style=flat-square)](https://snyk.io/test/npm/@lakutata/core)
-[![NPM Download](https://img.shields.io/npm/dm/@lakutata/core?style=flat-square)](https://npmjs.org/package/@lakutata/core)
+The core of the lakutata framework: the IoC container and dependency injection, the object model (`BaseObject`,
+`Component`, `Provider`, `Module`, `Application`) with its asynchronous construction and destruction, and the schema
+validation (`DTO`, built on joi) used by the decorators `@Configurable`, `@Expect`, `@Accept` and `@Return`.
 
-## TODO
+Most applications install the umbrella package `lakutata`, which re-exports this package (`lakutata`,
+`lakutata/decorator/di`, `lakutata/decorator/dto`, `lakutata/decorator/asst`, `lakutata/dtos`) and presets a pino `log`
+component and the `entrypoint` component. `@lakutata/core` alone is enough for a library or an application without
+them (it logs to the console then).
 
-- Write document for Lakutata
+## Installation
 
-## Features
+```shell
+npm install lakutata          # the framework
+npm install @lakutata/core    # or the core only
+```
+
+Node.js 22 or later, ESM (`"type": "module"`). The TypeScript options the decorators need:
+
+```json
+{
+  "compilerOptions": {
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  }
+}
+```
+
+## Usage
+
+### An application
+
+An application is a tree of objects created by its container. `Application.run()` validates its options, registers its
+components and providers, creates the objects listed in `bootstrap`, then calls `onLaunched`.
+
+```typescript
+import {Application, Component, DTO, type ILogger} from 'lakutata'
+import {Configurable, Inject} from 'lakutata/decorator/di'
+
+//A component: a singleton of the application, created when it is first needed (or by bootstrap)
+class Mailer extends Component {
+    //Its option, validated when it is created: given by the application options below
+    @Configurable(DTO.String().required())
+    protected readonly host: string
+
+    @Inject('log')
+    protected readonly log: ILogger
+
+    //Called once its injected objects and options are set
+    protected async init(): Promise<void> {
+        this.log.info('Mailer connected to %s', this.host)
+    }
+
+    public async send(to: string, text: string): Promise<void> {
+        this.log.info('Mail to %s: %s', to, text)
+    }
+
+    //Called when the application stops
+    protected async destroy(): Promise<void> {
+    }
+}
+
+Application
+    .run(() => ({
+        id: 'com.example.app',
+        name: 'Example',
+        components: {
+            mailer: {class: Mailer, host: 'smtp.example.com'}
+        },
+        bootstrap: ['mailer']
+    }))
+    .onLaunched(async (app: Application, log: ILogger): Promise<void> => {
+        const mailer: Mailer = await app.getObject('mailer')
+        await mailer.send('someone@example.com', 'Hello')
+        log.info('%s started', app.appName)
+    })
+    .onFatalException((error: Error, log: ILogger): void => log.error(error.message))
+```
+
+### Lifetimes
+
+| Decorator | One instance… | Default of |
+|---|---|---|
+| `@Singleton()` | per container | `Component` |
+| `@Scoped()` | per scope (`container.createScope()`, e.g. a request) | `Provider` (the controllers) |
+| `@Transient()` | per resolution | `BaseObject` |
+
+### Dependency injection
+
+`@Inject()` injects the object registered under the property name, `@Inject('name')` under another name,
+`@Inject(SomeClass)` an instance of a class (registered automatically when the class is marked `@Autoload()`). The
+injected objects are set before `init()` runs.
+
+### Validation
+
+A `DTO` subclass declares its fields with `@Expect(schema)`. The schemas are built by the static methods of `DTO`
+(`DTO.String()`, `DTO.Number()`, `DTO.Object()`, `DTO.Array()`, `DTO.Alternatives()`…, the joi API):
+
+```typescript
+import {DTO} from 'lakutata'
+import {Accept, Expect} from 'lakutata/decorator/dto'
+
+class CreateUserDTO extends DTO {
+    @Expect(DTO.String().email().required())
+    public email: string
+
+    @Expect(DTO.Number().integer().min(0).default(0))
+    public credit: number
+}
+
+class Users {
+    //The argument is validated (and its defaults applied) before the method runs
+    @Accept(CreateUserDTO.required())
+    public async create(input: CreateUserDTO): Promise<void> {
+    }
+}
+
+//Validated directly: the value with its defaults ({email: 'a@example.com', credit: 0}), InvalidValueException thrown
+//when it is invalid
+const input = await CreateUserDTO.validateAsync({email: 'a@example.com'})
+```
+
+### Tests and libraries: a container without an application
 
-- TODO
+```typescript
+import {Component, Container, DTO} from 'lakutata'
+import {Configurable} from 'lakutata/decorator/di'
 
-## Quickstart
+class Mailer extends Component {
+    @Configurable(DTO.String().required())
+    protected readonly host: string
 
-Follow the commands listed below.
+    public async send(to: string, text: string): Promise<string> {
+        return `${this.host} -> ${to}: ${text}`
+    }
+}
 
-```bash
-$ mkdir example && cd example
-$ TODO
+//Created with its options, its init() awaited
+const container: Container = new Container()
+const mailer: Mailer = await container.set(Mailer, {host: 'localhost'})
+await mailer.send('someone@example.com', 'Hello')
+//Destroys the objects it created
+await container.destroy()
 ```
 
-> Node.js >= 12.22.1 required.
+## API
 
-## Documentations
+| Export | Subpath | What it is |
+|---|---|---|
+| `Application` | `lakutata` | The application: `run()`, `env()`, `alias()`, `onLaunched()`, `onDone()`, `onFatalException()`, `getObject()`, `exit()` |
+| `Module` | `lakutata` | A group of components, providers and objects with its own container |
+| `Component` | `lakutata` | A singleton service with events (`emit`, `on`…) |
+| `Provider` | `lakutata` | A scoped object (one per scope) |
+| `BaseObject` | `lakutata` | The root class: asynchronous construction (`init`), destruction (`destroy`), `getObject` |
+| `Container` | `lakutata` | The IoC container: `set`, `get`, `getShared`, `register`, `createScope`, `destroy` |
+| `DTO` | `lakutata` | Validated data classes and the schema builders |
+| `Exception` | `lakutata` | The base of the exceptions of the framework (`errno`, `statusCode`) |
+| `isPackaged`, `resourcesPath` | `lakutata` | Whether the application runs packed, and its resources directory |
+| `registerValidationMessages`, `runInValidationLanguage`… | `lakutata` | The languages of the validation messages |
+| `Inject`, `Configurable`, `Autoload`, `Singleton`, `Scoped`, `Transient`, `Lifetime` | `lakutata/decorator/di` | Dependency injection and lifetimes |
+| `Expect`, `Accept`, `Return`, `IndexSignature` | `lakutata/decorator/dto` | DTO fields, method argument and return validation |
+| `Before`, `After` | `lakutata/decorator/asst` | Functions run before and after a method |
+| `PaginationSearchDTO`, `PaginationResultDTO`, `paginator`, `FlexibleDTO`, `toJsonSchema`, `fromJsonSchema` | `lakutata/dtos` | Pagination, open DTOs and JSON Schema conversion |
+| `ConsoleLogger`, `ILogger` | `lakutata/com/logger` | The logger interface and its console implementation |
 
-- TODO
+The typings document each declaration with examples.
 
-## How to Contribute
+## Errors
 
-Please let us know how can we help. Do check out [issues](https://gitee.com/nnxr/lakutata-core/issues) for bug reports or suggestions first.
+| Exception | Thrown when |
+|---|---|
+| `InvalidValueException` | A value does not match its schema (`DTO.validate`, `@Configurable`, `@Expect`) |
+| `InvalidMethodAcceptException`, `InvalidMethodReturnException` | The arguments (`@Accept`) or the result (`@Return`) of a method are invalid |
+| `DependencyInjectionException` | An injected object cannot be resolved |
+| `InvalidObjectOptionsException`, `InvalidObjectTypeException` | The options or the class of a declared object are invalid |
+| `LifetimeLockedException` | The lifetime of a class is changed after it was locked |
+| `ObjectDestroyedException` | A destroyed object is used |
+| `AliasExistsException`, `AliasNotFoundException`, `InvalidAliasNameException` | A path alias is declared twice, missing, or invalid |
+| `MethodNotFoundException` | A method called by name does not exist |
 
-## License
+## See also
 
-[MIT](LICENSE)
+- The guides: `doc/en/Core.md`, `doc/en/DTOValidation.md`, `doc/en/Decorator.md` of the package `lakutata` (Chinese
+  in `doc/zh`).
+- `@lakutata/entrypoint`: the controllers and their HTTP, CLI and service transports.
+- `@lakutata/logger`: the pino logger preset by `lakutata`.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,320 @@
+# Third-party notices
+
+Parts of `@lakutata/core` are derived from the third-party projects listed below. They are rewritten in
+TypeScript and modified; the original copyright notices and license terms are reproduced here as required.
+The files derived from these projects refer to "the upstream" in their header; the projects, versions and directories
+are listed in `src/lib/validation/engine/UPSTREAM.md`.
+
+## @hapi/hoek 11.0.7
+
+Used in `src/lib/validation/engine/utils` (subset of the library).
+
+Copyright (c) 2011-2022, Project contributors
+Copyright (c) 2011-2020, Sideway Inc
+Copyright (c) 2011-2014, Walmart
+Copyright (c) 2011, Yahoo Inc.
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* The names of any contributors may not be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS OFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+## @hapi/pinpoint 2.0.1
+
+Used in `src/lib/validation/engine/location`.
+
+Copyright (c) 2019-2020, Sideway. Inc, and project contributors  
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* The names of any contributors may not be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS OFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+## @hapi/formula 3.0.2
+
+Used in `src/lib/validation/engine/expression`.
+
+Copyright (c) 2019-2020, Sideway. Inc, and project contributors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+ * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+ * The names of any contributors may not be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+## @hapi/topo 6.0.2
+
+Used in `src/lib/validation/engine/sorter`.
+
+Copyright (c) 2012-2022, Project contributors
+Copyright (c) 2012-2020, Sideway Inc
+Copyright (c) 2012-2014, Walmart.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* The names of any contributors may not be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS OFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+## @hapi/tlds 1.1.4
+
+Used in `src/lib/validation/engine/tlds`.
+
+Copyright (c) 2019-2022, Sideway, Inc. and Project contributors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+ * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+ * The names of any contributors may not be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+## @hapi/address 5.1.1
+
+Used in `src/lib/validation/engine/address`.
+
+Copyright (c) 2019-2022, Sideway, Inc. and Project contributors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+ * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+ * The names of any contributors may not be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+## joi 18.0.2
+
+Used in `src/lib/validation/engine/schema`; the validation type declarations in `src/lib/validation/interfaces` and
+`src/lib/validation/types` are adapted from its `lib/index.d.ts`.
+
+Copyright (c) 2012-2022, Project contributors.
+Copyright (c) 2012-2022, Sideway. Inc.
+Copyright (c) 2012-2014, Walmart.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* The names of any contributors may not be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+## @softstack/joi-bigint 1.1.1
+
+Used in `src/lib/validation/engine/schema/extensions/bigint.ts`.
+
+Copyright (c) 2022 Softstack GmbH
+
+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.
+
+## joi-to-json 5.0.0
+
+Used in `src/lib/validation/engine/json-schema` (and its ported tests and test data).
+
+Copyright (c) 2020 Ken Chen
+
+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.
+
+## cron-validator 1.4.0
+
+Used in `src/lib/dto/internal/CronValidator.ts` (the validation of `DTO.Cron()`), from `lib/index.js`.
+
+Modifications: rewritten in TypeScript.
+
+MIT License
+
+Copyright (c) 2019 TheCloudConnectors
+
+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.
+
+## eventemitter2 6.4.9
+
+Used in `src/lib/base/internal/EventEmitter2.ts` (the events of the components), from `lib/eventemitter2.js`.
+
+Modifications: rewritten in TypeScript; the API used by the framework only (no `listenTo`, `waitFor` or cancelable
+promises); the nodes of the listener tree have no prototype; a listener both promisified and called in the next tick is
+called; `countAllListeners()` added.
+
+The MIT License (MIT)
+
+Copyright (c) 2016 Paolo Fragomeni <http://www.github.com/0x00a> and Contributors
+
+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.
+
+## combinations 1.0.0
+
+Used in `src/lib/validation/engine/json-schema/combinations.ts`.
+
+Author: Greg Allen (per the package metadata, which declares the MIT license; the package ships no license file).
+
+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.
+
+## lodash 4.17.21
+
+The semantics (and, for merge, the algorithm) of the lodash functions used by joi-to-json are reimplemented in
+`src/lib/validation/engine/json-schema/helpers.ts`.
+
+Copyright OpenJS Foundation and other contributors <https://openjsf.org/>
+
+Based on Underscore.js, copyright Jeremy Ashkenas,
+DocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>
+
+This software consists of voluntary contributions made by many
+individuals. For exact contribution history, see the revision history
+available at https://github.com/lodash/lodash
+
+The following license applies to all parts of this software except as
+documented below:
+
+====
+
+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.
+
+====
+
+Copyright and related rights for sample code are waived via CC0. Sample
+code is defined as all source code displayed within the prose of the
+documentation.
+
+CC0: http://creativecommons.org/publicdomain/zero/1.0/
+
+====
+
+Files located in the node_modules and vendor directories are externally
+maintained libraries used by this software which have their own
+licenses; we recommend you read them, as their terms may differ from the
+terms above.
+
+## @hapi/code 9.0.3
+
+Used in `src/tests/engine/support` (test assertion library only).
+
+Copyright (c) 2014-2022, Project contributors
+Copyright (c) 2014-2020, Sideway Inc
+Copyright (c) 2014, Walmart
+Copyright (c) 2011-2014 Jake Luer
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* The names of any contributors may not be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS OFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+## deep-eql
+
+A code fragment of `src/lib/validation/engine/utils/deepEqual.ts` (identity comparison of zero values) is copied
+from deep-eql, copyright (c) 2013 Jake Luer, jake@alogicalparadox.com, MIT Licensed, https://github.com/chaijs/deep-eql

package/dist/cjs/components/ConsoleLogger.d.ts

@@ -0,0 +1,62 @@
+import { Component } from '../lib/core/Component.js';
+import { ILogger } from '../interfaces/ILogger.js';
+/**
+ * The logger of a core-only application, writing plain lines to the console:
+ * `[<ISO time>] <LEVEL> (<application name>): <message>`, formatted as `util.format()` (an object given before its
+ * message is written after it); the warnings and errors to stderr, the other levels to stdout. The application uses it
+ * when it has no `log` component; register it as `log` to configure its level. The `lakutata` package replaces it with
+ * its Logger component.
+ * @example
+ * ```typescript
+ * import {Application} from 'lakutata'
+ * import {ConsoleLogger} from '@lakutata/core/com/logger'
+ *
+ * Application.run({
+ *     id: 'tool.app',
+ *     name: 'Tool',
+ *     components: {
+ *         log: {class: ConsoleLogger, level: 'debug'}
+ *     }
+ * }).onLaunched((app, logger): void => logger.debug({pid: process.pid}, 'Launched'))
+ * ```
+ */
+export declare class ConsoleLogger extends Component implements ILogger {
+    /**
+     * The lowest level written: `trace`, `debug`, `info`, `warn`, `error`, or `silent` for none.
+     * @default 'info'
+     * @protected
+     */
+    protected readonly level: string;
+    /**
+     * Write a log line, unless its level is below the configured one.
+     * @param level The level of the line (`trace`, `debug`, `info`, `warn`, `error`).
+     * @param args An object (or error) and its message, or a message and its format arguments.
+     * @protected
+     */
+    protected write(level: string, args: unknown[]): void;
+    /**
+     * Log an error to stderr.
+     * @param args An object (or error) and its message, or a message and its format arguments.
+     */
+    error(...args: any[]): void;
+    /**
+     * Log a warning to stderr.
+     * @param args An object (or error) and its message, or a message and its format arguments.
+     */
+    warn(...args: any[]): void;
+    /**
+     * Log an information to stdout.
+     * @param args An object (or error) and its message, or a message and its format arguments.
+     */
+    info(...args: any[]): void;
+    /**
+     * Log a debugging detail to stdout (written when the level is `debug` or `trace`).
+     * @param args An object (or error) and its message, or a message and its format arguments.
+     */
+    debug(...args: any[]): void;
+    /**
+     * Log a tracing detail to stdout (written when the level is `trace`).
+     * @param args An object (or error) and its message, or a message and its format arguments.
+     */
+    trace(...args: any[]): void;
+}