@decaf-ts/for-couchdb 0.3.13 → 0.3.15

package/LICENSE.md

@@ -1,75 +1,165 @@
-MIT License
+Mozilla Public License Version 2.0
 
 Copyright (c) 2025 Tiago Venceslau 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:
+1. Definitions
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+"Contributor"
+    means each individual or legal entity that creates, contributes to the
+    creation of, or owns Covered 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.
+"Contributor Version"
+    means the combination of the Contributions of others (if any) used by a
+    Contributor and that particular Contributor's Contribution.
+
+"Covered Software"
+    means Source Code Form to which the initial Contributor has attached the
+    notice in Exhibit A, the executables produced from that Source Code Form,
+    and modifications of such Source Code Form, in each case including the
+    files distributed with such Source Code Form.
+
+"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.
 
----
+"License"
+    means this document.
 
-## Section 2. AGPL Trigger: AI-Generated Code Usage
+"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.
 
-If this software is incorporated into a product, service, or system that **uses AI generation of code**, then instead of MIT, the software is governed by the **GNU Affero General Public License v3.0 (AGPL-3.0)**, *in full*.
+"Modifications"
+    means any addition to or deletion from the contents of Covered Software
+    or any new file that contains any Covered Software.
 
-**What “Uses AI generation of code” means (any of the following):**  
-1. The product uses AI to automatically generate **Decaf-TS front-end or back-end code**.  
-2. The product incorporates AI tools, pipelines, or workflows where **Decaf-TS code is generated** automatically or on demand.  
-3. Usage via **Decaf MCP** or any equivalent integration which enables AI-driven Decaf-TS code generation.  
-4. The product uses **Decaf-TS to dynamically generate UI** for AI agent conversation systems (chat, multimodal, interactive).  
-5. The product uses this software plus AI to generate software **“at scale”** (e.g. via automated bulk pipelines, continuous generation).  
-6. The product or service commercializes or sells software, tools, or applications **that were generated by AI using this software**.
+"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.
 
-**Clarifications & Exceptions (these do *not* trigger AGPL):**  
-- If AI is used only during **development time** (e.g. a developer uses AI + Decaf tooling as an assistant, writes or reviews code, then commits)—this **does not** count as “uses AI generation of code” in Section 2.  
-- If a company builds a **Decaf-based product** using AI internally, but the **resulting product does not itself dynamically generate additional Decaf code**, then Section 2 is **not triggered**.  
-- If a company builds a **Decaf-based product** using AI internally, and while the **resulting product does generate it's UI dynamically via Decaf, the product does not itself dynamically generate additional Decaf code as a service**, then Section 2 is **not triggered**.
+"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 all other cases meeting the six trigger conditions above, the software is subject to AGPL-3.0 — you must comply with all AGPL obligations (source disclosure, network interaction clause, etc.)
+"Source Code Form"
+    means the form of the work preferred for making modifications.
 
-## Section 3. Reference to AGPL
+"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.
 
-The full text of the GNU Affero General Public License v3.0 is available from the Free Software Foundation at:  
-https://www.gnu.org/licenses/agpl-3.0.html
+2. License Grants and Conditions
 
----
+Each Contributor hereby grants You a world-wide, royalty-free, non-exclusive
+license:
 
-## Notes & Examples (for clarity)
+  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
 
-- A CLI tool that helps you scaffold Decaf code locally (without runtime AI generation) remains under MIT.  
-- A web service that uses AI at runtime to produce new Decaf UI or backend code for users must operate under AGPL.  
-- A SaaS product that sells modules generated via AI using this software falls under AGPL.  
-- Internal use or development with AI suggestions, without dynamic generation in the delivered product, is under MIT.
+  b. under Patent Claims infringed by the making, using, or selling of
+     Contributions made by that Contributor alone or jointly with others;
+     provided that You agree to the terms of this License.
 
----
+This license does not grant any rights in the trademarks, service marks, or
+logos of any Contributor (except as may be necessary to comply with the
+notice requirements in Section 3.4).
 
-**Legal disclaimers, warranty, and liability** follow the same as in MIT or AGPL as applicable.  
+3. Distribution Obligations
 
----
+3.1. Distribution of Source Form
 
-### Why this is more “bullet-proof” (improvements over earlier drafts)
+All distribution of Covered Software in Source Code Form, including any
+Modifications that You create or to which You contribute, must be made under
+this License. You must inform recipients that the Source Code Form of the
+Covered Software is governed by the terms of this License, and include a copy
+of this License in or with the Source Code Form.
 
-- The **trigger conditions** are enumerated and explicit (six bullet points).  
-- The **exceptions** are limited and clearly stated (development-time, non-code-generating product).  
-- We embed the MIT text fully (so recipients see their rights).  
-- We **link to the full AGPL** rather than embed it (keeping the file manageable) but still make it binding by reference.  
-- We include a **Notes & Examples** section to show boundary cases and reduce ambiguity.  
-- The style is more “plain English + structured” (like n8n’s) to reduce misinterpretation.  
+3.2. Distribution of Executable Form
 
----
+If You distribute Covered Software in Executable Form then:
 
-If you like, I can generate this as a **downloadable `LICENSE.md` file** for you right away, so you can drop it in your repo. Would you like me to do that?
+  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; and that You do
+     not add any further restrictions to the rights granted by 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 resulting work as a single product. In
+order to do so, you must ensure the terms of this License are maintained for
+any Covered Software contained within the Larger Work. If the Larger Work is
+distributed in Executable Form containing Covered Software, then the Source
+Code Form containing the Covered Software must be made available under the
+terms of this License, and You must ensure the license notice described in
+Exhibit A is included with the Source Code Form.
+
+3.4. Notices
+
+You must cause each file that you distribute containing Covered Software to
+carry a legal notice stating that you have changed the file (if you have) and
+including at least the ownership and license notice required by Exhibit A.
+
+4. 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 insofar as the Secondary
+License grants additional permissions. If the Covered Software is not made
+available under a Secondary License, then this License fully governs its use.
+
+5. Disclaimer of Warranty
+
+Covered Software is provided "as is". Contributors disclaim all warranties
+and conditions, express or implied, including, without limitation, any
+implied warranties of merchantability, fitness for a particular purpose, or
+non-infringement.
+
+6. Limitation of Liability
+
+Except to the extent required by applicable law, in no event will any
+Contributor be liable for any damages arising out of or in connection with
+this License or the use or inability to use the Covered Software, even if
+advised of the possibility of such damages.
+
+7. Termination
+
+This License will terminate automatically if You fail to comply with its
+terms. However, if you cease all activities that violate the License, then
+any patent license(s) granted by a Contributor which have been terminated
+under this section will automatically reinstate if you resume compliance.
+
+8. Miscellaneous
+
+This License represents the complete agreement concerning 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. The headings are for convenience only and do not affect
+interpretation.
+
+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,4 +1,4 @@
-![Banner](./workdocs/assets/Banner.png)
+![Banner](./workdocs/assets/decaf-logo.svg)
 
 # Decaf CouchDB Module
 
@@ -415,6 +415,24 @@ const indexName = generateIndexName('email', 'users', ['firstName'], 'asc');
 ```
 
 
+## 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)
@@ -458,6 +476,6 @@ So if you can, if this project in any way. either by learning something or simpl
 
 ## License
 
-This project is released under MIT with an AGPL-3.0 trigger for AI-generated code usage; MIT covers standard development, but AI-driven Decaf code generation activates full AGPL obligations—see [LICENSE.md](./LICENSE.md) for full terms.
+This project is released under the [Mozilla Public License 2.0](./LICENSE.md).
 
 By developers, for developers...