@lenne.tech/nest-server 11.3.0 → 11.4.1

package/dist/core/modules/migrate/mongo-state-store.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoStateStore = void 0;
+exports.synchronizedMigration = synchronizedMigration;
+exports.synchronizedUp = synchronizedUp;
+const mongodb_1 = require("mongodb");
+const util_1 = require("util");
+class MongoStateStore {
+    constructor(objectOrHost) {
+        this.mongodbHost = typeof objectOrHost === 'string' ? objectOrHost : objectOrHost.uri;
+        this.collectionName =
+            typeof objectOrHost === 'string' ? 'migrations' : (objectOrHost.collectionName ?? 'migrations');
+        this.lockCollectionName = typeof objectOrHost !== 'string' ? objectOrHost.lockCollectionName : undefined;
+    }
+    load(fn) {
+        this.loadAsync()
+            .then((result) => fn(undefined, result))
+            .catch((err) => fn(err));
+    }
+    async loadAsync() {
+        return dbRequest(this.mongodbHost, async (db) => {
+            const result = await db.collection(this.collectionName).find({}).toArray();
+            if (result.length > 1) {
+                throw new Error(`Expected exactly one result, but got ${result.length}`);
+            }
+            if (result.length === 0) {
+                console.debug('No migrations found, probably running the very first time');
+                return {};
+            }
+            return result[0];
+        });
+    }
+    save(set, fn) {
+        this.saveAsync(set)
+            .then(() => fn())
+            .catch((err) => fn(err));
+    }
+    async saveAsync(set) {
+        const { lastRun, migrations } = set;
+        await dbRequest(this.mongodbHost, async (db) => {
+            await db.collection(this.collectionName).replaceOne({}, { lastRun, migrations }, { upsert: true });
+        });
+    }
+}
+exports.MongoStateStore = MongoStateStore;
+async function synchronizedMigration(opts, callback) {
+    if (!opts.stateStore) {
+        throw new Error('No `stateStore` in migration options');
+    }
+    const stateStore = opts.stateStore;
+    if (!(stateStore instanceof MongoStateStore)) {
+        throw new Error('Given `stateStore` is not `MongoStateStore`');
+    }
+    const lockCollectionName = stateStore.lockCollectionName;
+    if (typeof lockCollectionName !== 'string') {
+        throw new Error('`lockCollectionName` in MongoStateStore is not set');
+    }
+    try {
+        await acquireLock(stateStore.mongodbHost, lockCollectionName);
+        const set = await stateStore.loadAsync();
+        await callback(set);
+    }
+    finally {
+        await releaseLock(stateStore.mongodbHost, lockCollectionName);
+    }
+}
+async function synchronizedUp(opts) {
+    await synchronizedMigration(opts, async (loadedSet) => {
+        await (0, util_1.promisify)(loadedSet.up).call(loadedSet);
+    });
+}
+async function acquireLock(url, lockCollectionName) {
+    await dbRequest(url, async (db) => {
+        const collection = db.collection(lockCollectionName);
+        await collection.createIndex({ lock: 1 }, { unique: true });
+        let showMessage = true;
+        for (;;) {
+            const result = await collection.updateOne({ lock: 'lock' }, { $set: { lock: 'lock' } }, { upsert: true });
+            const lockAcquired = result.upsertedCount > 0;
+            if (lockAcquired) {
+                break;
+            }
+            if (showMessage) {
+                console.debug('Waiting for migration lock release …');
+                showMessage = false;
+            }
+            await (0, util_1.promisify)(setTimeout)(100);
+        }
+    });
+}
+async function dbRequest(url, callback) {
+    let client;
+    try {
+        client = await mongodb_1.MongoClient.connect(url);
+        const db = client.db();
+        return await callback(db);
+    }
+    finally {
+        await client?.close();
+    }
+}
+async function releaseLock(url, lockCollectionName) {
+    await dbRequest(url, (db) => db.collection(lockCollectionName).deleteOne({ lock: 'lock' }));
+}
+//# sourceMappingURL=mongo-state-store.js.map

package/dist/core/modules/migrate/mongo-state-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-state-store.js","sourceRoot":"","sources":["../../../../src/core/modules/migrate/mongo-state-store.ts"],"names":[],"mappings":"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"}

package/dist/core/modules/migrate/templates/migration-project.template.ts

@@ -0,0 +1,53 @@
+import { getDb, uploadFileToGridFS } from '@lenne.tech/nest-server';
+import { Db, ObjectId } from 'mongodb';
+import config from '../src/config.env';
+
+/**
+ * Migration template for nest-server projects
+ *
+ * This template is ready-to-use for @lenne.tech/nest-server projects.
+ * It imports the necessary helpers and config automatically.
+ *
+ * Available helpers:
+ * - getDb(uri): Get MongoDB connection
+ * - uploadFileToGridFS(uri, filePath, options): Upload file to GridFS
+ */
+
+const MONGO_URL = config.mongoose.uri;
+
+/**
+ * Run migration
+ *
+ * Code your update script here!
+ */
+export const up = async () => {
+  const db: Db = await getDb(MONGO_URL);
+
+  // Example: Add a new field to all documents in a collection
+  // await db.collection('users').updateMany(
+  //   { email: { $exists: false } },
+  //   { $set: { email: '' } }
+  // );
+
+  // Example: Upload a file to GridFS
+  // const fileId: ObjectId = await uploadFileToGridFS(
+  //   MONGO_URL,
+  //   '../assets/image.png',
+  //   { bucketName: 'images', filename: 'logo.png' }
+  // );
+};
+
+/**
+ * Rollback migration
+ *
+ * Code your downgrade script here!
+ */
+export const down = async () => {
+  const db: Db = await getDb(MONGO_URL);
+
+  // Example: Remove the field added in the up() function
+  // await db.collection('users').updateMany(
+  //   {},
+  //   { $unset: { email: '' } }
+  // );
+};

package/dist/index.d.ts

@@ -118,6 +118,7 @@ export * from './core/modules/health-check/core-health-check.controller';
 export * from './core/modules/health-check/core-health-check.module';
 export * from './core/modules/health-check/core-health-check.resolver';
 export * from './core/modules/health-check/core-health-check.service';
+export * from './core/modules/migrate';
 export * from './core/modules/user/core-user.model';
 export * from './core/modules/user/core-user.service';
 export * from './core/modules/user/inputs/core-user-create.input';

package/dist/index.js

@@ -133,6 +133,7 @@ __exportStar(require("./core/modules/health-check/core-health-check.controller")
 __exportStar(require("./core/modules/health-check/core-health-check.module"), exports);
 __exportStar(require("./core/modules/health-check/core-health-check.resolver"), exports);
 __exportStar(require("./core/modules/health-check/core-health-check.service"), exports);
+__exportStar(require("./core/modules/migrate"), exports);
 __exportStar(require("./core/modules/user/core-user.model"), exports);
 __exportStar(require("./core/modules/user/core-user.service"), exports);
 __exportStar(require("./core/modules/user/inputs/core-user-create.input"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAIA,gDAA8B;AAK9B,iEAA+C;AAC/C,qEAAmD;AACnD,kFAAgE;AAChE,kFAAgE;AAChE,sFAAoE;AACpE,6FAA2E;AAC3E,kFAAgE;AAChE,0FAAwE;AACxE,+EAA6D;AAC7D,gFAA8D;AAC9D,2EAAyD;AACzD,kFAAgE;AAChE,mFAAiE;AACjE,+EAA6D;AAC7D,4EAA0D;AAC1D,wEAAsD;AACtD,gEAA8C;AAC9C,sEAAoD;AACpD,kFAAgE;AAChE,sEAAoD;AACpD,sEAAoD;AACpD,uEAAqD;AACrD,kEAAgD;AAChD,yEAAuD;AACvD,oEAAkD;AAClD,sEAAoD;AACpD,uEAAqD;AACrD,sEAAoD;AACpD,qEAAmD;AACnD,qEAAmD;AACnD,oEAAkD;AAClD,uEAAqD;AACrD,qEAAmD;AACnD,6EAA2D;AAC3D,wEAAsD;AACtD,oEAAkD;AAClD,2EAAyD;AACzD,kEAAgD;AAChD,wFAAsE;AACtE,wFAAsE;AACtE,4FAA0E;AAC1E,oGAAkF;AAClF,qGAAmF;AACnF,qFAAmE;AACnE,qFAAmE;AACnE,2FAAyE;AACzE,4FAA0E;AAC1E,sFAAoE;AACpE,oFAAkE;AAClE,qFAAmE;AACnE,qFAAmE;AACnE,wEAAsD;AACtD,8EAA4D;AAC5D,uEAAqD;AACrD,4EAA0D;AAC1D,0EAAwD;AACxD,2EAAyD;AACzD,mEAAiD;AACjD,8EAA4D;AAC5D,oEAAkD;AAClD,oEAAkD;AAClD,uEAAqD;AACrD,wEAAsD;AACtD,gFAA8D;AAC9D,sEAAoD;AACpD,uEAAqD;AACrD,yEAAuD;AACvD,2EAAyD;AACzD,wEAAsD;AACtD,0EAAwD;AACxD,yEAAuD;AACvD,kFAAgE;AAChE,iEAA+C;AAC/C,2EAAyD;AACzD,8DAA4C;AAC5C,+DAA6C;AAC7C,qEAAmD;AACnD,yEAAuD;AACvD,uEAAqD;AACrD,6EAA2D;AAC3D,wEAAsD;AACtD,2EAAyD;AACzD,0EAAwD;AACxD,4EAA0D;AAC1D,iFAA+D;AAC/D,+EAA6D;AAC7D,mEAAiD;AAMjD,+EAA6D;AAC7D,2EAAyD;AACzD,sEAAoD;AACpD,uEAAqD;AACrD,yEAAuD;AACvD,iGAA+E;AAC/E,yFAAuE;AACvE,yFAAuE;AACvE,wEAAsD;AACtD,yEAAuD;AACvD,qFAAmE;AACnE,qFAAmE;AACnE,0FAAwE;AACxE,2FAAyE;AACzE,uFAAqE;AACrE,sFAAoE;AACpE,iFAA+D;AAC/D,sFAAoE;AACpE,8EAA4D;AAC5D,uEAAqD;AAMrD,2EAAyD;AACzD,2EAAyD;AACzD,yEAAuD;AACvD,wEAAsD;AACtD,gGAA8E;AAC9E,uFAAqE;AAMrE,6FAA2E;AAC3E,2FAAyE;AACzE,uFAAqE;AACrE,yFAAuE;AAMvE,wFAAsE;AACtE,sEAAoD;AACpD,wEAAsD;AACtD,oFAAkE;AAClE,6EAA2D;AAM3D,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAIA,gDAA8B;AAK9B,iEAA+C;AAC/C,qEAAmD;AACnD,kFAAgE;AAChE,kFAAgE;AAChE,sFAAoE;AACpE,6FAA2E;AAC3E,kFAAgE;AAChE,0FAAwE;AACxE,+EAA6D;AAC7D,gFAA8D;AAC9D,2EAAyD;AACzD,kFAAgE;AAChE,mFAAiE;AACjE,+EAA6D;AAC7D,4EAA0D;AAC1D,wEAAsD;AACtD,gEAA8C;AAC9C,sEAAoD;AACpD,kFAAgE;AAChE,sEAAoD;AACpD,sEAAoD;AACpD,uEAAqD;AACrD,kEAAgD;AAChD,yEAAuD;AACvD,oEAAkD;AAClD,sEAAoD;AACpD,uEAAqD;AACrD,sEAAoD;AACpD,qEAAmD;AACnD,qEAAmD;AACnD,oEAAkD;AAClD,uEAAqD;AACrD,qEAAmD;AACnD,6EAA2D;AAC3D,wEAAsD;AACtD,oEAAkD;AAClD,2EAAyD;AACzD,kEAAgD;AAChD,wFAAsE;AACtE,wFAAsE;AACtE,4FAA0E;AAC1E,oGAAkF;AAClF,qGAAmF;AACnF,qFAAmE;AACnE,qFAAmE;AACnE,2FAAyE;AACzE,4FAA0E;AAC1E,sFAAoE;AACpE,oFAAkE;AAClE,qFAAmE;AACnE,qFAAmE;AACnE,wEAAsD;AACtD,8EAA4D;AAC5D,uEAAqD;AACrD,4EAA0D;AAC1D,0EAAwD;AACxD,2EAAyD;AACzD,mEAAiD;AACjD,8EAA4D;AAC5D,oEAAkD;AAClD,oEAAkD;AAClD,uEAAqD;AACrD,wEAAsD;AACtD,gFAA8D;AAC9D,sEAAoD;AACpD,uEAAqD;AACrD,yEAAuD;AACvD,2EAAyD;AACzD,wEAAsD;AACtD,0EAAwD;AACxD,yEAAuD;AACvD,kFAAgE;AAChE,iEAA+C;AAC/C,2EAAyD;AACzD,8DAA4C;AAC5C,+DAA6C;AAC7C,qEAAmD;AACnD,yEAAuD;AACvD,uEAAqD;AACrD,6EAA2D;AAC3D,wEAAsD;AACtD,2EAAyD;AACzD,0EAAwD;AACxD,4EAA0D;AAC1D,iFAA+D;AAC/D,+EAA6D;AAC7D,mEAAiD;AAMjD,+EAA6D;AAC7D,2EAAyD;AACzD,sEAAoD;AACpD,uEAAqD;AACrD,yEAAuD;AACvD,iGAA+E;AAC/E,yFAAuE;AACvE,yFAAuE;AACvE,wEAAsD;AACtD,yEAAuD;AACvD,qFAAmE;AACnE,qFAAmE;AACnE,0FAAwE;AACxE,2FAAyE;AACzE,uFAAqE;AACrE,sFAAoE;AACpE,iFAA+D;AAC/D,sFAAoE;AACpE,8EAA4D;AAC5D,uEAAqD;AAMrD,2EAAyD;AACzD,2EAAyD;AACzD,yEAAuD;AACvD,wEAAsD;AACtD,gGAA8E;AAC9E,uFAAqE;AAMrE,6FAA2E;AAC3E,2FAAyE;AACzE,uFAAqE;AACrE,yFAAuE;AACvE,wFAAsE;AAMtE,yDAAuC;AAMvC,sEAAoD;AACpD,wEAAsD;AACtD,oFAAkE;AAClE,6EAA2D;AAM3D,qDAAmC"}