firestore-batch-updater 1.10.0 → 1.11.0

package/README.ko.md

@@ -17,6 +17,7 @@
 - 필드 선택 - `select()`로 필요한 필드만 로드 (메모리 및 비용 절약)
 - 단일 문서 작업 - `findOne()`, `createOne()`, `updateOne()`, `deleteOne()`으로 효율적인 단일 문서 처리
 - 존재 여부 확인 - `exists()`로 매칭 문서 존재 여부 빠르게 확인
+- 비어있는지 확인 - `isEmpty()`로 매칭 문서가 없는지 확인 (`exists()`의 반대)
 - 전체 문서 조회 - `getAll()`로 매칭되는 모든 문서 데이터 조회
 - 집계 쿼리 - `aggregate()`로 서버 사이드 `sum`, `average`, `count` 연산
 - 커서 페이지네이션 - `paginate()`로 메모리 효율적인 페이지 단위 조회
@@ -99,6 +100,7 @@ console.log(`${result.successCount}개 문서 업데이트 완료`);
 | `select(...fields)` | 특정 필드만 조회 (체이닝 가능) | `this` |
 | `count()` | 매칭되는 문서 개수 조회 | `CountResult` |
 | `exists()` | 매칭되는 문서 존재 여부 확인 | `boolean` |
+| `isEmpty()` | 매칭되는 문서가 없는지 확인 | `boolean` |
 | `findOne()` | 첫 번째 매칭 문서 조회 | `{ id, data } \| null` |
 | `getOne(id)` | ID로 문서 직접 조회 | `{ id, data } \| null` |
 | `getAll()` | 모든 매칭 문서 조회 | `{ id, data }[]` |

package/README.md

@@ -17,6 +17,7 @@ English | [한국어](./README.ko.md)
 - Field selection - Use `select()` to load only needed fields (saves memory and costs)
 - Single document operations - Use `findOne()`, `createOne()`, `updateOne()`, `deleteOne()` for efficient single-doc ops
 - Existence check - Use `exists()` to quickly check if matching documents exist
+- Empty check - Use `isEmpty()` to check if no matching documents exist (opposite of `exists()`)
 - Get all documents - Use `getAll()` to retrieve all matching documents with data
 - Aggregation - Use `aggregate()` for server-side `sum`, `average`, and `count` operations
 - Cursor pagination - Use `paginate()` for memory-efficient page-by-page iteration
@@ -99,6 +100,7 @@ console.log(`Updated ${result.successCount} documents`);
 | `select(...fields)` | Select specific fields to retrieve (chainable) | `this` |
 | `count()` | Count matching documents | `CountResult` |
 | `exists()` | Check if matching documents exist | `boolean` |
+| `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` |
 | `getAll()` | Get all matching documents | `{ id, data }[]` |
@@ -425,6 +427,31 @@ if (hasOldLogs) {
 }
 ```
 
+### Check if Collection is Empty
+
+```typescript
+// Check if there are no pending orders
+const noPending = await updater
+  .collection("orders")
+  .where("status", "==", "pending")
+  .isEmpty();
+
+if (noPending) {
+  console.log("No pending orders - all caught up!");
+}
+
+// Opposite of exists() - useful for guard clauses
+const noAdmins = await updater
+  .collection("users")
+  .where("role", "==", "admin")
+  .isEmpty();
+
+if (noAdmins) {
+  console.log("Warning: No admin users found - creating default admin");
+  await updater.collection("users").createOne({ role: "admin", name: "Default Admin" });
+}
+```
+
 ### Get All Documents
 
 ```typescript

package/dist/index.d.mts

@@ -585,6 +585,12 @@ declare class BatchUpdater {
      * @returns True if at least one document exists, false otherwise
      */
     exists(): Promise<boolean>;
+    /**
+     * Check if no documents match the query conditions
+     * Opposite of exists() - returns true when the collection/query has no matching documents
+     * @returns true if no documents match, false otherwise
+     */
+    isEmpty(): Promise<boolean>;
     /**
      * Get all documents matching the query conditions
      * @returns Array of documents with id and data

package/dist/index.d.ts

@@ -585,6 +585,12 @@ declare class BatchUpdater {
      * @returns True if at least one document exists, false otherwise
      */
     exists(): Promise<boolean>;
+    /**
+     * Check if no documents match the query conditions
+     * Opposite of exists() - returns true when the collection/query has no matching documents
+     * @returns true if no documents match, false otherwise
+     */
+    isEmpty(): Promise<boolean>;
     /**
      * Get all documents matching the query conditions
      * @returns Array of documents with id and data

package/dist/index.js

@@ -319,6 +319,15 @@ var BatchUpdater = class {
     const snapshot = await query.count().get();
     return snapshot.data().count > 0;
   }
+  /**
+   * Check if no documents match the query conditions
+   * Opposite of exists() - returns true when the collection/query has no matching documents
+   * @returns true if no documents match, false otherwise
+   */
+  async isEmpty() {
+    const result = await this.exists();
+    return !result;
+  }
   /**
    * Get all documents matching the query conditions
    * @returns Array of documents with id and data

package/dist/index.mjs

@@ -274,6 +274,15 @@ var BatchUpdater = class {
     const snapshot = await query.count().get();
     return snapshot.data().count > 0;
   }
+  /**
+   * Check if no documents match the query conditions
+   * Opposite of exists() - returns true when the collection/query has no matching documents
+   * @returns true if no documents match, false otherwise
+   */
+  async isEmpty() {
+    const result = await this.exists();
+    return !result;
+  }
   /**
    * Get all documents matching the query conditions
    * @returns Array of documents with id and data

package/package.json

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