@lightdash/cli 1.162.1 → 1.162.2

package/dist/handlers/compile.d.ts

@@ -13,8 +13,13 @@ export type CompileHandlerOptions = DbtCompileOptions & {
     validateWarehouseColumns?: boolean;
     partialCompilation?: boolean;
 };
+export type CompileProjectResult = {
+    explores: (Explore | ExploreError)[];
+    isProjectComplete: boolean;
+};
 export declare const hasBlockingCompileError: (explore: Explore | ExploreError) => boolean;
 export declare const stripWarehouseColumnErrors: (explore: Explore | ExploreError) => Explore | ExploreError;
+export declare const compileProject: (options: CompileHandlerOptions) => Promise<CompileProjectResult>;
 export declare const compile: (options: CompileHandlerOptions) => Promise<(Explore | ExploreError)[]>;
 export declare const compileHandler: (originalOptions: CompileHandlerOptions) => Promise<void>;
 //# sourceMappingURL=compile.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/handlers/compile.ts"],"names":[],"mappings":"AAAA,OAAO,EAMH,OAAO,EACP,YAAY,EAgBf,MAAM,mBAAmB,CAAC;AAoB3B,OAAO,EAAE,iBAAiB,EAA8B,MAAM,eAAe,CAAC;AAI9E,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,uBAAuB,YACvB,OAAO,GAAG,YAAY,KAChC,OAIW,CAAC;AAEf,eAAO,MAAM,0BAA0B,YAC1B,OAAO,GAAG,YAAY,KAChC,OAAO,GAAG,YAiBZ,CAAC;AA+NF,eAAO,MAAM,OAAO,YAAmB,qBAAqB,wCAiU3D,CAAC;AAEF,eAAO,MAAM,cAAc,oBACN,qBAAqB,kBAmCzC,CAAC"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/handlers/compile.ts"],"names":[],"mappings":"AAAA,OAAO,EAMH,OAAO,EACP,YAAY,EAgBf,MAAM,mBAAmB,CAAC;AAoB3B,OAAO,EAAE,iBAAiB,EAA8B,MAAM,eAAe,CAAC;AAI9E,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,QAAQ,EAAE,CAAC,OAAO,GAAG,YAAY,CAAC,EAAE,CAAC;IACrC,iBAAiB,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,uBAAuB,YACvB,OAAO,GAAG,YAAY,KAChC,OAIW,CAAC;AAEf,eAAO,MAAM,0BAA0B,YAC1B,OAAO,GAAG,YAAY,KAChC,OAAO,GAAG,YAiBZ,CAAC;AA+NF,eAAO,MAAM,cAAc,YACd,qBAAqB,KAC/B,OAAO,CAAC,oBAAoB,CAsU9B,CAAC;AAEF,eAAO,MAAM,OAAO,YACP,qBAAqB,KAC/B,OAAO,CAAC,CAAC,OAAO,GAAG,YAAY,CAAC,EAAE,CACO,CAAC;AAE7C,eAAO,MAAM,cAAc,oBACN,qBAAqB,kBAmCzC,CAAC"}

package/dist/handlers/compile.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.compileHandler = exports.compile = exports.stripWarehouseColumnErrors = exports.hasBlockingCompileError = void 0;
+exports.compileHandler = exports.compile = exports.compileProject = exports.stripWarehouseColumnErrors = exports.hasBlockingCompileError = void 0;
 const tslib_1 = require("tslib");
 const common_1 = require("@lightdash/common");
 const warehouses_1 = require("@lightdash/warehouses");
@@ -167,7 +167,7 @@ async function patchDeferredModels(compiledModels, originallySelectedModelIds, s
         return compiledModels;
     }
 }
-const compile = async (options) => {
+const compileProject = async (options) => {
     const dbtVersionResult = await (0, getDbtVersion_1.tryGetDbtVersion)();
     const executionId = (0, uuid_1.v4)();
     const startTime = Date.now();
@@ -191,6 +191,7 @@ const compile = async (options) => {
     // Try lightdash project compile
     let explores = null;
     let dbtMetrics = null;
+    let isProjectComplete = true;
     explores = await getExploresFromLightdashYmlProject({
         projectDir: absoluteProjectPath,
         lightdashProjectConfig,
@@ -219,6 +220,10 @@ const compile = async (options) => {
         });
         const { compiledModelIds, originallySelectedModelIds } = await (0, compile_1.maybeCompileModelsAndJoins)({ targetDir: context.targetDir }, options);
         let manifest = await (0, manifest_1.loadManifest)({ targetDir: context.targetDir });
+        const projectManifestModels = (0, common_1.getModelsFromManifest)(manifest);
+        isProjectComplete =
+            (0, common_1.getCompiledModels)(projectManifestModels, compiledModelIds)
+                .length === projectManifestModels.length;
         let effectiveCompiledModelIds = compiledModelIds;
         if (options.combineManifest) {
             const externalManifest = await (0, manifest_1.loadCombineManifest)(options.combineManifest);
@@ -376,8 +381,10 @@ const compile = async (options) => {
             durationMs: Date.now() - startTime,
         },
     });
-    return explores;
+    return { explores, isProjectComplete };
 };
+exports.compileProject = compileProject;
+const compile = async (options) => (await (0, exports.compileProject)(options)).explores;
 exports.compile = compile;
 const compileHandler = async (originalOptions) => {
     const options = { ...originalOptions };

package/dist/handlers/compileProject.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compileProject.test.d.ts.map

package/dist/handlers/compileProject.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compileProject.test.d.ts","sourceRoot":"","sources":["../../src/handlers/compileProject.test.ts"],"names":[],"mappings":""}

package/dist/handlers/compileProject.test.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const common_1 = require("@lightdash/common");
+const promises_1 = tslib_1.__importDefault(require("fs/promises"));
+const os_1 = tslib_1.__importDefault(require("os"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const context_1 = require("../dbt/context");
+const manifest_1 = require("../dbt/manifest");
+const validation_1 = require("../dbt/validation");
+const loader_1 = require("../lightdash/loader");
+const compile_1 = require("./compile");
+const compile_2 = require("./dbt/compile");
+const getDbtVersion_1 = require("./dbt/getDbtVersion");
+vi.mock('../analytics/analytics');
+vi.mock('../config', () => ({
+    getConfig: vi.fn().mockResolvedValue({ user: null, context: null }),
+}));
+vi.mock('../dbt/context');
+vi.mock('../dbt/manifest', async (importOriginal) => ({
+    ...(await importOriginal()),
+    loadCombineManifest: vi.fn(),
+    loadManifest: vi.fn(),
+}));
+vi.mock('../dbt/validation');
+vi.mock('../lightdash/loader');
+vi.mock('./dbt/compile');
+vi.mock('./dbt/getDbtVersion');
+const dbtNode = (uniqueId, resourceType, compiled) => ({
+    unique_id: uniqueId,
+    name: uniqueId.split('.').at(-1) ?? uniqueId,
+    resource_type: resourceType,
+    package_name: 'test',
+    path: `${uniqueId}.sql`,
+    original_file_path: `models/${uniqueId}.sql`,
+    alias: uniqueId.split('.').at(-1) ?? uniqueId,
+    checksum: { name: 'sha256', checksum: uniqueId },
+    tags: [],
+    refs: [],
+    sources: [],
+    depends_on: { macros: [], nodes: [] },
+    database: 'db',
+    schema: 'public',
+    fqn: ['test', uniqueId],
+    raw_code: 'SELECT 1',
+    columns: {
+        id: {
+            name: 'id',
+            data_type: common_1.DimensionType.NUMBER,
+            meta: {},
+        },
+    },
+    meta: {},
+    description: '',
+    created_at: 0,
+    language: 'sql',
+    relation_name: `"db"."public"."${uniqueId}"`,
+    config: { materialized: 'table' },
+    compiled,
+});
+const manifest = (nodes) => ({
+    metadata: {
+        dbt_schema_version: 'https://schemas.getdbt.com/dbt/manifest/v12.json',
+        generated_at: '2026-01-01T00:00:00Z',
+        adapter_type: 'postgres',
+    },
+    nodes,
+    sources: {},
+    macros: {},
+    docs: {},
+    exposures: {},
+    metrics: {},
+});
+const compileOptions = (projectDir) => ({
+    projectDir,
+    profilesDir: '',
+    target: undefined,
+    profile: undefined,
+    vars: undefined,
+    verbose: false,
+    startOfWeek: 0,
+    skipWarehouseCatalog: true,
+    skipDbtCompile: true,
+    useDbtList: false,
+    select: undefined,
+    models: undefined,
+    threads: undefined,
+    noVersionCheck: false,
+    exclude: undefined,
+    selector: undefined,
+    state: undefined,
+    fullRefresh: false,
+    defer: false,
+    targetPath: undefined,
+    favorState: false,
+    combineManifest: undefined,
+    warehouseCredentials: false,
+    disableTimestampConversion: false,
+});
+describe('compileProject completeness', () => {
+    let tempDir;
+    beforeEach(async () => {
+        vi.clearAllMocks();
+        tempDir = await promises_1.default.mkdtemp(path_1.default.join(os_1.default.tmpdir(), 'lightdash-compile-project-test-'));
+        await promises_1.default.writeFile(path_1.default.join(tempDir, 'lightdash.config.yml'), 'warehouse:\n  type: postgres\n');
+        vi.mocked(getDbtVersion_1.tryGetDbtVersion).mockResolvedValue({
+            success: true,
+            version: {
+                verboseVersion: '1.10.19',
+                versionOption: common_1.SupportedDbtVersions.V1_10,
+                isDbtCloudCLI: false,
+                isDbtFusion: false,
+            },
+        });
+        vi.mocked(context_1.getDbtContext).mockResolvedValue({
+            projectName: 'test_project',
+            profileName: 'test_profile',
+            targetDir: path_1.default.join(tempDir, 'target'),
+            modelsDir: 'models',
+        });
+        vi.mocked(loader_1.loadLightdashModels).mockResolvedValue([]);
+        vi.mocked(validation_1.validateDbtModel).mockImplementation(async (_adapter, _version, models) => ({
+            valid: models,
+            invalid: [],
+            skipped: [],
+        }));
+        vi.spyOn(console, 'error').mockImplementation(() => undefined);
+    });
+    afterEach(async () => {
+        vi.restoreAllMocks();
+        await promises_1.default.rm(tempDir, { recursive: true, force: true });
+    });
+    test('reports an unselected model and seed manifest as complete', async () => {
+        const projectManifest = manifest({
+            'model.test.orders': dbtNode('model.test.orders', 'model', true),
+            'seed.test.countries': dbtNode('seed.test.countries', 'seed', false),
+        });
+        vi.mocked(manifest_1.loadManifest).mockResolvedValue(projectManifest);
+        vi.mocked(compile_2.maybeCompileModelsAndJoins).mockResolvedValue({
+            compiledModelIds: ['model.test.orders'],
+            originallySelectedModelIds: undefined,
+        });
+        const result = await (0, compile_1.compileProject)(compileOptions(tempDir));
+        expect(result.isProjectComplete).toBe(true);
+    });
+    test('reports a selected subset as incomplete', async () => {
+        const projectManifest = manifest({
+            'model.test.orders': dbtNode('model.test.orders', 'model', true),
+            'model.test.customers': dbtNode('model.test.customers', 'model', true),
+        });
+        vi.mocked(manifest_1.loadManifest).mockResolvedValue(projectManifest);
+        vi.mocked(compile_2.maybeCompileModelsAndJoins).mockResolvedValue({
+            compiledModelIds: ['model.test.orders'],
+            originallySelectedModelIds: ['model.test.orders'],
+        });
+        const result = await (0, compile_1.compileProject)(compileOptions(tempDir));
+        expect(result.isProjectComplete).toBe(false);
+    });
+    test('derives completeness before combining an external manifest', async () => {
+        const projectManifest = manifest({
+            'model.test.orders': dbtNode('model.test.orders', 'model', true),
+        });
+        const externalManifest = manifest({
+            'model.external.compiled': dbtNode('model.external.compiled', 'model', true),
+            'model.external.uncompiled': dbtNode('model.external.uncompiled', 'model', false),
+        });
+        vi.mocked(manifest_1.loadManifest).mockResolvedValue(projectManifest);
+        vi.mocked(manifest_1.loadCombineManifest).mockResolvedValue(externalManifest);
+        vi.mocked(compile_2.maybeCompileModelsAndJoins).mockResolvedValue({
+            compiledModelIds: ['model.test.orders'],
+            originallySelectedModelIds: undefined,
+        });
+        const result = await (0, compile_1.compileProject)({
+            ...compileOptions(tempDir),
+            combineManifest: 'external-manifest.json',
+        });
+        expect(result.isProjectComplete).toBe(true);
+    });
+});

package/dist/handlers/compileWarehouseColumnValidation.test.js

@@ -310,7 +310,8 @@ describe('compile warehouse column validation', () => {
             });
             const deployRequest = vi
                 .mocked(apiClient_1.lightdashApi)
-                .mock.calls.find(([request]) => request.url === '/api/v1/projects/projectUuid/explores');
+                .mock.calls.find(([request]) => request.url ===
+                '/api/v1/projects/projectUuid/explores?complete=false');
             if (deployRequest === undefined) {
                 throw new Error('Expected explores deploy request');
             }

package/dist/handlers/deploy.d.ts

@@ -23,6 +23,7 @@ type DeployHandlerOptions = DbtCompileOptions & {
 };
 type DeployArgs = DeployHandlerOptions & {
     projectUuid: string;
+    complete?: boolean;
 };
 export declare const deploy: (explores: (Explore | ExploreError)[], options: DeployArgs) => Promise<void>;
 export declare const deployHandler: (originalOptions: DeployHandlerOptions) => Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/handlers/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,OAAO,EACP,YAAY,EASf,MAAM,mBAAmB,CAAC;AA2B3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AASlD,KAAK,oBAAoB,GAAG,iBAAiB,GAAG;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,wBAAwB,EAAE,OAAO,CAAC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,KAAK,UAAU,GAAG,oBAAoB,GAAG;IACrC,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AA8QF,eAAO,MAAM,MAAM,aACL,CAAC,OAAO,GAAG,YAAY,CAAC,EAAE,WAC3B,UAAU,KACpB,OAAO,CAAC,IAAI,CA6Id,CAAC;AAiGF,eAAO,MAAM,aAAa,oBAA2B,oBAAoB,kBAmKxE,CAAC"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/handlers/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,OAAO,EACP,YAAY,EASf,MAAM,mBAAmB,CAAC;AA2B3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AASlD,KAAK,oBAAoB,GAAG,iBAAiB,GAAG;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,wBAAwB,EAAE,OAAO,CAAC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,KAAK,UAAU,GAAG,oBAAoB,GAAG;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AA+QF,eAAO,MAAM,MAAM,aACL,CAAC,OAAO,GAAG,YAAY,CAAC,EAAE,WAC3B,UAAU,KACpB,OAAO,CAAC,IAAI,CA6Id,CAAC;AAiGF,eAAO,MAAM,aAAa,oBAA2B,oBAAoB,kBAuKxE,CAAC"}

package/dist/handlers/deploy.js

@@ -147,6 +147,7 @@ const deployBatched = async (explores, options) => {
             body: JSON.stringify({
                 explores: batch,
                 batchNumber: batchIndex,
+                complete: options.complete === true,
             }),
         }), batchIndex + 1);
         globalState_1.default.log(styles.success(`  ✓ Batch ${batchIndex + 1} uploaded (${response.exploreCount} explores)`));
@@ -237,7 +238,7 @@ const deploy = async (explores, options) => {
         try {
             const deployResponse = await (0, apiClient_1.lightdashApi)({
                 method: 'PUT',
-                url: `/api/v1/projects/${options.projectUuid}/explores`,
+                url: `/api/v1/projects/${options.projectUuid}/explores?complete=${options.complete === true}`,
                 body: deployPayload,
             });
             if (deployResponse) {
@@ -440,7 +441,7 @@ const deployHandler = async (originalOptions) => {
         options.disableTimestampConversion =
             await (0, timestampConversion_1.getProjectDisableTimestampConversion)(options.disableTimestampConversion, existingProjectSelection.projectUuid);
     }
-    const explores = await (0, compile_1.compile)(options);
+    const { explores, isProjectComplete } = await (0, compile_1.compileProject)(options);
     let projectUuid;
     if (options.create !== undefined) {
         const project = await createNewProject(executionId, options);
@@ -462,7 +463,11 @@ const deployHandler = async (originalOptions) => {
     else {
         throw new common_1.AuthorizationError(`No active Lightdash project. Run 'lightdash login --help'`);
     }
-    await (0, exports.deploy)(explores, { ...options, projectUuid });
+    await (0, exports.deploy)(explores, {
+        ...options,
+        projectUuid,
+        complete: isProjectComplete,
+    });
     const serverUrl = config.context?.serverUrl?.replace(/\/$/, '');
     let displayUrl = options.create
         ? `${serverUrl}/createProject/cli?projectUuid=${projectUuid}`

package/dist/handlers/deploy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deploy.test.d.ts.map

package/dist/handlers/deploy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.test.d.ts","sourceRoot":"","sources":["../../src/handlers/deploy.test.ts"],"names":[],"mappings":""}

package/dist/handlers/deploy.test.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const common_1 = require("@lightdash/common");
+const analytics_1 = require("../analytics/analytics");
+const lightdash_config_1 = require("../lightdash-config");
+const apiClient_1 = require("./dbt/apiClient");
+const deploy_1 = require("./deploy");
+vi.mock('../analytics/analytics');
+vi.mock('../lightdash-config');
+vi.mock('./dbt/apiClient', async (importOriginal) => ({
+    ...(await importOriginal()),
+    lightdashApi: vi.fn(),
+}));
+const compiledExplore = {
+    name: 'orders',
+    label: 'Orders',
+    tags: [],
+    tables: {},
+    baseTable: 'orders',
+    joinedTables: [],
+    targetDatabase: common_1.SupportedDbtAdapter.POSTGRES,
+};
+const deployOptions = {
+    projectDir: '/tmp/project',
+    profilesDir: '',
+    target: undefined,
+    profile: undefined,
+    vars: undefined,
+    verbose: false,
+    ignoreErrors: false,
+    validateWarehouseColumns: false,
+    projectUuid: 'project-uuid',
+    skipWarehouseCatalog: true,
+    skipDbtCompile: true,
+    useDbtList: false,
+    select: undefined,
+    models: undefined,
+    threads: undefined,
+    noVersionCheck: false,
+    exclude: undefined,
+    selector: undefined,
+    state: undefined,
+    fullRefresh: false,
+    defer: false,
+    targetPath: undefined,
+    favorState: false,
+    combineManifest: undefined,
+};
+describe('deploy completeness transport', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.mocked(lightdash_config_1.readAndLoadLightdashProjectConfig).mockResolvedValue({
+            spotlight: { default_visibility: 'show' },
+        });
+        vi.mocked(analytics_1.LightdashAnalytics.track).mockResolvedValue(undefined);
+    });
+    it.each([
+        { complete: true, expected: 'true' },
+        { complete: false, expected: 'false' },
+        { complete: undefined, expected: 'false' },
+    ])('sends complete=$expected on the default upload', async ({ complete, expected }) => {
+        vi.mocked(apiClient_1.lightdashApi).mockImplementation(async ({ url }) => {
+            if (url.includes('/explores?')) {
+                return {
+                    exploreCount: 1,
+                    warnings: {
+                        warningCount: 0,
+                        exploresWithWarnings: [],
+                    },
+                };
+            }
+            return null;
+        });
+        await (0, deploy_1.deploy)([compiledExplore], {
+            ...deployOptions,
+            complete,
+        });
+        expect(apiClient_1.lightdashApi).toHaveBeenCalledWith(expect.objectContaining({
+            method: 'PUT',
+            url: `/api/v1/projects/project-uuid/explores?complete=${expected}`,
+            body: JSON.stringify([compiledExplore]),
+        }));
+    });
+    test('includes the completeness assertion in every batch body', async () => {
+        vi.mocked(apiClient_1.lightdashApi).mockImplementation(async ({ url }) => {
+            if (url.endsWith('/deploy')) {
+                return {
+                    deploySessionUuid: 'deploy-session-uuid',
+                };
+            }
+            if (url.endsWith('/batch')) {
+                return { batchNumber: 0, exploreCount: 1 };
+            }
+            if (url.endsWith('/finalize')) {
+                return {
+                    exploreCount: 1,
+                    warnings: {
+                        warningCount: 0,
+                        exploresWithWarnings: [],
+                    },
+                    status: common_1.DeploySessionStatus.COMPLETED,
+                };
+            }
+            return null;
+        });
+        await (0, deploy_1.deploy)([compiledExplore], {
+            ...deployOptions,
+            complete: false,
+            useBatchedDeploy: true,
+        });
+        expect(apiClient_1.lightdashApi).toHaveBeenCalledWith({
+            method: 'POST',
+            url: '/api/v2/projects/project-uuid/deploy/deploy-session-uuid/batch',
+            body: JSON.stringify({
+                explores: [compiledExplore],
+                batchNumber: 0,
+                complete: false,
+            }),
+        });
+    });
+});

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

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/handlers/preview.ts"],"names":[],"mappings":"AACA,OAAO,EACH,+BAA+B,EAKlC,MAAM,mBAAmB,CAAC;AAgB3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAOlD,KAAK,qBAAqB,GAAG,iBAAiB,GAAG;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,+BAA+B,CAAC;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,wBAAwB,EAAE,OAAO,CAAC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AA2GF,eAAO,MAAM,cAAc,oBACN,qBAAqB,KACvC,OAAO,CAAC,IAAI,CAmSd,CAAC;AAEF,eAAO,MAAM,mBAAmB,oBACX,qBAAqB,KACvC,OAAO,CAAC,IAAI,CA8Kd,CAAC;AAEF,eAAO,MAAM,kBAAkB,YAClB,yBAAyB,KACnC,OAAO,CAAC,IAAI,CA0Cd,CAAC"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/handlers/preview.ts"],"names":[],"mappings":"AACA,OAAO,EACH,+BAA+B,EAKlC,MAAM,mBAAmB,CAAC;AAgB3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAOlD,KAAK,qBAAqB,GAAG,iBAAiB,GAAG;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,+BAA+B,CAAC;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,wBAAwB,EAAE,OAAO,CAAC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AA2GF,eAAO,MAAM,cAAc,oBACN,qBAAqB,KACvC,OAAO,CAAC,IAAI,CAsSd,CAAC;AAEF,eAAO,MAAM,mBAAmB,oBACX,qBAAqB,KACvC,OAAO,CAAC,IAAI,CAgLd,CAAC;AAEF,eAAO,MAAM,kBAAkB,YAClB,yBAAyB,KACnC,OAAO,CAAC,IAAI,CA0Cd,CAAC"}

package/dist/handlers/preview.js

@@ -216,10 +216,11 @@ const previewHandler = async (originalOptions) => {
         },
     });
     try {
-        const explores = await (0, compile_1.compile)(options);
+        const { explores, isProjectComplete } = await (0, compile_1.compileProject)(options);
         await (0, deploy_1.deploy)(explores, {
             ...options,
             projectUuid: project.projectUuid,
+            complete: isProjectComplete,
         });
         await (0, config_1.setPreviewProject)(project.projectUuid, name);
         process.on('SIGINT', async () => {
@@ -264,9 +265,11 @@ const previewHandler = async (originalOptions) => {
                 watcher.unwatch(manifestFilePath);
                 // Deploying will change manifest.json too, so we need to stop watching the file until it is deployed
                 if (project) {
-                    await (0, deploy_1.deploy)(await (0, compile_1.compile)(options), {
+                    const compileResult = await (0, compile_1.compileProject)(options);
+                    await (0, deploy_1.deploy)(compileResult.explores, {
                         ...options,
                         projectUuid: project.projectUuid,
+                        complete: compileResult.isProjectComplete,
                     });
                 }
                 console.error(`${styles.success('✔')}   Preview updated \n`);
@@ -348,10 +351,11 @@ const startPreviewHandler = async (originalOptions) => {
         // Update
         options.disableTimestampConversion =
             await (0, timestampConversion_1.getProjectDisableTimestampConversion)(options.disableTimestampConversion, previewProject.projectUuid);
-        const explores = await (0, compile_1.compile)(options);
+        const { explores, isProjectComplete } = await (0, compile_1.compileProject)(options);
         await (0, deploy_1.deploy)(explores, {
             ...options,
             projectUuid: previewProject.projectUuid,
+            complete: isProjectComplete,
         });
         const url = await projectUrl(previewProject);
         console.error(`Project updated on ${url}`);
@@ -408,10 +412,11 @@ const startPreviewHandler = async (originalOptions) => {
                 (0, timestampConversion_1.getDisableTimestampConversionFromProject)(project.warehouseConnection);
             globalState_1.default.debug(`> Using disable-timestamp-conversion=${String(options.disableTimestampConversion ?? false)} from preview project settings`);
         }
-        const explores = await (0, compile_1.compile)(options);
+        const { explores, isProjectComplete } = await (0, compile_1.compileProject)(options);
         await (0, deploy_1.deploy)(explores, {
             ...options,
             projectUuid: project.projectUuid,
+            complete: isProjectComplete,
         });
         const url = await projectUrl(project);
         if (!hasContentCopy) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightdash/cli",
-  "version": "1.162.1",
+  "version": "1.162.2",
   "description": "Lightdash CLI tool",
   "license": "MIT",
   "repository": {
@@ -45,8 +45,8 @@
     "unique-names-generator": "4.7.1",
     "uuid": "11.1.1",
     "yaml": "2.8.3",
-    "@lightdash/common": "1.162.1",
-    "@lightdash/warehouses": "1.162.1"
+    "@lightdash/common": "1.162.2",
+    "@lightdash/warehouses": "1.162.2"
   },
   "devDependencies": {
     "@types/inquirer": "8.2.4",