fcemail 0.1.11

package/internal/display/logo.go

@@ -0,0 +1,242 @@
+package display
+
+import (
+	"fmt"
+	"strings"
+
+	"github.com/charmbracelet/lipgloss"
+)
+
+// ── Styles ────────────────────────────────────────────────────────────────────
+
+var (
+	// Adaptive colors for both light and dark terminals
+	colorDim    = lipgloss.AdaptiveColor{Light: "244", Dark: "240"}
+	colorBright = lipgloss.AdaptiveColor{Light: "235", Dark: "255"}
+	colorMuted  = lipgloss.AdaptiveColor{Light: "248", Dark: "245"}
+	colorAccent = lipgloss.AdaptiveColor{Light: "232", Dark: "255"}
+	colorBorder = lipgloss.AdaptiveColor{Light: "250", Dark: "238"}
+
+	styleDim     = lipgloss.NewStyle().Foreground(colorDim)
+	styleBright  = lipgloss.NewStyle().Foreground(colorBright).Bold(true)
+	styleMuted   = lipgloss.NewStyle().Foreground(colorMuted)
+	styleAccent  = lipgloss.NewStyle().Foreground(colorAccent).Bold(true)
+	styleBorder  = lipgloss.NewStyle().Foreground(colorBorder)
+	styleSuccess = lipgloss.NewStyle().Foreground(colorBright)
+	styleError   = lipgloss.NewStyle().Foreground(colorBright).Bold(true)
+	styleWarn    = lipgloss.NewStyle().Foreground(colorDim)
+
+	panelStyle = lipgloss.NewStyle().
+			Border(lipgloss.RoundedBorder()).
+			BorderForeground(colorBorder).
+			Padding(0, 2)
+)
+
+// ── Logo ──────────────────────────────────────────────────────────────────────
+
+// ASCII logo optimized for readability and Go raw string constraints
+// Using @@ as a placeholder for backticks
+const logoASCII = `
+    ______              ______           __                     ______                _ __
+   / ____/________ ___ / ____/_  _______/ /_____  ____ ___     / ____/___ ___  ____ _(_) /
+  / /_  / ___/ _ \/ _ \ /   / / / / ___/ __/ __ \/ __ @@__ \   / __/ / __ @@__ \/ __ @@/ / / 
+ / __/ / /  /  __/  __/ /___/ /_/ (__  ) /_/ /_/ / / / / / /  / /___/ / / / / / /_/ / / /  
+/_/   /_/   \___/\___/\____/\__,_/____/\__/\____/_/ /_/ /_/  /_____/_/ /_/ /_/\__,_/_/_/   
+`
+
+const tagline = `   FreeCustom.Email — disposable inbox API`
+
+// PrintLogo prints the full logo + wordmark on first login
+func PrintLogo() {
+	fixedLogo := strings.ReplaceAll(logoASCII, "@@", "`")
+	logo := styleBright.Render(fixedLogo)
+	tag := styleMuted.Render(tagline)
+	fmt.Println(logo)
+	fmt.Println(tag)
+	fmt.Println()
+}
+
+// PrintInlineLogo prints a compact single-line logo for command headers
+func PrintInlineLogo() {
+	icon := styleBright.Render("◉")
+	name := styleBright.Render("fce")
+	fmt.Printf("%s %s  ", icon, name)
+}
+
+// ── Section headers ───────────────────────────────────────────────────────────
+
+func Header(title string) {
+	bar  := styleDim.Render(strings.Repeat("─", 48))
+	head := styleAccent.Render(title)
+	fmt.Println()
+	fmt.Println(bar)
+	fmt.Printf("  %s\n", head)
+	fmt.Println(bar)
+}
+
+// ── Status messages ───────────────────────────────────────────────────────────
+
+func Success(msg string) {
+	fmt.Printf("  %s  %s\n", styleBright.Render("✓"), styleSuccess.Render(msg))
+}
+
+func Error(msg string) {
+	fmt.Printf("  %s  %s\n", styleBright.Render("✗"), styleError.Render(msg))
+}
+
+func Warn(msg string) {
+	fmt.Printf("  %s  %s\n", styleBright.Render("!"), styleWarn.Render(msg))
+}
+
+func Info(msg string) {
+	fmt.Printf("  %s  %s\n", styleDim.Render("·"), styleMuted.Render(msg))
+}
+
+func Step(n int, total int, msg string) {
+	counter := styleDim.Render(fmt.Sprintf("[%d/%d]", n, total))
+	fmt.Printf("  %s  %s\n", counter, styleMuted.Render(msg))
+}
+
+// ── Tables ────────────────────────────────────────────────────────────────────
+
+type Row struct {
+	Key   string
+	Value string
+}
+
+func Table(rows []Row) {
+	maxKey := 0
+	for _, r := range rows {
+		if len(r.Key) > maxKey {
+			maxKey = len(r.Key)
+		}
+	}
+	fmt.Println()
+	for _, r := range rows {
+		pad   := strings.Repeat(" ", maxKey-len(r.Key)+2)
+		key   := styleDim.Render(r.Key)
+		sep   := styleBorder.Render("·")
+		value := styleBright.Render(r.Value)
+		fmt.Printf("  %s%s%s  %s\n", key, pad, sep, value)
+	}
+	fmt.Println()
+}
+
+// ── List ──────────────────────────────────────────────────────────────────────
+
+func List(items []string) {
+	fmt.Println()
+	for i, item := range items {
+		n   := styleDim.Render(fmt.Sprintf("%02d", i+1))
+		dot := styleBorder.Render("·")
+		fmt.Printf("  %s %s %s\n", n, dot, styleBright.Render(item))
+	}
+	fmt.Println()
+}
+
+// ── Plan badge ────────────────────────────────────────────────────────────────
+
+func PlanBadge(plan string) string {
+	p := strings.ToLower(plan)
+	if p == "free" || p == "developer" {
+		return styleDim.Render("[" + strings.ToUpper(plan) + "]")
+	}
+
+	// High visibility solid badge for paid plans
+	return lipgloss.NewStyle().
+		Foreground(lipgloss.AdaptiveColor{Light: "255", Dark: "0"}).
+		Background(lipgloss.AdaptiveColor{Light: "235", Dark: "255"}).
+		Padding(0, 1).
+		Bold(true).
+		Render(strings.ToUpper(plan))
+}
+
+// ── Live event (for watch) ────────────────────────────────────────────────────
+
+func EmailEvent(id, from, subject, otp, link string, timestamp string) {
+	div   := styleDim.Render(strings.Repeat("─", 52))
+	fmt.Println()
+	fmt.Println(div)
+	fmt.Printf("  %s  %s\n", styleDim.Render("ID  "), styleDim.Render(id))
+	fmt.Printf("  %s  %s\n", styleDim.Render("FROM"), styleBright.Render(from))
+	fmt.Printf("  %s  %s\n", styleDim.Render("SUBJ"), styleMuted.Render(subject))
+	fmt.Printf("  %s  %s\n", styleDim.Render("TIME"), styleDim.Render(timestamp))
+	if otp != "" {
+		otpVal := styleAccent.Render(otp)
+		fmt.Printf("  %s  %s\n", styleBright.Render("OTP "), otpVal)
+	}
+	if link != "" {
+		button := lipgloss.NewStyle().
+			Foreground(lipgloss.AdaptiveColor{Light: "255", Dark: "0"}).
+			Background(lipgloss.AdaptiveColor{Light: "235", Dark: "255"}).
+			Padding(0, 1).
+			Bold(true).
+			Render("OPEN EMAIL")
+		fmt.Printf("\n  %s  %s\n", button, styleDim.Render(link))
+	}
+	fmt.Println(div)
+	fmt.Println()
+}
+
+func MessageContent(data map[string]interface{}) {
+	from    := fmt.Sprintf("%v", data["from"])
+	subject := fmt.Sprintf("%v", data["subject"])
+	date    := fmt.Sprintf("%v", data["date"])
+	text    := fmt.Sprintf("%v", data["text"])
+	body    := fmt.Sprintf("%v", data["body"])
+	html    := fmt.Sprintf("%v", data["html"])
+
+	Header("Message Details")
+	Table([]Row{
+		{Key: "From",    Value: from},
+		{Key: "Subject", Value: subject},
+		{Key: "Date",    Value: date},
+	})
+
+	if text != "" && text != "<nil>" {
+		fmt.Println("\n" + styleDim.Render("── Text Content ──────────────────────────────────────────────"))
+		fmt.Println(text)
+	} else if body != "" && body != "<nil>" {
+		fmt.Println("\n" + styleDim.Render("── Body ──────────────────────────────────────────────────────"))
+		fmt.Println(body)
+	} else if html != "" && html != "<nil>" {
+		fmt.Println("\n" + styleDim.Render("── HTML (Source) ─────────────────────────────────────────────"))
+		fmt.Println(html)
+	}
+	fmt.Println()
+}
+
+// ── Waiting spinner (simple) ──────────────────────────────────────────────────
+
+func Waiting(msg string) {
+	fmt.Printf("  %s  %s\n", styleDim.Render("◌"), styleMuted.Render(msg))
+}
+
+// ── Plan gate error ───────────────────────────────────────────────────────────
+
+func PlanGate(requiredPlan string, feature string) {
+	fmt.Println()
+	Error(fmt.Sprintf("%s requires %s plan or above.", feature, strings.Title(requiredPlan)))
+	Info("Upgrade at: https://www.freecustom.email/api/pricing")
+	fmt.Println()
+}
+
+// ── Divider ───────────────────────────────────────────────────────────────────
+
+func Divider() {
+	fmt.Println(styleDim.Render("  " + strings.Repeat("─", 48)))
+}
+
+// TableBadge returns a formatted string with a badge and value
+func TableBadge(label, value string) string {
+	badge := lipgloss.NewStyle().
+		Foreground(lipgloss.AdaptiveColor{Light: "255", Dark: "0"}).
+		Background(lipgloss.AdaptiveColor{Light: "244", Dark: "240"}).
+		Padding(0, 1).
+		Bold(true).
+		Width(10).
+		Align(lipgloss.Center).
+		Render(strings.ToUpper(label))
+
+	return fmt.Sprintf("  %s  %s", badge, styleBright.Render(value))
+}

package/internal/ws/watch.go

@@ -0,0 +1,144 @@
+package ws
+
+import (
+	"encoding/json"
+	"fmt"
+	"net/url"
+	"os"
+	"os/signal"
+	"syscall"
+	"time"
+
+	"github.com/DishIs/fce-cli/internal/display"
+	"github.com/gorilla/websocket"
+)
+
+const wsBaseURL = "wss://api2.freecustom.email/v1/ws"
+
+type emailEvent struct {
+	Type             string `json:"type"`
+	ID               string `json:"id"`
+	From             string `json:"from"`
+	To               string `json:"to"`
+	Subject          string `json:"subject"`
+	Date             string `json:"date"`
+	OTP              string `json:"otp"`
+	VerificationLink string `json:"verificationLink"`
+	HasAttachment    bool   `json:"hasAttachment"`
+	Plan             string `json:"plan"`
+	// Connected event fields
+	SubscribedInboxes []string `json:"subscribed_inboxes"`
+	ConnectionCount   int      `json:"connection_count"`
+}
+
+// Watch opens a WebSocket connection and streams emails to the terminal.
+// mailbox can be "" to watch all registered inboxes.
+func Watch(apiKey, mailbox string) error {
+	u, _ := url.Parse(wsBaseURL)
+	q := u.Query()
+	q.Set("api_key", apiKey)
+	if mailbox != "" {
+		q.Set("mailbox", mailbox)
+	}
+	u.RawQuery = q.Encode()
+
+	// Connect
+	dialer := websocket.DefaultDialer
+	conn, _, err := dialer.Dial(u.String(), nil)
+	if err != nil {
+		return fmt.Errorf("could not connect to WebSocket: %w", err)
+	}
+	defer conn.Close()
+
+	// Graceful shutdown on SIGINT / SIGTERM
+	sigCh := make(chan os.Signal, 1)
+	signal.Notify(sigCh, syscall.SIGINT, syscall.SIGTERM)
+	go func() {
+		<-sigCh
+		fmt.Println()
+		display.Info("Disconnected.")
+		conn.WriteMessage(websocket.CloseMessage,
+			websocket.FormatCloseMessage(websocket.CloseNormalClosure, ""))
+		conn.Close()
+		os.Exit(0)
+	}()
+
+	// Ping loop to keep alive
+	go func() {
+		ticker := time.NewTicker(25 * time.Second)
+		defer ticker.Stop()
+		for range ticker.C {
+			msg, _ := json.Marshal(map[string]string{"type": "ping"})
+			conn.WriteMessage(websocket.TextMessage, msg)
+		}
+	}()
+
+	// Read loop
+	for {
+		_, raw, err := conn.ReadMessage()
+		if err != nil {
+			if websocket.IsCloseError(err, websocket.CloseNormalClosure, websocket.CloseGoingAway) {
+				return nil
+			}
+			return fmt.Errorf("connection error: %w", err)
+		}
+
+		var event emailEvent
+		if err := json.Unmarshal(raw, &event); err != nil {
+			continue
+		}
+
+		switch event.Type {
+		case "connected":
+			inboxList := mailbox
+			if inboxList == "" {
+				inboxList = fmt.Sprintf("%d inbox(es)", len(event.SubscribedInboxes))
+			}
+			display.Success(fmt.Sprintf("Watching %s  %s",
+				inboxList,
+				display.PlanBadge(event.Plan),
+			))
+			display.Info("Waiting for emails… (press Ctrl+C to stop)")
+
+		case "pong":
+			// keepalive — ignore
+
+		case "error":
+			// plan gate or connection error
+			var errEvent struct {
+				Type    string `json:"type"`
+				Code    string `json:"code"`
+				Message string `json:"message"`
+			}
+			json.Unmarshal(raw, &errEvent)
+			display.Error(errEvent.Message)
+			return nil
+
+		default:
+			// Email event
+			id   := event.ID
+			otp  := safeStr(event.OTP)
+			link := safeStr(event.VerificationLink)
+			ts   := formatTimestamp(event.Date)
+			display.EmailEvent(id, event.From, event.Subject, otp, link, ts)
+		}
+	}
+}
+
+func safeStr(s string) string {
+	if s == "null" || s == "__DETECTED__" || s == "__UPGRADE_REQUIRED__" {
+		return ""
+	}
+	return s
+}
+
+func formatTimestamp(t string) string {
+	if t == "" {
+		return time.Now().Format("15:04:05")
+	}
+	parsed, err := time.Parse(time.RFC3339Nano, t)
+	if err != nil {
+		return t
+	}
+	return parsed.Local().Format("15:04:05")
+}

package/main.go

@@ -0,0 +1,7 @@
+package main
+
+import "github.com/DishIs/fce-cli/cmd"
+
+func main() {
+	cmd.Execute()
+}

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "fcemail",
+  "version": "0.1.11",
+  "description": "FreeCustom.Email CLI — Manage disposable inboxes from your terminal.",
+  "bin": {
+    "fce": "bin/fce"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install-binary.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DishIs/fce-cli.git"
+  },
+  "author": "DishIs",
+  "license": "MIT"
+}

package/scripts/install-binary.js

@@ -0,0 +1,11 @@
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+console.log('Downloading fce-cli binary...');
+try {
+  execSync('curl -fsSL https://raw.githubusercontent.com/DishIs/fce-cli/main/scripts/install.sh | BIN_DIR=./bin sh');
+} catch (err) {
+  console.error('Failed to download binary:', err.message);
+  process.exit(1);
+}

package/scripts/install.sh

@@ -0,0 +1,65 @@
+#!/bin/sh
+set -e
+
+# Config
+OWNER="DishIs"
+REPO="fce-cli"
+BINARY_NAME="fce"
+GITHUB_API="https://api.github.com/repos/$OWNER/$REPO/releases/latest"
+
+# Detect OS
+OS=$(uname -s | tr '[:upper:]' '[:lower:]')
+case "$OS" in
+  linux*)   OS='linux';;
+  darwin*)  OS='darwin';;
+  msys*|cygwin*|mingw*) OS='windows';;
+  *)        echo "Unsupported OS: $OS"; exit 1;;
+esac
+
+# Detect Arch
+ARCH=$(uname -m)
+case "$ARCH" in
+  x86_64) ARCH='amd64';;
+  arm64|aarch64) ARCH='arm64';;
+  *)      echo "Unsupported architecture: $ARCH"; exit 1;;
+esac
+
+# Allow overriding install directory (useful for NPM)
+INSTALL_DIR=${BIN_DIR:-"/usr/local/bin"}
+
+echo "Installing $BINARY_NAME for $OS/$ARCH..."
+
+# Get latest version and download URL
+DOWNLOAD_URL=$(curl -s $GITHUB_API | grep "browser_download_url" | grep "${OS}_${ARCH}" | cut -d '"' -f 4 | head -n 1)
+
+if [ -z "$DOWNLOAD_URL" ]; then
+  echo "Could not find a release for $OS/$ARCH"
+  exit 1
+fi
+
+# Create temp directory
+TMP_DIR=$(mktemp -d)
+trap 'rm -rf "$TMP_DIR"' EXIT
+
+# Download and extract
+echo "Downloading $DOWNLOAD_URL..."
+curl -sL "$DOWNLOAD_URL" -o "$TMP_DIR/archive"
+
+if [ "$OS" = "windows" ]; then
+  unzip -q "$TMP_DIR/archive" -d "$TMP_DIR"
+else
+  tar -xzf "$TMP_DIR/archive" -C "$TMP_DIR"
+fi
+
+# Move to install directory
+if [ "$INSTALL_DIR" = "./bin" ]; then
+  mkdir -p "$INSTALL_DIR"
+  mv "$TMP_DIR/$BINARY_NAME" "$INSTALL_DIR/"
+  echo "Successfully installed $BINARY_NAME to $INSTALL_DIR!"
+else
+  echo "Installing to $INSTALL_DIR/$BINARY_NAME (requires sudo)..."
+  sudo mv "$TMP_DIR/$BINARY_NAME" "$INSTALL_DIR/"
+  echo "Successfully installed $BINARY_NAME!"
+fi
+
+$BINARY_NAME version || "$INSTALL_DIR/$BINARY_NAME" version || echo "Installation complete."