@farazirfan/costar-server-executor 1.7.37 → 1.7.39

package/dist/tools/whatsapp.js

@@ -0,0 +1,215 @@
+/**
+ * CoStar Server Executor - WhatsApp Tool
+ *
+ * Send and receive WhatsApp messages via Asterizk API.
+ * All operations go through POST /email/whatsapp/manage.
+ * Uses draft-then-send pattern: draft message → get draft_id → send draft.
+ *
+ * Operations: send_message, send_media, get_messages, get_messages_by_contact,
+ *             get_groups, get_contacts
+ */
+import { Type } from "@sinclair/typebox";
+import { jsonResult, readStringParam, readNumberParam, readBooleanParam } from "../utils/tool-helpers.js";
+import { asterizkFetch, handleAsterizkApiError } from "../utils/asterizk-auth.js";
+const WhatsAppSchema = Type.Object({
+    operation: Type.Union([
+        Type.Literal("send_message"),
+        Type.Literal("send_media"),
+        Type.Literal("get_messages"),
+        Type.Literal("get_messages_by_contact"),
+        Type.Literal("get_groups"),
+        Type.Literal("get_contacts"),
+    ], {
+        description: "Operation: send_message (text), send_media (image/video/doc), get_messages (recent inbox), get_messages_by_contact (chat history), get_groups (list groups), get_contacts (list contacts)",
+    }),
+    phone_number: Type.Optional(Type.String({
+        description: "Recipient phone number (digits only or with +). Required for send_message, send_media.",
+    })),
+    message: Type.Optional(Type.String({ description: "Text message to send. Required for send_message." })),
+    group_jid: Type.Optional(Type.String({
+        description: "WhatsApp group JID to send to (instead of phone_number). Optional for send_message, send_media.",
+    })),
+    media_url: Type.Optional(Type.String({ description: "URL of media file to send. Required for send_media." })),
+    media_type: Type.Optional(Type.Union([
+        Type.Literal("image"),
+        Type.Literal("video"),
+        Type.Literal("audio"),
+        Type.Literal("document"),
+    ], { description: "Type of media. Required for send_media." })),
+    caption: Type.Optional(Type.String({ description: "Caption for media message. Optional for send_media." })),
+    contact_jid: Type.Optional(Type.String({
+        description: "WhatsApp JID of contact (e.g., 1234567890@s.whatsapp.net). Required for get_messages_by_contact.",
+    })),
+    limit: Type.Optional(Type.Number({ description: "Number of messages to retrieve. Default: 50." })),
+    unread_only: Type.Optional(Type.Boolean({ description: "Only return unread messages. Default: false." })),
+    from_datetime: Type.Optional(Type.String({ description: "Filter messages from this datetime (ISO 8601). Optional." })),
+});
+/**
+ * Get the WhatsApp device ID from environment
+ */
+function getDeviceId() {
+    const deviceId = process.env.WHATSAPP_DEVICE_ID;
+    if (!deviceId) {
+        throw new Error("WHATSAPP_DEVICE_ID environment variable is required for WhatsApp operations");
+    }
+    return deviceId;
+}
+/**
+ * WhatsApp manage endpoint call
+ */
+async function whatsappManage(body) {
+    const response = await asterizkFetch("/email/whatsapp/manage", { body });
+    if (!response.ok) {
+        const errText = await response.text();
+        throw new Error(`WhatsApp API error (${response.status}): ${errText}`);
+    }
+    return response.json();
+}
+/**
+ * Draft a message, then immediately send it.
+ * Returns the combined result.
+ */
+async function draftAndSend(draftBody) {
+    // Step 1: Draft
+    const draftResult = await whatsappManage(draftBody);
+    const draftId = draftResult.draft_id;
+    if (!draftId) {
+        // Some API versions auto-send — return whatever we got
+        return draftResult;
+    }
+    // Step 2: Send the draft
+    const sendResult = await whatsappManage({
+        operation: "send_whatsapp_draft",
+        device_id: getDeviceId(),
+        draft_id: draftId,
+    });
+    return { draft_id: draftId, draft: draftResult, send: sendResult };
+}
+export function createWhatsAppTool() {
+    return {
+        name: "whatsapp",
+        label: "WhatsApp",
+        description: "Send and receive WhatsApp messages. Operations: send_message (text to a contact or group), send_media (image/video/audio/document), get_messages (recent inbox), get_messages_by_contact (chat with specific person), get_groups (list groups), get_contacts (list WhatsApp contacts). Always search contacts first to get the correct phone number or JID.",
+        parameters: WhatsAppSchema,
+        execute: async (_toolCallId, params) => {
+            const operation = readStringParam(params, "operation", { required: true });
+            try {
+                const deviceId = getDeviceId();
+                switch (operation) {
+                    case "send_message": {
+                        const phoneNumber = readStringParam(params, "phone_number");
+                        const groupJid = readStringParam(params, "group_jid");
+                        const message = readStringParam(params, "message", { required: true });
+                        if (!phoneNumber && !groupJid) {
+                            return jsonResult({
+                                error: "missing_recipient",
+                                message: "Provide either phone_number or group_jid",
+                            });
+                        }
+                        console.log(`[WHATSAPP] Sending message to ${phoneNumber || groupJid}`);
+                        const result = await draftAndSend({
+                            operation: "draft_whatsapp_message",
+                            device_id: deviceId,
+                            to: phoneNumber || "",
+                            message,
+                            group_jid: groupJid || null,
+                        });
+                        return jsonResult({
+                            status: "sent",
+                            to: phoneNumber || groupJid,
+                            message_preview: message.slice(0, 100),
+                            ...result,
+                        });
+                    }
+                    case "send_media": {
+                        const phoneNumber = readStringParam(params, "phone_number");
+                        const groupJid = readStringParam(params, "group_jid");
+                        const mediaUrl = readStringParam(params, "media_url", { required: true });
+                        const mediaType = readStringParam(params, "media_type", { required: true });
+                        const caption = readStringParam(params, "caption") || "";
+                        if (!phoneNumber && !groupJid) {
+                            return jsonResult({
+                                error: "missing_recipient",
+                                message: "Provide either phone_number or group_jid",
+                            });
+                        }
+                        console.log(`[WHATSAPP] Sending ${mediaType} to ${phoneNumber || groupJid}`);
+                        const result = await draftAndSend({
+                            operation: "draft_whatsapp_message_with_media",
+                            device_id: deviceId,
+                            to: phoneNumber || "",
+                            group_jid: groupJid || null,
+                            media_type: mediaType,
+                            file_url: mediaUrl,
+                            caption,
+                        });
+                        return jsonResult({
+                            status: "sent",
+                            to: phoneNumber || groupJid,
+                            media_type: mediaType,
+                            ...result,
+                        });
+                    }
+                    case "get_messages": {
+                        const limit = readNumberParam(params, "limit") || 50;
+                        const unreadOnly = readBooleanParam(params, "unread_only", false);
+                        const fromDatetime = readStringParam(params, "from_datetime");
+                        console.log(`[WHATSAPP] Getting messages (limit: ${limit}, unread: ${unreadOnly})`);
+                        const data = await whatsappManage({
+                            operation: "retrieve_messages",
+                            device_id: deviceId,
+                            limit,
+                            skip: 0,
+                            unread_only: unreadOnly,
+                            from_datetime: fromDatetime || null,
+                            to_datetime: null,
+                        });
+                        return jsonResult(data);
+                    }
+                    case "get_messages_by_contact": {
+                        const contactJid = readStringParam(params, "contact_jid", { required: true });
+                        const limit = readNumberParam(params, "limit") || 50;
+                        const fromDatetime = readStringParam(params, "from_datetime");
+                        console.log(`[WHATSAPP] Getting messages for contact ${contactJid} (limit: ${limit})`);
+                        const data = await whatsappManage({
+                            operation: "retrieve_msgs_by_contact",
+                            device_id: deviceId,
+                            remote_jid: contactJid,
+                            limit,
+                            skip: 0,
+                            from_datetime: fromDatetime || null,
+                            to_datetime: null,
+                        });
+                        return jsonResult(data);
+                    }
+                    case "get_groups": {
+                        console.log(`[WHATSAPP] Getting groups`);
+                        const data = await whatsappManage({
+                            operation: "get_groups",
+                            device_id: deviceId,
+                        });
+                        return jsonResult(data);
+                    }
+                    case "get_contacts": {
+                        console.log(`[WHATSAPP] Getting contacts`);
+                        const data = await whatsappManage({
+                            operation: "retrieve_contacts",
+                            device_id: deviceId,
+                        });
+                        return jsonResult(data);
+                    }
+                    default:
+                        return jsonResult({
+                            error: "invalid_operation",
+                            message: `Unknown operation: ${operation}. Use: send_message, send_media, get_messages, get_messages_by_contact, get_groups, get_contacts`,
+                        });
+                }
+            }
+            catch (error) {
+                console.error(`[WHATSAPP] Error (${operation}):`, error);
+                return jsonResult(handleAsterizkApiError(error, operation));
+            }
+        },
+    };
+}
+//# sourceMappingURL=whatsapp.js.map

package/dist/tools/whatsapp.js.map

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

package/dist/tools/youtube.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CoStar Server Executor - YouTube Tool
+ *
+ * Search YouTube videos, get details, and fetch transcripts.
+ * Uses YouTube Data API v3 for search/details.
+ * Uses youtube_transcript_api Python package for transcripts (installed on server).
+ *
+ * Requires: YOUTUBE_API_KEY env var.
+ */
+import type { AnyAgentTool } from "../types/tool.js";
+export declare function createYouTubeTool(): AnyAgentTool;
+//# sourceMappingURL=youtube.d.ts.map

package/dist/tools/youtube.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube.d.ts","sourceRoot":"","sources":["../../src/tools/youtube.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA+ErD,wBAAgB,iBAAiB,IAAI,YAAY,CAyKhD"}

package/dist/tools/youtube.js

@@ -0,0 +1,218 @@
+/**
+ * CoStar Server Executor - YouTube Tool
+ *
+ * Search YouTube videos, get details, and fetch transcripts.
+ * Uses YouTube Data API v3 for search/details.
+ * Uses youtube_transcript_api Python package for transcripts (installed on server).
+ *
+ * Requires: YOUTUBE_API_KEY env var.
+ */
+import { Type } from "@sinclair/typebox";
+import { execSync } from "child_process";
+import { jsonResult, readStringParam, readNumberParam } from "../utils/tool-helpers.js";
+const YouTubeSchema = Type.Object({
+    operation: Type.Union([
+        Type.Literal("search"),
+        Type.Literal("get_video"),
+        Type.Literal("get_transcript"),
+    ], {
+        description: "Operation: search (find videos), get_video (video details — views, likes, description), get_transcript (fetch video transcript/subtitles)",
+    }),
+    query: Type.Optional(Type.String({ description: "Search query. Required for search." })),
+    video_id: Type.Optional(Type.String({
+        description: "YouTube video ID (the part after v= in the URL). Required for get_video and get_transcript.",
+    })),
+    limit: Type.Optional(Type.Number({ description: "Number of search results. Default: 10. Max: 50. Used with search." })),
+    language: Type.Optional(Type.String({ description: "Transcript language code (e.g., 'en', 'es'). Default: 'en'. Used with get_transcript." })),
+});
+function getApiKey() {
+    const key = process.env.YOUTUBE_API_KEY;
+    if (!key) {
+        throw new Error("YOUTUBE_API_KEY environment variable is required");
+    }
+    return key;
+}
+/**
+ * Call YouTube Data API v3
+ */
+async function youtubeApi(path, params) {
+    const apiKey = getApiKey();
+    const queryParams = new URLSearchParams({ ...params, key: apiKey });
+    const response = await fetch(`https://www.googleapis.com/youtube/v3${path}?${queryParams.toString()}`);
+    if (!response.ok) {
+        const errText = await response.text();
+        throw new Error(`YouTube API error (${response.status}): ${errText}`);
+    }
+    return response.json();
+}
+/**
+ * Format ISO 8601 duration (PT1H2M3S) to human readable
+ */
+function formatDuration(iso) {
+    const match = iso.match(/PT(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?/);
+    if (!match)
+        return iso;
+    const h = match[1] ? `${match[1]}h ` : "";
+    const m = match[2] ? `${match[2]}m ` : "";
+    const s = match[3] ? `${match[3]}s` : "";
+    return (h + m + s).trim() || "0s";
+}
+/**
+ * Format large numbers (1234567 → 1.2M)
+ */
+function formatCount(n) {
+    if (n >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(1)}M`;
+    if (n >= 1_000)
+        return `${(n / 1_000).toFixed(1)}K`;
+    return String(n);
+}
+export function createYouTubeTool() {
+    return {
+        name: "youtube",
+        label: "YouTube",
+        description: "Search YouTube videos, get video details (views, likes, description), and fetch transcripts/subtitles. Use for finding videos, summarizing video content, or researching topics via video. Requires YOUTUBE_API_KEY env var.",
+        parameters: YouTubeSchema,
+        execute: async (_toolCallId, params) => {
+            const operation = readStringParam(params, "operation", { required: true });
+            try {
+                switch (operation) {
+                    case "search": {
+                        const query = readStringParam(params, "query", { required: true });
+                        const limit = readNumberParam(params, "limit") || 10;
+                        console.log(`[YOUTUBE] Searching: "${query}" (limit: ${limit})`);
+                        const data = await youtubeApi("/search", {
+                            part: "snippet",
+                            q: query,
+                            type: "video",
+                            maxResults: String(limit),
+                            order: "relevance",
+                        });
+                        const items = (data.items || []);
+                        const results = items.map((item) => {
+                            const snippet = item.snippet;
+                            const id = item.id;
+                            return {
+                                video_id: id?.videoId,
+                                title: snippet?.title,
+                                channel: snippet?.channelTitle,
+                                description: (snippet?.description || "").slice(0, 200),
+                                published_at: snippet?.publishedAt,
+                                url: `https://www.youtube.com/watch?v=${id?.videoId}`,
+                            };
+                        });
+                        return jsonResult({ query, count: results.length, results });
+                    }
+                    case "get_video": {
+                        const videoId = readStringParam(params, "video_id", { required: true });
+                        console.log(`[YOUTUBE] Getting video details: ${videoId}`);
+                        const data = await youtubeApi("/videos", {
+                            part: "snippet,statistics,contentDetails",
+                            id: videoId,
+                        });
+                        const items = (data.items || []);
+                        if (items.length === 0) {
+                            return jsonResult({ error: "not_found", message: `Video ${videoId} not found` });
+                        }
+                        const item = items[0];
+                        const snippet = item.snippet;
+                        const stats = item.statistics;
+                        const details = item.contentDetails;
+                        return jsonResult({
+                            video_id: videoId,
+                            title: snippet?.title,
+                            channel: snippet?.channelTitle,
+                            description: snippet?.description,
+                            published_at: snippet?.publishedAt,
+                            duration: formatDuration(details?.duration || ""),
+                            views: formatCount(Number(stats?.viewCount) || 0),
+                            likes: formatCount(Number(stats?.likeCount) || 0),
+                            comments: formatCount(Number(stats?.commentCount) || 0),
+                            tags: (snippet?.tags || []).slice(0, 10),
+                            url: `https://www.youtube.com/watch?v=${videoId}`,
+                        });
+                    }
+                    case "get_transcript": {
+                        const videoId = readStringParam(params, "video_id", { required: true });
+                        const language = readStringParam(params, "language") || "en";
+                        console.log(`[YOUTUBE] Getting transcript: ${videoId} (lang: ${language})`);
+                        try {
+                            // Use youtube_transcript_api Python package via shell
+                            const cmd = `python3 -c "
+import json
+from youtube_transcript_api import YouTubeTranscriptApi
+try:
+    transcript = YouTubeTranscriptApi.get_transcript('${videoId}', languages=['${language}', 'en'])
+    print(json.dumps(transcript))
+except Exception as e:
+    print(json.dumps({'error': str(e)}))
+"`;
+                            const output = execSync(cmd, {
+                                encoding: "utf-8",
+                                timeout: 30_000,
+                            }).trim();
+                            const parsed = JSON.parse(output);
+                            if (parsed.error) {
+                                return jsonResult({
+                                    video_id: videoId,
+                                    error: "transcript_unavailable",
+                                    message: parsed.error,
+                                });
+                            }
+                            // Combine transcript segments into readable text
+                            const segments = parsed;
+                            const fullText = segments.map((s) => s.text).join(" ");
+                            // Also include timestamped segments (first 100 for context window)
+                            const timestamped = segments.slice(0, 100).map((s) => {
+                                const mins = Math.floor(s.start / 60);
+                                const secs = Math.floor(s.start % 60);
+                                return `[${mins}:${secs.toString().padStart(2, "0")}] ${s.text}`;
+                            });
+                            return jsonResult({
+                                video_id: videoId,
+                                language,
+                                segment_count: segments.length,
+                                full_text: fullText,
+                                timestamped: timestamped,
+                                url: `https://www.youtube.com/watch?v=${videoId}`,
+                            });
+                        }
+                        catch (execError) {
+                            const msg = execError instanceof Error ? execError.message : String(execError);
+                            // Fallback: python package might not be installed
+                            if (msg.includes("ModuleNotFoundError") || msg.includes("No module")) {
+                                return jsonResult({
+                                    video_id: videoId,
+                                    error: "transcript_unavailable",
+                                    message: "youtube_transcript_api package not installed. Install with: pip install youtube_transcript_api",
+                                });
+                            }
+                            return jsonResult({
+                                video_id: videoId,
+                                error: "transcript_failed",
+                                message: msg,
+                            });
+                        }
+                    }
+                    default:
+                        return jsonResult({
+                            error: "invalid_operation",
+                            message: `Unknown operation: ${operation}. Use: search, get_video, get_transcript`,
+                        });
+                }
+            }
+            catch (error) {
+                console.error(`[YOUTUBE] Error (${operation}):`, error);
+                const msg = error instanceof Error ? error.message : String(error);
+                if (msg.includes("YOUTUBE_API_KEY")) {
+                    return jsonResult({
+                        error: "not_configured",
+                        message: "YouTube is not configured. YOUTUBE_API_KEY is required.",
+                    });
+                }
+                return jsonResult({ error: `${operation}_failed`, message: msg });
+            }
+        },
+    };
+}
+//# sourceMappingURL=youtube.js.map

package/dist/tools/youtube.js.map

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

package/dist/utils/asterizk-auth.d.ts

@@ -0,0 +1,43 @@
+/**
+ * CoStar Server Executor - Asterizk API Auth Utility
+ *
+ * Shared utility for authenticating with the Asterizk API (api-dev.asterizk.ai).
+ * Used by phone call, WhatsApp, and contacts tools.
+ *
+ * Flow:
+ * 1. Get USER_ID from env
+ * 2. Fetch JWT from /email/auth/tokens/{userId} (same endpoint as google-oauth.ts)
+ * 3. Use JWT as X-Samantha-JWT header for all Asterizk API calls
+ */
+/**
+ * Get user ID from environment variable
+ */
+export declare function getUserId(): string;
+/**
+ * Get user email from environment variable
+ */
+export declare function getUserEmail(): string;
+/**
+ * Get the Asterizk API base URL
+ */
+export declare function getAsterizkApiUrl(): string;
+/**
+ * Get authenticated headers for Asterizk API calls
+ */
+export declare function getAsterizkHeaders(): Promise<Record<string, string>>;
+/**
+ * Make an authenticated fetch to the Asterizk API
+ */
+export declare function asterizkFetch(path: string, options?: {
+    method?: string;
+    body?: unknown;
+    timeoutMs?: number;
+}): Promise<Response>;
+/**
+ * Handle Asterizk API errors with user-friendly messages
+ */
+export declare function handleAsterizkApiError(error: unknown, operation: string): {
+    error: string;
+    message: string;
+};
+//# sourceMappingURL=asterizk-auth.d.ts.map

package/dist/utils/asterizk-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asterizk-auth.d.ts","sourceRoot":"","sources":["../../src/utils/asterizk-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAgCD;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQ1E;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,QAAQ,CAAC,CAoBnB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAmCpC"}

package/dist/utils/asterizk-auth.js

@@ -0,0 +1,125 @@
+/**
+ * CoStar Server Executor - Asterizk API Auth Utility
+ *
+ * Shared utility for authenticating with the Asterizk API (api-dev.asterizk.ai).
+ * Used by phone call, WhatsApp, and contacts tools.
+ *
+ * Flow:
+ * 1. Get USER_ID from env
+ * 2. Fetch JWT from /email/auth/tokens/{userId} (same endpoint as google-oauth.ts)
+ * 3. Use JWT as X-Samantha-JWT header for all Asterizk API calls
+ */
+/**
+ * Get user ID from environment variable
+ */
+export function getUserId() {
+    return process.env.USER_ID || "default";
+}
+/**
+ * Get user email from environment variable
+ */
+export function getUserEmail() {
+    const email = process.env.USER_EMAIL;
+    if (!email) {
+        throw new Error("USER_EMAIL environment variable is required");
+    }
+    return email;
+}
+/**
+ * Get the Asterizk API base URL
+ */
+export function getAsterizkApiUrl() {
+    return process.env.ASTERIZK_API_URL || "https://api-dev.asterizk.ai";
+}
+/**
+ * Fetch Samantha JWT for a user.
+ * Uses the same /email/auth/tokens/{userId} endpoint as google-oauth.ts.
+ * The access_token in the response IS the Samantha JWT.
+ */
+async function getSamanthaJwt(userId) {
+    const apiUrl = getAsterizkApiUrl();
+    const response = await fetch(`${apiUrl}/email/auth/tokens/${userId}`, {
+        method: "GET",
+        headers: { "Content-Type": "application/json" },
+    });
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new Error(`No auth tokens found for user ${userId}. Please login in the app.`);
+        }
+        throw new Error(`Failed to fetch auth tokens: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    const jwt = data.access_token || data.google_access_token;
+    if (!jwt) {
+        throw new Error(`No access token in auth response for user ${userId}`);
+    }
+    return jwt;
+}
+/**
+ * Get authenticated headers for Asterizk API calls
+ */
+export async function getAsterizkHeaders() {
+    const userId = getUserId();
+    const jwt = await getSamanthaJwt(userId);
+    return {
+        "Content-Type": "application/json",
+        "X-Samantha-JWT": jwt,
+    };
+}
+/**
+ * Make an authenticated fetch to the Asterizk API
+ */
+export async function asterizkFetch(path, options = {}) {
+    const apiUrl = getAsterizkApiUrl();
+    const headers = await getAsterizkHeaders();
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(`${apiUrl}${path}`, {
+            method: options.method || "POST",
+            headers,
+            body: options.body ? JSON.stringify(options.body) : undefined,
+            signal: controller.signal,
+        });
+        return response;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Handle Asterizk API errors with user-friendly messages
+ */
+export function handleAsterizkApiError(error, operation) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message.includes("abort") || message.includes("timeout")) {
+        return {
+            error: "timeout",
+            message: `Request timed out while ${operation}. The server may be slow — please try again.`,
+        };
+    }
+    if (message.includes("No auth tokens") || message.includes("401")) {
+        return {
+            error: "not_authenticated",
+            message: "Authentication expired. Please re-login in the app.",
+        };
+    }
+    if (message.includes("404")) {
+        return {
+            error: "not_found",
+            message: `Resource not found while ${operation}.`,
+        };
+    }
+    if (message.includes("ECONNREFUSED") || message.includes("fetch failed")) {
+        return {
+            error: "connection_failed",
+            message: "Cannot reach the API server. It may be temporarily unavailable.",
+        };
+    }
+    return {
+        error: `${operation}_failed`,
+        message,
+    };
+}
+//# sourceMappingURL=asterizk-auth.js.map

package/dist/utils/asterizk-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asterizk-auth.js","sourceRoot":"","sources":["../../src/utils/asterizk-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACrC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,6BAA6B,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,cAAc,CAAC,MAAc;IAC1C,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IAEnC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,sBAAsB,MAAM,EAAE,EAAE;QACpE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;KAChD,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,4BAA4B,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,mBAAmB,CAAC;IAE1D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,6CAA6C,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAEzC,OAAO;QACL,cAAc,EAAE,kBAAkB;QAClC,gBAAgB,EAAE,GAAG;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,UAII,EAAE;IAEN,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAE9C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAE9D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,EAAE;YAC/C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,MAAM;YAChC,OAAO;YACP,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;YAC7D,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAc,EACd,SAAiB;IAEjB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEvE,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7D,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,2BAA2B,SAAS,8CAA8C;SAC5F,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO;YACL,KAAK,EAAE,mBAAmB;YAC1B,OAAO,EAAE,qDAAqD;SAC/D,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,4BAA4B,SAAS,GAAG;SAClD,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACzE,OAAO;YACL,KAAK,EAAE,mBAAmB;YAC1B,OAAO,EAAE,iEAAiE;SAC3E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,GAAG,SAAS,SAAS;QAC5B,OAAO;KACR,CAAC;AACJ,CAAC"}