@simonfestl/husky-cli 1.26.0 → 1.29.0

package/dist/lib/biz/resolved-tickets.js

@@ -0,0 +1,250 @@
+import { QdrantClient } from './qdrant.js';
+import { EmbeddingService } from './embeddings.js';
+import { v4 as uuidv4 } from 'uuid';
+// ============================================================================
+// Types
+// ============================================================================
+export const RESOLUTION_OUTCOMES = ['positive', 'negative', 'neutral', 'escalated'];
+// ============================================================================
+// Constants
+// ============================================================================
+const RESOLVED_COLLECTION = 'tickets_resolved';
+// ============================================================================
+// Resolved Tickets Service
+// ============================================================================
+export class ResolvedTicketsService {
+    qdrant;
+    embeddings;
+    constructor() {
+        this.qdrant = QdrantClient.fromConfig();
+        this.embeddings = EmbeddingService.fromConfig();
+    }
+    async log(input) {
+        const id = `rt_${input.ticket_id}_${uuidv4().slice(0, 6)}`;
+        const now = new Date().toISOString();
+        const ticket = {
+            id,
+            ticket_id: input.ticket_id,
+            problem: input.problem,
+            problem_category: input.problem_category,
+            resolution: {
+                outcome: input.outcome,
+                summary: input.summary,
+                steps: input.steps.map((s, i) => ({
+                    ...s,
+                    order: s.order || i + 1,
+                })),
+                sop_reference: input.sop_reference,
+            },
+            agent_id: input.agent_id,
+            files: input.files || [],
+            tags: input.tags || [],
+            created_at: now,
+            customer_satisfaction: input.customer_satisfaction,
+            metadata: input.metadata,
+        };
+        const embeddingText = this.buildEmbeddingText(ticket);
+        const vector = await this.embeddings.embed(embeddingText);
+        await this.qdrant.upsertOne(RESOLVED_COLLECTION, id, vector, {
+            type: 'resolved_ticket',
+            ...this.ticketToPayload(ticket),
+        });
+        return ticket;
+    }
+    async get(id) {
+        const point = await this.qdrant.getPoint(RESOLVED_COLLECTION, id);
+        if (!point || !point.payload)
+            return null;
+        const payload = point.payload;
+        if (payload.type !== 'resolved_ticket')
+            return null;
+        return this.payloadToTicket(payload);
+    }
+    async getByTicketId(ticketId) {
+        const results = await this.qdrant.scroll(RESOLVED_COLLECTION, {
+            filter: {
+                must: [
+                    { key: 'type', match: { value: 'resolved_ticket' } },
+                    { key: 'ticket_id', match: { value: ticketId } },
+                ],
+            },
+            limit: 1,
+            with_payload: true,
+        });
+        if (results.length === 0)
+            return null;
+        return this.payloadToTicket(results[0].payload);
+    }
+    async search(query, options = {}) {
+        const limit = options.limit || 5;
+        const minScore = options.minScore || 0.5;
+        const vector = await this.embeddings.embed(query);
+        const mustConditions = [
+            { key: 'type', match: { value: 'resolved_ticket' } }
+        ];
+        if (options.category) {
+            mustConditions.push({ key: 'problem_category', match: { value: options.category } });
+        }
+        if (options.outcome) {
+            mustConditions.push({ key: 'outcome', match: { value: options.outcome } });
+        }
+        const results = await this.qdrant.search(RESOLVED_COLLECTION, vector, limit, {
+            filter: { must: mustConditions },
+            scoreThreshold: minScore,
+        });
+        return results
+            .map(r => {
+            const ticket = this.payloadToTicket(r.payload);
+            if (!ticket)
+                return null;
+            return { ticket, score: r.score };
+        })
+            .filter((r) => r !== null);
+    }
+    async list(options = {}) {
+        const limit = options.limit || 50;
+        const mustConditions = [
+            { key: 'type', match: { value: 'resolved_ticket' } }
+        ];
+        if (options.category) {
+            mustConditions.push({ key: 'problem_category', match: { value: options.category } });
+        }
+        if (options.outcome) {
+            mustConditions.push({ key: 'outcome', match: { value: options.outcome } });
+        }
+        if (options.agent_id) {
+            mustConditions.push({ key: 'agent_id', match: { value: options.agent_id } });
+        }
+        const results = await this.qdrant.scroll(RESOLVED_COLLECTION, {
+            filter: { must: mustConditions },
+            limit,
+            with_payload: true,
+        });
+        return results
+            .map(r => this.payloadToTicket(r.payload))
+            .filter((t) => t !== null);
+    }
+    async findSimilarProblems(problem, options = {}) {
+        const searchOptions = {
+            limit: options.limit || 5,
+            minScore: options.minScore || 0.6,
+        };
+        if (options.onlyPositive) {
+            searchOptions.outcome = 'positive';
+        }
+        return this.search(problem, searchOptions);
+    }
+    async getCategories() {
+        const tickets = await this.list({ limit: 1000 });
+        const categoryMap = new Map();
+        for (const t of tickets) {
+            const count = categoryMap.get(t.problem_category) || 0;
+            categoryMap.set(t.problem_category, count + 1);
+        }
+        return Array.from(categoryMap.entries())
+            .map(([category, count]) => ({ category, count }))
+            .sort((a, b) => b.count - a.count);
+    }
+    async stats() {
+        const tickets = await this.list({ limit: 1000 });
+        const byOutcome = {
+            positive: 0,
+            negative: 0,
+            neutral: 0,
+            escalated: 0,
+        };
+        const byCategory = {};
+        let totalSteps = 0;
+        for (const t of tickets) {
+            byOutcome[t.resolution.outcome]++;
+            byCategory[t.problem_category] = (byCategory[t.problem_category] || 0) + 1;
+            totalSteps += t.resolution.steps.length;
+        }
+        return {
+            total: tickets.length,
+            byOutcome,
+            byCategory,
+            avgSteps: tickets.length > 0 ? totalSteps / tickets.length : 0,
+        };
+    }
+    async delete(id) {
+        await this.qdrant.deletePoints(RESOLVED_COLLECTION, [id]);
+    }
+    buildEmbeddingText(ticket) {
+        const stepsText = ticket.resolution.steps
+            .map(s => `${s.order}. ${s.action}: ${s.description}`)
+            .join('\n');
+        return [
+            `Problem: ${ticket.problem}`,
+            `Category: ${ticket.problem_category}`,
+            `Resolution: ${ticket.resolution.summary}`,
+            `Outcome: ${ticket.resolution.outcome}`,
+            `Steps:\n${stepsText}`,
+        ].join('\n');
+    }
+    ticketToPayload(ticket) {
+        return {
+            id: ticket.id,
+            ticket_id: ticket.ticket_id,
+            problem: ticket.problem,
+            problem_category: ticket.problem_category,
+            outcome: ticket.resolution.outcome,
+            summary: ticket.resolution.summary,
+            steps: JSON.stringify(ticket.resolution.steps),
+            sop_reference: ticket.resolution.sop_reference || null,
+            agent_id: ticket.agent_id,
+            files: ticket.files || [],
+            tags: ticket.tags,
+            created_at: ticket.created_at,
+            customer_satisfaction: ticket.customer_satisfaction ?? null,
+            metadata: ticket.metadata ? JSON.stringify(ticket.metadata) : null,
+        };
+    }
+    payloadToTicket(payload) {
+        if (!payload || payload.type !== 'resolved_ticket')
+            return null;
+        let steps = [];
+        try {
+            if (typeof payload.steps === 'string') {
+                steps = JSON.parse(payload.steps);
+            }
+            else if (Array.isArray(payload.steps)) {
+                steps = payload.steps;
+            }
+        }
+        catch {
+            steps = [];
+        }
+        let metadata;
+        try {
+            if (typeof payload.metadata === 'string') {
+                metadata = JSON.parse(payload.metadata);
+            }
+            else if (payload.metadata && typeof payload.metadata === 'object') {
+                metadata = payload.metadata;
+            }
+        }
+        catch {
+            metadata = undefined;
+        }
+        return {
+            id: String(payload.id),
+            ticket_id: Number(payload.ticket_id),
+            problem: String(payload.problem || ''),
+            problem_category: String(payload.problem_category || 'general'),
+            resolution: {
+                outcome: payload.outcome || 'neutral',
+                summary: String(payload.summary || ''),
+                steps,
+                sop_reference: payload.sop_reference ? String(payload.sop_reference) : undefined,
+            },
+            agent_id: String(payload.agent_id || ''),
+            files: payload.files || [],
+            tags: payload.tags || [],
+            created_at: String(payload.created_at || new Date().toISOString()),
+            customer_satisfaction: payload.customer_satisfaction ? Number(payload.customer_satisfaction) : undefined,
+            metadata,
+        };
+    }
+}
+export default ResolvedTicketsService;

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

@@ -0,0 +1,196 @@
+export interface ShopifyConfig {
+    shopDomain: string;
+    accessToken: string;
+    apiVersion?: string;
+}
+export interface Order {
+    id: string;
+    name: string;
+    email: string;
+    createdAt: Date;
+    updatedAt: Date;
+    fulfillmentStatus: string | null;
+    financialStatus: string;
+    totalPrice: string;
+    currency: string;
+    customer: Customer;
+    lineItems: LineItem[];
+    fulfillments: Fulfillment[];
+    shippingAddress?: Address;
+    billingAddress?: Address;
+    tags: string[];
+    note: string | null;
+}
+export interface Customer {
+    id: string;
+    email: string;
+    firstName: string | null;
+    lastName: string | null;
+    phone: string | null;
+    ordersCount: number;
+    totalSpent: string;
+    createdAt: Date;
+    updatedAt: Date;
+    tags: string[];
+    acceptsMarketing: boolean;
+    defaultAddress?: Address;
+}
+export interface Product {
+    id: string;
+    title: string;
+    handle: string;
+    descriptionHtml: string;
+    vendor: string;
+    productType: string;
+    status: 'ACTIVE' | 'ARCHIVED' | 'DRAFT';
+    tags: string[];
+    variants: ProductVariant[];
+    images: ProductImage[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface ProductVariant {
+    id: string;
+    title: string;
+    sku: string | null;
+    price: string;
+    compareAtPrice: string | null;
+    inventoryQuantity: number;
+    weight: number | null;
+    weightUnit: string;
+    barcode: string | null;
+}
+export interface ProductImage {
+    id: string;
+    url: string;
+    altText: string | null;
+    width: number;
+    height: number;
+}
+export interface LineItem {
+    id: string;
+    title: string;
+    quantity: number;
+    price: string;
+    sku: string | null;
+    variantId: string | null;
+    productId: string | null;
+}
+export interface Fulfillment {
+    id: string;
+    status: string;
+    createdAt: Date;
+    updatedAt: Date;
+    trackingCompany: string | null;
+    trackingNumber: string | null;
+    trackingUrl: string | null;
+}
+export interface Address {
+    address1: string | null;
+    address2: string | null;
+    city: string | null;
+    province: string | null;
+    country: string | null;
+    zip: string | null;
+    phone: string | null;
+    firstName: string | null;
+    lastName: string | null;
+    company: string | null;
+}
+export interface OrderQueryParams {
+    status?: 'any' | 'open' | 'closed' | 'cancelled';
+    fulfillmentStatus?: 'any' | 'shipped' | 'partial' | 'unshipped' | 'unfulfilled';
+    financialStatus?: 'any' | 'authorized' | 'pending' | 'paid' | 'partially_paid' | 'refunded' | 'voided' | 'partially_refunded';
+    createdAtMin?: Date;
+    createdAtMax?: Date;
+    updatedAtMin?: Date;
+    updatedAtMax?: Date;
+    limit?: number;
+    sinceId?: string;
+    ids?: string[];
+}
+export interface CustomerQueryParams {
+    email?: string;
+    phone?: string;
+    createdAtMin?: Date;
+    createdAtMax?: Date;
+    updatedAtMin?: Date;
+    updatedAtMax?: Date;
+    limit?: number;
+    sinceId?: string;
+    ids?: string[];
+    tags?: string[];
+}
+export interface ProductQueryParams {
+    status?: 'ACTIVE' | 'ARCHIVED' | 'DRAFT';
+    vendor?: string;
+    productType?: string;
+    createdAtMin?: Date;
+    createdAtMax?: Date;
+    updatedAtMin?: Date;
+    updatedAtMax?: Date;
+    limit?: number;
+    sinceId?: string;
+    ids?: string[];
+    handle?: string;
+}
+export interface ProductUpdate {
+    title?: string;
+    descriptionHtml?: string;
+    vendor?: string;
+    productType?: string;
+    status?: 'ACTIVE' | 'ARCHIVED' | 'DRAFT';
+    tags?: string[];
+}
+export interface ShopMetrics {
+    ordersToday: number;
+    revenueToday: number;
+    averageOrderValue: number;
+    newCustomersToday: number;
+    returningCustomersToday: number;
+    topProducts: Array<{
+        productId: string;
+        title: string;
+        quantity: number;
+        revenue: number;
+    }>;
+    currencyCode: string;
+}
+export interface DateRange {
+    start: Date;
+    end: Date;
+}
+export declare class ShopifyClient {
+    private shopDomain;
+    private accessToken;
+    private apiVersion;
+    private baseUrl;
+    constructor(config: ShopifyConfig);
+    static fromConfig(): ShopifyClient;
+    private request;
+    getOrders(params?: OrderQueryParams): Promise<Order[]>;
+    getOrder(id: string): Promise<Order>;
+    searchOrders(query: string, limit?: number): Promise<Order[]>;
+    getCustomers(params?: CustomerQueryParams): Promise<Customer[]>;
+    getCustomer(id: string): Promise<Customer>;
+    getCustomerOrderCount(customerId: string): Promise<number>;
+    getCustomerOrders(customerId: string, limit?: number): Promise<Order[]>;
+    searchCustomers(query: string): Promise<Customer[]>;
+    getProducts(params?: ProductQueryParams): Promise<Product[]>;
+    getProduct(id: string): Promise<Product>;
+    updateProduct(id: string, updates: ProductUpdate): Promise<Product>;
+    searchProducts(query: string): Promise<Product[]>;
+    getLowStockProducts(threshold?: number): Promise<Product[]>;
+    getShopMetrics(dateRange: DateRange): Promise<ShopMetrics>;
+    getDailyMetrics(): Promise<ShopMetrics>;
+    getWeeklyMetrics(): Promise<ShopMetrics>;
+    testConnection(): Promise<{
+        success: boolean;
+        shopName?: string;
+        error?: string;
+    }>;
+    private mapOrder;
+    private mapCustomer;
+    private mapProduct;
+}
+export default ShopifyClient;