vaspera 2.5.0

package/dist/enterprise/integrations/ticketing.d.ts

@@ -0,0 +1,257 @@
+/**
+ * Ticketing Integration
+ *
+ * Integrates with Jira, ServiceNow, and Linear for creating
+ * issues and incidents from certification findings.
+ *
+ * @module enterprise/integrations/ticketing
+ */
+import type { Finding, Severity } from "../../certification/types.js";
+/**
+ * Supported ticketing platforms
+ */
+export type TicketingPlatform = "jira" | "servicenow" | "linear";
+/**
+ * Base ticketing configuration
+ */
+export interface TicketingConfig {
+    /** Platform type */
+    platform: TicketingPlatform;
+    /** API base URL */
+    baseUrl: string;
+    /** API token or credentials */
+    apiToken: string;
+    /** Additional auth (e.g., email for Jira) */
+    email?: string;
+    /** Default project/board */
+    defaultProject?: string;
+    /** Severity to priority mapping */
+    severityMapping?: Record<Severity, string>;
+    /** Custom field mappings */
+    customFields?: Record<string, string>;
+}
+/**
+ * Ticket creation request
+ */
+export interface CreateTicketRequest {
+    /** Ticket title */
+    title: string;
+    /** Ticket description (markdown supported) */
+    description: string;
+    /** Ticket type (bug, task, incident, etc.) */
+    type?: string;
+    /** Priority */
+    priority?: string;
+    /** Project/board/team ID */
+    project?: string;
+    /** Labels/tags */
+    labels?: string[];
+    /** Assignee */
+    assignee?: string;
+    /** Custom fields */
+    customFields?: Record<string, unknown>;
+    /** Source finding(s) */
+    findings?: Finding[];
+}
+/**
+ * Created ticket response
+ */
+export interface TicketResponse {
+    /** Ticket ID */
+    id: string;
+    /** Ticket key/number */
+    key: string;
+    /** Ticket URL */
+    url: string;
+    /** Platform */
+    platform: TicketingPlatform;
+    /** Creation timestamp */
+    createdAt: string;
+}
+/**
+ * Batch ticket creation result
+ */
+export interface BatchTicketResult {
+    /** Successfully created tickets */
+    created: TicketResponse[];
+    /** Failed ticket creations */
+    failed: Array<{
+        request: CreateTicketRequest;
+        error: string;
+    }>;
+}
+/**
+ * Jira-specific configuration
+ */
+export interface JiraConfig extends TicketingConfig {
+    platform: "jira";
+    /** Jira Cloud or Server */
+    isCloud: boolean;
+    /** Default issue type */
+    defaultIssueType?: string;
+}
+/**
+ * Jira client
+ */
+export declare class JiraClient {
+    private config;
+    constructor(config: JiraConfig);
+    /**
+     * Create a Jira issue
+     */
+    createTicket(request: CreateTicketRequest): Promise<TicketResponse>;
+    /**
+     * Add comment to existing issue
+     */
+    addComment(issueKey: string, comment: string): Promise<void>;
+    /**
+     * Attach findings report to issue
+     */
+    attachFile(issueKey: string, filename: string, content: string): Promise<void>;
+    /**
+     * Search for existing issues
+     */
+    searchIssues(jql: string): Promise<Array<{
+        key: string;
+        summary: string;
+    }>>;
+    /**
+     * Make Jira API request
+     */
+    private request;
+    /**
+     * Get authorization header
+     */
+    private getAuthHeader;
+    /**
+     * Map severity to Jira priority
+     */
+    private mapSeverity;
+    /**
+     * Format description with findings
+     */
+    private formatDescription;
+    /**
+     * Map custom fields
+     */
+    private mapCustomFields;
+}
+/**
+ * ServiceNow-specific configuration
+ */
+export interface ServiceNowConfig extends TicketingConfig {
+    platform: "servicenow";
+    /** Table to create records in (default: incident) */
+    table?: string;
+}
+/**
+ * ServiceNow client
+ */
+export declare class ServiceNowClient {
+    private config;
+    constructor(config: ServiceNowConfig);
+    /**
+     * Create ServiceNow incident/record
+     */
+    createTicket(request: CreateTicketRequest): Promise<TicketResponse>;
+    /**
+     * Add work note to incident
+     */
+    addWorkNote(sysId: string, note: string): Promise<void>;
+    /**
+     * Update incident state
+     */
+    updateState(sysId: string, state: number): Promise<void>;
+    /**
+     * Make ServiceNow API request
+     */
+    private request;
+    /**
+     * Map severity to ServiceNow priority
+     */
+    private mapSeverity;
+    /**
+     * Format description
+     */
+    private formatDescription;
+}
+/**
+ * Linear-specific configuration
+ */
+export interface LinearConfig extends TicketingConfig {
+    platform: "linear";
+    /** Team ID */
+    teamId?: string;
+}
+/**
+ * Linear client
+ */
+export declare class LinearClient {
+    private config;
+    constructor(config: LinearConfig);
+    /**
+     * Create Linear issue
+     */
+    createTicket(request: CreateTicketRequest): Promise<TicketResponse>;
+    /**
+     * Add comment to issue
+     */
+    addComment(issueId: string, comment: string): Promise<void>;
+    /**
+     * Get team ID by name
+     */
+    getTeamId(teamName: string): Promise<string | null>;
+    /**
+     * Make GraphQL request to Linear API
+     */
+    private graphql;
+    /**
+     * Map severity to Linear priority
+     */
+    private mapSeverityToPriority;
+    /**
+     * Format description with findings
+     */
+    private formatDescription;
+}
+/**
+ * Unified ticketing client
+ */
+export declare class TicketingClient {
+    private client;
+    private platform;
+    constructor(config: TicketingConfig);
+    /**
+     * Create a ticket
+     */
+    createTicket(request: CreateTicketRequest): Promise<TicketResponse>;
+    /**
+     * Create tickets for findings
+     */
+    createTicketsForFindings(findings: Finding[], options?: {
+        project?: string;
+        groupByCategory?: boolean;
+        minSeverity?: Severity;
+    }): Promise<BatchTicketResult>;
+    /**
+     * Get platform name
+     */
+    getPlatform(): TicketingPlatform;
+}
+/**
+ * Create ticketing client
+ */
+export declare function createTicketingClient(config: TicketingConfig): TicketingClient;
+/**
+ * Create Jira client
+ */
+export declare function createJiraClient(config: Omit<JiraConfig, "platform">): JiraClient;
+/**
+ * Create ServiceNow client
+ */
+export declare function createServiceNowClient(config: Omit<ServiceNowConfig, "platform">): ServiceNowClient;
+/**
+ * Create Linear client
+ */
+export declare function createLinearClient(config: Omit<LinearConfig, "platform">): LinearClient;
+//# sourceMappingURL=ticketing.d.ts.map

package/dist/enterprise/integrations/ticketing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticketing.d.ts","sourceRoot":"","sources":["../../../src/enterprise/integrations/ticketing.ts"],"names":[],"mappings":"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"}