adminizer 5.0.0-build.19 → 5.0.0-build.20

package/helpers/assetVersionHelper.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Adminizer package version. Built entry assets keep stable file names
+ * (app.js, agent.es.js, controls/*.es.js and controls/*.css), so this version
+ * is appended as a query string to invalidate browser caches on release.
+ */
+export declare function getAssetVersion(): string;
+/** Appends ?v=<version> to a production asset URL; dev URLs pass through untouched. */
+export declare function withAssetVersion(url: string): string;
+export declare function withAssetVersion(url: string | undefined): string | undefined;

package/helpers/assetVersionHelper.js

@@ -0,0 +1,30 @@
+import fs from "fs";
+import path from "node:path";
+let cachedVersion = null;
+/**
+ * Adminizer package version. Built entry assets keep stable file names
+ * (app.js, agent.es.js, controls/*.es.js and controls/*.css), so this version
+ * is appended as a query string to invalidate browser caches on release.
+ */
+export function getAssetVersion() {
+    if (cachedVersion !== null) {
+        return cachedVersion;
+    }
+    let version = "";
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.resolve(import.meta.dirname, "../../package.json"), "utf-8"));
+        version = typeof pkg.version === "string" ? pkg.version : "";
+    }
+    catch {
+        // Missing or unreadable package.json: fall back to an empty version.
+    }
+    cachedVersion = version;
+    return version;
+}
+export function withAssetVersion(url) {
+    const version = getAssetVersion();
+    if (!url || !version || process.env.ADMINIZER_ENV === "dev") {
+        return url;
+    }
+    return `${url}${url.includes("?") ? "&" : "?"}v=${version}`;
+}

package/helpers/inertiaAddHelper.js

@@ -1,5 +1,6 @@
 import inertiaActionsHelper from "./inertiaActionsHelper.js";
 import { isObject } from "./JsUtils.js";
+import { withAssetVersion } from "./assetVersionHelper.js";
 import { Adminizer } from "../lib/Adminizer.js";
 const missingControlWarnings = new Set();
 /**
@@ -195,8 +196,8 @@ export function getControlsOptions(fieldConfig, req, type, defaultControlName, c
             ...(control?.getConfig() || {}), // Base config of the editor
             ...(shouldUseFieldConfig ? fieldOptions?.config || {} : {}),
         },
-        path: control.getJsPath(),
-        cssPath: control.getCssPath(),
+        path: withAssetVersion(control.getJsPath()),
+        cssPath: withAssetVersion(control.getCssPath()),
     };
     // If items are provided, use them instead of the CKEditor defaults.
     if (type === 'wysiwyg'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "adminizer",
   "type": "module",
-  "version": "5.0.0-build.19",
+  "version": "5.0.0-build.20",
   "main": "index.js",
   "exports": {
     ".": "./index.js",

package/system/bindInertia.js

@@ -5,6 +5,7 @@ import path from "node:path";
 import { Adminizer } from "../lib/Adminizer.js";
 import { InertiaMenuHelper } from "../helpers/inertiaMenuHelper.js";
 import { getUiTranslations } from "../lib/ui-i18n/getUiTranslations.js";
+import { getAssetVersion } from "../helpers/assetVersionHelper.js";
 import { COMMON_UI_TRANSLATION_KEYS } from "../lib/ui-i18n/uiTranslationKeys.js";
 export function bindInertia(adminizer) {
     const escapeHtmlAttribute = (value) => value
@@ -31,6 +32,9 @@ export function bindInertia(adminizer) {
         }
         return `${adminizer.config.routePrefix}/${customFavicon.replace(/^\/+/, "")}`;
     };
+    // Entry files are built with stable names (app.js, agent.es.js, controls),
+    // so a version query string is what invalidates browser caches on release.
+    const assetVersion = getAssetVersion();
     const viteRender = () => {
         if (process.env.ADMINIZER_ENV === 'dev') {
             return `
@@ -73,19 +77,21 @@ export function bindInertia(adminizer) {
             }
             // JS resource
             if (entry.file) {
-                const href = `${adminizer.config.routePrefix}/assets/${entry.file}`;
+                const href = `${adminizer.config.routePrefix}/assets/${entry.file}?v=${assetVersion}`;
                 preloadLinks.push(`<link rel="modulepreload" href="${href}" as="script">`);
                 scripts.push(`<script type="module" src="${href}"></script>`);
             }
             // Route prefix script
             const routePrefixScript = `<script>window.routePrefix = "${adminizer.config.routePrefix}";</script>`;
             const bindPublic = `<script>window.bindPublic = ${adminizer.config.bind?.public}</script>`;
+            const versionScript = `<script>window.adminizerVersion = "${assetVersion}";</script>`;
             return `
                 ${preloadLinks.join('\n')}
                 ${stylesheets.join('\n')}
                 ${scripts.join('\n')}
                 ${routePrefixScript}
                 ${bindPublic}
+                ${versionScript}
         `;
         }
     };