@adobe/helix-html-pipeline 3.11.24 → 3.12.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [3.12.0](https://github.com/adobe/helix-html-pipeline/compare/v3.11.24...v3.12.0) (2023-07-25)
+
+
+### Features
+
+* also rewrite custom preview and live host links ([#367](https://github.com/adobe/helix-html-pipeline/issues/367)) ([#368](https://github.com/adobe/helix-html-pipeline/issues/368)) ([0127e72](https://github.com/adobe/helix-html-pipeline/commit/0127e720f67fcbd41bc862b26f0e5c42e3979e57)), closes [#359](https://github.com/adobe/helix-html-pipeline/issues/359)
+
 ## [3.11.24](https://github.com/adobe/helix-html-pipeline/compare/v3.11.23...v3.11.24) (2023-07-23)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/helix-html-pipeline",
-  "version": "3.11.24",
+  "version": "3.12.0",
   "description": "Helix HTML Pipeline",
   "main": "src/index.js",
   "types": "src/index.d.ts",

package/src/PipelineState.d.ts

@@ -12,6 +12,7 @@
 import {PathInfo, S3Loader, FormsMessageDispatcher, PipelineTimer} from "./index";
 import {PipelineContent} from "./PipelineContent";
 import {Modifiers} from './utils/modifiers';
+import {ProjectConfig} from "./project-config";
 
 declare enum PipelineType {
   html = 'html',
@@ -29,13 +30,6 @@ declare interface AccessConfig {
   };
 }
 
-declare interface HelixConfigAll {
-  host:string;
-  routes:RegExp[];
-  access?:AccessConfig;
-  [string]:any;
-}
-
 declare interface PipelineOptions {
   log: Console;
   s3Loader: S3Loader;
@@ -97,7 +91,7 @@ declare class PipelineState {
   /**
    * the /.helix/config.json in object form
    */
-  config?: HelixConfigAll;
+  config?: ProjectConfig;
 
   /**
    * the metadata.json in modifier form.
@@ -123,5 +117,17 @@ declare class PipelineState {
    * Authentication information
    */
   authInfo?: AuthInfo;
+
+  /**
+   * the custom preview host if configured via config.cdn.preview.host
+   * this is initialized after the config is loaded.
+   */
+  previewHost?: string;
+
+  /**
+   * the custom live host if configured via config.cdn.live.host
+   * this is initialized after the config is loaded.
+   */
+  liveHost?: string;
 }
 

package/src/project-config.d.ts

@@ -0,0 +1,157 @@
+/*
+ * Copyright 2023 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+// NOTE: this file is autogenerated via 'npm run docs:types' in helix-admin-support
+
+export interface ProjectConfig {
+  /**
+   * Name of the project used by the slack bot when reporting.
+   */
+  name?: string;
+  /**
+   * Name of the project used by the sidekick.
+   */
+  project?: string;
+  /**
+   * Timezone to be used by the slack bot when reporting times.
+   */
+  timezone?: string;
+  /**
+   * Production host use by the slack bot to display project information.
+   */
+  host?: string;
+  /**
+   * configuration blueprint repository in the owner/repo format.
+   */
+  blueprint?: string;
+  /**
+   * the slack teamId/channelID(s) where the slack bot is used.
+   */
+  slack?: string | string[];
+  cdn?: ProjectCDNConfig;
+  access?: SiteAccessConfig;
+  admin?: AdminConfig;
+}
+/**
+ * The CDN config
+ */
+export interface ProjectCDNConfig {
+  prod: FastlyConfig | AkamaiConfig | CloudflareConfig | ManagedConfig;
+  live?: {
+    /**
+     * Sidekick config to override the default preview host. it supports parameters $owner and $repo
+     */
+    host: string;
+  };
+  preview?: {
+    /**
+     * Sidekick config to override the default live host. it supports parameters $owner and $repo
+     */
+    host: string;
+  };
+}
+/**
+ * Production CDN configuration for Fastly
+ */
+export interface FastlyConfig {
+  type: 'fastly';
+  /**
+   * production host
+   */
+  host: string;
+  /**
+   * Route or routes on the CDN that are rendered with Franklin
+   */
+  route: string | string[];
+  /**
+   * The Fastly Service ID
+   */
+  serviceId: string;
+  /**
+   * A Fastly token for purging
+   */
+  authToken: string;
+}
+export interface AkamaiConfig {
+  type: 'akamai';
+  /**
+   * production host
+   */
+  host: string;
+  /**
+   * Route or routes on the CDN that are rendered with Franklin
+   */
+  route: string | string[];
+  endpoint: string;
+  clientSecret: string;
+  clientToken: string;
+  accessToken: string;
+}
+export interface CloudflareConfig {
+  type: 'cloudflare';
+  /**
+   * production host
+   */
+  host: string;
+  /**
+   * Route or routes on the CDN that are rendered with Franklin
+   */
+  route: string | string[];
+  origin: string;
+  plan: string;
+  zoneId: string;
+  apiToken: string;
+}
+export interface ManagedConfig {
+  type: 'managed';
+  /**
+   * production host
+   */
+  host: string;
+  /**
+   * Route or routes on the CDN that are rendered with Franklin
+   */
+  route: string | string[];
+}
+export interface SiteAccessConfig {
+  /**
+   * The email glob of the users that are allowed.
+   */
+  allow: string | string[];
+  /**
+   * the id of the API key(s). this is used to validate the API KEYS and allows to invalidate them.
+   */
+  apiKeyId?: string | string[];
+  require?: {
+    /**
+     * The list of owner/repo pointers to projects that are allowed to use this content.
+     */
+    repository: string | string[];
+  };
+}
+export interface AdminConfig {
+  role?: Role;
+  /**
+   * the id of the API key(s). this is used to validate the API KEYS and allows to invalidate them.
+   */
+  apiKeyId?: string | string[];
+}
+export interface Role {
+  /**
+   * The email glob of the users with author role.
+   */
+  author?: string | string[];
+  /**
+   * The email glob of the users with publish role.
+   */
+  publish?: string | string[];
+}

package/src/steps/fetch-config-all.js

@@ -87,6 +87,15 @@ export function computeRoutes(value) {
   });
 }
 
+function replaceParams(str, info) {
+  if (!str) {
+    return '';
+  }
+  return str
+    .replaceAll('$owner', info.owner)
+    .replaceAll('$repo', info.repo);
+}
+
 /**
  * Loads the /.helix/config-all.json from the content-bus and stores it in the state. if no
  * such config exists, it will load the metadata.json as fallback and separate out the
@@ -117,6 +126,9 @@ export default async function fetchConfigAll(state, req, res) {
       // also update last-modified (only for extensionless html pipeline)
       updateLastModified(state, res, extractLastModified(ret.headers));
     }
+    // set custom preview and live hosts
+    state.previewHost = replaceParams(state.config.cdn?.preview?.host, state);
+    state.liveHost = replaceParams(state.config.cdn?.live?.host, state);
   } else if (ret.status !== 404) {
     throw new PipelineStatusError(502, `failed to load /.helix/config-all.json: ${ret.status}`);
   } else {

package/src/steps/utils.js

@@ -186,7 +186,9 @@ export function rewriteUrl(state, url) {
     return url;
   }
   try {
-    const { pathname, search, hash } = new URL(url);
+    const {
+      host, pathname, search, hash,
+    } = new URL(url);
 
     if (AZURE_BLOB_REGEXP.test(url)) {
       const filename = pathname.split('/').pop();
@@ -200,7 +202,9 @@ export function rewriteUrl(state, url) {
       return `.${pathname}${hash}`;
     }
 
-    if (HELIX_URL_REGEXP.test(url)) {
+    if (HELIX_URL_REGEXP.test(url)
+      || host === state.previewHost
+      || host === state.liveHost) {
       if (hash && pathname === state.info?.path) {
         return hash;
       }