foxreach-cli 0.1.0__tar.gz → 0.2.0__tar.gz

{foxreach_cli-0.1.0 → foxreach_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: foxreach-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: CLI for the FoxReach cold email outreach API
 Project-URL: Homepage, https://foxreach.io
 Project-URL: Documentation, https://docs.foxreach.io/sdks/cli
@@ -23,7 +23,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Communications :: Email
 Requires-Python: >=3.9
 Requires-Dist: click>=8.0
-Requires-Dist: foxreach>=0.1.0
+Requires-Dist: foxreach>=0.2.0
 Requires-Dist: rich>=13.0
 Description-Content-Type: text/markdown
 

{foxreach_cli-0.1.0 → foxreach_cli-0.2.0}/foxreach_cli/commands/campaigns.py

@@ -188,6 +188,47 @@ def campaigns_pause(campaign_id: str) -> None:
     print_success(f"Campaign paused: {campaign.name} ({campaign.id})")
 
 
+@campaigns.command("resume")
+@click.argument("campaign_id")
+def campaigns_resume(campaign_id: str) -> None:
+    """Resume a paused campaign."""
+    client = get_client()
+    try:
+        campaign = client.campaigns.resume(campaign_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_success(f"Campaign resumed: {campaign.name} ({campaign.id})")
+
+
+@campaigns.command("remove-lead")
+@click.argument("campaign_id")
+@click.argument("lead_id")
+def campaigns_remove_lead(campaign_id: str, lead_id: str) -> None:
+    """Remove a lead from a campaign."""
+    client = get_client()
+    try:
+        client.campaigns.remove_lead(campaign_id, lead_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_success(f"Removed lead {lead_id} from campaign {campaign_id}")
+
+
+@campaigns.command("remove-account")
+@click.argument("campaign_id")
+@click.argument("account_id")
+def campaigns_remove_account(campaign_id: str, account_id: str) -> None:
+    """Remove an email account from a campaign."""
+    client = get_client()
+    try:
+        client.campaigns.remove_account(campaign_id, account_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_success(f"Removed account {account_id} from campaign {campaign_id}")
+
+
 @campaigns.command("add-leads")
 @click.argument("campaign_id")
 @click.option("--lead-ids", required=True, help="Comma-separated lead IDs")

{foxreach_cli-0.1.0 → foxreach_cli-0.2.0}/foxreach_cli/commands/inbox.py

@@ -121,3 +121,76 @@ def inbox_update(reply_id: str, read: Optional[bool], starred: Optional[bool], c
         print_json(thread)
     else:
         print_success(f"Thread updated: {reply_id}")
+
+
+@inbox.command("conversation")
+@click.argument("reply_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def inbox_conversation(reply_id: str, as_json: bool) -> None:
+    """Get the full conversation thread for a reply."""
+    client = get_client()
+    try:
+        result = client.inbox.get_conversation(reply_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(result)
+        return
+
+    messages = result.get("messages", [])
+    if not messages:
+        click.echo("No messages in this conversation.")
+        return
+
+    for msg in messages:
+        direction = msg.get("direction", "?")
+        ts = msg.get("timestamp", "")[:19] if msg.get("timestamp") else "\u2014"
+        from_email = msg.get("fromEmail", "")
+        subject = msg.get("subject", "")
+        click.echo(f"  [{direction:>8}] {ts}  {from_email}  {subject}")
+
+
+@inbox.command("reply")
+@click.argument("reply_id")
+@click.option("--body", required=True, help="Reply body text")
+@click.option("--subject", default=None, help="Override subject line")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def inbox_reply(reply_id: str, body: str, subject: Optional[str], as_json: bool) -> None:
+    """Send a reply to an inbox thread."""
+    client = get_client()
+    try:
+        result = client.inbox.send_reply(reply_id, body, subject=subject)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(result)
+    else:
+        print_success(f"Reply sent (message ID: {result.get('messageId', 'unknown')})")
+
+
+@inbox.command("stats")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def inbox_stats(as_json: bool) -> None:
+    """Get inbox statistics."""
+    client = get_client()
+    try:
+        result = client.inbox.stats()
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(result)
+        return
+
+    click.echo(f"  Total:          {result.get('total', 0)}")
+    click.echo(f"  Unread:         {result.get('unread', 0)}")
+    click.echo(f"  Interested:     {result.get('interested', 0)}")
+    click.echo(f"  Not Interested: {result.get('notInterested', 0)}")
+    click.echo(f"  Out of Office:  {result.get('outOfOffice', 0)}")
+    click.echo(f"  Uncategorized:  {result.get('uncategorized', 0)}")
+    click.echo(f"  Total Sent:     {result.get('totalSent', 0)}")

{foxreach_cli-0.1.0 → foxreach_cli-0.2.0}/foxreach_cli/commands/leads.py

@@ -176,3 +176,32 @@ def leads_delete(lead_id: str) -> None:
         print_error(str(e))
         sys.exit(1)
     print_success(f"Lead deleted: {lead_id}")
+
+
+@leads.command("activity")
+@click.argument("lead_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def leads_activity(lead_id: str, as_json: bool) -> None:
+    """Get activity timeline for a lead."""
+    client = get_client()
+    try:
+        result = client.leads.activity(lead_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(result)
+        return
+
+    activities = result.get("activities", [])
+    if not activities:
+        click.echo("No activity found for this lead.")
+        return
+
+    for a in activities:
+        ts = a.get("timestamp", "")[:19] if a.get("timestamp") else "\u2014"
+        atype = a.get("type", "unknown")
+        subject = a.get("subject", "")
+        campaign = a.get("campaignName", "")
+        click.echo(f"  {ts}  {atype:<16}  {subject[:50]:<50}  {campaign}")

foxreach_cli-0.2.0/foxreach_cli/commands/webhooks.py

@@ -0,0 +1,133 @@
+from __future__ import annotations
+
+import sys
+from dataclasses import asdict
+from typing import Optional
+
+import click
+
+from foxreach import FoxReachError, WebhookCreate, WebhookUpdate
+
+from ..client_factory import get_client
+from ..output import print_detail, print_error, print_json, print_meta, print_success, print_table
+
+
+@click.group()
+def webhooks() -> None:
+    """Manage webhooks."""
+
+
+@webhooks.command("list")
+@click.option("--page", default=1, type=int)
+@click.option("--limit", default=20, type=int)
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def webhooks_list(page: int, limit: int, as_json: bool) -> None:
+    """List webhooks."""
+    client = get_client()
+    try:
+        result = client.webhooks.list(page=page, page_size=limit)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json({"data": [asdict(w) for w in result.data], "meta": asdict(result.meta)})
+        return
+
+    if not result.data:
+        click.echo("No webhooks found.")
+        return
+
+    print_table(
+        result.data,
+        ["ID", "URL", "Active", "Events", "Failures"],
+        {
+            "ID": "id", "URL": "url", "Active": "is_active",
+            "Events": lambda w: ", ".join(w.events[:3]) + ("..." if len(w.events) > 3 else ""),
+            "Failures": "consecutive_failures",
+        },
+    )
+    print_meta(result.meta)
+
+
+@webhooks.command("create")
+@click.option("--url", required=True, help="Webhook endpoint URL")
+@click.option("--events", required=True, help="Comma-separated event types")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def webhooks_create(url: str, events: str, as_json: bool) -> None:
+    """Create a new webhook."""
+    event_list = [e.strip() for e in events.split(",") if e.strip()]
+    client = get_client()
+    try:
+        webhook = client.webhooks.create(WebhookCreate(url=url, events=event_list))
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(webhook)
+    else:
+        print_success(f"Webhook created: {webhook.id}")
+        if webhook.secret:
+            click.echo(f"  Secret: {webhook.secret}")
+            click.echo("  (Save this secret - it won't be shown again)")
+
+
+@webhooks.command("update")
+@click.argument("webhook_id")
+@click.option("--url", default=None, help="New endpoint URL")
+@click.option("--events", default=None, help="Comma-separated event types")
+@click.option("--active/--inactive", default=None, help="Enable or disable")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def webhooks_update(webhook_id: str, url: Optional[str], events: Optional[str], active: Optional[bool], as_json: bool) -> None:
+    """Update a webhook."""
+    event_list = [e.strip() for e in events.split(",") if e.strip()] if events else None
+    client = get_client()
+    try:
+        webhook = client.webhooks.update(webhook_id, WebhookUpdate(
+            url=url,
+            events=event_list,
+            is_active=active,
+        ))
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(webhook)
+    else:
+        print_success(f"Webhook updated: {webhook.id}")
+
+
+@webhooks.command("delete")
+@click.argument("webhook_id")
+@click.confirmation_option(prompt="Are you sure you want to delete this webhook?")
+def webhooks_delete(webhook_id: str) -> None:
+    """Delete a webhook."""
+    client = get_client()
+    try:
+        client.webhooks.delete(webhook_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_success(f"Webhook deleted: {webhook_id}")
+
+
+@webhooks.command("events")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def webhooks_events(as_json: bool) -> None:
+    """List available webhook event types."""
+    client = get_client()
+    try:
+        events = client.webhooks.list_events()
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(events)
+        return
+
+    click.echo("Available webhook event types:")
+    for event in events:
+        click.echo(f"  - {event}")

{foxreach_cli-0.1.0 → foxreach_cli-0.2.0}/foxreach_cli/main.py

@@ -70,6 +70,7 @@ from .commands.templates import templates
 from .commands.accounts import accounts
 from .commands.inbox import inbox
 from .commands.analytics import analytics
+from .commands.webhooks import webhooks
 
 cli.add_command(leads)
 cli.add_command(campaigns)
@@ -78,6 +79,7 @@ cli.add_command(templates)
 cli.add_command(accounts)
 cli.add_command(inbox)
 cli.add_command(analytics)
+cli.add_command(webhooks)
 
 
 def main() -> None:

{foxreach_cli-0.1.0 → foxreach_cli-0.2.0}/foxreach_cli/output.py

@@ -19,8 +19,8 @@ def print_json(data: Any) -> None:
     click.echo(json.dumps(data, indent=2, default=str))
 
 
-def print_table(rows: Sequence[Any], columns: List[str], field_map: Optional[Dict[str, str]] = None) -> None:
-    """Print a rich table. field_map maps column headers to dataclass field names."""
+def print_table(rows: Sequence[Any], columns: List[str], field_map: Optional[Dict[str, Any]] = None) -> None:
+    """Print a rich table. field_map maps column headers to dataclass field names or callables."""
     table = Table(show_header=True, header_style="bold cyan")
     for col in columns:
         table.add_column(col)
@@ -28,8 +28,11 @@ def print_table(rows: Sequence[Any], columns: List[str], field_map: Optional[Dic
     for row in rows:
         values = []
         for col in columns:
-            field = (field_map or {}).get(col, col.lower().replace(" ", "_"))
-            val = getattr(row, field, "") if hasattr(row, field) else ""
+            getter = (field_map or {}).get(col, col.lower().replace(" ", "_"))
+            if callable(getter):
+                val = getter(row)
+            else:
+                val = getattr(row, getter, "") if hasattr(row, getter) else ""
             values.append(str(val) if val is not None else "")
         table.add_row(*values)
 

{foxreach_cli-0.1.0 → foxreach_cli-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "foxreach-cli"
-version = "0.1.0"
+version = "0.2.0"
 description = "CLI for the FoxReach cold email outreach API"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -23,7 +23,7 @@ classifiers = [
 dependencies = [
     "click>=8.0",
     "rich>=13.0",
-    "foxreach>=0.1.0",
+    "foxreach>=0.2.0",
 ]
 
 [project.urls]