@lightdash/cli 1.34.0 → 1.35.0

package/dist/handlers/apps/appsDownload.test.js

@@ -2,11 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const common_1 = require("@lightdash/common");
 const appsDownload_1 = require("./appsDownload");
-describe('getDataAppUuidFromReference', () => {
+describe('getDataAppReference', () => {
     const appUuid = 'd3afc44c-6f0f-4d9f-a267-fb739efa31dd';
     const projectUuid = 'd4c8dfd2-98c0-4eb2-8395-d924aee62611';
     it('keeps a bare app UUID unchanged', () => {
-        expect((0, appsDownload_1.getDataAppUuidFromReference)(appUuid)).toBe(appUuid);
+        expect((0, appsDownload_1.getDataAppReference)(appUuid)).toBe(appUuid);
+    });
+    it('keeps a bare slug unchanged', () => {
+        expect((0, appsDownload_1.getDataAppReference)('my-app-slug')).toBe('my-app-slug');
     });
     it.each([
         `https://app.lightdash.cloud/projects/${projectUuid}/apps/${appUuid}`,
@@ -14,7 +17,7 @@ describe('getDataAppUuidFromReference', () => {
         `https://app.lightdash.cloud/projects/${projectUuid}/apps/${appUuid}/versions/2/view?state=filters#preview`,
         `https://app.lightdash.cloud/embed/${projectUuid}/app/${appUuid}`,
     ])('extracts the app UUID from %s', (url) => {
-        expect((0, appsDownload_1.getDataAppUuidFromReference)(url)).toBe(appUuid);
+        expect((0, appsDownload_1.getDataAppReference)(url)).toBe(appUuid);
     });
     it.each([
         'my-app',
@@ -22,7 +25,49 @@ describe('getDataAppUuidFromReference', () => {
         `https://app.lightdash.cloud/projects/${projectUuid}/apps/generate`,
         `ftp://app.lightdash.cloud/projects/${projectUuid}/apps/${appUuid}`,
     ])('leaves unsupported references unchanged: %s', (reference) => {
-        expect((0, appsDownload_1.getDataAppUuidFromReference)(reference)).toBe(reference);
+        expect((0, appsDownload_1.getDataAppReference)(reference)).toBe(reference);
+    });
+});
+describe('uploadFilterMatches', () => {
+    const makeManifest = (overrides = {}) => ({
+        codeVersion: 1,
+        appUuid: 'app-uuid-1',
+        projectUuid: 'proj-uuid-1',
+        version: 3,
+        name: 'My App',
+        description: '',
+        template: null,
+        downloadedAt: '2026-06-25T00:00:00.000Z',
+        ...overrides,
+    });
+    it('matches everything when the filter is null', () => {
+        expect((0, appsDownload_1.uploadFilterMatches)(null, makeManifest())).toBe(true);
+    });
+    it('matches on manifest.appUuid', () => {
+        const filter = new Set(['app-uuid-1']);
+        expect((0, appsDownload_1.uploadFilterMatches)(filter, makeManifest())).toBe(true);
+    });
+    it('matches on manifest.slug', () => {
+        const filter = new Set(['sales-app']);
+        expect((0, appsDownload_1.uploadFilterMatches)(filter, makeManifest({ slug: 'sales-app' }))).toBe(true);
+    });
+    it('does not match when neither uuid nor slug is in the filter', () => {
+        const filter = new Set(['other-uuid']);
+        expect((0, appsDownload_1.uploadFilterMatches)(filter, makeManifest({ slug: 'sales-app' }))).toBe(false);
+    });
+    it('matches only by uuid when the manifest has no slug', () => {
+        const filter = new Set(['app-uuid-1']);
+        expect((0, appsDownload_1.uploadFilterMatches)(filter, makeManifest({ slug: undefined }))).toBe(true);
+        expect((0, appsDownload_1.uploadFilterMatches)(new Set(['sales-app']), makeManifest({ slug: undefined }))).toBe(false);
+    });
+    it('matches only by slug for uuid-free manifests (slug-aware servers)', () => {
+        const manifest = makeManifest({
+            appUuid: undefined,
+            slug: 'sales-app',
+        });
+        expect((0, appsDownload_1.uploadFilterMatches)(new Set(['sales-app']), manifest)).toBe(true);
+        expect((0, appsDownload_1.uploadFilterMatches)(new Set(['app-uuid-1']), manifest)).toBe(false);
+        expect((0, appsDownload_1.uploadFilterMatches)(null, manifest)).toBe(true);
     });
 });
 describe('getDataAppUploadFilter', () => {
@@ -62,20 +107,20 @@ const makeDownload = () => ({
     },
 });
 describe('selectAppsToDownload', () => {
-    it('returns explicit uuids without listing when uuids are passed', () => {
+    it('returns explicit refs without listing when refs are passed', () => {
         expect((0, appsDownload_1.selectAppsToDownload)({ apps: ['uuid-a', 'uuid-b'] })).toEqual({
             mode: 'explicit',
-            appUuids: ['uuid-a', 'uuid-b'],
+            appRefs: ['uuid-a', 'uuid-b'],
         });
     });
     it('lists all apps when --include-apps is passed', () => {
         expect((0, appsDownload_1.selectAppsToDownload)({ includeApps: true })).toEqual({
             mode: 'list-all',
-            extraAppUuids: [],
+            extraAppRefs: [],
         });
     });
-    it('combines --include-apps with explicitly passed uuids', () => {
-        expect((0, appsDownload_1.selectAppsToDownload)({ apps: ['uuid-a'], includeApps: true })).toEqual({ mode: 'list-all', extraAppUuids: ['uuid-a'] });
+    it('combines --include-apps with explicitly passed refs', () => {
+        expect((0, appsDownload_1.selectAppsToDownload)({ apps: ['uuid-a'], includeApps: true })).toEqual({ mode: 'list-all', extraAppRefs: ['uuid-a'] });
     });
     it('normalizes explicit app URLs without listing apps', () => {
         expect((0, appsDownload_1.selectAppsToDownload)({
@@ -84,7 +129,7 @@ describe('selectAppsToDownload', () => {
             ],
         })).toEqual({
             mode: 'explicit',
-            appUuids: ['d3afc44c-6f0f-4d9f-a267-fb739efa31dd'],
+            appRefs: ['d3afc44c-6f0f-4d9f-a267-fb739efa31dd'],
         });
     });
     it('skips apps when neither flag is passed', () => {
@@ -170,6 +215,75 @@ describe('ensureDownloadedAppContext', () => {
         expect(() => (0, appsDownload_1.ensureDownloadedAppContext)('app-uuid-1', withoutContext)).toThrow(/does not support app context downloads/i);
     });
 });
+describe('preSlugUploadHint', () => {
+    it('suggests adding the slug to lightdash-app.yml when the server returned one', () => {
+        const hint = (0, appsDownload_1.preSlugUploadHint)({
+            folder: 'lightdash/apps/my-app',
+            slug: 'my-app',
+        });
+        expect(hint).toContain('lightdash/apps/my-app/lightdash-app.yml');
+        expect(hint).toContain('predates slug identity');
+        expect(hint).toContain('add `slug: my-app` to lightdash-app.yml');
+        expect(hint).toContain('Uploads keep working via uuid matching');
+    });
+    it('omits the add-slug suggestion when the server did not return a slug', () => {
+        const hint = (0, appsDownload_1.preSlugUploadHint)({
+            folder: 'lightdash/apps/my-app',
+            slug: undefined,
+        });
+        expect(hint).toContain('lightdash/apps/my-app/lightdash-app.yml');
+        expect(hint).toContain('predates slug identity');
+        expect(hint).not.toContain('add `slug:');
+        expect(hint).toContain('Uploads keep working via uuid matching');
+    });
+});
+describe('matchedUploadRefs', () => {
+    const manifest = {
+        codeVersion: 1,
+        appUuid: 'app-uuid-1',
+        projectUuid: 'proj-uuid-1',
+        slug: 'sales-app',
+        version: 3,
+        name: 'My App',
+        description: '',
+        template: null,
+        downloadedAt: '2026-07-29T00:00:00.000Z',
+    };
+    it('returns the filter entries the manifest satisfies', () => {
+        expect((0, appsDownload_1.matchedUploadRefs)(new Set(['app-uuid-1', 'sales-app', 'other']), manifest)).toEqual(['app-uuid-1', 'sales-app']);
+    });
+    it('returns only the slug for uuid-free manifests', () => {
+        expect((0, appsDownload_1.matchedUploadRefs)(new Set(['app-uuid-1', 'sales-app']), {
+            ...manifest,
+            appUuid: undefined,
+        })).toEqual(['sales-app']);
+    });
+});
+describe('unmatchedUploadRefsWarning', () => {
+    it('returns null when everything matched', () => {
+        expect((0, appsDownload_1.unmatchedUploadRefsWarning)([])).toBeNull();
+    });
+    it('lists unmatched refs', () => {
+        const warning = (0, appsDownload_1.unmatchedUploadRefsWarning)(['sales-ap']);
+        expect(warning).toContain('No local app folder matched: sales-ap.');
+        expect(warning).not.toContain('slug identity');
+    });
+    it('adds the slug-identity explanation for uuid-shaped refs', () => {
+        const warning = (0, appsDownload_1.unmatchedUploadRefsWarning)([
+            'd3afc44c-6f0f-4d9f-a267-fb739efa31dd',
+        ]);
+        expect(warning).toContain('carry no uuid');
+        expect(warning).toContain('select them by slug');
+    });
+});
+describe('preSlugServerHint', () => {
+    it('warns that the server matched by uuid only and to check for duplicates', () => {
+        const hint = (0, appsDownload_1.preSlugServerHint)('my-app');
+        expect(hint).toContain('"my-app"');
+        expect(hint).toContain('predates slug-based app identity');
+        expect(hint).toContain('verify no duplicate was created');
+    });
+});
 describe('computeUpsertedTotal', () => {
     it('sums only keys that are neither skipped nor failed', () => {
         const changes = {
@@ -211,30 +325,6 @@ describe('shouldWarnAllSkipped', () => {
         expect((0, appsDownload_1.shouldWarnAllSkipped)({})).toBe(false);
     });
 });
-describe('classifyAppUpload', () => {
-    it('proceeds when createNew is true regardless of project mismatch', () => {
-        expect((0, appsDownload_1.classifyAppUpload)('proj-a', 'proj-b', true)).toBe('proceed');
-    });
-    it('proceeds when manifest project matches target project', () => {
-        expect((0, appsDownload_1.classifyAppUpload)('proj-a', 'proj-a', false)).toBe('proceed');
-    });
-    it('needs-confirmation when projects differ and createNew is false', () => {
-        expect((0, appsDownload_1.classifyAppUpload)('proj-a', 'proj-b', false)).toBe('needs-confirmation');
-    });
-});
-describe('manifestRetargetHint', () => {
-    it('names both uuids, the consequence, and the manual fix', () => {
-        const hint = (0, appsDownload_1.manifestRetargetHint)({
-            folder: 'my-app',
-            appUuid: 'new-app-uuid',
-            projectUuid: 'target-proj-uuid',
-        });
-        expect(hint).toContain('my-app/lightdash-app.yml');
-        expect(hint).toContain('appUuid: new-app-uuid');
-        expect(hint).toContain('projectUuid: target-proj-uuid');
-        expect(hint).toMatch(/ask to create again/i);
-    });
-});
 describe('classifyAppDownloadError', () => {
     const make404 = (message) => new common_1.LightdashError({
         message,
@@ -287,7 +377,7 @@ describe('appsDownloadSummary', () => {
         expect(summary.failureLines).toEqual([]);
     });
     it('reports a warning with per-app reasons when any app failed', () => {
-        const summary = (0, appsDownload_1.appsDownloadSummary)(0, 1, [{ appUuid: 'uuid-a', message: 'server exploded' }], '/tmp/x/apps', 0);
+        const summary = (0, appsDownload_1.appsDownloadSummary)(0, 1, [{ appRef: 'uuid-a', message: 'server exploded' }], '/tmp/x/apps', 0);
         expect(summary.ok).toBe(false);
         expect(summary.message).toContain('Downloaded 0 of 1 data app(s)');
         expect(summary.message).toContain('1 failed');
@@ -303,7 +393,7 @@ describe('appsDownloadSummary', () => {
         expect(summary.failureLines).toEqual([]);
     });
     it('reports skips and failures together', () => {
-        const summary = (0, appsDownload_1.appsDownloadSummary)(1, 3, [{ appUuid: 'uuid-a', message: 'server exploded' }], '/tmp/x/apps', 1);
+        const summary = (0, appsDownload_1.appsDownloadSummary)(1, 3, [{ appRef: 'uuid-a', message: 'server exploded' }], '/tmp/x/apps', 1);
         expect(summary.ok).toBe(false);
         expect(summary.message).toContain('Downloaded 1 of 2 data app(s)');
         expect(summary.message).toContain('1 skipped: no built version');

package/dist/handlers/download.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/handlers/download.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/handlers/download.ts"],"names":[],"mappings":"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"}

package/dist/handlers/download.js

@@ -1082,10 +1082,10 @@ const downloadHandler = async (options) => {
         });
         if (appsSelection.mode !== 'none') {
             output.startItem('Data apps');
-            let appUuidsToDownload;
+            let appRefsToDownload;
             let appListingError = null;
             if (appsSelection.mode === 'explicit') {
-                appUuidsToDownload = appsSelection.appUuids;
+                appRefsToDownload = appsSelection.appRefs;
             }
             else {
                 // List every app in the project (includes apps not in any space)
@@ -1117,14 +1117,14 @@ const downloadHandler = async (options) => {
                 if (truncatedCount > 0) {
                     globalState_1.default.log(styles.warning(`Found ${listedAppUuids.length} data apps, downloading the first ${appsLimit}. Pass --apps-limit <n> to raise the cap.`));
                 }
-                appUuidsToDownload = [
+                appRefsToDownload = [
                     ...new Set([
                         ...cappedAppUuids,
-                        ...appsSelection.extraAppUuids,
+                        ...appsSelection.extraAppRefs,
                     ]),
                 ];
             }
-            if (appUuidsToDownload.length === 0) {
+            if (appRefsToDownload.length === 0) {
                 if (appListingError === null) {
                     output.completeItem('0 found');
                 }
@@ -1133,22 +1133,22 @@ const downloadHandler = async (options) => {
                 }
             }
             else {
-                output.updateActive(`0 of ${appUuidsToDownload.length} downloaded`);
+                output.updateActive(`0 of ${appRefsToDownload.length} downloaded`);
                 const baseDir = (0, contentAsCodePaths_1.getDownloadFolder)(options.path);
                 const appsDir = path.join(baseDir, 'apps');
                 const takenFolders = new Set();
                 let appSuccessCount = 0;
                 let appSkippedNotBuiltCount = 0;
                 const appFailures = [];
-                for (const appUuid of appUuidsToDownload) {
+                for (const appRef of appRefsToDownload) {
                     try {
                         // eslint-disable-next-line no-await-in-loop
-                        const code = (0, appsDownload_1.ensureDownloadedAppContext)(appUuid, await (0, apiClient_1.lightdashApi)({
+                        const code = (0, appsDownload_1.ensureDownloadedAppContext)(appRef, await (0, apiClient_1.lightdashApi)({
                             method: 'GET',
-                            url: `/api/v1/ee/projects/${projectId}/apps/${appUuid}/download`,
+                            url: `/api/v1/ee/projects/${projectId}/apps/${appRef}/download`,
                             body: undefined,
                         }));
-                        const folder = (0, appCodeFiles_1.appFolderName)(code.manifest.name, appUuid, takenFolders);
+                        const folder = (0, appCodeFiles_1.resolveAppFolderName)(code.manifest, takenFolders);
                         takenFolders.add(folder);
                         const appDir = path.join(appsDir, folder);
                         const manifest = {
@@ -1176,21 +1176,21 @@ const downloadHandler = async (options) => {
                         const outcome = (0, appsDownload_1.classifyAppDownloadError)(appErr);
                         if (outcome.kind === 'skip-not-built') {
                             appSkippedNotBuiltCount += 1;
-                            globalState_1.default.debug(`> Skipped app ${appUuid}: no built version to download`);
+                            globalState_1.default.debug(`> Skipped app ${appRef}: no built version to download`);
                         }
                         else {
                             appFailures.push({
-                                appUuid,
+                                appRef,
                                 message: outcome.message,
                             });
-                            globalState_1.default.log(styles.error(`Failed to download app ${appUuid}: ${outcome.message}`));
+                            globalState_1.default.log(styles.error(`Failed to download app ${appRef}: ${outcome.message}`));
                         }
                     }
                     output.updateActive(`${appSuccessCount +
                         appSkippedNotBuiltCount +
-                        appFailures.length} of ${appUuidsToDownload.length} processed`);
+                        appFailures.length} of ${appRefsToDownload.length} processed`);
                 }
-                const summary = (0, appsDownload_1.appsDownloadSummary)(appSuccessCount, appUuidsToDownload.length, appFailures, appsDir, appSkippedNotBuiltCount);
+                const summary = (0, appsDownload_1.appsDownloadSummary)(appSuccessCount, appRefsToDownload.length, appFailures, appsDir, appSkippedNotBuiltCount);
                 output.completeItem(`${appSuccessCount} downloaded${appSkippedNotBuiltCount > 0
                     ? `, ${appSkippedNotBuiltCount} skipped`
                     : ''}${appFailures.length > 0
@@ -1769,8 +1769,8 @@ const uploadHandler = async (options) => {
         else if (shouldUploadApps) {
             output.startItem('Data apps');
             // --include-apps uploads every folder on disk; explicit references
-            // filter folders by their manifest appUuid
-            const filterUuids = (0, appsDownload_1.getDataAppUploadFilter)(explicitAppReferences, options.includeApps === true);
+            // filter folders by their manifest slug or appUuid
+            const uploadFilter = (0, appsDownload_1.getDataAppUploadFilter)(explicitAppReferences, options.includeApps === true);
             const baseDir = (0, contentAsCodePaths_1.getDownloadFolder)(options.path);
             const appsDir = path.join(baseDir, 'apps');
             let appFolderEntries;
@@ -1792,43 +1792,19 @@ const uploadHandler = async (options) => {
             if (subDirs.length === 0) {
                 globalState_1.default.log(styles.warning(`No app folders found in ${appsDir}.`));
             }
+            const matchedRefs = new Set();
             for (const subDir of subDirs) {
                 const folderPath = path.join(appsDir, subDir.name);
                 try {
                     // eslint-disable-next-line no-await-in-loop
                     const code = await (0, appCodeFiles_1.readBundleFromDir)(folderPath);
-                    if (filterUuids &&
-                        !filterUuids.has(code.manifest.appUuid)) {
-                        globalState_1.default.debug(`Skipping app folder "${subDir.name}" (uuid ${code.manifest.appUuid} not in filter)`);
+                    if (!(0, appsDownload_1.uploadFilterMatches)(uploadFilter, code.manifest)) {
+                        globalState_1.default.debug(`Skipping app folder "${subDir.name}" (not in filter)`);
                         // eslint-disable-next-line no-continue
                         continue;
                     }
-                    // Guard: cross-project create
-                    const uploadDecision = (0, appsDownload_1.classifyAppUpload)(code.manifest.projectUuid, projectId, options.createNew === true);
-                    if (uploadDecision === 'needs-confirmation') {
-                        if (process.stdin.isTTY && process.stdout.isTTY) {
-                            // eslint-disable-next-line no-await-in-loop
-                            const { confirmed } = await inquirer_1.default.prompt([
-                                {
-                                    type: 'confirm',
-                                    name: 'confirmed',
-                                    message: `"${subDir.name}" was downloaded from project ${code.manifest.projectUuid}, but you are uploading to project ${projectId}. This will CREATE a new app. Continue?`,
-                                    default: false,
-                                },
-                            ]);
-                            if (!confirmed) {
-                                globalState_1.default.log(`Skipped "${subDir.name}" (cross-project create declined). Pass --create-new to make this explicit. If this app was already moved to the target project, set appUuid and projectUuid in lightdash-app.yml to the moved app instead.`);
-                                appsSkipped += 1;
-                                // eslint-disable-next-line no-continue
-                                continue;
-                            }
-                        }
-                        else {
-                            globalState_1.default.log(styles.error(`Cannot upload "${subDir.name}": its manifest targets project ${code.manifest.projectUuid} but you are uploading to project ${projectId}. Pass --create-new to create a new app in the target project. If this app was already moved there, set appUuid and projectUuid in lightdash-app.yml to the moved app instead.`));
-                            appsFailed += 1;
-                            // eslint-disable-next-line no-continue
-                            continue;
-                        }
+                    if (uploadFilter) {
+                        (0, appsDownload_1.matchedUploadRefs)(uploadFilter, code.manifest).forEach((ref) => matchedRefs.add(ref));
                     }
                     // Read declared dependencies from the app folder (optional).
                     // eslint-disable-next-line no-await-in-loop
@@ -1870,14 +1846,14 @@ const uploadHandler = async (options) => {
                             warningLines.forEach((line) => globalState_1.default.log(line));
                             if (process.stdin.isTTY && process.stdout.isTTY) {
                                 // eslint-disable-next-line no-await-in-loop
-                                const { proceed } = await inquirer_1.default.prompt([
+                                const { proceed } = await output.promptWhilePaused(() => inquirer_1.default.prompt([
                                     {
                                         type: 'confirm',
                                         name: 'proceed',
                                         message: `Upload "${subDir.name}" with custom dependencies?`,
                                         default: true,
                                     },
-                                ]);
+                                ]));
                                 if (!proceed) {
                                     globalState_1.default.log(`Skipped "${subDir.name}" (custom dependency upload declined).`);
                                     appsSkipped += 1;
@@ -1897,7 +1873,7 @@ const uploadHandler = async (options) => {
                         createNew: options.createNew === true,
                     });
                     // eslint-disable-next-line no-await-in-loop
-                    const { appUuid, version, action, warnings } = await (0, apiClient_1.lightdashApi)({
+                    const { appUuid, version, action, slug, warnings } = await (0, apiClient_1.lightdashApi)({
                         method: 'POST',
                         url: `/api/v1/ee/projects/${projectId}/apps/upload`,
                         body: JSON.stringify(body),
@@ -1913,42 +1889,20 @@ const uploadHandler = async (options) => {
                     }
                     const actionLabel = action === 'create' ? 'created' : 'updated';
                     globalState_1.default.log(styles.success(`Uploaded "${code.manifest.name}" — ${actionLabel} v${version} (${appUuid}). Building in the background; the app will show "building" until the server finishes.`));
+                    if (code.manifest.slug === undefined) {
+                        globalState_1.default.log(styles.warning((0, appsDownload_1.preSlugUploadHint)({
+                            folder: subDir.name,
+                            slug,
+                        })));
+                    }
+                    else if (slug === undefined) {
+                        // Bundle sent a slug but the response has none: the
+                        // server predates slug identity and matched by uuid
+                        // only (slug-only bundles may have just duplicated).
+                        globalState_1.default.log(styles.warning((0, appsDownload_1.preSlugServerHint)(subDir.name)));
+                    }
                     if (action === 'create') {
                         globalState_1.default.log(`New app: ${config.context.serverUrl}/projects/${projectId}/apps/${appUuid}`);
-                        if (process.stdin.isTTY && process.stdout.isTTY) {
-                            // eslint-disable-next-line no-await-in-loop
-                            const { retarget } = await inquirer_1.default.prompt([
-                                {
-                                    type: 'confirm',
-                                    name: 'retarget',
-                                    message: `Update ${subDir.name}/lightdash-app.yml to target the new app? This sets appUuid ${appUuid}, projectUuid ${projectId}, version ${version} — future uploads will update this app.`,
-                                    default: true,
-                                },
-                            ]);
-                            if (retarget) {
-                                // eslint-disable-next-line no-await-in-loop
-                                await (0, appCodeFiles_1.retargetManifest)(folderPath, {
-                                    appUuid,
-                                    projectUuid: projectId,
-                                    version,
-                                });
-                                globalState_1.default.log(styles.success(`Updated ${subDir.name}/lightdash-app.yml → appUuid ${appUuid}, projectUuid ${projectId}, version ${version}.`));
-                            }
-                            else {
-                                globalState_1.default.log(styles.warning((0, appsDownload_1.manifestRetargetHint)({
-                                    folder: subDir.name,
-                                    appUuid,
-                                    projectUuid: projectId,
-                                })));
-                            }
-                        }
-                        else {
-                            globalState_1.default.log(styles.warning((0, appsDownload_1.manifestRetargetHint)({
-                                folder: subDir.name,
-                                appUuid,
-                                projectUuid: projectId,
-                            })));
-                        }
                     }
                 }
                 catch (appErr) {
@@ -1962,6 +1916,12 @@ const uploadHandler = async (options) => {
                     globalState_1.default.log(styles.error(`Failed to upload app folder "${subDir.name}"${status ? ` [HTTP ${status}]` : ''}: ${(0, common_1.getErrorMessage)(appErr)}${hint}`));
                 }
             }
+            if (uploadFilter) {
+                const unmatchedWarning = (0, appsDownload_1.unmatchedUploadRefsWarning)([...uploadFilter].filter((ref) => !matchedRefs.has(ref)));
+                if (unmatchedWarning) {
+                    globalState_1.default.log(styles.warning(unmatchedWarning));
+                }
+            }
             if (appsCreated > 0)
                 changes['data apps created'] = appsCreated;
             if (appsUpdated > 0)
@@ -1972,6 +1932,13 @@ const uploadHandler = async (options) => {
                 changes['data apps skipped'] = appsSkipped;
             const appSummary = summarizeUploadChanges(changesBeforeApps, changes);
             output.completeItem(appSummary.detail, appSummary.variant);
+            if (appsFailed > 0) {
+                // App uploads are fire-and-forget per folder, so failures are
+                // logged and tallied rather than thrown — but the process must
+                // still exit non-zero or CI pipelines read the run as green.
+                globalState_1.default.log(styles.error(`${appsFailed} data app upload(s) failed — see errors above.`));
+                process.exitCode = 1;
+            }
         }
         const end = Date.now();
         await analytics_1.LightdashAnalytics.track({

package/dist/handlers/download.test.js

@@ -7,6 +7,7 @@ const os = tslib_1.__importStar(require("os"));
 const path = tslib_1.__importStar(require("path"));
 const vitest_1 = require("vitest");
 const globalState_1 = tslib_1.__importDefault(require("../globalState"));
+const appsDownload_1 = require("./apps/appsDownload");
 const apiClient_1 = require("./dbt/apiClient");
 const download_1 = require("./download");
 vitest_1.vi.mock('./dbt/apiClient', async (importOriginal) => ({
@@ -44,6 +45,35 @@ describe('hasContentFilters', () => {
         }))).toBe(false);
     });
 });
+describe('data app upload loop filter wiring', () => {
+    const makeManifest = (overrides = {}) => ({
+        codeVersion: 1,
+        appUuid: 'app-uuid-unmatched',
+        projectUuid: 'proj-uuid-1',
+        version: 1,
+        name: 'App',
+        description: '',
+        template: null,
+        downloadedAt: '2026-06-25T00:00:00.000Z',
+        ...overrides,
+    });
+    it('skips a folder matching neither slug nor uuid, and uploads one matched by slug', () => {
+        // Mirrors the --apps <appReferences...> wiring in the upload loop:
+        // the filter is built once from the CLI-supplied references, then
+        // matched per folder via uploadFilterMatches.
+        const uploadFilter = (0, appsDownload_1.getDataAppUploadFilter)(['sales-app'], false);
+        const unmatchedFolder = makeManifest({
+            appUuid: 'other-uuid',
+            slug: 'other-slug',
+        });
+        const matchedBySlugFolder = makeManifest({
+            appUuid: 'matched-uuid',
+            slug: 'sales-app',
+        });
+        expect((0, appsDownload_1.uploadFilterMatches)(uploadFilter, unmatchedFolder)).toBe(false);
+        expect((0, appsDownload_1.uploadFilterMatches)(uploadFilter, matchedBySlugFolder)).toBe(true);
+    });
+});
 const makeLooseDashboard = (slug, chartSlugs) => ({
     slug,
     name: slug,

package/dist/index.js

@@ -374,7 +374,7 @@ const downloadCommand = commander_1.program
     .option('--include-scheduled-deliveries', 'include all scheduled deliveries in the download', false)
     .option('--include-all', 'include all optional content in the download', false)
     .option('--strip-pivot-series', 'strip per-value pivot series config from chart YAML for portable downloads', false)
-    .option('--apps <appReferences...>', 'Download only specified data apps by UUID or URL (enterprise). Works for apps not added to a space.')
+    .option('--apps <appReferences...>', 'Download only the specified data apps, by UUID, slug, or app URL (enterprise). Works for apps not added to a space.')
     .option('--include-apps', "Include all of the project's data apps (enterprise), capped at --apps-limit (default: 50)", false)
     .option('--apps-limit <number>', 'Maximum number of data apps downloaded by --include-apps or --include-all (default: 50)', undefined)
     .option('--apps-only', 'Download only data apps (implies --skip-charts --skip-dashboards --skip-spaces). Requires --apps <appReferences...>, --include-apps, or --include-all.', false)
@@ -410,9 +410,9 @@ const uploadCommand = commander_1.program
     .option('--include-charts', 'Include charts updates when uploading dashboards', false)
     .option('--validate', 'Validate charts and dashboards after upload', false)
     .option('--gzip', 'Enable gzip compression for request bodies', false)
-    .option('--apps <appReferences...>', 'Upload only specified data apps by UUID or URL (enterprise).')
+    .option('--apps <appReferences...>', 'Upload only the specified data apps, by UUID, slug, or app URL (enterprise).')
     .option('--include-apps', 'Upload all app folders on disk (enterprise).', false)
-    .option('--create-new', 'Always create a new app from the uploaded code instead of updating the app referenced by lightdash-app.yml.', false)
+    .option('--create-new', 'Always create a new app from the uploaded code instead of updating the app referenced by lightdash-app.yml. The new app gets a fresh slug.', false)
     .option('--organization', 'upload all organization-scoped resources without selecting a project', false)
     .option('--send-invites', 'send invitations to eligible pending users during organization upload', false);
 uploadCommand.action(withOrganizationMode(download_1.uploadHandler));

package/dist/terminal/contentAsCodeOutput.d.ts

@@ -39,6 +39,7 @@ export declare const createContentAsCodeOutput: ({ operation, scope, }: CreateCo
     updateActive: (detail: string) => void;
     completeItem: (detail: string, variant?: ContentAsCodeOutputVariant) => void;
     runItem: <T>({ label, action, detail, variant, }: RunContentAsCodeItemProps<T>) => Promise<T>;
+    promptWhilePaused: <T>(prompt: () => Promise<T>) => Promise<T>;
     prepareForFailureDetails: () => void;
     complete: (path: string, elapsedSeconds: number) => boolean;
     fail: (detail: string, elapsedSeconds: number, showFallback: boolean) => void;

package/dist/terminal/contentAsCodeOutput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contentAsCodeOutput.d.ts","sourceRoot":"","sources":["../../src/terminal/contentAsCodeOutput.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/D,MAAM,MAAM,uBAAuB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,0BAA0B,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACnC,SAAS,EAAE,UAAU,GAAG,QAAQ,CAAC;IACjC,KAAK,EAAE,cAAc,GAAG,SAAS,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,uBAAuB,EAAE,CAAC;CACpC,CAAC;AAEF,KAAK,0BAA0B,GAAG,IAAI,CAClC,wBAAwB,EACxB,WAAW,GAAG,OAAO,GAAG,OAAO,CAClC,GAAG;IACA,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,yBAAyB,GAAG,IAAI,CACjC,wBAAwB,EACxB,WAAW,GAAG,OAAO,GAAG,gBAAgB,GAAG,OAAO,CACrD,GAAG;IACA,UAAU,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC;CACxD,CAAC;AAkBF,eAAO,MAAM,iBAAiB,eAAgB,MAAM,WACR,CAAC;AAE7C,eAAO,MAAM,yBAAyB,mCAInC,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,QAAQ,GAAG,YAAY,CAAC,WAG3B,CAAC;AAczC,eAAO,MAAM,2BAA2B,4DAMrC,0BAA0B,WAe5B,CAAC;AAEF,eAAO,MAAM,0BAA0B,6DAMpC,yBAAyB,WAY3B,CAAC;AAEF,eAAO,MAAM,2BAA2B,uDAMrC,wBAAwB,WAW1B,CAAC;AAEF,eAAO,MAAM,0BAA0B,QAAO,OAOzC,CAAC;AAEN,eAAO,MAAM,yBAAyB,YAAa,MAAM,KAAG,IAM3D,CAAC;AAEF,eAAO,MAAM,2BAA2B,UAC7B,wBAAwB,KAChC,OAOF,CAAC;AAEF,KAAK,8BAA8B,GAAG,IAAI,CACtC,wBAAwB,EACxB,WAAW,GAAG,OAAO,CACxB,CAAC;AAEF,KAAK,yBAAyB,CAAC,CAAC,IAAI;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,0BAA0B,GAAG,SAAS,CAAC;CAClE,CAAC;AAEF,eAAO,MAAM,yBAAyB,0BAGnC,8BAA8B;uBASH,MAAM,WAAW,MAAM;2BAwBnB,MAAM;2BAcxB,MAAM,YACJ,0BAA0B;cAkBjB,CAAC,uCAKrB,yBAAyB,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC;;qBAiBvB,MAAM,kBAAkB,MAAM,KAAG,OAAO;mBAc7C,MAAM,kBACE,MAAM,gBACR,OAAO;CA0BhC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"contentAsCodeOutput.d.ts","sourceRoot":"","sources":["../../src/terminal/contentAsCodeOutput.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/D,MAAM,MAAM,uBAAuB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,0BAA0B,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACnC,SAAS,EAAE,UAAU,GAAG,QAAQ,CAAC;IACjC,KAAK,EAAE,cAAc,GAAG,SAAS,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,uBAAuB,EAAE,CAAC;CACpC,CAAC;AAEF,KAAK,0BAA0B,GAAG,IAAI,CAClC,wBAAwB,EACxB,WAAW,GAAG,OAAO,GAAG,OAAO,CAClC,GAAG;IACA,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,yBAAyB,GAAG,IAAI,CACjC,wBAAwB,EACxB,WAAW,GAAG,OAAO,GAAG,gBAAgB,GAAG,OAAO,CACrD,GAAG;IACA,UAAU,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC;CACxD,CAAC;AAkBF,eAAO,MAAM,iBAAiB,eAAgB,MAAM,WACR,CAAC;AAE7C,eAAO,MAAM,yBAAyB,mCAInC,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,QAAQ,GAAG,YAAY,CAAC,WAG3B,CAAC;AAczC,eAAO,MAAM,2BAA2B,4DAMrC,0BAA0B,WAe5B,CAAC;AAEF,eAAO,MAAM,0BAA0B,6DAMpC,yBAAyB,WAY3B,CAAC;AAEF,eAAO,MAAM,2BAA2B,uDAMrC,wBAAwB,WAW1B,CAAC;AAEF,eAAO,MAAM,0BAA0B,QAAO,OAOzC,CAAC;AAEN,eAAO,MAAM,yBAAyB,YAAa,MAAM,KAAG,IAM3D,CAAC;AAEF,eAAO,MAAM,2BAA2B,UAC7B,wBAAwB,KAChC,OAOF,CAAC;AAEF,KAAK,8BAA8B,GAAG,IAAI,CACtC,wBAAwB,EACxB,WAAW,GAAG,OAAO,CACxB,CAAC;AAEF,KAAK,yBAAyB,CAAC,CAAC,IAAI;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,0BAA0B,GAAG,SAAS,CAAC;CAClE,CAAC;AAEF,eAAO,MAAM,yBAAyB,0BAGnC,8BAA8B;uBASH,MAAM,WAAW,MAAM;2BAwBnB,MAAM;2BAcxB,MAAM,YACJ,0BAA0B;cAkBjB,CAAC,uCAKrB,yBAAyB,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC;wBAWX,CAAC,UACtB,MAAM,OAAO,CAAC,CAAC,CAAC,KACzB,OAAO,CAAC,CAAC,CAAC;;qBA+BQ,MAAM,kBAAkB,MAAM,KAAG,OAAO;mBAc7C,MAAM,kBACE,MAAM,gBACR,OAAO;CA0BhC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/terminal/contentAsCodeOutput.js

@@ -134,11 +134,35 @@ const createContentAsCodeOutput = ({ operation, scope, }) => {
         completeItem(detail(value), variant?.(value));
         return value;
     };
+    // The spinner repaints its line continuously, drawing over interactive
+    // prompts rendered beneath it — the prompt becomes invisible and the
+    // command looks hung while waiting for input. Stop the spinner for the
+    // prompt's lifetime, then resume with the current progress text.
+    const promptWhilePaused = async (prompt) => {
+        if (!spinner)
+            return prompt();
+        spinner.stop();
+        try {
+            return await prompt();
+        }
+        finally {
+            spinner.start(useTree
+                ? (0, exports.formatContentAsCodeProgress)({
+                    operation,
+                    scope,
+                    items,
+                    activeLabel,
+                    activeDetail,
+                })
+                : `${runningLabel} ${activeLabel.toLowerCase()}`);
+        }
+    };
     return {
         startItem,
         updateActive,
         completeItem,
         runItem,
+        promptWhilePaused,
         prepareForFailureDetails: () => {
             if (!useTree && spinner) {
                 spinner.stop();