@hubspot/cli 8.0.11-experimental.0 → 8.0.11-experimental.1

package/lib/projects/localDev/helpers/project.d.ts

@@ -2,11 +2,12 @@ import { type IntermediateRepresentationNode, type IntermediateRepresentationNod
 import { Build } from '@hubspot/local-dev-lib/types/Build';
 import { Project } from '@hubspot/local-dev-lib/types/Project';
 import { ProjectConfig } from '../../../../types/Projects.js';
-export declare function createNewProjectForLocalDev(projectConfig: ProjectConfig, targetAccountId: number, shouldCreateWithoutConfirmation: boolean, hasPublicApps: boolean): Promise<Project>;
-export declare function createInitialBuildForNewProject(projectConfig: ProjectConfig, projectDir: string, targetAccountId: number, sendIR?: boolean, profile?: string): Promise<Build>;
+import { ExitFunction } from '../../../../types/Yargs.js';
+export declare function createNewProjectForLocalDev(projectConfig: ProjectConfig, targetAccountId: number, shouldCreateWithoutConfirmation: boolean, hasPublicApps: boolean, exit: ExitFunction): Promise<Project>;
+export declare function createInitialBuildForNewProject(projectConfig: ProjectConfig, projectDir: string, targetAccountId: number, exit: ExitFunction, sendIR?: boolean, profile?: string): Promise<Build>;
 export declare function compareLocalProjectToDeployed(projectConfig: ProjectConfig, accountId: number, deployedBuildId: number | undefined, localProjectNodes: {
     [key: string]: IntermediateRepresentationNodeLocalDev;
-}, profile?: string): Promise<void>;
+}, exit: ExitFunction, profile?: string): Promise<void>;
 export declare function getDeployedProjectNodes(projectConfig: ProjectConfig, accountId: number, deployedBuildId: number, profile?: string): Promise<{
     [key: string]: IntermediateRepresentationNode;
 }>;

package/lib/projects/localDev/helpers/project.js

@@ -8,7 +8,7 @@ import { sanitizeFileName } from '@hubspot/local-dev-lib/path';
 import { isDeepEqual } from '@hubspot/local-dev-lib/isDeepEqual';
 import { translate, } from '@hubspot/project-parsing-lib/translate';
 import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
-import { PROJECT_ERROR_TYPES, PROJECT_BUILD_TEXT, PROJECT_DEPLOY_TEXT, } from '../../../constants.js';
+import { PROJECT_ERROR_TYPES, PROJECT_BUILD_TEXT, PROJECT_DEPLOY_TEXT, PROJECT_CONFIG_FILE, } from '../../../constants.js';
 import { lib } from '../../../../lang/en.js';
 import { uiLogger } from '../../../ui/logger.js';
 import { uiLine } from '../../../ui/index.js';
@@ -22,7 +22,7 @@ import { debugError, logError } from '../../../errorHandlers/index.js';
 import { ApiErrorContext } from '../../../errorHandlers/index.js';
 import { getProjectPackageJsonLocations, hasMissingPackages, installPackages, } from '../../../dependencyManagement.js';
 // Prompt the user to create a new project if one doesn't exist on their target account
-export async function createNewProjectForLocalDev(projectConfig, targetAccountId, shouldCreateWithoutConfirmation, hasPublicApps) {
+export async function createNewProjectForLocalDev(projectConfig, targetAccountId, shouldCreateWithoutConfirmation, hasPublicApps, exit) {
     // Create the project without prompting if this is a newly created sandbox
     let shouldCreateProject = shouldCreateWithoutConfirmation;
     if (!shouldCreateProject) {
@@ -54,7 +54,7 @@ export async function createNewProjectForLocalDev(projectConfig, targetAccountId
             SpinniesManager.fail('createProject');
             uiLogger.log(lib.localDevHelpers.project.createNewProjectForLocalDev
                 .failedToCreateProject);
-            process.exit(EXIT_CODES.ERROR);
+            return exit(EXIT_CODES.ERROR);
         }
     }
     else {
@@ -62,24 +62,24 @@ export async function createNewProjectForLocalDev(projectConfig, targetAccountId
         uiLogger.log('');
         uiLogger.log(lib.localDevHelpers.project.createNewProjectForLocalDev
             .choseNotToCreateProject);
-        process.exit(EXIT_CODES.SUCCESS);
+        return exit(EXIT_CODES.SUCCESS);
     }
 }
-function projectUploadCallback(accountId, projectConfig, tempFile, buildId) {
+function projectUploadCallback(accountId, projectConfig, tempFile, exit, buildId) {
     if (!buildId) {
         uiLogger.error(lib.localDevHelpers.project.createInitialBuildForNewProject.genericError);
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     return pollProjectBuildAndDeploy(accountId, projectConfig, tempFile, buildId, true);
 }
 // Create an initial build if the project was newly created in the account
 // Return the newly deployed build
-export async function createInitialBuildForNewProject(projectConfig, projectDir, targetAccountId, sendIR, profile) {
+export async function createInitialBuildForNewProject(projectConfig, projectDir, targetAccountId, exit, sendIR, profile) {
     const { result: initialUploadResult, uploadError } = await handleProjectUpload({
         accountId: targetAccountId,
         projectConfig,
         projectDir,
-        callbackFunc: projectUploadCallback,
+        callbackFunc: (accountId, config, tempFile, buildId) => projectUploadCallback(accountId, config, tempFile, exit, buildId),
         uploadMessage: lib.localDevHelpers.project.createInitialBuildForNewProject
             .initialUploadMessage,
         forceCreate: true,
@@ -102,7 +102,7 @@ export async function createInitialBuildForNewProject(projectConfig, projectDir,
                 projectName: projectConfig.name,
             }));
         }
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     if (!initialUploadResult?.succeeded) {
         let subTasks = [];
@@ -120,15 +120,15 @@ export async function createInitialBuildForNewProject(projectConfig, projectDir,
             uiLogger.error(failedSubTask.errorMessage);
         });
         uiLogger.log('');
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     return initialUploadResult.buildResult;
 }
-export async function compareLocalProjectToDeployed(projectConfig, accountId, deployedBuildId, localProjectNodes, profile) {
+export async function compareLocalProjectToDeployed(projectConfig, accountId, deployedBuildId, localProjectNodes, exit, profile) {
     uiLogger.log('');
     if (!deployedBuildId) {
         uiLogger.error(lib.localDevHelpers.project.compareLocalProjectToDeployed.noDeployedBuild(projectConfig.name, uiAccountDescription(accountId)));
-        process.exit(EXIT_CODES.SUCCESS);
+        return exit(EXIT_CODES.SUCCESS);
     }
     SpinniesManager.add('compareLocalProjectToDeployed', {
         text: lib.localDevHelpers.project.compareLocalProjectToDeployed.checking,
@@ -146,7 +146,7 @@ export async function compareLocalProjectToDeployed(projectConfig, accountId, de
         });
         uiLogger.log('');
         uiLogger.log(lib.localDevHelpers.project.compareLocalProjectToDeployed.notUpToDateExplanation(profile));
-        process.exit(EXIT_CODES.SUCCESS);
+        return exit(EXIT_CODES.SUCCESS);
     }
 }
 export async function getDeployedProjectNodes(projectConfig, accountId, deployedBuildId, profile) {
@@ -155,7 +155,23 @@ export async function getDeployedProjectNodes(projectConfig, accountId, deployed
         tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'hubspot-project-compare-'));
         const { data: zippedProject } = await downloadProject(accountId, projectConfig.name, deployedBuildId);
         await extractZipArchive(zippedProject, sanitizeFileName(projectConfig.name), tempDir, { hideLogs: true });
-        const deployedProjectSourceDir = path.join(tempDir, projectConfig.srcDir);
+        // Read the deployed project's hsproject.json to get its srcDir
+        // Deployed projects always use "src" as the srcDir
+        const possibleProjectPaths = [
+            path.join(tempDir, PROJECT_CONFIG_FILE),
+            path.join(tempDir, sanitizeFileName(projectConfig.name), PROJECT_CONFIG_FILE),
+        ];
+        let deployedSrcDir = 'src';
+        for (const projectJsonPath of possibleProjectPaths) {
+            if (await fs.pathExists(projectJsonPath)) {
+                const deployedProjectConfig = await fs.readJson(projectJsonPath);
+                if (deployedProjectConfig.srcDir) {
+                    deployedSrcDir = deployedProjectConfig.srcDir;
+                }
+                break;
+            }
+        }
+        const deployedProjectSourceDir = path.join(tempDir, deployedSrcDir);
         const { intermediateNodesIndexedByUid } = await translate({
             projectSourceDir: deployedProjectSourceDir,
             platformVersion: projectConfig.platformVersion,
@@ -211,6 +227,6 @@ export async function checkAndInstallDependencies() {
             text: lib.localDevHelpers.project.checkAndInstallDependencies
                 .dependenciesFailure,
         });
-        process.exit(EXIT_CODES.ERROR);
+        throw e;
     }
 }

package/lib/projects/projectInfo.d.ts

@@ -1,22 +1,5 @@
 import { Project } from '@hubspot/local-dev-lib/types/Project';
-export type ProjectInfo = {
-    projectName: string;
-    platformVersion: string;
-    projectId: number;
-    deployedBuildId: number;
-    autoDeployEnabled: boolean;
-    projectUrl?: string;
-    app?: {
-        name: string;
-        id: number;
-        uid: string;
-        authType?: string;
-        distributionType?: string;
-    };
-    components: {
-        uid: string;
-        type: string;
-    }[];
-};
+import { ProjectInfo } from '../../types/Projects.js';
+export type { ProjectInfo };
 export declare function getProjectInfo(project: Project, platformVersion: string, accountId: number): Promise<ProjectInfo>;
-export declare function renderProjectInfo(projectInfo: ProjectInfo): Promise<void>;
+export declare function logProjectInfo(projectInfo: ProjectInfo): void;

package/lib/projects/projectInfo.js

@@ -1,15 +1,11 @@
-import React from 'react';
+import chalk from 'chalk';
 import { fetchAppMetadataBySourceId } from '@hubspot/local-dev-lib/api/appsDev';
+import { APP_KEY, USER_FACING_TO_INTERNAL_TYPE, } from '@hubspot/project-parsing-lib/constants';
 import { debugError } from '../errorHandlers/index.js';
 import { getProjectDetailUrl } from './urls.js';
 import { commands } from '../../lang/en.js';
-import { uiLink } from '../ui/index.js';
-import { renderInline } from '../../ui/render.js';
-import { getBoxWithTitle } from '../../ui/components/BoxWithTitle.js';
-import { getTable } from '../../ui/components/Table.js';
-import { mapTableDataToObjects } from '../../ui/lib/table.js';
-import { INK_COLORS } from '../../ui/styles.js';
-const APPLICATION_BUILD_TYPE = 'APPLICATION';
+import { uiLine, uiLink } from '../ui/index.js';
+import { uiLogger } from '../ui/logger.js';
 export async function getProjectInfo(project, platformVersion, accountId) {
     const deployedBuild = project.deployedBuild;
     const projectInfo = {
@@ -24,7 +20,7 @@ export async function getProjectInfo(project, platformVersion, accountId) {
     if (projectUrl) {
         projectInfo.projectUrl = projectUrl;
     }
-    const appSubbuild = deployedBuild.subbuildStatuses.find(s => s.buildType === APPLICATION_BUILD_TYPE);
+    const appSubbuild = deployedBuild.subbuildStatuses.find(s => s.buildType === USER_FACING_TO_INTERNAL_TYPE[APP_KEY]);
     if (appSubbuild) {
         try {
             const { data: appMetadata } = await fetchAppMetadataBySourceId(project.id, appSubbuild.buildName, accountId);
@@ -41,64 +37,46 @@ export async function getProjectInfo(project, platformVersion, accountId) {
         }
     }
     projectInfo.components = deployedBuild.subbuildStatuses
-        .filter(s => s.buildType !== APPLICATION_BUILD_TYPE)
+        .filter(s => s.buildType !== USER_FACING_TO_INTERNAL_TYPE[APP_KEY])
         .map(s => ({
-        uid: s.userDefinedId ||
-            s.buildName,
+        uid: s.buildName,
         type: s.buildType,
     }));
     return projectInfo;
 }
-export async function renderProjectInfo(projectInfo) {
-    const projectInfoLines = [
-        commands.project.info.project.name(projectInfo.projectName),
-        commands.project.info.project.platformVersion(projectInfo.platformVersion),
-        commands.project.info.project.id(projectInfo.projectId),
-        commands.project.info.project.deployedBuild(projectInfo.deployedBuildId),
-        commands.project.info.project.autoDeploy(projectInfo.autoDeployEnabled),
-    ];
+export function logProjectInfo(projectInfo) {
+    uiLogger.log(chalk.bold(commands.project.info.project.title(projectInfo.projectName)));
+    uiLine();
+    uiLogger.log(commands.project.info.project.platformVersion(projectInfo.platformVersion));
+    uiLogger.log(commands.project.info.project.id(projectInfo.projectId));
+    uiLogger.log(commands.project.info.project.deployedBuild(projectInfo.deployedBuildId));
+    uiLogger.log(commands.project.info.project.autoDeploy(projectInfo.autoDeployEnabled));
     if (projectInfo.projectUrl) {
-        projectInfoLines.push(uiLink(commands.project.info.viewProjectLink, projectInfo.projectUrl));
+        uiLogger.log('');
+        uiLogger.log(uiLink(commands.project.info.viewProjectLink, projectInfo.projectUrl));
     }
-    const childBoxes = [];
     if (projectInfo.app) {
-        const appInfoLines = [
-            commands.project.info.app.name(projectInfo.app.name),
-            commands.project.info.app.id(projectInfo.app.id),
-            commands.project.info.app.uid(projectInfo.app.uid),
-        ];
+        uiLogger.log('');
+        uiLogger.log(chalk.bold(commands.project.info.app.title));
+        uiLine();
+        uiLogger.log(commands.project.info.app.name(projectInfo.app.name));
+        uiLogger.log(commands.project.info.app.id(projectInfo.app.id));
+        uiLogger.log(commands.project.info.app.uid(projectInfo.app.uid));
         if (projectInfo.app.authType) {
-            appInfoLines.push(commands.project.info.app.authType(projectInfo.app.authType));
+            uiLogger.log(commands.project.info.app.authType(projectInfo.app.authType));
         }
         if (projectInfo.app.distributionType) {
-            appInfoLines.push(commands.project.info.app.distributionType(projectInfo.app.distributionType));
+            uiLogger.log(commands.project.info.app.distributionType(projectInfo.app.distributionType));
         }
-        childBoxes.push(getBoxWithTitle({
-            title: commands.project.info.app.title,
-            message: appInfoLines.join('\n'),
-            titleBackgroundColor: INK_COLORS.WHITE,
-            borderColor: INK_COLORS.WHITE,
-        }));
     }
     if (projectInfo.components.length > 0) {
-        const tableHeader = [
-            commands.project.info.labels.uid,
-            commands.project.info.labels.type,
-        ];
-        const tableData = projectInfo.components.map(c => [c.uid, c.type]);
-        const tableObjects = mapTableDataToObjects(tableHeader, tableData);
-        childBoxes.push(getBoxWithTitle({
-            title: commands.project.info.componentsHeader,
-            titleBackgroundColor: INK_COLORS.WHITE,
-            borderColor: INK_COLORS.WHITE,
-            children: getTable({ data: tableObjects, borderless: true }),
-        }));
+        uiLogger.log('');
+        uiLogger.log(chalk.bold(commands.project.info.componentsHeader));
+        uiLine();
+        const typeColWidth = Math.max(commands.project.info.labels.type.length, ...projectInfo.components.map(c => c.type.length));
+        uiLogger.log(`${commands.project.info.labels.type.padEnd(typeColWidth)}   ${commands.project.info.labels.uid}`);
+        for (const component of projectInfo.components) {
+            uiLogger.log(`${component.type.padEnd(typeColWidth)}   ${component.uid}`);
+        }
     }
-    await renderInline(getBoxWithTitle({
-        title: commands.project.info.project.title,
-        message: projectInfoLines.join('\n'),
-        titleBackgroundColor: INK_COLORS.INFO_BLUE,
-        borderColor: INK_COLORS.INFO_BLUE,
-        children: React.createElement(React.Fragment, null, ...childBoxes),
-    }));
 }

package/lib/projects/projectProfiles.d.ts

@@ -3,8 +3,7 @@ import { ProjectConfig } from '../../types/Projects.js';
 export declare function logProfileHeader(profileName: string): void;
 export declare function logProfileFooter(profile: HsProfileFile, includeVariables?: boolean): void;
 export declare function loadProfile(projectConfig: ProjectConfig | null, projectDir: string | null, profileName: string): HsProfileFile | never;
-export declare function enforceProfileUsage(projectConfig: ProjectConfig | null, projectDir: string | null): Promise<void>;
-export declare function loadAndValidateProfile(projectConfig: ProjectConfig | null, projectDir: string | null, profileName: string | undefined, silent?: boolean): Promise<number | undefined>;
+export declare function loadAndValidateProfile(projectConfig: ProjectConfig | null, projectDir: string | null, profileName: string, silent?: boolean): Promise<HsProfileFile | never>;
 type ValidateProjectForProfileOptions = {
     projectConfig: ProjectConfig;
     projectDir: string;

package/lib/projects/projectProfiles.js

@@ -1,7 +1,7 @@
 import path from 'path';
-import { loadHsProfileFile, getHsProfileFilename, getAllHsProfiles, validateProfileVariables, } from '@hubspot/project-parsing-lib/profiles';
+import { loadHsProfileFile, getHsProfileFilename, validateProfileVariables, } from '@hubspot/project-parsing-lib/profiles';
 import { commands, lib } from '../../lang/en.js';
-import { indent, uiBetaTag, uiLine } from '../ui/index.js';
+import { indent, uiLine } from '../ui/index.js';
 import { uiLogger } from '../ui/logger.js';
 import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
 import SpinniesManager from '../ui/SpinniesManager.js';
@@ -9,7 +9,7 @@ import { handleTranslate } from './upload.js';
 import { getErrorMessage } from '../errorHandlers/index.js';
 export function logProfileHeader(profileName) {
     uiLine();
-    uiBetaTag(lib.projectProfiles.logs.usingProfile(getHsProfileFilename(profileName)));
+    uiLogger.log(lib.projectProfiles.logs.usingProfile(getHsProfileFilename(profileName)));
     uiLogger.log('');
 }
 export function logProfileFooter(profile, includeVariables = false) {
@@ -51,19 +51,7 @@ export function loadProfile(projectConfig, projectDir, profileName) {
     }
     return profile;
 }
-export async function enforceProfileUsage(projectConfig, projectDir) {
-    if (projectConfig && projectDir) {
-        const existingProfiles = await getAllHsProfiles(path.join(projectDir, projectConfig.srcDir));
-        if (existingProfiles.length > 0) {
-            throw new Error(lib.projectProfiles.exitIfUsingProfiles.errors.noProfileSpecified);
-        }
-    }
-}
 export async function loadAndValidateProfile(projectConfig, projectDir, profileName, silent = false) {
-    if (!profileName) {
-        await enforceProfileUsage(projectConfig, projectDir);
-        return;
-    }
     if (!silent) {
         logProfileHeader(profileName);
     }
@@ -77,7 +65,7 @@ export async function loadAndValidateProfile(projectConfig, projectDir, profileN
             throw new Error(lib.projectProfiles.loadProfile.errors.profileNotValid(profileName, validationResult.errors));
         }
     }
-    return profile.accountId;
+    return profile;
 }
 function formatProfileValidationError(error, leadingIndentationLevel = 0) {
     // Trim leading whitespace and replace tabs with spaces to reducing indentations
@@ -97,7 +85,7 @@ export async function validateProjectForProfile({ projectConfig, projectDir, pro
         });
     }
     try {
-        const accountId = await loadAndValidateProfile(projectConfig, projectDir, profileName, true);
+        const { accountId } = await loadAndValidateProfile(projectConfig, projectDir, profileName, true);
         targetAccountId = accountId || derivedAccountId;
     }
     catch (error) {

package/lib/projects/upload.js

@@ -6,6 +6,7 @@ import { uploadProject } from '@hubspot/local-dev-lib/api/projects';
 import { shouldIgnoreFile } from '@hubspot/local-dev-lib/ignoreRules';
 import { isTranslationError, translate, } from '@hubspot/project-parsing-lib/translate';
 import { projectContainsHsMetaFiles } from '@hubspot/project-parsing-lib/projects';
+import { findAndParsePackageJsonFiles, collectWorkspaceDirectories, collectFileDependencies, } from '@hubspot/project-parsing-lib/workspaces';
 import SpinniesManager from '../ui/SpinniesManager.js';
 import { uiAccountDescription } from '../ui/index.js';
 import util from 'node:util';
@@ -16,6 +17,7 @@ import { isV2Project } from './platformVersion.js';
 import ProjectValidationError from '../errors/ProjectValidationError.js';
 import { walk } from '@hubspot/local-dev-lib/fs';
 import { LEGACY_CONFIG_FILES } from '../constants.js';
+import { archiveWorkspacesAndDependencies, getPackageJsonPathsToUpdate, getLockfilePathsToUpdate, } from './workspaces.js';
 async function uploadProjectFiles(accountId, projectName, filePath, uploadMessage, platformVersion, intermediateRepresentation) {
     const accountIdentifier = uiAccountDescription(accountId) || `${accountId}`;
     SpinniesManager.add('upload', {
@@ -48,6 +50,15 @@ export async function handleProjectUpload({ accountId, projectConfig, projectDir
     await validateNoHSMetaMismatch(srcDir, projectConfig);
     const tempFile = tmp.fileSync({ postfix: '.zip' });
     uiLogger.debug(lib.projectUpload.handleProjectUpload.compressing(tempFile.name));
+    // Collect workspace directories and file: dependencies for v2+ projects only.
+    // Versions <= 2025.1 do not support the new npm workspaces bundling behavior.
+    let workspaceMappings = [];
+    let fileDependencyMappings = [];
+    if (isV2Project(projectConfig.platformVersion)) {
+        const parsedPackageJsons = await findAndParsePackageJsonFiles(srcDir);
+        workspaceMappings = await collectWorkspaceDirectories(parsedPackageJsons);
+        fileDependencyMappings = await collectFileDependencies(parsedPackageJsons);
+    }
     const output = fs.createWriteStream(tempFile.name);
     const archive = archiver('zip');
     const result = new Promise((resolve, reject) => output.on('close', async function () {
@@ -91,8 +102,14 @@ export async function handleProjectUpload({ accountId, projectConfig, projectDir
         }
     }));
     archive.pipe(output);
+    const modifiedPackageJsonPaths = getPackageJsonPathsToUpdate(srcDir, workspaceMappings, fileDependencyMappings);
+    const lockfilePathsToUpdate = getLockfilePathsToUpdate(srcDir, workspaceMappings, fileDependencyMappings);
     let loggedIgnoredNodeModule = false;
     archive.directory(srcDir, false, file => {
+        if (modifiedPackageJsonPaths.has(file.name) ||
+            lockfilePathsToUpdate.has(file.name)) {
+            return false;
+        }
         const ignored = shouldIgnoreFile(file.name, true);
         if (ignored) {
             const isNodeModule = file.name.includes('node_modules');
@@ -105,6 +122,8 @@ export async function handleProjectUpload({ accountId, projectConfig, projectDir
         }
         return ignored ? false : file;
     });
+    // Archive workspaces and file: dependencies
+    await archiveWorkspacesAndDependencies(archive, srcDir, projectDir, workspaceMappings, fileDependencyMappings);
     archive.finalize();
     return result;
 }

package/lib/projects/workspaces.d.ts

@@ -0,0 +1,42 @@
+import archiver from 'archiver';
+import { WorkspaceMapping, FileDependencyMapping } from '@hubspot/project-parsing-lib/workspaces';
+/**
+ * Result of archiving workspaces and file dependencies
+ */
+export type WorkspaceArchiveResult = {
+    packageWorkspaces: Map<string, string[]>;
+    packageFileDeps: Map<string, Map<string, string>>;
+};
+/**
+ * Generates a short hash of the input string for use in workspace paths.
+ * Uses SHA256 truncated to 8 hex characters (4 billion possibilities).
+ */
+export declare function shortHash(input: string): string;
+/**
+ * Determines the archive path for an external workspace or file: dependency.
+ * Produces `_workspaces/<basename>-<hash>` with no subdirectory.
+ * The hash prevents collisions between different directories with the same basename.
+ */
+export declare function computeExternalArchivePath(absolutePath: string): string;
+/**
+ * Updates package.json files in the archive to reflect new workspace and file: dependency paths.
+ *
+ * Workspace entries in packageWorkspaces are already in final form:
+ * - Internal workspaces: relative paths (e.g. "../packages/utils")
+ * - External workspaces: relative paths (e.g. "../_workspaces/logger-abc")
+ *
+ * Only external file: dependencies appear in packageFileDeps; internal ones
+ * keep their original file: references and are left untouched.
+ */
+export declare function updatePackageJsonInArchive(archive: archiver.Archiver, srcDir: string, packageWorkspaces: Map<string, string[]>, packageFileDeps: Map<string, Map<string, string>>): Promise<void>;
+export declare function rewriteLockfileForExternalDeps(lockfileContent: Record<string, unknown>, pathMappings: Array<{
+    oldPath: string;
+    newPath: string;
+}>): Record<string, unknown>;
+export declare function getPackageJsonPathsToUpdate(srcDir: string, workspaceMappings: WorkspaceMapping[], fileDependencyMappings: FileDependencyMapping[]): Set<string>;
+export declare function getLockfilePathsToUpdate(srcDir: string, workspaceMappings: WorkspaceMapping[], fileDependencyMappings: FileDependencyMapping[]): Set<string>;
+/**
+ * Main orchestration function that handles archiving of workspaces and file dependencies.
+ * This is the clean integration point for upload.ts.
+ */
+export declare function archiveWorkspacesAndDependencies(archive: archiver.Archiver, srcDir: string, projectDir: string, workspaceMappings: WorkspaceMapping[], fileDependencyMappings: FileDependencyMapping[]): Promise<WorkspaceArchiveResult>;