Add hint to quote table names for sql 'unknown table' errors

shared/studio/tabs/queryEditor/state/index.ts

@@ -777,6 +777,8 @@ export class QueryEditor extends Model({
       .activeState.options.find((opt) => opt.name === "Implicit Limit")
       ?.value as bigint | undefined;
 
+    const lang =
+      this.selectedEditor === EditorKind.SQL ? Language.SQL : Language.EDGEQL;
     try {
       const {result, outCodecBuf, resultBuf, protoVer, capabilities, status} =
         yield* _await(
@@ -794,9 +796,7 @@ export class QueryEditor extends Model({
               replQueryTag: true,
             },
             this.runningQueryAbort?.signal,
-            this.selectedEditor === EditorKind.SQL
-              ? Language.SQL
-              : Language.EDGEQL
+            lang
           )
         );
 
@@ -819,7 +819,9 @@ export class QueryEditor extends Model({
         queryData,
         timestamp,
         thumbnailData,
-        error: extractErrorDetails(e, query),
+        error: extractErrorDetails(e, query, lang, () => [
+          ...(dbCtx.get(this)?.schemaData?.objectsByName.keys() ?? []),
+        ]),
       });
     }
     return {success: false};

shared/studio/tabs/repl/state/index.ts

@@ -468,6 +468,8 @@ export class Repl extends Model({
 
     dbState.setLoadingTab(Repl, true);
 
+    const lang =
+      this.language === ReplLang.SQL ? Language.SQL : Language.EDGEQL;
     let resultData: QueryResultData | undefined = undefined;
     let skipStoreHistoryItem = false;
     try {
@@ -500,7 +502,7 @@ export class Repl extends Model({
               replQueryTag: true,
             },
             (this._runningQuery as AbortController).signal,
-            this.language === ReplLang.SQL ? Language.SQL : Language.EDGEQL
+            lang
           )
         );
 
@@ -542,7 +544,11 @@ export class Repl extends Model({
         }
       }
     } catch (err: any) {
-      historyItem.setError(extractErrorDetails(err, query));
+      historyItem.setError(
+        extractErrorDetails(err, query, lang, () => [
+          ...(dbCtx.get(this)?.schemaData?.objectsByName.keys() ?? []),
+        ])
+      );
     }
 
     if (!skipStoreHistoryItem) {

shared/studio/utils/extractErrorDetails.ts

@@ -1,4 +1,5 @@
 import {EdgeDBError} from "edgedb";
+import {Language} from "edgedb/dist/ifaces";
 import {utf8Decoder} from "edgedb/dist/primitives/buffer";
 
 enum ErrorField {
@@ -33,7 +34,12 @@ function tryParseInt(val: any) {
   return null;
 }
 
-export function extractErrorDetails(err: any, query?: string): ErrorDetails {
+export function extractErrorDetails(
+  err: any,
+  query?: string,
+  lang?: Language,
+  getObjectTypeNames?: () => string[]
+): ErrorDetails {
   if (!(err instanceof Error)) {
     throw new Error(`Fatal Error: cannot handle non error as error: ${err}`);
   }
@@ -87,5 +93,38 @@ export function extractErrorDetails(err: any, query?: string): ErrorDetails {
     }
   }
 
+  if (lang === Language.SQL && !errDetails.hint && getObjectTypeNames) {
+    const match = errDetails.msg.match(/unknown table `(.*)`/);
+    if (match) {
+      const name = match[1];
+      const typeNames = getObjectTypeNames();
+      if (
+        name.startsWith('"') &&
+        name.endsWith('"') &&
+        typeNames.includes(name.slice(1, -1))
+      ) {
+        errDetails.hint = `Try specifying the module name using SQL syntax: ${name
+          .slice(1, -1)
+          .split("::")
+          .map((part) => (part.toLowerCase() === part ? part : `"${part}"`))
+          .join(".")}`;
+      } else {
+        const colonised = name.replace(".", "::");
+        for (const typeName of typeNames) {
+          const stripped = typeName.replace(/^default::/, "");
+          if (stripped.toLowerCase() === colonised) {
+            errDetails.hint = `Try quoting the table name: ${stripped
+              .split("::")
+              .map((part) =>
+                part.toLowerCase() === part ? part : `"${part}"`
+              )
+              .join(".")}`;
+            break;
+          }
+        }
+      }
+    }
+  }
+
   return errDetails;
 }