@adaptivestone/framework 5.0.0-beta.4 → 5.0.0-beta.41

package/dist/helpers/files.js

@@ -0,0 +1,76 @@
+import { promises as fs } from 'node:fs';
+import { format, join, parse } from 'node:path';
+const getFilesPathWithInheritance = async ({ internalFolder, externalFolder, logger, loggerFileType = '', filter: { startWithCapital = true, notTests = true, notHidden = true } = {}, }) => {
+    const [internalFiles, externalFiles] = await Promise.all([
+        fs.readdir(internalFolder, { recursive: true, withFileTypes: true }),
+        fs.readdir(externalFolder, { recursive: true, withFileTypes: true }),
+    ]);
+    const filterIndexFile = (fileDirent) => {
+        if (!fileDirent.isFile()) {
+            return false;
+        }
+        const fileArray = fileDirent.name.split('/');
+        const file = fileArray[fileArray.length - 1];
+        if (startWithCapital && file[0] !== file[0].toUpperCase()) {
+            // not start with capital
+            return false;
+        }
+        if (notTests &&
+            (file.endsWith('.test.js') ||
+                file.endsWith('.test.ts') ||
+                file.endsWith('.d.ts'))) {
+            return false;
+        }
+        if (!file.endsWith('.js') && !file.endsWith('.ts')) {
+            return false;
+        }
+        if (notHidden && file[0] === '.') {
+            // not start with dot
+            return false;
+        }
+        return true;
+    };
+    const internalFilesString = internalFiles
+        .filter(filterIndexFile)
+        .map((fileDirent) => join(fileDirent.parentPath, fileDirent.name)
+        .replace(`${internalFolder}/`, '')
+        .replace(`${internalFolder}`, ''));
+    const externalFilesString = externalFiles
+        .filter(filterIndexFile)
+        .map((fileDirent) => join(fileDirent.parentPath, fileDirent.name)
+        .replace(`${externalFolder}/`, '')
+        .replace(`${externalFolder}`, ''));
+    const filesToLoad = [];
+    for (const file of internalFilesString) {
+        const fileDetails = parse(file);
+        const jsFile = format({
+            dir: fileDetails.dir,
+            name: fileDetails.name,
+            ext: '.js',
+        });
+        const tsFile = format({
+            dir: fileDetails.dir,
+            name: fileDetails.name,
+            ext: '.ts',
+        });
+        if (externalFilesString.includes(jsFile) ||
+            externalFilesString.includes(tsFile)) {
+            logger(`Skipping register INTERNAL file '${file}' ${loggerFileType ? `of type ${loggerFileType}` : ''} as it override by EXTERNAL ONE`);
+        }
+        else {
+            filesToLoad.push({
+                path: join(internalFolder, file),
+                file,
+            });
+        }
+    }
+    for (const file of externalFilesString) {
+        filesToLoad.push({
+            path: join(externalFolder, file),
+            file,
+        });
+    }
+    return filesToLoad;
+};
+export { getFilesPathWithInheritance };
+//# sourceMappingURL=files.js.map

package/dist/helpers/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/helpers/files.ts"],"names":[],"mappings":"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"}

package/dist/helpers/logger.d.ts

@@ -0,0 +1,4 @@
+declare const levels: readonly ["error", "warn", "info", "debug"];
+type LogLevel = (typeof levels)[number];
+declare const consoleLogger: (level: LogLevel, message: string) => void;
+export { levels, consoleLogger };

package/dist/helpers/logger.js

@@ -0,0 +1,20 @@
+const levels = ['error', 'warn', 'info', 'debug'];
+function isLogLevel(level) {
+    return (typeof level === 'string' &&
+        levels.includes(level));
+}
+const consoleLogger = (level, message) => {
+    const configuredLevelIndex = isLogLevel(level) ? levels.indexOf(level) : -1;
+    const currentLevelIndex = levels.indexOf(level);
+    const shouldLog = configuredLevelIndex === -1 || configuredLevelIndex >= currentLevelIndex;
+    if (shouldLog) {
+        if (console[level]) {
+            console[level](message);
+        }
+        else {
+            console.log(message);
+        }
+    }
+};
+export { levels, consoleLogger };
+//# sourceMappingURL=logger.js.map

package/dist/helpers/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/helpers/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAI3D,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACxB,MAAgC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAClD,CAAC;AACJ,CAAC;AAED,MAAM,aAAa,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,EAAE;IACzD,MAAM,oBAAoB,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,SAAS,GACb,oBAAoB,KAAK,CAAC,CAAC,IAAI,oBAAoB,IAAI,iBAAiB,CAAC;IAC3E,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC"}

package/dist/helpers/redis/clearNamespace.d.ts

@@ -0,0 +1,2 @@
+import type { RedisClientType } from '@redis/client';
+export declare const clearNamespace: (redisClient: RedisClientType, namespace: string) => Promise<void>;

package/dist/helpers/redis/clearNamespace.js

@@ -0,0 +1,14 @@
+export const clearNamespace = async (redisClient, namespace) => {
+    const deletedKeys = [];
+    const keys = await redisClient.sendCommand([
+        'keys',
+        `*${namespace}*`,
+    ]);
+    if (keys && keys.length > 0) {
+        for (const key of keys) {
+            deletedKeys.push(redisClient.sendCommand(['del', key]));
+        }
+        await Promise.all(deletedKeys);
+    }
+};
+//# sourceMappingURL=clearNamespace.js.map

package/dist/helpers/redis/clearNamespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clearNamespace.js","sourceRoot":"","sources":["../../../src/helpers/redis/clearNamespace.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,WAA4B,EAC5B,SAAiB,EACjB,EAAE;IACF,MAAM,WAAW,GAAG,EAAE,CAAC;IAEvB,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,WAAW,CAAW;QACnD,MAAM;QACN,IAAI,SAAS,GAAG;KACjB,CAAC,CAAC;IAEH,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;AACH,CAAC,CAAC"}

package/dist/helpers/redis/redisConnection.d.ts

@@ -0,0 +1,6 @@
+import type { RedisClientType } from '@redis/client';
+export declare const getRedisClient: () => Promise<RedisClientType>;
+/**
+ * Synchronous way to get redis client. Make sure to call connect on it before usage
+ */
+export declare const getRedisClientSync: () => RedisClientType;

package/dist/helpers/redis/redisConnection.js

@@ -0,0 +1,48 @@
+import { createClient } from '@redis/client';
+import { appInstance } from "../appInstance.js";
+let redisClient = null;
+export const getRedisClient = async () => {
+    if (redisClient) {
+        return redisClient;
+    }
+    const redisClientLocal = createNewRedisClient();
+    await redisClientLocal.connect();
+    return redisClientLocal;
+};
+/**
+ * Synchronous way to get redis client. Make sure to call connect on it before usage
+ */
+export const getRedisClientSync = () => {
+    if (redisClient) {
+        return redisClient;
+    }
+    const redisClientLocal = createNewRedisClient();
+    // to make sure connection is established
+    (async () => {
+        await redisClientLocal.connect();
+    })();
+    return redisClientLocal;
+};
+const createNewRedisClient = () => {
+    if (redisClient) {
+        return redisClient;
+    }
+    const redisConfig = appInstance.getConfig('redis');
+    redisClient = createClient({
+        url: redisConfig.url,
+    });
+    redisClient.on('error', (error, b, c) => {
+        appInstance.logger?.error('Redis Client Error', error, b, c);
+    });
+    redisClient.on('connect', () => {
+        appInstance.logger?.info('Redis connection established');
+    });
+    appInstance.events.on('shutdown', async () => {
+        if (redisClient) {
+            await redisClient.quit();
+            redisClient = null;
+        }
+    });
+    return redisClient;
+};
+//# sourceMappingURL=redisConnection.js.map

package/dist/helpers/redis/redisConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redisConnection.js","sourceRoot":"","sources":["../../../src/helpers/redis/redisConnection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,IAAI,WAAW,GAA2B,IAAI,CAAC;AAE/C,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,IAA8B,EAAE;IACjE,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,gBAAgB,GAAG,oBAAoB,EAAE,CAAC;IAChD,MAAM,gBAAgB,CAAC,OAAO,EAAE,CAAC;IAEjC,OAAO,gBAAgB,CAAC;AAC1B,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAoB,EAAE;IACtD,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,gBAAgB,GAAG,oBAAoB,EAAE,CAAC;IAChD,yCAAyC;IACzC,CAAC,KAAK,IAAI,EAAE;QACV,MAAM,gBAAgB,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,gBAAgB,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,GAAoB,EAAE;IACjD,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,OAAO,CAEhD,CAAC;IAEF,WAAW,GAAG,YAAY,CAAC;QACzB,GAAG,EAAE,WAAW,CAAC,GAAG;KACrB,CAAC,CAAC;IAEH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;QACtC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,oBAAoB,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QAC7B,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE;QAC3C,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;YACzB,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC"}

package/dist/helpers/yup.d.ts

@@ -0,0 +1,13 @@
+import { Schema } from 'yup';
+/**
+ * Validator for file
+ * use as
+ * @example
+ * request: yup.object().shape({
+ *          someFile: new YupFile().required(),
+ * })
+ */
+declare class YupFile extends Schema {
+    constructor();
+}
+export { YupFile };

package/dist/helpers/yup.js

@@ -0,0 +1,21 @@
+import { PersistentFile } from 'formidable';
+import { Schema } from 'yup';
+/**
+ * Validator for file
+ * use as
+ * @example
+ * request: yup.object().shape({
+ *          someFile: new YupFile().required(),
+ * })
+ */
+class YupFile extends Schema {
+    constructor() {
+        super({
+            type: 'file',
+            check: (value) => Array.isArray(value) &&
+                value.every((item) => item instanceof PersistentFile),
+        });
+    }
+}
+export { YupFile };
+//# sourceMappingURL=yup.js.map

package/dist/helpers/yup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yup.js","sourceRoot":"","sources":["../../src/helpers/yup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAE7B;;;;;;;GAOG;AACH,MAAM,OAAQ,SAAQ,MAAM;IAC1B;QACE,KAAK,CAAC;YACJ,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,CAAC,KAAc,EAAE,EAAE,CACxB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBACpB,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,YAAY,cAAc,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;CACF;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,7 @@
+import folderConfig from "./folderConfig.js";
+import Server from "./server.js";
+const server = new Server(folderConfig);
+server.startServer().then(() => {
+    console.log(server.app.controllerManager?.controllers);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;AAExC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IAC7B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC"}

package/dist/models/Lock.d.ts

@@ -0,0 +1,90 @@
+import type { Schema } from 'mongoose';
+import type { GetModelTypeFromClass, GetModelTypeLiteFromSchema } from '../modules/BaseModel.ts';
+import { BaseModel } from '../modules/BaseModel.ts';
+export type TLock = GetModelTypeFromClass<typeof Lock>;
+declare class Lock extends BaseModel {
+    static initHooks(schema: Schema): void;
+    static get modelSchema(): {
+        readonly _id: {
+            readonly type: StringConstructor;
+            readonly required: true;
+        };
+        readonly expiredAt: {
+            readonly type: DateConstructor;
+        };
+    };
+    static get modelStatics(): {
+        /**
+         * acquire lock based on lock name
+         * @param {string} name
+         * @param {number} [ttlSeconds=30]
+         */
+        readonly acquireLock: (this: GetModelTypeLiteFromSchema<{
+            readonly _id: {
+                readonly type: StringConstructor;
+                readonly required: true;
+            };
+            readonly expiredAt: {
+                readonly type: DateConstructor;
+            };
+        }, {}>, name: string, ttlSeconds?: number) => Promise<boolean>;
+        /**
+         * release lock based on lock name
+         * @param {string} name
+         */
+        readonly releaseLock: (this: GetModelTypeLiteFromSchema<{
+            readonly _id: {
+                readonly type: StringConstructor;
+                readonly required: true;
+            };
+            readonly expiredAt: {
+                readonly type: DateConstructor;
+            };
+        }, {}>, name: string) => Promise<boolean>;
+        /**
+         * wait lock based on lock name
+         * @param {string} name
+         */
+        readonly waitForUnlock: (this: GetModelTypeLiteFromSchema<{
+            readonly _id: {
+                readonly type: StringConstructor;
+                readonly required: true;
+            };
+            readonly expiredAt: {
+                readonly type: DateConstructor;
+            };
+        }, {}>, name: string) => Promise<unknown>;
+        /**
+         * get lock remaining time based on lock name
+         * @param {string} name
+         */
+        readonly getLockData: (this: GetModelTypeLiteFromSchema<{
+            readonly _id: {
+                readonly type: StringConstructor;
+                readonly required: true;
+            };
+            readonly expiredAt: {
+                readonly type: DateConstructor;
+            };
+        }, {}>, name: string) => Promise<{
+            ttl: number;
+        }>;
+        /**
+         * get lock remaining time based on lock name
+         * @param {string[]} names
+         */
+        readonly getLocksData: (this: GetModelTypeLiteFromSchema<{
+            readonly _id: {
+                readonly type: StringConstructor;
+                readonly required: true;
+            };
+            readonly expiredAt: {
+                readonly type: DateConstructor;
+            };
+        }, {}>, names: string[]) => Promise<{
+            name: string;
+            ttl: number;
+        }[]>;
+    };
+}
+export default Lock;

package/dist/models/Lock.js

@@ -0,0 +1,97 @@
+import { BaseModel } from "../modules/BaseModel.js";
+class Lock extends BaseModel {
+    static initHooks(schema) {
+        schema.index({ expiredAt: 1 }, { expireAfterSeconds: 0 });
+    }
+    static get modelSchema() {
+        return {
+            _id: { type: String, required: true },
+            expiredAt: {
+                type: Date,
+            },
+        };
+    }
+    static get modelStatics() {
+        return {
+            /**
+             * acquire lock based on lock name
+             * @param {string} name
+             * @param {number} [ttlSeconds=30]
+             */
+            acquireLock: async function (name, ttlSeconds = 30) {
+                try {
+                    await this.create({
+                        _id: name,
+                        expiredAt: new Date(Date.now() + ttlSeconds * 1000),
+                    });
+                }
+                catch (error) {
+                    if (error.code !== 11000) {
+                        // not a duplicate keys
+                        throw error;
+                    }
+                    return false;
+                }
+                return true;
+            },
+            /**
+             * release lock based on lock name
+             * @param {string} name
+             */
+            releaseLock: async function (name) {
+                const res = await this.deleteOne({ _id: name });
+                if (res.acknowledged && res.deletedCount) {
+                    return true;
+                }
+                return false;
+            },
+            /**
+             * wait lock based on lock name
+             * @param {string} name
+             */
+            waitForUnlock: async function (name) {
+                const res = await this.findOne({ _id: name });
+                if (!res) {
+                    return Promise.resolve();
+                }
+                return new Promise((resolve) => {
+                    const stream = this.watch([
+                        { $match: { operationType: 'delete', 'documentKey._id': name } },
+                    ]);
+                    stream.on('change', () => {
+                        stream.close();
+                        resolve(true);
+                    });
+                });
+            },
+            /**
+             * get lock remaining time based on lock name
+             * @param {string} name
+             */
+            getLockData: async function (name) {
+                const res = await this.findOne({ _id: name });
+                if (!res || !res.expiredAt) {
+                    return { ttl: 0 };
+                }
+                return { ttl: res.expiredAt.getTime() - Date.now() };
+            },
+            /**
+             * get lock remaining time based on lock name
+             * @param {string[]} names
+             */
+            getLocksData: async function (names) {
+                const res = await this.find({ _id: { $in: names } });
+                const lockMap = new Map(res.map((lock) => [lock._id, lock]));
+                return names.map((name) => {
+                    const lock = lockMap.get(name);
+                    return {
+                        name,
+                        ttl: lock?.expiredAt ? lock.expiredAt.getTime() - Date.now() : 0,
+                    };
+                });
+            },
+        };
+    }
+}
+export default Lock;
+//# sourceMappingURL=Lock.js.map

package/dist/models/Lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Lock.js","sourceRoot":"","sources":["../../src/models/Lock.ts"],"names":[],"mappings":"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"}

package/dist/models/Migration.d.ts

@@ -0,0 +1,13 @@
+import type { GetModelTypeFromClass } from '../modules/BaseModel.ts';
+import { BaseModel } from '../modules/BaseModel.ts';
+export type TMigration = GetModelTypeFromClass<typeof Migration>;
+declare class Migration extends BaseModel {
+    static get modelSchema(): {
+        readonly migrationFile: {
+            readonly type: StringConstructor;
+            readonly unique: true;
+            readonly required: true;
+        };
+    };
+}
+export default Migration;

package/dist/models/Migration.js

@@ -0,0 +1,14 @@
+import { BaseModel } from "../modules/BaseModel.js";
+class Migration extends BaseModel {
+    static get modelSchema() {
+        return {
+            migrationFile: {
+                type: String,
+                unique: true,
+                required: true,
+            },
+        };
+    }
+}
+export default Migration;
+//# sourceMappingURL=Migration.js.map

package/dist/models/Migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migration.js","sourceRoot":"","sources":["../../src/models/Migration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGpD,MAAM,SAAU,SAAQ,SAAS;IAC/B,MAAM,KAAK,WAAW;QACpB,OAAO;YACL,aAAa,EAAE;gBACb,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,IAAI;aACf;SACO,CAAC;IACb,CAAC;CACF;AAED,eAAe,SAAS,CAAC"}

package/dist/models/Sequence.d.ts

@@ -0,0 +1,28 @@
+import type { GetModelTypeFromClass, GetModelTypeLiteFromSchema } from '../modules/BaseModel.ts';
+import { BaseModel } from '../modules/BaseModel.ts';
+export type TSequence = GetModelTypeFromClass<typeof Sequence>;
+declare class Sequence extends BaseModel {
+    static get modelSchema(): {
+        readonly _id: {
+            readonly type: StringConstructor;
+            readonly required: true;
+        };
+        readonly seq: {
+            readonly type: NumberConstructor;
+            readonly default: 1;
+        };
+    };
+    static get modelStatics(): {
+        readonly getSequence: (this: GetModelTypeLiteFromSchema<{
+            readonly _id: {
+                readonly type: StringConstructor;
+                readonly required: true;
+            };
+            readonly seq: {
+                readonly type: NumberConstructor;
+                readonly default: 1;
+            };
+        }, {}>, forType: string) => Promise<number>;
+    };
+}
+export default Sequence;

package/dist/models/Sequence.js

@@ -0,0 +1,19 @@
+import { BaseModel } from "../modules/BaseModel.js";
+class Sequence extends BaseModel {
+    static get modelSchema() {
+        return {
+            _id: { type: String, required: true },
+            seq: { type: Number, default: 1 },
+        };
+    }
+    static get modelStatics() {
+        return {
+            getSequence: async function (forType) {
+                const sequence = await this.findByIdAndUpdate({ _id: forType }, { $inc: { seq: 1 } }, { new: true, upsert: true });
+                return sequence.seq;
+            },
+        };
+    }
+}
+export default Sequence;
+//# sourceMappingURL=Sequence.js.map

package/dist/models/Sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sequence.js","sourceRoot":"","sources":["../../src/models/Sequence.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAIpD,MAAM,QAAS,SAAQ,SAAS;IAC9B,MAAM,KAAK,WAAW;QACpB,OAAO;YACL,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;YACrC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE;SACzB,CAAC;IACb,CAAC;IAED,MAAM,KAAK,YAAY;QAKrB,OAAO;YACL,WAAW,EAAE,KAAK,WAEhB,OAAe;gBAEf,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAC3C,EAAE,GAAG,EAAE,OAAO,EAAE,EAChB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EACpB,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAC5B,CAAC;gBACF,OAAO,QAAQ,CAAC,GAAG,CAAC;YACtB,CAAC;SACO,CAAC;IACb,CAAC;CACF;AAED,eAAe,QAAQ,CAAC"}