@digitalwalletcorp/sql-builder 1.6.1 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitalwalletcorp/sql-builder",
-  "version": "1.6.1",
+  "version": "2.1.0",
   "description": "This is a library for building SQL",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -16,8 +16,13 @@
   },
   "keywords": [
     "sql",
+    "template",
+    "builder",
     "dynamic",
-    "S2Dao"
+    "parameterized",
+    "placeholder",
+    "S2Dao",
+    "Doma"
   ],
   "author": "satoshi kotaki",
   "license": "MIT",

package/src/abstract-syntax-tree.ts

@@ -39,7 +39,7 @@ export class AbstractSyntaxTree {
   /**
    * 与えられた条件文字列を構文解析し、entityに対する条件として成立するか評価する
    *
-   * @param {string} condition "params != null && params.length > 10" のような条件
+   * @param {string} condition 'params != null && params.length > 10' のような条件
    * @param {Record<string, any>} entity
    * @returns {boolean}
    */
@@ -50,9 +50,8 @@ export class AbstractSyntaxTree {
       const result = this.evaluateRpn(rpnTokens, entity);
       return result;
     } catch (error: any) {
-      error.condition = condition;
-      error.entity = entity;
-      throw error;
+      const enhancedMessage = `[SQLBuilder] Failed to evaluate IF condition: '/*IF ${condition}*/'. ${error.message}`;
+      throw new Error(enhancedMessage);
     }
   }
 
@@ -239,7 +238,7 @@ export class AbstractSyntaxTree {
               output.push(op);
             }
             if (!foundLeftParen) {
-              throw new Error('[SQLBuilder.AbstractSyntaxTree] Mismatched parentheses');
+              throw new Error(`[SQLBuilder.AST] Mismatched parentheses: Found closing ')' without a matching '('. Check your IF condition syntax.`);;
             }
           }
           break;
@@ -250,7 +249,7 @@ export class AbstractSyntaxTree {
     while (operatorStack.length) {
       const op = operatorStack.pop()!;
       if (op.value === '(' || op.value === ')') {
-        throw new Error('[SQLBuilder.AbstractSyntaxTree] Mismatched parentheses');
+        throw new Error(`[SQLBuilder.AST] Mismatched parentheses: An extra '${op.value}' was found or a matching '(' is missing.`);
       }
       output.push(op);
     }

package/src/common.ts

@@ -1,3 +1,8 @@
+type PropertyResult = {
+  exists: boolean;
+  value: any;
+}
+
 /**
  * entityで指定したオブジェクトからドットで連結されたプロパティキーに該当する値を取得する
  *
@@ -6,17 +11,45 @@
  * @returns {any}
  */
 export function getProperty(entity: Record<string, any>, property: string): any {
+  return getPropertyResult(entity, property).value;
+}
+
+/**
+ * entityで指定したオブジェクトからドットで連結されたプロパティキーに該当する値が存在するかチェックする
+ *
+ * @param {Record<string, any>} entity
+ * @param {string} property
+ * @returns {boolean}
+ */
+export function hasProperty(entity: Record<string, any>, property: string): boolean {
+  return getPropertyResult(entity, property).exists;
+}
+
+/**
+ * entityで指定したオブジェクトからドットで連結されたプロパティキーに該当する値を取得する
+ *
+ * @param {Record<string, any>} entity
+ * @param {string} property
+ * @returns {PropertyResult}
+ */
+export function getPropertyResult(entity: Record<string, any>, property: string): PropertyResult {
   // `?.` または `.` でパスを分割
   const propertyPath = property.split(/(\?\.)|\./).filter(Boolean);
 
   // 再帰呼び出し用のヘルパー関数
   const get = (obj: Record<string, any>, keys: string[]): any => {
     if (keys.length === 0) {
-      return obj;
+      return {
+        exists: true,
+        value: obj
+      } as PropertyResult;
     }
     // オプショナルチェイニングのチェック
     if (obj == null) {
-      return undefined;
+      return {
+        exists: false,
+        value: undefined
+      } as PropertyResult;
     }
 
     const currentKey = keys[0];
@@ -27,8 +60,11 @@ export function getProperty(entity: Record<string, any>, property: string): any
       return get(obj, remainingKeys);
     }
     // プロパティが存在しない場合は undefined を返す
-    if (!obj.hasOwnProperty(currentKey)) {
-      return undefined;
+    if (!Object.prototype.hasOwnProperty.call(obj, currentKey)) {
+      return {
+        exists: false,
+        value: undefined
+      } as PropertyResult;
     }
     return get(obj[currentKey], remainingKeys);
   };