@stamhoofd/backend 2.111.0 → 2.112.0

package/LICENSE.md

@@ -0,0 +1,32 @@
+Free Use License for Non-Profit Organizations
+
+Copyright 2020 Codawood BV
+
+Permission is hereby granted, free of charge, to any non-profit organization with fewer than 2,000 members (each, a “Licensee”), to use this software and associated documentation files (the “Software”), subject to the following conditions:
+
+1. Eligibility:
+This license applies only if neither the Licensee nor, if applicable, its parent or umbrella organization, is already subject to an existing license for this project. For the purposes of this license, a “parent or umbrella organization” means any organization with which the Licensee is affiliated, coordinated, or represented as part of a larger collective, including but not limited to national associations or federations.
+
+2. Modifications:
+Modifications to the Software are permitted only if they are published publicly under the MIT License, covering only the modifications; the original Software remains under this license and may not be sublicensed without a separate agreement. Any modification made by a Licensee (other than modifications by the original author, its representatives, or the copyright owner) shall be deemed to be distributed under the MIT License. Submission of modifications through publicly accessible channels, including but not limited to pull requests on code repositories such as GitHub, shall be considered an explicit acknowledgment and grant by the Licensee that such modifications are made available under the MIT License. Licensees may not sublicense, transfer, or assign the rights granted under this license except as expressly permitted herein.
+
+3. Precedence of Existing Licenses:
+If the Licensee, or its parent or umbrella organization, is already subject to an existing license for this project, that license shall take precedence, and no additional free license is granted. Nothing in this license shall be construed to override any pre-existing exclusive license agreement.
+
+4. Data Protection / GDPR Responsibility:
+Licensees are solely responsible for ensuring that any processing of personal data using this software complies with applicable data protection laws, including the EU General Data Protection Regulation (GDPR).
+
+5. Termination and Revocation:
+The copyright holders may revoke this license at any time, at their sole discretion.
+
+6. Governing Law:
+This license shall be governed by and construed in accordance with the laws of Belgium, without regard to conflict of law principles.
+
+7. Third-Party Licenses:
+Certain files or components included in the Software may be governed by separate licenses, including open-source licenses, or contributed by third parties under different terms. Such files are not automatically covered by this license. Licensees are responsible for reviewing and complying with any additional license terms that apply to these files.
+
+For the purposes of this license, a “non-profit organization” means an entity recognized as non-profit under applicable law in its jurisdiction, which does not distribute profits to its members or owners.
+
+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.
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@stamhoofd/backend",
-    "version": "2.111.0",
+    "version": "2.112.0",
     "main": "./dist/index.js",
     "exports": {
         ".": {
@@ -11,6 +11,9 @@
         },
         "./src/boot": {
             "require": "./dist/src/boot.js"
+        },
+        "./tests/helpers": {
+            "require": "./dist/tests/helpers/index.js"
         }
     },
     "license": "UNLICENCED",
@@ -35,7 +38,7 @@
         "@types/mailparser": "^3",
         "@types/mysql": "^2.15.20",
         "@types/node": "^22",
-        "nock": "^13.5.1",
+        "nock": "^14.0.10",
         "qs": "^6.11.2",
         "sinon": "^18.0.0"
     },
@@ -51,14 +54,14 @@
         "@simonbackx/simple-encoding": "2.23.1",
         "@simonbackx/simple-endpoints": "1.20.1",
         "@simonbackx/simple-logging": "^1.0.1",
-        "@stamhoofd/backend-i18n": "2.111.0",
-        "@stamhoofd/backend-middleware": "2.111.0",
-        "@stamhoofd/email": "2.111.0",
-        "@stamhoofd/models": "2.111.0",
-        "@stamhoofd/queues": "2.111.0",
-        "@stamhoofd/sql": "2.111.0",
-        "@stamhoofd/structures": "2.111.0",
-        "@stamhoofd/utility": "2.111.0",
+        "@stamhoofd/backend-i18n": "2.112.0",
+        "@stamhoofd/backend-middleware": "2.112.0",
+        "@stamhoofd/email": "2.112.0",
+        "@stamhoofd/models": "2.112.0",
+        "@stamhoofd/queues": "2.112.0",
+        "@stamhoofd/sql": "2.112.0",
+        "@stamhoofd/structures": "2.112.0",
+        "@stamhoofd/utility": "2.112.0",
         "archiver": "^7.0.1",
         "axios": "^1.13.2",
         "cookie": "^0.7.0",
@@ -76,5 +79,5 @@
     "publishConfig": {
         "access": "public"
     },
-    "gitHead": "21344c902f356539e4034b499b94f54adbe10e50"
+    "gitHead": "8734fff2c389052210c5da51bd3c4beaf149bfd1"
 }

package/src/boot.ts

@@ -131,6 +131,7 @@ export const boot = async (options: { killProcess: boolean }) => {
     await import('./email-recipient-loaders/orders');
     await import('./email-recipient-loaders/receivable-balances');
     await import('./excel-loaders/registrations');
+    await import('./email-recipient-loaders/documents');
 
     productionLog('Opening port...');
     routerServer.listen(STAMHOOFD.PORT ?? 9090);

package/src/email-recipient-loaders/documents.ts

@@ -0,0 +1,66 @@
+import { Email, Member } from '@stamhoofd/models';
+import { SQL } from '@stamhoofd/sql';
+import { EmailRecipient, EmailRecipientFilterType, LimitedFilteredRequest, PaginatedResponse, Replacement } from '@stamhoofd/structures';
+import { GetDocumentsEndpoint } from '../endpoints/organization/dashboard/documents/GetDocumentsEndpoint.js';
+
+async function fetch(query: LimitedFilteredRequest) {
+    const result = await GetDocumentsEndpoint.buildData(query);
+
+    const recipients: EmailRecipient[] = [];
+    const memberIds = new Set(result.results.map(doc => doc.memberId).filter(id => id !== null)); // silently skip null memberIds
+
+    const members = await Member.getBlobByIds(...memberIds);
+    for (const member of members) {
+        const emails = member.details.getNotificationEmails();
+        for (const user of member.users) {
+            if (!emails.includes(user.email.toLocaleLowerCase())) {
+                continue;
+            }
+            const recipient = EmailRecipient.create({
+                objectId: member.id,
+                userId: user.id,
+                memberId: member.id,
+                firstName: user.firstName,
+                lastName: user.lastName,
+                email: user.email,
+                replacements: [
+                    Replacement.create({
+                        token: 'firstNameMember',
+                        value: member.firstName,
+                    }),
+                    Replacement.create({
+                        token: 'lastNameMember',
+                        value: member.lastName,
+                    }),
+                ],
+            });
+            recipients.push(recipient);
+        }
+    }
+
+    return new PaginatedResponse({
+        results: recipients,
+        next: result.next,
+    });
+}
+
+async function count(request: LimitedFilteredRequest) {
+    const query = await GetDocumentsEndpoint.buildQuery(request);
+    const uniqueMemberIds = await query.count(SQL.distinct(SQL.column('memberId')));
+
+    if (uniqueMemberIds > 100 || uniqueMemberIds === 0) {
+        return uniqueMemberIds; // rough estimate
+    }
+    // do full count
+    request.limit = 100;
+    let count = 0;
+    let req: LimitedFilteredRequest | null = request;
+    while (req) {
+        const result = await fetch(request);
+        count += result.results.length;
+        req = result.next ?? null;
+    }
+    return count;
+};
+
+Email.recipientLoaders.set(EmailRecipientFilterType.Documents, { fetch, count });