[Command Menu] Refactor layout customization conditional availability [Warning] (#19974)

closes
https://discord.com/channels/1130383047699738754/1494312529286004837
This commit is contained in:
nitin
2026-04-24 15:48:02 +05:30
committed by GitHub
parent 3deb467845
commit 097432d3a2
20 changed files with 374 additions and 61 deletions
@@ -1,7 +1,18 @@
import { Module } from '@nestjs/common';
import { AddLayoutCustomizationGuardToEditCommandsCommand } from 'src/database/commands/upgrade-version-command/2-1/2-1-workspace-command-1795000001000-add-layout-customization-guard-to-edit-commands.command';
import { WorkspaceIteratorModule } from 'src/database/commands/command-runners/workspace-iterator.module';
import { ApplicationModule } from 'src/engine/core-modules/application/application.module';
import { WorkspaceCacheModule } from 'src/engine/workspace-cache/workspace-cache.module';
import { WorkspaceMigrationModule } from 'src/engine/workspace-manager/workspace-migration/workspace-migration.module';
@Module({
imports: [],
providers: [],
imports: [
ApplicationModule,
WorkspaceCacheModule,
WorkspaceIteratorModule,
WorkspaceMigrationModule,
],
providers: [AddLayoutCustomizationGuardToEditCommandsCommand],
})
export class V2_1_UpgradeVersionCommandModule {}
@@ -0,0 +1,180 @@
import { Command } from 'nest-commander';
import { isDefined } from 'twenty-shared/utils';
import { ActiveOrSuspendedWorkspaceCommandRunner } from 'src/database/commands/command-runners/active-or-suspended-workspace.command-runner';
import { WorkspaceIteratorService } from 'src/database/commands/command-runners/workspace-iterator.service';
import { type RunOnWorkspaceArgs } from 'src/database/commands/command-runners/workspace.command-runner';
import { RegisteredWorkspaceCommand } from 'src/engine/core-modules/upgrade/decorators/registered-workspace-command.decorator';
import { type FlatCommandMenuItem } from 'src/engine/metadata-modules/flat-command-menu-item/types/flat-command-menu-item.type';
import { ApplicationService } from 'src/engine/core-modules/application/application.service';
import { WorkspaceCacheService } from 'src/engine/workspace-cache/services/workspace-cache.service';
import { STANDARD_COMMAND_MENU_ITEMS } from 'src/engine/workspace-manager/twenty-standard-application/constants/standard-command-menu-item.constant';
import { computeTwentyStandardApplicationAllFlatEntityMaps } from 'src/engine/workspace-manager/twenty-standard-application/utils/twenty-standard-application-all-flat-entity-maps.constant';
import { WorkspaceMigrationValidateBuildAndRunService } from 'src/engine/workspace-manager/workspace-migration/services/workspace-migration-validate-build-and-run-service';
import { replaceLegacyPageEditModeIdentifier } from 'src/database/commands/upgrade-version-command/2-1/utils/replace-legacy-page-edit-mode-identifier.util';
const UNIVERSAL_IDENTIFIERS_TO_UPDATE = new Set<string>([
STANDARD_COMMAND_MENU_ITEMS.editRecordPageLayout.universalIdentifier,
STANDARD_COMMAND_MENU_ITEMS.editDashboardLayout.universalIdentifier,
STANDARD_COMMAND_MENU_ITEMS.saveDashboardLayout.universalIdentifier,
STANDARD_COMMAND_MENU_ITEMS.cancelDashboardLayout.universalIdentifier,
]);
@RegisteredWorkspaceCommand('2.1.0', 1795000001000)
@Command({
name: 'upgrade:2-1:add-layout-customization-guard-to-edit-commands',
description:
'Guard layout edit commands and migrate legacy page edit-mode expressions',
})
export class AddLayoutCustomizationGuardToEditCommandsCommand extends ActiveOrSuspendedWorkspaceCommandRunner {
constructor(
protected readonly workspaceIteratorService: WorkspaceIteratorService,
private readonly applicationService: ApplicationService,
private readonly workspaceMigrationValidateBuildAndRunService: WorkspaceMigrationValidateBuildAndRunService,
private readonly workspaceCacheService: WorkspaceCacheService,
) {
super(workspaceIteratorService);
}
override async runOnWorkspace({
workspaceId,
options,
}: RunOnWorkspaceArgs): Promise<void> {
const isDryRun = options.dryRun ?? false;
this.logger.log(
`${isDryRun ? '[DRY RUN] ' : ''}Starting Edit command availability expression update for workspace ${workspaceId}`,
);
const { twentyStandardFlatApplication, workspaceCustomFlatApplication } =
await this.applicationService.findWorkspaceTwentyStandardAndCustomApplicationOrThrow(
{ workspaceId },
);
const { flatCommandMenuItemMaps: existingFlatCommandMenuItemMaps } =
await this.workspaceCacheService.getOrRecompute(workspaceId, [
'flatCommandMenuItemMaps',
]);
const { allFlatEntityMaps: standardAllFlatEntityMaps } =
computeTwentyStandardApplicationAllFlatEntityMaps({
now: new Date().toISOString(),
workspaceId,
twentyStandardApplicationId: twentyStandardFlatApplication.id,
});
const updatedAt = new Date().toISOString();
const itemsToUpdateById: Record<string, FlatCommandMenuItem> = {};
for (const universalIdentifier of UNIVERSAL_IDENTIFIERS_TO_UPDATE) {
const standardItem =
standardAllFlatEntityMaps.flatCommandMenuItemMaps.byUniversalIdentifier[
universalIdentifier
];
const existingItem =
existingFlatCommandMenuItemMaps.byUniversalIdentifier[
universalIdentifier
];
if (
!isDefined(standardItem) ||
!isDefined(existingItem) ||
existingItem.conditionalAvailabilityExpression ===
standardItem.conditionalAvailabilityExpression
) {
continue;
}
itemsToUpdateById[existingItem.id] = {
...existingItem,
conditionalAvailabilityExpression:
standardItem.conditionalAvailabilityExpression,
updatedAt,
};
}
for (const existingItem of Object.values(
existingFlatCommandMenuItemMaps.byUniversalIdentifier,
).filter(isDefined)) {
if (
UNIVERSAL_IDENTIFIERS_TO_UPDATE.has(existingItem.universalIdentifier)
) {
continue;
}
const currentConditionalAvailabilityExpression =
existingItem.conditionalAvailabilityExpression;
const nextConditionalAvailabilityExpression =
replaceLegacyPageEditModeIdentifier(
currentConditionalAvailabilityExpression,
);
if (
nextConditionalAvailabilityExpression ===
currentConditionalAvailabilityExpression
) {
continue;
}
itemsToUpdateById[existingItem.id] = {
...existingItem,
conditionalAvailabilityExpression:
nextConditionalAvailabilityExpression,
updatedAt,
};
}
const itemsToUpdate = Object.values(itemsToUpdateById);
if (itemsToUpdate.length === 0) {
this.logger.log(
`Edit command availability expressions already up to date for workspace ${workspaceId}`,
);
return;
}
this.logger.log(
`Found ${itemsToUpdate.length} command menu item(s) to update for workspace ${workspaceId}`,
);
if (isDryRun) {
this.logger.log(
`[DRY RUN] Would update ${itemsToUpdate.length} Edit command availability expression(s) for workspace ${workspaceId}`,
);
return;
}
const validateAndBuildResult =
await this.workspaceMigrationValidateBuildAndRunService.validateBuildAndRunWorkspaceMigration(
{
allFlatEntityOperationByMetadataName: {
commandMenuItem: {
flatEntityToCreate: [],
flatEntityToDelete: [],
flatEntityToUpdate: itemsToUpdate,
},
},
workspaceId,
applicationUniversalIdentifier:
workspaceCustomFlatApplication.universalIdentifier,
},
);
if (validateAndBuildResult.status === 'fail') {
this.logger.error(
`Failed to update Edit command availability expressions:\n${JSON.stringify(validateAndBuildResult, null, 2)}`,
);
throw new Error(
`Failed to update Edit command availability expressions for workspace ${workspaceId}`,
);
}
this.logger.log(
`Successfully updated ${itemsToUpdate.length} Edit command availability expression(s) for workspace ${workspaceId}`,
);
}
}
@@ -0,0 +1,63 @@
import { replaceLegacyPageEditModeIdentifier } from '../replace-legacy-page-edit-mode-identifier.util';
describe('replaceLegacyPageEditModeIdentifier', () => {
it('should replace the legacy edit-mode variable', () => {
expect(
replaceLegacyPageEditModeIdentifier(
'pageType == "RECORD_PAGE" and not isPageInEditMode',
),
).toBe(
'((pageType == "RECORD_PAGE") and ((not isDashboardPageLayoutInEditMode)))',
);
});
it('should replace the legacy variable in function arguments', () => {
expect(
replaceLegacyPageEditModeIdentifier(
'someEquals(selectedRecords, "status", isPageInEditMode)',
),
).toBe(
'someEquals(selectedRecords, "status", isDashboardPageLayoutInEditMode)',
);
});
it('should replace every legacy variable occurrence', () => {
expect(
replaceLegacyPageEditModeIdentifier(
'isPageInEditMode and not isPageInEditMode',
),
).toBe(
'(isDashboardPageLayoutInEditMode and ((not isDashboardPageLayoutInEditMode)))',
);
});
it('should not replace string literals', () => {
const conditionalAvailabilityExpression =
'objectMetadataItem.nameSingular == "isPageInEditMode"';
expect(
replaceLegacyPageEditModeIdentifier(conditionalAvailabilityExpression),
).toBe(conditionalAvailabilityExpression);
});
it('should not replace member access', () => {
const conditionalAvailabilityExpression =
'objectMetadataItem.isPageInEditMode';
expect(
replaceLegacyPageEditModeIdentifier(conditionalAvailabilityExpression),
).toBe(conditionalAvailabilityExpression);
});
it('should leave invalid expressions untouched', () => {
const conditionalAvailabilityExpression = 'isPageInEditMode and (';
expect(
replaceLegacyPageEditModeIdentifier(conditionalAvailabilityExpression),
).toBe(conditionalAvailabilityExpression);
});
it('should return null when expression is null', () => {
expect(replaceLegacyPageEditModeIdentifier(null)).toBeNull();
});
});
@@ -0,0 +1,39 @@
import { conditionalAvailabilityParser, isDefined } from 'twenty-shared/utils';
const LEGACY_PAGE_EDIT_MODE_IDENTIFIER = 'isPageInEditMode';
const DASHBOARD_PAGE_LAYOUT_EDIT_MODE_IDENTIFIER =
'isDashboardPageLayoutInEditMode';
const DASHBOARD_PAGE_LAYOUT_EDIT_MODE_EXPRESSION =
conditionalAvailabilityParser.parse(
DASHBOARD_PAGE_LAYOUT_EDIT_MODE_IDENTIFIER,
);
export const replaceLegacyPageEditModeIdentifier = (
conditionalAvailabilityExpression: string | null,
) => {
if (!isDefined(conditionalAvailabilityExpression)) {
return conditionalAvailabilityExpression;
}
try {
const parsedConditionalAvailabilityExpression =
conditionalAvailabilityParser.parse(conditionalAvailabilityExpression);
if (
!parsedConditionalAvailabilityExpression
.variables()
.includes(LEGACY_PAGE_EDIT_MODE_IDENTIFIER)
) {
return conditionalAvailabilityExpression;
}
return parsedConditionalAvailabilityExpression
.substitute(
LEGACY_PAGE_EDIT_MODE_IDENTIFIER,
DASHBOARD_PAGE_LAYOUT_EDIT_MODE_EXPRESSION,
)
.toString();
} catch {
return conditionalAvailabilityExpression;
}
};