@deephaven-enterprise/query-utils 2026.1.55 → 2026.1.58

package/dist/ArgumentUtils.d.ts

@@ -11,6 +11,10 @@
  * @returns An array of tokens. Returns an empty array for empty/whitespace input.
  */
 export declare function tokenizeArgs(args: string): string[];
+/** Removes blank list entries while preserving every nonblank value verbatim. */
+export declare function removeBlankEntries(entries: readonly string[]): string[];
+/** Removes fully blank name/value pairs while preserving nonblank pairs. */
+export declare function removeBlankEnvVarEntries(entries: readonly string[]): string[];
 /**
  * Joins a flat alternating key/value array into a space-separated
  * `KEY=VALUE` string. Values are shell-quoted as needed so the output can be
@@ -19,7 +23,7 @@ export declare function tokenizeArgs(args: string): string[];
  * @param entries Flat alternating array: `["KEY1", "VALUE1", "KEY2", "VALUE2", …]`
  * @returns Shell-safe string: `"KEY1=VALUE1 KEY2='value with spaces'"`
  */
-export declare function joinEnvVarEntries(entries: string[]): string;
+export declare function joinEnvVarEntries(entries: readonly string[]): string;
 /**
  * Parses a space-separated `KEY=VALUE` string into a flat alternating
  * key/value array. Uses shell quoting rules so that quoted spans are
@@ -33,13 +37,15 @@ export declare function joinEnvVarEntries(entries: string[]): string;
  * @throws {Error} If any token has an empty key or is a shell operator/glob.
  */
 export declare function splitEnvVarEntries(envVars: string): string[];
+/** Returns an error for invalid environment variable entries, or null. */
+export declare function getEnvVarEntriesValidationError(entries: readonly string[]): string | null;
 /**
  * Joins an array of classpath entries into a colon-separated string.
  *
  * @param entries Array of classpath entries, one path per element.
  * @returns Colon-separated string: `"path1:path2:path3"`
  */
-export declare function joinClasspathAdditions(entries: string[]): string;
+export declare function joinClasspathAdditions(entries: readonly string[]): string;
 /**
  * Splits a colon-separated classpath string into an array of entries,
  * filtering out any empty segments.

package/dist/ArgumentUtils.js

@@ -15,6 +15,23 @@ export function tokenizeArgs(args) {
     var _a;
     return (_a = args.match(/(?:[^\s"']+|"[^"]*"|'[^']*'|["'])+/g)) !== null && _a !== void 0 ? _a : [];
 }
+/** Removes blank list entries while preserving every nonblank value verbatim. */
+export function removeBlankEntries(entries) {
+    return entries.filter(entry => entry.trim() !== '');
+}
+/** Removes fully blank name/value pairs while preserving nonblank pairs. */
+export function removeBlankEnvVarEntries(entries) {
+    var _a, _b;
+    const result = [];
+    for (let index = 0; index < entries.length; index += 2) {
+        const name = (_a = entries[index]) !== null && _a !== void 0 ? _a : '';
+        const value = (_b = entries[index + 1]) !== null && _b !== void 0 ? _b : '';
+        if (name.trim() !== '' || value.trim() !== '') {
+            result.push(name, value);
+        }
+    }
+    return result;
+}
 /**
  * Joins a flat alternating key/value array into a space-separated
  * `KEY=VALUE` string. Values are shell-quoted as needed so the output can be
@@ -28,8 +45,9 @@ export function joinEnvVarEntries(entries) {
     for (let i = 0; i + 1 < entries.length; i += 2) {
         const key = entries[i];
         const value = entries[i + 1];
+        const quotedKey = ShellQuote.quote([key]);
         const quotedValue = ShellQuote.quote([value]);
-        pairs.push(`${key}=${quotedValue}`);
+        pairs.push(`${quotedKey}=${quotedValue}`);
     }
     return pairs.join(' ');
 }
@@ -66,6 +84,27 @@ export function splitEnvVarEntries(envVars) {
     }
     return entries;
 }
+/** Returns an error for invalid environment variable entries, or null. */
+export function getEnvVarEntriesValidationError(entries) {
+    const seenNames = new Set();
+    for (let i = 0; i + 1 < entries.length; i += 2) {
+        const name = entries[i].trim();
+        const value = entries[i + 1];
+        if (name === '' && value !== '') {
+            return 'Environment variable name cannot be empty';
+        }
+        if (name.includes('=')) {
+            return `Environment variable name cannot contain "=": ${name}`;
+        }
+        if (name !== '' && seenNames.has(name)) {
+            return `Duplicate environment variable name: ${name}`;
+        }
+        if (name !== '') {
+            seenNames.add(name);
+        }
+    }
+    return null;
+}
 /**
  * Joins an array of classpath entries into a colon-separated string.
  *

package/dist/QueryUtils.d.ts

@@ -29,6 +29,7 @@ export declare const QUERY_CONFIG_TABLE: "QueryInfo";
 export declare const SCOPE_CONFIG_TABLE: "ScopeNamesAndType";
 export declare const CATALOG_TABLE: "catalog";
 export declare const FACTORY_SERVICE_TABLES: Set<"QueryInfo" | "ScopeNamesAndType" | "catalog">;
+export type FactoryServiceTableName = typeof FACTORY_SERVICE_TABLES extends Set<infer T> ? T : never;
 export type TemporaryDraftQueryConfig = Omit<DraftQueryConstructorObject, 'scheduling' | 'workerKind' | 'type'> & {
     type: string;
     engine: string;
@@ -172,7 +173,7 @@ export declare function hasCommunitySupport(queryConfigurationTypes: ReadonlyMap
  * @param tableName the name of the table
  * @returns true if the table is a factory service table, false otherwise
  */
-export declare function isFactoryServiceTable(tableName: string): boolean;
+export declare function isFactoryServiceTable(tableName: string): tableName is FactoryServiceTableName;
 /**
  * Turns a URI into a QueryVariableDescriptor
  * @param params Function parameters

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deephaven-enterprise/query-utils",
-  "version": "2026.1.55",
+  "version": "2026.1.58",
   "description": "Deephaven Enterprise Query Utils",
   "author": "Deephaven Data Labs LLC",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -17,11 +17,11 @@
     "build": "tsc --build"
   },
   "dependencies": {
-    "@deephaven-enterprise/client-utils": "2026.1.55",
-    "@deephaven-enterprise/jsapi-types": "2026.1.55",
+    "@deephaven-enterprise/client-utils": "2026.1.58",
+    "@deephaven-enterprise/jsapi-types": "2026.1.58",
     "@deephaven/jsapi-types": "1.0.0-dev0.40.5",
-    "@deephaven/log": "^0.97.0",
-    "@deephaven/utils": "^0.97.0",
+    "@deephaven/log": "^1.8.0",
+    "@deephaven/utils": "^1.29.0",
     "@internationalized/date": "^3.12.2",
     "nanoid": "^5.1.6",
     "shell-quote": "^1.8.4"