devchain-cli 0.13.0 → 0.14.0

package/dist/server/modules/scheduled-epics/controllers/scheduled-epics.controller.js

@@ -0,0 +1,167 @@
+"use strict";
+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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScheduledEpicsController = void 0;
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+const scheduled_epics_service_1 = require("../services/scheduled-epics.service");
+const scheduled_epic_dto_1 = require("../dtos/scheduled-epic.dto");
+const ToggleSchema = zod_1.z
+    .object({
+    enabled: zod_1.z.boolean(),
+    configVersion: zod_1.z.number().int().positive(),
+})
+    .strict();
+const UpdateWithVersionSchema = zod_1.z
+    .object({
+    configVersion: zod_1.z.number().int().positive(),
+})
+    .passthrough();
+let ScheduledEpicsController = class ScheduledEpicsController {
+    constructor(service) {
+        this.service = service;
+    }
+    async list(projectId, enabled) {
+        if (!projectId) {
+            throw new common_1.BadRequestException('projectId query parameter is required');
+        }
+        const result = await this.service.list(projectId, {
+            enabled: enabled === 'true' ? true : enabled === 'false' ? false : undefined,
+        });
+        return result.items;
+    }
+    async get(id) {
+        return this.service.get(id);
+    }
+    async create(body) {
+        const parseResult = scheduled_epic_dto_1.CreateScheduledEpicDtoSchema.safeParse(body);
+        if (!parseResult.success) {
+            throw new common_1.BadRequestException({
+                message: 'Validation failed',
+                errors: parseResult.error.errors,
+            });
+        }
+        return this.service.create(parseResult.data);
+    }
+    async update(id, body) {
+        const versionParse = UpdateWithVersionSchema.safeParse(body);
+        if (!versionParse.success) {
+            throw new common_1.BadRequestException({
+                message: 'configVersion is required',
+                errors: versionParse.error.errors,
+            });
+        }
+        const { configVersion, ...rest } = versionParse.data;
+        const dtoParse = scheduled_epic_dto_1.UpdateScheduledEpicDtoSchema.safeParse(rest);
+        if (!dtoParse.success) {
+            throw new common_1.BadRequestException({
+                message: 'Validation failed',
+                errors: dtoParse.error.errors,
+            });
+        }
+        return this.service.update(id, dtoParse.data, configVersion);
+    }
+    async delete(id) {
+        await this.service.delete(id);
+        return { success: true };
+    }
+    async toggle(id, body) {
+        const parseResult = ToggleSchema.safeParse(body);
+        if (!parseResult.success) {
+            throw new common_1.BadRequestException({
+                message: 'Validation failed',
+                errors: parseResult.error.errors,
+            });
+        }
+        return this.service.toggle(id, parseResult.data.enabled, parseResult.data.configVersion);
+    }
+    async runNow(id) {
+        return this.service.runNow(id);
+    }
+    async listRuns(scheduleId, status, limit, offset) {
+        return this.service.listRuns(scheduleId, {
+            status: status,
+            limit: limit ? parseInt(limit, 10) : undefined,
+            offset: offset ? parseInt(offset, 10) : undefined,
+        });
+    }
+};
+exports.ScheduledEpicsController = ScheduledEpicsController;
+__decorate([
+    (0, common_1.Get)(),
+    __param(0, (0, common_1.Query)('projectId')),
+    __param(1, (0, common_1.Query)('enabled')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String]),
+    __metadata("design:returntype", Promise)
+], ScheduledEpicsController.prototype, "list", null);
+__decorate([
+    (0, common_1.Get)(':id'),
+    __param(0, (0, common_1.Param)('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], ScheduledEpicsController.prototype, "get", null);
+__decorate([
+    (0, common_1.Post)(),
+    __param(0, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ScheduledEpicsController.prototype, "create", null);
+__decorate([
+    (0, common_1.Put)(':id'),
+    __param(0, (0, common_1.Param)('id')),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], ScheduledEpicsController.prototype, "update", null);
+__decorate([
+    (0, common_1.Delete)(':id'),
+    __param(0, (0, common_1.Param)('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], ScheduledEpicsController.prototype, "delete", null);
+__decorate([
+    (0, common_1.Post)(':id/toggle'),
+    __param(0, (0, common_1.Param)('id')),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], ScheduledEpicsController.prototype, "toggle", null);
+__decorate([
+    (0, common_1.Post)(':id/run-now'),
+    __param(0, (0, common_1.Param)('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], ScheduledEpicsController.prototype, "runNow", null);
+__decorate([
+    (0, common_1.Get)(':id/runs'),
+    __param(0, (0, common_1.Param)('id')),
+    __param(1, (0, common_1.Query)('status')),
+    __param(2, (0, common_1.Query)('limit')),
+    __param(3, (0, common_1.Query)('offset')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String, String]),
+    __metadata("design:returntype", Promise)
+], ScheduledEpicsController.prototype, "listRuns", null);
+exports.ScheduledEpicsController = ScheduledEpicsController = __decorate([
+    (0, common_1.Controller)('api/scheduled-epics'),
+    __metadata("design:paramtypes", [scheduled_epics_service_1.ScheduledEpicsService])
+], ScheduledEpicsController);
+//# sourceMappingURL=scheduled-epics.controller.js.map

package/dist/server/modules/scheduled-epics/controllers/scheduled-epics.controller.js.map

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

package/dist/server/modules/scheduled-epics/dtos/scheduled-epic.dto.d.ts

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+export declare const CreateScheduledEpicDtoSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    name: z.ZodString;
+    cronExpression: z.ZodEffects<z.ZodString, string, string>;
+    timezone: z.ZodEffects<z.ZodString, string, string>;
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    titleTemplate: z.ZodEffects<z.ZodString, string, string>;
+    descriptionTemplate: z.ZodNullable<z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>>;
+    templateStatusId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    templateParentEpicId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    templateAgentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    templateTags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    allowOverlap: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    missedRunPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["skip", "run_once", "run_all"]>>>;
+    nextRunAt: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    projectId: string;
+    enabled: boolean;
+    cronExpression: string;
+    timezone: string;
+    titleTemplate: string;
+    templateTags: string[];
+    allowOverlap: boolean;
+    missedRunPolicy: "skip" | "run_once" | "run_all";
+    nextRunAt?: string | null | undefined;
+    descriptionTemplate?: string | null | undefined;
+    templateStatusId?: string | null | undefined;
+    templateParentEpicId?: string | null | undefined;
+    templateAgentId?: string | null | undefined;
+}, {
+    name: string;
+    projectId: string;
+    cronExpression: string;
+    timezone: string;
+    titleTemplate: string;
+    enabled?: boolean | undefined;
+    nextRunAt?: string | null | undefined;
+    descriptionTemplate?: string | null | undefined;
+    templateStatusId?: string | null | undefined;
+    templateParentEpicId?: string | null | undefined;
+    templateAgentId?: string | null | undefined;
+    templateTags?: string[] | undefined;
+    allowOverlap?: boolean | undefined;
+    missedRunPolicy?: "skip" | "run_once" | "run_all" | undefined;
+}>;
+export type CreateScheduledEpicDto = z.infer<typeof CreateScheduledEpicDtoSchema>;
+export declare const UpdateScheduledEpicDtoSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    cronExpression: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    timezone: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    titleTemplate: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    descriptionTemplate: z.ZodNullable<z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>>;
+    templateStatusId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    templateParentEpicId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    templateAgentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    templateTags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    allowOverlap: z.ZodOptional<z.ZodBoolean>;
+    missedRunPolicy: z.ZodOptional<z.ZodEnum<["skip", "run_once", "run_all"]>>;
+}, "strict", z.ZodTypeAny, {
+    name?: string | undefined;
+    enabled?: boolean | undefined;
+    cronExpression?: string | undefined;
+    timezone?: string | undefined;
+    titleTemplate?: string | undefined;
+    descriptionTemplate?: string | null | undefined;
+    templateStatusId?: string | null | undefined;
+    templateParentEpicId?: string | null | undefined;
+    templateAgentId?: string | null | undefined;
+    templateTags?: string[] | undefined;
+    allowOverlap?: boolean | undefined;
+    missedRunPolicy?: "skip" | "run_once" | "run_all" | undefined;
+}, {
+    name?: string | undefined;
+    enabled?: boolean | undefined;
+    cronExpression?: string | undefined;
+    timezone?: string | undefined;
+    titleTemplate?: string | undefined;
+    descriptionTemplate?: string | null | undefined;
+    templateStatusId?: string | null | undefined;
+    templateParentEpicId?: string | null | undefined;
+    templateAgentId?: string | null | undefined;
+    templateTags?: string[] | undefined;
+    allowOverlap?: boolean | undefined;
+    missedRunPolicy?: "skip" | "run_once" | "run_all" | undefined;
+}>;
+export type UpdateScheduledEpicDto = z.infer<typeof UpdateScheduledEpicDtoSchema>;

package/dist/server/modules/scheduled-epics/dtos/scheduled-epic.dto.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateScheduledEpicDtoSchema = exports.CreateScheduledEpicDtoSchema = void 0;
+const zod_1 = require("zod");
+const cron_helpers_1 = require("../helpers/cron-helpers");
+const timezone_helpers_1 = require("../helpers/timezone-helpers");
+const template_helpers_1 = require("../helpers/template-helpers");
+const CronExpressionSchema = zod_1.z
+    .string()
+    .min(1)
+    .superRefine((expr, ctx) => {
+    const result = (0, cron_helpers_1.validateCronExpression)(expr);
+    if (!result.valid) {
+        ctx.addIssue({ code: zod_1.z.ZodIssueCode.custom, message: result.reason });
+    }
+});
+const TimezoneSchema = zod_1.z
+    .string()
+    .min(1)
+    .superRefine((tz, ctx) => {
+    const result = (0, timezone_helpers_1.validateTimezone)(tz);
+    if (!result.valid) {
+        ctx.addIssue({ code: zod_1.z.ZodIssueCode.custom, message: result.reason });
+    }
+});
+const HandlebarsTemplateSchema = zod_1.z
+    .string()
+    .min(1)
+    .superRefine((tpl, ctx) => {
+    const result = (0, template_helpers_1.checkTemplateReady)(tpl);
+    if (!result.ready) {
+        ctx.addIssue({ code: zod_1.z.ZodIssueCode.custom, message: result.reason });
+    }
+});
+exports.CreateScheduledEpicDtoSchema = zod_1.z
+    .object({
+    projectId: zod_1.z.string().uuid(),
+    name: zod_1.z.string().min(1).max(200),
+    cronExpression: CronExpressionSchema,
+    timezone: TimezoneSchema,
+    enabled: zod_1.z.boolean().optional().default(true),
+    titleTemplate: HandlebarsTemplateSchema,
+    descriptionTemplate: zod_1.z
+        .string()
+        .superRefine((tpl, ctx) => {
+        if (tpl.length === 0)
+            return;
+        const result = (0, template_helpers_1.checkTemplateReady)(tpl);
+        if (!result.ready) {
+            ctx.addIssue({ code: zod_1.z.ZodIssueCode.custom, message: result.reason });
+        }
+    })
+        .optional()
+        .nullable(),
+    templateStatusId: zod_1.z.string().uuid().optional().nullable(),
+    templateParentEpicId: zod_1.z.string().uuid().optional().nullable(),
+    templateAgentId: zod_1.z.string().uuid().optional().nullable(),
+    templateTags: zod_1.z.array(zod_1.z.string().min(1)).optional().default([]),
+    allowOverlap: zod_1.z.boolean().optional().default(false),
+    missedRunPolicy: zod_1.z.enum(['skip', 'run_once', 'run_all']).optional().default('skip'),
+    nextRunAt: zod_1.z.string().datetime({ offset: true }).optional().nullable(),
+})
+    .strict();
+exports.UpdateScheduledEpicDtoSchema = zod_1.z
+    .object({
+    name: zod_1.z.string().min(1).max(200).optional(),
+    cronExpression: CronExpressionSchema.optional(),
+    timezone: TimezoneSchema.optional(),
+    enabled: zod_1.z.boolean().optional(),
+    titleTemplate: HandlebarsTemplateSchema.optional(),
+    descriptionTemplate: zod_1.z
+        .string()
+        .superRefine((tpl, ctx) => {
+        if (tpl.length === 0)
+            return;
+        const result = (0, template_helpers_1.checkTemplateReady)(tpl);
+        if (!result.ready) {
+            ctx.addIssue({ code: zod_1.z.ZodIssueCode.custom, message: result.reason });
+        }
+    })
+        .optional()
+        .nullable(),
+    templateStatusId: zod_1.z.string().uuid().optional().nullable(),
+    templateParentEpicId: zod_1.z.string().uuid().optional().nullable(),
+    templateAgentId: zod_1.z.string().uuid().optional().nullable(),
+    templateTags: zod_1.z.array(zod_1.z.string().min(1)).optional(),
+    allowOverlap: zod_1.z.boolean().optional(),
+    missedRunPolicy: zod_1.z.enum(['skip', 'run_once', 'run_all']).optional(),
+})
+    .strict();
+//# sourceMappingURL=scheduled-epic.dto.js.map

package/dist/server/modules/scheduled-epics/dtos/scheduled-epic.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-epic.dto.js","sourceRoot":"","sources":["../../../../src/modules/scheduled-epics/dtos/scheduled-epic.dto.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/scheduled-epics/helpers/cron-helpers.d.ts

@@ -0,0 +1,8 @@
+export type CronValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    reason: string;
+};
+export declare function validateCronExpression(expression: string): CronValidationResult;
+export declare function getNextRunAt(expression: string, timezone: string, after?: Date): Date | null;

package/dist/server/modules/scheduled-epics/helpers/cron-helpers.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateCronExpression = validateCronExpression;
+exports.getNextRunAt = getNextRunAt;
+const croner_1 = require("croner");
+function validateCronExpression(expression) {
+    try {
+        new croner_1.Cron(expression, { paused: true });
+        return { valid: true };
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : 'Invalid cron expression';
+        return { valid: false, reason };
+    }
+}
+function getNextRunAt(expression, timezone, after) {
+    const cron = new croner_1.Cron(expression, { timezone, paused: true });
+    return cron.nextRun(after ?? new Date());
+}
+//# sourceMappingURL=cron-helpers.js.map

package/dist/server/modules/scheduled-epics/helpers/cron-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-helpers.js","sourceRoot":"","sources":["../../../../src/modules/scheduled-epics/helpers/cron-helpers.ts"],"names":[],"mappings":";;AAIA,wDAQC;AAED,oCAGC;AAjBD,mCAA8B;AAI9B,SAAgB,sBAAsB,CAAC,UAAkB;IACvD,IAAI,CAAC;QACH,IAAI,aAAI,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAC;QAClF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;AACH,CAAC;AAED,SAAgB,YAAY,CAAC,UAAkB,EAAE,QAAgB,EAAE,KAAY;IAC7E,MAAM,IAAI,GAAG,IAAI,aAAI,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/server/modules/scheduled-epics/helpers/template-helpers.d.ts

@@ -0,0 +1,8 @@
+export type TemplateReadinessResult = {
+    ready: true;
+} | {
+    ready: false;
+    reason: string;
+};
+export declare function checkTemplateReady(template: string, sampleVars?: Record<string, unknown>): TemplateReadinessResult;
+export declare function renderScheduledEpicTemplate(template: string, vars: Record<string, unknown>): string;

package/dist/server/modules/scheduled-epics/helpers/template-helpers.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkTemplateReady = checkTemplateReady;
+exports.renderScheduledEpicTemplate = renderScheduledEpicTemplate;
+const handlebars_renderer_1 = require("../../../common/template/handlebars-renderer");
+function checkTemplateReady(template, sampleVars) {
+    try {
+        (0, handlebars_renderer_1.renderTemplate)(template, sampleVars ?? {});
+        return { ready: true };
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : 'Template render failed';
+        return { ready: false, reason };
+    }
+}
+function renderScheduledEpicTemplate(template, vars) {
+    return (0, handlebars_renderer_1.renderTemplate)(template, vars);
+}
+//# sourceMappingURL=template-helpers.js.map

package/dist/server/modules/scheduled-epics/helpers/template-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-helpers.js","sourceRoot":"","sources":["../../../../src/modules/scheduled-epics/helpers/template-helpers.ts"],"names":[],"mappings":";;AAIA,gDAWC;AAED,kEAKC;AAtBD,sFAA8E;AAI9E,SAAgB,kBAAkB,CAChC,QAAgB,EAChB,UAAoC;IAEpC,IAAI,CAAC;QACH,IAAA,oCAAc,EAAC,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC;QAC3C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;QACjF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;AACH,CAAC;AAED,SAAgB,2BAA2B,CACzC,QAAgB,EAChB,IAA6B;IAE7B,OAAO,IAAA,oCAAc,EAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC"}

package/dist/server/modules/scheduled-epics/helpers/timezone-helpers.d.ts

@@ -0,0 +1,7 @@
+export type TimezoneValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    reason: string;
+};
+export declare function validateTimezone(timezone: string): TimezoneValidationResult;

package/dist/server/modules/scheduled-epics/helpers/timezone-helpers.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTimezone = validateTimezone;
+function validateTimezone(timezone) {
+    if (!timezone || timezone.trim() === '') {
+        return { valid: false, reason: 'Timezone must not be empty' };
+    }
+    try {
+        Intl.DateTimeFormat(undefined, { timeZone: timezone });
+        return { valid: true };
+    }
+    catch {
+        return { valid: false, reason: `Unknown timezone: "${timezone}"` };
+    }
+}
+//# sourceMappingURL=timezone-helpers.js.map

package/dist/server/modules/scheduled-epics/helpers/timezone-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone-helpers.js","sourceRoot":"","sources":["../../../../src/modules/scheduled-epics/helpers/timezone-helpers.ts"],"names":[],"mappings":";;AAEA,4CAaC;AAbD,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;IAChE,CAAC;IAID,IAAI,CAAC;QACH,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,QAAQ,GAAG,EAAE,CAAC;IACrE,CAAC;AACH,CAAC"}

package/dist/server/modules/scheduled-epics/scheduled-epics.module.d.ts

@@ -0,0 +1,2 @@
+export declare class ScheduledEpicsModule {
+}

package/dist/server/modules/scheduled-epics/scheduled-epics.module.js

@@ -0,0 +1,35 @@
+"use strict";
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScheduledEpicsModule = void 0;
+const common_1 = require("@nestjs/common");
+const storage_module_1 = require("../storage/storage.module");
+const epics_module_1 = require("../epics/epics.module");
+const events_core_module_1 = require("../events/events-core.module");
+const scheduled_epics_service_1 = require("./services/scheduled-epics.service");
+const scheduled_epic_runner_service_1 = require("./services/scheduled-epic-runner.service");
+const scheduled_epics_controller_1 = require("./controllers/scheduled-epics.controller");
+let ScheduledEpicsModule = class ScheduledEpicsModule {
+};
+exports.ScheduledEpicsModule = ScheduledEpicsModule;
+exports.ScheduledEpicsModule = ScheduledEpicsModule = __decorate([
+    (0, common_1.Module)({
+        imports: [storage_module_1.StorageModule, epics_module_1.EpicsModule, events_core_module_1.EventsCoreModule],
+        controllers: [scheduled_epics_controller_1.ScheduledEpicsController],
+        providers: [
+            scheduled_epics_service_1.ScheduledEpicsService,
+            scheduled_epic_runner_service_1.ScheduledEpicRunnerService,
+            {
+                provide: scheduled_epics_service_1.SCHEDULED_EPIC_RUNNER_REFRESH,
+                useExisting: scheduled_epic_runner_service_1.ScheduledEpicRunnerService,
+            },
+        ],
+        exports: [scheduled_epics_service_1.ScheduledEpicsService, scheduled_epic_runner_service_1.ScheduledEpicRunnerService, scheduled_epics_service_1.SCHEDULED_EPIC_RUNNER_REFRESH],
+    })
+], ScheduledEpicsModule);
+//# sourceMappingURL=scheduled-epics.module.js.map

package/dist/server/modules/scheduled-epics/scheduled-epics.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-epics.module.js","sourceRoot":"","sources":["../../../src/modules/scheduled-epics/scheduled-epics.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,8DAA0D;AAC1D,wDAAoD;AACpD,qEAAgE;AAChE,gFAG4C;AAC5C,4FAAsF;AACtF,yFAAoF;AAe7E,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;CAAG,CAAA;AAAvB,oDAAoB;+BAApB,oBAAoB;IAbhC,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,8BAAa,EAAE,0BAAW,EAAE,qCAAgB,CAAC;QACvD,WAAW,EAAE,CAAC,qDAAwB,CAAC;QACvC,SAAS,EAAE;YACT,+CAAqB;YACrB,0DAA0B;YAC1B;gBACE,OAAO,EAAE,uDAA6B;gBACtC,WAAW,EAAE,0DAA0B;aACxC;SACF;QACD,OAAO,EAAE,CAAC,+CAAqB,EAAE,0DAA0B,EAAE,uDAA6B,CAAC;KAC5F,CAAC;GACW,oBAAoB,CAAG"}

package/dist/server/modules/scheduled-epics/services/scheduled-epic-runner.service.d.ts

@@ -0,0 +1,33 @@
+import { OnModuleDestroy, OnModuleInit } from '@nestjs/common';
+import { type StorageService } from '../../storage/interfaces/storage.interface';
+import type { ScheduledEpicRun } from '../../storage/models/domain.models';
+import { EpicsService } from '../../epics/services/epics.service';
+import { EventsService } from '../../events/services/events.service';
+import type { ScheduledEpicRunnerRefresh } from './scheduled-epics.service';
+export declare class ScheduledEpicRunnerService implements ScheduledEpicRunnerRefresh, OnModuleInit, OnModuleDestroy {
+    private readonly storage;
+    private readonly epicsService;
+    private readonly eventsService;
+    private wakeTimer;
+    private scanning;
+    constructor(storage: StorageService, epicsService: EpicsService, eventsService: EventsService);
+    onModuleInit(): void;
+    onModuleDestroy(): void;
+    refreshScheduleWindow(): void;
+    private scheduleNextWake;
+    private clearWakeTimer;
+    private wake;
+    private scanAndExecute;
+    private scanProject;
+    private processSchedule;
+    private computeMissedSlots;
+    private claimAndExecute;
+    private atomicClaim;
+    private drainPendingRuns;
+    executeRun(run: ScheduledEpicRun): Promise<void>;
+    private executeClaimedRun;
+    private publishRunOutcome;
+    private recoverStaleRuns;
+    private advanceNextRunAt;
+    private buildTemplateVars;
+}