firestore-batch-updater 1.18.0 → 1.19.0

package/README.ko.md

@@ -24,6 +24,7 @@
 - 통합 통계 - `fieldStats()`로 sum/avg/min/max/count 한 번에 조회
 - 커서 페이지네이션 - `paginate()`로 메모리 효율적인 페이지 단위 조회
 - ID 직접 조회 - `getOne()`으로 문서 ID로 빠른 조회
+- 문서 ID 존재 확인 - `has(id)`로 데이터 읽기 없이 특정 문서 ID 존재 여부 확인
 - 벌크 작업 - `bulkCreate()`, `bulkUpdate()`, `bulkDelete()`로 여러 문서에 각기 다른 데이터로 효율적 처리
 - 문서 변환 - `transform()`으로 각 문서에 커스텀 로직 적용 (가격 인상, 데이터 마이그레이션 등)
 - 복사 & 이동 - `copyTo()`로 컬렉션 간 문서 복사/이동 (데이터 변환 옵션 포함)
@@ -109,6 +110,7 @@ console.log(`${result.successCount}개 문서 업데이트 완료`);
 | `isEmpty()` | 매칭되는 문서가 없는지 확인 | `boolean` |
 | `findOne()` | 첫 번째 매칭 문서 조회 | `{ id, data } \| null` |
 | `getOne(id)` | ID로 문서 직접 조회 | `{ id, data } \| null` |
+| `has(id)` | 문서 ID 존재 여부 확인 | `boolean` |
 | `getAll()` | 모든 매칭 문서 조회 | `{ id, data }[]` |
 | `preview(data)` | 업데이트 전 미리보기 | `PreviewResult` |
 | `update(data, options?)` | 매칭되는 문서 업데이트 | `UpdateResult` |
@@ -646,6 +648,24 @@ const order = await updater
   .getOne("order-456");
 ```
 
+### 문서 ID 존재 확인
+
+```typescript
+// 특정 문서 ID가 존재하는지 확인 (데이터 읽기 없이 효율적)
+const exists = await updater.collection("users").has("user-123");
+
+if (exists) {
+  console.log("사용자가 존재합니다!");
+} else {
+  console.log("사용자를 찾을 수 없음");
+}
+
+// 가드 절에 유용
+if (!(await updater.collection("users").has(userId))) {
+  throw new Error("사용자를 찾을 수 없습니다");
+}
+```
+
 ### 벌크 업데이트
 
 ```typescript

package/README.md

@@ -24,6 +24,7 @@ English | [한국어](./README.ko.md)
 - Combined stats - Use `fieldStats()` to get sum/avg/min/max/count in one call
 - Cursor pagination - Use `paginate()` for memory-efficient page-by-page iteration
 - Direct ID lookup - Use `getOne()` for fast document retrieval by ID
+- Document ID check - Use `has(id)` to check if a specific document ID exists without reading data
 - Bulk operations - Use `bulkCreate()`, `bulkUpdate()`, `bulkDelete()` for efficient multi-document operations with different data each
 - Transform - Use `transform()` to apply custom logic to each document (e.g., price increase, data migration)
 - Copy & Move - Use `copyTo()` to copy/move documents between collections with optional data transformation
@@ -109,6 +110,7 @@ console.log(`Updated ${result.successCount} documents`);
 | `isEmpty()` | Check if no matching documents exist | `boolean` |
 | `findOne()` | Find first matching document | `{ id, data } \| null` |
 | `getOne(id)` | Get document by ID directly | `{ id, data } \| null` |
+| `has(id)` | Check if document ID exists | `boolean` |
 | `getAll()` | Get all matching documents | `{ id, data }[]` |
 | `preview(data)` | Preview changes before update | `PreviewResult` |
 | `update(data, options?)` | Update matching documents | `UpdateResult` |
@@ -665,6 +667,24 @@ const profile = await updater
   .getOne("user-123");
 ```
 
+### Check Document Exists by ID
+
+```typescript
+// Check if a specific document ID exists (without reading data)
+const exists = await updater.collection("users").has("user-123");
+
+if (exists) {
+  console.log("User exists!");
+} else {
+  console.log("User not found");
+}
+
+// Useful for guard clauses before operations
+if (!(await updater.collection("users").has(userId))) {
+  throw new Error("User not found");
+}
+```
+
 ### Bulk Update with Different Data
 
 ```typescript

package/dist/index.d.mts

@@ -629,6 +629,12 @@ declare class BatchUpdater {
         id: string;
         data: Record<string, any>;
     } | null>;
+    /**
+     * Check if a document with the given ID exists in the collection
+     * @param id - Document ID to check
+     * @returns true if the document exists, false otherwise
+     */
+    has(id: string): Promise<boolean>;
     /**
      * Update the first document matching the query conditions
      * @param updateData - Data to update

package/dist/index.d.ts

@@ -629,6 +629,12 @@ declare class BatchUpdater {
         id: string;
         data: Record<string, any>;
     } | null>;
+    /**
+     * Check if a document with the given ID exists in the collection
+     * @param id - Document ID to check
+     * @returns true if the document exists, false otherwise
+     */
+    has(id: string): Promise<boolean>;
     /**
      * Update the first document matching the query conditions
      * @param updateData - Data to update

package/dist/index.js

@@ -373,6 +373,25 @@ var BatchUpdater = class {
       data: docSnapshot.data()
     };
   }
+  /**
+   * Check if a document with the given ID exists in the collection
+   * @param id - Document ID to check
+   * @returns true if the document exists, false otherwise
+   */
+  async has(id) {
+    this.validateSetup();
+    if (!id || typeof id !== "string") {
+      throw new Error("Document ID is required");
+    }
+    if (this.isCollectionGroup) {
+      throw new Error(
+        "has() cannot be used with collectionGroup(). Use exists() with where conditions instead."
+      );
+    }
+    const docRef = this.firestore.collection(this.collectionPath).doc(id);
+    const docSnapshot = await docRef.get();
+    return docSnapshot.exists;
+  }
   /**
    * Update the first document matching the query conditions
    * @param updateData - Data to update

package/dist/index.mjs

@@ -328,6 +328,25 @@ var BatchUpdater = class {
       data: docSnapshot.data()
     };
   }
+  /**
+   * Check if a document with the given ID exists in the collection
+   * @param id - Document ID to check
+   * @returns true if the document exists, false otherwise
+   */
+  async has(id) {
+    this.validateSetup();
+    if (!id || typeof id !== "string") {
+      throw new Error("Document ID is required");
+    }
+    if (this.isCollectionGroup) {
+      throw new Error(
+        "has() cannot be used with collectionGroup(). Use exists() with where conditions instead."
+      );
+    }
+    const docRef = this.firestore.collection(this.collectionPath).doc(id);
+    const docSnapshot = await docRef.get();
+    return docSnapshot.exists;
+  }
   /**
    * Update the first document matching the query conditions
    * @param updateData - Data to update

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firestore-batch-updater",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "description": "Batch update Firestore documents with query-based filtering and preview",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",