@90soft/parse-server-kit 1.0.0 → 2.0.0

package/dist/swagger/swaggerSpec.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSwaggerSpec = generateSwaggerSpec;
+exports.getSwaggerJson = getSwaggerJson;
+const swaggerRegistry_1 = require("./swaggerRegistry");
+/**
+ * Generate OpenAPI 3.0 specification from registered metadata
+ */
+function generateSwaggerSpec(config) {
+    const models = swaggerRegistry_1.SwaggerRegistry.getModels();
+    const functions = swaggerRegistry_1.SwaggerRegistry.getFunctions();
+    // Build schemas from models
+    const schemas = {};
+    for (const model of models) {
+        schemas[model.className] = {
+            type: 'object',
+            description: model.description,
+            properties: model.properties,
+            required: model.required.length > 0 ? model.required : undefined,
+        };
+    }
+    // Add common schemas
+    schemas['ParseError'] = {
+        type: 'object',
+        properties: {
+            code: { type: 'number', description: 'Error code' },
+            error: { type: 'string', description: 'Error message' },
+        },
+    };
+    schemas['CloudFunctionRequest'] = {
+        type: 'object',
+        properties: {
+            _ApplicationId: { type: 'string', description: 'Application ID' },
+            _SessionToken: {
+                type: 'string',
+                description: 'Session token for authentication',
+            },
+        },
+    };
+    // Build paths from functions
+    const paths = {};
+    const tagSet = new Set();
+    for (const func of functions) {
+        const path = `/functions/${func.name}`;
+        const method = func.method.toLowerCase();
+        // Collect tags
+        if (func.tags) {
+            func.tags.forEach(tag => tagSet.add(tag));
+        }
+        // Build request body schema
+        let requestBody = undefined;
+        if (func.requestBody &&
+            Object.keys(func.requestBody.properties).length > 0) {
+            requestBody = {
+                required: true,
+                content: {
+                    'application/json': {
+                        schema: {
+                            type: 'object',
+                            properties: func.requestBody.properties,
+                            required: Object.entries(func.requestBody.properties)
+                                .filter(([_, v]) => v.required)
+                                .map(([k]) => k),
+                        },
+                    },
+                },
+            };
+        }
+        // Build responses
+        const responses = {};
+        if (func.responses) {
+            for (const [code, response] of Object.entries(func.responses)) {
+                responses[code] = {
+                    description: response.description,
+                    content: response.schema
+                        ? {
+                            'application/json': {
+                                schema: response.schema,
+                            },
+                        }
+                        : {
+                            'application/json': {
+                                schema: {
+                                    type: 'object',
+                                    properties: {
+                                        result: { type: 'object', description: 'Function result' },
+                                    },
+                                },
+                            },
+                        },
+                };
+            }
+        }
+        // Build security requirements (applicationId and restApiKey are always required)
+        const security = func.requiresAuth
+            ? [
+                { applicationId: [], restApiKey: [], sessionToken: [] },
+                { applicationId: [], restApiKey: [], masterKey: [] },
+            ]
+            : [{ applicationId: [], restApiKey: [] }];
+        paths[path] = {
+            ...paths[path],
+            [method]: {
+                tags: func.tags || ['Default'],
+                summary: func.summary,
+                description: func.description,
+                operationId: func.name,
+                security,
+                requestBody,
+                responses,
+            },
+        };
+    }
+    // Build tags array
+    const tags = Array.from(tagSet).map(tag => ({
+        name: tag,
+        description: `${tag} related operations`,
+    }));
+    // Build final spec
+    const spec = {
+        openapi: '3.0.3',
+        info: {
+            title: config.title,
+            version: config.version,
+            description: config.description || 'Auto-generated API documentation',
+        },
+        servers: [
+            {
+                url: config.basePath || process.env.mountPath || '/parse',
+                description: 'Parse Server API',
+            },
+        ],
+        tags,
+        paths,
+        components: {
+            schemas,
+            securitySchemes: {
+                applicationId: {
+                    type: 'apiKey',
+                    in: 'header',
+                    name: 'X-Parse-Application-Id',
+                    description: 'Parse Application ID',
+                },
+                sessionToken: {
+                    type: 'apiKey',
+                    in: 'header',
+                    name: 'X-Parse-Session-Token',
+                    description: 'User session token for authentication',
+                },
+                masterKey: {
+                    type: 'apiKey',
+                    in: 'header',
+                    name: 'X-Parse-Master-Key',
+                    description: 'Master key for admin operations',
+                },
+                restApiKey: {
+                    type: 'apiKey',
+                    in: 'header',
+                    name: 'X-Parse-REST-API-Key',
+                    description: 'REST API key for client requests',
+                },
+            },
+        },
+        security: [{ applicationId: [] }, { restApiKey: [] }],
+    };
+    return spec;
+}
+/**
+ * Get the Swagger specification as JSON
+ */
+function getSwaggerJson(config) {
+    return JSON.stringify(generateSwaggerSpec(config), null, 2);
+}
+//# sourceMappingURL=swaggerSpec.js.map

package/dist/swagger/swaggerSpec.js.map

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

package/dist/utils/ACL.d.ts

@@ -0,0 +1,19 @@
+type RoleRule = {
+    role: string;
+    read?: boolean;
+    write?: boolean;
+};
+type OwnerRule = {
+    user?: string | any;
+    read?: boolean;
+    write?: boolean;
+};
+export declare function implementACL(params: {
+    publicRead?: boolean;
+    publicWrite?: boolean;
+    roleRules?: RoleRule[] | undefined;
+    excludedRoles?: string[];
+    owner?: OwnerRule[];
+}, existingACL?: Parse.ACL): Parse.ACL;
+export {};
+//# sourceMappingURL=ACL.d.ts.map

package/dist/utils/ACL.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ACL.d.ts","sourceRoot":"","sources":["../../src/utils/ACL.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAC,CAAC;AAChE,KAAK,SAAS,GAAG;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAC,CAAC;AAExE,wBAAgB,YAAY,CAC1B,MAAM,EAAE;IACN,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACrB,EACD,WAAW,CAAC,EAAE,KAAK,CAAC,GAAG,GACtB,KAAK,CAAC,GAAG,CAgCX"}

package/dist/utils/ACL.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.implementACL = implementACL;
+function implementACL(params, existingACL) {
+    const { publicRead = false, publicWrite = false, roleRules, excludedRoles = [], owner = [], } = params;
+    const acl = existingACL ?? new Parse.ACL();
+    acl.setPublicReadAccess(!!publicRead);
+    acl.setPublicWriteAccess(!!publicWrite);
+    for (const { role, read = false, write = false } of roleRules ?? []) {
+        if (excludedRoles.includes(role))
+            continue;
+        if (read)
+            acl.setRoleReadAccess(role, true);
+        else
+            acl.setRoleReadAccess(role, false);
+        if (write)
+            acl.setRoleWriteAccess(role, true);
+        else
+            acl.setRoleWriteAccess(role, false);
+    }
+    for (const { user, read = false, write = false } of owner) {
+        if (user !== undefined) {
+            if (read)
+                acl.setReadAccess(user, true);
+            else
+                acl.setReadAccess(user, false);
+            if (write)
+                acl.setWriteAccess(user, true);
+            else
+                acl.setWriteAccess(user, false);
+        }
+    }
+    return acl;
+}
+//# sourceMappingURL=ACL.js.map

package/dist/utils/ACL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ACL.js","sourceRoot":"","sources":["../../src/utils/ACL.ts"],"names":[],"mappings":";;AAGA,oCAyCC;AAzCD,SAAgB,YAAY,CAC1B,MAMC,EACD,WAAuB;IAEvB,MAAM,EACJ,UAAU,GAAG,KAAK,EAClB,WAAW,GAAG,KAAK,EACnB,SAAS,EACT,aAAa,GAAG,EAAE,EAClB,KAAK,GAAG,EAAE,GACX,GAAG,MAAM,CAAC;IAEX,MAAM,GAAG,GAAG,WAAW,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;IAE3C,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACtC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAExC,KAAK,MAAM,EAAC,IAAI,EAAE,IAAI,GAAG,KAAK,EAAE,KAAK,GAAG,KAAK,EAAC,IAAI,SAAS,IAAI,EAAE,EAAE,CAAC;QAClE,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAS;QAC3C,IAAI,IAAI;YAAE,GAAG,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;;YACvC,GAAG,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxC,IAAI,KAAK;YAAE,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;;YACzC,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,MAAM,EAAC,IAAI,EAAE,IAAI,GAAG,KAAK,EAAE,KAAK,GAAG,KAAK,EAAC,IAAI,KAAK,EAAE,CAAC;QACxD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,IAAI;gBAAE,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;;gBACnC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACpC,IAAI,KAAK;gBAAE,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;;gBACrC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/utils/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * User Roles — override these in your project by re-exporting with your own values.
+ * These are the defaults for the template.
+ */
+export declare enum UserRoles {
+    ADMIN = "SuperAdmin",
+    EMPLOYEE = "Employee"
+}
+export type RoleString = `role:${UserRoles}`;
+export declare function roleKey(role: UserRoles): RoleString;
+/** Maximum limit for unbounded Parse queries */
+export declare const MAX_QUERY_LIMIT = 10000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,SAAS;IACnB,KAAK,eAAe;IACpB,QAAQ,aAAa;CACtB;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,SAAS,EAAE,CAAC;AAE7C,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAEnD;AAED,gDAAgD;AAChD,eAAO,MAAM,eAAe,QAAQ,CAAC"}

package/dist/utils/constants.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_QUERY_LIMIT = exports.UserRoles = void 0;
+exports.roleKey = roleKey;
+/**
+ * User Roles — override these in your project by re-exporting with your own values.
+ * These are the defaults for the template.
+ */
+var UserRoles;
+(function (UserRoles) {
+    UserRoles["ADMIN"] = "SuperAdmin";
+    UserRoles["EMPLOYEE"] = "Employee";
+})(UserRoles || (exports.UserRoles = UserRoles = {}));
+function roleKey(role) {
+    return `role:${role}`;
+}
+/** Maximum limit for unbounded Parse queries */
+exports.MAX_QUERY_LIMIT = 10000;
+//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":";;;AAWA,0BAEC;AAbD;;;GAGG;AACH,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,iCAAoB,CAAA;IACpB,kCAAqB,CAAA;AACvB,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB;AAID,SAAgB,OAAO,CAAC,IAAe;IACrC,OAAO,QAAQ,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,gDAAgD;AACnC,QAAA,eAAe,GAAG,KAAK,CAAC"}

package/dist/utils/dynamicImport.d.ts

@@ -0,0 +1,2 @@
+export declare const importFiles: (directoryPath: string) => void;
+//# sourceMappingURL=dynamicImport.d.ts.map

package/dist/utils/dynamicImport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamicImport.d.ts","sourceRoot":"","sources":["../../src/utils/dynamicImport.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW,GAAI,eAAe,MAAM,SAWhD,CAAC"}

package/dist/utils/dynamicImport.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.importFiles = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const isDirectory = (path) => (0, fs_1.statSync)(path).isDirectory();
+const importFiles = (directoryPath) => {
+    const files = (0, fs_1.readdirSync)(directoryPath);
+    files.forEach(file => {
+        const filePath = (0, path_1.join)(directoryPath, file);
+        if (isDirectory(filePath)) {
+            (0, exports.importFiles)(filePath);
+        }
+        else if ((0, path_1.extname)(filePath) === '.js') {
+            console.log(filePath);
+            require(filePath);
+        }
+    });
+};
+exports.importFiles = importFiles;
+//# sourceMappingURL=dynamicImport.js.map

package/dist/utils/dynamicImport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamicImport.js","sourceRoot":"","sources":["../../src/utils/dynamicImport.ts"],"names":[],"mappings":";;;AAAA,2BAAyC;AACzC,+BAAmC;AAEnC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAA,aAAQ,EAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AAE5D,MAAM,WAAW,GAAG,CAAC,aAAqB,EAAE,EAAE;IACnD,MAAM,KAAK,GAAG,IAAA,gBAAW,EAAC,aAAa,CAAC,CAAC;IACzC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACnB,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,IAAA,mBAAW,EAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;aAAM,IAAI,IAAA,cAAO,EAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;YACvC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtB,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAXW,QAAA,WAAW,eAWtB"}

package/dist/utils/helper.d.ts

@@ -0,0 +1,15 @@
+export declare function formatCount(num: any, locale?: string): string;
+export declare function generateRandomPassword(length?: number, includeNumbers?: boolean, includeSymbols?: boolean): string;
+export declare function generateRandomInteger(length: number): string;
+export declare function generateRandomString(length?: number): string;
+export declare function sleep(ms: number): Promise<unknown>;
+export declare function catchError<T>(promise: Promise<T>): Promise<[undefined, T] | [Error]>;
+/**
+ * Get role names for a single user
+ */
+export declare function getUserRoles(user: Parse.User): Promise<string[]>;
+/**
+ * Get role names for multiple users (batch — avoids N+1)
+ */
+export declare function getUsersRoles(users: Parse.User[]): Promise<Map<string, string[]>>;
+//# sourceMappingURL=helper.d.ts.map

package/dist/utils/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../src/utils/helper.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,SAAO,UAMlD;AAED,wBAAgB,sBAAsB,CACpC,MAAM,SAAI,EACV,cAAc,UAAO,EACrB,cAAc,UAAO,UAiBtB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,UAInD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,SAAI,GAAG,MAAM,CAOvD;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,oBAE/B;AAED,wBAAsB,UAAU,CAAC,CAAC,EAChC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAQnC;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKtE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAmBvF"}

package/dist/utils/helper.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatCount = formatCount;
+exports.generateRandomPassword = generateRandomPassword;
+exports.generateRandomInteger = generateRandomInteger;
+exports.generateRandomString = generateRandomString;
+exports.sleep = sleep;
+exports.catchError = catchError;
+exports.getUserRoles = getUserRoles;
+exports.getUsersRoles = getUsersRoles;
+function formatCount(num, locale = 'en') {
+    return new Intl.NumberFormat(locale, {
+        notation: 'compact',
+        compactDisplay: 'short',
+        maximumFractionDigits: 1,
+    }).format(num ?? 0);
+}
+function generateRandomPassword(length = 8, includeNumbers = true, includeSymbols = true) {
+    const lowerCaseChars = 'abcdefghijklmnopqrstuvwxyz';
+    const upperCaseChars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+    const numberChars = '0123456789';
+    const symbolChars = '!@#$%^&*()-_=+[]{}|;:,.<>?';
+    let charSet = lowerCaseChars + upperCaseChars;
+    if (includeNumbers)
+        charSet += numberChars;
+    if (includeSymbols)
+        charSet += symbolChars;
+    let password = '';
+    for (let i = 0; i < length; i++) {
+        const randomIndex = Math.floor(Math.random() * charSet.length);
+        password += charSet[randomIndex];
+    }
+    return password;
+}
+function generateRandomInteger(length) {
+    const min = Math.pow(10, length - 1);
+    const max = Math.pow(10, length) - 1;
+    return (Math.floor(Math.random() * (max - min + 1)) + min).toString();
+}
+function generateRandomString(length = 8) {
+    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+async function catchError(promise) {
+    return promise
+        .then(data => {
+        return [undefined, data];
+    })
+        .catch(err => {
+        return [err];
+    });
+}
+/**
+ * Get role names for a single user
+ */
+async function getUserRoles(user) {
+    const roleQuery = new Parse.Query('_Role');
+    roleQuery.equalTo('users', user);
+    const roles = await roleQuery.find({ useMasterKey: true });
+    return roles.map(r => r.get('name'));
+}
+/**
+ * Get role names for multiple users (batch — avoids N+1)
+ */
+async function getUsersRoles(users) {
+    if (users.length === 0)
+        return new Map();
+    const allRoles = await new Parse.Query('_Role').limit(100).find({ useMasterKey: true });
+    const userRolesMap = new Map();
+    for (const user of users) {
+        userRolesMap.set(user.id, []);
+    }
+    for (const role of allRoles) {
+        const usersRelation = role.getUsers().query();
+        usersRelation.containedIn('objectId', users.map(u => u.id));
+        usersRelation.limit(users.length);
+        const roleUsers = await usersRelation.find({ useMasterKey: true });
+        for (const u of roleUsers) {
+            const existing = userRolesMap.get(u.id) || [];
+            existing.push(role.get('name'));
+            userRolesMap.set(u.id, existing);
+        }
+    }
+    return userRolesMap;
+}
+//# sourceMappingURL=helper.js.map

package/dist/utils/helper.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@90soft/parse-server-kit",
-  "version": "1.0.0",
-  "description": "Decorator-driven development kit for Parse Server — @ParseClass, @ParseField, BaseModel, and more.",
+  "version": "2.0.0",
+  "description": "Complete decorator-driven development kit for Parse Server — models, cloud functions, triggers, cron, routing, ACL, Swagger, and more.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -17,7 +17,10 @@
     "typescript",
     "backend",
     "cloud-functions",
-    "mongodb"
+    "mongodb",
+    "acl",
+    "swagger",
+    "cron"
   ],
   "author": "90Soft",
   "license": "MIT",
@@ -27,12 +30,25 @@
   },
   "peerDependencies": {
     "parse": ">=5.0.0",
-    "reflect-metadata": ">=0.1.13"
+    "reflect-metadata": ">=0.1.13",
+    "express": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "node-cron": {
+      "optional": true
+    },
+    "swagger-ui-express": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "typescript": "^5.5.0",
     "@types/node": "^20.0.0",
+    "@types/express": "^5.0.0",
     "parse": "^5.3.0",
-    "reflect-metadata": "^0.2.2"
+    "reflect-metadata": "^0.2.2",
+    "express": "^5.0.0",
+    "swagger-ui-express": "^5.0.1",
+    "node-cron": "^4.0.0"
   }
 }