supalite 0.1.13 → 0.2.0

package/CHANGELOG.md

@@ -1,52 +1,15 @@
 # Changelog
 
-## [0.1.13] - 2025-03-02
+## [0.1.8] - 2025-03-04
 
 ### Fixed
-- modified_at과 updated_at 필드를 nullable로 변경하여 NULL 값 처리 개선
-- 타입 안전성 향상
+- 누락된 `dist` 파일들을 포함하도록 수정
 
-## [0.1.12] - 2025-03-02
+## [0.1.7] - 2025-03-04
 
 ### Added
-- Views 테이블 조회 기능 추가
-- TableOrViewName 타입 추가로 Tables와 Views 모두 지원
-- View 테이블 조회 예제 코드 추가
-- View 테이블 테스트를 위한 SQL 스크립트 추가
-
-## [0.1.11] - 2025-03-02
-
-### Fixed
-- 빌드 결과물 업데이트 및 배포 문제 해결
-
-## [0.1.10] - 2025-03-02
-
-### Fixed
-- order 메서드를 수정하여 컬럼 이름만 전달하는 경우에도 기본적으로 오름차순 정렬이 적용되도록 개선
-- Supabase와의 호환성 개선 (.order('post_index') 형식 지원)
-- order 메서드 사용 예제 추가
-
-## [0.1.9] - 2025-03-02
-
-### Fixed
-- from 메서드의 반환 타입을 수정하여 single() 메서드를 호출할 때 SingleQueryResult를 반환하도록 개선
-- 타입 단언 없이도 single() 메서드를 사용할 수 있도록 수정
-- single() 메서드 사용 예제 추가
-
-## [0.1.8] - 2025-03-02
-
-### Fixed
-- from 메서드의 반환 타입을 수정하여 타입 단언 없이도 배열 메서드를 사용할 수 있도록 개선
-- await 사용 시 자동으로 QueryResult<Row<T, S, K>>를 반환하도록 수정
-- Supabase와의 호환성 개선
-
-## [0.1.7] - 2025-03-02
-
-### Fixed
-- QueryResult 타입의 data 필드가 항상 배열을 반환하도록 수정
-- 쿼리 결과가 없을 때 null 대신 빈 배열([])을 반환하도록 수정
-- 에러 발생 시에도 data 필드가 빈 배열을 반환하도록 수정
-- Supabase와의 호환성 개선
+- QueryBuilder에 `match` 메서드 추가
+- `match` 메서드 테스트 코드 작성
 
 ## [0.1.6] - 2025-03-01
 

package/CHANGE_REPORT_LOG.md

@@ -1,65 +1,123 @@
-# 변경 사항 보고서 (2025-03-02)
+# 변경 작업 보고서
+
+## [2025-03-04] 누락된 dist 파일들을 포함하도록 수정
+
+### 작업 내용
+- 빌드 시 생성되는 dist 디렉토리의 파일들이 이전 커밋에 포함되지 않은 문제를 발견했습니다.
+- dist 디렉토리를 삭제하고 다시 빌드하여 누락된 파일들을 생성했습니다.
+- package.json 파일의 버전을 0.1.8로 업데이트했습니다.
+- CHANGELOG.md 파일에 변경 사항을 기록했습니다.
+
+### 변경된 파일
+- dist/*
+- package.json
+- CHANGELOG.md
+
+### 개발 과정
+1. dist 디렉토리 삭제
+2. npm run build 명령어 실행
+3. git add . 명령어로 변경된 파일 스테이징
+4. git commit -m "fix: Include missing files in dist directory" 명령어로 커밋
+5. package.json 파일의 버전 업데이트
+6. CHANGELOG.md 파일에 변경 사항 기록
+
+### 결론
+이번 작업을 통해 누락되었던 dist 파일들을 커밋에 포함시켰습니다.
+
+---
+
+## [2025-03-04] QueryBuilder에 match 메서드 추가
+
+### 작업 내용
+
+1.  **`match` 메서드 구현**:
+    - `QueryBuilder` 클래스에 `match` 메서드를 추가했습니다.
+    - 이 메서드는 객체를 인자로 받아, 객체의 각 키-값 쌍을 `"${key}" = $${index}` 형태의 조건으로 변환하여 `whereConditions` 배열에 추가합니다.
+    - 이를 통해 사용자는 객체 리터럴을 사용하여 간편하게 쿼리 조건을 추가할 수 있습니다.
+
+2.  **테스트용 테이블 생성**:
+    - `examples/setup.sql` 파일에 `test_table`을 생성하는 SQL 문을 추가했습니다.
+    - 이 테이블은 `match` 메서드의 동작을 테스트하는 데 사용됩니다.
+
+3.  **테스트용 함수 구현**:
+    - `src/test-table.ts` 파일에 `test_table`과 상호작용하는 함수를 작성했습니다.
+    - `insertIntoTestTable` 함수는 `test_table`에 데이터를 삽입합니다.
+    - `getFromTestTable` 함수는 `test_table`에서 데이터를 조회하고, `match` 메서드를 사용하여 조건을 적용합니다.
+
+4.  **테스트 코드 작성**:
+    - `examples/tests/query-builder.test.ts` 파일에 `match` 메서드를 테스트하는 코드를 작성했습니다.
+    - 이 코드는 `test_table`에 데이터를 삽입하고, `match` 메서드를 사용하여 다양한 조건으로 데이터를 조회합니다.
+    - 조회 결과가 예상과 일치하는지 확인합니다.
+
+5.  **테스트 실행**:
+    - `bun examples/tests/query-builder.test.ts` 명령어를 사용하여 테스트를 실행했습니다.
+    - 모든 테스트가 성공적으로 완료되었습니다.
+
+6.  **문서화**:
+     - CHANGELOG.md 파일에 `match` 메서드 추가 사항을 기록했습니다.
+     - 버전을 0.1.7로 업데이트했습니다.
+
+### 변경된 파일
+
+1.  `src/query-builder.ts`: `match` 메서드 추가
+2.  `examples/setup.sql`: `test_table` 생성 SQL 문 추가
+3.  `src/test-table.ts`: `test_table` 관련 함수 구현
+4.  `examples/tests/query-builder.test.ts`: `match` 메서드 테스트 코드 작성
+5.  `CHANGELOG.md`: 변경 사항 문서화 및 버전 업데이트
+
+### 개발 과정
+
+1.  `feature/add-match-method` 브랜치 생성
+2.  `QueryBuilder` 클래스에 `match` 메서드 구현
+3.  `examples/setup.sql` 파일에 `test_table` 생성 SQL 문 추가
+4.  `src/test-table.ts` 파일에 `test_table` 관련 함수 구현
+5.  `examples/tests/query-builder.test.ts` 파일에 `match` 메서드 테스트 코드 작성
+6.  테스트 실행 및 결과 확인
+7.  문서화 및 버전 업데이트
+8.  변경 사항 커밋
+9.  main 브랜치로 병합
+
+### 테스트 결과
+
+테스트 결과는 다음과 같습니다:
+
+```
+Result 1: [
+  {
+    id: 1
+    name: "test1"
+    value: 10
+  }
+]
+Result 2: [
+  {
+    id: 2
+    name: "test2"
+    value: 20
+  }
+]
+Result 3: [
+  {
+    id: 1
+    name: "test1"
+    value: 10
+  }
+]
+Result 4: null
+```
+
+Result1, 2, 3은 예상대로 출력되었고, Result 4는 존재하지 않는 데이터에 대한 결과로 null을 반환했습니다.
+
+### 결론
+
+이번 작업을 통해 `QueryBuilder` 클래스에 `match` 메서드를 추가하여, 사용자가 객체 리터럴을 사용하여 간편하게 쿼리 조건을 추가할 수 있게 되었습니다. 또한, 테스트 코드를 통해 `match` 메서드의 동작을 검증했습니다.
+
+---
+
+# 변경 작업 보고서
+
+## [2025-03-01] corepack을 통한 다중 패키지 관리자 지원 추가
+
+### 작업 내용
 
-## 버전 0.1.12 배포 완료
-
-### 1. 코드 변경 사항
-
-#### 타입 정의 수정 (`src/types.ts`)
-- `ViewName` 타입 추가: 스키마 내의 Views 이름을 참조하는 타입
-- `TableOrViewName` 타입 추가: Tables와 Views를 모두 포함하는 통합 타입
-- `Row`, `InsertRow`, `UpdateRow` 타입 수정: Views도 처리할 수 있도록 조건부 타입 적용
-
-#### 쿼리 빌더 수정 (`src/query-builder.ts`)
-- `QueryBuilder` 클래스의 제네릭 타입 매개변수를 `TableOrViewName`으로 변경
-
-#### PostgreSQL 클라이언트 수정 (`src/postgres-client.ts`)
-- `SchemaWithTables` 타입 수정: Views 타입 정의 추가
-- `from` 메서드 시그니처 수정: `TableOrViewName` 타입을 사용하도록 변경
-
-### 2. 예제 및 테스트 코드 추가
-
-#### 예제 데이터베이스 타입 정의 수정 (`examples/types/database.ts`)
-- 예제 데이터베이스 타입 정의에 Views 추가
-- `user_posts_view`와 `active_users_view` 뷰 정의 추가
-
-#### 테스트 및 예제 코드 추가
-- View 테이블 조회 예제 코드 작성 (`examples/tests/view-table.ts`)
-- 테스트용 SQL 스크립트 작성 (`examples/setup-views.sql`)
-- 모의 데이터를 사용한 테스트 코드 작성 (`examples/tests/mock-view-table.ts`)
-- 타입 안전성 테스트 코드 작성 (`examples/tests/view-table-test.ts`)
-- PostgreSQL 테스트 환경 설정 스크립트 작성 (`setup-postgres-test.sql`)
-
-### 3. 테스트 결과
-
-#### 타입 검증
-- TypeScript 컴파일러를 통한 타입 검증 완료
-- View 테이블 타입이 올바르게 추론됨
-- 타입 안전성 유지 (존재하지 않는 컬럼/테이블 접근 시 컴파일 오류 발생)
-- Views는 읽기 전용이므로 Insert/Update 시도 시 컴파일 오류 발생
-
-#### 모의 데이터 테스트
-- 모의 데이터를 사용한 View 테이블 조회 예제 실행 성공
-- 일반 테이블과 동일한 방식으로 View 테이블 조회 가능
-- 조건 적용, 정렬, 단일 결과 조회 등 다양한 쿼리 기능 정상 작동
-
-#### 실제 PostgreSQL 데이터베이스 테스트
-- PostgreSQL 테스트 환경 설정 및 테스트 데이터 생성 성공
-- 실제 데이터베이스에서 View 테이블 조회 기능 정상 작동 확인
-- 연결 문자열을 사용하여 인증 문제 해결
-
-### 4. 배포 과정
-
-#### 브랜치 관리
-- 브랜치 `feature/view-table-support` 생성
-- 변경 사항 커밋: "feat: Views 테이블 조회 기능 추가"
-- 테스트 코드 커밋: "test: View 테이블 조회 기능 테스트 코드 추가"
-- PostgreSQL 테스트 환경 설정 스크립트 커밋: "test: PostgreSQL 테스트 환경 설정 스크립트 추가"
-
-#### 머지 및 배포
-- `feature/view-table-support` 브랜치를 `main` 브랜치에 머지
-- 버전 0.1.12로 업데이트
-- npm에 배포 완료
-
-### 5. 결론
-
-이제 Supalite 라이브러리는 Supabase 데이터베이스의 Views 테이블도 조회할 수 있게 되었습니다. 사용자는 일반 테이블과 동일한 방식으로 View 테이블을 조회할 수 있으며, 타입 안전성과 기존 코드와의 호환성이 유지됩니다. 실제 PostgreSQL 데이터베이스에서도 정상적으로 작동함을 확인했습니다.
+... (생략) ...

package/dist/query-builder.d.ts

@@ -27,6 +27,9 @@ export declare class QueryBuilder<T extends DatabaseSchema, S extends SchemaName
         count?: 'exact' | 'planned' | 'estimated';
         head?: boolean;
     }): this;
+    match(conditions: {
+        [key: string]: any;
+    }): this;
     eq(column: string, value: any): this;
     neq(column: string, value: any): this;
     is(column: string, value: any): this;

package/dist/query-builder.js

@@ -32,6 +32,13 @@ class QueryBuilder {
         this.headOption = options?.head;
         return this;
     }
+    match(conditions) {
+        for (const key in conditions) {
+            this.whereConditions.push(`"${key}" = $${this.whereValues.length + 1}`);
+            this.whereValues.push(conditions[key]);
+        }
+        return this;
+    }
     eq(column, value) {
         this.whereConditions.push(`"${column}" = $${this.whereValues.length + 1}`);
         this.whereValues.push(value);

package/package.json

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