@trackunit/iris-app-sdk-vite 1.4.12 → 1.4.13

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## 1.4.13 (2026-08-20)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 2.4.13
+- Updated iris-app-api to 2.4.9
+- Updated iris-app to 2.5.13
+
 ## 1.4.12 (2026-08-20)
 
 ### 🧱 Updated Dependencies

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/iris-app-sdk-vite",
-  "version": "1.4.12",
+  "version": "1.4.13",
   "license": "SEE LICENSE IN LICENSE.txt",
   "repository": "https://github.com/Trackunit/manager",
   "executors": "./executors.json",
@@ -10,8 +10,8 @@
   "dependencies": {
     "rxjs": "7.8.1",
     "win-ca": "^3.5.1",
-    "@trackunit/iris-app-build-utilities": "2.4.12",
-    "@trackunit/iris-app-api": "2.4.8",
+    "@trackunit/iris-app-build-utilities": "2.4.13",
+    "@trackunit/iris-app-api": "2.4.9",
     "tslib": "^2.6.2",
     "vite": "8.1.5",
     "@module-federation/vite": "1.18.1",
@@ -22,7 +22,7 @@
     "@tailwindcss/postcss": "^4.1.18",
     "@vitejs/plugin-react-swc": "^4.3.2",
     "@nx/devkit": "23.1.0",
-    "@trackunit/iris-app": "2.5.12",
+    "@trackunit/iris-app": "2.5.13",
     "cross-keychain": "^1.1.0",
     "jwt-decode": "^3.1.2"
   },

package/src/executors/build/executor.js

@@ -11,6 +11,7 @@ const op = tslib_1.__importStar(require("rxjs/operators"));
 require("win-ca");
 const defaultViteConfig_1 = require("../utils/defaultViteConfig");
 const manifestLoader_1 = require("../utils/manifestLoader");
+const resolveSdkVersion_1 = require("../utils/resolveSdkVersion");
 const deleteOutputDir = (root, outputPath) => {
     const resolvedOutputPath = (0, path_1.resolve)(root, outputPath);
     if (resolvedOutputPath === root) {
@@ -41,6 +42,15 @@ async function* buildExecutor(options, context) {
     // by the spec - the import threw before the spec's beforeEach `vi.mock(...)`
     // had any chance to intercept it.
     const IrisAppManifest = await (0, manifestLoader_1.loadManifest)(context.root, projectRootDir);
+    // Stamp the *installed* `@trackunit/iris-app` version (not the declared
+    // range) so the host can decide content-inset behaviour from the published
+    // manifest. Fail-soft: absent version keeps the legacy-inset default.
+    const sdkVersion = (0, resolveSdkVersion_1.resolveSdkVersion)(projectRootDir);
+    if (sdkVersion !== undefined) {
+        IrisAppManifest.sdkVersion = sdkVersion;
+    }
+    // Advisory: warn when past the content-inset cutoff without `p-content-space`.
+    (0, iris_app_build_utilities_1.checkContentInsetAdoption)(sdkVersion, projectRootDir);
     const defaultConfig = await (0, defaultViteConfig_1.getDefaultViteConfig)("production", context.root, projectRootDir, IrisAppManifest, context, {
         skipTypeChecking,
     });

package/src/executors/serve/executor.js

@@ -13,6 +13,7 @@ require("win-ca");
 const checkCustomFields_1 = require("../utils/checkCustomFields");
 const defaultViteConfig_1 = require("../utils/defaultViteConfig");
 const manifestLoader_1 = require("../utils/manifestLoader");
+const resolveSdkVersion_1 = require("../utils/resolveSdkVersion");
 /**
  * Serve executor for serving Iris Apps with Vite.
  *
@@ -37,6 +38,14 @@ async function* serveExecutor(options, context) {
     // by the spec - the import threw before the spec's beforeEach `vi.mock(...)`
     // had any chance to intercept it.
     const irisAppManifest = await (0, manifestLoader_1.loadManifest)(context.root, projectRootDir);
+    // Stamp the installed SDK version so serve's published /manifest.json matches
+    // production builds (plugin also refreshes on emit after disk reloads).
+    const sdkVersion = (0, resolveSdkVersion_1.resolveSdkVersion)(projectRootDir);
+    if (sdkVersion !== undefined) {
+        irisAppManifest.sdkVersion = sdkVersion;
+    }
+    // Advisory: warn when past the content-inset cutoff without `p-content-space`.
+    (0, iris_app_build_utilities_1.checkContentInsetAdoption)(sdkVersion, projectRootDir);
     const checkCustomFieldsResult = await (0, checkCustomFields_1.checkCustomFields)(irisAppManifest, settings);
     if (checkCustomFieldsResult === "out-of-sync") {
         throw new Error("Custom fields are out of sync with the latest approved manifest, which can cause the app to behave in unexpected ways. Please submit and get this version approved before you continue developing the app.");

package/src/executors/utils/defaultViteConfig.js

@@ -33,15 +33,19 @@ const virtualEntryPlugin = {
  * @param mode - "production" or "development"
  * @param nxRootDir - the root of the nx workspace
  * @param appDir - the app directory
- * @param _irisAppManifest - the iris app manifest (used for logging/validation)
+ * @param irisAppManifest - the iris app manifest (may already carry a stamped `sdkVersion`)
  * @param context - NX executor context
  * @returns {Promise<UserConfig>} the default Vite config
  */
-const getDefaultViteConfig = async (mode, nxRootDir, appDir, _irisAppManifest, context, options = {}) => {
+const getDefaultViteConfig = async (mode, nxRootDir, appDir, irisAppManifest, context, options = {}) => {
     // Dynamic import - safe after enableTsConfigPath() is called
     const irisAppPlugins = await (0, getTrackunitIrisAppVitePlugins_1.getTrackunitIrisAppVitePlugins)({
         appDir,
         workspaceRoot: nxRootDir,
+        // Pass the executor-loaded (and possibly sdkVersion-stamped) manifest through so
+        // federation config and the first emit seed share one object — the plugin still
+        // refreshes `sdkVersion` on every generateManifestJson after disk reloads.
+        manifest: irisAppManifest,
         config: { mode },
         serversidePortMap: options.serversidePortMap,
         skipTypeChecking: options.skipTypeChecking,

package/src/executors/utils/getTrackunitIrisAppVitePlugins.js

@@ -16,6 +16,7 @@ const extensionLoaderCache_1 = require("./extensionLoaderCache");
 const loadCssInjectedByJsPlugin_1 = require("./loadCssInjectedByJsPlugin");
 const manifestCache_1 = require("./manifestCache");
 const manifestLoader_1 = require("./manifestLoader");
+const resolveSdkVersion_1 = require("./resolveSdkVersion");
 // Only import enableTsConfigPath statically - other utilities are dynamically imported
 // AFTER tsconfig paths are registered to avoid oxc analysis warnings
 // MIME types for serving extension assets during development
@@ -151,8 +152,11 @@ async function getTrackunitIrisAppVitePlugins(options) {
     // ESM-only since v5 (Vite 8). Load via file URL — Nx CJS executor hooks cannot
     // resolve the package's import-only exports map.
     const cssInjectedByJsPlugin = await (0, loadCssInjectedByJsPlugin_1.loadCssInjectedByJsPlugin)(workspaceRoot);
-    // Load manifest upfront for federation config
-    const initialLoad = await (0, manifestLoader_1.loadManifestWithSources)(workspaceRoot, resolvedAppDir);
+    // Prefer the executor-provided manifest (may already carry stamped sdkVersion);
+    // fall back to a fresh disk load for direct/plugin-only callers.
+    const initialLoad = options.manifest === undefined
+        ? await (0, manifestLoader_1.loadManifestWithSources)(workspaceRoot, resolvedAppDir)
+        : { manifest: options.manifest, sourcePaths: [] };
     const initialManifest = initialLoad.manifest;
     // Directories holding the sources the manifest was derived from. The dev
     // server's own watcher only covers the app root, but a manifest reads across
@@ -267,6 +271,13 @@ async function getTrackunitIrisAppVitePlugins(options) {
         const appSrc = path.join(resolvedAppDir, "src");
         manifestCopy.customFieldDefinitions = (0, iris_app_build_utilities_1.updateCustomFields)(manifestData.customFieldDefinitions, appSrc);
         manifestCopy.extensions = (0, iris_app_build_utilities_1.updateExtensions)([...manifestData.extensions]);
+        // Stamp (or refresh) the installed SDK version on every emit so serve HMR
+        // reloads and production builds both publish it — the build executor also
+        // stamps before config construction, but this path reloads from disk.
+        const sdkVersion = (0, resolveSdkVersion_1.resolveSdkVersion)(resolvedAppDir);
+        if (sdkVersion !== undefined) {
+            manifestCopy.sdkVersion = sdkVersion;
+        }
         return (0, iris_app_build_utilities_1.injectFullDescriptionImages)(manifestCopy, resolvedAppDir);
     };
     const manifestCache = (0, manifestCache_1.createManifestCache)({

package/src/executors/utils/resolveSdkVersion.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IRIS_APP_SDK_PACKAGE_NAME = exports.resolveSdkVersion = exports.defaultSearchRoots = void 0;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("node:fs"));
+const path = tslib_1.__importStar(require("node:path"));
+const PACKAGE_NAME = "@trackunit/iris-app";
+const readPackageName = (packageDir) => {
+    try {
+        const packageJson = JSON.parse(fs.readFileSync(path.join(packageDir, "package.json"), "utf-8"));
+        if (typeof packageJson === "object" &&
+            packageJson !== null &&
+            "name" in packageJson &&
+            typeof packageJson.name === "string") {
+            return packageJson.name;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+const isIrisAppPackageDir = (packageDir) => fs.existsSync(path.join(packageDir, "package.json")) && readPackageName(packageDir) === PACKAGE_NAME;
+/**
+ * Walks `node_modules` upwards from `fromDir` looking for `@trackunit/iris-app`.
+ * Mirrors the layout-tolerant walk in `loadCssInjectedByJsPlugin` so both classic
+ * hoisted installs and Yarn/pnpm isolated layouts resolve correctly.
+ */
+const findIrisAppInNodeModules = (fromDir) => {
+    let dir = path.resolve(fromDir);
+    for (;;) {
+        const candidate = path.join(dir, "node_modules", "@trackunit", "iris-app");
+        if (isIrisAppPackageDir(candidate)) {
+            return candidate;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            return undefined;
+        }
+        dir = parent;
+    }
+};
+/**
+ * Manager monorepo layout: `@trackunit/iris-app` lives at
+ * `libs/iris-app-sdk/iris-app` beside `@trackunit/iris-app-sdk-vite`, and is
+ * often *not* linked into any `node_modules` (Yarn `nodeLinker: pnpm` + TS path
+ * mappings). Walking up from the vite package and accepting a sibling / child
+ * `iris-app` directory recovers the stamped version for in-repo Iris app builds.
+ */
+const findIrisAppAsMonorepoSibling = (fromDir) => {
+    let dir = path.resolve(fromDir);
+    for (;;) {
+        const sibling = path.join(path.dirname(dir), "iris-app");
+        if (isIrisAppPackageDir(sibling)) {
+            return sibling;
+        }
+        const child = path.join(dir, "iris-app");
+        if (isIrisAppPackageDir(child)) {
+            return child;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            return undefined;
+        }
+        dir = parent;
+    }
+};
+/**
+ * Search the consumer app first, then this vite package's own tree.
+ *
+ * Under isolated node_modules layouts (pnpm, Yarn's `nodeLinker: pnpm`) monorepo
+ * Iris apps typically do not link `@trackunit/iris-app` under the app root — it
+ * sits beside `@trackunit/iris-app-sdk-vite` instead. A root-only walk then
+ * leaves `sdkVersion` unstamped and the host keeps the legacy content inset.
+ * ASA leftovers without `p-content-space` go flush; that is the GLU-1873
+ * proving state on this feature branch (pad/accept before master), not a
+ * reason to skip the stamp.
+ */
+const defaultSearchRoots = (fromDir) => [fromDir, __dirname];
+exports.defaultSearchRoots = defaultSearchRoots;
+const findIrisAppPackageDirFromRoots = (searchRoots) => {
+    for (const root of searchRoots) {
+        if (isIrisAppPackageDir(root)) {
+            return root;
+        }
+        const inNodeModules = findIrisAppInNodeModules(root);
+        if (inNodeModules !== undefined) {
+            return inNodeModules;
+        }
+    }
+    for (const root of searchRoots) {
+        const sibling = findIrisAppAsMonorepoSibling(root);
+        if (sibling !== undefined) {
+            return sibling;
+        }
+    }
+    return undefined;
+};
+/**
+ * Resolves the *installed* `@trackunit/iris-app` version from `node_modules`
+ * (not the declared semver range in package.json). Returns `undefined` on any
+ * failure so callers can keep the safe "absent means legacy inset" default.
+ *
+ * @param fromDir - Directory to start the node_modules walk from (typically the app root)
+ * @param searchRoots - Optional override of roots to walk (defaults to app + this package)
+ * @returns {string | undefined} the installed package version, or undefined if unresolved
+ */
+const resolveSdkVersion = (fromDir, searchRoots = (0, exports.defaultSearchRoots)(fromDir)) => {
+    try {
+        const packageDir = findIrisAppPackageDirFromRoots(searchRoots);
+        if (packageDir === undefined) {
+            return undefined;
+        }
+        const packageJson = JSON.parse(fs.readFileSync(path.join(packageDir, "package.json"), "utf-8"));
+        if (typeof packageJson !== "object" ||
+            packageJson === null ||
+            !("version" in packageJson) ||
+            typeof packageJson.version !== "string" ||
+            packageJson.version.length === 0) {
+            return undefined;
+        }
+        return packageJson.version;
+    }
+    catch {
+        return undefined;
+    }
+};
+exports.resolveSdkVersion = resolveSdkVersion;
+exports.IRIS_APP_SDK_PACKAGE_NAME = PACKAGE_NAME;
+//# sourceMappingURL=resolveSdkVersion.js.map