@pi-unipi/unipi 2.1.2 → 2.1.3

package/packages/notify/platforms/focus.ts

@@ -1,33 +0,0 @@
-/**
- * @pi-unipi/notify — Focus detection abstraction
- *
- * Unified interface for checking whether the terminal window is the
- * foreground (active) window. Platform-specific implementations are
- * dispatched based on process.platform.
- *
- * Currently implemented:
- *   - Windows (win32): calls focus-win.ts
- *
- * Unimplemented platforms always return false (no suppression).
- */
-
-import { isWindowFocusedOnWindows } from "./focus-win.js";
-
-/**
- * Check whether the current terminal/console window is the foreground
- * (active) window. Used by sendNativeNotification to optionally
- * suppress notifications when the user is already looking at the screen.
- *
- * @returns true if the terminal is the foreground window, false otherwise.
- *          On unimplemented platforms, always returns false.
- */
-export async function isWindowFocused(): Promise<boolean> {
-  switch (process.platform) {
-    case "win32":
-      return await isWindowFocusedOnWindows();
-    // TODO: macOS — use osascript to check frontmost application
-    // TODO: Linux — use xdotool (X11) or per-compositor tool (Wayland)
-    default:
-      return false;
-  }
-}

package/packages/notify/platforms/gotify.ts

@@ -1,36 +0,0 @@
-/**
- * @pi-unipi/notify — Gotify notification platform
- *
- * Sends push notifications to a Gotify server via HTTP POST.
- * Gotify is a self-hosted push notification server.
- */
-
-/** Send a notification to Gotify server */
-export async function sendGotifyNotification(
-  serverUrl: string,
-  appToken: string,
-  title: string,
-  message: string,
-  priority: number = 5
-): Promise<void> {
-  const url = serverUrl.replace(/\/$/, "") + "/message";
-  const response = await fetch(url, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      "X-Gotify-Key": appToken,
-    },
-    body: JSON.stringify({
-      title,
-      message,
-      priority,
-    }),
-  });
-
-  if (!response.ok) {
-    const body = await response.text().catch(() => "<no body>");
-    throw new Error(
-      `Gotify API error ${response.status}: ${body}`
-    );
-  }
-}

package/packages/notify/platforms/native.ts

@@ -1,79 +0,0 @@
-/**
- * @pi-unipi/notify — Native OS notification platform
- *
- * Wraps node-notifier for cross-platform desktop notifications.
- * Windows: SnoreToast (no admin required)
- * macOS: terminal-notifier
- * Linux: notify-send / libnotify
- */
-
-import notifier from "node-notifier";
-import { isWindowFocused } from "./focus.js";
-
-/** Options for native notification */
-export interface NativeNotificationOptions {
-  /** Windows appID to show instead of "SnoreToast" */
-  windowsAppId?: string;
-  /**
-   * When true, suppresses the notification if the terminal window is
-   * the foreground (active) window. Only effective on platforms where
-   * `isWindowFocused` is implemented (currently Windows).
-   */
-  suppressWhenFocused?: boolean;
-}
-
-/**
- * Thrown by sendNativeNotification when the notification was suppressed
- * because suppressWhenFocused is set and the terminal window is focused.
- *
- * Callers should catch this and treat it as intentional suppression,
- * NOT as a send failure.
- */
-export class SuppressedError extends Error {
-  constructor() {
-    super("Notification suppressed: terminal window is focused");
-    this.name = "SuppressedError";
-  }
-}
-
-/**
- * Send a native OS notification.
- *
- * When `suppressWhenFocused` is true and `isWindowFocused()` returns true
- * (i.e. the terminal is the foreground window), the notification is
- * suppressed and the promise rejects with SuppressedError.
- *
- * Resolves when notification is shown, rejects with SuppressedError on
- * suppression or with a standard Error on failure.
- */
-export async function sendNativeNotification(
-  title: string,
-  message: string,
-  options?: NativeNotificationOptions
-): Promise<void> {
-  // Suppress if the terminal window is currently focused
-  if (options?.suppressWhenFocused && await isWindowFocused()) {
-    throw new SuppressedError();
-  }
-
-  return new Promise((resolve, reject) => {
-    notifier.notify(
-      {
-        title,
-        message,
-        appID: options?.windowsAppId,
-      },
-      (err: Error | null) => {
-        if (err) {
-          reject(
-            new Error(
-              `Native notification failed: ${err.message}`
-            )
-          );
-        } else {
-          resolve();
-        }
-      }
-    );
-  });
-}

package/packages/notify/platforms/node-notifier.d.ts

@@ -1,20 +0,0 @@
-declare module "node-notifier" {
-  interface Notification {
-    title?: string;
-    message?: string;
-    appID?: string;
-    sound?: boolean | string;
-    icon?: string;
-    wait?: boolean;
-  }
-
-  interface Notifier {
-    notify(
-      notification: Notification,
-      callback: (err: Error | null, data: any) => void
-    ): void;
-  }
-
-  const notifier: Notifier;
-  export default notifier;
-}

package/packages/notify/platforms/ntfy.ts

@@ -1,48 +0,0 @@
-/**
- * @pi-unipi/notify — ntfy notification platform
- *
- * Sends push notifications to an ntfy server via HTTP POST.
- * ntfy is a simple HTTP-based pub-sub notification service.
- * Supports self-hosted instances and ntfy.sh (public).
- */
-
-/** Send a notification to an ntfy server */
-export async function sendNtfyNotification(
-  serverUrl: string,
-  topic: string,
-  title: string,
-  message: string,
-  priority: number = 3,
-  token?: string
-): Promise<void> {
-  // ntfy supports POSTing to the server root with a JSON body that carries
-  // topic/title/message/priority. JSON bodies are UTF-8 safe, unlike HTTP
-  // headers which must be ByteString (Latin-1) and reject characters like
-  // em dash (U+2014). See https://docs.ntfy.sh/publish/#publish-as-json
-  const url = serverUrl.replace(/\/$/, "");
-  const headers: Record<string, string> = {
-    "Content-Type": "application/json",
-  };
-
-  if (token) {
-    headers["Authorization"] = `Bearer ${token}`;
-  }
-
-  const body = JSON.stringify({
-    topic,
-    title,
-    message,
-    priority: Math.max(1, Math.min(5, priority)),
-  });
-
-  const response = await fetch(url, {
-    method: "POST",
-    headers,
-    body,
-  });
-
-  if (!response.ok) {
-    const resBody = await response.text().catch(() => "<no body>");
-    throw new Error(`ntfy API error ${response.status}: ${resBody}`);
-  }
-}

package/packages/notify/platforms/telegram.ts

@@ -1,77 +0,0 @@
-/**
- * @pi-unipi/notify — Telegram notification platform
- *
- * Sends notifications via Telegram Bot API.
- * Supports auto-detection of chat ID via polling getUpdates.
- */
-
-/** Send a notification via Telegram Bot API */
-export async function sendTelegramNotification(
-  botToken: string,
-  chatId: string,
-  title: string,
-  message: string
-): Promise<void> {
-  const text = `*${escapeMarkdown(title)}*\n${escapeMarkdown(message)}`;
-  const url = `https://api.telegram.org/bot${botToken}/sendMessage`;
-
-  const response = await fetch(url, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      chat_id: chatId,
-      text,
-      parse_mode: "MarkdownV2",
-    }),
-  });
-
-  if (!response.ok) {
-    const body = await response.text().catch(() => "<no body>");
-    throw new Error(
-      `Telegram API error ${response.status}: ${body}`
-    );
-  }
-}
-
-/**
- * Poll Telegram getUpdates to detect the chat ID from a user message.
- * Returns the chat ID string, or null if no message found.
- */
-export async function pollForChatId(
-  botToken: string,
-  signal?: AbortSignal
-): Promise<string | null> {
-  const url = `https://api.telegram.org/bot${botToken}/getUpdates?allowed_updates=["message"]`;
-
-  try {
-    const response = await fetch(url, { signal });
-    const data = (await response.json()) as {
-      ok: boolean;
-      result: Array<{
-        message?: { chat?: { id?: number } };
-        callback_query?: { message?: { chat?: { id?: number } } };
-      }>;
-    };
-
-    if (data.ok && data.result.length > 0) {
-      const lastUpdate = data.result[data.result.length - 1];
-      const chatId =
-        lastUpdate.message?.chat?.id ||
-        lastUpdate.callback_query?.message?.chat?.id;
-      if (chatId) {
-        return String(chatId);
-      }
-    }
-  } catch (err) {
-    if (signal?.aborted) throw err;
-    // Network error — return null to allow retry
-    return null;
-  }
-
-  return null;
-}
-
-/** Escape special MarkdownV2 characters */
-function escapeMarkdown(text: string): string {
-  return text.replace(/[_*\[\]()~`>#+\-=|{}.!\\]/g, "\\$&");
-}