@capawesome/cli 3.7.0-dev.3ddf02d.1764834835 → 3.7.0-dev.445ea3a.1764843317

package/dist/commands/apps/bundles/create.js

@@ -5,7 +5,7 @@ import appsService from '../../../services/apps.js';
 import authorizationService from '../../../services/authorization-service.js';
 import organizationsService from '../../../services/organizations.js';
 import { createBufferFromPath, createBufferFromReadStream, createBufferFromString, isPrivateKeyContent, } from '../../../utils/buffer.js';
-import { findCapacitorConfigPath, getLiveUpdateAppIdFromConfig, getWebDirFromConfig, } from '../../../utils/capacitor-config.js';
+import { findCapacitorConfigPath, getLiveUpdatePluginAppIdFromConfig, getLiveUpdatePluginPublicKeyFromConfig, getWebDirFromConfig, } from '../../../utils/capacitor-config.js';
 import { fileExistsAtPath, getFilesInDirectoryAndSubdirectories, isDirectory } from '../../../utils/file.js';
 import { createHash } from '../../../utils/hash.js';
 import { generateManifestJson } from '../../../utils/manifest.js';
@@ -18,9 +18,11 @@ import { defineCommand, defineOptions } from '@robingenz/zli';
 import { exec } from 'child_process';
 import consola from 'consola';
 import { createReadStream } from 'fs';
+import pathModule from 'path';
 import { hasTTY } from 'std-env';
 import { promisify } from 'util';
 import { z } from 'zod';
+// Promisified exec for running build scripts
 const execAsync = promisify(exec);
 export default defineCommand({
     description: 'Create a new app bundle.',
@@ -115,21 +117,24 @@ export default defineCommand({
             expiresAtDate.setDate(expiresAtDate.getDate() + expiresInDays);
             expiresAt = expiresAtDate.toISOString();
         }
+        // Try to auto-detect webDir from Capacitor configuration
+        const capacitorConfigPath = await findCapacitorConfigPath();
         // Check that either a path or a url is provided
         if (!path && !url) {
-            // Try to auto-detect webDir from Capacitor config
-            const capacitorConfigPath = await findCapacitorConfigPath();
+            // Try to auto-detect webDir from Capacitor configuration
             if (capacitorConfigPath) {
-                const webDir = await getWebDirFromConfig(capacitorConfigPath);
-                if (webDir) {
-                    path = webDir;
+                const webDirPath = await getWebDirFromConfig(capacitorConfigPath);
+                if (webDirPath) {
+                    const relativeWebDirPath = pathModule.relative(process.cwd(), webDirPath);
+                    consola.success(`Auto-detected web asset directory "${relativeWebDirPath}" from Capacitor configuration.`);
+                    path = webDirPath;
                 }
                 else {
-                    consola.warn('No webDir found in Capacitor config.');
+                    consola.warn('No web asset directory found in Capacitor configuration (`webDir`).');
                 }
             }
             else {
-                consola.warn('No Capacitor config found to auto-detect webDir.');
+                consola.warn('No Capacitor configuration found to auto-detect web asset directory.');
             }
             // If still no path, prompt the user
             if (!path) {
@@ -157,16 +162,16 @@ export default defineCommand({
             else {
                 const buildScript = await getBuildScript(packageJsonPath);
                 if (!buildScript) {
-                    consola.warn('No build script found in package.json.');
+                    consola.warn('No build script (`capawesome:build` or `build`) found in package.json.');
                 }
                 else if (hasTTY) {
-                    const shouldBuild = await prompt('Do you want to rebuild your web assets before creating the bundle?', {
+                    const shouldBuild = await prompt('Do you want to rebuild your web assets before proceeding?', {
                         type: 'select',
                         options: ['Yes', 'No'],
                     });
                     if (shouldBuild === 'Yes') {
                         try {
-                            consola.start(`Running ${buildScript.name} script...`);
+                            consola.start(`Running \`${buildScript.name}\` script...`);
                             const { stdout, stderr } = await execAsync(`npm run ${buildScript.name}`);
                             if (stdout) {
                                 console.log(stdout);
@@ -229,20 +234,23 @@ export default defineCommand({
             consola.error('It is not yet possible to provide a URL when creating a bundle with an artifact type of `manifest`.');
             process.exit(1);
         }
+        // Track if we found a Capacitor configuration but no app ID (for showing setup hint later)
+        let hasCapacitorConfigWithoutAppId = false;
         if (!appId) {
-            // Try to auto-detect appId from Capacitor config
-            const capacitorConfigPath = await findCapacitorConfigPath();
+            // Try to auto-detect appId from Capacitor configuration
             if (capacitorConfigPath) {
-                const configAppId = await getLiveUpdateAppIdFromConfig(capacitorConfigPath);
+                const configAppId = await getLiveUpdatePluginAppIdFromConfig(capacitorConfigPath);
                 if (configAppId) {
+                    consola.success(`Auto-detected Capawesome Cloud app ID "${configAppId}" from Capacitor configuration.`);
                     appId = configAppId;
                 }
                 else {
-                    consola.warn('No LiveUpdate appId found in Capacitor config.');
+                    hasCapacitorConfigWithoutAppId = true;
+                    consola.warn('No Capawesome Cloud app ID found in Capacitor configuration (`plugins.LiveUpdate.appId`).');
                 }
             }
             else {
-                consola.warn('No Capacitor config found to auto-detect appId.');
+                consola.warn('No Capacitor configuration found to auto-detect Capawesome Cloud app ID.');
             }
             // If still no appId, prompt the user
             if (!appId) {
@@ -297,6 +305,13 @@ export default defineCommand({
                 }
             }
         }
+        // Check if public key is configured but no private key was provided
+        if (!privateKey && capacitorConfigPath) {
+            const publicKey = await getLiveUpdatePluginPublicKeyFromConfig(capacitorConfigPath);
+            if (publicKey) {
+                consola.warn('A public key for verifying the integrity of the bundles is configured in your Capacitor configuration, but no private key has been provided for signing this bundle.');
+            }
+        }
         // Create the private key buffer
         let privateKeyBuffer;
         if (privateKey) {
@@ -329,10 +344,11 @@ export default defineCommand({
         const appName = app.name;
         // Final confirmation before creating bundle
         if (path && hasTTY) {
-            const confirmed = await prompt(`Are you sure you want to create a bundle from path ${path} for app "${appName}"?`, {
+            const relativePath = pathModule.relative(process.cwd(), path);
+            const confirmed = await prompt(`Are you sure you want to create a bundle from path "${relativePath}" for app "${appName}" (${appId})?`, {
                 type: 'confirm',
             });
-            if (confirmed) {
+            if (!confirmed) {
                 consola.info('Bundle creation cancelled.');
                 process.exit(0);
             }
@@ -405,6 +421,11 @@ export default defineCommand({
             }
             consola.success('Bundle successfully created.');
             consola.info(`Bundle ID: ${response.id}`);
+            // Show setup hint if Capacitor configuration exists but no app ID was configured
+            if (hasCapacitorConfigWithoutAppId) {
+                console.log(); // New line for better readability
+                consola.info('To set up the Live Update SDK in your Capacitor app, run the `apps:liveupdates:setup` command.');
+            }
         }
         catch (error) {
             if (appBundleId) {

package/dist/commands/apps/bundles/create.test.js

@@ -1,6 +1,8 @@
 import { DEFAULT_API_BASE_URL } from '../../../config/consts.js';
 import authorizationService from '../../../services/authorization-service.js';
+import { findCapacitorConfigPath } from '../../../utils/capacitor-config.js';
 import { fileExistsAtPath, getFilesInDirectoryAndSubdirectories, isDirectory } from '../../../utils/file.js';
+import { findPackageJsonPath } from '../../../utils/package-json.js';
 import userConfig from '../../../utils/user-config.js';
 import consola from 'consola';
 import nock from 'nock';
@@ -15,6 +17,8 @@ vi.mock('@/utils/buffer.js');
 vi.mock('@/utils/private-key.js');
 vi.mock('@/utils/hash.js');
 vi.mock('@/utils/signature.js');
+vi.mock('@/utils/capacitor-config.js');
+vi.mock('@/utils/package-json.js');
 vi.mock('consola');
 describe('apps-bundles-create', () => {
     const mockUserConfig = vi.mocked(userConfig);
@@ -22,12 +26,16 @@ describe('apps-bundles-create', () => {
     const mockFileExistsAtPath = vi.mocked(fileExistsAtPath);
     const mockGetFilesInDirectoryAndSubdirectories = vi.mocked(getFilesInDirectoryAndSubdirectories);
     const mockIsDirectory = vi.mocked(isDirectory);
+    const mockFindCapacitorConfigPath = vi.mocked(findCapacitorConfigPath);
+    const mockFindPackageJsonPath = vi.mocked(findPackageJsonPath);
     const mockConsola = vi.mocked(consola);
     beforeEach(() => {
         vi.clearAllMocks();
         mockUserConfig.read.mockReturnValue({ token: 'test-token' });
         mockAuthorizationService.hasAuthorizationToken.mockReturnValue(true);
         mockAuthorizationService.getCurrentAuthorizationToken.mockReturnValue('test-token');
+        mockFindCapacitorConfigPath.mockResolvedValue(undefined);
+        mockFindPackageJsonPath.mockResolvedValue(undefined);
         vi.spyOn(process, 'exit').mockImplementation((code) => {
             throw new Error(`Process exited with code ${code}`);
         });
@@ -67,7 +75,11 @@ describe('apps-bundles-create', () => {
         vi.mocked(mockZip.default.isZipped).mockReturnValue(true);
         vi.mocked(mockBuffer.createBufferFromPath).mockResolvedValue(testBuffer);
         vi.mocked(mockHash.createHash).mockResolvedValue(testHash);
-        const scope = nock(DEFAULT_API_BASE_URL)
+        const appScope = nock(DEFAULT_API_BASE_URL)
+            .get(`/v1/apps/${appId}`)
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(200, { id: appId, name: 'Test App' });
+        const bundleScope = nock(DEFAULT_API_BASE_URL)
             .post(`/v1/apps/${appId}/bundles`, {
             appId,
             url: bundleUrl,
@@ -78,7 +90,8 @@ describe('apps-bundles-create', () => {
             .matchHeader('Authorization', `Bearer ${testToken}`)
             .reply(201, { id: bundleId });
         await createBundleCommand.action(options, undefined);
-        expect(scope.isDone()).toBe(true);
+        expect(appScope.isDone()).toBe(true);
+        expect(bundleScope.isDone()).toBe(true);
         expect(mockConsola.success).toHaveBeenCalledWith('Bundle successfully created.');
         expect(mockConsola.info).toHaveBeenCalledWith(`Bundle ID: ${bundleId}`);
     });
@@ -129,12 +142,17 @@ describe('apps-bundles-create', () => {
             artifactType: 'zip',
             rollout: 1,
         };
-        const scope = nock(DEFAULT_API_BASE_URL)
+        const appScope = nock(DEFAULT_API_BASE_URL)
+            .get(`/v1/apps/${appId}`)
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(200, { id: appId, name: 'Test App' });
+        const bundleScope = nock(DEFAULT_API_BASE_URL)
             .post(`/v1/apps/${appId}/bundles`)
             .matchHeader('Authorization', `Bearer ${testToken}`)
             .reply(400, { message: 'Invalid bundle data' });
         await expect(createBundleCommand.action(options, undefined)).rejects.toThrow();
-        expect(scope.isDone()).toBe(true);
+        expect(appScope.isDone()).toBe(true);
+        expect(bundleScope.isDone()).toBe(true);
     });
     it('should handle private key file path', async () => {
         const appId = 'app-123';
@@ -175,7 +193,11 @@ describe('apps-bundles-create', () => {
         vi.mocked(mockBuffer.createBufferFromString).mockReturnValue(testBuffer);
         vi.mocked(mockHash.createHash).mockResolvedValue(testHash);
         vi.mocked(mockSignature.createSignature).mockResolvedValue(testSignature);
-        const scope = nock(DEFAULT_API_BASE_URL)
+        const appScope = nock(DEFAULT_API_BASE_URL)
+            .get(`/v1/apps/${appId}`)
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(200, { id: appId, name: 'Test App' });
+        const bundleScope = nock(DEFAULT_API_BASE_URL)
             .post(`/v1/apps/${appId}/bundles`, {
             appId,
             url: bundleUrl,
@@ -187,7 +209,8 @@ describe('apps-bundles-create', () => {
             .matchHeader('Authorization', `Bearer ${testToken}`)
             .reply(201, { id: bundleId });
         await createBundleCommand.action(options, undefined);
-        expect(scope.isDone()).toBe(true);
+        expect(appScope.isDone()).toBe(true);
+        expect(bundleScope.isDone()).toBe(true);
         expect(mockConsola.success).toHaveBeenCalledWith('Bundle successfully created.');
     });
     it('should handle private key plain text content', async () => {
@@ -223,7 +246,11 @@ describe('apps-bundles-create', () => {
         vi.mocked(mockPrivateKey.formatPrivateKey).mockReturnValue('formatted-private-key');
         vi.mocked(mockHash.createHash).mockResolvedValue(testHash);
         vi.mocked(mockSignature.createSignature).mockResolvedValue(testSignature);
-        const scope = nock(DEFAULT_API_BASE_URL)
+        const appScope = nock(DEFAULT_API_BASE_URL)
+            .get(`/v1/apps/${appId}`)
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(200, { id: appId, name: 'Test App' });
+        const bundleScope = nock(DEFAULT_API_BASE_URL)
             .post(`/v1/apps/${appId}/bundles`, {
             appId,
             url: bundleUrl,
@@ -235,7 +262,8 @@ describe('apps-bundles-create', () => {
             .matchHeader('Authorization', `Bearer ${testToken}`)
             .reply(201, { id: bundleId });
         await createBundleCommand.action(options, undefined);
-        expect(scope.isDone()).toBe(true);
+        expect(appScope.isDone()).toBe(true);
+        expect(bundleScope.isDone()).toBe(true);
         expect(mockConsola.success).toHaveBeenCalledWith('Bundle successfully created.');
     });
     it('should handle private key file not found', async () => {

package/dist/commands/apps/liveupdates/setup.js

@@ -0,0 +1,274 @@
+import appsService from '../../../services/apps.js';
+import authorizationService from '../../../services/authorization-service.js';
+import organizationsService from '../../../services/organizations.js';
+import { updateCapacitorConfig } from '../../../utils/capacitor-config-writer.js';
+import { findCapacitorConfigPath, readCapacitorConfig } from '../../../utils/capacitor-config.js';
+import { copyToClipboard } from '../../../utils/clipboard.js';
+import { fileExistsAtPath } from '../../../utils/file.js';
+import { checkOpensslInstalled, generateKeyPair, readPublicKey } from '../../../utils/openssl.js';
+import { findPackageJsonPath, getCapacitorMajorVersion, isPackageInstalled } from '../../../utils/package-json.js';
+import { installPackage } from '../../../utils/package-manager.js';
+import { prompt } from '../../../utils/prompt.js';
+import { defineCommand, defineOptions } from '@robingenz/zli';
+import consola from 'consola';
+import { hasTTY } from 'std-env';
+import { z } from 'zod';
+export default defineCommand({
+    description: 'Set up Live Updates in your Capacitor app.',
+    options: defineOptions(z.object({
+        appId: z.string().uuid().optional().describe('Capawesome Cloud app ID.'),
+    })),
+    action: async (options, args) => {
+        // Check if running in interactive mode
+        if (!hasTTY) {
+            consola.error('This command requires an interactive terminal. Please run it in an interactive environment.');
+            process.exit(1);
+        }
+        let { appId } = options;
+        // Step 1: Check if Capacitor config exists
+        const capacitorConfigPath = await findCapacitorConfigPath();
+        if (!capacitorConfigPath) {
+            consola.error('No Capacitor configuration found. Make sure you are in a Capacitor project.');
+            process.exit(1);
+        }
+        // Step 2: Read current config
+        let config = await readCapacitorConfig(capacitorConfigPath);
+        if (!config) {
+            config = {};
+        }
+        // Step 3: Select/Configure Capawesome Cloud App ID
+        // Try to get from config first
+        if (!appId && config?.plugins?.LiveUpdate?.appId) {
+            appId = config.plugins.LiveUpdate.appId;
+            consola.info(`Found existing Capawesome Cloud app ID in Capacitor configuration: ${appId}`);
+        }
+        // Prompt if still not found
+        if (!appId) {
+            // Check authorization
+            if (!authorizationService.hasAuthorizationToken()) {
+                consola.error('You must be logged in. Please run the `login` command first.');
+                process.exit(1);
+            }
+            // Prompt for organization
+            const organizations = await organizationsService.findAll();
+            if (organizations.length === 0) {
+                consola.error('You must create an organization before setting up Live Updates.');
+                process.exit(1);
+            }
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            const organizationId = await prompt('Select the organization of your app:', {
+                type: 'select',
+                options: organizations.map((org) => ({
+                    label: org.name,
+                    value: org.id,
+                })),
+            });
+            if (!organizationId) {
+                consola.error('You must select an organization.');
+                process.exit(1);
+            }
+            // Prompt for app
+            const apps = await appsService.findAll({ organizationId });
+            if (apps.length === 0) {
+                consola.error('You must create an app before setting up Live Updates.');
+                process.exit(1);
+            }
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            appId = await prompt('Select your app:', {
+                type: 'select',
+                options: apps.map((app) => ({
+                    label: app.name,
+                    value: app.id,
+                })),
+            });
+            if (!appId) {
+                consola.error('You must select an app.');
+                process.exit(1);
+            }
+        }
+        if (!config?.plugins?.LiveUpdate?.appId) {
+            // Update config with app ID
+            await updateCapacitorConfig(capacitorConfigPath, {
+                plugins: {
+                    LiveUpdate: {
+                        appId,
+                    },
+                },
+            });
+            consola.success(`Updated Capacitor configuration with Capawesome Cloud app ID: ${appId}`);
+        }
+        // Step 4: Install SDK (Optional)
+        const packageJsonPath = await findPackageJsonPath();
+        let sdkInstalled = false;
+        if (packageJsonPath) {
+            sdkInstalled = await isPackageInstalled(packageJsonPath, '@capawesome/capacitor-live-update');
+            if (sdkInstalled) {
+                consola.info('Live Update SDK is already installed.');
+            }
+        }
+        if (!sdkInstalled) {
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            const shouldInstall = await prompt('Do you want to install the Live Update SDK?', {
+                type: 'confirm',
+                initial: true,
+            });
+            if (shouldInstall) {
+                // Get Capacitor version to install matching plugin version
+                let packageName = '@capawesome/capacitor-live-update';
+                if (packageJsonPath) {
+                    const capacitorMajorVersion = await getCapacitorMajorVersion(packageJsonPath);
+                    if (capacitorMajorVersion) {
+                        packageName = `@capawesome/capacitor-live-update@^${capacitorMajorVersion}.0.0`;
+                        consola.info(`Installing plugin version ${capacitorMajorVersion} to match Capacitor ${capacitorMajorVersion}`);
+                    }
+                }
+                // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+                const packageManager = await prompt('Select your package manager:', {
+                    type: 'select',
+                    options: [
+                        { label: 'npm', value: 'npm' },
+                        { label: 'yarn', value: 'yarn' },
+                        { label: 'pnpm', value: 'pnpm' },
+                    ],
+                });
+                await installPackage(packageName, packageManager);
+                consola.success('Live Update SDK installed successfully.');
+            }
+        }
+        // Step 5: Set Up Code Signing (Optional)
+        // Reload config to get latest updates
+        config = await readCapacitorConfig(capacitorConfigPath);
+        const hasPublicKey = !!config?.plugins?.LiveUpdate?.publicKey;
+        if (!hasPublicKey) {
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            const shouldSetupSigning = await prompt('Do you want to set up code signing? (Recommended for production, optional for testing)', {
+                type: 'confirm',
+                initial: false,
+            });
+            if (shouldSetupSigning) {
+                // Check OpenSSL
+                const hasOpenssl = await checkOpensslInstalled();
+                if (!hasOpenssl) {
+                    consola.error('OpenSSL is not installed. Please install OpenSSL to generate key pairs.');
+                    consola.info('Visit https://www.openssl.org for installation instructions.');
+                    process.exit(1);
+                }
+                // Define key paths
+                const privateKeyPath = 'keypair.pem';
+                const publicKeyPath = 'publickey.crt';
+                // Check if files exist
+                const privateKeyExists = await fileExistsAtPath(privateKeyPath);
+                const publicKeyExists = await fileExistsAtPath(publicKeyPath);
+                let shouldGenerate = true;
+                if (privateKeyExists || publicKeyExists) {
+                    // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+                    const overwrite = await prompt('Key files already exist. Overwrite them?', {
+                        type: 'confirm',
+                        initial: false,
+                    });
+                    shouldGenerate = overwrite;
+                }
+                if (shouldGenerate) {
+                    // Generate keys
+                    consola.start('Generating RSA key pair...');
+                    await generateKeyPair(privateKeyPath, publicKeyPath);
+                    consola.success('Key pair generated successfully.');
+                    // Read public key
+                    const publicKey = await readPublicKey(publicKeyPath);
+                    // Update config
+                    await updateCapacitorConfig(capacitorConfigPath, {
+                        plugins: {
+                            LiveUpdate: {
+                                publicKey,
+                            },
+                        },
+                    });
+                    consola.success('Updated Capacitor configuration with public key.');
+                    // Show important instructions
+                    console.log(); // Blank line
+                    consola.box(`IMPORTANT: Keep your private key safe!\n\n` +
+                        `Private key location: ${privateKeyPath}\n` +
+                        `Public key location: ${publicKeyPath}\n\n` +
+                        `When creating bundles, use:\n` +
+                        `npx @capawesome/cli apps:bundles:create --private-key ${privateKeyPath}`);
+                }
+            }
+        }
+        // Step 6: Set Up Auto Rollback (Optional)
+        // Reload config again to get latest updates
+        config = await readCapacitorConfig(capacitorConfigPath);
+        const hasReadyTimeout = config?.plugins?.LiveUpdate?.readyTimeout !== undefined;
+        if (!hasReadyTimeout) {
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            const shouldSetupRollback = await prompt('Do you want to set up automatic rollbacks? (Recommended for production, optional for testing)', {
+                type: 'confirm',
+                initial: false,
+            });
+            if (shouldSetupRollback) {
+                const timeoutStr = await prompt('Enter ready timeout in milliseconds (recommended: 10000):', {
+                    type: 'text',
+                    initial: '10000',
+                });
+                const readyTimeout = parseInt(timeoutStr, 10);
+                if (isNaN(readyTimeout) || readyTimeout <= 0) {
+                    consola.error('Invalid timeout value. Must be a positive number.');
+                    process.exit(1);
+                }
+                // Update config
+                await updateCapacitorConfig(capacitorConfigPath, {
+                    plugins: {
+                        LiveUpdate: {
+                            readyTimeout,
+                        },
+                    },
+                });
+                consola.success(`Updated Capacitor configuration with ready timeout: ${readyTimeout}ms`);
+                // Show code snippet
+                console.log(); // Blank line
+                consola.box(`IMPORTANT: Add this code to your app!\n\n` +
+                    `Call this as soon as possible during app startup:\n\n` +
+                    `import { LiveUpdate } from '@capawesome/capacitor-live-update';\n\n` +
+                    `LiveUpdate.ready();`);
+            }
+        }
+        // Step 7: Final Message
+        console.log(); // Blank line
+        consola.success('Live Updates setup completed!');
+        consola.info('Next steps:');
+        consola.info('1. Sync your Capacitor project: `npx cap sync`');
+        consola.info('2. Create your first bundle: `npx @capawesome/cli apps:bundles:create`');
+        consola.info('3. Download and apply the latest bundle in your app by calling the `sync(...)` method:');
+        console.log(); // Blank line
+        const syncCode = `import { LiveUpdate } from '@capawesome/capacitor-live-update';\n\n` +
+            `const sync = async () => {\n` +
+            `  // Automatically download the latest update\n` +
+            `  const { nextBundleId } = await LiveUpdate.sync();\n` +
+            `  if (nextBundleId) {\n` +
+            `    // Reload the app to apply the update\n` +
+            `    await LiveUpdate.reload();\n` +
+            `  }\n` +
+            `};`;
+        consola.box(syncCode);
+        // Ask if user wants to copy to clipboard
+        // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+        const shouldCopy = await prompt('Do you want to copy this code to your clipboard?', {
+            type: 'confirm',
+            initial: true,
+        });
+        if (shouldCopy) {
+            try {
+                await copyToClipboard(syncCode);
+                consola.success('Code copied to clipboard!');
+            }
+            catch (error) {
+                consola.warn('Failed to copy to clipboard. Please copy the code manually.');
+            }
+        }
+        // Show helpful resources
+        console.log(); // Blank line
+        consola.log('Learn more:');
+        consola.log('- Plugin Documentation: https://capawesome.io/plugins/live-update/');
+        consola.log('- Update Strategies: https://capawesome.io/cloud/live-updates/guides/update-strategies/');
+        consola.log('- Best Practices: https://capawesome.io/cloud/live-updates/guides/best-practices/');
+    },
+});

package/dist/index.js

@@ -39,6 +39,7 @@ const config = defineConfig({
         'apps:deployments:cancel': await import('./commands/apps/deployments/cancel.js').then((mod) => mod.default),
         'apps:deployments:logs': await import('./commands/apps/deployments/logs.js').then((mod) => mod.default),
         'apps:devices:delete': await import('./commands/apps/devices/delete.js').then((mod) => mod.default),
+        'apps:liveupdates:setup': await import('./commands/apps/liveupdates/setup.js').then((mod) => mod.default),
         'manifests:generate': await import('./commands/manifests/generate.js').then((mod) => mod.default),
         'organizations:create': await import('./commands/organizations/create.js').then((mod) => mod.default),
     },

package/dist/utils/capacitor-config-writer.js

@@ -0,0 +1,123 @@
+import fs from 'fs';
+import { readCapacitorConfig } from './capacitor-config.js';
+import { writeFile } from './file.js';
+/**
+ * Deep merge two objects.
+ */
+const deepMerge = (target, source) => {
+    const result = { ...target };
+    for (const key in source) {
+        if (source[key] !== undefined) {
+            if (typeof source[key] === 'object' && !Array.isArray(source[key]) && source[key] !== null) {
+                result[key] = deepMerge(result[key] || {}, source[key]);
+            }
+            else {
+                result[key] = source[key];
+            }
+        }
+    }
+    return result;
+};
+/**
+ * Convert a value to a JavaScript object notation string.
+ */
+const toJSObjectString = (value, indent = 0) => {
+    const indentStr = '  '.repeat(indent);
+    const nextIndentStr = '  '.repeat(indent + 1);
+    if (value === null) {
+        return 'null';
+    }
+    if (value === undefined) {
+        return 'undefined';
+    }
+    if (typeof value === 'string') {
+        // Handle multi-line strings (like public keys)
+        if (value.includes('\n')) {
+            // Use template literal for multi-line strings
+            return `\`${value}\``;
+        }
+        return `'${value.replace(/'/g, "\\'")}'`;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            return '[]';
+        }
+        const items = value.map((item) => `${nextIndentStr}${toJSObjectString(item, indent + 1)}`).join(',\n');
+        return `[\n${items}\n${indentStr}]`;
+    }
+    if (typeof value === 'object') {
+        const keys = Object.keys(value);
+        if (keys.length === 0) {
+            return '{}';
+        }
+        const items = keys
+            .map((key) => {
+            const val = toJSObjectString(value[key], indent + 1);
+            return `${nextIndentStr}${key}: ${val}`;
+        })
+            .join(',\n');
+        return `{\n${items}\n${indentStr}}`;
+    }
+    return 'undefined';
+};
+/**
+ * Write a Capacitor config to a JSON file.
+ */
+export const writeCapacitorConfigJson = async (configPath, config) => {
+    const jsonContent = JSON.stringify(config, null, 2);
+    await writeFile(configPath, jsonContent);
+};
+/**
+ * Write a Capacitor config to a TypeScript file.
+ */
+export const writeCapacitorConfigTs = async (configPath, config) => {
+    // Read existing file to preserve reference comments
+    const existingContent = await fs.promises.readFile(configPath, 'utf-8');
+    // Extract reference comments
+    const referenceComments = [];
+    const lines = existingContent.split('\n');
+    for (const line of lines) {
+        if (line.trim().startsWith('///')) {
+            referenceComments.push(line.trim());
+        }
+    }
+    // Generate TypeScript content
+    const configObject = toJSObjectString(config, 0);
+    const tsContent = [
+        ...referenceComments,
+        ...(referenceComments.length > 0 ? [''] : []),
+        "import type { CapacitorConfig } from '@capacitor/cli';",
+        '',
+        'const config: CapacitorConfig = ' + configObject + ';',
+        '',
+        'export default config;',
+        '',
+    ].join('\n');
+    await writeFile(configPath, tsContent);
+};
+/**
+ * Update a Capacitor config file with partial updates.
+ * Performs a deep merge with existing config.
+ */
+export const updateCapacitorConfig = async (configPath, updates) => {
+    // Read current config
+    let currentConfig = await readCapacitorConfig(configPath);
+    if (!currentConfig) {
+        currentConfig = {};
+    }
+    // Merge updates
+    const mergedConfig = deepMerge(currentConfig, updates);
+    // Write based on file type
+    if (configPath.endsWith('.json')) {
+        await writeCapacitorConfigJson(configPath, mergedConfig);
+    }
+    else if (configPath.endsWith('.ts')) {
+        await writeCapacitorConfigTs(configPath, mergedConfig);
+    }
+    else {
+        throw new Error('Unsupported config file format');
+    }
+};

package/dist/utils/capacitor-config.js

@@ -37,14 +37,16 @@ export const readCapacitorConfig = async (configPath) => {
             // Extract webDir using regex
             const webDirMatch = content.match(/webDir:\s*['"]([^'"]+)['"]/);
             const appIdMatch = content.match(/LiveUpdate:\s*{[^}]*appId:\s*['"]([^'"]+)['"]/s);
+            const publicKeyMatch = content.match(/LiveUpdate:\s*{[^}]*publicKey:\s*['"]([^'"]+)['"]/s);
             const config = {};
             if (webDirMatch) {
                 config.webDir = webDirMatch[1];
             }
-            if (appIdMatch) {
+            if (appIdMatch || publicKeyMatch) {
                 config.plugins = {
                     LiveUpdate: {
-                        appId: appIdMatch[1],
+                        ...(appIdMatch && { appId: appIdMatch[1] }),
+                        ...(publicKeyMatch && { publicKey: publicKeyMatch[1] }),
                     },
                 };
             }
@@ -78,7 +80,17 @@ export const getWebDirFromConfig = async (configPath) => {
  * @param configPath The path to the config file.
  * @returns The appId, or undefined if not found.
  */
-export const getLiveUpdateAppIdFromConfig = async (configPath) => {
+export const getLiveUpdatePluginAppIdFromConfig = async (configPath) => {
     const config = await readCapacitorConfig(configPath);
     return config?.plugins?.LiveUpdate?.appId;
 };
+/**
+ * Get the LiveUpdate publicKey from the Capacitor config.
+ *
+ * @param configPath The path to the config file.
+ * @returns The publicKey, or undefined if not found.
+ */
+export const getLiveUpdatePluginPublicKeyFromConfig = async (configPath) => {
+    const config = await readCapacitorConfig(configPath);
+    return config?.plugins?.LiveUpdate?.publicKey;
+};

package/dist/utils/clipboard.js

@@ -0,0 +1,34 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+/**
+ * Copy text to the system clipboard.
+ * Works on macOS, Linux, and Windows.
+ *
+ * @param text The text to copy to the clipboard.
+ */
+export const copyToClipboard = async (text) => {
+    const platform = process.platform;
+    try {
+        if (platform === 'darwin') {
+            // macOS
+            await execAsync(`echo "${text.replace(/"/g, '\\"')}" | pbcopy`);
+        }
+        else if (platform === 'win32') {
+            // Windows
+            await execAsync(`echo "${text.replace(/"/g, '\\"')}" | clip`);
+        }
+        else {
+            // Linux - try xclip first, fall back to xsel
+            try {
+                await execAsync(`echo "${text.replace(/"/g, '\\"')}" | xclip -selection clipboard`);
+            }
+            catch (error) {
+                await execAsync(`echo "${text.replace(/"/g, '\\"')}" | xsel --clipboard --input`);
+            }
+        }
+    }
+    catch (error) {
+        throw new Error('Failed to copy to clipboard. Make sure clipboard utilities are installed.');
+    }
+};

package/dist/utils/openssl.js

@@ -0,0 +1,40 @@
+import { exec } from 'child_process';
+import fs from 'fs';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+/**
+ * Check if OpenSSL is installed on the system.
+ *
+ * @returns True if OpenSSL is installed, false otherwise.
+ */
+export const checkOpensslInstalled = async () => {
+    try {
+        await execAsync('openssl version');
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+};
+/**
+ * Generate an RSA key pair using OpenSSL.
+ *
+ * @param privateKeyPath Path where the private key will be saved.
+ * @param publicKeyPath Path where the public key will be saved.
+ */
+export const generateKeyPair = async (privateKeyPath, publicKeyPath) => {
+    // Generate private key
+    await execAsync(`openssl genrsa -out ${privateKeyPath} 2048`);
+    // Extract public key from private key
+    await execAsync(`openssl rsa -in ${privateKeyPath} -pubout -out ${publicKeyPath}`);
+};
+/**
+ * Read a public key from a file.
+ *
+ * @param publicKeyPath Path to the public key file.
+ * @returns The public key content as a string.
+ */
+export const readPublicKey = async (publicKeyPath) => {
+    const content = await fs.promises.readFile(publicKeyPath, 'utf-8');
+    return content.trim();
+};

package/dist/utils/package-json.js

@@ -56,3 +56,40 @@ export const getBuildScript = async (packageJsonPath) => {
     }
     return undefined;
 };
+/**
+ * Check if a package is installed.
+ * Checks both dependencies and devDependencies.
+ *
+ * @param packageJsonPath The path to the package.json file.
+ * @param packageName The name of the package to check.
+ * @returns True if the package is installed, false otherwise.
+ */
+export const isPackageInstalled = async (packageJsonPath, packageName) => {
+    const packageJson = await readPackageJson(packageJsonPath);
+    if (!packageJson) {
+        return false;
+    }
+    return !!(packageJson.dependencies?.[packageName] || packageJson.devDependencies?.[packageName]);
+};
+/**
+ * Get the Capacitor CLI version from package.json.
+ *
+ * @param packageJsonPath The path to the package.json file.
+ * @returns The Capacitor major version number, or undefined if not found.
+ */
+export const getCapacitorMajorVersion = async (packageJsonPath) => {
+    const packageJson = await readPackageJson(packageJsonPath);
+    if (!packageJson) {
+        return undefined;
+    }
+    const capacitorVersion = packageJson.dependencies?.['@capacitor/core'] || packageJson.devDependencies?.['@capacitor/core'];
+    if (!capacitorVersion) {
+        return undefined;
+    }
+    // Extract major version from version string (e.g., "^5.0.0" -> 5, "~6.1.0" -> 6)
+    const match = capacitorVersion.match(/(\d+)/);
+    if (match && match[1]) {
+        return parseInt(match[1], 10);
+    }
+    return undefined;
+};

package/dist/utils/package-manager.js

@@ -0,0 +1,38 @@
+import { exec } from 'child_process';
+import consola from 'consola';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+/**
+ * Install a package using the specified package manager.
+ *
+ * @param packageName The name of the package to install.
+ * @param packageManager The package manager to use (npm, yarn, or pnpm).
+ */
+export const installPackage = async (packageName, packageManager) => {
+    const commands = {
+        npm: `npm install ${packageName}`,
+        yarn: `yarn add ${packageName}`,
+        pnpm: `pnpm add ${packageName}`,
+    };
+    const command = commands[packageManager];
+    consola.start(`Installing ${packageName} using ${packageManager}...`);
+    try {
+        const { stdout, stderr } = await execAsync(command);
+        if (stdout) {
+            console.log(stdout);
+        }
+        if (stderr) {
+            console.error(stderr);
+        }
+    }
+    catch (error) {
+        consola.error(`Failed to install ${packageName}.`);
+        if (error.stdout) {
+            console.log(error.stdout);
+        }
+        if (error.stderr) {
+            console.error(error.stderr);
+        }
+        process.exit(1);
+    }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capawesome/cli",
-  "version": "3.7.0-dev.3ddf02d.1764834835",
+  "version": "3.7.0-dev.445ea3a.1764843317",
   "description": "The Capawesome Cloud Command Line Interface (CLI) to manage Live Updates and more.",
   "type": "module",
   "scripts": {
@@ -13,7 +13,7 @@
     "fmt": "npm run prettier -- --write",
     "prettier": "prettier \"**/*.{css,html,ts,js}\"",
     "sentry:releases:new": "sentry-cli releases new capawesome-team-cli@$npm_package_version --org genz-it-solutions-gmbh --project capawesome-team-cli",
-    "sentry:releases:set-commits": "sentry-cli releases set-commits capawesome-team-cli@$npm_package_version --auto --org genz-it-solutions-gmbh --project capawesome-team-cli",
+    "sentry:releases:set-commits": "sentry-cli releases set-commits capawesome-team-cli@$npm_package_version --auto --org genz-it-solutions-gmbh --project capawesome-team-cli --ignore-missing",
     "sentry:releases:finalize": "sentry-cli releases finalize capawesome-team-cli@$npm_package_version --org genz-it-solutions-gmbh --project capawesome-team-cli",
     "release": "commit-and-tag-version",
     "prepublishOnly": "npm run build && npm run sentry:releases:new && npm run sentry:releases:set-commits",