@norskvideo/ctl-dev-kit 0.2.95 → 0.2.97

package/dashboard/uses.ts

@@ -1,16 +1,21 @@
 // What a fleet dashboard uses, derived from its own code when it is built
-// (RFC 0006 registration-names-what-it-uses, task 122 K): every kind its
-// `fleet.query` and `fleet.watch` calls name, read as literals. A call the
-// build cannot read, or any other use of the client, fails the build rather
-// than leave `dashboard.json` short of what the code reads.
+// (RFC 0006 registration-names-what-it-uses, task 122 K, task 123 K): every
+// kind its `fleet.query` and `fleet.watch` calls name, and every operationId
+// its `fleet.call` and `fleet.live` calls name, read as literals.
+// `fleet.state.get`/`put` use nothing a registration lists. A call the build
+// cannot read, or any other use of the client, fails the build rather than
+// leave `dashboard.json` short of what the code reaches.
 
 import ts from "typescript";
 
 export const FLEET_MODULE = "@norskvideo/ctl-sdk/fleet";
-const CALLS = new Set(["query", "watch"]);
+const KIND_CALLS = new Set(["query", "watch"]);
+const OPERATION_CALLS = new Set(["call", "live"]);
+const STATE_CALLS = new Set(["get", "put"]);
 
 export interface DashboardUses {
   kinds: string[];
+  operations: string[];
 }
 
 export type UsesResult = { status: "ok"; value: DashboardUses } | { status: "error"; error: string[] };
@@ -38,6 +43,7 @@ function kindsOfSelection(arg: ts.Expression | undefined): string[] | undefined
 
 export function dashboardUses(files: readonly { path: string; source: string }[]): UsesResult {
   const kinds = new Set<string>();
+  const operations = new Set<string>();
   const problems: string[] = [];
   for (const { path, source } of files) {
     const sf = ts.createSourceFile(path, source, ts.ScriptTarget.Latest, true);
@@ -82,17 +88,48 @@ export function dashboardUses(files: readonly { path: string; source: string }[]
         ts.isCallExpression(node) &&
         ts.isPropertyAccessExpression(node.expression) &&
         ts.isIdentifier(node.expression.expression) &&
-        clients.has(node.expression.expression.text) &&
-        CALLS.has(node.expression.name.text)
+        clients.has(node.expression.expression.text)
       ) {
-        const found = kindsOfSelection(node.arguments[0]);
-        if (found === undefined) {
-          problems.push(
-            `${where(node)}: ${node.expression.getText()} must name its kind as a literal, or a list of literals, in the selection it is passed, so the dashboard's uses can be derived`,
-          );
-        } else {
-          for (const kind of found) kinds.add(kind);
+        const method = node.expression.name.text;
+        if (KIND_CALLS.has(method)) {
+          const found = kindsOfSelection(node.arguments[0]);
+          if (found === undefined) {
+            problems.push(
+              `${where(node)}: ${node.expression.getText()} must name its kind as a literal, or a list of literals, in the selection it is passed, so the dashboard's uses can be derived`,
+            );
+          } else {
+            for (const kind of found) kinds.add(kind);
+          }
+          for (const arg of node.arguments) visit(arg);
+          return;
         }
+        if (OPERATION_CALLS.has(method)) {
+          const operation = node.arguments[1];
+          if (
+            operation !== undefined &&
+            (ts.isStringLiteral(operation) || ts.isNoSubstitutionTemplateLiteral(operation))
+          ) {
+            operations.add(operation.text);
+          } else {
+            problems.push(
+              `${where(node)}: ${node.expression.getText()} must name its operationId as a literal, so the dashboard's uses can be derived`,
+            );
+          }
+          for (const arg of node.arguments) visit(arg);
+          return;
+        }
+      }
+      // fleet.state.get(...) / .put(...): the host's shared state, which a
+      // registration does not list.
+      if (
+        ts.isCallExpression(node) &&
+        ts.isPropertyAccessExpression(node.expression) &&
+        STATE_CALLS.has(node.expression.name.text) &&
+        ts.isPropertyAccessExpression(node.expression.expression) &&
+        node.expression.expression.name.text === "state" &&
+        ts.isIdentifier(node.expression.expression.expression) &&
+        clients.has(node.expression.expression.expression.text)
+      ) {
         for (const arg of node.arguments) visit(arg);
         return;
       }
@@ -101,7 +138,7 @@ export function dashboardUses(files: readonly { path: string; source: string }[]
         const declaring = ts.isImportSpecifier(parent) || (ts.isVariableDeclaration(parent) && parent.name === node);
         if (!declaring) {
           problems.push(
-            `${where(node)}: ${node.text} is used other than by calling its query or watch, so the build cannot see what it reads`,
+            `${where(node)}: ${node.text} is used other than by calling its query, watch, call, live or state.get/put, so the build cannot see what it reaches`,
           );
         }
       }
@@ -111,5 +148,5 @@ export function dashboardUses(files: readonly { path: string; source: string }[]
   }
   return problems.length > 0
     ? { status: "error", error: problems }
-    : { status: "ok", value: { kinds: [...kinds].sort() } };
+    : { status: "ok", value: { kinds: [...kinds].sort(), operations: [...operations].sort() } };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-dev-kit",
-  "version": "0.2.95",
+  "version": "0.2.97",
   "type": "module",
   "exports": {
     "./create-product": "./create-product/create-product.ts",
@@ -39,10 +39,10 @@
   },
   "devDependencies": {
     "@norskvideo/ctl-oas-to-ts": "^0.1.0",
-    "@norskvideo/norsk-sdk": "1.3.1-2026-10-16-e43e0f90",
-    "@norskvideo/norsk-studio": "1.30.0-2026-10-17-4468cc12",
-    "@norskvideo/norsk-studio-builder": "1.30.0-2026-10-17-4468cc12",
-    "@norskvideo/norsk-studio-built-ins": "1.30.0-2026-10-17-4468cc12",
+    "@norskvideo/norsk-sdk": "1.3.1-2026-10-21-c97178c2",
+    "@norskvideo/norsk-studio": "1.30.0-2026-10-20-6fb182ff",
+    "@norskvideo/norsk-studio-builder": "1.30.0-2026-10-20-6fb182ff",
+    "@norskvideo/norsk-studio-built-ins": "1.30.0-2026-10-20-6fb182ff",
     "@playwright/test": "^1.59.0",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",