elseware-ui 2.33.0 → 2.34.1

package/dist/index.js

@@ -188,6 +188,427 @@ function resolveAppearanceStyles({
       return solid[variant];
   }
 }
+
+// src/utils/configurator/errors.ts
+var ConfiguratorError = class extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.name = "ConfiguratorError";
+    this.cause = cause;
+  }
+};
+function formatIssue(issue) {
+  const path = issue.path?.join(".") || "config";
+  return `${path} : ${issue.message ?? "Invalid value"}`;
+}
+function formatConfigError(error) {
+  const maybeZodError = error;
+  if (Array.isArray(maybeZodError.issues)) {
+    return maybeZodError.issues.map(formatIssue).join("\n");
+  }
+  if (maybeZodError?.message) {
+    return maybeZodError.message;
+  }
+  return "Invalid configuration";
+}
+function toConfiguratorError(error, fallbackMessage) {
+  if (error instanceof ConfiguratorError) {
+    return error;
+  }
+  if (error instanceof Error) {
+    return new ConfiguratorError(error.message || fallbackMessage, error);
+  }
+  return new ConfiguratorError(fallbackMessage, error);
+}
+
+// src/utils/configurator/Configurator.ts
+var Configurator = class {
+  constructor(options) {
+    this.initialized = false;
+    this.config = null;
+    this.configError = null;
+    this.name = options.name ?? "config";
+    this.source = options.env;
+    this.schema = options.schema;
+    this.transform = options.transform;
+    if (options.validateOnCreate !== false) {
+      this.reload();
+    }
+  }
+  get isValid() {
+    this.ensureInitialized();
+    return !this.configError;
+  }
+  get error() {
+    this.ensureInitialized();
+    return this.configError;
+  }
+  get value() {
+    this.ensureInitialized();
+    if (this.configError) {
+      throw this.configError;
+    }
+    return this.config;
+  }
+  get optionalValue() {
+    this.ensureInitialized();
+    return this.config;
+  }
+  reload(env = this.source) {
+    this.source = env;
+    this.initialized = true;
+    const result = this.schema.safeParse(env);
+    if (!result.success) {
+      this.config = null;
+      this.configError = toConfiguratorError(
+        result.error,
+        formatConfigError(result.error)
+      );
+      return {
+        success: false,
+        config: null,
+        error: this.configError
+      };
+    }
+    try {
+      this.config = this.transform ? this.transform(result.data, { name: this.name }) : result.data;
+      this.configError = null;
+      return {
+        success: true,
+        config: this.config,
+        error: null
+      };
+    } catch (error) {
+      this.config = null;
+      this.configError = toConfiguratorError(
+        error,
+        `Failed to transform ${this.name}`
+      );
+      return {
+        success: false,
+        config: null,
+        error: this.configError
+      };
+    }
+  }
+  get(key) {
+    this.ensureInitialized();
+    if (!this.config) {
+      return void 0;
+    }
+    return this.config[key];
+  }
+  getRequired(key) {
+    const value = this.get(key);
+    if (value === void 0 || value === null) {
+      throw new Error(`Missing required config value: ${String(key)}`);
+    }
+    return value;
+  }
+  getPath(path, fallback) {
+    this.ensureInitialized();
+    if (!this.config) {
+      return fallback;
+    }
+    const value = path.split(".").reduce((current, key) => {
+      if (!current || typeof current !== "object") {
+        return void 0;
+      }
+      return current[key];
+    }, this.config);
+    return value === void 0 ? fallback : value;
+  }
+  getPathRequired(path) {
+    const value = this.getPath(path);
+    if (value === void 0 || value === null) {
+      throw new Error(`Missing required config value: ${path}`);
+    }
+    return value;
+  }
+  ensureInitialized() {
+    if (!this.initialized) {
+      this.reload();
+    }
+  }
+};
+
+// src/utils/configurator/createConfigurator.ts
+function createConfigurator(options) {
+  return new Configurator(options);
+}
+
+// src/utils/configurator/helpers/browser.ts
+function getBrowserOrigin() {
+  if (typeof window === "undefined") {
+    return "";
+  }
+  return window.location.origin;
+}
+function getBrowserHref() {
+  if (typeof window === "undefined") {
+    return "";
+  }
+  return window.location.href;
+}
+function getBrowserRedirectURL(options = {}) {
+  const {
+    queryParam = "redirect_uri",
+    fallbackPath = "/",
+    currentHref = getBrowserHref(),
+    referrerMode = "path"
+  } = options;
+  try {
+    if (currentHref) {
+      const currentURL = new URL(currentHref);
+      const redirectUri = currentURL.searchParams.get(queryParam);
+      if (redirectUri) {
+        return redirectUri;
+      }
+    }
+    if (typeof document !== "undefined" && document.referrer) {
+      const referrerURL = new URL(document.referrer);
+      if (referrerMode === "full") {
+        return referrerURL.toString();
+      }
+      return `${referrerURL.pathname}${referrerURL.search}${referrerURL.hash}`;
+    }
+    return fallbackPath;
+  } catch {
+    return fallbackPath;
+  }
+}
+
+// src/utils/configurator/helpers/json.ts
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function parseJson(value, key = "JSON value") {
+  if (isRecord(value) || Array.isArray(value)) {
+    return value;
+  }
+  if (typeof value !== "string") {
+    throw new ConfiguratorError(`${key} must be a JSON string`);
+  }
+  try {
+    return JSON.parse(value);
+  } catch {
+    throw new ConfiguratorError(`Invalid ${key} JSON`);
+  }
+}
+function parseJsonRecord(value, key = "JSON record", validateValue) {
+  const parsed = parseJson(value, key);
+  if (!isRecord(parsed)) {
+    throw new ConfiguratorError(`${key} must be a JSON object`);
+  }
+  return Object.entries(parsed).reduce(
+    (acc, [name, item]) => {
+      acc[name] = validateValue ? validateValue(name, item) : item;
+      return acc;
+    },
+    {}
+  );
+}
+
+// src/utils/configurator/helpers/url.ts
+function assertAbsoluteURL(value, key = "URL") {
+  if (typeof value !== "string") {
+    throw new ConfiguratorError(`${key} must be a string URL`);
+  }
+  try {
+    const url = new URL(value);
+    if (!["http:", "https:"].includes(url.protocol)) {
+      throw new Error();
+    }
+    return url.toString();
+  } catch {
+    throw new ConfiguratorError(`${key} must be a valid http/https URL`);
+  }
+}
+function parseUrlMap(value, key = "URL map") {
+  return parseJsonRecord(
+    value,
+    key,
+    (name, item) => assertAbsoluteURL(item, `${key}.${name}`)
+  );
+}
+function buildURL(base, path = "", params = {}) {
+  const url = new URL(assertAbsoluteURL(base, "base URL"));
+  if (path) {
+    const currentPath = url.pathname.replace(/\/$/, "");
+    const nextPath = path.replace(/^\/+/, "");
+    url.pathname = `${currentPath}/${nextPath}`;
+  }
+  Object.entries(params).forEach(([key, value]) => {
+    if (value !== void 0 && value !== null) {
+      url.searchParams.set(key, String(value));
+    }
+  });
+  return url.toString();
+}
+function resolveURLMap(source) {
+  return typeof source === "function" ? source() : source;
+}
+function createURLResolver(source, options = {}) {
+  const { label = "URL" } = options;
+  return (tag, path = "", params = {}) => {
+    const map = resolveURLMap(source) ?? {};
+    const base = map[tag];
+    if (!base) {
+      throw new ConfiguratorError(`${label} not configured for tag: ${tag}`);
+    }
+    return buildURL(base, path, params);
+  };
+}
+function getAllowedOrigins(options = {}) {
+  const {
+    urls = [],
+    maps = [],
+    includeCurrentOrigin = true,
+    currentOrigin = getBrowserOrigin()
+  } = options;
+  const origins = /* @__PURE__ */ new Set();
+  if (includeCurrentOrigin && currentOrigin) {
+    origins.add(currentOrigin);
+  }
+  urls.forEach((url) => {
+    origins.add(new URL(assertAbsoluteURL(url)).origin);
+  });
+  maps.forEach((map) => {
+    Object.values(map ?? {}).forEach((url) => {
+      origins.add(new URL(assertAbsoluteURL(url)).origin);
+    });
+  });
+  return Array.from(origins);
+}
+function getSafeRedirect(options = {}) {
+  const {
+    redirectUri,
+    fallback = "/",
+    allowedOrigins = [],
+    currentOrigin = getBrowserOrigin(),
+    allowedProtocols = ["http:", "https:"]
+  } = options;
+  try {
+    if (!redirectUri) {
+      return fallback;
+    }
+    const url = new URL(redirectUri, currentOrigin || fallback);
+    if (!allowedProtocols.includes(url.protocol)) {
+      return fallback;
+    }
+    const allowed = new Set(allowedOrigins);
+    if (currentOrigin) {
+      allowed.add(currentOrigin);
+    }
+    if (!allowed.has(url.origin)) {
+      return fallback;
+    }
+    return url.toString();
+  } catch {
+    return fallback;
+  }
+}
+function getErrorMessage(error) {
+  if (!error) {
+    return "Unknown configuration error";
+  }
+  if (error instanceof Error) {
+    return error.message || "Unknown configuration error";
+  }
+  if (typeof error === "string") {
+    return error;
+  }
+  try {
+    return JSON.stringify(error, null, 2);
+  } catch {
+    return "Unknown configuration error";
+  }
+}
+function getErrorStack(error) {
+  if (error instanceof Error) {
+    return error.stack;
+  }
+  return null;
+}
+function EnvErrorScreen({
+  error,
+  title = "Invalid Environment Configuration",
+  description = "The app could not start because one or more environment values are missing or invalid.",
+  footer,
+  showStack = false
+}) {
+  const message = getErrorMessage(error);
+  const stack = getErrorStack(error);
+  const lines = message.split("\n").filter(Boolean);
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "min-h-screen flex items-center justify-center bg-black text-white p-8", children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "max-w-4xl w-full rounded-xl border border-red-500 bg-red-950/30 p-6 shadow-2xl shadow-red-950/40", children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "mb-5", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("h1", { className: "text-2xl font-bold text-red-400 mb-2", children: title }),
+      description && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm text-red-100/80", children: description })
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "rounded-lg border border-red-500/30 bg-black/40 p-4", children: /* @__PURE__ */ jsxRuntime.jsx("pre", { className: "overflow-auto text-sm whitespace-pre-wrap text-red-100", children: lines.length > 0 ? lines.join("\n") : "Unknown configuration error" }) }),
+    showStack && stack && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "mt-4 rounded-lg border border-red-500/20 bg-black/30 p-4", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("p", { className: "mb-2 text-xs font-semibold uppercase tracking-wide text-red-300", children: "Stack trace" }),
+      /* @__PURE__ */ jsxRuntime.jsx("pre", { className: "overflow-auto text-xs whitespace-pre-wrap text-red-100/70", children: stack })
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "mt-5 text-sm text-red-100/70", children: footer ?? /* @__PURE__ */ jsxRuntime.jsxs("p", { children: [
+      "Fix your ",
+      /* @__PURE__ */ jsxRuntime.jsx("code", { className: "text-red-200", children: ".env" }),
+      " values and restart the development server."
+    ] }) })
+  ] }) });
+}
+var EnvErrorScreen_default = EnvErrorScreen;
+function ConfigBootstrap({
+  config,
+  loadApp,
+  ErrorComponent = EnvErrorScreen_default,
+  LoadingComponent,
+  loadingFallback = null,
+  showStack = false
+}) {
+  const [RootApp, setRootApp] = React3.useState(null);
+  const [loadError, setLoadError] = React3.useState(null);
+  React3.useEffect(() => {
+    if (!config.isValid) {
+      return;
+    }
+    let mounted = true;
+    loadApp().then((module) => {
+      if (mounted) {
+        setRootApp(() => module.default);
+      }
+    }).catch((error) => {
+      if (mounted) {
+        setLoadError(error);
+      }
+    });
+    return () => {
+      mounted = false;
+    };
+  }, [config, loadApp]);
+  if (!config.isValid) {
+    return /* @__PURE__ */ jsxRuntime.jsx(ErrorComponent, { error: config.error, showStack });
+  }
+  if (loadError) {
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      ErrorComponent,
+      {
+        error: loadError,
+        title: "Application Startup Error",
+        description: "The app configuration was valid, but the application failed while loading.",
+        showStack
+      }
+    );
+  }
+  if (!RootApp) {
+    if (LoadingComponent) {
+      return /* @__PURE__ */ jsxRuntime.jsx(LoadingComponent, {});
+    }
+    return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: loadingFallback });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(RootApp, {});
+}
+var ConfigBootstrap_default = ConfigBootstrap;
 var EUIContext = React3.createContext(null);
 var EUIProvider = ({
   config,
@@ -5300,7 +5721,7 @@ var ShapeSwitch = () => {
     {
       value: currentShape,
       onChange: handleChange,
-      className: "\n          px-3 py-2 rounded-md border border-gray-300\n          bg-white dark:bg-gray-800\n          text-sm shadow-sm\n          focus:outline-none\n        ",
+      className: "\r\n          px-3 py-2 rounded-md border border-gray-300\r\n          bg-white dark:bg-gray-800\r\n          text-sm shadow-sm\r\n          focus:outline-none\r\n        ",
       children: Object.keys(Shape).map((shape) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: shape, children: shape }, shape))
     }
   ) });
@@ -18294,7 +18715,7 @@ function MarkdownTOC({ title = "Table of Contents" }) {
     /* @__PURE__ */ jsxRuntime.jsx("div", { children: /* @__PURE__ */ jsxRuntime.jsx(
       "h2",
       {
-        className: "\n            text-sm\n            font-semibold\n            uppercase\n            tracking-wide\n            text-gray-900\n            dark:text-gray-100\n          ",
+        className: "\r\n            text-sm\r\n            font-semibold\r\n            uppercase\r\n            tracking-wide\r\n            text-gray-900\r\n            dark:text-gray-100\r\n          ",
         children: title
       }
     ) }),
@@ -19624,7 +20045,7 @@ var GlowWrapper = ({
         /* @__PURE__ */ jsxRuntime.jsx(
           "span",
           {
-            className: "\n          pointer-events-none absolute inset-0 opacity-0 \n          group-hover:opacity-100 transition-opacity duration-300\n        ",
+            className: "\r\n          pointer-events-none absolute inset-0 opacity-0 \r\n          group-hover:opacity-100 transition-opacity duration-300\r\n        ",
             style: { background: "var(--glow-bg)" }
           }
         ),
@@ -21326,6 +21747,9 @@ exports.CloudinaryProvider = CloudinaryProvider;
 exports.CloudinaryVideo = CloudinaryVideo_default;
 exports.Code = Code;
 exports.CommentThread = CommentThread_default;
+exports.ConfigBootstrap = ConfigBootstrap_default;
+exports.Configurator = Configurator;
+exports.ConfiguratorError = ConfiguratorError;
 exports.Content = Content;
 exports.ContentArea = ContentArea_default;
 exports.DEFAULT_GRAPH_THEME = DEFAULT_GRAPH_THEME;
@@ -21339,6 +21763,7 @@ exports.Drawer = Drawer;
 exports.DrawerToggler = DrawerToggler_default;
 exports.EUIDevLayout = EUIDevLayout_default;
 exports.EUIProvider = EUIProvider;
+exports.EnvErrorScreen = EnvErrorScreen_default;
 exports.Flag = Flag;
 exports.Flex = Flex;
 exports.FlexCol = FlexCol_default;
@@ -21479,15 +21904,25 @@ exports.WorldMapCountryTable = WorldMapCountryTable;
 exports.YoutubeVideoPlayer = YoutubeVideo_default;
 exports.addReplyToCache = addReplyToCache;
 exports.applyReactionState = applyReactionState;
+exports.assertAbsoluteURL = assertAbsoluteURL;
+exports.buildURL = buildURL;
 exports.cn = cn;
+exports.createConfigurator = createConfigurator;
 exports.createInitialGraphState = createInitialGraphState;
+exports.createURLResolver = createURLResolver;
 exports.decrementReplyCount = decrementReplyCount;
 exports.enumValues = enumValues;
 exports.formatCommentDate = formatCommentDate;
+exports.formatConfigError = formatConfigError;
 exports.formatGraphValue = formatGraphValue;
+exports.getAllowedOrigins = getAllowedOrigins;
+exports.getBrowserHref = getBrowserHref;
+exports.getBrowserOrigin = getBrowserOrigin;
+exports.getBrowserRedirectURL = getBrowserRedirectURL;
 exports.getCurrencySymbol = getCurrencySymbol;
 exports.getOptimisticDislikeState = getOptimisticDislikeState;
 exports.getOptimisticLikeState = getOptimisticLikeState;
+exports.getSafeRedirect = getSafeRedirect;
 exports.graphReducer = graphReducer;
 exports.incrementReplyCount = incrementReplyCount;
 exports.isMatch = isMatch;
@@ -21496,6 +21931,9 @@ exports.limitRealtimePoints = limitRealtimePoints;
 exports.normalize = normalize;
 exports.normalizeGraphData = normalizeGraphData;
 exports.normalizeGraphDataPoint = normalizeGraphDataPoint;
+exports.parseJson = parseJson;
+exports.parseJsonRecord = parseJsonRecord;
+exports.parseUrlMap = parseUrlMap;
 exports.removeComment = removeComment;
 exports.removeCommentTreeFromCache = removeCommentTreeFromCache;
 exports.replaceRealtimePoints = replaceRealtimePoints;
@@ -21504,6 +21942,7 @@ exports.resolveGraphColor = resolveGraphColor;
 exports.resolveGraphColors = resolveGraphColors;
 exports.resolveWithGlobal = resolveWithGlobal;
 exports.sendToast = sendToast;
+exports.toConfiguratorError = toConfiguratorError;
 exports.updateComment = updateComment;
 exports.updateReplyCacheComment = updateReplyCacheComment;
 exports.useClickOutside = useClickOutside;