@trackunit/iris-app-api 2.3.10 → 2.4.0

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 2.4.0 (2026-08-14)
+
+### 🚀 Features
+
+- AI navigation support in Iris app SDK ([#24052](https://github.com/Trackunit/manager/pull/24052))
+
+### ❤️ Thank You
+
+- Aravind K Namboothiri @akn-trackunit
+
 ## 2.3.10 (2026-08-13)
 
 This was a version bump only for iris-app-api to align it with other projects, there were no code changes.

package/migrations/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../../../libs/iris-app-sdk/iris-app-api/migrations/entry.ts"],"names":[],"mappings":"","sourcesContent":["export {};\n"]}

package/migrations/v2-4-0/add-ai-navigation.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addAiNavigation = void 0;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const ts = tslib_1.__importStar(require("typescript"));
+const TANSTACK_MODULE = "@tanstack/react-router";
+const IRIS_APP_API = "@trackunit/iris-app-api";
+/**
+ * Extension types whose manifest can carry `aiNavigation`. Mirrors
+ * `aiNavigableExtensionTypes`, kept literal here so the migration keeps working
+ * against whatever version of the package a consumer is upgrading from.
+ */
+const aiNavigableExtensionTypes = [
+    "FLEET_EXTENSION",
+    "ADMIN_EXTENSION",
+    "IRIS_APP_SETTINGS_EXTENSION",
+    "ASSET_HOME_EXTENSION",
+    "SITE_HOME_EXTENSION",
+    "CUSTOMER_HOME_EXTENSION",
+    "ASSET_EVENTS_ACTIONS_EXTENSION",
+];
+const isUnderNodeModulesOrDist = (filePath) => filePath.includes("node_modules/") || filePath.includes("dist/") || filePath.includes("/.nx/");
+const parse = (filePath, content) => ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+const indentationOf = (content, position) => {
+    const lineStart = content.lastIndexOf("\n", position - 1) + 1;
+    return /^[ \t]*/.exec(content.slice(lineStart, position))?.[0] ?? "";
+};
+/**
+ * Inserts a named import into an existing import from `moduleSpecifier`, or adds
+ * a fresh import statement after the last import when there is none.
+ */
+const withImport = ({ content, sourceFile, moduleSpecifier, importName, typeOnly, }) => {
+    const imports = sourceFile.statements.filter(ts.isImportDeclaration);
+    const existing = imports.find(declaration => ts.isStringLiteral(declaration.moduleSpecifier) && declaration.moduleSpecifier.text === moduleSpecifier);
+    const namedBindings = existing?.importClause?.namedBindings;
+    if (existing !== undefined && namedBindings !== undefined && ts.isNamedImports(namedBindings)) {
+        if (namedBindings.elements.some(element => element.name.text === importName)) {
+            return content;
+        }
+        const insertAt = namedBindings.elements[namedBindings.elements.length - 1]?.getEnd();
+        if (insertAt === undefined) {
+            return content;
+        }
+        return `${content.slice(0, insertAt)}, ${importName}${content.slice(insertAt)}`;
+    }
+    const importStatement = typeOnly
+        ? `import type { ${importName} } from "${moduleSpecifier}";`
+        : `import { ${importName} } from "${moduleSpecifier}";`;
+    const lastImportEnd = imports[imports.length - 1]?.getEnd();
+    return lastImportEnd === undefined
+        ? `${importStatement}\n${content}`
+        : `${content.slice(0, lastImportEnd)}\n${importStatement}${content.slice(lastImportEnd)}`;
+};
+/**
+ * Adds `staticData.aiNavigation` to a router's TanStack module augmentation so
+ * routes can be annotated in a typed way.
+ */
+const annotateRouter = (content, filePath) => {
+    const sourceFile = parse(filePath, content);
+    const augmentation = sourceFile.statements.find((statement) => ts.isModuleDeclaration(statement) && ts.isStringLiteral(statement.name) && statement.name.text === TANSTACK_MODULE);
+    const body = augmentation?.body;
+    if (body === undefined || !ts.isModuleBlock(body)) {
+        return null;
+    }
+    const alreadyDeclared = body.statements.some(statement => ts.isInterfaceDeclaration(statement) && statement.name.text === "StaticDataRouteOption");
+    if (alreadyDeclared) {
+        return null;
+    }
+    const closingBrace = body.getEnd() - 1;
+    const indentation = indentationOf(content, body.statements[0]?.getStart() ?? closingBrace);
+    const declaration = [
+        `${indentation}interface StaticDataRouteOption {`,
+        `${indentation}  aiNavigation?: IrisAiNavigationRouteMetadata;`,
+        `${indentation}}`,
+        "",
+    ].join("\n");
+    const withDeclaration = `${content.slice(0, closingBrace)}\n${declaration}${content.slice(closingBrace)}`;
+    return withImport({
+        content: withDeclaration,
+        sourceFile: parse(filePath, withDeclaration),
+        moduleSpecifier: IRIS_APP_API,
+        importName: "IrisAiNavigationRouteMetadata",
+        typeOnly: true,
+    });
+};
+const manifestObject = (sourceFile) => {
+    for (const statement of sourceFile.statements) {
+        if (!ts.isVariableStatement(statement))
+            continue;
+        for (const declaration of statement.declarationList.declarations) {
+            const initializer = declaration.initializer;
+            if (initializer !== undefined && ts.isObjectLiteralExpression(initializer)) {
+                return initializer;
+            }
+        }
+    }
+    return undefined;
+};
+const propertyValue = (object, name) => {
+    const property = object.properties.find((candidate) => ts.isPropertyAssignment(candidate) && candidate.name.getText().replace(/["']/g, "") === name);
+    return property !== undefined && ts.isStringLiteral(property.initializer) ? property.initializer.text : undefined;
+};
+const hasProperty = (object, name) => object.properties.some(property => property.name?.getText().replace(/["']/g, "") === name);
+/**
+ * Points an extension manifest at its route tree so `aiNavigation` is derived at
+ * build time instead of hand-written.
+ */
+const annotateExtensionManifest = (content, filePath, tree) => {
+    const sourceFile = parse(filePath, content);
+    const manifest = manifestObject(sourceFile);
+    if (manifest === undefined || hasProperty(manifest, "aiNavigation")) {
+        return null;
+    }
+    const extensionType = propertyValue(manifest, "type");
+    if (extensionType === undefined || !aiNavigableExtensionTypes.some(candidate => candidate === extensionType)) {
+        return null;
+    }
+    // Only the split layout is safe to wire up automatically: importing a module
+    // that also calls `createRouter` would construct a router while the manifest
+    // is being read.
+    const projectRoot = filePath.slice(0, filePath.lastIndexOf("/"));
+    const routeTreePath = `${projectRoot}/src/routeTree.tsx`;
+    if (!tree.exists(routeTreePath) || !(tree.read(routeTreePath, "utf-8") ?? "").includes("export const routeTree")) {
+        return null;
+    }
+    const anchor = manifest.properties.find(property => property.name?.getText() === "sourceRoot") ?? manifest.properties[0];
+    if (anchor === undefined) {
+        return null;
+    }
+    const insertAt = anchor.getEnd() + (content.charAt(anchor.getEnd()) === "," ? 1 : 0);
+    const indentation = indentationOf(content, anchor.getStart());
+    const withProperty = `${content.slice(0, insertAt)}\n${indentation}aiNavigation: extractAiNavigationFromTanstackRouter(routeTree),${content.slice(insertAt)}`;
+    const withExtractor = withImport({
+        content: withProperty,
+        sourceFile: parse(filePath, withProperty),
+        moduleSpecifier: IRIS_APP_API,
+        importName: "extractAiNavigationFromTanstackRouter",
+        typeOnly: false,
+    });
+    return withImport({
+        content: withExtractor,
+        sourceFile: parse(filePath, withExtractor),
+        moduleSpecifier: "./src/routeTree",
+        importName: "routeTree",
+        typeOnly: false,
+    });
+};
+/**
+ * Makes existing Iris apps ready for AI navigation.
+ *
+ * Routers gain the `staticData.aiNavigation` augmentation, and the extension
+ * manifests of navigable extension types start deriving `aiNavigation` from
+ * their route tree. Annotating individual routes with a title and description is
+ * left to the app author; see the developer hub changelog.
+ *
+ * @param tree - Nx virtual file tree.
+ */
+const addAiNavigation = (tree) => {
+    let routers = 0;
+    let manifests = 0;
+    (0, devkit_1.visitNotIgnoredFiles)(tree, "/", filePath => {
+        if (isUnderNodeModulesOrDist(filePath))
+            return;
+        const isRouter = filePath.endsWith("/router.tsx") || filePath.endsWith("/router.ts");
+        const isExtensionManifest = filePath.endsWith("/extension-manifest.ts");
+        if (!isRouter && !isExtensionManifest)
+            return;
+        const content = tree.read(filePath, "utf-8");
+        if (content === null)
+            return;
+        if (isRouter) {
+            if (!content.includes(TANSTACK_MODULE))
+                return;
+            const annotatedRouter = annotateRouter(content, filePath);
+            if (annotatedRouter !== null && annotatedRouter !== content) {
+                tree.write(filePath, annotatedRouter);
+                routers += 1;
+            }
+            return;
+        }
+        const annotatedManifest = annotateExtensionManifest(content, filePath, tree);
+        if (annotatedManifest !== null && annotatedManifest !== content) {
+            tree.write(filePath, annotatedManifest);
+            manifests += 1;
+        }
+    });
+    if (routers === 0 && manifests === 0) {
+        return;
+    }
+    devkit_1.logger.info(`AI navigation: annotated ${routers} router(s) and ${manifests} extension manifest(s). ` +
+        "Add a title and description to the routes the assistant should offer: " +
+        "https://developer.trackunit.com/changelog/ai-navigation");
+};
+exports.addAiNavigation = addAiNavigation;
+exports.default = exports.addAiNavigation;
+//# sourceMappingURL=add-ai-navigation.js.map

package/migrations/v2-4-0/add-ai-navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-ai-navigation.js","sourceRoot":"","sources":["../../../../../../libs/iris-app-sdk/iris-app-api/migrations/v2-4-0/add-ai-navigation.ts"],"names":[],"mappings":"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","sourcesContent":["import { logger, type Tree, visitNotIgnoredFiles } from \"@nx/devkit\";\nimport * as ts from \"typescript\";\n\nconst TANSTACK_MODULE = \"@tanstack/react-router\";\nconst IRIS_APP_API = \"@trackunit/iris-app-api\";\n\n/**\n * Extension types whose manifest can carry `aiNavigation`. Mirrors\n * `aiNavigableExtensionTypes`, kept literal here so the migration keeps working\n * against whatever version of the package a consumer is upgrading from.\n */\nconst aiNavigableExtensionTypes = [\n  \"FLEET_EXTENSION\",\n  \"ADMIN_EXTENSION\",\n  \"IRIS_APP_SETTINGS_EXTENSION\",\n  \"ASSET_HOME_EXTENSION\",\n  \"SITE_HOME_EXTENSION\",\n  \"CUSTOMER_HOME_EXTENSION\",\n  \"ASSET_EVENTS_ACTIONS_EXTENSION\",\n] as const;\n\nconst isUnderNodeModulesOrDist = (filePath: string): boolean =>\n  filePath.includes(\"node_modules/\") || filePath.includes(\"dist/\") || filePath.includes(\"/.nx/\");\n\nconst parse = (filePath: string, content: string): ts.SourceFile =>\n  ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);\n\nconst indentationOf = (content: string, position: number): string => {\n  const lineStart = content.lastIndexOf(\"\\n\", position - 1) + 1;\n  return /^[ \\t]*/.exec(content.slice(lineStart, position))?.[0] ?? \"\";\n};\n\n/**\n * Inserts a named import into an existing import from `moduleSpecifier`, or adds\n * a fresh import statement after the last import when there is none.\n */\nconst withImport = ({\n  content,\n  sourceFile,\n  moduleSpecifier,\n  importName,\n  typeOnly,\n}: {\n  readonly content: string;\n  readonly sourceFile: ts.SourceFile;\n  readonly moduleSpecifier: string;\n  readonly importName: string;\n  readonly typeOnly: boolean;\n}): string => {\n  const imports = sourceFile.statements.filter(ts.isImportDeclaration);\n  const existing = imports.find(\n    declaration =>\n      ts.isStringLiteral(declaration.moduleSpecifier) && declaration.moduleSpecifier.text === moduleSpecifier\n  );\n\n  const namedBindings = existing?.importClause?.namedBindings;\n  if (existing !== undefined && namedBindings !== undefined && ts.isNamedImports(namedBindings)) {\n    if (namedBindings.elements.some(element => element.name.text === importName)) {\n      return content;\n    }\n    const insertAt = namedBindings.elements[namedBindings.elements.length - 1]?.getEnd();\n    if (insertAt === undefined) {\n      return content;\n    }\n    return `${content.slice(0, insertAt)}, ${importName}${content.slice(insertAt)}`;\n  }\n\n  const importStatement = typeOnly\n    ? `import type { ${importName} } from \"${moduleSpecifier}\";`\n    : `import { ${importName} } from \"${moduleSpecifier}\";`;\n  const lastImportEnd = imports[imports.length - 1]?.getEnd();\n\n  return lastImportEnd === undefined\n    ? `${importStatement}\\n${content}`\n    : `${content.slice(0, lastImportEnd)}\\n${importStatement}${content.slice(lastImportEnd)}`;\n};\n\n/**\n * Adds `staticData.aiNavigation` to a router's TanStack module augmentation so\n * routes can be annotated in a typed way.\n */\nconst annotateRouter = (content: string, filePath: string): string | null => {\n  const sourceFile = parse(filePath, content);\n\n  const augmentation = sourceFile.statements.find(\n    (statement): statement is ts.ModuleDeclaration =>\n      ts.isModuleDeclaration(statement) && ts.isStringLiteral(statement.name) && statement.name.text === TANSTACK_MODULE\n  );\n  const body = augmentation?.body;\n  if (body === undefined || !ts.isModuleBlock(body)) {\n    return null;\n  }\n\n  const alreadyDeclared = body.statements.some(\n    statement => ts.isInterfaceDeclaration(statement) && statement.name.text === \"StaticDataRouteOption\"\n  );\n  if (alreadyDeclared) {\n    return null;\n  }\n\n  const closingBrace = body.getEnd() - 1;\n  const indentation = indentationOf(content, body.statements[0]?.getStart() ?? closingBrace);\n  const declaration = [\n    `${indentation}interface StaticDataRouteOption {`,\n    `${indentation}  aiNavigation?: IrisAiNavigationRouteMetadata;`,\n    `${indentation}}`,\n    \"\",\n  ].join(\"\\n\");\n\n  const withDeclaration = `${content.slice(0, closingBrace)}\\n${declaration}${content.slice(closingBrace)}`;\n\n  return withImport({\n    content: withDeclaration,\n    sourceFile: parse(filePath, withDeclaration),\n    moduleSpecifier: IRIS_APP_API,\n    importName: \"IrisAiNavigationRouteMetadata\",\n    typeOnly: true,\n  });\n};\n\nconst manifestObject = (sourceFile: ts.SourceFile): ts.ObjectLiteralExpression | undefined => {\n  for (const statement of sourceFile.statements) {\n    if (!ts.isVariableStatement(statement)) continue;\n    for (const declaration of statement.declarationList.declarations) {\n      const initializer = declaration.initializer;\n      if (initializer !== undefined && ts.isObjectLiteralExpression(initializer)) {\n        return initializer;\n      }\n    }\n  }\n  return undefined;\n};\n\nconst propertyValue = (object: ts.ObjectLiteralExpression, name: string): string | undefined => {\n  const property = object.properties.find(\n    (candidate): candidate is ts.PropertyAssignment =>\n      ts.isPropertyAssignment(candidate) && candidate.name.getText().replace(/[\"']/g, \"\") === name\n  );\n  return property !== undefined && ts.isStringLiteral(property.initializer) ? property.initializer.text : undefined;\n};\n\nconst hasProperty = (object: ts.ObjectLiteralExpression, name: string): boolean =>\n  object.properties.some(property => property.name?.getText().replace(/[\"']/g, \"\") === name);\n\n/**\n * Points an extension manifest at its route tree so `aiNavigation` is derived at\n * build time instead of hand-written.\n */\nconst annotateExtensionManifest = (content: string, filePath: string, tree: Tree): string | null => {\n  const sourceFile = parse(filePath, content);\n  const manifest = manifestObject(sourceFile);\n  if (manifest === undefined || hasProperty(manifest, \"aiNavigation\")) {\n    return null;\n  }\n\n  const extensionType = propertyValue(manifest, \"type\");\n  if (extensionType === undefined || !aiNavigableExtensionTypes.some(candidate => candidate === extensionType)) {\n    return null;\n  }\n\n  // Only the split layout is safe to wire up automatically: importing a module\n  // that also calls `createRouter` would construct a router while the manifest\n  // is being read.\n  const projectRoot = filePath.slice(0, filePath.lastIndexOf(\"/\"));\n  const routeTreePath = `${projectRoot}/src/routeTree.tsx`;\n  if (!tree.exists(routeTreePath) || !(tree.read(routeTreePath, \"utf-8\") ?? \"\").includes(\"export const routeTree\")) {\n    return null;\n  }\n\n  const anchor = manifest.properties.find(property => property.name?.getText() === \"sourceRoot\") ?? manifest.properties[0];\n  if (anchor === undefined) {\n    return null;\n  }\n  const insertAt = anchor.getEnd() + (content.charAt(anchor.getEnd()) === \",\" ? 1 : 0);\n  const indentation = indentationOf(content, anchor.getStart());\n  const withProperty = `${content.slice(0, insertAt)}\\n${indentation}aiNavigation: extractAiNavigationFromTanstackRouter(routeTree),${content.slice(insertAt)}`;\n\n  const withExtractor = withImport({\n    content: withProperty,\n    sourceFile: parse(filePath, withProperty),\n    moduleSpecifier: IRIS_APP_API,\n    importName: \"extractAiNavigationFromTanstackRouter\",\n    typeOnly: false,\n  });\n\n  return withImport({\n    content: withExtractor,\n    sourceFile: parse(filePath, withExtractor),\n    moduleSpecifier: \"./src/routeTree\",\n    importName: \"routeTree\",\n    typeOnly: false,\n  });\n};\n\n/**\n * Makes existing Iris apps ready for AI navigation.\n *\n * Routers gain the `staticData.aiNavigation` augmentation, and the extension\n * manifests of navigable extension types start deriving `aiNavigation` from\n * their route tree. Annotating individual routes with a title and description is\n * left to the app author; see the developer hub changelog.\n *\n * @param tree - Nx virtual file tree.\n */\nexport const addAiNavigation = (tree: Tree): void => {\n  let routers = 0;\n  let manifests = 0;\n\n  visitNotIgnoredFiles(tree, \"/\", filePath => {\n    if (isUnderNodeModulesOrDist(filePath)) return;\n\n    const isRouter = filePath.endsWith(\"/router.tsx\") || filePath.endsWith(\"/router.ts\");\n    const isExtensionManifest = filePath.endsWith(\"/extension-manifest.ts\");\n    if (!isRouter && !isExtensionManifest) return;\n\n    const content = tree.read(filePath, \"utf-8\");\n    if (content === null) return;\n\n    if (isRouter) {\n      if (!content.includes(TANSTACK_MODULE)) return;\n      const annotatedRouter = annotateRouter(content, filePath);\n      if (annotatedRouter !== null && annotatedRouter !== content) {\n        tree.write(filePath, annotatedRouter);\n        routers += 1;\n      }\n      return;\n    }\n\n    const annotatedManifest = annotateExtensionManifest(content, filePath, tree);\n    if (annotatedManifest !== null && annotatedManifest !== content) {\n      tree.write(filePath, annotatedManifest);\n      manifests += 1;\n    }\n  });\n\n  if (routers === 0 && manifests === 0) {\n    return;\n  }\n\n  logger.info(\n    `AI navigation: annotated ${routers} router(s) and ${manifests} extension manifest(s). ` +\n      \"Add a title and description to the routes the assistant should offer: \" +\n      \"https://developer.trackunit.com/changelog/ai-navigation\"\n  );\n};\n\nexport default addAiNavigation;\n"]}

package/migrations.json

@@ -1,3 +1,9 @@
 {
-  "generators": {}
+  "generators": {
+    "v2-4-0-add-ai-navigation": {
+      "version": "2.4.0",
+      "description": "Make Iris apps ready for AI navigation: add the staticData.aiNavigation augmentation to TanStack routers, and derive aiNavigation from the route tree in navigable extension manifests.",
+      "implementation": "./migrations/v2-4-0/add-ai-navigation"
+    }
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/iris-app-api",
-  "version": "2.3.10",
+  "version": "2.4.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "repository": "https://github.com/Trackunit/manager",
   "engines": {

package/src/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./types/aiNavigableExtension";
 export * from "./types/defaultValidHosts";
 export * from "./types/extensions/adminExtensionManifest";
 export * from "./types/extensions/assetEventsActionsExtensionManifest";
@@ -10,8 +11,11 @@ export * from "./types/extensions/reportExtensionManifest";
 export * from "./types/extensions/serversideApiExtensionManifest";
 export * from "./types/extensions/siteHomeExtensionManifest";
 export * from "./types/extensions/widgetExtensionManifest";
+export * from "./types/extractAiNavigationFromTanstackRouter";
 export * from "./types/iconImage";
 export * from "./types/icons.generated";
+export * from "./types/irisAiNavigation";
+export * from "./types/irisAiNavigationValidation";
 export * from "./types/irisAppCspInput";
 export * from "./types/irisAppCustomFields";
 export * from "./types/irisAppExtensionManifest";

package/src/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./types/aiNavigableExtension"), exports);
 tslib_1.__exportStar(require("./types/defaultValidHosts"), exports);
 tslib_1.__exportStar(require("./types/extensions/adminExtensionManifest"), exports);
 tslib_1.__exportStar(require("./types/extensions/assetEventsActionsExtensionManifest"), exports);
@@ -13,8 +14,11 @@ tslib_1.__exportStar(require("./types/extensions/reportExtensionManifest"), expo
 tslib_1.__exportStar(require("./types/extensions/serversideApiExtensionManifest"), exports);
 tslib_1.__exportStar(require("./types/extensions/siteHomeExtensionManifest"), exports);
 tslib_1.__exportStar(require("./types/extensions/widgetExtensionManifest"), exports);
+tslib_1.__exportStar(require("./types/extractAiNavigationFromTanstackRouter"), exports);
 tslib_1.__exportStar(require("./types/iconImage"), exports);
 tslib_1.__exportStar(require("./types/icons.generated"), exports);
+tslib_1.__exportStar(require("./types/irisAiNavigation"), exports);
+tslib_1.__exportStar(require("./types/irisAiNavigationValidation"), exports);
 tslib_1.__exportStar(require("./types/irisAppCspInput"), exports);
 tslib_1.__exportStar(require("./types/irisAppCustomFields"), exports);
 tslib_1.__exportStar(require("./types/irisAppExtensionManifest"), exports);

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/iris-app-sdk/iris-app-api/src/index.ts"],"names":[],"mappings":";;;AAAA,uEAA6C;AAC7C,oEAA0C;AAC1C,oFAA0D;AAC1D,iGAAuE;AACvE,wFAA8D;AAC9D,2FAAiE;AACjE,oFAA0D;AAC1D,8FAAoE;AACpE,wFAA8D;AAC9D,qFAA2D;AAC3D,4FAAkE;AAClE,uFAA6D;AAC7D,qFAA2D;AAC3D,wFAA8D;AAC9D,4DAAkC;AAClC,kEAAwC;AACxC,mEAAyC;AACzC,6EAAmD;AACnD,kEAAwC;AACxC,sEAA4C;AAC5C,2EAAiD;AACjD,4EAAkD;AAClD,kEAAwC;AACxC,qEAA2C;AAC3C,wEAA8C;AAC9C,mEAAyC;AACzC,oEAA0C;AAC1C,yDAA+B;AAC/B,uEAA6C;AAC7C,uEAA6C","sourcesContent":["export * from \"./types/aiNavigableExtension\";\nexport * from \"./types/defaultValidHosts\";\nexport * from \"./types/extensions/adminExtensionManifest\";\nexport * from \"./types/extensions/assetEventsActionsExtensionManifest\";\nexport * from \"./types/extensions/assetHomeExtensionManifest\";\nexport * from \"./types/extensions/customerHomeExtensionManifest\";\nexport * from \"./types/extensions/fleetExtensionManifest\";\nexport * from \"./types/extensions/irisAppSettingsExtensionManifest\";\nexport * from \"./types/extensions/lifecycleExtensionManifest\";\nexport * from \"./types/extensions/reportExtensionManifest\";\nexport * from \"./types/extensions/serversideApiExtensionManifest\";\nexport * from \"./types/extensions/siteHomeExtensionManifest\";\nexport * from \"./types/extensions/widgetExtensionManifest\";\nexport * from \"./types/extractAiNavigationFromTanstackRouter\";\nexport * from \"./types/iconImage\";\nexport * from \"./types/icons.generated\";\nexport * from \"./types/irisAiNavigation\";\nexport * from \"./types/irisAiNavigationValidation\";\nexport * from \"./types/irisAppCspInput\";\nexport * from \"./types/irisAppCustomFields\";\nexport * from \"./types/irisAppExtensionManifest\";\nexport * from \"./types/irisAppInstallationConfig\";\nexport * from \"./types/irisAppManifest\";\nexport * from \"./types/irisAppMarketplace\";\nexport * from \"./types/loadNxRootPackageJson\";\nexport * from \"./types/modulefederation\";\nexport * from \"./types/permissionsPolicy\";\nexport * from \"./types/scopes\";\nexport * from \"./types/serversideInterfaces\";\nexport * from \"./types/subscriptionPackages\";\n"]}

package/src/types/aiNavigableExtension.d.ts

@@ -0,0 +1,35 @@
+import { IrisAppExtensionType } from "./irisAppExtensionManifest";
+import { IrisAppExtension } from "./irisAppManifest";
+/**
+ * The extension types whose manifest implements {@link AiNavigableExtensionManifest},
+ * derived from the manifest union so the type level stays the single source of
+ * truth for which extensions can advertise AI navigation.
+ */
+export type AiNavigableExtensionType<TExtension = IrisAppExtension> = TExtension extends {
+    type: IrisAppExtensionType;
+} ? "aiNavigation" extends keyof TExtension ? TExtension["type"] : never : never;
+export type AiNavigableExtension = Extract<IrisAppExtension, {
+    type: AiNavigableExtensionType;
+}>;
+/**
+ * The AI navigable extension type names, for error messages that list what is
+ * supported.
+ *
+ * @returns {ReadonlyArray<string>} The extension type names that support AI navigation.
+ */
+export declare const aiNavigableExtensionTypeNames: () => ReadonlyArray<string>;
+/**
+ * Whether an extension type supports AI navigation.
+ *
+ * @param type - The extension type to check.
+ * @returns {boolean} True when a manifest of this type may carry `aiNavigation`.
+ */
+export declare const isAiNavigableExtensionType: (type: IrisAppExtensionType) => type is AiNavigableExtensionType;
+/**
+ * Narrows an extension to the manifests that can carry `aiNavigation`, so
+ * callers can read the field without widening the manifest union.
+ *
+ * @param extension - The extension manifest to narrow.
+ * @returns {boolean} True when the extension supports AI navigation.
+ */
+export declare const isAiNavigableExtension: (extension: IrisAppExtension) => extension is AiNavigableExtension;

package/src/types/aiNavigableExtension.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAiNavigableExtension = exports.isAiNavigableExtensionType = exports.aiNavigableExtensionTypeNames = void 0;
+/**
+ * Runtime mirror of {@link AiNavigableExtensionType}, needed where the extension
+ * type is only known as data (a published manifest at the server choke point, or
+ * an installed app in the Manager host). Typing it as a total `Record` makes the
+ * compiler reject both a type that is not AI navigable and a navigable type that
+ * was forgotten here.
+ *
+ * Types without a per-extension URL (`REPORT_EXTENSION`, `WIDGET_EXTENSION`) and
+ * non-UI types are absent because they do not implement the manifest interface.
+ * Entity-scoped types require entity id(s) as navigation params at navigate time
+ * (see `getIrisHostParamNames` in the Manager AI panel).
+ */
+const aiNavigableExtensionTypes = {
+    FLEET_EXTENSION: true,
+    ADMIN_EXTENSION: true,
+    IRIS_APP_SETTINGS_EXTENSION: true,
+    ASSET_HOME_EXTENSION: true,
+    SITE_HOME_EXTENSION: true,
+    CUSTOMER_HOME_EXTENSION: true,
+    ASSET_EVENTS_ACTIONS_EXTENSION: true,
+};
+/**
+ * The AI navigable extension type names, for error messages that list what is
+ * supported.
+ *
+ * @returns {ReadonlyArray<string>} The extension type names that support AI navigation.
+ */
+const aiNavigableExtensionTypeNames = () => Object.keys(aiNavigableExtensionTypes);
+exports.aiNavigableExtensionTypeNames = aiNavigableExtensionTypeNames;
+/**
+ * Whether an extension type supports AI navigation.
+ *
+ * @param type - The extension type to check.
+ * @returns {boolean} True when a manifest of this type may carry `aiNavigation`.
+ */
+const isAiNavigableExtensionType = (type) => type in aiNavigableExtensionTypes;
+exports.isAiNavigableExtensionType = isAiNavigableExtensionType;
+/**
+ * Narrows an extension to the manifests that can carry `aiNavigation`, so
+ * callers can read the field without widening the manifest union.
+ *
+ * @param extension - The extension manifest to narrow.
+ * @returns {boolean} True when the extension supports AI navigation.
+ */
+const isAiNavigableExtension = (extension) => (0, exports.isAiNavigableExtensionType)(extension.type);
+exports.isAiNavigableExtension = isAiNavigableExtension;
+//# sourceMappingURL=aiNavigableExtension.js.map

package/src/types/aiNavigableExtension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiNavigableExtension.js","sourceRoot":"","sources":["../../../../../../libs/iris-app-sdk/iris-app-api/src/types/aiNavigableExtension.ts"],"names":[],"mappings":";;;AAmBA;;;;;;;;;;;GAWG;AACH,MAAM,yBAAyB,GAA2C;IACxE,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,IAAI;IACrB,2BAA2B,EAAE,IAAI;IACjC,oBAAoB,EAAE,IAAI;IAC1B,mBAAmB,EAAE,IAAI;IACzB,uBAAuB,EAAE,IAAI;IAC7B,8BAA8B,EAAE,IAAI;CACrC,CAAC;AAEF;;;;;GAKG;AACI,MAAM,6BAA6B,GAAG,GAA0B,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;AAApG,QAAA,6BAA6B,iCAAuE;AAEjH;;;;;GAKG;AACI,MAAM,0BAA0B,GAAG,CAAC,IAA0B,EAAoC,EAAE,CACzG,IAAI,IAAI,yBAAyB,CAAC;AADvB,QAAA,0BAA0B,8BACH;AAEpC;;;;;;GAMG;AACI,MAAM,sBAAsB,GAAG,CAAC,SAA2B,EAAqC,EAAE,CACvG,IAAA,kCAA0B,EAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AADhC,QAAA,sBAAsB,0BACU","sourcesContent":["import { AiNavigableExtensionManifest } from \"./irisAiNavigation\";\nimport { IrisAppExtensionType } from \"./irisAppExtensionManifest\";\nimport { IrisAppExtension } from \"./irisAppManifest\";\n\n/**\n * The extension types whose manifest implements {@link AiNavigableExtensionManifest},\n * derived from the manifest union so the type level stays the single source of\n * truth for which extensions can advertise AI navigation.\n */\nexport type AiNavigableExtensionType<TExtension = IrisAppExtension> = TExtension extends {\n  type: IrisAppExtensionType;\n}\n  ? \"aiNavigation\" extends keyof TExtension\n    ? TExtension[\"type\"]\n    : never\n  : never;\n\nexport type AiNavigableExtension = Extract<IrisAppExtension, { type: AiNavigableExtensionType }>;\n\n/**\n * Runtime mirror of {@link AiNavigableExtensionType}, needed where the extension\n * type is only known as data (a published manifest at the server choke point, or\n * an installed app in the Manager host). Typing it as a total `Record` makes the\n * compiler reject both a type that is not AI navigable and a navigable type that\n * was forgotten here.\n *\n * Types without a per-extension URL (`REPORT_EXTENSION`, `WIDGET_EXTENSION`) and\n * non-UI types are absent because they do not implement the manifest interface.\n * Entity-scoped types require entity id(s) as navigation params at navigate time\n * (see `getIrisHostParamNames` in the Manager AI panel).\n */\nconst aiNavigableExtensionTypes: Record<AiNavigableExtensionType, true> = {\n  FLEET_EXTENSION: true,\n  ADMIN_EXTENSION: true,\n  IRIS_APP_SETTINGS_EXTENSION: true,\n  ASSET_HOME_EXTENSION: true,\n  SITE_HOME_EXTENSION: true,\n  CUSTOMER_HOME_EXTENSION: true,\n  ASSET_EVENTS_ACTIONS_EXTENSION: true,\n};\n\n/**\n * The AI navigable extension type names, for error messages that list what is\n * supported.\n *\n * @returns {ReadonlyArray<string>} The extension type names that support AI navigation.\n */\nexport const aiNavigableExtensionTypeNames = (): ReadonlyArray<string> => Object.keys(aiNavigableExtensionTypes);\n\n/**\n * Whether an extension type supports AI navigation.\n *\n * @param type - The extension type to check.\n * @returns {boolean} True when a manifest of this type may carry `aiNavigation`.\n */\nexport const isAiNavigableExtensionType = (type: IrisAppExtensionType): type is AiNavigableExtensionType =>\n  type in aiNavigableExtensionTypes;\n\n/**\n * Narrows an extension to the manifests that can carry `aiNavigation`, so\n * callers can read the field without widening the manifest union.\n *\n * @param extension - The extension manifest to narrow.\n * @returns {boolean} True when the extension supports AI navigation.\n */\nexport const isAiNavigableExtension = (extension: IrisAppExtension): extension is AiNavigableExtension =>\n  isAiNavigableExtensionType(extension.type);\n"]}

package/src/types/cspDirectives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cspDirectives.js","sourceRoot":"","sources":["../../../../../../libs/iris-app-sdk/iris-app-api/src/types/cspDirectives.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,yFAAyF;AACzF,EAAE;;;AAEW,QAAA,uCAAuC,GAAG,yCAAyC,CAAC;AACpF,QAAA,eAAe,GAAG,iBAAiB,CAAC;AACpC,QAAA,WAAW,GAAG,aAAa,CAAC;AAC5B,QAAA,YAAY,GAAG,cAAc,CAAC;AAC9B,QAAA,sBAAsB,GAAG,wBAAwB,CAAC;AAClD,QAAA,kBAAkB,GAAG,oBAAoB,CAAC;AAC1C,QAAA,YAAY,GAAG,cAAc,CAAC;AAC9B,QAAA,8BAA8B,GAAG,gCAAgC,CAAC;AAClE,QAAA,kBAAkB,GAAG,oBAAoB,CAAC;AAC1C,QAAA,iBAAiB,GAAG,mBAAmB,CAAC;AACxC,QAAA,uCAAuC,GAAG,yCAAyC,CAAC;AACpF,QAAA,aAAa,GAAG,eAAe,CAAC;AAChC,QAAA,oBAAoB,GAAG,sBAAsB,CAAC;AAC9C,QAAA,uCAAuC,GAAG,yCAAyC,CAAC;AA0BpF,QAAA,IAAI,GAAG,QAAQ,CAAC;AAChB,QAAA,IAAI,GAAG,QAAQ,CAAC;AAChB,QAAA,cAAc,GAAG,kBAAkB,CAAC;AACpC,QAAA,aAAa,GAAG,iBAAiB,CAAC;AAClC,QAAA,WAAW,GAAG,eAAe,CAAC;AAC9B,QAAA,aAAa,GAAG,iBAAiB,CAAC;AAClC,QAAA,aAAa,GAAG,iBAAiB,CAAC;AAClC,QAAA,gBAAgB,GAAG,oBAAoB,CAAC;AAExC,QAAA,KAAK,GAAG,SAAS,CAAC;AAClB,QAAA,KAAK,GAAG,SAAS,CAAC","sourcesContent":["//\n// Based on types from https://www.npmjs.com/package/csp-header but adjusted to our needs\n//\n\nexport const ALLOW_DOWNLOADS_WITHOUT_USER_ACTIVATION = \"allow-downloads-without-user-activation\";\nexport const ALLOW_DOWNLOADS = \"allow-downloads\";\nexport const ALLOW_FORMS = \"allow-forms\";\nexport const ALLOW_MODALS = \"allow-modals\";\nexport const ALLOW_ORIENTATION_LOCK = \"allow-orientation-lock\";\nexport const ALLOW_POINTER_LOCK = \"allow-pointer-lock\";\nexport const ALLOW_POPUPS = \"allow-popups\";\nexport const ALLOW_POPUPS_TO_ESCAPE_SANDBOX = \"allow-popups-to-escape-sandbox\";\nexport const ALLOW_PRESENTATION = \"allow-presentation\";\nexport const ALLOW_SAME_ORIGIN = \"allow-same-origin\";\nexport const ALLOW_STORAGE_ACCESS_BY_USER_ACTIVATION = \"allow-storage-access-by-user-activation\";\nexport const ALLOW_SCRIPTS = \"allow-scripts\";\nexport const ALLOW_TOP_NAVIGATION = \"allow-top-navigation\";\nexport const ALLOW_TOP_NAVIGATION_BY_USER_ACTIVATION = \"allow-top-navigation-by-user-activation\";\n\ntype TSource = string;\ntype TNonce = `nonce-${string}`;\ntype THash = `sha${\"256\" | \"384\" | \"512\"}-${string}`;\ntype TAttrDirective = THash | typeof NONE | typeof UNSAFE_INLINE | typeof UNSAFE_HASHES;\ntype TFetchDirective =\n  | TSource\n  | TNonce\n  | THash\n  | typeof NONE\n  | typeof SELF\n  | typeof UNSAFE_EVAL\n  | typeof UNSAFE_HASHES\n  | typeof UNSAFE_INLINE;\ntype TNavigationDirective =\n  | TSource\n  | TNonce\n  | THash\n  | typeof NONE\n  | typeof SELF\n  | typeof UNSAFE_EVAL\n  | typeof UNSAFE_HASHES\n  | typeof UNSAFE_INLINE\n  | typeof STRICT_DYNAMIC;\n\nexport const NONE = \"'none'\";\nexport const SELF = \"'self'\";\nexport const STRICT_DYNAMIC = \"'strict-dynamic'\";\nexport const REPORT_SAMPLE = \"'report-sample'\";\nexport const UNSAFE_EVAL = \"'unsafe-eval'\";\nexport const UNSAFE_HASHES = \"'unsafe-hashes'\";\nexport const UNSAFE_INLINE = \"'unsafe-inline'\";\nexport const WASM_UNSAFE_EVAL = \"'wasm-unsafe-eval'\";\n\nexport const ALLOW = \"'allow'\";\nexport const BLOCK = \"'block'\";\n\nexport type TWebRTCDirective = typeof ALLOW | typeof BLOCK;\n\nexport type CSPDirectives = {\n  \"child-src\": Array<TFetchDirective>;\n  \"connect-src\": Array<TFetchDirective>;\n  \"font-src\": Array<TFetchDirective>;\n  \"form-action\": Array<TNavigationDirective>;\n  \"frame-src\": Array<TFetchDirective>;\n  \"img-src\": Array<TFetchDirective | typeof STRICT_DYNAMIC>;\n  \"media-src\": Array<TFetchDirective>;\n  sandbox: Array<\n    | typeof ALLOW_DOWNLOADS\n    | typeof ALLOW_DOWNLOADS_WITHOUT_USER_ACTIVATION\n    | typeof ALLOW_FORMS\n    | typeof ALLOW_MODALS\n    | typeof ALLOW_ORIENTATION_LOCK\n    | typeof ALLOW_POINTER_LOCK\n    | typeof ALLOW_POPUPS\n    | typeof ALLOW_POPUPS_TO_ESCAPE_SANDBOX\n    | typeof ALLOW_PRESENTATION\n    | typeof ALLOW_SAME_ORIGIN\n    | typeof ALLOW_SCRIPTS\n    | typeof ALLOW_STORAGE_ACCESS_BY_USER_ACTIVATION\n    | typeof ALLOW_TOP_NAVIGATION\n    | typeof ALLOW_TOP_NAVIGATION_BY_USER_ACTIVATION\n  >;\n  \"script-src\": Array<TFetchDirective | typeof STRICT_DYNAMIC | typeof REPORT_SAMPLE | typeof WASM_UNSAFE_EVAL>;\n  \"script-src-attr\": Array<TAttrDirective | typeof REPORT_SAMPLE>;\n  \"script-src-elem\": Array<TFetchDirective | typeof STRICT_DYNAMIC | typeof REPORT_SAMPLE>;\n  \"style-src\": Array<TFetchDirective> | typeof REPORT_SAMPLE;\n  \"style-src-attr\": Array<TAttrDirective | typeof REPORT_SAMPLE>;\n  \"style-src-elem\": Array<TFetchDirective | typeof REPORT_SAMPLE>;\n  \"upgrade-insecure-requests\": boolean;\n  \"worker-src\": Array<TFetchDirective>;\n   webrtc: TWebRTCDirective;\n};\n"]}

package/src/types/defaultValidHosts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultValidHosts.js","sourceRoot":"","sources":["../../../../../../libs/iris-app-sdk/iris-app-api/src/types/defaultValidHosts.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AAE9C;;;;;;GAMG;AACI,MAAM,iBAAiB,GAAG,GAAG,EAAE;IACpC,2EAA2E;IAC3E,OAAO;QACL,mCAAmC;QACnC,qCAAqC;QACrC,mCAAmC;QACnC,wBAAwB;QACxB,wBAAwB;QACxB,wBAAwB;QACxB,8BAA8B;QAC9B,OAAO;QACP,gCAAgC;QAChC,OAAO;QACP,QAAQ;QACR,mCAAmC;QACnC,iCAAiC,EAAE,mCAAmC;QACtE,QAAQ;QACR,gCAAgC;QAChC,QAAQ;QACR,uBAAuB;QACvB,0BAA0B;QAC1B,qBAAqB;QACrB,WAAW;QACX,yBAAyB;QACzB,WAAW;QACX,yBAAyB;QACzB,yBAAyB;KAC1B,CAAC;AACJ,CAAC,CAAC;AA5BW,QAAA,iBAAiB,qBA4B5B;AAEF;;;;GAIG;AACI,MAAM,gBAAgB,GAAG,GAAG,EAAE;IACnC,OAAO;QACL,aAAa,EAAE,IAAA,yBAAiB,GAAE;QAClC,YAAY,EAAE,CAAC,GAAG,IAAA,yBAAiB,GAAE,EAAE,2BAAW,CAAC;QACnD,SAAS,EAAE,IAAA,yBAAiB,GAAE;QAC9B,YAAY,EAAE,IAAA,yBAAiB,GAAE;QACjC,aAAa,EAAE,IAAA,yBAAiB,GAAE;KACnC,CAAC;AACJ,CAAC,CAAC;AARW,QAAA,gBAAgB,oBAQ3B","sourcesContent":["import { UNSAFE_EVAL } from \"./cspDirectives\";\n\n/**\n * Returns default valid hosts for CSP for manager.\n *\n * ! Internal use only !\n *\n * @returns {string[]} - Array of valid hosts for CSP\n */\nexport const defaultValidHosts = () => {\n  // TRY TO KEEP IN SYNC WITH CHANGES IN server.js from manager (CSP headers)\n  return [\n    \"https://dev.manager.trackunit.com\",\n    \"https://stage.manager.trackunit.com\",\n    \"https://new.manager.trackunit.com\",\n    \"http://localhost:5005/\",\n    \"http://localhost:5010/\",\n    \"http://localhost:5011/\",\n    //Allow inline data like icons\n    \"data:\",\n    //Allow vector based google maps\n    \"blob:\",\n    //IMAGES\n    \"https://images.iris.trackunit.com\",\n    \"https://*.awsapi.trackunit.com/\", // loading images from machines api\n    //SENTRY\n    \"https://browser.sentry-cdn.com\",\n    //GOOGLE\n    \"https://*.gstatic.com\",\n    \"https://*.googleapis.com\",\n    \"https://*.ggpht.com\",\n    //AMPLITUDE\n    \"https://*.amplitude.com\",\n    //SPECCHECK\n    \"https://*.speccheck.com\",\n    \"https://api.hsforms.com\",\n  ];\n};\n\n/**\n * Returns default CSP config\n *\n * ! Internal use only !\n */\nexport const defaultCspConfig = () => {\n  return {\n    \"default-src\": defaultValidHosts(),\n    \"script-src\": [...defaultValidHosts(), UNSAFE_EVAL],\n    \"img-src\": defaultValidHosts(),\n    \"worker-src\": defaultValidHosts(),\n    \"connect-src\": defaultValidHosts(),\n  };\n};\n"]}

package/src/types/extensions/adminExtensionManifest.d.ts

@@ -1,6 +1,7 @@
+import { AiNavigableExtensionManifest } from "../irisAiNavigation";
 import { AbstractExtensionManifest, TranslationKey, Translations } from "../irisAppExtensionManifest";
 import { AccountScope } from "../scopes";
-export interface AdminExtensionManifest extends AbstractExtensionManifest {
+export interface AdminExtensionManifest extends AbstractExtensionManifest, AiNavigableExtensionManifest {
     type: "ADMIN_EXTENSION";
     /**
      * Conditions for the admin extension to be shown.

package/src/types/extensions/adminExtensionManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adminExtensionManifest.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/iris-app-api/src/types/extensions/adminExtensionManifest.ts"],"names":[],"mappings":"","sourcesContent":["import { AiNavigableExtensionManifest } from \"../irisAiNavigation\";\nimport { AbstractExtensionManifest, TranslationKey, Translations } from \"../irisAppExtensionManifest\";\nimport { AccountScope } from \"../scopes\";\n\nexport interface AdminExtensionManifest extends AbstractExtensionManifest, AiNavigableExtensionManifest {\n  type: \"ADMIN_EXTENSION\";\n\n  /**\n   * Conditions for the admin extension to be shown.\n   *\n   * Its doing OR between the conditions of the same type:\n   * - If only 1 scopes is used/filled out then the admin home extension will be shown if user has the required scope.\n   * - If more scopes are used/filled out then the admin home extension will be shown for all assets that the user has one of the required scopes for.\n   */\n  conditions?: {\n    scopes?: AccountScope | Array<AccountScope>;\n  };\n\n  menuItem: {\n    name: string | Translations | TranslationKey;\n  };\n}\n"]}

package/src/types/extensions/assetEventsActionsExtensionManifest.d.ts

@@ -1,7 +1,8 @@
+import { AiNavigableExtensionManifest } from "../irisAiNavigation";
 import { AbstractExtensionManifest, RequiredCustomField, TranslationKey, Translations } from "../irisAppExtensionManifest";
 import { AccountScope } from "../scopes";
 export type EVENT_TYPE = "ALERT" | "CAN_ERROR" | "DAMAGE_REPORT" | "FLUCTUATING_CAN_ERROR" | "MACHINE_FAULT" | "SERVICE";
-export interface AssetEventsActionsExtensionManifest extends AbstractExtensionManifest {
+export interface AssetEventsActionsExtensionManifest extends AbstractExtensionManifest, AiNavigableExtensionManifest {
     type: "ASSET_EVENTS_ACTIONS_EXTENSION";
     /**
      * Conditions for the asset events actions extension to be shown.

package/src/types/extensions/assetEventsActionsExtensionManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetEventsActionsExtensionManifest.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/iris-app-api/src/types/extensions/assetEventsActionsExtensionManifest.ts"],"names":[],"mappings":"","sourcesContent":["import { AiNavigableExtensionManifest } from \"../irisAiNavigation\";\nimport {\n  AbstractExtensionManifest,\n  RequiredCustomField,\n  TranslationKey,\n  Translations,\n} from \"../irisAppExtensionManifest\";\nimport { AccountScope } from \"../scopes\";\n\nexport type EVENT_TYPE =\n  | \"ALERT\"\n  | \"CAN_ERROR\"\n  | \"DAMAGE_REPORT\"\n  | \"FLUCTUATING_CAN_ERROR\"\n  | \"MACHINE_FAULT\"\n  | \"SERVICE\";\n\nexport interface AssetEventsActionsExtensionManifest extends AbstractExtensionManifest, AiNavigableExtensionManifest {\n  type: \"ASSET_EVENTS_ACTIONS_EXTENSION\";\n  /**\n   * Conditions for the asset events actions extension to be shown.\n   * Its doing AND between the conditions types and OR between the conditions of the same type:\n   * - If only failureModeIdentifier or suspectParameterNumber or eventType or SourceAddress is used/filled out then the event needs to match the filled out property.\n   * - If more failureModeIdentifier, suspectParameterNumber, SourceAddress, and eventType is used/filled out then asset events actions extension will be shown for all events that matches all FMI, SPN, and eventType.\n   * - If only scopes is used/filled out then the asset events actions extension will be shown for all assets that the user has the required scopes for.\n   * - If more scopes are used/filled out then the asset events actions extension will be shown for all assets that the user has one of the required scopes for.\n   * - If no conditions are used/filled out then the asset events actions extension will be shown for all assets and events.\n   */\n  conditions?: {\n    eventType?: EVENT_TYPE | Array<EVENT_TYPE>;\n    sourceAddress?: number | Array<number>;\n    failureModeIdentifier?: number | Array<number>;\n    suspectParameterNumber?: number | Array<number>;\n    scopes?: AccountScope | Array<AccountScope>;\n\n    /**\n     * Only entityType ASSET custom fields are supported here\n     */\n    requiredCustomField?: RequiredCustomField | Array<RequiredCustomField>;\n  };\n  menuItem: {\n    name: string | Translations | TranslationKey;\n  };\n}\n"]}

package/src/types/extensions/assetHomeExtensionManifest.d.ts

@@ -1,6 +1,7 @@
+import { AiNavigableExtensionManifest } from "../irisAiNavigation";
 import { AbstractExtensionManifest, RegExpType, RequiredCustomField, TranslationKey, Translations } from "../irisAppExtensionManifest";
 import { AccountScope } from "../scopes";
-export interface AssetHomeExtensionManifest extends AbstractExtensionManifest {
+export interface AssetHomeExtensionManifest extends AbstractExtensionManifest, AiNavigableExtensionManifest {
     type: "ASSET_HOME_EXTENSION";
     /**
      * Conditions for the asset home extension to be shown.

package/src/types/extensions/assetHomeExtensionManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetHomeExtensionManifest.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/iris-app-api/src/types/extensions/assetHomeExtensionManifest.ts"],"names":[],"mappings":"","sourcesContent":["import { AiNavigableExtensionManifest } from \"../irisAiNavigation\";\nimport {\n  AbstractExtensionManifest,\n  RegExpType,\n  RequiredCustomField,\n  TranslationKey,\n  Translations,\n} from \"../irisAppExtensionManifest\";\nimport { AccountScope } from \"../scopes\";\n\nexport interface AssetHomeExtensionManifest extends AbstractExtensionManifest, AiNavigableExtensionManifest {\n  type: \"ASSET_HOME_EXTENSION\";\n  /**\n   * Conditions for the asset home extension to be shown.\n   * model, brand, and telematicsDeviceType are case insensitive so does not matter how you write them.\n   *  brand: \"trackunit\" and brand: \"Trackunit\" will be the same.\n   *\n   * Its doing AND between the conditions types and OR between the conditions of the same type:\n   * - If both model and brand are used/filled out then asset needs to match both model and brand.\n   * - If only brand, model, or telematicsDeviceType is used/filled out then the asset needs to match the filled out property.\n   * - If only scopes is used/filled out then the asset home extension will be shown for all assets that the user has the required scopes for.\n   * - If more scopes are used/filled out then the asset home extension will be shown for all assets that the user has one of the required scopes for.\n   * - If no conditions are used/filled out then the asset home extension will be shown for all assets.\n   */\n  conditions?: {\n    model?: Array<string | RegExpType> | string | RegExpType;\n    brand?: Array<string | RegExpType> | string | RegExpType;\n    telematicsDeviceType?: Array<string | RegExpType> | string | RegExpType;\n    scopes?: AccountScope | Array<AccountScope>;\n\n    /**\n     * Only entityType ASSET custom fields are supported here\n     */\n    requiredCustomField?: RequiredCustomField | Array<RequiredCustomField>;\n  };\n  menuItem: {\n    name: string | Translations | TranslationKey;\n  };\n}\n"]}

package/src/types/extensions/customerHomeExtensionManifest.d.ts

@@ -1,6 +1,7 @@
+import { AiNavigableExtensionManifest } from "../irisAiNavigation";
 import { AbstractExtensionManifest, TranslationKey, Translations } from "../irisAppExtensionManifest";
 import { AccountScope } from "../scopes";
-export interface CustomerHomeExtensionManifest extends AbstractExtensionManifest {
+export interface CustomerHomeExtensionManifest extends AbstractExtensionManifest, AiNavigableExtensionManifest {
     type: "CUSTOMER_HOME_EXTENSION";
     /**
      * Conditions for the customer home extension to be shown.

package/src/types/extensions/customerHomeExtensionManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customerHomeExtensionManifest.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/iris-app-api/src/types/extensions/customerHomeExtensionManifest.ts"],"names":[],"mappings":"","sourcesContent":["import { AiNavigableExtensionManifest } from \"../irisAiNavigation\";\nimport { AbstractExtensionManifest, TranslationKey, Translations } from \"../irisAppExtensionManifest\";\nimport { AccountScope } from \"../scopes\";\n\nexport interface CustomerHomeExtensionManifest extends AbstractExtensionManifest, AiNavigableExtensionManifest {\n  type: \"CUSTOMER_HOME_EXTENSION\";\n\n  /**\n   * Conditions for the customer home extension to be shown.\n   *\n   * Its doing AND between the conditions types and OR between the conditions of the same type:\n   * - If only scopes is used/filled out then the extension will be shown for all customers that the user has the required permission for.\n   * - If more scopes are used/filled out then the extension will be shown for all customers that the user has one of the required permission for.\n   * - If showFor is used then the extension will be shown for all customers that match the showFor condition.\n   * - If both scopes and showFor are used then the extension will be shown for all customers that match the showFor condition and the user has the required permission for.\n   */\n  conditions?: {\n    scopes?: AccountScope | Array<AccountScope>;\n    /**\n     * - If showFor is \"ALL\" then the extension will be shown for all customers in customer home.\n     * - If showFor is \"BUSINESS_UNITS\" then the extension will be shown for all business units in customer home.\n     * - If showFor is \"CUSTOMERS\" then the extension will be shown for all customers that are not business units in customer home.\n     */\n    showFor?: \"ALL\" | \"BUSINESS_UNITS\" | \"CUSTOMERS\";\n  };\n\n  menuItem: {\n    name: string | Translations | TranslationKey;\n  };\n}\n"]}

package/src/types/extensions/fleetExtensionManifest.d.ts

@@ -1,7 +1,8 @@
 import { IconByName, IconByPath } from "../iconImage";
+import { AiNavigableExtensionManifest } from "../irisAiNavigation";
 import { AbstractExtensionManifest, RegExpType, TranslationKey, Translations } from "../irisAppExtensionManifest";
 import { AccountScope } from "../scopes";
-export interface FleetExtensionManifest extends AbstractExtensionManifest {
+export interface FleetExtensionManifest extends AbstractExtensionManifest, AiNavigableExtensionManifest {
     type: "FLEET_EXTENSION";
     /**
      * Conditions for the fleet extension to be shown.

package/src/types/extensions/fleetExtensionManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleetExtensionManifest.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/iris-app-api/src/types/extensions/fleetExtensionManifest.ts"],"names":[],"mappings":"","sourcesContent":["import { IconByName, IconByPath } from \"../iconImage\";\nimport { AiNavigableExtensionManifest } from \"../irisAiNavigation\";\nimport { AbstractExtensionManifest, RegExpType, TranslationKey, Translations } from \"../irisAppExtensionManifest\";\nimport { AccountScope } from \"../scopes\";\n\nexport interface FleetExtensionManifest extends AbstractExtensionManifest, AiNavigableExtensionManifest {\n  type: \"FLEET_EXTENSION\";\n\n  /**\n   * Conditions for the fleet extension to be shown.\n   * It is case insensitive so does not matter how you write the brand.\n   *  brand: \"trackunit\" and brand: \"Trackunit\" will be the same.\n   *\n   * Its doing AND between the conditions types and OR between the conditions of the same type:\n   * - If both model and brand are used/filled out then asset needs to match both model and brand.\n   * - If only brand or model is used/filled out then the asset needs to match the filled out property.\n   * - If only scopes is used/filled out then the fleet extension will be shown if the user has the required scope.\n   * - If more scopes are used/filled out then the fleet extension will be shown if the user has one of the required scopes.\n   * - If no conditions are used/filled out then the asset home extension will be shown for all assets.\n   */\n  conditions?: {\n    model?: Array<string | RegExpType> | string | RegExpType;\n    brand?: Array<string | RegExpType> | string | RegExpType;\n    scopes?: AccountScope | Array<AccountScope>;\n  };\n\n  menuItem: {\n    /**\n     * The name used in the menu item.\n     */\n    name: string | Translations | TranslationKey;\n    /**\n     * The icon used in the menu item.\n     *\n     * @deprecated please use image instead.\n     */\n    icon?: string;\n    image?: IconByName | IconByPath;\n\n    /**\n     * Description of the menu item, used in the 'Applications' menu.\n     */\n    description?: string | Translations | TranslationKey;\n  };\n}\n"]}

package/src/types/extensions/irisAppSettingsExtensionManifest.d.ts

@@ -1,4 +1,5 @@
+import { AiNavigableExtensionManifest } from "../irisAiNavigation";
 import { AbstractExtensionManifest } from "../irisAppExtensionManifest";
-export interface IrisAppSettingsExtensionManifest extends AbstractExtensionManifest {
+export interface IrisAppSettingsExtensionManifest extends AbstractExtensionManifest, AiNavigableExtensionManifest {
     type: "IRIS_APP_SETTINGS_EXTENSION";
 }

package/src/types/extensions/irisAppSettingsExtensionManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"irisAppSettingsExtensionManifest.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/iris-app-api/src/types/extensions/irisAppSettingsExtensionManifest.ts"],"names":[],"mappings":"","sourcesContent":["import { AiNavigableExtensionManifest } from \"../irisAiNavigation\";\nimport { AbstractExtensionManifest } from \"../irisAppExtensionManifest\";\n\nexport interface IrisAppSettingsExtensionManifest extends AbstractExtensionManifest, AiNavigableExtensionManifest {\n  type: \"IRIS_APP_SETTINGS_EXTENSION\";\n}\n"]}

package/src/types/extensions/lifecycleExtensionManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleExtensionManifest.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/iris-app-api/src/types/extensions/lifecycleExtensionManifest.ts"],"names":[],"mappings":"","sourcesContent":["import { AbstractExtensionManifest } from \"../irisAppExtensionManifest\";\n\nexport interface LifecycleExtensionManifest extends AbstractExtensionManifest {\n  type: \"LIFECYCLE_EXTENSION\";\n}\n"]}

package/src/types/extensions/reportExtensionManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportExtensionManifest.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/iris-app-api/src/types/extensions/reportExtensionManifest.ts"],"names":[],"mappings":"","sourcesContent":["import { IconName } from \"../icons.generated\";\nimport { AbstractExtensionManifest, TranslationKey, Translations } from \"../irisAppExtensionManifest\";\nimport { AccountScope } from \"../scopes\";\n\nexport interface ReportExtensionManifest extends AbstractExtensionManifest {\n  type: \"REPORT_EXTENSION\";\n\n  conditions?: {\n    scopes?: AccountScope | Array<AccountScope>;\n  };\n\n  menuItem: {\n    /**\n     * Title of the card in manager\n     */\n    name: string | Translations | TranslationKey;\n\n    /**\n     * Subtitle of the card in manager\n     */\n    description: string | Translations | TranslationKey;\n\n    /**\n     * Icon of the card in manager, must use icons from:\n     * https://design.iris.trackunit.com/?path=/docs/components-icon--default\n     */\n    icon: IconName;\n  };\n}\n"]}

package/src/types/extensions/serversideApiExtensionManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serversideApiExtensionManifest.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/iris-app-api/src/types/extensions/serversideApiExtensionManifest.ts"],"names":[],"mappings":"","sourcesContent":["import { AbstractExtensionManifest } from \"../irisAppExtensionManifest\";\n\nexport interface ServersideApiExtensionManifest extends AbstractExtensionManifest {\n  type: \"SERVERSIDE_API_EXTENSION\";\n  runtime: \"DENO\";\n  id: string;\n  name: string;\n  description?: string;\n  main: `${string}.ts` | `${string}.js`;\n  dependencyDefinitionFile: string;\n}\n"]}

package/src/types/extensions/siteHomeExtensionManifest.d.ts

@@ -1,3 +1,4 @@
+import { AiNavigableExtensionManifest } from "../irisAiNavigation";
 import { AbstractExtensionManifest, RequiredCustomField, TranslationKey, Translations } from "../irisAppExtensionManifest";
 import { AccountScope } from "../scopes";
 declare const siteType: {
@@ -10,7 +11,7 @@ declare const siteType: {
     readonly WORK_PLACE: "WORK_PLACE";
 };
 type SiteType = (typeof siteType)[keyof typeof siteType];
-export interface SiteHomeExtensionManifest extends AbstractExtensionManifest {
+export interface SiteHomeExtensionManifest extends AbstractExtensionManifest, AiNavigableExtensionManifest {
     type: "SITE_HOME_EXTENSION";
     /**
      * Conditions for the site home extension to be shown.

package/src/types/extensions/siteHomeExtensionManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"siteHomeExtensionManifest.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/iris-app-api/src/types/extensions/siteHomeExtensionManifest.ts"],"names":[],"mappings":";;AASA,6DAA6D;AAC7D,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;IAC5B,iBAAiB,EAAE,mBAAmB;IACtC,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;CAChB,CAAC","sourcesContent":["import { AiNavigableExtensionManifest } from \"../irisAiNavigation\";\nimport {\n  AbstractExtensionManifest,\n  RequiredCustomField,\n  TranslationKey,\n  Translations,\n} from \"../irisAppExtensionManifest\";\nimport { AccountScope } from \"../scopes\";\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nconst siteType = {\n  AREA: \"AREA\",\n  CLASSIC_POI: \"CLASSIC_POI\",\n  CLASSIC_ZONE: \"CLASSIC_ZONE\",\n  CONSTRUCTION_SITE: \"CONSTRUCTION_SITE\",\n  DEPOT: \"DEPOT\",\n  NOT_ON_SITE: \"NOT_ON_SITE\",\n  WORK_PLACE: \"WORK_PLACE\",\n} as const;\ntype SiteType = (typeof siteType)[keyof typeof siteType];\n\nexport interface SiteHomeExtensionManifest extends AbstractExtensionManifest, AiNavigableExtensionManifest {\n  type: \"SITE_HOME_EXTENSION\";\n\n  /**\n   * Conditions for the site home extension to be shown.\n   *\n   * Its doing AND between the conditions types and OR between the conditions of the same type:\n   * - If only scopes is used/filled out then the site home extension will be shown for all sites that the user has the required permission for.\n   * - If more scopes are used/filled out then the site home extension will be shown for all sites that the user has one of the required permission for.\n   * - If only requiredCustomField is used/filled out then the site home extension will be shown for all sites that has the required custom field.\n   * - If more requiredCustomField are used/filled out then the site home extension will be shown for all sites that has all of the required custom field.\n   * - If no conditions are used/filled out then the site home extension will be shown for all sites.\n   */\n  conditions?: {\n    siteType?: Array<SiteType> | SiteType;\n    scopes?: AccountScope | Array<AccountScope>;\n\n    /**\n     * Only entityType SITE custom fields are supported here\n     */\n    requiredCustomField?: RequiredCustomField | Array<RequiredCustomField>;\n  };\n\n  menuItem: {\n    name: string | Translations | TranslationKey;\n  };\n}\n"]}