kasy-cli 1.2.1

package/lib/commands/docs.js

@@ -0,0 +1,47 @@
+const path = require('node:path');
+const { exec } = require('node:child_process');
+const fs = require('fs-extra');
+const kleur = require('kleur');
+const { createTranslator, detectDefaultLanguage } = require('../utils/i18n');
+
+const DOCS_FILE = path.join(__dirname, '..', '..', 'docs', 'cli-reference.md');
+
+function openInBrowser(url) {
+  const cmd = process.platform === 'darwin'
+    ? `open "${url}"`
+    : process.platform === 'win32'
+      ? `start "" "${url}"`
+      : `xdg-open "${url}"`;
+  exec(cmd);
+}
+
+async function runDocs(options = {}) {
+  const t = createTranslator(options.language || detectDefaultLanguage());
+
+  console.log(kleur.bold(`\n  Kasy CLI — Documentação\n`));
+
+  // Show local CLI reference
+  if (await fs.pathExists(DOCS_FILE)) {
+    const content = await fs.readFile(DOCS_FILE, 'utf8');
+    // Show the first section (commands overview)
+    const lines = content.split('\n').slice(0, 60);
+    console.log(kleur.dim(lines.join('\n')));
+    console.log(kleur.dim(`\n  ... (arquivo completo: ${DOCS_FILE})\n`));
+  }
+
+  console.log(kleur.cyan(`  Comandos disponíveis:`));
+  console.log(`    ${kleur.bold('kasy new')}       — Criar novo projeto`);
+  console.log(`    ${kleur.bold('kasy add')}       — Adicionar módulo`);
+  console.log(`    ${kleur.bold('kasy doctor')}    — Verificar ambiente`);
+  console.log(`    ${kleur.bold('kasy run')}       — Executar app`);
+  console.log(`    ${kleur.bold('kasy deploy')}    — Deploy do projeto`);
+  console.log(`    ${kleur.bold('kasy ios')}       — Release iOS (configure / release / build)`);
+  console.log(`    ${kleur.bold('kasy codemagic')} — Build iOS na nuvem`);
+  console.log(`    ${kleur.bold('kasy features')}   — Listar features`);
+  console.log(`    ${kleur.bold('kasy validate')}  — Validar projeto`);
+  console.log('');
+  console.log(kleur.dim(`  Para detalhes de um comando: kasy help <comando>`));
+  console.log('');
+}
+
+module.exports = { runDocs };

package/lib/commands/doctor.js

@@ -0,0 +1,227 @@
+const path = require('node:path');
+const fs = require('fs-extra');
+const kleur = require('kleur');
+const { createTranslator, detectDefaultLanguage } = require('../utils/i18n');
+const {
+  getBaseChecks,
+  getPlatformChecks,
+  getBackendChecks,
+  runChecks,
+  hasRequiredFailures
+} = require('../utils/checks');
+const {
+  validateAppleSetup,
+  iosReleaseDocPath,
+  isKasyFlutterProject,
+  checkIosSigning,
+} = require('../utils/apple-release');
+const { validateCodemagicSetup, codemagicReleaseDocPath } = require('../utils/codemagic-release');
+const { validateGoogleIosUrlScheme, validateAppleSignInEntitlement, validateFacebookInfoPlist, validateFacebookAndroidStrings, validateRevenueCat } = require('../scaffold/shared/post-build');
+
+function collectOptionalBackendChecks() {
+  return [
+    ...getBackendChecks('firebase'),
+    ...getBackendChecks('supabase')
+  ];
+}
+
+/**
+ * Reconstruct active modules from kit_setup.json flags + features.dart.
+ */
+async function getActiveModules(kitSetup, projectDir) {
+  const modules = [];
+  if (kitSetup.useSentry) modules.push('sentry');
+  if (kitSetup.analyticsProvider === 'mixpanel') modules.push('analytics');
+  if (kitSetup.withFacebookPixel) modules.push('facebook');
+  if (kitSetup.subscriptionModule) modules.push('revenuecat');
+  if (kitSetup.withOnboarding) modules.push('onboarding');
+  if (kitSetup.webCompat) modules.push('web');
+  if (kitSetup.feedbackModule) modules.push('feedback');
+
+  // Read features.dart for llm_chat, widget
+  const featuresPath = path.join(projectDir, 'lib', 'core', 'config', 'features.dart');
+  if (await fs.pathExists(featuresPath)) {
+    const content = await fs.readFile(featuresPath, 'utf8');
+    if (/const bool withLlmChat\s*=\s*true/.test(content)) modules.push('llm_chat');
+  }
+
+  // Check ci by directory
+  if (await fs.pathExists(path.join(projectDir, '.github', 'workflows'))) modules.push('ci');
+
+  return modules;
+}
+
+async function runProjectChecks(projectDir, t, options = {}) {
+  const kitSetupPath = path.join(projectDir, 'kit_setup.json');
+  if (!(await fs.pathExists(kitSetupPath))) return;
+
+  let config;
+  try {
+    config = await fs.readJson(kitSetupPath);
+  } catch {
+    return;
+  }
+
+  console.log(kleur.bold(`\n${t('doctor.project.title')}`));
+
+  console.log(`  ${kleur.green('✓')} ${t('doctor.project.appName')}: ${kleur.cyan(config.appName || '—')}`);
+  console.log(`  ${kleur.green('✓')} ${t('doctor.project.backend')}: ${kleur.cyan(config.backendProvider || '—')}`);
+  console.log(`  ${kleur.green('✓')} ${t('doctor.project.bundleId')}: ${kleur.dim(config.bundleId || '—')}`);
+
+  // pub get check
+  const lockExists = await fs.pathExists(path.join(projectDir, 'pubspec.lock'));
+  if (lockExists) {
+    console.log(`  ${kleur.green('✓')} ${t('doctor.project.pubGet')}`);
+  } else {
+    console.log(`  ${kleur.yellow('⚠')} ${t('doctor.project.pubGetMissing')}`);
+  }
+
+  // Active modules
+  const modules = await getActiveModules(config, projectDir);
+  if (modules.length > 0) {
+    console.log(`  ${kleur.green('✓')} ${t('doctor.project.modules')}: ${kleur.cyan(modules.join(', '))}`);
+  } else {
+    console.log(`  ${kleur.dim('–')} ${t('doctor.project.noModules')}`);
+  }
+
+  await runIosReleaseChecks(projectDir, t, options.language, config);
+  await runRevenueCatChecks(projectDir, t, config);
+}
+
+async function runIosReleaseChecks(projectDir, t, language, config = {}) {
+  if (!(await isKasyFlutterProject(projectDir))) return;
+
+  const lang = language || detectDefaultLanguage();
+  console.log(kleur.bold(`\n${t('doctor.ios.title')}`));
+
+  if (process.platform !== 'darwin') {
+    console.log(`  ${kleur.yellow('⚠')} ${t('doctor.ios.notMac')}`);
+  } else {
+    const signing = await checkIosSigning(projectDir);
+    if (signing.ok) {
+      console.log(`  ${kleur.green('✓')} ${t('doctor.ios.signingOk')}`);
+    } else {
+      console.log(`  ${kleur.yellow('⚠')} ${t('doctor.ios.signingMissing')}`);
+    }
+  }
+
+  const googleScheme = await validateGoogleIosUrlScheme(projectDir);
+  if (googleScheme.skipped) {
+    console.log(`  ${kleur.dim('–')} ${t('doctor.ios.googleUrlSchemeSkipped')}`);
+  } else if (googleScheme.ok) {
+    console.log(`  ${kleur.green('✓')} ${t('doctor.ios.googleUrlSchemeOk')}`);
+  } else {
+    console.log(`  ${kleur.red('✗')} ${t('doctor.ios.googleUrlSchemeMissing')}`);
+    console.log(kleur.dim(`     ${googleScheme.error}`));
+  }
+
+  const appleEntitlement = await validateAppleSignInEntitlement(projectDir);
+  if (appleEntitlement.ok) {
+    console.log(`  ${kleur.green('✓')} ${t('doctor.ios.appleSignInEntitlementOk')}`);
+  } else {
+    console.log(`  ${kleur.yellow('⚠')} ${t('doctor.ios.appleSignInEntitlementMissing')}`);
+    console.log(kleur.dim(`     ${appleEntitlement.error}`));
+  }
+
+  if (config.withFacebookPixel) {
+    const facebook = await validateFacebookInfoPlist(projectDir);
+    if (facebook.skipped) {
+      console.log(`  ${kleur.dim('–')} ${t('doctor.ios.facebookSkipped')}`);
+    } else if (facebook.ok) {
+      console.log(`  ${kleur.green('✓')} ${t('doctor.ios.facebookOk')}`);
+    } else {
+      console.log(`  ${kleur.yellow('⚠')} ${t('doctor.ios.facebookPlaceholders')}`);
+      console.log(kleur.dim(`     ${facebook.error}`));
+    }
+
+    const facebookAndroid = await validateFacebookAndroidStrings(projectDir);
+    if (!facebookAndroid.skipped) {
+      if (facebookAndroid.ok) {
+        console.log(`  ${kleur.green('✓')} ${t('doctor.android.facebookOk')}`);
+      } else {
+        console.log(`  ${kleur.yellow('⚠')} ${t('doctor.android.facebookPlaceholders')}`);
+        console.log(kleur.dim(`     ${facebookAndroid.error}`));
+      }
+    }
+  }
+
+  const apple = await validateAppleSetup(projectDir);
+  if (apple.ok) {
+    console.log(`  ${kleur.green('✓')} ${t('doctor.ios.appleOk')}`);
+    console.log(`  ${kleur.green('✓')} ${t('doctor.ios.p8Ok')}`);
+  } else {
+    if (apple.issues.includes('missing_env') || apple.issues.includes('missing_credentials')) {
+      console.log(`  ${kleur.yellow('⚠')} ${t('doctor.ios.appleMissing')}`);
+    }
+    if (apple.issues.includes('missing_p8')) {
+      console.log(`  ${kleur.yellow('⚠')} ${t('doctor.ios.p8Missing')}`);
+    }
+  }
+
+  const cm = await validateCodemagicSetup(projectDir);
+  if (cm.ok) {
+    console.log(`  ${kleur.green('✓')} ${t('doctor.ios.codemagicOk')}`);
+  } else if (cm.issues.includes('missing_env')) {
+    console.log(`  ${kleur.dim('–')} ${t('doctor.ios.codemagicMissing')}`);
+  }
+
+  const docPath = iosReleaseDocPath(lang);
+  console.log(`  ${kleur.dim('–')} ${t('doctor.ios.doc')}: ${docPath}, ${codemagicReleaseDocPath(lang)}`);
+}
+
+async function runRevenueCatChecks(projectDir, t, config) {
+  if (!config.subscriptionModule) return;
+
+  console.log(kleur.bold(`\n${t('doctor.revenuecat.title')}`));
+
+  const rc = await validateRevenueCat(projectDir, config);
+  if (rc.skipped) return;
+
+  if (!rc.iosEmpty && !rc.androidEmpty) {
+    console.log(`  ${kleur.green('✓')} ${t('doctor.revenuecat.keysOk')}`);
+  } else {
+    console.log(`  ${kleur.yellow('⚠')} ${t('doctor.revenuecat.keysEmpty')}`);
+  }
+
+  if (rc.bothTest) {
+    console.log(`  ${kleur.yellow('⚠')} ${t('doctor.revenuecat.keysTest')}`);
+  }
+
+  if (rc.webhookUrl) {
+    console.log(`  ${kleur.green('✓')} ${t('doctor.revenuecat.webhookUrlSupabase')}:`);
+    console.log(kleur.cyan(`     ${rc.webhookUrl}`));
+  } else if (config.backendProvider === 'firebase' || config.firebaseProjectId) {
+    console.log(`  ${kleur.dim('–')} ${t('doctor.revenuecat.webhookUrlFirebase')}`);
+  }
+}
+
+async function runDoctor(options = {}) {
+  const language = options.language || detectDefaultLanguage();
+  const t = createTranslator(language);
+  const projectDir = path.resolve(options.directory || '.');
+  console.log(kleur.bold(`\n${t('doctor.title')}\n`));
+
+  // Project-specific checks (only when inside a kasy project)
+  await runProjectChecks(projectDir, t, { language });
+
+  const baseResults = await runChecks(
+    [...getBaseChecks(), ...getPlatformChecks()],
+    t('doctor.baseEnvironment'),
+    { t }
+  );
+
+  const optionalBackend = collectOptionalBackendChecks();
+  if (optionalBackend.length > 0) {
+    await runChecks(optionalBackend, t('doctor.optionalBackend'), { t });
+  }
+
+  if (hasRequiredFailures(baseResults)) {
+    throw new Error(t('doctor.requiredMissing'));
+  }
+
+  console.log(kleur.green(`\n${t('doctor.requiredPassed')}`));
+}
+
+module.exports = {
+  runDoctor
+};

package/lib/commands/features.js

@@ -0,0 +1,36 @@
+const kleur = require('kleur');
+const { createTranslator, detectDefaultLanguage } = require('../utils/i18n');
+const {
+  AVAILABLE_BACKENDS,
+  getVisibleFeatures
+} = require('../scaffold/catalog');
+
+const KASY_AUDIENCE = process.env.KASY_INTERNAL === '1' ? 'internal' : 'public';
+
+function runFeatures(options = {}) {
+  const t = createTranslator(options.language || detectDefaultLanguage());
+  console.log(kleur.bold(`\n${t('modules.backends')}\n`));
+  for (const backend of AVAILABLE_BACKENDS) {
+    console.log(
+      `${kleur.green('✓')} ${kleur.white(backend.id)} - ${kleur.gray(
+        t(`modules.backend.${backend.id}.description`)
+      )}`
+    );
+  }
+
+  console.log(kleur.bold(`\n${t('modules.features')}\n`));
+  for (const feature of getVisibleFeatures({ audience: KASY_AUDIENCE })) {
+    const badge = feature.status === 'internal' ? kleur.yellow(' [beta]') : '';
+    console.log(
+      `${kleur.cyan('•')} ${kleur.white(feature.id)}${badge} - ${kleur.gray(
+        t(`modules.feature.${feature.id}.description`)
+      )}`
+    );
+  }
+  console.log('');
+}
+
+module.exports = {
+  runFeatures,
+  AVAILABLE_MODULES: AVAILABLE_BACKENDS
+};

package/lib/commands/ios.js

@@ -0,0 +1,206 @@
+'use strict';
+
+const path = require('node:path');
+const fs = require('fs-extra');
+const kleur = require('kleur');
+const prompts = require('prompts');
+const { createTranslator, detectDefaultLanguage } = require('../utils/i18n');
+const {
+  isKasyFlutterProject,
+  readBundleId,
+  applePrivateKeyPath,
+  validateAppleSetup,
+  writeAppleEnv,
+  installPrivateKey,
+  openUrl,
+  iosReleaseDocPath,
+  runReleaseScript,
+  checkIosSigning,
+  checkDiskSpaceForIosBuild,
+  isXcodeCacheBuildError,
+  printBuildFailureHints,
+  runIosClean,
+  MIN_DISK_GB_FOR_IOS_BUILD,
+  URL_APP_STORE_CONNECT_APPS,
+  URL_APP_STORE_CONNECT_API,
+} = require('../utils/apple-release');
+const { validateGoogleIosUrlScheme } = require('../scaffold/shared/post-build');
+
+async function assertProject(projectDir, t) {
+  if (!(await isKasyFlutterProject(projectDir))) {
+    throw new Error(t('ios.error.notProject'));
+  }
+}
+
+async function runConfigure(directory, options = {}) {
+  const t = createTranslator(options.language || detectDefaultLanguage());
+  const projectDir = path.resolve(directory || '.');
+
+  await assertProject(projectDir, t);
+
+  const bundleId = await readBundleId(projectDir);
+  console.log(kleur.bold(`\n${t('ios.configure.title')}\n`));
+  if (bundleId) {
+    console.log(`  ${t('ios.configure.bundleId')}: ${kleur.cyan(bundleId)}`);
+  }
+  console.log(kleur.dim(`  ${t('ios.configure.doc')}: ${iosReleaseDocPath(options.language || detectDefaultLanguage())}\n`));
+
+  console.log(kleur.cyan(t('ios.configure.openingLinks')));
+  openUrl(URL_APP_STORE_CONNECT_API);
+  openUrl(URL_APP_STORE_CONNECT_APPS);
+
+  const response = await prompts(
+    [
+      {
+        type: 'text',
+        name: 'apiKey',
+        message: t('ios.configure.q.apiKey'),
+        validate: (v) => (v && v.trim().length > 0 ? true : t('ios.configure.q.required')),
+      },
+      {
+        type: 'text',
+        name: 'issuerId',
+        message: t('ios.configure.q.issuerId'),
+        validate: (v) => (v && v.trim().length > 0 ? true : t('ios.configure.q.required')),
+      },
+      {
+        type: 'text',
+        name: 'p8Path',
+        message: t('ios.configure.q.p8Path'),
+        validate: async (v) => {
+          if (!v || !v.trim()) return t('ios.configure.q.required');
+          const resolved = path.resolve(v.trim().replace(/^~/, process.env.HOME || ''));
+          if (!(await fs.pathExists(resolved))) return t('ios.configure.q.p8NotFound');
+          return true;
+        },
+      },
+      {
+        type: 'text',
+        name: 'appId',
+        message: t('ios.configure.q.appId'),
+        initial: '',
+      },
+    ],
+    { onCancel: () => { throw new Error(t('ios.configure.cancelled')); } }
+  );
+
+  const apiKey = response.apiKey.trim();
+  const issuerId = response.issuerId.trim();
+  const p8Source = path.resolve(response.p8Path.trim().replace(/^~/, process.env.HOME || ''));
+
+  const destPath = await installPrivateKey(p8Source, apiKey);
+  await writeAppleEnv(projectDir, {
+    apiKey,
+    issuerId,
+    appId: response.appId?.trim() || '',
+  });
+
+  console.log(kleur.green(`\n✓ ${t('ios.configure.success')}`));
+  console.log(kleur.dim(`  ${t('ios.configure.p8Installed')}: ${destPath}`));
+  console.log(kleur.cyan(`\n  ${t('ios.configure.next')}: kasy ios release\n`));
+}
+
+async function runBuildOrRelease(directory, options = {}, mode) {
+  const t = createTranslator(options.language || detectDefaultLanguage());
+  const projectDir = path.resolve(directory || '.');
+
+  await assertProject(projectDir, t);
+
+  if (mode === 'release' && process.platform !== 'darwin') {
+    console.log(kleur.yellow(`\n${t('ios.error.notMac')}`));
+    console.log(kleur.cyan(`  ${t('ios.error.useCodemagic')}: kasy codemagic configure\n`));
+    process.exitCode = 1;
+    return;
+  }
+
+  if (process.platform === 'darwin') {
+    const signing = await checkIosSigning(projectDir);
+    if (!signing.ok) {
+      console.log(kleur.yellow(`\n⚠ ${t('ios.error.signing')}`));
+      console.log(kleur.dim(`  ${t('ios.error.signingHint')}\n`));
+      process.exitCode = 1;
+      return;
+    }
+  }
+
+  if (mode === 'release') {
+    const validation = await validateAppleSetup(projectDir);
+    if (!validation.ok) {
+      console.log(kleur.red(`\n✗ ${t('ios.error.notConfigured')}\n`));
+      if (validation.issues.includes('missing_env')) {
+        console.log(kleur.dim(`  ${t('ios.error.runConfigure')}\n`));
+      }
+      process.exitCode = 1;
+      return;
+    }
+  }
+
+  const googleScheme = await validateGoogleIosUrlScheme(projectDir);
+  if (!googleScheme.ok) {
+    console.log(kleur.red(`\n✗ ${t('ios.error.googleUrlScheme')}\n`));
+    console.log(kleur.dim(`  ${googleScheme.error}`));
+    console.log(kleur.cyan(`  ${t('ios.error.googleUrlSchemeHint')}\n`));
+    process.exitCode = 1;
+    return;
+  }
+
+  const args = [];
+  if (options.noBump) args.push('--no-bump');
+  if (options.versionName) args.push('--version-name', options.versionName);
+  if (mode === 'build') args.push('--no-upload');
+
+  if (process.platform === 'darwin') {
+    const disk = await checkDiskSpaceForIosBuild(projectDir);
+    if (!disk.ok && disk.freeGb !== null) {
+      console.log(
+        kleur.yellow(
+          `\n⚠ ${t('ios.warn.lowDisk', { gb: disk.freeGb, min: MIN_DISK_GB_FOR_IOS_BUILD })}\n`
+        )
+      );
+    }
+  }
+
+  console.log(kleur.bold(`\n${mode === 'build' ? t('ios.build.title') : t('ios.release.title')}\n`));
+
+  try {
+    await runReleaseScript(projectDir, args, t);
+    console.log(kleur.green(`\n✓ ${mode === 'build' ? t('ios.build.success') : t('ios.release.success')}\n`));
+  } catch (err) {
+    const output = err.buildOutput || err.message;
+    console.error(kleur.red(`\n✗ ${output.slice(-4000)}\n`));
+    if (isXcodeCacheBuildError(output)) {
+      printBuildFailureHints(t, projectDir);
+    }
+    process.exitCode = 1;
+  }
+}
+
+async function runClean(directory, options = {}) {
+  const t = createTranslator(options.language || detectDefaultLanguage());
+  const projectDir = path.resolve(directory || '.');
+
+  await assertProject(projectDir, t);
+
+  if (process.platform !== 'darwin') {
+    console.log(kleur.yellow(`\n${t('ios.clean.notMac')}\n`));
+    process.exitCode = 1;
+    return;
+  }
+
+  console.log(kleur.bold(`\n${t('ios.clean.title')}\n`));
+  try {
+    await runIosClean(projectDir, t);
+    console.log(kleur.green(`\n✓ ${t('ios.clean.success')}\n`));
+    console.log(kleur.cyan(`  ${t('ios.configure.next')}: kasy ios release\n`));
+  } catch (err) {
+    console.error(kleur.red(`\n✗ ${err.message}\n`));
+    process.exitCode = 1;
+  }
+}
+
+module.exports = {
+  runConfigure,
+  runBuild: (dir, opts) => runBuildOrRelease(dir, opts, 'build'),
+  runRelease: (dir, opts) => runBuildOrRelease(dir, opts, 'release'),
+  runClean,
+};