@ooneex/cron 0.0.1 → 0.0.4

package/README.md

@@ -1 +1,550 @@
 # @ooneex/cron
+
+A scheduled task runner and cron job management library for TypeScript applications with timezone support. This package provides an abstract base class for creating scheduled jobs with a human-readable time syntax and seamless integration with the Ooneex framework.
+
+![Bun](https://img.shields.io/badge/Bun-Compatible-orange?style=flat-square&logo=bun)
+![Deno](https://img.shields.io/badge/Deno-Compatible-blue?style=flat-square&logo=deno)
+![Node.js](https://img.shields.io/badge/Node.js-Compatible-green?style=flat-square&logo=node.js)
+![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square&logo=typescript)
+![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)
+
+## Features
+
+✅ **Human-Readable Syntax** - Define schedules with intuitive syntax like "every 1 hours"
+
+✅ **Timezone Support** - Run jobs in specific timezones using IANA timezone names
+
+✅ **Start/Stop Control** - Programmatically start and stop scheduled jobs
+
+✅ **Active Status** - Check if a job is currently running
+
+✅ **Container Integration** - Works seamlessly with dependency injection
+
+✅ **Type-Safe** - Full TypeScript support with proper type definitions
+
+✅ **Error Handling** - Comprehensive error handling with custom exceptions
+
+## Installation
+
+### Bun
+```bash
+bun add @ooneex/cron
+```
+
+### pnpm
+```bash
+pnpm add @ooneex/cron
+```
+
+### Yarn
+```bash
+yarn add @ooneex/cron
+```
+
+### npm
+```bash
+npm install @ooneex/cron
+```
+
+## Usage
+
+### Basic Cron Job
+
+```typescript
+import { Cron, type CronTimeType } from '@ooneex/cron';
+import type { TimeZoneType } from '@ooneex/country';
+
+class CleanupCron extends Cron {
+  public getTime(): CronTimeType {
+    return 'every 1 hours';
+  }
+
+  public getTimeZone(): TimeZoneType | null {
+    return null; // Use server's local timezone
+  }
+
+  public async job(): Promise<void> {
+    console.log('Running cleanup task...');
+    // Cleanup logic here
+  }
+}
+
+// Start the cron job
+const cleanup = new CleanupCron();
+await cleanup.start();
+```
+
+### With Timezone Support
+
+```typescript
+import { Cron, type CronTimeType } from '@ooneex/cron';
+import type { TimeZoneType } from '@ooneex/country';
+
+class DailyReportCron extends Cron {
+  public getTime(): CronTimeType {
+    return 'every 24 hours';
+  }
+
+  public getTimeZone(): TimeZoneType | null {
+    return 'Europe/Paris'; // Run at Paris time
+  }
+
+  public async job(): Promise<void> {
+    await this.generateDailyReport();
+    await this.sendReportEmail();
+  }
+
+  private async generateDailyReport(): Promise<void> {
+    // Report generation logic
+  }
+
+  private async sendReportEmail(): Promise<void> {
+    // Email sending logic
+  }
+}
+```
+
+### Different Time Intervals
+
+```typescript
+import { Cron, type CronTimeType } from '@ooneex/cron';
+
+// Every 30 seconds
+class FrequentCheckCron extends Cron {
+  public getTime(): CronTimeType {
+    return 'every 30 seconds';
+  }
+
+  public getTimeZone(): null {
+    return null;
+  }
+
+  public async job(): Promise<void> {
+    console.log('Checking...');
+  }
+}
+
+// Every 5 minutes
+class CacheRefreshCron extends Cron {
+  public getTime(): CronTimeType {
+    return 'every 5 minutes';
+  }
+
+  public getTimeZone(): null {
+    return null;
+  }
+
+  public async job(): Promise<void> {
+    await this.refreshCache();
+  }
+}
+
+// Every 7 days (weekly)
+class WeeklyBackupCron extends Cron {
+  public getTime(): CronTimeType {
+    return 'every 7 days';
+  }
+
+  public getTimeZone(): TimeZoneType | null {
+    return 'America/New_York';
+  }
+
+  public async job(): Promise<void> {
+    await this.performBackup();
+  }
+}
+```
+
+### Controlling Cron Jobs
+
+```typescript
+import { Cron } from '@ooneex/cron';
+
+const job = new MyCronJob();
+
+// Start the job
+await job.start();
+console.log('Job is active:', job.isActive()); // true
+
+// Stop the job
+await job.stop();
+console.log('Job is active:', job.isActive()); // false
+
+// Restart the job
+await job.start();
+```
+
+## API Reference
+
+### Classes
+
+#### `Cron` (Abstract)
+
+Abstract base class for creating scheduled jobs.
+
+**Abstract Methods to Implement:**
+
+##### `getTime(): CronTimeType`
+
+Returns the schedule timing for the job.
+
+**Returns:** A string in the format `"every N units"` or `"in N units"`
+
+**Example:**
+```typescript
+public getTime(): CronTimeType {
+  return 'every 1 hours';
+}
+```
+
+##### `getTimeZone(): TimeZoneType | null`
+
+Returns the timezone for the job schedule.
+
+**Returns:** IANA timezone string or `null` for server's local timezone
+
+**Example:**
+```typescript
+public getTimeZone(): TimeZoneType | null {
+  return 'Europe/London';
+}
+```
+
+##### `job(): Promise<void>`
+
+The task to execute on schedule.
+
+**Example:**
+```typescript
+public async job(): Promise<void> {
+  await this.performTask();
+}
+```
+
+**Inherited Methods:**
+
+##### `start(): Promise<void>`
+
+Starts the cron job. If already active, does nothing.
+
+**Throws:** `CronException` if the job fails to start
+
+**Example:**
+```typescript
+const job = new MyCronJob();
+await job.start();
+```
+
+##### `stop(): Promise<void>`
+
+Stops the cron job.
+
+**Example:**
+```typescript
+await job.stop();
+```
+
+##### `isActive(): boolean`
+
+Checks if the cron job is currently running.
+
+**Returns:** `true` if the job is active, `false` otherwise
+
+**Example:**
+```typescript
+if (job.isActive()) {
+  console.log('Job is running');
+}
+```
+
+### Types
+
+#### `CronTimeType`
+
+String format for defining job schedules.
+
+```typescript
+type CronTimeType = `${PrefixType} ${number} ${SuffixType}`;
+```
+
+**Examples:**
+- `'every 1 seconds'`
+- `'every 30 seconds'`
+- `'every 5 minutes'`
+- `'every 1 hours'`
+- `'every 24 hours'`
+- `'every 7 days'`
+- `'every 1 months'`
+- `'every 1 years'`
+- `'in 10 seconds'`
+- `'in 5 minutes'`
+
+#### `PrefixType`
+
+```typescript
+type PrefixType = 'in' | 'every';
+```
+
+#### `SuffixType`
+
+```typescript
+type SuffixType = 'seconds' | 'minutes' | 'hours' | 'days' | 'months' | 'years';
+```
+
+#### `CronClassType`
+
+```typescript
+type CronClassType = new (...args: any[]) => ICron;
+```
+
+### Enums
+
+#### `ECronPrefix`
+
+| Value | Description |
+|-------|-------------|
+| `IN` | Run once after specified time |
+| `EVERY` | Run repeatedly at specified interval |
+
+#### `ECronSuffix`
+
+| Value | Description |
+|-------|-------------|
+| `SECONDS` | Time in seconds |
+| `MINUTES` | Time in minutes |
+| `HOURS` | Time in hours |
+| `DAYS` | Time in days |
+| `MONTHS` | Time in months |
+| `YEARS` | Time in years |
+
+### Interfaces
+
+#### `ICron`
+
+```typescript
+interface ICron {
+  getTime: () => Promise<CronTimeType> | CronTimeType;
+  start: () => Promise<void> | void;
+  stop: () => Promise<void> | void;
+  job: () => Promise<void> | void;
+  getTimeZone: () => TimeZoneType | null;
+  isActive: () => Promise<boolean> | boolean;
+}
+```
+
+## Advanced Usage
+
+### Integration with Ooneex App
+
+```typescript
+import { App } from '@ooneex/app';
+import { CleanupCron, BackupCron, ReportCron } from './cron';
+
+const app = new App({
+  cronJobs: [CleanupCron, BackupCron, ReportCron],
+  // ... other config
+});
+
+await app.run();
+// All cron jobs are automatically started
+```
+
+### Using Container Decorators
+
+```typescript
+import { Cron, decorator, type CronTimeType } from '@ooneex/cron';
+import { container } from '@ooneex/container';
+
+@decorator.cron()
+class EmailQueueCron extends Cron {
+  public getTime(): CronTimeType {
+    return 'every 1 minutes';
+  }
+
+  public getTimeZone(): null {
+    return null;
+  }
+
+  public async job(): Promise<void> {
+    await this.processEmailQueue();
+  }
+}
+
+// Job is automatically registered with container
+const job = container.get(EmailQueueCron);
+await job.start();
+```
+
+### Error Handling
+
+```typescript
+import { Cron, CronException, type CronTimeType } from '@ooneex/cron';
+
+class RiskyJob extends Cron {
+  public getTime(): CronTimeType {
+    return 'every 5 minutes';
+  }
+
+  public getTimeZone(): null {
+    return null;
+  }
+
+  public async job(): Promise<void> {
+    try {
+      await this.riskyOperation();
+    } catch (error) {
+      console.error('Job failed:', error);
+      // Handle error without crashing the scheduler
+    }
+  }
+}
+
+// Handle startup errors
+try {
+  const job = new RiskyJob();
+  await job.start();
+} catch (error) {
+  if (error instanceof CronException) {
+    console.error('Failed to start cron job:', error.message);
+  }
+}
+```
+
+### Conditional Job Execution
+
+```typescript
+import { Cron, type CronTimeType } from '@ooneex/cron';
+
+class ConditionalCron extends Cron {
+  private enabled = true;
+
+  public getTime(): CronTimeType {
+    return 'every 1 hours';
+  }
+
+  public getTimeZone(): null {
+    return null;
+  }
+
+  public async job(): Promise<void> {
+    if (!this.enabled) {
+      console.log('Job skipped - disabled');
+      return;
+    }
+
+    await this.performTask();
+  }
+
+  public enable(): void {
+    this.enabled = true;
+  }
+
+  public disable(): void {
+    this.enabled = false;
+  }
+}
+```
+
+### Job with Logging
+
+```typescript
+import { Cron, type CronTimeType } from '@ooneex/cron';
+import { container } from '@ooneex/container';
+import type { ILogger } from '@ooneex/logger';
+
+class LoggingCron extends Cron {
+  private readonly logger = container.get<ILogger>('logger');
+
+  public getTime(): CronTimeType {
+    return 'every 30 minutes';
+  }
+
+  public getTimeZone(): TimeZoneType | null {
+    return 'UTC';
+  }
+
+  public async job(): Promise<void> {
+    this.logger.info('Cron job started', { job: 'LoggingCron' });
+
+    try {
+      await this.performTask();
+      this.logger.success('Cron job completed', { job: 'LoggingCron' });
+    } catch (error) {
+      this.logger.error('Cron job failed', {
+        job: 'LoggingCron',
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+}
+```
+
+### Multiple Jobs with Shared Resources
+
+```typescript
+import { Cron, type CronTimeType } from '@ooneex/cron';
+import { container } from '@ooneex/container';
+import type { ICache } from '@ooneex/cache';
+import type { IDatabase } from '@ooneex/database';
+
+abstract class BaseCron extends Cron {
+  protected readonly cache = container.get<ICache>('cache');
+  protected readonly database = container.get<IDatabase>('database');
+}
+
+class CacheWarmupCron extends BaseCron {
+  public getTime(): CronTimeType {
+    return 'every 15 minutes';
+  }
+
+  public getTimeZone(): null {
+    return null;
+  }
+
+  public async job(): Promise<void> {
+    const data = await this.database.query('SELECT * FROM hot_data');
+    await this.cache.set('hot_data', data, 900); // 15 min TTL
+  }
+}
+
+class DataCleanupCron extends BaseCron {
+  public getTime(): CronTimeType {
+    return 'every 1 days';
+  }
+
+  public getTimeZone(): TimeZoneType | null {
+    return 'UTC';
+  }
+
+  public async job(): Promise<void> {
+    await this.database.query('DELETE FROM logs WHERE created_at < NOW() - INTERVAL 30 DAY');
+    await this.cache.delete('old_cache_key');
+  }
+}
+```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
+
+### Development Setup
+
+1. Clone the repository
+2. Install dependencies: `bun install`
+3. Run tests: `bun run test`
+4. Build the project: `bun run build`
+
+### Guidelines
+
+- Write tests for new features
+- Follow the existing code style
+- Update documentation for API changes
+- Ensure all tests pass before submitting PR
+
+---
+
+Made with ❤️ by the Ooneex team

package/dist/index.d.ts

@@ -1,7 +1,5 @@
-import { Exception } from "@ooneex/exception";
-declare class CronException extends Exception {
-	constructor(message: string, data?: Record<string, unknown>);
-}
+import { TimeZoneType as TimeZoneType2 } from "@ooneex/country";
+import { TimeZoneType } from "@ooneex/country";
 declare enum ECronPrefix {
 	IN = "in",
 	EVERY = "every"
@@ -19,12 +17,28 @@ type SuffixType = `${ECronSuffix}`;
 type CronTimeType = `${PrefixType} ${number} ${SuffixType}`;
 type CronClassType = new (...args: any[]) => ICron;
 interface ICron {
-	getTime: () => CronTimeType;
-	setTime?: (tim: CronTimeType) => ICron;
-	start: () => Promise<void>;
-	stop: () => Promise<void>;
-	job: () => Promise<void>;
-	getTimeZone: () => Promise<string | null>;
-	isActive: () => boolean;
+	getTime: () => Promise<CronTimeType> | CronTimeType;
+	start: () => Promise<void> | void;
+	stop: () => Promise<void> | void;
+	job: () => Promise<void> | void;
+	getTimeZone: () => TimeZoneType | null;
+	isActive: () => Promise<boolean> | boolean;
+}
+declare abstract class Cron implements ICron {
+	private cronJob;
+	abstract getTime(): CronTimeType;
+	abstract job(): Promise<void>;
+	abstract getTimeZone(): TimeZoneType2 | null;
+	start(): Promise<void>;
+	stop(): Promise<void>;
+	isActive(): boolean;
+}
+import { Exception } from "@ooneex/exception";
+declare class CronException extends Exception {
+	constructor(message: string, data?: Record<string, unknown>);
 }
-export { SuffixType, PrefixType, ICron, ECronSuffix, ECronPrefix, CronTimeType, CronException, CronClassType };
+import { EContainerScope } from "@ooneex/container";
+declare const decorator: {
+	cron: (scope?: EContainerScope) => (target: CronClassType) => void;
+};
+export { decorator, SuffixType, PrefixType, ICron, ECronSuffix, ECronPrefix, CronTimeType, CronException, CronClassType, Cron };

package/dist/index.js

@@ -1,4 +1,4 @@
 // @bun
-import{Exception as s}from"@ooneex/exception";import{HttpStatus as c}from"@ooneex/http-status";class p extends s{constructor(r,o={}){super(r,{status:c.Code.InternalServerError,data:o});this.name="CronException"}}var a;((e)=>{e.IN="in";e.EVERY="every"})(a||={});var m;((t)=>{t.SECONDS="seconds";t.MINUTES="minutes";t.HOURS="hours";t.DAYS="days";t.MONTHS="months";t.YEARS="years"})(m||={});export{m as ECronSuffix,a as ECronPrefix,p as CronException};
+import{CronJob as g}from"cron";import{Exception as T}from"@ooneex/exception";import{HttpStatus as e}from"@ooneex/http-status";class n extends T{constructor(r,i={}){super(r,{status:e.Code.InternalServerError,data:i});this.name="CronException"}}var s=(r)=>{let i=r.split(" ");if(i.length!==3)throw new n(`Invalid CronTimeType format: ${r}`);let m=i[0],t=Number.parseInt(i[1]||"1",10),p=i[2];if(Number.isNaN(t)||t<=0)throw new n(`Invalid number value in CronTimeType: ${i[1]}`);if(m==="in"){let c=new Date;switch(p){case"seconds":{let o=new Date(c.getTime()+t*1000);return`${o.getMinutes()} ${o.getHours()} ${o.getDate()} ${o.getMonth()+1} *`}case"minutes":{let o=new Date(c.getTime()+t*60*1000);return`${o.getMinutes()} ${o.getHours()} ${o.getDate()} ${o.getMonth()+1} *`}case"hours":{let o=new Date(c.getTime()+t*60*60*1000);return`${o.getMinutes()} ${o.getHours()} ${o.getDate()} ${o.getMonth()+1} *`}case"days":{let o=new Date(c.getTime()+t*24*60*60*1000);return`${o.getMinutes()} ${o.getHours()} ${o.getDate()} ${o.getMonth()+1} *`}case"months":{let o=new Date(c);return o.setMonth(o.getMonth()+t),`${o.getMinutes()} ${o.getHours()} ${o.getDate()} ${o.getMonth()+1} *`}case"years":{let o=new Date(c);return o.setFullYear(o.getFullYear()+t),`${o.getMinutes()} ${o.getHours()} ${o.getDate()} ${o.getMonth()+1} *`}}}if(m==="every")switch(p){case"seconds":if(t===1)return"* * * * * *";return`*/${t} * * * * *`;case"minutes":if(t===1)return"* * * * *";return`*/${t} * * * *`;case"hours":if(t===1)return"0 * * * *";return`0 */${t} * * *`;case"days":if(t===1)return"0 0 * * *";return`0 0 */${t} * *`;case"months":if(t===1)return"0 0 1 * *";return`0 0 1 */${t} *`;case"years":if(t===1)return"0 0 1 1 *";return"0 0 1 1 *"}throw new n(`Invalid CronTimeType format: ${r}`)};class b{cronJob=null;async start(){if(this.isActive())return;if(this.cronJob){this.cronJob.start();return}let r=s(this.getTime());try{let i={cronTime:r,onTick:async()=>{await this.job()},start:!0},m=this.getTimeZone();if(m!==null)i.timeZone=m;this.cronJob=g.from(i)}catch(i){throw new n("Failed to start cron job",{time:this.getTime(),cronExpression:r,error:i instanceof Error?i.message:String(i)})}}async stop(){if(this.cronJob)this.cronJob.stop()}isActive(){if(!this.cronJob)return!1;return this.cronJob.isActive}}import{container as y,EContainerScope as J}from"@ooneex/container";var R={cron:(r=J.Singleton)=>{return(i)=>{y.add(i,r)}}};var h;((m)=>{m.IN="in";m.EVERY="every"})(h||={});var a;((o)=>{o.SECONDS="seconds";o.MINUTES="minutes";o.HOURS="hours";o.DAYS="days";o.MONTHS="months";o.YEARS="years"})(a||={});export{R as decorator,a as ECronSuffix,h as ECronPrefix,n as CronException,b as Cron};
 
-//# debugId=7E2B5893252706C264756E2164756E21
+//# debugId=0AE63CF58662598364756E2164756E21

package/dist/index.js.map

@@ -1,11 +1,14 @@
 {
   "version": 3,
-  "sources": ["src/CronException.ts", "src/types.ts"],
+  "sources": ["src/Cron.ts", "src/CronException.ts", "src/helper.ts", "src/decorators.ts", "src/types.ts"],
   "sourcesContent": [
+    "import type { TimeZoneType } from \"@ooneex/country\";\nimport { CronJob } from \"cron\";\nimport { CronException } from \"./CronException\";\nimport { convertToCrontab } from \"./helper\";\nimport type { CronTimeType, ICron } from \"./types\";\n\nexport abstract class Cron implements ICron {\n  private cronJob: CronJob | null = null;\n\n  public abstract getTime(): CronTimeType;\n  public abstract job(): Promise<void>;\n  public abstract getTimeZone(): TimeZoneType | null;\n\n  public async start(): Promise<void> {\n    if (this.isActive()) {\n      return;\n    }\n\n    if (this.cronJob) {\n      this.cronJob.start();\n      return;\n    }\n\n    const cronExpression = convertToCrontab(this.getTime());\n\n    try {\n      const cronParams: {\n        cronTime: string;\n        onTick: () => Promise<void>;\n        start: boolean;\n        timeZone?: string;\n      } = {\n        cronTime: cronExpression,\n        onTick: async () => {\n          await this.job();\n        },\n        start: true,\n      };\n\n      const timeZone = this.getTimeZone();\n      if (timeZone !== null) {\n        cronParams.timeZone = timeZone;\n      }\n\n      this.cronJob = CronJob.from(cronParams);\n    } catch (error) {\n      throw new CronException(\"Failed to start cron job\", {\n        time: this.getTime(),\n        cronExpression,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  public async stop(): Promise<void> {\n    if (this.cronJob) {\n      this.cronJob.stop();\n    }\n  }\n\n  public isActive(): boolean {\n    if (!this.cronJob) {\n      return false;\n    }\n\n    return this.cronJob.isActive;\n  }\n}\n",
     "import { Exception } from \"@ooneex/exception\";\nimport { HttpStatus } from \"@ooneex/http-status\";\n\nexport class CronException extends Exception {\n  constructor(message: string, data: Record<string, unknown> = {}) {\n    super(message, {\n      status: HttpStatus.Code.InternalServerError,\n      data,\n    });\n    this.name = \"CronException\";\n  }\n}\n",
-    "export enum ECronPrefix {\n  IN = \"in\",\n  EVERY = \"every\",\n}\n\nexport enum ECronSuffix {\n  SECONDS = \"seconds\",\n  MINUTES = \"minutes\",\n  HOURS = \"hours\",\n  DAYS = \"days\",\n  MONTHS = \"months\",\n  YEARS = \"years\",\n}\n\nexport type PrefixType = `${ECronPrefix}`;\nexport type SuffixType = `${ECronSuffix}`;\nexport type CronTimeType = `${PrefixType} ${number} ${SuffixType}`;\n\n// biome-ignore lint/suspicious/noExplicitAny: trust me\nexport type CronClassType = new (...args: any[]) => ICron;\n\nexport interface ICron {\n  getTime: () => CronTimeType;\n  setTime?: (tim: CronTimeType) => ICron;\n  start: () => Promise<void>;\n  stop: () => Promise<void>;\n  job: () => Promise<void>;\n  getTimeZone: () => Promise<string | null>;\n  isActive: () => boolean;\n}\n"
+    "import { CronException } from \"./CronException\";\nimport type { CronTimeType, SuffixType } from \"./types\";\n\n/**\n * Converts a CronTimeType string to a standard crontab expression\n * @param cronTime - The CronTimeType string (e.g., \"every 5 minutes\", \"in 30 seconds\")\n * @returns A crontab expression string\n */\nexport const convertToCrontab = (cronTime: CronTimeType): string => {\n  const parts = cronTime.split(\" \");\n\n  if (parts.length !== 3) {\n    throw new CronException(`Invalid CronTimeType format: ${cronTime}`);\n  }\n\n  const prefix = parts[0] as \"in\" | \"every\";\n  const value = Number.parseInt(parts[1] || \"1\", 10);\n  const suffix = parts[2] as SuffixType;\n\n  if (Number.isNaN(value) || value <= 0) {\n    throw new CronException(`Invalid number value in CronTimeType: ${parts[1]}`);\n  }\n\n  // Handle \"in\" prefix (one-time execution)\n  if (prefix === \"in\") {\n    const now = new Date();\n\n    switch (suffix) {\n      case \"seconds\": {\n        const futureSeconds = new Date(now.getTime() + value * 1000);\n        return `${futureSeconds.getMinutes()} ${futureSeconds.getHours()} ${futureSeconds.getDate()} ${futureSeconds.getMonth() + 1} *`;\n      }\n\n      case \"minutes\": {\n        const futureMinutes = new Date(now.getTime() + value * 60 * 1000);\n        return `${futureMinutes.getMinutes()} ${futureMinutes.getHours()} ${futureMinutes.getDate()} ${futureMinutes.getMonth() + 1} *`;\n      }\n\n      case \"hours\": {\n        const futureHours = new Date(now.getTime() + value * 60 * 60 * 1000);\n        return `${futureHours.getMinutes()} ${futureHours.getHours()} ${futureHours.getDate()} ${futureHours.getMonth() + 1} *`;\n      }\n\n      case \"days\": {\n        const futureDays = new Date(now.getTime() + value * 24 * 60 * 60 * 1000);\n        return `${futureDays.getMinutes()} ${futureDays.getHours()} ${futureDays.getDate()} ${futureDays.getMonth() + 1} *`;\n      }\n\n      case \"months\": {\n        const futureMonths = new Date(now);\n        futureMonths.setMonth(futureMonths.getMonth() + value);\n        return `${futureMonths.getMinutes()} ${futureMonths.getHours()} ${futureMonths.getDate()} ${futureMonths.getMonth() + 1} *`;\n      }\n\n      case \"years\": {\n        const futureYears = new Date(now);\n        futureYears.setFullYear(futureYears.getFullYear() + value);\n        return `${futureYears.getMinutes()} ${futureYears.getHours()} ${futureYears.getDate()} ${futureYears.getMonth() + 1} *`;\n      }\n    }\n  }\n\n  // Handle \"every\" prefix (recurring execution)\n  if (prefix === \"every\") {\n    switch (suffix) {\n      case \"seconds\":\n        if (value === 1) return \"* * * * * *\";\n        return `*/${value} * * * * *`;\n\n      case \"minutes\":\n        if (value === 1) return \"* * * * *\";\n        return `*/${value} * * * *`;\n\n      case \"hours\":\n        if (value === 1) return \"0 * * * *\";\n        return `0 */${value} * * *`;\n\n      case \"days\":\n        if (value === 1) return \"0 0 * * *\";\n        return `0 0 */${value} * *`;\n\n      case \"months\":\n        if (value === 1) return \"0 0 1 * *\";\n        return `0 0 1 */${value} *`;\n\n      case \"years\":\n        if (value === 1) return \"0 0 1 1 *\";\n        return \"0 0 1 1 *\";\n    }\n  }\n\n  throw new CronException(`Invalid CronTimeType format: ${cronTime}`);\n};\n",
+    "import { container, EContainerScope } from \"@ooneex/container\";\nimport type { CronClassType } from \"./types\";\n\nexport const decorator = {\n  cron: (scope: EContainerScope = EContainerScope.Singleton) => {\n    return (target: CronClassType): void => {\n      container.add(target, scope);\n    };\n  },\n};\n",
+    "import type { TimeZoneType } from \"@ooneex/country\";\n\nexport enum ECronPrefix {\n  IN = \"in\",\n  EVERY = \"every\",\n}\n\nexport enum ECronSuffix {\n  SECONDS = \"seconds\",\n  MINUTES = \"minutes\",\n  HOURS = \"hours\",\n  DAYS = \"days\",\n  MONTHS = \"months\",\n  YEARS = \"years\",\n}\n\nexport type PrefixType = `${ECronPrefix}`;\nexport type SuffixType = `${ECronSuffix}`;\nexport type CronTimeType = `${PrefixType} ${number} ${SuffixType}`;\n\n// biome-ignore lint/suspicious/noExplicitAny: trust me\nexport type CronClassType = new (...args: any[]) => ICron;\n\nexport interface ICron {\n  getTime: () => Promise<CronTimeType> | CronTimeType;\n  start: () => Promise<void> | void;\n  stop: () => Promise<void> | void;\n  job: () => Promise<void> | void;\n  getTimeZone: () => TimeZoneType | null;\n  isActive: () => Promise<boolean> | boolean;\n}\n"
   ],
-  "mappings": ";AAAA,oBAAS,0BACT,qBAAS,4BAEF,MAAM,UAAsB,CAAU,CAC3C,WAAW,CAAC,EAAiB,EAAgC,CAAC,EAAG,CAC/D,MAAM,EAAS,CACb,OAAQ,EAAW,KAAK,oBACxB,MACF,CAAC,EACD,KAAK,KAAO,gBAEhB,CCXO,IAAK,GAAL,CAAK,IAAL,CACL,KAAK,KACL,QAAQ,UAFE,QAKL,IAAK,GAAL,CAAK,IAAL,CACL,UAAU,UACV,UAAU,UACV,QAAQ,QACR,OAAO,OACP,SAAS,SACT,QAAQ,UANE",
-  "debugId": "7E2B5893252706C264756E2164756E21",
+  "mappings": "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",
+  "debugId": "0AE63CF58662598364756E2164756E21",
   "names": []
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ooneex/cron",
-  "description": "",
-  "version": "0.0.1",
+  "description": "Scheduled task runner and cron job management with timezone support for Ooneex applications",
+  "version": "0.0.4",
   "type": "module",
   "files": [
     "dist",
@@ -25,14 +25,25 @@
     "test": "bun test tests",
     "build": "bunup",
     "lint": "tsgo --noEmit && bunx biome lint",
-    "publish:prod": "bun publish --tolerate-republish --access public",
-    "publish:pack": "bun pm pack --destination ./dist",
-    "publish:dry": "bun publish --dry-run"
+    "publish": "bun publish --access public || true"
   },
   "dependencies": {
+    "@ooneex/container": "0.0.2",
     "@ooneex/exception": "0.0.1",
-    "@ooneex/http-status": "0.0.1"
+    "@ooneex/http-status": "0.0.1",
+    "cron": "^4.4.0"
   },
-  "devDependencies": {},
-  "peerDependencies": {}
+  "devDependencies": {
+    "@ooneex/country": "0.0.1"
+  },
+  "keywords": [
+    "bun",
+    "cron",
+    "job",
+    "ooneex",
+    "scheduler",
+    "scheduling",
+    "task",
+    "typescript"
+  ]
 }