kasy-cli 1.2.1

package/README.md

@@ -0,0 +1,56 @@
+# kasy
+
+CLI for scaffolding production-ready Flutter SaaS apps.
+
+## Install
+
+```bash
+npm install -g @aicrus.io/kasy
+```
+
+Or run without installing:
+
+```bash
+npx @aicrus.io/kasy new
+```
+
+## Quick start
+
+```bash
+kasy new my-app
+```
+
+The wizard will ask for your app name, bundle ID, and backend. A complete Flutter project is generated and ready to run.
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `kasy new [dir]` | Create a new Flutter SaaS project |
+| `kasy add <module>` | Add a feature to an existing project |
+| `kasy remove <module>` | Remove a feature |
+| `kasy doctor` | Check your environment (Flutter, Node, CLIs) |
+| `kasy features` | List available backends and modules |
+| `kasy deploy [dir]` | Deploy backend (Firebase Functions / Supabase) |
+| `kasy ios release [dir]` | Build and release to the App Store |
+| `kasy run [dir]` | Run the app on a device or simulator |
+
+## Backends
+
+- **Firebase** — Firestore, Cloud Functions, Google Sign-In
+- **Supabase** — PostgreSQL, Edge Functions, RLS policies
+- **API REST** — Express/Node.js server included
+
+## Optional modules
+
+`sentry` · `analytics` · `revenuecat` · `onboarding` · `widget` · `llm_chat` · `facebook` · `local_notifications` · `feedback` · `ci`
+
+## Requirements
+
+- Node.js >= 18
+- Flutter SDK (any recent stable version)
+- Firebase CLI or Supabase CLI (depending on backend)
+
+## Languages
+
+The CLI wizard runs in **English**, **Portuguese**, or **Spanish** — detected automatically from your system locale.

package/bin/kasy.js

@@ -0,0 +1,529 @@
+#!/usr/bin/env node
+
+const { Command } = require('commander');
+const kleur = require('kleur');
+const pkg = require('../package.json');
+const { runNew } = require('../lib/commands/new');
+const { runDoctor } = require('../lib/commands/doctor');
+const { runFeatures } = require('../lib/commands/features');
+const { runValidate } = require('../lib/commands/validate');
+const { runDeployCommand } = require('../lib/commands/deploy');
+const { runCheck } = require('../lib/commands/check');
+const { runRun } = require('../lib/commands/run');
+const { runAdd } = require('../lib/commands/add');
+const { runRemove } = require('../lib/commands/remove');
+const { runUpdate } = require('../lib/commands/update');
+const { runDocs } = require('../lib/commands/docs');
+const { runNotificationsText } = require('../lib/commands/notifications');
+const {
+  runConfigure: runIosConfigure,
+  runBuild: runIosBuild,
+  runRelease: runIosRelease,
+  runClean: runIosClean,
+} = require('../lib/commands/ios');
+const {
+  runConfigure: runCodemagicConfigure,
+  runRelease: runCodemagicRelease,
+  runStatus: runCodemagicStatus,
+} = require('../lib/commands/codemagic');
+const {
+  createTranslator,
+  normalizeLanguage,
+  detectDefaultLanguage
+} = require('../lib/utils/i18n');
+const { getStoredLanguage, setStoredLanguage } = require('../lib/utils/license');
+const { promptLanguage } = require('../lib/utils/prompts');
+const { ensureLicenseKey, shouldRequireLicenseForArgv } = require('../lib/utils/license-gate');
+const { checkForUpdates } = require('../lib/utils/updates');
+
+function createLocalizedHelpConfig(t) {
+  return {
+    formatHelp(cmd, helper) {
+      const termWidth = helper.padWidth(cmd, helper);
+      const helpWidth = helper.helpWidth || 80;
+      const itemIndentWidth = 2;
+      const itemSeparatorWidth = 2;
+
+      function formatItem(term, description) {
+        if (description) {
+          const fullText = `${term.padEnd(termWidth + itemSeparatorWidth)}${description}`;
+          return helper.wrap(
+            fullText,
+            helpWidth - itemIndentWidth,
+            termWidth + itemSeparatorWidth
+          );
+        }
+
+        return term;
+      }
+
+      function formatList(textArray) {
+        return textArray.join('\n').replace(/^/gm, ' '.repeat(itemIndentWidth));
+      }
+
+      function localizeSubcommandTerm(term) {
+        return term.replace(/ \[options\]/g, ` ${t('cli.help.inline.options')}`);
+      }
+
+      const localizedUsage = helper.commandUsage(cmd).replace(
+        / \[options\]/g,
+        ` ${t('cli.help.inline.options')}`
+      );
+      let output = [`${t('cli.help.heading.usage')}: ${localizedUsage}`, ''];
+
+      const commandDescription = helper.commandDescription(cmd);
+      if (commandDescription.length > 0) {
+        output = output.concat([helper.wrap(commandDescription, helpWidth, 0), '']);
+      }
+
+      const argumentList = helper.visibleArguments(cmd).map((argument) => {
+        return formatItem(
+          helper.argumentTerm(argument),
+          helper.argumentDescription(argument)
+        );
+      });
+      if (argumentList.length > 0) {
+        output = output.concat([`${t('cli.help.heading.arguments')}:`, formatList(argumentList), '']);
+      }
+
+      const optionList = helper.visibleOptions(cmd).map((option) => {
+        return formatItem(helper.optionTerm(option), helper.optionDescription(option));
+      });
+      if (optionList.length > 0) {
+        output = output.concat([`${t('cli.help.heading.options')}:`, formatList(optionList), '']);
+      }
+
+      if (this.showGlobalOptions) {
+        const globalOptionList = helper.visibleGlobalOptions(cmd).map((option) => {
+          return formatItem(helper.optionTerm(option), helper.optionDescription(option));
+        });
+        if (globalOptionList.length > 0) {
+          output = output.concat([
+            `${t('cli.help.heading.globalOptions')}:`,
+            formatList(globalOptionList),
+            ''
+          ]);
+        }
+      }
+
+      const commandList = helper.visibleCommands(cmd).map((subcommand) => {
+        return formatItem(
+          localizeSubcommandTerm(helper.subcommandTerm(subcommand)),
+          helper.subcommandDescription(subcommand)
+        );
+      });
+      if (commandList.length > 0) {
+        output = output.concat([`${t('cli.help.heading.commands')}:`, formatList(commandList), '']);
+      }
+
+      return output.join('\n');
+    }
+  };
+}
+
+function applyLocalizedHelp(command, t) {
+  command
+    .configureHelp(createLocalizedHelpConfig(t))
+    .helpOption('-h, --help', t('cli.help.optionDescription'))
+    .showHelpAfterError(t('cli.help.afterError'));
+
+  return command;
+}
+
+function buildProgram(language) {
+  const t = createTranslator(language);
+  const program = applyLocalizedHelp(new Command(), t);
+
+  const langOption = t('cli.option.lang');
+  program
+    .name('kasy')
+    .description(t('cli.description'))
+    .usage(t('cli.usage'))
+    .version(pkg.version, '-V, --version', t('cli.option.version'))
+    .option('-l, --lang <lang>', langOption);
+
+  const helpParam = t('cli.command.help.paramName');
+  program.helpCommand(`help [${helpParam}]`, t('cli.help.commandDescription'));
+  const helpCommand = program._getHelpCommand();
+  if (helpCommand) {
+    applyLocalizedHelp(helpCommand, t);
+  }
+
+  program.addHelpText('beforeAll', `${kleur.bold().cyan(t('cli.tagline'))}\n`);
+  program.addHelpText(
+    'after',
+    `\n${t('cli.help.quickStart')} ${kleur.cyan('kasy new')}\n\n${t('cli.help.more', { command: kleur.cyan(`kasy help <${helpParam}>`) })}\n`
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('new')
+      .argument('[directory]', 'Target folder (default: asks during setup)', '.')
+      .option('-b, --backend <backend>', t('cli.command.setup.backendOption'))
+      .option('--with <features>', t('cli.command.setup.featuresOption'))
+      .option('--yes', 'Skip interactive questions — Quick mode with Starter preset')
+      .option('-p, --project <id>', 'Firebase Project ID (used with --yes)')
+      .description(t('cli.command.new.description'))
+      .action(async (directory, options) => {
+        await runNew(directory, { language, backend: options.backend, withModules: options.with, yes: options.yes, project: options.project });
+      }),
+    t
+  );
+
+  const directoryName = t('cli.command.setup.directoryName');
+  const langName = t('cli.command.setup.langName');
+  applyLocalizedHelp(
+    program
+      .command('setup')
+      .argument(`[${directoryName}]`, t('cli.command.setup.directoryArg'), '.')
+      .option(`-l, --lang <${langName}>`, t('cli.command.setup.langOption'))
+      .option('-b, --backend <backend>', t('cli.command.setup.backendOption'))
+      .option('--with <features>', t('cli.command.setup.featuresOption'))
+      .description(t('cli.command.setup.description'))
+      .action(async (directory, options) => {
+        // `setup` is an alias for `new` — unified flow
+        await runNew(directory, {
+          language: options.lang,
+          backend: options.backend,
+          withModules: options.with,
+        });
+      }),
+    t
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('doctor')
+      .description(t('cli.command.doctor.description'))
+      .action(async () => {
+        await runDoctor({ language });
+      }),
+    t
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('features')
+      .description(t('cli.command.modules.description'))
+      .action(() => {
+        runFeatures({ language });
+      }),
+    t
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('version')
+      .description(t('cli.command.version.description'))
+      .action(() => {
+        console.log(pkg.version);
+      }),
+    t
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('validate')
+      .option('--analyze-only', t('cli.command.validate.analyzeOnlyOption'))
+      .description(t('cli.command.validate.description'))
+      .action(async (options) => {
+        await runValidate({ language, analyzeOnly: Boolean(options.analyzeOnly) });
+      }),
+    t
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('deploy')
+      .argument('[directory]', 'Project folder (default: current directory)', '.')
+      .option('-p, --project <id>', 'Firebase Project ID')
+      .description(t('cli.command.deploy.description'))
+      .action(async (directory, options) => {
+        await runDeployCommand(directory, { project: options.project }, { language });
+      }),
+    t
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('check')
+      .argument('[directory]', 'Project folder (default: current directory)', '.')
+      .option('--fix', 'Auto-fix missing configuration (generate FCM key, deploy missing functions)')
+      .description(t('cli.command.check.description'))
+      .action(async (directory, options) => {
+        await runCheck({ directory: directory || '.', fix: Boolean(options.fix), language });
+      }),
+    t
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('run')
+      .argument('[directory]', 'Project folder (default: current directory)', '.')
+      .option('--ios', 'Run on iOS simulator/device')
+      .option('--android', 'Run on Android emulator/device')
+      .option('--web', 'Run on Chrome (web)')
+      .option('-d, --device <id>', 'Run on specific device ID')
+      .option('--prod', 'Use production dart-defines (from launch.json)')
+      .option('--no-defines', 'Skip dart-defines from launch.json')
+      .description(t('cli.command.run.description'))
+      .action(async (directory, options) => {
+        await runRun(directory, { language, ...options });
+      }),
+    t
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('add')
+      .argument('[module]', 'Module to add (e.g. sentry, analytics, revenuecat, onboarding, camera, ci...)')
+      .option('--list', 'List all available modules and their current status')
+      .option('--yes', 'Skip interactive prompts (use placeholder values)')
+      .option('-d, --directory <path>', 'Project folder (default: current directory)', '.')
+      .description(t('cli.command.add.description'))
+      .action(async (module, options) => {
+        await runAdd(module, { language, ...options });
+      }),
+    t
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('remove')
+      .argument('[module]', 'Module to remove (e.g. sentry, analytics, camera, ci...)')
+      .option('--yes', 'Skip confirmation prompt')
+      .option('-d, --directory <path>', 'Project folder (default: current directory)', '.')
+      .description(t('cli.command.remove.description'))
+      .action(async (module, options) => {
+        await runRemove(module, { language, ...options });
+      }),
+    t
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('update')
+      .argument(
+        '[module]',
+        t('cli.command.update.targetArg')
+      )
+      .option('--yes', 'Skip confirmation prompt')
+      .option('-d, --directory <path>', 'Project folder (default: current directory)', '.')
+      .description(t('cli.command.update.description'))
+      .action(async (module, options) => {
+        await runUpdate(module, { language, ...options });
+      }),
+    t
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('upgrade')
+      .description(t('cli.command.upgrade.description'))
+      .action(() => {
+        const { spawnSync } = require('node:child_process');
+        console.log('\n' + kleur.cyan(t('cli.command.upgrade.running')) + '\n');
+        const result = spawnSync('npm', ['install', '-g', 'kasy-cli'], { stdio: 'inherit', shell: true });
+        if (result.status === 0) {
+          console.log('\n' + kleur.green('✓ ' + t('cli.command.upgrade.done')) + '\n');
+        } else {
+          process.exitCode = result.status ?? 1;
+        }
+      }),
+    t
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('uninstall')
+      .description(t('cli.command.uninstall.description'))
+      .action(() => {
+        const { spawnSync } = require('node:child_process');
+        console.log('\n' + kleur.cyan(t('cli.command.uninstall.running')) + '\n');
+        const result = spawnSync('npm', ['uninstall', '-g', 'kasy-cli'], { stdio: 'inherit', shell: true });
+        if (result.status === 0) {
+          console.log('\n' + kleur.green('✓ ' + t('cli.command.uninstall.done')) + '\n');
+        } else {
+          process.exitCode = result.status ?? 1;
+        }
+      }),
+    t
+  );
+
+  const iosCmd = program.command('ios').description(t('cli.command.ios.description'));
+  applyLocalizedHelp(
+    iosCmd
+      .command('configure')
+      .argument('[directory]', 'Project folder (default: current directory)', '.')
+      .description(t('cli.command.ios.configure.description'))
+      .action(async (directory) => {
+        await runIosConfigure(directory, { language });
+      }),
+    t
+  );
+  applyLocalizedHelp(
+    iosCmd
+      .command('release')
+      .argument('[directory]', 'Project folder (default: current directory)', '.')
+      .option('--no-bump', 'Do not increment build number in pubspec.yaml')
+      .option('--version-name <version>', 'Set marketing version (e.g. 1.0.1)')
+      .description(t('cli.command.ios.release.description'))
+      .action(async (directory, options) => {
+        await runIosRelease(directory, { language, noBump: Boolean(options.noBump), versionName: options.versionName });
+      }),
+    t
+  );
+  applyLocalizedHelp(
+    iosCmd
+      .command('build')
+      .argument('[directory]', 'Project folder (default: current directory)', '.')
+      .option('--no-bump', 'Do not increment build number in pubspec.yaml')
+      .option('--version-name <version>', 'Set marketing version (e.g. 1.0.1)')
+      .description(t('cli.command.ios.build.description'))
+      .action(async (directory, options) => {
+        await runIosBuild(directory, { language, noBump: Boolean(options.noBump), versionName: options.versionName });
+      }),
+    t
+  );
+  applyLocalizedHelp(
+    iosCmd
+      .command('clean')
+      .argument('[directory]', 'Project folder (default: current directory)', '.')
+      .description(t('cli.command.ios.clean.description'))
+      .action(async (directory) => {
+        await runIosClean(directory, { language });
+      }),
+    t
+  );
+
+  const codemagicCmd = program.command('codemagic').description(t('cli.command.codemagic.description'));
+  applyLocalizedHelp(
+    codemagicCmd
+      .command('configure')
+      .argument('[directory]', 'Project folder (default: current directory)', '.')
+      .description(t('cli.command.codemagic.configure.description'))
+      .action(async (directory) => {
+        await runCodemagicConfigure(directory, { language });
+      }),
+    t
+  );
+  applyLocalizedHelp(
+    codemagicCmd
+      .command('release')
+      .argument('[directory]', 'Project folder (default: current directory)', '.')
+      .description(t('cli.command.codemagic.release.description'))
+      .action(async (directory) => {
+        await runCodemagicRelease(directory, { language });
+      }),
+    t
+  );
+  applyLocalizedHelp(
+    codemagicCmd
+      .command('status')
+      .argument('[buildId]', 'Codemagic build ID')
+      .argument('[directory]', 'Project folder (default: current directory)', '.')
+      .description(t('cli.command.codemagic.status.description'))
+      .action(async (buildId, directory) => {
+        await runCodemagicStatus(buildId, directory, { language });
+      }),
+    t
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('docs')
+      .description(t('cli.command.docs.description'))
+      .action(async () => {
+        await runDocs({ language });
+      }),
+    t
+  );
+
+  const notificationsCmd = program
+    .command('notifications')
+    .description(t('cli.command.notifications.description'));
+  applyLocalizedHelp(
+    notificationsCmd
+      .command('text')
+      .argument('[directory]', 'Project folder (default: current directory)', '.')
+      .option('-d, --directory <path>', 'Project folder (default: current directory)')
+      .option('--locale <code>', 'i18n files to update: pt, en, es, or all (default: all)', 'all')
+      .option('--demo-title <text>', 'Home → Features demo notification title')
+      .option('--demo-body <text>', 'Home → Features demo card description / instant notification body')
+      .option('--reminder-title <text>', 'Scheduled reminder notification title (Settings → Reminders)')
+      .option('--reminder-body <text>', 'Scheduled reminder notification body')
+      .description(t('cli.command.notifications.text.description'))
+      .action(async (directory, options) => {
+        const dir = options.directory || directory || '.';
+        await runNotificationsText(dir, {
+          language,
+          directory: dir,
+          lang: options.locale,
+          demoTitle: options.demoTitle,
+          demoBody: options.demoBody,
+          reminderTitle: options.reminderTitle,
+          reminderBody: options.reminderBody,
+        });
+      }),
+    t
+  );
+
+  return program;
+}
+
+function resolveLanguageFromArgv(argv) {
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+
+    if (arg === '--lang' || arg === '-l') {
+      return normalizeLanguage(argv[i + 1]);
+    }
+
+    if (arg.startsWith('--lang=')) {
+      return normalizeLanguage(arg.split('=')[1]);
+    }
+  }
+
+  return null;
+}
+
+async function resolveLanguage(argv) {
+  const fromArgv = resolveLanguageFromArgv(argv);
+  if (fromArgv) return fromArgv;
+
+  const fromEnv = normalizeLanguage(process.env.KASY_CLI_LANG);
+  if (fromEnv) return fromEnv;
+
+  const stored = getStoredLanguage();
+  if (stored) return stored;
+
+  if (process.stdin.isTTY) {
+    const detected = detectDefaultLanguage();
+    const t = createTranslator(detected);
+    console.log('');
+    console.log(kleur.bold().cyan(`  ${t('welcome.firstRun')}`));
+    console.log(kleur.gray(`  ${t('welcome.chooseLanguage')}`));
+    console.log('');
+    const chosen = await promptLanguage(null);
+    setStoredLanguage(chosen);
+    return chosen;
+  }
+
+  return detectDefaultLanguage();
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+  const language = await resolveLanguage(argv);
+  if (shouldRequireLicenseForArgv(argv)) {
+    await ensureLicenseKey({ language });
+  }
+  await checkForUpdates();
+  const program = buildProgram(language);
+  await program.parseAsync([process.argv[0], process.argv[1], ...argv]);
+}
+
+main().catch((error) => {
+  console.error(kleur.red(`\n✗ ${error.message}`));
+  process.exitCode = 1;
+});