@djangocfg/nextjs 2.1.483 → 2.1.484

package/README.md

@@ -370,7 +370,7 @@ registration, cache layers, and deployment notes.
 Create a health monitoring endpoint:
 
 ```tsx
-// app/api/health/route.ts
+// app/healthz/route.ts
 import { createHealthHandler } from '@djangocfg/nextjs/health';
 
 export const GET = createHealthHandler({
@@ -717,4 +717,3 @@ Issues and pull requests are welcome at [GitHub](https://github.com/markolofsen/
 ## License
 
 MIT - see [LICENSE](./LICENSE) for details
-

package/dist/config/index.d.mts

@@ -361,6 +361,24 @@ declare const isDev: boolean;
 declare const isProduction: boolean;
 declare const isCI: boolean;
 declare function getBasePath(isDefaultCfgAdmin?: boolean): string;
+/**
+ * Resolve the API origin that gets inlined into the client bundle.
+ *
+ * `NEXT_PUBLIC_*` is substituted at BUILD time, so a value supplied only at
+ * container runtime (a compose `environment:` entry, a `docker run -e`) arrives
+ * far too late — the bundle already shipped with whatever was present during
+ * `next build`.
+ *
+ * An empty result means "no API origin is configured". Callers MUST treat that
+ * as *do not send the request* rather than falling back to a relative path: the
+ * browser resolves a relative URL against the CURRENT page, so on an
+ * i18n-prefixed route `/cfg/accounts/profile` silently becomes
+ * `https://site.com/<locale>/cfg/accounts/profile` — a 404 that reproduces only
+ * in production. Use {@link hasApiUrl} to gate those call sites.
+ *
+ * The one case where empty legitimately means "relative": a static build served
+ * from the same origin as Django.
+ */
 declare function getApiUrl(): string;
 declare function getSiteUrl(): string;
 

package/dist/config/index.mjs

@@ -14,7 +14,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@djangocfg/nextjs",
-      version: "2.1.483",
+      version: "2.1.484",
       description: "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
       keywords: [
         "nextjs",
@@ -399,6 +399,7 @@ import { createRequire } from "module";
 import { join } from "path";
 
 // src/config/utils/env.ts
+import consola2 from "consola";
 var isStaticBuild = process.env.NEXT_PUBLIC_STATIC_BUILD === "true";
 var isDev = process.env.NODE_ENV === "development";
 var isProduction = !isDev;
@@ -410,6 +411,15 @@ function getBasePath(isDefaultCfgAdmin) {
 function getApiUrl() {
   return isStaticBuild ? "" : process.env.NEXT_PUBLIC_API_URL || "";
 }
+function hasApiUrl() {
+  return isStaticBuild || Boolean(process.env.NEXT_PUBLIC_API_URL);
+}
+function warnIfApiUrlMissing() {
+  if (hasApiUrl() || isDev) return;
+  consola2.warn(
+    "NEXT_PUBLIC_API_URL is not set \u2014 API-backed features are disabled in this build.\nRequests that need it are skipped rather than sent to a relative path.\nIf this app DOES have a backend, the value must be present at BUILD time:\n  \u2022 commit it to the app's `.env.production`, and check no `.dockerignore`\n    rule (e.g. `**/.env*`) strips that file from the build context;\n  \u2022 or pass it as a Dockerfile ARG/ENV before the build step.\nA compose `environment:` entry is too late \u2014 it only exists at runtime."
+  );
+}
 function getSiteUrl() {
   return isStaticBuild ? "" : process.env.NEXT_PUBLIC_SITE_URL || "";
 }
@@ -585,7 +595,7 @@ Example queries:
 import chalk from "chalk";
 import { execSync, spawn } from "child_process";
 import Conf from "conf";
-import consola2 from "consola";
+import consola3 from "consola";
 import { createInterface } from "readline";
 function createMemoryCache() {
   const store = /* @__PURE__ */ new Map();
@@ -804,13 +814,13 @@ async function installPackagesWithProgress(packages) {
   }
   console.log("");
   if (failedPackages.length === 0) {
-    consola2.success(`All ${total} packages installed successfully!`);
+    consola3.success(`All ${total} packages installed successfully!`);
     return true;
   } else if (successCount > 0) {
-    consola2.warn(`${successCount}/${total} packages installed. Failed: ${failedPackages.join(", ")}`);
+    consola3.warn(`${successCount}/${total} packages installed. Failed: ${failedPackages.join(", ")}`);
     return false;
   } else {
-    consola2.error(`Failed to install packages: ${failedPackages.join(", ")}`);
+    consola3.error(`Failed to install packages: ${failedPackages.join(", ")}`);
     return false;
   }
 }
@@ -821,7 +831,7 @@ async function installPackages(packages) {
   if (packages.length === 0) return true;
   const pm = detectPackageManager();
   const command = buildInstallCommand(packages, pm);
-  consola2.info(`Installing: ${chalk.cyan(packages.map((p) => p.name).join(", "))}`);
+  consola3.info(`Installing: ${chalk.cyan(packages.map((p) => p.name).join(", "))}`);
   const spinner = createSpinner("Installing packages...");
   spinner.start();
   return new Promise((resolve) => {
@@ -861,7 +871,7 @@ async function checkAndInstallPackages(options = {}) {
     return installPackages(toInstall);
   }
   console.log("");
-  consola2.box("\u{1F4E6} Missing Optional Packages");
+  consola3.box("\u{1F4E6} Missing Optional Packages");
   console.log("");
   for (const pkg of toInstall) {
     console.log(`  ${chalk.yellow("\u2022")} ${chalk.bold(pkg.name)}`);
@@ -885,7 +895,7 @@ async function checkAndInstallPackages(options = {}) {
       );
       if (enableAuto) {
         installerCache.set("autoInstall", true);
-        consola2.info("Auto-install enabled. Run with --no-auto-install to disable.");
+        consola3.info("Auto-install enabled. Run with --no-auto-install to disable.");
       }
     }
     return success;
@@ -896,7 +906,7 @@ async function checkAndInstallPackages(options = {}) {
   if (skipPermanently) {
     const currentSkip = installerCache.get("skipPackages") || [];
     installerCache.set("skipPackages", [...currentSkip, ...toInstall.map((p) => p.name)]);
-    consola2.info("Packages added to skip list.");
+    consola3.info("Packages added to skip list.");
   }
   return false;
 }
@@ -904,19 +914,19 @@ function printMissingPackagesInfo(packages) {
   if (packages.length === 0) return;
   const pm = detectPackageManager();
   const command = buildInstallCommand(packages, pm);
-  consola2.warn(`Missing optional packages: ${packages.map((p) => p.name).join(", ")}`);
-  consola2.info(`Install with: ${chalk.cyan(command)}`);
+  consola3.warn(`Missing optional packages: ${packages.map((p) => p.name).join(", ")}`);
+  consola3.info(`Install with: ${chalk.cyan(command)}`);
 }
 function resetInstallerPreferences() {
   installerCache.clear();
-  consola2.success("Installer preferences reset");
+  consola3.success("Installer preferences reset");
 }
 
 // src/config/packages/updater.ts
 import chalk2 from "chalk";
 import { spawn as spawn2 } from "child_process";
 import Conf2 from "conf";
-import consola3 from "consola";
+import consola4 from "consola";
 import { createRequire as createRequire2 } from "module";
 import { join as join2 } from "path";
 import { createInterface as createInterface2 } from "readline";
@@ -1176,13 +1186,13 @@ async function updatePackagesWithProgress(packages) {
   }
   console.log("");
   if (failedPackages.length === 0) {
-    consola3.success(`All ${total} packages updated successfully!`);
+    consola4.success(`All ${total} packages updated successfully!`);
     return true;
   } else if (successCount > 0) {
-    consola3.warn(`${successCount}/${total} packages updated. Failed: ${failedPackages.join(", ")}`);
+    consola4.warn(`${successCount}/${total} packages updated. Failed: ${failedPackages.join(", ")}`);
     return false;
   } else {
-    consola3.error(`Failed to update packages: ${failedPackages.join(", ")}`);
+    consola4.error(`Failed to update packages: ${failedPackages.join(", ")}`);
     return false;
   }
 }
@@ -1207,7 +1217,7 @@ async function checkAndUpdatePackages(options = {}) {
     return updatePackagesWithProgress(outdated);
   }
   console.log("");
-  consola3.box("\u{1F4E6} Updates Available");
+  consola4.box("\u{1F4E6} Updates Available");
   console.log("");
   for (const pkg of outdated) {
     console.log(
@@ -1226,7 +1236,7 @@ async function checkAndUpdatePackages(options = {}) {
       );
       if (enableAuto) {
         updaterCache.set("autoUpdate", true);
-        consola3.info("Auto-update enabled.");
+        consola4.info("Auto-update enabled.");
       }
     }
     return success;
@@ -1242,19 +1252,19 @@ async function checkAndUpdatePackages(options = {}) {
       }
     }
     updaterCache.set("skippedVersions", skipped);
-    consola3.info("Versions skipped. Will prompt again for newer versions.");
+    consola4.info("Versions skipped. Will prompt again for newer versions.");
   }
   return false;
 }
 function resetUpdaterPreferences() {
   updaterCache.clear();
-  consola3.success("Updater preferences reset");
+  consola4.success("Updater preferences reset");
 }
 
 // src/config/utils/version.ts
 import chalk3 from "chalk";
 import Conf3 from "conf";
-import consola4 from "consola";
+import consola5 from "consola";
 import semver2 from "semver";
 function createMemoryCache3() {
   const store = /* @__PURE__ */ new Map();
@@ -1346,10 +1356,10 @@ function getUpdateCommand() {
 async function printVersionInfo() {
   const { hasUpdate, currentVersion, latestVersion } = await checkForUpdate();
   if (!currentVersion) return;
-  consola4.box(`\u{1F4E6} @djangocfg/nextjs v${currentVersion}`);
+  consola5.box(`\u{1F4E6} @djangocfg/nextjs v${currentVersion}`);
   if (hasUpdate && latestVersion) {
-    consola4.warn(`Update Available! ${chalk3.red(currentVersion)} \u2192 ${chalk3.green(latestVersion)}`);
-    consola4.info(`Run: ${chalk3.cyan(getUpdateCommand())}`);
+    consola5.warn(`Update Available! ${chalk3.red(currentVersion)} \u2192 ${chalk3.green(latestVersion)}`);
+    consola5.info(`Run: ${chalk3.cyan(getUpdateCommand())}`);
     console.log("");
   }
 }
@@ -1449,6 +1459,7 @@ function deepMerge(target, source) {
 // src/config/createNextConfig.ts
 function createBaseNextConfig(options = {}) {
   const basePath = getBasePath(options.isDefaultCfgAdmin);
+  warnIfApiUrlMissing();
   const apiUrl = getApiUrl();
   const siteUrl = getSiteUrl();
   const baseConfig = {