@trackunit/iris-app 2.3.2 → 2.3.3

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 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

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.2",
+  "version": "2.3.3",
   "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.90",
-    "@trackunit/iris-app-api": "2.2.2",
+    "@trackunit/iris-app-build-utilities": "2.2.3",
+    "@trackunit/react-graphql-tools": "1.14.90",
+    "@trackunit/shared-utils": "1.15.91",
+    "@trackunit/iris-app-api": "2.2.3",
     "tslib": "^2.6.2",
     "@clack/prompts": "^1.0.0",
     "@npm/types": "^1.0.2",

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/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/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