supalite 0.2.1 → 0.3.1

package/README.md

@@ -1,6 +1,6 @@
 # SupaLite
 
-[![npm version](https://img.shields.io/badge/version-0.2.1-blue.svg)](https://www.npmjs.com/package/supalite)
+[![npm version](https://img.shields.io/badge/version-0.3.1-blue.svg)](https://www.npmjs.com/package/supalite)
 
 가볍고 효율적인 PostgreSQL 클라이언트 라이브러리입니다. Supabase와 동일한 API를 제공하면서도 더 가볍고 빠른 구현을 제공합니다.
 
@@ -15,7 +15,7 @@
 - 💪 트랜잭션 지원: Supabase에서 지원하지 않는 안전한 데이터베이스 트랜잭션 처리
 - 🎯 UPSERT 지원: 삽입/업데이트 동작 제어
 - 🔍 고급 필터링: OR 조건, ILIKE 검색 등 지원
-- 📚 배열 작업: 다중 레코드 삽입 및 배열 데이터 처리
+- 📚 배열 작업: 다중 레코드 삽입 및 배열 데이터 처리 (JSON/JSONB 필드 포함)
 - 🔄 Views, Functions, Enums 지원: Supabase 스타일의 완벽한 타입 지원
 
 ## 설치 방법
@@ -230,6 +230,15 @@ const { data, error } = await client
     }
   ]);
 
+// JSONB 배열 데이터 처리
+const { data: jsonData, error: jsonError } = await client
+  .from('your_jsonb_table') // 'your_jsonb_table'을 실제 테이블명으로 변경
+  .insert({ 
+    metadata_array: ['tag1', 2025, { active: true }] 
+  })
+  .select('metadata_array')
+  .single();
+
 // 다른 스키마 사용
 const { data, error } = await client
   .from('users', 'other_schema')

package/dist/query-builder.js

@@ -27,7 +27,15 @@ class QueryBuilder {
         return this.execute().finally(onfinally);
     }
     select(columns = '*', options) {
-        this.selectColumns = columns;
+        if (columns && columns !== '*') {
+            this.selectColumns = columns.split(',')
+                .map(col => col.trim())
+                .map(col => col.startsWith('"') && col.endsWith('"') ? col : `"${col}"`)
+                .join(', ');
+        }
+        else {
+            this.selectColumns = columns;
+        }
         this.countOption = options?.count;
         this.headOption = options?.head;
         return this;
@@ -215,19 +223,35 @@ class QueryBuilder {
                     if (rows.length === 0)
                         throw new Error('Empty array provided for insert');
                     insertColumns = Object.keys(rows[0]);
-                    values = rows.map(row => Object.values(row)).flat();
+                    // Process each row for potential JSON stringification
+                    const processedRowsValues = rows.map(row => Object.values(row).map(val => {
+                        if (Array.isArray(val) || (val !== null && typeof val === 'object' && !(val instanceof Date))) {
+                            return JSON.stringify(val);
+                        }
+                        return val;
+                    }));
+                    values = processedRowsValues.flat();
                     const placeholders = rows.map((_, i) => `(${insertColumns.map((_, j) => `$${i * insertColumns.length + j + 1}`).join(',')})`).join(',');
                     query = `INSERT INTO ${schemaTable} ("${insertColumns.join('","')}") VALUES ${placeholders}`;
                 }
                 else {
                     const insertData = this.insertData;
                     insertColumns = Object.keys(insertData);
-                    values = Object.values(insertData);
+                    values = Object.values(insertData).map(val => {
+                        if (Array.isArray(val) || (val !== null && typeof val === 'object' && !(val instanceof Date))) {
+                            return JSON.stringify(val);
+                        }
+                        return val;
+                    });
                     const insertPlaceholders = values.map((_, i) => `$${i + 1}`).join(',');
                     query = `INSERT INTO ${schemaTable} ("${insertColumns.join('","')}") VALUES (${insertPlaceholders})`;
                 }
                 if (this.queryType === 'UPSERT' && this.conflictTarget) {
-                    query += ` ON CONFLICT (${this.conflictTarget}) DO UPDATE SET `;
+                    // Quote conflict target if it's a simple column name and not already quoted
+                    const conflictTargetSQL = (this.conflictTarget.includes('"') || this.conflictTarget.includes('(') || this.conflictTarget.includes(','))
+                        ? this.conflictTarget
+                        : `"${this.conflictTarget}"`;
+                    query += ` ON CONFLICT (${conflictTargetSQL}) DO UPDATE SET `;
                     query += insertColumns
                         .map((col) => `"${col}" = EXCLUDED."${col}"`)
                         .join(', ');
@@ -246,11 +270,16 @@ class QueryBuilder {
                 if ('updated_at' in updateData && !updateData.updated_at) {
                     updateData.updated_at = now;
                 }
-                const updateValues = Object.values(updateData);
+                const processedUpdateValues = Object.values(updateData).map(val => {
+                    if (Array.isArray(val) || (val !== null && typeof val === 'object' && !(val instanceof Date))) {
+                        return JSON.stringify(val);
+                    }
+                    return val;
+                });
                 const setColumns = Object.keys(updateData).map((key, index) => `"${String(key)}" = $${index + 1}`);
                 query = `UPDATE ${schemaTable} SET ${setColumns.join(', ')}`;
-                values = [...updateValues, ...this.whereValues];
-                query += this.buildWhereClause(updateValues);
+                values = [...processedUpdateValues, ...this.whereValues];
+                query += this.buildWhereClause(processedUpdateValues);
                 query += returning;
                 break;
             }

package/docs/changelog/2025-06-10-jsonb-array-test.md

@@ -0,0 +1,12 @@
+## 2025-06-10: Added JSONB Array Tests
+
+- Modified `src/__tests__/query-builder-single.test.ts`:
+    - Updated `JsonbTestTable` related types to use the global `Json` type.
+    - Added `another_json_field` (JSONB) to `jsonb_test_table` schema and tests.
+    - Modified `beforeAll` to `DROP TABLE IF EXISTS jsonb_test_table` before `CREATE TABLE` to ensure schema updates are applied, fixing a "column does not exist" error during tests.
+    - Removed explicit `JSON.stringify()` from test cases, relying on internal handling.
+    - Added a new test case for inserting/selecting an object into `another_json_field`.
+- Modified `src/query-builder.ts` (`buildQuery` method):
+    - Implemented automatic `JSON.stringify()` for array or object values (excluding `Date` instances) when preparing data for `INSERT`, `UPSERT`, and `UPDATE` operations. This allows users to pass JavaScript objects/arrays directly for `json`/`jsonb` columns.
+    - Corrected a TypeScript error (`Cannot find name 'updateValues'`) in the `UPDATE` case of `buildQuery`.
+- Ensured `src/types.ts` contains the `Json` type definition.

package/docs/changelog/2025-06-10-reserved-keywords-handling.md

@@ -0,0 +1,8 @@
+## 2025-06-10: Improved Handling of Reserved Keywords as Column Names
+
+- **New Test Suite**: Created `src/__tests__/query-builder-reserved.test.ts` to specifically test scenarios where table column names are SQL reserved keywords (e.g., "order", "desc", "user", "limit", "group").
+    - Includes tests for SELECT, INSERT, UPDATE, ORDER BY, and UPSERT operations on these columns.
+- **`QueryBuilder` Modifications (`src/query-builder.ts`)**:
+    - **`select()` method**: Enhanced to automatically quote individual column names if a comma-separated string of unquoted names is provided (e.g., `select('order, desc')` will now correctly generate `SELECT "order", "desc"`). This does not affect `select('*')` or already quoted identifiers.
+    - **`upsert()` method**: The `onConflict` option, when provided as a simple unquoted column name, will now be automatically quoted (e.g., `onConflict: 'order'` becomes `ON CONFLICT ("order")`). Complex constraint names or multi-column conflict targets provided by the user are not modified.
+- **Previous JSONB Update Integration**: The work on reserved keywords was done on top of previous changes for automatic JSON stringification. The changelog entry `docs/changelog/2025-06-10-jsonb-array-test.md` covers those details. This entry focuses on reserved keyword handling.

package/package.json

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