@decaf-ts/core 0.5.42 → 0.5.43

package/LICENSE.md

@@ -1,22 +1,190 @@
-MIT License
+Mozilla Public License Version 2.0
 
-Copyright (c) 2025 Tiago Venceslau and Contributors
+1.0. Definitions
 
-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:
+1.1. "Contributor"
+    means each individual or legal entity that creates, contributes to the
+    creation of, or owns Covered Software.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+1.2. "Contributor Version"
+    means the combination of the Contributions of others (if any) used by a
+    Contributor and that particular Contributor's Contribution.
 
-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.
+1.3. "Covered Software"
+    means Source Code Form to which the initial Contributor has attached the
+    notice in Exhibit A, the Executable Form of such Source Code Form, and
+    Modifications of such Source Code Form.
 
+1.4. "Incompatible With Secondary Licenses"
+    means that the initial Contributor has attached the notice described in
+    Exhibit B to the Covered Software; the Covered Software is therefore
+    governed by the terms of this License without the option for the
+    additional permissions of a Secondary License.
+
+1.5. "Executable Form"
+    means any form of the work other than Source Code Form.
+
+1.6. "Larger Work"
+    means a work which combines Covered Software with other material, in a
+    separate file or files, that is not Covered Software.
+
+1.7. "License"
+    means this document.
+
+1.8. "Licensable"
+    means having the right to grant, to the maximum extent possible, whether
+    at the time of the making or afterwards, any and all of the rights
+    conveyed by this License.
+
+1.9. "Modifications"
+    means any addition to or deletion from the contents of Covered Software
+    or any new file that contains Covered Software.
+
+1.10. "Patent Claims"
+    means any patent claim(s), now owned or hereafter acquired, including
+    without limitation, method, process, and apparatus claims, in any patent
+    Licensable by grantor.
+
+1.11. "Secondary License"
+    means either the GNU General Public License, Version 2.0, the GNU Lesser
+    General Public License, Version 2.1, or any subsequent versions of those
+    licenses that are designated as a Secondary License in the notice in
+    Exhibit A.
+
+1.12. "Source Code Form"
+    means the form of the work preferred for making modifications.
+
+1.13. "You" (or "Your")
+    means an individual or a legal entity exercising rights under, and
+    complying with all of the terms of, this License. For legal entities,
+    "You" includes any entity that controls, is controlled by, or is under
+    common control with You. For purposes of this definition, "control"
+    means (a) the power, direct or indirect, to cause the direction or
+    management of such entity, whether by contract or otherwise, or (b)
+    ownership of more than fifty percent (50%) of the outstanding shares or
+    beneficial ownership of such entity.
+
+2.0. License Grants and Conditions
+
+2.1. Grants
+
+Each Contributor hereby grants You a world-wide, royalty-free, non-exclusive
+license:
+
+  a. under intellectual property rights (other than patent or trademark)
+     Licensable by such Contributor to use, reproduce, make available,
+     modify, display, perform, distribute, and otherwise exploit its
+     Contributions, either on an exclusive or non-exclusive basis; and
+
+  b. under Patent Claims to make, use, sell, offer for sale, have made,
+     import, and otherwise transfer the Contribution(s) of such
+     Contributor, if any, in the Covered Software.
+
+2.2. Effective Date
+
+The licenses granted in Section 2.1 are effective on the date the Contributor
+first makes the Covered Software available under this License.
+
+2.3. Limitations on the Grants
+
+The licenses granted in this Section 2 are subject to the following
+limitations:
+
+  a. No trademark rights are granted under this License.
+
+  b. This License does not grant any rights in the patents of any
+     Contributor except as expressly stated in Section 2.1(b).
+
+3.0. Distribution Obligations
+
+3.1. Distribution of Source Form
+
+All distribution of Covered Software in Source Code Form, including any
+Modifications that You create or to which You contribute, must be under the
+terms of this License. You must inform recipients that the Source Code Form
+of the Covered Software is subject to the terms of this License and include
+a copy of this License in or with the Source Code Form.
+
+3.2. Distribution of Executable Form
+
+If You distribute Covered Software in Executable Form then:
+
+  a. such Covered Software must also be made available in Source Code Form,
+     as described in Section 3.1, and You must inform recipients of the
+     Executable Form how to obtain a complete copy of the corresponding
+     Source Code Form in a reasonable manner on or through a medium
+     customarily used for software exchange; and
+
+  b. You may distribute the Executable Form under terms of your choice,
+     provided that You do not attempt to limit or alter the recipients'
+     rights in the Source Code Form under this License.
+
+3.3. Distribution of a Larger Work
+
+You may create and distribute a work that combines Covered Software with
+other material, and distribute the Larger Work as a single product. In such
+case, the Covered Software must still be made available under this License
+and must include the notices described in Exhibit A relating to the Covered
+Software.
+
+3.4. Notices
+
+You must cause each file that You distribute containing Covered Software to
+carry the legal notices described in Exhibit A.
+
+4.0. Incompatible With Secondary Licenses
+
+If the Covered Software is made available under the terms of this License
+and also made available under the terms of a Secondary License, then the
+terms of the Secondary License apply to the Covered Software in addition to
+this License to the extent the Secondary License grants additional
+permissions. If the Covered Software is not made available under a Secondary
+License, then this License governs its use.
+
+5.0. Disclaimer of Warranty
+
+Covered Software is provided "as is" without warranty of any kind, either
+express or implied, including, but not limited to, the implied warranties of
+merchantability, fitness for a particular purpose, and noninfringement.
+
+6.0. Limitation of Liability
+
+In no event and under no legal theory, whether in tort (including
+negligence), contract, or otherwise, unless required by applicable law (such
+as deliberate and grossly negligent acts) or agreed to in writing, shall any
+Contributor be liable to You for damages, including any direct, indirect,
+special, incidental, or consequential damages of any character arising as a
+result of this License or out of the use or inability to use the Covered
+Software (including but not limited to damages for loss of goodwill, work
+stoppage, computer failure or malfunction, or any and all other commercial
+damages or losses), even if such Contributor has been advised of the
+possibility of such damages.
+
+7.0. Termination
+
+7.1. Termination for Breach
+
+This License and the rights granted hereunder will terminate automatically
+if You fail to comply with terms of this License and do not cure such
+breach within thirty (30) days of becoming aware of the breach.
+
+7.2. Effect of Termination
+
+Upon termination of this License, any rights granted to You under this
+License will terminate, and You must cease all use and distribution of the
+Covered Software except as permitted by applicable law.
+
+8.0. Miscellaneous
+
+This License constitutes the entire agreement between the parties with
+respect to the subject matter hereof. If any provision of this License is
+held to be unenforceable, that provision shall be reformed only to the
+extent necessary to make it enforceable.
+
+Exhibit A - Source Code Form License Notice
+
+  This Source Code Form is subject to the terms of the Mozilla Public
+  License, v. 2.0. If a copy of the MPL was not distributed with this
+  file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+  Copyright (c) 2025 Tiago Venceslau and Contributors

package/README.md

@@ -1,8 +1,9 @@
+![Banner](./workdocs/assets/decaf-logo.svg)
+
 # Decaf TS — Core Package
 
 Decaf Core provides the foundational building blocks for the Decaf TypeScript ecosystem: strongly-typed models, repository pattern, pluggable persistence adapters, a composable query DSL, and pagination/observer utilities. With decorators and an injectable registry, it wires models to repositories and adapters so you can build data access that is framework-agnostic yet fully typed.
 
-
 ![Licence](https://img.shields.io/github/license/decaf-ts/core.svg?style=plastic)
 ![GitHub language count](https://img.shields.io/github/languages/count/decaf-ts/core?style=plastic)
 ![GitHub top language](https://img.shields.io/github/languages/top/decaf-ts/core?style=plastic)
@@ -26,6 +27,8 @@ Decaf Core provides the foundational building blocks for the Decaf TypeScript ec
 
 Documentation [here](https://decaf-ts.github.io/injectable-decorators/), Test results [here](https://decaf-ts.github.io/injectable-decorators/workdocs/reports/html/test-report.html) and Coverage [here](https://decaf-ts.github.io/injectable-decorators/workdocs/reports/coverage/lcov-report/index.html)
 
+Minimal size: 13.3 KB kb gzipped
+
 
 # Core Package — Detailed Description
 
@@ -338,6 +341,24 @@ async function injectablesExample() {
 ```
 
 
+## Coding Principles
+
+- group similar functionality in folders (analog to namespaces but without any namespace declaration)
+- one class per file;
+- one interface per file (unless interface is just used as a type);
+- group types as other interfaces in a types.ts file per folder;
+- group constants or enums in a constants.ts file per folder;
+- group decorators in a decorators.ts file per folder;
+- always import from the specific file, never from a folder or index file (exceptions for dependencies on other packages);
+- prefer the usage of established design patters where applicable:
+  - Singleton (can be an anti-pattern. use with care);
+  - factory;
+  - observer;
+  - strategy;
+  - builder;
+  - etc;
+
+
 ### Related
 
 [![decaf-ts](https://github-readme-stats.vercel.app/api/pin/?username=decaf-ts&repo=decaf-ts)](https://github.com/decaf-ts/decaf-ts)
@@ -377,6 +398,6 @@ So if you can, if this project in any way. either by learning something or simpl
 
 ## License
 
-This project is released under the [MIT License](./LICENSE.md).
+This project is released under the [Mozilla Public License 2.0](./LICENSE.md).
 
 By developers, for developers...