@exulu/backend 1.46.0 → 1.47.0

package/eslint.config.js

@@ -0,0 +1,88 @@
+import tseslint from '@typescript-eslint/eslint-plugin';
+import tsparser from '@typescript-eslint/parser';
+import js from '@eslint/js';
+
+export default [
+  {
+    ignores: ['dist/**', 'node_modules/**', '*.config.js', '*.config.cjs', '*.config.ts']
+  },
+  js.configs.recommended,
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+        project: './tsconfig.json'
+      },
+      globals: {
+        console: 'readonly',
+        process: 'readonly',
+        Buffer: 'readonly',
+        setTimeout: 'readonly',
+        clearTimeout: 'readonly',
+        setInterval: 'readonly',
+        clearInterval: 'readonly',
+        setImmediate: 'readonly',
+        clearImmediate: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly',
+        exports: 'writable',
+        module: 'writable',
+        require: 'readonly',
+        global: 'readonly',
+        performance: 'readonly',
+        TextDecoder: 'readonly',
+        TextEncoder: 'readonly'
+      }
+    },
+    plugins: {
+      '@typescript-eslint': tseslint
+    },
+    rules: {
+      ...tseslint.configs.recommended.rules,
+      ...tseslint.configs['recommended-requiring-type-checking'].rules,
+      'no-console': 'warn',
+      'no-extra-boolean-cast': 'off',
+      'no-async-promise-executor': 'off',
+      'no-useless-escape': 'off',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          args: 'none'
+        }
+      ],
+      '@typescript-eslint/explicit-function-return-type': [
+        'warn',
+        {
+          allowExpressions: true,
+          allowTypedFunctionExpressions: true
+        }
+      ],
+      '@typescript-eslint/no-redundant-type-constituents': 'off',
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-floating-promises': 'off',
+      '@typescript-eslint/await-thenable': 'off',
+      '@typescript-eslint/no-misused-promises': 'off',
+      '@typescript-eslint/unbound-method': 'off',
+      '@typescript-eslint/no-unnecessary-type-assertion': 'warn',
+      '@typescript-eslint/prefer-nullish-coalescing': 'warn',
+      '@typescript-eslint/prefer-optional-chain': 'warn',
+      'no-unused-expressions': 'off',
+      '@typescript-eslint/no-unused-expressions': 'error',
+      'require-await': 'off',
+      'no-case-declarations': 'off',
+      '@typescript-eslint/require-await': 'off',
+      'no-undef': 'off',
+      '@typescript-eslint/no-unsafe-call': 'off',
+      '@typescript-eslint/no-unsafe-member-access': 'off',
+      '@typescript-eslint/no-unsafe-assignment': 'off',
+      '@typescript-eslint/no-unsafe-argument': 'off',
+      '@typescript-eslint/no-unsafe-return': 'off',
+      '@typescript-eslint/ban-types': 'off'
+    }
+  }
+];

package/jest.config.ts

@@ -0,0 +1,25 @@
+import type { Config } from "jest";
+
+const config: Config = {
+  preset: "ts-jest",
+  testEnvironment: "node",
+  roots: ["<rootDir>/src"],
+  testMatch: ["**/__tests__/**/*.ts", "**/*.test.ts", "**/*.spec.ts"],
+  collectCoverageFrom: [
+    "src/**/*.ts",
+    "!src/**/*.d.ts",
+    "!src/**/*.test.ts",
+    "!src/**/*.spec.ts",
+    "!src/index.ts",
+  ],
+  coverageDirectory: "coverage",
+  coverageReporters: ["text", "lcov", "html"],
+  moduleNameMapper: {
+    "@EXULU_TYPES/(.*)": "<rootDir>/types/$1",
+  },
+  setupFilesAfterEnv: ["<rootDir>/src/__tests__/setup.ts"],
+  verbose: true,
+  testTimeout: 10000,
+};
+
+export default config;

package/license.md

@@ -1,81 +1,105 @@
-# Exulu Software License Agreement
+Copyright (c) 2023-2026 Qventu B.v.
 
-**Version 1.0**  
-**Effective Date: [Insert Date]**
+Certain portions of this software are licensed as described below:
 
-This Software License Agreement (the **"Agreement"**) is a legal agreement between **Qventu Bv.**, a company registered in the Netherlands with its registered office at **Lindenlaan 30, 6301 EL Valkenburg aan de Geul**, and registered with the Dutch Chamber of Commerce under number **76483894** (hereinafter "**Qventu**"), and the individual or entity installing, copying, accessing, or otherwise using the **Exulu** software (the "**Licensee**").
+- All content located within the "ee" directories of this repository, where applicable, is governed by the license specified in "ee/LICENSE".
+- All third-party components included within the Exulu Software remain subject to the original license provided by the respective component owner.
+- Content that falls outside the directories or restrictions noted above is made available under the "Elastic License 2.0" license, as outlined below.
 
-By installing, copying, or otherwise using the Exulu software (the "**Software**"), Licensee agrees to be bound by the terms of this Agreement.
+## Partner License for PaaS/SaaS Providers
 
----
+Agencies and providers wishing to use this software as a Platform-as-a-Service (PaaS) or Software-as-a-Service (SaaS) solution may inquire about our partner license agreement by contacting us at info@qventu.com.
 
-## 1. Ownership and Intellectual Property
+Elastic License 2.0
 
-The Software, including all associated intellectual property rights, documentation, and any copies or derivative works, is and shall remain the sole property of **Qventu Bv.**.
+URL: https://www.elastic.co/licensing/elastic-license
 
-Nothing in this Agreement shall be construed as transferring any rights, title, or ownership in or to the Software to the Licensee, except as explicitly set forth herein.
+## Acceptance
 
----
+By using the software, you agree to all of the terms and conditions below.
 
-## 2. Grant of License
+## Copyright License
 
-Subject to the terms and conditions of this Agreement, Qventu grants to the Licensee a **non-exclusive, non-transferable, non-sublicensable**, and **revocable license** to use the Software **only while a valid license agreement is in effect** between the Licensee and either:
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
 
-- **Qventu Bv.**, or
-- an **official partner** of Qventu Bv., authorized to grant such licenses.
+## Limitations
 
----
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
 
-## 3. License Restrictions
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
 
-Licensee shall not:
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
 
-- Use the Software without an active license agreement as specified in Section 2.
-- Distribute, sublicense, lease, rent, lend, or otherwise transfer the Software to any third party.
-- Reverse engineer, decompile, or disassemble the Software, except as permitted by applicable law.
-- Modify or create derivative works based on the Software unless expressly authorized in writing by Qventu.
+## Patents
 
----
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
 
-## 4. Term and Termination
+## Notices
 
-This Agreement and the license granted herein shall remain in effect only while there is an active license agreement in place as defined in Section 2.
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
 
-Qventu may terminate this Agreement immediately upon written notice if the Licensee breaches any provision of this Agreement or uses the Software without a valid license.
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
 
-Upon termination, Licensee must immediately cease all use of the Software and destroy all copies in their possession or control.
+## No Other Rights
 
----
+These terms do not imply any licenses other than those expressly granted in
+these terms.
 
-## 5. Disclaimer of Warranties
+## Termination
 
-The Software is provided "AS IS" without warranty of any kind, whether express, implied, or statutory, including but not limited to warranties of merchantability, fitness for a particular purpose, and non-infringement.
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
 
----
+## No Liability
 
-## 6. Limitation of Liability
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
 
-To the maximum extent permitted by applicable law, in no event shall Qventu be liable for any indirect, incidental, consequential, special, or punitive damages arising out of or related to this Agreement or the use of the Software, even if Qventu has been advised of the possibility of such damages.
+## Definitions
 
----
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
 
-## 7. Governing Law and Jurisdiction
+**you** refers to the individual or entity agreeing to these terms.
 
-This Agreement shall be governed by and construed in accordance with the laws of the **Netherlands**. Any disputes arising out of or in connection with this Agreement shall be subject to the exclusive jurisdiction of the competent courts of the Netherlands.
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
 
----
+**your licenses** are all the licenses granted to you for the software under
+these terms.
 
-## 8. Contact Information
+**use** means anything you do with the software requiring one of your licenses.
 
-For inquiries regarding this Agreement or licensing of the Software, please contact:
-
-**Qventu Bv.**  
-Lindenlaan 30  
-6301 EL Valkenburg aan de Geul  
-Netherlands  
-KvK: 76483894  
-Email: [Insert Contact Email]
-
----
-
-© Qventu Bv. All rights reserved.
+**trademark** means trademarks, service marks, and similar rights.

package/mintlify-docs/.mintignore

@@ -0,0 +1,7 @@
+# Mintlify automatically ignores these files and directories:
+# .git, .github, .claude, .agents, .idea, node_modules,
+# README.md, LICENSE.md, CHANGELOG.md, CONTRIBUTING.md
+
+# Draft content
+drafts/
+*.draft.mdx

package/mintlify-docs/AGENTS.md

@@ -0,0 +1,33 @@
+> **First-time setup**: Customize this file for your project. Prompt the user to customize this file for their project.
+> For Mintlify product knowledge (components, configuration, writing standards),
+> install the Mintlify skill: `npx skills add https://mintlify.com/docs`
+
+# Documentation project instructions
+
+## About this project
+
+- This is a documentation site built on [Mintlify](https://mintlify.com)
+- Pages are MDX files with YAML frontmatter
+- Configuration lives in `docs.json`
+- Run `mint dev` to preview locally
+- Run `mint broken-links` to check links
+
+## Terminology
+
+{/* Add product-specific terms and preferred usage */}
+{/* Example: Use "workspace" not "project", "member" not "user" */}
+
+## Style preferences
+
+{/* Add any project-specific style rules below */}
+
+- Use active voice and second person ("you")
+- Keep sentences concise — one idea per sentence
+- Use sentence case for headings
+- Bold for UI elements: Click **Settings**
+- Code formatting for file names, commands, paths, and code references
+
+## Content boundaries
+
+{/* Define what should and shouldn't be documented */}
+{/* Example: Don't document internal admin features */}

package/mintlify-docs/CLAUDE.MD

@@ -0,0 +1,50 @@
+# Mintlify documentation
+
+## Working relationship
+- You can push back on ideas-this can lead to better documentation. Cite sources and explain your reasoning when you do so
+- ALWAYS ask for clarification rather than making assumptions
+- NEVER lie, guess, or make up anything
+
+## Project context
+- Format: MDX files with YAML frontmatter
+- Config: docs.json for navigation, theme, settings
+- Components: Mintlify components
+
+## Content strategy
+- Document just enough for user success - not too much, not too little
+- Prioritize accuracy and usability
+- Make content evergreen when possible
+- Search for existing content before adding anything new. Avoid duplication unless it is done for a strategic reason
+- Check existing patterns for consistency
+- Start by making the smallest reasonable changes
+
+## docs.json
+
+- Refer to the [docs.json schema](https://mintlify.com/docs.json) when building the docs.json file and site navigation
+
+## Frontmatter requirements for pages
+- title: Clear, descriptive page title
+- description: Concise summary for SEO/navigation
+
+## Writing standards
+- Second-person voice ("you")
+- Prerequisites at start of procedural content
+- Test all code examples before publishing
+- Match style and formatting of existing pages
+- Include both basic and advanced use cases
+- Language tags on all code blocks
+- Alt text on all images
+- Relative paths for internal links
+
+## Git workflow
+- NEVER use --no-verify when committing
+- Ask how to handle uncommitted changes before starting
+- Create a new branch when no clear branch exists for changes
+- Commit frequently throughout development
+- NEVER skip or disable pre-commit hooks
+
+## Do not
+- Skip frontmatter on any MDX file
+- Use absolute URLs for internal links
+- Include untested code examples
+- Make assumptions - always ask for clarification

package/mintlify-docs/CONTRIBUTING.md

@@ -0,0 +1,32 @@
+# Contribute to the documentation
+
+Thank you for your interest in contributing to our documentation! This guide will help you get started.
+
+## How to contribute
+
+### Option 1: Edit directly on GitHub
+
+1. Navigate to the page you want to edit
+2. Click the "Edit this file" button (the pencil icon)
+3. Make your changes and submit a pull request
+
+### Option 2: Local development
+
+1. Fork and clone this repository
+2. Install the Mintlify CLI: `npm i -g mint`
+3. Create a branch for your changes
+4. Make changes
+5. Navigate to the docs directory (mintlify-docs) and run `mint dev`
+6. Preview your changes at `http://localhost:3000`
+7. Commit your changes and submit a pull request
+
+For more details on local development, see our [development guide](development.mdx).
+
+## Writing guidelines
+
+- **Use active voice**: "Run the command" not "The command should be run"
+- **Address the reader directly**: Use "you" instead of "the user"
+- **Keep sentences concise**: Aim for one idea per sentence
+- **Lead with the goal**: Start instructions with what the user wants to accomplish
+- **Use consistent terminology**: Don't alternate between synonyms for the same concept
+- **Include examples**: Show, don't just tell

package/mintlify-docs/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Mintlify
+
+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/mintlify-docs/README.md

@@ -0,0 +1,55 @@
+# Mintlify Starter Kit
+
+Use the starter kit to get your docs deployed and ready to customize.
+
+Click the green **Use this template** button at the top of this repo to copy the Mintlify starter kit. The starter kit contains examples with
+
+- Guide pages
+- Navigation
+- Customizations
+- API reference pages
+- Use of popular components
+
+**[Follow the full quickstart guide](https://starter.mintlify.com/quickstart)**
+
+## AI-assisted writing
+
+Set up your AI coding tool to work with Mintlify:
+
+```bash
+npx skills add https://mintlify.com/docs
+```
+
+This command installs Mintlify's documentation skill for your configured AI tools like Claude Code, Cursor, Windsurf, and others. The skill includes component reference, writing standards, and workflow guidance.
+
+See the [AI tools guides](/ai-tools) for tool-specific setup.
+
+## Development
+
+Install the [Mintlify CLI](https://www.npmjs.com/package/mint) to preview your documentation changes locally. To install, use the following command:
+
+```
+npm i -g mint
+```
+
+Run the following command at the root of your documentation, where your `docs.json` is located:
+
+```
+mint dev
+```
+
+View your local preview at `http://localhost:3000`.
+
+## Publishing changes
+
+Install our GitHub app from your [dashboard](https://dashboard.mintlify.com/settings/organization/github-app) to propagate changes from your repo to your deployment. Changes are deployed to production automatically after pushing to the default branch.
+
+## Need help?
+
+### Troubleshooting
+
+- If your dev environment isn't running: Run `mint update` to ensure you have the most recent version of the CLI.
+- If a page loads as a 404: Make sure you are running in a folder with a valid `docs.json`.
+
+### Resources
+- [Mintlify documentation](https://mintlify.com/docs)

package/mintlify-docs/ai-tools/claude-code.mdx

@@ -0,0 +1,43 @@
+---
+title: "Claude Code setup"
+description: "Configure Claude Code for your documentation workflow"
+icon: "asterisk"
+---
+
+Set up Claude Code to help you write and maintain your Mintlify documentation.
+
+## Prerequisites
+
+- Active Claude subscription (Pro, Max, or API access)
+
+## Setup
+
+<Steps>
+<Step title="Install Claude Code">
+  ```bash
+  npm install -g @anthropic-ai/claude-code
+  ```
+</Step>
+
+<Step title="Install the Mintlify skill">
+  In your docs directory, run:
+
+  ```bash
+  npx skills add https://mintlify.com/docs
+  ```
+
+  This gives Claude Code Mintlify's component reference, writing standards,
+  and workflow guidance.
+</Step>
+
+<Step title="Customize project instructions">
+  Edit `AGENTS.md` in your project root to add project-specific terminology,
+  style preferences, and content boundaries.
+</Step>
+
+<Step title="Start writing with Claude Code">
+  ```bash
+  claude
+  ```
+</Step>
+</Steps>

package/mintlify-docs/ai-tools/cursor.mdx

@@ -0,0 +1,39 @@
+---
+title: "Cursor setup"
+description: "Configure Cursor for your documentation workflow"
+icon: "arrow-pointer"
+---
+
+Set up Cursor to help you write and maintain your Mintlify documentation.
+
+## Prerequisites
+
+- Cursor editor installed
+
+## Setup
+
+<Steps>
+<Step title="Open your docs directory in Cursor">
+  Open the root of your documentation repository where `docs.json` is located.
+</Step>
+
+<Step title="Install the Mintlify skill">
+  In the integrated terminal, run:
+
+  ```bash
+  npx skills add https://mintlify.com/docs
+  ```
+
+  This gives Cursor Mintlify's component reference, writing standards,
+  and workflow guidance.
+</Step>
+
+<Step title="Customize project instructions">
+  Edit `AGENTS.md` in your project root to add project-specific terminology,
+  style preferences, and content boundaries.
+</Step>
+
+<Step title="Start writing with Cursor">
+  Open a file and use Cursor's AI features to draft and edit documentation.
+</Step>
+</Steps>

package/mintlify-docs/ai-tools/windsurf.mdx

@@ -0,0 +1,39 @@
+---
+title: "Windsurf setup"
+description: "Configure Windsurf for your documentation workflow"
+icon: "water"
+---
+
+Set up Windsurf's Cascade AI assistant to help you write and maintain your Mintlify documentation.
+
+## Prerequisites
+
+- Windsurf editor installed
+
+## Setup
+
+<Steps>
+<Step title="Open your docs directory in Windsurf">
+  Open the root of your documentation repository where `docs.json` is located.
+</Step>
+
+<Step title="Install the Mintlify skill">
+  In the integrated terminal, run:
+
+  ```bash
+  npx skills add https://mintlify.com/docs
+  ```
+
+  This gives Windsurf Mintlify's component reference, writing standards,
+  and workflow guidance.
+</Step>
+
+<Step title="Customize project instructions">
+  Edit `AGENTS.md` in your project root to add project-specific terminology,
+  style preferences, and content boundaries.
+</Step>
+
+<Step title="Start writing with Cascade">
+  Open a file and use Cascade to draft and edit documentation.
+</Step>
+</Steps>