@trackunit/iris-app-build-utilities 2.0.20 → 2.0.22-alpha-84ab66282fc.0

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2.0.21 (2026-06-12)
+
+This was a version bump only for iris-app-build-utilities to align it with other projects, there were no code changes.
+
 ## 2.0.20 (2026-06-11)
 
 ### 🧱 Updated Dependencies

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/iris-app-build-utilities",
-  "version": "2.0.20",
+  "version": "2.0.22-alpha-84ab66282fc.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "repository": "https://github.com/Trackunit/manager",
   "engines": {
@@ -10,14 +10,14 @@
     "tsconfig-paths": "^4.2.0",
     "typescript": "6.0.2",
     "@graphql-codegen/cli": "^5.0.3",
-    "@nx/react": "22.6.5",
+    "@nx/react": "22.7.5",
     "webpack-dev-server": "5.2.1",
     "tslib": "^2.6.2",
     "csp-header": "^6.3.1",
     "@rspack/core": "1.6.7",
-    "@trackunit/iris-app-api": "2.0.20",
-    "@nx/devkit": "22.6.5",
-    "@trackunit/shared-utils": "1.15.28",
+    "@trackunit/iris-app-api": "2.0.21-alpha-84ab66282fc.0",
+    "@nx/devkit": "22.7.5",
+    "@trackunit/shared-utils": "1.15.29-alpha-84ab66282fc.0",
     "http-proxy-middleware": "3.0.5",
     "marked": "14.1.2",
     "pacote": "^21.0.4",

package/src/getGraphqlCodeGenConfig.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getGraphqlCodegenConfig = void 0;
 const fs_1 = require("fs");
 const path_1 = require("path");
+const toPosixWorkspaceRelative_1 = require("./toPosixWorkspaceRelative");
 /**
  * This function returns the codegen config for trackunit public graphql-codegen.
  *
@@ -13,20 +14,27 @@ const path_1 = require("path");
 const getGraphqlCodegenConfig = (nxLibPath, gqlFilePaths) => {
     const internalSchemaFilePath = (0, path_1.join)(__dirname, "..", "..", "..", "..", "libs", "api", "internal-gql-schema", "generated", "internal-schema.gql");
     const publicSchemaUrlOrInternalSchemaPath = (0, fs_1.existsSync)(internalSchemaFilePath)
-        ? internalSchemaFilePath
+        ? (0, toPosixWorkspaceRelative_1.toPosixWorkspaceRelative)(internalSchemaFilePath)
         : "https://iris.trackunit.com/api/graphql/";
     // eslint-disable-next-line no-console
     console.log(`Using schema: ${publicSchemaUrlOrInternalSchemaPath}`);
-    // Adds a / to the end of the path to make gql client-preset happy - also on Windows
-    const generatedGqlOutputFolder = (0, path_1.join)(nxLibPath, "src", "generated", "graphql-api") + "/";
-    if ((0, fs_1.existsSync)(generatedGqlOutputFolder)) {
-        (0, fs_1.rmSync)(generatedGqlOutputFolder, { recursive: true });
+    // Pointers handed to graphql-codegen must be workspace-relative posix paths: absolute Windows
+    // paths contain a drive-letter colon that @graphql-tools' GitLoader misparses as a git
+    // ref:path pointer, and the client preset turns the generates key into a `!`-exclusion too.
+    const libPath = (0, toPosixWorkspaceRelative_1.toPosixWorkspaceRelative)(nxLibPath);
+    // Filesystem operations stay on the caller-provided native path; only codegen pointers are
+    // workspace-relative, so cleanup keeps working when cwd is not the workspace root.
+    const generatedGqlOutputDir = (0, path_1.join)(nxLibPath, "src", "generated", "graphql-api");
+    if ((0, fs_1.existsSync)(generatedGqlOutputDir)) {
+        (0, fs_1.rmSync)(generatedGqlOutputDir, { recursive: true });
         // eslint-disable-next-line no-console
-        console.log(`Cleanup path: ${generatedGqlOutputFolder}`);
+        console.log(`Cleanup path: ${generatedGqlOutputDir}`);
     }
-    const documents = gqlFilePaths && gqlFilePaths.length > 0 ? gqlFilePaths : [(0, path_1.join)(nxLibPath, "src", "**", "*.graphql")];
+    // The trailing / makes the gql client-preset happy - also on Windows
+    const generatedGqlOutputFolder = `${libPath}/src/generated/graphql-api/`;
+    const documents = gqlFilePaths && gqlFilePaths.length > 0 ? gqlFilePaths : [`${libPath}/src/**/*.graphql`];
     if (!gqlFilePaths) {
-        documents.push((0, path_1.join)(`!${nxLibPath}`, "src", "**", "*-manager.graphql"));
+        documents.push(`!${libPath}/src/**/*-manager.graphql`);
     }
     const generates = {};
     generates[generatedGqlOutputFolder] = {

package/src/index.d.ts

@@ -16,3 +16,4 @@ export * from "./plugin-shared/customFieldUtil";
 export * from "./plugin-shared/extensionUtil";
 export * from "./plugin-shared/indexHtmlUtil";
 export * from "./spawnServersideExtensions";
+export * from "./toPosixWorkspaceRelative";

package/src/index.js

@@ -19,4 +19,5 @@ tslib_1.__exportStar(require("./plugin-shared/customFieldUtil"), exports);
 tslib_1.__exportStar(require("./plugin-shared/extensionUtil"), exports);
 tslib_1.__exportStar(require("./plugin-shared/indexHtmlUtil"), exports);
 tslib_1.__exportStar(require("./spawnServersideExtensions"), exports);
+tslib_1.__exportStar(require("./toPosixWorkspaceRelative"), exports);
 //# sourceMappingURL=index.js.map

package/src/toPosixWorkspaceRelative.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Converts a path to a workspace-relative posix path for use as a graphql-tools/codegen pointer.
+ *
+ * Pointers must not contain backslashes (globs require forward slashes) and must not contain a
+ * drive-letter colon: `@graphql-tools` GitLoader parses any pointer with a single `:` as a
+ * `ref:path` git pointer, so an absolute Windows path like `C:\workspace\libs\foo` makes it run
+ * `git ls-tree` against a garbage ref and document loading fails.
+ *
+ * Only use this for pointers passed to graphql-codegen/graphql-tools. Filesystem operations
+ * should keep using native `path.join` paths.
+ *
+ * @param targetPath The absolute or relative path to convert.
+ * @param workspaceRoot The workspace root the result should be relative to. Defaults to
+ * `process.cwd()`, which is the workspace root for nx executors and codegen runs.
+ * @returns {string} The path relative to the workspace root with forward slashes. Paths outside
+ * the workspace root (e.g. on a different Windows drive) are returned as absolute posix paths.
+ */
+export declare const toPosixWorkspaceRelative: (targetPath: string, workspaceRoot?: string) => string;

package/src/toPosixWorkspaceRelative.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPosixWorkspaceRelative = void 0;
+const consoleUtils_1 = require("./plugin-shared/consoleUtils");
+const toPosixSeparators = (value) => value.replace(/\\/g, "/");
+const normalizeDriveLetter = (value) => value.replace(/^[a-z]:/, match => match.toUpperCase());
+const hasDriveLetter = (value) => /^[A-Z]:/.test(value);
+/**
+ * Converts a path to a workspace-relative posix path for use as a graphql-tools/codegen pointer.
+ *
+ * Pointers must not contain backslashes (globs require forward slashes) and must not contain a
+ * drive-letter colon: `@graphql-tools` GitLoader parses any pointer with a single `:` as a
+ * `ref:path` git pointer, so an absolute Windows path like `C:\workspace\libs\foo` makes it run
+ * `git ls-tree` against a garbage ref and document loading fails.
+ *
+ * Only use this for pointers passed to graphql-codegen/graphql-tools. Filesystem operations
+ * should keep using native `path.join` paths.
+ *
+ * @param targetPath The absolute or relative path to convert.
+ * @param workspaceRoot The workspace root the result should be relative to. Defaults to
+ * `process.cwd()`, which is the workspace root for nx executors and codegen runs.
+ * @returns {string} The path relative to the workspace root with forward slashes. Paths outside
+ * the workspace root (e.g. on a different Windows drive) are returned as absolute posix paths.
+ */
+const toPosixWorkspaceRelative = (targetPath, workspaceRoot = process.cwd()) => {
+    const target = normalizeDriveLetter(toPosixSeparators(targetPath));
+    const root = normalizeDriveLetter(toPosixSeparators(workspaceRoot)).replace(/\/+$/, "");
+    // Windows paths are case-insensitive; posix paths are not
+    const compareCaseInsensitively = hasDriveLetter(target) && hasDriveLetter(root);
+    const comparableTarget = compareCaseInsensitively ? target.toLowerCase() : target;
+    const comparableRoot = compareCaseInsensitively ? root.toLowerCase() : root;
+    if (comparableTarget === comparableRoot) {
+        return ".";
+    }
+    if (comparableTarget.startsWith(`${comparableRoot}/`)) {
+        return target.slice(root.length + 1);
+    }
+    if (hasDriveLetter(target)) {
+        (0, consoleUtils_1.logWarning)(`Could not make ${targetPath} relative to ${workspaceRoot}; the resulting pointer keeps its drive-letter colon, which may break graphql document loading on Windows.`);
+    }
+    return target;
+};
+exports.toPosixWorkspaceRelative = toPosixWorkspaceRelative;
+//# sourceMappingURL=toPosixWorkspaceRelative.js.map