@coraltravelcenter/b2c-landing-builder 2.7.1 → 2.8.0

package/README.md

@@ -24,6 +24,7 @@ b2c-landing-vite build
 b2c-landing-vite deploy
 b2c-landing-vite deploy --dry-run
 b2c-landing-vite deploy --update
+b2c-landing-vite deploy --relink
 b2c-landing-vite deploy --assets-only
 b2c-landing-vite block:add hero
 b2c-landing-vite block:rename hero main-hero
@@ -49,6 +50,12 @@ b2c-landing-vite update
   Страница, виджеты, ассеты и локальный deploy-state при этом не изменяются.
 - `deploy --assets-only --dry-run` показывает только план синхронизации ассетов.
 - `deploy --update` обновляет сохранённую версию страницы без создания новой.
+- `deploy --relink` восстанавливает или меняет привязку проекта к существующей
+  CMS-странице. Builder предлагает application, поиск страницы по названию или
+  URL, версию, HTML-зону и точную позицию. Обычный запуск создаёт checkout для
+  опубликованной версии; вместе с `--update` выбранная версия меняется на месте.
+- `deploy --relink --dry-run` проходит тот же интерактивный выбор и показывает
+  план, но не сохраняет новую привязку и не изменяет CMS.
 - `block:add` создаёт файлы в выбранных форматах разметки и стилей.
 - `block:rename` атомарно переименовывает все файлы блока и обновляет порядок.
 - `update` проверяет npm registry и показывает команду ручного обновления.

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@coraltravelcenter/b2c-landing-builder",
-  "version": "2.7.1",
+  "version": "2.8.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@coraltravelcenter/b2c-landing-builder",
-      "version": "2.7.1",
+      "version": "2.8.0",
       "license": "MIT",
       "dependencies": {
         "@clack/prompts": "1.7.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coraltravelcenter/b2c-landing-builder",
-  "version": "2.7.1",
+  "version": "2.8.0",
   "description": "CLI and build toolkit for B2C landing projects",
   "type": "module",
   "bin": {

package/src/cli/index.mjs

@@ -10,6 +10,7 @@ Commands:
   deploy                    Build, sync assets, and deploy CMS widgets
   deploy --dry-run          Show the exact deploy plan without changing CMS
   deploy --update           Update the current CMS version in place
+  deploy --relink           Attach the project to an existing CMS page
   deploy --assets-only      Build and sync assets with the B2C CDN
   check                     Validate project configuration
   block:add <key>           Create a block
@@ -78,11 +79,11 @@ export async function runCli(args) {
     return;
   }
   if (command === "deploy") {
-    const allowed = new Set(["--assets-only", "--update", "--dry-run"]);
+    const allowed = new Set(["--assets-only", "--update", "--dry-run", "--relink"]);
     const flags = new Set(rest);
     if (rest.some((argument) => !allowed.has(argument)) || flags.size !== rest.length ||
-      (flags.has("--assets-only") && flags.has("--update"))) {
-      throw new Error("Usage: b2c-landing-vite deploy [--assets-only | --update] [--dry-run]");
+      (flags.has("--assets-only") && (flags.has("--update") || flags.has("--relink")))) {
+      throw new Error("Usage: b2c-landing-vite deploy [--assets-only | --update] [--relink] [--dry-run]");
     }
     const config = await loadConfig();
     validateProject(config);
@@ -98,10 +99,17 @@ export async function runCli(args) {
         token,
         update: flags.has("--update"),
         assetsOnly: flags.has("--assets-only"),
+        relink: flags.has("--relink"),
       });
     }
     if (rest.includes("--assets-only")) return deployAssetsOnly({config, preset, token});
-    return deployProject({config, preset, token, update: rest.includes("--update")});
+    return deployProject({
+      config,
+      preset,
+      token,
+      update: flags.has("--update"),
+      relink: flags.has("--relink"),
+    });
   }
   if (command === "block:add" || command === "block:rename") {
     const config = await loadConfig();

package/src/deploy/backoffice-client.mjs

@@ -140,6 +140,17 @@ export class BackofficeClient {
     return result?.versions || [];
   }
 
+  async getPages(applicationId, {keyword = "", url = ""} = {}) {
+    const result = await this.request("GET", "/Page/GetAll", {query: {
+      pageIndex: 1,
+      pageSize: 100,
+      ApplicationId: applicationId,
+      Keyword: keyword,
+      Url: url,
+    }});
+    return result?.result || result || [];
+  }
+
   createPage(body) {
     return this.request("POST", "/Page/Create", {body});
   }

package/src/deploy/deploy.mjs

@@ -2,7 +2,7 @@ import {planAssetChanges, uploadChangedAssets} from "./assets.mjs";
 import {BackofficeClient} from "./backoffice-client.mjs";
 import {readBuildManifest} from "./manifest.mjs";
 import {readDeploymentState, writeDeploymentState} from "./state.mjs";
-import {createPagePlacement, prepareExistingPage, selectNewPagePlacement} from "./page.mjs";
+import {createPagePlacement, prepareExistingPage, selectExistingPagePlacement, selectNewPagePlacement} from "./page.mjs";
 import {planWidgetChanges, syncWidgets} from "./widgets.mjs";
 
 function paths(items) {
@@ -21,6 +21,7 @@ export async function planDeployment({
   client,
   update = false,
   assetsOnly = false,
+  relink = false,
   prompts,
   log = console.log,
 }) {
@@ -43,7 +44,13 @@ export async function planDeployment({
   let placement;
   let pageContent;
   let page;
-  if (previous.placement) {
+  if (relink) {
+    const selected = await selectExistingPagePlacement({client: api, domain: preset.domain, prompts});
+    placement = selected.placement;
+    pageContent = selected.pageContent;
+    const checkout = !update && [1, 4].includes(pageContent.status);
+    page = {action: checkout ? "relink and create checkout version" : "relink and update selected version", pageContentId: placement.pageContentId};
+  } else if (previous.placement) {
     placement = previous.placement;
     pageContent = await api.getContent(placement.pageContentId);
     const checkout = !update && [1, 4].includes(pageContent.status);
@@ -106,6 +113,7 @@ export async function deployProject({
   token,
   client,
   update = false,
+  relink = false,
   prompts,
   log = console.log,
 }) {
@@ -121,7 +129,10 @@ export async function deployProject({
     uploadFile: api.uploadFile.bind(api),
     listFiles: api.listFiles?.bind(api),
   });
-  const page = previous.placement
+  const linked = relink ? await selectExistingPagePlacement({client: api, domain: preset.domain, prompts}) : null;
+  const page = linked
+    ? await prepareExistingPage({client: api, placement: linked.placement, update})
+    : previous.placement
     ? await prepareExistingPage({client: api, placement: previous.placement, update})
     : await createPagePlacement({client: api, manifest, prompts});
   const widgets = await syncWidgets({

package/src/deploy/page.mjs

@@ -1,4 +1,4 @@
-import {HTML_WIDGET_ID, STATUS} from "./backoffice-client.mjs";
+import {HTML_WIDGET_ID, RU_LANGUAGE_ID, STATUS} from "./backoffice-client.mjs";
 
 function suitableAreas(scheme) {
   return scheme.flatMap((row, rowIndex) => (row.children || []).map((column, columnIndex) => ({
@@ -10,6 +10,10 @@ function suitableAreas(scheme) {
   );
 }
 
+function pageWidgets(pageContent) {
+  return pageContent.pageContents?.find((content) => String(content.languageId) === RU_LANGUAGE_ID)?.widgets || [];
+}
+
 function widgetNames(area) {
   return (area.usedWidgets || []).map((widget, index) =>
     widget.widgetName || widget.cmsTitle || widget.name || `widget ${index + 1}`
@@ -24,6 +28,31 @@ function areaLabel({area, rowIndex, columnIndex}) {
   return `Row ${rowIndex + 1}, column ${columnIndex + 1}${width}: ${name} — ${summary}`;
 }
 
+
+function existingAreaLabel(descriptor, widgets) {
+  const areaId = descriptor.area.layoutAreaId || descriptor.area.id;
+  const actual = widgets.filter((widget) => widget.layoutAreaId === areaId);
+  return areaLabel({
+    ...descriptor,
+    area: {...descriptor.area, usedWidgets: actual.map((widget) => ({widgetName: widget.cmsTitle || widget.widgetName}))},
+  });
+}
+
+function pageLabel(page, domain) {
+  const preview = page.contents?.[0]?.uniqueId;
+  const published = page.publishedUrls?.[RU_LANGUAGE_ID];
+  const link = published
+    ? `https://${domain}/${String(published).replace(/^\/+/, "")}`
+    : preview ? `https://${domain}/preview/${preview}/` : "no link";
+  return `${page.pageTitle || page.name || page.pageId} — ${link}`;
+}
+
+function versionLabel(content) {
+  const details = [content.statusName, content.version != null ? `v${content.version}` : null, content.author]
+    .filter(Boolean).join(", ");
+  return `${details || content.pageContentId}${content.modifiedTime ? ` — ${content.modifiedTime}` : ""}`;
+}
+
 async function defaultPrompts() {
   const {isCancel, select, text} = await import("@clack/prompts");
   const answer = async (promise) => {
@@ -94,6 +123,62 @@ export async function selectNewPagePlacement({client, manifest, prompts}) {
   };
 }
 
+export async function selectExistingPagePlacement({client, domain, prompts}) {
+  prompts ||= await defaultPrompts();
+  const applications = (await client.getApplications()).filter((app) => !/backoffice/i.test(app.name));
+  if (!applications.length) throw new Error("No backoffice applications are available");
+  const applicationId = await prompts.select({
+    message: "Application",
+    options: applications.map((app) => ({label: app.name, value: app.id})),
+  });
+  const searchBy = await prompts.select({
+    message: "Find an existing page by",
+    options: [{label: "Title", value: "title"}, {label: "URL", value: "url"}],
+  });
+  const query = await prompts.text({
+    message: searchBy === "title" ? "Page title (at least 3 characters)" : "Page URL (at least 3 characters)",
+    validate: (value) => value?.trim().length >= 3 ? undefined : "Enter at least 3 characters",
+  });
+  const pages = await client.getPages(applicationId, searchBy === "title"
+    ? {keyword: query.trim()}
+    : {url: query.trim()});
+  if (!pages.length) throw new Error(`No CMS pages found for ${JSON.stringify(query.trim())}`);
+  const pageId = await prompts.select({
+    message: "Existing CMS page",
+    options: pages.map((page) => ({label: pageLabel(page, domain), value: page.pageId || page.id, page})),
+  });
+  const page = pages.find((candidate) => (candidate.pageId || candidate.id) === pageId);
+  const versions = page.contents?.length ? page.contents : await client.getContentVersions(pageId);
+  if (!versions?.length) throw new Error("The selected CMS page has no versions");
+  const pageContentId = await prompts.select({
+    message: "Page version",
+    options: versions.map((content) => ({label: versionLabel(content), value: content.pageContentId || content.contentId})),
+  });
+  const pageContent = await client.getContent(pageContentId);
+  const areas = suitableAreas(pageContent.layout?.schema || []);
+  if (!areas.length) throw new Error("The selected page layout has no HTML widget area");
+  const widgets = pageWidgets(pageContent);
+  const layoutAreaId = await prompts.select({
+    message: "Where on the existing page should the landing blocks go?",
+    options: areas.map((descriptor) => ({
+      label: existingAreaLabel(descriptor, widgets),
+      value: descriptor.area.layoutAreaId || descriptor.area.id,
+    })),
+  });
+  const names = widgets.filter((widget) => widget.layoutAreaId === layoutAreaId)
+    .map((widget, index) => widget.cmsTitle || widget.widgetName || `widget ${index + 1}`);
+  const orderIndex = await prompts.select({
+    message: "Exact insertion point",
+    options: Array.from({length: names.length + 1}, (_, index) => ({
+      label: index === 0
+        ? names.length ? `At the beginning, before “${names[0]}”` : "Into the empty area"
+        : `After “${names[index - 1]}”`,
+      value: index,
+    })),
+  });
+  return {pageContent, placement: {pageContentId, layoutAreaId, orderIndex}};
+}
+
 export async function createPagePlacement(options) {
   const selected = await selectNewPagePlacement(options);
   const {client} = options;