From 72d4816073a6a29c429955f702d400e888ef4763 Mon Sep 17 00:00:00 2001
From: sneurlax <sneurlax@gmail.com>
Date: Mon, 13 Jul 2026 12:50:02 -0500
Subject: [PATCH] feat: allow caller-configurable Tor data directory

Add an optional dataDirPath parameter to Tor.start() and Tor.enable().
When provided, the tor_state and tor_cache directories are created under
that path; otherwise the application support directory is used as before.

This lets embedders place Tor state in an app-specific location rather
than being tied to getApplicationSupportDirectory().
---
 lib/tor.dart | 23 +++++++++++++++--------
 1 file changed, 15 insertions(+), 8 deletions(-)

diff --git a/lib/tor.dart b/lib/tor.dart
index c1c9c1e..7f36200 100644
--- a/lib/tor.dart
+++ b/lib/tor.dart
@@ -109,10 +109,14 @@ class Tor {
   }
 
   /// Start the Tor service.
-  Future<void> enable() async {
+  ///
+  /// If [dataDirPath] is provided, the Tor state and cache directories are
+  /// created underneath it. Otherwise the application support directory is
+  /// used.
+  Future<void> enable({String? dataDirPath}) async {
     _enabled = true;
     if (!started) {
-      await start();
+      await start(dataDirPath: dataDirPath);
     }
     broadcastState();
   }
@@ -143,20 +147,23 @@ class Tor {
   ///
   /// This will start the Tor service and establish a Tor circuit.
   ///
+  /// If [dataDirPath] is provided, the Tor state and cache directories are
+  /// created underneath it. Otherwise the application support directory is
+  /// used.
+  ///
   /// Throws an exception if the Tor service fails to start.
   ///
   /// Returns a Future that completes when the Tor service has started.
-  Future<void> start() async {
+  Future<void> start({String? dataDirPath}) async {
     broadcastState();
 
     await ensureRustLibInit();
 
     // Set the state and cache directories.
-    final Directory appSupportDir = await getApplicationSupportDirectory();
-    final stateDir =
-        await Directory('${appSupportDir.path}/tor_state').create();
-    final cacheDir =
-        await Directory('${appSupportDir.path}/tor_cache').create();
+    final String baseDirPath =
+        dataDirPath ?? (await getApplicationSupportDirectory()).path;
+    final stateDir = await Directory('$baseDirPath/tor_state').create();
+    final cacheDir = await Directory('$baseDirPath/tor_cache').create();
 
     // Generate a random port.
     int newPort = await _getRandomUnusedPort();