justfile

# Clicker - Presentation Remote System
# Run `just` to see available commands

set shell := ["bash", "-uc"]
set dotenv-load

# Find the most recently modified DerivedData folder
derived_data := `ls -td ~/Library/Developer/Xcode/DerivedData/Clicker-* 2>/dev/null | head -1`
mac_app := derived_data + "/Build/Products/Debug/ClickerRemoteReceiver.app"
release_mac_app := derived_data + "/Build/Products/Release/ClickerRemoteReceiver.app"
ios_app := derived_data + "/Build/Products/Debug-iphoneos/ClickerRemote.app"
ios_sim_app := derived_data + "/Build/Products/Debug-iphonesimulator/ClickerRemote.app"

# Version from Info.plist
version := `/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" MacApp/Info.plist 2>/dev/null || echo "1.0.0"`

dmg_name := "ClickerRemoteReceiver"
mac_logo := "public/logo/mac-logo.png"
notary_profile := "notarytool-profile"
signing_identity := "Developer ID Application: DOU Inc. (HD35YQ72U4)"

# ─────────────────────────────────────────────────────────────────────────────
# Development
# ─────────────────────────────────────────────────────────────────────────────

# Show available commands
default:
    @just --list

# Generate Xcode project from project.yml
generate:
    xcodegen generate

# Build Mac menu bar app
build-mac:
    xcodebuild -scheme ClickerMac build

# Build iOS app for physical device
build-ios:
    @if [ -z "${XCODE_DEVICE_ID:-}" ]; then \
        echo "Error: XCODE_DEVICE_ID not set. Create .env file with XCODE_DEVICE_ID=your-udid"; \
        exit 1; \
    fi
    xcodebuild -scheme ClickeriOS -destination 'id={{ env("XCODE_DEVICE_ID", "") }}' build

# Build iOS app for simulator
build-sim:
    xcodebuild -scheme ClickeriOS -destination 'platform=iOS Simulator,name=iPhone 16,OS=18.2' build

# Build and run iOS app in simulator
run-sim: build-sim
    xcrun simctl boot "iPhone 16" 2>/dev/null || true
    xcrun simctl install booted "{{ ios_sim_app }}"
    xcrun simctl launch booted com.dou.clicker-ios

# Build and run Mac app
run-mac: build-mac
    open "{{ mac_app }}"

# Build and install iOS app on device
install-ios: build-ios
    @if [ -z "${DEVICECTL_ID:-}" ]; then \
        echo "Error: DEVICECTL_ID not set. Run 'xcrun devicectl list devices' to find your device UUID"; \
        exit 1; \
    fi
    xcrun devicectl device install app --device {{ env("DEVICECTL_ID", "") }} "{{ ios_app }}"

# Build, install, and launch iOS app on device
run-ios: install-ios
    xcrun devicectl device process launch --device {{ env("DEVICECTL_ID", "") }} com.dou.clicker-ios

# Build and deploy iPhone + Watch apps to physical devices
deploy: build-ios
    @echo "📱 Installing iPhone + Watch apps on device..."
    xcrun devicectl device install app --device {{ env("DEVICECTL_ID", "") }} "{{ ios_app }}"
    @echo ""
    @echo "✅ Deployed! Watch app will sync to your paired Apple Watch automatically."
    @echo "   If it doesn't appear, open the Watch app on iPhone → My Watch → Installed Apps"

# Uninstall iOS app from device (removes app + all data)
uninstall-ios:
    @if [ -z "${DEVICECTL_ID:-}" ]; then \
        echo "Error: DEVICECTL_ID not set. Run 'xcrun devicectl list devices' to find your device UUID"; \
        exit 1; \
    fi
    @echo "🗑️  Uninstalling ClickerRemote from device..."
    xcrun devicectl device uninstall app --device {{ env("DEVICECTL_ID", "") }} com.dou.clicker-ios || echo "App not installed or already removed"
    @echo "✅ App and all data removed"

# Complete clean reinstall: uninstall, clean build, install fresh
clean-install-ios: uninstall-ios clean build-ios install-ios
    @echo "✅ Fresh installation complete"

# Build and run iOS app in screenshot mode (no trial banner)
screenshot:
    xcodebuild -scheme ClickeriOS \
        -destination 'platform=iOS Simulator,name=iPhone 16,OS=18.2' \
        SWIFT_ACTIVE_COMPILATION_CONDITIONS='DEBUG SCREENSHOT_MODE' \
        build
    xcrun simctl boot "iPhone 16" 2>/dev/null || true
    xcrun simctl install booted "{{ ios_sim_app }}"
    xcrun simctl launch booted com.dou.clicker-ios

# Clean build artifacts
clean:
    xcodebuild -scheme ClickerMac clean
    xcodebuild -scheme ClickeriOS clean
    @echo "🧹 Cleaning up mounted volumes and installed app (requires sudo)..."
    -sudo umount -f /Volumes/ClickerRemoteReceiver 2>/dev/null || true
    -sudo rm -rf /Volumes/ClickerRemoteReceiver 2>/dev/null || true
    -sudo rm -rf /Applications/ClickerRemoteReceiver.app 2>/dev/null || true
    @echo "✅ Clean complete"

# List connected iOS devices
list-devices:
    xcrun xctrace list devices

# ─────────────────────────────────────────────────────────────────────────────
# iOS App Store Distribution
# ─────────────────────────────────────────────────────────────────────────────

# Archive iOS app for App Store
archive-ios:
    xcodebuild archive \
        -scheme ClickeriOS \
        -archivePath ./build/Clicker.xcarchive \
        -destination 'generic/platform=iOS'

# Export and upload iOS app to App Store Connect
upload-ios:
    xcodebuild -exportArchive \
        -archivePath ./build/Clicker.xcarchive \
        -exportPath ./build/export \
        -exportOptionsPlist ExportOptions.plist

# Archive and upload iOS app to App Store Connect
release-ios: archive-ios upload-ios

# ─────────────────────────────────────────────────────────────────────────────
# Mac GitHub Distribution (Signed + Notarized DMG)
# ─────────────────────────────────────────────────────────────────────────────

# Build Mac app in Release configuration
build-mac-release:
    xcodebuild -scheme ClickerMac -configuration Release build

# Verify app is signed correctly for distribution
verify-signing: build-mac-release
    @echo "🔍 Verifying code signature..."
    codesign --verify --deep --strict --verbose=2 "{{ release_mac_app }}"
    @echo ""
    @echo "🔍 Checking signing identity..."
    codesign -dvv "{{ release_mac_app }}" 2>&1 | grep "Authority"
    @echo ""
    @echo "🔍 Checking Hardened Runtime..."
    codesign -dvv "{{ release_mac_app }}" 2>&1 | grep -E "(flags|runtime)"
    @echo ""
    @echo "✅ Signature verification complete"

# Create DMG for Mac app distribution (unsigned)
dmg: build-mac-release
    #!/usr/bin/env bash
    set -euo pipefail
    mkdir -p ./build
    rm -f "./build/{{ dmg_name }}-{{ version }}.dmg"
    echo "Creating DMG with custom icon..."

    # Create iconset from PNG
    rm -rf ./build/dmg-icon.iconset
    mkdir -p ./build/dmg-icon.iconset
    sips -s format png -z 16 16     "{{ mac_logo }}" --out ./build/dmg-icon.iconset/icon_16x16.png
    sips -s format png -z 32 32     "{{ mac_logo }}" --out ./build/dmg-icon.iconset/icon_16x16@2x.png
    sips -s format png -z 32 32     "{{ mac_logo }}" --out ./build/dmg-icon.iconset/icon_32x32.png
    sips -s format png -z 64 64     "{{ mac_logo }}" --out ./build/dmg-icon.iconset/icon_32x32@2x.png
    sips -s format png -z 128 128   "{{ mac_logo }}" --out ./build/dmg-icon.iconset/icon_128x128.png
    sips -s format png -z 256 256   "{{ mac_logo }}" --out ./build/dmg-icon.iconset/icon_128x128@2x.png
    sips -s format png -z 256 256   "{{ mac_logo }}" --out ./build/dmg-icon.iconset/icon_256x256.png
    sips -s format png -z 512 512   "{{ mac_logo }}" --out ./build/dmg-icon.iconset/icon_256x256@2x.png
    sips -s format png -z 512 512   "{{ mac_logo }}" --out ./build/dmg-icon.iconset/icon_512x512.png
    sips -s format png -z 1024 1024 "{{ mac_logo }}" --out ./build/dmg-icon.iconset/icon_512x512@2x.png
    iconutil -c icns ./build/dmg-icon.iconset -o ./build/dmg-icon.icns

    # Create temp folder for DMG contents
    rm -rf ./build/dmg-temp
    mkdir -p ./build/dmg-temp
    cp -R "{{ release_mac_app }}" ./build/dmg-temp/
    ln -s /Applications ./build/dmg-temp/Applications

    # Create read-write DMG first
    hdiutil create -volname "{{ dmg_name }}" \
        -srcfolder ./build/dmg-temp \
        -ov -format UDRW \
        "./build/{{ dmg_name }}-rw.dmg"

    # Mount, set volume icon, unmount
    hdiutil attach "./build/{{ dmg_name }}-rw.dmg" -mountpoint "/Volumes/{{ dmg_name }}"
    cp ./build/dmg-icon.icns "/Volumes/{{ dmg_name }}/.VolumeIcon.icns"
    SetFile -a C "/Volumes/{{ dmg_name }}"
    hdiutil detach "/Volumes/{{ dmg_name }}"
    sleep 2

    # Convert to compressed read-only DMG
    hdiutil convert "./build/{{ dmg_name }}-rw.dmg" \
        -format UDZO \
        -o "./build/{{ dmg_name }}-{{ version }}.dmg"

    # Cleanup
    rm -rf ./build/dmg-temp ./build/dmg-icon.iconset ./build/dmg-icon.icns "./build/{{ dmg_name }}-rw.dmg"
    echo "✅ DMG created: ./build/{{ dmg_name }}-{{ version }}.dmg"

# Sign the DMG with Developer ID
sign-dmg: dmg
    @echo "🔏 Signing DMG..."
    codesign --force --sign "{{ signing_identity }}" "./build/{{ dmg_name }}-{{ version }}.dmg"
    @echo "✅ DMG signed"

# Submit DMG for notarization and wait for result
notarize: sign-dmg
    @echo "📤 Submitting for notarization..."
    xcrun notarytool submit "./build/{{ dmg_name }}-{{ version }}.dmg" \
        --keychain-profile {{ notary_profile }} \
        --wait
    @echo ""
    @echo "📎 Stapling notarization ticket..."
    xcrun stapler staple "./build/{{ dmg_name }}-{{ version }}.dmg"
    @echo ""
    @echo "✅ Notarization complete!"

# Verify the DMG is properly notarized
verify-notarization:
    @echo "🔍 Verifying notarization..."
    spctl --assess --type open --context context:primary-signature --verbose=2 "./build/{{ dmg_name }}-{{ version }}.dmg"
    @echo ""
    xcrun stapler validate "./build/{{ dmg_name }}-{{ version }}.dmg"
    @echo "✅ Notarization verified"

# Build, sign, notarize DMG and show GitHub release instructions
release-mac: notarize
    @echo ""
    @echo "📦 Mac DMG ready for GitHub release!"
    @echo "   File: ./build/{{ dmg_name }}-{{ version }}.dmg"
    @echo ""
    @echo "To create a GitHub release:"
    @echo "  gh release create v{{ version }} ./build/{{ dmg_name }}-{{ version }}.dmg \\"
    @echo "    --title 'Clicker v{{ version }}' \\"
    @echo "    --notes 'Release notes here'"
    @echo ""

# ─────────────────────────────────────────────────────────────────────────────
# Notarization Setup
# ─────────────────────────────────────────────────────────────────────────────

# Check if Developer ID certificate is installed
check-signing:
    @echo "🔍 Looking for Developer ID Application certificate..."
    @security find-identity -v -p codesigning | grep "Developer ID Application" || \
        (echo "❌ No Developer ID Application certificate found!" && \
         echo "" && \
         echo "To create one:" && \
         echo "  1. Go to https://developer.apple.com/account/resources/certificates/list" && \
         echo "  2. Click + and select 'Developer ID Application'" && \
         echo "  3. Follow the prompts to create and download" && \
         echo "  4. Double-click the .cer file to install" && \
         exit 1)
    @echo "✅ Developer ID certificate found"

# Store notarization credentials in keychain (interactive)
setup-notary:
    @echo "📝 Setting up notarization credentials..."
    @echo "You'll need:"
    @echo "  - Your Apple ID email"
    @echo "  - Team ID: HD35YQ72U4"
    @echo "  - An app-specific password from https://appleid.apple.com"
    @echo ""
    xcrun notarytool store-credentials {{ notary_profile }} --team-id HD35YQ72U4

# Show the log from the last notarization submission
notary-log:
    @echo "📋 Recent notarization submissions:"
    xcrun notarytool history --keychain-profile {{ notary_profile }}

# ─────────────────────────────────────────────────────────────────────────────
# Homebrew Tap
# ─────────────────────────────────────────────────────────────────────────────

# Trigger homebrew-tap update after GitHub release is created
update-tap:
    @echo "🍺 Triggering homebrew-tap update for v{{ version }}..."
    gh workflow run update-clicker-cask.yml --repo douinc/homebrew-tap -f version={{ version }}
    @echo "✅ Workflow triggered! Check: https://github.com/douinc/homebrew-tap/actions"