QuickAdd TogglManager Plugin Integration - Update for Different Workspaces

[Tentaskyr]

Have to say thanks a lot for the TogglManagaer, it was almost exactly what I wanted but I also wanted to swap between workspaces so I adjusted with the help of ChatGPT ... and wanted to share for those who might want the same option. I got it working well enough for myself, but probably not as elegant as someone more experiences in javascript is .. so feel free to clean up as you wish.

// Toggl Manager with Workspace Switching (QuickAdd Macro)
// - Chooses workspace → project → task label
// - Fetches projects for the selected workspace live via Toggl v9 API
// - Starts a running timer in that exact workspace (bypasses plugin's default workspace)

let togglApi;
let quickAddApi;
let workspaces; // array from Toggl (all workspaces the token can access)

const BACK = "<- Back>";

// ---------------------------
// MENU CONFIG (edit to taste)
// ---------------------------
const menu = {
  "🤴 Personal": {
    togglWorkspaceName: "Personal",
    menuOptions: {
      "🧠 Learning & Skill Development": {
        togglProjectName: "Learning & Skill Development",
        PmenuOptions: {
          "✍ Note Making": "Note Making",
          "🃏 Spaced Repetition": "Spaced Repetition",
          "📖 Read Later Processing": "Read Later Processing",
        }
      },
      "🤴 Personal": {
        togglProjectName: "Personal",
        PmenuOptions: {
          "🏋️‍♂️ Exercise": "Exercise",
          "🧹 Chores": "Chores",
          "🌀 Weekly Review": "Weekly Review",
          "📆 Monthly Review": "Monthly Review",
          "✔ Planning": "Planning",
        }
      }
    }
  },
  "💼 Work": {
    togglWorkspaceName: "Work",
    menuOptions: {
      "👨‍🎓 Project1": {
        togglProjectName: "Project1",
        PmenuOptions: {
          "✨ Quality Check": "Quality Check Senate",
          "🔨 Fix QA Problems": "Resolve QA Issues",
          "🗃️ Ensure files are loaded": "Confirm Notes are on database",
        }
      },
      "📖 Project2": {
        togglProjectName: "Project2",
        PmenuOptions: {
          "🔍 Scoping": "Scoping",
          "🖨️ Scanning": "Scanning Material",
          "✨ Quality checking": "Quality Checking Scans",
        }
      }
    }
  }
};

// ---------------------------
// ENTRY POINT
// ---------------------------
module.exports = async function togglManager(params) {
  // Obsidian Toggl plugin manager (used just to load workspaces)
  togglApi = params.app.plugins.plugins["obsidian-toggl-integration"].toggl._apiManager;
  quickAddApi = params.quickAddApi;

  // Load all workspaces the token can access (safe to do once)
  workspaces = await togglApi.getWorkspaces();

  await openWorkspaceMenu(menu);
};

// ---------------------------
/* DIRECT v9 API HELPERS (bypass plugin workspace lock) */
// ---------------------------
function getPluginAndToken() {
  const plugin = app.plugins.plugins["obsidian-toggl-integration"];
  const token = plugin?.settings?.apiToken;
  return { plugin, token };
}

function authHeader() {
  const { token } = getPluginAndToken();
  return token ? `Basic ${btoa(`${token}:api_token`)}` : null;
}

// Fetch projects for a specific workspace from Toggl v9 API
async function fetchProjectsForWorkspace(wid, { includeArchived = false } = {}) {
  const auth = authHeader();
  if (!auth) {
    new Notice("Toggl API token not found in plugin settings.");
    return [];
  }
  const url = `https://api.track.toggl.com/api/v9/workspaces/${encodeURIComponent(wid)}/projects`;
  const res = await fetch(url, { headers: { Authorization: auth } });
  if (!res.ok) {
    const msg = await res.text();
    new Notice(`Toggl error loading projects: ${res.status} ${msg}`);
    return [];
  }
  let list = await res.json();
  if (!Array.isArray(list)) return [];
  if (!includeArchived) list = list.filter(p => !p.archived);
  return list;
}

// Start a running timer directly against v9 (respects workspace_id you pass)
async function startTimerDirect(description, wid, pid) {
  const { plugin, token } = getPluginAndToken();
  if (!token) {
    new Notice("Toggl API token not found in plugin settings.");
    return;
  }

  // Coerce to numbers to avoid type errors on their side
  const WID = Number(wid);
  const PID = Number(pid);

  const auth = `Basic ${btoa(`${token}:api_token`)}`;
  const nowISO = new Date().toISOString();
  const nowUnix = Math.floor(Date.now() / 1000);

  const url = `https://api.track.toggl.com/api/v9/workspaces/${encodeURIComponent(WID)}/time_entries`;

  const payload = {
    description: String(description || ""),
    project_id: PID,
    workspace_id: WID,         // redundant (wid is also in path), but harmless
    start: nowISO,
    duration: -nowUnix,        // negative = running timer
    stop: null,
    created_with: "Obsidian QuickAdd" // <-- add this; some backends require it
  };

  const res = await fetch(url, {
    method: "POST",
    headers: {
      Authorization: auth,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(payload)
  });

  // Best-possible diagnostics: show exact server error text
  if (!res.ok) {
    const text = await res.text();
    // Try to parse JSON error (v9 often returns JSON), else show raw text
    let reason = text;
    try {
      const j = JSON.parse(text);
      reason = JSON.stringify(j);
    } catch (_) {}
    new Notice(
      `Toggl start error ${res.status}: ${reason}\n` +
      `WID=${WID}, PID=${PID}, start=${nowISO}`
    );
    return;
  }

  // Success message (optional)
  try {
    const entry = await res.json();
    new Notice(`Timer started: "${description}" → pid ${PID} (wid ${WID})`);
  } catch {
    new Notice(`Timer started: "${description}"`);
  }
}


// ---------------------------
// MENUS
// ---------------------------
/** 1) Choose workspace (menu section) */
async function openWorkspaceMenu(menuConfig) {
  const { suggester } = quickAddApi;
  const options = Object.keys(menuConfig);
  const choice = await suggester(options, options);
  if (!choice) return;

  const wsConfig = menuConfig[choice];
  const ws = workspaces.find(w => w.name === wsConfig.togglWorkspaceName);
  if (!ws) {
    new Notice(`Workspace "${wsConfig.togglWorkspaceName}" not found in your Toggl account.`);
    return openWorkspaceMenu(menuConfig);
  }

  const projectsForWS = await fetchProjectsForWorkspace(ws.id); // live list for this workspace
  return openProjectMenu(menuConfig, wsConfig, ws.id, projectsForWS);
}

/** 2) Choose project (by your friendly label) */
async function openProjectMenu(menuConfig, wsConfig, wid, projectsForWS) {
  const { suggester } = quickAddApi;
  const options = [...Object.keys(wsConfig.menuOptions), BACK];
  const choice = await suggester(options, options);
  if (!choice) return;

  if (choice === BACK) return openWorkspaceMenu(menuConfig);

  const projectConfig = wsConfig.menuOptions[choice];
  return openTaskMenu(menuConfig, wsConfig, projectConfig, wid, projectsForWS);
}

/** 3) Choose task label, then resolve the real project in that workspace and start timer */
async function openTaskMenu(menuConfig, wsConfig, projectConfig, wid, projectsForWS) {
  const { suggester } = quickAddApi;
  const options = [...Object.keys(projectConfig.PmenuOptions), BACK];
  const choice = await suggester(options, options);
  if (!choice) return;

  if (choice === BACK) return openProjectMenu(menuConfig, wsConfig, wid, projectsForWS);

  const entryName = projectConfig.PmenuOptions[choice];

  // Try exact name first
  let project = projectsForWS.find(p => p.name === projectConfig.togglProjectName);

  // If not found, let user pick the actual project from the live list
  if (!project) {
    const pickFrom = projectsForWS.map(p => p.name).sort((a,b)=>a.localeCompare(b));
    const header = `${projectConfig.togglProjectName} (not found) — pick actual project`;
    const picked = await suggester([header, ...pickFrom, BACK], [header, ...pickFrom, BACK]);
    if (!picked || picked === BACK) {
      new Notice("Cancelled.");
      return;
    }
    if (picked !== header) {
      project = projectsForWS.find(p => p.name === picked);
    }
    if (!project) {
      new Notice("No project selected.");
      return;
    }
  }

  await startTimerDirect(entryName, wid, project.id);
  new Notice(`Started: ${entryName} → ${project.name}`);
}

[chhoumann]

Thanks a lot for sharing this! Great idea to add workspace switching :)