@bobfrankston/mailx 1.0.291 → 1.0.293

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx",
-  "version": "1.0.291",
+  "version": "1.0.293",
   "description": "Local-first email client with IMAP sync and standalone native app",
   "type": "module",
   "main": "bin/mailx.js",
@@ -24,7 +24,7 @@
     "@bobfrankston/iflow-node": "^0.1.7",
     "@bobfrankston/miscinfo": "^1.0.8",
     "@bobfrankston/oauthsupport": "^1.0.24",
-    "@bobfrankston/msger": "^0.1.324",
+    "@bobfrankston/msger": "^0.1.325",
     "@capacitor/android": "^8.3.0",
     "@capacitor/cli": "^8.3.0",
     "@capacitor/core": "^8.3.0",
@@ -86,7 +86,7 @@
       "@bobfrankston/iflow-node": "^0.1.7",
       "@bobfrankston/miscinfo": "^1.0.8",
       "@bobfrankston/oauthsupport": "^1.0.24",
-      "@bobfrankston/msger": "^0.1.324",
+      "@bobfrankston/msger": "^0.1.325",
       "@capacitor/android": "^8.3.0",
       "@capacitor/cli": "^8.3.0",
       "@capacitor/core": "^8.3.0",

package/packages/mailx-settings/cloud.d.ts

@@ -16,7 +16,10 @@
  * Dropbox (removed 2026-04-06): Never implemented — placeholder only.
  *   Would need Dropbox OAuth app, token management, and Dropbox API v2 calls.
  */
-/** Find the app-owned "mailx" folder, or create it. Returns folder ID. */
+/** Find the settings folder on GDrive, or create a flat "mailx" folder.
+ *  Supports nested paths from config (e.g. "home/.mailx") by walking each
+ *  segment. Falls back to the folderId in config if set, so a stale ID that
+ *  points to the wrong folder gets corrected on next lookup. */
 export declare function gDriveFindOrCreateFolder(): Promise<string | null>;
 export type CloudProvider = "gdrive" | "google" | "local";
 export interface CloudFile {

package/packages/mailx-settings/cloud.js

@@ -50,7 +50,10 @@ const GDRIVE_TOKEN_DIR = path.join(SETTINGS_DIR, "tokens", "gdrive");
 // drive.file: app can only see files it created. Safe, publishable without security audit.
 // All machines sharing the same OAuth client ID see the same files.
 const GDRIVE_SCOPES = "https://www.googleapis.com/auth/drive.file";
-const GDRIVE_FOLDER_NAME = "mailx";
+/** Paths to try when no config.path is set (fresh install). Order matters:
+ *  "home/.mailx" is the user convention for shared family settings; "mailx"
+ *  is the auto-created default. First one that exists on GDrive wins. */
+const GDRIVE_PATH_SEARCH_ORDER = ["home/.mailx", "mailx"];
 // ── Token helpers ──
 async function getGoogleDriveToken() {
     const creds = findGoogleCredentials();
@@ -99,39 +102,92 @@ async function getGoogleDriveToken() {
     }
 }
 // ── Google Drive API (folder-ID based) ──
-/** Find the app-owned "mailx" folder, or create it. Returns folder ID. */
+/** Walk a nested folder path on GDrive ("home/.mailx" → find "home", find
+ *  ".mailx" inside it). Returns the leaf folder ID, or null if any segment is
+ *  missing. When `create` is true, creates the LAST segment if missing (won't
+ *  create intermediate segments — that's a user error). */
+async function walkGDrivePath(token, segments, create) {
+    let parentId;
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        const found = await gDriveFindFolder(token, seg, parentId);
+        if (found) {
+            parentId = found;
+        }
+        else if (create && i === segments.length - 1) {
+            const body = { name: seg, mimeType: "application/vnd.google-apps.folder" };
+            if (parentId)
+                body.parents = [parentId];
+            const res = await fetch("https://www.googleapis.com/drive/v3/files", {
+                method: "POST",
+                headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
+                body: JSON.stringify(body),
+            });
+            if (!res.ok)
+                return null;
+            const created = await res.json();
+            parentId = created.id;
+        }
+        else {
+            return null;
+        }
+    }
+    return parentId || null;
+}
+/** Find a single folder by name, optionally inside a parent. */
+async function gDriveFindFolder(token, name, parentId) {
+    let query = `name='${name}' and mimeType='application/vnd.google-apps.folder' and trashed=false`;
+    if (parentId)
+        query += ` and '${parentId}' in parents`;
+    const res = await fetch(`https://www.googleapis.com/drive/v3/files?q=${encodeURIComponent(query)}&fields=files(id,name)`, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!res.ok) {
+        console.error(`  [cloud] gdrive folder search '${name}': ${res.status} ${res.statusText}`);
+        return null;
+    }
+    const data = await res.json();
+    return data.files?.[0]?.id || null;
+}
+/** Find the settings folder on GDrive, or create a flat "mailx" folder.
+ *  Supports nested paths from config (e.g. "home/.mailx") by walking each
+ *  segment. Falls back to the folderId in config if set, so a stale ID that
+ *  points to the wrong folder gets corrected on next lookup. */
 export async function gDriveFindOrCreateFolder() {
     const token = await getGoogleDriveToken();
     if (!token)
         return null;
+    // Read path from config — supports nested like "home/.mailx"
+    let cfgEntry = null;
     try {
-        // Search for existing folder (created by this OAuth client)
-        const query = `name='${GDRIVE_FOLDER_NAME}' and mimeType='application/vnd.google-apps.folder' and trashed=false`;
-        const res = await fetch(`https://www.googleapis.com/drive/v3/files?q=${encodeURIComponent(query)}&fields=files(id,name)`, {
-            headers: { Authorization: `Bearer ${token}` },
-        });
-        if (!res.ok) {
-            console.error(`  [cloud] gdrive folder search: ${res.status} ${res.statusText}`);
-            return null;
+        const cfgPath = path.join(SETTINGS_DIR, "config.jsonc");
+        if (fs.existsSync(cfgPath)) {
+            const raw = fs.readFileSync(cfgPath, "utf-8").replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "");
+            cfgEntry = JSON.parse(raw).sharedDir;
         }
-        const data = await res.json();
-        if (data.files?.[0]) {
-            console.log(`  [cloud] Found existing '${GDRIVE_FOLDER_NAME}' folder: ${data.files[0].id}`);
-            return data.files[0].id;
-        }
-        // Create folder
-        const createRes = await fetch("https://www.googleapis.com/drive/v3/files", {
-            method: "POST",
-            headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
-            body: JSON.stringify({ name: GDRIVE_FOLDER_NAME, mimeType: "application/vnd.google-apps.folder" }),
-        });
-        if (!createRes.ok) {
-            console.error(`  [cloud] gdrive folder create: ${createRes.status} ${createRes.statusText}`);
-            return null;
+    }
+    catch { /* ignore */ }
+    // Build search list: configured path first, then common conventions
+    const configuredPath = (typeof cfgEntry === "object" && cfgEntry?.path) ? cfgEntry.path : null;
+    const pathsToTry = configuredPath
+        ? [configuredPath]
+        : GDRIVE_PATH_SEARCH_ORDER;
+    try {
+        for (const tryPath of pathsToTry) {
+            const segments = tryPath.split(/[/\\]/).filter(Boolean);
+            const folderId = await walkGDrivePath(token, segments, false);
+            if (folderId) {
+                console.log(`  [cloud] Found existing '${tryPath}' folder: ${folderId}`);
+                return folderId;
+            }
         }
-        const created = await createRes.json();
-        console.log(`  [cloud] Created '${GDRIVE_FOLDER_NAME}' folder: ${created.id}`);
-        return created.id;
+        // None found — create the first path (configured or default "mailx")
+        const createPath = configuredPath || GDRIVE_PATH_SEARCH_ORDER[GDRIVE_PATH_SEARCH_ORDER.length - 1];
+        const segments = createPath.split(/[/\\]/).filter(Boolean);
+        const created = await walkGDrivePath(token, segments, true);
+        if (created)
+            console.log(`  [cloud] Created '${createPath}' folder: ${created}`);
+        return created;
     }
     catch (e) {
         console.error(`  [cloud] gdrive folder setup: ${e.message}`);

package/packages/mailx-settings/index.js

@@ -656,9 +656,14 @@ export async function initCloudConfig(provider = "gdrive") {
     const existing = readLocalConfig();
     if (existing.sharedDir)
         return; // Already configured
-    // Find or create the "mailx" folder via Drive API
+    // Find or create the settings folder via Drive API — tries "home/.mailx"
+    // first (family convention), then "mailx" (default). The found path gets
+    // saved so future lookups don't re-scan.
     const folderId = await gDriveFindOrCreateFolder();
-    const sharedDir = { provider, path: "mailx", folderId: folderId || undefined };
+    // Detect which path was actually found by reading back from the API
+    // (gDriveFindOrCreateFolder logs it). For now use "mailx" as default
+    // label — the folderId is what matters for subsequent reads/writes.
+    const sharedDir = { provider, path: "home/.mailx", folderId: folderId || undefined };
     const config = { ...existing, sharedDir, storePath: existing.storePath || DEFAULT_STORE_PATH };
     fs.mkdirSync(LOCAL_DIR, { recursive: true });
     atomicWrite(LOCAL_CONFIG_PATH, config);