@lenne.tech/nest-server 11.13.5 → 11.14.1

package/src/core/modules/migrate/README.md

@@ -25,11 +25,13 @@ npm uninstall @nodepit/migrate-state-store-mongodb
 ### 2. Update your imports
 
 **Before:**
+
 ```typescript
 import { MongoStateStore, synchronizedUp } from '@nodepit/migrate-state-store-mongodb';
 ```
 
 **After:**
+
 ```typescript
 import { MongoStateStore, synchronizedUp } from '@lenne.tech/nest-server';
 ```
@@ -58,7 +60,7 @@ const stateStore = new MongoStateStore('mongodb://localhost/mydb');
 const stateStore = new MongoStateStore({
   uri: 'mongodb://localhost/mydb',
   collectionName: 'custom_migrations', // optional, defaults to 'migrations'
-  lockCollectionName: 'migration_lock' // optional, for cluster environments
+  lockCollectionName: 'migration_lock', // optional, for cluster environments
 });
 ```
 
@@ -76,10 +78,8 @@ stateStore.load((err, state) => {
 
 // Save migration state
 const migrationState = {
-  migrations: [
-    { title: '1234-my-migration.js', timestamp: Date.now() }
-  ],
-  lastRun: '1234-my-migration.js'
+  migrations: [{ title: '1234-my-migration.js', timestamp: Date.now() }],
+  lastRun: '1234-my-migration.js',
 };
 
 stateStore.save(migrationState, (err) => {
@@ -121,9 +121,9 @@ import { MongoStateStore, synchronizedMigration, synchronizedUp } from '@lenne.t
 const migrationOptions = {
   stateStore: new MongoStateStore({
     uri: 'mongodb://localhost/mydb',
-    lockCollectionName: 'migration_lock' // Required for synchronized migrations
+    lockCollectionName: 'migration_lock', // Required for synchronized migrations
   }),
-  migrationsDirectory: './migrations'
+  migrationsDirectory: './migrations',
 };
 
 // Custom migration logic
@@ -148,6 +148,7 @@ new MongoStateStore(options: string | MongoStateStoreOptions)
 ```
 
 **Parameters:**
+
 - `options`: MongoDB URI string or configuration object
   - `uri`: MongoDB connection URI (required)
   - `collectionName`: Name of the collection to store migration state (default: 'migrations')
@@ -196,8 +197,8 @@ Wraps migrations with a lock to prevent simultaneous execution in clustered envi
 ```typescript
 async function synchronizedMigration(
   opts: MigrationOptions,
-  callback: (set: MigrationSet) => Promise<void>
-): Promise<void>
+  callback: (set: MigrationSet) => Promise<void>,
+): Promise<void>;
 ```
 
 #### synchronizedUp
@@ -205,7 +206,7 @@ async function synchronizedMigration(
 Convenience function that executes all pending migrations in a synchronized manner.
 
 ```typescript
-async function synchronizedUp(opts: MigrationOptions): Promise<void>
+async function synchronizedUp(opts: MigrationOptions): Promise<void>;
 ```
 
 ## How It Works
@@ -260,10 +261,10 @@ module.exports.up = function (next) {
   callbackify(async () => {
     const client = await MongoClient.connect(mongoUrl);
     try {
-      await client.db().collection('users').updateMany(
-        { email: { $exists: false } },
-        { $set: { email: '' } }
-      );
+      await client
+        .db()
+        .collection('users')
+        .updateMany({ email: { $exists: false } }, { $set: { email: '' } });
     } finally {
       await client.close();
     }
@@ -274,10 +275,10 @@ module.exports.down = function (next) {
   callbackify(async () => {
     const client = await MongoClient.connect(mongoUrl);
     try {
-      await client.db().collection('users').updateMany(
-        {},
-        { $unset: { email: '' } }
-      );
+      await client
+        .db()
+        .collection('users')
+        .updateMany({}, { $unset: { email: '' } });
     } finally {
       await client.close();
     }
@@ -295,9 +296,9 @@ async function runMigrations() {
   const migrationOptions = {
     stateStore: new MongoStateStore({
       uri: process.env.MONGODB_URL || 'mongodb://localhost/mydb',
-      lockCollectionName: 'migration_lock'
+      lockCollectionName: 'migration_lock',
     }),
-    migrationsDirectory: path.join(__dirname, 'migrations')
+    migrationsDirectory: path.join(__dirname, 'migrations'),
   };
 
   try {
@@ -357,8 +358,8 @@ const config = require('../src/config.env');
 
 module.exports = createMigrationStore(
   config.default.mongoose.uri,
-  'migrations',        // optional collection name
-  'migration_lock'     // optional lock collection for clusters
+  'migrations', // optional collection name
+  'migration_lock', // optional lock collection for clusters
 );
 ```
 
@@ -380,11 +381,10 @@ Helper function to upload files to GridFS during migrations:
 ```typescript
 import { uploadFileToGridFS } from '@lenne.tech/nest-server';
 
-const fileId = await uploadFileToGridFS(
-  'mongodb://localhost/mydb',
-  '../assets/image.png',
-  { bucketName: 'images', filename: 'logo.png' }
-);
+const fileId = await uploadFileToGridFS('mongodb://localhost/mydb', '../assets/image.png', {
+  bucketName: 'images',
+  filename: 'logo.png',
+});
 ```
 
 ### Migration Templates
@@ -417,6 +417,7 @@ For a complete step-by-step guide on migrating from @nodepit/migrate-state-store
 4. Run migrations using the built-in CLI
 
 **Example package.json scripts:**
+
 ```json
 {
   "scripts": {
@@ -449,5 +450,6 @@ MIT
 ## Support
 
 For issues and questions:
+
 - GitHub: https://github.com/lenneTech/nest-server/issues
-- Documentation: https://nest-server.lenne.tech
+- Documentation: https://nest-server.lenne.tech

package/src/core/modules/migrate/cli/migrate-cli.ts

@@ -19,9 +19,6 @@
  *   --template-file, -t    Template file for creating migrations
  */
 
-/* eslint-disable no-console */
-// Console output is required for CLI functionality
-
 import * as fs from 'fs';
 import * as path from 'path';
 

package/src/core/modules/migrate/helpers/migration.helper.ts

@@ -99,29 +99,21 @@ export const uploadFileToGridFS = async (
     ...options,
   };
 
-  return new Promise<ObjectId>(async (resolve, reject) => {
-    let client: MongoClient | undefined;
-    try {
-      client = await MongoClient.connect(mongoUrl);
-      const db = client.db();
-      const bucket = new GridFSBucket(db, { bucketName });
-      const writeStream = bucket.openUploadStream(filename);
-
-      const rs = fs.createReadStream(path.resolve(__dirname, relativePath)).pipe(writeStream);
-
-      rs.on('finish', () => {
-        resolve(writeStream.id as ObjectId);
-      });
+  const client = await MongoClient.connect(mongoUrl);
+  const db = client.db();
+  const bucket = new GridFSBucket(db, { bucketName });
+  const writeStream = bucket.openUploadStream(filename);
 
-      rs.on('error', (err) => {
-        reject(err);
-      });
-    } catch (err) {
+  const rs = fs.createReadStream(path.resolve(__dirname, relativePath)).pipe(writeStream);
+
+  return new Promise<ObjectId>((resolve, reject) => {
+    rs.on('finish', () => {
+      resolve(writeStream.id as ObjectId);
+    });
+
+    rs.on('error', (err) => {
       reject(err);
-    } finally {
-      // Note: Connection will be closed when stream finishes
-      // but we keep the client reference for proper error handling
-    }
+    });
   });
 };
 

package/src/core/modules/migrate/migration-runner.ts

@@ -1,6 +1,3 @@
-/* eslint-disable no-console */
-// Console output is required for migration runner feedback
-
 import * as fs from 'fs';
 import * as path from 'path';
 

package/src/core/modules/system-setup/INTEGRATION-CHECKLIST.md

@@ -8,18 +8,19 @@
 
 ## Do You Need This Checklist?
 
-| Scenario | Action Needed |
-|----------|---------------|
-| Fresh deployment needs initial admin creation | None - endpoints are available by default |
-| Automated deployment (Docker/CI) needs auto-creation | Set ENV variables (Step 1) |
-| Want to disable system setup | Set `systemSetup: { enabled: false }` in config |
-| Custom setup logic (extra fields, notifications) | Step 2 (Custom Controller) |
+| Scenario                                             | Action Needed                                   |
+| ---------------------------------------------------- | ----------------------------------------------- |
+| Fresh deployment needs initial admin creation        | None - endpoints are available by default       |
+| Automated deployment (Docker/CI) needs auto-creation | Set ENV variables (Step 1)                      |
+| Want to disable system setup                         | Set `systemSetup: { enabled: false }` in config |
+| Custom setup logic (extra fields, notifications)     | Step 2 (Custom Controller)                      |
 
 ---
 
 ## Reference Implementation
 
 **Local (in your node_modules):**
+
 ```
 node_modules/@lenne.tech/nest-server/src/core/modules/system-setup/
 ```
@@ -91,17 +92,17 @@ export class SystemSetupController extends CoreSystemSetupController {
 
 ## Common Mistakes
 
-| Mistake | Symptom | Fix |
-|---------|---------|-----|
-| BetterAuth not enabled | 404 on endpoints or 403 on init | Ensure `betterAuth` is configured |
-| Calling init with existing users | 403 "System setup not available" | Init only works on empty database |
-| Password too short | 400 validation error | Password must be at least 8 characters |
-| Missing ENV password | Auto-creation silently skipped | Set both `email` and `password` ENV vars |
-| `systemSetup: { enabled: false }` in config | 404 on endpoints | Remove the explicit disable |
+| Mistake                                     | Symptom                          | Fix                                      |
+| ------------------------------------------- | -------------------------------- | ---------------------------------------- |
+| BetterAuth not enabled                      | 404 on endpoints or 403 on init  | Ensure `betterAuth` is configured        |
+| Calling init with existing users            | 403 "System setup not available" | Init only works on empty database        |
+| Password too short                          | 400 validation error             | Password must be at least 8 characters   |
+| Missing ENV password                        | Auto-creation silently skipped   | Set both `email` and `password` ENV vars |
+| `systemSetup: { enabled: false }` in config | 404 on endpoints                 | Remove the explicit disable              |
 
 ---
 
 ## Detailed Documentation
 
 - **README.md:** `node_modules/@lenne.tech/nest-server/src/core/modules/system-setup/README.md`
-- **GitHub:** https://github.com/lenneTech/nest-server/blob/develop/src/core/modules/system-setup/README.md
+- **GitHub:** https://github.com/lenneTech/nest-server/blob/develop/src/core/modules/system-setup/README.md

package/src/core/modules/system-setup/README.md

@@ -42,16 +42,17 @@ Once any user exists, the init endpoint is permanently locked (returns 403) and
 
 ## Endpoints
 
-| Method | Endpoint | Description |
-|--------|----------|-------------|
-| GET | `/api/system-setup/status` | Check if system needs setup |
-| POST | `/api/system-setup/init` | Create initial admin user |
+| Method | Endpoint                   | Description                 |
+| ------ | -------------------------- | --------------------------- |
+| GET    | `/api/system-setup/status` | Check if system needs setup |
+| POST   | `/api/system-setup/init`   | Create initial admin user   |
 
 ### GET /api/system-setup/status
 
 Returns the current setup status.
 
 **Response:**
+
 ```json
 {
   "needsSetup": true,
@@ -64,6 +65,7 @@ Returns the current setup status.
 Creates the initial admin user. Only works when zero users exist.
 
 **Request Body:**
+
 ```json
 {
   "email": "admin@example.com",
@@ -72,13 +74,14 @@ Creates the initial admin user. Only works when zero users exist.
 }
 ```
 
-| Field | Type | Required | Validation |
-|-------|------|----------|------------|
-| `email` | string | Yes | Valid email format |
-| `password` | string | Yes | Minimum 8 characters |
-| `name` | string | No | Defaults to email prefix |
+| Field      | Type   | Required | Validation               |
+| ---------- | ------ | -------- | ------------------------ |
+| `email`    | string | Yes      | Valid email format       |
+| `password` | string | Yes      | Minimum 8 characters     |
+| `name`     | string | No       | Defaults to email prefix |
 
 **Success Response (201):**
+
 ```json
 {
   "success": true,
@@ -88,6 +91,7 @@ Creates the initial admin user. Only works when zero users exist.
 ```
 
 **Error Response (403):**
+
 ```json
 {
   "message": "LTNS_0050: System setup not available - users already exist"
@@ -100,11 +104,11 @@ Creates the initial admin user. Only works when zero users exist.
 
 System setup is **enabled by default** when BetterAuth is active:
 
-| Config | Effect |
-|--------|--------|
-| *(not set)* | Enabled (when BetterAuth is active) |
-| `systemSetup: { enabled: false }` | Disabled explicitly |
-| `systemSetup: { initialAdmin: { ... } }` | Enabled with auto-creation |
+| Config                                   | Effect                              |
+| ---------------------------------------- | ----------------------------------- |
+| _(not set)_                              | Enabled (when BetterAuth is active) |
+| `systemSetup: { enabled: false }`        | Disabled explicitly                 |
+| `systemSetup: { initialAdmin: { ... } }` | Enabled with auto-creation          |
 
 ```typescript
 // config.env.ts
@@ -220,6 +224,7 @@ if (needsSetup) {
 **Cause:** Users already exist in the database.
 
 **Solutions:**
+
 1. Check `GET /api/system-setup/status` - `needsSetup` should be `true`
 2. If this is a fresh deployment, verify the database is empty
 
@@ -228,6 +233,7 @@ if (needsSetup) {
 **Cause:** BetterAuth is not configured or not enabled.
 
 **Solutions:**
+
 1. Ensure `betterAuth` is configured in `config.env.ts`
 2. Verify BetterAuth is running (check server startup logs)
 
@@ -236,6 +242,7 @@ if (needsSetup) {
 **Cause:** Missing or incomplete ENV variables.
 
 **Solutions:**
+
 1. Verify both `email` and `password` are set
 2. Check server logs for `Auto-created initial admin on startup` or warning messages
 3. Ensure BetterAuth is fully initialized (check startup logs)
@@ -245,6 +252,7 @@ if (needsSetup) {
 **Cause:** System setup module is disabled.
 
 **Solutions:**
+
 1. Check that BetterAuth is enabled (system setup requires it)
 2. Ensure `systemSetup` is not set to `{ enabled: false }`
 
@@ -252,11 +260,11 @@ if (needsSetup) {
 
 ## Error Codes
 
-| Code | Key | Description |
-|------|-----|-------------|
-| LTNS_0050 | `SYSTEM_SETUP_NOT_AVAILABLE` | Users already exist, setup locked |
-| LTNS_0051 | `SYSTEM_SETUP_DISABLED` | System setup is disabled in config |
-| LTNS_0052 | `SYSTEM_SETUP_BETTERAUTH_REQUIRED` | BetterAuth must be enabled |
+| Code      | Key                                | Description                        |
+| --------- | ---------------------------------- | ---------------------------------- |
+| LTNS_0050 | `SYSTEM_SETUP_NOT_AVAILABLE`       | Users already exist, setup locked  |
+| LTNS_0051 | `SYSTEM_SETUP_DISABLED`            | System setup is disabled in config |
+| LTNS_0052 | `SYSTEM_SETUP_BETTERAUTH_REQUIRED` | BetterAuth must be enabled         |
 
 ---
 
@@ -264,4 +272,4 @@ if (needsSetup) {
 
 - [Integration Checklist](./INTEGRATION-CHECKLIST.md)
 - [BetterAuth Module](../better-auth/README.md)
-- [Configurable Features Pattern](../../../.claude/rules/configurable-features.md)
+- [Configurable Features Pattern](../../../.claude/rules/configurable-features.md)

package/src/core/modules/system-setup/core-system-setup.service.ts

@@ -74,10 +74,7 @@ export class CoreSystemSetupService implements OnApplicationBootstrap {
 
     // Partial credentials → warn and skip
     if (!initialAdmin.email || !initialAdmin.password) {
-      const missing = [
-        !initialAdmin.email && 'email',
-        !initialAdmin.password && 'password',
-      ].filter(Boolean).join(', ');
+      const missing = [!initialAdmin.email && 'email', !initialAdmin.password && 'password'].filter(Boolean).join(', ');
       this.logger.warn(`Incomplete initialAdmin config - missing: ${missing}. Auto-creation skipped.`);
       return;
     }
@@ -115,7 +112,9 @@ export class CoreSystemSetupService implements OnApplicationBootstrap {
       if (error instanceof ForbiddenException) {
         this.logger.log('Initial admin auto-creation skipped (users already exist)');
       } else {
-        this.logger.warn(`Initial admin auto-creation failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        this.logger.warn(
+          `Initial admin auto-creation failed: ${error instanceof Error ? error.message : 'Unknown error'}`,
+        );
       }
     }
   }

package/src/core/modules/tus/INTEGRATION-CHECKLIST.md

@@ -8,18 +8,19 @@
 
 ## Do You Need This Checklist?
 
-| Scenario | Checklist Needed? |
-|----------|-------------------|
-| Use TUS with defaults (everyone can upload) | No - works automatically |
-| Require authentication for uploads | Yes - Step 1 |
-| Custom upload handling (notifications, etc.) | Yes - Step 2 |
-| Disable TUS completely | No - just use `TusModule.forRoot({ config: false })` |
+| Scenario                                     | Checklist Needed?                                    |
+| -------------------------------------------- | ---------------------------------------------------- |
+| Use TUS with defaults (everyone can upload)  | No - works automatically                             |
+| Require authentication for uploads           | Yes - Step 1                                         |
+| Custom upload handling (notifications, etc.) | Yes - Step 2                                         |
+| Disable TUS completely                       | No - just use `TusModule.forRoot({ config: false })` |
 
 ---
 
 ## Reference Implementation
 
 **Local (in your node_modules):**
+
 ```
 node_modules/@lenne.tech/nest-server/src/server/server.module.ts
 ```
@@ -116,13 +117,13 @@ TusModule.forRoot({
     path: '/uploads',
     expiration: { expiresIn: '12h' },
   },
-})
+});
 ```
 
 ### Disable TUS
 
 ```typescript
-TusModule.forRoot({ config: false })
+TusModule.forRoot({ config: false });
 ```
 
 ---
@@ -140,11 +141,11 @@ TusModule.forRoot({ config: false })
 
 ## Common Mistakes
 
-| Mistake | Symptom | Fix |
-|---------|---------|-----|
-| Forgot to register custom controller | Default S_EVERYONE permissions | Add `controller: TusController` to forRoot() |
-| Custom controller missing @Roles | No authentication required | Add `@Roles(RoleEnum.S_USER)` to controller class |
-| Using wrong endpoint path | 404 on upload | Ensure client uses same path as config |
+| Mistake                              | Symptom                        | Fix                                               |
+| ------------------------------------ | ------------------------------ | ------------------------------------------------- |
+| Forgot to register custom controller | Default S_EVERYONE permissions | Add `controller: TusController` to forRoot()      |
+| Custom controller missing @Roles     | No authentication required     | Add `@Roles(RoleEnum.S_USER)` to controller class |
+| Using wrong endpoint path            | 404 on upload                  | Ensure client uses same path as config            |
 
 ---
 
@@ -173,4 +174,4 @@ upload.start();
 ## Detailed Documentation
 
 - **README.md:** `node_modules/@lenne.tech/nest-server/src/core/modules/tus/README.md`
-- **GitHub:** https://github.com/lenneTech/nest-server/blob/develop/src/core/modules/tus/README.md
+- **GitHub:** https://github.com/lenneTech/nest-server/blob/develop/src/core/modules/tus/README.md