@bluefly/openstandardagents 0.4.6 → 0.4.9

package/dist/services/release-automation/release.service.js

@@ -0,0 +1,207 @@
+/**
+ * Release CRUD Service
+ * Implements full CRUD operations for releases
+ */
+import { Gitlab } from '@gitbeaker/rest';
+import { ReleaseSchema, CreateReleaseRequestSchema, UpdateReleaseRequestSchema, } from './schemas/release.schema.js';
+import { BaseCrudService } from './base-crud.service.js';
+import { z } from 'zod';
+/**
+ * Release Filter Input
+ */
+const ReleaseFilterSchema = z.object({
+    version: z.string().optional(),
+    state: z.enum(['draft', 'dev', 'rc', 'released', 'deprecated']).optional(),
+    page: z.number().int().positive().default(1),
+    perPage: z.number().int().positive().min(1).max(100).default(20),
+});
+/**
+ * Release Service - CRUD operations
+ */
+export class ReleaseService extends BaseCrudService {
+    createSchema = CreateReleaseRequestSchema;
+    updateSchema = UpdateReleaseRequestSchema;
+    filterSchema = ReleaseFilterSchema;
+    entitySchema = ReleaseSchema;
+    gitlab;
+    projectId;
+    constructor(gitlabToken, projectId = process.env.CI_PROJECT_ID || '') {
+        super();
+        this.gitlab = new Gitlab({ token: gitlabToken });
+        this.projectId = projectId;
+    }
+    /**
+     * Create a new release
+     */
+    async create(input) {
+        try {
+            const validated = this.validateCreate(input);
+            // Check if release already exists
+            const existing = await this.findByVersion(validated.version);
+            if (existing) {
+                throw new Error(`Release ${validated.version} already exists`);
+            }
+            // Create release entity
+            const release = {
+                id: validated.version,
+                version: validated.version.replace(/^v/, ''),
+                state: 'draft',
+                milestoneId: validated.milestoneId,
+                tags: [],
+                mergeRequestId: undefined,
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+                releasedAt: null,
+                metadata: validated.metadata || {},
+            };
+            return this.validateEntity(release);
+        }
+        catch (error) {
+            this.handleValidationError(error);
+            throw error;
+        }
+    }
+    /**
+     * Read release by ID (version)
+     */
+    async read(id) {
+        this.validateId(id);
+        try {
+            // Try to find by version
+            const version = String(id).replace(/^v/, '');
+            const release = await this.findByVersion(version);
+            return release;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Update release
+     */
+    async update(id, input) {
+        this.validateId(id);
+        const validated = this.validateUpdate(input);
+        const existing = await this.read(id);
+        if (!existing) {
+            this.throwNotFound('Release', id);
+        }
+        const updated = {
+            ...existing,
+            ...validated,
+            updatedAt: new Date().toISOString(),
+            releasedAt: validated.state === 'released'
+                ? new Date().toISOString()
+                : existing.releasedAt,
+        };
+        return this.validateEntity(updated);
+    }
+    /**
+     * Delete release
+     */
+    async delete(id) {
+        this.validateId(id);
+        const existing = await this.read(id);
+        if (!existing) {
+            this.throwNotFound('Release', id);
+        }
+        if (existing.state === 'released') {
+            throw new Error('Cannot delete a released version. Deprecate instead.');
+        }
+        // In a real implementation, you would delete from storage here
+        // For now, we just validate the operation
+    }
+    /**
+     * List releases with filtering and pagination
+     */
+    async list(filters) {
+        const validatedFilters = this.validateFilter(filters || {});
+        try {
+            // Get all tags from GitLab
+            const tags = await this.gitlab.Tags.all(this.projectId, {
+                perPage: 100,
+            });
+            // Filter and map to releases
+            const releases = tags
+                .map((tag) => this.tagToRelease(tag))
+                .filter((release) => {
+                if (validatedFilters.version) {
+                    return release.version.includes(validatedFilters.version);
+                }
+                if (validatedFilters.state) {
+                    return release.state === validatedFilters.state;
+                }
+                return true;
+            });
+            // Sort by version (newest first)
+            releases.sort((a, b) => {
+                return b.version.localeCompare(a.version, undefined, {
+                    numeric: true,
+                    sensitivity: 'base',
+                });
+            });
+            // Paginate
+            const total = releases.length;
+            const page = validatedFilters.page;
+            const perPage = validatedFilters.perPage;
+            const start = (page - 1) * perPage;
+            const end = start + perPage;
+            const paginated = releases.slice(start, end);
+            return {
+                items: paginated.map((r) => this.validateEntity(r)),
+                pagination: this.calculatePagination(total, page, perPage),
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to list releases: ${error}`);
+        }
+    }
+    /**
+     * Helper: Find release by version
+     */
+    async findByVersion(version) {
+        try {
+            const tags = await this.gitlab.Tags.all(this.projectId, {
+                search: version,
+            });
+            const matchingTag = tags.find((tag) => tag.name.includes(version) || tag.name === `v${version}`);
+            if (matchingTag) {
+                return this.tagToRelease(matchingTag);
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Helper: Convert GitLab tag to Release entity
+     */
+    tagToRelease(tag) {
+        const version = tag.name.replace(/^v/, '');
+        const state = this.determineReleaseState(tag.name);
+        return {
+            id: tag.name,
+            version,
+            state,
+            tags: [tag.name],
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            releasedAt: state === 'released' ? new Date().toISOString() : null,
+            metadata: {},
+        };
+    }
+    /**
+     * Helper: Determine release state from tag name
+     */
+    determineReleaseState(tagName) {
+        if (tagName.includes('-dev.'))
+            return 'dev';
+        if (tagName.includes('-rc.'))
+            return 'rc';
+        if (tagName.match(/^v?[0-9]+\.[0-9]+\.[0-9]+$/))
+            return 'released';
+        return 'draft';
+    }
+}
+//# sourceMappingURL=release.service.js.map

package/dist/services/release-automation/schemas/release.schema.d.ts

@@ -0,0 +1,299 @@
+/**
+ * Release Automation - Zod Schemas
+ * DRY: Reusable validation schemas for release entities
+ */
+import { z } from 'zod';
+/**
+ * Release State
+ */
+export declare const ReleaseStateSchema: z.ZodEnum<{
+    deprecated: "deprecated";
+    dev: "dev";
+    draft: "draft";
+    rc: "rc";
+    released: "released";
+}>;
+/**
+ * Tag Type
+ */
+export declare const TagTypeSchema: z.ZodEnum<{
+    dev: "dev";
+    release: "release";
+    rc: "rc";
+}>;
+/**
+ * Milestone State
+ */
+export declare const MilestoneStateSchema: z.ZodEnum<{
+    active: "active";
+    closed: "closed";
+}>;
+/**
+ * Merge Request State
+ */
+export declare const MergeRequestStateSchema: z.ZodEnum<{
+    closed: "closed";
+    opened: "opened";
+    merged: "merged";
+    locked: "locked";
+}>;
+/**
+ * Merge Status
+ */
+export declare const MergeStatusSchema: z.ZodEnum<{
+    can_be_merged: "can_be_merged";
+    cannot_be_merged: "cannot_be_merged";
+    checking: "checking";
+    unchecked: "unchecked";
+}>;
+/**
+ * Base Pagination Schema
+ */
+export declare const PaginationSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodNumber>;
+    perPage: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Release Schema
+ */
+export declare const ReleaseSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodString;
+    state: z.ZodEnum<{
+        deprecated: "deprecated";
+        dev: "dev";
+        draft: "draft";
+        rc: "rc";
+        released: "released";
+    }>;
+    milestoneId: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    mergeRequestId: z.ZodOptional<z.ZodNumber>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Create Release Request
+ */
+export declare const CreateReleaseRequestSchema: z.ZodObject<{
+    version: z.ZodString;
+    milestoneId: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Update Release Request
+ */
+export declare const UpdateReleaseRequestSchema: z.ZodObject<{
+    state: z.ZodOptional<z.ZodEnum<{
+        deprecated: "deprecated";
+        dev: "dev";
+        draft: "draft";
+        rc: "rc";
+        released: "released";
+    }>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Milestone Schema
+ */
+export declare const MilestoneSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    state: z.ZodEnum<{
+        active: "active";
+        closed: "closed";
+    }>;
+    dueDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    startDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    statistics: z.ZodDefault<z.ZodObject<{
+        totalIssues: z.ZodDefault<z.ZodNumber>;
+        closedIssues: z.ZodDefault<z.ZodNumber>;
+        openIssues: z.ZodDefault<z.ZodNumber>;
+        completionPercentage: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Create Milestone Request
+ */
+export declare const CreateMilestoneRequestSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    dueDate: z.ZodOptional<z.ZodString>;
+    startDate: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Update Milestone Request
+ */
+export declare const UpdateMilestoneRequestSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        closed: "closed";
+    }>>;
+    dueDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    startDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Tag Schema
+ */
+export declare const TagSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        dev: "dev";
+        release: "release";
+        rc: "rc";
+    }>;
+    version: z.ZodString;
+    commitSha: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    ref: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Create Tag Request
+ */
+export declare const CreateTagRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+    ref: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Merge Request Schema
+ */
+export declare const MergeRequestSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    sourceBranch: z.ZodString;
+    targetBranch: z.ZodString;
+    state: z.ZodEnum<{
+        closed: "closed";
+        opened: "opened";
+        merged: "merged";
+        locked: "locked";
+    }>;
+    mergeStatus: z.ZodOptional<z.ZodEnum<{
+        can_be_merged: "can_be_merged";
+        cannot_be_merged: "cannot_be_merged";
+        checking: "checking";
+        unchecked: "unchecked";
+    }>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    mergedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    labels: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    approvals: z.ZodDefault<z.ZodObject<{
+        required: z.ZodDefault<z.ZodNumber>;
+        received: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Create Merge Request Request
+ */
+export declare const CreateMergeRequestRequestSchema: z.ZodObject<{
+    sourceBranch: z.ZodString;
+    targetBranch: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    labels: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    milestoneId: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Update Merge Request Request
+ */
+export declare const UpdateMergeRequestRequestSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodEnum<{
+        closed: "closed";
+        opened: "opened";
+        merged: "merged";
+        locked: "locked";
+    }>>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Webhook Payloads
+ */
+export declare const MilestoneWebhookPayloadSchema: z.ZodObject<{
+    object_kind: z.ZodLiteral<"milestone">;
+    project: z.ZodObject<{
+        id: z.ZodNumber;
+        path_with_namespace: z.ZodString;
+    }, z.core.$strip>;
+    object_attributes: z.ZodObject<{
+        id: z.ZodNumber;
+        title: z.ZodString;
+        state: z.ZodEnum<{
+            active: "active";
+            closed: "closed";
+        }>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const PushWebhookPayloadSchema: z.ZodObject<{
+    object_kind: z.ZodLiteral<"push">;
+    project: z.ZodObject<{
+        id: z.ZodNumber;
+    }, z.core.$strip>;
+    ref: z.ZodString;
+    commits: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+/**
+ * Webhook Response
+ */
+export declare const WebhookResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    message: z.ZodString;
+    actions: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        status: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;
+/**
+ * Error Response
+ */
+export declare const ErrorResponseSchema: z.ZodObject<{
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/**
+ * List Response (with pagination)
+ */
+export declare function createListResponseSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+    items: z.ZodArray<T>;
+    pagination: z.ZodObject<{
+        page: z.ZodDefault<z.ZodNumber>;
+        perPage: z.ZodDefault<z.ZodNumber>;
+        total: z.ZodNumber;
+        totalPages: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Type exports for TypeScript
+ */
+export type Release = z.infer<typeof ReleaseSchema>;
+export type CreateReleaseRequest = z.infer<typeof CreateReleaseRequestSchema>;
+export type UpdateReleaseRequest = z.infer<typeof UpdateReleaseRequestSchema>;
+export type Milestone = z.infer<typeof MilestoneSchema>;
+export type CreateMilestoneRequest = z.infer<typeof CreateMilestoneRequestSchema>;
+export type UpdateMilestoneRequest = z.infer<typeof UpdateMilestoneRequestSchema>;
+export type Tag = z.infer<typeof TagSchema>;
+export type CreateTagRequest = z.infer<typeof CreateTagRequestSchema>;
+export type MergeRequest = z.infer<typeof MergeRequestSchema>;
+export type CreateMergeRequestRequest = z.infer<typeof CreateMergeRequestRequestSchema>;
+export type UpdateMergeRequestRequest = z.infer<typeof UpdateMergeRequestRequestSchema>;
+export type MilestoneWebhookPayload = z.infer<typeof MilestoneWebhookPayloadSchema>;
+export type PushWebhookPayload = z.infer<typeof PushWebhookPayloadSchema>;
+export type WebhookResponse = z.infer<typeof WebhookResponseSchema>;
+export type ErrorResponse = z.infer<typeof ErrorResponseSchema>;
+//# sourceMappingURL=release.schema.d.ts.map