feat: add a native CLI launcher for local and YouTube playback

Build .build/terebi beside the app. Parse a single local file or YouTube URL, --url, --, and help; reject invalid commands before GUI launch. Resolve the adjacent app through symlinks and launch through NSWorkspace, reusing its process/window and saved progress. Launch the app without media before delivering URL events. Raw media argv suppress SwiftUI's initial singleton window. Own warm document and internet Apple events because SwiftUI's default external-event routing closes that window; retain initial Finder document delivery to create it. Verified actual CLI 0/64/69 exit behavior, PATH/symlink discovery from another directory, cold local/YouTube playback, warm local/YouTube replacement in the same native window/process, resume, Finder-style cold launch, and make all check.
2026-10-11 00:04:37 +02:00
parent 0411064f0c
commit 230949bb95
6 changed files with 204 additions and 3 deletions
@@ -0,0 +1,69 @@
+import Foundation
+
+enum PlayerCommand {
+    case help
+    case launch(URL?)
+
+    static let usage = """
+    Usage: terebi [FILE | YOUTUBE_URL]
+           terebi --url YOUTUBE_URL
+           terebi -- FILE
+           terebi --help
+
+    Open one local media file or YouTube video and start playback, resuming saved
+    video progress when available. With no arguments, open or activate the player.
+    Quote paths and URLs containing spaces or shell metacharacters.
+
+      --url URL  Open a YouTube video URL.
+      --         Treat the following argument as a filename, even with a leading '-'.
+      -h, --help Show this help without launching the player.
+
+    Reuses the running player when available. The command exits once macOS accepts
+    the launch; playback and extraction errors appear in the player window.
+    """
+
+    static func parse(_ arguments: [String], directory: URL = URL(fileURLWithPath: FileManager.default.currentDirectoryPath, isDirectory: true)) throws -> PlayerCommand {
+        if arguments.isEmpty { return .launch(nil) }
+        if arguments == ["--help"] || arguments == ["-h"] { return .help }
+        if arguments.first == "--url" {
+            guard arguments.count == 2 else { throw ArgumentError("--url requires exactly one YouTube URL.") }
+            return .launch(try YouTubeResolver.validateURL(arguments[1]))
+        }
+        var inputs = arguments
+        let filenameOnly = inputs.first == "--"
+        if filenameOnly {
+            inputs.removeFirst()
+        } else if inputs.first?.hasPrefix("-") == true {
+            throw ArgumentError("Unknown option. Use -- before filenames beginning with '-'.")
+        }
+        guard inputs.count == 1, let input = inputs.first, !input.isEmpty else {
+            throw ArgumentError("Expected exactly one file or YouTube URL.")
+        }
+        let file: URL
+        if !filenameOnly && input.contains("://") {
+            guard let url = URL(string: input) else { throw ArgumentError("Invalid media URL.") }
+            if url.isFileURL {
+                guard url.host == nil || url.host == "" || url.host == "localhost" else {
+                    throw ArgumentError("File URLs must refer to this machine.")
+                }
+                file = url
+            } else {
+                return .launch(try YouTubeResolver.validateURL(input))
+            }
+        } else {
+            let base = directory.hasDirectoryPath ? directory : URL(fileURLWithPath: directory.path, isDirectory: true)
+            file = URL(fileURLWithPath: input, relativeTo: base).absoluteURL
+        }
+        guard (try? file.resourceValues(forKeys: [.isRegularFileKey]).isRegularFile) == true,
+              FileManager.default.isReadableFile(atPath: file.path) else {
+            throw ArgumentError("File does not exist or is not a readable regular file.")
+        }
+        return .launch(file.standardizedFileURL)
+    }
+
+    private struct ArgumentError: LocalizedError {
+        let message: String
+        init(_ message: String) { self.message = message }
+        var errorDescription: String? { message }
+    }
+}