@homebound/beam 3.31.2 → 3.32.0

package/dist/index.d.cts

@@ -6205,11 +6205,20 @@ type ImpersonatedUser = {
 type EnvironmentBannerProps = {
     env: AppEnvironment;
     impersonating?: ImpersonatedUser;
+    /**
+     * Shows the production warning banner; typically set to `true` only for developers in the consuming app.
+     * Its styling takes precedence over impersonation (red fill + prod warning copy, with impersonation still
+     * shown on the right).
+     */
+    showProdWarning?: boolean;
 };
 /** Environment banner; horizontal/vertical pinning is owned by {@link EnvironmentBannerLayout}. */
 declare function EnvironmentBanner(props: EnvironmentBannerProps): JSX.Element | null;
-/** True when {@link EnvironmentBanner} should display: `dev`, `qa`, `local-prod`, or `prod` while impersonating. */
-declare function shouldShowEnvironmentBanner(env: AppEnvironment, impersonating: ImpersonatedUser | undefined): boolean;
+/**
+ * True when {@link EnvironmentBanner} should display: `dev`, `qa`, `local-prod`, or `prod` while impersonating
+ * or when `showProdWarning` is set (typically only for developers in the consuming app).
+ */
+declare function shouldShowEnvironmentBanner(env: AppEnvironment, impersonating: ImpersonatedUser | undefined, showProdWarning: boolean): boolean;
 /** Fixed banner height (px); {@link EnvironmentBannerLayout} reads this for spacer/CSS var offsets. */
 declare const environmentBannerSizePx = 34;
 

package/dist/index.d.ts

@@ -6205,11 +6205,20 @@ type ImpersonatedUser = {
 type EnvironmentBannerProps = {
     env: AppEnvironment;
     impersonating?: ImpersonatedUser;
+    /**
+     * Shows the production warning banner; typically set to `true` only for developers in the consuming app.
+     * Its styling takes precedence over impersonation (red fill + prod warning copy, with impersonation still
+     * shown on the right).
+     */
+    showProdWarning?: boolean;
 };
 /** Environment banner; horizontal/vertical pinning is owned by {@link EnvironmentBannerLayout}. */
 declare function EnvironmentBanner(props: EnvironmentBannerProps): JSX.Element | null;
-/** True when {@link EnvironmentBanner} should display: `dev`, `qa`, `local-prod`, or `prod` while impersonating. */
-declare function shouldShowEnvironmentBanner(env: AppEnvironment, impersonating: ImpersonatedUser | undefined): boolean;
+/**
+ * True when {@link EnvironmentBanner} should display: `dev`, `qa`, `local-prod`, or `prod` while impersonating
+ * or when `showProdWarning` is set (typically only for developers in the consuming app).
+ */
+declare function shouldShowEnvironmentBanner(env: AppEnvironment, impersonating: ImpersonatedUser | undefined, showProdWarning: boolean): boolean;
 /** Fixed banner height (px); {@link EnvironmentBannerLayout} reads this for spacer/CSS var offsets. */
 declare const environmentBannerSizePx = 34;
 

package/dist/index.js

@@ -21845,10 +21845,11 @@ function EnvironmentBanner(props) {
   const {
     env,
     impersonating,
+    showProdWarning = false,
     ...others
   } = props;
   const tid = useTestIds(others, "environmentBanner");
-  if (!shouldShowEnvironmentBanner(env, impersonating)) {
+  if (!shouldShowEnvironmentBanner(env, impersonating, showProdWarning)) {
     return null;
   }
   const {
@@ -21856,7 +21857,7 @@ function EnvironmentBanner(props) {
     badgeLabel,
     message,
     tooltip
-  } = getEnvironmentBannerConfig(env, impersonating);
+  } = getEnvironmentBannerConfig(env, impersonating, showProdWarning);
   const bgColorVar = maybeCssVar(bgColor);
   return /* @__PURE__ */ jsxs84("div", { ...trussProps83({
     flexShrink: "fs0",
@@ -21899,7 +21900,7 @@ function EnvironmentBanner(props) {
         ] })
       ] }),
       impersonating != null && /* @__PURE__ */ jsxs84("span", { className: "df aic gap2 fw6 fz_12px lh_16px white fs0", ...tid.impersonating, children: [
-        env !== "prod" && /* @__PURE__ */ jsxs84("span", { children: [
+        (env !== "prod" || showProdWarning) && /* @__PURE__ */ jsxs84("span", { children: [
           /* @__PURE__ */ jsx166("span", { className: "dn mdandup_dib", children: "Impersonating \xA0" }),
           impersonating.name
         ] }),
@@ -21908,10 +21909,10 @@ function EnvironmentBanner(props) {
     ] })
   ] });
 }
-function shouldShowEnvironmentBanner(env, impersonating) {
-  return env === "dev" || env === "qa" || env === "local-prod" || env === "prod" && isDefined(impersonating);
+function shouldShowEnvironmentBanner(env, impersonating, showProdWarning) {
+  return env === "dev" || env === "qa" || env === "local-prod" || env === "prod" && (isDefined(impersonating) || showProdWarning);
 }
-function getEnvironmentBannerConfig(env, impersonating) {
+function getEnvironmentBannerConfig(env, impersonating, showProdWarning) {
   switch (env) {
     case "dev":
       return {
@@ -21927,9 +21928,16 @@ function getEnvironmentBannerConfig(env, impersonating) {
         message: "You are in the QA Environment",
         tooltip: "You are in the QA Environment. Any changes here will not be reflected in live production data."
       };
-    // Prod env banner should only be displayed when impersonating
+    // Prod banner shows when impersonating or when `showProdWarning` is set. The prod warning takes precedence:
+    // it reuses the red local-prod fill for "live prod data" urgency, while impersonation (if any) still shows
+    // on the right. Impersonation alone keeps its own prod fill and copy.
     case "prod":
-      return {
+      return showProdWarning ? {
+        bgColor: "--b-env-brand-local-prod" /* EnvBrandLocalProd */,
+        badgeLabel: "PROD",
+        message: "You are in the Production Environment",
+        tooltip: "You are in the Production Environment. Any changes here WILL be reflected in live production data."
+      } : {
         bgColor: "--b-env-brand-prod" /* EnvBrandProd */,
         badgeLabel: "PROD",
         message: `You are impersonating ${impersonating?.name}`,
@@ -24160,7 +24168,7 @@ function EnvironmentBannerLayout(props) {
     children
   } = props;
   const tid = useTestIds(props, "environmentBannerLayout");
-  const showBanner = environmentBanner != null && shouldShowEnvironmentBanner(environmentBanner.env, environmentBanner.impersonating);
+  const showBanner = environmentBanner != null && shouldShowEnvironmentBanner(environmentBanner.env, environmentBanner.impersonating, environmentBanner.showProdWarning ?? false);
   const bannerHeightPx = showBanner ? environmentBannerSizePx : 0;
   const style = {
     [beamEnvironmentBannerLayoutHeightVar]: `${bannerHeightPx}px`