@trackunit/iris-app 2.3.9-alpha-90b6c9b97dd.0 → 2.3.9

package/CHANGELOG.md

@@ -1,3 +1,77 @@
+## 2.3.9 (2026-08-06)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 2.2.7
+- Updated iris-app-api to 2.2.7
+- Updated react-vite-test-setup to 0.0.93
+- Updated react-graphql-tools to 1.14.94
+- Updated shared-utils to 1.15.95
+
+## 2.3.8 (2026-08-06)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 2.2.6
+- Updated iris-app-api to 2.2.6
+- Updated react-vite-test-setup to 0.0.92
+- Updated react-graphql-tools to 1.14.93
+- Updated shared-utils to 1.15.94
+
+## 2.3.7 (2026-08-05)
+
+### 🩹 Fixes
+
+- use menuItem.image instead of deprecated icon in scaffolded extension templates [GLU-1568] ([#24599](https://github.com/Trackunit/manager/pull/24599))
+
+### ❤️ Thank You
+
+- Cursor @cursoragent
+- Mikkel Thorbjørn Andersen @mta-trackunit
+
+## 2.3.6 (2026-08-05)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 2.2.5
+- Updated iris-app-api to 2.2.5
+- Updated react-vite-test-setup to 0.0.91
+- Updated react-graphql-tools to 1.14.92
+- Updated shared-utils to 1.15.93
+
+## 2.3.5 (2026-08-04)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 2.2.4
+- Updated iris-app-api to 2.2.4
+- Updated react-vite-test-setup to 0.0.90
+- Updated react-graphql-tools to 1.14.91
+- Updated shared-utils to 1.15.92
+
+## 2.3.4 (2026-08-04)
+
+This was a version bump only for iris-app to align it with other projects, there were no code changes.
+
+## 2.3.3 (2026-08-04)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 2.2.3
+- Updated iris-app-api to 2.2.3
+- Updated react-vite-test-setup to 0.0.89
+- Updated react-graphql-tools to 1.14.90
+- Updated shared-utils to 1.15.91
+
+## 2.3.2 (2026-08-03)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 2.2.2
+- Updated iris-app-api to 2.2.2
+- Updated react-vite-test-setup to 0.0.88
+- Updated shared-utils to 1.15.90
+
 ## 2.3.1 (2026-08-03)
 
 ### 🧱 Updated Dependencies

package/README.md

@@ -11,6 +11,24 @@ For more info and a full guide on Iris App SDK Development, please visit our [De
 
 Run through the easy getting started guide here: [Getting Started](https://developers.trackunit.com/docs/getting-started)
 
+## Serverside GraphQL scaffolding
+
+Typed access to the Trackunit public GraphQL API is optional for serverside API extensions:
+
+```bash
+npx nx generate @trackunit/iris-app:extend \
+  --type=SERVERSIDE_API_EXTENSION \
+  --graphql
+```
+
+The option is off by default. It reuses the standard `graphql-hooks` target, configures React-free code generation against the public schema, and adds a named typed asset query example. Regenerate documents after editing `.graphql` files:
+
+```bash
+npx nx run <project>:graphql-hooks
+```
+
+Local requests must include a user bearer token. Set `SDK_ENVIRONMENT=DEV` or `STAGE` in the extension's `.env` to target a non-production public API; unset defaults to production.
+
 ## Testing Local Changes
 
 To test changes to the SDK generators locally, you can verify them in a full, temporary workspace environment.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/iris-app",
-  "version": "2.3.9-alpha-90b6c9b97dd.0",
+  "version": "2.3.9",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "src/index.js",
   "generators": "./generators.json",
@@ -23,8 +23,10 @@
     "@nx/react": "23.1.0",
     "@npmcli/arborist": "^9.1.9",
     "win-ca": "^3.5.1",
-    "@trackunit/shared-utils": "1.15.95-alpha-90b6c9b97dd.0",
-    "@trackunit/iris-app-api": "2.2.7-alpha-90b6c9b97dd.0",
+    "@trackunit/iris-app-build-utilities": "2.2.7",
+    "@trackunit/react-graphql-tools": "1.14.94",
+    "@trackunit/shared-utils": "1.15.95",
+    "@trackunit/iris-app-api": "2.2.7",
     "tslib": "^2.6.2",
     "@clack/prompts": "^1.0.0",
     "@npm/types": "^1.0.2",

package/src/executors/submit/executor.js

@@ -15,12 +15,81 @@ const irisAppServerSettings_1 = require("../utils/irisAppServerSettings");
 class NpmConflictError extends Error {
 }
 class NpmGeneralError extends Error {
+    constructor(message, statusCode, code, type) {
+        super(message);
+        this.statusCode = statusCode;
+        this.code = code;
+        this.type = type;
+    }
 }
 class ApproveError extends Error {
+    constructor(message, statusCode, code) {
+        super(message);
+        this.statusCode = statusCode;
+        this.code = code;
+    }
 }
 function sleep(time) {
     return new Promise(resolve => setTimeout(resolve, time));
 }
+// Errno-style codes that indicate the request never reached the registry at all
+// (DNS/connection/timeout failures at the transport layer), as opposed to local
+// validation errors (e.g. libnpmpublish's EPRIVATE/EBADSEMVER/EUSAGE) which carry
+// a code but are permanent and can never succeed on retry. Kept aligned with
+// make-fetch-happen's own RETRY_ERRORS list (used by the submit path) plus the
+// undici error codes doApproveApp's native fetch can raise.
+//
+// ENOTFOUND (DNS failure) is deliberately included even though make-fetch-happen
+// itself excludes it as "bad hostname, or offline" - a DNS blip during a VPN/
+// network transition is common enough in practice that failing fast here would
+// trade one wasted-wait problem for developers hitting spurious permanent
+// failures on flaky networks. This is a judgment call, not a clear-cut default.
+const RETRYABLE_TRANSPORT_CODES = new Set([
+    "ENOTFOUND",
+    "ECONNRESET",
+    "ECONNREFUSED",
+    "ETIMEDOUT",
+    "EAI_AGAIN",
+    "ERR_SOCKET_TIMEOUT",
+    "EADDRINUSE",
+    // from @npmcli/agent, surfaced through make-fetch-happen
+    "ECONNECTIONTIMEOUT",
+    "EIDLETIMEOUT",
+    "ERESPONSETIMEOUT",
+    "ETRANSFERTIMEOUT",
+    // doApproveApp uses Node's native fetch (undici), which raises its own
+    // codes distinct from the classic Node errno codes above.
+    "UND_ERR_CONNECT_TIMEOUT",
+    "UND_ERR_HEADERS_TIMEOUT",
+    "UND_ERR_BODY_TIMEOUT",
+    "UND_ERR_SOCKET", // e.g. "other side closed" on a reused keep-alive connection
+]);
+/**
+ * Decide whether a failed submit/approve attempt is worth retrying.
+ *
+ * This is an allowlist, not a denylist: only failures with a real chance of
+ * succeeding on a later attempt are retried - 5xx responses, 408/429 (timeout/
+ * rate-limited), a transport-level failure that never reached the registry at
+ * all (identified by a known transient errno code), or a minipass-fetch request
+ * timeout (which surfaces with the generic code FETCH_ERROR, distinguishable
+ * only via its `type: "request-timeout"`). Everything else - permanent 4xx
+ * errors, local validation errors with an unrelated code (e.g. EBADSEMVER), or
+ * any other unrecognized error shape - is treated as non-retryable by default.
+ *
+ * @param {number} [statusCode] The HTTP status code of the failed attempt, if any.
+ * @param {string} [code] The error's errno-style code, if any (no statusCode implies no HTTP response was received).
+ * @param {string} [type] The error's `type` field, if any. Only consulted when `code === "FETCH_ERROR"`, since that's the one code minipass-fetch's FetchError uses generically for several failure kinds - `type` is what distinguishes a timeout from the others.
+ * @returns {boolean} Whether the attempt should be retried.
+ */
+function isRetryableError(statusCode, code, type) {
+    if (statusCode !== undefined) {
+        return statusCode >= 500 || statusCode === 408 || statusCode === 429;
+    }
+    if (code === undefined) {
+        return false;
+    }
+    return RETRYABLE_TRANSPORT_CODES.has(code) || (code === "FETCH_ERROR" && type === "request-timeout");
+}
 /**
  * Submit the package to the npm registry.
  *
@@ -72,16 +141,24 @@ async function doUploadAppWithRetry(accessToken, manifest, tarData, settings, re
             console.error("❌ Unable to ship app package. Cannot submit over existing version.");
             return { success: false };
         }
+        if (!(e instanceof NpmGeneralError)) {
+            // An error shape we don't recognize (e.g. a bug elsewhere in this function) -
+            // log the full error/stack rather than a bare message so it stays debuggable.
+            console.error("❌ Unable to ship app package. Got error from Iris App SDK repository.", e);
+            return { success: false };
+        }
+        if (!isRetryableError(e.statusCode, e.code, e.type)) {
+            console.error("❌ Unable to ship app package.", e.message);
+            return { success: false };
+        }
+        if (retryCount > 1) {
+            console.error("⚠️ Unable to ship app package. Got error from Iris App SDK repository. Retrying submit...", e.message);
+            await sleep(30000);
+            return await doUploadAppWithRetry(accessToken, manifest, tarData, settings, retryCount - 1);
+        }
         else {
-            if (retryCount > 1) {
-                console.error("⚠️ Unable to ship app package. Got error from Iris App SDK repository. Retrying submit...", e);
-                await sleep(30000);
-                return await doUploadAppWithRetry(accessToken, manifest, tarData, settings, retryCount - 1);
-            }
-            else {
-                console.error("❌ Unable to ship app package. Got error from Iris App SDK repository.", e);
-                return { success: false };
-            }
+            console.error("❌ Unable to ship app package. Got error from Iris App SDK repository.", e.message);
+            return { success: false };
         }
     }
 }
@@ -102,6 +179,9 @@ async function doUploadApp(accessToken, manifest, tarData, settings) {
         else {
             return {
                 ok: false,
+                statusCode: err.statusCode,
+                code: err.code,
+                type: err.type,
                 headers: new Headers(err.headers),
                 statusText: `Error`,
                 text: () => Promise.resolve(`${err.name} ${err.message}`),
@@ -130,7 +210,7 @@ async function doUploadApp(accessToken, manifest, tarData, settings) {
             " " +
             (await submitResult.text()) +
             ". Trace ID: " +
-            submitResult.headers.get("trace-id"));
+            submitResult.headers.get("trace-id"), "statusCode" in submitResult ? submitResult.statusCode : undefined, "code" in submitResult ? submitResult.code : undefined, "type" in submitResult ? submitResult.type : undefined);
     }
 }
 async function promptUserForInput(query) {
@@ -150,19 +230,21 @@ async function doApproveAppWithRetry(token, manifest, settings, retryCount) {
         return await doApproveApp(token, manifest, settings);
     }
     catch (e) {
-        if (e instanceof ApproveError) {
-            if (retryCount > 1) {
-                console.error("⚠️ Unable to approve app package. Got approve error from Iris App SDK repository. Retrying approve...", e);
-                await sleep(30000);
-                return await doApproveAppWithRetry(token, manifest, settings, retryCount - 1);
-            }
-            else {
-                console.error("❌ Unable to approve app package. Got approve error from Iris App SDK repository.", e);
-                return { success: false };
-            }
+        if (!(e instanceof ApproveError)) {
+            console.error("❌ Unable to approve app package. Got error from Iris App SDK repository.", e);
+            return { success: false };
+        }
+        if (!isRetryableError(e.statusCode, e.code)) {
+            console.error("❌ Unable to approve app package.", e.message);
+            return { success: false };
+        }
+        if (retryCount > 1) {
+            console.error("⚠️ Unable to approve app package. Got approve error from Iris App SDK repository. Retrying approve...", e.message);
+            await sleep(30000);
+            return await doApproveAppWithRetry(token, manifest, settings, retryCount - 1);
         }
         else {
-            console.error("❌ Unable to approve app package. Got error from Iris App SDK repository.", e);
+            console.error("❌ Unable to approve app package. Got approve error from Iris App SDK repository.", e.message);
             return { success: false };
         }
     }
@@ -170,18 +252,29 @@ async function doApproveAppWithRetry(token, manifest, settings, retryCount) {
 async function doApproveApp(token, manifest, settings) {
     if (process.env.TU_APPROVE === "true") {
         console.log(`🖋️ Approving the app...`);
+        // A rejection here (e.g. DNS/connection/timeout failure) never produced an HTTP
+        // response, so it's re-thrown as an ApproveError with no statusCode - carrying
+        // the underlying cause's errno code (if any) so isRetryableError can recognize
+        // genuine transport failures, and the cause's message so the log doesn't just
+        // say "fetch failed" with no indication of what actually broke.
         const approveResult = await fetch(new URL(`${manifest.name}@${manifest.version}`, settings.approvalUrl), {
             method: "PUT",
             headers: {
                 Authorization: `Bearer ${token}`,
             },
+        }).catch((err) => {
+            const cause = err.cause instanceof Error ? err.cause : undefined;
+            const causeCode = cause && "code" in cause ? cause.code : undefined;
+            const code = typeof causeCode === "string" ? causeCode : undefined;
+            const reason = cause ? `${err.message}: ${cause.message}` : err.message;
+            throw new ApproveError(reason, undefined, code);
         });
         if (approveResult.ok) {
             console.log(`✅ Approved version ${manifest.version} of ${manifest.name}.`);
             return { success: true };
         }
         else {
-            throw new ApproveError(`${approveResult.statusText}, ${await approveResult.text()}, Trace ID: ${approveResult.headers.get("trace-id")}`);
+            throw new ApproveError(`${approveResult.statusText}, ${await approveResult.text()}, Trace ID: ${approveResult.headers.get("trace-id")}`, approveResult.status);
         }
     }
     else {

package/src/generators/create/generator.js

@@ -4,8 +4,8 @@ exports.IrisAppGenerator = void 0;
 const tslib_1 = require("tslib");
 const devkit_1 = require("@nx/devkit");
 const internal_1 = require("@nx/js/internal");
-const pacote = tslib_1.__importStar(require("pacote"));
 const path = tslib_1.__importStar(require("path"));
+const get_package_manifest_1 = require("../utils/get-package-manifest");
 function normalizeOptions(tree, options) {
     const name = (0, devkit_1.names)(options.name).fileName;
     const projectDirectory = options.directory ? path.join(options.directory, name) : name;
@@ -36,9 +36,6 @@ function addFiles(tree, options, packageJson) {
     };
     (0, devkit_1.generateFiles)(tree, path.join(__dirname, "files"), options.projectRoot, templateOptions);
 }
-const getManifest = (packageName) => {
-    return pacote.manifest(packageName, process.env.TU_NPM_REGISTRY ? { registry: process.env.TU_NPM_REGISTRY } : undefined);
-};
 /**
  * Iris App Generator.
  * This generator will create a new iris app, you can call this from your own generator.
@@ -49,24 +46,24 @@ const getManifest = (packageName) => {
  */
 const IrisAppGenerator = async function (tree, options) {
     const normalizedOptions = normalizeOptions(tree, options);
-    const packageJsonFromNpm = await getManifest("@trackunit/iris-app");
+    const packageJsonFromNpm = await (0, get_package_manifest_1.getPackageManifest)("@trackunit/iris-app");
     const packageJsonLocally = (0, devkit_1.readJsonFile)(path.join(__dirname, "..", "..", "..", "package.json"));
     if (options.updatePackageJson) {
         if (packageJsonFromNpm.version !== packageJsonLocally.version) {
             // eslint-disable-next-line no-console
             console.warn(`⚠️ This version of the iris-app package does not match the version of the iris-app package from NPM JS. Please update using: npm i @trackunit/iris-app@${packageJsonFromNpm.version}`);
         }
-        const reactComponentsPackageJsonFromNpm = getManifest("@trackunit/react-components");
-        const reactCoreContextsPackageJsonFromNpm = getManifest("@trackunit/react-core-contexts");
-        const cssCorePackageJsonFromNpm = getManifest("@trackunit/css-core");
+        const reactComponentsPackageJsonFromNpm = (0, get_package_manifest_1.getPackageManifest)("@trackunit/react-components");
+        const reactCoreContextsPackageJsonFromNpm = (0, get_package_manifest_1.getPackageManifest)("@trackunit/react-core-contexts");
+        const cssCorePackageJsonFromNpm = (0, get_package_manifest_1.getPackageManifest)("@trackunit/css-core");
         const tuDependencies = {
             "@trackunit/react-components": (await reactComponentsPackageJsonFromNpm).version,
             "@trackunit/react-core-contexts": (await reactCoreContextsPackageJsonFromNpm).version,
             "@trackunit/css-core": (await cssCorePackageJsonFromNpm).version,
         };
-        const irisAppSdkVitePackageJsonFromNpm = getManifest("@trackunit/iris-app-sdk-vite");
-        const reactCoreContextsTestPackageJsonFromNpm = getManifest("@trackunit/react-core-contexts-test");
-        const reactTestSetupPackageJsonFromNpm = getManifest("@trackunit/react-test-setup");
+        const irisAppSdkVitePackageJsonFromNpm = (0, get_package_manifest_1.getPackageManifest)("@trackunit/iris-app-sdk-vite");
+        const reactCoreContextsTestPackageJsonFromNpm = (0, get_package_manifest_1.getPackageManifest)("@trackunit/react-core-contexts-test");
+        const reactTestSetupPackageJsonFromNpm = (0, get_package_manifest_1.getPackageManifest)("@trackunit/react-test-setup");
         const tuDevDependencies = {
             "@trackunit/iris-app-sdk-vite": (await irisAppSdkVitePackageJsonFromNpm).version,
             "@trackunit/react-core-contexts-test": (await reactCoreContextsTestPackageJsonFromNpm).version,

package/src/generators/extend/files/FLEET_EXTENSION/extension-manifest.ts__template__

@@ -7,7 +7,7 @@ const fleetExtensionManifest: FleetExtensionManifest = {
 
     menuItem: {
         name: "<%= projectName %>",
-        icon: "QuestionMarkCircle"
+        image: { name: "QuestionMarkCircle" }
     }
 };
 

package/src/generators/extend/files/SERVERSIDE_API_EXTENSION_GRAPHQL/src/graphql/asset-by-id.graphql__template__

@@ -0,0 +1,6 @@
+query <%= className %>AssetById($id: ID!) {
+  asset(id: $id) {
+    id
+    name
+  }
+}

package/src/generators/extend/files/SERVERSIDE_API_EXTENSION_GRAPHQL/src/index.ts__template__

@@ -0,0 +1,31 @@
+import { createTrackunitGraphqlClient, getUserToken } from "@trackunit/serverside-utils";
+import { Hono } from "hono";
+import { <%= className %>AssetByIdDocument } from "./generated/graphql-api/graphql";
+
+const app = new Hono();
+
+app.get("/health", c => {
+  return c.json({
+    status: "ok",
+    timestamp: new Date().toISOString(),
+    service: "<%= projectName %>",
+  });
+});
+
+app.get("/assets/:id", async c => {
+  const token = getUserToken({ context: c });
+  if (!token) {
+    return c.json({ error: "Unauthorized" }, 401);
+  }
+
+  const client = createTrackunitGraphqlClient({ context: c });
+  const data = await client.request({
+    document: <%= className %>AssetByIdDocument,
+    variables: { id: c.req.param("id") },
+    signal: c.req.raw.signal,
+  });
+
+  return c.json(data);
+});
+
+export default app.fetch;

package/src/generators/extend/files/WIDGET_EXTENSION/extension-manifest.ts__template__

@@ -16,7 +16,7 @@ const widgetExtensionManifest: WidgetExtensionManifest = {
 
     header: {
         name: "<%= projectName %>",
-        icon: "QuestionMarkCircle"
+        image: { name: "QuestionMarkCircle" }
     },
 
     supportedFilters: {}, 

package/src/generators/extend/generator.d.ts

@@ -1,5 +1,15 @@
 import { Tree } from "@nx/devkit";
 import { IrisAppExtensionGeneratorSchema } from "./schema";
+type ServersideGraphqlOptions = {
+    readonly projectName: string;
+    readonly projectRoot: string;
+    readonly className: string;
+    readonly serversideUtilsVersion: string;
+};
+/**
+ * Adds public-schema codegen and a typed Hono example to a generated serverside extension.
+ */
+export declare const addServersideGraphql: (tree: Tree, options: ServersideGraphqlOptions) => Promise<void>;
 /**
  * Ensures that jest.preset.js exists and includes the required @trackunit/react-test-setup preset.
  * If the file doesn't exist, creates it. If it exists but doesn't include the preset, updates it.
@@ -13,3 +23,4 @@ export declare function ensureJestPresetConfiguration(tree: Tree, templateOption
  * @returns { Promise<void> } void
  */
 export declare const IrisAppExtensionGenerator: (tree: Tree, options: IrisAppExtensionGeneratorSchema) => Promise<() => void>;
+export {};

package/src/generators/extend/generator.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IrisAppExtensionGenerator = void 0;
+exports.IrisAppExtensionGenerator = exports.addServersideGraphql = void 0;
 exports.ensureJestPresetConfiguration = ensureJestPresetConfiguration;
 const tslib_1 = require("tslib");
 const devkit_1 = require("@nx/devkit");
@@ -9,12 +9,53 @@ const js_1 = require("@nx/js");
 const internal_1 = require("@nx/js/internal");
 const react_1 = require("@nx/react");
 const iris_app_api_1 = require("@trackunit/iris-app-api");
+const react_graphql_tools_1 = require("@trackunit/react-graphql-tools");
 const fs = tslib_1.__importStar(require("fs"));
 const path = tslib_1.__importStar(require("path"));
 const string_ts_1 = require("string-ts");
 const ts_morph_1 = require("ts-morph");
 const astUtils_1 = require("../../utils/ast/astUtils");
+const get_package_manifest_1 = require("../utils/get-package-manifest");
 const dependencies_1 = require("./dependencies");
+const addGraphqlDependency = (target) => {
+    if (!target) {
+        return;
+    }
+    const dependsOn = target.dependsOn ?? [];
+    if (!dependsOn.includes("graphql-hooks")) {
+        target.dependsOn = [...dependsOn, "graphql-hooks"];
+    }
+};
+/**
+ * Adds public-schema codegen and a typed Hono example to a generated serverside extension.
+ */
+const addServersideGraphql = async (tree, options) => {
+    await (0, react_graphql_tools_1.addGraphqlGenerator)(tree, {
+        project: options.projectName,
+        schemaSource: "public",
+        generateMocks: false,
+    });
+    (0, devkit_1.generateFiles)(tree, path.join(__dirname, "files", "SERVERSIDE_API_EXTENSION_GRAPHQL"), options.projectRoot, {
+        ...options,
+        template: "",
+    });
+    (0, devkit_1.updateJson)(tree, (0, devkit_1.joinPathFragments)(options.projectRoot, "project.json"), projectJson => {
+        addGraphqlDependency(projectJson.targets.build);
+        addGraphqlDependency(projectJson.targets.test);
+        addGraphqlDependency(projectJson.targets.serve);
+        addGraphqlDependency(projectJson.targets["tsc-validate"]);
+        return projectJson;
+    });
+    (0, devkit_1.updateJson)(tree, (0, devkit_1.joinPathFragments)(options.projectRoot, "package.json"), packageJson => {
+        packageJson.dependencies = {
+            ...packageJson.dependencies,
+            "@trackunit/serverside-utils": options.serversideUtilsVersion,
+        };
+        return packageJson;
+    });
+};
+exports.addServersideGraphql = addServersideGraphql;
+const getPackageVersion = async (packageName) => (await (0, get_package_manifest_1.getPackageManifest)(packageName)).version;
 function normalizeOptions(tree, options) {
     const name = (0, devkit_1.names)(options.name).fileName;
     const projectDirectory = options.directory ? `${(0, devkit_1.names)(options.directory).fileName}/${name}` : name;
@@ -86,6 +127,9 @@ const IrisAppExtensionGenerator = async function (tree, options) {
         template: "",
     };
     const irisAppExtensionType = normalizedOptions.type;
+    if (normalizedOptions.graphql && irisAppExtensionType !== "SERVERSIDE_API_EXTENSION") {
+        throw new Error("GraphQL setup is only supported for SERVERSIDE_API_EXTENSION");
+    }
     if (!tree.exists(`${(0, devkit_1.getWorkspaceLayout)(tree).appsDir}/${normalizedOptions.app}`)) {
         throw new Error(`The app does not exist: ${(0, devkit_1.getWorkspaceLayout)(tree).appsDir}/${normalizedOptions.app} make sure you enter the right app name`);
     }
@@ -193,6 +237,14 @@ const IrisAppExtensionGenerator = async function (tree, options) {
             return projectJson;
         });
     }
+    if (normalizedOptions.graphql) {
+        await (0, exports.addServersideGraphql)(tree, {
+            projectName: normalizedOptions.projectName,
+            projectRoot: normalizedOptions.projectRoot,
+            className: (0, devkit_1.names)(normalizedOptions.name).className,
+            serversideUtilsVersion: await getPackageVersion("@trackunit/serverside-utils"),
+        });
+    }
     //TODO: Change the following to update the manifest in the virtual Tree - not on the file system.
     const project = new ts_morph_1.Project({
         tsConfigFilePath: `${(0, devkit_1.getWorkspaceLayout)(tree).appsDir}/${normalizedOptions.app}/tsconfig.app.json`,

package/src/generators/extend/schema.d.ts

@@ -16,4 +16,5 @@ export interface IrisAppExtensionGeneratorSchema {
     | "LIFECYCLE_EXTENSION"
     | "SERVERSIDE_API_EXTENSION";
   extendJestPreset?: boolean;
+  graphql?: boolean;
 }

package/src/generators/extend/schema.json

@@ -64,6 +64,11 @@
       "type": "boolean",
       "description": "If the root jest.preset.js should be extended with the Iris app preset",
       "default": true
+    },
+    "graphql": {
+      "type": "boolean",
+      "description": "Add typed Trackunit public GraphQL support (SERVERSIDE_API_EXTENSION only)",
+      "default": false
     }
   },
   "required": ["name", "directory", "type"]

package/src/generators/utils/get-package-manifest.d.ts

@@ -0,0 +1,5 @@
+import * as pacote from "pacote";
+/**
+ * Keeps Trackunit registry overrides consistent across package-consuming generators.
+ */
+export declare const getPackageManifest: (packageName: string) => Promise<pacote.AbbreviatedManifest & pacote.ManifestResult>;

package/src/generators/utils/get-package-manifest.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPackageManifest = void 0;
+const tslib_1 = require("tslib");
+const pacote = tslib_1.__importStar(require("pacote"));
+/**
+ * Keeps Trackunit registry overrides consistent across package-consuming generators.
+ */
+const getPackageManifest = (packageName) => pacote.manifest(packageName, process.env.TU_NPM_REGISTRY ? { registry: process.env.TU_NPM_REGISTRY } : undefined);
+exports.getPackageManifest = getPackageManifest;
+//# sourceMappingURL=get-package-manifest.js.map