Skip to content

A local-first personal finance app

2.8 KB
Raw Blame
import * as api from '@actual-app/api';
import type { Command } from 'commander';

import { withConnection } from '#connection';
import { printOutput } from '#output';
import { parseBoolFlag } from '#utils';

export function registerCategoryGroupsCommand(program: Command) {
  const groups = program
    .command('category-groups')
    .description('Manage category groups');

  groups
    .command('list')
    .description('List category groups (excludes hidden by default)')
    .option('--include-hidden', 'Include hidden groups and categories', false)
    .action(async cmdOpts => {
      const opts = program.opts();
      await withConnection(
        opts,
        async () => {
          const result = await api.getCategoryGroups(
            cmdOpts.includeHidden ? {} : { hidden: false },
          );
          printOutput(result, opts.format);
        },
        { mutates: false },
      );
    });

  groups
    .command('create')
    .description('Create a new category group')
    .requiredOption('--name <name>', 'Group name')
    .option('--is-income', 'Mark as income group', false)
    .action(async cmdOpts => {
      const opts = program.opts();
      await withConnection(
        opts,
        async () => {
          const id = await api.createCategoryGroup({
            name: cmdOpts.name,
            is_income: cmdOpts.isIncome,
            hidden: false,
          });
          printOutput({ id }, opts.format);
        },
        { mutates: true },
      );
    });

  groups
    .command('update <id>')
    .description('Update a category group')
    .option('--name <name>', 'New group name')
    .option('--hidden <bool>', 'Set hidden status')
    .action(async (id: string, cmdOpts) => {
      const fields: Record<string, unknown> = {};
      if (cmdOpts.name !== undefined) fields.name = cmdOpts.name;
      if (cmdOpts.hidden !== undefined) {
        fields.hidden = parseBoolFlag(cmdOpts.hidden, '--hidden');
      }
      if (Object.keys(fields).length === 0) {
        throw new Error('No update fields provided. Use --name or --hidden.');
      }
      const opts = program.opts();
      await withConnection(
        opts,
        async () => {
          await api.updateCategoryGroup(id, fields);
          printOutput({ success: true, id }, opts.format);
        },
        { mutates: true },
      );
    });

  groups
    .command('delete <id>')
    .description('Delete a category group')
    .option('--transfer-to <id>', 'Transfer transactions to this category ID')
    .action(async (id: string, cmdOpts) => {
      const opts = program.opts();
      await withConnection(
        opts,
        async () => {
          await api.deleteCategoryGroup(id, cmdOpts.transferTo);
          printOutput({ success: true, id }, opts.format);
        },
        { mutates: true },
      );
    });
}