supalite 0.1.12 → 0.2.0

package/CHANGELOG.md

@@ -1,46 +1,15 @@
 # Changelog
 
-## [0.1.12] - 2025-03-02
-
-### 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
+## [0.1.8] - 2025-03-04
 
 ### Fixed
-- from 메서드의 반환 타입을 수정하여 single() 메서드를 호출할 때 SingleQueryResult를 반환하도록 개선
-- 타입 단언 없이도 single() 메서드를 사용할 수 있도록 수정
-- single() 메서드 사용 예제 추가
+- 누락된 `dist` 파일들을 포함하도록 수정
 
-## [0.1.8] - 2025-03-02
-
-### Fixed
-- from 메서드의 반환 타입을 수정하여 타입 단언 없이도 배열 메서드를 사용할 수 있도록 개선
-- await 사용 시 자동으로 QueryResult<Row<T, S, K>>를 반환하도록 수정
-- Supabase와의 호환성 개선
+## [0.1.7] - 2025-03-04
 
-## [0.1.7] - 2025-03-02
-
-### Fixed
-- QueryResult 타입의 data 필드가 항상 배열을 반환하도록 수정
-- 쿼리 결과가 없을 때 null 대신 빈 배열([])을 반환하도록 수정
-- 에러 발생 시에도 data 필드가 빈 배열을 반환하도록 수정
-- Supabase와의 호환성 개선
+### Added
+- QueryBuilder에 `match` 메서드 추가
+- `match` 메서드 테스트 코드 작성
 
 ## [0.1.6] - 2025-03-01
 

package/CHANGE_REPORT_LOG.md

@@ -1,121 +1,123 @@
-# 변경 사항 상세 보고서
-
-## 날짜: 2025-03-02
-## 버전: 0.1.12
-## 기능: Views 테이블 조회 기능 추가
-
-### 개요
-이번 업데이트에서는 Supabase 데이터베이스 타입 정의에서 Views 테이블도 조회할 수 있도록 기능을 추가했습니다. 이를 통해 사용자는 일반 테이블뿐만 아니라 데이터베이스 뷰도 동일한 방식으로 조회할 수 있게 되었습니다.
-
-### 변경 사항 상세 내용
-
-#### 1. 타입 정의 수정 (`src/types.ts`)
-- `ViewName` 타입 추가: 스키마 내의 Views 이름을 참조하는 타입
-- `TableOrViewName` 타입 추가: Tables와 Views를 모두 포함하는 통합 타입
-- `Row`, `InsertRow`, `UpdateRow` 타입 수정: Views도 처리할 수 있도록 조건부 타입 적용
-  - Views는 읽기 전용이므로 `InsertRow`와 `UpdateRow`는 Views에 대해 `never` 타입 반환
-
-```typescript
-export type ViewName<
-  T extends DatabaseSchema,
-  S extends SchemaName<T> = SchemaName<T>
-> = keyof NonNullable<T[S]['Views']>;
-
-export type TableOrViewName<
-  T extends DatabaseSchema,
-  S extends SchemaName<T> = SchemaName<T>
-> = TableName<T, S> | ViewName<T, S>;
-
-export type Row<
-  T extends DatabaseSchema,
-  S extends SchemaName<T>,
-  K extends TableOrViewName<T, S>
-> = K extends TableName<T, S> 
-  ? T[S]['Tables'][K]['Row'] 
-  : K extends ViewName<T, S> 
-    ? NonNullable<T[S]['Views']>[K]['Row'] 
-    : never;
-```
+# 변경 작업 보고서
 
-#### 2. 쿼리 빌더 수정 (`src/query-builder.ts`)
-- `QueryBuilder` 클래스의 제네릭 타입 매개변수를 `TableOrViewName`으로 변경하여 Views도 처리할 수 있도록 수정
-
-```typescript
-export class QueryBuilder<
-  T extends DatabaseSchema,
-  S extends SchemaName<T> = 'public',
-  K extends TableOrViewName<T, S> = TableOrViewName<T, S>
-> implements Promise<QueryResult<Row<T, S, K>> | SingleQueryResult<Row<T, S, K>>> {
-  // ...
-}
-```
+## [2025-03-04] 누락된 dist 파일들을 포함하도록 수정
 
-#### 3. PostgreSQL 클라이언트 수정 (`src/postgres-client.ts`)
-- `SchemaWithTables` 타입 수정: Views 타입 정의 추가
-- `from` 메서드 시그니처 수정: `TableOrViewName` 타입을 사용하도록 변경
-
-```typescript
-type SchemaWithTables = {
-  Tables: {
-    [key: string]: {
-      Row: any;
-      Insert: any;
-      Update: any;
-      Relationships: unknown[];
-    };
-  };
-  Views?: {
-    [key: string]: {
-      Row: any;
-    };
-  };
-  // ...
-};
-
-from<K extends TableOrViewName<T, 'public'>>(
-  table: K
-): QueryBuilder<T, 'public', K> & Promise<QueryResult<Row<T, 'public', K>>> & { single(): Promise<SingleQueryResult<Row<T, 'public', K>>> };
-```
+### 작업 내용
+- 빌드 시 생성되는 dist 디렉토리의 파일들이 이전 커밋에 포함되지 않은 문제를 발견했습니다.
+- dist 디렉토리를 삭제하고 다시 빌드하여 누락된 파일들을 생성했습니다.
+- package.json 파일의 버전을 0.1.8로 업데이트했습니다.
+- CHANGELOG.md 파일에 변경 사항을 기록했습니다.
 
-#### 4. 예제 데이터베이스 타입 정의 수정 (`examples/types/database.ts`)
-- 예제 데이터베이스 타입 정의에 Views 추가
-- `user_posts_view`와 `active_users_view` 뷰 정의 추가
-
-```typescript
-Views: {
-  user_posts_view: {
-    Row: {
-      user_id: number;
-      user_name: string;
-      post_id: number;
-      post_title: string;
-      post_content: string | null;
-      post_created_at: string;
-    };
-  };
-  active_users_view: {
-    Row: {
-      id: number;
-      name: string;
-      email: string;
-      last_login: string | null;
-      post_count: number;
-    };
-  };
-}
-```
+### 변경된 파일
+- 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` 명령어를 사용하여 테스트를 실행했습니다.
+    - 모든 테스트가 성공적으로 완료되었습니다.
 
-#### 5. 테스트 및 예제 코드 추가
-- View 테이블 조회 예제 코드 작성 (`examples/tests/view-table.ts`)
-- 테스트용 SQL 스크립트 작성 (`examples/setup-views.sql`)
-  - 테이블 생성 및 샘플 데이터 삽입
-  - View 생성 (user_posts_view, active_users_view)
+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 브랜치로 병합
 
 ### 테스트 결과
-- View 테이블 조회 기능이 정상적으로 작동함을 확인
-- 일반 테이블과 동일한 방식으로 View 테이블을 조회할 수 있음
-- 타입 안전성이 유지됨
-- 기존 코드와의 호환성이 유지됨
+
+테스트 결과는 다음과 같습니다:
+
+```
+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을 반환했습니다.
 
 ### 결론
-이번 업데이트를 통해 Supalite 라이브러리는 Supabase 데이터베이스의 Views 테이블도 조회할 수 있게 되었습니다. 이로써 사용자는 더 다양한 데이터베이스 객체에 접근할 수 있게 되었으며, Supabase와의 호환성이 더욱 향상되었습니다.
+
+이번 작업을 통해 `QueryBuilder` 클래스에 `match` 메서드를 추가하여, 사용자가 객체 리터럴을 사용하여 간편하게 쿼리 조건을 추가할 수 있게 되었습니다. 또한, 테스트 코드를 통해 `match` 메서드의 동작을 검증했습니다.
+
+---
+
+# 변경 작업 보고서
+
+## [2025-03-01] corepack을 통한 다중 패키지 관리자 지원 추가
+
+### 작업 내용
+
+... (생략) ...

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/dist/types.d.ts

@@ -40,8 +40,8 @@ export type TableOrViewName<T extends DatabaseSchema, S extends SchemaName<T> =
 export type Row<T extends DatabaseSchema, S extends SchemaName<T>, K extends TableOrViewName<T, S>> = K extends TableName<T, S> ? T[S]['Tables'][K]['Row'] : K extends ViewName<T, S> ? NonNullable<T[S]['Views']>[K]['Row'] : never;
 export type InsertRow<T extends DatabaseSchema, S extends SchemaName<T>, K extends TableOrViewName<T, S>> = K extends TableName<T, S> ? T[S]['Tables'][K]['Insert'] : never;
 export type UpdateRow<T extends DatabaseSchema, S extends SchemaName<T>, K extends TableOrViewName<T, S>> = K extends TableName<T, S> ? T[S]['Tables'][K]['Update'] & {
-    modified_at?: string;
-    updated_at?: string;
+    modified_at?: string | null;
+    updated_at?: string | null;
 } : never;
 export type EnumType<T extends DatabaseSchema, S extends SchemaName<T>, E extends keyof NonNullable<T[S]['Enums']>> = NonNullable<T[S]['Enums']>[E];
 export interface SupaliteConfig {

package/package.json

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