@monque/tsed 0.1.0 → 1.1.0

package/src/utils/collect-job-metadata.ts

@@ -0,0 +1,95 @@
+/**
+ * Collect job metadata utility
+ *
+ * Collects all job metadata from a class decorated with @JobController.
+ * Used by MonqueModule to discover and register all jobs.
+ */
+import { Store } from '@tsed/core';
+
+import { MONQUE } from '@/constants';
+import type { CronDecoratorOptions, JobDecoratorOptions, JobStore } from '@/decorators';
+
+import { buildJobName } from './build-job-name.js';
+
+/**
+ * Collected job registration info ready for Monque.register()
+ */
+export interface CollectedJobMetadata {
+	/**
+	 * Full job name (with namespace prefix if applicable)
+	 */
+	fullName: string;
+
+	/**
+	 * Method name on the controller class
+	 */
+	method: string;
+
+	/**
+	 * Job options to pass to Monque.register()
+	 */
+	opts: JobDecoratorOptions | CronDecoratorOptions;
+
+	/**
+	 * Whether this is a cron job
+	 */
+	isCron: boolean;
+
+	/**
+	 * Cron pattern (only for cron jobs)
+	 */
+	cronPattern?: string;
+}
+
+/**
+ * Collect all job metadata from a class.
+ *
+ * @param target - The class constructor (decorated with @JobController)
+ * @returns Array of collected job metadata ready for registration
+ *
+ * @example
+ * ```typescript
+ * const metadata = collectJobMetadata(EmailJobs);
+ * // Returns:
+ * // [
+ * //   { fullName: "email.send", method: "sendEmail", opts: {}, isCron: false },
+ * //   { fullName: "email.daily-digest", method: "sendDailyDigest", opts: {}, isCron: true, cronPattern: "0 9 * * *" }
+ * // ]
+ * ```
+ */
+export function collectJobMetadata(
+	target: new (...args: unknown[]) => unknown,
+): CollectedJobMetadata[] {
+	const store = Store.from(target);
+	const jobStore = store.get<JobStore>(MONQUE);
+
+	if (!jobStore) {
+		return [];
+	}
+
+	const results: CollectedJobMetadata[] = [];
+	const namespace = jobStore.namespace;
+
+	// Collect regular jobs
+	for (const job of jobStore.jobs) {
+		results.push({
+			fullName: buildJobName(namespace, job.name),
+			method: job.method,
+			opts: job.opts,
+			isCron: false,
+		});
+	}
+
+	// Collect cron jobs
+	for (const cron of jobStore.cronJobs) {
+		results.push({
+			fullName: buildJobName(namespace, cron.name),
+			method: cron.method,
+			opts: cron.opts,
+			isCron: true,
+			cronPattern: cron.pattern,
+		});
+	}
+
+	return results;
+}

package/src/utils/get-job-token.ts

@@ -0,0 +1,29 @@
+/**
+ * Generate a unique token for a job controller.
+ *
+ * Used internally by Ts.ED DI to identify job controller providers.
+ * The token is based on the class name for debugging purposes.
+ *
+ * @param target - The class constructor
+ * @returns A Symbol token unique to this job controller
+ *
+ * @example
+ * ```typescript
+ * @JobController("email")
+ * class EmailJobs {}
+ *
+ * const token = getJobToken(EmailJobs);
+ * // Symbol("monque:job:EmailJobs")
+ * ```
+ */
+import { MonqueError } from '@monque/core';
+
+export function getJobToken(target: new (...args: unknown[]) => unknown): symbol {
+	const name = target.name?.trim();
+
+	if (!name) {
+		throw new MonqueError('Job class must have a non-empty name');
+	}
+
+	return Symbol.for(`monque:job:${name}`);
+}

package/src/utils/index.ts

@@ -1,9 +1,9 @@
 export { buildJobName } from './build-job-name.js';
 export {
-	type CollectedWorkerMetadata,
-	collectWorkerMetadata,
-} from './collect-worker-metadata.js';
-export { getWorkerToken } from './get-worker-token.js';
+	type CollectedJobMetadata,
+	collectJobMetadata,
+} from './collect-job-metadata.js';
+export { getJobToken } from './get-job-token.js';
 export {
 	isMongooseConnection,
 	isMongooseService,

package/src/utils/resolve-database.ts

@@ -4,6 +4,7 @@
  * Multi-strategy database resolution for flexible MongoDB connection handling.
  */
 
+import { ConnectionError } from '@monque/core';
 import type { TokenProvider } from '@tsed/di';
 import type { Db } from 'mongodb';
 
@@ -66,7 +67,7 @@ export async function resolveDatabase(
 	// Strategy 3: DI token resolution
 	if (config.dbToken) {
 		if (!injectorFn) {
-			throw new Error(
+			throw new ConnectionError(
 				'MonqueTsedConfig.dbToken requires an injector function to resolve the database',
 			);
 		}
@@ -74,7 +75,7 @@ export async function resolveDatabase(
 		const resolved = injectorFn(config.dbToken);
 
 		if (!resolved) {
-			throw new Error(
+			throw new ConnectionError(
 				`Could not resolve database from token: ${String(config.dbToken)}. ` +
 					'Make sure the provider is registered in the DI container.',
 			);
@@ -87,7 +88,7 @@ export async function resolveDatabase(
 			const connection = resolved.get(connectionId);
 
 			if (!connection) {
-				throw new Error(
+				throw new ConnectionError(
 					`MongooseService resolved from token "${String(config.dbToken)}" returned no connection for ID "${connectionId}". ` +
 						'Ensure the connection ID is correct and the connection is established.',
 				);
@@ -106,7 +107,7 @@ export async function resolveDatabase(
 
 		// Default: Assume it is a native Db instance
 		if (typeof resolved !== 'object' || resolved === null || !('collection' in resolved)) {
-			throw new Error(
+			throw new ConnectionError(
 				`Resolved value from token "${String(config.dbToken)}" does not appear to be a valid MongoDB Db instance.`,
 			);
 		}
@@ -115,5 +116,5 @@ export async function resolveDatabase(
 	}
 
 	// No strategy provided
-	throw new Error("MonqueTsedConfig requires 'db', 'dbFactory', or 'dbToken' to be set");
+	throw new ConnectionError("MonqueTsedConfig requires 'db', 'dbFactory', or 'dbToken' to be set");
 }

package/src/utils/collect-worker-metadata.ts

@@ -1,95 +0,0 @@
-/**
- * Collect worker metadata utility
- *
- * Collects all worker metadata from a class decorated with @WorkerController.
- * Used by MonqueModule to discover and register all workers.
- */
-import { Store } from '@tsed/core';
-
-import { MONQUE } from '@/constants';
-import type { CronDecoratorOptions, WorkerDecoratorOptions, WorkerStore } from '@/decorators';
-
-import { buildJobName } from './build-job-name.js';
-
-/**
- * Collected worker registration info ready for Monque.register()
- */
-export interface CollectedWorkerMetadata {
-	/**
-	 * Full job name (with namespace prefix if applicable)
-	 */
-	fullName: string;
-
-	/**
-	 * Method name on the controller class
-	 */
-	method: string;
-
-	/**
-	 * Worker options to pass to Monque.register()
-	 */
-	opts: WorkerDecoratorOptions | CronDecoratorOptions;
-
-	/**
-	 * Whether this is a cron job
-	 */
-	isCron: boolean;
-
-	/**
-	 * Cron pattern (only for cron jobs)
-	 */
-	cronPattern?: string;
-}
-
-/**
- * Collect all worker metadata from a class.
- *
- * @param target - The class constructor (decorated with @WorkerController)
- * @returns Array of collected worker metadata ready for registration
- *
- * @example
- * ```typescript
- * const metadata = collectWorkerMetadata(EmailWorkers);
- * // Returns:
- * // [
- * //   { fullName: "email.send", method: "sendEmail", opts: {}, isCron: false },
- * //   { fullName: "email.daily-digest", method: "sendDailyDigest", opts: {}, isCron: true, cronPattern: "0 9 * * *" }
- * // ]
- * ```
- */
-export function collectWorkerMetadata(
-	target: new (...args: unknown[]) => unknown,
-): CollectedWorkerMetadata[] {
-	const store = Store.from(target);
-	const workerStore = store.get<WorkerStore>(MONQUE);
-
-	if (!workerStore) {
-		return [];
-	}
-
-	const results: CollectedWorkerMetadata[] = [];
-	const namespace = workerStore.namespace;
-
-	// Collect regular workers
-	for (const worker of workerStore.workers) {
-		results.push({
-			fullName: buildJobName(namespace, worker.name),
-			method: worker.method,
-			opts: worker.opts,
-			isCron: false,
-		});
-	}
-
-	// Collect cron jobs
-	for (const cron of workerStore.cronJobs) {
-		results.push({
-			fullName: buildJobName(namespace, cron.name),
-			method: cron.method,
-			opts: cron.opts,
-			isCron: true,
-			cronPattern: cron.pattern,
-		});
-	}
-
-	return results;
-}

package/src/utils/get-worker-token.ts

@@ -1,27 +0,0 @@
-/**
- * Generate a unique token for a worker controller.
- *
- * Used internally by Ts.ED DI to identify worker controller providers.
- * The token is based on the class name for debugging purposes.
- *
- * @param target - The class constructor
- * @returns A Symbol token unique to this worker controller
- *
- * @example
- * ```typescript
- * @WorkerController("email")
- * class EmailWorkers {}
- *
- * const token = getWorkerToken(EmailWorkers);
- * // Symbol("monque:worker:EmailWorkers")
- * ```
- */
-export function getWorkerToken(target: new (...args: unknown[]) => unknown): symbol {
-	const name = target.name?.trim();
-
-	if (!name) {
-		throw new Error('Worker class must have a non-empty name');
-	}
-
-	return Symbol.for(`monque:worker:${name}`);
-}