supalite 0.5.3 → 0.5.4

package/README.md

@@ -289,7 +289,7 @@ const { data, error } = await client
 - `is(column, value)`: IS 연산자
 - `not(column, operator, value)`: Negates an operator (e.g., `not('column', 'is', null)`).
 - `contains(column, value)`: 배열/JSON 포함 여부
-- `or(conditions)`: OR 조건 (예: 'status.eq.active,role.eq.admin')
+- `or(conditions)`: OR 조건 (예: 'status.eq.active,role.eq.admin', 'valid_until.is.null')
 
 ### 기타 메소드
 

package/dist/query-builder.js

@@ -171,7 +171,7 @@ class QueryBuilder {
     or(conditions) {
         const orParts = conditions.split(',').map(condition => {
             const [field, op, value] = condition.split('.');
-            const validOperators = ['eq', 'neq', 'ilike', 'like', 'gt', 'gte', 'lt', 'lte'];
+            const validOperators = ['eq', 'neq', 'ilike', 'like', 'gt', 'gte', 'lt', 'lte', 'is'];
             if (!validOperators.includes(op)) {
                 throw new Error(`Invalid operator: ${op}`);
             }
@@ -204,6 +204,13 @@ class QueryBuilder {
                     return `"${field}" < $${paramIndex}`;
                 case 'lte':
                     return `"${field}" <= $${paramIndex}`;
+                case 'is':
+                    if (processedValue === null) {
+                        // Remove the null value from whereValues since we don't need a parameter for IS NULL
+                        this.whereValues.pop();
+                        return `"${field}" IS NULL`;
+                    }
+                    return `"${field}" IS $${paramIndex}`;
                 default:
                     return '';
             }

package/docs/changelog/2025-11-21-support-is-in-or-method.md

@@ -0,0 +1,33 @@
+# 변경 보고서: `or` 메소드 내 `is` 연산자 지원
+
+**날짜:** 2025년 11월 21일
+
+## 변경 유형
+
+- [x] 기능 추가
+- [ ] 버그 수정
+- [ ] 성능 개선
+- [ ] 문서 업데이트
+- [ ] 기타
+
+## 변경 내용
+
+### `QueryBuilder`
+
+- **`or` 메소드 개선**: `or` 메소드 내부에서 `is` 연산자를 사용할 수 있도록 지원을 추가했습니다. 이제 `valid_until.is.null`과 같은 표현을 통해 `IS NULL` 조건을 `OR` 절 안에서 사용할 수 있습니다.
+
+  **사용 예시:**
+
+  ```typescript
+  const { data } = await client
+    .from('credits')
+    .select('*')
+    .or('valid_until.is.null,valid_until.gt.now()');
+  ```
+
+  위 코드는 `SELECT * FROM "public"."credits" WHERE ("valid_until" IS NULL OR "valid_until" > 'now()')` SQL 쿼리를 생성합니다.
+
+## 관련 파일
+
+- `src/query-builder.ts`
+- `README.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supalite",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "A lightweight TypeScript PostgreSQL client with Supabase-style API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",