@seaverse/data-service-sdk 0.10.2 → 0.11.0

package/dist/browser.umd.js

@@ -4786,6 +4786,7 @@
        *
        * @param collectionName - Collection name
        * @param includeDeleted - Include soft-deleted documents (default: false)
+       * @param options - Pagination options (limit and startAfter)
        * @returns QuerySnapshot with documents
        *
        * @example
@@ -4798,11 +4799,21 @@
        *
        * // Include deleted posts (admin use case)
        * const allPosts = await helper.getPublicData('posts', true);
+       *
+       * // Pagination: Get first 10 posts
+       * const firstPage = await helper.getPublicData('posts', false, { limit: 10 });
+       *
+       * // Get next 10 posts (start after last document)
+       * const lastDoc = firstPage.docs[firstPage.docs.length - 1];
+       * const nextPage = await helper.getPublicData('posts', false, {
+       *   limit: 10,
+       *   startAfter: lastDoc
+       * });
        * ```
        */
-      async getPublicData(collectionName, includeDeleted = false) {
+      async getPublicData(collectionName, includeDeleted = false, options) {
           const path = getPublicDataPath(this.appId, collectionName);
-          return this.getDocs(path, includeDeleted);
+          return this.getDocs(path, includeDeleted, options);
       }
       /**
        * Get all documents from userData collection (user's private data)
@@ -4811,6 +4822,7 @@
        *
        * @param collectionName - Collection name
        * @param includeDeleted - Include soft-deleted documents (default: false)
+       * @param options - Pagination options (limit and startAfter)
        * @returns QuerySnapshot with documents
        *
        * @example
@@ -4819,26 +4831,45 @@
        * snapshot.forEach(doc => {
        *   console.log('My note:', doc.data());
        * });
+       *
+       * // Pagination: Get first 20 notes
+       * const firstPage = await helper.getUserData('notes', false, { limit: 20 });
+       *
+       * // Get next page
+       * const lastDoc = firstPage.docs[firstPage.docs.length - 1];
+       * const nextPage = await helper.getUserData('notes', false, {
+       *   limit: 20,
+       *   startAfter: lastDoc
+       * });
        * ```
        */
-      async getUserData(collectionName, includeDeleted = false) {
+      async getUserData(collectionName, includeDeleted = false, options) {
           const path = getUserDataPath(this.appId, this.userId, collectionName);
-          return this.getDocs(path, includeDeleted);
+          return this.getDocs(path, includeDeleted, options);
       }
       /**
        * Get all documents from publicRead collection (read-only for users)
        *
        * @param collectionName - Collection name
+       * @param options - Pagination options (limit and startAfter)
        * @returns QuerySnapshot with documents
        *
        * @example
        * ```typescript
        * const configs = await helper.getPublicRead('config');
+       *
+       * // Pagination
+       * const firstPage = await helper.getPublicRead('config', { limit: 10 });
+       * const lastDoc = firstPage.docs[firstPage.docs.length - 1];
+       * const nextPage = await helper.getPublicRead('config', {
+       *   limit: 10,
+       *   startAfter: lastDoc
+       * });
        * ```
        */
-      async getPublicRead(collectionName) {
+      async getPublicRead(collectionName, options) {
           const path = getPublicReadPath(this.appId, collectionName);
-          return this.getDocs(path);
+          return this.getDocs(path, false, options);
       }
       /**
        * Get collection reference for publicData
@@ -5007,22 +5038,36 @@
       }
       /**
        * Internal: Get all documents from collection
-       * Optionally filter out soft-deleted documents
+       * Optionally filter out soft-deleted documents and support pagination
        */
-      async getDocs(collectionPath, includeDeleted = false) {
-          const { getDocs, collection, query, where } = await this.loadFirestore();
+      async getDocs(collectionPath, includeDeleted = false, options) {
+          const { getDocs, collection, query, where, limit, startAfter } = await this.loadFirestore();
           const colRef = collection(this.db, collectionPath);
-          if (includeDeleted) {
-              // Return all documents (including soft-deleted)
-              return getDocs(colRef);
-          }
-          else {
+          // Build query constraints
+          const constraints = [];
+          // Add soft-delete filter if needed
+          if (!includeDeleted) {
               // Filter out soft-deleted documents
               // Use '!=' to include documents without _deleted field (new documents)
               // This will return documents where _deleted is missing, null, undefined, or false
-              const q = query(colRef, where('_deleted', '!=', true));
+              constraints.push(where('_deleted', '!=', true));
+          }
+          // Add pagination constraints if provided
+          if (options?.limit) {
+              constraints.push(limit(options.limit));
+          }
+          if (options?.startAfter) {
+              constraints.push(startAfter(options.startAfter));
+          }
+          // Execute query
+          if (constraints.length > 0) {
+              const q = query(colRef, ...constraints);
               return getDocs(q);
           }
+          else {
+              // No constraints, return all documents
+              return getDocs(colRef);
+          }
       }
       /**
        * Internal: Get collection reference
@@ -5051,7 +5096,8 @@
               query: firestore.query,
               where: firestore.where,
               orderBy: firestore.orderBy,
-              limit: firestore.limit
+              limit: firestore.limit,
+              startAfter: firestore.startAfter
           };
       }
   }