@nocobase/plugin-multi-portal 3.0.0-alpha.2 → 3.0.0-alpha.4

package/dist/locale/zh-CN.json

@@ -33,6 +33,7 @@
   "Routes permissions": "路由权限",
   "Multi-portal": "门户管理",
   "Mobile": "移动端",
+  "More": "更多",
   "New portals are allowed to be accessed by default": "新建门户默认允许访问",
   "New routes are allowed to be accessed by default": "新建路由默认允许访问",
   "Must start with /. For example: /portal.": "必须以 / 开头，例如 /门户。",
@@ -57,6 +58,7 @@
   "No-code portal": "无代码门户",
   "Portal manager": "门户管理",
   "Portal name": "门户名称",
+  "Portal name \"{{portalName}}\" already exists": "门户名称“{{portalName}}”已存在",
   "Portal name can only contain lowercase letters, numbers, hyphens, and underscores": "门户名称只能包含小写英文字母、数字、连字符和下划线",
   "Portals": "门户",
   "Refresh": "刷新",
@@ -70,6 +72,7 @@
   "Source storage": "源码存储",
   "Submit": "提交",
   "Target portal": "目标门户",
+  "The default portal cannot be disabled": "默认门户不能停用，请先把默认设置给其他门户。",
   "The corresponding portal directory will also be deleted.": "对应的门户目录也会被删除。",
   "This entry is currently unavailable. Please check the application status.": "当前不可用，请检查应用状态。",
   "This entry is no longer available. Please remove this button.": "该入口当前不可用，请移除此按钮。",
@@ -119,6 +122,16 @@
   "No-code": "无代码模式",
   "AI": "AI 模式",
   "Default": "默认",
+  "Default portal": "默认门户",
+  "Set as default": "设为默认",
+  "Default portal updated successfully": "默认门户更新成功",
+  "Users enter this portal by default when they open the application without specifying one.": "用户未指定门户访问应用时，将默认进入此门户。",
+  "Use multiPortals:setDefault to update the default Portal": "请使用 multiPortals:setDefault 更新默认门户",
+  "filterByTk is required": "filterByTk 为必填项",
+  "Portal not found": "门户不存在",
+  "Disabled Portal cannot be set as default": "已禁用的门户不能设为默认",
+  "Portal layout must be enabled before setting it as default": "设为默认门户前必须先启用该门户布局",
+  "Unsupported Portal type cannot be set as default": "不支持的门户类型不能设为默认",
   "No portals yet": "还没有门户",
   "Each portal is a standalone front end with its own routes and menus.": "每个门户是一套独立的前台，有自己的路由和菜单。",
   "Cover": "封面",
@@ -126,7 +139,7 @@
   "Replace cover": "更换封面",
   "Used as the cover placeholder when no cover is uploaded.": "没有上传封面时，用它作为封面占位。",
   "Used in the access path.": "用于访问路径。",
-  "Shown on the portal card. A 16:9 image works best.": "显示在门户卡片上，建议使用 16:9 的图片。",
+  "Shown on the portal card.": "显示在门户卡片上。",
   "Device": "设备",
   "No-code portals render with the components of this device; AI portals use it for grouping.": "无代码门户按此选择组件形态；AI 门户用它做归类。",
   "The title and name below are filled in from the repository name.": "下面的标题和名称会按仓库名自动填写。"

package/dist/node_modules/tar/package.json

@@ -1 +1 @@
-{"author":"Isaac Z. Schlueter","name":"tar","description":"tar for node","version":"7.5.15","repository":{"type":"git","url":"https://github.com/isaacs/node-tar.git"},"scripts":{"genparse":"node scripts/generate-parse-fixtures.js","snap":"tap","test":"tap","pretest":"npm run prepare","presnap":"npm run prepare","prepare":"tshy && bash scripts/build.sh","preversion":"npm test","postversion":"npm publish","prepublishOnly":"git push origin --follow-tags","format":"prettier --write . --log-level warn","typedoc":"typedoc --tsconfig .tshy/esm.json ./src/*.ts","lint":"oxlint --fix src test","postsnap":"npm run lint","postlint":"npm run format"},"dependencies":{"@isaacs/fs-minipass":"^4.0.0","chownr":"^3.0.0","minipass":"^7.1.2","minizlib":"^3.1.0","yallist":"^5.0.0"},"devDependencies":{"@types/node":"^25.5.0","chmodr":"^2.0.2","end-of-stream":"^1.4.3","esbuild":"^0.27.4","events-to-array":"^2.0.3","mutate-fs":"^2.1.1","nock":"^13.5.4","oxlint":"^1.57.0","oxlint-tsgolint":"^0.17.3","prettier":"^3.8.1","rimraf":"^6.1.2","tap":"^21.6.2","tshy":"^3.3.2","typedoc":"^0.28.18"},"license":"BlueOak-1.0.0","engines":{"node":">=18"},"files":["dist"],"tshy":{"exports":{"./package.json":"./package.json",".":{"import":{"types":"./dist/esm/index.d.ts","default":"./dist/esm/index.min.js"},"require":{"types":"./dist/commonjs/index.d.ts","default":"./dist/commonjs/index.min.js"}},"./raw":"./src/index.ts","./c":"./src/create.ts","./create":"./src/create.ts","./replace":"./src/create.ts","./r":"./src/create.ts","./list":"./src/list.ts","./t":"./src/list.ts","./update":"./src/update.ts","./u":"./src/update.ts","./extract":"./src/extract.ts","./x":"./src/extract.ts","./pack":"./src/pack.ts","./unpack":"./src/unpack.ts","./parse":"./src/parse.ts","./read-entry":"./src/read-entry.ts","./write-entry":"./src/write-entry.ts","./header":"./src/header.ts","./pax":"./src/pax.ts","./types":"./src/types.ts"}},"exports":{"./package.json":"./package.json",".":{"import":{"types":"./dist/esm/index.d.ts","default":"./dist/esm/index.min.js"},"require":{"types":"./dist/commonjs/index.d.ts","default":"./dist/commonjs/index.min.js"}},"./raw":{"import":{"types":"./dist/esm/index.d.ts","default":"./dist/esm/index.js"},"require":{"types":"./dist/commonjs/index.d.ts","default":"./dist/commonjs/index.js"}},"./c":{"import":{"types":"./dist/esm/create.d.ts","default":"./dist/esm/create.js"},"require":{"types":"./dist/commonjs/create.d.ts","default":"./dist/commonjs/create.js"}},"./create":{"import":{"types":"./dist/esm/create.d.ts","default":"./dist/esm/create.js"},"require":{"types":"./dist/commonjs/create.d.ts","default":"./dist/commonjs/create.js"}},"./replace":{"import":{"types":"./dist/esm/create.d.ts","default":"./dist/esm/create.js"},"require":{"types":"./dist/commonjs/create.d.ts","default":"./dist/commonjs/create.js"}},"./r":{"import":{"types":"./dist/esm/create.d.ts","default":"./dist/esm/create.js"},"require":{"types":"./dist/commonjs/create.d.ts","default":"./dist/commonjs/create.js"}},"./list":{"import":{"types":"./dist/esm/list.d.ts","default":"./dist/esm/list.js"},"require":{"types":"./dist/commonjs/list.d.ts","default":"./dist/commonjs/list.js"}},"./t":{"import":{"types":"./dist/esm/list.d.ts","default":"./dist/esm/list.js"},"require":{"types":"./dist/commonjs/list.d.ts","default":"./dist/commonjs/list.js"}},"./update":{"import":{"types":"./dist/esm/update.d.ts","default":"./dist/esm/update.js"},"require":{"types":"./dist/commonjs/update.d.ts","default":"./dist/commonjs/update.js"}},"./u":{"import":{"types":"./dist/esm/update.d.ts","default":"./dist/esm/update.js"},"require":{"types":"./dist/commonjs/update.d.ts","default":"./dist/commonjs/update.js"}},"./extract":{"import":{"types":"./dist/esm/extract.d.ts","default":"./dist/esm/extract.js"},"require":{"types":"./dist/commonjs/extract.d.ts","default":"./dist/commonjs/extract.js"}},"./x":{"import":{"types":"./dist/esm/extract.d.ts","default":"./dist/esm/extract.js"},"require":{"types":"./dist/commonjs/extract.d.ts","default":"./dist/commonjs/extract.js"}},"./pack":{"import":{"types":"./dist/esm/pack.d.ts","default":"./dist/esm/pack.js"},"require":{"types":"./dist/commonjs/pack.d.ts","default":"./dist/commonjs/pack.js"}},"./unpack":{"import":{"types":"./dist/esm/unpack.d.ts","default":"./dist/esm/unpack.js"},"require":{"types":"./dist/commonjs/unpack.d.ts","default":"./dist/commonjs/unpack.js"}},"./parse":{"import":{"types":"./dist/esm/parse.d.ts","default":"./dist/esm/parse.js"},"require":{"types":"./dist/commonjs/parse.d.ts","default":"./dist/commonjs/parse.js"}},"./read-entry":{"import":{"types":"./dist/esm/read-entry.d.ts","default":"./dist/esm/read-entry.js"},"require":{"types":"./dist/commonjs/read-entry.d.ts","default":"./dist/commonjs/read-entry.js"}},"./write-entry":{"import":{"types":"./dist/esm/write-entry.d.ts","default":"./dist/esm/write-entry.js"},"require":{"types":"./dist/commonjs/write-entry.d.ts","default":"./dist/commonjs/write-entry.js"}},"./header":{"import":{"types":"./dist/esm/header.d.ts","default":"./dist/esm/header.js"},"require":{"types":"./dist/commonjs/header.d.ts","default":"./dist/commonjs/header.js"}},"./pax":{"import":{"types":"./dist/esm/pax.d.ts","default":"./dist/esm/pax.js"},"require":{"types":"./dist/commonjs/pax.d.ts","default":"./dist/commonjs/pax.js"}},"./types":{"import":{"types":"./dist/esm/types.d.ts","default":"./dist/esm/types.js"},"require":{"types":"./dist/commonjs/types.d.ts","default":"./dist/commonjs/types.js"}}},"type":"module","main":"./dist/commonjs/index.min.js","types":"./dist/commonjs/index.d.ts","module":"./dist/esm/index.min.js","_lastModified":"2026-07-30T05:57:24.832Z"}
+{"author":"Isaac Z. Schlueter","name":"tar","description":"tar for node","version":"7.5.15","repository":{"type":"git","url":"https://github.com/isaacs/node-tar.git"},"scripts":{"genparse":"node scripts/generate-parse-fixtures.js","snap":"tap","test":"tap","pretest":"npm run prepare","presnap":"npm run prepare","prepare":"tshy && bash scripts/build.sh","preversion":"npm test","postversion":"npm publish","prepublishOnly":"git push origin --follow-tags","format":"prettier --write . --log-level warn","typedoc":"typedoc --tsconfig .tshy/esm.json ./src/*.ts","lint":"oxlint --fix src test","postsnap":"npm run lint","postlint":"npm run format"},"dependencies":{"@isaacs/fs-minipass":"^4.0.0","chownr":"^3.0.0","minipass":"^7.1.2","minizlib":"^3.1.0","yallist":"^5.0.0"},"devDependencies":{"@types/node":"^25.5.0","chmodr":"^2.0.2","end-of-stream":"^1.4.3","esbuild":"^0.27.4","events-to-array":"^2.0.3","mutate-fs":"^2.1.1","nock":"^13.5.4","oxlint":"^1.57.0","oxlint-tsgolint":"^0.17.3","prettier":"^3.8.1","rimraf":"^6.1.2","tap":"^21.6.2","tshy":"^3.3.2","typedoc":"^0.28.18"},"license":"BlueOak-1.0.0","engines":{"node":">=18"},"files":["dist"],"tshy":{"exports":{"./package.json":"./package.json",".":{"import":{"types":"./dist/esm/index.d.ts","default":"./dist/esm/index.min.js"},"require":{"types":"./dist/commonjs/index.d.ts","default":"./dist/commonjs/index.min.js"}},"./raw":"./src/index.ts","./c":"./src/create.ts","./create":"./src/create.ts","./replace":"./src/create.ts","./r":"./src/create.ts","./list":"./src/list.ts","./t":"./src/list.ts","./update":"./src/update.ts","./u":"./src/update.ts","./extract":"./src/extract.ts","./x":"./src/extract.ts","./pack":"./src/pack.ts","./unpack":"./src/unpack.ts","./parse":"./src/parse.ts","./read-entry":"./src/read-entry.ts","./write-entry":"./src/write-entry.ts","./header":"./src/header.ts","./pax":"./src/pax.ts","./types":"./src/types.ts"}},"exports":{"./package.json":"./package.json",".":{"import":{"types":"./dist/esm/index.d.ts","default":"./dist/esm/index.min.js"},"require":{"types":"./dist/commonjs/index.d.ts","default":"./dist/commonjs/index.min.js"}},"./raw":{"import":{"types":"./dist/esm/index.d.ts","default":"./dist/esm/index.js"},"require":{"types":"./dist/commonjs/index.d.ts","default":"./dist/commonjs/index.js"}},"./c":{"import":{"types":"./dist/esm/create.d.ts","default":"./dist/esm/create.js"},"require":{"types":"./dist/commonjs/create.d.ts","default":"./dist/commonjs/create.js"}},"./create":{"import":{"types":"./dist/esm/create.d.ts","default":"./dist/esm/create.js"},"require":{"types":"./dist/commonjs/create.d.ts","default":"./dist/commonjs/create.js"}},"./replace":{"import":{"types":"./dist/esm/create.d.ts","default":"./dist/esm/create.js"},"require":{"types":"./dist/commonjs/create.d.ts","default":"./dist/commonjs/create.js"}},"./r":{"import":{"types":"./dist/esm/create.d.ts","default":"./dist/esm/create.js"},"require":{"types":"./dist/commonjs/create.d.ts","default":"./dist/commonjs/create.js"}},"./list":{"import":{"types":"./dist/esm/list.d.ts","default":"./dist/esm/list.js"},"require":{"types":"./dist/commonjs/list.d.ts","default":"./dist/commonjs/list.js"}},"./t":{"import":{"types":"./dist/esm/list.d.ts","default":"./dist/esm/list.js"},"require":{"types":"./dist/commonjs/list.d.ts","default":"./dist/commonjs/list.js"}},"./update":{"import":{"types":"./dist/esm/update.d.ts","default":"./dist/esm/update.js"},"require":{"types":"./dist/commonjs/update.d.ts","default":"./dist/commonjs/update.js"}},"./u":{"import":{"types":"./dist/esm/update.d.ts","default":"./dist/esm/update.js"},"require":{"types":"./dist/commonjs/update.d.ts","default":"./dist/commonjs/update.js"}},"./extract":{"import":{"types":"./dist/esm/extract.d.ts","default":"./dist/esm/extract.js"},"require":{"types":"./dist/commonjs/extract.d.ts","default":"./dist/commonjs/extract.js"}},"./x":{"import":{"types":"./dist/esm/extract.d.ts","default":"./dist/esm/extract.js"},"require":{"types":"./dist/commonjs/extract.d.ts","default":"./dist/commonjs/extract.js"}},"./pack":{"import":{"types":"./dist/esm/pack.d.ts","default":"./dist/esm/pack.js"},"require":{"types":"./dist/commonjs/pack.d.ts","default":"./dist/commonjs/pack.js"}},"./unpack":{"import":{"types":"./dist/esm/unpack.d.ts","default":"./dist/esm/unpack.js"},"require":{"types":"./dist/commonjs/unpack.d.ts","default":"./dist/commonjs/unpack.js"}},"./parse":{"import":{"types":"./dist/esm/parse.d.ts","default":"./dist/esm/parse.js"},"require":{"types":"./dist/commonjs/parse.d.ts","default":"./dist/commonjs/parse.js"}},"./read-entry":{"import":{"types":"./dist/esm/read-entry.d.ts","default":"./dist/esm/read-entry.js"},"require":{"types":"./dist/commonjs/read-entry.d.ts","default":"./dist/commonjs/read-entry.js"}},"./write-entry":{"import":{"types":"./dist/esm/write-entry.d.ts","default":"./dist/esm/write-entry.js"},"require":{"types":"./dist/commonjs/write-entry.d.ts","default":"./dist/commonjs/write-entry.js"}},"./header":{"import":{"types":"./dist/esm/header.d.ts","default":"./dist/esm/header.js"},"require":{"types":"./dist/commonjs/header.d.ts","default":"./dist/commonjs/header.js"}},"./pax":{"import":{"types":"./dist/esm/pax.d.ts","default":"./dist/esm/pax.js"},"require":{"types":"./dist/commonjs/pax.d.ts","default":"./dist/commonjs/pax.js"}},"./types":{"import":{"types":"./dist/esm/types.d.ts","default":"./dist/esm/types.js"},"require":{"types":"./dist/commonjs/types.d.ts","default":"./dist/commonjs/types.js"}}},"type":"module","main":"./dist/commonjs/index.min.js","types":"./dist/commonjs/index.d.ts","module":"./dist/esm/index.min.js","_lastModified":"2026-07-31T14:20:49.707Z"}

package/dist/server/collections/multiPortals.js

@@ -40,6 +40,10 @@ var multiPortals_default = (0, import_database.defineCollection)({
     {
       type: "UNIQUE",
       fields: ["portalName"]
+    },
+    {
+      type: "UNIQUE",
+      fields: ["isDefault"]
     }
   ],
   fields: [
@@ -89,6 +93,12 @@ var multiPortals_default = (0, import_database.defineCollection)({
       defaultValue: true,
       allowNull: false
     },
+    {
+      name: "isDefault",
+      type: "boolean",
+      defaultValue: null,
+      allowNull: true
+    },
     {
       name: "options",
       type: "json",

package/dist/server/plugin.d.ts

@@ -31,7 +31,7 @@ export declare class PluginMultiPortalServer extends Plugin {
     private logPortalBuildHtml;
     private getPortalStorageTaskKey;
     private runPortalStorageTask;
-    private removePortalStorageDist;
+    private removePortalStorageIndexHtml;
     private waitForPortalStorageTasks;
     private schedulePortalTemplateCopyAndBuild;
     private ensurePortalStorageItem;

package/dist/server/plugin.js

@@ -100,6 +100,7 @@ const MULTI_PORTAL_MANAGEMENT_ACTIONS = [
   "multiPortals:create",
   "multiPortals:update",
   "multiPortals:firstOrCreate",
+  "multiPortals:setDefault",
   "multiPortals:destroy",
   "multiPortals:deploy",
   "multiPortals:pullSource",
@@ -168,7 +169,7 @@ function formatInitPortalTitle(portalName) {
   const title = portalName.split(/[-_]/).filter(Boolean).map((segment) => `${segment.charAt(0).toUpperCase()}${segment.slice(1)}`).join(" ");
   return title || portalName;
 }
-function getDefaultMultiPortalRecord() {
+function getDefaultMultiPortalRecord(options = {}) {
   const portalName = getInitPortalName();
   return {
     uid: DEFAULT_MULTI_PORTAL_UID,
@@ -179,11 +180,12 @@ function getDefaultMultiPortalRecord() {
     routePath: `/${portalName}`,
     authCheck: true,
     enabled: true,
+    ...options.isDefault ? { isDefault: true } : {},
     uiLayoutUid: "admin-layout-model"
   };
 }
 function getFreshMultiPortalRecords() {
-  return [getDefaultMultiPortalRecord()];
+  return [getDefaultMultiPortalRecord({ isDefault: true })];
 }
 function getFixedLayoutMultiPortalRecords() {
   return [
@@ -597,12 +599,14 @@ async function buildPortalStorageItem(portalDir, item) {
   const buildEnv = getPortalStorageCommandEnv({
     NOCOBASE_API_URL: getPortalStorageApiUrl(item.appName),
     NOCOBASE_PORTAL_BASE: getPortalDeployBasePath(item.appName, item.portalName),
+    SKIP_YARN_COREPACK_CHECK: "1",
+    COREPACK_ENABLE_STRICT: "0",
     COREPACK_ENABLE_PROJECT_SPEC: "0"
   });
   await appendPortalStorageLog(logPath, `Building portal ${item.appName}/${item.portalName}.`);
   await appendPortalStorageLog(
     logPath,
-    `Build environment: NOCOBASE_API_URL=${buildEnv.NOCOBASE_API_URL || ""} NOCOBASE_PORTAL_BASE=${buildEnv.NOCOBASE_PORTAL_BASE || ""} APP_PUBLIC_PATH=${buildEnv.APP_PUBLIC_PATH || ""}`
+    `Build environment: NOCOBASE_API_URL=${buildEnv.NOCOBASE_API_URL || ""} NOCOBASE_PORTAL_BASE=${buildEnv.NOCOBASE_PORTAL_BASE || ""} APP_PUBLIC_PATH=${buildEnv.APP_PUBLIC_PATH || ""} SKIP_YARN_COREPACK_CHECK=${buildEnv.SKIP_YARN_COREPACK_CHECK || ""} COREPACK_ENABLE_STRICT=${buildEnv.COREPACK_ENABLE_STRICT || ""} COREPACK_ENABLE_PROJECT_SPEC=${buildEnv.COREPACK_ENABLE_PROJECT_SPEC || ""}`
   );
   await runPortalStorageCommandOnce("yarn", ["build:html"], {
     cwd: portalDir,
@@ -1033,6 +1037,37 @@ async function normalizeMultiPortalSlugValues(ctx, next) {
     values.portalName = slug;
     values.routePath = `/${slug}`;
   }
+  const repository = ctx.db.getRepository("multiPortals");
+  const pendingPortalNames = /* @__PURE__ */ new Set();
+  const targets = await getMultiPortalWriteTargets(ctx, ["uid"]);
+  for (const { existing, values } of targets) {
+    const portalName = values.portalName;
+    if (typeof portalName !== "string" || !portalName) {
+      continue;
+    }
+    if (pendingPortalNames.has(portalName)) {
+      ctx.throw(409, ctx.t('Portal name "{{portalName}}" already exists', { ns: import_constants.NAMESPACE, portalName }));
+      return;
+    }
+    pendingPortalNames.add(portalName);
+    const conflict = await repository.findOne({
+      filter: { portalName },
+      fields: ["uid"]
+    });
+    if (conflict && conflict.get("uid") !== (existing == null ? void 0 : existing.get("uid"))) {
+      ctx.throw(409, ctx.t('Portal name "{{portalName}}" already exists', { ns: import_constants.NAMESPACE, portalName }));
+      return;
+    }
+  }
+  await next();
+}
+async function preventDirectDefaultPortalMutation(ctx, next) {
+  for (const values of getMultiPortalWriteRecords(ctx)) {
+    if (Object.prototype.hasOwnProperty.call(values, "isDefault")) {
+      ctx.throw(400, ctx.t("Use multiPortals:setDefault to update the default Portal", { ns: import_constants.NAMESPACE }));
+      return;
+    }
+  }
   await next();
 }
 function isUniqueConstraintViolation(error) {
@@ -1095,39 +1130,6 @@ async function seedHistoricalMultiPortals(db) {
   }
   await repairFixedLayoutMultiPortalRecords(db);
 }
-async function preventUiLayoutRouteNameConflict(ctx, next) {
-  const targets = await getMultiPortalWriteTargets(ctx, ["uid", "portalName", "uiLayoutUid"]);
-  for (const { existing, values } of targets) {
-    const existingUid = trimString(existing == null ? void 0 : existing.get("uid"));
-    const uid = trimString(values.uid ?? existingUid);
-    const portalName = trimString(values.portalName ?? (existing == null ? void 0 : existing.get("portalName")));
-    const uiLayoutUid = trimString(values.uiLayoutUid ?? (existing == null ? void 0 : existing.get("uiLayoutUid")));
-    const fixedPortal = getFixedLayoutMultiPortalRecord(existingUid) || getFixedLayoutMultiPortalRecord(uid);
-    const canonicalPortal = (fixedPortal == null ? void 0 : fixedPortal.uid) === uid && (!existingUid || fixedPortal.uid === existingUid) && fixedPortal.portalName === portalName && fixedPortal.uiLayoutUid === uiLayoutUid;
-    if (fixedPortal && !canonicalPortal) {
-      ctx.throw(400, "Reserved Portal UID must match its canonical route and UI layout");
-      return;
-    }
-    if (!portalName) {
-      continue;
-    }
-    if (portalName === "admin" || portalName === "mobile") {
-      continue;
-    }
-    const existingInitPortal = (existing == null ? void 0 : existing.get("uid")) === DEFAULT_MULTI_PORTAL_UID && existing.get("portalName") === portalName;
-    const uiLayout = await ctx.db.getRepository("uiLayouts").findOne({
-      filter: {
-        routeName: portalName
-      },
-      fields: ["uid"]
-    });
-    if (uiLayout && !existingInitPortal) {
-      ctx.throw(400, "Portal route name conflicts with an existing UI layout");
-      return;
-    }
-  }
-  await next();
-}
 async function preventMultiPortalBackingLayoutChange(ctx, next) {
   const targets = await getMultiPortalWriteTargets(ctx, ["uiLayoutUid"]);
   for (const { existing, values } of targets) {
@@ -1242,7 +1244,6 @@ async function assertDesktopRouteParentsBelongToScope(ctx, scope, values = ((_a)
       id: parentIds,
       ...scope.filter
     },
-    ...transaction ? { lock: transaction.LOCK.UPDATE } : {},
     transaction
   });
   if (new Set(normalizeDesktopRouteTargetIds(parents)).size !== new Set(parentIds.map(String)).size) {
@@ -1276,7 +1277,6 @@ async function assertDesktopRouteUpsertMatchesBelongToScope(ctx, scope, values =
         ...filter,
         ...scope.filter
       },
-      ...transaction ? { lock: transaction.LOCK.UPDATE } : {},
       transaction
     });
     const allMatchIds = normalizeDesktopRouteTargetIds(allMatches);
@@ -1691,7 +1691,7 @@ async function findDesktopRouteMutationTargets(ctx, scopeFilter, transaction, se
       ...filter ?? {},
       ...scopeFilter ?? {}
     },
-    ...transaction ? { lock: transaction.LOCK.UPDATE } : {},
+    ...transaction && !scopeFilter ? { lock: transaction.LOCK.UPDATE } : {},
     transaction
   });
 }
@@ -1843,7 +1843,6 @@ async function guardDesktopRouteMoveScope(ctx, next) {
         id: routeIds,
         ...scope.filter
       },
-      lock: transaction.LOCK.UPDATE,
       transaction
     });
     if (normalizeDesktopRouteTargetIds(allRoutes).join(",") !== normalizeDesktopRouteTargetIds(scopedRoutes).join(",") || scopedRoutes.length !== routeIds.length) {
@@ -1873,7 +1872,6 @@ async function guardDesktopRouteMoveScope(ctx, next) {
           id: parentIds,
           ...scope.filter
         },
-        lock: transaction.LOCK.UPDATE,
         transaction
       });
       if (normalizeDesktopRouteTargetIds(parents).join(",") !== parentIds.map(String).sort().join(",")) {
@@ -1921,7 +1919,6 @@ async function guardDesktopRouteMoveScope(ctx, next) {
             $gte: targetSort
           }
         },
-        lock: transaction.LOCK.UPDATE,
         transaction
       });
       const affectedRouteIds = affectedRoutes.map((route) => route.get("id"));
@@ -2019,7 +2016,7 @@ async function findDesktopRouteDestroyRoots(ctx, transaction, scopeFilter) {
       ...scopeFilter ?? {},
       ...filterByTk.length ? { id: filterByTk } : {}
     },
-    lock: transaction.LOCK.UPDATE,
+    ...scopeFilter ? {} : { lock: transaction.LOCK.UPDATE },
     transaction
   });
   return collectDesktopRouteIds(records);
@@ -2085,13 +2082,20 @@ async function detachDesktopRouteTreeOwner(ctx, routeIds, scope, transaction) {
 }
 async function detachOwnerAndFindDestroyRoots(ctx, routeIds, scope, transaction) {
   var _a;
+  await ctx.db.getRepository("desktopRoutes").find({
+    fields: ["id"],
+    filter: {
+      id: routeIds
+    },
+    lock: transaction.LOCK.UPDATE,
+    transaction
+  });
   const routes = await ctx.db.getRepository("desktopRoutes").find({
     fields: ["id", "parentId"],
     appends: ["multiPortals", "uiLayouts"],
     filter: {
       id: routeIds
     },
-    lock: transaction.LOCK.UPDATE,
     transaction
   });
   const routesById = new Map(routes.map((route) => [String(route.get("id")), route]));
@@ -2196,6 +2200,115 @@ async function listEnabledMultiPortals(ctx, next) {
   ctx.body = records.map((record) => pickMultiPortalRuntimeFields(record));
   await next();
 }
+const DEFAULT_MULTI_PORTAL_RESPONSE_FIELDS = ["uid", "portalType", "routePath"];
+function getDefaultMultiPortalType(record) {
+  const portalType = record.get("portalType");
+  if (portalType === null || portalType === void 0) {
+    return "no-code";
+  }
+  return typeof portalType === "string" && isInitPortalType(portalType) ? portalType : null;
+}
+function pickDefaultMultiPortalFields(record) {
+  return {
+    uid: String(record.get("uid")),
+    portalType: getDefaultMultiPortalType(record) || "no-code",
+    routePath: String(record.get("routePath"))
+  };
+}
+async function findEnabledDefaultMultiPortal(ctx, transaction) {
+  const record = await ctx.db.getRepository("multiPortals").findOne({
+    filter: {
+      enabled: true,
+      isDefault: true
+    },
+    fields: [...DEFAULT_MULTI_PORTAL_RESPONSE_FIELDS, "uiLayoutUid"],
+    appends: ["uiLayout"],
+    transaction
+  });
+  if (!record) {
+    return null;
+  }
+  const portalType = getDefaultMultiPortalType(record);
+  if (!portalType) {
+    return null;
+  }
+  if (portalType === "no-code") {
+    const uiLayout = record.get("uiLayout");
+    if (!uiLayout || uiLayout.get("enabled") !== true) {
+      return null;
+    }
+  }
+  return record;
+}
+async function getDefaultMultiPortal(ctx, next) {
+  const record = await findEnabledDefaultMultiPortal(ctx);
+  ctx.body = record ? pickDefaultMultiPortalFields(record) : null;
+  ctx.status = 200;
+  await next();
+}
+async function setDefaultMultiPortal(ctx, next) {
+  var _a;
+  const filterByTk = (_a = ctx.action) == null ? void 0 : _a.params.filterByTk;
+  if (filterByTk === void 0 || filterByTk === null || filterByTk === "") {
+    ctx.throw(400, ctx.t("filterByTk is required", { ns: import_constants.NAMESPACE }));
+    return;
+  }
+  const repository = ctx.db.getRepository("multiPortals");
+  const updated = await ctx.db.sequelize.transaction(async (transaction) => {
+    const target = await repository.findOne({
+      filterByTk,
+      fields: [...DEFAULT_MULTI_PORTAL_RESPONSE_FIELDS, "enabled", "uiLayoutUid"],
+      lock: transaction.LOCK.UPDATE,
+      transaction
+    });
+    if (!target) {
+      ctx.throw(404, ctx.t("Portal not found", { ns: import_constants.NAMESPACE }));
+      return null;
+    }
+    if (target.get("enabled") !== true) {
+      ctx.throw(400, ctx.t("Disabled Portal cannot be set as default", { ns: import_constants.NAMESPACE }));
+      return null;
+    }
+    const portalType = getDefaultMultiPortalType(target);
+    if (!portalType) {
+      ctx.throw(400, ctx.t("Unsupported Portal type cannot be set as default", { ns: import_constants.NAMESPACE }));
+      return null;
+    }
+    if (portalType === "no-code") {
+      const uiLayoutUid = target.get("uiLayoutUid");
+      const uiLayout = typeof uiLayoutUid === "string" && uiLayoutUid ? await ctx.db.getRepository("uiLayouts").findOne({
+        filter: {
+          uid: uiLayoutUid,
+          enabled: true
+        },
+        fields: ["uid"],
+        lock: transaction.LOCK.UPDATE,
+        transaction
+      }) : null;
+      if (!uiLayout) {
+        ctx.throw(400, ctx.t("Portal layout must be enabled before setting it as default", { ns: import_constants.NAMESPACE }));
+        return null;
+      }
+    }
+    await repository.update({
+      filter: { isDefault: true },
+      values: { isDefault: null },
+      transaction
+    });
+    await repository.update({
+      filterByTk,
+      values: { isDefault: true },
+      transaction
+    });
+    return repository.findOne({
+      filterByTk,
+      fields: [...DEFAULT_MULTI_PORTAL_RESPONSE_FIELDS],
+      transaction
+    });
+  });
+  ctx.body = updated ? pickDefaultMultiPortalFields(updated) : null;
+  await next();
+}
 async function listAccessibleMultiPortals(ctx, next) {
   const accessiblePortalUids = await listCurrentRoleAccessibleMultiPortalUids(ctx);
   const records = await ctx.db.getRepository("multiPortals").find({
@@ -2399,10 +2512,9 @@ class PluginMultiPortalServer extends import_server.Plugin {
     }
     await run();
   }
-  async removePortalStorageDist(item) {
-    await import_fs.default.promises.rm((0, import_utils.storagePathJoin)("portals", item.appName, item.portalName, "dist"), {
-      force: true,
-      recursive: true
+  async removePortalStorageIndexHtml(item) {
+    await import_fs.default.promises.rm((0, import_utils.storagePathJoin)("portals", item.appName, item.portalName, "dist", "index.html"), {
+      force: true
     });
   }
   waitForPortalStorageTasks() {
@@ -2446,8 +2558,8 @@ class PluginMultiPortalServer extends import_server.Plugin {
           return;
         }
         this.logPortalBuildHtml(item, "skipped", "the portal is disabled");
-        await this.removePortalStorageDist(item);
-        await appendPortalStorageLog(logPath, `Portal dist directory removed for ${item.appName}/${item.portalName}.`);
+        await this.removePortalStorageIndexHtml(item);
+        await appendPortalStorageLog(logPath, `Portal index.html removed for ${item.appName}/${item.portalName}.`);
       } catch (error) {
         await appendPortalStorageLog(
           logPath,
@@ -2489,15 +2601,15 @@ class PluginMultiPortalServer extends import_server.Plugin {
       return;
     }
     this.logPortalBuildHtml(item, "skipped", "the portal is disabled");
-    await this.removePortalStorageDist(item);
-    await appendPortalStorageLog(logPath, `Portal dist directory removed for ${item.appName}/${item.portalName}.`);
+    await this.removePortalStorageIndexHtml(item);
+    await appendPortalStorageLog(logPath, `Portal index.html removed for ${item.appName}/${item.portalName}.`);
   }
   async syncMultiPortalStorageItem(multiPortal, options, syncPrevious = false, forceBuild = false) {
     const currentItem = this.getMultiPortalStorageItem(multiPortal);
     const previousItem = syncPrevious ? this.getMultiPortalStorageItem(multiPortal, true) : null;
     await this.runPortalStorageTask(async () => {
       if (previousItem && (!currentItem || previousItem.appName !== currentItem.appName || previousItem.portalName !== currentItem.portalName || !currentItem.enabled)) {
-        await this.removePortalStorageDist(previousItem);
+        await this.removePortalStorageIndexHtml(previousItem);
       }
       if (currentItem) {
         await this.ensurePortalStorageItem(currentItem, { forceBuild });
@@ -2847,26 +2959,29 @@ class PluginMultiPortalServer extends import_server.Plugin {
       "desktopRoutes:listRolePermissionTargets",
       mapMultiPortalLayoutToUiLayoutForRolePermissionTargets
     );
+    this.app.resourceManager.registerPreActionHandler("multiPortals:create", preventDirectDefaultPortalMutation);
     this.app.resourceManager.registerPreActionHandler("multiPortals:create", captureSkipCreatePortalDirectory);
     this.app.resourceManager.registerPreActionHandler("multiPortals:create", normalizeMultiPortalSlugValues);
-    this.app.resourceManager.registerPreActionHandler("multiPortals:create", preventUiLayoutRouteNameConflict);
+    this.app.resourceManager.registerPreActionHandler("multiPortals:update", preventDirectDefaultPortalMutation);
     this.app.resourceManager.registerPreActionHandler("multiPortals:update", preventMultiPortalBackingLayoutChange);
     this.app.resourceManager.registerPreActionHandler("multiPortals:update", normalizeMultiPortalSlugValues);
-    this.app.resourceManager.registerPreActionHandler("multiPortals:update", preventUiLayoutRouteNameConflict);
+    this.app.resourceManager.registerPreActionHandler("multiPortals:firstOrCreate", preventDirectDefaultPortalMutation);
     this.app.resourceManager.registerPreActionHandler(
       "multiPortals:firstOrCreate",
       preventMultiPortalBackingLayoutChange
     );
     this.app.resourceManager.registerPreActionHandler("multiPortals:firstOrCreate", captureSkipCreatePortalDirectory);
     this.app.resourceManager.registerPreActionHandler("multiPortals:firstOrCreate", normalizeMultiPortalSlugValues);
-    this.app.resourceManager.registerPreActionHandler("multiPortals:firstOrCreate", preventUiLayoutRouteNameConflict);
+    this.app.resourceManager.registerPreActionHandler(
+      "multiPortals:updateOrCreate",
+      preventDirectDefaultPortalMutation
+    );
     this.app.resourceManager.registerPreActionHandler(
       "multiPortals:updateOrCreate",
       preventMultiPortalBackingLayoutChange
     );
     this.app.resourceManager.registerPreActionHandler("multiPortals:updateOrCreate", captureSkipCreatePortalDirectory);
     this.app.resourceManager.registerPreActionHandler("multiPortals:updateOrCreate", normalizeMultiPortalSlugValues);
-    this.app.resourceManager.registerPreActionHandler("multiPortals:updateOrCreate", preventUiLayoutRouteNameConflict);
     this.app.resourceManager.registerPreActionHandler("desktopRoutes:create", addDesktopRouteCreateMultiPortal, {
       after: UI_LAYOUT_DESKTOP_ROUTE_WRITE_LAYOUT_HANDLER_TAG
     });
@@ -2891,12 +3006,15 @@ class PluginMultiPortalServer extends import_server.Plugin {
       actions: ROLE_MULTI_PORTAL_PERMISSION_ACTIONS
     });
     this.app.acl.allow("multiPortals", "listEnabled", "public");
+    this.app.acl.allow("multiPortals", "getDefault", "public");
     this.app.acl.allow("multiPortals", "listAccessible", "loggedIn");
     this.app.resourceManager.use(createPortalDeployUploadMiddleware(), {
       tag: "multiPortalDeployUpload",
       after: "acl"
     });
     this.app.resourceManager.registerActionHandler("multiPortals:listEnabled", listEnabledMultiPortals);
+    this.app.resourceManager.registerActionHandler("multiPortals:getDefault", getDefaultMultiPortal);
+    this.app.resourceManager.registerActionHandler("multiPortals:setDefault", setDefaultMultiPortal);
     this.app.resourceManager.registerActionHandler("multiPortals:listAccessible", listAccessibleMultiPortals);
     this.app.resourceManager.registerActionHandler("multiPortals:deploy", async (ctx, next) => {
       await this.deployPortalDist(ctx, next);
@@ -2921,6 +3039,11 @@ class PluginMultiPortalServer extends import_server.Plugin {
       (0, import_ensureDefaultRoleMultiPortalAccess.applyDefaultRoleMultiPortalAccess)(role);
     });
     this.app.db.on("desktopRoutes.afterCreate", reconcileCreatedDesktopRoutePermissions);
+    this.app.db.on("multiPortals.beforeUpdate", (multiPortal) => {
+      if (multiPortal.get("enabled") === false && multiPortal.get("isDefault") === true) {
+        multiPortal.set("isDefault", null);
+      }
+    });
     this.app.db.on("multiPortals.afterCreate", async (multiPortal, options) => {
       await grantDefaultAccessToNewMultiPortal(this.app.db, multiPortal, options);
       await this.publishAppManifestItem(multiPortal, options);