@simonfestl/husky-cli 0.8.2 → 0.9.0

package/dist/lib/biz/zendesk-types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Zendesk API Types
+ * Extended for v0.9 with macros support
+ */
+export interface ZendeskConfig {
+    SUBDOMAIN: string;
+    EMAIL: string;
+    API_TOKEN: string;
+    BASE_URL?: string;
+}
+export declare enum TicketPriority {
+    Low = "low",
+    Normal = "normal",
+    High = "high",
+    Urgent = "urgent"
+}
+export declare enum TicketStatus {
+    New = "new",
+    Open = "open",
+    Pending = "pending",
+    Hold = "hold",
+    Solved = "solved",
+    Closed = "closed"
+}
+export declare enum TicketType {
+    Problem = "problem",
+    Incident = "incident",
+    Question = "question",
+    Task = "task"
+}
+export interface PaginationParams {
+    page?: number;
+    per_page?: number;
+    sort_by?: string;
+    sort_order?: 'asc' | 'desc';
+}
+export interface ZendeskUser {
+    id: number;
+    name: string;
+    email: string;
+    phone?: string;
+    role: string;
+    created_at: string;
+    updated_at: string;
+    organization_id?: number;
+    tags?: string[];
+}
+export interface ZendeskTicket {
+    id: number;
+    subject: string;
+    description?: string;
+    status: TicketStatus | string;
+    priority?: TicketPriority | string;
+    type?: TicketType | string;
+    requester_id?: number;
+    assignee_id?: number;
+    group_id?: number;
+    tags?: string[];
+    custom_fields?: Array<{
+        id: number;
+        value: unknown;
+    }>;
+    created_at: string;
+    updated_at: string;
+    url?: string;
+}
+export interface TicketComment {
+    id: number;
+    type: string;
+    author_id: number;
+    body: string;
+    html_body?: string;
+    public: boolean;
+    created_at: string;
+    attachments?: Attachment[];
+}
+export interface Attachment {
+    id: number;
+    file_name: string;
+    content_url: string;
+    content_type: string;
+    size: number;
+}
+export interface CreateTicketRequest {
+    subject: string;
+    comment: {
+        body: string;
+        public?: boolean;
+    };
+    requester?: {
+        name?: string;
+        email?: string;
+    };
+    requester_id?: number;
+    priority?: TicketPriority | string;
+    status?: TicketStatus | string;
+    type?: TicketType | string;
+    tags?: string[];
+    assignee_id?: number;
+}
+export interface UpdateTicketRequest {
+    subject?: string;
+    comment?: {
+        body: string;
+        public?: boolean;
+    };
+    status?: TicketStatus | string;
+    priority?: TicketPriority | string;
+    assignee_id?: number;
+    tags?: string[];
+}
+export interface SearchResult<T> {
+    results: T[];
+    count: number;
+    next_page: string | null;
+    previous_page: string | null;
+}
+export interface MacroAction {
+    field: string;
+    value: string | string[];
+}
+export interface ZendeskMacro {
+    id: number;
+    title: string;
+    description?: string;
+    active: boolean;
+    actions: MacroAction[];
+    restriction?: {
+        type: string;
+        id?: number;
+        ids?: number[];
+    };
+    created_at: string;
+    updated_at: string;
+    url?: string;
+}

package/dist/lib/biz/zendesk-types.js

@@ -0,0 +1,28 @@
+/**
+ * Zendesk API Types
+ * Extended for v0.9 with macros support
+ */
+// Enums
+export var TicketPriority;
+(function (TicketPriority) {
+    TicketPriority["Low"] = "low";
+    TicketPriority["Normal"] = "normal";
+    TicketPriority["High"] = "high";
+    TicketPriority["Urgent"] = "urgent";
+})(TicketPriority || (TicketPriority = {}));
+export var TicketStatus;
+(function (TicketStatus) {
+    TicketStatus["New"] = "new";
+    TicketStatus["Open"] = "open";
+    TicketStatus["Pending"] = "pending";
+    TicketStatus["Hold"] = "hold";
+    TicketStatus["Solved"] = "solved";
+    TicketStatus["Closed"] = "closed";
+})(TicketStatus || (TicketStatus = {}));
+export var TicketType;
+(function (TicketType) {
+    TicketType["Problem"] = "problem";
+    TicketType["Incident"] = "incident";
+    TicketType["Question"] = "question";
+    TicketType["Task"] = "task";
+})(TicketType || (TicketType = {}));

package/dist/lib/biz/zendesk.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Zendesk API Client
+ * Extended for v0.9 with macros and enhanced ticket operations
+ */
+import { ZendeskConfig, ZendeskTicket, ZendeskUser, TicketComment, CreateTicketRequest, UpdateTicketRequest, PaginationParams, Attachment, ZendeskMacro } from './zendesk-types.js';
+export declare class ZendeskClient {
+    private config;
+    private baseUrl;
+    constructor(config: ZendeskConfig);
+    /**
+     * Create client from Husky config
+     */
+    static fromConfig(): ZendeskClient;
+    /**
+     * Make authenticated request
+     */
+    private request;
+    listTickets(params?: PaginationParams & {
+        status?: string;
+    }): Promise<ZendeskTicket[]>;
+    getTicket(ticketId: number): Promise<ZendeskTicket>;
+    createTicket(data: CreateTicketRequest): Promise<ZendeskTicket>;
+    updateTicket(ticketId: number, data: UpdateTicketRequest): Promise<ZendeskTicket>;
+    deleteTicket(ticketId: number): Promise<void>;
+    addComment(ticketId: number, body: string, isPublic?: boolean): Promise<ZendeskTicket>;
+    addInternalNote(ticketId: number, body: string): Promise<ZendeskTicket>;
+    closeTicket(ticketId: number): Promise<ZendeskTicket>;
+    assignTicket(ticketId: number, assigneeId: number): Promise<ZendeskTicket>;
+    addTags(ticketId: number, tags: string[]): Promise<ZendeskTicket>;
+    removeTags(ticketId: number, tags: string[]): Promise<ZendeskTicket>;
+    getTicketComments(ticketId: number): Promise<TicketComment[]>;
+    searchTickets(query: string): Promise<ZendeskTicket[]>;
+    getTicketAttachments(ticketId: number): Promise<Attachment[]>;
+    downloadAttachment(contentUrl: string): Promise<ArrayBuffer>;
+    getUser(userId: number): Promise<ZendeskUser>;
+    searchUsers(query: string): Promise<ZendeskUser[]>;
+    getUserTickets(userId: number): Promise<ZendeskTicket[]>;
+    listMacros(params?: {
+        active?: boolean;
+        category?: number;
+    }): Promise<ZendeskMacro[]>;
+    getMacro(macroId: number): Promise<ZendeskMacro>;
+    applyMacro(ticketId: number, macroId: number): Promise<ZendeskTicket>;
+}
+export default ZendeskClient;

package/dist/lib/biz/zendesk.js

@@ -0,0 +1,206 @@
+/**
+ * Zendesk API Client
+ * Extended for v0.9 with macros and enhanced ticket operations
+ */
+import { getConfig } from '../../commands/config.js';
+export class ZendeskClient {
+    config;
+    baseUrl;
+    constructor(config) {
+        this.config = config;
+        this.baseUrl = config.BASE_URL || `https://${config.SUBDOMAIN}.zendesk.com/api/v2`;
+    }
+    /**
+     * Create client from Husky config
+     */
+    static fromConfig() {
+        const config = getConfig();
+        const zendeskConfig = {
+            SUBDOMAIN: config.zendeskSubdomain || process.env.ZENDESK_SUBDOMAIN || '',
+            EMAIL: config.zendeskEmail || process.env.ZENDESK_EMAIL || '',
+            API_TOKEN: config.zendeskApiToken || process.env.ZENDESK_API_TOKEN || '',
+        };
+        if (!zendeskConfig.SUBDOMAIN || !zendeskConfig.EMAIL || !zendeskConfig.API_TOKEN) {
+            throw new Error('Missing Zendesk credentials. Configure with:\n' +
+                '  husky config set zendesk-subdomain <subdomain>\n' +
+                '  husky config set zendesk-email <email>\n' +
+                '  husky config set zendesk-api-token <token>');
+        }
+        return new ZendeskClient(zendeskConfig);
+    }
+    /**
+     * Make authenticated request
+     */
+    async request(endpoint, options = {}) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const auth = Buffer.from(`${this.config.EMAIL}/token:${this.config.API_TOKEN}`).toString('base64');
+        const response = await fetch(url, {
+            ...options,
+            headers: {
+                'Authorization': `Basic ${auth}`,
+                'Content-Type': 'application/json',
+                ...options.headers,
+            },
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Zendesk API Error ${response.status}: ${error}`);
+        }
+        if (response.status === 204) {
+            return {};
+        }
+        return response.json();
+    }
+    // =========================================================================
+    // TICKETS
+    // =========================================================================
+    async listTickets(params) {
+        const query = new URLSearchParams();
+        if (params?.page)
+            query.set('page', String(params.page));
+        if (params?.per_page)
+            query.set('per_page', String(params.per_page));
+        if (params?.sort_by)
+            query.set('sort_by', params.sort_by);
+        if (params?.sort_order)
+            query.set('sort_order', params.sort_order);
+        // Filter by status using search
+        if (params?.status) {
+            return this.searchTickets(`status:${params.status}`);
+        }
+        const endpoint = `/tickets.json${query.toString() ? `?${query}` : ''}`;
+        const response = await this.request(endpoint);
+        return response.tickets;
+    }
+    async getTicket(ticketId) {
+        const response = await this.request(`/tickets/${ticketId}.json`);
+        return response.ticket;
+    }
+    async createTicket(data) {
+        const response = await this.request('/tickets.json', {
+            method: 'POST',
+            body: JSON.stringify({ ticket: data }),
+        });
+        return response.ticket;
+    }
+    async updateTicket(ticketId, data) {
+        const response = await this.request(`/tickets/${ticketId}.json`, {
+            method: 'PUT',
+            body: JSON.stringify({ ticket: data }),
+        });
+        return response.ticket;
+    }
+    async deleteTicket(ticketId) {
+        await this.request(`/tickets/${ticketId}.json`, { method: 'DELETE' });
+    }
+    async addComment(ticketId, body, isPublic = true) {
+        return this.updateTicket(ticketId, {
+            comment: { body, public: isPublic },
+        });
+    }
+    async addInternalNote(ticketId, body) {
+        return this.addComment(ticketId, body, false);
+    }
+    async closeTicket(ticketId) {
+        return this.updateTicket(ticketId, { status: 'solved' });
+    }
+    async assignTicket(ticketId, assigneeId) {
+        return this.updateTicket(ticketId, { assignee_id: assigneeId });
+    }
+    async addTags(ticketId, tags) {
+        const ticket = await this.getTicket(ticketId);
+        const existingTags = ticket.tags || [];
+        const newTags = [...new Set([...existingTags, ...tags])];
+        return this.updateTicket(ticketId, { tags: newTags });
+    }
+    async removeTags(ticketId, tags) {
+        const ticket = await this.getTicket(ticketId);
+        const existingTags = ticket.tags || [];
+        const newTags = existingTags.filter(t => !tags.includes(t));
+        return this.updateTicket(ticketId, { tags: newTags });
+    }
+    async getTicketComments(ticketId) {
+        const response = await this.request(`/tickets/${ticketId}/comments.json`);
+        return response.comments;
+    }
+    async searchTickets(query) {
+        const searchParams = new URLSearchParams({ query: `type:ticket ${query}` });
+        const response = await this.request(`/search.json?${searchParams}`);
+        return response.results;
+    }
+    // =========================================================================
+    // ATTACHMENTS
+    // =========================================================================
+    async getTicketAttachments(ticketId) {
+        const comments = await this.getTicketComments(ticketId);
+        const attachments = [];
+        for (const comment of comments) {
+            if (comment.attachments) {
+                attachments.push(...comment.attachments);
+            }
+        }
+        return attachments;
+    }
+    async downloadAttachment(contentUrl) {
+        const auth = Buffer.from(`${this.config.EMAIL}/token:${this.config.API_TOKEN}`).toString('base64');
+        const response = await fetch(contentUrl, {
+            headers: { 'Authorization': `Basic ${auth}` },
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to download attachment: ${response.status}`);
+        }
+        return response.arrayBuffer();
+    }
+    // =========================================================================
+    // USERS
+    // =========================================================================
+    async getUser(userId) {
+        const response = await this.request(`/users/${userId}.json`);
+        return response.user;
+    }
+    async searchUsers(query) {
+        const searchParams = new URLSearchParams({ query });
+        const response = await this.request(`/users/search.json?${searchParams}`);
+        return response.users;
+    }
+    async getUserTickets(userId) {
+        const response = await this.request(`/users/${userId}/tickets/requested.json`);
+        return response.tickets;
+    }
+    // =========================================================================
+    // MACROS (Templates)
+    // =========================================================================
+    async listMacros(params) {
+        const query = new URLSearchParams();
+        if (params?.active !== undefined)
+            query.set('active', String(params.active));
+        if (params?.category)
+            query.set('category', String(params.category));
+        const endpoint = `/macros.json${query.toString() ? `?${query}` : ''}`;
+        const response = await this.request(endpoint);
+        return response.macros;
+    }
+    async getMacro(macroId) {
+        const response = await this.request(`/macros/${macroId}.json`);
+        return response.macro;
+    }
+    async applyMacro(ticketId, macroId) {
+        // Get macro to extract its actions
+        const macro = await this.getMacro(macroId);
+        // Build update from macro actions
+        const update = {};
+        for (const action of macro.actions) {
+            if (action.field === 'comment_value' || action.field === 'comment_value_html') {
+                update.comment = { body: String(action.value), public: true };
+            }
+            else if (action.field === 'status') {
+                update.status = String(action.value);
+            }
+            else if (action.field === 'priority') {
+                update.priority = String(action.value);
+            }
+        }
+        return this.updateTicket(ticketId, update);
+    }
+}
+export default ZendeskClient;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simonfestl/husky-cli",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "CLI for Huskyv0 Task Orchestration with Claude Agent SDK",
   "type": "module",
   "bin": {
@@ -42,4 +42,4 @@
   "bugs": {
     "url": "https://github.com/simon-sfxecom/huskyv0/issues"
   }
-}
+}