@lightdash/cli 0.2644.1 → 0.2646.0

package/dist/config.d.ts

@@ -24,6 +24,7 @@ export type Config = {
 };
 export declare const getConfig: () => Promise<Config>;
 export declare const setProject: (projectUuid: string, projectName: string) => Promise<void>;
+export declare const unsetProject: () => Promise<void>;
 export declare const setPreviewProject: (projectUuid: string, name: string) => Promise<void>;
 export declare const unsetPreviewProject: () => Promise<void>;
 export declare const setDefaultUser: (userUuid: string, organizationUuid: string) => Promise<void>;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,cAAc,QAAsC,CAAC;AAElE,MAAM,MAAM,MAAM,GAAG;IACjB,IAAI,CAAC,EAAE;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,OAAO,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB;;;WAGG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,OAAO,CAAC,EAAE;QACN,qCAAqC,CAAC,EAAE,OAAO,CAAC;KACnD,CAAC;CACL,CAAC;AAgCF,eAAO,MAAM,SAAS,QAAa,OAAO,CAAC,MAAM,CAmBhD,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,aAAa,MAAM,EAAE,aAAa,MAAM,kBAUxE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,aAAa,MAAM,EAAE,MAAM,MAAM,kBAUxE,CAAC;AAEF,eAAO,MAAM,mBAAmB,qBAU/B,CAAC;AAEF,eAAO,MAAM,cAAc,GACvB,UAAU,MAAM,EAChB,kBAAkB,MAAM,kBAW3B,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,SAAS,MAAM,CAAC,SAAS,CAAC,kBAM1D,CAAC;AAEF,eAAO,MAAM,SAAS,GAAU,QAAQ,MAAM,CAAC,SAAS,CAAC,kBAMxD,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,cAAc,QAAsC,CAAC;AAElE,MAAM,MAAM,MAAM,GAAG;IACjB,IAAI,CAAC,EAAE;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,OAAO,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB;;;WAGG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,OAAO,CAAC,EAAE;QACN,qCAAqC,CAAC,EAAE,OAAO,CAAC;KACnD,CAAC;CACL,CAAC;AAgCF,eAAO,MAAM,SAAS,QAAa,OAAO,CAAC,MAAM,CAmBhD,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,aAAa,MAAM,EAAE,aAAa,MAAM,kBAUxE,CAAC;AAEF,eAAO,MAAM,YAAY,qBAUxB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,aAAa,MAAM,EAAE,MAAM,MAAM,kBAUxE,CAAC;AAEF,eAAO,MAAM,mBAAmB,qBAU/B,CAAC;AAEF,eAAO,MAAM,cAAc,GACvB,UAAU,MAAM,EAChB,kBAAkB,MAAM,kBAW3B,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,SAAS,MAAM,CAAC,SAAS,CAAC,kBAM1D,CAAC;AAEF,eAAO,MAAM,SAAS,GAAU,QAAQ,MAAM,CAAC,SAAS,CAAC,kBAMxD,CAAC"}

package/dist/config.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setAnswer = exports.setContext = exports.setDefaultUser = exports.unsetPreviewProject = exports.setPreviewProject = exports.setProject = exports.getConfig = exports.configFilePath = void 0;
+exports.setAnswer = exports.setContext = exports.setDefaultUser = exports.unsetPreviewProject = exports.setPreviewProject = exports.unsetProject = exports.setProject = exports.getConfig = exports.configFilePath = void 0;
 const tslib_1 = require("tslib");
 const fs_1 = require("fs");
 const yaml = tslib_1.__importStar(require("js-yaml"));
@@ -68,6 +68,18 @@ const setProject = async (projectUuid, projectName) => {
     });
 };
 exports.setProject = setProject;
+const unsetProject = async () => {
+    const config = await getRawConfig();
+    await setConfig({
+        ...config,
+        context: {
+            ...(config.context || {}),
+            project: undefined,
+            projectName: undefined,
+        },
+    });
+};
+exports.unsetProject = unsetProject;
 const setPreviewProject = async (projectUuid, name) => {
     const config = await getRawConfig();
     await setConfig({

package/dist/handlers/download.d.ts

@@ -14,8 +14,13 @@ export type DownloadHandlerOptions = {
     concurrency: number;
     gzip?: boolean;
 };
+type MetadataEntry = {
+    slug: string;
+    type: 'charts' | 'dashboards';
+    downloadedAt: string;
+};
 type DownloadContentType = 'charts' | 'dashboards' | 'sqlCharts';
-export declare const downloadContent: (ids: string[], type: DownloadContentType, projectId: string, projectName: string, customPath?: string, languageMap?: boolean, nested?: boolean) => Promise<[number, string[]]>;
+export declare const downloadContent: (ids: string[], type: DownloadContentType, projectId: string, projectName: string, customPath?: string, languageMap?: boolean, nested?: boolean) => Promise<[number, string[], MetadataEntry[]]>;
 export declare const downloadHandler: (options: DownloadHandlerOptions) => Promise<void>;
 export declare const uploadHandler: (options: DownloadHandlerOptions) => Promise<void>;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/handlers/download.ts"],"names":[],"mappings":"AAqCA,MAAM,MAAM,sBAAsB,GAAG;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAmQF,KAAK,mBAAmB,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,CAAC;AAkDjE,eAAO,MAAM,eAAe,GACxB,KAAK,MAAM,EAAE,EACb,MAAM,mBAAmB,EACzB,WAAW,MAAM,EACjB,aAAa,MAAM,EACnB,aAAa,MAAM,EACnB,cAAa,OAAe,EAC5B,SAAQ,OAAe,KACxB,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CA2G5B,CAAC;AAEF,eAAO,MAAM,eAAe,GACxB,SAAS,sBAAsB,KAChC,OAAO,CAAC,IAAI,CAuKd,CAAC;AA4ZF,eAAO,MAAM,aAAa,GACtB,SAAS,sBAAsB,KAChC,OAAO,CAAC,IAAI,CA+Id,CAAC"}
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/handlers/download.ts"],"names":[],"mappings":"AA2CA,MAAM,MAAM,sBAAsB,GAAG;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AA2FF,KAAK,aAAa,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;CACxB,CAAC;AAyOF,KAAK,mBAAmB,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,CAAC;AAkDjE,eAAO,MAAM,eAAe,GACxB,KAAK,MAAM,EAAE,EACb,MAAM,mBAAmB,EACzB,WAAW,MAAM,EACjB,aAAa,MAAM,EACnB,aAAa,MAAM,EACnB,cAAa,OAAe,EAC5B,SAAQ,OAAe,KACxB,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC,CA+G7C,CAAC;AAEF,eAAO,MAAM,eAAe,GACxB,SAAS,sBAAsB,KAChC,OAAO,CAAC,IAAI,CAmMd,CAAC;AA4ZF,eAAO,MAAM,aAAa,GACtB,SAAS,sBAAsB,KAChC,OAAO,CAAC,IAAI,CAkJd,CAAC"}

package/dist/handlers/download.js

@@ -15,6 +15,7 @@ const config_1 = require("../config");
 const globalState_1 = tslib_1.__importDefault(require("../globalState"));
 const styles = tslib_1.__importStar(require("../styles"));
 const apiClient_1 = require("./dbt/apiClient");
+const metadataFile_1 = require("./metadataFile");
 const selectProject_1 = require("./selectProject");
 const getDownloadFolder = (customPath) => {
     if (customPath) {
@@ -71,29 +72,69 @@ const getFileExtension = (contentType) => {
 const writeContent = async (contentAsCode, outputDir, languageMap) => {
     const extension = getFileExtension(contentAsCode.type);
     const itemPath = path.join(outputDir, `${contentAsCode.content.slug}${extension}`);
-    const chartYml = yaml.dump(contentAsCode.content, {
+    // Strip timestamps — they go to .lightdash-metadata.json instead
+    const { updatedAt, downloadedAt, ...cleanContent } = contentAsCode.content;
+    const chartYml = yaml.dump(cleanContent, {
         quotingType: '"',
+        sortKeys: true,
     });
     await fs_1.promises.writeFile(itemPath, chartYml);
     if (contentAsCode.translationMap && languageMap) {
         const translationPath = path.join(outputDir, `${contentAsCode.content.slug}.language.map.yml`);
-        await fs_1.promises.writeFile(translationPath, yaml.dump(contentAsCode.translationMap));
+        await fs_1.promises.writeFile(translationPath, yaml.dump(contentAsCode.translationMap, { sortKeys: true }));
     }
+    const metadataType = contentAsCode.type === 'dashboard' ? 'dashboards' : 'charts';
+    let downloadedAtString;
+    if (downloadedAt instanceof Date) {
+        downloadedAtString = downloadedAt.toISOString();
+    }
+    else if (typeof downloadedAt === 'string') {
+        downloadedAtString = downloadedAt;
+    }
+    else {
+        downloadedAtString = new Date().toISOString();
+    }
+    return {
+        slug: contentAsCode.content.slug,
+        type: metadataType,
+        downloadedAt: downloadedAtString,
+    };
+};
+const hasUnsortedKeys = (obj) => {
+    if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {
+        if (Array.isArray(obj)) {
+            return obj.some(hasUnsortedKeys);
+        }
+        return false;
+    }
+    const keys = Object.keys(obj);
+    const sorted = [...keys].sort();
+    if (keys.some((key, i) => key !== sorted[i])) {
+        return true;
+    }
+    return Object.values(obj).some(hasUnsortedKeys);
 };
 const isLightdashContentFile = (folder, entry) => entry.isFile() &&
     entry.parentPath &&
     entry.parentPath.endsWith(path.sep + folder) &&
     entry.name.endsWith('.yml') &&
     !entry.name.endsWith('.language.map.yml');
-const loadYamlFile = async (file) => {
+const loadYamlFile = async (file, folder, metadata) => {
     const filePath = path.join(file.parentPath, file.name);
     const [fileContent, stats] = await Promise.all([
         fs_1.promises.readFile(filePath, 'utf-8'),
         fs_1.promises.stat(filePath),
     ]);
     const item = yaml.load(fileContent);
-    const downloadedAt = item.downloadedAt
-        ? new Date(item.downloadedAt)
+    if (hasUnsortedKeys(item)) {
+        globalState_1.default.log(styles.warning(`Warning: ${file.name} has unsorted YAML keys. Re-download to fix, or sort keys alphabetically.`));
+    }
+    const metadataSection = folder === 'dashboards' ? metadata.dashboards : metadata.charts;
+    const downloadedAtRaw = metadataSection[item.slug] ?? item.downloadedAt;
+    const downloadedAt = downloadedAtRaw
+        ? new Date(downloadedAtRaw instanceof Date
+            ? downloadedAtRaw.getTime()
+            : downloadedAtRaw)
         : undefined;
     const needsUpdating = downloadedAt &&
         Math.abs(stats.mtime.getTime() - downloadedAt.getTime()) > 30000;
@@ -111,13 +152,14 @@ const readCodeFiles = async (folder, customPath) => {
         throw new Error(`Node.js v20.12.0 or later is required for this command (current: ${process.version}).`);
     }
     try {
+        const metadata = await (0, metadataFile_1.readMetadataFile)(baseDir);
         const allEntries = await fs_1.promises.readdir(baseDir, {
             recursive: true,
             withFileTypes: true,
         });
         const items = await Promise.all(allEntries
             .filter((entry) => isLightdashContentFile(folder, entry))
-            .map((file) => loadYamlFile(file)));
+            .map((file) => loadYamlFile(file, folder, metadata)));
         if (items.length === 0) {
             console.error(styles.warning(`Unable to upload ${folder}, no files found in "${baseDir}". Run download command first.`));
         }
@@ -140,16 +182,19 @@ const groupBySpace = (items) => {
 };
 const writeSpaceContent = async ({ projectName, spaceSlug, folder, contentType, contentInSpace, contentAsCode, customPath, languageMap, folderScheme, }) => {
     const outputDir = await createDirForContent(projectName, spaceSlug, folder, customPath, folderScheme);
+    const entries = [];
     for (const { item, index } of contentInSpace) {
         const translationMap = 'languageMap' in contentAsCode
             ? contentAsCode.languageMap?.[index]
             : undefined;
-        await writeContent({
+        const entry = await writeContent({
             type: contentType,
             content: item,
             translationMap,
         }, outputDir, languageMap);
+        entries.push(entry);
     }
+    return entries;
 };
 const getContentTypeConfig = (type, projectId) => {
     switch (type) {
@@ -191,6 +236,7 @@ const downloadContent = async (ids, type, projectId, projectName, customPath, la
     let offset = 0;
     let total = 0;
     let chartSlugs = [];
+    let allMetadataEntries = [];
     do {
         globalState_1.default.debug(`Downloading ${config.displayName} with offset "${offset}" and filters "${contentFilters}"`);
         const commonParams = config.supportsLanguageMap
@@ -214,7 +260,7 @@ const downloadContent = async (ids, type, projectId, projectName, customPath, la
         if ('sqlCharts' in results) {
             const sqlChartsBySpace = groupBySpace(results.sqlCharts);
             for (const [spaceSlug, sqlChartsInSpace] of Object.entries(sqlChartsBySpace)) {
-                await writeSpaceContent({
+                const entries = await writeSpaceContent({
                     projectName,
                     spaceSlug,
                     folder: 'charts',
@@ -225,12 +271,13 @@ const downloadContent = async (ids, type, projectId, projectName, customPath, la
                     languageMap,
                     folderScheme,
                 });
+                allMetadataEntries = [...allMetadataEntries, ...entries];
             }
         }
         else if ('dashboards' in results) {
             const dashboardsBySpace = groupBySpace(results.dashboards);
             for (const [spaceSlug, dashboardsInSpace] of Object.entries(dashboardsBySpace)) {
-                await writeSpaceContent({
+                const entries = await writeSpaceContent({
                     projectName,
                     spaceSlug,
                     folder: 'dashboards',
@@ -241,6 +288,7 @@ const downloadContent = async (ids, type, projectId, projectName, customPath, la
                     languageMap,
                     folderScheme,
                 });
+                allMetadataEntries = [...allMetadataEntries, ...entries];
             }
             chartSlugs = [
                 ...chartSlugs,
@@ -250,7 +298,7 @@ const downloadContent = async (ids, type, projectId, projectName, customPath, la
         else {
             const chartsBySpace = groupBySpace(results.charts);
             for (const [spaceSlug, chartsInSpace] of Object.entries(chartsBySpace)) {
-                await writeSpaceContent({
+                const entries = await writeSpaceContent({
                     projectName,
                     spaceSlug,
                     folder: 'charts',
@@ -261,12 +309,13 @@ const downloadContent = async (ids, type, projectId, projectName, customPath, la
                     languageMap,
                     folderScheme,
                 });
+                allMetadataEntries = [...allMetadataEntries, ...entries];
             }
         }
         offset = results.offset;
         total = results.total;
     } while (offset < total);
-    return [total, [...new Set(chartSlugs)]];
+    return [total, [...new Set(chartSlugs)], allMetadataEntries];
 };
 exports.downloadContent = downloadContent;
 const downloadHandler = async (options) => {
@@ -278,7 +327,12 @@ const downloadHandler = async (options) => {
     }
     const projectSelection = await (0, selectProject_1.selectProject)(config, options.project);
     if (!projectSelection) {
-        throw new Error('No project selected. Run lightdash config set-project');
+        throw new common_1.LightdashError({
+            message: 'No project selected. Run lightdash config set-project',
+            name: 'Not Found',
+            statusCode: 404,
+            data: {},
+        });
     }
     const projectId = projectSelection.projectUuid;
     // Log current project info
@@ -305,20 +359,21 @@ const downloadHandler = async (options) => {
         },
     });
     try {
-        // If any filter is provided, we skip those items without filters
-        // eg: if a --charts filter is provided, we skip dashboards if no --dashboards filter is provided
         const hasFilters = options.charts.length > 0 || options.dashboards.length > 0;
+        let allMetadataEntries = [];
         // Download regular charts
         if (hasFilters && options.charts.length === 0) {
             console.info(styles.warning(`No charts filters provided, skipping`));
         }
         else {
-            const [regularChartTotal] = await (0, exports.downloadContent)(options.charts, 'charts', projectId, projectName, options.path, options.languageMap, options.nested);
+            const [regularChartTotal, , regularChartMeta] = await (0, exports.downloadContent)(options.charts, 'charts', projectId, projectName, options.path, options.languageMap, options.nested);
             spinner.succeed(`Downloaded ${regularChartTotal} charts`);
+            allMetadataEntries = [...allMetadataEntries, ...regularChartMeta];
             // Download SQL charts
             spinner.start(`Downloading SQL charts`);
-            const [sqlChartTotal] = await (0, exports.downloadContent)(options.charts, 'sqlCharts', projectId, projectName, options.path, options.languageMap, options.nested);
+            const [sqlChartTotal, , sqlChartMeta] = await (0, exports.downloadContent)(options.charts, 'sqlCharts', projectId, projectName, options.path, options.languageMap, options.nested);
             spinner.succeed(`Downloaded ${sqlChartTotal} SQL charts`);
+            allMetadataEntries = [...allMetadataEntries, ...sqlChartMeta];
             chartTotal = regularChartTotal + sqlChartTotal;
         }
         // Download dashboards
@@ -327,18 +382,34 @@ const downloadHandler = async (options) => {
         }
         else {
             let chartSlugs = [];
-            [dashboardTotal, chartSlugs] = await (0, exports.downloadContent)(options.dashboards, 'dashboards', projectId, projectName, options.path, options.languageMap, options.nested);
+            let dashMeta;
+            [dashboardTotal, chartSlugs, dashMeta] = await (0, exports.downloadContent)(options.dashboards, 'dashboards', projectId, projectName, options.path, options.languageMap, options.nested);
+            allMetadataEntries = [...allMetadataEntries, ...dashMeta];
             spinner.succeed(`Downloaded ${dashboardTotal} dashboards`);
-            // If any filter is provided, we download all charts linked to these dashboards
-            // We don't need to do this if we download everything (no filters)
             if (hasFilters && chartSlugs.length > 0) {
                 spinner.start(`Downloading ${chartSlugs.length} charts linked to dashboards`);
-                // Download both regular charts and SQL charts linked to dashboards
-                const [regularCharts] = await (0, exports.downloadContent)(chartSlugs, 'charts', projectId, projectName, options.path, options.languageMap, options.nested);
-                const [sqlCharts] = await (0, exports.downloadContent)(chartSlugs, 'sqlCharts', projectId, projectName, options.path, options.languageMap, options.nested);
+                const [regularCharts, , linkedChartMeta] = await (0, exports.downloadContent)(chartSlugs, 'charts', projectId, projectName, options.path, options.languageMap, options.nested);
+                allMetadataEntries = [
+                    ...allMetadataEntries,
+                    ...linkedChartMeta,
+                ];
+                const [sqlCharts, , linkedSqlMeta] = await (0, exports.downloadContent)(chartSlugs, 'sqlCharts', projectId, projectName, options.path, options.languageMap, options.nested);
+                allMetadataEntries = [...allMetadataEntries, ...linkedSqlMeta];
                 spinner.succeed(`Downloaded ${regularCharts + sqlCharts} charts linked to dashboards`);
             }
         }
+        // Write metadata file with all downloadedAt timestamps
+        const metadataToWrite = {
+            version: 1,
+            charts: {},
+            dashboards: {},
+        };
+        for (const entry of allMetadataEntries) {
+            metadataToWrite[entry.type][entry.slug] = entry.downloadedAt;
+        }
+        const baseDir = getDownloadFolder(options.path);
+        await (0, metadataFile_1.writeMetadataFile)(baseDir, metadataToWrite);
+        globalState_1.default.log(styles.warning(`\nNote: ${metadataFile_1.METADATA_FILENAME} was written to ${baseDir}. Consider adding it to your .gitignore.`));
         const end = Date.now();
         await analytics_1.LightdashAnalytics.track({
             event: 'download.completed',
@@ -348,7 +419,7 @@ const downloadHandler = async (options) => {
                 projectId,
                 chartsNum: chartTotal,
                 dashboardsNum: dashboardTotal,
-                timeToCompleted: (end - start) / 1000, // in seconds
+                timeToCompleted: (end - start) / 1000,
             },
         });
     }
@@ -612,7 +683,12 @@ const uploadHandler = async (options) => {
     }
     const projectSelection = await (0, selectProject_1.selectProject)(config, options.project);
     if (!projectSelection) {
-        throw new Error('No project selected. Run lightdash config set-project');
+        throw new common_1.LightdashError({
+            message: 'No project selected. Run lightdash config set-project',
+            name: 'Not Found',
+            statusCode: 404,
+            data: {},
+        });
     }
     const projectId = projectSelection.projectUuid;
     // Log current project info

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

@@ -1 +1 @@
-{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/handlers/login.ts"],"names":[],"mappings":"AAkBA,KAAK,YAAY,GAAG;IAChB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AA4JF,eAAO,MAAM,KAAK,GACd,UAAU,MAAM,GAAG,SAAS,EAC5B,SAAS,YAAY,kBAmJxB,CAAC"}
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/handlers/login.ts"],"names":[],"mappings":"AAkBA,KAAK,YAAY,GAAG;IAChB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AA4JF,eAAO,MAAM,KAAK,GACd,UAAU,MAAM,GAAG,SAAS,EAC5B,SAAS,YAAY,kBA2JxB,CAAC"}

package/dist/handlers/login.js

@@ -221,11 +221,14 @@ const login = async (urlInput, options) => {
             await (0, setProject_1.setFirstProject)();
         }
         else {
-            const project = await (0, setProject_1.setProjectCommand)();
-            if (project === undefined) {
+            const result = await (0, setProject_1.setProjectCommand)();
+            if (result === 'empty') {
                 console.error('Now you can add your first project to lightdash by doing: ');
                 console.error(`\n  ${styles.bold(`⚡️ lightdash deploy --create`)}\n`);
             }
+            else if (result === 'skipped') {
+                console.error(`\n  No project selected — use ${styles.bold('lightdash config set-project')} or ${styles.bold('--project <uuid>')} when running commands.\n`);
+            }
         }
     }
     catch {

package/dist/handlers/metadataFile.d.ts

@@ -0,0 +1,9 @@
+export declare const METADATA_FILENAME = ".lightdash-metadata.json";
+export type LightdashMetadata = {
+    version: 1;
+    charts: Record<string, string>;
+    dashboards: Record<string, string>;
+};
+export declare const readMetadataFile: (baseDir: string) => Promise<LightdashMetadata>;
+export declare const writeMetadataFile: (baseDir: string, metadata: LightdashMetadata) => Promise<void>;
+//# sourceMappingURL=metadataFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadataFile.d.ts","sourceRoot":"","sources":["../../src/handlers/metadataFile.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AAE5D,MAAM,MAAM,iBAAiB,GAAG;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,CAAC;AAQF,eAAO,MAAM,gBAAgB,GACzB,SAAS,MAAM,KAChB,OAAO,CAAC,iBAAiB,CAQ3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC1B,SAAS,MAAM,EACf,UAAU,iBAAiB,KAC5B,OAAO,CAAC,IAAI,CASd,CAAC"}

package/dist/handlers/metadataFile.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeMetadataFile = exports.readMetadataFile = exports.METADATA_FILENAME = void 0;
+const tslib_1 = require("tslib");
+const fs_1 = require("fs");
+const path = tslib_1.__importStar(require("path"));
+exports.METADATA_FILENAME = '.lightdash-metadata.json';
+const emptyMetadata = () => ({
+    version: 1,
+    charts: {},
+    dashboards: {},
+});
+const readMetadataFile = async (baseDir) => {
+    const filePath = path.join(baseDir, exports.METADATA_FILENAME);
+    try {
+        const content = await fs_1.promises.readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return emptyMetadata();
+    }
+};
+exports.readMetadataFile = readMetadataFile;
+const writeMetadataFile = async (baseDir, metadata) => {
+    const existing = await (0, exports.readMetadataFile)(baseDir);
+    const merged = {
+        version: 1,
+        charts: { ...existing.charts, ...metadata.charts },
+        dashboards: { ...existing.dashboards, ...metadata.dashboards },
+    };
+    const filePath = path.join(baseDir, exports.METADATA_FILENAME);
+    await fs_1.promises.writeFile(filePath, JSON.stringify(merged, null, 2));
+};
+exports.writeMetadataFile = writeMetadataFile;

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

@@ -1 +1 @@
-{"version":3,"file":"renameHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/renameHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAKH,UAAU,EAEb,MAAM,mBAAmB,CAAC;AAkB3B,KAAK,oBAAoB,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACrB,CAAC;AAsCF,eAAO,MAAM,aAAa,GAAU,SAAS,oBAAoB,kBAgMhE,CAAC"}
+{"version":3,"file":"renameHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/renameHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAMH,UAAU,EAEb,MAAM,mBAAmB,CAAC;AAkB3B,KAAK,oBAAoB,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACrB,CAAC;AAsCF,eAAO,MAAM,aAAa,GAAU,SAAS,oBAAoB,kBAmMhE,CAAC"}

package/dist/handlers/renameHandler.js

@@ -48,7 +48,12 @@ const renameHandler = async (options) => {
         config.context.previewProject ||
         config.context.project;
     if (!projectUuid) {
-        throw new Error('No project selected. Run lightdash config set-project');
+        throw new common_1.LightdashError({
+            message: 'No project selected. Run lightdash config set-project',
+            name: 'Not Found',
+            statusCode: 404,
+            data: {},
+        });
     }
     // Log current project info
     if (options.project) {

package/dist/handlers/setProject.d.ts

@@ -3,8 +3,12 @@ type SetProjectOptions = {
     name: string;
     uuid: string;
 };
-export declare const setProjectCommand: (name?: string, uuid?: string) => Promise<void>;
+export declare const setProjectCommand: (name?: string, uuid?: string) => Promise<"selected" | "skipped" | "empty">;
 export declare const setFirstProject: () => Promise<void>;
 export declare const setProjectHandler: (options: SetProjectOptions) => Promise<void>;
+export declare const unsetProjectCommand: () => Promise<void>;
+export declare const unsetProjectHandler: (options: {
+    verbose: boolean;
+}) => Promise<void>;
 export {};
 //# sourceMappingURL=setProject.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"setProject.d.ts","sourceRoot":"","sources":["../../src/handlers/setProject.ts"],"names":[],"mappings":"AAQA,KAAK,iBAAiB,GAAG;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,OAAO,MAAM,EAAE,OAAO,MAAM,kBAuDnE,CAAC;AAEF,eAAO,MAAM,eAAe,qBAmB3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,SAAS,iBAAiB,kBAmBjE,CAAC"}
+{"version":3,"file":"setProject.d.ts","sourceRoot":"","sources":["../../src/handlers/setProject.ts"],"names":[],"mappings":"AAQA,KAAK,iBAAiB,GAAG;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC1B,OAAO,MAAM,EACb,OAAO,MAAM,KACd,OAAO,CAAC,UAAU,GAAG,SAAS,GAAG,OAAO,CAmE1C,CAAC;AAEF,eAAO,MAAM,eAAe,qBAmB3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,SAAS,iBAAiB,kBAsBjE,CAAC;AAEF,eAAO,MAAM,mBAAmB,qBAG/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAU,SAAS;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,kBAmBtE,CAAC"}

package/dist/handlers/setProject.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setProjectHandler = exports.setFirstProject = exports.setProjectCommand = void 0;
+exports.unsetProjectHandler = exports.unsetProjectCommand = exports.setProjectHandler = exports.setFirstProject = exports.setProjectCommand = void 0;
 const tslib_1 = require("tslib");
 const inquirer_1 = tslib_1.__importDefault(require("inquirer"));
 const url_1 = require("url");
@@ -16,7 +16,7 @@ const setProjectCommand = async (name, uuid) => {
     });
     globalState_1.default.debug(`> Set project returned response: ${JSON.stringify(projects)}`);
     if (projects.length === 0)
-        return;
+        return 'empty';
     let selectedProject;
     // --uuid or --name options
     if (uuid !== undefined || name !== undefined) {
@@ -27,16 +27,27 @@ const setProjectCommand = async (name, uuid) => {
         [selectedProject] = projects;
     }
     else {
+        const SKIP_VALUE = '__skip__';
         const answers = await inquirer_1.default.prompt([
             {
                 type: 'list',
                 name: 'project',
-                choices: projects.map((project) => ({
-                    name: project.name,
-                    value: project.projectUuid,
-                })),
+                choices: [
+                    {
+                        name: "Don't select a project",
+                        value: SKIP_VALUE,
+                    },
+                    ...projects.map((project) => ({
+                        name: project.name,
+                        value: project.projectUuid,
+                    })),
+                ],
             },
         ]);
+        if (answers.project === SKIP_VALUE) {
+            await (0, config_1.unsetProject)();
+            return 'skipped';
+        }
         selectedProject = projects.find((project) => project.projectUuid === answers.project);
     }
     if (selectedProject !== undefined) {
@@ -45,10 +56,9 @@ const setProjectCommand = async (name, uuid) => {
         const projectUrl = config.context?.serverUrl &&
             new url_1.URL(`/projects/${selectedProject.projectUuid}/home`, config.context.serverUrl);
         console.error(`\n  ✅️ Connected to Lightdash project: ${projectUrl || ''}\n`);
+        return 'selected';
     }
-    else {
-        throw new Error(`Project not found.`);
-    }
+    throw new Error(`Project not found.`);
 };
 exports.setProjectCommand = setProjectCommand;
 const setFirstProject = async () => {
@@ -70,7 +80,10 @@ const setProjectHandler = async (options) => {
     let success = true;
     globalState_1.default.setVerbose(options.verbose);
     try {
-        await (0, exports.setProjectCommand)(options.name, options.uuid);
+        const result = await (0, exports.setProjectCommand)(options.name, options.uuid);
+        if (result === 'skipped') {
+            console.error(`\n  Project unset.\n`);
+        }
     }
     catch (e) {
         success = false;
@@ -88,3 +101,31 @@ const setProjectHandler = async (options) => {
     }
 };
 exports.setProjectHandler = setProjectHandler;
+const unsetProjectCommand = async () => {
+    await (0, config_1.unsetProject)();
+    console.error(`\n  Project unset.\n`);
+};
+exports.unsetProjectCommand = unsetProjectCommand;
+const unsetProjectHandler = async (options) => {
+    const startTime = Date.now();
+    let success = true;
+    globalState_1.default.setVerbose(options.verbose);
+    try {
+        await (0, exports.unsetProjectCommand)();
+    }
+    catch (e) {
+        success = false;
+        throw e;
+    }
+    finally {
+        await analytics_1.LightdashAnalytics.track({
+            event: 'command.executed',
+            properties: {
+                command: 'unset-project',
+                durationMs: Date.now() - startTime,
+                success,
+            },
+        });
+    }
+};
+exports.unsetProjectHandler = unsetProjectHandler;

package/dist/index.js

@@ -111,7 +111,9 @@ ${styles.bold('Examples:')}
   ${styles.title('⚡')}️lightdash ${styles.bold('login')} http://localhost:3000 --email demo@lightdash.com ${styles.secondary('-- Local dev only: prompts for password securely')}
 `)
     .option('--token <token>', 'Login with an API access token', undefined)
-    .option('--project <project uuid>', 'Select a project by UUID after login', parseProjectArgument, undefined)
+    .addOption(new commander_1.Option('--project <project uuid>', 'Select a project by UUID after login')
+    .argParser(parseProjectArgument)
+    .conflicts('skipProjectSelection'))
     .option('--email <email>', 'Login with email and password', undefined)
     .option('--oauth-port <port>', 'Port for the local OAuth callback server (default: random available port)', (value) => {
     const port = parseInt(value, 10);
@@ -143,6 +145,11 @@ configProgram
     .description('Show the currently selected project')
     .option('--verbose', undefined, false)
     .action(getProject_1.getProjectHandler);
+configProgram
+    .command('unset-project')
+    .description('Clear the currently selected project')
+    .option('--verbose', undefined, false)
+    .action(setProject_1.unsetProjectHandler);
 const dbtProgram = commander_1.program.command('dbt').description('Runs dbt commands');
 dbtProgram
     .command('run')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightdash/cli",
-  "version": "0.2644.1",
+  "version": "0.2646.0",
   "description": "Lightdash CLI tool",
   "license": "MIT",
   "repository": {
@@ -40,8 +40,8 @@
     "unique-names-generator": "^4.7.1",
     "uuid": "^11.0.3",
     "yaml": "^2.7.0",
-    "@lightdash/warehouses": "0.2644.1",
-    "@lightdash/common": "0.2644.1"
+    "@lightdash/common": "0.2646.0",
+    "@lightdash/warehouses": "0.2646.0"
   },
   "devDependencies": {
     "@types/inquirer": "^8.2.1",