@seaverse/data-service-sdk 0.4.0 → 0.5.0

package/dist/browser.umd.js

@@ -4179,10 +4179,101 @@
       }
   }
 
+  /**
+   * Create Firebase configuration from Firestore token response
+   *
+   * This helper function extracts the Firebase config from the token response,
+   * making it easy to initialize Firebase app.
+   *
+   * @param tokenResponse - The Firestore token response from SDK
+   * @returns Firebase configuration object ready for initializeApp()
+   *
+   * @example
+   * ```typescript
+   * import { initializeApp } from 'firebase/app';
+   * import { getFirebaseConfig } from '@seaverse/data-service-sdk';
+   *
+   * const tokenResponse = await client.generateGuestFirestoreToken({ app_id: 'my-app' });
+   * const firebaseConfig = getFirebaseConfig(tokenResponse);
+   *
+   * const app = initializeApp(firebaseConfig);
+   * ```
+   */
+  function getFirebaseConfig(tokenResponse) {
+      return {
+          apiKey: tokenResponse.web_api_key,
+          projectId: tokenResponse.project_id,
+      };
+  }
+  /**
+   * Initialize Firebase with Firestore token response (browser only)
+   *
+   * This is a convenience function that automatically:
+   * 1. Creates Firebase config from token response
+   * 2. Initializes Firebase app
+   * 3. Signs in with the custom token
+   * 4. Returns authenticated Firebase instances
+   *
+   * IMPORTANT: This function requires Firebase SDK to be installed separately:
+   * npm install firebase
+   *
+   * @param tokenResponse - The Firestore token response from SDK
+   * @returns Object containing initialized Firebase app, auth, and db instances
+   *
+   * @example
+   * ```typescript
+   * import { initializeWithToken } from '@seaverse/data-service-sdk';
+   *
+   * const tokenResponse = await client.generateGuestFirestoreToken({ app_id: 'my-app' });
+   * const { app, auth, db, userId, appId } = await initializeWithToken(tokenResponse);
+   *
+   * // Ready to use Firestore!
+   * const snapshot = await getDocs(collection(db, `appData/${appId}/publicData/posts`));
+   * ```
+   */
+  async function initializeWithToken(tokenResponse) {
+      // Check if Firebase SDK is available
+      let initializeApp;
+      let getAuth;
+      let signInWithCustomToken;
+      let getFirestore;
+      try {
+          // Try to import Firebase modules
+          const firebaseApp = await import('firebase/app');
+          const firebaseAuth = await import('firebase/auth');
+          const firebaseFirestore = await import('firebase/firestore');
+          initializeApp = firebaseApp.initializeApp;
+          getAuth = firebaseAuth.getAuth;
+          signInWithCustomToken = firebaseAuth.signInWithCustomToken;
+          getFirestore = firebaseFirestore.getFirestore;
+      }
+      catch (error) {
+          throw new Error('Firebase SDK not found. Please install it: npm install firebase\n' +
+              'Or import manually and use getFirebaseConfig() helper instead.');
+      }
+      // Initialize Firebase
+      const config = getFirebaseConfig(tokenResponse);
+      const app = initializeApp(config);
+      // Sign in with custom token
+      const auth = getAuth(app);
+      await signInWithCustomToken(auth, tokenResponse.custom_token);
+      // Get Firestore instance
+      const db = getFirestore(app);
+      return {
+          app,
+          auth,
+          db,
+          userId: tokenResponse.user_id,
+          appId: tokenResponse.app_id || '',
+      };
+  }
+
   exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL;
   exports.DEFAULT_TIMEOUT = DEFAULT_TIMEOUT;
   exports.DataServiceClient = DataServiceClient;
   exports.ENDPOINTS = ENDPOINTS;
+  exports.getFirebaseConfig = getFirebaseConfig;
+  exports.initializeWithToken = initializeWithToken;
 
 }));
 //# sourceMappingURL=browser.umd.js.map