fix(table): revert default-case throw to plain Error and update JSDoc @throws tags

Author: waleedlatif1

apps/sim/lib/table/sql.ts

@@ -52,7 +52,7 @@ const ALLOWED_OPERATORS = new Set([
  * @param filter - Filter object with field conditions and logical operators
  * @param tableName - Table name for the query (e.g., 'user_table_rows')
  * @returns SQL WHERE clause or undefined if no filter specified
- * @throws Error if field name is invalid or operator is not allowed
+ * @throws {TableQueryValidationError} if field name is invalid or operator is not allowed
  *
  * @example
  * // Simple equality
@@ -121,7 +121,7 @@ export function buildFilterClause(filter: Filter, tableName: string): SQL | unde
  * @param tableName - Table name for the query (e.g., 'user_table_rows')
  * @param columns - Optional column definitions for type-aware sorting
  * @returns SQL ORDER BY clause or undefined if no sort specified
- * @throws Error if field name is invalid
+ * @throws {TableQueryValidationError} if field name or sort direction is invalid
  *
  * @example
  * buildSortClause({ name: 'asc', age: 'desc' }, 'user_table_rows')
@@ -161,7 +161,7 @@ export function buildSortClause(
  * Field names must match the NAME_PATTERN (alphanumeric + underscore, starting with letter/underscore).
  *
  * @param field - The field name to validate
- * @throws Error if field name is invalid
+ * @throws {TableQueryValidationError} if field name is invalid
  */
 function validateFieldName(field: string): void {
   if (!field || typeof field !== 'string') {
@@ -179,7 +179,7 @@ function validateFieldName(field: string): void {
  * Validates an operator to ensure it's in the allowed list.
  *
  * @param operator - The operator to validate
- * @throws Error if operator is not allowed
+ * @throws {TableQueryValidationError} if operator is not allowed
  */
 function validateOperator(operator: string): void {
   if (!ALLOWED_OPERATORS.has(operator)) {
@@ -203,7 +203,7 @@ function validateOperator(operator: string): void {
  *                    object with operators like $eq, $gt, $in, etc.
  * @returns Array of SQL condition fragments. Multiple conditions are returned
  *          when the condition object contains multiple operators.
- * @throws Error if field name is invalid or operator is not allowed
+ * @throws {TableQueryValidationError} if field name is invalid or operator is not allowed
  */
 function buildFieldCondition(
   tableName: string,
@@ -273,8 +273,10 @@ function buildFieldCondition(
           break
 
         default:
-          // This should never happen due to validateOperator, but added for completeness
-          throw new TableQueryValidationError(`Unsupported operator: ${op}`)
+          // This should never happen due to validateOperator, but added for completeness.
+          // Throw a plain Error (→ 500) since reaching this default means the switch
+          // and ALLOWED_OPERATORS have drifted — that's a programmer error, not a caller error.
+          throw new Error(`Unsupported operator: ${op}`)
       }
     }
   } else {