mushu-cli 0.1.1__tar.gz

mushu_cli-0.1.1/.gitignore

@@ -0,0 +1,28 @@
+# Virtual environment
+.venv/
+venv/
+
+# Python cache
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Distribution
+dist/
+build/
+*.egg-info/
+
+# Ruff cache
+.ruff_cache/
+
+# pytest
+.pytest_cache/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# macOS
+.DS_Store

mushu_cli-0.1.1/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## [0.1.1](https://github.com/cjoelrun/mushu/compare/mushu-cli-v0.1.0...mushu-cli-v0.1.1) (2026-01-25)
+
+
+### Features
+
+* **cli:** add app and api-key commands ([fa651ff](https://github.com/cjoelrun/mushu/commit/fa651ffa924a5d5d25f9e79453ba327a341368eb))
+
+
+### Bug Fixes
+
+* **cli:** align version with release-please manifest ([ddd628c](https://github.com/cjoelrun/mushu/commit/ddd628cf00cd803270fd4524a67e54b8dbed35b5))

mushu_cli-0.1.1/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: mushu-cli
+Version: 0.1.1
+Summary: CLI for Mushu platform (auth + notifications)
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.26.0
+Requires-Dist: pyjwt>=2.8.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == 'dev'

mushu_cli-0.1.1/README.md

@@ -0,0 +1,202 @@
+# mushu-cli
+
+Command-line interface for the Mushu platform.
+
+## Features
+
+- **Authentication**: Sign in with Apple via web OAuth
+- **Organization Management**: Create and manage organizations
+- **Notification Tenants**: Configure APNs credentials and send push notifications
+- **Payment**: Manage Stripe integration and org wallet
+- **Media**: Upload and manage images/videos
+- **Device Management**: Register and list device tokens
+- **Per-Project Config**: Local `.mushu.json` for project-specific settings
+
+## Installation
+
+```bash
+pip install mushu-cli
+```
+
+Or install from source:
+
+```bash
+cd mushu-cli
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# Sign in
+mushu auth login
+
+# Create an organization
+mushu org create "My Company"
+
+# Initialize project config (creates .mushu.json)
+mushu init --org org_abc123
+
+# Commands now use that org automatically
+mushu tenant create --bundle-id com.myapp.ios
+mushu push send --user <user_id> --title "Hello" --body "World"
+mushu media upload photo.jpg
+```
+
+## Project Configuration
+
+### Per-Project Config (.mushu.json)
+
+Create a `.mushu.json` file in your project root to set defaults for that project:
+
+```bash
+# Initialize with your org
+mushu init --org org_abc123
+
+# Or with more options
+mushu init --org org_abc123 --tenant tenant_xyz --app app_def456
+```
+
+This creates a `.mushu.json` file:
+
+```json
+{
+  "org_id": "org_abc123",
+  "tenant_id": "tenant_xyz",
+  "app_id": "app_def456"
+}
+```
+
+The CLI automatically finds and uses this config when running commands from that directory (or any subdirectory).
+
+### Config Resolution Order
+
+Settings are resolved in this order (highest priority first):
+
+1. **Command-line flags** (`--org`, `--tenant`, etc.)
+2. **Environment variables** (`MUSHU_ORG_ID`, `MUSHU_TENANT_ID`, etc.)
+3. **Local `.mushu.json`** (walked up from current directory)
+4. **Global `~/.mushu/config.json`** defaults
+
+### View Current Config
+
+```bash
+# Show status including which config is active
+mushu status
+
+# Show detailed config info
+mushu config --show
+```
+
+## Commands
+
+### Project Init
+
+```bash
+mushu init                              # Use current global defaults
+mushu init --org <id>                   # Set org for this project
+mushu init --org <id> --tenant <id>     # Set org and tenant
+mushu init --force                      # Overwrite existing .mushu.json
+```
+
+### Authentication
+
+```bash
+mushu auth login              # Sign in with Apple
+mushu auth logout             # Sign out
+mushu auth whoami             # Show current user
+```
+
+### Organizations
+
+```bash
+mushu org create <name>       # Create organization
+mushu org list                # List your organizations
+mushu org show <id>           # Show organization details
+mushu org delete <id>         # Delete organization
+mushu org use <id>            # Set as global default
+```
+
+### Notification Tenants
+
+```bash
+mushu tenant create --bundle-id <bundle>  # Create tenant (uses project org)
+mushu tenant list                          # List tenants
+mushu tenant show <id>                     # Show tenant
+mushu tenant delete <id>                   # Delete tenant
+mushu tenant use <id>                      # Set as default tenant
+```
+
+### Push Notifications
+
+```bash
+mushu push send --user <id> --title "Title" --body "Body"
+mushu push send --user <id> --silent --data '{"key":"value"}'
+```
+
+### Devices
+
+```bash
+mushu device register <token> --user <id> --platform ios
+mushu device list
+mushu device delete <id>
+```
+
+### Media
+
+```bash
+mushu media upload <file>     # Upload (uses project org)
+mushu media list              # List media
+mushu media show <id>
+mushu media delete <id>
+```
+
+### Pay
+
+```bash
+mushu pay tenant create --name "My App"
+mushu pay tenant list
+mushu pay product create --name "Starter Pack" --price 999 --amount 10000000
+```
+
+### Global Configuration
+
+```bash
+mushu config --show                    # Show current config
+mushu config --auth-url <url>          # Set auth API URL
+mushu config --notify-url <url>        # Set notify API URL
+mushu status                           # Show connection status
+```
+
+## Configuration Files
+
+### Global (~/.mushu/)
+
+- `config.json` - API URLs and global defaults
+- `tokens.json` - Authentication tokens (created after login)
+
+### Local (.mushu.json)
+
+Project-specific settings. Supports:
+
+| Field | Description |
+|-------|-------------|
+| `org_id` | Organization ID |
+| `org_name` | Organization name (display only) |
+| `app_id` | App ID |
+| `app_name` | App name (display only) |
+| `tenant_id` | Notification tenant ID |
+| `pay_tenant_id` | Pay tenant ID |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `MUSHU_AUTH_URL` | Override auth API URL |
+| `MUSHU_NOTIFY_URL` | Override notify API URL |
+| `MUSHU_PAY_URL` | Override pay API URL |
+| `MUSHU_MEDIA_URL` | Override media API URL |
+| `MUSHU_ORG_ID` | Override org ID |
+| `MUSHU_APP_ID` | Override app ID |
+| `MUSHU_TENANT_ID` | Override tenant ID |
+| `MUSHU_PAY_TENANT_ID` | Override pay tenant ID |

mushu_cli-0.1.1/justfile

@@ -0,0 +1,83 @@
+# Mushu CLI development justfile
+
+# Default recipe - show available commands
+default:
+    @just --list
+
+# Install dependencies and CLI in development mode
+install:
+    uv sync
+
+# Run the CLI (pass arguments after --)
+run *args:
+    uv run mushu {{args}}
+
+# Configure CLI for production
+config-prod:
+    uv run mushu config \
+        --auth-url https://auth.mushucorp.com \
+        --notify-url https://notify.mushucorp.com \
+        --pay-url https://pay.mushucorp.com
+
+# Configure CLI for local development
+config-local:
+    uv run mushu config \
+        --auth-url http://localhost:8000 \
+        --notify-url http://localhost:8001 \
+        --pay-url http://localhost:8002
+
+# Show current config
+config:
+    uv run mushu config --show
+
+# Show current status
+status:
+    uv run mushu status
+
+# Login
+login:
+    uv run mushu auth login
+
+# Logout
+logout:
+    uv run mushu auth logout
+
+# List organizations
+orgs:
+    uv run mushu org list
+
+# List notification tenants
+tenants:
+    uv run mushu tenant list
+
+# List pay tenants
+pay-tenants:
+    uv run mushu pay list
+
+# Create a pay tenant
+pay-create name org_id stripe_key:
+    uv run mushu pay create --name "{{name}}" --org "{{org_id}}" --stripe-key "{{stripe_key}}"
+
+# List products for default pay tenant
+products:
+    uv run mushu pay products
+
+# Add a product (credit pack)
+add-product name price credits:
+    uv run mushu pay add-product --name "{{name}}" --price {{price}} --credits {{credits}}
+
+# Create an API key for default pay tenant
+api-key name="default":
+    uv run mushu pay api-key --name "{{name}}"
+
+# Run linting
+lint:
+    uv run ruff check .
+
+# Format code
+fmt:
+    uv run ruff format .
+
+# Clean up
+clean:
+    rm -rf .venv __pycache__ .ruff_cache *.egg-info

mushu_cli-0.1.1/mushu/__init__.py

@@ -0,0 +1 @@
+"""Mushu CLI - Unified CLI for Mushu platform (auth + notifications)."""

mushu_cli-0.1.1/mushu/cli.py

@@ -0,0 +1,259 @@
+"""Main CLI entry point for Mushu."""
+
+from pathlib import Path
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from mushu.commands import (
+    api_key,
+    app as app_cmd,
+    auth,
+    device,
+    email,
+    media,
+    org,
+    pay,
+    push,
+    tenant,
+)
+from mushu.config import (
+    LocalConfig,
+    StoredTokens,
+    get_config,
+    get_global_config,
+    LOCAL_CONFIG_FILE,
+)
+
+app = typer.Typer(
+    name="mushu",
+    help="Mushu CLI - Authentication and push notifications",
+    no_args_is_help=True,
+)
+console = Console()
+
+# Add command groups
+app.add_typer(auth.app, name="auth", help="Authentication")
+app.add_typer(org.app, name="org", help="Organization management")
+app.add_typer(app_cmd.app, name="app", help="App management")  # app_cmd to avoid name collision
+app.add_typer(api_key.app, name="api-key", help="API key management")
+app.add_typer(tenant.app, name="tenant", help="Notification tenant management")
+app.add_typer(pay.app, name="pay", help="Payment tenant management")
+app.add_typer(media.app, name="media", help="Media management")
+app.add_typer(device.app, name="device", help="Device management")
+app.add_typer(push.app, name="push", help="Push notifications")
+app.add_typer(email.app, name="email", help="Email notifications")
+
+
+@app.command("init")
+def init_cmd(
+    org_id: str = typer.Option(None, "--org", "-o", help="Organization ID"),
+    org_name: str = typer.Option(None, "--org-name", help="Organization name (for display)"),
+    app_id: str = typer.Option(None, "--app", "-a", help="App ID"),
+    app_name: str = typer.Option(None, "--app-name", help="App name (for display)"),
+    tenant_id: str = typer.Option(None, "--tenant", "-t", help="Notification tenant ID"),
+    pay_tenant_id: str = typer.Option(None, "--pay-tenant", help="Pay tenant ID"),
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing config"),
+):
+    """Initialize a .mushu.json config file in the current directory.
+
+    This creates a project-specific configuration that the CLI will automatically
+    use when running commands from this directory (or any subdirectory).
+
+    Examples:
+        mushu init --org org_abc123
+        mushu init --org org_abc123 --tenant tenant_xyz
+        mushu init --org org_abc123 --app app_def456
+    """
+    config_path = Path.cwd() / LOCAL_CONFIG_FILE
+
+    # Check if config already exists
+    if config_path.exists() and not force:
+        console.print(f"[yellow]Config file already exists: {config_path}[/yellow]")
+        console.print("Use --force to overwrite")
+        raise typer.Exit(1)
+
+    # If no options provided, try to use current global defaults
+    if not any([org_id, app_id, tenant_id, pay_tenant_id]):
+        global_config = get_global_config()
+        if global_config.default_org:
+            org_id = global_config.default_org
+            org_name = global_config.default_org_name
+            console.print(f"[dim]Using default org from global config: {org_id}[/dim]")
+        if global_config.default_tenant:
+            tenant_id = global_config.default_tenant
+            console.print(f"[dim]Using default tenant from global config: {tenant_id}[/dim]")
+        if global_config.default_pay_tenant:
+            pay_tenant_id = global_config.default_pay_tenant
+
+    if not org_id:
+        console.print(
+            "[yellow]No org specified. Use --org to set one, or run 'mushu org use <id>' first.[/yellow]"
+        )
+        raise typer.Exit(1)
+
+    # Create and save local config
+    local_config = LocalConfig(
+        org_id=org_id,
+        org_name=org_name,
+        app_id=app_id,
+        app_name=app_name,
+        tenant_id=tenant_id,
+        pay_tenant_id=pay_tenant_id,
+    )
+    saved_path = local_config.save(config_path)
+
+    console.print(f"[green]Created {saved_path}[/green]")
+    console.print()
+
+    # Show what was saved
+    table = Table(show_header=False, box=None)
+    table.add_column("Key", style="dim")
+    table.add_column("Value")
+
+    if org_id:
+        display = f"{org_id}" + (f" ({org_name})" if org_name else "")
+        table.add_row("org_id", display)
+    if app_id:
+        display = f"{app_id}" + (f" ({app_name})" if app_name else "")
+        table.add_row("app_id", display)
+    if tenant_id:
+        table.add_row("tenant_id", tenant_id)
+    if pay_tenant_id:
+        table.add_row("pay_tenant_id", pay_tenant_id)
+
+    console.print(table)
+    console.print()
+    console.print("[dim]Commands in this directory will now use these defaults.[/dim]")
+
+
+@app.command("config")
+def config_cmd(
+    auth_url: str = typer.Option(None, "--auth-url", help="Set auth API URL"),
+    notify_url: str = typer.Option(None, "--notify-url", help="Set notify API URL"),
+    pay_url: str = typer.Option(None, "--pay-url", help="Set pay API URL"),
+    media_url: str = typer.Option(None, "--media-url", help="Set media API URL"),
+    show: bool = typer.Option(False, "--show", "-s", help="Show current config"),
+):
+    """Configure global CLI settings.
+
+    For per-project settings, use 'mushu init' to create a .mushu.json file.
+    """
+    config = get_global_config()
+
+    if auth_url:
+        config.auth_url = auth_url.rstrip("/")
+        console.print(f"[green]Auth URL: {auth_url}[/green]")
+
+    if notify_url:
+        config.notify_url = notify_url.rstrip("/")
+        console.print(f"[green]Notify URL: {notify_url}[/green]")
+
+    if pay_url:
+        config.pay_url = pay_url.rstrip("/")
+        console.print(f"[green]Pay URL: {pay_url}[/green]")
+
+    if media_url:
+        config.media_url = media_url.rstrip("/")
+        console.print(f"[green]Media URL: {media_url}[/green]")
+
+    if auth_url or notify_url or pay_url or media_url:
+        config.save()
+
+    if show or (not auth_url and not notify_url and not pay_url and not media_url):
+        # Show effective config (merged)
+        effective = get_config()
+
+        console.print("[bold]Global Config[/bold] (~/.mushu/config.json)")
+        console.print(f"  Auth URL: {config.auth_url}")
+        console.print(f"  Notify URL: {config.notify_url}")
+        console.print(f"  Pay URL: {config.pay_url}")
+        console.print(f"  Media URL: {config.media_url}")
+        console.print(f"  Default org: {config.default_org or '[not set]'}")
+        console.print(f"  Default tenant: {config.default_tenant or '[not set]'}")
+        console.print()
+
+        if effective.local_config_path:
+            console.print(f"[bold]Local Config[/bold] ({effective.local_config_path})")
+            local = LocalConfig.load()
+            if local:
+                if local.org_id:
+                    console.print(f"  org_id: {local.org_id}")
+                if local.app_id:
+                    console.print(f"  app_id: {local.app_id}")
+                if local.tenant_id:
+                    console.print(f"  tenant_id: {local.tenant_id}")
+                if local.pay_tenant_id:
+                    console.print(f"  pay_tenant_id: {local.pay_tenant_id}")
+            console.print()
+
+        console.print("[bold]Effective Config[/bold] (merged)")
+        console.print(f"  org_id: {effective.org_id or '[not set]'}")
+        console.print(f"  app_id: {effective.app_id or '[not set]'}")
+        console.print(f"  tenant_id: {effective.tenant_id or '[not set]'}")
+
+
+@app.command("status")
+def status():
+    """Show current status and effective configuration."""
+    config = get_config()
+    tokens = StoredTokens.load()
+
+    console.print("[bold]Mushu Status[/bold]")
+    console.print()
+
+    # Auth status
+    if tokens:
+        console.print("[green]Authenticated[/green]")
+        if tokens.email:
+            console.print(f"  Email: {tokens.email}")
+        if tokens.user_id:
+            console.print(f"  User: {tokens.user_id}")
+    else:
+        console.print("[yellow]Not authenticated[/yellow]")
+        console.print("  Run: mushu auth login")
+
+    console.print()
+
+    # Project context
+    console.print("[bold]Project Context[/bold]")
+    if config.local_config_path:
+        console.print(f"  [dim]from {config.local_config_path}[/dim]")
+    else:
+        console.print("  [dim]no .mushu.json found (using global defaults)[/dim]")
+
+    if config.org_id:
+        display = config.org_id + (f" ({config.org_name})" if config.org_name else "")
+        console.print(f"  [green]Org: {display}[/green]")
+    else:
+        console.print("  [yellow]Org: not set[/yellow]")
+
+    if config.app_id:
+        display = config.app_id + (f" ({config.app_name})" if config.app_name else "")
+        console.print(f"  [green]App: {display}[/green]")
+
+    if config.tenant_id:
+        console.print(f"  [green]Tenant: {config.tenant_id}[/green]")
+
+    console.print()
+    console.print(f"[dim]Auth: {config.auth_url}[/dim]")
+    console.print(f"[dim]Notify: {config.notify_url}[/dim]")
+
+
+@app.callback()
+def main():
+    """
+    Mushu CLI - Authentication, push notifications, and media for your apps.
+
+    Get started:
+      mushu auth login          # Sign in
+      mushu org create ...      # Create an organization
+      mushu init --org <id>     # Set up project config
+      mushu push send ...       # Send a notification
+    """
+    pass
+
+
+if __name__ == "__main__":
+    app()

mushu_cli-0.1.1/mushu/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI commands for Mushu."""