@dakkitor/api-contracts 1.1.9 → 1.1.11

package/dist/cron-executions/cron-executions.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-executions.contract.d.ts","sourceRoot":"","sources":["../../contracts/cron-executions/cron-executions.contract.ts"],"names":[],"mappings":"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"}

package/dist/cron-executions/cron-executions.contract.js

@@ -0,0 +1,271 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cronExecutionsContract = exports.PaginatedCronJobHealthSchema = exports.PaginatedCronExecutionHistorySchema = exports.CronExecutionFilterSchema = exports.CronExecutionResponseSchema = exports.CronJobHealthSchema = exports.CronJobMetadataSchema = exports.CronExecutionStatsSchema = exports.CronExecutionHistorySchema = exports.CronExecutionStatusSchema = exports.CronJobNameSchema = void 0;
+const core_1 = require("@ts-rest/core");
+const zod_1 = require("zod");
+const common_schemas_1 = require("../common/common-schemas");
+const error_schemas_1 = require("../common/error-schemas");
+const pagination_query_schema_1 = require("../common/pagination-query.schema");
+const pagination_schema_1 = require("../common/pagination.schema");
+const c = (0, core_1.initContract)();
+exports.CronJobNameSchema = zod_1.z
+    .enum([
+    'GENERATE_DAILY_ACTIVES',
+    'CLEANUP_ORPHANED_FILES',
+    'CLEANUP_ARCHIVED_FILES',
+    'UPDATE_AGENT_PERFORMANCE',
+])
+    .openapi({ title: 'CronJobName' });
+exports.CronExecutionStatusSchema = zod_1.z
+    .enum(['SUCCESS', 'FAILED', 'PARTIAL'])
+    .openapi({ title: 'CronExecutionStatus' });
+exports.CronExecutionHistorySchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid().describe('Unique identifier for this execution'),
+    jobName: zod_1.z.string().describe('Name of the cron job'),
+    status: zod_1.z.string().describe('Execution status'),
+    startedAt: zod_1.z.string().describe('When the execution started'),
+    completedAt: zod_1.z
+        .string()
+        .nullable()
+        .optional()
+        .describe('When the execution completed (null if still running)'),
+    durationMs: zod_1.z
+        .number()
+        .nullable()
+        .optional()
+        .describe('Duration in milliseconds'),
+    recordsProcessed: zod_1.z
+        .number()
+        .nullable()
+        .optional()
+        .describe('Number of records processed during execution'),
+    recordsCreated: zod_1.z
+        .number()
+        .nullable()
+        .optional()
+        .describe('Number of records created during execution'),
+    recordsDeleted: zod_1.z
+        .number()
+        .nullable()
+        .optional()
+        .describe('Number of records deleted during execution'),
+    errorMessage: zod_1.z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Error message if execution failed'),
+})
+    .openapi({ title: 'CronExecutionHistory' });
+exports.CronExecutionStatsSchema = zod_1.z
+    .object({
+    totalExecutions: zod_1.z
+        .number()
+        .describe('Total number of executions in the last 30 days'),
+    successRate: zod_1.z.number().describe('Success rate percentage (0-100)'),
+    averageDurationMs: zod_1.z
+        .number()
+        .describe('Average execution duration in milliseconds'),
+    failedInLast24Hours: zod_1.z
+        .number()
+        .describe('Number of failed executions in the last 24 hours'),
+    executionsByJob: zod_1.z.record(zod_1.z.number()).describe('Executions by job name'),
+    successRateByJob: zod_1.z
+        .record(zod_1.z.number())
+        .describe('Success rate by job name (percentage)'),
+})
+    .openapi({ title: 'CronExecutionStats' });
+exports.CronJobMetadataSchema = zod_1.z
+    .object({
+    recordsProcessed: zod_1.z.number().optional(),
+    recordsCreated: zod_1.z.number().optional(),
+    recordsDeleted: zod_1.z.number().optional(),
+    duration: zod_1.z.string().optional(),
+    durationMs: zod_1.z.number().optional(),
+    error: zod_1.z.string().optional(),
+    warnings: zod_1.z.array(zod_1.z.string()).optional(),
+})
+    .catchall(zod_1.z.unknown())
+    .openapi({ title: 'CronJobMetadata' });
+exports.CronJobHealthSchema = zod_1.z
+    .object({
+    jobName: zod_1.z.string().describe('Name of the cron job'),
+    lastExecutionAt: zod_1.z.string().describe('Last execution timestamp'),
+    isOverdue: zod_1.z
+        .boolean()
+        .describe('Whether the job is overdue (past expected execution time)'),
+    lastStatus: zod_1.z.string().describe('Last execution status'),
+    executionsInLast24Hours: zod_1.z
+        .number()
+        .describe('Number of executions in the last 24 hours'),
+    metadata: exports.CronJobMetadataSchema.optional().describe('Additional job-specific metadata'),
+})
+    .openapi({ title: 'CronJobHealth' });
+exports.CronExecutionResponseSchema = zod_1.z
+    .object({
+    success: zod_1.z
+        .boolean()
+        .describe('Whether the cron job was executed successfully'),
+    message: zod_1.z.string().describe('Message describing the execution result'),
+    executionId: zod_1.z
+        .string()
+        .uuid()
+        .describe('Unique identifier for this execution'),
+})
+    .openapi({ title: 'CronExecutionResponse' });
+exports.CronExecutionFilterSchema = pagination_query_schema_1.PaginationQuerySchema.extend({
+    jobNames: zod_1.z
+        .union([exports.CronJobNameSchema, zod_1.z.array(exports.CronJobNameSchema)])
+        .optional()
+        .transform((val) => (Array.isArray(val) ? val : val ? [val] : undefined))
+        .describe('Filter by specific cron job names'),
+    statuses: zod_1.z
+        .union([exports.CronExecutionStatusSchema, zod_1.z.array(exports.CronExecutionStatusSchema)])
+        .optional()
+        .transform((val) => (Array.isArray(val) ? val : val ? [val] : undefined))
+        .describe('Filter by execution status'),
+    startedAfter: zod_1.z
+        .string()
+        .datetime()
+        .optional()
+        .describe('Filter executions started after this date (ISO 8601 format)'),
+    startedBefore: zod_1.z
+        .string()
+        .datetime()
+        .optional()
+        .describe('Filter executions started before this date (ISO 8601 format)'),
+    sortBy: zod_1.z
+        .enum([
+        'startedAt',
+        'completedAt',
+        'durationMs',
+        'jobName',
+        'status',
+        'createdAt',
+    ])
+        .default('startedAt')
+        .optional()
+        .describe('Sort by field'),
+    sortOrder: common_schemas_1.SortOrderSchema.default('DESC').optional().describe('Sort order'),
+}).openapi({ title: 'CronExecutionFilter' });
+exports.PaginatedCronExecutionHistorySchema = (0, pagination_schema_1.createPaginatedResponseSchema)(exports.CronExecutionHistorySchema).openapi({
+    title: 'PaginatedCronExecutionHistory',
+});
+exports.PaginatedCronJobHealthSchema = (0, pagination_schema_1.createPaginatedResponseSchema)(exports.CronJobHealthSchema).openapi({
+    title: 'PaginatedCronJobHealth',
+});
+exports.cronExecutionsContract = c.router({
+    findAll: {
+        method: 'GET',
+        path: '/cron-executions',
+        query: exports.CronExecutionFilterSchema,
+        responses: {
+            200: exports.PaginatedCronExecutionHistorySchema,
+            403: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'List all cron executions',
+        metadata: {
+            tags: ['Internal - Cron Jobs'],
+        },
+    },
+    getStats: {
+        method: 'GET',
+        path: '/cron-executions/stats',
+        responses: {
+            200: exports.CronExecutionStatsSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Get execution statistics',
+        metadata: {
+            tags: ['Internal - Cron Jobs'],
+        },
+    },
+    getHealthStatus: {
+        method: 'GET',
+        path: '/cron-executions/health',
+        query: pagination_query_schema_1.PaginationQuerySchema,
+        responses: {
+            200: exports.PaginatedCronJobHealthSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Get health status for all cron jobs',
+        metadata: {
+            tags: ['Internal - Cron Jobs'],
+        },
+    },
+    getById: {
+        method: 'GET',
+        path: '/cron-executions/:id',
+        pathParams: zod_1.z.object({
+            id: zod_1.z.string().uuid(),
+        }),
+        responses: {
+            200: exports.CronExecutionHistorySchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Get execution by ID',
+        metadata: {
+            tags: ['Internal - Cron Jobs'],
+        },
+    },
+    triggerGenerateDailyActives: {
+        method: 'POST',
+        path: '/cron-executions/trigger/generate-daily-actives',
+        body: zod_1.z.object({}),
+        responses: {
+            201: exports.CronExecutionResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Trigger actives generation',
+        metadata: {
+            tags: ['Internal - Cron Jobs'],
+        },
+    },
+    triggerCleanupOrphanedFiles: {
+        method: 'POST',
+        path: '/cron-executions/trigger/cleanup-orphaned-files',
+        body: zod_1.z.object({}),
+        responses: {
+            201: exports.CronExecutionResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Trigger orphaned files cleanup',
+        metadata: {
+            tags: ['Internal - Cron Jobs'],
+        },
+    },
+    triggerCleanupArchivedFiles: {
+        method: 'POST',
+        path: '/cron-executions/trigger/cleanup-archived-files',
+        body: zod_1.z.object({}),
+        responses: {
+            201: exports.CronExecutionResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Trigger archived files cleanup',
+        metadata: {
+            tags: ['Internal - Cron Jobs'],
+        },
+    },
+    triggerUpdateAgentPerformance: {
+        method: 'POST',
+        path: '/cron-executions/trigger/update-agent-performance',
+        body: zod_1.z.object({}),
+        responses: {
+            201: exports.CronExecutionResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Trigger agent performance update',
+        metadata: {
+            tags: ['Internal - Cron Jobs'],
+        },
+    },
+}, {
+    pathPrefix: '/v2',
+    commonResponses: {
+        400: error_schemas_1.ErrorResponseSchema,
+        401: error_schemas_1.ErrorResponseSchema,
+        500: error_schemas_1.ErrorResponseSchema,
+    },
+});