@deephaven-enterprise/query-utils 2026.1.58 → 2026.1.60

package/dist/QueryPermissions.d.ts

@@ -13,6 +13,17 @@ export declare const TYPE_SPECIFIC_FIELD_PARTITION_FORMULA = "PartitionFormula";
  * @returns True if the user can view permissions for the query, false otherwise
  */
 export declare function canViewPermissions(user: EnterpriseUser, draftQuery: DraftQuery | null): boolean;
+/**
+ * Check whether the user may attach a console to the given query. Attaching
+ * runs code in the query's own scope, so it is restricted to the owner and,
+ * only when the server opts in, the query's admins.
+ * @param user The user attempting to attach
+ * @param query The query to attach to
+ * @param isAllowedForAdmins Value of the server's
+ * `consoleAttachmentAllowedForAdmins` setting
+ * @returns True if the user may attach a console to the query
+ */
+export declare function canAttachToConsole(user: EnterpriseUser, query: QueryInfo, isAllowedForAdmins: boolean): boolean;
 /**
  * Get the query configuration types that are displayable and the user is allowed to create
  * @param queryConfigurationTypes Query configuration types to filter

package/dist/QueryPermissions.js

@@ -30,6 +30,30 @@ export function canViewPermissions(user, draftQuery) {
     // Otherwise, only show it if they can view the shared users
     return user.permissions.canViewQuerySharedUsers;
 }
+/**
+ * Check whether the user may attach a console to the given query. Attaching
+ * runs code in the query's own scope, so it is restricted to the owner and,
+ * only when the server opts in, the query's admins.
+ * @param user The user attempting to attach
+ * @param query The query to attach to
+ * @param isAllowedForAdmins Value of the server's
+ * `consoleAttachmentAllowedForAdmins` setting
+ * @returns True if the user may attach a console to the query
+ */
+export function canAttachToConsole(user, query, isAllowedForAdmins) {
+    if (user.permissions.isSuperUser) {
+        return true;
+    }
+    if (query.owner === user.operateAs) {
+        return true;
+    }
+    if (!isAllowedForAdmins) {
+        return false;
+    }
+    // Same definition of admin used by `getQuerySelectionPermissions`.
+    return (user.groups.includes(query.owner) ||
+        query.adminGroups.some(group => user.groups.includes(group)));
+}
 /**
  * Get the query configuration types that are displayable and the user is allowed to create
  * @param queryConfigurationTypes Query configuration types to filter

package/dist/QueryStateUtils.d.ts

@@ -1,5 +1,5 @@
 import type { dh } from '@deephaven/jsapi-types';
-import type { QueryInfo } from '@deephaven-enterprise/jsapi-types';
+import type { QueryInfo, WorkerKind } from '@deephaven-enterprise/jsapi-types';
 import type DraftQuery from './DraftQuery.ts';
 export type QueryInfoMap = Map<string, QueryInfo>;
 export declare const NON_RUNNING_STATUSES: Set<string>;
@@ -17,6 +17,13 @@ export declare function isQueryStartable(query: QueryInfo): boolean;
 export declare function isQueryRestartable(query: QueryInfo): boolean;
 export declare function isStoppable(queryInfoMap: QueryInfoMap | undefined, serial: string): boolean;
 export declare function isRunning(query: QueryInfo): boolean;
+/**
+ * Check whether a console session can attach to the given query. Attaching runs
+ * a console against the query's existing worker, so the query must be running on
+ * a Core+ worker. Any query type is allowed; who may attach is a separate
+ * permission check.
+ */
+export declare function isAttachableToConsole(query: QueryInfo, workerKinds: readonly WorkerKind[], defaultWorkerKind: string): boolean;
 export declare function isWebClient(query: QueryInfo): boolean;
 /**
  * Check if the specified query can be restarted in it's current state.

package/dist/QueryStateUtils.js

@@ -1,3 +1,4 @@
+import { getWorkerKind, isCommunityWorkerKind, } from '@deephaven-enterprise/client-utils';
 import { QueryColumns } from "./QueryColumns.js";
 import { QueryScheduler } from "./QueryScheduler.js";
 import { QueryStatus } from "./QueryStatus.js";
@@ -74,6 +75,17 @@ export function isRunning(query) {
     var _a;
     return ((_a = query.designated) === null || _a === void 0 ? void 0 : _a.status) === QueryStatus.running;
 }
+/**
+ * Check whether a console session can attach to the given query. Attaching runs
+ * a console against the query's existing worker, so the query must be running on
+ * a Core+ worker. Any query type is allowed; who may attach is a separate
+ * permission check.
+ */
+export function isAttachableToConsole(query, workerKinds, defaultWorkerKind) {
+    var _a;
+    return (isRunning(query) &&
+        isCommunityWorkerKind(getWorkerKind((_a = query.workerKind) !== null && _a !== void 0 ? _a : defaultWorkerKind, workerKinds)));
+}
 export function isWebClient(query) {
     return query.type === WEB_CLIENT_DATA_CORE_CONFIG_TYPE;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deephaven-enterprise/query-utils",
-  "version": "2026.1.58",
+  "version": "2026.1.60",
   "description": "Deephaven Enterprise Query Utils",
   "author": "Deephaven Data Labs LLC",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -17,8 +17,8 @@
     "build": "tsc --build"
   },
   "dependencies": {
-    "@deephaven-enterprise/client-utils": "2026.1.58",
-    "@deephaven-enterprise/jsapi-types": "2026.1.58",
+    "@deephaven-enterprise/client-utils": "2026.1.60",
+    "@deephaven-enterprise/jsapi-types": "2026.1.60",
     "@deephaven/jsapi-types": "1.0.0-dev0.40.5",
     "@deephaven/log": "^1.8.0",
     "@deephaven/utils": "^1.29.0",