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

package/README.md

@@ -0,0 +1,424 @@
+# @90soft/parse-server-kit
+
+Decorator-driven development kit for Parse Server. Write models and cloud functions with TypeScript decorators — no boilerplate.
+
+## Install
+
+```bash
+npm install @90soft/parse-server-kit
+```
+
+Peer dependencies: `parse`, `reflect-metadata`, `express`
+Optional: `node-cron` (for @Cron), `swagger-ui-express` (for Swagger)
+
+---
+
+## Quick Start
+
+### 1. Define a Model
+
+```ts
+import { ParseClass, ParseField, BaseModel } from '@90soft/parse-server-kit';
+import { UserRoles, roleKey } from '@90soft/parse-server-kit';
+
+@ParseClass('Product', {
+  clp: {
+    find:   { [roleKey(UserRoles.ADMIN)]: true, [roleKey(UserRoles.EMPLOYEE)]: true },
+    get:    { [roleKey(UserRoles.ADMIN)]: true, [roleKey(UserRoles.EMPLOYEE)]: true },
+    create: { [roleKey(UserRoles.ADMIN)]: true, [roleKey(UserRoles.EMPLOYEE)]: true },
+    update: { [roleKey(UserRoles.ADMIN)]: true, [roleKey(UserRoles.EMPLOYEE)]: true },
+    delete: { [roleKey(UserRoles.ADMIN)]: true },
+    count:  { [roleKey(UserRoles.ADMIN)]: true, [roleKey(UserRoles.EMPLOYEE)]: true },
+  },
+})
+export default class Product extends BaseModel {
+  @ParseField({ type: 'String', required: true })
+  name!: string;
+
+  @ParseField({ type: 'Number', required: true, min: 0 })
+  price!: number;
+
+  @ParseField({ type: 'String', enum: ['active', 'draft', 'archived'] })
+  status!: string;
+
+  @ParseField({ type: 'Pointer', targetClass: 'Category', required: true })
+  category!: any;
+
+  @ParseField({ type: 'Boolean' })
+  available!: boolean;
+
+  @ParseField({ type: 'Date' })
+  createdDate!: Date;
+}
+```
+
+### 2. Write Cloud Functions
+
+```ts
+import { CloudFunction, Route, catchError, UserRoles } from '@90soft/parse-server-kit';
+import Product from '../../models/Product';
+import User from '../../models/User';
+
+@Route(Product) // → /api/products/create, /api/products/list, etc.
+class ProductFunctions {
+
+  @CloudFunction({
+    methods: ['POST'],
+    validation: { requireUser: true, fields: { name: { required: true } } },
+  })
+  static async createProduct(req: Parse.Cloud.FunctionRequest) {
+    const user = req.user! as User;
+    const product = Product.fromParams(req.params);
+    const [err, saved] = await catchError(
+      product.save(null, { sessionToken: user.getSessionToken() })
+    );
+    if (err) throw err;
+    return saved;
+  }
+
+  @CloudFunction({
+    methods: ['GET'],
+    validation: { requireUser: true, fields: { skip: { type: String }, limit: { type: String } } },
+  })
+  static async listProducts(req: Parse.Cloud.FunctionRequest) {
+    const query = new Parse.Query(Product);
+    query.include('category');
+    const skip = Number(req.params.skip) || 0;
+    const limit = Number(req.params.limit) || 10;
+    query.skip(skip).limit(limit);
+
+    if (req.params.search) {
+      const search = req.params.search;
+      query.matches('name', new RegExp(search, 'i'));
+    }
+
+    const [err, results] = await catchError(query.find({ sessionToken: req.user!.getSessionToken() }));
+    if (err) throw err;
+
+    const [countErr, count] = await catchError(query.count({ sessionToken: req.user!.getSessionToken() }));
+    return { results, count: countErr ? 0 : count };
+  }
+
+  @CloudFunction({
+    methods: ['POST'],
+    validation: { requireUser: true, fields: { id: { required: true } } },
+  })
+  static async getProduct(req: Parse.Cloud.FunctionRequest) {
+    const query = new Parse.Query(Product);
+    query.include('category');
+    const [err, product] = await catchError(query.get(req.params.id, { sessionToken: req.user!.getSessionToken() }));
+    if (err) throw err;
+    return product;
+  }
+
+  @CloudFunction({
+    methods: ['POST'],
+    validation: { requireUser: true, fields: { id: { required: true } } },
+  })
+  static async updateProduct(req: Parse.Cloud.FunctionRequest) {
+    const user = req.user! as User;
+    const product = Product.fromParams(req.params);
+    const [err, saved] = await catchError(
+      product.save(null, { sessionToken: user.getSessionToken() })
+    );
+    if (err) throw err;
+    return saved;
+  }
+
+  @CloudFunction({
+    methods: ['POST'],
+    validation: { requireUser: true, fields: { id: { required: true } } },
+  })
+  static async deleteProduct(req: Parse.Cloud.FunctionRequest) {
+    const query = new Parse.Query(Product);
+    const [err, product] = await catchError(query.get(req.params.id, { useMasterKey: true }));
+    if (err) throw err;
+    const [delErr] = await catchError(product!.destroy({ useMasterKey: true }));
+    if (delErr) throw delErr;
+    return { success: true };
+  }
+}
+```
+
+### 3. Add Triggers
+
+```ts
+import { ParseClass, ParseField, BaseModel, BeforeSave, AfterDelete } from '@90soft/parse-server-kit';
+
+@ParseClass('Product', { /* clp... */ })
+export default class Product extends BaseModel {
+  @ParseField({ type: 'String', required: true })
+  name!: string;
+
+  @BeforeSave()
+  static async onBeforeSave(req: Parse.Cloud.BeforeSaveRequest<Product>) {
+    // Validate or modify before saving
+    if (!req.object.get('name')) {
+      throw new Parse.Error(142, 'Name is required');
+    }
+  }
+
+  @AfterDelete()
+  static async onAfterDelete(req: Parse.Cloud.AfterDeleteRequest<Product>) {
+    // Cleanup after deletion
+    console.log(`Product ${req.object.id} deleted`);
+  }
+}
+```
+
+### 4. Add Cron Jobs
+
+```ts
+import { Cron, CronSchedule } from '@90soft/parse-server-kit';
+
+class MyCronJobs {
+  @Cron({ schedule: CronSchedule.DAILY_MIDNIGHT, description: 'Cleanup expired sessions' })
+  static async cleanupSessions() {
+    // job logic
+  }
+
+  @Cron({ schedule: '*/30 * * * *', description: 'Sync data every 30 minutes' })
+  static async syncData() {
+    // job logic
+  }
+}
+```
+
+### 5. Server Setup (app.ts)
+
+```ts
+import express from 'express';
+import {
+  CloudFunctionRegistry, TriggerRegistry, CronRegistry,
+  importFiles, catchError, applyMongoValidators,
+  validateEntityRoutes, restrictRoutes, removeResultMiddleware,
+  conditionalJsonMiddleware, setupSwagger,
+} from '@90soft/parse-server-kit';
+
+const app = express();
+
+// 1. Load models (must be before Parse Server init)
+importFiles(join(__dirname, 'cloudCode/models'));
+
+// 2. Init Parse Server
+const parseServer = await initializeParseServer();
+
+// 3. Middleware
+app.use(removeResultMiddleware);
+app.use(cors());
+app.use(process.env.mountPath, validateEntityRoutes);
+app.use(conditionalJsonMiddleware);
+app.use(process.env.mountPath, restrictRoutes);
+
+// 4. Mount Parse Server
+app.use(process.env.mountPath, parseServer.app);
+
+// 5. Initialize registries (after Parse Server mount)
+CloudFunctionRegistry.initialize();  // also initializes RouteRegistry
+TriggerRegistry.initialize();
+CronRegistry.initialize();
+
+// 6. Swagger docs
+setupSwagger(app, { title: 'My API', version: '1.0.0' });
+
+// 7. Start server
+server.listen(1337);
+```
+
+---
+
+## API Reference
+
+### Decorators
+
+| Decorator | Target | Description |
+|---|---|---|
+| `@ParseClass(name, options)` | Class | Registers a Parse model with CLP, ACL, indexes |
+| `@ParseField(options)` | Property | Defines a field with type, validation, index |
+| `@CloudFunction(config)` | Static method | Registers a cloud function with HTTP method, validation, roles |
+| `@ProtectedCloudFunction(config)` | Static method | Same as @CloudFunction but requires auth by default |
+| `@Route(ModelOrString)` | Class | Maps cloud functions to `/api/{entity}/{action}` routes |
+| `@Cron(config)` | Static method | Registers a cron job with schedule |
+| `@BeforeSave(config?)` | Static method | Before save trigger |
+| `@AfterSave(config?)` | Static method | After save trigger |
+| `@BeforeDelete(config?)` | Static method | Before delete trigger |
+| `@AfterDelete(config?)` | Static method | After delete trigger |
+| `@BeforeFind(config?)` | Static method | Before find trigger |
+| `@AfterFind(config?)` | Static method | After find trigger |
+| `@BeforeLogin(config?)` | Static method | Before login trigger |
+| `@AfterLogin(config?)` | Static method | After login trigger |
+| `@AfterLogout(config?)` | Static method | After logout trigger |
+
+### @ParseField Options
+
+| Option | Type | Description |
+|---|---|---|
+| `type` | `'String' \| 'Number' \| 'Boolean' \| 'Date' \| 'Pointer' \| 'Array' \| ...` | Field type |
+| `required` | `boolean` | Whether the field is required |
+| `targetClass` | `string` | Target class for Pointer/Relation |
+| `index` | `boolean \| 1 \| -1` | Create an index |
+| `unique` | `boolean` | Create a unique index |
+| `min` / `max` | `number` | Number range validation |
+| `minLength` / `maxLength` | `number` | String length validation |
+| `enum` | `string[]` | Allowed values for String fields |
+| `pattern` | `string` | Regex pattern for String fields |
+| `description` | `string` | Swagger documentation |
+
+### @Route
+
+```ts
+// Import model class — auto-generates route from className
+@Route(Product)  // → /api/products/*
+
+// Custom string — full control over route prefix
+@Route('menu-items')  // → /api/menu-items/*
+```
+
+Routes are automatically mapped:
+```
+createProduct  → POST /api/products/create
+getProduct     → POST /api/products/get
+listProducts   → GET  /api/products/list
+updateProduct  → POST /api/products/update
+deleteProduct  → POST /api/products/delete
+```
+
+### BaseModel
+
+```ts
+// Create from request params (auto-maps fields, handles pointers)
+const product = Product.fromParams(req.params);
+
+// Create a pointer reference by ID
+const category = Category.pointer('abc123');
+
+// Override excluded pointer classes (default: ['IMG', 'File'])
+class MyModel extends BaseModel {
+  protected static EXCLUDED_POINTER_CLASSES = ['IMG', 'File', 'CustomFile'];
+}
+```
+
+### ACL
+
+```ts
+import { implementACL, UserRoles } from '@90soft/parse-server-kit';
+
+obj.setACL(implementACL({
+  roleRules: [
+    { role: UserRoles.ADMIN, read: true, write: true },
+    { role: UserRoles.EMPLOYEE, read: true },
+  ],
+  owner: [
+    { user: userId, read: true, write: true },
+  ],
+}));
+```
+
+### Utilities
+
+```ts
+import {
+  catchError,          // Wraps promises: const [err, data] = await catchError(promise)
+  getUserRoles,        // Get role names for a user
+  getUsersRoles,       // Batch get roles for multiple users
+  importFiles,         // Auto-import all .js files in a directory
+  generateRandomPassword,
+  generateRandomString,
+  sleep,
+  formatCount,
+} from '@90soft/parse-server-kit';
+```
+
+### Middleware
+
+```ts
+import {
+  validateEntityRoutes,       // Maps /api/{entity}/{action} → cloud functions
+  restrictRoutes,             // Blocks /classes, /schemas, etc.
+  removeResultMiddleware,     // Unwraps Parse {result: ...} wrapper
+  conditionalJsonMiddleware,  // JSON parsing with master key extraction
+  validateFunctionRoutes,     // Legacy /functions/* validation
+} from '@90soft/parse-server-kit';
+```
+
+### Swagger
+
+```ts
+import { setupSwagger, SwaggerRegistry } from '@90soft/parse-server-kit';
+
+// Auto-generates API docs from @ParseClass and @CloudFunction metadata
+setupSwagger(app, {
+  title: 'My API',
+  version: '1.0.0',
+  description: 'Auto-generated docs',
+});
+// Access at: http://localhost:1337/api-docs
+```
+
+### Hooks (for integrations)
+
+```ts
+import { onClassRegistered, onFieldRegistered, onFunctionRegistered } from '@90soft/parse-server-kit';
+
+// Runs when @ParseClass is applied
+onClassRegistered((className, constructor, fields, options) => {
+  // Register with Swagger, setup triggers, etc.
+});
+
+// Runs when @CloudFunction is applied
+onFunctionRegistered((name, config, target) => {
+  // Register with Swagger docs
+});
+```
+
+### Constants
+
+```ts
+import { UserRoles, roleKey, MAX_QUERY_LIMIT, CronSchedule } from '@90soft/parse-server-kit';
+
+UserRoles.ADMIN      // 'SuperAdmin'
+UserRoles.EMPLOYEE   // 'Employee'
+roleKey(UserRoles.ADMIN)  // 'role:SuperAdmin'
+MAX_QUERY_LIMIT      // 10000
+
+CronSchedule.EVERY_HOUR      // '0 * * * *'
+CronSchedule.DAILY_MIDNIGHT  // '0 0 * * *'
+CronSchedule.WEEKLY_MONDAY   // '0 0 * * 1'
+```
+
+### Validation
+
+```ts
+import { validateObject, validateOrThrow, applyMongoValidators } from '@90soft/parse-server-kit';
+
+// Validate against @ParseField constraints (min, max, enum, pattern, etc.)
+const result = validateObject(parseObject);
+// { valid: false, errors: [{ field: 'price', message: 'must be at least 0' }] }
+
+// Throw Parse.Error if invalid (use in BeforeSave triggers)
+validateOrThrow(parseObject);
+
+// Apply MongoDB schema validators from decorator metadata
+await applyMongoValidators(parseServerInstance);
+```
+
+---
+
+## File Structure Convention
+
+```
+backend/src/cloudCode/
+  ├── models/
+  │   └── Product.ts              ← @ParseClass + @ParseField + triggers
+  ├── modules/
+  │   └── Product/
+  │       └── functions.ts        ← @Route + @CloudFunction
+  ├── cron.ts                     ← @Cron jobs
+  ├── main.ts                     ← importFiles for models + modules
+  └── decorator/
+      └── setupHooks.ts           ← connects package hooks to Swagger + Triggers
+```
+
+## License
+
+MIT

package/dist/decorators/cloudDecorator.d.ts

@@ -0,0 +1,7 @@
+import { RouteConfig } from './types/cloudTypes';
+type OnFunctionRegistered = (name: string, config: RouteConfig, target: any) => void;
+export declare function onFunctionRegistered(hook: OnFunctionRegistered): void;
+export declare function CloudFunction(config: RouteConfig): (target: any, propertyKey: string, descriptor?: PropertyDescriptor | undefined) => PropertyDescriptor;
+export declare function ProtectedCloudFunction(config?: Partial<RouteConfig>): (target: any, propertyKey: string, descriptor?: PropertyDescriptor | undefined) => PropertyDescriptor;
+export {};
+//# sourceMappingURL=cloudDecorator.d.ts.map

package/dist/decorators/cloudDecorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudDecorator.d.ts","sourceRoot":"","sources":["../../src/decorators/cloudDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,WAAW,EAAC,MAAM,oBAAoB,CAAC;AAKtE,KAAK,oBAAoB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;AAErF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,oBAAoB,QAE9D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,IAE7C,QAAQ,GAAG,EACX,aAAa,MAAM,EACnB,aAAa,kBAAkB,GAAG,SAAS,wBAkC9C;AAoCD,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,YAxE5D,GAAG,eACE,MAAM,eACN,kBAAkB,GAAG,SAAS,wBA4E9C"}

package/dist/decorators/cloudDecorator.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onFunctionRegistered = onFunctionRegistered;
+exports.CloudFunction = CloudFunction;
+exports.ProtectedCloudFunction = ProtectedCloudFunction;
+const helper_1 = require("../utils/helper");
+const cloudRegistry_1 = require("./cloudRegistry");
+const functionHooks = [];
+function onFunctionRegistered(hook) {
+    functionHooks.push(hook);
+}
+function CloudFunction(config) {
+    return function (target, propertyKey, descriptor) {
+        if (!descriptor) {
+            descriptor = Object.getOwnPropertyDescriptor(target, propertyKey);
+        }
+        if (!descriptor) {
+            throw new Error(`Descriptor not found for property ${propertyKey}`);
+        }
+        const originalMethod = descriptor.value;
+        // Wrap with role checking
+        descriptor.value = async function (...args) {
+            const request = args[0];
+            if (config.requireRoles) {
+                await checkUserRoles(request, config);
+            }
+            return originalMethod.apply(this, args);
+        };
+        const metadata = {
+            name: propertyKey,
+            config,
+            handler: descriptor.value,
+        };
+        cloudRegistry_1.CloudFunctionRegistry.register(metadata);
+        // Notify hooks (Swagger, etc.)
+        for (const hook of functionHooks) {
+            hook(propertyKey, config, target);
+        }
+        return descriptor;
+    };
+}
+async function checkUserRoles(request, config) {
+    const user = request.user;
+    if (!user) {
+        throw new Parse.Error(Parse.Error.OBJECT_NOT_FOUND, 'Authentication required');
+    }
+    if (!config.requireRoles || config.requireRoles.length === 0)
+        return;
+    const roleQuery = new Parse.Query('_Role');
+    roleQuery.containedIn('name', config.requireRoles);
+    roleQuery.equalTo('users', user);
+    const [error, userRoles] = await (0, helper_1.catchError)(roleQuery.find({ useMasterKey: true }));
+    if (error) {
+        throw new Parse.Error(Parse.Error.OTHER_CAUSE, 'Authorization check failed');
+    }
+    let hasPermission = false;
+    if (config.requireAllRoles) {
+        const userRoleNames = userRoles.map(role => role.get('name'));
+        hasPermission = config.requireRoles.every(role => userRoleNames.includes(role));
+    }
+    else {
+        hasPermission = userRoles.length > 0;
+    }
+    if (!hasPermission) {
+        const msg = config.customErrorMessage ||
+            `Access denied. Required ${config.requireAllRoles ? 'all' : 'one of'} these roles: ${config.requireRoles.join(', ')}`;
+        throw new Parse.Error(Parse.Error.OPERATION_FORBIDDEN, msg);
+    }
+}
+function ProtectedCloudFunction(config = {}) {
+    return CloudFunction({
+        methods: ['POST'],
+        validation: { requireUser: true },
+        ...config,
+    });
+}
+//# sourceMappingURL=cloudDecorator.js.map

package/dist/decorators/cloudDecorator.js.map

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

package/dist/decorators/cloudRegistry.d.ts

@@ -0,0 +1,9 @@
+import { CloudFunctionMetadata } from './types/cloudTypes';
+export declare class CloudFunctionRegistry {
+    private static functions;
+    static register(metadata: CloudFunctionMetadata): void;
+    static getFunctions(): CloudFunctionMetadata[];
+    static getFunction(name: string): CloudFunctionMetadata | undefined;
+    static initialize(): void;
+}
+//# sourceMappingURL=cloudRegistry.d.ts.map

package/dist/decorators/cloudRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudRegistry.d.ts","sourceRoot":"","sources":["../../src/decorators/cloudRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,qBAAqB,EAAC,MAAM,oBAAoB,CAAC;AAGzD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAiD;IAEzE,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB;IAI/C,MAAM,CAAC,YAAY;IAInB,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM;IAI/B,MAAM,CAAC,UAAU;CASlB"}

package/dist/decorators/cloudRegistry.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudFunctionRegistry = void 0;
+const routeDecorator_1 = require("./routeDecorator");
+class CloudFunctionRegistry {
+    static register(metadata) {
+        this.functions.set(metadata.name, metadata);
+    }
+    static getFunctions() {
+        return Array.from(this.functions.values());
+    }
+    static getFunction(name) {
+        return this.functions.get(name);
+    }
+    static initialize() {
+        this.functions.forEach(metadata => {
+            Parse.Cloud.define(metadata.name, metadata.handler, metadata.config.validation);
+            console.log(`Registered cloud function: ${metadata.name}`);
+        });
+        // Build entity-based route map after all functions are registered
+        routeDecorator_1.RouteRegistry.initialize();
+    }
+}
+exports.CloudFunctionRegistry = CloudFunctionRegistry;
+CloudFunctionRegistry.functions = new Map();
+//# sourceMappingURL=cloudRegistry.js.map

package/dist/decorators/cloudRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudRegistry.js","sourceRoot":"","sources":["../../src/decorators/cloudRegistry.ts"],"names":[],"mappings":";;;AACA,qDAA+C;AAE/C,MAAa,qBAAqB;IAGhC,MAAM,CAAC,QAAQ,CAAC,QAA+B;QAC7C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,UAAU;QACf,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YAChC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAChF,OAAO,CAAC,GAAG,CAAC,8BAA8B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,kEAAkE;QAClE,8BAAa,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;;AAvBH,sDAwBC;AAvBgB,+BAAS,GAAuC,IAAI,GAAG,EAAE,CAAC"}

package/dist/decorators/cronDecorator.d.ts

@@ -0,0 +1,6 @@
+import 'reflect-metadata';
+import { CronConfig } from './types/cronTypes';
+export declare function Cron(config: CronConfig): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export { CronSchedule } from './types/cronTypes';
+export { CronRegistry } from './cronRegistry';
+//# sourceMappingURL=cronDecorator.d.ts.map

package/dist/decorators/cronDecorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronDecorator.d.ts","sourceRoot":"","sources":["../../src/decorators/cronDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAG7C,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,IACpB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,wBAiBlF;AAED,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC"}

package/dist/decorators/cronDecorator.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CronRegistry = exports.CronSchedule = void 0;
+exports.Cron = Cron;
+require("reflect-metadata");
+const cronRegistry_1 = require("./cronRegistry");
+function Cron(config) {
+    return function (target, propertyKey, descriptor) {
+        const handler = descriptor.value;
+        if (typeof handler !== 'function') {
+            throw new Error(`@Cron decorator can only be applied to methods.`);
+        }
+        cronRegistry_1.CronRegistry.register({
+            name: propertyKey,
+            schedule: config.schedule,
+            handler: handler,
+            description: config.description,
+            enabled: config.enabled ?? true,
+            timezone: config.timezone ?? 'UTC',
+        });
+        return descriptor;
+    };
+}
+var cronTypes_1 = require("./types/cronTypes");
+Object.defineProperty(exports, "CronSchedule", { enumerable: true, get: function () { return cronTypes_1.CronSchedule; } });
+var cronRegistry_2 = require("./cronRegistry");
+Object.defineProperty(exports, "CronRegistry", { enumerable: true, get: function () { return cronRegistry_2.CronRegistry; } });
+//# sourceMappingURL=cronDecorator.js.map

package/dist/decorators/cronDecorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronDecorator.js","sourceRoot":"","sources":["../../src/decorators/cronDecorator.ts"],"names":[],"mappings":";;;AAIA,oBAkBC;AAtBD,4BAA0B;AAE1B,iDAA4C;AAE5C,SAAgB,IAAI,CAAC,MAAkB;IACrC,OAAO,UAAU,MAAW,EAAE,WAAmB,EAAE,UAA8B;QAC/E,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC;QACjC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,2BAAY,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;YAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,KAAK;SACnC,CAAC,CAAC;QAEH,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED,+CAA+C;AAAvC,yGAAA,YAAY,OAAA;AACpB,+CAA4C;AAApC,4GAAA,YAAY,OAAA"}

package/dist/decorators/cronRegistry.d.ts

@@ -0,0 +1,13 @@
+import { CronJobMetadata } from './types/cronTypes';
+export declare class CronRegistry {
+    private static jobs;
+    static register(metadata: CronJobMetadata): void;
+    static getJobs(): CronJobMetadata[];
+    static getJob(name: string): CronJobMetadata | undefined;
+    static initialize(): void;
+    static stopJob(name: string): boolean;
+    static startJob(name: string): boolean;
+    static stopAll(): void;
+    static runNow(name: string): Promise<void>;
+}
+//# sourceMappingURL=cronRegistry.d.ts.map

package/dist/decorators/cronRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronRegistry.d.ts","sourceRoot":"","sources":["../../src/decorators/cronRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAUlD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAyC;IAE5D,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAOhD,MAAM,CAAC,OAAO,IAAI,eAAe,EAAE;IAInC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIxD,MAAM,CAAC,UAAU,IAAI,IAAI;IA2CzB,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAMrC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAMtC,MAAM,CAAC,OAAO,IAAI,IAAI;WAKT,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMjD"}