@nest-boot/queue-api 0.0.0-stage → 8.1.0

package/dist/queue-api.module.js

@@ -0,0 +1,25 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { QueueModule } from "@nest-boot/queue";
+import { Global, Module } from "@nestjs/common";
+import { JobProcessor } from "./processors/job.processor.js";
+import { JobQueue } from "./queues/job.queue.js";
+import { JobResolver } from "./resolvers/job.resolver.js";
+import { JobService } from "./services/job.service.js";
+/** Authenticated Job APIs using the application's global database and auth configuration. */
+let QueueApiModule = class QueueApiModule {
+};
+QueueApiModule = __decorate([
+    Global(),
+    Module({
+        imports: [QueueModule],
+        providers: [JobQueue, JobProcessor, JobService, JobResolver],
+        exports: [JobService],
+    })
+], QueueApiModule);
+export { QueueApiModule };
+//# sourceMappingURL=queue-api.module.js.map

package/dist/queue-api.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-api.module.js","sourceRoot":"","sources":["../src/queue-api.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,6FAA6F;AAOtF,IAAM,cAAc,GAApB,MAAM,cAAc;CAAG,CAAA;AAAjB,cAAc;IAN1B,MAAM,EAAE;IACR,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,WAAW,CAAC;QACtB,SAAS,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,CAAC;QAC5D,OAAO,EAAE,CAAC,UAAU,CAAC;KACtB,CAAC;GACW,cAAc,CAAG"}

package/dist/queues/job.queue.d.ts

@@ -0,0 +1,32 @@
+import type { QueueOptions } from "@nest-boot/queue";
+import { BaseQueue } from "@nest-boot/queue";
+import type { JobProgress } from "bullmq";
+import { z } from "zod";
+import { JobStatus } from "../enums/job-status.enum.js";
+/** Built-in Redis queue for synchronizing and cleaning up Job records. */
+export declare class JobQueue extends BaseQueue {
+    readonly jobSchemas: {
+        cleanup: {
+            data: z.ZodObject<{}, z.core.$strip>;
+        };
+        sync: {
+            data: z.ZodObject<{
+                eventId: z.ZodString;
+                data: z.ZodObject<{
+                    queue: z.ZodString;
+                    jobId: z.ZodString;
+                    name: z.ZodOptional<z.ZodString>;
+                    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    status: z.ZodOptional<z.ZodEnum<typeof JobStatus>>;
+                    progress: z.ZodOptional<z.ZodNullable<z.ZodCustom<JobProgress, JobProgress>>>;
+                    returnValue: z.ZodOptional<z.ZodUnknown>;
+                    failedReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    createdAt: z.ZodOptional<z.ZodNumber>;
+                    startedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    finishedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>;
+        };
+    };
+    constructor(options?: QueueOptions);
+}

package/dist/queues/job.queue.js

@@ -0,0 +1,65 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Queue } from "@nest-boot/queue";
+import { BaseQueue } from "@nest-boot/queue";
+import { Optional } from "@nestjs/common";
+import { z } from "zod";
+import { JobStatus } from "../enums/job-status.enum.js";
+/** Built-in Redis queue for synchronizing and cleaning up Job records. */
+let JobQueue = class JobQueue extends BaseQueue {
+    jobSchemas = {
+        cleanup: { data: z.object({}) },
+        sync: {
+            data: z.object({
+                eventId: z.string().regex(/^\d+-\d+$/),
+                data: z.object({
+                    queue: z.string(),
+                    jobId: z.string(),
+                    name: z.string().optional(),
+                    data: z.record(z.string(), z.unknown()).optional(),
+                    status: z.enum(JobStatus).optional(),
+                    progress: z
+                        .custom((value) => typeof value === "number" ||
+                        typeof value === "string" ||
+                        typeof value === "boolean" ||
+                        (typeof value === "object" && value !== null))
+                        .nullish(),
+                    returnValue: z.unknown().optional(),
+                    failedReason: z.string().nullish(),
+                    createdAt: z.number().int().nonnegative().optional(),
+                    startedAt: z.number().int().nonnegative().nullish(),
+                    finishedAt: z.number().int().nonnegative().nullish(),
+                }),
+            }),
+        },
+    };
+    constructor(options = {}) {
+        super({
+            ...options,
+            defaultJobOptions: {
+                attempts: 20,
+                backoff: { type: "exponential", delay: 1000 },
+                removeOnComplete: true,
+                removeOnFail: 1000,
+                ...options.defaultJobOptions,
+            },
+        });
+    }
+};
+JobQueue = __decorate([
+    Queue(),
+    __param(0, Optional()),
+    __metadata("design:paramtypes", [Object])
+], JobQueue);
+export { JobQueue };
+//# sourceMappingURL=job.queue.js.map

package/dist/queues/job.queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.queue.js","sourceRoot":"","sources":["../../src/queues/job.queue.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,0EAA0E;AAEnE,IAAM,QAAQ,GAAd,MAAM,QAAS,SAAQ,SAAS;IAC5B,UAAU,GAAG;QACpB,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;QAC/B,IAAI,EAAE;YACJ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBACb,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC;gBACtC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;oBACb,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;oBACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;oBACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;oBAClD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;oBACpC,QAAQ,EAAE,CAAC;yBACR,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,KAAK,KAAK,QAAQ;wBACzB,OAAO,KAAK,KAAK,QAAQ;wBACzB,OAAO,KAAK,KAAK,SAAS;wBAC1B,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAChD;yBACA,OAAO,EAAE;oBACZ,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;oBACnC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;oBAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;oBACpD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE;oBACnD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE;iBACrD,CAAC;aACH,CAAC;SACH;KACF,CAAC;IAEF,YAAwB,UAAwB,EAAE;QAChD,KAAK,CAAC;YACJ,GAAG,OAAO;YACV,iBAAiB,EAAE;gBACjB,QAAQ,EAAE,EAAE;gBACZ,OAAO,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE;gBAC7C,gBAAgB,EAAE,IAAI;gBACtB,YAAY,EAAE,IAAI;gBAClB,GAAG,OAAO,CAAC,iBAAiB;aAC7B;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA3CY,QAAQ;IADpB,KAAK,EAAE;IAgCO,WAAA,QAAQ,EAAE,CAAA;;GA/BZ,QAAQ,CA2CpB"}

package/dist/resolvers/job.resolver.d.ts

@@ -0,0 +1,54 @@
+import type { ConnectionArgsInterface, ConnectionResult } from "@nest-boot/graphql-connection";
+import type { GraphQLResolveInfo } from "graphql";
+import { Job as JobEntity } from "../entities/job.entity.js";
+import { JobService } from "../services/job.service.js";
+/** Authenticated Job queries with visibility and ownership enforced by JobService. */
+export declare class JobResolver {
+    private readonly jobService;
+    constructor(jobService: JobService);
+    /**
+     * Returns numeric progress without exposing arbitrary BullMQ progress payloads.
+     * @param job - Authorized parent job.
+     * @returns Finite numeric progress, or null for other progress values.
+     */
+    progress(job: JobEntity): number | null;
+    /**
+     * Reads a task belonging to the current user.
+     * @param id - Database-generated Job UUID.
+     * @returns Matching record in the authorized scope, or null.
+     */
+    userJob(id: string): Promise<JobEntity | null>;
+    /**
+     * Paginates tasks belonging to the current user.
+     * @param args - Cursor pagination, filters and creation-time ordering.
+     * @param info - GraphQL selection used to shape the query.
+     * @returns Nodes and counts within the same authorized scope.
+     */
+    userJobs(args: ConnectionArgsInterface<JobEntity>, info: GraphQLResolveInfo): Promise<ConnectionResult<JobEntity>>;
+    /**
+     * Reads a task in the authorized current workspace.
+     * @param id - Database-generated Job UUID.
+     * @returns Matching record in the authorized scope, or null.
+     */
+    workspaceJob(id: string): Promise<JobEntity | null>;
+    /**
+     * Paginates tasks in the authorized current workspace.
+     * @param args - Cursor pagination, filters and creation-time ordering.
+     * @param info - GraphQL selection used to shape the query.
+     * @returns Nodes and counts within the same authorized scope.
+     */
+    workspaceJobs(args: ConnectionArgsInterface<JobEntity>, info: GraphQLResolveInfo): Promise<ConnectionResult<JobEntity>>;
+    /**
+     * Reads an unowned task after administrator authorization.
+     * @param id - Database-generated Job UUID.
+     * @returns Matching record in the authorized scope, or null.
+     */
+    systemJob(id: string): Promise<JobEntity | null>;
+    /**
+     * Paginates unowned tasks after administrator authorization.
+     * @param args - Cursor pagination, filters and creation-time ordering.
+     * @param info - GraphQL selection used to shape the query.
+     * @returns Nodes and counts within the same authorized scope.
+     */
+    systemJobs(args: ConnectionArgsInterface<JobEntity>, info: GraphQLResolveInfo): Promise<ConnectionResult<JobEntity>>;
+}

package/dist/resolvers/job.resolver.js

@@ -0,0 +1,145 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { AuthGuard } from "@nest-boot/auth";
+import { Args, Float, ID, Info, Parent, Query, ResolveField, Resolver, } from "@nest-boot/graphql";
+import { UseGuards } from "@nestjs/common";
+import { JobConnection, JobConnectionArgs, } from "../connections/job.connection-definition.js";
+import { Job as JobEntity } from "../entities/job.entity.js";
+import { JobService } from "../services/job.service.js";
+/** Authenticated Job queries with visibility and ownership enforced by JobService. */
+let JobResolver = class JobResolver {
+    jobService;
+    constructor(jobService) {
+        this.jobService = jobService;
+    }
+    /**
+     * Returns numeric progress without exposing arbitrary BullMQ progress payloads.
+     * @param job - Authorized parent job.
+     * @returns Finite numeric progress, or null for other progress values.
+     */
+    progress(job) {
+        return typeof job.progress === "number" && Number.isFinite(job.progress)
+            ? job.progress
+            : null;
+    }
+    /**
+     * Reads a task belonging to the current user.
+     * @param id - Database-generated Job UUID.
+     * @returns Matching record in the authorized scope, or null.
+     */
+    async userJob(id) {
+        return await this.jobService.getUserJob(id);
+    }
+    /**
+     * Paginates tasks belonging to the current user.
+     * @param args - Cursor pagination, filters and creation-time ordering.
+     * @param info - GraphQL selection used to shape the query.
+     * @returns Nodes and counts within the same authorized scope.
+     */
+    async userJobs(args, info) {
+        return await this.jobService.getUserJobConnection(args, info);
+    }
+    /**
+     * Reads a task in the authorized current workspace.
+     * @param id - Database-generated Job UUID.
+     * @returns Matching record in the authorized scope, or null.
+     */
+    async workspaceJob(id) {
+        return await this.jobService.getWorkspaceJob(id);
+    }
+    /**
+     * Paginates tasks in the authorized current workspace.
+     * @param args - Cursor pagination, filters and creation-time ordering.
+     * @param info - GraphQL selection used to shape the query.
+     * @returns Nodes and counts within the same authorized scope.
+     */
+    async workspaceJobs(args, info) {
+        return await this.jobService.getWorkspaceJobConnection(args, info);
+    }
+    /**
+     * Reads an unowned task after administrator authorization.
+     * @param id - Database-generated Job UUID.
+     * @returns Matching record in the authorized scope, or null.
+     */
+    async systemJob(id) {
+        return await this.jobService.getSystemJob(id);
+    }
+    /**
+     * Paginates unowned tasks after administrator authorization.
+     * @param args - Cursor pagination, filters and creation-time ordering.
+     * @param info - GraphQL selection used to shape the query.
+     * @returns Nodes and counts within the same authorized scope.
+     */
+    async systemJobs(args, info) {
+        return await this.jobService.getSystemJobConnection(args, info);
+    }
+};
+__decorate([
+    ResolveField(() => Float, { nullable: true }),
+    __param(0, Parent()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [JobEntity]),
+    __metadata("design:returntype", Object)
+], JobResolver.prototype, "progress", null);
+__decorate([
+    Query(() => JobEntity, { nullable: true }),
+    __param(0, Args("id", { type: () => ID })),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], JobResolver.prototype, "userJob", null);
+__decorate([
+    Query(() => JobConnection),
+    __param(0, Args({ type: () => JobConnectionArgs })),
+    __param(1, Info()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], JobResolver.prototype, "userJobs", null);
+__decorate([
+    Query(() => JobEntity, { nullable: true }),
+    __param(0, Args("id", { type: () => ID })),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], JobResolver.prototype, "workspaceJob", null);
+__decorate([
+    Query(() => JobConnection),
+    __param(0, Args({ type: () => JobConnectionArgs })),
+    __param(1, Info()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], JobResolver.prototype, "workspaceJobs", null);
+__decorate([
+    Query(() => JobEntity, { nullable: true }),
+    __param(0, Args("id", { type: () => ID })),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], JobResolver.prototype, "systemJob", null);
+__decorate([
+    Query(() => JobConnection),
+    __param(0, Args({ type: () => JobConnectionArgs })),
+    __param(1, Info()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], JobResolver.prototype, "systemJobs", null);
+JobResolver = __decorate([
+    UseGuards(AuthGuard),
+    Resolver(() => JobEntity),
+    __metadata("design:paramtypes", [JobService])
+], JobResolver);
+export { JobResolver };
+//# sourceMappingURL=job.resolver.js.map

package/dist/resolvers/job.resolver.js.map

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

package/dist/services/job.service.d.ts

@@ -0,0 +1,77 @@
+import { EntityManager } from "@mikro-orm/core";
+import { UserService, WorkspaceService } from "@nest-boot/auth";
+import { type ConnectionArgsInterface, type ConnectionResult } from "@nest-boot/graphql-connection";
+import { QueueManager } from "@nest-boot/queue";
+import { type OnModuleDestroy, type OnModuleInit } from "@nestjs/common";
+import type { GraphQLResolveInfo } from "graphql";
+import { Job as JobEntity } from "../entities/job.entity.js";
+import { JobQueue } from "../queues/job.queue.js";
+/** Manages Job history queries and forwards Redis events to the persistence queue. */
+export declare class JobService implements OnModuleInit, OnModuleDestroy {
+    private readonly em;
+    private readonly queue;
+    private readonly manager;
+    private readonly users;
+    private readonly workspaces;
+    private readonly logger;
+    private readonly sources;
+    private readonly pending;
+    private shutdown?;
+    constructor(em: EntityManager, queue: JobQueue, manager: QueueManager, users: UserService, workspaces: WorkspaceService);
+    /**
+     * Reads one task belonging to the current user.
+     * @param id - Database-generated Job UUID.
+     * @returns Matching record in the authorized scope, or null.
+     */
+    getUserJob(id: string): Promise<JobEntity | null>;
+    /**
+     * Paginates tasks belonging to the current user.
+     * @param args - Cursor pagination, filters and creation-time ordering.
+     * @param info - GraphQL selection used to shape the query.
+     * @returns Nodes and counts within the same authorized scope.
+     */
+    getUserJobConnection(args: ConnectionArgsInterface<JobEntity>, info?: GraphQLResolveInfo): Promise<ConnectionResult<JobEntity>>;
+    /**
+     * Reads one task in the authenticated, selected workspace.
+     * @param id - Database-generated Job UUID.
+     * @returns Matching record in the authorized scope, or null.
+     */
+    getWorkspaceJob(id: string): Promise<JobEntity | null>;
+    /**
+     * Paginates tasks in the authenticated, selected workspace.
+     * @param args - Cursor pagination, filters and creation-time ordering.
+     * @param info - GraphQL selection used to shape the query.
+     * @returns Nodes and counts within the same authorized scope.
+     */
+    getWorkspaceJobConnection(args: ConnectionArgsInterface<JobEntity>, info?: GraphQLResolveInfo): Promise<ConnectionResult<JobEntity>>;
+    /**
+     * Reads an unowned task after checking the current administrator session.
+     * @param id - Database-generated Job UUID.
+     * @returns Matching record in the authorized scope, or null.
+     */
+    getSystemJob(id: string): Promise<JobEntity | null>;
+    /**
+     * Paginates unowned tasks after checking the current administrator session.
+     * @param args - Cursor pagination, filters and creation-time ordering.
+     * @param info - GraphQL selection used to shape the query.
+     * @returns Nodes and counts within the same authorized scope.
+     */
+    getSystemJobConnection(args: ConnectionArgsInterface<JobEntity>, info?: GraphQLResolveInfo): Promise<ConnectionResult<JobEntity>>;
+    private currentUser;
+    private userFilter;
+    private workspaceFilter;
+    private systemFilter;
+    private getScopedJob;
+    private getScopedJobConnection;
+    private visibleFilter;
+    /** Attaches history forwarding before QueueManager starts its event readers. */
+    onModuleInit(): Promise<void>;
+    private forward;
+    private closeReaders;
+    /**
+     * Drains source Workers, event forwarding, then the persistence Worker.
+     * @returns Shared completion of synchronization shutdown.
+     */
+    onModuleDestroy(): Promise<void>;
+    private close;
+}