@volontariapp/workers 0.1.0-snap-a134190 → 0.1.0-snap-8452a68

package/dist/core/base.worker.d.ts

@@ -0,0 +1,11 @@
+import { WorkerHost } from '@nestjs/bullmq';
+import { Logger } from '@volontariapp/logger';
+import type { Job } from 'bullmq';
+import type { JobMessagingType, JobRegistry } from '@volontariapp/messaging';
+export declare abstract class BaseWorker<K extends JobMessagingType> extends WorkerHost {
+    protected readonly logger: Logger;
+    protected readonly workerId: string;
+    process(job: Job<JobRegistry[K], void, K>, _token?: string): Promise<void>;
+    protected abstract processJob(job: Job<JobRegistry[K], void, K>): Promise<void>;
+}
+//# sourceMappingURL=base.worker.d.ts.map

package/dist/core/base.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.worker.d.ts","sourceRoot":"","sources":["../../src/core/base.worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE7E,8BAAsB,UAAU,CAAC,CAAC,SAAS,gBAAgB,CAAE,SAAQ,UAAU;IAC7E,SAAS,CAAC,QAAQ,CAAC,MAAM,SAAkD;IAC3E,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAc;IAE3C,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBhF,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAChF"}

package/dist/core/base.worker.js

@@ -0,0 +1,32 @@
+import { WorkerHost } from '@nestjs/bullmq';
+import { Logger } from '@volontariapp/logger';
+import { hostname } from 'node:os';
+export class BaseWorker extends WorkerHost {
+    logger = new Logger({ context: this.constructor.name });
+    workerId = hostname();
+    async process(job, _token) {
+        this.logger.info('Processing job', {
+            jobId: job.id,
+            type: job.name,
+            workerId: this.workerId,
+        });
+        try {
+            await this.processJob(job);
+            this.logger.info('Job completed', {
+                jobId: job.id,
+                type: job.name,
+                workerId: this.workerId,
+            });
+        }
+        catch (error) {
+            this.logger.error('Job failed', {
+                jobId: job.id,
+                type: job.name,
+                workerId: this.workerId,
+                error,
+            });
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=base.worker.js.map

package/dist/core/base.worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.worker.js","sourceRoot":"","sources":["../../src/core/base.worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAInC,MAAM,OAAgB,UAAuC,SAAQ,UAAU;IAC1D,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IACxD,QAAQ,GAAW,QAAQ,EAAE,CAAC;IAEjD,KAAK,CAAC,OAAO,CAAC,GAAiC,EAAE,MAAe;QAC9D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE;YACjC,KAAK,EAAE,GAAG,CAAC,EAAE;YACb,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;gBAChC,KAAK,EAAE,GAAG,CAAC,EAAE;gBACb,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE;gBAC9B,KAAK,EAAE,GAAG,CAAC,EAAE;gBACb,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK;aACN,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CAGF"}

package/dist/core/base.worker.unit.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.worker.unit.spec.d.ts.map

package/dist/core/base.worker.unit.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.worker.unit.spec.d.ts","sourceRoot":"","sources":["../../src/core/base.worker.unit.spec.ts"],"names":[],"mappings":""}

package/dist/core/base.worker.unit.spec.js

@@ -0,0 +1,110 @@
+import { describe, it, expect, beforeEach, jest } from '@jest/globals';
+const mockInfo = jest.fn();
+const mockError = jest.fn();
+jest.unstable_mockModule('@nestjs/bullmq', () => ({
+    WorkerHost: class WorkerHost {
+    },
+}));
+jest.unstable_mockModule('@volontariapp/logger', () => ({
+    Logger: jest.fn().mockImplementation(() => ({
+        info: mockInfo,
+        error: mockError,
+    })),
+}));
+const { BaseWorker } = await import('./base.worker.js');
+const { JobMessagingType } = await import('@volontariapp/messaging');
+class TestWorker extends BaseWorker {
+    processJob = jest.fn();
+}
+describe('BaseWorker', () => {
+    let worker;
+    let mockJob;
+    beforeEach(() => {
+        jest.clearAllMocks();
+        worker = new TestWorker();
+        mockJob = {
+            id: 'job-123',
+            name: JobMessagingType.SEND_WELCOME_EMAIL,
+        };
+    });
+    describe('process — success', () => {
+        it('should call processJob with the job', async () => {
+            worker.processJob.mockResolvedValue(undefined);
+            await worker.process(mockJob);
+            expect(worker.processJob).toHaveBeenCalledTimes(1);
+            expect(worker.processJob).toHaveBeenCalledWith(mockJob);
+        });
+        it('should log "Processing job" before execution', async () => {
+            worker.processJob.mockResolvedValue(undefined);
+            await worker.process(mockJob);
+            expect(mockInfo).toHaveBeenNthCalledWith(1, 'Processing job', {
+                jobId: 'job-123',
+                type: JobMessagingType.SEND_WELCOME_EMAIL,
+                workerId: expect.any(String),
+            });
+        });
+        it('should log "Job completed" after execution', async () => {
+            worker.processJob.mockResolvedValue(undefined);
+            await worker.process(mockJob);
+            expect(mockInfo).toHaveBeenCalledTimes(2);
+            expect(mockInfo).toHaveBeenNthCalledWith(2, 'Job completed', {
+                jobId: 'job-123',
+                type: JobMessagingType.SEND_WELCOME_EMAIL,
+                workerId: expect.any(String),
+            });
+        });
+        it('should not call logger.error on success', async () => {
+            worker.processJob.mockResolvedValue(undefined);
+            await worker.process(mockJob);
+            expect(mockError).not.toHaveBeenCalled();
+        });
+        it('should ignore the optional token parameter', async () => {
+            worker.processJob.mockResolvedValue(undefined);
+            await worker.process(mockJob, 'some-bullmq-token');
+            expect(worker.processJob).toHaveBeenCalledWith(mockJob);
+        });
+    });
+    describe('process — failure', () => {
+        it('should re-throw the error thrown by processJob', async () => {
+            const error = new Error('Processing failed');
+            worker.processJob.mockRejectedValue(error);
+            await expect(worker.process(mockJob)).rejects.toThrow(error);
+        });
+        it('should call logger.error with job metadata and the error', async () => {
+            const error = new Error('Processing failed');
+            worker.processJob.mockRejectedValue(error);
+            await expect(worker.process(mockJob)).rejects.toThrow();
+            expect(mockError).toHaveBeenCalledTimes(1);
+            expect(mockError).toHaveBeenCalledWith('Job failed', {
+                jobId: 'job-123',
+                type: JobMessagingType.SEND_WELCOME_EMAIL,
+                workerId: expect.any(String),
+                error,
+            });
+        });
+        it('should log "Processing job" but NOT "Job completed" on failure', async () => {
+            worker.processJob.mockRejectedValue(new Error('fail'));
+            await expect(worker.process(mockJob)).rejects.toThrow();
+            expect(mockInfo).toHaveBeenCalledTimes(1);
+            expect(mockInfo).toHaveBeenCalledWith('Processing job', expect.any(Object));
+        });
+        it('should propagate non-Error thrown values', async () => {
+            const thrown = 'string-error';
+            worker.processJob.mockRejectedValue(thrown);
+            await expect(worker.process(mockJob)).rejects.toBe(thrown);
+            expect(mockError).toHaveBeenCalledWith('Job failed', expect.objectContaining({ error: thrown }));
+        });
+    });
+    describe('typing', () => {
+        it('should pass Job typed with correct payload to processJob', async () => {
+            const typedJob = {
+                id: 'typed-job',
+                name: JobMessagingType.SEND_WELCOME_EMAIL,
+            };
+            worker.processJob.mockResolvedValue(undefined);
+            await worker.process(typedJob);
+            expect(worker.processJob).toHaveBeenCalledWith(typedJob);
+        });
+    });
+});
+//# sourceMappingURL=base.worker.unit.spec.js.map

package/dist/core/base.worker.unit.spec.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,5 @@
-export { BaseWorker } from './base.worker.js';
-export type { WorkerConfig, WorkerConnectionConfig } from './types/worker-config.types.js';
+export { BaseWorker } from './core/base.worker.js';
+export type { JobOf } from './types/index.js';
+export type { WorkerAppConfig, BullWorkerModuleConfig, BullConnectionConfig, BullDefaultJobOptions, } from './interfaces/index.js';
+export { createBullConfig } from './utils/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,YAAY,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
-export { BaseWorker } from './base.worker.js';
+export { BaseWorker } from './core/base.worker.js';
+export { createBullConfig } from './utils/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAQnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/interfaces/bull-config.interface.d.ts

@@ -0,0 +1,23 @@
+export interface BullConnectionConfig {
+    host: string;
+    port: number;
+    password: string;
+    db: number;
+    maxRetriesPerRequest: null;
+    enableReadyCheck: boolean;
+    enableOfflineQueue: boolean;
+}
+export interface BullDefaultJobOptions {
+    attempts: number;
+    backoff: {
+        type: string;
+        delay: number;
+    };
+    removeOnComplete: boolean;
+    removeOnFail: boolean;
+}
+export interface BullWorkerModuleConfig {
+    connection: BullConnectionConfig;
+    defaultJobOptions: BullDefaultJobOptions;
+}
+//# sourceMappingURL=bull-config.interface.d.ts.map

package/dist/interfaces/bull-config.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bull-config.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/bull-config.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB,EAAE,IAAI,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,oBAAoB,CAAC;IACjC,iBAAiB,EAAE,qBAAqB,CAAC;CAC1C"}

package/dist/interfaces/bull-config.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bull-config.interface.js.map

package/dist/interfaces/bull-config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bull-config.interface.js","sourceRoot":"","sources":["../../src/interfaces/bull-config.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/index.d.ts

@@ -0,0 +1,3 @@
+export type { WorkerAppConfig } from './worker-app-config.interface.js';
+export type { BullWorkerModuleConfig, BullConnectionConfig, BullDefaultJobOptions, } from './bull-config.interface.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,YAAY,EACV,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC"}

package/dist/interfaces/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":""}

package/dist/interfaces/worker-app-config.interface.d.ts

@@ -0,0 +1,6 @@
+import type { IRedisConfig } from '@volontariapp/config';
+export interface WorkerAppConfig {
+    redis: IRedisConfig;
+    concurrency?: number;
+}
+//# sourceMappingURL=worker-app-config.interface.d.ts.map

package/dist/interfaces/worker-app-config.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-app-config.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/worker-app-config.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/interfaces/worker-app-config.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker-app-config.interface.js.map

package/dist/interfaces/worker-app-config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-app-config.interface.js","sourceRoot":"","sources":["../../src/interfaces/worker-app-config.interface.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export type { JobOf } from './job.types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/types/job.types.d.ts

@@ -0,0 +1,4 @@
+import type { Job } from 'bullmq';
+import type { JobMessagingType, JobRegistry } from '@volontariapp/messaging';
+export type JobOf<K extends JobMessagingType> = Job<JobRegistry[K], void, K>;
+//# sourceMappingURL=job.types.d.ts.map

package/dist/types/job.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.types.d.ts","sourceRoot":"","sources":["../../src/types/job.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE7E,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,gBAAgB,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC"}

package/dist/types/job.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=job.types.js.map

package/dist/types/job.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.types.js","sourceRoot":"","sources":["../../src/types/job.types.ts"],"names":[],"mappings":""}

package/dist/utils/bull-config.utils.d.ts

@@ -0,0 +1,4 @@
+import type { IRedisConfig } from '@volontariapp/config';
+import type { BullWorkerModuleConfig } from '../interfaces/index.js';
+export declare function createBullConfig(redis: IRedisConfig): BullWorkerModuleConfig;
+//# sourceMappingURL=bull-config.utils.d.ts.map

package/dist/utils/bull-config.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bull-config.utils.d.ts","sourceRoot":"","sources":["../../src/utils/bull-config.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,sBAAsB,CAkB5E"}

package/dist/utils/bull-config.utils.js

@@ -0,0 +1,20 @@
+export function createBullConfig(redis) {
+    return {
+        connection: {
+            host: redis.host,
+            port: redis.port,
+            password: redis.password,
+            db: redis.db ?? 0,
+            maxRetriesPerRequest: null,
+            enableReadyCheck: false,
+            enableOfflineQueue: false,
+        },
+        defaultJobOptions: {
+            attempts: 3,
+            backoff: { type: 'exponential', delay: 1000 },
+            removeOnComplete: true,
+            removeOnFail: false,
+        },
+    };
+}
+//# sourceMappingURL=bull-config.utils.js.map

package/dist/utils/bull-config.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bull-config.utils.js","sourceRoot":"","sources":["../../src/utils/bull-config.utils.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,OAAO;QACL,UAAU,EAAE;YACV,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC;YACjB,oBAAoB,EAAE,IAAI;YAC1B,gBAAgB,EAAE,KAAK;YACvB,kBAAkB,EAAE,KAAK;SAC1B;QACD,iBAAiB,EAAE;YACjB,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE;YAC7C,gBAAgB,EAAE,IAAI;YACtB,YAAY,EAAE,KAAK;SACpB;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { createBullConfig } from './bull-config.utils.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export { createBullConfig } from './bull-config.utils.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volontariapp/workers",
-  "version": "0.1.0-snap-a134190",
+  "version": "0.1.0-snap-8452a68",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -9,7 +9,7 @@
     "type": "git",
     "url": "git+https://github.com/Volontariapp/npm-packages.git"
   },
-  "description": "",
+  "description": "Abstract BullMQ worker base for Volontariapp NestJS workers",
   "license": "UNLICENSED",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,14 +30,29 @@
     "prepublishOnly": "yarn build",
     "build": "tsc -p tsconfig.json",
     "lint": "eslint src/",
-    "test": "echo \"No tests yet\""
+    "test": "node --experimental-vm-modules $(yarn bin jest)",
+    "test:coverage": "node --experimental-vm-modules $(yarn bin jest) --coverage --coverageReporters=\"text\" --coverageReporters=\"json-summary\" --coverageReporters=\"lcov\"",
+    "test:watch": "node --experimental-vm-modules $(yarn bin jest) --watch"
   },
   "dependencies": {
+    "@volontariapp/config": "3.0.0",
     "@volontariapp/logger": "0.2.3",
-    "bullmq": "^5.76.5"
+    "@volontariapp/messaging": "1.1.0"
+  },
+  "peerDependencies": {
+    "@nestjs/bullmq": "^11.0.0",
+    "@nestjs/common": "^11.0.0",
+    "bullmq": "^5.0.0"
   },
   "devDependencies": {
+    "@jest/globals": "^30.3.0",
+    "@nestjs/bullmq": "^11.0.0",
+    "@nestjs/common": "^11.0.0",
+    "@types/jest": "^30.0.0",
     "@types/node": "^24.0.0",
+    "bullmq": "^5.76.5",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.6",
     "typescript": "5.7.3"
   }
 }

package/dist/base.worker.d.ts

@@ -1,14 +0,0 @@
-import { type Job } from 'bullmq';
-import { Logger } from '@volontariapp/logger';
-import type { WorkerConfig } from './types/worker-config.types.js';
-export declare abstract class BaseWorker<TData extends Record<string, unknown>> {
-    protected readonly config: WorkerConfig;
-    private readonly worker;
-    protected readonly logger: Logger;
-    protected readonly workerId: string;
-    constructor(config: WorkerConfig);
-    private registerEvents;
-    protected abstract processJob(job: Job<TData, void>): Promise<void>;
-    close(): Promise<void>;
-}
-//# sourceMappingURL=base.worker.d.ts.map

package/dist/base.worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"base.worker.d.ts","sourceRoot":"","sources":["../src/base.worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,8BAAsB,UAAU,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKxD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY;IAJnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEL,MAAM,EAAE,YAAY;IAgBnD,OAAO,CAAC,cAAc;IA2BtB,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/dist/base.worker.js

@@ -1,51 +0,0 @@
-import { Worker } from 'bullmq';
-import { Logger } from '@volontariapp/logger';
-import { hostname } from 'node:os';
-export class BaseWorker {
-    config;
-    worker;
-    logger;
-    workerId;
-    constructor(config) {
-        this.config = config;
-        this.workerId = hostname();
-        this.logger = new Logger({ context: this.constructor.name });
-        this.worker = new Worker(config.queueName, (job) => this.processJob(job), {
-            connection: config.connection,
-            concurrency: config.concurrency ?? 1,
-        });
-        this.registerEvents();
-    }
-    registerEvents() {
-        this.worker.on('completed', (job) => {
-            this.logger.info(`Job completed`, {
-                jobId: job.id,
-                jobName: job.name,
-                workerId: this.workerId,
-            });
-        });
-        this.worker.on('failed', (job, error) => {
-            this.logger.error(`Job failed`, {
-                jobId: job?.id,
-                jobName: job?.name,
-                workerId: this.workerId,
-                error,
-            });
-        });
-        this.worker.on('error', (error) => {
-            this.logger.error(`Worker error`, {
-                workerId: this.workerId,
-                queue: this.config.queueName,
-                error,
-            });
-        });
-    }
-    async close() {
-        this.logger.info(`Worker closing`, {
-            workerId: this.workerId,
-            queue: this.config.queueName,
-        });
-        await this.worker.close();
-    }
-}
-//# sourceMappingURL=base.worker.js.map

package/dist/base.worker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"base.worker.js","sourceRoot":"","sources":["../src/base.worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,MAAM,OAAgB,UAAU;IAKC;IAJd,MAAM,CAAsB;IAC1B,MAAM,CAAS;IACf,QAAQ,CAAS;IAEpC,YAA+B,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QAE7D,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CACtB,MAAM,CAAC,SAAS,EAChB,CAAC,GAAqB,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAC/C;YACE,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,CAAC;SACrC,CACF,CAAC;QAEF,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,GAAqB,EAAE,EAAE;YACpD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;gBAChC,KAAK,EAAE,GAAG,CAAC,EAAE;gBACb,OAAO,EAAE,GAAG,CAAC,IAAI;gBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAiC,EAAE,KAAY,EAAE,EAAE;YAC3E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE;gBAC9B,KAAK,EAAE,GAAG,EAAE,EAAE;gBACd,OAAO,EAAE,GAAG,EAAE,IAAI;gBAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK;aACN,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YACvC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE;gBAChC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;gBAC5B,KAAK;aACN,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAID,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE;YACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;SAC7B,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/types/worker-config.types.d.ts

@@ -1,14 +0,0 @@
-export interface WorkerConnectionConfig {
-    host: string;
-    port: number;
-    db?: number;
-    maxRetriesPerRequest?: number | null;
-    enableReadyCheck?: boolean;
-    enableOfflineQueue?: boolean;
-}
-export interface WorkerConfig {
-    queueName: string;
-    concurrency?: number;
-    connection: WorkerConnectionConfig;
-}
-//# sourceMappingURL=worker-config.types.d.ts.map

package/dist/types/worker-config.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker-config.types.d.ts","sourceRoot":"","sources":["../../src/types/worker-config.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,sBAAsB,CAAC;CACpC"}

package/dist/types/worker-config.types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=worker-config.types.js.map

package/dist/types/worker-config.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker-config.types.js","sourceRoot":"","sources":["../../src/types/worker-config.types.ts"],"names":[],"mappings":""}